@lsctech/polaris 0.5.4 → 0.5.5

package/dist/cli/index.js

@@ -35,8 +35,25 @@ function resolveStateFile(repoRoot, explicit) {
         return (0, node_path_1.resolve)(explicit);
     const taskchainPath = (0, node_path_1.join)(repoRoot, ".taskchain_artifacts", "polaris-run", "current-state.json");
     const polarisPath = (0, node_path_1.join)(repoRoot, ".polaris", "runs", "current-state.json");
-    if ((0, node_fs_1.existsSync)(taskchainPath))
+    // Prefer canonical cluster-scoped state.json when it exists — finalize
+    // rejects the compatibility/debug taskchain path as the sole state source.
+    // Read cluster_id from the taskchain path if available, then check the
+    // canonical path bootstrapped alongside it.
+    if ((0, node_fs_1.existsSync)(taskchainPath)) {
+        try {
+            const raw = JSON.parse((0, node_fs_1.readFileSync)(taskchainPath, "utf-8"));
+            const clusterId = typeof raw["cluster_id"] === "string" ? raw["cluster_id"] : undefined;
+            if (clusterId) {
+                const canonicalPath = (0, node_path_1.join)(repoRoot, ".polaris", "clusters", clusterId, "state.json");
+                if ((0, node_fs_1.existsSync)(canonicalPath))
+                    return canonicalPath;
+            }
+        }
+        catch {
+            // Fall through to taskchain path
+        }
         return taskchainPath;
+    }
     if ((0, node_fs_1.existsSync)(polarisPath))
         return polarisPath;
     return taskchainPath;

package/dist/loop/dispatch.js

@@ -305,7 +305,9 @@ function detectPacketGenerationFailure(packet) {
     if (allowedScope.length === 0) {
         return {
             missingField: "allowed_scope",
-            message: `Packet generation failed for ${childId}: missing actionable allowed_scope.`,
+            message: `Packet generation failed for ${childId}: missing actionable allowed_scope. ` +
+                `Add a '## Scope' section to the child issue body in your tracker, ` +
+                `then run 'polaris tracker sync-in <cluster-id>' to pull the update.`,
         };
     }
     const issueBody = packet.instructions.issue_context?.body?.trim() ?? "";

package/dist/loop/evidence-backfill.js

@@ -95,7 +95,12 @@ function backfillClusterStateEvidence(options) {
     const packetsDir = (0, node_path_1.join)(repoRoot, ".polaris", "clusters", clusterId, "packets");
     const backfilled = [];
     const skipped = [];
-    for (const childId of state.completed_children) {
+    // Scan both completed and open children — recovery may have committed work
+    // for children that were never checkpointed into completed_children.
+    const seen = new Set();
+    const allChildren = [...state.completed_children, ...state.open_children].filter((id) => { if (seen.has(id))
+        return false; seen.add(id); return true; });
+    for (const childId of allChildren) {
         // Resolve result file — mirrors continue.ts priority:
         //   1. result_file on child meta (explicit override, e.g. --result-file flag)
         //   2. dispatch_record.expected_result_path
@@ -132,10 +137,12 @@ function backfillClusterStateEvidence(options) {
             continue;
         }
         // Guard: result must indicate completion.
-        if (result["status"] !== undefined && result["status"] !== "done") {
+        // Accept "done" (backfill artifact) and "success" (SuccessResultPacket schema).
+        const resultStatus = result["status"];
+        if (resultStatus !== undefined && resultStatus !== "done" && resultStatus !== "success") {
             skipped.push({
                 childId,
-                reason: `result status is not done: ${String(result["status"])}`,
+                reason: `result status is not done or success: ${String(resultStatus)}`,
             });
             continue;
         }

package/dist/loop/parent.js

@@ -776,6 +776,52 @@ async function runParentLoop(options) {
     // persisted to disk, so a fresh loop start always begins clean.
     const lifecycle = new lifecycle_js_1.WorkerLifecycleManager(maxConcurrentWorkers);
     lifecycle.forceReleaseAll();
+    // ── Auto-sync pre-flight: fetch missing issue bodies from tracker ────────
+    // When child issue bodies are absent or lack a ## Scope section, dispatch
+    // hard-fails with "empty allowed_scope". Attempt a silent tracker sync-in
+    // before the loop starts so operators don't need to run it manually.
+    if (!dryRun) {
+        const openChildrenNeedingScope = state.open_children.filter((childId) => {
+            // Skip analyze children — they never need scope (no impl packets)
+            if (isAnalyzeChild(childId, state)) {
+                return false;
+            }
+            // Resolve child body: prefer cached meta body, then fall back to snapshot
+            const cachedChildBody = state.open_children_meta?.[childId]?.body;
+            const childBody = (cachedChildBody && cachedChildBody.trim().length > 0)
+                ? cachedChildBody
+                : (0, checkpoint_js_1.readBodyFromClusterSnapshot)(state.cluster_id, childId, repoRoot) ?? '';
+            // If body is completely absent, treat as needing scope sync-in
+            if (childBody.trim().length === 0) {
+                return true;
+            }
+            // Parse child body for scope
+            const { scope: childScope } = (0, body_parser_js_1.parseIssueBody)(childBody);
+            if (childScope.length > 0) {
+                return false; // Child has scope, no sync needed
+            }
+            // Fallback: check parent/cluster-root body for scope
+            const cachedParentBody = state.open_children_meta?.[state.cluster_id]?.body;
+            const parentBody = (cachedParentBody && cachedParentBody.trim().length > 0)
+                ? cachedParentBody
+                : (0, checkpoint_js_1.readBodyFromClusterSnapshot)(state.cluster_id, state.cluster_id, repoRoot) ?? '';
+            const { scope: parentScope } = (0, body_parser_js_1.parseIssueBody)(parentBody);
+            // If parent has scope, child can inherit — no sync needed
+            // Otherwise, child truly needs scope sync-in
+            return parentScope.length === 0;
+        });
+        if (openChildrenNeedingScope.length > 0) {
+            process.stderr.write(`[polaris] ${openChildrenNeedingScope.length} children missing scope — attempting tracker sync-in...\n`);
+            try {
+                await (0, index_js_2.loadTrackerGraph)(config, state.cluster_id);
+                process.stderr.write(`[polaris] sync-in complete.\n`);
+            }
+            catch (syncErr) {
+                process.stderr.write(`[polaris] sync-in failed (${syncErr instanceof Error ? syncErr.message : String(syncErr)}). ` +
+                    `Run 'polaris tracker sync-in ${state.cluster_id}' manually and retry.\n`);
+            }
+        }
+    }
     // ── Main dispatch loop ───────────────────────────────────────────────────
     // eslint-disable-next-line no-constant-condition
     while (true) {

package/dist/loop/run-bootstrap.js

@@ -216,6 +216,19 @@ function runLoopBootstrapInit(options) {
     //  avoid circular deps; validateState is called by dispatch which is downstream)
     (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(stateFile), { recursive: true });
     const sha = (0, checkpoint_js_1.writeStateAtomic)(stateFile, initialState);
+    // Also write to the canonical cluster-scoped path so `polaris finalize`
+    // can locate it without requiring --state-file. finalize rejects the
+    // .taskchain_artifacts compatibility path as the sole state source.
+    const canonicalStatePath = (0, node_path_1.resolve)(repoRoot, ".polaris", "clusters", clusterId, "state.json");
+    if ((0, node_path_1.resolve)(stateFile) !== canonicalStatePath) {
+        try {
+            (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(canonicalStatePath), { recursive: true });
+            (0, checkpoint_js_1.writeStateAtomic)(canonicalStatePath, initialState);
+        }
+        catch (error) {
+            process.stderr.write(`Warning: Could not write canonical state to ${canonicalStatePath}: ${error instanceof Error ? error.message : String(error)}\n`);
+        }
+    }
     const summary = {
         run_id: runId,
         cluster_id: clusterId,

package/package.json

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