@zigrivers/scaffold 2.1.0

package/dist/validation/index.test.js

@@ -0,0 +1,241 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { describe, it, expect, afterEach } from 'vitest';
+// ---------------------------------------------------------------------------
+// Integration-style tests using real tmp directories
+// ---------------------------------------------------------------------------
+const tmpDirs = [];
+function makeTmpDir() {
+    const d = path.join(os.tmpdir(), `scaffold-validation-test-${crypto.randomUUID()}`);
+    fs.mkdirSync(d, { recursive: true });
+    tmpDirs.push(d);
+    return d;
+}
+function makeProjectRoot(opts = {}) {
+    const root = makeTmpDir();
+    fs.mkdirSync(path.join(root, '.scaffold'), { recursive: true });
+    if (opts.configContent !== undefined && opts.configContent !== null) {
+        fs.writeFileSync(path.join(root, '.scaffold', 'config.yml'), opts.configContent, 'utf8');
+    }
+    if (opts.stateContent !== undefined && opts.stateContent !== null) {
+        fs.writeFileSync(path.join(root, '.scaffold', 'state.json'), opts.stateContent, 'utf8');
+    }
+    if (opts.pipelineFiles !== undefined && opts.pipelineFiles.length > 0) {
+        fs.mkdirSync(path.join(root, 'pipeline'), { recursive: true });
+        for (const f of opts.pipelineFiles) {
+            fs.writeFileSync(path.join(root, 'pipeline', f.name), f.content, 'utf8');
+        }
+    }
+    return root;
+}
+const validConfig = `version: 2
+methodology: mvp
+platforms:
+  - web
+`;
+const validState = JSON.stringify({
+    'schema-version': 1,
+    'scaffold-version': '2.0.0',
+    init_methodology: 'mvp',
+    config_methodology: 'mvp',
+    'init-mode': 'greenfield',
+    created: '2024-01-01T00:00:00.000Z',
+    in_progress: null,
+    steps: {},
+    next_eligible: [],
+    'extra-steps': [],
+});
+const validFrontmatter = (name) => `---
+name: ${name}
+description: A test step
+phase: modeling
+order: 1
+outputs:
+  - output.md
+---
+# Body
+`;
+afterEach(() => {
+    for (const d of tmpDirs.splice(0)) {
+        fs.rmSync(d, { recursive: true, force: true });
+    }
+});
+// ---------------------------------------------------------------------------
+// Import under test (after tmp setup helpers)
+// ---------------------------------------------------------------------------
+import { runValidation } from './index.js';
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('runValidation', () => {
+    // Test 1: Returns no errors for valid config + pipeline
+    it('returns no errors for valid config, state, and pipeline', () => {
+        const root = makeProjectRoot({
+            configContent: validConfig,
+            stateContent: validState,
+            pipelineFiles: [
+                { name: 'my-step.md', content: validFrontmatter('my-step') },
+            ],
+        });
+        const result = runValidation(root);
+        expect(result.errors).toHaveLength(0);
+        expect(result.warnings).toHaveLength(0);
+        expect(result.validFilesCount).toBe(1);
+        expect(result.totalFilesCount).toBe(1);
+    });
+    // Test 2: Returns errors when config.yml is missing
+    it('returns errors when config.yml is missing', () => {
+        const root = makeProjectRoot({
+            // no configContent — no file written
+            stateContent: validState,
+        });
+        const result = runValidation(root, ['config']);
+        expect(result.errors.length).toBeGreaterThan(0);
+        const codes = result.errors.map(e => e.code);
+        expect(codes.some(c => c === 'CONFIG_MISSING')).toBe(true);
+    });
+    // Test 3: Returns errors for invalid frontmatter
+    it('returns errors for invalid frontmatter', () => {
+        const badFrontmatter = `---
+name: INVALID NAME WITH SPACES
+description: Bad step
+phase: modeling
+order: 1
+outputs:
+  - output.md
+---
+`;
+        const root = makeProjectRoot({
+            configContent: validConfig,
+            stateContent: validState,
+            pipelineFiles: [
+                { name: 'bad-step.md', content: badFrontmatter },
+            ],
+        });
+        const result = runValidation(root, ['frontmatter']);
+        expect(result.errors.length).toBeGreaterThan(0);
+    });
+    // Test 4: Returns errors for dependency cycles
+    it('returns errors for dependency cycles', () => {
+        // step-a depends on step-b, step-b depends on step-a = cycle
+        const stepA = `---
+name: step-a
+description: Step A
+phase: modeling
+order: 1
+dependencies:
+  - step-b
+outputs:
+  - a.md
+---
+`;
+        const stepB = `---
+name: step-b
+description: Step B
+phase: modeling
+order: 2
+dependencies:
+  - step-a
+outputs:
+  - b.md
+---
+`;
+        const root = makeProjectRoot({
+            configContent: validConfig,
+            stateContent: validState,
+            pipelineFiles: [
+                { name: 'step-a.md', content: stepA },
+                { name: 'step-b.md', content: stepB },
+            ],
+        });
+        const result = runValidation(root, ['dependencies']);
+        expect(result.errors.length).toBeGreaterThan(0);
+        expect(result.errors.some(e => e.code === 'DEP_CYCLE_DETECTED')).toBe(true);
+    });
+    // Test 5: Accumulates all errors before returning (multiple files with errors)
+    it('accumulates errors from multiple invalid frontmatter files', () => {
+        const badA = `---
+name: INVALID A
+description: Bad
+phase: modeling
+order: 1
+outputs:
+  - out.md
+---
+`;
+        const badB = `---
+name: INVALID B
+description: Bad
+phase: modeling
+order: 2
+outputs:
+  - out.md
+---
+`;
+        const root = makeProjectRoot({
+            configContent: validConfig,
+            stateContent: validState,
+            pipelineFiles: [
+                { name: 'bad-a.md', content: badA },
+                { name: 'bad-b.md', content: badB },
+            ],
+        });
+        const result = runValidation(root, ['frontmatter']);
+        // Should have errors from both files, not short-circuited after first
+        expect(result.errors.length).toBeGreaterThanOrEqual(2);
+    });
+    // Test 6: --scope config only runs config validation
+    it('scope config only runs config validation', () => {
+        // No pipeline dir, no state — should only check config
+        const root = makeProjectRoot({
+            configContent: validConfig,
+            // no state
+        });
+        const result = runValidation(root, ['config']);
+        expect(result.scopes).toEqual(['config']);
+        // No state errors because state scope not included
+        const stateCodes = result.errors.filter(e => e.code.startsWith('STATE_'));
+        expect(stateCodes).toHaveLength(0);
+    });
+    // Test 7: --scope frontmatter only runs frontmatter validation
+    it('scope frontmatter only runs frontmatter validation', () => {
+        const root = makeProjectRoot({
+            // no config — config errors should not appear
+            pipelineFiles: [
+                { name: 'my-step.md', content: validFrontmatter('my-step') },
+            ],
+        });
+        const result = runValidation(root, ['frontmatter']);
+        expect(result.scopes).toEqual(['frontmatter']);
+        // No config errors
+        const configCodes = result.errors.filter(e => e.code.startsWith('CONFIG_'));
+        expect(configCodes).toHaveLength(0);
+    });
+    // Test 8: validFilesCount matches actual valid file count
+    it('validFilesCount counts only valid files', () => {
+        const goodStep = validFrontmatter('good-step');
+        const badStep = `---
+name: BAD STEP
+description: Bad
+phase: modeling
+order: 1
+outputs:
+  - out.md
+---
+`;
+        const root = makeProjectRoot({
+            configContent: validConfig,
+            stateContent: validState,
+            pipelineFiles: [
+                { name: 'good-step.md', content: goodStep },
+                { name: 'bad-step.md', content: badStep },
+            ],
+        });
+        const result = runValidation(root, ['frontmatter']);
+        expect(result.totalFilesCount).toBe(2);
+        expect(result.validFilesCount).toBe(1);
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/validation/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../src/validation/index.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,SAAS,EAAE,MAAM,QAAQ,CAAA;AAExD,8EAA8E;AAC9E,qDAAqD;AACrD,8EAA8E;AAE9E,MAAM,OAAO,GAAa,EAAE,CAAA;AAE5B,SAAS,UAAU;IACjB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,4BAA4B,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;IACnF,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,eAAe,CAAC,OAIrB,EAAE;IACJ,MAAM,IAAI,GAAG,UAAU,EAAE,CAAA;IACzB,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAE/D,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;QACpE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;IAC1F,CAAC;IAED,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;QAClE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAA;IACzF,CAAC;IAED,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC9D,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACnC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QAC1E,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,WAAW,GAAG;;;;CAInB,CAAA;AAED,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC;IAChC,gBAAgB,EAAE,CAAC;IACnB,kBAAkB,EAAE,OAAO;IAC3B,gBAAgB,EAAE,KAAK;IACvB,kBAAkB,EAAE,KAAK;IACzB,WAAW,EAAE,YAAY;IACzB,OAAO,EAAE,0BAA0B;IACnC,WAAW,EAAE,IAAI;IACjB,KAAK,EAAE,EAAE;IACT,aAAa,EAAE,EAAE;IACjB,aAAa,EAAE,EAAE;CAClB,CAAC,CAAA;AAEF,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC;QACnC,IAAI;;;;;;;;CAQX,CAAA;AAED,SAAS,CAAC,GAAG,EAAE;IACb,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAClC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAChD,CAAC;AACH,CAAC,CAAC,CAAA;AAEF,8EAA8E;AAC9E,8CAA8C;AAC9C,8EAA8E;AAE9E,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,wDAAwD;IACxD,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,IAAI,GAAG,eAAe,CAAC;YAC3B,aAAa,EAAE,WAAW;YAC1B,YAAY,EAAE,UAAU;YACxB,aAAa,EAAE;gBACb,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,EAAE;aAC7D;SACF,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;QAClC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACrC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACvC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACtC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,oDAAoD;IACpD,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,IAAI,GAAG,eAAe,CAAC;YAC3B,qCAAqC;YACrC,YAAY,EAAE,UAAU;SACzB,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC9C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAA;QAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAC5C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC5D,CAAC,CAAC,CAAA;IAEF,iDAAiD;IACjD,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,cAAc,GAAG;;;;;;;;CAQ1B,CAAA;QACG,MAAM,IAAI,GAAG,eAAe,CAAC;YAC3B,aAAa,EAAE,WAAW;YAC1B,YAAY,EAAE,UAAU;YACxB,aAAa,EAAE;gBACb,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,EAAE;aACjD;SACF,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,aAAa,CAAC,CAAC,CAAA;QACnD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAA;IACjD,CAAC,CAAC,CAAA;IAEF,+CAA+C;IAC/C,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,6DAA6D;QAC7D,MAAM,KAAK,GAAG;;;;;;;;;;CAUjB,CAAA;QACG,MAAM,KAAK,GAAG;;;;;;;;;;CAUjB,CAAA;QACG,MAAM,IAAI,GAAG,eAAe,CAAC;YAC3B,aAAa,EAAE,WAAW;YAC1B,YAAY,EAAE,UAAU;YACxB,aAAa,EAAE;gBACb,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE;gBACrC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE;aACtC;SACF,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,cAAc,CAAC,CAAC,CAAA;QACpD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAA;QAC/C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC7E,CAAC,CAAC,CAAA;IAEF,+EAA+E;IAC/E,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,IAAI,GAAG;;;;;;;;CAQhB,CAAA;QACG,MAAM,IAAI,GAAG;;;;;;;;CAQhB,CAAA;QACG,MAAM,IAAI,GAAG,eAAe,CAAC;YAC3B,aAAa,EAAE,WAAW;YAC1B,YAAY,EAAE,UAAU;YACxB,aAAa,EAAE;gBACb,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE;gBACnC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE;aACpC;SACF,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,aAAa,CAAC,CAAC,CAAA;QACnD,sEAAsE;QACtE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAA;IACxD,CAAC,CAAC,CAAA;IAEF,qDAAqD;IACrD,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,uDAAuD;QACvD,MAAM,IAAI,GAAG,eAAe,CAAC;YAC3B,aAAa,EAAE,WAAW;YAC1B,WAAW;SACZ,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC9C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;QACzC,mDAAmD;QACnD,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAA;QACzE,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;IAEF,+DAA+D;IAC/D,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,IAAI,GAAG,eAAe,CAAC;YAC3B,8CAA8C;YAC9C,aAAa,EAAE;gBACb,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,EAAE;aAC7D;SACF,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,aAAa,CAAC,CAAC,CAAA;QACnD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAA;QAC9C,mBAAmB;QACnB,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAA;QAC3E,MAAM,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;IAEF,0DAA0D;IAC1D,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAA;QAC9C,MAAM,OAAO,GAAG;;;;;;;;CAQnB,CAAA;QACG,MAAM,IAAI,GAAG,eAAe,CAAC;YAC3B,aAAa,EAAE,WAAW;YAC1B,YAAY,EAAE,UAAU;YACxB,aAAa,EAAE;gBACb,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE;gBAC3C,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE;aAC1C;SACF,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,aAAa,CAAC,CAAC,CAAA;QACnD,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACtC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/validation/state-validator.d.ts

@@ -0,0 +1,15 @@
+import type { ScaffoldError, ScaffoldWarning } from '../types/index.js';
+/**
+ * Validate .scaffold/state.json for the given project root.
+ *
+ * - Returns STATE_MISSING error if file does not exist
+ * - Returns STATE_PARSE_ERROR if file is not valid JSON
+ * - Returns STATE_SCHEMA_VERSION error if schema-version is not 1
+ * - Returns FIELD_INVALID_VALUE errors for steps with invalid status values
+ * - Returns STATE_IN_PROGRESS warning if in_progress is non-null (potential crash)
+ */
+export declare function validateState(projectRoot: string): {
+    errors: ScaffoldError[];
+    warnings: ScaffoldWarning[];
+};
+//# sourceMappingURL=state-validator.d.ts.map

package/dist/validation/state-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-validator.d.ts","sourceRoot":"","sources":["../../src/validation/state-validator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAKvE;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG;IAClD,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,QAAQ,EAAE,eAAe,EAAE,CAAA;CAC5B,CA6FA"}

package/dist/validation/state-validator.js

@@ -0,0 +1,104 @@
+// src/validation/state-validator.ts
+import fs from 'node:fs';
+import path from 'node:path';
+import { ExitCode } from '../types/index.js';
+const VALID_STATUSES = new Set(['pending', 'in_progress', 'completed', 'skipped']);
+/**
+ * Validate .scaffold/state.json for the given project root.
+ *
+ * - Returns STATE_MISSING error if file does not exist
+ * - Returns STATE_PARSE_ERROR if file is not valid JSON
+ * - Returns STATE_SCHEMA_VERSION error if schema-version is not 1
+ * - Returns FIELD_INVALID_VALUE errors for steps with invalid status values
+ * - Returns STATE_IN_PROGRESS warning if in_progress is non-null (potential crash)
+ */
+export function validateState(projectRoot) {
+    const statePath = path.join(projectRoot, '.scaffold', 'state.json');
+    const errors = [];
+    const warnings = [];
+    // Check existence
+    if (!fs.existsSync(statePath)) {
+        errors.push({
+            code: 'STATE_MISSING',
+            message: `Pipeline state not found at ${statePath}`,
+            exitCode: ExitCode.ValidationError,
+            recovery: 'Run "scaffold init" to initialize the pipeline',
+            context: { file: statePath },
+        });
+        return { errors, warnings };
+    }
+    // Read file
+    let raw;
+    try {
+        raw = fs.readFileSync(statePath, 'utf8');
+    }
+    catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        errors.push({
+            code: 'STATE_PARSE_ERROR',
+            message: `Failed to read state.json: ${detail}`,
+            exitCode: ExitCode.StateCorruption,
+            recovery: 'Run "scaffold reset" to reinitialize state',
+            context: { file: statePath, detail },
+        });
+        return { errors, warnings };
+    }
+    // Parse JSON
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        errors.push({
+            code: 'STATE_PARSE_ERROR',
+            message: `Failed to parse state.json: ${detail}`,
+            exitCode: ExitCode.StateCorruption,
+            recovery: 'Run "scaffold reset" to reinitialize state',
+            context: { file: statePath, detail },
+        });
+        return { errors, warnings };
+    }
+    // Check schema version
+    const schemaVersion = parsed['schema-version'];
+    if (schemaVersion !== 1) {
+        errors.push({
+            code: 'STATE_SCHEMA_VERSION',
+            message: `state.json schema version ${String(schemaVersion)} is not supported (expected 1)`,
+            exitCode: ExitCode.StateCorruption,
+            recovery: 'Run "scaffold reset" to reinitialize state, or upgrade scaffold',
+            context: { file: statePath, expected: 1, actual: schemaVersion },
+        });
+        return { errors, warnings };
+    }
+    // Validate step statuses
+    const steps = parsed['steps'];
+    if (steps !== null && steps !== undefined && typeof steps === 'object' && !Array.isArray(steps)) {
+        for (const [slug, entry] of Object.entries(steps)) {
+            const stepEntry = entry;
+            const status = stepEntry['status'];
+            if (typeof status === 'string' && !VALID_STATUSES.has(status)) {
+                errors.push({
+                    code: 'FIELD_INVALID_VALUE',
+                    message: `Step "${slug}" has invalid status "${status}"`,
+                    exitCode: ExitCode.ValidationError,
+                    recovery: `Valid statuses: ${[...VALID_STATUSES].join(', ')}`,
+                    context: { file: statePath, field: `steps.${slug}.status`, value: status },
+                });
+            }
+        }
+    }
+    // Warn if in_progress is non-null (potential crash recovery needed)
+    const inProgress = parsed['in_progress'];
+    if (inProgress !== null && inProgress !== undefined) {
+        const inProgressRecord = inProgress;
+        const step = typeof inProgressRecord['step'] === 'string' ? inProgressRecord['step'] : 'unknown';
+        warnings.push({
+            code: 'STATE_IN_PROGRESS',
+            message: `Step "${step}" is marked in_progress — this may indicate a previous crash`,
+            context: { file: statePath, step },
+        });
+    }
+    return { errors, warnings };
+}
+//# sourceMappingURL=state-validator.js.map

package/dist/validation/state-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-validator.js","sourceRoot":"","sources":["../../src/validation/state-validator.ts"],"names":[],"mappings":"AAAA,oCAAoC;AAEpC,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAE5C,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC,CAAA;AAElF;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB;IAI/C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,CAAC,CAAA;IACnE,MAAM,MAAM,GAAoB,EAAE,CAAA;IAClC,MAAM,QAAQ,GAAsB,EAAE,CAAA;IAEtC,kBAAkB;IAClB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,+BAA+B,SAAS,EAAE;YACnD,QAAQ,EAAE,QAAQ,CAAC,eAAe;YAClC,QAAQ,EAAE,gDAAgD;YAC1D,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;SAC7B,CAAC,CAAA;QACF,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;IAC7B,CAAC;IAED,YAAY;IACZ,IAAI,GAAW,CAAA;IACf,IAAI,CAAC;QACH,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;IAC1C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAC/D,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,8BAA8B,MAAM,EAAE;YAC/C,QAAQ,EAAE,QAAQ,CAAC,eAAe;YAClC,QAAQ,EAAE,4CAA4C;YACtD,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE;SACrC,CAAC,CAAA;QACF,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;IAC7B,CAAC;IAED,aAAa;IACb,IAAI,MAA+B,CAAA;IACnC,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAA;IACrD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAC/D,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,+BAA+B,MAAM,EAAE;YAChD,QAAQ,EAAE,QAAQ,CAAC,eAAe;YAClC,QAAQ,EAAE,4CAA4C;YACtD,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE;SACrC,CAAC,CAAA;QACF,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;IAC7B,CAAC;IAED,uBAAuB;IACvB,MAAM,aAAa,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAA;IAC9C,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EAAE,6BAA6B,MAAM,CAAC,aAAa,CAAC,gCAAgC;YAC3F,QAAQ,EAAE,QAAQ,CAAC,eAAe;YAClC,QAAQ,EAAE,iEAAiE;YAC3E,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,aAAuB,EAAE;SAC3E,CAAC,CAAA;QACF,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;IAC7B,CAAC;IAED,yBAAyB;IACzB,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;IAC7B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChG,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;YAC7E,MAAM,SAAS,GAAG,KAAgC,CAAA;YAClD,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;YAClC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9D,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,qBAAqB;oBAC3B,OAAO,EAAE,SAAS,IAAI,yBAAyB,MAAM,GAAG;oBACxD,QAAQ,EAAE,QAAQ,CAAC,eAAe;oBAClC,QAAQ,EAAE,mBAAmB,CAAC,GAAG,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBAC7D,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,IAAI,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE;iBAC3E,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,oEAAoE;IACpE,MAAM,UAAU,GAAG,MAAM,CAAC,aAAa,CAAC,CAAA;IACxC,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QACpD,MAAM,gBAAgB,GAAG,UAAqC,CAAA;QAC9D,MAAM,IAAI,GAAG,OAAO,gBAAgB,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QAChG,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,SAAS,IAAI,8DAA8D;YACpF,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;SACnC,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;AAC7B,CAAC"}

package/dist/wizard/questions.d.ts

@@ -0,0 +1,18 @@
+import type { OutputContext } from '../cli/output/context.js';
+export interface WizardAnswers {
+    methodology: 'deep' | 'mvp' | 'custom';
+    depth: 1 | 2 | 3 | 4 | 5;
+    platforms: string[];
+    traits: string[];
+}
+/**
+ * Ask user the wizard questions interactively.
+ * In auto mode, use defaults immediately.
+ */
+export declare function askWizardQuestions(options: {
+    output: OutputContext;
+    suggestion: 'deep' | 'mvp';
+    methodology?: string;
+    auto: boolean;
+}): Promise<WizardAnswers>;
+//# sourceMappingURL=questions.d.ts.map

package/dist/wizard/questions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"questions.d.ts","sourceRoot":"","sources":["../../src/wizard/questions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAE7D,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAA;IACtC,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACxB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IAChD,MAAM,EAAE,aAAa,CAAA;IACrB,UAAU,EAAE,MAAM,GAAG,KAAK,CAAA;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,OAAO,CAAA;CACd,GAAG,OAAO,CAAC,aAAa,CAAC,CA2CzB"}

package/dist/wizard/questions.js

@@ -0,0 +1,46 @@
+/**
+ * Ask user the wizard questions interactively.
+ * In auto mode, use defaults immediately.
+ */
+export async function askWizardQuestions(options) {
+    const { output, suggestion, auto } = options;
+    // Methodology question (skip if --methodology was provided)
+    let methodology = suggestion;
+    if (options.methodology) {
+        methodology = options.methodology;
+    }
+    else if (!auto) {
+        // In interactive mode, ask via OutputContext.prompt
+        const answer = await output.prompt(`Select methodology (deep/mvp/custom) [${suggestion}]:`, suggestion);
+        if (['deep', 'mvp', 'custom'].includes(answer)) {
+            methodology = answer;
+        }
+    }
+    // Depth question (only for custom methodology)
+    let depth = methodology === 'mvp' ? 1 : methodology === 'deep' ? 5 : 3;
+    if (methodology === 'custom' && !auto) {
+        const depthStr = await output.prompt('Depth (1-5) [3]:', '3');
+        const parsed = parseInt(depthStr);
+        if (parsed >= 1 && parsed <= 5)
+            depth = parsed;
+    }
+    // Platform selection (simplified — claude-code always included)
+    const platforms = ['claude-code'];
+    if (!auto) {
+        const addCodex = await output.confirm('Include Codex adapter?', false);
+        if (addCodex)
+            platforms.push('codex');
+    }
+    // Traits (web/mobile/desktop)
+    const traits = [];
+    if (!auto) {
+        const isWeb = await output.confirm('Is this a web application?', false);
+        if (isWeb)
+            traits.push('web');
+        const isMobile = await output.confirm('Is this a mobile application?', false);
+        if (isMobile)
+            traits.push('mobile');
+    }
+    return { methodology, depth, platforms, traits };
+}
+//# sourceMappingURL=questions.js.map

package/dist/wizard/questions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"questions.js","sourceRoot":"","sources":["../../src/wizard/questions.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAKxC;IACC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,OAAO,CAAA;IAE5C,4DAA4D;IAC5D,IAAI,WAAW,GAA8B,UAA4B,CAAA;IACzE,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,WAAW,GAAG,OAAO,CAAC,WAAwC,CAAA;IAChE,CAAC;SAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACjB,oDAAoD;QACpD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAChC,yCAAyC,UAAU,IAAI,EACvD,UAAU,CACX,CAAA;QACD,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/C,WAAW,GAAG,MAAmC,CAAA;QACnD,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,IAAI,KAAK,GAAsB,WAAW,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACzF,IAAI,WAAW,KAAK,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,MAAM,CAAS,kBAAkB,EAAE,GAAG,CAAC,CAAA;QACrE,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAA;QACjC,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC;YAAE,KAAK,GAAG,MAA2B,CAAA;IACrE,CAAC;IAED,gEAAgE;IAChE,MAAM,SAAS,GAAG,CAAC,aAAa,CAAC,CAAA;IACjC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAA;QACtE,IAAI,QAAQ;YAAE,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACvC,CAAC;IAED,8BAA8B;IAC9B,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAA;QACvE,IAAI,KAAK;YAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC7B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAA;QAC7E,IAAI,QAAQ;YAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACrC,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,CAAA;AAClD,CAAC"}

package/dist/wizard/suggestion.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Suggest a methodology based on project keywords and signals.
+ * Returns 'mvp' for prototype/quick projects, 'deep' for complex ones.
+ */
+export declare function suggestMethodology(options: {
+    idea?: string;
+    mode: 'greenfield' | 'brownfield' | 'v1-migration';
+    sourceFileCount?: number;
+}): 'deep' | 'mvp';
+//# sourceMappingURL=suggestion.d.ts.map

package/dist/wizard/suggestion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestion.d.ts","sourceRoot":"","sources":["../../src/wizard/suggestion.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,YAAY,GAAG,YAAY,GAAG,cAAc,CAAA;IAClD,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,GAAG,MAAM,GAAG,KAAK,CAYjB"}

package/dist/wizard/suggestion.js

@@ -0,0 +1,17 @@
+/**
+ * Suggest a methodology based on project keywords and signals.
+ * Returns 'mvp' for prototype/quick projects, 'deep' for complex ones.
+ */
+export function suggestMethodology(options) {
+    const { idea = '', mode, sourceFileCount = 0 } = options;
+    // MVP signals in the idea text
+    const mvpKeywords = ['prototype', 'mvp', 'quick', 'hack', 'simple', 'basic', 'minimal', 'poc'];
+    if (mvpKeywords.some(k => idea.toLowerCase().includes(k)))
+        return 'mvp';
+    // Large existing codebase → deep
+    if (mode === 'brownfield' && sourceFileCount > 10)
+        return 'deep';
+    // Default: deep
+    return 'deep';
+}
+//# sourceMappingURL=suggestion.js.map

package/dist/wizard/suggestion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestion.js","sourceRoot":"","sources":["../../src/wizard/suggestion.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAIlC;IACC,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,IAAI,EAAE,eAAe,GAAG,CAAC,EAAE,GAAG,OAAO,CAAA;IAExD,+BAA+B;IAC/B,MAAM,WAAW,GAAG,CAAC,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAA;IAC9F,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAA;IAEvE,iCAAiC;IACjC,IAAI,IAAI,KAAK,YAAY,IAAI,eAAe,GAAG,EAAE;QAAE,OAAO,MAAM,CAAA;IAEhE,gBAAgB;IAChB,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/wizard/wizard.d.ts

@@ -0,0 +1,19 @@
+import type { ScaffoldError } from '../types/index.js';
+import type { OutputContext } from '../cli/output/context.js';
+export interface WizardOptions {
+    projectRoot: string;
+    idea?: string;
+    methodology?: string;
+    force: boolean;
+    auto: boolean;
+    output: OutputContext;
+}
+export interface WizardResult {
+    success: boolean;
+    projectRoot: string;
+    configPath: string;
+    methodology: string;
+    errors: ScaffoldError[];
+}
+export declare function runWizard(options: WizardOptions): Promise<WizardResult>;
+//# sourceMappingURL=wizard.d.ts.map

package/dist/wizard/wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.d.ts","sourceRoot":"","sources":["../../src/wizard/wizard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAW7D,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,OAAO,CAAA;IACd,IAAI,EAAE,OAAO,CAAA;IACb,MAAM,EAAE,aAAa,CAAA;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,aAAa,EAAE,CAAA;CACxB;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CA2G7E"}

package/dist/wizard/wizard.js

@@ -0,0 +1,104 @@
+import { detectProjectMode } from '../project/detector.js';
+import { suggestMethodology } from './suggestion.js';
+import { askWizardQuestions } from './questions.js';
+import { StateManager } from '../state/state-manager.js';
+import { discoverMetaPrompts } from '../core/assembly/meta-prompt-loader.js';
+import { atomicWriteFile, ensureDir } from '../utils/fs.js';
+import yaml from 'js-yaml';
+import fs from 'node:fs';
+import path from 'node:path';
+export async function runWizard(options) {
+    const { projectRoot, idea, methodology: presetMethodology, force, auto, output } = options;
+    const scaffoldDir = path.join(projectRoot, '.scaffold');
+    // Check for existing .scaffold/
+    if (fs.existsSync(scaffoldDir) && !force) {
+        return {
+            success: false,
+            projectRoot,
+            configPath: path.join(scaffoldDir, 'config.yml'),
+            methodology: 'unknown',
+            errors: [
+                {
+                    code: 'INIT_SCAFFOLD_EXISTS',
+                    message: '.scaffold/ directory already exists',
+                    exitCode: 1,
+                    recovery: 'Use --force to back up and reinitialize',
+                },
+            ],
+        };
+    }
+    // Backup existing .scaffold/ if --force
+    if (fs.existsSync(scaffoldDir) && force) {
+        const backupPath = path.join(projectRoot, '.scaffold.backup');
+        const finalBackup = fs.existsSync(backupPath)
+            ? `${backupPath}.${Date.now()}`
+            : backupPath;
+        fs.renameSync(scaffoldDir, finalBackup);
+        output.info(`Backed up existing .scaffold/ to ${path.basename(finalBackup)}`);
+    }
+    // Detect project
+    const detection = detectProjectMode(projectRoot);
+    // Compute methodology suggestion
+    const suggestion = suggestMethodology({
+        idea,
+        mode: detection.mode,
+    });
+    // Ask questions
+    const answers = await askWizardQuestions({
+        output,
+        suggestion,
+        methodology: presetMethodology,
+        auto,
+    });
+    // Build config — methodology is a top-level string per the real ScaffoldConfig schema
+    const config = {
+        version: 2,
+        methodology: answers.methodology,
+        platforms: answers.platforms,
+        project: {
+            traits: answers.traits,
+        },
+    };
+    // For custom methodology, store depth in custom.default_depth
+    if (answers.methodology === 'custom') {
+        config.custom = { default_depth: answers.depth };
+    }
+    // Write .scaffold/ directory structure
+    ensureDir(scaffoldDir);
+    ensureDir(path.join(scaffoldDir, 'instructions'));
+    // Write config.yml
+    const configPath = path.join(scaffoldDir, 'config.yml');
+    atomicWriteFile(configPath, yaml.dump(config));
+    // Initialize state.json via StateManager
+    const pipelineDir = path.join(projectRoot, 'pipeline');
+    const metaPrompts = discoverMetaPrompts(pipelineDir);
+    const allSteps = [...metaPrompts.entries()].map(([slug, mp]) => ({
+        slug,
+        produces: mp.frontmatter.outputs ?? [],
+    }));
+    const stateManager = new StateManager(projectRoot, () => []);
+    stateManager.initializeState({
+        enabledSteps: allSteps,
+        scaffoldVersion: '2.0.0',
+        methodology: answers.methodology,
+        initMode: detection.mode === 'v1-migration'
+            ? 'v1-migration'
+            : detection.mode === 'brownfield'
+                ? 'brownfield'
+                : 'greenfield',
+    });
+    // Write empty decisions.jsonl
+    const decisionsPath = path.join(scaffoldDir, 'decisions.jsonl');
+    if (!fs.existsSync(decisionsPath)) {
+        fs.writeFileSync(decisionsPath, '', 'utf8');
+    }
+    output.success(`Initialized scaffold project (${answers.methodology}, depth ${answers.depth})`);
+    return {
+        success: true,
+        projectRoot,
+        configPath,
+        methodology: answers.methodology,
+        errors: [],
+    };
+}
+//# sourceMappingURL=wizard.js.map

package/dist/wizard/wizard.js.map

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

package/dist/wizard/wizard.test.d.ts

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

package/dist/wizard/wizard.test.d.ts.map

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