Document PromptKit source migration

This commit is contained in:
2026-10-04 13:04:02 +00:00
parent 411a67b241
commit b913ef0d07
6 changed files with 384 additions and 166 deletions

View File

@@ -3,8 +3,8 @@
## Status, Baseline, And Authority
Planned on 2026-10-04 against Scriptorium
`82b0f231b6ba71328f65f9a501143b2eedbe5d9c`. Stages 1–10 are complete; stages
11–13 are pending.
`82b0f231b6ba71328f65f9a501143b2eedbe5d9c`. Stages 1–11 are complete; stages
12–13 are pending.
This plan is for a Luna coding agent: implement the stages in sequential order,
normally one stage per implementation prompt. The
[feature roadmap](promptkit.md) owns the target state, scope, and confirmed
@@ -615,7 +615,23 @@ redaction exception limited to it and application/framework scopes distinguishab
## Stage 11: Update User Contracts And Upgrade Guidance
Status: Pending. Depends on Stage 10.
Status: Complete. The configuration reference now owns the ordered
`promptkit_sources` sequence, empty/default behavior, source precedence and
paths, application imports/overlays, and the separation from Promptkit
definition and message-resource semantics; obsolete application backend and
directory settings were removed. The CLI reference documents repeated source
flags, removed flags, command-specific options, all four framework inspection
operations, their JSON source projection, JSON Pointer behavior, output and
exit behavior, and limited native redaction. Operations distinguish
application validation from eager framework construction and describe message
capture, restart, runtime schema/artifact/credential boundaries, and sensitive
report handling. A separate executable migration guide covers selector
replacement, backend relocation, keyed IDs/versions, `base_profile` to
`extends`, and zero/null/map review. README dependency/navigation links were
updated while the historical Go-package migration and licensing footer remain
intact. The README and composed render examples, both maintained render
scripts, application validate/explain examples, and framework validate/explain
examples ran offline; `git diff --check` passes.
Files: `docs/config.md`, `docs/cli.md`, `docs/operations.md`, `README.md`,
affected executable-consumer guidance and example scripts.