@mmnto/cli 1.100.0 → 1.101.0

package/dist/commands/install-hooks-exit-contract.test.js

@@ -0,0 +1,339 @@
+/**
+ * Exit-code contract for `totem hook install` (`hooksCommand`) + the managed
+ * session-hook bounded drift-repair (mmnto-ai/totem#2410 PR-A, slices 2+3).
+ *
+ * This is the dedicated falsifying test for the contract #2406 stabilized and
+ * strategy#894 froze (Tenet 19). It locks:
+ *   - exit 0 ⟺ {fresh install, already-current, bounded drift-repair (git hook AND
+ *     session hook), declared skips (not-a-git-repo, hook-manager-detected)};
+ *   - exit ≠0 ⟺ genuine failure (a hook write throws → propagates → handleError);
+ *   - `--check` is exactly 0/1 (all-present-with-marker vs missing/markerless);
+ *   - a bare install never mutates a non-bounded file (git hook OR session hook);
+ *     `--force` is the only unbounded write; a legacy markerless-end session hook is
+ *     never bare-repaired; a no-marker user file is never touched even under --force;
+ *   - regenerated artifacts always carry marker + end marker (so they self-repair);
+ *   - the two `overwritten` messages are distinct ("Drift-repaired…" vs
+ *     "Force-overwritten…").
+ *
+ * `hooksCommand` reads `process.cwd()` and gates via `process.exit` on `--check`
+ * failure, so the exit-code cases drive it under `process.chdir` + a `process.exit`
+ * spy (the doctor.test.ts idiom); the session-hook matrix drives the pure
+ * `regenerateManagedSessionHooks(cwd, force)` seam directly.
+ */
+import { execSync } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { cleanTmpDir } from '../test-utils.js';
+import { CLAUDE_PREWRITESHIELD, CLAUDE_SESSION_START, GEMINI_SESSION_START, MANAGED_SESSION_HOOKS, TOTEM_FILE_END, TOTEM_FILE_MARKER, } from './init-templates.js';
+import { hooksCommand, installHooksNonInteractive, regenerateManagedSessionHooks, TOTEM_PREPUSH_END, TOTEM_PREPUSH_MARKER, } from './install-hooks.js';
+// ─── Roster invariant (locked contract, mmnto-ai/totem#2410) ─────────
+describe('MANAGED_SESSION_HOOKS roster invariant', () => {
+    it('every entry embeds its own marker AND end marker (so regenerated artifacts self-repair)', () => {
+        expect(MANAGED_SESSION_HOOKS.length).toBeGreaterThan(0);
+        for (const { rel, content, marker, endMarker } of MANAGED_SESSION_HOOKS) {
+            expect(content.includes(marker), `${rel} content is missing its marker`).toBe(true);
+            expect(content.includes(endMarker), `${rel} content is missing its end marker`).toBe(true);
+            // The marker must OPEN the file (only whitespace before it) — the ownership
+            // precondition for bounded drift-repair.
+            expect(content.trimStart().startsWith(marker), `${rel} marker must open the file`).toBe(true);
+            // The end marker must CLOSE the region (nothing but whitespace after it).
+            const endIdx = content.indexOf(endMarker);
+            expect(content.slice(endIdx + endMarker.length).trim()).toBe('');
+        }
+    });
+    it('covers the six distributed managed artifacts (incl. the PR-B prepare wrapper)', () => {
+        const rels = MANAGED_SESSION_HOOKS.map((h) => h.rel).sort();
+        expect(rels).toEqual([
+            '.claude/hooks/PreWriteShield.cjs',
+            '.claude/hooks/SessionStart.cjs',
+            '.claude/hooks/gate-wrapper.cjs',
+            '.gemini/hooks/BeforeTool.js',
+            '.gemini/hooks/SessionStart.js',
+            '.totem/prepare.cjs',
+        ].sort());
+    });
+});
+// ─── Managed session-hook bounded drift-repair (slice 3) ─────────────
+describe('regenerateManagedSessionHooks — bounded drift-repair matrix', () => {
+    let tmpDir;
+    const CLAUDE_SS = '.claude/hooks/SessionStart.cjs';
+    function writeHook(rel, content) {
+        const p = path.join(tmpDir, ...rel.split('/'));
+        fs.mkdirSync(path.dirname(p), { recursive: true });
+        fs.writeFileSync(p, content, 'utf-8');
+        return p;
+    }
+    beforeEach(() => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'totem-2410-sess-'));
+    });
+    afterEach(() => {
+        cleanTmpDir(tmpDir);
+    });
+    it('does NOT create a missing session hook (regenerate-only-if-present)', async () => {
+        const results = await regenerateManagedSessionHooks(tmpDir);
+        expect(results).toEqual([]);
+        expect(fs.existsSync(path.join(tmpDir, ...CLAUDE_SS.split('/')))).toBe(false);
+    });
+    it('returns exists for a present, byte-identical session hook (already current)', async () => {
+        writeHook(CLAUDE_SS, CLAUDE_SESSION_START);
+        const results = await regenerateManagedSessionHooks(tmpDir);
+        const r = results.find((x) => x.file === CLAUDE_SS);
+        expect(r.action).toBe('exists');
+        expect(fs.readFileSync(path.join(tmpDir, ...CLAUDE_SS.split('/')), 'utf-8')).toBe(CLAUDE_SESSION_START);
+    });
+    it('bare drift-repairs a bounded totem-owned session hook (overwritten, no force)', async () => {
+        const p = writeHook(CLAUDE_SS, `${TOTEM_FILE_MARKER}\nstale body\n${TOTEM_FILE_END}\n`);
+        const results = await regenerateManagedSessionHooks(tmpDir);
+        const r = results.find((x) => x.file === CLAUDE_SS);
+        expect(r.action).toBe('overwritten');
+        // Regenerated to canonical — and canonical carries marker + end marker.
+        const written = fs.readFileSync(p, 'utf-8');
+        expect(written).toBe(CLAUDE_SESSION_START);
+        expect(written.includes(TOTEM_FILE_MARKER)).toBe(true);
+        expect(written.includes(TOTEM_FILE_END)).toBe(true);
+    });
+    it('does NOT bare-repair a legacy marker-headed session hook missing the end marker', async () => {
+        const legacy = `${TOTEM_FILE_MARKER} — Claude Code SessionStart hook\nstale legacy body\n`;
+        const p = writeHook(CLAUDE_SS, legacy);
+        const results = await regenerateManagedSessionHooks(tmpDir);
+        const r = results.find((x) => x.file === CLAUDE_SS);
+        expect(r.action).toBe('declined');
+        // Untouched — takes one `totem hook install --force`.
+        expect(fs.readFileSync(p, 'utf-8')).toBe(legacy);
+    });
+    it('--force overwrites a legacy markerless-end session hook (the migration path)', async () => {
+        const legacy = `${TOTEM_FILE_MARKER} — Claude Code SessionStart hook\nstale legacy body\n`;
+        const p = writeHook(CLAUDE_SS, legacy);
+        const results = await regenerateManagedSessionHooks(tmpDir, true);
+        const r = results.find((x) => x.file === CLAUDE_SS);
+        expect(r.action).toBe('overwritten');
+        expect(fs.readFileSync(p, 'utf-8')).toBe(CLAUDE_SESSION_START);
+    });
+    it('does NOT repair a bounded hook with user content AFTER the end marker (bare declines)', async () => {
+        const withTrailingUser = `${TOTEM_FILE_MARKER}\nstale\n${TOTEM_FILE_END}\nconsole.log("mine");\n`;
+        const p = writeHook(CLAUDE_SS, withTrailingUser);
+        const results = await regenerateManagedSessionHooks(tmpDir);
+        expect(results.find((x) => x.file === CLAUDE_SS).action).toBe('declined');
+        expect(fs.readFileSync(p, 'utf-8')).toBe(withTrailingUser);
+    });
+    it('never touches a user-owned file with NO totem marker, even under --force (skipped)', async () => {
+        const userOwned = '// my own SessionStart hook\nconsole.log("mine");\n';
+        const p = writeHook(CLAUDE_SS, userOwned);
+        const bare = await regenerateManagedSessionHooks(tmpDir);
+        expect(bare.find((x) => x.file === CLAUDE_SS).action).toBe('skipped');
+        expect(fs.readFileSync(p, 'utf-8')).toBe(userOwned);
+        const forced = await regenerateManagedSessionHooks(tmpDir, true);
+        expect(forced.find((x) => x.file === CLAUDE_SS).action).toBe('skipped');
+        expect(fs.readFileSync(p, 'utf-8')).toBe(userOwned);
+    });
+    it('never touches a user file that merely QUOTES the marker (marker not at start), even under --force', async () => {
+        // A user-owned hook that quotes the marker string in a comment/string is NOT
+        // marker-headed (positional gate, mmnto-ai/totem#2413). The old `includes(marker)`
+        // gate would treat it as owned and let --force clobber it.
+        const quotesMarker = `// my own hook\n// I copied this line: ${TOTEM_FILE_MARKER}\nconsole.log("mine");\n`;
+        const p = writeHook(CLAUDE_SS, quotesMarker);
+        const bare = await regenerateManagedSessionHooks(tmpDir);
+        expect(bare.find((x) => x.file === CLAUDE_SS).action).toBe('skipped');
+        expect(fs.readFileSync(p, 'utf-8')).toBe(quotesMarker);
+        const forced = await regenerateManagedSessionHooks(tmpDir, true);
+        expect(forced.find((x) => x.file === CLAUDE_SS).action).toBe('skipped');
+        expect(fs.readFileSync(p, 'utf-8')).toBe(quotesMarker);
+    });
+    it('repairs each vendor family independently (claude + gemini)', async () => {
+        writeHook('.claude/hooks/PreWriteShield.cjs', `${TOTEM_FILE_MARKER}\nstale\n${TOTEM_FILE_END}\n`);
+        writeHook('.gemini/hooks/SessionStart.js', GEMINI_SESSION_START); // already current
+        const results = await regenerateManagedSessionHooks(tmpDir);
+        expect(results.find((x) => x.file === '.claude/hooks/PreWriteShield.cjs').action).toBe('overwritten');
+        expect(fs.readFileSync(path.join(tmpDir, '.claude', 'hooks', 'PreWriteShield.cjs'), 'utf-8')).toBe(CLAUDE_PREWRITESHIELD);
+        expect(results.find((x) => x.file === '.gemini/hooks/SessionStart.js').action).toBe('exists');
+    });
+});
+// ─── hooksCommand exit-code contract (slice 2) ───────────────────────
+describe('hooksCommand exit-code contract', () => {
+    let tmpDir;
+    let originalCwd;
+    let errorSpy;
+    let exitSpy;
+    const hooksDir = () => path.join(tmpDir, '.git', 'hooks');
+    const errorOutput = () => errorSpy.mock.calls
+        .map((c) => c.map((a) => String(a)).join(' '))
+        .join('\n');
+    beforeEach(() => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'totem-2410-cmd-'));
+        execSync('git init', { cwd: tmpDir, stdio: 'ignore' });
+        originalCwd = process.cwd();
+        process.chdir(tmpDir);
+        errorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        // A throwing process.exit surfaces a --check failure as a rejection (the CLI
+        // edge would exit non-zero); the install path must never reach it.
+        exitSpy = vi.spyOn(process, 'exit').mockImplementation(((code) => {
+            throw new Error(`process.exit:${code ?? 0}`);
+        }));
+    });
+    afterEach(() => {
+        process.chdir(originalCwd);
+        vi.restoreAllMocks();
+        cleanTmpDir(tmpDir);
+    });
+    // ── exit 0 classes ──────────────────────────────────────────────
+    it('exit 0: fresh install (no throw, no process.exit)', async () => {
+        await expect(hooksCommand({})).resolves.toBeUndefined();
+        expect(exitSpy).not.toHaveBeenCalled();
+        expect(fs.existsSync(path.join(hooksDir(), 'pre-push'))).toBe(true);
+    });
+    it('exit 0: already-current (second install is a no-op)', async () => {
+        await hooksCommand({});
+        errorSpy.mockClear();
+        await expect(hooksCommand({})).resolves.toBeUndefined();
+        expect(exitSpy).not.toHaveBeenCalled();
+        expect(errorOutput()).toContain('already installed');
+    });
+    it('exit 0: bare git-hook drift-repair prints "Drift-repaired", not "Force-overwritten"', async () => {
+        await hooksCommand({});
+        // Corrupt pre-push to a stale-but-bounded totem-owned whole file.
+        fs.writeFileSync(path.join(hooksDir(), 'pre-push'), `#!/bin/sh\n# ${TOTEM_PREPUSH_MARKER}\nstale\n# ${TOTEM_PREPUSH_END}\n`);
+        errorSpy.mockClear();
+        await expect(hooksCommand({})).resolves.toBeUndefined();
+        expect(exitSpy).not.toHaveBeenCalled();
+        const out = errorOutput();
+        expect(out).toContain('Drift-repaired pre-push hook (totem-owned bounded region).');
+        expect(out).not.toContain('Force-overwritten pre-push');
+    });
+    it('exit 0: bare session-hook drift-repair prints "Drift-repaired"', async () => {
+        fs.mkdirSync(path.join(tmpDir, '.claude', 'hooks'), { recursive: true });
+        fs.writeFileSync(path.join(tmpDir, '.claude', 'hooks', 'SessionStart.cjs'), `${TOTEM_FILE_MARKER}\nstale\n${TOTEM_FILE_END}\n`);
+        errorSpy.mockClear();
+        await expect(hooksCommand({})).resolves.toBeUndefined();
+        expect(exitSpy).not.toHaveBeenCalled();
+        expect(errorOutput()).toContain('Drift-repaired .claude/hooks/SessionStart.cjs session hook (totem-owned bounded region).');
+        expect(fs.readFileSync(path.join(tmpDir, '.claude', 'hooks', 'SessionStart.cjs'), 'utf-8')).toBe(CLAUDE_SESSION_START);
+    });
+    it('exit 0: declared skip — not a git repository', async () => {
+        const nonGit = fs.mkdtempSync(path.join(os.tmpdir(), 'totem-2410-nogit-'));
+        process.chdir(nonGit);
+        try {
+            await expect(hooksCommand({})).resolves.toBeUndefined();
+            expect(exitSpy).not.toHaveBeenCalled();
+            expect(errorOutput()).toContain('Not a git repository');
+        }
+        finally {
+            process.chdir(tmpDir);
+            cleanTmpDir(nonGit);
+        }
+    });
+    it('exit 0: declared skip — hook manager detected', async () => {
+        fs.mkdirSync(path.join(tmpDir, '.husky'), { recursive: true });
+        await expect(hooksCommand({})).resolves.toBeUndefined();
+        expect(exitSpy).not.toHaveBeenCalled();
+    });
+    it('hook-manager repo STILL drift-repairs an existing bounded session hook (lc#806 guard)', async () => {
+        // A git-hook manager (husky) means git hooks are the manager's job — a declared
+        // skip for the git side. But the session hooks are Claude/Gemini artifacts,
+        // independent of the manager, so they must still be regenerated: the fix for the
+        // hook-manager early-return that otherwise recreates the lc#806 stale class.
+        fs.mkdirSync(path.join(tmpDir, '.husky'), { recursive: true });
+        const ssPath = path.join(tmpDir, '.claude', 'hooks', 'SessionStart.cjs');
+        fs.mkdirSync(path.dirname(ssPath), { recursive: true });
+        fs.writeFileSync(ssPath, `${TOTEM_FILE_MARKER}\nstale\n${TOTEM_FILE_END}\n`);
+        errorSpy.mockClear();
+        await expect(hooksCommand({})).resolves.toBeUndefined();
+        expect(exitSpy).not.toHaveBeenCalled();
+        // The bounded session hook is drift-repaired even though git hooks were skipped.
+        expect(fs.readFileSync(ssPath, 'utf-8')).toBe(CLAUDE_SESSION_START);
+        expect(errorOutput()).toContain('Drift-repaired .claude/hooks/SessionStart.cjs session hook (totem-owned bounded region).');
+    });
+    // ── exit ≠0: genuine failure ────────────────────────────────────
+    it('exit ≠0: a genuine hook-write failure propagates as a thrown error', async () => {
+        // Make the first-installed hook PATH a directory: the installer's read/write of it
+        // throws EISDIR — a genuine FS failure that must PROPAGATE (fail-loud, Tenet 4),
+        // not be swallowed into a false `installed`. (A directory-at-path fault is
+        // cross-platform, unlike an ESM fs spy — vitest cannot redefine fs namespace exports.)
+        fs.mkdirSync(path.join(hooksDir(), 'pre-commit'), { recursive: true });
+        await expect(hooksCommand({})).rejects.toThrow();
+        expect(exitSpy).not.toHaveBeenCalled();
+    });
+    // ── --check: exactly 0/1 ────────────────────────────────────────
+    it('--check exit 0: all hooks present with markers', async () => {
+        await hooksCommand({});
+        errorSpy.mockClear();
+        await expect(hooksCommand({ check: true })).resolves.toBeUndefined();
+        expect(exitSpy).not.toHaveBeenCalled();
+        expect(errorOutput()).toContain('All hooks installed');
+    });
+    it('--check exit 1: hooks missing (and the remedy names `totem hook install`)', async () => {
+        await expect(hooksCommand({ check: true })).rejects.toThrow('process.exit:1');
+        expect(exitSpy).toHaveBeenCalledWith(1);
+        const out = errorOutput();
+        expect(out).toContain('Some hooks are missing');
+        expect(out).toContain('totem hook install');
+        expect(out).not.toContain('Run `totem hooks`');
+    });
+    it('--check exit 1: hook present but missing the Totem marker', async () => {
+        // Install, then strip the marker from one hook (markerless → not counted).
+        await hooksCommand({});
+        fs.writeFileSync(path.join(hooksDir(), 'pre-push'), '#!/bin/sh\necho "no marker"\n');
+        await expect(hooksCommand({ check: true })).rejects.toThrow('process.exit:1');
+        expect(exitSpy).toHaveBeenCalledWith(1);
+    });
+    it('--check is read-only: it does NOT mutate a drifted session hook', async () => {
+        // Install git hooks so --check passes on the git side (exit 0), then plant a
+        // drifted-but-bounded session hook. --check is a verify-only path and returns
+        // before session-hook regeneration, so the drifted hook must be left untouched.
+        await hooksCommand({});
+        const ssPath = path.join(tmpDir, '.claude', 'hooks', 'SessionStart.cjs');
+        fs.mkdirSync(path.dirname(ssPath), { recursive: true });
+        const drifted = `${TOTEM_FILE_MARKER}\nstale\n${TOTEM_FILE_END}\n`;
+        fs.writeFileSync(ssPath, drifted);
+        await expect(hooksCommand({ check: true })).resolves.toBeUndefined();
+        expect(exitSpy).not.toHaveBeenCalled();
+        expect(fs.readFileSync(ssPath, 'utf-8')).toBe(drifted);
+    });
+    // ── the two `overwritten` messages are distinct ─────────────────
+    it('bare drift-repair and --force overwrite print DISTINCT messages', async () => {
+        await hooksCommand({});
+        const staleBounded = `#!/bin/sh\n# ${TOTEM_PREPUSH_MARKER}\nstale\n# ${TOTEM_PREPUSH_END}\n`;
+        // Bare (no --force) bounded drift-repair.
+        fs.writeFileSync(path.join(hooksDir(), 'pre-push'), staleBounded);
+        errorSpy.mockClear();
+        await hooksCommand({});
+        const bareMsg = errorOutput()
+            .split('\n')
+            .find((l) => l.includes('pre-push hook'));
+        // --force overwrite of the same stale-bounded file.
+        fs.writeFileSync(path.join(hooksDir(), 'pre-push'), staleBounded);
+        errorSpy.mockClear();
+        await hooksCommand({ force: true });
+        const forceMsg = errorOutput()
+            .split('\n')
+            .find((l) => l.includes('pre-push hook'));
+        expect(bareMsg).toContain('Drift-repaired');
+        expect(forceMsg).toContain('Force-overwritten');
+        expect(bareMsg).not.toBe(forceMsg);
+    });
+    // ── bare install never mutates a non-bounded git hook ───────────
+    it('bare install never mutates a user hook with an appended totem block (non-bounded)', async () => {
+        const userThenTotem = `#!/bin/sh\nrun_my_tests\n# ${TOTEM_PREPUSH_MARKER}\nstale\n# ${TOTEM_PREPUSH_END}\n`;
+        fs.mkdirSync(hooksDir(), { recursive: true });
+        fs.writeFileSync(path.join(hooksDir(), 'pre-push'), userThenTotem);
+        await expect(hooksCommand({})).resolves.toBeUndefined();
+        expect(exitSpy).not.toHaveBeenCalled();
+        // User content preserved — only --force may overwrite an unbounded file.
+        expect(fs.readFileSync(path.join(hooksDir(), 'pre-push'), 'utf-8')).toBe(userThenTotem);
+    });
+});
+// ─── sanity: installHooksNonInteractive still classifies a fresh repo ─
+describe('installHooksNonInteractive (contract sanity)', () => {
+    let tmpDir;
+    beforeEach(() => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'totem-2410-ni-'));
+    });
+    afterEach(() => {
+        cleanTmpDir(tmpDir);
+    });
+    it('returns null outside a git repo (declared skip, exit 0 at the command edge)', () => {
+        expect(installHooksNonInteractive(tmpDir)).toBeNull();
+    });
+});
+//# sourceMappingURL=install-hooks-exit-contract.test.js.map

package/dist/commands/install-hooks-exit-contract.test.js.map

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

package/dist/commands/install-hooks.d.ts

@@ -99,6 +99,45 @@ export declare function hooksCommand(opts: {
     strict?: boolean;
     standard?: boolean;
 }): Promise<void>;
+/**
+ * The action taken on one managed session-hook artifact by
+ * {@link regenerateManagedSessionHooks}:
+ *   - `exists`      — present, marker-headed, already byte-identical to canonical (no write).
+ *   - `overwritten` — regenerated: a bare bounded drift-repair OR a `--force` overwrite.
+ *   - `declined`    — marker present but the region is NOT bounded-owned (legacy file
+ *                     with no end marker, or user content after the end marker) and no
+ *                     `--force`: left untouched, takes one `totem hook install --force`.
+ *   - `skipped`     — a user-owned file carrying NO totem marker at all: never touched,
+ *                     not even under `--force`.
+ */
+export type ManagedSessionHookAction = 'exists' | 'overwritten' | 'declined' | 'skipped';
+export interface ManagedSessionHookResult {
+    /** Repo-relative path of the artifact. */
+    file: string;
+    action: ManagedSessionHookAction;
+}
+/**
+ * Walk the {@link MANAGED_SESSION_HOOKS} roster and regenerate the whole-file
+ * session-hook artifacts (`.claude/hooks/*.cjs`, `.gemini/hooks/*.js`) that EXIST
+ * under `cwd`, applying the #2406 bounded-ownership semantics generalized to the
+ * JS/CJS hook family:
+ *
+ *   - Missing file            → not created (creation is `totem init`'s job); omitted
+ *                               from the results entirely.
+ *   - Marker + identical      → `exists` (already current).
+ *   - Marker + drifted, bounded totem-owned whole file → bare drift-repair
+ *                               (`overwritten`), or `--force` → `overwritten`.
+ *   - Marker + drifted, unbounded (legacy no-end-marker / trailing user content):
+ *                               bare → `declined`; `--force` → `overwritten`.
+ *   - Marker does not OPEN the file (no marker, or a merely-quoted marker) →
+ *                               `skipped` even under `--force` (never clobber a
+ *                               user-owned file).
+ *
+ * Regenerate-only-if-present, single-writer per invocation. A write failure
+ * (perms/FS) PROPAGATES (Tenet 4 — a hook the tool cannot write must fail loud,
+ * never silently report success), mirroring `installGitHook`.
+ */
+export declare function regenerateManagedSessionHooks(cwd: string, force?: boolean): Promise<ManagedSessionHookResult[]>;
 /**
  * Silently upgrade the pre-push hook if it was installed by Totem but uses
  * an old format (flag-checking or command-executing) instead of the new

package/dist/commands/install-hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install-hooks.d.ts","sourceRoot":"","sources":["../../src/commands/install-hooks.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAC;AAInD,eAAO,MAAM,iBAAiB,4BAA4B,CAAC;AAC3D,eAAO,MAAM,cAAc,2BAA2B,CAAC;AACvD,eAAO,MAAM,qBAAqB,+BAA+B,CAAC;AAClE,eAAO,MAAM,kBAAkB,8BAA8B,CAAC;AAC9D,eAAO,MAAM,sBAAsB,4BAA4B,CAAC;AAChE,eAAO,MAAM,mBAAmB,2BAA2B,CAAC;AAC5D,eAAO,MAAM,oBAAoB,0BAA0B,CAAC;AAC5D,eAAO,MAAM,iBAAiB,yBAAyB,CAAC;AAIxD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOtD;AAED,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAiB7D;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAiB5D;AAED,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA+BxE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAA;CAAE,GACzC,IAAI,CAaN;AA4ED,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,QAAQ,CAAC,SAAS,EACtB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAA;CAAE,GACzC,OAAO,CAAC,IAAI,CAAC,CA0Df;AAcD,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,CA4BvE;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,CAoH1F;AA4DD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,OAAO,EACf,SAAS,CAAC,EAAE,MAAM,GACjB,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,mBAAmB,GAAG,aAAa,CAgD3E;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,mBAAmB,GAAG,aAAa,CAAC;IACjG,OAAO,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,mBAAmB,GAAG,aAAa,CAAC;CAChG;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,QAAQ,CAAC,SAAS,EACtB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAA;CAAE,GACzC,OAAO,CAAC,qBAAqB,CAAC,CA2DhC;AAED,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CA8BzD;AAID,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,mBAAmB,GAAG,aAAa,CAAC;IACrF,OAAO,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,mBAAmB,GAAG,aAAa,CAAC;IACnF,SAAS,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,mBAAmB,GAAG,aAAa,CAAC;IACrF,YAAY,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,mBAAmB,GAAG,aAAa,CAAC;CACzF;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,OAAO,EACf,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAA;CAAE,GACzC,kBAAkB,GAAG,IAAI,CA0D3B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CA8BxD;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiFhB;AAID;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAmF/D"}
+{"version":3,"file":"install-hooks.d.ts","sourceRoot":"","sources":["../../src/commands/install-hooks.ts"],"names":[],"mappings":"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"}

package/dist/commands/install-hooks.js

@@ -651,7 +651,7 @@ export async function hooksCommand(opts) {
             console.error('[Totem] All hooks installed.');
         }
         else {
-            console.error('[Totem] Some hooks are missing. Run `totem hooks` to install.');
+            console.error('[Totem] Some hooks are missing. Run `totem hook install` to install.');
             process.exit(1);
         }
         return;
@@ -682,32 +682,140 @@ export async function hooksCommand(opts) {
         tier = 'standard';
     }
     const result = installHooksNonInteractive(cwd, opts.force, { tier });
-    if (!result) {
-        // Hook manager detected — guidance already printed by installHooksNonInteractive
-        return;
+    // The git-hook summary prints ONLY when git hooks were actually written. A null
+    // result means a hook manager (husky/lefthook) was detected and
+    // installHooksNonInteractive already printed its guidance — but this MUST NOT
+    // early-return: the managed session hooks below are Claude/Gemini artifacts,
+    // independent of any git-hook manager, and must still be regenerated (a
+    // hook-manager repo otherwise recreates the lc#806 stale-session-hook class).
+    if (result) {
+        const actions = [
+            { name: 'pre-commit', status: result.preCommit },
+            { name: 'pre-push', status: result.prePush },
+            { name: 'post-merge', status: result.postMerge },
+            { name: 'post-checkout', status: result.postCheckout },
+        ];
+        for (const { name, status } of actions) {
+            switch (status) {
+                case 'installed':
+                    console.error(`[Totem] Installed ${name} hook.`);
+                    break;
+                case 'appended':
+                    console.error(`[Totem] Appended Totem to existing ${name} hook.`);
+                    break;
+                case 'exists':
+                    console.error(`[Totem] ${name} hook already installed.`);
+                    break;
+                case 'overwritten':
+                    // `installGitHook` returns `overwritten` for BOTH a forced overwrite and a
+                    // bare (no-force) drift-repair of a totem-owned bounded region. Print the
+                    // truthful cause: "Force-overwritten" ONLY when --force was actually passed,
+                    // "Drift-repaired" for the bare bounded self-repair (mmnto-ai/totem#2410 —
+                    // fixes the misleading always-"Force-overwritten" message).
+                    console.error(opts.force
+                        ? `[Totem] Force-overwritten ${name} hook.`
+                        : `[Totem] Drift-repaired ${name} hook (totem-owned bounded region).`);
+                    break;
+                case 'skipped-non-shell':
+                    console.error(`[Totem] Warning: ${name} hook uses a non-shell interpreter. Integrate manually.`);
+                    break;
+            }
+        }
     }
-    const actions = [
-        { name: 'pre-commit', status: result.preCommit },
-        { name: 'pre-push', status: result.prePush },
-        { name: 'post-merge', status: result.postMerge },
-        { name: 'post-checkout', status: result.postCheckout },
-    ];
-    for (const { name, status } of actions) {
-        switch (status) {
-            case 'installed':
-                console.error(`[Totem] Installed ${name} hook.`);
-                break;
-            case 'appended':
-                console.error(`[Totem] Appended Totem to existing ${name} hook.`);
-                break;
+    // ── Managed session-hook regeneration (mmnto-ai/totem#2410 PR-A slice 3) ──
+    // Runs on BOTH the manager and no-manager paths (the `if (result)` above only
+    // gates the git-hook summary): the `.claude/hooks/*.cjs` and `.gemini/hooks/*.js`
+    // artifacts are Claude/Gemini hooks, not git hooks, so they are regenerated
+    // whether or not a git-hook manager (husky/lefthook) is in play. The `--check`
+    // and not-a-git-repo paths already returned above, so this never fires for the
+    // read-only verify or the honest-skip. Regenerate-only-if-present: creation stays
+    // with `totem init`; this verb repairs drift in artifacts the repo already adopted.
+    await printManagedSessionHookSummary(gitRoot, opts.force);
+}
+/**
+ * Walk the {@link MANAGED_SESSION_HOOKS} roster and regenerate the whole-file
+ * session-hook artifacts (`.claude/hooks/*.cjs`, `.gemini/hooks/*.js`) that EXIST
+ * under `cwd`, applying the #2406 bounded-ownership semantics generalized to the
+ * JS/CJS hook family:
+ *
+ *   - Missing file            → not created (creation is `totem init`'s job); omitted
+ *                               from the results entirely.
+ *   - Marker + identical      → `exists` (already current).
+ *   - Marker + drifted, bounded totem-owned whole file → bare drift-repair
+ *                               (`overwritten`), or `--force` → `overwritten`.
+ *   - Marker + drifted, unbounded (legacy no-end-marker / trailing user content):
+ *                               bare → `declined`; `--force` → `overwritten`.
+ *   - Marker does not OPEN the file (no marker, or a merely-quoted marker) →
+ *                               `skipped` even under `--force` (never clobber a
+ *                               user-owned file).
+ *
+ * Regenerate-only-if-present, single-writer per invocation. A write failure
+ * (perms/FS) PROPAGATES (Tenet 4 — a hook the tool cannot write must fail loud,
+ * never silently report success), mirroring `installGitHook`.
+ */
+export async function regenerateManagedSessionHooks(cwd, force) {
+    // Dynamic-import the roster (large canonical template strings) + the shared
+    // ownership helpers so init-templates stays off the CLI cold-start graph
+    // (packages/cli lazy-load guideline; mirrors doctor-parity.ts's own import).
+    // `isBoundedOwnedFile` is the single shared session-hook ownership checker
+    // (mmnto-ai/totem#2413 — was a divergent twin of init's local copy).
+    const { MANAGED_SESSION_HOOKS, isBoundedOwnedFile, markerOpensFile } = await import('./init-templates.js');
+    const results = [];
+    for (const { rel, content, marker, endMarker } of MANAGED_SESSION_HOOKS) {
+        const filePath = path.join(cwd, ...rel.split('/'));
+        if (!fs.existsSync(filePath)) {
+            // Regenerate-only-if-present: never create a session hook the repo opted out of.
+            continue;
+        }
+        const existing = fs.readFileSync(filePath, 'utf-8');
+        // Positional ownership gate (mmnto-ai/totem#2413): the marker must OPEN the file.
+        // A user-owned file with NO marker — or one that merely QUOTES the marker string in
+        // a comment/string — is never touched, not even under --force. (The old
+        // `includes(marker)` gate let a quoting user file be clobbered by --force, breaking
+        // the "no marker → never touched, even forced" contract.)
+        if (!markerOpensFile(existing, marker)) {
+            results.push({ file: rel, action: 'skipped' });
+            continue;
+        }
+        if (existing === content) {
+            results.push({ file: rel, action: 'exists' });
+            continue;
+        }
+        // Content differs. --force overwrites any marker-headed file (bounded or not);
+        // a bare run repairs only a bounded totem-OWNED whole file, and declines the rest.
+        if (force || isBoundedOwnedFile(existing, marker, endMarker)) {
+            fs.writeFileSync(filePath, content, 'utf-8');
+            results.push({ file: rel, action: 'overwritten' });
+        }
+        else {
+            results.push({ file: rel, action: 'declined' });
+        }
+    }
+    return results;
+}
+/**
+ * Regenerate the managed session hooks and print one summary line per artifact,
+ * mirroring the git-hook summary. The `overwritten` line distinguishes a forced
+ * overwrite from a bare bounded drift-repair (same truthful split the git-hook
+ * summary uses).
+ */
+async function printManagedSessionHookSummary(cwd, force) {
+    const results = await regenerateManagedSessionHooks(cwd, force);
+    for (const { file, action } of results) {
+        switch (action) {
             case 'exists':
-                console.error(`[Totem] ${name} hook already installed.`);
+                console.error(`[Totem] ${file} session hook already current.`);
                 break;
             case 'overwritten':
-                console.error(`[Totem] Force-overwritten ${name} hook.`);
+                console.error(force
+                    ? `[Totem] Force-overwritten ${file} session hook.`
+                    : `[Totem] Drift-repaired ${file} session hook (totem-owned bounded region).`);
+                break;
+            case 'declined':
+                console.error(`[Totem] ${file} session hook has drifted but is not a bounded totem-owned region — run \`totem hook install --force\` to regenerate.`);
                 break;
-            case 'skipped-non-shell':
-                console.error(`[Totem] Warning: ${name} hook uses a non-shell interpreter. Integrate manually.`);
+            case 'skipped':
+                console.error(`[Totem] ${file}: user-owned file (no Totem marker) — left untouched.`);
                 break;
         }
     }