@polymorphism-tech/morph-spec 2.2.0 → 2.4.0

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/content/.claude/commands/morph-costs.md

@@ -1,206 +0,0 @@
-# /morph-costs - Cost Estimation and Reporting
-
-Estima e reporta custos de recursos Azure.
-
-## Uso
-
-```
-/morph-costs [action]
-```
-
-### Actions
-
-| Action | Descrição |
-|--------|-----------|
-| `estimate` | Estima custos da feature atual |
-| `report` | Gera relatório de custos do projeto |
-| `compare` | Compara custos entre ambientes |
-
----
-
-## Workflow
-
-### 1. ESTIMATE - Estimar Custos
-
-Quando o usuário solicitar `/morph-costs estimate`:
-
-1. Ler spec.md da feature atual para identificar recursos
-
-2. Para cada recurso Azure, calcular custo mensal:
-
-   | Recurso | SKU | Custo/Mês |
-   |---------|-----|-----------|
-   | Container Apps | Consumption (scale-to-zero) | ~$0 |
-   | Azure SQL | Free (32GB) | $0 |
-   | Azure SQL | Basic (5 DTU) | ~$5 |
-   | Storage | Standard LRS (1GB) | ~$0.02 |
-   | Key Vault | Standard | ~$0.03/10k ops |
-   | App Insights | Free (5GB/mês) | $0 |
-   | Service Bus | Basic | ~$0.05 |
-
-3. Apresentar estimativa:
-   ```markdown
-   ## Estimativa de Custos - {Feature}
-
-   | Recurso | SKU | Custo/Mês |
-   |---------|-----|-----------|
-   | Container Apps | Consumption | ~$0 |
-   | SQL Database | Free | $0 |
-   | Storage | LRS 1GB | $0.02 |
-   | **TOTAL** | | **$0.02/mês** |
-
-   ### Aprovação
-   ✅ Free tier - nenhuma aprovação necessária
-   ```
-
-4. Verificar contra limites do Cost Guardian:
-   - Free tier apenas: ✅ Aprovado automaticamente
-   - Até $10/mês: ⚠️ Requer confirmação
-   - Acima de $10: ❌ Requer ADR
-
----
-
-### 2. REPORT - Relatório de Custos
-
-Quando o usuário solicitar `/morph-costs report`:
-
-1. Analisar todos os recursos definidos em `infra/`
-
-2. Gerar relatório consolidado:
-
-   ```markdown
-   ## Relatório de Custos - {Projeto}
-
-   ### Por Ambiente
-
-   | Ambiente | Recursos | Custo/Mês |
-   |----------|----------|-----------|
-   | dev | 6 | ~$0 |
-   | prod | 6 | ~$15 |
-   | **Total** | | **~$15/mês** |
-
-   ### Por Tipo de Recurso
-
-   | Recurso | Dev | Prod |
-   |---------|-----|------|
-   | Container Apps | $0 | $5 |
-   | SQL Database | $0 | $5 |
-   | Storage | $0.02 | $2 |
-   | Key Vault | $0 | $0.50 |
-   | App Insights | $0 | $2.50 |
-
-   ### Recomendações
-   1. ✅ Dev usa free tier corretamente
-   2. ⚠️ Considerar Reserved Capacity para prod (-30%)
-   ```
-
-3. Salvar relatório em `.morph/outputs/costs-report.md`
-
----
-
-### 3. COMPARE - Comparar Ambientes
-
-Quando o usuário solicitar `/morph-costs compare`:
-
-1. Analisar `parameters.dev.json` e `parameters.prod.json`
-
-2. Gerar comparativo:
-
-   ```markdown
-   ## Comparativo de Custos
-
-   | Recurso | Dev | Prod | Diferença |
-   |---------|-----|------|-----------|
-   | SQL SKU | Free | Basic | +$5 |
-   | Storage SKU | LRS | GRS | +$1 |
-   | Min Replicas | 0 | 1 | +$3 |
-   | **Total** | $0 | $15 | +$15 |
-
-   ### Por que prod custa mais?
-   - SQL Basic: melhor performance, SLA 99.99%
-   - Storage GRS: redundância geográfica
-   - Min replicas 1: sem cold start
-   ```
-
----
-
-## Pricing Reference
-
-### Free Tier Resources
-
-| Recurso | Limite Grátis |
-|---------|---------------|
-| Azure SQL | 32GB, 100k vCore seconds |
-| Container Apps | Scale-to-zero, 180k vCPU-sec |
-| Storage | 5GB LRS |
-| App Insights | 5GB/mês |
-| Cosmos DB | 1000 RU/s, 25GB |
-| Functions | 1M execuções |
-
-### Costs by Region (Brazil South)
-
-| Recurso | SKU | Preço |
-|---------|-----|-------|
-| Container Apps | Consumption | $0.000012/vCPU-sec |
-| SQL | Basic | $4.99/mês |
-| SQL | S0 | $14.72/mês |
-| Storage | LRS | $0.0184/GB |
-| Storage | GRS | $0.046/GB |
-
----
-
-## Cost Guardian Rules
-
-### Aprovação Automática (Free Tier)
-- Container Apps com scale-to-zero
-- SQL Free tier
-- Storage Standard LRS até 5GB
-- App Insights free tier
-
-### Requer Confirmação (até $10/mês)
-- SQL Basic
-- Storage adicional
-- Service Bus Basic
-
-### Requer ADR (acima de $10/mês)
-- Recursos Premium
-- Multiple replicas
-- Reserved capacity
-- Qualquer recurso não essencial
-
----
-
-## Exemplo de Uso
-
-```
-Usuário: /morph-costs estimate
-Claude: Analisando feature "scheduled-reports"...
-
-        ## Estimativa de Custos
-
-        | Recurso | SKU | Custo/Mês |
-        |---------|-----|-----------|
-        | Container Apps | Consumption | ~$0 |
-        | SQL Database | Free | $0 |
-        | Storage | LRS 1GB | $0.02 |
-        | Hangfire | In-process | $0 |
-
-        **TOTAL: ~$0.02/mês**
-
-        ✅ Dentro do free tier - aprovado automaticamente!
-
-Usuário: /morph-costs report
-Claude: ## Relatório de Custos - MyProject
-
-        | Ambiente | Custo/Mês |
-        |----------|-----------|
-        | dev | $0.02 |
-        | prod | $12.50 |
-
-        ⚠️ Prod excede $10/mês.
-        Deseja criar um ADR para justificar? (sim/não)
-```
-
----
-
-*MORPH-SPEC by Polymorphism Tech*