@jungjaehoon/mama-os 0.28.6 → 0.29.0

package/dist/operator/board-reconcile.js

@@ -16,37 +16,10 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReconcileScheduler = exports.RECONCILE_RUN_TOKEN = void 0;
-exports.buildReconcilePrompt = buildReconcilePrompt;
 /** The prompt MUST begin with this token so the persona's RECONCILE RUN mode engages. */
 exports.RECONCILE_RUN_TOKEN = 'RECONCILE RUN';
-function buildReconcilePrompt(input) {
-    const label = input.channelLabel ?? input.channelKey;
-    const scope = `reconcile:${input.channelKey}`;
-    return [
-        `${exports.RECONCILE_RUN_TOKEN} for channel ${label} (${input.channelKey}). Today is ${input.todayIso}.`,
-        'New messages arrived in this channel. Reconcile the operator board and the task ledger',
-        'against them. Plan (execute in order):',
-        '1. Read the delta lines below.',
-        `2. task_list() for existing work items${input.kagemushaContext ? ' and kagemusha_tasks() as extra CONTEXT (the native ledger stays the projection source)' : ''}.`,
-        '3. Judge which slots are affected (briefing / action_required / decisions / pipeline).',
-        '4. You MUST call at least ONE of: report_publish with ONLY the affected slots,',
-        '   task_create, or task_update -- when the delta concerns work that ALREADY has a',
-        '   task row (match by title or source in step 2), task_update that row instead of',
-        '   creating a near-duplicate, and pass source_channel plus source_event_id from the',
-        '   delta header so retries upsert. If NOTHING on the board or ledger is affected,',
-        `   you MUST call contract_no_update({reason, scope: "${scope}"}) instead.`,
-        '5. Finish with exactly one line: RECONCILED <comma-separated slots or none>.',
-        '',
-        'Constraints: do not rewrite unaffected slots; no mama_save; no follow-up questions.',
-        '- Set due_at only from trusted, unambiguous time and time zone evidence; otherwise retain date-only precision.',
-        '- Never infer completion from calendar disappearance.',
-        '- Never copy Trello or Kagemusha lifecycle status into the native ledger.',
-        '',
-        `<latest-delta channel="${input.channelKey}">`,
-        ...input.deltaLines,
-        '</latest-delta>',
-    ].join('\n');
-}
+/** Generous: live batches run 1-30. A cap that truncates is logged, never silent. */
+const MAX_PENDING_EVENT_IDS = 500;
 class ReconcileScheduler {
     debounceMs;
     maxWaitMs;
@@ -68,15 +41,23 @@ class ReconcileScheduler {
         this.log = opts.log;
         this.now = opts.now ?? Date.now;
     }
-    enqueue(channelKey, lines) {
+    enqueue(channelKey, lines, eventIds = []) {
         if (this.stopped)
             return;
         const state = this.channels.get(channelKey) ?? {
             pendingLines: [],
+            pendingEventIds: [],
             debounceTimer: null,
             firstEnqueuedAt: null,
         };
         state.pendingLines = [...state.pendingLines, ...lines].slice(-this.maxPendingLines);
+        const mergedIds = [...new Set([...state.pendingEventIds, ...eventIds])];
+        if (mergedIds.length > MAX_PENDING_EVENT_IDS) {
+            // Loud, because a truncated cause set understates what the run rested on and would
+            // otherwise look exactly like a smaller batch.
+            this.log(`[reconcile] ${channelKey}: cause set exceeded ${MAX_PENDING_EVENT_IDS}; dropping the oldest ${mergedIds.length - MAX_PENDING_EVENT_IDS}`);
+        }
+        state.pendingEventIds = mergedIds.slice(-MAX_PENDING_EVENT_IDS);
         if (state.firstEnqueuedAt === null)
             state.firstEnqueuedAt = this.now();
         this.channels.set(channelKey, state);
@@ -143,15 +124,20 @@ class ReconcileScheduler {
             return;
         }
         const lines = state.pendingLines;
+        const eventIds = state.pendingEventIds;
         state.pendingLines = [];
+        state.pendingEventIds = [];
         state.firstEnqueuedAt = null;
         this.runTimestamps.push(this.now());
         try {
-            await this.run(channelKey, lines);
+            await this.run(channelKey, lines, eventIds);
         }
         catch (err) {
-            // Run failure keeps the channel dirty for retry; the scheduler survives.
+            // Run failure keeps the channel dirty for retry; the scheduler survives. The cause
+            // set is restored with the lines - a retry that kept the prompt but lost the batch
+            // would run on evidence it could no longer name.
             state.pendingLines = [...lines, ...state.pendingLines].slice(-this.maxPendingLines);
+            state.pendingEventIds = [...new Set([...eventIds, ...state.pendingEventIds])].slice(-MAX_PENDING_EVENT_IDS);
             if (state.firstEnqueuedAt === null)
                 state.firstEnqueuedAt = this.now();
             this.log(`[reconcile] run failed for ${channelKey}: ${err instanceof Error ? err.message : String(err)}; kept dirty for retry`);

package/dist/operator/board-reconcile.js.map

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

package/dist/operator/changes-projection.d.ts

@@ -0,0 +1,70 @@
+/**
+ * The read side of the effect ledger: what this system changed, and on what evidence.
+ *
+ * Lives here rather than inside the gateway executor's switch so it can be tested against
+ * a real ledger without standing up an agent. The first cut was written inline and its
+ * tests drove everything EXCEPT the tool path, which is how a projection that could state
+ * a falsehood passed seven green tests.
+ *
+ * The falsehood it could state: rows are capped, coverage is not. With 40 attributed and
+ * 80 unattributed changes in a window, a default call returned 50 rows - all unattributed,
+ * because the newest changes skew that way while `task_update` has no cause field - beside
+ * a coverage count saying 40 were explainable, and nothing anywhere saying 120 matched. A
+ * model reading its own output could truthfully report "nothing I did is explainable".
+ *
+ * So: the counts and the rows must describe the same population, the cap must be visible,
+ * and a filter the caller misspells must fail loudly rather than return zero rows - "no
+ * rows" and "nothing changed" are the same sentence to a reader, and only one of them is
+ * ever true.
+ */
+import type { EffectQuery, EffectRecord, EffectTarget } from '../evidence/effects.js';
+export interface ChangesLedger {
+    listChanges(query: EffectQuery): EffectRecord[];
+    changeCoverage(sinceMs?: number, targetType?: EffectTarget): {
+        attributed: number;
+        unattributed: number;
+    };
+}
+export interface ChangesReadInput {
+    since?: unknown;
+    target_type?: unknown;
+    cause_state?: unknown;
+    limit?: unknown;
+}
+export interface ChangesReadFailure {
+    success: false;
+    code: 'invalid_argument';
+    error: string;
+}
+export interface ChangesReadResult {
+    success: true;
+    coverage: {
+        attributed: number;
+        unattributed: number;
+    };
+    since: string;
+    /** Changes matching the filter in the window - not the number returned. */
+    total: number;
+    returned: number;
+    changes: Array<{
+        kind: string;
+        target_type: string;
+        target_id: string;
+        cause_state: string;
+        source_event_ids: string[];
+        channel: string | null;
+        run_id: string | null;
+        at: string;
+    }>;
+}
+/**
+ * The window a read covers.
+ *
+ * Unparseable input falls back to the default and the resolved window is returned to the
+ * caller, so whatever was asked for, what was actually read is stated. Non-string input is
+ * not a window at all - a model emitting epoch milliseconds used to crash the tool on
+ * `.trim()`.
+ */
+export declare function parseChangesSince(since: unknown, nowMs: number): number;
+export declare function readChanges(ledger: ChangesLedger, input: ChangesReadInput, nowMs: number): ChangesReadResult | ChangesReadFailure;
+//# sourceMappingURL=changes-projection.d.ts.map

package/dist/operator/changes-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changes-projection.d.ts","sourceRoot":"","sources":["../../src/operator/changes-projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAc,MAAM,wBAAwB,CAAC;AAWlG,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,EAAE,CAAC;IAChD,cAAc,CACZ,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,YAAY,GACxB;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,KAAK,CAAC;IACf,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,IAAI,CAAC;IACd,QAAQ,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC,CAAC;CACJ;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAkBvE;AAyCD,wBAAgB,WAAW,CACzB,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,gBAAgB,EACvB,KAAK,EAAE,MAAM,GACZ,iBAAiB,GAAG,kBAAkB,CAwCxC"}

package/dist/operator/changes-projection.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseChangesSince = parseChangesSince;
+exports.readChanges = readChanges;
+const DEFAULT_WINDOW_MS = 24 * 60 * 60 * 1000;
+const DEFAULT_LIMIT = 50;
+const MAX_LIMIT = 200;
+/** Below this a window is not a window; it is a corrupted number reaching toISOString. */
+const MIN_SINCE_MS = 0;
+const TARGET_TYPES = ['task', 'report_slot', 'memory', 'wiki_page'];
+const CAUSE_STATES = ['attributed', 'unattributed'];
+/**
+ * The window a read covers.
+ *
+ * Unparseable input falls back to the default and the resolved window is returned to the
+ * caller, so whatever was asked for, what was actually read is stated. Non-string input is
+ * not a window at all - a model emitting epoch milliseconds used to crash the tool on
+ * `.trim()`.
+ */
+function parseChangesSince(since, nowMs) {
+    const raw = typeof since === 'string' ? since.trim() : '';
+    if (raw === '')
+        return nowMs - DEFAULT_WINDOW_MS;
+    // Minutes are here because a caller writing "30m" is entirely ordinary, and without
+    // the unit it fell through to the 24-hour default - a window 48x wider than asked for.
+    const relative = /^(\d+)\s*([dhm])$/i.exec(raw);
+    if (relative) {
+        const unit = relative[2].toLowerCase();
+        const unitMs = unit === 'd' ? 24 * 60 * 60 * 1000 : unit === 'h' ? 60 * 60 * 1000 : 60 * 1000;
+        // Clamped: a window of 99999999999 days is not a request, and an unclamped one
+        // produces a timestamp that throws on the way back out.
+        return clampSince(nowMs - Number(relative[1]) * unitMs, nowMs);
+    }
+    const parsed = Date.parse(raw);
+    if (Number.isNaN(parsed))
+        return nowMs - DEFAULT_WINDOW_MS;
+    return clampSince(parsed, nowMs);
+}
+/** A future window returns nothing, and nothing reads as "nothing changed". */
+function clampSince(sinceMs, nowMs) {
+    return Math.min(Math.max(sinceMs, MIN_SINCE_MS), nowMs);
+}
+function parseLimit(limit) {
+    if (limit === undefined || limit === null)
+        return DEFAULT_LIMIT;
+    const value = typeof limit === 'string' ? Number(limit.trim()) : limit;
+    if (typeof value !== 'number' || !Number.isInteger(value) || value < 1) {
+        return invalid(`limit must be a positive whole number, got: ${String(limit)}`);
+    }
+    return Math.min(value, MAX_LIMIT);
+}
+function parseEnum(value, allowed, field) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    if (typeof value === 'string' && allowed.includes(value))
+        return value;
+    // Silently returning zero rows for a misspelt filter is the worst answer available:
+    // it is indistinguishable from "nothing changed".
+    return invalid(`${field} must be one of ${allowed.join(', ')}, got: ${String(value)}`);
+}
+function invalid(error) {
+    return { success: false, code: 'invalid_argument', error };
+}
+function isFailure(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        value.success === false);
+}
+function readChanges(ledger, input, nowMs) {
+    const limit = parseLimit(input.limit);
+    if (isFailure(limit))
+        return limit;
+    const targetType = parseEnum(input.target_type, TARGET_TYPES, 'target_type');
+    if (isFailure(targetType))
+        return targetType;
+    const causeState = parseEnum(input.cause_state, CAUSE_STATES, 'cause_state');
+    if (isFailure(causeState))
+        return causeState;
+    const sinceMs = parseChangesSince(input.since, nowMs);
+    // Coverage is the cause_state breakdown, so it answers within the SAME target scope the
+    // rows were drawn from. It deliberately ignores cause_state: filtering the breakdown by
+    // one of its own terms would report a zero that only means "I asked for the other one".
+    const coverage = ledger.changeCoverage(sinceMs, targetType);
+    const matching = coverage.attributed + coverage.unattributed;
+    const total = causeState === undefined
+        ? matching
+        : causeState === 'attributed'
+            ? coverage.attributed
+            : coverage.unattributed;
+    const changes = ledger.listChanges({ sinceMs, targetType, causeState, limit });
+    return {
+        success: true,
+        coverage,
+        since: new Date(sinceMs).toISOString(),
+        total,
+        returned: changes.length,
+        changes: changes.map((change) => ({
+            kind: change.kind,
+            target_type: change.targetType,
+            target_id: change.targetId,
+            cause_state: change.causeState,
+            source_event_ids: change.sourceEventIds,
+            channel: change.channelId,
+            run_id: change.runId,
+            at: new Date(change.atMs).toISOString(),
+        })),
+    };
+}
+//# sourceMappingURL=changes-projection.js.map

package/dist/operator/changes-projection.js.map

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

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

@@ -0,0 +1,94 @@
+/**
+ * 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

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

package/dist/operator/external-correlation.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * 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".
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.correlateTasksWithExternalItems = correlateTasksWithExternalItems;
+function readString(source, key) {
+    const value = source?.[key];
+    return typeof value === 'string' && value.trim().length > 0 ? value : null;
+}
+/** Legacy fallback only: `<boardId>:<itemId>:<observedMs>`. Structured metadata wins. */
+function parseCompositeSourceId(sourceId) {
+    const parts = sourceId.split(':');
+    if (parts.length !== 3) {
+        return null;
+    }
+    const [boardId, itemId] = parts;
+    return boardId && itemId ? { boardId, itemId } : null;
+}
+function resolveExternalRef(record) {
+    const composite = parseCompositeSourceId(record.sourceId);
+    const boardId = readString(record.metadata, 'boardId');
+    const itemId = readString(record.metadata, 'cardId') ?? readString(record.metadata, 'itemId');
+    if (boardId && itemId) {
+        const conflict = composite !== null && (composite.boardId !== boardId || composite.itemId !== itemId);
+        return { ref: { boardId, itemId }, conflict };
+    }
+    return { ref: composite, conflict: false };
+}
+function classify(row, input, liveById) {
+    const prefix = `${input.connector}:`;
+    if (!row.sourceChannel) {
+        return {
+            taskId: row.id,
+            outcome: 'not_applicable',
+            reason: 'no_source',
+            externalRef: null,
+            live: null,
+        };
+    }
+    if (!row.sourceChannel.startsWith(prefix)) {
+        return {
+            taskId: row.id,
+            outcome: 'not_applicable',
+            reason: 'other_connector',
+            externalRef: null,
+            live: null,
+        };
+    }
+    if (!row.sourceEventId) {
+        return {
+            taskId: row.id,
+            outcome: 'unmatched',
+            reason: 'no_provenance',
+            externalRef: null,
+            live: null,
+        };
+    }
+    const record = input.lookupProvenance(row.sourceEventId);
+    if (!record) {
+        return {
+            taskId: row.id,
+            outcome: 'unmatched',
+            reason: 'provenance_not_indexed',
+            externalRef: null,
+            live: null,
+        };
+    }
+    if (record.sourceConnector !== input.connector) {
+        return {
+            taskId: row.id,
+            outcome: 'unmatched',
+            reason: 'provenance_connector_mismatch',
+            externalRef: null,
+            live: null,
+        };
+    }
+    const { ref, conflict } = resolveExternalRef(record);
+    if (!ref) {
+        return {
+            taskId: row.id,
+            outcome: 'unmatched',
+            reason: 'external_ref_unresolvable',
+            externalRef: null,
+            live: null,
+        };
+    }
+    if (conflict) {
+        return {
+            taskId: row.id,
+            outcome: 'ambiguous',
+            reason: 'provenance_conflict',
+            externalRef: ref,
+            live: null,
+        };
+    }
+    const live = liveById.get(ref.itemId);
+    if (live) {
+        return {
+            taskId: row.id,
+            outcome: 'matched',
+            reason: 'live_item',
+            externalRef: ref,
+            live: { board: live.board, list: live.list },
+        };
+    }
+    return {
+        taskId: row.id,
+        outcome: 'historical_only',
+        // A partial snapshot cannot even establish that the item is gone from the open set.
+        reason: input.liveSnapshotComplete ? 'absent_from_live_snapshot' : 'live_snapshot_incomplete',
+        externalRef: ref,
+        live: null,
+    };
+}
+/**
+ * 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.
+ */
+function correlateTasksWithExternalItems(input) {
+    const liveById = new Map(input.liveItems.map((item) => [item.itemId, item]));
+    const resolved = input.rows.map((row) => classify(row, input, liveById));
+    const rowsByItem = new Map();
+    for (const correlation of resolved) {
+        if (correlation.externalRef && correlation.outcome !== 'ambiguous') {
+            const key = correlation.externalRef.itemId;
+            rowsByItem.set(key, (rowsByItem.get(key) ?? 0) + 1);
+        }
+    }
+    const correlations = resolved.map((correlation) => {
+        if (correlation.externalRef &&
+            correlation.outcome !== 'ambiguous' &&
+            (rowsByItem.get(correlation.externalRef.itemId) ?? 0) > 1) {
+            return {
+                ...correlation,
+                outcome: 'ambiguous',
+                reason: 'multiple_rows_one_item',
+                live: null,
+            };
+        }
+        return correlation;
+    });
+    const coverage = {
+        total: correlations.length,
+        matched: 0,
+        unmatched: 0,
+        ambiguous: 0,
+        historical_only: 0,
+        not_applicable: 0,
+    };
+    for (const correlation of correlations) {
+        coverage[correlation.outcome] += 1;
+    }
+    return { correlations, coverage };
+}
+//# sourceMappingURL=external-correlation.js.map

package/dist/operator/external-correlation.js.map

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

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

@@ -82,7 +82,15 @@ export interface TriggerLoopDeps {
      * (each carrying the event id so reconcile task writes can pass
      * source_event_id). Absent -> no reconcile leg.
      */
-    onChannelDelta?: (channelKey: string, lines: string[]) => void;
+    /**
+     * `eventIds` is the batch itself, carried alongside the human-readable lines.
+     *
+     * The ids were already inside the lines as `[id:evt_...]` headers and were only ever
+     * read back by parsing prose - which meant the SYSTEM knew the batch, flattened it to
+     * text, and then asked the AGENT to restate it. Every change a bounded run makes rests
+     * on this batch; carrying it is the difference between a fact and a claim.
+     */
+    onChannelDelta?: (channelKey: string, lines: string[], eventIds: string[]) => void;
     /** Kagemusha dual output: FULL report also publishes the operator board slots. */
     fullReportBoardLines?: string[];
     /** Context carry (plan v6 S1-T4): persist the delivered FULL report text. */

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

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

package/dist/operator/operator-trigger-loop.js

@@ -248,11 +248,15 @@ class OperatorTriggerLoop {
                 byChannel.set(key, bucket);
             }
             for (const [channelKey, channelEvents] of byChannel) {
-                const lines = channelEvents
-                    .slice(-10)
-                    .map((e) => `- [id:${e.eventIndexId ?? e.id}] ${e.userId}: ${e.content.trim().slice(0, 200)}`);
+                // The prompt shows the last 10; the CAUSE is the whole batch. Truncating both
+                // would silently drop events the run acted on from the record of why it acted.
+                const shown = channelEvents.slice(-10);
+                const lines = shown.map((e) => `- [id:${e.eventIndexId ?? e.id}] ${e.userId}: ${e.content.trim().slice(0, 200)}`);
+                const eventIds = channelEvents
+                    .map((e) => e.eventIndexId)
+                    .filter((id) => typeof id === 'string' && id.length > 0);
                 try {
-                    this.deps.onChannelDelta(channelKey, lines);
+                    this.deps.onChannelDelta(channelKey, lines, eventIds);
                 }
                 catch (err) {
                     log(`[trigger-loop] onChannelDelta failed for ${channelKey}: ${err instanceof Error ? err.message : String(err)}`);