@polymorphism-tech/morph-spec 7.9.4 → 8.0.0

package/CLAUDE.md

@@ -49,7 +49,7 @@ No build step — pure ESM JavaScript, runs directly via Node.js 18+.
 - **`framework/`** — Metadata installed into target projects (READ-ONLY at runtime):
   - `MORPH.md` — NLH charter (the single source of behavioral truth)
   - `CLAUDE.md` — Runtime instructions injected into target's `.claude/CLAUDE.md`
-  - `agents.json` (v5.0.0) — 7 domain personas, no tiers
+  - `agents.json` (v5.2.0) — 8 agents: 7 domain personas + 1 stage persona (`scout`, read-only), no tiers
   - `phases.json` — 5 phases (proposal, uiux, plan, implement, review)
   - `standards/STANDARDS.json` — index of available standards
   - `hooks/claude-code/core/` — 7 fail-open guardrail hooks
@@ -70,7 +70,7 @@ No build step — pure ESM JavaScript, runs directly via Node.js 18+.
 
 **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 7 flat domain personas (dotnet-senior, ef-modeler, maf-expert, nextjs-expert, ui-designer, infra-engineer, evaluator). No tier system — Claude assumes the 3 NLH roles (Orchestrator/Specialist/Evaluator) per MORPH.md.
+**Personas, not tiers:** `agents.json` has 8 flat personas — 7 domain personas (dotnet-senior, ef-modeler, maf-expert, nextjs-expert, ui-designer, infra-engineer, evaluator) plus 1 stage persona (`scout`, read-only). `model` is sized per stage: `sonnet` for implementers, `opus` for `evaluator`, `haiku` for `scout`. No tier system — Claude assumes the 3 NLH roles (Orchestrator/Specialist/Evaluator) per MORPH.md.
 
 ### Phase Sequence
 

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:** 7.9.4  
+**Version:** 8.0.0  
 **Requires:** Node.js 22+, Claude Code
 
 ---
@@ -121,6 +121,14 @@ morph-spec approval-status {feature}
 
 ---
 
+## Work-type routing & worktrees
+
+Not every change deserves the full pipeline. Every feature is born with a **work type** — `feature`, `bug`, `chore`, or `hotfix` — set via `morph-spec create {feature} --type <type>` or classified from free text with `--request "<text>"`. The type dimensions the pipeline: `feature` runs the full proposal → [uiux] → plan → implement → review sequence; `bug` runs a lean proposal/plan; `chore` skips straight to implement (Gates 1/2 stamped by policy at birth); `hotfix` runs scout (read-only root-cause) → surgical fix → test loop, and its Gate 3 always pauses for a human even under `trust: auto`. Change the type mid-flight with `morph-spec retype {feature} {newType}` (undoes only policy-stamped gates, preserves human approvals, blocked after Gate 3).
+
+Independent features can also be developed **in parallel, each isolated in its own git worktree** — one feature, one worktree, one Claude Code instance. `morph-spec create {feature} --worktree` (or `morph-spec worktree setup {feature}`) creates `.worktrees/{feature}/` on branch `morph/{feature}`. The authoritative `feature.json` travels committed on the branch; shared infra (`node_modules`, `.claude`, `.morph/framework`) is linked via junctions (`morph-spec worktree link --all` repairs it if missing). Close out with `morph-spec worktree finish {feature}` (merges `--no-ff` back into the clean primary root) followed by `morph-spec archive {feature}` at the root; `morph-spec worktree list` shows every active worktree with its phase and gate status.
+
+---
+
 ## Slash commands
 
 These commands are available inside Claude Code after init.
@@ -130,6 +138,7 @@ These commands are available inside Claude Code after init.
 | --------------------------- | --------------------------------------------------------- |
 | `/morph-proposal {feature}` | Full spec pipeline (phases 0-4, pauses at approval gates) |
 | `/morph-apply {feature}`    | Implement approved feature (phase 5)                      |
+| `/morph-hotfix {feature}`   | Surgical hotfix ADW — scout → fix → human Gate 3 → ship    |
 | `/morph-status`             | Feature status dashboard                                  |
 | `/morph-preflight`          | Pre-implementation validation                             |
 
@@ -166,6 +175,26 @@ morph-spec status {feature}            # Feature status dashboard
 morph-spec validate                    # Run all validators
 morph-spec validate {validator}        # Run specific validator
 morph-spec validate-feature {feature}  # Content-aware feature validation
+morph-spec verify {feature} [task]     # Deterministic build+tests+validators chain, before the LLM judge
+```
+
+### Work-type routing
+
+```bash
+morph-spec create {feature} --type feature|bug|chore|hotfix   # Explicit birth: type dimensions the pipeline
+morph-spec create {feature} --request "<free text>"           # Deterministic detector classifies the type
+morph-spec retype {feature} {newType}                          # Change work type mid-flight (blocked after Gate 3)
+morph-spec dag {feature} [--mermaid]                            # DAG dispatch decision; --mermaid emits a flowchart
+```
+
+### Worktrees (parallel development)
+
+```bash
+morph-spec create {feature} --worktree   # Birth the feature already isolated in its own worktree
+morph-spec worktree setup {feature}      # Create .worktrees/{feature}/ on branch morph/{feature}
+morph-spec worktree link [--all]         # Relink shared infra (node_modules, .claude, .morph/framework)
+morph-spec worktree finish {feature}     # Merge --no-ff back to the primary root, clean up (requires Gate 3)
+morph-spec worktree list [--json]        # List active feature worktrees with phase/gate status
 ```
 
 ---
@@ -365,4 +394,4 @@ Code generated by morph-spec (contracts, templates, implementation output) belon
 
 ---
 
-*morph-spec v7.9.4 by [Polymorphism Tech](https://polymorphism.tech)*
+*morph-spec v8.0.0 by [Polymorphism Tech](https://polymorphism.tech)*

package/bin/morph-spec.js

@@ -23,7 +23,7 @@ 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 } from '../src/commands/project/worktree.js';
+import { worktreeSetupCommand, worktreeLinkCommand, worktreeFinishCommand, worktreeListCommand } from '../src/commands/project/worktree.js';
 
 // === Approval gates (human-only) ===
 import { approveCommand, approvalStatusCommand, unapproveCommand } from '../src/commands/state/approve.js';
@@ -32,6 +32,7 @@ import { archiveCommand } from '../src/commands/state/archive.js';
 import { scoreCommand } from '../src/commands/state/score.js';
 import { gateDecisionCommand } from '../src/commands/state/gate-decision.js';
 import { createCommand } from '../src/commands/state/create.js';
+import { retypeCommand } from '../src/commands/state/retype.js';
 
 // === Tasks ===
 import { dagCommand } from '../src/commands/tasks/dag.js';
@@ -39,6 +40,7 @@ import { dagCommand } from '../src/commands/tasks/dag.js';
 // === Validation ===
 import { validateCommand } from './validate.js';
 import { validateFeatureCommand } from '../src/commands/validation/validate-feature.js';
+import { verifyCommand } from '../src/commands/validation/verify.js';
 
 // === Scaffolding ===
 import { scaffoldDotnetCommand, scaffoldNextjsCommand } from '../src/commands/scaffold/scaffold.js';
@@ -170,8 +172,12 @@ program
 
 program
   .command('create <feature>')
-  .description('Create the feature folder structure + canonical feature.json (explicit birth — see framework/schemas/feature.schema.json)')
+  .description('Classify work type (--type/--request), scaffold + stamp policy gates, and create the canonical feature.json (explicit birth — see framework/schemas/feature.schema.json)')
   .option('--status <status>', 'Initial feature status (default: in_progress)')
+  .option('--type <type>', 'Work type: feature|bug|chore|hotfix (default: feature) — see src/core/work-types.js')
+  .option('--request <text>', 'Free-text request classified by the deterministic detector; tie/none exits 2 with candidates for an LLM/user decision (feature NOT created)')
+  .option('--detect-source <source>', 'workTypeDetection.source recorded when --type is explicit: deterministic|llm|user (default: user)')
+  .option('--worktree', 'Create the feature already inside its own git worktree (branch morph/{feature}) — fails open outside a git repo')
   .option('--json', 'Output as JSON')
   .action((feature, options) => createCommand(feature, options));
 
@@ -182,11 +188,19 @@ program
   .option('--json', 'Output as JSON')
   .action((feature, task, score, options) => scoreCommand(feature, task, score, options));
 
+program
+  .command('retype <feature> <newType>')
+  .description('Change a feature work type mid-flight (feature|bug|chore|hotfix) — resets only policy-stamped gates, preserves human approvals')
+  .option('--reason <text>', 'Why the type changed')
+  .option('--json', 'Output as JSON')
+  .action((feature, newType, options) => retypeCommand(feature, newType, options));
+
 // ─── Tasks ────────────────────────────────────────────────────────────────
 program
   .command('dag <feature>')
   .description('Analyze the tasks.json DAG and print the sequential vs parallel dispatch decision (effort-weighted)')
   .option('--json', 'Output as JSON')
+  .option('--mermaid', 'Emit the tasks.json DAG as a Mermaid flowchart (flowchart TD)')
   .action((feature, options) => dagCommand(feature, options));
 
 // ─── Validation ───────────────────────────────────────────────────────────
@@ -215,6 +229,19 @@ program
   .option('-v, --verbose', 'Show detailed output')
   .action(validateFeatureCommand);
 
+program
+  .command('verify <feature> [task]')
+  .description('Run the deterministic verification chain (build + tests + validators) — 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('--skip-tests', 'Skip the test node')
+  .option('--skip-build', 'Skip the build node')
+  .option('--no-persist', 'Do not persist the result to feature.json')
+  .action((feature, task, options) =>
+    verifyCommand(feature, task, { ...options, noPersist: options.persist === false })
+  );
+
 // ─── Scaffolding ──────────────────────────────────────────────────────────
 const scaffoldCmd = program
   .command('scaffold')
@@ -273,6 +300,27 @@ worktreeCommand
   .option('--fresh', 'Create a new dated branch even if one already exists')
   .action((feature, options) => worktreeSetupCommand(feature, options));
 
+worktreeCommand
+  .command('link')
+  .description('Link shared infra (node_modules[, .claude, .morph/framework]) into the current worktree')
+  .option('--target <path>', 'Worktree path to link into (default: cwd)')
+  .option('--all', 'Link all shared dirs, not just node_modules')
+  .action((options) => worktreeLinkCommand(options));
+
+worktreeCommand
+  .command('finish <feature>')
+  .description('Merge the feature branch back into the primary root and clean up the worktree (requires Gate 3 approved)')
+  .option('--keep', 'Keep the worktree and branch after merging')
+  .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) => worktreeFinishCommand(feature, options));
+
+worktreeCommand
+  .command('list')
+  .description('List active feature worktrees with their phase and gate status')
+  .option('--json', 'Output as JSON')
+  .action((options) => worktreeListCommand(options));
+
 // ─── Dashboard ────────────────────────────────────────────────────────────
 program
   .command('dashboard')