@polymorphism-tech/morph-spec 4.8.18 → 4.9.0

package/src/generator/config-generator.js

@@ -1,206 +0,0 @@
-/**
- * @fileoverview ConfigGenerator - Renders templates and generates config files
- * @module morph-spec/generator/config-generator
- */
-
-import { readFile, access, copyFile } from 'fs/promises';
-import { join, dirname } from 'path';
-import Handlebars from 'handlebars';
-import { fileURLToPath } from 'url';
-import Ajv from 'ajv';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-/**
- * @typedef {import('../types/index.js').ProjectConfig} ProjectConfig
- * @typedef {import('../types/index.js').GeneratedConfigs} GeneratedConfigs
- */
-
-/**
- * Validation Error
- */
-export class ValidationError extends Error {
-  constructor(message, field, value) {
-    super(message);
-    this.name = 'ValidationError';
-    this.field = field;
-    this.value = value;
-  }
-}
-
-/**
- * ConfigGenerator - Generates configuration files from ProjectConfig
- * @class
- */
-export class ConfigGenerator {
-  constructor() {
-    this.projectMdTemplate = null;
-    this.configJsonTemplate = null;
-    this.ajv = new Ajv({ allErrors: true });
-  }
-
-  /**
-   * Load templates from filesystem
-   * @private
-   */
-  async loadTemplates() {
-    if (this.projectMdTemplate && this.configJsonTemplate) {
-      return; // Already loaded
-    }
-
-    const templatesDir = join(__dirname, 'templates');
-
-    const [projectMdSource, configJsonSource] = await Promise.all([
-      readFile(join(templatesDir, 'project.md.template'), 'utf-8'),
-      readFile(join(templatesDir, 'config.json.template'), 'utf-8')
-    ]);
-
-    this.projectMdTemplate = Handlebars.compile(projectMdSource);
-    this.configJsonTemplate = Handlebars.compile(configJsonSource);
-  }
-
-  /**
-   * Generate configuration files from project config
-   * @param {ProjectConfig} projectConfig - Detected project config
-   * @returns {Promise<GeneratedConfigs>}
-   */
-  async generate(projectConfig) {
-    // Load templates if not already loaded
-    await this.loadTemplates();
-
-    // Add generation timestamp
-    const context = {
-      ...projectConfig,
-      generatedAt: new Date().toISOString()
-    };
-
-    // Render templates
-    const projectMd = this.renderProjectMd(context);
-    const configJson = this.renderConfigJson(context);
-
-    // Parse config.json to object
-    const configObject = JSON.parse(configJson);
-
-    // Validate config.json (optional, but good practice)
-    // Note: agent-schema.json validation would happen here if we had the schema
-    // For now, we just ensure it's valid JSON
-
-    return {
-      projectMd,
-      configJson,
-      configObject
-    };
-  }
-
-  /**
-   * Render project.md template
-   * @param {ProjectConfig} config - Project config
-   * @returns {string} Rendered markdown
-   */
-  renderProjectMd(config) {
-    if (!this.projectMdTemplate) {
-      throw new Error('Templates not loaded. Call loadTemplates() first.');
-    }
-
-    return this.projectMdTemplate(config);
-  }
-
-  /**
-   * Render config.json template
-   * @param {ProjectConfig} config - Project config
-   * @returns {string} Rendered JSON string
-   */
-  renderConfigJson(config) {
-    if (!this.configJsonTemplate) {
-      throw new Error('Templates not loaded. Call loadTemplates() first.');
-    }
-
-    const rendered = this.configJsonTemplate(config);
-
-    // Validate that rendered output is valid JSON
-    try {
-      JSON.parse(rendered);
-      return rendered;
-    } catch (error) {
-      throw new ValidationError(
-        `Rendered config.json is not valid JSON: ${error.message}`,
-        'configJson',
-        rendered
-      );
-    }
-  }
-
-  /**
-   * Validate config.json against agent schema
-   * @param {string} configJson - JSON string
-   * @returns {boolean} True if valid
-   * @throws {ValidationError} If validation fails
-   */
-  validateConfigJson(configJson) {
-    // Parse JSON
-    let parsed;
-    try {
-      parsed = JSON.parse(configJson);
-    } catch (error) {
-      throw new ValidationError(
-        `Invalid JSON: ${error.message}`,
-        'configJson',
-        configJson
-      );
-    }
-
-    // Basic validation - ensure required fields exist
-    const requiredFields = ['name', 'type', 'description', 'stack', 'architecture'];
-    for (const field of requiredFields) {
-      if (!parsed[field]) {
-        throw new ValidationError(
-          `Missing required field: ${field}`,
-          field,
-          parsed
-        );
-      }
-    }
-
-    // Validate stack.backend is required
-    if (!parsed.stack || !parsed.stack.backend) {
-      throw new ValidationError(
-        'stack.backend is required',
-        'stack.backend',
-        parsed
-      );
-    }
-
-    return true;
-  }
-
-  /**
-   * Backup existing configuration files
-   * @param {string} cwd - Current working directory
-   * @returns {Promise<void>}
-   */
-  async backupExisting(cwd) {
-    const projectMdPath = join(cwd, '.morph', 'project.md');
-    const configJsonPath = join(cwd, '.morph', 'config', 'config.json');
-
-    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
-
-    // Backup project.md if exists
-    try {
-      await access(projectMdPath);
-      const backupPath = join(cwd, '.morph', `project.md.${timestamp}.backup`);
-      await copyFile(projectMdPath, backupPath);
-    } catch (error) {
-      // File doesn't exist, no need to backup
-    }
-
-    // Backup config.json if exists
-    try {
-      await access(configJsonPath);
-      const backupPath = join(cwd, '.morph', 'config', `config.json.${timestamp}.backup`);
-      await copyFile(configJsonPath, backupPath);
-    } catch (error) {
-      // File doesn't exist, no need to backup
-    }
-  }
-}

package/src/generator/templates/config.json.template

@@ -1,40 +0,0 @@
-{
-  "$schema": "../schema/agent-schema.json",
-  "name": "{{name}}",
-  "type": "{{type}}",
-  "description": "{{description}}",
-  "stack": {
-    {{#if stack.frontend}}
-    "frontend": {
-      "tech": "{{stack.frontend.tech}}",
-      "version": "{{stack.frontend.version}}"{{#if stack.frontend.details}},
-      "details": "{{stack.frontend.details}}"{{/if}}
-    },
-    {{/if}}
-    "backend": {
-      "tech": "{{stack.backend.tech}}",
-      "version": "{{stack.backend.version}}"{{#if stack.backend.details}},
-      "details": "{{stack.backend.details}}"{{/if}}
-    }{{#if stack.database}},
-    "database": {
-      "tech": "{{stack.database.tech}}",
-      "version": "{{stack.database.version}}"{{#if stack.database.details}},
-      "details": "{{stack.database.details}}"{{/if}}
-    }{{/if}}{{#if stack.hosting}},
-    "hosting": "{{stack.hosting}}"{{/if}}
-  },
-  "architecture": "{{architecture}}",
-  "conventions": "{{conventions}}",
-  "infrastructure": {
-    "azure": {{hasAzure}},
-    "docker": {{hasDocker}},
-    "devops": {{hasDevOps}}
-  }{{#if repository}},
-  "repository": "{{repository}}"{{/if}},
-  "meta": {
-    "generatedBy": "morph-spec-cli",
-    "generatedAt": "{{generatedAt}}",
-    "llmConfidence": {{confidence}},
-    "autoDetected": true
-  }
-}

package/src/generator/templates/project.md.template

@@ -1,67 +0,0 @@
-# {{name}}
-
-> {{description}}
-
-## Stack
-
-| Component | Technology |
-|-----------|------------|
-{{#if stack.frontend}}
-| **Frontend** | {{stack.frontend.tech}} {{stack.frontend.version}}{{#if stack.frontend.details}} - {{stack.frontend.details}}{{/if}} |
-{{/if}}
-| **Backend** | {{stack.backend.tech}} {{stack.backend.version}}{{#if stack.backend.details}} - {{stack.backend.details}}{{/if}} |
-{{#if stack.database}}
-| **Database** | {{stack.database.tech}} {{stack.database.version}}{{#if stack.database.details}} - {{stack.database.details}}{{/if}} |
-{{/if}}
-{{#if stack.hosting}}
-| **Hosting** | {{stack.hosting}} |
-{{/if}}
-
-## Architecture
-
-**Pattern:** {{architecture}}
-
-{{projectStructure}}
-
-## Code Conventions
-
-{{conventions}}
-
-## Infrastructure
-
-{{#if hasAzure}}
-- ✅ **Azure** - Uses Azure infrastructure (Bicep files detected)
-{{else}}
-- ❌ **Azure** - No Azure resources detected
-{{/if}}
-
-{{#if hasDocker}}
-- ✅ **Docker** - Containerized (Dockerfile/docker-compose.yml detected)
-{{else}}
-- ❌ **Docker** - Not containerized
-{{/if}}
-
-{{#if hasDevOps}}
-- ✅ **CI/CD** - Pipelines detected
-{{else}}
-- ❌ **CI/CD** - No pipelines detected
-{{/if}}
-
-{{#if repository}}
-## Repository
-
-{{repository}}
-{{/if}}
-
-{{#if warnings.length}}
-## ⚠️ Warnings
-
-{{#each warnings}}
-- {{this}}
-{{/each}}
-{{/if}}
-
----
-
-*Auto-generated by MORPH-SPEC CLI on {{generatedAt}}*
-*LLM Confidence: {{confidence}}%*

package/src/lib/agents/micro-agent-factory.js

@@ -1,161 +0,0 @@
-/**
- * Micro Agent Factory — Create ultra-specialized agents
- *
- * Micro-agents are stripped-down versions of base agents with:
- * - Only the standards they need (1-3 files max)
- * - A single focused mission
- * - Minimal context overhead (~2-5K tokens vs 20-50K for full agent)
- *
- * Saved to: .morph/micro-agents/{name}.json
- */
-
-import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from 'fs';
-import { join } from 'path';
-
-const MICRO_AGENTS_DIR = join(process.cwd(), '.morph/micro-agents');
-const AGENTS_CONFIG = join(process.cwd(), '.morph/framework/agents.json');
-
-// ============================================================================
-// Agent Creation
-// ============================================================================
-
-/**
- * Create a micro-agent from a base agent with a standards subset
- * @param {Object} opts
- * @param {string} opts.name - Micro-agent name (e.g., 'jwt-validator')
- * @param {string} opts.baseAgent - Base agent ID (e.g., 'security-expert')
- * @param {string[]} opts.standards - Relevant standards file paths (1-3 files)
- * @param {string} opts.mission - Focused mission description
- * @param {string[]} [opts.tools] - Tools this micro-agent uses (default: minimal set)
- * @param {Object} [opts.constraints] - Additional constraints
- * @returns {Object} Micro-agent config object
- */
-export function createMicroAgent({ name, baseAgent, standards, mission, tools = null, constraints = {} }) {
-  if (!name || !baseAgent || !mission) {
-    throw new Error('name, baseAgent, and mission are required');
-  }
-
-  if (standards && standards.length > 5) {
-    throw new Error('Micro-agents should load at most 5 standards files (ideally 1-3)');
-  }
-
-  const baseAgentConfig = loadBaseAgent(baseAgent);
-
-  const microAgent = {
-    id: name,
-    type: 'micro-agent',
-    baseAgent,
-    createdAt: new Date().toISOString(),
-    mission,
-    tier: (baseAgentConfig?.tier || 3) + 1, // micro-agents are tier+1 (more specialized)
-    domain: baseAgentConfig?.domain || 'general',
-    standards: standards || [],
-    tools: tools || ['Read', 'Write', 'Edit'],
-    constraints: {
-      maxStandards: 3,
-      maxFiles: 10,
-      focusOnly: mission,
-      ...constraints
-    },
-    contextEstimate: {
-      standards: (standards || []).length * 2000,
-      overhead: 1500,
-      total: ((standards || []).length * 2000) + 1500
-    },
-    prompt: generateMicroAgentPrompt({ name, baseAgent, standards, mission, constraints, baseAgentConfig })
-  };
-
-  return microAgent;
-}
-
-/**
- * Save a micro-agent to disk
- * @param {Object} microAgent - Micro-agent config (from createMicroAgent)
- * @returns {string} Path to saved file
- */
-export function saveMicroAgent(microAgent) {
-  if (!existsSync(MICRO_AGENTS_DIR)) {
-    mkdirSync(MICRO_AGENTS_DIR, { recursive: true });
-  }
-
-  const filePath = join(MICRO_AGENTS_DIR, `${microAgent.id}.json`);
-  writeFileSync(filePath, JSON.stringify(microAgent, null, 2), 'utf8');
-  return filePath;
-}
-
-/**
- * List all micro-agents
- * @returns {Array} Array of micro-agent summaries
- */
-export function listMicroAgents() {
-  if (!existsSync(MICRO_AGENTS_DIR)) return [];
-
-  return readdirSync(MICRO_AGENTS_DIR)
-    .filter(f => f.endsWith('.json'))
-    .map(f => {
-      try {
-        const agent = JSON.parse(readFileSync(join(MICRO_AGENTS_DIR, f), 'utf8'));
-        return {
-          id: agent.id,
-          baseAgent: agent.baseAgent,
-          mission: agent.mission,
-          standards: agent.standards?.length || 0,
-          contextEstimate: agent.contextEstimate?.total || 0,
-          createdAt: agent.createdAt
-        };
-      } catch {
-        return null;
-      }
-    })
-    .filter(Boolean);
-}
-
-/**
- * Get a specific micro-agent
- * @param {string} name - Micro-agent name
- * @returns {Object|null} Micro-agent config or null
- */
-export function getMicroAgent(name) {
-  const filePath = join(MICRO_AGENTS_DIR, `${name}.json`);
-  if (!existsSync(filePath)) return null;
-  try {
-    return JSON.parse(readFileSync(filePath, 'utf8'));
-  } catch {
-    return null;
-  }
-}
-
-// ============================================================================
-// Helpers
-// ============================================================================
-
-function loadBaseAgent(agentId) {
-  if (!existsSync(AGENTS_CONFIG)) return null;
-  try {
-    const config = JSON.parse(readFileSync(AGENTS_CONFIG, 'utf8'));
-    return config.agents?.find(a => a.id === agentId) || null;
-  } catch {
-    return null;
-  }
-}
-
-function generateMicroAgentPrompt({ name, baseAgent, standards, mission, constraints, baseAgentConfig }) {
-  const standardsList = standards?.map(s => `- framework/standards/${s}`).join('\n') || '(none)';
-
-  return `You are a MICRO-AGENT: ${name}
-Base: ${baseAgent} (${baseAgentConfig?.description || 'specialist'})
-
-MISSION (single focus):
-${mission}
-
-STANDARDS TO LOAD (${standards?.length || 0} files):
-${standardsList}
-
-CONSTRAINTS:
-- Focus ONLY on your mission above
-- Do NOT load additional standards or context
-- Maximum ${constraints.maxFiles || 10} files to read/write
-- Report completion when done — do NOT start new tasks
-
-This is a minimal-context agent. Stay focused.`;
-}