claude-dev-env 8.85.1 → 8.85.2

package/bin/install.mjs

@@ -60,6 +60,10 @@ import {
     installMarketplacePlugins,
     shouldInstallMarketplacePlugin,
 } from './install-pstack-plugin.mjs';
+import {
+    DEEPSTACK_PLUGIN_SPEC,
+    installDeepStackForHosts,
+} from './install-deepstack-plugin.mjs';
 import { seedCodexPstackModels } from './seed-codex-pstack-models.mjs';
 import {
     codexSolSettingSnapshotPaths,
@@ -227,6 +231,7 @@ export const CORE_SKILLS = [
     'task-build',
     'eli5',
     'deepen',
+    'efficient-review',
 ];
 
 export function collectPackageSourceConflicts(packageDirectory) {
@@ -2938,6 +2943,24 @@ function executeInstallPlanMutations(plan, transactionHelpers) {
         }
         printPluginHostOutcomes([PSTACK_PLUGIN_SPEC], pstackPlugin);
     }
+    if (!selectedGroups && shouldInstallMarketplacePlugin(DEEPSTACK_PLUGIN_SPEC)) {
+        const deepStackPlugin = installDeepStackForHosts({
+            claudeRoot: CLAUDE_HOME,
+            codexHome: INSTALL_ROOT_RESOLUTION.codexHomeDirectory,
+            cursorDirectory: INSTALL_ROOT_RESOLUTION.cursorInstallDirectory,
+            firstTaskHookPath: join(
+                INSTALL_ROOT_RESOLUTION.hooksInstallDirectory,
+                'session',
+                'deepen_first_prompt.py',
+            ),
+        });
+        summary.deepStackPlugin = deepStackPlugin;
+        printPluginHostOutcomes([DEEPSTACK_PLUGIN_SPEC], deepStackPlugin);
+        const cursorOutcome = deepStackPlugin.cursor;
+        console.log(cursorOutcome.warning
+            ? `  DeepStack (cursor): ${cursorOutcome.status} — ${cursorOutcome.warning}`
+            : `  DeepStack (cursor): ${cursorOutcome.status}`);
+    }
     const allRepositoryPluginSpecs = [
         USAGE_WRAPUP_PLUGIN_SPEC,
         SUBAGENT_MODELS_PLUGIN_SPEC,
@@ -3484,6 +3507,7 @@ Usage:
   npx ${PACKAGE_NAME} --profile ID Install into one named profile root (under the profiles root)
   npx ${PACKAGE_NAME} --profiles A,B  Install into each selected profile (one ownership manifest per target)
   npx ${PACKAGE_NAME} --no-pstack  Full install without the pstack plugin (also CDE_INSTALL_PSTACK=0)
+  npx ${PACKAGE_NAME} --no-deepstack  Full install without the DeepStack plugin (also CDE_INSTALL_DEEPSTACK=0)
   npx ${PACKAGE_NAME} --no-usage-wrapup  Full install without the usage-wrapup plugin (also CDE_INSTALL_USAGE_WRAPUP=0)
   npx ${PACKAGE_NAME} --no-subagent-models  Full install without the subagent-models plugin (also CDE_INSTALL_SUBAGENT_MODELS=0)
   npx ${PACKAGE_NAME} --no-deepen-first-prompt  Full install without the deepen-first-prompt plugin (also CDE_INSTALL_DEEPEN_FIRST_PROMPT=0)

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

@@ -31,6 +31,7 @@ function installEnvironment(homeDirectory) {
         GIT_CONFIG_GLOBAL: join(homeDirectory, '.gitconfig'),
         CODEX_HOME: join(homeDirectory, '.codex'),
         CDE_INSTALL_PSTACK: '0',
+        CDE_INSTALL_DEEPSTACK: '0',
         CDE_INSTALL_USAGE_WRAPUP: '0',
     };
 }

package/bin/install.prune.test.mjs

@@ -64,6 +64,7 @@ const CORE_SKILL_DIRECTORIES = [
     'issue-tracker',
     'task-build',
     'eli5',
+    'efficient-review',
 ];
 const PRIOR_RUN_BACKUP_DIRECTORY_NAMES = [
     '2020-01-01T00-00-00-000Z',
@@ -262,6 +263,7 @@ function resolveInstallerInvocation(homeDirectory) {
         CLAUDE_CONFIG_DIR: undefined,
         LLM_SETTINGS_PROFILES_ROOT: undefined,
         CDE_INSTALL_PSTACK: '0',
+        CDE_INSTALL_DEEPSTACK: '0',
         CDE_INSTALL_USAGE_WRAPUP: '0',
         CDE_INSTALL_SUBAGENT_MODELS: '0',
         CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
@@ -802,6 +804,24 @@ test('a scoped --only install records the skill names it installed', () => {
     }
 });
 
+test('a fresh scoped core install includes efficient-review', () => {
+    const sandbox = createSandbox();
+    try {
+        runInstaller(sandbox.homeDirectory, ['--only', 'core']);
+        const skillPath = join(sandbox.skillsDirectory, 'efficient-review', 'SKILL.md');
+        const skillText = readFileSync(skillPath, 'utf8');
+        assert.match(skillText, /^name: efficient-review$/m);
+        assert.match(skillText, /\/efficient-review/);
+        assert.equal(readManifest(sandbox.manifestPath).skills.includes('efficient-review'), true);
+        assert.equal(
+            existsSync(join(sandbox.skillsDirectory, 'efficient-review', 'defaults.json')),
+            true,
+        );
+    } finally {
+        rmSync(sandbox.homeDirectory, { recursive: true, force: true });
+    }
+});
+
 test('a fresh scoped core install ships active skills and omits retired skills', () => {
     const sandbox = createSandbox();
     try {

package/bin/install.question-presentation.test.mjs

@@ -25,6 +25,7 @@ function installInScratchHome(homeDirectory, argumentsList = [], extraEnvironmen
             CLAUDE_CONFIG_DIR: undefined,
             LLM_SETTINGS_PROFILES_ROOT: undefined,
             CDE_INSTALL_PSTACK: '0',
+            CDE_INSTALL_DEEPSTACK: '0',
             CDE_INSTALL_USAGE_WRAPUP: '0',
             CDE_INSTALL_SUBAGENT_MODELS: '0',
             CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
@@ -182,6 +183,7 @@ test('a successful pstack install omits the retired skill block and gains the qu
 
     const installation = installInScratchHome(homeDirectory, [], {
         CDE_INSTALL_PSTACK: '1',
+        CDE_INSTALL_DEEPSTACK: '0',
         CDE_INSTALL_USAGE_WRAPUP: '0',
         CDE_INSTALL_SUBAGENT_MODELS: '0',
         CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
@@ -211,6 +213,7 @@ test('enabling pstack after a pstack-off install preserves question guidance', (
 
     const secondInstallation = installInScratchHome(homeDirectory, [], {
         CDE_INSTALL_PSTACK: '1',
+        CDE_INSTALL_DEEPSTACK: '0',
         CDE_INSTALL_USAGE_WRAPUP: '0',
         CDE_INSTALL_SUBAGENT_MODELS: '0',
         CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
@@ -241,6 +244,7 @@ test('a failed pstack transition restores question-only guidance and removes its
 
     const failedInstallation = installInScratchHome(homeDirectory, [], {
         CDE_INSTALL_PSTACK: '1',
+        CDE_INSTALL_DEEPSTACK: '0',
         CDE_INSTALL_USAGE_WRAPUP: '0',
         CDE_INSTALL_SUBAGENT_MODELS: '0',
         CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',

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

@@ -63,6 +63,7 @@ function runInstallerInSandbox(sandboxHome, installerArguments = []) {
             CLAUDE_CONFIG_DIR: undefined,
             LLM_SETTINGS_PROFILES_ROOT: undefined,
             CDE_INSTALL_PSTACK: '0',
+            CDE_INSTALL_DEEPSTACK: '0',
             CDE_INSTALL_USAGE_WRAPUP: '0',
             CDE_INSTALL_SUBAGENT_MODELS: '0',
             CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',

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

@@ -31,6 +31,7 @@ function installEnvironment(homeDirectory) {
         CLAUDE_CONFIG_DIR: '',
         GIT_CONFIG_GLOBAL: join(homeDirectory, '.gitconfig'),
         CDE_INSTALL_PSTACK: '0',
+        CDE_INSTALL_DEEPSTACK: '0',
         CDE_INSTALL_USAGE_WRAPUP: '0',
         CDE_INSTALL_SUBAGENT_MODELS: '0',
         CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',

package/bin/install.test.mjs

@@ -262,6 +262,11 @@ test('CORE_SKILLS ships deepen so the first-task skill installs with core', () =
     assert.equal(INSTALL_GROUPS.core.skills.includes('deepen'), true);
 });
 
+test('CORE_SKILLS ships efficient-review so a core install includes the skill', () => {
+    assert.ok(CORE_SKILLS.includes('efficient-review'), 'efficient-review must be in CORE_SKILLS');
+    assert.equal(INSTALL_GROUPS.core.skills.includes('efficient-review'), true);
+});
+
 test('CORE_SKILLS ships test-runner for explicit Django and Playwright readiness checks', () => {
     assert.ok(CORE_SKILLS.includes('test-runner'));
     assert.equal(INSTALL_GROUPS.core.skills.includes('test-runner'), true);
@@ -3040,6 +3045,7 @@ test('a failed update preserves an existing skills lookup pointer', () => {
             CLAUDE_CONFIG_DIR: '',
             GIT_CONFIG_GLOBAL: join(homeDirectory, '.gitconfig'),
             CDE_INSTALL_PSTACK: '0',
+            CDE_INSTALL_DEEPSTACK: '0',
             CDE_INSTALL_USAGE_WRAPUP: '0',
             CDE_INSTALL_SUBAGENT_MODELS: '0',
             CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
@@ -3094,6 +3100,7 @@ function runPstackInstaller(homeDirectory, extraArguments, environmentOverrides
             CLAUDE_CONFIG_DIR: join(homeDirectory, '.claude'),
             GIT_CONFIG_GLOBAL: join(homeDirectory, '.gitconfig'),
             CDE_INSTALL_PSTACK: '1',
+            CDE_INSTALL_DEEPSTACK: '0',
             CDE_INSTALL_USAGE_WRAPUP: '0',
             CDE_INSTALL_SUBAGENT_MODELS: '0',
             CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
@@ -3167,6 +3174,49 @@ test('a full install adds the pstack marketplace and plugin on both hosts', t =>
     assert.equal(manifest.files.includes(join(codexHome, 'AGENTS.md')), false);
 });
 
+test('a full install adds DeepStack for Claude, Codex, and Cursor', t => {
+    const sandbox = pstackPluginSandbox(t);
+    const sourceDirectory = join(sandbox.homeDirectory, 'deepstack-source');
+    mkdirSync(join(sourceDirectory, 'skills', 'deepstack-mode'), { recursive: true });
+    mkdirSync(join(sourceDirectory, 'hooks'), { recursive: true });
+    writeFileSync(join(sourceDirectory, 'skills', 'deepstack-mode', 'SKILL.md'), 'DeepStack intake\n');
+    writeFileSync(join(sourceDirectory, 'hooks', 'session-start.sh'), '#!/bin/sh\n', { mode: 0o755 });
+
+    const installerOutput = runPstackInstaller(sandbox.homeDirectory, [], {
+        ...sandbox.environment,
+        CDE_INSTALL_PSTACK: '0',
+        CDE_INSTALL_DEEPSTACK: '1',
+        CDE_DEEPSTACK_SOURCE: sourceDirectory,
+    });
+
+    assert.deepEqual(sandbox.recordedCommands(), [
+        'claude plugin uninstall deepstack@DeepStack',
+        'claude plugin marketplace remove DeepStack',
+        'claude plugin marketplace add jl-cmd-projects/DeepStack',
+        'claude plugin install deepstack@DeepStack',
+        'codex plugin remove deepstack@DeepStack',
+        'codex plugin marketplace remove DeepStack',
+        'codex plugin marketplace add jl-cmd-projects/DeepStack',
+        'codex plugin add deepstack@DeepStack',
+    ]);
+    assert.match(installerOutput, /DeepStack \(claude\): installed/);
+    assert.match(installerOutput, /DeepStack \(codex\): installed/);
+    assert.match(installerOutput, /DeepStack \(cursor\): installed/);
+    const cursorPlugin = join(sandbox.homeDirectory, '.cursor', 'plugins', 'deepstack');
+    assert.equal(
+        readFileSync(join(cursorPlugin, 'skills', 'deepstack-mode', 'SKILL.md'), 'utf8'),
+        'DeepStack intake\n',
+    );
+    const hooks = JSON.parse(readFileSync(join(sandbox.homeDirectory, '.cursor', 'hooks.json'), 'utf8'));
+    const hookText = JSON.stringify(hooks);
+    assert.match(hookText, /session-start\.sh/);
+    assert.match(hookText, /SessionStart/);
+    assert.match(hookText, /deepen_first_prompt\.py/);
+    assert.match(hookText, /UserPromptSubmit/);
+    const sheet = readFileSync(join(sandbox.homeDirectory, '.codex', 'deepstack-models.md'), 'utf8');
+    assert.match(sheet, /^session hook: on$/m);
+});
+
 test('a repeat install preserves Codex pstack configuration', t => {
     const sandbox = pstackPluginSandbox(t);
     const codexHome = join(sandbox.homeDirectory, '.codex');
@@ -3427,7 +3477,7 @@ test('the help output names the usage-wrapup opt-out beside the pstack one', ()
     });
 
     assert.equal(helpRun.status, 0, helpRun.stderr);
-    assert.match(helpRun.stdout, /--no-pstack .*\n.*--no-usage-wrapup .*CDE_INSTALL_USAGE_WRAPUP=0/);
+    assert.match(helpRun.stdout, /--no-pstack .*\n.*--no-deepstack .*CDE_INSTALL_DEEPSTACK=0.*\n.*--no-usage-wrapup .*CDE_INSTALL_USAGE_WRAPUP=0/);
     assert.match(helpRun.stdout, /--no-deepen-first-prompt .*CDE_INSTALL_DEEPEN_FIRST_PROMPT=0/);
 });
 

package/bin/install.transaction.test.mjs

@@ -88,6 +88,7 @@ test('capture and restore recover settings, manifest, files, and hooksPath', ()
         CLAUDE_CONFIG_DIR: undefined,
         LLM_SETTINGS_PROFILES_ROOT: undefined,
         CDE_INSTALL_PSTACK: '0',
+        CDE_INSTALL_DEEPSTACK: '0',
         CDE_INSTALL_USAGE_WRAPUP: '0',
         CDE_INSTALL_SUBAGENT_MODELS: '0',
         CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
@@ -154,6 +155,7 @@ test('capture and restore recover an additional host settings file', () => {
             CLAUDE_CONFIG_DIR: undefined,
             LLM_SETTINGS_PROFILES_ROOT: undefined,
             CDE_INSTALL_PSTACK: '0',
+            CDE_INSTALL_DEEPSTACK: '0',
             CDE_INSTALL_USAGE_WRAPUP: '0',
             CDE_INSTALL_SUBAGENT_MODELS: '0',
             CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
@@ -193,6 +195,7 @@ test('runWithInstallTransaction restores prior state on injected fault', () => {
         CLAUDE_CONFIG_DIR: undefined,
         LLM_SETTINGS_PROFILES_ROOT: undefined,
         CDE_INSTALL_PSTACK: '0',
+        CDE_INSTALL_DEEPSTACK: '0',
         CDE_INSTALL_USAGE_WRAPUP: '0',
         CDE_INSTALL_SUBAGENT_MODELS: '0',
         CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
@@ -251,6 +254,7 @@ test('runWithInstallTransaction commits and discards journal on success', () =>
             CLAUDE_CONFIG_DIR: undefined,
             LLM_SETTINGS_PROFILES_ROOT: undefined,
             CDE_INSTALL_PSTACK: '0',
+            CDE_INSTALL_DEEPSTACK: '0',
             CDE_INSTALL_USAGE_WRAPUP: '0',
             CDE_INSTALL_SUBAGENT_MODELS: '0',
             CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
@@ -298,6 +302,7 @@ function runInstaller(homeDirectory, extraArguments, options = {}) {
         CLAUDE_CONFIG_DIR: undefined,
         LLM_SETTINGS_PROFILES_ROOT: undefined,
         CDE_INSTALL_PSTACK: '0',
+        CDE_INSTALL_DEEPSTACK: '0',
         CDE_INSTALL_USAGE_WRAPUP: '0',
         CDE_INSTALL_SUBAGENT_MODELS: '0',
         CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
@@ -335,6 +340,7 @@ test('a later install fault removes newly seeded Codex pstack files', () => {
             faultPhase: FAULT_PHASES.AFTER_MANIFEST_WRITE,
             environment: {
                 CDE_INSTALL_PSTACK: '1',
+                CDE_INSTALL_DEEPSTACK: '0',
                 CDE_INSTALL_USAGE_WRAPUP: '0',
                 CDE_INSTALL_SUBAGENT_MODELS: '0',
                 CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
@@ -482,6 +488,7 @@ test('installer fault after_git_config restores prior core.hooksPath', () => {
                 CLAUDE_CONFIG_DIR: undefined,
                 LLM_SETTINGS_PROFILES_ROOT: undefined,
                 CDE_INSTALL_PSTACK: '0',
+                CDE_INSTALL_DEEPSTACK: '0',
                 CDE_INSTALL_USAGE_WRAPUP: '0',
                 CDE_INSTALL_SUBAGENT_MODELS: '0',
                 CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
@@ -503,6 +510,7 @@ test('installer fault after_git_config restores prior core.hooksPath', () => {
                 CLAUDE_CONFIG_DIR: undefined,
                 LLM_SETTINGS_PROFILES_ROOT: undefined,
                 CDE_INSTALL_PSTACK: '0',
+                CDE_INSTALL_DEEPSTACK: '0',
                 CDE_INSTALL_USAGE_WRAPUP: '0',
                 CDE_INSTALL_SUBAGENT_MODELS: '0',
                 CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',

package/bin/install.uninstall-transaction.test.mjs

@@ -74,6 +74,7 @@ function runInstaller(homeDirectory, extraArguments, options = {}) {
         CLAUDE_CONFIG_DIR: undefined,
         LLM_SETTINGS_PROFILES_ROOT: undefined,
         CDE_INSTALL_PSTACK: '0',
+        CDE_INSTALL_DEEPSTACK: '0',
         CDE_INSTALL_USAGE_WRAPUP: '0',
         CDE_INSTALL_SUBAGENT_MODELS: '0',
         CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',
@@ -312,6 +313,7 @@ test('uninstall fault after_git_config restores prior core.hooksPath', () => {
                 CLAUDE_CONFIG_DIR: undefined,
                 LLM_SETTINGS_PROFILES_ROOT: undefined,
                 CDE_INSTALL_PSTACK: '0',
+                CDE_INSTALL_DEEPSTACK: '0',
                 CDE_INSTALL_USAGE_WRAPUP: '0',
                 CDE_INSTALL_SUBAGENT_MODELS: '0',
                 CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',

package/bin/install.update-keeps-hooks.test.mjs

@@ -25,6 +25,7 @@ function installerEnvironment(homeDirectory) {
         CLAUDE_CONFIG_DIR: undefined,
         LLM_SETTINGS_PROFILES_ROOT: undefined,
         CDE_INSTALL_PSTACK: '0',
+        CDE_INSTALL_DEEPSTACK: '0',
         CDE_INSTALL_USAGE_WRAPUP: '0',
         CDE_INSTALL_SUBAGENT_MODELS: '0',
         CDE_INSTALL_DEEPEN_FIRST_PROMPT: '0',

package/docs/decisions/deepstack-install.md

@@ -0,0 +1,9 @@
+# DeepStack install
+
+The plugin lives in `jl-cmd-projects/DeepStack`. `npx claude-dev-env` installs plugin id `deepstack@DeepStack` for Claude Code and Codex, and copies it to `~/.cursor/plugins/deepstack` with the SessionStart hook and the first-task gate.
+
+The entry skill in that repository names these triggers:
+
+- DeepStack intake
+- DeepStack search leaf
+- DeepStack reproducible-check leaf

package/docs/rule-guides/deepstack-wording.md

@@ -0,0 +1,23 @@
+Back to the [rules index](../../rules/index.md).
+
+# DeepStack wording
+
+## In brief
+
+A deepened task uses the three DeepStack labels and puts `CDE_DEEPEN:v1` on line 1. The gate in `hooks/session/deepen_first_prompt.py` is the check. This guide cites that gate.
+
+**When this applies:** Writing a deepened task, a worker prompt, or a sentence that names the three DeepStack lines.
+
+## Labels
+
+- `SCOPE (role):` names the standing job in one sentence.
+- `EXAMPLES (illustration only):` lists each example, or `none`.
+- `ZOOM-IN BLOCKER:` names why the standing job cannot proceed, or `none`.
+
+Say "the user" in public text.
+
+## Where it is enforced
+
+| Surface | What runs |
+|---|---|
+| A first-task rewrite | `hooks/session/deepen_first_prompt.py` |

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "claude-dev-env",
-    "version": "8.85.1",
+    "version": "8.85.2",
     "description": "Claude Code development standards — rules, hooks, agents, commands, and skills",
     "type": "module",
     "bin": {

package/rules/deepstack-wording.md

@@ -0,0 +1,15 @@
+---
+paths:
+  - "**/*.md"
+  - "**/commands/**"
+---
+
+# DeepStack wording
+
+**When:** Writing a deepened task, a worker prompt, or a line that names the three DeepStack lines.
+
+Use these labels: `SCOPE (role):`, `EXAMPLES (illustration only):`, and `ZOOM-IN BLOCKER:`. Put `CDE_DEEPEN:v1` on line 1. Say "the user".
+
+**Enforcement:** `hooks/session/deepen_first_prompt.py` is the gate. This rule cites that gate.
+
+**Full text:** [guide](../docs/rule-guides/deepstack-wording.md). Read it when you write the three lines.