@skein-code/cli 0.3.28 → 0.3.29

package/README.md

@@ -96,7 +96,7 @@ To build, verify, and install a local package artifact from this checkout:
 
 ```bash
 npm run verify:package -- --output-dir artifacts/package
-npm install -g ./artifacts/package/skein-code-cli-0.3.28.tgz
+npm install -g ./artifacts/package/skein-code-cli-0.3.29.tgz
 ```
 
 To install the published package from npm:
@@ -252,7 +252,13 @@ as `accent`, `text`, `muted`, `success`, and `error`. Set
 `SKEIN_GLYPHS=ascii` when a terminal or multiplexer renders Unicode symbols
 inconsistently. `NO_COLOR=1` or `ui.color: false` removes palette colors while
 keeping status symbols and semantic labels intact. `/density compact` and
-`/density comfortable` control vertical rhythm. Skein enables Kitty keyboard
+`/density comfortable` control vertical rhythm. `TERM=dumb` automatically uses
+ASCII, monochrome, reduced-motion, non-incremental output. Set
+`SKEIN_SCREEN_READER=1` (or Ink's `INK_SCREEN_READER=true`) for linear
+screen-reader output with semantic timeline, permission-choice, and input roles;
+this profile applies the same low-motion fallbacks while preserving keyboard
+commands. `SKEIN_REDUCE_MOTION=1` disables activity animation independently.
+Skein enables Kitty keyboard
 enhancements without probing when Kitty, WezTerm, Ghostty, or foot declares
 support; set `SKEIN_KITTY_KEYBOARD=on|off` to override detection.
 
@@ -639,7 +645,16 @@ npm test
 npm run build
 npm run check
 npm run test:pty
+npm run benchmark:terminal-ui
 npm run release:verify
 ```
 
+The PTY suite exercises 20/24/40/80/120 columns, a 40×10 viewport,
+`TERM=dumb`, ASCII/`NO_COLOR`, and screen-reader interaction. It replays raw
+output in a headless terminal and checks the final visible frame for overflow,
+stale panels, control-sequence leaks, and missing ready/permission/error state.
+`benchmark:terminal-ui` is a local single-process regression gate with p95
+budgets of 25 ms for input processing and 150 ms for streaming renders; it is
+not a universal hardware performance claim.
+
 Skein is licensed under MIT.

package/dist/cli.js

@@ -220,7 +220,7 @@ function isSqliteBusy(error) {
 // package.json
 var package_default = {
   name: "@skein-code/cli",
-  version: "0.3.28",
+  version: "0.3.29",
   description: "A context-first, model-agnostic coding agent with an auditable terminal workspace.",
   type: "module",
   license: "MIT",
@@ -236,6 +236,10 @@ var package_default = {
   },
   skein: {
     releaseNotes: [
+      "TERM=dumb and screen-reader sessions now use deterministic ASCII, monochrome, reduced-motion, non-incremental rendering without losing keyboard input",
+      "SKEIN_SCREEN_READER=1 enables Ink accessibility output with semantic timeline, permission, and composer roles plus clean phase boundaries",
+      "PTY release gates now replay eight terminal scenarios through a headless emulator and reject final-frame overflow, stale panels, announcement joins, and missing status",
+      "A local terminal UI benchmark enforces 25 ms input and 150 ms streaming-render p95 budgets while retaining the final streamed chunk",
       "MCP trust and revoke confirmation rendering now has a deterministic cross-platform release regression gate",
       "MCP now follows a no-network search and inspect review before explicit workspace-bound manifest trust and lazy activation",
       "Declarative capability manifests expose redacted source, version, tools, permissions, network, command, path, sensitive-field, process, and completion-evidence effects",
@@ -319,6 +323,7 @@ var package_default = {
     "benchmark:context": "tsx scripts/benchmark-local-index.ts",
     "benchmark:duplication": "tsx scripts/benchmark-duplication.ts",
     "benchmark:token-economy": "tsx scripts/benchmark-token-economy.ts",
+    "benchmark:terminal-ui": "tsx scripts/benchmark-terminal-ui.ts",
     "verify:package": "node scripts/verify-package.mjs",
     "release:verify": "npm run check && npm run verify:package --",
     typecheck: "tsc --noEmit",
@@ -346,6 +351,7 @@ var package_default = {
     "@types/diff": "^8.0.0",
     "@types/node": "^22.19.7",
     "@types/react": "^19.2.7",
+    "@xterm/headless": "^6.0.0",
     tsup: "^8.5.1",
     tsx: "^4.21.0",
     vitest: "^4.0.18"
@@ -14770,6 +14776,20 @@ import { constants as constants5 } from "node:fs";
 import chalk from "chalk";
 
 // src/ui/terminal-capabilities.ts
+function resolveTerminalAccessibility(environment = process.env) {
+  const screenReader = truthy(environment.SKEIN_SCREEN_READER) || environment.INK_SCREEN_READER?.trim().toLowerCase() === "true";
+  const dumb = environment.TERM?.trim().toLowerCase() === "dumb";
+  const reducedMotion = screenReader || dumb || truthy(environment.SKEIN_REDUCE_MOTION);
+  const ascii = screenReader || dumb || environment.SKEIN_GLYPHS === "ascii" || environment.MOSAIC_GLYPHS === "ascii";
+  const color = !screenReader && !dumb && environment.NO_COLOR === void 0;
+  return {
+    screenReader,
+    reducedMotion,
+    ascii,
+    color,
+    incrementalRendering: !screenReader && !dumb
+  };
+}
 function resolveKittyKeyboardConfig(environment = process.env) {
   const override = environment.SKEIN_KITTY_KEYBOARD?.trim().toLowerCase();
   if (override && ["1", "true", "yes", "on", "enabled"].includes(override)) {
@@ -14791,6 +14811,9 @@ function enabledKittyKeyboard() {
 function disabledKittyKeyboard() {
   return { mode: "disabled", flags: ["disambiguateEscapeCodes"] };
 }
+function truthy(value) {
+  return value !== void 0 && ["1", "true", "yes", "on"].includes(value.trim().toLowerCase());
+}
 
 // src/cli/glyphs.ts
 var unicodeGlyphs = {
@@ -16219,7 +16242,7 @@ function Timeline({ items, width = 80, glyphMode = "auto", showToolOutput = fals
   if (!items.length) {
     return /* @__PURE__ */ jsx(Box, { paddingLeft: 2, marginBottom: 1, children: /* @__PURE__ */ jsx(Text, { color: theme.muted, children: "Start with a request, @file, or /help." }) });
   }
-  return /* @__PURE__ */ jsx(Box, { flexDirection: "column", children: items.map((item, index) => {
+  return /* @__PURE__ */ jsx(Box, { flexDirection: "column", "aria-role": "list", children: items.map((item, index) => {
     if (item.kind === "user") {
       return /* @__PURE__ */ jsxs(Box, { marginBottom: compact3 || item.clipped ? 0 : 1, children: [
         /* @__PURE__ */ jsx(Box, { width: 2, children: /* @__PURE__ */ jsx(Text, { bold: true, color: theme.accent, children: glyphs.prompt }) }),
@@ -16690,7 +16713,7 @@ function PermissionCard({ call, category, reason, width = 80, glyphMode = "auto"
     { text: "[Esc]", color: theme.muted }
   ];
   const marker = glyphs.borderStyle === "classic" ? "!" : "\u258E";
-  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginBottom: 1, "aria-role": "radiogroup", children: [
     /* @__PURE__ */ jsx(PermissionLine, { marker, children: /* @__PURE__ */ jsx(Text, { bold: true, color: theme.warning, children: title }) }),
     /* @__PURE__ */ jsx(PermissionLine, { marker, children: /* @__PURE__ */ jsx(Text, { color: theme.muted, children: tool }) }),
     /* @__PURE__ */ jsx(PermissionLine, { marker, children: /* @__PURE__ */ jsx(Text, { color: theme.text, children: summaryLine }) }),
@@ -16753,7 +16776,7 @@ function PromptBar({ busy, value, placeholder, width = 80, mode = "chat", queueC
       ] }),
       /* @__PURE__ */ jsx(Text, { color: theme.text, children: truncateDisplay(safeQueuePreview, queuePreviewWidth) })
     ] }) : null,
-    /* @__PURE__ */ jsxs(Box, { children: [
+    /* @__PURE__ */ jsxs(Box, { "aria-role": "textbox", children: [
       /* @__PURE__ */ jsx(Text, { bold: true, color: shell ? theme.warning : theme.accent, children: shell ? "! " : `${glyphs.prompt} ` }),
       children
     ] }),
@@ -18417,13 +18440,14 @@ function SkeinApp({ runner, config, extensions, initialPrompt, askMode = false,
   const terminalHeight = Math.max(1, rows || 24);
   const horizontalPadding = terminalWidth >= 24 ? 1 : 0;
   const contentWidth = Math.max(1, terminalWidth - horizontalPadding * 2);
-  const glyphMode = process.env.SKEIN_GLYPHS === "ascii" || process.env.MOSAIC_GLYPHS === "ascii" ? "ascii" : "auto";
+  const terminalAccessibility = resolveTerminalAccessibility();
+  const glyphMode = terminalAccessibility.ascii ? "ascii" : "auto";
   const glyphs = resolveGlyphs(glyphMode);
   const separator = ` ${glyphs.separator} `;
   const ellipsis = terminalEllipsis();
   const initialSession = runner.getSession();
   const setupProblem = config.model.provider !== "compatible" && !config.model.apiKey ? `No ${config.model.provider} API key found. Set it and restart: export ${providerApiKeyEnv(config.model.provider)}=<your-key>${separator}then run ${PRODUCT_COMMAND} again. Use ${PRODUCT_COMMAND} doctor to verify, or --model to switch provider.` : config.model.provider === "compatible" && !config.model.baseUrl ? `No model endpoint configured. Set one and restart: export SKEIN_BASE_URL=<endpoint>${separator}or pass --base-url <endpoint>. Run ${PRODUCT_COMMAND} doctor to verify.` : void 0;
-  const colorEnabled = config.ui.color && !process.env.NO_COLOR;
+  const colorEnabled = config.ui.color && terminalAccessibility.color;
   const [theme, setTheme] = useState2(() => resolveThemeWithColor(config.ui.theme, colorEnabled));
   const [themeCatalogRevision, setThemeCatalogRevision] = useState2(0);
   const [compact3, setCompact] = useState2(config.ui.compact);
@@ -18559,13 +18583,13 @@ function SkeinApp({ runner, config, extensions, initialPrompt, askMode = false,
     setHistorySearch((current) => current ? setHistorySearchQuery(current, input2) : current);
   }, [input2]);
   useEffect2(() => {
-    if (!busy || reducedMotion()) {
+    if (!busy || terminalAccessibility.reducedMotion) {
       setFrameIndex(0);
       return void 0;
     }
     const timer = setInterval(() => setFrameIndex((value) => (value + 1) % spinnerFrames().length), 120);
     return () => clearInterval(timer);
-  }, [busy]);
+  }, [busy, terminalAccessibility.reducedMotion]);
   const requestPermission = useCallback((call, category, reason) => {
     return new Promise((resolve28) => setPermission({
       call,
@@ -20004,14 +20028,17 @@ function permissionPosture(config) {
 }
 async function runInteractiveTui(options) {
   await reloadUserThemes();
+  const terminalAccessibility = resolveTerminalAccessibility();
   const instance = render2(/* @__PURE__ */ jsx3(SkeinApp, { ...options }), {
     exitOnCtrlC: false,
     patchConsole: true,
-    incrementalRendering: true,
+    incrementalRendering: terminalAccessibility.incrementalRendering,
+    isScreenReaderEnabled: terminalAccessibility.screenReader,
     maxFps: 30,
     kittyKeyboard: resolveKittyKeyboardConfig()
   });
   await instance.waitUntilExit();
+  if (terminalAccessibility.screenReader) process.stdout.write("\n");
 }
 function initialTimeline(session, banner, setupProblem) {
   const items = session.messages.filter((message2) => (message2.role === "user" || message2.role === "assistant") && visibleMessage(message2)).slice(-20).map((message2) => ({ id: message2.id, kind: message2.role, text: message2.content }));
@@ -20201,12 +20228,9 @@ function toolDetail2(call) {
   return keys.slice(0, 3).join(", ");
 }
 function spinnerFrames() {
-  const ascii = process.env.SKEIN_GLYPHS === "ascii" || process.env.MOSAIC_GLYPHS === "ascii";
+  const ascii = resolveTerminalAccessibility().ascii;
   return ascii ? [".", "o", "O", "o"] : ["\u25CC", "\u25CD", "\u25CE", "\u25C9", "\u25CE", "\u25CD"];
 }
-function reducedMotion() {
-  return process.env.SKEIN_REDUCE_MOTION === "1" || process.env.SKEIN_REDUCE_MOTION === "true" || process.env.INK_SCREEN_READER === "true" || process.env.TERM === "dumb";
-}
 
 // src/ui/workspace-preparation.tsx
 import { useEffect as useEffect3, useRef as useRef3, useState as useState3 } from "react";
@@ -20229,10 +20253,11 @@ function WorkspacePreparationView({
 }) {
   const theme = useTheme();
   const safeWidth2 = Math.max(1, Math.floor(width));
-  const innerWidth = Math.max(1, safeWidth2 - (safeWidth2 >= 24 ? 4 : 0));
   const compact3 = safeWidth2 < 48;
   const constrained = height < 14;
-  const ascii = process.env.SKEIN_GLYPHS === "ascii" || process.env.MOSAIC_GLYPHS === "ascii";
+  const horizontalPadding = safeWidth2 >= 24 && !constrained ? 2 : 0;
+  const innerWidth = Math.max(1, safeWidth2 - horizontalPadding * 2);
+  const ascii = resolveTerminalAccessibility().ascii;
   const spinner = (ascii ? [".", "o", "O", "o"] : ["\u25DC", "\u25E0", "\u25DD", "\u25DE", "\u25E1", "\u25DF"])[frame % (ascii ? 4 : 6)];
   const separator = ascii ? "|" : "\xB7";
   const brand = ascii ? "*" : PRODUCT_MARK;
@@ -20242,7 +20267,7 @@ function WorkspacePreparationView({
   const modelLine = `model ${sanitizeTerminalText(model)}`;
   const workspaceLine = `workspace ${compactDisplayPath(sanitizeTerminalText(workspace), Math.max(1, innerWidth - 10))}`;
   const steps = preparationSteps(phase, progress, readiness, error, { ascii, spinner });
-  return /* @__PURE__ */ jsxs4(Box3, { flexDirection: "column", paddingX: safeWidth2 >= 24 ? 2 : 0, children: [
+  return /* @__PURE__ */ jsxs4(Box3, { flexDirection: "column", paddingX: horizontalPadding, children: [
     /* @__PURE__ */ jsxs4(Box3, { children: [
       /* @__PURE__ */ jsxs4(Text4, { bold: true, color: theme.accent, children: [
         brand,
@@ -20260,11 +20285,11 @@ function WorkspacePreparationView({
       /* @__PURE__ */ jsx4(Text4, { color: theme.dim, children: truncateDisplay(modelLine, innerWidth) }),
       /* @__PURE__ */ jsx4(Text4, { color: theme.dim, children: truncateDisplay(workspaceLine, innerWidth) })
     ] }) : /* @__PURE__ */ jsx4(Text4, { color: theme.dim, children: truncateDisplay(workspaceLine, innerWidth) }),
-    /* @__PURE__ */ jsx4(Box3, { marginTop: 1, flexDirection: constrained ? "row" : "column", children: steps.map((step2) => constrained ? /* @__PURE__ */ jsxs4(Text4, { color: step2.state === "active" ? theme.accent : step2.state === "complete" ? theme.success : step2.state === "error" ? theme.error : theme.dim, children: [
+    /* @__PURE__ */ jsx4(Box3, { marginTop: 1, flexDirection: constrained ? "row" : "column", children: steps.map((step2, index) => constrained ? /* @__PURE__ */ jsxs4(Text4, { color: step2.state === "active" ? theme.accent : step2.state === "complete" ? theme.success : step2.state === "error" ? theme.error : theme.dim, children: [
+      index ? " " : "",
       step2.glyph,
       " ",
-      step2.id === "persist" ? "save" : step2.id,
-      step2.id === "verify" ? "" : " "
+      step2.id === "persist" ? "save" : step2.id
     ] }, step2.id) : /* @__PURE__ */ jsxs4(Box3, { height: 1, overflowY: "hidden", children: [
       /* @__PURE__ */ jsxs4(Text4, { bold: true, color: step2.state === "active" ? theme.accent : step2.state === "complete" ? theme.success : step2.state === "error" ? theme.error : theme.border, children: [
         step2.glyph,
@@ -20276,7 +20301,7 @@ function WorkspacePreparationView({
         truncateDisplay(step2.detail, Math.max(1, innerWidth - displayWidth(step2.glyph) - (compact3 ? 12 : 14)))
       ] })
     ] }, step2.id)) }),
-    /* @__PURE__ */ jsxs4(Box3, { marginTop: 1, children: [
+    /* @__PURE__ */ jsxs4(Box3, { marginTop: constrained ? 0 : 1, children: [
       /* @__PURE__ */ jsxs4(Text4, { bold: true, color: error ? theme.error : readiness ? theme.success : theme.accent, children: [
         readiness ? ascii ? "[ok]" : "\u2713" : error ? ascii ? "[x]" : "\xD7" : spinner,
         " "
@@ -20385,7 +20410,8 @@ function WorkspacePreparationApp({
 }
 async function runWorkspacePreparation(engine, config, options = {}) {
   let result;
-  const colorEnabled = config.ui.color && !process.env.NO_COLOR;
+  const terminalAccessibility = resolveTerminalAccessibility();
+  const colorEnabled = config.ui.color && terminalAccessibility.color;
   const theme = resolveThemeWithColor(config.ui.theme, colorEnabled);
   const instance = render3(
     /* @__PURE__ */ jsx4(ThemeProvider, { theme, children: /* @__PURE__ */ jsx4(
@@ -20407,11 +20433,13 @@ async function runWorkspacePreparation(engine, config, options = {}) {
       ...options.stderr ? { stderr: options.stderr } : {},
       exitOnCtrlC: false,
       patchConsole: false,
-      incrementalRendering: true,
+      incrementalRendering: terminalAccessibility.incrementalRendering,
+      isScreenReaderEnabled: terminalAccessibility.screenReader,
       kittyKeyboard: resolveKittyKeyboardConfig()
     }
   );
   await instance.waitUntilExit();
+  if (terminalAccessibility.screenReader) (options.stdout ?? process.stdout).write("\n");
   return result ?? { status: "cancelled" };
 }
 function preparationLabel(phase, progress, readiness, compact3 = false) {
@@ -20758,7 +20786,7 @@ function isLoopbackHostname(hostname) {
   return normalized === "localhost" || normalized.endsWith(".localhost") || normalized === "::1" || /^127(?:\.\d{1,3}){3}$/u.test(normalized);
 }
 function OnboardingApp({ initialConfig, saveConfig, onFinish }) {
-  const colorEnabled = initialConfig.ui.color && !process.env.NO_COLOR;
+  const colorEnabled = initialConfig.ui.color && resolveTerminalAccessibility().color;
   const theme = useMemo2(() => resolveThemeWithColor(initialConfig.ui.theme, colorEnabled), [colorEnabled, initialConfig.ui.theme]);
   return /* @__PURE__ */ jsx5(ThemeProvider, { theme, children: /* @__PURE__ */ jsx5(OnboardingFlow, { initialConfig, saveConfig, onFinish }) });
 }
@@ -20981,6 +21009,7 @@ function providerLabel(provider) {
 }
 async function runFirstRunOnboarding(initialConfig, options = {}) {
   let result;
+  const terminalAccessibility = resolveTerminalAccessibility();
   const instance = render4(
     /* @__PURE__ */ jsx5(
       OnboardingApp,
@@ -20998,11 +21027,13 @@ async function runFirstRunOnboarding(initialConfig, options = {}) {
       ...options.stderr ? { stderr: options.stderr } : {},
       exitOnCtrlC: false,
       patchConsole: false,
-      incrementalRendering: true,
+      incrementalRendering: terminalAccessibility.incrementalRendering,
+      isScreenReaderEnabled: terminalAccessibility.screenReader,
       kittyKeyboard: resolveKittyKeyboardConfig()
     }
   );
   await instance.waitUntilExit();
+  if (terminalAccessibility.screenReader) (options.stdout ?? process.stdout).write("\n");
   return result ?? { status: "cancelled" };
 }