@zigrivers/scaffold 2.1.0

package/dist/cli/commands/build.test.js

@@ -0,0 +1,272 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+// ---------------------------------------------------------------------------
+// Hoisted mocks
+// ---------------------------------------------------------------------------
+vi.mock('../middleware/project-root.js', () => ({
+    findProjectRoot: vi.fn(),
+}));
+vi.mock('../middleware/output-mode.js', () => ({
+    resolveOutputMode: vi.fn(() => 'interactive'),
+}));
+vi.mock('../../config/loader.js', () => ({
+    loadConfig: vi.fn(),
+}));
+vi.mock('../../core/assembly/meta-prompt-loader.js', () => ({
+    discoverMetaPrompts: vi.fn(),
+}));
+vi.mock('../../core/assembly/preset-loader.js', () => ({
+    loadAllPresets: vi.fn(),
+}));
+vi.mock('../../core/dependency/graph.js', () => ({
+    buildGraph: vi.fn(),
+}));
+vi.mock('../../core/dependency/dependency.js', () => ({
+    detectCycles: vi.fn(() => []),
+    topologicalSort: vi.fn(() => []),
+}));
+vi.mock('../../cli/output/error-display.js', () => ({
+    displayErrors: vi.fn(),
+}));
+// ---------------------------------------------------------------------------
+// Imports (after mocks)
+// ---------------------------------------------------------------------------
+import { findProjectRoot } from '../middleware/project-root.js';
+import { resolveOutputMode } from '../middleware/output-mode.js';
+import { loadConfig } from '../../config/loader.js';
+import { discoverMetaPrompts } from '../../core/assembly/meta-prompt-loader.js';
+import { buildGraph } from '../../core/dependency/graph.js';
+import { detectCycles, topologicalSort } from '../../core/dependency/dependency.js';
+import { displayErrors } from '../../cli/output/error-display.js';
+import buildCommand from './build.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function makeConfig(overrides = {}) {
+    return {
+        version: 2,
+        methodology: 'deep',
+        platforms: ['claude-code'],
+        ...overrides,
+    };
+}
+function makeMetaPromptMap(names) {
+    return new Map(names.map(name => [
+        name,
+        {
+            stepName: name,
+            filePath: `/fake/pipeline/${name}.md`,
+            frontmatter: {
+                name,
+                phase: 'modeling',
+                order: 1,
+                dependencies: [],
+                outputs: [],
+            },
+            body: '',
+            sections: {},
+        },
+    ]));
+}
+function makeGraph(names) {
+    return {
+        nodes: new Map(names.map(name => [
+            name,
+            { slug: name, phase: 'modeling', order: 1, dependencies: [], enabled: true },
+        ])),
+        edges: new Map(names.map(name => [name, []])),
+    };
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('build command', () => {
+    let exitSpy;
+    let stdoutSpy;
+    let writtenLines;
+    const mockFindProjectRoot = vi.mocked(findProjectRoot);
+    const mockResolveOutputMode = vi.mocked(resolveOutputMode);
+    const mockLoadConfig = vi.mocked(loadConfig);
+    const mockDiscoverMetaPrompts = vi.mocked(discoverMetaPrompts);
+    const mockBuildGraph = vi.mocked(buildGraph);
+    const mockDetectCycles = vi.mocked(detectCycles);
+    const mockTopologicalSort = vi.mocked(topologicalSort);
+    beforeEach(() => {
+        writtenLines = [];
+        exitSpy = vi.spyOn(process, 'exit').mockImplementation((() => { }));
+        stdoutSpy = vi.spyOn(process.stdout, 'write').mockImplementation((chunk) => {
+            writtenLines.push(String(chunk));
+            return true;
+        });
+        vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+        // Defaults
+        mockFindProjectRoot.mockReturnValue('/fake/project');
+        mockResolveOutputMode.mockReturnValue('interactive');
+        mockLoadConfig.mockReturnValue({
+            config: makeConfig(),
+            errors: [],
+            warnings: [],
+        });
+        mockDiscoverMetaPrompts.mockReturnValue(makeMetaPromptMap(['step-a', 'step-b']));
+        mockBuildGraph.mockReturnValue(makeGraph(['step-a', 'step-b']));
+        mockDetectCycles.mockReturnValue([]);
+        mockTopologicalSort.mockReturnValue(['step-a', 'step-b']);
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    // Test 1: Exits 1 when project root not found
+    it('exits 1 when project root not found', async () => {
+        mockFindProjectRoot.mockReturnValue(null);
+        const argv = {
+            'validate-only': false,
+            force: false,
+            format: undefined,
+            auto: undefined,
+            verbose: undefined,
+            root: undefined,
+        };
+        await buildCommand.handler(argv);
+        expect(exitSpy).toHaveBeenCalledWith(1);
+    });
+    // Test 2: Exits 1 when config invalid
+    it('exits 1 when config has errors', async () => {
+        mockLoadConfig.mockReturnValue({
+            config: null,
+            errors: [
+                {
+                    code: 'CONFIG_MISSING',
+                    message: 'Config not found',
+                    exitCode: 1,
+                },
+            ],
+            warnings: [],
+        });
+        const argv = {
+            'validate-only': false,
+            force: false,
+            format: undefined,
+            auto: undefined,
+            verbose: undefined,
+            root: undefined,
+        };
+        await buildCommand.handler(argv);
+        expect(exitSpy).toHaveBeenCalledWith(1);
+        expect(displayErrors).toHaveBeenCalled();
+    });
+    // Test 3: Exits 1 when dependency cycles detected
+    it('exits 1 when dependency cycles detected', async () => {
+        mockDetectCycles.mockReturnValue([
+            {
+                code: 'DEP_CYCLE_DETECTED',
+                message: 'Cycle detected involving: step-a, step-b',
+                exitCode: 1,
+                context: { steps: 'step-a, step-b' },
+            },
+        ]);
+        const argv = {
+            'validate-only': false,
+            force: false,
+            format: undefined,
+            auto: undefined,
+            verbose: undefined,
+            root: undefined,
+        };
+        await buildCommand.handler(argv);
+        expect(exitSpy).toHaveBeenCalledWith(1);
+        expect(displayErrors).toHaveBeenCalled();
+    });
+    // Test 4: --validate-only succeeds without generating files
+    it('--validate-only exits 0 and reports validation passed', async () => {
+        const argv = {
+            'validate-only': true,
+            force: false,
+            format: undefined,
+            auto: undefined,
+            verbose: undefined,
+            root: undefined,
+        };
+        await buildCommand.handler(argv);
+        expect(exitSpy).toHaveBeenCalledWith(0);
+        const allOutput = writtenLines.join('');
+        expect(allOutput).toContain('Validation passed');
+    });
+    // Test 5: Reports step count in output
+    it('reports step count in human-readable output', async () => {
+        const argv = {
+            'validate-only': false,
+            force: false,
+            format: undefined,
+            auto: undefined,
+            verbose: undefined,
+            root: undefined,
+        };
+        await buildCommand.handler(argv);
+        expect(exitSpy).toHaveBeenCalledWith(0);
+        const allOutput = writtenLines.join('');
+        expect(allOutput).toContain('2');
+    });
+    // Test 6: JSON mode returns BuildResult shape
+    it('JSON mode returns BuildResult shape', async () => {
+        mockResolveOutputMode.mockReturnValue('json');
+        const argv = {
+            'validate-only': false,
+            force: false,
+            format: 'json',
+            auto: undefined,
+            verbose: undefined,
+            root: undefined,
+        };
+        await buildCommand.handler(argv);
+        expect(exitSpy).toHaveBeenCalledWith(0);
+        const allOutput = writtenLines.join('');
+        const parsed = JSON.parse(allOutput);
+        const data = parsed.data ?? parsed;
+        expect(data).toHaveProperty('stepsTotal');
+        expect(data).toHaveProperty('stepsEnabled');
+        expect(data).toHaveProperty('platforms');
+        expect(data).toHaveProperty('generatedFiles');
+        expect(data).toHaveProperty('buildTimeMs');
+    });
+    // Test 7: Handles empty pipeline directory (0 steps)
+    it('handles empty pipeline directory gracefully', async () => {
+        mockDiscoverMetaPrompts.mockReturnValue(new Map());
+        mockBuildGraph.mockReturnValue(makeGraph([]));
+        mockTopologicalSort.mockReturnValue([]);
+        const argv = {
+            'validate-only': false,
+            force: false,
+            format: undefined,
+            auto: undefined,
+            verbose: undefined,
+            root: undefined,
+        };
+        await buildCommand.handler(argv);
+        expect(exitSpy).toHaveBeenCalledWith(0);
+        const allOutput = writtenLines.join('');
+        expect(allOutput).toContain('0');
+    });
+    // Test 8: --validate-only JSON mode returns { valid, stepCount, cycles }
+    it('--validate-only JSON mode returns validation result shape', async () => {
+        mockResolveOutputMode.mockReturnValue('json');
+        const argv = {
+            'validate-only': true,
+            force: false,
+            format: 'json',
+            auto: undefined,
+            verbose: undefined,
+            root: undefined,
+        };
+        await buildCommand.handler(argv);
+        expect(exitSpy).toHaveBeenCalledWith(0);
+        const allOutput = writtenLines.join('');
+        const parsed = JSON.parse(allOutput);
+        const data = parsed.data ?? parsed;
+        expect(data).toHaveProperty('valid', true);
+        expect(data).toHaveProperty('stepCount');
+        expect(data).toHaveProperty('cycles', 0);
+        // Silence unused variable warnings
+        void stdoutSpy;
+        void mockBuildGraph;
+    });
+});
+//# sourceMappingURL=build.test.js.map

package/dist/cli/commands/build.test.js.map

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

package/dist/cli/commands/dashboard.d.ts

@@ -0,0 +1,14 @@
+import type { CommandModule } from 'yargs';
+interface DashboardArgs {
+    format?: string;
+    auto?: boolean;
+    verbose?: boolean;
+    root?: string;
+    force?: boolean;
+    output?: string;
+    'no-open'?: boolean;
+    'json-only'?: boolean;
+}
+declare const dashboardCommand: CommandModule<Record<string, unknown>, DashboardArgs>;
+export default dashboardCommand;
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/cli/commands/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/dashboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAc1C,UAAU,aAAa;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAID,QAAA,MAAM,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,CAkG3E,CAAA;AAED,eAAe,gBAAgB,CAAA"}

package/dist/cli/commands/dashboard.js

@@ -0,0 +1,102 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { execSync } from 'node:child_process';
+import { findProjectRoot } from '../middleware/project-root.js';
+import { resolveOutputMode } from '../middleware/output-mode.js';
+import { createOutputContext } from '../output/context.js';
+import { StateManager } from '../../state/state-manager.js';
+import { readDecisions } from '../../state/decision-logger.js';
+import { loadConfig } from '../../config/loader.js';
+import { generateDashboardData, generateHtml } from '../../dashboard/generator.js';
+const dashboardCommand = {
+    command: 'dashboard',
+    describe: 'Open pipeline dashboard in browser',
+    builder: (yargs) => {
+        return yargs
+            .option('output', {
+            type: 'string',
+            description: 'Output path for HTML file',
+        })
+            .option('no-open', {
+            type: 'boolean',
+            description: 'Skip opening in browser',
+            default: false,
+        })
+            .option('json-only', {
+            type: 'boolean',
+            description: 'Output data as JSON to stdout',
+            default: false,
+        });
+    },
+    handler: async (argv) => {
+        // 1. Resolve project root
+        const projectRoot = argv.root ?? findProjectRoot(process.cwd());
+        if (!projectRoot) {
+            process.stderr.write('✗ error [PROJECT_NOT_INITIALIZED]: No .scaffold/ directory found\n' +
+                '  Fix: Run `scaffold init` to initialize a project\n');
+            process.exit(1);
+            return;
+        }
+        // 2. Resolve output mode and create context
+        const outputMode = resolveOutputMode(argv);
+        const output = createOutputContext(outputMode);
+        // 3. Load state
+        const stateManager = new StateManager(projectRoot, () => []);
+        let state;
+        try {
+            state = stateManager.loadState();
+        }
+        catch {
+            output.error({
+                code: 'STATE_MISSING',
+                message: 'No state.json found',
+                exitCode: 1,
+                recovery: 'Run scaffold init',
+            });
+            process.exit(1);
+            return;
+        }
+        // 4. Load decisions
+        const decisions = readDecisions(projectRoot);
+        // 5. Load config for methodology
+        const { config } = loadConfig(projectRoot, []);
+        const methodology = config?.methodology?.preset ??
+            state.config_methodology ??
+            'unknown';
+        // 6. Generate dashboard data
+        const dashboardData = generateDashboardData({ state, decisions, methodology });
+        // 7. JSON-only mode — output data and exit
+        if (argv['json-only']) {
+            output.result(dashboardData);
+            process.exit(0);
+            return;
+        }
+        // 8. Generate HTML
+        const html = generateHtml(dashboardData);
+        // 9. Determine output path
+        const outputPath = argv.output ?? path.join(os.tmpdir(), `scaffold-dashboard-${Date.now()}.html`);
+        // 10. Create parent directory if needed and write file
+        fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+        fs.writeFileSync(outputPath, html, 'utf8');
+        // 11. Open in browser (unless --no-open)
+        if (!argv['no-open']) {
+            let opener = 'xdg-open';
+            if (process.platform === 'darwin')
+                opener = 'open';
+            if (process.platform === 'win32')
+                opener = 'start';
+            try {
+                execSync(`${opener} "${outputPath}"`);
+            }
+            catch {
+                // Ignore errors when opening browser
+            }
+        }
+        // 12. Report success
+        output.success(`Dashboard generated: ${outputPath}`);
+        process.exit(0);
+    },
+};
+export default dashboardCommand;
+//# sourceMappingURL=dashboard.js.map

package/dist/cli/commands/dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../../src/cli/commands/dashboard.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAgBlF,MAAM,gBAAgB,GAA0D;IAC9E,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,oCAAoC;IAC9C,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;QACjB,OAAO,KAAK;aACT,MAAM,CAAC,QAAQ,EAAE;YAChB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,2BAA2B;SACzC,CAAC;aACD,MAAM,CAAC,SAAS,EAAE;YACjB,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,yBAAyB;YACtC,OAAO,EAAE,KAAK;SACf,CAAC;aACD,MAAM,CAAC,WAAW,EAAE;YACnB,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,+BAA+B;YAC5C,OAAO,EAAE,KAAK;SACf,CAAC,CAAA;IACN,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,0BAA0B;QAC1B,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,IAAI,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;QAC/D,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,oEAAoE;gBACpE,sDAAsD,CACvD,CAAA;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACf,OAAM;QACR,CAAC;QAED,4CAA4C;QAC5C,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAA;QAC1C,MAAM,MAAM,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAA;QAE9C,gBAAgB;QAChB,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;QAC5D,IAAI,KAAoB,CAAA;QACxB,IAAI,CAAC;YACH,KAAK,GAAG,YAAY,CAAC,SAAS,EAAE,CAAA;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,KAAK,CAAC;gBACX,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,qBAAqB;gBAC9B,QAAQ,EAAE,CAAC;gBACX,QAAQ,EAAE,mBAAmB;aAC9B,CAAC,CAAA;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACf,OAAM;QACR,CAAC;QAED,oBAAoB;QACpB,MAAM,SAAS,GAAG,aAAa,CAAC,WAAW,CAAC,CAAA;QAE5C,iCAAiC;QACjC,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC,CAAA;QAC9C,MAAM,WAAW,GACd,MAAgC,EAAE,WAAW,EAAE,MAAM;YACtD,KAAK,CAAC,kBAAkB;YACxB,SAAS,CAAA;QAEX,6BAA6B;QAC7B,MAAM,aAAa,GAAG,qBAAqB,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAA;QAE9E,2CAA2C;QAC3C,IAAI,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACtB,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;YAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACf,OAAM;QACR,CAAC;QAED,mBAAmB;QACnB,MAAM,IAAI,GAAG,YAAY,CAAC,aAAa,CAAC,CAAA;QAExC,2BAA2B;QAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,sBAAsB,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAEjG,uDAAuD;QACvD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC3D,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;QAE1C,yCAAyC;QACzC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACrB,IAAI,MAAM,GAAG,UAAU,CAAA;YACvB,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ;gBAAE,MAAM,GAAG,MAAM,CAAA;YAClD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;gBAAE,MAAM,GAAG,OAAO,CAAA;YAClD,IAAI,CAAC;gBACH,QAAQ,CAAC,GAAG,MAAM,KAAK,UAAU,GAAG,CAAC,CAAA;YACvC,CAAC;YAAC,MAAM,CAAC;gBACP,qCAAqC;YACvC,CAAC;QACH,CAAC;QAED,qBAAqB;QACrB,MAAM,CAAC,OAAO,CAAC,wBAAwB,UAAU,EAAE,CAAC,CAAA;QACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;CACF,CAAA;AAED,eAAe,gBAAgB,CAAA"}

package/dist/cli/commands/dashboard.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dashboard.test.d.ts.map

package/dist/cli/commands/dashboard.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.test.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/dashboard.test.ts"],"names":[],"mappings":""}

package/dist/cli/commands/dashboard.test.js

@@ -0,0 +1,142 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import * as projectRootModule from '../middleware/project-root.js';
+const tmpDirs = [];
+function makeTmpDir() {
+    const d = path.join(os.tmpdir(), `scaffold-dashboard-test-${crypto.randomUUID()}`);
+    fs.mkdirSync(d, { recursive: true });
+    tmpDirs.push(d);
+    return d;
+}
+function makeProjectDir(stateContent) {
+    const dir = makeTmpDir();
+    fs.mkdirSync(path.join(dir, '.scaffold'), { recursive: true });
+    const state = stateContent ?? JSON.stringify({
+        'schema-version': 1,
+        'scaffold-version': '2.0.0',
+        init_methodology: 'deep',
+        config_methodology: 'deep',
+        'init-mode': 'greenfield',
+        created: '2024-01-01T00:00:00.000Z',
+        in_progress: null,
+        steps: {
+            'create-prd': {
+                status: 'completed',
+                source: 'pipeline',
+                at: '2024-01-02T00:00:00.000Z',
+                completed_by: 'claude',
+                depth: 2,
+                produces: ['docs/prd.md'],
+            },
+        },
+        next_eligible: [],
+        'extra-steps': [],
+    });
+    fs.writeFileSync(path.join(dir, '.scaffold', 'state.json'), state, 'utf8');
+    return dir;
+}
+afterEach(() => {
+    for (const d of tmpDirs) {
+        try {
+            fs.rmSync(d, { recursive: true, force: true });
+        }
+        catch { /* ignore */ }
+    }
+    tmpDirs.length = 0;
+    vi.restoreAllMocks();
+});
+async function runDashboardHandler(argv) {
+    const mod = await import('./dashboard.js');
+    const cmd = mod.default;
+    if (typeof cmd.handler === 'function') {
+        await cmd.handler(argv);
+    }
+}
+const BASE_ARGV = {
+    root: undefined,
+    format: undefined,
+    auto: false,
+    output: undefined,
+    'no-open': true,
+    'json-only': false,
+};
+describe('dashboard command', () => {
+    let stdoutWrite;
+    let stderrWrite;
+    let exitSpy;
+    beforeEach(() => {
+        stdoutWrite = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        stderrWrite = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+        exitSpy = vi.spyOn(process, 'exit').mockImplementation(((code) => {
+            throw new Error(`process.exit(${code})`);
+        }));
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('exits 1 when project root not found', async () => {
+        vi.spyOn(projectRootModule, 'findProjectRoot').mockReturnValue(null);
+        await expect(runDashboardHandler({ ...BASE_ARGV })).rejects.toThrow('process.exit(1)');
+        expect(exitSpy).toHaveBeenCalledWith(1);
+    });
+    it('--json-only outputs JSON to stdout', async () => {
+        const dir = makeProjectDir();
+        vi.spyOn(projectRootModule, 'findProjectRoot').mockReturnValue(dir);
+        await expect(runDashboardHandler({ ...BASE_ARGV, format: 'json', 'json-only': true })).rejects.toThrow('process.exit(0)');
+        const allStdout = stdoutWrite.mock.calls.map(c => String(c[0])).join('');
+        const parsed = JSON.parse(allStdout);
+        expect(parsed.success).toBe(true);
+        expect(parsed.data).toHaveProperty('methodology');
+        expect(parsed.data).toHaveProperty('steps');
+        expect(parsed.data).toHaveProperty('progress');
+        expect(parsed.data).toHaveProperty('decisions');
+    });
+    it('generates HTML file at specified --output path', async () => {
+        const dir = makeProjectDir();
+        const outDir = makeTmpDir();
+        const outputPath = path.join(outDir, 'dashboard.html');
+        vi.spyOn(projectRootModule, 'findProjectRoot').mockReturnValue(dir);
+        await expect(runDashboardHandler({ ...BASE_ARGV, output: outputPath })).rejects.toThrow('process.exit(0)');
+        expect(fs.existsSync(outputPath)).toBe(true);
+        const content = fs.readFileSync(outputPath, 'utf8');
+        expect(content.trimStart().startsWith('<!DOCTYPE html>')).toBe(true);
+    });
+    it('creates parent directories for --output path', async () => {
+        const dir = makeProjectDir();
+        const outDir = makeTmpDir();
+        const outputPath = path.join(outDir, 'nested', 'deep', 'dashboard.html');
+        vi.spyOn(projectRootModule, 'findProjectRoot').mockReturnValue(dir);
+        await expect(runDashboardHandler({ ...BASE_ARGV, output: outputPath })).rejects.toThrow('process.exit(0)');
+        expect(fs.existsSync(outputPath)).toBe(true);
+    });
+    it('--no-open generates HTML and exits 0 without attempting browser open', async () => {
+        // When --no-open is true the handler must not invoke any browser opener.
+        // We verify this by asserting the command succeeds cleanly even in a
+        // headless environment where open/xdg-open would not be available.
+        const dir = makeProjectDir();
+        const outDir = makeTmpDir();
+        const outputPath = path.join(outDir, 'dashboard.html');
+        vi.spyOn(projectRootModule, 'findProjectRoot').mockReturnValue(dir);
+        await expect(runDashboardHandler({ ...BASE_ARGV, output: outputPath })).rejects.toThrow('process.exit(0)');
+        // File exists, so the handler completed the write step
+        expect(fs.existsSync(outputPath)).toBe(true);
+        expect(exitSpy).toHaveBeenCalledWith(0);
+    });
+    it('outputs success message with file path in interactive mode', async () => {
+        const dir = makeProjectDir();
+        const outDir = makeTmpDir();
+        const outputPath = path.join(outDir, 'dashboard.html');
+        vi.spyOn(projectRootModule, 'findProjectRoot').mockReturnValue(dir);
+        await expect(runDashboardHandler({ ...BASE_ARGV, output: outputPath })).rejects.toThrow('process.exit(0)');
+        const allOutput = [
+            ...stdoutWrite.mock.calls.map(c => String(c[0])),
+            ...stderrWrite.mock.calls.map(c => String(c[0])),
+        ].join('');
+        expect(allOutput).toContain('Dashboard generated');
+        expect(allOutput).toContain(outputPath);
+    });
+});
+//# sourceMappingURL=dashboard.test.js.map

package/dist/cli/commands/dashboard.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.test.js","sourceRoot":"","sources":["../../../src/cli/commands/dashboard.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,MAAM,MAAM,aAAa,CAAA;AAChC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAExE,OAAO,KAAK,iBAAiB,MAAM,+BAA+B,CAAA;AAElE,MAAM,OAAO,GAAa,EAAE,CAAA;AAE5B,SAAS,UAAU;IACjB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,2BAA2B,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;IAClF,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACf,OAAO,CAAC,CAAA;AACV,CAAC;AAED,SAAS,cAAc,CAAC,YAAqB;IAC3C,MAAM,GAAG,GAAG,UAAU,EAAE,CAAA;IACxB,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC9D,MAAM,KAAK,GAAG,YAAY,IAAI,IAAI,CAAC,SAAS,CAAC;QAC3C,gBAAgB,EAAE,CAAC;QACnB,kBAAkB,EAAE,OAAO;QAC3B,gBAAgB,EAAE,MAAM;QACxB,kBAAkB,EAAE,MAAM;QAC1B,WAAW,EAAE,YAAY;QACzB,OAAO,EAAE,0BAA0B;QACnC,WAAW,EAAE,IAAI;QACjB,KAAK,EAAE;YACL,YAAY,EAAE;gBACZ,MAAM,EAAE,WAAW;gBACnB,MAAM,EAAE,UAAU;gBAClB,EAAE,EAAE,0BAA0B;gBAC9B,YAAY,EAAE,QAAQ;gBACtB,KAAK,EAAE,CAAC;gBACR,QAAQ,EAAE,CAAC,aAAa,CAAC;aAC1B;SACF;QACD,aAAa,EAAE,EAAE;QACjB,aAAa,EAAE,EAAE;KAClB,CAAC,CAAA;IACF,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;IAC1E,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,SAAS,CAAC,GAAG,EAAE;IACb,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC;YAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,CAAC,MAAM,GAAG,CAAC,CAAA;IAClB,EAAE,CAAC,eAAe,EAAE,CAAA;AACtB,CAAC,CAAC,CAAA;AAEF,KAAK,UAAU,mBAAmB,CAAC,IAA6B;IAC9D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAA;IAC1C,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAA;IACvB,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QACtC,MAAM,GAAG,CAAC,OAAO,CAAC,IAAa,CAAC,CAAA;IAClC,CAAC;AACH,CAAC;AAED,MAAM,SAAS,GAAG;IAChB,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,KAAK;IACX,MAAM,EAAE,SAA+B;IACvC,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,KAAK;CACnB,CAAA;AAED,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,IAAI,WAAsD,CAAA;IAC1D,IAAI,WAAsD,CAAA;IAC1D,IAAI,OAAqB,CAAA;IAEzB,UAAU,CAAC,GAAG,EAAE;QACd,WAAW,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;QAC9E,WAAW,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;QAC9E,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAa,EAAE,EAAE;YACxE,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,GAAG,CAAC,CAAA;QAC1C,CAAC,CAAU,CAAC,CAAA;IACd,CAAC,CAAC,CAAA;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAA;IACtB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,EAAE,CAAC,KAAK,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;QAEpE,MAAM,MAAM,CACV,mBAAmB,CAAC,EAAE,GAAG,SAAS,EAAE,CAAC,CACtC,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;QAEpC,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,GAAG,GAAG,cAAc,EAAE,CAAA;QAC5B,EAAE,CAAC,KAAK,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAA;QAEnE,MAAM,MAAM,CACV,mBAAmB,CAAC,EAAE,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CACzE,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;QAEpC,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACxE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAGlC,CAAA;QACD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,aAAa,CAAC,CAAA;QACjD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;QAC3C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,CAAA;QAC9C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,CAAA;IACjD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,GAAG,GAAG,cAAc,EAAE,CAAA;QAC5B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;QAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;QACtD,EAAE,CAAC,KAAK,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAA;QAEnE,MAAM,MAAM,CACV,mBAAmB,CAAC,EAAE,GAAG,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAC1D,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;QAEpC,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC5C,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;QACnD,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACtE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,GAAG,GAAG,cAAc,EAAE,CAAA;QAC5B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;QAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAA;QACxE,EAAE,CAAC,KAAK,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAA;QAEnE,MAAM,MAAM,CACV,mBAAmB,CAAC,EAAE,GAAG,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAC1D,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;QAEpC,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;QACpF,yEAAyE;QACzE,qEAAqE;QACrE,mEAAmE;QACnE,MAAM,GAAG,GAAG,cAAc,EAAE,CAAA;QAC5B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;QAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;QACtD,EAAE,CAAC,KAAK,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAA;QAEnE,MAAM,MAAM,CACV,mBAAmB,CAAC,EAAE,GAAG,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAC1D,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;QAEpC,uDAAuD;QACvD,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC5C,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,GAAG,GAAG,cAAc,EAAE,CAAA;QAC5B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;QAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;QACtD,EAAE,CAAC,KAAK,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAA;QAEnE,MAAM,MAAM,CACV,mBAAmB,CAAC,EAAE,GAAG,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAC1D,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;QAEpC,MAAM,SAAS,GAAG;YAChB,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAChD,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACjD,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACV,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAA;QAClD,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/cli/commands/decisions.d.ts

@@ -0,0 +1,13 @@
+import type { CommandModule } from 'yargs';
+interface DecisionsArgs {
+    step?: string;
+    last?: number;
+    format?: string;
+    auto?: boolean;
+    verbose?: boolean;
+    root?: string;
+    force?: boolean;
+}
+declare const decisionsCommand: CommandModule<Record<string, unknown>, DecisionsArgs>;
+export default decisionsCommand;
+//# sourceMappingURL=decisions.d.ts.map

package/dist/cli/commands/decisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/decisions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAM1C,UAAU,aAAa;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,QAAA,MAAM,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,CAuD3E,CAAA;AAED,eAAe,gBAAgB,CAAA"}

package/dist/cli/commands/decisions.js

@@ -0,0 +1,62 @@
+import { readDecisions } from '../../state/decision-logger.js';
+import { findProjectRoot } from '../middleware/project-root.js';
+import { resolveOutputMode } from '../middleware/output-mode.js';
+import { createOutputContext } from '../output/context.js';
+const decisionsCommand = {
+    command: 'decisions',
+    describe: 'Show recorded decisions',
+    builder: (yargs) => {
+        return yargs
+            .option('step', {
+            type: 'string',
+            description: 'Filter decisions by step slug',
+        })
+            .option('last', {
+            type: 'number',
+            description: 'Show last N decisions',
+        });
+    },
+    handler: async (argv) => {
+        const projectRoot = argv.root ?? findProjectRoot(process.cwd());
+        if (!projectRoot) {
+            process.exit(1);
+        }
+        const outputMode = resolveOutputMode(argv);
+        const output = createOutputContext(outputMode);
+        const decisions = readDecisions(projectRoot, {
+            step: argv.step,
+            last: argv.last,
+        });
+        if (outputMode === 'json') {
+            output.result({
+                decisions: decisions.map(d => ({
+                    id: d.id,
+                    step: d.prompt,
+                    decision: d.decision,
+                    rationale: undefined,
+                    category: d.category,
+                    actor: d.completed_by,
+                    timestamp: d.at,
+                    provisional: d.step_completed === false,
+                })),
+                total: decisions.length,
+            });
+        }
+        else {
+            if (decisions.length === 0) {
+                output.info('No decisions recorded.');
+            }
+            else {
+                for (const d of decisions) {
+                    const provisional = d.step_completed === false ? ' [provisional]' : '';
+                    output.info(`${d.id} [${d.prompt}]${provisional}: ${d.decision}`);
+                    if (d.category)
+                        output.info(`  Category: ${d.category}`);
+                }
+            }
+        }
+        process.exit(0);
+    },
+};
+export default decisionsCommand;
+//# sourceMappingURL=decisions.js.map