@neuraloom/contracts 0.0.0-stage → 0.1.22

package/dist/schemas/provider-sentinel/provider-sentinel-result.schema.js

@@ -0,0 +1,126 @@
+"use strict";
+/**
+ * Provider Sentinel evidence contract — Real Provider Sentinel for film media spine.
+ * Constitutional: types owned by @neuraloom/contracts only.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProviderSentinelResultSchema = exports.ProviderSentinelDriftSchema = exports.ProviderSentinelApiModeSchema = exports.ProviderSentinelCostControlSchema = exports.ProviderSentinelCleanupResultSchema = exports.ProviderSentinelCleanupModeSchema = exports.ProviderSentinelReadbackChecksSchema = exports.ProviderSentinelGateChecksSchema = exports.ProviderSentinelStorageChecksSchema = exports.ProviderSentinelDatabaseChecksSchema = exports.ProviderSentinelOpenAiCallSchema = exports.ProviderSentinelModeSchema = exports.ProviderSentinelEnvironmentSchema = void 0;
+const zod_1 = require("zod");
+const execution_evidence_schema_1 = require("./execution-evidence.schema");
+const provider_sentinel_common_schema_1 = require("./provider-sentinel-common.schema");
+const image_generation_provider_schema_1 = require("../film/image-generation-provider.schema");
+var provider_sentinel_common_schema_2 = require("./provider-sentinel-common.schema");
+Object.defineProperty(exports, "ProviderSentinelEnvironmentSchema", { enumerable: true, get: function () { return provider_sentinel_common_schema_2.ProviderSentinelEnvironmentSchema; } });
+Object.defineProperty(exports, "ProviderSentinelModeSchema", { enumerable: true, get: function () { return provider_sentinel_common_schema_2.ProviderSentinelModeSchema; } });
+exports.ProviderSentinelOpenAiCallSchema = zod_1.z
+    .object({
+    attempted: zod_1.z.boolean(),
+    succeeded: zod_1.z.boolean(),
+    requestId: zod_1.z.string().optional(),
+    latencyMs: zod_1.z.number().nonnegative().optional(),
+    errorCode: zod_1.z.string().optional(),
+    errorMessage: zod_1.z.string().optional(),
+})
+    .strict();
+exports.ProviderSentinelDatabaseChecksSchema = zod_1.z
+    .object({
+    providerJobInserted: zod_1.z.boolean(),
+    mediaAssetInserted: zod_1.z.boolean(),
+    reviewStateInserted: zod_1.z.boolean(),
+    lineageInserted: zod_1.z.boolean(),
+    skippedReason: zod_1.z.string().optional(),
+})
+    .strict();
+exports.ProviderSentinelStorageChecksSchema = zod_1.z
+    .object({
+    bucket: zod_1.z.string(),
+    objectWritten: zod_1.z.boolean(),
+    objectReadable: zod_1.z.boolean(),
+    objectPath: zod_1.z.string().optional(),
+    skippedReason: zod_1.z.string().optional(),
+})
+    .strict();
+exports.ProviderSentinelGateChecksSchema = zod_1.z
+    .object({
+    trainingSafeGateChecked: zod_1.z.boolean(),
+    trainingSafeGatePassed: zod_1.z.boolean(),
+    approvalRequired: zod_1.z.boolean(),
+})
+    .strict();
+exports.ProviderSentinelReadbackChecksSchema = zod_1.z
+    .object({
+    providerJobReadable: zod_1.z.boolean(),
+    mediaAssetReadable: zod_1.z.boolean(),
+    storageObjectReadable: zod_1.z.boolean(),
+    reviewStateReadable: zod_1.z.boolean(),
+})
+    .strict();
+exports.ProviderSentinelCleanupModeSchema = zod_1.z.enum([
+    'hard_delete',
+    'retain',
+    'skipped',
+]);
+exports.ProviderSentinelCleanupResultSchema = zod_1.z
+    .object({
+    attempted: zod_1.z.boolean(),
+    succeeded: zod_1.z.boolean(),
+    mode: exports.ProviderSentinelCleanupModeSchema.optional(),
+    verified: zod_1.z.boolean().optional(),
+    retainedArtifactIds: zod_1.z.array(zod_1.z.string().uuid()).optional(),
+})
+    .strict();
+exports.ProviderSentinelCostControlSchema = zod_1.z
+    .object({
+    maxAllowedUsd: zod_1.z.number().nonnegative().optional(),
+    estimatedUsd: zod_1.z.number().nonnegative().optional(),
+})
+    .strict();
+exports.ProviderSentinelApiModeSchema = zod_1.z.enum(['images_api', 'responses_image_generation']);
+/**
+ * SDK / API drift detection. Records what we requested vs what the SDK + API
+ * actually returned (model, bytes/MIME, content-types), so a mismatch — e.g.
+ * "DB says webp but bytes are png", or "mock provider ran in live mode" — fails
+ * the sentinel instead of being silently trusted from SDK types.
+ */
+exports.ProviderSentinelDriftSchema = zod_1.z
+    .object({
+    sdkVersion: zod_1.z.string(),
+    apiMode: exports.ProviderSentinelApiModeSchema,
+    requestedModel: zod_1.z.string(),
+    actualModel: zod_1.z.string().optional(),
+    requestedSize: zod_1.z.string().optional(),
+    requestedQuality: zod_1.z.string().optional(),
+    requestedOutputFormat: zod_1.z.string().optional(),
+    actualMime: zod_1.z.string().optional(),
+    storageContentType: zod_1.z.string().optional(),
+    dbAssetContentType: zod_1.z.string().optional(),
+    responseShapeRecognized: zod_1.z.boolean(),
+    mockProviderDetected: zod_1.z.boolean(),
+    driftDetected: zod_1.z.boolean(),
+    driftReasons: zod_1.z.array(zod_1.z.string()).default([]),
+})
+    .strict();
+exports.ProviderSentinelResultSchema = zod_1.z
+    .object({
+    ok: zod_1.z.boolean(),
+    mode: provider_sentinel_common_schema_1.ProviderSentinelModeSchema,
+    environment: provider_sentinel_common_schema_1.ProviderSentinelEnvironmentSchema,
+    provider: image_generation_provider_schema_1.ImageGenerationProviderIdSchema,
+    model: zod_1.z.string(),
+    routeVerified: zod_1.z.boolean(),
+    sentinelRunId: zod_1.z.string().optional(),
+    cleanupManifestPath: zod_1.z.string().optional(),
+    openaiCall: exports.ProviderSentinelOpenAiCallSchema,
+    drift: exports.ProviderSentinelDriftSchema.optional(),
+    database: exports.ProviderSentinelDatabaseChecksSchema,
+    storage: exports.ProviderSentinelStorageChecksSchema,
+    gates: exports.ProviderSentinelGateChecksSchema,
+    readback: exports.ProviderSentinelReadbackChecksSchema,
+    cleanup: exports.ProviderSentinelCleanupResultSchema,
+    costControl: exports.ProviderSentinelCostControlSchema,
+    evidencePath: zod_1.z.string(),
+    notes: zod_1.z.array(zod_1.z.string()).default([]),
+    /** Standardized cross-sentinel proof shape (#1160); optional for film JSON backward compatibility. */
+    executionEvidence: execution_evidence_schema_1.ExecutionEvidenceSchema.optional(),
+})
+    .strict();

package/dist/schemas/provider-sentinel/text-durable-sentinel-config.schema.d.ts

@@ -0,0 +1,51 @@
+/**
+ * OpenAI text / durable-workflow provider sentinel CLI config.
+ */
+import { z } from 'zod';
+export declare const TEXT_DURABLE_SENTINEL_NAMESPACE: {
+    readonly workflow: "openai_text_durable_plan_probe";
+    readonly workflowStepId: "plan";
+    readonly agentRole: "provider_sentinel";
+    readonly promptPrefix: "[provider-sentinel:text-durable] ";
+};
+export declare const TextDurableSentinelConfigSchema: z.ZodObject<{
+    mode: z.ZodEnum<["dry-run", "live-provider", "cleanup"]>;
+    environment: z.ZodEnum<["local", "preview", "prd"]>;
+    liveMode: z.ZodBoolean;
+    cleanup: z.ZodBoolean;
+    postRunCleanup: z.ZodBoolean;
+    retainDays: z.ZodOptional<z.ZodNumber>;
+    projectId: z.ZodString;
+    userId: z.ZodString;
+    maxCostUsd: z.ZodOptional<z.ZodNumber>;
+    openAiApiKeyPresent: z.ZodBoolean;
+    supabaseConfigured: z.ZodBoolean;
+    liveProviderSentinelEnabled: z.ZodBoolean;
+}, "strict", z.ZodTypeAny, {
+    projectId: string;
+    mode: "dry-run" | "live-provider" | "cleanup";
+    environment: "preview" | "prd" | "local";
+    userId: string;
+    cleanup: boolean;
+    liveMode: boolean;
+    postRunCleanup: boolean;
+    openAiApiKeyPresent: boolean;
+    supabaseConfigured: boolean;
+    liveProviderSentinelEnabled: boolean;
+    retainDays?: number | undefined;
+    maxCostUsd?: number | undefined;
+}, {
+    projectId: string;
+    mode: "dry-run" | "live-provider" | "cleanup";
+    environment: "preview" | "prd" | "local";
+    userId: string;
+    cleanup: boolean;
+    liveMode: boolean;
+    postRunCleanup: boolean;
+    openAiApiKeyPresent: boolean;
+    supabaseConfigured: boolean;
+    liveProviderSentinelEnabled: boolean;
+    retainDays?: number | undefined;
+    maxCostUsd?: number | undefined;
+}>;
+export type TextDurableSentinelConfig = z.infer<typeof TextDurableSentinelConfigSchema>;

package/dist/schemas/provider-sentinel/text-durable-sentinel-config.schema.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * OpenAI text / durable-workflow provider sentinel CLI config.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TextDurableSentinelConfigSchema = exports.TEXT_DURABLE_SENTINEL_NAMESPACE = void 0;
+const zod_1 = require("zod");
+const provider_sentinel_common_schema_1 = require("./provider-sentinel-common.schema");
+exports.TEXT_DURABLE_SENTINEL_NAMESPACE = {
+    workflow: 'openai_text_durable_plan_probe',
+    workflowStepId: 'plan',
+    agentRole: 'provider_sentinel',
+    promptPrefix: '[provider-sentinel:text-durable] ',
+};
+exports.TextDurableSentinelConfigSchema = zod_1.z
+    .object({
+    mode: provider_sentinel_common_schema_1.ProviderSentinelModeSchema,
+    environment: provider_sentinel_common_schema_1.ProviderSentinelEnvironmentSchema,
+    liveMode: zod_1.z.boolean(),
+    cleanup: zod_1.z.boolean(),
+    postRunCleanup: zod_1.z.boolean(),
+    retainDays: zod_1.z.number().int().positive().optional(),
+    projectId: zod_1.z.string().uuid(),
+    userId: zod_1.z.string().uuid(),
+    maxCostUsd: zod_1.z.number().positive().optional(),
+    openAiApiKeyPresent: zod_1.z.boolean(),
+    supabaseConfigured: zod_1.z.boolean(),
+    liveProviderSentinelEnabled: zod_1.z.boolean(),
+})
+    .strict();

package/dist/schemas/publication/manuscript-export.schema.d.ts

@@ -0,0 +1,249 @@
+import { z } from "zod";
+export declare const ManuscriptExportFormatSchema: z.ZodEnum<["pdf", "docx", "epub", "md", "zip"]>;
+export declare const ManuscriptExportChapterManifestEntrySchema: z.ZodObject<{
+    chapterNumber: z.ZodNumber;
+    title: z.ZodString;
+    wordCount: z.ZodNumber;
+    guardianScore: z.ZodNumber;
+    artifactId: z.ZodString;
+    sourcesSuggested: z.ZodArray<z.ZodString, "many">;
+    unresolvedEvidenceNeeds: z.ZodArray<z.ZodString, "many">;
+    citationStatus: z.ZodEnum<["linked", "partial", "needs_assignment", "none"]>;
+}, "strict", z.ZodTypeAny, {
+    title: string;
+    artifactId: string;
+    guardianScore: number;
+    chapterNumber: number;
+    wordCount: number;
+    sourcesSuggested: string[];
+    unresolvedEvidenceNeeds: string[];
+    citationStatus: "partial" | "linked" | "none" | "needs_assignment";
+}, {
+    title: string;
+    artifactId: string;
+    guardianScore: number;
+    chapterNumber: number;
+    wordCount: number;
+    sourcesSuggested: string[];
+    unresolvedEvidenceNeeds: string[];
+    citationStatus: "partial" | "linked" | "none" | "needs_assignment";
+}>;
+export declare const ManuscriptExportManifestSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    workflowVariant: z.ZodNullable<z.ZodString>;
+    chapterCount: z.ZodNumber;
+    chapters: z.ZodArray<z.ZodObject<{
+        chapterNumber: z.ZodNumber;
+        title: z.ZodString;
+        wordCount: z.ZodNumber;
+        guardianScore: z.ZodNumber;
+        artifactId: z.ZodString;
+        sourcesSuggested: z.ZodArray<z.ZodString, "many">;
+        unresolvedEvidenceNeeds: z.ZodArray<z.ZodString, "many">;
+        citationStatus: z.ZodEnum<["linked", "partial", "needs_assignment", "none"]>;
+    }, "strict", z.ZodTypeAny, {
+        title: string;
+        artifactId: string;
+        guardianScore: number;
+        chapterNumber: number;
+        wordCount: number;
+        sourcesSuggested: string[];
+        unresolvedEvidenceNeeds: string[];
+        citationStatus: "partial" | "linked" | "none" | "needs_assignment";
+    }, {
+        title: string;
+        artifactId: string;
+        guardianScore: number;
+        chapterNumber: number;
+        wordCount: number;
+        sourcesSuggested: string[];
+        unresolvedEvidenceNeeds: string[];
+        citationStatus: "partial" | "linked" | "none" | "needs_assignment";
+    }>, "many">;
+    exportTimestamp: z.ZodString;
+    sourceArtifactType: z.ZodString;
+    totalWordCount: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    workflowVariant: string | null;
+    projectId: string;
+    chapters: {
+        title: string;
+        artifactId: string;
+        guardianScore: number;
+        chapterNumber: number;
+        wordCount: number;
+        sourcesSuggested: string[];
+        unresolvedEvidenceNeeds: string[];
+        citationStatus: "partial" | "linked" | "none" | "needs_assignment";
+    }[];
+    chapterCount: number;
+    totalWordCount: number;
+    exportTimestamp: string;
+    sourceArtifactType: string;
+}, {
+    workflowVariant: string | null;
+    projectId: string;
+    chapters: {
+        title: string;
+        artifactId: string;
+        guardianScore: number;
+        chapterNumber: number;
+        wordCount: number;
+        sourcesSuggested: string[];
+        unresolvedEvidenceNeeds: string[];
+        citationStatus: "partial" | "linked" | "none" | "needs_assignment";
+    }[];
+    chapterCount: number;
+    totalWordCount: number;
+    exportTimestamp: string;
+    sourceArtifactType: string;
+}>;
+export type ManuscriptExportChapterManifestEntry = z.infer<typeof ManuscriptExportChapterManifestEntrySchema>;
+export type ManuscriptExportManifest = z.infer<typeof ManuscriptExportManifestSchema>;
+export declare const ManuscriptExportRequestSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    format: z.ZodEnum<["pdf", "docx", "epub", "md", "zip"]>;
+}, "strict", z.ZodTypeAny, {
+    projectId: string;
+    format: "md" | "pdf" | "docx" | "epub" | "zip";
+}, {
+    projectId: string;
+    format: "md" | "pdf" | "docx" | "epub" | "zip";
+}>;
+export declare const ManuscriptExportResponseSchema: z.ZodObject<{
+    status: z.ZodEnum<["ready", "not_found", "error"]>;
+    format: z.ZodEnum<["pdf", "docx", "epub", "md", "zip"]>;
+    fileName: z.ZodString;
+    mimeType: z.ZodString;
+    contentBase64: z.ZodNullable<z.ZodString>;
+    generatedAt: z.ZodString;
+    sourceArtifactType: z.ZodNullable<z.ZodString>;
+    wordCount: z.ZodOptional<z.ZodNumber>;
+    manifest: z.ZodOptional<z.ZodObject<{
+        projectId: z.ZodString;
+        workflowVariant: z.ZodNullable<z.ZodString>;
+        chapterCount: z.ZodNumber;
+        chapters: z.ZodArray<z.ZodObject<{
+            chapterNumber: z.ZodNumber;
+            title: z.ZodString;
+            wordCount: z.ZodNumber;
+            guardianScore: z.ZodNumber;
+            artifactId: z.ZodString;
+            sourcesSuggested: z.ZodArray<z.ZodString, "many">;
+            unresolvedEvidenceNeeds: z.ZodArray<z.ZodString, "many">;
+            citationStatus: z.ZodEnum<["linked", "partial", "needs_assignment", "none"]>;
+        }, "strict", z.ZodTypeAny, {
+            title: string;
+            artifactId: string;
+            guardianScore: number;
+            chapterNumber: number;
+            wordCount: number;
+            sourcesSuggested: string[];
+            unresolvedEvidenceNeeds: string[];
+            citationStatus: "partial" | "linked" | "none" | "needs_assignment";
+        }, {
+            title: string;
+            artifactId: string;
+            guardianScore: number;
+            chapterNumber: number;
+            wordCount: number;
+            sourcesSuggested: string[];
+            unresolvedEvidenceNeeds: string[];
+            citationStatus: "partial" | "linked" | "none" | "needs_assignment";
+        }>, "many">;
+        exportTimestamp: z.ZodString;
+        sourceArtifactType: z.ZodString;
+        totalWordCount: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        workflowVariant: string | null;
+        projectId: string;
+        chapters: {
+            title: string;
+            artifactId: string;
+            guardianScore: number;
+            chapterNumber: number;
+            wordCount: number;
+            sourcesSuggested: string[];
+            unresolvedEvidenceNeeds: string[];
+            citationStatus: "partial" | "linked" | "none" | "needs_assignment";
+        }[];
+        chapterCount: number;
+        totalWordCount: number;
+        exportTimestamp: string;
+        sourceArtifactType: string;
+    }, {
+        workflowVariant: string | null;
+        projectId: string;
+        chapters: {
+            title: string;
+            artifactId: string;
+            guardianScore: number;
+            chapterNumber: number;
+            wordCount: number;
+            sourcesSuggested: string[];
+            unresolvedEvidenceNeeds: string[];
+            citationStatus: "partial" | "linked" | "none" | "needs_assignment";
+        }[];
+        chapterCount: number;
+        totalWordCount: number;
+        exportTimestamp: string;
+        sourceArtifactType: string;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    status: "error" | "ready" | "not_found";
+    generatedAt: string;
+    mimeType: string;
+    fileName: string;
+    format: "md" | "pdf" | "docx" | "epub" | "zip";
+    sourceArtifactType: string | null;
+    contentBase64: string | null;
+    manifest?: {
+        workflowVariant: string | null;
+        projectId: string;
+        chapters: {
+            title: string;
+            artifactId: string;
+            guardianScore: number;
+            chapterNumber: number;
+            wordCount: number;
+            sourcesSuggested: string[];
+            unresolvedEvidenceNeeds: string[];
+            citationStatus: "partial" | "linked" | "none" | "needs_assignment";
+        }[];
+        chapterCount: number;
+        totalWordCount: number;
+        exportTimestamp: string;
+        sourceArtifactType: string;
+    } | undefined;
+    wordCount?: number | undefined;
+}, {
+    status: "error" | "ready" | "not_found";
+    generatedAt: string;
+    mimeType: string;
+    fileName: string;
+    format: "md" | "pdf" | "docx" | "epub" | "zip";
+    sourceArtifactType: string | null;
+    contentBase64: string | null;
+    manifest?: {
+        workflowVariant: string | null;
+        projectId: string;
+        chapters: {
+            title: string;
+            artifactId: string;
+            guardianScore: number;
+            chapterNumber: number;
+            wordCount: number;
+            sourcesSuggested: string[];
+            unresolvedEvidenceNeeds: string[];
+            citationStatus: "partial" | "linked" | "none" | "needs_assignment";
+        }[];
+        chapterCount: number;
+        totalWordCount: number;
+        exportTimestamp: string;
+        sourceArtifactType: string;
+    } | undefined;
+    wordCount?: number | undefined;
+}>;
+export type ManuscriptExportFormat = z.infer<typeof ManuscriptExportFormatSchema>;
+export type ManuscriptExportRequest = z.infer<typeof ManuscriptExportRequestSchema>;
+export type ManuscriptExportResponse = z.infer<typeof ManuscriptExportResponseSchema>;

package/dist/schemas/publication/manuscript-export.schema.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ManuscriptExportResponseSchema = exports.ManuscriptExportRequestSchema = exports.ManuscriptExportManifestSchema = exports.ManuscriptExportChapterManifestEntrySchema = exports.ManuscriptExportFormatSchema = void 0;
+const zod_1 = require("zod");
+exports.ManuscriptExportFormatSchema = zod_1.z.enum(["pdf", "docx", "epub", "md", "zip"]);
+exports.ManuscriptExportChapterManifestEntrySchema = zod_1.z
+    .object({
+    chapterNumber: zod_1.z.number().int(),
+    title: zod_1.z.string(),
+    wordCount: zod_1.z.number().int().nonnegative(),
+    guardianScore: zod_1.z.number(),
+    artifactId: zod_1.z.string().uuid(),
+    sourcesSuggested: zod_1.z.array(zod_1.z.string()),
+    unresolvedEvidenceNeeds: zod_1.z.array(zod_1.z.string()),
+    citationStatus: zod_1.z.enum(["linked", "partial", "needs_assignment", "none"]),
+})
+    .strict();
+exports.ManuscriptExportManifestSchema = zod_1.z
+    .object({
+    projectId: zod_1.z.string().uuid(),
+    workflowVariant: zod_1.z.string().nullable(),
+    chapterCount: zod_1.z.number().int().nonnegative(),
+    chapters: zod_1.z.array(exports.ManuscriptExportChapterManifestEntrySchema),
+    exportTimestamp: zod_1.z.string().datetime(),
+    sourceArtifactType: zod_1.z.string(),
+    totalWordCount: zod_1.z.number().int().nonnegative(),
+})
+    .strict();
+exports.ManuscriptExportRequestSchema = zod_1.z
+    .object({
+    projectId: zod_1.z.string().uuid(),
+    format: exports.ManuscriptExportFormatSchema,
+})
+    .strict();
+exports.ManuscriptExportResponseSchema = zod_1.z
+    .object({
+    status: zod_1.z.enum(["ready", "not_found", "error"]),
+    format: exports.ManuscriptExportFormatSchema,
+    fileName: zod_1.z.string().min(1),
+    mimeType: zod_1.z.string().min(1),
+    contentBase64: zod_1.z.string().nullable(),
+    generatedAt: zod_1.z.string().datetime(),
+    sourceArtifactType: zod_1.z.string().nullable(),
+    wordCount: zod_1.z.number().int().nonnegative().optional(),
+    manifest: exports.ManuscriptExportManifestSchema.optional(),
+})
+    .strict();

package/dist/schemas/repo/repo-scan-run.schema.d.ts

@@ -0,0 +1,60 @@
+/**
+ * repo_scan_runs table + scan pipeline helpers (#1397).
+ */
+import { z } from 'zod';
+export declare const RepoScanRunModeSchema: z.ZodEnum<["full", "incremental", "standard", "deep"]>;
+export type RepoScanRunMode = z.infer<typeof RepoScanRunModeSchema>;
+export declare const RepoScanRunStatusSchema: z.ZodEnum<["running", "completed", "failed"]>;
+export type RepoScanRunStatus = z.infer<typeof RepoScanRunStatusSchema>;
+export declare const RepoScanRunRowSchema: z.ZodObject<{
+    id: z.ZodString;
+    project_id: z.ZodString;
+    git_repository_id: z.ZodString;
+    commit_sha: z.ZodString;
+    branch: z.ZodString;
+    scan_mode: z.ZodEnum<["full", "incremental", "standard", "deep"]>;
+    status: z.ZodEnum<["running", "completed", "failed"]>;
+    paths_changed_count: z.ZodNumber;
+    started_at: z.ZodString;
+    completed_at: z.ZodNullable<z.ZodString>;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+    error_message: z.ZodNullable<z.ZodString>;
+    fetched_blob_count: z.ZodNumber;
+    eligible_blob_count: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    status: "running" | "completed" | "failed";
+    created_at: string;
+    completed_at: string | null;
+    branch: string;
+    project_id: string;
+    error_message: string | null;
+    updated_at: string;
+    commit_sha: string;
+    git_repository_id: string;
+    scan_mode: "full" | "standard" | "deep" | "incremental";
+    paths_changed_count: number;
+    started_at: string;
+    fetched_blob_count: number;
+    eligible_blob_count: number;
+}, {
+    id: string;
+    status: "running" | "completed" | "failed";
+    created_at: string;
+    completed_at: string | null;
+    branch: string;
+    project_id: string;
+    error_message: string | null;
+    updated_at: string;
+    commit_sha: string;
+    git_repository_id: string;
+    scan_mode: "full" | "standard" | "deep" | "incremental";
+    paths_changed_count: number;
+    started_at: string;
+    fetched_blob_count: number;
+    eligible_blob_count: number;
+}>;
+export type RepoScanRunRow = z.infer<typeof RepoScanRunRowSchema>;
+/** Canonical knowledge-graph subgraph id for code_reality layer at a commit. */
+export declare function buildCodeRealitySubgraphId(projectId: string, commitSha: string): string;

package/dist/schemas/repo/repo-scan-run.schema.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * repo_scan_runs table + scan pipeline helpers (#1397).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RepoScanRunRowSchema = exports.RepoScanRunStatusSchema = exports.RepoScanRunModeSchema = void 0;
+exports.buildCodeRealitySubgraphId = buildCodeRealitySubgraphId;
+const zod_1 = require("zod");
+exports.RepoScanRunModeSchema = zod_1.z.enum(['full', 'incremental', 'standard', 'deep']);
+exports.RepoScanRunStatusSchema = zod_1.z.enum(['running', 'completed', 'failed']);
+exports.RepoScanRunRowSchema = zod_1.z
+    .object({
+    id: zod_1.z.string().uuid(),
+    project_id: zod_1.z.string().uuid(),
+    git_repository_id: zod_1.z.string().uuid(),
+    commit_sha: zod_1.z.string().min(7),
+    branch: zod_1.z.string().min(1),
+    scan_mode: exports.RepoScanRunModeSchema,
+    status: exports.RepoScanRunStatusSchema,
+    paths_changed_count: zod_1.z.number().int().min(0),
+    started_at: zod_1.z.string().datetime(),
+    completed_at: zod_1.z.string().datetime().nullable(),
+    created_at: zod_1.z.string().datetime(),
+    updated_at: zod_1.z.string().datetime(),
+    error_message: zod_1.z.string().nullable(),
+    fetched_blob_count: zod_1.z.number().int().min(0),
+    eligible_blob_count: zod_1.z.number().int().min(0),
+})
+    .strict();
+/** Canonical knowledge-graph subgraph id for code_reality layer at a commit. */
+function buildCodeRealitySubgraphId(projectId, commitSha) {
+    const sha = commitSha.length > 40 ? commitSha.slice(0, 40) : commitSha;
+    return `${projectId}:code_reality:${sha}`;
+}