@jungjaehoon/mama-os 0.20.0 → 0.21.0

package/dist/operator/trigger-author.d.ts

@@ -0,0 +1,45 @@
+/**
+ * trigger-author - Task 3, the heart (G1 + G3).
+ *
+ * The agent recognizes a recurring situation in a window of polled events and AUTHORS a
+ * trigger (its match keywords, memoryQuery, procedure, requiredEvidence). This replaces both
+ * Kagemusha's hardcoded regex markers (G1) and its 4-profile executable catalog (G3).
+ *
+ * The agent is injected (`AskAgent`) so the flow is deterministic + unit-testable; the real
+ * claude-CLI agent is `askAgentCLI`, exercised by the LLM eval.
+ *
+ * G3 GUARD: validation is STRUCTURAL only. `kind` and `procedure[].action` are open strings;
+ * unknown VALUES are accepted. Never narrow them to a fixed enum - that re-freezes G3.
+ */
+import type { OperatorChannelEvent } from './operator-interfaces.js';
+import type { TriggerRecord } from './trigger-types.js';
+import type { TriggerRegistry } from './trigger-registry.js';
+/** Injected agent: prompt in, raw text answer out. */
+export type AskAgent = (prompt: string) => Promise<string>;
+/** What the agent returns (a CreateTriggerInput minus server-managed fields). */
+export interface TriggerSpec {
+    id?: string;
+    kind: string;
+    memoryQuery: string;
+    match: {
+        keywords: string[];
+        keywordMode: 'any' | 'every';
+        scopeChannelIds?: string[];
+        minConfidence: number;
+    };
+    procedure: {
+        action: string;
+        description: string;
+    }[];
+    requiredEvidence: string[];
+}
+export interface AuthorOptions {
+    note?: string;
+}
+export declare function authorTriggers(events: OperatorChannelEvent[], registry: TriggerRegistry, askAgent: AskAgent, opts?: AuthorOptions): Promise<TriggerRecord[]>;
+export declare function buildAuthorPrompt(events: OperatorChannelEvent[], existing: TriggerRecord[]): string;
+export declare function parseTriggerSpecs(text: string): TriggerSpec[];
+export declare function validateTriggerSpec(spec: unknown): TriggerSpec;
+/** Real agent: the local claude CLI (CLI-over-API). Used by the LLM eval, not unit tests. */
+export declare const askAgentCLI: AskAgent;
+//# sourceMappingURL=trigger-author.d.ts.map

package/dist/operator/trigger-author.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-author.d.ts","sourceRoot":"","sources":["../../src/operator/trigger-author.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAsB,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAI7D,sDAAsD;AACtD,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE3D,iFAAiF;AACjF,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,EAAE,KAAK,GAAG,OAAO,CAAC;QAC7B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,SAAS,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrD,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,oBAAoB,EAAE,EAC9B,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,QAAQ,EAClB,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,aAAa,EAAE,CAAC,CA6B1B;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,oBAAoB,EAAE,EAC9B,QAAQ,EAAE,aAAa,EAAE,GACxB,MAAM,CAsCR;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAW7D;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,CA2D9D;AAED,6FAA6F;AAC7F,eAAO,MAAM,WAAW,EAAE,QAOzB,CAAC"}

package/dist/operator/trigger-author.js

@@ -0,0 +1,217 @@
+"use strict";
+/**
+ * trigger-author - Task 3, the heart (G1 + G3).
+ *
+ * The agent recognizes a recurring situation in a window of polled events and AUTHORS a
+ * trigger (its match keywords, memoryQuery, procedure, requiredEvidence). This replaces both
+ * Kagemusha's hardcoded regex markers (G1) and its 4-profile executable catalog (G3).
+ *
+ * The agent is injected (`AskAgent`) so the flow is deterministic + unit-testable; the real
+ * claude-CLI agent is `askAgentCLI`, exercised by the LLM eval.
+ *
+ * G3 GUARD: validation is STRUCTURAL only. `kind` and `procedure[].action` are open strings;
+ * unknown VALUES are accepted. Never narrow them to a fixed enum - that re-freezes G3.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askAgentCLI = void 0;
+exports.authorTriggers = authorTriggers;
+exports.buildAuthorPrompt = buildAuthorPrompt;
+exports.parseTriggerSpecs = parseTriggerSpecs;
+exports.validateTriggerSpec = validateTriggerSpec;
+const node_crypto_1 = require("node:crypto");
+const node_child_process_1 = require("node:child_process");
+const node_util_1 = require("node:util");
+const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
+async function authorTriggers(events, registry, askAgent, opts = {}) {
+    const existing = registry.listActive();
+    const prompt = buildAuthorPrompt(events, existing);
+    const answer = await askAgent(prompt);
+    const specs = parseTriggerSpecs(answer); // throws on unparseable output (no-fallback)
+    const created = [];
+    const seen = existing.map((t) => ({
+        keywords: t.match.keywords,
+        scopeChannelIds: t.match.scopeChannelIds,
+    }));
+    for (const spec of specs) {
+        if (isDuplicate(spec, seen))
+            continue;
+        const id = spec.id ?? deriveId(spec);
+        if (registry.getById(id))
+            continue;
+        const input = {
+            id,
+            kind: spec.kind,
+            memoryQuery: spec.memoryQuery,
+            match: spec.match,
+            procedure: spec.procedure,
+            requiredEvidence: spec.requiredEvidence,
+            authoredBy: 'agent',
+            provenance: { createdFrom: 'agent-authored', note: opts.note ?? '' },
+        };
+        created.push(registry.create(input));
+        seen.push({ keywords: spec.match.keywords, scopeChannelIds: spec.match.scopeChannelIds });
+    }
+    return created;
+}
+function buildAuthorPrompt(events, existing) {
+    // English default. Personal phrasing overrides load from ~/.mama/operator/*.json (later refinement).
+    const window = events.map((e) => `- [${e.channelId}] ${e.content}`).join('\n');
+    const existingList = existing.length === 0
+        ? '(none yet)'
+        : existing
+            .map((t) => `- ${t.id}: keywords=[${t.match.keywords.join(', ')}] memoryQuery="${t.memoryQuery}"`)
+            .join('\n');
+    return [
+        "You maintain a personal operator's library of TRIGGERS. A trigger fires on future messages",
+        'that match its keywords and then recalls a memory to help the operator intervene proactively.',
+        '',
+        'Look at the recent messages below. Propose new triggers ONLY for situations that genuinely',
+        'RECUR (appear repeatedly, possibly phrased differently). Do NOT create triggers for one-off',
+        'messages. If nothing recurs, return an empty array.',
+        '',
+        'Recent messages:',
+        window,
+        '',
+        'Existing triggers (do not duplicate these):',
+        existingList,
+        '',
+        'A situation already covered by an existing trigger -- even with different wording or a',
+        'partial keyword overlap -- does NOT need a new trigger. Near-variants make several',
+        'triggers fire on the same message, which wastes recall and dilutes the report. Prefer',
+        'proposing NOTHING over proposing a variant of an existing trigger.',
+        '',
+        'Return ONLY a JSON array (no prose) of trigger objects with this shape:',
+        '[{ "kind": string, "memoryQuery": string,',
+        '   "match": { "keywords": string[], "keywordMode": "any"|"every", "minConfidence": number },',
+        '   "procedure": [{ "action": string, "description": string }],',
+        '   "requiredEvidence": string[] }]',
+        'kind and action are free text you choose - describe the situation and steps in your own words.',
+    ].join('\n');
+}
+function parseTriggerSpecs(text) {
+    const arr = extractJsonArray(stripCodeFences(text));
+    if (arr === null)
+        throw new Error('agent output contained no JSON array of trigger specs');
+    let parsed;
+    try {
+        parsed = JSON.parse(arr);
+    }
+    catch (error) {
+        throw new Error(`agent trigger JSON did not parse: ${error.message}`);
+    }
+    if (!Array.isArray(parsed))
+        throw new Error('agent trigger JSON was not an array');
+    return parsed.map(validateTriggerSpec);
+}
+function validateTriggerSpec(spec) {
+    if (!isObject(spec))
+        throw new Error('trigger spec must be an object');
+    const nonEmptyString = (v) => typeof v === 'string' && v.trim() !== '';
+    if (!nonEmptyString(spec.kind))
+        throw new Error('trigger.kind must be a non-empty string');
+    if (!nonEmptyString(spec.memoryQuery))
+        throw new Error('trigger.memoryQuery must be a non-empty string');
+    if (!isObject(spec.match))
+        throw new Error('trigger.match must be an object');
+    const match = spec.match;
+    if (!Array.isArray(match.keywords) ||
+        match.keywords.length === 0 ||
+        !match.keywords.every(nonEmptyString)) {
+        throw new Error('trigger.match.keywords must be a non-empty string[]');
+    }
+    if (match.keywordMode !== 'any' && match.keywordMode !== 'every') {
+        throw new Error("trigger.match.keywordMode must be 'any' or 'every'");
+    }
+    if (typeof match.minConfidence !== 'number')
+        throw new Error('trigger.match.minConfidence must be a number');
+    if (match.scopeChannelIds !== undefined &&
+        (!Array.isArray(match.scopeChannelIds) ||
+            !match.scopeChannelIds.every((c) => typeof c === 'string'))) {
+        throw new Error('trigger.match.scopeChannelIds must be string[] when present');
+    }
+    if (!Array.isArray(spec.procedure) ||
+        !spec.procedure.every((p) => isObject(p) && typeof p.action === 'string' && typeof p.description === 'string')) {
+        throw new Error('trigger.procedure must be an array of {action, description}');
+    }
+    if (!Array.isArray(spec.requiredEvidence) ||
+        !spec.requiredEvidence.every((e) => typeof e === 'string')) {
+        throw new Error('trigger.requiredEvidence must be string[]');
+    }
+    // Deliberately NO check of kind/action VALUES against any catalog (G3 guard).
+    return {
+        id: typeof spec.id === 'string' ? spec.id : undefined,
+        kind: spec.kind,
+        memoryQuery: spec.memoryQuery,
+        match: {
+            keywords: match.keywords,
+            keywordMode: match.keywordMode,
+            minConfidence: match.minConfidence,
+            scopeChannelIds: match.scopeChannelIds,
+        },
+        procedure: spec.procedure,
+        requiredEvidence: spec.requiredEvidence,
+    };
+}
+/** Real agent: the local claude CLI (CLI-over-API). Used by the LLM eval, not unit tests. */
+const askAgentCLI = async (prompt) => {
+    const { stdout } = await execFileAsync('claude', ['-p', prompt, '--output-format', 'json'], {
+        maxBuffer: 16 * 1024 * 1024,
+    });
+    const parsed = JSON.parse(stdout);
+    if (parsed.type === 'result' && typeof parsed.result === 'string')
+        return parsed.result;
+    throw new Error('claude CLI did not return a text result');
+};
+exports.askAgentCLI = askAgentCLI;
+// ---- helpers ----
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function stripCodeFences(text) {
+    return text.replace(/```(?:json)?/gi, '');
+}
+function extractJsonArray(text) {
+    const start = text.indexOf('[');
+    const end = text.lastIndexOf(']');
+    if (start === -1 || end === -1 || end < start)
+        return null;
+    return text.slice(start, end + 1);
+}
+function normalizedKeywordSet(keywords) {
+    return [...new Set(keywords.map((k) => k.trim().toLocaleLowerCase()))].sort().join('|');
+}
+/**
+ * Near-duplicate gate. Exact keyword-set equality alone let near-variants pile
+ * up: day-1 live data showed 65% of fires were co-fires of overlapping triggers
+ * on the same message. Within the same scope, a spec is a duplicate when its
+ * keyword set is a subset/superset of an existing trigger's, or the Jaccard
+ * overlap is >= 0.6. This is authoring HYGIENE (like the exact check before
+ * it), not outcome judgment -- keep/retire decisions stay with the agent (G2).
+ */
+function isDuplicate(spec, seen) {
+    const specKeys = new Set(spec.match.keywords.map((k) => k.trim().toLowerCase()).filter(Boolean));
+    const specScope = (spec.match.scopeChannelIds ?? []).slice().sort().join(',');
+    return seen.some((s) => {
+        if ((s.scopeChannelIds ?? []).slice().sort().join(',') !== specScope)
+            return false;
+        const seenKeys = new Set(s.keywords.map((k) => k.trim().toLowerCase()).filter(Boolean));
+        if (specKeys.size === 0 || seenKeys.size === 0)
+            return false;
+        let shared = 0;
+        for (const k of specKeys)
+            if (seenKeys.has(k))
+                shared += 1;
+        if (shared === specKeys.size || shared === seenKeys.size)
+            return true; // subset either way
+        const jaccard = shared / (specKeys.size + seenKeys.size - shared);
+        return jaccard >= 0.6;
+    });
+}
+function deriveId(spec) {
+    const hash = (0, node_crypto_1.createHash)('sha256')
+        .update(`${spec.kind}\n${normalizedKeywordSet(spec.match.keywords)}`)
+        .digest('hex')
+        .slice(0, 12);
+    return `trigger.${hash}`;
+}
+//# sourceMappingURL=trigger-author.js.map

package/dist/operator/trigger-author.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-author.js","sourceRoot":"","sources":["../../src/operator/trigger-author.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAiCH,wCAkCC;AAED,8CAyCC;AAED,8CAWC;AAED,kDA2DC;AAtLD,6CAAyC;AACzC,2DAA8C;AAC9C,yCAAsC;AAKtC,MAAM,aAAa,GAAG,IAAA,qBAAS,EAAC,6BAAQ,CAAC,CAAC;AAwBnC,KAAK,UAAU,cAAc,CAClC,MAA8B,EAC9B,QAAyB,EACzB,QAAkB,EAClB,OAAsB,EAAE;IAExB,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,6CAA6C;IAEtF,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ;QAC1B,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe;KACzC,CAAC,CAAC,CAAC;IACJ,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC;YAAE,SAAS;QACtC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAAE,SAAS;QACnC,MAAM,KAAK,GAAuB;YAChC,EAAE;YACF,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,UAAU,EAAE,OAAO;YACnB,UAAU,EAAE,EAAE,WAAW,EAAE,gBAAgB,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE;SACrE,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAgB,iBAAiB,CAC/B,MAA8B,EAC9B,QAAyB;IAEzB,qGAAqG;IACrG,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/E,MAAM,YAAY,GAChB,QAAQ,CAAC,MAAM,KAAK,CAAC;QACnB,CAAC,CAAC,YAAY;QACd,CAAC,CAAC,QAAQ;aACL,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,WAAW,GAAG,CACxF;aACA,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,OAAO;QACL,4FAA4F;QAC5F,+FAA+F;QAC/F,EAAE;QACF,4FAA4F;QAC5F,6FAA6F;QAC7F,qDAAqD;QACrD,EAAE;QACF,kBAAkB;QAClB,MAAM;QACN,EAAE;QACF,6CAA6C;QAC7C,YAAY;QACZ,EAAE;QACF,wFAAwF;QACxF,oFAAoF;QACpF,uFAAuF;QACvF,oEAAoE;QACpE,EAAE;QACF,yEAAyE;QACzE,2CAA2C;QAC3C,8FAA8F;QAC9F,gEAAgE;QAChE,oCAAoC;QACpC,gGAAgG;KACjG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAgB,iBAAiB,CAAC,IAAY;IAC5C,MAAM,GAAG,GAAG,gBAAgB,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,IAAI,GAAG,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3F,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,qCAAsC,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;IACnF,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACnF,OAAO,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AACzC,CAAC;AAED,SAAgB,mBAAmB,CAAC,IAAa;IAC/C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACvE,MAAM,cAAc,GAAG,CAAC,CAAU,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IAE7F,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC3F,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IAEpE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAC9E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACzB,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC9B,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAC3B,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,EACrC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,KAAK,KAAK,IAAI,KAAK,CAAC,WAAW,KAAK,OAAO,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,aAAa,KAAK,QAAQ;QACzC,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,IACE,KAAK,CAAC,eAAe,KAAK,SAAS;QACnC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC;YACpC,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,EAC7D,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IAED,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;QAC9B,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CACnB,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,CACxF,EACD,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IACD,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC;QACrC,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,EAC1D,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED,8EAA8E;IAC9E,OAAO;QACL,EAAE,EAAE,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;QACrD,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,KAAK,EAAE;YACL,QAAQ,EAAE,KAAK,CAAC,QAAoB;YACpC,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,eAAe,EAAE,KAAK,CAAC,eAAuC;SAC/D;QACD,SAAS,EAAE,IAAI,CAAC,SAAsD;QACtE,gBAAgB,EAAE,IAAI,CAAC,gBAA4B;KACpD,CAAC;AACJ,CAAC;AAED,6FAA6F;AACtF,MAAM,WAAW,GAAa,KAAK,EAAE,MAAM,EAAE,EAAE;IACpD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE;QAC1F,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;KAC5B,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAwC,CAAC;IACzE,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC;IACxF,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;AAC7D,CAAC,CAAC;AAPW,QAAA,WAAW,eAOtB;AAEF,oBAAoB;AAEpB,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,GAAG,GAAG,KAAK;QAAE,OAAO,IAAI,CAAC;IAC3D,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,oBAAoB,CAAC,QAAkB;IAC9C,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1F,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,WAAW,CAClB,IAAiB,EACjB,IAA0D;IAE1D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACjG,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9E,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;QACrB,IAAI,CAAC,CAAC,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACnF,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACxF,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAC7D,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,KAAK,MAAM,CAAC,IAAI,QAAQ;YAAE,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,MAAM,IAAI,CAAC,CAAC;QAC3D,IAAI,MAAM,KAAK,QAAQ,CAAC,IAAI,IAAI,MAAM,KAAK,QAAQ,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC,CAAC,oBAAoB;QAC3F,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC;QAClE,OAAO,OAAO,IAAI,GAAG,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,QAAQ,CAAC,IAAiB;IACjC,MAAM,IAAI,GAAG,IAAA,wBAAU,EAAC,QAAQ,CAAC;SAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,KAAK,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;SACpE,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,OAAO,WAAW,IAAI,EAAE,CAAC;AAC3B,CAAC"}

package/dist/operator/trigger-evolve.d.ts

@@ -0,0 +1,31 @@
+/**
+ * evolveTrigger - Task 4, G2 (the learning Kagemusha deferred forever).
+ *
+ * An intervention outcome (succeeded / failed / corrected) is fed to the trigger's stats,
+ * then the AGENT decides whether to keep, refine, or retire the trigger. The decision is
+ * INJECTED (`decide`) - the real one is an LLM call. There is deliberately NO numeric
+ * threshold in this module: a fixed `if (failed >= N) disable()` would be exactly the
+ * automation trap that re-freezes G2. The same stats can be kept or retired by judgment.
+ */
+import type { TriggerRegistry } from './trigger-registry.js';
+import type { TriggerRecord } from './trigger-types.js';
+import type { TriggerSpec } from './trigger-author.js';
+export type EvolutionOutcome = 'succeeded' | 'failed' | 'corrected';
+export type EvolutionAction = 'kept' | 'refined' | 'retired';
+export type EvolutionDecision = {
+    action: 'kept';
+} | {
+    action: 'retired';
+    reason: string;
+} | {
+    action: 'refined';
+    reason: string;
+    newSpec: TriggerSpec;
+};
+export type DecideEvolution = (ctx: {
+    trigger: TriggerRecord;
+    outcome: EvolutionOutcome;
+    detail: string;
+}) => Promise<EvolutionDecision>;
+export declare function evolveTrigger(triggerId: string, outcome: EvolutionOutcome, detail: string, registry: TriggerRegistry, decide: DecideEvolution): Promise<EvolutionAction>;
+//# sourceMappingURL=trigger-evolve.d.ts.map

package/dist/operator/trigger-evolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-evolve.d.ts","sourceRoot":"","sources":["../../src/operator/trigger-evolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAsB,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AACpE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7D,MAAM,MAAM,iBAAiB,GACzB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC;AAEhE,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE;IAClC,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEjC,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,eAAe,CAAC,CAkC1B"}

package/dist/operator/trigger-evolve.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * evolveTrigger - Task 4, G2 (the learning Kagemusha deferred forever).
+ *
+ * An intervention outcome (succeeded / failed / corrected) is fed to the trigger's stats,
+ * then the AGENT decides whether to keep, refine, or retire the trigger. The decision is
+ * INJECTED (`decide`) - the real one is an LLM call. There is deliberately NO numeric
+ * threshold in this module: a fixed `if (failed >= N) disable()` would be exactly the
+ * automation trap that re-freezes G2. The same stats can be kept or retired by judgment.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evolveTrigger = evolveTrigger;
+const node_crypto_1 = require("node:crypto");
+async function evolveTrigger(triggerId, outcome, detail, registry, decide) {
+    // Feed the outcome into the stats (the G2 signal). 'corrected' counts as the current form failing.
+    registry.recordOutcome(triggerId, outcome === 'succeeded' ? 'succeeded' : 'failed');
+    const trigger = registry.getById(triggerId);
+    if (!trigger)
+        throw new Error(`evolveTrigger: no trigger with id ${triggerId}`);
+    // Keep / refine / retire is the AGENT's judgment (injected). No threshold constant here (G2 guard).
+    const decision = await decide({ trigger, outcome, detail });
+    if (decision.action === 'retired') {
+        registry.disable(triggerId, decision.reason);
+        return 'retired';
+    }
+    if (decision.action === 'refined') {
+        registry.disable(triggerId, `refined: ${decision.reason}`);
+        const spec = decision.newSpec;
+        const id = spec.id ?? `${triggerId}.r.${refineHash(spec)}`;
+        const input = {
+            id,
+            kind: spec.kind,
+            memoryQuery: spec.memoryQuery,
+            match: spec.match,
+            procedure: spec.procedure,
+            requiredEvidence: spec.requiredEvidence,
+            authoredBy: 'agent',
+            provenance: { createdFrom: `refined-from:${triggerId}`, note: decision.reason },
+        };
+        registry.create(input);
+        return 'refined';
+    }
+    return 'kept';
+}
+function refineHash(spec) {
+    return (0, node_crypto_1.createHash)('sha256')
+        .update(`${spec.kind}\n${spec.match.keywords.join('|')}`)
+        .digest('hex')
+        .slice(0, 8);
+}
+//# sourceMappingURL=trigger-evolve.js.map

package/dist/operator/trigger-evolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-evolve.js","sourceRoot":"","sources":["../../src/operator/trigger-evolve.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAqBH,sCAwCC;AA3DD,6CAAyC;AAmBlC,KAAK,UAAU,aAAa,CACjC,SAAiB,EACjB,OAAyB,EACzB,MAAc,EACd,QAAyB,EACzB,MAAuB;IAEvB,mGAAmG;IACnG,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAEpF,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,SAAS,EAAE,CAAC,CAAC;IAEhF,oGAAoG;IACpG,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAE5D,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC7C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,YAAY,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3D,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC;QAC9B,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,MAAM,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3D,MAAM,KAAK,GAAuB;YAChC,EAAE;YACF,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,UAAU,EAAE,OAAO;YACnB,UAAU,EAAE,EAAE,WAAW,EAAE,gBAAgB,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE;SAChF,CAAC;QACF,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,UAAU,CAAC,IAAiB;IACnC,OAAO,IAAA,wBAAU,EAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;SACxD,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACjB,CAAC"}

package/dist/operator/trigger-fire.d.ts

@@ -0,0 +1,29 @@
+/**
+ * fireTrigger - the proactive intervention: a fired TriggerSignal recalls its
+ * agent-authored memoryQuery (mama-core) and gathers requiredEvidence, then surfaces
+ * both to the agent. Read-only and self-activating (G4): no human gate, no outward send.
+ *
+ * This is "memory triggered like a skill" - the agent's memoryQuery decides what is
+ * recalled; the recall itself is a mechanical system assist.
+ */
+import type { OperatorMemoryPort } from './operator-interfaces.js';
+import type { TriggerSignal } from './trigger-types.js';
+/** Resolver for a requiredEvidence key the operator can supply (channel_history, task_state, ...). */
+export type EvidenceProvider = () => Promise<unknown>;
+export interface FireResult {
+    recalled: {
+        topic: string;
+        content: string;
+    }[];
+    evidence: Record<string, unknown>;
+}
+export interface FireOptions {
+    limit?: number;
+    /** Observability hook - every fire is surfaced here (log + alarm at integration). */
+    onFire?: (info: {
+        signal: TriggerSignal;
+        result: FireResult;
+    }) => void;
+}
+export declare function fireTrigger(signal: TriggerSignal, memory: OperatorMemoryPort, evidenceProviders?: Record<string, EvidenceProvider>, opts?: FireOptions): Promise<FireResult>;
+//# sourceMappingURL=trigger-fire.d.ts.map

package/dist/operator/trigger-fire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-fire.d.ts","sourceRoot":"","sources":["../../src/operator/trigger-fire.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,sGAAsG;AACtG,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,aAAa,CAAC;QAAC,MAAM,EAAE,UAAU,CAAA;KAAE,KAAK,IAAI,CAAC;CACxE;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,kBAAkB,EAC1B,iBAAiB,GAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAM,EACxD,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,UAAU,CAAC,CA6BrB"}

package/dist/operator/trigger-fire.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * fireTrigger - the proactive intervention: a fired TriggerSignal recalls its
+ * agent-authored memoryQuery (mama-core) and gathers requiredEvidence, then surfaces
+ * both to the agent. Read-only and self-activating (G4): no human gate, no outward send.
+ *
+ * This is "memory triggered like a skill" - the agent's memoryQuery decides what is
+ * recalled; the recall itself is a mechanical system assist.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fireTrigger = fireTrigger;
+async function fireTrigger(signal, memory, evidenceProviders = {}, opts = {}) {
+    const bundle = await memory.recall(signal.memoryQuery, { limit: opts.limit ?? 5 });
+    const recalled = bundle.map((record) => ({ topic: record.topic, content: record.content }));
+    const evidence = {};
+    for (const key of signal.requiredEvidence) {
+        if (key === 'current_message') {
+            evidence[key] = signal.text;
+        }
+        else if (evidenceProviders[key]) {
+            // Component isolation (PR #119 review): evidence is auxiliary surface data - one
+            // throwing provider must not abort the whole tick (uncommitted deltas would re-fire
+            // every signal next tick). The failure is surfaced IN the evidence handed to the
+            // agent, never swallowed silently.
+            try {
+                evidence[key] = await evidenceProviders[key]();
+            }
+            catch (error) {
+                evidence[key] = `(evidence provider "${key}" failed: ${error instanceof Error ? error.message : String(error)})`;
+            }
+        }
+        else {
+            // Not available. Surface honestly as null rather than guessing (no-fallback).
+            evidence[key] = null;
+        }
+    }
+    const result = { recalled, evidence };
+    opts.onFire?.({ signal, result });
+    return result;
+}
+//# sourceMappingURL=trigger-fire.js.map

package/dist/operator/trigger-fire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-fire.js","sourceRoot":"","sources":["../../src/operator/trigger-fire.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAmBH,kCAkCC;AAlCM,KAAK,UAAU,WAAW,CAC/B,MAAqB,EACrB,MAA0B,EAC1B,oBAAsD,EAAE,EACxD,OAAoB,EAAE;IAEtB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC;IACnF,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAE5F,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAC7C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC1C,IAAI,GAAG,KAAK,iBAAiB,EAAE,CAAC;YAC9B,QAAQ,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;QAC9B,CAAC;aAAM,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;YAClC,iFAAiF;YACjF,oFAAoF;YACpF,iFAAiF;YACjF,mCAAmC;YACnC,IAAI,CAAC;gBACH,QAAQ,CAAC,GAAG,CAAC,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;YACjD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,QAAQ,CAAC,GAAG,CAAC,GAAG,uBAAuB,GAAG,aACxC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,GAAG,CAAC;YACN,CAAC;QACH,CAAC;aAAM,CAAC;YACN,8EAA8E;YAC9E,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QACvB,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IAClD,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAClC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/operator/trigger-matcher.d.ts

@@ -0,0 +1,19 @@
+/**
+ * matchTriggers - registry-driven trigger matching (system-assist).
+ *
+ * Ports Kagemusha `workflowMatchesMessage`
+ * (~/project/mama-suite/apps/kagemusha/src/agent/contracts/workflow-situation-detector.ts:42):
+ * keyword any/every + scope filter. Deliberately DROPS two things:
+ *   - the `approvedAt`/`approvedBy` human-approval gate (`:43`) -> triggers self-activate (G4).
+ *   - the per-kind special-case (`:46` feedback_artifact_followup + hasConcreteFeedbackArtifactSignal)
+ *     -> that is a hardcoded marker (G1) and carries chatwork:/slack: PII. This matcher has
+ *     ZERO per-kind branches; a trigger matches purely on its agent-authored keywords + scope.
+ *
+ * The keywords were authored by the agent (trigger-author.ts); mechanically checking them
+ * is a legitimate system assist, not judgment.
+ */
+import type { OperatorChannelEvent } from './operator-interfaces.js';
+import type { TriggerSignal } from './trigger-types.js';
+import type { TriggerRegistry } from './trigger-registry.js';
+export declare function matchTriggers(event: OperatorChannelEvent, registry: TriggerRegistry): TriggerSignal[];
+//# sourceMappingURL=trigger-matcher.d.ts.map

package/dist/operator/trigger-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-matcher.d.ts","sourceRoot":"","sources":["../../src/operator/trigger-matcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,wBAAgB,aAAa,CAAC,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,eAAe,GAAG,aAAa,EAAE,CAerG"}

package/dist/operator/trigger-matcher.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * matchTriggers - registry-driven trigger matching (system-assist).
+ *
+ * Ports Kagemusha `workflowMatchesMessage`
+ * (~/project/mama-suite/apps/kagemusha/src/agent/contracts/workflow-situation-detector.ts:42):
+ * keyword any/every + scope filter. Deliberately DROPS two things:
+ *   - the `approvedAt`/`approvedBy` human-approval gate (`:43`) -> triggers self-activate (G4).
+ *   - the per-kind special-case (`:46` feedback_artifact_followup + hasConcreteFeedbackArtifactSignal)
+ *     -> that is a hardcoded marker (G1) and carries chatwork:/slack: PII. This matcher has
+ *     ZERO per-kind branches; a trigger matches purely on its agent-authored keywords + scope.
+ *
+ * The keywords were authored by the agent (trigger-author.ts); mechanically checking them
+ * is a legitimate system assist, not judgment.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchTriggers = matchTriggers;
+function matchTriggers(event, registry) {
+    // The operator reacts to incoming messages, not its own output (ports detector role check,
+    // workflow-situation-detector.ts:13).
+    if (event.role !== 'user')
+        return [];
+    const text = event.content.trim();
+    if (!text)
+        return [];
+    const signals = [];
+    for (const trigger of registry.listActive()) {
+        if (triggerMatchesEvent(trigger, event, text)) {
+            signals.push(buildSignal(trigger, event, text));
+        }
+    }
+    return signals;
+}
+function triggerMatchesEvent(trigger, event, text) {
+    const { keywords, keywordMode, scopeChannelIds } = trigger.match;
+    if (scopeChannelIds && scopeChannelIds.length > 0 && !scopeChannelIds.includes(event.channelId)) {
+        return false;
+    }
+    const cleaned = keywords.map((keyword) => keyword.trim()).filter(Boolean);
+    if (cleaned.length === 0)
+        return false;
+    const normalized = text.toLocaleLowerCase();
+    const hit = (keyword) => normalized.includes(keyword.toLocaleLowerCase());
+    return keywordMode === 'any' ? cleaned.some(hit) : cleaned.every(hit);
+}
+function buildSignal(trigger, event, text) {
+    return {
+        kind: trigger.kind,
+        memoryQuery: trigger.memoryQuery,
+        requiredEvidence: [...trigger.requiredEvidence],
+        confidence: trigger.match.minConfidence,
+        detector: `agent-authored:${trigger.id}`,
+        channelId: event.channelId,
+        occurredAt: event.createdAt,
+        reason: `Agent-authored trigger ${trigger.id} matched.`,
+        text,
+        sourceRefs: [{ sourceConnector: event.channel, sourceId: event.eventIndexId ?? String(event.id) }],
+        triggerId: trigger.id,
+    };
+}
+//# sourceMappingURL=trigger-matcher.js.map

package/dist/operator/trigger-matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-matcher.js","sourceRoot":"","sources":["../../src/operator/trigger-matcher.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;AAMH,sCAeC;AAfD,SAAgB,aAAa,CAAC,KAA2B,EAAE,QAAyB;IAClF,2FAA2F;IAC3F,sCAAsC;IACtC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,EAAE,CAAC;IAErC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAClC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAErB,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC;QAC5C,IAAI,mBAAmB,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;YAC9C,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAsB,EAAE,KAA2B,EAAE,IAAY;IAC5F,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC;IAEjE,IAAI,eAAe,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAChG,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAEvC,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC5C,MAAM,GAAG,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAClF,OAAO,WAAW,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACxE,CAAC;AAED,SAAS,WAAW,CAAC,OAAsB,EAAE,KAA2B,EAAE,IAAY;IACpF,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,gBAAgB,EAAE,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;QAC/C,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,aAAa;QACvC,QAAQ,EAAE,kBAAkB,OAAO,CAAC,EAAE,EAAE;QACxC,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,UAAU,EAAE,KAAK,CAAC,SAAS;QAC3B,MAAM,EAAE,0BAA0B,OAAO,CAAC,EAAE,WAAW;QACvD,IAAI;QACJ,UAAU,EAAE,CAAC,EAAE,eAAe,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,YAAY,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QAClG,SAAS,EAAE,OAAO,CAAC,EAAE;KACtB,CAAC;AACJ,CAAC"}

package/dist/operator/trigger-registry.d.ts

@@ -0,0 +1,36 @@
+/**
+ * TriggerRegistry - operator-owned persistence for agent-authored triggers.
+ *
+ * The agent authors triggers (trigger-author.ts); this store only persists/lists them.
+ * Ports Kagemusha `WorkflowContractRegistry`
+ * (~/project/mama-suite/apps/kagemusha/src/agent/contracts/workflow-registry.ts) but with the
+ * human-approval lifecycle removed: `create` yields `status:'active'` immediately (G4 unfrozen).
+ * There is no `needs_review`/`approvedBy` - that gate does not exist here by construction.
+ *
+ * Personal triggers live in the operator DB under `~/.mama`; this source is generic.
+ */
+import type { SQLiteDatabase } from '../sqlite.js';
+import type { CreateTriggerInput, TriggerRecord } from './trigger-types.js';
+export declare class TriggerRegistry {
+    private db;
+    constructor(db: SQLiteDatabase);
+    private runMigration;
+    /** Persist an agent-authored trigger. Self-activates (G4): status is 'active' at birth. */
+    create(input: CreateTriggerInput): TriggerRecord;
+    listActive(): TriggerRecord[];
+    /** Every trigger regardless of status (owner tray view). id DESC breaks same-ms ties. */
+    listAll(): TriggerRecord[];
+    getById(id: string): TriggerRecord | null;
+    /**
+     * Record that a trigger FIRED (read-only surface loop) - bumps `fired` only.
+     * Distinct from recordOutcome: a fire is not a success/failure judgment, and the
+     * read-only loop must never fabricate one (M1-T2).
+     */
+    recordFire(id: string): void;
+    /** Record an intervention outcome - the G2 evolution feed (Task 4 reads stats). */
+    recordOutcome(id: string, outcome: 'succeeded' | 'failed'): void;
+    /** Retire a trigger (agent-judged in Task 4; here it's the mechanical write). */
+    disable(id: string, reason: string): TriggerRecord;
+    close(): void;
+}
+//# sourceMappingURL=trigger-registry.d.ts.map

package/dist/operator/trigger-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-registry.d.ts","sourceRoot":"","sources":["../../src/operator/trigger-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAiB,MAAM,oBAAoB,CAAC;AAoB3F,qBAAa,eAAe;IAC1B,OAAO,CAAC,EAAE,CAAiB;gBAEf,EAAE,EAAE,cAAc;IAK9B,OAAO,CAAC,YAAY;IAuBpB,2FAA2F;IAC3F,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa;IAgChD,UAAU,IAAI,aAAa,EAAE;IAO7B,yFAAyF;IACzF,OAAO,IAAI,aAAa,EAAE;IAO1B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAOzC;;;;OAIG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAO5B,mFAAmF;IACnF,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,QAAQ,GAAG,IAAI;IAYhE,iFAAiF;IACjF,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa;IAYlD,KAAK,IAAI,IAAI;CAGd"}