fraim 2.0.346 → 2.0.349

package/dist/src/local-mcp-server/learning-usage-attestation.js

@@ -1,238 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.extractLegacyTitle = exports.parseFiringSection = void 0;
-exports.recordAttestationsFromRetrospective = recordAttestationsFromRetrospective;
-exports.readRetrospectiveForAttestation = readRetrospectiveForAttestation;
-exports.runBackfill = runBackfill;
-const artifact_paths_1 = require("../../registry/scripts/artifact-paths");
-/**
- * Issue #1103 — turning an attestation into a usage record.
- *
- * The retrospective is the durable record of a firing; the usage store is derived
- * from it (R17). So there is exactly one parser (`learning-firing-parser.ts`) and
- * one recorder here, used by two entry points: the live attestation at the end of
- * a job, and the backfill over the retrospectives already on disk (R15).
- *
- * Matching is an id or an exact title, and nothing else. R5 forbids resolving a
- * prose reference to the closest title, and an unmatched item is reported rather
- * than guessed at: a wrong match writes a firing onto the wrong entry, which is
- * worse than no firing at all.
- */
-const fs_1 = require("fs");
-const path_1 = require("path");
-const learning_source_record_1 = require("./learning-source-record");
-const learning_usage_store_1 = require("./learning-usage-store");
-const learning_firing_parser_1 = require("./learning-firing-parser");
-const learning_context_builder_1 = require("./learning-context-builder");
-// Re-exported so callers that only need one of the two halves keep one import.
-var learning_firing_parser_2 = require("./learning-firing-parser");
-Object.defineProperty(exports, "parseFiringSection", { enumerable: true, get: function () { return learning_firing_parser_2.parseFiringSection; } });
-Object.defineProperty(exports, "extractLegacyTitle", { enumerable: true, get: function () { return learning_firing_parser_2.extractLegacyTitle; } });
-const ENTRY_INDEX_READS = [
-    { scope: 'manager', level: 'machine' },
-    { scope: 'manager', level: 'project' },
-    { scope: 'org', level: 'machine' },
-    { scope: 'reverse', level: 'machine' },
-    { scope: 'reverse', level: 'project' },
-];
-function buildEntryIndex(workspaceRoot, userId) {
-    const byId = new Map();
-    const byTitle = new Map();
-    // Keep this list in parity with the preserved-entry levels that the offer
-    // path can surface. Storage resolution stays inside readPreservedLearnings.
-    for (const { scope, level } of ENTRY_INDEX_READS) {
-        let entries = [];
-        try {
-            entries = (0, learning_context_builder_1.readPreservedLearnings)(workspaceRoot, userId, scope, level);
-        }
-        catch {
-            continue;
-        }
-        for (const entry of entries) {
-            const fileType = fileTypeOf(entry);
-            const attestable = {
-                // #1752 A1: one definition of what an entry is, shared with the offer
-                // path. These two disagreeing is defect 4.
-                key: (0, learning_usage_store_1.resolveEntryIdentity)({ id: entry.id, fileType, title: entry.title }).key,
-                family: 'learning',
-                title: entry.title,
-                fileType,
-                level: entry.level,
-            };
-            if (entry.id && !byId.has(entry.id))
-                byId.set(entry.id, attestable);
-            const titleKey = (0, learning_usage_store_1.normalizeEntryTitle)(entry.title);
-            if (!byTitle.has(titleKey))
-                byTitle.set(titleKey, attestable);
-        }
-    }
-    for (const rule of (0, learning_context_builder_1.collectOfferedRuleFiles)(workspaceRoot, true)) {
-        const attestable = {
-            key: rule.key,
-            family: 'rule',
-            title: rule.title,
-            fileType: rule.fileType,
-            level: rule.level,
-        };
-        if (!byId.has(rule.key))
-            byId.set(rule.key, attestable);
-        const titleKey = (0, learning_usage_store_1.normalizeEntryTitle)(rule.title);
-        if (!byTitle.has(titleKey))
-            byTitle.set(titleKey, attestable);
-        if (rule.id && !byId.has(rule.id))
-            byId.set(rule.id, attestable);
-    }
-    return { byId, byTitle };
-}
-function fileTypeOf(entry) {
-    return learning_context_builder_1.CATEGORY_TO_FILETYPE[entry.category] ?? 'mistake-patterns';
-}
-function retrospectiveDate(content, fallback) {
-    const match = content.match(/^date:\s*(\d{4}-\d{2}-\d{2})\s*$/m);
-    return match ? match[1] : fallback;
-}
-/**
- * Record the firings a retrospective attests. Idempotent per (entry, source), so a
- * re-run, or a backfill that overlaps a live attestation, cannot inflate a count.
- */
-function recordAttestationsFromRetrospective(workspaceRoot, userId, options) {
-    const limits = options.limits ?? (0, learning_usage_store_1.resolveUsageLimits)(workspaceRoot);
-    const parsed = (0, learning_firing_parser_1.parseFiringSection)(options.content, { source: options.source, legacy: options.legacy });
-    const date = options.date ?? retrospectiveDate(options.content, new Date().toISOString().slice(0, 10));
-    const index = buildEntryIndex(workspaceRoot, userId);
-    const unmatched = [];
-    const inputs = [];
-    for (const item of parsed.items) {
-        let entry;
-        if (item.id) {
-            entry = index.byId.get(item.id);
-            if (!entry) {
-                unmatched.push({
-                    id: item.id,
-                    title: item.title,
-                    reason: `No entry carries the id ${item.id}. Reported unmatched rather than assigned to the closest title.`,
-                    raw: item.raw,
-                });
-                continue;
-            }
-        }
-        else {
-            entry = index.byTitle.get((0, learning_usage_store_1.normalizeEntryTitle)(item.title));
-            if (!entry) {
-                unmatched.push({
-                    id: null,
-                    title: item.title,
-                    reason: 'No entry has exactly this title. Exact titles match; a paraphrase is reported rather than resolved by similarity.',
-                    raw: item.raw,
-                });
-                continue;
-            }
-        }
-        inputs.push({
-            key: entry.key,
-            family: entry.family,
-            title: entry.title,
-            fileType: entry.fileType,
-            level: entry.level,
-            outcome: item.outcome,
-            note: item.note,
-            job: options.job,
-            date,
-            agent: options.agent,
-            model: options.model,
-            source: item.format === 'legacy' ? 'backfill-legacy' : 'attested',
-            sourceRef: options.source,
-        });
-    }
-    let applied = 0;
-    let alreadyRecorded = 0;
-    if (inputs.length > 0) {
-        const result = (0, learning_usage_store_1.recordFirings)(inputs, {
-            limits, now: options.now, storePath: options.storePath, integrityMode: options.integrityMode,
-        });
-        applied = result.recorded;
-        alreadyRecorded = result.alreadyRecorded;
-    }
-    return {
-        source: options.source,
-        sectionState: parsed.sectionState,
-        itemsRead: parsed.items.length + parsed.rejected.length,
-        applied,
-        alreadyRecorded,
-        unmatched,
-        rejected: parsed.rejected,
-    };
-}
-// ── R15: backfill ────────────────────────────────────────────────────────────
-/** Resolve live attestation against its recorded home and immutable accounting identity. */
-function readRetrospectiveForAttestation(workspaceRoot, userId, filePath) {
-    let reason = 'Retrospective is outside configured learning homes';
-    for (const home of (0, learning_context_builder_1.getLearningInputHomes)(workspaceRoot)) {
-        const result = (0, learning_context_builder_1.readLearningSourceFile)((0, path_1.resolve)(filePath), home.root, home.contentRoot);
-        if (result.status !== 'valid') {
-            reason = result.reason;
-            continue;
-        }
-        if (result.record.kind !== 'retrospective' || result.record.author !== userId) {
-            throw new Error('Retrospective kind or author does not match this attestation');
-        }
-        return { content: result.content, record: result.record };
-    }
-    throw new Error(`Invalid learning retrospective: ${reason}`);
-}
-/** Read only typed future reflections, including archives, with stable accounting identity. */
-function runBackfill(workspaceRoot, userId, options) {
-    const limits = options.limits ?? (0, learning_usage_store_1.resolveUsageLimits)(workspaceRoot);
-    const report = {
-        filesScanned: 0, filesWithSection: 0, itemsRead: 0, applied: 0,
-        alreadyRecorded: 0, unmatched: [], rejected: [], synthesizedFilesRead: 0, invalidRecords: [],
-    };
-    const seen = new Set();
-    for (const home of (0, learning_context_builder_1.getLearningInputHomes)(workspaceRoot)) {
-        const paths = (0, artifact_paths_1.resolveLearningPaths)(home.root, home.contentRoot);
-        for (const dir of [paths.retrospectives, paths.archiveRetrospectives]) {
-            if (options.retrospectivesDir && (0, learning_source_record_1.normalizeLearningSourcePath)(dir) !== (0, learning_source_record_1.normalizeLearningSourcePath)(options.retrospectivesDir))
-                continue;
-            let files;
-            try {
-                if ((0, fs_1.lstatSync)(dir).isSymbolicLink())
-                    continue;
-                files = (0, fs_1.readdirSync)(dir).filter(f => f.endsWith('.md'));
-            }
-            catch {
-                continue;
-            }
-            for (const file of files) {
-                const filePath = (0, path_1.join)(dir, file);
-                const parsed = (0, learning_context_builder_1.readLearningSourceFile)(filePath, home.root, home.contentRoot);
-                if (parsed.status !== 'valid') {
-                    if (parsed.status === 'invalid')
-                        report.invalidRecords.push({ path: filePath, reason: parsed.reason });
-                    continue;
-                }
-                const { record } = parsed;
-                if (record.kind !== 'retrospective' || record.author !== userId)
-                    continue;
-                if (seen.has(record.usageIdentity))
-                    continue;
-                seen.add(record.usageIdentity);
-                report.filesScanned++;
-                if (record.synthesized)
-                    report.synthesizedFilesRead++;
-                const result = recordAttestationsFromRetrospective(workspaceRoot, userId, {
-                    content: parsed.content, source: record.usageIdentity, job: record.job, date: record.date,
-                    agent: options.agent, model: options.model, legacy: false,
-                    limits, now: options.now, storePath: options.storePath, integrityMode: 'flag',
-                });
-                if (result.sectionState !== 'absent')
-                    report.filesWithSection++;
-                report.itemsRead += result.itemsRead;
-                report.applied += result.applied;
-                report.alreadyRecorded += result.alreadyRecorded;
-                report.unmatched.push(...result.unmatched);
-                report.rejected.push(...result.rejected);
-            }
-        }
-    }
-    return report;
-}