@neuraloom/contracts 0.0.0-stage → 0.1.23

package/dist/schemas/workflow/workflow-doctor.schema.js

@@ -0,0 +1,141 @@
+"use strict";
+/**
+ * WorkflowDoctorReport — schema for the /workflow/doctor API route and page.
+ *
+ * Shows per-step: expected stages (from registry), actual artifact status in the DB,
+ * missing stages, extra stages, wrong-variant artifacts, stale artifacts,
+ * and completion result summary.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowDoctorReportSchema = exports.WorkflowDoctorClosureSchema = exports.WorkflowDoctorAuditFindingSchema = exports.WorkflowDoctorCompletionBlockerSchema = exports.WorkflowDoctorCompletionBlockerKindSchema = exports.WorkflowDoctorStepArtifactCoverageSchema = exports.WorkflowDoctorChannelSummarySchema = exports.WorkflowDoctorMappingHintSchema = exports.WorkflowDoctorMappingHintKindSchema = exports.WorkflowDoctorStepReportSchema = exports.WorkflowDoctorStageReportSchema = exports.WorkflowDoctorStageStatusSchema = void 0;
+const zod_1 = require("zod");
+exports.WorkflowDoctorStageStatusSchema = zod_1.z.enum([
+    'present_accepted',
+    'present_pending',
+    'present_rejected',
+    'missing',
+    'extra',
+    'wrong_variant',
+    'stale',
+]);
+exports.WorkflowDoctorStageReportSchema = zod_1.z.object({
+    stageId: zod_1.z.string(),
+    label: zod_1.z.string(),
+    status: exports.WorkflowDoctorStageStatusSchema,
+    /** Artifact ID from the DB, if found. */
+    artifactId: zod_1.z.string().uuid().optional(),
+    /** Guardian score of the latest artifact, if found. */
+    guardianScore: zod_1.z.number().int().min(0).max(100).nullable().optional(),
+    /** workflow_variant on the artifact row (may differ from project resolved variant). */
+    artifactVariant: zod_1.z.string().nullable().optional(),
+    /** True if this stage was expected by the registry. */
+    expected: zod_1.z.boolean(),
+    /** True if this stage was found in the DB but not declared in the registry for this variant. */
+    extra: zod_1.z.boolean(),
+    /** True if source artifact has changed since this artifact was created. */
+    stale: zod_1.z.boolean(),
+});
+exports.WorkflowDoctorStepReportSchema = zod_1.z.object({
+    stepId: zod_1.z.string(),
+    label: zod_1.z.string(),
+    stages: zod_1.z.array(exports.WorkflowDoctorStageReportSchema),
+    missingCount: zod_1.z.number().int().min(0),
+    extraCount: zod_1.z.number().int().min(0),
+    wrongVariantCount: zod_1.z.number().int().min(0),
+    staleCount: zod_1.z.number().int().min(0),
+    /** True if the registry completion rule is satisfied. */
+    completionSatisfied: zod_1.z.boolean(),
+    /** Registry completion mode for this step. */
+    completionMode: zod_1.z.enum(['all_required_stages', 'final_artifact', 'any_of_stages', 'custom']),
+});
+/** Workflow Doctor — closure visibility (variant spine vs persisted artifacts). */
+exports.WorkflowDoctorMappingHintKindSchema = zod_1.z.enum([
+    'explicit_variant_resolved',
+    'legacy_project_kind_mapped',
+    'legacy_kind_field_mapped',
+    'fallback_default_variant',
+    'invalid_explicit_variant_coerced',
+    'unknown_legacy_kind_defaulted',
+]);
+exports.WorkflowDoctorMappingHintSchema = zod_1.z.object({
+    kind: exports.WorkflowDoctorMappingHintKindSchema,
+    message: zod_1.z.string(),
+});
+exports.WorkflowDoctorChannelSummarySchema = zod_1.z.object({
+    variant: zod_1.z.string(),
+    family: zod_1.z.string(),
+    channelLabel: zod_1.z.string(),
+    channelDescription: zod_1.z.string(),
+    workflowVersion: zod_1.z.string(),
+    projectKind: zod_1.z.string(),
+    /** Active progress denominator — operator nav for software_app, else non-deprecated channel steps. */
+    stepCount: zod_1.z.number().int().min(0),
+    experimentalStepIds: zod_1.z.array(zod_1.z.string()),
+    /** software_app only: WORKFLOW_STEPS operator nav count (dual-spine honesty). */
+    operatorNavStepCount: zod_1.z.number().int().min(0).optional(),
+    /** Channel registry steps excluded from operator progress (e.g. scan, architecture-control). */
+    deprecatedChannelStepIds: zod_1.z.array(zod_1.z.string()).optional(),
+});
+exports.WorkflowDoctorStepArtifactCoverageSchema = zod_1.z.object({
+    stepId: zod_1.z.string(),
+    label: zod_1.z.string(),
+    /** Expected registry stages for this step. */
+    expectedStages: zod_1.z.number().int().min(0),
+    presentAccepted: zod_1.z.number().int().min(0),
+    presentPending: zod_1.z.number().int().min(0),
+    presentRejected: zod_1.z.number().int().min(0),
+    missing: zod_1.z.number().int().min(0),
+    wrongVariant: zod_1.z.number().int().min(0),
+    stale: zod_1.z.number().int().min(0),
+    extraInDb: zod_1.z.number().int().min(0),
+    completionSatisfied: zod_1.z.boolean(),
+    completionMode: zod_1.z.enum(['all_required_stages', 'final_artifact', 'any_of_stages', 'custom']),
+});
+exports.WorkflowDoctorCompletionBlockerKindSchema = zod_1.z.enum([
+    'missing_upstream_input',
+    'incomplete_step_outputs',
+    'wrong_variant_artifact',
+    'stale_artifact',
+]);
+exports.WorkflowDoctorCompletionBlockerSchema = zod_1.z.object({
+    blockerKind: exports.WorkflowDoctorCompletionBlockerKindSchema,
+    stepId: zod_1.z.string(),
+    stepLabel: zod_1.z.string(),
+    message: zod_1.z.string(),
+    remediationHint: zod_1.z.string(),
+});
+/** Static pathway audit finding — registry integrity (Doctor UI + CI sibling checks). */
+exports.WorkflowDoctorAuditFindingSchema = zod_1.z.object({
+    variant: zod_1.z.string(),
+    stepId: zod_1.z.string(),
+    severity: zod_1.z.enum(['critical', 'major', 'minor', 'info']),
+    category: zod_1.z.string(),
+    title: zod_1.z.string(),
+    recommendedFix: zod_1.z.string(),
+});
+exports.WorkflowDoctorClosureSchema = zod_1.z.object({
+    channelSummary: exports.WorkflowDoctorChannelSummarySchema,
+    mappingHints: zod_1.z.array(exports.WorkflowDoctorMappingHintSchema),
+    stepArtifactCoverage: zod_1.z.array(exports.WorkflowDoctorStepArtifactCoverageSchema),
+    completionBlockers: zod_1.z.array(exports.WorkflowDoctorCompletionBlockerSchema),
+    /** True when there are no completion blockers (gates + outputs). */
+    closureReady: zod_1.z.boolean(),
+});
+exports.WorkflowDoctorReportSchema = zod_1.z.object({
+    projectId: zod_1.z.string().uuid(),
+    resolvedVariant: zod_1.z.string(),
+    workflowFamily: zod_1.z.string(),
+    generatedAt: zod_1.z.string().datetime(),
+    steps: zod_1.z.array(exports.WorkflowDoctorStepReportSchema),
+    /** True if ALL steps have completionSatisfied = true. */
+    overallHealthy: zod_1.z.boolean(),
+    /** Summary counts. */
+    totalMissing: zod_1.z.number().int().min(0),
+    totalExtra: zod_1.z.number().int().min(0),
+    totalWrongVariant: zod_1.z.number().int().min(0),
+    totalStale: zod_1.z.number().int().min(0),
+    /** Closure visibility — channel spine, coverage, blockers, mapping hints (#943). */
+    closure: exports.WorkflowDoctorClosureSchema,
+    /** Static registry pathway checks (no DB). */
+    auditFindings: zod_1.z.array(exports.WorkflowDoctorAuditFindingSchema).optional(),
+});

package/dist/schemas/workflow/workflow-evidence.schema.d.ts

@@ -0,0 +1,67 @@
+import { z } from "zod";
+export declare const WorkflowEvidenceConflictCodeSchema: z.ZodEnum<["completion_vs_release_gate", "release_gate_vs_completion", "completion_vs_deployments_gate", "deployments_gate_vs_completion"]>;
+export type WorkflowEvidenceConflictCode = z.infer<typeof WorkflowEvidenceConflictCodeSchema>;
+export declare const WorkflowEvidenceConflictSchema: z.ZodObject<{
+    stepId: z.ZodString;
+    code: z.ZodEnum<["completion_vs_release_gate", "release_gate_vs_completion", "completion_vs_deployments_gate", "deployments_gate_vs_completion"]>;
+    message: z.ZodString;
+    completionSays: z.ZodEnum<["complete", "incomplete"]>;
+    gateSays: z.ZodEnum<["satisfied", "unsatisfied"]>;
+}, "strip", z.ZodTypeAny, {
+    code: "completion_vs_release_gate" | "release_gate_vs_completion" | "completion_vs_deployments_gate" | "deployments_gate_vs_completion";
+    message: string;
+    stepId: string;
+    completionSays: "incomplete" | "complete";
+    gateSays: "satisfied" | "unsatisfied";
+}, {
+    code: "completion_vs_release_gate" | "release_gate_vs_completion" | "completion_vs_deployments_gate" | "deployments_gate_vs_completion";
+    message: string;
+    stepId: string;
+    completionSays: "incomplete" | "complete";
+    gateSays: "satisfied" | "unsatisfied";
+}>;
+export type WorkflowEvidenceConflict = z.infer<typeof WorkflowEvidenceConflictSchema>;
+export declare const WorkflowEvidenceSummarySchema: z.ZodObject<{
+    conflicts: z.ZodArray<z.ZodObject<{
+        stepId: z.ZodString;
+        code: z.ZodEnum<["completion_vs_release_gate", "release_gate_vs_completion", "completion_vs_deployments_gate", "deployments_gate_vs_completion"]>;
+        message: z.ZodString;
+        completionSays: z.ZodEnum<["complete", "incomplete"]>;
+        gateSays: z.ZodEnum<["satisfied", "unsatisfied"]>;
+    }, "strip", z.ZodTypeAny, {
+        code: "completion_vs_release_gate" | "release_gate_vs_completion" | "completion_vs_deployments_gate" | "deployments_gate_vs_completion";
+        message: string;
+        stepId: string;
+        completionSays: "incomplete" | "complete";
+        gateSays: "satisfied" | "unsatisfied";
+    }, {
+        code: "completion_vs_release_gate" | "release_gate_vs_completion" | "completion_vs_deployments_gate" | "deployments_gate_vs_completion";
+        message: string;
+        stepId: string;
+        completionSays: "incomplete" | "complete";
+        gateSays: "satisfied" | "unsatisfied";
+    }>, "many">;
+    reviewReleaseTier: z.ZodOptional<z.ZodNullable<z.ZodEnum<["engineering_preview_only", "internal_beta_candidate", "launchable_public_mvp"]>>>;
+    deploymentsPlatformState: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    conflicts: {
+        code: "completion_vs_release_gate" | "release_gate_vs_completion" | "completion_vs_deployments_gate" | "deployments_gate_vs_completion";
+        message: string;
+        stepId: string;
+        completionSays: "incomplete" | "complete";
+        gateSays: "satisfied" | "unsatisfied";
+    }[];
+    reviewReleaseTier?: "engineering_preview_only" | "internal_beta_candidate" | "launchable_public_mvp" | null | undefined;
+    deploymentsPlatformState?: string | null | undefined;
+}, {
+    conflicts: {
+        code: "completion_vs_release_gate" | "release_gate_vs_completion" | "completion_vs_deployments_gate" | "deployments_gate_vs_completion";
+        message: string;
+        stepId: string;
+        completionSays: "incomplete" | "complete";
+        gateSays: "satisfied" | "unsatisfied";
+    }[];
+    reviewReleaseTier?: "engineering_preview_only" | "internal_beta_candidate" | "launchable_public_mvp" | null | undefined;
+    deploymentsPlatformState?: string | null | undefined;
+}>;
+export type WorkflowEvidenceSummary = z.infer<typeof WorkflowEvidenceSummarySchema>;

package/dist/schemas/workflow/workflow-evidence.schema.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowEvidenceSummarySchema = exports.WorkflowEvidenceConflictSchema = exports.WorkflowEvidenceConflictCodeSchema = void 0;
+const zod_1 = require("zod");
+const review_release_decision_operator_schema_1 = require("./review-release-decision-operator.schema");
+exports.WorkflowEvidenceConflictCodeSchema = zod_1.z.enum([
+    "completion_vs_release_gate",
+    "release_gate_vs_completion",
+    "completion_vs_deployments_gate",
+    "deployments_gate_vs_completion",
+]);
+exports.WorkflowEvidenceConflictSchema = zod_1.z.object({
+    stepId: zod_1.z.string(),
+    code: exports.WorkflowEvidenceConflictCodeSchema,
+    message: zod_1.z.string(),
+    completionSays: zod_1.z.enum(["complete", "incomplete"]),
+    gateSays: zod_1.z.enum(["satisfied", "unsatisfied"]),
+});
+exports.WorkflowEvidenceSummarySchema = zod_1.z.object({
+    conflicts: zod_1.z.array(exports.WorkflowEvidenceConflictSchema),
+    reviewReleaseTier: review_release_decision_operator_schema_1.ReviewReleaseDecisionTierSchema.nullable().optional(),
+    deploymentsPlatformState: zod_1.z.string().nullable().optional(),
+});