@erclx/canon 5.61.0 → 5.63.0

package/src/tooling/scan.ts

@@ -1,6 +1,13 @@
 import { existsSync, readFileSync } from 'node:fs'
 import { join } from 'node:path'
 import { resolveSurfacePath } from '@/roots/surface'
+import {
+  type Disposition,
+  hashFile,
+  readStamp,
+  stampedDispositions,
+  stampedHashes,
+} from '@/sync/stamp'
 import { mergeSections } from '@/tooling/gitignore'
 import {
   ancestorsFirst,
@@ -19,10 +26,14 @@ import {
 } from '@/tooling/package'
 import { isSubfolderTarget, isWithheldInSubfolder } from '@/tooling/subfolder'
 
+export type DriftCause = 'stale' | 'edited' | 'unattributed'
+
+/** `cause` is set on a drifted config alone. */
 export interface ConfigState {
   readonly rel: string
   readonly stack: string
   readonly state: 'new' | 'drifted' | 'matching'
+  readonly cause?: DriftCause
 }
 
 export interface SeedState {
@@ -41,9 +52,24 @@ export interface WithheldState {
   readonly present: boolean
 }
 
+/**
+ * A golden file the project declined or customized, which every write skips.
+ * `moved` is set on a customized config alone, true once the golden copy no
+ * longer hashes to the one the project took.
+ */
+export interface DispositionState {
+  readonly rel: string
+  readonly stack: string
+  readonly kind: 'config' | 'seed'
+  readonly disposition: Disposition
+  readonly present: boolean
+  readonly moved?: boolean
+}
+
 export interface ScanResult {
   readonly configs: readonly ConfigState[]
   readonly withheld: readonly WithheldState[]
+  readonly dispositions: readonly DispositionState[]
   readonly seeds: readonly SeedState[]
   readonly scripts: readonly ScriptState[]
   readonly deps: readonly DepState[]
@@ -53,6 +79,17 @@ export interface ScanResult {
   readonly totalChanges: number
 }
 
+/**
+ * Why a drifted config differs, which decides whether a write may replace it.
+ * A copy still at the hash the last write recorded is `stale`, since canon
+ * moved and the project did not. A copy off it is `edited`, and a copy with no
+ * recorded hash is `unattributed`, since nothing says who changed it.
+ */
+function driftCause(recorded: string | undefined, dest: string): DriftCause {
+  if (recorded === undefined) return 'unattributed'
+  return hashFile(dest) === recorded ? 'stale' : 'edited'
+}
+
 function isIdentical(a: string, b: string): boolean {
   if (!existsSync(b)) return false
   return readFileSync(a).equals(readFileSync(b))
@@ -72,11 +109,19 @@ function isIdentical(a: string, b: string): boolean {
  * GitHub reads only at the root moves to `withheld` and counts as no change.
  * The scope is read here so every caller of `scan` agrees without passing a
  * flag.
+ *
+ * A path the project declined or customized moves to `dispositions` ahead of
+ * the subfolder test, so it is listed once. The record is read here for the
+ * same reason as the scope.
  */
 export function scan(chain: readonly Manifest[], target: string): ScanResult {
   const isSubfolder = isSubfolderTarget(target)
+  const stamp = readStamp(target)
+  const held = stampedDispositions(stamp, 'tooling')
+  const recorded = stampedHashes(stamp, 'tooling')
   const configs: ConfigState[] = []
   const withheld: WithheldState[] = []
+  const dispositions: DispositionState[] = []
   const seenConfigs = new Set<string>()
 
   for (const manifest of chain) {
@@ -87,18 +132,38 @@ export function scan(chain: readonly Manifest[], target: string): ScanResult {
       const source = join(manifest.configsDir, rel)
       const dest = join(target, rel)
 
+      const entry = held[rel]
+      if (entry !== undefined) {
+        dispositions.push({
+          rel,
+          stack: manifest.name,
+          kind: 'config',
+          disposition: entry.disposition,
+          present: existsSync(dest),
+          ...(entry.disposition === 'customized'
+            ? { moved: hashFile(source) !== entry.base }
+            : {}),
+        })
+        continue
+      }
+
       if (isSubfolder && isWithheldInSubfolder(rel)) {
         withheld.push({ rel, stack: manifest.name, present: existsSync(dest) })
         continue
       }
 
-      const state = !existsSync(dest)
-        ? 'new'
-        : isIdentical(source, dest)
-          ? 'matching'
-          : 'drifted'
-
-      configs.push({ rel, stack: manifest.name, state })
+      if (!existsSync(dest)) {
+        configs.push({ rel, stack: manifest.name, state: 'new' })
+      } else if (isIdentical(source, dest)) {
+        configs.push({ rel, stack: manifest.name, state: 'matching' })
+      } else {
+        configs.push({
+          rel,
+          stack: manifest.name,
+          state: 'drifted',
+          cause: driftCause(recorded[rel], dest),
+        })
+      }
     }
   }
 
@@ -110,6 +175,18 @@ export function scan(chain: readonly Manifest[], target: string): ScanResult {
       if (seenSeeds.has(rel)) continue
       seenSeeds.add(rel)
 
+      const entry = held[rel]
+      if (entry !== undefined) {
+        dispositions.push({
+          rel,
+          stack: manifest.name,
+          kind: 'seed',
+          disposition: entry.disposition,
+          present: existsSync(resolveSurfacePath(target, rel)),
+        })
+        continue
+      }
+
       if (isSubfolder && isWithheldInSubfolder(rel)) {
         withheld.push({
           rel,
@@ -144,6 +221,7 @@ export function scan(chain: readonly Manifest[], target: string): ScanResult {
   const totalChanges =
     (newManifest ? 1 : 0) +
     configs.filter((entry) => entry.state !== 'matching').length +
+    dispositions.filter((entry) => entry.moved === true).length +
     seeds.filter((entry) => entry.state === 'missing').length +
     scripts.filter((entry) => entry.state !== 'matching').length +
     deps.filter((entry) => entry.state === 'missing').length +
@@ -152,6 +230,7 @@ export function scan(chain: readonly Manifest[], target: string): ScanResult {
   return {
     configs,
     withheld,
+    dispositions,
     seeds,
     scripts,
     deps,

package/src/tooling/stamp.ts

@@ -1,7 +1,19 @@
 import { existsSync } from 'node:fs'
 import { join } from 'node:path'
-import { readStamp, stampedChain, writeChainStamp } from '@/sync/stamp'
-import { isWholeStack, loadManifest, type Manifest } from '@/tooling/manifest'
+import {
+  type DomainHashes,
+  hashFile,
+  readStamp,
+  stampedChain,
+  stampedHashes,
+  writeChainStamp,
+} from '@/sync/stamp'
+import {
+  configFiles,
+  isWholeStack,
+  loadManifest,
+  type Manifest,
+} from '@/tooling/manifest'
 import { readPackage } from '@/tooling/package'
 
 /**
@@ -32,15 +44,47 @@ export async function recordToolingChain(
 ): Promise<string[] | undefined> {
   if (isWorkspaceRoot(target)) return undefined
 
-  const merged = mergeAddOns(
-    toolkitRoot,
-    stampedChain(readStamp(target), 'tooling'),
-    chain,
+  const stamp = readStamp(target)
+  const merged = mergeAddOns(toolkitRoot, stampedChain(stamp, 'tooling'), chain)
+  await writeChainStamp(
+    target,
+    { domain: 'tooling', toolkitRoot },
+    merged,
+    now,
+    matchedHashes(chain, target, stampedHashes(stamp, 'tooling')),
   )
-  await writeChainStamp(target, { domain: 'tooling', toolkitRoot }, merged, now)
   return merged
 }
 
+/**
+ * The golden hash of every config the target now matches, over the hashes an
+ * earlier run recorded. A config the target holds a different copy of keeps
+ * its previous hash, so a held edit still reads as edited on the next run
+ * rather than as a stale copy the write may replace.
+ */
+function matchedHashes(
+  chain: readonly Manifest[],
+  target: string,
+  previous: DomainHashes,
+): DomainHashes {
+  const hashes: Record<string, string> = { ...previous }
+  const seen = new Set<string>()
+
+  for (const manifest of chain) {
+    for (const rel of configFiles(manifest)) {
+      if (seen.has(rel)) continue
+      seen.add(rel)
+
+      const dest = join(target, rel)
+      if (!existsSync(dest)) continue
+      const golden = hashFile(join(manifest.configsDir, rel))
+      if (hashFile(dest) === golden) hashes[rel] = golden
+    }
+  }
+
+  return hashes
+}
+
 /**
  * An add-on stands alone beside a core chain, so syncing one must not displace
  * the chain it layers onto. Base extends nothing and still heads a core chain.

package/tooling/web/reference.md

@@ -45,6 +45,8 @@ The web layer covers the tooling shared across Vite + React, Astro, and Next.js.
 
 ## Screenshot cases
 
+The starter `e2e/home.spec.ts` is seeded once. Sync copies it into a project that has none and leaves it alone after, so grow it freely.
+
 - Edit the `CASES` in the seeded `e2e/capture/cases.ts`, one entry per output file naming a section, a theme, and a route, since sync overwrites the `e2e/screenshot.ts` harness
 - Move cases from `e2e/screenshot.ts` to `e2e/capture/cases.ts` before a sync, and set `EVIDENCE_ROOT = 'evidence'` to keep an existing baseline
 - Expect each case crossed with `VIEWPORTS`, written to `screenshots/<hostname>/<section>/<width>--<theme>.png`, so local and deployed runs stay apart
@@ -76,7 +78,7 @@ The web layer covers the tooling shared across Vite + React, Astro, and Next.js.
 
 - Expect the sweep under `screenshots/` to be ignored and only a flagged case's `EVIDENCE_ROOT` output tracked, so a target's first capture is the baseline it commits
 - Size a case's `sections` list against the frames each later change regenerates, since a case naming sections commits a folder per section
-- Run the capture after a surface changes, component files included, per `governance/rules/ui/surface-capture.md`, unless the production build strips the component out
+- Run the capture after a surface changes, component files included, per the `ui-craft` skill's capture reference, unless the production build strips the component out
 
 ## Screenshot scripts and workflows
 

package/governance/ledger/ui/copy.md

@@ -1,49 +0,0 @@
----
-title: UI copy rule ledger
-description: Sources for governance/rules/ui/copy.md, one row per bullet
----
-
-# UI copy rule ledger
-
-The field is content design, and the authority for researched interface copy is the GOV.UK Design System and its style guide.
-
-## Punctuation
-
-| Bullet                        | Source                                                                                                                                                                  | Read       |
-| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
-| No em dash or semicolon       | House choice: both read as generated copy in an interface, and a comma, a period, or a split sentence carries the same meaning in a shorter line                        | 2026-10-18 |
-| No trailing label punctuation | [Button](https://design-system.service.gov.uk/components/button/): every example label, such as "Start now", "Sign in", and "Continue", carries no trailing punctuation | 2026-10-18 |
-
-## Button copy
-
-| Bullet            | Source                                                                                                                                     | Read       |
-| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ---------- |
-| The action's verb | [Button](https://design-system.service.gov.uk/components/button/): "Write button text in sentence case, describing the action it performs" | 2026-10-18 |
-
-## Error messages
-
-| Bullet            | Source                                                                                                                                                                                                                                            | Read       |
-| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
-| Say how to fix it | [Error message](https://design-system.service.gov.uk/components/error-message/): "Describe what has happened and tell them how to fix it", and "'Enter your first name' is clearer, more direct and natural than 'First name must have an entry'" | 2026-10-18 |
-| Short and plain   | [Error message](https://design-system.service.gov.uk/components/error-message/): "The message must be in plain English, use positive language and get to the point", with no "technical jargon like 'form post error'"                            | 2026-10-18 |
-
-## Placeholder text
-
-| Bullet                         | Source                                                                                                                                                                                                                                           | Read       |
-| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- |
-| No placeholder, a hint instead | [Text input](https://design-system.service.gov.uk/components/text-input/): "Do not use placeholder text in place of a label, or for hints or examples", since "it vanishes when the user starts typing" and "not all screen readers read it out" | 2026-10-18 |
-
-## Declined
-
-Every bullet the rewrite removed or reshaped, grouped by why.
-
-### Contradicted by the source
-
-- Replaced "show format examples over instructions in placeholder text" with the hint text bullet, since GOV.UK says not to use a placeholder "for hints or examples".
-- Cut "reserve instructions for labels or helper text", which the new placeholder bullet now carries.
-
-### Merged or reworded
-
-- Merged the imperative verb and padded phrasing bullets. The `Save` over `Save changes` example went, since GOV.UK adds words "to better describe the action".
-- Merged "keep messages short and actionable" and "one sentence maximum" into the plain language bullet.
-- Reworded the error example to `Enter an email address`, the instruction form GOV.UK prefers over a description.

package/governance/ledger/ui/design-taste.md

@@ -1,19 +0,0 @@
----
-title: Design taste rule ledger
-description: Sources for governance/rules/ui/design-taste.md, one row per bullet
----
-
-# Design taste rule ledger
-
-The rule is a pointer to the `design-taste` skill, which carries its own sources, so both rows are house choices naming the bug the pointer prevents.
-
-## Authority
-
-| Bullet                     | Source                                                                                                                                                                     | Read       |
-| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
-| Load the skill             | House choice: a style edit made without the layer order or the coherence locks reaches for a model's defaults, and a second copy of them in the rule drifts from the skill | 2026-10-18 |
-| Report an unresolved skill | House choice: the rule ships with the CLI and the skill with the plugin, so a project holding governance alone would otherwise proceed silently without it                 | 2026-10-18 |
-
-## Declined
-
-The rewrite kept both bullets unchanged.

package/governance/ledger/ui/interface-casing.md

@@ -1,47 +0,0 @@
----
-title: Interface casing rule ledger
-description: Sources for governance/rules/ui/interface-casing.md, one row per bullet
----
-
-# Interface casing rule ledger
-
-The field is content design, and the authority is the GOV.UK style guide, which sets sentence case for every heading and title. The label count and the scope bullets are canon's own.
-
-## Sentence case
-
-| Bullet                   | Source                                                                                                                                                      | Read       |
-| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
-| Sentence case            | [A to Z of GOV.UK style](https://www.gov.uk/guidance/style-guide/a-to-z-of-gov-uk-style): "Always use sentence case, even in page titles and service names" | 2026-10-18 |
-| Proper nouns keep casing | [A to Z of GOV.UK style](https://www.gov.uk/guidance/style-guide/a-to-z-of-gov-uk-style): "The exceptions to this are proper nouns"                         | 2026-10-18 |
-
-## Uppercase labels
-
-| Bullet      | Source                                                                                                                                                       | Read       |
-| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- |
-| Label count | House choice: an uppercase eyebrow over every section is the template tell `design-taste` reaches past, and the count makes the cap checkable against a page | 2026-10-18 |
-
-## Where it applies
-
-| Bullet                 | Source                                                                                                           | Read       |
-| ---------------------- | ---------------------------------------------------------------------------------------------------------------- | ---------- |
-| Copy outside the globs | House choice: a locale file holds the same rendered strings, so title case there ships with no rule firing on it | 2026-10-18 |
-
-## Overriding
-
-| Bullet              | Source                                                                                                                                        | Read       |
-| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
-| Depart where needed | House choice: an acronym or brand mark lowered to sentence case misnames it, the same reason GOV.UK keeps "proper nouns" as its one exception | 2026-10-18 |
-
-## Declined
-
-Every bullet the rewrite removed or reshaped, grouped by why.
-
-### Cut without a check
-
-- Cut "treat the count as a judgment, since a glob cannot check it", which tells a session nothing it can verify against a line.
-
-### Merged or reworded
-
-- Folded "treat title case on every heading as a template tell" into the sentence case bullet as its reason.
-- Shortened the uppercase label bullet under 200 characters, keeping the `ceil(sections / 3)` count and the delete remedy.
-- Reworded the scope bullet from a statement of what the rule covers to the directive a session can act on.

package/governance/ledger/ui/keyboard.md

@@ -1,68 +0,0 @@
----
-title: Keyboard rule ledger
-description: Sources for governance/rules/ui/keyboard.md, one row per bullet
----
-
-# Keyboard rule ledger
-
-The field is web accessibility, and the authorities are the W3C, through WCAG 2.2 and the ARIA Authoring Practices Guide, MDN for CSS behavior, and the platform guidelines from Apple and Android for native targets. Every bullet here was split from `a11y.md`.
-
-## Focus styles
-
-| Bullet                                   | Source                                                                                                                                                                                                                                    | Read                 |
-| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- |
-| One project focus ring                   | House choice: per-component focus styles drift apart, and `canon inventory` reports the ring by computed style, so a one-off treatment shows as its own row                                                                               | 2026-10-18           |
-| No outline removal without a replacement | [outline](https://developer.mozilla.org/en-US/docs/Web/CSS/outline): "Assigning outline a value of 0 or none will remove the browser's default focus style. If an element can be interacted with it must have a visible focus indicator." | 2026-10-18           |
-| 3:1 ring in every theme                  | [Understanding Non-text Contrast](https://www.w3.org/WAI/WCAG22/Understanding/non-text-contrast.html): visual information needed to identify a state needs "a contrast ratio of at least 3:1 against adjacent color(s)"                   | 2026-10-18, WCAG 2.2 |
-
-## Keyboard operation
-
-| Bullet                         | Source                                                                                                                                                                                                                               | Read                 |
-| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------- |
-| Escape closes                  | [Dialog (modal) pattern](https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/): "Escape : Closes the dialog", and the [combobox pattern](https://www.w3.org/WAI/ARIA/apg/patterns/combobox/) gives Escape the same job for a popup | 2026-10-18, APG      |
-| No bare character shortcut     | [Understanding Character Key Shortcuts](https://www.w3.org/WAI/WCAG22/Understanding/character-key-shortcuts.html): a character-only shortcut needs a way to "Turn off", to "Remap", or to be "Active only on focus"                  | 2026-10-18, WCAG 2.2 |
-| Drag has a single-pointer path | [Understanding Dragging Movements](https://www.w3.org/WAI/WCAG22/Understanding/dragging-movements.html): "For any action that involves dragging, provide a simple pointer alternative"                                               | 2026-10-18, WCAG 2.2 |
-
-## Composite widgets
-
-| Bullet                       | Source                                                                                                                                                                                                                                                             | Read            |
-| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------- |
-| One item in the tab sequence | [Developing a keyboard interface](https://www.w3.org/WAI/ARIA/apg/practices/keyboard-interface/): "the tab sequence should include only one focusable element of a composite UI component", managed by "a roving tabindex" or "the aria-activedescendant property" | 2026-10-18, APG |
-| Combobox keys                | [Combobox pattern](https://www.w3.org/WAI/ARIA/apg/patterns/combobox/): "Down Arrow : If the popup is available, moves focus into the popup", Enter accepts the focused option, and "Escape : Dismisses the popup if it is visible"                                | 2026-10-18, APG |
-
-## Focus management
-
-| Bullet                       | Source                                                                                                                                                                                                                                 | Read                 |
-| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- |
-| Focus into a dialog and back | [Dialog (modal) pattern](https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/): "When a dialog opens, focus moves to an element inside the dialog", and "When a dialog closes, focus returns to the element that invoked the dialog" | 2026-10-18, APG      |
-| Focus never covered          | [Understanding Focus Not Obscured (Minimum)](https://www.w3.org/WAI/WCAG22/Understanding/focus-not-obscured-minimum.html): "the component is not entirely hidden due to author-created content"                                        | 2026-10-18, WCAG 2.2 |
-
-## Pointer targets
-
-| Bullet              | Source                                                                                                                                                                                                                                                                                                                              | Read                 |
-| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- |
-| 24 by 24 on the web | [Understanding Target Size (Minimum)](https://www.w3.org/WAI/WCAG22/Understanding/target-size-minimum.html): "at least 24 by 24 CSS pixels", except where "a 24 CSS pixel diameter circle is centered on the bounding box of each" and "the circles do not intersect"                                                               | 2026-10-18, WCAG 2.2 |
-| Native figures      | [Apple accessibility guidelines](https://developer.apple.com/design/human-interface-guidelines/accessibility): a default "44x44 pt" control size on iOS and iPadOS, and [Android accessibility](https://developer.android.com/guide/topics/ui/accessibility/apps): "a focusable area, or touch target size , of at least 48dpx48dp" | 2026-10-18           |
-
-## Declined
-
-Every bullet the split removed or reshaped, grouped by why.
-
-### Browser defaults
-
-- Cut the Tab, Enter, and Space bullets of the old keyboard model. A native element does each by default, and `a11y.md` already sends a session to the native element.
-
-### Rewritten to what the source says
-
-- Replaced "do not introduce non-standard key bindings" with the character key bullet. No reviewer can check "non-standard", and the criterion names the binding that breaks.
-- Narrowed "move focus into any overlay, popover, or dialog on open" to a dialog. The APG moves focus into a modal dialog, and a non-modal popover such as a tooltip leaves focus on its trigger.
-
-### Cut without a source or a bug class
-
-- Cut "never move focus on hover", a convention Claude already follows that no cited page takes a side on.
-
-### Merged or reworded
-
-- Merged "arrow keys navigate within composite widgets" into the roving `tabindex` bullet, which names the arrow keys.
-- Merged "Escape cancels in-progress edits" into the Escape bullet, and took in the inline confirmation case from the `ux-completeness.md` rewrite so the Escape behavior has one copy.
-- Reworded the combobox bullet to the pattern's own keys, dropping "typing filters", which the APG leaves to each autocomplete behavior.

package/governance/ledger/ui/link-behavior.md

@@ -1,29 +0,0 @@
----
-title: Link behavior rule ledger
-description: Sources for governance/rules/ui/link-behavior.md, one row per bullet
----
-
-# Link behavior rule ledger
-
-The field is interaction design, and the authority is the Nielsen Norman Group's research on new windows and tabs.
-
-## Default target
-
-| Bullet                      | Source                                                                                                                                                                                                                                                                                           | Read       |
-| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- |
-| Same tab, new tab by task   | [Opening links in new browser windows and tabs](https://www.nngroup.com/articles/new-browser-windows-and-tabs/): "There is generally one good reason to open a page in a new window, and that is that the user will need to refer to that content in order to complete a task in another window" | 2026-10-18 |
-| No blanket external new tab | [Opening links in new browser windows and tabs](https://www.nngroup.com/articles/new-browser-windows-and-tabs/): "New windows or tabs prevent the use of the Back button" and "can cause disorientation"                                                                                         | 2026-10-18 |
-
-## mailto: links
-
-| Bullet             | Source                                                                                                                                       | Read       |
-| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
-| `mailto:` same tab | House choice: the link opens the mail client and leaves the page in place, so `target="_blank"` only adds an empty tab the person must close | 2026-10-18 |
-
-## Declined
-
-Every bullet the rewrite removed or reshaped, grouped by why.
-
-### Rewritten to what the source says
-
-- Reworded the new tab exception from "a destination that would discard in-progress work" to a page the person must consult while finishing a task, the one reason NN/g names.

package/governance/rules/ui/copy.md

@@ -1,28 +0,0 @@
----
-description: Enforce UI copy and text standards for rendered strings in components
-paths:
-  - '**/*.tsx'
-  - '**/*.jsx'
-  - '**/*.astro'
-  - '**/*.html'
----
-
-# UI copy standards
-
-## Punctuation
-
-- Write no em dash (`—`) or semicolon in rendered copy. Use a comma or a period, or restructure the sentence.
-- Add no trailing punctuation to a button label or a short action string.
-
-## Button copy
-
-- Label a button with the verb of the action it performs, such as `Save` or `Delete`, never with filler such as `Click to delete`.
-
-## Error messages
-
-- Tell the person how to fix the error, such as `Enter an email address` over `Email is invalid`.
-- Keep an error message to one short sentence in plain language, with no technical jargon or error codes.
-
-## Placeholder text
-
-- Never use placeholder text as a label, a hint, or an example. Put a format example such as `name@example.com` in hint text under the label.

package/governance/rules/ui/design-taste.md

@@ -1,18 +0,0 @@
----
-description: Route edits that decide how a surface looks to the design-taste skill for the layer ordering, the coherence locks, and the defaults a model reaches for
-paths:
-  - '**/*.tsx'
-  - '**/*.jsx'
-  - '**/*.astro'
-  - '**/*.html'
-  - '**/*.css'
-  - '**/*.scss'
-  - 'canon/DESIGN.md'
----
-
-# Design taste standards
-
-## Authority
-
-- Load the `canon:design-taste` skill for which design decision settles first, what must stay constant across a surface, and the defaults to reach past. It is the single source for all three.
-- Report it rather than proceeding silently when the skill does not resolve. It ships with the plugin and this rule ships with the CLI, so a project that installed governance alone does not have it.

package/governance/rules/ui/interface-casing.md

@@ -1,29 +0,0 @@
----
-description: Enforce casing for interface text in markup, MDX, and content modules, where copy lives in a content folder
-paths:
-  - '**/*.tsx'
-  - '**/*.jsx'
-  - '**/*.astro'
-  - '**/*.html'
-  - '**/*.mdx'
-  - '**/content/**/*.ts'
----
-
-# Interface casing standards
-
-## Sentence case
-
-- Use sentence case for rendered headings, labels, nav items, tab titles, and dialog titles, since title case on every heading reads as a template default.
-- Keep the original casing of a proper noun or product name, such as `GitHub`, `macOS`, or `TypeScript`.
-
-## Uppercase labels
-
-- Keep small uppercase labels above headings to `ceil(sections / 3)`, the first screen counting as one. Delete the extra labels, since position already names a section.
-
-## Where it applies
-
-- Apply the same casing to interface copy kept outside the globs, such as a locale file, which this rule never fires on.
-
-## Overriding
-
-- Depart from sentence case only where the case needs it, such as an acronym, a brand mark, or a set-in-caps identity the design chose on purpose.

package/governance/rules/ui/link-behavior.md

@@ -1,19 +0,0 @@
----
-description: Enforce the same-tab default for an outbound link and for a mail link
-paths:
-  - '**/*.tsx'
-  - '**/*.jsx'
-  - '**/*.astro'
-  - '**/*.html'
----
-
-# Link behavior standards
-
-## Default target
-
-- Open a link in the same tab. Reserve `target="_blank"` for a page the person must consult while finishing a task in the current one.
-- Never add `target="_blank"` as a default for every external link.
-
-## mailto: links
-
-- Open a `mailto:` link in the same tab. It hands off to the mail client rather than replacing the page, so a new tab leaves an empty tab behind.