Module bash_rewrite 

Bash command rewriter for hoisted bash.

Rewriting is an optimization of native bash, not a second command language. The dispatch layer makes a pre-execution decision and records it for differential tests. Once a request is accepted, its handler response is returned directly; native bash is never run as a recovery path.

Modules

catalog

Versioned metadata for the bash rewrite dispatch surface.

differential

Closed corpus schema and reusable validation for the bash rewrite campaign.

dispatch

footer

observation

Canonical observations used by the bash differential campaign.

parser

rules

Structs

DeclineReason

RewriteRequest

Enums

RewriteDecision

Traits

RewriteRule

A rewrite rule owns both the pre-execution shape decision and the typed request it emits. Implementations keep parsing in the decision phase so an accepted request has one stable request ID and one decision class.

Functions

try_rewrite

Try to rewrite a synthetic request. Production bash calls try_rewrite_for_request with the caller’s request ID; this compatibility wrapper is retained for direct library users and existing unit tests.

try_rewrite_for_request

Make the rewrite decision for one public bash request. A native route is recorded when the sandbox owns execution or when no rule accepts the command. The record is test-visible through dispatch::route_record and an opt-in JSONL sidecar, without changing the agent-facing response.