2026-10-11 02:06:06 +00:00
|
|
|
# CommandKit ckprompt
|
|
|
|
|
|
2026-10-12 02:38:27 +00:00
|
|
|
`ckprompt` is the optional PromptKit integration for CommandKit. It adapts
|
2026-10-12 17:26:11 +00:00
|
|
|
PromptKit engine configuration, native comparison, prompt/profile catalogs,
|
|
|
|
|
named inspection, and prompt requirements discovery. Importing it does not
|
|
|
|
|
install either command family.
|
2026-10-11 02:06:06 +00:00
|
|
|
|
|
|
|
|
## Module
|
|
|
|
|
|
|
|
|
|
The module path is
|
|
|
|
|
`gitea.maximumdirect.net/eric/CommandKit/integrations/ckprompt`. Its first
|
|
|
|
|
release is prepared as `v0.1.0`. It uses `commandkit`, `ckconfig`, and
|
|
|
|
|
PromptKit. See the
|
|
|
|
|
[consumer guide](https://gitea.maximumdirect.net/eric/CommandKit/src/branch/main/docs/consumers/guide.md#promptkit-configuration-and-definitions)
|
|
|
|
|
for callback, input, state, and acquisition contracts.
|
|
|
|
|
|
|
|
|
|
## Example
|
|
|
|
|
|
|
|
|
|
Add `ckprompt.ConfigScope(loadEngine)` to the scopes passed to
|
2026-10-12 02:38:27 +00:00
|
|
|
`ckconfig.Command` when the application wants PromptKit engine configuration
|
|
|
|
|
and native comparison in the `config` family. Install
|
|
|
|
|
`ckprompt.Command(ckprompt.FromEngine(loadEngine))` separately for prompt/profile
|
2026-10-12 17:26:11 +00:00
|
|
|
catalogs, named inspections, and requirements discovery. `FromEngine` supplies
|
|
|
|
|
all five PromptKit-backed callbacks; applications may narrow, wrap, or replace
|
|
|
|
|
them before capture or provide custom callbacks with `ckprompt.Suite`.
|
|
|
|
|
Requirements is independently optional. CommandKit-owned inspection and
|
|
|
|
|
listing code does not execute prompts or contact model providers; application
|
|
|
|
|
loaders and direct callbacks retain their own effects. See the
|
|
|
|
|
[CLI reference](https://gitea.maximumdirect.net/eric/CommandKit/src/branch/main/docs/cli.md#promptkit-requirements)
|
2026-10-12 02:38:27 +00:00
|
|
|
for operator commands and report semantics. The maintained
|
2026-10-11 02:06:06 +00:00
|
|
|
[composed example](examples/composed) shows complete application wiring.
|
|
|
|
|
|
|
|
|
|
## License and attribution
|
|
|
|
|
|
|
|
|
|
This module is licensed under the [GNU Lesser General Public License v3.0 or
|
|
|
|
|
later](COPYRIGHT). The accompanying [LICENSE](LICENSE) contains the full LGPL
|
|
|
|
|
v3 and GPL v3 texts. See [third-party attribution](docs/oss/attribution.md)
|
|
|
|
|
for incorporated and dependency notices.
|
