@femtomc/mu-agent 26.2.77 → 26.2.79

package/README.md

@@ -82,6 +82,6 @@ There is no dedicated `query(...)` vs `command(...)` wrapper boundary in this pa
 
 ## Control-plane config notes
 
-- Runtime config source of truth is `.mu/config.json`.
+- Runtime config source of truth is `<store>/config.json` (resolve with `mu store paths`).
 - Inspect runtime state via CLI (`mu control status`, `mu status`).
 - Apply control-plane lifecycle mutations via CLI (`mu control reload`, `mu control update`).

package/dist/self_documentation.d.ts

@@ -1,7 +1,13 @@
+type MuPackageReadme = {
+    label: string;
+    path: string;
+};
 export type MuDocumentation = {
     readmePath?: string;
     docsPath?: string;
+    packageReadmes: MuPackageReadme[];
 };
 export declare function resolveMuDocumentation(): MuDocumentation;
 export declare function appendMuDocumentationSection(basePrompt: string): string;
+export {};
 //# sourceMappingURL=self_documentation.d.ts.map

package/dist/self_documentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"self_documentation.d.ts","sourceRoot":"","sources":["../src/self_documentation.ts"],"names":[],"mappings":"AA8BA,MAAM,MAAM,eAAe,GAAG;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAgB,sBAAsB,IAAI,eAAe,CA2BxD;AAED,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAiBvE"}
+{"version":3,"file":"self_documentation.d.ts","sourceRoot":"","sources":["../src/self_documentation.ts"],"names":[],"mappings":"AA8BA,KAAK,eAAe,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACb,CAAC;AAgFF,MAAM,MAAM,eAAe,GAAG;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,eAAe,EAAE,CAAC;CAClC,CAAC;AAEF,wBAAgB,sBAAsB,IAAI,eAAe,CAiCxD;AAED,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAyBvE"}

package/dist/self_documentation.js

@@ -24,6 +24,78 @@ function firstExistingPath(candidates) {
     }
     return undefined;
 }
+const INSTALLED_PACKAGE_README_LOOKUP = [
+    { packageName: "@femtomc/mu-agent", label: "@femtomc/mu-agent" },
+    { packageName: "@femtomc/mu-control-plane", label: "@femtomc/mu-control-plane" },
+    { packageName: "@femtomc/mu-core", label: "@femtomc/mu-core" },
+    { packageName: "@femtomc/mu-forum", label: "@femtomc/mu-forum" },
+    { packageName: "@femtomc/mu-issue", label: "@femtomc/mu-issue" },
+    { packageName: "@femtomc/mu-orchestrator", label: "@femtomc/mu-orchestrator" },
+    { packageName: "@femtomc/mu-server", label: "@femtomc/mu-server" },
+];
+const MONOREPO_PACKAGE_README_LOOKUP = [
+    { relPath: join("packages", "agent", "README.md"), label: "@femtomc/mu-agent" },
+    { relPath: join("packages", "control-plane", "README.md"), label: "@femtomc/mu-control-plane" },
+    { relPath: join("packages", "core", "README.md"), label: "@femtomc/mu-core" },
+    { relPath: join("packages", "forum", "README.md"), label: "@femtomc/mu-forum" },
+    { relPath: join("packages", "issue", "README.md"), label: "@femtomc/mu-issue" },
+    { relPath: join("packages", "orchestrator", "README.md"), label: "@femtomc/mu-orchestrator" },
+    { relPath: join("packages", "server", "README.md"), label: "@femtomc/mu-server" },
+    { relPath: join("packages", "cli", "README.md"), label: "@femtomc/mu (CLI)" },
+    { relPath: join("packages", "neovim", "README.md"), label: "mu.nvim" },
+];
+function resolvePackageRoot(packageName) {
+    try {
+        const entry = require.resolve(packageName);
+        return findPackageRoot(dirname(entry));
+    }
+    catch {
+        return undefined;
+    }
+}
+function findPackageReadmesFromInstalledPackages() {
+    const readmes = [];
+    for (const candidate of INSTALLED_PACKAGE_README_LOOKUP) {
+        const root = resolvePackageRoot(candidate.packageName);
+        if (!root) {
+            continue;
+        }
+        const readmePath = join(root, "README.md");
+        if (existsSync(readmePath)) {
+            readmes.push({ label: candidate.label, path: readmePath });
+        }
+    }
+    return readmes;
+}
+function findPackageReadmesFromMonorepoRoots(candidateRoots) {
+    const roots = new Set();
+    for (const root of candidateRoots) {
+        roots.add(root);
+        roots.add(resolve(root, "..", ".."));
+    }
+    const readmes = [];
+    for (const root of roots) {
+        for (const candidate of MONOREPO_PACKAGE_README_LOOKUP) {
+            const readmePath = join(root, candidate.relPath);
+            if (existsSync(readmePath)) {
+                readmes.push({ label: candidate.label, path: readmePath });
+            }
+        }
+    }
+    return readmes;
+}
+function uniquePackageReadmes(readmes) {
+    const seenPaths = new Set();
+    const unique = [];
+    for (const readme of readmes) {
+        if (seenPaths.has(readme.path)) {
+            continue;
+        }
+        seenPaths.add(readme.path);
+        unique.push(readme);
+    }
+    return unique;
+}
 export function resolveMuDocumentation() {
     const thisModuleDir = dirname(fileURLToPath(import.meta.url));
     const agentPackageRoot = findPackageRoot(thisModuleDir);
@@ -44,14 +116,19 @@ export function resolveMuDocumentation() {
         docsCandidates.push(resolve(root, "..", "..", "docs"));
         docsCandidates.push(join(root, "docs"));
     }
+    const packageReadmes = uniquePackageReadmes([
+        ...findPackageReadmesFromInstalledPackages(),
+        ...findPackageReadmesFromMonorepoRoots(candidateRoots),
+    ]);
     return {
         readmePath: firstExistingPath(readmeCandidates),
         docsPath: firstExistingPath(docsCandidates),
+        packageReadmes,
     };
 }
 export function appendMuDocumentationSection(basePrompt) {
     const trimmed = basePrompt.trim();
-    const { readmePath, docsPath } = resolveMuDocumentation();
+    const { readmePath, docsPath, packageReadmes } = resolveMuDocumentation();
     const lines = ["Mu documentation (for mu feature/configuration/setup questions):"];
     if (readmePath) {
         lines.push(`- Main documentation: ${readmePath}`);
@@ -59,6 +136,15 @@ export function appendMuDocumentationSection(basePrompt) {
     if (docsPath) {
         lines.push(`- Additional docs: ${docsPath}`);
     }
+    if (packageReadmes.length > 0) {
+        lines.push("- Package READMEs:");
+        for (const readme of packageReadmes) {
+            lines.push(`  - ${readme.label}: ${readme.path}`);
+        }
+    }
+    else {
+        lines.push("- Package README paths unavailable at runtime.");
+    }
     if (!readmePath && !docsPath) {
         lines.push("- Documentation path unavailable at runtime; use `mu --help` and package README files.");
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@femtomc/mu-agent",
-  "version": "26.2.77",
+  "version": "26.2.79",
   "description": "Shared agent runtime for mu chat, orchestration roles, and serve extensions.",
   "keywords": [
     "mu",
@@ -24,7 +24,7 @@
     "themes/**"
   ],
   "dependencies": {
-    "@femtomc/mu-core": "26.2.77",
+    "@femtomc/mu-core": "26.2.79",
     "@mariozechner/pi-agent-core": "^0.53.0",
     "@mariozechner/pi-ai": "^0.53.0",
     "@mariozechner/pi-coding-agent": "^0.53.0",

package/prompts/roles/operator.md

@@ -21,6 +21,3 @@ Using `mu`:
 - Use `mu memory index status|rebuild` to inspect/refresh local memory index health when needed.
 - Use `mu heartbeats` and `mu cron` to access persistent scheduled processes that broadcast to the user.
 
-Documentation:
-- Your own documentation (including custom model setup and theme creation) is at: /path/to/README.md
-- Read it when users ask about features, configuration, or setup.