@jungjaehoon/mama-os 0.78.0 → 0.79.0

package/dist/runtime/upkeep-orders.js

@@ -0,0 +1,310 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UPKEEP_SCAN_PAGE = exports.UPKEEP_WINDOW_MS = exports.UPKEEP_MAX_ATTEMPTS = void 0;
+exports.upkeepOrderIdPrefix = upkeepOrderIdPrefix;
+exports.parseUpkeepOrder = parseUpkeepOrder;
+exports.orderRunIds = orderRunIds;
+exports.noUpdateCites = noUpdateCites;
+exports.runningChildren = runningChildren;
+exports.createUpkeepOrders = createUpkeepOrders;
+const node_crypto_1 = require("node:crypto");
+/**
+ * Ledger upkeep orders (docs/development/work/ledger-upkeep.md). The host chooses the subjects,
+ * the agent judges and writes in the common session, and the host checks each subject when the
+ * order's run ends. Record orders (record-orders.ts) stay a separate lane: they follow live deltas
+ * and carry batches; upkeep follows the ledger's own state.
+ *
+ *   tick(kind) ── scan ──> subjects not checked, not in an open order, under the attempt limit
+ *        │                          │
+ *        │                  accept(order on kind.channel)
+ *        ▼                          ▼
+ *   onResult / onLost ──> per subject: checked │ waiting (picked by the next tick) │ lost
+ *
+ * Checked and lost subjects are also written to upkeep_settled: the mailbox deletes acked order
+ * rows after seven days, and a settled subject must never be ordered again.
+ */
+/** A subject is ordered at most this many times; then it is reported lost and left alone. */
+exports.UPKEEP_MAX_ATTEMPTS = 3;
+/** How far back stored orders are read to count a subject's attempts. */
+exports.UPKEEP_WINDOW_MS = 7 * 24 * 60 * 60 * 1000;
+/** Candidates per scan page. */
+exports.UPKEEP_SCAN_PAGE = 200;
+/** Every order of a kind has an id with this prefix; its runs carry it as sourceMessageRef. */
+function upkeepOrderIdPrefix(kindName) {
+    return `upkeep:${kindName}:`;
+}
+function parseUpkeepOrder(payload) {
+    const value = payload;
+    if (!value ||
+        value.order !== 'upkeep' ||
+        typeof value.kind !== 'string' ||
+        !Array.isArray(value.subjects) ||
+        value.subjects.length === 0 ||
+        value.subjects.some((subject) => typeof subject?.key !== 'string' || subject.key === ''))
+        throw new Error('Upkeep order requires { order: upkeep, kind, subjects: [{ key }] }');
+    return value;
+}
+/** The runs an order produced: its own turn and the child runs that turn started. */
+function orderRunIds(adapter, orderIds) {
+    if (orderIds.length === 0)
+        return [];
+    const marks = orderIds.map(() => '?').join(',');
+    return adapter
+        .prepare(`SELECT r.model_run_id AS id FROM model_runs r
+          WHERE json_extract(r.input_refs_json, '$.sourceMessageRef') IN (${marks})
+         UNION
+         SELECT c.model_run_id FROM model_runs c JOIN model_runs p ON c.parent_model_run_id = p.model_run_id
+          WHERE json_extract(p.input_refs_json, '$.sourceMessageRef') IN (${marks})`)
+        .all(...orderIds, ...orderIds).map((row) => row.id);
+}
+/**
+ * A completed work.no_update in these runs. With `cites`, the no-update must name one of the
+ * values in that input field (`commitmentIds` for a work item, `observationRefs` for a source);
+ * with `cites` null, any no-update in the runs counts. The field name is a fixed union, never
+ * caller text, so it interpolates into the json path safely.
+ */
+function noUpdateCites(adapter, runIds, cites) {
+    if (runIds.length === 0)
+        return false;
+    if (cites !== null && cites.values.length === 0)
+        return false;
+    const citing = cites === null
+        ? ''
+        : `AND EXISTS (
+            SELECT 1 FROM json_each(CASE WHEN json_valid(t.input_summary)
+                THEN json_extract(t.input_summary, '$.${cites.field}') END) ref
+             WHERE ref.value IN (${cites.values.map(() => '?').join(',')}))`;
+    return (adapter
+        .prepare(`SELECT 1 FROM tool_traces t
+          WHERE t.tool_name = 'work.no_update' AND t.execution_status = 'completed'
+            AND t.model_run_id IN (${runIds.map(() => '?').join(',')})
+            ${citing}
+          LIMIT 1`)
+        .get(...runIds, ...(cites?.values ?? [])) !== undefined);
+}
+/** The kind's subjects as its stored orders of the last week show them. */
+function storedSubjects(adapter, kind, now) {
+    const rows = adapter
+        .prepare(`SELECT m.stimulus_id, m.payload_json, m.status, n.state AS native_state
+         FROM mailbox_inputs m LEFT JOIN native_input_deliveries n ON n.input_id = m.id
+        WHERE m.kind = 'scheduled' AND m.channel_key = ? AND m.created_at >= ?
+        ORDER BY m.created_at, m.id`)
+        .all(kind.channel, now - exports.UPKEEP_WINDOW_MS);
+    const states = new Map();
+    let anyOpen = false;
+    for (const row of rows) {
+        const order = parseUpkeepOrder(JSON.parse(row.payload_json));
+        // A row parked uncertain stays claimed; it is settled through onLost, not left open.
+        const open = (row.status === 'pending' || row.status === 'claimed') && row.native_state !== 'uncertain';
+        anyOpen ||= open;
+        for (const subject of order.subjects) {
+            const current = states.get(subject.key);
+            states.set(subject.key, {
+                subject,
+                orders: [...(current?.orders ?? []), row.stimulus_id],
+                open: (current?.open ?? false) || open,
+            });
+        }
+    }
+    return { states, anyOpen };
+}
+/** A subject settled for good (upkeep_settled); a later write keeps the latest state. */
+function recordSettled(adapter) {
+    return adapter.prepare(`INSERT OR REPLACE INTO upkeep_settled (kind, subject_key, state, settled_at) VALUES (?, ?, ?, ?)`);
+}
+/** Child runs of an order run that this process started and that have not ended yet. */
+function runningChildren(adapter, modelRunId, startedAt) {
+    const row = adapter
+        .prepare(`SELECT count(*) AS n FROM model_runs
+        WHERE parent_model_run_id = ? AND status NOT IN ('committed', 'failed') AND created_at >= ?`)
+        .get(modelRunId, startedAt);
+    return row?.n ?? 0;
+}
+function createUpkeepOrders(options) {
+    const now = options.now ?? Date.now;
+    const sleep = options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    const childWaitMs = options.childWaitMs ?? 10 * 60 * 1000;
+    const byName = new Map(options.kinds.map((kind) => [kind.name, kind]));
+    const byChannel = new Map(options.kinds.map((kind) => [kind.channel, kind]));
+    const timers = [];
+    // Orders whose check is still waiting for child runs: their subjects are not ordered again yet.
+    const checking = new Set();
+    // An order is settled once: a row parked uncertain and then closed reports here twice.
+    const settledOrders = new Set();
+    let stopped = false;
+    const kindOf = (row) => {
+        const kind = byChannel.get(row.channelKey);
+        if (!kind)
+            throw new Error(`No upkeep kind serves channel ${row.channelKey}`);
+        return kind;
+    };
+    const settle = (kind, orderId, order, reason) => {
+        if (settledOrders.has(orderId))
+            return;
+        settledOrders.add(orderId);
+        const at = now();
+        const { states } = storedSubjects(options.adapter, kind, at);
+        const record = recordSettled(options.adapter);
+        for (const subject of order.subjects) {
+            const orders = states.get(subject.key)?.orders ?? [];
+            if (kind.checked(options.adapter, subject, orderRunIds(options.adapter, orders))) {
+                record.run(kind.name, subject.key, 'checked', at);
+                options.onEvent?.({ type: 'checked', kind: kind.name, subject: subject.key });
+                continue;
+            }
+            const attempt = orders.length;
+            if (attempt >= exports.UPKEEP_MAX_ATTEMPTS) {
+                record.run(kind.name, subject.key, 'lost', at);
+                options.onEvent?.({ type: 'lost', kind: kind.name, subject: subject.key, attempt, reason });
+            }
+            else
+                options.onEvent?.({
+                    type: 'waiting',
+                    kind: kind.name,
+                    subject: subject.key,
+                    attempt,
+                    reason,
+                });
+        }
+    };
+    const tick = (kindName) => {
+        const kind = byName.get(kindName);
+        if (!kind)
+            throw new Error(`Unknown upkeep kind ${kindName}`);
+        if (stopped)
+            return;
+        const at = now();
+        const { states, anyOpen } = storedSubjects(options.adapter, kind, at);
+        // One order of a kind at a time keeps the common session's queue for the owner; an order whose
+        // child runs may still write is not over yet.
+        if (anyOpen || [...checking].some((id) => id.startsWith(upkeepOrderIdPrefix(kind.name))))
+            return;
+        const settled = new Set(options.adapter
+            .prepare(`SELECT subject_key FROM upkeep_settled WHERE kind = ?`)
+            .all(kind.name).map((row) => row.subject_key));
+        const record = recordSettled(options.adapter);
+        const due = [];
+        const perGroup = new Map();
+        const candidates = function* () {
+            for (let page = 0;; page += 1) {
+                const rows = kind.scan(options.adapter, at, page);
+                yield* rows;
+                if (rows.length < exports.UPKEEP_SCAN_PAGE)
+                    return;
+            }
+        };
+        for (const subject of candidates()) {
+            if (kind.group === undefined && due.length >= kind.maxPerOrder)
+                break;
+            const group = kind.group?.(subject);
+            if (group !== undefined && (perGroup.get(group) ?? 0) >= kind.maxPerOrder)
+                continue;
+            if (settled.has(subject.key))
+                continue;
+            const state = states.get(subject.key);
+            const orders = state?.orders ?? [];
+            // No order of the kind is open here, so these orders are over. Their settlement is recorded
+            // again: a stop during the child-run wait, a failed check or a crash in settle() leaves it
+            // unwritten, and the stored orders that show it are deleted after seven days.
+            if (orders.length > 0 &&
+                kind.checked(options.adapter, subject, orderRunIds(options.adapter, orders))) {
+                record.run(kind.name, subject.key, 'checked', at);
+                continue;
+            }
+            // Reported lost when its last order was settled; it is never ordered again.
+            if (orders.length >= exports.UPKEEP_MAX_ATTEMPTS) {
+                record.run(kind.name, subject.key, 'lost', at);
+                continue;
+            }
+            due.push(subject);
+            if (group !== undefined)
+                perGroup.set(group, (perGroup.get(group) ?? 0) + 1);
+        }
+        if (due.length === 0)
+            return;
+        const id = `${upkeepOrderIdPrefix(kind.name)}${at}:${(0, node_crypto_1.randomUUID)().slice(0, 8)}`;
+        const payload = { order: 'upkeep', kind: kind.name, subjects: due };
+        const receipt = options.accept({
+            id,
+            kind: 'scheduled',
+            channelKey: kind.channel,
+            occurredAt: at,
+            payload: payload,
+        });
+        if (receipt.state !== 'duplicate')
+            options.onEvent?.({ type: 'ordered', kind: kind.name, order: id, subjects: due.length });
+    };
+    return {
+        isUpkeepRow: (row) => row.kind === 'scheduled' && byChannel.has(row.channelKey),
+        render: (row, at) => kindOf(row).render(parseUpkeepOrder(row.payload).subjects, at),
+        // The check waits for child runs in the background so the owner's queue is never held.
+        onResult: (row, modelRunId) => {
+            const kind = kindOf(row);
+            const order = parseUpkeepOrder(row.payload);
+            checking.add(row.stimulusId);
+            void (async () => {
+                if (modelRunId !== null) {
+                    const deadline = Date.now() + childWaitMs;
+                    while (!stopped &&
+                        runningChildren(options.adapter, modelRunId, options.processStartedAt) > 0 &&
+                        Date.now() < deadline)
+                        await sleep(5_000);
+                }
+                if (stopped)
+                    return;
+                settle(kind, row.stimulusId, order, 'the order ended without the expected write or a no-update naming it');
+            })()
+                .catch((error) => {
+                // A check cut off by shutdown is not a loss: the next tick finds the subject again.
+                if (stopped)
+                    return;
+                for (const subject of order.subjects)
+                    options.onEvent?.({
+                        type: 'lost',
+                        kind: kind.name,
+                        subject: subject.key,
+                        attempt: 0,
+                        reason: `upkeep check failed: ${error instanceof Error ? error.message : String(error)}`,
+                    });
+            })
+                .finally(() => checking.delete(row.stimulusId));
+        },
+        onLost: (row, reason) => {
+            const kind = kindOf(row);
+            settle(kind, row.stimulusId, parseUpkeepOrder(row.payload), reason);
+        },
+        tick,
+        start: () => {
+            if (timers.length > 0 || stopped)
+                return;
+            for (const kind of options.kinds) {
+                const run = () => {
+                    try {
+                        tick(kind.name);
+                    }
+                    catch (error) {
+                        // A scan that fails names its kind; no subject was ordered, so the next scan retries.
+                        options.onEvent?.({
+                            type: 'lost',
+                            kind: kind.name,
+                            subject: '*',
+                            attempt: 0,
+                            reason: `upkeep scan failed: ${error instanceof Error ? error.message : String(error)}`,
+                        });
+                    }
+                };
+                const first = setTimeout(run, options.firstTickDelayMs ?? 60_000);
+                const every = setInterval(run, kind.intervalMs);
+                first.unref?.();
+                every.unref?.();
+                timers.push({ cancel: () => clearTimeout(first) }, { cancel: () => clearInterval(every) });
+            }
+        },
+        stop: () => {
+            stopped = true;
+            for (const timer of timers.splice(0))
+                timer.cancel();
+        },
+    };
+}
+//# sourceMappingURL=upkeep-orders.js.map

package/dist/runtime/upkeep-orders.js.map

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

package/dist/runtime/upkeep-reconcile.d.ts

@@ -0,0 +1,25 @@
+import type { JudgmentAccess } from '@jungjaehoon/mama-core/knowledge';
+import { type WorkListViewContext } from '../api/work-actions.js';
+import { type UpkeepKind } from './upkeep-orders.js';
+export declare const RECONCILE_ORDER_CHANNEL = "operator:reconcile";
+export interface ReconcileKindOptions {
+    knowledge: WorkListViewContext['knowledge'];
+    /** The common session's access: only work it can read is chosen. */
+    access: () => JudgmentAccess;
+    timeZone: () => string;
+    /** reports.full_report_hours, read at each scan: the first after midnight is the morning one. */
+    fullReportHours: () => readonly number[];
+}
+/**
+ * U3, board reconcile. Once a day before the morning report the host orders two groups of
+ * subject, at most ten of each:
+ * - an open item with cited cards that moved after the item's latest revision, all its moved cards
+ *   in one subject keyed by the item and its latest move, so a new move is a new subject;
+ * - an item in progress or in review whose latest source event is over 30 days old, chosen the way
+ *   work.list lastEventBefore chooses it, oldest first, keyed by the item and its latest revision
+ *   from outside the reconcile orders.
+ * A subject is checked by a revision on the item from the order's runs, or a work.no_update
+ * naming it. The runner keeps settled subjects past the mailbox's retention (upkeep_settled).
+ */
+export declare function reconcileUpkeepKind(options: ReconcileKindOptions): UpkeepKind;
+//# sourceMappingURL=upkeep-reconcile.d.ts.map

package/dist/runtime/upkeep-reconcile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upkeep-reconcile.d.ts","sourceRoot":"","sources":["../../src/runtime/upkeep-reconcile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAkB,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvF,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAKL,KAAK,UAAU,EAEhB,MAAM,oBAAoB,CAAC;AAE5B,eAAO,MAAM,uBAAuB,uBAAuB,CAAC;AAO5D,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAC5C,oEAAoE;IACpE,MAAM,EAAE,MAAM,cAAc,CAAC;IAC7B,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,iGAAiG;IACjG,eAAe,EAAE,MAAM,SAAS,MAAM,EAAE,CAAC;CAC1C;AAoID;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,UAAU,CAsI7E"}

package/dist/runtime/upkeep-reconcile.js

@@ -0,0 +1,231 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RECONCILE_ORDER_CHANNEL = void 0;
+exports.reconcileUpkeepKind = reconcileUpkeepKind;
+const work_actions_js_1 = require("../api/work-actions.js");
+const untrusted_content_js_1 = require("../utils/untrusted-content.js");
+const timezone_js_1 = require("./timezone.js");
+const upkeep_orders_js_1 = require("./upkeep-orders.js");
+exports.RECONCILE_ORDER_CHANNEL = 'operator:reconcile';
+const KIND = 'reconcile';
+/** The stale step the daily page carried until U3: items in progress or in review. */
+const STALE_STATUSES = ['in_progress', 'review'];
+/** An item whose latest source event is older than this is stale. */
+const STALE_AFTER_MS = 30 * 24 * 60 * 60 * 1000;
+/**
+ * Whether the day's order is due: from local midnight until the first full report after midnight
+ * (or the next midnight when there is none), once a local day. The hourly tick finds it due at its
+ * first run of the day; a restart in the same morning finds the order already placed, and a
+ * subject the order missed waits for the next day.
+ */
+function due(adapter, now, zone, hours) {
+    const day = (0, timezone_js_1.localDateKey)(now, zone);
+    const midnight = (0, timezone_js_1.epochAtLocalDateTime)(`${day}T00:00:00`, zone);
+    const after = hours.filter((hour) => hour > 0);
+    if (after.length > 0) {
+        const morning = String(Math.min(...after)).padStart(2, '0');
+        if (now >= (0, timezone_js_1.epochAtLocalDateTime)(`${day}T${morning}:00:00`, zone))
+            return false;
+    }
+    return (adapter
+        .prepare(`SELECT 1 FROM mailbox_inputs
+          WHERE kind = 'scheduled' AND channel_key = ? AND created_at >= ? LIMIT 1`)
+        .get(exports.RECONCILE_ORDER_CHANNEL, midnight) === undefined);
+}
+/**
+ * The time of an item's latest revision on the source timeline: its event time, or its write time
+ * when it has none, as work.list's event spans read a revision. A backfill writes an earlier
+ * period after later revisions, so the last-written revision is not always the latest one.
+ */
+function latestRevisionAt(item) {
+    return Math.max(...(item.chain ?? []).map((entry) => entry.eventDatetime ?? entry.createdAt));
+}
+/**
+ * The card ids among the observations each item's revisions cite. Card ids are read from the
+ * observation's metadata (`cardId`), which only the Trello connector writes today; it stores the
+ * board id there for a board-level action, which names no card. Read from the item side, every
+ * join is on a key (an edge's object is the observation id).
+ */
+function citedCards(adapter) {
+    const rows = adapter
+        .prepare(`SELECT DISTINCT a.commitment_id AS commitmentId, o.source AS connector,
+              json_extract(o.metadata_json, '$.cardId') AS card
+         FROM commitment_assignments a
+         JOIN twin_edges e ON e.subject_kind = 'memory' AND e.subject_id = a.record_id
+                          AND e.edge_type = 'derived_from' AND e.object_kind = 'observation'
+         JOIN observation_versions o ON o.observation_id = e.object_id
+        WHERE json_extract(o.metadata_json, '$.cardId') IS NOT NULL
+          AND json_extract(o.metadata_json, '$.cardId') IS NOT json_extract(o.metadata_json, '$.boardId')
+        ORDER BY commitmentId, connector, card`)
+        .all();
+    const cards = new Map();
+    for (const row of rows)
+        cards.set(row.commitmentId, [
+            ...(cards.get(row.commitmentId) ?? []),
+            { connector: row.connector, card: row.card },
+        ]);
+    return cards;
+}
+/**
+ * Stored list moves in the attempt window, oldest first: a stored board event whose action data
+ * names the list the card went to (`data.listAfter`). A subject older than the window would count
+ * its attempts from zero again.
+ */
+function windowMoves(adapter, since, now) {
+    return adapter
+        .prepare(`SELECT source_connector AS connector, json_extract(metadata_json, '$.cardId') AS card,
+              source_id AS event, current_observation_id AS ref, event_datetime AS at
+         FROM connector_event_index
+        WHERE event_datetime >= ? AND event_datetime <= ?
+          AND json_extract(metadata_json, '$.data.listAfter') IS NOT NULL
+          AND json_extract(metadata_json, '$.cardId') IS NOT NULL
+          AND current_observation_id IS NOT NULL
+        ORDER BY event_datetime, source_id`)
+        .all(since, now);
+}
+/**
+ * Each item's latest revision not written by a reconcile order's run or its child runs. A stale
+ * subject is keyed by it: an order that keeps the item with a work.revise does not make it a new
+ * subject the next morning, while a revision from anywhere else does.
+ */
+function outsideRevisions(adapter, ids) {
+    if (ids.length === 0)
+        return new Map();
+    const prefix = `${(0, upkeep_orders_js_1.upkeepOrderIdPrefix)(KIND)}%`;
+    const rows = adapter
+        .prepare(`WITH order_runs AS (
+         SELECT model_run_id FROM model_runs
+          WHERE json_extract(input_refs_json, '$.sourceMessageRef') LIKE ?
+         UNION
+         SELECT c.model_run_id FROM model_runs c JOIN model_runs p ON c.parent_model_run_id = p.model_run_id
+          WHERE json_extract(p.input_refs_json, '$.sourceMessageRef') LIKE ?)
+       SELECT commitment_id AS commitmentId, MAX(revision) AS revision FROM commitment_assignments
+        WHERE commitment_id IN (${ids.map(() => '?').join(',')})
+          AND (model_run_id IS NULL OR model_run_id NOT IN (SELECT model_run_id FROM order_runs))
+        GROUP BY commitment_id`)
+        .all(prefix, prefix, ...ids);
+    return new Map(rows.map((row) => [row.commitmentId, row.revision]));
+}
+function title(item) {
+    return typeof item.values.title === 'string' ? item.values.title : '';
+}
+/**
+ * U3, board reconcile. Once a day before the morning report the host orders two groups of
+ * subject, at most ten of each:
+ * - an open item with cited cards that moved after the item's latest revision, all its moved cards
+ *   in one subject keyed by the item and its latest move, so a new move is a new subject;
+ * - an item in progress or in review whose latest source event is over 30 days old, chosen the way
+ *   work.list lastEventBefore chooses it, oldest first, keyed by the item and its latest revision
+ *   from outside the reconcile orders.
+ * A subject is checked by a revision on the item from the order's runs, or a work.no_update
+ * naming it. The runner keeps settled subjects past the mailbox's retention (upkeep_settled).
+ */
+function reconcileUpkeepKind(options) {
+    return {
+        name: KIND,
+        channel: exports.RECONCILE_ORDER_CHANNEL,
+        intervalMs: 60 * 60 * 1000,
+        maxPerOrder: 10,
+        group: (subject) => subject.group,
+        scan: (adapter, now, page) => {
+            const zone = options.timeZone();
+            if (!due(adapter, now, zone, options.fullReportHours()))
+                return [];
+            const ledger = (0, work_actions_js_1.workListLedger)({ knowledge: options.knowledge, access: options.access(), timeZone: zone, now: () => now }, { status: STALE_STATUSES, lastEventBefore: now - STALE_AFTER_MS });
+            const open = new Map(ledger
+                .filter((entry) => work_actions_js_1.OPEN_WORK_STATUSES.includes(entry.status))
+                .map((entry) => [entry.item.commitmentId, entry]));
+            const cards = citedCards(adapter);
+            const citing = new Map();
+            for (const [commitmentId, list] of cards)
+                for (const card of list) {
+                    const at = `${card.connector}\n${card.card}`;
+                    citing.set(at, [...(citing.get(at) ?? []), commitmentId]);
+                }
+            // Per item, each cited card's latest move that the item's revisions have not caught up with.
+            const movesOf = new Map();
+            for (const move of windowMoves(adapter, now - upkeep_orders_js_1.UPKEEP_WINDOW_MS, now))
+                for (const commitmentId of citing.get(`${move.connector}\n${move.card}`) ?? []) {
+                    const entry = open.get(commitmentId);
+                    if (!entry || move.at <= latestRevisionAt(entry.item))
+                        continue;
+                    const byCard = movesOf.get(commitmentId) ?? new Map();
+                    byCard.set(`${move.connector}\n${move.card}`, move);
+                    movesOf.set(commitmentId, byCard);
+                }
+            const moved = [...movesOf].map(([commitmentId, byCard]) => {
+                const entry = open.get(commitmentId);
+                const moves = [...byCard.values()].sort((a, b) => a.at - b.at);
+                return {
+                    key: `move:${commitmentId}:${moves.at(-1).connector}:${moves.at(-1).event}`,
+                    group: 'move',
+                    commitmentId,
+                    title: title(entry.item),
+                    status: entry.status,
+                    lastEventAt: null,
+                    cards: [],
+                    moves,
+                    revisedAt: latestRevisionAt(entry.item),
+                };
+            });
+            moved.sort((a, b) => a.moves.at(-1).at - b.moves.at(-1).at || a.key.localeCompare(b.key));
+            const staleEntries = ledger
+                .filter((entry) => entry.stale)
+                .sort((a, b) => a.lastEvent - b.lastEvent || a.item.commitmentId.localeCompare(b.item.commitmentId));
+            const revisions = outsideRevisions(adapter, staleEntries.map((entry) => entry.item.commitmentId));
+            const stale = staleEntries.map((entry) => ({
+                // An item the orders themselves created has no outside revision: revision 0.
+                key: `stale:${entry.item.commitmentId}:${revisions.get(entry.item.commitmentId) ?? 0}`,
+                group: 'stale',
+                commitmentId: entry.item.commitmentId,
+                title: title(entry.item),
+                status: entry.status,
+                lastEventAt: entry.lastEvent,
+                cards: cards.get(entry.item.commitmentId) ?? [],
+                moves: [],
+                revisedAt: null,
+            }));
+            return [...moved, ...stale].slice(page * upkeep_orders_js_1.UPKEEP_SCAN_PAGE, (page + 1) * upkeep_orders_js_1.UPKEEP_SCAN_PAGE);
+        },
+        checked: (adapter, subject, runIds) => {
+            const { commitmentId } = subject;
+            if (runIds.length === 0)
+                return false;
+            const revised = adapter
+                .prepare(`SELECT 1 FROM commitment_assignments
+              WHERE commitment_id = ? AND model_run_id IN (${runIds.map(() => '?').join(',')})
+              LIMIT 1`)
+                .get(commitmentId, ...runIds) !== undefined;
+            return (revised ||
+                (0, upkeep_orders_js_1.noUpdateCites)(adapter, runIds, { field: 'commitmentIds', values: [commitmentId] }));
+        },
+        render: (subjects, now) => {
+            const zone = options.timeZone();
+            const all = subjects;
+            const at = (ms) => (0, timezone_js_1.localNow)(ms, zone);
+            const lines = all.map((subject) => subject.group === 'move'
+                ? `- moved ${subject.commitmentId} (${subject.status}), after the item's latest revision ${at(subject.revisedAt)}: ${subject.moves
+                    .map((move) => `card ${move.card} (${move.connector}) moved ${at(move.at)}, event ${move.ref}`)
+                    .join('; ')}`
+                : `- stale ${subject.commitmentId} (${subject.status}): latest source event ${at(subject.lastEventAt)}; ${subject.cards.length === 0
+                    ? 'cites no card'
+                    : `cards ${subject.cards.map((card) => `${card.card} (${card.connector})`).join(', ')}`}`);
+            // Titles come from stored work, which sources can shape: they are data, never instructions.
+            const titles = all.map((subject) => `${subject.commitmentId}: ${subject.title.replace(/\s+/g, ' ').slice(0, 200)}`);
+            return [
+                `[upkeep_reconcile] ${all.length} work item${all.length === 1 ? '' : 's'} to reconcile with the board`,
+                `Current time: ${at(now.getTime())} (${zone})`,
+                'Each item below may no longer match its source: a card it cites moved after its latest revision, or it is still in progress or in review with no source event in over 30 days (work.list lastEventBefore, not changedBefore: a backfill or correction rewrote many items later without a new event). Settle each one, so the ledger matches the board:',
+                "1. Read each item with work.list view=detail with ids (up to 4 per call), and its last originals with source.read (a moved item's move events first).",
+                '2. Read each listed card live with its connector: trello.read view=card id=<card id>. An item that cites no card but is board work: find its card with trello.read view=search (by its title), and say so when none exists. A stored move only chose the item; the live card decides. When the live card differs from its stored events, the collection has a gap: say so in the reason.',
+                '3. Close, cancel, change or keep each item: work.revise with what changed and why, linking what it rests on with derived_from; or, when it stays as it is, work.no_update with commitmentIds naming it and why it stays.',
+                '4. The order is checked when it ends: each item needs step 3. Correct a refused write (help gives its contract) and write it again.',
+                '5. Reply exactly [ack].',
+                'Items, at most ten moved and ten stale a day, stale oldest first; the rest come in the next days:',
+                ...lines,
+                (0, untrusted_content_js_1.wrapUntrustedContent)('work_titles', titles.join('\n')),
+            ].join('\n');
+        },
+    };
+}
+//# sourceMappingURL=upkeep-reconcile.js.map

package/dist/runtime/upkeep-reconcile.js.map

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

package/dist/runtime/upkeep-writeback.d.ts

@@ -0,0 +1,22 @@
+import { type UpkeepKind } from './upkeep-orders.js';
+export declare const WRITEBACK_ORDER_CHANNEL = "operator:writeback";
+export interface WritebackKindOptions {
+    /**
+     * The non-chat connectors the common session reads in full (ownerAccess.connectorWideRead).
+     * Their observations carry no memory scope, and the owner read path admits them by connector
+     * (observations.ts isObservationVisibilityRowVisible), so the same list decides they are common.
+     */
+    wideReadConnectors: () => readonly string[];
+    /** The common session's principal: its question turns qualify, and its chat scope is common. */
+    ownerPrincipalId: string;
+    timeZone: () => string;
+}
+/**
+ * U2, write-back orders. A subject is one question turn (a committed owner_message run of the
+ * common session or an owner-role principal) that read common-scope sources and recorded nothing
+ * from them. The order carries only common-scope handles; the question text is never carried. It
+ * is checked when the order's run writes a revision or a fact/lesson citing one of the handles, or
+ * declares work.no_update naming them.
+ */
+export declare function writebackUpkeepKind(options: WritebackKindOptions): UpkeepKind;
+//# sourceMappingURL=upkeep-writeback.d.ts.map

package/dist/runtime/upkeep-writeback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upkeep-writeback.d.ts","sourceRoot":"","sources":["../../src/runtime/upkeep-writeback.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,UAAU,EAEhB,MAAM,oBAAoB,CAAC;AAE5B,eAAO,MAAM,uBAAuB,uBAAuB,CAAC;AAK5D,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,kBAAkB,EAAE,MAAM,SAAS,MAAM,EAAE,CAAC;IAC5C,gGAAgG;IAChG,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,MAAM,CAAC;CACxB;AAgGD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,UAAU,CA0I7E"}