@zigrivers/scaffold 3.9.2 → 3.10.0

package/dist/project/detectors/required-fields.test.js

@@ -0,0 +1,24 @@
+import { describe, it, expect } from 'vitest';
+import { z } from 'zod';
+import { getRequiredFieldsWithoutDefaults } from './required-fields.js';
+import { WebAppConfigSchema, BackendConfigSchema } from '../../config/schema.js';
+describe('getRequiredFieldsWithoutDefaults', () => {
+    it('returns the anchor field for WebAppConfigSchema', () => {
+        const required = getRequiredFieldsWithoutDefaults(WebAppConfigSchema);
+        expect(required).toEqual(['renderingStrategy']);
+    });
+    it('returns the anchor field for BackendConfigSchema', () => {
+        const required = getRequiredFieldsWithoutDefaults(BackendConfigSchema);
+        expect(required).toEqual(['apiStyle']);
+    });
+    it('excludes optional fields', () => {
+        const schema = z.object({
+            a: z.string(),
+            b: z.string().optional(),
+            c: z.string().default('c'),
+        });
+        const required = getRequiredFieldsWithoutDefaults(schema);
+        expect(required).toEqual(['a']);
+    });
+});
+//# sourceMappingURL=required-fields.test.js.map

package/dist/project/detectors/required-fields.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"required-fields.test.js","sourceRoot":"","sources":["../../../src/project/detectors/required-fields.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAA;AACvE,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAEhF,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;IAChD,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,QAAQ,GAAG,gCAAgC,CAAC,kBAAkB,CAAC,CAAA;QACrE,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAA;IACjD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,QAAQ,GAAG,gCAAgC,CAAC,mBAAmB,CAAC,CAAA;QACtE,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;YACtB,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;YACb,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACxB,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;SAC3B,CAAC,CAAA;QACF,MAAM,QAAQ,GAAG,gCAAgC,CAAC,MAAM,CAAC,CAAA;QACzD,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IACjC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/project/detectors/resolve-detection.d.ts

@@ -0,0 +1,18 @@
+import type { DetectionMatch } from './types.js';
+import type { ProjectType } from '../../types/index.js';
+import type { ScaffoldError, ScaffoldWarning } from '../../types/index.js';
+import { type DisambiguateOptions } from './disambiguate.js';
+export interface ResolveDetectionInput {
+    readonly matches: readonly DetectionMatch[];
+    readonly explicitProjectType?: ProjectType;
+    readonly opts: DisambiguateOptions;
+}
+export interface ResolveDetectionResult {
+    readonly chosen: DetectionMatch | null;
+    readonly error?: ScaffoldError;
+    readonly warnings: readonly ScaffoldWarning[];
+}
+/** Synthesize an empty detection match for an explicitly-specified projectType. */
+export declare function synthesizeEmptyMatch(projectType: ProjectType): DetectionMatch;
+export declare function resolveDetection(input: ResolveDetectionInput): Promise<ResolveDetectionResult>;
+//# sourceMappingURL=resolve-detection.d.ts.map

package/dist/project/detectors/resolve-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-detection.d.ts","sourceRoot":"","sources":["../../../src/project/detectors/resolve-detection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE1E,OAAO,EAAgB,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAE1E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAA;IAC3C,QAAQ,CAAC,mBAAmB,CAAC,EAAE,WAAW,CAAA;IAC1C,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAA;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAA;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAA;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAA;CAC9C;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,cAAc,CAO7E;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,sBAAsB,CAAC,CAiLjC"}

package/dist/project/detectors/resolve-detection.js

@@ -0,0 +1,184 @@
+import { ExitCode } from '../../types/enums.js';
+import { disambiguate } from './disambiguate.js';
+/** Synthesize an empty detection match for an explicitly-specified projectType. */
+export function synthesizeEmptyMatch(projectType) {
+    return {
+        projectType,
+        confidence: 'high',
+        partialConfig: {},
+        evidence: [{ signal: 'user-specified', note: '--project-type flag' }],
+    };
+}
+export async function resolveDetection(input) {
+    const warnings = [];
+    // Case G: user passed --project-type → short-circuits Cases A-F
+    if (input.explicitProjectType) {
+        const found = input.matches.find(m => m.projectType === input.explicitProjectType);
+        if (found) {
+            // Promote the detected match — user's explicit choice overrides disambiguation
+            return {
+                chosen: {
+                    ...found,
+                    confidence: 'high',
+                    evidence: [...found.evidence, { signal: 'user-specified', note: '--project-type flag' }],
+                },
+                warnings,
+            };
+        }
+        // Type not detected — synthesize empty match (flags/existing may fill in the rest)
+        return { chosen: synthesizeEmptyMatch(input.explicitProjectType), warnings };
+    }
+    const high = input.matches.filter(m => m.confidence === 'high');
+    const medium = input.matches.filter(m => m.confidence === 'medium');
+    const low = input.matches.filter(m => m.confidence === 'low');
+    // Case A: no matches
+    if (input.matches.length === 0) {
+        return { chosen: null, warnings };
+    }
+    // Case B: single high match
+    if (high.length === 1) {
+        if (medium.length > 0 || low.length > 0) {
+            warnings.push({
+                code: 'ADOPT_SECONDARY_MATCHES',
+                message: `Committed ${high[0].projectType}; runners-up: `
+                    + `${[...medium, ...low].map(m => m.projectType).join(', ')}`,
+                context: {
+                    winner: high[0].projectType,
+                    runners_up: [...medium, ...low].map(m => m.projectType).join(','),
+                },
+            });
+        }
+        return { chosen: high[0], warnings };
+    }
+    // Case C: multiple high matches → disambiguate (pass ALL eligible matches so runners-up are visible)
+    if (high.length >= 2) {
+        const eligible = [...high, ...medium, ...low]; // user sees the full picture
+        // Override acceptLowConfidence: true when runners-up include low tier,
+        // so disambiguate.filterEligible doesn't drop them from the picker
+        const opts = low.length > 0
+            ? { ...input.opts, acceptLowConfidence: true }
+            : input.opts;
+        const result = await disambiguate(eligible, opts);
+        if (result.nonTtyFallback) {
+            warnings.push({
+                code: 'ADOPT_NON_TTY',
+                message: 'Non-TTY environment detected; disambiguation skipped (treated as --auto)',
+            });
+        }
+        if (result.chosen)
+            return { chosen: result.chosen, warnings };
+        if (result.skipReason === 'auto') {
+            return {
+                chosen: null,
+                error: {
+                    code: 'ADOPT_AMBIGUOUS',
+                    message: 'Detection found multiple plausible project types: '
+                        + `${high.map(m => m.projectType).join(', ')}. `
+                        + 'Re-run with --project-type <type> to choose.',
+                    exitCode: ExitCode.Ambiguous,
+                },
+                warnings,
+            };
+        }
+        if (result.skipReason === 'user-cancelled') {
+            // User Ctrl-C is a deliberate cancellation; surface as exit code 4
+            return {
+                chosen: null,
+                error: {
+                    code: 'ADOPT_USER_CANCELLED',
+                    message: 'User cancelled the disambiguation prompt',
+                    exitCode: ExitCode.UserCancellation,
+                },
+                warnings,
+            };
+        }
+        return { chosen: null, warnings };
+    }
+    // Case D: single medium match
+    if (medium.length === 1) {
+        if (low.length > 0) {
+            warnings.push({
+                code: 'ADOPT_SECONDARY_MATCHES',
+                message: `Committed ${medium[0].projectType}; `
+                    + `low-confidence runners-up: ${low.map(m => m.projectType).join(', ')}`,
+            });
+        }
+        return { chosen: medium[0], warnings };
+    }
+    // Case E: multiple medium matches → disambiguate (pass medium + low so runners-up are visible)
+    if (medium.length >= 2) {
+        const eligible = [...medium, ...low];
+        // Override acceptLowConfidence: true when runners-up include low tier
+        const opts = low.length > 0
+            ? { ...input.opts, acceptLowConfidence: true }
+            : input.opts;
+        const result = await disambiguate(eligible, opts);
+        if (result.nonTtyFallback) {
+            warnings.push({
+                code: 'ADOPT_NON_TTY',
+                message: 'Non-TTY environment detected; disambiguation skipped (treated as --auto)',
+            });
+        }
+        if (result.chosen)
+            return { chosen: result.chosen, warnings };
+        if (result.skipReason === 'auto') {
+            return {
+                chosen: null,
+                error: {
+                    code: 'ADOPT_AMBIGUOUS',
+                    message: 'Detection found multiple plausible project types: '
+                        + `${medium.map(m => m.projectType).join(', ')}. `
+                        + 'Re-run with --project-type <type> to choose.',
+                    exitCode: ExitCode.Ambiguous,
+                },
+                warnings,
+            };
+        }
+        if (result.skipReason === 'user-cancelled') {
+            return {
+                chosen: null,
+                error: {
+                    code: 'ADOPT_USER_CANCELLED',
+                    message: 'User cancelled the disambiguation prompt',
+                    exitCode: ExitCode.UserCancellation,
+                },
+                warnings,
+            };
+        }
+        return { chosen: null, warnings };
+    }
+    // Case F: only low matches — route through disambiguate so non-TTY/CI fallback is consistent
+    if (low.length > 0) {
+        const result = await disambiguate(low, { ...input.opts, acceptLowConfidence: true });
+        if (result.nonTtyFallback) {
+            warnings.push({
+                code: 'ADOPT_NON_TTY',
+                message: 'Non-TTY environment detected; low-tier disambiguation skipped',
+            });
+        }
+        if (result.chosen)
+            return { chosen: result.chosen, warnings };
+        if (result.skipReason === 'auto') {
+            // No interactive prompt available — emit ADOPT_LOW_ONLY warning + no commit
+            warnings.push({
+                code: 'ADOPT_LOW_ONLY',
+                message: `Only low-confidence matches found: ${low.map(m => m.projectType).join(', ')}`,
+            });
+            return { chosen: null, warnings };
+        }
+        if (result.skipReason === 'user-cancelled') {
+            return {
+                chosen: null,
+                error: {
+                    code: 'ADOPT_USER_CANCELLED',
+                    message: 'User cancelled the disambiguation prompt',
+                    exitCode: ExitCode.UserCancellation,
+                },
+                warnings,
+            };
+        }
+        return { chosen: null, warnings };
+    }
+    return { chosen: null, warnings };
+}
+//# sourceMappingURL=resolve-detection.js.map

package/dist/project/detectors/resolve-detection.js.map

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

package/dist/project/detectors/resolve-detection.test.d.ts

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

package/dist/project/detectors/resolve-detection.test.d.ts.map

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

package/dist/project/detectors/resolve-detection.test.js

@@ -0,0 +1,158 @@
+/* eslint-disable @typescript-eslint/no-explicit-any -- test mocks need flexible typing */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { resolveDetection, synthesizeEmptyMatch } from './resolve-detection.js';
+vi.mock('./disambiguate.js', () => ({
+    disambiguate: vi.fn(),
+}));
+import { disambiguate } from './disambiguate.js';
+const match = (t, c) => ({
+    projectType: t, confidence: c, partialConfig: {}, evidence: [],
+});
+describe('resolveDetection Cases A-G', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('Case A: no matches → no projectType', async () => {
+        const result = await resolveDetection({
+            matches: [],
+            opts: { interactive: true, acceptLowConfidence: false },
+        });
+        expect(result.chosen).toBeNull();
+        expect(result.error).toBeUndefined();
+    });
+    it('Case B: single high → commit', async () => {
+        const m = match('web-app', 'high');
+        const result = await resolveDetection({
+            matches: [m],
+            opts: { interactive: true, acceptLowConfidence: false },
+        });
+        expect(result.chosen).toBe(m);
+    });
+    it('Case B with runners-up: warns ADOPT_SECONDARY_MATCHES', async () => {
+        const result = await resolveDetection({
+            matches: [match('web-app', 'high'), match('backend', 'medium')],
+            opts: { interactive: true, acceptLowConfidence: false },
+        });
+        expect(result.chosen?.projectType).toBe('web-app');
+        expect(result.warnings.some(w => w.code === 'ADOPT_SECONDARY_MATCHES')).toBe(true);
+    });
+    it('Case C: multiple high → disambiguate is called', async () => {
+        vi.mocked(disambiguate).mockResolvedValueOnce({ chosen: match('backend', 'high') });
+        const result = await resolveDetection({
+            matches: [match('web-app', 'high'), match('backend', 'high')],
+            opts: { interactive: true, acceptLowConfidence: false },
+        });
+        expect(disambiguate).toHaveBeenCalled();
+        expect(result.chosen?.projectType).toBe('backend');
+    });
+    it('Case C under --auto: emits ADOPT_AMBIGUOUS error', async () => {
+        vi.mocked(disambiguate).mockResolvedValueOnce({ chosen: null, skipReason: 'auto' });
+        const result = await resolveDetection({
+            matches: [match('web-app', 'high'), match('backend', 'high')],
+            opts: { interactive: false, acceptLowConfidence: false },
+        });
+        expect(result.chosen).toBeNull();
+        expect(result.error?.code).toBe('ADOPT_AMBIGUOUS');
+        expect(result.error?.exitCode).toBe(6);
+    });
+    it('Case D: single medium → commit', async () => {
+        const m = match('library', 'medium');
+        const result = await resolveDetection({
+            matches: [m],
+            opts: { interactive: true, acceptLowConfidence: false },
+        });
+        expect(result.chosen).toBe(m);
+    });
+    it('Case F: only low interactive → delegates to disambiguate', async () => {
+        vi.mocked(disambiguate).mockResolvedValueOnce({ chosen: match('library', 'low') });
+        const result = await resolveDetection({
+            matches: [match('library', 'low')],
+            opts: { interactive: true, acceptLowConfidence: false },
+        });
+        expect(result.chosen?.projectType).toBe('library');
+    });
+    it('Case F: only low --auto → ADOPT_LOW_ONLY warning + no commit', async () => {
+        vi.mocked(disambiguate).mockResolvedValueOnce({ chosen: null, skipReason: 'auto' });
+        const result = await resolveDetection({
+            matches: [match('library', 'low')],
+            opts: { interactive: false, acceptLowConfidence: false },
+        });
+        expect(result.chosen).toBeNull();
+        expect(result.warnings.some(w => w.code === 'ADOPT_LOW_ONLY')).toBe(true);
+    });
+    it('Case G: explicitProjectType short-circuits detection', async () => {
+        const result = await resolveDetection({
+            matches: [match('backend', 'high')], // Would otherwise pick backend
+            explicitProjectType: 'web-app', // But user said web-app
+            opts: { interactive: true, acceptLowConfidence: false },
+        });
+        expect(result.chosen?.projectType).toBe('web-app');
+        expect(disambiguate).not.toHaveBeenCalled();
+    });
+    it('Case G: explicitProjectType promotes detected match instead of synthesizing empty', async () => {
+        const webMatch = match('web-app', 'medium');
+        // Manually add partialConfig for realism
+        const richMatch = { ...webMatch, partialConfig: { renderingStrategy: 'ssr' } };
+        const result = await resolveDetection({
+            matches: [richMatch, match('backend', 'high')],
+            explicitProjectType: 'web-app',
+            opts: { interactive: true, acceptLowConfidence: false },
+        });
+        expect(result.chosen?.projectType).toBe('web-app');
+        expect(result.chosen?.confidence).toBe('high'); // promoted
+        expect(result.chosen?.partialConfig?.renderingStrategy).toBe('ssr'); // preserved
+        expect(result.chosen?.evidence).toContainEqual(expect.objectContaining({ signal: 'user-specified' }));
+        expect(disambiguate).not.toHaveBeenCalled();
+    });
+    it('Case C user-cancelled → ADOPT_USER_CANCELLED error with exit code 4', async () => {
+        vi.mocked(disambiguate).mockResolvedValueOnce({ chosen: null, skipReason: 'user-cancelled' });
+        const result = await resolveDetection({
+            matches: [match('web-app', 'high'), match('backend', 'high')],
+            opts: { interactive: true, acceptLowConfidence: false },
+        });
+        expect(result.error?.code).toBe('ADOPT_USER_CANCELLED');
+        expect(result.error?.exitCode).toBe(4);
+    });
+    it('Case C non-TTY fallback → ADOPT_NON_TTY warning + ADOPT_AMBIGUOUS error', async () => {
+        vi.mocked(disambiguate).mockResolvedValueOnce({ chosen: null, skipReason: 'auto', nonTtyFallback: true });
+        const result = await resolveDetection({
+            matches: [match('web-app', 'high'), match('backend', 'high')],
+            opts: { interactive: true, acceptLowConfidence: false },
+        });
+        expect(result.warnings.some(w => w.code === 'ADOPT_NON_TTY')).toBe(true);
+        expect(result.error?.code).toBe('ADOPT_AMBIGUOUS');
+    });
+    it('Case E: multiple medium matches → disambiguate called', async () => {
+        vi.mocked(disambiguate).mockResolvedValueOnce({ chosen: match('library', 'medium') });
+        const result = await resolveDetection({
+            matches: [match('library', 'medium'), match('cli', 'medium')],
+            opts: { interactive: true, acceptLowConfidence: false },
+        });
+        expect(disambiguate).toHaveBeenCalled();
+        expect(result.chosen?.projectType).toBe('library');
+    });
+    it('Case B with low runner-up: warns ADOPT_SECONDARY_MATCHES', async () => {
+        const result = await resolveDetection({
+            matches: [match('web-app', 'high'), match('library', 'low')],
+            opts: { interactive: true, acceptLowConfidence: false },
+        });
+        expect(result.chosen?.projectType).toBe('web-app');
+        expect(result.warnings.some(w => w.code === 'ADOPT_SECONDARY_MATCHES')).toBe(true);
+    });
+    it('Case D with low runner-up: warns ADOPT_SECONDARY_MATCHES', async () => {
+        const result = await resolveDetection({
+            matches: [match('backend', 'medium'), match('library', 'low')],
+            opts: { interactive: true, acceptLowConfidence: false },
+        });
+        expect(result.chosen?.projectType).toBe('backend');
+        expect(result.warnings.some(w => w.code === 'ADOPT_SECONDARY_MATCHES')).toBe(true);
+    });
+    it('synthesizeEmptyMatch produces a match with empty partialConfig', () => {
+        const m = synthesizeEmptyMatch('web-app');
+        expect(m.projectType).toBe('web-app');
+        expect(m.confidence).toBe('high');
+        expect(Object.keys(m.partialConfig)).toHaveLength(0);
+        expect(m.evidence[0].signal).toBe('user-specified');
+    });
+});
+//# sourceMappingURL=resolve-detection.test.js.map

package/dist/project/detectors/resolve-detection.test.js.map

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

package/dist/project/detectors/types.d.ts

@@ -0,0 +1,56 @@
+import type { z } from 'zod';
+import type { WebAppConfigSchema, BackendConfigSchema, CliConfigSchema, LibraryConfigSchema, MobileAppConfigSchema, DataPipelineConfigSchema, MlConfigSchema, BrowserExtensionConfigSchema, GameConfigSchema } from '../../config/schema.js';
+export type Confidence = 'high' | 'medium' | 'low';
+export interface DetectionEvidence {
+    readonly signal: string;
+    readonly file?: string;
+    readonly note?: string;
+}
+interface BaseMatch {
+    readonly confidence: Confidence;
+    readonly evidence: readonly DetectionEvidence[];
+}
+export interface WebAppMatch extends BaseMatch {
+    readonly projectType: 'web-app';
+    readonly partialConfig: Partial<z.infer<typeof WebAppConfigSchema>>;
+}
+export interface BackendMatch extends BaseMatch {
+    readonly projectType: 'backend';
+    readonly partialConfig: Partial<z.infer<typeof BackendConfigSchema>>;
+}
+export interface CliMatch extends BaseMatch {
+    readonly projectType: 'cli';
+    readonly partialConfig: Partial<z.infer<typeof CliConfigSchema>>;
+}
+export interface LibraryMatch extends BaseMatch {
+    readonly projectType: 'library';
+    readonly partialConfig: Partial<z.infer<typeof LibraryConfigSchema>>;
+}
+export interface MobileAppMatch extends BaseMatch {
+    readonly projectType: 'mobile-app';
+    readonly partialConfig: Partial<z.infer<typeof MobileAppConfigSchema>>;
+}
+export interface DataPipelineMatch extends BaseMatch {
+    readonly projectType: 'data-pipeline';
+    readonly partialConfig: Partial<z.infer<typeof DataPipelineConfigSchema>>;
+}
+export interface MlMatch extends BaseMatch {
+    readonly projectType: 'ml';
+    readonly partialConfig: Partial<z.infer<typeof MlConfigSchema>>;
+}
+export interface BrowserExtensionMatch extends BaseMatch {
+    readonly projectType: 'browser-extension';
+    readonly partialConfig: Partial<z.infer<typeof BrowserExtensionConfigSchema>>;
+}
+export interface GameMatch extends BaseMatch {
+    readonly projectType: 'game';
+    readonly partialConfig: Partial<z.infer<typeof GameConfigSchema>>;
+}
+export type DetectionMatch = WebAppMatch | BackendMatch | CliMatch | LibraryMatch | MobileAppMatch | DataPipelineMatch | MlMatch | BrowserExtensionMatch | GameMatch;
+export type Detector = (ctx: import('./context.js').SignalContext) => DetectionMatch | null;
+/** Exhaustiveness helper for discriminated-union routing. */
+export declare function assertNever(value: never): never;
+/** Ergonomic evidence builder. */
+export declare function evidence(signal: string, file?: string, note?: string): DetectionEvidence;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/project/detectors/types.d.ts.map

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

package/dist/project/detectors/types.js

@@ -0,0 +1,9 @@
+/** Exhaustiveness helper for discriminated-union routing. */
+export function assertNever(value) {
+    throw new Error(`Unhandled detection match variant: ${JSON.stringify(value)}`);
+}
+/** Ergonomic evidence builder. */
+export function evidence(signal, file, note) {
+    return { signal, file, note };
+}
+//# sourceMappingURL=types.js.map

package/dist/project/detectors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/project/detectors/types.ts"],"names":[],"mappings":"AAgEA,6DAA6D;AAC7D,MAAM,UAAU,WAAW,CAAC,KAAY;IACtC,MAAM,IAAI,KAAK,CAAC,sCAAsC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;AAChF,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,IAAa,EAAE,IAAa;IACnE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AAC/B,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { SignalContext } from './context.js';
+import type { WebAppMatch } from './types.js';
+/**
+ * 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 declare function detectWebApp(ctx: SignalContext): WebAppMatch | null;
+//# sourceMappingURL=web-app.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"web-app.d.ts","sourceRoot":"","sources":["../../../src/project/detectors/web-app.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAgN7C;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,WAAW,GAAG,IAAI,CAoCnE"}