@appchy/jarvis 0.1.43 → 0.1.44

package/bin/jarvis.mjs

@@ -8,25 +8,91 @@
  * pairs, so one binary serves our cloud, a self-hosted instance and a laptop
  * alike. For source-tree iteration with hot reload, run
  * `pnpm -C apps/cli dev` — that runs `tsx src/bin.ts` directly.
+ *
+ * It does decide WHICH BUILD, for the two commands a repo reaches jarvis with.
+ * A repo names jarvis by `command: "jarvis"` in a checked-in `.mcp.json`, so the
+ * only place a machine-specific answer can live is here.
  */
 
 import { fileURLToPath } from "url";
-import { dirname, join } from "path";
-import { existsSync } from "fs";
+import { dirname, isAbsolute, join, relative } from "path";
+import { existsSync, readFileSync, realpathSync } from "fs";
+import { homedir } from "os";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const distEntry = join(__dirname, "..", "dist", "bin.js");
 
-if (!existsSync(distEntry)) {
-  const isSourceCheckout = existsSync(join(__dirname, "..", "src", "bin.ts"));
-  console.error("Error: dist/bin.js not found.");
-  if (isSourceCheckout) {
-    console.error("  This is a source checkout. Run `pnpm -C apps/cli dev` for dev work,");
-    console.error("  or `pnpm -C apps/cli build` to produce a bundle.");
-  } else {
-    console.error("  The package may be corrupted. Reinstall with `pnpm i -g @appchy/jarvis`.");
+/** The commands a repo reaches jarvis with. Machine lifecycle — `start`, `init`, `pair` —
+ *  is deliberately absent: a redirect meant for an MCP server must never move the daemon,
+ *  which owns this machine's Claude Code and is identified by its config dir, not its build. */
+const REDIRECTED = new Set(["serve", "work"]);
+
+/** The development build to run here, or null for the one this launcher ships with.
+ *  `src/dev.ts` answers the same question for `jarvis dev status`; it cannot be imported,
+ *  because this has to decide before any bundle is loaded. Keep the two answers identical. */
+function devBuild() {
+  const command = process.argv[2];
+  if (!REDIRECTED.has(command)) return null;
+
+  const configDir = process.env.JARVIS_CONFIG_DIR ?? join(homedir(), ".jarvis");
+  let redirect;
+  try {
+    redirect = JSON.parse(readFileSync(join(configDir, "dev.json"), "utf-8"));
+  } catch {
+    return null;
   }
-  process.exit(1);
+  if (typeof redirect?.root !== "string") return null;
+
+  // Every symlink resolved on both sides: an unresolved comparison fails wherever a home
+  // or temp directory is a link, and that failure is indistinguishable from being switched off.
+  const real = (target) => {
+    try {
+      return realpathSync(target);
+    } catch {
+      return target;
+    }
+  };
+  const cwd = real(process.cwd());
+  const here =
+    redirect.all === true ||
+    (Array.isArray(redirect.repos) &&
+      redirect.repos.some((repo) => {
+        if (typeof repo !== "string") return false;
+        const rel = relative(real(repo), cwd);
+        return rel === "" || (!rel.startsWith("..") && !isAbsolute(rel));
+      }));
+  if (!here) return null;
+
+  const entry = join(redirect.root, "apps", "cli", "dist", "bin.js");
+  if (!existsSync(entry)) {
+    // Falling back silently would serve the installed build under the name of the one
+    // being tested, which is the shape of this bug nobody catches: the half you look at
+    // is right. stderr, because stdout is the MCP transport.
+    process.stderr.write(
+      `jarvis: ${redirect.root} has no build to run — using the installed one.\n` +
+        `        Build it with \`pnpm --filter @appchy/jarvis build\`.\n`,
+    );
+    return null;
+  }
+  return entry;
 }
 
-await import(distEntry);
+const dev = devBuild();
+if (dev) {
+  process.stderr.write(`jarvis: development build, from ${dev}\n`);
+  await import(dev);
+} else {
+  if (!existsSync(distEntry)) {
+    const isSourceCheckout = existsSync(join(__dirname, "..", "src", "bin.ts"));
+    console.error("Error: dist/bin.js not found.");
+    if (isSourceCheckout) {
+      console.error("  This is a source checkout. Run `pnpm -C apps/cli dev` for dev work,");
+      console.error("  or `pnpm -C apps/cli build` to produce a bundle.");
+    } else {
+      console.error("  The package may be corrupted. Reinstall with `pnpm i -g @appchy/jarvis`.");
+    }
+    process.exit(1);
+  }
+
+  await import(distEntry);
+}

package/dist/bin.js

@@ -4433,8 +4433,8 @@ async function scanTree(root) {
     for (const file of await walk(join3(work, base))) {
       const text = await readFile(file, "utf-8");
       const changedAt = (await stat(file)).mtime.toISOString().slice(0, 10);
-      const path20 = relative(work, file).split(sep).join("/");
-      const item = toWorkItem({ path: path20, text, changedAt });
+      const path22 = relative(work, file).split(sep).join("/");
+      const item = toWorkItem({ path: path22, text, changedAt });
       if (item) items.push(item);
     }
   }
@@ -5400,8 +5400,8 @@ function reason(err) {
 }
 function issueText(issues) {
   return issues.slice(0, 3).map((issue) => {
-    const path20 = (issue.path ?? []).map((step) => String(typeof step === "object" ? step.key : step)).join(".");
-    return path20 ? `${path20}: ${issue.message}` : issue.message;
+    const path22 = (issue.path ?? []).map((step) => String(typeof step === "object" ? step.key : step)).join(".");
+    return path22 ? `${path22}: ${issue.message}` : issue.message;
   }).join("; ");
 }
 function keyText(data) {
@@ -5689,9 +5689,9 @@ function localFiles(options = {}) {
       }
     },
     save: async (ctx, key, bytes) => {
-      const path20 = pathOf(ctx, key);
-      await mkdir(dirname3(path20), { recursive: true });
-      await writeFile(path20, bytes, "utf8");
+      const path22 = pathOf(ctx, key);
+      await mkdir(dirname3(path22), { recursive: true });
+      await writeFile(path22, bytes, "utf8");
     },
     locate: (ctx, key) => pathOf(ctx, key)
   });
@@ -5709,10 +5709,10 @@ async function loadConfig2(cwd) {
   let dir = resolve3(cwd);
   for (; ; ) {
     for (const name of CONFIG_NAMES) {
-      const path20 = resolve3(dir, name);
-      if (existsSync5(path20)) {
-        const config2 = await importConfig(path20);
-        validateConfig(config2, path20);
+      const path22 = resolve3(dir, name);
+      if (existsSync5(path22)) {
+        const config2 = await importConfig(path22);
+        validateConfig(config2, path22);
         return {
           ...config2,
           persistence: config2.persistence ?? localFiles(),
@@ -5728,9 +5728,9 @@ async function loadConfig2(cwd) {
     `No jarvis.config.{ts,js,mjs} found from ${cwd}. A repo maps its world in one, at its root.`
   );
 }
-async function importConfig(path20) {
+async function importConfig(path22) {
   const jiti = createJiti(import.meta.url, { moduleCache: false, alias: selfAlias() });
-  const mod = await jiti.import(path20);
+  const mod = await jiti.import(path22);
   const config2 = mod.default ?? mod;
   return config2;
 }
@@ -5783,9 +5783,9 @@ function toVendorAlias(dir) {
 function toSpecifier(subpath) {
   return subpath === "." ? PACKAGE_NAME : `${PACKAGE_NAME}/${subpath.replace(/^\.\//, "")}`;
 }
-function validateConfig(value, path20) {
+function validateConfig(value, path22) {
   const fail = (msg) => {
-    throw new Error(`${path20}: ${msg}`);
+    throw new Error(`${path22}: ${msg}`);
   };
   if (typeof value !== "object" || value === null) fail("config must export an object");
   const c = value;
@@ -6491,10 +6491,10 @@ async function git3(root, argv, timeout = 5e3) {
   }
 }
 async function fetchHeadIso(root) {
-  const path20 = await git3(root, ["rev-parse", "--git-path", "FETCH_HEAD"]);
-  if (!path20) return void 0;
+  const path22 = await git3(root, ["rev-parse", "--git-path", "FETCH_HEAD"]);
+  if (!path22) return void 0;
   try {
-    return (await stat2(resolve4(root, path20))).mtime.toISOString();
+    return (await stat2(resolve4(root, path22))).mtime.toISOString();
   } catch {
     return void 0;
   }
@@ -6571,10 +6571,10 @@ async function freshness(ctx) {
   };
 }
 async function snapshotMtimeMs(ctx) {
-  const path20 = ctx.config.persistence?.locate?.({ repoRoot: ctx.config.repoRoot }, "snapshot");
-  if (!path20) return void 0;
+  const path22 = ctx.config.persistence?.locate?.({ repoRoot: ctx.config.repoRoot }, "snapshot");
+  if (!path22) return void 0;
   try {
-    return (await stat2(path20)).mtimeMs;
+    return (await stat2(path22)).mtimeMs;
   } catch {
     return void 0;
   }
@@ -6996,10 +6996,10 @@ async function cachedEnforcerDiags(ctx, freshPaths) {
 }
 function isFresh(snapshot, repoRoot, freshPaths) {
   if (!freshPaths || freshPaths.length === 0) return true;
-  for (const path20 of freshPaths) {
+  for (const path22 of freshPaths) {
     let mtimeMs;
     try {
-      mtimeMs = statSync2(resolve5(repoRoot, path20)).mtimeMs;
+      mtimeMs = statSync2(resolve5(repoRoot, path22)).mtimeMs;
     } catch {
       return false;
     }
@@ -7652,15 +7652,15 @@ import { readFile as readFile5 } from "fs/promises";
 import { resolve as resolve6 } from "path";
 
 // ../../packages/data/src/meta.ts
-function stringMeta(metadata, path20) {
-  const value = metaValue(metadata, path20);
+function stringMeta(metadata, path22) {
+  const value = metaValue(metadata, path22);
   return typeof value === "string" ? value : void 0;
 }
-function metaValue(metadata, path20) {
+function metaValue(metadata, path22) {
   if (!metadata) return void 0;
-  if (Object.prototype.hasOwnProperty.call(metadata, path20)) return metadata[path20];
+  if (Object.prototype.hasOwnProperty.call(metadata, path22)) return metadata[path22];
   let current = metadata;
-  for (const part of path20.split(".")) {
+  for (const part of path22.split(".")) {
     if (!current || typeof current !== "object" || !Object.prototype.hasOwnProperty.call(current, part))
       return void 0;
     current = current[part];
@@ -7771,8 +7771,8 @@ function resolveScopeGovernance(ctx, members, codeNodes) {
   }
   return [...out.values()];
 }
-function resolveDirectoryGovernance(ctx, path20) {
-  let dir = path20.includes("/") ? path20.slice(0, path20.lastIndexOf("/")) : "";
+function resolveDirectoryGovernance(ctx, path22) {
+  let dir = path22.includes("/") ? path22.slice(0, path22.lastIndexOf("/")) : "";
   for (; ; ) {
     const siblings = codeNodesInDir(ctx, dir);
     if (siblings.length > 0) return resolveScopeGovernance(ctx, [], siblings);
@@ -8333,15 +8333,15 @@ async function review(ctx, req) {
       cites: []
     });
   }
-  for (const path20 of unresolved) {
-    const dirGov = resolveDirectoryGovernance(ctx, path20).filter((n) => !isWorkItem(n)).map((g) => g.id).filter((id) => !cites.has(id)).slice(0, 3);
+  for (const path22 of unresolved) {
+    const dirGov = resolveDirectoryGovernance(ctx, path22).filter((n) => !isWorkItem(n)).map((g) => g.id).filter((id) => !cites.has(id)).slice(0, 3);
     const hint = dirGov.length ? ` Files in its directory are governed by ${dirGov.join(", ")} \u2014 cite if it applies.` : "";
     findings.push({
       code: "unresolved-edit",
       severity: "info",
       confidence: "precise",
-      subject: path20,
-      message: `${path20} isn't in the graph yet (a new file, or a path that doesn't match).${hint || " No governed siblings to assess it by."}`,
+      subject: path22,
+      message: `${path22} isn't in the graph yet (a new file, or a path that doesn't match).${hint || " No governed siblings to assess it by."}`,
       cites: dirGov
     });
   }
@@ -9192,8 +9192,8 @@ async function readFileContent(workdir, relPath) {
 
 // src/workspace.ts
 var workspacePath = null;
-function setWorkspacePath(path20) {
-  workspacePath = path20;
+function setWorkspacePath(path22) {
+  workspacePath = path22;
 }
 function getWorkspacePath() {
   if (!workspacePath) {
@@ -9612,10 +9612,11 @@ import WebSocket from "ws";
 import { createRequire as createRequire2 } from "module";
 var _require = createRequire2(import.meta.url);
 var VERSION2 = _require("../package.json").version ?? "0.0.0";
-var SHA = "c87ba61";
+var IS_DEV = String(_require("../package.json").name ?? "").endsWith("-dev");
+var SHA = "d64996d";
 var BUILT = "2026-09-07";
 var BUILD = SHA ?? "source";
-var BUILD_LABEL = SHA ? `${VERSION2} (${SHA}${BUILT ? ` ${BUILT}` : ""})` : `${VERSION2} (source)`;
+var BUILD_LABEL = `${SHA ? `${VERSION2} (${SHA}${BUILT ? ` ${BUILT}` : ""})` : `${VERSION2} (source)`}${IS_DEV ? " \u2014 development build" : ""}`;
 
 // src/upstream.ts
 function createUpstreamClient(config2) {
@@ -10542,12 +10543,12 @@ function register14(program) {
 }
 
 // src/commands/mcp.ts
-async function call(path20, method, body) {
+async function call(path22, method, body) {
   const config2 = loadConfig();
   if (!config2?.token) {
     throw new Error("not connected \u2014 run `jarvis connect` first");
   }
-  const resp = await fetch(new URL(path20, config2.url ?? getJarvisUrl()), {
+  const resp = await fetch(new URL(path22, config2.url ?? getJarvisUrl()), {
     method,
     headers: {
       authorization: `Bearer ${config2.token}`,
@@ -10556,7 +10557,7 @@ async function call(path20, method, body) {
     ...body === void 0 ? {} : { body: JSON.stringify(body) }
   });
   if (!resp.ok) {
-    throw new Error(`${method} ${path20} failed: ${resp.status} ${await resp.text()}`);
+    throw new Error(`${method} ${path22} failed: ${resp.status} ${await resp.text()}`);
   }
   return await resp.json();
 }
@@ -10904,9 +10905,9 @@ function resolveRepo(repo) {
   loadEnvFile(resolve8(homedir4(), ".jarvis", "data.env"));
   return cwd;
 }
-function loadEnvFile(path20) {
+function loadEnvFile(path22) {
   try {
-    process.loadEnvFile(path20);
+    process.loadEnvFile(path22);
   } catch {
   }
 }
@@ -10927,6 +10928,102 @@ function register16(program) {
   });
 }
 
+// src/commands/dev.ts
+import path20 from "path";
+
+// src/dev.ts
+import fs18 from "fs";
+import path19 from "path";
+function redirectFile() {
+  return path19.join(getConfigDir(), "dev.json");
+}
+function readDevRedirect() {
+  try {
+    const raw = JSON.parse(fs18.readFileSync(redirectFile(), "utf-8"));
+    if (typeof raw.root !== "string" || raw.root.length === 0) return null;
+    return {
+      root: raw.root,
+      repos: Array.isArray(raw.repos) ? raw.repos.filter((r) => typeof r === "string") : [],
+      all: raw.all === true
+    };
+  } catch {
+    return null;
+  }
+}
+function saveDevRedirect(req) {
+  const dir = getConfigDir();
+  fs18.mkdirSync(dir, { recursive: true });
+  fs18.writeFileSync(redirectFile(), `${JSON.stringify(req, null, 2)}
+`);
+}
+function clearDevRedirect() {
+  fs18.rmSync(redirectFile(), { force: true });
+}
+function realPath(target) {
+  try {
+    return fs18.realpathSync(target);
+  } catch {
+    return target;
+  }
+}
+function isRedirected(req) {
+  if (req.redirect.all) return true;
+  const cwd = realPath(req.cwd);
+  return req.redirect.repos.some((repo) => {
+    const rel = path19.relative(realPath(repo), cwd);
+    return rel === "" || !rel.startsWith("..") && !path19.isAbsolute(rel);
+  });
+}
+
+// src/commands/dev.ts
+function register17(program) {
+  const dev = program.command("dev").description("Run a development build in a repo, without replacing the installed jarvis");
+  dev.command("use").argument("[where]", "'here' for the working directory, 'all' for every repo", "here").option("--root <path>", "The checkout to run. Default: the one already recorded").description("Point a repo at the development build").action((where, opts) => {
+    const current = readDevRedirect();
+    const root = path20.resolve(opts.root ?? current?.root ?? process.cwd());
+    if (where !== "here" && where !== "all") {
+      console.error(`Unknown target '${where}' \u2014 say 'here' or 'all'.`);
+      process.exitCode = 1;
+      return;
+    }
+    const repos = new Set(current?.repos ?? []);
+    if (where === "here") repos.add(realPath(process.cwd()));
+    saveDevRedirect({ root, repos: [...repos], all: where === "all" || (current?.all ?? false) });
+    console.log(
+      where === "all" ? `Every repo on this machine now serves the development build in ${root}.` : `${process.cwd()} now serves the development build in ${root}.`
+    );
+    console.log("The installed jarvis is untouched. Undo with `jarvis dev off`.");
+  });
+  dev.command("off").argument("[where]", "'here' for the working directory, 'all' to stop everywhere", "all").description("Stop serving the development build").action((where) => {
+    const current = readDevRedirect();
+    if (!current) {
+      console.log("No repo is on a development build.");
+      return;
+    }
+    if (where === "here") {
+      const repos = current.repos.filter((repo) => realPath(repo) !== realPath(process.cwd()));
+      saveDevRedirect({ ...current, repos, all: false });
+      console.log(`${process.cwd()} is back on the installed jarvis.`);
+      return;
+    }
+    clearDevRedirect();
+    console.log("Every repo is back on the installed jarvis.");
+  });
+  dev.command("status").description("Say which repos are on a development build").action(() => {
+    const current = readDevRedirect();
+    if (!current) {
+      console.log("No repo is on a development build.");
+      return;
+    }
+    console.log(`development build  ${current.root}`);
+    console.log(current.all ? "  every repo on this machine" : "");
+    for (const repo of current.repos) console.log(`  ${repo}`);
+    console.log(
+      isRedirected({ cwd: process.cwd(), redirect: current }) ? "\nHere: the development build." : "\nHere: the installed jarvis."
+    );
+  });
+}
+
 // src/graph/mcp.ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 async function runMcp(cwd, hosted = [], prompts = []) {
@@ -11464,7 +11561,7 @@ function describeStart(response) {
 // src/serve/approvals.ts
 import { readFileSync as readFileSync7 } from "fs";
 import os10 from "os";
-import path19 from "path";
+import path21 from "path";
 function pendingApproval(cwd) {
   const unapproved = unapprovedServers(cwd);
   const reasons = [
@@ -11475,15 +11572,15 @@ function pendingApproval(cwd) {
   return `it will HOLD at a prompt and take no turn, because ${reasons.join(" and ")}. Nothing will appear in Claude Code's history or in the app until somebody opens ${cwd} in Claude Code once and answers. This is a one-time gate per folder.`;
 }
 function untrustedFolder(cwd) {
-  const state2 = readJson2(path19.join(os10.homedir(), ".claude.json"));
+  const state2 = readJson2(path21.join(os10.homedir(), ".claude.json"));
   const project = state2?.projects?.[cwd];
   if (!state2) return false;
   return project?.hasTrustDialogAccepted !== true;
 }
 function unapprovedServers(cwd) {
-  const declared = readJson2(path19.join(cwd, ".mcp.json"));
+  const declared = readJson2(path21.join(cwd, ".mcp.json"));
   if (!declared?.mcpServers) return [];
-  const settings = readJson2(path19.join(cwd, ".claude", "settings.local.json"));
+  const settings = readJson2(path21.join(cwd, ".claude", "settings.local.json"));
   if (settings?.enableAllProjectMcpServers === true) return [];
   const answered = /* @__PURE__ */ new Set([
     ...settings?.enabledMcpjsonServers ?? [],
@@ -11593,7 +11690,7 @@ async function brief2(repo) {
 }
 
 // src/commands/serve.ts
-function register17(program) {
+function register18(program) {
   program.command("serve").description("Serve this repo to an agent over stdio \u2014 what an .mcp.json launches").option("--repo <path>", "The repo to serve. Default: the working directory").action(async (opts) => {
     const repo = resolveRepo(opts.repo);
     const problem = harnessProblem();
@@ -11655,7 +11752,7 @@ function refuseNamedConfigDir() {
   );
   return true;
 }
-function register18(program) {
+function register19(program) {
   const hooks = program.command("hooks").description("Wire this machine's Claude Code to jarvis \u2014 no pairing, no daemon");
   hooks.command("install").description("Install the Claude Code hooks (the session block and the rules on edit)").action(() => {
     if (refuseNamedConfigDir()) process.exit(1);
@@ -11710,7 +11807,7 @@ Open Claude Code in a repo that has a work/ tree to see them.`);
 
 // src/commands/work.ts
 import { spawnSync as spawnSync3 } from "child_process";
-function register19(program) {
+function register20(program) {
   program.command("work").description("The board \u2014 take work, prove it, finish it").argument("[args...]", "Passed to the harness untouched").allowUnknownOption().passThroughOptions().helpOption(false).action((passed) => {
     const problem = harnessProblem();
     if (problem) {
@@ -11752,22 +11849,23 @@ function createCli() {
   register17(program);
   register18(program);
   register19(program);
+  register20(program);
   return program;
 }
 
 // src/bin.ts
 if (isRunningFromSource()) {
   const dotenv = await import("dotenv");
-  const fs18 = await import("fs");
-  const path20 = await import("path");
+  const fs19 = await import("fs");
+  const path22 = await import("path");
   let dir = process.cwd();
-  while (dir !== path20.dirname(dir)) {
-    const envPath = path20.join(dir, ".env");
-    if (fs18.existsSync(envPath)) {
+  while (dir !== path22.dirname(dir)) {
+    const envPath = path22.join(dir, ".env");
+    if (fs19.existsSync(envPath)) {
       dotenv.config({ path: envPath });
       break;
     }
-    dir = path20.dirname(dir);
+    dir = path22.dirname(dir);
   }
 }
 createCli().parse();