SDS-012: Case Management Service (CMMN)

Document Type

Software Design Specification (SDS)

Purpose

Specifies the AI Agent-Orchestrated Case Management Service, which orchestrates the lifecycle of projects (“Cases”) using CMMN primitives, manages the Artifact Pipeline, and integrates with the Project Manager Agent.

API Specification: System.CaseManagement

@namespace "system.casemanagement"
@version "1.1.0"
@owner "architecture-lead"

// ============================================================================
// 1. CORE ENTITIES: The Decision & Execution Actors
// ============================================================================

Entity "ProjectManagerAgent" in system.casemanagement
@rationale "The authoritative G3 conductor managing AI members and cognitive ergonomics."

Entity "CaseMember" in system.casemanagement
@rationale "Hybrid participants (Human or AI G3 agents) assigned to specific tasks."

Entity "Case" in system.casemanagement
@rationale "The CMMN-style collaborative container chartered by a Desired Outcome."

Entity "Task" in system.casemanagement
@rationale "The primary unit of work, including Discretionary and Mandatory tasks."

// ============================================================================
// 2. ARTIFACT PIPELINE: The Hierarchy of Meaning
// ============================================================================

Resource "CognitiveArtifact" units in system.casemanagement
@rationale "Ephemeral aids (notes, sketches) intended to reduce mental load."

Resource "IntellectualArtifact" units in system.casemanagement
@rationale "Synthesized constructs (specs, SOPs, domain concepts) derived from notes."

Resource "InformationProduct" units in system.casemanagement
@rationale "Refined intellectual artifacts mapped to market/domain value (software, campaigns)."

Resource "IntellectualCapital" units in system.casemanagement
@rationale "Standardized products transformed into assets via Exchange Rate Policies."

// ============================================================================
// 3. ORCHESTRATION FLOWS: The Isomorphic Synthesis Loop
// ============================================================================

// Artifact Reification Pipeline
Flow "Synthesis" from "CognitiveArtifact" to "IntellectualArtifact"
@rationale "The transition where raw sketches become formal specifications."

Flow "Refinement" from "IntellectualArtifact" to "InformationProduct"
@rationale "Projecting specifications into executable code or market-ready products."

Flow "Capitalization" from "InformationProduct" to "IntellectualCapital"
@rationale "Final reification into organizational value and assets."

// CMMN Execution Orchestration
Flow "ActivateTask" from "ProjectManagerAgent" to "Task"
@rationale "The PM-Agent explicitly triggers Discretionary Tasks based on Sentry criteria."

Flow "TransitionState" from "Case" to "InternalFederatedLedger"
@rationale "Every state change (Available -> Active -> Complete) is logged for provenance."

// ============================================================================
// 4. PROVENANCE & IDENTITY: The Identity Token Backbone
// ============================================================================

Resource "TransitionToken" in system.casemanagement
@rationale "A typed identity token representing an auditable state transition."

Resource "TokenLink" in system.casemanagement
@rationale "Explicit semantic edges defining lineage (e.g., 'produced_from')."

// ============================================================================
// 5. GOVERNANCE POLICIES: Architectural Invariants
// ============================================================================

Policy "SingleAgentControl" per Constraint Obligation priority 10
@rationale "AI members must be managed exclusively by the ProjectManagerAgent."
as: forall m in entities where m.type = "CaseMember": (m.parent = "ProjectManagerAgent")

Policy "NoTeleportation" per Constraint Obligation priority 10
@rationale "A ProjectionToken may only exist if the Case advanced to an Active state."
as: forall p in resources where p.name = "ProjectionToken":
    exists t in resources where t.name = "TransitionToken": (t.kind = "ExecutionStart")

Policy "SovereignGate" per Constraint Obligation priority 10
@rationale "High-impact capital conversions require a Human Sovereign signature."
as: forall r in flows where r.name = "Capitalization": (exists s in resources where s.name = "SignatureToken")

// ============================================================================
// 6. SYNTHESIS CONTRACT: The Manifest IR Projection
// ============================================================================

Resource "ManifestIR" in system.casemanagement
@rationale "The architectural contract used by VibesPro™ to scaffold the monorepo."

Mapping "CaseToHexagonal" for calm {
    Entity "Case" -> Target { "type": "AggregateRoot" }
    Flow "Synthesis" -> Target { "type": "ApplicationService" }
    Resource "IntellectualCapital" -> Target { "type": "DomainModel" }
}

System Implications

  1. Organizational Intelligence: Captures why decisions were made (ADRs) linked to code via Identity Tokens.
  2. Autonomous Gating: PM-Agent uses sentries to gate discretionary tasks.
  3. Self-Healing: Manifest IR is deterministic; drift can be corrected by re-running VibesPro™.
  4. Economic Traceability: Models Intellectual Capital as a quantifiable asset.

References