OpenSite/Reference/Commands/Command discovery: Difference between revisions
BathAfrica (talk | contribs) Reorganize OpenSite help: learning paths, examples and chapter navigation |
BathAfrica (talk | contribs) Link adjacent OpenSite reference pages in reading order |
||
| Line 30: | Line 30: | ||
[[Category:OpenSite documentation]] | [[Category:OpenSite documentation]] | ||
<div class="os-page-nav">{{Docnav|OpenSite/ | <div class="os-page-nav">{{Docnav|OpenSite/Reference/Commands|OpenSite/Reference/Commands/Document demo|OpenSite/Guides|All guides}}</div> | ||
Latest revision as of 14:14, 29 October 2026
List registered command ids, or show one descriptor.
- Stable identifier
cli.commands
Implementation milestone
Roadmap phase 4.
Units
None. The registry does not store a quantity.
Terminal example
Python access
opensite.commands() lists the same registry. There is no separate show function.
Output
The list prints provider.name version=N for every registered descriptor. show prints the id, version, title key, mutation policy, capability, documentation reference, and whether an executor is registered.
Errors
Exit 2 when the arguments are not supported. Exit 1 when show names a command that is not registered.
Limitations
This lists in-process registrations. It does not load a plugin. A metadata-only command would print executor=no. The development CLI installs an allow-all policy before it runs a mutating command. That policy is not an account or license check.
Verification evidence
Repository evidence references (not rerun for this publication): CTest cli.commands and application.commands. ADR-0023.
Try this workflow
Discover commands — a worked lesson with expected results.
Documentation basis
Source-reviewed against development commit 77c3fee13944bcc4b5d487c77eb1f82fbe4c6ea7, branch feature/phase-13c-properties-python-expressions. This review inspected the implementation and repository evidence; it did not run the Windows application or repeat CTest.
src/cli/main.cppsrc/cli/document_commands.cppsrc/cli/preference_commands.cppsrc/application/builtins.cpp