@polymorphism-tech/morph-spec 4.21.0 → 5.0.1

package/framework/templates/CLAUDE.md.core.template

@@ -0,0 +1,22 @@
+# [Nome do Projeto]
+
+[1-2 frases sobre o domínio do sistema, quem usa, qual o principal constraint.]
+
+## Stack
+
+VSA + .NET 10 + EF Core + Neon (Postgres) + Microsoft Agent Framework + Next.js (App Router) + Tailwind + Framer Motion + Shadcn + Hangfire (quando necessário).
+
+Padrões proibidos por padrão: `Guid.NewGuid()` (use `Guid.CreateVersion7()`), classes não-sealed sem justificativa, exceptions como fluxo de controle, Repository pattern.
+
+## Harness
+
+morph-spec NLH — leia `.morph/framework/MORPH.md` ao iniciar cada sessão. Em seguida, leia `.morph/state.json` para identificar a feature ativa e a fase atual; assuma o papel correspondente (Orchestrator/Specialist/Evaluator) e continue o trabalho.
+
+## Standards do projeto
+
+[Liste de 3 a 6 IDs de `.morph/framework/standards/STANDARDS.json` específicos deste projeto, se algum desviar do default. Caso contrário, deixe vazio — os defaults do stack já são aplicados pelo morph-plan.]
+
+## Slash commands
+
+- `/morph-proposal {feature}` — entendimento de negócio + spec/mandate/tasks (Gates 1 e 2)
+- `/morph-apply {feature}` — execução autônoma das tarefas + review (Gate 3)

package/framework/templates/REGISTRY.json

@@ -50,7 +50,7 @@
       "path": "docs/spec.md",
       "location": "framework",
       "category": "documentation",
-      "phase": "design",
+      "phase": "plan",
       "required": true,
       "description": "Detailed technical spec with architecture, data model, API contracts",
       "outputName": "spec.md",
@@ -70,7 +70,7 @@
       "path": "feature/tasks.md",
       "location": "framework",
       "category": "documentation",
-      "phase": "tasks",
+      "phase": "plan",
       "required": true,
       "description": "Task breakdown with IDs, dependencies, estimates, and checkpoints",
       "outputName": "tasks.md",
@@ -89,7 +89,7 @@
       "path": "feature/decisions.md",
       "location": "framework",
       "category": "documentation",
-      "phase": "design",
+      "phase": "plan",
       "required": true,
       "description": "ADR format for documenting architectural decisions with context, alternatives, consequences",
       "outputName": "decisions.md",
@@ -109,7 +109,7 @@
       "path": "feature/recap.md",
       "location": "framework",
       "category": "documentation",
-      "phase": "completed",
+      "phase": "implement",
       "required": true,
       "description": "Post-implementation summary with deliverables, metrics, lessons learned",
       "outputName": "recap.md",

package/framework/workflows/configs/fast-track.json

@@ -31,21 +31,16 @@
     "tooltip"
   ],
   "phases": {
-    "run": ["proposal", "tasks", "implement"],
-    "skip": ["uiux", "design", "plan", "sync"],
+    "run": ["proposal", "implement"],
+    "skip": ["uiux", "plan", "review", "sync"],
     "skipIfCondition": {},
     "combined": {}
   },
-  "pausePoints": [
-    {
-      "phase": "tasks",
-      "question": "Approve task breakdown?"
-    }
-  ],
+  "pausePoints": [],
   "outputs": {
-    "required": ["proposal.md", "tasks.md"],
+    "required": ["proposal.md"],
     "optional": ["recap.md"],
-    "skip": ["spec.md", "contracts.cs", "contracts.ts", "plan.md", "design-system.md", "schema-analysis.md"]
+    "skip": ["spec.md", "contracts.cs", "contracts.ts", "plan.md", "tasks.md", "mandate.md", "design-system.md", "schema-analysis.md"]
   },
   "priority": 1
 }

package/framework/workflows/configs/full.json

@@ -29,7 +29,7 @@
     "integração"
   ],
   "phases": {
-    "run": ["proposal", "uiux", "design", "plan", "tasks", "implement", "sync"],
+    "run": ["proposal", "uiux", "plan", "implement", "review", "sync"],
     "skip": [],
     "skipIfCondition": {
       "uiux": "!hasUIAgents"
@@ -46,17 +46,13 @@
       "question": "Approve UI/UX designs?",
       "condition": "hasUIAgents"
     },
-    {
-      "phase": "design",
-      "question": "Approve technical specification?"
-    },
     {
       "phase": "plan",
-      "question": "Approve implementation plan?"
+      "question": "Approve spec, plan, and task breakdown?"
     },
     {
-      "phase": "tasks",
-      "question": "Approve task breakdown?"
+      "phase": "review",
+      "question": "Approve for merge/PR?"
     }
   ],
   "outputs": {

package/framework/workflows/configs/quick.json

@@ -0,0 +1,32 @@
+{
+  "id": "quick",
+  "name": "Quick (Single-Shot)",
+  "description": "Single-shot for trivial changes — skips all ceremony. Typo fixes, config changes, small bug fixes.",
+  "priority": 0,
+  "criteria": {
+    "maxFiles": 2,
+    "maxLines": 20,
+    "maxComponents": 0,
+    "noInfrastructure": true
+  },
+  "keywords": [
+    "fix", "typo", "rename", "update", "change", "add", "remove",
+    "bump", "config", "label", "text", "string", "color", "css",
+    "toggle", "flag", "icon", "badge", "tooltip", "placeholder"
+  ],
+  "phases": {
+    "run": ["proposal", "implement"],
+    "skip": ["uiux", "plan", "review", "sync"],
+    "skipIfCondition": {},
+    "combined": {}
+  },
+  "pausePoints": [],
+  "outputs": {
+    "required": ["proposal.md"],
+    "optional": [],
+    "skip": ["spec.md", "contracts.cs", "contracts.ts", "plan.md", "tasks.md", "mandate.md", "design-system.md", "schema-analysis.md", "review-report.md"]
+  },
+  "gates": {
+    "autoApproveAll": true
+  }
+}

package/framework/workflows/configs/standard.json

@@ -1,64 +1,57 @@
-{
-  "id": "standard",
-  "name": "Standard (Medium Complexity)",
-  "description": "Medium complexity features - 3-10 files, tactical decisions",
-  "criteria": {
-    "minFiles": 3,
-    "maxFiles": 10,
-    "minLines": 50,
-    "maxLines": 500,
-    "maxComponents": 2,
-    "noInfrastructure": true,
-    "tacticalDecisions": true
-  },
-  "keywords": [
-    "paginação",
-    "pagination",
-    "paginate",
-    "filtro",
-    "filter",
-    "filtering",
-    "refatorar",
-    "refactor",
-    "performance",
-    "exportar",
-    "export",
-    "optimize",
-    "sorting",
-    "search",
-    "busca"
-  ],
-  "phases": {
-    "run": ["proposal", "design", "plan", "tasks", "implement", "sync"],
-    "skip": [],
-    "skipIfCondition": {
-      "uiux": "!hasUIAgents"
-    },
-    "combined": {}
-  },
-  "pausePoints": [
-    {
-      "phase": "proposal",
-      "question": "Approve feature proposal?"
-    },
-    {
-      "phase": "design",
-      "question": "Approve spec (concise, 1-2 pages)?"
-    },
-    {
-      "phase": "plan",
-      "question": "Approve implementation plan?"
-    },
-    {
-      "phase": "tasks",
-      "question": "Approve task breakdown?",
-      "condition": "taskCount > 5"
-    }
-  ],
-  "outputs": {
-    "required": ["proposal.md", "spec.md", "plan.md", "recap.md"],
-    "optional": ["decisions.md"],
-    "skip": ["contracts.cs"]
-  },
-  "priority": 2
-}
+{
+  "id": "standard",
+  "name": "Standard (Medium Complexity)",
+  "description": "Medium complexity features - 3-10 files, tactical decisions",
+  "criteria": {
+    "minFiles": 3,
+    "maxFiles": 10,
+    "minLines": 50,
+    "maxLines": 500,
+    "maxComponents": 2,
+    "noInfrastructure": true,
+    "tacticalDecisions": true
+  },
+  "keywords": [
+    "paginação",
+    "pagination",
+    "paginate",
+    "filtro",
+    "filter",
+    "filtering",
+    "refatorar",
+    "refactor",
+    "performance",
+    "exportar",
+    "export",
+    "optimize",
+    "sorting",
+    "search",
+    "busca"
+  ],
+  "phases": {
+    "run": ["proposal", "plan", "implement", "review", "sync"],
+    "skip": ["uiux"],
+    "skipIfCondition": {},
+    "combined": {}
+  },
+  "pausePoints": [
+    {
+      "phase": "proposal",
+      "question": "Approve feature proposal?"
+    },
+    {
+      "phase": "plan",
+      "question": "Approve plan and task breakdown?"
+    },
+    {
+      "phase": "review",
+      "question": "Approve for merge/PR?"
+    }
+  ],
+  "outputs": {
+    "required": ["proposal.md", "spec.md", "plan.md", "recap.md"],
+    "optional": ["decisions.md"],
+    "skip": ["contracts.cs"]
+  },
+  "priority": 2
+}

package/package.json

@@ -1,23 +1,24 @@
 {
   "name": "@polymorphism-tech/morph-spec",
-  "version": "4.21.0",
-  "description": "MORPH-SPEC: AI-First development framework with validation pipeline and multi-stack support",
+  "version": "5.0.1",
+  "description": "MORPH-SPEC: NLH (Natural Language Harness) for spec-driven development with Claude Code",
   "keywords": [
     "claude-code",
     "claude",
     "ai-coding",
     "ai-first",
     "spec-driven",
+    "nlh",
+    "natural-language-harness",
+    "autonomy",
     "dotnet",
     "dotnet10",
     "nextjs",
-    "agent-framework",
     "vsa",
+    "vertical-slice",
     "framework",
-    "developer-tools",
     "morph",
-    "polymorphism",
-    "micro-saas"
+    "polymorphism"
   ],
   "main": "src/index.js",
   "bin": {

package/src/commands/mcp/mcp-setup.js

@@ -25,11 +25,11 @@ import {
   loadMcpRegistry,
   isRemoteMcp,
   generateStitchProxy,
-  patchConfigForPlatform
+  patchConfigForPlatform,
+  setupStitch
 } from '../../lib/installers/mcp-installer.js';
 import { detectClaudeConfig } from '../../lib/detectors/claude-config-detector.js';
 import { detectProject } from '../../lib/detectors/index.js';
-import { installMcpServers } from '../../utils/claude-settings-manager.js';
 
 /**
  * Detect the current project's stack.
@@ -207,35 +207,58 @@ async function setupSpecificMcp(targetPath, name, stack, existingMcps) {
 
   const credentials = mcpEntry.install.credentials || [];
 
-  // Stitch MCP — custom OAuth proxy setup
+  // Stitch MCP — automated setup via setupStitch()
   if (name === 'stitch' && !mcpEntry.install.autoInstall) {
-    console.log(chalk.cyan(`\n  Setting up Stitch MCP (OAuth proxy)\n`));
+    console.log(chalk.cyan(`\n  Setting up Stitch MCP (automated)\n`));
     console.log(chalk.gray(`  Usage: ${mcpEntry.usage}`));
     console.log('');
 
+    // Allow user to provide GCP project if auto-detection might fail
+    let gcpProject;
     const gcpCred = credentials.find(c => c.envVar === 'STITCH_GCP_PROJECT');
-    const { gcpProject } = await inquirer.prompt([{
+    const { gcpProjectInput } = await inquirer.prompt([{
       type: 'input',
-      name: 'gcpProject',
-      message: gcpCred ? `${gcpCred.name}:` : 'GCP Project ID:',
+      name: 'gcpProjectInput',
+      message: gcpCred ? `${gcpCred.name} (leave blank for auto-detect):` : 'GCP Project ID (blank for auto-detect):',
     }]);
-
-    if (!gcpProject || !gcpProject.trim()) {
-      console.log(chalk.red('  GCP Project ID is required.'));
-      console.log('');
-      return;
+    if (gcpProjectInput?.trim()) gcpProject = gcpProjectInput.trim();
+
+    const spinner = ora('Setting up Stitch MCP...').start();
+    const result = await setupStitch(targetPath, { gcpProject });
+
+    // Report step-by-step results
+    for (const step of result.steps) {
+      if (step.success) {
+        switch (step.step) {
+          case 'find-gcloud': spinner.text = `gcloud found (${step.source})`; break;
+          case 'verify-adc': spinner.text = 'ADC credentials verified'; break;
+          case 'detect-project': spinner.text = `GCP project: ${step.gcpProject}`; break;
+          case 'enable-api': spinner.text = 'Stitch API enabled'; break;
+          case 'generate-proxy': spinner.text = `Proxy generated: ${step.proxyPath}`; break;
+          case 'install-mcp': spinner.text = 'MCP config installed in .mcp.json'; break;
+          case 'health-check': spinner.text = `Health-check passed (protocol ${step.protocolVersion})`; break;
+        }
+      }
     }
 
-    const spinner = ora('Generating Stitch proxy...').start();
-    const { proxyPath } = generateStitchProxy(targetPath, gcpProject.trim());
-    spinner.succeed(`Proxy script generated: ${proxyPath}`);
-
-    const config = { ...mcpEntry.install.config };
-    const result = await installMcpServers(targetPath, { stitch: patchConfigForPlatform(config) });
-    if (result.added.length > 0) {
-      console.log(chalk.green(`  ✓ Stitch MCP configured (using OAuth proxy)`));
+    if (result.success) {
+      spinner.succeed('Stitch MCP setup complete');
+      for (const step of result.steps) {
+        if (step.step === 'health-check' && step.success) {
+          console.log(chalk.green(`  ✓ Health-check passed (protocol ${step.protocolVersion})`));
+        }
+      }
     } else {
-      console.log(chalk.yellow(`  ⚠ Stitch MCP already configured`));
+      const failedStep = result.steps.find(s => !s.success && s.step !== 'enable-api' && s.step !== 'health-check');
+      spinner.fail(`Stitch setup failed at: ${failedStep?.step || 'unknown'}`);
+      if (failedStep?.error) {
+        console.log(chalk.red(`  ${failedStep.error}`));
+      }
+      // Show health-check warning if it failed but setup otherwise succeeded
+      const healthStep = result.steps.find(s => s.step === 'health-check');
+      if (healthStep && !healthStep.success) {
+        console.log(chalk.yellow(`  ⚠ Health-check: ${healthStep.error}`));
+      }
     }
 
     if (mcpEntry.companionSkills?.installCommand) {
@@ -292,7 +315,7 @@ async function setupSpecificMcp(targetPath, name, stack, existingMcps) {
     const { installNow } = await inquirer.prompt([{
       type: 'confirm',
       name: 'installNow',
-      message: 'Add to .claude/settings.local.json now?',
+      message: 'Add to .mcp.json now?',
       default: true
     }]);
 
@@ -345,7 +368,7 @@ async function setupSpecificMcp(targetPath, name, stack, existingMcps) {
   } else {
     // Show config snippet
     const instructions = generateSetupInstructions(name, mcpEntry);
-    console.log(chalk.gray('\n  Add to .claude/settings.local.json → mcpServers:'));
+    console.log(chalk.gray('\n  Add to .mcp.json → mcpServers:'));
     console.log(chalk.gray('  ' + '─'.repeat(55)));
     for (const line of instructions.configSnippet.split('\n')) {
       console.log(chalk.gray(`  ${line}`));
@@ -424,20 +447,24 @@ async function interactiveWizard(targetPath, stack, existingMcps) {
       }]);
 
       if (setupNow) {
-        // Stitch — custom OAuth proxy flow
+        // Stitch — automated setup via setupStitch()
         if (name === 'stitch' && !entry.install.autoInstall) {
           const gcpCred = entry.install.credentials?.find(c => c.envVar === 'STITCH_GCP_PROJECT');
           const { gcpProject } = await inquirer.prompt([{
             type: 'input',
             name: 'gcpProject',
-            message: gcpCred ? `${gcpCred.name}:` : 'GCP Project ID:',
+            message: gcpCred ? `${gcpCred.name} (blank for auto-detect):` : 'GCP Project ID (blank for auto-detect):',
           }]);
-          if (gcpProject?.trim()) {
-            const { proxyPath } = generateStitchProxy(targetPath, gcpProject.trim());
-            console.log(chalk.green(`  ✓ Proxy generated: ${proxyPath}`));
-            const config = { ...entry.install.config };
-            await installMcpServers(targetPath, { stitch: patchConfigForPlatform(config) });
-            console.log(chalk.green(`  ✓ Stitch configured (OAuth proxy)`));
+
+          const stitchSpinner = ora('Setting up Stitch MCP...').start();
+          const stitchResult = await setupStitch(targetPath, { gcpProject: gcpProject?.trim() || undefined });
+          if (stitchResult.success) {
+            stitchSpinner.succeed('Stitch MCP setup complete');
+          } else {
+            const failedStep = stitchResult.steps.find(s => !s.success && s.step !== 'enable-api' && s.step !== 'health-check');
+            stitchSpinner.fail(`Stitch setup failed: ${failedStep?.error || 'unknown'}`);
+          }
+          if (entry.companionSkills?.installCommand) {
             const skillResults = installCompanionSkills({ stitch: entry });
             for (const r of skillResults) {
               if (r.success) console.log(chalk.green(`  ✓ Companion skills: ${r.repo}`));