limen-ai 1.0.0

package/dist/techniques/interfaces/tgp_types.js

@@ -0,0 +1,160 @@
+/**
+ * TGP (Technique Governance Protocol) — Frozen Type Definitions
+ * Spec ref: TGP v1.0 Design Source (FINAL), Architecture Freeze CF-12/CF-13
+ *
+ * Phase: v3.3.0 — Technique Governance Truth Model
+ * Status: FROZEN — derived from design source, no implementation exists.
+ *
+ * This file defines every type, interface, error code, event, and constant
+ * for the technique governance protocol. Every field traces to a design
+ * source section or a resolved ambiguity.
+ *
+ * EXISTING v3.2 DEPENDENCIES (additive-only):
+ *   - TechniqueStore (src/learning/store/technique_store.ts)
+ *   - TechniqueApplicator (src/learning/applicator/technique_applicator.ts)
+ *   - QuarantineManager (src/learning/quarantine/quarantine_manager.ts)
+ *   - ColdStartManager (src/learning/cold_start/cold_start_manager.ts)
+ *   - CrossAgentTransfer (src/learning/transfer/cross_agent_transfer.ts)
+ *   All are additive-only. TGP extends, never modifies.
+ *
+ * LAYER ISOLATION: TGP defines its own TGPTechniqueStatus independently
+ * from v3.2's TechniqueStatus. Implementation amendment will reconcile.
+ */
+// ============================================================================
+// State Transitions [§5.1, TGP-I2]
+// ============================================================================
+/**
+ * Valid status transitions per TGP-I2. [CF-12, §5.1]
+ *
+ * candidate → active:    Promotion gate (TGP-I3)
+ * candidate → retired:   Lifecycle bound expiry or manual (TGP-I6)
+ * active → suspended:    Quarantine (I-10) or manual
+ * active → retired:      §29.6 threshold or manual
+ * suspended → active:    Restoration (CF-01, explicit governed action)
+ * suspended → retired:   Retirement from suspension
+ * retired → []:          Terminal — no transitions out
+ *
+ * No backward transitions to candidate. No skip from candidate to suspended.
+ */
+export const TGP_STATUS_TRANSITIONS = {
+    candidate: ['active', 'retired'],
+    active: ['suspended', 'retired'],
+    suspended: ['active', 'retired'],
+    retired: [],
+};
+// ============================================================================
+// Error Codes
+// ============================================================================
+/** Promotion error codes. [TGP-I3, TGP-I4, TGP-I5] */
+export const TGP_PROMOTION_ERROR_CODES = {
+    /** No evaluation evidence exists. [TGP-I3 req 1] */
+    NO_EVALUATION_EVIDENCE: 'TGP_PROMOTION_NO_EVALUATION_EVIDENCE',
+    /** No qualifying evaluation source. Transfer-only evidence rejected. [AMB-03, §6.2] */
+    INSUFFICIENT_EVALUATION_SOURCE: 'TGP_PROMOTION_INSUFFICIENT_EVALUATION_SOURCE',
+    /** Candidate is quarantine-blocked. [TGP-I5] */
+    TECHNIQUE_SOURCE_QUARANTINED: 'TGP_PROMOTION_TECHNIQUE_SOURCE_QUARANTINED',
+    /** Confidence threshold not met. [TGP-I3 req 4] */
+    THRESHOLD_NOT_MET: 'TGP_PROMOTION_THRESHOLD_NOT_MET',
+    /** Technique is not in candidate status. [TGP-I2] */
+    NOT_CANDIDATE: 'TGP_PROMOTION_NOT_CANDIDATE',
+    /** Technique already promoted. [§6.3] */
+    ALREADY_PROMOTED: 'TGP_PROMOTION_ALREADY_PROMOTED',
+    /** CF-13 audit fields incomplete. [TGP-I4] */
+    AUDIT_INCOMPLETE: 'TGP_PROMOTION_AUDIT_INCOMPLETE',
+    /** Confidence threshold is invalid (NaN, Infinity, or below floor). [DC-TGP-411] */
+    INVALID_THRESHOLD: 'TGP_PROMOTION_INVALID_THRESHOLD',
+};
+/** Lifecycle error codes. [TGP-I2] */
+export const TGP_LIFECYCLE_ERROR_CODES = {
+    /** Backward transition to candidate attempted. [TGP-I2] */
+    BACKWARD_TRANSITION: 'TGP_LIFECYCLE_BACKWARD_TRANSITION',
+    /** Invalid transition from current status. [TGP-I2] */
+    INVALID_TRANSITION: 'TGP_LIFECYCLE_INVALID_TRANSITION',
+    /** Content modification attempted. [TGP-I1] */
+    CONTENT_IMMUTABLE: 'TGP_LIFECYCLE_CONTENT_IMMUTABLE',
+    /** Type modification attempted. [TGP-I1] */
+    TYPE_IMMUTABLE: 'TGP_LIFECYCLE_TYPE_IMMUTABLE',
+    /** Transition out of retired attempted. [TGP-I2] */
+    RETIRED_TERMINAL: 'TGP_LIFECYCLE_RETIRED_TERMINAL',
+    /** Candidate → suspended attempted (must pass through active). [TGP-I2] */
+    CANDIDATE_SKIP_SUSPENDED: 'TGP_LIFECYCLE_CANDIDATE_SKIP_SUSPENDED',
+};
+/** Quarantine error codes. [TGP-I5] */
+export const TGP_QUARANTINE_ERROR_CODES = {
+    /** Technique has no source memories to quarantine against. [§8] */
+    NO_SOURCE_MEMORIES: 'TGP_QUARANTINE_NO_SOURCE_MEMORIES',
+    /** Memory not found in technique's source list. */
+    MEMORY_NOT_IN_SOURCES: 'TGP_QUARANTINE_MEMORY_NOT_IN_SOURCES',
+};
+/** Evaluation error codes. [§6.2] */
+export const TGP_EVALUATION_ERROR_CODES = {
+    /** Technique not found. */
+    TECHNIQUE_NOT_FOUND: 'TGP_EVALUATION_TECHNIQUE_NOT_FOUND',
+    /** Invalid confidence score (not in 0.0-1.0). [§6.2] */
+    INVALID_CONFIDENCE_SCORE: 'TGP_EVALUATION_INVALID_CONFIDENCE_SCORE',
+    /** Evaluation not found. */
+    EVALUATION_NOT_FOUND: 'TGP_EVALUATION_NOT_FOUND',
+};
+/** Candidate retention error codes. [TGP-I6] */
+export const TGP_RETENTION_ERROR_CODES = {
+    /** Technique is not a candidate. [TGP-I6] */
+    NOT_CANDIDATE: 'TGP_RETENTION_NOT_CANDIDATE',
+};
+/** Template registration error codes. [PSD-1] */
+export const TGP_TEMPLATE_ERROR_CODES = {
+    /** Template contains no techniques. */
+    EMPTY_TEMPLATE: 'TGP_TEMPLATE_EMPTY',
+    /** Duplicate template application (idempotency check). */
+    TEMPLATE_ALREADY_APPLIED: 'TGP_TEMPLATE_ALREADY_APPLIED',
+    /** Atomic transaction failed. */
+    TRANSACTION_FAILED: 'TGP_TEMPLATE_TRANSACTION_FAILED',
+    /** Template evaluation evidence has invalid confidence score (NaN, Infinity, or out of range). [DC-TGP-109] */
+    INVALID_CONFIDENCE_SCORE: 'TGP_TEMPLATE_INVALID_CONFIDENCE_SCORE',
+};
+// ============================================================================
+// Events [§9]
+// ============================================================================
+/**
+ * TGP events — 8 events per §9. [DERIVED: from v3.2 §10]
+ *
+ * All carry: techniqueId, agentId, timestamp, and transition-specific payload.
+ */
+export const TGP_EVENTS = {
+    /** Technique created as candidate. Scope: agent. Propagation: local. */
+    TECHNIQUE_EXTRACTED: 'technique.extracted',
+    /** candidate → active. Scope: agent. Propagation: up. Payload: promotionDecisionId. */
+    TECHNIQUE_PROMOTED: 'technique.promoted',
+    /** Promotion attempted but rejected. Scope: agent. Propagation: local. */
+    TECHNIQUE_PROMOTION_REJECTED: 'technique.promotion_rejected',
+    /** active → suspended. Scope: agent. Propagation: up. Payload: reason. */
+    TECHNIQUE_SUSPENDED: 'technique.suspended',
+    /** suspended → active. Scope: agent. Propagation: up. */
+    TECHNIQUE_RESTORED: 'technique.restored',
+    /** any → retired. Scope: agent. Propagation: local. Payload: retiredReason. */
+    TECHNIQUE_RETIRED: 'technique.retired',
+    /** quarantinedAt set on candidate. Scope: agent. Propagation: up. Payload: source memory ID. */
+    TECHNIQUE_QUARANTINE_BLOCKED: 'technique.quarantine_blocked',
+    /** quarantinedAt cleared on candidate. Scope: agent. Propagation: local. */
+    TECHNIQUE_QUARANTINE_CLEARED: 'technique.quarantine_cleared',
+};
+// ============================================================================
+// Configuration Constants
+// ============================================================================
+/** Default candidate retention period in days. [TGP-I6, V1-CHOICE] */
+export const DEFAULT_CANDIDATE_RETENTION_DAYS = 90;
+/**
+ * Default promotion confidence threshold. [AMB-02]
+ * Derived from CT-TGP-23's test setup which uses 0.5.
+ * Configurable per deployment.
+ */
+export const DEFAULT_PROMOTION_CONFIDENCE_THRESHOLD = 0.5;
+/**
+ * Evaluation sources that qualify for sole-basis promotion. [§6.2, AMB-03]
+ * transfer_history is EXCLUDED — it alone cannot satisfy the gate.
+ */
+export const QUALIFYING_EVALUATION_SOURCES = [
+    'runtime',
+    'template',
+    'manual',
+];
+//# sourceMappingURL=tgp_types.js.map

package/dist/techniques/interfaces/tgp_types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tgp_types.js","sourceRoot":"","sources":["../../../src/techniques/interfaces/tgp_types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAyGH,+EAA+E;AAC/E,mCAAmC;AACnC,+EAA+E;AAE/E;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAwE;IACzG,SAAS,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;IAChC,MAAM,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;IAChC,SAAS,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;IAChC,OAAO,EAAE,EAAE;CACH,CAAC;AAujBX,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E,sDAAsD;AACtD,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,oDAAoD;IACpD,sBAAsB,EAAE,sCAAsC;IAC9D,uFAAuF;IACvF,8BAA8B,EAAE,8CAA8C;IAC9E,gDAAgD;IAChD,4BAA4B,EAAE,4CAA4C;IAC1E,mDAAmD;IACnD,iBAAiB,EAAE,iCAAiC;IACpD,qDAAqD;IACrD,aAAa,EAAE,6BAA6B;IAC5C,yCAAyC;IACzC,gBAAgB,EAAE,gCAAgC;IAClD,8CAA8C;IAC9C,gBAAgB,EAAE,gCAAgC;IAClD,oFAAoF;IACpF,iBAAiB,EAAE,iCAAiC;CAC5C,CAAC;AAEX,sCAAsC;AACtC,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,2DAA2D;IAC3D,mBAAmB,EAAE,mCAAmC;IACxD,uDAAuD;IACvD,kBAAkB,EAAE,kCAAkC;IACtD,+CAA+C;IAC/C,iBAAiB,EAAE,iCAAiC;IACpD,4CAA4C;IAC5C,cAAc,EAAE,8BAA8B;IAC9C,oDAAoD;IACpD,gBAAgB,EAAE,gCAAgC;IAClD,2EAA2E;IAC3E,wBAAwB,EAAE,wCAAwC;CAC1D,CAAC;AAEX,uCAAuC;AACvC,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,mEAAmE;IACnE,kBAAkB,EAAE,mCAAmC;IACvD,mDAAmD;IACnD,qBAAqB,EAAE,sCAAsC;CACrD,CAAC;AAEX,qCAAqC;AACrC,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,2BAA2B;IAC3B,mBAAmB,EAAE,oCAAoC;IACzD,wDAAwD;IACxD,wBAAwB,EAAE,yCAAyC;IACnE,4BAA4B;IAC5B,oBAAoB,EAAE,0BAA0B;CACxC,CAAC;AAEX,gDAAgD;AAChD,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,6CAA6C;IAC7C,aAAa,EAAE,6BAA6B;CACpC,CAAC;AAEX,iDAAiD;AACjD,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,uCAAuC;IACvC,cAAc,EAAE,oBAAoB;IACpC,0DAA0D;IAC1D,wBAAwB,EAAE,8BAA8B;IACxD,iCAAiC;IACjC,kBAAkB,EAAE,iCAAiC;IACrD,+GAA+G;IAC/G,wBAAwB,EAAE,uCAAuC;CACzD,CAAC;AAEX,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,wEAAwE;IACxE,mBAAmB,EAAE,qBAAqB;IAC1C,uFAAuF;IACvF,kBAAkB,EAAE,oBAAoB;IACxC,0EAA0E;IAC1E,4BAA4B,EAAE,8BAA8B;IAC5D,0EAA0E;IAC1E,mBAAmB,EAAE,qBAAqB;IAC1C,yDAAyD;IACzD,kBAAkB,EAAE,oBAAoB;IACxC,+EAA+E;IAC/E,iBAAiB,EAAE,mBAAmB;IACtC,gGAAgG;IAChG,4BAA4B,EAAE,8BAA8B;IAC5D,4EAA4E;IAC5E,4BAA4B,EAAE,8BAA8B;CACpD,CAAC;AAEX,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E,sEAAsE;AACtE,MAAM,CAAC,MAAM,gCAAgC,GAAG,EAAE,CAAC;AAEnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAG,GAAG,CAAC;AAE1D;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAgC;IACxE,SAAS;IACT,UAAU;IACV,QAAQ;CACA,CAAC"}

package/dist/techniques/migration/020_tgp_governance.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Forward-only migration v29: TGP (Technique Governance Protocol) Schema Extensions
+ * Spec ref: TGP v1.0 Design Source §5-§9, Architecture Freeze CF-12/CF-13
+ *
+ * Phase: 1 (TGP)
+ *
+ * Changes to learning_techniques (table rebuild — SQLite cannot ALTER CHECK/NOT NULL):
+ *   - status CHECK: adds 'candidate' state [CF-12, §5.1]
+ *   - success_rate: NOT NULL → nullable [AMB-05, DC-TGP-905]
+ *   - default status: 'active' → 'candidate' [PSD-1]
+ *   - New columns: provenance_kind, quarantined_at, promoted_at,
+ *     promotion_decision_id, transfer_source_technique_id, retired_at, retired_reason
+ *
+ * New tables:
+ *   - technique_evaluations [§6.2, PSD-2]
+ *   - technique_promotion_decisions [§6.3, CF-13]
+ *
+ * Triggers:
+ *   - TGP-I1: content, type, source_memory_ids, provenance_kind immutable
+ *   - TGP-I2: no backward to candidate, retired terminal, no candidate→suspended
+ *   - DC-TGP-211: promotion fields immutable once set
+ *   - Evaluation/decision immutability (no UPDATE, no DELETE)
+ *
+ * Invariants enforced:
+ *   TGP-I1: Immutable technique definition (trigger-enforced)
+ *   TGP-I2: Forward-only lifecycle (trigger-enforced)
+ *   TGP-I4: CF-13 audit sufficiency (schema-enforced NOT NULL on CF-13 fields)
+ *   TGP-I5: Quarantine promotion block (quarantined_at column)
+ */
+import type { MigrationEntry } from '../../kernel/interfaces/index.js';
+/**
+ * Get TGP (Technique Governance Protocol) migration.
+ * Version 29 continues from CCP's version 28.
+ */
+export declare function getTgpGovernanceMigration(): MigrationEntry[];
+//# sourceMappingURL=020_tgp_governance.d.ts.map

package/dist/techniques/migration/020_tgp_governance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"020_tgp_governance.d.ts","sourceRoot":"","sources":["../../../src/techniques/migration/020_tgp_governance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAqNvE;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,cAAc,EAAE,CAI5D"}

package/dist/techniques/migration/020_tgp_governance.js

@@ -0,0 +1,249 @@
+/**
+ * Forward-only migration v29: TGP (Technique Governance Protocol) Schema Extensions
+ * Spec ref: TGP v1.0 Design Source §5-§9, Architecture Freeze CF-12/CF-13
+ *
+ * Phase: 1 (TGP)
+ *
+ * Changes to learning_techniques (table rebuild — SQLite cannot ALTER CHECK/NOT NULL):
+ *   - status CHECK: adds 'candidate' state [CF-12, §5.1]
+ *   - success_rate: NOT NULL → nullable [AMB-05, DC-TGP-905]
+ *   - default status: 'active' → 'candidate' [PSD-1]
+ *   - New columns: provenance_kind, quarantined_at, promoted_at,
+ *     promotion_decision_id, transfer_source_technique_id, retired_at, retired_reason
+ *
+ * New tables:
+ *   - technique_evaluations [§6.2, PSD-2]
+ *   - technique_promotion_decisions [§6.3, CF-13]
+ *
+ * Triggers:
+ *   - TGP-I1: content, type, source_memory_ids, provenance_kind immutable
+ *   - TGP-I2: no backward to candidate, retired terminal, no candidate→suspended
+ *   - DC-TGP-211: promotion fields immutable once set
+ *   - Evaluation/decision immutability (no UPDATE, no DELETE)
+ *
+ * Invariants enforced:
+ *   TGP-I1: Immutable technique definition (trigger-enforced)
+ *   TGP-I2: Forward-only lifecycle (trigger-enforced)
+ *   TGP-I4: CF-13 audit sufficiency (schema-enforced NOT NULL on CF-13 fields)
+ *   TGP-I5: Quarantine promotion block (quarantined_at column)
+ */
+import { createHash } from 'node:crypto';
+const MIGRATION_029_SQL = `
+-- Migration 029: TGP (Technique Governance Protocol) Schema Extensions
+-- Spec ref: TGP v1.0 Design Source, Architecture Freeze CF-12/CF-13
+-- Phase: 1 (TGP)
+
+-- ============================================================================
+-- Step 1: Rebuild learning_techniques with TGP extensions
+-- SQLite cannot ALTER CHECK constraints or change NOT NULL → nullable.
+-- Table rebuild required. [DC-TGP-905]
+-- ============================================================================
+
+-- Drop triggers that reference the old table
+DROP TRIGGER IF EXISTS learning_techniques_tenant_immutable;
+
+-- Rename old table
+ALTER TABLE learning_techniques RENAME TO _learning_techniques_v32;
+
+-- Create new table with TGP extensions
+CREATE TABLE learning_techniques (
+  id                           TEXT    PRIMARY KEY,
+  tenant_id                    TEXT    NOT NULL,
+  agent_id                     TEXT    NOT NULL,
+  type                         TEXT    NOT NULL CHECK (type IN ('prompt_fragment', 'decision_rule', 'rag_pattern')),
+  content                      TEXT    NOT NULL,
+  source_memory_ids            TEXT    NOT NULL,
+  confidence                   REAL    NOT NULL,
+  success_rate                 REAL,
+  application_count            INTEGER NOT NULL DEFAULT 0,
+  last_applied                 TEXT,
+  last_updated                 TEXT    NOT NULL,
+  status                       TEXT    NOT NULL DEFAULT 'candidate'
+                               CHECK (status IN ('candidate', 'active', 'suspended', 'retired')),
+  created_at                   TEXT    NOT NULL,
+  provenance_kind              TEXT    DEFAULT 'local_extraction'
+                               CHECK (provenance_kind IN ('local_extraction', 'cross_agent_transfer', 'template_seed')),
+  quarantined_at               TEXT,
+  promoted_at                  TEXT,
+  promotion_decision_id        TEXT,
+  transfer_source_technique_id TEXT,
+  retired_at                   TEXT,
+  retired_reason               TEXT    CHECK (retired_reason IS NULL OR retired_reason IN (
+                                 'low_success_rate', 'low_confidence', 'stale', 'human_flagged',
+                                 'candidate_expiry', 'quarantine_permanent'))
+);
+
+-- Copy v3.2 data (existing techniques are active with local_extraction provenance)
+INSERT INTO learning_techniques (
+  id, tenant_id, agent_id, type, content, source_memory_ids,
+  confidence, success_rate, application_count, last_applied,
+  last_updated, status, created_at,
+  provenance_kind
+)
+SELECT
+  id, tenant_id, agent_id, type, content, source_memory_ids,
+  confidence, success_rate, application_count, last_applied,
+  last_updated, status, created_at,
+  'local_extraction'
+FROM _learning_techniques_v32;
+
+-- Drop backup
+DROP TABLE _learning_techniques_v32;
+
+-- Recreate indexes
+CREATE INDEX IF NOT EXISTS idx_lt_tenant_agent ON learning_techniques(tenant_id, agent_id);
+CREATE INDEX IF NOT EXISTS idx_lt_tenant_agent_status ON learning_techniques(tenant_id, agent_id, status);
+CREATE INDEX IF NOT EXISTS idx_lt_tenant_status ON learning_techniques(tenant_id, status);
+
+-- ============================================================================
+-- Step 2: Triggers for TGP invariants on learning_techniques
+-- ============================================================================
+
+-- Tenant immutability (restored from v3.2 migration 016)
+CREATE TRIGGER IF NOT EXISTS learning_techniques_tenant_immutable
+  BEFORE UPDATE OF tenant_id ON learning_techniques
+  WHEN OLD.tenant_id IS NOT NULL AND NEW.tenant_id IS NOT OLD.tenant_id
+  BEGIN
+    SELECT RAISE(ABORT, 'I-MUT: tenant_id is immutable after INSERT on learning_techniques');
+  END;
+
+-- TGP-I1: Content immutability (content, type, source_memory_ids, provenance_kind)
+CREATE TRIGGER IF NOT EXISTS tgp_content_immutable
+  BEFORE UPDATE ON learning_techniques
+  WHEN NEW.content IS NOT OLD.content
+    OR NEW.type IS NOT OLD.type
+    OR NEW.source_memory_ids IS NOT OLD.source_memory_ids
+    OR (OLD.provenance_kind IS NOT NULL AND NEW.provenance_kind IS NOT OLD.provenance_kind)
+  BEGIN
+    SELECT RAISE(ABORT, 'TGP-I1: content, type, source_memory_ids, provenance_kind are immutable');
+  END;
+
+-- TGP-I2: No backward transition to candidate
+CREATE TRIGGER IF NOT EXISTS tgp_no_backward_to_candidate
+  BEFORE UPDATE OF status ON learning_techniques
+  WHEN NEW.status = 'candidate' AND OLD.status != 'candidate'
+  BEGIN
+    SELECT RAISE(ABORT, 'TGP-I2: backward transition to candidate is prohibited');
+  END;
+
+-- TGP-I2: Retired is terminal
+CREATE TRIGGER IF NOT EXISTS tgp_retired_terminal
+  BEFORE UPDATE OF status ON learning_techniques
+  WHEN OLD.status = 'retired' AND NEW.status != 'retired'
+  BEGIN
+    SELECT RAISE(ABORT, 'TGP-I2: retired is a terminal state');
+  END;
+
+-- TGP-I2: Candidate cannot skip to suspended
+CREATE TRIGGER IF NOT EXISTS tgp_candidate_no_suspended
+  BEFORE UPDATE OF status ON learning_techniques
+  WHEN OLD.status = 'candidate' AND NEW.status = 'suspended'
+  BEGIN
+    SELECT RAISE(ABORT, 'TGP-I2: candidate cannot transition directly to suspended');
+  END;
+
+-- DC-TGP-211: Promotion fields immutable once set
+CREATE TRIGGER IF NOT EXISTS tgp_promotion_fields_immutable
+  BEFORE UPDATE ON learning_techniques
+  WHEN OLD.promoted_at IS NOT NULL
+    AND (NEW.promoted_at IS NOT OLD.promoted_at
+      OR NEW.promotion_decision_id IS NOT OLD.promotion_decision_id)
+  BEGIN
+    SELECT RAISE(ABORT, 'TGP: promotion fields (promoted_at, promotion_decision_id) are immutable after set');
+  END;
+
+-- ============================================================================
+-- Step 3: Technique Evaluations table [§6.2, PSD-2]
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS technique_evaluations (
+  id                    TEXT    PRIMARY KEY,
+  technique_id          TEXT    NOT NULL,
+  agent_id              TEXT    NOT NULL,
+  tenant_id             TEXT    NOT NULL,
+  evaluator_agent_id    TEXT    NOT NULL,
+  mission_id            TEXT,
+  evaluation_source     TEXT    NOT NULL CHECK (evaluation_source IN ('runtime', 'template', 'transfer_history', 'manual')),
+  baseline_performance  TEXT    NOT NULL,
+  technique_performance TEXT    NOT NULL,
+  comparison_result     TEXT    NOT NULL,
+  confidence_score      REAL,
+  evaluation_method     TEXT    NOT NULL CHECK (evaluation_method IN ('shadow_execution', 'dedicated_task', 'retrospective', 'human_review', 'template_provided')),
+  created_at            TEXT    NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_te_tenant_technique ON technique_evaluations(tenant_id, technique_id);
+CREATE INDEX IF NOT EXISTS idx_te_tenant ON technique_evaluations(tenant_id);
+
+-- Evaluations are immutable after creation
+CREATE TRIGGER IF NOT EXISTS tgp_evaluation_immutable
+  BEFORE UPDATE ON technique_evaluations
+  BEGIN
+    SELECT RAISE(ABORT, 'TGP: technique_evaluations records are immutable after creation');
+  END;
+
+-- Evaluations cannot be deleted
+CREATE TRIGGER IF NOT EXISTS tgp_evaluation_no_delete
+  BEFORE DELETE ON technique_evaluations
+  BEGIN
+    SELECT RAISE(ABORT, 'TGP: technique_evaluations cannot be deleted');
+  END;
+
+-- ============================================================================
+-- Step 4: Technique Promotion Decisions table [§6.3, CF-13]
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS technique_promotion_decisions (
+  id                        TEXT    PRIMARY KEY,
+  technique_id              TEXT    NOT NULL,
+  agent_id                  TEXT    NOT NULL,
+  tenant_id                 TEXT    NOT NULL,
+  decided_by                TEXT    NOT NULL,
+  evaluation_lineage        TEXT    NOT NULL,
+  confidence_threshold      REAL,
+  decision_rule             TEXT    NOT NULL,
+  activation_basis          TEXT    NOT NULL,
+  policy_version            TEXT    NOT NULL,
+  evaluation_schema_version TEXT    NOT NULL,
+  threshold_config_version  TEXT    NOT NULL,
+  result                    TEXT    NOT NULL CHECK (result IN ('promoted', 'rejected')),
+  rejection_reason          TEXT,
+  decided_at                TEXT    NOT NULL,
+  activated_at              TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_tpd_tenant_technique ON technique_promotion_decisions(tenant_id, technique_id);
+CREATE INDEX IF NOT EXISTS idx_tpd_tenant ON technique_promotion_decisions(tenant_id);
+
+-- Promotion decisions are immutable after creation
+CREATE TRIGGER IF NOT EXISTS tgp_decision_immutable
+  BEFORE UPDATE ON technique_promotion_decisions
+  BEGIN
+    SELECT RAISE(ABORT, 'TGP: technique_promotion_decisions records are immutable after creation');
+  END;
+
+-- Promotion decisions cannot be deleted
+CREATE TRIGGER IF NOT EXISTS tgp_decision_no_delete
+  BEFORE DELETE ON technique_promotion_decisions
+  BEGIN
+    SELECT RAISE(ABORT, 'TGP: technique_promotion_decisions cannot be deleted');
+  END;
+`;
+function buildEntry(version, name, sql) {
+    return {
+        version,
+        name,
+        sql,
+        checksum: createHash('sha256').update(sql).digest('hex'),
+    };
+}
+/**
+ * Get TGP (Technique Governance Protocol) migration.
+ * Version 29 continues from CCP's version 28.
+ */
+export function getTgpGovernanceMigration() {
+    return [
+        buildEntry(29, 'tgp_governance', MIGRATION_029_SQL),
+    ];
+}
+//# sourceMappingURL=020_tgp_governance.js.map

package/dist/techniques/migration/020_tgp_governance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"020_tgp_governance.js","sourceRoot":"","sources":["../../../src/techniques/migration/020_tgp_governance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwMzB,CAAC;AAEF,SAAS,UAAU,CAAC,OAAe,EAAE,IAAY,EAAE,GAAW;IAC5D,OAAO;QACL,OAAO;QACP,IAAI;QACJ,GAAG;QACH,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;KACzD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO;QACL,UAAU,CAAC,EAAE,EAAE,gBAAgB,EAAE,iBAAiB,CAAC;KACpD,CAAC;AACJ,CAAC"}

package/dist/techniques/store/tgp_stores.d.ts

@@ -0,0 +1,36 @@
+/**
+ * TGP (Technique Governance Protocol) Store Implementations — SQLite-backed.
+ * Replaces NotImplementedError stubs in tgp_harness.ts.
+ *
+ * Phase: 1 (TGP)
+ * Implements: TechniqueEvaluationStore, PromotionDecisionStore,
+ *   PromotionGate, TGPQuarantineCascade, CandidateRetentionEvaluator,
+ *   TGPInferenceFilter, TemplateRegistrar.
+ *
+ * Pattern: Follows src/governance/stores/governance_stores.ts and
+ *          src/claims/store/claim_stores.ts.
+ *
+ * Truth model obligations:
+ *   TGP-I1: Content immutability (trigger-enforced + application guard)
+ *   TGP-I2: Forward-only lifecycle (trigger-enforced + application guard)
+ *   TGP-I3: Promotion requires evaluation evidence
+ *   TGP-I4: CF-13 audit sufficiency (all 5 fields populated)
+ *   TGP-I5: Quarantine blocks promotion (quarantinedAt check)
+ *   TGP-I6: Candidate lifecycle bound (retention period)
+ *   TGP-I7: Trust-independent validation (no trust shortcuts)
+ *   TGP-I8: Candidate excluded from inference
+ */
+import type { DatabaseConnection } from '../../kernel/interfaces/database.js';
+import type { TechniqueGovernor, TechniqueGovernorDeps } from '../interfaces/tgp_types.js';
+/**
+ * Create the TGP TechniqueGovernor facade with real SQLite-backed implementations.
+ *
+ * Replaces the NOT_IMPLEMENTED harness. All methods backed by real SQL.
+ * Schema must be initialized via migration 029 before calling any method.
+ *
+ * @param deps - External dependencies (audit, events)
+ * @param conn - Database connection for DC-TGP-908 PRAGMA verification
+ * @returns Frozen TechniqueGovernor with all subsystems wired
+ */
+export declare function createTechniqueGovernorImpl(deps: TechniqueGovernorDeps, conn?: DatabaseConnection): TechniqueGovernor;
+//# sourceMappingURL=tgp_stores.d.ts.map

package/dist/techniques/store/tgp_stores.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tgp_stores.d.ts","sourceRoot":"","sources":["../../../src/techniques/store/tgp_stores.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAM9E,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EAwBtB,MAAM,4BAA4B,CAAC;AA8qCpC;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,qBAAqB,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,iBAAiB,CAsBrH"}