@polymorphism-tech/morph-spec 4.16.0 → 4.18.0

package/CLAUDE.md

@@ -99,6 +99,42 @@ State lives in `.morph/state.json` in target projects. Phase and outputs are **d
 - **Template helpers** — Handlebars v2.0 helpers: pascalCase, camelCase, snakeCase, kebabCase, pluralize, plus comparison/logic helpers
 - **CLI structure** — Commands are thin wrappers that delegate to `src/core/` or `src/lib/` modules. Keep business logic out of command files.
 
+## Framework Development Guardrails
+
+When modifying framework components, always verify the full scope of related files. A PostToolUse hook (`.claude/hooks/post-tool-use/framework-consistency-guard.js`) will remind you, but you should also proactively check.
+
+### Dependency Matrix
+
+| When you modify... | Also verify... |
+|---------------------|----------------|
+| `framework/agents.json` | squad-templates/*.json, agents-installer.js (tier defaults), advance-phase.js (hardcoded agent lists), doctor.js (REQUIRED_AGENTS), agents-manager.js (validation rules), total_agents/tier counts |
+| `framework/standards/**` | STANDARDS.json (entry exists), agents.json (agents reference the standard), .md file exists at declared path |
+| `framework/hooks/claude-code/**` | hooks-installer.js (MORPH_HOOKS array + MORPH_PERMISSIONS), hook follows fail-open pattern |
+| `framework/skills/**` | phases.json (requiredSkills if phase-bound), skills-installer.js, SKILL.md frontmatter |
+| `framework/phases.json` | advance-phase.js, dispatch-agents.js, output-schema.js (phase mappings) |
+| `framework/templates/**` | REGISTRY.json (template registered) |
+| `src/core/paths/output-schema.js` | Run `npm run generate` to update phase-utils.js and skill markdown blocks |
+
+### Per-Domain Checklists
+
+**Agents** — required fields: tier, title, group, active_phases, reports_to, domains, keywords, validators, standards. If tier 3+: teammate.spawn_prompt. If stack-specific: stacks[]. Update total_agents/tier counts.
+
+**Standards** — STANDARDS.json entry needs: id, name, path, category, subcategory, tags, digest. At least one agent must reference it. If stack-specific: stacks[].
+
+**Hooks** — must be in MORPH_HOOKS array in hooks-installer.js. Must follow fail-open pattern. If needs permissions: add to MORPH_PERMISSIONS.
+
+**Skills** — SKILL.md with valid frontmatter. If phase-bound: in phases.json requiredSkills. If stack-specific: stacks[] frontmatter.
+
+**Phases** — index/folder consistent. requiredSkills reference existing dirs. advance-phase.js handles transitions.
+
+**Templates** — registered in REGISTRY.json. Uses only available Handlebars helpers.
+
+**Output Schema** — always run `npm run generate` after changes.
+
+### Test Coverage
+
+Every `src/**/*.js` file should have a corresponding `test/**/*.test.js`. The consistency hook will warn when a test file is missing.
+
 ## Framework vs Runtime Distinction
 
 - **This repo** (`morph-spec-framework/`) = the CLI tool source code

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:** 4.16.0  
+**Version:** 4.18.0  
 **Requires:** Node.js 18+, Claude Code
 
 ---
@@ -364,4 +364,4 @@ Code generated by morph-spec (contracts, templates, implementation output) belon
 
 ---
 
-*morph-spec v4.16.0 by [Polymorphism Tech](https://polymorphism.tech)*
+*morph-spec v4.18.0 by [Polymorphism Tech](https://polymorphism.tech)*

package/bin/morph-spec.js

@@ -160,6 +160,7 @@ taskCommand
   .option('--note <text>', 'Add a deviation note explaining why task was done differently than planned')
   .option('--skip-validation', 'Skip code validation (budget-limited, requires --reason)')
   .option('--reason <text>', 'Reason for skipping validation (required with --skip-validation)')
+  .option('--skip-build', 'Skip test build guard')
   .option('--dry-run', 'Show validation results without marking tasks as complete')
   .action((feature, taskIds, options) => taskDoneCommand(feature, taskIds, options));
 
@@ -183,6 +184,7 @@ taskCommand
   .option('--note <text>', 'Add a deviation note explaining why tasks were done differently than planned')
   .option('--skip-validation', 'Skip code validation (budget-limited, requires --reason)')
   .option('--reason <text>', 'Reason for skipping validation (required with --skip-validation)')
+  .option('--skip-build', 'Skip test build guard')
   .option('--dry-run', 'Show validation results without marking tasks as complete')
   .action((feature, range, options) => taskBulkDoneCommand(feature, range, options));
 
@@ -190,6 +192,7 @@ taskCommand
   .command('annotate <feature> <task-id> <text>')
   .description('Add a note to a task (deviation, context, or blocker resolution)')
   .option('--type <type>', 'Note type: deviation | context | blocker-resolved', 'deviation')
+  .option('--mark-done', 'Also mark the task as completed')
   .action((feature, taskId, text, options) => taskAnnotateCommand(feature, taskId, text, options));
 
 // Generation commands