bemadralphy 0.3.1 → 0.3.3

package/README.md

@@ -191,6 +191,10 @@ npx bemadralphy status
 # Show run history (human or JSON)
 npx bemadralphy history
 npx bemadralphy history --output json
+
+# Check local dependency readiness
+npx bemadralphy doctor
+npx bemadralphy doctor --output json
 ```
 
 ---
@@ -414,6 +418,23 @@ yarn global add bemadralphy
 curl -fsSL https://raw.githubusercontent.com/hxp-pxh/BeMadRalphy/main/install.sh | bash
 ```
 
+Verify the install:
+
+```bash
+bemadralphy --version
+bemadralphy --help
+```
+
+If your shell cannot find `bemadralphy` right after global install:
+
+```bash
+# still works without global PATH wiring
+npx bemadralphy --help
+
+# if you use a custom npm prefix, add its bin dir to PATH
+export PATH="$(npm config get prefix)/bin:$PATH"
+```
+
 ### Docker
 
 ```bash
@@ -479,6 +500,12 @@ node dist/cli.js --help
 - Execute fails for unknown/unavailable engines.
 - Verify/Post fail if OpenSpec commands fail.
 
+`init` is now soft for onboarding:
+
+- Always scaffolds `.bemadralphy/`, `openspec/`, `_bmad-output/`, and starter `idea.md`.
+- If `bd`, `bmad`, or `openspec` are missing, it completes with warnings and reports missing CLIs.
+- Use `bemadralphy doctor` to check readiness before full pipeline runs.
+
 Typical recovery flow:
 
 ```bash

package/dist/beads/parse-tasks.d.ts

@@ -0,0 +1,2 @@
+import type { TaskSummary } from './tasks-md.js';
+export declare function parseTasksMarkdown(contents: string): TaskSummary[];

package/dist/beads/parse-tasks.js

@@ -0,0 +1,12 @@
+export function parseTasksMarkdown(contents) {
+    const lines = contents.split(/\r?\n/).filter((line) => line.startsWith('|'));
+    const rows = lines
+        .map((line) => line.split('|').map((part) => part.trim()))
+        .filter((parts) => parts.length >= 4 && parts[1] !== 'ID' && parts[1] !== '---');
+    return rows.map((parts) => ({
+        id: parts[1],
+        title: parts[2],
+        status: parts[3],
+    }));
+}
+//# sourceMappingURL=parse-tasks.js.map

package/dist/beads/parse-tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-tasks.js","sourceRoot":"","sources":["../../src/beads/parse-tasks.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG,KAAK;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;SACzD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC;IACnF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1B,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;QACZ,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QACf,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;KACjB,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/cli.js

@@ -1,11 +1,14 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
-import { runExplore, runHistory, runInit, runPipeline, runReplay, runStatus } from './orchestrator.js';
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { runDoctor, runExplore, runHistory, runInit, runPipeline, runReplay, runStatus, } from './orchestrator.js';
 const program = new Command();
 program
     .name('bemadralphy')
     .description('CLI orchestrator for end-to-end automated coding pipelines')
-    .version('0.1.0');
+    .version(resolveCliVersion());
 program
     .command('init')
     .description('Initialize BMAD, Beads, and BeMadRalphy config')
@@ -54,6 +57,13 @@ program
     .action(async (options) => {
     await runHistory(options.output);
 });
+program
+    .command('doctor')
+    .description('Check local environment dependencies and readiness')
+    .option('--output <format>', 'Output format: text|json', 'text')
+    .action(async (options) => {
+    await runDoctor(options.output);
+});
 program
     .command('replay <runId>')
     .description('Replay a previous run from history')
@@ -92,4 +102,19 @@ function maybeOption(command, key, value) {
     }
     return undefined;
 }
+function resolveCliVersion() {
+    try {
+        const here = path.dirname(fileURLToPath(import.meta.url));
+        const packageJsonPath = path.join(here, '..', 'package.json');
+        const raw = readFileSync(packageJsonPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.version === 'string' && parsed.version.trim().length > 0) {
+            return parsed.version;
+        }
+    }
+    catch {
+        // fall through to default
+    }
+    return '0.0.0';
+}
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/docs/pr-body.d.ts

@@ -0,0 +1,8 @@
+export type PrBodyInput = {
+    title: string;
+    summary: string;
+    changes: string[];
+    tests: string[];
+    linkedIssues?: string[];
+};
+export declare function generatePrBody(input: PrBodyInput): string;

package/dist/docs/pr-body.js

@@ -0,0 +1,11 @@
+export function generatePrBody(input) {
+    const lines = [];
+    lines.push('## Summary', '', input.summary, '');
+    lines.push('## Changes', '', ...input.changes.map((c) => `- ${c}`), '');
+    lines.push('## Tests', '', ...input.tests.map((t) => `- ${t}`), '');
+    if (input.linkedIssues && input.linkedIssues.length > 0) {
+        lines.push('## Linked Issues', '', ...input.linkedIssues.map((i) => `- ${i}`), '');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=pr-body.js.map

package/dist/docs/pr-body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-body.js","sourceRoot":"","sources":["../../src/docs/pr-body.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,cAAc,CAAC,KAAkB;IAC/C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACxE,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAEpE,IAAI,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/engines/cli.d.ts

@@ -0,0 +1,14 @@
+import type { EngineAdapter } from './types.js';
+type CliAdapterConfig = {
+    name: string;
+    hasNativeSwarm: boolean;
+    permissionFlags?: string[];
+    defaultCommand: string;
+    envCommand: string;
+    envArgs: string;
+};
+export declare function createCliAdapter(config: CliAdapterConfig): EngineAdapter;
+export declare function resolveCommand(config: CliAdapterConfig): string;
+export declare function resolveArgs(config: CliAdapterConfig, prompt: string, promptFile: string, taskId: string): string[];
+export declare function parseArgsEnv(raw?: string): string[] | null;
+export {};

package/dist/engines/cli.js

@@ -0,0 +1,72 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { commandExists, runCommand } from '../utils/exec.js';
+import { logInfo } from '../utils/logging.js';
+import { renderTaskPrompt } from './prompt-template.js';
+export function createCliAdapter(config) {
+    return {
+        name: config.name,
+        hasNativeSwarm: config.hasNativeSwarm,
+        permissionFlags: config.permissionFlags ?? [],
+        async checkAvailable() {
+            const command = resolveCommand(config);
+            return commandExists(command);
+        },
+        async execute(task, options) {
+            const command = resolveCommand(config);
+            const cwd = options.cwd ?? process.cwd();
+            const prompt = await renderTaskPrompt(cwd, task);
+            const promptFile = await writePromptFile(cwd, task.id, prompt);
+            const args = resolveArgs(config, prompt, promptFile, task.id);
+            try {
+                const { stdout, stderr } = await runCommand(command, args, cwd);
+                const output = stdout.trim() ? stdout : stderr;
+                return { status: 'success', output };
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                logInfo(`engine "${config.name}" failed: ${message}`);
+                return { status: 'failed', error: message };
+            }
+        },
+    };
+}
+export function resolveCommand(config) {
+    return process.env[config.envCommand] ?? config.defaultCommand;
+}
+export function resolveArgs(config, prompt, promptFile, taskId) {
+    const raw = process.env[config.envArgs];
+    const args = parseArgsEnv(raw) ?? ['--prompt-file', '{promptFile}'];
+    return args.map((arg) => arg
+        .replaceAll('{prompt}', prompt)
+        .replaceAll('{promptFile}', promptFile)
+        .replaceAll('{taskId}', taskId));
+}
+export function parseArgsEnv(raw) {
+    if (!raw || !raw.trim()) {
+        return null;
+    }
+    const trimmed = raw.trim();
+    if (trimmed.startsWith('[')) {
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (Array.isArray(parsed)) {
+                return parsed.map((item) => String(item));
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    return trimmed.split(/\s+/).filter(Boolean);
+}
+async function writePromptFile(projectRoot, taskId, prompt) {
+    const dir = path.join(projectRoot, '.bemadralphy', 'prompts');
+    await mkdir(dir, { recursive: true });
+    const safeId = taskId.replace(/[^a-zA-Z0-9._-]+/g, '_');
+    const promptPath = path.join(dir, `${safeId}.md`);
+    await writeFile(promptPath, `${prompt}\n`, 'utf-8');
+    return promptPath;
+}
+//# sourceMappingURL=cli.js.map

package/dist/engines/cli.js.map

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

package/dist/engines/prompt-template.d.ts

@@ -0,0 +1,2 @@
+import type { EngineTask } from './types.js';
+export declare function renderTaskPrompt(projectRoot: string, task: EngineTask): Promise<string>;

package/dist/engines/prompt-template.js

@@ -0,0 +1,96 @@
+import { access, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { parse } from 'yaml';
+const DEFAULT_TEMPLATE = [
+    '# Task',
+    'ID: {{task.id}}',
+    'Title: {{task.title}}',
+    'Description: {{task.description}}',
+    '',
+    '# Project',
+    'Root: {{project.root}}',
+    'Idea: {{project.idea}}',
+    'Decisions:',
+    '{{project.decisions}}',
+    '',
+    '# Instructions',
+    '- Work in this repository.',
+    '- Update tests if needed.',
+    '- Summarize changes and list any risks.',
+    '',
+].join('\n');
+export async function renderTaskPrompt(projectRoot, task) {
+    const template = await loadTemplate(projectRoot);
+    const intake = await loadIntake(projectRoot);
+    const decisions = formatDecisions(intake?.decisions ?? {});
+    const values = new Map([
+        ['{{task.id}}', task.id],
+        ['{{task.title}}', task.title],
+        ['{{task.description}}', task.description ?? 'n/a'],
+        ['{{project.root}}', projectRoot],
+        ['{{project.idea}}', intake?.idea?.trim() || 'n/a'],
+        ['{{project.decisions}}', decisions],
+    ]);
+    let rendered = template;
+    for (const [key, value] of values) {
+        rendered = rendered.replaceAll(key, value);
+    }
+    return rendered;
+}
+async function loadTemplate(projectRoot) {
+    const overridePath = process.env.BEMADRALPHY_PROMPT_TEMPLATE;
+    const candidates = [
+        overridePath,
+        path.join(projectRoot, '.bemadralphy', 'prompts', 'task.md'),
+        path.join(projectRoot, '.bemadralphy', 'prompt.md'),
+    ].filter(Boolean);
+    for (const candidate of candidates) {
+        if (await exists(candidate)) {
+            return readFile(candidate, 'utf-8');
+        }
+    }
+    return DEFAULT_TEMPLATE;
+}
+async function loadIntake(projectRoot) {
+    try {
+        const intakePath = path.join(projectRoot, '.bemadralphy', 'intake.yaml');
+        const contents = await readFile(intakePath, 'utf-8');
+        const parsed = (parse(contents) ?? {});
+        return {
+            decisions: (parsed.decisions ?? {}),
+            idea: typeof parsed.idea === 'string' ? parsed.idea : undefined,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function formatDecisions(decisions) {
+    const keys = Object.keys(decisions);
+    if (keys.length === 0) {
+        return '- None';
+    }
+    return keys
+        .sort()
+        .map((key) => `- ${key}: ${formatDecisionValue(decisions[key])}`)
+        .join('\n');
+}
+function formatDecisionValue(value) {
+    if (value === null || value === undefined) {
+        return 'n/a';
+    }
+    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    return JSON.stringify(value);
+}
+async function exists(targetPath) {
+    try {
+        await access(targetPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=prompt-template.js.map

package/dist/engines/prompt-template.js.map

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

package/dist/engines/stub.d.ts

@@ -0,0 +1,2 @@
+import type { EngineAdapter } from './types.js';
+export declare function createStubAdapter(name: string, hasNativeSwarm: boolean, permissionFlags?: string[], commandName?: string): EngineAdapter;

package/dist/engines/stub.js

@@ -0,0 +1,17 @@
+import { commandExists } from '../utils/exec.js';
+import { logInfo } from '../utils/logging.js';
+export function createStubAdapter(name, hasNativeSwarm, permissionFlags = [], commandName = name) {
+    return {
+        name,
+        hasNativeSwarm,
+        permissionFlags,
+        async checkAvailable() {
+            return commandExists(commandName);
+        },
+        async execute(task, options) {
+            logInfo(`engine "${name}" not implemented (task=${task.id}, dryRun=${Boolean(options.dryRun)})`);
+            return { status: 'skipped', output: 'engine not implemented' };
+        },
+    };
+}
+//# sourceMappingURL=stub.js.map

package/dist/engines/stub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub.js","sourceRoot":"","sources":["../../src/engines/stub.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAG9C,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,cAAuB,EACvB,kBAA4B,EAAE,EAC9B,cAAsB,IAAI;IAE1B,OAAO;QACL,IAAI;QACJ,cAAc;QACd,eAAe;QACf,KAAK,CAAC,cAAc;YAClB,OAAO,aAAa,CAAC,WAAW,CAAC,CAAC;QACpC,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,IAAgB,EAAE,OAAuB;YACrD,OAAO,CACL,WAAW,IAAI,2BAA2B,IAAI,CAAC,EAAE,YAAY,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CACxF,CAAC;YACF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC;QACjE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/git/worktrees.d.ts

@@ -0,0 +1,11 @@
+export type Worktree = {
+    path: string;
+    branch: string;
+};
+export declare function isWorktreeModeEnabled(): Promise<boolean>;
+export declare function isCleanWorkingTree(projectRoot: string): Promise<boolean>;
+export declare function isCleanStatus(status: string): boolean;
+export declare function createWorktree(projectRoot: string, taskId: string): Promise<Worktree>;
+export declare function removeWorktree(projectRoot: string, worktree: Worktree): Promise<void>;
+export declare function commitAndMerge(projectRoot: string, worktree: Worktree, message: string): Promise<void>;
+export declare function abortMerge(projectRoot: string): Promise<void>;

package/dist/git/worktrees.js

@@ -0,0 +1,63 @@
+import { mkdir, rm } from 'node:fs/promises';
+import path from 'node:path';
+import { runCommand } from '../utils/exec.js';
+import { logInfo } from '../utils/logging.js';
+export async function isWorktreeModeEnabled() {
+    return process.env.BEMADRALPHY_WORKTREES === '1';
+}
+export async function isCleanWorkingTree(projectRoot) {
+    const { stdout } = await runCommand('git', ['status', '--porcelain'], projectRoot);
+    return isCleanStatus(stdout);
+}
+export function isCleanStatus(status) {
+    return status.trim().length === 0;
+}
+export async function createWorktree(projectRoot, taskId) {
+    const worktreesDir = path.join(projectRoot, '.bemadralphy', 'worktrees');
+    await mkdir(worktreesDir, { recursive: true });
+    const slug = slugify(taskId);
+    const worktreePath = path.join(worktreesDir, slug);
+    const branch = `bemadralphy/${slug}`;
+    await runCommand('git', ['worktree', 'add', '-b', branch, worktreePath], projectRoot);
+    logInfo(`worktree: created ${worktreePath} (${branch})`);
+    return { path: worktreePath, branch };
+}
+export async function removeWorktree(projectRoot, worktree) {
+    await runCommand('git', ['worktree', 'remove', '--force', worktree.path], projectRoot);
+    await rm(worktree.path, { recursive: true, force: true });
+    logInfo(`worktree: removed ${worktree.path}`);
+}
+export async function commitAndMerge(projectRoot, worktree, message) {
+    const { stdout } = await runCommand('git', ['status', '--porcelain'], worktree.path);
+    if (stdout.trim().length === 0) {
+        logInfo(`worktree: no changes for ${worktree.branch}`);
+        return;
+    }
+    await runCommand('git', ['add', '-A'], worktree.path);
+    await runCommand('git', ['commit', '-m', message], worktree.path);
+    try {
+        await runCommand('git', ['merge', '--no-ff', worktree.branch], projectRoot);
+        logInfo(`worktree: merged ${worktree.branch}`);
+    }
+    catch (error) {
+        logInfo(`worktree: merge failed for ${worktree.branch}`);
+        throw error;
+    }
+}
+export async function abortMerge(projectRoot) {
+    try {
+        await runCommand('git', ['merge', '--abort'], projectRoot);
+        logInfo('worktree: merge aborted');
+    }
+    catch (error) {
+        logInfo('worktree: merge abort failed');
+        throw error;
+    }
+}
+function slugify(input) {
+    return input
+        .toLowerCase()
+        .replace(/[^a-z0-9-]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+//# sourceMappingURL=worktrees.js.map

package/dist/git/worktrees.js.map

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

package/dist/orchestrator.d.ts

@@ -25,4 +25,5 @@ export declare function runExplore(query: string): Promise<void>;
 export declare function runStatus(output?: OutputFormat): Promise<void>;
 export declare function runHistory(output?: OutputFormat): Promise<void>;
 export declare function runReplay(runId: string, options?: Partial<RunOptions>): Promise<void>;
+export declare function runDoctor(output?: OutputFormat): Promise<void>;
 export {};

package/dist/orchestrator.js

@@ -8,7 +8,7 @@ import { loadPlugins, runPhaseHooks } from './plugins/index.js';
 import { executePhase, explorePhase, intakePhase, planningPhase, postPhase, scaffoldPhase, steeringPhase, syncPhase, verifyPhase, } from './phases/index.js';
 import { loadState, saveState } from './state.js';
 import { generateSpecs } from './specs/index.js';
-import { assertCommandExists, runCommand } from './utils/exec.js';
+import { commandExists, runCommand } from './utils/exec.js';
 import { configureLogger, logError, logInfo, logProgress, logSummary, } from './utils/logging.js';
 const PHASES = [
     { name: 'intake', run: intakePhase },
@@ -46,13 +46,40 @@ export async function runInit(projectRoot = process.cwd()) {
         ].join('\n'), 'utf-8');
         logInfo('init: created starter idea.md');
     }
-    await assertCommandExists('bd', 'Install from https://github.com/steveyegge/beads.');
-    await assertCommandExists('bmad', 'Install with: npm install -g bmad-method');
-    await assertCommandExists('openspec', 'Install with: npm install -g @fission-ai/openspec');
-    await runCommand('bd', ['init'], projectRoot);
-    logInfo('init: Beads initialized');
-    await generateSpecs(projectRoot);
-    logInfo('init: completed scaffold of .bemadralphy, openspec/, and _bmad-output/');
+    const hasBd = await commandExists('bd');
+    const hasBmad = await commandExists('bmad');
+    const hasOpenSpec = await commandExists('openspec');
+    if (hasBd) {
+        await runCommand('bd', ['init'], projectRoot);
+        logInfo('init: Beads initialized');
+    }
+    else {
+        logInfo('init: bd not found; skipped Beads init. Install from https://github.com/steveyegge/beads.');
+    }
+    if (hasOpenSpec) {
+        await generateSpecs(projectRoot);
+    }
+    else {
+        logInfo('init: openspec not found; skipped OpenSpec init. Install with: npm install -g @fission-ai/openspec');
+    }
+    if (!hasBmad) {
+        logInfo('init: bmad not found; planning phase will fail until installed (npm install -g bmad-method).');
+    }
+    const missingRequired = ['bd', 'bmad', 'openspec'].filter((cli) => {
+        if (cli === 'bd') {
+            return !hasBd;
+        }
+        if (cli === 'bmad') {
+            return !hasBmad;
+        }
+        return !hasOpenSpec;
+    });
+    if (missingRequired.length > 0) {
+        logInfo(`init: partial setup complete. Missing CLIs: ${missingRequired.join(', ')}`);
+    }
+    else {
+        logInfo('init: completed scaffold of .bemadralphy, openspec/, and _bmad-output/');
+    }
 }
 export async function runPipeline(options) {
     const normalized = await resolveRunOptions(options);
@@ -220,7 +247,7 @@ export async function runStatus(output = 'text') {
     const projectRoot = process.cwd();
     const state = await loadState(projectRoot);
     if (!state) {
-        logInfo('status: no state found (.bemadralphy/state.yaml missing)');
+        logInfo('status: no state found (.bemadralphy/state.yaml missing). Run "bemadralphy init" to get started.');
         return;
     }
     if (output === 'json') {
@@ -237,7 +264,7 @@ export async function runHistory(output = 'text') {
         return;
     }
     if (records.length === 0) {
-        logInfo('history: no runs found');
+        logInfo('history: no runs found. Run "bemadralphy init" then "bemadralphy run" to create your first run.');
         return;
     }
     for (const row of records) {
@@ -262,6 +289,37 @@ export async function runReplay(runId, options = {}) {
     };
     await runPipeline(replayOptions);
 }
+export async function runDoctor(output = 'text') {
+    configureLogger({ outputFormat: output });
+    const checks = await Promise.all([
+        checkDependency('node', true, `found ${process.version}`),
+        checkDependency('npm', true, 'required for npm-based install/update flows'),
+        checkDependency('bd', true, 'Install from https://github.com/steveyegge/beads.'),
+        checkDependency('bmad', true, 'Install with: npm install -g bmad-method'),
+        checkDependency('openspec', true, 'Install with: npm install -g @fission-ai/openspec'),
+        checkDependency('ralphy', false, 'Install with: npm install -g ralphy-cli'),
+        checkDependency('gh', false, 'Install GitHub CLI from https://cli.github.com/'),
+        checkDependency('ollama', false, 'Install from https://ollama.com/download for local models.'),
+    ]);
+    const missingRequired = checks.filter((entry) => entry.required && !entry.installed);
+    if (output === 'json') {
+        logSummary({
+            status: missingRequired.length === 0 ? 'ok' : 'degraded',
+            checks,
+            missingRequired: missingRequired.map((entry) => entry.name),
+        });
+        return;
+    }
+    for (const check of checks) {
+        const state = check.installed ? 'ok' : check.required ? 'missing' : 'optional-missing';
+        logInfo(`doctor: ${check.name}=${state}${check.hint ? ` (${check.hint})` : ''}`);
+    }
+    if (missingRequired.length > 0) {
+        logInfo(`doctor: missing required CLIs (${missingRequired.map((entry) => entry.name).join(', ')}). Install them before running full pipeline.`);
+        return;
+    }
+    logInfo('doctor: environment looks good for full pipeline runs.');
+}
 function stateFrom(ctx, phase, status, lastError) {
     const phaseIndex = PHASES.findIndex((entry) => entry.name === phase);
     const nextPhase = phaseIndex >= 0 ? PHASES[phaseIndex + 1]?.name : undefined;
@@ -374,4 +432,11 @@ async function appendFailure(projectRoot, runId, phase, message) {
     await mkdir(path.dirname(failuresPath), { recursive: true });
     await writeFile(failuresPath, `${new Date().toISOString()} runId=${runId} phase=${phase} error=${message}\n`, { encoding: 'utf-8', flag: 'a' });
 }
+async function checkDependency(name, required, hint) {
+    if (name === 'node') {
+        return { name, required, installed: true, hint };
+    }
+    const installed = await commandExists(name);
+    return { name, required, installed, hint: installed ? undefined : hint };
+}
 //# sourceMappingURL=orchestrator.js.map