charness 3.6.1 → 3.8.0

package/dist/todos/projects.d.ts

@@ -0,0 +1,102 @@
+/**
+ * @description Which conversations share a project board (D15, D16, D57) — automatic by repository:
+ *
+ *   a Telegram topic   → its bound folder's git repository, by ROOT COMMIT (remote names differ between checkouts,
+ *                        worktrees share it); a folder that is not a git checkout is a project of its own folder —
+ *                        so two topics on one folder are always together
+ *   a Jira conversation → the repository NAMES its `jira.json` project lists (`repos`); conversations of projects
+ *                        that share a name are one board, and a topic whose repository folder has that name joins
+ *                        it; projects without `repos` all share one board per instance
+ *   a topic's override  → "join the project of topic X" or "own project" (`state.json` `todoProjectOverrides`)
+ *
+ * The grouping is a union-find over keys each conversation holds; a topic's repository NAME joins the union only
+ * when some Jira conversation names it, so two unrelated repositories that happen to share a folder name never meet.
+ */
+/** How long a folder's repository is trusted before git is asked again (a folder may become a checkout, or move). */
+export declare const repositoryIdentityTtlMs: number;
+/** A read that failed (git missing, slow, the folder gone) is tried again this soon — a project must not split for long. */
+export declare const failedRepositoryReadRetryMs: number;
+/** @name RepositoryIdentity @description What makes two folders one repository, and what it is called. */
+export interface RepositoryIdentity {
+    /** The first (sorted) root commit — the same in every clone and worktree. */
+    rootCommit: string;
+    /** The main repository's folder name (a worktree's or a submodule's repository, not the worktree's own folder). */
+    repositoryName: string;
+}
+/** @name TodoProjectOverride @description A topic's choice in the project picker; absent = automatic. */
+export type TodoProjectOverride = {
+    kind: 'own';
+} | {
+    kind: 'join';
+    conversationKey: string;
+};
+/**
+ * @name TodoProjectMember
+ * @description A conversation as the grouping sees it. `workDir` = a topic's bound folder (absolute); a Jira
+ * conversation carries `jiraRepositoryNames` instead (`null` = its project lists no `repos`).
+ */
+export interface TodoProjectMember {
+    conversationKey: string;
+    workDir: string | null;
+    identity: RepositoryIdentity | null;
+    jiraRepositoryNames?: readonly string[] | null;
+}
+/** @name TodoProject @description One board: its name, its members in binding order, and how it was formed. */
+export interface TodoProject {
+    name: string;
+    memberKeys: string[];
+}
+/** @description Run git in `workDir` within `timeoutMs`; its trimmed stdout, or `null` when it failed or ran too long. */
+export type RunGit = (workDir: string, args: readonly string[], timeoutMs: number) => Promise<string | null>;
+/** @description The real git. */
+export declare const runGitInFolder: RunGit;
+/** @description The repository's own folder name from git's common dir (`…/repo/.git`, a submodule's `…/modules/repo`, a bare `repo.git`). */
+export declare function getRepositoryNameFromCommonDir(commonDir: string): string;
+/**
+ * @name RepositoryRootCommitStore
+ * @description Where the root commits outlive the process, by git common dir: the LAST KNOWN answer, at once after a
+ * restart while the process walks the history again (the one slow read) — a rewritten history changes it.
+ */
+export interface RepositoryRootCommitStore {
+    load(): Record<string, string>;
+    save(rootCommits: Readonly<Record<string, string>>): void;
+}
+/**
+ * @description The root commits kept in `<todosDir>/repositories.json`. It is a cache: an unreadable file is logged
+ * and read as empty (the next walk rewrites it).
+ */
+export declare function createRepositoryRootCommitFile(todosDir: string, logWarning?: (line: string) => void): RepositoryRootCommitStore;
+/** @name RepositoryIdentityReaderDeps @description Git, the clock, where a warning goes and where root commits persist. */
+export interface RepositoryIdentityReaderDeps {
+    runGit: RunGit;
+    getNowMs?: () => number;
+    logWarning?: (line: string) => void;
+    rootCommitStore?: RepositoryRootCommitStore;
+}
+/** @name RepositoryIdentityReader @description A folder's repository: waited for, or only what is known now. */
+export interface RepositoryIdentityReader {
+    /** The folder's repository (`null` = none, or git failed), asking git when the cached read is stale; a read in progress is shared. */
+    read(workDir: string): Promise<RepositoryIdentity | null>;
+    /**
+     * What is known NOW, never waiting for git: the last read's answer — kept past its TTL while a refresh runs in the
+     * background — or `undefined` when the folder was never read (a read starts).
+     */
+    peek(workDir: string): RepositoryIdentity | null | undefined;
+}
+/**
+ * @description A reader of folders' repository identities. Two cheap-to-expensive steps, cached apart: a folder's
+ * git common dir (`git rev-parse --git-common-dir`, resolved against the folder — no `--path-format`, which needs git
+ * 2.31) for {@link repositoryIdentityTtlMs}, and the repository's root commit by its common dir: the history walk
+ * runs once per repository and process, shared by every folder of it. With a {@link RepositoryRootCommitStore}, the
+ * root commit a previous process walked answers at once while this process walks again in the background — a
+ * rewritten history (or a folder re-initialised at the same path) is corrected by the next process, and logged.
+ * Two reads of one folder at once share one git run. A failed read is tried again after
+ * {@link failedRepositoryReadRetryMs}, and a failure on a folder that IS a checkout (it has `.git`) is logged once.
+ */
+export declare function createRepositoryIdentityReader(deps: RepositoryIdentityReaderDeps): RepositoryIdentityReader;
+/**
+ * @description Group `members` (in binding order) into projects. `overrides` by conversation key; an override that
+ * names a conversation not among the members falls back to automatic.
+ */
+export declare function groupTodoProjects(members: readonly TodoProjectMember[], overrides: Readonly<Record<string, TodoProjectOverride>>): TodoProject[];
+//# sourceMappingURL=projects.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/todos/projects.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;GAaG;AAEH,qHAAqH;AACrH,eAAO,MAAM,uBAAuB,QAAiB,CAAC;AACtD,4HAA4H;AAC5H,eAAO,MAAM,2BAA2B,QAAY,CAAC;AAYrD,0GAA0G;AAC1G,MAAM,WAAW,kBAAkB;IACjC,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,mHAAmH;IACnH,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,yGAAyG;AACzG,MAAM,MAAM,mBAAmB,GAAG;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9F;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACpC,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;CAChD;AAED,+GAA+G;AAC/G,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,0HAA0H;AAC1H,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAI7G,iCAAiC;AACjC,eAAO,MAAM,cAAc,EAAE,MAO5B,CAAC;AAEF,8IAA8I;AAC9I,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIxE;AAaD;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC;CAC3D;AAOD;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAmC,GAAG,yBAAyB,CAwB7J;AAED,2HAA2H;AAC3H,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,eAAe,CAAC,EAAE,yBAAyB,CAAC;CAC7C;AAED,gHAAgH;AAChH,MAAM,WAAW,wBAAwB;IACvC,sIAAsI;IACtI,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAC1D;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,GAAG,SAAS,CAAC;CAC9D;AAWD;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,4BAA4B,GAAG,wBAAwB,CAsH3G;AA2BD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,GAAG,WAAW,EAAE,CAsChJ"}

package/dist/todos/projects.js

@@ -0,0 +1,342 @@
+"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.runGitInFolder = exports.failedRepositoryReadRetryMs = exports.repositoryIdentityTtlMs = void 0;
+exports.getRepositoryNameFromCommonDir = getRepositoryNameFromCommonDir;
+exports.createRepositoryRootCommitFile = createRepositoryRootCommitFile;
+exports.createRepositoryIdentityReader = createRepositoryIdentityReader;
+exports.groupTodoProjects = groupTodoProjects;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const util_1 = require("util");
+const zod_1 = require("zod");
+const configDirFile_1 = require("../configDirFile");
+/**
+ * @description Which conversations share a project board (D15, D16, D57) — automatic by repository:
+ *
+ *   a Telegram topic   → its bound folder's git repository, by ROOT COMMIT (remote names differ between checkouts,
+ *                        worktrees share it); a folder that is not a git checkout is a project of its own folder —
+ *                        so two topics on one folder are always together
+ *   a Jira conversation → the repository NAMES its `jira.json` project lists (`repos`); conversations of projects
+ *                        that share a name are one board, and a topic whose repository folder has that name joins
+ *                        it; projects without `repos` all share one board per instance
+ *   a topic's override  → "join the project of topic X" or "own project" (`state.json` `todoProjectOverrides`)
+ *
+ * The grouping is a union-find over keys each conversation holds; a topic's repository NAME joins the union only
+ * when some Jira conversation names it, so two unrelated repositories that happen to share a folder name never meet.
+ */
+/** How long a folder's repository is trusted before git is asked again (a folder may become a checkout, or move). */
+exports.repositoryIdentityTtlMs = 10 * 60 * 1000;
+/** A read that failed (git missing, slow, the folder gone) is tried again this soon — a project must not split for long. */
+exports.failedRepositoryReadRetryMs = 30 * 1000;
+/** `git rev-parse` answers at once; a longer one is abandoned. */
+const gitQuickQueryTimeoutMs = 5000;
+/** `git rev-list --max-parents=0` walks the whole history: a large repository needs longer, once per process. */
+const gitHistoryQueryTimeoutMs = 30 * 1000;
+const gitDirName = '.git';
+const gitDirSuffix = '.git';
+/** The board every Jira conversation of a project without `repos` shares. */
+const sharedJiraBoardKey = 'jira:shared';
+/** The name of a project none of whose members has a folder name (only such Jira conversations). */
+const unnamedJiraProjectName = 'jira';
+const execFileAsync = (0, util_1.promisify)(child_process_1.execFile);
+/** @description The real git. */
+const runGitInFolder = async (workDir, args, timeoutMs) => {
+    try {
+        const { stdout } = await execFileAsync('git', ['-C', workDir, ...args], { timeout: timeoutMs, encoding: 'utf8' });
+        return stdout.trim();
+    }
+    catch {
+        return null;
+    }
+};
+exports.runGitInFolder = runGitInFolder;
+/** @description The repository's own folder name from git's common dir (`…/repo/.git`, a submodule's `…/modules/repo`, a bare `repo.git`). */
+function getRepositoryNameFromCommonDir(commonDir) {
+    const baseName = path.basename(commonDir);
+    if (baseName === gitDirName)
+        return path.basename(path.dirname(commonDir));
+    return baseName.endsWith(gitDirSuffix) ? baseName.slice(0, -gitDirSuffix.length) : baseName;
+}
+/** @description Whether a cached read still stands: a success for `ttlMs`, a failure only for the short retry window. */
+function checkIsReadFresh(cached, nowMs, ttlMs) {
+    return cached !== undefined && nowMs - cached.readAt < (cached.value === null ? exports.failedRepositoryReadRetryMs : ttlMs);
+}
+/** The root commits' file under the store's directory (`DATA_DIR/todos`). */
+const rootCommitFileName = 'repositories.json';
+const rootCommitFileMode = 0o600;
+const rootCommitFileSchema = zod_1.z.object({ version: zod_1.z.literal(1), rootCommits: zod_1.z.record(zod_1.z.string(), zod_1.z.string()) });
+/**
+ * @description The root commits kept in `<todosDir>/repositories.json`. It is a cache: an unreadable file is logged
+ * and read as empty (the next walk rewrites it).
+ */
+function createRepositoryRootCommitFile(todosDir, logWarning = (line) => console.warn(line)) {
+    const filePath = path.join(todosDir, rootCommitFileName);
+    return {
+        load() {
+            let text;
+            try {
+                text = fs.readFileSync(filePath, 'utf8');
+            }
+            catch (e) {
+                if (e instanceof Error && 'code' in e && e.code === 'ENOENT')
+                    return {};
+                logWarning(`[todos] ${filePath} could not be read (${e instanceof Error ? e.message : String(e)}); the repositories' first commits are read from git again`);
+                return {};
+            }
+            try {
+                return rootCommitFileSchema.parse(JSON.parse(text)).rootCommits;
+            }
+            catch {
+                logWarning(`[todos] ${filePath} is unreadable; the repositories' first commits are read from git again`);
+                return {};
+            }
+        },
+        save(rootCommits) {
+            fs.mkdirSync(todosDir, { recursive: true, mode: 0o700 });
+            (0, configDirFile_1.writeJsonFileAtomically)(filePath, { version: 1, rootCommits }, rootCommitFileMode);
+        },
+    };
+}
+/**
+ * @description A reader of folders' repository identities. Two cheap-to-expensive steps, cached apart: a folder's
+ * git common dir (`git rev-parse --git-common-dir`, resolved against the folder — no `--path-format`, which needs git
+ * 2.31) for {@link repositoryIdentityTtlMs}, and the repository's root commit by its common dir: the history walk
+ * runs once per repository and process, shared by every folder of it. With a {@link RepositoryRootCommitStore}, the
+ * root commit a previous process walked answers at once while this process walks again in the background — a
+ * rewritten history (or a folder re-initialised at the same path) is corrected by the next process, and logged.
+ * Two reads of one folder at once share one git run. A failed read is tried again after
+ * {@link failedRepositoryReadRetryMs}, and a failure on a folder that IS a checkout (it has `.git`) is logged once.
+ */
+function createRepositoryIdentityReader(deps) {
+    const { runGit, getNowMs = Date.now, logWarning = (line) => console.warn(line), rootCommitStore } = deps;
+    const commonDirs = new Map();
+    /** The root commits THIS process walked, by common dir (a failure is kept for the retry window). */
+    const walkedRootCommits = new Map();
+    /** Every root commit known by common dir — the store's, then this process's walks; what the store gets back. */
+    let knownRootCommits = null;
+    const lastIdentities = new Map();
+    const readsInProgress = new Map();
+    const walksInProgress = new Map();
+    const warnedFolders = new Set();
+    function getKnownRootCommits() {
+        knownRootCommits ??= new Map(Object.entries(rootCommitStore?.load() ?? {}));
+        return knownRootCommits;
+    }
+    function storeRootCommits() {
+        if (!rootCommitStore)
+            return;
+        try {
+            rootCommitStore.save(Object.fromEntries(getKnownRootCommits()));
+        }
+        catch (e) {
+            logWarning(`[todos] the repositories' first commits could not be stored: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    function warnOnceIfCheckout(workDir, what) {
+        if (warnedFolders.has(workDir) || !fs.existsSync(path.join(workDir, gitDirName)))
+            return;
+        warnedFolders.add(workDir);
+        logWarning(`[todos] git could not read ${what} of ${workDir}: its topic is a project of its own until it can`);
+    }
+    function getKnownIdentity(workDir) {
+        const nowMs = getNowMs();
+        const commonDir = commonDirs.get(workDir);
+        if (!checkIsReadFresh(commonDir, nowMs, exports.repositoryIdentityTtlMs))
+            return { kind: 'due', lastIdentity: lastIdentities.get(workDir) };
+        if (commonDir.value === null)
+            return { kind: 'fresh', identity: null };
+        const walked = walkedRootCommits.get(commonDir.value);
+        const isWalked = checkIsReadFresh(walked, nowMs, Number.POSITIVE_INFINITY);
+        // A walk that failed leaves the last known root in place: a slow or broken git never splits a known repository.
+        const rootCommit = walked?.value ?? getKnownRootCommits().get(commonDir.value) ?? null;
+        const identity = rootCommit === null ? null : { rootCommit, repositoryName: getRepositoryNameFromCommonDir(commonDir.value) };
+        if (isWalked)
+            return { kind: 'fresh', identity };
+        return identity === null ? { kind: 'due', lastIdentity: lastIdentities.get(workDir) } : { kind: 'stored', identity };
+    }
+    /** The history walk of one repository, shared by its folders while it runs. */
+    function walkRootCommit(commonDir, workDir) {
+        const inProgress = walksInProgress.get(commonDir);
+        if (inProgress)
+            return inProgress;
+        const walk = (async () => {
+            const roots = await runGit(workDir, ['rev-list', '--max-parents=0', 'HEAD'], gitHistoryQueryTimeoutMs);
+            const firstRoot = roots?.split('\n').map((line) => line.trim()).filter((line) => line !== '').sort()[0] ?? null;
+            walkedRootCommits.set(commonDir, { value: firstRoot, readAt: getNowMs() });
+            if (firstRoot === null) {
+                warnOnceIfCheckout(workDir, 'the first commit');
+                return;
+            }
+            const previous = getKnownRootCommits().get(commonDir);
+            if (previous === firstRoot)
+                return;
+            if (previous !== undefined)
+                logWarning(`[todos] the first commit of ${commonDir} changed (its history was rewritten): its topics are grouped by the new one`);
+            getKnownRootCommits().set(commonDir, firstRoot);
+            storeRootCommits();
+        })().finally(() => walksInProgress.delete(commonDir));
+        walksInProgress.set(commonDir, walk);
+        return walk;
+    }
+    async function readFromGit(workDir) {
+        let commonDir = commonDirs.get(workDir);
+        if (!checkIsReadFresh(commonDir, getNowMs(), exports.repositoryIdentityTtlMs)) {
+            const output = await runGit(workDir, ['rev-parse', '--git-common-dir'], gitQuickQueryTimeoutMs);
+            commonDir = { value: output ? path.resolve(workDir, output) : null, readAt: getNowMs() };
+            commonDirs.set(workDir, commonDir);
+            if (commonDir.value === null)
+                warnOnceIfCheckout(workDir, 'the repository');
+        }
+        if (commonDir.value !== null && !checkIsReadFresh(walkedRootCommits.get(commonDir.value), getNowMs(), Number.POSITIVE_INFINITY)) {
+            const repositoryDir = commonDir.value;
+            const walk = walkRootCommit(repositoryDir, workDir);
+            // A stored root answers now; the walk corrects it in the background.
+            if (getKnownRootCommits().has(repositoryDir)) {
+                void walk.catch((e) => logWarning(`[todos] the history of ${repositoryDir} could not be walked: ${e instanceof Error ? e.message : String(e)}`));
+            }
+            else {
+                await walk;
+            }
+        }
+        const known = getKnownIdentity(workDir);
+        const identity = known.kind === 'due' ? null : known.identity;
+        lastIdentities.set(workDir, identity);
+        return identity;
+    }
+    function startRead(workDir) {
+        const inProgress = readsInProgress.get(workDir);
+        if (inProgress)
+            return inProgress;
+        const started = readFromGit(workDir).finally(() => readsInProgress.delete(workDir));
+        readsInProgress.set(workDir, started);
+        return started;
+    }
+    function startReadInBackground(workDir) {
+        void startRead(workDir).catch((e) => logWarning(`[todos] the repository of ${workDir} could not be read: ${e instanceof Error ? e.message : String(e)}`));
+    }
+    return {
+        read(workDir) {
+            const known = getKnownIdentity(workDir);
+            if (known.kind === 'due')
+                return startRead(workDir);
+            lastIdentities.set(workDir, known.identity);
+            if (known.kind === 'stored')
+                startReadInBackground(workDir);
+            return Promise.resolve(known.identity);
+        },
+        peek(workDir) {
+            const known = getKnownIdentity(workDir);
+            if (known.kind !== 'fresh')
+                startReadInBackground(workDir);
+            return known.kind === 'due' ? known.lastIdentity : known.identity;
+        },
+    };
+}
+/** @description The keys that put a conversation into a union, before overrides. */
+function getAutomaticKeys(member, jiraNames) {
+    if (member.jiraRepositoryNames !== undefined) {
+        return member.jiraRepositoryNames === null || member.jiraRepositoryNames.length === 0
+            ? [sharedJiraBoardKey]
+            : member.jiraRepositoryNames.map((name) => `name:${name}`);
+    }
+    if (member.identity) {
+        const nameKey = `name:${member.identity.repositoryName}`;
+        return [`root:${member.identity.rootCommit}`, ...(jiraNames.has(nameKey) ? [nameKey] : [])];
+    }
+    return member.workDir === null ? [] : [`folder:${member.workDir}`];
+}
+/** @description What a project is called: its first member's repository folder name (D16). */
+function getProjectName(members) {
+    for (const member of members) {
+        if (member.identity)
+            return member.identity.repositoryName;
+        if (member.workDir !== null)
+            return path.basename(member.workDir);
+        const [firstName] = member.jiraRepositoryNames ?? [];
+        if (firstName !== undefined)
+            return firstName;
+    }
+    return unnamedJiraProjectName;
+}
+/**
+ * @description Group `members` (in binding order) into projects. `overrides` by conversation key; an override that
+ * names a conversation not among the members falls back to automatic.
+ */
+function groupTodoProjects(members, overrides) {
+    const memberKeys = new Set(members.map((member) => member.conversationKey));
+    const jiraNames = new Set(members.flatMap((member) => (member.jiraRepositoryNames ?? []).map((name) => `name:${name}`)));
+    const parents = new Map();
+    const find = (node) => {
+        let root = node;
+        while (parents.get(root) !== undefined && parents.get(root) !== root)
+            root = parents.get(root) ?? root;
+        parents.set(node, root);
+        return root;
+    };
+    const union = (left, right) => {
+        const leftRoot = find(left);
+        const rightRoot = find(right);
+        if (leftRoot !== rightRoot)
+            parents.set(rightRoot, leftRoot);
+    };
+    for (const member of members) {
+        const selfNode = `self:${member.conversationKey}`;
+        parents.set(selfNode, parents.get(selfNode) ?? selfNode);
+        const override = overrides[member.conversationKey];
+        if (override?.kind === 'own')
+            continue;
+        if (override?.kind === 'join' && memberKeys.has(override.conversationKey) && override.conversationKey !== member.conversationKey) {
+            union(`self:${override.conversationKey}`, selfNode);
+            continue;
+        }
+        for (const key of getAutomaticKeys(member, jiraNames)) {
+            if (!parents.has(key))
+                parents.set(key, key);
+            union(key, selfNode);
+        }
+    }
+    const projects = new Map();
+    for (const member of members) {
+        const root = find(`self:${member.conversationKey}`);
+        projects.set(root, [...(projects.get(root) ?? []), member]);
+    }
+    return [...projects.values()].map((projectMembers) => ({
+        name: getProjectName(projectMembers),
+        memberKeys: projectMembers.map((member) => member.conversationKey),
+    }));
+}
+//# sourceMappingURL=projects.js.map

package/dist/todos/projects.js.map

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

package/dist/todos/registry.d.ts

@@ -0,0 +1,64 @@
+import { type SessionKey } from '../sessionKey';
+import { type TodoUpdateArgs } from './merge';
+import { type TodoReminderDecision, type TodoStandaloneGate } from './nag';
+import type { TodoStore } from './store';
+import type { TodoTopicFile } from './types';
+/**
+ * @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). */
+export declare const todoHistoryMaxItems = 50;
+/** What `todo_read` reads: the conversation's own list, or its project's whole board. */
+export declare const todoReadScopes: readonly ["own", "project"];
+export type TodoReadScope = (typeof todoReadScopes)[number];
+/** @name TodoReadArgs @description A `todo_read` call: the own list (optionally with its history) or the project board. */
+export interface TodoReadArgs {
+    scope?: TodoReadScope;
+    includeHistory?: boolean;
+}
+/** @description What a `todo_*` tool answers. */
+export type TodoToolOutcome = {
+    ok: true;
+    message: string;
+} | {
+    ok: false;
+    error: string;
+};
+/** @name TodoRegistryDeps @description The file store and the clock. */
+export interface TodoRegistryDeps {
+    store: TodoStore;
+    getNowMs: () => number;
+}
+/** @name TodoRegistry @description The registry's operations over the conversations' lists. */
+export interface TodoRegistry {
+    updateTodos(key: SessionKey, args: TodoUpdateArgs): TodoToolOutcome;
+    readTodos(key: SessionKey, args: TodoReadArgs): TodoToolOutcome;
+    /** The line a `final` answer's result carries when the list was not touched during the request (D8), else `null`. */
+    getFinalAnswerNote(key: SessionKey, requestCreatedAt: number): string | null;
+    /** The conversation's stored record (the `/todo` view reads it). */
+    getTopic(key: SessionKey): TodoTopicFile;
+    /** The file store itself, for the project board that reads the peers' lists and stores what each agent saw. */
+    getStore(): TodoStore;
+    /** The session was busy for `elapsedMs` (the reminder engine's poll); kept in memory until the turn ends. */
+    addTurnWork(key: SessionKey, elapsedMs: number): void;
+    /** A turn of the conversation ended: the work is stored, and the reminder's clock starts at the first one. */
+    noteTurnEnd(key: SessionKey, nowMs: number): void;
+    /**
+     * Form a (D11): the reminder line the next prompt carries when the list is stale, else `null`. Taking it counts as
+     * a delivered reminder.
+     */
+    takePromptReminder(key: SessionKey, intervalMs: number | null, nowMs: number): string | null;
+    /** Form b (D12): whether a standalone reminder goes out now, and its text. */
+    decideStandaloneReminder(key: SessionKey, intervalMs: number | null, gate: TodoStandaloneGate, nowMs: number): TodoReminderDecision & {
+        text: string;
+        isStale: boolean;
+    };
+    /** A standalone reminder reached the agent. */
+    noteReminderDelivered(key: SessionKey, nowMs: number): void;
+    /** A person wrote in the conversation: the silence after ignored reminders ends (D13). */
+    notePersonActivity(key: SessionKey): void;
+}
+export declare function createTodoRegistry(deps: TodoRegistryDeps): TodoRegistry;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/todos/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAE7D,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAWL,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACxB,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;GAIG;AAEH,gEAAgE;AAChE,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,yFAAyF;AACzF,eAAO,MAAM,cAAc,6BAA8B,CAAC;AAC1D,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,2HAA2H;AAC3H,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,iDAAiD;AACjD,MAAM,MAAM,eAAe,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3F,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,MAAM,MAAM,CAAC;CACxB;AAED,+FAA+F;AAC/F,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,GAAG,eAAe,CAAC;IACpE,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,GAAG,eAAe,CAAC;IAChE,qHAAqH;IACrH,kBAAkB,CAAC,GAAG,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC7E,oEAAoE;IACpE,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,aAAa,CAAC;IACzC,+GAA+G;IAC/G,QAAQ,IAAI,SAAS,CAAC;IACtB,6GAA6G;IAC7G,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACtD,8GAA8G;IAC9G,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAClD;;;OAGG;IACH,kBAAkB,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC7F,8EAA8E;IAC9E,wBAAwB,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,GAAG,oBAAoB,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IACzK,+CAA+C;IAC/C,qBAAqB,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5D,0FAA0F;IAC1F,kBAAkB,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAAC;CAC3C;AAQD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,CA8FvE"}