@lucern/contracts 0.1.0 → 0.1.2-alpha.1

package/dist/workflow-runtime.contract.d.ts

@@ -15,58 +15,58 @@
  *   - Reclassifying a mutation tier is BREAKING
  *   - Changing canonical workflow IDs is BREAKING
  */
-export declare const WORKFLOW_RUNTIME_SCHEMA_VERSION: "1.0.0";
-export declare const WORKFLOW_MUTATION_TIERS: readonly ["read_only", "low_risk_write", "high_risk_write"];
-export type WorkflowMutationTier = (typeof WORKFLOW_MUTATION_TIERS)[number];
-export declare const WORKFLOW_APPROVAL_MODES: readonly ["none", "audit_only", "human_required", "auto_approve"];
-export type WorkflowApprovalMode = (typeof WORKFLOW_APPROVAL_MODES)[number];
-export declare const DEFAULT_TIER_APPROVAL_MODE: Readonly<Record<WorkflowMutationTier, WorkflowApprovalMode>>;
-export declare const WORKFLOW_ACTION_KINDS: readonly ["context_pack", "integrity_check", "lucern_tool", "report_compile", "brief_publish", "notification", "custom"];
-export type WorkflowActionKind = (typeof WORKFLOW_ACTION_KINDS)[number];
-export declare const WORKFLOW_HOOK_EVENTS: readonly ["schedule.tick", "worktree.activated", "worktree.completed", "question.created", "question.answered", "evidence.appended", "inbox.item_created"];
-export type WorkflowHookEvent = (typeof WORKFLOW_HOOK_EVENTS)[number];
-export declare const WORKFLOW_OUTPUT_KINDS: readonly ["engineering_brief", "research_memo", "strategy_artifact", "inbox_summary", "pipeline_brief", "structured_payload"];
-export type WorkflowOutputKind = (typeof WORKFLOW_OUTPUT_KINDS)[number];
-export declare const WORKFLOW_RUN_STATUSES: readonly ["queued", "running", "awaiting_approval", "completed", "failed", "cancelled"];
-export type WorkflowRunStatus = (typeof WORKFLOW_RUN_STATUSES)[number];
-export declare const WORKFLOW_TRIGGER_KINDS: readonly ["manual", "schedule", "hook"];
-export type WorkflowTriggerKind = (typeof WORKFLOW_TRIGGER_KINDS)[number];
-export declare const WORKFLOW_PROOF_ARTIFACT_KINDS: readonly ["report", "brief", "artifact", "dashboard", "test_evidence"];
-export type WorkflowProofArtifactKind = (typeof WORKFLOW_PROOF_ARTIFACT_KINDS)[number];
-export declare const WORKFLOW_STAFFING_HINTS: readonly ["solo", "backend+tests", "fullstack", "mcp+tests"];
-export type WorkflowStaffingHint = (typeof WORKFLOW_STAFFING_HINTS)[number];
-export declare const WORKFLOW_AUTO_FIX_MODES: readonly ["disabled", "dry_run", "safe", "aggressive"];
-export type WorkflowAutoFixMode = (typeof WORKFLOW_AUTO_FIX_MODES)[number];
-export declare const WORKFLOW_INTEGRITY_CHECKS: readonly ["null_dependency_refs", "superseded_blockers", "band_order_inconsistency", "sparse_shaping", "failed_completed_gate"];
-export type WorkflowIntegrityCheckId = (typeof WORKFLOW_INTEGRITY_CHECKS)[number];
-export type WorkflowProofArtifact = {
+declare const WORKFLOW_RUNTIME_SCHEMA_VERSION: "1.0.0";
+declare const WORKFLOW_MUTATION_TIERS: readonly ["read_only", "low_risk_write", "high_risk_write"];
+type WorkflowMutationTier = (typeof WORKFLOW_MUTATION_TIERS)[number];
+declare const WORKFLOW_APPROVAL_MODES: readonly ["none", "audit_only", "human_required", "auto_approve"];
+type WorkflowApprovalMode = (typeof WORKFLOW_APPROVAL_MODES)[number];
+declare const DEFAULT_TIER_APPROVAL_MODE: Readonly<Record<WorkflowMutationTier, WorkflowApprovalMode>>;
+declare const WORKFLOW_ACTION_KINDS: readonly ["context_pack", "integrity_check", "lucern_tool", "report_compile", "brief_publish", "notification", "custom"];
+type WorkflowActionKind = (typeof WORKFLOW_ACTION_KINDS)[number];
+declare const WORKFLOW_HOOK_EVENTS: readonly ["schedule.tick", "worktree.activated", "worktree.completed", "question.created", "question.answered", "evidence.appended", "inbox.item_created"];
+type WorkflowHookEvent = (typeof WORKFLOW_HOOK_EVENTS)[number];
+declare const WORKFLOW_OUTPUT_KINDS: readonly ["engineering_brief", "research_memo", "strategy_artifact", "inbox_summary", "pipeline_brief", "structured_payload"];
+type WorkflowOutputKind = (typeof WORKFLOW_OUTPUT_KINDS)[number];
+declare const WORKFLOW_RUN_STATUSES: readonly ["queued", "running", "awaiting_approval", "completed", "failed", "cancelled"];
+type WorkflowRunStatus = (typeof WORKFLOW_RUN_STATUSES)[number];
+declare const WORKFLOW_TRIGGER_KINDS: readonly ["manual", "schedule", "hook"];
+type WorkflowTriggerKind = (typeof WORKFLOW_TRIGGER_KINDS)[number];
+declare const WORKFLOW_PROOF_ARTIFACT_KINDS: readonly ["report", "brief", "artifact", "dashboard", "test_evidence"];
+type WorkflowProofArtifactKind = (typeof WORKFLOW_PROOF_ARTIFACT_KINDS)[number];
+declare const WORKFLOW_STAFFING_HINTS: readonly ["solo", "backend+tests", "fullstack", "mcp+tests"];
+type WorkflowStaffingHint = (typeof WORKFLOW_STAFFING_HINTS)[number];
+declare const WORKFLOW_AUTO_FIX_MODES: readonly ["disabled", "dry_run", "safe", "aggressive"];
+type WorkflowAutoFixMode = (typeof WORKFLOW_AUTO_FIX_MODES)[number];
+declare const WORKFLOW_INTEGRITY_CHECKS: readonly ["null_dependency_refs", "superseded_blockers", "band_order_inconsistency", "sparse_shaping", "failed_completed_gate"];
+type WorkflowIntegrityCheckId = (typeof WORKFLOW_INTEGRITY_CHECKS)[number];
+type WorkflowProofArtifact = {
     kind: WorkflowProofArtifactKind;
     label: string;
     required?: boolean;
     sourceRef?: string;
 };
-export type WorkflowAutoFixPolicy = {
+type WorkflowAutoFixPolicy = {
     mode: WorkflowAutoFixMode;
     maxActionsPerRun?: number;
     permittedMutationTiers?: WorkflowMutationTier[];
     requireAuditTrail?: boolean;
     escalationGate?: string;
 };
-export declare const DEFAULT_WORKFLOW_AUTO_FIX_POLICY: WorkflowAutoFixPolicy;
-export type WorkflowApprovalPolicy = {
+declare const DEFAULT_WORKFLOW_AUTO_FIX_POLICY: WorkflowAutoFixPolicy;
+type WorkflowApprovalPolicy = {
     mode: WorkflowApprovalMode;
     approvalGate?: string;
     autoApprovePolicyKey?: string;
     rationaleRequired?: boolean;
 };
-export type WorkflowOutputBase = {
+type WorkflowOutputBase = {
     outputId: string;
     kind: WorkflowOutputKind;
     title: string;
     summary: string;
     generatedAt?: number;
 };
-export type EngineeringBriefOutput = WorkflowOutputBase & {
+type EngineeringBriefOutput = WorkflowOutputBase & {
     kind: "engineering_brief";
     sections: Array<{
         heading: string;
@@ -74,23 +74,23 @@ export type EngineeringBriefOutput = WorkflowOutputBase & {
     }>;
     touchedPaths?: string[];
 };
-export type ResearchMemoOutput = WorkflowOutputBase & {
+type ResearchMemoOutput = WorkflowOutputBase & {
     kind: "research_memo";
     claims: string[];
     evidenceRefs?: string[];
 };
-export type StrategyArtifactOutput = WorkflowOutputBase & {
+type StrategyArtifactOutput = WorkflowOutputBase & {
     kind: "strategy_artifact";
     recommendations: string[];
     decisionWindow?: string;
 };
-export type InboxSummaryOutput = WorkflowOutputBase & {
+type InboxSummaryOutput = WorkflowOutputBase & {
     kind: "inbox_summary";
     channel: "developer_portal" | "chat" | "ops";
     inboxTitle: string;
     inboxBody: string;
 };
-export type PipelineBriefOutput = WorkflowOutputBase & {
+type PipelineBriefOutput = WorkflowOutputBase & {
     kind: "pipeline_brief";
     hingeWorktreeId?: string;
     groupedBlockers: Array<{
@@ -98,12 +98,12 @@ export type PipelineBriefOutput = WorkflowOutputBase & {
         blockedWorktreeIds: string[];
     }>;
 };
-export type StructuredPayloadOutput = WorkflowOutputBase & {
+type StructuredPayloadOutput = WorkflowOutputBase & {
     kind: "structured_payload";
     payload: Record<string, unknown>;
 };
-export type WorkflowOutputContract = EngineeringBriefOutput | ResearchMemoOutput | StrategyArtifactOutput | InboxSummaryOutput | PipelineBriefOutput | StructuredPayloadOutput;
-export type WorkflowActionContract = {
+type WorkflowOutputContract = EngineeringBriefOutput | ResearchMemoOutput | StrategyArtifactOutput | InboxSummaryOutput | PipelineBriefOutput | StructuredPayloadOutput;
+type WorkflowActionContract = {
     actionId: string;
     kind: WorkflowActionKind;
     title: string;
@@ -114,14 +114,14 @@ export type WorkflowActionContract = {
     idempotent?: boolean;
     approval: WorkflowApprovalPolicy;
 };
-export type WorkflowHookContract = {
+type WorkflowHookContract = {
     hookId: string;
     event: WorkflowHookEvent;
     description: string;
     condition?: string;
     actionIds: string[];
 };
-export type WorkflowTriggerContract = {
+type WorkflowTriggerContract = {
     kind: "manual";
     description?: string;
 } | {
@@ -132,7 +132,7 @@ export type WorkflowTriggerContract = {
     kind: "hook";
     event: WorkflowHookEvent;
 };
-export type WorkflowDefinitionV1 = {
+type WorkflowDefinitionV1 = {
     workflowId: string;
     version: typeof WORKFLOW_RUNTIME_SCHEMA_VERSION;
     title: string;
@@ -146,7 +146,7 @@ export type WorkflowDefinitionV1 = {
     outputs: readonly WorkflowOutputKind[];
     integrityChecks?: readonly WorkflowIntegrityCheckId[];
 };
-export type WorkflowRunReceiptV1 = {
+type WorkflowRunReceiptV1 = {
     runId: string;
     workflowId: string;
     status: WorkflowRunStatus;
@@ -156,7 +156,8 @@ export type WorkflowRunReceiptV1 = {
     outputKinds: WorkflowOutputKind[];
     approvalsRequired?: number;
 };
-export declare const NIGHTLY_RECONCILIATION_WORKFLOW_ID: "workflow.pipeline_reconciliation.v1";
-export declare const MORNING_BRIEF_WORKFLOW_ID: "workflow.morning_brief.v1";
-export declare const CANONICAL_WORKFLOW_DEFINITIONS: readonly WorkflowDefinitionV1[];
-//# sourceMappingURL=workflow-runtime.contract.d.ts.map
+declare const NIGHTLY_RECONCILIATION_WORKFLOW_ID: "workflow.pipeline_reconciliation.v1";
+declare const MORNING_BRIEF_WORKFLOW_ID: "workflow.morning_brief.v1";
+declare const CANONICAL_WORKFLOW_DEFINITIONS: readonly WorkflowDefinitionV1[];
+
+export { CANONICAL_WORKFLOW_DEFINITIONS, DEFAULT_TIER_APPROVAL_MODE, DEFAULT_WORKFLOW_AUTO_FIX_POLICY, type EngineeringBriefOutput, type InboxSummaryOutput, MORNING_BRIEF_WORKFLOW_ID, NIGHTLY_RECONCILIATION_WORKFLOW_ID, type PipelineBriefOutput, type ResearchMemoOutput, type StrategyArtifactOutput, type StructuredPayloadOutput, WORKFLOW_ACTION_KINDS, WORKFLOW_APPROVAL_MODES, WORKFLOW_AUTO_FIX_MODES, WORKFLOW_HOOK_EVENTS, WORKFLOW_INTEGRITY_CHECKS, WORKFLOW_MUTATION_TIERS, WORKFLOW_OUTPUT_KINDS, WORKFLOW_PROOF_ARTIFACT_KINDS, WORKFLOW_RUNTIME_SCHEMA_VERSION, WORKFLOW_RUN_STATUSES, WORKFLOW_STAFFING_HINTS, WORKFLOW_TRIGGER_KINDS, type WorkflowActionContract, type WorkflowActionKind, type WorkflowApprovalMode, type WorkflowApprovalPolicy, type WorkflowAutoFixMode, type WorkflowAutoFixPolicy, type WorkflowDefinitionV1, type WorkflowHookContract, type WorkflowHookEvent, type WorkflowIntegrityCheckId, type WorkflowMutationTier, type WorkflowOutputBase, type WorkflowOutputContract, type WorkflowOutputKind, type WorkflowProofArtifact, type WorkflowProofArtifactKind, type WorkflowRunReceiptV1, type WorkflowRunStatus, type WorkflowStaffingHint, type WorkflowTriggerContract, type WorkflowTriggerKind };

package/dist/workflow-runtime.contract.js

@@ -1,258 +1,245 @@
-/**
- * Workflow Runtime Contract v1
- *
- * Canonical TypeScript contract for Lucern's graph-local workflow runtime.
- * WF-1 defines the typed substrate for:
- *   - workflow definitions and run receipts
- *   - action mutation tiering and approval expectations
- *   - hooks over worktree/question/evidence/inbox events
- *   - output unions for domain-specific artifacts
- *   - deterministic integrity checks and operational metadata
- *
- * BREAKING CHANGE RULES:
- *   - Adding optional fields is NON-breaking
- *   - Removing fields or renaming enum values is BREAKING
- *   - Reclassifying a mutation tier is BREAKING
- *   - Changing canonical workflow IDs is BREAKING
- */
-export const WORKFLOW_RUNTIME_SCHEMA_VERSION = "1.0.0";
-export const WORKFLOW_MUTATION_TIERS = [
-    "read_only",
-    "low_risk_write",
-    "high_risk_write",
+// src/workflow-runtime.contract.ts
+var WORKFLOW_RUNTIME_SCHEMA_VERSION = "1.0.0";
+var WORKFLOW_MUTATION_TIERS = [
+  "read_only",
+  "low_risk_write",
+  "high_risk_write"
 ];
-export const WORKFLOW_APPROVAL_MODES = [
-    "none",
-    "audit_only",
-    "human_required",
-    "auto_approve",
+var WORKFLOW_APPROVAL_MODES = [
+  "none",
+  "audit_only",
+  "human_required",
+  "auto_approve"
 ];
-export const DEFAULT_TIER_APPROVAL_MODE = {
-    read_only: "none",
-    low_risk_write: "audit_only",
-    high_risk_write: "human_required",
+var DEFAULT_TIER_APPROVAL_MODE = {
+  read_only: "none",
+  low_risk_write: "audit_only",
+  high_risk_write: "human_required"
 };
-export const WORKFLOW_ACTION_KINDS = [
-    "context_pack",
-    "integrity_check",
-    "lucern_tool",
-    "report_compile",
-    "brief_publish",
-    "notification",
-    "custom",
+var WORKFLOW_ACTION_KINDS = [
+  "context_pack",
+  "integrity_check",
+  "lucern_tool",
+  "report_compile",
+  "brief_publish",
+  "notification",
+  "custom"
 ];
-export const WORKFLOW_HOOK_EVENTS = [
-    "schedule.tick",
-    "worktree.activated",
-    "worktree.completed",
-    "question.created",
-    "question.answered",
-    "evidence.appended",
-    "inbox.item_created",
+var WORKFLOW_HOOK_EVENTS = [
+  "schedule.tick",
+  "worktree.activated",
+  "worktree.completed",
+  "question.created",
+  "question.answered",
+  "evidence.appended",
+  "inbox.item_created"
 ];
-export const WORKFLOW_OUTPUT_KINDS = [
-    "engineering_brief",
-    "research_memo",
-    "strategy_artifact",
-    "inbox_summary",
-    "pipeline_brief",
-    "structured_payload",
+var WORKFLOW_OUTPUT_KINDS = [
+  "engineering_brief",
+  "research_memo",
+  "strategy_artifact",
+  "inbox_summary",
+  "pipeline_brief",
+  "structured_payload"
 ];
-export const WORKFLOW_RUN_STATUSES = [
-    "queued",
-    "running",
-    "awaiting_approval",
-    "completed",
-    "failed",
-    "cancelled",
+var WORKFLOW_RUN_STATUSES = [
+  "queued",
+  "running",
+  "awaiting_approval",
+  "completed",
+  "failed",
+  "cancelled"
 ];
-export const WORKFLOW_TRIGGER_KINDS = [
-    "manual",
-    "schedule",
-    "hook",
+var WORKFLOW_TRIGGER_KINDS = [
+  "manual",
+  "schedule",
+  "hook"
 ];
-export const WORKFLOW_PROOF_ARTIFACT_KINDS = [
-    "report",
-    "brief",
-    "artifact",
-    "dashboard",
-    "test_evidence",
+var WORKFLOW_PROOF_ARTIFACT_KINDS = [
+  "report",
+  "brief",
+  "artifact",
+  "dashboard",
+  "test_evidence"
 ];
-export const WORKFLOW_STAFFING_HINTS = [
-    "solo",
-    "backend+tests",
-    "fullstack",
-    "mcp+tests",
+var WORKFLOW_STAFFING_HINTS = [
+  "solo",
+  "backend+tests",
+  "fullstack",
+  "mcp+tests"
 ];
-export const WORKFLOW_AUTO_FIX_MODES = [
-    "disabled",
-    "dry_run",
-    "safe",
-    "aggressive",
+var WORKFLOW_AUTO_FIX_MODES = [
+  "disabled",
+  "dry_run",
+  "safe",
+  "aggressive"
 ];
-export const WORKFLOW_INTEGRITY_CHECKS = [
-    "null_dependency_refs",
-    "superseded_blockers",
-    "band_order_inconsistency",
-    "sparse_shaping",
-    "failed_completed_gate",
+var WORKFLOW_INTEGRITY_CHECKS = [
+  "null_dependency_refs",
+  "superseded_blockers",
+  "band_order_inconsistency",
+  "sparse_shaping",
+  "failed_completed_gate"
 ];
-export const DEFAULT_WORKFLOW_AUTO_FIX_POLICY = {
-    mode: "disabled",
-    permittedMutationTiers: ["read_only"],
-    requireAuditTrail: true,
+var DEFAULT_WORKFLOW_AUTO_FIX_POLICY = {
+  mode: "disabled",
+  permittedMutationTiers: ["read_only"],
+  requireAuditTrail: true
 };
-export const NIGHTLY_RECONCILIATION_WORKFLOW_ID = "workflow.pipeline_reconciliation.v1";
-export const MORNING_BRIEF_WORKFLOW_ID = "workflow.morning_brief.v1";
-export const CANONICAL_WORKFLOW_DEFINITIONS = [
-    {
-        workflowId: NIGHTLY_RECONCILIATION_WORKFLOW_ID,
-        version: WORKFLOW_RUNTIME_SCHEMA_VERSION,
-        title: "Nightly Pipeline Reconciliation",
-        description: "Runs deterministic integrity checks, compiles pipeline state, and emits an operator-facing reconciliation brief.",
-        trigger: {
-            kind: "schedule",
-            cadence: "daily",
-            timezone: "America/New_York",
-        },
-        staffingHint: "backend+tests",
-        proofArtifacts: [
-            {
-                kind: "report",
-                label: "Pipeline reconciliation report",
-                required: true,
-            },
-            {
-                kind: "test_evidence",
-                label: "Integrity check receipt",
-                required: true,
-            },
-        ],
-        autoFixPolicy: {
-            mode: "safe",
-            maxActionsPerRun: 5,
-            permittedMutationTiers: ["read_only", "low_risk_write"],
-            requireAuditTrail: true,
-            escalationGate: "gate:workflow-runtime-contract-live",
-        },
-        actions: [
-            {
-                actionId: "compile_context_pack",
-                kind: "context_pack",
-                title: "Compile pipeline context",
-                description: "Build the ranked context needed for deterministic checks.",
-                mutationTier: "read_only",
-                produces: ["structured_payload"],
-                idempotent: true,
-                approval: { mode: "none" },
-            },
-            {
-                actionId: "run_integrity_checks",
-                kind: "integrity_check",
-                title: "Run integrity checks",
-                description: "Evaluate dependency references, blockers, execution bands, shaping coverage, and completed gates.",
-                mutationTier: "read_only",
-                produces: ["structured_payload"],
-                idempotent: true,
-                approval: { mode: "none" },
-            },
-            {
-                actionId: "record_followup_questions",
-                kind: "lucern_tool",
-                title: "Record follow-up questions",
-                description: "Create or reopen operator-facing questions for integrity failures that require human review.",
-                mutationTier: "low_risk_write",
-                toolName: "create_question",
-                produces: ["pipeline_brief"],
-                approval: { mode: "audit_only", rationaleRequired: true },
-            },
-            {
-                actionId: "publish_reconciliation_brief",
-                kind: "brief_publish",
-                title: "Publish reconciliation brief",
-                description: "Emit an inbox-routed brief summarizing the nightly pipeline state and grouped blockers.",
-                mutationTier: "low_risk_write",
-                produces: ["pipeline_brief", "inbox_summary"],
-                approval: { mode: "audit_only" },
-            },
-        ],
-        hooks: [
-            {
-                hookId: "nightly-schedule",
-                event: "schedule.tick",
-                description: "Run once per nightly cadence.",
-                actionIds: [
-                    "compile_context_pack",
-                    "run_integrity_checks",
-                    "record_followup_questions",
-                    "publish_reconciliation_brief",
-                ],
-            },
-        ],
-        outputs: ["pipeline_brief", "inbox_summary", "structured_payload"],
-        integrityChecks: WORKFLOW_INTEGRITY_CHECKS,
+var NIGHTLY_RECONCILIATION_WORKFLOW_ID = "workflow.pipeline_reconciliation.v1";
+var MORNING_BRIEF_WORKFLOW_ID = "workflow.morning_brief.v1";
+var CANONICAL_WORKFLOW_DEFINITIONS = [
+  {
+    workflowId: NIGHTLY_RECONCILIATION_WORKFLOW_ID,
+    version: WORKFLOW_RUNTIME_SCHEMA_VERSION,
+    title: "Nightly Pipeline Reconciliation",
+    description: "Runs deterministic integrity checks, compiles pipeline state, and emits an operator-facing reconciliation brief.",
+    trigger: {
+      kind: "schedule",
+      cadence: "daily",
+      timezone: "America/New_York"
     },
-    {
-        workflowId: MORNING_BRIEF_WORKFLOW_ID,
-        version: WORKFLOW_RUNTIME_SCHEMA_VERSION,
-        title: "Morning Brief",
-        description: "Compiles a developer-facing morning brief from graph state, overnight workflow outputs, and inbox routing preferences.",
-        trigger: {
-            kind: "schedule",
-            cadence: "daily",
-            timezone: "America/New_York",
-        },
-        staffingHint: "solo",
-        proofArtifacts: [
-            {
-                kind: "brief",
-                label: "Morning brief",
-                required: true,
-            },
-        ],
-        autoFixPolicy: {
-            mode: "dry_run",
-            maxActionsPerRun: 1,
-            permittedMutationTiers: ["read_only", "low_risk_write"],
-            requireAuditTrail: true,
-        },
-        actions: [
-            {
-                actionId: "compile_brief_inputs",
-                kind: "context_pack",
-                title: "Compile brief inputs",
-                description: "Read graph state, worktree state, and overnight workflow receipts.",
-                mutationTier: "read_only",
-                produces: ["structured_payload"],
-                idempotent: true,
-                approval: { mode: "none" },
-            },
-            {
-                actionId: "publish_morning_brief",
-                kind: "brief_publish",
-                title: "Publish morning brief",
-                description: "Publish a typed inbox summary with prioritized worktree and question context.",
-                mutationTier: "low_risk_write",
-                produces: ["engineering_brief", "inbox_summary"],
-                approval: { mode: "audit_only" },
-            },
-        ],
-        hooks: [
-            {
-                hookId: "morning-schedule",
-                event: "schedule.tick",
-                description: "Run once per morning cadence.",
-                actionIds: ["compile_brief_inputs", "publish_morning_brief"],
-            },
-            {
-                hookId: "worktree-complete-refresh",
-                event: "worktree.completed",
-                description: "Refresh the queued morning brief inputs when worktree outcomes land overnight.",
-                actionIds: ["compile_brief_inputs"],
-            },
-        ],
-        outputs: ["engineering_brief", "inbox_summary", "structured_payload"],
-        integrityChecks: ["sparse_shaping"],
+    staffingHint: "backend+tests",
+    proofArtifacts: [
+      {
+        kind: "report",
+        label: "Pipeline reconciliation report",
+        required: true
+      },
+      {
+        kind: "test_evidence",
+        label: "Integrity check receipt",
+        required: true
+      }
+    ],
+    autoFixPolicy: {
+      mode: "safe",
+      maxActionsPerRun: 5,
+      permittedMutationTiers: ["read_only", "low_risk_write"],
+      requireAuditTrail: true,
+      escalationGate: "gate:workflow-runtime-contract-live"
     },
+    actions: [
+      {
+        actionId: "compile_context_pack",
+        kind: "context_pack",
+        title: "Compile pipeline context",
+        description: "Build the ranked context needed for deterministic checks.",
+        mutationTier: "read_only",
+        produces: ["structured_payload"],
+        idempotent: true,
+        approval: { mode: "none" }
+      },
+      {
+        actionId: "run_integrity_checks",
+        kind: "integrity_check",
+        title: "Run integrity checks",
+        description: "Evaluate dependency references, blockers, execution bands, shaping coverage, and completed gates.",
+        mutationTier: "read_only",
+        produces: ["structured_payload"],
+        idempotent: true,
+        approval: { mode: "none" }
+      },
+      {
+        actionId: "record_followup_questions",
+        kind: "lucern_tool",
+        title: "Record follow-up questions",
+        description: "Create or reopen operator-facing questions for integrity failures that require human review.",
+        mutationTier: "low_risk_write",
+        toolName: "create_question",
+        produces: ["pipeline_brief"],
+        approval: { mode: "audit_only", rationaleRequired: true }
+      },
+      {
+        actionId: "publish_reconciliation_brief",
+        kind: "brief_publish",
+        title: "Publish reconciliation brief",
+        description: "Emit an inbox-routed brief summarizing the nightly pipeline state and grouped blockers.",
+        mutationTier: "low_risk_write",
+        produces: ["pipeline_brief", "inbox_summary"],
+        approval: { mode: "audit_only" }
+      }
+    ],
+    hooks: [
+      {
+        hookId: "nightly-schedule",
+        event: "schedule.tick",
+        description: "Run once per nightly cadence.",
+        actionIds: [
+          "compile_context_pack",
+          "run_integrity_checks",
+          "record_followup_questions",
+          "publish_reconciliation_brief"
+        ]
+      }
+    ],
+    outputs: ["pipeline_brief", "inbox_summary", "structured_payload"],
+    integrityChecks: WORKFLOW_INTEGRITY_CHECKS
+  },
+  {
+    workflowId: MORNING_BRIEF_WORKFLOW_ID,
+    version: WORKFLOW_RUNTIME_SCHEMA_VERSION,
+    title: "Morning Brief",
+    description: "Compiles a developer-facing morning brief from graph state, overnight workflow outputs, and inbox routing preferences.",
+    trigger: {
+      kind: "schedule",
+      cadence: "daily",
+      timezone: "America/New_York"
+    },
+    staffingHint: "solo",
+    proofArtifacts: [
+      {
+        kind: "brief",
+        label: "Morning brief",
+        required: true
+      }
+    ],
+    autoFixPolicy: {
+      mode: "dry_run",
+      maxActionsPerRun: 1,
+      permittedMutationTiers: ["read_only", "low_risk_write"],
+      requireAuditTrail: true
+    },
+    actions: [
+      {
+        actionId: "compile_brief_inputs",
+        kind: "context_pack",
+        title: "Compile brief inputs",
+        description: "Read graph state, worktree state, and overnight workflow receipts.",
+        mutationTier: "read_only",
+        produces: ["structured_payload"],
+        idempotent: true,
+        approval: { mode: "none" }
+      },
+      {
+        actionId: "publish_morning_brief",
+        kind: "brief_publish",
+        title: "Publish morning brief",
+        description: "Publish a typed inbox summary with prioritized worktree and question context.",
+        mutationTier: "low_risk_write",
+        produces: ["engineering_brief", "inbox_summary"],
+        approval: { mode: "audit_only" }
+      }
+    ],
+    hooks: [
+      {
+        hookId: "morning-schedule",
+        event: "schedule.tick",
+        description: "Run once per morning cadence.",
+        actionIds: ["compile_brief_inputs", "publish_morning_brief"]
+      },
+      {
+        hookId: "worktree-complete-refresh",
+        event: "worktree.completed",
+        description: "Refresh the queued morning brief inputs when worktree outcomes land overnight.",
+        actionIds: ["compile_brief_inputs"]
+      }
+    ],
+    outputs: ["engineering_brief", "inbox_summary", "structured_payload"],
+    integrityChecks: ["sparse_shaping"]
+  }
 ];
+
+export { CANONICAL_WORKFLOW_DEFINITIONS, DEFAULT_TIER_APPROVAL_MODE, DEFAULT_WORKFLOW_AUTO_FIX_POLICY, MORNING_BRIEF_WORKFLOW_ID, NIGHTLY_RECONCILIATION_WORKFLOW_ID, WORKFLOW_ACTION_KINDS, WORKFLOW_APPROVAL_MODES, WORKFLOW_AUTO_FIX_MODES, WORKFLOW_HOOK_EVENTS, WORKFLOW_INTEGRITY_CHECKS, WORKFLOW_MUTATION_TIERS, WORKFLOW_OUTPUT_KINDS, WORKFLOW_PROOF_ARTIFACT_KINDS, WORKFLOW_RUNTIME_SCHEMA_VERSION, WORKFLOW_RUN_STATUSES, WORKFLOW_STAFFING_HINTS, WORKFLOW_TRIGGER_KINDS };
+//# sourceMappingURL=workflow-runtime.contract.js.map
 //# sourceMappingURL=workflow-runtime.contract.js.map