claude-dev-env 8.85.0 → 8.85.2

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

@@ -57,12 +57,12 @@ import {
 } from './install.mjs';
 import { EVER_SHIPPED_SKILL_NAMES } from './ever-shipped-skills.mjs';
 import {
+    DEEPEN_GUIDANCE_BLOCK_START,
     PACKAGE_GUIDANCE_BLOCK_END,
     PACKAGE_GUIDANCE_BLOCK_START,
-    SKILL_LOAD_BLOCK_START,
-    SKILL_LOAD_INSTRUCTION,
     QUESTION_PRESENTATION_BLOCK_START,
-    withSkillLoadBlock,
+    SKILL_LOAD_BLOCK_END,
+    SKILL_LOAD_BLOCK_START,
 } from './codex-skill-load-block.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',
@@ -3124,6 +3131,17 @@ function pstackPluginSandbox(t) {
     };
 }
 
+const STALE_SKILL_LOAD_SENTENCE = 'Load the pstack:poteto-mode skill before your first tool call or reply: '
+    + 'open its SKILL.md from your skills list and follow it. This binds every Codex agent, '
+    + 'including a helper started with spawn_agent, whatever its task message says.';
+
+function assertOmitsSkillLoadSentence(codexGuidance) {
+    assert.equal(codexGuidance.includes(SKILL_LOAD_BLOCK_START), false);
+    assert.equal(codexGuidance.includes(SKILL_LOAD_BLOCK_END), false);
+    assert.equal(codexGuidance.includes('pstack:poteto-mode'), false);
+    assert.equal(codexGuidance.includes(STALE_SKILL_LOAD_SENTENCE), false);
+}
+
 test('a full install adds the pstack marketplace and plugin on both hosts', t => {
     const sandbox = pstackPluginSandbox(t);
 
@@ -3145,9 +3163,10 @@ test('a full install adds the pstack marketplace and plugin on both hosts', t =>
     const sheet = readFileSync(join(codexHome, 'pstack-models.md'), 'utf8');
     const agents = readFileSync(join(codexHome, 'AGENTS.md'), 'utf8');
     assert.match(sheet, /^session hook: on$/m);
+    assert.match(agents, /^# pstack model configuration\n/);
     assert.match(agents, /^feature, refactoring: gpt-6-sol$/m);
     assert.doesNotMatch(agents, /^session hook:/m);
-    assert.ok(agents.startsWith(`${SKILL_LOAD_BLOCK_START}\n${SKILL_LOAD_INSTRUCTION}\n`));
+    assertOmitsSkillLoadSentence(agents);
     assert.equal(existsSync(join(sandbox.homeDirectory, '.claude', 'pstack-models.md')), false);
     const manifestPath = join(sandbox.homeDirectory, '.claude', '.claude-dev-env-manifest.json');
     const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
@@ -3155,18 +3174,66 @@ 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');
     runPstackInstaller(sandbox.homeDirectory, [], sandbox.environment);
-    writeFileSync(join(codexHome, 'AGENTS.md'), 'Custom Codex guidance\n');
+    writeFileSync(
+        join(codexHome, 'AGENTS.md'),
+        `${SKILL_LOAD_BLOCK_START}\n${STALE_SKILL_LOAD_SENTENCE}\n${SKILL_LOAD_BLOCK_END}\nCustom Codex guidance\n`,
+    );
     writeFileSync(join(codexHome, 'pstack-models.md'), 'session hook: off\n');
 
     runPstackInstaller(sandbox.homeDirectory, [], sandbox.environment);
 
     const codexGuidance = readFileSync(join(codexHome, 'AGENTS.md'), 'utf8');
-    assert.ok(codexGuidance.startsWith(withSkillLoadBlock('Custom Codex guidance\n')));
+    assert.ok(codexGuidance.startsWith('Custom Codex guidance\n'));
+    assertOmitsSkillLoadSentence(codexGuidance);
     assert.ok(codexGuidance.includes(QUESTION_PRESENTATION_BLOCK_START));
+    assert.ok(codexGuidance.includes(DEEPEN_GUIDANCE_BLOCK_START));
     assert.equal(readFileSync(join(codexHome, 'pstack-models.md'), 'utf8'), 'session hook: off\n');
 });
 
@@ -3185,7 +3252,7 @@ test('a Codex guidance link to the retired Claude copy becomes a file Codex can
     );
     assert.equal(lstatSync(codexAgentsPath).isSymbolicLink(), false);
     const codexGuidance = readFileSync(codexAgentsPath, 'utf8');
-    assert.ok(codexGuidance.startsWith(`${SKILL_LOAD_BLOCK_START}\n${SKILL_LOAD_INSTRUCTION}\n`));
+    assertOmitsSkillLoadSentence(codexGuidance);
     assert.ok(codexGuidance.includes(packageGuidance));
 });
 
@@ -3248,8 +3315,9 @@ test('a fresh full install writes the package guidance into Codex AGENTS.md', t
 
     const codexGuidance = readFileSync(join(sandbox.homeDirectory, '.codex', 'AGENTS.md'), 'utf8');
     assertHoldsPackageGuidance(codexGuidance);
-    assert.ok(codexGuidance.startsWith(`${SKILL_LOAD_BLOCK_START}\n${SKILL_LOAD_INSTRUCTION}\n`));
+    assertOmitsSkillLoadSentence(codexGuidance);
     assert.ok(codexGuidance.includes(QUESTION_PRESENTATION_BLOCK_START));
+    assert.ok(codexGuidance.includes(DEEPEN_GUIDANCE_BLOCK_START));
 });
 
 test('--no-pstack writes package and question guidance without the skill-load block', t => {
@@ -3329,9 +3397,10 @@ test('a pstack install after a --no-pstack install seeds the Codex model sheet',
     assert.match(readFileSync(join(codexHome, 'pstack-models.md'), 'utf8'), /^session hook: on$/m);
     const codexGuidance = readFileSync(join(codexHome, 'AGENTS.md'), 'utf8');
     assert.match(codexGuidance, /^feature, refactoring: gpt-6-sol$/m);
-    assert.ok(codexGuidance.startsWith(`${SKILL_LOAD_BLOCK_START}\n${SKILL_LOAD_INSTRUCTION}\n`));
+    assertOmitsSkillLoadSentence(codexGuidance);
     assertHoldsPackageGuidance(codexGuidance);
     assert.ok(codexGuidance.includes(QUESTION_PRESENTATION_BLOCK_START));
+    assert.ok(codexGuidance.includes(DEEPEN_GUIDANCE_BLOCK_START));
 });
 
 const USAGE_WRAPUP_CLAUDE_COMMANDS = Object.freeze([
@@ -3408,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.0",
+    "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.