@polymorphism-tech/morph-spec 9.8.0 → 10.1.1

package/CLAUDE.md

@@ -8,6 +8,8 @@ morph-spec is a spec-driven development harness CLI (`@polymorphism-tech/morph-s
 
 This repo is the **framework source code** — not a project that uses morph-spec.
 
+**Do not run the morph-spec workflow here.** No `init`, `create`, `plan-check`, `gate-check`, `approve`, `advance`, `verify`, `context refresh` or `finish`, and no `/morph-plan` or `/morph-apply` as a process, even if a prompt starts with one: confirm first. Work here is ordinary: a normal branch, `npm test`, `npm run generate:check`, a PR. `framework/skills/` and `framework/CLAUDE.md` are source to edit, not instructions to follow. `/.morph/` is gitignored: this repo keeps no morph-spec state.
+
 ## Build & Test Commands
 
 ```bash
@@ -40,7 +42,7 @@ No build step — pure ESM JavaScript, runs directly via Node.js 22+.
 
 ### Module Layout
 
-- **`bin/morph-spec.js`** — Commander.js CLI entry point: install/inspect commands plus the deterministic steps of the loop (`create`, `plan-check`, `gate-check`, `approve`/`advance`, `verify`, `report-check`, `mutate`, `finish`).
+- **`bin/morph-spec.js`** — Commander.js CLI entry point: install/inspect commands plus the deterministic steps of the loop (`create`, `plan-check`, `gate-check`, `approve`/`advance`, `verify`, `report-check`, `e2e`, `finish`).
 - **`src/commands/`** — CLI command handlers organized by domain (project/, state/, validation/, scaffold/, mcp/, context/, dashboard/).
 - **`src/core/`** — Core domain logic:
   - `state/state-manager.js` — Atomic state I/O with process-ID temp files
@@ -49,14 +51,14 @@ No build step — pure ESM JavaScript, runs directly via Node.js 22+.
   - `workflows/` — Workflow type detector
 - **`src/lib/`** — Libraries and subsystems:
   - `validators/` — Validators run by the `verify` validators node (code-budget, contracts, nextjs, packages, reuse)
-  - `generators/` — Code generation (architecture context, handoff, scaffold, settings)
+  - `generators/` — Code generation (architecture context, scaffold, settings)
   - `stack-filter.js` — Stack-aware asset filtering via YAML frontmatter `stacks:` tags
   - `installers/` — Agents, skills, hooks installers
 - **`src/utils/`** — Shared utilities (logger, banner, file-copier, claude-settings-manager, agents-installer, skills-installer, hooks-installer)
 - **`framework/`** — Metadata installed into target projects (READ-ONLY at runtime):
-  - `MORPH.md` — NLH charter (the single source of behavioral truth; ≤ 20k chars, `resident-size` canary)
-  - `CLAUDE.md` — Runtime instructions injected into target's `.claude/CLAUDE.md` (≤ 4k chars)
-  - `agents.json` — 10 flat personas (see below); `maxTurns` per persona (ADR-004)
+  - `MORPH.md` — NLH charter (the single source of behavioral truth; ≤ 8k chars, `resident-size` canary)
+  - `CLAUDE.md` — Runtime instructions injected into target's `.claude/CLAUDE.md` (≤ 3k chars)
+  - `agents.json` — the 3 Gate 3 personas (see below); `maxTurns` per persona
   - `phases.json` — 4 phases (plan, uiux, implement, review)
   - `standards/STANDARDS.json` — index of available standards
   - `hooks/claude-code/core/` — fail-open guardrail hooks (+ `hooks/shared/` for what hooks and `src/` both read)
@@ -79,7 +81,7 @@ No build step — pure ESM JavaScript, runs directly via Node.js 22+.
 
 **Stack-aware filtering:** Assets declare `stacks: ['dotnet']` in YAML frontmatter or `stack: ['dotnet']` in `agents.json`. `setup-infra.js` reads `config.json → project.stack`, splits into tags, and installs only matching assets.
 
-**Personas, not tiers:** `agents.json` has 10 flat personas — 6 domain implementers (dotnet-senior, ef-modeler, maf-expert, nextjs-expert, ui-designer, infra-engineer), the 3 read-only Gate 3 roles (verifier, reviewer, security) and 1 stage persona (`scout`, read-only). `model` is sized per stage: `sonnet` for implementers, `scout`, `verifier` and `reviewer`; `security` and `ui-designer` (design quality is the deliverable, high effort) are `opus`; the dispatch routes the verifier to `opus` when `verifierModelFor` (risk-detector.js, read by `report-check --before-eval`) sees prompt/model or media (measured against haiku in `docs/specs/scout-evidence/decisions.md`). No tier system — Claude assumes the 3 NLH roles (Orchestrator/Specialist/Evaluator) per MORPH.md.
+**Single loop:** the main session plans, implements the whole plan in one window, fixes and finishes; domain know-how lives in the stack rules `framework/rules/*-standards.md`, loaded by `paths:` when the session touches a matching file and installed by `syncStackRules` from `plan-check`/`verify`/`update` (`docs/specs/single-loop/decisions.md`, ADR-010). `agents.json` has only the 3 read-only Gate 3 roles — `verifier` (executes each `Cn`), `reviewer` (plan.md + diff), `security` (sensitive paths) — dispatched in fresh context in the same response. `reviewer` is `sonnet`, `security` is `opus`; the dispatch routes the verifier to `opus` when `verifierModelFor` (risk-detector.js, read by `report-check --before-eval`) sees prompt/model or media.
 
 ### Phase Sequence
 
@@ -87,7 +89,7 @@ No build step — pure ESM JavaScript, runs directly via Node.js 22+.
 plan → [uiux] → implement → review
 ```
 
-Gates: `plan` (plan.md + `checks.json` from `plan-check`), `uiux` (optional, after the plan gate, `1-design/`), `review` (Gate 3: `verifier.md` + `reviewer.md` [+ `security.md`]). Folders keep their ids: `2-plan/`, `1-design/`, `3-implement/`, `4-review/`. `chore`/`hotfix` are born with `plan` stamped by policy. Implementation unit: the slices `F1..Fn` of plan.md; progress = `3-implement/reports/F{n}.md`.
+Gates: `plan` (plan.md + `checks.json` from `plan-check`), `uiux` (optional, after the plan gate, `1-design/`), `review` (Gate 3: `verifier.md` + `reviewer.md` [+ `security.md`]). Folders keep their ids: `2-plan/`, `1-design/`, `3-implement/`, `4-review/`. `chore`/`hotfix` are born with `plan` stamped by policy. Done-when = the scenarios `C1..Cn` of plan.md; progress = `3-implement/report.md` (one row per `Cn`: `pendente`/`feito`/`bloqueado`). The archive keeps `feature.json` + `2-plan/plan.md`.
 
 ### State Schema
 
@@ -96,7 +98,7 @@ Authoritative, committed state: `.morph/features/{f}/feature.json` (status, appr
 ## Testing Conventions
 
 - **Framework:** Node.js native `node:test` — no Jest or Mocha
-- **Concurrency:** files run in parallel (`scripts/run-tests.mjs`) — `node --test` gives each file its own process, so `process.chdir()` stays inside the file. A test never writes a tracked file of this repo: a script under test reads its root from `MORPH_REPO_ROOT`, and the test points it at `copyTrackedRepo()` (`test/helpers/repo-copy.js`, a temp git repo with the tracked files). The runner fails if a run changes the tracked tree
+- **Concurrency:** files run in parallel (`scripts/run-tests.mjs`) — `node --test` gives each file its own process, so `process.chdir()` stays inside the file. A test never writes a tracked file of this repo: a script under test reads its root from `MORPH_REPO_ROOT`, and the test points it at `copyTrackedRepo()` (`test/helpers/repo-copy.js`, a temp git repo with the tracked files). The runner fails if a run changes the tracked tree. Each file has a 10-minute `--test-timeout` (it bounds the whole file under process isolation): a hang fails by name. A test that imports a hook sets `MORPH_HOOK_CHAINED=1` first, or the hook's `runStandalone` waits on stdin, which `node --test` never closes
 - **Subprocesses:** drive the CLI through `test/helpers/cli.js` (`runCli`, no shell) and git through `test/helpers/git.js` (`git(cwd, ...args)`) — `execSync('git …')` pays a cmd.exe per call on Windows. Hooks that export `run(payload)` can be called in-process (see `test/hooks/loop-detect.test.js`); keep one spawn per hook for the standalone wiring
 - **Temp dirs:** `createTempDir()` / `cleanupTempDir()` from `test/helpers/test-utils.js`
 - **Home:** a suite that runs `setupInfra`/`updateCommand`/`initCommand` calls `isolateHome()` (test-utils) at the top — the installers write `~/.claude/settings.json` through `os.homedir()`. Canary: `test/meta/home-isolation.test.js`
@@ -125,8 +127,8 @@ A matriz "mexeu em X → verifique Y" mora em `.claude/rules/matrix-*.md`, uma r
 | `.claude/rules/matrix-hooks.md` | Hooks, telemetria e comment-guard |
 | `.claude/rules/matrix-charter.md` | Carta NLH, skills e docs instaláveis |
 | `.claude/rules/matrix-templates-ai.md` | Fases, templates, ai-kit e CI |
-| `.claude/rules/matrix-plan-review.md` | Plano, relatórios de fatia, gates e Gate 3 |
-| `.claude/rules/matrix-verify.md` | Verify, testes, mutação e CI |
+| `.claude/rules/matrix-plan-review.md` | Plano, progresso, gates e Gate 3 |
+| `.claude/rules/matrix-verify.md` | Verify, testes e CI |
 | `.claude/rules/matrix-worktree-git.md` | Worktrees, finish e git |
 | `.claude/rules/matrix-graph.md` | Grafo de codebase e validador de reuso |
 | `.claude/rules/matrix-platform.md` | MCP, installers, procs, heavy e dashboard |

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:** 9.8.0  
+**Version:** 10.1.1  
 **Requires:** Node.js 22+, Claude Code
 
 ---
@@ -244,11 +244,11 @@ Guardrail hooks are installed into `.claude/settings.local.json` across 13 event
 | --------------------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
 | `SessionStart`              | `worktree-context.js`                                                   | Injects feature identity (worktree) or active-feature summary (root)           |
 | `PreToolUse` (Write\|Edit)  | `protect-spec-files.js`, `enforce-phase-writes.js`                       | Freezes `plan.md` after the plan gate (only `plan-check` writes `checks.json`); enforces phase folders |
-| `PreToolUse` (Bash)         | `pre-bash-denylist.js`, `block-destructive-worktree-removal.js`, `block-raw-worktree-add.js`, `warn-bash-source-write.js`, `heavy-gate.js`, `worktree-env-inject.js` | Destructive-command guards, worktree governance, heavy-node semaphore, per-worktree env |
+| `PreToolUse` (Bash)         | `pre-bash-denylist.js`, `block-destructive-worktree-removal.js`, `block-raw-worktree-add.js`, `heavy-gate.js`, `worktree-env-inject.js` | Destructive-command guards, worktree governance, heavy-node semaphore, per-worktree env |
 | `WorktreeCreate` / `WorktreeRemove` | `worktree-create.js`, `worktree-remove.js`                     | Native worktrees delegate to the CLI                                            |
 | `PostToolUse` (Write\|Edit) | `comment-guard.js`                                                       | Blocks added comments the comment standard forbids                              |
 | `PostToolUse`               | `state-sync.js`, `gate-guard.js`                                         | Syncs feature state; enforces gate ordering                                     |
-| `PostToolUse`, `PostToolUseFailure`, `PostToolBatch`, `SubagentStop`, `UserPromptSubmit` | `telemetry-log.js`, `loop-detect.js`, `graph-refresh-kick.js`, `heavy-release.js` | Telemetry, repeated-action loops, graph refresh, heavy-slot release |
+| `PostToolUse`, `PostToolUseFailure`, `PostToolBatch`, `SubagentStop`, `UserPromptSubmit` | `telemetry-log.js`, `loop-detect.js`, `graph-refresh-kick.js`, `heavy-release.js`, `masked-exit.js` | Telemetry, repeated-action loops, graph refresh, heavy-slot release, masked test exit warning |
 | `Stop`                      | `validate-completion.js`                                                  | Warns about incomplete tasks, missing outputs, or pending approval gates         |
 
 
@@ -380,4 +380,4 @@ Code generated by morph-spec (contracts, templates, implementation output) belon
 
 ---
 
-*morph-spec v9.8.0 by [Polymorphism Tech](https://polymorphism.tech)*
+*morph-spec v10.1.1 by [Polymorphism Tech](https://polymorphism.tech)*

package/bin/morph-spec.js

@@ -23,16 +23,15 @@ const worktreeProvisionCommand = lazy('../src/commands/project/worktree.js', 'wo
 const worktreeLinkCommand = lazy('../src/commands/project/worktree.js', 'worktreeLinkCommand');
 const worktreeListCommand = lazy('../src/commands/project/worktree.js', 'worktreeListCommand');
 const worktreeRemoveCommand = lazy('../src/commands/project/worktree.js', 'worktreeRemoveCommand');
-const worktreeReapCommand = lazy('../src/commands/project/worktree-reap.js', 'worktreeReapCommand');
 const branchPruneCommand = lazy('../src/commands/project/branch.js', 'branchPruneCommand');
 const fleetCommand = lazy('../src/commands/project/fleet.js', 'fleetCommand');
 const envCommand = lazy('../src/commands/project/env.js', 'envCommand');
 const claimCommand = lazy('../src/commands/project/claim.js', 'claimCommand');
 const standardsCommand = lazy('../src/commands/project/standards.js', 'standardsCommand');
 const reportCheckCommand = lazy('../src/commands/state/report-check.js', 'reportCheckCommand');
-const scoutCheckCommand = lazy('../src/commands/validation/scout-check.js', 'scoutCheckCommand');
 const planCheckCommand = lazy('../src/commands/validation/plan-check.js', 'planCheckCommand');
 const stackScanCommand = lazy('../src/commands/project/stack-scan.js', 'stackScanCommand');
+const stackSetCommand = lazy('../src/commands/project/stack-set.js', 'stackSetCommand');
 const testsAuditCommand = lazy('../src/commands/validation/tests-audit.js', 'testsAuditCommand');
 
 const approveCommand = lazy('../src/commands/state/approve.js', 'approveCommand');
@@ -40,12 +39,12 @@ const approvalStatusCommand = lazy('../src/commands/state/approve.js', 'approval
 const unapproveCommand = lazy('../src/commands/state/approve.js', 'unapproveCommand');
 const advanceCommand = lazy('../src/commands/state/advance.js', 'advanceCommand');
 const archiveCommand = lazy('../src/commands/state/archive.js', 'archiveCommand');
+const recapCommand = lazy('../src/commands/state/recap.js', 'recapCommand');
 const finishCommand = lazy('../src/commands/state/finish.js', 'finishCommand');
 const gateDecisionCommand = lazy('../src/commands/state/gate-decision.js', 'gateDecisionCommand');
 const gateCheckCommand = lazy('../src/commands/state/gate-check.js', 'gateCheckCommand');
 const createCommand = lazy('../src/commands/state/create.js', 'createCommand');
 const retypeCommand = lazy('../src/commands/state/retype.js', 'retypeCommand');
-const handoffCommand = lazy('../src/commands/state/handoff.js', 'handoffCommand');
 const nextCommand = lazy('../src/commands/state/next.js', 'nextCommand');
 const listCommand = lazy('../src/commands/state/list.js', 'listCommand');
 const deleteCommand = lazy('../src/commands/state/delete.js', 'deleteCommand');
@@ -54,14 +53,15 @@ const graphStatusCommand = lazy('../src/commands/graph/status.js', 'graphStatusC
 const graphBuildCommand = lazy('../src/commands/graph/build.js', 'graphBuildCommand');
 const graphAffectedCommand = lazy('../src/commands/graph/affected.js', 'graphAffectedCommand');
 const graphExplainCommand = lazy('../src/commands/graph/explain.js', 'graphExplainCommand');
+const graphDiffCommand = lazy('../src/commands/graph/diff.js', 'graphDiffCommand');
 
 const validateCommand = lazy('./validate.js', 'validateCommand');
 const validateFeatureCommand = lazy('../src/commands/validation/validate-feature.js', 'validateFeatureCommand');
 const verifyCommand = lazy('../src/commands/validation/verify.js', 'verifyCommand');
-const mutateCommand = lazy('../src/commands/validation/mutate.js', 'mutateCommand');
 const e2eUpCommand = lazy('../src/commands/e2e/e2e.js', 'e2eUpCommand');
 const e2eStatusCommand = lazy('../src/commands/e2e/e2e.js', 'e2eStatusCommand');
 const e2eDownCommand = lazy('../src/commands/e2e/e2e.js', 'e2eDownCommand');
+const e2eResetCommand = lazy('../src/commands/e2e/e2e.js', 'e2eResetCommand');
 
 const scaffoldDotnetCommand = lazy('../src/commands/scaffold/scaffold.js', 'scaffoldDotnetCommand');
 const scaffoldNextjsCommand = lazy('../src/commands/scaffold/scaffold.js', 'scaffoldNextjsCommand');
@@ -102,6 +102,8 @@ program
   .option('-f, --force', 'Overwrite existing MORPH installation')
   .option('-p, --path <path>', 'Target path (default: current directory)')
   .option('--skip-mcp', 'Skip MCP server auto-setup')
+  .option('--stack <stack>', 'Empty project: declare the stack without asking (dotnet, nextjs or dotnet+nextjs)')
+  .option('--with <integrations>', 'With --stack: comma-separated integrations (neon, maf, docker)')
   .action(initCommand);
 
 program
@@ -181,6 +183,14 @@ program
   .option('--force', 'Archive even if Gate 3 (review) is not approved')
   .action((feature, options) => archiveCommand(feature, options));
 
+program
+  .command('recap <feature>')
+  .description('Recap animado da feature (cenários provados, estados, o que mudou, gates), com legenda e narração; o finish já gera')
+  .option('--piper', 'Narra com o Piper local (áudio embutido, gravado no temp); sem ele, voz do sistema')
+  .option('-p, --path <path>', 'Target path (default: current directory)')
+  .option('--json', 'Output as JSON')
+  .action((feature, options) => recapCommand(feature, options));
+
 program
   .command('finish <feature>')
   .description('Close a feature: archive → integrate. --merge merges morph/{f} into the default (local); --pr pushes it + opens a PR. Works with and without a worktree')
@@ -259,13 +269,6 @@ program
   .option('--json', 'Output as JSON')
   .action((feature, newType, options) => retypeCommand(feature, newType, options));
 
-program
-  .command('handoff <feature>')
-  .description('Generate the compressed session-handoff document (.morph/features/{f}/handoff.md) — pointers, not copies. Resolves the tree that owns the feature\'s state (worktree, or morph/{feature} if only committed) and writes there — not necessarily cwd.')
-  .option('--json', 'Output as JSON')
-  .option('--here', 'Force building/writing in the current directory, even if another tree owns this feature')
-  .action((feature, options) => handoffCommand(feature, options));
-
 program
   .command('next <feature>')
   .description('The next step of the loop, decided from disk (phase, gates, slice reports, verify stamp, fail streak) in the tree that owns the feature. Read-only.')
@@ -313,6 +316,14 @@ graphCommand
   .option('--json', 'Output as JSON')
   .action((symbol, options) => graphExplainCommand(symbol, options));
 
+graphCommand
+  .command('diff')
+  .description('Árvore de chamadas do que mudou (+ novo, ~ alterado), do merge-base ao HEAD; recusa grafo que não é deste commit')
+  .option('-p, --path <path>', 'Target path (default: current directory)')
+  .option('--base <ref>', 'Base do diff (default: merge-base com a branch padrão)')
+  .option('--json', 'Output as JSON')
+  .action((options) => graphDiffCommand(options));
+
 program
   .command('validate [validator]')
   .description('Run project validations (all | packages | next-components | spec-tasks)')
@@ -356,18 +367,6 @@ program
     verifyCommand(feature, { ...options, noPersist: options.persist === false })
   );
 
-program
-  .command('mutate [feature]')
-  .description('Prova de mutação do Gate 3 em lote: lê o manifesto de mutantes, roda todos (um build de schemata em .NET, subconjunto primeiro, suíte inteira só para sobrevivente), restaura os bytes e imprime a seção `## Mutações`')
-  .option('--plan <file>', 'Manifesto JSON (default: .morph/features/<feature>/4-review/mutants.json)')
-  .option('--out <file>', 'Onde gravar a seção `## Mutações` (default: 4-review/mutation-section.md)')
-  .option('--allow-dirty', 'Permite mutar arquivo com alteração não commitada (o snapshot é o único caminho de volta)')
-  .option('--jobs <n>', 'Rodadas de subconjunto em paralelo (default 2); cada worker toma um slot heavy livre, e sem slot livre a rodada degrada para sequencial', (v) => Number.parseInt(v, 10))
-  .option('--timeout <ms>', 'Teto de cada comando de build/teste', (v) => Number.parseInt(v, 10))
-  .option('--restore', 'Recupera o disco de uma rodada que morreu no meio: restaura os bytes do journal, sem rodar nada')
-  .option('--json', 'Output as JSON')
-  .action((feature, options) => mutateCommand(feature, options));
-
 const scaffoldCmd = program
   .command('scaffold')
   .description('Generate feature files from templates');
@@ -443,6 +442,12 @@ e2eCommand
   .option('--json', 'Output as JSON')
   .action((feature, options) => e2eDownCommand(feature, options));
 
+e2eCommand
+  .command('reset <feature>')
+  .description('Put the running stack\'s data back in a known state between verification flows: e2e.resetCommand, or recreate the non-built services that own a named volume; then the auth seed. App services and e2e.hostServices are not restarted. Exit 1 when the stack is not up')
+  .option('--json', 'Output as JSON')
+  .action((feature, options) => e2eResetCommand(feature, options));
+
 const heavyCommand = program
   .command('heavy')
   .description('Slots por usuário para os nós pesados (build, testes, e2e), compartilhados entre as sessões');
@@ -496,14 +501,6 @@ worktreeCommand
   .option('--json', 'Output as JSON (always JSON)')
   .action((feature, options) => worktreeRemoveCommand(feature, options));
 
-worktreeCommand
-  .command('reap')
-  .description('Remove the worktrees and branches of sub-agents that stopped clean (nothing uncommitted, no commit only they hold); everything else is listed with the reason and left alone')
-  .option('--dry-run', 'Report what would be removed without touching anything')
-  .option('--grace <minutes>', 'Minutes a stopped agent must stay quiet before its tree is reaped (default 30, or worktree.reap.graceMinutes)')
-  .option('--json', 'Output as a single JSON line')
-  .action((options) => worktreeReapCommand(options));
-
 worktreeCommand
   .command('list')
   .description('List active feature worktrees with their phase and gate status')
@@ -532,7 +529,7 @@ program
 
 program
   .command('fleet')
-  .description('Fleet view — every active feature across primary root and worktrees (phase, gates, tasks, ports, handoff, activity)')
+  .description('Fleet view — every active feature across primary root and worktrees (phase, gates, scenarios, ports, activity)')
   .option('--json', 'Output as JSON')
   .action((options) => fleetCommand(options));
 
@@ -556,18 +553,11 @@ program
   .action((options) => standardsCommand(options));
 
 program
-  .command('report-check <feature> [slices...]')
-  .description('Audit slice report files (3-implement/reports/{slice}.md) against the work the dispatch actually wrote (telemetry, keyed by the agent that wrote the report). Exits 0 only when every audited slice is intact; naming slices audits only those')
+  .command('report-check <feature>')
+  .description('State of the Gate 3 reports (4-review/), scenario progress of 3-implement/report.md and the tree they were written against')
   .option('--before-eval', 'Save a snapshot of the tree before dispatching the review agents and print their models; later runs report what changed since')
   .option('--json', 'Output as JSON')
-  .action((feature, slices, options) => reportCheckCommand(feature, slices, options));
-
-program
-  .command('scout-check <map>')
-  .description('Audit a scout map: every path:line citation must exist and carry the literal line it quotes (±2 lines); absence/liveness verdicts only as hypotheses with the search command and its raw count. Exits 0 only when nothing failed')
-  .option('--root <dir>', 'Tree the citations are relative to (default: top of the current worktree)')
-  .option('--json', 'Output as JSON')
-  .action((map, options) => scoutCheckCommand(map, options));
+  .action((feature, options) => reportCheckCommand(feature, options));
 
 program
   .command('plan-check <feature>')
@@ -579,10 +569,17 @@ program
 
 program
   .command('stack-scan [feature]')
-  .description('Audit the code against config.project.stack, judging only the configured stacks (runtime, ORM, database, Guid.NewGuid, generic repository, service layer, raw SQL, sealed, router, UI library) by severity. With a feature, write .morph/features/<f>/2-plan/stack-scan.md; without, print the report')
+  .description('Audit the code against config.project.stack, judging only the configured stacks (runtime, ORM, database, Guid.NewGuid, generic repository, service layer, raw SQL, sealed, router, UI library) by severity. Prints the report (markdown, or --json); never writes a file')
   .option('--json', 'Output as JSON')
   .action((feature, options) => stackScanCommand(feature, options));
 
+program
+  .command('stack-set <stack>')
+  .description('Declare the project stack (dotnet, nextjs or dotnet+nextjs) in config.json and install its domain rules into .claude/rules/; rules load when a Claude Code session starts')
+  .option('--with <integrations>', 'Comma-separated integrations (neon, maf, docker)')
+  .option('--json', 'Output as JSON')
+  .action((stack, options) => stackSetCommand(stack, options));
+
 program
   .command('tests-audit')
   .description('Read-only audit of the tracked test files: case count, largest files, tests that pin prose or a constant, [Fact] families that are [Theory] candidates, and one subject tested in several layers — candidates to delete or merge, never verdicts')

package/claude-plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "morph-spec",
-  "version": "9.8.0",
+  "version": "10.1.1",
   "displayName": "MORPH-SPEC Framework",
   "description": "Spec-driven development with 38 agents and 8-phase workflow for .NET/Blazor/Next.js/Azure",
   "publisher": "polymorphism-tech",

package/docs/CHEATSHEET.md

@@ -23,18 +23,17 @@ morph-spec --version
 ## Phase workflow
 
 ```
-proposal → [uiux] → plan → implement → review
+plan → [uiux] → implement → review
 ```
 
-`uiux` is optional. Which of the 5 phases actually run for a given feature is also shaped by its **work type** (see below) — a `chore` skips straight to implement, a `hotfix` runs a different pipeline entirely.
+`uiux` is optional and runs after the plan gate. Which phases actually run for a given feature is also shaped by its **work type** (see below): a `chore` writes a short plan and goes straight to implement, a `hotfix` follows its own path.
 
 | Phase | Folder | Gate |
 |-------|--------|------|
-| proposal | `0-proposal/` | ✅ Gate 1 |
-| uiux *(optional)* | `1-design/` | ✅ |
-| plan | `2-plan/` | ✅ Gate 2 |
-| implement | `3-implement/` | — (auto-advance between tasks) |
-| review | `4-review/` | ✅ Gate 3 |
+| plan | `2-plan/` | ✅ `plan` (`plan.md` + `checks.json`) |
+| uiux *(optional)* | `1-design/` | ✅ `uiux` |
+| implement | `3-implement/` | — (one row per `Cn` in `report.md`) |
+| review | `4-review/` | ✅ `review` (Gate 3) |
 
 ---
 
@@ -42,9 +41,9 @@ proposal → [uiux] → plan → implement → review
 
 | Command | Purpose |
 |---------|---------|
-| `/morph-proposal {feature}` | Business understanding + plan (Gates 1 and 2). Step 0 routes by work type (`feature`/`bug`/`chore`/`hotfix`) |
-| `/morph-hotfix {feature}` | Surgical hotfix ADW (scout → fix → human gate → ship) |
-| `/morph-apply {feature}` | Autonomous execution + review (Gate 3) |
+| `/morph-plan {feature or issue link}` | From a request to the approved plan: routes by work type (`feature`/`bug`/`chore`/`hotfix`), opens with a thesis against the code |
+| `/morph-hotfix {feature}` | Production incident: surgical fix, Gate 3 always human |
+| `/morph-apply {feature}` | Implements the whole plan, runs `verify` and Gate 3, closes with `finish` |
 | `/morph-status [feature]` | Status of the active (or specified) feature |
 | `/morph-archive {feature}` | Archive **without integrating** (legacy feature / cleanup) — normal close is `morph-spec finish --pr\|--merge` |
 | `/morph-preflight` | Pre-deploy validation (specs, contracts, tests, infra) |
@@ -69,14 +68,15 @@ morph-spec archive {feature} [--force] [--no-git]        # archive WITHOUT integ
 
 ## CLI — feature birth & work-type routing
 
-Every feature is born with a **work type** that dimensions its pipeline: `feature` (full proposal → [uiux] → plan → implement → review), `bug` (lean), `chore` (fast-track straight to implement), `hotfix` (scout → surgical fix → human Gate 3 always, even under `trust: auto`).
+Every feature is born with a **work type** that dimensions its pipeline: `feature` (full plan → [uiux] → implement → review), `bug` (same flow, lean plan), `chore` (short plan, straight to implement), `hotfix` (surgical fix, human Gate 3 always, even under `trust: auto`).
 
-Every feature is also born with an **identity**: `--description` is required (`create` refuses a nameless scaffold without it), `name` defaults to the slug.
+Every feature is also born with an **identity**: a description is required (`create` refuses a nameless scaffold without it), `name` defaults to the slug. `--request` is kept literally in `feature.json → description`, and the plan critique checks the plan against it.
 
 ```bash
+morph-spec create {feature} --request '<free text>'                  # detector classifies the type AND seeds the description
+morph-spec create {feature} --type <t> --request '<title> <url>'     # issue link: the type is picked, the body stays out of the argument
 morph-spec create {feature} --type feature|bug|chore|hotfix --description "<what/why>"
-morph-spec create {feature} --request "<free text>"       # detector classifies the type AND seeds the description
-morph-spec retype {feature} {newType}                     # change type mid-flight (blocked after Gate 3)
+morph-spec retype {feature} {newType}                                # change type mid-flight (blocked after Gate 3)
 ```
 
 ---
@@ -84,7 +84,9 @@ morph-spec retype {feature} {newType}                     # change type mid-flig
 ## CLI — state (server-side, timestamped)
 
 ```bash
-morph-spec gate-decision {feature} {gate} --pause <bool> [--reason] [--signals json]   # writes gateDecisions
+morph-spec next {feature} [--json]                                                     # the next step, decided from disk
+morph-spec gate-check {feature} {gate} [--json]                                        # decide + record whether the gate pauses
+morph-spec gate-decision {feature} {gate} --pause <bool> [--reason] [--signals json]   # writes gateDecisions by hand
 ```
 
 Never hand-edit `gateDecisions`/`approvalGates` in `feature.json` — always go through these commands (they collide with the `state-sync` hook otherwise).
@@ -94,25 +96,18 @@ Never hand-edit `gateDecisions`/`approvalGates` in `feature.json` — always go
 ## CLI — validation
 
 ```bash
-morph-spec validate [packages|next-components|spec-tasks]
+morph-spec plan-check {feature} [--json]                           # validate plan.md, write checks.json
+morph-spec validate [packages|next-components]
 morph-spec validate-feature {feature} [--phase {phase}] [--json]   # alias: vf
-morph-spec verify {feature} [task] [--json] [--skip-tests] [--skip-build]   # deterministic build+test+validator chain, before the LLM judge
-```
-
----
-
-## CLI — DAG
-
-```bash
-morph-spec dag {feature} [--json]          # sequential vs parallel dispatch decision (effort-weighted)
-morph-spec dag {feature} --mermaid         # emit the tasks.json DAG as a Mermaid flowchart
+morph-spec verify {feature} [--json] [--filter <ids>] [--skip-tests] [--skip-build] [--skip-e2e]   # deterministic build+test+validator+e2e chain; the gate reads the unfiltered run
+morph-spec report-check {feature} [--before-eval] [--json]         # state of the implement and of the Gate 3 reports
 ```
 
 ---
 
 ## CLI — worktrees (parallel development / fleet)
 
-One feature = one git worktree = one Claude Code instance. Each worktree gets its own deterministic port block (`.morph/worktree.env`) and a regenerable handoff document.
+One feature = one git worktree = one Claude Code instance. Each worktree gets its own deterministic port block (`.morph/worktree.env`).
 
 ```bash
 morph-spec create {feature} --description "<what/why>" --worktree   # birth the feature already isolated in its own worktree
@@ -120,9 +115,8 @@ morph-spec worktree setup {feature}        # create worktrees/{feature}/ on bran
 morph-spec worktree link [--all]           # relink shared infra (node_modules[, .claude, .morph/framework])
 morph-spec worktree list [--json]          # active feature worktrees with phase/gate status
 # Close a worktree feature with `morph-spec finish {feature} --pr|--merge` (see above) — it absorbed `worktree finish`.
-morph-spec handoff {feature} [--json] [--here]   # regenerate the handoff doc — resolves the owning tree and writes THERE, safe to run from the root
 morph-spec doctor --worktrees [--prune]    # reconcile git's registry × disk × features; --prune also clears a dangling root worktree.path pointer
-morph-spec fleet [--json]                  # every active feature (root + worktrees) with phase/gates/ports/handoff/activity
+morph-spec fleet [--json]                  # every active feature (root + worktrees) with phase/gates/ports/activity
 ```
 
 ---
@@ -145,14 +139,13 @@ morph-spec dashboard [--port 3200]                                # open the ins
 .morph/
 ├── config/config.json           # project config (editable)
 ├── framework/                    # READ-ONLY
-│   ├── agents.json                # 8 domain personas
+│   ├── agents.json                # the 3 Gate 3 personas
 │   ├── standards/                 # standards registry
-│   └── templates/                 # code, IaC, and context templates
+│   └── CLI.md                     # every command in detail
 ├── context/                       # project context (editable)
 ├── features/{feature}/
 │   ├── feature.json                # authoritative, committed
-│   ├── handoff.md
-│   └── 0-proposal/ 1-design/ 2-plan/ 3-implement/ 4-review/
+│   └── 1-design/ 2-plan/ 3-implement/ 4-review/
 └── state.json                      # gitignored, derived index — never hand-edited
 
 .claude/
@@ -171,18 +164,17 @@ Never edited directly — go through CLI commands or `morph-spec update` instead
 | Path | Protected by |
 |------|-------------|
 | `.morph/state.json`, `.morph/framework/**` | `permissions.deny` |
-| `tasks.json` plan contract (`title`/`description`/`dependencies`/`effort`/`doneCriteria`/`group`) after Gate 2 | `protect-spec-files` hook (semantic diff) |
+| `2-plan/checks.json`, and the body of `2-plan/plan.md` after the plan gate (only `## Errata` is appended) | `protect-spec-files` hook |
 
 ---
 
 ## Links
 
 - [QUICKSTART.md](QUICKSTART.md) — step-by-step guide
-- [ARCHITECTURE.md](ARCHITECTURE.md) — system design
 - [CHANGELOG.md](../CHANGELOG.md) — release history
 - [npm](https://www.npmjs.com/package/@polymorphism-tech/morph-spec)
 - support@polymorphism.com.br
 
 ---
 
-*morph-spec v9.8.0 by Polymorphism Tech*
+*morph-spec v10.1.1 by Polymorphism Tech*