sprinty-mcp 0.1.0

package/dist/tools/current.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"current.js","sourceRoot":"","sources":["../../src/tools/current.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,aAAa,CAAC,IAAgB,EAAE,IAAY,EAAE,MAAc;IAC1E,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC;IACzE,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,aAAa,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;QACpC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC;QAC3B,iBAAiB,EAAE,OAAO;KAC3B,CAAC;AACJ,CAAC"}

package/dist/tools/register.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+import { SprintStore } from "../store/store.js";
+export interface ToolDef {
+    description: string;
+    schema: z.ZodObject<z.ZodRawShape>;
+    handler: (raw: unknown) => Promise<unknown>;
+}
+export type ToolHandlers = Record<string, ToolDef>;
+export declare function buildToolHandlers(store: SprintStore, openDashboard: () => Promise<string>): ToolHandlers;

package/dist/tools/register.js

@@ -0,0 +1,32 @@
+import { z } from "zod";
+import { SprintStore } from "../store/store.js";
+import { windowCurrent } from "./current.js";
+import * as S from "./schemas.js";
+function def(schema, description, run) {
+    return { description, schema, handler: async (raw) => run(schema.parse(raw)) };
+}
+export function buildToolHandlers(store, openDashboard) {
+    return {
+        sprint_new: def(S.SprintNewInput, "Start a sprint; returns orientation (skills + how this works).", (i) => ({ ...store.createSprint(i.goal), orientation: orientation() })),
+        sprint_close: def(S.SprintCloseInput, "Close the sprint after a programmatic re-check of all gates.", () => store.closeSprint()),
+        info: def(S.InfoInput, "The one status read: sprint, subsprints, statuses.", () => store.read()),
+        current: def(S.CurrentInput, "Focus window: last closed item + next N, notes scoped to current subsprint.", (i) => windowCurrent(store.read(), i.past, i.future)),
+        subsprint_new: def(S.SubsprintNewInput, "Create a subsprint (description, goals, gates).", (i) => store.createSubsprint(i)),
+        add: def(S.AddInput, "Add an item (description, code locations, gates — all required).", (i) => store.addItem(i)),
+        update: def(S.UpdateInput, "Attach intermediate info to an item or subsprint.", (i) => store.updateItem(i)),
+        done: def(S.DoneInput, "Resolve an item as completed with commit id + gate results.", (i) => store.done(i)),
+        split: def(S.SplitInput, "Resolve an item as split, creating a seeded subsprint atomically.", (i) => store.split(i)),
+        deprecate: def(S.DeprecateInput, "Resolve an item as deprecated with a reason.", (i) => store.deprecate(i)),
+        note: def(S.NoteInput, "Add a note to an item or subsprint.", (i) => store.addNote(i)),
+        search: def(S.SearchInput, "Regex search over the current sprint's immutable ledger, with context lines.", (i) => store.search(i.pattern, i.context_lines)),
+        dashboard: def(S.DashboardInput, "Start (once) and return the follow-along dashboard URL.", async () => ({ url: await openDashboard() })),
+    };
+}
+function orientation() {
+    return {
+        skills: ["how-to-run-a-sprint", "using-sprinty"],
+        how: "One sprint per session. Build item-driven: subsprint_new -> add -> done/split/deprecate. " +
+            "Items need description + code_locations + gates. Resolve every item, then sprint_close re-runs gates.",
+    };
+}
+//# sourceMappingURL=register.js.map

package/dist/tools/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../src/tools/register.ts"],"names":[],"mappings":"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"}

package/dist/tools/schemas.d.ts

@@ -0,0 +1,189 @@
+import { z } from "zod";
+export declare const SprintNewInput: z.ZodObject<{
+    goal: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    goal: string;
+}, {
+    goal: string;
+}>;
+export declare const SprintCloseInput: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const InfoInput: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const CurrentInput: z.ZodObject<{
+    past: z.ZodDefault<z.ZodNumber>;
+    future: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    past: number;
+    future: number;
+}, {
+    past?: number | undefined;
+    future?: number | undefined;
+}>;
+export declare const SubsprintNewInput: z.ZodObject<{
+    description: z.ZodString;
+    goals: z.ZodArray<z.ZodString, "many">;
+    gates: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<["test", "typecheck", "build", "command", "manual"]>;
+        spec: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "test" | "typecheck" | "build" | "command" | "manual";
+        spec: string;
+    }, {
+        kind: "test" | "typecheck" | "build" | "command" | "manual";
+        spec: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    goals: string[];
+    gates: {
+        kind: "test" | "typecheck" | "build" | "command" | "manual";
+        spec: string;
+    }[];
+}, {
+    description: string;
+    goals: string[];
+    gates: {
+        kind: "test" | "typecheck" | "build" | "command" | "manual";
+        spec: string;
+    }[];
+}>;
+export declare const AddInput: z.ZodObject<{
+    subsprint: z.ZodString;
+    description: z.ZodString;
+    code_locations: z.ZodArray<z.ZodString, "many">;
+    gates: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<["test", "typecheck", "build", "command", "manual"]>;
+        spec: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "test" | "typecheck" | "build" | "command" | "manual";
+        spec: string;
+    }, {
+        kind: "test" | "typecheck" | "build" | "command" | "manual";
+        spec: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    gates: {
+        kind: "test" | "typecheck" | "build" | "command" | "manual";
+        spec: string;
+    }[];
+    code_locations: string[];
+    subsprint: string;
+}, {
+    description: string;
+    gates: {
+        kind: "test" | "typecheck" | "build" | "command" | "manual";
+        spec: string;
+    }[];
+    code_locations: string[];
+    subsprint: string;
+}>;
+export declare const UpdateInput: z.ZodObject<{
+    target: z.ZodString;
+    note: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    note: string;
+    target: string;
+}, {
+    note: string;
+    target: string;
+}>;
+export declare const DoneInput: z.ZodObject<{
+    item: z.ZodString;
+    commit_id: z.ZodString;
+    gate_results: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<["test", "typecheck", "build", "command", "manual"]>;
+        spec: z.ZodString;
+        passed: z.ZodBoolean;
+        evidence: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "test" | "typecheck" | "build" | "command" | "manual";
+        spec: string;
+        passed: boolean;
+        evidence: string;
+    }, {
+        kind: "test" | "typecheck" | "build" | "command" | "manual";
+        spec: string;
+        passed: boolean;
+        evidence: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    commit_id: string;
+    gate_results: {
+        kind: "test" | "typecheck" | "build" | "command" | "manual";
+        spec: string;
+        passed: boolean;
+        evidence: string;
+    }[];
+    item: string;
+}, {
+    commit_id: string;
+    gate_results: {
+        kind: "test" | "typecheck" | "build" | "command" | "manual";
+        spec: string;
+        passed: boolean;
+        evidence: string;
+    }[];
+    item: string;
+}>;
+export declare const SplitInput: z.ZodObject<{
+    item: z.ZodString;
+    description: z.ZodString;
+    goals: z.ZodArray<z.ZodString, "many">;
+    gates: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<["test", "typecheck", "build", "command", "manual"]>;
+        spec: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "test" | "typecheck" | "build" | "command" | "manual";
+        spec: string;
+    }, {
+        kind: "test" | "typecheck" | "build" | "command" | "manual";
+        spec: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    goals: string[];
+    gates: {
+        kind: "test" | "typecheck" | "build" | "command" | "manual";
+        spec: string;
+    }[];
+    item: string;
+}, {
+    description: string;
+    goals: string[];
+    gates: {
+        kind: "test" | "typecheck" | "build" | "command" | "manual";
+        spec: string;
+    }[];
+    item: string;
+}>;
+export declare const DeprecateInput: z.ZodObject<{
+    item: z.ZodString;
+    reason: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    reason: string;
+    item: string;
+}, {
+    reason: string;
+    item: string;
+}>;
+export declare const NoteInput: z.ZodObject<{
+    element: z.ZodString;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    element: string;
+}, {
+    text: string;
+    element: string;
+}>;
+export declare const SearchInput: z.ZodObject<{
+    pattern: z.ZodString;
+    context_lines: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    pattern: string;
+    context_lines: number;
+}, {
+    pattern: string;
+    context_lines?: number | undefined;
+}>;
+export declare const DashboardInput: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;

package/dist/tools/schemas.js

@@ -0,0 +1,40 @@
+import { z } from "zod";
+import { Gate, GateResult } from "../domain/gates.js";
+export const SprintNewInput = z.object({ goal: z.string().min(1) });
+export const SprintCloseInput = z.object({});
+export const InfoInput = z.object({});
+export const CurrentInput = z.object({
+    past: z.number().int().nonnegative().default(1),
+    future: z.number().int().nonnegative().default(3),
+});
+export const SubsprintNewInput = z.object({
+    description: z.string().min(1),
+    goals: z.array(z.string().min(1)).min(1),
+    gates: z.array(Gate).min(1),
+});
+export const AddInput = z.object({
+    subsprint: z.string().min(1),
+    description: z.string().min(1),
+    code_locations: z.array(z.string().min(1)).min(1),
+    gates: z.array(Gate).min(1),
+});
+export const UpdateInput = z.object({ target: z.string().min(1), note: z.string().min(1) });
+export const DoneInput = z.object({
+    item: z.string().min(1),
+    commit_id: z.string().min(7),
+    gate_results: z.array(GateResult).min(1),
+});
+export const SplitInput = z.object({
+    item: z.string().min(1),
+    description: z.string().min(1),
+    goals: z.array(z.string().min(1)).min(1),
+    gates: z.array(Gate).min(1),
+});
+export const DeprecateInput = z.object({ item: z.string().min(1), reason: z.string().min(1) });
+export const NoteInput = z.object({ element: z.string().min(1), text: z.string().min(1) });
+export const SearchInput = z.object({
+    pattern: z.string().min(1),
+    context_lines: z.number().int().nonnegative().default(0),
+});
+export const DashboardInput = z.object({});
+//# sourceMappingURL=schemas.js.map

package/dist/tools/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/tools/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACpE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAC7C,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACtC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;CAClD,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CAC5B,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CAC5B,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC5F,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACzC,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CAC5B,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC/F,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC3F,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;CACzD,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "sprinty-mcp",
+  "version": "0.1.0",
+  "description": "Disciplined sprint MCP for Claude Code, Codex, and Gemini",
+  "type": "module",
+  "license": "Apache-2.0",
+  "author": "Elie Bursztein",
+  "homepage": "https://github.com/ebursztein/sprinty",
+  "repository": { "type": "git", "url": "git+https://github.com/ebursztein/sprinty.git" },
+  "bugs": { "url": "https://github.com/ebursztein/sprinty/issues" },
+  "bin": { "sprinty-mcp": "dist/index.js" },
+  "files": ["dist", "skills"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "pretest": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0",
+    "@vitest/coverage-v8": "^2.0.0",
+    "@types/node": "^22.0.0"
+  },
+  "engines": { "node": ">=20" }
+}

package/skills/how-to-run-a-sprint/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: how-to-run-a-sprint
+description: Use at the start of any non-trivial change to run a disciplined, ledgered sprint via the sprinty MCP. Covers the open -> item-driven build -> resolve -> close loop and the gates.
+---
+
+# How to run a sprint
+
+A sprint is one focused unit of work for this session. It is item-driven: you do not
+write prose plans, you create structured items the sprinty MCP records in an immutable ledger.
+
+## The loop
+
+1. **`sprint_new(goal)`** — one sentence of intent. Returns the skills to use and a primer.
+   Call **`info()`** any time to re-orient (especially after a context reset).
+2. **`subsprint_new(description, goals[], gates[])`** — carve the work into a goal-bearing unit.
+   A gate is always *about something*: `{ kind: test|typecheck|build|command|manual, spec }`.
+3. **`add(subsprint, description, code_locations[], gates[])`** — add an item. All three are
+   required. The item's gates are what proves it; a `test`-kind gate is the test you must write.
+4. Work the item. Use **`update(target, note)`** to record intermediate discoveries, and
+   **`note(element, text)`** for observations on an item or subsprint.
+5. Resolve every item exactly one way:
+   - **`done(item, commit_id, gate_results[])`** — completed. Requires a *real* commit and
+     passing gate results. The server verifies the commit exists.
+   - **`split(item, description, goals[], gates[])`** — the item was too big; it becomes a new
+     subsprint (atomically resolved as `split`). Then `add` items into the new subsprint.
+   - **`deprecate(item, reason)`** — drop it, on the record, with a real reason.
+6. **`sprint_close()`** — the teeth. It re-runs every executable gate and refuses to close if any
+   item is unresolved, any completed item lacks a commit, or any gate fails. Read the blockers,
+   fix them, close again.
+
+## Rules
+
+- Never invent an id. The server mints `S01`, `S01-001`. Read them back from tool results.
+- No item without a description, at least one code location, and at least one gate.
+- Don't go out of order: orient with `info()`/`current()` before adding or resolving.
+- The ledger is append-only. You cannot un-say a resolution — resolve honestly.
+- Want to watch it live? **`dashboard()`** returns a URL that auto-refreshes.
+- Search the immutable record anytime with **`search(pattern, context_lines)`** (regex + grep-style context).
+- One sprint open at a time. Start a new sprint only after `sprint_close()` accepts the current one.

package/skills/using-sprinty/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: using-sprinty
+description: Reference for the sprinty MCP tools — exact inputs, what each returns, and the failure modes. Use when you need the precise contract of a sprinty tool.
+---
+
+# Using sprinty (tool reference)
+
+| Tool | Input | Returns / Rejects |
+|---|---|---|
+| `sprint_new` | `{ goal }` | sprint view + orientation. Rejects if a sprint is already open. |
+| `info` | `{}` | full sprint view (subsprints + items + statuses). |
+| `current` | `{ past?=1, future?=3 }` | last resolved items, next open items, current subsprint notes. |
+| `subsprint_new` | `{ description, goals[], gates[] }` | `{ id: "S0N", … }`. |
+| `add` | `{ subsprint, description, code_locations[], gates[] }` | `{ id: "S0N-00M", … }`. Rejects unknown subsprint. |
+| `update` | `{ target, note }` | view. Rejects unknown target. |
+| `done` | `{ item, commit_id, gate_results[] }` | view. Rejects fake commit / failing gate / already resolved. |
+| `split` | `{ item, description, goals[], gates[] }` | view. Item → `split`, new subsprint seeded. |
+| `deprecate` | `{ item, reason }` | view. Requires non-empty reason. |
+| `note` | `{ element, text }` | view. `element` is an item or subsprint id. |
+| `search` | `{ pattern, context_lines?=0 }` | regex matches over the current sprint ledger, with context lines. |
+| `sprint_close` | `{}` | closed view, or an error listing every blocker. |
+| `dashboard` | `{}` | `{ url }` — read-only live view. |
+
+**Gate shape:** `{ kind: "test"|"typecheck"|"build"|"command"|"manual", spec }`.
+Executable kinds are re-run at `sprint_close`; `manual` relies on recorded evidence.
+
+**GateResult shape (for `done`):** `{ kind, spec, passed, evidence }`. `passed:false` is rejected.
+
+**Storage:** one append-only JSONL ledger per sprint under `.sprinty/`, with a `.sprinty/current`
+pointer naming the active sprint (this enforces one-open-sprint unicity). `.sprinty/` is per
+working tree, so git worktrees run independent sprints.