Agent Sandbox Registry

agent-sandbox

Review area: completeness - did the port / split omit or degrade anything?

无中文版

parity/review/completeness.md

Review area: completeness - did the port / split omit or degrade anything?

Reviewer: independent (did not write the port). Scope: whole project split (Python CLI -> Node port, original repo -> cli/ + python-sdk/{client-sdk,server-sdk}), proven by mechanical inventory. Detail reports:

Overall verdict

Nothing was omitted from the CLI port or lost in the split; the Node CLI is behaviourally complete against the oracle. All 66 commands / 315 parameters are identical, all 97 env reads, all exit codes, all CLI-reachable message literals, all 2980 original tests are accounted for (1351 in the Node ledger, 1647 unchanged in the SDK trees, 0 unaccounted; ledger 999/999 passing, no skips). 0 files of the original repo are missing without a CLI-moved-to-Node justification.

What is not clean is documentation/cross-project consistency: the python-sdk docs and SDK runtime hints describe abx features (abx provider *, --provider, config check/migrate, canonical ABX_* variables) that neither the oracle nor the Node CLI has, and that KNOWN-GAPS.md does not record as a gap. Plus 3 stale maintainer cross-references.

Counts: 0 BUG in the CLI behaviour; 2 GAP-UNJUSTIFIED (F-01, F-07); 5 doc/stale-reference BUGs (low); the rest ACCEPTED-OK.

Findings

F-01 - GAP-UNJUSTIFIED (medium): python-sdk docs/hints advertise abx provider, --provider, config check|migrate that the Node CLI does not have

F-07 - GAP-UNJUSTIFIED (medium): canonical client variables documented for "SDK and CLI" are ignored by the CLI

F-02 - BUG (docs, low): cli/AGENTS.md:193 says the evidence capture script stays in python-sdk

scripts/capture_cli_evidence.py ... stays in the python-sdk repository. It does not exist in python-sdk/scripts/; it was rewritten as cli/scripts/capture-cli-evidence.mjs. Test ADV-completeness-02. Fix: point to scripts/capture-cli-evidence.mjs.

F-03 - BUG (docs, low): cli/parity/KNOWN-GAPS.md:159 cites src/utils/async_bridge.ts, which does not exist

Module intentionally not ported (the same entry says it "exports nothing"); the file is not there. Test ADV-completeness-01. Fix: reword to "no async_bridge module".

F-04 - BUG (docs, low): cli/parity/blocked-tests.md:69 cites tests/test_cli_evidence/test_mcp_evidence.test.ts (does not exist)

Real file: tests/test_cli_evidence/test_evidence_snapshots.test.ts. Test ADV-completeness-01.

F-05 - BUG (docs, low): cli/docs/PORTING.md:131 requires findings in parity/review-log.md, which does not exist; PORTING.md:28 tells reviewers to set ABX_NO_KEYCHAIN=1, which neither implementation reads

Harmless (the keychain integration was removed upstream), but the instruction is misleading. Test ADV-completeness-01 (first part). Fix: create the log or point to parity/review/*.md; drop or footnote ABX_NO_KEYCHAIN.

The zh tree lacks 5 en-only pages added after the split baseline (agents-api.md, agents-api-review.md, provider-opensandbox-mapping.md, repository-layout.md, server-sdk-v2/). Fix: translate, or drop the link/mark en-only. Also cli/docs/{en,zh}/design/cli-design.md:11 (#3-natural-language-creation) and cli/docs/zh/design/architecture.md:129 (../reference/configuration.md#credential-resolution) have broken anchors (the two cli-design ones pre-exist in the original).

F-08 - ACCEPTED-OK: client pyproject drops [cli]/[binary] extras and the abx script; sdist no longer carries SKILL.md/CHANGELOG

User-approved (CLI moved to Node). migrating-from-0.2.md documents it; SKILL.md ships in the npm package (npm pack --dry-run); packaging tests rewritten.

F-09 - ACCEPTED-OK: 92 message literals "not found verbatim"

All classified in completeness-cli.md section 5 (regexes, strftime, Python-only install hints, deploy logs, the documented template_guide change, split literals).

F-10 - ACCEPTED-OK: 61 "missing" symbols

45 *_sync wrappers + async_bridge + typing artefacts + re-implemented helpers; all in KNOWN-GAPS or restructured in place.

Held up (attacked, no defect found)

How to reproduce

cd cli && npm run build
ORIG_REPO=<original python repo> ORACLE_VENV=<oracle venv> bash parity/review/inventory/run_all.sh
ORACLE_VENV=<oracle venv> node parity/diff/adv_completeness_click_tree.mjs
npx vitest run tests/adversarial/completeness      # 5 failures by design: 01 -> F-03/F-04/F-05, 02 -> F-02, 03+04 -> F-01, 05 -> F-07