Module status page

Workflow

Workflow planning/evaluation layer with Operator Command adapters, preview execution paths, advisory intake from the Pre-Development / Construction adapter, and accepted non-executable lifecycle queue item generation.

maturity: PARTIALproduction status: smoke testednavigation status: liveowner: Workflow services and /api/v1/workflowcapability owner: Workflow

What Is Live

  • API route: src/app/api/v1/workflow/[dealId]/route.ts
  • API route: src/app/api/v1/workflow/evaluate/[dealId]/route.ts
  • API route: src/app/api/v1/workflow/task/status/route.ts
  • Service: src/lib/workflow
  • Service: src/lib/lifecycle-boundary/adaptPredevConstructionBoundaryToStageWorkflow.ts
  • Service: src/lib/lifecycle-boundary/predevConstructionWorkflowQueueAdapter.ts
  • Service: src/lib/operator-command/operatorQueueAdvisoryLifecycleAdapter.ts
  • Adapter: src/lib/workflow/__tests__/workflowToOperatorAdapter.test.ts
  • Adapter: src/lib/lifecycle-boundary/adaptPredevConstructionBoundaryToStageWorkflow.ts
  • Adapter: src/lib/lifecycle-boundary/predevConstructionWorkflowQueueAdapter.ts
  • Adapter: src/lib/operator-command/operatorQueueAdvisoryLifecycleAdapter.ts

What Is Not Wired

  • Missing critical piece: Production acceptance for the read-only advisory lifecycle UI before controlled mutations.
  • Missing adapter: Dedicated controlled adapters for non-contract workflows.
  • Missing adapter: Production acceptance for read-only advisory lifecycle UI.
  • Known risk: Several execution adapters still default to preview/noop; lifecycle boundary queue items have read-only UI exposure but must remain advisory before any mutation path.
  • Duplicate logic: Workflow state appears in stage, queue, and operator outcome projections.

Known Blockers

No active blockers are listed.

Next Recommended Action

  • Keep lifecycle queue items advisory-only and production-accept the read-only Operator Command UI exposure before any mutation path.

System Audit Evidence

  • Readiness score: 68%
  • Integration depth: adapter integrated
  • Route exposure: api only
  • Security boundary: partial
  • Queue integration: partial
  • Readiness integration: partial
  • Workflow integration: wired
  • Data Room integration: partial
  • Export integration: partial
  • Test: src/lib/workflow/__tests__/workflowToOperatorAdapter.test.ts
  • Test: src/lib/operator-command/__tests__/executeOperatorWorkflowPlan.test.ts
  • Test: src/lib/operator-command/__tests__/operatorQueueAdvisoryLifecycleAdapter.test.ts
  • Test: src/lib/lifecycle-boundary/__tests__/adaptPredevConstructionBoundaryToStageWorkflow.test.ts
  • Test: src/lib/lifecycle-boundary/__tests__/predevConstructionWorkflowQueueAdapter.test.ts
  • Smoke: scripts/smoke-workflow-to-operator-adapter.ts
  • Smoke: scripts/smoke-operator-workflow.ts
  • Smoke: scripts/smoke-stage-workflow-simulation.ts
  • Smoke: scripts/smoke-operator-queue-advisory-lifecycle.ts
  • Smoke: scripts/smoke-predev-construction-stage-workflow-adapter.ts
  • Smoke: scripts/smoke-predev-construction-workflow-queue-adapter.ts
  • Persistence: Append-only workflow/outcome ledgers in operator-command services.

Architecture Governance

  • 11 governance doctrines tracked
  • 15 required adapter seams
  • 13 forbidden direct couplings
  • No high or critical governance findings

Capability Registry

  • Read-only Workflow status page for preview/task services surfaced through Operator Command.
  • Registry production status: production
  • Primary nav group: Command
  • Capability: system audit maturity
  • Capability: workflow preview inventory
  • Capability: missing adapter list
  • Capability: safe operator links

Related Links

Safe Available Actions

No mutation controls on this page. This page does not mutate readiness, auto-approve obligations, execute workflow actions, advance stages, send emails, or create default/breach conclusions.