@lsctech/polaris 0.4.1 → 0.4.2

package/dist/cli/adopt-rules.js

@@ -1,5 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractRepoOverview = extractRepoOverview;
+exports.refreshPolarisRules = refreshPolarisRules;
 exports.generatePolarisRules = generatePolarisRules;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
@@ -186,6 +188,32 @@ function buildContentInline(overview) {
         "",
     ].join("\n");
 }
+function extractRepoOverview(content) {
+    const match = content.match(/(?:^|\n)## Repository Overview\r?\n([\s\S]*?)(?:\r?\n## |$)/);
+    if (!match)
+        return "Repository managed by Polaris.";
+    const overview = match[1].trim().replace(/(^|\n)---\s*$/, "").trim();
+    return overview || "Repository managed by Polaris.";
+}
+function refreshPolarisRules(repoRoot, currentVersion) {
+    const outputPath = (0, node_path_1.join)(repoRoot, "POLARIS_RULES.md");
+    let content = "";
+    if ((0, node_fs_1.existsSync)(outputPath)) {
+        content = (0, node_fs_1.readFileSync)(outputPath, "utf-8");
+    }
+    const firstLine = content.split(/\r?\n/)[0] ?? "";
+    const versionMatch = firstLine.match(/^<!-- polaris-version: ([\d.]+-?[\w.]*) -->$/);
+    const existingVersion = versionMatch?.[1];
+    if (existingVersion === currentVersion) {
+        return { status: "skipped", path: outputPath };
+    }
+    const overview = extractRepoOverview(content);
+    const newContent = `<!-- polaris-version: ${currentVersion} -->\n${buildContentInline(overview)}`;
+    const dir = (0, node_path_1.dirname)(outputPath);
+    (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+    (0, node_fs_1.writeFileSync)(outputPath, newContent, "utf-8");
+    return { status: "updated", path: outputPath };
+}
 async function generatePolarisRules(repoRoot, inventory, options = {}) {
     const { overwrite = false, workspaceDir } = options;
     const outputPath = (0, node_path_1.join)(repoRoot, "POLARIS_RULES.md");

package/dist/cli/index.js

@@ -27,6 +27,7 @@ const librarian_js_1 = require("./librarian.js");
 const medic_js_1 = require("./medic.js");
 const welfare_js_1 = require("../map/welfare.js");
 const adopt_command_js_1 = require("./adopt-command.js");
+const upgrade_command_js_1 = require("./upgrade-command.js");
 const simplicity_js_1 = require("../loop/simplicity.js");
 const autoresearch_js_1 = require("./autoresearch.js");
 function resolveStateFile(repoRoot, explicit) {
@@ -110,6 +111,7 @@ function createPolarisCommand(options = {}) {
         repoRoot,
     }));
     program.addCommand((0, adopt_command_js_1.createAdoptCommand)({ repoRoot }));
+    program.addCommand((0, upgrade_command_js_1.createUpgradeCommand)({ repoRoot }));
     program.addCommand((0, autoresearch_js_1.createAutoresearchCommand)({ repoRoot }));
     program
         .command("simplicity")

package/dist/cli/upgrade-command.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createUpgradeCommand = createUpgradeCommand;
+const commander_1 = require("commander");
+const version_js_1 = require("./version.js");
+const adopt_rules_js_1 = require("./adopt-rules.js");
+function createUpgradeCommand(options = {}) {
+    const repoRoot = options.repoRoot ?? process.cwd();
+    const doRefresh = options.refresh ?? adopt_rules_js_1.refreshPolarisRules;
+    const getCurrentVersion = options.getVersion ?? version_js_1.getVersion;
+    const cmd = new commander_1.Command("upgrade")
+        .description("Refresh POLARIS_RULES.md to the current Polaris CLI version")
+        .option("-r, --repo-root <path>", "Repository root", repoRoot)
+        .action(async (cmdOptions) => {
+        const targetRoot = cmdOptions.repoRoot ?? repoRoot;
+        const version = getCurrentVersion();
+        const result = doRefresh(targetRoot, version);
+        if (result.status === "updated") {
+            process.stdout.write(`POLARIS_RULES.md updated to version ${version}\n`);
+        }
+        else {
+            process.stdout.write(`Already up to date (${version})\n`);
+        }
+    });
+    return cmd;
+}

package/dist/workspace/.polaris/skills/closeout-librarian/steps/08-librarian-commit.md

@@ -101,6 +101,8 @@ Capture the resulting commit SHA.
 
 Record the commit SHA and list of committed files for step 09.
 
+Use `git diff --cached --name-only` output as the source for `files_committed` — git outputs repo-relative paths (e.g., "src/cli/POLARIS.md"), which is the required format for the result JSON.
+
 ## Failure Handling
 
 If `git commit` fails:

package/dist/workspace/.polaris/skills/closeout-librarian/steps/09-sealed-result.md

@@ -24,7 +24,7 @@ interface CloseoutLibrarianResult {
   status: "success" | "partial" | "blocked" | "failure";
   commit_sha: string | null;
   commit_message: string;
-  files_committed: string[];
+  files_committed: string[];  // repo-relative paths (e.g., "src/cli/POLARIS.md")
   drift_reconciliation: DriftReconciliationResult;
   polaris_md_updates: FileUpdate[];
   summary_md_updates: FileUpdate[];

package/package.json

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