@paradow/ledge 0.16.1 → 0.18.0

package/README.md

@@ -42,6 +42,7 @@ ledge claude            # start Claude Code in a tracked tmux session (tab renam
 ledge claude --name max # pick the session's Ledge name
 ledge status            # list bots and what they wait for
 ledge attach <id>       # put this terminal on a running session (what the overlay opens a tab with)
+ledge tui               # follow and answer every session from this terminal (--notify bell|osc9|off)
 ledge daemon            # run the daemon in the foreground (normally run by the systemd service)
 ledge uninstall         # undo ledge setup: hooks, service and ~/.local/bin/ledge (--purge: ~/.ledge too)
 ```
@@ -65,6 +66,7 @@ systemctl --user disable --now ledge-daemon.service   # back to on-demand start
 ~/.ledge/daemon.log     dropped hooks, failed injections, poll errors
 ~/.ledge/chat.json      the day's chat conversation (date, session id)
 ~/.ledge/chat/context/  files the chat reads (sessions.md, pane-*, reply-*, git-*)
+~/.ledge/tui.json       ledge tui's settings (its language)
 ~/.ledge/daemon.pid     PID of the running daemon, removed when it stops cleanly
 ~/.config/systemd/user/ledge-daemon.service   user unit written by `ledge setup`
 ~/.ledge/exit-<id>      transient: the agent's exit code, written by the launcher's wrapper when the agent ends and read and deleted by `ledge claude`

package/dist/cli/{attach-5H727FCW.js → attach-I6TTCGNV.js}

@@ -1,19 +1,24 @@
 import {
   attachEnv
-} from "./chunk-MQICEVKR.js";
+} from "./chunk-QQZALYNI.js";
+import "./chunk-7IQ6FV2F.js";
+import "./chunk-3EIRKAX7.js";
+import "./chunk-OLLQBK6N.js";
+import "./chunk-KKNE7BFZ.js";
+import "./chunk-3HCID6NW.js";
+import "./chunk-TRTS24PF.js";
 import {
   connect
-} from "./chunk-DEXDXDO4.js";
-import "./chunk-H36JD4E3.js";
+} from "./chunk-GXFU4XAX.js";
 import {
   PROTOCOL_PORT,
   backendOf
-} from "./chunk-Q5WWH7FG.js";
+} from "./chunk-HP3G2TYJ.js";
 import {
   realTmux
-} from "./chunk-2H5FJH4Q.js";
-import "./chunk-BNKPXSUY.js";
-import "./chunk-R5462SQM.js";
+} from "./chunk-WJ6YMZTT.js";
+import "./chunk-43D6NMYH.js";
+import "./chunk-7ZAA75HG.js";
 
 // src/cli/attach.ts
 import { spawn } from "child_process";

package/dist/cli/{bridge-LXMOQN6Q.js → bridge-APNFBPNE.js}

@@ -7,8 +7,8 @@ import {
   parseClientMessage,
   parseServerMessage,
   readDaemonToken
-} from "./chunk-Q5WWH7FG.js";
-import "./chunk-R5462SQM.js";
+} from "./chunk-HP3G2TYJ.js";
+import "./chunk-7ZAA75HG.js";
 
 // src/cli/bridge.ts
 import WebSocket from "ws";

package/dist/cli/chunk-3EIRKAX7.js

@@ -0,0 +1,165 @@
+import {
+  definitionDirs,
+  definitionFiles,
+  listRoles,
+  readSmall,
+  unquote
+} from "./chunk-3HCID6NW.js";
+import {
+  SeatsSchema,
+  TeamNameSchema
+} from "./chunk-HP3G2TYJ.js";
+import {
+  log
+} from "./chunk-43D6NMYH.js";
+import {
+  ledgeDir
+} from "./chunk-7ZAA75HG.js";
+
+// src/daemon/teams.ts
+import { writeFileSync, mkdirSync, renameSync } from "fs";
+import { join } from "path";
+var scalar = (raw) => unquote(raw.replace(/\s+#.*$/, "").trim());
+function flowMap(raw) {
+  const inner = raw.trim().replace(/^\{/, "").replace(/\}$/, "");
+  const out = {};
+  for (const part of inner.split(",")) {
+    if (!part.trim()) continue;
+    const i = part.indexOf(":");
+    if (i <= 0) throw new Error(`not a key: value pair: ${part.trim().slice(0, 40)}`);
+    out[part.slice(0, i).trim()] = scalar(part.slice(i + 1));
+  }
+  return out;
+}
+function parseTemplateText(text) {
+  const src = text.replace(/^/, "").replace(/\r\n/g, "\n");
+  if (src.trimStart().startsWith("{")) return JSON.parse(src);
+  const out = {};
+  let list = null;
+  let item = null;
+  let itemIndent = -1;
+  for (const raw of src.split("\n")) {
+    if (!raw.trim() || raw.trimStart().startsWith("#")) continue;
+    if (raw.includes("	")) throw new Error("tabs are not allowed in YAML");
+    const indent = raw.length - raw.trimStart().length;
+    const line = raw.trim();
+    if (indent === 0 && !line.startsWith("- ")) {
+      item = null;
+      list = null;
+      const i2 = line.indexOf(":");
+      if (i2 <= 0) throw new Error(`line without a key: ${line.slice(0, 60)}`);
+      const key = line.slice(0, i2).trim();
+      const rest = line.slice(i2 + 1).trim();
+      if (rest === "") {
+        list = [];
+        out[key] = list;
+      } else if (rest.startsWith("[")) out[key] = rest.replace(/^\[|\]$/g, "").split(",").map(scalar).filter(Boolean);
+      else out[key] = scalar(rest);
+      continue;
+    }
+    if (!list) throw new Error(`indented line outside a list: ${line.slice(0, 60)}`);
+    if (line.startsWith("- ") || line === "-") {
+      const rest = line.slice(1).trim();
+      if (rest.startsWith("{")) {
+        list.push(flowMap(rest));
+        item = null;
+        continue;
+      }
+      item = {};
+      itemIndent = indent;
+      list.push(item);
+      if (rest) {
+        const i2 = rest.indexOf(":");
+        if (i2 <= 0) {
+          list[list.length - 1] = scalar(rest);
+          item = null;
+          continue;
+        }
+        item[rest.slice(0, i2).trim()] = scalar(rest.slice(i2 + 1));
+      }
+      continue;
+    }
+    if (!item || indent <= itemIndent) throw new Error(`line outside a seat: ${line.slice(0, 60)}`);
+    const i = line.indexOf(":");
+    if (i <= 0) throw new Error(`line without a key: ${line.slice(0, 60)}`);
+    item[line.slice(0, i).trim()] = scalar(line.slice(i + 1));
+  }
+  return out;
+}
+function parseTemplate(id, text, source, path) {
+  let raw;
+  try {
+    raw = parseTemplateText(text);
+  } catch (e) {
+    return e.message;
+  }
+  const name = TeamNameSchema.safeParse(typeof raw.name === "string" ? raw.name : id);
+  if (!name.success) return "name: a name of 1 to 60 characters";
+  const seats = SeatsSchema.safeParse(raw.seats);
+  if (!seats.success) {
+    const issue = seats.error.issues[0];
+    return `seats${issue.path.length ? `.${issue.path.join(".")}` : ""}: ${issue.message}`;
+  }
+  return { id, name: name.data, seats: seats.data, source, path };
+}
+function listTemplates(cwd) {
+  const templates = /* @__PURE__ */ new Map();
+  const problems = [];
+  for (const { dir, source } of definitionDirs("teams", cwd)) {
+    for (const path of definitionFiles(dir, [".yaml", ".yml"])) {
+      const id = path.slice(dir.length + 1).replace(/\.ya?ml$/, "");
+      if (templates.has(id)) continue;
+      let t;
+      try {
+        t = parseTemplate(id, readSmall(path), source, path);
+      } catch (e) {
+        t = e.message;
+      }
+      if (typeof t === "string") {
+        log(`team ${path} skipped: ${t}`);
+        problems.push({ path, reason: t });
+        continue;
+      }
+      templates.set(id, t);
+    }
+  }
+  return { templates: [...templates.values()].sort((a, b) => a.id.localeCompare(b.id)), problems };
+}
+function resolveSeats(seats, roles, defaults = { tool: "claude" }) {
+  const byId = new Map(roles.map((r) => [r.id, r]));
+  const unknown = seats.filter((s) => !byId.has(s.role)).map((s) => s.role);
+  if (unknown.length) return { unknown };
+  return seats.map((s) => {
+    const role = byId.get(s.role);
+    const tool = s.tool ?? role.tool ?? defaults.tool;
+    const own = s.tool === void 0 || s.tool === role.tool;
+    const model = s.model ?? (own ? role.model : void 0) ?? (tool === defaults.tool ? defaults.model : void 0);
+    const effort = s.effort ?? (own ? role.effort : void 0) ?? (tool === defaults.tool ? defaults.effort : void 0);
+    return { role, tool, ...model ? { model } : {}, ...effort ? { effort } : {}, ...s.name ? { name: s.name } : {} };
+  });
+}
+function listDefinitions(cwd) {
+  const r = listRoles(cwd);
+  const t = listTemplates(cwd);
+  return { roles: r.roles, templates: t.templates, problems: [...r.problems, ...t.problems] };
+}
+function templateId(name) {
+  const id = name.normalize("NFD").replace(/[̀-ͯ]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 64);
+  return id || "team";
+}
+var yamlScalar = (v) => /^[\w./@:+-]+$/.test(v) && !/^(true|false|null|yes|no|~)$/i.test(v) ? v : JSON.stringify(v);
+function saveTemplate(name, seats, dir = join(ledgeDir(), "teams")) {
+  const path = join(dir, `${templateId(name)}.yaml`);
+  const lines = [`name: ${yamlScalar(name)}`, "seats:", ...seats.map((s) => `  - { ${Object.entries(s).filter(([, v]) => v !== void 0).map(([k, v]) => `${k}: ${yamlScalar(String(v))}`).join(", ")} }`), ""];
+  mkdirSync(dir, { recursive: true });
+  const tmp = `${path}.tmp`;
+  writeFileSync(tmp, lines.join("\n"));
+  renameSync(tmp, path);
+  return path;
+}
+
+export {
+  resolveSeats,
+  listDefinitions,
+  saveTemplate
+};

package/dist/cli/chunk-3HCID6NW.js

@@ -0,0 +1,145 @@
+import {
+  ROLE_LABEL_MAX,
+  ROLE_PROMPT_MAX,
+  RoleSchema
+} from "./chunk-HP3G2TYJ.js";
+import {
+  log
+} from "./chunk-43D6NMYH.js";
+import {
+  ledgeDir
+} from "./chunk-7ZAA75HG.js";
+
+// src/daemon/roles.ts
+import { existsSync, readdirSync, readFileSync, statSync } from "fs";
+import { dirname, join, resolve } from "path";
+var FILE_MAX = 64 * 1024;
+function repoRoot(cwd) {
+  const start = resolve(cwd);
+  for (let dir = start; ; dir = dirname(dir)) {
+    if (existsSync(join(dir, ".git"))) return dir;
+    if (dirname(dir) === dir) return start;
+  }
+}
+function definitionDirs(kind, cwd) {
+  const home = join(ledgeDir(), kind);
+  const repo = cwd ? join(repoRoot(cwd), ".ledge", kind) : void 0;
+  return [...repo && resolve(repo) !== resolve(home) ? [{ dir: repo, source: "repo" }] : [], { dir: home, source: "home" }];
+}
+function definitionFiles(dir, ext) {
+  let names;
+  try {
+    names = readdirSync(dir);
+  } catch {
+    return [];
+  }
+  return names.filter((n) => ext.some((e) => n.endsWith(e)) && !n.startsWith(".")).sort().map((n) => join(dir, n)).filter((p) => {
+    try {
+      return statSync(p).isFile();
+    } catch {
+      return false;
+    }
+  });
+}
+function readSmall(path) {
+  if (statSync(path).size > FILE_MAX) throw new Error(`file over ${FILE_MAX / 1024} KB`);
+  return readFileSync(path, "utf8");
+}
+function frontMatter(text) {
+  const src = text.replace(/^/, "").replace(/\r\n/g, "\n");
+  const m = /^---\n([\s\S]*?)\n---[ \t]*(?:\n|$)/.exec(src);
+  if (!m) return { fields: {}, body: src.trim() };
+  const fields = {};
+  for (const raw of m[1].split("\n")) {
+    const line = raw.replace(/\s+#.*$/, "").trim();
+    if (!line || line.startsWith("#")) continue;
+    const i = line.indexOf(":");
+    if (i <= 0) throw new Error(`front matter line without a key: ${line.slice(0, 60)}`);
+    fields[line.slice(0, i).trim()] = unquote(line.slice(i + 1).trim());
+  }
+  return { fields, body: src.slice(m[0].length).trim() };
+}
+var unquote = (v) => v.length >= 2 && (v[0] === '"' || v[0] === "'") && v.at(-1) === v[0] ? v.slice(1, -1) : v;
+var ROLE_KEYS = /* @__PURE__ */ new Set(["label", "tool", "model", "effort", "autonomy"]);
+function parseRole(id, text, source, path) {
+  let parsed;
+  try {
+    parsed = frontMatter(text);
+  } catch (e) {
+    return e.message;
+  }
+  const { fields, body } = parsed;
+  const unknown = Object.keys(fields).find((k) => !ROLE_KEYS.has(k));
+  if (unknown) return `unknown key ${unknown}`;
+  if (body.length > ROLE_PROMPT_MAX) return `prompt over ${ROLE_PROMPT_MAX} characters`;
+  const label = (fields.label ?? id).slice(0, ROLE_LABEL_MAX);
+  const r = RoleSchema.safeParse({
+    id,
+    label,
+    prompt: body,
+    source,
+    path,
+    ...fields.tool ? { tool: fields.tool } : {},
+    ...fields.model ? { model: fields.model } : {},
+    ...fields.effort ? { effort: fields.effort } : {},
+    ...fields.autonomy ? { autonomy: fields.autonomy } : {}
+  });
+  if (!r.success) {
+    const issue = r.error.issues[0];
+    return `${issue.path.join(".") || "role"}: ${issue.message}`;
+  }
+  return r.data;
+}
+function listRoles(cwd) {
+  const roles = /* @__PURE__ */ new Map();
+  const problems = [];
+  for (const { dir, source } of definitionDirs("roles", cwd)) {
+    for (const path of definitionFiles(dir, [".md"])) {
+      const id = path.slice(dir.length + 1, -".md".length);
+      if (roles.has(id)) continue;
+      let r;
+      try {
+        r = parseRole(id, readSmall(path), source, path);
+      } catch (e) {
+        r = e.message;
+      }
+      if (typeof r === "string") {
+        log(`role ${path} skipped: ${r}`);
+        problems.push({ path, reason: r });
+        continue;
+      }
+      roles.set(id, r);
+    }
+  }
+  return { roles: [...roles.values()].sort((a, b) => a.id.localeCompare(b.id)), problems };
+}
+function findRole(id, cwd) {
+  return listRoles(cwd).roles.find((r) => r.id === id);
+}
+function autonomyArgs(tool, autonomy) {
+  if (!autonomy || autonomy === "ask") return [];
+  switch (tool) {
+    case "claude":
+      return ["--permission-mode", autonomy === "edits" ? "acceptEdits" : "auto"];
+    case "codex":
+      return autonomy === "edits" ? ["--ask-for-approval", "on-request"] : ["--ask-for-approval", "never", "--sandbox", "workspace-write"];
+    case "cursor":
+      return autonomy === "auto" ? ["--force"] : [];
+    case "omp":
+      return [];
+  }
+}
+function ompApprovalFor(autonomy) {
+  return autonomy === "auto" ? "yolo" : autonomy ? "always-ask" : void 0;
+}
+
+export {
+  definitionDirs,
+  definitionFiles,
+  readSmall,
+  unquote,
+  listRoles,
+  findRole,
+  autonomyArgs,
+  ompApprovalFor
+};

package/dist/cli/{chunk-BNKPXSUY.js → chunk-43D6NMYH.js}

@@ -1,6 +1,6 @@
 import {
   paths
-} from "./chunk-R5462SQM.js";
+} from "./chunk-7ZAA75HG.js";
 
 // src/log.ts
 import { appendFileSync } from "fs";