@erclx/canon 5.34.0 → 5.35.0

package/governance/stacks/go.toml

@@ -0,0 +1,2 @@
+extends = "base"
+rules = ["code", "130-go", "335-testing-go"]

package/governance/stacks/node.toml

@@ -1,2 +1,2 @@
 extends = "base"
-rules = ["code", "100-typescript"]
+rules = ["code", "100-typescript", "300-testing-ts"]

package/governance/stacks/php.toml

@@ -0,0 +1,2 @@
+extends = "base"
+rules = ["code", "140-php", "336-testing-php"]

package/governance/stacks/python.toml

@@ -1,2 +1,2 @@
 extends = "base"
-rules = ["code", "110-python", "340-pydantic", "330-testing-py", "360-security-server", "370-database"]
+rules = ["code", "110-python", "330-testing-py"]

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@erclx/canon",
   "type": "module",
-  "version": "5.34.0",
+  "version": "5.35.0",
   "description": "Runs your agent's work and keeps its code good, on one setup for every repo.",
   "license": "MIT",
   "bin": {
@@ -10,7 +10,6 @@
   "files": [
     "src",
     "scripts",
-    "standards",
     "governance",
     "tooling",
     "claude",
@@ -25,7 +24,6 @@
     "access": "public"
   },
   "scripts": {
-    "check:spell": "cspell '**' '.*/**' '.*' --no-progress --color --show-context",
     "format": "prettier --write --log-level warn --ignore-path .gitignore --ignore-path .prettierignore . && shfmt --write --indent 2 scripts/ tooling/ claude/",
     "check:format": "prettier --check --log-level warn --ignore-path .gitignore --ignore-path .prettierignore . && shfmt --diff --indent 2 scripts/ tooling/ claude/",
     "check:shell": "find scripts tooling claude .claude/hooks -name '*.sh' -exec shellcheck --severity=warning {} + && find .husky -maxdepth 1 -type f -exec shellcheck --severity=warning --shell=sh {} +",
@@ -71,7 +69,6 @@
     "@types/bun": "^1.2.10",
     "@types/micromatch": "^4.0.10",
     "astro": "^6.1.9",
-    "cspell": "^8.17.1",
     "happy-dom": "^20.14.5",
     "husky": "^9.1.7",
     "micromatch": "^4.0.8",

package/scripts/core/install-check.sh

@@ -97,9 +97,8 @@ log_step "Assert scaffold"
 # catches a failed domain, and the gate stays green while the target is
 # missing everything that domain provides.
 #
-# Standards name no path because that corpus never installs into a target. A
-# scaffold reads a standard through `canon standards <name>`, resolving against
-# the toolkit rather than a copy this gate could assert on. The two
+# Authoring references name no path because they ship inside the plugin's
+# skills rather than installing into a target. The two
 # rule paths stand for the `claude` and `canon` groups `base` takes whole.
 for path in "CLAUDE.md" ".claude/wiki/index.md" ".claude" "canon/context/index.md" \
   ".prettierrc" ".editorconfig" ".lintstagedrc" ".husky/pre-commit" ".github/workflows/verify.yml" "scripts/verify.sh" \

package/src/audits/catalog.ts

@@ -468,7 +468,6 @@ const RECORD_KINDS: readonly (readonly [string, Corpus])[] = [
   ['plans', 'per-machine'],
   ['groundwork', 'per-machine'],
   ['intake', 'per-machine'],
-  ['standards', 'tracked'],
   ['teach', 'per-machine'],
 ]
 
@@ -588,14 +587,6 @@ export const AUDITS: readonly AuditSpec[] = [
     argv: ['records', 'validate', kind, '--json'],
     gatingExits: [],
     corpus,
-    // `standards` is the one tracked kind here, so it takes none of the
-    // per-machine default the other five inherit from their corpus. A target
-    // reads standards through `canon standards` rather than a copy in its own
-    // tree, so carrying no standards folder at all is the
-    // ordinary state of every project but this repository.
-    ...(kind === 'standards' && {
-      absentReasons: ['no-folder'] satisfies RecordRefusal[],
-    }),
     counts: findingsOnly,
   })),
   {

package/src/claude/routing.ts

@@ -16,7 +16,7 @@ const PATH_TOKEN = /^[.A-Za-z0-9_][A-Za-z0-9._/-]*$/
 /** A placeholder segment, which a shape carries and a real path does not. */
 const SHAPE = /<[^>]*>/
 
-/** An alphabetic extension, which separates `cspell.json` from `3.6.0`. */
+/** An alphabetic extension, which separates `tsconfig.json` from `3.6.0`. */
 const EXTENSION = /\.[a-z]{2,5}$/
 
 /** Extensions a folder is probed with, so a glob narrowed by type still hits. */

package/src/claude/skills-reach.ts

@@ -6,10 +6,9 @@ import { SURFACE_ROOTS } from '@/roots/surface'
 /**
  * The authoring roots this repository owns and no install channel delivers.
  *
- * Every entry is a folder a target never holds under that spelling. Standards
- * install nowhere and are reached through the plugin corpus,
- * rules install under `.claude/rules/`, and the rest are this repository's
- * own source, docs, and catalogs.
+ * Every entry is a folder a target never holds under that spelling. Rules
+ * install under `.claude/rules/`, and the rest are this repository's own
+ * source, docs, and catalogs.
  *
  * `src/`, `scripts/`, and bare `docs/` are deliberately absent. A body naming
  * one of those is describing the reader's own tree, so listing them would
@@ -28,7 +27,6 @@ const AUTHORING_ROOTS = [
   'docs/agents/',
   'governance/',
   'internal/',
-  'standards/',
   'tooling/',
   'wiki/',
 ] as const
@@ -51,7 +49,7 @@ const TOKEN = /`([^`\s]+)`/g
  *
  * Requires an extension and a separator, and admits no `<`, `$`, or `*`. A
  * body writes `canon/context/<domain>.md` to name a shape rather than a
- * file, and `${CLAUDE_SKILL_DIR}/../../standards/<name>.md` to resolve
+ * file, and `${CLAUDE_SKILL_DIR}/../<skill>/references/<name>.md` to resolve
  * against the plugin root, which is self-contained by construction.
  */
 const CONCRETE = /^[.A-Za-z0-9_][A-Za-z0-9._/-]*\.[a-z]{1,4}$/

package/src/cli/help.ts

@@ -27,7 +27,6 @@ export const COMMAND_GROUPS: { title: string; rows: CommandRow[] }[] = [
     title: 'Domains',
     rows: [
       ['gov [cmd]', 'Governance rules (install, sync, list)'],
-      ['standards [cmd]', 'Standards (list, <name>)'],
       ['tooling [cmd]', 'Tooling stacks (sync, ref, create)'],
       ['claude [cmd]', 'Claude workflow (init, sync, setup)'],
       ['wiki [cmd]', 'Wiki pages (init)'],
@@ -75,7 +74,7 @@ export const COMMAND_GROUPS: { title: string; rows: CommandRow[] }[] = [
       ['labels [cmd]', 'Read a changed set against the label map (audit)'],
       ['comments [cmd]', 'Measure comment density and trend (scan)'],
       ['context [cmd]', 'Report context folder health (audit)'],
-      ['markdown [cmd]', 'Report markdown against the standards (audit)'],
+      ['markdown [cmd]', 'Report markdown against the shipped bans (audit)'],
       ['census [path]', 'Report file count, extensions, and line totals'],
     ],
   },
@@ -91,10 +90,10 @@ const SANDBOX_ROWS: CommandRow[] = [
 const EXAMPLES = [
   'canon sync ../my-app',
   'canon sandbox git:commit',
-  'canon gov install react',
+  'canon gov install node',
   'canon gov sync ../my-app',
   'canon gov restated --json',
-  'canon standards markdown',
+  'canon markdown audit docs/',
   'canon init ../my-app',
   'canon tooling sync base',
   'canon claude init',

package/src/cli.ts

@@ -5,7 +5,6 @@ import { register as init } from '@/commands/init'
 import { register as sandbox } from '@/commands/sandbox'
 import { register as sync } from '@/commands/sync'
 import { register as gov } from '@/commands/gov'
-import { register as standards } from '@/commands/standards'
 import { register as tooling } from '@/commands/tooling'
 import { register as claude } from '@/commands/claude'
 import { register as wiki } from '@/commands/wiki'
@@ -66,7 +65,6 @@ init(program)
 sandbox(program)
 sync(program)
 gov(program)
-standards(program)
 tooling(program)
 claude(program)
 wiki(program)

package/src/commands/gov.ts

@@ -143,7 +143,7 @@ export function register(program: Command): void {
   gov
     .command('install')
     .description('Install a governance stack into .claude/rules/canon/')
-    .argument('[stack]', 'Stack name (e.g. base, node, react)')
+    .argument('[stack]', 'Stack name (e.g. base, node, python)')
     .argument('[target]', 'Target directory', '.')
     .helpOption('-h, --help', 'Show this help message')
     .option('--add <rules>', 'Comma-separated rules to layer on the stack')
@@ -152,9 +152,9 @@ export function register(program: Command): void {
       [
         '',
         'Examples:',
-        '  canon gov install react',
+        '  canon gov install node',
         '  canon gov install node ../my-app',
-        '  canon gov install astro --add 200-react,260-shadcn ../my-app',
+        '  canon gov install node --add 210-astro,260-shadcn ../my-app',
         '  canon gov install --add tasks,plan ../my-app',
         '',
         'With --add and no stack, the named rules install alone. A first',
@@ -307,7 +307,7 @@ export function register(program: Command): void {
         'members a closed catalog holds, then compares the stated figure',
         'against what the tree actually counts.',
         '',
-        'Catalogs read: skills, governance rules, standards, CLI commands,',
+        'Catalogs read: skills, governance rules, CLI commands,',
         'and audit ids. Closed rather than derived, so widening the',
         'set is a deliberate change rather than a side effect of a new list',
         'command shipping elsewhere.',
@@ -441,10 +441,6 @@ export function register(program: Command): void {
         'present and the question answerable.',
         '',
         'Forms read, with where each resolves:',
-        '  standard  canon standards <name> , against standards/ alone, which',
-        '            is where the verb itself looks. internal/standards/ is not',
-        '            tried, since a name resolving only there refuses for the',
-        '            session that opens the citation.',
         '  path      a backticked path carrying a directory segment and a file',
         '            extension, against the root',
         "  sibling   a bare <nnn>-<slug>.md , against the citing rule's folder",
@@ -454,7 +450,7 @@ export function register(program: Command): void {
         '  naming a file, such as canon/context/<domain>.md or app/**/route.ts',
         '  a bare filename naming a convention, such as route.ts or manifest.toml',
         '  a span carrying no file extension, which is a folder or a module',
-        '  specifier, such as src/pages/ , next/font , or claude/standards',
+        '  specifier, such as src/pages/ , next/font , or claude/skills',
         '  a fenced block, which displays a path rather than pointing at one',
         '',
         'Exempt, reported by name rather than dropped:',

package/src/commands/init.ts

@@ -40,7 +40,7 @@ export function register(program: Command): void {
         'Examples:',
         '  canon init',
         '  canon init ../my-app',
-        '  canon init --stack astro --add 260-shadcn ../my-app',
+        '  canon init --stack node --add 210-astro,260-shadcn ../my-app',
         '  canon init --skip governance ../my-app',
         '',
       ].join('\n'),

package/src/commands/labels.ts

@@ -10,7 +10,6 @@ import { checkTitleFormat, type TitleFormatIssue } from '@/labels/format'
 import { MAP_REL } from '@/labels/map'
 import { isReleasePullRequest, scanPhaseLabels } from '@/labels/phase'
 import { checkSections } from '@/labels/sections'
-import { scanTitleSpelling } from '@/labels/spelling'
 import { BAN_SETS } from '@/markdown/bans'
 import { bodyLines, scanBans } from '@/markdown/scan'
 import { intro, logInfo, logStep, logWarn, outro, plural } from '@/cli/ui'
@@ -169,7 +168,7 @@ export function register(program: Command): void {
   labels
     .command('scan')
     .description(
-      'Fail a pull request or a posted review whose title, body, or review comment carries a phase label, a board identifier, a session link, or a title with an unspelled word',
+      'Fail a pull request or a posted review whose title, body, or review comment carries a phase label, a board identifier, or a session link',
     )
     .helpOption('-h, --help', 'Show this help message')
     .option(
@@ -188,7 +187,7 @@ export function register(program: Command): void {
       'after',
       [
         '',
-        'Reads canon standards versioning for the two namespaces and sorts every',
+        'Reads the git-commit versioning reference for the two namespaces and sorts every',
         'version-shaped token this pull request carries into the one the pull',
         'request is allowed to hold. A release-please pull request, read off its',
         'own fixed head branch and title, may carry semver references. Every',
@@ -212,13 +211,6 @@ export function register(program: Command): void {
         'session and for no other reader, which no clone repairs, so it is read',
         'on a release pull request too, where the board identifier is not.',
         '',
-        "It also spell-checks the title alone against this repository's own",
-        'cspell config, since release-please copies the title into',
-        'CHANGELOG.md and nothing else spell-checks it first. The check shells',
-        "this repository's own resolved cspell binary and reports nothing when",
-        'a target project carries none, rather than reaching the network or',
-        'forcing a new dependency.',
-        '',
         "It also grades the title alone against claude/skills/git-pr/references/pr.md's ## Title",
         'section: the `<type>(<scope>)[!]: <subject>` structure, lowercase casing',
         'for the type, the scope, and the first subject word, and a 72-',
@@ -234,11 +226,11 @@ export function register(program: Command): void {
         'request or a review, outside a code span or a link.',
         '',
         'Exit codes:',
-        '  0  none of the seven found',
+        '  0  none of the six found',
         '  1  refused, with the reason on stderr or in the JSON record',
         '  2  the title or body carries a phase label, a board identifier, a',
         '     session link, a banned character, a heading outside the closed',
-        '     list or a required one missing, a title word no dictionary holds, or a title',
+        '     list or a required one missing, or a title',
         "     breaking claude/skills/git-pr/references/pr.md's format, casing, or length",
         '',
         'Examples:',
@@ -532,7 +524,6 @@ async function runScan(opts: ScanOptions): Promise<number> {
   }
 
   const result = scanPhaseLabels(resolved)
-  const spelling = await scanTitleSpelling(resolved.title, process.cwd())
   // A scan given no title, whatever produced that absence, has nothing to
   // grade and would otherwise fail as `structure` for the wrong reason.
   const titleFormat =
@@ -579,34 +570,6 @@ async function runScan(opts: ScanOptions): Promise<number> {
     for (const link of result.sessionLinks) logWarn(link)
   }
 
-  const spellingChecked = spelling.kind === 'checked'
-  const unspelledWords =
-    spelling.kind === 'checked' ? spelling.unknownWords : []
-
-  logStep(
-    spelling.kind === 'unavailable'
-      ? 'Spelling unavailable'
-      : unspelledWords.length === 0
-        ? 'Clean'
-        : 'Unspelled word found',
-  )
-  if (spelling.kind === 'unavailable' && spelling.reason === 'no-binary') {
-    logInfo(
-      `no node_modules/.bin/cspell resolved walking up from ${spelling.probedFrom}, so the title was not checked`,
-    )
-  } else if (spelling.kind === 'unavailable') {
-    logInfo(
-      `cspell did not exit clean or with issues found (${spelling.message}), so the title was not checked`,
-    )
-  } else if (unspelledWords.length === 0) {
-    logInfo('no word in the title is absent from every dictionary')
-  } else {
-    logWarn(
-      `${plural(unspelledWords.length, 'word')} in the title absent from every dictionary. Fix the spelling, or add jargon and project-specific terms to .cspell/project-terms.txt and dependency vocabulary to .cspell/tech-stack.txt.`,
-    )
-    for (const word of unspelledWords) logWarn(word)
-  }
-
   const titleFormatIssues = titleFormat?.issues ?? []
 
   // A review carries its own headings, a release-please body opens on a
@@ -707,8 +670,6 @@ async function runScan(opts: ScanOptions): Promise<number> {
         semverTags: result.semverTags,
         boardReferences: result.boardReferences,
         sessionLinks: result.sessionLinks,
-        unspelledWords,
-        spellingChecked,
         titleFormatIssues,
         sections: { checked: sectionsChecked, ...sections },
         bannedCharacters,
@@ -719,7 +680,6 @@ async function runScan(opts: ScanOptions): Promise<number> {
   return result.phaseLabels.length === 0 &&
     result.boardReferences.length === 0 &&
     result.sessionLinks.length === 0 &&
-    unspelledWords.length === 0 &&
     titleFormatIssues.length === 0 &&
     sections.outside.length === 0 &&
     sections.missing.length === 0 &&

package/src/commands/migrate.ts

@@ -1124,7 +1124,7 @@ export function register(program: Command): void {
         'repoints every citation that names one, live or archived.',
         '',
         'A promoted folder is one a durable record cites and no source file',
-        'under claude/, scripts/, src/, governance/, or standards/ names by',
+        'under claude/, scripts/, src/, or governance/ names by',
         'path. A folder a script still writes into stays in scratch, since',
         'moving it needs a code change first.',
         '',

package/src/commands/records.ts

@@ -29,7 +29,6 @@ import {
 import {
   type Finding,
   isRecordKind,
-  isSharedScratch,
   RECORD_KINDS,
   type RecordKind,
   type ValidateOutcome,
@@ -92,10 +91,7 @@ export function register(program: Command): void {
     .argument('<kind>', `Record folder: ${RECORD_KINDS.join(', ')}`)
     .helpOption('-h, --help', 'Show this help message')
     .option('--json', 'Add a machine-readable record on stdout')
-    .option(
-      '--root <path>',
-      'Project root, defaulting to the main worktree except on standards',
-    )
+    .option('--root <path>', 'Project root, defaulting to the main worktree')
     .addHelpText(
       'after',
       [
@@ -104,8 +100,6 @@ export function register(program: Command): void {
         '  plans       filename, required sections, and the suggested-and-answer contract',
         '  groundwork  README and current-state files, numbering, dating, and a half-closed track',
         '  intake      overview file, numbering, dating, and the four bullets every item carries',
-        '  standards   frontmatter, the scope section and its handoff list, and a filename',
-        '              derived from the governed path',
         '',
         'Exit codes:',
         '  0  every check passed',
@@ -113,12 +107,11 @@ export function register(program: Command): void {
         '  2  at least one record carries a finding',
         '',
         'It reports and never writes, so a session fixes what the report names. A',
-        'session record has no history to undo a wrong repair from, and a standard',
-        'is installed and cited everywhere, so a rename is larger than a file move.',
+        'session record has no history to undo a wrong repair from.',
         '',
         'Examples:',
         '  canon records validate plans',
-        '  canon records validate standards',
+        '  canon records validate teach',
         '  canon records validate intake --json',
         '',
       ].join('\n'),
@@ -718,15 +711,6 @@ function reportRefusal(
   return 1
 }
 
-/**
- * A shared-scratch kind reads the main worktree root, so a linked worktree
- * validates the records every other session reads. A tracked corpus reads the
- * checkout the caller stands in, which is the copy that session has edited.
- */
-function defaultRoot(kind: RecordKind): Promise<string> {
-  return isSharedScratch(kind) ? mainWorktreeRoot() : currentWorktreeRoot()
-}
-
 async function runValidate(
   kind: string,
   opts: ValidateCommandOptions,
@@ -745,7 +729,7 @@ async function runValidate(
     )
   }
 
-  const root = opts.root ?? (await defaultRoot(kind))
+  const root = opts.root ?? (await mainWorktreeRoot())
 
   return report(await validateWithStacks(root, kind), emitJson, root)
 }

package/src/commands/tooling.ts

@@ -99,8 +99,7 @@ export function register(program: Command): void {
         '  canon tooling sync vite-react web --skip base',
         '',
         'A target below its git root syncs as a subfolder. It withholds',
-        '.github/, which GitHub reads only at the root, and writes a nested',
-        'cspell.json registering the stack word lists.',
+        '.github/, which GitHub reads only at the root.',
         '',
         'To gate CI on tooling drift, run headlessly with neither flag. That',
         'exits 1 when a file would be replaced and 0 when none would, which is',
@@ -276,8 +275,7 @@ function runList(opts: ListOptions): number {
 
 /**
  * Writes the reference to stdout and every frame line to stderr, so a caller
- * capturing the output with `$(...)` receives the document alone. Mirrors
- * `print` in `src/commands/standards.ts`.
+ * capturing the output with `$(...)` receives the document alone.
  */
 function printReference(stack: string): number {
   intro('canon tooling reference')

package/src/counts/catalogs.ts

@@ -3,7 +3,6 @@ import { join } from 'node:path'
 import { AUDITS } from '@/audits/catalog'
 import { listSkills } from '@/claude/skills-list'
 import { buildGovCatalog } from '@/gov/list'
-import { listStandards } from '@/standards/read'
 
 export interface Catalog {
   readonly id: string
@@ -59,11 +58,6 @@ export const CATALOGS: readonly Catalog[] = [
     nouns: ['rule', 'rules'],
     count: (root) => buildGovCatalog(root).rules.length,
   },
-  {
-    id: 'standards',
-    nouns: ['standard', 'standards'],
-    count: (root) => listStandards(root).length,
-  },
   {
     id: 'commands',
     nouns: ['command', 'commands'],

package/src/gate/boundaries.ts

@@ -337,8 +337,8 @@ export const capabilitySeeding: Measure = async (ctx) => {
  * Every file under `claude/` resolved through its symlinks and rejected when it
  * lands under `internal/`.
  *
- * The plugin reaches `standards/` through a symlink, which an installer
- * dereferences with no code in the path to filter. Walking with symlinks
+ * An installer dereferences any symlink under the plugin root with no code in
+ * the path to filter, so a link added there ships whatever it points at. Walking with symlinks
  * followed is what an install copies, so this is the only place the boundary
  * can be measured. The walk tracks the real directories on its current descent
  * and does not enter one a second time, the way `find -L` stops on a loop.

package/src/gate/measures.ts

@@ -505,7 +505,7 @@ export const documentCeiling: Measure = async (ctx) => {
  * Whether a path's stem, its basename up to the first `.`, repeats its
  * immediate parent folder, either whole or as a `<folder>-` prefix.
  *
- * Exact rather than singular-aware, so `standards/standard.md` passes. A false
+ * Exact rather than singular-aware, so `skills/skill.md` passes. A false
  * positive on a gate stage teaches a contributor to route around it, and a
  * widened match is cheap to add once a real echo slips through.
  */
@@ -771,28 +771,6 @@ export function seedEntryCount(payload: string): number {
   )
 }
 
-/**
- * Scoped to arrival rather than the corpus, since `standards/standard.md`
- * forbids writing a criterion into an existing standard outside the change that
- * exercises it. Gating the known gaps would fail every push until someone
- * closed them all, which is the sweep that rule exists to prevent.
- */
-export const standardCriteria: Measure = async (ctx) => {
-  const run = await ctx.cli(['standards', 'audit', '--arrivals-only'])
-
-  if (run.exitCode === 0) {
-    return { emissions: [info('Arriving standards carry a success criterion')] }
-  }
-
-  return {
-    emissions: [output(run.all)],
-    failure:
-      run.exitCode === 2
-        ? 'A standard new to this branch carries no success-criterion section. Run bun src/cli.ts standards audit.'
-        : 'canon standards audit could not read which standards arrived on this branch. Run bun src/cli.ts standards audit --json to see why.',
-  }
-}
-
 /**
  * Every file in the gated corpus, walked from `ctx.root` rather than from the
  * changed set.
@@ -804,7 +782,7 @@ export const standardCriteria: Measure = async (ctx) => {
  * nothing it would notice.
  *
  * `dot` is what reaches the seeds, which is half of what `tooling/` ships. Every
- * seeded `.claude/` tree, `.cspell/` list, and `.husky/` hook sits behind a
+ * seeded `.claude/` tree, `.github/` workflow, and `.husky/` hook sits behind a
  * dotted segment, so the default scan walks `tooling/` and returns none of the
  * files a scaffolded project actually receives.
  */
@@ -841,8 +819,8 @@ function describeShippedReference(reference: ShippedReference): string {
       return 'a pull request number that resolves elsewhere for a reader in a target'
     case 'docs-path':
       return 'a path into this repository that a registry install never carries'
-    case 'standards-path':
-      return 'a bare standards/ path that has nothing to expand it in an installed plugin cache'
+    case 'retired-verb':
+      return 'a call to canon standards, a verb no installed CLI carries'
     case 'phase-label':
       return 'a phase label that names a board no target holds'
     case 'rule-path':
@@ -903,8 +881,8 @@ export const shippedReferences: Measure = async (ctx) => {
     ),
     failure:
       found.length === 1
-        ? `One reference in the shipped corpora resolves wrong for a reader in a target. Qualify a cross-repository citation as owner/repo#123 or owner/repo@abc1234, cite a docs page through canon docs <name>, rewrite a bare standards/ path under claude/skills/ as \${CLAUDE_SKILL_DIR}/../../standards/<name>.md, state a same-repository citation or a phase label as a fact instead and relocate the evidence to the owning canon/context/ entry, state the fact a shipped skill body's cited rule enforces instead of its path, or mark the line ${REFERENCE_MARKER}: <reason> where the bare form is the point.`
-        : `${found.length} references in the shipped corpora resolve wrong for a reader in a target. Qualify a cross-repository citation as owner/repo#123 or owner/repo@abc1234, cite a docs page through canon docs <name>, rewrite a bare standards/ path under claude/skills/ as \${CLAUDE_SKILL_DIR}/../../standards/<name>.md, state a same-repository citation or a phase label as a fact instead and relocate the evidence to the owning canon/context/ entry, state the fact a shipped skill body's cited rule enforces instead of its path, or mark each line ${REFERENCE_MARKER}: <reason> where the bare form is the point.`,
+        ? `One reference in the shipped corpora resolves wrong for a reader in a target. Qualify a cross-repository citation as owner/repo#123 or owner/repo@abc1234, cite a docs page through canon docs <name>, cite the owner skill's reference in place of a canon standards call, state a same-repository citation or a phase label as a fact instead and relocate the evidence to the owning canon/context/ entry, state the fact a shipped skill body's cited rule enforces instead of its path, or mark the line ${REFERENCE_MARKER}: <reason> where the bare form is the point.`
+        : `${found.length} references in the shipped corpora resolve wrong for a reader in a target. Qualify a cross-repository citation as owner/repo#123 or owner/repo@abc1234, cite a docs page through canon docs <name>, cite the owner skill's reference in place of a canon standards call, state a same-repository citation or a phase label as a fact instead and relocate the evidence to the owning canon/context/ entry, state the fact a shipped skill body's cited rule enforces instead of its path, or mark each line ${REFERENCE_MARKER}: <reason> where the bare form is the point.`,
   }
 }
 

package/src/gate/sequencer.ts

@@ -50,6 +50,45 @@ export interface LoadReading {
   /** The 1-minute load average. */
   readonly loadAverage: number
   readonly cores: number
+  /**
+   * The `some avg10` stall share per resource from `/proc/pressure`, which the
+   * load average folds into one number. Absent where the kernel has no PSI.
+   */
+  readonly pressure?: PressureReading
+}
+
+export interface PressureReading {
+  readonly cpu: number
+  readonly memory: number
+  readonly io: number
+}
+
+/**
+ * Reads the `some avg10` percentage from one `/proc/pressure/<resource>` file.
+ * A file that does not parse answers `undefined`, which drops the clause.
+ */
+export function parsePressure(text: string): number | undefined {
+  const match = /^some\b.*\bavg10=(\d+(?:\.\d+)?)\b/m.exec(text)
+  if (match === null) return undefined
+  const value = Number.parseFloat(match[1])
+  return Number.isFinite(value) ? value : undefined
+}
+
+function readPressure(): PressureReading | undefined {
+  try {
+    const read = (name: string) =>
+      parsePressure(readFileSync(`/proc/pressure/${name}`, 'utf8'))
+    const cpu = read('cpu')
+    const memory = read('memory')
+    const io = read('io')
+    if (cpu === undefined || memory === undefined || io === undefined) {
+      return undefined
+    }
+    return { cpu, memory, io }
+  } catch {
+    // PSI off or absent: the files may exist and still fail with EOPNOTSUPP.
+    return undefined
+  }
 }
 
 /**
@@ -62,7 +101,12 @@ export function readProcLoad(): LoadReading | undefined {
     const first = readFileSync('/proc/loadavg', 'utf8').split(' ')[0]
     const loadAverage = Number.parseFloat(first)
     if (!Number.isFinite(loadAverage)) return undefined
-    return { loadAverage, cores: availableParallelism() }
+    const pressure = readPressure()
+    return {
+      loadAverage,
+      cores: availableParallelism(),
+      ...(pressure === undefined ? {} : { pressure }),
+    }
   } catch {
     return undefined
   }
@@ -252,7 +296,12 @@ function withLoadLine(
   const reading = (ctx.readLoad ?? readProcLoad)()
   if (reading === undefined) return outcome
 
-  const text = `Load average ${reading.loadAverage} on ${reading.cores} cores when the ${stage.label} stage failed`
+  const { pressure } = reading
+  const stalls =
+    pressure === undefined
+      ? ''
+      : `, pressure cpu ${pressure.cpu.toFixed(1)}% memory ${pressure.memory.toFixed(1)}% io ${pressure.io.toFixed(1)}% over 10s,`
+  const text = `Load average ${reading.loadAverage} on ${reading.cores} cores${stalls} when the ${stage.label} stage failed`
   return {
     ...outcome,
     emissions: [...outcome.emissions, { kind: 'info', text }],