@zigrivers/scaffold 2.28.1 → 2.38.1

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

@@ -0,0 +1,325 @@
+// src/validation/state-validator.test.ts
+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';
+import { validateState } from './state-validator.js';
+import { ExitCode } from '../types/index.js';
+// ---------------------------------------------------------------------------
+// Tmp directory management
+// ---------------------------------------------------------------------------
+const tmpDirs = [];
+function makeTmpDir() {
+    const d = path.join(os.tmpdir(), `scaffold-state-test-${crypto.randomUUID()}`);
+    fs.mkdirSync(d, { recursive: true });
+    tmpDirs.push(d);
+    return d;
+}
+function makeProjectRoot(stateContent) {
+    const root = makeTmpDir();
+    fs.mkdirSync(path.join(root, '.scaffold'), { recursive: true });
+    if (stateContent !== undefined && stateContent !== null) {
+        fs.writeFileSync(path.join(root, '.scaffold', 'state.json'), stateContent, 'utf8');
+    }
+    return root;
+}
+afterEach(() => {
+    for (const d of tmpDirs.splice(0)) {
+        fs.rmSync(d, { recursive: true, force: true });
+    }
+});
+// ---------------------------------------------------------------------------
+// Valid state fixture
+// ---------------------------------------------------------------------------
+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': [],
+});
+function makeState(overrides = {}) {
+    const base = JSON.parse(validState);
+    return JSON.stringify({ ...base, ...overrides });
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('validateState', () => {
+    // ---- Valid inputs ----
+    describe('valid inputs', () => {
+        it('returns no errors for a valid state file', () => {
+            const root = makeProjectRoot(validState);
+            const result = validateState(root);
+            expect(result.errors).toHaveLength(0);
+            expect(result.warnings).toHaveLength(0);
+        });
+        it('returns no errors for valid state with completed steps', () => {
+            const state = makeState({
+                steps: {
+                    'create-prd': { status: 'completed', completedAt: '2024-01-01' },
+                    'design-system': { status: 'pending' },
+                    'code-review': { status: 'skipped' },
+                },
+            });
+            const root = makeProjectRoot(state);
+            const result = validateState(root);
+            expect(result.errors).toHaveLength(0);
+        });
+        it('accepts all valid status values', () => {
+            const state = makeState({
+                steps: {
+                    'step-pending': { status: 'pending' },
+                    'step-in-progress': { status: 'in_progress' },
+                    'step-completed': { status: 'completed' },
+                    'step-skipped': { status: 'skipped' },
+                },
+            });
+            const root = makeProjectRoot(state);
+            const result = validateState(root);
+            expect(result.errors).toHaveLength(0);
+        });
+    });
+    // ---- Missing state file ----
+    describe('missing state file', () => {
+        it('returns STATE_MISSING error when state.json does not exist', () => {
+            const root = makeProjectRoot(); // no state file written
+            const result = validateState(root);
+            expect(result.errors).toHaveLength(1);
+            expect(result.errors[0].code).toBe('STATE_MISSING');
+            expect(result.errors[0].exitCode).toBe(ExitCode.ValidationError);
+            expect(result.errors[0].recovery).toContain('scaffold init');
+        });
+        it('returns STATE_MISSING with correct file path in context', () => {
+            const root = makeProjectRoot();
+            const result = validateState(root);
+            const expectedPath = path.join(root, '.scaffold', 'state.json');
+            expect(result.errors[0].context?.file).toBe(expectedPath);
+        });
+        it('short-circuits after STATE_MISSING (no further validation)', () => {
+            const root = makeProjectRoot();
+            const result = validateState(root);
+            expect(result.errors).toHaveLength(1); // Only the one error
+            expect(result.warnings).toHaveLength(0);
+        });
+    });
+    // ---- Parse errors ----
+    describe('parse errors', () => {
+        it('returns STATE_PARSE_ERROR for invalid JSON', () => {
+            const root = makeProjectRoot('{ not valid json }}}');
+            const result = validateState(root);
+            expect(result.errors).toHaveLength(1);
+            expect(result.errors[0].code).toBe('STATE_PARSE_ERROR');
+            expect(result.errors[0].exitCode).toBe(ExitCode.StateCorruption);
+        });
+        it('returns STATE_PARSE_ERROR for empty string content', () => {
+            const root = makeProjectRoot('');
+            const result = validateState(root);
+            expect(result.errors).toHaveLength(1);
+            expect(result.errors[0].code).toBe('STATE_PARSE_ERROR');
+        });
+        it('short-circuits after parse error (no further validation)', () => {
+            const root = makeProjectRoot('not json at all');
+            const result = validateState(root);
+            expect(result.errors).toHaveLength(1);
+            expect(result.warnings).toHaveLength(0);
+        });
+    });
+    // ---- Schema version validation ----
+    describe('schema version validation', () => {
+        it('returns STATE_SCHEMA_VERSION error when version is not 1', () => {
+            const state = makeState({ 'schema-version': 2 });
+            const root = makeProjectRoot(state);
+            const result = validateState(root);
+            expect(result.errors).toHaveLength(1);
+            expect(result.errors[0].code).toBe('STATE_SCHEMA_VERSION');
+            expect(result.errors[0].exitCode).toBe(ExitCode.StateCorruption);
+        });
+        it('returns STATE_SCHEMA_VERSION for version 0', () => {
+            const state = makeState({ 'schema-version': 0 });
+            const root = makeProjectRoot(state);
+            const result = validateState(root);
+            expect(result.errors[0].code).toBe('STATE_SCHEMA_VERSION');
+        });
+        it('returns STATE_SCHEMA_VERSION when schema-version is missing (undefined)', () => {
+            const base = JSON.parse(validState);
+            delete base['schema-version'];
+            const root = makeProjectRoot(JSON.stringify(base));
+            const result = validateState(root);
+            expect(result.errors).toHaveLength(1);
+            expect(result.errors[0].code).toBe('STATE_SCHEMA_VERSION');
+        });
+        it('returns STATE_SCHEMA_VERSION when schema-version is a string', () => {
+            const state = makeState({ 'schema-version': '1' });
+            const root = makeProjectRoot(state);
+            const result = validateState(root);
+            expect(result.errors).toHaveLength(1);
+            expect(result.errors[0].code).toBe('STATE_SCHEMA_VERSION');
+        });
+        it('short-circuits after schema version error', () => {
+            const state = makeState({ 'schema-version': 99 });
+            const root = makeProjectRoot(state);
+            const result = validateState(root);
+            expect(result.errors).toHaveLength(1);
+        });
+    });
+    // ---- Invalid step statuses ----
+    describe('invalid step statuses', () => {
+        it('returns FIELD_INVALID_VALUE for step with invalid status', () => {
+            const state = makeState({
+                steps: {
+                    'bad-step': { status: 'unknown-status' },
+                },
+            });
+            const root = makeProjectRoot(state);
+            const result = validateState(root);
+            expect(result.errors).toHaveLength(1);
+            expect(result.errors[0].code).toBe('FIELD_INVALID_VALUE');
+            expect(result.errors[0].message).toContain('bad-step');
+            expect(result.errors[0].message).toContain('unknown-status');
+            expect(result.errors[0].exitCode).toBe(ExitCode.ValidationError);
+        });
+        it('returns errors for multiple steps with invalid statuses', () => {
+            const state = makeState({
+                steps: {
+                    'step-a': { status: 'invalid-a' },
+                    'step-b': { status: 'invalid-b' },
+                    'step-c': { status: 'completed' }, // valid
+                },
+            });
+            const root = makeProjectRoot(state);
+            const result = validateState(root);
+            expect(result.errors).toHaveLength(2); // Only two invalid ones
+        });
+        it('includes recovery hint listing valid statuses', () => {
+            const state = makeState({
+                steps: {
+                    'bad-step': { status: 'garbage' },
+                },
+            });
+            const root = makeProjectRoot(state);
+            const result = validateState(root);
+            expect(result.errors[0].recovery).toContain('pending');
+            expect(result.errors[0].recovery).toContain('completed');
+            expect(result.errors[0].recovery).toContain('skipped');
+            expect(result.errors[0].recovery).toContain('in_progress');
+        });
+        it('includes context with field path and value', () => {
+            const state = makeState({
+                steps: {
+                    'my-step': { status: 'bad-value' },
+                },
+            });
+            const root = makeProjectRoot(state);
+            const result = validateState(root);
+            expect(result.errors[0].context?.field).toBe('steps.my-step.status');
+            expect(result.errors[0].context?.value).toBe('bad-value');
+        });
+    });
+    // ---- in_progress warning ----
+    describe('in_progress warning', () => {
+        it('warns when in_progress is non-null', () => {
+            const state = makeState({
+                in_progress: { step: 'create-prd', started: '2024-01-01' },
+            });
+            const root = makeProjectRoot(state);
+            const result = validateState(root);
+            expect(result.errors).toHaveLength(0);
+            expect(result.warnings).toHaveLength(1);
+            expect(result.warnings[0].code).toBe('STATE_IN_PROGRESS');
+            expect(result.warnings[0].message).toContain('create-prd');
+        });
+        it('does not warn when in_progress is null', () => {
+            const state = makeState({ in_progress: null });
+            const root = makeProjectRoot(state);
+            const result = validateState(root);
+            expect(result.warnings).toHaveLength(0);
+        });
+        it('uses "unknown" when in_progress.step is not a string', () => {
+            const state = makeState({
+                in_progress: { started: '2024-01-01' }, // no step field
+            });
+            const root = makeProjectRoot(state);
+            const result = validateState(root);
+            expect(result.warnings).toHaveLength(1);
+            expect(result.warnings[0].message).toContain('unknown');
+        });
+        it('includes context with file and step', () => {
+            const state = makeState({
+                in_progress: { step: 'my-step' },
+            });
+            const root = makeProjectRoot(state);
+            const result = validateState(root);
+            expect(result.warnings[0].context?.step).toBe('my-step');
+            expect(result.warnings[0].context?.file).toBeDefined();
+        });
+    });
+    // ---- Edge cases for steps field ----
+    describe('steps field edge cases', () => {
+        it('handles steps being null gracefully', () => {
+            const state = makeState({ steps: null });
+            const root = makeProjectRoot(state);
+            const result = validateState(root);
+            // null is not an object, so the steps validation loop is skipped
+            expect(result.errors).toHaveLength(0);
+        });
+        it('handles steps being undefined (missing) gracefully', () => {
+            const base = JSON.parse(validState);
+            delete base['steps'];
+            const root = makeProjectRoot(JSON.stringify(base));
+            const result = validateState(root);
+            // undefined steps should not cause errors
+            expect(result.errors).toHaveLength(0);
+        });
+        it('handles steps being an array gracefully (skips validation)', () => {
+            const state = makeState({ steps: ['a', 'b'] });
+            const root = makeProjectRoot(state);
+            const result = validateState(root);
+            // Array is filtered out by the typeof check
+            expect(result.errors).toHaveLength(0);
+        });
+        it('handles empty steps object with no errors', () => {
+            const state = makeState({ steps: {} });
+            const root = makeProjectRoot(state);
+            const result = validateState(root);
+            expect(result.errors).toHaveLength(0);
+        });
+        it('skips steps where status is not a string', () => {
+            const state = makeState({
+                steps: {
+                    'numeric-status': { status: 42 },
+                    'null-status': { status: null },
+                    'valid-step': { status: 'completed' },
+                },
+            });
+            const root = makeProjectRoot(state);
+            const result = validateState(root);
+            // Non-string statuses are ignored by the typeof === 'string' check
+            expect(result.errors).toHaveLength(0);
+        });
+    });
+    // ---- Return type shape ----
+    describe('return type', () => {
+        it('always returns errors and warnings arrays (never undefined)', () => {
+            const root = makeProjectRoot(validState);
+            const result = validateState(root);
+            expect(Array.isArray(result.errors)).toBe(true);
+            expect(Array.isArray(result.warnings)).toBe(true);
+        });
+    });
+    // ---- Nonexistent project root ----
+    describe('nonexistent project root', () => {
+        it('returns STATE_MISSING for nonexistent root directory', () => {
+            const result = validateState('/nonexistent/path/that/does/not/exist');
+            expect(result.errors).toHaveLength(1);
+            expect(result.errors[0].code).toBe('STATE_MISSING');
+        });
+    });
+});
+//# sourceMappingURL=state-validator.test.js.map

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

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

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

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

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

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

package/dist/wizard/suggestion.test.js

@@ -0,0 +1,115 @@
+import { describe, it, expect } from 'vitest';
+import { suggestMethodology } from './suggestion.js';
+describe('suggestMethodology', () => {
+    // -----------------------------------------------------------------------
+    // MVP keyword detection
+    // -----------------------------------------------------------------------
+    describe('MVP keyword signals in idea text', () => {
+        const mvpKeywords = ['prototype', 'mvp', 'quick', 'hack', 'simple', 'basic', 'minimal', 'poc'];
+        for (const keyword of mvpKeywords) {
+            it(`returns 'mvp' when idea contains "${keyword}"`, () => {
+                expect(suggestMethodology({ idea: `Build a ${keyword} app`, mode: 'greenfield' })).toBe('mvp');
+            });
+        }
+        it('returns \'mvp\' when keyword is uppercase (case-insensitive)', () => {
+            expect(suggestMethodology({ idea: 'Build a PROTOTYPE dashboard', mode: 'greenfield' })).toBe('mvp');
+        });
+        it('returns \'mvp\' when keyword is mixed case', () => {
+            expect(suggestMethodology({ idea: 'Quick MVP for demo', mode: 'greenfield' })).toBe('mvp');
+        });
+        it('returns \'mvp\' when keyword is embedded in a longer word', () => {
+            // 'simple' is embedded in 'simplest'
+            expect(suggestMethodology({ idea: 'The simplest possible API', mode: 'greenfield' })).toBe('mvp');
+        });
+        it('returns \'mvp\' for MVP keyword even in brownfield mode', () => {
+            expect(suggestMethodology({
+                idea: 'quick fix for legacy code',
+                mode: 'brownfield',
+                sourceFileCount: 100,
+            })).toBe('mvp');
+        });
+        it('returns \'mvp\' for MVP keyword even in v1-migration mode', () => {
+            expect(suggestMethodology({ idea: 'minimal migration script', mode: 'v1-migration' })).toBe('mvp');
+        });
+    });
+    // -----------------------------------------------------------------------
+    // Brownfield + large codebase → deep
+    // -----------------------------------------------------------------------
+    describe('brownfield mode with large codebase', () => {
+        it('returns \'deep\' when brownfield and sourceFileCount > 10', () => {
+            expect(suggestMethodology({ mode: 'brownfield', sourceFileCount: 11 })).toBe('deep');
+        });
+        it('returns \'deep\' when brownfield and sourceFileCount is very large', () => {
+            expect(suggestMethodology({ mode: 'brownfield', sourceFileCount: 500 })).toBe('deep');
+        });
+        it('returns \'deep\' (default) when brownfield and sourceFileCount is exactly 10', () => {
+            // sourceFileCount > 10 is the condition — 10 does NOT trigger the brownfield branch
+            const result = suggestMethodology({ mode: 'brownfield', sourceFileCount: 10 });
+            expect(result).toBe('deep');
+        });
+        it('returns \'deep\' (default) when brownfield and sourceFileCount is small', () => {
+            // Falls through to the default, not the brownfield branch
+            expect(suggestMethodology({ mode: 'brownfield', sourceFileCount: 3 })).toBe('deep');
+        });
+        it('returns \'deep\' (default) when brownfield and sourceFileCount is 0', () => {
+            expect(suggestMethodology({ mode: 'brownfield', sourceFileCount: 0 })).toBe('deep');
+        });
+    });
+    // -----------------------------------------------------------------------
+    // Default behavior → deep
+    // -----------------------------------------------------------------------
+    describe('default behavior', () => {
+        it('returns \'deep\' for greenfield with no idea', () => {
+            expect(suggestMethodology({ mode: 'greenfield' })).toBe('deep');
+        });
+        it('returns \'deep\' for greenfield with non-MVP idea', () => {
+            expect(suggestMethodology({ idea: 'Build an enterprise platform', mode: 'greenfield' })).toBe('deep');
+        });
+        it('returns \'deep\' for v1-migration with no idea', () => {
+            expect(suggestMethodology({ mode: 'v1-migration' })).toBe('deep');
+        });
+        it('returns \'deep\' for v1-migration with non-MVP idea', () => {
+            expect(suggestMethodology({
+                idea: 'Migrate the entire authentication system',
+                mode: 'v1-migration',
+            })).toBe('deep');
+        });
+    });
+    // -----------------------------------------------------------------------
+    // Edge cases
+    // -----------------------------------------------------------------------
+    describe('edge cases', () => {
+        it('returns \'deep\' when idea is an empty string', () => {
+            expect(suggestMethodology({ idea: '', mode: 'greenfield' })).toBe('deep');
+        });
+        it('returns \'deep\' when idea is undefined (omitted)', () => {
+            expect(suggestMethodology({ mode: 'greenfield' })).toBe('deep');
+        });
+        it('returns \'deep\' when sourceFileCount is undefined (omitted)', () => {
+            expect(suggestMethodology({ mode: 'brownfield' })).toBe('deep');
+        });
+        it('MVP keywords take priority over brownfield + large codebase', () => {
+            // keyword check runs first, so even with brownfield + large codebase,
+            // an MVP keyword in the idea should return 'mvp'
+            expect(suggestMethodology({
+                idea: 'prototype integration test',
+                mode: 'brownfield',
+                sourceFileCount: 200,
+            })).toBe('mvp');
+        });
+        it('returns \'deep\' with all options explicitly provided but no MVP keywords', () => {
+            expect(suggestMethodology({
+                idea: 'Full-featured dashboard with analytics',
+                mode: 'greenfield',
+                sourceFileCount: 0,
+            })).toBe('deep');
+        });
+        it('returns \'deep\' when idea contains only whitespace', () => {
+            expect(suggestMethodology({ idea: '   ', mode: 'greenfield' })).toBe('deep');
+        });
+        it('returns \'mvp\' when idea has keyword surrounded by punctuation', () => {
+            expect(suggestMethodology({ idea: '(mvp)', mode: 'greenfield' })).toBe('mvp');
+        });
+    });
+});
+//# sourceMappingURL=suggestion.test.js.map

package/dist/wizard/suggestion.test.js.map

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

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

@@ -1 +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"}
+{"version":3,"file":"wizard.d.ts","sourceRoot":"","sources":["../../src/wizard/wizard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAY7D,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,CA4I7E"}

package/dist/wizard/wizard.js

@@ -2,6 +2,7 @@ import { detectProjectMode } from '../project/detector.js';
 import { suggestMethodology } from './suggestion.js';
 import { askWizardQuestions } from './questions.js';
 import { StateManager } from '../state/state-manager.js';
+import { migrateState } from '../state/state-migration.js';
 import { discoverMetaPrompts } from '../core/assembly/meta-prompt-loader.js';
 import { atomicWriteFile, ensureDir, getPackagePipelineDir } from '../utils/fs.js';
 import yaml from 'js-yaml';
@@ -27,8 +28,21 @@ export async function runWizard(options) {
             ],
         };
     }
-    // Backup existing .scaffold/ if --force
+    // Read old state before backup (to preserve completed steps)
+    let oldState = null;
     if (fs.existsSync(scaffoldDir) && force) {
+        const oldStatePath = path.join(scaffoldDir, 'state.json');
+        if (fs.existsSync(oldStatePath)) {
+            try {
+                const raw = JSON.parse(fs.readFileSync(oldStatePath, 'utf8'));
+                // Apply step name migrations before merging
+                migrateState(raw);
+                oldState = raw;
+            }
+            catch {
+                // Couldn't read old state — proceed without preserving
+            }
+        }
         const backupPath = path.join(projectRoot, '.scaffold.backup');
         const finalBackup = fs.existsSync(backupPath)
             ? `${backupPath}.${Date.now()}`
@@ -87,6 +101,25 @@ export async function runWizard(options) {
                 ? 'brownfield'
                 : 'greenfield',
     });
+    // Merge completed/skipped steps from old state (--force re-init)
+    if (oldState) {
+        const newState = stateManager.loadState();
+        let preserved = 0;
+        for (const [slug, entry] of Object.entries(oldState.steps)) {
+            if (entry.status === 'completed' || entry.status === 'skipped') {
+                if (newState.steps[slug]) {
+                    // Step exists in new pipeline — preserve its completion status
+                    newState.steps[slug] = entry;
+                    preserved++;
+                }
+                // Step doesn't exist in new pipeline — skip (it was removed or renamed)
+            }
+        }
+        if (preserved > 0) {
+            stateManager.saveState(newState);
+            output.info(`Preserved ${preserved} completed/skipped step(s) from previous state`);
+        }
+    }
     // Write empty decisions.jsonl
     const decisionsPath = path.join(scaffoldDir, 'decisions.jsonl');
     if (!fs.existsSync(decisionsPath)) {

package/dist/wizard/wizard.js.map

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

package/knowledge/core/adr-craft.md

@@ -4,6 +4,8 @@ description: Writing effective architecture decision records including technolog
 topics: [adr, architecture-decisions, tech-stack, decision-documentation, technology-selection]
 ---
 
+## Summary
+
 ## What Warrants an ADR
 
 An Architecture Decision Record captures a decision that is architecturally significant — one that affects the system's structure, non-functional characteristics, dependencies, interfaces, or construction techniques. Not every decision needs an ADR. The litmus test: would a new team member need to know why this choice was made to work effectively?
@@ -61,6 +63,8 @@ Each technology choice should compare the top 2-3 realistic options, state the s
 - Temporary decisions (experiment with X for a spike) — not architectural
 - Decisions that have no realistic alternatives — if there's only one viable option, just use it
 
+## Deep Guidance
+
 ## ADR Structure
 
 ### Title

package/knowledge/core/api-design.md

@@ -4,6 +4,8 @@ description: API design principles for REST, GraphQL, and inter-service communic
 topics: [api, rest, graphql, endpoints, contracts, versioning, error-handling, authentication]
 ---
 
+## Summary
+
 ## API-First Development
 
 Design the API contract before writing implementation code. The contract defines what the API does; the implementation fulfills that contract. This order matters because:
@@ -81,6 +83,8 @@ POST /api/v1/order-submissions       # Create an "order submission" resource
 POST /api/v1/password-resets         # Create a "password reset" resource
 ```
 
+## Deep Guidance
+
 ### HTTP Methods
 
 | Method | Semantics | Idempotent | Safe |