@ai-sdlc/orchestrator 0.1.0

package/dist/state/schema.js

@@ -0,0 +1,264 @@
+/**
+ * SQLite DDL and migrations for the state store.
+ */
+export const CURRENT_SCHEMA_VERSION = 6;
+export const SCHEMA_DDL = `
+CREATE TABLE IF NOT EXISTS schema_version (
+  version INTEGER PRIMARY KEY,
+  applied_at TEXT DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS complexity_profile (
+  id INTEGER PRIMARY KEY,
+  repo_path TEXT NOT NULL,
+  score REAL NOT NULL,
+  files_count INTEGER,
+  modules_count INTEGER,
+  dependency_count INTEGER,
+  analyzed_at TEXT DEFAULT (datetime('now')),
+  raw_data TEXT
+);
+
+CREATE TABLE IF NOT EXISTS episodic_memory (
+  id INTEGER PRIMARY KEY,
+  issue_number INTEGER,
+  pr_number INTEGER,
+  pipeline_type TEXT NOT NULL,
+  outcome TEXT NOT NULL,
+  duration_ms INTEGER,
+  files_changed INTEGER,
+  error_message TEXT,
+  metadata TEXT,
+  created_at TEXT DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS autonomy_ledger (
+  id INTEGER PRIMARY KEY,
+  agent_name TEXT NOT NULL UNIQUE,
+  current_level INTEGER DEFAULT 0,
+  total_tasks INTEGER DEFAULT 0,
+  success_count INTEGER DEFAULT 0,
+  failure_count INTEGER DEFAULT 0,
+  last_task_at TEXT,
+  metrics TEXT
+);
+
+CREATE TABLE IF NOT EXISTS pipeline_runs (
+  id INTEGER PRIMARY KEY,
+  run_id TEXT NOT NULL UNIQUE,
+  issue_number INTEGER,
+  pr_number INTEGER,
+  pipeline_type TEXT NOT NULL,
+  status TEXT NOT NULL,
+  current_stage TEXT,
+  started_at TEXT DEFAULT (datetime('now')),
+  completed_at TEXT,
+  result TEXT,
+  gate_results TEXT
+);
+
+CREATE TABLE IF NOT EXISTS conventions (
+  id INTEGER PRIMARY KEY,
+  category TEXT NOT NULL,
+  pattern TEXT NOT NULL,
+  confidence REAL,
+  examples TEXT,
+  detected_at TEXT DEFAULT (datetime('now'))
+);
+`;
+export const MIGRATION_V2 = `
+ALTER TABLE complexity_profile ADD COLUMN architectural_patterns TEXT;
+ALTER TABLE complexity_profile ADD COLUMN hotspots TEXT;
+ALTER TABLE complexity_profile ADD COLUMN module_graph TEXT;
+ALTER TABLE complexity_profile ADD COLUMN conventions_data TEXT;
+
+CREATE TABLE IF NOT EXISTS hotspots (
+  id INTEGER PRIMARY KEY,
+  repo_path TEXT NOT NULL,
+  file_path TEXT NOT NULL,
+  churn_rate REAL NOT NULL,
+  complexity INTEGER NOT NULL,
+  commit_count INTEGER,
+  last_modified TEXT,
+  note TEXT,
+  analyzed_at TEXT DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS routing_history (
+  id INTEGER PRIMARY KEY,
+  issue_number INTEGER,
+  task_complexity INTEGER,
+  codebase_complexity REAL,
+  routing_strategy TEXT NOT NULL,
+  agent_name TEXT,
+  reason TEXT,
+  decided_at TEXT DEFAULT (datetime('now'))
+);
+`;
+export const MIGRATION_V3 = `
+-- Cost tracking
+CREATE TABLE IF NOT EXISTS cost_ledger (
+  id INTEGER PRIMARY KEY,
+  run_id TEXT NOT NULL,
+  agent_name TEXT NOT NULL,
+  pipeline_type TEXT NOT NULL,
+  model TEXT,
+  input_tokens INTEGER DEFAULT 0,
+  output_tokens INTEGER DEFAULT 0,
+  total_tokens INTEGER DEFAULT 0,
+  cost_usd REAL DEFAULT 0.0,
+  issue_number INTEGER,
+  pr_number INTEGER,
+  created_at TEXT DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_cost_ledger_run ON cost_ledger(run_id);
+CREATE INDEX IF NOT EXISTS idx_cost_ledger_agent ON cost_ledger(agent_name);
+
+-- Gate threshold overrides per complexity band
+CREATE TABLE IF NOT EXISTS gate_threshold_overrides (
+  id INTEGER PRIMARY KEY,
+  gate_name TEXT NOT NULL,
+  complexity_band TEXT NOT NULL,
+  enforcement_level TEXT NOT NULL,
+  threshold_overrides TEXT,
+  active INTEGER DEFAULT 1,
+  created_at TEXT DEFAULT (datetime('now')),
+  UNIQUE(gate_name, complexity_band)
+);
+
+-- Autonomy event log (immutable)
+CREATE TABLE IF NOT EXISTS autonomy_events (
+  id INTEGER PRIMARY KEY,
+  agent_name TEXT NOT NULL,
+  event_type TEXT NOT NULL,
+  from_level INTEGER NOT NULL,
+  to_level INTEGER NOT NULL,
+  trigger TEXT,
+  metrics_snapshot TEXT,
+  unmet_conditions TEXT,
+  created_at TEXT DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_autonomy_events_agent ON autonomy_events(agent_name);
+
+-- Extend autonomy_ledger
+ALTER TABLE autonomy_ledger ADD COLUMN pr_approval_rate REAL DEFAULT 0.0;
+ALTER TABLE autonomy_ledger ADD COLUMN rollback_count INTEGER DEFAULT 0;
+ALTER TABLE autonomy_ledger ADD COLUMN security_incidents INTEGER DEFAULT 0;
+ALTER TABLE autonomy_ledger ADD COLUMN promoted_at TEXT;
+ALTER TABLE autonomy_ledger ADD COLUMN demoted_at TEXT;
+ALTER TABLE autonomy_ledger ADD COLUMN time_at_level_ms INTEGER DEFAULT 0;
+
+-- Extend episodic_memory
+ALTER TABLE episodic_memory ADD COLUMN agent_name TEXT;
+ALTER TABLE episodic_memory ADD COLUMN complexity_score INTEGER;
+ALTER TABLE episodic_memory ADD COLUMN routing_strategy TEXT;
+ALTER TABLE episodic_memory ADD COLUMN gate_pass_count INTEGER;
+ALTER TABLE episodic_memory ADD COLUMN gate_fail_count INTEGER;
+ALTER TABLE episodic_memory ADD COLUMN cost_usd REAL;
+ALTER TABLE episodic_memory ADD COLUMN is_regression INTEGER DEFAULT 0;
+ALTER TABLE episodic_memory ADD COLUMN related_episodes TEXT;
+
+-- Extend pipeline_runs
+ALTER TABLE pipeline_runs ADD COLUMN cost_usd REAL DEFAULT 0.0;
+ALTER TABLE pipeline_runs ADD COLUMN tokens_used INTEGER DEFAULT 0;
+ALTER TABLE pipeline_runs ADD COLUMN model TEXT;
+ALTER TABLE pipeline_runs ADD COLUMN agent_name TEXT;
+ALTER TABLE pipeline_runs ADD COLUMN complexity_score INTEGER;
+`;
+export const MIGRATION_V4 = `
+-- Handoff audit trail
+CREATE TABLE IF NOT EXISTS handoff_events (
+  id INTEGER PRIMARY KEY,
+  run_id TEXT NOT NULL,
+  from_agent TEXT NOT NULL,
+  to_agent TEXT NOT NULL,
+  payload_hash TEXT,
+  validation_result TEXT NOT NULL,
+  error_message TEXT,
+  created_at TEXT DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_handoff_events_run ON handoff_events(run_id);
+`;
+export const MIGRATION_V5 = `
+-- Deployment records
+CREATE TABLE IF NOT EXISTS deployments (
+  id INTEGER PRIMARY KEY,
+  deployment_id TEXT NOT NULL UNIQUE,
+  target_name TEXT NOT NULL,
+  provider TEXT NOT NULL,
+  version TEXT NOT NULL,
+  environment TEXT NOT NULL,
+  state TEXT NOT NULL,
+  url TEXT,
+  error TEXT,
+  started_at TEXT DEFAULT (datetime('now')),
+  completed_at TEXT
+);
+CREATE INDEX IF NOT EXISTS idx_deployments_target ON deployments(target_name);
+CREATE INDEX IF NOT EXISTS idx_deployments_env ON deployments(environment);
+
+-- Rollout step records
+CREATE TABLE IF NOT EXISTS rollout_steps (
+  id INTEGER PRIMARY KEY,
+  deployment_id TEXT NOT NULL,
+  step_number INTEGER NOT NULL,
+  weight_percent INTEGER NOT NULL,
+  state TEXT NOT NULL,
+  metrics_snapshot TEXT,
+  started_at TEXT DEFAULT (datetime('now')),
+  completed_at TEXT,
+  FOREIGN KEY (deployment_id) REFERENCES deployments(deployment_id)
+);
+CREATE INDEX IF NOT EXISTS idx_rollout_steps_deployment ON rollout_steps(deployment_id);
+
+-- Audit entries (indexed, queryable)
+CREATE TABLE IF NOT EXISTS audit_entries (
+  id INTEGER PRIMARY KEY,
+  entry_id TEXT NOT NULL UNIQUE,
+  actor TEXT NOT NULL,
+  action TEXT NOT NULL,
+  resource_type TEXT,
+  resource_id TEXT,
+  detail TEXT,
+  hash TEXT,
+  previous_hash TEXT,
+  signature TEXT,
+  created_at TEXT DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_audit_entries_actor ON audit_entries(actor);
+CREATE INDEX IF NOT EXISTS idx_audit_entries_action ON audit_entries(action);
+CREATE INDEX IF NOT EXISTS idx_audit_entries_resource ON audit_entries(resource_type, resource_id);
+CREATE INDEX IF NOT EXISTS idx_audit_entries_created ON audit_entries(created_at);
+`;
+export const MIGRATION_V6 = `
+-- Cost governance: add stage_name and cache_read_tokens to cost_ledger
+ALTER TABLE cost_ledger ADD COLUMN stage_name TEXT;
+ALTER TABLE cost_ledger ADD COLUMN cache_read_tokens INTEGER DEFAULT 0;
+`;
+export const MIGRATIONS = [
+    {
+        version: 1,
+        sql: SCHEMA_DDL,
+    },
+    {
+        version: 2,
+        sql: MIGRATION_V2,
+    },
+    {
+        version: 3,
+        sql: MIGRATION_V3,
+    },
+    {
+        version: 4,
+        sql: MIGRATION_V4,
+    },
+    {
+        version: 5,
+        sql: MIGRATION_V5,
+    },
+    {
+        version: 6,
+        sql: MIGRATION_V6,
+    },
+];
+//# sourceMappingURL=schema.js.map

package/dist/state/store.d.ts

@@ -0,0 +1,109 @@
+/**
+ * SQLite-backed state store for the AI-SDLC orchestrator.
+ *
+ * Uses better-sqlite3 for synchronous operations. The state store is
+ * optional — the orchestrator works without it.
+ */
+import type BetterSqlite3 from 'better-sqlite3';
+import type { ComplexityProfile, EpisodicRecord, AutonomyLedgerEntry, PipelineRun, PipelineRunStatus, Convention, HotspotRecord, RoutingDecision, CostLedgerEntry, GateThresholdOverride, AutonomyEvent, HandoffEvent, DeploymentRecord, DeploymentRecordState, RolloutStepRecord, AuditEntryRecord } from './types.js';
+export declare class StateStore {
+    private db;
+    constructor(db: BetterSqlite3.Database);
+    /**
+     * Create a StateStore from a file path or :memory: for testing.
+     */
+    static open(pathOrDb: string | BetterSqlite3.Database): StateStore;
+    private migrate;
+    saveComplexityProfile(profile: ComplexityProfile): number;
+    getLatestComplexityProfile(repoPath: string): ComplexityProfile | undefined;
+    private mapComplexityProfile;
+    saveEpisodicRecord(record: EpisodicRecord): number;
+    getEpisodicRecords(issueNumber?: number, limit?: number): EpisodicRecord[];
+    private mapEpisodicRecord;
+    getAutonomyLedger(agentName: string): AutonomyLedgerEntry | undefined;
+    upsertAutonomyLedger(entry: AutonomyLedgerEntry): void;
+    getAllAutonomyLedgerEntries(): AutonomyLedgerEntry[];
+    private mapAutonomyLedger;
+    savePipelineRun(run: PipelineRun): number;
+    updatePipelineRunStatus(runId: string, status: PipelineRunStatus, opts?: {
+        currentStage?: string;
+        result?: string;
+        gateResults?: string;
+    }): void;
+    getPipelineRun(runId: string): PipelineRun | undefined;
+    getPipelineRuns(issueNumber?: number, limit?: number): PipelineRun[];
+    private mapPipelineRun;
+    saveConvention(convention: Convention): number;
+    getConventions(category?: string): Convention[];
+    private mapConvention;
+    saveHotspot(record: HotspotRecord): number;
+    getHotspots(repoPath: string, limit?: number): HotspotRecord[];
+    private mapHotspot;
+    saveRoutingDecision(decision: RoutingDecision): number;
+    getRoutingHistory(limit?: number): RoutingDecision[];
+    private mapRoutingDecision;
+    saveCostEntry(entry: CostLedgerEntry): number;
+    getCostEntries(opts?: {
+        runId?: string;
+        agentName?: string;
+        since?: string;
+        limit?: number;
+    }): CostLedgerEntry[];
+    getCostSummary(since?: string): {
+        totalCostUsd: number;
+        totalTokens: number;
+        entryCount: number;
+    };
+    private mapCostEntry;
+    saveGateThresholdOverride(override: GateThresholdOverride): number;
+    getGateThresholdOverrides(gateName?: string, complexityBand?: string): GateThresholdOverride[];
+    saveAutonomyEvent(event: AutonomyEvent): number;
+    getAutonomyEvents(agentName?: string, limit?: number): AutonomyEvent[];
+    searchEpisodicRecords(opts: {
+        agentName?: string;
+        outcome?: string;
+        since?: string;
+        files?: string;
+        limit?: number;
+    }): EpisodicRecord[];
+    /**
+     * Save a full codebase profile with JSON-serialized analysis data.
+     * Also saves individual hotspot records.
+     */
+    saveCodebaseProfile(profile: ComplexityProfile): number;
+    saveHandoffEvent(event: Omit<HandoffEvent, 'id' | 'createdAt'>): number;
+    getHandoffEvents(runId?: string, limit?: number): HandoffEvent[];
+    saveDeployment(record: Omit<DeploymentRecord, 'id'>): number;
+    updateDeployment(deploymentId: string, update: {
+        state: DeploymentRecordState;
+        url?: string;
+        error?: string;
+        completedAt?: string;
+    }): void;
+    getDeployment(deploymentId: string): DeploymentRecord | undefined;
+    getDeployments(opts?: {
+        targetName?: string;
+        environment?: string;
+        limit?: number;
+    }): DeploymentRecord[];
+    private mapDeployment;
+    saveRolloutStep(record: Omit<RolloutStepRecord, 'id'>): number;
+    getRolloutSteps(deploymentId: string): RolloutStepRecord[];
+    saveAuditEntry(record: Omit<AuditEntryRecord, 'id'>): number;
+    queryAuditEntries(opts?: {
+        actor?: string;
+        action?: string;
+        resourceType?: string;
+        resourceId?: string;
+        since?: string;
+        until?: string;
+        limit?: number;
+        offset?: number;
+    }): AuditEntryRecord[];
+    getAuditEntry(entryId: string): AuditEntryRecord | undefined;
+    private mapAuditEntry;
+    /** Expose the underlying database for direct queries (e.g. dashboard). */
+    getDatabase(): BetterSqlite3.Database;
+    close(): void;
+}
+//# sourceMappingURL=store.d.ts.map