@trieungoctam/speckit 0.3.3 → 0.3.5

package/README.md

@@ -11,6 +11,7 @@ The curated skill set is intentionally small: `spec-shape`, `spec-research`, `sp
 ## Quickstart
 
 ```bash
+npx @trieungoctam/speckit@latest setup
 npx @trieungoctam/speckit@latest init --ide cursor
 npx @trieungoctam/speckit@latest init --ide all
 npx @trieungoctam/speckit@latest init --enterprise --ide all
@@ -19,6 +20,7 @@ npx @trieungoctam/speckit@latest session start "Add checkout validation"
 npx @trieungoctam/speckit@latest quick "Add checkout validation"
 npx @trieungoctam/speckit@latest context .speckit/stories/<story>.md
 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 validate --json
@@ -66,6 +68,7 @@ For implementation stories, red-green-refactor evidence is mandatory. A story is
 
 | Command | Purpose |
 | --- | --- |
+| `speckit setup` | Open an interactive setup wizard for mode, IDE adapter, overwrite policy, and Beads Viewer setup. |
 | `speckit init` | Create `.speckit/` core runtime, super-agent, skill catalog, and all IDE adapters. |
 | `speckit init --enterprise` | Add flow, tool policy, and prompt harness files on top of the shared runtime. |
 | `speckit init --ide <name>` | Generate shared Speckit runtime plus one adapter: `claude-code`, `codex`, `antigravity`, `opencode`, or `cursor`. |
@@ -88,6 +91,7 @@ For implementation stories, red-green-refactor evidence is mandatory. A story is
 | `speckit next` | Safely wraps `bv --robot-next --format json`. |
 | `speckit sprint plan` | Build a sprint plan and status file from synced stories. |
 | `speckit sprint next` | Pick the next selectable story from sprint state. |
+| `speckit graph setup` | Print Beads Viewer install commands, check `br`/`bd`/`bv`, and prepare `.beads/beads.jsonl`. |
 | `speckit graph triage` | Run Beads Viewer robot triage, or local JSON fallback if `bv` is missing. |
 | `speckit graph plan` | Run Beads Viewer robot plan, or local JSON fallback if `bv` is missing. |
 | `speckit graph insights` | Run Beads Viewer robot insights, or local JSON fallback if `bv` is missing. |
@@ -112,6 +116,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/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.
 - `docs/spec-quality-gates.md` describes validation gates for release readiness.

package/dist/adapters/tool-checks.d.ts

@@ -3,6 +3,8 @@ export type ToolCheck = {
     required: boolean;
     available: boolean;
     hint: string;
+    install?: string[];
 };
 export declare function checkTools(): ToolCheck[];
+export declare function beadsViewerInstallGuide(): string;
 export declare function commandExists(command: string): boolean;

package/dist/adapters/tool-checks.js

@@ -1,23 +1,50 @@
 import { spawnSync } from "node:child_process";
 const tools = [
-    ["git", true, "Install Git and run Speckit inside a repository."],
-    ["node", true, "Install Node.js 20 or newer."],
-    ["br", false, "Recommended beads CLI. Use bd only for older projects."],
-    ["bd", false, "Legacy beads CLI fallback."],
-    ["bv", false, "Recommended for Beads Viewer robot commands."],
-    ["claude", false, "Claude Code adapter runtime."],
-    ["codex", false, "Codex adapter runtime."],
-    ["opencode", false, "OpenCode adapter runtime."],
-    ["cursor", false, "Cursor adapter runtime."],
+    ["git", true, "Install Git and run Speckit inside a repository.", ["https://git-scm.com/downloads"]],
+    ["node", true, "Install Node.js 20 or newer.", ["https://nodejs.org/"]],
+    ["br", false, "Recommended beads CLI. Use bd only for older projects.", ["Install beads_rust/br from your team's preferred channel."]],
+    ["bd", false, "Legacy beads CLI fallback.", ["brew install beads", "go install github.com/steveyegge/beads/cmd/bd@latest"]],
+    [
+        "bv",
+        false,
+        "Recommended for Beads Viewer robot commands.",
+        [
+            "brew install dicklesworthstone/tap/bv",
+            "go install github.com/Dicklesworthstone/beads_viewer/cmd/bv@latest",
+            "nix run github:Dicklesworthstone/beads_viewer -- --help",
+        ],
+    ],
+    ["claude", false, "Claude Code adapter runtime.", ["https://docs.anthropic.com/en/docs/claude-code"]],
+    ["codex", false, "Codex adapter runtime.", ["https://developers.openai.com/codex"]],
+    ["opencode", false, "OpenCode adapter runtime.", ["https://opencode.ai/"]],
+    ["cursor", false, "Cursor adapter runtime.", ["https://cursor.com/"]],
 ];
 export function checkTools() {
-    return tools.map(([name, required, hint]) => ({
+    return tools.map(([name, required, hint, install]) => ({
         name,
         required,
         available: commandExists(name),
         hint,
+        install: [...install],
     }));
 }
+export function beadsViewerInstallGuide() {
+    return `Beads Viewer setup
+
+Install bv with one of:
+  brew install dicklesworthstone/tap/bv
+  go install github.com/Dicklesworthstone/beads_viewer/cmd/bv@latest
+  nix run github:Dicklesworthstone/beads_viewer -- --help
+
+Verify:
+  bv --version
+  speckit sync
+  speckit graph triage --json
+
+Rules:
+  Never run bare bv from agents. Use Speckit wrappers or bv --robot-* flags.
+  Speckit writes .beads/beads.jsonl from .speckit stories before graph commands.`;
+}
 export function commandExists(command) {
     const result = spawnSync(command, ["--version"], {
         encoding: "utf8",

package/dist/cli.js

@@ -1,4 +1,5 @@
 import { initCommand } from "./commands/init.js";
+import { setupCommand } from "./commands/setup.js";
 import { doctorCommand } from "./commands/doctor.js";
 import { startCommand } from "./commands/start.js";
 import { shapeCommand } from "./commands/shape.js";
@@ -21,7 +22,13 @@ import { closeCommand } from "./commands/close.js";
 export async function main(argv = process.argv.slice(2), root = process.cwd()) {
     const parsed = parseArgs(argv);
     try {
+        if (isHelp(parsed)) {
+            printHelp();
+            return 0;
+        }
         switch (parsed.command) {
+            case "setup":
+                return setupCommand({ root });
             case "init":
                 return initCommand({
                     root,
@@ -134,10 +141,14 @@ function value(parsed, name) {
 function has(parsed, name) {
     return parsed.flags.has(name);
 }
+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
 
 Usage:
+  speckit setup
   speckit init [--ide all|claude-code|codex|antigravity|opencode|cursor] [--force]
   speckit init --enterprise [--ide all] [--force]
   speckit doctor [--json] [--deep]
@@ -150,7 +161,7 @@ Usage:
   speckit permissions audit [--path <path>] [--command <command>] [--json]
   speckit session start|checkpoint|compact|resume|status [target] [--note "..."] [--json]
   speckit sprint plan|next [--json]
-  speckit graph triage|plan|insights [--json]
+  speckit graph setup|triage|plan|insights [--json]
   speckit validate [--json]
   speckit triage [--json]
   speckit next

package/dist/commands/doctor.js

@@ -32,6 +32,12 @@ export async function doctorCommand(options) {
         stdout.log(`Speckit doctor: ${report.status}`);
         stdout.log(`Node: ${report.node}`);
         stdout.log(`Tools: ${tools.map((tool) => `${tool.name}=${tool.available ? "ok" : "missing"}`).join(", ")}`);
+        for (const tool of tools.filter((tool) => !tool.available)) {
+            stdout.log(`Tool hint ${tool.name}: ${tool.hint}`);
+            if (tool.install?.length) {
+                stdout.log(`Install ${tool.name}: ${tool.install.join(" OR ")}`);
+            }
+        }
         stdout.log(`Tests: ${tests[0]?.command ?? "not detected"}`);
         for (const check of deepChecks) {
             stdout.log(`Deep ${check.name}: ${check.ok ? "ok" : "missing"}`);

package/dist/commands/graph.js

@@ -1,5 +1,5 @@
 import { spawnSync } from "node:child_process";
-import { commandExists } from "../adapters/tool-checks.js";
+import { beadsViewerInstallGuide, checkTools, commandExists } from "../adapters/tool-checks.js";
 import { prepareBeadsMirror } from "../core/beads-mirror.js";
 import { readSyncedStories, selectableStories } from "../core/synced-stories.js";
 const robotActions = new Map([
@@ -9,9 +9,12 @@ const robotActions = new Map([
 ]);
 export async function graphCommand(options) {
     const stdout = options.stdout ?? console;
+    if (options.action === "setup") {
+        return graphSetup(options);
+    }
     const robotFlag = robotActions.get(options.action);
     if (!robotFlag) {
-        stdout.error("Usage: speckit graph triage|plan|insights [--json]");
+        stdout.error("Usage: speckit graph setup|triage|plan|insights [--json]");
         return 1;
     }
     if (commandExists("bv")) {
@@ -32,6 +35,29 @@ export async function graphCommand(options) {
     stdout.log(JSON.stringify(fallback, null, 2));
     return 0;
 }
+async function graphSetup(options) {
+    const stdout = options.stdout ?? console;
+    const tools = checkTools().filter((tool) => ["br", "bd", "bv"].includes(tool.name));
+    const mirrorPath = await prepareBeadsMirror(options.root);
+    const report = {
+        status: tools.find((tool) => tool.name === "bv")?.available ? "ready" : "needs-bv",
+        mirror: mirrorPath,
+        tools,
+        install: beadsViewerInstallGuide(),
+    };
+    if (options.json) {
+        stdout.log(JSON.stringify(report, null, 2));
+    }
+    else {
+        stdout.log(beadsViewerInstallGuide());
+        stdout.log("");
+        stdout.log(`Mirror: ${mirrorPath}`);
+        for (const tool of tools) {
+            stdout.log(`${tool.name}: ${tool.available ? "ok" : "missing"} - ${tool.hint}`);
+        }
+    }
+    return 0;
+}
 async function localGraphFallback(root, action) {
     const stories = await readSyncedStories(root);
     const selectable = selectableStories(stories);
@@ -46,6 +72,6 @@ async function localGraphFallback(root, action) {
             top_pick: selectable[0] ?? null,
         },
         recommendations: selectable.slice(0, 3),
-        command: "Install Beads Viewer for graph metrics: bv --robot-triage --format json",
+        command: "Install Beads Viewer for graph metrics: brew install dicklesworthstone/tap/bv",
     };
 }

package/dist/commands/next.js

@@ -1,9 +1,9 @@
 import { spawnSync } from "node:child_process";
-import { commandExists } from "../adapters/tool-checks.js";
+import { beadsViewerInstallGuide, commandExists } from "../adapters/tool-checks.js";
 export async function nextCommand(options = {}) {
     const stdout = options.stdout ?? console;
     if (!commandExists("bv")) {
-        stdout.error("bv is not installed. Install Beads Viewer, then run: bv --robot-next --format json");
+        stdout.error(`bv is not installed.\n\n${beadsViewerInstallGuide()}`);
         return 1;
     }
     const result = spawnSync("bv", ["--robot-next", "--format", "json"], {

package/dist/commands/setup.d.ts

@@ -0,0 +1,9 @@
+import { Readable, Writable } from "node:stream";
+export type SetupOptions = {
+    root: string;
+    answers?: string[];
+    stdin?: Readable;
+    output?: Writable;
+    stdout?: Pick<typeof console, "log" | "error">;
+};
+export declare function setupCommand(options: SetupOptions): Promise<number>;

package/dist/commands/setup.js

@@ -0,0 +1,128 @@
+import { createInterface } from "node:readline/promises";
+import { adapters } from "../config/adapter-registry.js";
+import { graphCommand } from "./graph.js";
+import { initCommand } from "./init.js";
+const modeChoices = [
+    { label: "Enterprise Agile + TDD harness", value: "enterprise" },
+    { label: "Standard Agile + TDD runtime", value: "standard" },
+];
+const ideChoices = [
+    { label: "All supported IDEs", value: "all" },
+    ...adapters.map((adapter) => ({
+        label: adapter.displayName,
+        value: adapter.name,
+    })),
+];
+export async function setupCommand(options) {
+    const stdin = options.stdin ?? process.stdin;
+    const output = options.output ?? process.stdout;
+    const stdout = options.stdout ?? console;
+    if (options.answers) {
+        return setupFromAnswers(options, stdout, options.answers);
+    }
+    if (!stdin.isTTY || !output.isTTY) {
+        stdout.error("Interactive setup requires a TTY. Use `speckit init --enterprise --ide all` for non-interactive setup.");
+        return 1;
+    }
+    const rl = createInterface({ input: stdin, output });
+    try {
+        stdout.log("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);
+        stdout.log("");
+        stdout.log(`Selected: ${mode}, ide=${ide}, force=${force ? "yes" : "no"}, graph=${configureGraph ? "yes" : "no"}`);
+        stdout.log("");
+        const initExit = await initCommand({
+            root: options.root,
+            ide,
+            enterprise: mode === "enterprise",
+            force,
+            stdout,
+        });
+        if (configureGraph) {
+            stdout.log("");
+            await graphCommand({ root: options.root, action: "setup", stdout });
+        }
+        return initExit;
+    }
+    finally {
+        rl.close();
+    }
+}
+async function setupFromAnswers(options, stdout, answers) {
+    stdout.log("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 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("");
+    const initExit = await initCommand({
+        root: options.root,
+        ide,
+        enterprise: mode === "enterprise",
+        force,
+        stdout,
+    });
+    if (configureGraph) {
+        stdout.log("");
+        await graphCommand({ root: options.root, action: "setup", stdout });
+    }
+    return initExit;
+}
+function selectAnswer(stdout, choices, prompt, defaultValue, answer) {
+    stdout.log(prompt);
+    choices.forEach((choice, index) => stdout.log(`  ${index + 1}. ${choice.label}`));
+    const selected = (answer?.trim() || defaultValue);
+    const index = Number.parseInt(selected, 10) - 1;
+    if (!Number.isInteger(index) || !choices[index]) {
+        throw new Error(`Invalid selection: ${selected}`);
+    }
+    stdout.log("");
+    return choices[index].value;
+}
+function confirmAnswer(prompt, defaultValue, answer) {
+    const selected = answer?.trim().toLowerCase();
+    if (!selected)
+        return defaultValue;
+    if (["y", "yes"].includes(selected))
+        return true;
+    if (["n", "no"].includes(selected))
+        return false;
+    throw new Error(`Invalid yes/no answer for "${prompt}": ${answer}`);
+}
+async function select(rl, stdout, choices, prompt, defaultValue) {
+    for (;;) {
+        stdout.log(prompt);
+        choices.forEach((choice, index) => {
+            const number = String(index + 1);
+            stdout.log(`  ${number}. ${choice.label}`);
+        });
+        const answer = (await rl.question(`Select [${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("");
+    }
+}
+async function confirm(rl, stdout, prompt, defaultValue) {
+    const suffix = defaultValue ? "Y/n" : "y/N";
+    for (;;) {
+        const answer = (await rl.question(`${prompt} [${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.");
+    }
+}

package/docs/adapters.md

@@ -25,3 +25,24 @@ Speckit never invokes bare `bv`. The `next` command calls:
 ```bash
 bv --robot-next --format json
 ```
+
+Run this once on a new machine to see install commands and prepare the graph mirror:
+
+```bash
+speckit graph setup
+```
+
+Common `bv` installs:
+
+```bash
+brew install dicklesworthstone/tap/bv
+go install github.com/Dicklesworthstone/beads_viewer/cmd/bv@latest
+```
+
+Graph wrappers use robot mode:
+
+```bash
+speckit graph triage --json
+speckit graph plan --json
+speckit graph insights --json
+```

package/docs/beads-viewer-setup.md

@@ -0,0 +1,58 @@
+<!-- speckit:managed -->
+# Beads Viewer Setup
+
+Speckit works without Beads Viewer by falling back to local JSON. Install `bv` when you want graph-aware prioritization, bottleneck detection, critical path analysis, and robot-mode planning.
+
+## Install `bv`
+
+Recommended on macOS/Linux:
+
+```bash
+brew install dicklesworthstone/tap/bv
+```
+
+Go install:
+
+```bash
+go install github.com/Dicklesworthstone/beads_viewer/cmd/bv@latest
+```
+
+Nix:
+
+```bash
+nix run github:Dicklesworthstone/beads_viewer -- --help
+```
+
+## Verify With Speckit
+
+```bash
+speckit graph setup
+speckit sync
+speckit graph triage --json
+speckit next
+```
+
+`speckit graph setup` prepares `.beads/beads.jsonl` from Speckit stories and reports whether `bv` is available.
+
+## Agent Safety Rule
+
+Do not run bare `bv` from an agent session. Bare `bv` opens the interactive TUI. Use:
+
+```bash
+speckit graph triage --json
+speckit graph plan --json
+speckit graph insights --json
+bv --robot-triage --format json
+bv --robot-next --format json
+```
+
+## Data Flow
+
+```text
+.speckit/stories/*.md
+  -> speckit sync
+  -> .speckit/sync/beads-sync.jsonl
+  -> .beads/beads.jsonl
+  -> bv --robot-* or Speckit graph wrappers
+```
+

package/docs/development-roadmap.md

@@ -4,7 +4,7 @@
 
 Speckit MVP is implemented and pushed to `git@github.com:trieungoctam/speckit.git` on `main`.
 
-Current package target: `@trieungoctam/speckit@0.3.3`.
+Current package target: `@trieungoctam/speckit@0.3.5`.
 
 The CLI is npx-ready, generates Agile + TDD rules, creates workflow artifacts, supports five IDE adapters, wraps Beads Viewer safely, includes an enterprise harness, and has automated prompt/readiness/session tests plus CI.
 
@@ -13,11 +13,11 @@ The CLI is npx-ready, generates Agile + TDD rules, creates workflow artifacts, s
 | Milestone | Status | Notes |
 | --- | --- | --- |
 | Product contract | Complete | Contract, workflow model, and command surface documented. |
-| CLI scaffold | Complete | `bin/speckit`, TypeScript build, command router, managed file writer. |
+| CLI scaffold | Complete | `bin/speckit`, TypeScript build, command router, interactive setup wizard, managed file writer. |
 | Workflow engine | Complete | `start`, `shape`, `plan`, `context`, `quick`, `sync`, `triage`, `ready`, `run`, `review`, and `close` generate linked artifacts. |
 | Long session manager | Complete | `memory refresh` plus `session start/checkpoint/compact/resume/status` preserve agent continuity outside chat history. |
 | IDE adapters | Complete | Claude Code, Codex, Antigravity, OpenCode, Cursor. |
-| Beads integration | MVP Complete | `next` and `graph triage/plan/insights` wrap BV robot mode; `sync` exports story metadata JSONL. |
+| Beads integration | MVP Complete | `graph setup` prints install commands and prepares `.beads/beads.jsonl`; `next` and `graph triage/plan/insights` wrap BV robot mode; `sync` exports story metadata JSONL. |
 | Sprint automation | MVP Complete | `sprint plan` and `sprint next` select work from synced stories. |
 | Enterprise harness | MVP Complete | `init --enterprise` creates flow, tool-policy, and prompt harness files; `doctor --deep` verifies them. |
 | Curated skill catalog | Complete | Speckit now generates focused phase skills, a schema, delegation statuses, and task hydration/sync-back guidance. |

package/docs/project-changelog.md

@@ -1,5 +1,30 @@
 # Project Changelog
 
+## 0.3.5 - 2026-05-11
+
+### Added
+
+- Added `speckit setup`, an interactive TUI wizard for setup mode, IDE adapter, overwrite policy, and optional Beads Viewer setup.
+- Added `speckit graph setup` to print Beads Viewer install commands, check `br`/`bd`/`bv`, and prepare `.beads/beads.jsonl`.
+- Added `docs/beads-viewer-setup.md` with Homebrew, Go, and Nix setup paths plus robot-safe verification commands.
+
+### Changed
+
+- `speckit doctor` now prints install hints for missing tools.
+- `speckit next` now prints concrete Beads Viewer setup guidance when `bv` is missing.
+- README and workflow docs now include the graph setup step.
+
+## 0.3.4 - 2026-05-11
+
+### Fixed
+
+- Fixed global CLI help handling so `speckit --help`, `speckit -h`, `speckit help`, and command-level `--help` print usage without an unknown-command warning.
+
+### Quality
+
+- Added CLI help regression coverage.
+- `npm test` passes with 44 tests.
+
 ## 0.3.3 - 2026-05-11
 
 ### Added

package/docs/use-cases.md

@@ -6,6 +6,16 @@ This guide shows how to use Speckit for common product and engineering workflows
 
 Use when a repository does not have Speckit runtime files yet.
 
+Interactive:
+
+```bash
+npx @trieungoctam/speckit@latest setup
+```
+
+The wizard asks for setup mode, IDE adapter, overwrite policy, and whether to run Beads Viewer setup.
+
+Scripted:
+
 ```bash
 npx @trieungoctam/speckit@latest init --enterprise --ide cursor
 npx @trieungoctam/speckit@latest doctor --deep
@@ -131,6 +141,7 @@ Use when multiple stories exist and the next task is not obvious.
 
 ```bash
 speckit sync
+speckit graph setup
 speckit sprint plan
 speckit sprint next --json
 speckit graph triage --json
@@ -141,6 +152,7 @@ speckit graph insights --json
 Best practices:
 
 - Run `sync` before any graph command.
+- Run `graph setup` on new machines to print Beads Viewer install commands, check `bv`, and prepare `.beads/beads.jsonl`.
 - Keep graph commands robot-safe. Use Speckit wrappers instead of interactive graph commands.
 - Treat graph output as prioritization input, not automatic permission to implement.
 - Re-run `sprint plan` when story status or dependencies change.

package/docs/workflow-model.md

@@ -70,3 +70,5 @@ Long-running agent work must keep durable state outside chat history:
 ## Beads Viewer Automation
 
 `speckit sync` prepares both Speckit sync metadata and a Beads Viewer-compatible `.beads/beads.jsonl` mirror. `speckit graph triage|plan|insights` refreshes that mirror before invoking `bv --robot-*` from the project root, then falls back to local JSON if Beads Viewer is unavailable or still fails.
+
+Run `speckit graph setup` on a new machine to print Beads Viewer install commands, check `br`/`bd`/`bv`, and prepare `.beads/beads.jsonl`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trieungoctam/speckit",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "Enterprise Agile + TDD workflow compiler for agentic IDEs.",
   "type": "module",
   "files": [