token-goat 2.9.26 → 2.9.29

package/dist/token-goat-hook-client.cjs

@@ -0,0 +1,475 @@
+const __tgModuleUrl = require('node:url').pathToFileURL(__filename).href;
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/hook_client.ts
+var hook_client_exports = {};
+__export(hook_client_exports, {
+  WARM_CLI_COMMANDS: () => WARM_CLI_COMMANDS,
+  callServer: () => callServer,
+  queryServers: () => queryServers,
+  relayViaServer: () => relayViaServer,
+  runCliViaServer: () => runCliViaServer,
+  serverEnabled: () => serverEnabled,
+  serverStatuses: () => serverStatuses,
+  warmCliEligible: () => warmCliEligible
+});
+module.exports = __toCommonJS(hook_client_exports);
+var import_node_child_process = require("node:child_process");
+var fs2 = __toESM(require("node:fs"), 1);
+var net = __toESM(require("node:net"), 1);
+
+// src/env.ts
+var FALSY_ENV_VALUES = /* @__PURE__ */ new Set(["0", "false", "no", "off"]);
+var TRUTHY_ENV_VALUES = /* @__PURE__ */ new Set(["1", "true", "yes", "on"]);
+function envBool(key, defaultVal) {
+  const raw = process.env[key];
+  if (raw === void 0) return defaultVal;
+  const norm = raw.trim().toLowerCase();
+  if (norm === "") return defaultVal;
+  if (TRUTHY_ENV_VALUES.has(norm)) return true;
+  if (FALSY_ENV_VALUES.has(norm)) return false;
+  return defaultVal;
+}
+
+// src/hook_ipc.ts
+var crypto = __toESM(require("node:crypto"), 1);
+var fs = __toESM(require("node:fs"), 1);
+var os2 = __toESM(require("node:os"), 1);
+var path2 = __toESM(require("node:path"), 1);
+var import_node_url = require("node:url");
+
+// src/constants.ts
+var os = __toESM(require("node:os"), 1);
+var path = __toESM(require("node:path"), 1);
+
+// src/version.ts
+var import_node_module = require("node:module");
+function readManifest() {
+  if (true) return JSON.parse('{"version":"2.9.29","name":"token-goat","bugs":{"url":"https://github.com/DFKHelper/token-goat/issues"}}');
+  try {
+    return (0, import_node_module.createRequire)(__tgModuleUrl)("../package.json");
+  } catch {
+    return {};
+  }
+}
+var manifest = readManifest();
+var VERSION = manifest.version ?? "0.0.0";
+var PACKAGE_NAME = manifest.name !== void 0 && manifest.name !== "" ? manifest.name : "token-goat";
+var ISSUES_URL = manifest.bugs?.url !== void 0 && manifest.bugs.url !== "" ? manifest.bugs.url : "https://github.com/DFKHelper/token-goat/issues";
+
+// src/constants.ts
+function safeEnvDir(value) {
+  const stripped = value.trim();
+  if (stripped === "") return void 0;
+  if (!path.isAbsolute(stripped)) return void 0;
+  if (process.platform === "win32") {
+    const root = path.parse(stripped).root;
+    if (root === "" || root === "\\" || root === "/") return void 0;
+  }
+  return stripped;
+}
+function dataDirForHome(homeDir) {
+  const platform = process.platform;
+  if (platform === "win32") {
+    return path.join(homeDir, "AppData", "Local", "dfk-helper", "token-goat");
+  }
+  if (platform === "darwin") {
+    return path.join(homeDir, "Library", "Application Support", "token-goat");
+  }
+  return path.join(homeDir, ".local", "share", "token-goat");
+}
+function homeFallbackOrGuard() {
+  const inVitest = process.env["VITEST_WORKER_ID"] !== void 0 || process.env["VITEST"] === "true";
+  if (inVitest && process.env["VITEST_ALLOW_REAL_DATA_DIR"] !== "1") {
+    throw new Error(
+      "token-goat: refusing to resolve DATA_DIR against the real home directory inside a Vitest worker (LOCALAPPDATA/XDG_DATA_HOME is unset). This would read or write the developer's real global.db/config.toml. Set LOCALAPPDATA/XDG_DATA_HOME explicitly for this process, or VITEST_ALLOW_REAL_DATA_DIR=1 if this is an intentional mocked-home test."
+    );
+  }
+  return dataDirForHome(os.homedir());
+}
+function defaultDataDir() {
+  const platform = process.platform;
+  if (platform === "win32") {
+    const raw = process.env["LOCALAPPDATA"] ?? "";
+    const base2 = raw ? safeEnvDir(raw) : void 0;
+    if (base2 !== void 0) {
+      return path.join(base2, "dfk-helper", "token-goat");
+    }
+    return homeFallbackOrGuard();
+  }
+  if (platform === "darwin") {
+    const raw = process.env["XDG_DATA_HOME"] ?? "";
+    const base2 = raw ? safeEnvDir(raw) : void 0;
+    if (base2 !== void 0) {
+      return path.join(base2, "token-goat");
+    }
+    return homeFallbackOrGuard();
+  }
+  const xdg = process.env["XDG_DATA_HOME"] ?? "";
+  const base = xdg ? safeEnvDir(xdg) : void 0;
+  if (base !== void 0) {
+    return path.join(base, "token-goat");
+  }
+  return homeFallbackOrGuard();
+}
+var DATA_DIR = defaultDataDir();
+function dataDir() {
+  return DATA_DIR;
+}
+function configPath() {
+  return path.join(DATA_DIR, "config.toml");
+}
+var SYMBOL_BODY_CHAR_CAP = 128 * 1024;
+
+// src/hook_ipc.ts
+var PROTOCOL_VERSION = 1;
+var SERVER_SLOTS = 3;
+var MAX_FRAME_BYTES = 64 * 1024 * 1024;
+var KEY_BYTES = 32;
+function bundleDir() {
+  const dir = path2.dirname((0, import_node_url.fileURLToPath)(__tgModuleUrl));
+  try {
+    return fs.realpathSync.native(dir);
+  } catch {
+    return dir;
+  }
+}
+function endpointId(dir) {
+  const fold = (p) => process.platform === "win32" ? p.toLowerCase() : p;
+  return crypto.createHash("sha256").update(`${fold(dir)}\0${fold(bundleDir())}`).digest("hex").slice(0, 16);
+}
+function endpointFor(slot, dir = dataDir()) {
+  const id = `${endpointId(dir)}-${slot}`;
+  if (process.platform === "win32") return String.raw`\\.\pipe\token-goat-hooks-` + id;
+  const inData = path2.join(dir, `hooks-${id}.sock`);
+  if (Buffer.byteLength(inData) < 100) return inData;
+  const own = privateTempDir();
+  return own === void 0 ? inData : path2.join(own, `${id}.sock`);
+}
+function privateTempDir() {
+  const uid = process.getuid?.();
+  if (uid === void 0) return void 0;
+  const own = path2.join(os2.tmpdir(), `token-goat-${uid}`);
+  try {
+    fs.mkdirSync(own, { mode: 448 });
+  } catch {
+  }
+  try {
+    const st = fs.lstatSync(own);
+    return st.isDirectory() && st.uid === uid && (st.mode & 63) === 0 ? own : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function serverKeyPath(dir = dataDir()) {
+  return path2.join(dir, "hook-server.key");
+}
+function keyIsPrivate(st) {
+  if (process.platform === "win32") return true;
+  return (st.mode & 63) === 0 && (process.getuid === void 0 || st.uid === process.getuid());
+}
+function readServerKey(dir = dataDir()) {
+  try {
+    const p = serverKeyPath(dir);
+    if (!keyIsPrivate(fs.statSync(p))) return void 0;
+    const key = fs.readFileSync(p);
+    return key.length === KEY_BYTES ? key : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function nonce() {
+  return crypto.randomBytes(16).toString("hex");
+}
+function mac(key, ...parts) {
+  const h = crypto.createHmac("sha256", key);
+  for (const part of parts) h.update(`${Buffer.byteLength(part)}:`).update(part);
+  return h.digest("hex");
+}
+function macMatches(expected, actual) {
+  if (typeof actual !== "string" || actual.length !== expected.length) return false;
+  return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(actual));
+}
+function writeFrame(socket, message) {
+  socket.write(encodeFrame(message));
+}
+function encodeFrame(message) {
+  const body = Buffer.from(JSON.stringify(message), "utf8");
+  const header = Buffer.alloc(4);
+  header.writeUInt32BE(body.length, 0);
+  return Buffer.concat([header, body]);
+}
+function frameFits(frame) {
+  return frame.length - 4 <= MAX_FRAME_BYTES;
+}
+function readFrames(socket, onFrame, onError) {
+  let buffered = Buffer.alloc(0);
+  socket.on("data", (chunk) => {
+    buffered = buffered.length === 0 ? chunk : Buffer.concat([buffered, chunk]);
+    while (buffered.length >= 4) {
+      const len = buffered.readUInt32BE(0);
+      if (len > MAX_FRAME_BYTES) {
+        onError(new Error(`frame of ${len} bytes exceeds ${MAX_FRAME_BYTES}`));
+        socket.destroy();
+        return;
+      }
+      if (buffered.length < 4 + len) return;
+      const body = buffered.subarray(4, 4 + len);
+      buffered = buffered.subarray(4 + len);
+      let message;
+      try {
+        message = JSON.parse(body.toString("utf8"));
+      } catch (e) {
+        onError(e);
+        socket.destroy();
+        return;
+      }
+      if (message === null || typeof message !== "object" || Array.isArray(message)) {
+        onError(new Error("frame is not a JSON object"));
+        socket.destroy();
+        return;
+      }
+      onFrame(message);
+    }
+  });
+}
+function envSnapshot() {
+  const env = {};
+  for (const [k, v] of Object.entries(process.env)) if (v !== void 0) env[k] = v;
+  return env;
+}
+function markerPath(name, dir = dataDir()) {
+  return path2.join(dir, `hook-server.${name}`);
+}
+function markerAgeMs(name, dir = dataDir()) {
+  try {
+    return Date.now() - fs.statSync(markerPath(name, dir)).mtimeMs;
+  } catch {
+    return Infinity;
+  }
+}
+function touchMarker(name, content = String(process.pid), dir = dataDir()) {
+  try {
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(markerPath(name, dir), content);
+  } catch {
+  }
+}
+function configStamp() {
+  try {
+    return String(fs.statSync(configPath()).mtimeMs);
+  } catch {
+    return "absent";
+  }
+}
+function readMarker(name, dir = dataDir()) {
+  try {
+    return fs.readFileSync(markerPath(name, dir), "utf8");
+  } catch {
+    return void 0;
+  }
+}
+function launcherPath() {
+  return path2.join(bundleDir(), "token-goat.mjs");
+}
+
+// src/hook_client.ts
+var HANDSHAKE_TIMEOUT_MS = 150;
+var FIND_BUDGET_MS = 300;
+var RESPONSE_TIMEOUT_MS = 12e4;
+var CONTROL_WAIT_MS = 1e4;
+var SPAWN_RETRY_MS = 3e4;
+var DISABLED_MARKER_TTL_MS = 10 * 6e4;
+function attempt(slot, key, request, handshakeMs, dir) {
+  return new Promise((resolve) => {
+    const socket = net.connect(endpointFor(slot, dir));
+    const nc = nonce();
+    let dispatched = false;
+    let settled = false;
+    const finish = (outcome) => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      socket.destroy();
+      resolve(outcome);
+    };
+    let timer = setTimeout(() => finish({ kind: "busy" }), handshakeMs);
+    socket.on("error", (e) => {
+      if (dispatched) finish({ kind: "lost" });
+      else finish({ kind: e.code === "ENOENT" || e.code === "ECONNREFUSED" ? "absent" : "refused" });
+    });
+    socket.on("close", () => finish({ kind: dispatched ? "lost" : "refused" }));
+    const control = request.kind === "status" || request.kind === "stop";
+    socket.on("connect", () => writeFrame(socket, { t: "hello", v: PROTOCOL_VERSION, nc, ...control ? { ctl: true } : {} }));
+    let ns = "";
+    readFrames(
+      socket,
+      (msg) => {
+        if (msg["t"] === "busy") return finish({ kind: "busy" });
+        if (msg["t"] === "stale") return finish({ kind: "stale" });
+        if (msg["t"] === "challenge" && !dispatched) {
+          ns = typeof msg["ns"] === "string" ? msg["ns"] : "";
+          if (ns === "" || msg["v"] !== PROTOCOL_VERSION || !macMatches(mac(key, "S", nc, ns), msg["mac"])) return finish({ kind: "refused" });
+          const body = JSON.stringify(request);
+          const frame = encodeFrame({ t: "req", mac: mac(key, "C", nc, ns, body), body });
+          if (!frameFits(frame)) return finish({ kind: "oversize" });
+          dispatched = true;
+          clearTimeout(timer);
+          timer = setTimeout(() => finish({ kind: "lost" }), RESPONSE_TIMEOUT_MS);
+          socket.write(frame);
+          return;
+        }
+        if (msg["t"] === "res" && dispatched) {
+          const body = msg["body"];
+          if (typeof body !== "string" || !macMatches(mac(key, "R", nc, ns, body), msg["mac"])) return finish({ kind: "lost" });
+          try {
+            return finish({ kind: "served", reply: JSON.parse(body) });
+          } catch {
+            return finish({ kind: "lost" });
+          }
+        }
+        finish({ kind: dispatched ? "lost" : "refused" });
+      },
+      () => finish({ kind: dispatched ? "lost" : "refused" })
+    );
+  });
+}
+function startServer(slot) {
+  const launcher = launcherPath();
+  const disabled = markerAgeMs("disabled") < DISABLED_MARKER_TTL_MS && readMarker("disabled") === configStamp();
+  if (disabled || markerAgeMs(`spawn-${slot}`) < SPAWN_RETRY_MS || !fs2.existsSync(launcher)) return;
+  touchMarker(`spawn-${slot}`);
+  try {
+    (0, import_node_child_process.spawn)(process.execPath, [launcher, "hook-server", "run", "--slot", String(slot)], { detached: true, stdio: "ignore", windowsHide: true }).unref();
+  } catch {
+  }
+}
+function serverEnabled() {
+  return envBool("TOKEN_GOAT_HOOK_SERVER", true);
+}
+async function callServer(request, opts = {}) {
+  if (!serverEnabled()) return void 0;
+  const autostart = opts.autostart !== false;
+  const key = readServerKey();
+  if (key === void 0) {
+    if (autostart) startServer(0);
+    return void 0;
+  }
+  const deadline = Date.now() + FIND_BUDGET_MS;
+  for (let slot = 0; slot < SERVER_SLOTS && Date.now() < deadline; slot++) {
+    const outcome = await attempt(slot, key, request, opts.handshakeMs ?? HANDSHAKE_TIMEOUT_MS);
+    if (outcome.kind === "served") return outcome.reply;
+    if (outcome.kind === "lost") return "lost";
+    if (outcome.kind === "absent") {
+      if (autostart) startServer(slot);
+      return void 0;
+    }
+    if (outcome.kind === "stale" || outcome.kind === "oversize") return void 0;
+  }
+  return void 0;
+}
+async function relayViaServer(event, input, harnessWaitMs) {
+  try {
+    const request = {
+      kind: "hook",
+      event,
+      input: typeof input === "string" ? input : JSON.stringify(input),
+      elapsedMs: performance.now(),
+      env: envSnapshot(),
+      cwd: process.cwd()
+    };
+    if (harnessWaitMs !== void 0) request.harnessWaitMs = harnessWaitMs;
+    const reply = await callServer(request);
+    if (reply === void 0) return void 0;
+    if (reply === "lost" || !reply.ok || !("stdout" in reply)) return "{}";
+    return reply.stdout;
+  } catch {
+    return void 0;
+  }
+}
+var WARM_CLI_COMMANDS = /* @__PURE__ */ new Set([
+  "answer",
+  "brief",
+  "changed",
+  "exports",
+  "imports",
+  "map",
+  "outline",
+  "read",
+  "refs",
+  "section",
+  "semantic",
+  "skeleton",
+  "symbol"
+]);
+function warmCliEligible(argv) {
+  const command = argv[2];
+  if (command === void 0 || !WARM_CLI_COMMANDS.has(command) || process.stdout.isTTY === true) return false;
+  return !argv.slice(3).some((a) => a === "-" || a === "--stdin" || a === "--help" || a === "-h");
+}
+async function runCliViaServer(argv) {
+  if (!warmCliEligible(argv)) return false;
+  try {
+    const reply = await callServer({ kind: "cli", argv: argv.slice(2), env: envSnapshot(), cwd: process.cwd() });
+    if (reply === void 0 || reply === "lost" || !reply.ok || !("stdout" in reply)) return false;
+    if (reply.stdout !== "") process.stdout.write(reply.stdout);
+    if (reply.stderr !== void 0 && reply.stderr !== "") process.stderr.write(reply.stderr);
+    process.exitCode = reply.status ?? 0;
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function serverStatuses(dir) {
+  return (await queryServers("status", dir)).flatMap(({ reply }) => reply.ok && "info" in reply ? [reply.info] : []);
+}
+async function queryServers(kind, dir) {
+  const key = readServerKey(dir);
+  if (key === void 0) return [];
+  const deadline = Date.now() + CONTROL_WAIT_MS;
+  const answered = [];
+  for (let slot = 0; slot < SERVER_SLOTS; slot++) {
+    let outcome = await attempt(slot, key, { kind }, 2e3, dir);
+    while (outcome.kind === "busy" && Date.now() < deadline) outcome = await attempt(slot, key, { kind }, 2e3, dir);
+    if (outcome.kind === "served") answered.push({ slot, reply: outcome.reply });
+  }
+  return answered;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  WARM_CLI_COMMANDS,
+  callServer,
+  queryServers,
+  relayViaServer,
+  runCliViaServer,
+  serverEnabled,
+  serverStatuses,
+  warmCliEligible
+});

package/dist/token-goat-hook-client.mjs

@@ -0,0 +1,26 @@
+import { createRequire as __cjsRequire } from 'node:module';
+const require = __cjsRequire(import.meta.url);
+import {
+  WARM_CLI_COMMANDS,
+  callServer,
+  queryServers,
+  relayViaServer,
+  runCliViaServer,
+  serverEnabled,
+  serverStatuses,
+  warmCliEligible
+} from "./token-goat-chunk-RQGGMPCR.mjs";
+import "./token-goat-chunk-DPNLUJWB.mjs";
+import "./token-goat-chunk-IVE6U7KV.mjs";
+import "./token-goat-chunk-MELOKFDJ.mjs";
+import "./token-goat-chunk-A37V4PBF.mjs";
+export {
+  WARM_CLI_COMMANDS,
+  callServer,
+  queryServers,
+  relayViaServer,
+  runCliViaServer,
+  serverEnabled,
+  serverStatuses,
+  warmCliEligible
+};

package/dist/token-goat-hook.mjs

@@ -2,30 +2,40 @@ import { createRequire as __cjsRequire } from 'node:module';
 const require = __cjsRequire(import.meta.url);
 import {
   relayInProcess
-} from "./token-goat-chunk-JALB3KWJ.mjs";
-import "./token-goat-chunk-ZZT6PVB3.mjs";
-import "./token-goat-chunk-7Y6GWTII.mjs";
-import "./token-goat-chunk-62IHOU6L.mjs";
-import "./token-goat-chunk-MDV5VWF4.mjs";
-import "./token-goat-chunk-MBDJR6HU.mjs";
-import "./token-goat-chunk-4GEDH2WU.mjs";
-import "./token-goat-chunk-VVROQBQJ.mjs";
-import "./token-goat-chunk-M6CVNHTW.mjs";
-import "./token-goat-chunk-G6EYO5CD.mjs";
-import "./token-goat-chunk-43JFN26X.mjs";
-import "./token-goat-chunk-D2X7XN5M.mjs";
+} from "./token-goat-chunk-QO3LXVVR.mjs";
+import "./token-goat-chunk-IVWI2OCK.mjs";
+import "./token-goat-chunk-DNRPXHYH.mjs";
+import "./token-goat-chunk-RTMVLHWX.mjs";
+import "./token-goat-chunk-L7H3U27L.mjs";
+import "./token-goat-chunk-RRNZMM3A.mjs";
+import "./token-goat-chunk-E4ZOJIZK.mjs";
+import "./token-goat-chunk-E5TK5DNO.mjs";
+import "./token-goat-chunk-ZER6EAXZ.mjs";
+import "./token-goat-chunk-44BM7DDQ.mjs";
+import "./token-goat-chunk-EUSDXRXU.mjs";
+import "./token-goat-chunk-G7IWXCFF.mjs";
+import "./token-goat-chunk-H5J3C56Q.mjs";
+import "./token-goat-chunk-TDUT2CL6.mjs";
+import "./token-goat-chunk-ONXH6NZ5.mjs";
+import "./token-goat-chunk-O6I2XU4P.mjs";
+import "./token-goat-chunk-D4ETHJD6.mjs";
+import "./token-goat-chunk-52NSDWYY.mjs";
+import "./token-goat-chunk-2WOUYWLM.mjs";
+import "./token-goat-chunk-CIQ2FTY3.mjs";
 import "./token-goat-chunk-3BTK54F3.mjs";
-import "./token-goat-chunk-7EPYB34H.mjs";
-import "./token-goat-chunk-IKZLSRII.mjs";
-import "./token-goat-chunk-7SXPJOSZ.mjs";
-import "./token-goat-chunk-LRIZ7K3F.mjs";
-import "./token-goat-chunk-EEIDFMEM.mjs";
-import "./token-goat-chunk-OSUFN2FV.mjs";
-import "./token-goat-chunk-6E2IDLHF.mjs";
+import "./token-goat-chunk-VMFWNHGR.mjs";
+import "./token-goat-chunk-435UQTKD.mjs";
+import "./token-goat-chunk-7CPMDFGB.mjs";
+import "./token-goat-chunk-TGOXNAHW.mjs";
+import "./token-goat-chunk-XB5KKOCG.mjs";
+import "./token-goat-chunk-YZAAZU2S.mjs";
+import "./token-goat-chunk-IVE6U7KV.mjs";
+import "./token-goat-chunk-XYWPOSCN.mjs";
+import "./token-goat-chunk-TCQANXYC.mjs";
 import "./token-goat-chunk-NMTKNYGF.mjs";
+import "./token-goat-chunk-MELOKFDJ.mjs";
 import "./token-goat-chunk-Y4AFKTHK.mjs";
-import "./token-goat-chunk-GMOUBOX4.mjs";
-import "./token-goat-chunk-RRNZMM3A.mjs";
+import "./token-goat-chunk-JTKCQMQA.mjs";
 import {
   init_define_import_meta_env
 } from "./token-goat-chunk-A37V4PBF.mjs";

package/dist/token-goat.core.mjs

@@ -1,47 +1,15 @@
 import { createRequire as __cjsRequire } from 'node:module';
 const require = __cjsRequire(import.meta.url);
 import {
-  run
-} from "./token-goat-chunk-TG5ZPD6B.mjs";
-import "./token-goat-chunk-BH4ZVRB2.mjs";
-import "./token-goat-chunk-PAV6NNY7.mjs";
-import "./token-goat-chunk-L45IWWMC.mjs";
-import "./token-goat-chunk-RH27ZSPF.mjs";
-import "./token-goat-chunk-5M3NRJD2.mjs";
-import "./token-goat-chunk-DA43OE7L.mjs";
-import "./token-goat-chunk-7Y6GWTII.mjs";
-import "./token-goat-chunk-62IHOU6L.mjs";
-import "./token-goat-chunk-MDV5VWF4.mjs";
-import "./token-goat-chunk-MBDJR6HU.mjs";
-import "./token-goat-chunk-4GEDH2WU.mjs";
-import "./token-goat-chunk-VVROQBQJ.mjs";
-import "./token-goat-chunk-M6CVNHTW.mjs";
-import "./token-goat-chunk-G6EYO5CD.mjs";
-import "./token-goat-chunk-43JFN26X.mjs";
-import "./token-goat-chunk-D2X7XN5M.mjs";
-import "./token-goat-chunk-LKSXAMJB.mjs";
-import "./token-goat-chunk-WNBSCSAI.mjs";
-import "./token-goat-chunk-BAWKGODL.mjs";
-import "./token-goat-chunk-STYRLQIW.mjs";
-import "./token-goat-chunk-L43RKNHA.mjs";
-import "./token-goat-chunk-3BTK54F3.mjs";
-import "./token-goat-chunk-RIB6XY2V.mjs";
-import "./token-goat-chunk-XTQAOTSO.mjs";
-import "./token-goat-chunk-AH6QILZM.mjs";
-import "./token-goat-chunk-LHUP4DXZ.mjs";
-import "./token-goat-chunk-7EPYB34H.mjs";
-import "./token-goat-chunk-IKZLSRII.mjs";
-import "./token-goat-chunk-7SXPJOSZ.mjs";
-import "./token-goat-chunk-LRIZ7K3F.mjs";
-import "./token-goat-chunk-EEIDFMEM.mjs";
-import "./token-goat-chunk-OSUFN2FV.mjs";
+  runCliViaServer
+} from "./token-goat-chunk-RQGGMPCR.mjs";
+import "./token-goat-chunk-DPNLUJWB.mjs";
+import "./token-goat-chunk-IVE6U7KV.mjs";
 import {
   installEpipeGuard
-} from "./token-goat-chunk-6E2IDLHF.mjs";
+} from "./token-goat-chunk-TCQANXYC.mjs";
 import "./token-goat-chunk-NMTKNYGF.mjs";
-import "./token-goat-chunk-Y4AFKTHK.mjs";
-import "./token-goat-chunk-GMOUBOX4.mjs";
-import "./token-goat-chunk-RRNZMM3A.mjs";
+import "./token-goat-chunk-MELOKFDJ.mjs";
 import {
   init_define_import_meta_env
 } from "./token-goat-chunk-A37V4PBF.mjs";
@@ -49,4 +17,6 @@ import {
 // src/main.ts
 init_define_import_meta_env();
 installEpipeGuard();
-void run();
+void runCliViaServer(process.argv).then(async (served) => {
+  if (!served) await (await import("./token-goat-chunk-HUYUHODZ.mjs")).run();
+});

package/docs/C4_RUNTIME_ARCHITECTURE.md

@@ -80,7 +80,7 @@ flowchart TB
     end
 
     subgraph TGProcesses ["Token-Goat Runtime Containers"]
-        HookShim["🪝 Hook Shim<br/><small>[~/.claude/hooks/token-goat-shim.js]</small><br/>In-process fast path / Subprocess launcher"]:::shim
+        HookShim["🪝 Hook Shim<br/><small>[~/.claude/hooks/token-goat-shim.cjs]</small><br/>In-process fast path / Subprocess launcher"]:::shim
         HookRelay["⚡ Hook Relay & Normalizer<br/><small>[dist/token-goat-hook.mjs]</small><br/>Normalizes Codex/Gemini/Claude schemas"]:::process
         CLIBinary["💻 CLI Tool & Command Suite<br/><small>[dist/token-goat.mjs]</small><br/>100+ surgical read, outline, pack commands"]:::process
         MCPServer["🔌 MCP stdio Server<br/><small>[token-goat mcp-serve]</small><br/>18 tools: symbol, read, retrieve, section"]:::process
@@ -218,7 +218,7 @@ flowchart TB
 sequenceDiagram
     autonumber
     participant Agent as AI Agent (Claude Code)
-    participant Shim as token-goat-shim.js
+    participant Shim as token-goat-shim.cjs
     participant Relay as relay.ts / hook_registry.ts
     participant Filter as ToolFilter (tool_filters/)
     participant Store as session_store.ts & disk_cache.ts