@bastani/atomic 0.9.16-alpha.2 → 0.9.16-alpha.3

package/dist/builtin/workflows/src/tui/dispatch-confirm.ts

@@ -1,334 +0,0 @@
-/**
- * `/workflow <name> …` dispatch confirmation — chat surface from
- * ui/dispatch-mockup.html §1 (compact two-row redesign).
- *
- * Visual contract:
- *  - One rounded `DISPATCHED` panel.
- *  - One status-coloured rounded run card:
- *      title: full runId · workflowName · ● running
- *      body: compact `k=v · k=v · +N more` input summary when present
- *
- * What we deliberately do NOT emit (was in the legacy 7-row layout):
- *  - the `✓ submitted · /workflow <name>` echo line — pi already shows
- *    the user's slash-input verbatim, with all inputs, on its own row;
- *  - the `[ DISPATCHED ]` band — a single-card surface doesn't need a
- *    band wrapper (bands frame multi-card surfaces like BACKGROUND /
- *    WORKFLOWS);
- *  - the `run id` muted caption — the bare identifier row already
- *    communicates identity without restoring legacy chrome;
- *  - the `status starting…` body row — the `● running` badge on row 1
- *    occupies the same semantic slot;
- *  - the second hint row `▸ /workflow status` — that is a separate intent
- *    (list other in-flight runs), already discoverable from a bare `/workflow`
- *    invocation and the picker's confirm panel.
- *
- * Plain mode drops ANSI; the rounded panel/card layout shape is preserved.
- *
- * cross-ref:
- *  - ui/dispatch-mockup.html (before / after side-by-side)
- *  - ui/mockups.html §1 (legacy 6-row layout, preserved for context)
- *  - src/tui/chat-surface.ts shared primitives (renderTaggedCard,
- *    renderHintRows, including the `titleSuffix` slot used here)
- */
-
-import type { WorkflowInputValues } from "../shared/types.js";
-import { chatWidth, ELLIPSIS, renderRoundedBox } from "./chat-surface.js";
-import { hexToAnsi, RESET } from "./color-utils.js";
-import type { GraphTheme } from "./graph-theme.js";
-import { wrapIdentifierLines } from "./run-identity-rows.js";
-import { truncateToWidth, visibleWidth } from "./text-helpers.js";
-
-const INLINE_INPUT_LIMIT = 3;
-
-/**
- * Below this many cells, inline inputs on row 1 are unreadable. We wrap
- * to a body row instead. Empirically: shorter than `prompt="x" · +1 more`
- * (≈14 cells) leaves no headroom for the inputs to survive truncation,
- * and the body row's full-width budget is always more useful.
- */
-const MIN_INLINE_INPUT_BUDGET = 16;
-
-export interface RenderDispatchConfirmOpts {
-	/** Registered workflow name rendered beside the full run-id body row. */
-	workflowName: string;
-	/** Real run UUID; every rendered occurrence keeps the complete value. */
-	runId: string;
-	/** Inputs merged from CLI tokens + picker output. */
-	inputs: Readonly<WorkflowInputValues>;
-	/** Provide for themed chrome; omit for plain ASCII. */
-	theme?: GraphTheme;
-	/** Render width (cells). Defaults to `process.stdout.columns`. */
-	width?: number;
-}
-
-/**
- * Render the post-dispatch confirmation: one rounded panel containing a
- * rounded run card with runId, workflow name, inputs summary, and a
- * `● running` status badge, followed by a workflow-control hint.
- */
-export function renderDispatchConfirm(opts: RenderDispatchConfirmOpts): string {
-	const width = effectiveWidth(opts.width);
-	const theme = opts.theme;
-	const accent = theme?.warning ?? "#000000";
-	const tag = opts.runId;
-	// Status badge — anchored to the right of row 1, in the running hue.
-	// Mirrors the `● running` glyph used by every other live-run surface.
-	const trailing = theme ? { text: "● running", fg: theme.warning } : { text: "● running" };
-
-	// Decide whether the inputs ride row 1 (inline suffix beside the
-	// workflow name) or wrap to a body row. Budget math mirrors
-	// `renderTaggedCard`'s row-1 chrome accounting:
-	//
-	//   " "(1)  (1) " "(1) [tag](tag.length + 2) "  "(2) title(titleW)
-	//   "  "(2) suffix(suffixW) gap(≥1) trailing(trailingW) " "(1)
-	//
-	// Solve for the max suffix width that still leaves room for the
-	// bold workflow name + status badge at the right edge.
-	const STRIPE_PREFIX_W = 2;
-	const TAG_PILL_PAD = 2;
-	const TITLE_MARGIN = 2;
-	const SUFFIX_SEP = 2;
-	const TRAILING_GAP = 1; // min cells between suffix and trailing badge
-	const END_PAD = 1;
-	const tagW = tag.length + TAG_PILL_PAD;
-	const titleW = visibleWidth(opts.workflowName);
-	const trailingW = visibleWidth(trailing.text);
-	const inlineBudget = Math.max(
-		0,
-		width - STRIPE_PREFIX_W - tagW - TITLE_MARGIN - titleW - SUFFIX_SEP - TRAILING_GAP - trailingW - END_PAD,
-	);
-
-	const hasInputs = Object.keys(opts.inputs).length > 0;
-	let titleSuffix: string | undefined;
-	const bodyRows: string[] = [];
-
-	if (hasInputs && inlineBudget >= MIN_INLINE_INPUT_BUDGET) {
-		const inline = renderInputsSegment(opts.inputs, inlineBudget, theme);
-		if (inline?.fitted) {
-			titleSuffix = inline.rendered;
-		}
-	}
-
-	// Body row is the overflow path: either the inline budget was too
-	// tight, or the rendered inputs spilled past it. Either way, we use
-	// the full body interior (width - body chrome) as the wider canvas.
-	if (hasInputs && titleSuffix === undefined) {
-		const BODY_PREFIX_W = 4; // "    " — see renderTaggedCard body prefix
-		const bodyBudget = Math.max(0, width - 2 - BODY_PREFIX_W);
-		const overflowSeg = renderInputsSegment(opts.inputs, bodyBudget, theme);
-		if (overflowSeg) bodyRows.push(overflowSeg.rendered);
-	}
-
-	const inputRows =
-		bodyRows.length > 0 ? bodyRows.map((row) => `   ${row} `) : [`   ${titleSuffix ?? "started in background"} `];
-	const identifierRows = renderIdentifierRows(opts.runId, width - 2, theme);
-	const titleLine = ` ●  ${opts.workflowName}  ${trailing.text} `;
-
-	const hints = renderDispatchHintRows(opts.runId, width - 4, theme).map((line) => ` ${line} `);
-
-	return renderRoundedBox({
-		title: "DISPATCHED",
-		bodyLines: [...identifierRows, titleLine, ...inputRows, "", ...hints],
-		accent,
-		theme,
-		width,
-	});
-}
-
-function renderIdentifierRows(id: string, width: number, theme?: GraphTheme): string[] {
-	const rows = wrapIdentifierLines(id, width, "   ", "   ");
-	if (!theme) return rows.map((row) => `${row.prefix}${row.chunk}`);
-	const accent = hexToAnsi(theme.accent);
-	return rows.map((row) => `${row.prefix}${accent}${row.chunk}${RESET}`);
-}
-
-function renderDispatchHintRows(id: string, width: number, theme?: GraphTheme): string[] {
-	const budget = Math.max(1, width);
-	const prefix = "▸ /workflow connect ";
-	const continuation = "  ";
-	const rows = wrapIdentifierLines(id, budget, prefix, continuation);
-	const suffix = "  see agents working · chat with and steer each stage";
-	const last = rows[rows.length - 1]!;
-	if (visibleWidth(`${last.prefix}${last.chunk}${suffix}`) <= budget) {
-		last.chunk += suffix;
-	} else {
-		rows.push({
-			prefix: continuation,
-			chunk: truncateToWidth(suffix.trimStart(), Math.max(1, budget - visibleWidth(continuation)), ELLIPSIS),
-		});
-	}
-	if (!theme) return rows.map((row) => `${row.prefix}${row.chunk}`);
-	const dim = hexToAnsi(theme.dim);
-	const accent = hexToAnsi(theme.accent);
-	return rows.map((row) => `${dim}${row.prefix}${RESET}${accent}${row.chunk}${RESET}`);
-}
-
-interface InputsSegment {
-	/** Pre-styled string; safe to splice directly into a card row. */
-	rendered: string;
-	/** Visible width (excluding ANSI escapes). */
-	visibleWidth: number;
-	/**
-	 * `true` when the natural styled `k=v · k=v · +N more` form fit inside
-	 * `budget`; `false` when the segment had to fall back to the degraded
-	 * `k=v, k=v, …` truncated single-line form.
-	 *
-	 * The inline (row-1 suffix) path MUST only accept `fitted === true`
-	 * results — the body row carries a wider budget and is where any
-	 * unavoidable truncation belongs.
-	 */
-	fitted: boolean;
-}
-
-/**
- * Format the inputs as a compact `k=v  ·  k=v  ·  +N more` segment that
- * fits in `budget` visible cells. Returns null when the inputs map is
- * empty.
- *
- * Truncation policy:
- *  - First {@link INLINE_INPUT_LIMIT} entries inline; the remainder
- *    collapsed to `+N more`.
- *  - String values are quoted; long values truncate inside the quotes,
- *    keeping the closing `"`.
- *  - Objects / arrays render as a compact JSON projection clamped to
- *    the same per-pair `valueBudget` derived below.
- *  - If the styled segment would still exceed `budget`, fall back to a
- *    single end-truncated `k=v, k=v, …` line — the same degraded shape
- *    the legacy `inputsRow` emitted, but without the `inputs` column
- *    label.
- */
-function renderInputsSegment(
-	inputs: Readonly<WorkflowInputValues>,
-	budget: number,
-	theme?: GraphTheme,
-): InputsSegment | null {
-	const entries = Object.entries(inputs);
-	if (entries.length === 0) return null;
-
-	const text = theme ? hexToAnsi(theme.text) : "";
-	const faint = theme ? hexToAnsi(theme.dim) : "";
-	const dim = faint;
-	const reset = theme ? RESET : "";
-
-	const visible = entries.slice(0, INLINE_INPUT_LIMIT);
-	const overflow = entries.length - visible.length;
-	const numPairs = visible.length;
-
-	// Per-pair `valueBudget` allocation. The legacy heuristic (`width *
-	// 0.5` regardless of pair count) would let any single value claim
-	// more than the whole row, dragging the styled `k=v · k=v · +N more`
-	// form through the comma-truncated fallback whenever ≥2 pairs had
-	// non-trivial values.
-	//
-	// Instead, subtract the fixed cost of the row (keys + `=`, separators,
-	// overflow marker) and split the remainder evenly across the visible
-	// pairs, with a floor so any single value still renders something
-	// meaningful.
-	const SEP_W = 5; // visible width of "  ·  "
-	const overflowText = overflow > 0 ? `+${overflow} more` : "";
-	const overflowCost = overflow > 0 ? SEP_W + overflowText.length : 0;
-	const keysCost = visible.reduce((sum, [k]) => sum + k.length + 1, 0);
-	const sepCost = Math.max(0, numPairs - 1) * SEP_W;
-	const fixedCost = keysCost + sepCost + overflowCost;
-	const availableForValues = Math.max(0, budget - fixedCost);
-	const valueBudget = Math.max(10, Math.floor(availableForValues / Math.max(numPairs, 1)));
-
-	// Render every visible value once; reuse the result for both the
-	// styled output and the visible-width measurement.
-	const renderedValues = visible.map(([, v]) => renderInputValue(v, valueBudget));
-	const renderedSegs = visible.map(([k], i) => {
-		const v = renderedValues[i];
-		if (!theme) return `${k}=${v}`;
-		return `${text}${k}${reset}${faint}=${reset}${text}${v}${reset}`;
-	});
-	const segWidths = visible.map(([k], i) => k.length + 1 + visibleWidth(renderedValues[i] ?? ""));
-
-	const sep = theme ? `  ${faint}·${reset}  ` : "  ·  ";
-
-	let rendered = renderedSegs.join(sep);
-	let totalW = segWidths.reduce((a, b) => a + b, 0) + Math.max(0, visible.length - 1) * SEP_W;
-
-	if (overflow > 0) {
-		const moreText = `+${overflow} more`;
-		rendered += theme ? `${sep}${dim}${moreText}${reset}` : `${sep}${moreText}`;
-		totalW += SEP_W + moreText.length;
-	}
-
-	if (totalW <= budget) {
-		return { rendered, visibleWidth: totalW, fitted: true };
-	}
-
-	// Overflow fallback — drop per-pair ANSI, emit an end-truncated plain
-	// join. Matches the legacy `inputsRow` degraded path, minus the
-	// `inputs` column label. Body-row callers tolerate this; the inline
-	// suffix path rejects it via `fitted === false` and falls through to
-	// the body-row layout instead.
-	const flat = entries.map(([k, v]) => `${k}=${renderInputValue(v, valueBudget)}`).join(", ");
-	const cut = truncateToWidth(flat, Math.max(8, budget), ELLIPSIS);
-	if (!theme) return { rendered: cut, visibleWidth: visibleWidth(cut), fitted: false };
-	return {
-		rendered: `${text}${cut}${reset}`,
-		visibleWidth: visibleWidth(cut),
-		fitted: false,
-	};
-}
-
-/**
- * Anything that would break a value out of its single card row.
- *
- * Card rows are spliced into a bordered box by `renderRoundedBox`, which pads
- * each row to the interior width. A value carrying a literal newline emits a
- * second physical line that no border ever wraps, destroying the box from that
- * row down. `truncateToWidth` cannot save us: it measures *visible width*, and
- * a control character has none, so a `\n` survives truncation intact.
- *
- * This is reachable from ordinary use — any multi-line workflow input (a
- * `prompt`, an `acceptance_criteria` block) contains newlines by nature.
- *
- * Scoped to `\p{Cc}` (C0/C1 controls, so `\n`, `\r`, `\t`, and a stray ESC that
- * would otherwise inject styling) plus the two separators `JSON.stringify` does
- * *not* escape, which some terminals still break lines on. It deliberately does
- * NOT cover all of `\p{Cf}`: that class includes U+200D ZERO WIDTH JOINER, and
- * stripping it splits emoji sequences such as a family glyph into their
- * components. A format character that occupies no cell cannot break a row, so
- * removing it only corrupts the value the user asked to see.
- */
-const ROW_BREAKING_RE = /[\p{Cc}\u2028\u2029]+/gu;
-
-/**
- * Replace runs of row-breaking characters with a single space.
- *
- * Only the replaced runs collapse. Pre-existing spacing is left alone and the
- * result is not trimmed, because a value's own leading, trailing, or repeated
- * spaces are content: the card renders inside quotes, so `"  alpha   beta  "`
- * should still read as what was passed rather than as `"alpha beta"`.
- */
-function toSingleLine(value: string): string {
-	return value.replace(ROW_BREAKING_RE, " ");
-}
-
-function renderInputValue(value: unknown, budget: number): string {
-	if (typeof value === "string") {
-		// Reserve 2 cells for the surrounding quotes; truncate the interior.
-		const interior = Math.max(0, budget - 2);
-		const trimmed = truncateToWidth(toSingleLine(value), interior, ELLIPSIS);
-		return `"${trimmed}"`;
-	}
-	if (typeof value === "number" || typeof value === "boolean") {
-		return String(value);
-	}
-	if (value === null) return "null";
-	// Objects / arrays — show a compact JSON projection within budget.
-	// JSON.stringify escapes \n as literal backslash-n, but not U+2028/U+2029.
-	const json = JSON.stringify(value);
-	return truncateToWidth(toSingleLine(json ?? ""), budget, ELLIPSIS);
-}
-
-/**
- * Resolve the render width for the dispatch surface. Delegates to the
- * shared `chatWidth()` helper which already accounts for the chat host's
- * 2-cell horizontal padding when no explicit width is supplied.
- */
-function effectiveWidth(width?: number): number {
-	return chatWidth(width);
-}

package/dist/builtin/workflows/src/tui/edge.ts

@@ -1,25 +0,0 @@
-/**
- * String-rendering helper for a connector edge between nodes.
- *
- * Edges are rendered in the dim border role so they recede behind the
- * status-coloured node cards (DESIGN.md "Status-Is-Truth" — saturated
- * colour belongs to nodes, not connectors).
- */
-
-import { hexToAnsi, RESET } from "./color-utils.js";
-import { buildConnector } from "./connectors.js";
-import type { GraphTheme } from "./graph-theme.js";
-import type { LayoutNode } from "./layout.js";
-import { NODE_W } from "./layout.js";
-
-export interface EdgeOpts {
-	theme: GraphTheme;
-}
-
-export function renderEdge(from: LayoutNode, to: LayoutNode, opts: EdgeOpts): string[] {
-	const ec = hexToAnsi(opts.theme.borderDim);
-	const fromX = from.x + NODE_W;
-	const toX = to.x;
-	const result = buildConnector(fromX, toX);
-	return result.lines.map((l) => `${ec}${l.chars}${RESET}`);
-}

package/dist/builtin/workflows/src/tui/graph-canvas.ts

@@ -1,185 +0,0 @@
-/**
- * Sparse character grid used to compose the DAG canvas: edges (low z)
- * are plotted first, then node cards (high z) overwrite the cells they
- * occupy. The final {@link toLines} call materialises the buffer as
- * ANSI-styled strings keyed off each cell's foreground colour.
- *
- * Why not just draw into raw strings? Edges turn corners through the
- * gaps between cards, so we need column-accurate plotting. A sparse map
- * keeps the buffer cheap for wide-but-mostly-empty graph canvases.
- *
- * cross-ref:
- *   - github.com/bastani-inc/atomic packages/atomic-sdk/src/components/connectors.ts
- *   - src/tui/graph-view.ts  _renderGraph
- */
-
-import { hexToAnsi, RESET } from "./color-utils.js";
-
-interface Cell {
-	ch: string;
-	/** Hex foreground colour, or null for "use default fg" (no ANSI fg set). */
-	fg: string | null;
-}
-
-type Dir = "u" | "d" | "l" | "r";
-
-function dirsForGlyph(ch: string): Set<Dir> {
-	switch (ch) {
-		case "│":
-			return new Set(["u", "d"]);
-		case "─":
-			return new Set(["l", "r"]);
-		case "╭":
-			return new Set(["d", "r"]);
-		case "╮":
-			return new Set(["d", "l"]);
-		case "╰":
-			return new Set(["u", "r"]);
-		case "╯":
-			return new Set(["u", "l"]);
-		case "├":
-			return new Set(["u", "d", "r"]);
-		case "┤":
-			return new Set(["u", "d", "l"]);
-		case "┬":
-			return new Set(["d", "l", "r"]);
-		case "┴":
-			return new Set(["u", "l", "r"]);
-		case "┼":
-			return new Set(["u", "d", "l", "r"]);
-		default:
-			return new Set();
-	}
-}
-
-function glyphForDirs(dirs: Set<Dir>): string {
-	const has = (...want: Dir[]) => want.every((d) => dirs.has(d));
-	if (has("u", "d", "l", "r")) return "┼";
-	if (has("u", "d", "r")) return "├";
-	if (has("u", "d", "l")) return "┤";
-	if (has("d", "l", "r")) return "┬";
-	if (has("u", "l", "r")) return "┴";
-	if (has("u", "d")) return "│";
-	if (has("l", "r")) return "─";
-	if (has("d", "r")) return "╭";
-	if (has("d", "l")) return "╮";
-	if (has("u", "r")) return "╰";
-	if (has("u", "l")) return "╯";
-	if (has("u") || has("d")) return "│";
-	if (has("l") || has("r")) return "─";
-	return " ";
-}
-
-export interface GraphCanvasBounds {
-	top: number;
-	bottom: number;
-	left: number;
-	right: number;
-}
-
-export class GraphCanvas {
-	private rows: Map<number, Map<number, Cell>> = new Map();
-	private maxRow = -1;
-	private maxCol = -1;
-
-	constructor(private readonly bounds?: GraphCanvasBounds) {}
-	setCell(row: number, col: number, ch: string, fg: string | null): void {
-		if (row < 0 || col < 0) return;
-		if (
-			this.bounds &&
-			(row < this.bounds.top || row >= this.bounds.bottom || col < this.bounds.left || col >= this.bounds.right)
-		) {
-			return;
-		}
-		let cols = this.rows.get(row);
-		if (!cols) {
-			cols = new Map();
-			this.rows.set(row, cols);
-		}
-		cols.set(col, { ch, fg });
-		if (row > this.maxRow) this.maxRow = row;
-		if (col > this.maxCol) this.maxCol = col;
-	}
-
-	getCell(row: number, col: number): string | null {
-		return this.rows.get(row)?.get(col)?.ch ?? null;
-	}
-
-	mergeCell(row: number, col: number, dirs: readonly Dir[], fg: string | null): void {
-		if (row < 0 || col < 0) return;
-		const existing = this.getCell(row, col);
-		const merged = new Set<Dir>([...(existing == null ? [] : dirsForGlyph(existing)), ...dirs]);
-		this.setCell(row, col, glyphForDirs(merged), fg);
-	}
-
-	/**
-	 * Paint a single character cell, but only if the target cell is empty.
-	 * Used by the edge plotter so a corner glyph never clobbers a node-card
-	 * border that has already been placed at the same coordinate.
-	 */
-	setCellIfEmpty(row: number, col: number, ch: string, fg: string | null): void {
-		const cols = this.rows.get(row);
-		if (cols?.has(col)) return;
-		this.setCell(row, col, ch, fg);
-	}
-
-	/**
-	 * Place a horizontal `─` run from `(row, fromCol)` to `(row, toCol)`
-	 * inclusive, recolouring each cell with `fg`. Pass `endChar` to use a
-	 * different glyph at the final column (e.g. `>`-style arrowhead).
-	 */
-	hline(row: number, fromCol: number, toCol: number, fg: string | null): void {
-		if (this.bounds && (row < this.bounds.top || row >= this.bounds.bottom)) return;
-		const lo = Math.max(Math.min(fromCol, toCol), this.bounds?.left ?? 0);
-		const hi = Math.min(Math.max(fromCol, toCol), (this.bounds?.right ?? Number.POSITIVE_INFINITY) - 1);
-		for (let c = lo; c <= hi; c++) this.mergeCell(row, c, ["l", "r"], fg);
-	}
-
-	vline(col: number, fromRow: number, toRow: number, fg: string | null): void {
-		if (this.bounds && (col < this.bounds.left || col >= this.bounds.right)) return;
-		const lo = Math.max(Math.min(fromRow, toRow), this.bounds?.top ?? 0);
-		const hi = Math.min(Math.max(fromRow, toRow), (this.bounds?.bottom ?? Number.POSITIVE_INFINITY) - 1);
-		for (let r = lo; r <= hi; r++) this.mergeCell(r, col, ["u", "d"], fg);
-	}
-
-	/** Materialise the canvas as one ANSI-styled string per row. */
-	toLines(): string[] {
-		const top = this.bounds?.top ?? 0;
-		const bottom = this.bounds?.bottom ?? this.maxRow + 1;
-		const left = this.bounds?.left ?? 0;
-		if (bottom <= top) return [];
-		const lines: string[] = [];
-		for (let r = top; r < bottom; r++) {
-			const cols = this.rows.get(r);
-			if (!cols || cols.size === 0) {
-				lines.push("");
-				continue;
-			}
-			let buf = "";
-			let cursorCol = left;
-			let activeFg: string | null = null;
-			const sortedCols = Array.from(cols.keys()).sort((a, b) => a - b);
-			for (const c of sortedCols) {
-				if (c > cursorCol) {
-					if (activeFg !== null) {
-						buf += RESET;
-						activeFg = null;
-					}
-					buf += " ".repeat(c - cursorCol);
-					cursorCol = c;
-				}
-				const cell = cols.get(c)!;
-				if (cell.fg !== activeFg) {
-					if (activeFg !== null) buf += RESET;
-					if (cell.fg !== null) buf += hexToAnsi(cell.fg);
-					activeFg = cell.fg;
-				}
-				buf += cell.ch;
-				cursorCol += 1;
-			}
-			if (activeFg !== null) buf += RESET;
-			lines.push(buf);
-		}
-		return lines;
-	}
-}