@lucern/sdk 0.2.0-alpha.6 → 0.2.0-alpha.8

package/dist/lucern/contracts/src/workflow-runtime.contract.js

@@ -1,257 +0,0 @@
-/**
- * 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",
-];
-export const 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",
-};
-export const 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",
-];
-export const 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",
-];
-export const WORKFLOW_TRIGGER_KINDS = [
-    "manual",
-    "schedule",
-    "hook",
-];
-export const WORKFLOW_PROOF_ARTIFACT_KINDS = [
-    "report",
-    "brief",
-    "artifact",
-    "dashboard",
-    "test_evidence",
-];
-export const WORKFLOW_STAFFING_HINTS = [
-    "solo",
-    "backend+tests",
-    "fullstack",
-    "mcp+tests",
-];
-export const 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",
-];
-export const 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,
-    },
-    {
-        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"],
-    },
-];

package/dist/realtime-refs.d.ts

@@ -1 +0,0 @@
-export * from "./lib/platform/sdk/realtime/refs";

package/dist/realtime-refs.js

@@ -1 +0,0 @@
-export * from "./lib/platform/sdk/realtime/refs.js";

package/dist/realtime.d.ts

@@ -1 +0,0 @@
-export * from "./lib/platform/sdk/realtime/index";

package/dist/realtime.js

@@ -1 +0,0 @@
-export * from "./lib/platform/sdk/realtime/index.js";