@polymorphism-tech/morph-spec 4.10.9 → 4.11.0

package/CLAUDE.md

@@ -1,3 +1,3 @@
-# Project
-
-@.claude/CLAUDE.md
+# Project
+
+@.claude/CLAUDE.md

package/LICENSE

@@ -1,71 +1,71 @@
-Proprietary License
-
-Copyright (c) 2024-2025 Polymorphism Tech
-All rights reserved.
-
-MORPH-SPEC Framework - Proprietary Software License
-
-1. GRANT OF LICENSE
-
-Subject to the terms and conditions of this License, Polymorphism Tech ("Licensor")
-grants you a limited, non-exclusive, non-transferable license to:
-
-a) Install and use the MORPH-SPEC CLI tool for personal or commercial projects
-b) Use the generated templates and code in your own projects
-c) Modify generated code for your specific use cases
-
-2. RESTRICTIONS
-
-You may NOT:
-
-a) Redistribute, sell, lease, or sublicense the MORPH-SPEC framework itself
-b) Modify, decompile, reverse engineer, or create derivative works of the framework
-c) Remove or modify any copyright notices or proprietary markings
-d) Use the framework to create competing products or services
-e) Publicly fork or redistribute the source code
-f) Share access credentials to private repositories
-
-3. OWNERSHIP
-
-The MORPH-SPEC framework, including all code, documentation, templates, and
-associated materials, remains the exclusive property of Polymorphism Tech.
-
-4. GENERATED CODE
-
-Code and projects generated using MORPH-SPEC are yours to use, modify, and
-distribute as you see fit, including commercial use.
-
-5. SUPPORT AND UPDATES
-
-- CLI tool updates are provided via npm registry
-- Support is available at: support@polymorphism.tech
-- Documentation updates are included with each release
-
-6. WARRANTY DISCLAIMER
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-
-7. LIMITATION OF LIABILITY
-
-IN NO EVENT SHALL POLYMORPHISM TECH BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
-8. TERMINATION
-
-This license is effective until terminated. Your rights under this license will
-terminate automatically without notice if you fail to comply with any term of
-this license.
-
-9. CONTACT
-
-For licensing inquiries, custom licenses, or commercial support:
-Email: contact@polymorphism.com.br
-Website: https://polymorphism.com.br
-
----
-
-MORPH-SPEC by Polymorphism Tech
+Proprietary License
+
+Copyright (c) 2024-2025 Polymorphism Tech
+All rights reserved.
+
+MORPH-SPEC Framework - Proprietary Software License
+
+1. GRANT OF LICENSE
+
+Subject to the terms and conditions of this License, Polymorphism Tech ("Licensor")
+grants you a limited, non-exclusive, non-transferable license to:
+
+a) Install and use the MORPH-SPEC CLI tool for personal or commercial projects
+b) Use the generated templates and code in your own projects
+c) Modify generated code for your specific use cases
+
+2. RESTRICTIONS
+
+You may NOT:
+
+a) Redistribute, sell, lease, or sublicense the MORPH-SPEC framework itself
+b) Modify, decompile, reverse engineer, or create derivative works of the framework
+c) Remove or modify any copyright notices or proprietary markings
+d) Use the framework to create competing products or services
+e) Publicly fork or redistribute the source code
+f) Share access credentials to private repositories
+
+3. OWNERSHIP
+
+The MORPH-SPEC framework, including all code, documentation, templates, and
+associated materials, remains the exclusive property of Polymorphism Tech.
+
+4. GENERATED CODE
+
+Code and projects generated using MORPH-SPEC are yours to use, modify, and
+distribute as you see fit, including commercial use.
+
+5. SUPPORT AND UPDATES
+
+- CLI tool updates are provided via npm registry
+- Support is available at: support@polymorphism.tech
+- Documentation updates are included with each release
+
+6. WARRANTY DISCLAIMER
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+
+7. LIMITATION OF LIABILITY
+
+IN NO EVENT SHALL POLYMORPHISM TECH BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+8. TERMINATION
+
+This license is effective until terminated. Your rights under this license will
+terminate automatically without notice if you fail to comply with any term of
+this license.
+
+9. CONTACT
+
+For licensing inquiries, custom licenses, or commercial support:
+Email: contact@polymorphism.com.br
+Website: https://polymorphism.com.br
+
+---
+
+MORPH-SPEC by Polymorphism Tech

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.10.9  
+**Version:** 4.11.0  
 **Requires:** Node.js 18+, Claude Code
 
 ---
@@ -312,17 +312,11 @@ After updating, run `morph-spec doctor` to confirm the installation is healthy.
 
 ### `morph-spec: command not found`
 
-If you are using nvm-windows or a Node version manager, the global bin path may not be on `PATH` in your shell. Use `npx` instead:
-
-```bash
-npx @polymorphism-tech/morph-spec init
-```
-
-Or add the npm global bin to your PATH:
+The installer automatically adds the npm global directory to your PowerShell `$PROFILE`. Open a **new terminal** after installing. If it still doesn't work, add it manually:
 
 ```bash
 npm config get prefix
-# Add {prefix}/bin to your PATH
+# Add {prefix} to your PATH
 ```
 
 ### `morph-spec doctor` reports issues
@@ -354,7 +348,7 @@ npm config set prefix %APPDATA%\npm-global
 npm install -g @polymorphism-tech/morph-spec
 ```
 
-1. Use `npx` for all CLI invocations
+1. Open a new terminal (the installer adds npm to your PATH automatically)
 
 ### Hook not triggering on SessionStart
 
@@ -376,4 +370,4 @@ Code generated by morph-spec (contracts, templates, implementation output) belon
 
 ---
 
-*morph-spec v4.10.9 by [Polymorphism Tech](https://polymorphism.tech)*
+*morph-spec v4.11.0 by [Polymorphism Tech](https://polymorphism.tech)*

package/bin/morph-spec.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 import { program } from 'commander';
 import chalk from 'chalk';
@@ -56,6 +56,12 @@ import { mcpSetupCommand } from '../src/commands/mcp/mcp-setup.js';
 // Trust commands
 import { trustStatusCommand, trustSetCommand } from '../src/commands/trust/trust.js';
 
+// Project metrics
+import { projectMetricsCommand } from '../src/commands/agents/project-metrics.js';
+
+// Standards context budget
+import { contextBudgetCommand } from '../src/commands/standards/context-budget.js';
+
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'));
 
@@ -406,4 +412,20 @@ agentCommand
   .option('--force', 'Skip confirmation prompt')
   .action((id, options) => agentRemoveCommand(id, options));
 
+// Project-level metrics
+program
+  .command('project-metrics')
+  .description('Aggregate project-level metrics from state.json')
+  .option('--json', 'Output as JSON')
+  .option('--save', 'Save metrics to .morph/metrics.json')
+  .action((options) => projectMetricsCommand(options));
+
+// Standards context budget
+program
+  .command('context-budget')
+  .description('Show estimated token usage for agent standards briefings')
+  .option('--phase <phase>', 'Phase to compute (default: implement)')
+  .option('--json', 'Output as JSON')
+  .action((options) => contextBudgetCommand(options));
+
 program.parse();

package/bin/task-manager.js

@@ -408,7 +408,7 @@ class TaskManager {
       // This is fail-open by design: a broken validator shouldn't block commits.
       // Common cause: missing optional deps.
       console.log(chalk.yellow(`\n⚠️  Validation skipped (${error.message})`));
-      console.log(chalk.gray(`   Run manually: npx morph-spec validate-feature ${featureName}`));
+      console.log(chalk.gray(`   Run manually: morph-spec validate-feature ${featureName}`));
       return { passed: true, validators: {}, passRate: 1.0 };
     }
   }
@@ -850,7 +850,7 @@ async function main() {
         const taskIds = filteredArgs.slice(2);
 
         if (!featureName || taskIds.length === 0) {
-          console.error(chalk.red('Usage: npx morph-spec task done <feature> <task-id> [task-id...] [--skip-validation] [--dry-run]'));
+          console.error(chalk.red('Usage: morph-spec task done <feature> <task-id> [task-id...] [--skip-validation] [--dry-run]'));
           process.exit(1);
         }
 
@@ -870,7 +870,7 @@ async function main() {
         const rangeArg = filteredArgs[2]; // e.g. T001..T082
 
         if (!featureName) {
-          console.error(chalk.red('Usage: npx morph-spec task bulk-done <feature> [--all | --from T001 --to T053 | T001..T082] [--skip-validation] [--dry-run]'));
+          console.error(chalk.red('Usage: morph-spec task bulk-done <feature> [--all | --from T001 --to T053 | T001..T082] [--skip-validation] [--dry-run]'));
           process.exit(1);
         }
 
@@ -886,7 +886,7 @@ async function main() {
         const taskId = args[2];
 
         if (!featureName || !taskId) {
-          console.error(chalk.red('Usage: npx morph-spec task start <feature> <task-id>'));
+          console.error(chalk.red('Usage: morph-spec task start <feature> <task-id>'));
           process.exit(1);
         }
 
@@ -898,7 +898,7 @@ async function main() {
         const featureName = args[1];
 
         if (!featureName) {
-          console.error(chalk.red('Usage: npx morph-spec task next <feature>'));
+          console.error(chalk.red('Usage: morph-spec task next <feature>'));
           process.exit(1);
         }
 

package/claude-plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "morph-spec",
-  "version": "4.10.9",
+  "version": "4.11.0",
   "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

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

package/docs/QUICKSTART.md

@@ -6,13 +6,7 @@
 npm install -g @polymorphism-tech/morph-spec
 ```
 
-Or use `npx` without a global install:
-
-```bash
-npx @polymorphism-tech/morph-spec init
-```
-
-> **Windows / nvm-windows:** Global installs may not appear on PATH. Use `npx` or add the npm prefix to PATH manually: `npm config get prefix`, then add `{prefix}` to your PATH.
+> The installer automatically configures your PowerShell PATH on Windows. If `morph-spec` is not found, open a new terminal window.
 
 ---
 
@@ -203,4 +197,4 @@ morph-spec doctor
 
 ---
 
-*morph-spec v4.10.9 by Polymorphism Tech*
+*morph-spec v4.11.0 by Polymorphism Tech*

package/framework/agents/README.md

@@ -1,14 +1,14 @@
-# Level 2: Domains
-
-Domain expertise skills organized by squad.
-
-**Purpose:** Skills that provide deep domain knowledge (backend, frontend, infra, quality, ai-agents, integrations).
-
-**Squads:**
-- backend/ - Backend Squad (led by dotnet-senior)
-- frontend/ - Frontend Squad (led by ui-designer)
-- infrastructure/ - Infrastructure Squad (led by infra-architect)
-- quality/ - Quality Squad (coordinated by standards-architect)
-- ai-agents/ - AI/Agent specialists
-- integrations/ - External integration specialists
-- architecture/ - Architecture and planning
+# Level 2: Domains
+
+Domain expertise skills organized by squad.
+
+**Purpose:** Skills that provide deep domain knowledge (backend, frontend, infra, quality, ai-agents, integrations).
+
+**Squads:**
+- backend/ - Backend Squad (led by dotnet-senior)
+- frontend/ - Frontend Squad (led by ui-designer)
+- infrastructure/ - Infrastructure Squad (led by infra-architect)
+- quality/ - Quality Squad (coordinated by standards-architect)
+- ai-agents/ - AI/Agent specialists
+- integrations/ - External integration specialists
+- architecture/ - Architecture and planning