@polymorphism-tech/morph-spec 4.10.6 → 4.10.8

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/hooks/shared/worktree-helpers.js

@@ -29,6 +29,7 @@ export function parseWorktreeResult(stdout) {
 
 /**
  * Build context line(s) to inject based on worktree setup result.
+ * Outputs MANDATORY instructions for Claude to work inside the worktree.
  * @param {Object|null} result - Parsed result from parseWorktreeResult
  * @returns {string} Context lines to inject, or '' to skip injection
  */
@@ -36,18 +37,39 @@ export function buildWorktreeContextLine(result) {
   if (!result) return '';
   if (result.error) return '';
 
-  if (result.created) {
-    return `🪴 Worktree created: Working in .worktrees/${result.feature || ''} on branch ${result.branch}`;
-  }
+  const path = result.path;
+  const feature = result.feature || '';
 
-  if (result.alreadyExists) {
+  if (result.created || result.alreadyExists) {
     return [
-      `⚠️  Existing worktree found for feature '${result.feature}': ${result.path} (branch: ${result.branch})`,
-      `   Use AskUserQuestion to ask: "resume existing worktree or start fresh (--fresh)?"`,
-      `   • Resume: continue in existing worktree (no change)`,
-      `   • Fresh: run \`morph-spec worktree setup ${result.feature} --fresh\``
+      `🪴 WORKTREE ACTIVE — branch: ${result.branch}`,
+      `   WORKTREE_PATH: ${path}`,
+      `   MANDATORY: ALL work for feature '${feature}' MUST happen inside the worktree:`,
+      `   • Bash: run \`cd ${path}\` first (CWD persists for subsequent commands)`,
+      `   • Read/Write/Edit: use ${path} as base for ALL file paths`,
+      `   • Glob/Grep: set path parameter to ${path}`,
+      `   DO NOT write files to the main project directory.`,
     ].join('\n');
   }
 
   return '';
 }
+
+/**
+ * Build worktree context from state metadata (for resume sessions).
+ * @param {Object} worktreeMeta - { path, branch } from state.features[name].worktree
+ * @param {string} featureName - Feature name
+ * @returns {string} Context lines or ''
+ */
+export function buildWorktreeResumeContext(worktreeMeta, featureName) {
+  if (!worktreeMeta?.path) return '';
+  return [
+    `🪴 WORKTREE ACTIVE — branch: ${worktreeMeta.branch}`,
+    `   WORKTREE_PATH: ${worktreeMeta.path}`,
+    `   MANDATORY: ALL work for feature '${featureName}' MUST happen inside the worktree:`,
+    `   • Bash: run \`cd ${worktreeMeta.path}\` first (CWD persists for subsequent commands)`,
+    `   • Read/Write/Edit: use ${worktreeMeta.path} as base for ALL file paths`,
+    `   • Glob/Grep: set path parameter to ${worktreeMeta.path}`,
+    `   DO NOT write files to the main project directory.`,
+  ].join('\n');
+}

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/README.md

@@ -17,7 +17,6 @@ Each skill is a directory: `{name}/SKILL.md` + optional `scripts/`, `references/
 | `verification-before-completion` | Gate check before marking any work done |
 | `code-review` | .NET/C# review checklist (naming, arch, async, DI, DTOs) |
 | `morph-replicate` | Convert HTML prototypes to Blazor components |
-| `terminal-title` | Manually override the terminal window title for the current task |
 
 ### level-0-meta extras
 

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

@@ -33,6 +33,18 @@ allowed-tools: Read, Bash, Glob, Grep, AskUserQuestion
 
 ## Workflow
 
+### Step 0: Create session tasks
+
+```
+TaskCreate: "Explore project context"   → activeForm: "Exploring context"
+TaskCreate: "Ask clarifying questions"  → activeForm: "Asking questions"
+TaskCreate: "Propose 2-3 approaches"    → activeForm: "Analyzing approaches"
+TaskCreate: "Present design"            → activeForm: "Presenting design"
+TaskCreate: "Document recommendation"   → activeForm: "Documenting"
+```
+
+Update each to `in_progress` before its step and `completed` after.
+
 ### Step 1: Explore Context
 
 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.