@erclx/canon 5.45.0 → 5.47.0

package/claude/skills/write-human/REQUIREMENT.md

@@ -7,42 +7,30 @@ description: Scope boundary between the writing rules a scan enforces and the on
 
 ## Gap
 
-Without this skill, a session is graded on the words it avoids and never on how the prose reads. The banned characters ship as data the CLI and the installed hook both read, so that half is measured on every run. The voice half sat under a heading in a standard nothing opened, so a session wrote the whole passage without it and the audit reported a clean exit over prose that read machine-written.
+Without this skill, a session is graded on the words it avoids and never on how the prose reads. The banned characters ship as data a command reads. The voice half sits in a standard nothing opens, so a clean audit passes prose that reads machine-written.
 
-The output of that arrangement is specific rather than general. Paragraphs come back with every sentence landing within a few words of the last, with consecutive sentences opening on the same word and the same grammatical shape, and with the compression rule applied until the verb is gone, so the passage trades uniform sentences for uniform fragments. A session told to be terse and told nothing about cadence produces exactly that, since cutting is the only instruction it holds.
-
-A session also has no name for the patterns no closed word set can match. Rule-of-three, synonym cycling, false ranges, inline-header lists, and adverb propping each survive a clean scan, so a passage carrying all five reports zero findings and still reads wrong. Nothing tells the session those patterns exist, and a ban list cannot be extended to reach them, because each is a shape rather than a token.
-
-Importing that catalog wholesale fails on a different measurement. External material of this kind bans abstract metaphor nouns and names `surface` among them, which this corpus uses 593 times in tracked markdown. A session handed the catalog with no stated position either rewrites established vocabulary or silently ignores the item, and neither outcome is recoverable by a later reader who cannot tell which happened.
+Terse sessions return uniform fragments, each sentence near the same length and opening alike. Rule-of-three and synonym cycling survive any scan because each is a shape, not a token. External catalogs also ban terms this corpus uses heavily, and a session without a stated position rewrites them or ignores the item.
 
 ## Must
 
-- Arrive attached to the writing rather than waiting to be consulted, which is why the path-scoped rule on a markdown edit carries an explicit instruction to load this skill
-- State cadence as something to measure, giving the sentence-length spread and the repeated-opening count a session can check, since a rule to vary sentence length is one a session satisfies by assertion
-- Ban the fragment trade by name, since compression is the instruction a terse register already carries and the verb is what it drops first
-- Name the machine tells a scan cannot reach, and hold the catalog behind a stated trigger so a run that needs none pays no read for it
-- Carry the marketing words and vague qualifiers as word-choice guidance, since no command reads them and a word ban catches the token and misses the habit behind it
-- Point at the banned characters rather than restating them, since they ship as package data a command reads and a second copy drifts with nothing comparing the two
-- Record which external patterns were adopted, which were declined, and the measurement behind each, so a later session extends the position instead of re-deriving it
-- Yield voice to a surface that states its own, and hold rhythm, density, and the tells on every surface
+- Arrive attached to the writing through the path-scoped markdown rule, rather than waiting to be consulted
+- State cadence as something to measure, with a sentence-length spread and a repeated-opening count, and ban the fragment trade by name
+- Name the machine tells a scan cannot reach behind a stated trigger, and carry marketing words and vague qualifiers as word-choice guidance
+- Point at the banned characters rather than restating them, since they ship as package data and a second copy drifts
+- Record which external patterns were adopted or declined with the measurement behind each, and yield voice to a surface that states its own
 
 ## Must not
 
 - Restate the banned characters, at any length or as an example set
-- Present the word guidance as a gate, or restate it on a second surface, since this body is its one copy
-- Claim the reported failure is closed. Cadence is a property of a passage and nothing measures the output against these rules yet, so this skill states the rule and the measurement is owed separately.
+- Present the word guidance as a gate, or restate it on a second surface
+- Claim the cadence failure is closed, since nothing measures finished output against these rules yet
 - Rewrite a term the corpus already uses because an external source bans it, without the count and a recorded position
-- Grow a second voice register inside this body. One baseline covers every surface, and a register a real surface needs arrives as an overlay that yields on voice alone.
-
-## Guards
-
-- A passage on a surface stating its own voice keeps that voice, so the yield is read before the voice rules are applied rather than after the rewrite
-- Text a model drafted goes through the tells catalog, and a short original draft with nothing reading off skips it
+- Grow a second voice register inside this body
 
 ## Out of scope
 
-- The banned characters, which `markdown.md` states for a reader and `canon markdown audit` gates from package data
-- Spelling, which a project's spell checker enforces
-- Markdown mechanics, being headings, lists, code spans, punctuation, and file references
-- What voice a given surface declares, which belongs to the standard governing that surface
-- Measuring whether finished output followed these rules, which needs a check this skill does not carry
+- The banned characters, which `markdown-craft` points at and `canon markdown audit` gates
+- Markdown mechanics, being headings, lists, code spans, punctuation, and file references, which `markdown-craft` owns
+- What voice a given surface declares, which the standard governing that surface owns
+- Spelling, which a project's spell checker owns
+- Measuring whether finished output followed these rules, which no check owns yet

package/claude/skills/youtube-transcripts/REQUIREMENT.md

@@ -7,32 +7,26 @@ description: Why the transcript fetch stays in the CLI, and why fetching stops s
 
 ## Gap
 
-Without this skill, a pasted video link turns into captions printed in chat, which persist nowhere and cannot be cited by a later session. The file is the point. A transcript saved with its metadata is context the repository holds, and a transcript in a message is context that ends with the turn.
+Without this skill, a pasted video link becomes captions printed in chat, which persist nowhere and cannot be cited later. A saved transcript with its metadata is context the repository holds.
 
-A session that fetches on its own gets the shape wrong. Raw captions carry timing cues and duplicated lines, and a file written without frontmatter has no title, no source URL, and no way to tell which video it came from. Reimplementing the cleanup also duplicates logic the CLI already owns, so the two drift and the drift shows up as inconsistent files rather than as an error.
-
-Two smaller failures follow the fetch. A video with no captions produces a file that looks empty rather than one reported as having none, so the user reads it as a failed fetch. And a session that summarizes what it fetched answers a question nobody asked, spending context on a reading the user may not want yet.
+A session fetching on its own gets the shape wrong. Raw captions carry timing cues and duplicates, a file without frontmatter loses its source, and reimplemented cleanup drifts from the CLI. A video with no captions looks like a failed fetch, and a summary answers a question nobody asked.
 
 ## Must
 
 - Run the CLI, which owns the fetch, the caption cleanup, and the frontmatter
-- Surface the written path as a full relative path, in the form the project's instruction file sets under `## Output`
+- Surface the written path in full, in the form the project's instruction file sets under `## Output`
 - Report a video with no captions as a fact about the video, since the file still exists and carries its metadata
-- Name the missing external binary and stop, leaving the install to the user
+- Name a missing external binary and stop, leaving the install to the user
+- Stop on a missing URL or a link that is not a YouTube URL, since the command cannot fetch either
 
 ## Must not
 
 - Reimplement the fetch or the cleanup
-- Summarize or annotate the transcript unasked, which is a separate request against the file
+- Summarize or annotate the transcript unasked
 - Install the external binary the command shells out to
 
-## Guards
-
-- No URL stops, since there is nothing to fetch
-- A link that is not a YouTube URL stops rather than attempting a generic fetch the command cannot do
-
 ## Out of scope
 
-- Downloading the video or its audio
-- Summarizing a transcript already on disk, which is a read of that file
-- Choosing where transcripts live, which the command defaults and a flag overrides
+- Downloading the video or its audio, which no skill here owns
+- Summarizing a transcript already on disk, which is a plain read of that file
+- Choosing where transcripts live, which the command's default and its flag own

package/docs/agents/context-audit.md

@@ -22,18 +22,25 @@ canon context audit tooling/base/seeds --gate
 
 ## Output
 
-| Check               | Reports                                                                                                                                          | Reaches                 | Finding                                                     |
-| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------- | ----------------------------------------------------------- |
-| Citations           | A path into an audited folder that resolves nowhere                                                                                              | Every audited folder    | Gates always                                                |
-| Requirements record | Words past the cap the record states as `This record holds at most 600 words.`                                                                   | `canon/REQUIREMENTS.md` | Gates past a stated cap, never under `--citations-only`     |
-| Required sections   | An entry missing `Overview` or `Layout`. A split folder answers by any sibling                                                                   | `canon/context/`        | Gates under `--gate`                                        |
-| Closed set          | An H2 outside `Overview`, `Layout`, and `Gotchas`, under `extraSections`                                                                         | `canon/context/`        | Gates under `--gate`                                        |
-| Shape               | `retired-section`, `gotcha-count`, `gotcha-heading`, `gotcha-paragraph`, `layout-heading`, `layout-bullets`, `layout-paragraphs`, `layout-depth` | `canon/context/`        | Gates under `--gate` in a `SHAPE_GATED_FOLDERS` folder only |
-| Index drift         | An entry its index does not link, or a link resolving to nothing                                                                                 | Every audited folder    | Gates under `--gate`                                        |
-| Reference form      | A backticked bare filename matching a sibling entry, under `bareReferences`                                                                      | Split folders           | Reports                                                     |
-| Length              | An entry past about 150 rendered lines at 80 columns, with its `causes`                                                                          | Every audited folder    | Reports                                                     |
-| Tables              | Six or more body rows whose first column mostly carries a path, command, or link                                                                 | Every audited folder    | Reports                                                     |
-| Provenance          | A date, change number, or release label. A date after measured, verified, driven, passed, or fired is excluded                                   | `canon/context/`        | Reports                                                     |
+| Check               | Reports                                                                                                                                               | Reaches                 | Finding                                                     |
+| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | ----------------------------------------------------------- |
+| Citations           | A path into an audited folder that resolves nowhere                                                                                                   | Every audited folder    | Gates always                                                |
+| Requirements record | Words past the cap the record states as `This record holds at most 600 words.`                                                                        | `canon/REQUIREMENTS.md` | Gates past a stated cap, never under `--citations-only`     |
+| Required sections   | An entry missing `Overview` or `Layout`. A split folder answers by any sibling                                                                        | `canon/context/`        | Gates under `--gate`                                        |
+| Closed set          | An H2 outside `Overview`, `Layout`, and `Gotchas`, under `extraSections`                                                                              | `canon/context/`        | Gates under `--gate`                                        |
+| Shape               | `retired-section`, `gotcha-count`, `gotcha-heading`, `gotcha-paragraph`, `layout-heading`, `layout-bullets`, `layout-paragraphs`, `layout-depth`      | `canon/context/`        | Gates under `--gate` in a `SHAPE_GATED_FOLDERS` folder only |
+| Index drift         | An entry its index does not link, or a link resolving to nothing                                                                                      | Every audited folder    | Gates under `--gate`                                        |
+| Coverage            | A folder directly under a code root that no Layout names, one with a Layout H3 in two entries, and a declared root matching nothing, under `coverage` | `canon/context/`        | Gates under `--gate`, never under `--citations-only`        |
+| Reference form      | A backticked bare filename matching a sibling entry, under `bareReferences`                                                                           | Split folders           | Reports                                                     |
+| Length              | An entry past about 150 rendered lines at 80 columns, with its `causes`                                                                               | Every audited folder    | Reports                                                     |
+| Tables              | Six or more body rows whose first column mostly carries a path, command, or link                                                                      | Every audited folder    | Reports                                                     |
+| Provenance          | A date, change number, or release label. A date after measured, verified, driven, passed, or fired is excluded                                        | `canon/context/`        | Reports                                                     |
+
+The coverage roots come from `roots` in `canon/config/context.toml`, a list of folders or globs such as `packages/*/src`.
+
+- Without the file the root defaults to `src` when that folder exists, and `roots = []` opts out
+- A file that is not valid TOML, or holds no list of strings under `roots`, gates under `--gate`
+- With no declaration and no `src/`, the audit reports no code root and never gates
 
 A shape break is any of these:
 

package/docs/agents/markdown-audit.md

@@ -22,14 +22,14 @@ An argument is a file, a directory, or a glob, taken against the corpus git list
 
 The ban set and checkpoints ship in `src/markdown/bans.ts` and `src/markdown/structure.ts`. `markdown.md` states each rule and the `write-human` skill states the cadence numbers, so move a number in both places in one change.
 
-| Finding         | Reports                                                                              | Gates                     |
-| --------------- | ------------------------------------------------------------------------------------ | ------------------------- |
-| Bans            | The two characters `markdown.md` bans, outside frontmatter, fences, spans, and links | Always                    |
-| Links           | A relative link resolving to nothing on disk                                         | Always                    |
-| Density         | The six limits below, under `density`                                                | On a `GATED_PATHS` prefix |
-| Reference shape | A `kind: reference` page breaking its shape, under `referenceShape`                  | On a `GATED_PATHS` prefix |
-| Colons          | A colon followed by more text in a prose line, under `colons`                        | Never                     |
-| Heading case    | A capital after the first word of a heading or `title`, under `headingCase`          | Never                     |
+| Finding         | Reports                                                                              | Gates             |
+| --------------- | ------------------------------------------------------------------------------------ | ----------------- |
+| Bans            | The two characters `markdown.md` bans, outside frontmatter, fences, spans, and links | Always            |
+| Links           | A relative link resolving to nothing on disk                                         | Always            |
+| Density         | The six limits below, under `density`                                                | On a gated prefix |
+| Reference shape | A `kind: reference` page breaking its shape, under `referenceShape`                  | On a gated prefix |
+| Colons          | A colon followed by more text in a prose line, under `colons`                        | Never             |
+| Heading case    | A capital after the first word of a heading or `title`, under `headingCase`          | Never             |
 
 A page marked `kind: reference` holds its opening, then `Output`, `Refusals`, and `See also` as H2s, each at most once and in that order. It takes no H3 and no table headed `Flag` or `Option`. An unmarked page is never measured.
 
@@ -46,9 +46,14 @@ A page marked `kind: reference` holds its opening, then `Output`, `Refusals`, an
 - A table, fence, list, heading, or bold section marker ends a run of paragraphs
 - A run whose every item opens with a bold label or a link is exempt, and numbered items never count
 - Only context entries, docs, skill bodies, references, and requirements, tooling seeds and stack references, the wiki, `README.md`, and `CONTRIBUTING.md` take a finding
-- A bullet run gates on those paths, and the rest gates under `GATED_PATHS` in `src/markdown/scope.ts`. Outside a canon checkout nothing gates.
+- A requirement gates only once the gated list below names its own file, never through its skill's prefix and never on a bullet run alone
 
-A requirement is the one exception to both. It gates only once `GATED_PATHS` names its own file, never through its skill's prefix and never on a bullet run alone.
+| Root              | A density or reference shape finding gates                                                                 |
+| ----------------- | ---------------------------------------------------------------------------------------------------------- |
+| Canon's checkout  | Under a `GATED_PATHS` prefix in `src/markdown/scope.ts`, and a bullet run on every density path above      |
+| Any other project | Under a prefix `canon/config/markdown.toml` lists, a bullet run included. With no such file nothing gates. |
+
+A project's list grows through `canon markdown gated add <prefix>`, which appends a folder only once it carries no finding, and `canon init` starts a new project with every root that passes already listed. A config that does not parse refuses the audit with its path named.
 
 Five measures report and never set the exit code on their own.
 

package/docs/target/projects.md

@@ -72,6 +72,8 @@ The default is `base`. Escalate only for a project writing code, and `target-set
 
 `canon init` installs base tooling, the Claude workflow, and governance. Pass `--stack <name>` for a language stack.
 
+Init then lists each markdown root that already passes the density limits in `canon/config/markdown.toml`, so those folders fail a push from the start. A root carrying a finding is named and left out, and `canon:document-repair` brings it to zero later. An existing config is kept as it is.
+
 - `--skip governance` leaves `.claude/rules/` empty. The run prints the `canon gov install <stack> <path>` command that restores the rules it dropped.
 
 ## Add a domain later

package/docs/workflow/skill-map.md

@@ -99,8 +99,9 @@ Groups run in the order a project meets them. Every name `canon claude skills li
 
 ## Keep the project current with the toolkit
 
-| Skill                         | When to use                                          |
-| ----------------------------- | ---------------------------------------------------- |
-| `canon:target-check`          | In a target, to compare each domain with the toolkit |
-| `canon:canon-feedback`        | The toolkit is broken, missing, or off               |
-| `canon:canon-feedback-triage` | In the toolkit repo, to file feedback issues         |
+| Skill                         | When to use                                             |
+| ----------------------------- | ------------------------------------------------------- |
+| `canon:target-check`          | In a target, to compare each domain with the toolkit    |
+| `canon:document-repair`       | Rewrite a failing docs folder to the limits and gate it |
+| `canon:canon-feedback`        | The toolkit is broken, missing, or off                  |
+| `canon:canon-feedback-triage` | In the toolkit repo, to file feedback issues            |

package/docs/workflow/zshrc-aliases.md

@@ -17,6 +17,7 @@ A hand-written block without markers is detected through its `alias clp=` line,
 ```zsh
 # >>> canon aliases >>>
 TOOLKIT="/path/to/toolkit"
+export CLAUDE_CODE_ENABLE_TODO_TOOLS=1
 
 alias cl='claude'
 alias clr='cl -r'
@@ -32,6 +33,8 @@ alias clpac='clpa --cwd .'
 # <<< canon aliases <<<
 ```
 
+The export gives a session started from your terminal the task tools, which Claude Code reads before it starts, so workers and reviewers can show their checklist on `Ctrl+T`. A background session has them without it.
+
 To opt out, delete the block and run `bun install` and `bun link` yourself. Bash takes the block unchanged in `~/.bashrc`, pasted by hand. Bootstrap writes `~/.zshrc` alone.
 
 ## What each one does

package/governance/renames.toml

@@ -15,7 +15,6 @@
 # file.
 [renamed]
 "015-output" = "566-output"
-"035-tasks" = "602-tasks"
 "055-scratch" = "604-scratch"
 "085-worktrees" = "605-worktrees"
 "087-git" = "606-git"
@@ -32,7 +31,6 @@
 "655-tasks" = "tasks"
 "570-skill" = "skill"
 "801-markdown" = "markdown"
-"602-tasks" = "task-scope"
 "604-scratch" = "scratch"
 "605-worktrees" = "worktrees"
 "606-git" = "git"

package/governance/rules/claude/output.md

@@ -1,5 +1,5 @@
 ---
-description: Report file paths correctly for the reading surface and group them when the response covers many
+description: Report file paths correctly for the reading surface, group them when the response covers many, and name sessions to a person
 ---
 
 # Output standards
@@ -17,3 +17,7 @@ description: Report file paths correctly for the reading surface and group them
 
 - Group paths under `**Created:**`, `**Modified:**`, and `**Deleted:**` headers when the response covers multiple files, with every path under them in that form.
 - Put a single-file change's path on its own line, with no header.
+
+## Naming sessions
+
+- Name a session to a person by its roster name from `canon sessions list`, and give its id only beside the name, never alone.

package/governance/rules/code/routing.md

@@ -1,5 +1,5 @@
 ---
-description: Routes code placement and shape decisions to the skills that carry them
+description: Routes code placement and shape decisions to the skills that carry them, and library calls to the official docs
 ---
 
 # Code standards
@@ -11,3 +11,7 @@ description: Routes code placement and shape decisions to the skills that carry
 ## Shape
 
 - Load the `canon:code-craft` skill before deciding the shape of a new function, class, or module, and report it rather than proceeding silently when it does not resolve.
+
+## Libraries
+
+- Before calling a library API the codebase does not already use, fetch the official docs for the installed version and match the call to them, since recall of an API goes stale.

package/governance/stacks/base.toml

@@ -4,7 +4,6 @@ extends = ""
 # `canon gov detect`. Every other rule is opt-in.
 rules = [
   "output",
-  "task-scope",
   "scratch",
   "worktrees",
   "git",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@erclx/canon",
   "type": "module",
-  "version": "5.45.0",
+  "version": "5.47.0",
   "description": "Runs your agent's work and keeps its code good, on one setup for every repo.",
   "license": "MIT",
   "bin": {

package/scripts/core/bootstrap.sh

@@ -26,6 +26,7 @@ alias_block() {
   cat <<EOF
 $MARKER_OPEN
 TOOLKIT="$PROJECT_ROOT"
+export CLAUDE_CODE_ENABLE_TODO_TOOLS=1
 
 alias cl='claude'
 alias clr='cl -r'

package/src/claude/cases/workflow.ts

@@ -146,6 +146,18 @@ export const WORKFLOW_CASES: readonly SkillCase[] = [
       'Are our requirements and architecture docs still true, and when were they last reviewed?',
     expect: 'document-health',
   },
+  // A repair rather than a report, and folder by folder until each gates,
+  // which is what separates it from `document-health` above.
+  {
+    prompt:
+      'Our docs folder fails the paragraph and bullet limits everywhere, so rewrite it until it passes and lock it in.',
+    expect: 'document-repair',
+  },
+  {
+    prompt:
+      'Bring the context entries under the density limits one folder at a time and gate each once it is clean.',
+    expect: 'document-repair',
+  },
   {
     prompt: 'Open a new entry on the task board for this piece of work.',
     expect: 'task-board',

package/src/commands/context.ts

@@ -56,6 +56,11 @@ import {
   presentNames,
   resolveFolders,
 } from '@/context/folders'
+import {
+  type CoverageReport,
+  measureCoverage,
+  readRoots,
+} from '@/context/coverage'
 import { isGating } from '@/context/gate'
 import { isShapeGated, SHAPE_GATED_FOLDERS } from '@/context/shape-gated'
 import { currentWorktreeRoot } from '@/git/worktree'
@@ -101,7 +106,7 @@ export function register(program: Command): void {
   context
     .command('audit')
     .description(
-      'Report required sections, entry length, citations, reference form, catalog tables, provenance, index drift, and the requirements record against its own word cap',
+      'Report required sections, entry length, citations, reference form, catalog tables, provenance, index drift, code folders no entry names, and the requirements record against its own word cap',
     )
     .argument('[path]', 'Project root, defaulting to the current directory')
     .helpOption('-h, --help', 'Show this help message')
@@ -113,7 +118,7 @@ export function register(program: Command): void {
     .option('--citations-only', 'Run the gating citation check alone')
     .option(
       '--gate',
-      'Also fail on a missing required section, an H2 outside the set, a shape break in a gated folder, or index drift, the findings that are facts',
+      'Also fail on a missing required section, an H2 outside the set, a shape break in a gated folder, index drift, or a code folder no entry names, the findings that are facts',
     )
     .addHelpText(
       'after',
@@ -129,7 +134,9 @@ export function register(program: Command): void {
         '--citations-only, which never measures it. A record stating no',
         'cap is reported and never gated. --gate widens the gate to the',
         'findings that are facts rather than judgments: a missing',
-        'required section, an H2 outside the closed set, and index drift.',
+        'required section, an H2 outside the closed set, index drift, and',
+        'a code folder no Layout names or two entries claim. The roots come',
+        'from canon/config/context.toml and default to src when present.',
         'A context entry requires Overview and Layout and allows Gotchas.',
         'A shape break, such as a Decisions section or a sixth gotcha, is',
         'reported everywhere and gated only under a shape-gated folder.',
@@ -667,6 +674,9 @@ async function runAudit(
         isShapeGated(relative(top, join(root, rel))),
       )
   const length = gateOnly ? undefined : lengthFindings(entries)
+  const coverage: CoverageReport | undefined = gateOnly
+    ? undefined
+    : measureCoverage(root, readRoots(root), folders)
   // Absent under `--citations-only` and null when the project carries no
   // record. A run that never looked and a project with nothing to look at are
   // different answers, and one value for both reports the second as the first.
@@ -685,6 +695,7 @@ async function runAudit(
     reportTables(entries)
     reportProvenance(entries, folders)
     reportDrift(drift)
+    reportCoverage(coverage ?? { kind: 'no-root' })
     reportRequirements(requirements, root)
     outro()
   }
@@ -721,6 +732,8 @@ async function runAudit(
         extraSections: extras,
         shapeFindings: shape,
         indexDrift: drift,
+        // Absent under `--citations-only`, which never measures it.
+        coverage,
         // Null says the run opened the project and found no record, which a
         // target that never wrote one is entitled to. Absent says the run
         // never looked, which is `--citations-only`.
@@ -753,6 +766,7 @@ async function runAudit(
     extraSections: extras,
     shape,
     drift,
+    coverage: coverage ?? { kind: 'no-root' },
     widened,
   })
 
@@ -1210,6 +1224,46 @@ function reportProvenance(
   )
 }
 
+function reportCoverage(report: CoverageReport): void {
+  logStep('Coverage')
+
+  if (report.kind === 'no-root') {
+    logInfo(
+      'No code root found, since no canon/config/context.toml declares one and there is no src/, so nothing was measured.',
+    )
+    return
+  }
+
+  if (report.kind === 'invalid') {
+    logWarn(report.reason)
+    return
+  }
+
+  if (report.kind === 'opted-out') {
+    logInfo(
+      'canon/config/context.toml declares roots = [], so coverage was not measured.',
+    )
+    return
+  }
+
+  const { unnamed, doubled, missingRoots } = report.findings
+  const lines = [
+    ...missingRoots.map((root) => `${root}  matches no folder`),
+    ...unnamed.map((folder) => `${folder}  named in no Layout`),
+    ...doubled.map(
+      ({ folder, rels }) => `${folder}  Layout H3 in ${rels.join(', ')}`,
+    ),
+  ]
+
+  if (lines.length === 0) {
+    logInfo(`Every folder under ${report.roots.join(', ')} is named once.`)
+    return
+  }
+
+  logWarn(plural(lines.length, 'coverage finding'))
+  pipeOutput(lines.join('\n'))
+}
+
 /** Reports the requirements record against the word cap it states, if any. */
 function reportRequirements(
   report: RequirementsReport | undefined,