@erclx/canon 4.6.1 → 4.7.0

package/scripts/tooling/verify.sh

@@ -16,7 +16,7 @@ show_help() {
   echo -e "${GREY}│${NC}    --keep       ${GREY}# Keep tmp dir after run for inspection${NC}"
   echo -e "${GREY}│${NC}    -h, --help   ${GREY}# Show this help message${NC}"
   echo -e "${GREY}│${NC}"
-  echo -e "${GREY}│${NC}  Scaffolds <stack> into .claude/.tmp/verify-<stack>/, syncs the full"
+  echo -e "${GREY}│${NC}  Scaffolds <stack> into .canon/tmp/verify-<stack>/, syncs the full"
   echo -e "${GREY}│${NC}  layer chain, and runs check + test:e2e + screenshot."
   echo -e "${GREY}└${NC}"
   exit 0
@@ -100,7 +100,7 @@ main() {
   open_timeline "canon tooling verify $stack"
   trap close_timeline EXIT
 
-  local tmp_root="$PROJECT_ROOT/.claude/.tmp"
+  local tmp_root="$PROJECT_ROOT/.canon/tmp"
   local tmp_dir="$tmp_root/verify-$stack"
 
   mkdir -p "$tmp_root"

package/snippets/claude/decision-memo.md

@@ -1,4 +1,4 @@
-Produce a decision memo for a research or should-we question. This is the decision-heavy counterpart to `claude-feature`, which plans a build. Write one file per independent concern under `.claude/plans/feature-<slug>.md`, or answer inline when the plan is small. Use the same plans folder as `claude-feature`.
+Produce a decision memo for a research or should-we question. This is the decision-heavy counterpart to `claude-feature`, which plans a build. Write one file per independent concern under `.canon/plans/feature-<slug>.md`, or answer inline when the plan is small. Use the same plans folder as `claude-feature`.
 
 Read the current state from the code and docs before recommending. Do not assume it.
 

package/snippets/claude/feature-recap.md

@@ -1,4 +1,4 @@
-Recap the implementation this session completed. Read the plan file referenced in the session (usually `.claude/plans/feature-<slug>.md`) and produce a verification block.
+Recap the implementation this session completed. Read the plan file referenced in the session (usually `.canon/plans/feature-<slug>.md`) and produce a verification block.
 
 Output this shape, nothing else:
 

package/src/audits/catalog.ts

@@ -488,7 +488,7 @@ export const AUDITS: readonly AuditSpec[] = [
     corpus: 'tracked',
     // The one reason this verb refuses for that is an absence rather than a
     // break, on the same test the reach check and the skill audit take: no
-    // target adopts `.claude/context/`, `.claude/diagrams/`, and
+    // target adopts `.claude/context/`, `.canon/diagrams/`, and
     // `.claude/wireframes/` all at once, so without the allowance every such
     // project reports the verb unmeasured on every run and never changes.
     absentReasons: ['no-folders'] satisfies ContextAuditRefusal[],

package/src/claude/cases/all.ts

@@ -12,7 +12,7 @@ import { SETUP_CASES } from '@/claude/cases/setup'
  * Bootstrapped from each skill's own quoted trigger phrases and then
  * rephrased and supplemented rather than shipped verbatim, since a positive
  * lifted unchanged from a trigger passes by construction and never tests a
- * person's own words. See `.claude/groundwork/42-ai-blueprint/08-spikes.md`
+ * person's own words. See `.canon/groundwork/42-ai-blueprint/08-spikes.md`
  * for the extraction arm this corpus replaces as the shipped measure.
  */
 export const SKILL_CASES: readonly SkillCase[] = [

package/src/claude/seeds.ts

@@ -2,6 +2,7 @@ import { existsSync } from 'node:fs'
 import { chmod, mkdir, readFile, writeFile } from 'node:fs/promises'
 import { dirname, join } from 'node:path'
 import { copyPreservingMode } from '@/copy'
+import { creationRel, isRecordEntry } from '@/record-root'
 import { rewritesOnInstall, stripSeedMarker } from '@/seed-marker'
 
 const SEEDS_DIR = join('tooling', 'claude', 'seeds')
@@ -81,13 +82,23 @@ export function planSeeds(root: string, target: string): SeedEntry[] {
   }
 
   for (const subdir of SUBDIRS) {
+    // The seed tree authors every subdirectory under `.claude/`, and three of
+    // them are record folders that install under the record root instead. A
+    // target that has not migrated resolves back to `.claude/`, so the same seed
+    // lands beside the records already there rather than opening a second root.
+    // Scaffolding one under `.claude/` now would also land it outside the single
+    // `.canon/` ignore entry a target receives, which tracks the memory pen.
+    const installRel = isRecordEntry(subdir)
+      ? creationRel(target, subdir)
+      : join(CLAUDE_DIR, subdir)
+
     for (const name of listLevel(join(source, subdir))) {
       const rel = `${subdir}/${name}`
       seeds.push({
         src: join(source, subdir, name),
-        dest: join(destDir, subdir, name),
+        dest: join(target, installRel, name),
         scanLabel: rel,
-        applyLabel: join(CLAUDE_DIR, subdir, name),
+        applyLabel: join(installRel, name),
         scope: 'claude',
         executable: subdir === HOOKS,
       })

package/src/claude/skills-rank.ts

@@ -8,7 +8,7 @@ import { listSkillsAt, resolveSkillsCorpus } from '@/claude/skills-list'
  * asks whether the descriptions are separable by the words they use, and
  * Claude Code does not route this way.
  *
- * Ported from `.claude/groundwork/42-ai-blueprint/evidence/rank.ts`, which
+ * Ported from `.canon/groundwork/42-ai-blueprint/evidence/rank.ts`, which
  * ran once against this catalog and named the collisions this measure now
  * tracks on a cadence.
  */

package/src/cli.ts

@@ -72,11 +72,11 @@ function showHelp(): void {
     `${GREY}│${NC}    demo [cmd]         ${GREY}# Record a running app (compile, run)${NC}`,
     `${GREY}│${NC}    inventory [subj]   ${GREY}# Report one computed property across every route${NC}`,
     `${GREY}│${NC}    drive <url> <run>  ${GREY}# Walk a page through named interactions and measure each state${NC}`,
-    `${GREY}│${NC}    feedback           ${GREY}# Write toolkit feedback from stdin to .claude/review/feedback/${NC}`,
+    `${GREY}│${NC}    feedback           ${GREY}# Write toolkit feedback from stdin to .canon/review/feedback/${NC}`,
     `${GREY}│${NC}    transcripts <url>  ${GREY}# Fetch a YouTube transcript with metadata frontmatter${NC}`,
     `${GREY}│${NC}    tasks [cmd]        ${GREY}# Task board commands (archive)${NC}`,
-    `${GREY}│${NC}    intake [cmd]       ${GREY}# Intake folders under .claude/intake/ (list, answer)${NC}`,
-    `${GREY}│${NC}    teach [cmd]        ${GREY}# Learning workspaces under .claude/teach/ (list, open, resource, glossary)${NC}`,
+    `${GREY}│${NC}    intake [cmd]       ${GREY}# Intake folders under .canon/intake/ (list, answer)${NC}`,
+    `${GREY}│${NC}    teach [cmd]        ${GREY}# Learning workspaces under .canon/teach/ (list, open, resource, glossary)${NC}`,
     `${GREY}│${NC}    comments [cmd]     ${GREY}# Measure comment density and trend (scan)${NC}`,
     `${GREY}│${NC}    context [cmd]      ${GREY}# Report context folder health (audit)${NC}`,
     `${GREY}│${NC}    markdown [cmd]     ${GREY}# Report markdown against the attribute standards (audit)${NC}`,
@@ -121,7 +121,7 @@ function showHelp(): void {
     `${GREY}│${NC}    canon slides render`,
     `${GREY}│${NC}    canon slides list --json`,
     `${GREY}│${NC}    canon capture assets/install.html`,
-    `${GREY}│${NC}    canon serve .claude/teach`,
+    `${GREY}│${NC}    canon serve .canon/teach`,
     `${GREY}│${NC}    canon inventory focus --json`,
     `${GREY}│${NC}    canon drive http://localhost:4173 run.json --json`,
     `${GREY}│${NC}    pbpaste | canon feedback`,

package/src/commands/demo.ts

@@ -61,7 +61,7 @@ export function register(program: Command): void {
         '  1  refused, with the reason on stderr',
         '',
         'Examples:',
-        '  canon demo compile .claude/.tmp/screencast/inline-edit.md',
+        '  canon demo compile .canon/tmp/screencast/inline-edit.md',
         '  canon demo compile draft.md --out demos --force',
         '',
       ].join('\n'),

package/src/commands/design.ts

@@ -17,7 +17,7 @@ export function register(program: Command): void {
     .option(
       '-o, --out <path>',
       'Output directory',
-      creationRel('review', 'design'),
+      creationRel(process.cwd(), 'review', 'design'),
     )
     .action((opts: { source: string; out: string }) => {
       const sourcePath = resolve(process.cwd(), opts.source)

package/src/commands/feedback.ts

@@ -40,10 +40,10 @@ function isToolkitSource(): boolean {
  * single ignore entry and the single backed-folder entry it already had.
  */
 function writeLocal(body: string): string {
-  // Creation, so the destination is the creation default rather than the
-  // resolved read root. A toolkit checkout that has migrated its records already
-  // carries the folder and resolves the same path either way.
-  const relativeDir = creationRel('review', 'feedback')
+  // Resolved against the same root the write joins onto, so a checkout that has
+  // not migrated its records writes this beside the ones already there rather
+  // than opening a second root nothing reads.
+  const relativeDir = creationRel(PROJECT_ROOT, 'review', 'feedback')
   const reviewDir = join(PROJECT_ROOT, relativeDir)
   mkdirSync(reviewDir, { recursive: true })
   const filename = `feedback-${deriveSlug(body)}-${timestamp()}.md`
@@ -57,7 +57,7 @@ export function register(program: Command): void {
   program
     .command('feedback')
     .description(
-      'Write toolkit feedback from stdin to .claude/review/feedback/, or open a GitHub issue with --github',
+      'Write toolkit feedback from stdin to .canon/review/feedback/, or open a GitHub issue with --github',
     )
     .option(
       '--github',

package/src/commands/gov.ts

@@ -66,7 +66,17 @@ import {
   select,
 } from '@/ui'
 
-const PAYLOAD_REL = creationRel(SCRATCH, 'gov', 'rules.md')
+/**
+ * Where the rules payload lands, resolved per target rather than once at import.
+ *
+ * The record root a project uses is a fact about that project, and this command
+ * writes into a target the caller named, so a value computed here against this
+ * process's own tree would point every target at whichever root the toolkit
+ * happens to hold.
+ */
+function payloadRel(root: string): string {
+  return creationRel(root, SCRATCH, 'gov', 'rules.md')
+}
 const RULES_REL = join('.claude', 'rules')
 
 interface InstallOptions {
@@ -170,7 +180,7 @@ export function register(program: Command): void {
 
   gov
     .command('build')
-    .description('Concatenate installed rules into .claude/.tmp/gov/rules.md')
+    .description('Concatenate installed rules into .canon/tmp/gov/rules.md')
     .argument('[target]', 'Target directory', '.')
     .helpOption('-h, --help', 'Show this help message')
     .action(async (target: string) => {
@@ -1222,6 +1232,7 @@ async function runBuild(target: string): Promise<number> {
   intro('canon gov build')
 
   const resolved = resolve(target)
+  const payload = payloadRel(resolved)
   const rulesDir = join(resolved, RULES_REL)
 
   if (!existsSync(rulesDir)) {
@@ -1237,7 +1248,7 @@ async function runBuild(target: string): Promise<number> {
   }
 
   const shouldBuild = await select({
-    message: `Build ${files.length} rules to ${PAYLOAD_REL}?`,
+    message: `Build ${files.length} rules to ${payload}?`,
     options: [
       { value: true, label: 'Yes' },
       { value: false, label: 'No' },
@@ -1252,15 +1263,15 @@ async function runBuild(target: string): Promise<number> {
   }
 
   logStep('Building rules payload')
-  const output = join(resolved, PAYLOAD_REL)
+  const output = join(resolved, payload)
   await mkdir(dirname(output), { recursive: true })
   await writeFile(output, buildRulesPayload(files))
-  logAdd(PAYLOAD_REL)
+  logAdd(payload)
 
   const { GREEN, NC } = palette(process.stderr)
   outro()
   process.stderr.write(
-    `${GREEN}✓ Rules built (${files.length} rules → ${PAYLOAD_REL})${NC}\n`,
+    `${GREEN}✓ Rules built (${files.length} rules → ${payload})${NC}\n`,
   )
   return 0
 }

package/src/commands/intake.ts

@@ -47,7 +47,7 @@ interface AnswerCommandOptions {
 export function register(program: Command): void {
   const intake = program
     .command('intake')
-    .description('Read and answer intake folders in .claude/intake/')
+    .description('Read and answer intake folders in .canon/intake/')
     .helpOption('-h, --help', 'Show this help message')
 
   intake

package/src/commands/migrate.ts

@@ -1,7 +1,14 @@
+import { readFileSync } from 'node:fs'
+import { join } from 'node:path'
 import type { Command } from 'commander'
 import { listRepositoryFiles } from '@/git-files'
-import { applyRename, readSources } from '@/migrate/apply'
+import { applyRecordsMove, applyRename, readSources } from '@/migrate/apply'
 import { isToolkitOwned, planRename, type RenamePlan } from '@/migrate/plan'
+import {
+  ignoresDestination,
+  planRecordsMove,
+  type RecordsPlan,
+} from '@/migrate/records'
 import { logError, logInfo, logStep, logWarn, pipeOutput, plural } from '@/ui'
 
 interface RenameOptions {
@@ -128,12 +135,176 @@ function toRecord(
   }
 }
 
+interface RecordsOptions {
+  readonly json?: boolean
+  readonly write?: boolean
+  readonly root?: string
+}
+
+/**
+ * Moves a project's session records to `.canon/` and repoints what cites them.
+ *
+ * The ignore gate runs before anything is planned. Every folder being moved is
+ * ignored where it stands, so landing them under a root the project does not
+ * ignore publishes the memory pen into the next commit, and reporting a plan
+ * the caller cannot safely apply is worse than refusing to draw one.
+ */
+async function runRecords(opts: RecordsOptions): Promise<number> {
+  const root = opts.root ?? process.cwd()
+
+  const gitignore = readGitignore(root)
+  if (gitignore === undefined) {
+    logError(
+      `No .gitignore at ${root}, so the records cannot be moved somewhere they stay ignored.`,
+    )
+    return 1
+  }
+
+  if (!ignoresDestination(gitignore)) {
+    logError(
+      'This project does not ignore .canon/, and every record folder being moved is ignored where it stands.',
+    )
+    logError(
+      'Run canon tooling sync --write to take the ignore entry, then run this again.',
+    )
+    return 1
+  }
+
+  const files = await listRepositoryFiles(root)
+  if (files === undefined) {
+    logError(`Could not list files under ${root}. Is it a git repository?`)
+    return 1
+  }
+
+  const plan = planRecordsMove(root, await readSources(root, files))
+
+  // stdout, so the record pipes clean. `pipeOutput` frames to stderr, which is
+  // where this command's report belongs and where a JSON record does not.
+  if (opts.json) {
+    process.stdout.write(
+      `${JSON.stringify(toRecordsRecord(plan, opts.write))}\n`,
+    )
+  }
+
+  reportRecords(plan)
+
+  if (plan.collisions.length > 0) {
+    logError(
+      `${plural(plan.collisions.length, 'destination')} already exist under .canon/. Merging two record folders is not a call this verb takes.`,
+    )
+    for (const path of plan.collisions) logError(`  ${path}`)
+    return 1
+  }
+
+  if (plan.moves.length === 0 && plan.entries.length === 0) return 0
+
+  if (!opts.write) {
+    logWarn('Nothing was written. Pass --write to apply this plan.')
+    return 2
+  }
+
+  const applied = await applyRecordsMove(root, plan)
+  logStep(
+    `Rewrote ${plural(applied.written, 'file')} and moved ${plural(applied.moved, 'folder')}.`,
+  )
+
+  // `failed` carries a citation the write loop could not land as well as a
+  // folder the rename loop stopped on, so the line names a path rather than a
+  // folder. Reading a rejected write back as a folder that would not move sends
+  // the reader looking at the wrong half of the verb.
+  if (applied.failed.length > 0) {
+    logError(`Could not write ${plural(applied.failed.length, 'path')}.`)
+    for (const path of applied.failed) logError(`  ${path}`)
+    return 1
+  }
+
+  return 0
+}
+
+function readGitignore(root: string): string | undefined {
+  try {
+    return readFileSync(join(root, '.gitignore'), 'utf8')
+  } catch {
+    return undefined
+  }
+}
+
+function reportRecords(plan: RecordsPlan): void {
+  logInfo(`${plural(plan.moves.length, 'folder')} to move.`)
+  for (const move of plan.moves) logInfo(`  ${move.from} -> ${move.to}`)
+  logInfo(
+    `${plural(plan.entries.length, 'file')} to change, ${plural(plan.rewritten, 'citation')} to rewrite.`,
+  )
+  logInfo(`${plural(plan.kept, 'citation')} marked to keep the old root.`)
+
+  if (plan.excluded.length > 0) {
+    logInfo(`${plural(plan.excluded.length, 'file')} excluded from the sweep.`)
+  }
+}
+
+function toRecordsRecord(
+  plan: RecordsPlan,
+  wrote: boolean | undefined,
+): unknown {
+  return {
+    ok: plan.collisions.length === 0,
+    wrote: wrote === true,
+    moves: plan.moves,
+    collisions: plan.collisions,
+    files: plan.entries.length,
+    rewritten: plan.rewritten,
+    kept: plan.kept,
+    excluded: plan.excluded.length,
+    paths: plan.entries.map((entry) => ({
+      path: entry.path,
+      rewritten: entry.rewritten,
+    })),
+  }
+}
+
 export function register(program: Command): void {
   const migrate = program
     .command('migrate')
-    .description('Move a project off the retired aitk name')
+    .description('Move a project off a retired name or layout')
     .helpOption('-h, --help', 'Show this help message')
 
+  migrate
+    .command('records')
+    .description('Move the gitignored session records to .canon/')
+    .helpOption('-h, --help', 'Show this help message')
+    .option('--json', 'Add a machine-readable record on stdout')
+    .option('--write', 'Apply the plan rather than reporting it')
+    .option(
+      '--root <path>',
+      'Project root, defaulting to the working directory',
+    )
+    .addHelpText(
+      'after',
+      [
+        '',
+        'Exit codes:',
+        '  0  nothing to move, or --write applied the whole plan',
+        '  1  refused, or a move failed',
+        '  2  a plan exists and --write was not passed',
+        '',
+        'The project has to ignore .canon/ before anything moves. Every folder',
+        'this relocates is ignored where it stands, and landing one under a root',
+        'the project tracks publishes the memory pen into the next commit.',
+        '',
+        'A line carrying canon-keep-record-root, or the line below it, keeps the',
+        'old root. Prose that dates a decision needs it; a live path does not.',
+        '',
+        'Examples:',
+        '  canon migrate records',
+        '  canon migrate records --write',
+        '  canon migrate records --json',
+        '',
+      ].join('\n'),
+    )
+    .action(async (opts: RecordsOptions) => {
+      process.exitCode = await runRecords(opts)
+    })
+
   migrate
     .command('rename')
     .description('Rewrite every unprotected aitk token to canon')

package/src/commands/pr.ts

@@ -130,7 +130,7 @@ export function register(program: Command): void {
         'Examples:',
         '  canon pr key-changes',
         '  canon pr key-changes 1265 --json',
-        '  canon pr key-changes --body .claude/.tmp/body.md --base origin/main',
+        '  canon pr key-changes --body .canon/tmp/body.md --base origin/main',
         '',
       ].join('\n'),
     )

package/src/commands/records.ts

@@ -226,7 +226,7 @@ function backupHelp(verb: 'push' | 'pull'): string {
     '',
     ...direction,
     '',
-    'The history lives in a second git directory at .claude/.records.git, pointed at a',
+    'The history lives in a second git directory at .canon/.records.git, pointed at a',
     'private repository a person creates once. The verbs refuse with the setup command',
     'when it is absent, and refuse when its origin is also a remote of this project.',
     '',

package/src/commands/serve.ts

@@ -36,8 +36,8 @@ export function register(program: Command): void {
         'starts it in the background and reads the record off stdout.',
         '',
         'Examples:',
-        '  canon serve .claude/teach',
-        '  canon serve .claude/teach --entry 03-fde-system-design/index.html',
+        '  canon serve .canon/teach',
+        '  canon serve .canon/teach --entry 03-fde-system-design/index.html',
         '  canon serve dist --port 4000 --json',
         '',
       ].join('\n'),

package/src/commands/slides.ts

@@ -20,7 +20,7 @@ export function register(program: Command): void {
     .option(
       '-o, --out <path>',
       'Output directory',
-      creationRel('review', 'slides'),
+      creationRel(process.cwd(), 'review', 'slides'),
     )
     .option('-v, --variant <variant>', 'Override variant (light or dark)')
     .option(

package/src/commands/tasks.ts

@@ -76,7 +76,7 @@ interface OutcomeCommandOptions {
 export function register(program: Command): void {
   const tasks = program
     .command('tasks')
-    .description('Manage the task board in .claude/tasks/')
+    .description('Manage the task board in .canon/tasks/')
     .helpOption('-h, --help', 'Show this help message')
 
   tasks
@@ -157,8 +157,8 @@ export function register(program: Command): void {
         '',
         'Locations:',
         '  unstated  the task carries no Plan: line',
-        '  live      the target resolves inside .claude/plans/',
-        '  archived  the target resolves inside .claude/plans/archive/',
+        '  live      the target resolves inside .canon/plans/',
+        '  archived  the target resolves inside .canon/plans/archive/',
         '  outside   the target resolves somewhere else',
         '',
         'Exit codes:',
@@ -201,11 +201,11 @@ export function register(program: Command): void {
         'exit code, which a shell function wrapping canon can flatten to zero.',
         '',
         'A relative path resolves against the project root first and against',
-        '.claude/tasks/ second, so the ../plans/ link a board row writes works.',
+        '.canon/tasks/ second, so the ../plans/ link a board row writes works.',
         '',
         'Examples:',
         '  canon tasks plan-answers dispatch-answer-gate',
-        '  canon tasks plan-answers .claude/plans/feature-dispatch-answer-gate.md',
+        '  canon tasks plan-answers .canon/plans/feature-dispatch-answer-gate.md',
         '  canon tasks plan-answers ../plans/feature-dispatch-answer-gate.md',
         '  canon tasks plan-answers dispatch-answer-gate --json',
         '',

package/src/commands/teach.ts

@@ -76,7 +76,7 @@ interface GlossaryCommandOptions {
 export function register(program: Command): void {
   const teach = program
     .command('teach')
-    .description('Manage learning workspaces in .claude/teach/')
+    .description('Manage learning workspaces in .canon/teach/')
     .helpOption('-h, --help', 'Show this help message')
 
   teach

package/src/context/audit.ts

@@ -19,7 +19,7 @@ import { isStubSeed } from '@/seed-marker'
  * Every reason `canon context audit` refuses for.
  *
  * `no-folders` is the one ordinary absence: a project that never adopted
- * `.claude/context/`, `.claude/diagrams/`, or `.claude/wireframes/` names no
+ * `.claude/context/`, `.canon/diagrams/`, or `.claude/wireframes/` names no
  * corpus this audit can measure, the same state `no-skills` reads for the
  * skill corpora. The other four are a malformed invocation or a checkout git
  * cannot read, which stay a break rather than an absence.

package/src/demo/compile.ts

@@ -5,7 +5,7 @@ import type { Beat, Draft } from '@/demo/beats'
  * separate artifacts on purpose: a beat carries no target, no wait condition,
  * and no timing, and putting those four fields on every beat would destroy the
  * property the draft was designed around. See
- * `.claude/groundwork/38-demo-recorder/06-decision.md`.
+ * `.canon/groundwork/38-demo-recorder/06-decision.md`.
  *
  * A compiled plan is committed rather than scratch, because the timing below is
  * a starting point the operator tunes and the draft cannot reproduce a tuned

package/src/gov/citations.ts

@@ -357,7 +357,7 @@ function globMatches(root: string, glob: string): boolean {
 /**
  * Which of `paths` git ignores, or nothing when git could not answer.
  *
- * Session scratch is the class this reaches. `.claude/tasks/index.md` is real
+ * Session scratch is the class this reaches. `.canon/tasks/index.md` is real
  * in a live project, absent from a fresh clone and from every linked worktree,
  * and a rule naming it is right either way. Resolving against the filesystem
  * alone would make the verdict depend on which tree the check ran in.

package/src/gov/restated.ts

@@ -43,7 +43,7 @@ const MIRRORS: readonly (readonly [string, string])[] = [
  *
  * Under one percent of the 2750 statements this repository offers. Tuned
  * against that corpus rather than reasoned to, which is what the plan asked of
- * the first run: `.claude/plans/` sits at 14 and is the anchor the motivating
+ * the first run: `.canon/plans/` sits at 14 and is the anchor the motivating
  * case turns on, while `file` sits at 371 and matches most of the tree.
  */
 export const COMMON_CEILING = 20
@@ -55,7 +55,7 @@ export const ANCHOR_FLOOR = 3
  * What a backticked token is worth against a plain word.
  *
  * An author marking a span as code named an identifier rather than describing
- * one, so `.claude/plans/archive/` says more about what a statement governs
+ * one, so `.canon/plans/archive/` says more about what a statement governs
  * than any two prose words do. Weighting it is what lets the floor rise high
  * enough to drop a coincidental word pair without losing a rule two surfaces
  * spelled entirely differently around one shared path.
@@ -267,7 +267,7 @@ interface Indexed<T extends Statement> {
 /**
  * Splits text into the tokens an anchor can be drawn from.
  *
- * A code span keeps its inner text whole, since `.claude/plans/archive/` is the
+ * A code span keeps its inner text whole, since `.canon/plans/archive/` is the
  * strongest anchor this corpus offers and splitting it on the punctuation would
  * leave three words every second bullet also carries.
  */