@chrisdudek/yg 2.4.0 → 2.5.0

package/dist/bin.js

@@ -45,6 +45,7 @@ quality:
   context_budget:
     warning: 10000
     error: 20000
+    own_warning: 5000
 `;
 
 // src/templates/platform.ts
@@ -160,6 +161,7 @@ You have broken Yggdrasil if you do any of the following:
 - \u274C Placed a cross-cutting requirement in a local artifact instead of an aspect, or used an aspect id with no \`aspects/\` directory.
 - \u274C Invented a rationale, business rule, or decision \u2014 or recorded a decision without documenting rejected alternatives and rationale (use "rationale: unknown" if unknown).
 - \u274C Used blackbox coverage for greenfield (new) code.
+- \u274C Deleted or shortened graph artifact content to reduce context package size instead of splitting the node.
 
 ### Escape Hatch
 
@@ -347,7 +349,8 @@ When reviewing graph quality (triggered by user or quality improvement):
 
 - **\`yg\` not found** \u2192 inform user: "yg CLI is not installed or not in PATH." Stop.
 - **Unfixable validate errors** \u2192 if not resolved after 3 attempts, stop and report to user. Do not loop.
-- **Budget exceeded** \u2192 if \`yg build-context\` exits with error (context package exceeds budget), warn user: "This node should be split." Do not proceed with implementation.
+- **Budget warning (W005/W006)** \u2192 informational. \`yg validate\` shows a breakdown (own/hierarchy/aspects/flows/dependencies). Large inherited context means the system is complex \u2014 this is not a problem to fix, it is reality to acknowledge. Do not delete knowledge from artifacts. Do not attempt to "reduce" inherited context.
+- **Own budget warning (W015)** \u2192 own artifacts are large. Consider splitting this node's responsibilities into child nodes. Redistribute knowledge across children so total knowledge is preserved or increased, never reduced.
 - **Corrupted \`.yggdrasil/\` files** \u2192 report to user. Do not attempt repair.
 - **Incremental sync** \u2192 run \`yg drift-sync\` every 3-5 source files during multi-file tasks. Do not defer to end.`;
 var KNOWLEDGE_BASE = `## KNOWLEDGE BASE
@@ -1183,7 +1186,7 @@ import { parse as parseYaml3 } from "yaml";
 var DEFAULT_QUALITY = {
   min_artifact_length: 50,
   max_direct_relations: 10,
-  context_budget: { warning: 1e4, error: 2e4 }
+  context_budget: { warning: 1e4, error: 2e4, own_warning: void 0 }
 };
 async function parseConfig(filePath) {
   const content = await readFile5(filePath, "utf-8");
@@ -1248,7 +1251,8 @@ async function parseConfig(filePath) {
     max_direct_relations: qualityRaw.max_direct_relations ?? DEFAULT_QUALITY.max_direct_relations,
     context_budget: {
       warning: qualityRaw.context_budget?.warning ?? DEFAULT_QUALITY.context_budget.warning,
-      error: qualityRaw.context_budget?.error ?? DEFAULT_QUALITY.context_budget.error
+      error: qualityRaw.context_budget?.error ?? DEFAULT_QUALITY.context_budget.error,
+      own_warning: qualityRaw.context_budget?.own_warning
     }
   } : DEFAULT_QUALITY;
   if (quality.context_budget.error < quality.context_budget.warning) {
@@ -1256,6 +1260,9 @@ async function parseConfig(filePath) {
       `yg-config.yaml: quality.context_budget.error (${quality.context_budget.error}) must be >= warning (${quality.context_budget.warning})`
     );
   }
+  if (quality.context_budget.own_warning !== void 0 && quality.context_budget.own_warning <= 0) {
+    throw new Error("quality.context_budget.own_warning must be a positive number");
+  }
   return {
     version,
     name: raw.name.trim(),
@@ -2043,6 +2050,77 @@ function collectAncestors(node) {
   }
   return ancestors;
 }
+function collectDependencyAncestors(target, config, graph) {
+  const ancestors = collectAncestors(target);
+  const structuralFilenames = Object.entries(config.artifacts ?? {}).filter(([, c]) => c.included_in_relations).map(([filename]) => filename);
+  const configArtifactKeys = [...Object.keys(config.artifacts ?? {})];
+  return ancestors.map((ancestor) => {
+    const nodeAspects = (ancestor.meta.aspects ?? []).map((a) => a.aspect);
+    const expanded = expandAspects(nodeAspects, graph.aspects);
+    const filterFilenames = structuralFilenames.length > 0 ? structuralFilenames : configArtifactKeys;
+    const availableFiles = filterFilenames.filter(
+      (f) => ancestor.artifacts.some((a) => a.filename === f)
+    );
+    return {
+      path: ancestor.path,
+      name: ancestor.meta.name,
+      type: ancestor.meta.type,
+      aspects: expanded,
+      artifactFilenames: availableFiles
+    };
+  });
+}
+function computeBudgetBreakdown(pkg2, graph) {
+  let own = 0;
+  let hierarchy = 0;
+  let aspects = 0;
+  let flows = 0;
+  let relational = 0;
+  for (const layer of pkg2.layers) {
+    const tokens = estimateTokens(layer.content);
+    switch (layer.type) {
+      case "global":
+      case "own":
+        own += tokens;
+        break;
+      case "hierarchy":
+        hierarchy += tokens;
+        break;
+      case "aspects":
+        aspects += tokens;
+        break;
+      case "flows":
+        flows += tokens;
+        break;
+      case "relational":
+        relational += tokens;
+        break;
+    }
+  }
+  let depAncestorTokens = 0;
+  const node = graph.nodes.get(pkg2.nodePath);
+  if (node) {
+    const ancestorPaths = new Set(collectAncestors(node).map((a) => a.path));
+    for (const relation of node.meta.relations ?? []) {
+      const target = graph.nodes.get(relation.target);
+      if (!target || ancestorPaths.has(relation.target)) continue;
+      const depAncestors = collectDependencyAncestors(target, graph.config, graph);
+      for (const anc of depAncestors) {
+        const ancNode = graph.nodes.get(anc.path);
+        if (!ancNode) continue;
+        for (const filename of anc.artifactFilenames) {
+          const art = ancNode.artifacts.find((a) => a.filename === filename);
+          if (art) {
+            depAncestorTokens += estimateTokens(art.content);
+          }
+        }
+      }
+    }
+  }
+  const dependencies = relational + depAncestorTokens;
+  const total = own + hierarchy + aspects + flows + dependencies;
+  return { own, hierarchy, aspects, flows, dependencies, total };
+}
 function toContextMapOutput(pkg2, graph) {
   const node = graph.nodes.get(pkg2.nodePath);
   const config = graph.config;
@@ -2091,11 +2169,12 @@ function toContextMapOutput(pkg2, graph) {
     depRefs.push(ref);
   }
   const registry = buildArtifactRegistry(node, ancestors, depRefs, graph);
+  const breakdown = computeBudgetBreakdown(pkg2, graph);
   const warningThreshold = config.quality?.context_budget?.warning ?? 1e4;
   const errorThreshold = config.quality?.context_budget?.error ?? 2e4;
-  const budgetStatus = pkg2.tokenCount >= errorThreshold ? "error" : pkg2.tokenCount >= warningThreshold ? "warning" : "ok";
+  const budgetStatus = breakdown.total >= errorThreshold ? "severe" : breakdown.total >= warningThreshold ? "warning" : "ok";
   return {
-    meta: { tokenCount: pkg2.tokenCount, budgetStatus },
+    meta: { tokenCount: breakdown.total, budgetStatus, breakdown },
     project: config.name,
     node: {
       path: pkg2.nodePath,
@@ -2960,26 +3039,42 @@ async function checkAnchorPresence(graph) {
 }
 async function checkContextBudget(graph) {
   const issues = [];
-  const warningThreshold = graph.config.quality?.context_budget.warning ?? 1e4;
-  const errorThreshold = graph.config.quality?.context_budget.error ?? 2e4;
-  for (const [nodePath, node] of graph.nodes) {
+  const budget = graph.config.quality?.context_budget ?? { warning: 1e4, error: 2e4 };
+  const warningThreshold = budget.warning;
+  const errorThreshold = budget.error;
+  const ownWarningThreshold = budget.own_warning;
+  for (const [nodePath] of graph.nodes) {
+    const node = graph.nodes.get(nodePath);
     if (node.meta.blackbox) continue;
     try {
       const pkg2 = await buildContext(graph, nodePath);
-      if (pkg2.tokenCount >= errorThreshold) {
+      const breakdown = computeBudgetBreakdown(pkg2, graph);
+      const breakdownLine = `own: ${breakdown.own.toLocaleString()} (${pct(breakdown.own, breakdown.total)}) | hierarchy: ${breakdown.hierarchy.toLocaleString()} (${pct(breakdown.hierarchy, breakdown.total)}) | aspects: ${breakdown.aspects.toLocaleString()} (${pct(breakdown.aspects, breakdown.total)}) | flows: ${breakdown.flows.toLocaleString()} (${pct(breakdown.flows, breakdown.total)}) | dependencies: ${breakdown.dependencies.toLocaleString()} (${pct(breakdown.dependencies, breakdown.total)})`;
+      if (breakdown.total >= errorThreshold) {
         issues.push({
           severity: "warning",
           code: "W006",
           rule: "budget-error",
-          message: `Context is ${pkg2.tokenCount.toLocaleString()} tokens (error threshold: ${errorThreshold.toLocaleString()}) \u2014 blocks materialization, node must be split`,
+          message: `Context is ${breakdown.total.toLocaleString()} tokens (error threshold: ${errorThreshold.toLocaleString()}).
+     ${breakdownLine}`,
           nodePath
         });
-      } else if (pkg2.tokenCount >= warningThreshold) {
+      } else if (breakdown.total >= warningThreshold) {
         issues.push({
           severity: "warning",
           code: "W005",
           rule: "budget-warning",
-          message: `Context is ${pkg2.tokenCount.toLocaleString()} tokens (warning threshold: ${warningThreshold.toLocaleString()}). Consider splitting the node or reducing dependencies.`,
+          message: `Context is ${breakdown.total.toLocaleString()} tokens (warning threshold: ${warningThreshold.toLocaleString()}).
+     ${breakdownLine}`,
+          nodePath
+        });
+      }
+      if (ownWarningThreshold !== void 0 && breakdown.own >= ownWarningThreshold) {
+        issues.push({
+          severity: "warning",
+          code: "W015",
+          rule: "own-budget-warning",
+          message: `Own artifacts: ${breakdown.own.toLocaleString()} tokens (threshold: ${ownWarningThreshold.toLocaleString()}). Consider splitting this node's responsibilities into child nodes.`,
           nodePath
         });
       }
@@ -2988,6 +3083,10 @@ async function checkContextBudget(graph) {
   }
   return issues;
 }
+function pct(value, total) {
+  if (total === 0) return "0%";
+  return `${Math.round(value / total * 100)}%`;
+}
 
 // src/cli/build-context.ts
 function collectRelevantNodePaths(graph, nodePath) {
@@ -4319,7 +4418,8 @@ async function runSimulation(graph, nodePaths, targetNodePath) {
   for (const dep of nodePaths) {
     try {
       const pkg2 = await buildContext(graph, dep);
-      const status = pkg2.tokenCount >= budget.error ? "error" : pkg2.tokenCount >= budget.warning ? "warning" : "ok";
+      const breakdown = computeBudgetBreakdown(pkg2, graph);
+      const status = breakdown.total >= budget.error ? "severe" : breakdown.total >= budget.warning ? "warning" : "ok";
       let baselineTokens = null;
       if (baselineGraph?.nodes.has(dep)) {
         try {
@@ -4333,8 +4433,8 @@ async function runSimulation(graph, nodePaths, targetNodePath) {
       );
       const changedLine = hasDepOnTarget ? `  + Changed dependency interface: ${targetNodePath}
 ` : "";
-      const budgetLine = baselineTokens !== null ? `  Budget: ${baselineTokens} -> ${pkg2.tokenCount} tokens (${status})
-` : `  Budget: ${pkg2.tokenCount} tokens (${status})
+      const budgetLine = baselineTokens !== null ? `  Budget: ${baselineTokens} -> ${breakdown.total} tokens (${status})
+` : `  Budget: ${breakdown.total} tokens (${status})
 `;
       const driftEntry = driftByNode.get(dep);
       const driftLine = driftEntry && driftEntry.status !== "ok" ? `  Mapped files (on-disk): ${driftEntry.status}${driftEntry.details ? ` (${driftEntry.details})` : ""}