{"node_types":[{"name":"Answer","title":"Answer","retention_class":"operational","state_machine":null,"description":"A response to a Question that cites sources. Answers are operational-truth records; AI-drafted answers must be human-accepted before they become an Answer (Q11 AI-acceptance integrity)."},{"name":"Assumption","title":"Assumption","retention_class":"operational","state_machine":null,"description":"A RAID Assumption: a stated belief whose validity is required for downstream decisions or capabilities to hold. Stale assumptions are auto-promoted to Issues past their review_date."},{"name":"Capability","title":"Capability","retention_class":"operational","state_machine":"capability","description":"A discrete business capability (e.g., 'L2 helpdesk operations', 'AP invoice processing', 'GST filing'). Capabilities move through the capability lifecycle, group into TransitionWaves, and mature along MaturityDimensions."},{"name":"Control","title":"Control","retention_class":"reference","state_machine":null,"description":"A compliance or governance control mapped to a framework (SOC 2, ISO 27001, SAMA, PDPL, NCA, etc.). Controls carry implementation status and evidence pointers; full PDPL/regulatory mapping work lands in Phase 1B (Q1)."},{"name":"Decision","title":"Decision","retention_class":"operational","state_machine":"decision","description":"A choice point with options, rationale, RACI, and dependencies. The Decision is the core entity of the Decision Graph; everything else feeds, depends on, or annotates Decisions. Multi-step approval chains per Q2."},{"name":"Document","title":"Document","retention_class":"operational","state_machine":null,"description":"An uploaded artefact stored in R2, chunked and embedded for retrieval, classified for visibility control. Source-tracked: every chunk carries provenance metadata. Per-document classification per Q1 (4-tier in Phase 1A; PDPL alignment lands in Phase 1B)."},{"name":"Function","title":"Function","retention_class":"reference","state_machine":null,"description":"Top-level pillar within a tenant engagement (e.g., IT, Finance, HR, Legal, PMO). Container for Workstreams."},{"name":"Gate","title":"Gate","retention_class":"operational","state_machine":null,"description":"A Go/No-Go checkpoint with required approvals and exit criteria. Gates govern milestone progression and cutover events. Multi-step approval chains per Q2."},{"name":"Issue","title":"Issue","retention_class":"operational","state_machine":null,"description":"A RAID Issue: a present-tense problem requiring resolution. May be created directly or auto-promoted from a stale Assumption."},{"name":"LegalEntity","title":"LegalEntity","retention_class":"reference","state_machine":null,"description":"An incorporated entity in the tenant's group: parent, subsidiary, or the GCC entity itself. Captures incorporation, headcount projections, and autonomy posture relevant to the transformation."},{"name":"MaturityDimension","title":"MaturityDimension","retention_class":"operational","state_machine":null,"description":"A measurable axis on which a Workstream is scored against the canonical 5-level rubric (Ad-hoc -> Repeatable -> Defined -> Managed -> Optimised). Maturity Dimensions are typically defined by a WorkstreamPack."},{"name":"Milestone","title":"Milestone","retention_class":"operational","state_machine":"milestone","description":"A time-bound event in the programme (e.g., 'Entity incorporated', 'First payroll run from GCC'). Milestones are sequenced under Gates and blocked by open Decisions."},{"name":"ProgrammeMemoryEvent","title":"ProgrammeMemoryEvent","retention_class":"memory","state_machine":null,"description":"A durable, immutable record of WHY a thing happened: opposition, off-record context, similar-pattern citations, assumptions, invalidations, reversal reasons, lessons learned. Not an audit log entry (the events table is that). Programme Memory is a first-class entity that drives Programme Memory queries and embeddings-based retrieval. Per-type visibility defaults per Q3 / scope spec section 3.6. Immutable: corrections require a new event."},{"name":"Question","title":"Question","retention_class":"operational","state_machine":"question","description":"A discovery item that produces evidence in support of one or more Decisions. Questions are typically templated from a WorkstreamPack and instantiated per tenant."},{"name":"Risk","title":"Risk","retention_class":"operational","state_machine":null,"description":"A RAID Risk: a potential adverse event with probability, impact, and a mitigation plan. Risks are linked to Decisions, Capabilities, or Milestones via edges. Risks have a status enum but no formal state machine."},{"name":"Stakeholder","title":"Stakeholder","retention_class":"reference","state_machine":null,"description":"A person with one or more RACI roles across objects in this tenant. Stakeholder nodes are referenced from every RACI assignment. The idp_subject field bridges the in-graph Stakeholder identity to the SSO/Access identity once federation is wired."},{"name":"Tenant","title":"Tenant","retention_class":"reference","state_machine":null,"description":"A client engagement. Top-level isolation boundary for all per-tenant data (I1)."},{"name":"TransitionWave","title":"TransitionWave","retention_class":"operational","state_machine":null,"description":"A grouping of Capabilities that cut over together to the GCC. Waves are the unit of execution for the transition execution module (Phase 2)."},{"name":"Workstream","title":"Workstream","retention_class":"operational","state_machine":null,"description":"Second-level grouping under a Function (e.g., 'IT-Identity', 'AP Operations', 'Talent Acquisition'). Workstreams hold Questions and Capabilities and are typically instantiated from a WorkstreamPack."},{"name":"WorkstreamPack","title":"WorkstreamPack","retention_class":"provenance","state_machine":null,"description":"An installed instance of a versioned, opinionated bundle of workstreams + questions + suggested decisions + maturity rubric. Records WHICH pack was installed, at what version, against which registry hash (I14). Packs reference but cannot extend the central node-type vocabulary (I10)."}]}