@ai-sdlc/orchestrator 0.5.0 → 0.9.0

package/dist/state/schema.js

@@ -1,7 +1,7 @@
 /**
  * SQLite DDL and migrations for the state store.
  */
-export const CURRENT_SCHEMA_VERSION = 8;
+export const CURRENT_SCHEMA_VERSION = 12;
 export const SCHEMA_DDL = `
 CREATE TABLE IF NOT EXISTS schema_version (
   version INTEGER PRIMARY KEY,
@@ -262,6 +262,261 @@ CREATE INDEX IF NOT EXISTS idx_priority_calibration_sampled ON priority_calibrat
 ALTER TABLE episodic_memory ADD COLUMN priority_composite REAL;
 ALTER TABLE episodic_memory ADD COLUMN priority_confidence REAL;
 `;
+export const MIGRATION_V9 = `
+-- Workflow pattern detection tables
+
+-- Tool sequence events captured by PostToolUse hook
+CREATE TABLE IF NOT EXISTS tool_sequence_events (
+  id INTEGER PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  tool_name TEXT NOT NULL,
+  action_canonical TEXT NOT NULL,
+  project_path TEXT,
+  timestamp TEXT NOT NULL,
+  ingested_at TEXT DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_tool_seq_session ON tool_sequence_events(session_id);
+CREATE INDEX IF NOT EXISTS idx_tool_seq_ts ON tool_sequence_events(timestamp);
+
+-- Detected workflow patterns (from n-gram mining)
+CREATE TABLE IF NOT EXISTS workflow_patterns (
+  id INTEGER PRIMARY KEY,
+  pattern_hash TEXT NOT NULL UNIQUE,
+  pattern_type TEXT NOT NULL,
+  sequence_json TEXT NOT NULL,
+  frequency INTEGER NOT NULL,
+  session_count INTEGER NOT NULL,
+  confidence REAL NOT NULL,
+  first_seen TEXT,
+  last_seen TEXT,
+  status TEXT DEFAULT 'detected',
+  detected_at TEXT DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_workflow_patterns_status ON workflow_patterns(status);
+
+-- Automation proposals for human review
+CREATE TABLE IF NOT EXISTS pattern_proposals (
+  id INTEGER PRIMARY KEY,
+  pattern_id INTEGER NOT NULL,
+  proposal_type TEXT NOT NULL,
+  artifact_type TEXT NOT NULL,
+  artifact_path TEXT,
+  draft_content TEXT NOT NULL,
+  confidence REAL NOT NULL,
+  status TEXT DEFAULT 'pending',
+  reviewed_at TEXT,
+  reviewer_reason TEXT,
+  created_at TEXT DEFAULT (datetime('now')),
+  FOREIGN KEY (pattern_id) REFERENCES workflow_patterns(id)
+);
+CREATE INDEX IF NOT EXISTS idx_pattern_proposals_status ON pattern_proposals(status);
+`;
+export const MIGRATION_V10 = `
+-- Design System Governance tables (RFC-0006)
+
+CREATE TABLE IF NOT EXISTS design_token_events (
+  id INTEGER PRIMARY KEY,
+  binding_name TEXT NOT NULL,
+  event_type TEXT NOT NULL,
+  tokens_affected INTEGER DEFAULT 0,
+  diff_json TEXT,
+  actor TEXT,
+  pipeline_run_id TEXT,
+  design_review_decision TEXT,
+  created_at TEXT DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_design_token_events_binding ON design_token_events(binding_name);
+CREATE INDEX IF NOT EXISTS idx_design_token_events_type ON design_token_events(event_type);
+CREATE INDEX IF NOT EXISTS idx_design_token_events_run ON design_token_events(pipeline_run_id);
+
+CREATE TABLE IF NOT EXISTS design_review_events (
+  id INTEGER PRIMARY KEY,
+  binding_name TEXT NOT NULL,
+  pr_number INTEGER,
+  component_name TEXT,
+  reviewer TEXT NOT NULL,
+  decision TEXT NOT NULL,
+  categories_json TEXT,
+  actionable_notes TEXT,
+  created_at TEXT DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_design_review_events_binding ON design_review_events(binding_name);
+CREATE INDEX IF NOT EXISTS idx_design_review_events_pr ON design_review_events(pr_number);
+CREATE INDEX IF NOT EXISTS idx_design_review_events_decision ON design_review_events(decision);
+
+CREATE TABLE IF NOT EXISTS token_compliance_history (
+  id INTEGER PRIMARY KEY,
+  binding_name TEXT NOT NULL,
+  coverage_percent REAL NOT NULL,
+  violations_count INTEGER NOT NULL DEFAULT 0,
+  scanned_at TEXT DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_token_compliance_binding ON token_compliance_history(binding_name);
+
+CREATE TABLE IF NOT EXISTS visual_regression_results (
+  id INTEGER PRIMARY KEY,
+  binding_name TEXT NOT NULL,
+  story_name TEXT NOT NULL,
+  viewport INTEGER,
+  diff_percentage REAL NOT NULL,
+  approved INTEGER DEFAULT 0,
+  approver TEXT,
+  baseline_url TEXT,
+  current_url TEXT,
+  created_at TEXT DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_visual_regression_binding ON visual_regression_results(binding_name);
+CREATE INDEX IF NOT EXISTS idx_visual_regression_story ON visual_regression_results(story_name);
+
+CREATE TABLE IF NOT EXISTS usability_simulation_results (
+  id INTEGER PRIMARY KEY,
+  binding_name TEXT NOT NULL,
+  story_name TEXT NOT NULL,
+  persona_id TEXT,
+  task_id TEXT,
+  completed INTEGER DEFAULT 0,
+  actions_taken INTEGER,
+  expected_actions INTEGER,
+  efficiency REAL,
+  findings_json TEXT,
+  created_at TEXT DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_usability_sim_binding ON usability_simulation_results(binding_name);
+CREATE INDEX IF NOT EXISTS idx_usability_sim_story ON usability_simulation_results(story_name);
+`;
+export const MIGRATION_V11 = `
+-- PPA Triad Integration tables (RFC-0008)
+
+-- Compiled DID artifacts: scope lists, constraint rules, anti-pattern lists,
+-- BM25 corpus (SA-1), principle corpora (SA-2). Keyed by source_hash so the
+-- reconciler can detect DID changes cheaply.
+CREATE TABLE IF NOT EXISTS did_compiled_artifacts (
+  id INTEGER PRIMARY KEY,
+  did_name TEXT NOT NULL,
+  namespace TEXT,
+  source_hash TEXT NOT NULL,
+  scope_lists_json TEXT,
+  constraint_rules_json TEXT,
+  anti_pattern_lists_json TEXT,
+  measurable_signals_json TEXT,
+  bm25_corpus_blob BLOB,
+  principle_corpora_blob BLOB,
+  compiled_at TEXT DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_did_compiled_did ON did_compiled_artifacts(did_name);
+CREATE INDEX IF NOT EXISTS idx_did_compiled_hash ON did_compiled_artifacts(source_hash);
+
+-- SA scoring events: layer 1/2/3 results per issue, phase weights, composite score.
+CREATE TABLE IF NOT EXISTS did_scoring_events (
+  id INTEGER PRIMARY KEY,
+  did_name TEXT NOT NULL,
+  issue_number INTEGER NOT NULL,
+  sa_dimension TEXT NOT NULL,
+  phase TEXT NOT NULL,
+  layer1_result_json TEXT,
+  layer2_result_json TEXT,
+  layer3_result_json TEXT,
+  composite_score REAL,
+  phase_weights_json TEXT,
+  created_at TEXT DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_did_scoring_did ON did_scoring_events(did_name);
+CREATE INDEX IF NOT EXISTS idx_did_scoring_issue ON did_scoring_events(issue_number);
+CREATE INDEX IF NOT EXISTS idx_did_scoring_created ON did_scoring_events(created_at);
+
+-- SA feedback events: accept/dismiss/escalate/override signals from Product/Design leads.
+-- Used by C6 calibration (M6) and Phase 3 weight auto-calibration.
+CREATE TABLE IF NOT EXISTS did_feedback_events (
+  id INTEGER PRIMARY KEY,
+  did_name TEXT NOT NULL,
+  issue_number INTEGER NOT NULL,
+  dimension TEXT NOT NULL,
+  signal TEXT NOT NULL CHECK (signal IN ('accept', 'dismiss', 'escalate', 'override')),
+  principal TEXT,
+  category TEXT,
+  structural_score REAL,
+  llm_score REAL,
+  composite_score REAL,
+  notes TEXT,
+  created_at TEXT DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_did_feedback_did ON did_feedback_events(did_name);
+CREATE INDEX IF NOT EXISTS idx_did_feedback_issue ON did_feedback_events(issue_number);
+CREATE INDEX IF NOT EXISTS idx_did_feedback_signal ON did_feedback_events(signal);
+CREATE INDEX IF NOT EXISTS idx_did_feedback_created ON did_feedback_events(created_at);
+
+-- Design change events: emitted when DID.spec.plannedChanges[] adds an entry.
+-- Addendum A §A.9 Design→Engineering lookahead.
+CREATE TABLE IF NOT EXISTS design_change_events (
+  id INTEGER PRIMARY KEY,
+  did_name TEXT NOT NULL,
+  change_id TEXT NOT NULL,
+  change_type TEXT NOT NULL,
+  status TEXT NOT NULL,
+  payload_json TEXT NOT NULL,
+  emitted_at TEXT DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_design_change_did ON design_change_events(did_name);
+CREATE INDEX IF NOT EXISTS idx_design_change_change ON design_change_events(change_id);
+
+-- Code area metrics: used by enrichAdmissionInput (C3) for defect risk factor
+-- and by DesignQualityTrendDegrading monitor (A.8).
+CREATE TABLE IF NOT EXISTS code_area_metrics (
+  id INTEGER PRIMARY KEY,
+  code_area TEXT NOT NULL,
+  defect_density REAL,
+  churn_rate REAL,
+  pr_rejection_rate REAL,
+  code_acceptance_rate REAL,
+  has_frontend_components INTEGER DEFAULT 0,
+  design_metrics_json TEXT,
+  data_point_count INTEGER DEFAULT 0,
+  window_start TEXT,
+  window_end TEXT,
+  computed_at TEXT DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_code_area_metrics_area ON code_area_metrics(code_area);
+CREATE INDEX IF NOT EXISTS idx_code_area_metrics_computed ON code_area_metrics(computed_at);
+
+-- Design lookahead notification state: dedupe per issue with 7-day expiry.
+-- Used by C7 (§11).
+CREATE TABLE IF NOT EXISTS design_lookahead_notifications (
+  id INTEGER PRIMARY KEY,
+  issue_number INTEGER NOT NULL,
+  first_notified_at TEXT DEFAULT (datetime('now')),
+  last_notified_at TEXT DEFAULT (datetime('now')),
+  pillar_breakdown_json TEXT,
+  UNIQUE(issue_number)
+);
+CREATE INDEX IF NOT EXISTS idx_lookahead_issue ON design_lookahead_notifications(issue_number);
+`;
+export const MIGRATION_V12 = `
+-- SA Phase-3 calibrated weights (RFC-0008 §B.8 — AISDLC-66).
+-- One row per dimension (SA-1, SA-2); upserted by the auto-calibrator
+-- nightly or on demand.
+-- CR-2 (RFC-0008 Addendum B §B.7): both weights MUST be ≥ 0.20 so
+-- neither layer can be dropped below a "minimum influence" floor by
+-- auto-calibration. The code-level clamp is the first gate; this
+-- CHECK is the last line of defense if the code clamp is bypassed.
+CREATE TABLE IF NOT EXISTS sa_phase_weights (
+  id INTEGER PRIMARY KEY,
+  dimension TEXT NOT NULL UNIQUE,
+  w_structural REAL NOT NULL,
+  w_llm REAL NOT NULL,
+  calibrated_at TEXT DEFAULT (datetime('now')),
+  CHECK (w_structural >= 0.20 AND w_structural <= 0.80),
+  CHECK (w_llm >= 0.20 AND w_llm <= 0.80)
+);
+CREATE INDEX IF NOT EXISTS idx_sa_phase_weights_dim ON sa_phase_weights(dimension);
+`;
+export const MIGRATION_V13 = `
+-- RFC-0010 §11.4 cost attribution: track the model alias used in pipeline YAML
+-- alongside the resolved physical model ID, plus an informational shadow cost
+-- (what subscription-harness work would have cost on pay-per-token).
+ALTER TABLE cost_ledger ADD COLUMN model_alias TEXT;
+ALTER TABLE cost_ledger ADD COLUMN shadow_cost_usd REAL;
+CREATE INDEX IF NOT EXISTS idx_cost_ledger_model_alias ON cost_ledger(model_alias);
+`;
 export const MIGRATIONS = [
     {
         version: 1,
@@ -295,5 +550,25 @@ export const MIGRATIONS = [
         version: 8,
         sql: MIGRATION_V8,
     },
+    {
+        version: 9,
+        sql: MIGRATION_V9,
+    },
+    {
+        version: 10,
+        sql: MIGRATION_V10,
+    },
+    {
+        version: 11,
+        sql: MIGRATION_V11,
+    },
+    {
+        version: 12,
+        sql: MIGRATION_V12,
+    },
+    {
+        version: 13,
+        sql: MIGRATION_V13,
+    },
 ];
 //# sourceMappingURL=schema.js.map

package/dist/state/store.d.ts

@@ -5,7 +5,7 @@
  * 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, PriorityCalibrationSample } from './types.js';
+import type { ComplexityProfile, EpisodicRecord, AutonomyLedgerEntry, PipelineRun, PipelineRunStatus, Convention, HotspotRecord, RoutingDecision, CostLedgerEntry, GateThresholdOverride, AutonomyEvent, HandoffEvent, DeploymentRecord, DeploymentRecordState, RolloutStepRecord, AuditEntryRecord, PriorityCalibrationSample, ToolSequenceEvent, WorkflowPattern, PatternProposal, DesignTokenEventRecord, DesignReviewEventRecord, TokenComplianceRecord, VisualRegressionResultRecord, UsabilitySimulationResultRecord, DidCompiledArtifactRecord, DidScoringEventRecord, SaDimension, DidFeedbackEventRecord, FeedbackSignal, DesignChangeEventRecord, CodeAreaMetricsRecord, DesignLookaheadNotificationRecord, SaPhaseWeightsRecord } from './types.js';
 export declare class StateStore {
     private db;
     constructor(db: BetterSqlite3.Database);
@@ -118,6 +118,76 @@ export declare class StateStore {
     }): number;
     /** Expose the underlying database for direct queries (e.g. dashboard). */
     getDatabase(): BetterSqlite3.Database;
+    saveToolSequenceEvent(event: ToolSequenceEvent): number;
+    saveToolSequenceEvents(events: ToolSequenceEvent[]): number;
+    getToolSequenceEvents(opts?: {
+        sessionId?: string;
+        since?: string;
+        limit?: number;
+    }): ToolSequenceEvent[];
+    saveWorkflowPattern(pattern: WorkflowPattern): number;
+    getWorkflowPatterns(opts?: {
+        status?: string;
+    }): WorkflowPattern[];
+    savePatternProposal(proposal: PatternProposal): number;
+    getPatternProposals(opts?: {
+        status?: string;
+    }): PatternProposal[];
+    updateProposalStatus(id: number, status: string, reason?: string): void;
+    insertDesignTokenEvent(record: DesignTokenEventRecord): number;
+    getDesignTokenEvents(bindingName: string, limit?: number): DesignTokenEventRecord[];
+    insertDesignReviewEvent(record: DesignReviewEventRecord): number;
+    getDesignReviewEvents(bindingName: string, limit?: number): DesignReviewEventRecord[];
+    insertTokenComplianceSnapshot(record: TokenComplianceRecord): number;
+    getTokenComplianceHistory(bindingName: string, limit?: number): TokenComplianceRecord[];
+    insertVisualRegressionResult(record: VisualRegressionResultRecord): number;
+    getVisualRegressionResults(bindingName: string, limit?: number): VisualRegressionResultRecord[];
+    insertUsabilitySimulationResult(record: UsabilitySimulationResultRecord): number;
+    getUsabilitySimulationResults(bindingName: string, limit?: number): UsabilitySimulationResultRecord[];
+    insertDidCompiledArtifact(record: DidCompiledArtifactRecord): number;
+    getLatestDidCompiledArtifact(didName: string): DidCompiledArtifactRecord | undefined;
+    getDidCompiledArtifactByHash(didName: string, sourceHash: string): DidCompiledArtifactRecord | undefined;
+    private mapDidCompiledArtifact;
+    recordDidScoringEvent(record: DidScoringEventRecord): number;
+    getDidScoringEvents(opts?: {
+        didName?: string;
+        issueNumber?: number;
+        saDimension?: SaDimension;
+        since?: string;
+        limit?: number;
+    }): DidScoringEventRecord[];
+    recordDidFeedback(record: DidFeedbackEventRecord): number;
+    getDidFeedbackEvents(opts?: {
+        didName?: string;
+        issueNumber?: number;
+        signal?: FeedbackSignal;
+        dimension?: SaDimension;
+        since?: string;
+        limit?: number;
+    }): DidFeedbackEventRecord[];
+    recordDesignChange(record: DesignChangeEventRecord): number;
+    getDesignChangeEvents(opts?: {
+        didName?: string;
+        changeId?: string;
+        limit?: number;
+    }): DesignChangeEventRecord[];
+    insertCodeAreaMetrics(record: CodeAreaMetricsRecord): number;
+    /**
+     * Get the most recent metrics snapshot for a code area.
+     * `since` filters to rows where `computed_at >= since`.
+     */
+    getCodeAreaMetrics(codeArea: string, opts?: {
+        since?: string;
+    }): CodeAreaMetricsRecord | undefined;
+    getCodeAreaMetricsHistory(codeArea: string, opts?: {
+        since?: string;
+        limit?: number;
+    }): CodeAreaMetricsRecord[];
+    private mapCodeAreaMetrics;
+    upsertDesignLookaheadNotification(record: DesignLookaheadNotificationRecord): number;
+    getDesignLookaheadNotification(issueNumber: number): DesignLookaheadNotificationRecord | undefined;
+    upsertSaPhaseWeights(record: SaPhaseWeightsRecord): void;
+    getSaPhaseWeights(dimension: SaDimension): SaPhaseWeightsRecord | undefined;
     close(): void;
 }
 //# sourceMappingURL=store.d.ts.map