@pi-unipi/kanboard 3.0.0-alpha.17 → 3.0.0-alpha.19

package/index.ts

@@ -44,6 +44,7 @@ import {
   syncPiRuntime,
   runRotateTokenAction,
   runStopDaemon,
+  captureToBacklog,
   type CommandDeps,
 } from "./src/commands.js";
 import { createWriteGuard } from "./src/guard.js";
@@ -224,6 +225,12 @@ export default function (pi: ExtensionAPI) {
   registerProgressRenderer(pi);
   registerKanboardCommands(pi, buildDeps());
 
+  // ── API for other extensions (input-shortcuts K chord) ──────────────
+  // Add the editor text to this project's Backlog as a body-only task.
+  (globalThis as { __unipi_kanboard_api?: unknown }).__unipi_kanboard_api = {
+    captureToBacklog: (opts: { cwd: string; text: string }) => captureToBacklog(buildDeps(), opts),
+  };
+
   // R1 progress reminders for hand-worked tasks (silent in child sessions).
   registerProgressReminders(
     pi,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/kanboard",
-  "version": "3.0.0-alpha.17",
+  "version": "3.0.0-alpha.19",
   "description": "Kanboard v3 — deferred-work board: CLI/daemon bridge, task runner and skill",
   "type": "module",
   "main": "index.ts",
@@ -31,7 +31,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.17"
+    "@pi-unipi/core": "3.0.0-alpha.19"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",
@@ -48,10 +48,10 @@
     "themes": []
   },
   "optionalDependencies": {
-    "@pi-unipi/kanboard-linux-x64": "3.0.0-alpha.17",
-    "@pi-unipi/kanboard-linux-arm64": "3.0.0-alpha.17",
-    "@pi-unipi/kanboard-darwin-x64": "3.0.0-alpha.17",
-    "@pi-unipi/kanboard-darwin-arm64": "3.0.0-alpha.17",
-    "@pi-unipi/kanboard-win32-x64": "3.0.0-alpha.17"
+    "@pi-unipi/kanboard-linux-x64": "3.0.0-alpha.19",
+    "@pi-unipi/kanboard-linux-arm64": "3.0.0-alpha.19",
+    "@pi-unipi/kanboard-darwin-x64": "3.0.0-alpha.19",
+    "@pi-unipi/kanboard-darwin-arm64": "3.0.0-alpha.19",
+    "@pi-unipi/kanboard-win32-x64": "3.0.0-alpha.19"
   }
 }

package/src/commands.ts

@@ -11,6 +11,7 @@ import { join } from "node:path";
 import { promisify } from "node:util";
 
 import type { ExtensionAPI, ExtensionCommandContext, ExtensionContext, Theme } from "@earendil-works/pi-coding-agent";
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import { getSettings } from "@pi-unipi/core";
 
 import { KanboardCliError, type KanboardCli } from "./bin.js";
@@ -576,15 +577,18 @@ export async function runAdd(deps: CommandDeps, ctx: ExtensionCommandContext, te
     ctx.ui.notify(`kanboard: ${parsed.error} — /unipi:kanboard-add [-p 1-5] [--after ID] [--status backlog|todo] <title>`, "warning");
     return;
   }
-  if (!parsed.title) {
-    ctx.ui.notify("kanboard: add needs a title — /unipi:kanboard-add <title>", "warning");
+  const hasDescription = parsed.description.trim().length > 0;
+  if (!parsed.title && !hasDescription) {
+    ctx.ui.notify("kanboard: add needs a title or a description — /unipi:kanboard-add <title> (lines below are the description)", "warning");
     return;
   }
   if (!(await ensureOnboarded(deps, ctx))) return;
 
   let bodyFile: string | null = null;
   try {
-    const argv = ["add", parsed.title, ...parsed.flags];
+    // A description-only add omits the title positional entirely (the binary
+    // stores an empty title and derives the display title from the body).
+    const argv = ["add", ...(parsed.title ? [parsed.title] : []), ...parsed.flags];
     if (parsed.description) {
       bodyFile = join(mkdtempSync(join(tmpdir(), "kb-add-")), "body.md");
       writeFileSync(bodyFile, parsed.description);
@@ -606,6 +610,55 @@ export async function runAdd(deps: CommandDeps, ctx: ExtensionCommandContext, te
   }
 }
 
+export type CaptureToBacklogResult =
+  | { ok: true; id: string; attachments: number }
+  | { ok: false; reason: string };
+
+/**
+ * Capture editor text as a Backlog task body — the entry point the
+ * input-shortcuts K chord calls through `globalThis.__unipi_kanboard_api`.
+ * No title: the body carries the point (the binary derives the display
+ * title). No prompts: when the folder is not onboarded the capture is
+ * refused with the reason instead.
+ */
+export async function captureToBacklog(
+  deps: CommandDeps,
+  opts: { cwd: string; text: string },
+): Promise<CaptureToBacklogResult> {
+  const client = deps.cli;
+  if (!client) return { ok: false, reason: deps.unavailable ?? "kanboard binary unavailable" };
+  let slug: string | null = null;
+  try {
+    const settings = getSettings("kanboard", opts.cwd) as { slug?: string };
+    slug = typeof settings.slug === "string" && settings.slug.length > 0 ? settings.slug : null;
+  } catch {
+    slug = null;
+  }
+  if (!slug) {
+    return { ok: false, reason: "kanboard is not set up here — run /unipi:kanboard" };
+  }
+  const text = opts.text.trim();
+  if (!text) return { ok: false, reason: "nothing to add" };
+  const attaches = detectFilePaths(text);
+  let bodyFile: string | null = null;
+  try {
+    bodyFile = join(mkdtempSync(join(tmpdir(), "kb-capture-")), "body.md");
+    writeFileSync(bodyFile, text);
+    const argv = ["--project", slug, "add", "--status", "backlog", "--body-file", bodyFile];
+    for (const file of attaches) argv.push("--attach", file);
+    const task = asTask("add", await client.run<unknown>(argv, { cwd: opts.cwd }));
+    deps.debug(`captureToBacklog ${task.id} (${attaches.length} attachments)`);
+    return { ok: true, id: task.id, attachments: attaches.length };
+  } catch (error) {
+    return {
+      ok: false,
+      reason: error instanceof KanboardCliError ? error.message : String(error),
+    };
+  } finally {
+    if (bodyFile) rmSync(join(bodyFile, ".."), { recursive: true, force: true });
+  }
+}
+
 export async function runStatus(deps: CommandDeps, ctx: ExtensionCommandContext | ExtensionContext): Promise<void> {
   const client = deps.cli;
   const lines: string[] = [];
@@ -806,6 +859,8 @@ export async function runRotateTokenAction(
 interface ShowTask {
   id: string;
   title: string;
+  /** Derived title (Rust `display_title`) — shown when `title` is empty. */
+  displayTitle?: string;
   status: string;
   priority?: string;
   order?: number;
@@ -831,6 +886,11 @@ const SHOW_EXTRA_LANES: Array<{ id: string; label: string }> = [
 const PRIO_GLYPH: Record<string, string> = { urgent: "⇈", high: "↑", medium: "·", low: "↓", none: " " };
 const PRIO_RANK: Record<string, number> = { urgent: 0, high: 1, medium: 2, low: 3, none: 4 };
 
+/** The title a row shows: the derived one when the raw title is empty. */
+function showTitle(task: ShowTask): string {
+  return task.displayTitle || task.title || "(untitled)";
+}
+
 /** Same ordering as the CLI's claim_sort: priority, then lane order, then id. */
 export function claimOrder(tasks: ShowTask[]): ShowTask[] {
   return [...tasks].sort(
@@ -875,7 +935,7 @@ function laneRows(tasks: ShowTask[], lane: string): ShowRow[] {
         number: `${number}.`,
         id: task.id,
         prio: PRIO_GLYPH[task.priority ?? "none"] ?? " ",
-        title: task.title,
+        title: showTitle(task),
         extra:
           task.ready === false || waits.length > 0
             ? `waits for ${waits.join(", ")}`
@@ -898,7 +958,7 @@ function laneRows(tasks: ShowTask[], lane: string): ShowRow[] {
       branch: "",
       id: task.id,
       prio: PRIO_GLYPH[task.priority ?? "none"] ?? " ",
-      title: task.title,
+      title: showTitle(task),
       extra:
         lane === "in_progress" && task.run?.session
           ? `· ${task.run.session}`
@@ -952,15 +1012,29 @@ export function showRenderer(
         lines.push(theme.fg("accent", lane.label));
         for (const row of laneRows(inLane, lane.id)) {
           const head = `  ${row.branch}${row.number ? `${row.number} ` : ""}${theme.fg("muted", row.id)} ${row.prio} `;
-          // visible length so far, then truncate the title to fit.
-          const prefixLen = 2 + row.branch.length + (row.number ? row.number.length + 1 : 0) + row.id.length + 2;
-          const budget = Math.max(10, width - prefixLen - (row.extra ? row.extra.length + 2 : 0));
-          const title = row.title.length > budget ? `${row.title.slice(0, Math.max(1, budget - 1))}…` : row.title;
-          const extra = row.extra ? `  ${row.tone === "error" ? theme.fg("error", row.extra) : theme.fg("dim", row.extra)}` : "";
-          lines.push(`${head}${title}${extra}`);
+          const styledExtra = row.extra
+            ? `  ${row.tone === "error" ? theme.fg("error", row.extra) : theme.fg("dim", row.extra)}`
+            : "";
+          // Budgets in visible cells (CJK ≈ 2 cells, ANSI = 0 — .length lies on both).
+          // Title takes all the room left after the extra when both fit comfortably,
+          // else it is capped at 10 cells; the extra then takes whatever remains, so a
+          // huge blockedReason is truncated instead of overflowing the terminal (which
+          // hard-crashes pi). Final truncate is the belt-and-braces guarantee.
+          const avail = Math.max(0, width - visibleWidth(head));
+          const extraW = styledExtra ? visibleWidth(styledExtra) : 0;
+          const titleBudget = Math.max(0, avail - extraW >= 10 ? avail - extraW : Math.min(avail, 10));
+          const title = truncateToWidth(row.title, titleBudget, "…");
+          let line = `${head}${title}`;
+          if (styledExtra) {
+            const extraBudget = avail - visibleWidth(title) - 2;
+            if (extraBudget > 0) line += truncateToWidth(styledExtra, extraBudget + 2, "…");
+          }
+          lines.push(line);
         }
       }
-      return lines;
+      // Hard guarantee: a line wider than the terminal hard-crashes pi, so every
+      // emitted line — header and lane labels included — is truncated to `width`.
+      return lines.map((line) => truncateToWidth(line, width));
     },
     invalidate: () => undefined,
   };
@@ -1094,19 +1168,19 @@ export async function taskCompletions(
   const needle = prefix.toLowerCase();
   const items = cache.tasks
     .filter((task) => !["cancelled", "archived"].includes(task.status))
-    .filter((task) => task.id.toLowerCase().startsWith(needle) || (titleSearch && task.title.toLowerCase().includes(needle)))
+    .filter((task) => task.id.toLowerCase().startsWith(needle) || (titleSearch && showTitle(task).toLowerCase().includes(needle)))
     .slice(0, 12)
     .map((task) =>
       rowStyle === "id-title"
         ? {
             value: fullArgs(before, task.id),
-            label: `${task.id}  ${task.title.slice(0, 64)}`,
+            label: `${task.id}  ${showTitle(task).slice(0, 64)}`,
             description: task.status,
           }
         : {
             value: fullArgs(before, task.id),
             label: task.id,
-            description: `${task.status} — ${task.title}`,
+            description: `${task.status} — ${showTitle(task)}`,
           },
     );
   return items.length > 0 ? items : null;

package/src/monitor.ts

@@ -294,7 +294,7 @@ export function createKanboardMonitor(deps: MonitorDeps): KanboardMonitor {
 						source: "kanboard",
 						priority: AUTOWORK_PRIORITY,
 						customType: AUTOWORK_NUDGE_CUSTOM_TYPE,
-						content: `↻ next ready: ${next.id} ${next.title} — show it, start it, work it (autowork) ${ANTI_POISONING_SUFFIX}`,
+						content: `↻ next ready: ${next.id} ${next.displayTitle || next.title || "(untitled)"} — show it, start it, work it (autowork) ${ANTI_POISONING_SUFFIX}`,
 						display: true,
 						onDelivered: () => {
 							offersPerTask.set(next.id, offers); // counts on DELIVERY, not proposal

package/src/shapes.ts

@@ -45,6 +45,8 @@ export interface KanboardActivity {
 export interface KanboardTask {
   id: string;
   title: string;
+  /** Title derived from the first body line when `title` is empty (Rust `Task::display_title`). */
+  displayTitle?: string;
   body?: string;
   status: string;
   priority?: string;
@@ -115,6 +117,7 @@ export function asTask(command: string, value: unknown): KanboardTask {
     ...record,
     id: requireString(command, record, "id"),
     title: requireString(command, record, "title"),
+    displayTitle: typeof record.displayTitle === "string" ? record.displayTitle : undefined,
     status: requireString(command, record, "status"),
     deps: optionalArray<string>(record.deps) ?? [],
     activity: optionalArray<KanboardActivity>(record.activity) ?? [],