395 KiB
SSH Relay GitHub Release Distribution — Living Implementation Checklist
Date created: 2026-07-14
Last updated: 2026-07-14
Current phase: Milestone 3 / Work Package 2 target-native runtime assembly — exact-head run 29363423068 at commit 2db46d91b proves bounded build/Release discovery on both native Windows architectures: both clean builds select three tracking candidates, search 82 entries, select one target record, and report the same /brepro, /debug, /experimental:deterministic, /guard:cf summary with no explicit /incremental switch; Linux x64/arm64, macOS x64/arm64, and Windows x64 compare exactly and upload, while Windows arm64 retains the 2,879 linker-thunk mismatch and fails before upload under E-M3-WINDOWS-LINK-COMMAND-RELEASE-ROOT-CI-RED-001; exact implementation commit e7d9a1c8d adds only a bounded target .ilk presence/size diagnostic and is locally green under E-M3-WINDOWS-INCREMENTAL-DATABASE-LOCAL-001; the next exact-head six-cell run is required before any producer change; no evidence authorizes changing a comparator, production/default path, or tuple state; oldest-baseline, native-trust, cross-family remote, and measured-baseline gates remain open; no bundled-runtime path is enabled
Primary design: SSH relay GitHub Release plan
Motivating issues: #8450, #1693
Mandatory Living-Document Protocol
This checklist is part of the implementation, not a planning artifact that may go stale. Every agent or engineer working on this project must read it before editing code and update it in the same change as the work it records.
- At the start of every implementation session, read this document and confirm the current phase, open decisions, accepted gaps, and existing evidence.
- Mark the active item with
**In progress — YYYY-MM-DD, owner/agent**before changing code. - Keep only one implementation item marked in progress unless independent PRs are deliberately running in parallel and each names its owner.
- Do not change
- [ ]to- [x]until the implementation and its required verification are complete. - Every completed item must cite an evidence-ledger ID such as
E-ARTIFACT-001or a merged PR. - Record exact commands, runner OS/architecture, commit SHA, result, duration, and artifact link for executable evidence. “Tests passed” is not adequate evidence.
- Record what a test does not prove. Mock coverage must not be presented as live SSH, native-module, release-asset, or platform coverage.
- If implementation changes the design, update both this checklist and the HTML plan in the same PR before continuing.
- If a supported tuple lacks required real-environment proof, leave it on a proven legacy path or mark it unsupported. Do not check it off based on cross-compilation or emulation alone.
- Never use “100% verified” without naming the exact declared matrix and showing that every required cell passed.
- Preserve unrelated worktree changes. At checklist creation, the existing edits to
ssh-remote-node-resolution.tsand its test are user-owned issue #8450 work. - Before every PR handoff, update Current Status, PR/Work-Package Status, Verification Ledger, Accepted Gaps, and Next Required Action.
Status Legend
- [ ]— not complete.- [x]— complete with linked evidence.**In progress — date, owner**— actively being implemented; the checkbox remains unchecked.BLOCKED:— cannot proceed without a named decision, authority, runner, credential, or external state. Include the exact unblock condition.ACCEPTED GAP:— deliberately not proved yet. Include scope, fallback behavior, owner, and promotion condition.
Current Status
- Implementation status: Work Package 0 is committed at
c4259d94fon currentmain, with refreshed focused, static, full-lint, live #8450 SSH/PTY, and GitHub Actions proof (E-M0-UNIT-002, E-M0-STATIC-002, E-M0-LIVE-002, E-M0-CI-001). Draft PR #8724 is open and CI-green at implementation head94e58d83e. - Completed package: Work Package 1's disconnected manifest, content-identity, signature,
release-asset, and conservative selector contracts are locally and CI-green under E-M2-RED-001,
E-M2-CONTRACT-001, and E-M2-CI-001. They remain isolated in stacked draft PR
#8728 at implementation commit
b9d80a4cb; no deploy/resolver call site is connected and no tuple is enabled. - Active package: Work Package 2 target-native runtime assembly, archive inspection, executable
smoke, SBOM, and provenance only. The Windows x64/arm64 artifact candidate and portability
corrections are implemented through
b6903b220, with bounded smoke diagnostics in3aab5aff8, explicit PTY smoke settlement inddf28eb8d, and bounded active-resource diagnostics in6bba90020, in stacked draft PR #8741. Exact-head run 29341643555 proves the bundled Node, patched PTY input/resize/exit, and watcher lifecycle complete on x64 in 3,357.413 ms with 56,905,728-byte RSS and arm64 in 6,593.663 ms with 54,505,472-byte RSS, but each child retains a Windows handle until the parent kills it at its 45-second bound. Exact-head run 29343816558 now classifies the resource on both native architectures: after all public PTY cleanup and a two-second observation window, oneMessagePortremains alongside only the expected parent stdioPipeWrapresources (E-M3-WINDOWS-RESOURCE-DIAGNOSTIC-CI-RED-001). The active slice is an exact-source, fail-closed correction applied only to the copied node-pty Windows JavaScript inside runtime artifact staging; the repository-wide node-pty patch and legacy/default desktop path must remain unchanged. That local contract is green atc04b4f630under E-M3-WINDOWS-CONPTY-WORKER-LOCAL-001. Exact-head run 29345126283 then passed all six native jobs; both Windows architectures shed theMessagePortwithin the two-second observation window, exited normally, and uploaded unpublished evidence (E-M3-WINDOWS-CI-001). This package may produce test artifacts but must not publish, resolve, transfer, install, launch, or enable them. - Active evidence gate: the immutable Node v24.18.0 contract, pinned release key, bounded verifier,
and artifact-only CLI are locally green under E-M3-NODE-RED-001 and E-M3-NODE-PROVENANCE-001.
E-M3-RUNTIME-LOCAL-001 additionally proves one unpublished Linux arm64 glibc assembly, exact-tree
archive inspection, deterministic repack, bundled Node 24.18.0 execution, real patched PTY, and
watcher events. E-M3-STATIC-001 records the current focused, type, lint, format, line-budget, and
diff gates. The first exact-head native run exposed a macOS
/varversus/private/varwatcher oracle mismatch under E-M3-CI-RED-001. The corrected exact-head run passed target-native build, archive/tree verification, bundled Node, patched PTY, and watcher smoke for Linux x64/arm64 and macOS x64/arm64 under E-M3-CI-001. A bounded comparator now rejects incomplete outputs and any runtime-tree, archive, identity, SPDX, provenance, type, mode, size, or digest drift after two independently verified clean builds; its exact implementation-commit contract and static gates are locally green under E-M3-REPRODUCIBILITY-LOCAL-001. Exact-head run 29347236627 passed both Linux cells, exposed macOS x64/arm64 runtime identity drift, and failed Windows x64/arm64 while collecting the new comparator suite under E-M3-REPRODUCIBILITY-CI-RED-001. E-M3-REPRODUCIBILITY-DIAGNOSTIC-LOCAL-001 removes the comparator shebang, checks both new files withnode --checkon POSIX and Windows, and reports runtime-tree drift before derived metadata drift. E-M3-REPRODUCIBILITY-DIAGNOSTIC-CI-RED-001 proves those diagnostics on all six native runners: Linux x64/arm64 remain equal, both macOS builds first differ atpty.node, and both Windows builds first differ atconpty_console_list.node. The bounded correction ina09b02ec4makes macOS retain a reproducible loadable UUID, applies/Breproonly to copied Windows artifact source, and requires exclusive caller-owned work paths;3e433b343makes the CI path canonical across runs. E-M3-REPRODUCIBILITY-LINKER-CI-RED-001 proves both Linux and macOS architectures now build, verify, smoke, compare exactly, and upload, but both Windows jobs fail closed in contract collection becausessh-relay-runtime-build.test.mjsimports a builder with an unused Unix shebang. E-M3-REPRODUCIBILITY-BUILDER-PARSER-LOCAL-001 proves the bounded correction at exact commitf864d3fa6. Exact-head run 29351557922 then parses and builds on all six native runners: Linux x64/arm64, macOS x64/arm64, and Windows x64 compare exactly and upload, while Windows arm64 fully builds, verifies, and smokes both outputs but fails closed before upload whenconpty_console_list.nodediffers (E-M3-REPRODUCIBILITY-WINDOWS-ARM64-CI-RED-001). Documentation- only exact-head repeat run 29352510414 reproduces the same isolated arm64 drift while all five controls compare and upload under E-M3-REPRODUCIBILITY-WINDOWS-ARM64-REPEAT-CI-RED-001. Native Windows arm64 equality remains mandatory; oldest-baseline, native-trust, SSH, and musl cells remain open. E-M3-WINDOWS-PE-DIAGNOSTIC-LOCAL-001 proves the bounded diagnostic and fail-closed workflow ordering locally at exact implementation commit39ee3451b; both native Windows cells remained required before interpreting or correcting the producer. Exact-head run 29353432240 keeps x64 and all POSIX controls green, then reports the real arm64 PE hashes/layout/ranges and fails without upload under E-M3-WINDOWS-PE-DIAGNOSTIC-CI-RED-001. Because the 128 detailed-range cap is exhausted by.text, the active diagnostic-only correction adds raw-section labels and a bounded summary across all 2,887 ranges before any producer change. Exact-head run 29357355064 keeps all five controls reproducible and proves both generated x64 option blocks, but the native arm64 build fails closed at the new Release-condition verifier before runtime staging under E-M3-WINDOWS-MSBUILD-PLATFORM-CASE-CI-RED-001. The runner exposesPlatform=arm64; the active correction accepts only a case-insensitive exact match for the expected architecture and retains every option/cardinality check. Exact-head run 29358223742 proves that correction on the real arm64 runner, preserves five exact controls, and reaches paired disassembly under E-M3-WINDOWS-ARM64-THUNK-DISASSEMBLY-CI-RED-001. The arm64 outputs have 2,879 linker-emitted 16-byte function thunks whose three control-flow instructions match and whose unreachable fourthudfinstruction differs, plus 68 derived identity bytes. Strict comparison and rejected-output no-upload remain intact. The active diagnostic must prove the generated incremental-link state before any producer change. No comparator, publication, or production behavior changes. - Windows input correction: E-M3-WINDOWS-INPUT-GAP-001 proved the official Windows ZIP lacks headers
and
node.lib. Both artifacts now require the exact signed headers archive and tuple import library as explicit inputs. The schema, signed-checksum verifier, bounded ZIP/header extraction, and import-library staging are locally green under E-M3-WINDOWS-INPUT-001; native Windows build proof remains active and no implicitnode-gypdownload is allowed. - Windows PTY-closure correction: E-M3-WINDOWS-CONPTY-GAP-001 proved the candidate omitted the
conpty.dllandOpenConsole.exefiles required by Orca's productionuseConptyDll: truepath and therefore exercised a weaker system-ConPTY smoke. E-M3-WINDOWS-LOCAL-002 proves the corrected local tree-closure and smoke configuration contracts. E-M3-WINDOWS-CI-001 proves the corrected native x64/arm64 closure executes and settles; oldest-baseline and native-trust cells remain open. - Windows native progression: E-M3-WINDOWS-CI-RED-002 captured and corrected NTFS fixture modes,
Windows shebang parsing, authenticated-key checkout bytes, and POSIX-only mode assertions. At the
corrected exact head, E-M3-WINDOWS-CI-RED-003 proves 20 passing and one intentionally skipped test
on each native architecture, exact input download, and a common fail-closed Git-for-Windows
gpgvdrive-letter keyring incompatibility. E-M3-WINDOWS-CI-RED-004 proves that correction with 21 passing and one intentionally skipped test, signed input acceptance, native compilation, and runtime/ZIP assembly on each architecture; both 45-second bundled smoke commands then time out without propagating their already bounded child stderr. E-M3-WINDOWS-SMOKE-SETTLEMENT-CI-RED-001 and E-M3-WINDOWS-SMOKE-SETTLEMENT-CI-RED-002 then proved functional PTY/watcher smoke still did not settle after public listener and terminal cleanup. E-M3-WINDOWS-RESOURCE-DIAGNOSTIC-CI-RED-001 identifies the persistent native resource as oneMessagePorton both x64 and arm64 after a two-second drain window. E-M3-WINDOWS-CI-001 proves the artifact-only correction removes that resource before normal exit on both architectures and retains the uploaded bytes. No oldest- baseline, native-trust, SSH, reproducibility, or enabled-tuple claim is made. - Production behavior: unchanged; Orca embeds relay JavaScript and installs
node-ptyplus@parcel/watcherwith remote npm. - New runtime assets published: none.
- Bundled runtime enabled: no.
- Declared supported bundled tuples: none until the required target-native and two-layer live evidence cells are complete.
- Validation orchestration: GitHub Actions is the primary runner and evidence surface under E-M1-RUNNER-DECISION-001; exact native labels are recorded, while representative cross-family remote targets remain open.
- Rollout control: the Beta-tagged option lives on SSH target add/edit surfaces and is persisted per target through existing target configuration. It is off by default for existing, new, imported, missing, unknown, and malformed configurations, all of which resolve to legacy. Only an explicit per-target opt-in selects bundled-preferred behavior, and implementing the setting does not authorize default-on rollout or legacy removal (E-M1-ROLLOUT-DECISION-001).
- Legacy fallback removal: not authorized.
- Next required action: replace the empty-property oracle with a bounded parser for the actual post-build MSBuild linker-command tracking record, then rerun all six target-native cells. Require both Windows clean builds to report the same allowlisted linker-switch summary before considering one copied-artifact producer correction. Preserve strict comparison, no rejected upload, the repository-wide node-pty patch, legacy/default path, and every other release gate.
Non-Negotiable Invariants
- The bundled primary path never requires outbound HTTP, npm, a compiler, Python, or a system Node installation on the SSH host.
- The desktop downloads the runtime, verifies it locally, and transfers it through the existing authenticated SSH connection.
- SSH authentication/connection and relay RPC transport remain unchanged; bootstrap artifact transfer is a separately designed, measured, and gated subsystem.
- Every desktop build embeds the exact signed manifest needed to resolve a remote tuple to a content identity while the desktop is offline.
- Relay artifacts are built and signed before desktop packaging; app builds and GitHub Release uploads consume the exact same immutable bytes.
- No downloaded byte is extracted, transferred, or executed until manifest authenticity, expected tuple, size bounds, and archive SHA-256 are verified at the appropriate boundary.
- A completed remote install is immutable and content-addressed. A running old relay is never mutated in place.
- Bundled and legacy installs use distinct identities, locks, partial directories, sentinels, and launch generations.
- Fallback cannot start until all bundled download, extraction, upload, verification, and launch work is aborted, awaited, and unable to mutate state.
- Signature, archive hash/safety, extracted-tree, or native-signature failure fails closed in
auto: rejected bytes never execute and automatic legacy fallback never starts. - Detected local or remote cache corruption is quarantined and may recover only from freshly verified bundled bytes; failed/unavailable recovery fails closed without automatic legacy.
- Local signed-manifest/archive/tree verification plus authenticated SSH transfer into exclusive staging is the pre-execution integrity boundary; bundled Node then hashes the entire staged tree before any completion sentinel is written.
- Remote install proof establishes initial transfer/finalization correctness. Warm launch trusts Orca's completed-directory immutability assumption; the sentinel is not ongoing proof against later mutation or a hostile authenticated account that can replace runtime and sentinel.
- Platform support is never inferred from an artifact existing. Each enabled tuple requires a real-environment runtime proof.
- Unknown or conflicting platform/libc evidence deterministically selects proven legacy behavior; it never guesses an artifact.
- Runtime transfer has explicit memory, file-count, concurrency, cancellation, and time budgets.
- Bundled mode depends only on the explicitly declared POSIX or Windows bootstrap primitives; it
never silently requires remote Node, Python, tar,
sha256sum, orshasum. - Every Node/CVE/runtime/key refresh produces a new desktop tag/build and embedded signed manifest. Old clients remain frozen to their embedded manifest and accepted keys.
- Current PTY, watcher, Git, filesystem, streaming, agent-hook, preflight, reconnect, and GC contracts remain intact.
- macOS, Linux, and Windows behavior remains behind runtime checks and uses platform-native paths and commands.
- No implementation file adds a max-lines disable or vague
helpers/utilsmodule name.
Milestone 0 — Preserve and Prove the Legacy Safety Net
Goal: land the narrow #8450 correction independently because automatic fallback depends on a coherent Node/npm resolver.
Work Package 0 implementation evidence was completed on 2026-07-14 by the Codex implementation owner. No relay artifact-distribution behavior is included.
- Confirm the #8450 implementation selects Node and npm from the same bin directory on POSIX. (E-M0-UNIT-001, E-M0-UNIT-002, E-M0-LIVE-002)
- Confirm Windows selects
node.exeandnpm.cmdfrom one toolchain directory. (E-M0-UNIT-001; mocked Windows command construction, not live Windows) - Reject an incomplete system Node and continue to the usable NVM candidate. (E-M0-UNIT-001, E-M0-UNIT-002, E-M0-LIVE-002)
- Preserve minimum supported Node-version enforcement. (E-M0-UNIT-001)
- Preserve login-shell, known-path, version-manager, noisy-startup, cancellation, and
MaxSessions=1behaviors. (E-M0-UNIT-001; liveMaxSessions=1remains outside this WP0 proof) - Add the exact Ubuntu/system-Node-without-npm/NVM-below-
.bashrc-guard regression fixture. (E-M0-UNIT-001, E-M0-LIVE-001) - Add negative tests for Node present/npm missing, npm present/Node too old, mismatched bin directories, and an unusable npm shim. (E-M0-UNIT-001)
- Run focused resolver and deploy tests and record evidence. (E-M0-UNIT-001, E-M0-UNIT-002)
- Run a live SSH reproduction matching issue #8450 and record the selected paths and successful relay/PTY launch without recording usernames or home paths in committed evidence. (E-M0-LIVE-001, E-M0-LIVE-002)
- Keep this fix in a separate PR or commit from GitHub Release distribution. The reviewed plan
is commit
2b67de870; WP0 code is the separate commitc4259d94fin draft PR #8724. (E-M0-PR-001) - Document which tuples have a live passing legacy E2E. Fallback is only a support claim for those tuples. (E-M0-LIVE-001)
| Legacy remote tuple | Client | Transport | Evidence | Scope limit |
|---|---|---|---|---|
| Ubuntu 24.04 arm64, glibc, system Node 18 without npm, guarded NVM Node 22/npm 10 | macOS 26.2 arm64 | Built-in SSH2 connection + SFTP relay upload | E-M0-LIVE-001, E-M0-LIVE-002 | Does not prove x64, system SSH, Windows, musl, or MaxSessions=1 |
Completion evidence required: focused red/green tests, live #8450 SSH run, typecheck, lint, and PR link.
Milestone 1 — Close Blocking Product and Support Decisions
No production implementation begins until every blocking item has an owner and decision record.
Supported runtime baselines
- Define the oldest supported glibc version as 2.28 for initial Linux x64/arm64 candidates. (E-M1-BASELINE-001)
- Define the oldest supported libstdc++/C++ ABI level as libstdc++ 6.0.25 with
GLIBCXX_3.4.25. (E-M1-BASELINE-001) - Define the minimum supported Linux kernel as 4.18. (E-M1-BASELINE-001)
- Define no enabled musl baseline initially. Alpine/musl remains a selector and legacy-path test family until Orca produces and proves its own target-native Node/runtime build; no unofficial Node binary is accepted. (E-M1-BASELINE-001, E-M1-NODE-PROVENANCE-001)
- Define macOS 13.5 as the minimum for both x64 and arm64 candidates. (E-M1-BASELINE-001)
- Define the initial Windows candidates as Windows 10 22H2 build 19045 or Server 2022 build 20348 for x64, and Windows 11 24H2 build 26100 for arm64, with OpenSSH for Windows 8.1p1, Windows PowerShell 5.1, and .NET Framework 4.8 as minimum bootstrap primitives. (E-M1-BASELINE-001)
- Treat a Rosetta-translated shell as x64 process architecture, but keep it on legacy until an x64 artifact passes a live Rosetta SSH cell. A native arm64 shell selects arm64; detection never forces a native-architecture artifact across a translated process boundary. (E-M1-BASELINE-001)
- Document current legacy platform families separately from bundled candidates and distinguish a code-declared family from a live-evidenced fallback claim. (E-M1-LEGACY-INVENTORY-001)
Decision owner: Codex implementation owner for #8450. Decision authority: conservative implementation boundary under the user-approved legacy-default Beta rollout. These are minimum eligibility constraints, not support claims: every candidate remains disabled until its two-layer live evidence cells pass.
The initial candidate families are Linux glibc x64/arm64, macOS x64/arm64, and Windows x64/arm64. Linux musl, WSL, Rosetta-translated macOS, and any unlisted OS/architecture remain legacy-only. Version parsing is exact and fail-conservative; an unknown, missing, older, or conflicting baseline probe selects legacy rather than guessing a compatible artifact.
| Remote family | Current legacy path | Proposed bundled candidate | Live fallback evidence in this project |
|---|---|---|---|
| Linux x64 glibc | Declared linux-x64; coherent remote Node/npm plus remote native npm install |
linux-x64-glibc |
None yet |
| Linux arm64 glibc | Declared linux-arm64; coherent remote Node/npm plus remote native npm install |
linux-arm64-glibc |
E-M0-LIVE-002 (Ubuntu 24.04 arm64) |
| Linux x64/arm64 musl | Shares current Linux platform key; compatibility depends on legacy npm/native build | None initially; selector returns legacy | None |
| macOS x64 | Declared darwin-x64; coherent remote Node/npm plus remote native npm install |
darwin-x64 |
None |
| macOS arm64 | Declared darwin-arm64; coherent remote Node/npm plus remote native npm install |
darwin-arm64 |
None |
| Windows x64 | Declared win32-x64; coherent node.exe/npm.cmd plus remote native install |
win32-x64 |
None |
| Windows arm64 | Declared win32-arm64; coherent node.exe/npm.cmd plus remote native install |
win32-arm64 |
None |
| WSL/Rosetta/other | No separate current platform identity; behavior follows detected process family | No candidate until a separately identified live cell | None |
“Declared” above means the current source accepts the platform and has deterministic unit coverage; it is not a claim that this project has a passing live SSH fallback cell. Automatic legacy fallback for a bundled tuple is permitted only where the last column has current evidence for the relevant family/transport conditions.
Validation runner and network topology
Decision owner: Codex implementation owner for #8450. Decision authority: worktree owner direction on 2026-07-14. GitHub Actions is the primary orchestration and durable evidence surface because it can couple target-native build jobs, packaged-client jobs, logs, metrics, and immutable artifacts to the exact commit under test without introducing a second release-control plane.
- Use GitHub Actions for the PR, nightly, release, and promotion evidence workflows. (E-M1-RUNNER-DECISION-001)
- Permit a GitHub-hosted runner to fill a required evidence cell only when it provides real hardware or native virtualization for the declared OS/architecture and the job records the runner label, image/version, architecture, and native-versus-emulated status. (E-M1-RUNNER-DECISION-001)
- Require a real OpenSSH daemon, the full-size packaged runtime, and the production built-in SSH/SFTP or system-SSH path named by the cell. A mock server, reduced fixture, cross-build, QEMU-only run, or artifact existence cannot fill a live cell. Same-host or native-container targets qualify only when they preserve the declared remote OS/architecture, SSH daemon, primitive, egress, and isolation conditions. (E-M1-RUNNER-DECISION-001)
- For Layer B cross-family cells, have the GitHub Actions job provision or connect to an ephemeral native SSH target or an approved self-hosted target pool. The remote need not itself be GitHub-hosted, but its image/snapshot identity and teardown result are part of the evidence; do not assume networking between unrelated hosted jobs. (E-M1-RUNNER-DECISION-001)
- Keep any tuple without an available qualifying native runner or reachable representative remote disabled and on its proven legacy path. (E-M1-RUNNER-DECISION-001)
- Inventory the repository's available GitHub-hosted runner labels and record native architecture, image/version policy, and unreserved capacity. No approved self-hosted SSH target pool currently exists. (E-M1-RUNNER-INVENTORY-001)
- Name and pin the representative POSIX and Windows remote images/snapshots used for Layer B, including their OpenSSH and bootstrap-primitive baselines and network-egress controls.
- Use the explicit native GitHub runner labels below for paired legacy-versus-bundled regression measurements in the same job, with local network shaping and at least ten samples per path. If three qualifying reruns have over 15% coefficient of variation or disagree on the threshold, require an approved dedicated runner; do not weaken the threshold. (E-M1-BUDGET-DECISION-001)
BLOCKED for cross-family live evidence, not for contract-only work: the Codex implementation owner owns repo-local fixture/workflow definitions, but a repository release administrator must approve an ephemeral cloud credential/environment or a self-hosted target pool before immutable POSIX and Windows Layer B snapshots can be named as reachable infrastructure. The unblock record must include provider, snapshot IDs, credential owner, egress policy, teardown SLA, and cost/capacity owner. Safe default: no Layer B cell and no bundled tuple is enabled; continue schema/selector and local same-family test work without secrets.
Native runner inventory decision
Decision owner: Codex implementation owner for #8450. Image authority: GitHub-hosted runner image
catalog; repository workflow inventory at this branch. Pin explicit OS labels in new relay workflows
and record the resolved image version from every job because GitHub refreshes images weekly.
*-latest is not permitted for qualifying tuple evidence.
| Client/build architecture | Qualifying label | Native image family | Capacity/update rule |
|---|---|---|---|
| Linux x64 | ubuntu-24.04 |
Ubuntu 24.04 x64 | GitHub-hosted ephemeral, unreserved/queue-dependent; weekly image, log exact version |
| Linux arm64 | ubuntu-24.04-arm |
Ubuntu 24.04 arm64 | GitHub-hosted ephemeral, unreserved/queue-dependent; weekly image, log exact version |
| macOS x64 | macos-15-intel |
macOS 15 x64 | GitHub-hosted ephemeral, unreserved/queue-dependent; weekly image, log exact version |
| macOS arm64 | macos-15 |
macOS 15 arm64 | GitHub-hosted ephemeral, unreserved/queue-dependent; weekly image, log exact version |
| Windows x64 | windows-2022 |
Server 2022 x64 | GitHub-hosted ephemeral, unreserved/queue-dependent; weekly image, log exact version |
| Windows arm64 | windows-11-arm |
Windows 11 arm64 | GitHub-hosted ephemeral, unreserved/queue-dependent; weekly image, log exact version |
The repository already uses ubuntu-latest, ubuntu-24.04-arm, macos-15, windows-2022, and a
third-party macOS release label. Existing latest and third-party labels may remain for their
current workflows but do not qualify a relay tuple unless the relay job pins the explicit label and
records its resolved image. No approved self-hosted SSH target pool, reserved hosted-runner capacity,
or cross-family remote endpoint is inferred from this inventory; those unresolved Layer B cells keep
the affected tuple disabled.
Remote bootstrap primitives
- Define the exact POSIX baseline as POSIX
shwith builtincommand/printfplus byte-preservingcat,mkdir,rm,mv,chmod,test, andnohup; no Node, Python, Perl, tar, base64, checksum tool, or compiler is permitted. (E-M1-BOOTSTRAP-DECISION-001) - Define the exact Windows baseline as OpenSSH for Windows 8.1p1, Windows PowerShell 5.1, and
.NET Framework 4.8 with
FileStream,FileMode.CreateNew, 64 KiB binary reads/writes, same-volumeDirectory.Move, ACL-preserving filesystem operations, and the existing detached relay launch mechanism. (E-M1-BOOTSTRAP-DECISION-001) - Capability-probe required semantics with a client-generated nonce and byte fixture, without Node or Python, once per authenticated SSH connection. Never persist or share the result across hosts or reconnect generations. (E-M1-BOOTSTRAP-DECISION-001)
- Treat missing or semantically incorrect bootstrap primitives as compatibility failure,
eligible for legacy in
autoonly where that exact legacy family has current evidence. (E-M1-BOOTSTRAP-DECISION-001) - Record no BusyBox-only variant as qualified initially. Ubuntu 24.04 arm64 BusyBox 1.36.1 lacks
the required
nohupapplet and therefore selects legacy; any BusyBox host must pass the full semantic probe with external required commands before it can become a candidate. (E-M1-BUSYBOX-001)
Bootstrap primitive decision
POSIX system SSH and built-in SSH2 both open a dedicated stdin byte stream for each manifest file.
The remote command creates that file with restrictive permissions and cat > file; the client sends
exactly the declared size and closes stdin. The initial semantic probe round-trips a binary fixture
containing NUL, CR, LF, high-bit bytes, and no trailing newline through the same path. Per-file
channels are bounded and become sequential under MaxSessions=1. Full staged-tree integrity is
still checked later by transferred bundled Node, not by trusting cat or a remote checksum command.
Windows transfer sends raw bytes to a purpose-built PowerShell script that reads
Console.OpenStandardInput() into a 64 KiB buffer and writes with FileStream. A CreateNew lock
file containing an unguessable client token establishes exclusive staging ownership before the
directory is created; every later command verifies that token. The reader rejects early EOF and one
extra byte beyond the declared safe-integer size. It never materializes the file as a string,
JSON/base64 value, or whole-file buffer. Publish uses same-volume rename only after bundled-Node
tree verification and native probes. Probe artifacts and locks are removed on success, failure, or
cancellation; cleanup settlement is part of the timeout oracle.
Node runtime ownership
- Pin the first runtime contract to official Node v24.18.0 LTS (Krypton). Stay on Node 24 LTS until a separately reviewed major upgrade; never silently float a desktop build to a newer patch. (E-M1-NODE-PROVENANCE-001)
- Use unchanged official nodejs.org binaries for Linux glibc x64/arm64, macOS x64/arm64, and Windows x64/arm64. Build all relay code and native dependencies in target-native Orca jobs; do not substitute cross-built Node executables. (E-M1-NODE-PROVENANCE-001)
- Produce no musl Node binary in the initial release. A later musl candidate requires an Orca-owned target-native source build, reproducible provenance, signing, and the same live gates; unofficial community binaries are prohibited. (E-M1-NODE-PROVENANCE-001)
- Check Node security/release status at least weekly and at every desktop release cut. Triage a published Node/runtime CVE within one business day; ship an applicable critical fix within seven calendar days and high-severity fix within fourteen, or disable the affected bundled tuple while legacy remains available. (E-M1-NODE-PROVENANCE-001)
- Require every Node patch, CVE remediation, native-code change, dependency change, manifest-key change, or accepted-key change to create a new runtime content ID and a new desktop tag/build with a newly embedded signed manifest. Old clients remain pinned. (E-M1-NODE-PROVENANCE-001)
- Verify the detached Node
SHASUMS256.txt.sigagainst a build-input-pinned Node release keyring before extraction, record the signer fingerprint and source archive digest in provenance, and preserve official executable bytes/signatures. Orca-built native executables and libraries still require the target-native signing policy decided below. (E-M1-NODE-PROVENANCE-001) - For Windows native-module builds, authenticate the exact-version
headers.tar.gzand architecture-specificwin-*/node.libthrough that same signed checksum document in addition to the tuple ZIP. The official Windows ZIP does not contain either build input; implicitnode-gypdownloads are prohibited. (E-M3-WINDOWS-INPUT-GAP-001)
Trust and signing
- Use Ed25519 detached signatures through the existing direct
tweetnacl@1.0.3dependency; reject non-64-byte signatures, non-32-byte public keys, unknown algorithms, and unknown keys. (E-M1-TRUST-DECISION-001) - Canonicalize only a fully validated unsigned manifest projection: fixed schema field order,
tuples sorted by canonical tuple ID, files sorted by portable relative path, safe integers,
portable ASCII identity/path fields, no optional
undefined, and UTF-8JSON.stringifybytes with no whitespace or trailing newline. Signatures are outside the signed projection. (E-M1-TRUST-DECISION-001) - Generate Ed25519 keys offline, store only the base64-encoded 32-byte seed in a tag-restricted
relay-runtime-manifest-signingGitHub Environment with required reviewers, expose it only to the fail-closed aggregate job, pin every action by commit SHA, grant no write permission except the separate draft-release upload job, and rely on environment deployment logs for audit. (E-M1-TRUST-DECISION-001) - Define key ID as
sha256:<lowercase hex SHA-256 of the 32-byte Ed25519 public key>. Embed the accepted key set in the desktop. Rotation dual-signs at least two consecutive desktop releases and 30 days; old-key removal/revocation and emergency replacement ship only in a new desktop build. Old clients and manifests remain pinned with no freshness lookup. (E-M1-TRUST-DECISION-001) - Require embedded manifest tag/channel/version to equal the compiled desktop identity and use only that exact release URL. A newer desktop never accepts an older manifest. A user-initiated desktop downgrade may use its own embedded older manifest/cache namespace but cannot rewrite a newer content-addressed install. (E-M1-TRUST-DECISION-001)
- Use GitHub artifact attestations/keyless OIDC provenance as a supplement, never as a replacement for the offline-verifiable embedded Ed25519 manifest signature. (E-M1-TRUST-DECISION-001)
- Preserve valid official Node signatures. Sign every Orca-built macOS executable,
.node, dylib, andspawn-helperwith the existing Developer ID Application identity before final hashes; verify strict codesign and notarized containing-app provenance on a native runner. (E-M1-TRUST-DECISION-001) - Preserve valid upstream Authenticode signatures and send every unsigned Orca-built Windows
.exe,.dll, and.nodethrough the existing SignPath inner-binary flow before final hashes; verifyGet-AuthenticodeSignatureand signer policy on returned bytes. (E-M1-TRUST-DECISION-001) - Define target-native trust environments: clean macOS 13.5 x64/arm64 snapshots with quarantine plus Gatekeeper/codesign assessment; Windows Server 2022 x64 and Windows 11 24H2 arm64 snapshots with current Microsoft Defender signatures; and a disposable Windows 11 24H2 x64 VM with the release WDAC policy in audit then enforced mode. Record snapshot/policy/signature IDs in every run; third-party EDR observations may supplement but not replace these gates. (E-M1-ENDPOINT-DECISION-001)
Manifest-key operational gate
Decision owner: Codex implementation owner for #8450. Operational owners: repository release administrators for GitHub Environment/reviewer policy, existing Apple credential owners for macOS, and existing SignPath organization approvers for Windows. No key or secret is created by this decision. Runtime publication remains blocked until the protected environment, two test keys, dual-sign/unknown-key/revocation rehearsals, action-SHA allowlist, and access audit are executable.
The signing job receives canonical unsigned bytes and returns only key ID plus signature. The aggregate job reconstructs and verifies the signed projection before emitting the final manifest. The desktop repeats the same validation and rejects duplicates before cryptographic verification. At least one accepted signature is required, every signature entry must be unique, and a malformed or unknown extra signature fails closed rather than being ignored. Key compromise cannot alter an old client's embedded manifest or archive hashes; emergency response stops asset publication and ships a new desktop build with revised accepted keys.
The trust-environment decision does not imply those snapshots exist in an approved pool. Gatekeeper tests add a quarantine attribute to the downloaded runtime before assessment and execution. Windows tests update Defender intelligence, scan the unpacked tree, verify every PE signature, run native PTY/watcher smoke, then repeat under the enforced WDAC policy. Detection, quarantine, or policy denial is release-blocking and must retain logs without weakening the security product.
Operational budgets and rollout policy
- Record current legacy cold-install and warm-connect baselines on representative networks.
- Set the local verified-runtime cache to 2 GiB, with an atomic LRU that never evicts referenced, locked, staging, current-manifest, or running content; retain at least current plus previous content per used tuple when they fit. (E-M1-BUDGET-DECISION-001)
- Reject an archive over 100 MiB compressed, 350 MiB expanded, 5,000 entries, 250 MiB for one file, a path over 240 UTF-8 bytes, or aggregate metadata arithmetic outside safe integers. (E-M1-BUDGET-DECISION-001)
- Set stage ceilings: cache lookup 2 s, connect/DNS availability decision 15 s, download 5 min, extraction 2 min, transfer 20 min, remote full-tree verification 3 min, native/smoke probes 2 min, launch/handshake 30 s, cancellation-and-join 10 s, and total cold bootstrap 30 min. (E-M1-BUDGET-DECISION-001)
- Limit incremental transfer/extraction memory to 64 MiB on the desktop and 32 MiB on the remote, excluding the launched relay's measured steady-state runtime; no single buffer exceeds 1 MiB. (E-M1-BUDGET-DECISION-001)
- Limit SFTP to four in-flight files and four bootstrap channels by default, reduce to one after
the existing
MaxSessions=1capability result, and never exceed eight open file handles in either process. (E-M1-BUDGET-DECISION-001) - Require warm-connect p95 to be no more than 100 ms or 10% slower than paired legacy, whichever allowance is larger. Cold p95 must not exceed the smaller of the 30-minute hard cap or 115% of the measured bytes/throughput lower bound plus five minutes at 1/10/100 Mbps and 50/100/200 ms RTT. Offline/connectivity classification completes within 20 s, and legacy starts within 10 s after any eligible failure is classified and bundled work is joined. (E-M1-BUDGET-DECISION-001)
- Keep automatic legacy fallback through at least two stable releases and 30 days after any separately authorized default-on change. Narrowing fallback or removing legacy requires a separate review plus complete matrix, soak, support, and rollback evidence. (E-M1-BUDGET-DECISION-001)
- Use existing per-SSH-target configuration for rollout control; do not add a rollout backend. This closes the control-mechanism decision, not its implementation. (E-M1-ROLLOUT-DECISION-001)
- Define offline/missing-asset behavior: use a verified client cache without GitHub or remote
egress; otherwise classified offline/404/cache-unavailable errors may use proven legacy in
Beta
auto. If legacy prerequisites also fail, return both stage codes and actionable retry, update, or disable-Beta guidance without hiding the original error. Integrity failures never fallback. (E-M1-BUDGET-DECISION-001)
Per-target Beta rollout decision
Decision owner: Codex implementation owner for #8450. Decision authority: worktree owner direction on 2026-07-14. The purpose is to gather real-host evidence without changing behavior for existing SSH users or making all of a user's hosts depend on one experimental path.
- Keep
legacyas the persisted and effective default for every existing and newly added SSH target. An absent or unknown configuration value must deserialize conservatively tolegacy. (E-M1-ROLLOUT-DECISION-001) - Expose the bundled-preferred path as an off-by-default option on SSH target add and edit surfaces, using the same Beta-tag treatment as existing Beta features and storing the choice per target rather than as a global experiment. (E-M1-ROLLOUT-DECISION-001)
- Represent the persisted choice as an extensible mode such as
legacy | bundled-auto, not a boolean. Keep forcedbundledas a separate engineering/support diagnostic and do not expose it as the normal Beta choice. Exact schema naming remains an implementation detail. (E-M1-ROLLOUT-DECISION-001) - Apply a setting change only to the next connection or explicit reconnect. Never hot-swap the relay underneath a live PTY, watcher, RPC, reconnect, or reattach generation. (E-M1-ROLLOUT-DECISION-001)
- In Beta mode, allow only classified availability/compatibility failures to enter proven legacy automatically. Integrity/security failures remain fail-closed; recovery is an explicit local action that disables Beta for that target and reconnects through legacy. (E-M1-ROLLOUT-DECISION-001)
- Require a separate reviewed rollout decision and completed evidence gates before changing the default for any tuple. Shipping the Beta setting does not authorize default-on or legacy removal. (E-M1-ROLLOUT-DECISION-001)
Decision evidence required: reviewed decision record with owners, dates, rationale, and affected matrix cells.
Milestone 2 — Define the Artifact, Manifest, and Identity Contract
Suggested modules are provisional; update this file before choosing different names.
Work Package 1 complete — 2026-07-14, Codex implementation owner: implemented the pure manifest schema, canonical unsigned bytes/signature verification, content identity, and fail-conservative platform/libc selector with hostile-input tests only. No deploy/resolver call site or bundled tuple is enabled in this package. Local and exact-head draft PR evidence is recorded under E-M2-RED-001, E-M2-CONTRACT-001, and E-M2-CI-001.
Manifest schema
- Add a versioned relay artifact schema in
src/main/ssh/ssh-relay-artifact-schema.ts. (E-M2-CONTRACT-001) - Include schema version, exact Orca build tag, relay protocol version, runtime content ID, OS, architecture, libc family/version requirements, minimum OS/kernel requirements, Node version, dependency versions, archive name, archive size, expanded size, file count, and archive SHA-256. (E-M2-CONTRACT-001)
- Include every runtime file’s relative path, type, size, SHA-256, and required executable mode. (E-M2-CONTRACT-001)
- Include signing key ID, signature algorithm/version, creation timestamp, and provenance/SBOM references without making wall-clock time part of runtime identity. (E-M2-CONTRACT-001)
- Include target-native code-signing verification attestation, policy/tool identity, and the exact attested byte hashes inside the signed manifest. (E-M2-CONTRACT-001)
- Reject duplicate tuple entries, duplicate/case-colliding paths, unsafe Windows names, unsupported schema versions, missing required files, extra native platform packages, and inconsistent aggregate sizes. (E-M2-CONTRACT-001)
- Define exact archive naming for stable, RC, and perf builds. (E-M2-CONTRACT-001)
- Define exact direct release URL construction. Runtime code must not call the GitHub API or use
a mutable
latestURL. (E-M2-CONTRACT-001)
Content identity
- Compute the content identity from canonical full-runtime metadata and file digests, including Node, relay entries, native modules, helper executables, and runtime JavaScript. (E-M2-CONTRACT-001)
- Prove changing only Node changes the identity. (E-M2-CONTRACT-001)
- Prove changing only
node-ptychanges the identity. (E-M2-CONTRACT-001) - Prove changing only
@parcel/watcherchanges the identity. (E-M2-CONTRACT-001) - Prove changing only
relay-watcher.jschanges the identity. (E-M2-CONTRACT-001) - Prove mode changes for executable files change the identity or are otherwise authenticated. (E-M2-CONTRACT-001)
- Prove metadata that should not affect execution does not create nondeterministic identities. (E-M2-CONTRACT-001)
- Update remote directory parsing and GC rules for the new mode-qualified identity without breaking legacy directory recognition.
Archive safety
- Permit only regular files and explicitly declared directories; reject devices, FIFOs, sockets, hard links, and symlinks unless a separately reviewed safe policy is adopted.
- Reject absolute paths,
.., drive/UNC paths, path separators inappropriate for the local extraction platform, Windows alternate data streams, device names, trailing spaces/dots, and case-fold collisions. - Enforce compressed size, expanded size, file count, nesting depth, and per-file limits before and during extraction.
- Verify the extracted tree exactly matches the manifest with no missing or extra files.
- Add deterministic schema, identity, canonicalization, URL, and hostile-archive tests.
Completion evidence required: schema and test files, red/green evidence, canonical test vectors, and reviewed compatibility contract.
Milestone 3 — Build Minimal Self-Contained Runtime Archives
In progress — 2026-07-14, Codex implementation owner: isolate target-native runtime assembly, archive inspection, bundled-Node/native-module/PTY/watcher smoke, SBOM, and provenance capabilities behind purpose-named scripts and CI artifacts. No release publication, desktop resolver, SSH transfer, install, fallback, rollout setting, or tuple enablement belongs in this package.
Active sub-gate — 2026-07-14, Codex implementation owner: exact-head run 29345126283 proves all
six target-native artifact/executable jobs, including normal Windows x64/arm64 settlement and
unpublished upload. E-M3-REPRODUCIBILITY-LOCAL-001 proves the bounded comparator requires two
independently verified clean outputs and exact type/mode/size/SHA-256 equality for the runtime tree,
archive, identity, SPDX, and provenance before uploading only the first output. Exact-head run
29347236627 first exposed native reproducibility and Windows parser failures. Diagnostic run
29348424235 then passed the parser/contracts on all six runners, kept both Linux tuples equal, and
isolated the first native differences to macOS pty.node and Windows conpty_console_list.node
under E-M3-REPRODUCIBILITY-DIAGNOSTIC-CI-RED-001. Artifact consumers, publication, the
repository-wide node-pty patch, and the legacy/default path remain unchanged.
Active correction — 2026-07-14, Codex implementation owner: exact-head run 29351557922 proves
the parser and /Brepro correction on both Windows architectures, with complete equality on x64.
Windows arm64 builds, verifies, and smokes both complete outputs but first differs at copied-artifact
conpty_console_list.node, so the comparator rejects the cell and uploads neither output under
E-M3-REPRODUCIBILITY-WINDOWS-ARM64-CI-RED-001. The active bounded package adds a test-covered PE
mismatch diagnostic before cleanup: hashes, sizes, coalesced differing byte ranges, and relevant PE
headers only, with bounded reads/output and no failed-binary upload. Exact-head repeat run
29352510414 reproduces the same arm64-only drift while all five controls compare and upload under
E-M3-REPRODUCIBILITY-WINDOWS-ARM64-REPEAT-CI-RED-001. No comparator weakening, post-build
normalization, producer correction, repository-wide node-pty change, tuple enablement, or production
consumer is authorized without the diagnostic evidence. Exact implementation commit 39ee3451b is
locally green under E-M3-WINDOWS-PE-DIAGNOSTIC-LOCAL-001. Exact-head run 29353432240 proves the x64
control and real arm64 parser, but its 128 detailed ranges are exhausted by .text; the active
diagnostic-only correction adds bounded full-scan section totals/samples before any producer change.
Exact implementation commit cd7f94136 is locally green under
E-M3-WINDOWS-PE-FULL-SCAN-LOCAL-001. Exact-head run 29354676731 then classifies the complete
arm64 drift under E-M3-WINDOWS-PE-FULL-SCAN-CI-RED-001: 2,879 one-byte .text differences at
16-byte intervals plus 68 /Brepro-derived metadata bytes, with five controls reproducible and
uploaded and no rejected arm64 upload. Exact implementation commit 6546f54d5 applies the native
toolchain's reproducible compiler and linker settings only to the copied node-pty binding.gyp and
is locally green under E-M3-WINDOWS-COMPILER-DETERMINISM-LOCAL-001. Exact-head run 29355973362 then
kept five controls reproducible but reproduced the identical Windows arm64 PE drift under
E-M3-WINDOWS-COMPILER-DETERMINISM-CI-RED-001. Exact implementation commit 0d3a0c9d3 now
fail-closed verifies how those settings reach the generated conpty_console_list.vcxproj and adds
bounded paired ARM64 disassembly after a mismatch under E-M3-WINDOWS-MSBUILD-DISASSEMBLY-LOCAL-001;
no second producer correction is justified before the target-native evidence. Exact-head run
29357355064 proves both generated option blocks twice on Windows x64 but fails closed on native
Windows arm64 before staging because the Release group lookup does not accept the runner's lowercase
arm64 platform spelling (E-M3-WINDOWS-MSBUILD-PLATFORM-CASE-CI-RED-001).
Exact-head run 29358223742 then proves that correction on native Windows arm64 and retains all five
reproducible controls. Both arm64 clean builds log the required compiler/linker options, assemble,
verify, and execute, but strict comparison still rejects conpty_console_list.node and uploads no
arm64 artifact. The complete PE scan reports 5,826 differing bytes: 5,758 bytes across 2,879
two-byte .text ranges exactly 16 bytes apart plus 68 derived COFF/debug/CodeView bytes. Paired
disassembly proves each 16-byte function thunk has byte-identical adrp x16, add x16, and
br x16 instructions; only the unreachable fourth instruction changes from udf #0x24d to
udf #0x16d (E-M3-WINDOWS-ARM64-THUNK-DISASSEMBLY-CI-RED-001).
Exact-head run 29359948742 proves MSBuild.exe -getProperty:LinkIncremental returns an empty value
after each native Windows build. The strict parser rejects that value before staging on x64 and
arm64; all four POSIX controls compare exactly and upload, and neither Windows job uploads. This is
valid negative evidence under E-M3-WINDOWS-LINK-INCREMENTAL-CI-RED-001, but an unset evaluated
property does not classify the actual linker command or authorize a producer change.
In progress — 2026-07-14, Codex implementation owner: the disproved property oracle is replaced
locally by a bounded, post-build parser for the target's actual MSBuild linker-command tracking
record under E-M3-WINDOWS-LINK-COMMAND-TRACKING-LOCAL-001. The file read is capped at 256 KiB plus
one rejection byte; logs contain only an allowlisted summary of /INCREMENTAL, /GUARD, /DEBUG,
/OPT, /Brepro, and /experimental:deterministic switches; missing, duplicate, oversized,
malformed, or ambiguous inputs fail before staging. The active gate is the exact-head six-cell
native run. Retain the existing architecture, generated-option, strict comparison, and no-upload
gates. Do not normalize bytes, change the producer, modify repository-wide node-pty, or connect a
production consumer.
Exact-head run 29361673339 proves the assumed fixed tracking path is absent on both native Windows
architectures after the target compiles successfully. The active correction must discover
link.command.1.tlog candidates under a bounded build-tree entry/depth/cardinality budget, select
exactly one whose bounded decoded record names conpty_console_list.node, and retain the existing
strict parser and no-upload boundary. It must not log command contents or authorize a producer
change (E-M3-WINDOWS-LINK-COMMAND-PATH-CI-RED-001).
The bounded discovery correction is locally green under E-M3-WINDOWS-LINK-COMMAND-DISCOVERY-LOCAL-001: it scans at most 10,000 entries and eight levels, rejects symbolic links and more than 32 tracking candidates, reads each candidate under the existing 256 KiB cap, and requires exactly one exact target-output match before strict parsing. The active gate is now a new exact-head native run; no producer change is authorized locally.
Exact-head run 29362672415 proves both native Windows builds reach the discovery gate after target
compilation but reject because scanning from the entire generated build tree encounters unrelated
dependency directories beyond depth eight. All four POSIX controls compare and upload. The active
correction may narrow only the traversal root to build/Release, the output tree where both logs
show MSBuild emitted conpty_console_list.node; every existing depth, entry, candidate, byte,
encoding, target-cardinality, parser, comparator, and no-upload bound remains unchanged
(E-M3-WINDOWS-LINK-COMMAND-DISCOVERY-CI-RED-001).
The correction now scopes the same bounded discovery to build/Release only and is locally green
under E-M3-WINDOWS-LINK-COMMAND-RELEASE-ROOT-LOCAL-001. No budget, parser, producer, comparison,
staging, upload, legacy, or production behavior changed. The active gate is another exact-head
six-cell native run.
Exact-head run 29363423068 proves the scoped discovery on both native Windows runners. Both clean
builds on both architectures select three tracking candidates under 82 Release-tree entries and
report the same allowlisted command summary: /brepro, /debug, /experimental:deterministic,
and /guard:cf, with no explicit /incremental switch. Windows x64 and all four POSIX controls
compare and upload; Windows arm64 still fails strict comparison at the same 2,879 linker thunks and
uploads nothing (E-M3-WINDOWS-LINK-COMMAND-RELEASE-ROOT-CI-RED-001). Because /DEBUG may imply
incremental linking without an explicit command switch, the next bounded diagnostic records only
the exact target .ilk file's presence and size from the already bounded clean Release tree before
any copied-artifact producer change.
Each runtime must contain only the executable closure required by the relay.
- Replace or extend
config/scripts/build-relay.mjswithout weakening its existing relay and watcher content-hash guarantees. - Add a clearly named runtime assembly script, for example
config/scripts/build-ssh-relay-runtime.mjs. (E-M3-RUNTIME-LOCAL-001) - Pin Node and verify downloaded source/binary checksums and upstream signatures. (E-M3-NODE-PROVENANCE-001; real archive execution remains a separate per-tuple gate)
- Extend the immutable Node input contract for Windows to include the signed exact-version
headers archive and tuple-specific
node.lib; verify/copy them into an exclusive local build root and configurenode-gypto fail rather than fetch an unstaged input. (E-M3-WINDOWS-INPUT-001; successful target-native offline build remains a per-tuple gate) - Build Orca’s patched
node-pty@1.1.0against the exact bundled Node runtime. - Assert Orca-required patched exports/diagnostics exist; do not silently use an upstream prebuild that omits the patch.
- For Windows, copy the tuple-architecture
conpty.dllandOpenConsole.exefrom the pinned node-pty source intobuild/Release/conpty, hash them into the runtime identity as native runtime files, and prove PTY spawn/resize/exit withuseConptyDll: true. Do not substitute a system-ConPTY smoke for the production path. (E-M3-WINDOWS-CONPTY-GAP-001, E-M3-WINDOWS-CI-001) - Include exactly one compatible
@parcel/watcher@2.5.6native optional package. - Include relay JavaScript, watcher child, required runtime JavaScript closure, licenses, SBOM, provenance, and runtime metadata.
- Exclude package managers, development dependencies, compilers, sources, caches, build directories, and Orca-built debug symbols unless an approved diagnostics requirement needs them. Preserve verified official Node executable bytes without stripping or rewriting them, even when the upstream binary contains debug metadata.
- Make POSIX
tar.xzoutput deterministic for the same tree, epoch, and pinned compression toolchain; keep Windows zip determinism as an open per-tuple gate. (E-M3-RUNTIME-LOCAL-001) - Verify required executable modes before archiving. (E-M3-RUNTIME-LOCAL-001)
- Sign native code according to the platform decisions in Milestone 1.
- Verify platform-native signatures/policy on target-native runners after signing and before aggregation; attest the exact verified bytes for the signed manifest.
- Run target-native archive inspection and target-runtime smoke before upload for every current glibc/macOS/Windows candidate. (E-M3-RUNTIME-LOCAL-001, E-M3-CI-001, E-M3-WINDOWS-CI-001)
Per-tuple build and executable proof
| Runtime tuple | Build/provenance | Bundled Node | node-pty load + real PTY |
Watcher events | Oldest baseline | Native trust | Evidence |
|---|---|---|---|---|---|---|---|
| linux-x64-glibc | [x] | [x] | [x] | [x] | [ ] | [ ] | E-M3-CI-001 |
| linux-arm64-glibc | [x] | [x] | [x] | [x] | [ ] | [ ] | E-M3-RUNTIME-LOCAL-001; E-M3-CI-001 |
| linux-x64-musl | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | — |
| linux-arm64-musl | [ ] | [ ] | [ ] | [ ] | [ ] | [ ] | — |
| darwin-x64 | [x] | [x] | [x] | [x] | [ ] | [ ] | E-M3-CI-001 |
| darwin-arm64 | [x] | [x] | [x] | [x] | [ ] | [ ] | E-M3-CI-001 |
| win32-x64 | [x] | [x] | [x] | [x] | [ ] | [ ] | E-M3-WINDOWS-CI-001 |
| win32-arm64 | [x] | [x] | [x] | [x] | [ ] | [ ] | E-M3-WINDOWS-CI-001 |
Rules:
- Real hardware or native virtualized execution is required for release promotion. QEMU or cross-compilation may add coverage but cannot fill the evidence column alone.
- A tuple without a trustworthy runtime source or real runner stays disabled.
- Every archive executes the exact bundled Node, loads both native dependencies, spawns a real PTY, performs input/resize/exit, and observes create/modify/rename/delete watcher events.
- Every build records compiler/toolchain/container image digests and runner architecture.
Milestone 4 — Make Relay Artifacts Prerequisites of Desktop Builds
- Add target-native runtime build jobs for every enabled tuple; do not treat a cross-build alone as native execution evidence.
- Add platform-native signing jobs. Signed macOS and Windows runtime bytes must return as immutable outputs before final hashes are computed.
- Add one fail-closed aggregate job that waits for all required native build/signing outputs, validates them, computes final hashes, builds the canonical manifest, and signs it.
- Make Linux, Windows, and macOS desktop build jobs depend on the successful aggregate output.
- Download the immutable manifest artifact into every desktop build workspace.
- Embed the exact signed manifest and accepted public keys in the packaged desktop.
- Prove all desktop variants embed byte-identical manifest contents.
- Ensure development builds can use a deterministic local unsigned/development manifest without weakening official-build verification.
- Upload the exact prebuilt runtime bytes—not rebuilt equivalents—to the same draft GitHub Release as the app.
- Aggregate platform job outputs without clobbering or duplicating asset names.
- Extend
config/scripts/verify-release-required-assets.mjsor add a narrowly named relay gate that verifies every enabled asset, manifest, signature, size, and upload state. - Download every draft asset back through the authenticated release API, verify byte identity, and execute the archive before allowing publication.
- Confirm stable, RC, and perf tag identities remain exact and cannot cross channels.
- Confirm a partial or failed relay build leaves the release draft and blocks publication.
- Confirm artifact upload retries do not change signed bytes or silently replace the manifest.
- Define bounded retry/timeout behavior for every native build, signing, aggregate, upload, and read-back job; exhaustion must block downstream jobs.
- Make manual signing approval absence, denial, or timeout fail closed rather than allowing an unsigned or stale asset through the aggregate.
- Rehearse signing-service failure and recovery of the same draft without changing already signed bytes or accidentally publishing it.
Completion evidence required: release workflow tests, a draft rehearsal, read-back hashes, embedded manifest extraction from every packaged app, and blocked-publication failure rehearsal.
Milestone 5 — Implement Desktop Artifact Selection, Download, and Cache
Suggested concrete modules:
src/main/ssh/ssh-relay-artifact-selector.tssrc/main/ssh/ssh-relay-libc-detection.tssrc/main/ssh/ssh-relay-artifact-download.tssrc/main/ssh/ssh-relay-artifact-cache.tssrc/main/ssh/ssh-relay-artifact-extraction.ts
Platform and libc selection
- Reuse current OS/architecture detection without changing supported relay-platform parsing.
- Add marked, noise-resistant, no-Node libc probes.
- Prefer
getconf GNU_LIBC_VERSIONwhen present; parse only output following Orca’s marker. - Detect musl through marked
ldd --versionoutput and known loader paths without treating arbitrary startup text as evidence. - Validate required libc/libstdc++/kernel/OS versions against manifest constraints.
- Treat absent, ambiguous, conflicting, or unparseable results as unknown and choose proven
legacy behavior in
automode. - Cover GNU coreutils, BusyBox, Alpine, containers, old glibc, Rosetta, Windows, macOS, startup
noise, missing commands, localization, cancellation, and
MaxSessions=1.
Manifest verification and exact URL resolution
- Load the embedded manifest for official builds and verify its signature before trusting fields.
- Verify the manifest-authenticated target-native attestation and exact byte hashes portably; do
not assume a macOS client can run Authenticode tooling or a Windows client can run
codesign. - Resolve the expected tuple and content ID while fully offline.
- Construct the exact
/releases/download/<tag>/<asset>URL without an API lookup. - Reject redirects that violate the approved GitHub release-asset origin policy.
- Ensure authorization, cookies, proxy credentials, and custom headers do not leak across redirect origins.
- Use Electron networking that respects supported system proxy and certificate behavior.
Download and local cache
- Store archives and extracted trees under an app-owned cache, keyed by signed content identity.
- Stream downloads into exclusive temporary files; never buffer a full runtime in memory.
- Apply download size and time budgets while streaming.
- Verify archive SHA-256 before extraction.
- Extract into an exclusive temporary directory with all archive-safety checks from Milestone 2.
- Verify the exact expanded tree before atomically publishing the cache entry.
- Coordinate cache ownership across multiple Orca processes and windows.
- Recover stale download/extraction locks without deleting an active writer.
- Never select partial files, partial directories, or entries with a failed verification record.
- Re-verify cached metadata and expected identity before use; define when full file rehashing is required.
- Implement bounded eviction that never removes an in-use entry.
- Handle read-only cache, permission failures, disk full, quota, inode exhaustion, cancellation, crash, corruption, and concurrent download deterministically.
- Preserve
ORCA_RELAY_PATHfor explicit development/test use with an official-build safety boundary. - Prefetch only last-known target tuples under an explicit size/network policy; prefetch must not block app startup or a normal connection.
Required offline/cache cases
| Remote runtime | Local verified cache | Client internet | Expected bundled behavior | Legacy/error behavior | Evidence |
|---|---|---|---|---|---|
| Present, matching | Any | Offline | Launch remote cache without GitHub | None | — |
| Missing | Present | Offline | Transfer local cache over SSH | None | — |
| Missing | Missing | Online | Download locally, verify, transfer | Fallback only on eligible failure | — |
| Missing | Missing | Offline | Bundled unavailable | Proven legacy or precise error | — |
| Partial/corrupt | Present | Offline | Quarantine remote entry; replace from verified local cache | Fail closed if verified reinstall fails; no automatic legacy | — |
| Missing | Corrupt | Online | Quarantine local entry; redownload and fully verify | Fail closed if recovery fails; no automatic legacy | — |
| Missing | Corrupt | Offline | Quarantine and reject corrupt cache | Fail closed; no automatic legacy | — |
| Corrupt | Missing | Any | Quarantine remote entry; recover only from newly verified bundled bytes | Fail closed if recovery is unavailable/fails | — |
Milestone 6 — Add Bounded Runtime Transfer for Every SSH Transport
Current behavior must not be assumed adequate for a much larger runtime:
- POSIX system SSH currently streams a tar archive and requires remote
tar. - Windows system SSH currently collects the tree and sends one JSON/base64 package.
- SFTP currently walks files serially and does not preserve executable modes.
Shared transfer contract
- Define one transport-neutral source-tree contract based on the verified manifest.
- Pre-scan and reject local source mutation, symlinks, special files, extra files, and path collisions before creating remote files.
- Stream files with bounded buffers; prohibit whole-tree memory materialization.
- Pass one AbortSignal through enumeration, channel creation, reads, writes, permission repair, and remote cleanup.
- Close and await every local stream, SSH channel, child process, SFTP session, and cleanup task on success, failure, cancellation, and timeout.
- Track transferred bytes/file counts for progress and bounded diagnostics without logging paths.
- Restore every executable mode declared by the manifest, including bundled Node and
spawn-helper, before validation. - Require exclusive per-file staging so no concurrent writer or launcher can observe a partial file as complete.
POSIX system SSH
- Capability-probe remote tar with a narrow cache scoped to the SSH host/connection.
- Keep streaming tar as an optional fast path when proven available and compatible.
- Add a no-tar bounded file-stream path: frame each manifest file locally, open an authenticated SSH exec channel, and stream raw bytes through stdin into its exclusive staged path using only the declared POSIX shell/file primitives.
- Prove the no-tar path does not invoke remote Node, Python, Perl, archive tools,
sha256sum, orshasum. - Preserve remote path quoting and avoid shell injection for spaces and non-ASCII homes.
- Verify local and remote tar failures, pipeline failures, and cancellation are all observed and joined.
- Fail with a compatibility classification when a required POSIX primitive is missing or has incompatible semantics; do not improvise a text/base64 transfer.
Windows system SSH
- Replace whole-tree JSON/base64 buffering with a framed or per-file bounded binary stream.
- Implement against the declared PowerShell/.NET baseline using binary stdin/file APIs and exclusive staged paths; do not depend on implicit console text encodings.
- Avoid command-line length, PowerShell string, and full-input buffering limits.
- Handle case-insensitive collisions, reserved names, long paths, endpoint-protection locks, and partial writes.
- Prove binary fidelity without relying on text encoding.
- Fail with a compatibility classification when the declared PowerShell/.NET primitives are missing or incompatible.
SFTP
- Add bounded concurrency without exceeding restrictive server session/channel limits.
- Preserve per-file abortability and close handles deterministically.
- Restore modes after upload and verify mode-repair failure is fatal before finalization.
- Compare serial and bounded-concurrency behavior on high-latency SSH.
Transfer validation
- Test zero-byte, large, many-small-file, and maximum-allowed trees.
- Test required-command absence one primitive at a time on POSIX and Windows.
- Test supported and unsupported BusyBox command variants, including byte fidelity and exit-code behavior.
- Test source mutation and local symlink replacement during upload.
- Test network interruption at beginning, middle, final file, permission repair, and sentinel write.
- Test local and remote disk full, quota, inode exhaustion, read-only target, noexec target, Windows antivirus lock, and SSH channel closure.
- Measure peak RSS, bytes buffered, open file handles, channels, duration, and cancellation settlement against Milestone 1 budgets.
- Prove cancelled transfer performs no later writes.
Milestone 7 — Install, Verify, Launch, Reconnect, and Garbage-Collect
Suggested concrete modules:
-
src/main/ssh/ssh-relay-runtime-transfer.ts -
src/main/ssh/ssh-relay-runtime-validation.ts -
src/main/ssh/ssh-relay-bootstrap-mode.ts -
Refactor
ssh-relay-deploy.tswithout adding a max-lines disable; split by domain responsibility where necessary. -
Resolve expected bundled content identity before remote install-state probing.
-
Verify embedded manifest signature, tuple, limits, archive SHA-256, and exact extracted tree on the client before transfer begins.
-
Use mode-qualified, content-addressed remote directories and locks.
-
Upload into a mode-qualified partial/staging directory that no launcher or GC can treat as complete.
-
Treat local verification plus authenticated SSH transfer into exclusive staging as the pre-execution integrity boundary; document that a hostile authenticated account is out of scope.
-
Do not require a remote hash utility. Run bundled Node from the transferred staging path as the first staged binary execution, verify its exact version, and use it to hash every manifest file.
-
Compare the complete staged-tree sizes and SHA-256 values before any sentinel or publish step.
-
Load
node-ptyand@parcel/watcherthrough bundled Node. -
Repeat target-native execution/policy probes before finalization; any native-trust failure is an integrity/security failure even though transfer may already have occurred.
-
Run a minimal real PTY input/resize/exit smoke and watcher event smoke before finalization.
-
Write structured
.install-completecontents containing schema, mode, content ID, manifest digest, and validation version; do not use an empty sentinel. -
Assert the ordering: full-tree hash comparison, native loads, PTY/watcher smoke, then completion sentinel and atomic publication. No earlier stage may write a success sentinel.
-
Atomically publish the completed install or otherwise prove no observer can see it as complete before validation finishes.
-
On warm reconnect, require the expected structured sentinel identity plus required-file presence and signed-manifest size metadata before treating the directory as initially validated.
-
Do not full-tree rehash every warm launch. Trust the structured initial-install proof under the completed-directory immutability assumption to protect latency; explicitly document that the sentinel is not ongoing proof against post-install filesystem mutation.
-
Treat any detected warm-cache absence, size/hash mismatch, unexpected file, or changed sentinel as integrity failure: quarantine it, recover only from freshly verified bundled bytes, and fail closed without automatic legacy if recovery cannot complete.
-
Launch
relay.jswith bundled Node and an environment that cannot accidentally resolve remote user packages ahead of bundled dependencies. -
Preserve protocol-handshake and version-mismatch behavior.
-
Preserve
MaxSessions=1sequential fallback for probes. -
Preserve concurrent install locking, stale-lock recovery, cross-version isolation, reconnect, PTY reattach, watcher isolation, and best-effort GC.
-
Ensure GC recognizes bundled, legacy, partial, locked, active, and malformed directories and never deletes a live version.
-
Ensure a failed bundled install never mutates a completed legacy install or running relay.
-
Confirm primary-path command capture contains no npm, curl, wget, registry, compiler, Python, system-Node,
sha256sum, orshasuminvocation.
Completion evidence required: deterministic install/failure tests, built-runtime harness, live SSH connect/reconnect/upgrade/downgrade, PTY/watcher proof, and command audit.
Milestone 8 — Implement a Safe, Explicit Fallback State Machine
Modes:
auto: bundled primary; eligible availability/compatibility failures may use proven legacy.bundled: bundled only; fail with exact stage and recovery guidance.legacy: current embedded relay plus coherent remote Node/npm behavior.
The public per-target Beta choice maps bundled-auto configuration to internal auto behavior.
Missing, unknown, or disabled configuration maps to legacy; forced bundled remains an
engineering/support control.
- Add the versioned per-target runtime-mode field and prove existing, missing, malformed,
imported, and newly created target configurations resolve to
legacyunless explicitly opted in. - Add the Beta-tagged option to SSH target add and edit surfaces using the existing design-system Beta treatment; persist it only for that target.
- Prove the add-target control is visibly off, the edit-target control reflects only that target's persisted mode, and saving or reconnecting one target cannot change another target.
- Prove an off, absent, unknown, malformed, existing, or imported setting routes directly through the current legacy bootstrap without entering bundled manifest, cache, download, transfer, or install work.
- Prove toggling the option does not mutate or restart a live relay and takes effect only on the next connection or explicit reconnect.
- For fail-closed Beta errors, provide an explicit local “disable Beta and reconnect” recovery action that updates the target before starting legacy; never disguise it as automatic fallback.
- Record privacy-safe tuple, transport, stage, duration, outcome, and fallback reason under existing telemetry consent without hostname, username, path, command, or target identity.
State and cancellation
- Model explicit states for manifest resolution, local-cache lookup, download, extraction, transfer, remote verification, launch, bundled cleanup, legacy bootstrap, and connected.
- Give every state a named timeout budget and child AbortSignal derived from one parent.
- Replace timeout-only
Promise.racebehavior where underlying deployment can continue after the caller fails. - On eligible bundled failure, abort, close, and await all bundled work before legacy begins.
- Invalidate callbacks by generation so late completion cannot write a sentinel, launch a relay, report success, or mutate cache/install state.
- Use separate bundled/legacy identities, locks, partial dirs, completion records, and GC rules.
- Ensure two simultaneous clients choosing different modes cannot modify one another’s install.
- Preserve the original bundled failure and fallback outcome in bounded diagnostics.
Failure classification
- Classify GitHub unavailable, client offline, asset missing, approved redirect failure, proxy failure, local cache unavailable, unsupported tuple, and bundled runtime incompatibility.
- Classify signature mismatch, archive hash mismatch, unsafe archive, extracted/transferred-tree mismatch, bundled-Node corruption, and native-signature failure as integrity/security failures.
- Permit automatic legacy only for explicitly classified availability/compatibility failures and only for remote tuples with current legacy evidence.
- Make every integrity/security failure fail closed in
auto; assert no legacy process, lock, partial directory, or diagnostic “fallback success” is created. - Never execute rejected bytes. Delete/quarantine them according to an explicit policy.
- If legacy prerequisites are unproved or fail, return an error that includes bundled stage, fallback stage, actionable recovery, and no sensitive paths.
- Forced
bundlednever silently changes mode. - Forced
legacynever performs a GitHub runtime download.
Race and fallback proof
- Timeout during download, extraction, SFTP transfer, system-SSH transfer, chmod, hash, PTY smoke, watcher smoke, sentinel write, and launch.
- Cancellation while a sibling connection waits on the bundled lock.
- Bundled failure while an old bundled relay remains live.
- Bundled failure while legacy install is complete and live.
- Legacy failure after bundled cleanup.
- App shutdown during every state.
- Assert zero post-fallback bundled writes, processes, channels, locks, and callbacks.
Milestone 9 — Diagnostics, Progress, Support, and Privacy
- Define stable stage codes for selection, manifest, cache, download, extraction, transfer, permission repair, remote hash, native probe, smoke, launch, fallback, and connected.
- Define stable fallback reason codes without embedding remote output, usernames, hostnames, IPs, repository names, or paths.
- Preserve exact low-level errors in local diagnostic logs with existing redaction boundaries.
- Add aggregate duration/byte/count metrics only through existing authorized diagnostics or telemetry mechanisms; do not imply authorization for a new backend.
- Provide progress labels for operations exceeding the style-guide thresholds; avoid flashing progress for warm cache hits.
- Keep connection controls disabled immediately while maintaining stable focus.
- Document
auto,bundled, andlegacysupport overrides and their intended support use. - Add troubleshooting for client offline, remote offline, missing asset, unsupported tuple, signature failure, noexec home, disk full, proxy, and fallback failure.
- Make user-visible wording state facts only after the corresponding stage result exists.
- Add tests for diagnostic bounds, redaction, stage ordering, duplicate suppression, and cancellation/fallback reporting.
Milestone 10 — Deterministic Test and Fault-Injection Coverage
Schema, selector, and trust
- Canonical manifest serialization golden vectors.
- Valid/invalid signatures, unknown key IDs, rotated keys, revoked keys, wrong tag, rollback, and unsupported schema.
- Valid/tampered/missing target-native trust attestations and attested-byte hash mismatches, verified from clients running a different OS than the target tuple.
- Every OS/architecture/libc selection plus unknown/conflicting/noisy probes.
- Minimum-version boundaries for libc, libstdc++, kernel, macOS, and Windows.
- Exact stable/RC/perf URL and channel mapping.
Cache and download
- 200 and approved redirects, redirect loop, wrong origin, missing
Location, 404, 429 with retry policy, 5xx, timeout, proxy auth, certificate failure, truncated body, oversized body, wrong content length, wrong hash, and deleted asset. - Cold, warm, offline, corrupt, partial, concurrent, multi-process, stale-lock, eviction, read-only, permission, local disk full, quota, and inode cases.
- Archive traversal, absolute path, symlink/hardlink/device, Windows name/path, case collision, archive bomb, too many files, deep nesting, unexpected file, and source mutation cases.
- Assert bad manifest signature, archive hash, archive safety, extracted-tree hash, and native
signature each fail closed in
autowithout entering legacy.
Install and fallback
- Full identity change and remote-directory change for every executable component.
- Lock first acquisition, waiter, concurrent probe, stale recovery, cancellation, and host isolation.
- Partial install is never complete; structured sentinel must match expected mode/content/schema.
- Transfer corruption is detected before finalization.
- Missing remote
sha256sum/shasumstill succeeds through bundled-Node full-tree hashing. - Corrupt one uploaded file after transfer and before verification; prove no sentinel is written and no relay launches.
- Corrupt or prevent execution of the transferred bundled Node; prove verification fails before sentinel and does not automatically enter legacy as an integrity failure.
- Corrupt local and completed remote caches; prove quarantine plus recovery from freshly verified bytes, or fail-closed behavior with zero automatic legacy when recovery is unavailable/fails.
- Mutate a warm remote file/sentinel and prove every detected case fails closed. Separately prove an unchanged warm path trusts initial-install proof without a full-tree rehash and meets latency.
- Instrument stage ordering and prove tree hash → native loads → PTY/watcher smoke → sentinel → publish/launch with no alternative success path.
- Existing legacy and bundled installs never overlap or mutate.
- All fallback transition and stale-generation cases from Milestone 8.
Relay behavior
- Protocol handshake and frame compatibility.
- PTY spawn, attach, input, resize, signal, exit, reconnect, and error mapping.
- Filesystem read/write/stat/readdir/search and bulk streaming.
- Filesystem watch registration, overflow, cancellation, crash isolation, and recovery.
- Git status/diff/blob/worktree/submodule/ignore and response streaming using Git 2.25-compatible commands and existing capability rules.
- Agent hooks, managed hook installation, remote CLI, preflight, port scan, subprocess, and aborts.
- Grace-period detach/reattach, two clients, app restart, remote restart, upgrade, downgrade, and GC.
Milestone 11 — Live Platform and Environment Matrix
Use a risk-based two-layer matrix. This does not claim every client × remote tuple combination. Every required cell must contain one or more evidence IDs rather than a bare checkmark or prose.
Layer A — every enabled remote tuple across both transport families
Each cell’s evidence must cover a native real runner, no Node/npm/compiler, blocked remote egress, PTY, watcher, every relay RPC family, reconnect/upgrade, and eligible legacy fallback. POSIX system SSH evidence includes the no-tar path; Windows system SSH is a mandatory distinct path.
| Remote tuple | Built-in SSH/SFTP evidence ID | System SSH evidence ID | MaxSessions=1 evidence ID |
Baseline/native-policy evidence ID |
|---|---|---|---|---|
| linux-x64-glibc | — | — | — | — |
| linux-arm64-glibc | — | — | — | — |
| linux-x64-musl | — | — | — | — |
| linux-arm64-musl | — | — | — | — |
| darwin-x64 | — | — | — | — |
| darwin-arm64 | — | — | — | — |
| win32-x64 | — | — | — | — |
| win32-arm64 | — | — | — | — |
Layer B — every supported client against representative remote families
Each supported client OS/architecture must prove resolver/cache behavior and both transfer families against representative POSIX and Windows remotes. This layer catches client-specific process, filesystem, proxy/certificate, executable-bit, quoting, and cache behavior without pretending to be a full Cartesian product.
| Client | Resolver/cache evidence ID | Built-in → POSIX evidence ID | Built-in → Windows evidence ID | System SSH → POSIX evidence ID | System SSH → Windows evidence ID |
|---|---|---|---|---|---|
| macOS x64 | — | — | — | — | — |
| macOS arm64 | — | — | — | — | — |
| Linux x64 | — | — | — | — | — |
| Linux arm64 | — | — | — | — | — |
| Windows x64 | — | — | — | — | — |
| Windows arm64 | — | — | — | — | — |
- Define and record the representative POSIX and Windows remotes used by Layer B.
- Require Windows remote/system-SSH and
MaxSessions=1evidence before any Windows remote tuple is enabled. - Reject promotion if any required cell still contains
—; do not roll up partial evidence into an unsupported “all combinations” claim.
Required environment variants
- Exact #8450: system Node without npm plus usable NVM below
.bashrcnon-interactive guard. - No Node, npm, Python, make, compiler, registry, curl, or wget.
- No tar,
sha256sum, orshasum; no-tar transfer and bundled-Node verification still succeed. - Remove each required POSIX and Windows bootstrap primitive in turn and verify deterministic compatibility classification.
- Remote egress denied at the network layer and audited for attempted connections.
~/.npmrcwithignore-scripts=true, broken registry, and read-only npm cache.MaxSessions=1, noisy startup, slow SSH, packet interruption, proxy jump, and system SSH.- Spaces, Unicode, long paths, case collisions, restrictive umask, read-only home, noexec home, disk quota, inode exhaustion, and endpoint-protection locks.
- Supported and unsupported BusyBox/Alpine primitive variants, old supported glibc boundary, containerized host, Rosetta, Windows OpenSSH, and enterprise native-code policy.
- Two Orca clients connecting/installing simultaneously.
- Existing live PTY during app/relay upgrade and downgrade.
- Remote reboot, app crash/restart, interrupted first install, stale lock, and GC with a live old relay.
Milestone 12 — Performance and Resource Regression Gates
Baseline measurements must be captured before product behavior changes.
- Record legacy cold install p50/p95, warm connect p50/p95, transferred bytes, remote CPU/RSS, desktop CPU/RSS, process/channel/file counts, and failure timeout on the same machines used for comparison.
- Measure bundled cold download + transfer, local-cache transfer, remote-cache launch, GitHub failure-to-fallback, and client-offline behavior.
- Test at 1, 10, and 100 Mbps with 50, 100, and 200 ms latency and defined loss/jitter.
- Prove remote-cache warm connect meets the numeric Milestone 1 budget.
- Prove local-cache transfer and cold download meet the numeric Milestone 1 budgets.
- Prove SFTP and system-SSH transfer peak memory remain bounded by the numeric budgets.
- Prove file count does not cause unbounded sequential round trips or channel fanout.
- Prove cache verification/eviction does not block Electron startup or the renderer main thread.
- Prove failed bundled attempts do not add an unacceptable delay before eligible legacy fallback.
- Record before/after results, machine identity, network shaping, commit SHA, command, raw artifact, and statistical interpretation.
- Add demotion thresholds for latency, memory, transfer flakes, cache corruption, and fallback delay.
Milestone 13 — Supply-Chain and Security Completion
- Write the explicit threat model and trust boundaries.
- Generate and publish an SBOM per runtime and aggregate release.
- Record build provenance, source revisions, toolchain/container digests, and native signatures.
- Verify official Node checksums/signatures before assembly and preserve native trust where possible.
- Verify Orca-built native code signatures on target macOS and Windows policies.
- Verify target-native attestation generation/read-back, signed-manifest authentication, portable client verification, and pre-finalization target policy probes on exact bytes.
- Exercise manifest key rotation and dual-key migration in a release rehearsal.
- Exercise compromised/revoked-key response by shipping a new desktop build with newly embedded
keys/manifest; prove there is no mutable freshness or
latestlookup. - Exercise anti-rollback across stable, RC, perf, desktop upgrade, and desktop downgrade.
- Add dependency and Node CVE monitoring with a named owner and response SLA.
- Exercise an emergency runtime refresh through a new desktop tag/build, embedded manifest, identity, release, download, remote coexistence, and GC; prove an installed old client remains pinned to its original manifest.
- Review archive parsing, redirect handling, cache permissions, local TOCTOU, remote quoting, native loading search paths, and diagnostic redaction.
- Complete security review before
autobecomes default for any stable tuple.
Milestone 14 — Release, Rollout, Rollback, and Fallback Retirement
Asset-only
- Publish complete runtime assets and signed manifest without production consumption.
- Run read-back, direct public URL, archive execution, and packaged-manifest comparison.
- Accumulate build/release flake and duration evidence.
- Rehearse native build/signing timeout, bounded retry success/exhaustion, manual approval absence/denial, signing failure, aggregate failure, and recovery of an unpublished draft.
Per-target Beta — legacy remains default
- Ship the Beta-tagged per-target option in RC and stable builds with every existing and new
target defaulting to
legacy. - Enable forced
bundledonly for engineering and support diagnostics; normal testers use the per-targetbundled-autoBeta choice. - Verify diagnostics and support recovery for every failure class.
- Run the full enabled tuple matrix and security/performance gates.
- Exercise forced
legacyrollback from the same build. - Accumulate approved privacy-safe Beta usage, success, classified fallback, integrity failure, latency, PTY/watcher, reconnect, and support evidence per exact tuple.
Future default-on evaluation — separately authorized
- Obtain a separate reviewed decision before changing any target's default from
legacy; this issue and the Beta implementation do not authorize that change. - Consider default
autoonly for tuples whose artifact, live matrix, Beta usage, and support evidence are complete. - Require three consecutive RC builds with no unexplained fallback, cache-corruption, PTY, watcher, reconnect, native-policy, or release failures.
- Test GitHub outage, client offline, remote offline, missing asset, unsupported tuple, and integrity failure from the packaged RC.
- Prove every integrity/security failure in that RC fails closed without automatic legacy.
- Confirm non-enabled tuples deterministically retain proven legacy behavior.
Stable Beta soak
- Publish the opt-in Beta to stable only after its release-blocking gates pass against exact
uploaded bytes; stable publication still leaves every target on
legacyunless opted in. - Keep automatic legacy fallback for at least the decided number of stable cycles.
- Monitor approved privacy-safe success/fallback/error signals and support reports.
- Define immediate demotion/rollback signals and owner.
- Exercise rollback without deleting live bundled or legacy remote installs.
- Do not narrow fallback until every retirement criterion below is satisfied.
Fallback retirement criteria
- Every claimed supported tuple has stable real-environment bundled proof.
- Both layers of the risk-based client/transport/environment matrix are complete with an evidence ID in every required cell.
- Soak duration and release count meet the Milestone 1 policy.
- No unexplained fallback remains.
- GitHub outage and offline behavior remain acceptable without hidden remote requirements.
- Support has a tested downgrade/recovery path for old app versions and old remote installs.
- A separate reviewed decision explicitly authorizes removing or narrowing remote npm fallback.
Proposed PR / Work-Package Split
Update status and evidence as work begins. Do not combine these into one large behavior switch.
| Work package | Scope | Default behavior change | Status | PR/evidence |
|---|---|---|---|---|
| 0. #8450 legacy fix | Coherent Node/npm selection and live repro | Fixes legacy selection only | Complete and CI-green in draft PR #8724 | E-M0-UNIT-002, E-M0-LIVE-002, E-M0-STATIC-002, E-M0-PR-001, E-M0-CI-001 |
| 1. Contract and selectors | Manifest schema, identity, platform/libc selection, hostile inputs | None | Complete and CI-green in draft PR #8728 | b9d80a4cb; E-M2-RED-001, E-M2-CONTRACT-001, E-M2-CI-001 |
| 2. Runtime builds | Per-tuple assembly, native smoke, SBOM/provenance/signing | None | Draft PR #8741; native target .ilk evidence pending |
e7d9a1c8d; E-M3-WINDOWS-INCREMENTAL-DATABASE-LOCAL-001 |
| 3. Release publication | Prerequisite DAG, embedded manifest, draft upload/read-back gates | Asset-only | Not started | — |
| 4. Desktop resolver/cache | Verified download, extraction, cache, offline behavior | None/forced mode only | Not started | — |
| 5. Transfer/install | Bounded transports, structured sentinel, bundled launch behind per-target Beta/forced mode | Per-target opt-in only | Not started | — |
| 6. Fallback/diagnostics | Abort-and-join state machine, mode isolation, reason codes, target-mode configuration/UI | Per-target Beta only | Not started | — |
| 7. Live gates/rollout | Matrix, security, performance, release promotion | Per-tuple staged | Not started | — |
Every PR must document:
- Named invariant and motivating issue.
- Exact product behavior changed and deliberately unchanged.
- Performance-risk inventory and numeric budgets.
- Correctness oracle and exact commands.
- Platform/provider/transport coverage: covered, unaffected, or accepted gap.
- Red/green evidence where a bug or failure contract is added.
- Residual gaps and fallback behavior.
- Rollback/demotion rule.
- Checklist and HTML plan updates.
- No unrelated worktree changes included.
Verification Command Inventory
Do not mark commands passed here until they have actually run on the implementation commit. Add new focused commands as their scripts/tests are introduced.
Existing focused commands
pnpm exec vitest run --config config/vitest.config.ts src/main/ssh/ssh-remote-node-resolution.test.ts(E-M0-UNIT-001)pnpm exec vitest run --config config/vitest.config.ts src/main/ssh/ssh-relay-native-deps-install.test.ts(E-M0-UNIT-001)pnpm exec vitest run --config config/vitest.config.ts src/main/ssh/ssh-relay-versioned-install.test.ts(E-M0-UNIT-001)pnpm exec vitest run --config config/vitest.config.ts src/main/ssh/ssh-relay-deploy.test.ts(E-M0-UNIT-001)pnpm exec vitest run --config config/vitest.config.ts src/main/ssh/ssh-relay-cross-version-isolation.test.ts(E-M0-UNIT-001)pnpm exec vitest run --config config/vitest.config.ts src/main/ssh/ssh-remote-platform-detection.test.ts(E-M0-UNIT-001)pnpm exec vitest run --config config/vitest.config.ts src/relay/pty-handler.test.ts src/relay/fs-handler.test.ts src/relay/subprocess.test.tspnpm run build:relay(E-M0-LIVE-001)node config/scripts/relay-watcher-fault-harness.mjspnpm run test:e2e:ssh-docker-watcher-isolationpnpm run test:e2e:ssh-docker-perfpnpm run typecheck(E-M0-STATIC-001, E-M0-STATIC-002, E-M0-CI-001)pnpm run lint(E-M0-STATIC-002, E-M0-CI-001)pnpm run check:max-lines-ratchet(E-M0-STATIC-001, E-M0-STATIC-002, E-M0-CI-001)
Milestone 0 commands added
pnpm exec vitest run --config config/vitest.config.ts src/main/ssh/ssh-remote-node-toolchain-resolution.test.ts(E-M0-UNIT-001)pnpm run test:e2e:ssh-node-toolchain-resolution(E-M0-LIVE-001)
Milestone 3 commands added
pnpm exec vitest run --config config/vitest.config.ts config/scripts/ssh-relay-node-release-verification.test.mjs(E-M3-NODE-RED-001, E-M3-NODE-PROVENANCE-001)node config/scripts/verify-ssh-relay-node-release-inputs.mjs --inputs-directory <verified-input-directory> --archive linux-x64-glibc(E-M3-NODE-PROVENANCE-001; metadata and archive verification only)pnpm exec vitest run --config config/vitest.config.ts config/scripts/ssh-relay-node-zip-inspection.test.mjs config/scripts/ssh-relay-runtime-zip.test.mjs(E-M3-WINDOWS-ZIP-RED-001, E-M3-WINDOWS-INPUT-001; synthetic ZIP/input contracts only)pnpm exec vitest run --config config/vitest.config.ts config/scripts/ssh-relay-runtime-windows-tree.test.mjs(E-M3-WINDOWS-LOCAL-002; structural Windows ConPTY closure only, no execution)pnpm exec vitest run --config config/vitest.config.ts config/scripts/ssh-relay-runtime-pty-smoke.test.mjs(E-M3-WINDOWS-SMOKE-SETTLEMENT-LOCAL-RED-001, E-M3-WINDOWS-SMOKE-SETTLEMENT-LOCAL-001; native evidence remains pending)pnpm exec vitest run --config config/vitest.config.ts config/scripts/ssh-relay-runtime-resource-diagnostics.test.mjs(E-M3-WINDOWS-RESOURCE-DIAGNOSTIC-LOCAL-001; native classification pending)pnpm exec vitest run --config config/vitest.config.ts config/scripts/ssh-relay-node-pty-windows-settlement.test.mjs(E-M3-WINDOWS-CONPTY-WORKER-LOCAL-RED-001, E-M3-WINDOWS-CONPTY-WORKER-LOCAL-001; native settlement pending)pnpm exec vitest run --config config/vitest.config.ts config/scripts/ssh-relay-runtime-reproducibility.test.mjs config/scripts/ssh-relay-runtime-workflow.test.mjs(E-M3-REPRODUCIBILITY-LOCAL-001; synthetic comparator/workflow contract only, native execution pending)pnpm exec vitest run --config config/vitest.config.ts config/scripts/ssh-relay-node-pty-build.test.mjs config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs config/scripts/ssh-relay-runtime-build.test.mjs config/scripts/ssh-relay-runtime-workflow.test.mjs(E-M3-REPRODUCIBILITY-LINKER-LOCAL-001; command/linker/work-path contracts plus local macOS native proof; Windows native equality pending)node --check config/scripts/build-ssh-relay-runtime.mjs && node --check config/scripts/ssh-relay-runtime-build.test.mjs(E-M3-REPRODUCIBILITY-BUILDER-PARSER-LOCAL-001; exact local parser proof; native Windows remains pending)node config/scripts/verify-ssh-relay-node-release-inputs.mjs --inputs-directory <verified-windows-input-directory> --archive win32-x64(E-M3-WINDOWS-INPUT-001; signed real Node ZIP, headers, and import library; no Windows execution)node config/scripts/build-ssh-relay-runtime.mjs --tuple linux-arm64-glibc --inputs-directory <verified-input-directory> --output-directory <exclusive-output> --work-directory <exclusive-stable-work> --source-date-epoch <epoch> --git-commit <full-sha>(E-M3-RUNTIME-LOCAL-001, E-M3-REPRODUCIBILITY-LINKER-LOCAL-001; local native Linux arm64 history plus current stable-work contract)node config/scripts/verify-ssh-relay-runtime.mjs --runtime-directory <runtime-tree> --identity <identity.json> --archive <runtime.tar.xz>(E-M3-RUNTIME-LOCAL-001; local native Linux arm64 only)
Commands/scripts that must be added or formally identified
- Manifest/schema/identity/signature/selector unit-test command. (E-M2-CONTRACT-001)
- Per-tuple POSIX runtime assembly command. (E-M3-RUNTIME-LOCAL-001; Windows command remains open)
- Per-tuple POSIX archive inspection and native smoke command. (E-M3-RUNTIME-LOCAL-001; Windows command remains open)
- Embedded-manifest extraction/comparison command for every packaged app.
- Draft release relay-asset completeness/read-back command.
- Release-DAG failure rehearsal covering native signing, aggregate, timeout/retry/manual approval, and recovered draft behavior.
- Hostile-archive and cache fault suite.
- Full-size transfer memory/cancellation suite for SFTP, POSIX system SSH, and Windows system SSH.
- Remote primitive/binary-fidelity suite for missing commands, BusyBox variants, no-tar POSIX, and bounded PowerShell/.NET Windows transfer.
- Remote verification-order suite for absent hash tools, corrupt upload, broken bundled Node, and sentinel/publish ordering.
- No-Node/no-egress packaged Electron SSH E2E.
- Full relay RPC conformance E2E using the packaged runtime.
- Upgrade/downgrade/concurrent-client/live-PTY E2E.
- macOS Gatekeeper and Windows Authenticode/WDAC/AV rehearsal commands.
- Network-shaped cold/warm/fallback performance report.
- Manifest key rotation/revocation/anti-rollback rehearsal.
Verification Evidence Ledger
Append entries; do not rewrite history. If evidence becomes invalid after code or matrix changes, mark it superseded and link the replacement.
Required entry format:
### E-<AREA>-<NNN> — <short title>
- Date:
- Commit SHA / PR:
- Runner: <OS, version, architecture, native/emulated>
- Remote: <OS, version, architecture, libc, relevant restrictions>
- Transport/network:
- Exact command:
- Result: PASS | FAIL | FLAKE | SUPERSEDED
- Duration and resource metrics:
- Artifact/log/trace link:
- Oracle proved:
- Does not prove:
- Checklist items satisfied:
- Follow-up:
E-PLAN-001 — Initial checklist creation
-
Date: 2026-07-14
-
Commit SHA / PR: uncommitted working tree
-
Runner: documentation-only local worktree
-
Remote: not applicable
-
Transport/network: not applicable
-
Exact command:
node --input-type=module -e 'import fs from "node:fs"; import path from "node:path"; import { marked } from "marked"; const file="docs/reference/plans/2026-07-14-ssh-relay-github-release-implementation-checklist.md"; const source=fs.readFileSync(file,"utf8"); const html=marked.parse(source); const links=[...source.matchAll(/\[[^\]]+\]\(([^)]+)\)/g)].map(m=>m[1]).filter(h=>!(/^(https?:|#)/.test(h))); for(const href of links){if(!fs.existsSync(path.resolve(path.dirname(file),href))) throw new Error(`Missing link: ${href}`)} const fences=(source.match(/^```/gm)||[]).length; if(fences%2) throw new Error(`Unbalanced fences: ${fences}`); const open=(source.match(/^- \[ \]/gm)||[]).length; const done=(source.match(/^- \[[xX]\]/gm)||[]).length; if(done) throw new Error(`Unexpected completed boxes: ${done}`); if(!html.includes("type=\"checkbox\"")) throw new Error("Task lists did not render"); console.log(`PASS links=${links.length} fences=${fences} open=${open} complete=${done}`)' -
Result: SUPERSEDED after subsequent review-driven plan expansion; originally PASS for document creation only.
-
Duration and resource metrics: 1.0 second;
links=1 fences=2 open=349 complete=0. -
Artifact/log/trace link: this file and the linked HTML plan
-
Oracle proved: the living checklist exists and covers implementation, validation, release, and rollback work.
-
Does not prove: any product behavior, artifact build, SSH runtime, platform, security, release, or performance claim.
-
Checklist items satisfied: none of the implementation milestones.
-
Follow-up: replaced by E-PLAN-002; close Milestone 1 decisions before production implementation.
E-PLAN-002 — Post-round-3 plan validation
-
Date: 2026-07-14
-
Commit SHA / PR: uncommitted planning worktree; implementation not started
-
Runner: macOS arm64 local documentation validation
-
Remote: not applicable
-
Transport/network: local file rendering only
-
Exact command:
git diff --check node --input-type=module - <<'NODE' import fs from 'node:fs' import path from 'node:path' import { marked } from 'marked' import { parse } from 'parse5' const mdFile = 'docs/reference/plans/2026-07-14-ssh-relay-github-release-implementation-checklist.md' const source = fs.readFileSync(mdFile, 'utf8') const rendered = marked.parse(source) const links = [...source.matchAll(/\[[^\]]+\]\(([^)]+)\)/g)].map(m => m[1]).filter(h => !/^(https?:|#)/.test(h)) for (const href of links) if (!fs.existsSync(path.resolve(path.dirname(mdFile), href))) throw new Error(`Missing link: ${href}`) const fences = (source.match(/^```/gm) || []).length const open = (source.match(/^- \[ \]/gm) || []).length const done = (source.match(/^- \[[xX]\]/gm) || []).length if (fences % 2 || done || !rendered.includes('type="checkbox"')) throw new Error('Invalid Markdown checklist') const html = fs.readFileSync('docs/reference/plans/2026-07-14-ssh-relay-github-release-plan.html', 'utf8') const errors = [] parse(html, { onParseError: error => errors.push(error) }) const ids = [...html.matchAll(/\bid="([^"]+)"/g)].map(m => m[1]) const hrefs = [...html.matchAll(/href="#([^"]+)"/g)].map(m => m[1]) if (errors.length || new Set(ids).size !== ids.length || hrefs.some(id => !ids.includes(id))) throw new Error('Invalid HTML plan') console.log({ links: links.length, fences, open, done, htmlIds: ids.length, fragmentLinks: hrefs.length }) NODE -
Result: SUPERSEDED after the round-4 tuple-status correction; originally PASS for the working-tree artifacts after round-3 findings were resolved.
-
Duration and resource metrics: 7.1 seconds;
links=1 fences=2 open=402 complete=0 htmlIds=11 fragmentLinks=9. -
Artifact/log/trace link: this file, the linked HTML plan, and local screenshots
/tmp/relay-plan-desktop-light.pngand/tmp/relay-plan-mobile-dark.png. -
Oracle proved: Markdown rendered with balanced fences, valid local links, and no prematurely completed implementation boxes; HTML parsed without parse errors, duplicate IDs, or broken fragment links;
git diff --checkpassed. HTML SHA-256 was375659e4ed3c4ec06b8077cae5badf39761ea5d92267612081195d6a027e073f; the checklist prefix before this ledger wasb599bf0c7ce6ca5ceb6188a153deb3437443f61d8a09069c8dc8dd6f21cdf9ad. -
Does not prove: any product behavior, artifact build, SSH runtime, platform, security, release, or performance claim. Visual mobile emulation must be repeated after the final review because the first CLI session relaunched at its default viewport.
-
Checklist items satisfied: none of the implementation milestones.
-
Follow-up: replaced by E-PLAN-003; complete final visual validation before implementation handoff.
E-PLAN-003 — Post-round-4 static validation
- Date: 2026-07-14
- Commit SHA / PR: uncommitted planning worktree; implementation not started
- Runner: macOS arm64 local documentation validation
- Remote: not applicable
- Transport/network: local file parsing only
- Exact command: the exact
git diff --checkand inlinemarked/parse5command block recorded in E-PLAN-002, followed byshasum -a 256for the HTML and the checklist prefix before this ledger. - Result: PASS for current static planning artifacts.
- Duration and resource metrics: under 1 second;
links=1 fences=2 open=402 complete=0 htmlIds=11 fragmentLinks=9. - Artifact/log/trace link: this file and the linked HTML plan.
- Oracle proved: Markdown/HTML structure, links, task-state integrity, fragment IDs, whitespace, and
current artifact identity. HTML SHA-256 is
728fa4edcf37e834f064a32308b2901a455402a61016bd7b047b151a75100bf1; the checklist prefix before this ledger isb599bf0c7ce6ca5ceb6188a153deb3437443f61d8a09069c8dc8dd6f21cdf9ad. - Does not prove: any product behavior or final visual responsiveness.
- Checklist items satisfied: none of the implementation milestones.
- Follow-up: obtain an explicit clean independent review, then run final desktop/mobile visual validation and implementation handoff.
E-PLAN-004 — Clean review and final visual validation
- Date: 2026-07-14
- Commit SHA / PR: uncommitted planning worktree; implementation not started
- Runner: macOS arm64, agent-browser Chromium
- Remote: not applicable
- Transport/network: local
file://rendering - Exact command: independent subagent round 5 reviewed both files completely and returned
CLEAN; agent-browser opened the HTML at 1440×1000 light mode and 390×844 @3x dark/reduced-motion mode, captured screenshots, queried document/table widths and media state, and checked page errors. - Result: PASS.
- Duration and resource metrics: desktop
documentWidth=1440, no page overflow, both tablesclientWidth=scrollWidth=966; mobiledocumentWidth=390, no page overflow, table regions scroll internally at352→363and352→505; dark mode and reduced motion both active; no page errors. - Artifact/log/trace link:
/tmp/relay-plan-final-desktop.pngand/tmp/relay-plan-final-mobile.pngin the handoff machine, plus the round-5CLEANverdict. - Oracle proved: current plan is visually usable at representative desktop/mobile widths, table overflow is contained, dark/reduced-motion media behavior activates, and an independent reviewer found no remaining actionable implementation, regression, security, cross-platform, release, evidence, HTML, or Markdown issue.
- Does not prove: product implementation or runtime behavior; all implementation checklist boxes remain open until backed by implementation evidence.
- Checklist items satisfied: planning review/validation only; none of Milestones 0–14.
- Follow-up: implementation agent must begin at Milestone 0/1, maintain this checklist, and attach evidence before marking any product item complete.
E-M0-UNIT-001 — Coherent Node/npm resolver and legacy deploy regression suite
-
Date: 2026-07-14
-
Commit SHA / PR:
1ef0551bc138724d736583eac788f4183bef07e2plus uncommitted Work Package 0 changes; no PR created -
Runner: macOS 26.2 arm64, native; Node v26.0.0 and pnpm 10.24.0 (repository requests Node 24)
-
Remote: local POSIX shell fixture for the guarded-NVM case; mocked Windows PowerShell command construction; no live SSH remote in this entry
-
Transport/network: local Vitest only
-
Exact command:
pnpm exec vitest run --config config/vitest.config.ts src/main/ssh/ssh-remote-node-resolution.test.ts pnpm exec vitest run --config config/vitest.config.ts src/main/ssh/ssh-remote-node-toolchain-resolution.test.ts pnpm exec vitest run --config config/vitest.config.ts src/main/ssh/ssh-relay-native-deps-install.test.ts pnpm exec vitest run --config config/vitest.config.ts src/main/ssh/ssh-relay-versioned-install.test.ts pnpm exec vitest run --config config/vitest.config.ts src/main/ssh/ssh-relay-deploy.test.ts pnpm exec vitest run --config config/vitest.config.ts src/main/ssh/ssh-relay-cross-version-isolation.test.ts pnpm exec vitest run --config config/vitest.config.ts src/main/ssh/ssh-remote-platform-detection.test.ts -
Result: PASS; respectively 32/32, 8/8, 16/16, 26/26, 21/21, 1/1, and 6/6 tests
-
Duration and resource metrics: respectively 577 ms, 1.21 s, 634 ms, 538 ms, 642 ms, 546 ms, and 156 ms Vitest duration; resource usage not instrumented
-
Artifact/log/trace link: local command output; source fixtures in
ssh-remote-node-toolchain-resolution.test.ts -
Oracle proved: POSIX and Windows probes require colocated Node/npm, Node 18 minimum remains, missing/failing/no-op npm candidates are skipped, guarded NVM is found without sourcing it, startup noise is marker-bounded, non-POSIX login shells receive a
/bin/sh-wrapped toolchain probe, strict session-limit errors/cancellation remain classified, and the selected NVM bin directory reaches legacynpm install. -
Does not prove: live SSH, live Windows, system SSH,
MaxSessions=1on a real server, release artifacts, or an executable red run against the pre-fix source. The original #8450 report is the field red observation; these green tests are discriminating but were not run after temporarily reverting user-owned code. -
Checklist items satisfied: Milestone 0 coherent pairing, negative cases, version enforcement, strategy/cancellation/session-limit preservation, and focused resolver/deploy verification.
-
Follow-up: keep this work package separate; add live Windows or
MaxSessions=1evidence only if those claims are needed for a later support matrix.
E-M0-LIVE-001 — Ubuntu 24.04 guarded-NVM relay and PTY reproduction
-
Date: 2026-07-14
-
Commit SHA / PR:
1ef0551bc138724d736583eac788f4183bef07e2plus uncommitted Work Package 0 changes; no PR created -
Runner: macOS 26.2 arm64 native client; Docker 29.2.1; Electron 43.1.0
-
Remote: Ubuntu 24.04 Linux arm64/glibc container (
sha256:4fbb8e6a8395de5a7550b33509421a2bafbc0aab6c06ba2cef9ebffbc7092d90); system Node v18.19.1 with no sibling npm; NVM-layout Node v22.22.3/npm 10.9.8 below a non-interactive.bashrcreturn guard; build-essential and Python present for the legacy native dependency install -
Transport/network: authenticated built-in SSH2 over Docker loopback; SFTP relay upload; remote registry and Node header egress available for the legacy npm install
-
Exact command:
pnpm run test:e2e:ssh-node-toolchain-resolution SKIP_BUILD=1 pnpm run test:e2e:ssh-node-toolchain-resolution -
Result: PASS twice; one purpose-named Playwright test passed on each run
-
Duration and resource metrics: fresh Electron/relay build plus E2E 1.8 minutes; repeated E2E 1.2 minutes with test evidence
durationMs=62553; memory/channel/file counts not instrumented for this narrow legacy resolver proof -
Artifact/log/trace link: local Playwright stdout included
systemNode=v18.19.1 nvmNode=v22.22.3 npm=10.9.8 selected=nvm relayPty=pass; fixture and runner are checked into this worktree -
Oracle proved: non-interactive and login-shell PATH both expose the incomplete system Node, the complete NVM directory remains discoverable below the guard, Orca connects, the detached relay's argv[0] is the NVM Node path, and a marker round-trips through a real remote PTY.
-
Does not prove: Linux x64, musl, Windows, macOS remote, system SSH,
MaxSessions=1, blocked remote egress, absence of build tools, fallback behavior, performance budgets, or bundled runtimes. -
Checklist items satisfied: Milestone 0 exact live #8450 reproduction and documented passing legacy tuple.
-
Follow-up: keep this evidence scoped to the one declared legacy tuple; do not generalize it into a bundled or cross-platform support claim.
E-M0-STATIC-001 — Work Package 0 type, format, line-budget, and diff gates
-
Date: 2026-07-14
-
Commit SHA / PR:
1ef0551bc138724d736583eac788f4183bef07e2plus uncommitted Work Package 0 changes -
Runner: macOS 26.2 arm64 native; Node v26.0.0 and pnpm 10.24.0
-
Remote: not applicable
-
Transport/network: local only
-
Exact command:
pnpm run typecheck pnpm exec oxlint src/main/ssh/ssh-remote-node-resolution.ts src/main/ssh/ssh-remote-node-toolchain-probe.ts src/main/ssh/ssh-remote-node-resolution.test.ts src/main/ssh/ssh-remote-node-toolchain-resolution.test.ts src/main/ssh/ssh-relay-native-deps-install.test.ts tests/e2e/helpers/docker-ssh-relay-target.ts tests/e2e/helpers/docker-ssh-relay-processes.ts tests/e2e/ssh-node-toolchain-resolution.spec.ts pnpm exec oxfmt --check src/main/ssh/ssh-remote-node-resolution.ts src/main/ssh/ssh-remote-node-toolchain-probe.ts src/main/ssh/ssh-remote-node-resolution.test.ts src/main/ssh/ssh-remote-node-toolchain-resolution.test.ts src/main/ssh/ssh-relay-native-deps-install.test.ts tests/e2e/helpers/docker-ssh-relay-target.ts tests/e2e/helpers/docker-ssh-relay-processes.ts tests/e2e/ssh-node-toolchain-resolution.spec.ts config/scripts/run-ssh-node-toolchain-resolution-e2e.mjs package.json pnpm run check:max-lines-ratchet git diff --check -
Result: PASS
-
Duration and resource metrics: typecheck 7.94 s; formatting check 144 ms; other gates under 1 s; resource usage not instrumented
-
Artifact/log/trace link: local command output
-
Oracle proved: Node/CLI/web TypeScript projects compile, touched TypeScript has no oxlint errors, all touched files are formatted, no new max-lines bypass exists, and the diff has no whitespace errors.
-
Does not prove: repository-wide lint completion; see E-M0-LINT-001.
-
Checklist items satisfied: Milestone 0 typecheck and max-lines/diff handoff gates.
-
Follow-up: resolve or explicitly baseline E-M0-LINT-001 before calling the full lint gate green.
E-M0-LINT-001 — Repository-wide lint blocked outside Work Package 0
- Date: 2026-07-14
- Commit SHA / PR:
1ef0551bc138724d736583eac788f4183bef07e2plus uncommitted Work Package 0 changes - Runner: macOS 26.2 arm64 native; Node v26.0.0 and pnpm 10.24.0
- Remote: not applicable
- Transport/network: local only
- Exact command:
pnpm run lint - Result: SUPERSEDED for current PR by E-M0-STATIC-002 after rebasing onto
origin/main; originally FAIL after 4.56 s - Duration and resource metrics: 4.56 s; resource usage not instrumented
- Artifact/log/trace link: local lint output
- Oracle proved: repository-wide oxlint completed with warnings only, then the type-aware
switch-exhaustiveness subgate failed at the untouched
src/renderer/src/components/tab-bar/TerminalTabLeadingIcon.tsx:31becauseactive | inactivecases are unhandled. - Does not prove: a WP0 lint regression. The failing renderer file is clean in
git statusand is outside this work package; touched-file oxlint passes in E-M0-STATIC-001. - Checklist items satisfied: none; the full
pnpm run lintcheckbox remains open. - Follow-up: none for WP0. Upstream
mainadded the missing cases before this branch rebased; the full lint command now passes atc4259d94fwithout an authored renderer change in this PR.
E-M0-UNIT-002 — Rebased Work Package 0 focused regression suites
-
Date: 2026-07-14
-
Commit SHA / PR:
c4259d94fccf8d1465280b8e69c22db328710f9e; draft PR #8724 -
Runner: macOS 26.2 arm64 native; Node v26.0.0 and pnpm 10.24.0 (repository requests Node 24)
-
Remote: local POSIX fixture and mocked Windows PowerShell command construction; no live SSH remote
-
Transport/network: local Vitest only
-
Exact command:
pnpm exec vitest run --config config/vitest.config.ts src/main/ssh/ssh-remote-node-resolution.test.ts pnpm exec vitest run --config config/vitest.config.ts src/main/ssh/ssh-remote-node-toolchain-resolution.test.ts pnpm exec vitest run --config config/vitest.config.ts src/main/ssh/ssh-relay-native-deps-install.test.ts pnpm exec vitest run --config config/vitest.config.ts src/main/ssh/ssh-relay-versioned-install.test.ts pnpm exec vitest run --config config/vitest.config.ts src/main/ssh/ssh-relay-deploy.test.ts pnpm exec vitest run --config config/vitest.config.ts src/main/ssh/ssh-relay-cross-version-isolation.test.ts pnpm exec vitest run --config config/vitest.config.ts src/main/ssh/ssh-remote-platform-detection.test.ts -
Result: PASS; respectively 32/32, 8/8, 16/16, 26/26, 21/21, 1/1, and 6/6 tests (110 total)
-
Duration and resource metrics: respectively 461 ms, 1.73 s, 324 ms, 339 ms, 284 ms, 245 ms, and 189 ms Vitest duration; 10.52 s aggregate wall time; resource usage not instrumented
-
Artifact/log/trace link: local command output and the exact sources in PR #8724
-
Oracle proved: the focused resolver/deploy contracts from E-M0-UNIT-001 remain green after rebasing onto
9d5173252, including colocated toolchains, guarded NVM, shell-noise markers, cancellation, session-limit classification, and propagation of the selected bin directory to npm install. -
Does not prove: live SSH, live Windows, system SSH, a real
MaxSessions=1server, or bundled runtime behavior. -
Checklist items satisfied: refreshed Milestone 0 focused regression gate on the exact PR commit.
-
Follow-up: use E-M0-LIVE-002 for the one claimed live tuple and PR CI for additional runner signal.
E-M0-STATIC-002 — Rebased Work Package 0 full static and repository lint gates
-
Date: 2026-07-14
-
Commit SHA / PR:
c4259d94fccf8d1465280b8e69c22db328710f9e; draft PR #8724 -
Runner: macOS 26.2 arm64 native; Node v26.0.0 and pnpm 10.24.0 (repository requests Node 24)
-
Remote: not applicable
-
Transport/network: local only
-
Exact command:
pnpm run typecheck pnpm run check:max-lines-ratchet pnpm exec oxfmt --check src/main/ssh/ssh-remote-node-resolution.ts src/main/ssh/ssh-remote-node-toolchain-probe.ts src/main/ssh/ssh-remote-node-resolution.test.ts src/main/ssh/ssh-remote-node-toolchain-resolution.test.ts src/main/ssh/ssh-relay-native-deps-install.test.ts tests/e2e/helpers/docker-ssh-relay-target.ts tests/e2e/helpers/docker-ssh-relay-processes.ts tests/e2e/ssh-node-toolchain-resolution.spec.ts config/scripts/run-ssh-node-toolchain-resolution-e2e.mjs package.json docs/reference/plans/2026-07-14-ssh-relay-github-release-implementation-checklist.md docs/reference/plans/2026-07-14-ssh-relay-github-release-plan.html git diff --check pnpm run lint -
Result: PASS; typecheck, 355-entry max-lines ratchet, 12-file formatting check, diff check, and the complete repository lint/reliability/localization chain all exited zero
-
Duration and resource metrics: typecheck/max-lines/format/diff group 7.39 s; full lint 14.11 s; resource usage not instrumented
-
Artifact/log/trace link: local command output; exact PR commits
-
Oracle proved: the exact rebased PR commit compiles, adds no line-budget bypass, is formatted, has no tracked whitespace errors, and passes the full repository lint chain. E-M0-LINT-001 is no longer a current blocker; its renderer fix came from upstream
main, not this PR's authored diff. -
Does not prove: packaged runtime behavior, live SSH, or GitHub-hosted runner behavior.
-
Checklist items satisfied: Milestone 0 typecheck, full lint, max-lines, format, and diff gates.
-
Follow-up: record the GitHub-hosted
verifyresult separately when PR #8724 completes.
E-M0-LIVE-002 — Rebased Ubuntu 24.04 guarded-NVM relay and PTY reproduction
- Date: 2026-07-14
- Commit SHA / PR:
c4259d94fccf8d1465280b8e69c22db328710f9e; draft PR #8724 - Runner: macOS 26.2 arm64 native client; Docker 29.2.1; Node v26.0.0; pnpm 10.24.0
- Remote: Ubuntu 24.04 Linux arm64/glibc container,
ubuntu@sha256:4fbb8e6a8395de5a7550b33509421a2bafbc0aab6c06ba2cef9ebffbc7092d90; system Node v18.19.1 with no sibling npm; guarded NVM-layout Node v22.22.3/npm 10.9.8 - Transport/network: authenticated built-in SSH2 over Docker loopback; SFTP relay upload; remote registry and Node-header egress available for the legacy native dependency install
- Exact command:
pnpm run test:e2e:ssh-node-toolchain-resolution - Result: PASS; one purpose-named Playwright test passed
- Duration and resource metrics: test oracle
durationMs=144224; full build plus E2E 3.2 minutes; memory/channel/file counts not instrumented for this narrow legacy resolver proof - Artifact/log/trace link: local Playwright stdout recorded
remote=ubuntu-24.04 architecture=arm64 systemNode=v18.19.1 nvmNode=v22.22.3 npm=10.9.8 selected=nvm relayPty=pass durationMs=144224 - Oracle proved: the exact rebased app/relay build selects the complete guarded NVM toolchain, launches the detached relay with that Node, and round-trips a marker through a real remote PTY.
- Does not prove: Linux x64, musl, Windows, macOS remote, system SSH,
MaxSessions=1, blocked remote egress, fallback behavior, performance budgets, or bundled runtimes. - Checklist items satisfied: refreshed Milestone 0 exact live #8450 reproduction on the PR commit.
- Follow-up: retain this narrow tuple claim and use later matrix work for all broader coverage.
E-M0-PR-001 — Independent draft PR boundary
-
Date: 2026-07-14
-
Commit SHA / PR: plan/checklist
2b67de870120b9a9230cb4464bff39665fa9bb44; WP0 codec4259d94fccf8d1465280b8e69c22db328710f9e; draft PR #8724 -
Runner: GitHub PR metadata; execution checks still running when recorded
-
Remote: not applicable
-
Transport/network: authenticated Git push and GitHub API
-
Exact command:
git push -u origin Jinwoo-H/bug-8450-ssh-node-npm-toolchain gh pr create --repo stablyai/orca --draft --base main --head Jinwoo-H/bug-8450-ssh-node-npm-toolchain gh pr view 8724 --repo stablyai/orca --json number,url,isDraft,state,headRefOid,baseRefOid,mergeStateStatus,statusCheckRollup -
Result: PASS for the independent review boundary; PR is open and draft with the expected head/base
-
Duration and resource metrics: push and PR creation 7.1 s; metadata read 0.8 s
-
Artifact/log/trace link: https://github.com/stablyai/orca/pull/8724
-
Oracle proved: reviewed planning artifacts and the WP0 resolver correction are separate commits; no bundled-runtime distribution implementation is present; GitHub Actions checks were triggered.
-
Does not prove: CI success, reviewer approval, mergeability after later base changes, or any bundled runtime behavior.
-
Checklist items satisfied: Milestone 0 separate commit/PR boundary.
-
Follow-up: GitHub-hosted runner/check details were appended as E-M0-CI-001 after completion.
E-M0-CI-001 — Draft PR full regression and packaged-app checks
-
Date: 2026-07-14
-
Commit SHA / PR:
94e58d83eabfba30b90e9714e91485ba5e3cf8d7; draft PR #8724 -
Runner: GitHub-hosted native runners:
ubuntu-latestresolved to x64ubuntu-24.04image20260705.232.1for verify and Linux golden jobs; runner image provisioner20260624.560macos-15resolved to arm64macos-15-arm64image20260706.0213.1for the macOS golden job; runner image provisioner20260624.560
-
Remote: not applicable; these workflows did not provision or connect to an SSH server
-
Transport/network: GitHub Actions checkout/package-network traffic only; no built-in SFTP or system-SSH relay transport was exercised
-
Exact command:
gh run watch 29325885071 --repo stablyai/orca --exit-status gh pr view 8724 --repo stablyai/orca --json url,state,isDraft,headRefOid,baseRefOid,mergeStateStatus,statusCheckRollup gh api repos/stablyai/orca/actions/jobs/87061960266 gh api repos/stablyai/orca/actions/jobs/87061960006 gh api repos/stablyai/orca/actions/jobs/87061960091 gh run view 29325885071 --repo stablyai/orca --job 87061960266 --log gh run view 29325884997 --repo stablyai/orca --job 87061960006 --log gh run view 29325884997 --repo stablyai/orca --job 87061960091 --log -
Result: PASS;
verify,golden e2e linux experiment, andgolden e2e mac experimentall completed successfully on the expected PR head -
Duration and resource metrics: verify job 13m13s; Linux golden job 4m23s; macOS golden job 5m57s; verify configured a 4 GiB Node heap ceiling but the workflows did not report peak process memory, channels, or file counts
-
Artifact/log/trace link:
-
Oracle proved: the PR head passes repository lint, reliability and max-lines gates, typecheck, Git 2.25 compatibility, full tests, unpacked-app packaging, packaged CLI smoke, and the existing Linux and macOS golden Electron suites.
-
Does not prove: live SSH, Windows, Linux arm64, musl, system SSH, SFTP bootstrap transfer,
MaxSessions=1, no-egress remotes, full-size runtime transfer, cancellation/resource budgets, or any bundled-runtime behavior. E-M0-LIVE-002 remains the only live SSH claim for WP0. -
Checklist items satisfied: Work Package 0 required PR checks, full repository lint, and independent CI boundary.
-
Follow-up: keep PR #8724 limited to WP0; use separate work-package branches and purpose-built SSH workflows for all later tuple claims.
E-M1-RUNNER-DECISION-001 — GitHub Actions validation topology decision
- Date: 2026-07-14
- Commit SHA / PR:
1ef0551bc138724d736583eac788f4183bef07e2plus uncommitted planning and Work Package 0 changes - Runner: documentation decision in the macOS 26.2 arm64 native worktree
- Remote: not applicable; exact native runner labels and representative remotes remain open
- Transport/network: not applicable
- Exact command: no executable runner command applies to the policy decision; both artifacts were structurally validated by the exact command recorded in E-M1-ROLLOUT-DECISION-001.
- Result: PASS for recording the user-authorized decision; no runner cell is claimed complete.
- Duration and resource metrics: not applicable to the decision; shared structural validation took 46 ms.
- Artifact/log/trace link: the Milestone 1 “Validation runner and network topology” section and the HTML “GitHub Actions runner policy” callout
- Oracle proved: both planning artifacts name GitHub Actions as the primary orchestrator and define when hosted, ephemeral, or self-hosted native execution may fill an evidence cell.
- Does not prove: availability, capacity, permissions, networking, signing access, native execution, or any live matrix cell for a concrete runner label.
- Checklist items satisfied: Milestone 1 runner-provider and qualification-policy decisions only.
- Follow-up: inventory exact labels/images and pin representative POSIX/Windows remotes before claiming any tuple.
E-M1-ROLLOUT-DECISION-001 — Per-SSH-target Beta with legacy default
-
Date: 2026-07-14
-
Commit SHA / PR:
1ef0551bc138724d736583eac788f4183bef07e2plus uncommitted planning and Work Package 0 changes -
Runner: macOS 26.2 arm64 native; Node v26.0.0 and pnpm 10.24.0
-
Remote: not applicable; documentation/content validation only
-
Transport/network: local files only
-
Exact command:
node --input-type=module - <<'NODE' import fs from 'node:fs' import path from 'node:path' import { marked } from 'marked' import { parse } from 'parse5' const started = performance.now() const mdFile = 'docs/reference/plans/2026-07-14-ssh-relay-github-release-implementation-checklist.md' const htmlFile = 'docs/reference/plans/2026-07-14-ssh-relay-github-release-plan.html' const source = fs.readFileSync(mdFile, 'utf8') const rendered = marked.parse(source) const links = [...source.matchAll(/\[[^\]]+\]\(([^)]+)\)/g)].map(match => match[1]).filter(href => !/^(https?:|#)/.test(href)) for (const href of links) if (!fs.existsSync(path.resolve(path.dirname(mdFile), href))) throw new Error(`Missing link: ${href}`) const fences = (source.match(/^```/gm) || []).length const open = (source.match(/^- \[ \]/gm) || []).length const done = (source.match(/^- \[[xX]\]/gm) || []).length if (fences % 2 || !rendered.includes('type="checkbox"')) throw new Error('Invalid Markdown checklist') const html = fs.readFileSync(htmlFile, 'utf8') const errors = [] parse(html, { onParseError: error => errors.push(error) }) const ids = [...html.matchAll(/\bid="([^"]+)"/g)].map(match => match[1]) const hrefs = [...html.matchAll(/href="#([^"]+)"/g)].map(match => match[1]) if (errors.length || new Set(ids).size !== ids.length || hrefs.some(id => !ids.includes(id))) throw new Error('Invalid HTML plan') const requiredMd = ['Per-target Beta rollout decision', 'E-M1-ROLLOUT-DECISION-001', 'missing, malformed,', 'separate reviewed rollout decision'] const requiredHtml = ['Per-target Beta contract', 'bundled-auto', 'Future default review'] for (const value of requiredMd) if (!source.includes(value)) throw new Error(`Missing checklist contract: ${value}`) for (const value of requiredHtml) if (!html.includes(value)) throw new Error(`Missing HTML contract: ${value}`) console.log(JSON.stringify({ result: 'PASS', links: links.length, fences, open, done, htmlIds: ids.length, fragmentLinks: hrefs.length, durationMs: Math.round(performance.now() - started) })) NODE pnpm exec oxfmt --check docs/reference/plans/2026-07-14-ssh-relay-github-release-implementation-checklist.md docs/reference/plans/2026-07-14-ssh-relay-github-release-plan.html git diff --check -
Result: PASS;
links=1 fences=2 open=393 complete=33 htmlIds=11 fragmentLinks=9and nogit diff --checkfindings; both planning artifacts passoxfmt --check. -
Duration and resource metrics: 46 ms for Markdown/HTML parsing; resource usage not instrumented.
-
Artifact/log/trace link: this checklist and the linked HTML plan
-
Oracle proved: both artifacts record a Beta-tagged per-target opt-in, conservative legacy deserialization, next-connection-only application, classified fallback, explicit fail-closed recovery, and separate authorization before any default change.
-
Does not prove: configuration migration, add/edit UI, Beta badge rendering, live-session preservation, telemetry, fallback behavior, or any bundled runtime execution.
-
Checklist items satisfied: Milestone 1 rollout-control mechanism and per-target Beta policy decisions only; implementation boxes in Milestones 8 and 14 remain open.
-
Follow-up: implement and test the target configuration/UI in its reviewable work package after the Work Package 0 boundary and remaining Milestone 1 blockers are closed.
E-M1-BASELINE-001 — Conservative initial runtime eligibility baselines
-
Date: 2026-07-14
-
Commit SHA / PR:
a84d52dc6; stacked draft PR #8728 -
Runner: macOS 26.2 arm64 native; authoritative Node v24.18.0 release/build metadata fetched over HTTPS
-
Remote: no SSH remote; local AlmaLinux 8 arm64 container reported glibc 2.28 and
libstdc++-8.5.0 -
Transport/network: HTTPS to nodejs.org and raw.githubusercontent.com; local Docker execution only
-
Exact command:
curl -fsSL https://nodejs.org/dist/index.json | jq -r '[.[] | select(.version | startswith("v24."))][0] | {version,date,lts,security,files}' curl -fsSL https://raw.githubusercontent.com/nodejs/node/v24.18.0/BUILDING.md | sed -n '65,190p' docker run --rm almalinux:8 sh -lc 'uname -m; getconf GNU_LIBC_VERSION; rpm -q libstdc++ glibc' -
Result: PASS for a decision record. Node v24.18.0 is LTS and publishes official Linux glibc, macOS, and Windows archives for x64/arm64. Its supported-platform contract states Linux kernel 4.18, glibc 2.28, libstdc++ 6.0.25/
GLIBCXX_3.4.25, macOS 13.5, Windows 10/Server 2016 x64, and Windows 10 arm64 minimums. Orca adopts those Linux/macOS floors and stricter Windows floors aligned with the declared SSH bootstrap primitives. -
Duration and resource metrics: network reads under 1 s each; local AlmaLinux probe 0.6 s; no runtime load or memory metric applies to the policy decision
-
Artifact/log/trace link:
-
Oracle proved: the recorded minimums do not claim compatibility below the upstream official Node binary ABI/OS floors, and musl is excluded because Node publishes no official musl archive.
-
Does not prove: any Orca runtime archive, native module, SSH primitive, Rosetta behavior, Windows host, minimum-kernel VM, or enabled tuple. Every candidate remains disabled pending live evidence.
-
Checklist items satisfied: Milestone 1 glibc, libstdc++, kernel, musl, macOS, Windows, and Rosetta eligibility decisions.
-
Follow-up: encode these floors in the manifest/selector contract and fill every target-native live cell before enabling a tuple.
E-M1-NODE-PROVENANCE-001 — Pinned official Node 24 LTS provenance policy
-
Date: 2026-07-14
-
Commit SHA / PR:
a84d52dc6; stacked draft PR #8728 -
Runner: macOS 26.2 arm64 native orchestrating an Ubuntu 24.04 arm64 Docker container for GPG verification
-
Remote: not applicable; provenance inputs were verified locally before any extraction or transfer
-
Transport/network: HTTPS to nodejs.org and the Node release-key repository; no SSH
-
Exact command:
curl -fsSL https://nodejs.org/dist/v24.18.0/SHASUMS256.txt | rg 'node-v24\.18\.0-(linux-(x64|arm64)|darwin-(x64|arm64)|win-(x64|arm64))\.(tar\.xz|zip)$' docker run --rm ubuntu:24.04 bash -lc 'apt-get update -qq && apt-get install -y -qq ca-certificates curl gpgv >/dev/null && curl -fsSL https://github.com/nodejs/release-keys/raw/refs/heads/main/gpg-only-active-keys/pubring.kbx -o /tmp/nodejs-active.kbx && curl -fsSL https://nodejs.org/dist/v24.18.0/SHASUMS256.txt -o /tmp/SHASUMS256.txt && curl -fsSL https://nodejs.org/dist/v24.18.0/SHASUMS256.txt.sig -o /tmp/SHASUMS256.txt.sig && gpgv --keyring /tmp/nodejs-active.kbx /tmp/SHASUMS256.txt.sig /tmp/SHASUMS256.txt && sha256sum /tmp/SHASUMS256.txt' -
Result: PASS; detached signature timestamp
2026-06-23T23:07:59Zverified with active Node release keyC82FA3AE1CBEDC6BE46B9360C43CEC45C17AB93C(Richard Lau); verified checksum-file SHA-2563927bab574a00ca0560c9583fe19655ba19603a1c5851414e4325d34ac50e469 -
Duration and resource metrics: checksum fetch 0.3 s; clean-container key/signature verification 11.9 s including package installation; resource usage not instrumented
-
Artifact/log/trace link:
-
Oracle proved: the selected six upstream archives exist and their checksum list has a valid signature from the active Node release keyring. The policy pins the exact patch and requires a new desktop identity for every refresh.
-
Does not prove: that future CI pins rather than mutably fetches the keyring, verifies archives, preserves native signatures, builds native modules, meets the CVE SLA, or signs Orca artifacts. Those remain implementation/release gates.
-
Checklist items satisfied: Milestone 1 Node version, provenance, musl-source, update/CVE, refresh identity, and upstream-signature decisions.
-
Follow-up: vendor a reviewed keyring/input digest into the build contract, implement fail-closed verification, and add target-native signing/provenance jobs.
E-M1-RUNNER-INVENTORY-001 — Native GitHub-hosted runner catalog
-
Date: 2026-07-14
-
Commit SHA / PR:
a84d52dc6; stacked draft PR #8728 -
Runner: macOS 26.2 arm64 native; GitHub runner-image catalog plus repository workflow inventory
-
Remote: not applicable; no SSH target is claimed
-
Transport/network: HTTPS to the GitHub runner-image catalog and GitHub Actions logs
-
Exact command:
curl -fsSL https://raw.githubusercontent.com/actions/runner-images/main/README.md | sed -n '/Available Images/,/Beta Images/p' rg -n 'runs-on:' .github/workflows gh run view 29325885071 --repo stablyai/orca --job 87061960266 --log gh run view 29325884997 --repo stablyai/orca --job 87061960091 --log -
Result: PASS for inventory. The catalog exposes native x64/arm64 Linux, macOS, and Windows labels selected above and documents weekly image refresh. PR evidence independently resolved
ubuntu-latestto x64ubuntu-24.04image20260705.232.1andmacos-15to arm64macos-15-arm64image20260706.0213.1. -
Duration and resource metrics: catalog fetch 0.2 s; workflow scan 0.1 s; prior log reads under 3 s; hosted capacity is unreserved and queue-dependent rather than a fixed resource guarantee
-
Artifact/log/trace link:
- https://github.com/actions/runner-images#available-images
- E-M0-CI-001 job links
-
Oracle proved: explicit native labels exist for the six client/build architectures and new relay workflows can avoid mutable
latestaliases while recording exact resolved images. -
Does not prove: repository access to paid capacity at a future run, runner availability, SSH server reachability, cross-family networking, image stability, or any runtime tuple. No approved self-hosted target pool was found or inferred.
-
Checklist items satisfied: Milestone 1 runner-label/architecture/image-update/capacity inventory.
-
Follow-up: pin representative remote images/snapshots, provision cross-family endpoints, and run a minimal native label smoke before assigning any evidence cell.
E-M1-DECISION-DOC-001 — Baseline/provenance plan-content validation
- Date: 2026-07-14
- Commit SHA / PR:
a84d52dc6; stacked draft PR #8728 - Runner: macOS 26.2 arm64 native; Node v26.0.0 and pnpm 10.24.0
- Remote: not applicable; documentation/content validation only
- Transport/network: local files only
- Exact command: purpose-built inline Node validation using
markedandparse5, followed bypnpm exec oxfmt --checkfor both plan artifacts andgit diff --check - Result: PASS;
links=1 fences=2 htmlIds=11 fragmentLinks=9, no parse/fragment/duplicate-ID, formatting, or whitespace findings - Duration and resource metrics: structural validation 42 ms; formatter check 243 ms; resource usage not instrumented
- Artifact/log/trace link: this checklist and the linked HTML plan
- Oracle proved: both artifacts contain the baseline, Node provenance, musl legacy-only, and explicit native-runner inventory decisions and remain structurally valid.
- Does not prove: implementation, live compatibility, runner access, SSH transport, signing, or any enabled tuple.
- Checklist items satisfied: evidence-backed synchronization of the Milestone 1 decision content in both required plan artifacts.
- Follow-up: continue the remaining Milestone 1 gates and keep contract implementation in stacked draft PR #8728 with no default behavior change.
E-M1-LEGACY-INVENTORY-001 — Current legacy families versus bundled candidates
- Date: 2026-07-14
- Commit SHA / PR:
5c37e8efe; stacked draft PR #8728 - Runner: macOS 26.2 arm64 native; Vitest Node environment
- Remote: none; source-declared platform identities and deterministic tests only
- Transport/network: local files only
- Exact command:
pnpm exec vitest run --config config/vitest.config.ts src/main/ssh/relay-protocol.test.ts src/main/ssh/ssh-remote-platform-detection.test.ts - Result: PASS; 35/35 tests across two files, including Linux/macOS/Windows x64/arm64 parsing and conservative unsupported-platform rejection
- Duration and resource metrics: 253 ms; memory, channels, and files not instrumented
- Artifact/log/trace link: local Vitest stdout; current
RelayPlatformsource and the living table - Oracle proved: current source has six deterministic legacy platform identities and rejects unknown OS/architectures; the plan now separates those identities from libc-aware bundled candidates and from live fallback claims.
- Does not prove: a live SSH connection, native npm install, PTY/watcher health, libc compatibility, or fallback on any family. E-M0-LIVE-002 remains the only live legacy evidence in this project.
- Checklist items satisfied: Milestone 1 legacy-versus-bundled family inventory.
- Follow-up: fill current legacy E2E cells before allowing automatic fallback for each corresponding bundled tuple.
E-M1-BOOTSTRAP-DECISION-001 — No-Node POSIX and bounded Windows primitive contract
- Date: 2026-07-14
- Commit SHA / PR:
5c37e8efe; stacked draft PR #8728 - Runner: macOS 26.2 arm64 native; Docker Desktop native arm64 Linux containers
- Remote: local Ubuntu 24.04, Debian 12/bookworm-slim, and AlmaLinux 8 arm64 containers; no SSH daemon, Windows host, or BusyBox image
- Transport/network: Docker stdin/stdout only; the fixture exercised the proposed raw per-file stream but not an authenticated SSH channel
- Exact command: inline Node harness spawned each image with
docker run --rm -i ... sh -c, sent a ten-byte fixture containing NUL/CR/LF/high-bit bytes, and required exact output aftermkdir/cat/chmod/mv/test/nohup/rm - Result: PASS; exact ten-byte round trip on Ubuntu 24.04, Debian bookworm-slim, and AlmaLinux 8
- Duration and resource metrics: Ubuntu 4,384 ms, Debian 569 ms, AlmaLinux 506 ms including container startup; one stdin/stdout stream; peak memory and open-file counts not instrumented
- Artifact/log/trace link: local harness stdout recorded in the implementation session
- Oracle proved: the declared POSIX command subset can preserve the binary fixture without Node, Python, Perl, tar, base64, or checksum tools on three glibc userlands.
- Does not prove: SSH framing, cancellation, short/extra input rejection, concurrency,
MaxSessions=1, BusyBox, Windows PowerShell/.NET, exclusive lock races, full-size transfer, or complete-tree verification. - Checklist items satisfied: Milestone 1 POSIX/Windows primitive, per-connection probe, and compatibility-failure decisions only. Windows is a specified contract, not executable evidence.
- Follow-up: turn this into purpose-named unit/live tests, add BusyBox and bounded Windows binary transfer, and do not enable any tuple from this local semantic probe.
E-M1-BUSYBOX-001 — BusyBox-only primitive baseline fails closed
- Date: 2026-07-14
- Commit SHA / PR:
5c37e8efe; stacked draft PR #8728 - Runner: macOS 26.2 arm64 native; Ubuntu 24.04 arm64 Docker container
- Remote: BusyBox v1.36.1, Ubuntu package
1:1.36.1-6ubuntu3.1; no SSH daemon - Transport/network: Docker stdin and Ubuntu package mirror; no SSH
- Exact command: install BusyBox, enumerate applets, install its applet symlinks into an isolated
PATH, then run the declaredsh/cat/mkdir/rm/mv/chmod/test/nohupsemantic probe - Result: PASS for fail-conservative classification; the probe exited 127 because this BusyBox build
provides all declared applets except
nohup, so it is ineligible and must select legacy - Duration and resource metrics: 4.6 s including package installation; one container/process stream; peak memory not instrumented
- Artifact/log/trace link: local stdout recorded
BusyBox v1.36.1 (Ubuntu 1:1.36.1-6ubuntu3.1) multi-call binary; applet inventory omittednohup - Oracle proved: the selector cannot infer compatibility from “BusyBox 1.36.1” alone and the exact declared primitive probe rejects this variant rather than attempting a partial bundled install.
- Does not prove: Alpine's BusyBox build, BusyBox plus an external
nohup, SSH behavior, or any passing BusyBox tuple. No BusyBox bundled support is claimed. - Checklist items satisfied: Milestone 1 initial BusyBox variant record and deterministic disable rule.
- Follow-up: add this missing-
nohupcase to the committed selector/primitive suite and retain legacy unless a complete BusyBox environment passes live SSH evidence.
E-M1-BUDGET-DECISION-001 — Fail-closed resource, timeout, and rollout budgets
- Date: 2026-07-14
- Commit SHA / PR:
5c37e8efe; stacked draft PR #8728 - Runner: documentation decision in the macOS 26.2 arm64 native worktree
- Remote: not applicable; measured legacy and bundled baselines remain open
- Transport/network: not applicable; the decision defines later 1/10/100 Mbps and 50/100/200 ms shaped tests
- Exact command: plan/checklist content validation plus arithmetic review of every byte/count/time ceiling; no runtime benchmark is represented by this entry
- Result: PASS for recording release-blocking upper bounds and paired comparison rules; no performance gate is claimed passed
- Duration and resource metrics: decision/content validation only; runtime metrics intentionally absent until the baseline harness is implemented
- Artifact/log/trace link: “Operational budgets and rollout policy” in this checklist and “Hard resource and latency budgets” in the HTML plan
- Oracle proved: implementation now has explicit rejection, cache, memory, concurrency, timeout, cancellation, warm/cold latency, fallback-delay, and legacy-retention thresholds to test against.
- Does not prove: that the limits fit the final full-size archive, that either implementation stays below them, hosted-runner stability, or any baseline/regression result. Those boxes remain open.
- Checklist items satisfied: Milestone 1 cache/archive/time/memory/channel/latency/fallback-duration, paired-runner-method, and offline/missing-asset policy decisions.
- Follow-up: measure legacy first, instrument file/channel/memory/cancellation metrics, and revise both plan files before implementation only if evidence proves a limit infeasible.
E-M1-TRUST-DECISION-001 — Manifest and native-signing trust policy
-
Date: 2026-07-14
-
Commit SHA / PR:
5c37e8efe; stacked draft PR #8728 -
Runner: macOS 26.2 arm64 native for local Ed25519 probe; historical native Windows Server 2022 x64 GitHub-hosted signing rehearsal jobs
-
Remote: not applicable; no SSH transfer or target-native execution of a relay artifact
-
Transport/network: local
tweetnaclsign/verify plus GitHub Actions/SignPath artifact round trips -
Exact command:
rg -n 'tweetnacl|CSC_LINK|APPLE_ID|SIGNPATH|SignPath|Get-AuthenticodeSignature' package.json .github/workflows config node --input-type=module <inline-tweetnacl-sign-mutate-verify-harness> gh run view 28987534795 --repo stablyai/orca --json status,conclusion,createdAt,updatedAt,url,jobs gh run view 28988432001 --repo stablyai/orca --json status,conclusion,createdAt,updatedAt,url,jobs -
Result: PASS for technical feasibility and existing Windows signing evidence. The local probe made and verified a 64-byte Ed25519 signature with
tweetnacl, derived the SHA-256 public-key ID, and rejected a changed payload. SignPath test-policy run28987534795and release-policy run28988432001both signed/restored inner PE files, rebuilt/signed the installer, and passed end-to-end signature verification. -
Duration and resource metrics: local Ed25519 probe under 0.1 s; test SignPath job 10m7s; production SignPath rehearsal 17m24s; signing memory not instrumented
-
Artifact/log/trace link:
-
Oracle proved: the chosen signature primitive works through an already packaged dependency, and the repository's existing Windows release machinery can return signed inner native bytes before final packaging/hashing.
-
Does not prove: canonical serializer implementation, protected manifest environment/secret, dual-key rotation, revocation, action-SHA pinning, artifact attestations, macOS relay-native signing/notarization, key custody, WDAC/Gatekeeper/AV, or any signed relay runtime. Those remain release-blocking implementation/operational gates.
-
Checklist items satisfied: Milestone 1 algorithm, canonical-byte, key-custody policy, rotation, anti-rollback, keyless-provenance, and native macOS/Windows signing decisions only.
-
Follow-up: implement hostile-input/canonical/signature tests without real secrets, then provision and rehearse the protected environment before any release workflow can sign a manifest.
E-M1-ENDPOINT-DECISION-001 — Native trust validation environment contract
- Date: 2026-07-14
- Commit SHA / PR:
5c37e8efe; stacked draft PR #8728 - Runner: documentation decision in the macOS 26.2 arm64 native worktree
- Remote: no approved macOS 13.5, Windows Server 2022/Windows 11 arm64, or WDAC-enforced snapshot was executed
- Transport/network: not applicable
- Exact command: repository signing-workflow inspection plus synchronized checklist/HTML content validation; no endpoint-protection command is represented by this decision entry
- Result: PASS for defining exact target-native environments and fail-closed outcomes; all execution gates remain open
- Duration and resource metrics: decision/content validation only
- Artifact/log/trace link: Milestone 1 trust section and HTML “OS-native trust controls” risk
- Oracle proved: future Gatekeeper/Defender/WDAC evidence has concrete OS/architecture, quarantine, policy mode, identity logging, and release-blocking requirements.
- Does not prove: snapshot/provider availability, policy ownership, actual signature acceptance, antivirus behavior, native loading, PTY/watcher smoke, or any endpoint-protection pass.
- Checklist items satisfied: Milestone 1 endpoint-protection environment decision only.
- Follow-up: provision or approve the snapshot pool and keep every affected tuple disabled until the target-native runs pass.
E-M1-DECISION-DOC-002 — Remaining Milestone 1 plan-content validation
- Date: 2026-07-14
- Commit SHA / PR:
5c37e8efe; stacked draft PR #8728 - Runner: macOS 26.2 arm64 native; Node v26.0.0 and pnpm 10.24.0
- Remote: not applicable; documentation/content validation only
- Transport/network: local files only
- Exact command: purpose-built inline Node validation using
markedandparse5, required-content assertions for all newly recorded Milestone 1 decisions,pnpm exec oxfmt --checkon both artifacts, andgit diff --check - Result: PASS;
links=1 fences=2 htmlIds=11 fragmentLinks=9, no parse/fragment/duplicate-ID/content/format/whitespace findings - Duration and resource metrics: structural validation 42 ms; formatter check 253 ms; resource usage not instrumented
- Artifact/log/trace link: this checklist and the linked HTML plan
- Oracle proved: both artifacts contain synchronized legacy-family, bootstrap, BusyBox, offline/fallback, numeric-budget, manifest-trust, native-signing, and endpoint-environment decisions and remain structurally valid.
- Does not prove: implementation, measured budget compliance, key provisioning, native trust, live transfer, or any enabled tuple.
- Checklist items satisfied: evidence-backed synchronization of the remaining safely decidable Milestone 1 policy content.
- Follow-up: keep unresolved remote-pool and measured-baseline gates open while contract-only work proceeds without secrets or a runtime behavior switch.
E-M2-RED-001 — Missing contract modules and canonical-vector red baseline
-
Date: 2026-07-14
-
Commit SHA / PR:
959bc05caca7e5ccb4c69b47c1bf6f5b47671c57plus uncommitted Work Package 1 tests; stacked draft PR #8728 -
Runner: macOS 26.2 arm64 native; Node v26.0.0 and pnpm 10.24.0
-
Remote: not applicable; pure local contract tests
-
Transport/network: local Vitest only; no SSH or GitHub request
-
Exact command:
pnpm exec vitest run --config config/vitest.config.ts \ src/main/ssh/ssh-relay-artifact-schema.test.ts \ src/main/ssh/ssh-relay-runtime-identity.test.ts \ src/main/ssh/ssh-relay-manifest-signature.test.ts \ src/main/ssh/ssh-relay-release-asset.test.ts \ src/main/ssh/ssh-relay-artifact-selector.test.ts -
Result: FAIL as the intended executable red baseline: signature and selector suites failed to import because their production modules did not exist; the identity vector still contained its explicit replacement marker; and one native-package fixture reached the undeclared-parent guard before the intended native-package guard. Four files failed, one passed, with 35 tests executed (33 passed and 2 failed) plus two import-failed suites.
-
Duration and resource metrics: 292 ms Vitest duration; no runtime-transfer resources apply.
-
Artifact/log/trace link: local command output retained in the implementation session; test paths above are the durable repro.
-
Oracle proved: the new tests were discriminating before the missing signature/selector modules and canonical vector were implemented, and the native-package fixture needed to preserve tree consistency to reach its intended oracle.
-
Does not prove: behavior before all schema/identity files existed, live SSH, a real archive, cryptographic key custody, target-native execution, or any production-path failure.
-
Checklist items satisfied: red half of the Work Package 1 contract-test gate only.
-
Follow-up: implemented and superseded for green behavior by E-M2-CONTRACT-001; retained as red history.
E-M2-CONTRACT-001 — Manifest, identity, signature, URL, and selector contracts
-
Date: 2026-07-14
-
Commit SHA / PR:
b9d80a4cbca43c344a3a5fbdc669fa97c7527da0; stacked draft PR #8728; PR CI evidence pending -
Runner: macOS 26.2 arm64 native; Node v26.0.0 and pnpm 10.24.0 (repository requests Node 24)
-
Remote: not applicable; pure local schema, cryptography, identity, release-name, and selection tests
-
Transport/network: local Vitest/static tools only; no SSH, release download, or GitHub API call
-
Exact command:
pnpm exec vitest run --config config/vitest.config.ts \ src/main/ssh/ssh-relay-artifact-schema.test.ts \ src/main/ssh/ssh-relay-runtime-identity.test.ts \ src/main/ssh/ssh-relay-manifest-signature.test.ts \ src/main/ssh/ssh-relay-release-asset.test.ts \ src/main/ssh/ssh-relay-artifact-selector.test.ts pnpm run typecheck pnpm run lint pnpm run check:max-lines-ratchet pnpm exec oxfmt --check \ src/main/ssh/ssh-relay-artifact-consistency.ts \ src/main/ssh/ssh-relay-artifact-path-policy.ts \ src/main/ssh/ssh-relay-artifact-schema.ts \ src/main/ssh/ssh-relay-artifact-selector.ts \ src/main/ssh/ssh-relay-manifest-signature.ts \ src/main/ssh/ssh-relay-release-asset.ts \ src/main/ssh/ssh-relay-runtime-identity.ts \ src/main/ssh/ssh-relay-artifact-schema.test.ts \ src/main/ssh/ssh-relay-artifact-selector.test.ts \ src/main/ssh/ssh-relay-manifest-signature.test.ts \ src/main/ssh/ssh-relay-release-asset.test.ts \ src/main/ssh/ssh-relay-runtime-identity.test.ts \ src/main/ssh/ssh-relay-artifact-test-manifest.ts \ docs/reference/plans/2026-07-14-ssh-relay-github-release-implementation-checklist.md git diff --cached --check -
Result: PASS locally. Five suites passed with 68/68 tests; Node/CLI/web typecheck passed; the full repository lint/reliability/localization chain exited zero with pre-existing warnings only; the 355-entry max-lines ratchet reported no new bypass; touched-file formatting and tracked diff checks passed.
-
Duration and resource metrics: final Vitest duration 540 ms (1.33 s wall); typecheck 3.91 s; full lint 23.62 s; formatting check 874 ms; max-lines and diff checks under 1 s. Runtime memory, channels, handles, files, and cancellation do not apply to this disconnected pure contract layer and were not instrumented.
-
Artifact/log/trace link: local command output; canonical runtime identity vector
sha256:5afe9c8094ec61a5eec6f7be6d1035faacee7362871985c74cc6ee6aceea8677; canonical unsigned-manifest byte hashe78bf4416628a91055035dc7926035cbf633f29d3618be34e041c6dc5e0794fb; draft PR #8728 -
Oracle proved: strict versioned parsing; bounded sizes/counts; portable path and special-entry rejection; required runtime closure and executable Node mode; tuple/archive/attestation cross-consistency; stable content identity; exact stable/RC/perf tag and direct-URL rules; initial and dual Ed25519 signing with canonical unsigned bytes; unknown/malformed/duplicate/mismatched key failure; conservative Linux glibc/musl, macOS, Windows-bootstrap, translated-process, unknown, old, unavailable, and ambiguous selection.
-
Does not prove: Node 24 execution, real archive parsing/extraction, local cache/download, target probes, SSH/SFTP/system-SSH transfer, runtime build/native loading, signing environment custody, release publication, fallback state, UI rollout, performance, or any live matrix cell. No module is connected to a production call site and no tuple is enabled.
-
Checklist items satisfied: Milestone 2 manifest-schema, signed-content, content-identity, release-name/URL, schema-level hostile path/type, and pure selector contract items explicitly marked above; verification command inventory entry.
-
Follow-up: push and record the exact GitHub Actions result, then begin Work Package 2 target-native runtime assembly without production consumption.
E-M2-CI-001 — Work Package 1 full PR verification and packaging gate
-
Date: 2026-07-14
-
Commit SHA / PR: exact checked head
6732d911a8e81ad071925e68d3a60fec2e3e452a, containing implementation commitb9d80a4cbca43c344a3a5fbdc669fa97c7527da0; stacked draft PR #8728 -
Runner: GitHub-hosted native x64
ubuntu-latest, resolved to Ubuntu 24.04 image20260705.232.1; image provisioner20260624.560; runner2.335.1; Node v24.18.0 -
Remote: not applicable; the workflow provisioned no SSH server and exercised no remote tuple
-
Transport/network: GitHub Actions checkout/package traffic only; no SSH/SFTP/system-SSH runtime transfer
-
Exact command:
gh run watch 29329963564 --repo stablyai/orca --exit-status gh pr view 8728 --repo stablyai/orca \ --json url,isDraft,state,headRefOid,baseRefOid,mergeStateStatus,statusCheckRollup gh api repos/stablyai/orca/actions/jobs/87075275741 gh run view 29329963564 --repo stablyai/orca --job 87075275741 --log -
Result: PASS. The
verifyjob completed successfully on the exact PR head; repository lint, reliability gates, max-lines, typecheck, Git 2.25 compatibility, 2,803 passing test files with 29,695 passing tests, unpacked Linux app packaging, packaged daemon load, and packaged CLI smoke all passed. Nine test files and 55 tests were intentionally skipped by the existing suite. -
Duration and resource metrics: 11m52s from
2026-07-14T11:44:44Zto2026-07-14T11:56:36Z; the workflow did not report peak memory, channel, handle, or file counts. -
Artifact/log/trace link: https://github.com/stablyai/orca/actions/runs/29329963564/job/87075275741
-
Oracle proved: Work Package 1 compiles and passes the repository's full PR regression/package gate under the pinned Node 24 runtime on a native Linux x64 runner; PR #8728 is draft, open, and reports a clean merge state at the checked head.
-
Does not prove: live SSH, Linux arm64, macOS, Windows, musl, archive assembly/extraction, native runtime execution, signing, release assets, download/cache, transfer/install, fallback, UI, performance budgets, or any enabled tuple. The existing relay build exercised by packaging remains the legacy JavaScript build, not a self-contained runtime artifact.
-
Checklist items satisfied: Work Package 1 exact-head PR CI gate only; no live matrix or runtime tuple cell.
-
Follow-up: keep PR #8728 draft and isolated; begin Work Package 2 on a new stacked branch with no production consumer.
E-M3-NODE-RED-001 — Node release verifier red gate
-
Date: 2026-07-14
-
Commit SHA / PR:
0c299fe189310b6dbd539f0f0f506b240524ba6aplus uncommitted Work Package 2 test; no Work Package 2 PR yet -
Runner: macOS 26.2 arm64 native; Node v26.0.0 and pnpm 10.24.0
-
Remote: not applicable; local test discovery only
-
Transport/network: none
-
Exact command:
pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-release-verification.test.mjs -
Result: expected FAIL before implementation. Vitest could not import the intentionally missing
config/scripts/ssh-relay-node-release-verification.mjs; one suite failed before collecting tests. -
Duration and resource metrics: 136 ms Vitest duration; archive/runtime resources do not apply.
-
Artifact/log/trace link: durable test path above; local command output retained in the implementation session.
-
Oracle proved: the focused suite was discriminating before the verifier facade and domain modules existed.
-
Does not prove: any validation behavior, cryptographic verification, downloaded byte, archive, extraction, runtime execution, SSH behavior, or platform tuple.
-
Checklist items satisfied: red half of the Milestone 3 Node provenance implementation gate only.
-
Follow-up: green implementation and real release-input proof are recorded in E-M3-NODE-PROVENANCE-001.
E-M3-NODE-PROVENANCE-001 — Pinned Node metadata and archive verification
-
Date: 2026-07-14
-
Commit SHA / PR: implementation commit
f2b387b21bbe6a3863ff1a492a1a03b65e0a0477in stacked draft PR #8741; native PR CI pending -
Runner: focused tests on macOS 26.2 arm64 with Node v26.0.0/pnpm 10.24.0; real proof in Docker Engine 29.2.1 on Linux/arm64 using
node:24-bookwormresolved tonode@sha256:032e78d7e54e352129831743737e3a83171d9cc5b5896f411649c597ce0b11ea, Node v24.17.0, and GnuPG/gpgv 2.2.40 -
Remote: not applicable; local container build-input verification only
-
Transport/network: HTTPS downloads from exact
https://nodejs.org/dist/v24.18.0/URLs; Debian package mirrors suppliedca-certificates,curl,gnupg, andgpgv; no SSH transport -
Exact command:
pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-release-verification.test.mjs docker run --rm -v "$PWD:/workspace:ro" -w /workspace node:24-bookworm \ bash -lc 'set -euo pipefail apt-get update -qq DEBIAN_FRONTEND=noninteractive apt-get install -y -qq ca-certificates curl gnupg gpgv >/dev/null mkdir -p /tmp/node-inputs curl --fail --silent --show-error --location --proto "=https" --tlsv1.2 https://nodejs.org/dist/v24.18.0/SHASUMS256.txt --output /tmp/node-inputs/SHASUMS256.txt curl --fail --silent --show-error --location --proto "=https" --tlsv1.2 https://nodejs.org/dist/v24.18.0/SHASUMS256.txt.sig --output /tmp/node-inputs/SHASUMS256.txt.sig curl --fail --silent --show-error --location --proto "=https" --tlsv1.2 https://nodejs.org/dist/v24.18.0/node-v24.18.0-linux-x64.tar.xz --output /tmp/node-inputs/node-v24.18.0-linux-x64.tar.xz node config/scripts/verify-ssh-relay-node-release-inputs.mjs --inputs-directory /tmp/node-inputs --archive linux-x64-glibc' -
Result: PASS. Seven focused tests passed. The real verifier accepted the pinned release-key hash
84b1ca614406f341cb86e72920f5a64687a13ab67ab84038bcf2abba97898a84, exact signerC82FA3AE1CBEDC6BE46B9360C43CEC45C17AB93C, authenticated checksum-document hash3927bab574a00ca0560c9583fe19655ba19603a1c5851414e4325d34ac50e469, all six pinned checksum entries, and the 31,511,588-byte Linux x64 archive hash55aa7153f9d88f28d765fcdad5ae6945b5c0f98a36881703817e4c450fa76742. -
Duration and resource metrics: final focused Vitest duration 160 ms; container provisioning, metadata download, archive download, and verification completed in approximately 11 seconds. Peak memory and network bytes were not instrumented; the accepted archive size was 31,511,588 bytes and hashing was streaming/bounded.
-
Artifact/log/trace link: committed contract, pinned ASCII release key, purpose-named verifier modules/CLI, and local command output; no artifact was published or retained in the repository.
-
Oracle proved: strict immutable six-tuple contract validation; bounded metadata/archive hashing; exact release-key bytes; detached-signature success through gpgv; exact signer fingerprint; authenticated checksum-to-archive cross-checking; duplicate/malformed/missing/mismatched input rejection in focused tests; and one real official Linux x64 archive byte hash.
-
Does not prove: archive safety or extraction, Linux x64 execution (the container was arm64), any bundled Node/native dependency/PTY/watcher behavior, the other five archive downloads, target-native assembly/signing, SSH transfer, release publication, cache behavior, or any enabled tuple.
-
Checklist items satisfied: Milestone 3 pinned Node/downloaded-binary checksum/upstream-signature implementation gate and the two Milestone 3 verification-command inventory entries only.
-
Follow-up: assemble the first runtime on a target-native runner, inspect its archive, execute its bundled Node and native dependencies, then fill only the evidence cells actually proved.
E-M3-WINDOWS-CONPTY-GAP-001 — Candidate omitted the production ConPTY runtime closure
-
Date: 2026-07-14
-
Commit SHA / PR: source audit while preparing implementation commit
922edb6ff28199b394f508731fd18a635bec49a0; draft PR #8741 -
Runner: macOS 26.2 arm64; source and installed-package inspection only
-
Remote and transport: none
-
Exact commands:
rg -n "useConpty|nodePty\\.spawn|pty\\.spawn" src/main src/shared sed -n '470,515p' src/main/daemon/pty-subprocess.ts sed -n '1,130p' node_modules/node-pty/scripts/post-install.js find node_modules/node-pty/third_party/conpty -maxdepth 3 -type f -print | sort rg -n "conpty\\.dll|OpenConsole|useConptyDll" \ config/scripts/ssh-relay-runtime-tree.mjs \ config/scripts/ssh-relay-runtime-smoke-child.cjs -
Result: discriminating discovery. Orca's daemon PTY spawn passes
useConptyDll: trueon Windows. Pinnednode-pty@1.1.0supplies architecture-specificconpty.dllandOpenConsole.exeunderthird_party/conpty/1.23.251008001/win10-{x64,arm64}and its postinstall copies those files tobuild/Release/conpty. The candidate directly invokednode-gyp, copied onlyconpty.nodeandconpty_console_list.node, and smoked withuseConpty: truebut notuseConptyDll: true. -
Oracle proved: the candidate artifact could pass its proposed smoke while omitting files required by the production relay PTY configuration. Both plan artifacts now require the exact ConPTY runtime closure and production-mode smoke before a Windows executable cell can pass.
-
Does not prove: corrected staging, artifact-tree identity, ConPTY execution, Authenticode/native trust, Windows build, SSH, transfer, install, or any enabled tuple.
-
Checklist items satisfied: none; this is a red gap record and its implementation item remains open.
-
Follow-up: stage the tuple-specific files without running an implicit downloader, copy and hash them into the runtime, use
useConptyDll: truein native smoke, and obtain Windows x64/arm64 CI evidence before checking the implementation item.
E-M3-WINDOWS-INPUT-GAP-001 — Windows ZIP lacks native build inputs
-
Date: 2026-07-14
-
Commit SHA / PR: investigation while implementing the Windows artifact-only slice in draft PR #8741; no Windows artifact was produced or enabled
-
Runner: macOS 26.2 arm64;
curlplus systemunzip; inspection only -
Remote and transport: exact HTTPS download from
https://nodejs.org/dist/v24.18.0/node-v24.18.0-win-x64.zip; no SSH or release upload -
Exact commands:
curl --fail --silent --show-error --location --proto '=https' --tlsv1.2 \ --connect-timeout 20 --max-time 300 --retry 2 --retry-delay 2 --retry-all-errors \ https://nodejs.org/dist/v24.18.0/node-v24.18.0-win-x64.zip \ --output /tmp/orca-node-win-input-check/node-v24.18.0-win-x64.zip unzip -l /tmp/orca-node-win-input-check/node-v24.18.0-win-x64.zip | \ rg 'node\\.exe$|include/node/node\\.h$|node\\.lib$|LICENSE$' curl --fail --silent --show-error --location --proto '=https' --tlsv1.2 \ https://nodejs.org/dist/v24.18.0/SHASUMS256.txt | \ rg 'headers|win-(x64|arm64)/node\\.lib|win-(x64|arm64)\\.zip' -
Result: discriminating discovery. The authenticated x64 ZIP contains 2,449 files and 105,728,964 expanded bytes, including the 92,534,088-byte
node.exeand rootLICENSE, but noinclude/node/node.hand nonode.lib. The same signed checksum document authenticatesnode-v24.18.0-headers.tar.gzas6c7d41d83c3481d2301115b8ce4a44b7d4fbfa52859b1aac14f445d460137887,win-x64/node.libas589684168a73547ca47cd22d76a4e465ef561abe89fb1b2b23fe35bbe857d505, andwin-arm64/node.libas7da03c5111815b69bbe63ffd2e51b28cd69eec9f545b7ccb8756efffdbb88dc2. -
Oracle proved: the original six-binary-archive contract is insufficient to build
node-ptyon Windows without an unrecordednode-gypdownload. Both plan artifacts now require the signed headers archive and per-architecture import library as explicit immutable build inputs. -
Does not prove: headers/import-library download or extraction, Windows build, ZIP determinism, bundled Node/ConPTY/watcher execution, signing/trust, SSH, or any enabled tuple.
-
Checklist items satisfied: Windows build-input policy correction only; implementation remains unchecked.
-
Follow-up: extend the signed input schema/verifier and hostile-input tests, stage only the required headers and
node.lib, then run the native Windows build with implicit downloads disabled.
E-M3-WINDOWS-ZIP-RED-001 — Windows ZIP/input contract red gate
-
Date: 2026-07-14
-
Commit SHA / PR: uncommitted Windows artifact-only tests on top of
c308107a9; draft PR #8741 -
Runner: macOS 26.2 arm64; Node v26.0.0 and pnpm 10.24.0
-
Remote and transport: none; synthetic local test discovery only
-
Exact command:
pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-runtime-zip.test.mjs \ config/scripts/ssh-relay-node-zip-inspection.test.mjs -
Result: expected FAIL before implementation. Both suites failed at import because the deliberately missing
ssh-relay-runtime-zip.mjsandssh-relay-node-zip-inspection.mjsmodules did not exist; zero tests were collected. -
Duration and resource metrics: 196 ms Vitest duration; archive/runtime resources do not apply.
-
Oracle proved: both Windows ZIP boundaries were discriminating before their implementations.
-
Does not prove: any ZIP validation, real Node input, Windows build/execution, SSH, or tuple support.
-
Checklist items satisfied: red half of the Windows ZIP/input contract gate only.
-
Follow-up: E-M3-WINDOWS-INPUT-001 records the first green implementation and real signed inputs.
E-M3-WINDOWS-INPUT-001 — Signed Windows Node inputs and bounded selective extraction
-
Date: 2026-07-14
-
Commit SHA / PR: implementation commit
922edb6ff28199b394f508731fd18a635bec49a0; draft PR #8741; native Windows CI pending -
Runners: focused tests and real selective extraction on macOS 26.2 arm64 with Node v26.0.0/pnpm 10.24.0; signature/checksum/file verification in native Linux arm64 container
node@sha256:032e78d7e54e352129831743737e3a83171d9cc5b5896f411649c597ce0b11eawith GnuPG/gpgv 2.2.40 -
Remote and transport: exact HTTPS inputs from
nodejs.org/dist/v24.18.0; no SSH, release upload, Windows execution, or remote-host egress -
Exact commands:
pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-release-verification.test.mjs \ config/scripts/ssh-relay-node-tar-inspection.test.mjs \ config/scripts/ssh-relay-node-zip-inspection.test.mjs \ config/scripts/ssh-relay-runtime-artifact.test.mjs \ config/scripts/ssh-relay-runtime-zip.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs docker run --rm \ -v "$PWD:/workspace:ro" -v /tmp/orca-node-win-input-check:/inputs:ro \ -w /workspace \ node@sha256:032e78d7e54e352129831743737e3a83171d9cc5b5896f411649c597ce0b11ea \ bash -lc 'set -euo pipefail apt-get update -qq DEBIAN_FRONTEND=noninteractive apt-get install -y -qq gnupg gpgv >/dev/null node config/scripts/verify-ssh-relay-node-release-inputs.mjs \ --inputs-directory /inputs --archive win32-x64' node --input-type=module -e \ "import {readFile} from 'node:fs/promises'; import {extractVerifiedSshRelayNodeZipBuildInputs} from './config/scripts/ssh-relay-node-zip-inspection.mjs'; const release=JSON.parse(await readFile( './config/ssh-relay-node-release-v24.18.0.json','utf8')); console.log(await extractVerifiedSshRelayNodeZipBuildInputs( release,'win32-x64','<node-zip>','<exclusive-destination>', {headersArchivePath:'<headers.tar.gz>',importLibraryPath:'<win-x64/node.lib>'}));" -
Result: PASS. Six focused suites passed 19/19 tests. The real verifier authenticated signer
C82FA3AE1CBEDC6BE46B9360C43CEC45C17AB93C, the exact signed checksum document, all nine pinned release inputs, the 37,176,245-byte x64 ZIP, 9,951,449-byte headers archive, and 2,986,260-byte x64 import library. Bounded ZIP inspection consumed 2,449 entries/1,984 files/105,728,964 expanded bytes and selectively staged onlynode.exeplusLICENSE. Bounded headers inspection consumed 3,326 entries/2,726 files/58,969,198 expanded bytes and staged onlyinclude;node.libwas rehashed before and after exclusive copy toRelease/node.lib. -
Resource and integrity details: all input hashing and archive entry verification streamed; each file was bounded by 256 MiB, aggregate input expansion by 1 GiB, path depth by 32, path bytes by 512, and entries by 100,000. Synthetic runtime ZIP creation was byte-identical for the same tree and epoch and rejected extra entries and content mismatch. Peak RSS, open files, and cancellation settlement were not instrumented in this local slice.
-
Oracle proved: exact schema and signed-checksum coverage for the Windows ZIP, common headers, and tuple import library; missing/malformed input rejection; safe portable ZIP paths, traversal and case-fold collision rejection; CRC-32 plus SHA-256 streaming; bounded selective extraction; exact post-copy hashes; and deterministic synthetic runtime ZIP packing/inspection.
-
Does not prove: native Windows
node-ptybuild, thatnode-gypsucceeds offline, bundlednode.exe/ConPTY/watcher execution, full-runtime ZIP identity on Windows, Windows x64/arm64 signing/trust, oldest baseline, SSH/SFTP/system-SSH, release publication, cache/fallback/UI, or any enabled tuple. Localgpg/gpgvwere unavailable on macOS, so the signature proof is the pinned Linux container command above; Windows jobs explicitly select Git for Windows' bundled tools. -
Checklist items satisfied: explicit signed Windows build-input contract and bounded local staging only; no Windows per-tuple build/executable cell is checked.
-
Follow-up: run the exact builder on native
windows-2022andwindows-11-arm, require the loopback-onlynode-gypfallback URL to remain unused, and record only the cells actually passed.
E-M3-WINDOWS-LOCAL-002 — Corrected Windows artifact contracts and local static gates
-
Date: 2026-07-14
-
Commit SHA / PR: implementation commit
922edb6ff28199b394f508731fd18a635bec49a0; draft PR #8741 -
Runner: macOS 26.2 arm64; Node v26.0.0 and pnpm 10.24.0. The repository requires Node 24, so exact-head draft-PR CI is the authoritative supported-Node result.
-
Remote and transport: none; synthetic contracts and repository static checks only
-
Exact commands:
pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-release-verification.test.mjs \ config/scripts/ssh-relay-node-tar-inspection.test.mjs \ config/scripts/ssh-relay-node-zip-inspection.test.mjs \ config/scripts/ssh-relay-runtime-artifact.test.mjs \ config/scripts/ssh-relay-runtime-windows-tree.test.mjs \ config/scripts/ssh-relay-runtime-zip.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm run typecheck pnpm exec oxlint pnpm run check:max-lines-ratchet GOMAXPROCS=2 pnpm run lint pnpm exec oxfmt --check \ docs/reference/plans/2026-07-14-ssh-relay-github-release-implementation-checklist.md \ docs/reference/plans/2026-07-14-ssh-relay-github-release-plan.html git diff --check -
Result: PASS. Seven focused suites passed 21/21 tests in 290 ms. Typecheck, oxlint, max-lines, full lint/reliability/localization gates, plan formatting, and diff whitespace passed. Oxlint reported only pre-existing warnings outside this package. Full lint used
GOMAXPROCS=2because the external Go type-aware linter had previously segfaulted on an existing dependency declaration at unconstrained concurrency. -
Oracle proved: deterministic synthetic Windows ZIP packing and complete ZIP reinspection; signed-input schema and bounded ZIP/header staging contracts; Windows-unsafe header path rejection; the Windows runtime-tree identity contains
conpty.dllandOpenConsole.exeas native runtime files; the smoke configuration selectsuseConptyDll: true; the workflow declares exact x64/arm64 native runners and has read-only, unpublished artifact authority. -
Resource metrics: focused Vitest duration 290 ms. Runtime RSS, open files/channels, cancellation settlement, artifact size, and native build/smoke duration do not apply to these synthetic checks and remain open for target-native evidence.
-
Does not prove: Windows native compilation, offline
node-gyp, staged ConPTY execution, bundled-Node/PTY/watcher smoke, full artifact bytes or reproducibility, native trust/signing, oldest baseline, SSH transfer/install, publication, resolver/cache/fallback/UI, or any enabled tuple. -
Checklist items satisfied: the added purpose-named local Windows-tree command only. Windows per-tuple build/executable and ConPTY implementation boxes remain unchecked pending native CI.
-
Follow-up: push this exact implementation head and record exact Windows x64/arm64 jobs, images, artifact IDs/hashes/sizes, build/verify/smoke durations, RSS, and any discriminating failure.
E-M3-WINDOWS-CI-RED-002 — First Windows native jobs stopped at contract tests
-
Date: 2026-07-14
-
Commit SHA / PR: exact workflow head
539cd060e74386ba33bf1291c940b68fba9af13bcontaining implementation commit922edb6ff28199b394f508731fd18a635bec49a0; draft PR #8741 -
Native jobs:
- x64 job
87105197603: requestedwindows-2022; resolvedwin22image20260706.237.1, GitHub-hosted X64, Windows Server 2022 Datacenter build 20348, Node v24.18.0; failed after 1m17s. - arm64 job
87105197605: requestedwindows-11-arm; resolvedwin11-arm64image20260706.102.1, GitHub-hosted ARM64, Windows 10 Enterprise build 26200, Node v24.18.0; failed after 3m37s.
- x64 job
-
Remote and transport: none. Both jobs stopped before Node input download, native build, runtime smoke, or artifact upload.
-
Exact commands:
gh api repos/stablyai/orca/actions/jobs/87105197603/logs > /tmp/orca-win-x64-red.log gh api repos/stablyai/orca/actions/jobs/87105197605/logs > /tmp/orca-win-arm64-red.log rg -n "requested_runner=|resolved_image_os=|resolved_image_version=|runner_arch=|WindowsProductName|WindowsVersion|OsBuildNumber|source_commit=|FAIL|SyntaxError|Node archive is missing" \ /tmp/orca-win-x64-red.log /tmp/orca-win-arm64-red.log -
Result: FAIL as a discriminating pre-build gate on both architectures. Each run reported three failed and four passed suites, with one failed and ten passed collected tests. The x64 test phase took 1.26s; arm64 took 1.33s.
ssh-relay-node-tar-inspection.test.mjscreated its POSIX tar fixture from an NTFS file and therefore lost the declaredbin/nodeexecute bit; the production inspector correctly rejected it.ssh-relay-node-release-verification.test.mjsandssh-relay-runtime-artifact.test.mjsseparately failed at import with onlySyntaxError: Invalid or unexpected token; the first logs did not identify a source location. -
Discriminating follow-up: exact head
55f7137c6e065481d2f58fed1353df9a75914fc8reran in run 29339487426. X64 job87107170544proved the explicit tar-mode correction: five suites and all 11 collected tests passed in 1.24s. Only the same two import-time syntax errors remained. Both failing suites import a command-line.mjsfile with a Unix shebang, while every supported call site already invokes those files throughnode; the next correction removes only those unused shebangs and preserves the CLI main guards. -
Second follow-up: exact head
ef94c90663740c657d44e93f758c99016e66b61areran in run 29339742904. X64 job87108126824collected all seven suites and 21 tests, proving the shebang correction. Eighteen tests passed, one POSIX archive test skipped as designed, and two Windows-specific assertions failed in 1.17s: Git checkout converted the pinned armored key from LF to CRLF, and a POSIXchmod(0o600)rejection assertion ran even though the Windows verifier intentionally takes modes from verified ZIP metadata. The received key hash25cc2da386fe54cfc6a3d683f1df2a5f636014a31be8efadd73a9ecc2208dbecexactly matchessed 's/$/\r/' <pinned-key> | shasum -a 256; the committed LF bytes remain84b1ca614406f341cb86e72920f5a64687a13ab67ab84038bcf2abba97898a84. -
Oracle proved: both requested hosted runner labels resolve to native Node 24 environments, MSVC setup succeeds, Git for Windows supplies both required GPG tools, frozen source installation succeeds, and the test command stops the artifact build before any download or upload. It also discriminated one cross-platform fixture assumption.
-
Does not prove: that the explicit-mode fixture correction is green on Windows; the cause of the two import-time syntax errors; Node input download/signature verification; native compilation; offline
node-gyp; bundled Node/ConPTY/watcher execution; ZIP output; native trust; SSH; or any enabled tuple. -
Checklist items satisfied: exact Windows runner-label resolution only. No Windows build, executable, archive, or artifact cell is checked.
-
Follow-up: mark the pinned armored key
-textso checkout preserves its authenticated bytes, keep the filesystem-mode mutation assertion POSIX-only, and rerun both native architectures. Continue to block input download/build until all seven suites pass.
E-M3-WINDOWS-CI-RED-003 — Native Windows input verification exposed GPG path incompatibility
-
Date: 2026-07-14
-
Commit SHA / PR: exact workflow head
b387ac48cda70b60a5a148c03ce740f9afedf9cb; draft PR #8741 -
Native jobs:
- x64 job
87109014067: requestedwindows-2022; resolvedwin22image20260706.237.1, GitHub-hosted X64, Windows Server 2022 Datacenter build 20348, Node v24.18.0; failed after 1m21s. - arm64 job
87109014073: requestedwindows-11-arm; resolvedwin11-arm64image20260706.102.1, GitHub-hosted ARM64, Windows 10 Enterprise build 26200, Node v24.18.0; failed after approximately 3m.
- x64 job
-
Remote and transport: none. Each job downloaded exact HTTPS inputs from
nodejs.org/dist/v24.18.0; neither reached archive extraction, native compilation, smoke, ZIP creation, or artifact upload. -
Exact commands:
gh run view 29339998273 --repo stablyai/orca \ --json databaseId,headSha,status,conclusion,url,createdAt,updatedAt,jobs gh api repos/stablyai/orca/actions/jobs/87109014067/logs | \ rg -n -C 12 "SSH relay runtime build failed|gpgv rejected|invalid key resource|Process completed with exit code" gh api repos/stablyai/orca/actions/jobs/87109014073/logs | \ rg -n -C 12 "SSH relay runtime build failed|gpgv rejected|invalid key resource|Process completed with exit code" -
Result: FAIL as a discriminating signed-input gate on both architectures. All seven focused suites collected on each runner; 20 tests passed and one POSIX-only test skipped as designed in 1.17s on x64 and 1.47s on arm64. Exact Node inputs downloaded successfully. Git for Windows
gpgvthen rejected the exclusive verified-copy keyring path before signature acceptance:invalid key resource URL 'C:\\...\\release-key.gpg'. GnuPG interprets the drive-letter colon as a resource-URL scheme at this option boundary. Both runners failed closed withNo public key; no unverified archive was extracted or executed. -
Oracle proved: the preceding fixture, shebang, checkout-byte, and filesystem-mode corrections are green on both native Windows architectures; exact release inputs are downloadable; the production signature gate executes and prevents unverified bytes from progressing. The identical x64/arm64 failure isolates command-path representation rather than architecture-specific cryptography.
-
Does not prove: successful Windows signature verification, archive/header/import-library extraction, offline
node-gyp, native compilation, bundled Node/ConPTY/watcher execution, ZIP output or determinism, native trust/signing, oldest baseline, SSH, or any enabled tuple. -
Checklist items satisfied: Windows contract-test portability and fail-closed signed-input behavior only. No Windows build, executable, archive, or artifact cell is checked.
-
Follow-up: run both GPG commands in the exclusive verified-copy directory with cwd-relative paths, assert the command boundary never receives an absolute drive-letter path, and rerun both native architectures before any broader Windows correction.
E-M3-WINDOWS-GPG-PATH-RED-001 — Relative verified-copy command boundary red gate
- Date: 2026-07-14
- Commit SHA / PR: red test introduced before its implementation in correction commit
b6903b220; exact baseb387ac48cda70b60a5a148c03ce740f9afedf9cb; draft PR #8741 - Runner: macOS 26.2 arm64; Node v26.0.0 and pnpm 10.24.0
- Remote and transport: none; mocked child-process command boundary only
- Exact command:
pnpm exec vitest run --config config/vitest.config.ts config/scripts/ssh-relay-node-release-verification.test.mjs - Result: expected FAIL; one new test failed and seven existing tests passed in 163 ms. The failure
diff showed absolute temporary paths passed to both
gpg --outputandgpgv --keyring, while the required oracle expected cwd-relative verified-copy names and a common exclusive working directory. - Oracle proved: the regression test discriminates the exact command representation rejected by Git for Windows in E-M3-WINDOWS-CI-RED-003 without weakening signature/fingerprint validation.
- Does not prove: real GPG execution, Windows compatibility, successful signature verification, archive extraction/build/smoke, or any tuple support.
- Checklist items satisfied: red half of the Windows GPG path-portability correction only.
- Follow-up: add cwd support to the bounded command runner, pass only explicit relative verified-copy names, rerun this focused suite, and require native x64/arm64 CI before claiming the correction.
E-M3-WINDOWS-GPG-PATH-LOCAL-001 — Relative verified-copy command boundary correction
-
Date: 2026-07-14
-
Commit SHA / PR: implementation commit
b6903b220on exact baseb387ac48cda70b60a5a148c03ce740f9afedf9cb; draft PR #8741 -
Runner: macOS 26.2 arm64; Node v26.0.0 and pnpm 10.24.0. The repository requires Node 24, so exact-head draft-PR CI remains authoritative.
-
Remote and transport: none; mocked GPG command-boundary regression plus local contract/static checks
-
Exact commands:
pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-release-verification.test.mjs pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-release-verification.test.mjs \ config/scripts/ssh-relay-node-tar-inspection.test.mjs \ config/scripts/ssh-relay-node-zip-inspection.test.mjs \ config/scripts/ssh-relay-runtime-artifact.test.mjs \ config/scripts/ssh-relay-runtime-windows-tree.test.mjs \ config/scripts/ssh-relay-runtime-zip.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm run typecheck pnpm exec oxlint pnpm run check:max-lines-ratchet GOMAXPROCS=2 pnpm run lint pnpm exec oxfmt --check \ docs/reference/plans/2026-07-14-ssh-relay-github-release-implementation-checklist.md \ docs/reference/plans/2026-07-14-ssh-relay-github-release-plan.html git diff --check -
Result: PASS. The focused signature suite passed 8/8 tests in 151 ms; all seven artifact suites passed 22/22 tests in 313 ms. Typecheck, full oxlint, max-lines ratchet, full lint/reliability/localization gates, plan formatting, and diff whitespace passed. Oxlint reported only existing warnings outside this package; full lint used
GOMAXPROCS=2for the previously recorded external Go linter stability constraint. -
Oracle proved: both GPG invocations share the exclusive verified-copy directory as their cwd and receive only explicit
./paths for the key, keyring, checksum, and signature; existing hash, command-failure, and exact-fingerprint tests remain green. -
Does not prove: real GPG execution, Git for Windows compatibility, Node 24 support, Windows native build/smoke, archive output, or any tuple support.
-
Checklist items satisfied: local green half of the path-portability correction only. Native CI is still mandatory before the E-M3-WINDOWS-CI-RED-003 failure is considered corrected.
-
Follow-up: run the exact correction on Windows x64/arm64 and all four POSIX artifact jobs, then record any next discriminating native boundary without broadening this work package.
E-M3-WINDOWS-CI-RED-004 — Native Windows assembly reached an opaque bounded smoke timeout
-
Date: 2026-07-14
-
Commit SHA / PR: exact workflow head
42aa02fa9eccf81e40d80f87461ddd232a1cda1f, containing implementation commitb6903b220; draft PR #8741 -
Run: SSH Relay Runtime Artifacts 29340686444, conclusion
failure; all four POSIX regression jobs passed and uploaded only unpublished seven-day Actions artifacts. -
Native Windows jobs:
- x64 job
87111302431:windows-2022, resolvedwin22image20260706.237.1, GitHub-hosted X64, Windows Server 2022 Datacenter build 20348, Node v24.18.0; failed after 4m37s. - arm64 job
87111302486:windows-11-arm, resolvedwin11-arm64image20260706.102.1, GitHub-hosted ARM64, Windows 10 Enterprise build 26200, Node v24.18.0; failed after 7m9s.
- x64 job
-
Remote and transport: no SSH remote. Exact inputs came from
nodejs.org/dist/v24.18.0; no release publication or Windows artifact upload occurred. -
Exact commands:
gh run view 29340686444 --repo stablyai/orca \ --json databaseId,headSha,status,conclusion,url,createdAt,updatedAt,jobs gh api repos/stablyai/orca/actions/jobs/87111302431/logs | \ rg -n -C 25 "SSH relay runtime verification failed|durationMs|contentId|Process completed with exit code" gh api repos/stablyai/orca/actions/jobs/87111302486/logs | \ rg -n -C 25 "SSH relay runtime verification failed|durationMs|contentId|Process completed with exit code" gh api --paginate repos/stablyai/orca/actions/runs/29340686444/artifacts -
Result: FAIL at the native bundled smoke on both architectures. Each runner passed all seven contract suites with 21 passing and one intentionally skipped test, authenticated the exact Node checksum/signature plus ZIP/headers/import library, compiled the patched native modules, assembled and reinspected a 60-entry/42-file deterministic-format ZIP, and entered verification's smoke only after archive/tree integrity checks. X64 produced a 37,212,065-byte ZIP expanding to 97,248,414 bytes, content ID
90823b2c6bf7dad748a4399fe74fdfa8be82ef4a00d727e3a6be173f274fd43f, archive SHA-256ee7634dea179026b3ba8232294016d939e32edc34e1fd3697dd9e11722285d6a, and 146,511.617 ms build duration. Arm64 produced a 33,261,531-byte ZIP expanding to 86,189,740 bytes, content ID09ec2772bb8c47ee240fd226963b7e251a8060e7f84321cb24d2668bf993e2ca, archive SHA-2565cb50521ec88d491f1a4183fc13f0b0f688e242e290038c4d34e0125d8e8b2c2, and 176,108.728 ms build duration. -
Failure boundary: each bundled-Node smoke exceeded the parent command's 45-second timeout. The child already bounds PTY and watcher waits at 15 seconds and writes its classified failure to stderr, but
verify-ssh-relay-runtime.mjscurrently reports only the genericexecFilestack. The logs therefore cannot distinguish PTY, watcher, cleanup-handle, or combined failure. Upload remained skipped. Smoke RSS, channel/file counts, and cancellation settlement were not emitted. -
Oracle proved: the GPG relative-path correction works through real Git-for-Windows GPG on native x64 and arm64; signed-input gating, offline native build inputs, patched native compilation, bundled Node v24.18.0 staging, ZIP construction/inspection, and pre-execution archive/tree gates all precede the failing smoke. The four POSIX jobs remain green on the exact same source head.
-
Does not prove: successful Windows PTY/ConPTY/watcher execution, which smoke substage failed, prompt child-process settlement, ZIP clean-rebuild identity, durable Windows artifact bytes, native trust/signing, oldest baseline, SSH, or any enabled tuple.
-
Checklist items satisfied: native GPG path portability and pre-smoke Windows assembly progression only. Windows per-tuple cells remain unchecked because executable smoke and artifact retention did not pass.
-
Follow-up: preserve bounded child stdout, stderr, timeout, exit, and signal details in the parent diagnostic; add a failure-path unit test; rerun x64 first and change no PTY/watcher behavior until the classified child failure is visible.
E-M3-WINDOWS-SMOKE-DIAGNOSTIC-RED-001 — Bounded child-detail propagation red gate
- Date: 2026-07-14
- Commit SHA / PR: red test introduced before its implementation in
3aab5aff8; exact base42aa02fa9eccf81e40d80f87461ddd232a1cda1f; draft PR #8741 - Runner: macOS 26.2 arm64; Node v26.0.0 and pnpm 10.24.0
- Remote and transport: none; synthetic child-process error object only
- Exact command:
pnpm exec vitest run --config config/vitest.config.ts config/scripts/ssh-relay-runtime-artifact.test.mjs - Result: expected FAIL; the new diagnostic test failed and three existing tests passed in 239 ms
because
formatSshRelayRuntimeSmokeFailuredid not exist. The required oracle supplies timeout, exit/signal state, partial stdout, and a greater-than-limit stderr whose final classified failure must survive explicit truncation. - Oracle proved: existing parent diagnostics cannot satisfy the bounded failure-detail contract and the new test discriminates both missing metadata and unbounded/error-tail-losing implementations.
- Does not prove: child execution, Windows behavior, the actual PTY/watcher failure, cleanup settlement, or any tuple support.
- Checklist items satisfied: red half of the smoke-diagnostic correction only.
- Follow-up: implement a 64-KiB tail-preserving formatter around the already 4-MiB-bounded child
process, wrap
execFilefailure with it, and rerun focused/static gates before native x64 CI.
E-M3-WINDOWS-SMOKE-DIAGNOSTIC-LOCAL-001 — Bounded child-detail propagation correction
-
Date: 2026-07-14
-
Commit SHA / PR: implementation commit
3aab5aff8on exact base42aa02fa9eccf81e40d80f87461ddd232a1cda1f; draft PR #8741 -
Runner: macOS 26.2 arm64; Node v26.0.0 and pnpm 10.24.0. Exact-head Node 24 CI remains authoritative.
-
Remote and transport: none; synthetic child-process error plus local artifact contracts
-
Exact commands:
pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-runtime-artifact.test.mjs pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-release-verification.test.mjs \ config/scripts/ssh-relay-node-tar-inspection.test.mjs \ config/scripts/ssh-relay-node-zip-inspection.test.mjs \ config/scripts/ssh-relay-runtime-artifact.test.mjs \ config/scripts/ssh-relay-runtime-windows-tree.test.mjs \ config/scripts/ssh-relay-runtime-zip.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm run typecheck pnpm exec oxlint \ config/scripts/verify-ssh-relay-runtime.mjs \ config/scripts/ssh-relay-runtime-artifact.test.mjs pnpm exec oxlint pnpm run check:max-lines-ratchet GOMAXPROCS=2 pnpm run lint pnpm exec oxfmt --check \ docs/reference/plans/2026-07-14-ssh-relay-github-release-implementation-checklist.md \ docs/reference/plans/2026-07-14-ssh-relay-github-release-plan.html git diff --check -
Result: PASS. The focused artifact suite passed 4/4 tests in 194 ms; all seven artifact suites passed 23/23 tests in 293 ms. Typecheck, focused and full oxlint, max-lines ratchet, full lint/reliability/localization gates, plan formatting, and diff whitespace passed. Full lint reported only existing warnings outside this package and used the recorded
GOMAXPROCS=2stability constraint. -
Oracle proved: any failed bundled-smoke child now propagates the declared 45-second parent timeout, exit code, kill state, signal, message, stdout, and stderr; each stream retains at most its final 64 KiB with an explicit omitted-byte count. The real command remains capped at 4 MiB and no success-path parsing or smoke behavior changed.
-
Does not prove: real child failure propagation on Windows, which PTY/watcher stage fails, process-tree settlement after timeout, successful native smoke, or any tuple support.
-
Checklist items satisfied: local green half of the bounded smoke-diagnostic correction only.
-
Follow-up: rerun native Windows x64, capture the classified child tail, and make no execution-path change until that evidence identifies the actual failure.
E-M3-WINDOWS-SMOKE-SETTLEMENT-CI-RED-001 — Native Windows smoke succeeds but does not settle
-
Date: 2026-07-14
-
Commit SHA / PR: exact workflow head
df661e370102b9b66c26f4c708e641abef0aa1ae; draft PR #8741 -
Runners and jobs: GitHub Actions run 29341643555; Windows x64 job 87114639412,
windows-2022image20260706.237.1, Windows Server 2022 10.0.20348, native x64, Node v24.18.0; Windows arm64 job 87114639449,windows-11-arm64image20260706.102.1, Windows 11 Enterprise 10.0.26200, native arm64, Node v24.18.0 -
Remote and transport: no SSH remote; target-native artifact build and bundled-runtime execution on the hosted runner; exact signed inputs downloaded from pinned nodejs.org URLs
-
Exact command:
gh api repos/stablyai/orca/actions/jobs/87114639412/logs | \ rg -n -C 16 'Bundled runtime smoke command failed|timeoutMs=|Image:|Version:' gh api repos/stablyai/orca/actions/jobs/87114639449/logs | \ rg -n -C 16 'Bundled runtime smoke command failed|timeoutMs=|Image:|Version:' -
Result: expected discriminating FAIL. The exact signed inputs, offline native build, archive and complete-tree verification all passed. Bundled Node v24.18.0/ABI 137 then completed the patched ConPTY smoke with exit 23, 101×37 resize, input marker, and both native modules loaded from
build/Release; watcher create, update, rename-as-delete/create, and delete also completed. The x64 child emitted valid JSON after 3,357.413 ms with 56,905,728-byte RSS; arm64 emitted the same functional result after 6,593.663 ms with 54,505,472-byte RSS. Both remained alive until the parent killed them at 45 seconds (code=null,killed=true,signal="SIGTERM", empty stderr). -
Artifact metrics: x64 content ID
sha256:8cf9eb4e04459e25d710a28235a57e777d39f65168841c2408ab658243a21d94; ZIP 37,212,068 bytes with SHA-256sha256:11f83971ed20cde7be41aa2f753cfd4350cd4a70a3fe46a27540ebc872c4ca56; build 151,226.208 ms. Arm64 content IDsha256:dda60b6237b320c74236f57bece072d0f847479eb322f43f22c829daf2ce9bf6; ZIP 33,261,533 bytes with SHA-256sha256:f3fefed7b959fb6c3945170e8f0f7d2766cf26240aef9928b0e25770e5b19a26; 86,189,740 expanded bytes; build 248,307.259 ms. Uploads remained skipped because prompt process settlement is part of executable proof. -
Oracle proved: Windows x64 and arm64 PTY/ConPTY and watcher functionality succeeds through each exact bundled runtime, and the common remaining failure occurs after successful JSON emission in child-process handle settlement rather than in PTY, watcher, archive, or tree validation.
-
Does not prove: prompt cleanup, durable artifact upload, clean-rebuild identity, native trust/signing, oldest baseline, SSH, or any enabled tuple. Both per-tuple rows remain unchecked until the child exits normally and exact-head CI retains each artifact.
-
Follow-up: retain and dispose the PTY listener subscriptions, call the supported Windows terminal cleanup after a validated successful exit, and prove normal child settlement without
process.exit()on both native architectures.
E-M3-WINDOWS-SMOKE-SETTLEMENT-LOCAL-RED-001 — PTY lifecycle cleanup contract red gate
- Date: 2026-07-14
- Commit SHA / PR: uncommitted contract test and behavior-preserving PTY-smoke module extraction on
exact base
df661e370102b9b66c26f4c708e641abef0aa1ae; draft PR #8741 - Runner: macOS 26.2 arm64; Node v26.0.0 and pnpm 10.24.0
- Remote and transport: none; injected terminal/listener lifecycle only
- Exact command:
pnpm exec vitest run --config config/vitest.config.ts config/scripts/ssh-relay-runtime-pty-smoke.test.mjs - Result: expected FAIL in 122 ms. The Windows success case returned a valid exit result but called
terminal.kill()zero times; the POSIX success case and Windows case both disposed zero of their threeonData/onExitsubscriptions. Two tests failed, with no timeout or synthetic forced exit. - Oracle proved: the current success path lacks the exact listener and ConPTY cleanup operations required by the native x64 diagnostic, and the purpose-named suite distinguishes Windows-only terminal cleanup from platform-neutral listener disposal.
- Does not prove: the green implementation, actual Windows handle release, timeout/error cleanup, full child-process settlement, arm64 behavior, or any tuple support.
- Checklist items satisfied: red half of the Windows PTY smoke-settlement correction only.
- Follow-up: add idempotent finally cleanup, preserve successful POSIX no-kill behavior, rerun this suite and all artifact/static gates, then require exact-head native Windows CI.
E-M3-WINDOWS-SMOKE-SETTLEMENT-LOCAL-001 — Explicit PTY resource settlement
-
Date: 2026-07-14
-
Commit SHA / PR: implementation commit
ddf28eb8dba3ade4806082cfc5edd6526389cf94; draft PR #8741 -
Runner: macOS 26.2 arm64; Node v26.0.0 and pnpm 10.24.0. Exact-head Node 24 native CI remains authoritative.
-
Remote and transport: none; injected terminal lifecycle plus local source/static verification
-
Exact commands:
pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-runtime-pty-smoke.test.mjs pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-release-verification.test.mjs \ config/scripts/ssh-relay-node-tar-inspection.test.mjs \ config/scripts/ssh-relay-node-zip-inspection.test.mjs \ config/scripts/ssh-relay-runtime-artifact.test.mjs \ config/scripts/ssh-relay-runtime-pty-smoke.test.mjs \ config/scripts/ssh-relay-runtime-windows-tree.test.mjs \ config/scripts/ssh-relay-runtime-zip.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm run typecheck pnpm exec oxlint \ config/scripts/ssh-relay-runtime-smoke-child.cjs \ config/scripts/ssh-relay-runtime-pty-smoke.cjs \ config/scripts/ssh-relay-runtime-pty-smoke.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm run check:max-lines-ratchet GOMAXPROCS=2 pnpm run lint pnpm exec oxfmt --check .github/workflows/ssh-relay-runtime-artifacts.yml \ config/scripts/ssh-relay-runtime-smoke-child.cjs \ config/scripts/ssh-relay-runtime-pty-smoke.cjs \ config/scripts/ssh-relay-runtime-pty-smoke.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs \ docs/reference/plans/2026-07-14-ssh-relay-github-release-implementation-checklist.md git diff --check -
Result: PASS. The lifecycle suite passed 2/2 tests in 117 ms; the eight artifact suites passed 25/25 tests in 417 ms. Typecheck, focused oxlint, max-lines ratchet, full lint/reliability/localization checks, formatting, and diff whitespace passed. Full lint reported only pre-existing warnings outside this package.
-
Oracle proved: the success path retains and disposes both data subscriptions and the exit subscription exactly once; a validated Windows exit additionally calls the supported node-pty terminal cleanup exactly once, while a successful POSIX exit does not kill its terminal. Cleanup is in
finally, the existing timeout/error path still kills the terminal, and noprocess.exit()was introduced. Both native workflow families now run the lifecycle contract. -
Does not prove: actual Windows ConPTY handle release, prompt bundled child-process exit, exact-head Node 24 behavior, artifact retention, clean-rebuild identity, native trust, oldest baseline, SSH, or any enabled tuple. Both Windows per-tuple cells remain unchecked.
-
Checklist items satisfied: local green half of the PTY smoke-settlement correction and its purpose-named verification-command inventory only.
-
Follow-up: commit and push the isolated correction, run both target-native Windows jobs at the exact head, and require normal smoke completion plus artifact upload before advancing.
E-M3-WINDOWS-SMOKE-SETTLEMENT-CI-RED-002 — Explicit PTY cleanup is insufficient on native x64
- Date: 2026-07-14
- Commit SHA / PR: exact workflow head
b6291e55b1781b4c4e6f46a4965152f4a0d2334f, containing PTY settlement implementationddf28eb8dba3ade4806082cfc5edd6526389cf94; draft PR #8741 - Runners and jobs: GitHub Actions run
29342918504; Windows x64 job
87119092333,
windows-2022native x64 with Node v24.18.0; Windows arm64 job 87119092293,windows-11-arm64native arm64 with Node v24.18.0 - Remote and transport: no SSH remote; target-native artifact build and bundled-runtime execution
- Exact commands:
gh api repos/stablyai/orca/actions/jobs/87119092333/logs | rg -n -C 20 'SSH relay runtime verification failed|timeoutMs=|durationMs|rssBytes|contentId'and the same command for job87119092293 - Result: expected discriminating FAIL. The new 25/25 contract suite passed, followed by signed
inputs, offline native compilation, archive/tree inspection, and functional bundled smoke. The
child emitted PTY exit 23, 101×37 resize, input, patched native paths, all watcher events, and
valid JSON in 3,344.690 ms with 59,699,200-byte RSS, then again remained alive until the parent
killed it at 45 seconds with empty stderr. ZIP size was 37,212,067 bytes, content ID
sha256:68a49782761c411494e677be9c2dc5038fb4f85f066316edc7b92ee25a3c3fbd, archive SHA-256sha256:11688158da540cdfa1e10e5f632dac7487adf61e600e46d3fb0303fa42fc15b6, and build duration 139,167.307 ms. Artifact upload remained skipped. - Arm64 result: the same valid PTY/watcher JSON arrived in 3,772.018 ms with 54,095,872-byte RSS,
followed by the identical 45-second timeout and empty stderr. ZIP size was 33,261,534 bytes,
content ID
sha256:cff683eba32500f95d4a1a87d8f8a8eaf06613753b75d8eff55ccce23a0160c6, archive SHA-256sha256:12640e6003547cf94f6ab13c6fdecb6373254b724fb561aa38023a3d33b5fa17, and build duration 155,781.418 ms. Upload remained skipped. - Oracle proved: disposing all public PTY subscriptions and calling public Windows terminal cleanup after validated exit does not by itself settle the bundled child. The failure remains post-smoke and is not a PTY/watcher functional failure, but the retained resource type is still unknown.
- Does not prove: which PTY worker/socket, watcher, stdio, timer, or other resource remains; safe dependency-level remediation; normal child exit; artifact retention; or any tuple.
- Checklist items satisfied: none beyond a new native red boundary; Windows rows remain unchecked.
- Follow-up: emit bounded
process.getActiveResourcesInfo()data after all smoke cleanup, retain it through the existing parent diagnostic, and make no further cleanup change until the resource class is visible on native Windows.
E-M3-WINDOWS-RESOURCE-DIAGNOSTIC-LOCAL-001 — Bounded post-cleanup resource observation
-
Date: 2026-07-14
-
Commit SHA / PR: diagnostic implementation commit
6bba900209543a53b7673ca12173159d40d9fc87; draft PR #8741 -
Runner: macOS 26.2 arm64; Node v26.0.0 and pnpm 10.24.0. Native Windows classification remains authoritative.
-
Remote and transport: none; injected public active-resource lists plus local source/static gates
-
Exact commands:
pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-runtime-resource-diagnostics.test.mjs \ config/scripts/ssh-relay-runtime-pty-smoke.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-release-verification.test.mjs \ config/scripts/ssh-relay-node-tar-inspection.test.mjs \ config/scripts/ssh-relay-node-zip-inspection.test.mjs \ config/scripts/ssh-relay-runtime-artifact.test.mjs \ config/scripts/ssh-relay-runtime-pty-smoke.test.mjs \ config/scripts/ssh-relay-runtime-resource-diagnostics.test.mjs \ config/scripts/ssh-relay-runtime-windows-tree.test.mjs \ config/scripts/ssh-relay-runtime-zip.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm run typecheck pnpm exec oxlint config/scripts/ssh-relay-runtime-resource-diagnostics.cjs \ config/scripts/ssh-relay-runtime-resource-diagnostics.test.mjs \ config/scripts/ssh-relay-runtime-smoke-child.cjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm run check:max-lines-ratchet GOMAXPROCS=2 pnpm run lint pnpm exec oxfmt --check .github/workflows/ssh-relay-runtime-artifacts.yml \ config/scripts/ssh-relay-runtime-resource-diagnostics.cjs \ config/scripts/ssh-relay-runtime-resource-diagnostics.test.mjs \ config/scripts/ssh-relay-runtime-smoke-child.cjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs \ docs/reference/plans/2026-07-14-ssh-relay-github-release-implementation-checklist.md git diff --check -
Result: PASS. The resource/PTY/workflow slice passed 6/6 tests in 173 ms; all nine artifact suites passed 27/27 tests in 297 ms. Typecheck, focused oxlint, max-lines, full lint/reliability/localization, formatting, and whitespace gates passed with only existing out-of-package lint warnings.
-
Oracle proved: Windows diagnostics use the public
process.getActiveResourcesInfo()API, retain only at most 256 resource type strings capped at 128 characters, report omitted counts, and take snapshots immediately after all functional cleanup and after a two-second drain window. POSIX smoke receives neither the delay nor a resource probe. Both native workflow families run the contract. -
Does not prove: the actual retained native Windows resource types, whether the culprit is PTY or watcher state, safe cleanup, normal child exit, artifact retention, or any tuple.
-
Checklist items satisfied: bounded local diagnostic contract and verification-command inventory only; no behavior, matrix, or tuple item.
-
Follow-up: commit and push the diagnostic, capture both native Windows snapshots through the existing 45-second failure formatter, then change only the resource owner identified by evidence.
E-M3-WINDOWS-RESOURCE-DIAGNOSTIC-CI-RED-001 — Native Windows retains one MessagePort
-
Date: 2026-07-14
-
Commit SHA / PR: exact workflow head
2aaea70465dc80ced2ba4662b5bc1475a9c2f8c5, containing bounded diagnostic implementation6bba900209543a53b7673ca12173159d40d9fc87; draft PR #8741 -
Runners and jobs: GitHub Actions run 29343816558; Windows x64 job 87122172498,
windows-2022image20260706.237.1, native x64, runner2.335.1; Windows arm64 job 87122172553,windows-11-arm64image20260706.102.1, native arm64, runner2.335.1 -
Remote and transport: no SSH remote; target-native artifact build and bundled-runtime execution
-
Exact commands:
gh api 'repos/stablyai/orca/actions/runs/29343816558/jobs?per_page=100' \ --jq '.jobs[] | [.id,.name,.status,.conclusion,.head_sha,.html_url] | @tsv' gh api repos/stablyai/orca/actions/jobs/87122172498/logs | \ rg -n -C 10 'resourceSettlement|Bundled runtime smoke command failed|timeoutMs=|contentId|durationMs|rssBytes' gh api repos/stablyai/orca/actions/jobs/87122172553/logs | \ rg -n -C 10 'resourceSettlement|Bundled runtime smoke command failed|timeoutMs=|contentId|durationMs|rssBytes' -
Result: expected discriminating FAIL on both Windows jobs after 27/27 contract tests, exact signed inputs, offline native compilation, archive/tree inspection, and valid functional smoke output. Immediately after smoke each child reported three
PipeWrapresources plus oneMessagePort; after the two-second observation window onePipeWrapsettled but theMessagePortremained. Each child then remained alive until the unchanged 45-second parent timeout sentSIGTERM. -
X64 metrics: functional smoke completed in 5,368.1555 ms with 60,022,784-byte RSS. The ZIP was 37,212,066 bytes with content ID
sha256:4ee246445ad65eec49b70fceab92fbd954de2f7fd8608a0646cc9a79ce53e69a, archive SHA-256sha256:20c98e2db2aaa9245fb2c632d37c4963e70f65a0e5257aff4e196dc64fb984dd, and build duration 143,545.9941 ms. -
Arm64 metrics: functional smoke completed in 5,873.1038 ms with 54,059,008-byte RSS. The ZIP was 33,261,530 bytes with content ID
sha256:9418590ffa09d21145dd1ff4d8492d1ff8b0328df496e300edec1969365df3a3, archive SHA-256sha256:52477f9714e7ac38b9f40ce5642b7f1c9e838f98af48387c7a88ef53b1dcf385, and build duration 169,800.5025 ms. -
POSIX control: Linux x64/arm64 and macOS x64/arm64 jobs at the same exact head all completed successfully; the Windows-only observation did not add a POSIX delay or resource probe.
-
Oracle proved: the retained native resource class is one persistent
MessagePorton both Windows architectures after successful PTY/ConPTY/watcher behavior and public PTY cleanup. The remainingPipeWrapresources are the smoke child's parent stdio and are not sufficient to explain the Windows-only non-exit because the same child-process boundary exits on POSIX. -
Does not prove: which dependency object owns the
MessagePort, a safe correction, normal Windows child exit, uploaded artifact retention, clean-rebuild identity, native trust, SSH, or any tuple. Both Windows executable cells remain unchecked. -
Checklist items satisfied: native resource classification only.
-
Follow-up: inspect the copied node-pty ConPTY worker lifecycle, add an exact-source fail-closed transform contract scoped to Windows artifact staging, then require both native jobs to exit and upload unpublished evidence before advancing.
E-M3-WINDOWS-CONPTY-WORKER-LOCAL-RED-001 — Copied-source settlement contract red gate
- Date: 2026-07-14
- Commit SHA / PR: uncommitted red-test working tree based on
2aaea70465dc80ced2ba4662b5bc1475a9c2f8c5; draft PR #8741 - Runner: macOS 26.2 arm64; Node v26.0.0 and pnpm 10.24.0. Node 24 and native Windows remain the authoritative artifact environments.
- Remote and transport: none; synthetic copied-source fixtures only
- Exact command:
pnpm exec vitest run --config config/vitest.config.ts config/scripts/ssh-relay-node-pty-windows-settlement.test.mjs - Result: expected discriminating FAIL, 4/4 tests failed in 136 ms. The copied Windows source was unchanged, POSIX returned no explicit no-op result, and missing/duplicate source patterns did not fail closed.
- Oracle proved: the new contract failed for each missing behavior before the correction existed.
- Does not prove: the green transform, production wiring, native Windows execution, prompt worker settlement, or any tuple.
- Checklist items satisfied: red half of the copied ConPTY worker settlement correction only.
- Follow-up: implement the exact one-match transform against exclusive artifact staging and rerun focused, artifact, and repository gates.
E-M3-WINDOWS-CONPTY-WORKER-LOCAL-001 — Fail-closed artifact-only worker settlement
-
Date: 2026-07-14
-
Commit SHA / PR: implementation commit
c04b4f630; draft PR #8741 -
Runner: macOS 26.2 arm64; Node v26.0.0 and pnpm 10.24.0. Node 24 and native Windows remain the authoritative artifact environments.
-
Remote and transport: none; pinned installed node-pty source, synthetic source-drift fixtures, workflow contract, and repository static gates
-
Exact commands:
pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-pty-windows-settlement.test.mjs pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-pty-windows-settlement.test.mjs \ config/scripts/ssh-relay-runtime-pty-smoke.test.mjs \ config/scripts/ssh-relay-runtime-resource-diagnostics.test.mjs \ config/scripts/ssh-relay-runtime-windows-tree.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-release-verification.test.mjs \ config/scripts/ssh-relay-node-tar-inspection.test.mjs \ config/scripts/ssh-relay-node-pty-windows-settlement.test.mjs \ config/scripts/ssh-relay-node-zip-inspection.test.mjs \ config/scripts/ssh-relay-runtime-artifact.test.mjs \ config/scripts/ssh-relay-runtime-pty-smoke.test.mjs \ config/scripts/ssh-relay-runtime-resource-diagnostics.test.mjs \ config/scripts/ssh-relay-runtime-windows-tree.test.mjs \ config/scripts/ssh-relay-runtime-zip.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm run typecheck pnpm exec oxlint config/scripts/ssh-relay-node-pty-build.mjs \ config/scripts/ssh-relay-node-pty-windows-settlement.mjs \ config/scripts/ssh-relay-node-pty-windows-settlement.test.mjs \ .github/workflows/ssh-relay-runtime-artifacts.yml pnpm run check:max-lines-ratchet GOMAXPROCS=2 pnpm run lint pnpm exec oxfmt --check .github/workflows/ssh-relay-runtime-artifacts.yml \ config/scripts/ssh-relay-node-pty-build.mjs \ config/scripts/ssh-relay-node-pty-windows-settlement.mjs \ config/scripts/ssh-relay-node-pty-windows-settlement.test.mjs \ docs/reference/plans/2026-07-14-ssh-relay-github-release-implementation-checklist.md git diff --check -
Result: PASS. The purpose-named suite passed 5/5 tests in 124 ms; the settlement/PTY/resource/tree/ workflow slice passed 12/12 tests across five suites in 201 ms; all ten artifact suites passed 32/32 tests in 378 ms. Typecheck, focused oxlint, max-lines, full lint/reliability/localization, formatting, and whitespace gates passed with only existing out-of-package lint warnings.
-
Duration and resource metrics: the combined repository static command completed in approximately 12.4 seconds. Peak memory and open-file counts were not instrumented by these local static tests.
-
Oracle proved: the transform accepts the exact pinned installed node-pty source, starts the ConPTY
Workerdrain even when no later output arrives, preserves later-data timer resets, modifies only the copied Windows artifact source after exclusive staging, and does not inspect a POSIX copy. Missing, drifted, duplicate, or already-transformed source rejects before a write. Both native workflow families run the purpose-named contract. The repository-wideconfig/patches/node-pty@1.1.0.patchand legacy/default desktop node-pty behavior are unchanged. -
Does not prove: native Windows worker termination, normal smoke child exit, absence of a persistent
MessagePort, artifact upload, reproducibility, native trust, oldest baseline, SSH, or any tuple. -
Checklist items satisfied: purpose-named local copied-source settlement contract and verification command inventory only; Windows executable rows remain unchecked.
-
Follow-up: push the exact head and require both target-native Windows jobs to exit normally, show no persistent
MessagePortafter the observation window, and upload unpublished evidence.
E-M3-WINDOWS-CI-001 — Native Windows artifacts execute, settle, and upload
-
Date: 2026-07-14
-
Commit SHA / PR: exact workflow head
d9a556b9c8b3d3a639d4fc93a8ba25926089d20f, containing implementation commitc04b4f630; draft PR #8741 -
Run: GitHub Actions 29345126283, completed success with all six target-native jobs green
-
Windows runners and jobs: x64 job 87126693074,
windows-2022image20260706.237.1, Windows Server 2022 build 20348, native X64, Node v24.18.0; arm64 job 87126693105,windows-11-arm64image20260706.102.1, Windows build 26200, native ARM64, Node v24.18.0 -
Remote and transport: no SSH remote; target-native artifact build, bundled-runtime execution, and GitHub Actions unpublished artifact upload
-
Exact commands:
gh run watch 29345126283 --repo stablyai/orca --interval 10 --exit-status gh api 'repos/stablyai/orca/actions/runs/29345126283/jobs?per_page=100' \ --jq '.jobs[] | [.id,.name,.status,.conclusion,.started_at,.completed_at,.head_sha,.html_url] | @tsv' gh api repos/stablyai/orca/actions/jobs/87126693074/logs | \ rg -n -C 12 'resourceSettlement|contentId|archive|durationMs|rssBytes|Artifact .* has been successfully uploaded' gh api repos/stablyai/orca/actions/jobs/87126693105/logs | \ rg -n -C 12 'resourceSettlement|contentId|archive|durationMs|rssBytes|Artifact .* has been successfully uploaded' gh api 'repos/stablyai/orca/actions/runs/29345126283/artifacts?per_page=100' \ --jq '.artifacts[] | [.id,.name,.size_in_bytes,.expired,.created_at,.archive_download_url] | @tsv' gh api repos/stablyai/orca/actions/artifacts/8315822805/zip > <temporary-x64-actions.zip> gh api repos/stablyai/orca/actions/artifacts/8315904862/zip > <temporary-arm64-actions.zip> shasum -a 256 <temporary-x64-actions.zip> <temporary-arm64-actions.zip> unzip -l <temporary-x64-actions.zip> unzip -p <temporary-x64-actions.zip> '*identity.json' | jq unzip -l <temporary-arm64-actions.zip> unzip -p <temporary-arm64-actions.zip> '*identity.json' | jq -
Result: PASS. Both Windows jobs passed 32/32 artifact contract tests, exact signed Node input verification, offline target-native compilation, exact archive/tree inspection, bundled Node v24.18.0, production-DLL ConPTY input/101×37 resize/exit 23, watcher lifecycle, normal child exit, and unpublished upload. Immediately after smoke, each child reported three
PipeWrapresources, oneMessagePort, and the diagnostic's ownTimeout; after the two-second observation only the two parent stdioPipeWrapresources remained. NoMessagePortor timer survived, and neither 45-second parent timeout fired. -
X64 metrics and bytes: build 135,657.3557 ms; full verification 6,495.1387 ms; smoke 5,353.5073 ms with 54,075,392-byte RSS. The 42-file ZIP was 37,212,121 bytes, expanded to 97,248,569 bytes, had content ID
sha256:32efa708b1fbefb05a11b0de6703551e5680d64c8015bb956095db3b50292c92, and archive SHA-256sha256:2ec9db55b5c417ea7ed9ab6cf5a960be4b9c305e68c68f8123a11dab0e3119a4. Uploaded artifact 8315822805 was 37,075,355 bytes and downloaded with SHA-256d98d1c935514667ea5c48a160ef54b9674a93f995ca24df2c19759735c62eefb; total job duration was 4m06s. -
Arm64 metrics and bytes: build 190,135.9561 ms; full verification 7,908.8115 ms; smoke 5,874.805 ms with 51,843,072-byte RSS. The 42-file ZIP was 33,261,582 bytes, expanded to 86,189,895 bytes, had content ID
sha256:e1d5eab84a7b1eb38d55acb9f87d852569995e22c47c02d202f29eb293467944, and archive SHA-256sha256:577285df23333a3de89489dec52027afd76aeb9ef23f74ffb6d5706e06a75ae8. Uploaded artifact 8315904862 was 33,137,908 bytes and downloaded with SHA-25677b78cb33117c8c8b4f5d639dada063651f7d303a815a097bfa36d9e651a2419; total job duration was 7m09s. -
POSIX control: Linux x64/arm64 and macOS x64/arm64 passed the same exact-head contract, build, verification, smoke, and unpublished upload steps. All six run artifacts exist with seven-day retention; no release asset was published.
-
Oracle proved: the copied-source correction terminates the node-pty ConPTY worker on both native Windows architectures without masking the process with
process.exit(), while preserving full PTY/watcher behavior and the four POSIX controls. The exact uploaded evidence contains the runtime ZIP, identity, SPDX SBOM, and provenance files. -
Does not prove: same-runner clean-rebuild identity, oldest baselines, Authenticode/native trust, SSH/SFTP/system-SSH transfer, relay RPC behavior, cancellation, publication, or any enabled tuple.
-
Checklist items satisfied: Milestone 3 Windows
conpty.dll/OpenConsole.exeproduction-path item; Windows x64 and arm64 build/provenance, bundled Node, real PTY, and watcher cells; target-native pre-upload inspection/smoke command. -
Follow-up: add and execute the separately gated same-head/same-runner two-clean-build identity oracle before oldest-baseline or trust work.
E-M3-RUNTIME-LOCAL-001 — First target-native Linux arm64 runtime artifact
-
Date: 2026-07-14
-
Commit SHA / PR: implementation commit
f2b387b21bbe6a3863ff1a492a1a03b65e0a0477in stacked draft PR #8741; native PR CI pending -
Runner: macOS 26.2 arm64 host with Docker Engine 29.2.1; native Linux/arm64 container
node@sha256:032e78d7e54e352129831743737e3a83171d9cc5b5896f411649c597ce0b11ea(Debian bookworm, build Node v24.17.0), bundled Node v24.18.0 ABI 137, Python 3.11.2, GNU C++ 12.2.0, GNU strip 2.40, XZ Utils 5.4.1, GnuPG/gpgv 2.2.40 -
Remote: none; native container artifact build/execution only, not an SSH host or oldest-baseline VM
-
Transport/network: exact HTTPS downloads from
nodejs.org/dist/v24.18.0; Debian package mirrors for build/signature-verification tools; no SSH, SFTP, system SSH, release upload, or remote egress -
Exact command:
docker run --rm \ -v "$PWD:/workspace" \ -v /tmp/orca-runtime-linux-arm64-v3:/evidence \ -w /workspace \ node@sha256:032e78d7e54e352129831743737e3a83171d9cc5b5896f411649c597ce0b11ea \ bash -lc 'set -euo pipefail apt-get update -qq DEBIAN_FRONTEND=noninteractive apt-get install -y -qq build-essential ca-certificates curl gnupg gpgv python3 xz-utils >/dev/null mkdir -p /tmp/node-inputs base=https://nodejs.org/dist/v24.18.0 for asset in SHASUMS256.txt SHASUMS256.txt.sig node-v24.18.0-linux-arm64.tar.xz; do curl --fail --silent --show-error --location --proto "=https" --tlsv1.2 \ --connect-timeout 20 --max-time 300 --retry 2 --retry-delay 2 --retry-all-errors \ "$base/$asset" --output "/tmp/node-inputs/$asset" done output=/evidence/new-parent/artifact node config/scripts/build-ssh-relay-runtime.mjs --tuple linux-arm64-glibc --inputs-directory /tmp/node-inputs --output-directory "$output" --source-date-epoch 1784030321 --git-commit 0c299fe189310b6dbd539f0f0f506b240524ba6a identity="$output/orca-ssh-relay-runtime-linux-arm64-glibc.identity.json" archive=$(find "$output" -maxdepth 1 -name "*.tar.xz" -print -quit) node config/scripts/verify-ssh-relay-runtime.mjs --runtime-directory "$output/runtime" --identity "$identity" --archive "$archive"'A second clean
createSshRelayRuntimeArchiveinvocation used the same runtime tree,SOURCE_DATE_EPOCH, container digest, Node tar implementation, and XZ 5.4.1, followed bycmpandsha256sumagainst the first archive. -
Result: PASS. The target-native build authenticated the official Node metadata/archive, inspected 5,774 upstream tar entries before selective extraction, executed Node v24.18.0, source-built Orca-patched
node-pty@1.1.0against the exact Node 24 headers, stripped the resulting Linux addon, copied exactly one Linux arm64 glibc watcher native package, and preserved the existing relay/watcher content hash. Full archive and unpacked-tree verification agreed on content IDsha256:cf0acba7a8839d5ee422755562ce30ffa4433a663991054d0b5d9681ebc54832. The bundled runtime produced PTY input, 101×37 resize, and exit code 23 plus watcher create, update, rename-as-delete/create, and delete events. The same tree repacked byte-for-byte identically: both archives hashed tosha256:b1b9857a42d45a068f03f2484f98fcebe82b3d21ddd53eac7d0bdabf494a7f9e. -
Duration and resource metrics: exclusive artifact staging to finalized identity took 138.666 seconds based on output birth/finalization timestamps; deterministic repack compression took approximately 109 seconds; full archive/tree/native verification took 3,746.221 ms; bundled PTY/watcher smoke took 248.879 ms with 35,328,000-byte RSS. The archive is 28,192,132 bytes, expands to 122,865,156 bytes, and contains 34 files/49 total entries. Build peak memory, open-file count, and cancellation settlement were not instrumented and remain CI follow-ups. After adding bounded native-command/xz execution, compressed-size prechecks, exact mode verification, frozen installs, and automatic parent creation, a fresh build into the previously absent
/evidence/new-parent/artifactcompleted in 89,580.560 ms and retained the exact content/archive hashes above; verification took 3,515.039 ms and smoke took 192.609 ms with 34,885,632-byte RSS. -
Artifact/log/trace link: unpublished local artifact directory
/tmp/orca-runtime-linux-arm64-v3/new-parent/artifact; archive hash above; SBOM hashsha256:27f81b5650b088dc8e01563b0229c978f8ea05828e90a1a4fd0d11640d6cc54a; provenance hashsha256:dc1433c481b57de44929248ddb033f2a35bfdb40fc32d9f442b9d8f8ed7f816c; identity hashsha256:95b4ca6bcce846c65c6b15c35df548db0598d8156aee1c54c196b95f998824a6. -
Oracle proved: one native Linux arm64 glibc artifact-only build; exact official Node signature and archive input; bounded source-tar inspection; exclusive selective extraction; Node-ABI-matched patched
node-pty; one correct watcher package; runtime-only JavaScript/license closure; SPDX SBOM/provenance/identity assets; executable modes; deterministictar.xz; exact archive/tree hashes; and direct bundled Node/native PTY/watcher execution before any upload. -
Does not prove: GitHub runner reproducibility, Linux x64, macOS, Windows/zip, musl, oldest glibc or kernel, native code signing/trust, quarantine/Gatekeeper/WDAC/AV, SSH/SFTP/system-SSH transfer, relay RPC conformance, cancellation/file-handle/peak-memory budgets, release publication, cache, fallback, UI, or any enabled tuple. Docker Desktop architecture is native arm64 but this is not an approved oldest-baseline or cross-family remote cell. The verified official Node binary reports upstream debug metadata and was intentionally preserved byte-for-byte; only Orca-built
pty.nodewas stripped. Both plan artifacts now state that precedence explicitly. -
Checklist items satisfied: named assembly script; POSIX deterministic archive; pre-archive mode verification; local POSIX archive/smoke commands; Linux arm64 build/provenance, bundled Node, patched real PTY, and watcher cells only.
-
Follow-up: run
.github/workflows/ssh-relay-runtime-artifacts.ymlon the exact draft-PR head, record resolved runner image identities and artifacts, implement Windows zip/native assembly separately, and leave every tuple disabled until oldest-baseline, trust, and both live SSH layers are complete.
E-M3-STATIC-001 — Work Package 2 focused and repository static gates
-
Date: 2026-07-14
-
Commit SHA / PR: implementation commit
f2b387b21bbe6a3863ff1a492a1a03b65e0a0477in stacked draft PR #8741; native PR CI pending -
Runner: macOS 26.2 arm64; Node v26.0.0 and pnpm 10.24.0
-
Remote and transport: not applicable; local source/static verification only
-
Exact commands:
pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-release-verification.test.mjs \ config/scripts/ssh-relay-node-tar-inspection.test.mjs \ config/scripts/ssh-relay-runtime-artifact.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm run typecheck pnpm run lint pnpm exec oxfmt --check .github/workflows/ssh-relay-runtime-artifacts.yml \ config/scripts/*ssh-relay* config/ssh-relay-node-release-v24.18.0.json pnpm run check:max-lines-ratchet git diff --check -
Result: PASS. Four focused suites passed 15/15 tests in 993 ms; typecheck passed; repository lint passed with only pre-existing warnings outside Work Package 2; formatting passed for 20 matched files; max-lines reported 355 grandfathered suppressions and no new bypass; diff check passed.
-
Duration and resource metrics: full lint completed in 20.438 seconds. Peak memory, open files, and cancellation settlement were not instrumented by these static commands.
-
Artifact/log/trace link: purpose-named tests and local command output; durable GitHub job links are pending the draft PR.
-
Oracle proved: hostile release-input/archive cases, canonical identity parity, deterministic archive/exact-tree and permission rejection, workflow runner/action/no-publication/frozen-install contracts, compilation, repository lint policy, formatting, line budget, and whitespace safety.
-
Does not prove: Node 24 source-tool execution, target-native runners beyond E-M3-RUNTIME-LOCAL-001, macOS/x64, signing/trust, oldest baselines, SSH transfer, relay RPCs, publication, cancellation settlement, or any enabled tuple. The exact workflow head and Node 24 gates require PR CI.
-
Checklist items satisfied: current Work Package 2 local handoff/static gate only.
-
Follow-up: create the isolated stacked draft PR, run the four target-native POSIX jobs, and replace uncommitted/local evidence with exact commit, run, job, image, artifact, and duration identifiers.
E-M3-CI-RED-001 — Native macOS watcher path-oracle failure
-
Date: 2026-07-14
-
Commit SHA / PR: exact draft-PR head
f8a230ef301fc6f2bb76082f549e3b3ae725c142in #8741 -
Runner and jobs: GitHub Actions run 29335018198; macOS arm64 job 87092056703 used
macos-15-arm64image20260706.0213.1, macOS 15.7.7, runner arm64, and Node v24.18.0; macOS x64 job 87092056769 usedmacos-15image20260629.0276.1, runner x64, and Node v24.18.0 -
Remote and transport: no SSH remote; target-native artifact build and local execution on each hosted runner; Node inputs downloaded from the exact pinned nodejs.org URLs
-
Exact workflow/log commands:
gh run watch 29335018198 --repo stablyai/orca --exit-status --interval 10 gh api -H 'Accept: application/vnd.github+json' \ repos/stablyai/orca/actions/jobs/87092056703/logs gh api -H 'Accept: application/vnd.github+json' \ repos/stablyai/orca/actions/jobs/87092056769/logs -
Result: expected discriminating FAIL. Both macOS jobs passed exact-head checkout, Node 24 setup, frozen dependency install, 15/15 contract tests, authenticated Node input download, target-native Node/
node-pty/watcher assembly, deterministic archive inspection, and full tree hashing. Native smoke then timed out after 15 seconds waiting for watchercreate; evidence upload correctly did not run. Both Linux jobs completed build, verification, smoke, and unpublished upload, but their cells remain provisional until the corrected exact-head matrix reruns. -
Duration and resource metrics: macOS arm64 job failed in 1m51s after a 54,699.324 ms artifact build; macOS x64 failed in 3m44s after a 105,665.482 ms artifact build. Each watcher wait settled at its declared 15-second bound. Peak memory and open-file counts were not recorded in the failed macOS smoke because no success payload was emitted.
-
Artifact/log/trace link: run and job links above. The arm64 pre-smoke artifact had content ID
sha256:cc205af32168718f9662e8513338ad844ba4c1210c247623d84f92778afa1610and archive hashsha256:cd9cca6f56c9645a73b6b022515668ef7392c2eeb8f01d63b8a46b046cf337a3; the x64 pre-smoke artifact had content IDsha256:82a7017f6c1f703258a9d6b9f3d5ad4d5c57320f1b667fd87902cb1f4cd21cd3and archive hashsha256:88670165fcdf55236fb2a81d70566b913b39824362b5cf5f0136e646bf9c9b2c. -
Oracle proved: the native matrix and exact-head provenance gates discriminate after successful builds; macOS FSEvents can report canonical
/private/var/...paths whiletmpdir()supplied the/var/...symlink spelling, so the equality oracle could reject the same filesystem object. -
Does not prove: a passing macOS watcher, upload, native trust/signing, oldest baseline, SSH, relay RPCs, Windows, or any enabled tuple. Successful Linux results from this failed aggregate do not satisfy the final corrected-head evidence requirement.
-
Checklist items satisfied: red half of the macOS target-native watcher-smoke gate only; no tuple checkbox was changed.
-
Follow-up: canonicalize the watched temporary directory before constructing expected event paths, retain bounded observed-event diagnostics, rerun all four jobs, and require every upload to pass.
E-M3-CI-001 — Corrected four-tuple POSIX native artifact run
-
Date: 2026-07-14
-
Commit SHA / PR: exact draft-PR head
151628992f8d05d11902604650b3ed884992da5cin #8741 -
Workflow: GitHub Actions run 29335399279, conclusion
success; no release asset was published -
Exact evidence commands:
gh run view 29335399279 --repo stablyai/orca --json databaseId,headSha,status,conclusion,url,jobs gh run view 29335399279 --repo stablyai/orca --job <job-id> --log gh api --paginate repos/stablyai/orca/actions/runs/29335399279/artifacts gh api repos/stablyai/orca/actions/artifacts/<artifact-id>/zip unzip -p <downloaded-artifact.zip> '*.identity.json' | jq -
Native runner, artifact, identity, and resource results:
Tuple Job / requested runner / resolved image Artifact ID / Actions ZIP bytes Runtime archive bytes / expanded bytes / files Content ID / archive SHA-256 Build / full verify / smoke / RSS darwin-arm6487093265074; macos-15;macos1520260706.0213.1; native ARM648311761833; 24,755,74824,742,840 / 122,027,869 / 35 16a9814a2af4adfbcce55ead3ab53f3982d8043d4b18d85762586212a481bdca/a7e31f92c1a0793b656f79ceff5fe63b7a1cf56a70394336a92c2ab207d30ea752,648.921 ms / 2,090.791 ms / 556.324 ms / 51,068,928 bytes darwin-x6487093265143; macos-15-intel;macos1520260629.0276.1; native X648311834044; 26,420,36026,405,780 / 124,316,655 / 35 ad3a4cdaf25cd8f2657e348fca5c68df69923f9f50295afa2227a8c195e2014b/9b6c492b4fda250c6b6688e343499e79afc7ca53be355b1e687e61ed8430a759108,328.464 ms / 1,956.297 ms / 325.008 ms / 40,546,304 bytes linux-x64-glibc87093265139; ubuntu-24.04;ubuntu2420260705.232.1; native X648311766570; 29,276,67329,260,688 / 124,846,502 / 34 960546cd96c67fcf9bb0a61e96ecdbecbffd9104d3a495578f8bb19dd810649a/b28fc4837d17399246926ab4d565e30f21b6adc6c22401910627e820aca7c52b61,805.875 ms / 2,288.790 ms / 159.950 ms / 56,315,904 bytes linux-arm64-glibc87093265142; ubuntu-24.04-arm;ubuntu2420260706.52.2; native ARM648311785832; 28,215,44728,200,600 / 122,865,172 / 34 aa3aa8ae8b42334ba7b0dbe5c43fd1184e36b3f4f4a9bec0e990e9b78f090756/d73d03c0507408e538b93549d449359e78c986c45f1bd5811c15197720fc5da869,030.100 ms / 1,618.140 ms / 159.037 ms / 52,219,904 bytes -
Result: PASS. All four jobs checked out the exact source head, used Node v24.18.0, authenticated the pinned Node release metadata and tuple archive, used a frozen source install, passed 15/15 focused contracts, assembled on the target-native architecture, verified the complete archive and unpacked tree before native execution, loaded the Orca-patched PTY addon, exercised a real PTY input/101×37 resize/exit-23 lifecycle, observed bounded create/update/rename/delete watcher events, and uploaded only an unpublished seven-day Actions artifact.
-
Oracle proved: target-native build/provenance, bundled Node execution, patched native PTY load and lifecycle, watcher lifecycle, exact archive/tree equality, size bounds, and artifact-only workflow behavior for the four named POSIX tuples on the exact runner images above.
-
Does not prove: deterministic native rebuilding. The local versus CI Linux arm64 runtime differed in the Orca-built
pty.node, and the red versus corrected macOS runs produced different content identities despite no intended runtime-tree source change. The current jobs record image and toolchain versions but do not pin all apt/Homebrew/compiler inputs or compare two clean native builds on the same runner. This evidence also does not prove oldest OS/libc/kernel baselines, native signing/trust, Windows/ZIP, musl, SSH/SFTP/system-SSH transfer, relay RPC conformance, cancellation/file/channel peaks, release publication/read-back, cache, fallback, UI, or any enabled tuple. -
Checklist items satisfied: build/provenance, bundled Node, real patched PTY, and watcher cells for
linux-x64-glibc,linux-arm64-glibc,darwin-x64, anddarwin-arm64only. Oldest-baseline and native-trust cells remain unchecked. -
Follow-up: add a same-head/same-runner two-clean-build identity comparison, implement bounded deterministic Windows ZIP assembly and native Windows jobs, and leave all tuples disabled until the remaining trust, baseline, and two-layer live SSH gates pass.
E-M3-REPRODUCIBILITY-LOCAL-001 — Bounded two-clean-build identity oracle
-
Date: 2026-07-14
-
Commit SHA / PR: exact implementation commit
c70e96374cafb681c52b3d60e42322ba5a76791cin stacked draft PR #8741; native PR CI pending -
Runner: macOS 26.2 build 25C56 arm64, native; Node v26.0.0 and pnpm 10.24.0. Node v24.18.0 on each target-native GitHub runner remains the authoritative artifact environment.
-
Remote and transport: none; synthetic output trees and parsed GitHub Actions workflow only
-
Exact commands:
pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-runtime-reproducibility.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-release-verification.test.mjs \ config/scripts/ssh-relay-node-tar-inspection.test.mjs \ config/scripts/ssh-relay-node-pty-windows-settlement.test.mjs \ config/scripts/ssh-relay-node-zip-inspection.test.mjs \ config/scripts/ssh-relay-runtime-artifact.test.mjs \ config/scripts/ssh-relay-runtime-pty-smoke.test.mjs \ config/scripts/ssh-relay-runtime-reproducibility.test.mjs \ config/scripts/ssh-relay-runtime-resource-diagnostics.test.mjs \ config/scripts/ssh-relay-runtime-windows-tree.test.mjs \ config/scripts/ssh-relay-runtime-zip.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm run typecheck pnpm exec oxlint config/scripts/ssh-relay-runtime-reproducibility.mjs \ config/scripts/ssh-relay-runtime-reproducibility.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm run check:max-lines-ratchet GOMAXPROCS=2 pnpm run lint pnpm exec oxfmt --check .github/workflows/ssh-relay-runtime-artifacts.yml \ config/scripts/ssh-relay-runtime-reproducibility.mjs \ config/scripts/ssh-relay-runtime-reproducibility.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs \ docs/reference/plans/2026-07-14-ssh-relay-github-release-implementation-checklist.md git diff HEAD^ --check -
Result: PASS. The purpose-named comparator/workflow command passed 10/10 tests in 200 ms; the complete artifact set passed 40/40 tests across 11 suites in 1.09 seconds. Typecheck, focused oxlint, the 355-entry max-lines ratchet, full repository lint/reliability/localization, formatting, and exact-commit diff checks all exited zero. Full lint emitted only pre-existing warnings outside this package.
-
Duration and resource metrics: purpose suite 0.87 seconds wall; full artifact suite 3.02 seconds; typecheck 8.47 seconds; focused oxlint 1.94 seconds; max-lines 4.95 seconds; full lint 26.34 seconds; formatting 5.56 seconds; diff check 90 ms. Comparator file reads are incremental, bounded to 250 MiB per file and 500 MiB per output, with 6,000 entries, 512-byte paths, depth 40, a five-minute AbortSignal, and sequential tree walks. Peak RSS/open files were not instrumented for synthetic fixtures; native CI remains responsible for real artifact duration and size evidence.
-
Artifact/log/trace link: exact source and test files in commit
c70e96374; durable target-native run and job links pending -
Oracle proved: distinct real output roots are required; symlinks and special files reject before hashing; complete runtime/archive/identity/SPDX/provenance output is mandatory; archive bytes must match their identity; any path type, mode, size, or SHA-256 drift fails closed. Both POSIX and Windows jobs build and independently verify/smoke two exclusive outputs, compare only afterward, and copy/upload only the first verified equal output. The workflow retains read-only permissions, exact-head checkout, SHA-pinned actions, explicit runner labels, and no release publication path.
-
Does not prove: any real native build is reproducible, Node v24 execution, compiler/linker determinism, Linux/macOS/Windows output equality, oldest baselines, native trust/signing, SSH, publication, transfer, cache, fallback, UI, or an enabled tuple.
-
Checklist items satisfied: purpose-named local reproducibility/workflow command and exact-commit static handoff only; no per-tuple or native-trust checkbox changes.
-
Follow-up: push the exact head, run all six native jobs, and record the exact differing path/field for every red result before correcting producer nondeterminism without weakening this oracle.
E-M3-REPRODUCIBILITY-CI-RED-001 — First native clean-build comparison
-
Date: 2026-07-14
-
Commit SHA / PR: exact head
09b047f4eee224b45ca337b46b8402016290a1a9in stacked draft PR #8741 -
Run and jobs: run 29347236627; Linux x64
87134028593, Linux arm6487134028669, macOS arm6487134028547, macOS x6487134028651, Windows x6487134028652, Windows arm6487134028632 -
Runners:
ubuntu-24.04x64,ubuntu-24.04-armarm64,macos-15-intelx64,macos-15arm64,windows-2022x64, andwindows-11-armarm64; Node v24.18.0. The macOS arm64 failure ran on macOS 15.7.7 image20260706.0213.1; the x64 failure ran on macOS 15.7.7 image20260629.0276.1. Both used Xcode 16.4 build 16F6. -
Remote and transport: none; GitHub-hosted target-native artifact jobs only
-
Exact evidence commands:
gh run view 29347236627 --repo stablyai/orca \ --json databaseId,headSha,status,conclusion,url,jobs gh api -H 'Accept: application/vnd.github+json' \ repos/stablyai/orca/actions/jobs/<completed-job-id>/logs -
Result: Linux x64 and arm64 independently built, verified, smoked, compared equal, and uploaded unpublished evidence. macOS arm64 independently verified and smoked both outputs but failed the equality gate: content IDs were
sha256:f1bbc1de26d6e9aae3899754c4ac4aea694ad9f5197fcf1c773e29fc50401129andsha256:c26eba0226e73542a0cd7aec0ca5fa7e3809051453e40095e47fe9d154ba944f; archive digests/sizes weresha256:9cd56317ff03eb4e89a811e46736dc7558e447b9f0cd2d7e20fdeb5e5c40114a/ 24,714,656 bytes andsha256:cde8fa92470fdf73ec02e8e6ebbf23417e43d98b465fa9c6bdea4373be8c3e84/ 24,714,700 bytes. macOS x64 likewise failed with content IDssha256:b71d7d50bba78b6cf9e6dc24b006d48c709a784c7eb77f500e86ab5fe692690bandsha256:ceae81924c97c917855af864239b87a7d2eecc28de7d00c21c32c47c5385354f; archive digests/sizes weresha256:01f7d4c6d54241e211c5063b89e92a3511433b18a50cb643bbfbe0384546a50e/ 26,384,540 bytes andsha256:f98dfdead87f4884382fedc3e3bff0197a3b2aa6981c38107e198cb38e8bdf67/ 26,384,576 bytes. The committed comparator first reported identity SHA-256 drift on both macOS architectures. Windows x64 and arm64 stopped before downloading Node inputs or building artifacts because Vitest collected zero comparator tests withSyntaxError: Invalid or unexpected token; the other 10 suites passed with 31 tests passed and one skipped. -
Duration and resource metrics: Linux build/compare steps completed in 125 seconds (x64) and 131 seconds (arm64); macOS arm64 failed after 123 seconds in the build/compare step. Windows contract suites completed in 1.54 seconds on arm64 and before artifact assembly on both architectures. Peak RSS, file/channel counts, and cancellation settlement were not instrumented by this gate.
-
Artifact/log/trace link: run and job links above. The two Linux evidence artifacts are unpublished; failed cells uploaded no runtime artifact.
-
Oracle proved: the equality gate accepts both Linux glibc tuples and detects real macOS clean-build drift; Windows contract collection fails before unverified artifact work can start. No asset was published and no production or default path changed.
-
Does not prove: Windows parser correction, macOS producer determinism, oldest baselines, native trust/signing, SSH, SFTP/system-SSH, release publication, resolver/cache, transfer/install, fallback, UI, or any enabled tuple.
-
Checklist items satisfied: none newly complete; native reproducibility remains open.
-
Follow-up: remove the comparator shebang, add explicit native
node --checkgates, report runtime-tree drift before derived metadata, rerun all six jobs, and correct the macOS producer only after the exact differing runtime file is identified. Never ignore or normalize unequal bytes in the comparator.
E-M3-REPRODUCIBILITY-DIAGNOSTIC-LOCAL-001 — Windows parser and runtime-first drift diagnostics
-
Date: 2026-07-14
-
Commit SHA / PR: exact implementation commit
e58913d1a571f4c578a7fe1dc51ef5c93e9b3136in stacked draft PR #8741 -
Runner: macOS 26.2 build 25C56 arm64, native; Node v26.0.0 and pnpm 10.24.0. Node v24.18.0 target-native GitHub execution remains pending.
-
Remote and transport: none; local synthetic comparator fixtures and workflow source contract only
-
Exact commands:
node --check config/scripts/ssh-relay-runtime-reproducibility.mjs node --check config/scripts/ssh-relay-runtime-reproducibility.test.mjs pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-runtime-reproducibility.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-release-verification.test.mjs \ config/scripts/ssh-relay-node-tar-inspection.test.mjs \ config/scripts/ssh-relay-node-pty-windows-settlement.test.mjs \ config/scripts/ssh-relay-node-zip-inspection.test.mjs \ config/scripts/ssh-relay-runtime-artifact.test.mjs \ config/scripts/ssh-relay-runtime-pty-smoke.test.mjs \ config/scripts/ssh-relay-runtime-reproducibility.test.mjs \ config/scripts/ssh-relay-runtime-resource-diagnostics.test.mjs \ config/scripts/ssh-relay-runtime-windows-tree.test.mjs \ config/scripts/ssh-relay-runtime-zip.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm run typecheck pnpm exec oxlint config/scripts/ssh-relay-runtime-reproducibility.mjs \ config/scripts/ssh-relay-runtime-reproducibility.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm run check:max-lines-ratchet GOMAXPROCS=2 pnpm run lint pnpm exec oxfmt --check .github/workflows/ssh-relay-runtime-artifacts.yml \ config/scripts/ssh-relay-runtime-reproducibility.mjs \ config/scripts/ssh-relay-runtime-reproducibility.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs \ docs/reference/plans/2026-07-14-ssh-relay-github-release-implementation-checklist.md git diff --check -
Result: PASS. Both new files passed
node --check; the purpose suite passed 11/11 tests; the complete artifact set passed 41/41 tests across 11 suites. Typecheck, focused oxlint, the 355-entry max-lines ratchet, full repository lint/reliability/localization, formatting, and diff checks exited zero. Full lint emitted only pre-existing warnings outside this package. -
Duration and resource metrics: syntax checks 60 ms and 50 ms; purpose suite 850 ms wall; complete artifact suite 1.27 seconds wall; typecheck 2.00 seconds; focused oxlint 480 ms; max-lines 780 ms; full lint 11.96 seconds. Synthetic fixture peak RSS/open files were not instrumented.
-
Artifact/log/trace link: exact sources in commit
e58913d1a; target-native rerun pending -
Oracle proved: the comparator and its test import parse locally without the shebang; both POSIX and Windows workflow contract stages run explicit syntax checks before Vitest or artifact inputs; a simultaneous runtime/identity drift reports the runtime-tree path first. The comparator still compares every byte and does not normalize or ignore drift.
-
Does not prove: Windows x64/arm64 parsing, any native build, the differing macOS runtime path, macOS determinism, oldest baselines, native trust, SSH, publication, transfer, fallback, UI, or an enabled tuple.
-
Checklist items satisfied: no native or tuple box; this closes only the local diagnostic correction required after E-M3-REPRODUCIBILITY-CI-RED-001.
-
Follow-up: push the exact commit, rerun all six native jobs, require both Windows syntax checks to pass, and use the macOS runtime-first failure path to correct producer nondeterminism.
E-M3-REPRODUCIBILITY-DIAGNOSTIC-CI-RED-001 — Native drift paths isolated on all six runners
-
Date: 2026-07-14
-
Commit SHA / PR: exact head
c62b0d0a9580b132fec5f11c3234a983503a011c; stacked draft PR #8741 -
Run and jobs: run 29348424235, conclusion
failure; Linux x6487138091964, Linux arm6487138091995, macOS arm6487138091994, macOS x6487138092013, Windows x6487138091948, and Windows arm6487138091977 -
Runners:
ubuntu-24.04x64 image20260705.232.1,ubuntu-24.04-armarm64 image20260706.52.2,macos-15arm64 image20260706.0213.1,macos-15-intelx64 image20260629.0276.1,windows-2022x64 image20260706.237.1, andwindows-11-armarm64 image20260706.102.1; all native and using Node v24.18.0 -
Remote and transport: none; target-native artifact assembly/execution and unpublished Actions artifact upload only
-
Exact evidence commands:
gh run view 29348424235 --repo stablyai/orca \ --json databaseId,headSha,status,conclusion,url,createdAt,updatedAt,jobs gh api -H 'Accept: application/vnd.github+json' \ repos/stablyai/orca/actions/jobs/<job-id>/logs -
Result: FAIL as an evidence-producing native gate. Every POSIX runner passed 41/41 contracts; Windows passed 38 and skipped three POSIX-only tests. Linux x64 and arm64 built, verified, smoked, compared exactly, and uploaded unpublished artifacts
8317161547and8317164595. macOS arm64 first differed atruntime/node_modules/node-pty/build/Release/pty.node, with content IDssha256:206de506d0499ded3c16913e28f76c528f5bead5214e6675ee4a5ee6bb0a642candsha256:68e23c3608b3d3bc95d591e6f99a5126ab6a6b0066c84c8340f4bc4195e64ac8; macOS x64 differed at the same path withsha256:eda4590b97d003f9a94fb59595a84273f3660fb920d85ff699c9d7925c52a7a2andsha256:701b4310acbeb1f7340d50b554cfe65e2802c5346aca0036aae4ebb3f974becf. Windows x64 first differed atruntime/node_modules/node-pty/build/Release/conpty_console_list.node, with content IDssha256:df55ffd5a5614a61e5fd2ae8cd990f28b84b9a0d557df861989c92b9e66652ebandsha256:1bbf496013af3d0172a275ba48dcb1a054aeb1b17261b606ecdd4c2dd3ce95fb; Windows arm64 differed at the same path withsha256:4d93459ffefb8f8b8250c6b0267e34f04a9ac5b5f99b60671f484fb34054519aandsha256:844c6f07a92ed3602af74bba92c8c98047313b97080b668aeb0b3a51ef7d2db8. -
Duration and resource metrics: build/compare steps were 138 seconds for Linux x64, 132 seconds for Linux arm64, 100 seconds for macOS arm64, 301 seconds for macOS x64, 296 seconds for Windows x64, and 285 seconds for Windows arm64. Both builds in every failing cell completed bundled Node/native PTY/watcher smoke before comparison. Smoke RSS ranged from 40,615,936 to 53,633,024 bytes in failing cells. Peak build RSS, open files/channels, and cancellation settlement were not instrumented by this gate.
-
Artifact/log/trace link: run/job links above; Linux x64 upload 8317161547 and Linux arm64 upload 8317164595; failing cells correctly uploaded nothing
-
Oracle proved: the parser and runtime-first diagnostic corrections execute on all native runner families; Linux reproducibility remains green; macOS and Windows drift is inside native node-pty outputs rather than archive/identity derivation; rejected cells cannot upload or publish bytes.
-
Does not prove: either linker correction, macOS/Windows equality, cross-run identity, oldest baselines, native trust/signing, SSH, transfer, publication, resolver/cache, fallback, UI, or an enabled tuple.
-
Checklist items satisfied: no new completion checkbox; this closes only the diagnostic run and identifies the bounded producer corrections required next.
-
Follow-up: retain the complete-output comparator, correct native producers without post-build normalization, and require a new same-head six-runner pass before advancing.
E-M3-REPRODUCIBILITY-LINKER-LOCAL-001 — Canonical work path and native linker correction
-
Date: 2026-07-14
-
Commit SHA / PR: implementation
a09b02ec4e623cc8cac8ece089e4ff734014dd5b; canonical-path follow-up3e433b3438e8e1aa11d2728e3f2258996b3d37f2; stacked draft PR #8741, push/native CI pending -
Runner: macOS 26.2 build 25C56, native Apple M4 arm64; local test/static process Node v26.0.0 and pnpm 10.24.0; native harness used official bundled Node v24.18.0, node-gyp 12.3.0, Apple Clang/make, and Python 3.13.5
-
Remote and transport: none; exact Node archive downloaded over HTTPS, then local native builds; no SSH, publication, or production consumer
-
Exact commands:
pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-pty-build.test.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-runtime-build.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-release-verification.test.mjs \ config/scripts/ssh-relay-node-tar-inspection.test.mjs \ config/scripts/ssh-relay-node-pty-build.test.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-windows-settlement.test.mjs \ config/scripts/ssh-relay-node-zip-inspection.test.mjs \ config/scripts/ssh-relay-runtime-artifact.test.mjs \ config/scripts/ssh-relay-runtime-build.test.mjs \ config/scripts/ssh-relay-runtime-pty-smoke.test.mjs \ config/scripts/ssh-relay-runtime-reproducibility.test.mjs \ config/scripts/ssh-relay-runtime-resource-diagnostics.test.mjs \ config/scripts/ssh-relay-runtime-windows-tree.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs \ config/scripts/ssh-relay-runtime-zip.test.mjs pnpm run typecheck pnpm exec oxlint \ config/scripts/build-ssh-relay-runtime.mjs \ config/scripts/ssh-relay-runtime-build.test.mjs \ config/scripts/ssh-relay-node-pty-build.mjs \ config/scripts/ssh-relay-node-pty-build.test.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm run check:max-lines-ratchet GOMAXPROCS=2 pnpm run lint pnpm exec oxfmt --check \ .github/workflows/ssh-relay-runtime-artifacts.yml \ config/scripts/build-ssh-relay-runtime.mjs \ config/scripts/ssh-relay-runtime-build.test.mjs \ config/scripts/ssh-relay-node-pty-build.mjs \ config/scripts/ssh-relay-node-pty-build.test.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs git diff HEAD --checkThe native oracle downloaded
node-v24.18.0-darwin-arm64.tar.xz, twice extracted it under the fixed exclusive/tmp/orca-ssh-relay-runtime-build-work/node-inputspath, calledbuildPatchedSshRelayNodePtytwice with the same cleannode-ptypath, compared both outputs, required oneLC_UUIDfromotool -l, and then repeated the build in a separate process session against the prior hashes. -
Result: PASS locally. The focused command passed 8/8 tests; all 14 artifact suites passed 47/47. Typecheck, focused oxlint, the 355-entry max-lines ratchet, full repository lint/reliability/localization, formatting, syntax, and diff gates exited zero. Full lint emitted only pre-existing out-of-package warnings. Two clean native passes and the separate repeat session produced byte-identical outputs:
pty.nodewas 83,256 bytes with SHA-256e73f80560b8ecc0ae19421fc82fb612e4f50e66f17dfd491cdf95599bc7b685a, andspawn-helperwas 50,192 bytes with SHA-2563396961b0f8f9cdb0fcd2155eb54035276ee7ee2813d84faa1dfae5ba84dc95d. Each retained exactly oneLC_UUID, and everybuildPatchedSshRelayNodePtycall completed its bundled-Node native-load oracle. A separate-Wl,-no_uuiddiagnostic made bytes equal but caused bundled Node/dlopen to rejectpty.nodewithmissing LC_UUID load command; that approach was discarded and is not present in the implementation. -
Duration and resource metrics: focused tests 229 ms; exact-head full artifact suite 1.35 seconds; parallel static gate 11.5 seconds; two-pass canonical native harness 11.126 seconds; separate repeat native build 2.511 seconds excluding archive download/extraction. Native harness peak RSS, file counts, and cancellation settlement were not instrumented.
-
Artifact/log/trace link: exact source commits and local command output; no artifact was published
-
Oracle proved: output/work overlap rejects; both paths are exclusive; a caller-provided canonical work path is reused cleanly and safely; macOS configures then links with
-Wl,-reproduciblewithout deletingLC_UUID; copied Windowsbinding.gypreceives exactly one/Breproand source drift fails closed; Linux and legacy/repository-wide node-pty behavior are unchanged; both native workflow families use the same canonical runner-local path while retaining run-scoped outputs. -
Does not prove: native Windows
/Breprobehavior, macOS x64, GitHub-hosted equality, different runner-image/toolchain revisions, oldest baselines, native signatures/trust, SSH, transfer, publication, resolver/cache, fallback, UI, or any enabled tuple. -
Checklist items satisfied: exact-head local linker/work-path contracts and macOS arm64 native correction only; native reproducibility remains open until all six jobs pass together.
-
Follow-up: push
3e433b343, run all six target-native jobs, and require complete equality plus upload in each cell without weakening the comparator.
E-M3-REPRODUCIBILITY-LINKER-CI-RED-001 — POSIX equality and Windows builder parser boundary
-
Date: 2026-07-14
-
Commit SHA / PR: exact head
54df2cb998ae564c1a19cf32a8c93bf28770d07a; stacked draft PR #8741 -
Run and jobs: run 29350639822, conclusion
failure; Linux x6487145674443, Linux arm6487145674440, macOS arm6487145674422, macOS x6487145674490, Windows x6487145674413, and Windows arm6487145674455 -
Runners:
ubuntu-24.04x64 image20260705.232.1,ubuntu-24.04-armarm64 image20260706.52.2,macos-15arm64 image20260706.0213.1,macos-15-intelx64 image20260629.0276.1,windows-2022x64 image20260706.237.1, andwindows-11-armarm64 image20260706.102.1; all native, runner2.335.1, provisioner20260624.560, and Node v24.18.0. Windows x64 was Server 2022 build 20348; arm64 was Windows Enterprise build 26200. -
Remote and transport: none; target-native artifact assembly/execution and unpublished Actions artifact upload only
-
Exact evidence commands:
gh run view 29350639822 --repo stablyai/orca \ --json databaseId,headSha,headBranch,status,conclusion,url,createdAt,updatedAt,jobs gh api repos/stablyai/orca/actions/jobs/<job-id>/logs gh api 'repos/stablyai/orca/actions/runs/29350639822/artifacts?per_page=100' -
Result: FAIL as an evidence-producing six-runner gate. Linux x64/arm64 and macOS x64/arm64 each passed 47/47 contracts, authenticated exact Node inputs, performed two exclusive native builds, fully inspected and smoked both outputs, compared the runtime tree/archive/identity/SPDX/ provenance byte-for-byte, and uploaded only the first equal output. Windows x64/arm64 each passed 42 tests and skipped three POSIX-only tests across 13 suites, then failed while collecting
ssh-relay-runtime-build.test.mjswithSyntaxError: Invalid or unexpected token: that test importsbuild-ssh-relay-runtime.mjs, whose first line was an unused Unix shebang. Input download, native build, verification, comparison, and upload were all skipped on both Windows jobs. -
Equal-output and upload details:
Tuple Content ID / runtime archive SHA-256 Archive / expanded / files Build 1 / build 2 / max smoke RSS Actions artifact linux-x64-glibc960546cd96c67fcf9bb0a61e96ecdbecbffd9104d3a495578f8bb19dd810649a/1881a082b5c8ab1caf28801e42a8f62601b0275096ec67468498d1a370c4af3b29,266,692 / 124,846,502 / 34 67,504 / 65,510 ms / 56,438,784 bytes 8318063540, 29,282,697 bytes linux-arm64-glibcaa3aa8ae8b42334ba7b0dbe5c43fd1184e36b3f4f4a9bec0e990e9b78f090756/909a8f69acf9edb294e5d74b4323adc399821e049f0cba933206621f75c3effe28,197,220 / 122,865,172 / 34 67,457 / 65,054 ms / 52,596,736 bytes 8318072302, 28,212,074 bytes darwin-arm6440ff5d2036784b794e7b09f78596409f63f3145280c530bece5280d40897f6cb/132b0b6b3ecd4386ecf72119a950334f54ec34fe46e51c4f871d8c787824777524,736,104 / 122,027,869 / 35 55,320 / 52,391 ms / 51,658,752 bytes 8318052438, 24,749,047 bytes darwin-x64585ea6034cdd07487d8667059f975a877c795a45dc0d6eeee1617f2e3749faa2/b47ed8b464989b1638a2024ac5980a45a494ff33f9a3dbe648c8f7974efb1e3326,373,464 / 124,316,655 / 35 88,815 / 78,961 ms / 40,665,088 bytes 8318098409, 26,388,039 bytes -
Duration and resource metrics: total jobs were 3m12s Linux x64, 3m28s Linux arm64, 2m50s macOS arm64, 4m28s macOS x64, 1m19s Windows x64, and 3m42s Windows arm64. Windows contract collection took 1.97s and 2.76s. POSIX comparison scanned 54/55 entries and 146.8–154.1 MB in 285–895 ms. Build peak RSS, open files/channels, and cancellation settlement were not instrumented.
-
Artifact/log/trace link: run/job links and four unpublished seven-day artifacts above; Windows correctly produced no artifact
-
Oracle proved: the canonical clean-work directory plus
-Wl,-reproduciblemakes both native macOS architectures byte-identical while retaining successful bundled-Node/native PTY/watcher execution; both Linux controls remain equal; failed contract collection prevents Windows inputs, execution, and upload. The parser boundary is the imported builder shebang, not/Breprooutput. -
Does not prove: Windows builder parsing after correction, native
/Breproequality, a six-job pass, cross-run identity, oldest baselines, native trust/signing, SSH, transfer, publication, resolver/cache, fallback, UI, or an enabled tuple. -
Checklist items satisfied: native macOS linker reproducibility evidence only; native reproducibility remains open until all six same-head jobs pass together.
-
Follow-up: remove only the unused builder shebang, syntax-check the builder and its test on POSIX and Windows before Vitest, rerun local gates, then require a new six-runner exact-head pass.
E-M3-REPRODUCIBILITY-BUILDER-PARSER-LOCAL-001 — Imported builder parser correction
-
Date: 2026-07-14
-
Commit SHA / PR: exact implementation commit
f864d3fa6df7a938e509c7622604e2fd2bd85493; stacked draft PR #8741, push/native CI pending -
Runner: macOS 26.2 build 25C56, native Apple M4 arm64; Node v26.0.0 and pnpm 10.24.0. The repository requires Node 24, so the new target-native run remains authoritative for Windows.
-
Remote and transport: none; local syntax, contract, and repository static gates only
-
Exact commands:
node --check config/scripts/build-ssh-relay-runtime.mjs node --check config/scripts/ssh-relay-runtime-build.test.mjs pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-release-verification.test.mjs \ config/scripts/ssh-relay-node-tar-inspection.test.mjs \ config/scripts/ssh-relay-node-pty-build.test.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-windows-settlement.test.mjs \ config/scripts/ssh-relay-node-zip-inspection.test.mjs \ config/scripts/ssh-relay-runtime-artifact.test.mjs \ config/scripts/ssh-relay-runtime-build.test.mjs \ config/scripts/ssh-relay-runtime-pty-smoke.test.mjs \ config/scripts/ssh-relay-runtime-reproducibility.test.mjs \ config/scripts/ssh-relay-runtime-resource-diagnostics.test.mjs \ config/scripts/ssh-relay-runtime-windows-tree.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs \ config/scripts/ssh-relay-runtime-zip.test.mjs pnpm run typecheck pnpm exec oxlint config/scripts/build-ssh-relay-runtime.mjs \ config/scripts/ssh-relay-runtime-build.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs \ .github/workflows/ssh-relay-runtime-artifacts.yml pnpm run check:max-lines-ratchet GOMAXPROCS=2 pnpm run lint pnpm exec oxfmt --check .github/workflows/ssh-relay-runtime-artifacts.yml \ config/scripts/build-ssh-relay-runtime.mjs \ config/scripts/ssh-relay-runtime-build.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs git diff HEAD --check -
Result: PASS at the exact implementation commit. Both syntax checks exited zero; all 14 artifact suites passed 47/47 tests. Typecheck, focused oxlint, the 355-entry max-lines ratchet, full repository lint/reliability/localization, formatting, and exact-head diff checks exited zero. Full lint emitted only pre-existing warnings outside this package.
-
Duration and resource metrics: full artifact command 3.08s wall; typecheck 3.30s; focused oxlint 0.49s; max-lines 0.76s; full lint 12.79s. Synthetic test peak RSS, open files/channels, and cancellation settlement were not instrumented.
-
Artifact/log/trace link: exact commit and local command output; no runtime artifact was produced
-
Oracle proved: the builder and importing test parse after removing only the unused shebang; every real builder invocation remains explicitly through
node; both workflow families syntax-check the builder and test before Vitest or Node input download; workflow source contracts require both POSIX and Windows checks without changing permissions, artifact scope, or production behavior. -
Does not prove: native Windows parsing, Node 24 behavior,
/Breprooutput equality, any native build, oldest baselines, native trust, SSH, transfer, publication, resolver/cache, fallback, UI, or an enabled tuple. -
Checklist items satisfied: exact local builder parser/syntax-gate correction only; no native or tuple checkbox.
-
Follow-up: push the exact commit and require all six target-native jobs to pass together before closing native reproducibility.
E-M3-REPRODUCIBILITY-WINDOWS-ARM64-CI-RED-001 — Native arm64 residual binary drift
-
Date: 2026-07-14
-
Commit SHA / PR: exact head
de541efd11989d2e6dce0402307912afffae3510; stacked draft PR #8741 -
Run and jobs: run 29351557922, conclusion
failure; Linux arm6487148758201, Linux x6487148758213, Windows x6487148758259, macOS arm6487148758282, macOS x6487148758287, and failing Windows arm6487148758290 -
Runners:
ubuntu-24.04-armimage20260706.52.2,ubuntu-24.04image20260705.232.1,windows-2022image20260706.237.1,macos-15-arm64image20260706.0213.1,macos-15image20260629.0276.1, andwindows-11-arm64image20260706.102.1; all native, runner2.335.1, provisioner20260624.560, and Node v24.18.0 -
Remote and transport: none; target-native artifact assembly/execution and unpublished Actions artifact upload only
-
Exact evidence commands:
gh run view 29351557922 --repo stablyai/orca \ --json databaseId,headSha,headBranch,status,conclusion,url,createdAt,updatedAt,jobs gh api repos/stablyai/orca/actions/jobs/<job-id>/logs gh api 'repos/stablyai/orca/actions/runs/29351557922/artifacts?per_page=100' -
Result: FAIL as a six-runner reproducibility gate. All six jobs passed the builder/test syntax checks and artifact contracts, authenticated the exact Node inputs, and completed two native builds. Linux x64/arm64, macOS x64/arm64, and Windows x64 inspected and smoked both outputs, compared every runtime/archive/identity/SPDX/provenance entry exactly, and uploaded only after equality. Windows arm64 also inspected and smoked both complete 60-entry, 42-file, 86,189,895-byte outputs, including PTY input/resize/exit, watcher lifecycle, and resource settlement, but the comparator first found SHA-256 drift at
runtime/node_modules/node-pty/build/Release/conpty_console_list.node; no arm64 artifact uploaded. -
Equal-output artifacts: Linux x64
8318426445(29,283,624 bytes), Linux arm648318449064(28,212,246 bytes), macOS arm648318457230(24,710,997 bytes), Windows x648318478579(37,075,312 bytes), and macOS x648318524353(26,365,330 bytes), all unpublished seven-day Actions artifacts. Their runtime content IDs are respectively960546cd96c6,aa3aa8ae8b42,40ff5d203678,2a6bfa06b445, and585ea6034cdd(prefixes shown; full values remain in logs). -
Windows arm64 drift details: build one content ID
58afdfbe6b3e48ee1a46bcb09f20a9c7d4d6fe25bdf346e82038fa0a2211ea86, archive 33,261,552 bytes with SHA-2560277fa35bb1ec644a509e3068bf120294c99484ac3638fdd352ae386f83bdd2f; build two content ID6e64071c12f58b0f73a34339c6f1f1dac725d852224537c32d2c87f8e587bdb9, archive 33,261,545 bytes with SHA-256234aa56026009c91abdfa37abae484723a39f027f8afa00760afc784a3ecfd05. -
Duration and resource metrics: jobs were 3m43s Linux arm64, 2m57s Linux x64, 4m54s Windows x64, 4m7s macOS arm64, 6m34s macOS x64, and 10m37s Windows arm64. Windows arm64 native builds took 152,711 ms and 132,480 ms; smoke took 5,845 ms and 5,408 ms at 53,018,624 and 51,732,480 bytes RSS. Build peak RSS, open files/channels, and cancellation settlement were not instrumented.
-
Oracle proved: the parser correction works natively on both Windows architectures;
/Breproyields complete equality on Windows x64; all four POSIX controls remain equal; a native arm64 residual is isolated to the copied node-ptyconpty_console_list.node; mismatch prevents upload. -
Does not prove: the differing byte region or PE field, a Windows arm64 correction, all-six equality, cross-run identity, oldest baselines, native trust/signing, SSH, transfer, publication, resolver/cache, fallback, UI, or an enabled tuple.
-
Checklist items satisfied: native parser boundary and five same-head reproducibility cells only; native reproducibility remains open.
-
Follow-up: add a bounded PE-diff diagnostic for the two Windows arm64 binaries, record byte ranges and headers, then correct only the copied artifact build if evidence identifies a safe source. Do not weaken comparison, upload failed outputs, or change repository-wide/legacy node-pty.
E-M3-REPRODUCIBILITY-WINDOWS-ARM64-REPEAT-CI-RED-001 — Independent repeat of arm64-only drift
-
Date: 2026-07-14
-
Commit SHA / PR: documentation-only exact head
a7151f9750fd9bfcdcff8c01c1fd6caff2e6116a; implementation bytes remainde541efd11989d2e6dce0402307912afffae3510; stacked draft PR #8741 -
Run and jobs: run 29352510414, conclusion
failure; Linux x6487151980265, Linux arm6487151980298, macOS arm6487151980396, macOS x6487151980327, Windows x6487151980324, and failing Windows arm6487151980264 -
Runners: the same six native labels/toolchain family recorded in E-M3-REPRODUCIBILITY-WINDOWS-ARM64-CI-RED-001. The failing cell was Windows 11 Enterprise 10.0.26200 arm64, image
windows-11-arm6420260706.102.1, runner2.335.1, provisioner20260624.560, Node v24.18.0, MSVC 19.44.35228 / tools 14.44.35207, Windows SDK 10.0.26100.0, and Python 3.13.14. -
Remote and transport: none; independent target-native artifact assembly/execution and unpublished Actions artifact upload only
-
Exact evidence commands:
gh run view 29352510414 --repo stablyai/orca \ --json databaseId,headSha,status,conclusion,url,updatedAt,jobs gh api repos/stablyai/orca/actions/jobs/87151980264/logs gh api 'repos/stablyai/orca/actions/runs/29352510414/artifacts?per_page=100' -
Result: FAIL as expected at the unchanged native boundary. All 14 contract suites passed on Windows arm64 with 44 tests passed and three POSIX-only skips. Linux x64/arm64, macOS x64/arm64, and Windows x64 independently built twice, inspected, smoked, compared exactly, and uploaded unpublished artifacts
8318818618,8318833832,8318812505,8318846378, and8318866333. Windows arm64 again built, inspected, and smoked two complete 60-entry, 42-file, 86,189,895-byte outputs, then first differed atruntime/node_modules/node-pty/build/Release/conpty_console_list.node; upload was skipped. -
Windows arm64 rejected outputs: first content ID
e13f39ae96eba36c3ed41054da7429533e2eebbdd7d845a712d802d002906bc8, ZIP 33,261,548 bytes with SHA-256ca1be18b572e353ac2eb3a390d91e5d0acb93100735f387ce74300cb48ba39d1; second content ID4989a282c6529df6066aefbb5667ca96777907d54f1d9a48041f8ff98555b9c0, ZIP 33,261,548 bytes with SHA-256e91664074aa2f434ea0e2603596410c119b89b2a4a4d7eab453bfb7407ff91d0. -
Duration and resource metrics: jobs completed in 3m9s Linux x64, 3m39s Linux arm64, 2m56s macOS arm64, 4m9s macOS x64, 4m53s Windows x64, and 8m48s Windows arm64. Arm64 native builds took 145,700 ms and 124,010 ms; smoke took 6,042 ms and 5,564 ms at 53,075,968 and 52,977,664 bytes RSS. Build peak RSS, open files/channels, and cancellation settlement were not instrumented.
-
Artifact/log/trace link: run/job above and the five unpublished seven-day artifacts; no failed arm64 bytes were uploaded
-
Oracle proved: the Windows arm64 difference repeats across an independent run while the same-head Windows x64 and four POSIX controls remain reproducible; the strict gate consistently prevents a rejected output from upload. The drift is not a transient failure from run 29351557922.
-
Does not prove: differing PE byte ranges/headers, a producer correction, arm64 equality, cross-run equality, oldest baselines, native trust/signing, SSH, publication, transfer, fallback, UI, or any enabled tuple.
-
Checklist items satisfied: no new completion checkbox; this repeat evidence justifies the bounded PE diagnostic before any producer change.
-
Follow-up: run the bounded diagnostic on both native Windows runners, require x64 to remain equal, and use only the rejected arm64 headers/ranges to choose or reject a copied-artifact correction.
E-M3-WINDOWS-PE-DIAGNOSTIC-LOCAL-001 — Bounded rejected-binary diagnostics
-
Date: 2026-07-14
-
Commit SHA / PR: exact implementation commit
39ee3451b8cc38b5311a0cb1085ad48a1f302185; stacked draft PR #8741, push/native execution pending -
Runner: macOS 26.2 build 25C56, native Apple M4 arm64; Node v26.0.0 and pnpm 10.24.0. The repository requires Node 24, so target-native Windows jobs remain authoritative.
-
Remote and transport: none; synthetic PE32+ arm64 fixtures and workflow source contracts only
-
Exact commands:
node --check config/scripts/ssh-relay-runtime-windows-pe-diagnostic.mjs node --check config/scripts/ssh-relay-runtime-windows-pe-diagnostic.test.mjs pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-runtime-windows-pe-diagnostic.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-release-verification.test.mjs \ config/scripts/ssh-relay-node-tar-inspection.test.mjs \ config/scripts/ssh-relay-node-pty-build.test.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-windows-settlement.test.mjs \ config/scripts/ssh-relay-node-zip-inspection.test.mjs \ config/scripts/ssh-relay-runtime-artifact.test.mjs \ config/scripts/ssh-relay-runtime-build.test.mjs \ config/scripts/ssh-relay-runtime-pty-smoke.test.mjs \ config/scripts/ssh-relay-runtime-reproducibility.test.mjs \ config/scripts/ssh-relay-runtime-resource-diagnostics.test.mjs \ config/scripts/ssh-relay-runtime-windows-pe-diagnostic.test.mjs \ config/scripts/ssh-relay-runtime-windows-tree.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs \ config/scripts/ssh-relay-runtime-zip.test.mjs pnpm run typecheck pnpm exec oxlint config/scripts/ssh-relay-runtime-windows-pe-diagnostic.mjs \ config/scripts/ssh-relay-runtime-windows-pe-diagnostic.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm run check:max-lines-ratchet GOMAXPROCS=2 pnpm run lint pnpm exec oxfmt --check .github/workflows/ssh-relay-runtime-artifacts.yml \ config/scripts/ssh-relay-runtime-windows-pe-diagnostic.mjs \ config/scripts/ssh-relay-runtime-windows-pe-diagnostic.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs \ docs/reference/plans/2026-07-14-ssh-relay-github-release-implementation-checklist.md git diff --check -
Result: PASS at the exact implementation commit. Both syntax checks exited zero; the purpose command passed 5/5 tests across two suites; all 15 artifact suites passed 50/50 tests. Typecheck, focused oxlint, the 355-entry max-lines ratchet, full repository lint/reliability/localization, formatting, staged hooks, and diff checks exited zero. Full lint emitted only pre-existing warnings outside this package.
-
Duration and resource metrics: syntax checks 50 ms and 40 ms; purpose suite 142 ms Vitest / 0.76s wall; complete artifact suite 470 ms Vitest / 1.15s wall; typecheck 2.68s; focused oxlint 0.69s; max-lines 1.58s; full lint 11.92s; formatting check 1.82s. The implementation rejects inputs over 64 MiB, reads in 64 KiB chunks, caps the header at 1 MiB, the section/debug tables at 96/32 entries, byte/header differences at 128 each, and the whole diagnostic at 60 seconds. Synthetic peak RSS/open files were not instrumented.
-
Artifact/log/trace link: exact source commit; no binary artifact was created or uploaded
-
Oracle proved: valid PE32+ fixtures report whole-file sizes/SHA-256, coalesced file-offset ranges, COFF/optional/data-directory/section/debug headers, and hashed—not printed—CodeView paths; oversized, malformed, same-file, unknown-argument, and pre-aborted inputs fail boundedly. Workflow contracts require diagnostic syntax/tests on Windows, invoke it only after the strict comparator rejects the two retained
conpty_console_list.nodefiles, throw afterward, and leave evidence copying unreachable, so rejected binaries are not uploaded. No max-lines bypass was added. -
Does not prove: parsing the real x64/arm64 linker outputs, native Node 24 behavior, the actual differing ranges/headers, x64 equality after the workflow change, a producer correction, arm64 equality, oldest baselines, native trust, SSH, publication, transfer, fallback, UI, or an enabled tuple.
-
Checklist items satisfied: local bounded diagnostic and fail-closed workflow ordering only; no native, tuple, or production checkbox.
-
Follow-up: push the exact implementation, require native x64 equality and arm64 diagnostic output with no upload, then record the exact PE evidence before changing the producer.
E-M3-WINDOWS-PE-DIAGNOSTIC-CI-RED-001 — Real arm64 PE drift with x64 control
-
Date: 2026-07-14
-
Commit SHA / PR: exact documentation head
27c6a5718c544cd3f559d6adc24cc0beca2ed59e, containing diagnostic implementation39ee3451b8cc38b5311a0cb1085ad48a1f302185; stacked draft PR #8741 -
Run and jobs: run 29353432240, conclusion
failure; Windows arm6487155072734, macOS x6487155072752, Linux x6487155072794, macOS arm6487155072820, Linux arm6487155072837, and Windows x6487155072849 -
Runners: the six target-native labels recorded in prior reproducibility evidence. The diagnostic cell was Windows 11 Enterprise 10.0.26200 arm64, image
windows-11-arm6420260706.102.1, runner2.335.1, provisioner20260624.560, Node v24.18.0, MSVC 19.44.35228 / tools 14.44.35207, Windows SDK 10.0.26100.0, and Python 3.13.14. -
Remote and transport: none; target-native artifact assembly/execution, rejected-file diagnostics, and unpublished Actions artifact upload only
-
Exact evidence commands:
gh run view 29353432240 --repo stablyai/orca \ --json headSha,status,conclusion,url,createdAt,updatedAt,jobs gh api repos/stablyai/orca/actions/jobs/87155072734/logs gh api 'repos/stablyai/orca/actions/runs/29353432240/artifacts?per_page=100' -
Result: FAIL as the intended evidence-producing gate. Both Windows jobs passed 15 suites with 47 tests passed and three POSIX-only skips, including native Node 24 execution of the new diagnostic contracts. Linux x64/arm64, macOS x64/arm64, and Windows x64 built twice, inspected, smoked, compared exactly, and uploaded unpublished artifacts
8319201464,8319207054,8319191783,8319227039, and8319248077. Windows x64 therefore proves the diagnostic package does not disturb the successful comparator/upload path. Windows arm64 again built, inspected, and smoked both complete outputs, then failed atconpty_console_list.node; the diagnostic ran before the fatal throw and artifact upload was skipped. -
Rejected arm64 runtime outputs: first content ID
bb05f852159277dea617679f84304d2bc3b01d446ceffd07fb58c9469038bcf6, ZIP 33,261,545 bytes with SHA-256248a4962141e5b1b1c5b24433993923171c5c1d342b8db4de624b92a1019823c; second content ID9d937233f63b142f03e504af2ffeeeb05b2de2b979047a369a79dd1d793b1786, ZIP 33,261,544 bytes with SHA-25624f752754890704e991f5cc85663a6bb7a6934fc5d64f81ea2414ea12778c249. -
PE diagnostic result: both native modules are exactly 956,928 bytes with identical machine
0xaa64, 12-section layout, PE32+ image/section/file alignment, 840,192-byte code section, data directories, load config, imports, relocations, and linker version 14.44. Their SHA-256 values are7ef783c59d73cd6101fbed4ef634ef3d075448726c118b36cca4d17145e35afaand196dc3373e52350abdf33c30f80a00e0b9b71c96b53b47ba337b1abe428ac8fc. Exactly 2,946 bytes differ across 2,887 coalesced ranges. The first code difference is at file offset0x41c, followed by one-byte ranges at 16-byte intervals in the retained sample. Header differences are confined to COFF/debug timestampsdd34d0b3versus0211cbf1and CodeView IDs383b9420683f05ced18d65c8e95b4a72versus459643a06a5ac306094361fd1788cbe5; CodeView age and the SHA-256 of the unprinted 92-byte PDB path are identical. The detailed-range list correctly reports truncation after 128 of 2,887 ranges. -
Duration and resource metrics: jobs were 8m48s Windows arm64, 4m12s macOS x64, 3m15s Linux x64, 2m57s macOS arm64, 3m24s Linux arm64, and 5m0s Windows x64. Arm64 native builds took 148,290 ms and 120,068 ms; smoke took 5,871 ms and 5,421 ms at 51,417,088 and 52,633,600 bytes RSS. The PE diagnostic completed between log timestamps 17:30:23.088 and 17:30:23.272 UTC. Build peak RSS, open files/channels, and cancellation settlement were not instrumented.
-
Artifact/log/trace link: run/job above and five unpublished seven-day artifacts; no rejected arm64 bytes were uploaded
-
Oracle proved: native Windows parses and bounds the real PE files, x64 remains fully reproducible, arm64 output layout and PDB path are stable, and drift affects thousands of mostly single-byte code ranges plus
/Brepro-derived identity fields rather than only a timestamp. The comparator and no-upload boundary remain strict. -
Does not prove: the full per-section distribution because the first diagnostic version labels raw section data as unmapped and caps detailed ranges at 128; the responsible compiler/linker input, a safe producer correction, arm64 equality, cross-run equality, oldest baselines, native trust, SSH, publication, transfer, fallback, UI, or any enabled tuple.
-
Checklist items satisfied: native PE diagnostic and Windows x64 control only; no tuple or production checkbox.
-
Follow-up: add raw-section attribution plus bounded per-section totals/samples across the complete scan, rerun both Windows cells, and do not change the producer until that evidence is recorded.
E-M3-WINDOWS-PE-FULL-SCAN-LOCAL-001 — Bounded complete-region PE summary
-
Date: 2026-07-14
-
Commit SHA / PR: exact implementation commit
cd7f941365bf6e631cf0f9947f517ecef02afc8e; stacked draft PR #8741, native execution pending -
Runner: macOS 26.2 build 25C56, native Apple M4 arm64; Node v26.0.0 and pnpm 10.24.0. The repository requires Node 24, so the target-native jobs remain authoritative.
-
Remote and transport: none; synthetic PE32+ fixtures and workflow-source contracts only
-
Exact commands:
node --check config/scripts/ssh-relay-runtime-windows-pe-diagnostic.mjs node --check config/scripts/ssh-relay-runtime-windows-pe-diagnostic.test.mjs pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-runtime-windows-pe-diagnostic.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-release-verification.test.mjs \ config/scripts/ssh-relay-node-tar-inspection.test.mjs \ config/scripts/ssh-relay-node-pty-build.test.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-windows-settlement.test.mjs \ config/scripts/ssh-relay-node-zip-inspection.test.mjs \ config/scripts/ssh-relay-runtime-artifact.test.mjs \ config/scripts/ssh-relay-runtime-build.test.mjs \ config/scripts/ssh-relay-runtime-pty-smoke.test.mjs \ config/scripts/ssh-relay-runtime-reproducibility.test.mjs \ config/scripts/ssh-relay-runtime-resource-diagnostics.test.mjs \ config/scripts/ssh-relay-runtime-windows-pe-diagnostic.test.mjs \ config/scripts/ssh-relay-runtime-windows-tree.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs \ config/scripts/ssh-relay-runtime-zip.test.mjs pnpm run typecheck pnpm exec oxlint config/scripts/ssh-relay-runtime-windows-pe-diagnostic.mjs \ config/scripts/ssh-relay-runtime-windows-pe-diagnostic.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm run check:max-lines-ratchet GOMAXPROCS=2 pnpm run lint pnpm exec oxfmt --check .github/workflows/ssh-relay-runtime-artifacts.yml \ config/scripts/ssh-relay-runtime-windows-pe-diagnostic.mjs \ config/scripts/ssh-relay-runtime-windows-pe-diagnostic.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs \ docs/reference/plans/2026-07-14-ssh-relay-github-release-implementation-checklist.md git diff --check -
Result: PASS. Both syntax checks exited zero; the purpose command passed 6/6 tests across two suites; all 15 artifact suites passed 51/51 tests. Typecheck, focused oxlint, the 355-entry max-lines ratchet, full repository lint/reliability/localization, formatting, staged hooks, and diff checks exited zero. Full lint emitted only pre-existing warnings outside this package.
-
Duration and resource metrics: purpose suite 246 ms Vitest; complete artifact suite 963 ms Vitest / 2.24s wall; typecheck 2.52s; focused oxlint 0.68s; max-lines 1.54s; full lint 11.09s; formatting and diff check 1.06s. The full scan still reads in 64 KiB chunks; detailed ranges remain capped at 128, each byte excerpt at 32 bytes, each region at eight samples, and the entire diagnostic at 60 seconds. Synthetic peak RSS/open files were not instrumented.
-
Artifact/log/trace link: exact source commit; no binary artifact was created or uploaded
-
Oracle proved: every coalesced range contributes to bounded per-region differing-byte and range totals even after the detailed-range cap is exhausted; raw PE section data is attributed by the most specific overlapping region, preserving CodeView/debug labels; excerpts and region samples remain bounded. The comparator, fatal failure, and no-upload ordering are unchanged.
-
Does not prove: the real arm64 section distribution, Windows x64 control, arm64 reproducibility, a producer correction, oldest baselines, native trust, SSH, publication, transfer, fallback, UI, or any enabled tuple.
-
Checklist items satisfied: diagnostic observability only; no artifact, tuple, or production box.
-
Follow-up: push the exact implementation and ledger head, run all six target-native cells, require five reproducible uploads plus a rejected Windows arm64 full-scan summary, and record that evidence before changing any copied-artifact producer input.
E-M3-WINDOWS-PE-FULL-SCAN-CI-RED-001 — Complete native arm64 region classification
-
Date: 2026-07-14
-
Commit SHA / PR: exact head
a51093f009a03a1105e9f0b86be14797a8046414, containing exact diagnostic implementationcd7f941365bf6e631cf0f9947f517ecef02afc8e; stacked draft PR #8741 -
Run and jobs: run 29354676731, conclusion
failure; Windows arm6487159223395, Linux arm6487159223407, macOS x6487159223419, macOS arm6487159223455, Windows x6487159223488, and Linux x6487159223544 -
Runners: the six target-native labels recorded in prior reproducibility evidence. The diagnostic cell was Windows 11 Enterprise 10.0.26200 arm64, image
windows-11-arm6420260706.102.1, runner2.335.1, provisioner20260624.560, Node v24.18.0, MSVC 19.44.35228 / tools 14.44.35207, Windows SDK 10.0.26100.0, and Python 3.13.14. -
Remote and transport: none; target-native artifact assembly/execution, rejected-file diagnostics, and unpublished Actions artifact upload only
-
Exact evidence commands:
gh run view 29354676731 --repo stablyai/orca \ --json headSha,status,conclusion,url,createdAt,updatedAt,jobs gh api repos/stablyai/orca/actions/jobs/87159223395/logs gh api 'repos/stablyai/orca/actions/runs/29354676731/artifacts?per_page=100' -
Result: FAIL as the intended evidence-producing gate. All Windows contract suites passed before execution; Linux x64/arm64, macOS x64/arm64, and Windows x64 built twice, inspected, smoked, compared exactly, and uploaded. Windows arm64 built, inspected, and smoked both outputs, then the strict comparator rejected
conpty_console_list.node; the full-scan diagnostic completed before the fatal throw and the upload step was skipped. -
Uploaded controls:
ssh-relay-runtime-linux-x64-glibcartifact8319697674(29,282,973 bytes), Linux arm648319710845(28,211,514), macOS x648319759300(26,374,729), macOS arm648319686475(24,756,958), and Windows x648319797990(37,075,313). All are unpublished and expire 2026-07-21; the run contains exactly five artifacts and no Windows arm64 artifact. -
Rejected arm64 outputs: content IDs
75f048e2216c5a88b5dec886d7ce43f8c54768c42184835cfd0d9a22ea3f1e53anddddc49d84bdafd5bef136be5050352555e99943b21f49781f1604bd9e37051bc; ZIP sizes 33,261,549 and 33,261,550 bytes with SHA-2564c21eaba04e514dee246ee23ea6b4559369fc37eaf90dc0634f11146427bb45aandaecde9c9982d972d194417cc2d076353fb808f39ba4f018b8d9e64cfdf5c3411. -
PE diagnostic result: both modules are 956,928-byte machine
0xaa64PE32+ files with identical 12-section layout, data directories, imports, relocations, 840,192-byte code section, and linker version 14.44. Their SHA-256 values are52d4909f106a4e8f85e7fc4c8cc0ccae93eaa74a83342b569d71f67619f15a1eand6926210ec6208caa2a79655e2af544b74d8a0d6d1b8c7637d4ece017c89046de. Exactly 2,947 bytes differ across 2,886 ranges:.text: 2,879 one-byte ranges from file offsets 1,052 through 47,100, exactly 16 bytes apart; all eight retained samples change85to0e.- COFF header: one four-byte
/Breprotimestamp range. - Debug directory: three four-byte ranges carrying that timestamp.
- CodeView data: one 16-byte identifier range.
.rdata: two ranges totaling 36 bytes, containing the derived CodeView/build identities and timestamp.
The CodeView path remains 92 bytes with identical SHA-256
401080e65f10d7483583537fc7394ddf416fa36febfd76e6d1c17c64bb36f3ea; no other section differs. The detailed list remains capped while every range contributes to the five bounded region summaries. -
Duration and resource metrics: jobs were 9m50s Windows arm64, 6m56s Windows x64, 5m33s macOS x64, 3m44s Linux arm64, 3m18s Linux x64, and 2m55s macOS arm64. Arm64 builds took 152,517 ms and 130,926 ms; smoke took 5,963 ms and 5,414 ms at 51,884,032 and 51,789,824 bytes RSS. The complete smoke stages took 7,978 ms and 7,203 ms. Build peak RSS, open files/channels, and cancellation settlement were not instrumented.
-
Artifact/log/trace link: run/jobs and five unpublished seven-day artifacts above; rejected arm64 bytes remained runner-local
-
Oracle proved: the arm64 failure is copied-source producer nondeterminism concentrated in a regular
.textpattern, with only derived/Breproidentities elsewhere. It is not ZIP order, tree metadata, comparator normalization, a changing PDB path, or a cross-platform regression. The strict no-upload boundary remains effective. -
Does not prove: which compiler input causes the repeating
.textbyte, a safe producer correction, arm64 equality, cross-run equality, oldest baselines, native trust, SSH, publication, transfer, fallback, UI, or any enabled tuple. -
Checklist items satisfied: complete native PE region classification and five control cells only; no tuple or production checkbox.
-
Follow-up: evaluate a test-covered reproducible compiler input only in the copied node-pty source, rerun all local gates and all six target-native cells, and require exact arm64 equality without normalizing binaries or weakening the comparator.
E-M3-WINDOWS-COMPILER-DETERMINISM-LOCAL-001 — Copied-source MSVC reproducibility inputs
-
Date: 2026-07-14
-
Commit SHA / PR: exact implementation commit
6546f54d53446015f10681fffff9fe895e460232; stacked draft PR #8741, native execution pending -
Runner: macOS 26.2 build 25C56, native Apple M4 arm64; Node v26.0.0 and pnpm 10.24.0. This runner cannot execute MSVC, so target-native Windows jobs remain authoritative.
-
Remote and transport: none; copied
binding.gypsource-shape contracts only -
Exact red command:
pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs -
Red result: FAIL as intended, one failed and one passed test. The copied compiler block lacked
/Brepro; no implementation change had yet been made. -
Exact green commands:
node --check config/scripts/ssh-relay-node-pty-windows-build-determinism.mjs node --check config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-build.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-release-verification.test.mjs \ config/scripts/ssh-relay-node-tar-inspection.test.mjs \ config/scripts/ssh-relay-node-pty-build.test.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-windows-settlement.test.mjs \ config/scripts/ssh-relay-node-zip-inspection.test.mjs \ config/scripts/ssh-relay-runtime-artifact.test.mjs \ config/scripts/ssh-relay-runtime-build.test.mjs \ config/scripts/ssh-relay-runtime-pty-smoke.test.mjs \ config/scripts/ssh-relay-runtime-reproducibility.test.mjs \ config/scripts/ssh-relay-runtime-resource-diagnostics.test.mjs \ config/scripts/ssh-relay-runtime-windows-pe-diagnostic.test.mjs \ config/scripts/ssh-relay-runtime-windows-tree.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs \ config/scripts/ssh-relay-runtime-zip.test.mjs pnpm run typecheck pnpm exec oxlint config/scripts/ssh-relay-node-pty-windows-build-determinism.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-build.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm run check:max-lines-ratchet GOMAXPROCS=2 pnpm run lint pnpm exec oxfmt --check .github/workflows/ssh-relay-runtime-artifacts.yml \ config/scripts/ssh-relay-node-pty-windows-build-determinism.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-build.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs \ docs/reference/plans/2026-07-14-ssh-relay-github-release-implementation-checklist.md git diff --check -
Green result: PASS. Both syntax checks exited zero; the purpose command passed 6/6 tests across three suites; all 15 artifact suites passed 51/51 tests. Typecheck, focused oxlint, the 355-entry max-lines ratchet, full repository lint/reliability/localization, formatting, staged hooks, and diff checks exited zero. Full lint emitted only pre-existing warnings outside this package.
-
Duration and resource metrics: purpose suite 183 ms Vitest; complete artifact suite 1.27s Vitest / 2.65s wall; typecheck 2.85s; focused oxlint 0.76s; max-lines 1.81s; full lint 10.91s; formatting and diff check 1.10s. Synthetic peak RSS/open files were not instrumented.
-
Artifact/log/trace link: exact source commit; no binary artifact was created or uploaded
-
Oracle proved: Windows builds receive
/Breproand/experimental:deterministicin both the compiler and linker option blocks after an exact reviewed-source match. POSIX tuples are untouched, unexpected or already-modified source fails closed, and the installed repositorynode_modules/node-pty/binding.gypremains byte-identical because only the exclusive copied source is rewritten. -
Does not prove: that MSVC 19.44 accepts the flags on both architectures, Windows arm64 equality, native execution, cross-run equality, oldest baselines, native trust, SSH, publication, transfer, fallback, UI, or any enabled tuple.
-
Checklist items satisfied: copied-source compiler/linker input contract only; no tuple or production checkbox.
-
Follow-up: push the exact implementation and ledger head, run all six target-native cells, and require exact equality and successful unpublished upload on both Windows architectures.
E-M3-WINDOWS-COMPILER-DETERMINISM-CI-RED-001 — Compiler-setting correction does not remove arm64 drift
-
Date: 2026-07-14
-
Commit SHA / PR: exact head
a6b423f33f0f0f7b4e7975ed80d901f168563e61, containing exact implementation commit6546f54d53446015f10681fffff9fe895e460232; stacked draft PR #8741 -
Run and jobs: run 29355973362, conclusion
failure; Linux arm6487163591039, Windows x6487163591059, macOS x6487163591076, Windows arm6487163591141, macOS arm6487163591145, and Linux x6487163591207 -
Runners: the six target-native labels recorded in prior reproducibility evidence. The failing cell was GitHub-hosted
windows-11-arm, resolved imagewin11-arm6420260706.102.1, nativeARM64, Node v24.18.0, MSVC 19.44.35228 / tools 14.44.35207, Windows SDK 10.0.26100.0, and Python 3.13.14. -
Remote and transport: none; target-native artifact assembly/execution, rejected-file diagnostics, and unpublished Actions artifact upload only
-
Exact evidence commands:
gh run view 29355973362 --repo stablyai/orca \ --json headSha,status,conclusion,url,createdAt,updatedAt,jobs gh run view 29355973362 --repo stablyai/orca --job 87163591141 --log-failed gh api repos/stablyai/orca/actions/runs/29355973362/artifacts --paginate -
Result: FAIL as the intended strict evidence gate. All 15 Windows contract suites passed with 48 passing and three intentionally skipped tests. Linux x64/arm64, macOS x64/arm64, and Windows x64 built twice, inspected, executed, compared exactly, and uploaded. Windows arm64 built and executed both complete outputs, then the comparator rejected
runtime/node_modules/node-pty/build/Release/conpty_console_list.node; the diagnostic ran, the job failed, and no Windows arm64 artifact was uploaded. -
Uploaded controls: Linux x64 artifact
8320207112(29,282,626 bytes), Linux arm648320217472(28,211,075), macOS x648320277866(26,390,709), macOS arm648320191810(24,741,051), and Windows x648320261436(37,075,310). All are unpublished seven-day artifacts; the run contains exactly five artifacts. -
Rejected arm64 outputs: content IDs
5523ec111f63a53edb3da090cf90bedb0421c2c9862dc0356e106fdf5a6519f2andfaadd0f5285a449fd0aad0960918edc72d565dc150171e8e292c160931340235; ZIP sizes 33,261,550 and 33,261,546 bytes with SHA-256769fc2b8a4761b8d19b9d4b02adc2add6b4232ed73a1ee154e6e073760f52edaand217e9f8b500837130e0978a7aa03dba2790a926b42410752c7d804e6d5a38143. -
PE diagnostic result: both rejected modules remain 956,928-byte machine
0xaa64PE32+ files with the identical 12-section layout. Their SHA-256 values are548ff529facca76eb3a30c79f96e2170336b7cf01a3e55aabc2a5cd615cd1111ande0039271e09a898d3edf9eb4506f3d895cd3282a893a1e15acb4abec2f9cb69c. Exactly the same 2,947 bytes differ across 2,886 ranges: 2,879 one-byte.textranges every 16 bytes from offsets 1,052 through 47,100, plus 68 bytes of derived COFF/debug/CodeView identity. The retained.textsamples all change45to2d; the 92-byte PDB path hash remains identical. -
Duration and resource metrics: jobs were 8m25s Windows arm64, 5m50s macOS x64, 5m15s Windows x64, 3m37s Linux arm64, 3m16s Linux x64, and 2m41s macOS arm64. Arm64 builds took 141,484 ms and 116,582 ms; smoke took 5,784 ms and 5,439 ms at 53,014,528 and 53,047,296 bytes RSS. The complete smoke stages took 7,448 ms and 7,383 ms. Build peak RSS, open files/channels, and cancellation settlement were not instrumented.
-
Artifact/log/trace link: run/jobs and the five unpublished artifacts above; rejected arm64 bytes remained runner-local
-
Oracle proved: adding the reviewed compiler/linker settings did not alter the arm64 failure signature, while all five controls and both arm64 runtime executions remain healthy. The strict comparator and no-upload boundary still work. This falsifies the hypothesis that the copied settings alone are sufficient.
-
Does not prove: whether the generated MSBuild project actually propagates both settings to every
conpty_console_listcompile/link invocation, what the repeated ARM64 instruction represents, a safe producer correction, arm64 or cross-run equality, oldest baselines, native trust, SSH, publication, transfer, fallback, UI, or any enabled tuple. -
Checklist items satisfied: native negative evidence and five reproducible control cells only; no tuple or production checkbox.
-
Follow-up: inspect the generated
conpty_console_list.vcxprojfail-closed for the expected compiler/linker inputs and emit bounded paired ARM64 instruction/disassembly context around the first differing ranges. Do not change the producer, normalize binaries, weaken comparison, or upload rejected bytes before that evidence.
E-M3-WINDOWS-MSBUILD-DISASSEMBLY-LOCAL-001 — Generated-project and bounded disassembly contracts
-
Date: 2026-07-14
-
Commit SHA / PR: exact implementation commit
0d3a0c9d3f0eee78d3106a646369cc3fc5db96b1; stacked draft PR #8741, native execution pending -
Runner: macOS 26.2 build 25C56, native Apple M4 arm64; Node v26.0.0 and pnpm 10.24.0. This runner cannot generate or execute native MSBuild/ARM64 PE inputs, so the target-native Windows jobs remain authoritative.
-
Remote and transport: none; synthetic generated-project fixtures and workflow-source contracts only
-
Exact red command:
pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs -
Red result: FAIL as intended, two failed and two passed tests because no generated-project verifier existed.
-
Exact green commands:
node --check config/scripts/ssh-relay-node-pty-windows-build-determinism.mjs node --check config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs node --check config/scripts/ssh-relay-node-pty-build.mjs node --check config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-build.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-release-verification.test.mjs \ config/scripts/ssh-relay-node-tar-inspection.test.mjs \ config/scripts/ssh-relay-node-pty-build.test.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-windows-settlement.test.mjs \ config/scripts/ssh-relay-node-zip-inspection.test.mjs \ config/scripts/ssh-relay-runtime-artifact.test.mjs \ config/scripts/ssh-relay-runtime-build.test.mjs \ config/scripts/ssh-relay-runtime-pty-smoke.test.mjs \ config/scripts/ssh-relay-runtime-reproducibility.test.mjs \ config/scripts/ssh-relay-runtime-resource-diagnostics.test.mjs \ config/scripts/ssh-relay-runtime-windows-pe-diagnostic.test.mjs \ config/scripts/ssh-relay-runtime-windows-tree.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs \ config/scripts/ssh-relay-runtime-zip.test.mjs pnpm run typecheck pnpm exec oxlint config/scripts/ssh-relay-node-pty-windows-build-determinism.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-build.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm run check:max-lines-ratchet GOMAXPROCS=2 pnpm run lint pnpm exec oxfmt --check .github/workflows/ssh-relay-runtime-artifacts.yml \ config/scripts/ssh-relay-node-pty-windows-build-determinism.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-build.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs \ docs/reference/plans/2026-07-14-ssh-relay-github-release-implementation-checklist.md pnpm exec lint-staged git diff --check -
Green result: PASS. All syntax checks exited zero; the purpose command passed 8/8 tests across three suites; all 15 artifact suites passed 53/53 tests. Typecheck, focused oxlint, the 355-entry max-lines ratchet, full repository lint/reliability/localization, formatting, staged hooks, and diff checks exited zero. Full lint emitted only pre-existing warnings outside this package.
-
Duration and resource metrics: purpose suite 156 ms Vitest; complete artifact suite 1.11s Vitest. Static-gate wall time, synthetic peak RSS, open files/channels, and cancellation settlement were not instrumented.
-
Artifact/log/trace link: exact source commit and local command output; no binary artifact was created or uploaded
-
Oracle proved: Windows artifact builds now reject a missing, duplicate, non-inherited, or wrong-architecture Release
ClCompile/Linkoption in the generatedconpty_console_list.vcxprojbefore runtime staging, and log the exact accepted setting summary. On an arm64 mismatch the workflow retains the existing structured PE diagnostic, then requests only absolute image addresses0x180001000through0x180001200from nativellvm-objdump.exebefore the fatal throw. Rejected bytes still cannot reach artifact staging. -
Does not prove: the real generated XML shape, native
llvm-objdumpavailability/output, which repeated ARM64 instruction differs, a safe producer correction, arm64 equality, oldest baselines, native trust, SSH, publication, transfer, fallback, UI, or any enabled tuple. -
Checklist items satisfied: local generated-project and bounded-disassembly contracts only; no tuple or production checkbox.
-
Follow-up: push the exact implementation and ledger head, run all six target-native cells, and require both Windows jobs to prove generated settings. If arm64 still differs, record the two bounded disassemblies and retain strict failure/no-upload before any producer correction.
E-M3-WINDOWS-MSBUILD-PLATFORM-CASE-CI-RED-001 — Native arm64 Release-group lookup fails closed
-
Date: 2026-07-14
-
Commit SHA / PR: exact head
65d44d72f7a5da382ffddc194f302b4386b2391c, containing exact diagnostic implementation commit0d3a0c9d3f0eee78d3106a646369cc3fc5db96b1; stacked draft PR #8741 -
Run and jobs: run 29357355064, conclusion
failure; Linux x6487168238852, Windows x6487168238867, macOS x6487168238889, Windows arm6487168238935, macOS arm6487168238945, and Linux arm6487168238954 -
Runners: the six target-native labels recorded in prior reproducibility evidence. The failing cell was GitHub-hosted
windows-11-arm, imagewin11-arm64release20260706.102, nativeARM64, runner 2.335.1, Node v24.18.0, MSVC tools 14.44.35207, Windows SDK 10.0.26100.0, and an arm64 developer environment exposingPlatform=arm64. -
Remote and transport: none; target-native artifact assembly, generated-project verification, and unpublished Actions artifact upload only
-
Exact evidence commands:
gh run view 29357355064 --repo stablyai/orca \ --json headSha,status,conclusion,url,createdAt,updatedAt,jobs gh run view 29357355064 --repo stablyai/orca --job 87168238867 --log gh run view 29357355064 --repo stablyai/orca --job 87168238935 --log-failed gh api repos/stablyai/orca/actions/runs/29357355064/artifacts --paginate -
Result: FAIL as the intended strict evidence gate. Linux x64/arm64, macOS x64/arm64, and Windows x64 built twice, inspected, executed, compared exactly, and uploaded. Windows x64 logged the required
/Breproand/experimental:deterministiccompiler and linker settings for both clean builds. Native Windows arm64 completed compilation of the first copied node-pty tree, then the generated-project verifier rejected it withgenerated MSBuild settings lack one exact Release configurationbefore runtime staging, verification, smoke, comparison, or diagnostics. Its artifact upload was skipped. -
Uploaded controls: Linux x64 artifact
8320756625(29,278,781 bytes,sha256:50bab609edc8e4eb776f462622c5e1310e926049e5ec0e759692ea4ae74142a4), Linux arm648320758083(28,215,186,sha256:0b2770363a95717b0193c58ee066242ab08a9fa80eb0060049e912f6314776a8), macOS x648320845963(26,407,443,sha256:70b4217dc54ff2015638e7407714208f7e399acadf0cbcd0d8d5340025235d34), macOS arm648320753136(24,774,283,sha256:8f5c1a65e88d79b036cabf24d80656e6b987335c5d0a908d4fff241026d74467), and Windows x648320806874(37,075,312,sha256:a325d8e09c0391ee971328da397ac23412024ce2e4bf0dc633f897f8b923add2). The run contains exactly five unpublished seven-day artifacts and no Windows arm64 artifact. -
Duration and resource metrics: jobs were 6m43s macOS x64, 6m24s Windows arm64, 5m15s Windows x64, 3m24s Linux x64, 3m23s Linux arm64, and 3m16s macOS arm64. The arm64 verifier failure occurred 2m24s into the build/inspect step before runtime smoke, so no new arm64 smoke RSS, channel/file count, cancellation, or fallback metric exists for this run.
-
Artifact/log/trace link: run/jobs and the five unpublished artifacts above; no rejected arm64 runtime or binary was staged or uploaded
-
Oracle proved: the generated-setting verifier executes after native compilation and fails closed before staging when its Release-group architecture spelling does not match. Windows x64 proves both required settings in both generated projects. The native arm64 developer environment uses a lowercase platform spelling, while all five architecture controls and the no-upload boundary remain intact.
-
Does not prove: the exact native arm64 generated XML condition, that a case-insensitive exact architecture match reaches its option blocks, a complete arm64 runtime, paired disassembly, a safe producer correction, arm64 equality, oldest baselines, native trust, SSH, publication, transfer, fallback, UI, or any enabled tuple.
-
Checklist items satisfied: native negative verifier evidence and five reproducible control cells only; no tuple or production checkbox.
-
Follow-up: cover lowercase
arm64with a purpose fixture and compare only the expected Release architecture case-insensitively, retaining exact group and option cardinality. Rerun both Windows cells and all four POSIX controls before interpreting the underlying PE drift.
E-M3-WINDOWS-MSBUILD-PLATFORM-CASE-LOCAL-001 — Lowercase native platform contract
-
Date: 2026-07-14
-
Commit SHA / PR: exact implementation commit
4207c207ab932ef67522b4f73b98d63fa32d0924; stacked draft PR #8741, native execution pending -
Runner: macOS 26.2 build 25C56, native Apple M4 arm64; Node v26.0.0 and pnpm 10.24.0. This runner cannot generate or execute native MSBuild/ARM64 PE inputs, so the target-native Windows jobs remain authoritative.
-
Remote and transport: none; synthetic generated-project fixtures and workflow/source contracts only
-
Exact red command:
pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs -
Red result: FAIL as intended, one failed and three passed tests because a generated
Release|arm64condition was rejected for thewin32-arm64tuple. -
Exact green commands:
node --check config/scripts/ssh-relay-node-pty-windows-build-determinism.mjs node --check config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-build.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-release-verification.test.mjs \ config/scripts/ssh-relay-node-tar-inspection.test.mjs \ config/scripts/ssh-relay-node-pty-build.test.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-windows-settlement.test.mjs \ config/scripts/ssh-relay-node-zip-inspection.test.mjs \ config/scripts/ssh-relay-runtime-artifact.test.mjs \ config/scripts/ssh-relay-runtime-build.test.mjs \ config/scripts/ssh-relay-runtime-pty-smoke.test.mjs \ config/scripts/ssh-relay-runtime-reproducibility.test.mjs \ config/scripts/ssh-relay-runtime-resource-diagnostics.test.mjs \ config/scripts/ssh-relay-runtime-windows-pe-diagnostic.test.mjs \ config/scripts/ssh-relay-runtime-windows-tree.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs \ config/scripts/ssh-relay-runtime-zip.test.mjs pnpm run typecheck pnpm exec oxlint config/scripts/ssh-relay-node-pty-windows-build-determinism.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs pnpm run check:max-lines-ratchet GOMAXPROCS=2 pnpm run lint pnpm exec oxfmt --check \ config/scripts/ssh-relay-node-pty-windows-build-determinism.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ docs/reference/plans/2026-07-14-ssh-relay-github-release-implementation-checklist.md pnpm exec lint-staged git diff --check -
Green result: PASS. Both syntax checks exited zero; the purpose command passed 8/8 tests across three suites; all 15 artifact suites passed 53/53 tests. Typecheck, focused oxlint, the 355-entry max-lines ratchet, full repository lint/reliability/localization, formatting, staged hooks, and diff checks exited zero. Full lint emitted only pre-existing warnings outside this package.
-
Duration and resource metrics: red suite 382 ms Vitest; purpose suite 181 ms Vitest; complete artifact suite 1.51 s Vitest; typecheck 3.41 s; focused lint/line ratchet 3.28 s; full lint 13.30 s. Synthetic peak RSS, open files/channels, and cancellation settlement were not instrumented.
-
Artifact/log/trace link: exact source commit and local command output; no binary artifact was created or uploaded
-
Oracle proved:
Release|arm64is accepted for only the expectedwin32-arm64architecture while the quoted Release condition remains exact apart from case. Wrong architecture, missing or duplicate group/option blocks, missing inheritance, and missing or duplicated required flags still fail closed. No source rewrite, producer, comparator, staging, or production path changed. -
Does not prove: the exact native generated XML, native flag propagation, complete arm64 build, paired disassembly, a safe producer correction, arm64 equality, oldest baselines, native trust, SSH, publication, transfer, fallback, UI, or any enabled tuple.
-
Checklist items satisfied: local generated-project platform-casing contract only; no tuple or production checkbox.
-
Follow-up: push the exact implementation and ledger head, then run all six target-native cells and require both Windows architectures to log the accepted generated settings before interpreting any later comparator mismatch.
E-M3-WINDOWS-ARM64-THUNK-DISASSEMBLY-CI-RED-001 — Native linker-thunk drift isolated
-
Date: 2026-07-14
-
Commit SHA / PR: exact head
e1a63930b4d350e8677e2be3a35b0bdec95f268c, containing exact lowercase-platform implementation commit4207c207ab932ef67522b4f73b98d63fa32d0924; stacked draft PR #8741 -
Run and jobs: run 29358223742, conclusion
failure; Linux arm6487171219009success, Windows arm6487171219067expected strict failure, Linux x6487171219080success, Windows x6487171219167success, macOS arm6487171219192success, and macOS x6487171219210success -
Runners: GitHub-hosted
ubuntu-24.04-arm/ubuntu24-arm6420260706.52.2native ARM64;windows-11-arm/win11-arm6420260706.102.1native ARM64;ubuntu-24.04/ubuntu2420260705.232.1native X64;windows-2022/win2220260706.237.1native X64;macos-15/macos1520260706.0213.1native ARM64; andmacos-15-intel/macos1520260629.0276.1native X64. Every job recorded Node v24.18.0 and the exact source commit. -
Remote and transport: none; target-native artifact assembly, generated-project verification, bundled-Node/native-module execution, strict comparison, and unpublished Actions artifacts only
-
Exact evidence commands:
gh pr view 8741 --repo stablyai/orca \ --json number,state,isDraft,headRefName,headRefOid,url,statusCheckRollup,updatedAt gh api repos/stablyai/orca/actions/runs/29358223742 gh api 'repos/stablyai/orca/actions/runs/29358223742/jobs?per_page=100' gh api 'repos/stablyai/orca/actions/runs/29358223742/artifacts?per_page=100' gh run view 29358223742 --repo stablyai/orca --job 87171219167 --log gh run view 29358223742 --repo stablyai/orca --job 87171219067 --log-failed gh api repos/stablyai/orca/actions/jobs/87171219067/logs | \ sed -n '/windows_arm64_disassembly=first/,$p' gh run download 29358223742 --repo stablyai/orca --dir <temporary-directory> jq -c '{tupleId,contentId,nodeVersion,archive,fileCount}' \ <temporary-directory>/*/*.identity.json -
Result: FAIL as the intended strict reproducibility gate. The lowercase
arm64correction reaches the one expected Release group on both native arm64 clean builds. Both log exactly one inherited compiler and linker option block containing/Breproand/experimental:deterministic, then assemble, inspect, verify, and execute the complete runtime. Each bundled Node v24.18.0 smoke proves ABI 137, patched PTY input/resize/exit code 23, watcher create/update/delete, and settled Windows resources. Strict comparison then rejects onlyruntime/node_modules/node-pty/build/Release/conpty_console_list.node; no arm64 output is staged for upload. -
Windows arm64 outputs: both PE files are 956,928 bytes. The first content identity is
sha256:a6adc716ec39503f68f4e322624ed9193b9343ca4b5f74d22843c47635e81519, with 33,261,547-byte ZIPsha256:5aebde73ef6cad605d13c5c27977f1229729aa28a6959649989d8ecd4a6d2a9e; the second issha256:2aef13722dd084941069d260591c529d1ca5ebf0b1e2defa34da4c43f44c2d24, with the same ZIP size and digestsha256:974612580fa7a008bcf3377ddd13ce5f99b78cc31c99c7b9b720066b3f9dc91c. Both archives contain 42 files and expand to 86,189,895 bytes. -
PE oracle: the complete scan reports 5,826 differing bytes across 2,886 coalesced ranges. The
.textcontribution is 5,758 bytes across 2,879 two-byte ranges from file offsets 1,052 through 47,102, exactly 16 bytes apart. The remaining 68 bytes are one four-byte COFF timestamp, three four-byte debug timestamps, one 16-byte CodeView identifier, and 36 derived.rdatabytes. Section layout, file size, executable control-flow bytes, and all other bytes match. -
Paired disassembly oracle: the first 512
.textbytes contain repeated 16-byte function thunks. For every displayed thunk,adrp x16, target,add x16, x16, offset, andbr x16are byte-identical. Only the unreachable fourth instruction differs: first build0000024d(udf #0x24d), second build0000016d(udf #0x16d). This classifies the changing bytes as linker-emitted thunk padding; it does not yet prove the generated linker setting responsible. -
Uploaded controls: exactly five unpublished seven-day artifacts and no Windows arm64 artifact: Linux x64
8321096098, 29,281,909 bytes,sha256:cbe4d1be7664227fa34fb977f568ba0fc9409d5b5f5139fd4937013e46501074, content IDsha256:960546cd96c67fcf9bb0a61e96ecdbecbffd9104d3a495578f8bb19dd810649a, archivesha256:c87306e069af8c849b7679ccdf0504cc48c51b0ac0586edcdbf698972156bab5; Linux arm648321099340, 28,212,775 bytes,sha256:0502a9710a9612c44fc2aa4792ee1f30859158fcac40668b59c35ca670eb83f2, content IDsha256:aa3aa8ae8b42334ba7b0dbe5c43fd1184e36b3f4f4a9bec0e990e9b78f090756, archivesha256:f017fcd7808cd8ba86175b2fad63103e880d57ccbec70412938e0cc145310eda; macOS x648321127611, 26,376,349 bytes,sha256:9297b99e9605c065cbf04d3431edadf8312ee19dd1b60d8790cba95f090bd68e, content IDsha256:585ea6034cdd07487d8667059f975a877c795a45dc0d6eeee1617f2e3749faa2, archivesha256:5669d69085d268e01fe5ece6e4372832c3f61c89bcefa9acaf732c81eb460775; macOS arm648321085541, 24,740,934 bytes,sha256:8ab194c0d0c08ab40aa8f7821738fd5c2e3b1821fb83df6d59992b6106ba46f2, content IDsha256:40ff5d2036784b794e7b09f78596409f63f3145280c530bece5280d40897f6cb, archivesha256:b51e5a6a53aeff2ae47e4156900981395516c9b246ab1ae3fff5c4c34500ee0a; and Windows x648321159937, 37,075,308 bytes,sha256:dcadebbcbb7d3c6f308badeefa7940350022b22bb76fd31baed15bb304af56c1, content IDsha256:2a6bfa06b445fb78d6e4a5abba6ec379cbed6f7830c805e82c7145d18a1c3d8b, archivesha256:ee1a0cc8bdf55d783ed1c1232dedd788710a1d88edd7e89a2ddfa84e0986d7ca. -
Duration and resource metrics: jobs ran 3m07s Linux arm64, 9m15s Windows arm64, 3m02s Linux x64, 5m22s Windows x64, 2m41s macOS arm64, and 4m11s macOS x64. Windows arm64 clean builds took 149,415.066 ms and 130,574.341 ms; verification took 7,688.862 ms and 8,012.846 ms, with smoke taking 5,865.144 ms at 53,235,712-byte RSS and 5,553.779 ms at 53,133,312-byte RSS. Cancellation, SSH channel/file counts, and fallback delay are outside this artifact-only run.
-
Artifact/log/trace link: run/jobs and the five unpublished artifacts above; rejected arm64 bytes exist only in the bounded job workspace and log diagnostics and were not uploaded
-
Oracle proved: real native lowercase platform acceptance, exact generated compiler/linker option propagation, two complete executable arm64 candidates, strict rejection, exact five-control reproducibility, bounded linker-thunk classification, and rejected-output no-upload.
-
Does not prove: whether MSBuild enabled incremental linking, that disabling it is the safe producer correction, arm64 equality, oldest baselines, native trust, SSH, publication, transfer, fallback, UI, or any enabled tuple. No executable byte may be normalized from this evidence.
-
Checklist items satisfied: target-native platform-case gate and bounded ARM64 instruction diagnostic only; no tuple or production checkbox.
-
Follow-up: add a purpose-tested bounded parser for the exact generated Release
LinkIncrementalstate, require both Windows clean builds to report it, and rerun all six native controls before considering one copied-artifact producer correction.
E-M3-WINDOWS-LINK-INCREMENTAL-DIAGNOSTIC-LOCAL-001 — Effective MSBuild link-state gate
-
Date: 2026-07-14
-
Commit SHA / PR: exact implementation commit
36a19f525cc63e488f49daa5c3a6aafc590acc08; stacked draft PR #8741, target-native execution pending -
Runner: macOS 26.2 build 25C56, native Apple M4 arm64; Node v26.0.0 and pnpm 10.24.0. This runner cannot evaluate a native MSBuild project, so the two Windows jobs remain authoritative.
-
Remote and transport: none; strict command/output contracts and builder ordering only
-
Exact red command:
pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs -
Red result: FAIL as intended, one failed and four passed tests because
windowsNodePtyLinkIncrementalCommandwas not implemented. -
Exact green commands:
node --check config/scripts/ssh-relay-node-pty-windows-build-determinism.mjs node --check config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs node --check config/scripts/ssh-relay-node-pty-build.mjs pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-build.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-release-verification.test.mjs \ config/scripts/ssh-relay-node-tar-inspection.test.mjs \ config/scripts/ssh-relay-node-pty-build.test.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-windows-settlement.test.mjs \ config/scripts/ssh-relay-node-zip-inspection.test.mjs \ config/scripts/ssh-relay-runtime-artifact.test.mjs \ config/scripts/ssh-relay-runtime-build.test.mjs \ config/scripts/ssh-relay-runtime-pty-smoke.test.mjs \ config/scripts/ssh-relay-runtime-reproducibility.test.mjs \ config/scripts/ssh-relay-runtime-resource-diagnostics.test.mjs \ config/scripts/ssh-relay-runtime-windows-pe-diagnostic.test.mjs \ config/scripts/ssh-relay-runtime-windows-tree.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs \ config/scripts/ssh-relay-runtime-zip.test.mjs pnpm run typecheck pnpm exec oxlint \ config/scripts/ssh-relay-node-pty-windows-build-determinism.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-build.mjs pnpm run check:max-lines-ratchet GOMAXPROCS=2 pnpm run lint pnpm exec oxfmt --check \ config/scripts/ssh-relay-node-pty-windows-build-determinism.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-build.mjs \ docs/reference/plans/2026-07-14-ssh-relay-github-release-implementation-checklist.md pnpm exec lint-staged git diff --check -
Green result: PASS. All syntax checks exited zero; the purpose command passed 9/9 tests across three suites; all 15 artifact suites passed 54/54 tests. Typecheck, focused oxlint, the 355-entry max-lines ratchet, full repository lint/reliability/localization, formatting, staged hooks, and diff checks exited zero. Full lint emitted only pre-existing warnings outside this package;
lint-stagedreported no staged files in its standalone run and the commit hook subsequently ran oxlint, React Doctor, and oxfmt successfully over all four staged files. -
Duration and resource metrics: purpose gate 1.93 s wall / 459 ms Vitest; complete artifact gate 2.87 s wall / 1.35 s Vitest; typecheck 3.10 s; focused lint and line ratchet 3.09 s; full lint 12.91 s. Synthetic peak RSS, open files/channels, cancellation settlement, and fallback delay were not instrumented.
-
Artifact/log/trace link: exact implementation commit and local command output; no binary artifact was created or uploaded
-
Oracle proved: Windows builds form a bounded
MSBuild.exequery for the exact generatedconpty_console_list.vcxproj, Release configuration, and tuple architecture; request only the evaluatedLinkIncrementalproperty; accept exactly one case-insensitive boolean result; and fail before staging on missing, noisy, or non-boolean output. x64 and arm64 commands are covered, POSIX creates no query, and the result is appended to the existing generated-setting record. -
Does not prove:
MSBuild.exe -getPropertyavailability or result on either native Windows image, the actual effective incremental-link state, the thunk owner, a safe producer correction, arm64 equality, oldest baselines, native trust, SSH, publication, transfer, fallback, UI, or any enabled tuple. -
Checklist items satisfied: local bounded effective-link-state diagnostic only; no tuple or production checkbox.
-
Follow-up: push the exact implementation and ledger head, run all six target-native cells, and require both Windows clean builds to report
linkIncrementalbefore changing the producer.
E-M3-WINDOWS-LINK-INCREMENTAL-CI-RED-001 — Native property oracle is empty and fails closed
-
Date: 2026-07-14
-
Commit SHA / PR: exact head
2d4433bbd0d2481d3f91c56d10155989cd6e7e44, containing exact diagnostic implementation commit36a19f525cc63e488f49daa5c3a6aafc590acc08; stacked draft PR #8741 -
Run and jobs: run 29359948742, conclusion
failure; macOS x6487177167723success, Linux x6487177167732success, Windows x6487177167740expected diagnostic failure, Windows arm6487177167757expected diagnostic failure, macOS arm6487177167776success, and Linux arm6487177167801success -
Runners: GitHub-hosted Windows x64 used
windows-2022/win2220260706.237.1, native X64; Windows arm64 usedwindows-11-arm/win11-arm6420260706.102.1, native ARM64. Both recorded Node v24.18.0 and exact source head2d4433bbd. The four POSIX cells used the same target-native labels as E-M3-WINDOWS-ARM64-THUNK-DISASSEMBLY-CI-RED-001. -
Remote and transport: none; target-native artifact assembly, strict pre-staging diagnostic, and unpublished Actions artifacts only
-
Exact evidence commands:
gh run view 29359948742 --repo stablyai/orca \ --json headSha,status,conclusion,url,createdAt,updatedAt,jobs gh api repos/stablyai/orca/actions/jobs/87177167740/logs gh api repos/stablyai/orca/actions/jobs/87177167757/logs gh api 'repos/stablyai/orca/actions/runs/29359948742/artifacts?per_page=100' -
Result: FAIL as the intended diagnostic boundary. Each native Windows job completes the first copied node-pty build and validates the generated Release compiler/linker option blocks. The subsequent
MSBuild.exe -getProperty:LinkIncrementalquery exits zero but writes only an empty value. The strict parser rejects it withunexpected LinkIncremental evaluation from MSBuildbefore runtime staging, archive creation, verification, smoke, comparison, or upload. This proves the property oracle is not usable and does not prove that incremental linking is enabled or disabled. -
Uploaded controls: exactly four unpublished seven-day POSIX artifacts and no Windows artifacts: Linux x64
8321792649, 29,280,250 bytes,sha256:81b21c5f0670cd0337a9b8c666a154c474f52780d19d745497e25bbe69adcfe3; Linux arm648321797660, 28,211,154 bytes,sha256:deca7d86e20442287878c6d17f6d533ba6be626dd7ff765f7cd841986272ffc8; macOS x648321944562, 26,386,865 bytes,sha256:045573de326e8f9532ac31d5449f4aed4a201bbf152c98d971aa761c76e5ec37; and macOS arm648321811571, 24,727,700 bytes,sha256:8fc66890341f548671ec15d0875186ca5ea128cb1ea959a2a69cacc14b9c0864. -
Duration and resource metrics: jobs ran 9m08s macOS x64, 3m13s Linux x64, 2m50s Windows x64, 6m31s Windows arm64, 3m56s macOS arm64, and 3m21s Linux arm64. Both Windows failures occur after one native build but before runtime smoke, so no new Windows RSS, channel/file count, cancellation, or fallback metric exists.
-
Artifact/log/trace link: run/jobs and the four unpublished POSIX artifacts above; no Windows runtime or binary was staged or uploaded
-
Oracle proved: both native Windows architectures return an empty evaluated Release
LinkIncrementalproperty and the bounded diagnostic rejects it before staging. All four POSIX controls remain reproducible and upload. -
Does not prove: the actual linker command, whether
/INCREMENTALwas passed, the thunk owner, a safe producer correction, Windows runtime equality, oldest baselines, native trust, SSH, publication, transfer, fallback, UI, or any enabled tuple. -
Checklist items satisfied: native negative property-oracle evidence only; no tuple or production checkbox.
-
Follow-up: inspect the actual post-build
link.command.1.tlogunder a byte cap, emit only an allowlisted switch summary, and retain all existing strict comparison/no-upload controls.
E-M3-WINDOWS-LINK-COMMAND-TRACKING-LOCAL-001 — Bounded native linker-command gate
-
Date: 2026-07-14
-
Commit SHA / PR: exact implementation commit
4a66435b71b158624645c614543d139a9ea45d51; stacked draft PR #8741, target-native execution pending -
Runner: macOS 26.2 build 25C56, native Apple M4 arm64; Node v26.0.0 and pnpm 10.24.0. This runner cannot generate the native MSBuild tracking file, so Windows x64/arm64 jobs remain authoritative.
-
Remote and transport: none; bounded local file/parser and builder-ordering contracts only
-
Exact red commands:
pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs /usr/bin/time -lp pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-build.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs -
Red result: the pre-implementation purpose suite failed two and passed four tests because the tracking-path/parser contracts did not exist. The later bounded-reader audit deliberately added malformed UTF-16 input and failed one of eleven tests because
Buffer.toString('utf16le')preserved a lone surrogate instead of rejecting it. FatalTextDecoderdecoding closed that gap; the audit red run took 0.99 s wall with 131,973,120-byte maximum RSS and 96,196,032-byte peak memory footprint. -
Exact green commands:
node --check config/scripts/ssh-relay-node-pty-windows-build-determinism.mjs node --check config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs node --check config/scripts/ssh-relay-node-pty-build.mjs /usr/bin/time -lp pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-build.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs /usr/bin/time -lp pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-release-verification.test.mjs \ config/scripts/ssh-relay-node-tar-inspection.test.mjs \ config/scripts/ssh-relay-node-pty-build.test.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-windows-settlement.test.mjs \ config/scripts/ssh-relay-node-zip-inspection.test.mjs \ config/scripts/ssh-relay-runtime-artifact.test.mjs \ config/scripts/ssh-relay-runtime-build.test.mjs \ config/scripts/ssh-relay-runtime-pty-smoke.test.mjs \ config/scripts/ssh-relay-runtime-reproducibility.test.mjs \ config/scripts/ssh-relay-runtime-resource-diagnostics.test.mjs \ config/scripts/ssh-relay-runtime-windows-pe-diagnostic.test.mjs \ config/scripts/ssh-relay-runtime-windows-tree.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs \ config/scripts/ssh-relay-runtime-zip.test.mjs pnpm run typecheck pnpm exec oxlint \ config/scripts/ssh-relay-node-pty-windows-build-determinism.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-build.mjs pnpm run check:max-lines-ratchet GOMAXPROCS=2 pnpm run lint pnpm exec oxfmt --check \ config/scripts/ssh-relay-node-pty-windows-build-determinism.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-build.mjs \ docs/reference/plans/2026-07-14-ssh-relay-github-release-implementation-checklist.md git diff --check -
Green result: PASS. The purpose suites pass 11/11 tests and all 15 artifact suites pass 56/56. Syntax checks, typecheck, focused oxlint, the 355-entry max-lines ratchet, full repository lint/reliability/localization, formatting, and diff checks exit zero. Full lint emits only pre-existing warnings outside this artifact package.
-
Duration and resource metrics: purpose gate 0.89 s wall / 166 ms Vitest with 132,513,792-byte maximum RSS and 96,720,296-byte peak footprint; complete artifact gate 1.35 s wall / 550 ms Vitest with 137,068,544-byte maximum RSS and 95,819,104-byte peak footprint; typecheck 3.10 s, focused lint 0.34 s, max-lines 2.01 s, full lint 10.89 s, and format 2.24 s. No SSH channels/files, cancellation, fallback, or runtime latency is exercised by this diagnostic-only package.
-
Artifact/log/trace link: current exact source/tests and local command output; no runtime artifact was created, staged, published, or uploaded
-
Oracle proved: the builder locates the target-specific post-build
conpty_console_list.tlog/link.command.1.tlog, reads at most 256 KiB plus one rejection byte, accepts fatal UTF-16LE-BOM or UTF-8 decoding, requires exactly one command record and one each of/Brepro,/guard:cf, and/experimental:deterministic, classifies incremental linking as enabled/disabled/unspecified, and emits only the allowlisted switch summary. Oversize, malformed encoding/switches, duplicate records/switches, ambiguous incremental states, and missing required switches fail before runtime staging. POSIX paths create no tracking-file lookup. -
Does not prove: the file path/encoding/record shape on either native Windows runner, the emitted switch summary, the incremental-link state, thunk ownership, a safe producer correction, arm64 equality, oldest baselines, native trust, SSH, publication, transfer, fallback, UI, or any enabled tuple.
-
Checklist items satisfied: local bounded post-build tracking diagnostic only; no tuple or production checkbox.
-
Follow-up: push the exact implementation and ledger head, run all six target-native cells, and require both Windows clean builds to emit the same accepted summary before changing the producer.
E-M3-WINDOWS-LINK-COMMAND-PATH-CI-RED-001 — Native fixed tracking path is absent
-
Date: 2026-07-14
-
Commit SHA / PR: exact head
dafca2060f2daf4ba27b54a0eb18bb9700136f5b, containing exact tracking implementation commit4a66435b71b158624645c614543d139a9ea45d51; stacked draft PR #8741 -
Run and jobs: run 29361673339, conclusion
failure; macOS arm6487183054190success, Linux arm6487183054293success, Windows arm6487183054295expected diagnostic failure, macOS x6487183054306success, Linux x6487183054310success, and Windows x6487183054318expected diagnostic failure -
Runners: GitHub-hosted Windows x64 used
windows-2022/win2220260706.237.1, native X64; Windows arm64 usedwindows-11-arm64/win11-arm6420260706.102.1, native ARM64. Both used runner2.335.1, Node v24.18.0, MSVC 14.44.35207, and exact source headdafca2060. The four POSIX controls used their previously recorded target-native labels. -
Remote and transport: none; target-native artifact assembly, strict pre-staging diagnostic, and unpublished Actions artifacts only
-
Exact evidence commands:
gh run view 29361673339 --repo stablyai/orca \ --json status,conclusion,headSha,createdAt,updatedAt,url,jobs gh api repos/stablyai/orca/actions/jobs/87183054318/logs gh api repos/stablyai/orca/actions/jobs/87183054295/logs gh api 'repos/stablyai/orca/actions/runs/29361673339/artifacts?per_page=100' -
Result: FAIL as the intended diagnostic boundary. Each Windows job successfully compiles
conpty_console_list.nodefor its native architecture, then the bounded reader receivesENOENTfor the locally assumed fixedbuild/Release/obj/conpty_console_list/conpty_console_list.tlog/link.command.1.tloglocation. Both jobs fail before runtime staging, verification, smoke, comparison, or upload. This proves only that the fixed path is wrong; it does not show whether a target-matching tracking file exists elsewhere. -
Uploaded controls: exactly four unpublished seven-day POSIX artifacts and no Windows artifacts: Linux x64
8322467354, 29,282,467 bytes,sha256:75a29015224b0dd96e479f94d362be7023af0263373192332488ca4cc30647ae; Linux arm648322477826, 28,215,101 bytes,sha256:07e9be64b1ab7fd2a9ebf9a30672bd275c670d5f0c95bd624b933d3bc870515e; macOS x648322529916, 26,372,643 bytes,sha256:a0c3fdd314b19b0f371b5ea88eb862dfe335a785506b8011f8fde915f1323b1c; and macOS arm648322474835, 24,749,773 bytes,sha256:11ddd1291e7b104edae6e54d18ab44a20a90aa28a29ed3d2bd92e2f3202d215c. -
Duration and resource metrics: jobs ran 3m25s macOS arm64, 3m27s Linux arm64, 6m40s Windows arm64, 5m37s macOS x64, 3m06s Linux x64, and 3m00s Windows x64. Both Windows failures occur after one native compile but before runtime smoke; no new Windows RSS, channel/file count, cancellation, or fallback metric exists.
-
Artifact/log/trace link: run/jobs and the four unpublished POSIX artifacts above; no Windows runtime or rejected binary was staged or uploaded
-
Oracle proved: both native Windows architectures share the same absent fixed tracking path while the target native build itself completes; all four POSIX controls remain reproducible and upload; rejected Windows output remains unavailable to consumers.
-
Does not prove: the actual tracking-file path, candidate cardinality, command record shape, allowlisted switch summary, incremental-link state, thunk ownership, a safe producer correction, Windows runtime equality, oldest baselines, native trust, SSH, publication, transfer, fallback, UI, or any enabled tuple.
-
Checklist items satisfied: native negative path-shape evidence only; no tuple or production checkbox.
-
Follow-up: replace the false fixed-path assumption with bounded build-tree discovery that requires exactly one target-matching
link.command.1.tlog, then rerun all six native cells without weakening parsing, comparison, or no-upload controls.
E-M3-WINDOWS-LINK-COMMAND-DISCOVERY-LOCAL-001 — Bounded target-matching discovery
-
Date: 2026-07-14
-
Commit SHA / PR: exact implementation commit
6198f0ddd5b31704ab72902e9a21e78412da870d; stacked draft PR #8741, target-native execution pending -
Runner: macOS 26.2 build 25C56, native Apple M4 arm64; Node v26.0.0 and pnpm 10.24.0. This runner cannot generate the native MSBuild tree, so Windows x64/arm64 jobs remain authoritative.
-
Remote and transport: none; bounded build-tree discovery, target selection, and builder-ordering contracts only
-
Red evidence: E-M3-WINDOWS-LINK-COMMAND-PATH-CI-RED-001 on both native Windows architectures; no synthetic local failure is substituted for that real path-shape evidence
-
Exact green commands:
node --check config/scripts/ssh-relay-node-pty-windows-build-determinism.mjs node --check config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs node --check config/scripts/ssh-relay-node-pty-build.mjs /usr/bin/time -lp pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-build.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-release-verification.test.mjs \ config/scripts/ssh-relay-node-tar-inspection.test.mjs \ config/scripts/ssh-relay-node-pty-build.test.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-windows-settlement.test.mjs \ config/scripts/ssh-relay-node-zip-inspection.test.mjs \ config/scripts/ssh-relay-runtime-artifact.test.mjs \ config/scripts/ssh-relay-runtime-build.test.mjs \ config/scripts/ssh-relay-runtime-pty-smoke.test.mjs \ config/scripts/ssh-relay-runtime-reproducibility.test.mjs \ config/scripts/ssh-relay-runtime-resource-diagnostics.test.mjs \ config/scripts/ssh-relay-runtime-windows-pe-diagnostic.test.mjs \ config/scripts/ssh-relay-runtime-windows-tree.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs \ config/scripts/ssh-relay-runtime-zip.test.mjs pnpm run typecheck pnpm exec oxlint \ config/scripts/ssh-relay-node-pty-windows-build-determinism.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-build.mjs pnpm run check:max-lines-ratchet GOMAXPROCS=2 pnpm run lint pnpm exec oxfmt --check \ config/scripts/ssh-relay-node-pty-windows-build-determinism.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-build.mjs \ docs/reference/plans/2026-07-14-ssh-relay-github-release-implementation-checklist.md git diff --check -
Green result: PASS. The purpose suites pass 13/13 tests and all 15 artifact suites pass 58/58. Syntax checks, typecheck, focused oxlint, the 355-entry max-lines ratchet, full repository lint/reliability/localization, formatting, and diff checks exit zero. Full lint emits only pre-existing warnings outside this artifact package.
-
Duration and resource metrics: focused purpose gate 1.03 s wall / 227 ms Vitest with 131,825,664-byte maximum RSS and 95,999,352-byte peak footprint; complete artifact gate 2.96 s wall / 1.36 s Vitest; typecheck 3.08 s, focused lint 0.66 s, max-lines 1.47 s, and full lint 13.87 s. The final full artifact run was parallel with static gates, so its process RSS was not isolated. No SSH channels/files, cancellation, fallback, or runtime latency is exercised.
-
Artifact/log/trace link: current exact source/tests and local command output; no runtime artifact was created, staged, published, or uploaded
-
Oracle proved: discovery is deterministic and bounded to 10,000 build-tree entries, depth eight, and 32 exact-name candidates; symbolic links fail closed; each candidate read remains bounded; target selection requires exactly one token-bounded
conpty_console_list.nodeoutput rather than a lookalike or path assumption. Missing/duplicate targets, excessive depth/cardinality, oversized bytes, malformed contents, and all existing strict-parser failures settle before staging. POSIX performs no discovery. -
Does not prove: that either native Windows tree contains a candidate, candidate cardinality on the runners, the actual record shape, allowlisted switch summary, incremental-link state, thunk ownership, a safe producer correction, arm64 equality, oldest baselines, native trust, SSH, publication, transfer, fallback, UI, or any enabled tuple.
-
Checklist items satisfied: local bounded tracking discovery only; no tuple or production checkbox.
-
Follow-up: push the exact implementation and ledger head, rerun all six target-native cells, and require both Windows clean builds to select one target record and emit the same accepted summary before changing the producer.
E-M3-WINDOWS-LINK-COMMAND-DISCOVERY-CI-RED-001 — Whole build tree exceeds depth bound
-
Date: 2026-07-14
-
Commit SHA / PR: exact head
f9a49d53123b27b19713eadef927de1102ec08de, containing exact discovery implementation commit6198f0ddd5b31704ab72902e9a21e78412da870d; stacked draft PR #8741 -
Run and jobs: run 29362672415, conclusion
failure; Windows x6487186432938expected diagnostic failure, Windows arm6487186432948expected diagnostic failure, macOS arm6487186432965success, Linux arm6487186432979success, Linux x6487186432980success, and macOS x6487186433013success -
Runners: GitHub-hosted Windows x64 and arm64 used the same native labels, images, runner, Node, and MSVC versions recorded by E-M3-WINDOWS-LINK-COMMAND-PATH-CI-RED-001; exact source head was
f9a49d531. The four POSIX controls used their previously recorded target-native labels. -
Remote and transport: none; target-native artifact assembly, bounded build-tree discovery, and unpublished Actions artifacts only
-
Exact evidence commands:
gh run view 29362672415 --repo stablyai/orca \ --json status,conclusion,headSha,createdAt,updatedAt,url,jobs gh api repos/stablyai/orca/actions/jobs/87186432938/logs gh api repos/stablyai/orca/actions/jobs/87186432948/logs gh api 'repos/stablyai/orca/actions/runs/29362672415/artifacts?per_page=100' -
Result: FAIL as the intended discovery boundary. Each Windows job successfully compiles the target and enters bounded discovery, then rejects with
MSBuild linker tracking discovery exceeds the bounded depthbefore opening or parsing a candidate. Starting at the complete generatedbuildtree includes unrelated dependency/project subtrees; the evidence does not justify raising the eight-level limit. Both logs show the target binary is emitted underbuild/Release, which is the narrow output-tree root for the next correction. -
Uploaded controls: exactly four unpublished seven-day POSIX artifacts and no Windows artifacts: Linux x64
8322871131, 29,278,807 bytes,sha256:b11ceb6bd42d28d379d32b3627a242f60cf62f78e9a7267589220ce7737b9c63; Linux arm648322874205, 28,209,038 bytes,sha256:f2195e1f4c03d1fb6507e32b5d5328a65f351c2c22b56a8144aa1c9449c3f733; macOS x648322934998, 26,370,804 bytes,sha256:6fea712fd57b06cc93a7e8f0f3ebda4526307258be66ba901cd3fc190f7a03ed; and macOS arm648322879006, 24,728,020 bytes,sha256:2407308e60002c5e735cd301f1f30e9754d5c383a18f36009d14f08085f1f577. -
Duration and resource metrics: jobs ran 2m58s Windows x64, 6m25s Windows arm64, 3m45s macOS arm64, 3m25s Linux arm64, 3m22s Linux x64, and 5m56s macOS x64. Windows fails after one native compile but before runtime smoke; no new Windows RSS, channel/file count, cancellation, or fallback metric exists.
-
Artifact/log/trace link: run/jobs and four unpublished POSIX artifacts above; no Windows runtime or rejected binary was staged or uploaded
-
Oracle proved: both native Windows architectures reach and enforce the same traversal-depth bound; whole-build-tree discovery is too broad; the target output tree is
build/Release; all four POSIX controls remain reproducible and upload. -
Does not prove: whether
build/Releasecontains tracking candidates, candidate/target cardinality, record shape, allowlisted switch summary, incremental-link state, thunk ownership, a safe producer correction, Windows equality, oldest baselines, native trust, SSH, publication, transfer, fallback, UI, or any enabled tuple. -
Checklist items satisfied: native negative discovery-root evidence only; no tuple or production checkbox.
-
Follow-up: narrow the discovery root to
build/Releasewithout raising or removing any bound, then rerun all six native cells and require exactly one target record on both Windows runners.
E-M3-WINDOWS-LINK-COMMAND-RELEASE-ROOT-LOCAL-001 — Release output-tree discovery scope
-
Date: 2026-07-14
-
Commit SHA / PR: exact implementation commit
6f28a8cbf53d1cfe889ce259476eb4aaaead2d87; stacked draft PR #8741, target-native execution pending -
Runner: macOS 26.2 build 25C56, native Apple M4 arm64; Node v26.0.0 and pnpm 10.24.0. This runner cannot generate the native MSBuild tree, so Windows x64/arm64 jobs remain authoritative.
-
Remote and transport: none; bounded discovery-root and builder-ordering contracts only
-
Red evidence: E-M3-WINDOWS-LINK-COMMAND-DISCOVERY-CI-RED-001 on both native Windows architectures; no synthetic local failure substitutes for that real traversal-shape evidence
-
Exact green commands:
node --check config/scripts/ssh-relay-node-pty-windows-build-determinism.mjs node --check config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs node --check config/scripts/ssh-relay-node-pty-build.mjs /usr/bin/time -lp pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-build.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-release-verification.test.mjs \ config/scripts/ssh-relay-node-tar-inspection.test.mjs \ config/scripts/ssh-relay-node-pty-build.test.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-windows-settlement.test.mjs \ config/scripts/ssh-relay-node-zip-inspection.test.mjs \ config/scripts/ssh-relay-runtime-artifact.test.mjs \ config/scripts/ssh-relay-runtime-build.test.mjs \ config/scripts/ssh-relay-runtime-pty-smoke.test.mjs \ config/scripts/ssh-relay-runtime-reproducibility.test.mjs \ config/scripts/ssh-relay-runtime-resource-diagnostics.test.mjs \ config/scripts/ssh-relay-runtime-windows-pe-diagnostic.test.mjs \ config/scripts/ssh-relay-runtime-windows-tree.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs \ config/scripts/ssh-relay-runtime-zip.test.mjs pnpm run typecheck pnpm exec oxlint \ config/scripts/ssh-relay-node-pty-windows-build-determinism.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-build.mjs pnpm run check:max-lines-ratchet GOMAXPROCS=2 pnpm run lint pnpm exec oxfmt --check \ config/scripts/ssh-relay-node-pty-windows-build-determinism.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-build.mjs \ docs/reference/plans/2026-07-14-ssh-relay-github-release-implementation-checklist.md git diff --check -
Green result: PASS. The purpose suites pass 13/13 tests and all 15 artifact suites pass 58/58. Syntax checks, typecheck, focused oxlint, the 355-entry max-lines ratchet, full repository lint/reliability/localization, formatting, and diff checks exit zero. Full lint emits only pre-existing warnings outside this package.
-
Duration and resource metrics: focused purpose gate 1.26 s wall / 263 ms Vitest with 131,710,976-byte maximum RSS and 95,868,256-byte peak footprint; complete artifact gate 4.01 s wall / 1.92 s Vitest; typecheck 4.21 s, focused lint 0.90 s, max-lines 2.37 s, and full lint 13.78 s. The final artifact run was parallel with static gates, so its process RSS was not isolated. No SSH channels/files, cancellation, fallback, or runtime latency is exercised.
-
Artifact/log/trace link: current exact source/tests and local command output; no runtime artifact was created, staged, published, or uploaded
-
Oracle proved: target discovery begins at
build/Release, matching the exact native output tree evidenced by both Windows logs; tests place valid, irrelevant, duplicate, oversized, deep, and over-cardinality fixtures below that root. The existing entry/depth/candidate/byte, symbolic-link, encoding, target-cardinality, strict-parser, and POSIX no-op contracts remain unchanged. -
Does not prove: that either native Release tree contains a candidate, candidate/target cardinality, record shape, allowlisted switch summary, incremental-link state, thunk ownership, a safe producer correction, arm64 equality, oldest baselines, native trust, SSH, publication, transfer, fallback, UI, or any enabled tuple.
-
Checklist items satisfied: local Release-tree discovery scope only; no tuple or production checkbox.
-
Follow-up: push the exact implementation and ledger head, rerun all six target-native cells, and require both Windows clean builds to select one target record and emit the same accepted summary before changing the producer.
E-M3-WINDOWS-LINK-COMMAND-RELEASE-ROOT-CI-RED-001 — Native command classified; arm64 drift retained
-
Date: 2026-07-14
-
Commit SHA / PR: exact head
2db46d91b17789ce70eed5e5e496dec2ff56442a, containing exact Release-root implementation commit6f28a8cbf53d1cfe889ce259476eb4aaaead2d87; stacked draft PR #8741 -
Run and jobs: run 29363423068, conclusion
failure; Windows x6487188953411success, Windows arm6487188953416expected strict-comparison failure, Linux arm6487188953471success, Linux x6487188953495success, macOS x6487188953507success, and macOS arm6487188953532success -
Runners: Windows x64 used
windows-2022/win2220260706.237.1, native X64, Windows Server 2022 build 20348; Windows arm64 usedwindows-11-arm/win11-arm6420260706.102.1, native ARM64, Windows build 26200. Both used Node v24.18.0 and MSVC 14.44.35207 / compiler 19.44.35228. Linux x64 usedubuntu-24.04/ubuntu2420260705.232.1; Linux arm64 usedubuntu-24.04-arm/ubuntu24-arm6420260706.52.2; macOS x64 usedmacos-15-intel/macos1520260629.0276.1; macOS arm64 usedmacos-15/macos1520260706.0213.1. Every runner checked out the exact head above. -
Remote and transport: none; target-native artifact assembly, strict comparison, and unpublished seven-day Actions artifacts only
-
Exact evidence commands:
gh run view 29363423068 --repo stablyai/orca \ --json status,conclusion,headSha,createdAt,updatedAt,url,jobs gh api repos/stablyai/orca/actions/jobs/87188953411/logs gh api repos/stablyai/orca/actions/jobs/87188953416/logs gh api 'repos/stablyai/orca/actions/runs/29363423068/artifacts?per_page=100' -
Result: FAIL as the intended strict reproducibility boundary. Each clean build on both Windows architectures discovers three
link.command.1.tlogcandidates under 82build/Releaseentries, selects exactly one record namingconpty_console_list.node, and accepts fatal UTF-16LE input. The two x64 records are 2,114 bytes and the two arm64 records are 2,092 bytes. All four reportincremental: unspecifiedand the identical allowlisted switches/brepro,/debug,/experimental:deterministic, and/guard:cf; no explicit/incrementalor/optswitch is present. Windows x64 and all four POSIX jobs compare exactly. Windows arm64 builds, verifies, and executes both candidates, then strict comparison rejects onlyruntime/node_modules/node-pty/build/Release/conpty_console_list.nodeand skips upload. -
Arm64 diagnostic: the two 956,928-byte modules differ at 5,826 bytes across 2,886 ranges: 5,758 bytes in 2,879 two-byte
.textranges spaced 16 bytes apart, plus 68 derived COFF/debug/CodeView bytes. Their content IDs aresha256:4c4cc3b9ee0bac3a391a49ebfce230fef1d94984ef0f66eeba59fd2833b2a0d2andsha256:26afc17c33337f6f1b8e767504a58207f4fc68cb26e807aca68a9d5e8040aba5. -
Uploaded controls: exactly five unpublished artifacts and no Windows arm64 artifact: Windows x64
8323220212, 37,075,312 bytes,sha256:10a07ff4863e4a0b4aef3325540660952f03f88cc7b2c2a4013f3081b5c9310c; Linux x648323166437, 29,285,377 bytes,sha256:21ee42d19e6a9f15e7afda18f9e27ff5ae280a19da61ef4042ca5b0a3ce608fe; Linux arm648323165493, 28,220,691 bytes,sha256:19cb887221810cd9e9df160d6ba6a185fd6282adee90d2dde6c66ad9a83e4fe1; macOS x648323238492, 26,405,918 bytes,sha256:af41bae838a26b1e127bc1bd20c3d1f2a6d0d5de1f6aeb9372d2b19561a2351a; and macOS arm648323152771, 24,729,554 bytes,sha256:aff001434f0d00db32d92a13ffbb40ed4f0cc0199cf29925109fc7f7bbf84977. -
Duration and resource metrics: jobs ran 5m33s Windows x64, 8m15s Windows arm64, 3m25s Linux arm64, 3m30s Linux x64, 6m18s macOS x64, and 2m55s macOS arm64. Windows arm64 clean builds took 135,371.797 ms and 118,713.734 ms; smoke took 5,767.417 ms at 53,186,560-byte RSS and 5,443.331 ms at 51,802,112-byte RSS. SSH channels/files, cancellation, and fallback delay remain outside this artifact-only run.
-
Artifact/log/trace link: run/jobs and the five unpublished artifacts above; rejected arm64 bytes existed only in the bounded job workspace and logs and were not uploaded
-
Oracle proved: the native Release-tree shape, candidate and target cardinality, record encoding, and allowlisted linker summary on both Windows architectures; no explicit incremental-link switch; five exact clean-build controls; unchanged arm64 thunk drift; strict rejection and no-upload.
-
Does not prove: effective incremental linking when
/DEBUGsupplies a default, the target.ilkstate, a safe producer correction, arm64 equality, oldest baselines, native trust, SSH, publication, transfer, fallback, UI, or any enabled tuple. -
Checklist items satisfied: native Release-root/command diagnostic only; no tuple or production checkbox.
-
Follow-up: inspect only the exact target
.ilkfile's presence and size within the already bounded clean Release tree on both architectures. If it is present, require target-native evidence before considering copied-artifact/INCREMENTAL:NO; if absent, investigate the next bounded linker feature. Preserve/guard:cf, strict comparison, rejected-output no-upload, and all repository-wide/default behavior.
E-M3-WINDOWS-INCREMENTAL-DATABASE-LOCAL-001 — Bounded target .ilk diagnostic
-
Date: 2026-07-14
-
Commit SHA / PR: exact implementation commit
e7d9a1c8d3222ff5923679ad69b76b57d963c4f3; stacked draft PR #8741, target-native execution pending -
Runner: macOS 26.2 build 25C56, native Apple M4 arm64; Node v26.0.0 and pnpm 10.24.0. This runner cannot produce a native MSVC
.ilk, so Windows x64/arm64 jobs remain authoritative. -
Remote and transport: none; bounded local discovery/result-shape contracts only
-
Red evidence: E-M3-WINDOWS-LINK-COMMAND-RELEASE-ROOT-CI-RED-001 proves both native commands carry
/DEBUGbut no explicit/INCREMENTAL; no synthetic local result substitutes for the pending target-native file-state evidence -
Exact green commands:
node --check config/scripts/ssh-relay-node-pty-windows-build-determinism.mjs node --check config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs /usr/bin/time -lp pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-build.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs /usr/bin/time -lp pnpm exec vitest run --config config/vitest.config.ts \ config/scripts/ssh-relay-node-release-verification.test.mjs \ config/scripts/ssh-relay-node-tar-inspection.test.mjs \ config/scripts/ssh-relay-node-pty-build.test.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-windows-settlement.test.mjs \ config/scripts/ssh-relay-node-zip-inspection.test.mjs \ config/scripts/ssh-relay-runtime-artifact.test.mjs \ config/scripts/ssh-relay-runtime-build.test.mjs \ config/scripts/ssh-relay-runtime-pty-smoke.test.mjs \ config/scripts/ssh-relay-runtime-reproducibility.test.mjs \ config/scripts/ssh-relay-runtime-resource-diagnostics.test.mjs \ config/scripts/ssh-relay-runtime-windows-pe-diagnostic.test.mjs \ config/scripts/ssh-relay-runtime-windows-tree.test.mjs \ config/scripts/ssh-relay-runtime-workflow.test.mjs \ config/scripts/ssh-relay-runtime-zip.test.mjs pnpm run typecheck pnpm exec oxlint \ config/scripts/ssh-relay-node-pty-windows-build-determinism.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-build.mjs pnpm run check:max-lines-ratchet GOMAXPROCS=2 pnpm run lint pnpm exec oxfmt --check \ config/scripts/ssh-relay-node-pty-windows-build-determinism.mjs \ config/scripts/ssh-relay-node-pty-windows-build-determinism.test.mjs \ config/scripts/ssh-relay-node-pty-build.mjs \ docs/reference/plans/2026-07-14-ssh-relay-github-release-implementation-checklist.md git diff --check -
Result: PASS. The purpose suites pass 13/13 tests and all 15 artifact suites pass 58/58. Syntax, typecheck, focused oxlint, the 355-entry max-lines ratchet, full repository lint/reliability/localization, formatting, diff, and staged pre-commit hooks exit zero. Full lint emits only pre-existing warnings outside this artifact package.
-
Duration and resource metrics: purpose gate 0.94 s wall / 204 ms Vitest with 131,940,352-byte maximum RSS and 96,081,224-byte peak footprint; complete artifact gate 3.50 s wall / 1.59 s Vitest with 132,235,264-byte maximum RSS and 96,392,544-byte peak footprint. The parallel typecheck/focused-lint/max-lines group completed in 3.8 s; full lint completed in 17.3 s and formatting/diff checks in 0.8 s. No runtime archive, SSH channel/file, cancellation, fallback, or launch-latency metric is exercised by this diagnostic-only package.
-
Artifact/log/trace link: exact implementation commit and local command output; no runtime artifact was created, staged, published, or uploaded
-
Oracle proved: the already bounded and deterministic
build/Releasetraversal detects at most one exact case-insensitiveconpty_console_list.ilk; duplicate target databases fail closed; a present file reports only a safe numeric byte size, absence reports no guessed link state, symbolic links retain the existing rejection, and POSIX remains a no-op. The diagnostic result is appended to the existing allowlisted MSBuild summary before staging. -
Does not prove: whether either native Windows build emits the target
.ilk, that.ilkpresence alone owns the arm64 thunk drift, that/INCREMENTAL:NOis a safe correction, arm64 equality, oldest baselines, native trust, SSH, publication, transfer, fallback, UI, or any enabled tuple. -
Checklist items satisfied: local bounded target incremental-database diagnostic only; no tuple or production checkbox.
-
Follow-up: push the exact implementation plus ledger head, rerun all six native cells, and require both clean builds on both Windows architectures to report the target
.ilkstate before any producer change. Preserve/guard:cf, strict comparison, no rejected upload, and every default/legacy boundary.
Accepted Gaps
No product gap is accepted merely because it appears in this list. Each entry requires explicit owner and promotion condition.
| Gap | Current behavior | Risk | Owner | Promotion/removal condition | Status |
|---|---|---|---|---|---|
| Bundled runtime only partially implemented | Six unpublished native artifact proofs; no production consumer | #8450/#1693 environment failures remain | Codex implementation owner | Complete Work Packages 2–7 plus Milestones 3–14 | Open |
| No bundled tuple enabled | Every target's default and effective mode remains legacy | No bundled support claim can be made | Codex implementation owner | Complete target-native build/trust and both required live-evidence layers | Open |
| Windows runtime smoke incomplete | Native x64/arm64 smoke settles and uploads exact evidence | Historical blocker is closed | Codex implementation owner | Met by E-M3-WINDOWS-CI-001 | CLOSED |
| Native clean-rebuild identity unproved | Five controls pass; arm64 target command has no explicit /INCREMENTAL |
Toolchain drift may change native content IDs | Codex implementation owner | Classify target .ilk, then make all six clean builds match |
Open |
| Cross-family Layer B remotes unavailable | GitHub native runner labels exist; no approved reachable target pool | Client/remote integration gaps may escape | Repository release administrator + implementation owner | Approve provider/snapshots/credentials/egress/teardown/cost owner | BLOCKED |
| Musl has no accepted official Node binary | Musl is deliberately legacy-only | Unofficial binary would break provenance trust | Codex implementation owner | Orca-owned target-native source build, signing, provenance, and live gates | ACCEPTED GAP |
| Native arm64 live matrices incomplete | Hosted Linux/Windows arm64 labels exist; full SSH/runtime cells do not | Cross-build or unit tests may hide native bugs | Codex implementation owner | Full native archive, trust, SFTP/system-SSH, RPC, and baseline evidence | Open |
| Legacy performance baseline unmeasured | Numeric budgets exist; paired cold/warm measurements do not | Regression thresholds lack a measured baseline | Codex implementation owner | Purpose-built paired harness with ten samples on pinned runner classes | Open |
| Manifest signing environment unprovisioned | Ed25519/key-rotation policy exists; no protected runtime signing secret | Runtime assets cannot be safely published | Repository release administrator | Protected environment, reviewers, two test keys, rehearsals, and access audit | BLOCKED |
| Bootstrap primitives lack full live proof | POSIX/Windows contracts exist; bounded SSH implementations do not | Hidden dependency or transfer corruption | Codex implementation owner | Purpose-named full-size SFTP/POSIX/Windows system-SSH live suites | Open |
Final Definition of Done
The project is not complete until every applicable item below is checked with evidence IDs.
- Milestone 0 legacy safety net is merged and live-proven.
- All Milestone 1 decisions are closed and reviewed.
- Artifact/manifest schema and full-runtime identity are implemented and hostile-input tested.
- Every enabled runtime tuple passes build, native, oldest-baseline, trust, and live SSH proofs.
- Relay artifacts are immutable prerequisites of every desktop build.
- Target-native builds, native signing jobs, and the fail-closed aggregate/manifest job pass all failure and recovered-draft rehearsals before desktop packaging.
- Every packaged desktop embeds the exact signed manifest whose bytes are published.
- Client download/cache/extraction passes online, offline, proxy, integrity, concurrency, and resource-failure gates.
- Every SSH transfer path is bounded, cancellable, no-tar-capable, mode-correct, and full-size tested.
- Remote installation uses full-tree verification and a structured, mode-qualified completion record.
- Declared POSIX/Windows bootstrap primitives, missing-command behavior, BusyBox variants, and no-remote-hash-tool behavior are live-proven.
- The primary path launches with bundled Node and performs no remote npm or HTTP operation.
- Fallback aborts and joins bundled work, uses separate state, and is race/failure tested.
- Every integrity/security failure fails closed in
autowithout automatic legacy. - The exact online/offline/cache matrix is live-proven.
- Every relay RPC family, reconnect, reattach, upgrade, downgrade, concurrent-client, and GC contract passes through the packaged runtime.
- Security review, SBOM, provenance, key lifecycle, native signing, CVE ownership, and emergency refresh through a new desktop build/embedded manifest are operational; old clients stay pinned.
- Numeric performance and resource budgets pass on the required matrix.
- Draft release read-back and public direct-URL behavior pass for exact stable/RC/perf tags.
- Three consecutive qualifying RCs pass without unexplained fallback or relay regression.
- Stable soak and rollback criteria pass.
- Every accepted gap is closed or explicitly retained with owner, fallback, and promotion rule.
- HTML plan, this checklist, reliability-gate metadata, troubleshooting docs, and PR evidence are current.
- Legacy fallback remains unless a separate reviewed decision authorizes narrowing/removal.
Next Required Action
Add a purpose-tested bounded diagnostic for the exact target conpty_console_list.ilk file under
the already bounded clean build/Release traversal, recording only presence and size. Rerun both
Windows architectures and all four POSIX controls. Only if target-native evidence proves implicit
incremental linking may a copied-artifact /INCREMENTAL:NO producer correction be considered;
retain /guard:cf, strict parsing/comparison, and rejected-output no-upload.
Cross-family Layer B targets, the protected manifest-signing environment,
oldest-baseline/native-trust cells, and the paired legacy performance baseline remain
release/default-path blockers; no publication, desktop resolver, SSH transfer/install, per-target
Beta, fallback, tuple enablement, or default behavior may be connected by this package.