@zigrivers/scaffold 3.16.0 → 3.18.0

package/dist/utils/artifact-path.test.js

@@ -0,0 +1,138 @@
+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 { resolveContainedArtifactPath } from './artifact-path.js';
+const tmpDirs = [];
+function tmpRoot() {
+    const p = path.join(os.tmpdir(), `scaffold-test-${crypto.randomUUID()}`);
+    fs.mkdirSync(p, { recursive: true });
+    tmpDirs.push(p);
+    return p;
+}
+afterEach(() => {
+    for (const d of tmpDirs) {
+        try {
+            fs.rmSync(d, { recursive: true, force: true });
+        }
+        catch { /* ignore */ }
+    }
+    tmpDirs.length = 0;
+});
+describe('resolveContainedArtifactPath', () => {
+    it('resolves a normal relative path inside the project root', () => {
+        const root = tmpRoot();
+        const docs = path.join(root, 'docs');
+        fs.mkdirSync(docs, { recursive: true });
+        fs.writeFileSync(path.join(docs, 'plan.md'), 'x');
+        const resolved = resolveContainedArtifactPath(root, 'docs/plan.md');
+        expect(resolved).not.toBeNull();
+        expect(resolved).toBe(fs.realpathSync(path.join(docs, 'plan.md')));
+    });
+    it('returns null for a traversal attempt via ..', () => {
+        const root = tmpRoot();
+        fs.mkdirSync(path.join(root, 'docs'), { recursive: true });
+        const resolved = resolveContainedArtifactPath(root, '../../etc/passwd');
+        expect(resolved).toBeNull();
+    });
+    it('returns null when a symlink escapes the project root (existing leaf)', () => {
+        const root = tmpRoot();
+        const outside = tmpRoot();
+        fs.writeFileSync(path.join(outside, 'secret.txt'), 'nope');
+        fs.mkdirSync(path.join(root, 'docs'), { recursive: true });
+        fs.symlinkSync(outside, path.join(root, 'docs', 'escape'));
+        const resolved = resolveContainedArtifactPath(root, 'docs/escape/secret.txt');
+        expect(resolved).toBeNull();
+    });
+    it('returns null when a symlinked ancestor escapes and the leaf does NOT exist', () => {
+        // Critical case: the leaf is missing, but an ancestor in the chain is a
+        // symlink that points outside the project root. A naive ENOENT fallback
+        // that only does string-prefix checks would accept this. The helper must
+        // canonicalize the deepest existing ancestor and reject.
+        const root = tmpRoot();
+        const outside = tmpRoot();
+        fs.mkdirSync(path.join(root, 'docs'), { recursive: true });
+        fs.symlinkSync(outside, path.join(root, 'docs', 'escape'));
+        const resolved = resolveContainedArtifactPath(root, 'docs/escape/missing.txt');
+        expect(resolved).toBeNull();
+    });
+    it('returns null on prefix collision (project vs project-malicious)', () => {
+        const parent = tmpRoot();
+        const project = path.join(parent, 'project');
+        const malicious = path.join(parent, 'project-malicious');
+        fs.mkdirSync(project, { recursive: true });
+        fs.mkdirSync(malicious, { recursive: true });
+        fs.writeFileSync(path.join(malicious, 'secret.txt'), 'nope');
+        const resolved = resolveContainedArtifactPath(project, '../project-malicious/secret.txt');
+        expect(resolved).toBeNull();
+    });
+    it('returns the canonical path for a file that does not yet exist', () => {
+        // Pre-completion checks pass a path whose file does not exist yet. The
+        // helper must NOT reject these — it must return a canonical would-be path
+        // after verifying the deepest existing ancestor stays within the root.
+        const root = tmpRoot();
+        fs.mkdirSync(path.join(root, 'docs'), { recursive: true });
+        const canonicalRoot = fs.realpathSync(root);
+        const resolved = resolveContainedArtifactPath(root, 'docs/not-yet.md');
+        expect(resolved).toBe(path.join(canonicalRoot, 'docs', 'not-yet.md'));
+    });
+    it('returns a canonical path when the project root itself is a symlink', () => {
+        // macOS tmpdir is /var/folders/... which is a symlink to /private/var/... —
+        // this test makes the behavior explicit regardless of platform.
+        const realParent = tmpRoot();
+        const realRoot = path.join(realParent, 'real-proj');
+        fs.mkdirSync(realRoot, { recursive: true });
+        const symlinkedRoot = path.join(tmpRoot(), 'via-symlink');
+        fs.symlinkSync(realRoot, symlinkedRoot);
+        const resolved = resolveContainedArtifactPath(symlinkedRoot, 'docs/not-yet.md');
+        expect(resolved).toBe(path.join(fs.realpathSync(symlinkedRoot), 'docs', 'not-yet.md'));
+    });
+    it('returns null when the file does not exist AND the path would escape', () => {
+        const root = tmpRoot();
+        const resolved = resolveContainedArtifactPath(root, '../../does-not-exist');
+        expect(resolved).toBeNull();
+    });
+    it('returns null when relPath is absolute and points outside the root', () => {
+        // path.resolve(root, '/etc/passwd') === '/etc/passwd' — the root arg is
+        // ignored when the second arg is absolute. This is the single most
+        // important attack vector for a poisoned state.json with an absolute
+        // `produces` entry.
+        const root = tmpRoot();
+        const resolved = resolveContainedArtifactPath(root, '/etc/passwd');
+        expect(resolved).toBeNull();
+    });
+    it('returns null for relPath containing a null byte', () => {
+        // fs APIs throw on null bytes; reject them at the boundary rather than
+        // leaking undefined behavior to callers.
+        const root = tmpRoot();
+        const resolved = resolveContainedArtifactPath(root, 'docs/foo\0.md');
+        expect(resolved).toBeNull();
+    });
+    it('returns null when the project root itself does not exist', () => {
+        const nonexistent = path.join(os.tmpdir(), `scaffold-test-${crypto.randomUUID()}`);
+        const resolved = resolveContainedArtifactPath(nonexistent, 'docs/plan.md');
+        expect(resolved).toBeNull();
+    });
+    it('rejects any relPath that resolves to the project root itself', () => {
+        // The project root directory is not a legitimate artifact. Empty
+        // string, '.', './', and an absolute path to the root all resolve
+        // to projectRoot and must all fail — otherwise existence-only
+        // callers (detectCompletion, checkCompletion, analyzeCrash) would
+        // count the project root directory as a present artifact.
+        const root = tmpRoot();
+        expect(resolveContainedArtifactPath(root, '')).toBeNull();
+        expect(resolveContainedArtifactPath(root, '.')).toBeNull();
+        expect(resolveContainedArtifactPath(root, './')).toBeNull();
+        expect(resolveContainedArtifactPath(root, root)).toBeNull();
+        expect(resolveContainedArtifactPath(root, fs.realpathSync(root))).toBeNull();
+    });
+    it('rejects non-string relPath (state boundary is untrusted)', () => {
+        // State is JSON-loaded via a trust-cast; a poisoned state.json could
+        // put a non-string in produces[]. Fail closed.
+        const root = tmpRoot();
+        const resolved = resolveContainedArtifactPath(root, 42);
+        expect(resolved).toBeNull();
+    });
+});
+//# sourceMappingURL=artifact-path.test.js.map

package/dist/utils/artifact-path.test.js.map

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

package/dist/utils/errors.d.ts

@@ -27,7 +27,7 @@ export declare function frontmatterUnclosed(file: string): ScaffoldError;
 export declare function frontmatterYamlError(file: string, detail: string): ScaffoldError;
 export declare function frontmatterNameInvalid(name: string, file: string): ScaffoldError;
 export declare function frontmatterUnknownField(field: string, file: string): ScaffoldWarning;
-export declare function stateSchemaVersion(expected: number, actual: number, file: string): ScaffoldError;
+export declare function stateSchemaVersion(expected: number | readonly number[], actual: number, file: string): ScaffoldError;
 export declare function stateMissing(file: string): ScaffoldError;
 export declare function stateParseError(file: string, detail: string): ScaffoldError;
 export declare function psmAlreadyInProgress(step: string, current: string): ScaffoldError;
@@ -44,6 +44,8 @@ export declare function overlayMissing(name: string, path: string): ScaffoldErro
 export declare function overlayParseError(path: string, detail: string): ScaffoldError;
 export declare function overlayMalformedEntry(step: string, field: string, file: string): ScaffoldWarning;
 export declare function overlayMalformedSection(section: string, file: string): ScaffoldWarning;
+export declare function overlayMalformedAppendItem(step: string, index: number, file: string): ScaffoldWarning;
+export declare function overlayCrossReadsNotAllowed(file: string): ScaffoldWarning;
 /**
  * Converts any thrown value into a well-formed ScaffoldError.
  * - Already-shaped ScaffoldError objects are returned unchanged (strict duck-type check).

package/dist/utils/errors.d.ts.map

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

package/dist/utils/errors.js

@@ -1,4 +1,5 @@
 // src/utils/errors.ts
+import path from 'node:path';
 // --- Error factories ---
 export function configMissing(configPath) {
     return {
@@ -130,12 +131,15 @@ export function frontmatterUnknownField(field, file) {
     };
 }
 export function stateSchemaVersion(expected, actual, file) {
+    const expectedDisplay = Array.isArray(expected)
+        ? expected.join(' or ')
+        : String(expected);
     return {
         code: 'STATE_SCHEMA_VERSION',
-        message: `state.json schema version ${actual} is not supported (expected ${expected})`,
+        message: `state.json schema version ${actual} is not supported (expected ${expectedDisplay})`,
         exitCode: 3,
         recovery: 'Run "scaffold reset" to reinitialize state, or upgrade scaffold',
-        context: { file, expected, actual },
+        context: { file, expected: Array.isArray(expected) ? expected[0] : expected, actual },
     };
 }
 export function stateMissing(file) {
@@ -268,6 +272,21 @@ export function overlayMalformedSection(section, file) {
         context: { section, file },
     };
 }
+export function overlayMalformedAppendItem(step, index, file) {
+    return {
+        code: 'OVERLAY_MALFORMED_APPEND_ITEM',
+        message: `Overlay entry "${step}" append[${index}] is malformed — ignoring that item`,
+        context: { step, index, file },
+    };
+}
+export function overlayCrossReadsNotAllowed(file) {
+    return {
+        code: 'OVERLAY_CROSS_READS_NOT_ALLOWED',
+        message: 'cross-reads-overrides is only valid in structural overlays — '
+            + `stripping from ${path.basename(file)}`,
+        context: { file },
+    };
+}
 /**
  * Converts any thrown value into a well-formed ScaffoldError.
  * - Already-shaped ScaffoldError objects are returned unchanged (strict duck-type check).

package/dist/utils/errors.js.map

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

package/dist/utils/errors.test.js

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import { configMissing, configUnknownField, lockHeld, fieldInvalidMethodology, psmAlreadyInProgress, configEmpty, configParseError, configNotObject, fieldMissing, fieldWrongType, fieldEmptyValue, fieldInvalidDepth, frontmatterMissing, frontmatterUnclosed, frontmatterYamlError, frontmatterNameInvalid, frontmatterUnknownField, stateSchemaVersion, stateMissing, stateParseError, lockWriteFailed, lockStaleCleared, decisionParseError, presetMissing, presetParseError, presetInvalidStep, presetMissingStep, overlayMissing, overlayParseError, overlayMalformedEntry, asScaffoldError, } from './errors.js';
+import { configMissing, configUnknownField, lockHeld, fieldInvalidMethodology, psmAlreadyInProgress, configEmpty, configParseError, configNotObject, fieldMissing, fieldWrongType, fieldEmptyValue, fieldInvalidDepth, frontmatterMissing, frontmatterUnclosed, frontmatterYamlError, frontmatterNameInvalid, frontmatterUnknownField, stateSchemaVersion, stateMissing, stateParseError, lockWriteFailed, lockStaleCleared, decisionParseError, presetMissing, presetParseError, presetInvalidStep, presetMissingStep, overlayMissing, overlayParseError, overlayMalformedEntry, overlayMalformedAppendItem, overlayCrossReadsNotAllowed, asScaffoldError, } from './errors.js';
 describe('error factories — shape', () => {
     it('all error objects have code, message, exitCode', () => {
         const errors = [
@@ -52,6 +52,32 @@ describe('error factories — shape', () => {
             expect(warn).not.toHaveProperty('exitCode');
         }
     });
+    it('overlayMalformedAppendItem produces a ScaffoldWarning with code, message, and context', () => {
+        const w = overlayMalformedAppendItem('system-architecture', 3, '/path/overlay.yml');
+        expect(w.code).toBe('OVERLAY_MALFORMED_APPEND_ITEM');
+        expect(w.message).toContain('system-architecture');
+        expect(w.message).toContain('append[3]');
+        // Lock the item-vs-entry distinction (spec §2.1) so a regression to the old
+        // 'ignoring entry' wording would fail this test.
+        expect(w.message).toContain('ignoring that item');
+        expect(w.message).not.toContain('ignoring entry');
+        expect(w).not.toHaveProperty('exitCode');
+        expect(w.context).toEqual({
+            step: 'system-architecture',
+            index: 3,
+            file: '/path/overlay.yml',
+        });
+    });
+    it('overlayCrossReadsNotAllowed produces a ScaffoldWarning using basename of file', () => {
+        const w = overlayCrossReadsNotAllowed('/some/absolute/path/backend-overlay.yml');
+        expect(w.code).toBe('OVERLAY_CROSS_READS_NOT_ALLOWED');
+        expect(w.message).toContain('structural overlays');
+        expect(w.message).toContain('stripping');
+        expect(w.message).toContain('backend-overlay.yml');
+        expect(w.message).not.toContain('/some/absolute/path');
+        expect(w).not.toHaveProperty('exitCode');
+        expect(w.context).toEqual({ file: '/some/absolute/path/backend-overlay.yml' });
+    });
 });
 describe('configMissing', () => {
     it('returns CONFIG_MISSING with exitCode 1', () => {

package/dist/utils/errors.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.test.js","sourceRoot":"","sources":["../../src/utils/errors.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,QAAQ,EACR,uBAAuB,EACvB,oBAAoB,EACpB,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,GAGhB,MAAM,aAAa,CAAA;AAEpB,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,MAAM,GAAoB;YAC9B,aAAa,CAAC,kBAAkB,CAAC;YACjC,WAAW,CAAC,kBAAkB,CAAC;YAC/B,gBAAgB,CAAC,kBAAkB,EAAE,UAAU,CAAC;YAChD,eAAe,CAAC,kBAAkB,CAAC;YACnC,YAAY,CAAC,MAAM,EAAE,kBAAkB,CAAC;YACxC,cAAc,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC;YACpD,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC;YAChC,iBAAiB,CAAC,CAAC,EAAE,OAAO,CAAC;YAC7B,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;YAChD,kBAAkB,CAAC,cAAc,CAAC;YAClC,mBAAmB,CAAC,cAAc,CAAC;YACnC,oBAAoB,CAAC,cAAc,EAAE,UAAU,CAAC;YAChD,sBAAsB,CAAC,UAAU,EAAE,cAAc,CAAC;YAClD,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAAE,kBAAkB,CAAC;YAC5C,YAAY,CAAC,kBAAkB,CAAC;YAChC,eAAe,CAAC,kBAAkB,EAAE,UAAU,CAAC;YAC/C,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,CAAC;YACxC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC;YAC7B,eAAe,CAAC,YAAY,EAAE,mBAAmB,CAAC;YAClD,kBAAkB,CAAC,oBAAoB,EAAE,EAAE,EAAE,WAAW,CAAC;YACzD,aAAa,CAAC,KAAK,EAAE,kBAAkB,CAAC;YACxC,gBAAgB,CAAC,kBAAkB,EAAE,UAAU,CAAC;YAChD,iBAAiB,CAAC,cAAc,EAAE,KAAK,CAAC;YACxC,cAAc,CAAC,MAAM,EAAE,mBAAmB,CAAC;YAC3C,iBAAiB,CAAC,mBAAmB,EAAE,UAAU,CAAC;SACnD,CAAA;QAED,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;YAClC,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,CAAA;YACrC,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,CAAA;YACtC,MAAM,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YACtC,MAAM,CAAC,OAAO,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YACzC,MAAM,CAAC,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC5C,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,QAAQ,GAAsB;YAClC,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC;YAClC,uBAAuB,CAAC,KAAK,EAAE,cAAc,CAAC;YAC9C,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC;YAC9B,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC;YAClC,qBAAqB,CAAC,QAAQ,EAAE,SAAS,EAAE,mBAAmB,CAAC;SAChE,CAAA;QAED,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;YACnC,MAAM,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,CAAA;YACtC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,UAAU,CAAC,CAAA;QAC7C,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,GAAG,GAAG,aAAa,CAAC,kBAAkB,CAAC,CAAA;QAC7C,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;QACvC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC9B,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QAC/C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;QAC9C,MAAM,CAAE,IAA2C,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,EAAE,CAAA;IAClF,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;QACzC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QAClC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC9B,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,GAAG,GAAG,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;QAC5D,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAA;IAChD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,GAAG,GAAG,uBAAuB,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;QACzD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,CAAA;IACpD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,GAAG,GAAG,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;QACpD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAA;QAChD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC9B,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,GAAG,GAAkB,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAA;QACvE,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACvD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAA;QAC7B,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC,CAAA;QAClD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QACpC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACnC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAC/B,2EAA2E;QAC3E,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC1C,MAAM,CAAC,OAAO,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACnD,MAAM,CAAE,MAAM,CAAC,OAAQ,CAAC,KAAgB,CAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAA;IAC3E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,EAAE,CAAC,CAAA;QACzB,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC,CAAA;QAClD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC,CAAA;QACtD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QACpC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACtC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,YAAY,EAAE,GAAG,EAAE;QACpB,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAA;QACnD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IAC1C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iBAAiB,EAAE,GAAG,EAAE;QACzB,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC,CAAA;QACxD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;IAC/C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;QAC/C,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC,CAAA;QACtD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA,CAAI,iCAAiC;QACzE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
+{"version":3,"file":"errors.test.js","sourceRoot":"","sources":["../../src/utils/errors.test.ts"],"names":[],"mappings":"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"}

package/dist/utils/user-errors.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Base class for user-facing errors that the CLI handler layer normalizes
+ * to an exit code (typically 2) and a diagnostic line. Internal errors
+ * that should surface as stack traces do NOT extend this.
+ */
+export declare abstract class ScaffoldUserError extends Error {
+    constructor(message: string);
+}
+export declare class FlagConflictError extends ScaffoldUserError {
+    constructor(conflictSummary: string);
+}
+export declare class InvalidYamlError extends ScaffoldUserError {
+    constructor(sourceLabel: string, detail: string);
+}
+export declare class InvalidConfigError extends ScaffoldUserError {
+    constructor(sourceLabel: string, detail: string);
+}
+export declare class FromPathReadError extends ScaffoldUserError {
+    constructor(pathArg: string, cause: string);
+}
+export declare class TTYStdinError extends ScaffoldUserError {
+    constructor();
+}
+export declare class MultiServiceNotSupportedError extends ScaffoldUserError {
+    constructor(commandName: string);
+}
+export declare class ExistingScaffoldError extends ScaffoldUserError {
+    constructor(projectRoot: string);
+}
+export declare class ServiceRequiredError extends ScaffoldUserError {
+    constructor(stepName: string);
+}
+export declare class ServiceRejectedError extends ScaffoldUserError {
+    constructor(stepName: string);
+}
+export declare class ServiceNotFoundError extends ScaffoldUserError {
+    constructor(serviceName: string);
+}
+export declare class ServiceFlagWithoutServicesError extends ScaffoldUserError {
+    constructor();
+}
+export declare class MultiServiceOverlayMissingError extends ScaffoldUserError {
+    constructor();
+}
+export declare function isScaffoldUserError(err: unknown): err is ScaffoldUserError;
+//# sourceMappingURL=user-errors.d.ts.map

package/dist/utils/user-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-errors.d.ts","sourceRoot":"","sources":["../../src/utils/user-errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,8BAAsB,iBAAkB,SAAQ,KAAK;gBACvC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,iBAAkB,SAAQ,iBAAiB;gBAC1C,eAAe,EAAE,MAAM;CAGpC;AAED,qBAAa,gBAAiB,SAAQ,iBAAiB;gBACzC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAGhD;AAED,qBAAa,kBAAmB,SAAQ,iBAAiB;gBAC3C,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAGhD;AAED,qBAAa,iBAAkB,SAAQ,iBAAiB;gBAC1C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAG3C;AAED,qBAAa,aAAc,SAAQ,iBAAiB;;CAInD;AAED,qBAAa,6BAA8B,SAAQ,iBAAiB;gBACtD,WAAW,EAAE,MAAM;CAMhC;AAED,qBAAa,qBAAsB,SAAQ,iBAAiB;gBAC9C,WAAW,EAAE,MAAM;CAGhC;AAED,qBAAa,oBAAqB,SAAQ,iBAAiB;gBAC7C,QAAQ,EAAE,MAAM;CAG7B;AAED,qBAAa,oBAAqB,SAAQ,iBAAiB;gBAC7C,QAAQ,EAAE,MAAM;CAG7B;AAED,qBAAa,oBAAqB,SAAQ,iBAAiB;gBAC7C,WAAW,EAAE,MAAM;CAGhC;AAED,qBAAa,+BAAgC,SAAQ,iBAAiB;;CAIrE;AAED,qBAAa,+BAAgC,SAAQ,iBAAiB;;CAIrE;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,iBAAiB,CAE1E"}

package/dist/utils/user-errors.js

@@ -0,0 +1,76 @@
+/**
+ * Base class for user-facing errors that the CLI handler layer normalizes
+ * to an exit code (typically 2) and a diagnostic line. Internal errors
+ * that should surface as stack traces do NOT extend this.
+ */
+export class ScaffoldUserError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = new.target.name;
+    }
+}
+export class FlagConflictError extends ScaffoldUserError {
+    constructor(conflictSummary) {
+        super(`--from cannot be combined with: ${conflictSummary}. Edit services.yml and re-run.`);
+    }
+}
+export class InvalidYamlError extends ScaffoldUserError {
+    constructor(sourceLabel, detail) {
+        super(`Invalid YAML in ${sourceLabel}: ${detail}`);
+    }
+}
+export class InvalidConfigError extends ScaffoldUserError {
+    constructor(sourceLabel, detail) {
+        super(`Invalid config (${sourceLabel}):\n${detail}`);
+    }
+}
+export class FromPathReadError extends ScaffoldUserError {
+    constructor(pathArg, cause) {
+        super(`Cannot read --from path "${pathArg}": ${cause}`);
+    }
+}
+export class TTYStdinError extends ScaffoldUserError {
+    constructor() {
+        super('--from - requires piped input (stdin is a TTY).');
+    }
+}
+export class MultiServiceNotSupportedError extends ScaffoldUserError {
+    constructor(commandName) {
+        super('Multi-service projects are not yet executable. '
+            + `"scaffold ${commandName}" on a config with services[] lands in Wave 2.`);
+    }
+}
+export class ExistingScaffoldError extends ScaffoldUserError {
+    constructor(projectRoot) {
+        super(`.scaffold/ already exists at "${projectRoot}". Use --force to back up and reinitialize.`);
+    }
+}
+export class ServiceRequiredError extends ScaffoldUserError {
+    constructor(stepName) {
+        super(`Step '${stepName}' requires --service flag when services[] is configured.`);
+    }
+}
+export class ServiceRejectedError extends ScaffoldUserError {
+    constructor(stepName) {
+        super(`Step '${stepName}' is a global cross-service step and does not accept --service.`);
+    }
+}
+export class ServiceNotFoundError extends ScaffoldUserError {
+    constructor(serviceName) {
+        super(`Service '${serviceName}' not found in services[].`);
+    }
+}
+export class ServiceFlagWithoutServicesError extends ScaffoldUserError {
+    constructor() {
+        super('--service requires services[] in config.');
+    }
+}
+export class MultiServiceOverlayMissingError extends ScaffoldUserError {
+    constructor() {
+        super('Multi-service projects require multi-service-overlay.yml.');
+    }
+}
+export function isScaffoldUserError(err) {
+    return err instanceof ScaffoldUserError;
+}
+//# sourceMappingURL=user-errors.js.map

package/dist/utils/user-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-errors.js","sourceRoot":"","sources":["../../src/utils/user-errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAgB,iBAAkB,SAAQ,KAAK;IACnD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAA;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,iBAAiB;IACtD,YAAY,eAAuB;QACjC,KAAK,CAAC,mCAAmC,eAAe,iCAAiC,CAAC,CAAA;IAC5F,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,iBAAiB;IACrD,YAAY,WAAmB,EAAE,MAAc;QAC7C,KAAK,CAAC,mBAAmB,WAAW,KAAK,MAAM,EAAE,CAAC,CAAA;IACpD,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,iBAAiB;IACvD,YAAY,WAAmB,EAAE,MAAc;QAC7C,KAAK,CAAC,mBAAmB,WAAW,OAAO,MAAM,EAAE,CAAC,CAAA;IACtD,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,iBAAiB;IACtD,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,4BAA4B,OAAO,MAAM,KAAK,EAAE,CAAC,CAAA;IACzD,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,iBAAiB;IAClD;QACE,KAAK,CAAC,iDAAiD,CAAC,CAAA;IAC1D,CAAC;CACF;AAED,MAAM,OAAO,6BAA8B,SAAQ,iBAAiB;IAClE,YAAY,WAAmB;QAC7B,KAAK,CACH,iDAAiD;cAC/C,aAAa,WAAW,gDAAgD,CAC3E,CAAA;IACH,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,iBAAiB;IAC1D,YAAY,WAAmB;QAC7B,KAAK,CAAC,iCAAiC,WAAW,6CAA6C,CAAC,CAAA;IAClG,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,iBAAiB;IACzD,YAAY,QAAgB;QAC1B,KAAK,CAAC,SAAS,QAAQ,0DAA0D,CAAC,CAAA;IACpF,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,iBAAiB;IACzD,YAAY,QAAgB;QAC1B,KAAK,CAAC,SAAS,QAAQ,iEAAiE,CAAC,CAAA;IAC3F,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,iBAAiB;IACzD,YAAY,WAAmB;QAC7B,KAAK,CAAC,YAAY,WAAW,4BAA4B,CAAC,CAAA;IAC5D,CAAC;CACF;AAED,MAAM,OAAO,+BAAgC,SAAQ,iBAAiB;IACpE;QACE,KAAK,CAAC,0CAA0C,CAAC,CAAA;IACnD,CAAC;CACF;AAED,MAAM,OAAO,+BAAgC,SAAQ,iBAAiB;IACpE;QACE,KAAK,CAAC,2DAA2D,CAAC,CAAA;IACpE,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,OAAO,GAAG,YAAY,iBAAiB,CAAA;AACzC,CAAC"}

package/dist/utils/user-errors.test.d.ts

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

package/dist/utils/user-errors.test.d.ts.map

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

package/dist/utils/user-errors.test.js

@@ -0,0 +1,74 @@
+import { describe, it, expect } from 'vitest';
+import { ScaffoldUserError, FlagConflictError, InvalidYamlError, InvalidConfigError, FromPathReadError, TTYStdinError, MultiServiceNotSupportedError, ExistingScaffoldError, isScaffoldUserError, ServiceRequiredError, ServiceRejectedError, ServiceNotFoundError, ServiceFlagWithoutServicesError, MultiServiceOverlayMissingError, } from './user-errors.js';
+describe('ScaffoldUserError taxonomy', () => {
+    it('FlagConflictError extends ScaffoldUserError', () => {
+        const err = new FlagConflictError('foo');
+        expect(err).toBeInstanceOf(ScaffoldUserError);
+        expect(err.message).toContain('foo');
+    });
+    it('InvalidYamlError carries source label', () => {
+        const err = new InvalidYamlError('services.yml', 'unexpected token');
+        expect(err.message).toContain('services.yml');
+        expect(err.message).toContain('unexpected token');
+    });
+    it('InvalidConfigError carries formatted Zod message', () => {
+        const err = new InvalidConfigError('services.yml', 'bad field');
+        expect(err.message).toContain('services.yml');
+        expect(err.message).toContain('bad field');
+    });
+    it('FromPathReadError carries path and cause', () => {
+        const err = new FromPathReadError('x.yml', 'ENOENT');
+        expect(err.message).toContain('x.yml');
+        expect(err.message).toContain('ENOENT');
+    });
+    it('TTYStdinError has a fixed message', () => {
+        const err = new TTYStdinError();
+        expect(err.message).toContain('stdin');
+    });
+    it('MultiServiceNotSupportedError identifies the blocked command', () => {
+        const err = new MultiServiceNotSupportedError('run');
+        expect(err.message).toContain('run');
+        expect(err.message).toContain('Wave 2');
+    });
+    it('ExistingScaffoldError carries project root and recovery hint', () => {
+        const err = new ExistingScaffoldError('/tmp/my-project');
+        expect(err).toBeInstanceOf(ScaffoldUserError);
+        expect(err.message).toContain('/tmp/my-project');
+        expect(err.message).toContain('--force');
+    });
+    it('isScaffoldUserError narrows correctly', () => {
+        expect(isScaffoldUserError(new FlagConflictError('x'))).toBe(true);
+        expect(isScaffoldUserError(new Error('plain'))).toBe(false);
+        expect(isScaffoldUserError(null)).toBe(false);
+        expect(isScaffoldUserError(undefined)).toBe(false);
+    });
+    it('ServiceRequiredError', () => {
+        const err = new ServiceRequiredError('tech-stack');
+        expect(err).toBeInstanceOf(ScaffoldUserError);
+        expect(err.message).toContain('tech-stack');
+        expect(err.message).toContain('--service');
+    });
+    it('ServiceNotFoundError', () => {
+        const err = new ServiceNotFoundError('nonexistent');
+        expect(err).toBeInstanceOf(ScaffoldUserError);
+        expect(err.message).toContain('nonexistent');
+    });
+    it('ServiceRejectedError', () => {
+        const err = new ServiceRejectedError('service-ownership-map');
+        expect(err).toBeInstanceOf(ScaffoldUserError);
+        expect(err.message).toContain('service-ownership-map');
+        expect(err.message).toContain('global');
+    });
+    it('ServiceFlagWithoutServicesError', () => {
+        const err = new ServiceFlagWithoutServicesError();
+        expect(err).toBeInstanceOf(ScaffoldUserError);
+        expect(err.message).toContain('--service');
+        expect(err.message).toContain('services[]');
+    });
+    it('MultiServiceOverlayMissingError', () => {
+        const err = new MultiServiceOverlayMissingError();
+        expect(err).toBeInstanceOf(ScaffoldUserError);
+        expect(err.message).toContain('multi-service-overlay.yml');
+    });
+});
+//# sourceMappingURL=user-errors.test.js.map

package/dist/utils/user-errors.test.js.map

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

package/dist/validation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAQvE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,QAAQ,EAAE,eAAe,EAAE,CAAA;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,aAAa,GAAG,OAAO,GAAG,cAAc,CAAA;AAEjF;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,eAAe,EAAuD,GAC7E,gBAAgB,CAqDlB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAQvE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,QAAQ,EAAE,eAAe,EAAE,CAAA;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,aAAa,GAAG,OAAO,GAAG,cAAc,CAAA;AAEjF;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,eAAe,EAAuD,GAC7E,gBAAgB,CAoElB"}

package/dist/validation/index.js

@@ -1,4 +1,6 @@
 // src/validation/index.ts
+import fs from 'node:fs';
+import path from 'node:path';
 import { discoverMetaPrompts } from '../core/assembly/meta-prompt-loader.js';
 import { getPackagePipelineDir } from '../utils/fs.js';
 import { validateConfig } from './config-validator.js';
@@ -47,6 +49,20 @@ export function runValidation(projectRoot, scopes = ['config', 'frontmatter', 's
         const r = validateState(projectRoot);
         allErrors.push(...r.errors);
         allWarnings.push(...r.warnings);
+        // Validate service state files if they exist
+        const servicesDir = path.join(projectRoot, '.scaffold', 'services');
+        if (fs.existsSync(servicesDir)) {
+            for (const entry of fs.readdirSync(servicesDir, { withFileTypes: true })) {
+                if (entry.isDirectory()) {
+                    const serviceStatePath = path.join(servicesDir, entry.name, 'state.json');
+                    if (fs.existsSync(serviceStatePath)) {
+                        const sr = validateState(projectRoot, serviceStatePath);
+                        allErrors.push(...sr.errors);
+                        allWarnings.push(...sr.warnings);
+                    }
+                }
+            }
+        }
     }
     if (scopes.includes('dependencies')) {
         const r = validateDependencies(pipelineDir);