@jungjaehoon/mama-os 0.53.1 → 0.58.0

package/dist/operator/console-brief.js

@@ -1,246 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.hashConsoleBrief = exports.CONSOLE_BRIEF_DEFAULT = exports.CONSOLE_BRIEF_MAX_CHARS = void 0;
-exports.modernizeLegacyBriefMechanism = modernizeLegacyBriefMechanism;
-exports.consoleBriefPath = consoleBriefPath;
-exports.ensureConsoleBrief = ensureConsoleBrief;
-exports.loadConsoleBrief = loadConsoleBrief;
-exports.projectConsoleBriefForPrompt = projectConsoleBriefForPrompt;
-exports.readConsoleBriefSnapshot = readConsoleBriefSnapshot;
-exports.prepareConsoleBriefUpdate = prepareConsoleBriefUpdate;
-/**
- * Owner-console operating brief - the agent-owned operations manual.
- *
- * A mature operating prompt accretes one line per operational failure and
- * owner correction. This module preserves that learning LOOP, not a private
- * deployment's manual:
- * the system seeds a mechanism skeleton once and provides the write path;
- * the agent fills it from experience (console_brief_update, log-loud).
- *
- * Ownership contract: seeded only when missing, agent/user edits always win, NO
- * managed auto-upgrade. Since One MAMA this is the ONE brief every turn (chat,
- * event, scheduled) starts from; scheduled turns append a host turn-kind section.
- * The immutable behavioural floor (act-vs-ask boundary, evidence rules) stays
- * code-owned in message-router's discipline - this file layers the EVOLVING
- * knowledge on top and must never be treated as the security boundary.
- *
- * English mechanism only; personal/channel strings belong in runtime data.
- */
-const node_fs_1 = require("node:fs");
-const node_os_1 = require("node:os");
-const node_crypto_1 = require("node:crypto");
-const procedure_projection_js_1 = require("./procedure-projection.js");
-const node_path_1 = require("node:path");
-const private_prompt_overlay_js_1 = require("../connectors/private-prompt-overlay.js");
-/** Full-replace ceiling with headroom for a mature manual while preventing a
- * runaway self-edit from bloating every future prompt. */
-exports.CONSOLE_BRIEF_MAX_CHARS = 32_000;
-const LEGACY_CONSOLE_PRIVATE_LINES = new Set([
-    '- Business data: progressive exploration - kagemusha_overview() then',
-    'kagemusha_entities({activeOnly:true}) then kagemusha_tasks({...}) then',
-    'kagemusha_messages({channelId, since}) on the busiest channels. Never',
-    'widen a since window you were given.',
-    '- Use kagemusha_tasks first.',
-]);
-exports.CONSOLE_BRIEF_DEFAULT = `# Owner Console Operating Brief
-
-This file is yours; upgrades never overwrite it. It holds standing operating rules only.
-How you work is learned from the owner's corrections: store each one with procedure_update
-(when_to_use / when_not_to_use) in the turn it arrives. This brief is not a lesson log.
-Correct one of its rules with console_brief_update (replace or retire an exact target with the
-expected_hash from procedure_read({id:"owner-console-brief"})). Saving is not proof of changed behavior.
-`;
-/** Upgrade only the known, code-owned legacy tool mechanism when rendering a modern runtime.
- * The stored original and all owner business rules remain untouched. */
-function modernizeLegacyBriefMechanism(raw) {
-    const shortIntroduction = 'When the owner corrects how you work, or a procedure fails and you learn the\n' +
-        'fix, record it with console_brief_update({lesson}) - one durable lesson per\n' +
-        "call, appended below with today's date while everything above is preserved.";
-    const oldIntroduction = shortIntroduction +
-        '\n' +
-        'This is how your operating manual grows; losing a lesson means repeating the\n' +
-        'failure.';
-    const oldSelfUpdate = '- When the owner corrects your working style, or a recipe above proves\n' +
-        '  wrong, call console_brief_update({lesson}) in the same turn and say you\n' +
-        '  did. One concrete lesson per call; the file itself is curated by the\n' +
-        '  owner - you only ever add.';
-    const correctedIntroduction = 'Store owner corrections with procedure_update (when_to_use / when_not_to_use). Correct one existing brief rule with console_brief_update replace or retire and expected_hash; the brief is not a lesson log. Saving is not proof of changed behavior.';
-    const replacements = [
-        // Replace the longer seed first so its obsolete continuation cannot survive.
-        [oldIntroduction, correctedIntroduction],
-        [shortIntroduction, correctedIntroduction],
-        [
-            oldSelfUpdate,
-            '- Store the correction with procedure_update in the same turn; correct a contradicted brief rule with console_brief_update replace or retire and expected_hash, preserving unrelated rules.',
-        ],
-    ];
-    const project = (text) => replacements.reduce((value, [before, after]) => value
-        .replace(before, after)
-        .replace(before.replace(/\n/g, '\r\n'), after.replace(/\n/g, '\r\n')), text);
-    let output = '';
-    let prose = '';
-    let fence = null;
-    for (const line of raw.match(/[^\n]*(?:\n|$)/g) ?? []) {
-        const marker = line.match(/^ {0,3}(`{3,}|~{3,})/);
-        if (!fence && marker) {
-            output += project(prose) + line;
-            prose = '';
-            fence = { char: marker[1][0], length: marker[1].length };
-        }
-        else if (fence) {
-            output += line;
-            if (marker && marker[1][0] === fence.char && marker[1].length >= fence.length)
-                fence = null;
-        }
-        else {
-            prose += line;
-        }
-    }
-    return output + project(prose);
-}
-function consoleBriefPath(homeDir = (0, node_os_1.homedir)()) {
-    return (0, node_path_1.join)(homeDir, '.mama', 'briefs', 'brief-owner-console.md');
-}
-/** Boot seeding - write the packaged default ONLY when missing (agent/user
- *  edits always win; deliberate no-auto-upgrade, mirroring ensureBriefs). */
-function ensureConsoleBrief(homeDir = (0, node_os_1.homedir)()) {
-    const path = consoleBriefPath(homeDir);
-    if ((0, node_fs_1.existsSync)(path))
-        return false;
-    (0, node_fs_1.mkdirSync)((0, node_path_1.join)(homeDir, '.mama', 'briefs'), { recursive: true });
-    const tmpPath = `${path}.${(0, node_crypto_1.randomUUID)()}.tmp`;
-    (0, node_fs_1.writeFileSync)(tmpPath, exports.CONSOLE_BRIEF_DEFAULT, { encoding: 'utf8', flag: 'wx', mode: 0o600 });
-    try {
-        // Exclusive publication keeps a concurrent human-created brief intact.
-        (0, node_fs_1.linkSync)(tmpPath, path);
-        return true;
-    }
-    catch (error) {
-        if (error.code === 'EEXIST') {
-            return false;
-        }
-        throw error;
-    }
-    finally {
-        (0, node_fs_1.unlinkSync)(tmpPath);
-    }
-}
-/** Read the current brief; empty string when absent (caller seeds on boot). */
-function loadConsoleBrief(homeDir = (0, node_os_1.homedir)()) {
-    const path = consoleBriefPath(homeDir);
-    if (!(0, node_fs_1.existsSync)(path))
-        return '';
-    return (0, node_fs_1.readFileSync)(path, 'utf-8');
-}
-function removeLegacyConsolePrivateLines(raw) {
-    const parts = raw.split(/(\r?\n)/);
-    let projected = '';
-    for (let index = 0; index < parts.length; index += 2) {
-        const line = parts[index] ?? '';
-        const separator = parts[index + 1] ?? '';
-        if (!LEGACY_CONSOLE_PRIVATE_LINES.has(line)) {
-            projected += line + separator;
-        }
-    }
-    return projected;
-}
-/** Project a user-owned brief for one prompt without modifying its file. */
-function projectConsoleBriefForPrompt(raw, policy) {
-    const overlay = (0, private_prompt_overlay_js_1.buildPrivatePromptOverlay)('owner_console', policy);
-    const projected = (0, private_prompt_overlay_js_1.stripDisabledPrivatePromptRecipes)(removeLegacyConsolePrivateLines((0, private_prompt_overlay_js_1.stripMarkedPrivatePromptOverlays)(raw)), overlay.length > 0);
-    if (!overlay) {
-        return projected;
-    }
-    const separator = projected.endsWith('\n\n') ? '' : projected.endsWith('\n') ? '\n' : '\n\n';
-    return `${projected}${separator}${overlay}\n`;
-}
-exports.hashConsoleBrief = procedure_projection_js_1.hashProcedureDocument;
-function readConsoleBriefSnapshot(homeDir = (0, node_os_1.homedir)()) {
-    const path = consoleBriefPath(homeDir);
-    const text = loadConsoleBrief(homeDir);
-    return { path, text, hash: (0, node_fs_1.existsSync)(path) ? (0, exports.hashConsoleBrief)(text) : null };
-}
-/** Pure preparation: the canonical store commits this text and its old revision
- * before attempting Markdown publication. No full-document replace operation.
- */
-function prepareConsoleBriefUpdate(input, current) {
-    const priorHash = (0, exports.hashConsoleBrief)(current);
-    if (input.expectedHash !== undefined && input.expectedHash !== priorHash) {
-        throw new Error('console brief update refused: expected hash conflict');
-    }
-    let text;
-    if (input.operation === 'append') {
-        // Retired 2026-09-09: dated lesson lines accreted into a 10K brief with contradictory
-        // rules. Corrections are procedures now; the brief only ever changes by exact target.
-        throw new Error('console brief update refused: append is retired; store the correction with procedure_update');
-    }
-    else if (input.operation === 'replace' || input.operation === 'retire') {
-        if (!input.expectedHash) {
-            throw new Error('console brief update refused: expected hash required');
-        }
-        const target = input.target;
-        if (!target?.trim() || target.trim() === current.trim()) {
-            throw new Error('console brief update refused: exact partial target required');
-        }
-        const offset = current.indexOf(target);
-        if (offset < 0 || current.indexOf(target, offset + 1) >= 0) {
-            throw new Error('console brief update refused: missing or ambiguous target');
-        }
-        const end = offset + target.length;
-        if ((offset > 0 && current[offset - 1] !== '\n') ||
-            (end < current.length && !target.endsWith('\n') && !/^[\r\n]/.test(current.slice(end)))) {
-            throw new Error('console brief update refused: target must contain a complete rule or section');
-        }
-        const section = /^(#{2,6})[ \t]+/.exec(target);
-        if (section) {
-            const level = section[1].length;
-            const nextHeading = /^(#{1,6})[ \t]+/gm;
-            nextHeading.lastIndex = offset + target.split('\n')[0].length + 1;
-            let boundary = current.length;
-            let match;
-            while ((match = nextHeading.exec(current)) !== null) {
-                if (match[1].length <= level) {
-                    boundary = match.index;
-                    break;
-                }
-            }
-            if (end > boundary || current.slice(end, boundary).trim()) {
-                throw new Error('console brief update refused: target must contain exactly one complete section');
-            }
-        }
-        else {
-            const isListRule = /^[-*+] |^\d+[.)] /.test(target);
-            const precedingLine = current
-                .slice(0, offset)
-                .replace(/\r?\n$/, '')
-                .split(/\r?\n/)
-                .pop() ?? '';
-            if (/^#/.test(target) ||
-                /\n(?:#{1,6} |[-*+] |\d+[.)] )/.test(target) ||
-                (!isListRule && (precedingLine.trim() || /\r?\n\s*\r?\n/.test(target.trim())))) {
-                throw new Error('console brief update refused: target must contain one complete rule or section');
-            }
-        }
-        if (!section) {
-            const remainder = current.slice(end).replace(/^\r?\n/, '');
-            const followingLine = remainder.split(/\r?\n/)[0];
-            if (followingLine.trim() && !/^(?:#{1,6} |[-*+] |\d+[.)] )/.test(followingLine)) {
-                throw new Error('console brief update refused: target must contain the complete wrapped rule');
-            }
-        }
-        const replacement = input.operation === 'retire' ? '' : input.replacement;
-        if (replacement === undefined || (input.operation === 'replace' && !replacement.trim())) {
-            throw new Error('console brief update refused: nonempty replacement required');
-        }
-        text = current.slice(0, offset) + replacement + current.slice(end);
-    }
-    else {
-        throw new Error('console brief update refused: unsupported operation');
-    }
-    if (text.length > exports.CONSOLE_BRIEF_MAX_CHARS) {
-        throw new Error(`console brief update refused: ${text.length} chars exceeds ${exports.CONSOLE_BRIEF_MAX_CHARS}`);
-    }
-    return { text, priorHash, hash: (0, exports.hashConsoleBrief)(text) };
-}
-/** Legacy append-only API, preserving its return value and seed-on-missing behavior. */
-//# sourceMappingURL=console-brief.js.map

package/dist/operator/console-brief.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"console-brief.js","sourceRoot":"","sources":["../../src/operator/console-brief.ts"],"names":[],"mappings":"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"}

package/dist/operator/experience-evidence.d.ts

@@ -1,18 +0,0 @@
-import type { ProcedureAccess } from './procedure-store.js';
-export interface ExecutionEvidence {
-    input: unknown;
-    result: unknown;
-    inputHash: string | null;
-    resultHash: string | null;
-    completeness: 'complete' | 'redacted' | 'oversized' | 'unserializable';
-    redactions: string[];
-}
-export declare function safeExperienceSummary(text: string): string;
-/** Preserve comparable execution evidence, never turn an error into an action recipe. */
-export declare function captureExecutionEvidence(input: unknown, result: unknown): ExecutionEvidence;
-export declare function traceReadScope(access: ProcedureAccess): {
-    owner_scope: string;
-    project_id: string;
-    channel_id?: string;
-};
-//# sourceMappingURL=experience-evidence.d.ts.map

package/dist/operator/experience-evidence.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"experience-evidence.d.ts","sourceRoot":"","sources":["../../src/operator/experience-evidence.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAM5D,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,gBAAgB,CAAC;IACvE,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAeD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI1D;AAED,yFAAyF;AACzF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,iBAAiB,CA4C3F;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CASA"}

package/dist/operator/experience-evidence.js

@@ -1,82 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.safeExperienceSummary = safeExperienceSummary;
-exports.captureExecutionEvidence = captureExecutionEvidence;
-exports.traceReadScope = traceReadScope;
-const node_crypto_1 = require("node:crypto");
-const secret_filter_js_1 = require("../memory/secret-filter.js");
-const MAX_EVIDENCE_BYTES = 65_536;
-const SECRET_FIELD = /^(password|passphrase|api[_-]?key|access[_-]?token|refresh[_-]?token|authorization|cookie|secret|private[_-]?key)$/i;
-const CREDENTIAL_TEXT = /(?:["']?\b(?:password|passphrase|api[_-]?key|access[_-]?token|refresh[_-]?token|authorization|cookie|secret|private[_-]?key)["']?\s*[:=]\s*[^\s,;}]+|--(?:password|token|api-key)\s+\S+)/i;
-function hasSecretField(value, depth = 0) {
-    if (depth > 32)
-        return true;
-    if (typeof value === 'string')
-        return CREDENTIAL_TEXT.test(value);
-    if (!value || typeof value !== 'object')
-        return false;
-    return Object.entries(value).some(([key, entry]) => (SECRET_FIELD.test(key) && entry !== null && entry !== '') || hasSecretField(entry, depth + 1));
-}
-function safeExperienceSummary(text) {
-    return !(0, secret_filter_js_1.scanForSecrets)(text).clean || CREDENTIAL_TEXT.test(text)
-        ? '[redacted execution summary]'
-        : text;
-}
-/** Preserve comparable execution evidence, never turn an error into an action recipe. */
-function captureExecutionEvidence(input, result) {
-    let inputText;
-    let resultText;
-    try {
-        inputText = JSON.stringify(input ?? null);
-        resultText = JSON.stringify(result ?? null);
-        if (typeof inputText !== 'string' || typeof resultText !== 'string')
-            throw new Error('non-JSON evidence');
-    }
-    catch {
-        return {
-            input: null,
-            result: null,
-            inputHash: null,
-            resultHash: null,
-            completeness: 'unserializable',
-            redactions: [],
-        };
-    }
-    const inputHash = (0, node_crypto_1.createHash)('sha256').update(inputText).digest('hex');
-    const resultHash = (0, node_crypto_1.createHash)('sha256').update(resultText).digest('hex');
-    const common = { inputHash, resultHash };
-    if (Buffer.byteLength(inputText) + Buffer.byteLength(resultText) > MAX_EVIDENCE_BYTES) {
-        return { ...common, input: null, result: null, completeness: 'oversized', redactions: [] };
-    }
-    const inputValue = JSON.parse(inputText);
-    const resultValue = JSON.parse(resultText);
-    const scan = (0, secret_filter_js_1.scanForSecrets)(inputText + '\n' + resultText);
-    const secretFields = hasSecretField(inputValue) || hasSecretField(resultValue);
-    if (!scan.clean || secretFields) {
-        return {
-            ...common,
-            input: null,
-            result: null,
-            completeness: 'redacted',
-            redactions: [...scan.matches, ...(secretFields ? ['credential-field'] : [])],
-        };
-    }
-    return {
-        ...common,
-        input: inputValue,
-        result: resultValue,
-        completeness: 'complete',
-        redactions: [],
-    };
-}
-function traceReadScope(access) {
-    if (access.ownerScope !== 'owner:runtime' && !access.channelId) {
-        throw new Error('Execution evidence member channel required');
-    }
-    return {
-        owner_scope: access.ownerScope,
-        project_id: access.projectId,
-        ...(access.ownerScope === 'owner:runtime' ? {} : { channel_id: access.channelId }),
-    };
-}
-//# sourceMappingURL=experience-evidence.js.map

package/dist/operator/experience-evidence.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"experience-evidence.js","sourceRoot":"","sources":["../../src/operator/experience-evidence.ts"],"names":[],"mappings":"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"}

package/dist/operator/experience-hints.d.ts

@@ -1,44 +0,0 @@
-/**
- * Per-thread procedure hints.
- *
- * Shape reused from the working Kagemusha loop (agent-loop.ts buildBrainContext): rank
- * by the current message, at most three hits, about 1200 chars when a thread is opened or
- * re-opened and about 600 inside a live thread, and never repeat the same hint to the same
- * thread. The host selects and budgets; whether a hint applies stays the agent's judgment,
- * so a hint carries conditions and an entrance to the original, never an action order.
- */
-/** Stored text is data inside a host block: it must not be able to author markup. */
-export declare function escapePromptMarkup(text: string): string;
-export declare const FRESH_HINT_CHARS = 1200;
-export declare const CONTINUE_HINT_CHARS = 600;
-export interface ProcedureHintCandidate {
-    id: string;
-    revision: number;
-    title: string;
-    description: string;
-    whenToUse: string;
-    whenNotToUse: string;
-    updatedAt: number;
-}
-/**
- * What one backend thread has been told: id -> the revision rendered to it, or null when
- * the thread only saw the id counted in a catalog total. Absent ids are new to the thread.
- */
-export type ThreadHintMemory = Map<string, number | null>;
-export declare function selectProcedureHints(input: {
-    stimulus: string;
-    candidates: readonly ProcedureHintCandidate[];
-    maxHits?: number;
-    /** Omit on a fresh thread: everything is new to it. */
-    seen?: ThreadHintMemory;
-}): ProcedureHintCandidate[];
-export declare function renderProcedureHints(input: {
-    hits: readonly ProcedureHintCandidate[];
-    total: number;
-    maxChars: number;
-    fresh: boolean;
-}): {
-    text: string;
-    rendered: ProcedureHintCandidate[];
-};
-//# sourceMappingURL=experience-hints.d.ts.map

package/dist/operator/experience-hints.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"experience-hints.d.ts","sourceRoot":"","sources":["../../src/operator/experience-hints.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAIvC,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;AAoB1D,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB,GAAG,sBAAsB,EAAE,CAgB3B;AAmBD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,IAAI,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,sBAAsB,EAAE,CAAA;CAAE,CAuBvD"}

package/dist/operator/experience-hints.js

@@ -1,98 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONTINUE_HINT_CHARS = exports.FRESH_HINT_CHARS = void 0;
-exports.escapePromptMarkup = escapePromptMarkup;
-exports.selectProcedureHints = selectProcedureHints;
-exports.renderProcedureHints = renderProcedureHints;
-/**
- * Per-thread procedure hints.
- *
- * Shape reused from the working Kagemusha loop (agent-loop.ts buildBrainContext): rank
- * by the current message, at most three hits, about 1200 chars when a thread is opened or
- * re-opened and about 600 inside a live thread, and never repeat the same hint to the same
- * thread. The host selects and budgets; whether a hint applies stays the agent's judgment,
- * so a hint carries conditions and an entrance to the original, never an action order.
- */
-/** Stored text is data inside a host block: it must not be able to author markup. */
-function escapePromptMarkup(text) {
-    return text
-        .replace(/&(?!amp;|lt;|gt;|quot;|apos;)/g, '&')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;');
-}
-exports.FRESH_HINT_CHARS = 1200;
-exports.CONTINUE_HINT_CHARS = 600;
-const DEFAULT_MAX_HITS = 3;
-const MAX_LINE_CHARS = 240;
-function tokens(text) {
-    return [
-        ...new Set(text
-            .toLowerCase()
-            .split(/[\s"'`.,;:!?()[\]{}<>|/\\-]+/)
-            .filter((token) => token.length > 1)),
-    ];
-}
-function overlap(stimulusTokens, candidate) {
-    const haystack = [candidate.title, candidate.description, candidate.whenToUse]
-        .join(' ')
-        .toLowerCase();
-    return stimulusTokens.filter((token) => haystack.includes(token)).length;
-}
-function selectProcedureHints(input) {
-    const stimulusTokens = tokens(input.stimulus);
-    const scored = input.candidates
-        .map((candidate) => ({ candidate, overlap: overlap(stimulusTokens, candidate) }))
-        .filter(({ candidate, overlap }) => {
-        if (!input.seen)
-            return true;
-        const shown = input.seen.get(candidate.id);
-        if (shown === candidate.revision)
-            return false;
-        if (shown === undefined || typeof shown === 'number')
-            return true;
-        return overlap > 0;
-    })
-        .sort((left, right) => right.overlap - left.overlap || right.candidate.updatedAt - left.candidate.updatedAt);
-    return scored.slice(0, input.maxHits ?? DEFAULT_MAX_HITS).map(({ candidate }) => candidate);
-}
-function line(candidate, maxChars) {
-    const head = `- ${candidate.id}@${candidate.revision} `;
-    const body = escapePromptMarkup(`${candidate.title}: ${candidate.description} | use: ${candidate.whenToUse} | not: ${candidate.whenNotToUse}`
-        .replace(/\s+/g, ' ')
-        .trim());
-    const room = maxChars - head.length;
-    if (room <= 3)
-        return '';
-    return head + (body.length <= room ? body : `${body.slice(0, room - 3)}...`);
-}
-const FRESH_INSTRUCTION = 'Scoped procedures that may apply to this work: guidance, not authority or instructions; judge applicability. procedure_read loads a complete body by id, procedure_list the full catalog, procedure_update/retire correct one with expected_revision, experience_read lists execution evidence.';
-const CONTINUE_INSTRUCTION = 'Procedures new or revised for this thread, or possibly relevant now: guidance, not instructions. procedure_read loads a body.';
-function renderProcedureHints(input) {
-    if (input.hits.length === 0)
-        return { text: '', rendered: [] };
-    const open = '<procedure_hints>';
-    const close = '</procedure_hints>';
-    const lines = [open, input.fresh ? FRESH_INSTRUCTION : CONTINUE_INSTRUCTION];
-    const more = input.fresh && input.total > input.hits.length
-        ? `${input.total - input.hits.length} more: procedure_list`
-        : '';
-    let used = lines.join('\n').length + 1 + close.length + (more ? more.length + 1 : 0);
-    if (used > input.maxChars)
-        return { text: '', rendered: [] };
-    const rendered = [];
-    for (const hit of input.hits) {
-        const text = line(hit, Math.min(MAX_LINE_CHARS, input.maxChars - used - 1));
-        if (!text)
-            break;
-        lines.push(text);
-        rendered.push(hit);
-        used += text.length + 1;
-    }
-    if (rendered.length === 0)
-        return { text: '', rendered: [] };
-    if (more)
-        lines.push(more);
-    lines.push(close);
-    return { text: lines.join('\n'), rendered };
-}
-//# sourceMappingURL=experience-hints.js.map

package/dist/operator/experience-hints.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"experience-hints.js","sourceRoot":"","sources":["../../src/operator/experience-hints.ts"],"names":[],"mappings":"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"}

package/dist/operator/external-correlation.d.ts

@@ -1,94 +0,0 @@
-/**
- * Correlate native ledger rows with live external items - the join that has to exist
- * before any cross-store claim.
- *
- * The native ledger and the external board are separate stores with no shared key:
- * a row carries `source_channel` and `source_event_id`, never an external item id.
- * Left to itself a model joins on titles, which produces false, missed and ambiguous
- * matches and then reports them as fact. This module resolves the join the only way
- * that is deterministic - through recorded provenance - and labels everything it
- * cannot resolve so the caller can refuse to make a claim about it.
- *
- * `source_event_id` is NOT a foreign key. It is optional free-form text that a model
- * supplies on task_create, so every step validates rather than assumes: exact index
- * lookup, connector must match, external identifiers come from STRUCTURED metadata
- * (composite-id parsing only as a legacy fallback), and a disagreement between the
- * two is ambiguity, not a tie to break.
- *
- * H0b, the rule that costs the most when forgotten: an item missing from the live
- * snapshot proves NOTHING. The poller reads only open items and emits no tombstone,
- * so disappearance is archive, deletion, permission loss, a board move, or a partial
- * read - never evidence of completion. Absence resolves to `historical_only`, and no
- * outcome in this module ever means "done".
- */
-export type CorrelationOutcome = 'matched' | 'unmatched' | 'ambiguous' | 'historical_only' | 'not_applicable';
-export type CorrelationReason = 
-/** not_applicable */
-'no_source' | 'other_connector'
-/** unmatched */
- | 'no_provenance' | 'provenance_not_indexed' | 'provenance_connector_mismatch' | 'external_ref_unresolvable'
-/** ambiguous */
- | 'provenance_conflict' | 'multiple_rows_one_item'
-/** historical_only */
- | 'absent_from_live_snapshot' | 'live_snapshot_incomplete'
-/** matched */
- | 'live_item';
-export interface CorrelationLedgerRow {
-    id: number;
-    sourceChannel: string | null;
-    sourceEventId: string | null;
-}
-/** A connector_event_index row, reduced to what correlation needs. */
-export interface ProvenanceRecord {
-    sourceConnector: string;
-    /** Connector-written composite identity, e.g. `<boardId>:<itemId>:<observedMs>`. */
-    sourceId: string;
-    metadata: Record<string, unknown> | null;
-}
-export interface LiveExternalItem {
-    itemId: string;
-    board: string;
-    list: string;
-}
-export interface ExternalRef {
-    boardId: string;
-    itemId: string;
-}
-export interface CorrelationInput {
-    /** Connector whose items are being correlated, e.g. 'trello'. */
-    connector: string;
-    rows: readonly CorrelationLedgerRow[];
-    lookupProvenance: (eventIndexId: string) => ProvenanceRecord | null;
-    liveItems: readonly LiveExternalItem[];
-    /**
-     * Whether the live snapshot covered everything it claims to.
-     * When false, absence cannot even be called historical: a partial read is
-     * indistinguishable from a vanished item, so nothing resolves to matched-by-absence.
-     */
-    liveSnapshotComplete: boolean;
-}
-export interface TaskCorrelation {
-    taskId: number;
-    outcome: CorrelationOutcome;
-    reason: CorrelationReason;
-    externalRef: ExternalRef | null;
-    /** Present only for `matched`: the item's CURRENT position on the live board. */
-    live: {
-        board: string;
-        list: string;
-    } | null;
-}
-export type CorrelationCoverage = Record<CorrelationOutcome, number> & {
-    total: number;
-};
-export interface CorrelationResult {
-    correlations: TaskCorrelation[];
-    coverage: CorrelationCoverage;
-}
-/**
- * Resolve every row, then demote collisions: when several rows resolve to ONE external
- * item, no row among them can carry a factual claim about it, because which row the
- * item's state belongs to is exactly what is unknown.
- */
-export declare function correlateTasksWithExternalItems(input: CorrelationInput): CorrelationResult;
-//# sourceMappingURL=external-correlation.d.ts.map

package/dist/operator/external-correlation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"external-correlation.d.ts","sourceRoot":"","sources":["../../src/operator/external-correlation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GACT,WAAW,GACX,WAAW,GACX,iBAAiB,GACjB,gBAAgB,CAAC;AAErB,MAAM,MAAM,iBAAiB;AAC3B,qBAAqB;AACnB,WAAW,GACX,iBAAiB;AACnB,gBAAgB;GACd,eAAe,GACf,wBAAwB,GACxB,+BAA+B,GAC/B,2BAA2B;AAC7B,gBAAgB;GACd,qBAAqB,GACrB,wBAAwB;AAC1B,sBAAsB;GACpB,2BAA2B,GAC3B,0BAA0B;AAC5B,cAAc;GACZ,WAAW,CAAC;AAEhB,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,oFAAoF;IACpF,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACtC,gBAAgB,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,gBAAgB,GAAG,IAAI,CAAC;IACpE,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACvC;;;;OAIG;IACH,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,iFAAiF;IACjF,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC9C;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzF,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,QAAQ,EAAE,mBAAmB,CAAC;CAC/B;AA8HD;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,gBAAgB,GAAG,iBAAiB,CAyC1F"}