State Schema

The active orchestrator runtime state target is:

./orchestrator/data/orchestrator-state.json

The canonical schema lives in:

workspace/orchestrator/src/types.ts

This document is a current summary, not a replacement for the source type definitions.

Root Structure

interface OrchestratorState {
  lastStartedAt: string | null;
  updatedAt: string | null;
  indexedDocs: number;
  docIndexVersion: number;
  pendingDocChanges: string[];
  taskHistory: TaskRecord[];
  taskExecutions: TaskExecutionRecord[];
  approvals: ApprovalRecord[];
  driftRepairs: DriftRepairRecord[];
  redditQueue: RedditQueueItem[];
  redditResponses: RedditReplyRecord[];
  agentDeployments: AgentDeploymentRecord[];
  rssDrafts: RssDraftRecord[];
  rssSeenIds: string[];
  governedSkillState: PersistedGovernedSkillRecord[];
  incidentLedger: IncidentLedgerRecord[];
  workflowEvents: WorkflowEventRecord[];
  relationshipObservations: RelationshipObservationRecord[];
  lastDriftRepairAt: string | null;
  lastRedditResponseAt: string | null;
  lastAgentDeployAt: string | null;
  lastRssSweepAt: string | null;
  lastNightlyBatchAt?: string | null;
  lastDigestNotificationAt?: string | null;
}

Important Collections

Field	Purpose
pendingDocChanges	buffered file paths waiting for sync/repair
taskHistory	recent task outcomes
taskExecutions	larger execution record set keyed by explicit idempotency key or task-id fallback
approvals	pending and completed approval records
driftRepairs	drift-repair run history
redditQueue	queued community work
redditResponses	completed Reddit helper outputs
agentDeployments	deployment record history
rssDrafts	scored RSS-derived content candidates
rssSeenIds	bounded dedupe set for RSS items
governedSkillState	persisted governed-skill intake and review state
incidentLedger	bounded incident history for runtime, repair, proof, and trust issues
workflowEvents	ordered workflow-stage evidence for runs, approvals, proof, and result flow
relationshipObservations	observed topology edges and proof-surface relationships

Retention Behavior

Retention is enforced in code, not just documentation. The current limits are applied in:

workspace/orchestrator/src/state.ts

Examples of bounded collections:

• taskHistory
• taskExecutions
• approvals
• driftRepairs
• redditResponses
• agentDeployments
• rssDrafts
• rssSeenIds

If you need the exact current limits, use state.ts as the source of truth.

Important Rule

If this file conflicts with:

• orchestrator_config.json
• orchestrator/src/types.ts
• orchestrator/src/state.ts

then the code and config win.