@zigrivers/scaffold 3.9.2 → 3.10.0

package/dist/project/detectors/web-app.js

@@ -0,0 +1,228 @@
+import { evidence } from './types.js';
+/** Web framework config files — presence of any means "web project at root". */
+const WEB_FRAMEWORK_CONFIGS = [
+    'next.config.js', 'next.config.mjs', 'next.config.ts',
+    'astro.config.mjs', 'astro.config.ts',
+    'remix.config.js', 'remix.config.ts',
+    'nuxt.config.ts', 'nuxt.config.js',
+    'svelte.config.js', 'svelte.config.ts',
+    'vite.config.ts', 'vite.config.js', 'vite.config.mjs',
+    'angular.json',
+];
+/**
+ * Returns true when the project looks like a mobile-only project (Flutter,
+ * Expo, or React Native with ios/ + android/ dirs). Returns false when a web
+ * framework config file is present at root (monorepo case — the web detector
+ * should still fire).
+ */
+function isMobileProject(ctx) {
+    // If any web framework config file exists, this is a monorepo — skip disqualifier.
+    for (const cfg of WEB_FRAMEWORK_CONFIGS) {
+        if (ctx.hasFile(cfg))
+            return false;
+    }
+    // Flutter
+    if (ctx.hasFile('pubspec.yaml'))
+        return true;
+    // Expo
+    if (ctx.hasFile('app.json') && ctx.hasDep('expo', 'npm'))
+        return true;
+    // React Native — both native dirs present
+    if (ctx.dirExists('ios') && ctx.dirExists('android'))
+        return true;
+    return false;
+}
+/** Reads the first existing file from a list, returning its content. */
+function readFirst(ctx, paths) {
+    for (const p of paths) {
+        const content = ctx.readFileText(p);
+        if (content !== undefined)
+            return content;
+    }
+    return undefined;
+}
+function detectNextJs(ctx) {
+    if (!ctx.hasDep('next', 'npm'))
+        return null;
+    const configContent = readFirst(ctx, ['next.config.mjs', 'next.config.ts', 'next.config.js']);
+    const evidenceList = [evidence('next-dep', 'package.json')];
+    let renderingStrategy = 'ssr';
+    if (configContent) {
+        if (/output\s*:\s*['"]export['"]/.test(configContent)) {
+            renderingStrategy = 'ssg';
+        }
+        else if (/output\s*:\s*['"]standalone['"]/.test(configContent)) {
+            renderingStrategy = 'ssr';
+        }
+        evidenceList.push(evidence('next-config', 'next.config.mjs'));
+    }
+    // Hybrid detection: both app/ and pages/ directories present
+    if (ctx.dirExists('app') && ctx.dirExists('pages')) {
+        renderingStrategy = 'hybrid';
+        evidenceList.push(evidence('next-hybrid', 'app/ + pages/'));
+    }
+    return { framework: 'next', renderingStrategy, evidenceList };
+}
+function detectAstro(ctx) {
+    if (!ctx.hasDep('astro', 'npm'))
+        return null;
+    const configContent = readFirst(ctx, ['astro.config.mjs', 'astro.config.ts']);
+    const evidenceList = [evidence('astro-dep', 'package.json')];
+    let renderingStrategy = 'ssg';
+    if (configContent) {
+        if (/output\s*:\s*['"]server['"]/.test(configContent)) {
+            renderingStrategy = 'ssr';
+        }
+        else if (/output\s*:\s*['"]hybrid['"]/.test(configContent)) {
+            renderingStrategy = 'hybrid';
+        }
+        evidenceList.push(evidence('astro-config', 'astro.config.mjs'));
+    }
+    return { framework: 'astro', renderingStrategy, evidenceList };
+}
+function detectRemix(ctx) {
+    if (!ctx.hasDep('@remix-run/react', 'npm') && !ctx.hasDep('@remix-run/node', 'npm'))
+        return null;
+    return {
+        framework: 'remix',
+        renderingStrategy: 'ssr',
+        evidenceList: [evidence('remix-dep', 'package.json')],
+    };
+}
+function detectNuxt(ctx) {
+    if (!ctx.hasDep('nuxt', 'npm'))
+        return null;
+    const configContent = readFirst(ctx, ['nuxt.config.ts', 'nuxt.config.js']);
+    const evidenceList = [evidence('nuxt-dep', 'package.json')];
+    let renderingStrategy = 'ssr';
+    if (configContent && /ssr\s*:\s*false/.test(configContent)) {
+        renderingStrategy = 'spa';
+    }
+    return { framework: 'nuxt', renderingStrategy, evidenceList };
+}
+function detectSvelteKit(ctx) {
+    if (!ctx.hasDep('@sveltejs/kit', 'npm'))
+        return null;
+    const evidenceList = [evidence('sveltekit-dep', 'package.json')];
+    let renderingStrategy = 'ssr';
+    let deployTarget;
+    // Adapter-based deploy target inference
+    if (ctx.hasDep('@sveltejs/adapter-static', 'npm')) {
+        renderingStrategy = 'ssg';
+        deployTarget = 'static';
+    }
+    else if (ctx.hasDep('@sveltejs/adapter-vercel', 'npm')
+        || ctx.hasDep('@sveltejs/adapter-netlify', 'npm')
+        || ctx.hasDep('@sveltejs/adapter-auto', 'npm')) {
+        deployTarget = 'serverless';
+    }
+    else if (ctx.hasDep('@sveltejs/adapter-cloudflare', 'npm')) {
+        deployTarget = 'edge';
+    }
+    else if (ctx.hasDep('@sveltejs/adapter-node', 'npm')) {
+        deployTarget = 'container';
+    }
+    return { framework: 'sveltekit', renderingStrategy, deployTarget, evidenceList };
+}
+function detectVite(ctx) {
+    if (!ctx.hasDep('vite', 'npm'))
+        return null;
+    // Vite requires an HTML entry point to be considered a web app
+    if (!ctx.hasFile('index.html') && !ctx.hasFile('public/index.html'))
+        return null;
+    return {
+        framework: 'vite',
+        renderingStrategy: 'spa',
+        evidenceList: [evidence('vite-dep', 'package.json'), evidence('vite-html', 'index.html')],
+    };
+}
+function detectAngular(ctx) {
+    if (!ctx.hasFile('angular.json'))
+        return null;
+    return {
+        framework: 'angular',
+        renderingStrategy: 'spa',
+        evidenceList: [evidence('angular-json', 'angular.json')],
+    };
+}
+/** Deploy target fallback from platform-specific config files. */
+function inferDeployTarget(ctx) {
+    if (ctx.hasFile('vercel.json'))
+        return 'serverless';
+    if (ctx.hasFile('netlify.toml'))
+        return 'serverless';
+    if (ctx.hasFile('wrangler.toml'))
+        return 'edge';
+    if (ctx.hasFile('Dockerfile'))
+        return 'container';
+    return undefined;
+}
+/** Detect realtime capabilities from dependencies. */
+function inferRealtime(ctx) {
+    if (ctx.hasDep('socket.io', 'npm') || ctx.hasDep('socket.io-client', 'npm'))
+        return 'websocket';
+    if (ctx.hasDep('ws', 'npm'))
+        return 'websocket';
+    return 'none';
+}
+/** Detect auth flow from dependencies. */
+function inferAuthFlow(ctx) {
+    // Session-based auth libraries
+    const sessionDeps = ['next-auth', '@auth/core', 'lucia', '@supabase/supabase-js'];
+    if (ctx.hasAnyDep(sessionDeps, 'npm'))
+        return 'session';
+    // OAuth-specific libraries
+    const oauthDeps = [
+        '@clerk/nextjs', '@clerk/clerk-react',
+        '@auth0/nextjs-auth0', '@auth0/auth0-react',
+    ];
+    if (ctx.hasAnyDep(oauthDeps, 'npm'))
+        return 'oauth';
+    return 'none';
+}
+/**
+ * Detects web-app projects by framework signature.
+ *
+ * Framework cascade: Next.js > Astro > Remix > Nuxt > SvelteKit > Vite > Angular.
+ * First match wins. Also infers rendering strategy, deploy target, realtime, and auth flow.
+ *
+ * Mobile disqualifier: returns null if the project looks mobile-only (Flutter,
+ * Expo, React Native) UNLESS a web framework config file is present (monorepo).
+ *
+ * IMPORTANT: this detector ONLY uses the SignalContext API — no direct fs/path imports.
+ */
+export function detectWebApp(ctx) {
+    // Mobile disqualifier — but not if web framework configs are present
+    if (isMobileProject(ctx))
+        return null;
+    // Framework detection cascade
+    const frameworkDetectors = [
+        detectNextJs, detectAstro, detectRemix, detectNuxt,
+        detectSvelteKit, detectVite, detectAngular,
+    ];
+    let framework = null;
+    for (const detect of frameworkDetectors) {
+        framework = detect(ctx);
+        if (framework)
+            break;
+    }
+    if (!framework)
+        return null;
+    // Deploy target: use framework-specific if available, else infer from config files
+    const deployTarget = framework.deployTarget ?? inferDeployTarget(ctx);
+    // Realtime + auth
+    const realtime = inferRealtime(ctx);
+    const authFlow = inferAuthFlow(ctx);
+    return {
+        projectType: 'web-app',
+        confidence: 'high',
+        partialConfig: {
+            renderingStrategy: framework.renderingStrategy,
+            ...(deployTarget && { deployTarget }),
+            ...(realtime !== 'none' && { realtime }),
+            ...(authFlow !== 'none' && { authFlow }),
+        },
+        evidence: [...framework.evidenceList],
+    };
+}
+//# sourceMappingURL=web-app.js.map

package/dist/project/detectors/web-app.js.map

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

package/dist/project/detectors/web-app.test.d.ts

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

package/dist/project/detectors/web-app.test.d.ts.map

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

package/dist/project/detectors/web-app.test.js

@@ -0,0 +1,95 @@
+import { describe, it, expect } from 'vitest';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createSignalContext, createFakeSignalContext } from './context.js';
+import { detectWebApp } from './web-app.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const FIXTURES = path.join(__dirname, '../../../tests/fixtures/adopt/detectors/web-app');
+describe('detectWebApp', () => {
+    it('Next.js standalone → ssr + realtime websocket', () => {
+        const ctx = createSignalContext(path.join(FIXTURES, 'nextjs-standalone'));
+        const match = detectWebApp(ctx);
+        expect(match).toBeTruthy();
+        expect(match?.projectType).toBe('web-app');
+        expect(match?.partialConfig.renderingStrategy).toBe('ssr');
+        expect(match?.partialConfig.realtime).toBe('websocket');
+        expect(match?.confidence).toBe('high');
+    });
+    it('Vite + index.html → spa', () => {
+        const ctx = createSignalContext(path.join(FIXTURES, 'vite-spa'));
+        const match = detectWebApp(ctx);
+        expect(match).toBeTruthy();
+        expect(match?.partialConfig.renderingStrategy).toBe('spa');
+    });
+    it('Astro output: server → ssr', () => {
+        const ctx = createSignalContext(path.join(FIXTURES, 'astro-server'));
+        const match = detectWebApp(ctx);
+        expect(match).toBeTruthy();
+        expect(match?.partialConfig.renderingStrategy).toBe('ssr');
+    });
+    it('SvelteKit + adapter-vercel → ssr + serverless + session auth', () => {
+        const ctx = createSignalContext(path.join(FIXTURES, 'sveltekit-vercel'));
+        const match = detectWebApp(ctx);
+        expect(match).toBeTruthy();
+        expect(match?.partialConfig.renderingStrategy).toBe('ssr');
+        expect(match?.partialConfig.deployTarget).toBe('serverless');
+        expect(match?.partialConfig.authFlow).toBe('session');
+    });
+    it('Mobile disqualifier: app.json + expo → null', () => {
+        const ctx = createFakeSignalContext({
+            rootEntries: ['package.json', 'app.json'],
+            files: {
+                'package.json': '{"name":"demo","dependencies":{"expo":"50"}}',
+                'app.json': '{}',
+            },
+            packageJson: { name: 'demo', dependencies: { expo: '50' } },
+        });
+        expect(detectWebApp(ctx)).toBeNull();
+    });
+    it('Mobile disqualifier: ios/ + android/ → null', () => {
+        const ctx = createFakeSignalContext({
+            rootEntries: ['package.json'],
+            files: { 'package.json': '{"name":"demo"}' },
+            dirs: ['ios', 'android'],
+            packageJson: { name: 'demo' },
+        });
+        expect(detectWebApp(ctx)).toBeNull();
+    });
+    it('Monorepo with hoisted expo + root next.config: NOT disqualified', () => {
+        const ctx = createFakeSignalContext({
+            rootEntries: ['package.json', 'next.config.mjs'],
+            files: { 'next.config.mjs': 'export default { output: \'standalone\' }' },
+            packageJson: { name: 'monorepo', dependencies: { expo: '50', next: '14', react: '18' } },
+        });
+        expect(detectWebApp(ctx)?.projectType).toBe('web-app');
+    });
+    it('Next.js app/ + pages/ → hybrid', () => {
+        const ctx = createFakeSignalContext({
+            rootEntries: ['package.json', 'next.config.mjs'],
+            files: { 'next.config.mjs': 'export default {}' },
+            dirs: ['app', 'pages'],
+            packageJson: { name: 'demo', dependencies: { next: '14', react: '18' } },
+        });
+        const match = detectWebApp(ctx);
+        expect(match?.partialConfig.renderingStrategy).toBe('hybrid');
+    });
+    it('No framework → null', () => {
+        const ctx = createFakeSignalContext({
+            rootEntries: ['package.json'],
+            files: { 'package.json': '{"name":"demo"}' },
+            packageJson: { name: 'demo', dependencies: { lodash: '4' } },
+        });
+        expect(detectWebApp(ctx)).toBeNull();
+    });
+    it('Default Next.js (no output directive) → ssr', () => {
+        const ctx = createFakeSignalContext({
+            rootEntries: ['package.json', 'next.config.mjs'],
+            files: { 'next.config.mjs': 'export default {}' },
+            packageJson: { name: 'demo', dependencies: { next: '14', react: '18' } },
+        });
+        const match = detectWebApp(ctx);
+        expect(match?.partialConfig.renderingStrategy).toBe('ssr');
+    });
+});
+//# sourceMappingURL=web-app.test.js.map

package/dist/project/detectors/web-app.test.js.map

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

package/dist/types/config.d.ts

@@ -41,6 +41,39 @@ export type BrowserExtensionConfig = z.infer<typeof BrowserExtensionConfigSchema
 export type GameConfig = z.infer<typeof GameConfigSchema>;
 /** Game engine options — derived from GameConfig (single source of truth). */
 export type GameEngine = GameConfig['engine'];
+/**
+ * Discriminated union for detected project configuration (v3.10+).
+ * Replaces the single `gameConfig` field with a polymorphic shape
+ * so any project type's config can flow through the same channel.
+ */
+export type DetectedConfig = {
+    type: 'web-app';
+    config: Partial<WebAppConfig>;
+} | {
+    type: 'backend';
+    config: Partial<BackendConfig>;
+} | {
+    type: 'cli';
+    config: Partial<CliConfig>;
+} | {
+    type: 'library';
+    config: Partial<LibraryConfig>;
+} | {
+    type: 'mobile-app';
+    config: Partial<MobileAppConfig>;
+} | {
+    type: 'data-pipeline';
+    config: Partial<DataPipelineConfig>;
+} | {
+    type: 'ml';
+    config: Partial<MlConfig>;
+} | {
+    type: 'browser-extension';
+    config: Partial<BrowserExtensionConfig>;
+} | {
+    type: 'game';
+    config: Partial<GameConfig>;
+};
 /** Override entry for knowledge injection. */
 export interface KnowledgeOverride {
     append: string[];

package/dist/types/config.d.ts.map

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

package/dist/types/enums.d.ts

@@ -16,7 +16,8 @@ export declare enum ExitCode {
     MissingDependency = 2,
     StateCorruption = 3,
     UserCancellation = 4,
-    BuildError = 5
+    BuildError = 5,
+    Ambiguous = 6
 }
 /** Output mode for CLI. */
 export type OutputMode = 'interactive' | 'json' | 'auto';

package/dist/types/enums.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../src/types/enums.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAA;AAEvD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAE1C,gEAAgE;AAChE,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,OAAO,CAAA;AAE7C,sCAAsC;AACtC,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAA;AAE5E,uCAAuC;AACvC,oBAAY,QAAQ;IAClB,OAAO,IAAI;IACX,eAAe,IAAI;IACnB,iBAAiB,IAAI;IACrB,eAAe,IAAI;IACnB,gBAAgB,IAAI;IACpB,UAAU,IAAI;CACf;AAED,2BAA2B;AAC3B,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,MAAM,GAAG,MAAM,CAAA"}
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../src/types/enums.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAA;AAEvD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAE1C,gEAAgE;AAChE,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,OAAO,CAAA;AAE7C,sCAAsC;AACtC,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAA;AAE5E,uCAAuC;AACvC,oBAAY,QAAQ;IAClB,OAAO,IAAI;IACX,eAAe,IAAI;IACnB,iBAAiB,IAAI;IACrB,eAAe,IAAI;IACnB,gBAAgB,IAAI;IACpB,UAAU,IAAI;IACd,SAAS,IAAI;CACd;AAED,2BAA2B;AAC3B,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,MAAM,GAAG,MAAM,CAAA"}

package/dist/types/enums.js

@@ -7,5 +7,6 @@ export var ExitCode;
     ExitCode[ExitCode["StateCorruption"] = 3] = "StateCorruption";
     ExitCode[ExitCode["UserCancellation"] = 4] = "UserCancellation";
     ExitCode[ExitCode["BuildError"] = 5] = "BuildError";
+    ExitCode[ExitCode["Ambiguous"] = 6] = "Ambiguous";
 })(ExitCode || (ExitCode = {}));
 //# sourceMappingURL=enums.js.map

package/dist/types/enums.js.map

@@ -1 +1 @@
-{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../src/types/enums.ts"],"names":[],"mappings":"AAeA,uCAAuC;AACvC,MAAM,CAAN,IAAY,QAOX;AAPD,WAAY,QAAQ;IAClB,6CAAW,CAAA;IACX,6DAAmB,CAAA;IACnB,iEAAqB,CAAA;IACrB,6DAAmB,CAAA;IACnB,+DAAoB,CAAA;IACpB,mDAAc,CAAA;AAChB,CAAC,EAPW,QAAQ,KAAR,QAAQ,QAOnB"}
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../src/types/enums.ts"],"names":[],"mappings":"AAeA,uCAAuC;AACvC,MAAM,CAAN,IAAY,QAQX;AARD,WAAY,QAAQ;IAClB,6CAAW,CAAA;IACX,6DAAmB,CAAA;IACnB,iEAAqB,CAAA;IACrB,6DAAmB,CAAA;IACnB,+DAAoB,CAAA;IACpB,mDAAc,CAAA;IACd,iDAAa,CAAA;AACf,CAAC,EARW,QAAQ,KAAR,QAAQ,QAQnB"}

package/dist/utils/errors.d.ts

@@ -44,4 +44,11 @@ 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;
+/**
+ * Converts any thrown value into a well-formed ScaffoldError.
+ * - Already-shaped ScaffoldError objects are returned unchanged (strict duck-type check).
+ * - Error instances have their message extracted; stack included in context.
+ * - String/null/undefined/other throws are wrapped with the fallback code.
+ */
+export declare function asScaffoldError(err: unknown, fallbackCode: string, fallbackExit: number): ScaffoldError;
 //# sourceMappingURL=errors.d.ts.map

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

@@ -268,4 +268,42 @@ export function overlayMalformedSection(section, file) {
         context: { section, file },
     };
 }
+/**
+ * Converts any thrown value into a well-formed ScaffoldError.
+ * - Already-shaped ScaffoldError objects are returned unchanged (strict duck-type check).
+ * - Error instances have their message extracted; stack included in context.
+ * - String/null/undefined/other throws are wrapped with the fallback code.
+ */
+export function asScaffoldError(err, fallbackCode, fallbackExit) {
+    // Case 1: Already a fully-formed ScaffoldError
+    if (err !== null && typeof err === 'object') {
+        const o = err;
+        if (typeof o.code === 'string' && typeof o.message === 'string' && typeof o.exitCode === 'number') {
+            return err;
+        }
+    }
+    // Case 2: Error instance
+    if (err instanceof Error) {
+        return {
+            code: fallbackCode,
+            message: err.message || 'Unknown error',
+            exitCode: fallbackExit,
+            context: err.stack
+                ? { stack: err.stack.slice(0, 500), name: err.name }
+                : undefined,
+        };
+    }
+    // Case 3: non-Error throws
+    return {
+        code: fallbackCode,
+        message: typeof err === 'string'
+            ? err
+            : err === null
+                ? 'null error thrown'
+                : err === undefined
+                    ? 'undefined error thrown'
+                    : `Non-Error thrown: ${String(err)}`,
+        exitCode: fallbackExit,
+    };
+}
 //# sourceMappingURL=errors.js.map

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, } 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, asScaffoldError, } from './errors.js';
 describe('error factories — shape', () => {
     it('all error objects have code, message, exitCode', () => {
         const errors = [
@@ -91,4 +91,45 @@ describe('psmAlreadyInProgress', () => {
         expect(err.exitCode).toBe(3);
     });
 });
+describe('asScaffoldError', () => {
+    it('returns an existing ScaffoldError as-is', () => {
+        const err = { code: 'FOO', message: 'bar', exitCode: 1 };
+        expect(asScaffoldError(err, 'FALLBACK', 1)).toBe(err);
+    });
+    it('wraps an Error instance', () => {
+        const err = new Error('boom');
+        const result = asScaffoldError(err, 'FALLBACK', 1);
+        expect(result.code).toBe('FALLBACK');
+        expect(result.message).toBe('boom');
+        expect(result.exitCode).toBe(1);
+        // Context shape: name and truncated stack (guards against type tightening)
+        expect(result.context?.name).toBe('Error');
+        expect(typeof result.context?.stack).toBe('string');
+        expect(result.context.stack.length).toBeLessThanOrEqual(500);
+    });
+    it('wraps an Error instance without a message', () => {
+        const err = new Error('');
+        const result = asScaffoldError(err, 'FALLBACK', 2);
+        expect(result.message).toBe('Unknown error');
+    });
+    it('wraps a string throw', () => {
+        const result = asScaffoldError('oh no', 'FALLBACK', 1);
+        expect(result.code).toBe('FALLBACK');
+        expect(result.message).toBe('oh no');
+    });
+    it('wraps null', () => {
+        const result = asScaffoldError(null, 'FALLBACK', 1);
+        expect(result.message).toContain('null');
+    });
+    it('wraps undefined', () => {
+        const result = asScaffoldError(undefined, 'FALLBACK', 1);
+        expect(result.message).toContain('undefined');
+    });
+    it('rejects partial ScaffoldError duck type (missing exitCode)', () => {
+        const partial = { code: 'FOO', message: 'bar' };
+        const result = asScaffoldError(partial, 'FALLBACK', 3);
+        expect(result.code).toBe('FALLBACK'); // NOT 'FOO' — strict shape check
+        expect(result.exitCode).toBe(3);
+    });
+});
 //# sourceMappingURL=errors.test.js.map