@trieungoctam/speckit 0.3.5 → 0.4.0

package/README.md

@@ -23,6 +23,10 @@ npx @trieungoctam/speckit@latest sync
 npx @trieungoctam/speckit@latest graph setup
 npx @trieungoctam/speckit@latest sprint plan
 npx @trieungoctam/speckit@latest graph triage --json
+npx @trieungoctam/speckit@latest team status .speckit/stories/<story>.md
+npx @trieungoctam/speckit@latest team audit .speckit/stories/<story>.md --json
+npx @trieungoctam/speckit@latest team handoff .speckit/stories/<story>.md --from dev --to qa
+npx @trieungoctam/speckit@latest score .speckit/stories/<story>.md
 npx @trieungoctam/speckit@latest validate --json
 npx @trieungoctam/speckit@latest permissions audit --path .env --json
 npx @trieungoctam/speckit@latest ready .speckit/stories/<story>.md
@@ -30,6 +34,8 @@ npx @trieungoctam/speckit@latest session checkpoint --note "red complete"
 npx @trieungoctam/speckit@latest review
 ```
 
+Interactive CLI output is colorized when the terminal supports ANSI colors. Use `NO_COLOR=1` to disable colors, or `SPECKIT_COLOR=1` to force colors for demos and snapshots.
+
 Or install globally:
 
 ```bash
@@ -83,6 +89,11 @@ For implementation stories, red-green-refactor evidence is mandatory. A story is
 | `speckit session compact` | Create an anchored summary for resume or handoff. |
 | `speckit session resume` | Mark a session as active and print its handoff path. |
 | `speckit session status` | Print active session state paths. |
+| `speckit team status <story>` | Show role-by-role team artifact readiness for a story. |
+| `speckit team audit <story>` | Run enterprise review-gate checks and return nonzero when blockers remain. |
+| `speckit team handoff <story>` | Create a durable role-to-role handoff artifact. |
+| `speckit score` | Score project workflow health across contract, team model, context/session, and graph sync. |
+| `speckit score <story>` | Score story health across team readiness, developer trace, TDD evidence, and review gate. |
 | `speckit shape "<intent>"` | Create a short spec contract. |
 | `speckit context <story>` | Build the current implementation context from a story. |
 | `speckit quick "<intent>"` | Create one story plus matching TDD evidence file. |
@@ -116,6 +127,7 @@ See `docs/adapters.md` for exact output paths.
 ## Guides
 
 - `docs/use-cases.md` covers setup, migration, quick changes, full planning, long sessions, TDD, graph automation, review, CI, and troubleshooting.
+- `docs/team-workflow.md` covers enterprise role ownership, status, audit, and handoff flow.
 - `docs/beads-viewer-setup.md` covers Beads Viewer installation, `bv` verification, and robot-safe graph usage.
 - `docs/workflow-model.md` describes the quick and full workflow lanes.
 - `docs/prompt-architecture.md` describes the prompt contract used by the super-agent, skills, workflows, run prompt, and IDE adapters.

package/dist/cli.js

@@ -9,6 +9,8 @@ import { planCommand } from "./commands/plan.js";
 import { memoryCommand } from "./commands/memory.js";
 import { permissionsCommand } from "./commands/permissions.js";
 import { sessionCommand } from "./commands/session.js";
+import { teamCommand } from "./commands/team.js";
+import { scoreCommand } from "./commands/score.js";
 import { sprintCommand } from "./commands/sprint.js";
 import { graphCommand } from "./commands/graph.js";
 import { validateCommand } from "./commands/validate.js";
@@ -19,6 +21,7 @@ import { runCommand } from "./commands/run.js";
 import { readyCommand } from "./commands/ready.js";
 import { reviewCommand } from "./commands/review.js";
 import { closeCommand } from "./commands/close.js";
+import { createColors } from "./core/colors.js";
 export async function main(argv = process.argv.slice(2), root = process.cwd()) {
     const parsed = parseArgs(argv);
     try {
@@ -65,6 +68,21 @@ export async function main(argv = process.argv.slice(2), root = process.cwd()) {
                     note: value(parsed, "note"),
                     json: has(parsed, "json"),
                 });
+            case "team":
+                return teamCommand({
+                    root,
+                    action: requiredAction(parsed),
+                    target: parsed.args.slice(1).join(" ").trim() || undefined,
+                    from: value(parsed, "from"),
+                    to: value(parsed, "to"),
+                    json: has(parsed, "json"),
+                });
+            case "score":
+                return scoreCommand({
+                    root,
+                    target: parsed.args.join(" ").trim() || undefined,
+                    json: has(parsed, "json"),
+                });
             case "sprint":
                 return sprintCommand({ root, action: requiredAction(parsed), json: has(parsed, "json") });
             case "graph":
@@ -145,7 +163,8 @@ function isHelp(parsed) {
     return parsed.command === "help" || parsed.command === "--help" || parsed.command === "-h" || has(parsed, "help");
 }
 function printHelp() {
-    console.log(`Speckit - Agile + TDD workflow compiler for agentic IDEs
+    const colors = createColors();
+    console.log(`${colors.bold(colors.cyan("Speckit"))} - Agile + TDD workflow compiler for agentic IDEs
 
 Usage:
   speckit setup
@@ -160,6 +179,8 @@ Usage:
   speckit memory refresh
   speckit permissions audit [--path <path>] [--command <command>] [--json]
   speckit session start|checkpoint|compact|resume|status [target] [--note "..."] [--json]
+  speckit team status|audit|handoff <story-path-or-id> [--from <role>] [--to <role>] [--json]
+  speckit score [story-path-or-id] [--json]
   speckit sprint plan|next [--json]
   speckit graph setup|triage|plan|insights [--json]
   speckit validate [--json]

package/dist/commands/doctor.js

@@ -6,8 +6,10 @@ import { detectTestCommands } from "../core/test-detection.js";
 import { coreFiles, enterpriseFiles } from "../core/scaffold.js";
 import { agentFiles } from "../core/agent-scaffold.js";
 import { validateWorkflowContract } from "../core/workflow-validator.js";
+import { createColors } from "../core/colors.js";
 export async function doctorCommand(options) {
     const stdout = options.stdout ?? console;
+    const colors = createColors();
     const tools = checkTools();
     const tests = await detectTestCommands(options.root);
     const deepChecks = options.deep ? await runDeepChecks(options.root) : [];
@@ -29,24 +31,25 @@ export async function doctorCommand(options) {
         stdout.log(JSON.stringify(report, null, 2));
     }
     else {
-        stdout.log(`Speckit doctor: ${report.status}`);
-        stdout.log(`Node: ${report.node}`);
-        stdout.log(`Tools: ${tools.map((tool) => `${tool.name}=${tool.available ? "ok" : "missing"}`).join(", ")}`);
+        stdout.log(`${colors.bold("Speckit doctor")}: ${colors.status(report.status === "ok", "ok", report.status)}`);
+        stdout.log(`${colors.bold("Node")}: ${report.node}`);
+        stdout.log(`Tools: ${tools.map((tool) => `${tool.name}=${colors.status(tool.available)}`).join(", ")}`);
         for (const tool of tools.filter((tool) => !tool.available)) {
-            stdout.log(`Tool hint ${tool.name}: ${tool.hint}`);
+            stdout.log(`${colors.yellow("Tool hint")} ${tool.name}: ${tool.hint}`);
             if (tool.install?.length) {
-                stdout.log(`Install ${tool.name}: ${tool.install.join(" OR ")}`);
+                stdout.log(`${colors.cyan(`Install ${tool.name}`)}: ${tool.install.join(" OR ")}`);
             }
         }
-        stdout.log(`Tests: ${tests[0]?.command ?? "not detected"}`);
+        stdout.log(`${colors.bold("Tests")}: ${tests[0]?.command ?? colors.yellow("not detected")}`);
         for (const check of deepChecks) {
-            stdout.log(`Deep ${check.name}: ${check.ok ? "ok" : "missing"}`);
+            stdout.log(`Deep ${check.name}: ${colors.status(check.ok)}`);
         }
         for (const check of contractChecks) {
-            stdout.log(`Contract ${check.name}: ${check.ok ? "ok" : check.detail}`);
+            stdout.log(`Contract ${check.name}: ${check.ok ? colors.green("ok") : colors.red(check.detail)}`);
         }
         for (const adapter of adapters) {
-            stdout.log(`Adapter ${adapter.name}: ${adapter.present}/${adapter.total} files present`);
+            const ok = adapter.present === adapter.total;
+            stdout.log(`Adapter ${adapter.name}: ${colors.status(ok, `${adapter.present}/${adapter.total}`, `${adapter.present}/${adapter.total}`)} files present`);
         }
     }
     return report.status === "ok" ? 0 : 1;

package/dist/commands/graph.js

@@ -1,6 +1,7 @@
 import { spawnSync } from "node:child_process";
 import { beadsViewerInstallGuide, checkTools, commandExists } from "../adapters/tool-checks.js";
 import { prepareBeadsMirror } from "../core/beads-mirror.js";
+import { createColors } from "../core/colors.js";
 import { readSyncedStories, selectableStories } from "../core/synced-stories.js";
 const robotActions = new Map([
     ["triage", "--robot-triage"],
@@ -37,6 +38,7 @@ export async function graphCommand(options) {
 }
 async function graphSetup(options) {
     const stdout = options.stdout ?? console;
+    const colors = createColors();
     const tools = checkTools().filter((tool) => ["br", "bd", "bv"].includes(tool.name));
     const mirrorPath = await prepareBeadsMirror(options.root);
     const report = {
@@ -51,9 +53,9 @@ async function graphSetup(options) {
     else {
         stdout.log(beadsViewerInstallGuide());
         stdout.log("");
-        stdout.log(`Mirror: ${mirrorPath}`);
+        stdout.log(`${colors.bold("Mirror")}: ${colors.cyan(mirrorPath)}`);
         for (const tool of tools) {
-            stdout.log(`${tool.name}: ${tool.available ? "ok" : "missing"} - ${tool.hint}`);
+            stdout.log(`${colors.bold(tool.name)}: ${colors.status(tool.available)} - ${colors.dim(tool.hint)}`);
         }
     }
     return 0;

package/dist/commands/init.js

@@ -2,8 +2,10 @@ import { coreFiles, enterpriseFiles } from "../core/scaffold.js";
 import { agentFiles } from "../core/agent-scaffold.js";
 import { writeManagedFiles } from "../core/managed-files.js";
 import { getAdapters } from "../config/adapter-registry.js";
+import { createColors } from "../core/colors.js";
 export async function initCommand(options) {
     const stdout = options.stdout ?? console;
+    const colors = createColors();
     const selectedIde = options.ide ?? "all";
     const sharedFiles = [...coreFiles(), ...agentFiles()];
     const baseFiles = options.enterprise ? [...sharedFiles, ...enterpriseFiles()] : sharedFiles;
@@ -13,9 +15,9 @@ export async function initCommand(options) {
     const updated = results.filter((result) => result.status === "updated").length;
     const skipped = results.filter((result) => result.status === "skipped");
     const mode = options.enterprise ? "enterprise" : "standard";
-    stdout.log(`Speckit initialized (${mode}): ${created} created, ${updated} updated, ${skipped.length} skipped.`);
+    stdout.log(`${colors.bold("Speckit initialized")} (${colors.cyan(mode)}): ${colors.green(String(created))} created, ${colors.yellow(String(updated))} updated, ${colors.status(skipped.length === 0, String(skipped.length), String(skipped.length))} skipped.`);
     for (const result of skipped) {
-        stdout.log(`skipped ${result.path}: ${result.reason}`);
+        stdout.log(`${colors.yellow("skipped")} ${result.path}: ${result.reason}`);
     }
     return skipped.length > 0 ? 2 : 0;
 }

package/dist/commands/plan.js

@@ -40,16 +40,49 @@ export async function planCommand(options) {
 evidence: ${dir}/tdd-evidence.md
 context: pending`, `# Story: ${options.intent}
 
+## Business Goal
+- Goal: ${options.intent}
+- Priority: medium
+- Success signal:
+
 ## Acceptance Criteria
 - Given ...
 - When ...
 - Then ...
 
+## Edge Cases
+- Boundary:
+- Error path:
+- State transition:
+
+## Implementation Scope
+- In scope:
+- Out of scope:
+- Files likely to read:
+- Files likely to modify:
+
+## Architecture Notes
+- Constraints:
+- Integration points:
+- Risks:
+
 ## TDD Evidence File
 \`${dir}/tdd-evidence.md\`
 
 ## Implementation Notes
 
+## Dev Agent Record
+### Test Intent
+
+### Debug Log
+
+### Completion Notes
+
+### File List
+
+## Change Log
+- ${new Date().toISOString().slice(0, 10)}: Story drafted.
+
 ## Spec Anti-Mistake Checklist
 - Reuse existing project patterns before adding new files.
 - Verify file locations before editing.
@@ -62,11 +95,15 @@ context: pending`, `# Story: ${options.intent}
             content: markdownWithFrontmatter(`status: missing
 story: ${dir}/story.md`, `# TDD Evidence: ${options.intent}
 
+## Test Intent
+
 ## Red
 
 ## Green
 
 ## Refactor
+
+## Review Evidence
 `),
         },
     ];

package/dist/commands/quick.js

@@ -18,11 +18,32 @@ context: pending`, `# Story: ${options.intent}
 ## Intent
 ${options.intent}
 
+## Business Goal
+- Goal: ${options.intent}
+- Priority: medium
+- Success signal: behavior is covered by executable tests and Speckit evidence
+
 ## Acceptance Criteria
 - Given the current product state
 - When this story is implemented
 - Then the behavior is covered by executable tests and Speckit evidence
 
+## Edge Cases
+- Boundary: document the smallest input, state, or permission boundary this story touches.
+- Error path: document how failures are surfaced or recovered.
+- State transition: document before and after behavior.
+
+## Implementation Scope
+- In scope: the smallest change needed to satisfy the acceptance criteria.
+- Out of scope: unrelated refactors, new dependencies, or behavior not tied to acceptance criteria.
+- Files likely to read:
+- Files likely to modify:
+
+## Architecture Notes
+- Constraints: reuse existing project patterns before adding new abstractions.
+- Integration points:
+- Risks:
+
 ## TDD Checklist
 - [ ] Test target identified
 - [ ] Red evidence recorded in ${evidencePath}
@@ -38,6 +59,18 @@ ${options.intent}
 - Do not introduce new libraries without explicit need.
 - Preserve existing behavior unless an acceptance criterion requires change.
 - Update docs only when behavior or workflow changes.
+
+## Dev Agent Record
+### Test Intent
+
+### Debug Log
+
+### Completion Notes
+
+### File List
+
+## Change Log
+- ${new Date().toISOString().slice(0, 10)}: Story drafted.
 `),
         },
         {
@@ -58,6 +91,11 @@ story: ${storyPath}`, `# TDD Evidence: ${options.intent}
 ## Refactor
 - Command: \`${testCommand}\`
 - Result:
+
+## Review Evidence
+- Reviewer:
+- Outcome:
+- Follow-ups:
 `),
         },
     ]);

package/dist/commands/ready.js

@@ -1,20 +1,22 @@
 import { evaluateReadiness } from "../core/readiness.js";
+import { createColors } from "../core/colors.js";
 export async function readyCommand(options) {
     const stdout = options.stdout ?? console;
+    const colors = createColors();
     const report = await evaluateReadiness(options.root, options.target);
     if (options.json) {
         stdout.log(JSON.stringify(report, null, 2));
         return report.status === "ready" ? 0 : 1;
     }
-    stdout.log(`# Speckit Readiness: ${report.status}`);
+    stdout.log(`# ${colors.bold("Speckit Readiness")}: ${colors.status(report.status === "ready", "ready", report.status)}`);
     if (report.story) {
-        stdout.log(`Story: ${report.story.path}`);
+        stdout.log(`${colors.bold("Story")}: ${colors.cyan(report.story.path)}`);
     }
     for (const check of report.checks) {
-        stdout.log(`- ${check.ok ? "ok" : "blocked"} ${check.name}: ${check.detail}`);
+        stdout.log(`- ${colors.status(check.ok, "ok", "blocked")} ${check.name}: ${check.detail}`);
     }
     if (report.status !== "ready") {
-        stdout.error("Run the suggested setup commands before `speckit run`.");
+        stdout.error(colors.yellow("Run the suggested setup commands before `speckit run`."));
     }
     return report.status === "ready" ? 0 : 1;
 }

package/dist/commands/score.d.ts

@@ -0,0 +1,7 @@
+export type ScoreOptions = {
+    root: string;
+    target?: string;
+    json?: boolean;
+    stdout?: Pick<typeof console, "log">;
+};
+export declare function scoreCommand(options: ScoreOptions): Promise<number>;

package/dist/commands/score.js

@@ -0,0 +1,29 @@
+import { createColors } from "../core/colors.js";
+import { calculateSpecScore } from "../core/spec-score.js";
+export async function scoreCommand(options) {
+    const stdout = options.stdout ?? console;
+    const report = await calculateSpecScore(options.root, options.target);
+    stdout.log(options.json ? JSON.stringify(report, null, 2) : renderScore(report));
+    return report.status === "blocked" ? 1 : 0;
+}
+function renderScore(report) {
+    const colors = createColors();
+    const lines = [
+        `${colors.bold("Spec Runtime Score")}: ${colors.status(report.score >= 75, `${report.score}/100`, `${report.score}/100`)}`,
+        `Status: ${report.status}`,
+    ];
+    if (report.target)
+        lines.push(`Target: ${colors.cyan(report.target)}`);
+    lines.push("");
+    for (const category of report.categories) {
+        const ok = category.score >= 75;
+        lines.push(`${colors.status(ok, String(category.score), String(category.score)).padStart(colors.enabled ? 12 : 3)} ${category.name}: ${category.passed}/${category.total} - ${category.detail}`);
+    }
+    lines.push("", "Recommendations:");
+    lines.push(...report.recommendations.map((item) => `- ${item}`));
+    if (report.blockers.length) {
+        lines.push("", "Blockers:");
+        lines.push(...report.blockers.map((item) => `- ${item}`));
+    }
+    return lines.join("\n");
+}

package/dist/commands/setup.js

@@ -1,5 +1,6 @@
 import { createInterface } from "node:readline/promises";
 import { adapters } from "../config/adapter-registry.js";
+import { createColors } from "../core/colors.js";
 import { graphCommand } from "./graph.js";
 import { initCommand } from "./init.js";
 const modeChoices = [
@@ -17,6 +18,7 @@ export async function setupCommand(options) {
     const stdin = options.stdin ?? process.stdin;
     const output = options.output ?? process.stdout;
     const stdout = options.stdout ?? console;
+    const colors = createColors(output);
     if (options.answers) {
         return setupFromAnswers(options, stdout, options.answers);
     }
@@ -26,14 +28,14 @@ export async function setupCommand(options) {
     }
     const rl = createInterface({ input: stdin, output });
     try {
-        stdout.log("Speckit setup");
+        stdout.log(colors.bold(colors.cyan("Speckit setup")));
         stdout.log("");
-        const mode = await select(rl, stdout, modeChoices, "Choose setup mode", "1");
-        const ide = await select(rl, stdout, ideChoices, "Choose IDE adapter", "1");
-        const force = await confirm(rl, stdout, "Overwrite unmanaged files if needed?", false);
-        const configureGraph = await confirm(rl, stdout, "Run Beads Viewer setup after init?", true);
+        const mode = await select(rl, stdout, modeChoices, "Choose setup mode", "1", colors);
+        const ide = await select(rl, stdout, ideChoices, "Choose IDE adapter", "1", colors);
+        const force = await confirm(rl, stdout, "Overwrite unmanaged files if needed?", false, colors);
+        const configureGraph = await confirm(rl, stdout, "Run Beads Viewer setup after init?", true, colors);
         stdout.log("");
-        stdout.log(`Selected: ${mode}, ide=${ide}, force=${force ? "yes" : "no"}, graph=${configureGraph ? "yes" : "no"}`);
+        stdout.log(colors.dim(`Selected: ${mode}, ide=${ide}, force=${force ? "yes" : "no"}, graph=${configureGraph ? "yes" : "no"}`));
         stdout.log("");
         const initExit = await initCommand({
             root: options.root,
@@ -53,14 +55,15 @@ export async function setupCommand(options) {
     }
 }
 async function setupFromAnswers(options, stdout, answers) {
-    stdout.log("Speckit setup");
+    const colors = createColors();
+    stdout.log(colors.bold(colors.cyan("Speckit setup")));
     stdout.log("");
-    const mode = selectAnswer(stdout, modeChoices, "Choose setup mode", "1", answers.shift());
-    const ide = selectAnswer(stdout, ideChoices, "Choose IDE adapter", "1", answers.shift());
+    const mode = selectAnswer(stdout, modeChoices, "Choose setup mode", "1", answers.shift(), colors);
+    const ide = selectAnswer(stdout, ideChoices, "Choose IDE adapter", "1", answers.shift(), colors);
     const force = confirmAnswer("Overwrite unmanaged files if needed?", false, answers.shift());
     const configureGraph = confirmAnswer("Run Beads Viewer setup after init?", true, answers.shift());
     stdout.log("");
-    stdout.log(`Selected: ${mode}, ide=${ide}, force=${force ? "yes" : "no"}, graph=${configureGraph ? "yes" : "no"}`);
+    stdout.log(colors.dim(`Selected: ${mode}, ide=${ide}, force=${force ? "yes" : "no"}, graph=${configureGraph ? "yes" : "no"}`));
     stdout.log("");
     const initExit = await initCommand({
         root: options.root,
@@ -75,9 +78,9 @@ async function setupFromAnswers(options, stdout, answers) {
     }
     return initExit;
 }
-function selectAnswer(stdout, choices, prompt, defaultValue, answer) {
-    stdout.log(prompt);
-    choices.forEach((choice, index) => stdout.log(`  ${index + 1}. ${choice.label}`));
+function selectAnswer(stdout, choices, prompt, defaultValue, answer, colors = createColors()) {
+    stdout.log(colors.bold(prompt));
+    choices.forEach((choice, index) => stdout.log(`  ${colors.cyan(String(index + 1))}. ${choice.label}`));
     const selected = (answer?.trim() || defaultValue);
     const index = Number.parseInt(selected, 10) - 1;
     if (!Number.isInteger(index) || !choices[index]) {
@@ -96,33 +99,33 @@ function confirmAnswer(prompt, defaultValue, answer) {
         return false;
     throw new Error(`Invalid yes/no answer for "${prompt}": ${answer}`);
 }
-async function select(rl, stdout, choices, prompt, defaultValue) {
+async function select(rl, stdout, choices, prompt, defaultValue, colors = createColors()) {
     for (;;) {
-        stdout.log(prompt);
+        stdout.log(colors.bold(prompt));
         choices.forEach((choice, index) => {
             const number = String(index + 1);
-            stdout.log(`  ${number}. ${choice.label}`);
+            stdout.log(`  ${colors.cyan(number)}. ${choice.label}`);
         });
-        const answer = (await rl.question(`Select [${defaultValue}]: `)).trim() || defaultValue;
+        const answer = (await rl.question(`${colors.dim("Select")} [${colors.cyan(defaultValue)}]: `)).trim() || defaultValue;
         const index = Number.parseInt(answer, 10) - 1;
         if (Number.isInteger(index) && choices[index]) {
             stdout.log("");
             return choices[index].value;
         }
-        stdout.log(`Invalid selection: ${answer}`);
+        stdout.log(colors.red(`Invalid selection: ${answer}`));
         stdout.log("");
     }
 }
-async function confirm(rl, stdout, prompt, defaultValue) {
+async function confirm(rl, stdout, prompt, defaultValue, colors = createColors()) {
     const suffix = defaultValue ? "Y/n" : "y/N";
     for (;;) {
-        const answer = (await rl.question(`${prompt} [${suffix}]: `)).trim().toLowerCase();
+        const answer = (await rl.question(`${prompt} [${colors.cyan(suffix)}]: `)).trim().toLowerCase();
         if (!answer)
             return defaultValue;
         if (["y", "yes"].includes(answer))
             return true;
         if (["n", "no"].includes(answer))
             return false;
-        stdout.log("Please answer y or n.");
+        stdout.log(colors.yellow("Please answer y or n."));
     }
 }

package/dist/commands/sync.js

@@ -3,8 +3,10 @@ import { join } from "node:path";
 import { markdown, writeManagedFiles } from "../core/managed-files.js";
 import { firstHeading, frontmatterValue } from "../core/story.js";
 import { writeBeadsMirror } from "../core/beads-mirror.js";
+import { createColors } from "../core/colors.js";
 export async function syncCommand(options) {
     const stdout = options.stdout ?? console;
+    const colors = createColors();
     const storiesDir = join(options.root, ".speckit", "stories");
     let entries;
     try {
@@ -45,7 +47,7 @@ bv --robot-next --format json
         },
     ], true);
     const beadsPath = await writeBeadsMirror(options.root, stories);
-    stdout.log(`Synced ${stories.length} stories to .speckit/sync/beads-sync.jsonl`);
-    stdout.log(`Prepared Beads Viewer mirror at ${beadsPath}`);
+    stdout.log(`Synced ${colors.cyan(String(stories.length))} stories to ${colors.cyan(".speckit/sync/beads-sync.jsonl")}`);
+    stdout.log(`Prepared Beads Viewer mirror at ${colors.cyan(beadsPath)}`);
     return 0;
 }

package/dist/commands/team.d.ts

@@ -0,0 +1,10 @@
+export type TeamOptions = {
+    root: string;
+    action: string;
+    target?: string;
+    from?: string;
+    to?: string;
+    json?: boolean;
+    stdout?: Pick<typeof console, "log" | "error">;
+};
+export declare function teamCommand(options: TeamOptions): Promise<number>;

package/dist/commands/team.js

@@ -0,0 +1,129 @@
+import { buildTeamReport } from "../core/team-report.js";
+import { createColors } from "../core/colors.js";
+import { markdown, writeManagedFiles } from "../core/managed-files.js";
+import { slugify, timestamp } from "../core/slug.js";
+export async function teamCommand(options) {
+    const stdout = options.stdout ?? console;
+    switch (options.action) {
+        case "status":
+            return status(options);
+        case "audit":
+            return audit(options);
+        case "handoff":
+            return handoff(options);
+        default:
+            stdout.error("Usage: speckit team status|audit|handoff <story> [--from <role>] [--to <role>] [--json]");
+            return 1;
+    }
+}
+async function status(options) {
+    const stdout = options.stdout ?? console;
+    const target = requireTarget(options);
+    if (!target)
+        return 1;
+    const report = await buildTeamReport(options.root, target);
+    stdout.log(options.json ? JSON.stringify(report, null, 2) : renderReport(report, "Spec Team Status"));
+    return report.story ? 0 : 1;
+}
+async function audit(options) {
+    const stdout = options.stdout ?? console;
+    const target = requireTarget(options);
+    if (!target)
+        return 1;
+    const report = await buildTeamReport(options.root, target);
+    const auditReport = {
+        gate: "review",
+        status: report.status,
+        story: report.story,
+        blockers: report.blockers,
+        warnings: report.warnings,
+        roles: report.roles,
+    };
+    stdout.log(options.json ? JSON.stringify(auditReport, null, 2) : renderAudit(auditReport));
+    return report.status === "ok" ? 0 : 1;
+}
+async function handoff(options) {
+    const stdout = options.stdout ?? console;
+    const target = requireTarget(options);
+    if (!target)
+        return 1;
+    const report = await buildTeamReport(options.root, target);
+    if (!report.story) {
+        stdout.error(report.blockers[0] ?? `Story not found: ${target}`);
+        return 1;
+    }
+    const from = options.from ?? "current-role";
+    const to = options.to ?? "next-role";
+    const path = `.speckit/team/handoffs/${timestamp()}-${slugify(report.story.id)}-${slugify(from)}-to-${slugify(to)}.md`;
+    await writeManagedFiles(options.root, [
+        {
+            path,
+            content: markdown(`# Spec Team Handoff
+
+## Story
+\`${report.story.path}\`
+
+## Route
+- From: ${from}
+- To: ${to}
+
+## Current Status
+- Story status: ${report.story.status ?? "missing"}
+- Team status: ${report.status}
+
+## Blockers
+${report.blockers.length ? report.blockers.map((item) => `- ${item}`).join("\n") : "- none"}
+
+## Warnings
+${report.warnings.length ? report.warnings.map((item) => `- ${item}`).join("\n") : "- none"}
+
+## Next Role Checklist
+- [ ] Read the story and linked evidence file.
+- [ ] Resolve blockers owned by the target role.
+- [ ] Update durable artifacts before handing off again.
+- [ ] Run \`speckit team audit ${report.story.path}\`.
+`),
+        },
+    ]);
+    stdout.log(path);
+    return 0;
+}
+function renderReport(report, title) {
+    const colors = createColors();
+    if (!report.story)
+        return `${colors.bold(title)}: ${colors.red("blocked")}\n${report.blockers.join("\n")}`;
+    const lines = [
+        `${colors.bold(title)}: ${colors.status(report.status === "ok", "ok", "blocked")}`,
+        `Story: ${colors.cyan(report.story.path)}`,
+        `State: ${report.story.status ?? "missing"}`,
+        "",
+    ];
+    for (const role of report.roles) {
+        lines.push(`${colors.bold(role.role)}: ${colors.status(role.status === "ok", role.status, role.status)}`);
+        for (const check of role.checks) {
+            lines.push(`  - ${colors.status(check.ok)} ${check.name}: ${check.detail}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n").trimEnd();
+}
+function renderAudit(report) {
+    const colors = createColors();
+    return [
+        `${colors.bold("Spec Team Audit")}: ${colors.status(report.status === "ok", "ok", "blocked")}`,
+        `Gate: ${report.gate}`,
+        report.story ? `Story: ${colors.cyan(report.story.path)}` : undefined,
+        "",
+        "Blocking:",
+        ...(report.blockers.length ? report.blockers.map((item) => `- ${item}`) : ["- none"]),
+        "",
+        "Warnings:",
+        ...(report.warnings.length ? report.warnings.map((item) => `- ${item}`) : ["- none"]),
+    ].filter((line) => line !== undefined).join("\n");
+}
+function requireTarget(options) {
+    if (options.target)
+        return options.target;
+    options.stdout?.error("Team command requires a story path or id.");
+    return undefined;
+}