Module status page
Stage Engine
Deal lifecycle stage evaluation, history, overrides, auto-advance, stage-to-queue signals, and future advisory intake from the Pre-Development / Construction Stage-Workflow adapter.
What Is Live
- API route: src/app/api/v1/deal-stage/[dealId]/route.ts
- API route: src/app/api/v1/deal-stage/advance/[dealId]/route.ts
- API route: src/app/api/v1/deals/stage/auto-advance/[dealId]/route.ts
- Service: src/lib/deal-stage
- Service: src/lib/deals
- Service: src/lib/lifecycle-boundary/adaptPredevConstructionBoundaryToStageWorkflow.ts
- Adapter: src/lib/operator-command/operatorModuleWiringInventory.ts
- Adapter: src/lib/lifecycle-boundary/adaptPredevConstructionBoundaryToStageWorkflow.ts
- Production evidence: Contract intake created active intake deals in production.
What Is Not Wired
- Missing critical piece: One canonical stage transition policy spanning API routes, workflow simulations, and advisory boundary recommendations.
- Missing adapter: Stage Engine advisory read adapter for lifecycle boundary recommendations.
- Known risk: Auto-advance routes require strict guardrails before broad production use; adapter recommendations are advisory only.
- Known drift: Deal stage and workflow readiness can report related but separate states.
- Duplicate logic: Advance gate and stage workflow simulation both reason about progression.
Known Blockers
No active blockers are listed.
Next Recommended Action
- Read Stage-Workflow adapter output as advisory input before changing stage advancement behavior.
System Audit Evidence
- Readiness score: 72%
- Integration depth: operator integrated
- Route exposure: api only
- Security boundary: partial
- Queue integration: wired
- Readiness integration: wired
- Workflow integration: wired
- Data Room integration: partial
- Export integration: partial
- Test: src/lib/deals/__tests__/activateDealFromContractIntake.test.ts
- Test: src/lib/lifecycle-boundary/__tests__/adaptPredevConstructionBoundaryToStageWorkflow.test.ts
- Smoke: scripts/smoke-stage-history.ts
- Smoke: scripts/smoke-stage-workflow-simulation.ts
- Smoke: scripts/smoke-advance-gate.ts
- Smoke: scripts/smoke-predev-construction-stage-workflow-adapter.ts
- Persistence: Deal registry, stage history, and intake registry records.
Architecture Governance
- 11 governance doctrines tracked
- 15 required adapter seams
- 13 forbidden direct couplings
- No high or critical governance findings
Capability Registry
- Read-only Stage Engine status page; stage advancement remains guarded and is not exposed here.
- Registry production status: internal only
- Primary nav group: System
- Capability: system audit maturity
- Capability: stage API inventory
- Capability: guardrail summary
- Capability: no advancement controls
Related Links
- Open Projects Execution
Current safe stage/readiness context.
- Open Contracts
Deal pages retain guarded stage state visibility.
Safe Available Actions
- Open System Audit
Canonical module maturity and production readiness.
- Open Architecture Governance
Doctrine and adapter requirements.
- Open registered route
Status/landing route from the capability registry.
- Open Projects Execution
Current safe stage/readiness context.
- Open Contracts
Deal pages retain guarded stage state visibility.
- Source/api/v1/deal-stage/[dealId]/route.ts
API source path listed for visibility only; no action is executed from this page.
- Source/api/v1/deal-stage/advance/[dealId]/route.ts
API source path listed for visibility only; no action is executed from this page.
- Source/api/v1/deals/stage/auto-advance/[dealId]/route.ts
API source path listed for visibility only; no action is executed from this page.
- scripts/smoke-stage-history.ts
Smoke script reference; not executed from this page.
- scripts/smoke-stage-workflow-simulation.ts
Smoke script reference; not executed from this page.
- scripts/smoke-advance-gate.ts
Smoke script reference; not executed from this page.
- scripts/smoke-predev-construction-stage-workflow-adapter.ts
Smoke script reference; not executed from this page.