@zigrivers/scaffold 2.28.1 → 2.38.1

package/dist/cli/commands/rework.js

@@ -0,0 +1,332 @@
+import { findProjectRoot } from '../middleware/project-root.js';
+import { resolveOutputMode } from '../middleware/output-mode.js';
+import { createOutputContext } from '../output/context.js';
+import { acquireLock, releaseLock } from '../../state/lock-manager.js';
+import { ReworkManager } from '../../state/rework-manager.js';
+import { StateManager } from '../../state/state-manager.js';
+import { discoverMetaPrompts } from '../../core/assembly/meta-prompt-loader.js';
+import { getPackagePipelineDir, getPackageMethodologyDir } from '../../utils/fs.js';
+import { loadConfig } from '../../config/loader.js';
+import { loadAllPresets } from '../../core/assembly/preset-loader.js';
+import { buildGraph } from '../../core/dependency/graph.js';
+import { computeEligible } from '../../core/dependency/eligibility.js';
+import { parsePhases, parseThrough, applyExclusions, resolveStepsForPhases } from '../../core/rework/phase-selector.js';
+import { PHASES } from '../../types/frontmatter.js';
+const reworkCommand = {
+    command: 'rework',
+    describe: 'Re-run pipeline steps by phase for depth improvement or cleanup',
+    builder: (yargs) => {
+        return yargs
+            .option('phases', {
+            type: 'string',
+            description: 'Phase numbers or ranges (e.g., 1-5, 1,3,5, 1-3,5)',
+        })
+            .option('through', {
+            type: 'number',
+            description: 'Shorthand for phases 1 through N',
+        })
+            .option('exclude', {
+            type: 'string',
+            description: 'Exclude specific phases (e.g., 3,5)',
+        })
+            .option('depth', {
+            type: 'number',
+            description: 'Override depth for all steps (1-5)',
+        })
+            .option('fix', {
+            type: 'boolean',
+            description: 'Auto-fix issues in review steps',
+            default: true,
+        })
+            .option('fresh', {
+            type: 'boolean',
+            description: 'Wipe artifacts before re-running',
+            default: false,
+        })
+            .option('resume', {
+            type: 'boolean',
+            description: 'Resume an interrupted rework session',
+            default: false,
+        })
+            .option('clear', {
+            type: 'boolean',
+            description: 'Clear an active rework session',
+            default: false,
+        })
+            .option('advance', {
+            type: 'string',
+            description: 'Mark a step as completed (used by runner skill)',
+        });
+    },
+    handler: async (argv) => {
+        const projectRoot = argv.root ?? findProjectRoot(process.cwd());
+        if (!projectRoot) {
+            process.stderr.write('✗ error [PROJECT_NOT_INITIALIZED]: No .scaffold/ directory found\n');
+            process.exit(1);
+            return;
+        }
+        const outputMode = resolveOutputMode(argv);
+        const output = createOutputContext(outputMode);
+        const reworkManager = new ReworkManager(projectRoot);
+        // --- Branch: --clear ---
+        if (argv.clear) {
+            reworkManager.clearSession();
+            if (outputMode === 'json') {
+                output.result({ action: 'cleared' });
+            }
+            else {
+                output.success('Rework session cleared');
+            }
+            process.exit(0);
+            return;
+        }
+        // --- Branch: --advance <step> ---
+        if (argv.advance) {
+            if (!reworkManager.hasSession()) {
+                output.error({
+                    code: 'REWORK_SESSION_MISSING',
+                    message: 'No active rework session',
+                    exitCode: 1,
+                    recovery: 'Run "scaffold rework" to create a new rework session',
+                });
+                process.exit(1);
+                return;
+            }
+            try {
+                reworkManager.advanceStep(argv.advance);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                output.error({ code: 'REWORK_ADVANCE_FAILED', message, exitCode: 2 });
+                process.exit(2);
+                return;
+            }
+            // Check if all steps are done
+            const session = reworkManager.loadSession();
+            const allDone = session.steps.every(s => s.status !== 'pending' && s.status !== 'in_progress');
+            if (allDone) {
+                if (outputMode === 'json') {
+                    output.result({
+                        action: 'completed',
+                        step: argv.advance,
+                        stats: session.stats,
+                        all_done: true,
+                    });
+                }
+                else {
+                    const { completed, failed, skipped } = session.stats;
+                    output.success(`Rework complete: ${completed} completed, ${failed} failed, ${skipped} skipped`);
+                }
+                reworkManager.clearSession();
+            }
+            else {
+                const nextStep = reworkManager.nextStep();
+                if (outputMode === 'json') {
+                    output.result({
+                        action: 'advanced',
+                        step: argv.advance,
+                        stats: session.stats,
+                        next_step: nextStep?.name ?? null,
+                        all_done: false,
+                    });
+                }
+                else {
+                    output.success(`Step '${argv.advance}' completed`);
+                    if (nextStep) {
+                        output.info(`Next: ${nextStep.name}`);
+                    }
+                }
+            }
+            process.exit(0);
+            return;
+        }
+        // --- Branch: --resume ---
+        if (argv.resume) {
+            if (!reworkManager.hasSession()) {
+                output.error({
+                    code: 'REWORK_SESSION_MISSING',
+                    message: 'No active rework session to resume',
+                    exitCode: 1,
+                    recovery: 'Run "scaffold rework" to create a new rework session',
+                });
+                process.exit(1);
+                return;
+            }
+            const session = reworkManager.loadSession();
+            const nextStep = reworkManager.nextStep();
+            if (outputMode === 'json') {
+                output.result(session);
+            }
+            else {
+                output.info(`Active rework: ${session.stats.completed}/${session.stats.total} steps completed` +
+                    (nextStep ? `. Next: ${nextStep.name}` : '. All steps done.'));
+            }
+            process.exit(0);
+            return;
+        }
+        // --- Branch: new rework ---
+        // Check for existing session
+        if (reworkManager.hasSession() && !argv.force) {
+            output.error({
+                code: 'REWORK_SESSION_EXISTS',
+                message: 'A rework session already exists',
+                exitCode: 1,
+                recovery: 'Use --resume to continue, --clear to remove, or --force to replace',
+            });
+            process.exit(1);
+            return;
+        }
+        // Clear existing session if forcing
+        if (reworkManager.hasSession() && argv.force) {
+            reworkManager.clearSession();
+        }
+        // Resolve phases
+        let phaseNumbers;
+        if (argv.through != null) {
+            phaseNumbers = parseThrough(argv.through);
+        }
+        else if (argv.phases != null) {
+            phaseNumbers = parsePhases(argv.phases);
+        }
+        else if (outputMode !== 'interactive') {
+            // Auto/json mode requires explicit phase selection
+            output.error({
+                code: 'REWORK_NO_PHASES',
+                message: 'No phases specified',
+                exitCode: 1,
+                recovery: 'Use --phases or --through to specify which phases to rework',
+            });
+            process.exit(1);
+            return;
+        }
+        else {
+            // Interactive mode — show phase selector
+            // For now, require explicit flags
+            output.error({
+                code: 'REWORK_NO_PHASES',
+                message: 'Interactive phase selection not yet implemented. Use --phases or --through.',
+                exitCode: 1,
+                recovery: 'Use --phases 1-5 or --through 5 to specify phases',
+            });
+            process.exit(1);
+            return;
+        }
+        // Apply exclusions
+        if (argv.exclude) {
+            const excludePhases = parsePhases(argv.exclude);
+            phaseNumbers = applyExclusions(phaseNumbers, excludePhases);
+        }
+        if (phaseNumbers.length === 0) {
+            output.error({
+                code: 'REWORK_NO_PHASES',
+                message: 'No phases selected after applying exclusions',
+                exitCode: 1,
+            });
+            process.exit(1);
+            return;
+        }
+        // Acquire lock
+        const lockResult = acquireLock(projectRoot, 'rework');
+        if (!lockResult.acquired && !argv.force) {
+            output.error({
+                code: 'LOCK_HELD',
+                message: 'Another scaffold process is running. Use --force to override.',
+                exitCode: 3,
+            });
+            process.exit(3);
+            return;
+        }
+        try {
+            // Load config and pipeline
+            const { config, errors: configErrors } = loadConfig(projectRoot, []);
+            if (!config) {
+                for (const err of configErrors) {
+                    output.error(err);
+                }
+                process.exit(1);
+                return;
+            }
+            const pipelineDir = getPackagePipelineDir(projectRoot);
+            const metaPrompts = discoverMetaPrompts(pipelineDir);
+            const metaPromptList = [...metaPrompts.values()].map(m => m.frontmatter);
+            const methodologyDir = getPackageMethodologyDir(projectRoot);
+            const presets = loadAllPresets(methodologyDir, [...metaPrompts.keys()]);
+            const preset = config.methodology === 'mvp'
+                ? presets.mvp
+                : config.methodology === 'custom'
+                    ? presets.custom ?? presets.deep
+                    : presets.deep;
+            const resolvedPreset = preset ?? {
+                name: 'deep',
+                description: 'Default deep methodology',
+                default_depth: 3,
+                steps: {},
+            };
+            // Build graph
+            const presetStepsMap = new Map(Object.entries(resolvedPreset.steps));
+            const graph = buildGraph(metaPromptList, presetStepsMap);
+            // Load state
+            const computeEligibleFn = (steps) => computeEligible(graph, steps);
+            const stateManager = new StateManager(projectRoot, computeEligibleFn);
+            const state = stateManager.loadState();
+            // Resolve steps for selected phases
+            const reworkSteps = resolveStepsForPhases(phaseNumbers, metaPromptList, state, graph);
+            if (reworkSteps.length === 0) {
+                output.error({
+                    code: 'REWORK_NO_STEPS',
+                    message: `No eligible steps found in phases ${phaseNumbers.join(', ')}`,
+                    exitCode: 1,
+                    recovery: 'Check that the selected phases have steps that are not skipped',
+                });
+                process.exit(1);
+                return;
+            }
+            // Batch-reset selected steps in state.json
+            for (const step of reworkSteps) {
+                if (state.steps[step.name]) {
+                    state.steps[step.name].status = 'pending';
+                    delete state.steps[step.name].at;
+                    delete state.steps[step.name].completed_by;
+                    delete state.steps[step.name].depth;
+                    delete state.steps[step.name].reason;
+                }
+            }
+            if (state.in_progress) {
+                const inProgressInRework = reworkSteps.some(s => s.name === state.in_progress?.step);
+                if (inProgressInRework) {
+                    state.in_progress = null;
+                }
+            }
+            stateManager.saveState(state);
+            // Create rework config
+            const reworkConfig = {
+                phases: phaseNumbers,
+                depth: argv.depth != null ? argv.depth : null,
+                fix: argv.fix !== false,
+                fresh: argv.fresh === true,
+                auto: argv.auto === true,
+            };
+            // Create session
+            const session = reworkManager.createSession(reworkConfig, reworkSteps);
+            // Output
+            const phaseDisplay = phaseNumbers
+                .map(n => PHASES.find(p => p.number === n)?.displayName ?? `Phase ${n}`)
+                .join(', ');
+            const depthDisplay = reworkConfig.depth != null ? ` at depth ${reworkConfig.depth}` : '';
+            if (outputMode === 'json') {
+                output.result(session);
+            }
+            else {
+                output.success(`Rework plan created: ${reworkSteps.length} steps across ${phaseDisplay}${depthDisplay}`);
+            }
+            process.exit(0);
+        }
+        finally {
+            if (lockResult.acquired) {
+                releaseLock(projectRoot);
+            }
+        }
+    },
+};
+export default reworkCommand;
+//# sourceMappingURL=rework.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,297 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+// ---------------------------------------------------------------------------
+// Hoisted mocks
+// ---------------------------------------------------------------------------
+vi.mock('../middleware/project-root.js', () => ({
+    findProjectRoot: vi.fn(),
+}));
+vi.mock('../middleware/output-mode.js', () => ({
+    resolveOutputMode: vi.fn(() => 'auto'),
+}));
+vi.mock('../../state/lock-manager.js', () => ({
+    acquireLock: vi.fn(() => ({ acquired: true })),
+    releaseLock: vi.fn(),
+}));
+vi.mock('../output/context.js', async (importOriginal) => {
+    const original = await importOriginal();
+    return {
+        ...original,
+        createOutputContext: (...args) => {
+            const ctx = original['createOutputContext'](...args);
+            return ctx;
+        },
+    };
+});
+// ---------------------------------------------------------------------------
+// Imports (after mocks)
+// ---------------------------------------------------------------------------
+import { findProjectRoot } from '../middleware/project-root.js';
+import { resolveOutputMode } from '../middleware/output-mode.js';
+import reworkCommand from './rework.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function makeState(steps) {
+    return {
+        'schema-version': 1,
+        'scaffold-version': '2.30.0',
+        init_methodology: 'deep',
+        config_methodology: 'deep',
+        'init-mode': 'greenfield',
+        created: '2026-01-01T00:00:00Z',
+        in_progress: null,
+        steps: Object.fromEntries(Object.entries(steps).map(([k, v]) => [k, {
+                status: v.status,
+                source: v.source ?? 'pipeline',
+                produces: v.produces ?? [],
+            }])),
+        next_eligible: [],
+        'extra-steps': [],
+    };
+}
+function makeReworkSession(overrides = {}) {
+    return {
+        schema_version: 1,
+        created: '2026-03-29T10:00:00Z',
+        config: { phases: [1], depth: null, fix: true, fresh: false, auto: false },
+        steps: [
+            { name: 'create-prd', phase: 1, status: 'pending', completed_at: null, error: null },
+            { name: 'review-prd', phase: 1, status: 'pending', completed_at: null, error: null },
+        ],
+        current_step: null,
+        stats: { total: 2, completed: 0, skipped: 0, failed: 0 },
+        ...overrides,
+    };
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('rework command', () => {
+    let exitSpy;
+    let writtenLines;
+    let tempDir;
+    const mockFindProjectRoot = vi.mocked(findProjectRoot);
+    const mockResolveOutputMode = vi.mocked(resolveOutputMode);
+    beforeEach(() => {
+        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'scaffold-rework-test-'));
+        const scaffoldDir = path.join(tempDir, '.scaffold');
+        fs.mkdirSync(scaffoldDir);
+        writtenLines = [];
+        exitSpy = vi.spyOn(process, 'exit').mockImplementation((() => { }));
+        vi.spyOn(process.stdout, 'write').mockImplementation((chunk) => {
+            writtenLines.push(String(chunk));
+            return true;
+        });
+        vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+        mockFindProjectRoot.mockReturnValue(tempDir);
+        mockResolveOutputMode.mockReturnValue('auto');
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        try {
+            fs.rmSync(tempDir, { recursive: true, force: true });
+        }
+        catch { /* ignore */ }
+    });
+    it('exits 1 when project root not found', async () => {
+        mockFindProjectRoot.mockReturnValue(null);
+        await reworkCommand.handler({
+            auto: true,
+            format: undefined,
+            root: undefined,
+            force: undefined,
+        });
+        expect(exitSpy).toHaveBeenCalledWith(1);
+    });
+    describe('--clear', () => {
+        it('deletes rework.json and exits 0', async () => {
+            const reworkPath = path.join(tempDir, '.scaffold', 'rework.json');
+            fs.writeFileSync(reworkPath, JSON.stringify(makeReworkSession()));
+            await reworkCommand.handler({
+                clear: true,
+                auto: true,
+                format: undefined,
+                root: undefined,
+                force: undefined,
+            });
+            expect(fs.existsSync(reworkPath)).toBe(false);
+            expect(exitSpy).toHaveBeenCalledWith(0);
+        });
+        it('exits 0 even when no session exists', async () => {
+            await reworkCommand.handler({
+                clear: true,
+                auto: true,
+                format: undefined,
+                root: undefined,
+                force: undefined,
+            });
+            expect(exitSpy).toHaveBeenCalledWith(0);
+        });
+    });
+    describe('--advance', () => {
+        it('advances step and outputs JSON result', async () => {
+            const reworkPath = path.join(tempDir, '.scaffold', 'rework.json');
+            const session = makeReworkSession();
+            session.steps[0].status = 'in_progress';
+            session.current_step = 'create-prd';
+            fs.writeFileSync(reworkPath, JSON.stringify(session));
+            mockResolveOutputMode.mockReturnValue('json');
+            await reworkCommand.handler({
+                advance: 'create-prd',
+                auto: true,
+                format: 'json',
+                root: undefined,
+                force: undefined,
+            });
+            expect(exitSpy).toHaveBeenCalledWith(0);
+            // Verify the session was updated
+            const updated = JSON.parse(fs.readFileSync(reworkPath, 'utf8'));
+            expect(updated.steps[0].status).toBe('completed');
+            expect(updated.stats.completed).toBe(1);
+        });
+        it('deletes session and reports completion when all steps done', async () => {
+            const reworkPath = path.join(tempDir, '.scaffold', 'rework.json');
+            const session = makeReworkSession();
+            const steps = session.steps;
+            steps[0].status = 'completed';
+            steps[0].completed_at = '2026-03-29T10:05:00Z';
+            steps[1].status = 'in_progress';
+            session.current_step = 'review-prd';
+            session.stats.completed = 1;
+            fs.writeFileSync(reworkPath, JSON.stringify(session));
+            await reworkCommand.handler({
+                advance: 'review-prd',
+                auto: true,
+                format: undefined,
+                root: undefined,
+                force: undefined,
+            });
+            expect(exitSpy).toHaveBeenCalledWith(0);
+            // Session should be cleaned up
+            expect(fs.existsSync(reworkPath)).toBe(false);
+        });
+    });
+    describe('--resume', () => {
+        it('exits 1 when no session exists', async () => {
+            await reworkCommand.handler({
+                resume: true,
+                auto: true,
+                format: undefined,
+                root: undefined,
+                force: undefined,
+            });
+            expect(exitSpy).toHaveBeenCalledWith(1);
+        });
+        it('outputs session status in json mode', async () => {
+            const reworkPath = path.join(tempDir, '.scaffold', 'rework.json');
+            fs.writeFileSync(reworkPath, JSON.stringify(makeReworkSession()));
+            mockResolveOutputMode.mockReturnValue('json');
+            await reworkCommand.handler({
+                resume: true,
+                auto: true,
+                format: 'json',
+                root: undefined,
+                force: undefined,
+            });
+            expect(exitSpy).toHaveBeenCalledWith(0);
+            const jsonOutput = writtenLines.find(l => l.includes('schema_version'));
+            expect(jsonOutput).toBeDefined();
+        });
+    });
+    describe('new rework', () => {
+        it('creates rework session with --phases and --auto', async () => {
+            // Write state.json with completed steps
+            const statePath = path.join(tempDir, '.scaffold', 'state.json');
+            fs.writeFileSync(statePath, JSON.stringify(makeState({
+                'create-prd': { status: 'completed' },
+                'review-prd': { status: 'completed' },
+            })));
+            // Write a minimal config
+            const configPath = path.join(tempDir, '.scaffold', 'config.yml');
+            fs.writeFileSync(configPath, 'version: 2\nmethodology: deep\nplatforms:\n  - claude-code\n');
+            await reworkCommand.handler({
+                phases: '1',
+                auto: true,
+                format: undefined,
+                root: undefined,
+                force: true,
+            });
+            // Check rework.json was created
+            const reworkPath = path.join(tempDir, '.scaffold', 'rework.json');
+            expect(fs.existsSync(reworkPath)).toBe(true);
+            const session = JSON.parse(fs.readFileSync(reworkPath, 'utf8'));
+            expect(session.config.phases).toEqual([1]);
+            expect(session.steps.length).toBeGreaterThan(0);
+            expect(exitSpy).toHaveBeenCalledWith(0);
+        });
+        it('errors when session exists in auto mode without --force', async () => {
+            const reworkPath = path.join(tempDir, '.scaffold', 'rework.json');
+            fs.writeFileSync(reworkPath, JSON.stringify(makeReworkSession()));
+            const statePath = path.join(tempDir, '.scaffold', 'state.json');
+            fs.writeFileSync(statePath, JSON.stringify(makeState({
+                'create-prd': { status: 'completed' },
+            })));
+            const configPath = path.join(tempDir, '.scaffold', 'config.yml');
+            fs.writeFileSync(configPath, 'version: 2\nmethodology: deep\nplatforms:\n  - claude-code\n');
+            await reworkCommand.handler({
+                phases: '1',
+                auto: true,
+                format: undefined,
+                root: undefined,
+                force: false,
+            });
+            expect(exitSpy).toHaveBeenCalledWith(1);
+        });
+        it('resets selected steps in state.json to pending', async () => {
+            const statePath = path.join(tempDir, '.scaffold', 'state.json');
+            fs.writeFileSync(statePath, JSON.stringify(makeState({
+                'create-prd': { status: 'completed' },
+                'review-prd': { status: 'completed' },
+            })));
+            const configPath = path.join(tempDir, '.scaffold', 'config.yml');
+            fs.writeFileSync(configPath, 'version: 2\nmethodology: deep\nplatforms:\n  - claude-code\n');
+            await reworkCommand.handler({
+                phases: '1',
+                auto: true,
+                format: undefined,
+                root: undefined,
+                force: true,
+            });
+            // Verify steps were reset in state.json
+            const state = JSON.parse(fs.readFileSync(statePath, 'utf8'));
+            for (const stepName of Object.keys(state.steps)) {
+                // All phase-1 steps should be pending
+                expect(state.steps[stepName].status).toBe('pending');
+            }
+            expect(exitSpy).toHaveBeenCalledWith(0);
+        });
+        it('records --fix --fresh --depth in config', async () => {
+            const statePath = path.join(tempDir, '.scaffold', 'state.json');
+            fs.writeFileSync(statePath, JSON.stringify(makeState({
+                'create-prd': { status: 'completed' },
+            })));
+            const configPath = path.join(tempDir, '.scaffold', 'config.yml');
+            fs.writeFileSync(configPath, 'version: 2\nmethodology: deep\nplatforms:\n  - claude-code\n');
+            await reworkCommand.handler({
+                phases: '1',
+                depth: 4,
+                fix: true,
+                fresh: true,
+                auto: true,
+                format: undefined,
+                root: undefined,
+                force: true,
+            });
+            const reworkPath = path.join(tempDir, '.scaffold', 'rework.json');
+            const session = JSON.parse(fs.readFileSync(reworkPath, 'utf8'));
+            expect(session.config.depth).toBe(4);
+            expect(session.config.fix).toBe(true);
+            expect(session.config.fresh).toBe(true);
+            expect(exitSpy).toHaveBeenCalledWith(0);
+        });
+    });
+});
+//# sourceMappingURL=rework.test.js.map