@arcadeai/hypotenuse 0.14.1 → 0.16.0

package/dist/hypotenuse.js

@@ -343,7 +343,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@arcadeai/hypotenuse",
-  version: "0.14.1",
+  version: "0.16.0",
   description: "Hypotenuse \u2014 run coding agents on your machine for Linear agent sessions",
   type: "module",
   license: "Apache-2.0",
@@ -377,7 +377,7 @@ var package_default = {
     lint: "tsc && biome check .",
     format: "tsc && biome check --write .",
     bundle: "bun build ./src/cli.ts --target bun --packages external --outfile dist/hypotenuse.js",
-    build: "bun build --compile --minify --sourcemap ./src/cli.ts --outfile dist/hypotenuse",
+    build: "bun build --compile --minify --sourcemap ./src/cli.ts ./skills/hypotenuse.md --loader .md:file --asset-naming='[name].[ext]' --outfile dist/hypotenuse",
     prepack: "bun run bundle"
   },
   dependencies: {
@@ -2493,7 +2493,7 @@ function applyOverrides(config, overrides, env = process.env) {
     },
     log: {
       ...config.log,
-      level: overrides.verbose ? "debug" : envLevel && LOG_LEVELS.includes(envLevel) ? envLevel : config.log.level
+      level: overrides.logLevel ?? (overrides.verbose ? "debug" : envLevel && LOG_LEVELS.includes(envLevel) ? envLevel : config.log.level)
     }
   };
 }
@@ -4037,6 +4037,124 @@ function changedFiles(cwd) {
   }
 }
 
+// src/daemon/log.ts
+import {
+  appendFileSync as appendFileSync2,
+  chmodSync as chmodSync2,
+  existsSync as existsSync7,
+  mkdirSync as mkdirSync3,
+  renameSync as renameSync2,
+  rmSync as rmSync2,
+  statSync as statSync3
+} from "fs";
+import { dirname as dirname5 } from "path";
+var LOG_ROTATE_BYTES = 10 * 1024 * 1024;
+var LOG_KEEP = 5;
+var RANK = {
+  error: 0,
+  warn: 1,
+  info: 2,
+  debug: 3,
+  trace: 4
+};
+var LEVEL_TOKEN = {
+  error: "status-error",
+  warn: "status-waiting",
+  info: "status-active",
+  debug: "text-tertiary",
+  trace: "text-tertiary"
+};
+var LINE = /^(\S+) (error|warn |info |debug|trace) (.*)$/;
+var FIELD_KEY = / ([A-Za-z][\w.]*)=/g;
+function paintLogLine(line, mode = getMode()) {
+  if (mode.depth === "none")
+    return line;
+  const match = LINE.exec(line);
+  if (!match)
+    return line;
+  const [, time = "", padded = "", rest = ""] = match;
+  const level = padded.trim();
+  const { color, dim } = createTheme(mode);
+  const token = LEVEL_TOKEN[level];
+  const body = rest.replace(FIELD_KEY, (_, key) => ` ${dim(`${key}=`)}`);
+  const message = level === "error" || level === "warn" ? color(token, body) : level === "debug" || level === "trace" ? dim(body) : body;
+  return `${dim(time)} ${color(token, padded)} ${message}`;
+}
+var PREVIEW_LIMIT = 200;
+function preview(text, level) {
+  const line = text.replace(/\s+/g, " ").trim();
+  return level !== "trace" && line.length > PREVIEW_LIMIT ? `${line.slice(0, PREVIEW_LIMIT - 1)}\u2026` : line;
+}
+
+class DaemonLog {
+  file;
+  level;
+  echo;
+  paint;
+  bytes = 0;
+  constructor(file, level, echo, paint = Boolean(process.stderr.isTTY) || process.argv.includes("--force-color") || isTruthyEnv(process.env.FORCE_COLOR)) {
+    this.file = file;
+    this.level = level;
+    this.echo = echo;
+    this.paint = paint;
+    if (file) {
+      mkdirSync3(dirname5(file), { recursive: true, mode: 448 });
+      this.bytes = existsSync7(file) ? statSync3(file).size : 0;
+    }
+  }
+  enabled(level) {
+    return RANK[level] <= RANK[this.level];
+  }
+  write(level, message, fields = {}) {
+    if (!this.enabled(level))
+      return;
+    const extra = Object.entries(fields).filter(([, v]) => v !== undefined).map(([k, v]) => `${k}=${typeof v === "string" && /\s/.test(v) ? JSON.stringify(v) : v}`).join(" ");
+    const line = `${new Date().toISOString()} ${level.padEnd(5)} ${message}${extra ? ` ${extra}` : ""}
+`;
+    if (this.echo)
+      process.stderr.write(this.paint ? `${paintLogLine(line.slice(0, -1))}
+` : line);
+    if (!this.file)
+      return;
+    try {
+      if (this.bytes + line.length > LOG_ROTATE_BYTES)
+        this.rotate();
+      const fresh = !existsSync7(this.file);
+      appendFileSync2(this.file, line, { mode: 384 });
+      if (fresh)
+        chmodSync2(this.file, 384);
+      this.bytes += Buffer.byteLength(line);
+    } catch {}
+  }
+  rotate() {
+    if (!this.file)
+      return;
+    rmSync2(`${this.file}.${LOG_KEEP}`, { force: true });
+    for (let i = LOG_KEEP - 1;i >= 1; i--) {
+      if (existsSync7(`${this.file}.${i}`))
+        renameSync2(`${this.file}.${i}`, `${this.file}.${i + 1}`);
+    }
+    if (existsSync7(this.file))
+      renameSync2(this.file, `${this.file}.1`);
+    this.bytes = 0;
+  }
+  error(message, fields) {
+    this.write("error", message, fields);
+  }
+  warn(message, fields) {
+    this.write("warn", message, fields);
+  }
+  info(message, fields) {
+    this.write("info", message, fields);
+  }
+  debug(message, fields) {
+    this.write("debug", message, fields);
+  }
+  trace(message, fields) {
+    this.write("trace", message, fields);
+  }
+}
+
 // src/daemon/main.ts
 import { spawn as spawn2 } from "child_process";
 import { createHash as createHash2 } from "crypto";
@@ -4044,7 +4162,7 @@ import { existsSync as existsSync16, readFileSync as readFileSync10, rmSync as r
 import { join as join10 } from "path";
 
 // src/acp/host.ts
-import { mkdirSync as mkdirSync6, readFileSync as readFileSync7 } from "fs";
+import { mkdirSync as mkdirSync7, readFileSync as readFileSync7 } from "fs";
 import { join as join8 } from "path";
 
 // src/telemetry/acp.ts
@@ -4431,7 +4549,7 @@ class NativeReceiver {
 }
 
 // src/worktree/co-author.ts
-import { chmodSync as chmodSync2, mkdirSync as mkdirSync3, renameSync as renameSync2, writeFileSync as writeFileSync2 } from "fs";
+import { chmodSync as chmodSync3, mkdirSync as mkdirSync4, renameSync as renameSync3, writeFileSync as writeFileSync2 } from "fs";
 import { join as join5 } from "path";
 var GIT_HOOK_NAMES = [
   "applypatch-msg",
@@ -4477,13 +4595,13 @@ exit 0
 `;
 function installCoAuthorHooks(stateDir) {
   const dir = join5(stateDir, "git-hooks");
-  mkdirSync3(dir, { recursive: true, mode: 448 });
+  mkdirSync4(dir, { recursive: true, mode: 448 });
   for (const name of GIT_HOOK_NAMES) {
     const path = join5(dir, name);
     const temporary = `${path}.${process.pid}.tmp`;
     writeFileSync2(temporary, HOOK_SCRIPT, { mode: 493 });
-    chmodSync2(temporary, 493);
-    renameSync2(temporary, path);
+    chmodSync3(temporary, 493);
+    renameSync3(temporary, path);
   }
   return dir;
 }
@@ -4500,7 +4618,7 @@ function coAuthorEnvironment(env, hooksDir, coAuthor) {
 }
 
 // src/worktree/manager.ts
-import { existsSync as existsSync9, mkdirSync as mkdirSync4, statSync as statSync3 } from "fs";
+import { existsSync as existsSync10, mkdirSync as mkdirSync5, statSync as statSync4 } from "fs";
 import { join as join6 } from "path";
 
 // src/worktree/branch.ts
@@ -4526,12 +4644,12 @@ function issueDirectory(identifier, fallback) {
 }
 
 // src/worktree/disk.ts
-import { existsSync as existsSync7, statfsSync } from "fs";
-import { dirname as dirname5 } from "path";
+import { existsSync as existsSync8, statfsSync } from "fs";
+import { dirname as dirname6 } from "path";
 function freeBytes(path, statfs = statfsSync) {
   let current = path;
-  while (!existsSync7(current)) {
-    const parent = dirname5(current);
+  while (!existsSync8(current)) {
+    const parent = dirname6(current);
     if (parent === current)
       break;
     current = parent;
@@ -4600,7 +4718,7 @@ function stderrTail(result, lines = 20) {
 }
 
 // src/worktree/lock.ts
-import { existsSync as existsSync8, readFileSync as readFileSync5, rmSync as rmSync2, writeFileSync as writeFileSync3 } from "fs";
+import { existsSync as existsSync9, readFileSync as readFileSync5, rmSync as rmSync3, writeFileSync as writeFileSync3 } from "fs";
 
 class KeyedMutex {
   tails = new Map;
@@ -4631,7 +4749,7 @@ function pidAlive(pid) {
   }
 }
 function readCheckoutLock(file) {
-  if (!existsSync8(file))
+  if (!existsSync9(file))
     return null;
   try {
     return JSON.parse(readFileSync5(file, "utf8"));
@@ -4654,7 +4772,7 @@ function takeCheckoutLock(file, agentSessionId, pid = process.pid) {
 function releaseCheckoutLock(file, agentSessionId) {
   const held = readCheckoutLock(file);
   if (!held || held.agentSessionId === agentSessionId)
-    rmSync2(file, { force: true });
+    rmSync3(file, { force: true });
 }
 
 // src/worktree/setup.ts
@@ -4823,7 +4941,7 @@ class WorktreeManager {
       this.refuseIfShort(request);
       await this.fetchBase(request, repository, baseBranch);
       const path = this.worktreePath(request, repository);
-      mkdirSync4(join6(path, ".."), { recursive: true, mode: 448 });
+      mkdirSync5(join6(path, ".."), { recursive: true, mode: 448 });
       await this.git(["worktree", "prune"], { cwd: repository.path });
       await this.must(["worktree", "add", "--detach", path, `origin/${baseBranch}`], repository.path, `create a read-only checkout of ${baseBranch}`);
       const created = this.state.insertWorktree({
@@ -4870,7 +4988,7 @@ class WorktreeManager {
   async scratch(request) {
     const id = request.assignment.agentSessionId;
     const path = join6(request.config.sessions.worktree_root, SCRATCH, String(id));
-    mkdirSync4(path, { recursive: true, mode: 448 });
+    mkdirSync5(path, { recursive: true, mode: 448 });
     const known = this.state.worktreeAt(path);
     let row;
     if (known && known.state !== "removed") {
@@ -4950,7 +5068,7 @@ ${stderrTail(fetched)}
   }
   fetchAge(repoPath) {
     try {
-      const age = this.now() - statSync3(join6(repoPath, ".git", "FETCH_HEAD")).mtimeMs;
+      const age = this.now() - statSync4(join6(repoPath, ".git", "FETCH_HEAD")).mtimeMs;
       if (age < 60000)
         return null;
       const units = [
@@ -5007,7 +5125,7 @@ ${stderrTail(fetched)}
     for (let n = 1;; n++) {
       const path = join6(parent, suffixed(dir, n));
       const row = this.state.worktreeAt(path);
-      if (!existsSync9(path) && (!row || row.state === "removed"))
+      if (!existsSync10(path) && (!row || row.state === "removed"))
         return path;
     }
   }
@@ -5062,7 +5180,7 @@ ${stderrTail(fetched)}
       const reachable = await this.fetchBase(request, repository, baseBranch);
       const { branch, local, remote } = await this.chooseBranch(request, repository, repoConfig, reachable);
       const path = this.worktreePath(request, repository);
-      mkdirSync4(join6(path, ".."), { recursive: true, mode: 448 });
+      mkdirSync5(join6(path, ".."), { recursive: true, mode: 448 });
       await this.git(["worktree", "prune"], { cwd: repository.path });
       let add;
       if (local) {
@@ -5106,7 +5224,7 @@ ${stderrTail(fetched)}
   reusable(agentSessionId) {
     const session = this.state.session(agentSessionId);
     const row = session?.worktreeId ? this.state.worktree(session.worktreeId) : null;
-    if (!row || row.kind !== "worktree" || row.state === "removed" || !existsSync9(row.path))
+    if (!row || row.kind !== "worktree" || row.state === "removed" || !existsSync10(row.path))
       return null;
     return row;
   }
@@ -5440,15 +5558,15 @@ class QuestionQueue {
 // src/acp/fs.ts
 import { randomUUID } from "crypto";
 import {
-  existsSync as existsSync10,
-  mkdirSync as mkdirSync5,
+  existsSync as existsSync11,
+  mkdirSync as mkdirSync6,
   readFileSync as readFileSync6,
   realpathSync,
-  renameSync as renameSync3,
-  rmSync as rmSync3,
+  renameSync as renameSync4,
+  rmSync as rmSync4,
   writeFileSync as writeFileSync4
 } from "fs";
-import { basename as basename2, dirname as dirname6, isAbsolute as isAbsolute5, join as join7, resolve as resolve2, sep } from "path";
+import { basename as basename2, dirname as dirname7, isAbsolute as isAbsolute5, join as join7, resolve as resolve2, sep } from "path";
 
 class OutsideWorktree extends Error {
   path;
@@ -5486,11 +5604,11 @@ class ConfinedFs {
     return real;
   }
   resolveParent(absolute) {
-    let dir = dirname6(absolute);
+    let dir = dirname7(absolute);
     const missing = [];
-    while (!existsSync10(dir) && dirname6(dir) !== dir) {
+    while (!existsSync11(dir) && dirname7(dir) !== dir) {
       missing.unshift(basename2(dir));
-      dir = dirname6(dir);
+      dir = dirname7(dir);
     }
     let real;
     try {
@@ -5524,20 +5642,20 @@ class ConfinedFs {
   write(path, content) {
     const absolute = this.absolute(path);
     let target;
-    if (existsSync10(absolute)) {
+    if (existsSync11(absolute)) {
       target = realpathSync(absolute);
       if (!this.inside(target))
         throw new OutsideWorktree(path);
     } else {
       target = join7(this.resolveParent(absolute), basename2(absolute));
     }
-    mkdirSync5(dirname6(target), { recursive: true });
-    const temp = join7(dirname6(target), `.${basename2(target)}.${randomUUID()}.tmp`);
+    mkdirSync6(dirname7(target), { recursive: true });
+    const temp = join7(dirname7(target), `.${basename2(target)}.${randomUUID()}.tmp`);
     try {
       writeFileSync4(temp, content);
-      renameSync3(temp, target);
+      renameSync4(temp, target);
     } catch (error) {
-      rmSync3(temp, { force: true });
+      rmSync4(temp, { force: true });
       throw error;
     }
   }
@@ -6490,7 +6608,7 @@ class Turn {
       this.cwd = this.workspace.cwd;
       this.branch = this.workspace.branch;
     } else {
-      mkdirSync6(this.cwd, { recursive: true, mode: 448 });
+      mkdirSync7(this.cwd, { recursive: true, mode: 448 });
     }
     if (this.endReason)
       throw new TurnFailure("stopped");
@@ -6818,6 +6936,13 @@ class Turn {
       "hypotenuse.prompt.context_bytes": Buffer.byteLength(ctx.assignment.promptContext ?? ""),
       "hypotenuse.acp.resumed": this.resumed
     }, promptText);
+    if (ctx.log.enabled("debug")) {
+      ctx.log.debug(`prompting ${this.agentId}: ${preview(promptText, ctx.log.level)}`, {
+        session: ctx.assignment.agentSessionId,
+        workItem: ctx.assignment.workItemId,
+        bytes: Buffer.byteLength(promptText)
+      });
+    }
     const request = conn.prompt(sessionId, blocks);
     this.promptSettled = request.then(() => {}, () => {});
     const answer = await this.guard(request, 0, "").catch((error) => {
@@ -7028,7 +7153,7 @@ class Turn {
 
 // src/runner/machine.ts
 import { createHash } from "crypto";
-import { existsSync as existsSync11, readFileSync as readFileSync8 } from "fs";
+import { existsSync as existsSync12, readFileSync as readFileSync8 } from "fs";
 import { hostname as hostname2 } from "os";
 var MAX_NAME = 64;
 function defaultRunnerName(host = hostname2()) {
@@ -7041,7 +7166,7 @@ function rawMachineId(env = process.env) {
   try {
     if (process.platform === "linux") {
       for (const path of ["/etc/machine-id", "/var/lib/dbus/machine-id"]) {
-        if (existsSync11(path)) {
+        if (existsSync12(path)) {
           const id = readFileSync8(path, "utf8").trim();
           if (id)
             return id;
@@ -7098,8 +7223,8 @@ function registrationHeartbeat() {
 }
 
 // src/daemon/control-socket.ts
-import { chmodSync as chmodSync3, existsSync as existsSync12, mkdirSync as mkdirSync7, rmSync as rmSync4 } from "fs";
-import { dirname as dirname7 } from "path";
+import { chmodSync as chmodSync4, existsSync as existsSync13, mkdirSync as mkdirSync8, rmSync as rmSync5 } from "fs";
+import { dirname as dirname8 } from "path";
 var METHOD_NOT_FOUND = -32601;
 var INVALID_PARAMS = -32602;
 var INTERNAL_ERROR = -32603;
@@ -7124,9 +7249,9 @@ class ControlServer {
     this.onError = onError;
   }
   listen() {
-    mkdirSync7(dirname7(this.path), { recursive: true, mode: 448 });
-    if (existsSync12(this.path))
-      rmSync4(this.path, { force: true });
+    mkdirSync8(dirname8(this.path), { recursive: true, mode: 448 });
+    if (existsSync13(this.path))
+      rmSync5(this.path, { force: true });
     const previous = process.umask(127);
     try {
       this.listener = Bun.listen({
@@ -7142,12 +7267,12 @@ class ControlServer {
     } finally {
       process.umask(previous);
     }
-    chmodSync3(this.path, 384);
+    chmodSync4(this.path, 384);
   }
   close() {
     this.listener?.stop(true);
     this.listener = null;
-    rmSync4(this.path, { force: true });
+    rmSync5(this.path, { force: true });
   }
   onData(socket, data) {
     socket.data.buffer += data.toString("utf8");
@@ -7286,90 +7411,6 @@ class DaemonApi {
   }
 }
 
-// src/daemon/log.ts
-import {
-  appendFileSync as appendFileSync2,
-  chmodSync as chmodSync4,
-  existsSync as existsSync13,
-  mkdirSync as mkdirSync8,
-  renameSync as renameSync4,
-  rmSync as rmSync5,
-  statSync as statSync4
-} from "fs";
-import { dirname as dirname8 } from "path";
-var LOG_ROTATE_BYTES = 10 * 1024 * 1024;
-var LOG_KEEP = 5;
-var RANK = {
-  error: 0,
-  warn: 1,
-  info: 2,
-  debug: 3,
-  trace: 4
-};
-
-class DaemonLog {
-  file;
-  level;
-  echo;
-  bytes = 0;
-  constructor(file, level, echo) {
-    this.file = file;
-    this.level = level;
-    this.echo = echo;
-    if (file) {
-      mkdirSync8(dirname8(file), { recursive: true, mode: 448 });
-      this.bytes = existsSync13(file) ? statSync4(file).size : 0;
-    }
-  }
-  enabled(level) {
-    return RANK[level] <= RANK[this.level];
-  }
-  write(level, message, fields = {}) {
-    if (!this.enabled(level))
-      return;
-    const extra = Object.entries(fields).filter(([, v]) => v !== undefined).map(([k, v]) => `${k}=${typeof v === "string" && /\s/.test(v) ? JSON.stringify(v) : v}`).join(" ");
-    const line = `${new Date().toISOString()} ${level.padEnd(5)} ${message}${extra ? ` ${extra}` : ""}
-`;
-    if (this.echo)
-      process.stderr.write(line);
-    if (!this.file)
-      return;
-    try {
-      if (this.bytes + line.length > LOG_ROTATE_BYTES)
-        this.rotate();
-      const fresh = !existsSync13(this.file);
-      appendFileSync2(this.file, line, { mode: 384 });
-      if (fresh)
-        chmodSync4(this.file, 384);
-      this.bytes += Buffer.byteLength(line);
-    } catch {}
-  }
-  rotate() {
-    if (!this.file)
-      return;
-    rmSync5(`${this.file}.${LOG_KEEP}`, { force: true });
-    for (let i = LOG_KEEP - 1;i >= 1; i--) {
-      if (existsSync13(`${this.file}.${i}`))
-        renameSync4(`${this.file}.${i}`, `${this.file}.${i + 1}`);
-    }
-    if (existsSync13(this.file))
-      renameSync4(this.file, `${this.file}.1`);
-    this.bytes = 0;
-  }
-  error(message, fields) {
-    this.write("error", message, fields);
-  }
-  warn(message, fields) {
-    this.write("warn", message, fields);
-  }
-  info(message, fields) {
-    this.write("info", message, fields);
-  }
-  debug(message, fields) {
-    this.write("debug", message, fields);
-  }
-}
-
 // src/daemon/pidfile.ts
 import {
   closeSync as closeSync2,
@@ -8942,6 +8983,46 @@ class Backoff {
 // src/daemon/event-sink.ts
 var BATCH_EVENTS = 50;
 var BATCH_BYTES = 64 * 1024;
+function describeEvent(event) {
+  let text;
+  switch (event.type) {
+    case "thought":
+    case "response":
+    case "error":
+      text = event.body;
+      break;
+    case "elicitation":
+      text = event.signal ? `[${event.signal}] ${event.body}` : event.body;
+      break;
+    case "action":
+      text = `${event.action} ${event.parameter}${event.result ? ` \u2192 ${event.result}` : ""}`;
+      break;
+    case "plan": {
+      const done = event.entries.filter((e) => e.status === "completed").length;
+      const now = event.entries.find((e) => e.status === "in_progress");
+      text = `${done}/${event.entries.length} done${now ? `; now: ${now.content}` : ""}`;
+      break;
+    }
+    case "summary":
+      text = event.title;
+      break;
+    case "external_url":
+      text = `${event.label} ${event.url}`;
+      break;
+    case "usage":
+      text = [
+        event.inputTokens !== undefined && `in=${event.inputTokens}`,
+        event.outputTokens !== undefined && `out=${event.outputTokens}`,
+        event.costUsd !== undefined && `cost=$${event.costUsd}`,
+        event.contextUsed !== undefined && `context=${event.contextUsed}${event.contextSize ? `/${event.contextSize}` : ""}`
+      ].filter(Boolean).join(" ");
+      break;
+    case "status":
+      text = event.state;
+      break;
+  }
+  return text;
+}
 
 class EventSink {
   state;
@@ -8971,13 +9052,14 @@ class EventSink {
       ephemeral,
       payload: { ...event, eventId, at: Date.now() }
     });
-    this.log.debug("event queued", {
-      session: target.agentSessionId,
-      workItem: target.workItemId,
-      type: event.type,
-      seq,
-      ephemeral
-    });
+    if (this.log.enabled("debug")) {
+      this.log.debug(`agent ${event.type}: ${preview(describeEvent(event), this.log.level)}`, {
+        session: target.agentSessionId,
+        workItem: target.workItemId,
+        seq,
+        ephemeral
+      });
+    }
     this.kick();
     return { eventId, seq };
   }
@@ -9872,6 +9954,14 @@ class Supervisor {
     });
     if (taken)
       slot.consumed.push(reply.activityId);
+    const { log } = this.options;
+    if (log.enabled("debug")) {
+      log.debug(`reply: ${preview(reply.body, log.level)}`, {
+        session: slot.agentSessionId,
+        workItem: slot.workItemId,
+        activity: reply.activityId
+      });
+    }
     this.options.log.info(taken ? "a reply answered the turn's question" : "a reply did not answer the turn's question; it becomes the next prompt", { session: slot.agentSessionId, workItem: slot.workItemId });
   }
   agentFor(role) {
@@ -10681,7 +10771,7 @@ function notRunning(ctx, error) {
   }
   throw error;
 }
-async function startBackground(ctx) {
+async function startBackground(ctx, logLevel) {
   const location = locateDaemon(ctx);
   const lock = await inspectLock(location.pidfile);
   if (lock.kind === "running" || lock.kind === "starting" || lock.kind === "hung") {
@@ -10696,7 +10786,8 @@ async function startBackground(ctx) {
     ...o.project ? ["--project", o.project] : [],
     ...o.verbose ? ["--verbose"] : [],
     "daemon",
-    "start"
+    "start",
+    ...logLevel ? ["--log-level", logLevel] : []
   ]);
   const child = spawn3(command, [...prefix, ...args], {
     detached: true,
@@ -10792,7 +10883,7 @@ async function tailLog(file, options) {
     const all = readFileSync11(file, "utf8").split(`
 `).filter(Boolean).filter(keep);
     for (const line of all.slice(-options.lines))
-      console.log(line);
+      console.log(paintLogLine(line));
   }
   if (!options.follow)
     return;
@@ -10818,12 +10909,15 @@ async function tailLog(file, options) {
     partial = lines.pop() ?? "";
     for (const line of lines)
       if (line && keep(line))
-        console.log(line);
+        console.log(paintLogLine(line));
   }
 }
+function logLevelOption() {
+  return new Option("--log-level <level>", "the log level, over -v, HYPOTENUSE_LOG_LEVEL, and the config file").choices(LOG_LEVELS);
+}
 function registerDaemonCommands(program) {
   const daemon = program.command("daemon").description("Run this machine as a runner");
-  daemon.command("start").description("Start the daemon (in the background unless --foreground)").option("--foreground", "run in this process; what a service manager runs").addOption(new Option("--detached-child").hideHelp()).action(async function() {
+  daemon.command("start").description("Start the daemon (in the background unless --foreground)").option("--foreground", "run in this process; what a service manager runs").addOption(logLevelOption()).addOption(new Option("--detached-child").hideHelp()).action(async function() {
     const opts = this.opts();
     if (opts.foreground) {
       const globals = this.optsWithGlobals();
@@ -10833,12 +10927,13 @@ function registerDaemonCommands(program) {
         url: globals.url,
         project: globals.project,
         verbose: globals.verbose,
+        logLevel: opts.logLevel,
         detachedChild: Boolean(opts.detachedChild)
       });
       return;
     }
     await runCommand(this, async (ctx) => {
-      const pid = await startBackground(ctx);
+      const pid = await startBackground(ctx, opts.logLevel);
       const { log } = locateDaemon(ctx);
       emit(ctx, { started: true, pid }, () => `Started the daemon (pid ${pid}). Logs: ${tildify(log, ctx.env)}`);
     });
@@ -10858,7 +10953,7 @@ function registerDaemonCommands(program) {
       }
     });
   });
-  daemon.command("restart").description("Stop the daemon (draining) and start it again").option("--timeout <duration>", "how long running turns may take before they are stopped", "10m").option("--cancel", "stop running turns at once").action(async function() {
+  daemon.command("restart").description("Stop the daemon (draining) and start it again").option("--timeout <duration>", "how long running turns may take before they are stopped", "10m").option("--cancel", "stop running turns at once").addOption(logLevelOption()).action(async function() {
     await runCommand(this, async (ctx) => {
       const opts = this.opts();
       try {
@@ -10871,7 +10966,7 @@ function registerDaemonCommands(program) {
         if (!(error instanceof DaemonNotRunning))
           throw error;
       }
-      const pid = await startBackground(ctx);
+      const pid = await startBackground(ctx, opts.logLevel);
       emit(ctx, { restarted: true, pid }, () => `Restarted the daemon (pid ${pid}).`);
     });
   });
@@ -12026,7 +12121,7 @@ function turnPlace(event) {
   }
   return t.runner ? `${t.status} on ${t.runner.name}` : t.status;
 }
-function describeEvent(event, payload) {
+function describeEvent2(event, payload) {
   const lines = [
     `${event.eventType} ${event.action}${event.issueIdentifier ? `  ${event.issueIdentifier}` : ""}`,
     `outcome    ${event.outcome}`,
@@ -12093,7 +12188,7 @@ function registerEventCommands(program) {
     await runCommand(this, async (ctx) => {
       const projectId = await ctx.projectId();
       const result = await ctx.signedInClient().request("GET", `/trigger-event/${id}`, { query: { projectId } });
-      emit(ctx, result, () => describeEvent(result.triggerEvent, result.payload));
+      emit(ctx, result, () => describeEvent2(result.triggerEvent, result.payload));
     });
   });
 }
@@ -13563,6 +13658,30 @@ function registerSessionCommands(program) {
   });
 }
 
+// src/commands/skill.ts
+import { existsSync as existsSync21, readFileSync as readFileSync12 } from "fs";
+import { join as join13 } from "path";
+var SKILL_FILE = "hypotenuse.md";
+async function readSkill() {
+  const embedded = Bun.embeddedFiles.find((file) => file.name === SKILL_FILE);
+  if (embedded)
+    return embedded.text();
+  for (const up of [[".."], ["..", ".."]]) {
+    const path = join13(import.meta.dir, ...up, "skills", SKILL_FILE);
+    if (existsSync21(path))
+      return readFileSync12(path, "utf8");
+  }
+  throw new Error(`This install has no skills/${SKILL_FILE}; reinstall hypotenuse.`);
+}
+function registerSkillCommand(program) {
+  program.command("skill").description("Print the agent skill for using this CLI (save it as SKILL.md)").action(async function() {
+    await runCommand(this, async (ctx) => {
+      const skill = await readSkill();
+      emit(ctx, { skill }, () => skill.trimEnd());
+    });
+  });
+}
+
 // src/commands/tag.ts
 function registerTagCommands(program) {
   const tag = program.command("tag").description("The selected project's permission tags");
@@ -14059,6 +14178,7 @@ function buildProgram() {
   registerServiceCommands(program);
   registerDoctorCommand(program);
   registerCheckUpdateCommand(program);
+  registerSkillCommand(program);
   registerUpgradeCommand(program);
   registerMcpCommand(program);
   return program;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcadeai/hypotenuse",
-  "version": "0.14.1",
+  "version": "0.16.0",
   "description": "Hypotenuse — run coding agents on your machine for Linear agent sessions",
   "type": "module",
   "license": "Apache-2.0",
@@ -34,7 +34,7 @@
     "lint": "tsc && biome check .",
     "format": "tsc && biome check --write .",
     "bundle": "bun build ./src/cli.ts --target bun --packages external --outfile dist/hypotenuse.js",
-    "build": "bun build --compile --minify --sourcemap ./src/cli.ts --outfile dist/hypotenuse",
+    "build": "bun build --compile --minify --sourcemap ./src/cli.ts ./skills/hypotenuse.md --loader .md:file --asset-naming='[name].[ext]' --outfile dist/hypotenuse",
     "prepack": "bun run bundle"
   },
   "dependencies": {

package/skills/hypotenuse.md

@@ -41,13 +41,14 @@ server. It calls the same HTTP actions the dashboard does, as the person who sig
 | `hypotenuse telemetry exporter list\|view\|add\|edit\|remove\|test` | Where the selected project's OpenTelemetry goes: each exporter is an OTLP/HTTP collector that receives every turn as one trace, at a content level (`metadata`, `content`, or `full` — full sends prompts and source code). `list` and `view <id>` show endpoint, level, signals, sample share, header names (never values), and the last export or error (any member); `add --name <name> --endpoint <https-url> [--header KEY=VALUE...] [--content <level>] [--signals traces,metrics,logs] [--sample 0.5] [--attribute KEY=VALUE...] [--no-agent-native] [--disabled]`; `edit <id>` with the same flags plus `--clear-headers` and `--enable\|--disable` (headers are kept unless given); `remove <id>`; `test <id>` sends a probe and prints each signal's answer, exiting 1 on a failure. Changes and tests are admin-only; header values are never printed. |
 | `hypotenuse identity list\|link\|unlink` | Links between people in the project's Linear workspace and project members; routing prefers the runners of whoever started a session. `list [--user <id>]` shows each link and how it was made (e-mail match, Linear sign-in, admin); `link --user <id> --linear-user <id> [--name] [--email]` links one (admin); `unlink <id>` removes your own link, or anyone's as an admin. |
 | `hypotenuse config init\|validate\|schema\|path` | The daemon's TOML config (`-c <path>`, else `HYPOTENUSE_CONFIG`, else `~/.config/hypotenuse/config.toml`). `init [--repo <path>...] [--force]` writes a commented starter filled in from this machine; `validate [--online] [--offline]` checks shape, references, and this machine (git clones, prompt files, agent commands), and with `--online` the server, runner token, project, and team keys — exit 0 valid (warnings allowed), 1 errors, 2 unreadable; `--json` prints `{ valid, errors: [{ path, message, hint? }], warnings }`. `schema` prints the JSON Schema; `path` prints the config, state directory, and credentials file in use. |
-| `hypotenuse daemon start\|stop\|restart\|status\|logs\|reload` | The runner daemon. `start` backgrounds it and waits until it is ready (`--foreground` stays attached, as a service manager runs it); `stop [--timeout 10m] [--cancel]` lets running turns finish (or stops them) and exits, `--force` signals it without its control socket; `status` exits 3 when it is not running; `logs [-f] [-n 200] [--session <id>]` (`--session` shows that session's agent log: the agent's stderr and ACP trace); `reload` re-reads the config and says what needs a restart. One daemon per machine. |
+| `hypotenuse daemon start\|stop\|restart\|status\|logs\|reload` | The runner daemon. `start` backgrounds it and waits until it is ready (`--foreground` stays attached, as a service manager runs it; `--log-level <level>` overrides `[log] level`, and `debug` logs every agent activity); `stop [--timeout 10m] [--cancel]` lets running turns finish (or stops them) and exits, `--force` signals it without its control socket; `status` exits 3 when it is not running; `logs [-f] [-n 200] [--session <id>]` (`--session` shows that session's agent log: the agent's stderr and ACP trace); `reload` re-reads the config and says what needs a restart. One daemon per machine. |
 | `hypotenuse agents list\|kill\|login` | The coding agents this machine runs. `list [--all]` shows the agent sessions the daemon is running (session, issue, role, agent, state, how long, pid, worktree); `kill <session-id\|ENG-123> [--reason]` stops that session's running turn, which says so in Linear (with the reason); both exit 3 when the daemon is not running. `login <agent> [--method <id>]` logs a coding agent in on this machine — a terminal login runs attached, an agent-run one over ACP — then confirms it can open a session (exit 1 if not). |
 | `hypotenuse worktrees list\|cleanup` | The git worktrees (and scratch directories) the daemon made for its sessions, one per session under `sessions.worktree_root`. `list` shows each one's repository, branch, issue, state, last use, size, and whether it is safe to remove now (not in use, no uncommitted changes, no unpushed commits, no `.hypotenuse-keep` file). `cleanup [--dry-run] [--all] [--older-than 7d] [--force]` removes what the cleanup policy allows and prints every kept one with its reason; `--all` ignores the policy, `--force` overrides every rule but "in use". Both work without a running daemon, from `state.db` and the disk. |
 | `hypotenuse service install\|uninstall\|status` | Run the daemon as a user service (launchd on macOS, systemd user unit on Linux) with the `PATH` of the installing shell; `install --print` shows the unit without installing it. Windows: prints the foreground command and the Task Scheduler recipe. |
 | `hypotenuse doctor [--agent <id>] [--offline]` | A checklist of this machine's runner setup — version, tools, config, credentials, server and token, daemon and service, agents, repositories, disk — exit 1 when a check fails. `--agent <id>` starts that agent, runs the ACP `initialize` handshake, and opens a session — a failure names `hypotenuse agents login <id>`. |
 | `hypotenuse mcp --session <id> --nonce <n>` | Hidden: the stdio MCP server the daemon hands a coding agent for one turn — the Linear tools scoped to that session. Not for running by hand. |
 | `hypotenuse check-update` | Whether a newer release exists, with its changelog. |
+| `hypotenuse skill` | Print this skill, the same text on every install (npm or binary); `--json` wraps it as `{ skill }`. |
 | `hypotenuse upgrade [--no-restart]` | Upgrade in place, by however it was installed (npm, bun, or binary), then drain and restart a running daemon on the new version. |
 
 ## Examples