Running a full assess -> plan -> apply -> verify against Infra/LXD and
Infra/Docker in throwaway worktrees, and a bootstrap into a scratch
directory, surfaced the same two mistakes repeated across both commands:
a shape was read where evidence was available, and a missing answer became
a silent default rather than a refusal.
adopt:
- classify secret-shaped paths by content, not by filename. A live
credential blocks; a file tracked against the repository's own ignore
rules and a name-only match are warnings; findings name keys, never
values. In Infra/Docker this turned 14 false blockers into 2 true ones
and surfaced 14 files committed despite `**/.env`.
- carry assess findings into the plan and refuse while an error-severity
finding is unresolved. An owner may accept one through
`acknowledgedFindings` with a reason; the acknowledgement enters the
plan and therefore planHash, so approval covers it.
- derive metadata.name from the git remote instead of the clone directory,
and refuse to plan without a confirmed owner (runbook section 9).
- propose content roots from the whole content vocabulary rather than the
winning type's markers, and recognise N sibling directories sharing a
marker file as one file-set root with a selector, as runbook 7.2 already
specified. Authority defaulted rather than derived now asks.
init: apply the guards adopt already had. Answers are validated against
the vocabularies that already existed in constants (name, type, lifecycle,
access) so init can no longer create a repository that fails its own
validate; owners are required; a directory that already holds the planned
paths is refused at plan time and pointed at adopt; and every path from a
plan is confined before the first byte is written -- init wrote outside
the repository from an edited plan.
validate: mask fenced blocks and inline code spans before scanning for
Markdown links. A PowerShell snippet in Infra/Docker's CLAUDE.md parsed as
a link and kept validate red for a reason unrelated to the repository.
paths: allow "." as a whole content-root path, never as a segment, so the
file-set root runbook 7.2 describes can be declared.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
The tables in sections 11.1 and 11.2 were right and the code was wrong, so most
of this is recording how a row is decided rather than changing the rule: format
comes from validating content against the KnowledgeBase schema, never from the
path a file happens to occupy.
Section 13 promised thirteen verify checks and ran none of the specific ones.
Rather than let the list keep implying coverage that does not exist, it now
separates what L1 checks from what waits on normalization and L3, and states
plainly that an unscoped report proves nothing.
- document the managed-block markers, insertion point and idempotence
- mark normalization and its recipes as not implemented, matching the CLI
- record that migrate does not exist, which is why post-adoption edits to a
contract currently fall outside plan/approve
- add the finding codes introduced with the safety and verify work, and explain
why a tracked secret and an ignored one are no longer the same code
- PLAN.md: Antivirus is a Wave 1 pilot the owner adopts deliberately; LXD stays
read-only. Normalization test row follows the feature into deferral
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>