Skip to main content

Module shell

Module shell 

Source
Expand description

Shell-safe primitives for protocol guidance rendering.

Single-quote escaping, identifier validation, and command builder helpers. The renderer layer composes these rather than duplicating quoting logic.

Enums§

ValidationError
Validation error for shell-rendered values.

Functions§

bn_comment_cmd
Build: maw exec default -- bn bone comment add <id> '<message>'
bn_do_cmd
Build: maw exec default -- bn do <id>
bn_done_cmd
Build: maw exec default -- bn done <id> --reason '<reason>'
bus_send_cmd
Build: bus send --agent <agent> <project> '<message>' -L <label>
bus_statuses_clear_cmd
Build: bus statuses clear --agent <agent>
claims_release_all_cmd
Build: bus claims release --agent <agent> --all
claims_release_cmd
Build: bus claims release --agent <agent> "<uri>"
claims_stake_cmd
Build: bus claims stake --agent <agent> "bone://<project>/<id>" -m "<memo>"
crit_create_cmd
Build: maw exec <ws> -- crit reviews create --agent <agent> --title '<title>' --reviewers <reviewers>
crit_request_cmd
Build: maw exec <ws> -- crit reviews request <id> --reviewers <reviewers> --agent <agent>
crit_show_cmd
Build: maw exec <ws> -- crit review <id>
shell_escape
Escape a string for safe inclusion in a single-quoted shell argument.
validate_bone_id
Validate a bone ID (e.g., bd-3cqv, bn-m80).
validate_identifier
Validate an identifier (agent name, project name). Must be non-empty and contain no shell metacharacters.
validate_review_id
Validate a review ID (e.g., cr-2rnh).
validate_workspace_name
Validate a workspace name.
ws_create_cmd
Build: maw ws create --random
ws_merge_cmd
Build: maw ws merge <ws> --destroy --message <msg>