@zigrivers/scaffold 2.1.0

package/dist/cli/commands/skip.js

@@ -0,0 +1,123 @@
+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 { acquireLock, releaseLock } from '../../state/lock-manager.js';
+import { findClosestMatch } from '../../utils/levenshtein.js';
+const skipCommand = {
+    command: 'skip <step>',
+    describe: 'Skip a pipeline step',
+    builder: (yargs) => {
+        return yargs
+            .positional('step', {
+            type: 'string',
+            description: 'Step slug to skip',
+            demandOption: true,
+        })
+            .option('reason', {
+            type: 'string',
+            description: 'Reason for skipping',
+        });
+    },
+    handler: async (argv) => {
+        const projectRoot = argv.root ?? findProjectRoot(process.cwd());
+        if (!projectRoot) {
+            process.stderr.write('\u2717 error [PROJECT_NOT_INITIALIZED]: No .scaffold/ directory found\n');
+            process.exit(1);
+            return;
+        }
+        const outputMode = resolveOutputMode(argv);
+        const output = createOutputContext(outputMode);
+        // Acquire lock
+        const lockResult = acquireLock(projectRoot, 'skip', argv.step);
+        if (!lockResult.acquired && !argv.force) {
+            if (lockResult.error) {
+                output.warn(`${lockResult.error.code}: ${lockResult.error.message}`);
+            }
+            else {
+                output.warn('Lock is held by another process');
+            }
+            process.exit(3);
+            return;
+        }
+        try {
+            const stateManager = new StateManager(projectRoot, () => []);
+            const state = stateManager.loadState();
+            // Check step exists
+            if (!(argv.step in state.steps)) {
+                const suggestion = findClosestMatch(argv.step, Object.keys(state.steps));
+                const msg = suggestion
+                    ? `Step '${argv.step}' not found. Did you mean '${suggestion}'?`
+                    : `Step '${argv.step}' not found`;
+                output.error({
+                    code: 'DEP_TARGET_MISSING',
+                    message: msg,
+                    exitCode: 2,
+                    recovery: 'Run `scaffold list` to see available steps',
+                });
+                process.exit(2);
+                return;
+            }
+            const stepEntry = state.steps[argv.step];
+            // Handle already-skipped
+            if (stepEntry.status === 'skipped') {
+                output.info(`Step '${argv.step}' is already skipped`);
+                process.exit(0);
+                return;
+            }
+            // Handle already-completed
+            if (stepEntry.status === 'completed') {
+                if (outputMode !== 'interactive') {
+                    if (!argv.force) {
+                        output.error({
+                            code: 'PSM_INVALID_TRANSITION',
+                            message: `Step '${argv.step}' is already completed`,
+                            exitCode: 3,
+                            recovery: 'Use --force to re-mark as skipped',
+                        });
+                        process.exit(3);
+                        return;
+                    }
+                }
+                else {
+                    const proceed = await output.confirm(`Step '${argv.step}' is already completed. Re-mark as skipped?`, false);
+                    if (!proceed) {
+                        process.exit(0);
+                        return;
+                    }
+                }
+            }
+            // Handle in_progress warning
+            if (stepEntry.status === 'in_progress') {
+                output.warn(`Step '${argv.step}' appears to be in progress \u2014 an agent session may be actively executing it`);
+            }
+            // Mark skipped
+            stateManager.markSkipped(argv.step, argv.reason ?? 'user-requested', 'scaffold-skip');
+            // Compute newly eligible
+            const newState = stateManager.loadState();
+            const newlyEligible = newState.next_eligible ?? [];
+            if (outputMode === 'json') {
+                output.result({
+                    step: argv.step,
+                    reason: argv.reason ?? 'user-requested',
+                    skippedAt: new Date().toISOString(),
+                    newly_eligible: newlyEligible,
+                });
+            }
+            else {
+                output.success(`Step '${argv.step}' marked as skipped`);
+                if (newlyEligible.length > 0) {
+                    output.info(`Newly eligible: ${newlyEligible.join(', ')}`);
+                }
+            }
+            process.exit(0);
+        }
+        finally {
+            if (lockResult.acquired) {
+                releaseLock(projectRoot);
+            }
+        }
+    },
+};
+export default skipCommand;
+//# sourceMappingURL=skip.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,339 @@
+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('../../state/state-manager.js', () => ({
+    StateManager: vi.fn().mockImplementation(() => ({
+        loadState: vi.fn(),
+        markSkipped: vi.fn(),
+    })),
+}));
+vi.mock('../../state/lock-manager.js', () => ({
+    acquireLock: vi.fn(() => ({ acquired: true })),
+    releaseLock: vi.fn(),
+}));
+vi.mock('../../utils/levenshtein.js', () => ({
+    findClosestMatch: vi.fn(() => null),
+}));
+// ---------------------------------------------------------------------------
+// Imports (after mocks)
+// ---------------------------------------------------------------------------
+import { findProjectRoot } from '../middleware/project-root.js';
+import { resolveOutputMode } from '../middleware/output-mode.js';
+import { StateManager } from '../../state/state-manager.js';
+import { acquireLock, releaseLock } from '../../state/lock-manager.js';
+import { findClosestMatch } from '../../utils/levenshtein.js';
+import skipCommand from './skip.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function makeState(overrides = {}) {
+    return {
+        '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: {},
+        next_eligible: [],
+        'extra-steps': [],
+        ...overrides,
+    };
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('skip command', () => {
+    let exitSpy;
+    let stdoutSpy;
+    let stderrSpy;
+    let writtenLines;
+    const mockFindProjectRoot = vi.mocked(findProjectRoot);
+    const mockResolveOutputMode = vi.mocked(resolveOutputMode);
+    const MockStateManager = vi.mocked(StateManager);
+    const mockAcquireLock = vi.mocked(acquireLock);
+    const mockFindClosestMatch = vi.mocked(findClosestMatch);
+    beforeEach(() => {
+        writtenLines = [];
+        exitSpy = vi.spyOn(process, 'exit').mockImplementation((() => { }));
+        stdoutSpy = vi.spyOn(process.stdout, 'write').mockImplementation((chunk) => {
+            writtenLines.push(String(chunk));
+            return true;
+        });
+        stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+        // Defaults
+        mockFindProjectRoot.mockReturnValue('/fake/project');
+        mockResolveOutputMode.mockReturnValue('interactive');
+        mockAcquireLock.mockReturnValue({ acquired: true });
+        mockFindClosestMatch.mockReturnValue(null);
+        // Default state with a pending step
+        MockStateManager.mockImplementation(() => ({
+            loadState: vi.fn(() => makeState({
+                steps: {
+                    'some-step': { status: 'pending', source: 'pipeline', produces: [] },
+                },
+                next_eligible: ['other-step'],
+            })),
+            markSkipped: vi.fn(),
+        }));
+    });
+    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 = {
+            step: 'some-step',
+            reason: undefined,
+            format: undefined,
+            auto: undefined,
+            verbose: undefined,
+            root: undefined,
+            force: undefined,
+        };
+        await skipCommand.handler(argv);
+        expect(exitSpy).toHaveBeenCalledWith(1);
+    });
+    // Test 2: Marks step as skipped successfully
+    it('marks step as skipped successfully', async () => {
+        const mockMarkSkipped = vi.fn();
+        MockStateManager.mockImplementation(() => ({
+            loadState: vi.fn(() => makeState({
+                steps: {
+                    'some-step': { status: 'pending', source: 'pipeline', produces: [] },
+                },
+                next_eligible: ['other-step'],
+            })),
+            markSkipped: mockMarkSkipped,
+        }));
+        const argv = {
+            step: 'some-step',
+            reason: 'not needed',
+            format: undefined,
+            auto: undefined,
+            verbose: undefined,
+            root: undefined,
+            force: undefined,
+        };
+        await skipCommand.handler(argv);
+        expect(mockMarkSkipped).toHaveBeenCalledWith('some-step', 'not needed', 'scaffold-skip');
+        expect(exitSpy).toHaveBeenCalledWith(0);
+    });
+    // Test 3: Step not found exits 2 with DEP_TARGET_MISSING
+    it('step not found exits 2 with DEP_TARGET_MISSING', async () => {
+        MockStateManager.mockImplementation(() => ({
+            loadState: vi.fn(() => makeState({
+                steps: { 'existing-step': { status: 'pending', source: 'pipeline', produces: [] } },
+                next_eligible: [],
+            })),
+            markSkipped: vi.fn(),
+        }));
+        const argv = {
+            step: 'missing-step',
+            reason: undefined,
+            format: undefined,
+            auto: undefined,
+            verbose: undefined,
+            root: undefined,
+            force: undefined,
+        };
+        await skipCommand.handler(argv);
+        expect(exitSpy).toHaveBeenCalledWith(2);
+        const allOutput = writtenLines.join('');
+        expect(allOutput).toContain('DEP_TARGET_MISSING');
+    });
+    // Test 4: Step not found includes fuzzy suggestion
+    it('step not found includes fuzzy suggestion when close match exists', async () => {
+        mockFindClosestMatch.mockReturnValue('existing-step');
+        MockStateManager.mockImplementation(() => ({
+            loadState: vi.fn(() => makeState({
+                steps: { 'existing-step': { status: 'pending', source: 'pipeline', produces: [] } },
+                next_eligible: [],
+            })),
+            markSkipped: vi.fn(),
+        }));
+        const argv = {
+            step: 'existin-step',
+            reason: undefined,
+            format: undefined,
+            auto: undefined,
+            verbose: undefined,
+            root: undefined,
+            force: undefined,
+        };
+        await skipCommand.handler(argv);
+        expect(exitSpy).toHaveBeenCalledWith(2);
+        const allOutput = writtenLines.join('');
+        expect(allOutput).toContain('existing-step');
+    });
+    // Test 5: Already completed exits 3 in json mode (PSM_INVALID_TRANSITION)
+    it('already completed exits 3 in json mode without --force', async () => {
+        mockResolveOutputMode.mockReturnValue('json');
+        MockStateManager.mockImplementation(() => ({
+            loadState: vi.fn(() => makeState({
+                steps: {
+                    'completed-step': { status: 'completed', source: 'pipeline', produces: [] },
+                },
+                next_eligible: [],
+            })),
+            markSkipped: vi.fn(),
+        }));
+        const argv = {
+            step: 'completed-step',
+            reason: undefined,
+            format: 'json',
+            auto: undefined,
+            verbose: undefined,
+            root: undefined,
+            force: undefined,
+        };
+        await skipCommand.handler(argv);
+        expect(exitSpy).toHaveBeenCalledWith(3);
+        const stderrOutput = stderrSpy.mock.calls.map((c) => String(c[0])).join('');
+        expect(stderrOutput).toContain('PSM_INVALID_TRANSITION');
+    });
+    // Test 6: Already completed prompts confirm in interactive mode
+    it('already completed prompts confirm in interactive mode and proceeds if confirmed', async () => {
+        mockResolveOutputMode.mockReturnValue('interactive');
+        const mockMarkSkipped = vi.fn();
+        MockStateManager.mockImplementation(() => ({
+            loadState: vi.fn(() => makeState({
+                steps: {
+                    'completed-step': { status: 'completed', source: 'pipeline', produces: [] },
+                },
+                next_eligible: [],
+            })),
+            markSkipped: mockMarkSkipped,
+        }));
+        // Spy on createOutputContext to inject our confirm mock
+        const contextModule = await import('../output/context.js');
+        const mockConfirm = vi.fn().mockResolvedValue(true);
+        vi.spyOn(contextModule, 'createOutputContext').mockReturnValue({
+            success: vi.fn(),
+            info: vi.fn(),
+            warn: vi.fn(),
+            error: vi.fn(),
+            result: vi.fn(),
+            prompt: vi.fn(),
+            confirm: mockConfirm,
+            startSpinner: vi.fn(),
+            stopSpinner: vi.fn(),
+            startProgress: vi.fn(),
+            updateProgress: vi.fn(),
+            stopProgress: vi.fn(),
+        });
+        const argv = {
+            step: 'completed-step',
+            reason: undefined,
+            format: undefined,
+            auto: undefined,
+            verbose: undefined,
+            root: undefined,
+            force: undefined,
+        };
+        await skipCommand.handler(argv);
+        expect(mockConfirm).toHaveBeenCalled();
+        expect(mockMarkSkipped).toHaveBeenCalledWith('completed-step', 'user-requested', 'scaffold-skip');
+        expect(exitSpy).toHaveBeenCalledWith(0);
+        vi.mocked(contextModule.createOutputContext).mockRestore();
+    });
+    // Test 7: Already skipped shows info and exits 0
+    it('already skipped shows info and exits 0', async () => {
+        MockStateManager.mockImplementation(() => ({
+            loadState: vi.fn(() => makeState({
+                steps: {
+                    'skipped-step': { status: 'skipped', source: 'pipeline', produces: [], reason: 'not needed' },
+                },
+                next_eligible: [],
+            })),
+            markSkipped: vi.fn(),
+        }));
+        const argv = {
+            step: 'skipped-step',
+            reason: undefined,
+            format: undefined,
+            auto: undefined,
+            verbose: undefined,
+            root: undefined,
+            force: undefined,
+        };
+        await skipCommand.handler(argv);
+        expect(exitSpy).toHaveBeenCalledWith(0);
+        const allOutput = writtenLines.join('');
+        expect(allOutput).toContain('already skipped');
+    });
+    // Test 8: in_progress step triggers warning
+    it('in_progress step triggers a warning before skipping', async () => {
+        const mockMarkSkipped = vi.fn();
+        MockStateManager.mockImplementation(() => ({
+            loadState: vi.fn(() => makeState({
+                steps: {
+                    'active-step': { status: 'in_progress', source: 'pipeline', produces: [] },
+                },
+                next_eligible: [],
+            })),
+            markSkipped: mockMarkSkipped,
+        }));
+        const argv = {
+            step: 'active-step',
+            reason: undefined,
+            format: undefined,
+            auto: undefined,
+            verbose: undefined,
+            root: undefined,
+            force: undefined,
+        };
+        await skipCommand.handler(argv);
+        const allOutput = writtenLines.join('');
+        expect(allOutput).toContain('in progress');
+        expect(mockMarkSkipped).toHaveBeenCalled();
+        expect(exitSpy).toHaveBeenCalledWith(0);
+    });
+    // Test 9: JSON output has step, reason, skippedAt, newly_eligible fields
+    it('JSON output has step, reason, skippedAt, newly_eligible fields', async () => {
+        mockResolveOutputMode.mockReturnValue('json');
+        MockStateManager.mockImplementation(() => ({
+            loadState: vi.fn(() => makeState({
+                steps: {
+                    'my-step': { status: 'pending', source: 'pipeline', produces: [] },
+                },
+                next_eligible: ['next-step'],
+            })),
+            markSkipped: vi.fn(),
+        }));
+        const argv = {
+            step: 'my-step',
+            reason: 'not needed',
+            format: 'json',
+            auto: undefined,
+            verbose: undefined,
+            root: undefined,
+            force: undefined,
+        };
+        await skipCommand.handler(argv);
+        const allOutput = writtenLines.join('');
+        const parsed = JSON.parse(allOutput);
+        // JsonOutput wraps in { success: true, data: ... }
+        const data = parsed.data ?? parsed;
+        expect(data).toHaveProperty('step', 'my-step');
+        expect(data).toHaveProperty('reason', 'not needed');
+        expect(data).toHaveProperty('skippedAt');
+        expect(data).toHaveProperty('newly_eligible');
+        expect(Array.isArray(data.newly_eligible)).toBe(true);
+        expect(exitSpy).toHaveBeenCalledWith(0);
+        // Silence unused variable warnings
+        void stdoutSpy;
+        void mockAcquireLock;
+        void releaseLock;
+    });
+});
+//# sourceMappingURL=skip.test.js.map

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

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

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

@@ -0,0 +1,12 @@
+import type { CommandModule } from 'yargs';
+interface StatusArgs {
+    phase?: number;
+    format?: string;
+    auto?: boolean;
+    verbose?: boolean;
+    root?: string;
+    force?: boolean;
+}
+declare const statusCommand: CommandModule<Record<string, unknown>, StatusArgs>;
+export default statusCommand;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAU1C,UAAU,UAAU;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,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;AAID,QAAA,MAAM,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,CAoFrE,CAAA;AAED,eAAe,aAAa,CAAA"}

package/dist/cli/commands/status.js

@@ -0,0 +1,79 @@
+import path from 'node:path';
+import { findProjectRoot } from '../middleware/project-root.js';
+import { resolveOutputMode } from '../middleware/output-mode.js';
+import { createOutputContext } from '../output/context.js';
+import { loadConfig } from '../../config/loader.js';
+import { StateManager } from '../../state/state-manager.js';
+import { discoverMetaPrompts } from '../../core/assembly/meta-prompt-loader.js';
+import { loadAllPresets } from '../../core/assembly/preset-loader.js';
+const statusCommand = {
+    command: 'status',
+    describe: 'Show pipeline progress and step statuses',
+    builder: (yargs) => {
+        return yargs.option('phase', {
+            type: 'number',
+            description: 'Filter output to a specific phase number',
+        });
+    },
+    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');
+            process.stderr.write('  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 config and state
+        const { config } = loadConfig(projectRoot, []);
+        const stateManager = new StateManager(projectRoot, () => []);
+        const state = stateManager.loadState();
+        // 4. Discover meta-prompts
+        const metaPrompts = discoverMetaPrompts(path.join(projectRoot, 'pipeline'));
+        loadAllPresets(path.join(projectRoot, 'methodology'), [...metaPrompts.keys()]);
+        // 5. Build progress stats
+        const { steps } = state;
+        const completed = Object.values(steps).filter(s => s.status === 'completed').length;
+        const skipped = Object.values(steps).filter(s => s.status === 'skipped').length;
+        const pending = Object.values(steps).filter(s => s.status === 'pending').length;
+        const inProgress = Object.values(steps).filter(s => s.status === 'in_progress').length;
+        const total = Object.keys(steps).length;
+        const pct = total > 0 ? Math.round((completed + skipped) / total * 100) : 0;
+        const methodology = config?.methodology?.preset ?? state.config_methodology;
+        // 6. Display or return JSON
+        if (outputMode === 'json') {
+            output.result({
+                pipeline: { methodology, total, completed, skipped, pending, inProgress },
+                progress: { completed, skipped, pending, inProgress, total, percentage: pct },
+                phases: [],
+                nextEligible: state.next_eligible,
+                orphaned_entries: [],
+            });
+        }
+        else {
+            output.info(`Pipeline: ${methodology} | Progress: ${pct}% (${completed}/${total})`);
+            const statusIcons = {
+                completed: '✓',
+                skipped: '→',
+                in_progress: '●',
+                pending: '○',
+            };
+            for (const [slug, entry] of Object.entries(steps)) {
+                const mp = metaPrompts.get(slug);
+                const phase = mp?.frontmatter?.phase ?? '?';
+                const icon = statusIcons[entry.status] ?? '?';
+                if (argv.phase !== undefined && phase !== String(argv.phase))
+                    continue;
+                output.info(`  ${icon} [${entry.status}] ${slug}`);
+            }
+            const nextEligibleList = state.next_eligible.join(', ') || 'none';
+            output.info(`\nNext eligible: ${nextEligibleList}`);
+        }
+        process.exit(0);
+    },
+};
+export default statusCommand;
+//# sourceMappingURL=status.js.map

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

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

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

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

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

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