charness 3.6.0 → 3.7.0

package/dist/todos/registry.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.todoReadScopes = exports.todoHistoryMaxItems = void 0;
+exports.createTodoRegistry = createTodoRegistry;
+const sessionKey_1 = require("../sessionKey");
+const format_1 = require("./format");
+const merge_1 = require("./merge");
+const nag_1 = require("./nag");
+const order_1 = require("./order");
+/**
+ * @description The todo registry's agent-facing service: what `todo_update` and `todo_read` do and answer, and the
+ * hint a `final` answer gets while the list still shows work in progress (D8). Platform-neutral — a Telegram topic
+ * and a Jira issue publish alike; the MCP surface only routes the conversation its token names here.
+ */
+/** The most closed items `todo_read`'s history returns (D5). */
+exports.todoHistoryMaxItems = 50;
+/** What `todo_read` reads: the conversation's own list, or its project's whole board. */
+exports.todoReadScopes = ['own', 'project'];
+/** @description The opening line of a `todo_update` result: what the call did. */
+function formatUpdateSummary(isChanged, createdIds) {
+    if (!isChanged)
+        return 'Noted: your list is still accurate.';
+    return createdIds.length === 0 ? 'Saved.' : `Saved. New ${createdIds.length === 1 ? 'item' : 'items'}: ${createdIds.join(', ')}.`;
+}
+function createTodoRegistry(deps) {
+    const { store, getNowMs } = deps;
+    /** Busy time polled since the conversation's last turn end, not stored yet (a write per poll would be wasted). */
+    const unsavedWorkMs = new Map();
+    /** The conversation's reminder bookkeeping with the unsaved work folded in. */
+    function getCurrentNag(key) {
+        const nag = store.getTopic(key).nag ?? (0, nag_1.createTodoNagState)();
+        return (0, nag_1.getTodoNagStateWithWork)(nag, unsavedWorkMs.get((0, sessionKey_1.keyToString)(key)) ?? 0);
+    }
+    /** Store `nag` (the unsaved work is in it now). */
+    function saveNag(key, nag) {
+        unsavedWorkMs.delete((0, sessionKey_1.keyToString)(key));
+        store.saveTopic(key, { ...store.getTopic(key), nag });
+    }
+    return {
+        updateTodos(key, args) {
+            const nowMs = getNowMs();
+            const result = (0, merge_1.applyTodoUpdate)(store.getTopic(key), args, nowMs);
+            if (!result.ok)
+                return { ok: false, error: `Nothing was saved:\n${result.errors.map((error) => `• ${error}`).join('\n')}` };
+            // Any call says the list is accurate: the reminder's clock waits for the next turn end (D10).
+            unsavedWorkMs.delete((0, sessionKey_1.keyToString)(key));
+            const saved = store.saveTopic(key, { ...result.file, nag: (0, nag_1.createTodoNagState)() });
+            return { ok: true, message: `${formatUpdateSummary(result.isChanged, result.createdIds)}\n\n${(0, format_1.formatOwnTodoList)(saved.items, nowMs)}` };
+        },
+        readTodos(key, args) {
+            const topic = store.getTopic(key);
+            const ownList = (0, format_1.formatOwnTodoList)(topic.items, getNowMs());
+            if (args.includeHistory !== true)
+                return { ok: true, message: ownList };
+            const liveClosed = (0, order_1.getClosedTodoItems)(topic.items);
+            const archived = liveClosed.length >= exports.todoHistoryMaxItems ? [] : store.readArchivedItems(key, exports.todoHistoryMaxItems - liveClosed.length);
+            return { ok: true, message: `${ownList}\n\n${(0, format_1.formatTodoHistory)([...liveClosed, ...archived].slice(0, exports.todoHistoryMaxItems))}` };
+        },
+        getFinalAnswerNote(key, requestCreatedAt) {
+            const topic = store.getTopic(key);
+            if ((topic.lastUpdateAt ?? 0) >= requestCreatedAt)
+                return null;
+            const inWork = (0, order_1.getInWorkTodoItems)(topic.items);
+            if (inWork.length === 0)
+                return null;
+            const titles = inWork.map((item) => `${item.id} «${item.title}»`).join(', ');
+            return `Your published todo list still shows in work: ${titles}. If that changed, record it with todo_update (done, dropped or queued) now.`;
+        },
+        getTopic: (key) => store.getTopic(key),
+        getStore: () => store,
+        addTurnWork(key, elapsedMs) {
+            // Before the clock starts nothing counts (the turn the update was made in included).
+            if (store.getTopic(key).nag?.clockStartedAt === undefined || elapsedMs <= 0)
+                return;
+            const conversationKey = (0, sessionKey_1.keyToString)(key);
+            unsavedWorkMs.set(conversationKey, (unsavedWorkMs.get(conversationKey) ?? 0) + elapsedMs);
+        },
+        noteTurnEnd(key, nowMs) {
+            const nag = (0, nag_1.getTodoNagStateAtTurnEnd)(getCurrentNag(key), nowMs);
+            unsavedWorkMs.delete((0, sessionKey_1.keyToString)(key));
+            store.saveTopic(key, { ...store.getTopic(key), nag, lastTurnEndAt: nowMs });
+        },
+        takePromptReminder(key, intervalMs, nowMs) {
+            const nag = getCurrentNag(key);
+            if (!(0, nag_1.decidePromptTodoReminder)(nag, intervalMs).shouldRemind)
+                return null;
+            saveNag(key, (0, nag_1.getTodoNagStateAfterReminder)(nag, nowMs));
+            return (0, nag_1.buildTodoReminderText)(store.getTopic(key).lastUpdateAt, nowMs);
+        },
+        decideStandaloneReminder(key, intervalMs, gate, nowMs) {
+            const nag = getCurrentNag(key);
+            return {
+                ...(0, nag_1.decideStandaloneTodoReminder)(nag, intervalMs, gate),
+                text: (0, nag_1.buildTodoReminderText)(store.getTopic(key).lastUpdateAt, nowMs),
+                isStale: (0, nag_1.checkIsTodoNagStale)(nag, intervalMs),
+            };
+        },
+        noteReminderDelivered(key, nowMs) {
+            saveNag(key, (0, nag_1.getTodoNagStateAfterReminder)(getCurrentNag(key), nowMs));
+        },
+        notePersonActivity(key) {
+            // On a person's message path, before the prompt is forwarded: a store that cannot be read or written is logged,
+            // never thrown — the message goes on.
+            try {
+                const stored = store.getTopic(key).nag;
+                if (stored === undefined || stored.ignoredCount === 0)
+                    return;
+                saveNag(key, (0, nag_1.getTodoNagStateAfterPersonActivity)(getCurrentNag(key)));
+            }
+            catch (e) {
+                console.error(`[todos] ${(0, sessionKey_1.keyToString)(key)}: the reminder's silence could not be lifted:`, e instanceof Error ? e.message : e);
+            }
+        },
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/todos/registry.js.map

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

package/dist/todos/reminderEngine.d.ts

@@ -0,0 +1,78 @@
+import { type SessionKey } from '../sessionKey';
+import type { SessionTurnProbe } from '../requests/wakeUpRules';
+import type { TodoStandaloneGate } from './nag';
+import type { TodoRegistry } from './registry';
+/**
+ * @description The timer side of the staleness reminder (D10–D12). The conversations' sessions are POLLED like the
+ * wake-up engine's watched turns: each poll adds the WORKING time to the conversation's work — busy, and nothing
+ * holding the turn (a session waiting on a question is busy, but its agent does nothing) —, and a busy → idle edge is
+ * a turn end. The adapter's own turn end (`noteAdapterTurnEnd`, json-stream's `turnEnded`) is one too: the per-turn
+ * lifecycle stops the process right after it, before a poll could find it idle. A turn end starts the reminder's
+ * clock (the first one after an update) and, when the list is stale and every gate holds, posts the standalone
+ * reminder. Every decision is the
+ * registry's (`nag.ts`); this module only observes and acts. A failure in one conversation is logged and never stops
+ * the others. The same poll hands a busy session the project board's changes mid-turn (`midTurn.ts`) — it runs while
+ * the shared lists are on, the reminder off or not.
+ */
+/** How often the sessions are polled — the wake-up engine's turn poll. */
+export declare const todoReminderPollMs = 10000;
+/**
+ * @name TodoReminderEngineDeps
+ * @description `listConversations` = the conversations whose sessions are polled; `getGate` adds what the turn probe
+ * does not know (an open request, the answer tail, a limit, an API-billed account); `getIntervalMs` = the reminder's
+ * interval now (`null` = off); `postReminder` writes the standalone reminder into the idle session and resolves
+ * whether it was written.
+ */
+export interface TodoReminderEngineDeps {
+    registry: Pick<TodoRegistry, 'addTurnWork' | 'noteTurnEnd' | 'decideStandaloneReminder' | 'noteReminderDelivered'>;
+    listConversations: () => SessionKey[];
+    probeTurn: (key: SessionKey) => SessionTurnProbe;
+    getGate: (key: SessionKey) => Omit<TodoStandaloneGate, keyof SessionTurnProbe>;
+    getIntervalMs: () => number | null;
+    /** Whether the shared lists are on at all; off, the poll does nothing. */
+    checkIsEnabled: () => boolean;
+    postReminder: (key: SessionKey, text: string) => Promise<boolean>;
+    /**
+     * Mid-turn delivery (D22): reconcile what the hooks took, deliver to a working session what changed, and withdraw a
+     * waiting inbox when no tool call can take it (a turn's end, a turn held open).
+     */
+    midTurn?: {
+        reconcile(): void;
+        deliverIfPending(key: SessionKey): Promise<void>;
+        discardInbox(key: SessionKey): void;
+    };
+    now?: () => number;
+    pollIntervalMs?: number;
+}
+export declare class TodoReminderEngine {
+    private readonly deps;
+    private timer;
+    private lastPollAt;
+    /** Whether each conversation's session was busy at the previous poll. */
+    private readonly wasBusy;
+    /** Conversations whose reminder post is under way: never two at once. */
+    private readonly posting;
+    private readonly now;
+    private readonly pollIntervalMs;
+    constructor(deps: TodoReminderEngineDeps);
+    start(): void;
+    /** @description The conversation's agent produced output: a turn is under way, even one shorter than a poll. */
+    noteAgentOutput(key: SessionKey): void;
+    stop(): void;
+    /** @description One poll over every conversation (exposed for tests). */
+    poll(): Promise<void>;
+    private pollConversation;
+    /**
+     * @description The adapter reported a turn's end (json-stream `turnEnded`, every terminal `result`). A poll can miss
+     * it — the per-turn lifecycle stops the process right after, before the next poll finds it idle — so the event is a
+     * turn end of its own; a turn whose end is held (unread input, a compaction) is left to the poll.
+     */
+    noteAdapterTurnEnd(key: SessionKey): Promise<void>;
+    /**
+     * A waiting inbox is withdrawn: its changes stay unseen and ride the next prompt. So the inbox dir is empty between
+     * turns, and the hook starts no `node` for any other session's tool call meanwhile.
+     */
+    private discardInbox;
+    private handleTurnEnd;
+}
+//# sourceMappingURL=reminderEngine.d.ts.map

package/dist/todos/reminderEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reminderEngine.d.ts","sourceRoot":"","sources":["../../src/todos/reminderEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;;;GAWG;AAEH,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAOzC;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,aAAa,GAAG,aAAa,GAAG,0BAA0B,GAAG,uBAAuB,CAAC,CAAC;IACnH,iBAAiB,EAAE,MAAM,UAAU,EAAE,CAAC;IACtC,SAAS,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,gBAAgB,CAAC;IACjD,OAAO,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC,kBAAkB,EAAE,MAAM,gBAAgB,CAAC,CAAC;IAC/E,aAAa,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACnC,0EAA0E;IAC1E,cAAc,EAAE,MAAM,OAAO,CAAC;IAC9B,YAAY,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE;;;OAGG;IACH,OAAO,CAAC,EAAE;QAAE,SAAS,IAAI,IAAI,CAAC;QAAC,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAAA;KAAE,CAAC;IACvH,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAOD,qBAAa,kBAAkB;IAUjB,OAAO,CAAC,QAAQ,CAAC,IAAI;IATjC,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,UAAU,CAAuB;IACzC,yEAAyE;IACzE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,yEAAyE;IACzE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAEX,IAAI,EAAE,sBAAsB;IAKzD,KAAK,IAAI,IAAI;IASb,gHAAgH;IAChH,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;IAItC,IAAI,IAAI,IAAI;IAKZ,yEAAyE;IACnE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAoBb,gBAAgB;IA2B9B;;;;OAIG;IACG,kBAAkB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxD;;;OAGG;IACH,OAAO,CAAC,YAAY;YAQN,aAAa;CAqB5B"}

package/dist/todos/reminderEngine.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TodoReminderEngine = exports.todoReminderPollMs = void 0;
+const sessionKey_1 = require("../sessionKey");
+/**
+ * @description The timer side of the staleness reminder (D10–D12). The conversations' sessions are POLLED like the
+ * wake-up engine's watched turns: each poll adds the WORKING time to the conversation's work — busy, and nothing
+ * holding the turn (a session waiting on a question is busy, but its agent does nothing) —, and a busy → idle edge is
+ * a turn end. The adapter's own turn end (`noteAdapterTurnEnd`, json-stream's `turnEnded`) is one too: the per-turn
+ * lifecycle stops the process right after it, before a poll could find it idle. A turn end starts the reminder's
+ * clock (the first one after an update) and, when the list is stale and every gate holds, posts the standalone
+ * reminder. Every decision is the
+ * registry's (`nag.ts`); this module only observes and acts. A failure in one conversation is logged and never stops
+ * the others. The same poll hands a busy session the project board's changes mid-turn (`midTurn.ts`) — it runs while
+ * the shared lists are on, the reminder off or not.
+ */
+/** How often the sessions are polled — the wake-up engine's turn poll. */
+exports.todoReminderPollMs = 10_000;
+/**
+ * A poll that comes much later than due (a suspended host, a blocked event loop) counts at most this many intervals
+ * of work: the gap was not observed as work.
+ */
+const maxCountedPollIntervals = 3;
+/** @description Whether the session stands at a settled turn end: live, idle, nothing holding the turn, nothing unread. */
+function checkIsSettledTurnEnd(probe) {
+    return probe.isActive && !probe.isBusy && !probe.isTurnEndBlocked && probe.hasUnconsumedInput !== true;
+}
+class TodoReminderEngine {
+    deps;
+    timer = null;
+    lastPollAt = null;
+    /** Whether each conversation's session was busy at the previous poll. */
+    wasBusy = new Map();
+    /** Conversations whose reminder post is under way: never two at once. */
+    posting = new Set();
+    now;
+    pollIntervalMs;
+    constructor(deps) {
+        this.deps = deps;
+        this.now = deps.now ?? Date.now;
+        this.pollIntervalMs = deps.pollIntervalMs ?? exports.todoReminderPollMs;
+    }
+    start() {
+        if (this.timer)
+            return;
+        this.lastPollAt = this.now();
+        this.timer = setInterval(() => {
+            void this.poll().catch((e) => console.warn('[todos] reminder poll failed:', e instanceof Error ? e.message : e));
+        }, this.pollIntervalMs);
+        this.timer.unref();
+    }
+    /** @description The conversation's agent produced output: a turn is under way, even one shorter than a poll. */
+    noteAgentOutput(key) {
+        this.wasBusy.set((0, sessionKey_1.keyToString)(key), true);
+    }
+    stop() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = null;
+    }
+    /** @description One poll over every conversation (exposed for tests). */
+    async poll() {
+        const nowMs = this.now();
+        const elapsedMs = Math.min(nowMs - (this.lastPollAt ?? nowMs), maxCountedPollIntervals * this.pollIntervalMs);
+        this.lastPollAt = nowMs;
+        // Off: nothing is counted, and a turn seen busy now is not an end later.
+        if (!this.deps.checkIsEnabled()) {
+            this.wasBusy.clear();
+            return;
+        }
+        const intervalMs = this.deps.getIntervalMs();
+        this.deps.midTurn?.reconcile();
+        for (const key of this.deps.listConversations()) {
+            try {
+                await this.pollConversation(key, nowMs, elapsedMs, intervalMs);
+            }
+            catch (e) {
+                console.warn(`[todos] reminder poll of ${(0, sessionKey_1.keyToString)(key)} failed:`, e instanceof Error ? e.message : e);
+            }
+        }
+    }
+    async pollConversation(key, nowMs, elapsedMs, intervalMs) {
+        const conversationKey = (0, sessionKey_1.keyToString)(key);
+        const probe = this.deps.probeTurn(key);
+        const wasBusy = this.wasBusy.get(conversationKey) === true;
+        this.wasBusy.set(conversationKey, probe.isBusy);
+        if (probe.isBusy) {
+            // A turn held open (a question waiting for the operator, a compaction) is no work of the agent's, and makes no
+            // tool call that could take an inbox: the changes wait for the turn to go on.
+            if (probe.isTurnEndBlocked) {
+                this.discardInbox(key);
+                return;
+            }
+            this.deps.registry.addTurnWork(key, elapsedMs);
+            await this.deps.midTurn?.deliverIfPending(key);
+            return;
+        }
+        const isTurnEnd = wasBusy && checkIsSettledTurnEnd(probe);
+        if (!isTurnEnd) {
+            // A turn whose end is held (a question, a compaction, unread input) ends at a later poll.
+            if (wasBusy && probe.isActive)
+                this.wasBusy.set(conversationKey, true);
+            // A session that ended mid-turn (a stop, a crash) makes no more tool calls.
+            if (wasBusy && !probe.isActive)
+                this.discardInbox(key);
+            return;
+        }
+        await this.handleTurnEnd(key, probe, nowMs, intervalMs);
+    }
+    /**
+     * @description The adapter reported a turn's end (json-stream `turnEnded`, every terminal `result`). A poll can miss
+     * it — the per-turn lifecycle stops the process right after, before the next poll finds it idle — so the event is a
+     * turn end of its own; a turn whose end is held (unread input, a compaction) is left to the poll.
+     */
+    async noteAdapterTurnEnd(key) {
+        if (!this.deps.checkIsEnabled())
+            return;
+        const probe = this.deps.probeTurn(key);
+        if (!checkIsSettledTurnEnd(probe))
+            return;
+        this.wasBusy.set((0, sessionKey_1.keyToString)(key), false);
+        await this.handleTurnEnd(key, probe, this.now(), this.deps.getIntervalMs());
+    }
+    /**
+     * A waiting inbox is withdrawn: its changes stay unseen and ride the next prompt. So the inbox dir is empty between
+     * turns, and the hook starts no `node` for any other session's tool call meanwhile.
+     */
+    discardInbox(key) {
+        try {
+            this.deps.midTurn?.discardInbox(key);
+        }
+        catch (e) {
+            console.warn(`[todos] ${(0, sessionKey_1.keyToString)(key)}: the mid-turn inbox could not be withdrawn:`, e instanceof Error ? e.message : e);
+        }
+    }
+    async handleTurnEnd(key, probe, nowMs, intervalMs) {
+        const conversationKey = (0, sessionKey_1.keyToString)(key);
+        this.discardInbox(key);
+        this.deps.registry.noteTurnEnd(key, nowMs);
+        if (this.posting.has(conversationKey))
+            return;
+        const decision = this.deps.registry.decideStandaloneReminder(key, intervalMs, { ...probe, ...this.deps.getGate(key) }, nowMs);
+        if (!decision.shouldRemind) {
+            // A due reminder that a gate holds back is worth one line per turn end; a list that is not due is not.
+            if (decision.isStale)
+                console.log(`[todos] ${conversationKey}: stale list, no reminder: ${decision.skipReasons.join(', ')}`);
+            return;
+        }
+        this.posting.add(conversationKey);
+        try {
+            if (await this.deps.postReminder(key, decision.text)) {
+                this.deps.registry.noteReminderDelivered(key, this.now());
+                console.log(`[todos] ${conversationKey}: stale list — reminded the agent`);
+            }
+        }
+        finally {
+            this.posting.delete(conversationKey);
+        }
+    }
+}
+exports.TodoReminderEngine = TodoReminderEngine;
+//# sourceMappingURL=reminderEngine.js.map

package/dist/todos/reminderEngine.js.map

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

package/dist/todos/store.d.ts

@@ -0,0 +1,34 @@
+import { type SessionKey } from '../sessionKey';
+import { type TodoItem, type TodoTopicFile } from './types';
+/** A closed item older than this leaves the live file for the archive. */
+export declare const todoArchiveAfterMs: number;
+/** @description `DATA_DIR/todos`: the lists, their archive, the mid-turn inboxes and the repositories' first commits. */
+export declare function getTodosDir(dataDir: string): string;
+/** @description The empty record of a conversation that never published anything. */
+export declare function createEmptyTodoTopicFile(key: SessionKey): TodoTopicFile;
+/**
+ * @description Split `file` into what stays live and the closed items old enough for the archive (closed before
+ * `nowMs - todoArchiveAfterMs`).
+ */
+export declare function getTodoArchiveSplit(file: TodoTopicFile, nowMs: number): {
+    file: TodoTopicFile;
+    archived: TodoItem[];
+};
+/** @name TodoStore @description The file store over one data dir. */
+export declare class TodoStore {
+    private readonly dataDir;
+    private readonly getNowMs;
+    private readonly files;
+    constructor(dataDir: string, getNowMs?: () => number);
+    private getDir;
+    private getFilePath;
+    private getArchivePath;
+    /** @description The conversation's record; the empty one when it never published (nothing is written for that). */
+    getTopic(key: SessionKey): TodoTopicFile;
+    private readTopicFile;
+    /** @description Store the conversation's record: old closed items go to the archive first. */
+    saveTopic(key: SessionKey, file: TodoTopicFile): TodoTopicFile;
+    /** @description The newest `limit` archived items of the conversation, the most recently closed first. */
+    readArchivedItems(key: SessionKey, limit: number): TodoItem[];
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/todos/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/todos/store.ts"],"names":[],"mappings":"AAIA,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAExE,OAAO,EAA6B,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAqBvF,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,QAA2B,CAAC;AAmC3D,yHAAyH;AACzH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,qFAAqF;AACrF,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,UAAU,GAAG,aAAa,CAEvE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,QAAQ,EAAE,CAAA;CAAE,CAMrH;AAED,qEAAqE;AACrE,qBAAa,SAAS;IAGR,OAAO,CAAC,QAAQ,CAAC,OAAO;IAAU,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFvE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;gBAE7B,OAAO,EAAE,MAAM,EAAmB,QAAQ,GAAE,MAAM,MAAiB;IAEhG,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,cAAc;IAItB,mHAAmH;IACnH,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,aAAa;IASxC,OAAO,CAAC,aAAa;IAqBrB,8FAA8F;IAC9F,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,GAAG,aAAa;IAa9D,0GAA0G;IAC1G,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE;CAmB9D"}

package/dist/todos/store.js

@@ -0,0 +1,208 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TodoStore = exports.todoArchiveAfterMs = void 0;
+exports.getTodosDir = getTodosDir;
+exports.createEmptyTodoTopicFile = createEmptyTodoTopicFile;
+exports.getTodoArchiveSplit = getTodoArchiveSplit;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const zod_1 = require("zod");
+const configDirFile_1 = require("../configDirFile");
+const sessionKey_1 = require("../sessionKey");
+const order_1 = require("./order");
+const types_1 = require("./types");
+/**
+ * @description The file store of the todo registry — the truth and the full history (D26). One JSON file per
+ * conversation, `DATA_DIR/todos/<conversation slug>.json`, written atomically (a temp file and a rename) and cached in
+ * memory: the bot is the only writer and every call is synchronous, so two writes can never interleave. A closed
+ * item older than {@link todoArchiveAfterMs} moves to `todos/archive/<slug>.jsonl` at the next save, one line per
+ * item, so the live file stays small and nothing is ever deleted.
+ *
+ * A file that cannot be read is set aside (`<name>.corrupt-<time>`) with one error line and the conversation starts
+ * from an empty list — a broken file must neither stop the bot nor be overwritten unseen.
+ */
+/** The store's directory under `DATA_DIR`. */
+const todosDirName = 'todos';
+/** Where archived items go, under the store's directory. */
+const archiveDirName = 'archive';
+/** `:` is illegal in a file name on some filesystems; the slug uses this instead. */
+const conversationSlugSeparator = '_';
+const todoFileExtension = '.json';
+const archiveFileExtension = '.jsonl';
+/** A closed item older than this leaves the live file for the archive. */
+exports.todoArchiveAfterMs = 30 * 24 * 60 * 60 * 1000;
+/** Private content of the operator's work: readable by the bot's user only. */
+const todoFileMode = 0o600;
+const todoItemSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    title: zod_1.z.string(),
+    status: zod_1.z.enum(types_1.todoStatuses),
+    note: zod_1.z.string().optional(),
+    source: zod_1.z.enum(types_1.todoSources),
+    ref: zod_1.z.string().optional(),
+    createdAt: zod_1.z.number(),
+    updatedAt: zod_1.z.number(),
+    startedAt: zod_1.z.number().optional(),
+    closedAt: zod_1.z.number().optional(),
+});
+const todoTopicFileSchema = zod_1.z.object({
+    version: zod_1.z.literal(1),
+    conversationKey: zod_1.z.string(),
+    nextItemNumber: zod_1.z.number().int().positive(),
+    items: zod_1.z.array(todoItemSchema),
+    revision: zod_1.z.number().int().nonnegative(),
+    changedAt: zod_1.z.number().optional(),
+    lastUpdateAt: zod_1.z.number().optional(),
+    nag: zod_1.z.object({
+        clockStartedAt: zod_1.z.number().optional(),
+        workedMs: zod_1.z.number().nonnegative(),
+        ignoredCount: zod_1.z.number().int().nonnegative(),
+        lastRemindedAt: zod_1.z.number().optional(),
+    }).optional(),
+    lastTurnEndAt: zod_1.z.number().optional(),
+    boardSeen: zod_1.z.object({ revisions: zod_1.z.record(zod_1.z.string(), zod_1.z.number()), at: zod_1.z.number() }).optional(),
+});
+/** @description `DATA_DIR/todos`: the lists, their archive, the mid-turn inboxes and the repositories' first commits. */
+function getTodosDir(dataDir) {
+    return path.join(dataDir, todosDirName);
+}
+/** @description The empty record of a conversation that never published anything. */
+function createEmptyTodoTopicFile(key) {
+    return { version: 1, conversationKey: (0, sessionKey_1.keyToString)(key), nextItemNumber: 1, items: [], revision: 0 };
+}
+/**
+ * @description Split `file` into what stays live and the closed items old enough for the archive (closed before
+ * `nowMs - todoArchiveAfterMs`).
+ */
+function getTodoArchiveSplit(file, nowMs) {
+    const archiveBefore = nowMs - exports.todoArchiveAfterMs;
+    const isArchived = (item) => !(0, order_1.checkIsOpenTodoItem)(item) && (item.closedAt ?? item.updatedAt) < archiveBefore;
+    const archived = file.items.filter(isArchived);
+    if (archived.length === 0)
+        return { file, archived };
+    return { file: { ...file, items: file.items.filter((item) => !isArchived(item)) }, archived };
+}
+/** @name TodoStore @description The file store over one data dir. */
+class TodoStore {
+    dataDir;
+    getNowMs;
+    files = new Map();
+    constructor(dataDir, getNowMs = Date.now) {
+        this.dataDir = dataDir;
+        this.getNowMs = getNowMs;
+    }
+    getDir() {
+        return getTodosDir(this.dataDir);
+    }
+    getFilePath(key) {
+        return path.join(this.getDir(), `${(0, sessionKey_1.keyToSlug)(key, conversationSlugSeparator)}${todoFileExtension}`);
+    }
+    getArchivePath(key) {
+        return path.join(this.getDir(), archiveDirName, `${(0, sessionKey_1.keyToSlug)(key, conversationSlugSeparator)}${archiveFileExtension}`);
+    }
+    /** @description The conversation's record; the empty one when it never published (nothing is written for that). */
+    getTopic(key) {
+        const conversationKey = (0, sessionKey_1.keyToString)(key);
+        const cached = this.files.get(conversationKey);
+        if (cached)
+            return cached;
+        const loaded = this.readTopicFile(key);
+        this.files.set(conversationKey, loaded);
+        return loaded;
+    }
+    readTopicFile(key) {
+        const filePath = this.getFilePath(key);
+        let text;
+        try {
+            text = fs.readFileSync(filePath, 'utf8');
+        }
+        catch (e) {
+            if (e instanceof Error && 'code' in e && e.code === 'ENOENT')
+                return createEmptyTodoTopicFile(key);
+            throw e;
+        }
+        try {
+            const parsed = todoTopicFileSchema.parse(JSON.parse(text));
+            if (parsed.conversationKey !== (0, sessionKey_1.keyToString)(key))
+                throw new Error(`it belongs to ${parsed.conversationKey}`);
+            return parsed;
+        }
+        catch (e) {
+            const asidePath = `${filePath}.corrupt-${this.getNowMs()}`;
+            fs.renameSync(filePath, asidePath);
+            console.error(`[todos] ${filePath} is unreadable (${e instanceof Error ? e.message : String(e)}); set aside as ${asidePath}, the list starts empty`);
+            return createEmptyTodoTopicFile(key);
+        }
+    }
+    /** @description Store the conversation's record: old closed items go to the archive first. */
+    saveTopic(key, file) {
+        const split = getTodoArchiveSplit(file, this.getNowMs());
+        if (split.archived.length > 0) {
+            const archivePath = this.getArchivePath(key);
+            fs.mkdirSync(path.dirname(archivePath), { recursive: true, mode: 0o700 });
+            fs.appendFileSync(archivePath, split.archived.map((item) => `${JSON.stringify(item)}\n`).join(''), { mode: todoFileMode });
+        }
+        fs.mkdirSync(this.getDir(), { recursive: true, mode: 0o700 });
+        (0, configDirFile_1.writeJsonFileAtomically)(this.getFilePath(key), split.file, todoFileMode);
+        this.files.set((0, sessionKey_1.keyToString)(key), split.file);
+        return split.file;
+    }
+    /** @description The newest `limit` archived items of the conversation, the most recently closed first. */
+    readArchivedItems(key, limit) {
+        let text;
+        try {
+            text = fs.readFileSync(this.getArchivePath(key), 'utf8');
+        }
+        catch {
+            return [];
+        }
+        const items = text.split('\n').flatMap((line) => {
+            if (line.trim() === '')
+                return [];
+            try {
+                const parsed = todoItemSchema.safeParse(JSON.parse(line));
+                return parsed.success ? [parsed.data] : [];
+            }
+            catch {
+                // A torn last line (a crash mid-append) is skipped; the lines before it are whole.
+                return [];
+            }
+        });
+        return items.sort((left, right) => (right.closedAt ?? 0) - (left.closedAt ?? 0)).slice(0, limit);
+    }
+}
+exports.TodoStore = TodoStore;
+//# sourceMappingURL=store.js.map

package/dist/todos/store.js.map

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