Prompting
How the CLI gets a template's answers - the question loop between the CLI and one template container, interactive or headless.
What this context owns. The question loop between the CLI and one template container: questions, answers, the deterministic state a template makes, the HTTP contract both sides speak, how one loop ends (prompt outcome), and headless mode with its envelope, answer validation and secret redaction.
The CLI side lives in the cyanprompt crate of sulfone.iridium (plus cyanprint/src/headless.rs); the template side is the template service of each SDK in sulfone.helium.
What it does not own. Which answers each template in a dependency tree receives, presets and namespacing (composition); how a call reaches a container and the session it runs in (coordinator); where answers are saved and replayed from (project lifecycle, the state file); the SDK's author-facing API such as d.get (authoring).
Start here: client-side state and determinism, the design this context is the first example of, and the shop example, the one project every doc uses.
Docs, in reading order
| Doc | Type | One line |
|---|---|---|
| Question | format | six kinds, their fields and ids, and the terminal prompt each becomes |
| Answer | format | {type, value}, three spellings, which kind gives which, matched by id only |
| Stateless replay | algorithm | the loop: the script runs from the top on every call; 3 questions = 4 runs |
| Question protocol | surface | init and validate over HTTP through the coordinator proxy: routes, JSON, errors, timeouts |
| Deterministic state | feature | d.get values kept within one run, and the four places they are lost |
| Prompt outcome | format | QnA, Complete, NeedInput, Err as a state machine |
| Answer validation | algorithm | validators by replay; interactive vs headless sibling maps; the discovery walk |
| Headless mode | flow | answers file, two walks, envelope, exit codes 0/2/1, cleanup, stdout contract |
| Secret redaction | guard | kept off this public page (security-related) |
Words: UL.yaml.