@lsctech/polaris 0.3.10 → 0.3.12

package/dist/cli/adopt-canon.js

@@ -3,9 +3,35 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.enrichCanonFiles = enrichCanonFiles;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
+const node_child_process_1 = require("node:child_process");
+const loader_js_1 = require("../config/loader.js");
+const librarian_dispatch_js_1 = require("../smartdocs-engine/librarian-dispatch.js");
 const SKIP_DIRS = new Set(["node_modules", ".git", "dist", "build", ".polaris", "smartdocs"]);
-function normalizeRoute(route) {
-    return route.replace(/^\.\//, "").replace(/\/$/, "");
+function loadInventoryCanonicalFolders(repoRoot) {
+    const inventoryPath = (0, node_path_1.join)(repoRoot, ".polaris", "adoption-inventory.json");
+    if (!(0, node_fs_1.existsSync)(inventoryPath))
+        return [];
+    try {
+        const raw = JSON.parse((0, node_fs_1.readFileSync)(inventoryPath, "utf-8"));
+        const folders = raw["likely_canonical_folders"];
+        return Array.isArray(folders) ? folders : [];
+    }
+    catch {
+        return [];
+    }
+}
+function scaffoldDraftSummaryFiles(repoRoot, canonicalFolders) {
+    for (const folder of canonicalFolders) {
+        const dir = (0, node_path_1.join)(repoRoot, folder);
+        if (!(0, node_fs_1.existsSync)(dir))
+            continue;
+        const summaryPath = (0, node_path_1.join)(dir, "SUMMARY.md");
+        if ((0, node_fs_1.existsSync)(summaryPath))
+            continue;
+        (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+        (0, node_fs_1.writeFileSync)(summaryPath, `# ${folder}\n\n<!-- polaris:draft -->\n`, "utf-8");
+        console.log(`  Scaffolded draft SUMMARY.md: ${folder}`);
+    }
 }
 function walkForSummaryDirs(dir, repoRoot, results) {
     let entries;
@@ -27,51 +53,161 @@ function walkForSummaryDirs(dir, repoRoot, results) {
         walkForSummaryDirs((0, node_path_1.join)(dir, entry.name), repoRoot, results);
     }
 }
-function buildLinkedDocsBlock(entries) {
+function listActiveDoctrineDocs(repoRoot) {
+    const activeDir = (0, node_path_1.join)(repoRoot, "smartdocs", "doctrine", "active");
+    if (!(0, node_fs_1.existsSync)(activeDir))
+        return [];
+    const docs = [];
+    try {
+        const files = (0, node_fs_1.readdirSync)(activeDir, { withFileTypes: true });
+        for (const f of files) {
+            if (!f.isFile() || !f.name.endsWith(".md"))
+                continue;
+            const filePath = (0, node_path_1.join)(activeDir, f.name);
+            const content = (0, node_fs_1.readFileSync)(filePath, "utf-8");
+            const titleMatch = content.match(/^#\s+(.+)/m);
+            const title = titleMatch ? titleMatch[1].trim() : f.name.replace(/\.md$/, "");
+            docs.push({ path: (0, node_path_1.relative)(repoRoot, filePath), title });
+        }
+    }
+    catch {
+        // ignore
+    }
+    return docs;
+}
+function buildLinkedDocsBlock(docs) {
     const lines = ["linked_docs:"];
-    for (const entry of entries) {
-        const path = entry.doc_path.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
-        const title = (entry.title ?? "").replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+    for (const doc of docs) {
+        const path = doc.path.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+        const title = doc.title.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
         lines.push(`  - path: "${path}"`);
         lines.push(`    title: "${title}"`);
     }
     return lines;
 }
-function injectLinkedDocs(content, entries) {
+function injectLinkedDocs(content, docs, summaryLines) {
     const lines = content.split("\n");
     const headingIdx = lines.findIndex((l) => l.startsWith("#"));
     if (headingIdx === -1)
         return content;
-    const yamlLines = ["", "---", ...buildLinkedDocsBlock(entries), "---"];
+    const yamlLines = ["", "---", ...buildLinkedDocsBlock(docs), "---"];
     const before = lines.slice(0, headingIdx + 1);
-    const after = lines.slice(headingIdx + 1);
+    // If agent provided summary content, append after YAML block
+    const after = summaryLines.length > 0
+        ? ["", ...summaryLines]
+        : lines.slice(headingIdx + 1);
     return [...before, ...yamlLines, ...after].join("\n");
 }
+function dispatchCanonAgent(options) {
+    const { repoRoot, routeFolder, doctrineDocs, providers, providerOrder } = options;
+    const providerName = (0, librarian_dispatch_js_1.resolveLibrarianProvider)(providers, providerOrder);
+    if (!providerName)
+        return null;
+    const cfg = providers[providerName];
+    const docList = doctrineDocs
+        .map((d, i) => `${i + 1}. [${d.title}] path: ${d.path}`)
+        .join("\n");
+    const prompt = `You are a Polaris librarian generating context files for an agent work area.
+
+Route folder: ${routeFolder}
+Repo root: ${repoRoot}
+
+Available doctrine documents:
+${docList}
+
+Generate two outputs for this route area:
+
+1. SUMMARY.md content — a navigation index. Select relevant doctrine docs and write 2-4 lines describing what this area covers.
+
+2. POLARIS.md content — operational instructions for agents entering this work area. Write 4-8 lines covering: what this area is responsible for, key patterns/conventions agents should follow, what to avoid, and which doctrine docs to consult for specific concerns. Be concise and directive — agents read this cold before starting work.
+
+Respond with ONLY valid JSON on a single line:
+{"relevant_docs":[{"path":"<doc path>","title":"<doc title>"}],"summary_lines":["line1","line2"],"polaris_lines":["line1","line2"]}
+
+If no doctrine docs are relevant, return an empty array for relevant_docs.`;
+    const args = (cfg.args ?? []).map((a) => (a === "{{worker_prompt}}" ? prompt : a));
+    const result = (0, node_child_process_1.spawnSync)(cfg.command, args, {
+        encoding: "utf-8",
+        timeout: 60000,
+        cwd: repoRoot,
+    });
+    const stdout = (result.stdout ?? "").trim();
+    const jsonLine = stdout
+        .split("\n")
+        .reverse()
+        .find((l) => l.trim().startsWith("{") && l.includes("relevant_docs"));
+    if (!jsonLine)
+        return null;
+    try {
+        return JSON.parse(jsonLine);
+    }
+    catch {
+        return null;
+    }
+}
 async function enrichCanonFiles(repoRoot) {
-    const indexPath = (0, node_path_1.join)(repoRoot, ".polaris", "map", "index.json");
-    if (!(0, node_fs_1.existsSync)(indexPath))
-        return;
-    const raw = JSON.parse((0, node_fs_1.readFileSync)(indexPath, "utf-8"));
-    // entries may be an array of {doc_path,route,title} OR an object keyed by file path
-    const rawEntries = raw["entries"] ?? [];
-    const entries = Array.isArray(rawEntries)
-        ? rawEntries
-        : Object.entries(rawEntries).map(([filePath, meta]) => ({
-            doc_path: filePath,
-            route: String(meta["route"] ?? ""),
-            title: meta["title"] ? String(meta["title"]) : undefined,
-        }));
+    let config = null;
+    try {
+        config = (0, loader_js_1.loadConfig)(repoRoot);
+    }
+    catch {
+        throw new Error("polaris agent setup required: could not load polaris.config.json.\n" +
+            "Run `polaris agent setup` or configure at least a foreman agent.");
+    }
+    const providers = (config.execution?.providers ?? {});
+    const librarianOrder = config.execution?.providerPolicy?.librarian?.providers ?? [];
+    const foremanOrder = config.execution?.providerPolicy?.foreman?.providers ?? [];
+    // Prefer librarian, fall back to foreman
+    const providerOrder = (0, librarian_dispatch_js_1.resolveLibrarianProvider)(providers, librarianOrder) != null
+        ? librarianOrder
+        : foremanOrder;
+    if ((0, librarian_dispatch_js_1.resolveLibrarianProvider)(providers, providerOrder) == null) {
+        const configured = [...new Set([...librarianOrder, ...foremanOrder])];
+        const msg = configured.length > 0
+            ? `Configured agents (${configured.join(", ")}) are not installed on this machine.`
+            : "No librarian or foreman agents are configured.";
+        throw new Error(`polaris agent setup required: ${msg}\n` +
+            "Run `polaris agent setup` to configure an available agent.");
+    }
+    const doctrineDocs = listActiveDoctrineDocs(repoRoot);
+    const canonicalFolders = loadInventoryCanonicalFolders(repoRoot);
+    if (canonicalFolders.length > 0) {
+        scaffoldDraftSummaryFiles(repoRoot, canonicalFolders);
+    }
     const summaryDirs = [];
     walkForSummaryDirs(repoRoot, repoRoot, summaryDirs);
+    let enrichedCount = 0;
     for (const dir of summaryDirs) {
-        const route = normalizeRoute((0, node_path_1.relative)(repoRoot, dir));
-        const matched = entries.filter((e) => normalizeRoute(e.route) === route);
-        if (matched.length === 0)
-            continue;
         const summaryPath = (0, node_path_1.join)(dir, "SUMMARY.md");
         const content = (0, node_fs_1.readFileSync)(summaryPath, "utf-8");
         if (!content.includes("<!-- polaris:draft -->"))
             continue;
-        (0, node_fs_1.writeFileSync)(summaryPath, injectLinkedDocs(content, matched), "utf-8");
+        const routeFolder = (0, node_path_1.relative)(repoRoot, dir);
+        console.log(`  Dispatching librarian for: ${routeFolder}`);
+        const response = dispatchCanonAgent({
+            repoRoot,
+            routeFolder,
+            doctrineDocs,
+            providers,
+            providerOrder,
+        });
+        if (!response) {
+            console.log(`  ⚠ No response for ${routeFolder}, skipping`);
+            continue;
+        }
+        (0, node_fs_1.writeFileSync)(summaryPath, injectLinkedDocs(content, response.relevant_docs, response.summary_lines), "utf-8");
+        if ((response.polaris_lines ?? []).length > 0) {
+            const polarisPath = (0, node_path_1.join)(dir, "POLARIS.md");
+            const polarisContent = [
+                `# POLARIS — ${routeFolder}`,
+                "",
+                ...response.polaris_lines,
+                "",
+            ].join("\n");
+            (0, node_fs_1.writeFileSync)(polarisPath, polarisContent, "utf-8");
+        }
+        enrichedCount++;
+        console.log(`  ✓ Enriched ${routeFolder} with ${response.relevant_docs.length} linked docs`);
     }
+    console.log(`\nEnriched ${enrichedCount} SUMMARY.md files.`);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lsctech/polaris",
-  "version": "0.3.10",
+  "version": "0.3.12",
   "description": "Polaris — standalone taskchain orchestration framework for governed AI agent workflows",
   "bin": {
     "polaris-cli": "dist/cli/index.js"