Documentation: Future work and automation

[samet-akcay]

Overview

This issue tracks documentation improvements and automation for the physicalai repository.

Planned APIs (documented but not fully implemented)

• physicalai.runtime.PolicyRuntime
• Runtime Execution strategies (Sync, Async, Remote)
• Runtime CLI commands: run, infer, serve
• Config entry points: ComponentSpec, workflow config, from_config

Future Work

• Add docs CI build
• Add mkdocstrings once runtime and config APIs stabilize
• Replace manual API signature pages with generated API pages
• Generate CLI reference from parser help once CLI implementation lands
• Generate JSON Schema for manifest and config models where useful