@happyvertical/smrt-cli 0.40.22 → 0.40.24

package/README.md

@@ -57,7 +57,7 @@ batch.
 
 ### Audited PostgreSQL timestamp conversion
 
-`timestamp without time zone` values do not carry enough information for SMRT
+`timestamp without time zone` values do not carry enough information for s-m-r-t
 to infer their original instant. After auditing every historical writer,
 database default, trigger, and raw SQL path, an operator may confirm that the
 legacy values are UTC wall times and include the exact opt-in:
@@ -155,7 +155,7 @@ Custom methods on s-m-r-t objects are auto-discovered from manifests. Method par
 ## Usage
 
 ```bash
-# Discover what SMRT objects are available
+# Discover what s-m-r-t objects are available
 smrt introspect
 
 # Generate an MCP server

package/dist/{commands-DrK9PHS4.js → commands-CR1RZCYu.js}

@@ -12,6 +12,7 @@ import { createLogger } from "@happyvertical/logger";
 import glob from "fast-glob";
 import { createHash } from "node:crypto";
 import { toSnakeCase } from "@happyvertical/smrt-core/utils";
+import { readAgentModuleDocs } from "@happyvertical/smrt-core/knowledge";
 import { MCPGenerator } from "@happyvertical/smrt-core/generators";
 import { generateDeclarationsFromCLI } from "@happyvertical/smrt-core/prebuild";
 import { execSync, spawn, spawnSync } from "node:child_process";
@@ -2393,8 +2394,11 @@ function createDocsCommand(config) {
 				console.log(`   ${totalPackages} packages documented`);
 				if (packages.length > 0) console.log(`   ${packages.length} SMRT packages`);
 				if (sdkPackages.length > 0) console.log(`   ${sdkPackages.length} SDK packages`);
-				const withAgentDocs = [...packages, ...sdkPackages].filter((p) => p.agentMd).length;
+				const allPackages = [...packages, ...sdkPackages];
+				const withAgentDocs = allPackages.filter((p) => p.agentMd).length;
 				if (withAgentDocs > 0) console.log(`   ${withAgentDocs} with AGENTS.md`);
+				const moduleDocCount = allPackages.reduce((total, p) => total + (p.moduleDocs?.length ?? 0), 0);
+				if (moduleDocCount > 0) console.log(`   ${moduleDocCount} linked module docs`);
 				if (rootDocs.length > 0) console.log(`   ${rootDocs.length} framework documents included`);
 				console.log("");
 			} catch (error) {
@@ -2494,7 +2498,8 @@ function loadPackageInfo(packagePath, dirName) {
 			readme: existsSync(readmePath) ? readFileSync(readmePath, "utf-8") : null,
 			agentMd: agentDoc.content,
 			claudeMd: agentDoc.content,
-			docSource: agentDoc.source
+			docSource: agentDoc.source,
+			moduleDocs: agentDoc.source === "AGENTS.md" ? readAgentModuleDocs(packagePath, agentDoc.content ?? void 0) : []
 		};
 	} catch {
 		console.warn(`   ⚠️  Could not read package.json for ${dirName}`);
@@ -2573,6 +2578,27 @@ function renderAgentMd(content) {
 	if (h1Match) content = content.slice(h1Match[0].length);
 	return content.trim();
 }
+/**
+* The package's AGENTS.md followed by every module doc it links (#2108).
+* The links stay in the rendered text so a reader can still map a section back
+* to its source path; the bodies follow so nothing is lost downstream.
+*/
+function renderPackageDoc(pkg, lines) {
+	const content = pkg.agentMd ?? pkg.claudeMd;
+	if (!content) {
+		lines.push("*No AGENTS.md found for this package.*");
+		lines.push("");
+		return;
+	}
+	lines.push(renderAgentMd(content));
+	lines.push("");
+	for (const doc of pkg.moduleDocs ?? []) {
+		lines.push(`#### ${doc.path}`);
+		lines.push("");
+		lines.push(renderAgentMd(doc.content));
+		lines.push("");
+	}
+}
 function generateMarkdown(packages, rootDocs, sdkPackages, generatedBy = "smrt docs:agents") {
 	const lines = [];
 	lines.push("# SMRT Framework Context");
@@ -2616,14 +2642,7 @@ function generateMarkdown(packages, rootDocs, sdkPackages, generatedBy = "smrt d
 		lines.push("");
 		lines.push(`## ${pkg.name}`);
 		lines.push("");
-		const content = pkg.agentMd ?? pkg.claudeMd;
-		if (content) {
-			lines.push(renderAgentMd(content));
-			lines.push("");
-		} else {
-			lines.push("*No AGENTS.md found for this package.*");
-			lines.push("");
-		}
+		renderPackageDoc(pkg, lines);
 	}
 	if (sdkPackages && sdkPackages.length > 0) {
 		lines.push("---");
@@ -2635,14 +2654,7 @@ function generateMarkdown(packages, rootDocs, sdkPackages, generatedBy = "smrt d
 			lines.push("");
 			lines.push(`### ${pkg.name}`);
 			lines.push("");
-			const content = pkg.agentMd ?? pkg.claudeMd;
-			if (content) {
-				lines.push(renderAgentMd(content));
-				lines.push("");
-			} else {
-				lines.push("*No AGENTS.md found for this package.*");
-				lines.push("");
-			}
+			renderPackageDoc(pkg, lines);
 		}
 	}
 	lines.push("---");

package/dist/index.js

@@ -48,56 +48,56 @@ var _docsCommands = null;
 var _playgroundCommands = null;
 async function getGnodeCommands() {
 	if (!_gnodeCommands) {
-		const { gnodeCommands } = await import("./commands-DrK9PHS4.js");
+		const { gnodeCommands } = await import("./commands-CR1RZCYu.js");
 		_gnodeCommands = gnodeCommands;
 	}
 	return _gnodeCommands;
 }
 async function getGitCommands() {
 	if (!_gitCommands) {
-		const { gitCommands } = await import("./commands-DrK9PHS4.js");
+		const { gitCommands } = await import("./commands-CR1RZCYu.js");
 		_gitCommands = gitCommands;
 	}
 	return _gitCommands;
 }
 async function getGenerateCommands() {
 	if (!_generateCommands) {
-		const { generateCommands } = await import("./commands-DrK9PHS4.js");
+		const { generateCommands } = await import("./commands-CR1RZCYu.js");
 		_generateCommands = generateCommands;
 	}
 	return _generateCommands;
 }
 async function getInitCommands() {
 	if (!_initCommands) {
-		const { initCommands } = await import("./commands-DrK9PHS4.js");
+		const { initCommands } = await import("./commands-CR1RZCYu.js");
 		_initCommands = initCommands;
 	}
 	return _initCommands;
 }
 async function getUtilityCommands() {
 	if (!_utilityCommands) {
-		const { utilityCommands } = await import("./commands-DrK9PHS4.js");
+		const { utilityCommands } = await import("./commands-CR1RZCYu.js");
 		_utilityCommands = utilityCommands;
 	}
 	return _utilityCommands;
 }
 async function getDispatchCommands() {
 	if (!_dispatchCommands) {
-		const { dispatchCommands } = await import("./commands-DrK9PHS4.js");
+		const { dispatchCommands } = await import("./commands-CR1RZCYu.js");
 		_dispatchCommands = dispatchCommands;
 	}
 	return _dispatchCommands;
 }
 async function getDocsCommands() {
 	if (!_docsCommands) {
-		const { docsCommands } = await import("./commands-DrK9PHS4.js");
+		const { docsCommands } = await import("./commands-CR1RZCYu.js");
 		_docsCommands = docsCommands;
 	}
 	return _docsCommands;
 }
 async function getPlaygroundCommands() {
 	if (!_playgroundCommands) {
-		const { playgroundCommands } = await import("./commands-DrK9PHS4.js");
+		const { playgroundCommands } = await import("./commands-CR1RZCYu.js");
 		_playgroundCommands = playgroundCommands;
 	}
 	return _playgroundCommands;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-cli",
-  "version": "0.40.22",
+  "version": "0.40.24",
   "description": "Developer CLI for SMRT framework - introspection, testing, and project management",
   "type": "module",
   "main": "./dist/index.js",
@@ -32,12 +32,12 @@
     "acorn": "^8.17.0",
     "fast-glob": "3.3.3",
     "tar": "^7.5.19",
-    "@happyvertical/smrt-agents": "0.40.22",
-    "@happyvertical/smrt-core": "0.40.22",
-    "@happyvertical/smrt-config": "0.40.22",
-    "@happyvertical/smrt-dev-mcp": "0.40.22",
-    "@happyvertical/smrt-playground": "0.40.22",
-    "@happyvertical/smrt-types": "0.40.22"
+    "@happyvertical/smrt-agents": "0.40.24",
+    "@happyvertical/smrt-config": "0.40.24",
+    "@happyvertical/smrt-core": "0.40.24",
+    "@happyvertical/smrt-dev-mcp": "0.40.24",
+    "@happyvertical/smrt-playground": "0.40.24",
+    "@happyvertical/smrt-types": "0.40.24"
   },
   "devDependencies": {
     "@types/node": "24.13.2",