claude-dev-env 8.56.1 → 8.57.0

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/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/docs/templates/artifact-page/README.md

@@ -16,6 +16,7 @@
 | Readable text | Text is 16px or larger and uses the full text color. Gray stays on lines and borders only. Text holds a 7:1 contrast ratio against its background. |
 | Touch targets | Buttons and chips are 40px or taller, with a visible focus ring. |
 | Copy fallback | The copy button uses the clipboard API and falls back to a hidden text area, then says when the copy is blocked. |
+| Review rounds | Parts changed since the viewer's last look carry a thin bar on their left edge, and changed cards a "Changed" label. [review-rounds.md](review-rounds.md) holds the data fields and behavior. |
 
 ## House rules for a page built from it
 

package/docs/templates/artifact-page/review-rounds.md

@@ -0,0 +1,26 @@
+# Marking what changed between review rounds
+
+A page that a reviewer reads more than once shows what changed since their last look. The template marks each changed card and each changed part with a thin bar on its left edge, gives each changed card a small "Changed" label, and gives each changed board chip a dot in the same color. There is no diff and no list of changes.
+
+## Data
+
+| Field | Where | Meaning |
+|---|---|---|
+| `round` | top of the data block | The review round this revision answers. Add one each time the page is republished after feedback. |
+| `changed_round` | an item | The round in which this item last changed. |
+| `changed_parts` | an item, optional | The parts that changed: `title`, `next`, `summary`, `steps`, `links`. With no list, only the card is marked. |
+
+When a revision answers feedback, set `round` to the new number and stamp each item it changed with that number and the parts it touched. Leave older stamps in place; they stop showing once the reviewer has seen their round.
+
+## Behavior
+
+- The page keeps the last round each viewer saw in `localStorage`. Parts stamped after that round are marked.
+- A first visit, or a browser that blocks storage, marks the parts stamped in the current round.
+- The marks hold through a reload in the same tab, through `sessionStorage`, and clear on the next visit.
+- A changed summary opens by itself.
+
+## Other pages
+
+Any element with `data-changed-round="N"` takes the bar. An element that holds a `data-change-slot` child gets the "Changed" label in that child; other elements get a screen reader label.
+
+The `--change` and `--change-ink` tokens hold the mark colors in light and dark. Keep the label text at 7:1 or better against `--change`, and the bar at 3:1 or better against `--surface` and `--bg`.

package/docs/templates/artifact-page/template.html

@@ -7,6 +7,7 @@
   --accent: #2245a2; --accent-soft: #e6ecfb; --accent-ink: #ffffff;
   --ok: #165737; --ok-soft: #e3f3ea; --bad: #8b2621; --bad-soft: #fbe5e3; --warn: #6f4100; --warn-soft: #fbf0dc;
   --violet: #553b95; --violet-soft: #efe9fa;
+  --change: #8a1f6b; --change-ink: #ffffff;
   --font-body: "Manrope", system-ui, -apple-system, "Segoe UI", sans-serif;
 }
 @media (prefers-color-scheme: dark) { :root:not([data-theme="light"]) {
@@ -14,12 +15,14 @@
   --accent: #a8bfff; --accent-soft: #1f2a45; --accent-ink: #0d1424;
   --ok: #6fd3a0; --ok-soft: #173327; --bad: #ffa8a0; --bad-soft: #3a1c1a; --warn: #f0b860; --warn-soft: #362a14;
   --violet: #c5b1f2; --violet-soft: #251f38;
+  --change: #f5a3dc; --change-ink: #1f0a19;
   color-scheme: dark } }
 :root[data-theme="dark"] {
   --bg: #12151b; --surface: #1a1f28; --fg: #e6e9ef; --edge: #6d7891; --line: #2b3240;
   --accent: #a8bfff; --accent-soft: #1f2a45; --accent-ink: #0d1424;
   --ok: #6fd3a0; --ok-soft: #173327; --bad: #ffa8a0; --bad-soft: #3a1c1a; --warn: #f0b860; --warn-soft: #362a14;
   --violet: #c5b1f2; --violet-soft: #251f38;
+  --change: #f5a3dc; --change-ink: #1f0a19;
   color-scheme: dark }
 * { box-sizing: border-box }
 body { background: var(--bg); color: var(--fg); font-family: var(--font-body); font-size: 17px; line-height: 1.4; padding-inline: 16px; padding-block: 24px 48px; margin: 0 }
@@ -95,6 +98,15 @@ details.what[open] summary::before { content: "▾" }
 .steps .sh { font-weight: 800 }
 .step { display: flex; gap: 10px; align-items: flex-start }
 .step .num { flex: none; width: 30px; height: 30px; border-radius: 50%; background: var(--warn); color: var(--surface); display: grid; place-items: center; font-weight: 800 }
+.lchip.changed::before { content: ""; width: 10px; height: 10px; border-radius: 50%; background: var(--change); flex: none }
+.changed { box-shadow: inset 4px 0 0 var(--change); padding-left: 12px; border-radius: 4px }
+.card.changed { box-shadow: inset 6px 0 0 var(--change); padding-left: 0; border-radius: 16px }
+.card.changed .band, .card.changed > .body { padding-left: 18px }
+.card.changed .body .changed { padding-left: 12px }
+.next.changed { border-radius: 12px }
+.lchip.changed { box-shadow: none; border-radius: 999px; padding-left: 10px; border-color: var(--change); display: inline-flex; align-items: center; gap: 6px }
+.pill-changed { display: inline-flex; align-items: center; min-height: 28px; padding: 0 10px; border-radius: 999px; background: var(--change); color: var(--change-ink); font-size: 16px; font-weight: 800 }
+.sr { position: absolute; width: 1px; height: 1px; overflow: hidden; clip-path: inset(50%); white-space: nowrap }
 .empty { background: var(--surface); border: 2px dashed var(--edge); border-radius: 14px; padding: 20px; font-weight: 600 }
 @media (hover: hover) { .lchip:hover, .fchip:hover, .tab:hover, .copy:hover { border-color: var(--accent) } }
 </style>
@@ -117,6 +129,7 @@ details.what[open] summary::before { content: "▾" }
 <script type="application/json" id="tracker-data">
 {
  "updated": "2026-01-15T17:30:00Z",
+ "round": 3,
  "owners": [
   {
    "key": "web",
@@ -147,6 +160,8 @@ details.what[open] summary::before { content: "▾" }
    "needs_you": true,
    "card": true,
    "next": "choose between the two dates in the linked plan.",
+   "changed_round": 3,
+   "changed_parts": ["next"],
    "summary": [
     "One release date everyone plans around",
     "The launch checklist dated backward from it",
@@ -167,6 +182,8 @@ details.what[open] summary::before { content: "▾" }
    "status": "blocked",
    "card": true,
    "next": "wait for the staging database to come back online.",
+   "changed_round": 2,
+   "changed_parts": ["next"],
    "summary": [
     "The login test passes ten runs in a row",
     "The root cause written in the pull request"
@@ -186,6 +203,8 @@ details.what[open] summary::before { content: "▾" }
    "status": "doing",
    "card": true,
    "next": "finish the index change and rerun the timing check.",
+   "changed_round": 3,
+   "changed_parts": ["summary"],
    "summary": [
     "Search answers in under one second",
     "A timing check that guards it",
@@ -288,6 +307,8 @@ const STAGE_BY_KEY = Object.fromEntries(STAGES.map(s => [s.key, s]));
 const TRACK = ["Card", "Builder", "Pull request", "Merged"];
 const state = { tab: "open", owner: "all", query: "" };
 try { const saved = JSON.parse(localStorage.getItem("work-tracker-view") || "{}"); if (saved.tab) state.tab = saved.tab; if (saved.owner) state.owner = saved.owner; } catch (e) {}
+const REVIEW_ROUND = Number(TRACKER.round) || 0;
+const CHANGE_BASELINE = changeBaseline();
 const ownerByKey = Object.fromEntries(TRACKER.owners.map(o => [o.key, o]));
 const isDone = it => it.status === "done";
 function stageOf(it) {
@@ -300,6 +321,34 @@ function stageOf(it) {
 const slug = it => "item-" + it.title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
 const fmt = iso => { if (!iso) return ""; try { return new Date(iso).toLocaleString(undefined, { month: "long", day: "numeric", hour: "numeric", minute: "2-digit" }); } catch (e) { return iso; } };
 const el = (tag, cls, text) => { const n = document.createElement(tag); if (cls) n.className = cls; if (text != null) n.textContent = text; return n; };
+function changeBaseline() {
+  try {
+    const held = JSON.parse(sessionStorage.getItem("work-tracker-baseline") || "null");
+    if (held && held.round === REVIEW_ROUND) return held.baseline;
+  } catch (e) {}
+  let baseline = REVIEW_ROUND - 1;
+  try {
+    const seen = localStorage.getItem("work-tracker-seen-round");
+    if (seen !== null && Number.isFinite(Number(seen))) baseline = Math.min(Number(seen), REVIEW_ROUND);
+  } catch (e) {}
+  try { sessionStorage.setItem("work-tracker-baseline", JSON.stringify({ round: REVIEW_ROUND, baseline })); } catch (e) {}
+  try { localStorage.setItem("work-tracker-seen-round", String(REVIEW_ROUND)); } catch (e) {}
+  return baseline;
+}
+function stampChange(node, it, part) {
+  if (it.changed_round && (!part || [].concat(it.changed_parts || []).includes(part))) node.dataset.changedRound = it.changed_round;
+  return node;
+}
+function markChanges() {
+  for (const node of document.querySelectorAll("[data-changed-round]")) {
+    if (Number(node.dataset.changedRound) <= CHANGE_BASELINE || node.classList.contains("changed")) continue;
+    node.classList.add("changed");
+    const slot = node.querySelector("[data-change-slot]");
+    if (slot) { slot.prepend(el("span", "pill-changed", "Changed")); continue; }
+    const label = node.querySelector(":scope > summary") || node;
+    label.prepend(el("span", "sr", "Changed. "));
+  }
+}
 function save() { try { localStorage.setItem("work-tracker-view", JSON.stringify({ tab: state.tab, owner: state.owner })); } catch (e) {} }
 function inView(it) {
   if ((state.tab === "done") !== isDone(it)) return false;
@@ -329,7 +378,7 @@ function renderBoard(items) {
     if (mine.length) {
       const chips = el("div", "lchips");
       for (const it of mine) {
-        const b = el("button", "lchip", it.title);
+        const b = stampChange(el("button", "lchip", it.title), it);
         b.setAttribute("aria-label", "Go to " + it.title);
         b.onclick = () => jumpTo(it);
         chips.append(b);
@@ -389,25 +438,27 @@ function copyButton(it) {
 }
 function itemCard(it) {
   const key = stageOf(it), s = STAGE_BY_KEY[key], owner = ownerByKey[it.owner] || { name: it.owner };
-  const card = el("article", "card " + key);
+  const card = stampChange(el("article", "card " + key), it);
   card.id = slug(it);
   const band = el("div", "band " + key);
+  band.dataset.changeSlot = "";
   band.append(el("span", null, s.icon), el("span", null, s.label));
   const proj = el("span", "proj");
   proj.append(el("span", null, (owner.icon || "📁")), el("span", null, owner.name));
   band.append(proj);
   card.append(band);
   const body = el("div", "body");
-  body.append(el("h3", "title", it.title));
+  body.append(stampChange(el("h3", "title", it.title), it, "title"));
   body.append(trackFor(it));
   if (it.next) {
-    const next = el("div", "next");
+    const next = stampChange(el("div", "next"), it, "next");
     next.append(el("span", "ic", isDone(it) ? "✅" : "👉"), el("span", null, it.next.charAt(0).toUpperCase() + it.next.slice(1)));
     body.append(next);
   }
   const points = [].concat(it.summary || []);
   if (points.length) {
-    const d = el("details", "what");
+    const d = stampChange(el("details", "what"), it, "summary");
+    d.open = d.dataset.changedRound > CHANGE_BASELINE;
     d.append(el("summary", null, "What it delivers"));
     const ul = el("ul", "points");
     for (const p of points) ul.append(el("li", null, p));
@@ -415,12 +466,12 @@ function itemCard(it) {
     body.append(d);
   }
   if (it.proposal && !isDone(it) && it.owner_steps && it.owner_steps.length) {
-    const st = el("div", "steps");
+    const st = stampChange(el("div", "steps"), it, "steps");
     st.append(el("div", "sh", "Your steps to create " + it.proposal.name));
     it.owner_steps.forEach((text, i) => { const row = el("div", "step"); row.append(el("span", "num", String(i + 1)), el("span", null, text)); st.append(row); });
     body.append(st);
   }
-  const actions = el("div", "actions");
+  const actions = stampChange(el("div", "actions"), it, "links");
   for (const l of it.links || []) {
     const a = el("a", "link");
     a.append(el("span", null, "🔗"), el("span", null, l.label));
@@ -458,6 +509,7 @@ function render() {
     list.append(h);
     mine.forEach(i => list.append(itemCard(i)));
   }
+  markChanges();
 }
 document.querySelectorAll(".tab").forEach(t => t.onclick = () => { state.tab = t.dataset.tab; save(); render(); });
 document.getElementById("search").oninput = e => { state.query = e.target.value; render(); };

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.1",
+    "version": "8.57.0",
     "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 == ""