tines 0.0.173 → 0.0.174

package/README.md

@@ -37,6 +37,10 @@ tines issues list --project <project>
 tines issues create <project> --title "…" -d @description.md
 tines issues show <project>/<number>
 tines issues move <project>/<number> <action>        # a workflow transition
+tines issues transfer <project>/<number> --project <dest>   # move to another project (keeps ID, record and old refs)
+tines issues transfer <ref> --project <dest> --dry-run      # review only: no number allocated, nothing written
+tines issues transfer <ref> --project <dest> --inspect 0    # print reviewed guidance item [0] in full
+tines issues transfer <ref> --project <dest> --yes          # skip the prompt (still commits only the fetched review)
 tines issues comment <project>/<number> - <<'EOF'    # body from stdin; @file also works
 …
 EOF

package/dist/index.js

@@ -3605,6 +3605,14 @@ var DESCRIBERS = {
     }
     return segs;
   },
+  "issue.transferred": (_ev, p) => [
+    text("transferred"),
+    selfRef(),
+    text("from"),
+    name(p.old_ref),
+    text("to"),
+    name(p.new_ref)
+  ],
   "issue.transitioned": (_ev, p) => {
     const segs = [text("moved"), selfRef()];
     if (p.action) segs.push(text("via"), name(p.action));
@@ -4036,6 +4044,15 @@ function createApiClient(options) {
     getIssueJournal: (issueId) => get(`/api/v1/issues/${issueId}/journal`),
     /** Launch prompt: stitched context plus the generated issue block. */
     getIssuePrompt: (issueId) => get(`/api/v1/issues/${issueId}/prompt`),
+    /**
+     * Review a move to another project: read-only, allocates no number and
+     * writes nothing. Returns the token that binds this exact review.
+     */
+    previewIssueTransfer: (issueId, destinationProjectId) => get(
+      `/api/v1/issues/${issueId}/transfer${query({ project: destinationProjectId })}`
+    ),
+    /** Commit the reviewed move. The token must come from a fresh preview. */
+    transferIssue: (issueId, body) => request("POST", `/api/v1/issues/${issueId}/transfer`, body),
     // Issue artifacts (name-addressed under the issue)
     listArtifacts: (issueId) => get(`/api/v1/issues/${issueId}/artifacts`),
     getArtifact: (issueId, name2) => get(artifactPath(issueId, name2)),
@@ -4727,7 +4744,7 @@ function table(rows) {
   console.log(formatTable(rows));
 }
 async function resolveProject(api, ref) {
-  const { items } = await api.listProjects({ archived: "all" });
+  const items = await listAll((page) => api.listProjects({ ...page, archived: "all" }));
   const byId = items.find((p) => p.id === ref);
   if (byId) return byId;
   const byName = items.filter((p) => p.name === ref);
@@ -5023,6 +5040,149 @@ function register(program3) {
 // src/commands/issues.ts
 import { existsSync as existsSync3, mkdirSync as mkdirSync2, readdirSync, readFileSync as readFileSync4, statSync as statSync2, writeFileSync as writeFileSync2 } from "node:fs";
 import { basename, dirname as dirname2, join as join2 } from "node:path";
+import { createInterface } from "node:readline/promises";
+
+// src/issue-transfer.ts
+var CHANGE_LABEL = {
+  added: "added by destination",
+  removed: "removed with source",
+  retained: "retained",
+  rescoped: "moves with the issue",
+  replaced: "overridden at destination"
+};
+function inspectableChanges(preview) {
+  return preview.context.changes.filter((c) => c.change !== "retained");
+}
+function repoLine(change) {
+  if (change.kind !== "repo") return null;
+  const before = change.repo_before;
+  const after = change.repo_after;
+  const show = (r) => r ? `${r.url}${r.branch ? `#${r.branch}` : ""} \u2192 ${r.dir}` : "none";
+  if (!before && !after) return null;
+  return `      checkout: ${show(before)} => ${show(after)}`;
+}
+function routingLines(preview) {
+  const lines = ["", "Routing:"];
+  for (const [label, explainer] of [
+    ["  before", preview.routing.before],
+    ["  after ", preview.routing.after]
+  ]) {
+    if (!explainer) {
+      lines.push(`${label}: no explanation available`);
+      continue;
+    }
+    lines.push(`${label}: ${explainer.verdict}`);
+    if (explainer.pin) {
+      lines.push(
+        `           pinned runner ${explainer.pin.runner_name ?? explainer.pin.runner_id}${explainer.pin.tier ? ` (${explainer.pin.tier})` : ""} \u2014 retained by the move`
+      );
+    }
+    for (const tie of explainer.ambiguous_rules) {
+      lines.push(`           tied rule ${tie.scope_label}`);
+    }
+  }
+  lines.push("  Capacity, heartbeats and spending are advisory and may change at any moment.");
+  return lines;
+}
+function formatTransferPreview(preview) {
+  const p = preview.preserved;
+  const lines = [
+    `Move ${preview.old_ref.ref} from ${preview.source.name} to ${preview.destination.name}`,
+    `  ${preview.number_notice} The issue keeps its stable ID (${preview.issue_id}) and every old ref keeps working.`,
+    "",
+    "Preserved:",
+    `  "${p.title}" \u2014 state unchanged, entered ${new Date(p.state_entered_at).toISOString()}`,
+    `  ${p.comment_count} comment(s), ${p.artifact_count} artifact(s) in ${p.artifact_version_count} version(s), ${p.run_count} run(s), ${p.link_count} link(s)`,
+    `  labels: ${p.labels.map((l) => l.name).join(", ") || "none"}`,
+    `  pins: ${p.pinned_runner_id ?? "none"}${p.pinned_tier ? ` (${p.pinned_tier})` : ""}; attempts ${p.attempt_count}${p.parked ? "; parked" : ""}`
+  ];
+  const changes = inspectableChanges(preview);
+  lines.push("", changes.length ? "Guidance changes:" : "Guidance: unchanged by this move.");
+  changes.forEach((change, index) => {
+    lines.push(`  [${index}] ${change.kind} "${change.name}" \u2014 ${CHANGE_LABEL[change.change]}`);
+    const scopeBefore = change.scope_before?.label ?? "\u2014";
+    const scopeAfter = change.scope_after?.label ?? "\u2014";
+    lines.push(`      scope: ${scopeBefore} => ${scopeAfter}`);
+    const repo = repoLine(change);
+    if (repo) lines.push(repo);
+  });
+  for (const conflict of preview.context.after.conflicts) {
+    lines.push(
+      `  ! ${conflict.item_ids.length} repositories still want the "${conflict.dir}" directory at the destination`
+    );
+  }
+  lines.push(...routingLines(preview));
+  if (preview.schedule) {
+    lines.push(
+      "",
+      `Schedule: ${preview.schedule.name} (${preview.schedule.project_name}) \u2014 ${preview.schedule.notice}`
+    );
+  }
+  if (preview.blockers.length) {
+    lines.push("", "Cannot move yet:");
+    for (const blocker of preview.blockers) {
+      lines.push(
+        `  ${blocker.code}: ${blocker.message}${blocker.remedy ? ` (${blocker.remedy})` : ""}`
+      );
+    }
+  }
+  if (preview.noop)
+    lines.push("", "This issue is already in that project; moving would change nothing.");
+  return lines.join("\n");
+}
+function formatTransferItem(preview, index) {
+  const change = inspectableChanges(preview)[index];
+  if (!change) return `no item [${index}] in this review`;
+  const side = change.change === "removed" ? preview.context.before : preview.context.after;
+  const prompt = side.prompt.parts.find((part) => part.item_id === change.item_id);
+  if (prompt) return `${change.name} (prompt, ${prompt.scope.label})
+${prompt.body}`;
+  const skill = side.skills.find((s) => s.item_id === change.item_id);
+  if (skill) {
+    return [
+      `${change.name} (skill, ${skill.scope.label})`,
+      ...skill.files.map((f) => `--- ${f.path}
+${f.content}`)
+    ].join("\n");
+  }
+  const repo = side.repos.find((r) => r.item_id === change.item_id);
+  if (repo)
+    return `${change.name} (repo, ${repo.scope.label})
+${repo.url} ${repo.branch ?? ""} \u2192 ${repo.dir}`;
+  return `${change.name} (${change.kind}) is not effective on either side; nothing to show.`;
+}
+function formatTransferResult(result) {
+  if (result.status === "noop") {
+    return `${result.old_ref.ref} is already in ${result.destination.name}; nothing changed`;
+  }
+  return [
+    `moved ${result.old_ref.ref} to ${result.new_ref.ref}`,
+    `  ${result.old_ref.ref} still resolves to this issue`,
+    `  ${result.new_ref.ref}`
+  ].join("\n");
+}
+async function confirmTransfer(preview, terminal, notice) {
+  if (notice) terminal.write(`${notice}
+`);
+  terminal.write(`${formatTransferPreview(preview)}
+`);
+  const inspectable = inspectableChanges(preview).length;
+  for (; ; ) {
+    const hint = inspectable ? `, or a number 0-${inspectable - 1} to read that item` : "";
+    const answer = await terminal.ask(
+      `Move ${preview.old_ref.ref} to ${preview.destination.name}? [y/N${hint}] `
+    );
+    if (answer === null) return { action: "abort", reason: "no answer" };
+    const trimmed = answer.trim();
+    if (/^\d+$/.test(trimmed)) {
+      terminal.write(`${formatTransferItem(preview, Number(trimmed))}
+`);
+      continue;
+    }
+    if (/^y(es)?$/i.test(trimmed)) return { action: "commit" };
+    return { action: "abort", reason: "aborted" };
+  }
+}
 
 // src/attach-source.ts
 import { existsSync as existsSync2, statSync } from "node:fs";
@@ -5755,6 +5915,92 @@ function register2(program3) {
       `${moved.project_name}/#${moved.number}: ${issue.state.name} \u2192 ${moved.state.name} ("${action2}")`
     );
   });
+  withCommon(
+    issues.command("transfer <ref>").description(
+      'Move an issue to another project, keeping its ID, record and old refs (this is not the workflow "move")'
+    ).requiredOption("-p, --project <name-or-id>", "destination project").option("--dry-run", "print the review and exit without moving anything").option("--inspect <n>", "print the full content of reviewed guidance item [n]").option("-y, --yes", "skip the confirmation prompt")
+  ).action(
+    async (ref, opts) => {
+      const api = client(opts);
+      const issue = await resolveIssue(api, ref);
+      const destination = await resolveProject(api, opts.project);
+      let preview = await api.previewIssueTransfer(issue.id, destination.id);
+      if (opts.inspect !== void 0) {
+        const text3 = formatTransferItem(preview, Number(opts.inspect));
+        if (opts.json) return printJson({ ...preview, inspected: text3 });
+        return console.log(text3);
+      }
+      if (opts.dryRun) {
+        if (opts.json) return printJson(preview);
+        return console.log(formatTransferPreview(preview));
+      }
+      const blocked = () => {
+        const blocker = preview.blockers[0];
+        if (opts.json) {
+          printJson({
+            error: {
+              code: blocker?.code ?? "transfer_blocked",
+              message: blocker?.message ?? "this move is blocked",
+              details: blocker ?? null
+            }
+          });
+          process.exitCode = 1;
+          return;
+        }
+        console.error(formatTransferPreview(preview));
+        return die(blocker ? `${blocker.code}: ${blocker.message}` : "this move is blocked");
+      };
+      if (!preview.can_commit || !preview.preview_token) return blocked();
+      const interactive = !opts.yes && process.stdin.isTTY;
+      if (!opts.yes && !interactive) {
+        die(
+          `refusing to move without a confirmation: rerun with --yes, or review it first with --dry-run --json`
+        );
+      }
+      const rl = interactive ? createInterface({ input: process.stdin, output: process.stderr }) : null;
+      const terminal = {
+        write: (text3) => process.stderr.write(text3),
+        ask: (question) => rl.question(question).catch(() => null)
+      };
+      try {
+        for (let attempt = 0; ; attempt++) {
+          if (interactive) {
+            const decision = await confirmTransfer(
+              preview,
+              terminal,
+              attempt === 0 ? void 0 : "The configuration this review described has changed. Here is the current one:"
+            );
+            if (decision.action === "abort") return die(decision.reason);
+          }
+          try {
+            const result = await api.transferIssue(issue.id, {
+              project_id: destination.id,
+              preview_token: preview.preview_token
+            });
+            if (opts.json) return printJson(result);
+            return console.log(formatTransferResult(result));
+          } catch (e) {
+            const fail = e;
+            if (fail.code === "transfer_preview_stale" && interactive && attempt === 0) {
+              preview = await api.previewIssueTransfer(issue.id, destination.id);
+              if (!preview.can_commit || !preview.preview_token) return blocked();
+              continue;
+            }
+            if (opts.json && fail.code) {
+              printJson({
+                error: { code: fail.code, message: fail.message, details: fail.details ?? null }
+              });
+              process.exitCode = 1;
+              return;
+            }
+            throw e;
+          }
+        }
+      } finally {
+        rl?.close();
+      }
+    }
+  );
   withCommon(
     issues.command("comment <ref> <markdown>").description(`Comment on an issue \u2014 Markdown body: ${BODY_VALUE_HELP}`).passThroughOptions()
   ).action(async (ref, markdown, opts, command) => {
@@ -6437,7 +6683,7 @@ start one: tines journal append ${issue.project_name}/${issue.number} "- <date>:
 }
 
 // src/commands/labels.ts
-import { createInterface } from "node:readline/promises";
+import { createInterface as createInterface2 } from "node:readline/promises";
 function parseLabelColor(value) {
   if (value === void 0) return void 0;
   if (!LABEL_COLORS.includes(value)) {
@@ -6510,7 +6756,7 @@ function register4(program3) {
           `${existing.routing_rule_count} routing rule${existing.routing_rule_count === 1 ? "" : "s"}`
         ] : []
       ].join(", ");
-      const rl = createInterface({ input: process.stdin, output: process.stdout });
+      const rl = createInterface2({ input: process.stdin, output: process.stdout });
       const answer = await rl.question(
         `Delete label "${existing.name}"${opts.force ? " and everything scoped to it" : ""}? It is on ${scoped}. [y/N] `
       );
@@ -9015,7 +9261,7 @@ function register8(program3) {
 }
 
 // src/commands/schedules.ts
-import { createInterface as createInterface2 } from "node:readline/promises";
+import { createInterface as createInterface3 } from "node:readline/promises";
 async function resolveSchedule(api, ref) {
   const { project, name: name2 } = parseScheduleRef(ref);
   const proj = await resolveProject(api, project);
@@ -9179,7 +9425,7 @@ recent instances:`);
     const api = client(opts);
     const schedule = await resolveSchedule(api, ref);
     if (!opts.yes) {
-      const rl = createInterface2({ input: process.stdin, output: process.stdout });
+      const rl = createInterface3({ input: process.stdin, output: process.stdout });
       const answer = await rl.question(
         `Delete schedule "${scheduleRef(schedule)}"? Its ${schedule.run_count} existing issue${schedule.run_count === 1 ? "" : "s"} will be kept. [y/N] `
       );

package/package.json

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