archymedes-cli 2.1.0 → 2.3.0

package/README.md

@@ -309,3 +309,28 @@ TUI dependency resolution. The reviewed archive and SHA256 checksum are written
 See [the release assessment](https://github.com/chrisnkuno/archymedes-cli/blob/main/docs/RELEASE_ASSESSMENT.md) for scope and remaining release proof.
 
 The startup geometry makes a brief rotation on roomy interactive terminals. Set `ARCHYMEDES_NO_MOTION=1` to keep it still. Preview it with `bun run preview:tui archymedes --animate`.
+
+## Fixed workspace
+
+Interactive sessions open in the fixed workspace: a persistent mode bar, an anchored composer, and
+menus that open inside the transcript area. `/layout` switches layouts during a session;
+`archymedes --layout scrollback` or `ARCHYMEDES_LAYOUT=scrollback` keeps the plain terminal log.
+
+Use `/mode` to choose plan, build, auto, or defender with the arrow keys. To read history, use the
+mouse wheel or Page Up / Page Down. Alt+Up / Alt+Down (or Ctrl) move one line, and Ctrl+Home jumps
+to the top. Escape, Ctrl+End, or scrolling back to the bottom returns to live output. History keeps
+its colours, a scrollbar shows your position, and the header counts output that arrived while you
+were reading. Arrow keys, Home and End still edit the composer. Wheel scrolling uses mouse
+reporting, so hold Shift to select text, or set `ARCHYMEDES_MOUSE=0` to keep the terminal's own
+selection. Each tab retains up to 5,000 output lines, and resizing reflows the transcript.
+
+`/find <text>` searches the tab's history and jumps to the first match; `/find` again moves to the
+next one, `/find prev` to the previous, and `/find off` or Escape returns to live output. `/pager`
+opens the whole transcript in `$PAGER` (`less -R` by default). `/cat image.png` draws a PNG in the
+transcript with coloured half-blocks; in the scrollback layout, `ARCHYMEDES_IMAGES=kitty` uses Kitty
+graphics for real pixels, and `/clear` removes them.
+
+The opening geometry rotates while the workspace is idle and settles as soon as you type.
+`ARCHYMEDES_NO_MOTION=1` disables this motion and menu focus animation. `--ascii`, `NO_COLOR`,
+and the existing themes remain supported. Try the real interface offline from the repository
+with `bun run preview:workspace`; the preview uses a temporary project and a local model fixture.

package/dist/{archymedes-brkqgrxv.mjs → archymedes-4kx65anz.mjs}

@@ -1,11 +1,14 @@
 import {
   SpringAnimator,
+  paginator
+} from "./archymedes-g8y3rt6t.mjs";
+import {
   UNICODE_GLYPHS,
-  paginator,
+  clipTo,
   visibleWidth
-} from "./archymedes-dwvn4c51.mjs";
+} from "./archymedes-a10k8yrk.mjs";
 
-// packages/archymedes-cli/src/chooser.ts
+// src/ui/chooser.ts
 var ALL_CHROME = { title: true, status: true, pagination: true, help: true };
 function chromeOf(chrome) {
   return { ...ALL_CHROME, ...chrome };
@@ -129,7 +132,11 @@ function renderChooser(state, items, options) {
     const shownLabel = clip(item.label, labelBudget);
     const padded = shownLabel + " ".repeat(Math.max(0, labelBudget - visibleWidth(shownLabel)));
     const marker = active ? paint.green(glyphs.prompt) : fadingOut ? paint.dim(glyphs.prompt) : " ";
-    const head = `${marker} ${paint.dim(number)} ${padded}  `;
+    const focus = Math.max(0, Math.min(1, options.focusProgress ?? 1));
+    const graphemes = [...new Intl.Segmenter(undefined, { granularity: "grapheme" }).segment(padded)].map((part) => part.segment);
+    const illuminated = Math.round(graphemes.length * focus);
+    const label = active ? paint.cyan(graphemes.slice(0, illuminated).join("")) + graphemes.slice(illuminated).join("") : padded;
+    const head = `${marker} ${paint.dim(number)} ${label}  `;
     const tail = `${item.hint ? ` ${item.hint}` : ""}${item.description ? `  ${item.description}` : ""}`;
     lines.push(`  ${head}${paint.dim(clip(tail, Math.max(0, room - visibleWidth(padded) - 2)))}`);
   }
@@ -144,22 +151,6 @@ function renderChooser(state, items, options) {
   return lines.join(`
 `);
 }
-function clipTo(text, width, glyphs = UNICODE_GLYPHS) {
-  if (width <= 0)
-    return "";
-  if (visibleWidth(text) <= width)
-    return text;
-  const mark = visibleWidth(glyphs.ellipsis) < width ? glyphs.ellipsis : "";
-  const budget = width - visibleWidth(mark);
-  let out = "";
-  const segments = typeof Intl.Segmenter === "function" ? [...new Intl.Segmenter(undefined, { granularity: "grapheme" }).segment(text)].map((entry) => entry.segment) : [...text];
-  for (const segment of segments) {
-    if (visibleWidth(out + segment) > budget)
-      break;
-    out += segment;
-  }
-  return `${out}${mark}`;
-}
 async function runChooser(keys, items, paint, options) {
   let state = { selected: Math.max(0, Math.min(options.initialIndex ?? 0, Math.max(0, items.length - 1))), query: "" };
   const liveOptions = () => {
@@ -173,40 +164,46 @@ async function runChooser(keys, items, paint, options) {
     glide?.stop();
     glide = undefined;
   };
-  for await (const input of keys) {
-    const current = liveOptions();
-    const previousSelected = state.selected;
-    const step = advanceChooser(state, items, input, {
-      filter: options.filter ?? false,
-      page: options.page ?? current.height ?? 8,
-      ...current.height === undefined ? {} : { height: current.height }
-    });
-    state = step.state;
-    if (step.done) {
+  try {
+    for await (const input of keys) {
+      const current = liveOptions();
+      const previousSelected = state.selected;
+      const step = advanceChooser(state, items, input, {
+        filter: options.filter ?? false,
+        page: options.page ?? current.height ?? 8,
+        ...current.height === undefined ? {} : { height: current.height }
+      });
+      state = step.state;
+      if (step.done) {
+        settleGlide();
+        if (step.done.index === undefined)
+          return;
+        return filterItems(items, state.query)[step.done.index]?.value;
+      }
       settleGlide();
-      if (step.done.index === undefined)
-        return;
-      return filterItems(items, state.query)[step.done.index]?.value;
+      const isSingleStep = (input.key.name === "up" || input.key.name === "down") && Math.abs(state.selected - previousSelected) === 1;
+      const motion = options.motion ?? (process.env.ARCHYMEDES_NO_MOTION !== "1" && process.env.NO_COLOR === undefined && process.env.TERM !== "dumb");
+      if (!motion || !isSingleStep || previousSelected === state.selected) {
+        paint(renderChooser(state, items, liveOptions()));
+        continue;
+      }
+      paint(renderChooser(state, items, { ...liveOptions(), transitionFrom: previousSelected, focusProgress: 0 }));
+      const animator = new SpringAnimator(0, (value) => {
+        if (value < 0.95) {
+          paint(renderChooser(state, items, { ...liveOptions(), transitionFrom: value < 0.5 ? previousSelected : undefined, focusProgress: value }));
+          return;
+        }
+        animator.stop();
+        glide = undefined;
+        paint(renderChooser(state, items, liveOptions()));
+      }, { intervalMs: 30 });
+      glide = animator;
+      animator.retarget(1);
     }
+  } finally {
     settleGlide();
-    const isSingleStep = (input.key.name === "up" || input.key.name === "down") && Math.abs(state.selected - previousSelected) === 1;
-    if (!isSingleStep || previousSelected === state.selected) {
-      paint(renderChooser(state, items, liveOptions()));
-      continue;
-    }
-    paint(renderChooser(state, items, { ...liveOptions(), transitionFrom: previousSelected }));
-    const animator = new SpringAnimator(0, (value) => {
-      if (value < 0.6)
-        return;
-      animator.stop();
-      glide = undefined;
-      paint(renderChooser(state, items, liveOptions()));
-    }, { intervalMs: 30 });
-    glide = animator;
-    animator.retarget(1);
   }
-  settleGlide();
   return;
 }
 
-export { INITIAL_CHOOSER_STATE, windowStart, terminalColumns, renderChooser, clipTo, runChooser };
+export { INITIAL_CHOOSER_STATE, filterItems, windowStart, terminalColumns, renderChooser, runChooser };

package/dist/{archymedes-jecyxv5c.mjs → archymedes-a10k8yrk.mjs}

@@ -1,4 +1,4 @@
-// packages/archymedes-cli/src/theme.ts
+// src/theme/theme.ts
 var BLUEPRINT = `
 /* Blueprint navy, chalk-white ink and an amber pencil — the original drafting table. */
 @theme blueprint {
@@ -89,12 +89,31 @@ var ARCHYMEDES = `
     --border-focus: #e7bb78;
 }
 `;
+var RAINBOW = `
+/* Every hue at once — the opening art and the thinking spinner sweep the full spectrum. */
+@theme rainbow {
+    --primary: #ff5f5f;
+    --secondary: #5fd7ff;
+    --accent: #ffd75f;
+    --bg: #0c0c0c;
+    --surface: #161616;
+    --text: #f2f2f2;
+    --text-muted: #9a9a9a;
+    --success: #5fff87;
+    --warning: #ffaf5f;
+    --error: #ff3b3b;
+    --border: double;
+    --border-color: #8a8a8a;
+    --border-focus: #d75fff;
+}
+`;
 var BUILTIN_THEME_SOURCES = {
   archymedes: ARCHYMEDES,
   blueprint: BLUEPRINT,
   parchment: PARCHMENT,
   chalkboard: CHALKBOARD,
-  "high-contrast": HIGH_CONTRAST
+  "high-contrast": HIGH_CONTRAST,
+  rainbow: RAINBOW
 };
 var DEFAULT_THEME_NAME = "archymedes";
 var NAMED_COLORS = {
@@ -163,6 +182,39 @@ function colorCode(value, depth) {
     return parsed < 8 ? `\x1B[${30 + parsed}m` : `\x1B[${90 + parsed - 8}m`;
   return depth === "truecolor" ? `\x1B[38;2;${parsed.r};${parsed.g};${parsed.b}m` : `\x1B[38;5;${rgbTo256(parsed)}m`;
 }
+function rainbowHex(t) {
+  const hue = (t % 1 + 1) % 1 * 360;
+  const c = 0.5;
+  const x = c * (1 - Math.abs(hue / 60 % 2 - 1));
+  const m = 0.6 - c / 2;
+  const [r1, g1, b1] = hue < 60 ? [c, x, 0] : hue < 120 ? [x, c, 0] : hue < 180 ? [0, c, x] : hue < 240 ? [0, x, c] : hue < 300 ? [x, 0, c] : [c, 0, x];
+  const channel = (value) => Math.round((value + m) * 255).toString(16).padStart(2, "0");
+  return `#${channel(r1)}${channel(g1)}${channel(b1)}`;
+}
+function rainbowText(text, depth, phase = 0) {
+  if (depth === "none")
+    return text;
+  const characters = [...text];
+  let out = "";
+  let open;
+  characters.forEach((character, index) => {
+    if (character === " ") {
+      if (open !== undefined) {
+        out += "\x1B[0m";
+        open = undefined;
+      }
+      out += character;
+      return;
+    }
+    const code = colorCode(rainbowHex(phase + index / 12), depth);
+    if (code !== open) {
+      out += code;
+      open = code;
+    }
+    out += character;
+  });
+  return open === undefined ? out : `${out}\x1B[0m`;
+}
 var DEFAULT_TOKENS = {
   primary: "cyan",
   secondary: "blue",
@@ -244,6 +296,169 @@ function buildPalette(theme, depth) {
     tokens: theme.tokens
   };
 }
+var EXTERNAL_MARK = "\x1B[35m";
+var ANSI_PALETTE = buildPalette({ name: "ansi", description: "", tokens: DEFAULT_TOKENS }, "ansi256");
+function roleCode(role, palette, depth) {
+  if (depth === "none")
+    return "";
+  return palette?.[role] || ANSI_PALETTE[role];
+}
 var NO_COLOR_PALETTE = buildPalette(findBuiltinTheme(DEFAULT_THEME_NAME) ?? { name: DEFAULT_THEME_NAME, description: "", tokens: DEFAULT_TOKENS }, "none");
 
-export { BUILTIN_THEME_SOURCES, rgbTo256, parseThemeSource, NO_COLOR_PALETTE };
+// src/text/ansi.ts
+var RESET = "\x1B[0m";
+var BOLD = "\x1B[1m";
+var DIM = "\x1B[2m";
+var ITALIC = "\x1B[3m";
+var STRIKE = "\x1B[9m";
+var REVERSE = "\x1B[7m";
+function paint(text, code, depth) {
+  return depth === "none" || code === "" ? text : `${code}${text}${RESET}`;
+}
+function paintAll(text, codes, depth) {
+  return depth === "none" || codes.length === 0 ? text : `${codes.join("")}${text}${RESET}`;
+}
+
+// src/text/glyphs.ts
+var UNICODE_GLYPHS = {
+  starGlyphs: [".", "·", "✧", "✦", "✶"],
+  spinnerFrames: ["  ◜  ", "  ◠  ", "  ◝  ", "  ◞  ", "  ◡  ", "  ◟  "],
+  star: "✦",
+  starDim: "✧",
+  check: "✓",
+  cross: "✗",
+  pending: "⋯",
+  prompt: "❯",
+  caret: "›",
+  bullet: "•",
+  ellipsis: "…",
+  middot: "·",
+  elbow: "⎿",
+  boxTopLeft: "╭",
+  boxTopRight: "╮",
+  boxBottomLeft: "╰",
+  boxBottomRight: "╯",
+  boxHorizontal: "─",
+  boxVertical: "│",
+  boxTeeLeft: "├",
+  boxTeeRight: "┤",
+  boxCross: "┼",
+  circleEmpty: "○",
+  circleHalf: "◐",
+  circleFull: "●",
+  checkbox: "☐",
+  checkboxDone: "☑",
+  paused: "⏸",
+  cancelled: "⊘",
+  treeBranch: "├─",
+  treeLast: "╰─",
+  treeTrunk: "│ ",
+  collapsed: "▸",
+  expanded: "▾",
+  arrowUp: "↑",
+  arrowLeft: "←",
+  arrowRight: "→",
+  arrowDown: "↓",
+  plus: "+",
+  minus: "-",
+  warning: "!",
+  effectWorkspace: "✎",
+  effectExternal: "◎",
+  sparkLevels: ["▁", "▂", "▃", "▄", "▅", "▆", "▇", "█"]
+};
+var ASCII_GLYPHS = {
+  starGlyphs: [".", ".", "+", "*", "*"],
+  spinnerFrames: ["-", "\\", "|", "/"],
+  star: "*",
+  starDim: "+",
+  check: "+",
+  cross: "x",
+  pending: "~",
+  prompt: ">",
+  caret: ">",
+  bullet: "-",
+  ellipsis: "...",
+  middot: "-",
+  elbow: "\\",
+  boxTopLeft: "+",
+  boxTopRight: "+",
+  boxBottomLeft: "+",
+  boxBottomRight: "+",
+  boxHorizontal: "-",
+  boxVertical: "|",
+  boxTeeLeft: "+",
+  boxTeeRight: "+",
+  boxCross: "+",
+  circleEmpty: "o",
+  circleHalf: "*",
+  circleFull: "*",
+  checkbox: "[ ]",
+  checkboxDone: "[x]",
+  paused: "=",
+  cancelled: "x",
+  treeBranch: "|-",
+  treeLast: "`-",
+  treeTrunk: "| ",
+  collapsed: ">",
+  expanded: "v",
+  arrowUp: "^",
+  arrowLeft: "<-",
+  arrowRight: "->",
+  arrowDown: "v",
+  plus: "+",
+  minus: "-",
+  warning: "!",
+  effectWorkspace: "w",
+  effectExternal: "e",
+  sparkLevels: [" ", ".", ":", "-", "=", "+", "*", "#"]
+};
+var ROUND_BORDER = { topLeft: "╭", topRight: "╮", bottomLeft: "╰", bottomRight: "╯", horizontal: "─", vertical: "│", teeLeft: "├", teeRight: "┤", cross: "┼" };
+var SINGLE_BORDER = { topLeft: "┌", topRight: "┐", bottomLeft: "└", bottomRight: "┘", horizontal: "─", vertical: "│", teeLeft: "├", teeRight: "┤", cross: "┼" };
+var DOUBLE_BORDER = { topLeft: "╔", topRight: "╗", bottomLeft: "╚", bottomRight: "╝", horizontal: "═", vertical: "║", teeLeft: "╠", teeRight: "╣", cross: "╬" };
+var ASCII_BORDER = { topLeft: "+", topRight: "+", bottomLeft: "+", bottomRight: "+", horizontal: "-", vertical: "|", teeLeft: "+", teeRight: "+", cross: "+" };
+function borderGlyphsFor(style, glyphs) {
+  if (glyphs === ASCII_GLYPHS)
+    return ASCII_BORDER;
+  if (style === "single")
+    return SINGLE_BORDER;
+  if (style === "double")
+    return DOUBLE_BORDER;
+  return ROUND_BORDER;
+}
+
+// src/text/text-width.ts
+var ANSI = /\x1b\[[0-9;]*m/g;
+var PRINTABLE_ASCII = /^[\x20-\x7e]*$/;
+function visibleWidth(text) {
+  if (PRINTABLE_ASCII.test(text))
+    return text.length;
+  let width = 0;
+  for (const character of text.includes("\x1B") ? text.replace(ANSI, "") : text) {
+    const code = character.codePointAt(0) ?? 0;
+    if (code >= 768 && code <= 879)
+      continue;
+    width += isWide(code) ? 2 : 1;
+  }
+  return width;
+}
+function isWide(code) {
+  return code >= 4352 && code <= 4447 || code >= 11904 && code <= 42191 || code >= 44032 && code <= 55203 || code >= 63744 && code <= 64255 || code >= 65072 && code <= 65135 || code >= 65280 && code <= 65376 || code >= 127744 && code <= 129535;
+}
+function clipTo(text, width, glyphs = UNICODE_GLYPHS) {
+  if (width <= 0)
+    return "";
+  if (visibleWidth(text) <= width)
+    return text;
+  const mark = visibleWidth(glyphs.ellipsis) < width ? glyphs.ellipsis : "";
+  const budget = width - visibleWidth(mark);
+  let out = "";
+  const segments = typeof Intl.Segmenter === "function" ? [...new Intl.Segmenter(undefined, { granularity: "grapheme" }).segment(text)].map((entry) => entry.segment) : [...text];
+  for (const segment of segments) {
+    if (visibleWidth(out + segment) > budget)
+      break;
+    out += segment;
+  }
+  return `${out}${mark}`;
+}
+
+export { RESET, BOLD, DIM, ITALIC, STRIKE, REVERSE, paint, paintAll, UNICODE_GLYPHS, ASCII_GLYPHS, borderGlyphsFor, visibleWidth, clipTo, BUILTIN_THEME_SOURCES, parseColor, rgbTo256, rainbowText, parseThemeSource, EXTERNAL_MARK, ANSI_PALETTE, roleCode, NO_COLOR_PALETTE };