@polymorphism-tech/morph-spec 4.8.4 → 4.8.6

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

package/claude-plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "morph-spec",
-  "version": "4.8.4",
+  "version": "4.8.6",
   "displayName": "MORPH-SPEC Framework",
   "description": "Spec-driven development with 38 agents and 8-phase workflow for .NET/Blazor/Next.js/Azure",
   "publisher": "polymorphism-tech",

package/docs/CHEATSHEET.md

@@ -200,4 +200,4 @@ These files are never edited directly. Use CLI commands or `morph-spec update` i
 
 ---
 
-*morph-spec v4.8.4 by Polymorphism Tech*
+*morph-spec v4.8.6 by Polymorphism Tech*

package/docs/QUICKSTART.md

@@ -203,4 +203,4 @@ morph-spec doctor
 
 ---
 
-*morph-spec v4.8.4 by Polymorphism Tech*
+*morph-spec v4.8.6 by Polymorphism Tech*

package/framework/hooks/dev/guard-version-numbers.js

@@ -7,7 +7,7 @@
  * Scope: Framework codebase only (dev hook)
  *
  * Blocks Write/Edit to files that contain hardcoded version patterns
- * like "MORPH-SPEC v4.8.4". Version should only be in package.json.
+ * like "MORPH-SPEC v4.8.6". Version should only be in package.json.
  *
  * Checked extensions: .md, .cs, .css, .js (covers templates + source)
  * Exceptions: CHANGELOG.md, node_modules/, test/, package.json, package-lock.json

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

@@ -14,12 +14,33 @@ allowed-tools: Read, Write, Edit, Bash, Glob, Grep
 
 # morph-init — LLM-Powered Project Initialization
 
-> Run once after `npm install -g @polymorphism-tech/morph-spec`.
+> Run once after `npm install @polymorphism-tech/morph-spec`.
 > Re-run as `/morph-init refresh` when your project evolves.
 
 ---
 
-## Step 0 — Required Plugins
+## Step 0 — Resolve CLI
+
+Before running any `morph-spec` command, detect how to invoke the CLI:
+
+```bash
+# Try local first (project dependency), then global
+npx morph-spec --version
+```
+
+- If `npx morph-spec --version` succeeds → use `npx morph-spec` as the CLI prefix for all commands.
+- If it fails → try `morph-spec --version` (global install). If that works → use `morph-spec`.
+- If both fail → **STOP** and show:
+  ```
+  morph-spec CLI not found. Install it first:
+    npm install @polymorphism-tech/morph-spec
+  ```
+
+Use the resolved CLI prefix (e.g. `npx morph-spec`) for ALL bash commands in the following steps.
+
+---
+
+## Step 1 — Required Plugins
 
 Check for required Claude Code plugins: **superpowers** and **context7**.
 
@@ -30,8 +51,8 @@ Read `~/.claude/plugins/installed_plugins.json` and check for:
 For each missing plugin, run:
 
 ```bash
-morph-spec install-plugin superpowers
-morph-spec install-plugin context7
+npx morph-spec install-plugin superpowers
+npx morph-spec install-plugin context7
 ```
 
 **If the command succeeds:** `✓ {plugin} installed. Restart Claude Code after /morph-init completes.`
@@ -53,25 +74,30 @@ Both `superpowers` and `context7` are required. Do not continue if either is mis
 
 ---
 
-## Step 1 — Infrastructure
+## Step 2 — Infrastructure
 
 Check if `.morph/` exists in the current directory.
 
 **If MISSING:**
 ```bash
-morph-spec setup-infra
+npx morph-spec setup-infra
 ```
 Output confirms: `✓ MORPH-SPEC infrastructure installed.`
 
-**If EXISTS and argument is `refresh`:** Continue — will overwrite context and config.
+**If EXISTS and argument is `refresh`:**
+Re-run setup-infra to update framework files, then continue with context/config refresh:
+```bash
+npx morph-spec setup-infra
+```
 
 **If EXISTS and no argument:**
 Ask: *"MORPH already initialized. Refresh context and config? (y/n)"*
+If `y` → re-run `npx morph-spec setup-infra` then continue.
 If `n` → STOP.
 
 ---
 
-## Step 2 — Analyze Project
+## Step 3 — Analyze Project
 
 Gather evidence to build a stack map. Run these in parallel:
 
@@ -104,7 +130,7 @@ backendPath:   src/backend (if monorepo)
 
 ---
 
-## Step 3 — Ask Targeted Questions
+## Step 4 — Ask Targeted Questions
 
 **Rule: only ask what cannot be inferred with ≥90% confidence from files.**
 
@@ -120,7 +146,7 @@ Do **not** ask about technology already confirmed by file evidence.
 
 ---
 
-## Step 4 — Generate `context/README.md`
+## Step 5 — Generate `context/README.md`
 
 Write `.morph/context/README.md`:
 
@@ -148,7 +174,7 @@ Write `.morph/context/README.md`:
 
 ---
 
-## Step 5 — Update `config.json`
+## Step 6 — Update `config.json`
 
 Read `.morph/config/config.json` and merge into `project`:
 
@@ -171,14 +197,14 @@ Read `.morph/config/config.json` and merge into `project`:
 
 ---
 
-## Step 6 — Configure MCPs
+## Step 7 — Configure MCPs
 
 For each detected integration with an available MCP:
 
 **Supabase detected:**
 > *"Configure Supabase MCP now? I'll need `SUPABASE_URL` and `SERVICE_ROLE_KEY`."*
 - YES → collect credentials → add to `.claude/settings.local.json` under `mcpServers`
-- NO → show snippet + `morph-spec mcp setup supabase`
+- NO → show snippet + `npx morph-spec mcp setup supabase`
 
 **GitHub:**
 > *"Configure GitHub MCP? I'll need a `GITHUB_PERSONAL_ACCESS_TOKEN`."*
@@ -188,7 +214,7 @@ Only offer Figma, Docker, Azure if explicitly detected in `.env.example`.
 
 ---
 
-## Step 7 — Final Output
+## Step 8 — Final Output
 
 Before printing the summary, check `~/.claude/settings.local.json` for `env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS`. If set to `"1"`, mark Agent Teams as enabled; otherwise show the warning.
 

package/framework/skills/level-1-workflows/phase-clarify/SKILL.md

@@ -4,7 +4,7 @@ description: MORPH-SPEC Phase 3 (Clarify). Reviews spec.md for ambiguities, gene
 argument-hint: "[feature-name]"
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep
-cliVersion: "4.8.4"
+cliVersion: "4.8.6"
 ---
 
 # MORPH Clarify - FASE 3

package/framework/skills/level-1-workflows/phase-codebase-analysis/SKILL.md

@@ -3,7 +3,7 @@ name: phase-codebase-analysis
 description: MORPH-SPEC Design sub-phase that analyzes existing codebase and database schema, producing schema-analysis.md with real column names, types, relationships, and field mismatches. Use at the start of Design phase before generating contracts.cs to prevent incorrect field names or types.
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep
-cliVersion: "4.8.4"
+cliVersion: "4.8.6"
 ---
 
 # MORPH Codebase Analysis - Sub-fase de DESIGN

package/framework/skills/level-1-workflows/phase-design/SKILL.md

@@ -4,7 +4,7 @@ description: MORPH-SPEC Phase 2 (Design). Analyzes codebase/schema, then produce
 argument-hint: "[feature-name]"
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep
-cliVersion: "4.8.4"
+cliVersion: "4.8.6"
 ---
 
 # MORPH Design - FASE 2

package/framework/skills/level-1-workflows/phase-implement/SKILL.md

@@ -6,7 +6,7 @@ disable-model-invocation: true
 context: fork
 agent: general-purpose
 user-invocable: false
-cliVersion: "4.8.4"
+cliVersion: "4.8.6"
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep
 ---
 

package/framework/skills/level-1-workflows/phase-setup/SKILL.md

@@ -4,7 +4,7 @@ description: MORPH-SPEC Phase 1 (Setup). Reads project context, detects tech sta
 argument-hint: "[feature-name]"
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep
-cliVersion: "4.8.4"
+cliVersion: "4.8.6"
 ---
 
 # MORPH Setup - FASE 1

package/framework/skills/level-1-workflows/phase-tasks/SKILL.md

@@ -5,7 +5,7 @@ argument-hint: "[feature-name]"
 disable-model-invocation: true
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep
-cliVersion: "4.8.4"
+cliVersion: "4.8.6"
 ---
 
 # MORPH Tasks - FASE 4

package/framework/skills/level-1-workflows/phase-uiux/SKILL.md

@@ -4,7 +4,7 @@ description: MORPH-SPEC Phase 1.5 (UI/UX). Creates design-system.md, mockups.md,
 argument-hint: "[feature-name]"
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep
-cliVersion: "4.8.4"
+cliVersion: "4.8.6"
 ---
 
 # MORPH UI/UX Design - FASE 1.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polymorphism-tech/morph-spec",
-  "version": "4.8.4",
+  "version": "4.8.6",
   "description": "MORPH-SPEC: AI-First development framework with validation pipeline and multi-stack support",
   "keywords": [
     "claude-code",

package/src/scripts/global-install.js

@@ -4,6 +4,7 @@ import { fileURLToPath } from 'url';
 import { homedir } from 'os';
 import { mkdir, copyFile } from 'fs/promises';
 import { existsSync } from 'fs';
+import { installGlobalStatusline } from '../utils/hooks-installer.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const FRAMEWORK_DIR = join(__dirname, '..', '..', 'framework');
@@ -28,7 +29,18 @@ export async function installGlobalSkill(claudeDir = join(homedir(), '.claude'))
 
 // Run as postinstall script
 if (process.argv[1] === fileURLToPath(import.meta.url)) {
-  installGlobalSkill()
-    .then(() => console.log('✓ morph-init skill installed to ~/.claude/skills/'))
-    .catch(e => console.warn('Could not install morph-init skill globally:', e.message));
+  const HOOKS_SRC = join(FRAMEWORK_DIR, 'hooks', 'claude-code');
+
+  await Promise.allSettled([
+    installGlobalSkill()
+      .then(() => console.log('✓ morph-init skill installed to ~/.claude/skills/')),
+    installGlobalStatusline(HOOKS_SRC)
+      .then(() => console.log('✓ statusline installed to ~/.claude/')),
+  ]).then(results => {
+    for (const r of results) {
+      if (r.status === 'rejected') {
+        console.warn('  postinstall warning:', r.reason?.message || r.reason);
+      }
+    }
+  });
 }