CANP-WP-0002 T06: revision v0.2, and section 23 rewritten

Closes the workplan. The format becomes `canned-prompt/v0.2`, and packages
declaring v0.1 remain valid — everything added across T01-T05 is additive, so
a v0.1 package means exactly what it always meant. That is the MINOR case
section 17 itself describes.

The spec file loses its version suffix: CannedPromptFormat-v0.1.md becomes
CannedPromptFormat.md, with the revision stated inside. One stable path that
never breaks a link, and no rename per revision; the version belongs in the
`format` string where tools actually read it.

Section 23 is rewritten into three parts rather than the planned two.
"Settled since v0.1" tables the five resolved questions against where each
rule now lives. "Still deferred" carries the eight unpromoted items plus
pattern-matching render checks. "Decided against" holds template inheritance
alone, because calling it deferred would misdescribe it — reopening it means
overturning a decision and answering four recorded objections, not filling a
gap.

Section 23 also names the two habits the five decisions turned out to share,
so later revisions follow them rather than rediscover them: separate the
deterministic half from the rest, and a package never asserts what it cannot
back.

The eval-rubric and registry-manifest schemas keep their own v0.1. They are
new in this revision and sit on their own version lines.

Reference CLI: ACCEPTED_FORMATS; an unknown revision is rejected naming what is
accepted. Tests 78 -> 81.

Example packages declare v0.2 and are bumped 0.1.0 -> 0.1.1 and 0.2.0 -> 0.2.1
as section 17 PATCH — metadata corrections with behavior unchanged.

Also refreshes section 22's worked example, which had drifted: it showed
pqrst-estimate at 0.1.0 with no composition, contradicting the package
actually in the repo. It now mirrors the real package and doubles as a
composition illustration.

CANP-WP-0002 is finished. CANP-WP-0003 carries forward the one residual: the
default registry's basename-derived name reads as `registry:`.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Bjefh8NUiEiahN4JLwoSKM

Assistant: claude-code
Assistant-Model: opus
Assistant-Process: 388925@bnt-lap001
Assistant-Session: 3507023f-e0fd-4a1e-9d90-a0d4217d1502
This commit is contained in:
tegwick 2026-09-06 14:22:45 +02:00
parent be675d33ad
commit 8376a00a88
10 changed files with 258 additions and 65 deletions

View file

@ -14,7 +14,7 @@ evidence, and is inspectable before use. See `INTENT.md`.
## In Scope
- `CannedPromptFormat-v0.1.md` — the package-format specification.
- `CannedPromptFormat.md` — the package-format specification (revision v0.2).
- `reference/` — a deliberately small Python CLI (`add`, `search`, `show`,
`render`, `install`, `publish`) over a filesystem catalog and registry.
- `examples/` — real packages that exercise the format and the implementation.
@ -36,12 +36,13 @@ Thin execution adapters are permitted; a general runtime is not.
## Current State
- **Seed / experimental.** Spec v0.1 is written; the reference CLI implements the
full local lifecycle and its 3 tests pass. One example package
(`examples/pqrst-estimate`) round-trips add → search → show → render → publish
→ install.
- The reference implementation is spec-conformant on the points it covers; the
known open design questions are tracked in `workplans/CANP-WP-0002-*.md`.
- **Experimental, revision v0.2.** The five open questions promoted from v0.1
are resolved and specified (`CANP-WP-0002`); what remains deferred is listed
in § 23. Packages declaring `canned-prompt/v0.1` remain valid.
- The reference CLI implements the full local lifecycle across eight verbs and
its 81 tests pass. Two example packages (`practice/pqrst-estimate` and the
`practice/house-style` fragment it composes) round-trip add → search → show →
resolve → render → eval → publish → install.
## Developer Workflow
@ -50,7 +51,7 @@ cd reference
python3 -m venv .venv && . .venv/bin/activate
pip install -r requirements-dev.txt
python3 -m pytest -q # tests
python3 -m pytest -q # 81 tests
CANNED_PROMPTS_HOME=/tmp/cp \
python3 canned_prompts.py add ../examples/pqrst-estimate # smoke
```
@ -61,6 +62,6 @@ There is no lint or build step yet; `pyproject.toml` declares the
## Getting Oriented
- Intent and principles: `INTENT.md`
- Format specification: `CannedPromptFormat-v0.1.md`
- Format specification: `CannedPromptFormat.md`
- Agent instructions: `AGENTS.md`
- Workplans: `workplans/`