claude-dev-env 8.56.0 → 8.56.2

package/bin/install-pstack-plugin.mjs

@@ -25,7 +25,7 @@ export const PSTACK_PLUGIN_SPEC = Object.freeze({
 export const USAGE_WRAPUP_PLUGIN_SPEC = Object.freeze({
     name: 'usage-wrapup',
     label: 'Usage-wrapup',
-    marketplaceRepository: 'jl-cmd/claude-dev-env',
+    marketplaceRepository: 'jl-cmd-projects/claude-dev-env',
     marketplaceName: 'claude-dev-env',
     sparsePaths: Object.freeze(['.claude-plugin', 'packages/usage-wrapup']),
     pluginIdentifier: 'usage-wrapup@claude-dev-env',
@@ -37,7 +37,7 @@ export const USAGE_WRAPUP_PLUGIN_SPEC = Object.freeze({
 export const SUBAGENT_MODELS_PLUGIN_SPEC = Object.freeze({
     name: 'subagent-models',
     label: 'Subagent-models',
-    marketplaceRepository: 'jl-cmd/claude-dev-env',
+    marketplaceRepository: 'jl-cmd-projects/claude-dev-env',
     marketplaceName: 'claude-dev-env',
     sparsePaths: Object.freeze(['.claude-plugin', 'packages/subagent-models']),
     pluginIdentifier: 'subagent-models@claude-dev-env',

package/bin/install-pstack-plugin.test.mjs

@@ -219,7 +219,7 @@ test('the usage-wrapup plan adds this repository marketplace and installs the pl
     assert.equal(plan.executable, 'claude');
     assert.equal(plan.homeVariable, 'CLAUDE_CONFIG_DIR');
     assert.deepEqual(plan.commands, [
-        ['plugin', 'marketplace', 'add', 'jl-cmd/claude-dev-env', '--sparse', '.claude-plugin', 'packages/usage-wrapup'],
+        ['plugin', 'marketplace', 'add', 'jl-cmd-projects/claude-dev-env', '--sparse', '.claude-plugin', 'packages/usage-wrapup'],
         ['plugin', 'install', 'usage-wrapup@claude-dev-env'],
     ]);
 });
@@ -237,7 +237,7 @@ test('installing usage-wrapup runs only the Claude commands, inside the managed
     assert.deepEqual(runner.calls.map(call => [call.executable, ...call.commandArguments]), [
         ['claude', 'plugin', 'uninstall', 'usage-wrapup@claude-dev-env'],
         ['claude', 'plugin', 'marketplace', 'remove', 'claude-dev-env'],
-        ['claude', 'plugin', 'marketplace', 'add', 'jl-cmd/claude-dev-env', '--sparse', '.claude-plugin', 'packages/usage-wrapup'],
+        ['claude', 'plugin', 'marketplace', 'add', 'jl-cmd-projects/claude-dev-env', '--sparse', '.claude-plugin', 'packages/usage-wrapup'],
         ['claude', 'plugin', 'install', 'usage-wrapup@claude-dev-env'],
     ]);
     for (const call of runner.calls) {
@@ -297,7 +297,7 @@ test('should remove and add the shared marketplace once when installing usage-wr
         ['claude', 'plugin', 'uninstall', 'subagent-models@claude-dev-env'],
         ['claude', 'plugin', 'marketplace', 'remove', 'claude-dev-env'],
         [
-            'claude', 'plugin', 'marketplace', 'add', 'jl-cmd/claude-dev-env',
+            'claude', 'plugin', 'marketplace', 'add', 'jl-cmd-projects/claude-dev-env',
             '--sparse', '.claude-plugin', 'packages/usage-wrapup', 'packages/subagent-models',
         ],
         ['claude', 'plugin', 'install', 'usage-wrapup@claude-dev-env'],
@@ -308,7 +308,7 @@ test('should remove and add the shared marketplace once when installing usage-wr
 test('should refuse one plan for plugins from two marketplaces', () => {
     assert.throws(
         () => marketplacePluginsPlan([PSTACK_PLUGIN_SPEC, SUBAGENT_MODELS_PLUGIN_SPEC], 'claude'),
-        /subagent-models comes from jl-cmd\/claude-dev-env/,
+        /subagent-models comes from jl-cmd-projects\/claude-dev-env/,
     );
 });
 

package/bin/install.profile-settings.test.mjs

@@ -1,7 +1,8 @@
 /**
- * Installing twice into a profile root under ~/.claude-profiles leaves exactly
- * one session-title gate Stop hook, that hook runs the gate under ~/.claude, and
- * the second install leaves settings.json byte for byte.
+ * Installing into a profile root under ~/.claude-profiles retires the profile
+ * session-title gate an earlier install left: its Stop hook and allow rule leave
+ * settings.json, its files leave ~/.claude, and a second install leaves
+ * settings.json byte for byte.
  */
 
 import { test } from 'node:test';
@@ -12,7 +13,11 @@ import { tmpdir } from 'node:os';
 import { fileURLToPath } from 'node:url';
 import { spawnSync } from 'node:child_process';
 
-import { ALL_SESSION_TITLE_GATE_RELATIVE_PATHS, SESSION_TITLE_GATE_FILE_NAME } from './merge_profile_settings.mjs';
+import {
+    RETIRED_SESSION_TITLE_GATE_COMMAND,
+    RETIRED_SESSION_TITLE_GATE_FILE_NAME,
+    RETIRED_SESSION_TITLE_GATE_PERMISSION,
+} from './merge_profile_settings.mjs';
 
 const INSTALLER_PATH = fileURLToPath(new URL('./install.mjs', import.meta.url));
 
@@ -46,31 +51,33 @@ function stopHookCommands(settingsPath) {
     );
 }
 
-test('two installs into a profile root keep one gate Stop hook that runs the gate under ~/.claude', () => {
+test('an install retires the profile gate, and a second install leaves settings.json byte for byte', () => {
     const homeDirectory = mkdtempSync(join(tmpdir(), 'cdev-profile-settings-'));
     try {
         writeFileSync(join(homeDirectory, '.gitconfig'), '');
         const profileRoot = join(homeDirectory, '.claude-profiles', 'work');
         mkdirSync(profileRoot, { recursive: true });
         const settingsPath = join(profileRoot, 'settings.json');
-        const forwardSlashedHome = homeDirectory.replace(/\\/g, '/');
-        const expectedGateCommand = `python3 ${forwardSlashedHome}/.claude/${SESSION_TITLE_GATE_FILE_NAME}`;
+        writeFileSync(settingsPath, JSON.stringify({
+            hooks: { Stop: [{ hooks: [{ type: 'command', command: RETIRED_SESSION_TITLE_GATE_COMMAND, timeout: 10 }] }] },
+            permissions: { allow: [RETIRED_SESSION_TITLE_GATE_PERMISSION] },
+        }, null, 4) + '\n');
+        const retiredGatePath = join(homeDirectory, '.claude', RETIRED_SESSION_TITLE_GATE_FILE_NAME);
+        mkdirSync(join(homeDirectory, '.claude'), { recursive: true });
+        writeFileSync(retiredGatePath, 'gate\n');
 
         runCoreInstall(homeDirectory, profileRoot);
         const settingsBytesAfterFirstInstall = readFileSync(settingsPath);
         runCoreInstall(homeDirectory, profileRoot);
 
         assert.deepEqual(readFileSync(settingsPath), settingsBytesAfterFirstInstall, 'second install leaves settings.json byte for byte');
-
-        const allGateCommands = stopHookCommands(settingsPath)
-            .filter((eachCommand) => eachCommand.includes(SESSION_TITLE_GATE_FILE_NAME));
-        assert.deepEqual(allGateCommands, [expectedGateCommand]);
-        for (const eachRelativePath of ALL_SESSION_TITLE_GATE_RELATIVE_PATHS) {
-            assert.ok(
-                existsSync(join(homeDirectory, '.claude', eachRelativePath)),
-                `${eachRelativePath} is installed under ~/.claude`,
-            );
-        }
+        assert.deepEqual(
+            stopHookCommands(settingsPath).filter((eachCommand) => eachCommand.includes(RETIRED_SESSION_TITLE_GATE_FILE_NAME)),
+            [],
+        );
+        const settings = JSON.parse(readFileSync(settingsPath, 'utf8'));
+        assert.equal((settings.permissions?.allow ?? []).includes(RETIRED_SESSION_TITLE_GATE_PERMISSION), false);
+        assert.equal(existsSync(retiredGatePath), false);
     } finally {
         rmSync(homeDirectory, { recursive: true, force: true });
     }

package/bin/install.test.mjs

@@ -3327,7 +3327,7 @@ test('a pstack install after a --no-pstack install seeds the Codex model sheet',
 const USAGE_WRAPUP_CLAUDE_COMMANDS = Object.freeze([
     'claude plugin uninstall usage-wrapup@claude-dev-env',
     'claude plugin marketplace remove claude-dev-env',
-    'claude plugin marketplace add jl-cmd/claude-dev-env --sparse .claude-plugin packages/usage-wrapup',
+    'claude plugin marketplace add jl-cmd-projects/claude-dev-env --sparse .claude-plugin packages/usage-wrapup',
     'claude plugin install usage-wrapup@claude-dev-env',
 ]);
 
@@ -3405,7 +3405,7 @@ const REPOSITORY_PLUGIN_CLAUDE_COMMANDS = Object.freeze([
     'claude plugin uninstall usage-wrapup@claude-dev-env',
     'claude plugin uninstall subagent-models@claude-dev-env',
     'claude plugin marketplace remove claude-dev-env',
-    'claude plugin marketplace add jl-cmd/claude-dev-env --sparse .claude-plugin packages/usage-wrapup packages/subagent-models',
+    'claude plugin marketplace add jl-cmd-projects/claude-dev-env --sparse .claude-plugin packages/usage-wrapup packages/subagent-models',
     'claude plugin install usage-wrapup@claude-dev-env',
     'claude plugin install subagent-models@claude-dev-env',
 ]);

package/bin/merge_profile_settings.mjs

@@ -7,11 +7,16 @@
  * Before the first change to a file, the merge copies that file to a
  * timestamped `.bak` beside it.
  *
- * Run `node merge_profile_settings.mjs --dry-run` to list the additions for
+ * Each run also retires the profile-level session-title Stop gate an earlier
+ * install copied to `~/.claude`. The plugin's own session-title stop gate does
+ * that job, so the merge removes the profile gate's Stop hook and allow rule
+ * from each file and deletes the gate files.
+ *
+ * Run `node merge_profile_settings.mjs --dry-run` to list the changes for
  * every profile on this machine without writing anything.
  */
 
-import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -26,14 +31,13 @@ import {
 import { resolveProfilesRootDirectory } from './select-install-targets.mjs';
 
 export const DRY_RUN_FLAG = '--dry-run';
-export const SESSION_TITLE_GATE_FILE_NAME = 'session_title_status_gate.py';
-export const SESSION_TITLE_GATE_SOURCE_DIRECTORY = fileURLToPath(new URL('../profile-settings/', import.meta.url));
-export const ALL_SESSION_TITLE_GATE_RELATIVE_PATHS = Object.freeze([
-    SESSION_TITLE_GATE_FILE_NAME,
-    join('config', '__init__.py'),
-    join('config', 'session_title_gate_constants.py'),
-]);
-export const SESSION_TITLE_GATE_COMMAND = `python3 ~/.claude/${SESSION_TITLE_GATE_FILE_NAME}`;
+export const RETIRED_SESSION_TITLE_GATE_FILE_NAME = 'session_title_status_gate.py';
+export const RETIRED_SESSION_TITLE_GATE_CONFIG_DIRECTORY_NAME = 'config';
+export const RETIRED_SESSION_TITLE_GATE_CONSTANTS_FILE_NAME = 'session_title_gate_constants.py';
+export const RETIRED_SESSION_TITLE_GATE_PACKAGE_INIT_TEXT =
+    '"""Constants package installed beside the Stop hook gate."""\n';
+export const RETIRED_SESSION_TITLE_GATE_COMMAND = `python3 ~/.claude/${RETIRED_SESSION_TITLE_GATE_FILE_NAME}`;
+export const RETIRED_SESSION_TITLE_GATE_PERMISSION = `Bash(${RETIRED_SESSION_TITLE_GATE_COMMAND}:*)`;
 export const AUTO_MODE_DEFAULTS_ENTRY = '$defaults';
 
 const DEFAULT_SETTINGS_INDENT = '    ';
@@ -45,22 +49,11 @@ const DEFAULT_HOST_CONFIGURATION_INDENT = '  ';
 
 /** @type {readonly DeclaredListEntries[]} */
 export const DECLARED_PROFILE_SETTINGS = Object.freeze([
-    {
-        keyPath: ['hooks', 'Stop'],
-        items: [
-            {
-                hooks: [
-                    { type: 'command', command: SESSION_TITLE_GATE_COMMAND, timeout: 10 },
-                ],
-            },
-        ],
-    },
     {
         keyPath: ['permissions', 'allow'],
         items: [
             'mcp__claude-code-remote__set_session_title',
             'mcp__ccd_session_mgmt__set_session_title',
-            `Bash(${SESSION_TITLE_GATE_COMMAND}:*)`,
             'Bash(python ~/.claude/scripts/account_broker.py run:*)',
         ],
     },
@@ -125,30 +118,49 @@ export function mergeDeclaredProfileSettings(settings, declaredSettings, homeDir
         for (const eachItem of items) {
             if (listHoldsItem(targetList, eachItem, homeDirectory)) continue;
             const addedItem = itemWithExpandedHookCommands(eachItem, homeDirectory);
-            const stopGroup = keyPath.join('.') === 'hooks.Stop'
-                ? targetList.find((eachGroup) => (
-                    eachGroup?.matcher === addedItem.matcher && Array.isArray(eachGroup?.hooks)
-                ))
-                : null;
-            if (stopGroup) {
-                const managedGateIndex = stopGroup.hooks.findIndex(
-                    (eachHook) => typeof eachHook?.command === 'string'
-                        && eachHook.command.replace(/\\/g, '/').includes('/hooks/blocking/session_title_stop_gate.py'),
-                );
-                stopGroup.hooks.splice(
-                    managedGateIndex < 0 ? stopGroup.hooks.length : managedGateIndex,
-                    0,
-                    ...addedItem.hooks,
-                );
-            } else {
-                targetList.push(addedItem);
-            }
+            targetList.push(addedItem);
             allAdditions.push(`${keyPath.join('.')}: ${JSON.stringify(addedItem)}`);
         }
     }
     return allAdditions;
 }
 
+/**
+ * Remove the retired profile gate's Stop hook and allow rule from one settings object.
+ *
+ * A Stop group left with no hook goes too, and so does an emptied Stop list or
+ * hooks object, so the file holds no husk of the retired entry.
+ *
+ * @param {Record<string, any>} settings
+ * @param {string} homeDirectory
+ * @returns {string[]} One description per removed entry.
+ */
+export function removeRetiredSessionTitleGate(settings, homeDirectory) {
+    const allRemovals = [];
+    const retiredCommandKey = hookCommandComparisonKey(RETIRED_SESSION_TITLE_GATE_COMMAND, homeDirectory);
+    const hooks = settings.hooks;
+    if (hooks && typeof hooks === 'object' && Array.isArray(hooks.Stop)) {
+        for (const eachGroup of hooks.Stop) {
+            if (!Array.isArray(eachGroup?.hooks)) continue;
+            eachGroup.hooks = eachGroup.hooks.filter((eachHook) => {
+                const isRetired = typeof eachHook?.command === 'string'
+                    && hookCommandComparisonKey(eachHook.command, homeDirectory) === retiredCommandKey;
+                if (isRetired) allRemovals.push(`hooks.Stop: ${eachHook.command}`);
+                return !isRetired;
+            });
+        }
+        hooks.Stop = hooks.Stop.filter((eachGroup) => !Array.isArray(eachGroup?.hooks) || eachGroup.hooks.length > 0);
+        if (hooks.Stop.length === 0) delete hooks.Stop;
+        if (Object.keys(hooks).length === 0) delete settings.hooks;
+    }
+    const allowList = settings.permissions?.allow;
+    if (Array.isArray(allowList) && allowList.includes(RETIRED_SESSION_TITLE_GATE_PERMISSION)) {
+        settings.permissions.allow = allowList.filter((eachRule) => eachRule !== RETIRED_SESSION_TITLE_GATE_PERMISSION);
+        allRemovals.push(`permissions.allow: ${RETIRED_SESSION_TITLE_GATE_PERMISSION}`);
+    }
+    return allRemovals;
+}
+
 /**
  * Merge the declared entries into one settings.json.
  *
@@ -163,13 +175,14 @@ export function mergeProfileSettingsFile(settingsPath, options) {
     if (!settings || typeof settings !== 'object' || Array.isArray(settings)) {
         throw new Error(`${settingsPath} holds a value other than a JSON object`);
     }
+    const removals = removeRetiredSessionTitleGate(settings, options.homeDirectory);
     const additions = mergeDeclaredProfileSettings(
         settings,
         options.declaredSettings ?? DECLARED_PROFILE_SETTINGS,
         options.homeDirectory,
     );
-    if (additions.length === 0 || options.dryRun) {
-        return { settingsPath, additions, backupPath: null };
+    if ((additions.length === 0 && removals.length === 0) || options.dryRun) {
+        return { settingsPath, additions, removals, backupPath: null };
     }
     let backupPath = null;
     if (settingsText) {
@@ -181,48 +194,57 @@ export function mergeProfileSettingsFile(settingsPath, options) {
         settingsPath,
         JSON.stringify(settings, null, hostConfigurationIndent(settingsText, DEFAULT_SETTINGS_INDENT)) + '\n',
     );
-    return { settingsPath, additions, backupPath };
+    return { settingsPath, additions, removals, backupPath };
 }
 
 /**
- * Copy the session-title gate and its constants module to `~/.claude` when a copy is absent or differs.
+ * Delete the retired profile gate and its constants package from `~/.claude`.
  *
- * The Stop hook entry runs the gate, so both files have to land before the entry does.
+ * The package's `__init__.py` goes only while it still holds the text the
+ * installer wrote, and the config directory goes only once nothing else is
+ * left in it, so a user's own files there stay.
  *
  * @param {{ homeDirectory: string, dryRun: boolean }} options
- * @returns {{ gatePath: string, changed: boolean }}
+ * @returns {{ removedPaths: string[] }}
  */
-export function installSessionTitleGate(options) {
+export function retireSessionTitleGate(options) {
     const claudeDirectory = join(options.homeDirectory, DEFAULT_CLAUDE_DIRECTORY_NAME);
-    const allStaleRelativePaths = ALL_SESSION_TITLE_GATE_RELATIVE_PATHS.filter((eachRelativePath) => {
-        const targetPath = join(claudeDirectory, eachRelativePath);
-        const sourceText = readFileSync(join(SESSION_TITLE_GATE_SOURCE_DIRECTORY, eachRelativePath), 'utf8');
-        return !existsSync(targetPath) || readFileSync(targetPath, 'utf8') !== sourceText;
-    });
-    if (!options.dryRun) {
-        for (const eachRelativePath of allStaleRelativePaths) {
-            const targetPath = join(claudeDirectory, eachRelativePath);
-            mkdirSync(dirname(targetPath), { recursive: true });
-            copyFileSync(join(SESSION_TITLE_GATE_SOURCE_DIRECTORY, eachRelativePath), targetPath);
+    const configDirectory = join(claudeDirectory, RETIRED_SESSION_TITLE_GATE_CONFIG_DIRECTORY_NAME);
+    const packageInitPath = join(configDirectory, '__init__.py');
+    const allRetiredPaths = [
+        join(claudeDirectory, RETIRED_SESSION_TITLE_GATE_FILE_NAME),
+        join(configDirectory, RETIRED_SESSION_TITLE_GATE_CONSTANTS_FILE_NAME),
+    ];
+    if (existsSync(packageInitPath) && readFileSync(packageInitPath, 'utf8') === RETIRED_SESSION_TITLE_GATE_PACKAGE_INIT_TEXT) {
+        allRetiredPaths.push(packageInitPath);
+    }
+    const removedPaths = allRetiredPaths.filter((eachPath) => existsSync(eachPath));
+    if (options.dryRun) {
+        return { removedPaths };
+    }
+    for (const eachPath of removedPaths) {
+        rmSync(eachPath);
+    }
+    if (existsSync(configDirectory)) {
+        const allLeftEntries = readdirSync(configDirectory).filter((eachName) => eachName !== '__pycache__');
+        if (allLeftEntries.length === 0) {
+            rmSync(configDirectory, { recursive: true, force: true });
         }
     }
-    return {
-        gatePath: join(claudeDirectory, SESSION_TITLE_GATE_FILE_NAME),
-        changed: allStaleRelativePaths.length > 0,
-    };
+    return { removedPaths };
 }
 
 /**
- * Install the gate, then merge the declared entries into each settings.json.
+ * Retire the profile gate, then merge the declared entries into each settings.json.
  *
  * @param {string[]} allSettingsPaths
  * @param {{ dryRun: boolean, homeDirectory: string, now?: Date }} options
- * @returns {{ gate: { gatePath: string, changed: boolean },
- *   files: { settingsPath: string, additions: string[], backupPath: string | null }[] }}
+ * @returns {{ gate: { removedPaths: string[] },
+ *   files: { settingsPath: string, additions: string[], removals: string[], backupPath: string | null }[] }}
  */
 export function mergeProfileSettings(allSettingsPaths, options) {
     const timestamp = (options.now ?? new Date()).toISOString().replace(/[:.]/g, '-');
-    const gate = installSessionTitleGate(options);
+    const gate = retireSessionTitleGate(options);
     const files = allSettingsPaths.map((eachPath) => mergeProfileSettingsFile(eachPath, {
         dryRun: options.dryRun,
         homeDirectory: options.homeDirectory,
@@ -232,25 +254,26 @@ export function mergeProfileSettings(allSettingsPaths, options) {
 }
 
 /**
- * @param {{ gate: { gatePath: string, changed: boolean },
- *   files: { settingsPath: string, additions: string[], backupPath: string | null }[] }} outcome
+ * @param {{ gate: { removedPaths: string[] },
+ *   files: { settingsPath: string, additions: string[], removals: string[], backupPath: string | null }[] }} outcome
  * @param {boolean} isDryRun
  * @returns {string[]}
  */
 export function describeProfileSettingsOutcome(outcome, isDryRun) {
-    const verb = isDryRun ? 'would add' : 'added';
-    const allLines = [
-        outcome.gate.changed
-            ? `${outcome.gate.gatePath}: ${isDryRun ? 'would copy' : 'copied'} session-title gate`
-            : `${outcome.gate.gatePath}: gate current`,
-    ];
-    for (const { settingsPath, additions, backupPath } of outcome.files) {
-        if (additions.length === 0) {
+    const addVerb = isDryRun ? 'would add' : 'added';
+    const removeVerb = isDryRun ? 'would remove' : 'removed';
+    const allLines = outcome.gate.removedPaths.map(
+        (eachPath) => `${eachPath}: ${removeVerb} retired session-title gate file`,
+    );
+    for (const { settingsPath, additions, removals, backupPath } of outcome.files) {
+        if (additions.length === 0 && removals.length === 0) {
             allLines.push(`${settingsPath}: no change`);
             continue;
         }
-        allLines.push(`${settingsPath}: ${verb} ${additions.length}${backupPath ? ` (backup ${backupPath})` : ''}`);
-        allLines.push(...additions.map((eachAddition) => `  ${eachAddition}`));
+        const backupNote = backupPath ? ` (backup ${backupPath})` : '';
+        allLines.push(`${settingsPath}: ${addVerb} ${additions.length}, ${removeVerb} ${removals.length}${backupNote}`);
+        allLines.push(...additions.map((eachAddition) => `  + ${eachAddition}`));
+        allLines.push(...removals.map((eachRemoval) => `  - ${eachRemoval}`));
     }
     return allLines;
 }

package/bin/merge_profile_settings.test.mjs

@@ -1,21 +1,23 @@
 import { test } from 'node:test';
 import { strict as assert } from 'node:assert';
-import { existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join, resolve } from 'node:path';
 
 import {
-    ALL_SESSION_TITLE_GATE_RELATIVE_PATHS,
     AUTO_MODE_DEFAULTS_ENTRY,
     DECLARED_PROFILE_SETTINGS,
-    SESSION_TITLE_GATE_FILE_NAME,
-    SESSION_TITLE_GATE_SOURCE_DIRECTORY,
+    RETIRED_SESSION_TITLE_GATE_CONSTANTS_FILE_NAME,
+    RETIRED_SESSION_TITLE_GATE_FILE_NAME,
+    RETIRED_SESSION_TITLE_GATE_PACKAGE_INIT_TEXT,
+    RETIRED_SESSION_TITLE_GATE_PERMISSION,
     discoverProfileSettingsPaths,
     mergeProfileSettings,
 } from './merge_profile_settings.mjs';
 
 const FIXED_NOW = new Date('2026-10-04T12:00:00.000Z');
 const BACKUP_SUFFIX = '.2026-10-04T12-00-00-000Z.bak';
+const PLUGIN_STOP_GATE_COMMAND = 'python3 /plugin/hooks/blocking/session_title_stop_gate.py';
 const PERMISSION_ALLOW_ITEMS = DECLARED_PROFILE_SETTINGS
     .find((eachEntry) => eachEntry.keyPath.join('.') === 'permissions.allow').items;
 const AUTO_MODE_ALLOW_ITEMS = DECLARED_PROFILE_SETTINGS
@@ -38,15 +40,23 @@ function backupFiles(directory) {
     return readdirSync(directory).filter((eachName) => eachName.endsWith('.bak'));
 }
 
-function expandedGateCommand(homeDirectory) {
-    return `python3 ${homeDirectory.replace(/\\/g, '/')}/.claude/${SESSION_TITLE_GATE_FILE_NAME}`;
+function expandedRetiredGateCommand(homeDirectory) {
+    return `python3 ${homeDirectory.replace(/\\/g, '/')}/.claude/${RETIRED_SESSION_TITLE_GATE_FILE_NAME}`;
 }
 
 function stopCommands(settings) {
-    return settings.hooks.Stop.flatMap((eachGroup) => eachGroup.hooks.map((eachHook) => eachHook.command));
+    return (settings.hooks?.Stop ?? []).flatMap((eachGroup) => eachGroup.hooks.map((eachHook) => eachHook.command));
 }
 
-test('a missing settings.json is created with every declared entry and the gate is copied', () => {
+function installRetiredGateFiles(claudeDirectory) {
+    mkdirSync(join(claudeDirectory, 'config', '__pycache__'), { recursive: true });
+    writeFileSync(join(claudeDirectory, RETIRED_SESSION_TITLE_GATE_FILE_NAME), 'gate\n');
+    writeFileSync(join(claudeDirectory, 'config', RETIRED_SESSION_TITLE_GATE_CONSTANTS_FILE_NAME), 'constants\n');
+    writeFileSync(join(claudeDirectory, 'config', '__init__.py'), RETIRED_SESSION_TITLE_GATE_PACKAGE_INIT_TEXT);
+    writeFileSync(join(claudeDirectory, 'config', '__pycache__', '__init__.cpython-311.pyc'), '');
+}
+
+test('a missing settings.json is created with every declared entry and no Stop hook', () => {
     const homeDirectory = makeHome();
     const claudeDirectory = join(homeDirectory, '.claude');
     mkdirSync(claudeDirectory);
@@ -55,33 +65,71 @@ test('a missing settings.json is created with every declared entry and the gate
     const outcome = mergeProfileSettings([settingsPath], { dryRun: false, homeDirectory, now: FIXED_NOW });
 
     assert.deepEqual(readSettings(settingsPath), {
-        hooks: {
-            Stop: [{ hooks: [{ type: 'command', command: expandedGateCommand(homeDirectory), timeout: 10 }] }],
-        },
         permissions: { allow: PERMISSION_ALLOW_ITEMS },
         autoMode: { allow: AUTO_MODE_ALLOW_ITEMS },
     });
     assert.equal(outcome.files[0].backupPath, null);
     assert.deepEqual(backupFiles(claudeDirectory), []);
-    for (const eachRelativePath of ALL_SESSION_TITLE_GATE_RELATIVE_PATHS) {
-        assert.equal(
-            readFileSync(join(claudeDirectory, eachRelativePath), 'utf8'),
-            readFileSync(join(SESSION_TITLE_GATE_SOURCE_DIRECTORY, eachRelativePath), 'utf8'),
-        );
-    }
+    assert.deepEqual(outcome.gate.removedPaths, []);
+});
+
+test('the retired profile gate leaves settings.json and ~/.claude, and the plugin gate stays', () => {
+    const homeDirectory = makeHome();
+    const claudeDirectory = join(homeDirectory, '.claude');
+    const settingsPath = join(claudeDirectory, 'settings.json');
+    writeSettings(settingsPath, {
+        hooks: {
+            Stop: [
+                {
+                    hooks: [
+                        { type: 'command', command: expandedRetiredGateCommand(homeDirectory), timeout: 10 },
+                        { type: 'command', command: PLUGIN_STOP_GATE_COMMAND },
+                    ],
+                },
+                { hooks: [{ type: 'command', command: expandedRetiredGateCommand(homeDirectory), timeout: 10 }] },
+            ],
+        },
+        permissions: { allow: ['Read', RETIRED_SESSION_TITLE_GATE_PERMISSION] },
+    });
+    installRetiredGateFiles(claudeDirectory);
+
+    const outcome = mergeProfileSettings([settingsPath], { dryRun: false, homeDirectory, now: FIXED_NOW });
+
+    const mergedSettings = readSettings(settingsPath);
+    assert.deepEqual(stopCommands(mergedSettings), [PLUGIN_STOP_GATE_COMMAND]);
+    assert.equal(mergedSettings.hooks.Stop.length, 1);
+    assert.equal(mergedSettings.permissions.allow.includes(RETIRED_SESSION_TITLE_GATE_PERMISSION), false);
+    assert.equal(outcome.files[0].removals.length, 3);
+    assert.equal(outcome.gate.removedPaths.length, 3);
+    assert.equal(existsSync(join(claudeDirectory, RETIRED_SESSION_TITLE_GATE_FILE_NAME)), false);
+    assert.equal(existsSync(join(claudeDirectory, 'config')), false);
 });
 
-test('a gate whose constants module is missing is reported changed and the module is copied', () => {
+test('a retired gate hook written with backslashes is removed, and an emptied hooks object goes', () => {
     const homeDirectory = makeHome();
     const settingsPath = join(homeDirectory, '.claude', 'settings.json');
+    const backslashedGateCommand = `python3 ${homeDirectory.replace(/\//g, '\\')}\\.claude\\${RETIRED_SESSION_TITLE_GATE_FILE_NAME}`;
+    writeSettings(settingsPath, {
+        hooks: { Stop: [{ hooks: [{ type: 'command', command: backslashedGateCommand, timeout: 10 }] }] },
+    });
+
     mergeProfileSettings([settingsPath], { dryRun: false, homeDirectory, now: FIXED_NOW });
-    const constantsPath = join(homeDirectory, '.claude', 'config', 'session_title_gate_constants.py');
-    unlinkSync(constantsPath);
 
-    const outcome = mergeProfileSettings([settingsPath], { dryRun: false, homeDirectory, now: FIXED_NOW });
+    assert.equal(readSettings(settingsPath).hooks, undefined);
+});
+
+test('a config directory holding other files keeps them and a changed __init__.py', () => {
+    const homeDirectory = makeHome();
+    const claudeDirectory = join(homeDirectory, '.claude');
+    installRetiredGateFiles(claudeDirectory);
+    writeFileSync(join(claudeDirectory, 'config', '__init__.py'), '"""Mine."""\n');
+    writeFileSync(join(claudeDirectory, 'config', 'mine.py'), 'VALUE = 1\n');
+
+    mergeProfileSettings([join(claudeDirectory, 'settings.json')], { dryRun: false, homeDirectory, now: FIXED_NOW });
 
-    assert.equal(outcome.gate.changed, true);
-    assert.equal(existsSync(constantsPath), true);
+    assert.equal(existsSync(join(claudeDirectory, 'config', RETIRED_SESSION_TITLE_GATE_CONSTANTS_FILE_NAME)), false);
+    assert.equal(readFileSync(join(claudeDirectory, 'config', '__init__.py'), 'utf8'), '"""Mine."""\n');
+    assert.equal(existsSync(join(claudeDirectory, 'config', 'mine.py')), true);
 });
 
 test('a file that already holds every entry is left byte for byte, with no backup', () => {
@@ -93,7 +141,7 @@ test('a file that already holds every entry is left byte for byte, with no backu
     const outcome = mergeProfileSettings([settingsPath], { dryRun: false, homeDirectory, now: FIXED_NOW });
 
     assert.deepEqual(outcome.files[0].additions, []);
-    assert.equal(outcome.gate.changed, false);
+    assert.deepEqual(outcome.files[0].removals, []);
     assert.equal(readFileSync(settingsPath, 'utf8'), textAfterFirstRun);
     assert.deepEqual(backupFiles(join(homeDirectory, '.claude')), []);
 });
@@ -104,7 +152,7 @@ test('a partial file gains only the missing entries, keeps other keys, and is ba
     const originalSettings = {
         model: 'opus',
         hooks: {
-            Stop: [{ hooks: [{ type: 'command', command: expandedGateCommand(homeDirectory), timeout: 30 }] }],
+            Stop: [{ hooks: [{ type: 'command', command: PLUGIN_STOP_GATE_COMMAND, timeout: 30 }] }],
             PreToolUse: [{ matcher: 'Bash', hooks: [{ type: 'command', command: 'python3 guard.py' }] }],
         },
         permissions: { allow: ['Read', 'mcp__claude-code-remote__set_session_title'], deny: ['Bash(rm:*)'] },
@@ -117,8 +165,7 @@ test('a partial file gains only the missing entries, keeps other keys, and is ba
 
     const mergedSettings = readSettings(settingsPath);
     assert.equal(mergedSettings.model, 'opus');
-    assert.deepEqual(mergedSettings.hooks.Stop, originalSettings.hooks.Stop);
-    assert.deepEqual(mergedSettings.hooks.PreToolUse, originalSettings.hooks.PreToolUse);
+    assert.deepEqual(mergedSettings.hooks, originalSettings.hooks);
     assert.deepEqual(mergedSettings.permissions.deny, ['Bash(rm:*)']);
     assert.deepEqual(mergedSettings.permissions.allow, [
         'Read',
@@ -132,31 +179,6 @@ test('a partial file gains only the missing entries, keeps other keys, and is ba
     assert.equal(readFileSync(outcome.files[0].backupPath, 'utf8'), originalText);
 });
 
-test('a gate hook written with backslashes counts as present', () => {
-    const homeDirectory = makeHome();
-    const settingsPath = join(homeDirectory, '.claude', 'settings.json');
-    const backslashedGateCommand = `python3 ${homeDirectory.replace(/\//g, '\\')}\\.claude\\${SESSION_TITLE_GATE_FILE_NAME}`;
-    writeSettings(settingsPath, {
-        hooks: { Stop: [{ hooks: [{ type: 'command', command: backslashedGateCommand, timeout: 10 }] }] },
-    });
-
-    mergeProfileSettings([settingsPath], { dryRun: false, homeDirectory, now: FIXED_NOW });
-
-    assert.deepEqual(stopCommands(readSettings(settingsPath)), [backslashedGateCommand]);
-});
-
-test('the gate hook is added beside a different Stop hook', () => {
-    const homeDirectory = makeHome();
-    const settingsPath = join(homeDirectory, '.claude', 'settings.json');
-    writeSettings(settingsPath, {
-        hooks: { Stop: [{ hooks: [{ type: 'command', command: 'python3 other_stop.py' }] }] },
-    });
-
-    mergeProfileSettings([settingsPath], { dryRun: false, homeDirectory, now: FIXED_NOW });
-
-    assert.deepEqual(stopCommands(readSettings(settingsPath)), ['python3 other_stop.py', expandedGateCommand(homeDirectory)]);
-});
-
 test('discovery finds the main, CLAUDE_CONFIG_DIR, and every profile settings.json once, and each is merged', () => {
     const homeDirectory = makeHome();
     const profilesRoot = join(homeDirectory, '.claude-profiles');
@@ -185,24 +207,27 @@ test('discovery finds the main, CLAUDE_CONFIG_DIR, and every profile settings.js
     ].sort());
     assert.equal(allSettingsPathsWithSharedConfig.length, 3);
     for (const eachPath of allSettingsPaths) {
-        assert.deepEqual(stopCommands(readSettings(eachPath)), [expandedGateCommand(homeDirectory)]);
+        assert.deepEqual(readSettings(eachPath).permissions.allow, PERMISSION_ALLOW_ITEMS);
         assert.deepEqual(readSettings(eachPath).autoMode.allow, AUTO_MODE_ALLOW_ITEMS);
     }
     assert.equal(readSettings(join(profilesRoot, 'work', 'settings.json')).model, 'work');
     assert.equal(backupFiles(join(profilesRoot, 'home')).length, 1);
 });
 
-test('a dry run reports additions and writes nothing', () => {
+test('a dry run reports additions and removals and writes nothing', () => {
     const homeDirectory = makeHome();
-    const settingsPath = join(homeDirectory, '.claude', 'settings.json');
-    writeSettings(settingsPath, { model: 'opus' });
+    const claudeDirectory = join(homeDirectory, '.claude');
+    const settingsPath = join(claudeDirectory, 'settings.json');
+    writeSettings(settingsPath, { model: 'opus', permissions: { allow: [RETIRED_SESSION_TITLE_GATE_PERMISSION] } });
+    installRetiredGateFiles(claudeDirectory);
     const originalText = readFileSync(settingsPath, 'utf8');
 
     const outcome = mergeProfileSettings([settingsPath], { dryRun: true, homeDirectory, now: FIXED_NOW });
 
-    assert.equal(outcome.files[0].additions.length, 7);
-    assert.equal(outcome.gate.changed, true);
+    assert.equal(outcome.files[0].additions.length, PERMISSION_ALLOW_ITEMS.length + AUTO_MODE_ALLOW_ITEMS.length);
+    assert.equal(outcome.files[0].removals.length, 1);
+    assert.equal(outcome.gate.removedPaths.length, 3);
     assert.equal(readFileSync(settingsPath, 'utf8'), originalText);
-    assert.deepEqual(backupFiles(join(homeDirectory, '.claude')), []);
-    assert.equal(existsSync(join(homeDirectory, '.claude', SESSION_TITLE_GATE_FILE_NAME)), false);
+    assert.deepEqual(backupFiles(claudeDirectory), []);
+    assert.equal(existsSync(join(claudeDirectory, RETIRED_SESSION_TITLE_GATE_FILE_NAME)), true);
 });

package/docs/account-broker.md

@@ -15,12 +15,12 @@ python scripts/account_broker.py accounts --product claude
 python scripts/account_broker.py choose --product codex
 python scripts/account_broker.py choose --product codex --spent account-name:1790000000
 python scripts/account_broker.py check --product codex
-python scripts/account_broker.py run --product claude --report report.json -- claude --output-format json -p "prompt"
+printf "%s" "prompt" | python scripts/account_broker.py run --product claude --report report.json -- claude --output-format json -p
 ```
 
 `accounts` prints the roster without reading meters. `choose` prints `decision`, `accounts`, and `state_path`. Each decision contains `action`, `account`, `home`, `reason`, `tier`, and `resets_at`. A wait decision has no account or home and includes the soonest reset in UTC. A failed meter read excludes the account for that choice. `--spent` saves an exclusion until the supplied Unix reset, the account's soonest known meter reset, or one hour when neither is available. A `--spent` name absent from the roster is saved until the supplied Unix reset, or for one hour when no reset is given. While any such mark is still in the future, `choose` waits until the soonest mark and exits 3, and with no Codex roster `--spent default` waits until that mark passes. Meter reads younger than 60 seconds are reused.
 
-`check` prints nothing and exits 3 while every account is below its floor. `run` sets `CLAUDE_CONFIG_DIR` or `CODEX_HOME` for each attempt. A Claude job also starts without the parent session's variables, such as `CLAUDE_CODE_SESSION_ID` and `CLAUDECODE`, so a child started from inside a Claude Code session runs as its own session. `ALL_PARENT_CLAUDE_SESSION_VARIABLES` lists them. It replays the same stdin bytes when a usage limit or start failure leads to another account. It writes the command's stdout to stdout and diagnostics to stderr. A resumed Claude session uses the account bound to its session when that account has room.
+`check` prints nothing and exits 3 while every account is below its floor. `run` sets `CLAUDE_CONFIG_DIR` or `CODEX_HOME` for each attempt. A Claude job also starts without the parent session's variables, such as `CLAUDE_CODE_SESSION_ID` and `CLAUDECODE`, so a child started from inside a Claude Code session runs as its own session. `ALL_PARENT_CLAUDE_SESSION_VARIABLES` lists them. It replays the same stdin bytes when a usage limit or start failure leads to another account. Send the prompt on stdin. When the command resolves to a `.cmd` or `.bat` file, the broker refuses an argument that holds a cmd.exe metacharacter and records `start_failed`. It writes the command's stdout to stdout and diagnostics to stderr. A resumed Claude session uses the account bound to its session when that account has room.
 
 The broker stores cached meters, spent marks, and Claude session bindings in one JSON file under `~/.claude/account-broker`. Every broker process for the same user reads that file, so a spent mark pauses that account for every job. A write holds an exclusive lock on the sibling `state.json.lock`, re-reads the file, merges, and swaps in a sibling temporary file with `os.replace`. The merge keeps the latest reset for each spent mark and the newest meter read for each account.
 

package/docs/rule-guides/session-title.md

@@ -8,6 +8,8 @@ Back to the [rule entry](../../rules/session-title.md).
 
 Before each turn ends, set the title to `<emoji> <name>`. Get the session id from `get_session` with no `session_id` when the tool asks for one.
 
+Set the title before the final reply, and set it in silence. The reply to the user carries no mention of the title, its emoji, or the reminder that asked for it. When a Stop hook asks for the title after the answer went out, make the call and end the turn with no text.
+
 ## Status emoji
 
 | Emoji | Use it when |

package/hooks/blocking/test_session_title_stop_gate.py

@@ -271,3 +271,11 @@ def test_stop_block_reason_names_the_seen_tool_when_the_turn_has_no_title() -> N
     ]
     block_reason = session_title_stop_gate.stop_block_reason(all_entries, is_remote_session=False)
     assert block_reason is not None and DESKTOP_TITLE_TOOL in block_reason
+
+
+def test_stop_block_reason_tells_the_model_to_set_the_title_in_silence() -> None:
+    all_entries = [prompt("Fix the runner"), tool_call("t1", REMOTE_TITLE_TOOL), prompt("Next")]
+    block_reason = session_title_stop_gate.stop_block_reason(all_entries, is_remote_session=True)
+    assert block_reason is not None
+    assert "Say nothing to the user about the title" in block_reason
+    assert "end with no text" in block_reason

package/hooks/hooks_constants/session_title_constants.py

@@ -51,6 +51,10 @@ STOP_BLOCK_REASON = (
     " two parts joined with ' + ', sentence case, no end punctuation,"
     " no dates, IDs, branch names or filler words."
     " Rename it when the scope of the work has changed."
+    " The title is a silent step: make the call and end the turn."
+    " Say nothing to the user about the title, its emoji or this reminder."
+    " When the user already has your answer this turn, end with no text."
+    " Next time, set the title before your final reply."
 )
 REMOTE_TITLE_TOOL_NAME = "mcp__claude-code-remote__set_session_title"
 UNKNOWN_TITLE_TOOL_NAME = "its name ends in __set_session_title"

package/installable-surfaces.manifest.json

@@ -10,8 +10,7 @@
     "system-prompts",
     "scripts",
     "_shared",
-    "audit-rubrics",
-    "profile-settings"
+    "audit-rubrics"
   ],
   "root_files": [
     "AGENTS.md",

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "claude-dev-env",
-    "version": "8.56.0",
+    "version": "8.56.2",
     "description": "Claude Code development standards — rules, hooks, agents, commands, and skills",
     "type": "module",
     "bin": {
@@ -25,7 +25,6 @@
         "settings.json",
         "installable-surfaces.manifest.json",
         "_shared/",
-        "profile-settings/",
         "audit-rubrics/",
         "codex-rules/",
         "pstack-codex-models.md",
@@ -50,7 +49,7 @@
     "license": "MIT",
     "repository": {
         "type": "git",
-        "url": "git+https://github.com/jl-cmd/claude-dev-env.git",
+        "url": "git+https://github.com/jl-cmd-projects/claude-dev-env.git",
         "directory": "packages/claude-dev-env"
     }
 }

package/profile-settings/config/__init__.py

@@ -1 +0,0 @@
-"""Constants package installed beside the Stop hook gate."""

package/profile-settings/config/session_title_gate_constants.py

@@ -1,15 +0,0 @@
-"""Constants for the session-title Stop hook gate."""
-
-ALL_TITLE_TOOL_NAMES = frozenset(
-    {
-        "mcp__claude-code-remote__set_session_title",
-        "mcp__ccd_session_mgmt__set_session_title",
-    }
-)
-INSTRUCTION = (
-    "Call set_session_title (session id from get_session) before you stop. "
-    'Title = "<emoji> <brief task name>", one line in a narrow sidebar. '
-    "\U0001f6a9 = Jon must act (question, approval, a step only he can do). "
-    "✅ = fully done (merged or nothing left). "
-    "⏳ = work, CI, or a merge queue still running and nothing waits on Jon."
-)

package/profile-settings/session_title_status_gate.py

@@ -1,77 +0,0 @@
-"""Stop hook that blocks until the session title is set with a status emoji."""
-
-import json
-import sys
-from typing import TextIO
-
-from config.session_title_gate_constants import ALL_TITLE_TOOL_NAMES, INSTRUCTION
-
-
-def _content_blocks(entry: dict) -> list:
-    content = entry.get("message", {}).get("content")
-    if isinstance(content, str):
-        return [{"type": "text", "text": content}]
-    return content if isinstance(content, list) else []
-
-
-def _is_user_text(entry: dict) -> bool:
-    if entry.get("type") != "user":
-        return False
-    return any(
-        block.get("type") == "text" and block.get("text", "").strip()
-        for block in _content_blocks(entry)
-        if isinstance(block, dict)
-    )
-
-
-def _is_title_call(entry: dict) -> bool:
-    if entry.get("type") != "assistant":
-        return False
-    return any(
-        block.get("type") == "tool_use" and block.get("name") in ALL_TITLE_TOOL_NAMES
-        for block in _content_blocks(entry)
-        if isinstance(block, dict)
-    )
-
-
-def title_set_since_last_user_text(all_transcript_lines: list[str]) -> bool:
-    """Report whether a title call follows the newest user text in the transcript.
-
-    Args:
-        all_transcript_lines: The transcript's JSONL lines, oldest first.
-
-    Returns:
-        True when a set_session_title call comes after the last user text.
-    """
-    for each_line in reversed(all_transcript_lines):
-        if not each_line.strip():
-            continue
-        entry = json.loads(each_line)
-        if _is_title_call(entry):
-            return True
-        if _is_user_text(entry):
-            return False
-    return False
-
-
-def main(decision_stream: TextIO) -> None:
-    """Block the stop with the title instruction when no title follows the last user text.
-
-    Args:
-        decision_stream: The stream that receives the Stop hook decision.
-    """
-    try:
-        payload = json.load(sys.stdin)
-        if payload.get("stop_hook_active"):
-            return
-        with open(payload["transcript_path"], encoding="utf-8") as transcript_file:
-            all_transcript_lines = transcript_file.readlines()
-        if title_set_since_last_user_text(all_transcript_lines):
-            return
-    except (OSError, KeyError, ValueError):
-        return
-    decision_stream.write(json.dumps({"decision": "block", "reason": INSTRUCTION}))
-
-
-if __name__ == "__main__":
-    main(sys.stdout)

package/profile-settings/test_session_title_status_gate.py

@@ -1,101 +0,0 @@
-"""Run the installed session-title gate as the Stop hook runs it."""
-
-import json
-import shutil
-import subprocess
-import sys
-from pathlib import Path
-
-GATE_SOURCE_DIRECTORY = Path(__file__).resolve().parent
-GATE_FILE_NAME = "session_title_status_gate.py"
-ALL_GATE_RELATIVE_PATHS = (
-    Path(GATE_FILE_NAME),
-    Path("config") / "__init__.py",
-    Path("config") / "session_title_gate_constants.py",
-)
-TITLE_TOOL_NAME = "mcp__claude-code-remote__set_session_title"
-
-
-def _install_gate(claude_directory: Path) -> Path:
-    for each_relative_path in ALL_GATE_RELATIVE_PATHS:
-        target_path = claude_directory / each_relative_path
-        target_path.parent.mkdir(parents=True, exist_ok=True)
-        shutil.copyfile(GATE_SOURCE_DIRECTORY / each_relative_path, target_path)
-    return claude_directory / GATE_FILE_NAME
-
-
-def _user_text_entry(text: str) -> dict:
-    return {"type": "user", "message": {"content": text}}
-
-
-def _title_call_entry() -> dict:
-    return {
-        "type": "assistant",
-        "message": {
-            "content": [{"type": "tool_use", "name": TITLE_TOOL_NAME, "input": {}}]
-        },
-    }
-
-
-def _run_gate(
-    tmp_path: Path, all_entries: list[dict], is_stop_hook_active: bool = False
-) -> str:
-    gate_path = _install_gate(tmp_path / ".claude")
-    transcript_path = tmp_path / "transcript.jsonl"
-    transcript_path.write_text(
-        "\n".join(json.dumps(each_entry) for each_entry in all_entries) + "\n\n",
-        encoding="utf-8",
-    )
-    payload = {
-        "transcript_path": str(transcript_path),
-        "stop_hook_active": is_stop_hook_active,
-    }
-    gate_run = subprocess.run(
-        [sys.executable, str(gate_path)],
-        input=json.dumps(payload),
-        capture_output=True,
-        text=True,
-        encoding="utf-8",
-        check=True,
-    )
-    return gate_run.stdout
-
-
-def should_allow_stop_when_title_follows_last_user_text(tmp_path: Path) -> None:
-    assert (
-        _run_gate(tmp_path, [_user_text_entry("fix the bug"), _title_call_entry()])
-        == ""
-    )
-
-
-def should_block_stop_when_user_text_follows_last_title(tmp_path: Path) -> None:
-    gate_output = _run_gate(
-        tmp_path, [_title_call_entry(), _user_text_entry("one more thing")]
-    )
-
-    decision = json.loads(gate_output)
-    assert decision["decision"] == "block"
-    assert "set_session_title" in decision["reason"]
-
-
-def should_allow_stop_when_stop_hook_is_already_active(tmp_path: Path) -> None:
-    assert (
-        _run_gate(tmp_path, [_user_text_entry("fix the bug")], is_stop_hook_active=True)
-        == ""
-    )
-
-
-def should_allow_stop_when_transcript_is_missing(tmp_path: Path) -> None:
-    gate_path = _install_gate(tmp_path / ".claude")
-    payload = {"transcript_path": str(tmp_path / "absent.jsonl")}
-
-    gate_run = subprocess.run(
-        [sys.executable, str(gate_path)],
-        input=json.dumps(payload),
-        capture_output=True,
-        text=True,
-        encoding="utf-8",
-        check=True,
-    )
-
-    assert gate_run.stdout == ""