@polymorphism-tech/morph-spec 7.7.1 → 7.7.3

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:** 7.7.1  
+**Version:** 7.7.3  
 **Requires:** Node.js 22+, Claude Code
 
 ---
@@ -365,4 +365,4 @@ Code generated by morph-spec (contracts, templates, implementation output) belon
 
 ---
 
-*morph-spec v7.7.1 by [Polymorphism Tech](https://polymorphism.tech)*
+*morph-spec v7.7.3 by [Polymorphism Tech](https://polymorphism.tech)*

package/bin/morph-spec.js

@@ -14,6 +14,7 @@ import chalk from 'chalk';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
 import { readFileSync } from 'fs';
+import { renderLogo } from '../src/utils/banner.js';
 
 // === Project / install ===
 import { initCommand } from '../src/commands/project/init.js';
@@ -52,17 +53,9 @@ import { dashboardCommand } from '../src/commands/dashboard/dashboard.js';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'));
 
-const banner = chalk.cyan(`
-  ███╗   ███╗ ██████╗ ██████╗ ██████╗ ██╗  ██╗
-  ████╗ ████║██╔═══██╗██╔══██╗██╔══██╗██║  ██║
-  ██╔████╔██║██║   ██║██████╔╝██████╔╝███████║
-  ██║╚██╔╝██║██║   ██║██╔══██╗██╔═══╝ ██╔══██║
-  ██║ ╚═╝ ██║╚██████╔╝██║  ██║██║     ██║  ██║
-  ╚═╝     ╚═╝ ╚═════╝ ╚═╝  ╚═╝╚═╝     ╚═╝  ╚═╝
-
-  Spec-driven development harness for Claude Code
-  by Polymorphism Tech | v${pkg.version}
-`);
+const banner = `${renderLogo(pkg.version)}
+  ${chalk.dim('Spec-driven development harness for Claude Code — by Polymorphism Tech')}
+`;
 
 program
   .name('morph-spec')

package/claude-plugin.json

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

@@ -196,4 +196,4 @@ These files are never edited directly. Use CLI commands or `morph-spec update` i
 
 ---
 
-*morph-spec v7.7.1 by Polymorphism Tech*
+*morph-spec v7.7.3 by Polymorphism Tech*

package/docs/QUICKSTART.md

@@ -197,4 +197,4 @@ morph-spec doctor
 
 ---
 
-*morph-spec v7.7.1 by Polymorphism Tech*
+*morph-spec v7.7.3 by Polymorphism Tech*

package/framework/skills/core/create-umbraco-lp/SKILL.md

@@ -4,7 +4,7 @@ description: Guia a criação de uma landing page nova ponta-a-ponta a partir do
 version: core
 when-to-invoke: ao iniciar um novo projeto de LP com o template Umbraco genérico
 user-invokable: true
-cliVersion: "7.7.1"
+cliVersion: "7.7.3"
 ---
 
 # create-umbraco-lp

package/framework/skills/core/migrate-lp-to-umbraco/SKILL.md

@@ -4,7 +4,7 @@ description: Migra uma landing page existente (React/Vite, Next.js estático ou
 version: core
 when-to-invoke: ao receber instrução "use /migrate-lp-to-umbraco {projeto}" do usuário, ou quando o usuário descrever necessidade de migrar uma LP para Umbraco
 user-invokable: true
-cliVersion: "7.7.1"
+cliVersion: "7.7.3"
 ---
 
 # migrate-lp-to-umbraco

package/framework/skills/core/morph-apply/SKILL.md

@@ -4,7 +4,7 @@ description: Orquestra a execução autônoma de tasks de uma feature morph-spec
 version: core
 when-to-invoke: após Gate 2 aprovado, ao receber instrução "use /morph-apply" ou "implementar feature"
 user-invokable: true
-cliVersion: "7.7.1"
+cliVersion: "7.7.3"
 ---
 
 # morph-apply

package/framework/skills/core/morph-brainstorming/SKILL.md

@@ -4,7 +4,7 @@ description: Entende o negócio, os usuários e a arquitetura antes de qualquer
 version: core
 when-to-invoke: ao receber um novo request de feature, antes de morph-plan
 user-invokable: true
-cliVersion: "7.7.1"
+cliVersion: "7.7.3"
 ---
 
 # morph-brainstorming

package/framework/skills/core/morph-eval/SKILL.md

@@ -4,7 +4,7 @@ description: Avalia a qualidade de uma tarefa ou fase com rubricas graduadas 0-1
 version: core
 when-to-invoke: ao completar uma tarefa ou ao finalizar uma fase de implementação
 user-invokable: false
-cliVersion: "7.7.1"
+cliVersion: "7.7.3"
 ---
 
 # morph-eval

package/framework/skills/core/morph-implement/SKILL.md

@@ -4,7 +4,7 @@ description: Guia a execução de cada tarefa de implementação com standard e
 version: core
 when-to-invoke: ao iniciar cada task de implementação listada em tasks.json
 user-invokable: false
-cliVersion: "7.7.1"
+cliVersion: "7.7.3"
 ---
 
 # morph-implement

package/framework/skills/core/morph-plan/SKILL.md

@@ -4,7 +4,7 @@ description: Guia a produção dos três artefatos de planejamento de uma featur
 version: core
 when-to-invoke: ao iniciar a fase plan de uma feature, após o Gate 1 (proposal aprovado)
 user-invokable: true
-cliVersion: "7.7.1"
+cliVersion: "7.7.3"
 ---
 
 # morph-plan

package/framework/skills/core/morph-proposal/SKILL.md

@@ -4,7 +4,7 @@ description: Orquestra a fase de proposta+plano de uma feature morph-spec. Encad
 version: core
 when-to-invoke: ao receber instrução "use /morph-proposal" do usuário, ou ao iniciar uma nova feature
 user-invokable: true
-cliVersion: "7.7.1"
+cliVersion: "7.7.3"
 ---
 
 # morph-proposal

package/framework/skills/core/morph-review/SKILL.md

@@ -4,7 +4,7 @@ description: Conduz a fase de revisão e produz o review-report.md para o Gate 3
 version: core
 when-to-invoke: ao iniciar a fase review, após todas as tasks de tasks.json estarem com status `done`
 user-invokable: true
-cliVersion: "7.7.1"
+cliVersion: "7.7.3"
 ---
 
 # morph-review

package/framework/skills/core/morph-stack-scan/SKILL.md

@@ -4,7 +4,7 @@ description: Varre o codebase existente, detecta stack atual, compara com o stac
 version: core
 when-to-invoke: ao iniciar uma feature em projeto brownfield (codebase já existente)
 user-invokable: true
-cliVersion: "7.7.1"
+cliVersion: "7.7.3"
 ---
 
 # morph-stack-scan

package/framework/skills/core/morph-standards/SKILL.md

@@ -4,7 +4,7 @@ description: Localiza e carrega um standard específico do STANDARDS.json sob de
 version: core
 when-to-invoke: quando precisar consultar um standard específico durante a implementação
 user-invokable: true
-cliVersion: "7.7.1"
+cliVersion: "7.7.3"
 ---
 
 # morph-standards

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polymorphism-tech/morph-spec",
-  "version": "7.7.1",
+  "version": "7.7.3",
   "description": "MORPH-SPEC: NLH (Natural Language Harness) for spec-driven development with Claude Code",
   "keywords": [
     "claude-code",

package/src/commands/project/doctor.js

@@ -196,7 +196,10 @@ async function doctorFullCommand(frameworkRoot) {
       let projectTags = [];
       const cfgPath = join(frameworkRoot, '.morph/config/config.json');
       if (await pathExists(cfgPath)) {
-        try { projectTags = getProjectTags(JSON.parse(await fs.readFile(cfgPath, 'utf8'))); } catch { /* no tags */ }
+        try {
+          const rawCfg = (await fs.readFile(cfgPath, 'utf8')).replace(/^/, '');
+          projectTags = getProjectTags(JSON.parse(rawCfg));
+        } catch { /* no tags */ }
       }
       const drift = checkAgentsDrift(frameworkRoot, join(frameworkRoot, '.morph/framework'), projectTags);
       check(`Personas installed (${drift.expected - drift.missing.length}/${drift.expected})`,

package/src/commands/project/update.js

@@ -410,6 +410,8 @@ export async function updateCommand(options) {
     if (updateStandards) logger.dim('  ✓ .morph/framework/standards/');
     logger.dim('  ✓ .morph/framework/hooks/');
     logger.dim('  ✓ .morph/framework/agents.json');
+    logger.dim('  ✓ .morph/framework/MORPH.md + phases.json (NLH charter)');
+    logger.dim('  ✓ .morph/framework/schemas/ + rubrics/ + evals/ (bar 9 + LLM rubrics)');
     if (commandsCopied) logger.dim('  ✓ .claude/commands/');
 
     logger.dim(`  ✓ .claude/settings.local.json (${hooksResult.installed} hooks installed)`);

package/src/scripts/setup-infra.js

@@ -92,7 +92,10 @@ async function installStackAwareAssets(targetPath, log) {
   let projectTags = [];
   if (await pathExists(configPath)) {
     try {
-      const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+      // BOM-tolerant: a config.json hand-edited on Windows (PS 5.1 Out-File)
+      // carries a UTF-8 BOM; without stripping it this parse fails silently
+      // and only universal personas get installed.
+      const config = JSON.parse(readFileSync(configPath, 'utf-8').replace(/^/, ''));
       projectTags = getProjectTags(config);
     } catch { /* ignore malformed config */ }
   }

package/src/utils/banner.js

@@ -1,51 +1,86 @@
-// src/utils/banner.js
-import chalk from 'chalk';
-import { type as osType, release as osRelease } from 'os';
-
-const BRAND = chalk.hex('#7C3AED');
-const DIM = chalk.dim;
-
-function platformLabel() {
-  const t = osType();
-  const r = osRelease().split('.').slice(0, 2).join('.');
-  if (t === 'Windows_NT') return `Windows ${r}`;
-  if (t === 'Darwin') return `macOS ${r}`;
-  return `Linux ${r}`;
-}
-
-export function printInstallBanner({ version, nodeVersion, results = [] }) {
-  const TITLE = '◆  M O R P H - S P E C';
-  const pad = `  ${TITLE}  `;
-  const line = '─'.repeat(pad.length);
-
-  const box = [
-    BRAND(`┌${line}┐`),
-    BRAND('│') + chalk.bold.white(pad) + BRAND('│'),
-    BRAND(`└${line}┘`),
-  ].join('\n');
-
-  const sep = (label) => DIM(`  ── ${label} ${'─'.repeat(Math.max(0, 30 - label.length))}`);
-
-  const itemLines = results.map(r =>
-    r.ok
-      ? `  ${chalk.green('✔')} ${r.label.padEnd(20)} ${DIM(r.path)}`
-      : `  ${chalk.red('✖')} ${r.label.padEnd(20)} ${chalk.red(r.error ?? 'failed')}`
-  );
-
-  console.log([
-    '',
-    box,
-    '',
-    `  Version    ${chalk.white(version)}`,
-    `  Platform   ${chalk.white(platformLabel())}`,
-    `  Node       ${chalk.white(nodeVersion)}`,
-    '',
-    sep('Installed'),
-    ...itemLines,
-    '',
-    sep('Next'),
-    `  ${chalk.cyan('1.')} Open your project in Claude Code`,
-    `  ${chalk.cyan('2.')} Run ${chalk.bold.white('/morph-init')}`,
-    '',
-  ].join('\n'));
-}
+// src/utils/banner.js
+import chalk from 'chalk';
+import { type as osType, release as osRelease } from 'os';
+
+const BRAND = chalk.hex('#7C3AED');
+const DIM = chalk.dim;
+
+/** Purple gradient, one tone per logo line (top → bottom). */
+const GRADIENT = ['#6D28D9', '#7C3AED', '#8B5CF6', '#A78BFA', '#C4B5FD', '#DDD6FE'];
+
+const LOGO_LINES = [
+  '███╗   ███╗ ██████╗ ██████╗ ██████╗ ██╗  ██╗',
+  '████╗ ████║██╔═══██╗██╔══██╗██╔══██╗██║  ██║',
+  '██╔████╔██║██║   ██║██████╔╝██████╔╝███████║',
+  '██║╚██╔╝██║██║   ██║██╔══██╗██╔═══╝ ██╔══██║',
+  '██║ ╚═╝ ██║╚██████╔╝██║  ██║██║     ██║  ██║',
+  '╚═╝     ╚═╝ ╚═════╝ ╚═╝  ╚═╝╚═╝     ╚═╝  ╚═╝',
+];
+
+const LOGO_WIDTH = LOGO_LINES[0].length; // 44
+
+/**
+ * The morph-spec logo: gradient "MORPH" block art with a S P E C + version
+ * rule underneath. Single source for the CLI help banner and the install
+ * banner — one drawing, everywhere.
+ *
+ * @param {string} version - e.g. "7.7.2"
+ * @returns {string}
+ */
+export function renderLogo(version) {
+  const art = LOGO_LINES
+    .map((line, i) => '  ' + chalk.hex(GRADIENT[i])(line))
+    .join('\n');
+
+  const label = ` S P E C `;
+  const ver = ` v${version} `;
+  const plain = `${label}·${ver}`;
+  const side = Math.max(2, Math.floor((LOGO_WIDTH - plain.length) / 2));
+  const rule =
+    '  ' +
+    DIM('─'.repeat(side)) +
+    BRAND.bold(label) +
+    DIM('·') +
+    chalk.bold.white(ver) +
+    DIM('─'.repeat(Math.max(2, LOGO_WIDTH - side - plain.length)));
+
+  return `\n${art}\n${rule}\n`;
+}
+
+function platformLabel() {
+  const t = osType();
+  const r = osRelease().split('.').slice(0, 2).join('.');
+  if (t === 'Windows_NT') return `Windows ${r}`;
+  if (t === 'Darwin') return `macOS ${r}`;
+  return `Linux ${r}`;
+}
+
+export function printInstallBanner({ version, nodeVersion, results = [] }) {
+  const sep = (label) => DIM(`  ── ${label} ${'─'.repeat(Math.max(0, 38 - label.length))}`);
+
+  const itemLines = results.map(r =>
+    r.ok
+      ? `  ${chalk.green('✔')} ${r.label.padEnd(20)} ${DIM(r.path)}`
+      : `  ${chalk.red('✖')} ${r.label.padEnd(20)} ${chalk.red(r.error ?? 'failed')}`
+  );
+
+  console.log([
+    renderLogo(version),
+    `  ${DIM('Spec-driven development harness for Claude Code')}`,
+    `  ${DIM('by Polymorphism Tech')} ${DIM('·')} ${DIM('Node')} ${chalk.white(nodeVersion)} ${DIM('·')} ${chalk.white(platformLabel())}`,
+    '',
+    sep('Installed'),
+    ...itemLines,
+    '',
+    sep('Next · new project'),
+    `  ${chalk.cyan('1.')} ${DIM('cd')} ${chalk.white('your-project')} ${DIM('(git repo)')}`,
+    `  ${chalk.cyan('2.')} Run ${chalk.bold.white('morph-spec init')}`,
+    `  ${chalk.cyan('3.')} Open it in Claude Code and run ${chalk.bold.white('/morph-init')}`,
+    '',
+    sep('Next · project already on morph-spec'),
+    `  ${chalk.cyan('1.')} Run ${chalk.bold.white('morph-spec update')} ${DIM('— sync charter, rubrics, hooks, personas')}`,
+    `  ${chalk.cyan('2.')} Run ${chalk.bold.white('morph-spec doctor')} ${DIM('— validate install + personas drift')}`,
+    `  ${chalk.cyan('3.')} ${DIM('Check')} ${chalk.white('.morph/config/config.json → project.stack')} ${DIM('(drives which personas install)')}`,
+    '',
+  ].join('\n'));
+}

package/src/utils/file-copier.js

@@ -37,7 +37,12 @@ export async function pathExists(path) {
 }
 
 export async function readJson(path) {
-  return fs.readJson(path);
+  // BOM-tolerant: PowerShell 5.1's `Out-File -Encoding utf8` writes UTF-8
+  // WITH BOM, and JSON.parse rejects it. A hand-edited config.json on Windows
+  // would then silently fall back to empty project tags (fail-open reads),
+  // installing only universal personas. Strip the BOM before parsing.
+  const raw = await fs.readFile(path, 'utf-8');
+  return JSON.parse(raw.replace(/^/, ''));
 }
 
 export async function writeJson(path, data) {