@askexenow/exe-os 0.8.56 → 0.8.57

package/dist/bin/backfill-conversations.js

@@ -1435,6 +1435,19 @@ var init_platform_procedures = __esm({
         domain: "architecture",
         priority: "p0",
         content: "Desktop and TUI are the SAME product in different renderers. Same data contracts, same interactions, same acceptance criteria. Desktop tab specs in ARCHITECTURE.md ARE the TUI specs. When building TUI, cross-reference Desktop spec. Different tab names, identical behavior. Never treat them as separate products."
+      },
+      // --- Orchestration golden path ---
+      {
+        title: "Task lifecycle \u2014 the golden path every agent follows",
+        domain: "workflow",
+        priority: "p0",
+        content: "create_task is dispatch + delivery. Task lifecycle: open \u2192 in_progress (you start) \u2192 done (update_task when finished) \u2192 needs_review (reviewer nudged) \u2192 closed (COO only via close_task). DB is the reliable delivery \u2014 intercom is just a speedup nudge. If you finish a task, self-chain: check for next task immediately (step 7). Never wait for a nudge. Never say 'standing by.'"
+      },
+      {
+        title: "Intercom is a speedup, not delivery \u2014 DB is the source of truth",
+        domain: "architecture",
+        priority: "p0",
+        content: "Tasks live in the DB. Intercom (tmux send-keys) is fire-and-forget \u2014 it may fail, get garbled, or arrive mid-work. Never rely on intercom for task delivery. The UserPromptSubmit hook checks the DB for new tasks on every prompt. Your operating procedures step 7 says check for next work. The daemon nudges idle agents as a speedup. If you have no tasks, you found them all."
       }
     ];
     PLATFORM_PROCEDURE_TITLES = new Set(

package/dist/bin/backfill-responses.js

@@ -1435,6 +1435,19 @@ var init_platform_procedures = __esm({
         domain: "architecture",
         priority: "p0",
         content: "Desktop and TUI are the SAME product in different renderers. Same data contracts, same interactions, same acceptance criteria. Desktop tab specs in ARCHITECTURE.md ARE the TUI specs. When building TUI, cross-reference Desktop spec. Different tab names, identical behavior. Never treat them as separate products."
+      },
+      // --- Orchestration golden path ---
+      {
+        title: "Task lifecycle \u2014 the golden path every agent follows",
+        domain: "workflow",
+        priority: "p0",
+        content: "create_task is dispatch + delivery. Task lifecycle: open \u2192 in_progress (you start) \u2192 done (update_task when finished) \u2192 needs_review (reviewer nudged) \u2192 closed (COO only via close_task). DB is the reliable delivery \u2014 intercom is just a speedup nudge. If you finish a task, self-chain: check for next task immediately (step 7). Never wait for a nudge. Never say 'standing by.'"
+      },
+      {
+        title: "Intercom is a speedup, not delivery \u2014 DB is the source of truth",
+        domain: "architecture",
+        priority: "p0",
+        content: "Tasks live in the DB. Intercom (tmux send-keys) is fire-and-forget \u2014 it may fail, get garbled, or arrive mid-work. Never rely on intercom for task delivery. The UserPromptSubmit hook checks the DB for new tasks on every prompt. Your operating procedures step 7 says check for next work. The daemon nudges idle agents as a speedup. If you have no tasks, you found them all."
       }
     ];
     PLATFORM_PROCEDURE_TITLES = new Set(

package/dist/bin/backfill-vectors.js

@@ -1,6 +1,12 @@
 #!/usr/bin/env node
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
 var __esm = (fn, res) => function __init() {
   return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
 };
@@ -1435,6 +1441,19 @@ var init_platform_procedures = __esm({
         domain: "architecture",
         priority: "p0",
         content: "Desktop and TUI are the SAME product in different renderers. Same data contracts, same interactions, same acceptance criteria. Desktop tab specs in ARCHITECTURE.md ARE the TUI specs. When building TUI, cross-reference Desktop spec. Different tab names, identical behavior. Never treat them as separate products."
+      },
+      // --- Orchestration golden path ---
+      {
+        title: "Task lifecycle \u2014 the golden path every agent follows",
+        domain: "workflow",
+        priority: "p0",
+        content: "create_task is dispatch + delivery. Task lifecycle: open \u2192 in_progress (you start) \u2192 done (update_task when finished) \u2192 needs_review (reviewer nudged) \u2192 closed (COO only via close_task). DB is the reliable delivery \u2014 intercom is just a speedup nudge. If you finish a task, self-chain: check for next task immediately (step 7). Never wait for a nudge. Never say 'standing by.'"
+      },
+      {
+        title: "Intercom is a speedup, not delivery \u2014 DB is the source of truth",
+        domain: "architecture",
+        priority: "p0",
+        content: "Tasks live in the DB. Intercom (tmux send-keys) is fire-and-forget \u2014 it may fail, get garbled, or arrive mid-work. Never rely on intercom for task delivery. The UserPromptSubmit hook checks the DB for new tasks on every prompt. Your operating procedures step 7 says check for next work. The daemon nudges idle agents as a speedup. If you have no tasks, you found them all."
       }
     ];
     PLATFORM_PROCEDURE_TITLES = new Set(
@@ -2038,12 +2057,12 @@ function isMainModule(importMetaUrl) {
 }
 
 // src/bin/backfill-vectors.ts
-import { existsSync as existsSync5, unlinkSync as unlinkSync3 } from "fs";
+import { existsSync as existsSync6, unlinkSync as unlinkSync3 } from "fs";
 import path6 from "path";
 
 // src/lib/worker-gate.ts
 init_config();
-import { readdirSync as readdirSync2, writeFileSync, unlinkSync as unlinkSync2, mkdirSync as mkdirSync2 } from "fs";
+import { readdirSync as readdirSync2, writeFileSync, unlinkSync as unlinkSync2, mkdirSync as mkdirSync2, existsSync as existsSync5 } from "fs";
 import path5 from "path";
 var WORKER_PID_DIR = path5.join(EXE_AI_DIR, "worker-pids");
 function registerWorkerPid(pid) {
@@ -2059,19 +2078,59 @@ function cleanupWorkerPid() {
   } catch {
   }
 }
+var BACKFILL_LOCK = path5.join(WORKER_PID_DIR, "backfill.lock");
+function tryAcquireBackfillLock() {
+  try {
+    mkdirSync2(WORKER_PID_DIR, { recursive: true });
+    if (existsSync5(BACKFILL_LOCK)) {
+      try {
+        const pid = parseInt(
+          __require("fs").readFileSync(BACKFILL_LOCK, "utf8").trim(),
+          10
+        );
+        if (!isNaN(pid) && pid > 0) {
+          try {
+            process.kill(pid, 0);
+            return false;
+          } catch {
+          }
+        }
+      } catch {
+      }
+    }
+    writeFileSync(BACKFILL_LOCK, String(process.pid));
+    return true;
+  } catch {
+    return true;
+  }
+}
+function releaseBackfillLock() {
+  try {
+    unlinkSync2(BACKFILL_LOCK);
+  } catch {
+  }
+}
 
 // src/bin/backfill-vectors.ts
 var BATCH_SIZE = 100;
 var BACKFILL_FLAG = path6.join(EXE_AI_DIR, "session-cache", "needs-backfill");
 async function backfillVectors() {
+  if (!tryAcquireBackfillLock()) {
+    process.stderr.write("[backfill] Another backfill is already running \u2014 exiting\n");
+    return { processed: 0, failed: 0, remaining: -1 };
+  }
   registerWorkerPid(process.pid);
-  process.on("exit", () => cleanupWorkerPid());
-  process.on("SIGTERM", () => {
+  const cleanup = () => {
     cleanupWorkerPid();
+    releaseBackfillLock();
+  };
+  process.on("exit", cleanup);
+  process.on("SIGTERM", () => {
+    cleanup();
     process.exit(0);
   });
   process.on("SIGINT", () => {
-    cleanupWorkerPid();
+    cleanup();
     process.exit(0);
   });
   await initStore();
@@ -2132,7 +2191,7 @@ async function backfillVectors() {
   return { processed: totalProcessed, failed: totalFailed, remaining: remainingCount };
 }
 function isBackfillNeeded() {
-  return existsSync5(BACKFILL_FLAG);
+  return existsSync6(BACKFILL_FLAG);
 }
 if (isMainModule(import.meta.url)) {
   backfillVectors().then((result) => {