@polymorphism-tech/morph-spec 3.0.1 → 3.2.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/src/writer/file-writer.js

@@ -0,0 +1,86 @@
+/**
+ * @fileoverview FileWriter - Saves generated configs to filesystem
+ * @module morph-spec/writer/file-writer
+ */
+
+import { writeFile, mkdir, access } from 'fs/promises';
+import { join, dirname } from 'path';
+import chalk from 'chalk';
+
+/**
+ * @typedef {import('../types/index.js').GeneratedConfigs} GeneratedConfigs
+ */
+
+/**
+ * FileWriter - Saves configuration files to .morph/ directory
+ * @class
+ */
+export class FileWriter {
+  /**
+   * Save generated configs to filesystem
+   * @param {string} cwd - Current working directory
+   * @param {GeneratedConfigs} configs - Configs to save
+   * @returns {Promise<void>}
+   */
+  async save(cwd, configs) {
+    const morphDir = join(cwd, '.morph');
+    const configDir = join(morphDir, 'config');
+
+    // Ensure directories exist
+    await this.ensureDirectoryExists(morphDir);
+    await this.ensureDirectoryExists(configDir);
+
+    // Write files
+    const projectMdPath = join(morphDir, 'project.md');
+    const configJsonPath = join(configDir, 'config.json');
+
+    await Promise.all([
+      this.writeProjectMd(projectMdPath, configs.projectMd),
+      this.writeConfigJson(configJsonPath, configs.configJson)
+    ]);
+
+    // Display success message
+    console.log(chalk.bold.green('\n✅ Configuration files saved:\n'));
+    console.log(chalk.cyan(`  📄 ${projectMdPath}`));
+    console.log(chalk.cyan(`  ⚙️  ${configJsonPath}`));
+    console.log();
+  }
+
+  /**
+   * Write project.md file
+   * @param {string} filepath - File path
+   * @param {string} content - File content
+   * @returns {Promise<void>}
+   */
+  async writeProjectMd(filepath, content) {
+    await writeFile(filepath, content, 'utf-8');
+  }
+
+  /**
+   * Write config.json file (with pretty formatting)
+   * @param {string} filepath - File path
+   * @param {string} content - File content (JSON string)
+   * @returns {Promise<void>}
+   */
+  async writeConfigJson(filepath, content) {
+    // Parse and re-stringify with pretty formatting
+    const parsed = JSON.parse(content);
+    const formatted = JSON.stringify(parsed, null, 2);
+
+    await writeFile(filepath, formatted, 'utf-8');
+  }
+
+  /**
+   * Ensure directory exists (create if not)
+   * @param {string} dirPath - Directory path
+   * @returns {Promise<void>}
+   */
+  async ensureDirectoryExists(dirPath) {
+    try {
+      await access(dirPath);
+    } catch (error) {
+      // Directory doesn't exist, create it
+      await mkdir(dirPath, { recursive: true });
+    }
+  }
+}

package/{content → stacks/blazor-azure}/.azure/README.md

@@ -268,8 +268,8 @@ az containerapp logs show \
 | [Azure DevOps Setup](docs/azure-devops-setup.md) | Setup completo (Workload Identity, Service Connections, Environments) |
 | [Local Development](docs/local-development.md) | Como rodar projeto local e acessar recursos staging |
 | [Branch Strategy](docs/branch-strategy.md) | Estratégia de branches (staging/main, feature branches) |
-| [Migration Guide](../content/.morph/standards/migration-guide.md) | App Service → Container Apps + CI/CD |
-| [Azure Standards](../content/.morph/standards/azure.md) | Padrões Azure e IaC |
+| [Migration Guide](../.morph/standards/migration-guide.md) | App Service → Container Apps + CI/CD |
+| [Azure Standards](../.morph/standards/azure.md) | Padrões Azure e IaC |
 
 ---
 

package/{content → stacks/blazor-azure}/.azure/pipelines/pipeline-variables.yml

@@ -20,7 +20,7 @@ variables:
   publishPath: '$(Build.ArtifactStagingDirectory)'
 
   # Bicep Configuration
-  bicepTemplateFile: 'content/.morph/templates/infra/main.bicep'
+  bicepTemplateFile: '.morph/templates/infra/main.bicep'
 
   # Versioning
   majorVersion: 1

package/{content → stacks/blazor-azure}/.azure/pipelines/prod-pipeline.yml

@@ -22,7 +22,7 @@ variables:
   - name: hostingType
     value: 'containerapp'
   - name: parametersFile
-    value: 'content/.morph/templates/infra/parameters.prod.json'
+    value: '.morph/templates/infra/parameters.prod.json'
   - name: imageName
     value: '$(APP_NAME)'
   - name: imageFullName

package/{content → stacks/blazor-azure}/.azure/pipelines/staging-pipeline.yml

@@ -24,7 +24,7 @@ variables:
   - name: hostingType
     value: 'containerapp'
   - name: parametersFile
-    value: 'content/.morph/templates/infra/parameters.staging.json'
+    value: '.morph/templates/infra/parameters.staging.json'
   - name: imageName
     value: '$(APP_NAME)'
   - name: imageFullName