@paigy/harness 0.2.2 → 0.2.5

package/README.md

@@ -168,6 +168,15 @@ macOS launchd agent so hosting survives reboots — the host loop IS the service
 launchd just keeps it alive (the old "no daemon" note was about the WAKE channel,
 which still belongs to paigy-listen).
 
+## The window is not distributable (yet)
+
+npm is the ONLY shipping channel: `@paigy/harness` installs the CLI and the whole
+bridge, and updates with `npm i -g @paigy/harness@latest`. The Electron window runs
+from source (`electron .`) — there is no packaging, no Developer ID signing or
+notarization, and therefore no auto-update (macOS auto-update requires the signing).
+A downloaded unsigned app would hit Gatekeeper's "damaged" dialog, which is worse
+than no download button. Steps for when it's time: #854.
+
 ## Run it
 
 ```sh

package/dist/cli.js

@@ -11631,10 +11631,10 @@ var require_headers = __commonJS({
         const lowercaseName = isLowerCase ? name : name.toLowerCase();
         const exists = this[kHeadersMap].get(lowercaseName);
         if (exists) {
-          const delimiter2 = lowercaseName === "cookie" ? "; " : ", ";
+          const delimiter3 = lowercaseName === "cookie" ? "; " : ", ";
           this[kHeadersMap].set(lowercaseName, {
             name: exists.name,
-            value: `${exists.value}${delimiter2}${value}`
+            value: `${exists.value}${delimiter3}${value}`
           });
         } else {
           this[kHeadersMap].set(lowercaseName, { name, value });
@@ -23091,7 +23091,7 @@ var require_lib = __commonJS({
 import { spawnSync } from "child_process";
 import { existsSync } from "fs";
 import { homedir } from "os";
-import { join } from "path";
+import { delimiter, dirname, join } from "path";
 var CATALOG = [
   {
     name: "claude",
@@ -23115,7 +23115,13 @@ var CATALOG = [
   }
 ];
 function probeDirs(home = homedir()) {
-  return [join(home, ".local", "bin"), "/usr/local/bin", "/opt/homebrew/bin", join(home, ".npm-global", "bin")];
+  return [
+    dirname(process.execPath),
+    join(home, ".local", "bin"),
+    "/usr/local/bin",
+    "/opt/homebrew/bin",
+    join(home, ".npm-global", "bin")
+  ];
 }
 function which(bin) {
   const hit = spawnSync("which", [bin], { encoding: "utf8" });
@@ -23132,7 +23138,11 @@ function runProbe(argv) {
   if (!cmd) return false;
   const resolved = which(cmd);
   if (!resolved) return false;
-  return spawnSync(resolved, args, { timeout: 1e4, stdio: "ignore" }).status === 0;
+  return spawnSync(resolved, args, {
+    timeout: 1e4,
+    stdio: "ignore",
+    env: { ...process.env, PATH: [process.env.PATH, ...probeDirs()].filter(Boolean).join(delimiter) }
+  }).status === 0;
 }
 function detect(entry, deps = {}) {
   const find = deps.which ?? which;
@@ -29735,7 +29745,12 @@ var UserAnswerSchema = external_exports.discriminatedUnion("kind", [
   external_exports.object({ kind: external_exports.literal("ranked"), optionIds: external_exports.array(external_exports.string()), labels: external_exports.array(external_exports.string()).optional() }),
   external_exports.object({ kind: external_exports.literal("clarify"), chunks: external_exports.array(external_exports.string()).min(1) }),
   external_exports.object({ kind: external_exports.literal("confirm"), approved: external_exports.boolean() }),
-  external_exports.object({ kind: external_exports.literal("turns"), turns: external_exports.array(TurnSchema).min(1) })
+  external_exports.object({ kind: external_exports.literal("turns"), turns: external_exports.array(TurnSchema).min(1) }),
+  /** An auto-answer derived from the user's PAST decisions (broker/precedent-design.md §2):
+   *  delivered through the same settle/await path as a human answer, carrying the judge's
+   *  derivation and the precedent ids it grew from. Always paired with a visible trail
+   *  card the user can reply to — the broker never overrides the user. */
+  external_exports.object({ kind: external_exports.literal("precedent"), answer: external_exports.string(), derivation: external_exports.string(), sources: external_exports.array(external_exports.string()).min(1) })
 ]);
 var IntentSchema = external_exports.object({
   // The full vocabulary the bot's mapper emits (mapper.INTENT_KINDS) — the schema lagged
@@ -30804,7 +30819,7 @@ function landIntents(intents) {
   });
 }
 async function checkReplies(opts = {}) {
-  const token = readToken();
+  const token = authToken(opts.token);
   const res = ensureAuthed(await reach(`${BACKEND_URL}/api/pending`, {
     headers: { authorization: `Bearer ${token}` }
   }));
@@ -31084,7 +31099,12 @@ var UserAnswerSchema2 = external_exports.discriminatedUnion("kind", [
   external_exports.object({ kind: external_exports.literal("ranked"), optionIds: external_exports.array(external_exports.string()), labels: external_exports.array(external_exports.string()).optional() }),
   external_exports.object({ kind: external_exports.literal("clarify"), chunks: external_exports.array(external_exports.string()).min(1) }),
   external_exports.object({ kind: external_exports.literal("confirm"), approved: external_exports.boolean() }),
-  external_exports.object({ kind: external_exports.literal("turns"), turns: external_exports.array(TurnSchema2).min(1) })
+  external_exports.object({ kind: external_exports.literal("turns"), turns: external_exports.array(TurnSchema2).min(1) }),
+  /** An auto-answer derived from the user's PAST decisions (broker/precedent-design.md §2):
+   *  delivered through the same settle/await path as a human answer, carrying the judge's
+   *  derivation and the precedent ids it grew from. Always paired with a visible trail
+   *  card the user can reply to — the broker never overrides the user. */
+  external_exports.object({ kind: external_exports.literal("precedent"), answer: external_exports.string(), derivation: external_exports.string(), sources: external_exports.array(external_exports.string()).min(1) })
 ]);
 var IntentSchema2 = external_exports.object({
   // The full vocabulary the bot's mapper emits (mapper.INTENT_KINDS) — the schema lagged
@@ -31956,6 +31976,9 @@ function spokenText(answer) {
     // A call log: the user's replies are the instruction, the bot's prompts are not.
     case "turns":
       return answer.turns.map((t) => t.reply).join(" ").trim() || null;
+    // An auto-answer derived from the user's past decisions — reads like a fast human.
+    case "precedent":
+      return answer.answer;
     case "ignored":
       return null;
   }
@@ -31967,7 +31990,7 @@ var clip = (s) => (s.length > 120 ? `${s.slice(0, 117)}\u2026` : s) || "(no text
 import { spawn } from "child_process";
 import { existsSync as existsSync3 } from "fs";
 import { homedir as homedir3 } from "os";
-import { dirname, resolve, delimiter } from "path";
+import { resolve, delimiter as delimiter2 } from "path";
 
 // src/harness/acp.ts
 var none = { events: [], writes: [] };
@@ -32200,7 +32223,7 @@ function startSession(opts) {
     // PATH knows neither — live catch 2026-08-04: the first slot-wake ENOENT'd).
     env: {
       ...process.env,
-      PATH: [process.env.PATH, dirname(process.execPath), ...probeDirs()].filter(Boolean).join(delimiter),
+      PATH: [process.env.PATH, ...probeDirs()].filter(Boolean).join(delimiter2),
       ...opts.token ? { PAIGY_TOKEN: opts.token } : {}
     },
     stdio: ["pipe", "pipe", "pipe"]
@@ -32329,7 +32352,7 @@ function runHarness(opts) {
 
 // src/workspaces.ts
 import { existsSync as existsSync4, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
-import { dirname as dirname2, join as join3, resolve as resolve2 } from "path";
+import { dirname as dirname3, join as join3, resolve as resolve2 } from "path";
 import { homedir as homedir4 } from "os";
 function workspacesFile() {
   return join3(homedir4(), ".paigy", "workspaces.json");
@@ -32347,7 +32370,7 @@ function addWorkspace(dir, deps) {
   const all = listWorkspaces(deps);
   if (!all.includes(next)) {
     all.push(next);
-    mkdirSync2(dirname2(deps.file), { recursive: true });
+    mkdirSync2(dirname3(deps.file), { recursive: true });
     writeFileSync2(deps.file, JSON.stringify(all, null, 2));
   }
   return all;
@@ -32387,11 +32410,12 @@ function startHost(opts) {
     }
   }
   const SLOT_HARNESS = { "mcp-agent": "claude", codex: "codex" };
+  const WAKE_PROMPT = "You were woken because Paigy work is waiting for you. Call check_replies now and handle everything it returns, then follow your paigy instructions to stay in the loop.";
   async function sweepSlots() {
     const workspace = listWorkspaces(opts.wsDeps)[0];
     if (!workspace) return;
     for (const slot of listSlots()) {
-      const harness = SLOT_HARNESS[slot];
+      const harness = SLOT_HARNESS[slot] ?? (slot === "Desktop" ? void 0 : "claude");
       const key = `slot:${slot}`;
       if (!harness || runs.has(key)) continue;
       const token = readToken(slot);
@@ -32403,7 +32427,7 @@ function startHost(opts) {
         harness,
         cwd: workspace,
         mode: "bypass",
-        prompt: "",
+        prompt: WAKE_PROMPT,
         exclusive: true,
         token,
         // A dead run must not squat the slot — evict so the next wake can respawn.

package/dist/main.js

@@ -4577,7 +4577,7 @@ var require_lib = __commonJS({
 import { app, BrowserWindow, dialog, ipcMain } from "electron";
 import { spawn as spawn2 } from "child_process";
 import { fileURLToPath } from "url";
-import { dirname as dirname3, join as join4 } from "path";
+import { dirname as dirname4, join as join4 } from "path";
 
 // ../../packages/sdk/dist/index.js
 import { createRequire as __sdkCreateRequire } from "module";
@@ -11157,7 +11157,12 @@ var UserAnswerSchema = external_exports.discriminatedUnion("kind", [
   external_exports.object({ kind: external_exports.literal("ranked"), optionIds: external_exports.array(external_exports.string()), labels: external_exports.array(external_exports.string()).optional() }),
   external_exports.object({ kind: external_exports.literal("clarify"), chunks: external_exports.array(external_exports.string()).min(1) }),
   external_exports.object({ kind: external_exports.literal("confirm"), approved: external_exports.boolean() }),
-  external_exports.object({ kind: external_exports.literal("turns"), turns: external_exports.array(TurnSchema).min(1) })
+  external_exports.object({ kind: external_exports.literal("turns"), turns: external_exports.array(TurnSchema).min(1) }),
+  /** An auto-answer derived from the user's PAST decisions (broker/precedent-design.md §2):
+   *  delivered through the same settle/await path as a human answer, carrying the judge's
+   *  derivation and the precedent ids it grew from. Always paired with a visible trail
+   *  card the user can reply to — the broker never overrides the user. */
+  external_exports.object({ kind: external_exports.literal("precedent"), answer: external_exports.string(), derivation: external_exports.string(), sources: external_exports.array(external_exports.string()).min(1) })
 ]);
 var IntentSchema = external_exports.object({
   // The full vocabulary the bot's mapper emits (mapper.INTENT_KINDS) — the schema lagged
@@ -12226,7 +12231,7 @@ function landIntents(intents) {
   });
 }
 async function checkReplies(opts = {}) {
-  const token = readToken();
+  const token = authToken(opts.token);
   const res = ensureAuthed(await reach(`${BACKEND_URL}/api/pending`, {
     headers: { authorization: `Bearer ${token}` }
   }));
@@ -12278,7 +12283,7 @@ import { hostname } from "os";
 import { spawnSync } from "child_process";
 import { existsSync as existsSync2 } from "fs";
 import { homedir as homedir2 } from "os";
-import { join as join2 } from "path";
+import { delimiter, dirname, join as join2 } from "path";
 var CATALOG = [
   {
     name: "claude",
@@ -12302,7 +12307,13 @@ var CATALOG = [
   }
 ];
 function probeDirs(home = homedir2()) {
-  return [join2(home, ".local", "bin"), "/usr/local/bin", "/opt/homebrew/bin", join2(home, ".npm-global", "bin")];
+  return [
+    dirname(process.execPath),
+    join2(home, ".local", "bin"),
+    "/usr/local/bin",
+    "/opt/homebrew/bin",
+    join2(home, ".npm-global", "bin")
+  ];
 }
 function which(bin) {
   const hit = spawnSync("which", [bin], { encoding: "utf8" });
@@ -12319,7 +12330,11 @@ function runProbe(argv) {
   if (!cmd) return false;
   const resolved = which(cmd);
   if (!resolved) return false;
-  return spawnSync(resolved, args, { timeout: 1e4, stdio: "ignore" }).status === 0;
+  return spawnSync(resolved, args, {
+    timeout: 1e4,
+    stdio: "ignore",
+    env: { ...process.env, PATH: [process.env.PATH, ...probeDirs()].filter(Boolean).join(delimiter) }
+  }).status === 0;
 }
 function detect(entry, deps = {}) {
   const find = deps.which ?? which;
@@ -12346,7 +12361,7 @@ function detectAll(deps = {}) {
 
 // src/workspaces.ts
 import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
-import { dirname, join as join3, resolve } from "path";
+import { dirname as dirname2, join as join3, resolve } from "path";
 import { homedir as homedir3 } from "os";
 function workspacesFile() {
   return join3(homedir3(), ".paigy", "workspaces.json");
@@ -12364,14 +12379,14 @@ function addWorkspace(dir, deps) {
   const all = listWorkspaces(deps);
   if (!all.includes(next)) {
     all.push(next);
-    mkdirSync2(dirname(deps.file), { recursive: true });
+    mkdirSync2(dirname2(deps.file), { recursive: true });
     writeFileSync2(deps.file, JSON.stringify(all, null, 2));
   }
   return all;
 }
 function removeWorkspace(dir, deps) {
   const all = listWorkspaces(deps).filter((w) => w !== dir);
-  mkdirSync2(dirname(deps.file), { recursive: true });
+  mkdirSync2(dirname2(deps.file), { recursive: true });
   writeFileSync2(deps.file, JSON.stringify(all, null, 2));
   return all;
 }
@@ -12380,7 +12395,7 @@ function removeWorkspace(dir, deps) {
 import { spawn } from "child_process";
 import { existsSync as existsSync4 } from "fs";
 import { homedir as homedir4 } from "os";
-import { dirname as dirname2, resolve as resolve2, delimiter } from "path";
+import { resolve as resolve2, delimiter as delimiter2 } from "path";
 
 // src/harness/acp.ts
 var none = { events: [], writes: [] };
@@ -12613,7 +12628,7 @@ function startSession(opts) {
     // PATH knows neither — live catch 2026-08-04: the first slot-wake ENOENT'd).
     env: {
       ...process.env,
-      PATH: [process.env.PATH, dirname2(process.execPath), ...probeDirs()].filter(Boolean).join(delimiter),
+      PATH: [process.env.PATH, ...probeDirs()].filter(Boolean).join(delimiter2),
       ...opts.token ? { PAIGY_TOKEN: opts.token } : {}
     },
     stdio: ["pipe", "pipe", "pipe"]
@@ -12876,7 +12891,12 @@ var UserAnswerSchema2 = external_exports.discriminatedUnion("kind", [
   external_exports.object({ kind: external_exports.literal("ranked"), optionIds: external_exports.array(external_exports.string()), labels: external_exports.array(external_exports.string()).optional() }),
   external_exports.object({ kind: external_exports.literal("clarify"), chunks: external_exports.array(external_exports.string()).min(1) }),
   external_exports.object({ kind: external_exports.literal("confirm"), approved: external_exports.boolean() }),
-  external_exports.object({ kind: external_exports.literal("turns"), turns: external_exports.array(TurnSchema2).min(1) })
+  external_exports.object({ kind: external_exports.literal("turns"), turns: external_exports.array(TurnSchema2).min(1) }),
+  /** An auto-answer derived from the user's PAST decisions (broker/precedent-design.md §2):
+   *  delivered through the same settle/await path as a human answer, carrying the judge's
+   *  derivation and the precedent ids it grew from. Always paired with a visible trail
+   *  card the user can reply to — the broker never overrides the user. */
+  external_exports.object({ kind: external_exports.literal("precedent"), answer: external_exports.string(), derivation: external_exports.string(), sources: external_exports.array(external_exports.string()).min(1) })
 ]);
 var IntentSchema2 = external_exports.object({
   // The full vocabulary the bot's mapper emits (mapper.INTENT_KINDS) — the schema lagged
@@ -13737,6 +13757,9 @@ function spokenText(answer) {
     // A call log: the user's replies are the instruction, the bot's prompts are not.
     case "turns":
       return answer.turns.map((t) => t.reply).join(" ").trim() || null;
+    // An auto-answer derived from the user's past decisions — reads like a fast human.
+    case "precedent":
+      return answer.answer;
     case "ignored":
       return null;
   }
@@ -13858,11 +13881,12 @@ function startHost(opts) {
     }
   }
   const SLOT_HARNESS = { "mcp-agent": "claude", codex: "codex" };
+  const WAKE_PROMPT = "You were woken because Paigy work is waiting for you. Call check_replies now and handle everything it returns, then follow your paigy instructions to stay in the loop.";
   async function sweepSlots() {
     const workspace = listWorkspaces(opts.wsDeps)[0];
     if (!workspace) return;
     for (const slot of listSlots()) {
-      const harness = SLOT_HARNESS[slot];
+      const harness = SLOT_HARNESS[slot] ?? (slot === "Desktop" ? void 0 : "claude");
       const key = `slot:${slot}`;
       if (!harness || runs.has(key)) continue;
       const token = readToken(slot);
@@ -13874,7 +13898,7 @@ function startHost(opts) {
         harness,
         cwd: workspace,
         mode: "bypass",
-        prompt: "",
+        prompt: WAKE_PROMPT,
         exclusive: true,
         token,
         // A dead run must not squat the slot — evict so the next wake can respawn.
@@ -13913,7 +13937,7 @@ function startHost(opts) {
 }
 
 // src/main.ts
-var here = dirname3(fileURLToPath(import.meta.url));
+var here = dirname4(fileURLToPath(import.meta.url));
 var wsDeps = { file: workspacesFile() };
 var DEVICE_SLOT = "Desktop";
 var deviceToken = () => readToken(DEVICE_SLOT) || readToken();

package/package.json

@@ -1,20 +1,13 @@
 {
   "name": "@paigy/harness",
-  "version": "0.2.2",
-  "description": "Run Claude Code / Codex on this machine, bridged to Paigy \u2014 launchable from your phone.",
+  "version": "0.2.5",
+  "description": "Run Claude Code / Codex on this machine, bridged to Paigy — launchable from your phone.",
   "license": "MIT",
   "type": "module",
   "main": "dist/main.js",
   "bin": {
     "paigy-harness": "dist/cli.js"
   },
-  "scripts": {
-    "build": "tsup",
-    "dev": "pnpm build && electron .",
-    "start": "electron .",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run"
-  },
   "dependencies": {},
   "devDependencies": {
     "@types/node": "^22.0.0",
@@ -23,10 +16,10 @@
     "tsup": "^8.3.5",
     "typescript": "^5.7.2",
     "vitest": "^2.1.8",
-    "@paigy/schema": "workspace:*",
-    "@paigy/sdk": "workspace:*",
     "qrcode": "^1.5.4",
-    "zod": "^3.24.1"
+    "zod": "^3.24.1",
+    "@paigy/schema": "0.0.0",
+    "@paigy/sdk": "0.1.0"
   },
   "files": [
     "dist/cli.js",
@@ -34,5 +27,12 @@
   ],
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "pnpm build && electron .",
+    "start": "electron .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
   }
-}
+}