tines 0.0.77 → 0.0.78

package/dist/index.js

@@ -1,11 +1,43 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { existsSync as existsSync2, mkdirSync as mkdirSync3, readdirSync, readFileSync as readFileSync2, statSync, writeFileSync as writeFileSync3 } from "node:fs";
+import { existsSync as existsSync2, mkdirSync as mkdirSync3, readdirSync, readFileSync as readFileSync3, statSync, writeFileSync as writeFileSync3 } from "node:fs";
 import { hostname as hostname2 } from "node:os";
 import { basename, dirname as dirname3, join as join3 } from "node:path";
 import { createInterface } from "node:readline/promises";
 
+// src/body-value.ts
+import { readFileSync } from "node:fs";
+var processStdin = {
+  get isTTY() {
+    return Boolean(process.stdin.isTTY);
+  },
+  read: () => readFileSync(0, "utf8")
+};
+var BODY_VALUE_HELP = 'inline text, @file, or "-" to read stdin; escape a literal leading @ as @@';
+function readBodyValue(value, stdin = processStdin) {
+  if (value.startsWith("@@")) return value.slice(1);
+  if (value === "-" || value === "@-") {
+    if (stdin.isTTY) {
+      throw new Error(
+        '"-" reads the body from stdin, but stdin is a terminal \u2014 pipe or redirect the Markdown (e.g. a quoted heredoc)'
+      );
+    }
+    const raw = stdin.read();
+    if (raw.trim() === "") throw new Error("no Markdown on stdin");
+    return raw;
+  }
+  if (value.startsWith("@")) {
+    const file = value.slice(1);
+    try {
+      return readFileSync(file, "utf8");
+    } catch (err) {
+      throw new Error(`cannot read ${file}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+  }
+  return value;
+}
+
 // src/daemon/daemon.ts
 import { spawn } from "node:child_process";
 import { mkdirSync as mkdirSync2, rmSync, writeFileSync as writeFileSync2 } from "node:fs";
@@ -26,7 +58,16 @@ var AGENT_GUIDELINES_NAME = "agent-guidelines";
 var JOURNAL_NAME = "journal";
 var AGENT_GUIDELINES_BODY = `You are an agent working on a Tines issue over its HTTP API / CLI. Beyond doing the work, leave the workspace smarter than you found it. Four places to write, chosen by who should inherit what you learned:
 
-- **Issue comments** \u2014 all prose about this issue: progress, findings, dead ends, questions, and instructions for whoever picks it up next. \`tines issues comment <project>/<number> "<markdown>"\`
+- **Issue comments** \u2014 all prose about this issue: progress, findings, dead ends, questions, and instructions for whoever picks it up next. Pass the body on stdin with a quoted heredoc, so backticks, $VARS, quotes and apostrophes reach the thread untouched by the shell (a mangled comment cannot be deleted):
+
+  \`\`\`
+  tines issues comment <project>/<number> - <<'EOF'
+  <markdown>
+  EOF
+  \`\`\`
+
+  A \`tines\` too old for that form posts a literal \`-\` instead of your body, without failing. If \`tines issues comment --help\` does not mention \`@file\`, use \`tines issues comment <project>/<number> "<markdown>"\` and mind the shell quoting.
+
 - **Issue context (artifacts)** \u2014 things this issue needs *attached*, not said: a skill, a repo/branch pin, or an override of a broader item (reuse its name): \`tines context create --kind <k> --name <n> --issue <project>/<number> \u2026\`. Never notes \u2014 notes are comments.
 - **Your journal** \u2014 shared notes for anyone doing this stage of work in this project. Append a dated bullet whenever you learn something they would want: commands that actually work, gotchas, where things live (see "Journal" at the end of this prompt for the exact commands). If an entry is wrong or stale, rewrite the journal to fix it \u2014 do not append a correction on top. Keep it short; prune when you touch it.
 - **Context change requests** \u2014 never edit shared context (project-, state-, or global-scoped items) directly. Propose instead: file an issue in the project you are working in, titled \`Context change: <scope label>\`, naming the item (kind, name, scope) with the full proposed text in the description. A human reviews and applies it.
@@ -345,7 +386,7 @@ var PLACEHOLDER_DESCRIPTIONS = {
 var TEMPLATE_PLACEHOLDERS = Object.keys(PLACEHOLDER_DESCRIPTIONS).map((key) => ({ key, description: PLACEHOLDER_DESCRIPTIONS[key] }));
 
 // src/daemon/store.ts
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync as readFileSync2, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 function defaultConfigDir() {
@@ -354,7 +395,7 @@ function defaultConfigDir() {
 function readJsonFile(path) {
   if (!existsSync(path)) return null;
   try {
-    return JSON.parse(readFileSync(path, "utf8"));
+    return JSON.parse(readFileSync2(path, "utf8"));
   } catch {
     return null;
   }
@@ -405,10 +446,10 @@ function saveDaemonState(path, runs) {
 }
 function processStartTimeMs(pid) {
   try {
-    const stat = readFileSync(`/proc/${pid}/stat`, "utf8");
+    const stat = readFileSync2(`/proc/${pid}/stat`, "utf8");
     const afterComm = stat.slice(stat.lastIndexOf(")") + 2).split(" ");
     const startTicks = Number(afterComm[19]);
-    const btimeLine = readFileSync("/proc/stat", "utf8").split("\n").find((line) => line.startsWith("btime "));
+    const btimeLine = readFileSync2("/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;
@@ -922,14 +963,14 @@ function readJsonBody(inline, file) {
   if (file !== void 0 && file !== "-") {
     let raw;
     try {
-      raw = readFileSync2(file, "utf8");
+      raw = readFileSync3(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 = readFileSync2(0, "utf8");
+    const raw = readFileSync3(0, "utf8");
     if (raw.trim() === "") {
       if (file === "-") die("no JSON on stdin");
       return void 0;
@@ -1059,18 +1100,6 @@ async function resolveScopeFlags(api, opts) {
   if (opts.issue !== void 0) scope.issue_id = (await resolveIssue(api, opts.issue)).id;
   return scope;
 }
-function readBodyValue(value) {
-  if (value.startsWith("@@")) return value.slice(1);
-  if (value.startsWith("@")) {
-    const file = value.slice(1);
-    try {
-      return readFileSync2(file, "utf8");
-    } catch (err) {
-      die(`cannot read ${file}: ${err instanceof Error ? err.message : String(err)}`);
-    }
-  }
-  return value;
-}
 function parseFileSpec(spec) {
   const sep = spec.indexOf("=");
   if (sep < 1 || sep === spec.length - 1) {
@@ -1083,7 +1112,7 @@ function parseFileSpec(spec) {
   }
   const file = source.slice(1);
   try {
-    return { path, content: readFileSync2(file, "utf8") };
+    return { path, content: readFileSync3(file, "utf8") };
   } catch (err) {
     die(`cannot read ${file}: ${err instanceof Error ? err.message : String(err)}`);
   }
@@ -1344,7 +1373,7 @@ function eventSummary(ev) {
 function cliVersion() {
   try {
     const manifest = new URL("../package.json", import.meta.url);
-    return JSON.parse(readFileSync2(manifest, "utf8")).version ?? "0.0.0-unknown";
+    return JSON.parse(readFileSync3(manifest, "utf8")).version ?? "0.0.0-unknown";
   } catch {
     return "0.0.0-unknown";
   }
@@ -1544,9 +1573,10 @@ withList(
   }
 );
 withCommon(
-  issues.command("create <project>").description("Create an issue in a project, optionally with a recurrence (a scheduled task)").requiredOption("-t, --title <title>", "issue title (doubles as the title template with a recurrence)").option("-d, --description <markdown>", "issue description (Markdown)").option("-w, --workflow <id-or-name>", "workflow (defaults to project default, else standard)").option("-s, --state <name>", "starting state (defaults to the workflow's initial state)").option("--every <preset>", 'repeat hourly (or every N hours: "6h"), daily, weekly, or monthly').option("--at <when>", "preset time of day HH:MM (default 09:00); for hourly, the minute past the hour :MM (default :00)").option("--on <when>", "weekday (weekly) or day of month (monthly)").option("--cron <expr>", "5-field cron expression (alternative to --every/--at/--on)").option("--tz <iana>", "schedule timezone (defaults to the system timezone)").option("--if-closed", "only create a new instance when all previous instances are closed").option("--schedule-name <name>", "schedule name, unique per project (defaults to the title)")
+  issues.command("create <project>").description("Create an issue in a project, optionally with a recurrence (a scheduled task)").requiredOption("-t, --title <title>", "issue title (doubles as the title template with a recurrence)").option("-d, --description <markdown>", `issue description (Markdown) \u2014 ${BODY_VALUE_HELP}`).option("-w, --workflow <id-or-name>", "workflow (defaults to project default, else standard)").option("-s, --state <name>", "starting state (defaults to the workflow's initial state)").option("--every <preset>", 'repeat hourly (or every N hours: "6h"), daily, weekly, or monthly').option("--at <when>", "preset time of day HH:MM (default 09:00); for hourly, the minute past the hour :MM (default :00)").option("--on <when>", "weekday (weekly) or day of month (monthly)").option("--cron <expr>", "5-field cron expression (alternative to --every/--at/--on)").option("--tz <iana>", "schedule timezone (defaults to the system timezone)").option("--if-closed", "only create a new instance when all previous instances are closed").option("--schedule-name <name>", "schedule name, unique per project (defaults to the title)")
 ).action(
   async (projectRef, opts) => {
+    const description = opts.description !== void 0 ? readBodyValue(opts.description) : void 0;
     const api = client(opts);
     const project = await resolveProject(api, projectRef);
     const workflowId = opts.workflow ? (await resolveWorkflow(api, opts.workflow)).id : void 0;
@@ -1562,7 +1592,7 @@ withCommon(
     } : void 0;
     const issue = await api.createIssue(project.id, {
       title: opts.title,
-      description: opts.description,
+      description,
       workflow_id: workflowId,
       state: opts.state,
       schedule
@@ -1586,17 +1616,18 @@ withCommon(
   printIssueDetail(issue);
 });
 withCommon(
-  issues.command("edit <ref>").description("Edit an issue: title, description, workflow, or force-set state").option("-t, --title <title>", "set the title").option("-d, --description <markdown>", "set the description (Markdown)").option(
+  issues.command("edit <ref>").description("Edit an issue: title, description, workflow, or force-set state").option("-t, --title <title>", "set the title").option("-d, --description <markdown>", `set the description (Markdown) \u2014 ${BODY_VALUE_HELP}`).option(
     "-s, --state <name>",
     "force-set the state, bypassing the workflow's transitions (records a forced move)"
   ).option("-w, --workflow <id-or-name>", "move the issue onto another workflow")
 ).action(
   async (ref, opts) => {
+    const description = opts.description !== void 0 ? readBodyValue(opts.description) : void 0;
     const api = client(opts);
     const issue = await resolveIssue(api, ref);
     const body = {};
     if (opts.title !== void 0) body.title = opts.title;
-    if (opts.description !== void 0) body.description = opts.description;
+    if (description !== void 0) body.description = description;
     if (opts.state !== void 0) body.state = opts.state;
     if (opts.workflow !== void 0) body.workflow_id = (await resolveWorkflow(api, opts.workflow)).id;
     if (Object.keys(body).length === 0) {
@@ -1626,12 +1657,13 @@ withCommon(
   );
 });
 withCommon(
-  issues.command("comment <ref> <markdown>").description("Comment on an issue (Markdown body)").passThroughOptions()
+  issues.command("comment <ref> <markdown>").description(`Comment on an issue \u2014 Markdown body: ${BODY_VALUE_HELP}`).passThroughOptions()
 ).action(async (ref, markdown, opts, command) => {
   if (helpGuard(command, markdown)) return;
+  const body = readBodyValue(markdown);
   const api = client(opts);
   const issue = await resolveIssue(api, ref);
-  const comment = await api.createComment(issue.id, { body: markdown });
+  const comment = await api.createComment(issue.id, { body });
   if (opts.json) return printJson(comment);
   console.log(`commented on ${issue.project_name}/#${issue.number} as ${actorLabel(comment.actor)}`);
 });
@@ -1802,7 +1834,7 @@ function walkFolder(dir) {
       const nextRel = rel ? `${rel}/${entry.name}` : entry.name;
       if (entry.isDirectory()) walk(nextAbs, nextRel);
       else if (entry.isFile()) {
-        files.push({ path: nextRel, contentType: sniffContentType(entry.name), bytes: readFileSync2(nextAbs) });
+        files.push({ path: nextRel, contentType: sniffContentType(entry.name), bytes: readFileSync3(nextAbs) });
       }
     }
   };
@@ -1889,7 +1921,7 @@ withCommon(
     } else if (opts.file !== void 0) {
       let bytes;
       try {
-        bytes = readFileSync2(opts.file);
+        bytes = readFileSync3(opts.file);
       } catch (err) {
         die(`cannot read ${opts.file}: ${err instanceof Error ? err.message : String(err)}`);
       }
@@ -2321,15 +2353,16 @@ start one: tines journal append ${issue.project_name}/${issue.number} "- <date>:
   console.log(full.body ?? "");
 });
 withCommon(
-  journal.command("append <ref> <markdown>").description("Append a lesson (creates the journal on first use)").option("--state <workflow>/<state>", STATE_FLAG_HELP).passThroughOptions()
+  journal.command("append <ref> <markdown>").description(`Append a lesson, creating the journal on first use \u2014 ${BODY_VALUE_HELP}`).option("--state <workflow>/<state>", STATE_FLAG_HELP).passThroughOptions()
 ).action(
   async (ref, markdown, opts, command) => {
     if (helpGuard(command, markdown)) return;
+    const text = readBodyValue(markdown);
     const api = client(opts);
     const { scope, note, item } = await resolveJournal(api, ref, opts.state);
     printNote(note);
     if (item) {
-      const updated = await api.appendContextItem(item.id, { text: markdown });
+      const updated = await api.appendContextItem(item.id, { text });
       if (opts.json) return printJson(updated);
       return console.log(`appended to the ${scope.label} journal (now v${updated.version})`);
     }
@@ -2339,7 +2372,7 @@ withCommon(
         name: JOURNAL_NAME,
         project_id: scope.project_id ?? void 0,
         workflow_state_id: scope.workflow_state_id ?? void 0,
-        body: markdown.trim()
+        body: text.trim()
       });
       if (opts.json) return printJson(created);
       console.log(`started the ${scope.label} journal (${created.id})`);
@@ -2347,7 +2380,7 @@ withCommon(
       if (!(err instanceof ApiError) || err.code !== "duplicate_context_name") throw err;
       const { item: fresh } = await resolveJournal(api, ref, opts.state);
       if (!fresh) throw err;
-      const updated = await api.appendContextItem(fresh.id, { text: markdown });
+      const updated = await api.appendContextItem(fresh.id, { text });
       if (opts.json) return printJson(updated);
       console.log(`appended to the ${scope.label} journal (now v${updated.version})`);
     }
@@ -2437,7 +2470,7 @@ recent instances:`);
   }
 });
 withCommon(
-  schedules.command("edit <ref>").description("Edit a schedule: templates, workflow, start state, recurrence, timezone, gate, or name").option("-t, --title <template>", "set the title template").option("-d, --description <markdown>", "set the description template (Markdown)").option(
+  schedules.command("edit <ref>").description("Edit a schedule: templates, workflow, start state, recurrence, timezone, gate, or name").option("-t, --title <template>", "set the title template").option("-d, --description <markdown>", `set the description template (Markdown) \u2014 ${BODY_VALUE_HELP}`).option(
     "-w, --workflow <id-or-name>",
     "move future instances onto another workflow (resets the start state to its initial state unless --state is also given)"
   ).option(
@@ -2446,11 +2479,12 @@ withCommon(
   ).option("--every <preset>", 'repeat hourly (or every N hours: "6h"), daily, weekly, or monthly').option("--at <when>", "preset time of day HH:MM (default 09:00); for hourly, the minute past the hour :MM (default :00)").option("--on <when>", "weekday (weekly) or day of month (monthly)").option("--cron <expr>", "5-field cron expression (alternative to --every/--at/--on)").option("--tz <iana>", "set the schedule timezone").option("--if-closed", "only create a new instance when all previous instances are closed").option("--no-if-closed", "clear the only-when-closed gate").option("--name <new-name>", "rename the schedule")
 ).action(
   async (ref, opts) => {
+    const descriptionTemplate = opts.description !== void 0 ? readBodyValue(opts.description) : void 0;
     const api = client(opts);
     const schedule = await resolveSchedule(api, ref);
     const body = {};
     if (opts.title !== void 0) body.title_template = opts.title;
-    if (opts.description !== void 0) body.description_template = opts.description;
+    if (descriptionTemplate !== void 0) body.description_template = descriptionTemplate;
     if (opts.workflow !== void 0) body.workflow_id = (await resolveWorkflow(api, opts.workflow)).id;
     if (opts.state !== void 0) body.state = opts.state;
     const recurrence = buildRecurrence(opts);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tines",
-  "version": "0.0.77",
+  "version": "0.0.78",
   "description": "CLI for Tines, an orchestration layer for AI agents",
   "repository": {
     "type": "git",