How yashighosh/moltprotocol works
MoltProtocol is an intent-aware workbench for legacy modernization. A user signs in, uploads or selects a codebase, reviews ingestion results, explores dependencies, generates confidence-scored intent summaries, and has an expert confirm or correct them before discrepancies are compared against validated intent. The server pipeline, parser, confidence scoring, discrepancy analysis, and SQLite persistence form the core internal layers; graph export and documented preview workspaces extend the product. Some page and server internals were not sampled, so those branches are included only where the README or source index supports them.
Main entry points: api.ts API Client · app.ts HTTP API · pipeline.ts Analysis Pipeline · summarize.ts Intent Summaries
Components 21
Workbench
- Demo Sign-in
client/src/auth.tsx - Project Workspace
client/src/pages/WorkspacePage.tsx - Ingestion View
client/src/pages/IngestionPage.tsx - Dependency Map
client/src/pages/DependencyPage.tsx - Intent Summaries
client/src/pages/IntentPage.tsx - Expert Review
client/src/pages/ReviewPage.tsx - Discrepancy View
client/src/pages/DiscrepancyPage.tsx - Modernization Views
client/src/pages/ArchitecturePage.tsx - API Client
client/src/api.ts
Ingestion and Analysis
- Analysis Pipeline
server/src/pipeline.ts - Source Ingestion
server/src/ingest/zipSafe.ts - Source Parser
server/src/analysis/parse.ts
Intent and Review
- Intent Summaries
server/src/intent/summarize.ts - Confidence Scoring
server/src/intent/confidence.ts - Persisted Review
server/src/pipeline.ts
Modernization Insights
- Graph Export
server/src/export/graphExport.ts - Discrepancy Analysis
server/src/discrepancy/compare.ts
API and Persistence
- HTTP API
server/src/app.ts - Project Read Models
server/src/readModels.ts - SQLite Database
server/src/db.ts
Other components
- Engineer
Connections 26
- Engineer → Demo Sign-in: signs in
README.md - Demo Sign-in → API Client: checks session
client/src/auth.tsx - Engineer → Project Workspace: selects project
README.md - Project Workspace → Ingestion View: opens ingestion
README.md - Ingestion View → API Client: submits source
client/src/pages/IngestionPage.tsx - API Client → HTTP API: requests API
README.md - HTTP API → Source Ingestion: reads uploaded zip
server/src/app.ts - HTTP API → Analysis Pipeline: starts ingestion
server/src/app.ts - Analysis Pipeline → Source Parser: parses source
server/src/pipeline.ts - Analysis Pipeline → SQLite Database: reads and writes
server/src/pipeline.ts - Analysis Pipeline → Intent Summaries: generates summaries
server/src/pipeline.ts - Intent Summaries → Source Parser: uses parsed source
server/src/intent/summarize.ts - Intent Summaries → Confidence Scoring: scores evidence
server/src/intent/summarize.ts - Engineer → Dependency Map: explores map
README.md - Dependency Map → API Client: requests analysis
- HTTP API → Graph Export: exports graph
server/src/app.ts - Engineer → Intent Summaries: reviews summaries
README.md - Intent Summaries → API Client: requests summaries
- Expert Review → API Client: confirms or corrects
client/src/pages/ReviewPage.tsx - HTTP API → Analysis Pipeline: records review
server/src/app.ts - Analysis Pipeline → Discrepancy Analysis: compares intent
server/src/pipeline.ts - Engineer → Discrepancy View: checks findings
README.md - Discrepancy View → API Client: loads findings
- Engineer → Modernization Views: opens preview views
README.md - HTTP API → Project Read Models: serves project data
server/src/app.ts - Project Read Models → SQLite Database: reads records