|
| 1 | +# v0.1 Release — Design |
| 2 | + |
| 3 | +## Goal |
| 4 | + |
| 5 | +Get Distil to a clean, working v0.1 state: build passes, tests pass, docs reflect reality, MCP server implemented. |
| 6 | + |
| 7 | +## Scope |
| 8 | + |
| 9 | +### In scope |
| 10 | + |
| 11 | +- Fix broken build (kindling module type errors) |
| 12 | +- Commit uncommitted kindling integration work |
| 13 | +- Update stale APS plans to reflect actual milestone status |
| 14 | +- Update README and CLAUDE.md to match reality |
| 15 | +- Implement `@distil/mcp` package (MCP server exposing all analysis layers) |
| 16 | +- Add `distil mcp` CLI subcommand |
| 17 | +- Ensure CI passes on main |
| 18 | + |
| 19 | +### Out of scope (deferred) |
| 20 | + |
| 21 | +- npm publishing / registry setup |
| 22 | +- Semantic search (M5) |
| 23 | +- Multi-language support (M7) |
| 24 | +- Monorepo workspace detection |
| 25 | + |
| 26 | +## Architecture |
| 27 | + |
| 28 | +### MCP Server (`@distil/mcp`) |
| 29 | + |
| 30 | +New package at `packages/distil-mcp/`. Exposes Distil analysis via Model Context Protocol using stdio transport. |
| 31 | + |
| 32 | +**Tools:** |
| 33 | + |
| 34 | +- `distil_tree` — File tree structure |
| 35 | +- `distil_extract` — L1 AST extraction |
| 36 | +- `distil_calls` — L2 call graph |
| 37 | +- `distil_impact` — L2 impact analysis |
| 38 | +- `distil_cfg` — L3 control flow graph |
| 39 | +- `distil_dfg` — L4 data flow graph |
| 40 | +- `distil_slice` — L5 program slicing |
| 41 | + |
| 42 | +**Dependencies:** `@distil/core`, `@modelcontextprotocol/sdk` |
| 43 | + |
| 44 | +**Transport:** stdio (started via `distil mcp` or configured in editor settings) |
| 45 | + |
| 46 | +## Workstreams |
| 47 | + |
| 48 | +1. **Fix build + kindling** — Fix type errors, commit kindling module, verify build + tests |
| 49 | +2. **Project hygiene** — Update APS plans, README, CLAUDE.md |
| 50 | +3. **MCP server** — New package implementing MCP protocol |
| 51 | + |
| 52 | +Streams 2 and 3 can run in parallel after stream 1 completes. |
0 commit comments