Public: anyone can read this; the crew can change it.
Milestones: the plan as limbs with weights, and one milestone's progress read from its dependency tree #731
Sign in to join this conversation.
Public: anyone can read this; the crew can change it.
Pillar: P0 Trust (umbrella #586), with the alignment set (#610, #611). Builds on #610 (pull #708) and #612 (pull #706).
The owner, 2026-10-05: "is there a milestone I can watch? this is where the issue dependency view is interesting. are milestones implemented? that would be a great way to see a high level." And: "that might also help me arbor the tree. There is a lot ... it's harder to make impactful decisions. I want to trim at a limb, not each leaf."
Outcome (what a person sees). The whole plan on one phone screen as a handful of limbs, each one line with its weight. He opens a limb and sees how far it is, who is building, what is stuck, and when it will land at this week's pace.
Today. Milestones are not a feature. Umbrella issues with dependency trees are: the pillar umbrellas #586 to #593, and trees inside them such as #603 with its twelve blockers. The map draws every leaf; nothing says "this limb is 7 of 12 done".
What a milestone is. Any issue that waits for other issues. Its tree is everything it waits for, directly or through others. Nothing is stored: it is read from the dependency edges. The top-level limbs are the pillar umbrellas and Later (
src/core/pillars.ts); in a repository with no pillars they are the issues that wait for others and that nothing waits for.Acceptance.
/:owner/:name/milestonesshows the top-level limbs, collapsed: each one line with its name, done / total, open issues beneath it, how many are building, spend so far (only for a person who may see owner facts), and its last movement. The whole list fits one phone screen for a plan of about ten limbs./:owner/:name/milestones/:numberis one milestone: done / total; what is building now and by whom; what is blocked and on what; what merged in the last 7 days; and a plain estimate from recent throughput ("about N days at this week's pace"), or a sentence that says there is no pace to estimate from. Its own limbs are collapsed lines with the same weights; leaves appear only when a limb is opened.GET /api/v1/repos/:owner/:name/milestones(and/:number) return the same numbers as the page.Contract (the owner's rule, docs/VISION.md).
The path: the owner on the map, the board or an issue asks "how far is this?"; the one action is open the milestone; he sees its limbs and opens one.
Done means reachable (all four, or the pull says which one does not apply and why):
/:owner/:name/milestonesand/:owner/:name/milestones/:numbermilestonesread with the same numbersStart from: src/core/dependencies.ts (
repoGraph,readyNow,blockedOn), src/core/pillars.ts, src/web/pages/map.ts (marksFor,wordFor,pillarRows), src/web/pages/board.ts, src/web/pages/thread.ts (the "Depends on" card), src/core/usage.ts, src/http/mcp.ts.Must not touch: the release workflow, the chart (charts/), other repositories.