@mmnto/cli 1.43.6 → 1.45.0

package/dist/commands/mail.js

@@ -0,0 +1,339 @@
+/**
+ * `totem mail` — canonical cross-repo outbox poll (ADR-106 § 3 / ADR-107).
+ *
+ * Senders write to their own `<repoRoot>/.totem/orchestration/<sender-agent>/outbox/*.md`
+ * with `to: <recipient-agent>` (or `to: broadcast`) in the frontmatter.
+ * Recipients invoke this command at session-start (typically via a
+ * vendor-specific hook in `.claude/hooks/` or `.gemini/hooks/`) to surface
+ * unread mail addressed to themselves.
+ *
+ * SELF_AGENTS resolution flows through `resolveSelfAgents` from
+ * `@mmnto/totem` (env > config.json > basename map). Workspace defaults to
+ * the parent directory of the calling repo, overridable via the
+ * `TOTEM_WORKSPACE` env var or `--workspace` flag.
+ *
+ * Ports the strategy-side reference implementation
+ * (`mmnto-ai/totem-strategy:.claude/hooks/SessionStart.cjs:pollInboundOutboxes`,
+ * merged via mmnto-ai/totem-strategy#373) into a cohort-portable command
+ * surface per the ADR-107 § Consequences direction.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { resolveSelfAgents } from '@mmnto/totem';
+// ─── Constants ──────────────────────────────────────────
+const TAG = 'Mail';
+/**
+ * Hard cap on filesystem entries scanned per invocation. Matches the
+ * strategy reference impl's MAX_SCAN; balances thoroughness against hook
+ * latency. When tripped, the result carries `truncated: true` so the
+ * caller can surface the warning instead of silently dropping mail.
+ */
+const MAX_SCAN = 500;
+// ─── Frontmatter parsing ────────────────────────────────
+/**
+ * Extract `to:` / `from:` / `subject:` / `date:` from a leading frontmatter
+ * block. Restricts the regex search to the header (text before the first
+ * blank line) so body lines starting with `to:` etc. cannot fabricate a
+ * match or overwrite displayed metadata — same defense pattern as the
+ * reference impl.
+ *
+ * Returns `null` if no `to:` field is present (the only frontmatter field
+ * required for a file to be eligible mail).
+ */
+/**
+ * Hard cap on bytes scanned for frontmatter when no blank-line separator
+ * exists. Defense against forged frontmatter: a malformed handoff without
+ * the `---\n\n` delimiter would otherwise let body lines starting with
+ * `to:` fabricate metadata. Real frontmatter is dozens of bytes; 2 KiB
+ * is generous-but-bounded.
+ */
+const MAX_HEADER_BYTES = 2048;
+function parseHeader(content) {
+    // Defense in depth: real handoffs open with a YAML frontmatter delimiter.
+    // Reject anything that doesn't, so a stray .md file in an outbox cannot
+    // be coerced into mail.
+    if (!content.startsWith('---'))
+        return null;
+    const parts = content.split(/\r?\n\r?\n/, 2);
+    const header = parts[0] ?? '';
+    // When there's no blank-line separator, the split returns the whole
+    // file as parts[0]. Cap header size in that case so body content can't
+    // fabricate `to:`/`from:` matches.
+    if (parts.length < 2 && content.length > MAX_HEADER_BYTES)
+        return null;
+    const toMatch = header.match(/^to:\s*(.+)$/im);
+    if (!toMatch)
+        return null;
+    const fromMatch = header.match(/^from:\s*(.+)$/im);
+    const subjectMatch = header.match(/^[-\s]*subject:\s*(.+)$/im);
+    const dateMatch = header.match(/^date:\s*(.+)$/im);
+    return {
+        to: toMatch[1].trim(),
+        from: fromMatch ? fromMatch[1].trim() : null,
+        subject: subjectMatch ? subjectMatch[1].trim() : null,
+        date: dateMatch ? dateMatch[1].trim() : null,
+    };
+}
+/**
+ * Build the set of basenames that should be skipped because they have
+ * already been actioned. Drains `processed/` and `processed/_broadcast/`
+ * for each SELF_AGENT in the calling repo.
+ */
+function buildProcessedSet(repoRoot, selfAgents, warnings) {
+    const processed = new Set();
+    for (const agent of selfAgents) {
+        const agentDir = path.join(repoRoot, '.totem', 'orchestration', agent, 'processed');
+        drainProcessedDir(agentDir, processed, warnings);
+        drainProcessedDir(path.join(agentDir, '_broadcast'), processed, warnings);
+    }
+    return processed;
+}
+function drainProcessedDir(dir, into, warnings) {
+    if (!fs.existsSync(dir))
+        return;
+    // totem-context: intentional cleanup — an unreadable processed/ subtree (EACCES, race with concurrent rename) emits a warning and degrades to a stale exclusion set rather than blocking the poll. Mail still surfaces; the agent may see already-actioned items in that worst case, which is observable (the warning) rather than silent.
+    try {
+        for (const entry of fs.readdirSync(dir)) {
+            if (entry.endsWith('.md'))
+                into.add(entry);
+        }
+        // totem-context: intentional cleanup — see directive above the try; dual placement so the rule fires on either the catch-keyword line or the catch-body line.
+    }
+    catch (err) {
+        warnings.push(`processed/ scan failed (${dir}): ${String(err)}`);
+    }
+}
+/**
+ * Enumerate outbox directories under `<workspace>/<repo>/.totem/orchestration/<agent>/outbox`.
+ * Single-level by default; recursive mode walks `<workspace>/**` (capped at MAX_SCAN
+ * to bound runtime on deep trees).
+ */
+function enumerateOutboxes(workspace, recursive, warnings) {
+    const slots = [];
+    if (!fs.existsSync(workspace)) {
+        warnings.push(`workspace does not exist: ${workspace}`);
+        return slots;
+    }
+    let repos;
+    try {
+        repos = fs
+            .readdirSync(workspace, { withFileTypes: true })
+            .filter((d) => d.isDirectory() && !d.name.startsWith('.') && d.name !== 'node_modules')
+            .map((d) => d.name)
+            .sort();
+        // totem-context: intentional cleanup — a workspace readdir failure (EACCES, ENOTDIR via raced symlink) is recorded as a structured warning so the CLI surfaces it; throwing here would block hook-driven session start over a non-fatal scan issue.
+    }
+    catch (err) {
+        warnings.push(`workspace scan failed: ${String(err)}`);
+        return slots;
+    }
+    const visit = (repoLabel, orchDir) => {
+        if (!fs.existsSync(orchDir))
+            return;
+        let agents;
+        try {
+            agents = fs.readdirSync(orchDir).sort();
+            // totem-context: intentional cleanup — per-repo readdir failure skips this slot, emits a structured warning, and lets sibling repos continue; one inaccessible orchestration tree must not block the rest of the scan.
+        }
+        catch (err) {
+            warnings.push(`orchestration scan failed (${repoLabel}): ${String(err)}`);
+            return;
+        }
+        for (const agent of agents) {
+            const outbox = path.join(orchDir, agent, 'outbox');
+            if (fs.existsSync(outbox)) {
+                slots.push({ repo: repoLabel, agent, outbox });
+            }
+        }
+    };
+    if (!recursive) {
+        for (const repo of repos) {
+            visit(repo, path.join(workspace, repo, '.totem', 'orchestration'));
+        }
+        return slots;
+    }
+    // Recursive variant: descend into each top-level repo and look for any
+    // `.totem/orchestration/` under it. Bounded depth so a malformed tree
+    // can't pin us — the MAX_SCAN file-open cap is the second guard.
+    const RECURSIVE_DEPTH_CAP = 6;
+    const stack = repos.map((r) => ({
+        dir: path.join(workspace, r),
+        label: r,
+        depth: 0,
+    }));
+    while (stack.length > 0) {
+        const node = stack.pop();
+        visit(node.label, path.join(node.dir, '.totem', 'orchestration'));
+        if (node.depth >= RECURSIVE_DEPTH_CAP)
+            continue;
+        let children;
+        try {
+            children = fs.readdirSync(node.dir, { withFileTypes: true });
+            // totem-context: intentional cleanup — recursive-descent readdir failure on one node emits a structured warning and skips that subtree; a single inaccessible dir must not abort the whole scan.
+        }
+        catch (err) {
+            warnings.push(`recursive scan failed (${node.dir}): ${String(err)}`);
+            continue;
+        }
+        for (const child of children) {
+            if (!child.isDirectory() || child.name.startsWith('.'))
+                continue;
+            if (child.name === 'node_modules')
+                continue;
+            stack.push({
+                dir: path.join(node.dir, child.name),
+                // Use the immediate-parent directory name as the repo label for
+                // nested layouts (e.g. `wrapper/nested-strategy/.totem/orchestration/`
+                // surfaces as repo='nested-strategy'). The top-level label is
+                // misleading when the orchestration tree lives under a wrapper dir.
+                label: child.name,
+                depth: node.depth + 1,
+            });
+        }
+    }
+    return slots;
+}
+// ─── Core poll ──────────────────────────────────────────
+/**
+ * Programmatic entry point. Returns a structured `MailPollResult` for
+ * consumers that want to render their own output (hooks, MCP audits,
+ * future surfaces). The CLI wrapper calls this then formats the result
+ * for human consumption.
+ *
+ * Never throws — filesystem failures degrade to warnings on the result.
+ */
+export function pollMail(opts = {}) {
+    const env = opts.env ?? process.env;
+    const repoRoot = path.resolve(opts.repoRoot ?? process.cwd());
+    const workspaceRaw = opts.workspace ?? env['TOTEM_WORKSPACE'] ?? path.dirname(repoRoot);
+    const workspace = path.resolve(workspaceRaw);
+    const selfResolution = resolveSelfAgents(repoRoot, env);
+    const selfLower = new Set(selfResolution.agents.map((a) => a.toLowerCase()));
+    const warnings = [];
+    if (selfResolution.agents.length === 0) {
+        warnings.push(`no SELF_AGENT resolved (set TOTEM_SELF_AGENT, add .totem/orchestration/config.json host_agents, or run from a known cohort repo)`);
+    }
+    const processedNames = selfResolution.agents.length > 0
+        ? buildProcessedSet(repoRoot, selfResolution.agents, warnings)
+        : new Set();
+    const slots = enumerateOutboxes(workspace, opts.recursive === true, warnings);
+    // Two-pass scan for global newest-first fairness under MAX_SCAN.
+    // Pass 1 (cheap): readdirSync every outbox to collect all unread filenames.
+    // Pass 2 (expensive): sort globally by filename (ISO-timestamp prefix), then
+    // readFileSync only the top MAX_SCAN. Without the global sort, alphabet-early
+    // repos can exhaust the cap before later repos are touched (per GCA review on
+    // mmnto-ai/totem#1971). Pre-collect of cheap reads is faster than the prior
+    // interleaved per-slot loop when truncation actually trips.
+    const unread = [];
+    for (const slot of slots) {
+        let files;
+        try {
+            files = fs.readdirSync(slot.outbox).filter((f) => f.endsWith('.md'));
+            // totem-context: intentional cleanup — outbox readdir failure (mid-rename race, EACCES, removed-during-scan) emits a structured warning and skips this slot.
+        }
+        catch (err) {
+            warnings.push(`outbox scan failed (${slot.repo}/${slot.agent}): ${String(err)}`);
+            continue;
+        }
+        for (const file of files) {
+            if (processedNames.has(file))
+                continue;
+            unread.push({ slot, file });
+        }
+    }
+    // Global newest-first by filename. ISO-timestamp prefixes give a total
+    // order; non-ISO filenames sort lexically (stable; only matters within a
+    // sender's outbox).
+    unread.sort((a, b) => b.file.localeCompare(a.file));
+    let scanned = 0;
+    let truncated = false;
+    if (unread.length > MAX_SCAN) {
+        truncated = true;
+    }
+    const mail = [];
+    const inScope = unread.length > MAX_SCAN ? unread.slice(0, MAX_SCAN) : unread;
+    for (const { slot, file } of inScope) {
+        scanned += 1;
+        let content;
+        try {
+            content = fs.readFileSync(path.join(slot.outbox, file), 'utf-8');
+            // totem-context: intentional cleanup — per-file readFileSync failure emits a structured warning and skips that file; mail surfacing must degrade gracefully on a single unreadable handoff (mid-write race or transient FS hiccup).
+        }
+        catch (err) {
+            warnings.push(`mail read failed (${slot.repo}/${slot.agent}/${file}): ${String(err)}`);
+            continue;
+        }
+        const header = parseHeader(content);
+        if (!header)
+            continue;
+        const toLower = header.to.toLowerCase();
+        if (toLower !== 'broadcast' && !selfLower.has(toLower))
+            continue;
+        mail.push({
+            file,
+            repo: slot.repo,
+            from: header.from ?? slot.agent,
+            to: header.to,
+            date: header.date,
+            subject: header.subject ?? '(no subject)',
+            filePath: path.join(slot.outbox, file),
+        });
+    }
+    // Re-sort the surviving mail by frontmatter date when available (filename
+    // sort already handled the primary order; this refines for files whose
+    // `date:` differs from the filename prefix).
+    mail.sort((a, b) => (b.date ?? b.file).localeCompare(a.date ?? a.file));
+    return {
+        selfAgents: { agents: [...selfResolution.agents], source: selfResolution.source },
+        mail,
+        scanned,
+        truncated,
+        workspace,
+        warnings,
+    };
+}
+// ─── Output formatting ──────────────────────────────────
+function formatTextResult(result) {
+    const lines = [];
+    const selfList = result.selfAgents.agents.length > 0 ? result.selfAgents.agents.join(', ') : '(none)';
+    lines.push(`Workspace: ${result.workspace}`);
+    lines.push(`Self agents: ${selfList} (source: ${result.selfAgents.source})`);
+    if (result.warnings.length > 0) {
+        for (const w of result.warnings)
+            lines.push(`Warning: ${w}`);
+    }
+    if (result.mail.length === 0) {
+        lines.push(`No unread mail addressed to ${selfList} or broadcast.`);
+    }
+    else {
+        lines.push(`${result.mail.length} unread:`);
+        for (const m of result.mail) {
+            lines.push(`  - ${m.file} (from ${m.from} @ ${m.repo}, to: ${m.to})`);
+            lines.push(`      subject: ${m.subject}`);
+        }
+    }
+    if (result.truncated) {
+        lines.push(`[scan truncated at ${result.scanned} files; raise concern if this persists]`);
+    }
+    return lines.join('\n');
+}
+// ─── CLI entry ──────────────────────────────────────────
+export async function mailCommand(opts = {}) {
+    const result = pollMail(opts);
+    if (opts.json === true) {
+        // JSON output goes to stdout (hook-friendly); structured logger goes to stderr
+        // via the standard CLI path. Using process.stdout keeps the JSON stream clean.
+        process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+        return result;
+    }
+    const { log } = await import('../ui.js');
+    const text = formatTextResult(result);
+    // log.info is stderr-bound across the CLI; mail output is informational,
+    // not a primary data product, so it joins the stderr stream consumers
+    // already attach to.
+    for (const line of text.split('\n')) {
+        log.info(TAG, line);
+    }
+    return result;
+}
+//# sourceMappingURL=mail.js.map

package/dist/commands/mail.js.map

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

package/dist/commands/mail.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tests for `totem mail` (mmnto-ai/totem#1970, ADR-106 § 3 / ADR-107).
+ *
+ * Filesystem-driven: every test builds a fresh `<tmp>/workspace/<repo>/.totem/orchestration/`
+ * tree, exercises the poll, and asserts on the structured `MailPollResult`.
+ * Skips the human-text formatter path except where the formatter's behavior
+ * itself is under test — JSON output is the durable contract for hook
+ * consumers, the text output is human-only.
+ */
+export {};
+//# sourceMappingURL=mail.test.d.ts.map

package/dist/commands/mail.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail.test.d.ts","sourceRoot":"","sources":["../../src/commands/mail.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}