@lsctech/polaris 0.3.28 → 0.3.29

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 simplicity_js_1 = require("../loop/simplicity.js");
 function resolveStateFile(repoRoot, explicit) {
     if (explicit)
         return (0, node_path_1.resolve)(explicit);
@@ -108,6 +109,19 @@ function createPolarisCommand(options = {}) {
         repoRoot,
     }));
     program.addCommand((0, adopt_command_js_1.createAdoptCommand)({ repoRoot }));
+    program
+        .command("simplicity")
+        .description("View or override the simplicity discipline mode for the active run")
+        .option("--bypass", "Omit the discipline ladder from worker prompts for this run")
+        .option("--restore", "Re-enable the discipline ladder (clear bypass)")
+        .option("--state-file <path>", "Override path to current-state.json")
+        .action((cmdOptions) => {
+        (0, simplicity_js_1.runSimplicityCommand)({
+            bypass: !!cmdOptions.bypass,
+            restore: !!cmdOptions.restore,
+            stateFile: resolveStateFile(repoRoot, cmdOptions.stateFile),
+        });
+    });
     const agentCmd = new commander_1.Command("agent").description("Manage Polaris agent provider configuration");
     agentCmd.addCommand(new commander_1.Command("setup")
         .description("Configure agent providers per role (librarian, foreman, worker, analyst)")

package/dist/loop/dispatch.js

@@ -15,6 +15,11 @@ const body_parser_js_1 = require("./body-parser.js");
 const loader_js_1 = require("../config/loader.js");
 const store_js_1 = require("../cluster-state/store.js");
 const worker_prompt_js_1 = require("./worker-prompt.js");
+function resolveSimplicityMode(state, config) {
+    if (state.simplicity_bypass)
+        return "off";
+    return config?.simplicity?.mode ?? "full";
+}
 const dispatch_boundary_js_1 = require("./dispatch-boundary.js");
 const run_bootstrap_js_1 = require("./run-bootstrap.js");
 const ledger_js_1 = require("./ledger.js");
@@ -659,7 +664,7 @@ function selectChild(state, requestedChild) {
  * @param resultFile - Optional path for the expected result file; non-absolute paths are resolved against `repoRoot`
  * @returns The constructed WorkerPacket ready for dispatch
  */
-function buildPacket(state, childId, stateFile, telemetryFile, repoRoot, resultFile) {
+function buildPacket(state, childId, stateFile, telemetryFile, repoRoot, resultFile, config) {
     const childMeta = state.open_children_meta?.[childId];
     // Hydrate body from cluster snapshot when runtime state lacks it.
     const cachedBody = childMeta?.body;
@@ -694,6 +699,7 @@ function buildPacket(state, childId, stateFile, telemetryFile, repoRoot, resultF
         allowedScope: resolvedScope.length > 0 ? resolvedScope : undefined,
         maxConcurrentWorkers: 1,
         promptMode: (0, worker_prompt_js_1.selectPromptMode)(childId, state),
+        simplicityMode: resolveSimplicityMode(state, config),
         resultFile: canonicalPath(absoluteResultFile(repoRoot, resultFile)),
     });
 }
@@ -912,7 +918,7 @@ function runLoopDispatch(options) {
         step_cursor: "dispatch",
         dispatch_boundary: (0, dispatch_boundary_js_1.advanceDispatchEpoch)(state.dispatch_boundary, childId),
     };
-    const packet = buildPacket(preliminaryState, childId, options.stateFile, telemetryFile, options.repoRoot, canonicalResultFile);
+    const packet = buildPacket(preliminaryState, childId, options.stateFile, telemetryFile, options.repoRoot, canonicalResultFile, loadedConfig);
     const packetFailure = detectPacketGenerationFailure(packet);
     if (packetFailure) {
         appendTelemetry(telemetryFile, {

package/dist/loop/simplicity.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSimplicityCommand = runSimplicityCommand;
+const checkpoint_js_1 = require("./checkpoint.js");
+/**
+ * Handles `polaris simplicity [--bypass | --restore]`.
+ *
+ * --bypass: sets simplicity_bypass: true for the active run (omits discipline ladder from worker prompts).
+ * --restore: clears simplicity_bypass (re-enables the ladder).
+ * bare: prints current bypass status without mutating state.
+ */
+function runSimplicityCommand(opts) {
+    if (!opts.bypass && !opts.restore) {
+        const state = (0, checkpoint_js_1.readState)(opts.stateFile);
+        if (state.simplicity_bypass) {
+            console.log("Simplicity bypass: on — discipline ladder omitted for this run.");
+        }
+        else {
+            console.log("Simplicity bypass: off — discipline mode comes from project config/default.");
+        }
+        return;
+    }
+    const state = (0, checkpoint_js_1.readState)(opts.stateFile);
+    if (opts.bypass) {
+        state.simplicity_bypass = true;
+        (0, checkpoint_js_1.writeStateAtomic)(opts.stateFile, state);
+        console.log("Simplicity bypass enabled — discipline ladder will be omitted from worker prompts for this run.");
+        return;
+    }
+    // restore
+    state.simplicity_bypass = false;
+    (0, checkpoint_js_1.writeStateAtomic)(opts.stateFile, state);
+    console.log("Simplicity bypass cleared — discipline ladder will be injected into worker prompts.");
+}

package/dist/loop/worker-packet.js

@@ -265,6 +265,7 @@ function compileImplPacket(input) {
         allowedScope: resolvedScope,
         validationCommands: resolvedValidation,
         mode: promptMode,
+        simplicityMode: input.simplicityMode,
     });
     return {
         schema_version: '2.1',

package/dist/loop/worker-prompt.js

@@ -57,6 +57,29 @@ function selectPromptMode(childId, state, override) {
         return override;
     return isNarrowChild(childId, state) ? 'compact' : 'full';
 }
+// ── Discipline section ────────────────────────────────────────────────────────
+function buildDisciplineSection(mode) {
+    if (mode === "off")
+        return [];
+    const lines = [
+        "## Implementation Discipline",
+        "Before writing code, stop at the first rung that holds:",
+        "",
+        "1. Does this need to exist?   → no: skip it (YAGNI)",
+        "2. Stdlib does it?            → use it",
+        "3. Native platform feature?   → use it",
+        "4. Installed dependency?      → use it",
+        "5. One line?                  → one line",
+        "6. Only then: the minimum that works",
+        "",
+        "Lazy, not negligent: validation, error handling, security, and accessibility are never on the chopping block.",
+    ];
+    if (mode === "full") {
+        lines.push("", "When you defer a simplification for later, mark it inline:", "  // ponytail: <what you deferred and why>");
+    }
+    lines.push("");
+    return lines;
+}
 // ── Builder ───────────────────────────────────────────────────────────────────
 /**
  * Build a compact or full worker dispatch prompt.
@@ -80,6 +103,10 @@ function buildWorkerPrompt(input) {
     lines.push('## Goal');
     lines.push(input.goal.trim());
     lines.push('');
+    // ── Implementation Discipline ─────────────────────────────────────────────
+    for (const line of buildDisciplineSection(input.simplicityMode ?? 'full')) {
+        lines.push(line);
+    }
     // ── Scope ─────────────────────────────────────────────────────────────────
     lines.push('## Scope');
     if (input.scopeTouch.length > 0) {
@@ -256,5 +283,6 @@ function buildPromptFromPacketInput(input) {
         telemetryFile: input.telemetryFile,
         issueContext: input.issueContext,
         mode: input.mode,
+        simplicityMode: input.simplicityMode,
     });
 }

package/package.json

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