@mmnto/cli 1.34.3 → 1.36.0

package/dist/commands/hook-run.test.js

@@ -0,0 +1,264 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { executeHookRun, EXIT_ALLOW, PRE_TOOL_USE_BLOCK_EXIT_CODE as EXIT_BLOCK, resolveInstalledPackVersions, } from './hook-run.js';
+/** Schema version no live runner supports — used to assert warn-and-skip on unknown manifest versions. */
+const UNSUPPORTED_SCHEMA_VERSION = 999;
+let workDir;
+beforeEach(() => {
+    workDir = fs.mkdtempSync(path.join(os.tmpdir(), 'totem-hook-run-'));
+});
+afterEach(() => {
+    fs.rmSync(workDir, { recursive: true, force: true });
+});
+function writeManifest(content) {
+    const manifestPath = path.join(workDir, 'compiled-hooks.json');
+    fs.writeFileSync(manifestPath, JSON.stringify(content), 'utf8');
+    return manifestPath;
+}
+const baseRule = {
+    id: 'gca-tag-xor-command',
+    packId: '@mmnto/pack-bot-gemini-code-assist',
+    trigger: { tool: 'bash', pattern: 'gh\\s+(pr|issue)\\s+comment' },
+    check: {
+        pattern: '(?=.*@gemini-code-assist)(?=.*\\/gemini review)',
+        type: 'reject-if-match',
+    },
+    message: 'GCA tag XOR command — never both; doubling wastes GCA quota.',
+    recoveryHint: 'Choose one: @-mention to comment, /gemini review for fresh review.',
+};
+function baseManifest(hooks = [baseRule]) {
+    return {
+        schemaVersion: 1,
+        compiledAt: '2026-05-11T18:43:00Z',
+        sourcePackVersions: {
+            '@mmnto/pack-bot-gemini-code-assist': '1.0.0',
+        },
+        hooks,
+    };
+}
+describe('executeHookRun — allow path', () => {
+    it('returns exit 0 with no stderr when the manifest file is absent (fresh repo)', () => {
+        const result = executeHookRun({
+            manifestPath: path.join(workDir, 'missing.json'),
+            installedPackVersions: {},
+            payload: { tool: 'bash', args: 'whatever' },
+        });
+        expect(result.exitCode).toBe(EXIT_ALLOW);
+        expect(result.stderr).toEqual([]);
+    });
+    it('returns exit 0 when no hook trigger matches the payload', () => {
+        const manifestPath = writeManifest(baseManifest());
+        const result = executeHookRun({
+            manifestPath,
+            installedPackVersions: { '@mmnto/pack-bot-gemini-code-assist': '1.0.0' },
+            payload: { tool: 'write', args: 'console.log("hi")' },
+        });
+        expect(result.exitCode).toBe(EXIT_ALLOW);
+        expect(result.stderr).toEqual([]);
+    });
+    it('returns exit 0 when the trigger matches but the check does not (reject-if-match)', () => {
+        const manifestPath = writeManifest(baseManifest());
+        const result = executeHookRun({
+            manifestPath,
+            installedPackVersions: { '@mmnto/pack-bot-gemini-code-assist': '1.0.0' },
+            payload: {
+                tool: 'bash',
+                args: 'gh pr comment 1 --body "@gemini-code-assist take a look"',
+            },
+        });
+        expect(result.exitCode).toBe(EXIT_ALLOW);
+        expect(result.stderr).toEqual([]);
+    });
+});
+describe('executeHookRun — reject path (ADR-104 § Decision 1)', () => {
+    it('exits 2 with the structured [totem:hook-block] line on the first matching hook', () => {
+        const manifestPath = writeManifest(baseManifest());
+        const result = executeHookRun({
+            manifestPath,
+            installedPackVersions: { '@mmnto/pack-bot-gemini-code-assist': '1.0.0' },
+            payload: {
+                tool: 'bash',
+                args: 'gh pr comment 1 --body "@gemini-code-assist /gemini review please"',
+            },
+        });
+        expect(result.exitCode).toBe(EXIT_BLOCK);
+        const rejectLine = result.stderr[result.stderr.length - 1];
+        expect(rejectLine).toContain('[totem:hook-block]');
+        expect(rejectLine).toContain('@mmnto/pack-bot-gemini-code-assist/gca-tag-xor-command');
+        expect(rejectLine).toContain('GCA tag XOR command');
+        expect(rejectLine).toContain('→ Choose one');
+    });
+    it('first-match-wins: a later hook that also matches is not evaluated', () => {
+        const second = {
+            ...baseRule,
+            id: 'never-reached',
+            message: 'should not appear in stderr',
+        };
+        const manifestPath = writeManifest(baseManifest([baseRule, second]));
+        const result = executeHookRun({
+            manifestPath,
+            installedPackVersions: { '@mmnto/pack-bot-gemini-code-assist': '1.0.0' },
+            payload: {
+                tool: 'bash',
+                args: 'gh pr comment 1 --body "@gemini-code-assist /gemini review"',
+            },
+        });
+        expect(result.exitCode).toBe(EXIT_BLOCK);
+        expect(result.stderr.some((l) => l.includes('never-reached'))).toBe(false);
+        expect(result.stderr.some((l) => l.includes('should not appear'))).toBe(false);
+    });
+    it('omits the recoveryHint line when the rule has no recoveryHint', () => {
+        const ruleWithoutHint = { ...baseRule, recoveryHint: undefined };
+        const manifestPath = writeManifest(baseManifest([ruleWithoutHint]));
+        const result = executeHookRun({
+            manifestPath,
+            installedPackVersions: { '@mmnto/pack-bot-gemini-code-assist': '1.0.0' },
+            payload: {
+                tool: 'bash',
+                args: 'gh pr comment 1 --body "@gemini-code-assist /gemini review"',
+            },
+        });
+        expect(result.exitCode).toBe(EXIT_BLOCK);
+        const rejectLine = result.stderr[result.stderr.length - 1];
+        expect(rejectLine).not.toContain('→');
+    });
+});
+describe('executeHookRun — diagnostics ordering', () => {
+    it('emits [totem:hook-stale] warnings before evaluating hooks (operator sees context for any rejection)', () => {
+        const manifestPath = writeManifest(baseManifest());
+        const result = executeHookRun({
+            manifestPath,
+            installedPackVersions: { '@mmnto/pack-bot-gemini-code-assist': '1.1.0' },
+            payload: {
+                tool: 'bash',
+                args: 'gh pr comment 1 --body "@gemini-code-assist /gemini review"',
+            },
+        });
+        expect(result.exitCode).toBe(EXIT_BLOCK);
+        const staleIdx = result.stderr.findIndex((l) => l.includes('[totem:hook-stale]'));
+        const rejectIdx = result.stderr.findIndex((l) => l.includes('[totem:hook-block]'));
+        expect(staleIdx).toBeGreaterThanOrEqual(0);
+        expect(rejectIdx).toBeGreaterThan(staleIdx);
+    });
+    it('emits [totem:hook-schema] warning and returns allow when manifest schemaVersion is unsupported', () => {
+        const manifestPath = writeManifest({
+            ...baseManifest(),
+            schemaVersion: UNSUPPORTED_SCHEMA_VERSION,
+        });
+        const result = executeHookRun({
+            manifestPath,
+            installedPackVersions: {},
+            payload: { tool: 'bash', args: 'whatever' },
+        });
+        expect(result.exitCode).toBe(EXIT_ALLOW);
+        expect(result.stderr.some((l) => l.includes('[totem:hook-schema]'))).toBe(true);
+    });
+    it('emits [totem:hook-error] prefix on structural manifest errors (corrupt JSON)', () => {
+        const manifestPath = path.join(workDir, 'compiled-hooks.json');
+        fs.writeFileSync(manifestPath, '{ not valid json', 'utf8');
+        const result = executeHookRun({
+            manifestPath,
+            installedPackVersions: {},
+            payload: { tool: 'bash', args: 'whatever' },
+        });
+        expect(result.exitCode).toBe(EXIT_ALLOW);
+        expect(result.stderr.some((l) => l.startsWith('[totem:hook-error]'))).toBe(true);
+    });
+});
+describe('resolveInstalledPackVersions', () => {
+    it('returns an empty map when no @mmnto scope directory exists', () => {
+        const result = resolveInstalledPackVersions(workDir);
+        expect(result).toEqual({});
+    });
+    it('reads version from each @mmnto/pack-* package.json under node_modules', () => {
+        const scopeDir = path.join(workDir, 'node_modules', '@mmnto');
+        const packDir = path.join(scopeDir, 'pack-bot-coderabbit');
+        fs.mkdirSync(packDir, { recursive: true });
+        fs.writeFileSync(path.join(packDir, 'package.json'), JSON.stringify({ name: '@mmnto/pack-bot-coderabbit', version: '1.2.3' }), 'utf8');
+        const result = resolveInstalledPackVersions(workDir);
+        expect(result).toEqual({ '@mmnto/pack-bot-coderabbit': '1.2.3' });
+    });
+    it('skips non-pack-* @mmnto packages (e.g. @mmnto/totem itself)', () => {
+        const scopeDir = path.join(workDir, 'node_modules', '@mmnto');
+        const corePkg = path.join(scopeDir, 'totem');
+        fs.mkdirSync(corePkg, { recursive: true });
+        fs.writeFileSync(path.join(corePkg, 'package.json'), JSON.stringify({ name: '@mmnto/totem', version: '1.36.0' }), 'utf8');
+        const result = resolveInstalledPackVersions(workDir);
+        expect(result).toEqual({});
+    });
+    it('rethrows non-ENOENT readdirSync errors (e.g. scope-dir-is-a-file)', () => {
+        // Make `<projectRoot>/node_modules/@mmnto` a regular file so readdirSync
+        // fails with a non-ENOENT errno (ENOTDIR on POSIX, varies on Windows but
+        // never ENOENT). The function must surface that fault rather than mask
+        // it as "no packs installed."
+        const scopePath = path.join(workDir, 'node_modules', '@mmnto');
+        fs.mkdirSync(path.dirname(scopePath), { recursive: true });
+        fs.writeFileSync(scopePath, 'not a directory', 'utf8');
+        expect(() => resolveInstalledPackVersions(workDir)).toThrow();
+    });
+    it('reads from symlinked pack directories (pnpm/yarn workspaces case)', () => {
+        // Regression: Dirent.isDirectory() returns false for symlinks even when
+        // the target is a directory. Workspace setups symlink packs into
+        // `node_modules/@mmnto/`, so a pre-filter on `entry.isDirectory()` would
+        // have silently skipped every workspace-linked pack. The function now
+        // drops the type pre-filter and lets the `readFileSync` traversal +
+        // try/catch handle it.
+        const scopeDir = path.join(workDir, 'node_modules', '@mmnto');
+        fs.mkdirSync(scopeDir, { recursive: true });
+        // Target directory (the "source" of the pack).
+        const sourceDir = path.join(workDir, 'workspace-pack-source');
+        fs.mkdirSync(sourceDir);
+        fs.writeFileSync(path.join(sourceDir, 'package.json'), JSON.stringify({ name: '@mmnto/pack-workspace', version: '2.0.0' }), 'utf8');
+        // Symlink it into node_modules/@mmnto/pack-workspace. Skip the test on
+        // platforms that do not grant the calling process permission to create
+        // directory symlinks (Windows without developer mode / admin).
+        try {
+            fs.symlinkSync(sourceDir, path.join(scopeDir, 'pack-workspace'), 'dir');
+        }
+        catch (err) {
+            if (err.code === 'EPERM')
+                return;
+            throw err;
+        }
+        const result = resolveInstalledPackVersions(workDir);
+        expect(result).toEqual({ '@mmnto/pack-workspace': '2.0.0' });
+    });
+    it('rethrows unusual per-pack errors (not in the expected errno set, not SyntaxError)', () => {
+        // The per-pack catch suppresses ENOENT/ENOTDIR/EPERM/EACCES (expected
+        // dir/permission quirks) and SyntaxError (malformed package.json), but
+        // any other exception class is treated as a real fault that surfaces.
+        // Mock readFileSync to throw a synthetic non-errno error and assert the
+        // function propagates it rather than silently skipping the pack.
+        const scopeDir = path.join(workDir, 'node_modules', '@mmnto');
+        const packDir = path.join(scopeDir, 'pack-unusual');
+        fs.mkdirSync(packDir, { recursive: true });
+        fs.writeFileSync(path.join(packDir, 'package.json'), JSON.stringify({ name: '@mmnto/pack-unusual', version: '1.0.0' }), 'utf8');
+        // `resolveInstalledPackVersions` only calls `readFileSync` for pack
+        // package.json files, so a blanket-throw mock exercises the inner catch
+        // without affecting other code paths.
+        const unusual = new Error('synthetic IO timeout');
+        const spy = vi.spyOn(fs, 'readFileSync').mockImplementation(() => {
+            throw unusual;
+        });
+        try {
+            expect(() => resolveInstalledPackVersions(workDir)).toThrow(unusual);
+        }
+        finally {
+            spy.mockRestore();
+        }
+    });
+    it('skips directory entries with unreadable or malformed package.json without failing the whole scan', () => {
+        const scopeDir = path.join(workDir, 'node_modules', '@mmnto');
+        const broken = path.join(scopeDir, 'pack-broken');
+        fs.mkdirSync(broken, { recursive: true });
+        fs.writeFileSync(path.join(broken, 'package.json'), '{ not json', 'utf8');
+        const good = path.join(scopeDir, 'pack-good');
+        fs.mkdirSync(good, { recursive: true });
+        fs.writeFileSync(path.join(good, 'package.json'), JSON.stringify({ name: '@mmnto/pack-good', version: '1.0.0' }), 'utf8');
+        const result = resolveInstalledPackVersions(workDir);
+        expect(result).toEqual({ '@mmnto/pack-good': '1.0.0' });
+    });
+});
+//# sourceMappingURL=hook-run.test.js.map

package/dist/commands/hook-run.test.js.map

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

package/dist/commands/hook-test.d.ts

@@ -0,0 +1,29 @@
+import type { HookTestResult, HookTestSummary } from '../hook/test-runner.js';
+/**
+ * `totem hook test [--filter <term>]` — run fixture-based verification for
+ * compiled bot-pack hooks (ADR-104 § Convergence).
+ *
+ * Loads `surface: hooks` fixtures from `.totem/tests/`, evaluates each
+ * against the matching compiled hook, and reports per-line failures so
+ * authors can iterate on specific payloads. The runner is deterministic
+ * Node.js — no LLM calls — mirroring the `totem hook run` contract.
+ *
+ * `--filter <term>` matches against hook id (case-insensitive substring).
+ */
+export interface HookTestCommandOptions {
+    filter?: string;
+}
+/**
+ * Apply `--filter` to a hook-test summary, failing loud when the filter
+ * matches nothing despite fixtures being present. Pure helper extracted
+ * from `hookTestCommand` so the filter contract is unit-testable without
+ * driving the command end-to-end through `process.cwd()` + `loadConfig`.
+ *
+ * Returns the filtered result slice when the filter matches (or is absent).
+ * Throws TEST_FAILED when `--filter` is set, `summary.total > 0`, and the
+ * filter matches no fixtures — a typoed filter must never look like a
+ * successful zero-test run.
+ */
+export declare function applyFilter(summary: HookTestSummary, filter: string | undefined): HookTestResult[];
+export declare function hookTestCommand(opts: HookTestCommandOptions): Promise<void>;
+//# sourceMappingURL=hook-test.d.ts.map

package/dist/commands/hook-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-test.d.ts","sourceRoot":"","sources":["../../src/commands/hook-test.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAW9E;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,cAAc,EAAE,CAYlB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwHjF"}

package/dist/commands/hook-test.js

@@ -0,0 +1,132 @@
+import path from 'node:path';
+import { sanitize, TotemError } from '@mmnto/totem';
+// Static `TotemError` import is intentional: `applyFilter` below is a pure
+// synchronous helper that throws TEST_FAILED on a typoed `--filter`, and an
+// async wrapper would defeat the testability win of extracting it. The
+// per-codebase guideline against top-level heavy internal value imports is
+// applied to `runHookTests` and `resolveInstalledPackVersions` (lazy-loaded
+// inside the command handler below) instead.
+const TAG = 'HookTest';
+/**
+ * Apply `--filter` to a hook-test summary, failing loud when the filter
+ * matches nothing despite fixtures being present. Pure helper extracted
+ * from `hookTestCommand` so the filter contract is unit-testable without
+ * driving the command end-to-end through `process.cwd()` + `loadConfig`.
+ *
+ * Returns the filtered result slice when the filter matches (or is absent).
+ * Throws TEST_FAILED when `--filter` is set, `summary.total > 0`, and the
+ * filter matches no fixtures — a typoed filter must never look like a
+ * successful zero-test run.
+ */
+export function applyFilter(summary, filter) {
+    if (!filter)
+        return summary.results;
+    const term = filter.toLowerCase();
+    const filtered = summary.results.filter((r) => r.hookId.toLowerCase().includes(term));
+    if (filtered.length === 0 && summary.total > 0) {
+        throw new TotemError('TEST_FAILED', `No hook tests matched --filter "${sanitize(filter)}".`, 'Use an existing hook id substring or omit --filter to run all hook tests.');
+    }
+    return filtered;
+}
+export async function hookTestCommand(opts) {
+    const { log, bold, errorColor, success: successColor } = await import('../ui.js');
+    const { loadConfig, loadEnv, resolveConfigPath } = await import('../utils.js');
+    const { runHookTests } = await import('../hook/test-runner.js');
+    const { resolveInstalledPackVersions } = await import('./hook-run.js');
+    const cwd = process.cwd();
+    loadEnv(cwd);
+    const configPath = resolveConfigPath(cwd);
+    const config = await loadConfig(configPath);
+    const configRoot = path.dirname(configPath);
+    const manifestPath = path.join(configRoot, config.totemDir, 'compiled-hooks.json');
+    const testsDir = path.join(configRoot, config.totemDir, 'tests');
+    const installedPackVersions = resolveInstalledPackVersions(configRoot);
+    log.info(TAG, 'Running hook tests...');
+    const summary = runHookTests({ manifestPath, testsDir, installedPackVersions });
+    // Sanitize every value that flows in from pack-supplied data (manifest
+    // contents, fixture paths) before it reaches the terminal — third-party
+    // packs are an untrusted boundary and identifiers like `hookId`/`packId`
+    // could carry ANSI control sequences that would mangle the operator's
+    // shell. The loader-emitted warnings/errors carry our own message text
+    // but may interpolate user-controlled paths, so they get sanitized too.
+    for (const w of summary.loadWarnings) {
+        log.warn(TAG, sanitize(w));
+    }
+    for (const e of summary.loadErrors) {
+        log.error('Totem Error', `${sanitize(e.code)}: ${sanitize(e.message)}`);
+    }
+    for (const unknown of summary.unknownHooks) {
+        const safeFixture = sanitize(path.basename(unknown.fixturePath));
+        const safeHookId = sanitize(unknown.hookId);
+        log.warn(TAG, `Fixture ${safeFixture} references hook id "${safeHookId}" not present in compiled manifest`);
+    }
+    const results = applyFilter(summary, opts.filter);
+    // "No fixtures" only fires when no fixtures exist at all — neither
+    // evaluatable results nor orphans referencing an absent hook. A directory
+    // containing only orphan fixtures must fail loud below, not show the
+    // "create a fixture" placeholder.
+    if (results.length === 0 &&
+        summary.total === 0 &&
+        summary.unknownHooks.length === 0 &&
+        summary.loadErrors.length === 0) {
+        log.dim(TAG, `No hook fixtures (surface: hooks) found in ${sanitize(config.totemDir)}/tests/`);
+        log.dim(TAG, 'Create a fixture with:');
+        log.dim(TAG, '');
+        log.dim(TAG, '  ---');
+        log.dim(TAG, '  rule: <hook-id>');
+        log.dim(TAG, '  surface: hooks');
+        log.dim(TAG, '  corpus: fail');
+        log.dim(TAG, '  ---');
+        log.dim(TAG, '');
+        log.dim(TAG, '  ## Should fail');
+        log.dim(TAG, '  ```text');
+        log.dim(TAG, '  <args payload that should be rejected>');
+        log.dim(TAG, '  ```');
+        return;
+    }
+    for (const result of results) {
+        const label = `${sanitize(result.packId)}/${sanitize(result.hookId)}`;
+        if (result.passed) {
+            log.success(TAG, `${label} — PASS`);
+            continue;
+        }
+        log.error('Totem Error', `${label} — FAIL`);
+        for (const failure of result.failures) {
+            const direction = failure.expected === 'reject' ? 'missed reject' : 'false positive';
+            console.error(`    [${direction}] expected ${failure.expected}, got ${failure.actual}`);
+            console.error(`      payload: ${sanitize(failure.line.trim())}`);
+        }
+    }
+    const passedCount = results.filter((r) => r.passed).length;
+    const failedCount = results.length - passedCount;
+    console.error('');
+    // Tenet 4: load errors or orphan fixtures must fail loud — they are
+    // never "success" states. A corrupt manifest or a fixture pointing at a
+    // typoed hook id silently passing would mask broken pack wiring.
+    const hasOrphans = summary.unknownHooks.length > 0;
+    const hasLoadErrors = summary.loadErrors.length > 0;
+    if (failedCount === 0 && !hasOrphans && !hasLoadErrors) {
+        const label = successColor(bold('PASS'));
+        log.info(TAG, `${label} — ${passedCount} hook test(s) passed`);
+        return;
+    }
+    const label = errorColor(bold('FAIL'));
+    const parts = [];
+    if (failedCount > 0)
+        parts.push(`${failedCount} failed`);
+    if (hasOrphans)
+        parts.push(`${summary.unknownHooks.length} unknown-hook reference(s)`);
+    if (hasLoadErrors)
+        parts.push(`${summary.loadErrors.length} manifest load error(s)`);
+    parts.push(`${passedCount} passed`);
+    log.info(TAG, `${label} — ${parts.join(', ')}`);
+    const reasons = [];
+    if (failedCount > 0)
+        reasons.push(`${failedCount} hook test(s) failed`);
+    if (hasOrphans)
+        reasons.push(`${summary.unknownHooks.length} fixture(s) reference unknown hook id`);
+    if (hasLoadErrors)
+        reasons.push(`${summary.loadErrors.length} compiled-hooks manifest load error(s)`);
+    throw new TotemError('TEST_FAILED', reasons.join('; ') + '.', 'Fix failing patterns, orphan fixtures, or manifest issues, then re-run `totem hook test`.');
+}
+//# sourceMappingURL=hook-test.js.map

package/dist/commands/hook-test.js.map

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

package/dist/commands/init-templates.d.ts

@@ -35,6 +35,17 @@ export declare const CLAUDE_SESSION_START_ENTRY: {
         timeout: number;
     }[];
 };
+export declare const SKILL_MARKER_START = "<!-- totem:skill-start -->";
+export declare const SKILL_MARKER_END = "<!-- totem:skill-end -->";
+export declare const SIGNOFF_SKILL_CONTENT: string;
+export declare const REVIEW_REPLY_SKILL_CONTENT = "---\nname: review-reply\ndescription: Unified PR review triage \u2014 fetch, normalize, and batch-action bot comments\n---\n\n<!-- totem:skill-start -->\n\nTriage PR review comments from all bots for PR $ARGUMENTS.\n\n## Phase 1: Fetch & Categorize (Deterministic)\n\nRun the triage command to fetch, normalize, deduplicate, and categorize all bot comments:\n\n```bash\npnpm totem triage-pr $ARGUMENTS\n```\n\nThis outputs a categorized inbox grouped by blast radius (Security \u2192 Architecture \u2192 Convention \u2192 Nits) with cross-bot deduplication already applied. The heavy lifting is done in TypeScript \u2014 no LLM math needed.\n\n**STOP HERE.** Present the output to the user and wait for them to specify actions. Do NOT proceed to Phase 2 until the user replies.\n\n## Phase 2: Execute Actions (Bulk Support)\n\nThe user may type individual IDs (e.g., `fix 4, 11`) OR use bulk actions:\n\n- `fix all security`\n- `defer all nits`\n- `extract all architecture`\n\n### `fix <numbers | category>`\n\nMark items as will-fix. No API calls \u2014 just acknowledge. The user will make code changes next.\n\n### `defer <numbers | category> [ticket]`\n\nAuto-reply on the PR acknowledging the deferral:\n\n- **CodeRabbit items:** Reply inline to each thread with \"Tracked in #NNN\" or \"Deferred \u2014 not blocking for this PR.\"\n- **GCA items:** DO NOT reply inline. Batch ALL GCA responses into ONE issue comment: `@gemini-code-assist` followed by a numbered list addressing each finding. Use `gh api repos/{owner}/{repo}/issues/$ARGUMENTS/comments --input -` with JSON payload.\n- **SARIF items:** No reply needed (our own tool).\n\n### `nit <numbers | category>`\n\nSame as defer but reply text is \"Acknowledged \u2014 nit / by design.\"\n\n### `extract <numbers | category>`\n\nFor each selected finding, generate a lesson and call `mcp__totem-dev__add_lesson` (or equivalent):\n\n- Use the bot's finding as the lesson body\n- Add relevant tags from the file path and finding category\n- The lesson will automatically get `lifecycle: nursery` treatment\n\n### `done`\n\nPrint summary of actions taken and exit.\n\n## CRITICAL: GCA Reply Protocol\n\n**NEVER reply individually to GCA bot comments.** GCA has a quota and will NOT respond to replies unless they contain `@gemini-code-assist`. Always batch ALL GCA responses into a single PR-level comment using the issue comments API endpoint (`/issues/{pr}/comments`), not the review comments reply endpoint.\n\n<!-- totem:skill-end -->\n";
+export declare const DISTRIBUTED_CLAUDE_SKILLS: readonly [{
+    readonly name: "signoff";
+    readonly content: string;
+}, {
+    readonly name: "review-reply";
+    readonly content: "---\nname: review-reply\ndescription: Unified PR review triage — fetch, normalize, and batch-action bot comments\n---\n\n<!-- totem:skill-start -->\n\nTriage PR review comments from all bots for PR $ARGUMENTS.\n\n## Phase 1: Fetch & Categorize (Deterministic)\n\nRun the triage command to fetch, normalize, deduplicate, and categorize all bot comments:\n\n```bash\npnpm totem triage-pr $ARGUMENTS\n```\n\nThis outputs a categorized inbox grouped by blast radius (Security → Architecture → Convention → Nits) with cross-bot deduplication already applied. The heavy lifting is done in TypeScript — no LLM math needed.\n\n**STOP HERE.** Present the output to the user and wait for them to specify actions. Do NOT proceed to Phase 2 until the user replies.\n\n## Phase 2: Execute Actions (Bulk Support)\n\nThe user may type individual IDs (e.g., `fix 4, 11`) OR use bulk actions:\n\n- `fix all security`\n- `defer all nits`\n- `extract all architecture`\n\n### `fix <numbers | category>`\n\nMark items as will-fix. No API calls — just acknowledge. The user will make code changes next.\n\n### `defer <numbers | category> [ticket]`\n\nAuto-reply on the PR acknowledging the deferral:\n\n- **CodeRabbit items:** Reply inline to each thread with \"Tracked in #NNN\" or \"Deferred — not blocking for this PR.\"\n- **GCA items:** DO NOT reply inline. Batch ALL GCA responses into ONE issue comment: `@gemini-code-assist` followed by a numbered list addressing each finding. Use `gh api repos/{owner}/{repo}/issues/$ARGUMENTS/comments --input -` with JSON payload.\n- **SARIF items:** No reply needed (our own tool).\n\n### `nit <numbers | category>`\n\nSame as defer but reply text is \"Acknowledged — nit / by design.\"\n\n### `extract <numbers | category>`\n\nFor each selected finding, generate a lesson and call `mcp__totem-dev__add_lesson` (or equivalent):\n\n- Use the bot's finding as the lesson body\n- Add relevant tags from the file path and finding category\n- The lesson will automatically get `lifecycle: nursery` treatment\n\n### `done`\n\nPrint summary of actions taken and exit.\n\n## CRITICAL: GCA Reply Protocol\n\n**NEVER reply individually to GCA bot comments.** GCA has a quota and will NOT respond to replies unless they contain `@gemini-code-assist`. Always batch ALL GCA responses into a single PR-level comment using the issue comments API endpoint (`/issues/{pr}/comments`), not the review comments reply endpoint.\n\n<!-- totem:skill-end -->\n";
+}];
 export declare function generateConfig(targets: IngestTarget[], embeddingTier: EmbeddingTier, cwd: string): Promise<string>;
 /**
  * Generate a YAML configuration file.

package/dist/commands/init-templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init-templates.d.ts","sourceRoot":"","sources":["../../src/commands/init-templates.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAMpE,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,YAAY,kCAAkC,CAAC;AAC5D,eAAO,MAAM,UAAU,gCAAgC,CAAC;AACxD,eAAO,MAAM,iBAAiB,QAA0C,CAAC;AACzE,eAAO,MAAM,eAAe,6CAA6C,CAAC;AAE1E,eAAO,MAAM,eAAe,i6JA4C3B,CAAC;AAEF,eAAO,MAAM,iBAAiB,8BAA8B,CAAC;AAgB7D,eAAO,MAAM,qBAAqB,6CAA6C,CAAC;AAIhF,eAAO,MAAM,oBAAoB,kwBAiBhC,CAAC;AAEF,eAAO,MAAM,kBAAkB,QAqD9B,CAAC;AAEF,eAAO,MAAM,YAAY,4hBAUxB,CAAC;AAIF,eAAO,MAAM,kBAAkB,waAY9B,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;CAQnC,CAAC;AAkBF,eAAO,MAAM,qBAAqB,QA8EjC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;CAQvC,CAAC;AA4BF,eAAO,MAAM,oBAAoB,m3CAkChC,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;CAQtC,CAAC;AAIF,wBAAsB,cAAc,CAClC,OAAO,EAAE,YAAY,EAAE,EACvB,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,CAyCjB;AAoDD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,YAAY,EAAE,EACvB,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,YAAY,EAAE,EACvB,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,YAAY,EAAE,EACvB,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAkBhD"}
+{"version":3,"file":"init-templates.d.ts","sourceRoot":"","sources":["../../src/commands/init-templates.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAMpE,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,YAAY,kCAAkC,CAAC;AAC5D,eAAO,MAAM,UAAU,gCAAgC,CAAC;AACxD,eAAO,MAAM,iBAAiB,QAA0C,CAAC;AACzE,eAAO,MAAM,eAAe,6CAA6C,CAAC;AAE1E,eAAO,MAAM,eAAe,i6JA4C3B,CAAC;AAEF,eAAO,MAAM,iBAAiB,8BAA8B,CAAC;AAgB7D,eAAO,MAAM,qBAAqB,6CAA6C,CAAC;AAIhF,eAAO,MAAM,oBAAoB,kwBAiBhC,CAAC;AAEF,eAAO,MAAM,kBAAkB,QAqD9B,CAAC;AAEF,eAAO,MAAM,YAAY,4hBAUxB,CAAC;AAIF,eAAO,MAAM,kBAAkB,waAY9B,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;CAQnC,CAAC;AAkBF,eAAO,MAAM,qBAAqB,QA8EjC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;CAQvC,CAAC;AA4BF,eAAO,MAAM,oBAAoB,m3CAkChC,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;CAQtC,CAAC;AAmBF,eAAO,MAAM,kBAAkB,+BAA+B,CAAC;AAC/D,eAAO,MAAM,gBAAgB,6BAA6B,CAAC;AAE3D,eAAO,MAAM,qBAAqB,QAkCjC,CAAC;AAEF,eAAO,MAAM,0BAA0B,08EA8DtC,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;;;;EAG5B,CAAC;AAIX,wBAAsB,cAAc,CAClC,OAAO,EAAE,YAAY,EAAE,EACvB,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,CAyCjB;AAoDD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,YAAY,EAAE,EACvB,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,YAAY,EAAE,EACvB,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,YAAY,EAAE,EACvB,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAkBhD"}

package/dist/commands/init-templates.js

@@ -347,6 +347,125 @@ export const CLAUDE_SESSION_START_ENTRY = {
         },
     ],
 };
+// ─── Claude Code skill distribution (mmnto-ai/totem#1890 Phase C slice 3) ───
+//
+// Skills are surfaced into consumer repos at `.claude/skills/<name>/SKILL.md`.
+// Marker-based replace: canonical content lives between SKILL_MARKER_START
+// and SKILL_MARKER_END. Re-running `totem init` replaces inside-marker
+// content with the current canonical; content AFTER the end marker is
+// user-customization territory and survives across refreshes.
+//
+// v0.1 ships two skills: signoff and review-reply. Both passed the
+// canonical/customization audit (universal across consumer repos,
+// idempotent on refresh, no `totem <name>` subcommand collision).
+//
+// Source-of-truth is `mmnto-ai/totem:.claude/skills/<name>/SKILL.md`. The
+// `installed-skills-match-source.test.ts` invariant locks these constants
+// against the source files so canonical drift fails CI rather than
+// silently propagating stale skill content to consumers.
+export const SKILL_MARKER_START = '<!-- totem:skill-start -->';
+export const SKILL_MARKER_END = '<!-- totem:skill-end -->';
+export const SIGNOFF_SKILL_CONTENT = `---
+name: signoff
+description: End-of-session — update memory, write journal entry, clean up
+---
+
+${SKILL_MARKER_START}
+
+End-of-session wrap-up:
+
+1. Update \`MEMORY.md\` with any new state (version shipped, tickets closed, key decisions)
+2. Write a journal entry to the substrate journal at \`<substrate>/.journal/totem/<filename>.md\` summarizing today's work. Use \`resolveSubstratePaths(gitRoot).journalRoot\` from \`@mmnto/totem\` to locate the substrate; if \`source === 'none'\`, fall back to repo-local \`.journal/totem/\` and warn (ADR-090 graceful degradation).
+3. Commit + push the substrate journal entry from \`mmnto-ai/totem-substrate\` (NOT this repo — \`.journal/\` is sediment-frozen here per ADR-100). Use rebase-and-retry on the push since other agents may sign off concurrently:
+
+   \`\`\`bash
+   cd <substrate-repo-root>
+   git add .journal/totem/<filename>.md
+   git commit -m "journal(totem): <slug>"
+   pushed=0
+   for i in 1 2 3 4 5; do
+     git push origin main && { pushed=1; break; }
+     git pull --rebase --autostash origin main || { echo "Rebase conflict — manual resolution needed"; break; }
+     sleep 1
+   done
+   [ "$pushed" = 1 ] || { echo "ERROR: substrate push failed — surface to user"; exit 1; }
+   \`\`\`
+
+   **Why the retry loop:** Substrate \`main\` accepts only fast-forward pushes. If a peer push (strategy-Claude, lc-Claude, status-Claude, etc.) lands between your commit and your push, yours fails with \`non-fast-forward\`. Per-agent journal filenames (\`<model>-NNNN-*.md\`) don't collide, so the rebase auto-succeeds without conflict — typically resolves within 1-2 retries. After 5 retries surface failure to the user; that's likely a genuine same-file edit (e.g., two recipients moving the same \`_broadcast/\` file to \`processed/\`) that needs manual resolution.
+
+` +
+    // totem-context: documentation example — `git branch -D` shown in canonical signoff procedure for human readers; not a runtime invocation in this file
+    `4. Clean up stale local branches: \`git branch -vv | grep ': gone]' | awk '{print $1}' | xargs git branch -D\`
+5. Report: what shipped, what's pending, what's next
+${SKILL_MARKER_END}
+`;
+export const REVIEW_REPLY_SKILL_CONTENT = `---
+name: review-reply
+description: Unified PR review triage — fetch, normalize, and batch-action bot comments
+---
+
+${SKILL_MARKER_START}
+
+Triage PR review comments from all bots for PR $ARGUMENTS.
+
+## Phase 1: Fetch & Categorize (Deterministic)
+
+Run the triage command to fetch, normalize, deduplicate, and categorize all bot comments:
+
+\`\`\`bash
+pnpm totem triage-pr $ARGUMENTS
+\`\`\`
+
+This outputs a categorized inbox grouped by blast radius (Security → Architecture → Convention → Nits) with cross-bot deduplication already applied. The heavy lifting is done in TypeScript — no LLM math needed.
+
+**STOP HERE.** Present the output to the user and wait for them to specify actions. Do NOT proceed to Phase 2 until the user replies.
+
+## Phase 2: Execute Actions (Bulk Support)
+
+The user may type individual IDs (e.g., \`fix 4, 11\`) OR use bulk actions:
+
+- \`fix all security\`
+- \`defer all nits\`
+- \`extract all architecture\`
+
+### \`fix <numbers | category>\`
+
+Mark items as will-fix. No API calls — just acknowledge. The user will make code changes next.
+
+### \`defer <numbers | category> [ticket]\`
+
+Auto-reply on the PR acknowledging the deferral:
+
+- **CodeRabbit items:** Reply inline to each thread with "Tracked in #NNN" or "Deferred — not blocking for this PR."
+- **GCA items:** DO NOT reply inline. Batch ALL GCA responses into ONE issue comment: \`@gemini-code-assist\` followed by a numbered list addressing each finding. Use \`gh api repos/{owner}/{repo}/issues/$ARGUMENTS/comments --input -\` with JSON payload.
+- **SARIF items:** No reply needed (our own tool).
+
+### \`nit <numbers | category>\`
+
+Same as defer but reply text is "Acknowledged — nit / by design."
+
+### \`extract <numbers | category>\`
+
+For each selected finding, generate a lesson and call \`mcp__totem-dev__add_lesson\` (or equivalent):
+
+- Use the bot's finding as the lesson body
+- Add relevant tags from the file path and finding category
+- The lesson will automatically get \`lifecycle: nursery\` treatment
+
+### \`done\`
+
+Print summary of actions taken and exit.
+
+## CRITICAL: GCA Reply Protocol
+
+**NEVER reply individually to GCA bot comments.** GCA has a quota and will NOT respond to replies unless they contain \`@gemini-code-assist\`. Always batch ALL GCA responses into a single PR-level comment using the issue comments API endpoint (\`/issues/{pr}/comments\`), not the review comments reply endpoint.
+
+${SKILL_MARKER_END}
+`;
+export const DISTRIBUTED_CLAUDE_SKILLS = [
+    { name: 'signoff', content: SIGNOFF_SKILL_CONTENT },
+    { name: 'review-reply', content: REVIEW_REPLY_SKILL_CONTENT },
+];
 // ─── Config generation ──────────────────────────────────
 export async function generateConfig(targets, embeddingTier, cwd) {
     const { detectOrchestrator, formatTargets } = await import('./init-detect.js');