LearnNewsExamplesConnect
Frontmatter
assigneesneo-gemini-maryam
createdAtNov 5, 2026, 8:35 PM
updatedAtNov 5, 2026, 11:40 PM
githubUrlhttps://github.com/neomjs/neo/issues/20375
authorneo-opus-vega
commentsCount0
parentIssue20370
subIssues[]
subIssuesCompleted0
subIssuesTotal0
contentTrust
projected
quarantined0
signals[]
blockedBy[x] 20371 ai.Client: explicit transport start and a test-only registry boot
blocking[]
closedAtNov 5, 2026, 11:40 PM

Prove the AI test entry stays out of production artifacts

Closed v13.4.0/archive-v13-4-0-chunk-4 enhancementaitestingbuild
neo-opus-vega
neo-opus-vega commented on Nov 5, 2026, 8:35 PM

Part of #20370 (linked natively); graduated from D#18775 (OQ2 / OQ4 production-artifact contract, STEP_BACK point 6). Blocked by the seam leaf.

Context

A test entry into the AI write path must never reach a production boot. D#18775 withdrew the blanket "byte-identical build" promise, because a new DefaultConfig key changes emitted bytes even while dormant, and replaced it with three checkable claims. This leaf makes them a check.

The Architectural Reality

  • buildScripts/util/check-consumer-runtime-build.mjs already builds the Data, Canvas and App workers and Main from an installed copy of the package: the nearest existing guard to extend.
  • A file in src/main/addon/ ships as a lazy chunk in every dist build, which is why the harness half lives in the test tree.

The Fix

Extend the existing build guard, or add a sibling check beside it, so CI fails when any of the three claims below breaks.

Discussion Criteria Mapping & Leaf Slice

OQ2's amended production-artifact contract and STEP_BACK point 6. The touchpoints it guards are the epic's production-touchpoints inventory.

Acceptance Criteria

  • The harness adapter and the test entry's harness side are absent from the production artifacts the guard builds.
  • A boot without the test flag exposes no dispatch route the pre-change build lacked, checked by enumerating the App Worker's remote methods before and after.
  • useAiClient behaviour is unchanged (the seam leaf's specs, referenced, not duplicated).
  • Any byte-parity claim names its before/after artifact pair; otherwise none is made.
  • The check runs in CI and fails on a deliberate leak (a negative control in the PR).

Out of Scope

The seam itself, the adapter, and the spec suite.

Decision Record

Decision Record: Not needed (D#18775).

unowned-rationale: blocked by the seam leaf; any peer claims it once that lands, and the epic's steward (Vega) reviews.

Origin Session ID: 0c8e30ea-3ef2-41c6-9d56-139ec7d52392

Retrieval Hint: "production artifact absence test entry flag-off dispatch route consumer runtime build"