@paradow/ledge 0.17.0 → 0.19.0

package/README.md

@@ -42,11 +42,17 @@ 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 tui               # follow and answer every session (--notify bell|osc9|off); see below for Windows Terminal
 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)
 ```
 
+From a WSL tab of Windows Terminal, `ledge tui` opens in a tab of its own with the Ledge mascot as its icon. A tab's
+icon comes only from its profile, so Ledge installs a `Ledge` profile as a fragment under
+`%LOCALAPPDATA%\Microsoft\Windows Terminal\Fragments\Ledge` (no admin right needed). That profile runs
+`~/.ledge/tui.sh`, which each `ledge tui` rewrites with its node and CLI. `ledge tui --here`, tmux, SSH and any other
+terminal keep the TUI where it was started.
+
 When a Claude it launched exits, Ledge appends a `custom-title` « name - topic » to its transcript, so `claude --resume` lists the conversation that way, unless the user named it (`claude -n`, `/rename`).
 
 `ledge setup` installs `ledge-daemon.service` as a systemd user unit, starts it and enables linger, so the daemon runs from WSL boot and restarts after a crash. Rerun it after a node upgrade or a repository move: the unit is rewritten and the service restarted. Useful commands:

package/dist/cli/{attach-EYIX7FZN.js → attach-3BKQSEWC.js}

@@ -1,19 +1,24 @@
 import {
   attachEnv
-} from "./chunk-36KJUV62.js";
+} from "./chunk-LOOOHYZR.js";
+import "./chunk-WP77O5LC.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-VVK4I6B5.js";
-import "./chunk-VE4LGNXX.js";
+} from "./chunk-GXFU4XAX.js";
 import {
   PROTOCOL_PORT,
   backendOf
-} from "./chunk-QD27W6W5.js";
+} from "./chunk-HP3G2TYJ.js";
 import {
   realTmux
-} from "./chunk-LAUNHDTX.js";
-import "./chunk-JQZHXVIZ.js";
-import "./chunk-ELLXOV4Q.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-6UHCD76N.js → bridge-APNFBPNE.js}

@@ -7,8 +7,8 @@ import {
   parseClientMessage,
   parseServerMessage,
   readDaemonToken
-} from "./chunk-QD27W6W5.js";
-import "./chunk-ELLXOV4Q.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-JQZHXVIZ.js → chunk-43D6NMYH.js}

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

package/dist/cli/chunk-4RD7OJ2J.js

@@ -0,0 +1,6 @@
+// src/version.ts
+var LEDGE_VERSION = true ? "0.19.0" : "0.0.0-dev";
+
+export {
+  LEDGE_VERSION
+};

package/dist/cli/{chunk-ELLXOV4Q.js → chunk-7ZAA75HG.js}

@@ -17,7 +17,7 @@ function ledgeDir() {
 }
 function paths() {
   const dir = ledgeDir();
-  return { dir, tmuxConf: join(dir, "tmux.conf"), journal: join(dir, "sessions.json"), log: join(dir, "daemon.log"), pid: join(dir, "daemon.pid"), history: join(dir, "history"), mail: join(dir, "mail.json"), tasks: join(dir, "tasks.json"), machines: join(dir, "machines.json"), projects: join(dir, "projects.json"), island: join(dir, "island.json"), token: join(dir, "token"), mobile: join(dir, "mobile.json"), mobileSession: join(dir, "mobile-session.json"), mobileKey: join(dir, "mobile-key"), devices: join(dir, "devices.json"), revocations: join(dir, "revocations.json") };
+  return { dir, tmuxConf: join(dir, "tmux.conf"), journal: join(dir, "sessions.json"), log: join(dir, "daemon.log"), pid: join(dir, "daemon.pid"), history: join(dir, "history"), mail: join(dir, "mail.json"), tasks: join(dir, "tasks.json"), teams: join(dir, "teams-live.json"), machines: join(dir, "machines.json"), projects: join(dir, "projects.json"), island: join(dir, "island.json"), token: join(dir, "token"), mobile: join(dir, "mobile.json"), mobileSession: join(dir, "mobile-session.json"), mobileKey: join(dir, "mobile-key"), devices: join(dir, "devices.json"), revocations: join(dir, "revocations.json") };
 }
 async function ensureLedgeDir() {
   const p = paths();

package/dist/cli/{chunk-5ZCHFGCV.js → chunk-BVBX222F.js}

@@ -1,23 +1,24 @@
-import {
-  connect
-} from "./chunk-VVK4I6B5.js";
 import {
   CODEX_HOOK_VAR
-} from "./chunk-VE4LGNXX.js";
+} from "./chunk-TRTS24PF.js";
+import {
+  connect
+} from "./chunk-GXFU4XAX.js";
 import {
+  LEDGE_GIVER,
   TASK_TEXT_MAX,
   TASK_TITLE_MAX
-} from "./chunk-QD27W6W5.js";
+} from "./chunk-HP3G2TYJ.js";
 
 // src/cli/task.ts
 import { randomUUID } from "crypto";
-var TASK_USAGE = `ledge task give <nom> "<titre>" ["<d\xE9tail>"]   confier un travail \xE0 une session
+var TASK_USAGE = `ledge task give <nom|@r\xF4le> "<titre>" ["<d\xE9tail>"]   confier un travail \xE0 une session (@r\xF4le : dans ton \xE9quipe)
 ledge task list [--all]                         tes t\xE2ches (tenues ou confi\xE9es), ouvertes ; --all : closes aussi
 ledge task show <id>                            une t\xE2che, son d\xE9tail et son historique
 ledge task take <id>                            la prendre
 ledge task done <id> ["<r\xE9sultat>"]             la terminer (la session qui l'a confi\xE9e est pr\xE9venue)
 ledge task refuse <id> "<raison>"               la refuser, ou l'annuler si tu l'as confi\xE9e
-ledge task pass <id> <nom> ["<note>"]           la passer \xE0 une autre session`;
+ledge task pass <id> <nom|@r\xF4le> ["<note>"]     la passer \xE0 une autre session`;
 var TASK_MS = 4e3;
 var ID = /^t[0-9a-f]{6}$/;
 function taskArgs(args) {
@@ -58,6 +59,7 @@ function formatTask(t) {
 async function taskOnClient(client, args, by, ms) {
   const op = taskArgs(args);
   if (!op) return { line: TASK_USAGE, code: 1 };
+  if (by === LEDGE_GIVER) return { line: "refus\xE9 : seul Ledge confie une t\xE2che en son nom", code: 1 };
   try {
     client.send({ type: "task.cmd", rid: randomUUID(), by, ...op });
     const r = await client.next("task.result", ms);

package/dist/cli/{chunk-OVJL2QTN.js → chunk-FQZ3IX6E.js}

@@ -1,10 +1,10 @@
 import {
   run
-} from "./chunk-LAUNHDTX.js";
+} from "./chunk-WJ6YMZTT.js";
 import {
   ensureLedgeDir,
   paths
-} from "./chunk-ELLXOV4Q.js";
+} from "./chunk-7ZAA75HG.js";
 
 // src/cli/setup.ts
 import { readFile as readFile2, writeFile, mkdir, rename, realpath, rm, stat, lstat, readlink } from "fs/promises";

package/dist/cli/{chunk-VVK4I6B5.js → chunk-GXFU4XAX.js}

@@ -4,7 +4,7 @@ import {
   SUMMARY_MAX,
   parseServerMessage,
   readDaemonToken
-} from "./chunk-QD27W6W5.js";
+} from "./chunk-HP3G2TYJ.js";
 
 // src/client.ts
 import WebSocket from "ws";