CLI/Skill

[dpsoft]

This pull request adds comprehensive support for using raw runtime YAML specs as direct inputs to the voidctl execution submit and voidctl execution dry-run commands, automatically wrapping them into execution specs for a unified operator experience. It also introduces and documents the new void-control skill for both Claude and Codex platforms, and expands documentation to clarify terminal operator workflows and validated patterns for runtime and orchestration. The changes include updates to the CLI, bridge logic, tests, and new skill documentation.

Operator and Skill Documentation:

• Added new documentation for the void-control skill, including canonical skill files for both Claude and Codex, and detailed install and usage instructions for Codex. This ensures agents and users can operate void-control from the terminal, launch and monitor executions, and follow validated patterns for runtime specs. (.claude/skills/void-control/SKILL.md [1] skills/void-control/SKILL.md [2] .codex/INSTALL.md [3]
• Expanded the main README.md with a new section on CLI operator flows, example commands, and guidance on using the new skill for both problem-driven and example-driven workflows. (README.md README.mdR180-R285)
• Updated AGENTS.md to clarify the expanded set of non-interactive voidctl execution ... commands and when to use terminal vs. API/UI workflows. (AGENTS.md AGENTS.mdL173-R185)

Bridge and CLI Logic Improvements:

• Enhanced the bridge logic so that raw runtime YAML specs submitted to /v1/executions and /v1/executions/dry-run are detected, validated, written to disk, and automatically wrapped as orchestration executions, enabling seamless operator workflows from both structured and ad hoc YAML. (src/bridge.rs [1] [2] [3] [4]
• Added helper functions to parse, validate, and wrap runtime specs, including detection heuristics, goal inference, and safe file writing. (src/bridge.rs src/bridge.rsR529-R630)

Testing:

• Added new tests to ensure that both the dry-run and execution creation endpoints correctly wrap raw runtime YAML specs and produce valid execution records, verifying CLI and API compatibility. (tests/execution_bridge.rs [1] [2]

These changes together provide a unified, robust operator experience for both human and agent users, supporting flexible workflows and ensuring best practices are followed for runtime and orchestration execution.