shynlee04/hivemind-plugin/hm-l3-hivemind-state-reference

.hivemind/
├── archive/                  # Archived session artifacts
├── cycle2/                   # Cycle 2 persistent data
├── daily-notes/              # Session daily notes
├── event-tracker/            # Session event journals (JSON + Markdown)
│   └── ses_XXXX.{json,md}    # One pair per session
├── journal/                  # Session journals (YYYY-MM-DD.jsonl)
├── lineage/                  # Execution lineage records
├── research/                 # Deep research cached artifacts
└── state/                    # Core state persistence ← PRIMARY
    ├── session-continuity.json   # Cross-session state (ContinuityStoreFile)
    ├── delegations.json          # Active/completed delegation records
    ├── config-workflows.json     # Workflow configuration state
    ├── SESSION-STATE.md          # WAL-protocol session state (markdown)
    ├── task_plan.md              # Planning-with-files task plan
    ├── findings.md               # Planning-with-files findings
    ├── progress.md               # Planning-with-files progress
    ├── session-context-prompt.md # Session context prompt storage
    ├── baseline-*.md             # Audit baselines (timestamped)
    ├── planning/                 # Task persistence (hm-planning-persistence)
    │   └── stack-skill-reset-*/  # Per-reset planning state
    └── .patches/                 # Patch history

ContinuityStoreFile = {
  version: number           // Schema version (currently 1)
  updatedAt: number         // Unix timestamp (ms) of last write
  sessions: Record<string, SessionContinuityRecord>
  governance: GovernancePersistenceState
}
SessionContinuityRecord = {
  sessionID: string         // OpenCode session ID (ses_XXXX)
  promptParams: object      // Prompt creation parameters
  toolProfile?: object      // Allowed/denied tools
  metadata: {
    status: TaskStatus      // pending | queued | running | completed | failed | error | cancelled | interrupt
    description: string
    delegation: DelegationMeta | null
    category?: string
    constraints: string[]
    lifecycle?: SessionLifecycleState  // current phase + transition history
    pendingNotifications: PendingNotification[]  // Queued parent-session notifications
    resultCapture?: CapturedResult
    compactionCheckpoint?: CompactionCheckpointData
    delegationPacket?: DelegationPacket
    route?: string
    lastToolActivityAt?: number
    updatedAt: number
  }
}
SessionLifecycleState = {
  phase: SessionLifecyclePhase  // created | queued | dispatching | running | completed | failed
  observation?: { source: string; observedAt: number; detail: string }
  error?: string
  transitionHistory?: Array<{ from: SessionLifecyclePhase; to: SessionLifecyclePhase; at: number }>
}
PendingNotification = {
  sessionID: string
  description: string
  agent: string
  status: "started" | "completed" | "failed" | "cancelled"
  error?: string
  resultPreview?: string
  briefSummary?: string
  outputLink?: string
  duration?: number
  metadata?: {
    delegationId: string
    terminalState: DelegationStatus
    recoveryGuarantee?: "resumable" | "best-effort" | "non-resumable-after-restart"
    summaryPreview?: string
  }
  createdAt: number
  delivered: boolean
}

Delegation = {
  id: string                          // UUID delegation ID
  parentSessionId: string             // Caller session
  childSessionId: string              // Spawned child session
  agent: string                       // Agent name dispatched
  status: DelegationStatus            // dispatched | running | completed | error | timeout
  createdAt: number                   // Unix timestamp (ms)
  safetyCeilingMs: number             // Max duration (default: 30 min)
  lastMessageCount: number            // For dual-signal completion detection
  stablePollCount: number             // Consecutive stable polls
  lastMessageCountChangeAt: number    // Timestamp of last message change
  nestingDepth: number                // Delegation chain depth (max: 3)
  executionMode: "sdk" | "pty"        // Dispatch mechanism
  workingDirectory: string            // Working directory for child
  queueKey: string                    // Concurrency lane key
  surface: "agent-delegation" | "command-process"
  recoveryGuarantee: "resumable" | "best-effort" | "non-resumable-after-restart"
  explicitCancellation: boolean       // User explicitly cancelled
  completedAt?: number
  error?: string
  terminalDetail?: string
  resultBriefSummary?: string
  gracePeriodExpiresAt?: number
}

EventTrackerRecord = {
  sessionId: string
  events: Array<{
    type: string
    source: string          // Hook source (session, tool, plugin)
    timestamp: number       // Unix timestamp (ms)
    data?: Record<string, unknown>
  }>
}

ConfigWorkflowsStore = {
  version: number
  updatedAt: number
  workflows: Record<string, ConfigWorkflow>
}
ConfigWorkflow = {
  id: string
  type: string                    // e.g., "batch-config"
  currentTurn: number             // Current workflow turn (0-indexed)
  turns: Record<string, {         // Turn number → status
    status: "pending" | "complete" | "failed"
    output: object | null
    completedAt?: number
  }>
  targetPrimitives: Array<{       // Primitives being configured
    type: "agent" | "command" | "skill" | "tool"
    name: string
  }>
  scope: "project" | "user"
  mode: string
  startedAt: number
  updatedAt: number
}

.hivemind/state/planning/
└── {reset-name}-YYYY-MM-DD/    # Per-reset planning directory
    ├── task_plan.md            # Task breakdown and status
    ├── findings.md             # Research findings and evidence
    └── progress.md             # Session progress tracking

# SESSION-STATE.md — Title
**WAL Protocol: Write BEFORE responding. Survives compaction.**
 
## Current Task
[Task description]
 
## Key Context
[Context bullets]
 
## Pending Actions
-[ ] [Checklist items]
 
## Recent Decisions
| Decision | Rationale | When |
|----------|-----------|------|