@jungjaehoon/mama-os 0.51.2 → 0.52.0

package/dist/operator/board-slot-instructions.js

@@ -14,7 +14,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BOARD_SLOT_ORDER = void 0;
 exports.buildBoardHtmlVocabulary = buildBoardHtmlVocabulary;
+exports.buildBoardSlotShapeLines = buildBoardSlotShapeLines;
+exports.buildReportPublishToolContract = buildReportPublishToolContract;
 exports.buildBoardPublishLines = buildBoardPublishLines;
+exports.boardHtmlClassVocabulary = boardHtmlClassVocabulary;
+exports.boardStructuralClasses = boardStructuralClasses;
+exports.htmlUsesBoardVocabulary = htmlUsesBoardVocabulary;
 exports.BOARD_SLOT_ORDER = ['briefing', 'action_required', 'decisions', 'pipeline'];
 /** The exact HTML shapes the board stylesheet understands. */
 function buildBoardHtmlVocabulary() {
@@ -32,23 +37,122 @@ function buildBoardHtmlVocabulary() {
         '- Temporal badges are separate facts: badge-danger (overdue), badge-warning (due today),',
         '  badge-info (upcoming), badge-success (closed).',
         '- Pipeline table: <table class="report-table"><thead><tr><th>...</th></tr></thead><tbody>rows</tbody></table>',
-        'No <script>, <iframe>, or event handlers: the board sanitizes them out and the CSP blocks them.',
+        'The board sanitizes script, iframe, object, embed, form, link, meta and base tags plus event',
+        'handlers out of every slot; inline styles fight the board stylesheet, so do not write them.',
     ];
 }
+/**
+ * Per-slot shape the board expects. Single source for the legacy persona's
+ * publish block and for the report_publish tool contract the standing owner
+ * runtime reads through tool_describe at publish time.
+ */
+function buildBoardSlotShapeLines() {
+    return [
+        '- pipeline: rendered by the host from the task ledger and already published. Never write it.',
+        '- briefing: one report-summary block (title + stat highlights), then up to 4 report-cards for the key situations.',
+        '- action_required: a report-section-title, then up to 5 report-cards; every card-action states the concrete next step.',
+        '- decisions: report-cards for items waiting on an owner decision or confirmation; omit filler when none exist,',
+        '  but still publish the slot with a one-line quiet note.',
+    ];
+}
+/**
+ * The report_publish tool description. The board's class vocabulary belongs
+ * with the tool that publishes it, not in per-turn prompt text: an agent that
+ * describes report_publish before calling it learns the shape the board styles.
+ */
+function buildReportPublishToolContract() {
+    const inline = (lines) => lines.join(' ').replace(/\s+/g, ' ').trim();
+    return inline([
+        'Publish dashboard analysis as HTML.',
+        'pipeline is a managed live task projection; change tasks instead.',
+        'Supply the task basis actually used for analysis; omission means its basis is unknown.',
+        'SLOT SHAPE:',
+        ...buildBoardSlotShapeLines(),
+        ...buildBoardHtmlVocabulary(),
+        "Write slot CONTENT in the owner's language; keep each slot under 6KB.",
+        'A slot that contains none of report-summary / report-card / report-section-title / report-table',
+        'is still published, but the result reports it back as a',
+        'warning because the board renders it as plain text.',
+    ]);
+}
 /** Instruction block that makes a report run also publish the board slots. */
 function buildBoardPublishLines() {
     return [
         'BEFORE writing your text report, update the operator board: call the report_publish',
         'gateway tool EXACTLY once with the THREE judgment slots:',
         '  report_publish({ slots: { briefing: "<html>", action_required: "<html>", decisions: "<html>" } })',
-        '- pipeline: rendered by the host from the task ledger and already published. Never write it.',
-        '- briefing: one report-summary block (title + stat highlights), then up to 4 item cards for the key situations.',
-        '- action_required: a report-section-title, then up to 5 cards; every card-action states the concrete next step.',
-        '- decisions: cards for items waiting on an owner decision or confirmation; omit filler when none exist,',
-        '  but still publish the slot with a one-line quiet note.',
+        ...buildBoardSlotShapeLines(),
         ...buildBoardHtmlVocabulary(),
         "Write all slot CONTENT in the owner's language (match the channels); keep each slot under 6KB.",
         'The plain-text report you write afterwards is a separate output: no HTML in it.',
     ];
 }
+/**
+ * The STRUCTURAL block classes: the ones the board stylesheet needs in order to
+ * render a slot as a board block rather than plain text. Sub-element classes
+ * (card-header, card-title, card-badge, badge-*, tag-*, summary-*) only decorate
+ * a structural block, so they prove nothing on their own -- the live 19:59/20:06
+ * slots carried `card`/`card-grid`/`badge-info` and still rendered unstyled.
+ * Single source: `boardHtmlClassVocabulary().structural`.
+ */
+const BOARD_STRUCTURAL_CLASSES = [
+    'report-summary',
+    'report-section-title',
+    'report-card',
+    'report-table',
+];
+/**
+ * The class tokens the board stylesheet understands, derived from the SAME
+ * vocabulary text the agent is shown. There is no second copy of the list: if
+ * a class is added to buildBoardHtmlVocabulary() it becomes recognised here.
+ * `structural` marks the subset that makes a slot count as board HTML.
+ */
+function boardHtmlClassVocabulary() {
+    const classes = new Set();
+    for (const line of buildBoardHtmlVocabulary()) {
+        for (const match of line.matchAll(/class="([^"]*)"/g)) {
+            for (const token of match[1].split(/\s+/)) {
+                if (token)
+                    classes.add(token);
+            }
+        }
+        // badge-*/tag-* variants are enumerated in prose, not inside a class attribute.
+        for (const match of line.matchAll(/\b(?:badge|tag)-[a-z]+\b/g)) {
+            classes.add(match[0]);
+        }
+    }
+    // The structural names must actually appear in the vocabulary the agent is
+    // shown; a silent drift would make the predicate unreachable.
+    const structural = new Set();
+    for (const name of BOARD_STRUCTURAL_CLASSES) {
+        if (!classes.has(name)) {
+            throw new Error(`Board vocabulary text no longer contains structural class ${name}`);
+        }
+        structural.add(name);
+    }
+    return Object.assign(classes, { structural });
+}
+/** The structural block classes, in vocabulary order. */
+function boardStructuralClasses() {
+    return BOARD_STRUCTURAL_CLASSES;
+}
+/**
+ * True when slot HTML carries at least one STRUCTURAL board class token.
+ * Exact: only class attribute tokens count, never substrings of prose. A slot
+ * built out of sub-element classes alone (badge-*, tag-*, summary-*, card-*)
+ * does NOT pass -- the board renders it as plain text.
+ */
+function htmlUsesBoardVocabulary(html) {
+    if (typeof html !== 'string' || html.length === 0)
+        return false;
+    const { structural } = boardHtmlClassVocabulary();
+    for (const match of html.matchAll(/class\s*=\s*(?:"([^"]*)"|'([^']*)')/g)) {
+        const value = match[1] ?? match[2] ?? '';
+        for (const token of value.split(/\s+/)) {
+            if (token && structural.has(token))
+                return true;
+        }
+    }
+    return false;
+}
 //# sourceMappingURL=board-slot-instructions.js.map

package/dist/operator/board-slot-instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"board-slot-instructions.js","sourceRoot":"","sources":["../../src/operator/board-slot-instructions.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAKH,4DAiBC;AAGD,wDAcC;AArCY,QAAA,gBAAgB,GAAG,CAAC,UAAU,EAAE,iBAAiB,EAAE,WAAW,EAAE,UAAU,CAAU,CAAC;AAElG,8DAA8D;AAC9D,SAAgB,wBAAwB;IACtC,OAAO;QACL,qGAAqG;QACrG,sFAAsF;QACtF,oIAAoI;QACpI,oEAAoE;QACpE,oGAAoG;QACpG,6DAA6D;QAC7D,6EAA6E;QAC7E,6DAA6D;QAC7D,+FAA+F;QAC/F,yDAAyD;QACzD,0FAA0F;QAC1F,kDAAkD;QAClD,+GAA+G;QAC/G,iGAAiG;KAClG,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,SAAgB,sBAAsB;IACpC,OAAO;QACL,qFAAqF;QACrF,0DAA0D;QAC1D,qGAAqG;QACrG,8FAA8F;QAC9F,iHAAiH;QACjH,iHAAiH;QACjH,yGAAyG;QACzG,0DAA0D;QAC1D,GAAG,wBAAwB,EAAE;QAC7B,gGAAgG;QAChG,iFAAiF;KAClF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"board-slot-instructions.js","sourceRoot":"","sources":["../../src/operator/board-slot-instructions.ts"],"names":[],"mappings":"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"}

package/dist/operator/console-brief.d.ts

@@ -1,8 +1,12 @@
+import { hashProcedureDocument } from './procedure-projection.js';
 import { type PrivateConnectorPolicy } from '../connectors/private-connector-policy.js';
 /** Full-replace ceiling with headroom for a mature manual while preventing a
  * runaway self-edit from bloating every future prompt. */
 export declare const CONSOLE_BRIEF_MAX_CHARS = 32000;
-export declare const CONSOLE_BRIEF_DEFAULT = "# Owner Console Operating Brief\n\nThis file is YOURS. It is seeded once and never overwritten by upgrades.\nWhen the owner corrects how you work, or a procedure fails and you learn the\nfix, record it with console_brief_update({lesson}) - one durable lesson per\ncall, appended below with today's date while everything above is preserved.\nThis is how your operating manual grows; losing a lesson means repeating the\nfailure.\n\n## Reporting philosophy\n\n- A report is analysis, not a listing. Cross-check at least two sources\n  (board/tasks vs channel messages) before stating a situation.\n- Cite where each claim came from, with the source timestamp. An uncited\n  claim is a guess.\n- Quote the key channel line when it drives a conclusion; name the room and\n  sender exactly as the source shows them.\n- Lead with what changed and what needs the owner; keep the quiet parts to\n  one line.\n\n## Procedure recipes (grow this section from experience)\n\n- Status questions: artifacts first (board_read, audit_findings_read), then\n  live queries; memory recall last and cited.\n- Business data: use only tools present in the current run catalog. Start with\n  a broad summary, narrow to active entities or tasks, then inspect specific\n  channels without widening a supplied time window.\n- Cross-channel synthesis: anchor items on their task id (relatedTaskId)\n  so the same work seen in two rooms stays one item.\n\n## Situational awareness\n\n- Delta events name what changed since your last look; answer against the\n  delta first, then the wider window.\n- After a context gap (compaction, restart), rebuild from storage - recall\n  and artifacts - never from what you assume you remember.\n\n## Self-update rule\n\n- 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.\n\n## Lessons\n";
+export declare const CONSOLE_BRIEF_DEFAULT = "# Owner Console Operating Brief\n\nThis file is yours; upgrades never overwrite it. It holds standing operating rules only.\nHow you work is learned from the owner's corrections: store each one with procedure_update\n(when_to_use / when_not_to_use) in the turn it arrives. This brief is not a lesson log.\nCorrect one of its rules with console_brief_update (replace or retire an exact target with the\nexpected_hash from procedure_read({id:\"owner-console-brief\"})). Saving is not proof of changed behavior.\n";
+/** Upgrade only the known, code-owned legacy tool mechanism when rendering a modern runtime.
+ * The stored original and all owner business rules remain untouched. */
+export declare function modernizeLegacyBriefMechanism(raw: string): string;
 export declare function consoleBriefPath(homeDir?: string): string;
 /** Boot seeding - write the packaged default ONLY when missing (agent/user
  *  edits always win; deliberate no-auto-upgrade, mirroring ensureBriefs). */
@@ -11,17 +15,26 @@ export declare function ensureConsoleBrief(homeDir?: string): boolean;
 export declare function loadConsoleBrief(homeDir?: string): string;
 /** Project a user-owned brief for one prompt without modifying its file. */
 export declare function projectConsoleBriefForPrompt(raw: string, policy: PrivateConnectorPolicy): string;
-/**
- * Append one dated lesson for the agent's self-update tool. APPEND, never
- * replace: on the loop's first live fire (2026-07-24) the model answered a
- * full-replace contract with just its new lesson, wiping the seeded manual
- * including the self-update rule itself. Accretion is the mechanism Kagemusha
- * actually validated - the agent only ever adds; reorganizing the file is the
- * owner's (or an owner-directed session's) manual edit.
- *
- * Loud validation, no fallback: an empty lesson is refused, and a brief that
- * would exceed the ceiling is refused (the manual needs owner curation),
- * never truncated.
+export declare const hashConsoleBrief: typeof hashProcedureDocument;
+export declare function readConsoleBriefSnapshot(homeDir?: string): {
+    path: string;
+    text: string;
+    hash: string | null;
+};
+export interface ConsoleBriefUpdate {
+    operation: 'append' | 'replace' | 'retire';
+    lesson?: string;
+    target?: string;
+    replacement?: string;
+    expectedHash?: string;
+}
+/** Pure preparation: the canonical store commits this text and its old revision
+ * before attempting Markdown publication. No full-document replace operation.
  */
-export declare function appendConsoleBriefLesson(lesson: string, homeDir?: string): string;
+export declare function prepareConsoleBriefUpdate(input: ConsoleBriefUpdate, current: string): {
+    text: string;
+    priorHash: string;
+    hash: string;
+};
+/** Legacy append-only API, preserving its return value and seed-on-missing behavior. */
 //# sourceMappingURL=console-brief.d.ts.map

package/dist/operator/console-brief.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"console-brief.d.ts","sourceRoot":"","sources":["../../src/operator/console-brief.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAOxF;0DAC0D;AAC1D,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAU9C,eAAO,MAAM,qBAAqB,+8DA6CjC,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,MAAkB,GAAG,MAAM,CAEpE;AAED;6EAC6E;AAC7E,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,MAAkB,GAAG,OAAO,CAQvE;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,MAAkB,GAAG,MAAM,CAIpE;AAeD,4EAA4E;AAC5E,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAWhG;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,MAAkB,GAAG,MAAM,CA4B5F"}
+{"version":3,"file":"console-brief.d.ts","sourceRoot":"","sources":["../../src/operator/console-brief.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAOxF;0DAC0D;AAC1D,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAU9C,eAAO,MAAM,qBAAqB,mgBAOjC,CAAC;AAEF;wEACwE;AACxE,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmDjE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,MAAkB,GAAG,MAAM,CAEpE;AAED;6EAC6E;AAC7E,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,MAAkB,GAAG,OAAO,CAkBvE;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,MAAkB,GAAG,MAAM,CAIpE;AAeD,4EAA4E;AAC5E,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAWhG;AAED,eAAO,MAAM,gBAAgB,8BAAwB,CAAC;AAEtD,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,MAAkB,GAAG;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,CAIA;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,MAAM,GACd;IACD,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd,CA4FA;AAED,wFAAwF"}

package/dist/operator/console-brief.js

@@ -1,11 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONSOLE_BRIEF_DEFAULT = exports.CONSOLE_BRIEF_MAX_CHARS = void 0;
+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.appendConsoleBriefLesson = appendConsoleBriefLesson;
+exports.readConsoleBriefSnapshot = readConsoleBriefSnapshot;
+exports.prepareConsoleBriefUpdate = prepareConsoleBriefUpdate;
 /**
  * Owner-console operating brief - the agent-owned operations manual.
  *
@@ -26,6 +28,8 @@ exports.appendConsoleBriefLesson = appendConsoleBriefLesson;
  */
 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
@@ -40,50 +44,60 @@ const LEGACY_CONSOLE_PRIVATE_LINES = new Set([
 ]);
 exports.CONSOLE_BRIEF_DEFAULT = `# Owner Console Operating Brief
 
-This file is YOURS. It is seeded once and never overwritten by upgrades.
-When the owner corrects how you work, or a procedure fails and you learn the
-fix, record it with console_brief_update({lesson}) - one durable lesson per
-call, appended below with today's date while everything above is preserved.
-This is how your operating manual grows; losing a lesson means repeating the
-failure.
-
-## Reporting philosophy
-
-- A report is analysis, not a listing. Cross-check at least two sources
-  (board/tasks vs channel messages) before stating a situation.
-- Cite where each claim came from, with the source timestamp. An uncited
-  claim is a guess.
-- Quote the key channel line when it drives a conclusion; name the room and
-  sender exactly as the source shows them.
-- Lead with what changed and what needs the owner; keep the quiet parts to
-  one line.
-
-## Procedure recipes (grow this section from experience)
-
-- Status questions: artifacts first (board_read, audit_findings_read), then
-  live queries; memory recall last and cited.
-- Business data: use only tools present in the current run catalog. Start with
-  a broad summary, narrow to active entities or tasks, then inspect specific
-  channels without widening a supplied time window.
-- Cross-channel synthesis: anchor items on their task id (relatedTaskId)
-  so the same work seen in two rooms stays one item.
-
-## Situational awareness
-
-- Delta events name what changed since your last look; answer against the
-  delta first, then the wider window.
-- After a context gap (compaction, restart), rebuild from storage - recall
-  and artifacts - never from what you assume you remember.
-
-## Self-update rule
-
-- When the owner corrects your working style, or a recipe above proves
-  wrong, call console_brief_update({lesson}) in the same turn and say you
-  did. One concrete lesson per call; the file itself is curated by the
-  owner - you only ever add.
-
-## Lessons
+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');
 }
@@ -94,10 +108,22 @@ function ensureConsoleBrief(homeDir = (0, node_os_1.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}.tmp`;
-    (0, node_fs_1.writeFileSync)(tmpPath, exports.CONSOLE_BRIEF_DEFAULT, 'utf-8');
-    (0, node_fs_1.renameSync)(tmpPath, path);
-    return 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)()) {
@@ -128,43 +154,93 @@ function projectConsoleBriefForPrompt(raw, policy) {
     const separator = projected.endsWith('\n\n') ? '' : projected.endsWith('\n') ? '\n' : '\n\n';
     return `${projected}${separator}${overlay}\n`;
 }
-/**
- * Append one dated lesson for the agent's self-update tool. APPEND, never
- * replace: on the loop's first live fire (2026-07-24) the model answered a
- * full-replace contract with just its new lesson, wiping the seeded manual
- * including the self-update rule itself. Accretion is the mechanism Kagemusha
- * actually validated - the agent only ever adds; reorganizing the file is the
- * owner's (or an owner-directed session's) manual edit.
- *
- * Loud validation, no fallback: an empty lesson is refused, and a brief that
- * would exceed the ceiling is refused (the manual needs owner curation),
- * never truncated.
+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 appendConsoleBriefLesson(lesson, homeDir = (0, node_os_1.homedir)()) {
-    const trimmed = lesson.trim();
-    if (!trimmed) {
-        throw new Error('console brief update refused: empty lesson');
+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');
     }
-    // A brief absent at call time (deleted, first run) is re-seeded so the
-    // lesson lands inside the full manual, not alone in an empty file.
-    let existing = loadConsoleBrief(homeDir);
-    if (!existing.trim()) {
-        ensureConsoleBrief(homeDir);
-        existing = loadConsoleBrief(homeDir);
+    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');
     }
-    const date = new Date().toISOString().slice(0, 10);
-    const entry = `- ${date}: ${trimmed.replace(/\s*\n\s*/g, ' ')}`;
-    const base = existing.replace(/\s+$/, '');
-    const next = `${base}\n${base.includes('\n## Lessons') ? '' : '\n## Lessons\n'}${entry}\n`;
-    if (next.length > exports.CONSOLE_BRIEF_MAX_CHARS) {
-        throw new Error(`console brief update refused: ${next.length} chars exceeds ${exports.CONSOLE_BRIEF_MAX_CHARS} - ` +
-            'ask the owner to curate the brief before recording more lessons');
+    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);
     }
-    const path = consoleBriefPath(homeDir);
-    (0, node_fs_1.mkdirSync)((0, node_path_1.join)(homeDir, '.mama', 'briefs'), { recursive: true });
-    const tmpPath = `${path}.tmp`;
-    (0, node_fs_1.writeFileSync)(tmpPath, next, 'utf-8');
-    (0, node_fs_1.renameSync)(tmpPath, path);
-    return next;
+    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 +1 @@
-{"version":3,"file":"console-brief.js","sourceRoot":"","sources":["../../src/operator/console-brief.ts"],"names":[],"mappings":";;;AAuFA,4CAEC;AAID,gDAQC;AAGD,4CAIC;AAgBD,oEAWC;AAcD,4DA4BC;AAjLD;;;;;;;;;;;;;;;;;GAiBG;AACH,qCAAyF;AACzF,qCAAkC;AAClC,yCAAiC;AAEjC,uFAIiD;AAEjD;0DAC0D;AAC7C,QAAA,uBAAuB,GAAG,MAAM,CAAC;AAE9C,MAAM,4BAA4B,GAAG,IAAI,GAAG,CAAC;IAC3C,sEAAsE;IACtE,wEAAwE;IACxE,uEAAuE;IACvE,sCAAsC;IACtC,8BAA8B;CAC/B,CAAC,CAAC;AAEU,QAAA,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6CpC,CAAC;AAEF,SAAgB,gBAAgB,CAAC,UAAkB,IAAA,iBAAO,GAAE;IAC1D,OAAO,IAAA,gBAAI,EAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,wBAAwB,CAAC,CAAC;AACpE,CAAC;AAED;6EAC6E;AAC7E,SAAgB,kBAAkB,CAAC,UAAkB,IAAA,iBAAO,GAAE;IAC5D,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,IAAA,oBAAU,EAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,IAAA,mBAAS,EAAC,IAAA,gBAAI,EAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,GAAG,IAAI,MAAM,CAAC;IAC9B,IAAA,uBAAa,EAAC,OAAO,EAAE,6BAAqB,EAAE,OAAO,CAAC,CAAC;IACvD,IAAA,oBAAU,EAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC1B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+EAA+E;AAC/E,SAAgB,gBAAgB,CAAC,UAAkB,IAAA,iBAAO,GAAE;IAC1D,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC,IAAA,oBAAU,EAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,OAAO,IAAA,sBAAY,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,+BAA+B,CAAC,GAAW;IAClD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACzC,IAAI,CAAC,4BAA4B,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5C,SAAS,IAAI,IAAI,GAAG,SAAS,CAAC;QAChC,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,4EAA4E;AAC5E,SAAgB,4BAA4B,CAAC,GAAW,EAAE,MAA8B;IACtF,MAAM,OAAO,GAAG,IAAA,qDAAyB,EAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IACnE,MAAM,SAAS,GAAG,IAAA,6DAAiC,EACjD,+BAA+B,CAAC,IAAA,4DAAgC,EAAC,GAAG,CAAC,CAAC,EACtE,OAAO,CAAC,MAAM,GAAG,CAAC,CACnB,CAAC;IACF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;IAC7F,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,IAAI,CAAC;AAChD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,wBAAwB,CAAC,MAAc,EAAE,UAAkB,IAAA,iBAAO,GAAE;IAClF,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IACD,uEAAuE;IACvE,mEAAmE;IACnE,IAAI,QAAQ,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QACrB,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC5B,QAAQ,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,KAAK,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,CAAC;IAChE,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,GAAG,IAAI,KAAK,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,GAAG,KAAK,IAAI,CAAC;IAC3F,IAAI,IAAI,CAAC,MAAM,GAAG,+BAAuB,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,iCAAiC,IAAI,CAAC,MAAM,kBAAkB,+BAAuB,KAAK;YACxF,iEAAiE,CACpE,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACvC,IAAA,mBAAS,EAAC,IAAA,gBAAI,EAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,GAAG,IAAI,MAAM,CAAC;IAC9B,IAAA,uBAAa,EAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACtC,IAAA,oBAAU,EAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC1B,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"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

@@ -0,0 +1,18 @@
+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

@@ -0,0 +1 @@
+{"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"}