sprinty-mcp 0.1.0 → 0.1.1

package/README.md

@@ -3,29 +3,40 @@
 A disciplined-sprint MCP server for AI coding agents — **Claude Code, Codex, and Gemini**.
 
 Sprinty gives an agent first-class tools to run a sprint with structure that can't silently rot:
-structured **sprint → subsprint → item** objects, an **immutable append-only ledger** anchored to
-real git commits, **programmatic close-gates** that re-run your tests before a sprint can close, a
-**regex search** over the record, and a **live follow-along dashboard**.
+structured **sprint → subsprint → item** objects, dependency graphs with topological ordering and
+cycle detection, an **immutable append-only ledger** anchored to real git commits,
+Git-backed **change maps**, Markdown changelogs with file tables, **programmatic close-gates**
+that re-run your tests and require coverage evidence before a sprint can close, a **regex search**
+over the record, and a **live follow-along dashboard**.
 
 The point: the agent doesn't drift, and the record doesn't lie. IDs are minted server-side, items
-can't exist without gates, `done` rejects a commit that doesn't exist, and `sprint_close` refuses
-to close while anything is unresolved or a gate fails.
+can't exist without gates, `done` rejects a commit that doesn't exist or lacks a semver changelog
+line, and `sprint_close` refuses to close while anything is open, coverage is missing, or a gate
+fails.
 
 ## Install
 
-Sprinty ships as a native plugin for each agent. The MCP server itself runs via `npx -y sprinty-mcp`
-(the npm package is `sprinty-mcp`; the server, tools, and plugins are all named `sprinty`).
+Sprinty has two layers:
 
-**Claude Code** — `clients/claude/` is a plugin (`.claude-plugin/plugin.json`) bundling the MCP
-server and skills. Add the MCP directly:
+- the MCP server, which runs from npm as `npx -y sprinty-mcp`;
+- optional client manifests under `clients/` for agents that support plugins or extensions.
+
+The npm package is `sprinty-mcp`. The server, MCP tool namespace, and client manifests are named
+`sprinty`.
+
+### Claude Code
+
+Add the MCP server directly:
 
 ```bash
 claude mcp add sprinty -- npx -y sprinty-mcp
 ```
 
-**Codex** — `clients/codex/` is a plugin (`.codex-plugin/plugin.json` + `.mcp.json` + skills),
-installed through a marketplace (`clients/codex/marketplace.json`). Or add the server to
-`~/.codex/config.toml`:
+The repo also includes a Claude plugin manifest in `clients/claude/`.
+
+### Codex
+
+Fast path: add the MCP server to `~/.codex/config.toml`:
 
 ```toml
 [mcp_servers.sprinty]
@@ -33,28 +44,74 @@ command = "npx"
 args = ["-y", "sprinty-mcp"]
 ```
 
-**Gemini CLI** — `clients/gemini/` is an extension (`gemini-extension.json` + `GEMINI.md` + skills):
+Codex CLI plugin path: install the repo-local marketplace from a repository checkout:
+
+```bash
+codex plugin marketplace add .
+codex plugin add sprinty@sprinty-local
+```
+
+The installable plugin bundle is `plugins/sprinty/`, and the marketplace index is
+`.agents/plugins/marketplace.json`. This marketplace layout is for Git/repo installs, not the npm
+tarball. The plugin uses a `plugins/sprinty/skills` symlink to the canonical top-level `skills/`
+directory; there is no duplicated Codex-only skill copy.
+
+After installation, ask Codex to use Sprinty for a non-trivial task. It should call `sprint_new`
+before implementation and `sprint_close` before claiming the sprint is done.
+
+### Gemini CLI
+
+`clients/gemini/` is a Gemini extension (`gemini-extension.json` + `GEMINI.md` + skills):
 
 ```bash
 gemini extensions install ./clients/gemini
 ```
 
-The skills are authored once in `skills/` and symlinked into each client, so all three share one
-body of guidance.
+The skill guidance is authored once in `skills/`. Client packages should reference or symlink that
+content rather than copying it.
 
 ## The loop
 
 ```
-sprint_new(goal)
-  -> subsprint_new(description, goals[], gates[])
-  -> add(subsprint, description, code_locations[], gates[])
-  -> done(commit_id, gate_results[]) | split(...) | deprecate(reason)
-  -> sprint_close()
+sprint_new(goal, context_notes?)
+  -> subsprint_new(description, goals[], gates[], dependencies?)
+  -> add(subsprint, description, code_locations[], gates[], dependencies?)
+  -> dependencies(target, dependencies[])
+  -> done(commit_id, gate_results[], changelog) | split(...) | deprecate(reason)
+  -> changelog()
+  -> sprint_close(coverage: { path, format: "lcov", command? })
 ```
 
 Full tool reference: [`skills/using-sprinty/SKILL.md`](skills/using-sprinty/SKILL.md).
 How to run a sprint: [`skills/how-to-run-a-sprint/SKILL.md`](skills/how-to-run-a-sprint/SKILL.md).
 
+## Watching the Dashboard
+
+The dashboard is for the human sitting next to the agent.
+
+1. Ask the agent to call `dashboard()`.
+2. Open the returned `http://127.0.0.1:<port>` URL in a browser.
+3. Leave it open while the sprint runs; it refreshes every two seconds.
+
+The dashboard shows the sprint goal, branch/worktree, start time, progress counts, line coverage,
+open items, gate evidence, dependency graph state, commit ids and changelog lines for completed
+items, changed-file hotspots, and a timestamped timeline from the immutable ledger.
+
+The dashboard server binds to `127.0.0.1` on an ephemeral port and is read-only. It lives only for
+the running MCP server process.
+
+## Proof Model
+
+Sprinty records timestamps on every event and projects them into the sprint timeline. Completed
+items require a real git commit id and controlled changelog entry when `done()` is called, and
+`sprint_close()` checks that the commit still resolves before closing. `done()` also records a
+Git-backed change map for the commit: file, language, directory, additions, deletions, net change,
+churn, item ids, and commit ids. `changelog()` renders a Markdown release note with semver sections,
+coverage, and change-map tables. `done()` also requires passing evidence for every declared item
+gate, including manual gates. Dependencies are stored as a real graph: `current()` returns nodes,
+edges, adjacency indexes, topological order, and cycle information; writes reject cycles. At close,
+executable gates are re-run by Sprinty and `sprint_close()` requires an LCOV coverage report path.
+
 ## Storage
 
 One append-only JSONL ledger file per sprint under `.sprinty/` in the repo you're working on, with a

package/clients/claude/.claude-plugin/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "sprinty",
+  "version": "0.1.0",
+  "description": "Disciplined sprint discipline: structured sprint/subsprint/item objects, an immutable git-anchored ledger, programmatic close-gates, and a live dashboard.",
+  "author": { "name": "Elie Bursztein" },
+  "homepage": "https://github.com/ebursztein/sprinty",
+  "repository": "https://github.com/ebursztein/sprinty",
+  "license": "Apache-2.0",
+  "keywords": ["sprint", "discipline", "ledger", "mcp"],
+  "mcpServers": {
+    "sprinty": { "command": "npx", "args": ["-y", "sprinty-mcp"] }
+  }
+}

package/clients/codex/README.md

@@ -0,0 +1,32 @@
+# Sprinty for Codex CLI
+
+The supported command-line Codex plugin lives at `plugins/sprinty/`, with the repository-local
+marketplace at `.agents/plugins/marketplace.json`. This directory is documentation only.
+
+Install from a repository checkout:
+
+```bash
+codex plugin marketplace add .
+codex plugin add sprinty@sprinty-local
+```
+
+Then start a new Codex CLI thread so the plugin skills and MCP server are loaded.
+
+This marketplace layout is for Git/repo installs, not the npm tarball. The npm package provides the
+MCP server used by the plugin (`npx -y sprinty-mcp`).
+
+The installed plugin provides:
+
+- Sprinty MCP tools through `npx -y sprinty-mcp`
+- shared Sprinty skills from the canonical repository `skills/` directory
+
+MCP-only setup without plugin skills:
+
+```bash
+codex mcp add sprinty -- npx -y sprinty-mcp
+```
+
+Do not copy skill files into client directories; keep them in the top-level `skills/` directory.
+
+For human visibility during a sprint, ask Codex to call `dashboard()` and open the returned
+`http://127.0.0.1:<port>` URL in a browser.

package/clients/gemini/GEMINI.md

@@ -0,0 +1,26 @@
+# Sprinty
+
+When a task is non-trivial, run a disciplined sprint with the sprinty MCP.
+
+See `skills/how-to-run-a-sprint` and `skills/using-sprinty`. The loop:
+
+```
+sprint_new(goal, context_notes?)
+  -> subsprint_new(description, goals[], gates[], dependencies?)
+  -> add(subsprint, description, code_locations[], gates[], dependencies?)
+  -> dependencies(target, dependencies[])
+  -> done(commit_id, gate_results[], changelog) | split(...) | deprecate(reason)
+  -> changelog()
+  -> sprint_close(coverage: { path, format: "lcov", command? })
+```
+
+Rules: IDs are minted by the server (`S01`, `S01-001`) — never invent them. Every item needs a
+description, at least one code location, and at least one gate. `done` requires a real commit,
+passing evidence for every declared item gate, and a semver-style changelog line with a verb such as
+`added`, `fixed`, or `removed`. `split` and `deprecate` are terminal non-code exits. `current()`
+returns the dependency graph, including topological order and cycles. `done` records a Git-backed
+change map. `changelog()` returns Markdown with changelog and change-map tables. `sprint_close`
+rechecks commits, re-runs executable gates, requires an LCOV coverage report path, and refuses to
+close on any blocker. Use
+`search(pattern, context_lines)` to query the immutable ledger. Use `dashboard()` for a live view,
+and give the returned localhost URL to the human so they can watch the sprint timeline.

package/clients/gemini/gemini-extension.json

@@ -0,0 +1,9 @@
+{
+  "name": "sprinty",
+  "version": "0.1.0",
+  "description": "Disciplined sprint discipline with an immutable git-anchored ledger and live dashboard.",
+  "contextFileName": "GEMINI.md",
+  "mcpServers": {
+    "sprinty": { "command": "npx", "args": ["-y", "sprinty-mcp"] }
+  }
+}

package/dist/dashboard/page.d.ts

@@ -1 +1 @@
-export declare const PAGE = "<!doctype html>\n<html><head><meta charset=\"utf-8\"><title>sprinty</title>\n<style>body{font:14px ui-monospace,monospace;margin:2rem;background:#0b0b0c;color:#e6e6e6}\n.sub{border:1px solid #333;border-radius:8px;padding:1rem;margin:1rem 0}\n.done{opacity:.55}.gate{color:#7aa2f7}.bad{color:#f7768e}.ok{color:#9ece6a}h1{font-size:1rem}</style></head>\n<body><h1 id=\"goal\">loading\u2026</h1><div id=\"root\"></div>\n<script>\nasync function tick(){\n  const s=await (await fetch('/state')).json();\n  document.getElementById('goal').textContent='Sprint: '+s.goal+' ['+s.status+'] @'+s.branch;\n  document.getElementById('root').innerHTML=s.subsprints.map(function(ss){\n    return '<div class=\"sub\"><b>'+ss.id+'</b> '+ss.description+' <i>['+ss.status+']</i>'+\n      ss.items.map(function(i){return '<div class=\"'+(i.status==='resolved'?'done':'')+'\">'+\n        i.id+' \u2014 '+i.description+(i.disposition?' ('+i.disposition+')':'')+'</div>';}).join('')+'</div>';\n  }).join('');\n}\ntick();setInterval(tick,2000);\n</script></body></html>";
+export declare const PAGE = "<!doctype html>\n<html lang=\"en\">\n<head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width,initial-scale=1\">\n<title>sprinty dashboard</title>\n<style>\n:root{color-scheme:dark;--bg:#101112;--panel:#191b1f;--panel2:#20242a;--line:#333842;--text:#f0f2f4;--muted:#9ca6b3;--blue:#80b8ff;--green:#7bd88f;--red:#ff8b8b;--yellow:#f4c96b}\n*{box-sizing:border-box}body{margin:0;background:var(--bg);color:var(--text);font:14px/1.45 ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,\"Segoe UI\",sans-serif}\nheader{display:grid;grid-template-columns:1fr auto;gap:1rem;align-items:end;padding:1.25rem 1.5rem;border-bottom:1px solid var(--line);background:#15171a}\nh1{margin:0;font-size:1.25rem;font-weight:700;letter-spacing:0}.meta{display:flex;flex-wrap:wrap;gap:.6rem;color:var(--muted);font-size:.85rem}.pill{border:1px solid var(--line);border-radius:999px;padding:.2rem .55rem;background:var(--panel2);color:var(--muted)}\n.pill.active{color:var(--green);border-color:#3b7049}.pill.closed{color:var(--blue);border-color:#355c88}\nmain{display:grid;grid-template-columns:minmax(0,1.25fr) minmax(22rem,.75fr);gap:1rem;padding:1rem;max-width:1400px;margin:0 auto}\nsection{background:var(--panel);border:1px solid var(--line);border-radius:8px;padding:1rem;min-width:0}section+section{margin-top:1rem}\nh2{margin:0 0 .75rem;font-size:.82rem;text-transform:uppercase;color:var(--muted);letter-spacing:.04em}\n.metrics{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:.6rem}.metric{background:var(--panel2);border:1px solid var(--line);border-radius:6px;padding:.75rem}.metric b{display:block;font-size:1.3rem}.metric span{color:var(--muted);font-size:.8rem}\n.sub{border-top:1px solid var(--line);padding:1rem 0}.sub:first-child{border-top:0;padding-top:0}.row{display:flex;gap:.6rem;align-items:center;justify-content:space-between}.title{font-weight:650}.desc{color:var(--muted);margin:.15rem 0 .6rem}.items{display:grid;gap:.55rem}\n.item{border:1px solid var(--line);background:var(--panel2);border-radius:6px;padding:.7rem}.item.terminal{opacity:.72}.item-head{display:flex;flex-wrap:wrap;gap:.45rem;align-items:center;margin-bottom:.3rem}.id{font:12px ui-monospace,monospace;color:var(--blue)}\n.status{font-size:.75rem;color:var(--muted)}.open{color:var(--yellow)}.completed{color:var(--green)}.split{color:var(--blue)}.deprecated,.failed{color:var(--red)}\n.gates{display:grid;gap:.25rem;margin-top:.45rem}.gate{font:12px ui-monospace,monospace;color:var(--muted);overflow-wrap:anywhere}.gate.pass{color:var(--green)}.gate.fail{color:var(--red)}\n.timeline{display:grid;gap:.5rem}.event{display:grid;grid-template-columns:8.5rem minmax(0,1fr);gap:.7rem;border-top:1px solid var(--line);padding-top:.5rem}.event:first-child{border-top:0;padding-top:0}.time{color:var(--muted);font:12px ui-monospace,monospace}.event b{font-size:.82rem}.event p{margin:.12rem 0 0;color:var(--muted);overflow-wrap:anywhere}\n.empty{color:var(--muted);padding:.6rem 0}.error{color:var(--red)}\n@media(max-width:850px){header{grid-template-columns:1fr}main{grid-template-columns:1fr}.metrics{grid-template-columns:repeat(2,minmax(0,1fr))}.event{grid-template-columns:1fr}}\n</style>\n</head>\n<body>\n<header>\n  <div>\n    <h1 id=\"goal\">Loading sprint...</h1>\n    <div class=\"meta\">\n      <span id=\"branch\"></span>\n      <span id=\"worktree\"></span>\n      <span id=\"created\"></span>\n    </div>\n  </div>\n  <span id=\"status\" class=\"pill\">loading</span>\n</header>\n<main>\n  <div>\n    <section>\n      <h2>Progress</h2>\n      <div class=\"metrics\">\n        <div class=\"metric\"><b id=\"metric-subsprints\">0</b><span>subsprints</span></div>\n        <div class=\"metric\"><b id=\"metric-items\">0</b><span>items</span></div>\n        <div class=\"metric\"><b id=\"metric-open\">0</b><span>open</span></div>\n        <div class=\"metric\"><b id=\"metric-gates\">0</b><span>gate results</span></div>\n        <div class=\"metric\"><b id=\"metric-coverage\">--</b><span>line coverage</span></div>\n      </div>\n    </section>\n    <section>\n      <h2>Active Items</h2>\n      <div id=\"active-items\" class=\"items\"></div>\n    </section>\n    <section>\n      <h2>Subsprints</h2>\n      <div id=\"subsprints\"></div>\n    </section>\n  </div>\n  <aside>\n    <section>\n      <h2>Hotspots</h2>\n      <div id=\"hotspots\" class=\"items\"></div>\n    </section>\n    <section>\n      <h2>Timeline</h2>\n      <div id=\"timeline\" class=\"timeline\"></div>\n    </section>\n  </aside>\n</main>\n<script>\nfunction byId(id){return document.getElementById(id)}\nfunction clear(node){node.replaceChildren()}\nfunction text(tag, className, value){\n  const node=document.createElement(tag);\n  if(className)node.className=className;\n  node.textContent=value == null ? \"\" : String(value);\n  return node;\n}\nfunction fmt(ts){\n  if(!ts)return \"\";\n  const d=new Date(ts);\n  return Number.isNaN(d.valueOf()) ? ts : d.toLocaleString();\n}\nfunction summarize(s){\n  const subs=s.subsprints||[];\n  const items=subs.flatMap(function(ss){return ss.items||[]});\n  const gateResults=items.reduce(function(n,i){return n+(i.gate_results||[]).length},0);\n  return {subs:subs,items:items,open:items.filter(function(i){return i.status===\"open\"}),gateResults:gateResults};\n}\nfunction renderGateResults(item, target){\n  const gates=document.createElement(\"div\");\n  gates.className=\"gates\";\n  const results=item.gate_results||[];\n  if(results.length===0){\n    gates.append(text(\"div\",\"gate\",\"pending evidence\"));\n  } else {\n    results.forEach(function(g){\n      gates.append(text(\"div\",\"gate \"+(g.passed?\"pass\":\"fail\"),(g.passed?\"pass \":\"fail \")+g.kind+\": \"+g.spec+\" - \"+g.evidence));\n    });\n  }\n  target.append(gates);\n}\nfunction renderItem(item){\n  const node=document.createElement(\"div\");\n  node.className=\"item \"+(item.status!==\"open\"?\"terminal\":\"\");\n  const head=document.createElement(\"div\");\n  head.className=\"item-head\";\n  head.append(text(\"span\",\"id\",item.id));\n  head.append(text(\"span\",\"status \"+item.status,item.disposition||item.status));\n  if(item.commit_id)head.append(text(\"span\",\"status\",\"commit \"+item.commit_id));\n  if(item.changelog)head.append(text(\"span\",\"status\",item.changelog.verb+\": \"+item.changelog.line));\n  head.append(text(\"span\",\"status\",fmt(item.created_at)));\n  node.append(head);\n  node.append(text(\"div\",\"title\",item.description));\n  if(item.code_locations&&item.code_locations.length)node.append(text(\"div\",\"desc\",item.code_locations.join(\", \")));\n  renderGateResults(item,node);\n  return node;\n}\nfunction renderSubsprint(ss){\n  const node=document.createElement(\"div\");\n  node.className=\"sub\";\n  const row=document.createElement(\"div\");\n  row.className=\"row\";\n  row.append(text(\"div\",\"title\",ss.id+\" - \"+ss.description));\n  row.append(text(\"span\",\"pill \"+ss.status,ss.status));\n  node.append(row);\n  node.append(text(\"div\",\"desc\",(ss.goals||[]).join(\"; \")));\n  const items=document.createElement(\"div\");\n  items.className=\"items\";\n  (ss.items||[]).forEach(function(item){items.append(renderItem(item))});\n  if(!items.childNodes.length)items.append(text(\"div\",\"empty\",\"No items yet.\"));\n  node.append(items);\n  return node;\n}\nfunction renderTimeline(s){\n  const timeline=byId(\"timeline\");\n  clear(timeline);\n  const events=(s.timeline||[]).slice(-30).reverse();\n  if(events.length===0){timeline.append(text(\"div\",\"empty\",\"No events yet.\"));return}\n  events.forEach(function(e){\n    const node=document.createElement(\"div\");\n    node.className=\"event\";\n    node.append(text(\"div\",\"time\",fmt(e.ts)));\n    const body=document.createElement(\"div\");\n    body.append(text(\"b\",\"\",e.id+\" / \"+e.type));\n    body.append(text(\"p\",\"\",e.text));\n    node.append(body);\n    timeline.append(node);\n  });\n}\nfunction renderHotspots(s){\n  const target=byId(\"hotspots\");\n  clear(target);\n  const rows=((s.change_map&&s.change_map.hotspots)||[]).slice(0,8);\n  if(rows.length===0){target.append(text(\"div\",\"empty\",\"No changed files yet.\"));return}\n  rows.forEach(function(row){\n    const node=document.createElement(\"div\");\n    node.className=\"item\";\n    const head=document.createElement(\"div\");\n    head.className=\"item-head\";\n    head.append(text(\"span\",\"id\",row.file));\n    head.append(text(\"span\",\"status\",\"churn \"+row.churn));\n    head.append(text(\"span\",\"status\",\"+\"+row.additions+\" -\"+row.deletions));\n    node.append(head);\n    node.append(text(\"div\",\"desc\",row.language+\" / \"+row.directory+\" / \"+(row.items||[]).join(\", \")));\n    target.append(node);\n  });\n}\nfunction render(s){\n  const summary=summarize(s);\n  byId(\"goal\").textContent=s.goal||\"(no sprint)\";\n  byId(\"branch\").textContent=s.branch ? \"branch \"+s.branch : \"\";\n  byId(\"worktree\").textContent=s.worktree||s.dir||\"\";\n  byId(\"created\").textContent=s.created_at ? \"started \"+fmt(s.created_at) : \"\";\n  const status=byId(\"status\");\n  status.className=\"pill \"+(s.status||\"active\");\n  status.textContent=s.status||\"active\";\n  byId(\"metric-subsprints\").textContent=String(summary.subs.length);\n  byId(\"metric-items\").textContent=String(summary.items.length);\n  byId(\"metric-open\").textContent=String(summary.open.length);\n  byId(\"metric-gates\").textContent=String(summary.gateResults);\n  byId(\"metric-coverage\").textContent=s.coverage&&s.coverage.lines ? String(s.coverage.lines.percent)+\"%\" : \"--\";\n  const active=byId(\"active-items\");\n  clear(active);\n  summary.open.forEach(function(item){active.append(renderItem(item))});\n  if(!active.childNodes.length)active.append(text(\"div\",\"empty\",\"No open items.\"));\n  const subsprints=byId(\"subsprints\");\n  clear(subsprints);\n  summary.subs.forEach(function(ss){subsprints.append(renderSubsprint(ss))});\n  if(!subsprints.childNodes.length)subsprints.append(text(\"div\",\"empty\",\"No subsprints yet.\"));\n  renderHotspots(s);\n  renderTimeline(s);\n}\nasync function tick(){\n  try{\n    const response=await fetch(\"/state\");\n    render(await response.json());\n  }catch(err){\n    byId(\"goal\").textContent=\"Dashboard disconnected\";\n    const active=byId(\"active-items\");\n    clear(active);\n    active.append(text(\"div\",\"error\",err && err.message ? err.message : \"Unable to load state.\"));\n  }\n}\ntick();setInterval(tick,2000);\n</script>\n</body>\n</html>";

package/dist/dashboard/page.js

@@ -1,19 +1,209 @@
 export const PAGE = `<!doctype html>
-<html><head><meta charset="utf-8"><title>sprinty</title>
-<style>body{font:14px ui-monospace,monospace;margin:2rem;background:#0b0b0c;color:#e6e6e6}
-.sub{border:1px solid #333;border-radius:8px;padding:1rem;margin:1rem 0}
-.done{opacity:.55}.gate{color:#7aa2f7}.bad{color:#f7768e}.ok{color:#9ece6a}h1{font-size:1rem}</style></head>
-<body><h1 id="goal">loading…</h1><div id="root"></div>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>sprinty dashboard</title>
+<style>
+:root{color-scheme:dark;--bg:#101112;--panel:#191b1f;--panel2:#20242a;--line:#333842;--text:#f0f2f4;--muted:#9ca6b3;--blue:#80b8ff;--green:#7bd88f;--red:#ff8b8b;--yellow:#f4c96b}
+*{box-sizing:border-box}body{margin:0;background:var(--bg);color:var(--text);font:14px/1.45 ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif}
+header{display:grid;grid-template-columns:1fr auto;gap:1rem;align-items:end;padding:1.25rem 1.5rem;border-bottom:1px solid var(--line);background:#15171a}
+h1{margin:0;font-size:1.25rem;font-weight:700;letter-spacing:0}.meta{display:flex;flex-wrap:wrap;gap:.6rem;color:var(--muted);font-size:.85rem}.pill{border:1px solid var(--line);border-radius:999px;padding:.2rem .55rem;background:var(--panel2);color:var(--muted)}
+.pill.active{color:var(--green);border-color:#3b7049}.pill.closed{color:var(--blue);border-color:#355c88}
+main{display:grid;grid-template-columns:minmax(0,1.25fr) minmax(22rem,.75fr);gap:1rem;padding:1rem;max-width:1400px;margin:0 auto}
+section{background:var(--panel);border:1px solid var(--line);border-radius:8px;padding:1rem;min-width:0}section+section{margin-top:1rem}
+h2{margin:0 0 .75rem;font-size:.82rem;text-transform:uppercase;color:var(--muted);letter-spacing:.04em}
+.metrics{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:.6rem}.metric{background:var(--panel2);border:1px solid var(--line);border-radius:6px;padding:.75rem}.metric b{display:block;font-size:1.3rem}.metric span{color:var(--muted);font-size:.8rem}
+.sub{border-top:1px solid var(--line);padding:1rem 0}.sub:first-child{border-top:0;padding-top:0}.row{display:flex;gap:.6rem;align-items:center;justify-content:space-between}.title{font-weight:650}.desc{color:var(--muted);margin:.15rem 0 .6rem}.items{display:grid;gap:.55rem}
+.item{border:1px solid var(--line);background:var(--panel2);border-radius:6px;padding:.7rem}.item.terminal{opacity:.72}.item-head{display:flex;flex-wrap:wrap;gap:.45rem;align-items:center;margin-bottom:.3rem}.id{font:12px ui-monospace,monospace;color:var(--blue)}
+.status{font-size:.75rem;color:var(--muted)}.open{color:var(--yellow)}.completed{color:var(--green)}.split{color:var(--blue)}.deprecated,.failed{color:var(--red)}
+.gates{display:grid;gap:.25rem;margin-top:.45rem}.gate{font:12px ui-monospace,monospace;color:var(--muted);overflow-wrap:anywhere}.gate.pass{color:var(--green)}.gate.fail{color:var(--red)}
+.timeline{display:grid;gap:.5rem}.event{display:grid;grid-template-columns:8.5rem minmax(0,1fr);gap:.7rem;border-top:1px solid var(--line);padding-top:.5rem}.event:first-child{border-top:0;padding-top:0}.time{color:var(--muted);font:12px ui-monospace,monospace}.event b{font-size:.82rem}.event p{margin:.12rem 0 0;color:var(--muted);overflow-wrap:anywhere}
+.empty{color:var(--muted);padding:.6rem 0}.error{color:var(--red)}
+@media(max-width:850px){header{grid-template-columns:1fr}main{grid-template-columns:1fr}.metrics{grid-template-columns:repeat(2,minmax(0,1fr))}.event{grid-template-columns:1fr}}
+</style>
+</head>
+<body>
+<header>
+  <div>
+    <h1 id="goal">Loading sprint...</h1>
+    <div class="meta">
+      <span id="branch"></span>
+      <span id="worktree"></span>
+      <span id="created"></span>
+    </div>
+  </div>
+  <span id="status" class="pill">loading</span>
+</header>
+<main>
+  <div>
+    <section>
+      <h2>Progress</h2>
+      <div class="metrics">
+        <div class="metric"><b id="metric-subsprints">0</b><span>subsprints</span></div>
+        <div class="metric"><b id="metric-items">0</b><span>items</span></div>
+        <div class="metric"><b id="metric-open">0</b><span>open</span></div>
+        <div class="metric"><b id="metric-gates">0</b><span>gate results</span></div>
+        <div class="metric"><b id="metric-coverage">--</b><span>line coverage</span></div>
+      </div>
+    </section>
+    <section>
+      <h2>Active Items</h2>
+      <div id="active-items" class="items"></div>
+    </section>
+    <section>
+      <h2>Subsprints</h2>
+      <div id="subsprints"></div>
+    </section>
+  </div>
+  <aside>
+    <section>
+      <h2>Hotspots</h2>
+      <div id="hotspots" class="items"></div>
+    </section>
+    <section>
+      <h2>Timeline</h2>
+      <div id="timeline" class="timeline"></div>
+    </section>
+  </aside>
+</main>
 <script>
+function byId(id){return document.getElementById(id)}
+function clear(node){node.replaceChildren()}
+function text(tag, className, value){
+  const node=document.createElement(tag);
+  if(className)node.className=className;
+  node.textContent=value == null ? "" : String(value);
+  return node;
+}
+function fmt(ts){
+  if(!ts)return "";
+  const d=new Date(ts);
+  return Number.isNaN(d.valueOf()) ? ts : d.toLocaleString();
+}
+function summarize(s){
+  const subs=s.subsprints||[];
+  const items=subs.flatMap(function(ss){return ss.items||[]});
+  const gateResults=items.reduce(function(n,i){return n+(i.gate_results||[]).length},0);
+  return {subs:subs,items:items,open:items.filter(function(i){return i.status==="open"}),gateResults:gateResults};
+}
+function renderGateResults(item, target){
+  const gates=document.createElement("div");
+  gates.className="gates";
+  const results=item.gate_results||[];
+  if(results.length===0){
+    gates.append(text("div","gate","pending evidence"));
+  } else {
+    results.forEach(function(g){
+      gates.append(text("div","gate "+(g.passed?"pass":"fail"),(g.passed?"pass ":"fail ")+g.kind+": "+g.spec+" - "+g.evidence));
+    });
+  }
+  target.append(gates);
+}
+function renderItem(item){
+  const node=document.createElement("div");
+  node.className="item "+(item.status!=="open"?"terminal":"");
+  const head=document.createElement("div");
+  head.className="item-head";
+  head.append(text("span","id",item.id));
+  head.append(text("span","status "+item.status,item.disposition||item.status));
+  if(item.commit_id)head.append(text("span","status","commit "+item.commit_id));
+  if(item.changelog)head.append(text("span","status",item.changelog.verb+": "+item.changelog.line));
+  head.append(text("span","status",fmt(item.created_at)));
+  node.append(head);
+  node.append(text("div","title",item.description));
+  if(item.code_locations&&item.code_locations.length)node.append(text("div","desc",item.code_locations.join(", ")));
+  renderGateResults(item,node);
+  return node;
+}
+function renderSubsprint(ss){
+  const node=document.createElement("div");
+  node.className="sub";
+  const row=document.createElement("div");
+  row.className="row";
+  row.append(text("div","title",ss.id+" - "+ss.description));
+  row.append(text("span","pill "+ss.status,ss.status));
+  node.append(row);
+  node.append(text("div","desc",(ss.goals||[]).join("; ")));
+  const items=document.createElement("div");
+  items.className="items";
+  (ss.items||[]).forEach(function(item){items.append(renderItem(item))});
+  if(!items.childNodes.length)items.append(text("div","empty","No items yet."));
+  node.append(items);
+  return node;
+}
+function renderTimeline(s){
+  const timeline=byId("timeline");
+  clear(timeline);
+  const events=(s.timeline||[]).slice(-30).reverse();
+  if(events.length===0){timeline.append(text("div","empty","No events yet."));return}
+  events.forEach(function(e){
+    const node=document.createElement("div");
+    node.className="event";
+    node.append(text("div","time",fmt(e.ts)));
+    const body=document.createElement("div");
+    body.append(text("b","",e.id+" / "+e.type));
+    body.append(text("p","",e.text));
+    node.append(body);
+    timeline.append(node);
+  });
+}
+function renderHotspots(s){
+  const target=byId("hotspots");
+  clear(target);
+  const rows=((s.change_map&&s.change_map.hotspots)||[]).slice(0,8);
+  if(rows.length===0){target.append(text("div","empty","No changed files yet."));return}
+  rows.forEach(function(row){
+    const node=document.createElement("div");
+    node.className="item";
+    const head=document.createElement("div");
+    head.className="item-head";
+    head.append(text("span","id",row.file));
+    head.append(text("span","status","churn "+row.churn));
+    head.append(text("span","status","+"+row.additions+" -"+row.deletions));
+    node.append(head);
+    node.append(text("div","desc",row.language+" / "+row.directory+" / "+(row.items||[]).join(", ")));
+    target.append(node);
+  });
+}
+function render(s){
+  const summary=summarize(s);
+  byId("goal").textContent=s.goal||"(no sprint)";
+  byId("branch").textContent=s.branch ? "branch "+s.branch : "";
+  byId("worktree").textContent=s.worktree||s.dir||"";
+  byId("created").textContent=s.created_at ? "started "+fmt(s.created_at) : "";
+  const status=byId("status");
+  status.className="pill "+(s.status||"active");
+  status.textContent=s.status||"active";
+  byId("metric-subsprints").textContent=String(summary.subs.length);
+  byId("metric-items").textContent=String(summary.items.length);
+  byId("metric-open").textContent=String(summary.open.length);
+  byId("metric-gates").textContent=String(summary.gateResults);
+  byId("metric-coverage").textContent=s.coverage&&s.coverage.lines ? String(s.coverage.lines.percent)+"%" : "--";
+  const active=byId("active-items");
+  clear(active);
+  summary.open.forEach(function(item){active.append(renderItem(item))});
+  if(!active.childNodes.length)active.append(text("div","empty","No open items."));
+  const subsprints=byId("subsprints");
+  clear(subsprints);
+  summary.subs.forEach(function(ss){subsprints.append(renderSubsprint(ss))});
+  if(!subsprints.childNodes.length)subsprints.append(text("div","empty","No subsprints yet."));
+  renderHotspots(s);
+  renderTimeline(s);
+}
 async function tick(){
-  const s=await (await fetch('/state')).json();
-  document.getElementById('goal').textContent='Sprint: '+s.goal+' ['+s.status+'] @'+s.branch;
-  document.getElementById('root').innerHTML=s.subsprints.map(function(ss){
-    return '<div class="sub"><b>'+ss.id+'</b> '+ss.description+' <i>['+ss.status+']</i>'+
-      ss.items.map(function(i){return '<div class="'+(i.status==='resolved'?'done':'')+'">'+
-        i.id+' — '+i.description+(i.disposition?' ('+i.disposition+')':'')+'</div>';}).join('')+'</div>';
-  }).join('');
+  try{
+    const response=await fetch("/state");
+    render(await response.json());
+  }catch(err){
+    byId("goal").textContent="Dashboard disconnected";
+    const active=byId("active-items");
+    clear(active);
+    active.append(text("div","error",err && err.message ? err.message : "Unable to load state."));
+  }
 }
 tick();setInterval(tick,2000);
-</script></body></html>`;
+</script>
+</body>
+</html>`;
 //# sourceMappingURL=page.js.map

package/dist/dashboard/page.js.map

@@ -1 +1 @@
-{"version":3,"file":"page.js","sourceRoot":"","sources":["../../src/dashboard/page.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;wBAiBI,CAAC"}
+{"version":3,"file":"page.js","sourceRoot":"","sources":["../../src/dashboard/page.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA+MZ,CAAC"}

package/dist/dashboard/server.js

@@ -4,7 +4,22 @@ export function startDashboard(getState) {
     const server = createServer((req, res) => {
         if (req.url === "/state") {
             res.writeHead(200, { "content-type": "application/json" });
-            res.end(JSON.stringify(getState() ?? { goal: "(no sprint)", status: "active", branch: "", subsprints: [] }));
+            res.end(JSON.stringify(getState() ?? {
+                goal: "(no sprint)",
+                worktree: "",
+                branch: "",
+                dir: "",
+                created_at: new Date().toISOString(),
+                closed_at: null,
+                status: "active",
+                subsprints: [],
+                timeline: [],
+                context_notes: [],
+                graph: { nodes: [], edges: [], blocked_by: {}, unblocks: {}, topological_order: [], cycles: [] },
+                changelog: [],
+                change_map: { by_file: [], by_directory: [], by_language: [], hotspots: [] },
+                coverage: null,
+            }));
             return;
         }
         res.writeHead(200, { "content-type": "text/html" });

package/dist/dashboard/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/dashboard/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAe,MAAM,WAAW,CAAC;AAEtD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAKjC,MAAM,UAAU,cAAc,CAAC,QAAiC;IAC9D,MAAM,MAAM,GAAW,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC/C,IAAI,GAAG,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;YACzB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;YAC7G,OAAO;QACT,CAAC;QACD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;QACpD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE;YACjC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,OAAO,EAAiB,CAAC;YACjD,OAAO,CAAC;gBACN,GAAG,EAAE,oBAAoB,IAAI,EAAE;gBAC/B,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;aACxD,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/dashboard/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAe,MAAM,WAAW,CAAC;AAEtD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAKjC,MAAM,UAAU,cAAc,CAAC,QAAiC;IAC9D,MAAM,MAAM,GAAW,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC/C,IAAI,GAAG,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;YACzB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI;gBACnC,IAAI,EAAE,aAAa;gBACnB,QAAQ,EAAE,EAAE;gBACZ,MAAM,EAAE,EAAE;gBACV,GAAG,EAAE,EAAE;gBACP,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACpC,SAAS,EAAE,IAAI;gBACf,MAAM,EAAE,QAAQ;gBAChB,UAAU,EAAE,EAAE;gBACd,QAAQ,EAAE,EAAE;gBACZ,aAAa,EAAE,EAAE;gBACjB,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;gBAChG,SAAS,EAAE,EAAE;gBACb,UAAU,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;gBAC5E,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC,CAAC;YACJ,OAAO;QACT,CAAC;QACD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;QACpD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE;YACjC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,OAAO,EAAiB,CAAC;YACjD,OAAO,CAAC;gBACN,GAAG,EAAE,oBAAoB,IAAI,EAAE;gBAC/B,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;aACxD,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}