@jungjaehoon/mama-core 1.9.0 → 2.0.0

package/dist/search/ranker-trainer.js

@@ -1,29 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.featureSetVersion = exports.SEARCH_RANKER_FEATURE_SET_VERSION = exports.RANKER_QUALITY_FIXTURES = void 0;
-exports.trainOfflineRanker = trainOfflineRanker;
 exports.scoreWithRankerModel = scoreWithRankerModel;
-exports.evaluateAgainstBaselines = evaluateAgainstBaselines;
-exports.insertRankerModelVersion = insertRankerModelVersion;
-exports.activateRankerModel = activateRankerModel;
 exports.ndcgAtK = ndcgAtK;
 exports.mrr = mrr;
-exports.seedQualityFixtureFeedback = seedQualityFixtureFeedback;
-const node_crypto_1 = require("node:crypto");
-const feedback_store_js_1 = require("./feedback-store.js");
 const ranker_features_js_1 = require("./ranker-features.js");
 Object.defineProperty(exports, "featureSetVersion", { enumerable: true, get: function () { return ranker_features_js_1.featureSetVersion; } });
 Object.defineProperty(exports, "SEARCH_RANKER_FEATURE_SET_VERSION", { enumerable: true, get: function () { return ranker_features_js_1.SEARCH_RANKER_FEATURE_SET_VERSION; } });
-const question_type_js_1 = require("./question-type.js");
-const MS_PER_DAY = 24 * 60 * 60 * 1000;
-const LEARNING_RATE = 0.05;
-const MINI_BATCH_SIZE = 32;
-const MAX_EPOCHS = 500;
-const EARLY_STOP_DELTA = 1e-5;
-const MIN_NEUTRAL_PER_QUERY = 3;
 // 0.01 is a small but meaningful margin across 8 fixture queries: it blocks
 // tie/noise wins without demanding a large jump on a tiny evaluation set.
-const RANKER_QUALITY_MARGIN = 0.01;
 function seededShuffle(items, seed) {
     const shuffled = [...items];
     let state = seed >>> 0;
@@ -457,105 +442,6 @@ exports.RANKER_QUALITY_FIXTURES = RAW_RANKER_QUALITY_FIXTURES.map((fixture) => (
     ...fixture,
     candidates: reorderFixtureCandidates(fixture.query, fixture.candidates),
 }));
-function asSourceForFeedback(sourceType) {
-    switch (sourceType) {
-        case 'wiki_page':
-            return 'wiki_page';
-        case 'case':
-            return 'case';
-        case 'connector_event':
-            return 'connector_event';
-        case 'checkpoint':
-            return 'checkpoint';
-        default:
-            return 'decision';
-    }
-}
-function parseDate(input, field) {
-    const date = new Date(input);
-    if (Number.isNaN(date.getTime())) {
-        throw new Error(`${field} must be a valid ISO timestamp`);
-    }
-    return date;
-}
-function iso(date) {
-    return date.toISOString();
-}
-function effectiveWindow(input) {
-    const retentionDays = (0, feedback_store_js_1.getFeedbackRetentionDays)(input.adapter);
-    const now = input.now ?? new Date();
-    const retentionCutoff = new Date(now.getTime() - retentionDays * MS_PER_DAY);
-    const until = input.until ? parseDate(input.until, 'until') : now;
-    const since = input.since ? parseDate(input.since, 'since') : retentionCutoff;
-    if (since.getTime() > until.getTime()) {
-        throw new Error('since must be before until');
-    }
-    const retentionWarning = Boolean(input.since && since.getTime() < retentionCutoff.getTime());
-    if (retentionWarning) {
-        console.warn(JSON.stringify({
-            event: 'training_window_exceeds_retention',
-            since: iso(since),
-            retention_cutoff_at: iso(retentionCutoff),
-        }));
-    }
-    return {
-        since: iso(since),
-        until: iso(until),
-        retention_cutoff_at: iso(retentionCutoff),
-        retention_days_at_train_time: retentionDays,
-        retention_warning: retentionWarning,
-    };
-}
-function labelForKind(kind) {
-    if (kind === 'accept' || kind === 'click') {
-        return 1;
-    }
-    if (kind === 'reject' || kind === 'hide' || kind === 'shown') {
-        return 0;
-    }
-    return null;
-}
-function rowToExample(row) {
-    const label = labelForKind(row.feedback_kind);
-    if (label === null) {
-        return null;
-    }
-    const features = (0, ranker_features_js_1.serializeFeatures)((0, ranker_features_js_1.extractFeatures)({
-        ...row,
-        source_type: row.result_source_type,
-        rank_position: row.rank_position,
-    }, row.query, { question_type: row.question_type }));
-    return {
-        query: row.query,
-        question_type: row.question_type,
-        features,
-        label,
-        feedback_kind: row.feedback_kind,
-        created_at: row.created_at,
-        feedback_id: row.feedback_id,
-    };
-}
-function capNeutralRows(rows) {
-    const byQuery = new Map();
-    for (const row of rows) {
-        const key = row.query_hash_hex || row.query;
-        const current = byQuery.get(key) ?? [];
-        current.push(row);
-        byQuery.set(key, current);
-    }
-    const capped = [];
-    for (const groupRows of byQuery.values()) {
-        const explicit = groupRows.filter((row) => row.feedback_kind !== 'shown');
-        const shown = groupRows.filter((row) => row.feedback_kind === 'shown');
-        const neutralLimit = Math.max(explicit.length * 3, MIN_NEUTRAL_PER_QUERY);
-        capped.push(...explicit, ...shown.slice(0, neutralLimit));
-    }
-    capped.sort((left, right) => {
-        const byCreatedAt = left.created_at.localeCompare(right.created_at);
-        return byCreatedAt !== 0 ? byCreatedAt : left.feedback_id.localeCompare(right.feedback_id);
-    });
-    return capped;
-}
 function sigmoid(value) {
     if (value >= 35) {
         return 1;
@@ -573,254 +459,11 @@ function dot(left, right) {
     }
     return total;
 }
-function hasBothLabels(examples) {
-    const labels = new Set(examples.map((example) => example.label));
-    return labels.has(0) && labels.has(1);
-}
-function trainWeights(examples, featureCount) {
-    const coefficients = new Array(featureCount).fill(0);
-    let intercept = 0;
-    if (examples.length === 0 || !hasBothLabels(examples)) {
-        return { coefficients, intercept };
-    }
-    for (let epoch = 0; epoch < MAX_EPOCHS; epoch += 1) {
-        const shuffledExamples = seededShuffle(examples, epoch + 1);
-        let epochDelta = 0;
-        let batchCount = 0;
-        for (let batchStart = 0; batchStart < shuffledExamples.length; batchStart += MINI_BATCH_SIZE) {
-            const batch = shuffledExamples.slice(batchStart, batchStart + MINI_BATCH_SIZE);
-            const gradients = new Array(featureCount).fill(0);
-            let interceptGradient = 0;
-            for (const example of batch) {
-                const prediction = sigmoid(dot(coefficients, example.features) + intercept);
-                const error = prediction - example.label;
-                for (let index = 0; index < featureCount; index += 1) {
-                    gradients[index] += error * example.features[index];
-                }
-                interceptGradient += error;
-            }
-            let delta = 0;
-            for (let index = 0; index < featureCount; index += 1) {
-                const update = (LEARNING_RATE * gradients[index]) / batch.length;
-                coefficients[index] -= update;
-                delta += Math.abs(update);
-            }
-            const interceptUpdate = (LEARNING_RATE * interceptGradient) / batch.length;
-            intercept -= interceptUpdate;
-            delta += Math.abs(interceptUpdate);
-            epochDelta += delta;
-            batchCount += 1;
-        }
-        if (batchCount > 0 && epochDelta / batchCount < EARLY_STOP_DELTA) {
-            break;
-        }
-    }
-    return { coefficients, intercept };
-}
-function questionWeights(examples, featureCount, fallback) {
-    const output = {};
-    for (const questionType of question_type_js_1.QUESTION_TYPES) {
-        const subset = examples.filter((example) => example.question_type === questionType);
-        output[questionType] = hasBothLabels(subset)
-            ? trainWeights(subset, featureCount).coefficients
-            : [...fallback];
-    }
-    return output;
-}
-function modelIdFor(input) {
-    const compactTime = input.trainedAt.replace(/[^0-9]/g, '').slice(0, 17);
-    const uniqueSuffix = (0, node_crypto_1.randomBytes)(4).toString('hex');
-    return `ranker_${compactTime}_${input.rows}_${input.distinctQueries}_${uniqueSuffix}`;
-}
-async function trainOfflineRanker(input) {
-    const minFeedbackRows = input.minFeedbackRows ?? 1000;
-    const minDistinctQueries = input.minDistinctQueries ?? 10;
-    const window = effectiveWindow(input);
-    const rows = (0, feedback_store_js_1.listSearchFeedback)(input.adapter, {
-        since: window.since,
-        until: window.until,
-    });
-    const cappedRows = capNeutralRows(rows);
-    const examples = cappedRows
-        .map(rowToExample)
-        .filter((example) => Boolean(example));
-    const distinctQueries = new Set(examples.map((example) => example.query.trim().toLowerCase()))
-        .size;
-    const counts = {
-        feedbackRows: examples.length,
-        distinctQueries,
-    };
-    const examplesHaveBothLabels = hasBothLabels(examples);
-    if (counts.feedbackRows < minFeedbackRows ||
-        counts.distinctQueries < minDistinctQueries ||
-        !examplesHaveBothLabels) {
-        return {
-            status: 'insufficient_data',
-            effectiveWindow: window,
-            counts,
-        };
-    }
-    const featureCount = examples[0].features.length;
-    const trained = trainWeights(examples, featureCount);
-    const trainedAt = input.now ? input.now.toISOString() : new Date().toISOString();
-    const model = {
-        model_id: modelIdFor({
-            trainedAt,
-            rows: counts.feedbackRows,
-            distinctQueries: counts.distinctQueries,
-        }),
-        feature_set_version: input.featureSetVersion ?? (0, ranker_features_js_1.featureSetVersion)(),
-        trained_at: trainedAt,
-        training_rows_count: examples.length,
-        coefficients: trained.coefficients,
-        intercept: trained.intercept,
-        question_type_weights: questionWeights(examples, featureCount, trained.coefficients),
-        training_window: window,
-    };
-    return {
-        status: 'trained',
-        model,
-        effectiveWindow: window,
-        counts,
-    };
-}
-function rankByScore(items, score) {
-    return items
-        .map((item) => ({ item, score: score(item) }))
-        .sort((left, right) => {
-        const diff = right.score - left.score;
-        if (Math.abs(diff) > 1e-12) {
-            return diff;
-        }
-        return left.item.id.localeCompare(right.item.id);
-    })
-        .map((entry) => entry.item);
-}
-function reciprocalRankRanks(items, leftScore, rightScore) {
-    const left = rankByScore(items, leftScore);
-    const right = rankByScore(items, rightScore);
-    const leftRanks = new Map(left.map((item, index) => [item.id, index + 1]));
-    const rightRanks = new Map(right.map((item, index) => [item.id, index + 1]));
-    return rankByScore(items, (item) => {
-        const leftRank = leftRanks.get(item.id) ?? items.length;
-        const rightRank = rightRanks.get(item.id) ?? items.length;
-        return 1 / (60 + leftRank) + 1 / (60 + rightRank);
-    });
-}
 function scoreWithRankerModel(model, row, query, questionType) {
     const features = (0, ranker_features_js_1.serializeFeatures)((0, ranker_features_js_1.extractFeatures)(row, query, { question_type: questionType }));
     const coefficients = model.question_type_weights[questionType] ?? model.coefficients;
     return sigmoid(dot(coefficients, features) + model.intercept);
 }
-function baselineMetrics(fixtures, ranker) {
-    const perQuery = {};
-    let ndcgTotal = 0;
-    let mrrTotal = 0;
-    for (const fixture of fixtures) {
-        const ranked = ranker(fixture);
-        const relevance = new Map(fixture.candidates.map((candidate) => [candidate.id, candidate.relevance]));
-        const relevantSet = new Set(fixture.candidates
-            .filter((candidate) => candidate.relevance > 0)
-            .map((candidate) => candidate.id));
-        const ndcg = ndcgAtK(ranked, relevance, 5);
-        const mrrScore = mrr(ranked, relevantSet);
-        perQuery[fixture.query] = { ndcg, mrr: mrrScore };
-        ndcgTotal += ndcg;
-        mrrTotal += mrrScore;
-    }
-    return {
-        ndcg: ndcgTotal / fixtures.length,
-        mrr: mrrTotal / fixtures.length,
-        per_query: perQuery,
-    };
-}
-async function evaluateAgainstBaselines(_input, model) {
-    const bm25 = baselineMetrics(exports.RANKER_QUALITY_FIXTURES, (fixture) => rankByScore(fixture.candidates, (candidate) => candidate.bm25_score));
-    const vector = baselineMetrics(exports.RANKER_QUALITY_FIXTURES, (fixture) => rankByScore(fixture.candidates, (candidate) => candidate.vector_score));
-    const rrf = baselineMetrics(exports.RANKER_QUALITY_FIXTURES, (fixture) => reciprocalRankRanks(fixture.candidates, (candidate) => candidate.bm25_score, (candidate) => candidate.vector_score));
-    const logistic = baselineMetrics(exports.RANKER_QUALITY_FIXTURES, (fixture) => rankByScore(fixture.candidates, (candidate) => 0.5 * candidate.bm25_score + 0.5 * candidate.vector_score));
-    const learned = baselineMetrics(exports.RANKER_QUALITY_FIXTURES, (fixture) => rankByScore(fixture.candidates, (candidate) => scoreWithRankerModel(model, candidate, fixture.query, fixture.question_type)));
-    const bestBaselineNdcg = Math.max(bm25.ndcg, vector.ndcg, rrf.ndcg, logistic.ndcg);
-    const bestBaselineMrr = Math.max(bm25.mrr, vector.mrr, rrf.mrr, logistic.mrr);
-    return {
-        bm25,
-        vector,
-        rrf,
-        logistic,
-        learned,
-        passes: learned.ndcg >= bestBaselineNdcg + RANKER_QUALITY_MARGIN &&
-            learned.mrr >= bestBaselineMrr + RANKER_QUALITY_MARGIN,
-    };
-}
-function runTransaction(adapter, fn) {
-    if (!adapter.transaction) {
-        return fn();
-    }
-    const result = adapter.transaction(fn);
-    if (typeof result === 'function') {
-        return result();
-    }
-    return result;
-}
-async function insertRankerModelVersion(adapter, model, evaluation) {
-    const coefficientsPayload = JSON.stringify({
-        coefficients: model.coefficients,
-        intercept: model.intercept,
-        question_type_weights: model.question_type_weights,
-        training_rows_count: model.training_rows_count,
-    });
-    const metricsPayload = JSON.stringify({
-        learned: evaluation.learned,
-        passes: evaluation.passes,
-    });
-    const baselinePayload = JSON.stringify({
-        bm25: evaluation.bm25,
-        vector: evaluation.vector,
-        rrf: evaluation.rrf,
-        logistic: evaluation.logistic,
-    });
-    const trainingWindowPayload = JSON.stringify(model.training_window ?? {
-        since: null,
-        until: null,
-        retention_cutoff_at: null,
-        retention_days_at_train_time: null,
-        retention_warning: false,
-    });
-    adapter
-        .prepare(`
-        INSERT INTO ranker_model_versions (
-          model_id, model_version, feature_set_version, coefficients_json, metrics_json,
-          training_window_json, baseline_metrics_json, quality_gate_status, trained_at,
-          trained_by, active
-        )
-        VALUES (?, 'offline-logistic-v1', ?, ?, ?, ?, ?, ?, ?, 'mama train-ranker', 0)
-      `)
-        .run(model.model_id, model.feature_set_version, coefficientsPayload, metricsPayload, trainingWindowPayload, baselinePayload, evaluation.passes ? 'passed' : 'failed', model.trained_at);
-    return { model_id: model.model_id, active: false };
-}
-async function activateRankerModel(adapter, model_id) {
-    const row = adapter
-        .prepare(`
-        SELECT model_id, feature_set_version, quality_gate_status
-        FROM ranker_model_versions
-        WHERE model_id = ?
-      `)
-        .get(model_id);
-    if (!row) {
-        return 'not_found';
-    }
-    if (row.feature_set_version !== ranker_features_js_1.SEARCH_RANKER_FEATURE_SET_VERSION) {
-        return 'feature_set_mismatch';
-    }
-    if (row.quality_gate_status !== 'passed') {
-        return 'quality_gate_failed';
-    }
-    runTransaction(adapter, () => {
-        adapter.prepare('UPDATE ranker_model_versions SET active = 0 WHERE active = 1').run();
-        adapter.prepare('UPDATE ranker_model_versions SET active = 1 WHERE model_id = ?').run(model_id);
-    });
-    return 'activated';
-}
 function ndcgAtK(results, relevanceMap, k) {
     const gains = results.slice(0, k).map((result, index) => {
         const relevance = relevanceMap.get(result.id) ?? 0;
@@ -838,23 +481,4 @@ function mrr(results, relevantSet) {
     const index = results.findIndex((result) => relevantSet.has(result.id));
     return index === -1 ? 0 : 1 / (index + 1);
 }
-function seedQualityFixtureFeedback(adapter, createdAt = '2026-04-18T00:00:00.000Z') {
-    let counter = 0;
-    for (const fixture of exports.RANKER_QUALITY_FIXTURES) {
-        for (const candidate of fixture.candidates) {
-            counter += 1;
-            const kind = candidate.relevance >= 3 ? 'accept' : 'reject';
-            adapter
-                .prepare(`
-            INSERT INTO search_feedback (
-              feedback_id, query, query_hash, question_type, result_source_type, result_source_id,
-              case_id, feedback_kind, rank_position, score_before, score_after, session_id,
-              actor, metadata_json, created_at, updated_at
-            )
-            VALUES (?, ?, zeroblob(32), ?, ?, ?, NULL, ?, ?, NULL, NULL, ?, 'test:ranker-fixture', '{}', ?, NULL)
-          `)
-                .run(`quality-${counter}`, fixture.query, fixture.question_type, asSourceForFeedback(candidate.source_type), candidate.id, kind, counter % 5, `fixture:${fixture.question_type}`, createdAt);
-        }
-    }
-}
 //# sourceMappingURL=ranker-trainer.js.map

package/dist/tier-validator.d.ts

@@ -36,20 +36,8 @@ export declare function checkEmbeddings(): CheckResult;
  * Validates database file accessibility
  */
 export declare function checkDatabase(): CheckResult;
-/**
- * Validates MAMA tier status
- *
- * Performs all system checks and determines tier:
- * - Tier 1: All checks pass (full features)
- * - Tier 2: One or more checks fail (degraded mode)
- */
-export declare function validateTier(): Promise<TierValidation>;
 /**
  * Get user-friendly tier description
  */
 export declare function getTierDescription(tier: number): string;
-/**
- * Get tier status banner
- */
-export declare function getTierBanner(validation: TierValidation): string;
 //# sourceMappingURL=tier-validator.d.ts.map

package/dist/tier-validator.js

@@ -18,9 +18,7 @@ exports.checkNodeVersion = checkNodeVersion;
 exports.checkSQLite = checkSQLite;
 exports.checkEmbeddings = checkEmbeddings;
 exports.checkDatabase = checkDatabase;
-exports.validateTier = validateTier;
 exports.getTierDescription = getTierDescription;
-exports.getTierBanner = getTierBanner;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
@@ -148,39 +146,6 @@ function checkDatabase() {
         };
     }
 }
-/**
- * Validates MAMA tier status
- *
- * Performs all system checks and determines tier:
- * - Tier 1: All checks pass (full features)
- * - Tier 2: One or more checks fail (degraded mode)
- */
-async function validateTier() {
-    const checks = [
-        {
-            name: 'Node.js',
-            ...checkNodeVersion(),
-        },
-        {
-            name: 'SQLite',
-            ...checkSQLite(),
-        },
-        {
-            name: 'Embeddings',
-            ...checkEmbeddings(),
-        },
-        {
-            name: 'Database',
-            ...checkDatabase(),
-        },
-    ];
-    // Determine tier: all pass = tier 1, any fail = tier 2
-    const tier = checks.every((c) => c.status === 'pass') ? 1 : 2;
-    return {
-        tier,
-        checks,
-    };
-}
 /**
  * Get user-friendly tier description
  */
@@ -191,25 +156,4 @@ function getTierDescription(tier) {
     };
     return descriptions[tier] || 'Unknown Tier';
 }
-/**
- * Get tier status banner
- */
-function getTierBanner(validation) {
-    const { tier, checks } = validation;
-    const failedChecks = checks.filter((c) => c.status === 'fail');
-    let banner = `\n┌─────────────────────────────────────────┐\n`;
-    banner += `│ MAMA Tier ${tier}: ${getTierDescription(tier).split(' - ')[0]}\n`;
-    if (failedChecks.length > 0) {
-        banner += `│\n`;
-        banner += `│ ⚠️  Issues detected:\n`;
-        failedChecks.forEach((check) => {
-            banner += `│ • ${check.name}: ${check.details}\n`;
-        });
-    }
-    else {
-        banner += `│ ✅ All systems operational\n`;
-    }
-    banner += `└─────────────────────────────────────────┘\n`;
-    return banner;
-}
 //# sourceMappingURL=tier-validator.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jungjaehoon/mama-core",
-  "version": "1.9.0",
+  "version": "2.0.0",
   "description": "MAMA Core - Shared modules for Memory-Augmented MCP Assistant",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -20,7 +20,6 @@
     "./decision-tracker": "./dist/decision-tracker.js",
     "./debug-logger": "./dist/debug-logger.js",
     "./decision-formatter": "./dist/decision-formatter.js",
-    "./memory-inject": "./dist/memory-inject.js",
     "./ollama-client": "./dist/ollama-client.js",
     "./errors": "./dist/errors.js",
     "./time-formatter": "./dist/time-formatter.js",
@@ -32,14 +31,6 @@
     "./canonicalize": "./dist/canonicalize.js",
     "./cases/types": "./dist/cases/types.js",
     "./cases/store": "./dist/cases/store.js",
-    "./cases/role-inference": "./dist/cases/role-inference.js",
-    "./cases/target-ref": "./dist/cases/target-ref.js",
-    "./cases/corrections": "./dist/cases/corrections.js",
-    "./cases/sqlite-transaction": "./dist/cases/sqlite-transaction.js",
-    "./cases/live-state": "./dist/cases/live-state.js",
-    "./cases/tombstone-sweeper": "./dist/cases/tombstone-sweeper.js",
-    "./cases/merge-split": "./dist/cases/merge-split.js",
-    "./cases/membership-matcher": "./dist/cases/membership-matcher.js",
     "./cases/search-rollup": "./dist/cases/search-rollup.js",
     "./cases/timeline-range": "./dist/cases/timeline-range.js",
     "./cases/wiki-page-index": "./dist/cases/wiki-page-index.js",

package/dist/cases/case-links.d.ts

@@ -1,116 +0,0 @@
-import type { DatabaseAdapter } from '../db-manager.js';
-import { type ImmediateTransactionAdapter } from './sqlite-transaction.js';
-export type CaseLinkType = 'related' | 'supersedes-case' | 'subcase-of' | 'blocked-by' | 'duplicate-of';
-export type CaseLinkSourceKind = 'manual' | 'wiki_compiler' | 'hitl_correction' | 'system_backfill';
-export interface CaseLinkRecord {
-    link_id: string;
-    case_id_from: string;
-    case_id_to: string;
-    link_type: CaseLinkType;
-    created_at: string;
-    created_by: string;
-    confidence: number | null;
-    reason_json: string | null;
-    source_kind: CaseLinkSourceKind;
-    source_ref: string | null;
-    source_ref_fingerprint: Buffer | null;
-    source_ref_fingerprint_hex: string | null;
-    revoked_at: string | null;
-    revoked_by: string | null;
-    revoke_reason: string | null;
-}
-export interface CaseLinkCreateInput {
-    link_id?: string;
-    case_id_from: string;
-    case_id_to: string;
-    link_type: CaseLinkType;
-    created_by: string;
-    confidence?: number | null;
-    reason_json?: string | Record<string, unknown> | null;
-    source_kind?: CaseLinkSourceKind;
-    source_ref?: string | null;
-    source_ref_fingerprint?: Buffer | Uint8Array | null;
-    unsuppress_wiki_tombstone?: boolean;
-    expected_current_value_json?: string | null;
-    reconfirm_token?: string | null;
-    session_id?: string | null;
-    now?: string;
-}
-export interface CaseLinkRevokeInput {
-    link_id: string;
-    revoked_by: string;
-    revoke_reason: string;
-    expected_current_value_json?: string | null;
-    reconfirm_token?: string | null;
-    session_id?: string | null;
-    now?: string;
-}
-export interface CaseLinkRequiresReconfirmResult {
-    kind: 'requires_reconfirm';
-    code: 'case.correction_requires_reconfirm';
-    case_id: string;
-    target_kind: 'case_link';
-    target_ref_json: string;
-    current_value_json: string;
-    old_value_json: string | null;
-    proposed_new_value_json: string;
-    reconfirm_token: string;
-    reconfirm_token_expires_at: string;
-    message: string;
-}
-export type CaseLinkCreateResult = {
-    kind: 'created';
-    link_id: string;
-    source_ref_fingerprint_hex: string;
-} | CaseLinkRequiresReconfirmResult | {
-    kind: 'rejected';
-    code: 'case.precompile_gap' | 'case.terminal_status' | 'case.self_link' | 'case.wiki_tombstone_conflict' | 'case.correction_active_conflict' | 'case.reconfirm_token_replayed';
-    message: string;
-    case_id?: string;
-};
-export type CaseLinkRevokeResult = {
-    kind: 'revoked';
-    link_id: string;
-} | CaseLinkRequiresReconfirmResult | {
-    kind: 'rejected';
-    code: 'case.case_link_not_found' | 'case.wiki_tombstone_fingerprint_missing' | 'case.reconfirm_token_replayed';
-    message: string;
-    link_id?: string;
-};
-export interface ListActiveCaseLinksResult {
-    terminal_case_id: string;
-    resolved_via_case_id: string | null;
-    chain: string[];
-    links: CaseLinkRecord[];
-}
-export interface BackfillStructuralLinksResult {
-    duplicate_of_inserted: number;
-    subcase_of_inserted: number;
-}
-type CaseLinkAdapter = Pick<DatabaseAdapter, 'prepare' | 'transaction'> & Partial<Pick<ImmediateTransactionAdapter, 'exec'>>;
-export declare function sha256TombstoneFingerprint(input: {
-    source_case_id: string;
-    target_case_id: string;
-    link_type: CaseLinkType;
-}): Buffer;
-export declare function createCaseLink(adapter: DatabaseAdapter, input: CaseLinkCreateInput): CaseLinkCreateResult;
-export declare function revokeCaseLink(adapter: DatabaseAdapter, input: CaseLinkRevokeInput): CaseLinkRevokeResult;
-export declare function listActiveCaseLinks(adapter: DatabaseAdapter, caseId: string): ListActiveCaseLinksResult;
-export declare function isWikiTombstoneActive(adapter: DatabaseAdapter | CaseLinkAdapter, input: {
-    source_case_id: string;
-    target_case_id: string;
-    link_type: CaseLinkType;
-}): boolean;
-export declare function unsuppressWikiTombstone(adapter: DatabaseAdapter, input: {
-    source_case_id: string;
-    target_case_id: string;
-    link_type: CaseLinkType;
-    unsuppressed_by: string;
-    now?: string;
-}): {
-    kind: 'unsuppressed';
-    unsuppressed_count: number;
-};
-export declare function backfillStructuralLinks(adapter: DatabaseAdapter): BackfillStructuralLinksResult;
-export {};
-//# sourceMappingURL=case-links.d.ts.map