tines 0.0.90 → 0.0.92

package/dist/index.js

@@ -1,8 +1,5 @@
 #!/usr/bin/env node
 
-// src/program.ts
-import { readFileSync as readFileSync8 } from "node:fs";
-
 // ../../node_modules/.pnpm/commander@15.0.0/node_modules/commander/lib/error.js
 var CommanderError = class extends Error {
   /**
@@ -4186,15 +4183,12 @@ function parseTargetSpec(spec) {
 }
 
 // src/common.ts
-var DEFAULT_URL = "http://localhost:5173";
-function withCommon(cmd, { baseUrlFlag = true } = {}) {
-  if (baseUrlFlag) {
-    cmd.option(
-      "-u, --url <url>",
-      `base URL of the Tines API (or set TINES_API_URL; default ${DEFAULT_URL})`
-    );
-  }
-  return cmd.option("--api-key <key>", "API key (or set TINES_API_KEY)").option("--json", "output the raw JSON response");
+var DEFAULT_URL = "https://tines.tbuckley.dev";
+function withCommon(cmd) {
+  return cmd.option(
+    "-u, --url <url>",
+    `base URL of the Tines API (or set TINES_API_URL; default ${DEFAULT_URL})`
+  ).option("--api-key <key>", "API key (or set TINES_API_KEY)").option("--json", "output the raw JSON response");
 }
 function withList(cmd) {
   return withCommon(
@@ -4420,13 +4414,14 @@ function register(program3) {
   );
   withCommon(
     withScopeFlags(
-      context.command("create").description("Create a context item scoped to a project, state, and/or issue").requiredOption("-k, --kind <kind>", "prompt, skill, or repo").requiredOption("-n, --name <name>", "item name (slug-like for skills; the dedup/override key)").option("-d, --description <text>", "one-liner shown in lists").option("--body <md>", "prompt body: inline Markdown or @file (escape a literal @ as @@)").option("--file <path>=@<local>", "skill file: workspace path = local file (repeatable)", collect, []).option("--url <url>", "repo: clone URL").option("--branch <branch>", "repo: branch to check out").option("--dir <dir>", "repo: checkout directory (defaults to the URL's basename)")
-    ),
-    // --url is the repo pointer here; the API base comes from TINES_API_URL.
-    { baseUrlFlag: false }
+      context.command("create").description("Create a context item scoped to a project, state, and/or issue").requiredOption("-k, --kind <kind>", "prompt, skill, or repo").requiredOption("-n, --name <name>", "item name (slug-like for skills; the dedup/override key)").option("-d, --description <text>", "one-liner shown in lists").option("--body <md>", "prompt body: inline Markdown or @file (escape a literal @ as @@)").option("--file <path>=@<local>", "skill file: workspace path = local file (repeatable)", collect, []).option("--repo-url <url>", "repo: clone URL").option("--branch <branch>", "repo: branch to check out").option("--dir <dir>", "repo: checkout directory (defaults to the URL's basename)")
+    )
   ).action(
     async (opts) => {
-      const api = client({ apiKey: opts.apiKey, json: opts.json });
+      if (opts.kind === "repo" && opts.repoUrl === void 0) {
+        die("--kind repo needs --repo-url <clone-url> (--url is the API base URL)");
+      }
+      const api = client(opts);
       const scope = await resolveScopeFlags(api, opts);
       const body = {
         kind: opts.kind,
@@ -4437,7 +4432,7 @@ function register(program3) {
       if (opts.body !== void 0) body.body = readBodyValue(opts.body);
       if (opts.file.length > 0) body.files = opts.file.map(parseFileSpec);
       if (opts.kind === "skill" && body.files === void 0) body.files = [];
-      if (opts.url !== void 0) body.repo_url = opts.url;
+      if (opts.repoUrl !== void 0) body.repo_url = opts.repoUrl;
       if (opts.branch !== void 0) body.repo_branch = opts.branch;
       if (opts.dir !== void 0) body.repo_dir = opts.dir;
       const item = await api.createContextItem(body);
@@ -4447,17 +4442,15 @@ function register(program3) {
   );
   withCommon(
     withScopeFlags(
-      context.command("edit <id>").description("Edit a context item: payload, name, description, or scope").option("-n, --name <name>", "rename the item").option("-d, --description <text>", "set the description").option("--body <md>", "prompt body: inline Markdown or @file (escape a literal @ as @@)").option("--file <path>=@<local>", "add or replace a skill file (repeatable)", collect, []).option("--remove-file <path>", "remove a skill file (repeatable)", collect, []).option("--url <url>", "repo: clone URL").option("--branch <branch>", "repo: branch (empty string clears it)").option("--dir <dir>", "repo: checkout directory (empty string restores the URL default)").option("--unset <dimension>", "drop a scope dimension: project, state, or issue (repeatable)", collect, []).option(
+      context.command("edit <id>").description("Edit a context item: payload, name, description, or scope").option("-n, --name <name>", "rename the item").option("-d, --description <text>", "set the description").option("--body <md>", "prompt body: inline Markdown or @file (escape a literal @ as @@)").option("--file <path>=@<local>", "add or replace a skill file (repeatable)", collect, []).option("--remove-file <path>", "remove a skill file (repeatable)", collect, []).option("--repo-url <url>", "repo: clone URL").option("--branch <branch>", "repo: branch (empty string clears it)").option("--dir <dir>", "repo: checkout directory (empty string restores the URL default)").option("--unset <dimension>", "drop a scope dimension: project, state, or issue (repeatable)", collect, []).option(
         "--expect-version <n>",
         "fail (409) unless the item is still at this version",
         (v) => Number.parseInt(v, 10)
       )
-    ),
-    // --url is the repo pointer here; the API base comes from TINES_API_URL.
-    { baseUrlFlag: false }
+    )
   ).action(
     async (id, opts) => {
-      const api = client({ apiKey: opts.apiKey, json: opts.json });
+      const api = client(opts);
       const body = {};
       if (opts.expectVersion !== void 0) body.expected_version = opts.expectVersion;
       if (opts.name !== void 0) body.name = opts.name;
@@ -4487,7 +4480,7 @@ function register(program3) {
         }
         body.files = [...files.entries()].map(([path2, content]) => ({ path: path2, content }));
       }
-      if (opts.url !== void 0) body.repo_url = opts.url;
+      if (opts.repoUrl !== void 0) body.repo_url = opts.repoUrl;
       if (opts.branch !== void 0) body.repo_branch = opts.branch === "" ? null : opts.branch;
       if (opts.dir !== void 0) body.repo_dir = opts.dir === "" ? null : opts.dir;
       if (Object.keys(body).length === 0) {
@@ -5028,16 +5021,14 @@ files (v${artifact.current_version.version}):`);
     artifactsCmd.command("attach <ref> <name>").description("Attach content to a named artifact slot (creates it, or appends the next version)").option("-f, --file <path>", "upload a file (MIME sniffed from the extension)").option(
       "--folder <dir>",
       "snapshot a directory tree as one version (collect locally, attach once; MIME per file sniffed)"
-    ).option("-t, --text <md|@file>", "inline text document: inline Markdown or @file").option("--url <url>", "link: the URL to attach").option("--pr <spec>", "PR reference: owner/repo#N or a GitHub PR URL").option("--content-type <mime>", "declared MIME type (with --file or --text)").option("--filename <name>", "display filename (with --text; defaults to <name>.md)").option("--title <title>", "display title (with --url)").option("-d, --description <text>", "artifact description, shown in lists and launch prompts"),
-    // --url is the link payload here; the API base comes from TINES_API_URL.
-    { baseUrlFlag: false }
+    ).option("-t, --text <md|@file>", "inline text document: inline Markdown or @file").option("--link <url>", "link: the URL to attach").option("--pr <spec>", "PR reference: owner/repo#N or a GitHub PR URL").option("--content-type <mime>", "declared MIME type (with --file or --text)").option("--filename <name>", "display filename (with --text; defaults to <name>.md)").option("--title <title>", "display title (with --link)").option("-d, --description <text>", "artifact description, shown in lists and launch prompts")
   ).action(
     async (ref, name2, opts) => {
-      const api = client({ apiKey: opts.apiKey, json: opts.json });
-      const sources = [opts.file, opts.folder, opts.text, opts.url, opts.pr].filter((v) => v !== void 0);
+      const api = client(opts);
+      const sources = [opts.file, opts.folder, opts.text, opts.link, opts.pr].filter((v) => v !== void 0);
       if (sources.length !== 1) {
         die(
-          "pass exactly one content source: --file <path>, --folder <dir>, --text <md|@file>, --url <url>, or --pr <spec>"
+          "pass exactly one content source: --file <path>, --folder <dir>, --text <md|@file>, --link <url>, or --pr <spec> (a link goes in --link; --url is the API base URL)"
         );
       }
       const issue = await resolveIssue(api, ref);
@@ -5074,10 +5065,10 @@ files (v${artifact.current_version.version}):`);
           ...opts.contentType !== void 0 ? { content_type: opts.contentType } : {},
           ...opts.description !== void 0 ? { description: opts.description } : {}
         });
-      } else if (opts.url !== void 0) {
+      } else if (opts.link !== void 0) {
         artifact = await api.putArtifact(issue.id, name2, {
           type: "link",
-          url: opts.url,
+          url: opts.link,
           ...opts.title !== void 0 ? { title: opts.title } : {},
           ...opts.description !== void 0 ? { description: opts.description } : {}
         });
@@ -5533,7 +5524,7 @@ import {
   createWriteStream,
   existsSync as existsSync4,
   mkdirSync as mkdirSync4,
-  readFileSync as readFileSync6,
+  readFileSync as readFileSync7,
   rmSync as rmSync2,
   statSync as statSync3,
   unlinkSync,
@@ -5542,6 +5533,17 @@ import {
 import { hostname, platform, arch } from "node:os";
 import { dirname as dirname4, join as join4 } from "node:path";
 
+// src/version.ts
+import { readFileSync as readFileSync4 } from "node:fs";
+function cliVersion() {
+  try {
+    const manifest = new URL("../package.json", import.meta.url);
+    return JSON.parse(readFileSync4(manifest, "utf8")).version ?? "0.0.0-unknown";
+  } catch {
+    return "0.0.0-unknown";
+  }
+}
+
 // src/daemon/claude-stream.ts
 function clip(value, max) {
   return value.length > max ? `${value.slice(0, max)}\u2026` : value;
@@ -5639,7 +5641,7 @@ var ClaudeStreamRenderer = class {
 
 // src/daemon/cli-refresh.ts
 import { spawn } from "node:child_process";
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync4 } from "node:fs";
+import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync5 } from "node:fs";
 import { dirname as dirname2, join as join2 } from "node:path";
 
 // src/daemon/support.ts
@@ -5676,6 +5678,47 @@ function buildHarnessInvocation(spec, input) {
     }
   }
 }
+var LAUNCH_ARG_MAX = 160;
+var SAFE_WORD = /^[A-Za-z0-9_@%+=:,./-]+$/;
+function launchWord(word) {
+  if (word.length > LAUNCH_ARG_MAX)
+    return shellQuote(`${word.slice(0, LAUNCH_ARG_MAX)}\u2026 [+${word.length - LAUNCH_ARG_MAX} chars]`);
+  return SAFE_WORD.test(word) ? word : shellQuote(word);
+}
+function formatLaunchCommand(invocation) {
+  if (invocation.file === "sh" && invocation.args.length === 2 && invocation.args[0] === "-c")
+    return invocation.args[1];
+  return [invocation.file, ...invocation.args].map(launchWord).join(" ");
+}
+function formatLaunchBanner(invocation, input, meta) {
+  const fields = [
+    `harness=${meta.harness}`,
+    `model=${input.model ?? "(fixed)"}`,
+    `timeout=${meta.timeoutMinutes}m`,
+    `cli=${meta.cliVersion}`,
+    `workspace=${input.workspace}`
+  ];
+  return `$ ${formatLaunchCommand(invocation)}
+# tines runner: ${fields.join(" ")}
+`;
+}
+function formatDuration(ms) {
+  const seconds = Math.max(0, Math.round(ms / 1e3));
+  return `${Math.floor(seconds / 60)}m${seconds % 60}s`;
+}
+function formatExitLine(exit) {
+  const parts = [];
+  if (exit.code !== null) parts.push(`code=${exit.code}`);
+  if (exit.signal) parts.push(`signal=${exit.signal}`);
+  if (parts.length === 0) parts.push("code=?");
+  if (exit.timedOut) parts.push("(timed out)");
+  return `# tines runner: exit ${parts.join(" ")} after ${formatDuration(exit.durationMs)}
+`;
+}
+function exitLineForRun(run, exit) {
+  if (run.settled) return null;
+  return formatExitLine({ ...exit, timedOut: run.timedOut });
+}
 var RunTable = class {
   constructor(effects, opts = {}) {
     this.effects = effects;
@@ -5881,7 +5924,7 @@ function binDirOf(prefix) {
 }
 function installedVersion(prefix) {
   try {
-    const pkg = readFileSync4(join2(prefix, "node_modules", PACKAGE, "package.json"), "utf8");
+    const pkg = readFileSync5(join2(prefix, "node_modules", PACKAGE, "package.json"), "utf8");
     const version = JSON.parse(pkg).version;
     return typeof version === "string" ? version : null;
   } catch {
@@ -5962,7 +6005,7 @@ import {
   existsSync as existsSync3,
   mkdirSync as mkdirSync3,
   readdirSync as readdirSync2,
-  readFileSync as readFileSync5,
+  readFileSync as readFileSync6,
   rmSync,
   statSync as statSync2,
   writeFileSync as writeFileSync2
@@ -5975,7 +6018,7 @@ function defaultConfigDir() {
 function readJsonFile(path2) {
   if (!existsSync3(path2)) return null;
   try {
-    return JSON.parse(readFileSync5(path2, "utf8"));
+    return JSON.parse(readFileSync6(path2, "utf8"));
   } catch {
     return null;
   }
@@ -6026,10 +6069,10 @@ function saveDaemonState(path2, runs) {
 }
 function processStartTimeMs(pid) {
   try {
-    const stat = readFileSync5(`/proc/${pid}/stat`, "utf8");
+    const stat = readFileSync6(`/proc/${pid}/stat`, "utf8");
     const afterComm = stat.slice(stat.lastIndexOf(")") + 2).split(" ");
     const startTicks = Number(afterComm[19]);
-    const btimeLine = readFileSync5("/proc/stat", "utf8").split("\n").find((line) => line.startsWith("btime "));
+    const btimeLine = readFileSync6("/proc/stat", "utf8").split("\n").find((line) => line.startsWith("btime "));
     const btime = Number(btimeLine?.slice("btime ".length));
     if (!Number.isFinite(startTicks) || !Number.isFinite(btime)) return null;
     return btime * 1e3 + startTicks / 100 * 1e3;
@@ -6114,6 +6157,7 @@ function directorySizeBytes(path2) {
 
 // src/daemon/daemon.ts
 var CLI_REFRESH_TTL_MS = 10 * 6e4;
+var DAEMON_VERSION = cliVersion();
 async function uploadRawLog(run) {
   const path2 = run.rawSpoolPath;
   if (!path2 || !run.rawUpload) return;
@@ -6122,7 +6166,7 @@ async function uploadRawLog(run) {
     await new Promise((resolve) => run.rawSpool?.end(resolve) ?? resolve());
     const size = statSync3(path2).size;
     if (size > 0) {
-      let body = readFileSync6(path2);
+      let body = readFileSync7(path2);
       if (body.byteLength > RUN_LOG_RAW_MAX_BYTES) {
         const marker = Buffer.from(
           `{"type":"tines_truncated","dropped_bytes":${body.byteLength - RUN_LOG_RAW_MAX_BYTES}}
@@ -6347,14 +6391,22 @@ async function runDaemon(opts) {
 ` : `warning: no daemon-managed tines CLI; using whatever \`tines\` is on this machine's PATH
 `
       );
+      const harnessInput = {
+        workspace,
+        promptFile: join4(workspace, "prompt.md"),
+        prompt: assignment.prompt,
+        model: assignment.run.model
+      };
       const invocation = buildHarnessInvocation(
         { harness: opts.harness, command: opts.command },
-        {
-          workspace,
-          promptFile: join4(workspace, "prompt.md"),
-          prompt: assignment.prompt,
-          model: assignment.run.model
-        }
+        harnessInput
+      );
+      run.batcher.append(
+        formatLaunchBanner(invocation, harnessInput, {
+          harness: opts.harness,
+          timeoutMinutes: assignment.timeout_minutes,
+          cliVersion: DAEMON_VERSION
+        })
       );
       const child = spawn2(invocation.file, invocation.args, {
         cwd: workspace,
@@ -6401,6 +6453,13 @@ async function runDaemon(opts) {
         void table2.finishAndCleanup(run, "failed", `failed to launch harness: ${message2(err)}`);
       });
       child.on("exit", (code, signal) => {
+        run.drain?.();
+        const closing = exitLineForRun(run, {
+          code,
+          signal,
+          durationMs: Date.now() - (run.spawnedAt ?? Date.now())
+        });
+        if (closing) run.batcher.append(closing);
         if (run.timedOut) {
           void table2.finishAndCleanup(
             run,
@@ -7138,7 +7197,7 @@ function register8(program3) {
 }
 
 // src/commands/workflows.ts
-import { readFileSync as readFileSync7 } from "node:fs";
+import { readFileSync as readFileSync8 } from "node:fs";
 function readJsonBody(inline, file) {
   if (inline !== void 0 && file !== void 0) {
     die("pass the JSON inline or with --file, not both");
@@ -7147,14 +7206,14 @@ function readJsonBody(inline, file) {
   if (file !== void 0 && file !== "-") {
     let raw;
     try {
-      raw = readFileSync7(file, "utf8");
+      raw = readFileSync8(file, "utf8");
     } catch (err) {
       die(`cannot read ${file}: ${err instanceof Error ? err.message : String(err)}`);
     }
     return parseJsonObject(raw, file);
   }
   if (file === "-" || !process.stdin.isTTY) {
-    const raw = readFileSync7(0, "utf8");
+    const raw = readFileSync8(0, "utf8");
     if (raw.trim() === "") {
       if (file === "-") die("no JSON on stdin");
       return void 0;
@@ -7308,14 +7367,6 @@ see \`tines workflows create --help\` for the expected shape`
 }
 
 // src/program.ts
-function cliVersion() {
-  try {
-    const manifest = new URL("../package.json", import.meta.url);
-    return JSON.parse(readFileSync8(manifest, "utf8")).version ?? "0.0.0-unknown";
-  } catch {
-    return "0.0.0-unknown";
-  }
-}
 var program2 = new Command();
 program2.name("tines").description("CLI for Tines").version(cliVersion()).enablePositionalOptions();
 registerTime(program2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tines",
-  "version": "0.0.90",
+  "version": "0.0.92",
   "description": "CLI for Tines, an orchestration layer for AI agents",
   "repository": {
     "type": "git",
@@ -26,7 +26,7 @@
   },
   "scripts": {
     "build": "esbuild src/index.ts --bundle --platform=node --target=node20 --format=esm --banner:js=\"#!/usr/bin/env node\" --outfile=dist/index.js",
-    "start": "tsx src/index.ts",
+    "start": "TINES_API_URL=${TINES_API_URL:-http://localhost:5173} tsx src/index.ts",
     "check": "tsc --noEmit",
     "test": "vitest run"
   }