Skip to content

Commit 6a87232

Browse files
committed
docs: add v0.1 release design and implementation plan
Authored-By: Aneki (joshuaboys)
1 parent a014110 commit 6a87232

File tree

2 files changed

+788
-0
lines changed

2 files changed

+788
-0
lines changed
Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
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

Comments
 (0)