@alessandroraffa/tangyr 5.0.1 → 6.0.0

package/README.md

@@ -365,23 +365,27 @@ acceptedLoss:
 
 Not every error entry is structural. `rule-not-delivered` (below) reports a rule that did not reach a target on this run, which is usually fixable — by giving the target an instructions path of its own, or by not enabling it. Accept it when you have decided to live with it, not to quiet it.
 
-## Rules that did not arrive
+## What did not arrive
 
-A rule reaches a target either as a file in that target's own rules slot or as a section in the instructions document it reads. Several targets resolve their instructions to one project-root `AGENTS.md` and write it in turn, so a rule folded into that file survives only for whoever wrote last.
+A kit's artifacts reach a target through that target's own surfaces: a file in its agents directory, a prompt, a workflow, a skill folder, a section in the instructions document it reads. The surfaces differ per target, and some targets have none for a given category.
 
-After every target has written, the run measures what is actually on disk and says so — one line per target, the count first, and the rules that did **not** arrive named:
+After every target has written, the run measures what is actually on disk and says so — one line per target, the counts first, and whatever did **not** arrive named beneath:
 
 ```text
-Rules reaching each target (3 declared, measured on disk):
-  claude-code  3/3
-  copilot      3/3
-  codex        0/3  missing: style, testing, review
-               its rules are folded into AGENTS.md, which cline wrote last
-  opencode     3/3
-  cline        3/3
+What reached each target (measured on disk):
+  claude-code  agents 1/1  commands 1/1  rules 1/1  skills 1/1  hooks 1/1
+  copilot      agents 1/1  commands 1/1  rules 1/1  skills 1/1  hooks 1/1
+  codex        agents 1/1  commands 1/1  rules 0/1  skills 1/1  hooks 1/1
+               rules missing: git-safety
+                 folded into AGENTS.md, which cline wrote last
+  cline        agents 0/1  commands 1/1  rules 1/1  skills 1/1  hooks 0/1
+               agents missing: reviewer
+                 cline has no agents surface in this scope
 ```
 
-Nothing is printed when every rule arrived; `--verbose` shows the block either way. The same fact reaches `--loss-report <path>` as a `rule-not-delivered` entry per rule per target, at `error` severity, so a run that loses a rule exits `3` rather than reporting success.
+Measured on the files, not on what the compilers intended: the two have disagreed, and the files are what the target reads. Nothing is printed when everything arrived; `--verbose` shows the block either way.
+
+The same fact reaches `--loss-report <path>` as a `rule-not-delivered`, `agent-not-delivered`, `command-not-delivered`, `skill-not-delivered` or `hook-not-delivered` entry, one per artifact per target, at `error` severity — so a run that loses part of the kit exits `3` rather than reporting success. A category the target has no surface for at all is left to the structural entry that already says so (`persona-not-representable`, `hook-as-plugin`), rather than repeated once per artifact.
 
 ## Exit codes