@neuraloom/contracts 0.0.0-stage → 0.1.22

package/dist/schemas/workflow/product-realization.schema.d.ts

@@ -0,0 +1,259 @@
+import { z } from "zod";
+/** UX-facing realization reason codes (subset of ProductRealizationCheckId). */
+export declare const ImplementRealizationReasonCodeSchema: z.ZodEnum<["missing_domain_file", "missing_api_route", "missing_ui_route", "missing_tests", "missing_traceability"]>;
+export type ImplementRealizationReasonCode = z.infer<typeof ImplementRealizationReasonCodeSchema>;
+export type ImplementRealisationEvidence = {
+    traceabilityRowCount?: number | undefined;
+    traceabilitySpecFilePresent?: boolean | undefined;
+    domainApiRouteCount?: number | undefined;
+    domainUiPageCount?: number | undefined;
+    packageJsonPresent?: boolean | undefined;
+    nextScaffoldPresent?: boolean | undefined;
+    apiHealthRoutePresent?: boolean | undefined;
+    /** Sprint A: separate layout.tsx / page.tsx presence tracking. */
+    nextLayoutPresent?: boolean | undefined;
+    nextRootPagePresent?: boolean | undefined;
+    /** Sprint A: orphaned parent route detection. */
+    orphanedParentRouteCount?: number | undefined;
+    orphanedParentRoutes?: string[] | undefined;
+    /** Sprint A: CSS import presence in layout.tsx. */
+    layoutCssImportPresent?: boolean | undefined;
+    /** Sprint B: routes declared in spec/route-manifest.json that have no backing page file. */
+    routeManifestMissingRoutes?: string[] | undefined;
+    /** Sprint B: internal nav link targets that have no corresponding page in the extracted manifest. */
+    navLinkViolations?: string[] | undefined;
+    /** Sprint C: root page.tsx has non-trivial content (not an empty shell). */
+    rootRouteHasContent?: boolean | undefined;
+    /** Sprint C: API route files that export no HTTP handler method. */
+    apiRouteMissingHandlers?: string[] | undefined;
+    /** Sprint C: CSS import paths in layout.tsx that have no matching file in the tree. */
+    cssImportMissingFiles?: string[] | undefined;
+    /** Sprint C: login page is missing a form/input when auth is detected. */
+    authPageMissingForm?: boolean | undefined;
+    /** Sprint E: package manager detected from package.json `packageManager` field. */
+    packageManager?: 'pnpm' | 'npm' | 'yarn' | 'bun' | 'unknown' | undefined;
+    /** Sprint E: number of third-party imports missing from package.json dependencies. */
+    packageDependencyMissingCount?: number | undefined;
+    /** Sprint E: list of missing third-party dependency declarations. */
+    packageDependencyMissing?: Array<{
+        importer: string;
+        specifier: string;
+        expectedPackage: string;
+        sourceType: 'ts' | 'tsx' | 'js' | 'jsx' | 'css' | 'config';
+    }> | undefined;
+    /** Sprint E: CSS toolchain detection result. */
+    cssToolchain?: {
+        detected: 'tailwind-v4' | 'tailwind-v3' | 'css-modules' | 'plain-css' | 'unknown';
+        globalsCssPresent: boolean;
+        tailwindCssImportPresent: boolean;
+        tailwindPackagePresent: boolean;
+        tailwindPostcssPackagePresent: boolean;
+        postcssConfigPresent: boolean;
+        postcssConfigUsesTailwindPlugin: boolean;
+    } | undefined;
+    /** Sprint E: lockfile detection and staleness result. */
+    lockfile?: {
+        present: boolean;
+        packageManager: 'pnpm' | 'npm' | 'yarn' | 'bun' | 'unknown';
+        appearsStale: boolean;
+        missingPackages: string[];
+    } | undefined;
+};
+export declare const ImplementRealisationEvidenceSchema: z.ZodType<ImplementRealisationEvidence>;
+/** Maps SSOT ProductRealizationCheckId subset to canonical MS02 reason codes. */
+export declare function canonicalReasonForProductRealizationCheck(checkId: string): ImplementRealizationReasonCode | undefined;
+export declare const IMPLEMENT_REALIZATION_REASON_HEADLINE: Record<ImplementRealizationReasonCode, string>;
+export declare const ImplementReadinessPathParamsSchema: z.ZodObject<{
+    projectId: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    projectId: string;
+}, {
+    projectId: string;
+}>;
+export type ImplementReadinessPathParams = {
+    projectId: string;
+};
+/** GET /implement/readiness — path-only SSOT for validation hooks. */
+export declare const ImplementReadinessRequestSchema: z.ZodType<ImplementReadinessPathParams>;
+export type ImplementReadinessRequest = ImplementReadinessPathParams;
+export declare const ProductRealizationCheckIdSchema: z.ZodEnum<["PACKAGE_JSON_PRESENT", "NEXT_ROOT_PAGE_MISSING", "NEXT_SCAFFOLD_PRESENT", "API_HEALTH_ROUTE", "DOMAIN_API_ROUTE_MIN_1", "DOMAIN_UI_ROUTE_MIN_1", "DOMAIN_MODEL_OR_SCHEMA_MIN_1", "TEST_FILE_MIN_1", "TRACEABILITY_ROWS_MIN_1", "ORPHANED_PARENT_ROUTE", "LAYOUT_CSS_IMPORT", "ROUTE_MANIFEST_COVERAGE", "NAV_LINK_INTEGRITY", "ROOT_ROUTE_RUNTIME_BEHAVIOR", "API_ROUTE_HANDLER_PRESENT", "CSS_IMPORT_TARGET_EXISTS", "AUTH_PAGE_MINIMAL_FORM", "PACKAGE_DEPENDENCY_MISSING", "CSS_TOOLCHAIN_INCOMPLETE", "LOCKFILE_STALE_OR_MISSING", "PACKAGE_IMPORT_RESOLUTION", "POSTCSS_CONFIG_MISSING"]>;
+export declare const ProductRealizationInputSchema: z.ZodObject<{
+    repoFiles: z.ZodArray<z.ZodString, "many">;
+    traceabilityRowCount: z.ZodNumber;
+    /**
+     * Sprint A: optional file contents for content-aware checks (e.g. CSS import in layout.tsx).
+     * When absent, content-dependent checks are skipped rather than hard-failed.
+     */
+    repoFileContents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        content: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        content: string;
+    }, {
+        path: string;
+        content: string;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    traceabilityRowCount: number;
+    repoFiles: string[];
+    repoFileContents?: {
+        path: string;
+        content: string;
+    }[] | undefined;
+}, {
+    traceabilityRowCount: number;
+    repoFiles: string[];
+    repoFileContents?: {
+        path: string;
+        content: string;
+    }[] | undefined;
+}>;
+export declare const ProductRealizationCheckResultSchema: z.ZodObject<{
+    id: z.ZodEnum<["PACKAGE_JSON_PRESENT", "NEXT_ROOT_PAGE_MISSING", "NEXT_SCAFFOLD_PRESENT", "API_HEALTH_ROUTE", "DOMAIN_API_ROUTE_MIN_1", "DOMAIN_UI_ROUTE_MIN_1", "DOMAIN_MODEL_OR_SCHEMA_MIN_1", "TEST_FILE_MIN_1", "TRACEABILITY_ROWS_MIN_1", "ORPHANED_PARENT_ROUTE", "LAYOUT_CSS_IMPORT", "ROUTE_MANIFEST_COVERAGE", "NAV_LINK_INTEGRITY", "ROOT_ROUTE_RUNTIME_BEHAVIOR", "API_ROUTE_HANDLER_PRESENT", "CSS_IMPORT_TARGET_EXISTS", "AUTH_PAGE_MINIMAL_FORM", "PACKAGE_DEPENDENCY_MISSING", "CSS_TOOLCHAIN_INCOMPLETE", "LOCKFILE_STALE_OR_MISSING", "PACKAGE_IMPORT_RESOLUTION", "POSTCSS_CONFIG_MISSING"]>;
+    passed: z.ZodBoolean;
+    evidence: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodEnum<["missing_domain_file", "missing_api_route", "missing_ui_route", "missing_tests", "missing_traceability"]>>;
+}, "strict", z.ZodTypeAny, {
+    id: "DOMAIN_MODEL_OR_SCHEMA_MIN_1" | "DOMAIN_API_ROUTE_MIN_1" | "DOMAIN_UI_ROUTE_MIN_1" | "TEST_FILE_MIN_1" | "TRACEABILITY_ROWS_MIN_1" | "ORPHANED_PARENT_ROUTE" | "LAYOUT_CSS_IMPORT" | "ROUTE_MANIFEST_COVERAGE" | "ROOT_ROUTE_RUNTIME_BEHAVIOR" | "API_ROUTE_HANDLER_PRESENT" | "CSS_IMPORT_TARGET_EXISTS" | "AUTH_PAGE_MINIMAL_FORM" | "PACKAGE_DEPENDENCY_MISSING" | "CSS_TOOLCHAIN_INCOMPLETE" | "LOCKFILE_STALE_OR_MISSING" | "PACKAGE_IMPORT_RESOLUTION" | "POSTCSS_CONFIG_MISSING" | "NEXT_ROOT_PAGE_MISSING" | "NAV_LINK_INTEGRITY" | "PACKAGE_JSON_PRESENT" | "NEXT_SCAFFOLD_PRESENT" | "API_HEALTH_ROUTE";
+    passed: boolean;
+    evidence?: string | undefined;
+    reason?: "missing_domain_file" | "missing_api_route" | "missing_ui_route" | "missing_tests" | "missing_traceability" | undefined;
+}, {
+    id: "DOMAIN_MODEL_OR_SCHEMA_MIN_1" | "DOMAIN_API_ROUTE_MIN_1" | "DOMAIN_UI_ROUTE_MIN_1" | "TEST_FILE_MIN_1" | "TRACEABILITY_ROWS_MIN_1" | "ORPHANED_PARENT_ROUTE" | "LAYOUT_CSS_IMPORT" | "ROUTE_MANIFEST_COVERAGE" | "ROOT_ROUTE_RUNTIME_BEHAVIOR" | "API_ROUTE_HANDLER_PRESENT" | "CSS_IMPORT_TARGET_EXISTS" | "AUTH_PAGE_MINIMAL_FORM" | "PACKAGE_DEPENDENCY_MISSING" | "CSS_TOOLCHAIN_INCOMPLETE" | "LOCKFILE_STALE_OR_MISSING" | "PACKAGE_IMPORT_RESOLUTION" | "POSTCSS_CONFIG_MISSING" | "NEXT_ROOT_PAGE_MISSING" | "NAV_LINK_INTEGRITY" | "PACKAGE_JSON_PRESENT" | "NEXT_SCAFFOLD_PRESENT" | "API_HEALTH_ROUTE";
+    passed: boolean;
+    evidence?: string | undefined;
+    reason?: "missing_domain_file" | "missing_api_route" | "missing_ui_route" | "missing_tests" | "missing_traceability" | undefined;
+}>;
+export declare const ProductRealizationLabelSchema: z.ZodEnum<["Product realized", "Scaffold deployed — product not implemented", "Engineering preview accepted — product implementation incomplete", "Product realization incomplete — blocks internal beta, not engineering preview"]>;
+export declare const ProductRealizationOutputSchema: z.ZodObject<{
+    passed: z.ZodBoolean;
+    checks: z.ZodArray<z.ZodObject<{
+        id: z.ZodEnum<["PACKAGE_JSON_PRESENT", "NEXT_ROOT_PAGE_MISSING", "NEXT_SCAFFOLD_PRESENT", "API_HEALTH_ROUTE", "DOMAIN_API_ROUTE_MIN_1", "DOMAIN_UI_ROUTE_MIN_1", "DOMAIN_MODEL_OR_SCHEMA_MIN_1", "TEST_FILE_MIN_1", "TRACEABILITY_ROWS_MIN_1", "ORPHANED_PARENT_ROUTE", "LAYOUT_CSS_IMPORT", "ROUTE_MANIFEST_COVERAGE", "NAV_LINK_INTEGRITY", "ROOT_ROUTE_RUNTIME_BEHAVIOR", "API_ROUTE_HANDLER_PRESENT", "CSS_IMPORT_TARGET_EXISTS", "AUTH_PAGE_MINIMAL_FORM", "PACKAGE_DEPENDENCY_MISSING", "CSS_TOOLCHAIN_INCOMPLETE", "LOCKFILE_STALE_OR_MISSING", "PACKAGE_IMPORT_RESOLUTION", "POSTCSS_CONFIG_MISSING"]>;
+        passed: z.ZodBoolean;
+        evidence: z.ZodOptional<z.ZodString>;
+        reason: z.ZodOptional<z.ZodEnum<["missing_domain_file", "missing_api_route", "missing_ui_route", "missing_tests", "missing_traceability"]>>;
+    }, "strict", z.ZodTypeAny, {
+        id: "DOMAIN_MODEL_OR_SCHEMA_MIN_1" | "DOMAIN_API_ROUTE_MIN_1" | "DOMAIN_UI_ROUTE_MIN_1" | "TEST_FILE_MIN_1" | "TRACEABILITY_ROWS_MIN_1" | "ORPHANED_PARENT_ROUTE" | "LAYOUT_CSS_IMPORT" | "ROUTE_MANIFEST_COVERAGE" | "ROOT_ROUTE_RUNTIME_BEHAVIOR" | "API_ROUTE_HANDLER_PRESENT" | "CSS_IMPORT_TARGET_EXISTS" | "AUTH_PAGE_MINIMAL_FORM" | "PACKAGE_DEPENDENCY_MISSING" | "CSS_TOOLCHAIN_INCOMPLETE" | "LOCKFILE_STALE_OR_MISSING" | "PACKAGE_IMPORT_RESOLUTION" | "POSTCSS_CONFIG_MISSING" | "NEXT_ROOT_PAGE_MISSING" | "NAV_LINK_INTEGRITY" | "PACKAGE_JSON_PRESENT" | "NEXT_SCAFFOLD_PRESENT" | "API_HEALTH_ROUTE";
+        passed: boolean;
+        evidence?: string | undefined;
+        reason?: "missing_domain_file" | "missing_api_route" | "missing_ui_route" | "missing_tests" | "missing_traceability" | undefined;
+    }, {
+        id: "DOMAIN_MODEL_OR_SCHEMA_MIN_1" | "DOMAIN_API_ROUTE_MIN_1" | "DOMAIN_UI_ROUTE_MIN_1" | "TEST_FILE_MIN_1" | "TRACEABILITY_ROWS_MIN_1" | "ORPHANED_PARENT_ROUTE" | "LAYOUT_CSS_IMPORT" | "ROUTE_MANIFEST_COVERAGE" | "ROOT_ROUTE_RUNTIME_BEHAVIOR" | "API_ROUTE_HANDLER_PRESENT" | "CSS_IMPORT_TARGET_EXISTS" | "AUTH_PAGE_MINIMAL_FORM" | "PACKAGE_DEPENDENCY_MISSING" | "CSS_TOOLCHAIN_INCOMPLETE" | "LOCKFILE_STALE_OR_MISSING" | "PACKAGE_IMPORT_RESOLUTION" | "POSTCSS_CONFIG_MISSING" | "NEXT_ROOT_PAGE_MISSING" | "NAV_LINK_INTEGRITY" | "PACKAGE_JSON_PRESENT" | "NEXT_SCAFFOLD_PRESENT" | "API_HEALTH_ROUTE";
+        passed: boolean;
+        evidence?: string | undefined;
+        reason?: "missing_domain_file" | "missing_api_route" | "missing_ui_route" | "missing_tests" | "missing_traceability" | undefined;
+    }>, "many">;
+    failedCheckIds: z.ZodArray<z.ZodEnum<["PACKAGE_JSON_PRESENT", "NEXT_ROOT_PAGE_MISSING", "NEXT_SCAFFOLD_PRESENT", "API_HEALTH_ROUTE", "DOMAIN_API_ROUTE_MIN_1", "DOMAIN_UI_ROUTE_MIN_1", "DOMAIN_MODEL_OR_SCHEMA_MIN_1", "TEST_FILE_MIN_1", "TRACEABILITY_ROWS_MIN_1", "ORPHANED_PARENT_ROUTE", "LAYOUT_CSS_IMPORT", "ROUTE_MANIFEST_COVERAGE", "NAV_LINK_INTEGRITY", "ROOT_ROUTE_RUNTIME_BEHAVIOR", "API_ROUTE_HANDLER_PRESENT", "CSS_IMPORT_TARGET_EXISTS", "AUTH_PAGE_MINIMAL_FORM", "PACKAGE_DEPENDENCY_MISSING", "CSS_TOOLCHAIN_INCOMPLETE", "LOCKFILE_STALE_OR_MISSING", "PACKAGE_IMPORT_RESOLUTION", "POSTCSS_CONFIG_MISSING"]>, "many">;
+    label: z.ZodEnum<["Product realized", "Scaffold deployed — product not implemented", "Engineering preview accepted — product implementation incomplete", "Product realization incomplete — blocks internal beta, not engineering preview"]>;
+    blockers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        evidence: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        message: string;
+        evidence?: string | undefined;
+    }, {
+        code: string;
+        message: string;
+        evidence?: string | undefined;
+    }>, "many">>;
+    repoFileCount: z.ZodOptional<z.ZodNumber>;
+    evaluatedAt: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    label: "Product realized" | "Scaffold deployed — product not implemented" | "Engineering preview accepted — product implementation incomplete" | "Product realization incomplete — blocks internal beta, not engineering preview";
+    passed: boolean;
+    checks: {
+        id: "DOMAIN_MODEL_OR_SCHEMA_MIN_1" | "DOMAIN_API_ROUTE_MIN_1" | "DOMAIN_UI_ROUTE_MIN_1" | "TEST_FILE_MIN_1" | "TRACEABILITY_ROWS_MIN_1" | "ORPHANED_PARENT_ROUTE" | "LAYOUT_CSS_IMPORT" | "ROUTE_MANIFEST_COVERAGE" | "ROOT_ROUTE_RUNTIME_BEHAVIOR" | "API_ROUTE_HANDLER_PRESENT" | "CSS_IMPORT_TARGET_EXISTS" | "AUTH_PAGE_MINIMAL_FORM" | "PACKAGE_DEPENDENCY_MISSING" | "CSS_TOOLCHAIN_INCOMPLETE" | "LOCKFILE_STALE_OR_MISSING" | "PACKAGE_IMPORT_RESOLUTION" | "POSTCSS_CONFIG_MISSING" | "NEXT_ROOT_PAGE_MISSING" | "NAV_LINK_INTEGRITY" | "PACKAGE_JSON_PRESENT" | "NEXT_SCAFFOLD_PRESENT" | "API_HEALTH_ROUTE";
+        passed: boolean;
+        evidence?: string | undefined;
+        reason?: "missing_domain_file" | "missing_api_route" | "missing_ui_route" | "missing_tests" | "missing_traceability" | undefined;
+    }[];
+    failedCheckIds: ("DOMAIN_MODEL_OR_SCHEMA_MIN_1" | "DOMAIN_API_ROUTE_MIN_1" | "DOMAIN_UI_ROUTE_MIN_1" | "TEST_FILE_MIN_1" | "TRACEABILITY_ROWS_MIN_1" | "ORPHANED_PARENT_ROUTE" | "LAYOUT_CSS_IMPORT" | "ROUTE_MANIFEST_COVERAGE" | "ROOT_ROUTE_RUNTIME_BEHAVIOR" | "API_ROUTE_HANDLER_PRESENT" | "CSS_IMPORT_TARGET_EXISTS" | "AUTH_PAGE_MINIMAL_FORM" | "PACKAGE_DEPENDENCY_MISSING" | "CSS_TOOLCHAIN_INCOMPLETE" | "LOCKFILE_STALE_OR_MISSING" | "PACKAGE_IMPORT_RESOLUTION" | "POSTCSS_CONFIG_MISSING" | "NEXT_ROOT_PAGE_MISSING" | "NAV_LINK_INTEGRITY" | "PACKAGE_JSON_PRESENT" | "NEXT_SCAFFOLD_PRESENT" | "API_HEALTH_ROUTE")[];
+    source?: string | undefined;
+    blockers?: {
+        code: string;
+        message: string;
+        evidence?: string | undefined;
+    }[] | undefined;
+    evaluatedAt?: string | undefined;
+    repoFileCount?: number | undefined;
+}, {
+    label: "Product realized" | "Scaffold deployed — product not implemented" | "Engineering preview accepted — product implementation incomplete" | "Product realization incomplete — blocks internal beta, not engineering preview";
+    passed: boolean;
+    checks: {
+        id: "DOMAIN_MODEL_OR_SCHEMA_MIN_1" | "DOMAIN_API_ROUTE_MIN_1" | "DOMAIN_UI_ROUTE_MIN_1" | "TEST_FILE_MIN_1" | "TRACEABILITY_ROWS_MIN_1" | "ORPHANED_PARENT_ROUTE" | "LAYOUT_CSS_IMPORT" | "ROUTE_MANIFEST_COVERAGE" | "ROOT_ROUTE_RUNTIME_BEHAVIOR" | "API_ROUTE_HANDLER_PRESENT" | "CSS_IMPORT_TARGET_EXISTS" | "AUTH_PAGE_MINIMAL_FORM" | "PACKAGE_DEPENDENCY_MISSING" | "CSS_TOOLCHAIN_INCOMPLETE" | "LOCKFILE_STALE_OR_MISSING" | "PACKAGE_IMPORT_RESOLUTION" | "POSTCSS_CONFIG_MISSING" | "NEXT_ROOT_PAGE_MISSING" | "NAV_LINK_INTEGRITY" | "PACKAGE_JSON_PRESENT" | "NEXT_SCAFFOLD_PRESENT" | "API_HEALTH_ROUTE";
+        passed: boolean;
+        evidence?: string | undefined;
+        reason?: "missing_domain_file" | "missing_api_route" | "missing_ui_route" | "missing_tests" | "missing_traceability" | undefined;
+    }[];
+    failedCheckIds: ("DOMAIN_MODEL_OR_SCHEMA_MIN_1" | "DOMAIN_API_ROUTE_MIN_1" | "DOMAIN_UI_ROUTE_MIN_1" | "TEST_FILE_MIN_1" | "TRACEABILITY_ROWS_MIN_1" | "ORPHANED_PARENT_ROUTE" | "LAYOUT_CSS_IMPORT" | "ROUTE_MANIFEST_COVERAGE" | "ROOT_ROUTE_RUNTIME_BEHAVIOR" | "API_ROUTE_HANDLER_PRESENT" | "CSS_IMPORT_TARGET_EXISTS" | "AUTH_PAGE_MINIMAL_FORM" | "PACKAGE_DEPENDENCY_MISSING" | "CSS_TOOLCHAIN_INCOMPLETE" | "LOCKFILE_STALE_OR_MISSING" | "PACKAGE_IMPORT_RESOLUTION" | "POSTCSS_CONFIG_MISSING" | "NEXT_ROOT_PAGE_MISSING" | "NAV_LINK_INTEGRITY" | "PACKAGE_JSON_PRESENT" | "NEXT_SCAFFOLD_PRESENT" | "API_HEALTH_ROUTE")[];
+    source?: string | undefined;
+    blockers?: {
+        code: string;
+        message: string;
+        evidence?: string | undefined;
+    }[] | undefined;
+    evaluatedAt?: string | undefined;
+    repoFileCount?: number | undefined;
+}>;
+export type ProductRealizationCheckId = z.infer<typeof ProductRealizationCheckIdSchema>;
+export type ProductRealizationInput = z.infer<typeof ProductRealizationInputSchema>;
+export type ProductRealizationCheckResult = z.infer<typeof ProductRealizationCheckResultSchema>;
+export type ProductRealizationOutput = z.infer<typeof ProductRealizationOutputSchema>;
+/** Blocking items for Implement / patch validation surfaces (deterministic predicate SSOT IDs). */
+export declare const ProductRealisationGateBlockerSchema: z.ZodObject<{
+    code: z.ZodEnum<["PACKAGE_JSON_PRESENT", "NEXT_ROOT_PAGE_MISSING", "NEXT_SCAFFOLD_PRESENT", "API_HEALTH_ROUTE", "DOMAIN_API_ROUTE_MIN_1", "DOMAIN_UI_ROUTE_MIN_1", "DOMAIN_MODEL_OR_SCHEMA_MIN_1", "TEST_FILE_MIN_1", "TRACEABILITY_ROWS_MIN_1", "ORPHANED_PARENT_ROUTE", "LAYOUT_CSS_IMPORT", "ROUTE_MANIFEST_COVERAGE", "NAV_LINK_INTEGRITY", "ROOT_ROUTE_RUNTIME_BEHAVIOR", "API_ROUTE_HANDLER_PRESENT", "CSS_IMPORT_TARGET_EXISTS", "AUTH_PAGE_MINIMAL_FORM", "PACKAGE_DEPENDENCY_MISSING", "CSS_TOOLCHAIN_INCOMPLETE", "LOCKFILE_STALE_OR_MISSING", "PACKAGE_IMPORT_RESOLUTION", "POSTCSS_CONFIG_MISSING"]>;
+    message: z.ZodString;
+    reason: z.ZodOptional<z.ZodEnum<["missing_domain_file", "missing_api_route", "missing_ui_route", "missing_tests", "missing_traceability"]>>;
+    evidence: z.ZodOptional<z.ZodType<ImplementRealisationEvidence, z.ZodTypeDef, ImplementRealisationEvidence>>;
+}, "strict", z.ZodTypeAny, {
+    code: "DOMAIN_MODEL_OR_SCHEMA_MIN_1" | "DOMAIN_API_ROUTE_MIN_1" | "DOMAIN_UI_ROUTE_MIN_1" | "TEST_FILE_MIN_1" | "TRACEABILITY_ROWS_MIN_1" | "ORPHANED_PARENT_ROUTE" | "LAYOUT_CSS_IMPORT" | "ROUTE_MANIFEST_COVERAGE" | "ROOT_ROUTE_RUNTIME_BEHAVIOR" | "API_ROUTE_HANDLER_PRESENT" | "CSS_IMPORT_TARGET_EXISTS" | "AUTH_PAGE_MINIMAL_FORM" | "PACKAGE_DEPENDENCY_MISSING" | "CSS_TOOLCHAIN_INCOMPLETE" | "LOCKFILE_STALE_OR_MISSING" | "PACKAGE_IMPORT_RESOLUTION" | "POSTCSS_CONFIG_MISSING" | "NEXT_ROOT_PAGE_MISSING" | "NAV_LINK_INTEGRITY" | "PACKAGE_JSON_PRESENT" | "NEXT_SCAFFOLD_PRESENT" | "API_HEALTH_ROUTE";
+    message: string;
+    evidence?: ImplementRealisationEvidence | undefined;
+    reason?: "missing_domain_file" | "missing_api_route" | "missing_ui_route" | "missing_tests" | "missing_traceability" | undefined;
+}, {
+    code: "DOMAIN_MODEL_OR_SCHEMA_MIN_1" | "DOMAIN_API_ROUTE_MIN_1" | "DOMAIN_UI_ROUTE_MIN_1" | "TEST_FILE_MIN_1" | "TRACEABILITY_ROWS_MIN_1" | "ORPHANED_PARENT_ROUTE" | "LAYOUT_CSS_IMPORT" | "ROUTE_MANIFEST_COVERAGE" | "ROOT_ROUTE_RUNTIME_BEHAVIOR" | "API_ROUTE_HANDLER_PRESENT" | "CSS_IMPORT_TARGET_EXISTS" | "AUTH_PAGE_MINIMAL_FORM" | "PACKAGE_DEPENDENCY_MISSING" | "CSS_TOOLCHAIN_INCOMPLETE" | "LOCKFILE_STALE_OR_MISSING" | "PACKAGE_IMPORT_RESOLUTION" | "POSTCSS_CONFIG_MISSING" | "NEXT_ROOT_PAGE_MISSING" | "NAV_LINK_INTEGRITY" | "PACKAGE_JSON_PRESENT" | "NEXT_SCAFFOLD_PRESENT" | "API_HEALTH_ROUTE";
+    message: string;
+    evidence?: ImplementRealisationEvidence | undefined;
+    reason?: "missing_domain_file" | "missing_api_route" | "missing_ui_route" | "missing_tests" | "missing_traceability" | undefined;
+}>;
+export type ProductRealisationGateBlocker = z.infer<typeof ProductRealisationGateBlockerSchema>;
+export declare const ProductRealisationGateResultSchema: z.ZodObject<{
+    ready: z.ZodBoolean;
+    blockers: z.ZodArray<z.ZodObject<{
+        code: z.ZodEnum<["PACKAGE_JSON_PRESENT", "NEXT_ROOT_PAGE_MISSING", "NEXT_SCAFFOLD_PRESENT", "API_HEALTH_ROUTE", "DOMAIN_API_ROUTE_MIN_1", "DOMAIN_UI_ROUTE_MIN_1", "DOMAIN_MODEL_OR_SCHEMA_MIN_1", "TEST_FILE_MIN_1", "TRACEABILITY_ROWS_MIN_1", "ORPHANED_PARENT_ROUTE", "LAYOUT_CSS_IMPORT", "ROUTE_MANIFEST_COVERAGE", "NAV_LINK_INTEGRITY", "ROOT_ROUTE_RUNTIME_BEHAVIOR", "API_ROUTE_HANDLER_PRESENT", "CSS_IMPORT_TARGET_EXISTS", "AUTH_PAGE_MINIMAL_FORM", "PACKAGE_DEPENDENCY_MISSING", "CSS_TOOLCHAIN_INCOMPLETE", "LOCKFILE_STALE_OR_MISSING", "PACKAGE_IMPORT_RESOLUTION", "POSTCSS_CONFIG_MISSING"]>;
+        message: z.ZodString;
+        reason: z.ZodOptional<z.ZodEnum<["missing_domain_file", "missing_api_route", "missing_ui_route", "missing_tests", "missing_traceability"]>>;
+        evidence: z.ZodOptional<z.ZodType<ImplementRealisationEvidence, z.ZodTypeDef, ImplementRealisationEvidence>>;
+    }, "strict", z.ZodTypeAny, {
+        code: "DOMAIN_MODEL_OR_SCHEMA_MIN_1" | "DOMAIN_API_ROUTE_MIN_1" | "DOMAIN_UI_ROUTE_MIN_1" | "TEST_FILE_MIN_1" | "TRACEABILITY_ROWS_MIN_1" | "ORPHANED_PARENT_ROUTE" | "LAYOUT_CSS_IMPORT" | "ROUTE_MANIFEST_COVERAGE" | "ROOT_ROUTE_RUNTIME_BEHAVIOR" | "API_ROUTE_HANDLER_PRESENT" | "CSS_IMPORT_TARGET_EXISTS" | "AUTH_PAGE_MINIMAL_FORM" | "PACKAGE_DEPENDENCY_MISSING" | "CSS_TOOLCHAIN_INCOMPLETE" | "LOCKFILE_STALE_OR_MISSING" | "PACKAGE_IMPORT_RESOLUTION" | "POSTCSS_CONFIG_MISSING" | "NEXT_ROOT_PAGE_MISSING" | "NAV_LINK_INTEGRITY" | "PACKAGE_JSON_PRESENT" | "NEXT_SCAFFOLD_PRESENT" | "API_HEALTH_ROUTE";
+        message: string;
+        evidence?: ImplementRealisationEvidence | undefined;
+        reason?: "missing_domain_file" | "missing_api_route" | "missing_ui_route" | "missing_tests" | "missing_traceability" | undefined;
+    }, {
+        code: "DOMAIN_MODEL_OR_SCHEMA_MIN_1" | "DOMAIN_API_ROUTE_MIN_1" | "DOMAIN_UI_ROUTE_MIN_1" | "TEST_FILE_MIN_1" | "TRACEABILITY_ROWS_MIN_1" | "ORPHANED_PARENT_ROUTE" | "LAYOUT_CSS_IMPORT" | "ROUTE_MANIFEST_COVERAGE" | "ROOT_ROUTE_RUNTIME_BEHAVIOR" | "API_ROUTE_HANDLER_PRESENT" | "CSS_IMPORT_TARGET_EXISTS" | "AUTH_PAGE_MINIMAL_FORM" | "PACKAGE_DEPENDENCY_MISSING" | "CSS_TOOLCHAIN_INCOMPLETE" | "LOCKFILE_STALE_OR_MISSING" | "PACKAGE_IMPORT_RESOLUTION" | "POSTCSS_CONFIG_MISSING" | "NEXT_ROOT_PAGE_MISSING" | "NAV_LINK_INTEGRITY" | "PACKAGE_JSON_PRESENT" | "NEXT_SCAFFOLD_PRESENT" | "API_HEALTH_ROUTE";
+        message: string;
+        evidence?: ImplementRealisationEvidence | undefined;
+        reason?: "missing_domain_file" | "missing_api_route" | "missing_ui_route" | "missing_tests" | "missing_traceability" | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    ready: boolean;
+    blockers: {
+        code: "DOMAIN_MODEL_OR_SCHEMA_MIN_1" | "DOMAIN_API_ROUTE_MIN_1" | "DOMAIN_UI_ROUTE_MIN_1" | "TEST_FILE_MIN_1" | "TRACEABILITY_ROWS_MIN_1" | "ORPHANED_PARENT_ROUTE" | "LAYOUT_CSS_IMPORT" | "ROUTE_MANIFEST_COVERAGE" | "ROOT_ROUTE_RUNTIME_BEHAVIOR" | "API_ROUTE_HANDLER_PRESENT" | "CSS_IMPORT_TARGET_EXISTS" | "AUTH_PAGE_MINIMAL_FORM" | "PACKAGE_DEPENDENCY_MISSING" | "CSS_TOOLCHAIN_INCOMPLETE" | "LOCKFILE_STALE_OR_MISSING" | "PACKAGE_IMPORT_RESOLUTION" | "POSTCSS_CONFIG_MISSING" | "NEXT_ROOT_PAGE_MISSING" | "NAV_LINK_INTEGRITY" | "PACKAGE_JSON_PRESENT" | "NEXT_SCAFFOLD_PRESENT" | "API_HEALTH_ROUTE";
+        message: string;
+        evidence?: ImplementRealisationEvidence | undefined;
+        reason?: "missing_domain_file" | "missing_api_route" | "missing_ui_route" | "missing_tests" | "missing_traceability" | undefined;
+    }[];
+}, {
+    ready: boolean;
+    blockers: {
+        code: "DOMAIN_MODEL_OR_SCHEMA_MIN_1" | "DOMAIN_API_ROUTE_MIN_1" | "DOMAIN_UI_ROUTE_MIN_1" | "TEST_FILE_MIN_1" | "TRACEABILITY_ROWS_MIN_1" | "ORPHANED_PARENT_ROUTE" | "LAYOUT_CSS_IMPORT" | "ROUTE_MANIFEST_COVERAGE" | "ROOT_ROUTE_RUNTIME_BEHAVIOR" | "API_ROUTE_HANDLER_PRESENT" | "CSS_IMPORT_TARGET_EXISTS" | "AUTH_PAGE_MINIMAL_FORM" | "PACKAGE_DEPENDENCY_MISSING" | "CSS_TOOLCHAIN_INCOMPLETE" | "LOCKFILE_STALE_OR_MISSING" | "PACKAGE_IMPORT_RESOLUTION" | "POSTCSS_CONFIG_MISSING" | "NEXT_ROOT_PAGE_MISSING" | "NAV_LINK_INTEGRITY" | "PACKAGE_JSON_PRESENT" | "NEXT_SCAFFOLD_PRESENT" | "API_HEALTH_ROUTE";
+        message: string;
+        evidence?: ImplementRealisationEvidence | undefined;
+        reason?: "missing_domain_file" | "missing_api_route" | "missing_ui_route" | "missing_tests" | "missing_traceability" | undefined;
+    }[];
+}>;
+export type ProductRealisationGateResult = z.infer<typeof ProductRealisationGateResultSchema>;

package/dist/schemas/workflow/product-realization.schema.js

@@ -0,0 +1,207 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProductRealisationGateResultSchema = exports.ProductRealisationGateBlockerSchema = exports.ProductRealizationOutputSchema = exports.ProductRealizationLabelSchema = exports.ProductRealizationCheckResultSchema = exports.ProductRealizationInputSchema = exports.ProductRealizationCheckIdSchema = exports.ImplementReadinessRequestSchema = exports.ImplementReadinessPathParamsSchema = exports.IMPLEMENT_REALIZATION_REASON_HEADLINE = exports.ImplementRealisationEvidenceSchema = exports.ImplementRealizationReasonCodeSchema = void 0;
+exports.canonicalReasonForProductRealizationCheck = canonicalReasonForProductRealizationCheck;
+const zod_1 = require("zod");
+/** UX-facing realization reason codes (subset of ProductRealizationCheckId). */
+exports.ImplementRealizationReasonCodeSchema = zod_1.z.enum([
+    "missing_domain_file",
+    "missing_api_route",
+    "missing_ui_route",
+    "missing_tests",
+    "missing_traceability",
+]);
+exports.ImplementRealisationEvidenceSchema = zod_1.z
+    .object({
+    traceabilityRowCount: zod_1.z.number().int().nonnegative().optional(),
+    traceabilitySpecFilePresent: zod_1.z.boolean().optional(),
+    domainApiRouteCount: zod_1.z.number().int().nonnegative().optional(),
+    domainUiPageCount: zod_1.z.number().int().nonnegative().optional(),
+    packageJsonPresent: zod_1.z.boolean().optional(),
+    nextScaffoldPresent: zod_1.z.boolean().optional(),
+    apiHealthRoutePresent: zod_1.z.boolean().optional(),
+    nextLayoutPresent: zod_1.z.boolean().optional(),
+    nextRootPagePresent: zod_1.z.boolean().optional(),
+    orphanedParentRouteCount: zod_1.z.number().int().nonnegative().optional(),
+    orphanedParentRoutes: zod_1.z.array(zod_1.z.string()).optional(),
+    layoutCssImportPresent: zod_1.z.boolean().optional(),
+    routeManifestMissingRoutes: zod_1.z.array(zod_1.z.string()).optional(),
+    navLinkViolations: zod_1.z.array(zod_1.z.string()).optional(),
+    rootRouteHasContent: zod_1.z.boolean().optional(),
+    apiRouteMissingHandlers: zod_1.z.array(zod_1.z.string()).optional(),
+    cssImportMissingFiles: zod_1.z.array(zod_1.z.string()).optional(),
+    authPageMissingForm: zod_1.z.boolean().optional(),
+    packageManager: zod_1.z.enum(['pnpm', 'npm', 'yarn', 'bun', 'unknown']).optional(),
+    packageDependencyMissingCount: zod_1.z.number().int().nonnegative().optional(),
+    packageDependencyMissing: zod_1.z.array(zod_1.z.object({
+        importer: zod_1.z.string(),
+        specifier: zod_1.z.string(),
+        expectedPackage: zod_1.z.string(),
+        sourceType: zod_1.z.enum(['ts', 'tsx', 'js', 'jsx', 'css', 'config']),
+    })).optional(),
+    cssToolchain: zod_1.z.object({
+        detected: zod_1.z.enum(['tailwind-v4', 'tailwind-v3', 'css-modules', 'plain-css', 'unknown']),
+        globalsCssPresent: zod_1.z.boolean(),
+        tailwindCssImportPresent: zod_1.z.boolean(),
+        tailwindPackagePresent: zod_1.z.boolean(),
+        tailwindPostcssPackagePresent: zod_1.z.boolean(),
+        postcssConfigPresent: zod_1.z.boolean(),
+        postcssConfigUsesTailwindPlugin: zod_1.z.boolean(),
+    }).optional(),
+    lockfile: zod_1.z.object({
+        present: zod_1.z.boolean(),
+        packageManager: zod_1.z.enum(['pnpm', 'npm', 'yarn', 'bun', 'unknown']),
+        appearsStale: zod_1.z.boolean(),
+        missingPackages: zod_1.z.array(zod_1.z.string()),
+    }).optional(),
+})
+    .strict();
+/** Maps SSOT ProductRealizationCheckId subset to canonical MS02 reason codes. */
+function canonicalReasonForProductRealizationCheck(checkId) {
+    switch (checkId) {
+        case "DOMAIN_MODEL_OR_SCHEMA_MIN_1":
+            return "missing_domain_file";
+        case "DOMAIN_API_ROUTE_MIN_1":
+            return "missing_api_route";
+        case "DOMAIN_UI_ROUTE_MIN_1":
+            return "missing_ui_route";
+        case "TEST_FILE_MIN_1":
+            return "missing_tests";
+        case "TRACEABILITY_ROWS_MIN_1":
+            return "missing_traceability";
+        case "ORPHANED_PARENT_ROUTE":
+            return "missing_ui_route";
+        case "LAYOUT_CSS_IMPORT":
+            return "missing_ui_route";
+        case "ROUTE_MANIFEST_COVERAGE":
+            return "missing_ui_route";
+        case "ROOT_ROUTE_RUNTIME_BEHAVIOR":
+            return "missing_ui_route";
+        case "API_ROUTE_HANDLER_PRESENT":
+            return "missing_api_route";
+        case "CSS_IMPORT_TARGET_EXISTS":
+            return "missing_ui_route";
+        case "AUTH_PAGE_MINIMAL_FORM":
+            return "missing_ui_route";
+        case "PACKAGE_DEPENDENCY_MISSING":
+            return "missing_domain_file";
+        case "CSS_TOOLCHAIN_INCOMPLETE":
+            return "missing_domain_file";
+        case "LOCKFILE_STALE_OR_MISSING":
+            return "missing_domain_file";
+        case "PACKAGE_IMPORT_RESOLUTION":
+            return "missing_domain_file";
+        case "POSTCSS_CONFIG_MISSING":
+            return "missing_domain_file";
+        case "NEXT_ROOT_PAGE_MISSING":
+            return "missing_ui_route";
+        case "NAV_LINK_INTEGRITY":
+            return "missing_ui_route";
+        default:
+            return undefined;
+    }
+}
+exports.IMPLEMENT_REALIZATION_REASON_HEADLINE = {
+    missing_domain_file: "Domain model or schema file missing",
+    missing_api_route: "Non-health App Router API route missing",
+    missing_ui_route: "Non-root App Router page missing",
+    missing_tests: "Automated test file missing",
+    missing_traceability: "Traceability missing (DB rows or spec/neuraloom-traceability.json)",
+};
+exports.ImplementReadinessPathParamsSchema = zod_1.z
+    .object({
+    projectId: zod_1.z.string().uuid(),
+})
+    .strict();
+/** GET /implement/readiness — path-only SSOT for validation hooks. */
+exports.ImplementReadinessRequestSchema = exports.ImplementReadinessPathParamsSchema;
+exports.ProductRealizationCheckIdSchema = zod_1.z.enum([
+    "PACKAGE_JSON_PRESENT",
+    "NEXT_ROOT_PAGE_MISSING",
+    "NEXT_SCAFFOLD_PRESENT",
+    "API_HEALTH_ROUTE",
+    "DOMAIN_API_ROUTE_MIN_1",
+    "DOMAIN_UI_ROUTE_MIN_1",
+    "DOMAIN_MODEL_OR_SCHEMA_MIN_1",
+    "TEST_FILE_MIN_1",
+    "TRACEABILITY_ROWS_MIN_1",
+    /** Sprint A: child route exists but parent segment has no page.tsx. */
+    "ORPHANED_PARENT_ROUTE",
+    /** Sprint A: src/app/layout.tsx does not import a global stylesheet. */
+    "LAYOUT_CSS_IMPORT",
+    /** Sprint B: spec/route-manifest.json declares a required route that has no backing page.tsx. */
+    "ROUTE_MANIFEST_COVERAGE",
+    "NAV_LINK_INTEGRITY",
+    /** Sprint C: root page.tsx is non-trivial (has redirect/JSX/content). */
+    "ROOT_ROUTE_RUNTIME_BEHAVIOR",
+    /** Sprint C: all API route.ts files export at least one HTTP handler. */
+    "API_ROUTE_HANDLER_PRESENT",
+    /** Sprint C: CSS files imported in layout.tsx actually exist in file tree. */
+    "CSS_IMPORT_TARGET_EXISTS",
+    /** Sprint C: login page has form/input when auth is detected. */
+    "AUTH_PAGE_MINIMAL_FORM",
+    /** Sprint E: all third-party imports are declared in package.json dependencies. */
+    "PACKAGE_DEPENDENCY_MISSING",
+    /** Sprint E: Tailwind v4 CSS toolchain is complete (tailwindcss + @tailwindcss/postcss present). */
+    "CSS_TOOLCHAIN_INCOMPLETE",
+    /** Sprint E: pnpm-lock.yaml or equivalent lockfile is present and appears current. */
+    "LOCKFILE_STALE_OR_MISSING",
+    /** Sprint E: non-CSS source files have all imports resolvable to declared packages. */
+    "PACKAGE_IMPORT_RESOLUTION",
+    /** Sprint E: postcss.config.* is present when Tailwind v4 is detected. */
+    "POSTCSS_CONFIG_MISSING",
+]);
+exports.ProductRealizationInputSchema = zod_1.z
+    .object({
+    repoFiles: zod_1.z.array(zod_1.z.string()),
+    traceabilityRowCount: zod_1.z.number().int().min(0),
+    /**
+     * Sprint A: optional file contents for content-aware checks (e.g. CSS import in layout.tsx).
+     * When absent, content-dependent checks are skipped rather than hard-failed.
+     */
+    repoFileContents: zod_1.z
+        .array(zod_1.z.object({ path: zod_1.z.string(), content: zod_1.z.string() }))
+        .optional(),
+})
+    .strict();
+exports.ProductRealizationCheckResultSchema = zod_1.z
+    .object({
+    id: exports.ProductRealizationCheckIdSchema,
+    passed: zod_1.z.boolean(),
+    evidence: zod_1.z.string().optional(),
+    reason: exports.ImplementRealizationReasonCodeSchema.optional(),
+})
+    .strict();
+exports.ProductRealizationLabelSchema = zod_1.z.enum([
+    "Product realized",
+    "Scaffold deployed — product not implemented",
+    "Engineering preview accepted — product implementation incomplete",
+    "Product realization incomplete — blocks internal beta, not engineering preview",
+]);
+exports.ProductRealizationOutputSchema = zod_1.z
+    .object({
+    passed: zod_1.z.boolean(),
+    checks: zod_1.z.array(exports.ProductRealizationCheckResultSchema),
+    failedCheckIds: zod_1.z.array(exports.ProductRealizationCheckIdSchema),
+    label: exports.ProductRealizationLabelSchema,
+    blockers: zod_1.z.array(zod_1.z.object({ code: zod_1.z.string(), message: zod_1.z.string(), evidence: zod_1.z.string().optional() })).optional(),
+    repoFileCount: zod_1.z.number().int().nonnegative().optional(),
+    evaluatedAt: zod_1.z.string().optional(),
+    source: zod_1.z.string().optional(),
+})
+    .strict();
+/** Blocking items for Implement / patch validation surfaces (deterministic predicate SSOT IDs). */
+exports.ProductRealisationGateBlockerSchema = zod_1.z
+    .object({
+    code: exports.ProductRealizationCheckIdSchema,
+    message: zod_1.z.string(),
+    reason: exports.ImplementRealizationReasonCodeSchema.optional(),
+    evidence: exports.ImplementRealisationEvidenceSchema.optional(),
+})
+    .strict();
+exports.ProductRealisationGateResultSchema = zod_1.z
+    .object({
+    ready: zod_1.z.boolean(),
+    blockers: zod_1.z.array(exports.ProductRealisationGateBlockerSchema),
+})
+    .strict();