@polymorphism-tech/morph-spec 4.10.9 → 4.11.0

package/framework/hooks/shared/phase-utils.js

@@ -1,139 +1,139 @@
-// GENERATED by scripts/generate-refs.js — DO NOT EDIT manually
-// Source of truth: src/core/paths/output-schema.js
-// Regenerate with: node scripts/generate-refs.js
-/**
- * Shared phase utilities for Claude Code hooks.
- *
- * Maps phases to directories and output types.
- */
-
-/** Phase order */
-export const PHASE_ORDER = ["proposal","setup","uiux","design","clarify","plan","tasks","implement","sync"];
-
-/** Map phase → allowed output subdirectory */
-export const PHASE_DIRS = {
-  proposal: '0-proposal',
-  setup: '0-proposal',
-  uiux: '2-ui',
-  design: '1-design',
-  clarify: '1-design',
-  plan: '3-plan',
-  tasks: '4-tasks',
-  implement: '5-implement',
-  sync: '5-implement',
-};
-
-/** Map output type (camelCase) → phase that produces it */
-export const OUTPUT_PHASE_MAP = {
-  proposal: 'proposal',
-  schemaAnalysis: 'design',
-  spec: 'design',
-  clarifications: 'clarify',
-  contracts: 'design',
-  contractsTs: 'design',
-  contractsVsa: 'design',
-  plan: 'plan',
-  tasks: 'tasks',
-  uiDesignSystem: 'uiux',
-  uiMockups: 'uiux',
-  uiComponents: 'uiux',
-  uiFlows: 'uiux',
-  decisions: 'design',
-  recap: 'implement',
-};
-
-/** Map filename → output type (camelCase) */
-export const FILENAME_TO_OUTPUT = {
-  'proposal.md': 'proposal',
-  'schema-analysis.md': 'schemaAnalysis',
-  'spec.md': 'spec',
-  'clarifications.md': 'clarifications',
-  'contracts.cs': 'contracts',
-  'contracts.ts': 'contractsTs',
-  'contracts-vsa.cs': 'contractsVsa',
-  'plan.md': 'plan',
-  'tasks.md': 'tasks',
-  'design-system.md': 'uiDesignSystem',
-  'mockups.md': 'uiMockups',
-  'components.md': 'uiComponents',
-  'flows.md': 'uiFlows',
-  'decisions.md': 'decisions',
-  'recap.md': 'recap',
-};
-
-/** Protected spec files and the approval gate that locks them */
-export const PROTECTED_SPEC_FILES = {
-  'schema-analysis.md': 'design',
-  'spec.md': 'design',
-  'contracts.cs': 'design',
-  'contracts.ts': 'design',
-  'contracts-vsa.cs': 'design',
-  'plan.md': 'plan',
-  'tasks.md': 'tasks',
-  'design-system.md': 'uiux',
-  'mockups.md': 'uiux',
-  'components.md': 'uiux',
-  'flows.md': 'uiux',
-};
-
-/**
- * Extract feature name from a .morph/features/{feature}/... path
- * @param {string} filePath - File path to analyze
- * @returns {string|null} Feature name or null
- */
-export function extractFeatureName(filePath) {
-  const normalized = filePath.replace(/\\/g, '/');
-  const match = normalized.match(/\.morph\/features\/([^/]+)\//);
-  return match ? match[1] : null;
-}
-
-/**
- * Extract phase subdirectory from a .morph/features/{feature}/{phaseDir}/... path
- * @param {string} filePath - File path to analyze
- * @returns {string|null} Phase directory (e.g., '0-proposal', '1-design') or null
- */
-export function extractPhaseDir(filePath) {
-  const normalized = filePath.replace(/\\/g, '/');
-  const match = normalized.match(/\.morph\/features\/[^/]+\/(\d+-[^/]+)\//);
-  return match ? match[1] : null;
-}
-
-/**
- * Check if a file path is inside .morph/features/
- * @param {string} filePath
- * @returns {boolean}
- */
-export function isFeaturePath(filePath) {
-  const normalized = filePath.replace(/\\/g, '/');
-  return normalized.includes('.morph/features/');
-}
-
-/**
- * Check if a file path is inside .morph/framework/ (readonly)
- * @param {string} filePath
- * @returns {boolean}
- */
-export function isFrameworkPath(filePath) {
-  const normalized = filePath.replace(/\\/g, '/');
-  return normalized.includes('.morph/framework/');
-}
-
-/**
- * Check if a file path is state.json
- * @param {string} filePath
- * @returns {boolean}
- */
-export function isStatePath(filePath) {
-  const normalized = filePath.replace(/\\/g, '/');
-  return normalized.endsWith('.morph/state.json');
-}
-
-/**
- * Get the basename of a file path
- * @param {string} filePath
- * @returns {string}
- */
-export function getBasename(filePath) {
-  const normalized = filePath.replace(/\\/g, '/');
-  return normalized.split('/').pop();
-}
+// GENERATED by scripts/generate-refs.js — DO NOT EDIT manually
+// Source of truth: src/core/paths/output-schema.js
+// Regenerate with: node scripts/generate-refs.js
+/**
+ * Shared phase utilities for Claude Code hooks.
+ *
+ * Maps phases to directories and output types.
+ */
+
+/** Phase order */
+export const PHASE_ORDER = ["proposal","setup","uiux","design","clarify","plan","tasks","implement","sync"];
+
+/** Map phase → allowed output subdirectory */
+export const PHASE_DIRS = {
+  proposal: '0-proposal',
+  setup: '0-proposal',
+  uiux: '2-ui',
+  design: '1-design',
+  clarify: '1-design',
+  plan: '3-plan',
+  tasks: '4-tasks',
+  implement: '5-implement',
+  sync: '5-implement',
+};
+
+/** Map output type (camelCase) → phase that produces it */
+export const OUTPUT_PHASE_MAP = {
+  proposal: 'proposal',
+  schemaAnalysis: 'design',
+  spec: 'design',
+  clarifications: 'clarify',
+  contracts: 'design',
+  contractsTs: 'design',
+  contractsVsa: 'design',
+  plan: 'plan',
+  tasks: 'tasks',
+  uiDesignSystem: 'uiux',
+  uiMockups: 'uiux',
+  uiComponents: 'uiux',
+  uiFlows: 'uiux',
+  decisions: 'design',
+  recap: 'implement',
+};
+
+/** Map filename → output type (camelCase) */
+export const FILENAME_TO_OUTPUT = {
+  'proposal.md': 'proposal',
+  'schema-analysis.md': 'schemaAnalysis',
+  'spec.md': 'spec',
+  'clarifications.md': 'clarifications',
+  'contracts.cs': 'contracts',
+  'contracts.ts': 'contractsTs',
+  'contracts-vsa.cs': 'contractsVsa',
+  'plan.md': 'plan',
+  'tasks.md': 'tasks',
+  'design-system.md': 'uiDesignSystem',
+  'mockups.md': 'uiMockups',
+  'components.md': 'uiComponents',
+  'flows.md': 'uiFlows',
+  'decisions.md': 'decisions',
+  'recap.md': 'recap',
+};
+
+/** Protected spec files and the approval gate that locks them */
+export const PROTECTED_SPEC_FILES = {
+  'schema-analysis.md': 'design',
+  'spec.md': 'design',
+  'contracts.cs': 'design',
+  'contracts.ts': 'design',
+  'contracts-vsa.cs': 'design',
+  'plan.md': 'plan',
+  'tasks.md': 'tasks',
+  'design-system.md': 'uiux',
+  'mockups.md': 'uiux',
+  'components.md': 'uiux',
+  'flows.md': 'uiux',
+};
+
+/**
+ * Extract feature name from a .morph/features/{feature}/... path
+ * @param {string} filePath - File path to analyze
+ * @returns {string|null} Feature name or null
+ */
+export function extractFeatureName(filePath) {
+  const normalized = filePath.replace(/\\/g, '/');
+  const match = normalized.match(/\.morph\/features\/([^/]+)\//);
+  return match ? match[1] : null;
+}
+
+/**
+ * Extract phase subdirectory from a .morph/features/{feature}/{phaseDir}/... path
+ * @param {string} filePath - File path to analyze
+ * @returns {string|null} Phase directory (e.g., '0-proposal', '1-design') or null
+ */
+export function extractPhaseDir(filePath) {
+  const normalized = filePath.replace(/\\/g, '/');
+  const match = normalized.match(/\.morph\/features\/[^/]+\/(\d+-[^/]+)\//);
+  return match ? match[1] : null;
+}
+
+/**
+ * Check if a file path is inside .morph/features/
+ * @param {string} filePath
+ * @returns {boolean}
+ */
+export function isFeaturePath(filePath) {
+  const normalized = filePath.replace(/\\/g, '/');
+  return normalized.includes('.morph/features/');
+}
+
+/**
+ * Check if a file path is inside .morph/framework/ (readonly)
+ * @param {string} filePath
+ * @returns {boolean}
+ */
+export function isFrameworkPath(filePath) {
+  const normalized = filePath.replace(/\\/g, '/');
+  return normalized.includes('.morph/framework/');
+}
+
+/**
+ * Check if a file path is state.json
+ * @param {string} filePath
+ * @returns {boolean}
+ */
+export function isStatePath(filePath) {
+  const normalized = filePath.replace(/\\/g, '/');
+  return normalized.endsWith('.morph/state.json');
+}
+
+/**
+ * Get the basename of a file path
+ * @param {string} filePath
+ * @returns {string}
+ */
+export function getBasename(filePath) {
+  const normalized = filePath.replace(/\\/g, '/');
+  return normalized.split('/').pop();
+}

package/framework/rules/csharp-standards.md

@@ -1,13 +1,13 @@
----
-paths:
-  - "**/*.cs"
-  - "**/*.csproj"
-stacks:
-  - dotnet
-  - blazor
----
-
-# C# and .NET Standards
-
-@.morph/framework/standards/core/coding.md
-@.morph/framework/standards/backend/dotnet/core.md
+---
+paths:
+  - "**/*.cs"
+  - "**/*.csproj"
+stacks:
+  - dotnet
+  - blazor
+---
+
+# C# and .NET Standards
+
+@.morph/framework/standards/core/coding.md
+@.morph/framework/standards/backend/dotnet/core.md

package/framework/rules/frontend-standards.md

@@ -1,13 +1,13 @@
----
-paths:
-  - "**/*.razor"
-  - "**/*.css"
-  - "**/*.scss"
-stacks:
-  - blazor
----
-
-# Frontend Standards
-
-@.morph/framework/standards/frontend/blazor/design-checklist.md
-@.morph/framework/standards/frontend/design-system/naming.md
+---
+paths:
+  - "**/*.razor"
+  - "**/*.css"
+  - "**/*.scss"
+stacks:
+  - blazor
+---
+
+# Frontend Standards
+
+@.morph/framework/standards/frontend/blazor/design-checklist.md
+@.morph/framework/standards/frontend/design-system/naming.md

package/framework/rules/infrastructure-standards.md

@@ -1,16 +1,16 @@
----
-paths:
-  - "**/*.bicep"
-  - "**/Dockerfile"
-  - "**/docker-compose*.yml"
-  - "**/pipelines/**"
-  - "**/.github/workflows/**"
-stacks:
-  - azure
-  - docker
----
-
-# Infrastructure Standards
-
-@.morph/framework/standards/infrastructure/azure/azure.md
-@.morph/framework/standards/infrastructure/docker/easypanel-deploy.md
+---
+paths:
+  - "**/*.bicep"
+  - "**/Dockerfile"
+  - "**/docker-compose*.yml"
+  - "**/pipelines/**"
+  - "**/.github/workflows/**"
+stacks:
+  - azure
+  - docker
+---
+
+# Infrastructure Standards
+
+@.morph/framework/standards/infrastructure/azure/azure.md
+@.morph/framework/standards/infrastructure/docker/easypanel-deploy.md

package/framework/rules/testing-standards.md

@@ -1,14 +1,14 @@
----
-paths:
-  - "tests/**"
-  - "**/*.test.*"
-  - "**/*.spec.*"
-  - "**/*Tests.cs"
-stacks:
-  - dotnet
-  - blazor
----
-
-# Testing Standards
-
-@.morph/framework/standards/core/testing.md
+---
+paths:
+  - "tests/**"
+  - "**/*.test.*"
+  - "**/*.spec.*"
+  - "**/*Tests.cs"
+stacks:
+  - dotnet
+  - blazor
+---
+
+# Testing Standards
+
+@.morph/framework/standards/core/testing.md

package/framework/skills/level-0-meta/morph-brainstorming/SKILL.md

@@ -22,12 +22,12 @@ allowed-tools: Read, Bash, Glob, Grep, AskUserQuestion
 
 | Action | Tool | Alternative |
 |--------|------|-------------|
-| Load feature state | **Bash** `npx morph-spec state get $ARGUMENTS` | — |
+| Load feature state | **Bash** `morph-spec state get $ARGUMENTS` | — |
 | Read project config | **Read** `.morph/config/config.json` | — |
 | Scan existing code | **Glob** / **Grep** | — |
 | Research libraries | **Context7 MCP** `query_docs()` | **WebSearch** |
 | Ask clarifying questions | **AskUserQuestion** (never plain text) | — |
-| Render proposal template | **Bash** `npx morph-spec template render docs/proposal ...` | — |
+| Render proposal template | **Bash** `morph-spec template render docs/proposal ...` | — |
 
 ---
 
@@ -49,11 +49,11 @@ Update each to `in_progress` before its step and `completed` after.
 
 Gather information before generating ideas. This step is what makes morph-aware brainstorming different from generic brainstorming — it grounds your thinking in the actual project state and constraints.
 
-1. **Read state** — `npx morph-spec state get $ARGUMENTS` → current phase, active agents, existing outputs, task history
+1. **Read state** — `morph-spec state get $ARGUMENTS` → current phase, active agents, existing outputs, task history
 2. **Read config** — `.morph/config/config.json` → stack, architecture style (VSA vs standard), project name, integrations
 3. **Check architecture** — `cat .morph/config/config.json | grep -A3 architecture` → determines which agents and patterns apply
 4. **Read existing outputs** — proposal.md, spec.md, decisions.md (if they exist from prior work)
-5. **Check active agents** — `npx morph-spec dispatch-agents $ARGUMENTS design --table` → which specialists are available
+5. **Check active agents** — `morph-spec dispatch-agents $ARGUMENTS design --table` → which specialists are available
 6. **Scan codebase** — use Glob/Grep to understand existing patterns, domain models, and service boundaries relevant to the feature
 7. **Check MCP tools** — if Context7, GitHub, or other MCPs are available, use them for research
 
@@ -106,7 +106,7 @@ For each approach, document:
 
    **Phase 0 (Proposal):**
    ```bash
-   npx morph-spec template render docs/proposal ".morph/features/$ARGUMENTS/0-proposal/proposal.md" '{"FEATURE_NAME":"...", "DATE":"..."}'
+   morph-spec template render docs/proposal ".morph/features/$ARGUMENTS/0-proposal/proposal.md" '{"FEATURE_NAME":"...", "DATE":"..."}'
    ```
    Then edit the rendered file to add the brainstorming results.
 
@@ -115,12 +115,12 @@ For each approach, document:
 
 3. **Update state** (mandatory — do not skip):
    ```bash
-   npx morph-spec state mark-output $ARGUMENTS proposal    # Phase 0
-   npx morph-spec state mark-output $ARGUMENTS decisions    # Phase 2
+   morph-spec state mark-output $ARGUMENTS proposal    # Phase 0
+   morph-spec state mark-output $ARGUMENTS decisions    # Phase 2
    ```
    Then verify the output was recorded:
    ```bash
-   npx morph-spec state get $ARGUMENTS
+   morph-spec state get $ARGUMENTS
    ```
 
 ---

package/framework/skills/level-0-meta/morph-checklist/SKILL.md

@@ -14,9 +14,9 @@ Types: `deploy`, `security`, `seo`, `performance`, `accessibility`, `legal-brazi
 ## Deploy
 
 ### MORPH-SPEC Validation (run first)
-- [ ] `npx morph-spec validate-feature {feature}` — passes with 100% pass rate
-- [ ] `npx morph-spec approval-status {feature}` — all gates approved (design, plan, tasks)
-- [ ] `npx morph-spec state get {feature}` — phase is `implement`, all tasks `done`
+- [ ] `morph-spec validate-feature {feature}` — passes with 100% pass rate
+- [ ] `morph-spec approval-status {feature}` — all gates approved (design, plan, tasks)
+- [ ] `morph-spec state get {feature}` — phase is `implement`, all tasks `done`
 - [ ] Recap generated: `.morph/features/{feature}/5-implement/recap.md` exists
 
 ### Pre-Deploy