@contentful/experience-design-system-cli 2.26.1-dev-build-a852362.0 → 2.26.1-dev-build-f03f014.0

package/dist/src/session/db.js

@@ -1,1538 +0,0 @@
-import { DatabaseSync } from 'node:sqlite';
-import { mkdirSync, readFileSync } from 'node:fs';
-import { createHash } from 'node:crypto';
-import { homedir } from 'node:os';
-import { dirname, resolve } from 'node:path';
-import { generateSessionId } from './session-id.js';
-const SCHEMA = `
-PRAGMA journal_mode = WAL;
-PRAGMA foreign_keys = ON;
-
-CREATE TABLE IF NOT EXISTS migrations (
-  name        TEXT NOT NULL PRIMARY KEY,
-  applied_at  TEXT NOT NULL
-);
-
-CREATE TABLE IF NOT EXISTS sessions (
-  id          TEXT NOT NULL PRIMARY KEY,
-  name        TEXT,
-  created_at  TEXT NOT NULL,
-  updated_at  TEXT NOT NULL
-);
-
-CREATE TABLE IF NOT EXISTS steps (
-  id            INTEGER PRIMARY KEY AUTOINCREMENT,
-  session_id    TEXT NOT NULL REFERENCES sessions(id) ON DELETE CASCADE,
-  command       TEXT NOT NULL,
-  status        TEXT NOT NULL DEFAULT 'pending',
-  started_at    TEXT NOT NULL,
-  completed_at  TEXT,
-  inputs        TEXT NOT NULL DEFAULT '{}',
-  outputs       TEXT NOT NULL DEFAULT '{}',
-  error         TEXT,
-  updated_at    TEXT NOT NULL
-);
-
-CREATE TABLE IF NOT EXISTS raw_components (
-  session_id             TEXT NOT NULL REFERENCES sessions(id) ON DELETE CASCADE,
-  component_id           TEXT NOT NULL,
-  name                   TEXT NOT NULL,
-  source                 TEXT NOT NULL,
-  framework              TEXT NOT NULL,
-  extracted_at           TEXT NOT NULL,
-  status                 TEXT NOT NULL DEFAULT 'extracted',
-  cdf_schema             TEXT,
-  description            TEXT,
-  extraction_confidence  INTEGER,
-  review_reasons         TEXT NOT NULL DEFAULT '[]',
-  needs_review           INTEGER NOT NULL DEFAULT 0,
-  source_path            TEXT,
-  reject_reason          TEXT,
-  PRIMARY KEY (session_id, component_id)
-);
-
-CREATE TABLE IF NOT EXISTS raw_props (
-  session_id        TEXT NOT NULL,
-  component_id      TEXT NOT NULL,
-  name              TEXT NOT NULL,
-  type              TEXT NOT NULL,
-  required          INTEGER NOT NULL CHECK (required IN (0, 1)),
-  category          TEXT CHECK (category IN ('content', 'design', 'state')),
-  default_value     TEXT,
-  description       TEXT,
-  token_reference   TEXT,
-  position          INTEGER NOT NULL,
-  cdf_type          TEXT,
-  cdf_category      TEXT CHECK (cdf_category IN ('content', 'design', 'state')),
-  cdf_token_kind    TEXT,
-  rationale         TEXT,
-  source_start_line INTEGER,
-  source_end_line   INTEGER,
-  PRIMARY KEY (session_id, component_id, name),
-  FOREIGN KEY (session_id, component_id) REFERENCES raw_components(session_id, component_id) ON DELETE CASCADE
-);
-
-CREATE TABLE IF NOT EXISTS raw_prop_allowed_values (
-  session_id   TEXT NOT NULL,
-  component_id TEXT NOT NULL,
-  prop_name    TEXT NOT NULL,
-  position     INTEGER NOT NULL,
-  value        TEXT NOT NULL,
-  PRIMARY KEY (session_id, component_id, prop_name, position),
-  FOREIGN KEY (session_id, component_id, prop_name) REFERENCES raw_props(session_id, component_id, name) ON DELETE CASCADE
-);
-
-CREATE TABLE IF NOT EXISTS raw_slots (
-  session_id   TEXT NOT NULL,
-  component_id TEXT NOT NULL,
-  name         TEXT NOT NULL,
-  is_default   INTEGER NOT NULL CHECK (is_default IN (0, 1)),
-  description  TEXT,
-  position     INTEGER NOT NULL,
-  required     INTEGER NOT NULL DEFAULT 1 CHECK (required IN (0, 1)),
-  PRIMARY KEY (session_id, component_id, name),
-  FOREIGN KEY (session_id, component_id) REFERENCES raw_components(session_id, component_id) ON DELETE CASCADE
-);
-
-CREATE TABLE IF NOT EXISTS raw_slot_allowed_components (
-  session_id        TEXT NOT NULL,
-  component_id      TEXT NOT NULL,
-  slot_name         TEXT NOT NULL,
-  position          INTEGER NOT NULL,
-  allowed_component TEXT NOT NULL,
-  PRIMARY KEY (session_id, component_id, slot_name, position),
-  FOREIGN KEY (session_id, component_id, slot_name) REFERENCES raw_slots(session_id, component_id, name) ON DELETE CASCADE
-);
-
-CREATE TABLE IF NOT EXISTS raw_token_groups (
-  session_id   TEXT NOT NULL REFERENCES sessions(id) ON DELETE CASCADE,
-  path         TEXT NOT NULL,
-  description  TEXT,
-  PRIMARY KEY (session_id, path)
-);
-
-CREATE TABLE IF NOT EXISTS raw_tokens (
-  session_id   TEXT NOT NULL,
-  path         TEXT NOT NULL,
-  type         TEXT NOT NULL,
-  value        TEXT NOT NULL,
-  description  TEXT,
-  PRIMARY KEY (session_id, path),
-  FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
-);
-
-CREATE TABLE IF NOT EXISTS generation_cache (
-  input_hash        TEXT NOT NULL,
-  entity_type       TEXT NOT NULL CHECK (entity_type IN ('component', 'token_set')),
-  entity_id         TEXT NOT NULL,
-  source_session_id TEXT NOT NULL REFERENCES sessions(id) ON DELETE CASCADE,
-  human_edited      INTEGER NOT NULL DEFAULT 0 CHECK (human_edited IN (0, 1)),
-  created_at        TEXT NOT NULL,
-  updated_at        TEXT NOT NULL,
-  PRIMARY KEY (input_hash, entity_type, entity_id)
-);
-
-CREATE TABLE IF NOT EXISTS scanned_files (
-  session_id  TEXT NOT NULL REFERENCES sessions(id) ON DELETE CASCADE,
-  path        TEXT NOT NULL,
-  PRIMARY KEY (session_id, path)
-);
-
-CREATE TABLE IF NOT EXISTS slot_cycles (
-  session_id             TEXT NOT NULL REFERENCES sessions(id) ON DELETE CASCADE,
-  cycle_index            INTEGER NOT NULL,
-  path_json              TEXT NOT NULL,
-  edges_json             TEXT NOT NULL,
-  suggested_break_json   TEXT,
-  PRIMARY KEY (session_id, cycle_index)
-);
-
-CREATE INDEX IF NOT EXISTS idx_steps_session            ON steps(session_id);
-CREATE INDEX IF NOT EXISTS idx_steps_command            ON steps(session_id, command);
-CREATE INDEX IF NOT EXISTS idx_raw_components_session   ON raw_components(session_id);
-CREATE INDEX IF NOT EXISTS idx_raw_props_session        ON raw_props(session_id, component_id);
-CREATE INDEX IF NOT EXISTS idx_raw_slots_session        ON raw_slots(session_id, component_id);
-CREATE INDEX IF NOT EXISTS idx_raw_tokens_session       ON raw_tokens(session_id);
-CREATE INDEX IF NOT EXISTS idx_raw_token_groups_session ON raw_token_groups(session_id);
-CREATE INDEX IF NOT EXISTS idx_generation_cache_entity  ON generation_cache(entity_type, entity_id);
-CREATE INDEX IF NOT EXISTS idx_generation_cache_session ON generation_cache(source_session_id);
-CREATE INDEX IF NOT EXISTS idx_scanned_files_session    ON scanned_files(session_id);
-`;
-export function getPipelineDbPath() {
-    if (process.env.EDS_PIPELINE_DB_PATH) {
-        return resolve(process.env.EDS_PIPELINE_DB_PATH);
-    }
-    return resolve(homedir(), '.contentful', 'experience-design-system-cli', 'pipeline.db');
-}
-export function openPipelineDb(dbPath) {
-    const path = dbPath ?? getPipelineDbPath();
-    mkdirSync(dirname(path), { recursive: true });
-    try {
-        const db = new DatabaseSync(path);
-        db.exec('PRAGMA busy_timeout = 5000');
-        db.exec('PRAGMA journal_mode = WAL');
-        db.exec('PRAGMA synchronous = NORMAL');
-        db.exec(SCHEMA);
-        applyDbMigrations(db);
-        return db;
-    }
-    catch (e) {
-        const msg = e instanceof Error ? e.message : String(e);
-        if (msg.includes('database is locked')) {
-            throw new Error('database is locked: another CLI process may be running. Retry once it exits.');
-        }
-        throw e;
-    }
-}
-function applyDbMigrations(db) {
-    const cols = db.prepare('PRAGMA table_info(raw_slots)').all();
-    if (!cols.some((c) => c.name === 'required')) {
-        db.exec('ALTER TABLE raw_slots ADD COLUMN required INTEGER NOT NULL DEFAULT 1 CHECK (required IN (0, 1))');
-    }
-    const rawCompCols = db.prepare('PRAGMA table_info(raw_components)').all();
-    const rawCompColNames = new Set(rawCompCols.map((c) => c.name));
-    if (!rawCompColNames.has('extraction_confidence')) {
-        db.exec('ALTER TABLE raw_components ADD COLUMN extraction_confidence INTEGER');
-    }
-    if (!rawCompColNames.has('review_reasons')) {
-        db.exec("ALTER TABLE raw_components ADD COLUMN review_reasons TEXT NOT NULL DEFAULT '[]'");
-    }
-    if (!rawCompColNames.has('needs_review')) {
-        db.exec('ALTER TABLE raw_components ADD COLUMN needs_review INTEGER NOT NULL DEFAULT 0');
-    }
-    if (!rawCompColNames.has('source_path')) {
-        db.exec('ALTER TABLE raw_components ADD COLUMN source_path TEXT');
-    }
-    const rawPropCols = db.prepare('PRAGMA table_info(raw_props)').all();
-    const rawPropColNames = new Set(rawPropCols.map((c) => c.name));
-    if (!rawPropColNames.has('rationale')) {
-        db.exec('ALTER TABLE raw_props ADD COLUMN rationale TEXT');
-    }
-    if (!rawPropColNames.has('source_start_line')) {
-        db.exec('ALTER TABLE raw_props ADD COLUMN source_start_line INTEGER');
-    }
-    if (!rawPropColNames.has('source_end_line')) {
-        db.exec('ALTER TABLE raw_props ADD COLUMN source_end_line INTEGER');
-    }
-    if (!rawCompColNames.has('reject_reason')) {
-        db.exec('ALTER TABLE raw_components ADD COLUMN reject_reason TEXT');
-    }
-    if (!rawCompColNames.has('component_description_rationale')) {
-        db.exec('ALTER TABLE raw_components ADD COLUMN component_description_rationale TEXT');
-    }
-    if (!rawCompColNames.has('props_rationale')) {
-        db.exec('ALTER TABLE raw_components ADD COLUMN props_rationale TEXT');
-    }
-    if (!rawCompColNames.has('slots_rationale')) {
-        db.exec('ALTER TABLE raw_components ADD COLUMN slots_rationale TEXT');
-    }
-    const rawSlotColsForRationale = db.prepare('PRAGMA table_info(raw_slots)').all();
-    if (!rawSlotColsForRationale.some((c) => c.name === 'rationale')) {
-        db.exec('ALTER TABLE raw_slots ADD COLUMN rationale TEXT');
-    }
-    const hasExtractCache = db
-        .prepare(`SELECT name FROM sqlite_master WHERE type='table' AND name='extract_cache'`)
-        .all();
-    if (hasExtractCache.length === 0) {
-        db.exec(`
-      CREATE TABLE extract_cache (
-        file_path        TEXT NOT NULL,
-        file_hash        TEXT NOT NULL,
-        cli_version      TEXT NOT NULL,
-        created_at       TEXT NOT NULL,
-        updated_at       TEXT NOT NULL,
-        components_json  TEXT NOT NULL,
-        PRIMARY KEY (file_hash, cli_version)
-      );
-      CREATE INDEX idx_extract_cache_file ON extract_cache(file_path);
-    `);
-    }
-    const hasSelectCache = db
-        .prepare(`SELECT name FROM sqlite_master WHERE type='table' AND name='select_cache'`)
-        .all();
-    if (hasSelectCache.length === 0) {
-        db.exec(`
-      CREATE TABLE select_cache (
-        component_hash TEXT NOT NULL,
-        prompt_hash    TEXT NOT NULL,
-        cli_version    TEXT NOT NULL,
-        decision       TEXT NOT NULL CHECK (decision IN ('accepted','rejected')),
-        reason         TEXT,
-        created_at     TEXT NOT NULL,
-        updated_at     TEXT NOT NULL,
-        PRIMARY KEY (component_hash, prompt_hash, cli_version)
-      );
-    `);
-    }
-    const tables = db
-        .prepare(`SELECT name FROM sqlite_master WHERE type='table' AND name='generation_cache'`)
-        .all();
-    if (tables.length === 0) {
-        db.exec(`
-      CREATE TABLE generation_cache (
-        input_hash        TEXT NOT NULL,
-        entity_type       TEXT NOT NULL CHECK (entity_type IN ('component', 'token_set')),
-        entity_id         TEXT NOT NULL,
-        source_session_id TEXT NOT NULL REFERENCES sessions(id) ON DELETE CASCADE,
-        human_edited      INTEGER NOT NULL DEFAULT 0 CHECK (human_edited IN (0, 1)),
-        created_at        TEXT NOT NULL,
-        updated_at        TEXT NOT NULL,
-        PRIMARY KEY (input_hash, entity_type, entity_id)
-      );
-      CREATE INDEX idx_generation_cache_entity ON generation_cache(entity_type, entity_id);
-      CREATE INDEX idx_generation_cache_session ON generation_cache(source_session_id);
-    `);
-    }
-    const genCacheCols = db.prepare(`PRAGMA table_info(generation_cache)`).all();
-    const hasPromptHash = genCacheCols.some((c) => c.name === 'prompt_hash');
-    const oldPkCols = genCacheCols.filter((c) => c.pk > 0).map((c) => c.name);
-    const promptHashInPk = oldPkCols.includes('prompt_hash');
-    if (!hasPromptHash) {
-        db.exec(`ALTER TABLE generation_cache ADD COLUMN prompt_hash TEXT NOT NULL DEFAULT ''`);
-    }
-    if (!promptHashInPk) {
-        db.exec('BEGIN');
-        try {
-            db.exec(`
-        CREATE TABLE generation_cache__new (
-          input_hash        TEXT NOT NULL,
-          entity_type       TEXT NOT NULL CHECK (entity_type IN ('component', 'token_set')),
-          entity_id         TEXT NOT NULL,
-          source_session_id TEXT NOT NULL REFERENCES sessions(id) ON DELETE CASCADE,
-          human_edited      INTEGER NOT NULL DEFAULT 0 CHECK (human_edited IN (0, 1)),
-          created_at        TEXT NOT NULL,
-          updated_at        TEXT NOT NULL,
-          prompt_hash       TEXT NOT NULL DEFAULT '',
-          PRIMARY KEY (input_hash, prompt_hash, entity_type, entity_id)
-        );
-        INSERT INTO generation_cache__new
-          (input_hash, entity_type, entity_id, source_session_id, human_edited, created_at, updated_at, prompt_hash)
-          SELECT input_hash, entity_type, entity_id, source_session_id, human_edited, created_at, updated_at, prompt_hash
-          FROM generation_cache;
-        DROP TABLE generation_cache;
-        ALTER TABLE generation_cache__new RENAME TO generation_cache;
-        CREATE INDEX IF NOT EXISTS idx_generation_cache_entity  ON generation_cache(entity_type, entity_id);
-        CREATE INDEX IF NOT EXISTS idx_generation_cache_session ON generation_cache(source_session_id);
-      `);
-            db.exec('COMMIT');
-        }
-        catch (e) {
-            db.exec('ROLLBACK');
-            throw e;
-        }
-    }
-    const hasCompositionCache = db
-        .prepare(`SELECT name FROM sqlite_master WHERE type='table' AND name='composition_cache'`)
-        .all();
-    if (hasCompositionCache.length === 0) {
-        db.exec(`
-      CREATE TABLE composition_cache (
-        input_hash   TEXT NOT NULL,
-        cli_version  TEXT NOT NULL,
-        agent_output TEXT NOT NULL,
-        created_at   TEXT NOT NULL,
-        updated_at   TEXT NOT NULL,
-        PRIMARY KEY (input_hash, cli_version)
-      );
-    `);
-    }
-}
-export function loadComponentReviewMetadata(db, sessionId, componentName) {
-    const compRow = db
-        .prepare(`SELECT component_id, source, source_path FROM raw_components WHERE session_id = ? AND name = ?`)
-        .get(sessionId, componentName);
-    if (!compRow)
-        return null;
-    const propRows = db
-        .prepare(`SELECT name, rationale, source_start_line, source_end_line FROM raw_props WHERE session_id = ? AND component_id = ?`)
-        .all(sessionId, compRow.component_id);
-    const props = {};
-    for (const r of propRows) {
-        props[r.name] = {
-            rationale: r.rationale,
-            sourceStartLine: r.source_start_line,
-            sourceEndLine: r.source_end_line,
-        };
-    }
-    // raw_components.source historically stores the file path, not the file
-    // text. For the source-view panel to render real lines, prefer reading
-    // the file from disk via source_path. Fall back to whatever's in `source`
-    // (handles in-memory fixtures and tests).
-    let componentSource = compRow.source ?? null;
-    if (compRow.source_path) {
-        try {
-            componentSource = readFileSync(compRow.source_path, 'utf8');
-        }
-        catch {
-            // File no longer exists or unreadable — leave fallback.
-        }
-    }
-    return {
-        sourcePath: compRow.source_path,
-        componentSource,
-        props,
-    };
-}
-export function loadComponentRationale(db, sessionId, componentName) {
-    const compRow = db
-        .prepare(`SELECT component_id, name, description, component_description_rationale, props_rationale, slots_rationale
-       FROM raw_components WHERE session_id = ? AND name = ?`)
-        .get(sessionId, componentName);
-    if (!compRow)
-        return null;
-    const propRows = db
-        .prepare(`SELECT name, cdf_category, category, description, rationale FROM raw_props
-       WHERE session_id = ? AND component_id = ? ORDER BY position`)
-        .all(sessionId, compRow.component_id);
-    const slotRows = db
-        .prepare(`SELECT name, description, rationale FROM raw_slots
-       WHERE session_id = ? AND component_id = ? ORDER BY position`)
-        .all(sessionId, compRow.component_id);
-    return {
-        name: compRow.name,
-        description: compRow.description,
-        descriptionRationale: compRow.component_description_rationale,
-        propsRationale: compRow.props_rationale,
-        slotsRationale: compRow.slots_rationale,
-        props: propRows.map((p) => ({
-            name: p.name,
-            category: p.cdf_category ?? p.category ?? null,
-            description: p.description,
-            rationale: p.rationale,
-        })),
-        slots: slotRows.map((s) => ({
-            name: s.name,
-            description: s.description,
-            rationale: s.rationale,
-        })),
-    };
-}
-export function applyToolCalls(db, sessionId, componentId, componentName, calls, incomingWarnings) {
-    const now = new Date().toISOString();
-    const warnings = [...incomingWarnings];
-    let classified = 0;
-    let excluded = 0;
-    let slots = 0;
-    const updateProp = db.prepare(`UPDATE raw_props SET cdf_type = ?, cdf_category = ?, cdf_token_kind = ?, required = ?, description = ?, rationale = ?
-     WHERE session_id = ? AND component_id = ? AND name = ?`);
-    const clearProp = db.prepare(`UPDATE raw_props SET cdf_type = 'excluded', cdf_category = NULL, cdf_token_kind = NULL, rationale = ?
-     WHERE session_id = ? AND component_id = ? AND name = ?`);
-    const deleteAllowedValues = db.prepare(`DELETE FROM raw_prop_allowed_values WHERE session_id = ? AND component_id = ? AND prop_name = ?`);
-    const insertAllowedValue = db.prepare(`INSERT OR IGNORE INTO raw_prop_allowed_values (session_id, component_id, prop_name, value, position)
-     VALUES (?, ?, ?, ?, ?)`);
-    const deleteAllowedComponents = db.prepare(`DELETE FROM raw_slot_allowed_components WHERE session_id = ? AND component_id = ? AND slot_name = ?`);
-    const insertAllowedComponent = db.prepare(`INSERT OR IGNORE INTO raw_slot_allowed_components (session_id, component_id, slot_name, allowed_component, position)
-     VALUES (?, ?, ?, ?, ?)`);
-    const updateSlot = db.prepare(`UPDATE raw_slots SET required = ?, description = ? WHERE session_id = ? AND component_id = ? AND name = ?`);
-    db.exec('BEGIN');
-    try {
-        for (const call of calls) {
-            if (call.tool === 'classify_component') {
-                if (call.description !== undefined) {
-                    db.prepare('UPDATE raw_components SET description = ? WHERE session_id = ? AND component_id = ?').run(call.description, sessionId, componentId);
-                }
-                if (call.rationale) {
-                    if (call.rationale.description !== undefined) {
-                        db.prepare('UPDATE raw_components SET component_description_rationale = ? WHERE session_id = ? AND component_id = ?').run(call.rationale.description, sessionId, componentId);
-                    }
-                    if (call.rationale.props !== undefined) {
-                        db.prepare('UPDATE raw_components SET props_rationale = ? WHERE session_id = ? AND component_id = ?').run(call.rationale.props, sessionId, componentId);
-                    }
-                    if (call.rationale.slots !== undefined) {
-                        db.prepare('UPDATE raw_components SET slots_rationale = ? WHERE session_id = ? AND component_id = ?').run(call.rationale.slots, sessionId, componentId);
-                    }
-                }
-            }
-            else if (call.tool === 'classify_prop') {
-                const changes = updateProp.run(call.cdf_type, call.cdf_category, call.token_kind ?? null, call.required !== undefined ? (call.required ? 1 : 0) : 0, call.description ?? null, call.reason ?? null, sessionId, componentId, call.prop);
-                if (changes.changes === 0) {
-                    warnings.push(`${componentName}: classify_prop '${call.prop}' — prop not found, skipped`);
-                    continue;
-                }
-                if (call.values && call.values.length > 0) {
-                    deleteAllowedValues.run(sessionId, componentId, call.prop);
-                    call.values.forEach((v, i) => insertAllowedValue.run(sessionId, componentId, call.prop, v, i));
-                }
-                if (call.default !== undefined) {
-                    const storedDefault = typeof call.default === 'boolean' ? String(call.default) : call.default;
-                    db.prepare(`UPDATE raw_props SET default_value = ? WHERE session_id = ? AND component_id = ? AND name = ?`).run(storedDefault, sessionId, componentId, call.prop);
-                }
-                classified++;
-            }
-            else if (call.tool === 'exclude_prop') {
-                clearProp.run(call.reason || null, sessionId, componentId, call.prop);
-                excluded++;
-            }
-            else if (call.tool === 'classify_slot') {
-                const slotRequired = call.required !== undefined ? (call.required ? 1 : 0) : 1;
-                const slotChanges = updateSlot.run(slotRequired, call.description ?? null, sessionId, componentId, call.slot);
-                if (slotChanges.changes === 0) {
-                    warnings.push(`${componentName}: classify_slot '${call.slot}' — slot not found, skipped`);
-                    continue;
-                }
-                if (call.rationale !== undefined) {
-                    db.prepare('UPDATE raw_slots SET rationale = ? WHERE session_id = ? AND component_id = ? AND name = ?').run(call.rationale, sessionId, componentId, call.slot);
-                }
-                if (call.allowed_components !== undefined) {
-                    deleteAllowedComponents.run(sessionId, componentId, call.slot);
-                    call.allowed_components.forEach((ac, i) => insertAllowedComponent.run(sessionId, componentId, call.slot, ac, i));
-                }
-                slots++;
-            }
-        }
-        db.prepare(`UPDATE raw_components SET status = 'generated', extracted_at = ? WHERE session_id = ? AND component_id = ?`).run(now, sessionId, componentId);
-        db.prepare('UPDATE sessions SET updated_at = ? WHERE id = ?').run(now, sessionId);
-        db.exec('COMMIT');
-    }
-    catch (e) {
-        db.exec('ROLLBACK');
-        throw e;
-    }
-    return { classified, excluded, slots, warnings };
-}
-export function getOrCreateSession(db, sessionFlag, sessionName, _hints) {
-    const now = new Date().toISOString();
-    if (sessionFlag === 'new' || sessionFlag === undefined) {
-        const id = generateSessionId();
-        db.prepare('INSERT INTO sessions (id, name, created_at, updated_at) VALUES (?, ?, ?, ?)').run(id, sessionName ?? null, now, now);
-        return { sessionId: id, isNew: true, isResumed: false };
-    }
-    const existing = db.prepare('SELECT id FROM sessions WHERE id = ?').get(sessionFlag);
-    if (!existing) {
-        throw new Error(`session '${sessionFlag}' not found. Run 'session list' to see active sessions.`);
-    }
-    return { sessionId: sessionFlag, isNew: false, isResumed: false };
-}
-export function createStep(db, sessionId, command, inputs) {
-    const now = new Date().toISOString();
-    db.exec('BEGIN');
-    try {
-        db.prepare(`UPDATE steps SET status = 'interrupted', completed_at = ?, updated_at = ?
-       WHERE session_id = ? AND command = ? AND status = 'pending'`).run(now, now, sessionId, command);
-        const result = db
-            .prepare(`INSERT INTO steps (session_id, command, status, started_at, inputs, outputs, updated_at)
-         VALUES (?, ?, 'pending', ?, ?, '{}', ?)`)
-            .run(sessionId, command, now, JSON.stringify(inputs), now);
-        db.prepare('UPDATE sessions SET updated_at = ? WHERE id = ?').run(now, sessionId);
-        db.exec('COMMIT');
-        return Number(result.lastInsertRowid);
-    }
-    catch (e) {
-        db.exec('ROLLBACK');
-        throw e;
-    }
-}
-export function updateStep(db, stepId, status, outputs, error) {
-    const now = new Date().toISOString();
-    db.exec('BEGIN');
-    try {
-        const step = db.prepare('SELECT session_id FROM steps WHERE id = ?').get(stepId);
-        db.prepare(`UPDATE steps SET status = ?, completed_at = ?, outputs = ?, error = ?, updated_at = ? WHERE id = ?`).run(status, now, JSON.stringify(outputs), error ?? null, now, stepId);
-        if (step) {
-            db.prepare('UPDATE sessions SET updated_at = ? WHERE id = ?').run(now, step.session_id);
-        }
-        db.exec('COMMIT');
-    }
-    catch (e) {
-        db.exec('ROLLBACK');
-        throw e;
-    }
-}
-export function storeRawComponents(db, sessionId, components, options) {
-    const now = new Date().toISOString();
-    const insertComp = db.prepare(`INSERT INTO raw_components (session_id, component_id, name, source, framework, extracted_at, extraction_confidence, review_reasons, needs_review, source_path)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
-    const insertProp = db.prepare(`INSERT INTO raw_props
-       (session_id, component_id, name, type, required, category, default_value, description, token_reference, position, source_start_line, source_end_line)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
-    const insertAllowedValue = db.prepare(`INSERT INTO raw_prop_allowed_values (session_id, component_id, prop_name, position, value)
-     VALUES (?, ?, ?, ?, ?)`);
-    const insertSlot = db.prepare(`INSERT INTO raw_slots (session_id, component_id, name, is_default, description, position)
-     VALUES (?, ?, ?, ?, ?, ?)`);
-    const insertAllowedComponent = db.prepare(`INSERT INTO raw_slot_allowed_components (session_id, component_id, slot_name, position, allowed_component)
-     VALUES (?, ?, ?, ?, ?)`);
-    db.exec('BEGIN');
-    try {
-        let cdfSnapshot = [];
-        let descSnapshot = [];
-        let avSnapshot = [];
-        if (options?.preserveCDF) {
-            cdfSnapshot = db
-                .prepare(`SELECT component_id, name, position, cdf_type, cdf_category, cdf_token_kind
-           FROM raw_props WHERE session_id = ? AND cdf_type IS NOT NULL`)
-                .all(sessionId);
-            descSnapshot = db
-                .prepare(`SELECT component_id, description
-           FROM raw_components WHERE session_id = ? AND description IS NOT NULL`)
-                .all(sessionId);
-            if (cdfSnapshot.length > 0) {
-                avSnapshot = db
-                    .prepare(`SELECT component_id, prop_name, position, value
-             FROM raw_prop_allowed_values WHERE session_id = ?`)
-                    .all(sessionId);
-            }
-        }
-        db.prepare('DELETE FROM raw_components WHERE session_id = ?').run(sessionId);
-        for (const comp of components) {
-            const componentId = deriveComponentId(comp.name, comp.source);
-            insertComp.run(sessionId, componentId, comp.name, comp.source, comp.framework, now, comp.extractionConfidence ?? null, JSON.stringify(comp.reviewReasons ?? []), comp.needsReview ? 1 : 0, comp.sourcePath ?? null);
-            for (let i = 0; i < comp.props.length; i++) {
-                const prop = comp.props[i];
-                insertProp.run(sessionId, componentId, prop.name, prop.type, prop.required ? 1 : 0, prop.category ?? null, prop.defaultValue ?? null, prop.description ?? null, prop.tokenReference ?? null, i, prop.sourceStartLine ?? null, prop.sourceEndLine ?? null);
-                if (prop.allowedValues) {
-                    prop.allowedValues.forEach((v, j) => insertAllowedValue.run(sessionId, componentId, prop.name, j, v));
-                }
-            }
-            for (let i = 0; i < comp.slots.length; i++) {
-                const slot = comp.slots[i];
-                insertSlot.run(sessionId, componentId, slot.name, slot.isDefault ? 1 : 0, slot.description ?? null, i);
-                if (slot.allowedComponents) {
-                    slot.allowedComponents.forEach((ac, j) => insertAllowedComponent.run(sessionId, componentId, slot.name, j, ac));
-                }
-            }
-        }
-        if (options?.preserveCDF && cdfSnapshot.length > 0) {
-            const updateCDFByName = db.prepare(`UPDATE raw_props SET cdf_type = ?, cdf_category = ?, cdf_token_kind = ?
-         WHERE session_id = ? AND component_id = ? AND name = ?`);
-            const updateCDFByPosition = db.prepare(`UPDATE raw_props SET cdf_type = ?, cdf_category = ?, cdf_token_kind = ?
-         WHERE session_id = ? AND component_id = ? AND position = ? AND cdf_type IS NULL`);
-            const restoredPropKeys = new Set();
-            const unmatchedSnaps = [];
-            for (const snap of cdfSnapshot) {
-                const result = updateCDFByName.run(snap.cdf_type, snap.cdf_category, snap.cdf_token_kind, sessionId, snap.component_id, snap.name);
-                if (Number(result.changes) > 0) {
-                    restoredPropKeys.add(`${snap.component_id}::${snap.name}`);
-                }
-                else {
-                    unmatchedSnaps.push(snap);
-                }
-            }
-            for (const snap of unmatchedSnaps) {
-                const result = updateCDFByPosition.run(snap.cdf_type, snap.cdf_category, snap.cdf_token_kind, sessionId, snap.component_id, snap.position);
-                if (Number(result.changes) > 0) {
-                    const matched = db
-                        .prepare(`SELECT name FROM raw_props WHERE session_id = ? AND component_id = ? AND position = ?`)
-                        .get(sessionId, snap.component_id, snap.position);
-                    if (matched) {
-                        restoredPropKeys.add(`${snap.component_id}::${matched.name}`);
-                    }
-                }
-            }
-            const updateDesc = db.prepare(`UPDATE raw_components SET description = ? WHERE session_id = ? AND component_id = ?`);
-            for (const snap of descSnapshot) {
-                updateDesc.run(snap.description, sessionId, snap.component_id);
-            }
-            const relevantAV = avSnapshot.filter((av) => restoredPropKeys.has(`${av.component_id}::${av.prop_name}`));
-            if (relevantAV.length > 0) {
-                const deleteAV = db.prepare(`DELETE FROM raw_prop_allowed_values WHERE session_id = ? AND component_id = ? AND prop_name = ?`);
-                const insertAV = db.prepare(`INSERT OR IGNORE INTO raw_prop_allowed_values (session_id, component_id, prop_name, position, value)
-           VALUES (?, ?, ?, ?, ?)`);
-                const deletedKeys = new Set();
-                for (const av of relevantAV) {
-                    const key = `${av.component_id}::${av.prop_name}`;
-                    if (!deletedKeys.has(key)) {
-                        deleteAV.run(sessionId, av.component_id, av.prop_name);
-                        deletedKeys.add(key);
-                    }
-                    insertAV.run(sessionId, av.component_id, av.prop_name, av.position, av.value);
-                }
-            }
-        }
-        if (options?.status) {
-            db.prepare('UPDATE raw_components SET status = ? WHERE session_id = ?').run(options.status, sessionId);
-        }
-        db.prepare('UPDATE sessions SET updated_at = ? WHERE id = ?').run(now, sessionId);
-        db.exec('COMMIT');
-    }
-    catch (e) {
-        db.exec('ROLLBACK');
-        throw e;
-    }
-}
-export function loadRawComponents(db, sessionId, allowedNames) {
-    const all = db
-        .prepare('SELECT component_id, name, source, framework, extraction_confidence, review_reasons, needs_review, source_path FROM raw_components WHERE session_id = ? ORDER BY rowid')
-        .all(sessionId);
-    const components = allowedNames ? all.filter((c) => allowedNames.has(c.name)) : all;
-    if (components.length === 0)
-        return [];
-    const props = db
-        .prepare(`SELECT component_id, name, type, required, category, default_value, description, token_reference, position,
-              rationale, source_start_line, source_end_line
-       FROM raw_props WHERE session_id = ? ORDER BY component_id, position`)
-        .all(sessionId);
-    const allowedValues = db
-        .prepare(`SELECT component_id, prop_name, position, value
-       FROM raw_prop_allowed_values WHERE session_id = ? ORDER BY component_id, prop_name, position`)
-        .all(sessionId);
-    const slots = db
-        .prepare(`SELECT component_id, name, is_default, description, position
-       FROM raw_slots WHERE session_id = ? ORDER BY component_id, position`)
-        .all(sessionId);
-    const allowedComponents = db
-        .prepare(`SELECT component_id, slot_name, position, allowed_component
-       FROM raw_slot_allowed_components WHERE session_id = ? ORDER BY component_id, slot_name, position`)
-        .all(sessionId);
-    const propsByComponent = groupBy(props, (p) => p.component_id);
-    const allowedValuesByProp = groupBy(allowedValues, (av) => `${av.component_id}::${av.prop_name}`);
-    const slotsByComponent = groupBy(slots, (s) => s.component_id);
-    const allowedComponentsBySlot = groupBy(allowedComponents, (ac) => `${ac.component_id}::${ac.slot_name}`);
-    return components.map((c) => ({
-        component_id: c.component_id,
-        name: c.name,
-        source: c.source,
-        framework: c.framework,
-        extractionConfidence: c.extraction_confidence ?? null,
-        reviewReasons: parseReviewReasons(c.review_reasons),
-        needsReview: Boolean(c.needs_review),
-        sourcePath: c.source_path ?? undefined,
-        props: (propsByComponent.get(c.component_id) ?? []).map((p) => {
-            const av = allowedValuesByProp.get(`${c.component_id}::${p.name}`);
-            const prop = {
-                name: p.name,
-                type: p.type,
-                required: Boolean(p.required),
-            };
-            if (p.category !== null)
-                prop.category = p.category;
-            if (p.default_value !== null)
-                prop.defaultValue = p.default_value;
-            if (p.description !== null)
-                prop.description = p.description;
-            if (p.token_reference !== null)
-                prop.tokenReference = p.token_reference;
-            if (av && av.length > 0)
-                prop.allowedValues = av.map((v) => v.value);
-            if (p.source_start_line !== null)
-                prop.sourceStartLine = p.source_start_line;
-            if (p.source_end_line !== null)
-                prop.sourceEndLine = p.source_end_line;
-            return prop;
-        }),
-        slots: (slotsByComponent.get(c.component_id) ?? []).map((s) => {
-            const ac = allowedComponentsBySlot.get(`${c.component_id}::${s.name}`);
-            const slot = {
-                name: s.name,
-                isDefault: Boolean(s.is_default),
-            };
-            if (s.description !== null)
-                slot.description = s.description;
-            if (ac && ac.length > 0)
-                slot.allowedComponents = ac.map((v) => v.allowed_component);
-            return slot;
-        }),
-    }));
-}
-export function renameEmptySlots(db, sessionId, componentId, componentName, slotCount) {
-    const emptySlots = db
-        .prepare(`SELECT name, position FROM raw_slots
-       WHERE session_id = ? AND component_id = ? AND trim(name) = ''
-       ORDER BY position`)
-        .all(sessionId, componentId);
-    if (emptySlots.length === 0)
-        return { renames: [], warnings: [] };
-    const renames = [];
-    const warnings = [];
-    const rename = db.prepare(`UPDATE raw_slots SET name = ? WHERE session_id = ? AND component_id = ? AND name = ? AND position = ?`);
-    db.exec('BEGIN');
-    try {
-        for (const slot of emptySlots) {
-            const newName = slotCount === 1 ? 'children' : `slot_${slot.position}`;
-            rename.run(newName, sessionId, componentId, slot.name, slot.position);
-            renames.push({ oldName: slot.name, newName });
-            warnings.push(`${componentName}: slot at position ${slot.position} had empty name — renamed to "${newName}" for classification`);
-        }
-        db.exec('COMMIT');
-    }
-    catch (e) {
-        db.exec('ROLLBACK');
-        throw e;
-    }
-    return { renames, warnings };
-}
-function parseReviewReasons(raw) {
-    try {
-        const parsed = JSON.parse(raw ?? '[]');
-        return Array.isArray(parsed) ? parsed.filter((reason) => typeof reason === 'string') : [];
-    }
-    catch {
-        // A malformed historical value should not prevent callers from loading.
-        return [];
-    }
-}
-function groupBy(items, key) {
-    const map = new Map();
-    for (const item of items) {
-        const k = key(item);
-        let arr = map.get(k);
-        if (!arr) {
-            arr = [];
-            map.set(k, arr);
-        }
-        arr.push(item);
-    }
-    return map;
-}
-function deriveComponentId(name, source) {
-    return createHash('sha256').update(`${name}:${source}`).digest('hex').slice(0, 12);
-}
-export function storeCDFComponents(db, sessionId, components) {
-    const now = new Date().toISOString();
-    const updateComp = db.prepare(`UPDATE raw_components SET status = 'generated', description = ? WHERE session_id = ? AND name = ?`);
-    const updateProp = db.prepare(`UPDATE raw_props SET cdf_type = ?, cdf_category = ?, cdf_token_kind = ?, required = ? WHERE session_id = ? AND component_id = ? AND name = ?`);
-    const deleteAllowedValues = db.prepare(`DELETE FROM raw_prop_allowed_values WHERE session_id = ? AND component_id = ? AND prop_name = ?`);
-    const insertAllowedValue = db.prepare(`INSERT INTO raw_prop_allowed_values (session_id, component_id, prop_name, value, position)
-     VALUES (?, ?, ?, ?, ?)`);
-    const insertAllowedComponent = db.prepare(`INSERT INTO raw_slot_allowed_components (session_id, component_id, slot_name, allowed_component, position)
-     VALUES (?, ?, ?, ?, ?)`);
-    const deleteSlots = db.prepare(`DELETE FROM raw_slots WHERE session_id = ? AND component_id = ?`);
-    const deleteSlotAllowedComponents = db.prepare(`DELETE FROM raw_slot_allowed_components WHERE session_id = ? AND component_id = ?`);
-    const readExistingSlotDefaults = db.prepare(`SELECT name, is_default FROM raw_slots WHERE session_id = ? AND component_id = ?`);
-    const insertSlotOnUpdate = db.prepare(`INSERT INTO raw_slots (session_id, component_id, name, is_default, required, description, position)
-     VALUES (?, ?, ?, ?, ?, ?, ?)`);
-    db.exec('BEGIN');
-    try {
-        for (const { key, entry } of components) {
-            const row = db
-                .prepare('SELECT component_id FROM raw_components WHERE session_id = ? AND name = ?')
-                .get(sessionId, key);
-            if (row) {
-                const { component_id: componentId } = row;
-                updateComp.run(entry.$description ?? null, sessionId, key);
-                for (const [propName, prop] of Object.entries(entry.$properties)) {
-                    updateProp.run(prop.$type, prop.$category, prop['$token.kind'] ?? null, prop.$required ? 1 : 0, sessionId, componentId, propName);
-                    if (prop.$values && prop.$values.length > 0) {
-                        deleteAllowedValues.run(sessionId, componentId, propName);
-                        prop.$values.forEach((v, i) => insertAllowedValue.run(sessionId, componentId, propName, v, i));
-                    }
-                }
-                const existingDefaults = new Map(readExistingSlotDefaults.all(sessionId, componentId).map((r) => [r.name, r.is_default]));
-                deleteSlotAllowedComponents.run(sessionId, componentId);
-                deleteSlots.run(sessionId, componentId);
-                let slotPos = 0;
-                for (const [slotName, slot] of Object.entries(entry.$slots ?? {})) {
-                    const isDefault = existingDefaults.get(slotName) ?? 0;
-                    insertSlotOnUpdate.run(sessionId, componentId, slotName, isDefault, slot.$required ? 1 : 0, slot.$description ?? null, slotPos++);
-                    if (slot.$allowedComponents && slot.$allowedComponents.length > 0) {
-                        slot.$allowedComponents.forEach((ac, i) => insertAllowedComponent.run(sessionId, componentId, slotName, ac, i));
-                    }
-                }
-            }
-            else {
-                const componentId = createHash('sha256').update(`${key}:generated`).digest('hex').slice(0, 12);
-                db.prepare(`INSERT INTO raw_components (session_id, component_id, name, source, framework, extracted_at, status, description)
-           VALUES (?, ?, ?, '', 'react', ?, 'generated', ?)`).run(sessionId, componentId, key, now, entry.$description ?? null);
-                let position = 0;
-                for (const [propName, prop] of Object.entries(entry.$properties)) {
-                    db.prepare(`INSERT OR REPLACE INTO raw_props
-               (session_id, component_id, name, type, required, category, default_value, description, token_reference, position, cdf_type, cdf_category, cdf_token_kind)
-             VALUES (?, ?, ?, '', ?, NULL, NULL, NULL, NULL, ?, ?, ?, ?)`).run(sessionId, componentId, propName, prop.$required ? 1 : 0, position++, prop.$type, prop.$category, prop['$token.kind'] ?? null);
-                    if (prop.$values && prop.$values.length > 0) {
-                        prop.$values.forEach((v, i) => insertAllowedValue.run(sessionId, componentId, propName, v, i));
-                    }
-                }
-                let slotPos = 0;
-                for (const [slotName, slot] of Object.entries(entry.$slots ?? {})) {
-                    db.prepare(`INSERT OR REPLACE INTO raw_slots
-               (session_id, component_id, name, is_default, required, description, position)
-             VALUES (?, ?, ?, 0, ?, ?, ?)`).run(sessionId, componentId, slotName, slot.$required ? 1 : 0, slot.$description ?? null, slotPos++);
-                    if (slot.$allowedComponents && slot.$allowedComponents.length > 0) {
-                        slot.$allowedComponents.forEach((ac, i) => insertAllowedComponent.run(sessionId, componentId, slotName, ac, i));
-                    }
-                }
-            }
-        }
-        db.prepare('UPDATE sessions SET updated_at = ? WHERE id = ?').run(now, sessionId);
-        db.exec('COMMIT');
-    }
-    catch (e) {
-        db.exec('ROLLBACK');
-        throw e;
-    }
-}
-export function loadCDFComponents(db, sessionId) {
-    const components = db
-        .prepare(`SELECT component_id, name, description FROM raw_components
-       WHERE session_id = ? AND status = 'generated' ORDER BY rowid`)
-        .all(sessionId);
-    if (components.length === 0)
-        return [];
-    const props = db
-        .prepare(`SELECT component_id, name, required, default_value, description,
-              cdf_type, cdf_category, cdf_token_kind, position
-       FROM raw_props
-       WHERE session_id = ? AND cdf_type IS NOT NULL AND cdf_type != 'excluded'
-       ORDER BY component_id, position`)
-        .all(sessionId);
-    const allowedValues = db
-        .prepare(`SELECT component_id, prop_name, value, position
-       FROM raw_prop_allowed_values WHERE session_id = ? ORDER BY component_id, prop_name, position`)
-        .all(sessionId);
-    const slots = db
-        .prepare(`SELECT component_id, name, description, required FROM raw_slots WHERE session_id = ? ORDER BY component_id, position`)
-        .all(sessionId);
-    const allowedComponents = db
-        .prepare(`SELECT component_id, slot_name, allowed_component
-       FROM raw_slot_allowed_components WHERE session_id = ? ORDER BY component_id, slot_name, position`)
-        .all(sessionId);
-    const propsByComponent = groupBy(props, (p) => p.component_id);
-    const allowedValuesByProp = groupBy(allowedValues, (av) => `${av.component_id}::${av.prop_name}`);
-    const slotsByComponent = groupBy(slots, (s) => s.component_id);
-    const allowedComponentsBySlot = groupBy(allowedComponents, (ac) => `${ac.component_id}::${ac.slot_name}`);
-    return components.map(({ component_id, name, description }) => {
-        const compProps = propsByComponent.get(component_id) ?? [];
-        const $properties = {};
-        for (const p of compProps) {
-            if (!p.name.trim())
-                continue;
-            const av = allowedValuesByProp.get(`${component_id}::${p.name}`);
-            const propDef = {
-                $type: p.cdf_type,
-                $category: p.cdf_category,
-            };
-            if (p.required)
-                propDef.$required = true;
-            if (p.default_value !== null) {
-                if (p.cdf_type === 'boolean') {
-                    propDef.$default = p.default_value === 'true';
-                }
-                else {
-                    propDef.$default = p.default_value;
-                }
-            }
-            if (p.description !== null)
-                propDef.$description = p.description;
-            if (av && av.length > 0)
-                propDef.$values = av.map((v) => v.value);
-            if (p.cdf_token_kind !== null)
-                propDef['$token.kind'] = p.cdf_token_kind;
-            $properties[p.name] = propDef;
-        }
-        const compSlots = slotsByComponent.get(component_id) ?? [];
-        const $slots = {};
-        for (const s of compSlots) {
-            if (!s.name.trim())
-                continue;
-            const ac = allowedComponentsBySlot.get(`${component_id}::${s.name}`);
-            const slotDef = {};
-            if (s.description !== null)
-                slotDef.$description = s.description;
-            if (s.required)
-                slotDef.$required = true;
-            if (ac && ac.length > 0)
-                slotDef.$allowedComponents = ac.map((v) => v.allowed_component);
-            $slots[s.name] = slotDef;
-        }
-        const entry = { $type: 'component', $properties };
-        if (description !== null)
-            entry.$description = description;
-        if (Object.keys($slots).length > 0)
-            entry.$slots = $slots;
-        return { key: name, entry };
-    });
-}
-export function loadScopeComponents(db, sessionId) {
-    const rows = db
-        .prepare(`SELECT name, component_id, status, reject_reason, review_reasons, needs_review FROM raw_components
-       WHERE session_id = ? AND status IN ('extracted', 'accepted', 'rejected')
-       ORDER BY name`)
-        .all(sessionId);
-    if (rows.length === 0)
-        return [];
-    const slotRows = db
-        .prepare(`SELECT component_id, name, position
-       FROM raw_slots WHERE session_id = ? ORDER BY component_id, position`)
-        .all(sessionId);
-    const allowedRows = db
-        .prepare(`SELECT component_id, slot_name, position, allowed_component
-       FROM raw_slot_allowed_components WHERE session_id = ? ORDER BY component_id, slot_name, position`)
-        .all(sessionId);
-    const slotsByComponent = groupBy(slotRows, (s) => s.component_id);
-    const allowedBySlot = groupBy(allowedRows, (a) => `${a.component_id}::${a.slot_name}`);
-    return rows.map((r) => {
-        const reviewReasons = parseReviewReasons(r.review_reasons);
-        const nonAuthorableReason = reviewReasons.find((reason) => reason.startsWith('non-authorable:'));
-        return {
-            name: r.name,
-            componentId: r.component_id,
-            aiDecision: r.status === 'accepted' ? 'accepted' : r.status === 'rejected' ? 'rejected' : null,
-            aiReason: r.reject_reason ?? nonAuthorableReason?.slice('non-authorable:'.length) ?? null,
-            needsReview: Boolean(r.needs_review),
-            slots: (slotsByComponent.get(r.component_id) ?? []).map((s) => ({
-                name: s.name,
-                allowedComponents: (allowedBySlot.get(`${r.component_id}::${s.name}`) ?? []).map((a) => a.allowed_component),
-            })),
-        };
-    });
-}
-export function applyScopeDecisions(db, sessionId, decisions) {
-    const now = new Date().toISOString();
-    const acceptedSet = new Set(decisions.accepted);
-    const accepted = [...acceptedSet];
-    const rejected = [...new Set(decisions.rejected)].filter((n) => !acceptedSet.has(n));
-    if (rejected.length > 0) {
-        const placeholders = rejected.map(() => '?').join(',');
-        db.prepare(`UPDATE raw_components SET status = 'rejected' WHERE session_id = ? AND name IN (${placeholders})`).run(sessionId, ...rejected);
-    }
-    if (accepted.length > 0) {
-        const placeholders = accepted.map(() => '?').join(',');
-        db.prepare(`UPDATE raw_components SET status = 'generated' WHERE session_id = ? AND name IN (${placeholders})`).run(sessionId, ...accepted);
-    }
-    db.prepare('UPDATE sessions SET updated_at = ? WHERE id = ?').run(now, sessionId);
-}
-export function storeDTCGTokens(db, sessionId, groups, tokens) {
-    const now = new Date().toISOString();
-    db.exec('BEGIN');
-    try {
-        db.prepare('DELETE FROM raw_token_groups WHERE session_id = ?').run(sessionId);
-        db.prepare('DELETE FROM raw_tokens WHERE session_id = ?').run(sessionId);
-        const insertGroup = db.prepare(`INSERT INTO raw_token_groups (session_id, path, description) VALUES (?, ?, ?)`);
-        for (const group of groups) {
-            insertGroup.run(sessionId, group.path, group.$description ?? null);
-        }
-        const insertToken = db.prepare(`INSERT INTO raw_tokens (session_id, path, type, value, description) VALUES (?, ?, ?, ?, ?)`);
-        for (const token of tokens) {
-            insertToken.run(sessionId, token.path, token.$type, JSON.stringify(token.$value), token.$description ?? null);
-        }
-        db.prepare('UPDATE sessions SET updated_at = ? WHERE id = ?').run(now, sessionId);
-        db.exec('COMMIT');
-    }
-    catch (e) {
-        db.exec('ROLLBACK');
-        throw e;
-    }
-}
-export function applyTokenToolCalls(db, sessionId, calls, incomingWarnings) {
-    const now = new Date().toISOString();
-    const warnings = [...incomingWarnings];
-    let tokens = 0;
-    let groups = 0;
-    const upsertToken = db.prepare(`INSERT INTO raw_tokens (session_id, path, type, value, description) VALUES (?, ?, ?, ?, ?)
-     ON CONFLICT(session_id, path) DO UPDATE SET type = excluded.type, value = excluded.value, description = excluded.description`);
-    const upsertGroup = db.prepare(`INSERT INTO raw_token_groups (session_id, path, description) VALUES (?, ?, ?)
-     ON CONFLICT(session_id, path) DO UPDATE SET description = excluded.description`);
-    db.exec('BEGIN');
-    try {
-        for (const call of calls) {
-            if (call.tool === 'set_token') {
-                upsertToken.run(sessionId, call.path, call.type, JSON.stringify(call.value), call.description ?? null);
-                tokens++;
-            }
-            else if (call.tool === 'set_group') {
-                upsertGroup.run(sessionId, call.path, call.description ?? null);
-                groups++;
-            }
-        }
-        db.prepare('UPDATE sessions SET updated_at = ? WHERE id = ?').run(now, sessionId);
-        db.exec('COMMIT');
-    }
-    catch (e) {
-        db.exec('ROLLBACK');
-        throw e;
-    }
-    return { tokens, groups, warnings };
-}
-export function loadDTCGTokens(db, sessionId) {
-    const groupRows = db
-        .prepare('SELECT path, description FROM raw_token_groups WHERE session_id = ? ORDER BY path')
-        .all(sessionId);
-    const tokenRows = db
-        .prepare('SELECT path, type, value, description FROM raw_tokens WHERE session_id = ? ORDER BY path')
-        .all(sessionId);
-    const groups = groupRows.map((r) => {
-        const prefix = `${r.path}.`;
-        const tokenIds = tokenRows
-            .filter((t) => t.path.startsWith(prefix) && !t.path.slice(prefix.length).includes('.'))
-            .map((t) => t.path);
-        const g = { path: r.path, tokenIds };
-        if (r.description !== null)
-            g.$description = r.description;
-        return g;
-    });
-    const tokens = tokenRows.map((r) => {
-        const t = {
-            path: r.path,
-            $type: r.type,
-            $value: JSON.parse(r.value),
-        };
-        if (r.description !== null)
-            t.$description = r.description;
-        return t;
-    });
-    return { groups, tokens };
-}
-export function findLatestSessionForCommand(db, command) {
-    const row = db
-        .prepare(`SELECT s.id FROM sessions s
-       JOIN steps st ON st.session_id = s.id
-       WHERE st.command = ? AND st.status = 'complete'
-       ORDER BY st.started_at DESC, st.id DESC
-       LIMIT 1`)
-        .get(command);
-    return row?.id ?? null;
-}
-export function seedCDFFromPriorSession(db, targetSessionId) {
-    const targetComponentIds = db
-        .prepare(`SELECT component_id FROM raw_components WHERE session_id = ?`)
-        .all(targetSessionId);
-    if (targetComponentIds.length === 0)
-        return 0;
-    const placeholders = targetComponentIds.map(() => '?').join(',');
-    const priorRow = db
-        .prepare(`SELECT session_id FROM raw_props
-       WHERE cdf_type IS NOT NULL AND session_id != ?
-         AND component_id IN (${placeholders})
-       ORDER BY rowid DESC LIMIT 1`)
-        .get(targetSessionId, ...targetComponentIds.map((r) => r.component_id));
-    if (!priorRow)
-        return 0;
-    const priorSessionId = priorRow.session_id;
-    const result = db
-        .prepare(`UPDATE raw_props SET
-       cdf_type = (SELECT p2.cdf_type FROM raw_props p2
-                   WHERE p2.session_id = ? AND p2.component_id = raw_props.component_id
-                   AND p2.name = raw_props.name AND p2.cdf_type IS NOT NULL),
-       cdf_category = (SELECT p2.cdf_category FROM raw_props p2
-                       WHERE p2.session_id = ? AND p2.component_id = raw_props.component_id
-                       AND p2.name = raw_props.name AND p2.cdf_type IS NOT NULL),
-       cdf_token_kind = (SELECT p2.cdf_token_kind FROM raw_props p2
-                         WHERE p2.session_id = ? AND p2.component_id = raw_props.component_id
-                         AND p2.name = raw_props.name AND p2.cdf_type IS NOT NULL)
-     WHERE session_id = ? AND cdf_type IS NULL
-       AND EXISTS (SELECT 1 FROM raw_props p2
-                   WHERE p2.session_id = ? AND p2.component_id = raw_props.component_id
-                   AND p2.name = raw_props.name AND p2.cdf_type IS NOT NULL)`)
-        .run(priorSessionId, priorSessionId, priorSessionId, targetSessionId, priorSessionId);
-    db.prepare(`UPDATE raw_components SET description = (
-       SELECT c2.description FROM raw_components c2
-       WHERE c2.session_id = ? AND c2.component_id = raw_components.component_id
-       AND c2.description IS NOT NULL
-     )
-     WHERE session_id = ? AND description IS NULL
-       AND EXISTS (SELECT 1 FROM raw_components c2
-                   WHERE c2.session_id = ? AND c2.component_id = raw_components.component_id
-                   AND c2.description IS NOT NULL)`).run(priorSessionId, targetSessionId, priorSessionId);
-    if (result.changes > 0) {
-        db.prepare(`INSERT OR IGNORE INTO raw_prop_allowed_values (session_id, component_id, prop_name, position, value)
-       SELECT ?, av.component_id, av.prop_name, av.position, av.value
-       FROM raw_prop_allowed_values av
-       WHERE av.session_id = ?
-         AND EXISTS (SELECT 1 FROM raw_props p
-                     WHERE p.session_id = ? AND p.component_id = av.component_id
-                     AND p.name = av.prop_name AND p.cdf_type IS NOT NULL)`).run(targetSessionId, priorSessionId, targetSessionId);
-    }
-    return Number(result.changes);
-}
-export function seedCDFFromPreviewResponse(db, sessionId, removedItems) {
-    if (removedItems.length === 0)
-        return 0;
-    let totalSeeded = 0;
-    const updateStmt = db.prepare(`UPDATE raw_props
-     SET cdf_type = ?, cdf_category = ?
-     WHERE session_id = ? AND component_id = ? AND name = ? AND cdf_type IS NULL`);
-    for (const item of removedItems) {
-        if (!item.fullProperties)
-            continue;
-        const localComponent = db
-            .prepare(`SELECT component_id FROM raw_components WHERE session_id = ? AND name = ?`)
-            .get(sessionId, item.name);
-        if (!localComponent)
-            continue;
-        const contentProps = new Set(item.contentProperties);
-        const designProps = new Set(item.designProperties);
-        for (const [propName, propSummary] of Object.entries(item.fullProperties)) {
-            const cdfType = mapServerTypeToCDFType(propSummary.type);
-            if (!cdfType)
-                continue;
-            let cdfCategory = propSummary.category || null;
-            if (!cdfCategory || !['content', 'design', 'state'].includes(cdfCategory)) {
-                if (contentProps.has(propName))
-                    cdfCategory = 'content';
-                else if (designProps.has(propName))
-                    cdfCategory = 'design';
-                else
-                    cdfCategory = 'state';
-            }
-            const result = updateStmt.run(cdfType, cdfCategory, sessionId, localComponent.component_id, propName);
-            totalSeeded += Number(result.changes);
-        }
-    }
-    return totalSeeded;
-}
-export function seedDefaultsFromChangedItems(db, sessionId, changedItems) {
-    if (changedItems.length === 0)
-        return 0;
-    let totalSeeded = 0;
-    const updateDefaultStmt = db.prepare(`UPDATE raw_props SET default_value = ?
-     WHERE session_id = ? AND component_id = ? AND name = ? AND default_value IS NULL`);
-    const updateCDFStmt = db.prepare(`UPDATE raw_props SET cdf_type = ?, cdf_category = ?
-     WHERE session_id = ? AND component_id = ? AND name = ? AND cdf_type IS NULL`);
-    for (const { current } of changedItems) {
-        if (!current.fullProperties)
-            continue;
-        const localComponent = db
-            .prepare(`SELECT component_id FROM raw_components WHERE session_id = ? AND name = ?`)
-            .get(sessionId, current.name);
-        if (!localComponent)
-            continue;
-        const contentProps = new Set(current.contentProperties);
-        const designProps = new Set(current.designProperties);
-        for (const [propName, propSummary] of Object.entries(current.fullProperties)) {
-            if (propSummary.default !== undefined && propSummary.default !== null) {
-                const defaultStr = typeof propSummary.default === 'string' ? propSummary.default : JSON.stringify(propSummary.default);
-                const result = updateDefaultStmt.run(defaultStr, sessionId, localComponent.component_id, propName);
-                totalSeeded += Number(result.changes);
-            }
-            const cdfType = mapServerTypeToCDFType(propSummary.type);
-            if (!cdfType)
-                continue;
-            let cdfCategory = propSummary.category || null;
-            if (!cdfCategory || !['content', 'design', 'state'].includes(cdfCategory)) {
-                if (contentProps.has(propName))
-                    cdfCategory = 'content';
-                else if (designProps.has(propName))
-                    cdfCategory = 'design';
-                else
-                    cdfCategory = 'state';
-            }
-            const result = updateCDFStmt.run(cdfType, cdfCategory, sessionId, localComponent.component_id, propName);
-            totalSeeded += Number(result.changes);
-        }
-    }
-    return totalSeeded;
-}
-export function backfillUnclassifiedProps(db, sessionId) {
-    const withCategory = db
-        .prepare(`UPDATE raw_props SET cdf_type = 'string', cdf_category = category
-     WHERE session_id = ? AND cdf_type IS NULL AND category IS NOT NULL
-       AND component_id IN (
-         SELECT component_id FROM raw_components WHERE session_id = ? AND status = 'generated'
-       )`)
-        .run(sessionId, sessionId);
-    const withoutCategory = db
-        .prepare(`UPDATE raw_props SET cdf_type = 'string', cdf_category = 'content'
-     WHERE session_id = ? AND cdf_type IS NULL AND category IS NULL
-       AND component_id IN (
-         SELECT component_id FROM raw_components WHERE session_id = ? AND status = 'generated'
-       )`)
-        .run(sessionId, sessionId);
-    return Number(withCategory.changes) + Number(withoutCategory.changes);
-}
-function mapServerTypeToCDFType(serverType) {
-    switch (serverType.toLowerCase()) {
-        case 'string':
-        case 'text':
-            return 'string';
-        case 'richtext':
-            return 'richtext';
-        case 'media':
-            return 'media';
-        case 'link':
-            return 'link';
-        case 'enum':
-        case 'symbol':
-            return 'enum';
-        case 'token':
-            return 'token';
-        case 'boolean':
-            return 'boolean';
-        default:
-            return 'string';
-    }
-}
-export function computeComponentInputHash(component) {
-    const payload = {
-        framework: component.framework,
-        name: component.name,
-        source: component.source,
-        props: component.props.map((p) => ({
-            name: p.name,
-            type: p.type,
-        })),
-        slots: component.slots.map((s) => ({
-            name: s.name,
-            isDefault: s.isDefault,
-            allowedComponents: [...(s.allowedComponents ?? [])].sort(),
-        })),
-    };
-    return createHash('sha256').update(JSON.stringify(payload)).digest('hex');
-}
-export function computeTokenInputHash(rawTokenContent) {
-    return createHash('sha256').update(rawTokenContent.trim()).digest('hex');
-}
-export function lookupCache(db, inputHash, entityType, entityId, promptHash = '') {
-    const row = db
-        .prepare(`SELECT input_hash, entity_type, entity_id, source_session_id, human_edited, created_at, updated_at, prompt_hash
-       FROM generation_cache
-       WHERE input_hash = ? AND entity_type = ? AND entity_id = ? AND prompt_hash = ?`)
-        .get(inputHash, entityType, entityId, promptHash);
-    if (!row)
-        return null;
-    return {
-        inputHash: row.input_hash,
-        entityType: row.entity_type,
-        entityId: row.entity_id,
-        sourceSessionId: row.source_session_id,
-        humanEdited: row.human_edited === 1,
-        promptHash: row.prompt_hash,
-        createdAt: row.created_at,
-        updatedAt: row.updated_at,
-    };
-}
-export function lookupCacheByEntity(db, entityType, entityId) {
-    const row = db
-        .prepare(`SELECT input_hash, entity_type, entity_id, source_session_id, human_edited, created_at, updated_at, prompt_hash
-       FROM generation_cache
-       WHERE entity_type = ? AND entity_id = ?
-       ORDER BY updated_at DESC LIMIT 1`)
-        .get(entityType, entityId);
-    if (!row)
-        return null;
-    return {
-        inputHash: row.input_hash,
-        entityType: row.entity_type,
-        entityId: row.entity_id,
-        sourceSessionId: row.source_session_id,
-        humanEdited: row.human_edited === 1,
-        promptHash: row.prompt_hash,
-        createdAt: row.created_at,
-        updatedAt: row.updated_at,
-    };
-}
-export function storeCache(db, inputHash, entityType, entityId, sourceSessionId, humanEdited, promptHash = '') {
-    const now = new Date().toISOString();
-    db.prepare(`INSERT INTO generation_cache (input_hash, entity_type, entity_id, source_session_id, human_edited, created_at, updated_at, prompt_hash)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?)
-     ON CONFLICT(input_hash, prompt_hash, entity_type, entity_id) DO UPDATE SET
-       source_session_id = excluded.source_session_id,
-       human_edited = CASE WHEN generation_cache.human_edited = 1 THEN 1 ELSE excluded.human_edited END,
-       updated_at = excluded.updated_at`).run(inputHash, entityType, entityId, sourceSessionId, humanEdited ? 1 : 0, now, now, promptHash);
-}
-export function storeScannedFiles(db, sessionId, filePaths) {
-    db.exec('BEGIN');
-    try {
-        db.prepare('DELETE FROM scanned_files WHERE session_id = ?').run(sessionId);
-        const insert = db.prepare('INSERT INTO scanned_files (session_id, path) VALUES (?, ?)');
-        for (const path of filePaths) {
-            insert.run(sessionId, path);
-        }
-        db.exec('COMMIT');
-    }
-    catch (e) {
-        db.exec('ROLLBACK');
-        throw e;
-    }
-}
-export function loadScannedFiles(db, sessionId) {
-    const rows = db.prepare('SELECT path FROM scanned_files WHERE session_id = ? ORDER BY path').all(sessionId);
-    return rows.map((r) => r.path);
-}
-export function storeSlotCycles(db, sessionId, cycles) {
-    db.exec('BEGIN');
-    try {
-        db.prepare('DELETE FROM slot_cycles WHERE session_id = ?').run(sessionId);
-        const insert = db.prepare(`INSERT INTO slot_cycles (session_id, cycle_index, path_json, edges_json, suggested_break_json)
-       VALUES (?, ?, ?, ?, ?)`);
-        for (let i = 0; i < cycles.length; i += 1) {
-            const cycle = cycles[i];
-            insert.run(sessionId, i, JSON.stringify(cycle.path), JSON.stringify(cycle.edges), cycle.suggestedBreak ? JSON.stringify(cycle.suggestedBreak) : null);
-        }
-        db.exec('COMMIT');
-    }
-    catch (e) {
-        db.exec('ROLLBACK');
-        throw e;
-    }
-}
-export function loadSlotCycles(db, sessionId) {
-    const rows = db
-        .prepare('SELECT cycle_index, path_json, edges_json, suggested_break_json FROM slot_cycles WHERE session_id = ? ORDER BY cycle_index')
-        .all(sessionId);
-    return rows.map((r) => ({
-        path: JSON.parse(r.path_json),
-        edges: JSON.parse(r.edges_json),
-        suggestedBreak: r.suggested_break_json ? JSON.parse(r.suggested_break_json) : null,
-    }));
-}
-export function clearSlotCycles(db, sessionId) {
-    db.prepare('DELETE FROM slot_cycles WHERE session_id = ?').run(sessionId);
-}
-export function markCacheHumanEdited(db, entityType, entityId) {
-    const now = new Date().toISOString();
-    db.prepare(`UPDATE generation_cache SET human_edited = 1, updated_at = ? WHERE entity_type = ? AND entity_id = ?`).run(now, entityType, entityId);
-}
-export function copyComponentFromCache(db, sourceSessionId, targetSessionId, componentId) {
-    const now = new Date().toISOString();
-    db.exec('BEGIN');
-    try {
-        const srcComp = db
-            .prepare(`SELECT description, status FROM raw_components WHERE session_id = ? AND component_id = ?`)
-            .get(sourceSessionId, componentId);
-        if (srcComp) {
-            db.prepare(`UPDATE raw_components SET description = ?, status = ?, extracted_at = ? WHERE session_id = ? AND component_id = ?`).run(srcComp.description, srcComp.status, now, targetSessionId, componentId);
-        }
-        const srcProps = db
-            .prepare(`SELECT name, cdf_type, cdf_category, cdf_token_kind, required, description, default_value
-         FROM raw_props WHERE session_id = ? AND component_id = ?`)
-            .all(sourceSessionId, componentId);
-        for (const p of srcProps) {
-            db.prepare(`UPDATE raw_props SET cdf_type = ?, cdf_category = ?, cdf_token_kind = ?, required = ?, description = ?, default_value = ?
-         WHERE session_id = ? AND component_id = ? AND name = ?`).run(p.cdf_type, p.cdf_category, p.cdf_token_kind, p.required, p.description, p.default_value, targetSessionId, componentId, p.name);
-        }
-        db.prepare(`DELETE FROM raw_prop_allowed_values WHERE session_id = ? AND component_id = ?`).run(targetSessionId, componentId);
-        const srcAV = db
-            .prepare(`SELECT prop_name, position, value FROM raw_prop_allowed_values WHERE session_id = ? AND component_id = ?`)
-            .all(sourceSessionId, componentId);
-        const insertAV = db.prepare(`INSERT INTO raw_prop_allowed_values (session_id, component_id, prop_name, position, value) VALUES (?, ?, ?, ?, ?)`);
-        for (const av of srcAV) {
-            insertAV.run(targetSessionId, componentId, av.prop_name, av.position, av.value);
-        }
-        const srcSlots = db
-            .prepare(`SELECT name, required, description FROM raw_slots WHERE session_id = ? AND component_id = ?`)
-            .all(sourceSessionId, componentId);
-        for (const s of srcSlots) {
-            db.prepare(`UPDATE raw_slots SET required = ?, description = ? WHERE session_id = ? AND component_id = ? AND name = ?`).run(s.required, s.description, targetSessionId, componentId, s.name);
-        }
-        db.prepare(`DELETE FROM raw_slot_allowed_components WHERE session_id = ? AND component_id = ?`).run(targetSessionId, componentId);
-        const srcSAC = db
-            .prepare(`SELECT slot_name, position, allowed_component FROM raw_slot_allowed_components WHERE session_id = ? AND component_id = ?`)
-            .all(sourceSessionId, componentId);
-        const insertSAC = db.prepare(`INSERT INTO raw_slot_allowed_components (session_id, component_id, slot_name, allowed_component, position) VALUES (?, ?, ?, ?, ?)`);
-        for (const sac of srcSAC) {
-            insertSAC.run(targetSessionId, componentId, sac.slot_name, sac.allowed_component, sac.position);
-        }
-        db.prepare('UPDATE sessions SET updated_at = ? WHERE id = ?').run(now, targetSessionId);
-        db.exec('COMMIT');
-    }
-    catch (e) {
-        db.exec('ROLLBACK');
-        throw e;
-    }
-}
-export function copyTokensFromCache(db, sourceSessionId, targetSessionId) {
-    const now = new Date().toISOString();
-    db.exec('BEGIN');
-    try {
-        db.prepare('DELETE FROM raw_tokens WHERE session_id = ?').run(targetSessionId);
-        db.prepare('DELETE FROM raw_token_groups WHERE session_id = ?').run(targetSessionId);
-        db.prepare(`INSERT INTO raw_token_groups (session_id, path, description)
-       SELECT ?, path, description FROM raw_token_groups WHERE session_id = ?`).run(targetSessionId, sourceSessionId);
-        db.prepare(`INSERT INTO raw_tokens (session_id, path, type, value, description)
-       SELECT ?, path, type, value, description FROM raw_tokens WHERE session_id = ?`).run(targetSessionId, sourceSessionId);
-        db.prepare('UPDATE sessions SET updated_at = ? WHERE id = ?').run(now, targetSessionId);
-        db.exec('COMMIT');
-    }
-    catch (e) {
-        db.exec('ROLLBACK');
-        throw e;
-    }
-}
-let _cliCacheVersionCache = null;
-export async function getCliCacheVersion() {
-    if (_cliCacheVersionCache)
-        return _cliCacheVersionCache;
-    try {
-        const { hashContent } = await import('./cache-keys.js');
-        const { resolveSkillPath } = await import('@contentful/experience-design-system-generation');
-        const skills = ['components', 'tokens', 'select'];
-        const parts = [];
-        for (const s of skills) {
-            try {
-                const p = resolveSkillPath(s);
-                parts.push(readFileSync(p, 'utf8'));
-            }
-            catch {
-                parts.push(`<missing:${s}>`);
-            }
-        }
-        _cliCacheVersionCache = hashContent(parts.join('\n---\n'));
-        return _cliCacheVersionCache;
-    }
-    catch {
-        _cliCacheVersionCache = 'fallback';
-        return _cliCacheVersionCache;
-    }
-}
-export function storeExtractCache(db, filePath, fileHash, cliVersion, components) {
-    const now = new Date().toISOString();
-    const componentsJson = JSON.stringify(components);
-    db.prepare(`INSERT INTO extract_cache (file_path, file_hash, cli_version, created_at, updated_at, components_json)
-     VALUES (?, ?, ?, ?, ?, ?)
-     ON CONFLICT(file_hash, cli_version) DO UPDATE SET
-       file_path = excluded.file_path,
-       updated_at = excluded.updated_at,
-       components_json = excluded.components_json`).run(filePath, fileHash, cliVersion, now, now, componentsJson);
-}
-export function lookupExtractCache(db, fileHash, cliVersion) {
-    const row = db
-        .prepare(`SELECT file_path, file_hash, cli_version, created_at, updated_at, components_json
-       FROM extract_cache
-       WHERE file_hash = ? AND cli_version = ?`)
-        .get(fileHash, cliVersion);
-    if (!row)
-        return null;
-    let components = [];
-    try {
-        components = JSON.parse(row.components_json);
-    }
-    catch {
-        return null;
-    }
-    return {
-        filePath: row.file_path,
-        fileHash: row.file_hash,
-        cliVersion: row.cli_version,
-        createdAt: row.created_at,
-        updatedAt: row.updated_at,
-        components,
-    };
-}
-/**
- * Content-addressed cache for the composition resolver's raw agent output
- * (authored parser source or emitted-edge JSONL). Keyed by a hash of the
- * candidate files + producer identity (`composition-cache-key.ts`), scoped by
- * `cli_version` so a prompt/skill change invalidates stale entries. Replaces
- * the former on-disk `~/.contentful/.../composition-cache` store so all CLI
- * caches live in the one pipeline DB.
- */
-export function storeCompositionCache(db, inputHash, cliVersion, agentOutput) {
-    const now = new Date().toISOString();
-    db.prepare(`INSERT INTO composition_cache (input_hash, cli_version, agent_output, created_at, updated_at)
-     VALUES (?, ?, ?, ?, ?)
-     ON CONFLICT(input_hash, cli_version) DO UPDATE SET
-       agent_output = excluded.agent_output,
-       updated_at = excluded.updated_at`).run(inputHash, cliVersion, agentOutput, now, now);
-}
-export function lookupCompositionCache(db, inputHash, cliVersion) {
-    const row = db
-        .prepare(`SELECT agent_output FROM composition_cache WHERE input_hash = ? AND cli_version = ?`)
-        .get(inputHash, cliVersion);
-    return row ? row.agent_output : null;
-}
-export function storeSelectCache(db, componentHash, promptHash, cliVersion, decision, reason) {
-    const now = new Date().toISOString();
-    db.prepare(`INSERT INTO select_cache (component_hash, prompt_hash, cli_version, decision, reason, created_at, updated_at)
-     VALUES (?, ?, ?, ?, ?, ?, ?)
-     ON CONFLICT(component_hash, prompt_hash, cli_version) DO UPDATE SET
-       decision = excluded.decision,
-       reason = excluded.reason,
-       updated_at = excluded.updated_at`).run(componentHash, promptHash, cliVersion, decision, reason, now, now);
-}
-export function lookupSelectCache(db, componentHash, promptHash, cliVersion) {
-    const row = db
-        .prepare(`SELECT component_hash, prompt_hash, cli_version, decision, reason, created_at, updated_at
-       FROM select_cache
-       WHERE component_hash = ? AND prompt_hash = ? AND cli_version = ?`)
-        .get(componentHash, promptHash, cliVersion);
-    if (!row)
-        return null;
-    return {
-        componentHash: row.component_hash,
-        promptHash: row.prompt_hash,
-        cliVersion: row.cli_version,
-        decision: row.decision,
-        reason: row.reason,
-        createdAt: row.created_at,
-        updatedAt: row.updated_at,
-    };
-}