@ai-sdlc/orchestrator 0.6.0 → 0.10.0

package/dist/scheduling/types.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Subscription-aware scheduling types per RFC-0010 §14. The dispatcher consults a
+ * SubscriptionLedger keyed by (harness, accountId, tenant) on every admission decision
+ * so parallel agents on the same vendor account correctly share quota.
+ */
+export type BillingMode = 'session-window' | 'monthly-cap' | 'pay-per-token';
+export type QuotaSource = 'self-tracked' | 'authoritative-api' | 'authoritative-with-fallback';
+export interface OffPeakSchedule {
+    enabled: boolean;
+    multiplier: number;
+    schedule: Array<{
+        /** IANA timezone (e.g., 'America/Los_Angeles'). */
+        tz: string;
+        /** Hour range like '22-06' (wraps midnight). */
+        hours: string;
+        /** Optional comma-separated days like 'Sat,Sun'. */
+        daysOfWeek?: string;
+    }>;
+    /** ISO 8601 date the operator last verified the schedule against vendor docs. */
+    lastVerified?: string;
+}
+export interface SubscriptionPlan {
+    /** Resource metadata.name. */
+    name: string;
+    /** Harness this plan applies to. */
+    harness: string;
+    billingMode: BillingMode;
+    /** Required when billingMode is session-window. ISO 8601 duration (e.g., 'PT5H'). */
+    windowDuration?: string;
+    /** Required when billingMode is session-window or monthly-cap. */
+    windowQuotaTokens?: number;
+    offPeak?: OffPeakSchedule;
+    pacingTarget: number;
+    hardCap: number;
+    quotaSource: QuotaSource;
+}
+export type Schedule = 'now' | 'off-peak' | 'quota-permitting' | 'defer-if-low-priority';
+export interface TokenEstimate {
+    input: number;
+    output: number;
+    /** When true, rolling updates do NOT supersede the operator-declared values. */
+    frozen?: boolean;
+}
+export interface LedgerKey {
+    harness: string;
+    accountId: string;
+    tenant: string;
+}
+export declare const DEFAULT_TENANT = "__default__";
+export declare const COLD_START_DEFAULT_INPUT = 50000;
+export declare const COLD_START_DEFAULT_OUTPUT = 10000;
+export declare const ESTIMATE_VARIANCE_THRESHOLD = 0.5;
+export declare const ROLLING_WINDOW_SIZE = 20;
+export interface WindowState {
+    windowStart: Date;
+    windowEnd: Date;
+    consumedTokens: number;
+    quotaTokens: number;
+    multiplier: number;
+    utilizationFraction: number;
+    pacingTarget: number;
+    hardCap: number;
+}
+export type AdmissionDecision = {
+    kind: 'yes';
+    reason: string;
+} | {
+    kind: 'wait-until';
+    until: Date;
+    reason: string;
+} | {
+    kind: 'no';
+    reason: string;
+    blockedBy: 'hardCap' | 'cost-budget' | 'maxBudgetUsd';
+};
+export interface BurnDownReport {
+    harness: string;
+    ledgerKey: LedgerKey;
+    windowEnd: string;
+    subscriptionTokensConsumed: number;
+    quotaTokens: number;
+    subscriptionUtilizationFraction: number;
+    dollarsSpent: number;
+    shadowCostUsd: number;
+    pacingTarget: number;
+    projectedUtilization: number;
+    queueDepth: number;
+    recommendation: 'under-pacing' | 'on-pace' | 'over-pacing';
+}
+export type LedgerEvent = {
+    type: 'AdmissionDenied';
+    ledgerKey: LedgerKey;
+    blockedBy: string;
+    detail: string;
+} | {
+    type: 'OffPeakDeferralExceeded';
+    ledgerKey: LedgerKey;
+    stage: string;
+} | {
+    type: 'BurnDownReport';
+    report: BurnDownReport;
+} | {
+    type: 'EstimateBootstrapped';
+    stage: string;
+    coldStartDefault: TokenEstimate;
+    firstRunActual: TokenEstimate;
+    newRollingEstimate: TokenEstimate;
+} | {
+    type: 'EstimateVariance';
+    stage: string;
+    declared: TokenEstimate;
+    observed: TokenEstimate;
+    ratio: number;
+} | {
+    type: 'MissingEstimate';
+    stage: string;
+} | {
+    type: 'LedgerReconciliation';
+    ledgerKey: LedgerKey;
+    previousSource: QuotaSource;
+    newSource: QuotaSource;
+    selfTracked: number;
+    authoritative: number;
+    absoluteDivergence: number;
+    relativeDivergence: number;
+} | {
+    type: 'LedgerPooled';
+    ledgerKey: LedgerKey;
+    pipelines: string[];
+} | {
+    type: 'LedgerKeyAmbiguous';
+    harness: string;
+    pipeline: string;
+} | {
+    type: 'TenantShareInvalid';
+    harness: string;
+    accountId: string;
+    sumOfShares: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/scheduling/types.js

@@ -0,0 +1,11 @@
+/**
+ * Subscription-aware scheduling types per RFC-0010 §14. The dispatcher consults a
+ * SubscriptionLedger keyed by (harness, accountId, tenant) on every admission decision
+ * so parallel agents on the same vendor account correctly share quota.
+ */
+export const DEFAULT_TENANT = '__default__';
+export const COLD_START_DEFAULT_INPUT = 50_000;
+export const COLD_START_DEFAULT_OUTPUT = 10_000;
+export const ESTIMATE_VARIANCE_THRESHOLD = 0.5;
+export const ROLLING_WINDOW_SIZE = 20;
+//# sourceMappingURL=types.js.map

package/dist/shared.d.ts

@@ -12,6 +12,19 @@ export declare function execFileAsync(cmd: string, args: string[], opts?: Record
  * Unknown keys are left as-is.
  */
 export declare function interpolate(text: string, vars: Record<string, string>): string;
+/**
+ * Build the standard set of template vars for branch / PR / notification interpolation.
+ * Provides backward-compatible {issueNumber} + {issueTitle} alongside backlog-friendly
+ * {issueId}, {issueIdLower}, {slug}.
+ */
+export declare function buildIssueTemplateVars(issueId: string, issueTitle: string): Record<string, string>;
+/**
+ * Convert an arbitrary string to a kebab-case slug suitable for branch names.
+ * Lowercases, replaces non-alphanumerics with single dashes, trims dashes from
+ * start/end, and truncates to 40 chars at a word boundary so the resulting
+ * branch name stays under git's path-component limits.
+ */
+export declare function slugify(input: string, maxLen?: number): string;
 /**
  * Interpolate a branch name pattern by replacing `{key}` placeholders.
  * Falls back to `ai-sdlc/issue-{issueNumber}` when no pattern is provided.

package/dist/shared.js

@@ -24,6 +24,38 @@ export function execFileAsync(cmd, args, opts) {
 export function interpolate(text, vars) {
     return text.replace(/\{(\w+)\}/g, (_, key) => vars[key] ?? `{${key}}`);
 }
+/**
+ * Build the standard set of template vars for branch / PR / notification interpolation.
+ * Provides backward-compatible {issueNumber} + {issueTitle} alongside backlog-friendly
+ * {issueId}, {issueIdLower}, {slug}.
+ */
+export function buildIssueTemplateVars(issueId, issueTitle) {
+    return {
+        issueNumber: issueId,
+        issueTitle,
+        issueId,
+        issueIdLower: issueId.toLowerCase(),
+        slug: slugify(issueTitle),
+    };
+}
+/**
+ * Convert an arbitrary string to a kebab-case slug suitable for branch names.
+ * Lowercases, replaces non-alphanumerics with single dashes, trims dashes from
+ * start/end, and truncates to 40 chars at a word boundary so the resulting
+ * branch name stays under git's path-component limits.
+ */
+export function slugify(input, maxLen = 40) {
+    const cleaned = input
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    if (cleaned.length <= maxLen)
+        return cleaned;
+    // Truncate at the last dash before maxLen so we don't cut a word in half.
+    const truncated = cleaned.slice(0, maxLen);
+    const lastDash = truncated.lastIndexOf('-');
+    return lastDash > maxLen / 2 ? truncated.slice(0, lastDash) : truncated;
+}
 /**
  * Interpolate a branch name pattern by replacing `{key}` placeholders.
  * Falls back to `ai-sdlc/issue-{issueNumber}` when no pattern is provided.

package/dist/state/schema.d.ts

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

package/dist/state/schema.js

@@ -1,7 +1,7 @@
 /**
  * SQLite DDL and migrations for the state store.
  */
-export const CURRENT_SCHEMA_VERSION = 9;
+export const CURRENT_SCHEMA_VERSION = 12;
 export const SCHEMA_DDL = `
 CREATE TABLE IF NOT EXISTS schema_version (
   version INTEGER PRIMARY KEY,
@@ -311,6 +311,212 @@ CREATE TABLE IF NOT EXISTS pattern_proposals (
 );
 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,
@@ -348,5 +554,21 @@ export const MIGRATIONS = [
         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, ToolSequenceEvent, WorkflowPattern, PatternProposal } 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);
@@ -134,6 +134,60 @@ export declare class StateStore {
         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