@gavin-hu/my-pi-agent 0.19.0 → 0.20.0

package/extensions/board/view/actions.ts

@@ -1,306 +0,0 @@
-/**
- * The client's writes and its two kit dialogs: one request per named action, the
- * confirmation a claim, a reclaim, or a deletion asks for first, and the card dialog
- * that shows a card whole.
- *
- * A browser is not an identity — the page writes as the session that serves it — so
- * the three actions that move a card between people ask before they act, and the
- * answer names the card and the session. Everything else is a single request whose
- * refusal becomes a banner, never an `alert()`.
- *
- * Both dialogs are the kit's (`bf-dialog` + `dialogScript`): the Tab trap, `Esc`,
- * the backdrop click, and the focus return are `lib/web`'s. This module only fills
- * them, answers them, and notices when the user dismissed one.
- */
-
-export const BOARD_ACTIONS_JS = String.raw`(function () {
-  "use strict";
-  var board = window.bfBoard || (window.bfBoard = {});
-  var token = new URLSearchParams(window.location.search).get("token") || "";
-
-  /** The one place a message reaches the reader: a banner, cleared by the next success. */
-  function banner(message) {
-    var node = document.getElementById("board-banner");
-    if (!node) return;
-    node.hidden = !message;
-    node.textContent = message || "";
-  }
-
-  /** One write. The token rides in the query string, the body is JSON. */
-  function request(path, method, body) {
-    var url = path + "?token=" + encodeURIComponent(token);
-    var options = { method: method };
-    if (body !== undefined) {
-      options.headers = { "Content-Type": "application/json" };
-      options.body = JSON.stringify(body);
-    }
-    return fetch(url, options).then(function (response) {
-      return response.json().catch(function () { return {}; }).then(function (payload) {
-        if (!response.ok) {
-          throw new Error(payload && payload.error ? payload.error : "The board refused that (" + response.status + ").");
-        }
-        banner("");
-        return payload;
-      });
-    });
-  }
-
-  function post(path, body) {
-    return request(path, "POST", body);
-  }
-
-  function remove(path) {
-    return request(path, "DELETE");
-  }
-
-  /** Call settle(false) when the kit closes the dialog without this module asking. */
-  function whenClosed(dialog, settle) {
-    var observer = new MutationObserver(function () {
-      if (dialog.hidden) {
-        observer.disconnect();
-        settle(false);
-      }
-    });
-    observer.observe(dialog, { attributes: true, attributeFilter: ["hidden"] });
-    return function () {
-      observer.disconnect();
-    };
-  }
-
-  /**
-   * Ask one question in the confirm dialog, and answer whether it was accepted.
-   *
-   * Esc and a backdrop click are the kit's to handle, and both mean "no": the
-   * dialog's hidden attribute going back up is what settles the promise, so a
-   * dismissed question never leaves the caller waiting.
-   */
-  function confirm(options) {
-    var dialog = document.getElementById("board-confirm");
-    var ok = document.getElementById("confirm-ok");
-    var cancel = document.getElementById("confirm-cancel");
-    if (!dialog || !ok || !cancel || !window.bfConfirm) return Promise.resolve(true);
-    document.getElementById("confirm-title").textContent = options.title;
-    document.getElementById("confirm-body").textContent = options.body || "";
-    ok.textContent = options.ok || "Confirm";
-    ok.className = "bf-btn " + (options.danger ? "bf-btn--danger" : "bf-btn--primary");
-    return new Promise(function (resolve) {
-      var answered = false;
-      function finish(value) {
-        if (answered) return;
-        answered = true;
-        ok.removeEventListener("click", accept);
-        cancel.removeEventListener("click", dismiss);
-        stop();
-        if (!dialog.hidden) window.bfConfirm.close();
-        resolve(value);
-      }
-      function accept() { finish(true); }
-      function dismiss() { finish(false); }
-      var stop = whenClosed(dialog, finish);
-      ok.addEventListener("click", accept);
-      cancel.addEventListener("click", dismiss);
-      window.bfConfirm.open();
-      cancel.focus();
-    });
-  }
-
-  /** The question a claim, a reclaim, or a deletion asks, or none for the rest. */
-  function question(verb, card) {
-    var me = board.view ? board.view.me.label : "this session";
-    if (verb === "claim") {
-      return { title: "Claim #" + card.id + "?", body: "Claim #" + card.id + " as " + me + "?", ok: "Claim" };
-    }
-    if (verb === "reclaim") {
-      return {
-        title: "Reclaim #" + card.id + "?",
-        body: "Reclaim #" + card.id + " from " + (card.owner ? card.owner.label : "nobody") + "? It returns to To do and keeps its notes.",
-        ok: "Reclaim",
-        danger: true
-      };
-    }
-    if (verb === "drop") {
-      var notes = card.notes.length;
-      return {
-        title: "Delete #" + card.id + "?",
-        body: "Delete #" + card.id + (notes > 0 ? " and its " + notes + " notes?" : "?"),
-        ok: "Delete",
-        danger: true
-      };
-    }
-    return undefined;
-  }
-
-  /**
-   * Run one named action against a card, after its question when it has one.
-   *
-   * A refusal is a banner; a success needs nothing, because the next frame is the
-   * truth and it arrives within a second.
-   */
-  board.act = function (verb, card, extra) {
-    var ask = question(verb, card);
-    var proceed = ask ? confirm(ask) : Promise.resolve(true);
-    return proceed.then(function (accepted) {
-      if (!accepted) return undefined;
-      var path = "/api/cards/" + encodeURIComponent(card.id);
-      var done = verb === "drop" ? remove(path) : post(path + "/" + verb, extra || {});
-      return done.catch(function (error) {
-        banner(error.message);
-        return undefined;
-      });
-    });
-  };
-
-  /**
-   * Hand an unowned card to a teammate, from the board rather than the bus.
-   *
-   * The page records the owner; it cannot send, so the card's history says no handoff
-   * went out and the peer reads it the next time it looks. The team tool's assign is
-   * the action that messages somebody.
-   */
-  board.assignTo = function (card, label) {
-    return post("/api/cards/" + encodeURIComponent(card.id) + "/assign", { to: label }).catch(function (error) {
-      banner(error.message);
-      return undefined;
-    });
-  };
-
-  /** Add a card from the composer. */
-  board.add = function (input) {
-    return post("/api/cards", input).catch(function (error) {
-      banner(error.message);
-      return undefined;
-    });
-  };
-
-  /** Note the card whose dialog is open, from its own field. */
-  board.addNote = function () {
-    var input = document.getElementById("card-dialog-note");
-    if (!input || board.openId === undefined) return undefined;
-    var text = input.value.trim();
-    if (!text) return undefined;
-    var card = board.findCard(board.view, board.openId);
-    if (!card) return undefined;
-    return post("/api/cards/" + encodeURIComponent(card.id) + "/note", { text: text })
-      .then(function (payload) {
-        input.value = "";
-        return payload;
-      })
-      .catch(function (error) {
-        banner(error.message);
-        return undefined;
-      });
-  };
-
-  /** Fill and open the card dialog; the second argument names what to focus. */
-  board.openCard = function (id, focus) {
-    var view = board.view;
-    if (!view) return;
-    var card = board.findCard(view, id);
-    if (!card || !window.bfCard) return;
-    board.openId = id;
-    board.fillDialog(card, view);
-    window.bfCard.open();
-    if (focus === "note") {
-      var input = document.getElementById("card-dialog-note");
-      if (input) input.focus();
-    }
-  };
-
-  board.closeCard = function () {
-    if (window.bfCard) window.bfCard.close();
-  };
-
-  board.dialogOpen = function () {
-    return window.bfCard ? window.bfCard.isOpen() : false;
-  };
-
-  /**
-   * Assign to: a teammate, then the button.
-   *
-   * The names come from the roster the page already has, live first: a session that has
-   * gone quiet is still a label a card can record, but it is not the one to pick.
-   */
-  function assignControl(card, view) {
-    var row = board.el("div", "board-dialog__assign");
-    var select = board.el("select", "bf-input board-dialog__assign-select");
-    select.setAttribute("aria-label", "Assign to");
-    var mates = view.teammates === undefined ? [] : view.teammates.map(function (mate) { return mate.label; });
-    // Your own terminal is not somebody to hand a card to, and neither is the seat.
-    var self = view.session ? view.session.label : "";
-    var others = mates.filter(function (label) { return label.toLowerCase() !== self.toLowerCase(); });
-    if (others.length > 0) mates = others;
-    if (mates.length === 0) mates = ["team-lead"];
-    for (var i = 0; i < mates.length; i++) {
-      var option = board.el("option", "", mates[i]);
-      option.value = mates[i];
-      select.appendChild(option);
-    }
-    row.appendChild(board.el("span", "board-dialog__label", "Assign to"));
-    row.appendChild(select);
-    row.appendChild(board.actionButton("Assign", function () { board.assignTo(card, select.value); }));
-    return row;
-  }
-
-  /**
-   * The card dialog's footer: the claim an unowned card is waiting for, the lane
-   * buttons its owner may move to, then its destructive ones. Nothing here is a
-   * card-face action, so a reader cannot delete a card from the lane by hitting the
-   * wrong button.
-   */
-  board.fillDialogActions = function (card, view) {
-    var footer = document.getElementById("card-dialog-actions");
-    if (!footer) return;
-    footer.textContent = "";
-    // Which verb a card allows is board.may's answer, the same one the card face and a
-    // queue row ask; this list only decides which of them the footer shows, and in what
-    // order. An unclaimed card is waiting for its first owner — without Claim the dialog
-    // offered a reader only Drop and Close on a card they had just opened.
-    if (board.may(card, view, "claim")) {
-      footer.appendChild(board.actionButton("Claim", function () { board.act("claim", card); }, "primary"));
-    }
-    if (board.may(card, view, "move")) {
-      // Only the lanes this card can reach: the lane it is in is the head's status, and
-      // a segmented control whose selected item is a disabled button reads as a live one.
-      var targets = ["doing", "blocked", "done"].filter(function (lane) { return lane !== card.status; });
-      var move = board.el("div", "board-dialog__move");
-      move.appendChild(board.el("span", "board-dialog__label", "Move to"));
-      var lanes = board.el("div", "bf-segmented");
-      for (var i = 0; i < targets.length; i++) {
-        (function (lane) {
-          var item = board.el("button", "bf-segmented__item", board.laneLabel(lane));
-          item.type = "button";
-          item.addEventListener("click", function () { board.act("move", card, { status: lane }); });
-          lanes.appendChild(item);
-        })(targets[i]);
-      }
-      move.appendChild(lanes);
-      footer.appendChild(move);
-    }
-    if (board.may(card, view, "assign")) footer.appendChild(assignControl(card, view));
-    if (board.may(card, view, "release")) {
-      footer.appendChild(board.actionButton("Release", function () { board.act("release", card); }));
-    }
-    // Fixing what the card says follows the same rule the rules do: the holder decides,
-    // and anyone decides while nobody holds it — including a finished card.
-    if (board.may(card, view, "edit")) {
-      footer.appendChild(board.actionButton("Edit", function () { board.editCard(card); }));
-    }
-    if (board.may(card, view, "drop")) {
-      footer.appendChild(board.actionButton("Drop", function () { board.act("drop", card); }, "danger"));
-    }
-    footer.appendChild(board.actionButton("Close", function () { board.closeCard(); }));
-  };
-
-  // A dialog the kit closed — Esc, a backdrop click, or its own close button —
-  // forgets which card it showed, so the next frame stops filling a hidden panel.
-  var cardDialog = document.getElementById("board-card-dialog");
-  if (cardDialog) {
-    new MutationObserver(function () {
-      if (cardDialog.hidden) board.openId = undefined;
-    }).observe(cardDialog, { attributes: true, attributeFilter: ["hidden"] });
-  }
-
-  board.banner = banner;
-  board.confirm = confirm;
-  board.post = post;
-})();`;

package/extensions/board/writes.ts

@@ -1,99 +0,0 @@
-/**
- * The page's write path: one request from a browser, one call into the store.
- *
- * A browser is not an identity, so every write here is made as the actor the page
- * serves as — the session that started it, until a page has a seat. Two statuses matter
- * to a client that retries: a field it can fix is 422, and a card somebody else moved is
- * 409 with the card as it now stands. Everything else about a card's lifecycle is
- * `lib/board/rules.ts`.
- */
-
-import { normalizeCardId } from "../../lib/board/card.ts";
-import type { Actor, CardOp } from "../../lib/board/rules.ts";
-import type { BoardStore } from "../../lib/board/store.ts";
-import { normalizeLabel } from "../../lib/session-label.ts";
-import { createInput } from "./input.ts";
-import type { PageResult, PageWrite } from "./transport/router.ts";
-
-/** What a write needs: the store, who it is made as, and the clock. */
-export interface WriteContext {
-	store: BoardStore;
-	actor: () => Actor;
-	now: () => number;
-}
-
-/** One write, with the status the page shows as a banner. */
-export async function writeOf(context: WriteContext, request: PageWrite): Promise<PageResult> {
-	const me = context.actor();
-	if (request.kind === "add") {
-		const parsed = createInput(request.body);
-		if ("error" in parsed) return { ok: false, status: 422, error: parsed.error };
-		const card = await context.store.create(parsed.input, me, context.now());
-		return { ok: true, card };
-	}
-
-	const id = normalizeCardId(request.id);
-	if (id === undefined) return { ok: false, status: 422, error: `"${request.id}" is not a card id.` };
-	const op = opOf(request);
-	if ("error" in op) return { ok: false, status: 422, error: op.error };
-	const result = await context.store.mutate(id, op.op, me, context.now());
-	if (!result.ok)
-		return {
-			ok: false,
-			status: 409,
-			error: result.error,
-			...(result.card === undefined ? {} : { card: result.card }),
-		};
-	return { ok: true, card: result.card };
-}
-
-/** The operation a card route names, or the reason it cannot be one. */
-export function opOf(request: PageWrite): { op: CardOp } | { error: string } {
-	switch (request.kind) {
-		case "claim":
-			return { op: { kind: "claim" } };
-		case "release":
-			return { op: { kind: "release" } };
-		case "reclaim":
-			return { op: { kind: "reclaim" } };
-		case "assign": {
-			// A page cannot message a peer — a command context has no tool calls — so this
-			// records the owner and says in the card's history that nothing was sent.
-			const to = normalizeLabel(typeof request.body.to === "string" ? request.body.to : "", "");
-			if (to === "") return { error: "assign needs a teammate to hand the card to." };
-			return {
-				op: {
-					kind: "assign",
-					to: { label: to },
-					note: `assigned to ${to} from the board page; no handoff was sent`,
-				},
-			};
-		}
-		case "drop":
-			return { op: { kind: "drop" } };
-		case "note":
-			return { op: { kind: "note", text: request.body.text } };
-		case "plan":
-			return { op: { kind: "plan", path: request.body.path } };
-		case "edit":
-			// Every field is passed through as the browser sent it, including the absent
-			// ones: `applyOp` leaves an absent field alone, which is what keeps the page
-			// from clearing a link it never showed.
-			return {
-				op: {
-					kind: "edit",
-					title: request.body.title,
-					paths: request.body.paths,
-					priority: request.body.priority,
-					dependsOn: request.body.dependsOn,
-				},
-			};
-		case "move": {
-			const status = request.body.status;
-			if (status === "doing" || status === "blocked" || status === "done") return { op: { kind: "move", status } };
-			return { error: 'move needs a target lane: "doing", "blocked", or "done".' };
-		}
-		default:
-			return { error: "add is not a card route." };
-	}
-}

package/extensions/bytefly/panel/tui/extensions-view.ts

@@ -1,40 +0,0 @@
-/**
- * The Extensions section's focused-row pane.
- *
- * The row, the summary, and the key hints are the shared list grammar; what is
- * specific here is the doctor's findings, including the resource path when a row
- * has no verdict.
- */
-
-import type { Theme } from "@earendil-works/pi-coding-agent";
-import { sanitizeLine } from "../../../../lib/format.ts";
-import { clip } from "../../../../lib/tui/columns.ts";
-import { paint } from "../../../../lib/tui/tokens.ts";
-import { detailLines as reportDetailLines } from "../../doctor/format.ts";
-import { rowBadge } from "../format.ts";
-import type { PanelRow } from "../types.ts";
-import { savedLine } from "./frame.ts";
-
-/** The focused extension's findings and the pending-changes note. */
-export function extensionDetail(
-	theme: Theme,
-	width: number,
-	row: PanelRow | undefined,
-	budget: number,
-	expanded: boolean,
-	dirty: boolean,
-): string[] {
-	const lines: string[] = [];
-	const badge = row ? rowBadge(row) : undefined;
-	// The focused row directly above already carries the entry's name and verdict,
-	// so the pane starts with what the row cannot say: the findings, or the
-	// resource path when nothing was reported.
-	if (badge?.text === undefined && row?.item) {
-		lines.push(clip(`  ${paint(theme, "meta", sanitizeLine(row.item.path))}`, width));
-	}
-	if (row?.report && budget > 0) {
-		lines.push(...reportDetailLines(row.report, theme, width, budget, expanded));
-	}
-	lines.push(...savedLine(theme, width, dirty));
-	return lines;
-}

package/extensions/bytefly/panel/tui/skills-view.ts

@@ -1,50 +0,0 @@
-/**
- * The Skills section: the focused skill's path, description, and refusal.
- *
- * Rows, the summary, and the key hints come from the shared list view, and the
- * row verdict is already `rowBadge`'s. The pane therefore starts with what the
- * row cannot say: the resolved file and what its frontmatter declares, or why Pi
- * refused it. Pure functions over the merged row; the component owns the cursor,
- * the scope, and the expansion.
- */
-
-import type { Theme } from "@earendil-works/pi-coding-agent";
-import { wrapTextWithAnsi } from "@earendil-works/pi-tui";
-import { sanitizeLine } from "../../../../lib/format.ts";
-import { clip } from "../../../../lib/tui/columns.ts";
-import { BODY_INDENT } from "../../../../lib/tui/indent.ts";
-import { paint } from "../../../../lib/tui/tokens.ts";
-import type { PanelRow } from "../types.ts";
-import { INDENT, savedLine } from "./frame.ts";
-
-/** The focused skill's file, description (or refusal), and pending changes. */
-export function skillDetail(options: {
-	theme: Theme;
-	width: number;
-	row: PanelRow | undefined;
-	budget: number;
-	expanded: boolean;
-	dirty: boolean;
-}): string[] {
-	const { theme, width, row, budget, expanded, dirty } = options;
-	// The focused row above already carries the name and verdict, so the pane
-	// starts with the file it resolves to.
-	const lines: string[] = [];
-	if (row?.item) lines.push(clip(`${INDENT}${paint(theme, "meta", sanitizeLine(row.item.path))}`, width));
-	const saved = savedLine(theme, width, dirty);
-	const skill = row?.skill;
-	const text = skill?.problem !== undefined ? `Not loaded: ${skill.problem}` : skill?.description;
-	if (text && budget > 1) {
-		// One line while collapsed, the whole wrapped description when expanded,
-		// minus the file line already pushed and the saved marker below it.
-		const available = Math.max(0, budget - lines.length - saved.length);
-		const room = expanded ? available : Math.min(1, available);
-		const bodyWidth = Math.max(1, width - BODY_INDENT);
-		const role = skill?.problem !== undefined ? "warn" : "meta";
-		for (const line of wrapTextWithAnsi(sanitizeLine(text), bodyWidth).slice(0, room)) {
-			lines.push(clip(`${INDENT}${paint(theme, role, line)}`, width));
-		}
-	}
-	lines.push(...saved);
-	return lines;
-}

package/extensions/job/process.ts

@@ -1,35 +0,0 @@
-/**
- * Process plumbing that only `job` needs.
- *
- * The shared spawn, tree-kill, and liveness seams live in `lib/spawn.ts`, so
- * what stays here is the job-specific remainder: the pid liveness and start-time
- * seams the runtime injects, and the `ps` token that guards against pid reuse
- * when a reattached job is settled.
- */
-
-import { execFileSync } from "node:child_process";
-
-/** Whether a pid is still alive. */
-export type LivenessFn = (pid: number) => boolean;
-
-/**
- * Best-effort OS start-time token for a pid, used to detect pid reuse.
- * Returns undefined when the platform cannot provide one (for example Windows,
- * or a process that is already gone), in which case callers fall back to
- * liveness alone.
- */
-export type StartTokenFn = (pid: number) => string | undefined;
-
-/** Default start-time token via `ps`. Undefined where `ps` is unavailable. */
-export const defaultStartToken: StartTokenFn = (pid) => {
-	try {
-		const out = execFileSync("ps", ["-p", String(pid), "-o", "lstart="], {
-			stdio: ["ignore", "pipe", "ignore"],
-			timeout: 2000,
-		});
-		const text = out.toString().trim();
-		return text || undefined;
-	} catch {
-		return undefined;
-	}
-};