@polymorphism-tech/morph-spec 4.10.9 → 4.11.0

package/src/lib/stack-filter.js

@@ -1,65 +1,65 @@
-/**
- * Parse `stacks:` from YAML frontmatter content.
- * Returns ['*'] if no stacks field found (backwards compatible — always install).
- *
- * Supports:
- *   stacks:\n  - dotnet\n  - blazor   (YAML list)
- *   stacks: [dotnet, blazor]           (inline array)
- *
- * @param {string} content - Raw file content with YAML frontmatter
- * @returns {string[]}
- */
-export function parseStacks(content) {
-  const normalized = content.replace(/\r\n/g, '\n');
-  const fmMatch = normalized.match(/^---\n([\s\S]*?)\n---/);
-  if (!fmMatch) return ['*'];
-
-  const fm = fmMatch[1];
-
-  // Try inline format: stacks: [dotnet, blazor]
-  const inlineMatch = fm.match(/^stacks:\s*\[([^\]]*)\]/m);
-  if (inlineMatch) {
-    const items = inlineMatch[1].split(',').map(s => s.trim()).filter(Boolean);
-    return items.length > 0 ? items : ['*'];
-  }
-
-  // Try YAML list format: stacks:\n  - dotnet\n  - blazor
-  const listMatch = fm.match(/^stacks:\s*\n((?:\s+-\s+.+\n?)*)/m);
-  if (listMatch) {
-    const items = listMatch[1]
-      .split('\n')
-      .map(line => line.replace(/^\s+-\s+/, '').replace(/["']/g, '').trim())
-      .filter(Boolean);
-    return items.length > 0 ? items : ['*'];
-  }
-
-  return ['*'];
-}
-
-/**
- * Extract project tags from config object.
- * Combines stack tags (from `project.stack` split by '-' or '+')
- * with integration tags (from `project.integrations` array).
- * Deduplicates the result.
- */
-export function getProjectTags(config) {
-  const stack = config?.project?.stack;
-  const stackTags = (stack && typeof stack === 'string')
-    ? stack.split(/[-+]/).filter(Boolean)
-    : [];
-  const integrations = Array.isArray(config?.project?.integrations)
-    ? config.project.integrations
-    : [];
-  return [...new Set([...stackTags, ...integrations])];
-}
-
-/**
- * Determine if an asset should be installed for the given project tags.
- * - stacks includes '*' → always install
- * - stacks is empty → treat as '*' (backwards compatible)
- * - Otherwise → install if intersection with projectTags is non-empty
- */
-export function shouldInstall(assetStacks, projectTags) {
-  if (assetStacks.length === 0 || assetStacks.includes('*')) return true;
-  return assetStacks.some(s => projectTags.includes(s));
-}
+/**
+ * Parse `stacks:` from YAML frontmatter content.
+ * Returns ['*'] if no stacks field found (backwards compatible — always install).
+ *
+ * Supports:
+ *   stacks:\n  - dotnet\n  - blazor   (YAML list)
+ *   stacks: [dotnet, blazor]           (inline array)
+ *
+ * @param {string} content - Raw file content with YAML frontmatter
+ * @returns {string[]}
+ */
+export function parseStacks(content) {
+  const normalized = content.replace(/\r\n/g, '\n');
+  const fmMatch = normalized.match(/^---\n([\s\S]*?)\n---/);
+  if (!fmMatch) return ['*'];
+
+  const fm = fmMatch[1];
+
+  // Try inline format: stacks: [dotnet, blazor]
+  const inlineMatch = fm.match(/^stacks:\s*\[([^\]]*)\]/m);
+  if (inlineMatch) {
+    const items = inlineMatch[1].split(',').map(s => s.trim()).filter(Boolean);
+    return items.length > 0 ? items : ['*'];
+  }
+
+  // Try YAML list format: stacks:\n  - dotnet\n  - blazor
+  const listMatch = fm.match(/^stacks:\s*\n((?:\s+-\s+.+\n?)*)/m);
+  if (listMatch) {
+    const items = listMatch[1]
+      .split('\n')
+      .map(line => line.replace(/^\s+-\s+/, '').replace(/["']/g, '').trim())
+      .filter(Boolean);
+    return items.length > 0 ? items : ['*'];
+  }
+
+  return ['*'];
+}
+
+/**
+ * Extract project tags from config object.
+ * Combines stack tags (from `project.stack` split by '-' or '+')
+ * with integration tags (from `project.integrations` array).
+ * Deduplicates the result.
+ */
+export function getProjectTags(config) {
+  const stack = config?.project?.stack;
+  const stackTags = (stack && typeof stack === 'string')
+    ? stack.split(/[-+]/).filter(Boolean)
+    : [];
+  const integrations = Array.isArray(config?.project?.integrations)
+    ? config.project.integrations
+    : [];
+  return [...new Set([...stackTags, ...integrations])];
+}
+
+/**
+ * Determine if an asset should be installed for the given project tags.
+ * - stacks includes '*' → always install
+ * - stacks is empty → treat as '*' (backwards compatible)
+ * - Otherwise → install if intersection with projectTags is non-empty
+ */
+export function shouldInstall(assetStacks, projectTags) {
+  if (assetStacks.length === 0 || assetStacks.includes('*')) return true;
+  return assetStacks.some(s => projectTags.includes(s));
+}

package/src/lib/standards/digest-builder.js

@@ -17,12 +17,16 @@
 import { readFileSync, existsSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
+import { shouldInstall, getProjectTags } from '../../lib/stack-filter.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
 const AGENTS_JSON_PATH = join(__dirname, '../../../framework/agents.json');
 const STANDARDS_JSON_PATH = join(__dirname, '../../../framework/standards/STANDARDS.json');
 
+/** Token budget threshold — warn if briefing exceeds this */
+const TOKEN_BUDGET_THRESHOLD = 8000;
+
 let _agentsCache = null;
 let _standardsCache = null;
 
@@ -65,6 +69,34 @@ function loadStandards() {
   }
 }
 
+/**
+ * Load project config.json from .morph/config.json.
+ *
+ * @param {string} [projectPath] - Override project path (defaults to cwd)
+ * @returns {Object|null}
+ */
+function loadProjectConfig(projectPath) {
+  const configPath = join(projectPath || process.cwd(), '.morph', 'config.json');
+  try {
+    if (!existsSync(configPath)) return null;
+    return JSON.parse(readFileSync(configPath, 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Estimate token count for a text string.
+ * Uses ~4 chars/token heuristic (conservative for English + code).
+ *
+ * @param {string} text
+ * @returns {number}
+ */
+export function estimateTokens(text) {
+  if (!text) return 0;
+  return Math.ceil(text.length / 4);
+}
+
 // ─────────────────────────────────────────────────────────────────────────────
 // Helpers
 // ─────────────────────────────────────────────────────────────────────────────
@@ -149,13 +181,15 @@ function formatBriefingLine(entry, priority, anchor) {
 /**
  * Build an agent briefing string for injection into taskPrompt.
  * Returns empty string when agent not found, has no standards, or all refs
- * are filtered by scope.
+ * are filtered by scope or stack.
  *
  * @param {string} agentId - Agent ID from agents.json
  * @param {string} phase - Current phase (design|tasks|implement)
+ * @param {Object} [opts] - Options
+ * @param {string} [opts.projectPath] - Override project path (defaults to cwd)
  * @returns {string} Formatted briefing or ''
  */
-export function buildAgentBriefing(agentId, phase) {
+export function buildAgentBriefing(agentId, phase, opts = {}) {
   const agents = loadAgents();
   const agentData = agents.agents?.[agentId];
   if (!agentData) return '';
@@ -164,6 +198,11 @@ export function buildAgentBriefing(agentId, phase) {
   if (standardsRefs.length === 0) return '';
 
   const standards = loadStandards();
+
+  // Load project tags for stack filtering
+  const config = loadProjectConfig(opts.projectPath);
+  const projectTags = config ? getProjectTags(config) : [];
+
   const lines = [];
 
   for (const rawRef of standardsRefs) {
@@ -180,11 +219,26 @@ export function buildAgentBriefing(agentId, phase) {
       continue;
     }
 
+    // Stack filtering: skip standards not relevant to this project's stack
+    if (projectTags.length > 0 && !shouldInstall(entry.stacks || ['*'], projectTags)) continue;
+
     const line = formatBriefingLine(entry, ref.priority, ref.anchor);
     if (line) lines.push(line);
   }
 
-  return lines.length > 0 ? lines.join('\n') : '';
+  const briefing = lines.length > 0 ? lines.join('\n') : '';
+
+  // Token budget warning
+  if (briefing) {
+    const tokens = estimateTokens(briefing);
+    if (tokens > TOKEN_BUDGET_THRESHOLD) {
+      process.stderr.write(
+        `[digest-builder] Warning: briefing for agent '${agentId}' is ~${tokens} tokens (threshold: ${TOKEN_BUDGET_THRESHOLD})\n`
+      );
+    }
+  }
+
+  return briefing;
 }
 
 /**

package/src/lib/standards/index.js

@@ -1,7 +1,7 @@
-/**
- * Standards Utilities
- *
- * Injects relevant coding standards and architectural guidelines into LLM context.
- */
-
-export * from './standards-context-injector.js';
+/**
+ * Standards Utilities
+ *
+ * Injects relevant coding standards and architectural guidelines into LLM context.
+ */
+
+export * from './standards-context-injector.js';