@ai-sdlc/orchestrator 0.6.0 → 0.9.0

package/dist/scheduling/schedule-decision.js

@@ -0,0 +1,89 @@
+/**
+ * Schedule-aware dispatch decision per RFC §14.3. Implements the four schedule modes
+ * (now, off-peak, quota-permitting, defer-if-low-priority) on top of the
+ * SubscriptionLedger admission decision.
+ */
+import { isOffPeakAt, nextOffPeakStart } from './off-peak.js';
+const DEFAULT_OFF_PEAK_MAX_WAIT_MS = 8 * 60 * 60 * 1000; // PT8H
+export function evaluateSchedule(schedule, ctx) {
+    const now = ctx.now ?? (() => new Date());
+    const admission = ctx.ledger.admit(ctx.ledgerKey, ctx.plan, ctx.estimate);
+    switch (schedule) {
+        case 'now':
+            return interpretNow(admission);
+        case 'off-peak':
+            return interpretOffPeak(admission, ctx, now());
+        case 'quota-permitting':
+            return interpretQuotaPermitting(admission);
+        case 'defer-if-low-priority':
+            return interpretDeferIfLowPriority(admission, ctx, now());
+        default:
+            throw new Error(`Unknown schedule mode: ${String(schedule)}`);
+    }
+}
+function interpretNow(admission) {
+    if (admission.kind === 'yes')
+        return { kind: 'dispatch-now', reason: admission.reason };
+    if (admission.kind === 'wait-until')
+        return { kind: 'wait-until', until: admission.until, reason: admission.reason };
+    return { kind: 'denied', reason: admission.reason, blockedBy: admission.blockedBy };
+}
+function interpretOffPeak(admission, ctx, now) {
+    if (!ctx.plan.offPeak || !ctx.plan.offPeak.enabled) {
+        // No off-peak configured; behave as 'now'.
+        return interpretNow(admission);
+    }
+    if (isOffPeakAt(ctx.plan.offPeak, now)) {
+        return interpretNow(admission);
+    }
+    const next = nextOffPeakStart(ctx.plan.offPeak, now);
+    if (!next)
+        return interpretNow(admission);
+    const maxWaitMs = parseDurationMs(ctx.offPeakMaxWait) ?? DEFAULT_OFF_PEAK_MAX_WAIT_MS;
+    if (next.getTime() - now.getTime() <= maxWaitMs) {
+        return {
+            kind: 'wait-until',
+            until: next,
+            reason: 'next off-peak window within offPeakMaxWait',
+        };
+    }
+    // Off-peak too far in the future; fall through to dispatch-on-peak with a warning.
+    return { kind: 'dispatch-now', reason: 'OffPeakDeferralExceeded — dispatching on-peak' };
+}
+function interpretQuotaPermitting(admission) {
+    if (admission.kind === 'yes')
+        return { kind: 'dispatch-now', reason: admission.reason };
+    return { kind: 'requeue', reason: admission.reason };
+}
+function interpretDeferIfLowPriority(admission, ctx, now) {
+    // Top quartile of queue → dispatch immediately.
+    const isTopQuartile = ctx.ppaScore !== undefined && ctx.queueScores && isInTopQuartile(ctx.ppaScore, ctx.queueScores);
+    if (isTopQuartile)
+        return interpretNow(admission);
+    // >30% window headroom → dispatch immediately.
+    const ws = ctx.ledger.windowState(ctx.ledgerKey, ctx.plan);
+    const headroomFraction = 1 - ws.utilizationFraction;
+    if (headroomFraction > 0.3)
+        return interpretNow(admission);
+    // Otherwise behave as 'off-peak'.
+    return interpretOffPeak(admission, ctx, now);
+}
+function isInTopQuartile(score, queueScores) {
+    if (queueScores.length === 0)
+        return true;
+    const sorted = [...queueScores].sort((a, b) => b - a);
+    const cutoff = sorted[Math.floor(sorted.length / 4)] ?? sorted[0];
+    return score >= cutoff;
+}
+function parseDurationMs(duration) {
+    if (!duration)
+        return null;
+    const m = duration.match(/^P(?:(\d+)D)?(?:T(?:(\d+)H)?(?:(\d+)M)?)?$/);
+    if (!m)
+        return null;
+    const days = Number.parseInt(m[1] ?? '0', 10);
+    const hours = Number.parseInt(m[2] ?? '0', 10);
+    const minutes = Number.parseInt(m[3] ?? '0', 10);
+    return ((days * 24 + hours) * 60 + minutes) * 60 * 1000;
+}
+//# sourceMappingURL=schedule-decision.js.map

package/dist/scheduling/tier-analysis.d.ts

@@ -0,0 +1,47 @@
+/**
+ * TierAnalysis aggregator per RFC §14.13. Aggregates QuotaContention events per
+ * billing window and produces upgrade/downgrade recommendations consumed by the
+ * Slack daily digest and cli-tier-recommendation.
+ */
+import type { LedgerKey, SubscriptionPlan } from './types.js';
+export type Confidence = 'low' | 'medium' | 'high';
+export interface ContentionEvent {
+    timestamp: string;
+    /** Cumulative duration the high-PPA stage waited on hardCap. */
+    contentionDurationMs: number;
+}
+export interface TierAnalysisInput {
+    billingPeriod: string;
+    ledgerKey: LedgerKey;
+    currentPlan: SubscriptionPlan;
+    contentionEvents: ContentionEvent[];
+    issuesDeferredOffPeak: number;
+    issuesBlockedOnHardCap: number;
+    /** Candidate plans (typically: registered SubscriptionPlan resources). */
+    candidates: SubscriptionPlan[];
+}
+export interface TierAnalysisResult {
+    billingPeriod: string;
+    ledgerKey: LedgerKey;
+    currentPlan: string;
+    currentPlanCostUsd: number;
+    contentionEvents: number;
+    cumulativeContentionDurationMs: number;
+    issuesDeferredOffPeak: number;
+    issuesBlockedOnHardCap: number;
+    recommendedPlan: string;
+    recommendedPlanCostUsd: number;
+    projectedTimeSavedMs: number;
+    projectedAdditionalIssuesProcessed: number;
+    projectedSpilloverSavingsUsd: number;
+    confidence: Confidence;
+    reasoning: string;
+}
+/**
+ * Reference plan-cost table — the orchestrator typically has these populated from the
+ * SubscriptionPlan resources, but ships with sensible defaults so cli-tier-recommendation
+ * can produce useful output even on a fresh deployment.
+ */
+export declare const PLAN_COSTS_USD: Record<string, number>;
+export declare function analyzeTier(input: TierAnalysisInput): TierAnalysisResult;
+//# sourceMappingURL=tier-analysis.d.ts.map

package/dist/scheduling/tier-analysis.js

@@ -0,0 +1,81 @@
+/**
+ * TierAnalysis aggregator per RFC §14.13. Aggregates QuotaContention events per
+ * billing window and produces upgrade/downgrade recommendations consumed by the
+ * Slack daily digest and cli-tier-recommendation.
+ */
+/**
+ * Reference plan-cost table — the orchestrator typically has these populated from the
+ * SubscriptionPlan resources, but ships with sensible defaults so cli-tier-recommendation
+ * can produce useful output even on a fresh deployment.
+ */
+export const PLAN_COSTS_USD = {
+    'claude-code-pro': 20,
+    'claude-code-max-5x': 100,
+    'claude-code-max-20x': 200,
+    'codex-plus': 20,
+    'codex-pro': 200,
+    'pay-per-token': 0,
+};
+const HIGH_CONTENTION_THRESHOLD = 20;
+const MEDIUM_CONTENTION_THRESHOLD = 5;
+export function analyzeTier(input) {
+    const cumulative = input.contentionEvents.reduce((a, e) => a + e.contentionDurationMs, 0);
+    const confidence = confidenceFor(input.contentionEvents.length);
+    const currentPlanCost = PLAN_COSTS_USD[input.currentPlan.name] ?? 0;
+    // Find the candidate that minimizes expected contention, conservative for downgrades.
+    let recommended = input.currentPlan;
+    let recommendedCost = currentPlanCost;
+    if (input.contentionEvents.length > 0) {
+        // Upgrade direction: pick the next plan up.
+        const upgrade = nextPlanUp(input.currentPlan, input.candidates);
+        if (upgrade) {
+            recommended = upgrade;
+            recommendedCost = PLAN_COSTS_USD[upgrade.name] ?? currentPlanCost;
+        }
+    }
+    else if (confidence === 'high') {
+        // Possibly recommend downgrade if utilization is consistently low — we don't have
+        // utilization in this aggregation; defer to caller to set issuesBlockedOnHardCap=0
+        // and contentionEvents=0 explicitly. For now keep currentPlan as the recommendation.
+    }
+    const reasoning = buildReasoning(input, cumulative, recommended);
+    return {
+        billingPeriod: input.billingPeriod,
+        ledgerKey: input.ledgerKey,
+        currentPlan: input.currentPlan.name,
+        currentPlanCostUsd: currentPlanCost,
+        contentionEvents: input.contentionEvents.length,
+        cumulativeContentionDurationMs: cumulative,
+        issuesDeferredOffPeak: input.issuesDeferredOffPeak,
+        issuesBlockedOnHardCap: input.issuesBlockedOnHardCap,
+        recommendedPlan: recommended.name,
+        recommendedPlanCostUsd: recommendedCost,
+        projectedTimeSavedMs: cumulative * 0.75, // heuristic: upgrade reclaims ~75% of contention
+        projectedAdditionalIssuesProcessed: Math.floor(cumulative / (60 * 60 * 1000)), // 1 issue per hour saved
+        projectedSpilloverSavingsUsd: input.issuesBlockedOnHardCap * 1.5,
+        confidence,
+        reasoning,
+    };
+}
+function nextPlanUp(current, candidates) {
+    const sameHarness = candidates.filter((c) => c.harness === current.harness);
+    const ordered = sameHarness.sort((a, b) => (PLAN_COSTS_USD[a.name] ?? 0) - (PLAN_COSTS_USD[b.name] ?? 0));
+    const idx = ordered.findIndex((p) => p.name === current.name);
+    if (idx < 0 || idx === ordered.length - 1)
+        return null;
+    return ordered[idx + 1];
+}
+function confidenceFor(count) {
+    if (count > HIGH_CONTENTION_THRESHOLD)
+        return 'high';
+    if (count >= MEDIUM_CONTENTION_THRESHOLD)
+        return 'medium';
+    return 'low';
+}
+function buildReasoning(input, cumulativeMs, recommended) {
+    if (recommended.name === input.currentPlan.name) {
+        return `Current plan ${input.currentPlan.name} appears appropriately sized for observed contention (${input.contentionEvents.length} events, ${(cumulativeMs / 1000 / 60 / 60).toFixed(1)}h cumulative).`;
+    }
+    return `${input.currentPlan.name} hit hardCap on ${input.issuesBlockedOnHardCap} issues this period, totaling ${(cumulativeMs / 1000 / 60 / 60).toFixed(1)}h of cumulative wait. ${recommended.name} would project to keep utilization below pacingTarget at current dispatch rate.`;
+}
+//# sourceMappingURL=tier-analysis.js.map

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