@toolbaux/guardian 0.1.5 → 0.1.7

package/dist/commands/context.js

@@ -12,11 +12,20 @@ export async function runContext(options) {
         loadArchitectureDiff(inputDir),
         loadHeatmap(inputDir)
     ]);
+    // Load structural intelligence if available
+    let si;
+    try {
+        const siPath = path.join(inputDir, "structural-intelligence.json");
+        const siRaw = await fs.readFile(siPath, "utf8");
+        si = JSON.parse(siRaw);
+    }
+    catch { /* not available */ }
     const content = renderContextBlock(architecture, ux, {
         focusQuery: options.focus,
         maxLines: normalizeMaxLines(options.maxLines),
         diff,
-        heatmap
+        heatmap,
+        structuralIntelligence: si
     });
     if (!options.output) {
         console.log(content);

package/dist/commands/generate.js

@@ -144,7 +144,7 @@ function renderAiContextMarkdown(architecture, ux, options) {
     }
     lines.push(renderContextBlock(architecture, ux, {
         focusQuery: options?.focusQuery,
-        maxLines: options?.maxLines ?? 80,
+        maxLines: options?.maxLines ?? 200,
         structuralIntelligence: options?.structuralIntelligence
     }));
     lines.push("");

package/dist/extract/context-block.js

@@ -8,7 +8,36 @@ export function renderContextBlock(architecture, ux, options) {
     lines.push("");
     lines.push(`**Backend:** ${ormModels.length} ORM models + ${schemaModels} schemas · ${architecture.endpoints.length} endpoints · ${architecture.modules.length} modules`);
     lines.push(`**Frontend:** ${ux.components.length} components · ${ux.pages.length} pages`);
+    // Show all roots if multi-root project
+    const roots = architecture.project.roots;
+    if (roots && roots.length > 2) {
+        lines.push(`**Roots:** ${roots.join(", ")}`);
+    }
     lines.push("");
+    // Module map with key exports — the most useful section for AI context
+    const modulesWithExports = architecture.modules.filter(m => m.exports.length > 0 || m.files.length > 0);
+    if (modulesWithExports.length > 0) {
+        lines.push("### Module Map");
+        for (const mod of modulesWithExports) {
+            const allSymbols = mod.exports.flatMap(e => e.symbols).filter(Boolean);
+            const topSymbols = allSymbols.slice(0, 6);
+            const symbolStr = topSymbols.length > 0
+                ? ` — exports: ${topSymbols.join(", ")}${allSymbols.length > 6 ? ` (+${allSymbols.length - 6} more)` : ""}`
+                : ` — ${mod.files.length} files`;
+            const epCount = mod.endpoints.length > 0 ? ` · ${mod.endpoints.length} endpoints` : "";
+            lines.push(`- **${mod.id}** (${mod.layer})${epCount}${symbolStr}`);
+        }
+        lines.push("");
+    }
+    // Cross-module dependencies
+    const crossEdges = architecture.dependencies.module_graph.filter(e => e.from !== e.to);
+    if (crossEdges.length > 0) {
+        lines.push("### Module Dependencies");
+        for (const edge of crossEdges.slice(0, 10)) {
+            lines.push(`- ${edge.from} → ${edge.to}`);
+        }
+        lines.push("");
+    }
     const couplingFiles = pickTopCouplingFiles(architecture, options?.heatmap, 5);
     if (couplingFiles.length > 0) {
         lines.push("### High-Coupling Files");
@@ -102,12 +131,29 @@ export function renderContextBlock(architecture, ux, options) {
             lines.push("");
         }
     }
-    lines.push("<!-- /guardian:context -->");
-    const maxLines = options?.maxLines ?? 120;
-    if (lines.length <= maxLines) {
-        return lines.join("\n");
+    // Deep intelligence pointers — tell AI agents where to find more detail
+    lines.push("### Deep Intelligence");
+    lines.push("");
+    lines.push("The above is a summary. For deeper analysis, these files and commands are available:");
+    lines.push("");
+    lines.push("**Files** (read directly when you need detail):");
+    lines.push("- `.specs/machine/architecture.snapshot.yaml` — full module map with every file, export symbol, import edge");
+    lines.push("- `.specs/machine/codebase-intelligence.json` — API registry with handler code, service calls, request/response schemas");
+    lines.push("- `.specs/machine/structural-intelligence.json` — depth/complexity analysis per module");
+    if (architecture.dependencies.file_graph.length > 0) {
+        lines.push("- `.specs/machine/architecture.snapshot.yaml → dependencies.file_graph` — file-level dependency edges");
+    }
+    if (architecture.analysis?.circular_dependencies?.length > 0) {
+        lines.push(`- Circular dependencies detected: ${architecture.analysis.circular_dependencies.length} cycles (check snapshot)`);
     }
-    return [...lines.slice(0, maxLines - 2), "- context truncated for line budget", "<!-- /guardian:context -->"].join("\n");
+    lines.push("");
+    lines.push("**Commands** (run in terminal for targeted lookup):");
+    lines.push("- `guardian search --query \"<feature>\"` — search endpoints, models, components, modules by keyword");
+    lines.push("- `guardian context --focus \"<feature>\"` — generate focused context for a specific area");
+    lines.push("- `guardian drift` — check architectural drift metrics");
+    lines.push("");
+    lines.push("<!-- /guardian:context -->");
+    return lines.join("\n");
 }
 function tokenize(value) {
     return value

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toolbaux/guardian",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "type": "module",
   "description": "Architectural intelligence for codebases. Verify that AI-generated code matches your architectural intent.",
   "keywords": [
@@ -41,7 +41,8 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "prepublishOnly": "npm run build",
+    "prepublishOnly": "npm run test:critical && npm run build",
+    "test:critical": "vitest run tests/critical/",
     "dev": "tsx src/cli.ts",
     "start": "node dist/cli.js",
     "typecheck": "tsc -p tsconfig.json --noEmit",