@polymorphism-tech/morph-spec 4.7.2 → 4.8.4

package/docs/CHEATSHEET.md

@@ -1,221 +1,203 @@
-# morph-spec Cheat Sheet
-
-## Setup
-
-```bash
-npm install -g @polymorphism-tech/morph-spec   # install globally
-morph-spec init                                 # initialize project
-morph-spec init --wizard                        # interactive wizard
-morph-spec init --force                         # overwrite existing
-morph-spec update                               # sync framework files
-morph-spec doctor                               # health check
-morph-spec --version
-```
-
----
-
-## Phase workflow
-
-```
-proposal → setup → [uiux] → design → clarify → tasks → implement → [sync]
-```
-
-Phases in brackets are optional.
-
-| Phase | Directory | Output files | Gate |
-|-------|-----------|--------------|------|
-| proposal | `0-proposal/` | `proposal.md` | ✅ Approval |
-| setup | *(no output)* | context loaded | — |
-| uiux *(optional)* | `2-ui/` | `design-system.md`, `mockups.md`, `components.md`, `flows.md` | ✅ Approval |
-| design | `1-design/` | `spec.md`, `contracts.cs`, `decisions.md` | ✅ Approval |
-| clarify | `1-design/` | spec updated | — |
-| tasks | `3-tasks/` | `tasks.md` | ✅ Approval |
-| implement | `4-implement/` | code + `recap.md` | — |
-| sync *(optional)* | `.morph/context/` | standards updated | — |
-
----
-
-## Slash commands (Claude Code)
-
-| Command | Description |
-|---------|-------------|
-| `/morph-proposal {feature}` | Full spec pipeline — phases 0–4 with approval gates |
-| `/morph-apply {feature}` | Implement approved feature — phase 5 |
-| `/morph-status` | Project-wide feature status dashboard |
-| `/morph-preflight` | Pre-implementation validation (7 checks) |
-
----
-
-## CLI — project management
-
-```bash
-morph-spec init [--wizard] [--force] [--skip-detection] [--skip-mcp]
-morph-spec update [--wizard] [--templates] [--standards]
-morph-spec doctor
-morph-spec detect [--verbose]
-morph-spec update-agents                       # refresh .claude/agents/
-```
-
----
-
-## CLI — feature workflow
-
-```bash
-morph-spec state list                          # all features
-morph-spec state get {feature} [--json]        # feature detail
-morph-spec state show {feature}                # phase + approval status
-morph-spec state set {feature} {key} {value}   # update property
-morph-spec state checkpoint {feature} "note"   # manual checkpoint
-morph-spec phase advance {feature}             # advance to next phase
-morph-spec status {feature} [--json] [--verbose]
-morph-spec diff {feature}                      # spec changes since snapshot
-morph-spec diff-save {feature}                 # save snapshot
-morph-spec rollback {feature} --to {phase}     # revert to phase
-morph-spec task done {feature}                 # mark task complete
-morph-spec task start {feature}                # start next task
-morph-spec task next {feature}                 # preview next task
-```
-
----
-
-## CLI — validation
-
-```bash
-morph-spec validate                            # all validators
-morph-spec validate architecture
-morph-spec validate packages
-morph-spec validate contrast [--wcag-aaa]
-morph-spec validate-blazor [path]
-morph-spec validate-blazor-state [path]
-morph-spec analyze-blazor-concurrency [path]
-morph-spec validate-css [path]
-morph-spec validate-feature {feature} [--phase {phase}] [--json]
-```
-
----
-
-## CLI — standards
-
-```bash
-morph-spec standards --list
-morph-spec standards --list --category {name}  # categories: core, backend, frontend, infra, ...
-morph-spec standards --search {query}
-morph-spec standards --show {id}
-morph-spec standards --json
-```
-
----
-
-## CLI — utilities
-
-```bash
-morph-spec cost {bicep-file}                   # Azure cost estimate
-morph-spec cost {bicep-file} --verbose
-morph-spec cost {bicep-file} --strict          # exit 1 if over limit
-morph-spec troubleshoot {keywords}
-morph-spec troubleshoot --category {name}
-morph-spec session-summary {feature}
-```
-
----
-
-## State — mark-output
-
-```bash
-morph-spec state mark-output {feature} proposal
-morph-spec state mark-output {feature} spec
-morph-spec state mark-output {feature} contracts
-morph-spec state mark-output {feature} decisions
-morph-spec state mark-output {feature} tasks
-morph-spec state mark-output {feature} recap
-
-# UI outputs (camelCase or kebab-case both work)
-morph-spec state mark-output {feature} uiDesignSystem
-morph-spec state mark-output {feature} uiMockups
-morph-spec state mark-output {feature} uiComponents
-morph-spec state mark-output {feature} uiFlows
-```
-
----
-
-## State — agents
-
-```bash
-morph-spec state add-agent {feature} {agent-id}
-morph-spec state remove-agent {feature} {agent-id}
-morph-spec detect-agents "{description}"          # detect agents for request
-morph-spec detect-agents --json "{description}"   # with standards
-morph-spec detect-agents --ids-only "{description}"
-```
-
----
-
-## Checkpoints
-
-```bash
-morph-spec checkpoint-save {feature}
-morph-spec checkpoint-restore {feature}
-morph-spec checkpoint-list {feature}
-```
-
----
-
-## Directory structure
-
-```
-.morph/
-├── config/
-│   └── config.json               # project config (editable)
-├── framework/                    # READ-ONLY
-│   ├── agents.json               # 37 agents, 4 tiers
-│   ├── standards/                # 74 standards across 11 categories
-│   └── templates/                # code and IaC templates
-├── context/                      # project context (editable)
-│   ├── README.md
-│   └── standards.md
-├── features/
-│   └── {feature}/
-│       ├── 0-proposal/proposal.md
-│       ├── 1-design/spec.md, contracts.cs, decisions.md
-│       ├── 2-ui/design-system.md, mockups.md, components.md, flows.md
-│       ├── 3-tasks/tasks.md
-│       └── 4-implement/recap.md
-├── checkpoints/
-├── logs/
-└── state.json                    # READ-ONLY — CLI managed
-
-.claude/
-├── commands/                     # slash commands
-├── skills/                       # framework skills (SKILL.md per dir)
-├── agents/                       # native subagents (37)
-│   ├── morph-{id}.md             # tier 1-2 agents
-│   └── morph-domain-{name}.md   # tier 3 domain agents
-├── rules/                        # path-scoped rules (5 files)
-└── settings.local.json           # hooks (11)
-```
-
----
-
-## Protected files
-
-These files are never edited directly. Use CLI commands or `morph-spec update` instead:
-
-| Path | Protected by |
-|------|-------------|
-| `.morph/state.json` | `permissions.deny` |
-| `.morph/framework/**` | `permissions.deny` |
-| Approved spec/contracts | `protect-spec-files.js` 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 v4.6.0 by Polymorphism Tech*
+# morph-spec Cheat Sheet
+
+## Setup
+
+```bash
+npm install -g @polymorphism-tech/morph-spec   # install globally
+morph-spec init                                 # initialize project
+morph-spec init --wizard                        # interactive wizard
+morph-spec init --force                         # overwrite existing
+morph-spec update                               # sync framework files
+morph-spec doctor                               # health check
+morph-spec --version
+```
+
+---
+
+## Phase workflow
+
+```
+proposal → setup → [uiux] → design → clarify → tasks → implement → [sync]
+```
+
+Phases in brackets are optional.
+
+| Phase | Directory | Output files | Gate |
+|-------|-----------|--------------|------|
+| proposal | `0-proposal/` | `proposal.md` | ✅ Approval |
+| setup | *(no output)* | context loaded | — |
+| uiux *(optional)* | `2-ui/` | `design-system.md`, `mockups.md`, `components.md`, `flows.md` | ✅ Approval |
+| design | `1-design/` | `spec.md`, `contracts.cs`, `decisions.md` | ✅ Approval |
+| clarify | `1-design/` | spec updated | — |
+| tasks | `3-tasks/` | `tasks.md` | ✅ Approval |
+| implement | `4-implement/` | code + `recap.md` | — |
+| sync *(optional)* | `.morph/context/` | standards updated | — |
+
+---
+
+## Slash commands (Claude Code)
+
+| Command | Description |
+|---------|-------------|
+| `/morph-proposal {feature}` | Full spec pipeline — phases 0–4 with approval gates |
+| `/morph-apply {feature}` | Implement approved feature — phase 5 |
+| `/morph-status` | Project-wide feature status dashboard |
+| `/morph-preflight` | Pre-implementation validation (7 checks) |
+
+---
+
+## CLI — project management
+
+```bash
+morph-spec init [--force] [--skip-mcp]
+morph-spec update [--templates] [--standards]
+morph-spec doctor
+```
+
+---
+
+## CLI — feature workflow
+
+```bash
+morph-spec state list                          # all features
+morph-spec state get {feature} [--json]        # feature detail
+morph-spec state set {feature} {key} {value}   # update property
+morph-spec phase advance {feature}             # advance to next phase
+morph-spec status {feature} [--json] [--verbose]
+morph-spec task done {feature}                 # mark task complete
+morph-spec task start {feature}                # start next task
+morph-spec task next {feature}                 # preview next task
+```
+
+---
+
+## CLI — validation
+
+```bash
+morph-spec validate                            # all validators
+morph-spec validate architecture
+morph-spec validate packages
+morph-spec validate contrast [--wcag-aaa]
+morph-spec validate-feature {feature} [--phase {phase}] [--json]
+```
+
+---
+
+## CLI — utilities
+
+```bash
+morph-spec generate recap {feature}           # auto-generate recap.md
+morph-spec template render {id} {output} {vars-json}
+morph-spec trust status [feature]
+morph-spec trust set {feature} {level} [reason]
+morph-spec mcp setup [name] [--list] [--auto]
+```
+
+---
+
+## State — mark-output
+
+```bash
+morph-spec state mark-output {feature} proposal
+morph-spec state mark-output {feature} spec
+morph-spec state mark-output {feature} contracts
+morph-spec state mark-output {feature} decisions
+morph-spec state mark-output {feature} tasks
+morph-spec state mark-output {feature} recap
+
+# UI outputs (camelCase or kebab-case both work)
+morph-spec state mark-output {feature} uiDesignSystem
+morph-spec state mark-output {feature} uiMockups
+morph-spec state mark-output {feature} uiComponents
+morph-spec state mark-output {feature} uiFlows
+```
+
+---
+
+## State — agents
+
+```bash
+morph-spec state add-agent {feature} {agent-id}
+morph-spec state remove-agent {feature} {agent-id}
+```
+
+---
+
+## Checkpoints
+
+```bash
+morph-spec checkpoint-save {feature}
+morph-spec checkpoint-restore {feature}
+morph-spec checkpoint-list {feature}
+```
+
+---
+
+## Approvals
+
+```bash
+morph-spec approve {feature} {gate}            # approve a gate
+morph-spec approval-status {feature}           # show gate status
+```
+
+---
+
+## Directory structure
+
+```
+.morph/
+├── config/
+│   └── config.json               # project config (editable)
+├── framework/                    # READ-ONLY
+│   ├── agents.json               # 38 agents, 4 tiers
+│   ├── standards/                # 82 standards across 11 categories
+│   └── templates/                # code and IaC templates
+├── context/                      # project context (editable)
+│   ├── README.md
+│   └── standards.md
+├── features/
+│   └── {feature}/
+│       ├── 0-proposal/proposal.md
+│       ├── 1-design/spec.md, contracts.cs, decisions.md
+│       ├── 2-ui/design-system.md, mockups.md, components.md, flows.md
+│       ├── 3-tasks/tasks.md
+│       └── 4-implement/recap.md
+├── checkpoints/
+├── logs/
+└── state.json                    # READ-ONLY — CLI managed
+
+.claude/
+├── commands/                     # slash commands
+├── skills/                       # framework skills (SKILL.md per dir)
+├── agents/                       # native subagents (38)
+│   ├── morph-{id}.md             # tier 1-2 agents
+│   └── morph-domain-{name}.md   # tier 3 domain agents
+├── rules/                        # path-scoped rules (6 files)
+└── settings.local.json           # hooks (11)
+```
+
+---
+
+## Protected files
+
+These files are never edited directly. Use CLI commands or `morph-spec update` instead:
+
+| Path | Protected by |
+|------|-------------|
+| `.morph/state.json` | `permissions.deny` |
+| `.morph/framework/**` | `permissions.deny` |
+| Approved spec/contracts | `protect-spec-files.js` 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 v4.8.4 by Polymorphism Tech*

package/docs/QUICKSTART.md

@@ -29,7 +29,7 @@ morph-spec init
 - Creates `.morph/` with framework files, standards, and templates
 - Creates `.morph/context/` with inferred project context
 - Installs `.claude/skills/`, `.claude/agents/`, `.claude/rules/`
-- Writes `.claude/settings.local.json` with 11 Claude Code hooks
+- Writes `.claude/settings.local.json` with 10 Claude Code hooks
 - Copies `CLAUDE.md` with runtime instructions
 
 Verify the installation:
@@ -118,12 +118,6 @@ morph-spec state get my-feature
 morph-spec status my-feature
 ```
 
-See what phase the feature is in and which approval gates have been passed:
-
-```bash
-morph-spec state show my-feature
-```
-
 Advance to the next phase manually (when needed):
 
 ```bash
@@ -209,4 +203,4 @@ morph-spec doctor
 
 ---
 
-*morph-spec v4.6.0 by Polymorphism Tech*
+*morph-spec v4.8.4 by Polymorphism Tech*

package/framework/CLAUDE.md

@@ -74,4 +74,4 @@ MCP tools load on-demand instead of all at startup — keeps context clean for a
 
 ---
 
-*MORPH-SPEC v4.5.0 by Polymorphism Tech*
+*MORPH-SPEC by Polymorphism Tech*

package/framework/commands/morph-proposal.md

@@ -22,9 +22,9 @@ npx morph-spec state get {feature-name}
 ### Workflow
 
 1. **Detecte agentes automaticamente:**
-   ```bash
-   npx morph-spec detect-agents "$ARGUMENTS"
-   ```
+   - Read `.morph/framework/agents.json`
+   - Para cada agente, compare `domains` e `keywords` com a feature solicitada
+   - Registre os agentes relevantes: `npx morph-spec state add-agent {feature-name} {agent-id}`
 
 2. **Invoque skills dos agentes detectados:**
    - Para agentes com `skillPath` em agents.json, consulte o Skill correspondente

package/framework/hooks/README.md

@@ -12,12 +12,10 @@ framework/hooks/
 │   ├── user-prompt/
 │   │   └── enrich-prompt.js         # Context-aware prompt enrichment
 │   ├── pre-tool-use/
-│   │   ├── protect-readonly-files.js # Block edits to state.json & framework/
 │   │   ├── protect-spec-files.js    # Block edits to approved spec artifacts
 │   │   └── enforce-phase-writes.js  # Enforce writes to correct phase dir
 │   ├── post-tool-use/
-│   │   ├── track-output-creation.js # Auto-mark outputs as created
-│   │   └── dispatch.js              # Dispatch on CLI commands
+│   │   └── dispatch.js              # Dispatch on CLI commands (auto-checkpoint)
 │   ├── stop/
 │   │   └── validate-completion.js   # Advisory: warn about incomplete work
 │   ├── pre-compact/
@@ -85,7 +83,6 @@ The installer writes to `.claude/settings.local.json`:
       { "matcher": "Bash", "hooks": [...] }
     ],
     "PostToolUse": [
-      { "matcher": "Write", "hooks": [...] },
       { "matcher": "Bash", "hooks": [...] }
     ],
     "Stop": [{ "hooks": [...] }],
@@ -202,4 +199,4 @@ morph-spec doctor --reset
 
 ---
 
-*MORPH-SPEC v4.5.0 — Hooks Architecture v2.5*
+*MORPH-SPEC by Polymorphism Tech — Hooks Architecture v2.5*

package/framework/hooks/claude-code/pre-tool-use/protect-readonly-files.js

@@ -1,58 +1,7 @@
 #!/usr/bin/env node
-
 /**
- * PreToolUse Hook: Protect state.json & Framework Files
- *
- * Event: PreToolUse | Matcher: Write|Edit
- *
- * Blocks direct edits to:
- *   - .morph/state.json → must use CLI commands
- *   - .morph/framework/** → read-only framework files
- *
- * Fail-open: exits 0 on any error.
+ * DEPRECATED — This hook has been replaced by native permissions.deny in settings.local.json.
+ * The file is kept as an empty stub. It is NOT registered in hooks-installer.js.
+ * Safe to delete.
  */
-
-import { readStdin } from '../../shared/stdin-reader.js';
-import { stateExists } from '../../shared/state-reader.js';
-import { isStatePath, isFrameworkPath } from '../../shared/phase-utils.js';
-import { block, pass } from '../../shared/hook-response.js';
-
-try {
-  // Skip if not a morph-spec project
-  if (!stateExists()) {
-    pass();
-  }
-
-  const payload = await readStdin();
-  if (!payload) pass();
-
-  const filePath = payload?.tool_input?.file_path || payload?.tool_input?.path || '';
-  if (!filePath) pass();
-
-  // Block edits to state.json
-  if (isStatePath(filePath)) {
-    block(
-      'MORPH-SPEC: Direct edits to .morph/state.json are blocked.\n' +
-      'Use CLI commands instead:\n' +
-      '  morph-spec state set <feature> <key> <value>\n' +
-      '  morph-spec phase advance <feature>\n' +
-      '  morph-spec task done <feature> <taskId>\n' +
-      '  morph-spec approve <feature> <gate>'
-    );
-  }
-
-  // Block edits to framework files
-  if (isFrameworkPath(filePath)) {
-    block(
-      'MORPH-SPEC: Files in .morph/framework/ are read-only.\n' +
-      'These files are managed by the framework and overwritten on update.\n' +
-      'To customize, create project-specific overrides in .morph/context/ or .morph/config/.'
-    );
-  }
-
-  // All other files are allowed
-  pass();
-} catch {
-  // Fail-open
-  process.exit(0);
-}
+process.exit(0);

package/framework/hooks/claude-code/session-start/inject-morph-context.js

@@ -11,13 +11,26 @@
  * Fail-open: exits 0 on any error.
  */
 
-import { loadState, getActiveFeature, getPendingGates, getMissingOutputs } from '../../shared/state-reader.js';
+import { loadState, getActiveFeature, getPendingGates, getMissingOutputs, derivePhaseForFeature } from '../../shared/state-reader.js';
 import { stateExists } from '../../shared/state-reader.js';
 import { injectContext, pass } from '../../shared/hook-response.js';
 import { readFileSync, existsSync } from 'fs';
 import { join } from 'path';
 
-const SPEC_MAX_CHARS = 3000;
+const DEFAULT_SPEC_MAX_CHARS = 3000;
+
+function getSpecMaxChars() {
+  try {
+    const configPath = join(process.cwd(), '.morph/config/config.json');
+    if (!existsSync(configPath)) return DEFAULT_SPEC_MAX_CHARS;
+    const cfg = JSON.parse(readFileSync(configPath, 'utf-8'));
+    return cfg?.hooks?.specInjectionLimit ?? DEFAULT_SPEC_MAX_CHARS;
+  } catch {
+    return DEFAULT_SPEC_MAX_CHARS;
+  }
+}
+
+const SPEC_MAX_CHARS = getSpecMaxChars();
 
 try {
   if (!stateExists()) pass();
@@ -30,7 +43,8 @@ try {
 
   if (active) {
     const { name, feature } = active;
-    lines.push(`- Active feature: ${name} (phase: ${feature.phase}, workflow: ${feature.workflow || 'auto'})`);
+    const phase = derivePhaseForFeature(name);
+    lines.push(`- Active feature: ${name} (phase: ${phase}, workflow: ${feature.workflow || 'auto'})`);
     lines.push(`- Status: ${feature.status}`);
 
     // Task progress
@@ -78,8 +92,9 @@ try {
     const featureNames = Object.keys(state.features);
     lines.push(`- Features: ${featureNames.length} (${featureNames.join(', ')})`);
 
-    for (const [name, feature] of Object.entries(state.features)) {
-      lines.push(`  - ${name}: phase=${feature.phase}, status=${feature.status}`);
+    for (const [fname, feat] of Object.entries(state.features)) {
+      const fPhase = derivePhaseForFeature(fname);
+      lines.push(`  - ${fname}: phase=${fPhase}, status=${feat.status}`);
     }
   }
 

package/framework/hooks/claude-code/statusline.py

@@ -347,7 +347,12 @@ def get_session_name(entries):
 def get_block_start(transcript_path, entries):
     """Find start of current 5-hour billing block. Cached per transcript."""
     h = hashlib.sha256(transcript_path.encode()).hexdigest()[:16]
-    cache_dir  = Path.home() / '.cache' / 'morph-spec'
+    # Use platform-appropriate cache directory
+    if os.name == 'nt':
+        base = Path(os.environ.get('LOCALAPPDATA', str(Path.home() / 'AppData' / 'Local')))
+        cache_dir = base / 'morph-spec' / 'cache'
+    else:
+        cache_dir = Path.home() / '.cache' / 'morph-spec'
     cache_file = cache_dir / f'block-{h}.json'
     now        = time.time()
     block_s    = 5 * 3600