elanous 0.2.9 → 0.2.11

package/scripts/install.ps1

@@ -3,6 +3,7 @@ param(
   [string] $Prefix,
   [string] $Source,
   [switch] $NoModifyPath,
+  [switch] $NoBootstrapBun,
   [switch] $Help,
   [Parameter(ValueFromRemainingArguments = $true)]
   [string[]] $RemainingArgs
@@ -20,8 +21,8 @@ $ErrorActionPreference = 'Stop'
 
 function Show-Usage {
   @'
-Usage: powershell -File scripts/install.ps1 [-Prefix PATH] [-Source PATH.tgz|URL] [-NoModifyPath] [-Help]
-       powershell -File scripts/install.ps1 [--prefix PATH] [--source PATH.tgz|URL] [--no-modify-path] [--help]
+Usage: powershell -File scripts/install.ps1 [-Prefix PATH] [-Source PATH.tgz|URL] [-NoModifyPath] [-NoBootstrapBun] [-Help]
+       powershell -File scripts/install.ps1 [--prefix PATH] [--source PATH.tgz|URL] [--no-modify-path] [--no-bootstrap-bun] [--help]
 
 Install elanous into a versioned layout.
   Prefix / --prefix               installation root (default: $ELANOUS_INSTALL_PREFIX or %LOCALAPPDATA%\elanous)
@@ -29,6 +30,7 @@ Install elanous into a versioned layout.
   Source / --source               install a package tarball (local path or http(s) URL; default: $ELANOUS_INSTALL_SOURCE,
                                   else pack the checkout or fetch the verified release when standalone)
   NoModifyPath / --no-modify-path do not append the elanous PATH block to the PowerShell profile
+  NoBootstrapBun / --no-bootstrap-bun fail instead of installing bun when missing
   Help / --help                   show this help
 '@ | Write-Output
 }
@@ -38,11 +40,15 @@ function Fail([string] $Message, [int] $Code) {
   exit $Code
 }
 
+# PowerShell 5.1 parses BOM-less scripts as ANSI. Keep translated messages ASCII in source and decode at runtime.
+function Say([string] $English, [string] $Korean) {
+  if ($installLang -eq 'ko') { return [regex]::Unescape($Korean) }
+  return $English
+}
+
 function Get-RequiredCommands([string] $InstallerPath) {
-  # install.sh is the single source of the required-command list; a non-checkout run (e.g. `irm ... | iex`) has no
-  # install.sh beside it and falls back to the same two names.
-  $fallbackCommands = 'git', 'bun'
-  if (-not $InstallerPath -or -not (Test-Path -LiteralPath $InstallerPath)) { return $fallbackCommands }
+  # A checkout follows install.sh; standalone release installs need bun but not git.
+  if (-not $InstallerPath -or -not (Test-Path -LiteralPath $InstallerPath)) { return @('bun') }
   $content = Get-Content -LiteralPath $InstallerPath -Raw
   $match = [regex]::Match($content, 'REQUIRED_COMMANDS=\(([^)]*)\)')
   if (-not $match.Success) { Fail "could not read REQUIRED_COMMANDS from $InstallerPath" 1 }
@@ -87,11 +93,14 @@ for ($index = 0; $index -lt $RemainingArgs.Count; $index++) {
       $Source = $RemainingArgs[++$index]
     }
     '--no-modify-path' { $NoModifyPath = $true }
+    '--no-bootstrap-bun' { $NoBootstrapBun = $true }
     default { Fail "unknown argument: $($RemainingArgs[$index])" 2 }
   }
 }
 
 if ($Help) { Show-Usage; exit 0 }
+$installLang = if ($env:ELANOUS_INSTALL_LANG) { $env:ELANOUS_INSTALL_LANG } else { [Globalization.CultureInfo]::CurrentUICulture.Name }
+$installLang = if ($installLang -match '^ko(?:-|$)') { 'ko' } else { 'en' }
 if (-not $Prefix) {
   $dataHome = if ($env:LOCALAPPDATA) { $env:LOCALAPPDATA } else { Join-Path $HOME 'AppData\Local' }
   $Prefix = if ($env:ELANOUS_INSTALL_PREFIX) { $env:ELANOUS_INSTALL_PREFIX } else { Join-Path $dataHome 'elanous' }
@@ -100,15 +109,46 @@ if (-not $Source -and $env:ELANOUS_INSTALL_SOURCE) { $Source = $env:ELANOUS_INST
 
 $scriptDir = if ($PSCommandPath) { Split-Path -Parent $PSCommandPath } else { $null }
 $repoRoot = if ($scriptDir) { [IO.Path]::GetFullPath((Join-Path $scriptDir '..')) } else { $null }
-$requiredCommands = Get-RequiredCommands $(if ($scriptDir) { Join-Path $scriptDir 'install.sh' } else { $null })
+$installerPath = if ($scriptDir) { Join-Path $scriptDir 'install.sh' } else { $null }
+$requiredCommands = Get-RequiredCommands $installerPath
+$missingGit = -not (Get-Command git -ErrorAction SilentlyContinue)
+$bootstrappedBun = $false
+$bunBin = Join-Path $HOME '.bun\bin'
+if (-not (Get-Command bun -ErrorAction SilentlyContinue) -and (Test-Path -LiteralPath (Join-Path $bunBin 'bun.exe') -PathType Leaf)) {
+  $env:PATH = $bunBin + [IO.Path]::PathSeparator + $env:PATH
+}
+# Preserve checkout required-command enforcement, including git, before changing any installation files.
 foreach ($command in $requiredCommands) {
+  if ($command -eq 'bun') { continue }
   if (-not (Get-Command $command -ErrorAction SilentlyContinue)) { Fail "required command missing: $command" 127 }
 }
+if (-not (Get-Command bun -ErrorAction SilentlyContinue)) {
+  $bunCommand = 'irm https://bun.sh/install.ps1 | iex'
+  if ($NoBootstrapBun) { Fail "$(Say 'bun is missing; run:' 'bun \uc774 \uc5c6\uc2b5\ub2c8\ub2e4. \uba3c\uc800 \uc2e4\ud589\ud558\uc138\uc694:') $bunCommand" 127 }
+  # Bun's official install.ps1 resets the session PATH to the user PATH only (System32 and tar vanish) - keep ours.
+  $pathBeforeBun = $env:PATH
+  try {
+    $bootstrapScript = if ($env:ELANOUS_INSTALL_BUN_SCRIPT) {
+      Read-Text $env:ELANOUS_INSTALL_BUN_SCRIPT
+    } else {
+      (Invoke-WebRequest -UseBasicParsing -Uri 'https://bun.sh/install.ps1').Content
+    }
+    if (-not $bootstrapScript) { throw 'empty installer response' }
+    & ([scriptblock]::Create([string]$bootstrapScript))
+    if (-not $?) { throw 'installer returned failure' }
+    if ($LASTEXITCODE -and $LASTEXITCODE -ne 0) { throw "installer exited with code $LASTEXITCODE" }
+  } catch { Fail "$(Say 'bun bootstrap failed:' 'bun \uc124\uce58 \uc2e4\ud328:') $($_.Exception.Message)" 1 }
+  $env:PATH = $bunBin + [IO.Path]::PathSeparator + $pathBeforeBun
+  if (-not (Get-Command bun -ErrorAction SilentlyContinue)) {
+    Fail (Say 'bun bootstrap failed: bun not found after installation' 'bun \uc124\uce58 \uc2e4\ud328: \uc124\uce58 \ub4a4\uc5d0\ub3c4 bun \uc744 \ucc3e\uc744 \uc218 \uc5c6\uc2b5\ub2c8\ub2e4') 1
+  }
+  $bootstrappedBun = $true
+}
 $bunPath = (Get-Command bun).Source
 
 # A standalone installer fetches a verified release; explicit sources and checkouts keep their existing paths.
 $isCheckout = $false
-if ($repoRoot -and (Test-Path -LiteralPath (Join-Path $repoRoot 'package.json'))) {
+if ($installerPath -and (Test-Path -LiteralPath $installerPath) -and $repoRoot -and (Test-Path -LiteralPath (Join-Path $repoRoot 'package.json'))) {
   $isCheckout = (Read-Text (Join-Path $repoRoot 'package.json')) -match '"name":\s*"elanous"'
 }
 $releaseDirectory = $null
@@ -247,7 +287,26 @@ try {
   if (-not $NoModifyPath -and -not (Read-Text $profilePath).Contains($markerStart)) {
     Add-Content -LiteralPath $profilePath -Value ("`r`n$markerStart`r`n$pathLine`r`n$markerEnd")
   }
-  Write-Output "Installed elanous $version at $shimPath"
+  # The default execution policy (Restricted) skips $PROFILE in a new window - the user PATH is what a fresh shell sees.
+  if (-not $NoModifyPath -and -not $env:ELANOUS_INSTALL_NO_USER_PATH) {
+    $binDirectory = Join-Path $Prefix 'bin'
+    $userPath = [Environment]::GetEnvironmentVariable('Path', 'User')
+    $userEntries = @(($userPath -split ';') | Where-Object { $_ })
+    if ($userEntries -notcontains $binDirectory) {
+      [Environment]::SetEnvironmentVariable('Path', (@($binDirectory) + $userEntries) -join ';', 'User')
+    }
+  }
+  $installedMessage = Say 'Installed elanous {0} at {1}' 'elanous {0} \uc744(\ub97c) \uc124\uce58\ud588\uc2b5\ub2c8\ub2e4: {1}'
+  Write-Output ($installedMessage -f $version, $shimPath)
+  $bootstrapped = if ($bootstrappedBun) { 'bun' } else { 'none' }
+  $missing = if ($missingGit -and -not $isCheckout) { 'git(next step)' } else { 'none' }
+  Write-Output "$(Say 'Install summary' '\uc124\uce58 \uc694\uc57d'): bootstrapped: $bootstrapped; missing: $missing"
+  Write-Output (Say 'Next:' '\ub2e4\uc74c:')
+  if (-not $NoModifyPath) { Write-Output (Say '  Open a new PowerShell window to use elanous on PATH.' '  elanous \uc744 PATH \uc5d0\uc11c \uc4f0\ub824\uba74 \uc0c8 PowerShell \ucc3d\uc744 \uc5ec\uc138\uc694.') }
+  else { Write-Output "$(Say '  Run:' '  \uc2e4\ud589:') $shimPath" }
+  if ($missing -ne 'none') {
+    Write-Output "  winget install --id Git.Git -e  # $(Say 'the harness uses git' '\ud558\ub2c8\uc2a4\uac00 git \uc744 \uc0ac\uc6a9\ud569\ub2c8\ub2e4')"
+  }
 } finally {
   Remove-Item -LiteralPath $tempDirectory -Recurse -Force -ErrorAction SilentlyContinue
 }

package/scripts/install.sh

@@ -11,7 +11,7 @@ set -euo pipefail
 
 usage() {
   cat <<'EOF'
-Usage: bash scripts/install.sh [--prefix PATH] [--source PATH.tgz|URL] [--no-modify-path] [--no-bootstrap-bun] [--no-setup] [--yes] [--allow-downgrade] [--help]
+Usage: bash scripts/install.sh [--prefix PATH] [--source PATH.tgz|URL] [--no-modify-path] [--no-bootstrap-bun] [--no-install-deps] [--no-setup] [--yes] [--allow-downgrade] [--help]
        curl -fsSL https://github.com/ElanvitalAI/elanous/releases/latest/download/install.sh | bash
 
 Install elanous without contacting a package registry.
@@ -23,6 +23,7 @@ Install elanous without contacting a package registry.
                       (or set $ELANOUS_INSTALL_SOURCE; without either, fetch the verified latest release)
   --no-modify-path    do not append the elanous PATH block to a shell startup file
   --no-bootstrap-bun  fail instead of installing bun with its official installer when bun is missing
+  --no-install-deps  do not install missing prerequisites with apt even when running as root
   --no-setup          do not start first-time setup in this window after installing (interactive terminals only)
   --yes               do not ask before updating an existing installation
   --allow-downgrade   allow installing a version older than the one already installed
@@ -38,6 +39,7 @@ PREFIX="${ELANOUS_INSTALL_PREFIX:-${XDG_DATA_HOME:-${HOME:?HOME is required}/.lo
 SOURCE="${ELANOUS_INSTALL_SOURCE:-}"
 MODIFY_PATH=1
 BOOTSTRAP_BUN=1
+INSTALL_DEPS=1
 RUN_SETUP=1
 ASSUME_YES=0
 ALLOW_DOWNGRADE=0
@@ -53,6 +55,7 @@ while [ "$#" -gt 0 ]; do
       SOURCE="$2"; shift 2 ;;
     --no-modify-path) MODIFY_PATH=0; shift ;;
     --no-bootstrap-bun) BOOTSTRAP_BUN=0; shift ;;
+    --no-install-deps) INSTALL_DEPS=0; shift ;;
     --no-setup) RUN_SETUP=0; shift ;;
     --yes|-y) ASSUME_YES=1; shift ;;
     --allow-downgrade) ALLOW_DOWNGRADE=1; shift ;;
@@ -91,8 +94,8 @@ if ! command -v bun >/dev/null 2>&1 && [ -x "${BUN_INSTALL:-$HOME/.bun}/bin/bun"
   export PATH="${BUN_INSTALL:-$HOME/.bun}/bin:$PATH"
 fi
 # Match doctor-distro.ts families when a required command is absent; do not source os-release as shell code.
-required_command_hint() {
-  local package="$1" id='' id_like='' version='' key value family='unknown' like
+required_command_family() {
+  local id='' id_like='' version='' key value family='unknown' like
   if [ "$(uname -s)" = 'Darwin' ]; then
     family='darwin'
   elif [ "$(uname -s)" = 'Linux' ] && [ -r "${ELANOUS_INSTALL_OS_RELEASE_FILE:-/etc/os-release}" ]; then
@@ -121,6 +124,12 @@ required_command_hint() {
       fi
     fi
   fi
+  printf '%s' "$family"
+}
+
+required_command_hint() {
+  local package="$1" family
+  family="$(required_command_family)"
   if [ "$package" = 'bun' ] && [ "$family" != 'unknown' ]; then
     echo '   curl -fsSL https://bun.sh/install | bash' >&2
     return
@@ -138,16 +147,33 @@ required_command_hint() {
 SUDO='sudo '
 [ "$(id -u 2>/dev/null)" = 0 ] && SUDO=''
 
-# 빠진 선행 명령을 «한 번에» 모아 한 줄로 댄다.
-# 🩸 09-25 베어 ubuntu:24.04 실측: unzip 으로 멈추고, 깔고 다시 돌리면 git 으로 또 멈췄다(세 판).
-# 패키지 매니저 권한은 사람 몫이라 대신 깔지 않는다. bun 은 여기서 세지 않는다(없으면 아래에서 공식 설치기로 깐다).
-MISSING=()
-if ! command -v bun >/dev/null 2>&1 && [ "$BOOTSTRAP_BUN" -eq 1 ]; then
-  command -v curl >/dev/null 2>&1 || MISSING+=(curl)
-  command -v unzip >/dev/null 2>&1 || MISSING+=(unzip)   # bun 공식 설치기가 쓴다
+# 빠진 선행 명령을 «한 번에» 모아 한 줄로 댄다. bun 은 여기서 세지 않는다(없으면 아래에서 공식 설치기로 깐다).
+missing_prerequisites() {
+  MISSING=()
+  if ! command -v bun >/dev/null 2>&1 && [ "$BOOTSTRAP_BUN" -eq 1 ]; then
+    command -v curl >/dev/null 2>&1 || MISSING+=(curl)
+    command -v unzip >/dev/null 2>&1 || MISSING+=(unzip)   # bun 공식 설치기가 쓴다
+  fi
+  command -v git >/dev/null 2>&1 || MISSING+=(git)
+}
+missing_prerequisites
+INSTALLED_DEPS=''
+DEPS_INSTALL_FAILED=0
+if [ "${#MISSING[@]}" -gt 0 ] && [ "$INSTALL_DEPS" -eq 1 ] && [ "$SUDO" = '' ] &&
+   command -v apt-get >/dev/null 2>&1 && [ "$(required_command_family)" = debian ]; then
+  DEPS_TO_INSTALL=("${MISSING[@]}")
+  # Fresh container images ship with empty package lists — refresh once, then install without prompts.
+  if DEBIAN_FRONTEND=noninteractive apt-get update -qq >&2 &&
+     DEBIAN_FRONTEND=noninteractive apt-get install -y -qq "${DEPS_TO_INSTALL[@]}" >&2; then
+    INSTALLED_DEPS="${DEPS_TO_INSTALL[*]}"
+    echo "installed: $INSTALLED_DEPS" >&2
+    missing_prerequisites
+  else
+    DEPS_INSTALL_FAILED=1
+    echo '⛔ 자동 설치 실패 — 아래를 직접 실행하라 (automatic install failed — run the command below yourself):' >&2
+  fi
 fi
-command -v git >/dev/null 2>&1 || MISSING+=(git)
-if [ "${#MISSING[@]}" -gt 0 ]; then
+if [ "${#MISSING[@]}" -gt 0 ] || [ "$DEPS_INSTALL_FAILED" -eq 1 ]; then
   echo "⛔ required command missing: ${MISSING[*]}. Install it, then rerun this script:" >&2
   required_command_hint "${MISSING[*]}"
   exit 127
@@ -429,6 +455,7 @@ if [ "$MODIFY_PATH" -eq 1 ] && [ -n "${LOGIN_STARTUP:-}" ] && ! grep -Fqx "$MARK
 fi
 
 echo "$(t "Installed elanous $VERSION at $PREFIX/bin/elanous" "elanous $VERSION 을(를) 설치했습니다: $PREFIX/bin/elanous")"
+[ -z "$INSTALLED_DEPS" ] || echo "installed: $INSTALLED_DEPS"
 
 # ── 다음 걸음 (2026-09-23 · Phase 3 「사람 손」) ─────────────────────────
 # ⛔ 설치가 끝나도 «무엇을 더 쳐야 하나»를 안 말하면, 빠뜨린 손이 나중에 «다른 원인의 얼굴»로 나타난다

package/scripts/lib/pwa-scenarios/scenarios.ts

@@ -79,6 +79,9 @@ export function createScenarios(): Scenario[] {
 export function createScenariosWithReplay(readReplay: typeof readTerminalReplay): Scenario[] {
   const marker = `pwa-scn-${randomBytes(8).toString('hex')}`;
   const t1bMarker = `pwa-scn-${randomBytes(8).toString('hex')}`;
+  const t5bFirst = `ELANOUS_T5B_${randomBytes(8).toString('hex')}`;
+  const t5bSecond = `ELANOUS_T5B_${randomBytes(8).toString('hex')}`;
+  const screenContains = (text: string): string => `(() => { const host = document.querySelector('[data-xterm-host]'); const term = host?.__elanousTerm; if (!term || !host.getClientRects().length) return false; const buffer = term.buffer.active; for (let row = buffer.viewportY; row < buffer.viewportY + term.rows; row++) if (buffer.getLine(row)?.translateToString().includes(${JSON.stringify(text)})) return true; return false; })()`;
   // C1 — the answer (n+1) never appears in the question, so finding it on the page means a model replied.
   const c1Base = 1000 + (randomBytes(2).readUInt16BE(0) % 8000);
   return [
@@ -149,6 +152,23 @@ export function createScenariosWithReplay(readReplay: typeof readTerminalReplay)
           return body.terminals.filter((row) => row.producer === 'web-registration' && row.id === ids.terminalId).length === 1;
         } }],
     },
+    {
+      id: 'T5b', surface: 'terminal', path: '/app/term/', title: 'terminal shows output on open and after reload',
+      steps: [
+        { kind: 'goto' }, { kind: 'waitFor', selector: terminal, timeoutMs: 20_000 },
+        { kind: 'waitFor', jsPredicate: `Array.from(document.querySelectorAll(${JSON.stringify(connected)})).some(node => node.textContent?.includes('ACP: 연결됨'))`, timeoutMs: 20_000 },
+        { kind: 'click', selector: terminal }, { kind: 'type', text: `echo ${t5bFirst}` }, { kind: 'press', key: 'Enter' },
+        { kind: 'waitFor', jsPredicate: screenContains(t5bFirst), timeoutMs: 20_000 },
+        { kind: 'goto' }, { kind: 'waitFor', selector: terminal, timeoutMs: 20_000 },
+        { kind: 'waitFor', jsPredicate: screenContains(t5bFirst), timeoutMs: 20_000 },
+        { kind: 'click', selector: terminal }, { kind: 'type', text: `echo ${t5bSecond}` }, { kind: 'press', key: 'Enter' },
+        { kind: 'waitFor', jsPredicate: screenContains(t5bSecond), timeoutMs: 20_000 },
+      ],
+      expect: [
+        { js: screenContains(t5bFirst), expected: 'first marker still visible after reload' },
+        { js: screenContains(t5bSecond), expected: 'new output visible after reload' },
+      ],
+    },
     {
       id: 'C1', surface: 'chat', path: '/app/chat/', title: 'first message streams a model reply', costly: true,
       steps: [{ kind: 'goto' }, { kind: 'waitFor', selector: chatInput, timeoutMs: 20_000 }, { kind: 'click', selector: chatInput }, { kind: 'type', text: `Reply with only the number that is one more than ${c1Base}.` }, { kind: 'press', key: 'Enter' }],

package/scripts/lib/tui-regress-checks.ts

@@ -0,0 +1,146 @@
+// V1 — TUI regression checks that UX measured by hand on 10-02 (U1a · U1b · MAT1c · ONB1), as data.
+// Each check says what to type and how to judge the rendered screen text. The verdicts are pure
+// (screen string → ok/reason) so they are unit-tested without a PTY; scripts/tui-regress.ts drives the PTY.
+
+export type Step =
+  | { kind: 'type'; text: string }
+  | { kind: 'key'; data: string }
+  | { kind: 'wait'; ms: number }
+  | { kind: 'snap'; as: string }
+  | { kind: 'erase'; count: number };
+
+export interface Verdict { ok: boolean; reason: string }
+
+export interface TuiCheck {
+  id: string;
+  title: string;
+  /** `tui.role` to set in the temp config before launch (owner when omitted). */
+  role?: 'owner' | 'contributor' | 'general';
+  steps: Step[];
+  judge: (snaps: Record<string, string>) => Verdict;
+}
+
+const CTRL_C = '\x03';
+const BACKSPACE = '\x7f';
+const HINT = /한 번 더 누르면 나갑니다/;
+
+const ok = (reason: string): Verdict => ({ ok: true, reason });
+const no = (reason: string): Verdict => ({ ok: false, reason });
+
+/** The input row: the last screen line that starts with the prompt marker. */
+export function inputRow(screen: string): string | undefined {
+  return screen.split('\n').filter((line) => line.trimStart().startsWith('❯')).at(-1);
+}
+
+/** Palette entries visible after typing a slash prefix (lines other than the input row that show `/name`). */
+export function paletteHas(screen: string, name: string): boolean {
+  const row = inputRow(screen);
+  return screen.split('\n').some((line) => line !== row && line.includes(`/${name}`));
+}
+
+export function judgeFirstScreen(screen: string): Verdict {
+  if (/Step 1/.test(screen)) return no('«Step 1» 마법사가 떴다');
+  if (!inputRow(screen)) return no('입력칸 «❯» 가 없다');
+  return ok('입력칸이 보이고 «Step 1» 이 없다');
+}
+
+export function judgeHintAppearsThenClears(armed: string, later: string): Verdict {
+  if (!HINT.test(armed)) return no('빈 입력 Ctrl+C 뒤 안내가 안 보인다');
+  if (HINT.test(later)) return no('2.6초 뒤에도 안내가 남아 있다');
+  return ok('안내가 떴다가 2초 뒤 사라졌다');
+}
+
+export function judgeCtrlCClearsText(typed: string, after: string, text: string): Verdict {
+  if (!(inputRow(typed) ?? '').includes(text)) return no('친 글이 입력칸에 안 보인다(준비 실패)');
+  if ((inputRow(after) ?? '').includes(text)) return no('Ctrl+C 뒤에도 글이 남아 있다');
+  if (HINT.test(after)) return no('글을 지우는 Ctrl+C 에 나가기 안내가 떴다');
+  return ok('글이 지워지고 안내는 없다');
+}
+
+export function judgePalette(screens: Record<string, string>, expectations: Record<string, boolean>): Verdict {
+  for (const [name, want] of Object.entries(expectations)) {
+    const screen = screens[name];
+    if (screen === undefined) return no(`/${name} 화면이 없다`);
+    if (paletteHas(screen, name) !== want) return no(`/${name} 가 팔레트에 ${want ? '없다' : '보인다'}`);
+  }
+  return ok(Object.entries(expectations).map(([n, w]) => `/${n} ${w ? '보임' : '숨김'}`).join(' · '));
+}
+
+/** U1b — the help is drawn (key section ⊕ a run of command rows) and the prompt survives below it.
+ *  Not «the whole grid fits»: an owner sees 60+ commands, which exceed a 50-row screen and scroll (PgUp). */
+export function judgeHelpShown(screen: string): Verdict {
+  const lines = screen.split('\n');
+  const commandRows = lines.filter((line) => /^\s+\/[a-z][a-z-]*/.test(line)).length;
+  if (!lines.some((line) => /^\s*Keys\s*$/.test(line))) return no('/help 의 Keys 절이 안 보인다');
+  if (commandRows < 10) return no(`명령 줄이 ${commandRows}개뿐이다`);
+  if (!inputRow(screen)) return no('도움말을 연 뒤 입력칸이 화면 밖으로 밀렸다');
+  return ok(`도움말이 그려졌다(명령 줄 ${commandRows} · Keys 절 · 입력칸 유지)`);
+}
+
+/** U1c2 — lines typed while a reply streams show up as «my» lines, in order, each above its own answer. */
+export function judgeQueuedEcho(screen: string): Verdict {
+  const lines = screen.split('\n');
+  const at = (re: RegExp, after = -1) => lines.findIndex((line, i) => i > after && re.test(line));
+  const u2 = at(/Q2MARK 라고만/);
+  if (u2 < 0) return no('줄 서 있던 «Q2MARK 라고만» 이 내 말로 안 보인다');
+  const a2 = lines.findIndex((line, i) => i > u2 && /Q2MARK/.test(line) && !/라고만/.test(line));
+  const u3 = at(/Q3MARK 라고만/, u2);
+  if (u3 < 0) return no('«Q3MARK 라고만» 이 내 말로 안 보인다(또는 순서가 뒤집혔다)');
+  const a3 = lines.findIndex((line, i) => i > u3 && /Q3MARK/.test(line) && !/라고만/.test(line));
+  if (!(a2 > u2 && u3 > a2 && a3 > u3)) return no(`순서가 내 말2(${u2}) → 답2(${a2}) → 내 말3(${u3}) → 답3(${a3}) 가 아니다`);
+  return ok('내 말2 → 답2 → 내 말3 → 답3');
+}
+
+const PALETTE_STEPS = (names: string[]): Step[] => names.flatMap((name) => [
+  { kind: 'type', text: `/${name.slice(0, 3)}` } as Step,
+  { kind: 'wait', ms: 800 } as Step,
+  { kind: 'snap', as: name } as Step,
+  { kind: 'erase', count: 4 } as Step,
+  { kind: 'wait', ms: 300 } as Step,
+]);
+
+export const TUI_REGRESS_CHECKS: TuiCheck[] = [
+  {
+    id: 'R1', title: '첫 화면 — 입력칸 · «Step 1» 0 (ONB1)',
+    steps: [{ kind: 'snap', as: 'boot' }],
+    judge: (s) => judgeFirstScreen(s.boot ?? ''),
+  },
+  {
+    id: 'R2', title: '빈 입력 Ctrl+C → 안내 → 2초 뒤 사라짐 (U1a · #22868)',
+    steps: [{ kind: 'key', data: CTRL_C }, { kind: 'wait', ms: 300 }, { kind: 'snap', as: 'armed' }, { kind: 'wait', ms: 2600 }, { kind: 'snap', as: 'later' }],
+    judge: (s) => judgeHintAppearsThenClears(s.armed ?? '', s.later ?? ''),
+  },
+  {
+    id: 'R3', title: '글 친 뒤 Ctrl+C → 입력 지움 · 안내 없음 (U1a)',
+    steps: [{ kind: 'type', text: 'regress-abc' }, { kind: 'wait', ms: 400 }, { kind: 'snap', as: 'typed' }, { kind: 'key', data: CTRL_C }, { kind: 'wait', ms: 400 }, { kind: 'snap', as: 'after' }],
+    judge: (s) => judgeCtrlCClearsText(s.typed ?? '', s.after ?? '', 'regress-abc'),
+  },
+  {
+    id: 'R4', title: 'owner 팔레트 — /directive · /help 보임 (MAT1c)',
+    steps: PALETTE_STEPS(['directive', 'help']),
+    judge: (s) => judgePalette(s, { directive: true, help: true }),
+  },
+  {
+    id: 'R5', title: 'general 팔레트 — /directive 숨김 · /help 보임 (MAT1c)',
+    role: 'general',
+    steps: PALETTE_STEPS(['directive', 'help']),
+    judge: (s) => judgePalette(s, { directive: false, help: true }),
+  },
+  {
+    id: 'R6', title: '/help 가 그려지고 입력칸이 남는다 (U1b · #22802)',
+    steps: [{ kind: 'type', text: '/help' }, { kind: 'key', data: '\r' }, { kind: 'wait', ms: 1500 }, { kind: 'snap', as: 'help' }],
+    judge: (s) => judgeHelpShown(s.help ?? ''),
+  },
+  {
+    id: 'R7', title: '답 오는 중 쳐 둔 두 줄이 내 말로 차례로 (U1c2 · #23026 · 실제 LLM 턴)',
+    steps: [
+      { kind: 'type', text: '1부터 25까지 숫자를 한 줄에 하나씩 써 줘. 도구는 쓰지 마.' }, { kind: 'key', data: '\r' }, { kind: 'wait', ms: 2500 },
+      { kind: 'type', text: 'Q2MARK 라고만 답해' }, { kind: 'key', data: '\r' }, { kind: 'wait', ms: 500 },
+      { kind: 'type', text: 'Q3MARK 라고만 답해' }, { kind: 'key', data: '\r' }, { kind: 'wait', ms: 60_000 },
+      { kind: 'snap', as: 'after' },
+    ],
+    judge: (s) => judgeQueuedEcho(s.after ?? ''),
+  },
+];
+
+export const ERASE = BACKSPACE;

package/scripts/marketing/measure-site-numbers.ts

@@ -0,0 +1,169 @@
+import { execFileSync } from 'node:child_process';
+import { closeSync, lstatSync, openSync, readSync } from 'node:fs';
+import { basename, sep } from 'node:path';
+
+const COMMANDS = {
+  lines: 'git ls-files -z',
+  prs: 'gh pr list --state merged --limit 100000 --json number',
+  months: 'git log --reverse --format=%cs | head -1',
+} as const;
+
+const UNMEASURED = '못 잼' as const;
+type Metric = number | typeof UNMEASURED;
+
+interface SiteNumberRow {
+  value: Metric;
+  command: string;
+  denominator: string;
+  candidate: string;
+  error?: string;
+}
+
+interface SiteNumbers {
+  measuredAtKst: string;
+  lines: SiteNumberRow;
+  prs: SiteNumberRow;
+  months: SiteNumberRow;
+}
+
+function command(binary: string, args: string[], cwd: string): Buffer {
+  return execFileSync(binary, args, { cwd, maxBuffer: 64 * 1024 * 1024, stdio: ['ignore', 'pipe', 'pipe'] });
+}
+
+export function siteNumberCandidate(value: number, kind: 'lines' | 'prs' | 'months'): string {
+  if (!Number.isSafeInteger(value) || value < 0) throw new Error('invalid measurement');
+  if (kind === 'months') return value >= 1 ? `${value}개월+` : '큰 수 후보 없음';
+  if (kind === 'lines' && value >= 1_000_000) return `${Math.floor(value / 100_000) * 10}만+`;
+  return value >= 10_000 ? `${Math.floor(value / 10_000)}만+` : '큰 수 후보 없음';
+}
+
+export function completedMonths(firstDay: string, todayKst: string): number {
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(firstDay) || !/^\d{4}-\d{2}-\d{2}$/.test(todayKst)
+    || !Number.isFinite(Date.parse(`${firstDay}T00:00:00Z`)) || !Number.isFinite(Date.parse(`${todayKst}T00:00:00Z`))) {
+    throw new Error('invalid commit or measurement date');
+  }
+  const [year, month, day] = firstDay.split('-').map(Number);
+  const [nowYear, nowMonth, nowDay] = todayKst.split('-').map(Number);
+  const months = (nowYear - year) * 12 + nowMonth - month - Number(nowDay < day);
+  if (months < 0) throw new Error('first commit is after measurement day');
+  return months;
+}
+
+function trackedTextLines(cwd: string): { lines: number; included: number; excluded: number } {
+  const paths = command('git', ['ls-files', '-z'], cwd).toString('utf8').split('\0').filter(Boolean);
+  let lines = 0;
+  let included = 0;
+  let excluded = 0;
+  const chunk = Buffer.allocUnsafe(64 * 1024);
+  for (const path of paths) {
+    const name = basename(path);
+    if (path.split(/[\\/]/).includes('node_modules') || name.endsWith('.lock')
+      || ['package-lock.json', 'npm-shrinkwrap.json', 'pnpm-lock.yaml', 'yarn.lock', 'Pipfile.lock'].includes(name)) {
+      excluded++;
+      continue;
+    }
+    const fullPath = `${cwd}${sep}${path}`;
+    try {
+      if (!lstatSync(fullPath).isFile()) { excluded++; continue; }
+      const fd = openSync(fullPath, 'r');
+      let fileLines = 0;
+      let lastByte: number | undefined;
+      let binary = false;
+      const decoder = new TextDecoder('utf-8', { fatal: true });
+      try {
+        let n: number;
+        while ((n = readSync(fd, chunk, 0, chunk.length, null)) > 0) {
+          for (let i = 0; i < n; i++) {
+            const byte = chunk[i];
+            if (byte === 0 || (byte < 32 && byte !== 9 && byte !== 10 && byte !== 13 && byte !== 12 && byte !== 27)) {
+              binary = true;
+              break;
+            }
+            if (byte === 10) fileLines++;
+          }
+          if (binary) break;
+          lastByte = chunk[n - 1];
+          try { decoder.decode(chunk.subarray(0, n), { stream: true }); }
+          catch { binary = true; break; }
+        }
+        if (!binary) {
+          try { decoder.decode(); } catch { binary = true; }
+        }
+      } finally { closeSync(fd); }
+      if (binary) excluded++;
+      else { lines += fileLines + Number(lastByte !== undefined && lastByte !== 10); included++; }
+    } catch (error) {
+      throw new Error(`tracked file cannot be read: ${path}`, { cause: error });
+    }
+  }
+  return { lines, included, excluded };
+}
+
+function measured(value: number, commandText: string, denominator: string, kind: 'lines' | 'prs' | 'months'): SiteNumberRow {
+  const candidate = siteNumberCandidate(value, kind);
+  const unit = kind === 'lines' ? '줄' : 'PR';
+  return { value, command: commandText, denominator,
+    candidate: candidate === '큰 수 후보 없음' || kind === 'months' ? candidate : `${candidate} ${unit}` };
+}
+
+function unavailable(commandText: string, denominator: string, error: unknown): SiteNumberRow {
+  return { value: UNMEASURED, command: commandText, denominator, candidate: UNMEASURED,
+    error: error instanceof Error ? error.message : String(error) };
+}
+
+export function measureSiteNumbers(options: { cwd: string; now?: Date; ghCommand?: string }): SiteNumbers {
+  const { cwd, now = new Date(), ghCommand = 'gh' } = options;
+  const measuredAtKst = new Intl.DateTimeFormat('sv-SE', {
+    timeZone: 'Asia/Seoul', year: 'numeric', month: '2-digit', day: '2-digit',
+    hour: '2-digit', minute: '2-digit', second: '2-digit', hourCycle: 'h23',
+  }).format(now).replace(' ', 'T') + '+09:00';
+  const todayKst = measuredAtKst.slice(0, 10);
+  let lines: SiteNumberRow;
+  try {
+    const result = trackedTextLines(cwd);
+    lines = measured(result.lines, COMMANDS.lines,
+      `git ls-files 추적 파일 ${result.included + result.excluded}개 중 UTF-8 일반 텍스트 ${result.included}개; 제외 ${result.excluded}개 (바이너리/제어 바이트·node_modules·잠금 파일·심볼릭 링크); 각 파일의 LF 개수 + 마지막 개행 없는 비어 있지 않은 파일의 마지막 줄`, 'lines');
+  } catch (error) {
+    lines = unavailable(COMMANDS.lines, 'git ls-files 추적 UTF-8 일반 텍스트 파일; 바이너리·node_modules·잠금 파일·심볼릭 링크 제외; LF 개수 + 마지막 개행 없는 비어 있지 않은 파일의 마지막 줄', error);
+  }
+  let prs: SiteNumberRow;
+  const prDenominator = '현재 저장소에서 gh가 반환한 병합 PR 목록 (상한 100000개; 제작 주체 미분류)';
+  try {
+    const list: unknown = JSON.parse(command(ghCommand, ['pr', 'list', '--state', 'merged', '--limit', '100000', '--json', 'number'], cwd).toString('utf8'));
+    if (!Array.isArray(list) || !list.every(item => item !== null && typeof item === 'object' && Number.isSafeInteger(item.number))) {
+      throw new Error('invalid gh PR response');
+    }
+    prs = measured(list.length, COMMANDS.prs, prDenominator, 'prs');
+  } catch (error) {
+    prs = unavailable(COMMANDS.prs, prDenominator, error);
+  }
+  let months: SiteNumberRow;
+  try {
+    const firstDay = command('git', ['log', '--reverse', '--format=%cs'], cwd).toString('utf8').split('\n')[0];
+    if (!firstDay) throw new Error('no commits');
+    months = measured(completedMonths(firstDay, todayKst), COMMANDS.months,
+      `첫 커밋 날짜 ${firstDay}부터 KST 오늘 ${todayKst}까지 완료된 달력 개월 (일 미도달이면 1개월 차감)`, 'months');
+  } catch (error) {
+    months = unavailable(COMMANDS.months, `첫 커밋 날짜부터 KST 오늘 ${todayKst}까지 완료된 달력 개월`, error);
+  }
+  return { measuredAtKst, lines, prs, months };
+}
+
+if (import.meta.main) {
+  const args = process.argv.slice(2);
+  if (args.some(arg => arg !== '--json') || args.length > 1) {
+    console.error('Usage: bun scripts/marketing/measure-site-numbers.ts [--json]');
+    process.exitCode = 2;
+  } else {
+    const result = measureSiteNumbers({ cwd: process.cwd() });
+    if (args.includes('--json')) console.log(JSON.stringify(result, null, 2));
+    else {
+      console.log(`잰 시각: ${result.measuredAtKst} (KST)`);
+      for (const [label, row] of [['줄 수', result.lines], ['병합 PR', result.prs], ['기간', result.months]] as const) {
+        console.log(`${label}: ${row.value} · 후보 ${row.candidate}`);
+        console.log(`  명령: ${row.command}\n  분모: ${row.denominator}`);
+        if (row.error) console.log(`  못 잰 이유: ${row.error}`);
+      }
+    }
+  }
+}