@polymorphism-tech/morph-spec 4.10.6 → 4.10.8

package/src/utils/version-checker.js

@@ -1,175 +1,175 @@
-import { readFileSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import { pathExists, readJson, writeJson } from './file-copier.js';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-/**
- * Get the current CLI version from package.json
- * @returns {string} Version string (e.g., "1.0.4")
- */
-export function getInstalledCLIVersion() {
-  try {
-    const pkgPath = join(__dirname, '..', '..', 'package.json');
-    const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
-    return pkg.version;
-  } catch (error) {
-    return 'unknown';
-  }
-}
-
-/**
- * Get the latest version from npm registry
- * @param {string} packageName - The package name (default: @polymorphism-tech/morph-spec)
- * @returns {Promise<string|null>} Latest version or null if failed
- */
-export async function getLatestNPMVersion(packageName = '@polymorphism-tech/morph-spec') {
-  try {
-    const response = await fetch(`https://registry.npmjs.org/${packageName}/latest`);
-    if (!response.ok) return null;
-    const data = await response.json();
-    return data.version;
-  } catch (error) {
-    return null;
-  }
-}
-
-/**
- * Get the MORPH version installed in the project
- * @param {string} projectPath - Path to the project
- * @returns {Promise<object|null>} Version info object or null if not found
- */
-export async function getProjectMorphVersion(projectPath) {
-  try {
-    const versionPath = join(projectPath, '.morph', '.morphversion');
-    if (!(await pathExists(versionPath))) {
-      return null;
-    }
-    return await readJson(versionPath);
-  } catch (error) {
-    return null;
-  }
-}
-
-/**
- * Save the MORPH version to the project
- * @param {string} projectPath - Path to the project
- * @param {string} version - Version to save
- * @returns {Promise<void>}
- */
-export async function saveProjectMorphVersion(projectPath, version) {
-  const versionPath = join(projectPath, '.morph', '.morphversion');
-  const versionInfo = {
-    morphVersion: version,
-    installedAt: new Date().toISOString(),
-    cliVersion: version
-  };
-  await writeJson(versionPath, versionInfo);
-}
-
-/**
- * Compare two semver versions
- * @param {string} v1 - First version
- * @param {string} v2 - Second version
- * @returns {number} -1 if v1 < v2, 0 if equal, 1 if v1 > v2
- */
-export function compareVersions(v1, v2) {
-  if (!v1 || !v2) return 0;
-
-  const parts1 = v1.split('.').map(Number);
-  const parts2 = v2.split('.').map(Number);
-
-  for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
-    const num1 = parts1[i] || 0;
-    const num2 = parts2[i] || 0;
-
-    if (num1 < num2) return -1;
-    if (num1 > num2) return 1;
-  }
-
-  return 0;
-}
-
-/**
- * Detect how the CLI was installed
- * @returns {'global'|'npx'|'unknown'}
- */
-export function detectInstallMethod() {
-  // Check if running via npx
-  if (process.env.npm_execpath && process.env.npm_execpath.includes('npx')) {
-    return 'npx';
-  }
-
-  // Check if installed globally
-  const isGlobal = process.env.npm_config_global === 'true' ||
-                   process.execPath.includes('node_modules');
-
-  if (isGlobal) {
-    return 'global';
-  }
-
-  return 'unknown';
-}
-
-/**
- * Get update instructions based on install method
- * @param {string} method - Install method ('global', 'npx', 'unknown')
- * @returns {string[]} Array of instruction strings
- */
-export function getUpdateInstructions(method) {
-  switch (method) {
-    case 'global':
-      return [
-        'npm install -g @polymorphism-tech/morph-spec@latest',
-        'morph-spec update'
-      ];
-    case 'npx':
-      return [
-        'npx @polymorphism-tech/morph-spec@latest update'
-      ];
-    default:
-      return [
-        'npm install -g @polymorphism-tech/morph-spec@latest',
-        'morph-spec update',
-        '',
-        'Or use npx:',
-        'npx @polymorphism-tech/morph-spec@latest update'
-      ];
-  }
-}
-
-/**
- * Check if CLI version is outdated
- * @returns {Promise<{isOutdated: boolean, current: string, latest: string|null}>}
- */
-export async function checkCLIOutdated() {
-  const current = getInstalledCLIVersion();
-  const latest = await getLatestNPMVersion();
-
-  if (!latest) {
-    return { isOutdated: false, current, latest: null };
-  }
-
-  const isOutdated = compareVersions(current, latest) < 0;
-
-  return { isOutdated, current, latest };
-}
-
-/**
- * Check if project MORPH version is outdated
- * @param {string} projectPath - Path to the project
- * @returns {Promise<{isOutdated: boolean, current: string|null, cliVersion: string}>}
- */
-export async function checkProjectOutdated(projectPath) {
-  const cliVersion = getInstalledCLIVersion();
-  const projectVersion = await getProjectMorphVersion(projectPath);
-
-  if (!projectVersion) {
-    return { isOutdated: false, current: null, cliVersion };
-  }
-
-  const isOutdated = compareVersions(projectVersion.morphVersion, cliVersion) < 0;
-
-  return { isOutdated, current: projectVersion.morphVersion, cliVersion };
-}
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { pathExists, readJson, writeJson } from './file-copier.js';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+/**
+ * Get the current CLI version from package.json
+ * @returns {string} Version string (e.g., "1.0.4")
+ */
+export function getInstalledCLIVersion() {
+  try {
+    const pkgPath = join(__dirname, '..', '..', 'package.json');
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+    return pkg.version;
+  } catch (error) {
+    return 'unknown';
+  }
+}
+
+/**
+ * Get the latest version from npm registry
+ * @param {string} packageName - The package name (default: @polymorphism-tech/morph-spec)
+ * @returns {Promise<string|null>} Latest version or null if failed
+ */
+export async function getLatestNPMVersion(packageName = '@polymorphism-tech/morph-spec') {
+  try {
+    const response = await fetch(`https://registry.npmjs.org/${packageName}/latest`);
+    if (!response.ok) return null;
+    const data = await response.json();
+    return data.version;
+  } catch (error) {
+    return null;
+  }
+}
+
+/**
+ * Get the MORPH version installed in the project
+ * @param {string} projectPath - Path to the project
+ * @returns {Promise<object|null>} Version info object or null if not found
+ */
+export async function getProjectMorphVersion(projectPath) {
+  try {
+    const versionPath = join(projectPath, '.morph', '.morphversion');
+    if (!(await pathExists(versionPath))) {
+      return null;
+    }
+    return await readJson(versionPath);
+  } catch (error) {
+    return null;
+  }
+}
+
+/**
+ * Save the MORPH version to the project
+ * @param {string} projectPath - Path to the project
+ * @param {string} version - Version to save
+ * @returns {Promise<void>}
+ */
+export async function saveProjectMorphVersion(projectPath, version) {
+  const versionPath = join(projectPath, '.morph', '.morphversion');
+  const versionInfo = {
+    morphVersion: version,
+    installedAt: new Date().toISOString(),
+    cliVersion: version
+  };
+  await writeJson(versionPath, versionInfo);
+}
+
+/**
+ * Compare two semver versions
+ * @param {string} v1 - First version
+ * @param {string} v2 - Second version
+ * @returns {number} -1 if v1 < v2, 0 if equal, 1 if v1 > v2
+ */
+export function compareVersions(v1, v2) {
+  if (!v1 || !v2) return 0;
+
+  const parts1 = v1.split('.').map(Number);
+  const parts2 = v2.split('.').map(Number);
+
+  for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
+    const num1 = parts1[i] || 0;
+    const num2 = parts2[i] || 0;
+
+    if (num1 < num2) return -1;
+    if (num1 > num2) return 1;
+  }
+
+  return 0;
+}
+
+/**
+ * Detect how the CLI was installed
+ * @returns {'global'|'npx'|'unknown'}
+ */
+export function detectInstallMethod() {
+  // Check if running via npx
+  if (process.env.npm_execpath && process.env.npm_execpath.includes('npx')) {
+    return 'npx';
+  }
+
+  // Check if installed globally
+  const isGlobal = process.env.npm_config_global === 'true' ||
+                   process.execPath.includes('node_modules');
+
+  if (isGlobal) {
+    return 'global';
+  }
+
+  return 'unknown';
+}
+
+/**
+ * Get update instructions based on install method
+ * @param {string} method - Install method ('global', 'npx', 'unknown')
+ * @returns {string[]} Array of instruction strings
+ */
+export function getUpdateInstructions(method) {
+  switch (method) {
+    case 'global':
+      return [
+        'npm install -g @polymorphism-tech/morph-spec@latest',
+        'morph-spec update'
+      ];
+    case 'npx':
+      return [
+        'npx @polymorphism-tech/morph-spec@latest update'
+      ];
+    default:
+      return [
+        'npm install -g @polymorphism-tech/morph-spec@latest',
+        'morph-spec update',
+        '',
+        'Or use npx:',
+        'npx @polymorphism-tech/morph-spec@latest update'
+      ];
+  }
+}
+
+/**
+ * Check if CLI version is outdated
+ * @returns {Promise<{isOutdated: boolean, current: string, latest: string|null}>}
+ */
+export async function checkCLIOutdated() {
+  const current = getInstalledCLIVersion();
+  const latest = await getLatestNPMVersion();
+
+  if (!latest) {
+    return { isOutdated: false, current, latest: null };
+  }
+
+  const isOutdated = compareVersions(current, latest) < 0;
+
+  return { isOutdated, current, latest };
+}
+
+/**
+ * Check if project MORPH version is outdated
+ * @param {string} projectPath - Path to the project
+ * @returns {Promise<{isOutdated: boolean, current: string|null, cliVersion: string}>}
+ */
+export async function checkProjectOutdated(projectPath) {
+  const cliVersion = getInstalledCLIVersion();
+  const projectVersion = await getProjectMorphVersion(projectPath);
+
+  if (!projectVersion) {
+    return { isOutdated: false, current: null, cliVersion };
+  }
+
+  const isOutdated = compareVersions(projectVersion.morphVersion, cliVersion) < 0;
+
+  return { isOutdated, current: projectVersion.morphVersion, cliVersion };
+}

package/framework/agents/architecture/po-pm-advisor.md

@@ -1,203 +0,0 @@
----
-name: po-pm-advisor
-description: PO/PM Advisor specialist for clarifying product requirements, defining acceptance criteria, writing user stories, and evaluating feature ROI. Use when defining feature scope, writing user stories with acceptance criteria, prioritizing the backlog, or resolving requirements conflicts.
-allowed-tools: Read, Write, Edit, Bash, Glob, Grep
----
-
-# PO/PM Advisor
-
-Especialista em requisitos, priorização e gestão de produto para clarificar features e ROI.
-
-## Responsabilidades
-
-1. **Clarificar requisitos** ambíguos ou incompletos
-2. **Priorizar features** por valor de negócio
-3. **Calcular ROI** e esforço estimado
-4. **Definir critérios** de aceitação
-
-## Triggers
-
-Keywords: `unclear`, `requirements`, `priority`, `ROI`, `mvp`, `scope`, `acceptance criteria`, `user story`
-
-## Framework de Clarificação
-
-### Perguntas Essenciais
-
-Quando receber uma feature request ambígua, faça estas perguntas:
-
-1. **Quem?** - Qual o usuário/persona principal?
-2. **O quê?** - O que exatamente deve acontecer?
-3. **Por quê?** - Qual problema resolve? Qual o valor?
-4. **Quando?** - Urgência? Deadline externo?
-5. **Como medir?** - Como saberemos que funcionou?
-
-### Template de User Story
-
-```markdown
-## User Story: {Nome da Feature}
-
-**Como** {persona/usuário},
-**Eu quero** {ação/funcionalidade},
-**Para que** {benefício/valor}.
-
-### Critérios de Aceitação
-
-**Dado** {contexto inicial},
-**Quando** {ação do usuário},
-**Então** {resultado esperado}.
-
-### Fora do Escopo
-
-- {Item explicitamente excluído}
-
-### Perguntas Pendentes
-
-- [ ] {Dúvida não resolvida}
-```
-
-## Matriz de Priorização (RICE)
-
-| Fator | Descrição | Escala |
-|-------|-----------|--------|
-| **R**each | Quantos usuários impacta | 1-10 |
-| **I**mpact | Quanto impacta cada usuário | 0.25, 0.5, 1, 2, 3 |
-| **C**onfidence | Confiança nas estimativas | 0-100% |
-| **E**ffort | Pessoa-semanas de trabalho | 1+ |
-
-```
-RICE Score = (Reach × Impact × Confidence) / Effort
-```
-
-### Exemplo
-
-| Feature | Reach | Impact | Confidence | Effort | Score |
-|---------|-------|--------|------------|--------|-------|
-| Login social | 8 | 1 | 80% | 1 | 6.4 |
-| Dashboard | 5 | 2 | 90% | 3 | 3.0 |
-| Export PDF | 3 | 0.5 | 100% | 0.5 | 3.0 |
-| Dark mode | 4 | 0.25 | 100% | 1 | 1.0 |
-
-## MVP vs Nice-to-Have
-
-### Critérios para MVP
-
-1. **Resolve o problema core** do usuário
-2. **Diferencia** da concorrência
-3. **Validável** em 2-4 semanas
-4. **Mensurável** (métricas definidas)
-
-### Framework MoSCoW
-
-| Categoria | Significado | Exemplo |
-|-----------|-------------|---------|
-| **M**ust have | Essencial, sem isso não funciona | Login, CRUD básico |
-| **S**hould have | Importante, mas não crítico | Filtros avançados |
-| **C**ould have | Desejável se houver tempo | Exportar relatório |
-| **W**on't have | Fora deste release | Integração X |
-
-## Estimativa de Esforço
-
-### T-Shirt Sizing
-
-| Size | Dias | Complexidade |
-|------|------|--------------|
-| XS | 0.5 | Task trivial |
-| S | 1-2 | Feature simples |
-| M | 3-5 | Feature com complexidade |
-| L | 5-10 | Feature complexa |
-| XL | 10+ | Épico, precisa quebrar |
-
-### Fatores de Risco
-
-Multiplicar estimativa por:
-
-| Fator | Multiplicador |
-|-------|---------------|
-| Tecnologia nova | 1.5x |
-| Integração externa | 1.3x |
-| Requisitos vagos | 1.5x |
-| Primeiro da equipe | 1.3x |
-
-## Template de ADR (Architecture Decision Record)
-
-```markdown
-# ADR-{XXX}: {Título da Decisão}
-
-## Status
-{PROPOSED | ACCEPTED | DEPRECATED | SUPERSEDED}
-
-## Contexto
-{Situação que requer decisão}
-
-## Opções Consideradas
-
-### Opção 1: {Nome}
-- Prós: ...
-- Contras: ...
-- Custo: ...
-
-### Opção 2: {Nome}
-- Prós: ...
-- Contras: ...
-- Custo: ...
-
-## Decisão
-{Opção escolhida e por quê}
-
-## Consequências
-- {Implicação positiva}
-- {Implicação negativa}
-- {Trade-off aceito}
-```
-
-## Cálculo de ROI
-
-```markdown
-## ROI Estimado: {Feature}
-
-### Benefícios (anual)
-- Aumento de conversão: R$ X
-- Redução de suporte: R$ Y
-- Economia de tempo: R$ Z
-- **Total Benefícios**: R$ (X+Y+Z)
-
-### Custos
-- Desenvolvimento: R$ A (horas × rate)
-- Infraestrutura: R$ B/mês × 12
-- Manutenção: R$ C/ano
-- **Total Custos**: R$ (A+B+C)
-
-### ROI
-**ROI = (Benefícios - Custos) / Custos × 100**
-
-ROI = (X+Y+Z - A+B+C) / (A+B+C) × 100 = **{N}%**
-
-### Payback
-**Meses = Custo Inicial / (Benefício Mensal - Custo Mensal)**
-```
-
-## Red Flags em Requisitos
-
-Alertar quando detectar:
-
-- "Deve ser igual ao [concorrente X]" sem especificar
-- "Simples" ou "rápido" sem estimativa
-- "Usuários querem..." sem evidência
-- Escopo crescente sem priorização
-- Deadline impossível sem trade-offs
-
-## Checklist de Requisitos
-
-- [ ] Persona/usuário definido
-- [ ] Problema claramente articulado
-- [ ] Valor de negócio quantificado
-- [ ] Critérios de aceitação escritos
-- [ ] Fora do escopo explícito
-- [ ] Dependências mapeadas
-- [ ] Riscos identificados
-- [ ] Estimativa de esforço
-- [ ] Prioridade definida (RICE/MoSCoW)
-
----
-
-*MORPH-SPEC by Polymorphism Tech*

package/framework/hooks/claude-code/user-prompt/set-terminal-title.js

@@ -1,68 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * UserPromptSubmit Hook: Set Terminal Title
- *
- * Event: UserPromptSubmit
- *
- * Extracts a concise title from the user's prompt and sets it as the
- * terminal window title using ANSI escape sequences written to /dev/tty.
- * Also saves to ~/.claude/terminal_title for shell hook integration.
- *
- * Title format: "[first ~40 chars of prompt, truncated at word boundary]"
- *
- * Fail-open: exits 0 on any error.
- */
-
-import { readStdin } from '../../shared/stdin-reader.js';
-import { openSync, writeSync, closeSync } from 'fs';
-import { writeFile, mkdir } from 'fs/promises';
-import { homedir } from 'os';
-import { join } from 'path';
-import { logHookActivity } from '../../shared/activity-logger.js';
-
-try {
-  const payload = await readStdin();
-  if (!payload) process.exit(0);
-
-  const prompt = payload?.prompt || payload?.user_prompt || payload?.content || '';
-  if (!prompt || prompt.length < 3) process.exit(0);
-
-  // Generate title: clean prompt, truncate at word boundary within 40 chars
-  const cleaned = prompt.replace(/[\r\n\t]+/g, ' ').replace(/\s+/g, ' ').trim();
-  const maxLen = 40;
-  let title = cleaned.slice(0, maxLen);
-  if (cleaned.length > maxLen) {
-    const lastSpace = title.lastIndexOf(' ');
-    if (lastSpace > 20) title = title.slice(0, lastSpace);
-  }
-
-  const prefix = process.env.CLAUDE_TITLE_PREFIX ? `${process.env.CLAUDE_TITLE_PREFIX} ` : '';
-  const finalTitle = `${prefix}${title}`;
-
-  // Save to session-specific file (MORPH_TERMINAL_TITLE_FILE) or fallback to global
-  // MORPH_TERMINAL_TITLE_FILE is set by the shell wrapper (Invoke-Claude / claude())
-  // per-session so multiple terminal windows don't interfere with each other.
-  try {
-    const titleFilePath = process.env.MORPH_TERMINAL_TITLE_FILE
-      || join(homedir(), '.claude', 'terminal_title');
-    const claudeDir = join(homedir(), '.claude');
-    await mkdir(claudeDir, { recursive: true });
-    await writeFile(titleFilePath, finalTitle, 'utf-8');
-  } catch { /* non-critical */ }
-
-  // Write ANSI escape to terminal device (bypasses stdout capture by Claude Code)
-  // Windows uses \\.\CONOUT$ as the equivalent of /dev/tty
-  let wrote = false;
-  try {
-    const devicePath = process.platform === 'win32' ? '\\\\.\\CONOUT$' : '/dev/tty';
-    const tty = openSync(devicePath, 'w');
-    writeSync(tty, `\x1b]0;${finalTitle}\x07`);
-    closeSync(tty);
-    wrote = true;
-  } catch { /* terminal may not support direct device access */ }
-
-  logHookActivity('set-terminal-title', 'UserPromptSubmit', wrote ? 'ok' : 'failed');
-} catch { /* fail-open */ }
-
-process.exit(0);

package/framework/skills/level-1-workflows/morph-phase-implement/.morph/logs/activity.json

@@ -1,38 +0,0 @@
-{
-  "sessionId": "",
-  "feature": "",
-  "phase": "",
-  "hooks": [
-    {
-      "name": "set-terminal-title",
-      "event": "UserPromptSubmit",
-      "result": "failed",
-      "ts": "16:06:20"
-    },
-    {
-      "name": "set-terminal-title",
-      "event": "UserPromptSubmit",
-      "result": "failed",
-      "ts": "16:12:07"
-    },
-    {
-      "name": "set-terminal-title",
-      "event": "UserPromptSubmit",
-      "result": "failed",
-      "ts": "16:12:15"
-    },
-    {
-      "name": "set-terminal-title",
-      "event": "UserPromptSubmit",
-      "result": "failed",
-      "ts": "16:12:15"
-    },
-    {
-      "name": "set-terminal-title",
-      "event": "UserPromptSubmit",
-      "result": "failed",
-      "ts": "16:12:40"
-    }
-  ],
-  "skills": []
-}

package/framework/skills/level-1-workflows/morph-phase-tasks/.morph/logs/activity.json

@@ -1,14 +0,0 @@
-{
-  "sessionId": "",
-  "feature": "",
-  "phase": "",
-  "hooks": [
-    {
-      "name": "set-terminal-title",
-      "event": "UserPromptSubmit",
-      "result": "failed",
-      "ts": "16:38:44"
-    }
-  ],
-  "skills": []
-}