@polymorphism-tech/morph-spec 4.3.3 → 4.3.5

package/src/commands/templates/template-show.js

@@ -76,15 +76,14 @@ export async function templateShowCommand(templateId, options) {
     // Resolve actual path
     if (options.showPath) {
       const projectPath = options.projectPath || process.cwd();
-      const stackId = options.stack || 'blazor-azure';
-      const resolvedPath = resolveTemplatePathById(templateId, projectPath, stackId);
+      const resolvedPath = resolveTemplatePathById(templateId, projectPath);
 
       logger.info(chalk.bold('📂 Resolved Path'));
       if (resolvedPath) {
         console.log(`  ${chalk.green(resolvedPath)}`);
         console.log(`  ${chalk.dim(`(${existsSync(resolvedPath) ? 'exists' : 'not found'})`)}`);
       } else {
-        console.log(`  ${chalk.red('Not found in framework/ or stack/')}`);
+        console.log(`  ${chalk.red('Not found in .morph/templates/ or framework/templates/')}`);
       }
       logger.blank();
     }
@@ -92,8 +91,7 @@ export async function templateShowCommand(templateId, options) {
     // Show template preview
     if (options.preview) {
       const projectPath = options.projectPath || process.cwd();
-      const stackId = options.stack || 'blazor-azure';
-      const resolvedPath = resolveTemplatePathById(templateId, projectPath, stackId);
+      const resolvedPath = resolveTemplatePathById(templateId, projectPath);
 
       if (resolvedPath && existsSync(resolvedPath)) {
         logger.info(chalk.bold('👁️  Preview (first 20 lines)'));

package/src/core/templates/template-registry.js

@@ -252,42 +252,28 @@ export function templateExists(templateId, projectPath = null) {
  * Get template absolute path with fallback logic.
  *
  * Resolution order:
- *   1. Stack-specific template (stacks/{stack}/.morph/templates/{path})
+ *   1. Project-local override (.morph/templates/{path})
  *   2. Framework universal template (framework/templates/{path})
  *
  * @param {string} templateId - Template identifier
  * @param {string} projectPath - Project root path
- * @param {string} [stackId] - Stack identifier (optional)
  * @returns {string|null} Absolute template path or null if not found
  */
-export function resolveTemplatePathById(templateId, projectPath, stackId = null) {
+export function resolveTemplatePathById(templateId, projectPath) {
   const template = getTemplateById(templateId, projectPath);
   if (!template) {
     return null;
   }
 
-  // If template is universal (framework location)
-  if (template.location === 'framework') {
-    const frameworkPath = join(projectPath, 'framework/templates', template.path);
-    return existsSync(frameworkPath) ? frameworkPath : null;
+  // 1. Project-local override
+  const projectLocalPath = join(projectPath, '.morph/templates', template.path);
+  if (existsSync(projectLocalPath)) {
+    return projectLocalPath;
   }
 
-  // If template is stack-specific
-  if (template.location === 'stack' && stackId) {
-    // Try stack-specific first
-    const stackPath = join(projectPath, 'stacks', stackId, '.morph/templates', template.path);
-    if (existsSync(stackPath)) {
-      return stackPath;
-    }
-
-    // Fallback to framework if exists
-    const frameworkPath = join(projectPath, 'framework/templates', template.path);
-    if (existsSync(frameworkPath)) {
-      return frameworkPath;
-    }
-  }
-
-  return null;
+  // 2. Framework universal template
+  const frameworkPath = join(projectPath, 'framework/templates', template.path);
+  return existsSync(frameworkPath) ? frameworkPath : null;
 }
 
 /**

package/src/lib/detectors/structure-detector.js

@@ -97,7 +97,7 @@ async function detectStack(projectPath) {
     ]
   };
 
-  const globIgnore = ['stacks/**', 'framework/**', 'test/**', 'node_modules/**', '.morph/**'];
+  const globIgnore = ['framework/**', 'test/**', 'node_modules/**', '.morph/**'];
 
   for (const [stack, globs] of Object.entries(patterns)) {
     for (const pattern of globs) {
@@ -115,7 +115,7 @@ async function detectStack(projectPath) {
  * Detect architecture pattern
  */
 async function detectArchitecture(projectPath) {
-  const globIgnore = ['stacks/**', 'framework/**', 'test/**', 'node_modules/**', '.morph/**'];
+  const globIgnore = ['framework/**', 'test/**', 'node_modules/**', '.morph/**'];
 
   const checks = [
     // .NET: Clean Architecture
@@ -209,7 +209,7 @@ async function detectUILibrary(projectPath) {
 async function detectPatterns(projectPath) {
   const patterns = [];
   // Ignore template/vendor directories; keep test/ accessible for JS test detection
-  const globIgnore = ['stacks/**', 'framework/**', 'test/fixtures/**', 'node_modules/**', '.morph/**'];
+  const globIgnore = ['framework/**', 'test/fixtures/**', 'node_modules/**', '.morph/**'];
 
   // C# / .NET patterns
   const dotnetChecks = [

package/src/lib/generators/context-generator.js

@@ -13,6 +13,21 @@
 
 import fs from 'fs/promises';
 import path from 'path';
+import { existsSync } from 'fs';
+
+/**
+ * Resolve a template path: check .morph/templates/ first, then framework/templates/.
+ * @param {string} projectPath
+ * @param {string} templatePath - relative path e.g. 'context/CONTEXT.md'
+ * @returns {string|null}
+ */
+function resolveTemplatePath(projectPath, templatePath) {
+  const projectLocal = path.join(projectPath, '.morph/templates', templatePath);
+  if (existsSync(projectLocal)) return projectLocal;
+  const framework = path.join(projectPath, 'framework/templates', templatePath);
+  if (existsSync(framework)) return framework;
+  return null;
+}
 
 /**
  * Load project state from state.json
@@ -50,8 +65,7 @@ async function loadConfig(projectPath) {
  * @returns {Promise<Object>} Parsed agents config
  */
 async function loadAgents(projectPath) {
-  const { resolveAgentsConfigPath } = await import('../stacks/stack-resolver.js');
-  const agentsPath = resolveAgentsConfigPath(projectPath);
+  const agentsPath = path.join(projectPath, '.morph/config/agents.json');
   try {
     const content = await fs.readFile(agentsPath, 'utf8');
     return JSON.parse(content);
@@ -179,8 +193,7 @@ export async function generateProjectContext(projectPath) {
     loadProjectStandards(projectPath)
   ]);
 
-  // Load template with fallback (stack-specific → framework universal)
-  const { resolveTemplatePath } = await import('../stacks/stack-resolver.js');
+  // Load template with fallback (.morph/templates/ → framework/templates/)
   const templatePath = resolveTemplatePath(projectPath, 'context/CONTEXT.md');
 
   if (!templatePath) {
@@ -351,8 +364,7 @@ export async function generateFeatureContext(projectPath, featureName) {
     // No tasks.json yet
   }
 
-  // Load template with fallback (stack-specific → framework universal)
-  const { resolveTemplatePath } = await import('../stacks/stack-resolver.js');
+  // Load template with fallback (.morph/templates/ → framework/templates/)
   const featureTemplatePath = resolveTemplatePath(projectPath, 'context/CONTEXT-FEATURE.md');
 
   if (!featureTemplatePath) {

package/src/lib/hooks/hook-executor.js

@@ -20,8 +20,6 @@ import { join } from 'path';
 function loadAgents(projectPath) {
   const agentPaths = [
     join(projectPath, '.morph/config/agents.json'),
-    join(projectPath, 'stacks/blazor-azure/.morph/config/agents.json'),
-    join(projectPath, 'stacks/nextjs-supabase/.morph/config/agents.json'),
   ];
 
   const allAgents = {};

package/src/lib/orchestration/team-orchestrator.js

@@ -13,7 +13,6 @@
 import fs from 'fs/promises';
 import path from 'path';
 import { fileURLToPath } from 'url';
-import { resolveAgentsConfigPath } from '../stacks/stack-resolver.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -24,7 +23,7 @@ const __dirname = path.dirname(__filename);
  * @returns {Promise<Object>} Parsed agents configuration
  */
 async function loadAgentsConfig(projectPath) {
-  const agentsPath = resolveAgentsConfigPath(projectPath);
+  const agentsPath = path.join(projectPath, '.morph/config/agents.json');
   const content = await fs.readFile(agentsPath, 'utf8');
   return JSON.parse(content);
 }

package/src/lib/standards/standards-context-injector.js

@@ -9,7 +9,6 @@
 
 import { readFileSync, existsSync } from 'fs';
 import { join } from 'path';
-import { resolveStandardsDir } from '../stacks/stack-resolver.js';
 
 /**
  * Agent → Standards mapping
@@ -202,8 +201,8 @@ function loadStandard(standardName, projectPath) {
   const locations = [
     // 1. Project override
     join(projectPath, '.morph/project/standards', `${standardName}.md`),
-    // 2. Stack standards (for stack-specific overrides like azure.md, passkeys-auth.md)
-    join(resolveStandardsDir(projectPath), `${standardName}.md`),
+    // 2. Project-level standards (.morph/standards/)
+    join(projectPath, '.morph/standards', `${standardName}.md`),
     // 3. Framework standards (hierarchical structure: core/, backend/, frontend/, infrastructure/)
     join(projectPath, 'framework/standards', `${standardName}.md`)
   ];
@@ -284,7 +283,7 @@ export function getStandardsListForAgent(agentId) {
 export function checkStandardExists(standardName, projectPath = '.') {
   const locations = [
     { type: 'project', path: join(projectPath, '.morph/project/standards', `${standardName}.md`) },
-    { type: 'stack', path: join(resolveStandardsDir(projectPath), `${standardName}.md`) },
+    { type: 'morph', path: join(projectPath, '.morph/standards', `${standardName}.md`) },
     { type: 'framework', path: join(projectPath, 'framework/standards', `${standardName}.md`) }
   ];
 

package/src/lib/troubleshooting/troubleshoot-grep.js

@@ -6,25 +6,19 @@
 import { readFileSync, readdirSync, existsSync } from 'fs';
 import { join, dirname, basename } from 'path';
 import { fileURLToPath } from 'url';
-import { resolveStandardsDir } from '../stacks/stack-resolver.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
-const frameworkRoot = join(__dirname, '..', '..');
 
-// Directories to search (stack standards resolved dynamically)
+// Directories to search
 const SEARCH_PATHS = [
   'framework/standards',
+  '.morph/standards',
   '.wiki'
 ];
 
 function getSearchPaths(basePath) {
-  const paths = [...SEARCH_PATHS];
-  // Insert resolved stack standards path
-  const stackStandards = resolveStandardsDir(basePath || frameworkRoot);
-  const relativePath = stackStandards.replace(basePath || frameworkRoot, '').replace(/^[\\/]/, '');
-  paths.splice(1, 0, relativePath);
-  return paths;
+  return SEARCH_PATHS;
 }
 
 /**

package/src/lib/validators/validation-runner.js

@@ -11,7 +11,6 @@ import { existsSync, readFileSync } from 'fs';
 import { join } from 'path';
 import chalk from 'chalk';
 import { loadState } from '../../core/state/state-manager.js';
-import { resolveAgentsConfigPath } from '../stacks/stack-resolver.js';
 
 /**
  * Load agent → validators map from agents.json (data-driven)
@@ -20,7 +19,7 @@ import { resolveAgentsConfigPath } from '../stacks/stack-resolver.js';
  */
 function loadAgentValidatorMap(projectPath) {
   try {
-    const agentsPath = resolveAgentsConfigPath(projectPath);
+    const agentsPath = join(projectPath, '.morph/config/agents.json');
     const agentsConfig = JSON.parse(readFileSync(agentsPath, 'utf8'));
 
     const map = {};

package/src/utils/file-copier.js

@@ -1,7 +1,6 @@
 import fs from 'fs-extra';
 import { join, dirname, resolve } from 'path';
 import { fileURLToPath } from 'url';
-import { resolveStackPath } from '../lib/stacks/stack-resolver.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const frameworkRoot = join(__dirname, '..', '..');
@@ -11,7 +10,7 @@ function isSamePath(a, b) {
 }
 
 export function getContentDir() {
-  return resolveStackPath(frameworkRoot);
+  return frameworkRoot;
 }
 
 export async function copyDirectory(src, dest, options = {}) {

package/docs/README.md

@@ -1,144 +0,0 @@
-# MORPH-SPEC API Documentation
-
-This directory contains the API documentation for MORPH-SPEC Framework libraries.
-
-## Available Documentation
-
-### API Reference (`/api`)
-
-Comprehensive API documentation generated from JSDoc comments in the source code.
-
-**Libraries Documented:**
-- **state-manager** - Feature state management, agents, checkpoints, outputs tracking
-- **design-system-generator** - UI design system parsing and theme generation
-
-**View Documentation:**
-- Open `api/index.html` in your browser
-- Or run `npm run docs:serve` to start a local server at http://localhost:8080
-
-## Running Tests
-
-### Run Tests
-
-```bash
-npm test
-```
-
-Runs all 85 unit tests with 100% pass rate.
-
-### Run Tests with Coverage
-
-```bash
-npm run test:coverage
-```
-
-Generates coverage report (HTML + text + lcov). **Current coverage: 98.03%**
-
-- **Statements:** 98.03%
-- **Branches:** 88.74%
-- **Functions:** 100%
-- **Lines:** 98.03%
-
-Coverage reports are generated in `coverage/` directory.
-
-### Coverage Summary Only
-
-```bash
-npm run test:coverage:summary
-```
-
-Shows text summary without generating HTML report.
-
-## Generating Documentation
-
-### Build API Docs
-
-```bash
-npm run docs
-```
-
-Generates HTML documentation from JSDoc comments in `src/lib/` to `docs/api/`.
-
-### Watch Mode
-
-```bash
-npm run docs:watch
-```
-
-Automatically regenerates documentation when source files change.
-
-### Serve Locally
-
-```bash
-npm run docs:serve
-```
-
-Starts a local HTTP server at http://localhost:8080 to view documentation.
-
-## Documentation Standards
-
-### JSDoc Format
-
-All library functions in `src/lib/` use JSDoc comments with:
-
-- **@param** - Parameter descriptions with types
-- **@returns** - Return value description with type
-- **@throws** - Exceptions that may be thrown
-- **@example** - Usage examples (when applicable)
-
-**Example:**
-
-```javascript
-/**
- * Get feature from state
- * @param {string} featureName - Feature name
- * @returns {Object|null} Feature object or null
- */
-export function getFeature(featureName) {
-  // Implementation
-}
-```
-
-### Module-Level Documentation
-
-Each library file starts with a block comment describing:
-
-- Purpose and responsibilities
-- Usage context (CLI commands, internal automation)
-- Key features
-
-**Example:**
-
-```javascript
-/**
- * MORPH-SPEC State Manager Library
- *
- * Manages state.json for tracking features, progress, agents, and checkpoints.
- * Used both by CLI commands and internal automation.
- */
-```
-
-## Updating Documentation
-
-1. **Update JSDoc comments** in source files (`src/lib/*.js`)
-2. **Regenerate docs:** `npm run docs`
-3. **Review:** Open `docs/api/index.html`
-4. **Commit:** Include updated `docs/api/` in your commit
-
-## Template
-
-Documentation is generated using the [docdash](https://github.com/clenemt/docdash) template for JSDoc, configured in `jsdoc.json`.
-
-**Features:**
-- Clean, modern design
-- Full-text search
-- Responsive layout
-- Syntax highlighting
-- Type definitions
-- Source code links
-
-## Links
-
-- **GitHub:** https://github.com/lucasPolymorphism/morph-spec-framework
-- **npm:** https://www.npmjs.com/package/@polymorphism-tech/morph-spec
-- **Website:** https://polymorphism.com.br/morph-spec