@polymorphism-tech/morph-spec 8.32.0 → 8.34.2

package/CLAUDE.md

@@ -120,11 +120,15 @@ When modifying framework components, verify the full scope of related files.
 | `src/lib/git/pending-prs.js` | os TRÊS consumidores da mesma síntese "aguardando merge": `list.js` (linha sintetizada), `fleet-scanner.js` (entrada `pr-pending`) e `doctor.js` (`auditPullRequests`). Uma feature visível numa superfície e invisível na outra é o bug que este módulo existe para impedir |
 | `src/lib/git/gh.js` | `pr-index.js` e `finish.js` — as DUAS formas de invocar o `gh` viraram uma; uma segunda cópia de `resolveGh` volta a tornar o caminho de sucesso do índice intestável |
 | `src/lib/worktree/feature-truth.js` | The four leaders reading the same "which tree owns this feature" predicate: `fleet-scanner.js`, `list.js`, `handoff.js`, and the mutator guard (`approve.js`/`advance.js`/`score.js`/`gate-decision.js`/`gate-check.js`) |
+| `src/lib/tasks/test-runner.js` | `verify-runner.js` (o nó `tests` repassa o `--timeout` e lê `timedOut`), `src/commands/project/worktree.js` (as constantes `WORKTREES_DIR`/`LEGACY_WORKTREES_DIR` que a descoberta ignora — duplicar as strings aqui é como o bug volta), `test/lib/test-runner.test.js` (o canário do ignore de worktrees e o do timeout escalado). Um worktree é o checkout de OUTRA feature: varrê-lo dobra o relógio e reporta sobre código fora da árvore avaliada |
 | `src/lib/graph/**`               | `test/lib/graph/*.test.js`, the committed fixture `test/fixtures/graph/namespace-hierarchy.graph.json` (ADR-003 regression — never hand-edit it), `doctor.js` (`codebase graph` check), `architecture-scanner.js` (centrality section), `setup-infra.js` step 18b |
 | `src/lib/validators/reuse/**`     | `validation-runner.js` (case + push universal), `framework/rubrics/*.json` (o id `reuse` mapeado numa categoria, senão o achado não pesa no score), `test/fixtures/graph/prospectpro-reuse.graph.json` (recorte do grafo real — regerar com `build-reuse-fixture.mjs`, nunca editar à mão) |
 | o ciclo de reuso (`reuse-map.md`) | `output-schema.js` (+ `npm run generate`), `framework/schemas/tasks.schema.json` + `tasks-json-parser.js` (campo `reuse`), `morph-plan` §1c/§5b, template de dispatch de `morph-implement`/`morph-apply`, personas de `agents.json`, `evals/rubrics/code-quality.md` + `condensed.md`, `morph-review` (insumo do avaliador), `test/framework/graph-fallback.test.js` |
 | `framework/mcp/registry.json`    | mcp-installer.js, claude-config-detector.js, agents-installer.js (personas' `mcp` field), `scripts/validate-framework.js` Check 8, `test/framework/mcp-registry.test.js` |
 | Any `framework/` file that calls `morph-spec graph` | The fallback to grep must be declared in the SAME file — `test/framework/graph-fallback.test.js` enforces it (ADR-002: a skill that requires the graph with no fallback is a bug) |
+| `framework/hooks/claude-code/core/worktree-create.js` / `worktree-remove.js` / `block-raw-worktree-add.js` / `worktree-env-inject.js` | `hooks-installer.js` (`MORPH_HOOKS`: eventos `WorktreeCreate`/`WorktreeRemove` + a ORDEM da chain Bash — inject por último, um comando bloqueado nunca é reescrito), `hooks-scanner.js` `EVENT_KEYS`, `chain.js` (`updatedInput` só viaja com rewrite — `permissionDecision:'allow'` incondicional pularia o prompt de todo Bash), `worktree.js` (`runWorktreeProvision`, `--if-clean`, `envKeyForWorktree`), `worktree-audit.js` (`morph-task/*`, `out-of-container`), `worktree-context.js`, MORPH.md §2.2, `morph-apply` §3b-w, `test/framework/worktree-governance-prose.test.js`, `resident-size.test.js` (MORPH.md está NO teto) |
+| `src/lib/worktree/env-allocator.js` (`portLayout`) | os DOIS escritores do bloco — `buildEnvFileContent` (`.morph/worktree.env`) e `compose-env.js` (`buildComposeEnv`, usado por `e2e up`, pelo nó `e2e` do `verify`, por `stack-teardown.js` e por `morph-spec env`) — e os leitores `worktree-context.js`, `handoff-generator.js`, `worktree-env-inject.js`, o template `docker-compose.template.yml` (variáveis que ele publica) e o standard `local-compose-isolation.md` (tabela de offsets). Canário: "worktree.env e compose env concordam byte a byte" em `test/lib/e2e/compose-env.test.js`. Offset novo aqui sem entrar no template é porta que ninguém publica |
+| `src/lib/worktree/dirs.js` | ÚNICA fonte do nome do container (`worktrees/`, sem ponto — Jest esconde diretório com ponto e reporta 0 testes sem erro). `worktree.js` re-exporta; `graphifyignore.js`, `file-copier.js`, `architecture-scanner.js`, `test-runner.js`, `worktree-audit.js`, `state-scanner.js` importam. `test/lib/worktree/dirs.test.js` cobra cada leitor |
 
 ### Test Coverage
 

package/README.md

@@ -3,7 +3,7 @@
 > Spec-driven development framework for multi-stack projects. Turns feature requests into implementation-ready code through structured, AI-orchestrated phases.
 
 **Package:** `@polymorphism-tech/morph-spec`
-**Version:** 8.32.0  
+**Version:** 8.34.2  
 **Requires:** Node.js 22+, Claude Code
 
 ---
@@ -379,4 +379,4 @@ Code generated by morph-spec (contracts, templates, implementation output) belon
 
 ---
 
-*morph-spec v8.32.0 by [Polymorphism Tech](https://polymorphism.tech)*
+*morph-spec v8.34.2 by [Polymorphism Tech](https://polymorphism.tech)*

package/bin/morph-spec.js

@@ -23,9 +23,10 @@ import { installPluginCommand } from '../src/commands/project/install-plugin-cmd
 import { updateCommand } from '../src/commands/project/update.js';
 import { doctorCommand } from '../src/commands/project/doctor.js';
 import { statusCommand } from '../src/commands/project/status.js';
-import { worktreeSetupCommand, worktreeLinkCommand, worktreeListCommand, worktreeRemoveCommand } from '../src/commands/project/worktree.js';
+import { worktreeSetupCommand, worktreeProvisionCommand, worktreeLinkCommand, worktreeListCommand, worktreeRemoveCommand } from '../src/commands/project/worktree.js';
 import { branchPruneCommand } from '../src/commands/project/branch.js';
 import { fleetCommand } from '../src/commands/project/fleet.js';
+import { envCommand } from '../src/commands/project/env.js';
 import { claimCommand } from '../src/commands/project/claim.js';
 import { standardsCommand } from '../src/commands/project/standards.js';
 import { reportCheckCommand } from '../src/commands/state/report-check.js';
@@ -189,6 +190,7 @@ program
   .option('--pr', 'Push morph/{feature} and open a PR against the default branch (no local merge)')
   .option('--merge', 'Merge morph/{feature} into the default branch locally (no push)')
   .option('--keep', 'Keep the worktree/branch after integrating (worktree flow only)')
+  .option('--keep-volumes', 'Keep the e2e stack\'s named volumes (e.g. a seeded database) instead of reclaiming them with the containers')
   .option('--force', 'Skip the Gate-3-approved precondition')
   .option('--discard-ignored', 'Allow removing the worktree even though it holds gitignored files that exist nowhere else (e.g. .env) — they are destroyed')
   .action((feature, options) => finishCommand(feature, options));
@@ -365,7 +367,7 @@ program
   .description('Run the deterministic verification chain (build + tests + validators + e2e) — code before the LLM judge')
   .option('--json', 'Output as JSON')
   .option('--rubric <id>', 'Force a rubric (default: by task group → config → default)')
-  .option('--timeout <ms>', 'Build timeout in ms (default 120000)', (v) => parseInt(v, 10))
+  .option('--timeout <ms>', 'Timeout in ms for the build AND tests nodes (build default 120000; tests default 120000 per test project, or project.testTimeoutMs)', (v) => parseInt(v, 10))
   .option('--skip-tests', 'Skip the test node')
   .option('--skip-build', 'Skip the build node')
   .option('--skip-e2e', 'Skip the e2e node (Docker bring-up + Playwright)')
@@ -456,8 +458,20 @@ worktreeCommand
   .command('setup <feature>')
   .description('Create a worktree at worktrees/{feature}/ on branch morph/{feature}')
   .option('--fresh', 'Create a new dated branch even if one already exists')
+  .option('--json', 'Output as JSON (always JSON — accepted so the WorktreeCreate hook can call setup and provision uniformly)')
   .action((feature, options) => worktreeSetupCommand(feature, options));
 
+// Task isolation — the tree `claude -w`, EnterWorktree and Agent
+// isolation:"worktree" ask for when the name is NOT a feature. Same infra as
+// setup (junctions, port block, git-invisible manifest, primary-root landing),
+// no feature identity. The WorktreeCreate hook is its main caller.
+worktreeCommand
+  .command('provision <name>')
+  .description('Create a task-isolation worktree at worktrees/{name}/ on branch morph-task/{name} — full morph infra, no feature identity')
+  .option('--base <ref>', 'Branch off this ref instead of the default branch')
+  .option('--json', 'Output as JSON (always JSON)')
+  .action((name, options) => worktreeProvisionCommand(name, options));
+
 worktreeCommand
   .command('link')
   .description('Link shared infra (node_modules[, .claude, .morph/framework]) into the current worktree')
@@ -475,6 +489,8 @@ worktreeCommand
   .option('--target <path>', 'Remove the worktree at this path (for worktrees with no feature registration)')
   .option('--discard-ignored', 'Skip the backup: gitignored files unique to the worktree are deleted instead of copied to .git/morph-spec/finish-backup (by default they are backed up and the removal proceeds anyway)')
   .option('--delete-branch', 'Also delete the branch (default: kept — unintegrated commits live there)')
+  .option('--if-clean', 'Refuse (exit 1, worktree-dirty) if the tree has any uncommitted or untracked file — nothing is touched on a refusal. What the WorktreeRemove hook passes')
+  .option('--json', 'Output as JSON (always JSON)')
   .action((feature, options) => worktreeRemoveCommand(feature, options));
 
 worktreeCommand
@@ -500,6 +516,14 @@ branchCommand
   .option('--json', 'Output as JSON')
   .action((options) => branchPruneCommand(options));
 
+// ─── Worktree env (shell-loadable port block) ─────────────────────────────
+program
+  .command('env [feature]')
+  .description('Print the worktree\'s dedicated environment (port block + COMPOSE_PROJECT_NAME), shell-loadable: eval "$(morph-spec env)" outside Claude Code; feature defaults to the morph/{f} or morph-task/{n} branch of cwd')
+  .option('--json', 'Output as JSON')
+  .option('--powershell', 'Emit $env:K="V" lines instead of POSIX exports')
+  .action((feature, options) => envCommand(feature, options));
+
 // ─── Fleet ────────────────────────────────────────────────────────────────
 program
   .command('fleet')