SMITH-019 Implement integrated remote terminals

[webfish0]

Outcome

Remote shells and child TUIs run inside Smith.

Scope

• Wire Code OSS remote PTY channels.
• Integrate a terminal parser and normal/alternate screen model.
• Implement modes, styles, cursor, hyperlinks, scrollback, search, and selection.
• Route focused input, escape chord, paste, mouse, and resize.
• Apply output backpressure and memory limits.

Acceptance criteria

• T-012 and terminal portions of T-020/T-022 pass.

Requirements: FR-011, US-005, NFR-006

Source: backlog.md SMITH-019.

[webfish0]

MVP-2 terminal workbench shell landed and was verified on clean commit 6e0f8db.

Evidence summary:

• Command: npm run verify:mvp
• Result: passed
• T-008: passed — deterministic workbench frames across wide/medium/narrow/minimum responsive modes
• T-009: passed — resize recomputes layout and rebuilds hit regions
• T-010: passed — core keyboard commands resolve with terminal-aware enablement/collision reporting
• T-011: passed — pointer routing selects the topmost semantic hit region
• T-012-smoke: passed — internal terminal screen model bounds child output and strips ANSI control sequences from outer frames
• Evidence path from local/CI run: test-evidence/mvp-2-terminal-workbench/

Known limitation: this is the deterministic terminal workbench shell and internal terminal-screen model. Raw terminal mode, live PTY channels, and full interactive alternate-screen integration remain pending before closing all MVP-2 issues.

[webfish0]

Product MVP completion for this issue is blocked by #29 until a live SSH validation target is available or local sshd/container-based SSH testing is approved. Foundation/unit evidence exists, but end-to-end remote evidence is required before Done.

[webfish0]

Unblocked by #29. Product MVP SSH smoke path now passes via disposable localhost OpenSSH server. Evidence:

@smith/matrix@0.0.0-mvp.0 verify:product-mvp
npm run verify:mvp && npm run test:product-mvp

@smith/matrix@0.0.0-mvp.0 verify:mvp
npm run verify:mvp0 && npm run verify:mvp1 && npm run verify:mvp2 && npm run verify:mvp3 && npm run verify:mvp4

@smith/matrix@0.0.0-mvp.0 verify:mvp0
npm run build:mvp0 && npm run test:mvp0 && npm run evidence:mvp0

@smith/matrix@0.0.0-mvp.0 build:mvp0
node scripts/mvp0-build.mjs

Built MVP-0 artifacts for Code OSS 22f2d38a75f6e892dab57a5a153053c56a80d244

@smith/matrix@0.0.0-mvp.0 test:mvp0
node scripts/mvp0-test.mjs

PASSED T-001 client and agent artifacts share pinned Code OSS baseline
PASSED T-026 licence and branding policy excludes prohibited default dependencies
PASSED T-027-smoke upstream update workflow controls are recorded

@smith/matrix@0.0.0-mvp.0 evidence:mvp0
node scripts/mvp0-evidence.mjs

Wrote test-evidence/mvp-0-foundation/manifest.json

@smith/matrix@0.0.0-mvp.0 verify:mvp1
npm run build:mvp0 && npm run test:mvp1

@smith/matrix@0.0.0-mvp.0 build:mvp0
node scripts/mvp0-build.mjs

Built MVP-0 artifacts for Code OSS 22f2d38a75f6e892dab57a5a153053c56a80d244

@smith/matrix@0.0.0-mvp.0 test:mvp1
node scripts/mvp1-test.mjs

PASSED T-002 SSH target resolution uses OpenSSH without shell interpolation
PASSED T-002-security SSH host validation rejects shell metacharacters
PASSED T-002-parser OpenSSH -G parser handles repeated values
PASSED T-003 agent install plan and handshake require version-matched client and agent
PASSED T-005-startup-smoke Smith connect-plan command exits successfully for localhost resolution

@smith/matrix@0.0.0-mvp.0 verify:mvp2
npm run test:mvp2

@smith/matrix@0.0.0-mvp.0 test:mvp2
node scripts/mvp2-test.mjs

PASSED T-008 workbench renders deterministic frames across responsive modes
PASSED T-009 resize layout preserves editor and rebuilds hit regions
PASSED T-010 core keyboard commands resolve with terminal-aware enablement
PASSED T-011 mouse hit routing selects topmost region
PASSED T-012-smoke internal terminal screen model bounds child process output

@smith/matrix@0.0.0-mvp.0 verify:mvp3
npm run test:mvp3

@smith/matrix@0.0.0-mvp.0 test:mvp3
node scripts/mvp3-test.mjs

PASSED T-004 workspace file service supports read write list rename delete and search
PASSED T-006 Unicode helpers distinguish UTF-16 positions graphemes and display cells
PASSED T-007 text buffer supports edit undo redo save and conflict detection
PASSED T-013-subset Explorer Search Problems and Output view models are usable

@smith/matrix@0.0.0-mvp.0 verify:mvp4
npm run test:mvp4

@smith/matrix@0.0.0-mvp.0 test:mvp4
node scripts/mvp4-test.mjs

PASSED T-014 native extension contributions classify to terminal-safe surfaces
PASSED T-014-language language feature view models expose terminal-safe completion diagnostics hover and actions
PASSED T-015 unsupported graphical extension surfaces are explicit
PASSED T-016-subset extension settings and keybinding contributions remain visible to configuration surfaces

@smith/matrix@0.0.0-mvp.0 test:product-mvp
node scripts/product-mvp-test.mjs

PASSED PMVP-001 opens SSH workspace and performs terminal IDE baseline flow; PMVP-001 passed. Remaining work on this issue is post-MVP hardening/full acceptance, not a Product MVP blocker.