@lsctech/polaris 0.3.1 → 0.3.3

package/dist/governance/review-packet.js

@@ -52,14 +52,15 @@ function groupAndSort(packets) {
  * Write _review-queue.json (canonical) and _review-queue.md (display-only) to outputDir.
  * Markdown is regenerated from JSON — never parse markdown to recover decisions.
  */
-function writeReviewQueue(packets, runId, outputDir) {
+function writeReviewQueue(packets, runId, outputDir, filename = "_review-queue.json") {
     (0, node_fs_1.mkdirSync)(outputDir, { recursive: true });
     const queueFile = {
         generated_at: new Date().toISOString(),
         run_id: runId,
         packets,
     };
-    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(outputDir, "_review-queue.json"), JSON.stringify(queueFile, null, 2) + "\n", "utf-8");
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(outputDir, filename), JSON.stringify(queueFile, null, 2) + "\n", "utf-8");
+    const mdFilename = filename.replace(/\.json$/, ".md");
     const sorted = groupAndSort(packets);
     const sections = sorted.map(renderPacketMarkdown).join("\n\n---\n\n");
     const md = [
@@ -69,21 +70,21 @@ function writeReviewQueue(packets, runId, outputDir) {
         `**Generated:** ${queueFile.generated_at}`,
         `**Pending review:** ${packets.length} document(s)`,
         ``,
-        `> Markdown is display-only. Edit \`_review-queue.json\` to set \`reviewDecision\` fields.`,
+        `> Markdown is display-only. Edit \`${filename}\` to set \`reviewDecision\` fields.`,
         `> Rerun \`polaris docs ingest\` to apply decisions.`,
         ``,
         `---`,
         ``,
         sections,
     ].join("\n");
-    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(outputDir, "_review-queue.md"), md, "utf-8");
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(outputDir, mdFilename), md, "utf-8");
 }
 /**
  * Read review queue from JSON. Returns empty array if no queue file exists.
  * Never reads markdown.
  */
-function readReviewQueue(outputDir) {
-    const jsonPath = (0, node_path_1.join)(outputDir, "_review-queue.json");
+function readReviewQueue(outputDir, filename = "_review-queue.json") {
+    const jsonPath = (0, node_path_1.join)(outputDir, filename);
     if (!(0, node_fs_1.existsSync)(jsonPath))
         return [];
     try {

package/dist/smartdocs-engine/agentic-review.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agenticDecideKey = agenticDecideKey;
+const node_fs_1 = require("node:fs");
+async function agenticDecideKey(packet) {
+    let docContent = "";
+    try {
+        if ((0, node_fs_1.existsSync)(packet.sourcePath)) {
+            docContent = (0, node_fs_1.readFileSync)(packet.sourcePath, "utf-8").slice(0, 3000);
+        }
+    }
+    catch { /* ignore */ }
+    // @ts-ignore: @anthropic-ai/sdk may not be installed as a dependency
+    const mod = await import("@anthropic-ai/sdk");
+    const Anthropic = mod.default ?? mod.Anthropic;
+    const client = new Anthropic();
+    const staleSymbols = packet.staleSymbols;
+    const triageFlag = packet.triageFlag;
+    const prompt = `You are reviewing a candidate documentation file flagged during Polaris docs triage.
+
+Flag type: ${String(triageFlag ?? "unknown")}
+Authority risk: ${packet.authorityRisk}
+Recommendation from triage: ${packet.recommendation}
+Reasoning: ${packet.reasoning.join("; ")}
+${Array.isArray(staleSymbols) ? `Stale symbols (not found in codebase graph): ${staleSymbols.join(", ")}` : ""}
+
+Document content:
+---
+${docContent}
+---
+
+Decide whether this document should be:
+- approved: doc is valid doctrine and should be promoted to active
+- rejected: doc is outdated, incorrect, or superseded and should be deprecated
+- deferred: uncertain — needs human review
+
+Respond with exactly one word: approve, reject, or defer.`;
+    const response = await client.messages.create({
+        model: "claude-haiku-4-5-20251001",
+        max_tokens: 10,
+        messages: [{ role: "user", content: prompt }],
+    });
+    const text = (response.content[0].text ?? "defer").trim().toLowerCase();
+    if (text.startsWith("approve"))
+        return "a";
+    if (text.startsWith("reject"))
+        return "r";
+    return "d";
+}

package/dist/smartdocs-engine/index.js

@@ -13,6 +13,8 @@ const validate_instructions_js_1 = require("./validate-instructions.js");
 const doctrine_js_1 = require("./doctrine.js");
 const audit_js_1 = require("./audit.js");
 const triage_js_1 = require("./triage.js");
+const adapter_js_1 = require("../graph/store/adapter.js");
+const index_js_1 = require("../graph/query/index.js");
 /**
  * Build and return the top-level "docs" Commander command group for Polaris docs lifecycle workflows.
  *
@@ -140,12 +142,24 @@ function createDocsCommand(options = {}) {
         .description("Interactively review pending governance decisions in the review queue")
         .option("--queue <path>", "path to _review-queue.json (default: smartdocs/raw/_review-queue.json)")
         .option("-r, --repo-root <path>", "Repository root", defaultRepoRoot)
+        .option("--agentic", "use LLM agent to make review decisions automatically")
+        .option("--triage", "review the triage queue (_triage-queue.json) instead of the review queue")
         .action(async (opts) => {
+        const repoRoot = opts.repoRoot;
+        const queueFilename = opts.triage ? "_triage-queue.json" : "_review-queue.json";
+        const queueDir = opts.queue
+            ? (0, node_path_1.resolve)(opts.repoRoot, opts.queue)
+                .replace(/_review-queue\.json$/, "")
+                .replace(/_triage-queue\.json$/, "")
+                .replace(/\/$/, "")
+            : (0, node_path_1.resolve)(repoRoot, "smartdocs", "raw");
+        let readKey;
+        if (opts.agentic) {
+            const { agenticDecideKey } = await import("./agentic-review.js");
+            readKey = agenticDecideKey;
+        }
         try {
-            const queueDir = opts.queue
-                ? (0, node_path_1.resolve)(opts.repoRoot, opts.queue).replace(/_review-queue\.json$/, "").replace(/\/$/, "")
-                : (0, node_path_1.resolve)(opts.repoRoot, "smartdocs", "raw");
-            await (0, review_js_1.runReviewSession)({ repoRoot: opts.repoRoot, queueDir });
+            await (0, review_js_1.runReviewSession)({ repoRoot, queueDir, queueFilename, readKey });
         }
         catch (err) {
             console.error(`polaris docs review: ${err instanceof Error ? err.message : String(err)}`);
@@ -160,18 +174,35 @@ function createDocsCommand(options = {}) {
         .option("--resume", "Resume from last checkpoint (auto-detected by default)")
         .option("--dry-run", "Plan batches and print cost estimate without calling the LLM")
         .action(async (options) => {
+        const repoRoot = options.repoRoot;
+        const dbPath = (0, node_path_1.join)(repoRoot, ".polaris", "graph", "graph.sqlite");
+        const graphOutputPath = (0, node_path_1.join)(".polaris", "graph");
+        let store = null;
+        try {
+            store = new adapter_js_1.GraphStoreAdapter({ repoRoot, graphOutputPath, dbPath });
+            store.open();
+            (0, index_js_1.configureGraphQuery)({ graphStore: store });
+        }
+        catch {
+            (0, index_js_1.configureGraphQuery)({ graphStore: null });
+        }
         try {
             await (0, triage_js_1.runTriage)({
-                repoRoot: options.repoRoot,
+                repoRoot,
                 batchSize: parseInt(options.batchSize, 10) || 10,
                 resume: options.resume,
                 dryRun: options.dryRun,
+                symbolLookup: (name) => (0, index_js_1.lookupSymbol)(name) !== null,
+                graphStats: () => (0, index_js_1.getGraphStats)(),
             });
         }
         catch (err) {
             console.error(`polaris docs triage: ${err instanceof Error ? err.message : String(err)}`);
             process.exit(1);
         }
+        finally {
+            store?.close();
+        }
     });
     docs
         .command("migrate")

package/dist/smartdocs-engine/review.js

@@ -84,7 +84,8 @@ function readSingleKey() {
 async function runReviewSession(options) {
     const { repoRoot, readKey, getReviewedBy = defaultGetReviewedBy, output = (msg) => process.stdout.write(msg + "\n"), } = options;
     const queueDir = options.queueDir ?? (0, node_path_1.resolve)(repoRoot, "smartdocs", "raw");
-    const packets = (0, index_js_1.readReviewQueue)(queueDir);
+    const queueFilename = options.queueFilename;
+    const packets = (0, index_js_1.readReviewQueue)(queueDir, queueFilename);
     if (packets.length === 0) {
         output("No review queue found. Run polaris docs ingest first.");
         return;
@@ -98,7 +99,7 @@ async function runReviewSession(options) {
     for (let i = 0; i < undecided.length; i++) {
         const packet = undecided[i];
         output(formatPacketCard(packet, i + 1, undecided.length));
-        const key = readKey ? await readKey() : await readSingleKey();
+        const key = readKey ? await readKey(packet) : await readSingleKey();
         if (key === "q") {
             const remaining = undecided.length - decided;
             output(`\nSession ended. ${decided} decision(s) saved, ${remaining} packet(s) still pending.`);
@@ -126,7 +127,7 @@ async function runReviewSession(options) {
                 reviewedBy: getReviewedBy(),
             };
         }
-        (0, index_js_1.writeReviewQueue)(packets, "review-session", queueDir);
+        (0, index_js_1.writeReviewQueue)(packets, "review-session", queueDir, queueFilename);
         decided++;
     }
     const approved = packets.filter((p) => p.reviewDecision === "approve").length;

package/package.json

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