Skip to content

refactor: clean runtime boundaries, tools and documentation - #6

Merged
HarcoChen merged 5 commits into
mainfrom
codex/function-entrypoints
Nov 11, 2026
Merged

HarcoChen merged 5 commits into
mainfrom
codex/function-entrypoints

Conversation

@HarcoChen

@HarcoChen HarcoChen commented Nov 11, 2026 •

Copy link
Copy Markdown
Contributor

Changes

  • Remove all 11 argparse entrypoints from the feature audit and benchmark tools.
  • Expose explicit keyword-argument functions through run(...), returning results directly.
  • Move Node comparison execution into its callable entrypoint so importing the module performs no benchmark or process startup.
  • Replace global argument state in the multiprocessing comparison with explicit worker parameters. CPU affinity accepts Python index sequences.
  • Convert command-line error exits into normal exceptions and update the benchmark guide to direct Python calls.

Documentation cleanup

  • Delete the AutoTavern comparison, native 0.3.3 migration diary, old hotspot notes and outdated Rust kernel description.
  • Publish a paired Rust versus Node throughput figure from the November 9 session benchmark, with workload scope and numerical labels. Keep the figure generator outside the repository.
  • Trim iterative A/B reports, local-only report links and repair logs from the benchmark guide, retaining current API usage, build instructions, replay and regression workflows.
  • Remove obsolete documentation links and layout commentary from both READMEs. Reduce each landing page to 96 lines and the usage guide to 68 lines, retaining installation, interface contracts and runnable examples.

Runtime boundaries

  • Move the production vector facade from benchmarks into arkguardrl_core.native_batch, and use shared model dimension and candidate-capacity constants.
  • Put Transition in the public contract module and define the legacy catalog revision alongside the catalog. Preserve existing legacy imports through re-exports.
  • Defer Node-specific Gym imports to the legacy factories, allowing native single, Gym and batch modules to import independently of the Node transport.
  • Consolidate explicit dynamic-library loading for both native extensions in the runtime module.
  • Delete the unreferenced temporary identity oracle and standalone field audit. Trim duplicate figure values and stale process notes from documentation.

Validation

  • All nine retained benchmark modules import with unrelated process arguments and a subprocess-startup trap active.
  • Mocked execution checks covered the retained callable tools, including returned summaries and report output, without launching games.
  • Invalid settings raise ValueError before runtime initialization. Documented Python call signatures and shell/Python syntax checks passed.
  • Static scan found no remaining argparse imports, parsers or parse_args calls in source or benchmark tools. Whitespace checks passed.
  • The moved vector classes match their previous AST after normalizing shared constants and the common loader. Mock checks covered output shape/ownership, partial step/reset, whole-batch error recovery and memory bounds.
  • Shared loading imported both existing compiled native extensions. Wheel build and installed-wheel imports passed, including the vector runtime and retained legacy imports.
  • Native imports avoid the Node transport modules. Remaining documentation links, section anchors and example syntax passed.
  • No games or training were run for this cleanup.

@HarcoChen HarcoChen changed the title refactor: remove argparse entrypoint wrappers refactor: clean entrypoints and obsolete documentation Nov 11, 2026
@HarcoChen
HarcoChen marked this pull request as ready for review November 11, 2026 11:07
@HarcoChen HarcoChen changed the title refactor: clean entrypoints and obsolete documentation refactor: clean runtime boundaries, tools and documentation Nov 11, 2026
@HarcoChen
HarcoChen added this pull request to the merge queue Nov 11, 2026
Merged via the queue into main with commit 7bafeb1 Nov 11, 2026
4 checks passed
@HarcoChen
HarcoChen deleted the codex/function-entrypoints branch November 11, 2026 11:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant