{
  "$schema": "https://pauta-project.dev/4.5.0/rules.schema.json",
  "name": "Pauta",
  "edition": "4.5.0",
  "date": "2026-11-08",
  "url": "https://pauta-project.dev/4.5.0/",
  "levels": {
    "MUST": "A release blocker for a new app.",
    "SHOULD": "Expected unless the app has a stated reason.",
    "MAY": "A pattern worth copying when the app grows into it."
  },
  "checks": {
    "code": "Verify by reading or searching the app's source, as the check says.",
    "test": "A named test holds the rule; confirm the app has it, or its equivalent, and that it runs in the build.",
    "by hand": "Needs the running app; source alone can't settle it."
  },
  "statuses": {
    "fail": "Not met, and pauta.json records no exception for it. A finding; a failed MUST blocks a release.",
    "manual": "Checked by hand: source can't settle it, so a person checks it in the running app.",
    "pending": "Not met; pauta.json records it as pending, with an issue.",
    "deviation": "A SHOULD the app does differently on purpose; pauta.json records it, with a decision record.",
    "not-applicable": "The rule reads as applying to every app, but its subject does not exist in this one; pauta.json records it.",
    "app-only": "A template only: the rule needs what each app made from it has of its own; pauta.json records it.",
    "limited": "The rule covers only apps with a feature this one lacks (its text, its page's or section's appliesTo, or the rule it details says so). Needs no exception.",
    "pass": "Met."
  },
  "audit": "https://pauta-project.dev/4.5.0/audit.schema.json",
  "pages": [
    {
      "slug": "principles",
      "title": "Principles",
      "prefix": null,
      "url": "https://pauta-project.dev/4.5.0/principles/",
      "markdown": "https://pauta-project.dev/4.5.0/principles.md",
      "description": "The thirteen rules every other page follows from: ten for the people using the apps, three for the people building them.",
      "appliesTo": null,
      "rules": 0
    },
    {
      "slug": "same-on-every-os",
      "title": "Same on every OS",
      "prefix": "OS",
      "url": "https://pauta-project.dev/4.5.0/same-on-every-os/",
      "markdown": "https://pauta-project.dev/4.5.0/same-on-every-os.md",
      "description": "The one list of places where Windows, macOS and Linux may differ, and the rules that keep everything else the same.",
      "appliesTo": null,
      "rules": 3
    },
    {
      "slug": "checklist",
      "title": "New app checklist",
      "prefix": null,
      "url": "https://pauta-project.dev/4.5.0/checklist/",
      "markdown": "https://pauta-project.dev/4.5.0/checklist.md",
      "description": "Every MUST a new app meets before its first release, and the SHOULDs worth doing first, grouped by area.",
      "appliesTo": null,
      "rules": 0
    },
    {
      "slug": "conformance",
      "title": "Conformance",
      "prefix": "PAUTA",
      "url": "https://pauta-project.dev/4.5.0/conformance/",
      "markdown": "https://pauta-project.dev/4.5.0/conformance.md",
      "description": "How an app says which edition of Pauta it implements and how fully it conforms, and how it records the rules it does not meet: not applicable, a deliberate deviation, or work still pending.",
      "appliesTo": null,
      "rules": 16
    },
    {
      "slug": "coding-agents",
      "title": "Coding agents and LLMs",
      "prefix": null,
      "url": "https://pauta-project.dev/4.5.0/coding-agents/",
      "markdown": "https://pauta-project.dev/4.5.0/coding-agents.md",
      "description": "What every edition serves to coding agents, how an app's AGENTS.md points its agent at the edition it is built to, and how to have an agent build a feature to the rules or audit an app against them.",
      "appliesTo": null,
      "rules": 0
    },
    {
      "slug": "platform",
      "title": "Platform baseline",
      "prefix": "PLAT",
      "url": "https://pauta-project.dev/4.5.0/platform/",
      "markdown": "https://pauta-project.dev/4.5.0/platform.md",
      "description": "JDK, JavaFX, AtlantaFX, NullAway, Maven Wrapper, tests and coverage: the stack every app shares.",
      "appliesTo": null,
      "rules": 13
    },
    {
      "slug": "repository",
      "title": "Repository documents",
      "prefix": "REPO",
      "url": "https://pauta-project.dev/4.5.0/repository/",
      "markdown": "https://pauta-project.dev/4.5.0/repository.md",
      "description": "README, CHANGELOG, LICENSE, NOTICE, AGENTS.md and the rest of the files every repository carries.",
      "appliesTo": null,
      "rules": 10
    },
    {
      "slug": "documentation",
      "title": "Documentation",
      "prefix": "DOCS",
      "url": "https://pauta-project.dev/4.5.0/documentation/",
      "markdown": "https://pauta-project.dev/4.5.0/documentation.md",
      "description": "User docs on the app's website, developer docs in docs/, and the Help menu that opens them. Every app documents itself, and the docs change in the same PR as the code.",
      "appliesTo": null,
      "rules": 18
    },
    {
      "slug": "quality",
      "title": "Code quality gates",
      "prefix": "QUAL",
      "url": "https://pauta-project.dev/4.5.0/quality/",
      "markdown": "https://pauta-project.dev/4.5.0/quality.md",
      "description": "NullAway, coverage floors and the guard tests that pay for themselves across the family.",
      "appliesTo": null,
      "rules": 12
    },
    {
      "slug": "performance",
      "title": "Performance",
      "prefix": "PERF",
      "url": "https://pauta-project.dev/4.5.0/performance/",
      "markdown": "https://pauta-project.dev/4.5.0/performance.md",
      "description": "Keep the JavaFX application thread free, coalesce work, bound memory, and measure: the rules that keep every app responsive.",
      "appliesTo": null,
      "rules": 22
    },
    {
      "slug": "keyboard",
      "title": "Keyboard first",
      "prefix": "KBD",
      "url": "https://pauta-project.dev/4.5.0/keyboard/",
      "markdown": "https://pauta-project.dev/4.5.0/keyboard.md",
      "description": "Commands, the Command Palette, keymaps, focus and accessibility.",
      "appliesTo": null,
      "rules": 17
    },
    {
      "slug": "accessibility",
      "title": "Accessibility",
      "prefix": "ACC",
      "url": "https://pauta-project.dev/4.5.0/accessibility/",
      "markdown": "https://pauta-project.dev/4.5.0/accessibility.md",
      "description": "What a screen reader, a keyboard-only user and a user who turns motion off need from every app, and where each is a rule.",
      "appliesTo": null,
      "rules": 7
    },
    {
      "slug": "window-shell",
      "title": "Window shell",
      "prefix": "WIN",
      "url": "https://pauta-project.dev/4.5.0/window-shell/",
      "markdown": "https://pauta-project.dev/4.5.0/window-shell.md",
      "description": "Status bar, themes, title bar, dialogs, Welcome, About, window state and zoom.",
      "appliesTo": null,
      "rules": 7
    },
    {
      "slug": "icons-and-color",
      "title": "Icons and color",
      "prefix": "ICON",
      "url": "https://pauta-project.dev/4.5.0/icons-and-color/",
      "markdown": "https://pauta-project.dev/4.5.0/icons-and-color.md",
      "description": "Inter and JetBrains Mono, the Caret & Ink palette, state colors that mean one thing, themes, and the two icon families.",
      "appliesTo": null,
      "rules": 21
    },
    {
      "slug": "toolbars-and-tooltips",
      "title": "Toolbars and tooltips",
      "prefix": "TBAR",
      "url": "https://pauta-project.dev/4.5.0/toolbars-and-tooltips/",
      "markdown": "https://pauta-project.dev/4.5.0/toolbars-and-tooltips.md",
      "description": "Icon-only buttons that have a name, groups by spacing, one chrome band, the customizable toolbar, and tooltips that share the menus' card.",
      "appliesTo": null,
      "rules": 12
    },
    {
      "slug": "tabs-and-panels",
      "title": "Tabs and tool panels",
      "prefix": "TABS",
      "url": "https://pauta-project.dev/4.5.0/tabs-and-panels/",
      "markdown": "https://pauta-project.dev/4.5.0/tabs-and-panels.md",
      "description": "The tab strip and its states, reorder and reopen, and the tool panels that dock around the editor.",
      "appliesTo": null,
      "rules": 23
    },
    {
      "slug": "menus",
      "title": "Menus",
      "prefix": "MENU",
      "url": "https://pauta-project.dev/4.5.0/menus/",
      "markdown": "https://pauta-project.dev/4.5.0/menus.md",
      "description": "The menu bar and right-click menus: an icon and the chord on every row, one font, one menu at a time, and a press anywhere else closes it.",
      "appliesTo": null,
      "rules": 16
    },
    {
      "slug": "tray-and-background",
      "title": "Tray and background",
      "prefix": "TRAY",
      "url": "https://pauta-project.dev/4.5.0/tray-and-background/",
      "markdown": "https://pauta-project.dev/4.5.0/tray-and-background.md",
      "description": "An app that keeps working behind a tray icon: the icon and its menu, close to tray, start at login, desktop notifications.",
      "appliesTo": "an app whose work goes on without its window, as Torrenta's, Modula's and nux's does. For the others (Editora, Termina, Mirada) a tray is MAY, none has one, and no rule on this page applies.",
      "rules": 14
    },
    {
      "slug": "settings",
      "title": "Settings",
      "prefix": "SET",
      "url": "https://pauta-project.dev/4.5.0/settings/",
      "markdown": "https://pauta-project.dev/4.5.0/settings.md",
      "description": "The Settings window with search, live apply, versioned config and Git/GitHub sync.",
      "appliesTo": null,
      "rules": 20
    },
    {
      "slug": "diagnostics",
      "title": "Diagnostics and support",
      "prefix": "DIAG",
      "url": "https://pauta-project.dev/4.5.0/diagnostics/",
      "markdown": "https://pauta-project.dev/4.5.0/diagnostics.md",
      "description": "Message Log, Debug Log, update notification, Report a Problem, Doctor and crash recovery.",
      "appliesTo": null,
      "rules": 8
    },
    {
      "slug": "command-line",
      "title": "Command line and launch",
      "prefix": "CLI",
      "url": "https://pauta-project.dev/4.5.0/command-line/",
      "markdown": "https://pauta-project.dev/4.5.0/command-line.md",
      "description": "The flags every app accepts and the single-instance hand-off.",
      "appliesTo": null,
      "rules": 10
    },
    {
      "slug": "i18n",
      "title": "Internationalization",
      "prefix": "INTL",
      "url": "https://pauta-project.dev/4.5.0/i18n/",
      "markdown": "https://pauta-project.dev/4.5.0/i18n.md",
      "description": "Six languages as the floor, and the rules that keep every catalog in step.",
      "appliesTo": null,
      "rules": 11
    },
    {
      "slug": "templates/command-palette",
      "title": "Command Palette",
      "prefix": "PAL",
      "url": "https://pauta-project.dev/4.5.0/templates/command-palette/",
      "markdown": "https://pauta-project.dev/4.5.0/templates/command-palette.md",
      "description": "The family's command palette: a 620 px in-scene card that finds and runs any command from the keyboard.",
      "appliesTo": null,
      "rules": 8
    },
    {
      "slug": "templates/quick-open",
      "title": "QuickOpen picker",
      "prefix": "QOPEN",
      "url": "https://pauta-project.dev/4.5.0/templates/quick-open/",
      "markdown": "https://pauta-project.dev/4.5.0/templates/quick-open.md",
      "description": "The family's list picker: the palette card with a title and a prompt, for choosing one thing from a list by typing.",
      "appliesTo": null,
      "rules": 12
    },
    {
      "slug": "templates/welcome",
      "title": "Welcome page",
      "prefix": "WELC",
      "url": "https://pauta-project.dev/4.5.0/templates/welcome/",
      "markdown": "https://pauta-project.dev/4.5.0/templates/welcome.md",
      "description": "The family's start page: Start actions with their chords, recent items a digit away, Customize and Help, shown when there is nothing to restore.",
      "appliesTo": null,
      "rules": 11
    },
    {
      "slug": "templates/about",
      "title": "About window",
      "prefix": "ABOUT",
      "url": "https://pauta-project.dev/4.5.0/templates/about/",
      "markdown": "https://pauta-project.dev/4.5.0/templates/about.md",
      "description": "The family's About panel: identity, update status, license, links and copyable environment details.",
      "appliesTo": null,
      "rules": 9
    },
    {
      "slug": "templates/pauta-window",
      "title": "Pauta window",
      "prefix": "PWIN",
      "url": "https://pauta-project.dev/4.5.0/templates/pauta-window/",
      "markdown": "https://pauta-project.dev/4.5.0/templates/pauta-window.md",
      "description": "The window that shows which edition of Pauta the app implements, how fully it conforms, and every exception it records, opened from About, the Help menu and the Command Palette.",
      "appliesTo": null,
      "rules": 8
    },
    {
      "slug": "templates/confirm-dialog",
      "title": "Confirm dialog",
      "prefix": "CONF",
      "url": "https://pauta-project.dev/4.5.0/templates/confirm-dialog/",
      "markdown": "https://pauta-project.dev/4.5.0/templates/confirm-dialog.md",
      "description": "The family's question before a destructive action: it names the thing, the button names the action in red, and Escape cancels.",
      "appliesTo": null,
      "rules": 12
    },
    {
      "slug": "templates/find-bar",
      "title": "Find bar",
      "prefix": "FIND",
      "url": "https://pauta-project.dev/4.5.0/templates/find-bar/",
      "markdown": "https://pauta-project.dev/4.5.0/templates/find-bar.md",
      "description": "The family's find bar: in-scene, incremental, with a count; Enter and Shift+Enter step, Escape gives the keyboard back.",
      "appliesTo": null,
      "rules": 15
    },
    {
      "slug": "templates/message-log",
      "title": "Message Log",
      "prefix": "MLOG",
      "url": "https://pauta-project.dev/4.5.0/templates/message-log/",
      "markdown": "https://pauta-project.dev/4.5.0/templates/message-log.md",
      "description": "The family's Message Log: the session's status-bar messages, newest first, opened from the status bar.",
      "appliesTo": null,
      "rules": 6
    },
    {
      "slug": "templates/settings-sync",
      "title": "Settings Sync",
      "prefix": "SYNC",
      "url": "https://pauta-project.dev/4.5.0/templates/settings-sync/",
      "markdown": "https://pauta-project.dev/4.5.0/templates/settings-sync.md",
      "description": "The family's Sync settings page: keep user data the same on every computer through a Git repository the user owns.",
      "appliesTo": "an app with user data worth carrying between computers ([SYNC-01](https://pauta-project.dev/4.5.0/templates/settings-sync/#sync-01)).",
      "rules": 2
    },
    {
      "slug": "release",
      "title": "Packaging, signing and release",
      "prefix": "REL",
      "url": "https://pauta-project.dev/4.5.0/release/",
      "markdown": "https://pauta-project.dev/4.5.0/release.md",
      "description": "jpackage, JReleaser, the five-target matrix, macOS/Linux/Windows signing and CI.",
      "appliesTo": null,
      "rules": 29
    },
    {
      "slug": "family/matrix",
      "title": "Feature matrix",
      "prefix": null,
      "url": "https://pauta-project.dev/4.5.0/family/matrix/",
      "markdown": "https://pauta-project.dev/4.5.0/family/matrix.md",
      "description": "Which of the six apps has which platform piece, release step and feature.",
      "appliesTo": null,
      "rules": 0
    },
    {
      "slug": "family/shared-features",
      "title": "Shared features",
      "prefix": null,
      "url": "https://pauta-project.dev/4.5.0/family/shared-features/",
      "markdown": "https://pauta-project.dev/4.5.0/family/shared-features.md",
      "description": "Features two or more apps already share that belong in the guideline.",
      "appliesTo": null,
      "rules": 0
    },
    {
      "slug": "family/gaps",
      "title": "Gaps per app",
      "prefix": null,
      "url": "https://pauta-project.dev/4.5.0/family/gaps/",
      "markdown": "https://pauta-project.dev/4.5.0/family/gaps.md",
      "description": "What each app still misses against this guide.",
      "appliesTo": null,
      "rules": 0
    }
  ],
  "rules": [
    {
      "id": "OS-01",
      "level": "MUST",
      "page": "same-on-every-os",
      "pageTitle": "Same on every OS",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/same-on-every-os/#os-01",
      "text": "Every command, setting and window exists on Windows, macOS and Linux, with the same default. Where the OS can't do what one asks, it stays where it is, disabled, and says why; it is never hidden. The table above is the only exception.",
      "why": "a user who moves to another OS looks for a feature where they left it. A missing row looks like a different app; a disabled one with a reason explains itself.",
      "check": {
        "kind": "code",
        "text": "no command, menu row or settings row is registered or added inside an OS check, and no default in the settings model depends on the OS. A row the OS can't serve calls `setDisable` and carries its reason ([KBD-04](https://pauta-project.dev/4.5.0/keyboard/#kbd-04) for a command)."
      },
      "reference": "Editora [`ui/SettingsWindow.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/SettingsWindow.java) (the extended-window row, disabled on macOS \"rather than hidden, so its note still explains why\")."
    },
    {
      "id": "OS-02",
      "level": "MUST",
      "page": "same-on-every-os",
      "pageTitle": "Same on every OS",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/same-on-every-os/#os-02",
      "text": "One class answers which OS the app runs on (`Os`, with `isWindows()`, `isMac()` and `isLinux()`), and no other class reads the `os.name` property.",
      "why": "checks scattered through the code are how apps drift apart on one OS without anyone choosing it. In one class, every difference can be found with one search, and a test can run the app as any OS ([OS-03](https://pauta-project.dev/4.5.0/same-on-every-os/#os-03)).",
      "check": {
        "kind": "code",
        "text": "`grep -rln '\"os.name\"' src/main/java` lists one file."
      },
      "reference": "no app yet. Every app reads `os.name` in several classes, Editora in about fifty; Editora's [`process/DesktopActions.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/process/DesktopActions.java) has the `Os` enum to start from."
    },
    {
      "id": "OS-03",
      "level": "SHOULD",
      "page": "same-on-every-os",
      "pageTitle": "Same on every OS",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/same-on-every-os/#os-03",
      "text": "Tests can run as any OS: the `Os` class takes an override, and one test asserts that the command ids, the menu bar's rows and the settings pages are the same for Windows, macOS and Linux.",
      "why": "CI runs the FX tests on one or two OSes ([REL-20](https://pauta-project.dev/4.5.0/release/#rel-20)); with the override, the comparison runs on every pull request on Linux alone.",
      "check": {
        "kind": "test",
        "text": "a test sets each OS in turn through the override and compares the three lists."
      },
      "reference": "no app yet. Editora's [`KeymapsTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/command/KeymapsTest.java) (`guiKeymapsBindSameCommandSetOnBothPlatforms`) does it for the keymaps."
    },
    {
      "id": "PAUTA-01",
      "level": "MUST",
      "page": "conformance",
      "pageTitle": "Conformance",
      "section": "Complete, Core and Partial",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/conformance/#pauta-01",
      "text": "Every app implements Pauta: it names one edition (the `pauta.version` of [ABOUT-08](https://pauta-project.dev/4.5.0/templates/about/#about-08)) and states its conformance, Complete, Core or Partial, as defined above.",
      "why": "an app that is in the family answers to these rules; saying which ones, and how far, is the first of them.",
      "check": {
        "kind": "code",
        "text": "`pom.xml` defines `pauta.version` and `src/main/resources/com/<app>/pauta.json` exists."
      },
      "reference": "The [app template](https://github.com/adriandeleon/adl-desktop-app-template)'s [`pom.xml`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/pom.xml) (`pauta.version`) and [`pauta.json`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/main/resources/com/example/app/pauta.json)."
    },
    {
      "id": "PAUTA-02",
      "level": "MUST",
      "page": "conformance",
      "pageTitle": "Conformance",
      "section": "Complete, Core and Partial",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/conformance/#pauta-02",
      "text": "The conformance is computed, never stored: one pure helper reads the exceptions and returns Partial when any MUST is pending, Core when any SHOULD is pending, and Complete otherwise. About, the Pauta window and the docs page take it from there; the README, which can't call the helper, is held to it by a test (PAUTA-15).",
      "why": "[*One source of truth for each fact*](https://pauta-project.dev/4.5.0/principles/#for-the-people-building-them). A conformance typed in by hand stays \"Complete\" after a pending exception is added.",
      "check": {
        "kind": "test",
        "text": "a unit test of the helper (`PautaConformance`, or the app's equivalent) covers all three and shows that deviation, not-applicable and app-only entries leave the result alone."
      },
      "reference": "The [app template](https://github.com/adriandeleon/adl-desktop-app-template)'s [`PautaConformance.java`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/main/java/com/example/app/PautaConformance.java) (`of`, `conformance`), tested by [`PautaConformanceTest`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/test/java/com/example/app/PautaConformanceTest.java)."
    },
    {
      "id": "PAUTA-03",
      "level": "MUST",
      "page": "conformance",
      "pageTitle": "Conformance",
      "section": "Complete, Core and Partial",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/conformance/#pauta-03",
      "text": "A new app's first release is at Core or Complete: the [New app checklist](https://pauta-project.dev/4.5.0/checklist/)'s MUSTs are release blockers, and recording one as pending does not lift that. A template repository is never released as an app, so this rule is for the app made from it and the template records no entry for it.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "the About window of the app's first release says Core or Complete."
      },
      "reference": "no app yet."
    },
    {
      "id": "PAUTA-04",
      "level": "MUST",
      "page": "conformance",
      "pageTitle": "Conformance",
      "section": "Exceptions",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/conformance/#pauta-04",
      "text": "Every MUST and SHOULD of the edition that the app does not meet has an exception, and every exception names a rule the app does not meet. An unmet rule with no entry is a failed audit, not an exception; an entry for a rule the app now meets is removed in the same change that meets it. A rule checked by hand counts like any other: someone checks it in the running app before the conformance is claimed, and one that fails is pending.",
      "why": "[*Never claim what is not true*](https://pauta-project.dev/4.5.0/principles/#for-the-people-using-the-apps). The list is the app's claim; it has to be whole and current.",
      "check": {
        "kind": "by hand",
        "text": "audit the app against its edition ([Coding agents and LLMs](https://pauta-project.dev/4.5.0/coding-agents/#audit-an-app)): no MUST or SHOULD is `fail`, every `manual` result has been checked by a person, and no result reports an entry for a rule that passes."
      },
      "reference": "The [app template](https://github.com/adriandeleon/adl-desktop-app-template)'s [`pauta.json`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/main/resources/com/example/app/pauta.json)."
    },
    {
      "id": "PAUTA-05",
      "level": "MUST",
      "page": "conformance",
      "pageTitle": "Conformance",
      "section": "Exceptions",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/conformance/#pauta-05",
      "text": "A rule limited to apps with a feature needs no entry in an app without that feature. A rule is limited when its own text says so (\"An app with user data worth carrying between computers…\"), when its page or section opens with an **Applies to** line (the [Tray and background](https://pauta-project.dev/4.5.0/tray-and-background/) page; `appliesTo` in `rules.json`), or when it details a rule that is limited (WELC-03 onward detail the Welcome page of [WELC-01](https://pauta-project.dev/4.5.0/templates/welcome/#welc-01)). `not-applicable` is for a rule that reads as applying to every app.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "no `not-applicable` entry names a rule whose text, page, section or parent rule already limits it."
      },
      "reference": "no app yet."
    },
    {
      "id": "PAUTA-06",
      "level": "MUST",
      "page": "conformance",
      "pageTitle": "Conformance",
      "section": "Exceptions",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/conformance/#pauta-06",
      "text": "A `deviation` is a choice, not a gap, and only a SHOULD can have one: a SHOULD is expected unless the app has a stated reason, and the deviation is that reason. It links a decision record in `docs/decisions/` ([DOCS-13](https://pauta-project.dev/4.5.0/documentation/#docs-13)) that gives the context, what the app does instead, and what it costs. A MUST the app does not meet is `pending`, as is any work it has not done yet.",
      "why": "a deviation keeps the conformance; a deviation from a MUST, or missing work called a deviation, would let the app say it is built to an edition it does not meet.",
      "check": {
        "kind": "code",
        "text": "every `deviation` entry names a SHOULD, and its `link` opens a file under `docs/decisions/` that names the rule's ID."
      },
      "reference": "The [app template](https://github.com/adriandeleon/adl-desktop-app-template)'s [`PautaConformanceTest`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/test/java/com/example/app/PautaConformanceTest.java) (`eachKindHasWhatItNeeds`)."
    },
    {
      "id": "PAUTA-07",
      "level": "MUST",
      "page": "conformance",
      "pageTitle": "Conformance",
      "section": "Exceptions",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/conformance/#pauta-07",
      "text": "A `pending` exception links an open issue in the app's own repository that names the rule's ID and edition, \"MENU-14 (Pauta 4.2.0)\". One issue may hold several rules, one per page for example, if it names each one that way. Closing the issue removes its entries.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "every `pending` entry's `link` is an issue URL in the app's repository whose text names that entry's rule ID and edition."
      },
      "reference": "The [app template](https://github.com/adriandeleon/adl-desktop-app-template)'s [`PautaConformanceTest`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/test/java/com/example/app/PautaConformanceTest.java) (`eachKindHasWhatItNeeds`), whose pending entries link issues in the template's own repository."
    },
    {
      "id": "PAUTA-08",
      "level": "MUST",
      "page": "conformance",
      "pageTitle": "Conformance",
      "section": "Exceptions",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/conformance/#pauta-08",
      "text": "Each exception's `reason` is one plain sentence for the person using the app, in English like the changelog: what is different and, for a deviation, what they get instead. No rule text, no class names.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "read each reason in the Pauta window as a user would."
      },
      "reference": "The [app template](https://github.com/adriandeleon/adl-desktop-app-template)'s [`PautaConformanceTest`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/test/java/com/example/app/PautaConformanceTest.java) (`eachKindHasWhatItNeeds`: a reason ends with a period and names no rule ID)."
    },
    {
      "id": "PAUTA-16",
      "level": "MUST",
      "page": "conformance",
      "pageTitle": "Conformance",
      "section": "Exceptions",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/conformance/#pauta-16",
      "text": "A template repository, one that new apps are made from, sets `\"template\": true` in its `pauta.json` and records as `app-only` the rules that only an app made from it can meet. `app-only` leaves the conformance as it is, like `not-applicable`, and nothing but a template may use it. Making an app from the template sets `template` to `false`. From then on the app's everyday build passes but lists what it inherited: each `app-only` entry and each `pending` link to another repository. Its release build fails until each one is met, or recorded as `pending` with an issue in the app's own repository.",
      "why": "a template can't have the website or screenshots of an app that doesn't exist yet, and an app must not inherit its template's issues as its own. A build that failed the moment the app was made would fail its first step; the release is where it has to be settled ([PAUTA-03](https://pauta-project.dev/4.5.0/conformance/#pauta-03)).",
      "check": {
        "kind": "code",
        "text": "in a template, `pauta.json` has `\"template\": true` and the rename script sets it to `false`; in an app, the release build runs the test with inherited entries treated as failures, and the app's first release has no `app-only` entry."
      },
      "reference": "the [app template](https://github.com/adriandeleon/adl-desktop-app-template) (in progress)."
    },
    {
      "id": "PAUTA-09",
      "level": "MUST",
      "page": "conformance",
      "pageTitle": "Conformance",
      "section": "The file",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/conformance/#pauta-09",
      "text": "The exceptions have one source, `pauta.json` as above: `rule`, `level`, `url`, `kind` and `reason` on every entry, `link` on every deviation and pending entry, one entry per rule, and `\"template\": true` beside `exceptions` only in a template repository (PAUTA-16).",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the file exists at that path, and each entry has the fields its kind needs."
      },
      "reference": "The [app template](https://github.com/adriandeleon/adl-desktop-app-template)'s [`pauta.json`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/main/resources/com/example/app/pauta.json), read by [`PautaConformanceTest`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/test/java/com/example/app/PautaConformanceTest.java) (`parsesEveryField`, `everyEntryNamesARuleOfTheEditionWithItsLevelAndAddress`)."
    },
    {
      "id": "PAUTA-10",
      "level": "MUST",
      "page": "conformance",
      "pageTitle": "Conformance",
      "section": "The file",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/conformance/#pauta-10",
      "text": "A test reads `pauta.json` against a copy of the edition's `rules.json` in `src/test/resources/pauta-rules.json` and fails when the copy's `edition` is not `pauta.version`, when an entry names a rule the edition does not have, when its `level` or `url` differs from the edition's, when a rule appears twice, when a deviation names a MUST, or when a deviation or pending entry has no `link`. Outside a template, it reports each `app-only` entry and each `pending` link that is not an issue in the app's own repository (the one `AppInfo` names), and fails on them in the release build ([PAUTA-16](https://pauta-project.dev/4.5.0/conformance/#pauta-16)).",
      "why": "moving to a newer edition changes levels and retires IDs; the test turns each stale entry into a failure.",
      "check": {
        "kind": "test",
        "text": "`PautaConformanceTest`, or the app's equivalent, runs in the build."
      },
      "reference": "The [app template](https://github.com/adriandeleon/adl-desktop-app-template)'s [`PautaConformanceTest`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/test/java/com/example/app/PautaConformanceTest.java) and its copy of the edition's rules, [`pauta-rules.json`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/test/resources/pauta-rules.json). The template parts (`app-only`, inherited links) aren't built yet."
    },
    {
      "id": "PAUTA-11",
      "level": "SHOULD",
      "page": "conformance",
      "pageTitle": "Conformance",
      "section": "The file",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/conformance/#pauta-11",
      "text": "Moving to a newer edition is one change: replace `pauta-rules.json`, run the audit again, update `pauta.json`, then change `pauta.version`, the README and `AGENTS.md` together.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "the change that raises `pauta.version` also replaces `pauta-rules.json` and touches `pauta.json` where the audit found something new."
      },
      "reference": "[Move an app to a newer edition](https://pauta-project.dev/4.5.0/coding-agents/#move-an-app-to-a-newer-edition)."
    },
    {
      "id": "PAUTA-12",
      "level": "MUST",
      "page": "conformance",
      "pageTitle": "Conformance",
      "section": "Where it shows",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/conformance/#pauta-12",
      "text": "In the app: About names the edition and the conformance ([ABOUT-09](https://pauta-project.dev/4.5.0/templates/about/#about-09)), and the Pauta window, opened from About, the Help menu and the Command Palette, lists every exception ([Pauta window](https://pauta-project.dev/4.5.0/templates/pauta-window/)).",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`help.pauta` is registered and About's *Pauta conformance* link runs it."
      },
      "reference": "The [app template](https://github.com/adriandeleon/adl-desktop-app-template)'s [`ui/Commands.java`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/main/java/com/example/app/ui/Commands.java) (`help.pauta`) and [`ui/AboutDialog.java`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/main/java/com/example/app/ui/AboutDialog.java) (the link that runs it)."
    },
    {
      "id": "PAUTA-13",
      "level": "MUST",
      "page": "conformance",
      "pageTitle": "Conformance",
      "section": "Where it shows",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/conformance/#pauta-13",
      "text": "In the user docs: the app's website has a *Pauta conformance* page under `/docs/` ([DOCS-02](https://pauta-project.dev/4.5.0/documentation/#docs-02)) with the edition, the conformance and every exception, grouped by kind, each with its rule ID linked to the edition's rule, its reason and its link. The Pauta window links to it.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the website's `src/content/docs/` has the page, and it lists the same rules as `pauta.json`."
      },
      "reference": "no app yet."
    },
    {
      "id": "PAUTA-14",
      "level": "SHOULD",
      "page": "conformance",
      "pageTitle": "Conformance",
      "section": "Where it shows",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/conformance/#pauta-14",
      "text": "The docs page is generated from `pauta.json`, like the Commands page ([DOCS-04](https://pauta-project.dev/4.5.0/documentation/#docs-04)), so it cannot list a different set from the app.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the website's `scripts/` has a generator that reads the app's `pauta.json`, and its output is committed."
      },
      "reference": "no app yet; editora-website's [`scripts/GenCommands.java`](https://github.com/adriandeleon/editora-website/blob/master/scripts/GenCommands.java) is the pattern."
    },
    {
      "id": "PAUTA-15",
      "level": "MUST",
      "page": "conformance",
      "pageTitle": "Conformance",
      "section": "Where it shows",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/conformance/#pauta-15",
      "text": "In the repository: the README's Pauta badge ([README badges](https://pauta-project.dev/4.5.0/repository/#readme-badges-in-this-order)) and its \"Built to\" line (at Partial, \"Working toward\") name the edition and the conformance, and both link to the docs page.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "`PautaConformanceTest` fails when the README's badge or line names another edition than `pauta.version` or another conformance than `PautaConformance` returns."
      },
      "reference": "The [app template](https://github.com/adriandeleon/adl-desktop-app-template)'s README (the badge and the *Working toward* line), checked by [`PautaConformanceTest`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/test/java/com/example/app/PautaConformanceTest.java) (`theReadmeNamesTheEditionAndTheConformanceAndLinksTheDocsPage`)."
    },
    {
      "id": "PLAT-01",
      "level": "MUST",
      "page": "platform",
      "pageTitle": "Platform baseline",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/platform/#plat-01",
      "text": "The app builds on **JDK 25 or newer**. `maven.compiler.release` 25 is the floor, not the ceiling: build and bundle a current JDK.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`pom.xml` sets `maven.compiler.release` to 25 and the enforcer's `requireJavaVersion` to the open-ended range `[25,)`."
      },
      "reference": "Editora [`pom.xml`](https://github.com/adriandeleon/Editora/blob/master/pom.xml)."
    },
    {
      "id": "PLAT-02",
      "level": "MUST",
      "page": "platform",
      "pageTitle": "Platform baseline",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/platform/#plat-02",
      "text": "The installers carry a jlinked runtime; users never install Java.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the `dist` profile's jpackage step builds a jlinked app image (`jLinkOptions`) and wraps the installer around it."
      },
      "reference": "Editora [`pom.xml`](https://github.com/adriandeleon/Editora/blob/master/pom.xml) (`dist` profile)."
    },
    {
      "id": "PLAT-03",
      "level": "MUST",
      "page": "platform",
      "pageTitle": "Platform baseline",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/platform/#plat-03",
      "text": "The app builds on **JavaFX 27 or newer**.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`pom.xml` sets `javafx.version` to 27 or later."
      },
      "reference": "Editora [`pom.xml`](https://github.com/adriandeleon/Editora/blob/master/pom.xml)."
    },
    {
      "id": "PLAT-04",
      "level": "MUST",
      "page": "platform",
      "pageTitle": "Platform baseline",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/platform/#plat-04",
      "text": "The app is one named JPMS module, `com.<app>`, whose `module-info.java` opens only what reflection, FXML and Jackson need.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`src/main/java/module-info.java` declares `module com.<app>`; each `opens` line serves FXML, Jackson or another reflective reader."
      },
      "reference": "Editora [`src/main/java/module-info.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/module-info.java)."
    },
    {
      "id": "PLAT-05",
      "level": "MUST",
      "page": "platform",
      "pageTitle": "Platform baseline",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/platform/#plat-05",
      "text": "Controls use **AtlantaFX 3.x** (`atlantafx-base`), with light and dark themes.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`pom.xml` depends on `atlantafx-base` 3.x; the theme list offers at least one light and one dark theme."
      },
      "reference": "Editora [`pom.xml`](https://github.com/adriandeleon/Editora/blob/master/pom.xml), [`ui/Themes.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/Themes.java)."
    },
    {
      "id": "PLAT-06",
      "level": "MUST",
      "page": "platform",
      "pageTitle": "Platform baseline",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/platform/#plat-06",
      "text": "App stylesheets take their colors from AtlantaFX `-color-*` tokens, or from state tokens built on them; no component rule carries a fixed hex. See [Icons and color](https://pauta-project.dev/4.5.0/icons-and-color/).",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`grep -nE '#[0-9a-fA-F]{3,8}\\b' app.css` finds hexes only where a token is defined (a `ladder()` of the ground, a scoped `-color-*` block), not in a component's `-fx-*-color` or `-fx-fill`."
      },
      "reference": "Editora [`app.css`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/styles/app.css); [`StyleContrastTest.severityAndDebugColoursComeFromTheStateTokens`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/StyleContrastTest.java) holds the severity and debug colors. Editora's [`app.css`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/styles/app.css) still has fixed hexes in a few component rules (the breakpoint markers, the execution arrow, the editor area's defaults)."
    },
    {
      "id": "PLAT-08",
      "level": "MUST",
      "page": "platform",
      "pageTitle": "Platform baseline",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/platform/#plat-08",
      "text": "The build is **Maven** with the **Maven Wrapper** committed (`mvnw`, `mvnw.cmd`, `.mvn/wrapper/`), so `./mvnw` works on a clean machine.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`mvnw`, `mvnw.cmd` and `.mvn/wrapper/maven-wrapper.properties` are in the repository."
      },
      "reference": "Editora [`mvnw`](https://github.com/adriandeleon/Editora/blob/master/mvnw), [`.mvn/wrapper/`](https://github.com/adriandeleon/Editora/tree/master/.mvn/wrapper)."
    },
    {
      "id": "PLAT-09",
      "level": "MUST",
      "page": "platform",
      "pageTitle": "Platform baseline",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/platform/#plat-09",
      "text": "Nullness is declared with **JSpecify** and checked by **NullAway** on **Error Prone** at compile time. Every package is `@NullMarked` in its own `package-info.java`.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the compiler arguments include `-Xep:NullAway:ERROR`; every source package has a `package-info.java` with `@NullMarked`."
      },
      "reference": "Editora [`pom.xml`](https://github.com/adriandeleon/Editora/blob/master/pom.xml), [`docs/conventions.md#null-annotations-jspecify-checked-by-nullaway`](https://github.com/adriandeleon/Editora/blob/master/docs/conventions.md#null-annotations-jspecify-checked-by-nullaway)."
    },
    {
      "id": "PLAT-10",
      "level": "MUST",
      "page": "platform",
      "pageTitle": "Platform baseline",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/platform/#plat-10",
      "text": "Code is formatted by **Spotless** with Palantir Java Format, and CI fails an unformatted change.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the spotless plugin configures `palantirJavaFormat`, and a CI job runs `spotless:check`."
      },
      "reference": "Editora [`pom.xml`](https://github.com/adriandeleon/Editora/blob/master/pom.xml) (spotless plugin), [`.github/workflows/ci.yml`](https://github.com/adriandeleon/Editora/blob/master/.github/workflows/ci.yml) (*Format*)."
    },
    {
      "id": "PLAT-11",
      "level": "MUST",
      "page": "platform",
      "pageTitle": "Platform baseline",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/platform/#plat-11",
      "text": "Tests run on **JUnit** (Jupiter, 5 or newer) and **TestFX** over JavaFX's built-in **Headless** glass platform (`-Dglass.platform=Headless`), so FX tests need no display, no xvfb and no Monocle.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "surefire's `systemPropertyVariables` set `glass.platform` to `Headless`; no Monocle dependency, and no xvfb in a step that runs tests (a release leg may use it to train the AOT cache, [REL-10](https://pauta-project.dev/4.5.0/release/#rel-10))."
      },
      "reference": "Editora [`pom.xml`](https://github.com/adriandeleon/Editora/blob/master/pom.xml) (surefire), [`docs/testing.md`](https://github.com/adriandeleon/Editora/blob/master/docs/testing.md), [`FxTestSupport`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/FxTestSupport.java)."
    },
    {
      "id": "PLAT-12",
      "level": "MUST",
      "page": "platform",
      "pageTitle": "Platform baseline",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/platform/#plat-12",
      "text": "A **JaCoCo** `check` runs at `mvn verify`: **≥ 0.90 lines, ≥ 0.90 methods**, ≥ 0.79 branches, plus per-package floors.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the `jacoco-check` execution is bound to `verify` with `BUNDLE` limits of 0.90 `LINE` and 0.90 `METHOD`."
      },
      "reference": "Editora [`pom.xml`](https://github.com/adriandeleon/Editora/blob/master/pom.xml) `jacoco-check`."
    },
    {
      "id": "PLAT-13",
      "level": "SHOULD",
      "page": "platform",
      "pageTitle": "Platform baseline",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/platform/#plat-13",
      "text": "The app logs through `java.util.logging` and no other logging API. The Debug Log captures it: [DIAG-02](https://pauta-project.dev/4.5.0/diagnostics/#diag-02).",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the app's own code imports no logging API other than `java.util.logging`."
      },
      "reference": "Editora [`ui/DebugLog.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/DebugLog.java)."
    },
    {
      "id": "PLAT-14",
      "level": "SHOULD",
      "page": "platform",
      "pageTitle": "Platform baseline",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/platform/#plat-14",
      "text": "Config files are JSON, read and written by Jackson as plain classes (POJOs). Their schema versions and migrations are [SET-09](https://pauta-project.dev/4.5.0/settings/#set-09).",
      "why": null,
      "check": {
        "kind": "code",
        "text": "every class written to the config folder is read and written through Jackson's `ObjectMapper`; no store builds or parses its JSON by hand."
      },
      "reference": "Editora [`config/Settings`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/config/Settings.java), [`config/migration/ConfigSchema.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/config/migration/ConfigSchema.java)."
    },
    {
      "id": "REPO-01",
      "level": "MUST",
      "page": "repository",
      "pageTitle": "Repository documents",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/repository/#repo-01",
      "text": "`README.md` is a landing page of about 200 lines: logo, badges, a one-paragraph pitch, the hero screenshot, highlights, install, build, command line, config folder, license. Detail lives on the website.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`README.md` is near 200 lines and has those parts, with links to the website for the rest."
      },
      "reference": "Editora [`README.md`](https://github.com/adriandeleon/Editora/blob/master/README.md)."
    },
    {
      "id": "REPO-02",
      "level": "MUST",
      "page": "repository",
      "pageTitle": "Repository documents",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/repository/#repo-02",
      "text": "`CHANGELOG.md` follows [Keep a Changelog 1.1](https://keepachangelog.com/en/1.1.0/) and SemVer: an `## [Unreleased]` section with Added / Changed / Fixed / Removed, and each entry opens with a bold one-line summary written for users.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the file names Keep a Changelog and Semantic Versioning, starts with `## [Unreleased]`, and every entry starts with `- **`."
      },
      "reference": "Editora [`CHANGELOG.md`](https://github.com/adriandeleon/Editora/blob/master/CHANGELOG.md)."
    },
    {
      "id": "REPO-03",
      "level": "MUST",
      "page": "repository",
      "pageTitle": "Repository documents",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/repository/#repo-03",
      "text": "`LICENSE` is MIT, \"Copyright (c) 2026 Adrián Arturo De León Saldivar\".",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`LICENSE` opens with `MIT License` and that copyright line."
      },
      "reference": "Editora [`LICENSE`](https://github.com/adriandeleon/Editora/blob/master/LICENSE)."
    },
    {
      "id": "REPO-04",
      "level": "MUST",
      "page": "repository",
      "pageTitle": "Repository documents",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/repository/#repo-04",
      "text": "`NOTICE` gives the app name, the copyright, \"licensed under the MIT License\", then every bundled third-party component with its license (Inter is OFL, AtlantaFX is MIT, OpenJFX is GPLv2+CPE…). It ships inside the installers too.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a test fails when a runtime dependency in `pom.xml` has no `NOTICE` entry, and another when `LICENSE` and `NOTICE` are not packaged."
      },
      "reference": "Editora [`NOTICE`](https://github.com/adriandeleon/Editora/blob/master/NOTICE), [`NoticeCoverageTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/packaging/NoticeCoverageTest.java), [`BuildHygieneTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/packaging/BuildHygieneTest.java)."
    },
    {
      "id": "REPO-05",
      "level": "MUST",
      "page": "repository",
      "pageTitle": "Repository documents",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/repository/#repo-05",
      "text": "`AGENTS.md` holds the operational rules for coding agents: essential commands, worktree-per-task, the change checklist. It is not a changelog. A short `CLAUDE.md` points to it.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`AGENTS.md` has sections for commands, worktrees and the change checklist; `CLAUDE.md` is a few lines that send the reader to `AGENTS.md`."
      },
      "reference": "Editora [`AGENTS.md`](https://github.com/adriandeleon/Editora/blob/master/AGENTS.md), [`CLAUDE.md`](https://github.com/adriandeleon/Editora/blob/master/CLAUDE.md)."
    },
    {
      "id": "REPO-06",
      "level": "MUST",
      "page": "repository",
      "pageTitle": "Repository documents",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/repository/#repo-06",
      "text": "`CONTRIBUTING.md` says how to build, test, format, and open a PR.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`CONTRIBUTING.md` names the build, test and format commands and the PR step."
      },
      "reference": "Editora [`CONTRIBUTING.md`](https://github.com/adriandeleon/Editora/blob/master/CONTRIBUTING.md)."
    },
    {
      "id": "REPO-07",
      "level": "MUST",
      "page": "repository",
      "pageTitle": "Repository documents",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/repository/#repo-07",
      "text": "`docs/` holds `architecture.md`, `conventions.md`, `testing.md`, `gotchas.md`, `release.md`, `building-and-packaging.md` and `decisions/` (ADRs).",
      "why": null,
      "check": {
        "kind": "code",
        "text": "each of those paths exists under `docs/`."
      },
      "reference": "Editora [`docs/`](https://github.com/adriandeleon/Editora/tree/master/docs)."
    },
    {
      "id": "REPO-08",
      "level": "MAY",
      "page": "repository",
      "pageTitle": "Repository documents",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/repository/#repo-08",
      "text": "`TODO.md` holds the open list, kept in the same PR as the change.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`TODO.md` exists at the root."
      },
      "reference": "Editora [`TODO.md`](https://github.com/adriandeleon/Editora/blob/master/TODO.md)."
    },
    {
      "id": "REPO-09",
      "level": "MUST",
      "page": "repository",
      "pageTitle": "Repository documents",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/repository/#repo-09",
      "text": "`.github/ISSUE_TEMPLATE/bug_report.yml` is an issue form whose field ids (`environment`, `report`) the in-app Report a Problem fills.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the form has fields with `id: environment` and `id: report`."
      },
      "reference": "Editora [`.github/ISSUE_TEMPLATE/bug_report.yml`](https://github.com/adriandeleon/Editora/blob/master/.github/ISSUE_TEMPLATE/bug_report.yml)."
    },
    {
      "id": "REPO-10",
      "level": "MUST",
      "page": "repository",
      "pageTitle": "Repository documents",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/repository/#repo-10",
      "text": "`branding/` holds the source SVG of the icon. The PNG, ICNS and ICO generated from it sit beside it or in `packaging/`.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`branding/` has an `.svg`; the `jpackage` icon paths in `pom.xml` point at the generated files."
      },
      "reference": "Editora [`branding/editora-icon.svg`](https://github.com/adriandeleon/Editora/blob/master/branding/editora-icon.svg), with [`editora.png`](https://github.com/adriandeleon/Editora/blob/master/branding/editora.png), `.icns` and `.ico` beside it; the template keeps them in [`packaging/icons/`](https://github.com/adriandeleon/adl-desktop-app-template/tree/master/packaging/icons)."
    },
    {
      "id": "DOCS-01",
      "level": "MUST",
      "page": "documentation",
      "pageTitle": "Documentation",
      "section": "User documentation",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/documentation/#docs-01",
      "text": "Every app has user documentation: a *Getting started* page (install, first launch, the first thing to do), one page per feature area, the keyboard reference, the Settings, and an FAQ. It is written for the person using the app, in their words, with screenshots from the real window. The README's 200 lines are not it.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the website repository's `src/content/docs/` has a getting-started page, a keymaps page, a settings or configuration page, an FAQ and a page per feature area."
      },
      "reference": "editora-website [`src/content/docs/`](https://github.com/adriandeleon/editora-website/tree/master/src/content/docs) (43 pages in nine categories, from *Getting started* to *Help*); torrenta-website (19), termina-website (16), mirada-website (11)."
    },
    {
      "id": "DOCS-02",
      "level": "MUST",
      "page": "documentation",
      "pageTitle": "Documentation",
      "section": "User documentation",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/documentation/#docs-02",
      "text": "The user docs live on the app's website, under `/docs/`, in the app's `<app>-website` repository, beside the feature pages, the screenshots, the news posts and the blog. Each docs page is a Markdown file whose frontmatter gives its `category` and `order`; the sidebar, the sitemap and the RSS feed follow. The app's repository never carries a second copy.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "every file in the website's `src/content/docs/` has `category` and `order` in its frontmatter; the app's `docs/` holds no user guide."
      },
      "reference": "editora-website [`README.md`](https://github.com/adriandeleon/editora-website/blob/master/README.md) (*Content*); Editora's [`AGENTS.md`](https://github.com/adriandeleon/Editora/blob/master/AGENTS.md): \"User-facing feature documentation goes to the separate website repository\"."
    },
    {
      "id": "DOCS-03",
      "level": "SHOULD",
      "page": "documentation",
      "pageTitle": "Documentation",
      "section": "User documentation",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/documentation/#docs-03",
      "text": "Deep links from the app open the running version's docs. Pages live under `/docs/v-<version>/…`; bare `/docs` and every unversioned slug redirect to the current version, so a link in a page never carries a version and a bump just regenerates `src/lib/version.ts`. The app builds the base from its own version with `-SNAPSHOT` dropped, so a development build points at the release it is working toward instead of a path that would always 404.",
      "why": "a release that pointed at another release's docs would claim what is not true ([*Never claim what is not true*](https://pauta-project.dev/4.5.0/principles/#for-the-people-using-the-apps)), so this becomes a must the day the app links to a specific page.",
      "check": {
        "kind": "code",
        "text": "the app's docs URL is `<homepage>/docs/v-` plus its version without `-SNAPSHOT`; the site's `astro.config.mjs` serves `/docs/v-<version>/` and redirects the unversioned paths."
      },
      "reference": "Editora [`AppInfo.docsUrl()`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/AppInfo.java), `releaseVersion()`; editora-website [`astro.config.mjs`](https://github.com/adriandeleon/editora-website/blob/master/astro.config.mjs), [`README.md`](https://github.com/adriandeleon/editora-website/blob/master/README.md) (*Versioned docs*). The other three sites carry a comment to port these routes when their app first deep-links."
    },
    {
      "id": "DOCS-04",
      "level": "SHOULD",
      "page": "documentation",
      "pageTitle": "Documentation",
      "section": "User documentation",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/documentation/#docs-04",
      "text": "Docs are generated where the app is the source. The Commands and Keybindings pages are generated from the app's command registrations, `messages.properties` and keymaps; the Roadmap and What's new from `TODO.md` and `CHANGELOG.md`; the version from `pom.xml`. The output is committed, so the site builds without the app checked out. A check fails the site when a docs page quotes a command id that does not exist or a chord that is bound to a different command.",
      "why": "one fact, one source ([*One source of truth for each fact*](https://pauta-project.dev/4.5.0/principles/#for-the-people-building-them)).",
      "check": {
        "kind": "code",
        "text": "the website's `scripts/` holds the generators, their output under `src/lib/` is committed, and `npm run check:docs` runs the id and chord check."
      },
      "reference": "editora-website [`scripts/GenCommands.java`](https://github.com/adriandeleon/editora-website/blob/master/scripts/GenCommands.java) (every `Command.of` in Editora's `com.editora.ui`, [`MainController`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MainController.java) holding most), [`GenRoadmap.java`](https://github.com/adriandeleon/editora-website/blob/master/scripts/GenRoadmap.java), [`GenFeatures.java`](https://github.com/adriandeleon/editora-website/blob/master/scripts/GenFeatures.java); [`scripts/check-doc-commands.mjs`](https://github.com/adriandeleon/editora-website/blob/master/scripts/check-doc-commands.mjs) (`npm run check:docs`)."
    },
    {
      "id": "DOCS-05",
      "level": "MUST",
      "page": "documentation",
      "pageTitle": "Documentation",
      "section": "User documentation",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/documentation/#docs-05",
      "text": "Release notes are written for users. Each `CHANGELOG.md` entry opens with a bold one-line summary ([Repository documents](https://pauta-project.dev/4.5.0/repository/)); the Welcome page's *What's New* opens this build's release, and the website's What's new is generated from the same file. The GitHub release carrying the section is [REL-04](https://pauta-project.dev/4.5.0/release/#rel-04).",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the Welcome page's *What's New* opens `AppInfo.releaseNotesUrl()`; the website's What's new is generated from `CHANGELOG.md`."
      },
      "reference": "Editora [`AppInfo.releaseNotesUrl()`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/AppInfo.java), [`WelcomePane`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/WelcomePane.java) (`welcome.whatsNew`); editora-website [`GenRoadmap.java`](https://github.com/adriandeleon/editora-website/blob/master/scripts/GenRoadmap.java)."
    },
    {
      "id": "DOCS-06",
      "level": "MUST",
      "page": "documentation",
      "pageTitle": "Documentation",
      "section": "Reachable from the app",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/documentation/#docs-06",
      "text": "**Help → Documentation** opens the user docs in the browser. It is a command (`help.documentation`), so it is in the palette, bindable and in the menu through the registry like every other row; it is the first row of the Help menu after the Command Palette, and the Welcome page's Help row repeats it.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`help.documentation` is registered, follows `palette.show` in the Help `MenuSpec`, and the Welcome page's Help row runs it through the registry."
      },
      "reference": "Editora [`WindowCommandRegistrar`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/WindowCommandRegistrar.java) (`help.documentation` → [`MainController.openDocumentation()`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MainController.java)), [`MenuBarModel`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MenuBarModel.java) (`menubar.help`), [`WelcomePane`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/WelcomePane.java) (`welcome.documentation`)."
    },
    {
      "id": "DOCS-07",
      "level": "SHOULD",
      "page": "documentation",
      "pageTitle": "Documentation",
      "section": "Reachable from the app",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/documentation/#docs-07",
      "text": "The Help menu runs in this order: Command Palette · Documentation · Check for Updates · Message Log · Debug Log · Report a Problem · Pauta Conformance · About. Simple mode keeps Command Palette, Documentation and About. An app without a feature drops its row; nothing moves.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "both `menubar.help` menu specs list those command ids in that order."
      },
      "reference": "Editora [`MenuBarModel`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MenuBarModel.java), both `MenuSpec(\"menubar.help\", …)`."
    },
    {
      "id": "DOCS-08",
      "level": "SHOULD",
      "page": "documentation",
      "pageTitle": "Documentation",
      "section": "Reachable from the app",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/documentation/#docs-08",
      "text": "Help has a keyboard reference: a searchable window of every key, grouped as the menus are, or the keybinding editor.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "open it from Help, search for a command, and find its key."
      },
      "reference": "Termina's and Mirada's [`ShortcutsWindow`](https://github.com/adriandeleon/Mirada/blob/main/src/main/java/com/mirada/ui/ShortcutsWindow.java); Editora's keybinding editor ([Keyboard first](https://pauta-project.dev/4.5.0/keyboard/))."
    },
    {
      "id": "DOCS-09",
      "level": "MUST",
      "page": "documentation",
      "pageTitle": "Documentation",
      "section": "Reachable from the app",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/documentation/#docs-09",
      "text": "Every command has a one-line description (`command.<id>.desc`), shown under the title in the palette. It is the in-app documentation of the command.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "the parity test fails when a `command.<id>` title has no `.desc`."
      },
      "reference": "Editora [`messages.properties`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/i18n/messages.properties), [`MessagesTest.everyCommandTitleHasAMatchingDescription`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/i18n/MessagesTest.java) ([Code quality gates](https://pauta-project.dev/4.5.0/quality/))."
    },
    {
      "id": "DOCS-10",
      "level": "MAY",
      "page": "documentation",
      "pageTitle": "Documentation",
      "section": "Reachable from the app",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/documentation/#docs-10",
      "text": "The palette opens per-command help. With a command highlighted, `C-h` opens its page, `/docs/v-<version>/commands/<id>`; where the keymap binds `C-h`, the first free of `F1` and `Shift+F1` does. Search Everywhere shares the URL builder so the two pickers can never disagree.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the palette and Search Everywhere both build the URL with `CommandPalette.docsUrl`."
      },
      "reference": "Editora [`CommandPalette.docsUrl`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/CommandPalette.java), `setDocsOpener`; [`PickerKeys.freeChord`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/PickerKeys.java)."
    },
    {
      "id": "DOCS-11",
      "level": "MAY",
      "page": "documentation",
      "pageTitle": "Documentation",
      "section": "Reachable from the app",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/documentation/#docs-11",
      "text": "Each page of the Settings window has a *Help for &lt;page&gt;* link to its docs page, from one map of page to slug.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "one map from Settings page to docs slug feeds every page's help link."
      },
      "reference": "Editora [`SettingsWindow`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/SettingsWindow.java), [`SettingsFrameBits.helpUrl`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/SettingsFrameBits.java), `settings.help`."
    },
    {
      "id": "DOCS-12",
      "level": "MUST",
      "page": "documentation",
      "pageTitle": "Documentation",
      "section": "Developer documentation",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/documentation/#docs-12",
      "text": "`docs/` has an index. `docs/README.md` says who the folder is for (contributors; user docs live on the website), states that the code wins when the two disagree, and lists every guide with one line. The set is the one [Repository documents](https://pauta-project.dev/4.5.0/repository/) names: `architecture.md`, `conventions.md`, `testing.md`, `gotchas.md`, `release.md`, `building-and-packaging.md` and `decisions/`.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`docs/README.md` exists, says those two things, and links each guide in `docs/`."
      },
      "reference": "Editora's [`docs/README.md`](https://github.com/adriandeleon/Editora/blob/master/docs/README.md); the template's [`docs/`](https://github.com/adriandeleon/adl-desktop-app-template/tree/master/docs)."
    },
    {
      "id": "DOCS-13",
      "level": "SHOULD",
      "page": "documentation",
      "pageTitle": "Documentation",
      "section": "Developer documentation",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/documentation/#docs-13",
      "text": "Every choice a newcomer would question has a decision record: a fork, a rejected dependency, a storage format, an escape hatch. It is one numbered Markdown file, `docs/decisions/NNNN-slug.md`, with the context, the decision and what it costs.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`docs/decisions/` holds `NNNN-slug.md` files, each with context, decision and consequences."
      },
      "reference": "Editora's [`docs/decisions/`](https://github.com/adriandeleon/Editora/tree/master/docs/decisions) (18 records, from [`0001-richtextfx-fork.md`](https://github.com/adriandeleon/Editora/blob/master/docs/decisions/0001-richtextfx-fork.md))."
    },
    {
      "id": "DOCS-14",
      "level": "MUST",
      "page": "documentation",
      "pageTitle": "Documentation",
      "section": "Developer documentation",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/documentation/#docs-14",
      "text": "Three files have three jobs. `AGENTS.md` is the operational guide, kept short (commands, worktree-per-task, the change checklist). `CONTRIBUTING.md` is the short version for a person, pointing into `docs/`. `docs/` holds the durable explanations. Exhaustive history goes to `docs/reference/`, not into any of the three.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`AGENTS.md` and `CONTRIBUTING.md` link into `docs/`; long catalogs sit under `docs/reference/`."
      },
      "reference": "Editora's [`AGENTS.md`](https://github.com/adriandeleon/Editora/blob/master/AGENTS.md) (*Documentation map*), [`CONTRIBUTING.md`](https://github.com/adriandeleon/Editora/blob/master/CONTRIBUTING.md), [`docs/reference/README.md`](https://github.com/adriandeleon/Editora/blob/master/docs/reference/README.md)."
    },
    {
      "id": "DOCS-15",
      "level": "SHOULD",
      "page": "documentation",
      "pageTitle": "Documentation",
      "section": "Developer documentation",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/documentation/#docs-15",
      "text": "Javadoc sits on its member: a doc comment above another doc comment documents nothing. Comments say why, not what.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a test fails the build on a Javadoc comment followed by another."
      },
      "reference": "Editora [`StackedJavadocTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/StackedJavadocTest.java)."
    },
    {
      "id": "DOCS-16",
      "level": "MUST",
      "page": "documentation",
      "pageTitle": "Documentation",
      "section": "Kept in step",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/documentation/#docs-16",
      "text": "Docs change in the same PR. A change that affects behavior updates `CHANGELOG.md`, `TODO.md`, the contributor guides it touches and the website's user docs in the same change, never as a follow-up. A reviewer treats a feature PR with no docs change as incomplete.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`docs/conventions.md`, `CONTRIBUTING.md` and `AGENTS.md` state the rule; in review, a feature PR's diff touches `CHANGELOG.md`."
      },
      "reference": "Editora [`docs/conventions.md#docs-in-the-same-pr`](https://github.com/adriandeleon/Editora/blob/master/docs/conventions.md#docs-in-the-same-pr), [`CONTRIBUTING.md`](https://github.com/adriandeleon/Editora/blob/master/CONTRIBUTING.md) (step 4), [`AGENTS.md`](https://github.com/adriandeleon/Editora/blob/master/AGENTS.md)."
    },
    {
      "id": "DOCS-17",
      "level": "MUST",
      "page": "documentation",
      "pageTitle": "Documentation",
      "section": "Kept in step",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/documentation/#docs-17",
      "text": "When documentation and code disagree, the code wins, and the documentation is fixed in the same change. The same rule this guide applies to itself.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`AGENTS.md` and `docs/README.md` say so."
      },
      "reference": "Editora's [`AGENTS.md`](https://github.com/adriandeleon/Editora/blob/master/AGENTS.md), [`docs/README.md`](https://github.com/adriandeleon/Editora/blob/master/docs/README.md)."
    },
    {
      "id": "DOCS-18",
      "level": "SHOULD",
      "page": "documentation",
      "pageTitle": "Documentation",
      "section": "Kept in step",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/documentation/#docs-18",
      "text": "Screenshots are retaken, not described. The capture hook renders the real window at 2× after any UI change, for the README (its hero in light and dark), the website and bug reports.",
      "why": "a stale screenshot claims what is not true.",
      "check": {
        "kind": "code",
        "text": "the app has a capture hook or a headless harness that writes the real window to a PNG."
      },
      "reference": "`DevCapture` ([Shared features](https://pauta-project.dev/4.5.0/family/shared-features/)); Editora's headless harness."
    },
    {
      "id": "QUAL-02",
      "level": "SHOULD",
      "page": "quality",
      "pageTitle": "Code quality gates",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/quality/#qual-02",
      "text": "A NullAway report is fixed, not suppressed: put `@Nullable` on what may be null.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`grep -rn '@SuppressWarnings(\"NullAway\")' src/main` finds nothing."
      },
      "reference": "Editora; one suppression is left, in [`recovery/RecoveryCodec.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/recovery/RecoveryCodec.java)."
    },
    {
      "id": "QUAL-03",
      "level": "SHOULD",
      "page": "quality",
      "pageTitle": "Code quality gates",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/quality/#qual-03",
      "text": "Coverage floors are a regression net, not a target. Beyond the build-wide floor of 0.90 lines and methods, each package of 300+ lines gets its own floor about three points below its measured level; when a package's coverage rises, its floor is ratcheted up.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the `jacoco-check` rules in `pom.xml` carry a `PACKAGE` line floor for each large package."
      },
      "reference": "Editora [`pom.xml`](https://github.com/adriandeleon/Editora/blob/master/pom.xml) `jacoco-check`."
    },
    {
      "id": "QUAL-04",
      "level": "SHOULD",
      "page": "quality",
      "pageTitle": "Code quality gates",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/quality/#qual-04",
      "text": "When a guide quotes the coverage floors, a test fails when the quoted table and the pom disagree.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a build test reads the `jacoco-check` rules from `pom.xml` and compares them with the guide's table."
      },
      "reference": "Editora [`BuildHygieneTest.theCoverageFloorsQuotedInTheTestingGuideAreTheOnesTheBuildEnforces`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/packaging/BuildHygieneTest.java), [`docs/testing.md`](https://github.com/adriandeleon/Editora/blob/master/docs/testing.md)."
    },
    {
      "id": "QUAL-05",
      "level": "MUST",
      "page": "quality",
      "pageTitle": "Code quality gates",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/quality/#qual-05",
      "text": "Extract the decision, then test it ([principle 12](https://pauta-project.dev/4.5.0/principles/#for-the-people-building-them)). Prefer a pure decision helper plus unit tests; use the headless FX harness only when controller or toolkit behavior is the point.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "enablement, visibility and navigation rules sit in classes that import no `javafx` type, each with a unit test not tagged `fx`."
      },
      "reference": "Editora [`docs/testing.md`](https://github.com/adriandeleon/Editora/blob/master/docs/testing.md) (*Prefer pure logic*): [`ui/Chrome`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/Chrome.java), [`editops/TextNav`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/editops/TextNav.java), [`config/PathKeys`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/config/PathKeys.java), each with a plain unit test."
    },
    {
      "id": "QUAL-06",
      "level": "MUST",
      "page": "quality",
      "pageTitle": "Code quality gates",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/quality/#qual-06",
      "text": "FX tests are tagged `@Tag(\"fx\")`, so the pure suite runs alone with `-DexcludedGroups=fx`.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "every test class that boots the toolkit (`FxTestSupport`, `FxToolkit`) carries `@Tag(\"fx\")`."
      },
      "reference": "Editora [`docs/testing.md`](https://github.com/adriandeleon/Editora/blob/master/docs/testing.md). Editora does not hold it fully yet: about twenty `*FxTest` classes, most of them `ProjectMap*FxTest`, carry no tag."
    },
    {
      "id": "QUAL-07",
      "level": "SHOULD",
      "page": "quality",
      "pageTitle": "Code quality gates",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/quality/#qual-07",
      "text": "Tests do not sleep. Workers and FX callbacks are owned by a scope (`AsyncTestScope`), and tests wait on latches.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`grep -rn 'Thread.sleep' src/test` finds nothing."
      },
      "reference": "Editora [`AsyncTestScope`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/AsyncTestScope.java), [`docs/testing.md`](https://github.com/adriandeleon/Editora/blob/master/docs/testing.md). Many older Editora tests still poll with `Thread.sleep`."
    },
    {
      "id": "QUAL-08",
      "level": "SHOULD",
      "page": "quality",
      "pageTitle": "Code quality gates",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/quality/#qual-08",
      "text": "A test window writes only inside its temp folders, never in the real home directory.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "the command sweep checks the home directory after running every command."
      },
      "reference": "Editora [`CommandSweepFxTest.leftInTheHomeDirectory`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/CommandSweepFxTest.java)."
    },
    {
      "id": "QUAL-09",
      "level": "MUST",
      "page": "quality",
      "pageTitle": "Code quality gates",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/quality/#qual-09",
      "text": "UI work is verified in the running app ([principle 13](https://pauta-project.dev/4.5.0/principles/#for-the-people-building-them)): a capture hook or headless screenshot of the real window, with real key and mouse events, before a UI change is called done.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the app has a capture hook (`DevCapture`) or a headless fixture that builds the real window."
      },
      "reference": "Editora [`FxWindowFixture`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/FxWindowFixture.java) (the real [`MainController`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MainController.java) window, headless); Torrenta and Termina `DevCapture.java`."
    },
    {
      "id": "QUAL-10",
      "level": "SHOULD",
      "page": "quality",
      "pageTitle": "Code quality gates",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/quality/#qual-10",
      "text": "A guard that cannot fail is decoration. When you add a drift or parity test, break the thing it guards once and watch it fail.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "break what the new test guards, run it, and see it fail."
      },
      "reference": "Modula's [`DependenciesTest`](https://github.com/adriandeleon/Modula/blob/master/src/test/java/com/modula/DependenciesTest.java)."
    },
    {
      "id": "QUAL-11",
      "level": "SHOULD",
      "page": "quality",
      "pageTitle": "Code quality gates",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/quality/#qual-11",
      "text": "A command sweep runs every registered command in a real headless window.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "one FX test iterates the registry and runs each command."
      },
      "reference": "Editora [`CommandSweepFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/CommandSweepFxTest.java)."
    },
    {
      "id": "QUAL-13",
      "level": "SHOULD",
      "page": "quality",
      "pageTitle": "Code quality gates",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/quality/#qual-13",
      "text": "A settings round trip shows that every switch, number and choice survives a restart.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "one FX test sets every control, reloads the settings and reads each back."
      },
      "reference": "Editora [`SettingsRoundTripFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/SettingsRoundTripFxTest.java)."
    },
    {
      "id": "QUAL-15",
      "level": "SHOULD",
      "page": "quality",
      "pageTitle": "Code quality gates",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/quality/#qual-15",
      "text": "A release supply-chain test keeps the signing and attestation steps where they are.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a test reads the workflows and fails when a signing, notarization or attestation step moves or goes."
      },
      "reference": "Editora [`ReleaseSupplyChainTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/packaging/ReleaseSupplyChainTest.java)."
    },
    {
      "id": "PERF-01",
      "level": "MUST",
      "page": "performance",
      "pageTitle": "Performance",
      "section": "The UI thread",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/performance/#perf-01",
      "text": "Never block the JavaFX application thread. No file or network I/O, no process start or wait, no parsing, searching, hashing or JSON of any size on it, and no `Thread.sleep`, `Future.get()`, `join()` or `Process.waitFor()` there.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "event handlers, listeners and `Platform.runLater` bodies call no `Files.*`, `HttpClient.send`, `ProcessBuilder.start`, `waitFor`, `Future.get`, `join` or `Thread.sleep`; that work runs on an executor or a virtual thread."
      },
      "reference": "Editora [`docs/performance.md`](https://github.com/adriandeleon/Editora/blob/master/docs/performance.md) §1."
    },
    {
      "id": "PERF-02",
      "level": "MUST",
      "page": "performance",
      "pageTitle": "Performance",
      "section": "The UI thread",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/performance/#perf-02",
      "text": "Touch the scene graph only on the FX thread. Background work hands its result back with `Platform.runLater`; nothing else creates, changes or reads live nodes.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "every executor task or thread body that ends in UI work wraps that work in `Platform.runLater`."
      },
      "reference": "every Editora service, for example [`git/GitService.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/git/GitService.java)."
    },
    {
      "id": "PERF-03",
      "level": "MUST",
      "page": "performance",
      "pageTitle": "Performance",
      "section": "The UI thread",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/performance/#perf-03",
      "text": "A background result is applied under a generation guard, so an answer to an old request never overwrites a newer one.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "each request takes a generation (`AtomicLong.incrementAndGet`) or goes through `LatestOnly`, and its result is applied only while that generation is still current, checked again inside the `runLater`."
      },
      "reference": "Editora [`git/GitService.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/git/GitService.java), [`search/SearchService.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/search/SearchService.java), [`ui/LatestOnly.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/LatestOnly.java) ([`LatestOnlyTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/LatestOnlyTest.java))."
    },
    {
      "id": "PERF-04",
      "level": "SHOULD",
      "page": "performance",
      "pageTitle": "Performance",
      "section": "The UI thread",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/performance/#perf-04",
      "text": "Every thread is named and is a daemon.",
      "why": "a thread dump then says what is running, and a stray worker never keeps the app alive after its last window closes.",
      "check": {
        "kind": "code",
        "text": "every `Executors.new…` and `new Thread` gets a name and `setDaemon(true)`, through a thread factory such as `daemon(\"my-feature\")`; virtual threads are daemons already."
      },
      "reference": "the shape below; Editora [`terminal/TerminalExecutors.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/terminal/TerminalExecutors.java)."
    },
    {
      "id": "PERF-05",
      "level": "MUST",
      "page": "performance",
      "pageTitle": "Performance",
      "section": "The UI thread",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/performance/#perf-05",
      "text": "Blocking work stays off the common `ForkJoinPool`, and a `Process` subclass overrides `onExit()`.",
      "why": "the common pool has one worker fewer than the machine has cores, so a few blocked waits (`CompletableFuture.supplyAsync` of a `waitFor`) starve every other user of it.",
      "check": {
        "kind": "code",
        "text": "no `supplyAsync` or `runAsync` without an executor wraps a blocking call, and every class that extends `Process` overrides `onExit()`."
      },
      "reference": "Editora [`process/ExitWatch.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/process/ExitWatch.java), [`docs/gotchas.md`](https://github.com/adriandeleon/Editora/blob/master/docs/gotchas.md). Editora's [`DapManager.reportJavaExit`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/dap/DapManager.java) still waits up to 3 s for an exit code in a `supplyAsync` on the common pool."
    },
    {
      "id": "PERF-06",
      "level": "MUST",
      "page": "performance",
      "pageTitle": "Performance",
      "section": "Hot paths",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/performance/#perf-06",
      "text": "Redraws are coalesced to at most one per pulse with a `pending` flag, and text-driven work waits for typing to pause.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "a redraw request sets a `pending` flag and schedules one pass; listeners on text go through a debounce."
      },
      "reference": "Editora [`ui/FxThrottle.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/FxThrottle.java)."
    },
    {
      "id": "PERF-07",
      "level": "MUST",
      "page": "performance",
      "pageTitle": "Performance",
      "section": "Hot paths",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/performance/#perf-07",
      "text": "Streams (process output, logs, progress) reach the FX thread in batches at least 16 ms apart, never one `runLater` per line.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "a reader thread appends to a buffer that the FX thread drains, with a minimum interval between drains."
      },
      "reference": "Editora [`process/OutputPump.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/process/OutputPump.java) (`MIN_DRAIN_INTERVAL_MILLIS`), [`ui/ConsoleAppender.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ConsoleAppender.java)."
    },
    {
      "id": "PERF-08",
      "level": "MUST",
      "page": "performance",
      "pageTitle": "Performance",
      "section": "Hot paths",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/performance/#perf-08",
      "text": "Work only on what is visible and only on what changed: no O(document) or O(list) work per keystroke, scroll or tick. Anything that can grow is shown in a virtualized control (`ListView`, `TableView`, a fixed cell size).",
      "why": null,
      "check": {
        "kind": "code",
        "text": "a listener on text, scroll or a timer re-processes the edited range or the visible rows, never the whole document or list; growing lists are `ListView` or `TableView`, not a `VBox` of nodes."
      },
      "reference": "Editora [`editor/highlight/HighlightPass.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/editor/highlight/HighlightPass.java), [`editor/minimap/MinimapRows.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/editor/minimap/MinimapRows.java)."
    },
    {
      "id": "PERF-09",
      "level": "SHOULD",
      "page": "performance",
      "pageTitle": "Performance",
      "section": "Hot paths",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/performance/#perf-09",
      "text": "A hot path allocates little: it reuses buffers and arrays, and caches data a repaint only reads.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the per-frame and per-keystroke code allocates no new arrays or images when the size has not changed."
      },
      "reference": "Editora [`editor/minimap/Minimap.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/editor/minimap/Minimap.java) (the snapshot image reused at the same size), [`MinimapRows.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/editor/minimap/MinimapRows.java)."
    },
    {
      "id": "PERF-10",
      "level": "SHOULD",
      "page": "performance",
      "pageTitle": "Performance",
      "section": "Hot paths",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/performance/#perf-10",
      "text": "CSS stays cheap: no `applyCss()` on a large subtree, stable style classes, and spans of the same style merged before they are applied.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`applyCss()` is called only on small nodes; style classes are not toggled per keystroke."
      },
      "reference": "Editora `SpanMerger` in [`editor/highlight/TextMateHighlighter.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/editor/highlight/TextMateHighlighter.java), [`docs/gotchas.md`](https://github.com/adriandeleon/Editora/blob/master/docs/gotchas.md)."
    },
    {
      "id": "PERF-11",
      "level": "MUST",
      "page": "performance",
      "pageTitle": "Performance",
      "section": "Memory and size",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/performance/#perf-11",
      "text": "Everything that grows is bounded: logs, histories, consoles, caches, undo. The newest is kept, with a note of what was cut.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "each such store has a test that fills it past its cap and finds the oldest dropped."
      },
      "reference": "Editora [`ui/MessageLog.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MessageLog.java) (200, [`MessageLogTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/MessageLogTest.java)), [`ui/DebugLog.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/DebugLog.java) ([`DebugLogTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/DebugLogTest.java)), [`test/OutputCap.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/test/OutputCap.java)."
    },
    {
      "id": "PERF-12",
      "level": "MUST",
      "page": "performance",
      "pageTitle": "Performance",
      "section": "Memory and size",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/performance/#perf-12",
      "text": "Large inputs are guarded by size and shape before they load: expensive features turn off past one threshold, the input opens read-only or capped past another, and what will not fit the free heap is refused.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the loader compares the size against named thresholds before reading the content."
      },
      "reference": "Editora [`EditorBuffer.LARGE_FILE_BYTES`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/editor/EditorBuffer.java) (5 MB) and `HUGE_FILE_BYTES` (50 MB), [`ui/LoadHeapGuard.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/LoadHeapGuard.java) ([`LoadHeapGuardTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/LoadHeapGuardTest.java))."
    },
    {
      "id": "PERF-13",
      "level": "MUST",
      "page": "performance",
      "pageTitle": "Performance",
      "section": "Memory and size",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/performance/#perf-13",
      "text": "A closed window releases what it held: listeners, timers, executors, file watchers, native resources.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a test opens and closes windows and checks nothing is left running."
      },
      "reference": "Editora [`FxWindowFixture.dispose`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/FxWindowFixture.java) ([`FxWindowFixtureLifecycleFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/FxWindowFixtureLifecycleFxTest.java)), [`ClosedLspManagers`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/lsp/ClosedLspManagers.java)."
    },
    {
      "id": "PERF-14",
      "level": "MUST",
      "page": "performance",
      "pageTitle": "Performance",
      "section": "Start-up",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/performance/#perf-14",
      "text": "The first frame comes first: only what the first window shows is built before it; tool windows, panels and pages build on first open.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a test opens a window and finds no closed tool window's panel built before the first paint."
      },
      "reference": "Editora's lazy [`ToolWindow`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ToolWindow.java) suppliers, [`LazyToolWindowsFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/LazyToolWindowsFxTest.java)."
    },
    {
      "id": "PERF-15",
      "level": "MUST",
      "page": "performance",
      "pageTitle": "Performance",
      "section": "Start-up",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/performance/#perf-15",
      "text": "What nobody waits for starts after the first frame has painted: the update check, extra fonts, indexes and caches.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a test finds the deferred work not started before the first paint."
      },
      "reference": "Editora [`ui/UpdateCheckScheduler.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/UpdateCheckScheduler.java), [`Fonts.loadRemainingAfterNextPaint`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/Fonts.java) ([`UpdateCheckSchedulerTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/UpdateCheckSchedulerTest.java), [`FontsDeferredLoadFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/FontsDeferredLoadFxTest.java), [`StartupDeferralFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/StartupDeferralFxTest.java))."
    },
    {
      "id": "PERF-16",
      "level": "SHOULD",
      "page": "performance",
      "pageTitle": "Performance",
      "section": "Start-up",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/performance/#perf-16",
      "text": "Config is read off the FX thread, before the toolkit needs it.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`main` starts the config read on its own thread before `launch`."
      },
      "reference": "Editora's `config-prefetch` thread in [`App.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/App.java)."
    },
    {
      "id": "PERF-17",
      "level": "SHOULD",
      "page": "performance",
      "pageTitle": "Performance",
      "section": "Start-up",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/performance/#perf-17",
      "text": "The app ships precompiled stylesheets (`.bss`) and an AOT cache trained on a real session.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the build converts the `.css` files to `.bss` and runs a training launch for the AOT cache."
      },
      "reference": "Editora [`scripts/css2bss.java`](https://github.com/adriandeleon/Editora/blob/master/scripts/css2bss.java), [`scripts/aot_build.java`](https://github.com/adriandeleon/Editora/blob/master/scripts/aot_build.java); Termina's and Mirada's [`scripts/aot-train.sh`](https://github.com/adriandeleon/Mirada/blob/main/scripts/aot-train.sh)."
    },
    {
      "id": "PERF-18",
      "level": "SHOULD",
      "page": "performance",
      "pageTitle": "Performance",
      "section": "Measure, don't guess",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/performance/#perf-18",
      "text": "Every change on a hot path says what it costs in its pull request: added FX-thread work, allocation per keystroke or scroll, extra layout passes, memory. \"Negligible\" is an answer; no answer is not.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "read the app's recent pull requests that touch a hot path."
      },
      "reference": "Editora [`docs/performance.md`](https://github.com/adriandeleon/Editora/blob/master/docs/performance.md) (its opening paragraph)."
    },
    {
      "id": "PERF-19",
      "level": "SHOULD",
      "page": "performance",
      "pageTitle": "Performance",
      "section": "Measure, don't guess",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/performance/#perf-19",
      "text": "Start-up is measured by a script that takes the median of several cold launches, and by phase marks in the app.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the repository has the script, and `main` and the first paint record phase marks."
      },
      "reference": "`scripts/measure-startup.sh` in Editora and Mirada; Editora [`perf/Startup.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/perf/Startup.java)."
    },
    {
      "id": "PERF-20",
      "level": "SHOULD",
      "page": "performance",
      "pageTitle": "Performance",
      "section": "Measure, don't guess",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/performance/#perf-20",
      "text": "The app can sample its FX thread when something stalls.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "an environment variable or property turns on a sampler of the FX thread's stack."
      },
      "reference": "Editora [`perf/Startup.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/perf/Startup.java) (`EDITORA_PERF_SAMPLE=1`)."
    },
    {
      "id": "PERF-21",
      "level": "SHOULD",
      "page": "performance",
      "pageTitle": "Performance",
      "section": "Measure, don't guess",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/performance/#perf-21",
      "text": "Each hot path that once regressed keeps a headless test.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "the fix for a hot-path regression adds a headless test that fails on the old code."
      },
      "reference": "Editora [`MinimapDeferredRenderFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/MinimapDeferredRenderFxTest.java)."
    },
    {
      "id": "PERF-22",
      "level": "SHOULD",
      "page": "performance",
      "pageTitle": "Performance",
      "section": "Measure, don't guess",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/performance/#perf-22",
      "text": "A suspected regression gets a number before and after, from temporary `System.nanoTime` instrumentation if nothing better exists.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "the pull request that fixes it states both numbers."
      },
      "reference": "Editora [`docs/performance.md`](https://github.com/adriandeleon/Editora/blob/master/docs/performance.md)."
    },
    {
      "id": "KBD-01",
      "level": "MUST",
      "page": "keyboard",
      "pageTitle": "Keyboard first",
      "section": "Commands",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/keyboard/#kbd-01",
      "text": "Every user-facing action is a `Command` (id, title, runnable) registered in one `CommandRegistry`.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "menu items, toolbar buttons, palette rows and key bindings run a command id through the registry; no control's handler does work no command can reach."
      },
      "reference": "Editora [`command/Command.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/command/Command.java), [`command/CommandRegistry.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/command/CommandRegistry.java)."
    },
    {
      "id": "KBD-02",
      "level": "SHOULD",
      "page": "keyboard",
      "pageTitle": "Keyboard first",
      "section": "Commands",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/keyboard/#kbd-02",
      "text": "Command ids are dotted and grouped by area: `file.open`, `view.toggleStatusBar`, `help.reportProblem`.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "every registered id matches `<area>.<camelCaseName>`."
      },
      "reference": "Editora [`ui/MenuBarModel.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MenuBarModel.java)."
    },
    {
      "id": "KBD-03",
      "level": "MUST",
      "page": "keyboard",
      "pageTitle": "Keyboard first",
      "section": "Commands",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/keyboard/#kbd-03",
      "text": "A command's title comes from `command.<id>` and its palette description from `command.<id>.desc` in the message catalogs.",
      "why": "a registered command is then localized and discoverable without extra work.",
      "check": {
        "kind": "test",
        "text": "a catalog parity test fails when a registered command has no `command.<id>` or `command.<id>.desc` key."
      },
      "reference": "Editora [`i18n/messages.properties`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/i18n/messages.properties), [`MessagesTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/i18n/MessagesTest.java)."
    },
    {
      "id": "KBD-04",
      "level": "SHOULD",
      "page": "keyboard",
      "pageTitle": "Keyboard first",
      "section": "Commands",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/keyboard/#kbd-04",
      "text": "A command that cannot run in the current context is shown grayed, with a tooltip that says why, not hidden.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the palette and menus list a disabled command with a reason, rather than filtering it out."
      },
      "reference": "Editora [`ui/Chrome.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/Chrome.java) (`paletteEnabled`, `disabledReason`)."
    },
    {
      "id": "KBD-05",
      "level": "MUST",
      "page": "keyboard",
      "pageTitle": "Keyboard first",
      "section": "Command Palette",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/keyboard/#kbd-05",
      "text": "The Command Palette opens with `M-x` in the Emacs keymap and `Ctrl+Shift+P` (`Cmd+Shift+P` on macOS) in the others; the IntelliJ keymap may use IntelliJ's own Find Action chord, `Ctrl+Shift+A` (`Cmd+Shift+A`), instead.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "each bundled keymap binds that chord to the palette command."
      },
      "reference": "Editora [`keymaps/emacs.json`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/keymaps/emacs.json) (`M-x`), [`cua.json`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/keymaps/cua.json) and [`vscode.json`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/keymaps/vscode.json) (`C-S-p`), [`cua.mac.json`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/keymaps/cua.mac.json) (`Cmd-S-p`), all to `palette.show`; [`intellij.json`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/keymaps/intellij.json) binds `C-S-a`."
    },
    {
      "id": "KBD-06",
      "level": "SHOULD",
      "page": "keyboard",
      "pageTitle": "Keyboard first",
      "section": "Command Palette",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/keyboard/#kbd-06",
      "text": "The palette matches fuzzily over title, id and description; a query that names a command's title outranks a fuzzy hit. Each row shows the command's binding in the active keymap. See the [Command Palette template](https://pauta-project.dev/4.5.0/templates/command-palette/).",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a ranking test puts the title match first."
      },
      "reference": "Editora [`ui/CommandPalette.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/CommandPalette.java), [`search/FuzzyMatch.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/search/FuzzyMatch.java)."
    },
    {
      "id": "KBD-07",
      "level": "MUST",
      "page": "keyboard",
      "pageTitle": "Keyboard first",
      "section": "Command Palette",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/keyboard/#kbd-07",
      "text": "The palette is an in-scene overlay in the window's root `StackPane`, not a `javafx.stage.Popup`.",
      "why": "on Windows a Popup does not reliably take OS keyboard focus, and the whole app can stop receiving keystrokes.",
      "check": {
        "kind": "code",
        "text": "the palette and every picker add their node to the root `StackPane`; none creates a `Popup`."
      },
      "reference": "Editora [`ui/CommandPalette.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/CommandPalette.java)."
    },
    {
      "id": "KBD-09",
      "level": "MUST",
      "page": "keyboard",
      "pageTitle": "Keyboard first",
      "section": "Keymaps",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/keyboard/#kbd-09",
      "text": "Emacs and CUA keymaps ship as JSON resources, CUA with a `.mac.json` variant where Cmd replaces Ctrl.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`emacs.json`, `cua.json` and `cua.mac.json` are in the app's resources."
      },
      "reference": "Editora [`src/main/resources/com/editora/keymaps/`](https://github.com/adriandeleon/Editora/tree/master/src/main/resources/com/editora/keymaps)."
    },
    {
      "id": "KBD-10",
      "level": "SHOULD",
      "page": "keyboard",
      "pageTitle": "Keyboard first",
      "section": "Keymaps",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/keyboard/#kbd-10",
      "text": "IntelliJ, VS Code and Sublime keymaps ship the same way, each with its `.mac.json` variant.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`intellij`, `vscode` and `sublime` `.json` and `.mac.json` files are in the resources."
      },
      "reference": "Editora [`src/main/resources/com/editora/keymaps/`](https://github.com/adriandeleon/Editora/tree/master/src/main/resources/com/editora/keymaps)."
    },
    {
      "id": "KBD-21",
      "level": "MUST",
      "page": "keyboard",
      "pageTitle": "Keyboard first",
      "section": "Keymaps",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/keyboard/#kbd-21",
      "text": "A keymap's `.mac.json` variant binds the same commands as the keymap it varies. A chord may differ, to put `Cmd` where the other has `Ctrl`, to follow the macOS keymap of the editor it copies, or where macOS keeps the chord for itself (`Cmd+Space`, `Cmd+Tab`). See [Same on every OS](https://pauta-project.dev/4.5.0/same-on-every-os/).",
      "why": "a command with no chord on one OS is a command that user never finds from the keyboard.",
      "check": {
        "kind": "test",
        "text": "a test loads each keymap and its `.mac.json` variant and compares the commands they bind."
      },
      "reference": "Editora [`KeymapsTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/command/KeymapsTest.java) (`guiKeymapsBindSameCommandSetOnBothPlatforms`)."
    },
    {
      "id": "KBD-11",
      "level": "MUST",
      "page": "keyboard",
      "pageTitle": "Keyboard first",
      "section": "Keymaps",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/keyboard/#kbd-11",
      "text": "Keymaps are applied in layers: base keymap → user overrides → plugin keymaps → the user's own bindings again. An app without plugins has the first two.",
      "why": "the user always has the last word, and a plugin can still use a chord the user freed.",
      "check": {
        "kind": "code",
        "text": "one place applies the layers in that order."
      },
      "reference": "Editora [`ui/KeymapLayers.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/KeymapLayers.java)."
    },
    {
      "id": "KBD-12",
      "level": "SHOULD",
      "page": "keyboard",
      "pageTitle": "Keyboard first",
      "section": "Keymaps",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/keyboard/#kbd-12",
      "text": "A keymap editor in Settings lists every command with its chord, is searchable, and warns of conflicts.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "open Settings → Keymap, search, and bind a chord that is taken."
      },
      "reference": "Editora [`ui/SettingsKeymapsPage.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/SettingsKeymapsPage.java); conflicts from [`KeybindingEdits.takenDefaults`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/command/KeybindingEdits.java)."
    },
    {
      "id": "KBD-13",
      "level": "SHOULD",
      "page": "keyboard",
      "pageTitle": "Keyboard first",
      "section": "Keymaps",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/keyboard/#kbd-13",
      "text": "No command's chord is written into translated text. Every label shows the binding from the active keymap. Fixed keys of a control (Enter, Tab, Esc, arrows) and keys meant for another program may be written.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "no message catalog value names a command's chord (`Ctrl+`, `Cmd+`, `C-x`, `M-x`); chords are rendered by one formatter."
      },
      "reference": "Editora [`command/ChordFormat.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/command/ChordFormat.java), the one place a binding is rendered. Editora's `command.edit.universalArgument` title still carries `C-u`."
    },
    {
      "id": "KBD-14",
      "level": "SHOULD",
      "page": "keyboard",
      "pageTitle": "Keyboard first",
      "section": "Keymaps",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/keyboard/#kbd-14",
      "text": "A multi-key prefix (`C-x …`) shows a which-key style hint listing the possible next keys.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "press `C-x` in the Emacs keymap and wait."
      },
      "reference": "no app lists the next keys yet. Editora echoes only the pending prefix (`C-x -`) in the status bar ([`command/KeyDispatcher.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/command/KeyDispatcher.java))."
    },
    {
      "id": "KBD-15",
      "level": "MUST",
      "page": "keyboard",
      "pageTitle": "Keyboard first",
      "section": "Focus and accessibility",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/keyboard/#kbd-15",
      "text": "Every interactive control is reachable with Tab and operable with Space or Enter. A button whose command the keyboard reaches another way is the exception: toolbar buttons ([TBAR-02](https://pauta-project.dev/4.5.0/toolbars-and-tooltips/#tbar-02)) and the find bar's buttons ([Find bar](https://pauta-project.dev/4.5.0/templates/find-bar/)) stay out of the Tab order. See [Accessibility](https://pauta-project.dev/4.5.0/accessibility/).",
      "why": "a control that Tab can't reach is one a keyboard-only or screen-reader user can't use at all.",
      "check": {
        "kind": "by hand",
        "text": "Tab through every window and dialog without the mouse."
      },
      "reference": "Editora; [`FocusRingFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/FocusRingFxTest.java) holds that every control family draws the focus ring when Tab reaches it."
    },
    {
      "id": "KBD-16",
      "level": "SHOULD",
      "page": "keyboard",
      "pageTitle": "Keyboard first",
      "section": "Focus and accessibility",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/keyboard/#kbd-16",
      "text": "The keyboard focus ring is one layer of `:focus-visible` rules in `app.css`, after every rule that sets a border or background on the same controls, since rules of equal specificity are decided by order.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "an FX test tabs to each control family and asserts the ring."
      },
      "reference": "Editora [`app.css`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/styles/app.css) (*Keyboard focus*, one layer for every control), [`FocusRingFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/FocusRingFxTest.java)."
    },
    {
      "id": "KBD-18",
      "level": "SHOULD",
      "page": "keyboard",
      "pageTitle": "Keyboard first",
      "section": "Focus and accessibility",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/keyboard/#kbd-18",
      "text": "On/off rows use a keyboard-operable switch with the `TOGGLE_BUTTON` role.",
      "why": "a bare AtlantaFX `ToggleSwitch` is mouse-only.",
      "check": {
        "kind": "code",
        "text": "no `new ToggleSwitch` outside the switch class."
      },
      "reference": "Editora [`ui/SettingSwitch.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/SettingSwitch.java)."
    },
    {
      "id": "ACC-01",
      "level": "MUST",
      "page": "accessibility",
      "pageTitle": "Accessibility",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/accessibility/#acc-01",
      "text": "Every control a person can reach with Tab or the mouse has an accessible name: its own text, a `Label` whose `labelFor` is the control, or `setAccessibleText`. A row drawn from a graphic (a `CustomMenuItem`, a list cell that lays out its own nodes) carries its text too.",
      "why": "a screen reader announces an unnamed control as \"button\", or says nothing.",
      "check": {
        "kind": "test",
        "text": "an FX test opens each window and dialog and fails on a focus-traversable node that has no text, no accessible text and no label pointing at it."
      },
      "reference": "Editora names its controls area by area ([`NamedControlsFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/NamedControlsFxTest.java)), and [`ui/MainMenuBar.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MainMenuBar.java) sets each `CustomMenuItem`'s text beside the row it draws. No app has the test that sweeps every window yet."
    },
    {
      "id": "ACC-02",
      "level": "SHOULD",
      "page": "accessibility",
      "pageTitle": "Accessibility",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/accessibility/#acc-02",
      "text": "A control the app builds from panes or draws itself says what it is: `setAccessibleRole` with the role it acts as (`BUTTON`, `TOGGLE_BUTTON`, `LIST_VIEW`, `TREE_ITEM`), its state answered from `queryAccessibleAttribute` (selected, expanded, checked), and `notifyAccessibleAttributeChanged` when the state changes.",
      "why": "without a role, a screen reader can't tell a status-bar segment that opens a picker from a label.",
      "check": {
        "kind": "code",
        "text": "every `Pane`, `Region`, `Label` or `Canvas` that handles a click or a key sets an accessible role."
      },
      "reference": "Editora's status-bar segments ([`ui/StatusBar.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/StatusBar.java), `BUTTON` with accessible help) and [`ui/SettingSwitch.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/SettingSwitch.java) (`TOGGLE_BUTTON`)."
    },
    {
      "id": "ACC-03",
      "level": "SHOULD",
      "page": "accessibility",
      "pageTitle": "Accessibility",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/accessibility/#acc-03",
      "text": "An app that paints content on a `Canvas` (a map, a strip of images, a terminal grid) gives it to the screen reader: an accessible text that sums it up and, where a person moves through items in it, one accessible node for each item on screen.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a test reads the canvas's accessible text, or the roles and names of the nodes it exposes."
      },
      "reference": "Editora [`ui/MapAccessibleRows.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MapAccessibleRows.java) (the Project Map's rows on screen, as `TREE_ITEM` nodes under a `TREE_VIEW`)."
    },
    {
      "id": "ACC-04",
      "level": "SHOULD",
      "page": "accessibility",
      "pageTitle": "Accessibility",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/accessibility/#acc-04",
      "text": "Motion follows the OS: while `Platform.getPreferences().isReducedMotion()` is true, an animation jumps to its end, and a change to the setting applies at once.",
      "why": "sliding and fading can make a person dizzy or sick, and they turned motion off in the OS for that reason.",
      "check": {
        "kind": "code",
        "text": "every `Transition` or `Timeline` that moves or fades part of the UI starts through one helper that reads `reducedMotionProperty()`."
      },
      "reference": "no app yet. Mirada fades its on-screen controls in and out ([`ui/OnScreenControls.java`](https://github.com/adriandeleon/Mirada/blob/main/src/main/java/com/mirada/ui/OnScreenControls.java), a `FadeTransition`) and reads no motion setting; the other apps don't animate their UI."
    },
    {
      "id": "ACC-05",
      "level": "SHOULD",
      "page": "accessibility",
      "pageTitle": "Accessibility",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/accessibility/#acc-05",
      "text": "Color is never the only signal: a state shown in color (an error, a changed line, a status) also shows a word, a glyph or a shape.",
      "why": "about one man in twelve can't tell red from green.",
      "check": {
        "kind": "by hand",
        "text": "look at a grayscale screenshot of each window and find every state still told apart."
      },
      "reference": "Editora's echo area colors an error and also says what failed ([WIN-01](https://pauta-project.dev/4.5.0/window-shell/#win-01))."
    },
    {
      "id": "ACC-06",
      "level": "SHOULD",
      "page": "accessibility",
      "pageTitle": "Accessibility",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/accessibility/#acc-06",
      "text": "A command moves focus to the next region of the window (the content, each open panel), and another to the previous one, and every keymap binds both.",
      "why": "Tab walks through every control inside a region; with several panels open, a keyboard user needs a way to jump between them.",
      "check": {
        "kind": "code",
        "text": "the two commands are registered and bound in each bundled keymap."
      },
      "reference": "Editora's `window.other` (\"Cycle focus between the editor and tool windows\"), bound only in the Emacs keymap (`C-x o`). `F6`, the Windows convention, is taken in Editora's other keymaps."
    },
    {
      "id": "ACC-07",
      "level": "SHOULD",
      "page": "accessibility",
      "pageTitle": "Accessibility",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/accessibility/#acc-07",
      "text": "Before a release, the smoke test on Windows and macOS ([REL-29](https://pauta-project.dev/4.5.0/release/#rel-29)) includes a pass with the screen reader: with Narrator and with VoiceOver, open the Command Palette, run a command, and move through Settings, hearing each control's name and role.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "the release checklist has the step, and someone did it for this release."
      },
      "reference": "no app yet."
    },
    {
      "id": "WIN-01",
      "level": "MUST",
      "page": "window-shell",
      "pageTitle": "Window shell",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/window-shell/#win-01",
      "text": "A status bar is always present (it can be toggled). Its left side is the *echo area*: one line of feedback for the last action, errors in red and warnings in amber. Clicking it opens the Message Log.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the echo label switches between an error and a warning style class, and its click handler runs the Message Log command."
      },
      "reference": "Editora [`ui/StatusBar.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/StatusBar.java) (`status-echo-error`, `status-echo-warn`; a click runs `view.messageLog`) and the [Message Log template](https://pauta-project.dev/4.5.0/templates/message-log/)."
    },
    {
      "id": "WIN-03",
      "level": "SHOULD",
      "page": "window-shell",
      "pageTitle": "Window shell",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/window-shell/#win-03",
      "text": "The title bar uses JavaFX 27's `HeaderBar` with `StageStyle.EXTENDED` to carry the menu or tabs, with a decorated-window fallback, and `useSystemMenuBar` on macOS.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the main stage is created `StageStyle.EXTENDED` with a `HeaderBar`, a setting falls back to a decorated window, and the menu bar sets `useSystemMenuBar` on macOS."
      },
      "reference": "Editora [`ui/ExtendedWindow.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ExtendedWindow.java), [`ui/MainMenuBar.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MainMenuBar.java)."
    },
    {
      "id": "WIN-04",
      "level": "SHOULD",
      "page": "window-shell",
      "pageTitle": "Window shell",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/window-shell/#win-04",
      "text": "Native dialogs go through one helper that attaches the app stylesheet and the UI font.",
      "why": "a dialog is its own scene and inherits neither.",
      "check": {
        "kind": "code",
        "text": "every `Alert` and `Dialog` the app builds passes through the helper."
      },
      "reference": "Editora [`ui/Dialogs.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/Dialogs.java) ([`Dialogs.styled`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/Dialogs.java))."
    },
    {
      "id": "WIN-11",
      "level": "MUST",
      "page": "window-shell",
      "pageTitle": "Window shell",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/window-shell/#win-11",
      "text": "A dialog's buttons are in the same order on every OS, with Cancel to the left of the action, as the [Confirm dialog](https://pauta-project.dev/4.5.0/templates/confirm-dialog/) draws them: the dialog's `ButtonBar` gets one fixed order, never JavaFX's default for the OS. See [Same on every OS](https://pauta-project.dev/4.5.0/same-on-every-os/).",
      "why": "JavaFX orders a `ButtonBar` by the OS it runs on (`BUTTON_ORDER_WINDOWS`, `_MAC_OS`, `_LINUX`), so the same confirmation puts its action on the left on Windows and on the right on macOS and Linux.",
      "check": {
        "kind": "code",
        "text": "the dialog helper ([WIN-04](https://pauta-project.dev/4.5.0/window-shell/#win-04)), or each dialog, calls `setButtonOrder` on the dialog pane's `ButtonBar` with one constant."
      },
      "reference": "no app yet. Editora's Git confirmations give their buttons the `OK_DONE` and `CANCEL_CLOSE` roles and leave the order to JavaFX."
    },
    {
      "id": "WIN-08",
      "level": "SHOULD",
      "page": "window-shell",
      "pageTitle": "Window shell",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/window-shell/#win-08",
      "text": "Window size, position, maximized state and open items are restored on the next launch. `--no-session` skipping the restore is [CLI-04](https://pauta-project.dev/4.5.0/command-line/#cli-04).",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a round-trip test of the saved workspace state."
      },
      "reference": "Editora [`config/WorkspaceState.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/config/WorkspaceState.java) (`windowX` … `windowMaximized`), [`ui/WindowSessionCoordinator.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/WindowSessionCoordinator.java), [`App.noSessionFlag`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/App.java); tests [`WorkspaceStateV29Test`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/config/WorkspaceStateV29Test.java), [`AppArgsTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/AppArgsTest.java), [`NoSessionStartupFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/NoSessionStartupFxTest.java)."
    },
    {
      "id": "WIN-09",
      "level": "SHOULD",
      "page": "window-shell",
      "pageTitle": "Window shell",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/window-shell/#win-09",
      "text": "UI and content zoom from the keyboard (`Ctrl/Cmd +`, `-`, `0`), kept across launches.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "zoom in, out and reset are commands bound in every keymap, and the zoom level is a saved setting."
      },
      "reference": "Editora zooms content only: `view.textZoomIn`, `view.textZoomOut` and `view.textZoomReset`, kept in [`Settings.fontZoom`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/config/Settings.java)."
    },
    {
      "id": "WIN-10",
      "level": "MAY",
      "page": "window-shell",
      "pageTitle": "Window shell",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/window-shell/#win-10",
      "text": "Modes: Zen (no chrome), Simple (fewer menus for new users), Expert.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "each mode is a command, and one truth table decides which chrome each mode shows."
      },
      "reference": "Editora [`ui/WindowChromeCoordinator.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/WindowChromeCoordinator.java) (`toggleZen`, `applySimpleMode`) over the truth table in [`ui/Chrome.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/Chrome.java)."
    },
    {
      "id": "ICON-01",
      "level": "MUST",
      "page": "icons-and-color",
      "pageTitle": "Icons and color",
      "section": "Type",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/icons-and-color/#icon-01",
      "text": "Inter is attached by a *scene* stylesheet on every window's scene, dialogs, popups and tooltips included, not by a rule in the app stylesheet.",
      "why": "dialogs, the Settings window, the palette, context menus and tooltips each live in a scene of their own that does not share `app.css`, and a scene sheet is re-applied cleanly when the theme switches at run time (`setUserAgentStylesheet`). AtlantaFX neither bundles nor names Inter, and JavaFX does not fall through a font-family list, so without the sheet the whole interface renders in the platform's \"System\" face.",
      "check": {
        "kind": "code",
        "text": "a listener on `Window.getWindows()` adds `ui-font.css` to each window's scene, and to a new scene when the window's scene changes; no `.root` rule in `app.css` sets `-fx-font-family`."
      },
      "reference": "Editora [`App.installUiFont`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/App.java), [`styles/ui-font.css`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/styles/ui-font.css). Termina and Torrenta carry the same sheet."
    },
    {
      "id": "ICON-02",
      "level": "MUST",
      "page": "icons-and-color",
      "pageTitle": "Icons and color",
      "section": "Type",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/icons-and-color/#icon-02",
      "text": "The app bundles Inter's four faces and registers them before any CSS is applied; it never maps the platform's own UI font.",
      "why": "an earlier macOS-only sheet used San Francisco, which JavaFX faux-bolds; Inter has a real bold on every platform.",
      "check": {
        "kind": "code",
        "text": "`Inter-Regular`, `Inter-Bold`, `Inter-Italic` and `Inter-BoldItalic` `.ttf` are under the app's `fonts/inter/` with their `OFL.txt`, and `Font.loadFont` runs on them before the first window is shown."
      },
      "reference": "Editora [`src/main/resources/com/editora/fonts/inter/`](https://github.com/adriandeleon/Editora/tree/master/src/main/resources/com/editora/fonts/inter), [`ui/Fonts.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/Fonts.java) (`loadForFirstPaint`, called from [`App`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/App.java)). Termina and Torrenta bundle the same four faces."
    },
    {
      "id": "ICON-04",
      "level": "SHOULD",
      "page": "icons-and-color",
      "pageTitle": "Icons and color",
      "section": "The palette: Caret & Ink",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/icons-and-color/#icon-04",
      "text": "A theme file follows the vendored AtlantaFX community themes: a `.root` block of `-color-*` tokens, then component rules that reference only those tokens.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the file's first rule is `.root`, and no rule after it holds a `#` hex."
      },
      "reference": "Editora [`styles/atlantafx-themes/editora-light.css`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/styles/atlantafx-themes/editora-light.css), `editora-dark.css`."
    },
    {
      "id": "ICON-05",
      "level": "SHOULD",
      "page": "icons-and-color",
      "pageTitle": "Icons and color",
      "section": "The palette: Caret & Ink",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/icons-and-color/#icon-05",
      "text": "A new app ships the Caret & Ink pair as its default theme, with `editora-light.css` and `editora-dark.css` copied unchanged into its own `styles/`.",
      "why": "the palette is the family's, not the editor's.",
      "check": {
        "kind": "code",
        "text": "the app's two files are identical to Editora's."
      },
      "reference": "Torrenta and Termina `styles/`. Both copies of `editora-dark.css` match Editora's; both copies of `editora-light.css` still have the earlier `-color-accent-fg`, `-color-warning-fg` and `-color-success-fg`, which Editora has since darkened."
    },
    {
      "id": "ICON-06",
      "level": "SHOULD",
      "page": "icons-and-color",
      "pageTitle": "Icons and color",
      "section": "The palette: Caret & Ink",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/icons-and-color/#icon-06",
      "text": "Brace (`-state-key`) is a `ladder()` over `-color-bg-default` that picks a deep ink on a light ground and a lighter periwinkle the darker the ground gets, and reads at 4.5:1 or more on every bundled theme's default and subtle surfaces.",
      "why": "Brace has no AtlantaFX role, so it has to be a literal.",
      "check": {
        "kind": "test",
        "text": "a contrast test resolves the ladder against every bundled theme's grounds."
      },
      "reference": "Editora [`app.css`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/styles/app.css) (`.root`), [`StyleContrastTest.theKeyboardPeriwinkleReadsOnEveryBundledAppTheme`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/StyleContrastTest.java)."
    },
    {
      "id": "ICON-07",
      "level": "MUST",
      "page": "icons-and-color",
      "pageTitle": "Icons and color",
      "section": "State colors",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/icons-and-color/#icon-07",
      "text": "Each state color is named once, as a `-state-*` token on `.root` that chains to one of the theme's roles (or a `ladder()` of its ground), and component rules use the token.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the `-state-*` tokens are declared only in the `.root` block at the top of `app.css`, each chaining to a `-color-*` role or a `ladder()`."
      },
      "reference": "Editora [`styles/app.css`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/styles/app.css) (`.root`)."
    },
    {
      "id": "ICON-08",
      "level": "MUST",
      "page": "icons-and-color",
      "pageTitle": "Icons and color",
      "section": "State colors",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/icons-and-color/#icon-08",
      "text": "No fixed hex in a component rule.",
      "why": "a hex suits one theme; the roles track every theme for free.",
      "check": {
        "kind": "code",
        "text": "outside the `.root` token block, `app.css` holds no `#` hex. A test fails a severity or debug color that is not a state token."
      },
      "reference": "Editora [`StyleContrastTest.severityAndDebugColoursComeFromTheStateTokens`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/StyleContrastTest.java). Editora doesn't yet pass the whole check: `.breakpoint-marker`, `.exec-arrow`, `.view-mode-bar`, `.recent-remove`, `.personal-note-tooltip-content`, the fold-gutter markers and the default editor and Markdown preview palettes in [`app.css`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/styles/app.css) still carry fixed hexes."
    },
    {
      "id": "ICON-09",
      "level": "SHOULD",
      "page": "icons-and-color",
      "pageTitle": "Icons and color",
      "section": "State colors",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/icons-and-color/#icon-09",
      "text": "Readable text uses `-color-fg-muted` or stronger, which is 4.5:1 on the default, subtle and overlay grounds in both flagship themes: a line of UI text is `-color-fg-default` and secondary text `-color-fg-muted`. `-color-fg-subtle` (2.7:1 to 3.9:1, under 3:1 on Editora Light's subtle and inset grounds) is for disabled or decorative text only.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a contrast test computes muted ink on each ground, and fails a readable selector set in `-color-fg-subtle`."
      },
      "reference": "Editora [`StyleContrastTest.textThatMustBeReadUsesTheMutedRoleNotSubtle`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/StyleContrastTest.java)."
    },
    {
      "id": "ICON-10",
      "level": "MUST",
      "page": "icons-and-color",
      "pageTitle": "Icons and color",
      "section": "State colors",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/icons-and-color/#icon-10",
      "text": "Tinted text (`-color-<role>-fg`) reaches 4.5:1 on its own subtle fill and on both grounds.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a contrast test computes each role's `-fg` on its `-subtle`, on `-color-bg-subtle` and on `-color-bg-default`, in both flagship themes."
      },
      "reference": "Editora [`StyleContrastTest.lightTintedTextReachesAaOnItsOwnGroundAndOnTheSubtleSurface`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/StyleContrastTest.java), `darkTintedTextStaysAa`."
    },
    {
      "id": "ICON-11",
      "level": "MUST",
      "page": "icons-and-color",
      "pageTitle": "Icons and color",
      "section": "State colors",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/icons-and-color/#icon-11",
      "text": "Ink on an emphasis fill is `-color-fg-emphasis`, never a fixed white: the token is white in the light themes and a dark ink in the dark ones.",
      "why": "white on the dark accent is 1.68:1.",
      "check": {
        "kind": "test",
        "text": "a contrast test computes `-color-fg-emphasis` on each role's `-emphasis`, and the rules that paint on an emphasis fill use it."
      },
      "reference": "Editora [`StyleContrastTest.inkOnAnEmphasisFillIsTheThemesOnEmphasisColour`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/StyleContrastTest.java)."
    },
    {
      "id": "ICON-12",
      "level": "MUST",
      "page": "icons-and-color",
      "pageTitle": "Icons and color",
      "section": "State colors",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/icons-and-color/#icon-12",
      "text": "One focus ring, `-focus-ring: -color-accent-emphasis`, drawn by the `:focus-visible` block in `app.css` ([KBD-16](https://pauta-project.dev/4.5.0/keyboard/#kbd-16)), at 3:1 or better on every surface (see [Keyboard first](https://pauta-project.dev/4.5.0/keyboard/)).",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a test reads `-focus-ring` from `.root` and computes it on the default, subtle, inset and overlay grounds."
      },
      "reference": "Editora [`app.css`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/styles/app.css) (*Keyboard focus*), [`StyleContrastTest.theFocusRingIsAtLeastThreeToOneOnEverySurface`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/StyleContrastTest.java)."
    },
    {
      "id": "ICON-13",
      "level": "SHOULD",
      "page": "icons-and-color",
      "pageTitle": "Icons and color",
      "section": "State colors",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/icons-and-color/#icon-13",
      "text": "A brand hue the theme has no role for (periwinkle, olive, violet) is a `ladder()` of `-color-bg-default`, never a fixed pair.",
      "why": "the old fixed light hexes read at 3.2:1 on Editora Dark.",
      "check": {
        "kind": "test",
        "text": "a contrast test resolves each ladder on every bundled theme's ground."
      },
      "reference": "Editora [`app.css`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/styles/app.css) (`-state-olive`, `-state-violet`, `-state-key`), [`StyleContrastTest.theGitOliveAndVioletFollowTheAppThemesGround`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/StyleContrastTest.java)."
    },
    {
      "id": "ICON-14",
      "level": "SHOULD",
      "page": "icons-and-color",
      "pageTitle": "Icons and color",
      "section": "State colors",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/icons-and-color/#icon-14",
      "text": "A pure test reads the stylesheets and does the WCAG arithmetic.",
      "why": "a contrast regression is invisible in a code diff.",
      "check": {
        "kind": "code",
        "text": "a test class reads the app's `.css` resources and computes contrast ratios without starting the toolkit."
      },
      "reference": "Editora [`StyleContrastTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/StyleContrastTest.java). Mirada's [`AccentTest`](https://github.com/adriandeleon/Mirada/blob/main/src/test/java/com/mirada/ui/AccentTest.java) checks that the accent reads as text on both grounds; Termina's [`ThemeTest`](https://github.com/adriandeleon/Termina/blob/master/src/test/java/com/termina/ui/ThemeTest.java) keeps every chromatic color of its terminal schemes legible."
    },
    {
      "id": "ICON-15",
      "level": "MUST",
      "page": "icons-and-color",
      "pageTitle": "Icons and color",
      "section": "Themes",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/icons-and-color/#icon-15",
      "text": "The app has light and dark themes and switches between them at run time, without a restart (see [Window shell](https://pauta-project.dev/4.5.0/window-shell/)).",
      "why": null,
      "check": {
        "kind": "code",
        "text": "picking a theme calls `Application.setUserAgentStylesheet` in the running app."
      },
      "reference": "Editora [`ui/Themes.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/Themes.java) (`applyAppTheme`)."
    },
    {
      "id": "ICON-16",
      "level": "MUST",
      "page": "icons-and-color",
      "pageTitle": "Icons and color",
      "section": "Themes",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/icons-and-color/#icon-16",
      "text": "A \"follow the system\" choice applies the light or dark theme to match the system's color scheme, and changes with it.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the theme setting has a system value, and a listener on `Platform.getPreferences().colorSchemeProperty()` re-applies the theme."
      },
      "reference": "Mirada [`settings/Settings.java`](https://github.com/adriandeleon/Mirada/blob/main/src/main/java/com/mirada/settings/Settings.java) (`ThemeChoice.SYSTEM`), [`ui/Theme.java`](https://github.com/adriandeleon/Mirada/blob/main/src/main/java/com/mirada/ui/Theme.java); nux [`config/Advanced.java`](https://github.com/adriandeleon/nux/blob/master/src/main/java/com/nux/config/Advanced.java) (`THEME_SYSTEM`), [`ui/Theme.java`](https://github.com/adriandeleon/nux/blob/master/src/main/java/com/nux/ui/Theme.java). Editora, Torrenta, Termina and Modula don't yet: their pickers list named themes only."
    },
    {
      "id": "ICON-17",
      "level": "MUST",
      "page": "icons-and-color",
      "pageTitle": "Icons and color",
      "section": "Themes",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/icons-and-color/#icon-17",
      "text": "A theme name the app does not know falls back to the first-run default theme.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the lookup from a saved name to a theme ends in the default, not an exception."
      },
      "reference": "Editora [`Themes.themeFor`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/Themes.java), falling back to [`Themes.DEFAULT`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/Themes.java) (Editora Light)."
    },
    {
      "id": "ICON-18",
      "level": "SHOULD",
      "page": "icons-and-color",
      "pageTitle": "Icons and color",
      "section": "Themes",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/icons-and-color/#icon-18",
      "text": "Semantic colors never decorate: a theme may change the teal, the ground and the ink, but amber still means \"not durable yet\", red \"broken\" and green \"verified\".",
      "why": null,
      "check": {
        "kind": "code",
        "text": "every rule that uses `-state-amber`, `-state-red` or `-state-green` marks one of the meanings in the State colors table."
      },
      "reference": "Editora [`app.css`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/styles/app.css)."
    },
    {
      "id": "ICON-19",
      "level": "MUST",
      "page": "icons-and-color",
      "pageTitle": "Icons and color",
      "section": "Icons",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/icons-and-color/#icon-19",
      "text": "A glyph node carries one family's style class, `icon-line` or `toolbar-icon`, never both.",
      "why": "a line glyph is colored by its stroke, and any `X .toolbar-icon` fill rule (there are dozens) would paint its outline solid. A glyph that moves family moves its CSS with it.",
      "check": {
        "kind": "test",
        "text": "a test builds every line glyph and fails when one also carries `toolbar-icon`."
      },
      "reference": "Editora [`ui/Icons.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/Icons.java) (`line`, `of`), [`MenuIconFamilyFxTest.aLineGlyphIsNeverAlsoTaggedAsAFilledOne`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/MenuIconFamilyFxTest.java)."
    },
    {
      "id": "ICON-20",
      "level": "MUST",
      "page": "icons-and-color",
      "pageTitle": "Icons and color",
      "section": "Icons",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/icons-and-color/#icon-20",
      "text": "The same action wears the same glyph wherever it is reached: Save is one floppy on the toolbar, in the File menu and in a tab's menu.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a test compares the path data and style class of each action's glyph across the icon classes."
      },
      "reference": "Editora [`ui/MenuBarIcons.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MenuBarIcons.java) reuses [`Icons`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/Icons.java); [`editor/MenuIcons.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/editor/MenuIcons.java) (the editor package may not depend on `ui`) copies each twin's family and path data verbatim, held by [`MenuIconFamilyFxTest.everySharedActionUsesTheSameGlyphInBothIconSets`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/MenuIconFamilyFxTest.java)."
    },
    {
      "id": "ICON-23",
      "level": "SHOULD",
      "page": "icons-and-color",
      "pageTitle": "Icons and color",
      "section": "Icons",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/icons-and-color/#icon-23",
      "text": "A file's icon comes from a pure function from file name to icon key, unit-tested without the toolkit, and any type it does not know gets the generic document glyph, so a new type never regresses the look.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a unit test resolves names to keys, an unknown one to the generic key."
      },
      "reference": "Editora [`ui/FileIcons.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/FileIcons.java): `iconKeyFor(name)` resolves the key, `forFileName` turns it into a node; brand logos from Simple Icons, category glyphs (image, archive, PDF, table, lock, JSON, settings) from Material. [`FileIconsTest.unknownAndNullFallBackToGeneric`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/FileIconsTest.java)."
    },
    {
      "id": "ICON-24",
      "level": "MUST",
      "page": "icons-and-color",
      "pageTitle": "Icons and color",
      "section": "Icons",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/icons-and-color/#icon-24",
      "text": "Every glyph set and font the app ships is credited in `NOTICE` with its license.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "each icon source named in the icon classes and each family under `fonts/` has an entry in `NOTICE`."
      },
      "reference": "Editora [`NOTICE`](https://github.com/adriandeleon/Editora/blob/master/NOTICE): Material Design Icons (Apache-2.0), Simple Icons (CC0; the logos stay their owners' trademarks), Inter and the monospace faces (OFL), and the glyph sets inside the bundled Symbols Nerd Font, Octicons and Seti UI (MIT) among them."
    },
    {
      "id": "TBAR-01",
      "level": "MUST",
      "page": "toolbars-and-tooltips",
      "pageTitle": "Toolbars and tooltips",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/toolbars-and-tooltips/#tbar-01",
      "text": "Every icon-only button has a name: one helper sets its tooltip and its accessible text from the same string.",
      "why": "a hand-rolled button gets the tooltip and forgets the name, which is how Editora once had seven copies of the helper drifting apart, and how a screen reader comes to announce \"button\".",
      "check": {
        "kind": "code",
        "text": "every icon-only `Button` is built by `Icons.button` or `Icons.toolbarButton`, or passed to `Icons.name`; none calls `setTooltip` without `setAccessibleText`."
      },
      "reference": "Editora [`ui/Icons.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/Icons.java) (`button`, `toolbarButton`, `name`); Torrenta's copy of all three. nux sets both by hand on its \"?\" button for the same reason. Editora doesn't yet on its main toolbar: [`WindowToolbar.setupButton`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/WindowToolbar.java) and [`ToolbarCoordinator.buildExtraButton`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ToolbarCoordinator.java) set the tooltip only."
    },
    {
      "id": "TBAR-02",
      "level": "MUST",
      "page": "toolbars-and-tooltips",
      "pageTitle": "Toolbars and tooltips",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/toolbars-and-tooltips/#tbar-02",
      "text": "Toolbar buttons stay out of the Tab order: the command, the palette and the menus reach the action, and Tab is for the content. The [keyboard page](https://pauta-project.dev/4.5.0/keyboard/#focus-and-accessibility) has the general focus rules.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "every button on a toolbar is built by `Icons.toolbarButton` or calls `setFocusTraversable(false)`."
      },
      "reference": "Editora [`Icons.toolbarButton`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/Icons.java), used by the tool window toolbars (Git, Diff, Markdown lint); Termina's search bar buttons; Mirada's header buttons. Editora doesn't yet on its main toolbar: the buttons built by [`WindowToolbar.setupButton`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/WindowToolbar.java) and [`ToolbarCoordinator.buildExtraButton`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ToolbarCoordinator.java), and the stripe buttons, take focus."
    },
    {
      "id": "TBAR-03",
      "level": "MUST",
      "page": "toolbars-and-tooltips",
      "pageTitle": "Toolbars and tooltips",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/toolbars-and-tooltips/#tbar-03",
      "text": "The tooltip names the command and its chord, read from the active keymap and never typed into a string: \"Save (C-x C-s)\". An unbound command shows its title alone.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the tooltip is built from the command's title and the keymap's display chord for its id, and is rebuilt when the keymap changes."
      },
      "reference": "Editora [`WindowToolbar.setupButton`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/WindowToolbar.java) (`refreshToolbarTooltips`), [`ToolbarCoordinator.buildExtraButton`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ToolbarCoordinator.java) and [`ToolWindowManager.tooltipFor`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ToolWindowManager.java); Torrenta's `toolbar.withChord`. Mirada's header buttons use the same \"label (key)\" form with the key written into the string."
    },
    {
      "id": "TBAR-04",
      "level": "SHOULD",
      "page": "toolbars-and-tooltips",
      "pageTitle": "Toolbars and tooltips",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/toolbars-and-tooltips/#tbar-04",
      "text": "Groups are separated by spacing, not rules: keep the `Separator` nodes (their padding is the gap) and make the line transparent.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the stylesheet sets `.tool-bar .separator:vertical > .line` to a transparent border."
      },
      "reference": "Editora [`app.css`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/styles/app.css). Torrenta's separators still draw a line."
    },
    {
      "id": "TBAR-05",
      "level": "SHOULD",
      "page": "toolbars-and-tooltips",
      "pageTitle": "Toolbars and tooltips",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/toolbars-and-tooltips/#tbar-05",
      "text": "Hiding a button group (Simple mode, a build tool that is not detected) hides the leading, trailing and doubled separators it leaves, so no gap stands on its own, and shows them all again when nothing is hidden.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "every change to a toolbar item's visibility ends in one pass over the bar's separators."
      },
      "reference": "Editora [`WindowChromeCoordinator.collapseToolbarSeparators`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/WindowChromeCoordinator.java)."
    },
    {
      "id": "TBAR-06",
      "level": "SHOULD",
      "page": "toolbars-and-tooltips",
      "pageTitle": "Toolbars and tooltips",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/toolbars-and-tooltips/#tbar-06",
      "text": "One chrome band: the menu bar, the toolbar and the tab strip share `-color-bg-subtle` and draw no hairline between them; the breadcrumb, the bottom stripe and the status bar do the same at the bottom.",
      "why": "three rules within forty pixels read as clutter, not structure.",
      "check": {
        "kind": "by hand",
        "text": "look at the top and the bottom of a window in a light and a dark theme for a line between the bands."
      },
      "reference": "Editora [`app.css`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/styles/app.css) (`.menu-bar, .tool-bar`)."
    },
    {
      "id": "TBAR-07",
      "level": "SHOULD",
      "page": "toolbars-and-tooltips",
      "pageTitle": "Toolbars and tooltips",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/toolbars-and-tooltips/#tbar-07",
      "text": "A toggle looks on while it is on: a button that opens an overlay (Find, the palette, a split) and the Simple mode button carry the `:open` pseudo-class while their state holds, so the way back out does not look like the way in.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "each such button sets a pseudo-class from its state, and the stylesheet gives that state a fill."
      },
      "reference": "Editora [`MainController.OPEN`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MainController.java), [`WindowChromeCoordinator`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/WindowChromeCoordinator.java) (Simple mode), `.button:open` in [`app.css`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/styles/app.css). Torrenta uses `:on` for Simple mode and `:active` for the alternative speed limit."
    },
    {
      "id": "TBAR-08",
      "level": "MUST",
      "page": "toolbars-and-tooltips",
      "pageTitle": "Toolbars and tooltips",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/toolbars-and-tooltips/#tbar-08",
      "text": "The toolbar never holds the only way to an action: every icon in the customizable cluster is also in the menus and the palette.",
      "why": "that is what makes it safe to hide icons in a narrow window and to let the user remove them.",
      "check": {
        "kind": "code",
        "text": "every toolbar catalog item runs a registered command that a menu also lists."
      },
      "reference": "Editora [`toolbar/ToolbarCatalog.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/toolbar/ToolbarCatalog.java): each item carries the `commandId` it runs; the only items without one are declared special widgets, such as the Recent menu button ([`ToolbarCatalogTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/toolbar/ToolbarCatalogTest.java))."
    },
    {
      "id": "TBAR-09",
      "level": "MAY",
      "page": "toolbars-and-tooltips",
      "pageTitle": "Toolbars and tooltips",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/toolbars-and-tooltips/#tbar-09",
      "text": "The toolbar is customizable: the user reorders, removes and restores its buttons, and the layout is saved in Settings and shared by every window.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "FX tests drive customize mode, reorder and removal."
      },
      "reference": "Editora [`ui/ToolbarCoordinator.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ToolbarCoordinator.java), [`ToolbarCustomizeModeFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/ToolbarCustomizeModeFxTest.java), [`ToolbarCustomizationFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/ToolbarCustomizationFxTest.java). The cluster is a list of catalog ids in Settings (`toolbarLayout`), sanitized on read. The bar's right-click menu offers *Customize Toolbar…* (or *Done*), *Configure…* (the Settings page) and *Restore Default*. In customize mode the bar tints, buttons drag to reorder with an accent insertion line and drag off the bar to remove; Escape leaves the mode."
    },
    {
      "id": "TBAR-10",
      "level": "MUST",
      "page": "toolbars-and-tooltips",
      "pageTitle": "Toolbars and tooltips",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/toolbars-and-tooltips/#tbar-10",
      "text": "The bar's right-click menu is one menu, reused across right-clicks, so showing it again moves it, and it closes on a press anywhere, the toolbar included.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "an FX test right-clicks the bar twice and finds one menu, then presses on the bar and elsewhere in the window and finds it closed."
      },
      "reference": "Editora [`ToolbarCoordinator`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ToolbarCoordinator.java), [`ContextMenuDismissal`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ContextMenuDismissal.java), [`ToolbarContextMenuDismissFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/ToolbarContextMenuDismissFxTest.java). See [Menus](https://pauta-project.dev/4.5.0/menus/), whose rules on icons, chords and the 14 px font ([MENU-16](https://pauta-project.dev/4.5.0/menus/#menu-16)) hold for this menu too."
    },
    {
      "id": "TBAR-12",
      "level": "SHOULD",
      "page": "toolbars-and-tooltips",
      "pageTitle": "Toolbars and tooltips",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/toolbars-and-tooltips/#tbar-12",
      "text": "Tool window stripes are toolbars: a stripe button is built like a toolbar button, with the chord in its tooltip, accessible text bound to the window's title, and a right-click menu with *Open in Split* and *Hide*.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the stripe button's tooltip comes from the same title-and-chord format, and its `accessibleTextProperty` is bound to the tool window's title."
      },
      "reference": "Editora [`ToolWindowManager.register`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ToolWindowManager.java), `tooltipFor`."
    },
    {
      "id": "TBAR-13",
      "level": "SHOULD",
      "page": "toolbars-and-tooltips",
      "pageTitle": "Toolbars and tooltips",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/toolbars-and-tooltips/#tbar-13",
      "text": "The right stripe's first icon lines up with the editor's first line of text, not with the tab strip.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "an FX test compares the first stripe button's top with the editor's first line."
      },
      "reference": "Editora [`ToolWindowStripeAlignmentFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/ToolWindowStripeAlignmentFxTest.java)."
    },
    {
      "id": "TABS-01",
      "level": "MUST",
      "page": "tabs-and-panels",
      "pageTitle": "Tabs and tool panels",
      "section": "Tabs",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/tabs-and-panels/#tabs-01",
      "text": "Every tab operation is a command, so it can be bound to a chord, is in the palette and has a menu row: close, close others, close all, close unmodified, close to the left and right, pin, reopen closed, next and previous. The tab's [right-click menu](https://pauta-project.dev/4.5.0/menus/) lists the ones that act on a tab.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "each operation has a registered command id, and `TabContextMenu` lists the per-tab ones."
      },
      "reference": "Editora [`ui/WindowCommandRegistrar.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/WindowCommandRegistrar.java) (`buffer.close`, `buffer.closeOthers`, `buffer.closeAll`, `buffer.closeUnmodified`, `buffer.closeLeft`, `buffer.closeRight`, `buffer.togglePin`, `buffer.reopenClosed`, `buffer.next`), [`ui/TabContextMenu.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/TabContextMenu.java). Editora has no previous-tab command yet."
    },
    {
      "id": "TABS-02",
      "level": "MUST",
      "page": "tabs-and-panels",
      "pageTitle": "Tabs and tool panels",
      "section": "Tabs",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/tabs-and-panels/#tabs-02",
      "text": "The header is the title: the Tab's own text stays empty, and a graphic header carries the file-type glyph, the markers and the title in a `.tab-title` label. The tooltip is the full path.",
      "why": "the graphic is what makes the header a drag handle and lets each state set its own color.",
      "check": {
        "kind": "code",
        "text": "every editor tab gets `setText(\"\")` and a graphic with a `.tab-title` label; its tooltip is the file's path."
      },
      "reference": "Editora [`ui/TabHeaders.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/TabHeaders.java)."
    },
    {
      "id": "TABS-03",
      "level": "MUST",
      "page": "tabs-and-panels",
      "pageTitle": "Tabs and tool panels",
      "section": "Tabs",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/tabs-and-panels/#tabs-03",
      "text": "The one header carries the states: a `• ` prefix in amber italic for unsaved, a pin and bold for pinned, muted italic for read-only.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`app.css` styles `.tab-header.dirty`, `.tab-header.pinned` and `.tab-header.read-only` `.tab-title`, and the header sets those classes."
      },
      "reference": "Editora [`ui/TabHeaders.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/TabHeaders.java), [`app.css`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/styles/app.css); the Unsaved, Pinned and Read-only rows of the Spec table below."
    },
    {
      "id": "TABS-04",
      "level": "MUST",
      "page": "tabs-and-panels",
      "pageTitle": "Tabs and tool panels",
      "section": "Tabs",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/tabs-and-panels/#tabs-04",
      "text": "Bulk close skips pinned tabs: close others, close all, close unmodified and close to the left or right never close a pinned tab.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`closeOtherTabs`, `closeAllTabs`, `closeUnmodifiedTabs` and `eligibleToLeft` / `eligibleToRight` all filter on the pinned set."
      },
      "reference": "Editora [`ui/MainController.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MainController.java)."
    },
    {
      "id": "TABS-05",
      "level": "MUST",
      "page": "tabs-and-panels",
      "pageTitle": "Tabs and tool panels",
      "section": "Tabs",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/tabs-and-panels/#tabs-05",
      "text": "Pinning moves the tab to the end of the pinned group, unpinning to just after it.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`togglePin` calls `moveToPinBoundary`."
      },
      "reference": "Editora [`ui/MainController.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MainController.java) (`togglePin`), [`ui/EditorArea.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/EditorArea.java) (`moveToPinBoundary`)."
    },
    {
      "id": "TABS-06",
      "level": "MUST",
      "page": "tabs-and-panels",
      "pageTitle": "Tabs and tool panels",
      "section": "Tabs",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/tabs-and-panels/#tabs-06",
      "text": "Reopen Closed Tab brings back the files whose tabs this window closed, newest first, bounded to twenty, a file listed once, with the caret where it was. In a terminal app the *tab* comes back (its shells, their directories, the pane arrangement, the names the user gave them, its place in the strip) and not the scrollback.",
      "why": "the process is gone, and pretending otherwise would be worse than saying so.",
      "check": {
        "kind": "test",
        "text": "a unit test over the closed-tab list holds the order, the bound, the single entry per file and the caret."
      },
      "reference": "Editora [`ui/ClosedTabs.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ClosedTabs.java), [`ClosedTabsTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/ClosedTabsTest.java); `C-S-t` in the CUA keymap. Termina [`ui/ClosedTabs.java`](https://github.com/adriandeleon/Termina/blob/master/src/main/java/com/termina/ui/ClosedTabs.java), on `Ctrl+Shift+Z` (`Cmd+Z` on macOS)."
    },
    {
      "id": "TABS-07",
      "level": "SHOULD",
      "page": "tabs-and-panels",
      "pageTitle": "Tabs and tool panels",
      "section": "Tabs",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/tabs-and-panels/#tabs-07",
      "text": "Tabs reorder by dragging, with the feedback shown above: the dragged header dimmed and an accent line on the edge where it will land.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "drag a tab along the strip and watch the landing edge."
      },
      "reference": "Editora [`TabHeaders.enableTabDrag`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/TabHeaders.java); Termina `installTabDrag` and the pure [`TabReorder.insertIndex`](https://github.com/adriandeleon/Termina/blob/master/src/main/java/com/termina/ui/TabReorder.java). In Termina a double-click on a tab renames it, and a pane dragged onto a tab joins it (the whole header outlined, `tab-drop-into`)."
    },
    {
      "id": "TABS-08",
      "level": "SHOULD",
      "page": "tabs-and-panels",
      "pageTitle": "Tabs and tool panels",
      "section": "Tabs",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/tabs-and-panels/#tabs-08",
      "text": "A tab shows its file's Git status in the Project tree's colors: modified accent, added green, untracked olive, renamed violet, deleted muted, conflict red. A read-only tab still shows it; an unsaved one shows amber.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a test gives a changed file the same style class the Project tree uses."
      },
      "reference": "Editora [`ui/TabGitStatus.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/TabGitStatus.java), [`TabGitStatusTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/TabGitStatusTest.java)."
    },
    {
      "id": "TABS-09",
      "level": "SHOULD",
      "page": "tabs-and-panels",
      "pageTitle": "Tabs and tool panels",
      "section": "Tabs",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/tabs-and-panels/#tabs-09",
      "text": "A switcher lists the open files in tab order: `C-x C-b` (Emacs) opens it, `C-n` / `C-p` or the arrows move, Enter or releasing Ctrl activates, `C-g` or Esc cancels, `C-d` or Backspace closes the highlighted file. Its width is fixed to the longest path on each open, so it never resizes while you move.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "open it with several tabs and move through it; the list keeps its width."
      },
      "reference": "Editora [`ui/Switcher.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/Switcher.java), [`SwitcherFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/SwitcherFxTest.java)."
    },
    {
      "id": "TABS-10",
      "level": "SHOULD",
      "page": "tabs-and-panels",
      "pageTitle": "Tabs and tool panels",
      "section": "Tabs",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/tabs-and-panels/#tabs-10",
      "text": "The window title names the file, the project and the app, with a `●` prefix for an unsaved file.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the code that sets the stage title adds all three and the marker."
      },
      "reference": "Editora [`MainController.updateWindowTitle`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MainController.java)."
    },
    {
      "id": "TABS-11",
      "level": "SHOULD",
      "page": "tabs-and-panels",
      "pageTitle": "Tabs and tool panels",
      "section": "Tabs",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/tabs-and-panels/#tabs-11",
      "text": "Tabs sit in the title bar through JavaFX 27's `HeaderBar`; see [Window shell](https://pauta-project.dev/4.5.0/window-shell/).",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "the tab strip shares the title bar's row."
      },
      "reference": "Termina [`ui/TerminalWindow.java`](https://github.com/adriandeleon/Termina/blob/master/src/main/java/com/termina/ui/TerminalWindow.java)."
    },
    {
      "id": "TABS-12",
      "level": "SHOULD",
      "page": "tabs-and-panels",
      "pageTitle": "Tabs and tool panels",
      "section": "Tabs",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/tabs-and-panels/#tabs-12",
      "text": "A command hides the tab bar.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "a registered command toggles the tab header."
      },
      "reference": "Editora `view.toggleTabBar`, `.tab-pane.no-tab-header` in [`app.css`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/styles/app.css)."
    },
    {
      "id": "TABS-13",
      "level": "MUST",
      "page": "tabs-and-panels",
      "pageTitle": "Tabs and tool panels",
      "section": "Tool panels",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/tabs-and-panels/#tabs-13",
      "text": "A command toggles each panel (`tool.<id>`: `M-1` … `M-0` in the Emacs keymap for ten of them), and the stripe button is the same command with a glyph.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "every tool window registers a `tool.<id>` command, and its stripe button runs it."
      },
      "reference": "Editora [`ui/ToolWindowManager.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ToolWindowManager.java), [`keymaps/emacs.json`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/keymaps/emacs.json)."
    },
    {
      "id": "TABS-14",
      "level": "MUST",
      "page": "tabs-and-panels",
      "pageTitle": "Tabs and tool panels",
      "section": "Tool panels",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/tabs-and-panels/#tabs-14",
      "text": "A panel's content is built on first use.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "an FX test holds that no closed tool window builds its panel before the first paint."
      },
      "reference": "Editora [`LazyToolWindowsFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/LazyToolWindowsFxTest.java)."
    },
    {
      "id": "TABS-15",
      "level": "SHOULD",
      "page": "tabs-and-panels",
      "pageTitle": "Tabs and tool panels",
      "section": "Tool panels",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/tabs-and-panels/#tabs-15",
      "text": "Panel state is restored: which windows are open, on which side, in what order, hidden or shown, floating, and every divider position go to `workspace-state.json` and come back on the next launch.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the workspace state holds each of those, and the manager reads them back at startup."
      },
      "reference": "Editora [`ui/ToolWindowManager.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ToolWindowManager.java), [`config/WorkspaceState.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/config/WorkspaceState.java)."
    },
    {
      "id": "TABS-16",
      "level": "SHOULD",
      "page": "tabs-and-panels",
      "pageTitle": "Tabs and tool panels",
      "section": "Tool panels",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/tabs-and-panels/#tabs-16",
      "text": "Panels dock on three sides, left, right and bottom, and a side holds at most two windows stacked (Project over Structure, two consoles along the bottom).",
      "why": "past that a side stops being a dock and becomes a list of slivers.",
      "check": {
        "kind": "code",
        "text": "the sides are an enum of three and the per-side limit is two."
      },
      "reference": "Editora [`ToolWindow.Side`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ToolWindow.java), [`ToolWindowManager.MAX_PER_SIDE`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ToolWindowManager.java)."
    },
    {
      "id": "TABS-17",
      "level": "SHOULD",
      "page": "tabs-and-panels",
      "pageTitle": "Tabs and tool panels",
      "section": "Tool panels",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/tabs-and-panels/#tabs-17",
      "text": "A panel re-docks by dragging its stripe button to another stripe, with the same dim-and-accent-line feedback as a tab; an empty stripe appears as a dashed accent drop zone for the duration of the drag.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "drag a stripe button to the opposite side."
      },
      "reference": "Editora [`ui/ToolWindowDock.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ToolWindowDock.java), [`ToolWindowVisibilityTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/ToolWindowVisibilityTest.java) (an empty stripe shows while dragging)."
    },
    {
      "id": "TABS-18",
      "level": "SHOULD",
      "page": "tabs-and-panels",
      "pageTitle": "Tabs and tool panels",
      "section": "Tool panels",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/tabs-and-panels/#tabs-18",
      "text": "Panels float, maximize, resize and close from the keyboard, and at most one window is maximized at a time.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the commands are registered and bound in the Emacs keymap."
      },
      "reference": "Editora `view.floatToolWindow`, `view.maximizeToolWindow` (`C-x f`), `view.closeFocusedToolWindow` (`C-x 0`), the resize commands (`C-x S-.`, `C-x S-,`, `C-x S-6`)."
    },
    {
      "id": "TABS-19",
      "level": "SHOULD",
      "page": "tabs-and-panels",
      "pageTitle": "Tabs and tool panels",
      "section": "Tool panels",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/tabs-and-panels/#tabs-19",
      "text": "Closing the panel that holds keyboard focus returns focus to where it was in the editor.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the manager keeps the last editor focus owner and refocuses it on close."
      },
      "reference": "Editora [`ToolWindowManager.focusEditor`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ToolWindowManager.java), a weak reference to the last editor focus owner."
    },
    {
      "id": "TABS-20",
      "level": "SHOULD",
      "page": "tabs-and-panels",
      "pageTitle": "Tabs and tool panels",
      "section": "Tool panels",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/tabs-and-panels/#tabs-20",
      "text": "Hidden is not unavailable: the user's show/hide choice for a stripe button is kept apart from a context-driven hide (the Commit window outside a Git repository), so the second never clobbers the first.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a unit test holds that a button shows only when visible and available."
      },
      "reference": "Editora [`ui/ToolWindowVisibility.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ToolWindowVisibility.java), [`ToolWindowVisibilityTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/ToolWindowVisibilityTest.java)."
    },
    {
      "id": "TABS-21",
      "level": "SHOULD",
      "page": "tabs-and-panels",
      "pageTitle": "Tabs and tool panels",
      "section": "Tool panels",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/tabs-and-panels/#tabs-21",
      "text": "A bottom window that is unusable at the default height asks for more on its first open; the user's own size wins afterwards.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a test opens an output window taller while the others keep the side's size."
      },
      "reference": "Editora [`ToolWindow.setFirstOpenShare`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ToolWindow.java), [`ToolWindowFirstOpenShareTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/ToolWindowFirstOpenShareTest.java)."
    },
    {
      "id": "TABS-22",
      "level": "SHOULD",
      "page": "tabs-and-panels",
      "pageTitle": "Tabs and tool panels",
      "section": "Tool panels",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/tabs-and-panels/#tabs-22",
      "text": "A stripe button badges a spinner while its window has something under way.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "an FX test badges a busy window's stripe button without changing its size."
      },
      "reference": "Editora [`ToolWindow.busy`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ToolWindow.java), [`ToolWindowManagerFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/ToolWindowManagerFxTest.java)."
    },
    {
      "id": "TABS-23",
      "level": "SHOULD",
      "page": "tabs-and-panels",
      "pageTitle": "Tabs and tool panels",
      "section": "Tool panels",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/tabs-and-panels/#tabs-23",
      "text": "Panels follow the active document where they should: the Git UI follows the active tab's repository, the status bar's environment segment the active `.http` file, Local History the file whose tab menu opened it.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "switch between tabs from two repositories with the Git window open."
      },
      "reference": "Editora [`ui/GitPathScope.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/GitPathScope.java)."
    },
    {
      "id": "MENU-14",
      "level": "MUST",
      "page": "menus",
      "pageTitle": "Menus",
      "section": "Look and feel",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/menus/#menu-14",
      "text": "Every row of every menu the app draws carries an icon that depicts it. A command row wears its command's glyph; a row that names a thing rather than an action (a recent file, a branch, a project) wears that thing's icon; a submenu wears its family's. Only a check or radio row goes without, because its mark fills the icon column. Where the icon set has no glyph that depicts a command, the app adds one (a Material 24 dp path, or a line glyph in the kit's style) instead of leaving the row blank or borrowing another command's.",
      "why": "a menu is scanned before it is read, and the glyph is what the eye finds first; the same glyph on the toolbar, in the palette and in the menu ([ICON-20](https://pauta-project.dev/4.5.0/icons-and-color/#icon-20)) is learned once. A blank cell breaks the column, and a borrowed glyph says something else.",
      "check": {
        "kind": "test",
        "text": "an FX test opens the menu bar's menus and the right-click menus of a tab, an editor, a list row and the toolbar, and fails on any visible row that is not a check or radio item and has no graphic."
      },
      "reference": "Editora [`ui/MenuBarIcons.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MenuBarIcons.java), [`editor/MenuIcons.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/editor/MenuIcons.java), [`ui/TabContextMenu.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/TabContextMenu.java); Termina's tab menu has an icon on every row. Editora doesn't yet pass: about half its menu-bar rows have no glyph, and [`MenuBarIconsTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/MenuBarIconsTest.java) holds that a command without a fitting glyph gets none, which this rule reverses; many right-click and drop-down rows have none either (Run All Requests in a `.http` file, the CSV grid's menu, the Markdown preview's)."
    },
    {
      "id": "MENU-15",
      "level": "MUST",
      "page": "menus",
      "pageTitle": "Menus",
      "section": "Look and feel",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/menus/#menu-15",
      "text": "Every menu row whose command has a chord in the active keymap shows it, in right-click menus and drop-downs as in the menu bar: right-aligned in the menu's chord column, Inter 11 px in `-state-key`. An unbound command leaves the cell empty, never a wrong chord, and a keymap switch rewrites every cell.",
      "why": "the menu is where a user learns the keys. A right-click menu that hides them teaches the mouse, while the palette and the toolbar's tooltips already show the same chord.",
      "check": {
        "kind": "test",
        "text": "an FX test binds a command, opens a right-click menu that lists it and finds its chord in a `menu-item-chord` label; after a keymap switch it finds the new chord."
      },
      "reference": "Editora [`MainMenuBar.rowContent`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MainMenuBar.java) and `alignChordColumns`, `.menu-item-chord` in [`app.css`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/styles/app.css). Editora's right-click menus show no chords yet: a row there is a plain `MenuItem`, not the menu bar's row."
    },
    {
      "id": "MENU-16",
      "level": "MUST",
      "page": "menus",
      "pageTitle": "Menus",
      "section": "Look and feel",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/menus/#menu-16",
      "text": "Every menu draws its titles in Inter 14 px regular and its chords in Inter 11 px, whatever node it was opened from: the font is pinned in absolute pixels on `.context-menu` and its rows' labels.",
      "why": "a popup inherits the font of the node it was shown from, and `em` resolves against it: Editora's toolbar menu once rendered at the bar's 18 px, a third larger than every other menu, and a file tree's or a monospace editor's font leaks the same way.",
      "check": {
        "kind": "test",
        "text": "an FX test opens a menu from the toolbar, an editor and a tree row and reads Inter 14 px from each row's title."
      },
      "reference": "Editora `.context-menu` and `.menu-item-chord` in [`app.css`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/styles/app.css), [`MainMenuBar.UI_FONT_SIZE`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MainMenuBar.java), [`ToolbarMenuFontFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/ToolbarMenuFontFxTest.java)."
    },
    {
      "id": "MENU-01",
      "level": "MUST",
      "page": "menus",
      "pageTitle": "Menus",
      "section": "The menu bar",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/menus/#menu-01",
      "text": "Every menu-bar item is a command from the registry, with its title from `command.<id>`, its chord from the active keymap and its enabled state from the command's gate. The bar assembles and refreshes; it holds no behavior of its own.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the bar's model lists command ids only, and every row runs its id through the registry."
      },
      "reference": "Editora [`ui/MenuBarModel.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MenuBarModel.java) over [`command/CommandRegistry.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/command/CommandRegistry.java), [`ui/MainMenuBar.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MainMenuBar.java)."
    },
    {
      "id": "MENU-02",
      "level": "MUST",
      "page": "menus",
      "pageTitle": "Menus",
      "section": "The menu bar",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/menus/#menu-02",
      "text": "Menu-bar rows use no `KeyCombination` accelerators. In the in-window bar each row is a `CustomMenuItem` laying out icon, title, spacer and chord. On the macOS system menu bar (`useSystemMenuBar`) the chord is appended to the title and rows carry no icon.",
      "why": "Emacs chords are multi-key, which a `KeyCombination` cannot express, and on macOS an accelerator would bypass the key dispatcher. The native macOS menu draws text only and no graphics, which is also the platform's convention.",
      "check": {
        "kind": "code",
        "text": "no `setAccelerator` in the menu-bar classes."
      },
      "reference": "Editora [`ui/MainMenuBar.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MainMenuBar.java) (`rowContent`, `refresh`)."
    },
    {
      "id": "MENU-03",
      "level": "SHOULD",
      "page": "menus",
      "pageTitle": "Menus",
      "section": "The menu bar",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/menus/#menu-03",
      "text": "Enablement is re-read every time a menu opens, and titles and chords on a keymap or locale change.",
      "why": "a menu built before Git finished detecting a repository must not stay grayed out.",
      "check": {
        "kind": "test",
        "text": "an FX test detects a repository after the window is built and finds the menu enabled."
      },
      "reference": "Editora [`MainMenuBar.refreshEnablement`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MainMenuBar.java), [`MenuBarEnablementFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/MenuBarEnablementFxTest.java)."
    },
    {
      "id": "MENU-04",
      "level": "SHOULD",
      "page": "menus",
      "pageTitle": "Menus",
      "section": "The menu bar",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/menus/#menu-04",
      "text": "Simple mode shows a shorter menu, rebuilt only when the mode actually changes.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the bar rebuilds only when the simple flag differs from the current one."
      },
      "reference": "Editora [`MainMenuBar.setSimple`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MainMenuBar.java), [`MenuBarModel.menus(simple)`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MenuBarModel.java)."
    },
    {
      "id": "MENU-05",
      "level": "MUST",
      "page": "menus",
      "pageTitle": "Menus",
      "section": "Right-click menus",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/menus/#menu-05",
      "text": "Every list row, tree row, tab, editor and read-only console has a right-click menu with the actions for *that* thing, each one a command.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "right-click each kind of thing; every row's action is also in the palette."
      },
      "reference": "Editora [`ui/TabContextMenu.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/TabContextMenu.java), [`ui/RowContextMenu.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/RowContextMenu.java), [`ui/ConsoleContextMenu.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ConsoleContextMenu.java)."
    },
    {
      "id": "MENU-06",
      "level": "MUST",
      "page": "menus",
      "pageTitle": "Menus",
      "section": "Right-click menus",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/menus/#menu-06",
      "text": "One right-click menu at a time: a right-click while a menu is open replaces it, and the first one closes before the second shows.",
      "why": "JavaFX stacks a second menu beside the first when each row owns its own `ContextMenu`, and the stale one is then no longer dismissible.",
      "check": {
        "kind": "test",
        "text": "an FX test right-clicks another row with a menu open and finds one menu showing."
      },
      "reference": "Editora [`ui/ContextMenuDismissal.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ContextMenuDismissal.java) closes every open right-click menu on the press that opens the next ([`ContextMenuDismissalFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/ContextMenuDismissalFxTest.java)); Modula's [`RadioPane`](https://github.com/adriandeleon/Modula/blob/master/src/main/java/com/modula/ui/RadioPane.java) hides the previous menu before showing a new one; Termina keeps one menu per view and shows it again."
    },
    {
      "id": "MENU-07",
      "level": "MUST",
      "page": "menus",
      "pageTitle": "Menus",
      "section": "Right-click menus",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/menus/#menu-07",
      "text": "A press anywhere outside a right-click menu closes it, including inside the control the menu was opened on. The press is not consumed: a click in a list still selects the row, and a right-click on another row opens that row's menu straight away. Drop-downs opened by a plain click (menu buttons, choice boxes, the menu bar) keep the stock behavior, and a menu that turned auto-hide off is left alone.",
      "why": "JavaFX's auto-hide deliberately ignores a press on the menu's *owner node*, so a stock menu on a tree or a text area stays open when the user clicks another row or the text.",
      "check": {
        "kind": "test",
        "text": "an FX test clicks inside the owner control and in another window, and the menu closes."
      },
      "reference": "Editora [`ContextMenuDismissal.install()`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ContextMenuDismissal.java), called once in [`App`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/App.java) at startup for every current and future window; [`ContextMenuDismissalFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/ContextMenuDismissalFxTest.java)."
    },
    {
      "id": "MENU-08",
      "level": "MUST",
      "page": "menus",
      "pageTitle": "Menus",
      "section": "Right-click menus",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/menus/#menu-08",
      "text": "Escape closes a right-click menu and focus goes back where it was. In a terminal the Escape does not reach the shell.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "open a menu, press Escape, and type: the keys reach the control that had focus."
      },
      "reference": "the stock `ContextMenu` hide-on-Escape (Spec below); Termina's `onKeyPressed` filter hides the menu and consumes the key ([`TerminalView`](https://github.com/adriandeleon/Termina/blob/master/src/main/java/com/termina/ui/TerminalView.java))."
    },
    {
      "id": "MENU-09",
      "level": "MUST",
      "page": "menus",
      "pageTitle": "Menus",
      "section": "Right-click menus",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/menus/#menu-09",
      "text": "The Menu key and <kbd>Shift+F10</kbd> open the selected row's menu, scrolled into view first, so every row action a mouse can reach the keyboard can too.",
      "why": "those keys arrive at the focused control, not at a row's cell, so a menu installed on cells never saw them.",
      "check": {
        "kind": "test",
        "text": "an FX test sends a keyboard request to a tree and a list and finds the selected row's menu, anchored to that row."
      },
      "reference": "Editora [`RowContextMenu.install(tree)`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/RowContextMenu.java), [`RowContextMenuFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/RowContextMenuFxTest.java)."
    },
    {
      "id": "MENU-10",
      "level": "SHOULD",
      "page": "menus",
      "pageTitle": "Menus",
      "section": "Right-click menus",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/menus/#menu-10",
      "text": "A right-click selects first. In an editor, a right-click outside every selection moves the caret to the click (so Paste lands there); inside a selection it keeps carets and selections (so Cut and Copy act on what was clicked). From the keyboard the target is the caret. In a list, the menu is the clicked row's.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "select a word, right-click elsewhere and paste; then right-click inside a selection and copy."
      },
      "reference": "Editora [`editor/ContextMenuTarget.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/editor/ContextMenuTarget.java)."
    },
    {
      "id": "MENU-11",
      "level": "SHOULD",
      "page": "menus",
      "pageTitle": "Menus",
      "section": "Right-click menus",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/menus/#menu-11",
      "text": "A menu attached to something that exists once per open file is built when first shown, and set up for each showing: an `onShowing` handler sets the labels, enablement and visibility for *this* showing, then collapses the separators.",
      "why": "such a menu is built for every file and opened for almost none.",
      "check": {
        "kind": "code",
        "text": "per-file menus are created through `LazyContextMenu.of(build)`."
      },
      "reference": "Editora [`ui/LazyContextMenu.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/LazyContextMenu.java), [`LazyContextMenuFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/LazyContextMenuFxTest.java). A read-only console's menu is just Select All and Copy, both disabled while it is empty ([`ConsoleContextMenu`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ConsoleContextMenu.java))."
    },
    {
      "id": "MENU-12",
      "level": "SHOULD",
      "page": "menus",
      "pageTitle": "Menus",
      "section": "Right-click menus",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/menus/#menu-12",
      "text": "A destructive row carries the `danger` class. The action follows the [window shell](https://pauta-project.dev/4.5.0/window-shell/) rule: it asks first with a button that names it, or is undoable.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "rows that delete, discard or reset add `danger` to their style classes."
      },
      "reference": "Editora `.menu-item.danger` in [`app.css`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/styles/app.css), [`ui/BranchPopup.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/BranchPopup.java)."
    },
    {
      "id": "MENU-13",
      "level": "MAY",
      "page": "menus",
      "pageTitle": "Menus",
      "section": "Right-click menus",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/menus/#menu-13",
      "text": "In a terminal view, a program that grabbed the mouse owns the right-click; <kbd>Shift</kbd>+right-click always opens the menu, and the keyboard request is never contested.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a pure test of when the menu shows, per mouse mode, Shift and trigger."
      },
      "reference": "Termina's [`TerminalView.shouldShowMenu`](https://github.com/adriandeleon/Termina/blob/master/src/main/java/com/termina/ui/TerminalView.java), [`ContextMenuContentionTest`](https://github.com/adriandeleon/Termina/blob/master/src/test/java/com/termina/ui/ContextMenuContentionTest.java)."
    },
    {
      "id": "TRAY-01",
      "level": "MUST",
      "page": "tray-and-background",
      "pageTitle": "Tray and background",
      "section": "The icon and its menu",
      "appliesTo": "an app whose work goes on without its window, as Torrenta's, Modula's and nux's does. For the others (Editora, Termina, Mirada) a tray is MAY, none has one, and no rule on this page applies.",
      "url": "https://pauta-project.dev/4.5.0/tray-and-background/#tray-01",
      "text": "The tray comes from the shared `tray/` package: a StatusNotifierItem on Linux, AWT's `SystemTray` on Windows and macOS, created off the FX thread after the first frame.",
      "why": "D-Bus and AWT can block, and neither is worth a stalled first frame.",
      "check": {
        "kind": "code",
        "text": "`Trays.create` picks `SniTray` on Linux and `AwtTray` elsewhere, and the window calls it from a background thread."
      },
      "reference": "Torrenta [`tray/Trays.java`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/tray/Trays.java), [`MainWindow.installTray`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/ui/MainWindow.java); the Spec table below."
    },
    {
      "id": "TRAY-02",
      "level": "MUST",
      "page": "tray-and-background",
      "pageTitle": "Tray and background",
      "section": "Behavior",
      "appliesTo": "an app whose work goes on without its window, as Torrenta's, Modula's and nux's does. For the others (Editora, Termina, Mirada) a tray is MAY, none has one, and no rule on this page applies.",
      "url": "https://pauta-project.dev/4.5.0/tray-and-background/#tray-02",
      "text": "The app is fully usable without a tray. No icon is a normal outcome (stock GNOME has no StatusNotifier host), not an error, and the reason is said where the person will look.",
      "why": "the bug they actually hit is silence: the box says close to tray, and closing quits.",
      "check": {
        "kind": "code",
        "text": "when the tray attempt returns no tray, the status bar says why and that closing quits."
      },
      "reference": "Torrenta [`MainWindow.installTray`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/ui/MainWindow.java) (\"No tray icon (…); closing the window quits Torrenta\", `status.noTray`); Modula's status says closing the window will quit it ([`RadioPane.reportNoTray`](https://github.com/adriandeleon/Modula/blob/master/src/main/java/com/modula/ui/RadioPane.java))."
    },
    {
      "id": "TRAY-03",
      "level": "MUST",
      "page": "tray-and-background",
      "pageTitle": "Tray and background",
      "section": "Behavior",
      "appliesTo": "an app whose work goes on without its window, as Torrenta's, Modula's and nux's does. For the others (Editora, Termina, Mirada) a tray is MAY, none has one, and no rule on this page applies.",
      "url": "https://pauta-project.dev/4.5.0/tray-and-background/#tray-03",
      "text": "Closing the window hides it only while an icon is actually up and the setting says so, both read at close time; otherwise a close quits. `Platform.setImplicitExit(false)` is set only once a tray exists, and turning the tray off brings a hidden window back.",
      "why": "the checkbox can change while the window is open, and hiding a window that leaves no icon behind is how a program becomes unreachable.",
      "check": {
        "kind": "code",
        "text": "the close handler tests that a tray exists and reads the live setting; `setImplicitExit(false)` sits after the tray is created."
      },
      "reference": "Torrenta [`MainWindow.setOnCloseRequest`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/ui/MainWindow.java), Modula's `installCloseBehaviour`, nux's [`TrayController.closeHidesWindow`](https://github.com/adriandeleon/nux/blob/master/src/main/java/com/nux/app/TrayController.java) and `updateImplicitExit`."
    },
    {
      "id": "TRAY-04",
      "level": "MUST",
      "page": "tray-and-background",
      "pageTitle": "Tray and background",
      "section": "Behavior",
      "appliesTo": "an app whose work goes on without its window, as Torrenta's, Modula's and nux's does. For the others (Editora, Termina, Mirada) a tray is MAY, none has one, and no rule on this page applies.",
      "url": "https://pauta-project.dev/4.5.0/tray-and-background/#tray-04",
      "text": "Quit is explicit and one path: the tray's Quit, File → Quit and the system's Quit all run the same method, which closes open dialogs first and saves the window geometry.",
      "why": "quitting from inside a nested event loop aborted the JVM.",
      "check": {
        "kind": "code",
        "text": "every quit entry point calls the one quit method."
      },
      "reference": "Torrenta [`MainWindow.quit`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/ui/MainWindow.java)."
    },
    {
      "id": "TRAY-05",
      "level": "SHOULD",
      "page": "tray-and-background",
      "pageTitle": "Tray and background",
      "section": "Behavior",
      "appliesTo": "an app whose work goes on without its window, as Torrenta's, Modula's and nux's does. For the others (Editora, Termina, Mirada) a tray is MAY, none has one, and no rule on this page applies.",
      "url": "https://pauta-project.dev/4.5.0/tray-and-background/#tray-05",
      "text": "`--minimized` comes up behind the icon. The window is never shown until the tray attempt has answered; if no icon comes, the window is shown after all. With the tray setting off, Torrenta starts minimized instead and nux ignores the flag.",
      "why": "a start at login can then never leave a program with no way back.",
      "check": {
        "kind": "code",
        "text": "a `--minimized` start shows the window when the tray attempt returns none."
      },
      "reference": "Torrenta [`MainWindow.show`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/ui/MainWindow.java), nux's [`App`](https://github.com/adriandeleon/nux/blob/master/src/main/java/com/nux/App.java)."
    },
    {
      "id": "TRAY-06",
      "level": "SHOULD",
      "page": "tray-and-background",
      "pageTitle": "Tray and background",
      "section": "Behavior",
      "appliesTo": "an app whose work goes on without its window, as Torrenta's, Modula's and nux's does. For the others (Editora, Termina, Mirada) a tray is MAY, none has one, and no rule on this page applies.",
      "url": "https://pauta-project.dev/4.5.0/tray-and-background/#tray-06",
      "text": "Start at login writes the OS's own entry, and nothing else: an XDG autostart entry in `~/.config/autostart` (quoted `Exec`, `StartupWMClass` matching the installed launcher, `X-KDE-autostart-after=panel` so a tray host is up first), a LaunchAgent in `~/Library/LaunchAgents`, the `HKCU\\…\\Run` value on Windows (read together with `StartupApproved`, where Task Manager keeps the person's \"off\"). The entry is the one truth: turned off in GNOME Tweaks, KDE's Autostart page or Task Manager, the box shows unticked. The one setting beside it is *start behind the tray icon*, written into the entry as `--minimized`.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a pure test of the exact bytes of each platform's entry."
      },
      "reference": "Torrenta [`os/Autostart.java`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/os/Autostart.java), [`os/AutostartSpec.java`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/os/AutostartSpec.java), [`AutostartSpecTest`](https://github.com/adriandeleon/torrenta/blob/master/src/test/java/com/torrenta/os/AutostartSpecTest.java); nux's design."
    },
    {
      "id": "TRAY-07",
      "level": "SHOULD",
      "page": "tray-and-background",
      "pageTitle": "Tray and background",
      "section": "Behavior",
      "appliesTo": "an app whose work goes on without its window, as Torrenta's, Modula's and nux's does. For the others (Editora, Termina, Mirada) a tray is MAY, none has one, and no rule on this page applies.",
      "url": "https://pauta-project.dev/4.5.0/tray-and-background/#tray-07",
      "text": "Only the app writes the login entry, and only from an installed package: the installers never do it, and a run from source says it has nothing to start.",
      "why": "an installer runs for every account.",
      "check": {
        "kind": "code",
        "text": "the entry's target comes from `jpackage.app-path`, and is absent when it is unset."
      },
      "reference": "Torrenta [`os/Autostart.java`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/os/Autostart.java)."
    },
    {
      "id": "TRAY-08",
      "level": "SHOULD",
      "page": "tray-and-background",
      "pageTitle": "Tray and background",
      "section": "Behavior",
      "appliesTo": "an app whose work goes on without its window, as Torrenta's, Modula's and nux's does. For the others (Editora, Termina, Mirada) a tray is MAY, none has one, and no rule on this page applies.",
      "url": "https://pauta-project.dev/4.5.0/tray-and-background/#tray-08",
      "text": "Every start-at-login call runs off the FX thread.",
      "why": "it may block on the file system or `reg.exe`.",
      "check": {
        "kind": "code",
        "text": "every `Autostart` read and write starts on a worker thread."
      },
      "reference": "Torrenta [`SettingsWindow`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/ui/SettingsWindow.java) (`autostart-read`, `autostart-write`) and [`MainWindow`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/ui/MainWindow.java) (`autostart-refresh`); nux's [`App`](https://github.com/adriandeleon/nux/blob/master/src/main/java/com/nux/App.java) (`nux-autostart`)."
    },
    {
      "id": "TRAY-09",
      "level": "MUST",
      "page": "tray-and-background",
      "pageTitle": "Tray and background",
      "section": "Behavior",
      "appliesTo": "an app whose work goes on without its window, as Torrenta's, Modula's and nux's does. For the others (Editora, Termina, Mirada) a tray is MAY, none has one, and no rule on this page applies.",
      "url": "https://pauta-project.dev/4.5.0/tray-and-background/#tray-09",
      "text": "Desktop notifications go through one `Notifier`: `notify-send` on Linux (nux and Termina fall back to `gdbus` against the freedesktop service), `osascript` with `display notification` on macOS, a PowerShell toast on Windows. Each is a short program run with the title and message as arguments, never as part of a script, off the FX thread and bounded to a few seconds; a failure is logged and never breaks the app.",
      "why": "text from a torrent name or a remote shell then cannot run anything.",
      "check": {
        "kind": "test",
        "text": "a test holds that each platform's command line passes the text as arguments and that a missing program is a problem, not an exception."
      },
      "reference": "Torrenta [`automation/Notifiers.java`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/automation/Notifiers.java), [`ProcessNotifier`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/automation/ProcessNotifier.java), [`NotifierTest`](https://github.com/adriandeleon/torrenta/blob/master/src/test/java/com/torrenta/automation/NotifierTest.java) (it ships [`toast.ps1`](https://github.com/adriandeleon/torrenta/blob/master/src/main/resources/com/torrenta/automation/toast.ps1)); nux's [`service/Notifier`](https://github.com/adriandeleon/nux/blob/master/src/main/java/com/nux/service/Notifier.java) raises it through the tray icon, which it keeps as the last resort on every platform; Termina's [`DesktopNotifier`](https://github.com/adriandeleon/Termina/blob/master/src/main/java/com/termina/ui/DesktopNotifier.java)."
    },
    {
      "id": "TRAY-10",
      "level": "MUST",
      "page": "tray-and-background",
      "pageTitle": "Tray and background",
      "section": "Behavior",
      "appliesTo": "an app whose work goes on without its window, as Torrenta's, Modula's and nux's does. For the others (Editora, Termina, Mirada) a tray is MAY, none has one, and no rule on this page applies.",
      "url": "https://pauta-project.dev/4.5.0/tray-and-background/#tray-10",
      "text": "Notifications are for what happened while the window was away, with one switch per event and few on by default.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "each notified event has its own setting, and most default to off."
      },
      "reference": "Torrenta notifies on added, finished, seeding done, error and updated, with only *finished* on at first, and a Test button in Settings shows one now ([`automation/AutomationSettings.java`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/automation/AutomationSettings.java)); nux notifies on power events with a rule per UPS; Termina and Editora relay a program's own OSC 9 and OSC 777 notifications."
    },
    {
      "id": "TRAY-11",
      "level": "SHOULD",
      "page": "tray-and-background",
      "pageTitle": "Tray and background",
      "section": "Behavior",
      "appliesTo": "an app whose work goes on without its window, as Torrenta's, Modula's and nux's does. For the others (Editora, Termina, Mirada) a tray is MAY, none has one, and no rule on this page applies.",
      "url": "https://pauta-project.dev/4.5.0/tray-and-background/#tray-11",
      "text": "A notification is never the only place a state is said: the in-app status already shows it.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "trigger each notified event with notifications off; the window still shows it."
      },
      "reference": "Torrenta's status bar and transfer list."
    },
    {
      "id": "TRAY-12",
      "level": "MAY",
      "page": "tray-and-background",
      "pageTitle": "Tray and background",
      "section": "Behavior",
      "appliesTo": "an app whose work goes on without its window, as Torrenta's, Modula's and nux's does. For the others (Editora, Termina, Mirada) a tray is MAY, none has one, and no rule on this page applies.",
      "url": "https://pauta-project.dev/4.5.0/tray-and-background/#tray-12",
      "text": "A dock badge: Torrenta puts the download rate on the macOS dock icon through AWT's `Taskbar` and a count on a Linux launcher that honors Unity's `LauncherEntry` signal (KDE, Dash to Dock); nothing on Windows, whose taskbar badges only AWT's own windows. It is cleared when nothing downloads and has its own switch.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a pure test of the badge state."
      },
      "reference": "Torrenta [`os/Badges.java`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/os/Badges.java), [`BadgeState`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/os/BadgeState.java), [`BadgeStateTest`](https://github.com/adriandeleon/torrenta/blob/master/src/test/java/com/torrenta/os/BadgeStateTest.java)."
    },
    {
      "id": "TRAY-13",
      "level": "SHOULD",
      "page": "tray-and-background",
      "pageTitle": "Tray and background",
      "section": "Behavior",
      "appliesTo": "an app whose work goes on without its window, as Torrenta's, Modula's and nux's does. For the others (Editora, Termina, Mirada) a tray is MAY, none has one, and no rule on this page applies.",
      "url": "https://pauta-project.dev/4.5.0/tray-and-background/#tray-13",
      "text": "A second launch brings the hidden window forward: the [single-instance hand-off](https://pauta-project.dev/4.5.0/command-line/) shows a window hidden to the tray before it opens what it was given.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "close to the tray, then launch the app again with a file."
      },
      "reference": "Torrenta [`MainWindow.showFromTray`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/ui/MainWindow.java)."
    },
    {
      "id": "TRAY-14",
      "level": "SHOULD",
      "page": "tray-and-background",
      "pageTitle": "Tray and background",
      "section": "Behavior",
      "appliesTo": "an app whose work goes on without its window, as Torrenta's, Modula's and nux's does. For the others (Editora, Termina, Mirada) a tray is MAY, none has one, and no rule on this page applies.",
      "url": "https://pauta-project.dev/4.5.0/tray-and-background/#tray-14",
      "text": "AWT stays headless unless the tray needs it. Linux never needs it; Windows and macOS lift the guard only when the tray setting is on, decided in `main`. A tray turned on later says \"restart to show the tray icon\" rather than \"unsupported\".",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a test holds that AWT is headful only where the tray is AWT's and wanted."
      },
      "reference": "Torrenta [`Trays.usesAwt`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/tray/Trays.java), `os.AwtUse`, [`TraysTest`](https://github.com/adriandeleon/torrenta/blob/master/src/test/java/com/torrenta/tray/TraysTest.java)."
    },
    {
      "id": "SET-01",
      "level": "MUST",
      "page": "settings",
      "pageTitle": "Settings",
      "section": "The Settings window",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/settings/#set-01",
      "text": "The Settings window opens from a palette command, bound to `Ctrl+,` (`Cmd+,` on macOS) in the CUA keymap.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "a registered command opens Settings, and `cua.json` and `cua.mac.json` bind it."
      },
      "reference": "Editora `view.settings`, bound in [`keymaps/cua.json`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/keymaps/cua.json) and [`cua.mac.json`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/keymaps/cua.mac.json) (and in the VS Code and Sublime keymaps; IntelliJ's uses `C-M-s`)."
    },
    {
      "id": "SET-02",
      "level": "MUST",
      "page": "settings",
      "pageTitle": "Settings",
      "section": "The Settings window",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/settings/#set-02",
      "text": "The window has a sidebar of pages with icons on the left, the page on the right, and a search field on top.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "open Settings; the search field sits above the sidebar and the page."
      },
      "reference": "Editora [`ui/SettingsWindow.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/SettingsWindow.java), [`ui/SettingsSidebarNav.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/SettingsSidebarNav.java), [`ui/SettingsIcons.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/SettingsIcons.java)."
    },
    {
      "id": "SET-03",
      "level": "MUST",
      "page": "settings",
      "pageTitle": "Settings",
      "section": "The Settings window",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/settings/#set-03",
      "text": "Search finds a row by its title, description, visible text, its card or section heading, its page name and English keywords. Title hits rank above description hits; whole words above word starts. The page with the best match opens, and every non-matching row, heading and card is hidden.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a unit test ranks a title hit above a keyword hit and a whole word above part of one."
      },
      "reference": "Editora [`ui/SettingsSearch.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/SettingsSearch.java), [`SettingsSearchTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/SettingsSearchTest.java)."
    },
    {
      "id": "SET-04",
      "level": "MUST",
      "page": "settings",
      "pageTitle": "Settings",
      "section": "The Settings window",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/settings/#set-04",
      "text": "Settings apply live, with no Save button. Text fields commit on Enter or focus loss; invalid values are marked and never committed.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "no Save or Apply button in the window; text fields commit through `commitOnEnterOrBlur`."
      },
      "reference": "Editora [`SettingsWindow.commitOnEnterOrBlur`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/SettingsWindow.java); [`SettingsSyncPage`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/SettingsSyncPage.java)'s branch field marks an invalid branch."
    },
    {
      "id": "SET-05",
      "level": "SHOULD",
      "page": "settings",
      "pageTitle": "Settings",
      "section": "The Settings window",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/settings/#set-05",
      "text": "A change made in one window reaches every other open window.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "an FX test changes a setting in one window and finds it applied in the other."
      },
      "reference": "Editora: every window holds the same [`config/SharedConfig.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/config/SharedConfig.java), which announces each change (`onSettingsChanged`); [`CrossWindowSettingsFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/CrossWindowSettingsFxTest.java)."
    },
    {
      "id": "SET-06",
      "level": "MUST",
      "page": "settings",
      "pageTitle": "Settings",
      "section": "Adding a setting touches five places",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/settings/#set-06",
      "text": "Every setting has a palette command that flips the field or prompts for its value.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "for each row in Settings, find a palette command that changes it."
      },
      "reference": "Editora's `view.toggle…` and picker commands ([`ui/WindowCommandRegistrar.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/WindowCommandRegistrar.java)). Editora does not have one for every setting yet: `terminalNotifications`, for one, is only a Settings row."
    },
    {
      "id": "SET-07",
      "level": "MUST",
      "page": "settings",
      "pageTitle": "Settings",
      "section": "Config folder and schema",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/settings/#set-07",
      "text": "Config lives in `~/.<app>`, unless `<APP>_CONFIG_DIR` or a command-line flag ([CLI-02](https://pauta-project.dev/4.5.0/command-line/#cli-02)) names another folder.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "one resolver picks the folder, in the order `--config-dir`, the environment variable, the default."
      },
      "reference": "Editora [`App`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/App.java) and [`ConfigManager.configDirFor`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/config/ConfigManager.java), [`ConfigDirTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/config/ConfigDirTest.java)."
    },
    {
      "id": "SET-08",
      "level": "SHOULD",
      "page": "settings",
      "pageTitle": "Settings",
      "section": "Config folder and schema",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/settings/#set-08",
      "text": "`settings.json` holds preferences, `workspace-state.json` session state, and other stores their own JSON files.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the config folder's file names are constants in the config package."
      },
      "reference": "Editora [`config/ConfigManager.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/config/ConfigManager.java), [`config/WorkspaceState.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/config/WorkspaceState.java)."
    },
    {
      "id": "SET-09",
      "level": "MUST",
      "page": "settings",
      "pageTitle": "Settings",
      "section": "Config folder and schema",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/settings/#set-09",
      "text": "Every versioned file has a `SCHEMA_VERSION` and a `v → v+1` migration step. A purely additive field uses an identity step.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "each store declares `SCHEMA_VERSION`, and the migrations have one step per version."
      },
      "reference": "Editora [`config/migration/ConfigMigrations.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/config/migration/ConfigMigrations.java), [`ConfigSchema.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/config/migration/ConfigSchema.java), [`ConfigMigrationsTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/config/migration/ConfigMigrationsTest.java)."
    },
    {
      "id": "SET-10",
      "level": "MUST",
      "page": "settings",
      "pageTitle": "Settings",
      "section": "Config folder and schema",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/settings/#set-10",
      "text": "A file newer than the running build is backed up to `<name>.v<n>.bak` and defaults load.",
      "why": "an older build never clobbers a newer config.",
      "check": {
        "kind": "test",
        "text": "a test loads a too-new `settings.json` and finds the backup and the defaults."
      },
      "reference": "Editora [`ConfigVersioningTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/config/ConfigVersioningTest.java) (`tooNewSettingsAreBackedUpAndDefaultsLoaded`)."
    },
    {
      "id": "SET-11",
      "level": "MUST",
      "page": "settings",
      "pageTitle": "Settings",
      "section": "Config folder and schema",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/settings/#set-11",
      "text": "Never trust a config file. Clamp every value to its valid range when it is **read**, not only when it is written; an unknown value falls back to its default; a file that cannot be decoded is kept as a backup (Editora names it `<name>.corrupt.bak`) and defaults load. A bad file never stops the app from starting.",
      "why": "config is plain JSON (or properties) and people edit it by hand. A hand-edited two-million-line scrollback must not exhaust memory at the next launch (Termina).",
      "check": {
        "kind": "test",
        "text": "a test loads out-of-range numbers and an unparseable file, including one that makes the parser throw something other than an `IOException` (a malformed `\\uXXXX` escape in a `.properties` file)."
      },
      "reference": "Editora [`config/migration/ConfigMigrations.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/config/migration/ConfigMigrations.java) (`keepCorrupt`), [`ConfigLoadProblemsTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/config/ConfigLoadProblemsTest.java) (`outOfRangeNumbersAreClampedOnLoad`, `anUnparseableFileIsReportedWithItsBackup`); Termina [`config/Settings.java`](https://github.com/adriandeleon/Termina/blob/master/src/main/java/com/termina/config/Settings.java), [`SettingsTest`](https://github.com/adriandeleon/Termina/blob/master/src/test/java/com/termina/config/SettingsTest.java) (`aMalformedEscapeNoLongerStopsTheAppStarting`). Torrenta, Modula, Mirada and nux keep no backup, and in Torrenta and nux a malformed escape stops the app from starting."
    },
    {
      "id": "SET-12",
      "level": "MUST",
      "page": "settings",
      "pageTitle": "Settings",
      "section": "Config folder and schema",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/settings/#set-12",
      "text": "Export configuration writes a timestamped `.zip` of the config folder; Import restores from one.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "tests over the zip's name and contents, and an import that replaces only the ticked parts."
      },
      "reference": "Editora [`config/ConfigExporter.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/config/ConfigExporter.java), [`config/ConfigImport.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/config/ConfigImport.java), [`ConfigExporterTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/config/ConfigExporterTest.java), [`ConfigImportTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/config/ConfigImportTest.java)."
    },
    {
      "id": "SET-13",
      "level": "MUST",
      "page": "settings",
      "pageTitle": "Settings",
      "section": "Secrets stay out of files",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/settings/#set-13",
      "text": "No secret goes in a config file. API keys and tokens go to the operating system's keychain: macOS Keychain, Windows Credential Manager, the Secret Service on Linux. Calls may block on a prompt, so they run off the FX thread.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "no key or token field in the settings model; reads and writes go through the secret store."
      },
      "reference": "Editora [`secrets/SecretStore.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/secrets/SecretStore.java), [`config/ApiKeyVault.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/config/ApiKeyVault.java). Editora doesn't yet: [`Settings`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/config/Settings.java) keeps the AI keys as a fallback for when no keychain answers, and saving a key from Settings writes the keychain on the FX thread. Torrenta keeps its proxy password, Torznab key and remote-profile passwords in plain text."
    },
    {
      "id": "SET-14",
      "level": "MUST",
      "page": "settings",
      "pageTitle": "Settings",
      "section": "Secrets stay out of files",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/settings/#set-14",
      "text": "A credential the app can ask for again lives in memory for the session only and is never written. Work that needs it waits until the user has signed in this session; do not \"fix\" that by storing the password.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the credential is a field of a runtime object, absent from every config class."
      },
      "reference": "nux's UPS login ([`app/CommandRunner.java`](https://github.com/adriandeleon/nux/blob/master/src/main/java/com/nux/app/CommandRunner.java))."
    },
    {
      "id": "SET-15",
      "level": "MUST",
      "page": "settings",
      "pageTitle": "Settings",
      "section": "Secrets stay out of files",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/settings/#set-15",
      "text": "A secret in the wrong place is refused. A repository URL with a password or token in it is refused, with the fix ([Settings Sync](https://pauta-project.dev/4.5.0/templates/settings-sync/)); a problem report redacts tokens, credentials, e-mail addresses, user names and home paths before anyone sees it ([Diagnostics](https://pauta-project.dev/4.5.0/diagnostics/)).",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "paste `https://user:token@host/repo.git` as the sync repository."
      },
      "reference": "Editora [`ui/SettingsSyncPage.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/SettingsSyncPage.java) (`settings.sync.repo.credentials`), [`sync/SyncEngine.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/sync/SyncEngine.java) (`hasCredentials`, checked again at sync time), [`report/Redactor.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/report/Redactor.java)."
    },
    {
      "id": "SET-16",
      "level": "MUST",
      "page": "settings",
      "pageTitle": "Settings",
      "section": "Secrets stay out of files",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/settings/#set-16",
      "text": "An option that weakens security has no UI: it exists only as a key in the config file, so nobody turns it on by clicking.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "no Settings row or command writes such a key."
      },
      "reference": "nux's trust-all TLS (`tlsTrustAll` in [`config/Config.java`](https://github.com/adriandeleon/nux/blob/master/src/main/java/com/nux/config/Config.java)). Editora doesn't yet: *Require registry signature* for plugins is a Settings checkbox and the `plugins.toggleRequireSignature` command."
    },
    {
      "id": "SET-18",
      "level": "SHOULD",
      "page": "settings",
      "pageTitle": "Settings",
      "section": "Settings Sync (Git / GitHub)",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/settings/#set-18",
      "text": "Setup is by pasting a repo URL, or **Create on GitHub** through the `gh` CLI. The account that can read the repo is pinned per clone, so machines with two GitHub accounts work.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a test remembers the first account that can read the repository and uses it without asking again."
      },
      "reference": "Editora [`sync/SyncAccount.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/sync/SyncAccount.java), [`SyncAccountTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/sync/SyncAccountTest.java), [`ui/SettingsSyncPage.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/SettingsSyncPage.java)."
    },
    {
      "id": "SET-19",
      "level": "SHOULD",
      "page": "settings",
      "pageTitle": "Settings",
      "section": "Settings Sync (Git / GitHub)",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/settings/#set-19",
      "text": "Sync runs automatically (on change and at start) and on demand. Machine-local keys (window size, paths) never sync.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "one pure class decides which keys or files travel, and machine-local ones are not among them."
      },
      "reference": "Editora [`ui/SettingsSync.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/SettingsSync.java) (after startup, after a local change, on an interval, and `sync.now`), [`sync/SyncCategory.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/sync/SyncCategory.java); Torrenta [`sync/SyncKeys.java`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/sync/SyncKeys.java)."
    },
    {
      "id": "SET-20",
      "level": "SHOULD",
      "page": "settings",
      "pageTitle": "Settings",
      "section": "Settings Sync (Git / GitHub)",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/settings/#set-20",
      "text": "On a same-entry conflict *this machine wins*, and a backup is taken before any sync that replaces local files.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a merge test where both sides changed one entry keeps this machine's."
      },
      "reference": "Editora [`sync/SyncMerge.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/sync/SyncMerge.java), [`SyncMergeTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/sync/SyncMergeTest.java)."
    },
    {
      "id": "SET-21",
      "level": "SHOULD",
      "page": "settings",
      "pageTitle": "Settings",
      "section": "Settings Sync (Git / GitHub)",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/settings/#set-21",
      "text": "Sync status shows as a pill in Settings and as echo messages; failures go to the Message Log.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "point Sync at a repository that does not exist and read the pill and the log."
      },
      "reference": "Editora [`ui/SettingsSyncPage.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/SettingsSyncPage.java), [`SyncStatus`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/SyncStatus.java)."
    },
    {
      "id": "DIAG-01",
      "level": "MUST",
      "page": "diagnostics",
      "pageTitle": "Diagnostics and support",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/diagnostics/#diag-01",
      "text": "The **Message Log** is a session-only, bounded history of every echo-area message with `HH:mm:ss` times, newest first. Esc closes it; Clear empties it. A click on the echo area opens it ([WIN-01](https://pauta-project.dev/4.5.0/window-shell/#win-01)); the [Message Log template](https://pauta-project.dev/4.5.0/templates/message-log/) has the rest.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a test records messages newest first, evicts the oldest past the cap, and clears."
      },
      "reference": "Editora [`ui/MessageLog.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MessageLog.java) ([`MessageLogTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/MessageLogTest.java)), [`ui/MessageLogPopup.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MessageLogPopup.java)."
    },
    {
      "id": "DIAG-02",
      "level": "MUST",
      "page": "diagnostics",
      "pageTitle": "Diagnostics and support",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/diagnostics/#diag-02",
      "text": "The **Debug Log** captures all `java.util.logging` records and uncaught exceptions in memory (bounded) **and** mirrors them to `<app>-session.log` in the config folder, keeping the previous one as `<app>-session.prev.log` so a crash is still visible next launch.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "tests bound the buffer and find the session file written and the previous one kept."
      },
      "reference": "Editora [`ui/DebugLog.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/DebugLog.java) ([`DebugLogTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/DebugLogTest.java), [`DebugLogSessionFileTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/DebugLogSessionFileTest.java))."
    },
    {
      "id": "DIAG-03",
      "level": "MUST",
      "page": "diagnostics",
      "pageTitle": "Diagnostics and support",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/diagnostics/#diag-03",
      "text": "The Debug Log opens in a modeless window with Refresh, Copy, Clear, Export and Report a Problem.",
      "why": "it is the only way to see logs in a packaged build.",
      "check": {
        "kind": "by hand",
        "text": "open the Debug Log and keep working in the main window while it is open."
      },
      "reference": "Editora [`ui/DebugLogWindow.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/DebugLogWindow.java)."
    },
    {
      "id": "DIAG-04",
      "level": "MUST",
      "page": "diagnostics",
      "pageTitle": "Diagnostics and support",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/diagnostics/#diag-04",
      "text": "An **uncaught exception handler** is installed at the start of `main`, before the toolkit starts, and routes to the Debug Log and an echo message. Never a stack trace dialog.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`main` calls the install method before any argument handling or `launch`, and the handler shows no dialog."
      },
      "reference": "Editora [`DebugLog.install()`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/DebugLog.java). Editora, Torrenta and Termina log the exception but do not yet post an echo message."
    },
    {
      "id": "DIAG-05",
      "level": "MUST",
      "page": "diagnostics",
      "pageTitle": "Diagnostics and support",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/diagnostics/#diag-05",
      "text": "The **update notification** reads GitHub `/releases/latest` once per app session (not per window), at most once a day, a few seconds after the first frame. A newer version shows a status-bar notice and a line in About; \"Check for Updates\" runs it by hand; Settings has an off switch. It never downloads or installs by itself.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a test waits for the first paint and the delay, then checks once a session and not when off or not due."
      },
      "reference": "Editora [`update/UpdateCheck.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/update/UpdateCheck.java), [`ui/UpdateCheckScheduler.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/UpdateCheckScheduler.java) ([`UpdateCheckSchedulerTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/UpdateCheckSchedulerTest.java)), [`ui/UpdateCoordinator.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/UpdateCoordinator.java)."
    },
    {
      "id": "DIAG-06",
      "level": "MUST",
      "page": "diagnostics",
      "pageTitle": "Diagnostics and support",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/diagnostics/#diag-06",
      "text": "Help → **Report a Problem** builds a report (version, OS, runtime, settings summary, recent Debug Log), **redacts** it (home paths, user names, e-mail addresses, credentials, tokens), shows it editable, copies it to the clipboard and opens a prefilled GitHub issue from `bug_report.yml`. Over about 7,500 characters the link falls back to \"paste from the clipboard\". Nothing is uploaded. The same report from the command line, for when the app cannot start, is [CLI-05](https://pauta-project.dev/4.5.0/command-line/#cli-05).",
      "why": null,
      "check": {
        "kind": "test",
        "text": "redaction tests cover home paths, user names, e-mail addresses, credentials in URLs and tokens; a report test puts a short report in the link and leaves the paste hint for a long one."
      },
      "reference": "Editora [`report/ProblemReport.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/report/ProblemReport.java), [`report/Redactor.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/report/Redactor.java), [`report/ReportCommand.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/report/ReportCommand.java), [`ui/ReportProblemWindow.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ReportProblemWindow.java) ([`RedactorTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/report/RedactorTest.java), [`ProblemReportTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/report/ProblemReportTest.java))."
    },
    {
      "id": "DIAG-07",
      "level": "SHOULD",
      "page": "diagnostics",
      "pageTitle": "Diagnostics and support",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/diagnostics/#diag-07",
      "text": "A **Doctor** page checks the environment (external tools, versions, permissions, paths), with a status per row and a fix or link for each failure.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "open the Doctor with a tool missing and find its row failed, with what to install."
      },
      "reference": "Editora `doctor/*`, [`ui/DoctorPane.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/DoctorPane.java)."
    },
    {
      "id": "DIAG-08",
      "level": "SHOULD",
      "page": "diagnostics",
      "pageTitle": "Diagnostics and support",
      "section": null,
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/diagnostics/#diag-08",
      "text": "An app with user documents snapshots unsaved work off the FX thread and offers it back after a crash.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a test finds an abandoned session's snapshots and offers them to the first window only."
      },
      "reference": "Editora [`recovery/RecoveryService.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/recovery/RecoveryService.java) ([`RecoveryServiceTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/recovery/RecoveryServiceTest.java), [`CrashRecoveryFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/CrashRecoveryFxTest.java))."
    },
    {
      "id": "CLI-01",
      "level": "MUST",
      "page": "command-line",
      "pageTitle": "Command line and launch",
      "section": "Flags",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/command-line/#cli-01",
      "text": "`--help` and `--version` print before the GUI starts, in plain English, not translated.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`main` handles both and exits before `launch`, printing fixed English text rather than catalog messages."
      },
      "reference": "Editora [`App.main`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/App.java), [`App.helpText`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/App.java); [`AppArgsTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/AppArgsTest.java)."
    },
    {
      "id": "CLI-02",
      "level": "MUST",
      "page": "command-line",
      "pageTitle": "Command line and launch",
      "section": "Flags",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/command-line/#cli-02",
      "text": "`--config-dir <dir>` uses another config folder, and `--dev` uses `~/.<app>-dev`.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the config folder is resolved from both flags before anything reads `~/.<app>`."
      },
      "reference": "Editora [`App.main`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/App.java) ([`ConfigManager.configDirFor`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/config/ConfigManager.java), [`App.devFlag`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/App.java))."
    },
    {
      "id": "CLI-03",
      "level": "SHOULD",
      "page": "command-line",
      "pageTitle": "Command line and launch",
      "section": "Flags",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/command-line/#cli-03",
      "text": "`--new-instance` starts a second process instead of handing off to the running one.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the flag skips the single-instance hand-off."
      },
      "reference": "Editora [`App.newInstanceFlag`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/App.java)."
    },
    {
      "id": "CLI-04",
      "level": "SHOULD",
      "page": "command-line",
      "pageTitle": "Command line and launch",
      "section": "Flags",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/command-line/#cli-04",
      "text": "`--no-session` does not restore the last session.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "launch with `--no-session` and find only the items given on the command line."
      },
      "reference": "Editora [`App.helpText`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/App.java)."
    },
    {
      "id": "CLI-05",
      "level": "MUST",
      "page": "command-line",
      "pageTitle": "Command line and launch",
      "section": "Flags",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/command-line/#cli-05",
      "text": "`--report` writes a redacted problem report and opens the GitHub issue, without starting the GUI.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a test runs the report command and finds the redacted report written."
      },
      "reference": "Editora [`report/ReportCommand.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/report/ReportCommand.java) ([`ReportCommandTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/report/ReportCommandTest.java))."
    },
    {
      "id": "CLI-06",
      "level": "SHOULD",
      "page": "command-line",
      "pageTitle": "Command line and launch",
      "section": "Flags",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/command-line/#cli-06",
      "text": "`[files…]` opens these items.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "launch with two files and find both open."
      },
      "reference": "Editora [`App.fileTargets`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/App.java)."
    },
    {
      "id": "CLI-07",
      "level": "MUST",
      "page": "command-line",
      "pageTitle": "Command line and launch",
      "section": "Launch",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/command-line/#cli-07",
      "text": "One instance runs per config folder. A second launch hands its arguments to the running app over a local endpoint and exits; on macOS, `openFiles` Apple Events reach the running app.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a test makes the first launch primary and delivers a second launch's arguments to it."
      },
      "reference": "Editora [`ipc/SingleInstance.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ipc/SingleInstance.java) ([`SingleInstanceTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ipc/SingleInstanceTest.java)), [`MacOpenFiles.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/MacOpenFiles.java)."
    },
    {
      "id": "CLI-08",
      "level": "SHOULD",
      "page": "command-line",
      "pageTitle": "Command line and launch",
      "section": "Launch",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/command-line/#cli-08",
      "text": "An advisory lock tells two processes on one config folder about each other.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a test takes the lock from two processes."
      },
      "reference": "Editora [`config/InstanceLock.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/config/InstanceLock.java) ([`InstanceLockTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/config/InstanceLockTest.java))."
    },
    {
      "id": "CLI-09",
      "level": "SHOULD",
      "page": "command-line",
      "pageTitle": "Command line and launch",
      "section": "Launch",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/command-line/#cli-09",
      "text": "`main` sets `java.awt.headless=true` before any AWT class loads.",
      "why": "on macOS, AWT's native toolkit and JavaFX contend for the one AppKit run loop and can hang; headless Java2D still draws to images.",
      "check": {
        "kind": "code",
        "text": "`System.setProperty(\"java.awt.headless\", \"true\")` is among the first statements of `main`."
      },
      "reference": "Editora [`App.main`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/App.java)."
    },
    {
      "id": "CLI-10",
      "level": "SHOULD",
      "page": "command-line",
      "pageTitle": "Command line and launch",
      "section": "Launch",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/command-line/#cli-10",
      "text": "External tools are resolved through the login shell's `PATH`.",
      "why": "a `.app` launched from Finder inherits a stripped `PATH`.",
      "check": {
        "kind": "code",
        "text": "every process the app starts gets a `PATH` that includes the login shell's."
      },
      "reference": "Editora [`process/ProcessRunner.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/process/ProcessRunner.java) (`augmentedPath`)."
    },
    {
      "id": "INTL-01",
      "level": "MUST",
      "page": "i18n",
      "pageTitle": "Internationalization",
      "section": "Languages",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/i18n/#intl-01",
      "text": "The app ships a message catalog for each of the six languages above, English as the base.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the six `messages*.properties` files are in the app's `i18n` resources."
      },
      "reference": "Editora [`src/main/resources/com/editora/i18n/`](https://github.com/adriandeleon/Editora/tree/master/src/main/resources/com/editora/i18n)."
    },
    {
      "id": "INTL-02",
      "level": "SHOULD",
      "page": "i18n",
      "pageTitle": "Internationalization",
      "section": "Languages",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/i18n/#intl-02",
      "text": "A new language is a `messages_<code>.properties` with every key, listed in the Settings language picker and in the parity test.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the language's code is in `Messages`' language list (which the picker shows) and in the catalog list the parity test walks."
      },
      "reference": "Editora [`i18n/Messages.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/i18n/Messages.java) (`LANGUAGES`, `available()`); [`MessagesTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/i18n/MessagesTest.java)'s `LOCALES` and `ALL_CATALOGS`, after which `translationCatalogsHaveExactlyTheBaseKeySet` holds it to the same keys as the others."
    },
    {
      "id": "INTL-03",
      "level": "SHOULD",
      "page": "i18n",
      "pageTitle": "Internationalization",
      "section": "Languages",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/i18n/#intl-03",
      "text": "Every value is translated for real: no English value is shipped in another language's catalog.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "compare each catalog's values with the base; a value identical to the English one is a name, a term or a bare pattern that stays the same in that language (\"Git: Pull (Rebase)\", \"{0} · {1}\"), never an untranslated sentence. No test catches it, so it is also checked in review."
      },
      "reference": "Editora `messages_*.properties`."
    },
    {
      "id": "INTL-04",
      "level": "SHOULD",
      "page": "i18n",
      "pageTitle": "Internationalization",
      "section": "Languages",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/i18n/#intl-04",
      "text": "The layout holds in every language at 1024 px wide: rows wrap, never cut. German is today's longest.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "run the app in each language at 1024 px wide (see [Quality](https://pauta-project.dev/4.5.0/quality/))."
      },
      "reference": "Editora [`messages_de.properties`](https://github.com/adriandeleon/Editora/blob/master/src/main/resources/com/editora/i18n/messages_de.properties)."
    },
    {
      "id": "INTL-05",
      "level": "SHOULD",
      "page": "i18n",
      "pageTitle": "Internationalization",
      "section": "Languages",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/i18n/#intl-05",
      "text": "A Chinese, Japanese or Korean catalog comes with a font fallback for its script.",
      "why": "Inter has no CJK glyphs.",
      "check": {
        "kind": "by hand",
        "text": "run the app in that language and look for missing-glyph boxes."
      },
      "reference": "no app yet."
    },
    {
      "id": "INTL-06",
      "level": "SHOULD",
      "page": "i18n",
      "pageTitle": "Internationalization",
      "section": "Languages",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/i18n/#intl-06",
      "text": "An Arabic or Hebrew catalog sets `NodeOrientation.RIGHT_TO_LEFT` on every scene.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the scene setup sets the node orientation from the current language."
      },
      "reference": "no app yet."
    },
    {
      "id": "INTL-07",
      "level": "SHOULD",
      "page": "i18n",
      "pageTitle": "Internationalization",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/i18n/#intl-07",
      "text": "No raw English literal is passed to a control: every string comes from `tr(\"some.key\")` in one `Messages` class.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a test scans the sources for `tr(\"…\")` calls and fails when a key is missing from the base catalog."
      },
      "reference": "Editora [`i18n/Messages.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/i18n/Messages.java), [`MessagesTest.everyLiteralKeyUsedInTheSourcesExists`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/i18n/MessagesTest.java)."
    },
    {
      "id": "INTL-08",
      "level": "MUST",
      "page": "i18n",
      "pageTitle": "Internationalization",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/i18n/#intl-08",
      "text": "Every catalog has every key of the base catalog, and no more, each with a non-empty value.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a parity test fails the build when a key is missing, extra or empty in any catalog."
      },
      "reference": "Editora [`MessagesTest.translationCatalogsHaveExactlyTheBaseKeySet`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/i18n/MessagesTest.java), `translationsAreNonEmptyAndDistinctFromKeys`."
    },
    {
      "id": "INTL-09",
      "level": "SHOULD",
      "page": "i18n",
      "pageTitle": "Internationalization",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/i18n/#intl-09",
      "text": "In a value with a placeholder, a literal apostrophe is doubled; in a value without one, it is written once.",
      "why": "a value with a placeholder is a `MessageFormat` pattern, where a lone apostrophe starts a quoted section and can swallow the placeholder after it; a value without one is shown exactly as written.",
      "check": {
        "kind": "test",
        "text": "catalog tests fail a lone apostrophe beside a placeholder and a doubled one without."
      },
      "reference": "Editora [`MessagesTest.aValueWithAPlaceholderNeverHasALoneApostrophe`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/i18n/MessagesTest.java), `aValueWithoutAPlaceholderNeverDoublesAnApostrophe`."
    },
    {
      "id": "INTL-10",
      "level": "SHOULD",
      "page": "i18n",
      "pageTitle": "Internationalization",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/i18n/#intl-10",
      "text": "Identifiers such as line numbers and ports use `{0,number,#}`, so they are not digit-grouped.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a test formats each identifier argument in every locale and fails on a grouped number."
      },
      "reference": "Editora [`MessagesTest.identifierArgumentsAreNeverDigitGrouped`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/i18n/MessagesTest.java)."
    },
    {
      "id": "INTL-11",
      "level": "SHOULD",
      "page": "i18n",
      "pageTitle": "Internationalization",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/i18n/#intl-11",
      "text": "Technical identifiers and the `--help` and `--version` text stay untranslated, outside the catalogs.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the usage text is a literal in the launcher, not a `tr` call."
      },
      "reference": "Editora [`App.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/App.java) (the usage text)."
    },
    {
      "id": "PAL-01",
      "level": "MUST",
      "page": "templates/command-palette",
      "pageTitle": "Command Palette",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/command-palette/#pal-01",
      "text": "Every app has one Command Palette per window, opened by the `palette.show` command. Its chords, `M-x` in the Emacs keymap and `Ctrl+Shift+P` (`Cmd+Shift+P` on macOS) in the others (`Ctrl+Shift+A` allowed in the IntelliJ keymap), are [KBD-05](https://pauta-project.dev/4.5.0/keyboard/#kbd-05).",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the window builds one `CommandPalette`, and `palette.show` opens it."
      },
      "reference": "Editora [`ui/CommandPalette.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/CommandPalette.java), built once in [`MainController`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MainController.java)."
    },
    {
      "id": "PAL-02",
      "level": "MUST",
      "page": "templates/command-palette",
      "pageTitle": "Command Palette",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/command-palette/#pal-02",
      "text": "The palette lists every registered command, with its title from `command.<id>` and its description from `command.<id>.desc`.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the palette's rows come from the whole registry, filtered only by the query; a command that cannot run stays listed, grayed. A catalog parity test fails on a command title with no `.desc`."
      },
      "reference": "Editora [`CommandPalette.filter`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/CommandPalette.java) (`registry.all()`), [`MessagesTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/i18n/MessagesTest.java); the Spec table below."
    },
    {
      "id": "PAL-04",
      "level": "SHOULD",
      "page": "templates/command-palette",
      "pageTitle": "Command Palette",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/command-palette/#pal-04",
      "text": "The palette opens from the `palette.show` command, by its chord or a menu item, with an empty query that lists every command.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`show` clears the field and filters on the empty query before the card appears."
      },
      "reference": "Editora [`CommandPalette.show`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/CommandPalette.java)."
    },
    {
      "id": "PAL-05",
      "level": "SHOULD",
      "page": "templates/command-palette",
      "pageTitle": "Command Palette",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/command-palette/#pal-05",
      "text": "Typing filters the list, and the first *enabled* match is selected.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a test with a disabled command at the top finds the cursor on the first enabled row."
      },
      "reference": "Editora [`CommandPalette.selectFirstEnabled`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/CommandPalette.java), [`CommandPaletteDisabledFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/CommandPaletteDisabledFxTest.java)."
    },
    {
      "id": "PAL-06",
      "level": "SHOULD",
      "page": "templates/command-palette",
      "pageTitle": "Command Palette",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/command-palette/#pal-06",
      "text": "↑ ↓, `C-n` `C-p` and Page Up/Down move the selection; Enter, or a click on an enabled row, runs the command. The palette closes first, then the command runs.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the run path hides the card before it calls the registry, and does nothing on a disabled row."
      },
      "reference": "Editora [`CommandPalette.runSelected`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/CommandPalette.java), [`PickerKeys`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/PickerKeys.java)."
    },
    {
      "id": "PAL-07",
      "level": "SHOULD",
      "page": "templates/command-palette",
      "pageTitle": "Command Palette",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/command-palette/#pal-07",
      "text": "Esc, `C-g` or a click on the scrim cancels, and focus returns to where it was.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the cancel key and a press on the backdrop both hide the overlay, and hiding focuses the node that had focus before it opened."
      },
      "reference": "Editora [`PickerKeys`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/PickerKeys.java) (`CANCEL`), [`OverlayHost`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/OverlayHost.java) (`previousFocus`)."
    },
    {
      "id": "PAL-08",
      "level": "SHOULD",
      "page": "templates/command-palette",
      "pageTitle": "Command Palette",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/command-palette/#pal-08",
      "text": "`C-h`, or the first of `C-h`, `F1`, `Shift+F1` the active keymap leaves free, opens the selected command's page on the website, for the running version.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the docs chord is the first free one of the three, and the URL is built from the app's versioned docs address."
      },
      "reference": "Editora [`CommandPalette`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/CommandPalette.java) ([`PickerKeys.freeChord`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/PickerKeys.java), `docsUrl`), [`AppInfo.docsUrl`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/AppInfo.java)."
    },
    {
      "id": "PAL-09",
      "level": "SHOULD",
      "page": "templates/command-palette",
      "pageTitle": "Command Palette",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/command-palette/#pal-09",
      "text": "A live keymap switch re-renders the key chips, the opener chip and the key legend.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "applying a new keymap calls the palette's rebind method, which rebuilds the opener, the legend and the rows."
      },
      "reference": "Editora [`CommandPalette.refreshBindings`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/CommandPalette.java), called from [`SettingsReapply`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/SettingsReapply.java)."
    },
    {
      "id": "QOPEN-01",
      "level": "SHOULD",
      "page": "templates/quick-open",
      "pageTitle": "QuickOpen picker",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/quick-open/#qopen-01",
      "text": "One picker serves every list choice: recent files, themes, keymaps, a setting's values, a branch to compare with.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "those choices are instances of one generic picker class; there is no second list-picker class or `ChoiceDialog` for them."
      },
      "reference": "Editora [`ui/QuickOpen.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/QuickOpen.java) (one generic class, instantiated more than seventy times), driven by [`PickerKeys`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/PickerKeys.java). Editora still asks with a `ChoiceDialog` in three places: the Git reset mode and the merge parent to revert against ([`ui/GitWindowCoordinator.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/GitWindowCoordinator.java)), and the settings backup to restore ([`ui/SettingsResetFlow.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/SettingsResetFlow.java))."
    },
    {
      "id": "QOPEN-02",
      "level": "SHOULD",
      "page": "templates/quick-open",
      "pageTitle": "QuickOpen picker",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/quick-open/#qopen-02",
      "text": "The picker is the palette's card in the shared in-scene overlay host, with a title naming the command over the field and a prompt in the field; never a `javafx.stage.Popup`.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the picker shows its card through the overlay host and sets a title and a prompt text."
      },
      "reference": "Editora [`QuickOpen.setOverlayHost`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/QuickOpen.java), [`ui/OverlayHost.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/OverlayHost.java); the Spec table below."
    },
    {
      "id": "QOPEN-03",
      "level": "SHOULD",
      "page": "templates/quick-open",
      "pageTitle": "QuickOpen picker",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/quick-open/#qopen-03",
      "text": "The items are read fresh on every showing and snapshotted, so typing filters a stable list. A source that answers late (an outline the language server has not returned yet) calls `reload()`.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`show` calls the items supplier; `reload` re-reads it and keeps the query."
      },
      "reference": "Editora [`QuickOpen.show`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/QuickOpen.java), [`QuickOpen.reload`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/QuickOpen.java)."
    },
    {
      "id": "QOPEN-04",
      "level": "SHOULD",
      "page": "templates/quick-open",
      "pageTitle": "QuickOpen picker",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/quick-open/#qopen-04",
      "text": "With nothing typed the list keeps the supplier's own order (recency for recent files, document order for symbols), with the current value pre-selected when there is one.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the empty query passes the items through unsorted and selects the `setCurrentItem` value."
      },
      "reference": "Editora [`QuickOpen.filter`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/QuickOpen.java), `setCurrentItem`."
    },
    {
      "id": "QOPEN-05",
      "level": "SHOULD",
      "page": "templates/quick-open",
      "pageTitle": "QuickOpen picker",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/quick-open/#qopen-05",
      "text": "Typing ranks by fuzzy score, and ties keep the supplier's order, so rows do not shuffle under the cursor between keystrokes.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the sort's last tiebreak is the supplier's index."
      },
      "reference": "Editora [`QuickOpen.filter`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/QuickOpen.java)."
    },
    {
      "id": "QOPEN-06",
      "level": "SHOULD",
      "page": "templates/quick-open",
      "pageTitle": "QuickOpen picker",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/quick-open/#qopen-06",
      "text": "The active keymap's line and page chords (`nav.lineDown`, `nav.pageUp`, …) move the selection, as do ↑ ↓, Page Up/Down and `Ctrl+Home`/`Ctrl+End` (`Cmd` on macOS), which always work; plain Home and End stay with the field's caret. Enter or a click on a row chooses; the card hides first, then the choice runs, so focus is already back where it belongs.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the accept path hides the card before it calls the choice handler."
      },
      "reference": "Editora [`QuickOpen`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/QuickOpen.java) (`hide()` then `onChoose`), [`PickerKeys.resolve`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/PickerKeys.java)."
    },
    {
      "id": "QOPEN-07",
      "level": "SHOULD",
      "page": "templates/quick-open",
      "pageTitle": "QuickOpen picker",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/quick-open/#qopen-07",
      "text": "Esc, `C-g` or a click on the scrim cancels, and the host restores focus. A picker that previewed something undoes it.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a test previews a row, dismisses the picker and finds the preview undone."
      },
      "reference": "Editora [`OverlayHost`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/OverlayHost.java) (`previousFocus`), [`QuickOpenPreviewFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/QuickOpenPreviewFxTest.java) (`dismissingRestoresWhatWasPreviewed`)."
    },
    {
      "id": "QOPEN-08",
      "level": "MAY",
      "page": "templates/quick-open",
      "pageTitle": "QuickOpen picker",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/quick-open/#qopen-08",
      "text": "A picker previews the highlighted row as the selection moves and undoes the preview on cancel (Recent Locations shows each place and returns to the origin on Esc). A preview without an undo is worse than none, and nothing is previewed for the row the picker opens on, only for one the user moved to. The theme and keymap pickers do not preview; they apply on Enter.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "opening previews nothing, moving previews, choosing does not restore."
      },
      "reference": "Editora [`QuickOpen.setPreview(onPreview, onCancelled)`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/QuickOpen.java), [`QuickOpenPreviewFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/QuickOpenPreviewFxTest.java)."
    },
    {
      "id": "QOPEN-09",
      "level": "MAY",
      "page": "templates/quick-open",
      "pageTitle": "QuickOpen picker",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/quick-open/#qopen-09",
      "text": "A row action acts on the highlighted row and keeps the picker open (the breakpoints picker enables or removes one), re-reading the list afterwards and keeping the cursor in place.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a row action runs on the highlighted row and the picker stays up."
      },
      "reference": "Editora [`QuickOpen.addRowAction(key, legend, action)`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/QuickOpen.java), [`QuickOpenPreviewFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/QuickOpenPreviewFxTest.java) (`aRowActionActsOnTheHighlightedRowAndKeepsThePickerOpen`)."
    },
    {
      "id": "QOPEN-10",
      "level": "SHOULD",
      "page": "templates/quick-open",
      "pageTitle": "QuickOpen picker",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/quick-open/#qopen-10",
      "text": "A picker that can open on an empty list shows a placeholder sentence in it, never a blank card. A picker with nothing to offer may instead say so in the status line and not open.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "each picker whose source can be empty either calls `setPlaceholder` or returns before `show` with a status message."
      },
      "reference": "Editora [`QuickOpen.setPlaceholder`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/QuickOpen.java) ([`BreakpointsPicker`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/BreakpointsPicker.java)); [`NavigationCoordinator`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/NavigationCoordinator.java) (`status.nav.noRecentLocations`)."
    },
    {
      "id": "QOPEN-11",
      "level": "SHOULD",
      "page": "templates/quick-open",
      "pageTitle": "QuickOpen picker",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/quick-open/#qopen-11",
      "text": "The host shows one card at a time; opening a picker replaces whatever card was up.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the host's `show` removes the previous card before it adds the new one, and keeps the original focus owner."
      },
      "reference": "Editora [`OverlayHost.show`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/OverlayHost.java)."
    },
    {
      "id": "QOPEN-12",
      "level": "SHOULD",
      "page": "templates/quick-open",
      "pageTitle": "QuickOpen picker",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/quick-open/#qopen-12",
      "text": "The picker's relatives move, accept and cancel with the same keys as the picker.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "each relative maps its keys through `PickerKeys`."
      },
      "reference": "Editora [`Switcher`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/Switcher.java), [`FileFinder`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/FileFinder.java), [`MultiSelectPicker`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MultiSelectPicker.java), [`BranchPopup`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/BranchPopup.java), [`GitStashPopup`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/GitStashPopup.java)."
    },
    {
      "id": "WELC-01",
      "level": "SHOULD",
      "page": "templates/welcome",
      "pageTitle": "Welcome page",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/welcome/#welc-01",
      "text": "An app that opens files or projects shows a Welcome page when there is no session to restore.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "startup with nothing restored opens the Welcome page."
      },
      "reference": "Editora [`ui/WelcomePane.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/WelcomePane.java), [`MainController.addWelcomeTab`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MainController.java)."
    },
    {
      "id": "WELC-02",
      "level": "SHOULD",
      "page": "templates/welcome",
      "pageTitle": "Welcome page",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/welcome/#welc-02",
      "text": "An app whose window *is* its content shows its own empty state instead, with the same ingredients: the ways in, each with its chord.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "start the app with nothing in it and read the empty state's keys."
      },
      "reference": "Torrenta [`ui/Welcome.java`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/ui/Welcome.java) (see In the apps below)."
    },
    {
      "id": "WELC-03",
      "level": "SHOULD",
      "page": "templates/welcome",
      "pageTitle": "Welcome page",
      "section": "Behavior",
      "appliesTo": "an app with a Welcome page ([WELC-01](https://pauta-project.dev/4.5.0/templates/welcome/#welc-01)).",
      "url": "https://pauta-project.dev/4.5.0/templates/welcome/#welc-03",
      "text": "The page is shown at startup when there is no session to restore (so always with `--no-session`), by the `view.welcome` command (Help → Welcome Page), and when the tab strip is empty after a project swap. Standalone diff startup suppresses it while its worker reads the files.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "those three paths open the one Welcome tab; the diff startup holds a flag that skips it."
      },
      "reference": "Editora [`MainController.addWelcomeTab`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MainController.java), `showWelcomeIfNoTabs`; [`WindowSessionCoordinator`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/WindowSessionCoordinator.java) (`suppressWelcome`)."
    },
    {
      "id": "WELC-04",
      "level": "SHOULD",
      "page": "templates/welcome",
      "pageTitle": "Welcome page",
      "section": "Behavior",
      "appliesTo": "an app with a Welcome page ([WELC-01](https://pauta-project.dev/4.5.0/templates/welcome/#welc-01)).",
      "url": "https://pauta-project.dev/4.5.0/templates/welcome/#welc-04",
      "text": "Closing the last file tab does not bring the page back. The editor area shows its own quiet hint instead: Open File, Open Folder, Command Palette and Welcome Page, each with its chord, and takes focus so chords still reach the window.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "closing the last tab shows the hint and opening a tab hides it."
      },
      "reference": "Editora [`ui/EditorEmptyState.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/EditorEmptyState.java), [`EditorEmptyStateFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/EditorEmptyStateFxTest.java)."
    },
    {
      "id": "WELC-05",
      "level": "SHOULD",
      "page": "templates/welcome",
      "pageTitle": "Welcome page",
      "section": "Behavior",
      "appliesTo": "an app with a Welcome page ([WELC-01](https://pauta-project.dev/4.5.0/templates/welcome/#welc-01)).",
      "url": "https://pauta-project.dev/4.5.0/templates/welcome/#welc-05",
      "text": "The page is rebuilt on every show, so the recents, the Projects and Git toggles, the keymap and the theme are current. A refresh keeps the focus where it was.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "showing the page calls `refresh`, which re-requests focus when the page had it."
      },
      "reference": "Editora [`WelcomePane.refresh`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/WelcomePane.java)."
    },
    {
      "id": "WELC-06",
      "level": "SHOULD",
      "page": "templates/welcome",
      "pageTitle": "Welcome page",
      "section": "Behavior",
      "appliesTo": "an app with a Welcome page ([WELC-01](https://pauta-project.dev/4.5.0/templates/welcome/#welc-01)).",
      "url": "https://pauta-project.dev/4.5.0/templates/welcome/#welc-06",
      "text": "The recent lists offer no file that no longer exists and no project whose root is gone. Remote files are kept unchecked.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the recent files pass through the same filter as the toolbar's dropdown; projects are kept only when their root is a directory."
      },
      "reference": "Editora [`RecentFiles.showable`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/config/RecentFiles.java), [`WelcomePane`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/WelcomePane.java)."
    },
    {
      "id": "WELC-07",
      "level": "SHOULD",
      "page": "templates/welcome",
      "pageTitle": "Welcome page",
      "section": "Behavior",
      "appliesTo": "an app with a Welcome page ([WELC-01](https://pauta-project.dev/4.5.0/templates/welcome/#welc-01)).",
      "url": "https://pauta-project.dev/4.5.0/templates/welcome/#welc-07",
      "text": "Remove from recent files asks first, through the caller, then refreshes the page.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the remover the page is given shows a confirmation before it removes the entry."
      },
      "reference": "Editora [`WelcomePane.setRecentRemover`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/WelcomePane.java); [`MainController`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MainController.java) (`dialog.removeRecent.*`)."
    },
    {
      "id": "WELC-08",
      "level": "SHOULD",
      "page": "templates/welcome",
      "pageTitle": "Welcome page",
      "section": "Behavior",
      "appliesTo": "an app with a Welcome page ([WELC-01](https://pauta-project.dev/4.5.0/templates/welcome/#welc-01)).",
      "url": "https://pauta-project.dev/4.5.0/templates/welcome/#welc-08",
      "text": "The digits 1 to 9 open the numbered entries: typed characters only, with no modifier, so chords and Enter are untouched.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the digit handler is on `KEY_TYPED` and ignores Ctrl, Alt and Meta."
      },
      "reference": "Editora [`WelcomePane.onKeyTyped`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/WelcomePane.java)."
    },
    {
      "id": "WELC-09",
      "level": "SHOULD",
      "page": "templates/welcome",
      "pageTitle": "Welcome page",
      "section": "Behavior",
      "appliesTo": "an app with a Welcome page ([WELC-01](https://pauta-project.dev/4.5.0/templates/welcome/#welc-01)).",
      "url": "https://pauta-project.dev/4.5.0/templates/welcome/#welc-09",
      "text": "Saved SFTP sites appear as their own section; a click opens the connection form prefilled. The section is hidden when there are none.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the page adds a Remote Sites section only when the saved-sites list is not empty."
      },
      "reference": "Editora [`WelcomePane`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/WelcomePane.java) (`remoteSites`, `welcome.remote`)."
    },
    {
      "id": "WELC-10",
      "level": "SHOULD",
      "page": "templates/welcome",
      "pageTitle": "Welcome page",
      "section": "Behavior",
      "appliesTo": "an app with a Welcome page ([WELC-01](https://pauta-project.dev/4.5.0/templates/welcome/#welc-01)).",
      "url": "https://pauta-project.dev/4.5.0/templates/welcome/#welc-10",
      "text": "Customize runs `keymap.select` and `theme.setAppTheme`; a change made there re-renders the page, chords included.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the Customize links run those two commands."
      },
      "reference": "Editora [`WelcomePane`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/WelcomePane.java) (`customizeRow`)."
    },
    {
      "id": "WELC-11",
      "level": "SHOULD",
      "page": "templates/welcome",
      "pageTitle": "Welcome page",
      "section": "Behavior",
      "appliesTo": "an app with a Welcome page ([WELC-01](https://pauta-project.dev/4.5.0/templates/welcome/#welc-01)).",
      "url": "https://pauta-project.dev/4.5.0/templates/welcome/#welc-11",
      "text": "The Welcome tab is not a document: its menu is Close only, with no Save, Rename or Pin, and the title bar shows the app or project name, not a file.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the Welcome tab's context menu holds one Close item."
      },
      "reference": "Editora [`MainController.addWelcomeTab`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MainController.java)."
    },
    {
      "id": "ABOUT-01",
      "level": "MUST",
      "page": "templates/about",
      "pageTitle": "About window",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/about/#about-01",
      "text": "Every app has an About window, reached by Help → About, the `help.about` command, and on macOS the application menu's About item.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`help.about` is registered and listed in the Help menu, and the macOS application menu's About item runs it."
      },
      "reference": "Editora [`ui/AboutDialog.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/AboutDialog.java), [`ui/MenuBarModel.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MenuBarModel.java) (`help.about` in the Help menu)."
    },
    {
      "id": "ABOUT-02",
      "level": "MUST",
      "page": "templates/about",
      "pageTitle": "About window",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/about/#about-02",
      "text": "About shows the version and build, the Pauta edition (see below), the runtime, the license, links, and the result of the last update check.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the window reads the version, build and edition from `AppInfo`, the same text as `--version`, and shows the update checker's last answer."
      },
      "reference": "Editora [`ui/AboutDialog.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/AboutDialog.java), [`AppInfo`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/AppInfo.java); the Spec table below."
    },
    {
      "id": "ABOUT-03",
      "level": "SHOULD",
      "page": "templates/about",
      "pageTitle": "About window",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/about/#about-03",
      "text": "*Copy details* copies the environment block and leaves the window open; its label becomes \"Copied\".",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the button sits in the content, not the dialog's button bar, so pressing it can't close the window."
      },
      "reference": "Editora [`AboutDialog`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/AboutDialog.java) (`about.copyDetails`, `about.copied`)."
    },
    {
      "id": "ABOUT-04",
      "level": "SHOULD",
      "page": "templates/about",
      "pageTitle": "About window",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/about/#about-04",
      "text": "The update status claims nothing before a check has answered: with no answer, or with the check switched off, it says it has not checked, never \"up to date\".",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the status falls back to the not-checked text when the checker has no result."
      },
      "reference": "Editora [`AboutDialog`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/AboutDialog.java) (`about.notChecked`); the states below."
    },
    {
      "id": "ABOUT-05",
      "level": "MUST",
      "page": "templates/about",
      "pageTitle": "About window",
      "section": "Pauta edition and conformance",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/about/#about-05",
      "text": "The edition appears in two places: a link, *Built to Pauta 4.2.0*, among the others, and a line `Pauta: 4.2.0` in the environment block, right after the commit, so *Copy details* carries it.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the links use the `about.pauta` key, and the environment block writes a `Pauta:` line after the commit."
      },
      "reference": "The [app template](https://github.com/adriandeleon/adl-desktop-app-template)'s [`ui/AboutDialog.java`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/main/java/com/example/app/ui/AboutDialog.java) and [`AppInfo.java`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/main/java/com/example/app/AppInfo.java); Termina's [`ui/AboutWindow.java`](https://github.com/adriandeleon/Termina/blob/master/src/main/java/com/termina/ui/AboutWindow.java) and [`AppInfo.java`](https://github.com/adriandeleon/Termina/blob/master/src/main/java/com/termina/AppInfo.java)."
    },
    {
      "id": "ABOUT-06",
      "level": "MUST",
      "page": "templates/about",
      "pageTitle": "About window",
      "section": "Pauta edition and conformance",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/about/#about-06",
      "text": "The link opens the edition's own address, `https://pauta-project.dev/<edition>/` (for example `https://pauta-project.dev/4.2.0/`), which never changes, not `latest/`, which moves on to newer editions.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the URL is built from the edition number and never contains `latest`."
      },
      "reference": "The [app template](https://github.com/adriandeleon/adl-desktop-app-template)'s [`AppInfo.java`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/main/java/com/example/app/AppInfo.java) (`pautaUrl`); Termina's [`AppInfo.java`](https://github.com/adriandeleon/Termina/blob/master/src/main/java/com/termina/AppInfo.java) (`pautaUrl`)."
    },
    {
      "id": "ABOUT-07",
      "level": "MUST",
      "page": "templates/about",
      "pageTitle": "About window",
      "section": "Pauta edition and conformance",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/about/#about-07",
      "text": "The number is the edition the app meets, not the newest. Moving to a newer edition means reading its changelog for new or stronger MUSTs, meeting them, then changing the number. An app at Partial names the edition it is working toward instead, and says so (ABOUT-09).",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "audit the app against the MUSTs of the edition it names."
      },
      "reference": "no app yet."
    },
    {
      "id": "ABOUT-08",
      "level": "MUST",
      "page": "templates/about",
      "pageTitle": "About window",
      "section": "Pauta edition and conformance",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/about/#about-08",
      "text": "The edition has one source: a `pauta.version` property in `pom.xml`, filtered into `build-info.properties` and read by `AppInfo`, like the app's own version. The README's Pauta badge and its \"Built to\" line name the same edition and change with it.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`pom.xml` defines `pauta.version`, `build-info.properties` carries it, `AppInfo` reads it, and the README names the same number."
      },
      "reference": "The [app template](https://github.com/adriandeleon/adl-desktop-app-template)'s [`pom.xml`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/pom.xml), `build-info.properties` and [`AppInfo.java`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/main/java/com/example/app/AppInfo.java); Termina's the same, with [`AppInfo.java`](https://github.com/adriandeleon/Termina/blob/master/src/main/java/com/termina/AppInfo.java)."
    },
    {
      "id": "ABOUT-09",
      "level": "MUST",
      "page": "templates/about",
      "pageTitle": "About window",
      "section": "Pauta edition and conformance",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/about/#about-09",
      "text": "About shows the app's conformance, Complete, Core or Partial, as the helper computes it from `pauta.json` ([PAUTA-02](https://pauta-project.dev/4.5.0/conformance/#pauta-02)) and never higher: a link, *Pauta conformance: Core*, right after the edition's, that opens the [Pauta window](https://pauta-project.dev/4.5.0/templates/pauta-window/), and a line `Pauta conformance: Core (2 exceptions)` right after the `Pauta:` line; with one it says `(1 exception)`, with none `(no exceptions)`. At Partial the edition's link reads *Working toward Pauta 4.2.0*: the app does not meet that edition yet, so it does not say it is built to it.",
      "why": "[*Never claim what is not true*](https://pauta-project.dev/4.5.0/principles/#for-the-people-using-the-apps).",
      "check": {
        "kind": "code",
        "text": "About calls the conformance helper and holds no conformance name of its own; the link runs `help.pauta`; at Partial the edition's link uses `about.pautaWorkingToward`."
      },
      "reference": "The [app template](https://github.com/adriandeleon/adl-desktop-app-template)'s [`ui/AboutDialog.java`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/main/java/com/example/app/ui/AboutDialog.java) and [`PautaConformance.java`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/main/java/com/example/app/PautaConformance.java) (`environmentLine`). Termina's About shows the edition but not the conformance."
    },
    {
      "id": "PWIN-01",
      "level": "MUST",
      "page": "templates/pauta-window",
      "pageTitle": "Pauta window",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/pauta-window/#pwin-01",
      "text": "Every app has a Pauta window, opened by the `help.pauta` command: from the Command Palette like every command, from the Help menu's *Pauta Conformance* row just above About, and from About's *Pauta conformance* link.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`help.pauta` is registered, the Help `MenuSpec` lists it before `help.about`, and About's *Pauta conformance* link runs it through the registry."
      },
      "reference": "The [app template](https://github.com/adriandeleon/adl-desktop-app-template)'s [`ui/Commands.java`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/main/java/com/example/app/ui/Commands.java) (`help.pauta`), [`ui/AppMenus.java`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/main/java/com/example/app/ui/AppMenus.java) (before `help.about` in Help) and [`ui/AboutDialog.java`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/main/java/com/example/app/ui/AboutDialog.java)."
    },
    {
      "id": "PWIN-02",
      "level": "MUST",
      "page": "templates/pauta-window",
      "pageTitle": "Pauta window",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/pauta-window/#pwin-02",
      "text": "The window shows the edition, the conformance with one sentence that says what it means, a count of exceptions by kind, and every exception: the rule's ID, its level (MUST or SHOULD), the kind, the reason, and for a deviation or a pending exception its link.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "open the window and compare it with `pauta.json`, entry by entry."
      },
      "reference": "The [app template](https://github.com/adriandeleon/adl-desktop-app-template)'s [`ui/PautaWindow.java`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/main/java/com/example/app/ui/PautaWindow.java)."
    },
    {
      "id": "PWIN-03",
      "level": "MUST",
      "page": "templates/pauta-window",
      "pageTitle": "Pauta window",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/pauta-window/#pwin-03",
      "text": "It reads from `pauta.json` and `AppInfo` alone, and takes the conformance from the same helper as About ([PAUTA-02](https://pauta-project.dev/4.5.0/conformance/#pauta-02)). Nothing in it is written in the window's code.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the window loads the exceptions through one loader and calls the conformance helper; it holds no rule IDs or conformance names of its own."
      },
      "reference": "The [app template](https://github.com/adriandeleon/adl-desktop-app-template)'s [`ui/PautaWindow.java`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/main/java/com/example/app/ui/PautaWindow.java) (`PautaConformance.of`)."
    },
    {
      "id": "PWIN-04",
      "level": "MUST",
      "page": "templates/pauta-window",
      "pageTitle": "Pauta window",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/pauta-window/#pwin-04",
      "text": "Every link opens a fixed address: the edition at `https://pauta-project.dev/<edition>/`, each rule ID at its address in that edition (the entry's `url`), never `latest/`. The edition's link, here and in About, runs the `help.pautaRules` command, so the palette reaches it too.",
      "why": "an app built to 4.2.0 answers to 4.2.0's rules; `latest/` moves on.",
      "check": {
        "kind": "code",
        "text": "`help.pautaRules` is registered and builds the edition URL from `pauta.version`; rule links use each entry's `url`."
      },
      "reference": "[ABOUT-06](https://pauta-project.dev/4.5.0/templates/about/#about-06)."
    },
    {
      "id": "PWIN-05",
      "level": "SHOULD",
      "page": "templates/pauta-window",
      "pageTitle": "Pauta window",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/pauta-window/#pwin-05",
      "text": "Pending exceptions come first, then deviations, then app-only (in a template), then not-applicable; within a kind, MUSTs before SHOULDs, then by ID.",
      "why": "what the app still owes is what a reader came to find.",
      "check": {
        "kind": "test",
        "text": "a unit test of the sort."
      },
      "reference": "The [app template](https://github.com/adriandeleon/adl-desktop-app-template)'s [`PautaConformance.java`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/main/java/com/example/app/PautaConformance.java) (`sorted`), tested by [`PautaConformanceTest`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/test/java/com/example/app/PautaConformanceTest.java)."
    },
    {
      "id": "PWIN-06",
      "level": "SHOULD",
      "page": "templates/pauta-window",
      "pageTitle": "Pauta window",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/pauta-window/#pwin-06",
      "text": "*Copy as text* copies the edition, the conformance and the list as Markdown, one line per exception, and leaves the window open; its label becomes \"Copied\".",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the button sits in the content, not the button bar, like About's *Copy details*."
      },
      "reference": "Editora [`AboutDialog`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/AboutDialog.java) (`about.copyDetails`, `about.copied`)."
    },
    {
      "id": "PWIN-07",
      "level": "SHOULD",
      "page": "templates/pauta-window",
      "pageTitle": "Pauta window",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/pauta-window/#pwin-07",
      "text": "A *Conformance in the docs* link runs the `help.pautaDocs` command, which opens the app's docs page ([PAUTA-13](https://pauta-project.dev/4.5.0/conformance/#pauta-13)) for this version, `/docs/v-<version>/pauta/`, where the site serves versioned docs ([DOCS-03](https://pauta-project.dev/4.5.0/documentation/#docs-03)), and `/docs/pauta/` until it does. The README's badge links the unversioned page, which always shows the latest release.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`help.pautaDocs` is registered and builds the URL from the app's docs base, like Help → Documentation."
      },
      "reference": "Editora [`AppInfo.docsUrl()`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/AppInfo.java)."
    },
    {
      "id": "PWIN-08",
      "level": "SHOULD",
      "page": "templates/pauta-window",
      "pageTitle": "Pauta window",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/pauta-window/#pwin-08",
      "text": "With no exceptions, the list's place says so in one line, \"No exceptions: Mirada meets every MUST and SHOULD of Pauta 4.2.0.\", and the copy button still works.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "with an empty `exceptions` array, open the window."
      },
      "reference": "The [app template](https://github.com/adriandeleon/adl-desktop-app-template)'s [`ui/PautaWindow.java`](https://github.com/adriandeleon/adl-desktop-app-template/blob/master/src/main/java/com/example/app/ui/PautaWindow.java) (`pauta.none`)."
    },
    {
      "id": "CONF-01",
      "level": "MUST",
      "page": "templates/confirm-dialog",
      "pageTitle": "Confirm dialog",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/confirm-dialog/#conf-01",
      "text": "Before anything the user made is removed, deleted, discarded or overwritten, the app asks first, unless the action can be taken back instead.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "each destructive action calls a confirmation before it changes anything, or records an undo."
      },
      "reference": "Editora [`ui/CloseCoordinator.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/CloseCoordinator.java) (unsaved changes, Quit) and [`GitCoordinator.confirmDestructive`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/GitCoordinator.java); Torrenta [`ui/RemoveConfirm.java`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/ui/RemoveConfirm.java), which asks it for the torrent list, the RSS tab and every list in Settings."
    },
    {
      "id": "CONF-02",
      "level": "MUST",
      "page": "templates/confirm-dialog",
      "pageTitle": "Confirm dialog",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/confirm-dialog/#conf-02",
      "text": "The question names the thing and what happens to it.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "every confirmation string names the thing, by an argument for its name or count or in its own words (\"Quit Editora?\"), and says what happens to it."
      },
      "reference": "Editora `dialog.unsaved.header`, `dialog.discard.tracked`; Torrenta [`RemoveConfirm.question`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/ui/RemoveConfirm.java), [`Actions.removeQuestion`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/ui/Actions.java)."
    },
    {
      "id": "CONF-03",
      "level": "MUST",
      "page": "templates/confirm-dialog",
      "pageTitle": "Confirm dialog",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/confirm-dialog/#conf-03",
      "text": "The confirming button carries the action's own verb (Delete files, Remove, Discard, Quit), never OK or Yes, in the `danger` style.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the action's `ButtonType` is named from the catalog and its button gets the `danger` style class."
      },
      "reference": "Editora [`GitCoordinator.confirmDestructive`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/GitCoordinator.java), [`MainController.styleUnsavedChangesButtons`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MainController.java), `styleQuitButtonAsDanger`; Torrenta [`RemoveConfirm.ask`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/ui/RemoveConfirm.java)."
    },
    {
      "id": "CONF-04",
      "level": "MUST",
      "page": "templates/confirm-dialog",
      "pageTitle": "Confirm dialog",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/confirm-dialog/#conf-04",
      "text": "Cancel is the way out: Escape and the window's close button both answer Cancel, and nothing is lost on a dismissal.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "Cancel has the `CANCEL_CLOSE` role, and the result defaults to Cancel when the dialog closes any other way (`showAndWait().orElse(cancel)`)."
      },
      "reference": "Editora [`GitCoordinator.confirmDestructive`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/GitCoordinator.java), [`CloseCoordinator.unsavedAlert`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/CloseCoordinator.java); Torrenta [`RemoveConfirm.ask`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/ui/RemoveConfirm.java)."
    },
    {
      "id": "CONF-05",
      "level": "SHOULD",
      "page": "templates/confirm-dialog",
      "pageTitle": "Confirm dialog",
      "section": "States",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/confirm-dialog/#conf-05",
      "text": "When saving is an option the question has three answers, in this order: Save (the `success` style, green), Discard (`danger`) and Cancel. A Save that fails leaves the tab open.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the unsaved-changes alert sets Save, Discard and Cancel in that order and styles the first two."
      },
      "reference": "Editora [`CloseCoordinator.unsavedAlert`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/CloseCoordinator.java), [`MainController.styleUnsavedChangesButtons`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MainController.java)."
    },
    {
      "id": "CONF-06",
      "level": "SHOULD",
      "page": "templates/confirm-dialog",
      "pageTitle": "Confirm dialog",
      "section": "States",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/confirm-dialog/#conf-06",
      "text": "A question about ending a running program, which is not the user's data, words the button Close and makes Cancel the default button, so dismissing the dialog by any route keeps the program alive.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the close-running-program alert calls `setDefaultButton(true)` on Cancel."
      },
      "reference": "Termina [`ui/TerminalWindow.java`](https://github.com/adriandeleon/Termina/blob/master/src/main/java/com/termina/ui/TerminalWindow.java) (`dialog.closeAnyway`)."
    },
    {
      "id": "CONF-07",
      "level": "SHOULD",
      "page": "templates/confirm-dialog",
      "pageTitle": "Confirm dialog",
      "section": "States",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/confirm-dialog/#conf-07",
      "text": "Where the action can be taken back, the app asks nothing and offers Undo instead.",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "close a clean tab and reopen it with Reopen Closed Tab; in Mirada, trash an image and undo."
      },
      "reference": "Mirada moves an image to the trash at once and offers Undo; Torrenta asks before removing a torrent but also keeps the removal on its undo stack for ten minutes ([`UndoStack.KEEP_MS`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/ui/UndoStack.java)); Editora [`ClosedTabs`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ClosedTabs.java)."
    },
    {
      "id": "CONF-08",
      "level": "SHOULD",
      "page": "templates/confirm-dialog",
      "pageTitle": "Confirm dialog",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/confirm-dialog/#conf-08",
      "text": "The question comes before anything changes, and the action runs only on the action button.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the helper returns true on the action button alone, and the caller acts only on true."
      },
      "reference": "Torrenta [`RemoveConfirm.ask`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/ui/RemoveConfirm.java); Editora [`GitCoordinator.confirmDestructive`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/GitCoordinator.java)."
    },
    {
      "id": "CONF-09",
      "level": "SHOULD",
      "page": "templates/confirm-dialog",
      "pageTitle": "Confirm dialog",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/confirm-dialog/#conf-09",
      "text": "One gesture asks one question. An action on many things asks once with the count (\"Remove these 3 torrents?\", Torrenta's \"Apply to many torrents\" for a bulk command). Closing every tab asks per unsaved buffer, selecting each tab first so the user sees what the question is about, and remembers a Discard answer for exactly the state that was shown.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "a bulk command builds one question with a plural count; the close-all sweep selects each tab before it asks."
      },
      "reference": "Torrenta [`Actions.removeQuestion`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/ui/Actions.java); Editora [`CloseCoordinator.confirmSweep`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/CloseCoordinator.java)."
    },
    {
      "id": "CONF-10",
      "level": "SHOULD",
      "page": "templates/confirm-dialog",
      "pageTitle": "Confirm dialog",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/confirm-dialog/#conf-10",
      "text": "A delete that cannot be undone says so; one that leaves the files says that instead.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "\"This cannot be undone.\" appears only in the strings of actions that cannot be undone."
      },
      "reference": "Editora `dialog.discard.tracked`; Torrenta `actions.removeQuestion.delete`."
    },
    {
      "id": "CONF-11",
      "level": "SHOULD",
      "page": "templates/confirm-dialog",
      "pageTitle": "Confirm dialog",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/confirm-dialog/#conf-11",
      "text": "A dangerous alternative (Force with Lease, Delete Anyway) is offered beside the safe one (Pull, then Push), in red, and only once the safe one has failed.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the force path is reached only from the safe command's failure result."
      },
      "reference": "Editora [`GitBranchCoordinator.offerAfterRejection`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/GitBranchCoordinator.java) (Force with Lease after a rejected push), `confirmForceDelete` (Delete Anyway after `NOT_FULLY_MERGED`)."
    },
    {
      "id": "CONF-12",
      "level": "SHOULD",
      "page": "templates/confirm-dialog",
      "pageTitle": "Confirm dialog",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/confirm-dialog/#conf-12",
      "text": "The question can be tested without a screen: its words come from pure code, and a capture hook answers the dialog, so a UI test never presses a native button.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a unit test covers the header and question for every kind, and UI tests set the capture answer."
      },
      "reference": "Torrenta [`RemoveConfirm.header`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/ui/RemoveConfirm.java), `question`, `answerForCapture`; [`RemoveConfirmTest`](https://github.com/adriandeleon/torrenta/blob/master/src/test/java/com/torrenta/ui/RemoveConfirmTest.java)."
    },
    {
      "id": "FIND-01",
      "level": "MUST",
      "page": "templates/find-bar",
      "pageTitle": "Find bar",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/find-bar/#find-01",
      "text": "Wherever there is text to search, the app has a find bar that is part of the window, never a popup.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the bar is a node in the window's scene graph (docked or floating); no `Popup` or `Stage` is created for it."
      },
      "reference": "Editora [`ui/FindReplaceBar.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/FindReplaceBar.java) (the editor's find and replace), with [`ui/ConsoleFindBar.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ConsoleFindBar.java) and [`ui/TerminalFindBar.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/TerminalFindBar.java) as the same shape over a console and a terminal; Termina [`ui/SearchBar.java`](https://github.com/adriandeleon/Termina/blob/master/src/main/java/com/termina/ui/SearchBar.java)."
    },
    {
      "id": "FIND-02",
      "level": "MUST",
      "page": "templates/find-bar",
      "pageTitle": "Find bar",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/find-bar/#find-02",
      "text": "The bar searches as you type and shows a match count.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the query field's text listener runs the search (debounced) and updates the count label."
      },
      "reference": "Editora [`FindReplaceBar`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/FindReplaceBar.java) (`debounce`, `find.count`); Termina [`SearchBar`](https://github.com/adriandeleon/Termina/blob/master/src/main/java/com/termina/ui/SearchBar.java) (`search.count`)."
    },
    {
      "id": "FIND-03",
      "level": "MUST",
      "page": "templates/find-bar",
      "pageTitle": "Find bar",
      "section": "Rules",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/find-bar/#find-03",
      "text": "A list app filters instead of finding, with the same field and the same Escape.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the list's filter field filters as it is typed, and Escape in it empties it or gives focus back to the list."
      },
      "reference": "Torrenta [`Omnibox`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/ui/Omnibox.java), [`FilterQuery`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/ui/FilterQuery.java), [`MainWindow.onOmniboxKey`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/ui/MainWindow.java)."
    },
    {
      "id": "FIND-04",
      "level": "SHOULD",
      "page": "templates/find-bar",
      "pageTitle": "Find bar",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/find-bar/#find-04",
      "text": "The find command (`find.show`) opens the bar: `C-s` in the Emacs keymap and `Ctrl/Cmd+F` in CUA, Sublime, VS Code and IntelliJ, with `F3` as well in CUA and Sublime. A terminal uses `Ctrl+Shift+F`, `Cmd+F` on macOS, since a plain `Ctrl+letter` belongs to the shell. The command while the bar is already open finds the next match (Editora) or puts the caret back in the field (Termina).",
      "why": null,
      "check": {
        "kind": "code",
        "text": "each bundled keymap binds that chord to the find command; the command steps when the bar is shown."
      },
      "reference": "Editora `keymaps/*.json`, [`MainController.findShowOrNext`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MainController.java); Termina [`TerminalWindow`](https://github.com/adriandeleon/Termina/blob/master/src/main/java/com/termina/ui/TerminalWindow.java) (`menu.find`, [`MenuAction.appChord`](https://github.com/adriandeleon/Termina/blob/master/src/main/java/com/termina/ui/MenuAction.java))."
    },
    {
      "id": "FIND-05",
      "level": "SHOULD",
      "page": "templates/find-bar",
      "pageTitle": "Find bar",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/find-bar/#find-05",
      "text": "Typing highlights every match and selects and scrolls to the first one at or after the caret. The anchor is the caret at open time, so refining the query does not run away down the document.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the search starts from an anchor saved when the bar opens, not from the current selection."
      },
      "reference": "Editora [`FindReplaceBar`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/FindReplaceBar.java) (`searchAnchor`, `recompute`)."
    },
    {
      "id": "FIND-06",
      "level": "MUST",
      "page": "templates/find-bar",
      "pageTitle": "Find bar",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/find-bar/#find-06",
      "text": "Enter steps to the next match and Shift+Enter to the previous one, wrapping around at the ends. In a terminal the directions are up and down the scrollback.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the query field's key handler steps forward on Enter and backward on Shift+Enter."
      },
      "reference": "Editora [`ConsoleFindBar`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/ConsoleFindBar.java), [`TerminalFindBar`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/TerminalFindBar.java); Termina [`SearchBar`](https://github.com/adriandeleon/Termina/blob/master/src/main/java/com/termina/ui/SearchBar.java). Editora's editor bar ([`FindReplaceBar`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/FindReplaceBar.java)) does not yet: its field steps forward on Enter, and back only with the previous button, `find.showBackward` (`C-r`, `Shift+F3`) or `find.previous`. Alt+Enter there turns every match into a caret."
    },
    {
      "id": "FIND-07",
      "level": "MUST",
      "page": "templates/find-bar",
      "pageTitle": "Find bar",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/find-bar/#find-07",
      "text": "Escape or the close button closes the bar: the highlights go, a search still pending is canceled so nothing moves after the bar is gone, and focus returns to the editor, the console or the shell.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the close path stops the debounces, cancels the running search, clears the highlights and focuses the text it searched."
      },
      "reference": "Editora [`FindReplaceBar.hideBar`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/FindReplaceBar.java)."
    },
    {
      "id": "FIND-08",
      "level": "SHOULD",
      "page": "templates/find-bar",
      "pageTitle": "Find bar",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/find-bar/#find-08",
      "text": "In a terminal, Escape is consumed in the field and never reaches the shell, and the terminal's own key and mouse filters leave every event aimed at the bar alone.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the field consumes Escape, and the terminal's filters return early for events from the bar."
      },
      "reference": "Termina [`SearchBar`](https://github.com/adriandeleon/Termina/blob/master/src/main/java/com/termina/ui/SearchBar.java), [`TerminalView.fromSearchBar`](https://github.com/adriandeleon/Termina/blob/master/src/main/java/com/termina/ui/TerminalView.java)."
    },
    {
      "id": "FIND-09",
      "level": "SHOULD",
      "page": "templates/find-bar",
      "pageTitle": "Find bar",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/find-bar/#find-09",
      "text": "The keymap's caret and editing chords (`C-a`, `C-e`, `C-k`, `C-y`, `Ctrl+V/X/C/Z`) act on the field, not on the document. Find's own chords stay global, so next, previous, replace and close work while the field has focus.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the find fields install the shared text-input keymap."
      },
      "reference": "Editora [`TextInputKeymap.installShared`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/command/TextInputKeymap.java); Termina's and Mirada's [`TextInputKeys`](https://github.com/adriandeleon/Mirada/blob/main/src/main/java/com/mirada/ui/TextInputKeys.java)."
    },
    {
      "id": "FIND-10",
      "level": "SHOULD",
      "page": "templates/find-bar",
      "pageTitle": "Find bar",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/find-bar/#find-10",
      "text": "Nothing found is one status-line message (\"Not found: x\") or the count \"No matches\". No beep, no dialog.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the no-match path sets `find.notFound` or `search.none` and opens nothing."
      },
      "reference": "Editora [`FindReplaceBar`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/FindReplaceBar.java) (`find.notFound`); Termina [`SearchBar`](https://github.com/adriandeleon/Termina/blob/master/src/main/java/com/termina/ui/SearchBar.java) (`search.none`)."
    },
    {
      "id": "FIND-11",
      "level": "SHOULD",
      "page": "templates/find-bar",
      "pageTitle": "Find bar",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/find-bar/#find-11",
      "text": "Replace keeps each match's case when *AB* (preserve case) is on.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a test replaces with preserve case on and finds each match's casing kept."
      },
      "reference": "Editora [`FindReplaceBarFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/FindReplaceBarFxTest.java) (`preserveCaseFollowsEachMatchesCasing`)."
    },
    {
      "id": "FIND-12",
      "level": "SHOULD",
      "page": "templates/find-bar",
      "pageTitle": "Find bar",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/find-bar/#find-12",
      "text": "A replacement that is too slow stops with \"Replace stopped: the pattern is too slow\" instead of hanging the window.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a catastrophic regex in Replace All aborts."
      },
      "reference": "Editora `find.replaceTimeout`, [`FindReplaceBarFxTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/FindReplaceBarFxTest.java) (`catastrophicRegexInReplaceAllAbortsInsteadOfHanging`)."
    },
    {
      "id": "FIND-13",
      "level": "SHOULD",
      "page": "templates/find-bar",
      "pageTitle": "Find bar",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/find-bar/#find-13",
      "text": "A list app's filter box filters the names as plain words are typed, turns `key:value` terms into chips and runs a command after `>`. `Ctrl+K` focuses it and is drawn in the box as a key badge.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the box's text listener filters, and its badge is read from the filter command's chord."
      },
      "reference": "Torrenta [`Omnibox`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/ui/Omnibox.java), [`MainWindow.buildFilterBar`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/ui/MainWindow.java)."
    },
    {
      "id": "FIND-14",
      "level": "SHOULD",
      "page": "templates/find-bar",
      "pageTitle": "Find bar",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/find-bar/#find-14",
      "text": "Escape in a filter box peels one layer: a box with something in it empties, an empty one gives the list back.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the box's Escape handler clears a non-empty box and otherwise focuses the list."
      },
      "reference": "Torrenta [`MainWindow.onOmniboxKey`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/ui/MainWindow.java)."
    },
    {
      "id": "FIND-15",
      "level": "SHOULD",
      "page": "templates/find-bar",
      "pageTitle": "Find bar",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/find-bar/#find-15",
      "text": "The filter box is out of the Tab order, so a fresh launch does not land every keystroke in it, and the window's own chords (undo, `Ctrl+Alt+1…9`) do not fire while a text field has focus: `Ctrl+Z` there is the field's own undo.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the box is not focus-traversable, and the window's chord handlers return early when the focus owner is a `TextInputControl`."
      },
      "reference": "Torrenta [`MainWindow.buildFilterBar`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/ui/MainWindow.java), [`MainWindow`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/ui/MainWindow.java) window chords."
    },
    {
      "id": "MLOG-02",
      "level": "SHOULD",
      "page": "templates/message-log",
      "pageTitle": "Message Log",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/message-log/#mlog-02",
      "text": "A click on the unread-error count opens the log too, and so does the `view.messageLog` command.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the unread-error count runs `view.messageLog` on a click, and the command is registered."
      },
      "reference": "Editora [`StatusBar`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/StatusBar.java) (`echo`, `unreadErrors`), [`StatusBar.showMessageLog`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/StatusBar.java)."
    },
    {
      "id": "MLOG-03",
      "level": "SHOULD",
      "page": "templates/message-log",
      "pageTitle": "Message Log",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/message-log/#mlog-03",
      "text": "`C-g` or a click outside closes the log too, as Esc does.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the card's key handler hides it on `C-g`; the overlay's backdrop hides it on a press."
      },
      "reference": "Editora [`MessageLogPopup`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MessageLogPopup.java), [`OverlayHost`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/OverlayHost.java)."
    },
    {
      "id": "MLOG-04",
      "level": "SHOULD",
      "page": "templates/message-log",
      "pageTitle": "Message Log",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/message-log/#mlog-04",
      "text": "`Ctrl+C` (`Cmd+C` on macOS) copies the selected entries.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the card's key handler copies the selection on the shortcut-down C."
      },
      "reference": "Editora [`MessageLogPopup.copySelection`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MessageLogPopup.java)."
    },
    {
      "id": "MLOG-05",
      "level": "SHOULD",
      "page": "templates/message-log",
      "pageTitle": "Message Log",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/message-log/#mlog-05",
      "text": "A message's severity comes from its key: a `status.*` key whose last segment contains `fail` or `error` is an error, one containing `cannot` or `invalid` a warning. Name new keys accordingly, or report through the error channel directly.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a severity test classifies keys by those rules."
      },
      "reference": "Editora [`ui/StatusSeverity.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/StatusSeverity.java) (`ofKey`), [`StatusSeverityTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/StatusSeverityTest.java)."
    },
    {
      "id": "MLOG-06",
      "level": "SHOULD",
      "page": "templates/message-log",
      "pageTitle": "Message Log",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/message-log/#mlog-06",
      "text": "Opening the log, or clearing it, resets the unread-error count.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "opening the log marks it read, and `clear` zeroes the count."
      },
      "reference": "Editora [`MessageLog.markRead`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MessageLog.java), [`MessageLog.clear`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/MessageLog.java), [`StatusBar.showMessageLog`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/StatusBar.java)."
    },
    {
      "id": "MLOG-07",
      "level": "SHOULD",
      "page": "templates/message-log",
      "pageTitle": "Message Log",
      "section": "Behavior",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/templates/message-log/#mlog-07",
      "text": "An unread error is never evicted silently: the count keeps it even when the entry drops off the end.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "an error pushed past the capacity still counts as unread."
      },
      "reference": "Editora [`MessageLogSeverityTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/ui/MessageLogSeverityTest.java) (`anEvictedErrorStillCounts`)."
    },
    {
      "id": "SYNC-01",
      "level": "SHOULD",
      "page": "templates/settings-sync",
      "pageTitle": "Settings Sync",
      "section": "Rules",
      "appliesTo": "an app with user data worth carrying between computers ([SYNC-01](https://pauta-project.dev/4.5.0/templates/settings-sync/#sync-01)).",
      "url": "https://pauta-project.dev/4.5.0/templates/settings-sync/#sync-01",
      "text": "An app with user data worth carrying between computers offers Settings Sync, on a page of its own in the Settings window that the Settings search finds by \"sync\".",
      "why": null,
      "check": {
        "kind": "by hand",
        "text": "open Settings, search \"sync\", and land on the Sync page."
      },
      "reference": "Editora [`ui/SettingsSync.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/SettingsSync.java) (the service) and [`ui/SettingsSyncPage.java`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/SettingsSyncPage.java), built by [`SettingsWindow`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/ui/SettingsWindow.java) (`Category.SYNC`)."
    },
    {
      "id": "SYNC-02",
      "level": "SHOULD",
      "page": "templates/settings-sync",
      "pageTitle": "Settings Sync",
      "section": "Rules",
      "appliesTo": "an app with user data worth carrying between computers ([SYNC-01](https://pauta-project.dev/4.5.0/templates/settings-sync/#sync-01)).",
      "url": "https://pauta-project.dev/4.5.0/templates/settings-sync/#sync-02",
      "text": "The store is a Git repository the user owns, reached through their own Git credentials (a credential helper or an SSH key), with no server or account of ours. Refusing a URL with a password or token in it is [SET-15](https://pauta-project.dev/4.5.0/settings/#set-15).",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the sync package runs `git` against the user's URL, with no server or account of the app's own."
      },
      "reference": "Editora [`sync/`](https://github.com/adriandeleon/Editora/tree/master/src/main/java/com/editora/sync) package ([`SyncEngine`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/sync/SyncEngine.java), [`SyncMerge`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/sync/SyncMerge.java), [`SyncAccount`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/sync/SyncAccount.java)), [`SyncEngine.hasCredentials`](https://github.com/adriandeleon/Editora/blob/master/src/main/java/com/editora/sync/SyncEngine.java); Termina carries the same package, Torrenta its own [`sync/`](https://github.com/adriandeleon/torrenta/tree/master/src/main/java/com/torrenta/sync) with [`SyncEngine`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/sync/SyncEngine.java) and [`SyncAccount`](https://github.com/adriandeleon/torrenta/blob/master/src/main/java/com/torrenta/sync/SyncAccount.java); the Spec table below."
    },
    {
      "id": "REL-01",
      "level": "MUST",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "Targets",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-01",
      "text": "jpackage builds the installers for the five targets in the table above, each on its own runner, through the Maven `dist` profile.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the release workflow's build matrix lists `linux-x64`, `linux-arm64`, `macos-arm64`, `macos-x64` and `windows-x64` on those runners, and `pom.xml` has a `dist` profile."
      },
      "reference": "Editora [`release.yml`](https://github.com/adriandeleon/Editora/blob/master/.github/workflows/release.yml) (the `build` job), [`pom.xml`](https://github.com/adriandeleon/Editora/blob/master/pom.xml) (`dist`)."
    },
    {
      "id": "REL-02",
      "level": "SHOULD",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "Targets",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-02",
      "text": "Downloads are named `<App>-<version>-<target>.<ext>`.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the release-asset check builds the expected names this way."
      },
      "reference": "Editora [`scripts/release/CheckRelease.java`](https://github.com/adriandeleon/Editora/blob/master/scripts/release/CheckRelease.java) (`expectedAssets`)."
    },
    {
      "id": "REL-03",
      "level": "MUST",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "Targets",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-03",
      "text": "**JReleaser** (`jreleaser.yml`) only creates the GitHub release: it builds nothing, and attaches every file and `checksums_sha256.txt`.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`jreleaser.yml` attaches the build matrix's files and runs after the build jobs."
      },
      "reference": "Editora [`jreleaser.yml`](https://github.com/adriandeleon/Editora/blob/master/jreleaser.yml), the `release` job in [`release.yml`](https://github.com/adriandeleon/Editora/blob/master/.github/workflows/release.yml)."
    },
    {
      "id": "REL-04",
      "level": "SHOULD",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "Targets",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-04",
      "text": "The release notes are the version's section of `CHANGELOG.md`.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the release job hands JReleaser that section as the changelog."
      },
      "reference": "Torrenta [`scripts/release/ReleaseNotes.java`](https://github.com/adriandeleon/torrenta/blob/master/scripts/release/ReleaseNotes.java). Editora's release notes are still its commit list."
    },
    {
      "id": "REL-05",
      "level": "MUST",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "Targets",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-05",
      "text": "The Maven version is the single source of truth: a tag `vX.Y.Z` releases the version in `pom.xml`.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the release workflow fails when the tag and the pom version differ."
      },
      "reference": "Editora's \"Check the tag against the pom version\" step in [`release.yml`](https://github.com/adriandeleon/Editora/blob/master/.github/workflows/release.yml)."
    },
    {
      "id": "REL-06",
      "level": "SHOULD",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "Targets",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-06",
      "text": "`master` carries a `-SNAPSHOT` version, and a post-release job opens the pull request that bumps it to the next snapshot.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the pom's version on `master` ends in `-SNAPSHOT`, and `release.yml` has the bump job."
      },
      "reference": "Editora's `bump` job in [`release.yml`](https://github.com/adriandeleon/Editora/blob/master/.github/workflows/release.yml)."
    },
    {
      "id": "REL-07",
      "level": "SHOULD",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "Targets",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-07",
      "text": "A **release-asset check** fails the run before publishing when an expected file is missing.",
      "why": "GitHub releases are immutable.",
      "check": {
        "kind": "code",
        "text": "a step before JReleaser compares the gathered files with the expected list."
      },
      "reference": "Editora's \"Verify the expected release assets\" step in [`release.yml`](https://github.com/adriandeleon/Editora/blob/master/.github/workflows/release.yml)."
    },
    {
      "id": "REL-08",
      "level": "SHOULD",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "Targets",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-08",
      "text": "On Linux, a `.desktop` file's `StartupWMClass` is the JavaFX app class.",
      "why": "the running window then belongs to the menu entry and shows its icon.",
      "check": {
        "kind": "code",
        "text": "`packaging/linux/<App>.desktop` sets `StartupWMClass=com.<app>.App`."
      },
      "reference": "Editora [`packaging/linux/Editora.desktop`](https://github.com/adriandeleon/Editora/blob/master/packaging/linux/Editora.desktop), Torrenta [`packaging/linux/Torrenta.desktop`](https://github.com/adriandeleon/torrenta/blob/master/packaging/linux/Torrenta.desktop)."
    },
    {
      "id": "REL-09",
      "level": "SHOULD",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "Targets",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-09",
      "text": "On Linux, AppStream metainfo has the id `io.github.adriandeleon.<App>`.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`packaging/linux/io.github.adriandeleon.<App>.metainfo.xml` carries that `<id>`."
      },
      "reference": "Torrenta [`packaging/linux/`](https://github.com/adriandeleon/torrenta/tree/master/packaging/linux). Editora's metainfo id (`com.editora.Editora`) predates the rule."
    },
    {
      "id": "REL-10",
      "level": "SHOULD",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "Targets",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-10",
      "text": "Packaging trains an **AOT cache** (JDK 25 Leyden) to cut start-up time; Linux legs run the training under `xvfb`.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the `dist` build runs a training launch with `-XX:AOTCacheOutput`, and the Linux release legs install `xvfb`."
      },
      "reference": "Editora [`scripts/aot_build.java`](https://github.com/adriandeleon/Editora/blob/master/scripts/aot_build.java)."
    },
    {
      "id": "REL-11",
      "level": "MUST",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "Install methods",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-11",
      "text": "The GitHub release offers every download on every platform: the `.dmg`, `.msi`, `.deb`, `.rpm`, `.AppImage` and `.tar.gz`, with checksums.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`jreleaser.yml` attaches each of these types."
      },
      "reference": "Editora [`jreleaser.yml`](https://github.com/adriandeleon/Editora/blob/master/jreleaser.yml)."
    },
    {
      "id": "REL-12",
      "level": "SHOULD",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "Install methods",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-12",
      "text": "On macOS (Apple Silicon) the app installs with `brew install --cask adriandeleon/tap/<app>`: JReleaser's `brew` packager writes the cask to [`adriandeleon/homebrew-tap`](https://github.com/adriandeleon/homebrew-tap). A cask takes exactly one artifact, so it serves Apple Silicon, and Intel Macs use the `macos-x64` DMG.",
      "why": "the official homebrew-cask repository has notability rules a new project does not meet, so the family shares one personal tap.",
      "check": {
        "kind": "code",
        "text": "`jreleaser.yml` has a `brew` packager for that tap; `jreleaser package --basedir .` writes the cask locally, to check it without releasing."
      },
      "reference": "Torrenta and Termina `jreleaser.yml`; Editora has no packager yet."
    },
    {
      "id": "REL-13",
      "level": "SHOULD",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "Install methods",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-13",
      "text": "On Windows x64 the app installs with `winget install AdrianDeLeon.<App>`: JReleaser's `winget` packager opens a pull request on [`microsoft/winget-pkgs`](https://github.com/microsoft/winget-pkgs) from the `adriandeleon` fork. The package identifier is `AdrianDeLeon.<App>`, the moniker the app's lower-case name.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`jreleaser.yml` has a `winget` packager with that identifier; `jreleaser package --basedir .` writes the manifests locally."
      },
      "reference": "Torrenta and Termina `jreleaser.yml`; Editora has no packager yet."
    },
    {
      "id": "REL-14",
      "level": "SHOULD",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "Install methods",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-14",
      "text": "Both packagers read a `PACKAGES_TOKEN` secret, a classic personal access token with `repo` scope. Without it JReleaser skips both, and the GitHub release still publishes.",
      "why": "the workflow's own token cannot write to the tap or open a pull request on the fork.",
      "check": {
        "kind": "code",
        "text": "`release.yml` passes `PACKAGES_TOKEN` to JReleaser and leaves the packagers out when it is empty."
      },
      "reference": "Torrenta and Termina `release.yml`."
    },
    {
      "id": "REL-15",
      "level": "MUST",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "Signing",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-15",
      "text": "The macOS `.dmg` is signed with the Developer ID Application certificate (team 8JKSF797L8), with the hardened runtime and per-app entitlements, notarized with `notarytool`, stapled and checked with `spctl`; then the notarized app is launched once.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`release.yml` imports `MACOS_CERT_P12` and `MACOS_CERT_PASSWORD`, notarizes with `APPLE_API_KEY_P8`, `APPLE_API_KEY_ID` and `APPLE_API_ISSUER`, staples, runs `spctl` and launches the app."
      },
      "reference": "Editora's \"Import signing certificate (macOS)\" and \"Notarize DMG (macOS)\" steps in [`release.yml`](https://github.com/adriandeleon/Editora/blob/master/.github/workflows/release.yml), [`packaging/macos/Editora.entitlements`](https://github.com/adriandeleon/Editora/blob/master/packaging/macos/Editora.entitlements). Done in all six apps."
    },
    {
      "id": "REL-16",
      "level": "MUST",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "Signing",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-16",
      "text": "Linux downloads are signed with the one shared OpenPGP release key (\"Adrian De Leon (release signing)\") in a separate `sign-linux` job: `rpmsign` for the `.rpm`, a debsigs origin signature for the `.deb`, and an armored `.asc` beside every file. The public key is committed as `packaging/linux/signing-key.asc` and attached to each release.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`release.yml` has a `sign-linux` job that reads `LINUX_GPG_KEY` and `LINUX_GPG_PASSPHRASE` and runs the shared scripts, and `packaging/linux/signing-key.asc` exists."
      },
      "reference": "Editora [`scripts/release/sign-linux-packages.sh`](https://github.com/adriandeleon/Editora/blob/master/scripts/release/sign-linux-packages.sh), [`scripts/release/check-linux-signatures.sh`](https://github.com/adriandeleon/Editora/blob/master/scripts/release/check-linux-signatures.sh). Done in Editora, Torrenta, Termina and Modula; Mirada partly; nux not yet."
    },
    {
      "id": "REL-17",
      "level": "SHOULD",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "Signing",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-17",
      "text": "The Windows `.msi` is signed with Authenticode, once the certificate is chosen.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the Windows leg signs the `.msi` before it is uploaded."
      },
      "reference": "no app yet. **Open decision**: SignPath Foundation (free for OSS), a Certum Open Source certificate, or Azure Trusted Signing. Until then MSIs are unsigned and SmartScreen warns."
    },
    {
      "id": "REL-18",
      "level": "MUST",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "Signing",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-18",
      "text": "Every download has a GitHub **build provenance attestation** (`actions/attest-build-provenance`), which `gh attestation verify` checks.",
      "why": null,
      "check": {
        "kind": "test",
        "text": "a test keeps the attested files and the files JReleaser attaches the same list."
      },
      "reference": "Editora's \"Attest build provenance\" step in [`release.yml`](https://github.com/adriandeleon/Editora/blob/master/.github/workflows/release.yml), [`ReleaseSupplyChainTest`](https://github.com/adriandeleon/Editora/blob/master/src/test/java/com/editora/packaging/ReleaseSupplyChainTest.java). Done in Editora, Termina and Mirada."
    },
    {
      "id": "REL-19",
      "level": "MUST",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "CI/CD (GitHub Actions)",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-19",
      "text": "`ci.yml` runs on every push to `master` and every pull request: **Format** (`spotless:check`) and **Build & Test** (`./mvnw verify`, coverage gate included) on JDK 25. Both are required status checks for `master`.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`ci.yml` triggers on `push` to `master` and on `pull_request`, with the two jobs; the repository's rules for `master` require both."
      },
      "reference": "Editora [`ci.yml`](https://github.com/adriandeleon/Editora/blob/master/.github/workflows/ci.yml)."
    },
    {
      "id": "REL-20",
      "level": "SHOULD",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "CI/CD (GitHub Actions)",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-20",
      "text": "The tests run on all three OSes: the pure suite (no JavaFX toolkit) on Linux, macOS and Windows, and the FX suite on Linux and at least one more. `ci.yml` covers Linux on every pull request; `full-tests.yml` covers the rest daily, on a pull request labeled `full-ci`, and before every release, and lists flaky tests in the job summary.",
      "why": "path separators, line endings, case-insensitive file systems and process spawning fail on one OS only, and the pure suite is where they show; the FX suite catches layout and focus differences.",
      "check": {
        "kind": "code",
        "text": "`full-tests.yml`'s jobs run the pure suite on `windows-*` and `macos-*` and the FX suite (`-Dgroups=fx`) on at least one of them; it has a `schedule` and a `pull_request` trigger gated on the label, and the release preflight waits for its run on the tagged commit."
      },
      "reference": "Editora [`full-tests.yml`](https://github.com/adriandeleon/Editora/blob/master/.github/workflows/full-tests.yml) (the pure suite on Windows and macOS, the FX suite on macOS in three shards), [`scripts/ci/ReportFlakes.java`](https://github.com/adriandeleon/Editora/blob/master/scripts/ci/ReportFlakes.java), and the \"Check that the Full tests passed on this commit\" step in [`release.yml`](https://github.com/adriandeleon/Editora/blob/master/.github/workflows/release.yml)."
    },
    {
      "id": "REL-21",
      "level": "MUST",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "CI/CD (GitHub Actions)",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-21",
      "text": "`release.yml` runs on a version tag (`v*`, or better the version-shaped `v[0-9]+.[0-9]+.[0-9]+*`, which a tag like `vendor-import` doesn't match) that matches the pom version, with `workflow_dispatch` as a dry run. It runs the five-target matrix, the signing jobs, attestations, the release-asset check, JReleaser, then the bump to the next snapshot. A dry run builds and signs and publishes nothing.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`release.yml` triggers on the tag pattern and `workflow_dispatch`, and a dispatch runs JReleaser with `--dry-run`."
      },
      "reference": "Editora [`release.yml`](https://github.com/adriandeleon/Editora/blob/master/.github/workflows/release.yml)."
    },
    {
      "id": "REL-22",
      "level": "MUST",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "CI/CD (GitHub Actions)",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-22",
      "text": "Every workflow pins each third-party action to a commit SHA, with its version in a comment (`actions/setup-java@b843ebf… # v6.1.0`).",
      "why": null,
      "check": {
        "kind": "code",
        "text": "every `uses:` in `.github/workflows/` ends in a 40-character SHA and a comment naming its version (`# vX.Y.Z`), or its branch when the action publishes no tag (Editora's `jreleaser/release-action … # v2`)."
      },
      "reference": "Editora [`.github/workflows/`](https://github.com/adriandeleon/Editora/tree/master/.github/workflows)."
    },
    {
      "id": "REL-23",
      "level": "MUST",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "CI/CD (GitHub Actions)",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-23",
      "text": "Dependabot updates `github-actions` and `maven` weekly.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`.github/dependabot.yml` lists both ecosystems with `interval: weekly`."
      },
      "reference": "Editora [`.github/dependabot.yml`](https://github.com/adriandeleon/Editora/blob/master/.github/dependabot.yml)."
    },
    {
      "id": "REL-24",
      "level": "MUST",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "CI/CD (GitHub Actions)",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-24",
      "text": "Every workflow starts from `permissions: contents: read`; only a job that needs write access asks for it, in its own block.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "each workflow's top-level `permissions` is `contents: read`, and every `write` sits in a job's own `permissions`."
      },
      "reference": "Editora [`release.yml`](https://github.com/adriandeleon/Editora/blob/master/.github/workflows/release.yml): `release` (publish), `bump` (the pull request) and `preflight` (start a Full tests run)."
    },
    {
      "id": "REL-25",
      "level": "SHOULD",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "CI/CD (GitHub Actions)",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-25",
      "text": "Every workflow sets up JDK 25 with `actions/setup-java` and `cache: maven`.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "each `setup-java` step has `java-version: '25'` and `cache: maven`."
      },
      "reference": "Editora uses Temurin in [`ci.yml`](https://github.com/adriandeleon/Editora/blob/master/.github/workflows/ci.yml) and [`full-tests.yml`](https://github.com/adriandeleon/Editora/blob/master/.github/workflows/full-tests.yml), and Liberica for the release build, for linux-aarch64 coverage."
    },
    {
      "id": "REL-26",
      "level": "MUST",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "CI/CD (GitHub Actions)",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-26",
      "text": "Every job has `timeout-minutes`, and `concurrency` cancels a superseded pull-request run, never a run on `master`.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "every job sets `timeout-minutes`; `cancel-in-progress` is true only for `pull_request` events."
      },
      "reference": "Editora [`ci.yml`](https://github.com/adriandeleon/Editora/blob/master/.github/workflows/ci.yml) (`cancel-in-progress: ${{ github.event_name == 'pull_request' }}`)."
    },
    {
      "id": "REL-27",
      "level": "MUST",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "CI/CD (GitHub Actions)",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-27",
      "text": "CI uploads the surefire reports even when tests fail, and the JaCoCo report; it writes the coverage totals to the job summary.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "the test reports upload under `if: always()`, and a step appends the totals to `$GITHUB_STEP_SUMMARY`."
      },
      "reference": "Editora's \"Upload test reports and coverage data\" and \"Summarise coverage\" steps in [`ci.yml`](https://github.com/adriandeleon/Editora/blob/master/.github/workflows/ci.yml)."
    },
    {
      "id": "REL-28",
      "level": "MUST",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "CI/CD (GitHub Actions)",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-28",
      "text": "Signing skips cleanly when the secrets are absent (forks, dry runs), so they still build; a tag without them fails.",
      "why": null,
      "check": {
        "kind": "code",
        "text": "each signing step checks its secrets first, skips without them, and fails on a tag push."
      },
      "reference": "Editora's \"Import signing certificate (macOS)\" step checks `MACOS_CERT_P12` first."
    },
    {
      "id": "REL-29",
      "level": "MUST",
      "page": "release",
      "pageTitle": "Packaging, signing and release",
      "section": "CI/CD (GitHub Actions)",
      "appliesTo": null,
      "url": "https://pauta-project.dev/4.5.0/release/#rel-29",
      "text": "The packaged app is launched once on each OS before a release (a smoke test).",
      "why": null,
      "check": {
        "kind": "code",
        "text": "`release.yml` runs the packaged launcher on every target before JReleaser."
      },
      "reference": "Torrenta's \"Smoke-test the packaged app\" step runs the launcher in every target's image. Editora runs only the notarized macOS app (`--version`, `--check-terminal`)."
    }
  ],
  "retired": [
    {
      "id": "ICON-03",
      "edition": "3.0.0",
      "see": "ICON-09",
      "seeUrl": "https://pauta-project.dev/4.5.0/icons-and-color/#icon-09"
    },
    {
      "id": "KBD-19",
      "edition": "3.0.0",
      "see": "ICON-09",
      "seeUrl": "https://pauta-project.dev/4.5.0/icons-and-color/#icon-09"
    },
    {
      "id": "ICON-22",
      "edition": "4.0.0",
      "see": "MENU-14",
      "seeUrl": "https://pauta-project.dev/4.5.0/menus/#menu-14"
    },
    {
      "id": "TBAR-11",
      "edition": "4.0.0",
      "see": "MENU-16",
      "seeUrl": "https://pauta-project.dev/4.5.0/menus/#menu-16"
    },
    {
      "id": "PLAT-07",
      "edition": "4.3.0",
      "see": "ICON-02",
      "seeUrl": "https://pauta-project.dev/4.5.0/icons-and-color/#icon-02"
    },
    {
      "id": "QUAL-01",
      "edition": "4.3.0",
      "see": "PLAT-09",
      "seeUrl": "https://pauta-project.dev/4.5.0/platform/#plat-09"
    },
    {
      "id": "QUAL-12",
      "edition": "4.3.0",
      "see": "INTL-08",
      "seeUrl": "https://pauta-project.dev/4.5.0/i18n/#intl-08"
    },
    {
      "id": "QUAL-14",
      "edition": "4.3.0",
      "see": "ICON-14",
      "seeUrl": "https://pauta-project.dev/4.5.0/icons-and-color/#icon-14"
    },
    {
      "id": "DOCS-19",
      "edition": "4.3.0",
      "see": "REPO-01",
      "seeUrl": "https://pauta-project.dev/4.5.0/repository/#repo-01"
    },
    {
      "id": "KBD-08",
      "edition": "4.3.0",
      "see": "QOPEN-01",
      "seeUrl": "https://pauta-project.dev/4.5.0/templates/quick-open/#qopen-01"
    },
    {
      "id": "KBD-17",
      "edition": "4.3.0",
      "see": "TBAR-01",
      "seeUrl": "https://pauta-project.dev/4.5.0/toolbars-and-tooltips/#tbar-01"
    },
    {
      "id": "KBD-20",
      "edition": "4.3.0",
      "see": "INTL-04",
      "seeUrl": "https://pauta-project.dev/4.5.0/i18n/#intl-04"
    },
    {
      "id": "WIN-02",
      "edition": "4.3.0",
      "see": "ICON-16",
      "seeUrl": "https://pauta-project.dev/4.5.0/icons-and-color/#icon-16"
    },
    {
      "id": "WIN-05",
      "edition": "4.3.0",
      "see": "CONF-01",
      "seeUrl": "https://pauta-project.dev/4.5.0/templates/confirm-dialog/#conf-01"
    },
    {
      "id": "WIN-06",
      "edition": "4.3.0",
      "see": "WELC-01",
      "seeUrl": "https://pauta-project.dev/4.5.0/templates/welcome/#welc-01"
    },
    {
      "id": "WIN-07",
      "edition": "4.3.0",
      "see": "ABOUT-02",
      "seeUrl": "https://pauta-project.dev/4.5.0/templates/about/#about-02"
    },
    {
      "id": "ICON-21",
      "edition": "4.3.0",
      "see": "TBAR-01",
      "seeUrl": "https://pauta-project.dev/4.5.0/toolbars-and-tooltips/#tbar-01"
    },
    {
      "id": "SET-17",
      "edition": "4.3.0",
      "see": "SYNC-01",
      "seeUrl": "https://pauta-project.dev/4.5.0/templates/settings-sync/#sync-01"
    },
    {
      "id": "PAL-03",
      "edition": "4.3.0",
      "see": "KBD-07",
      "seeUrl": "https://pauta-project.dev/4.5.0/keyboard/#kbd-07"
    },
    {
      "id": "MLOG-01",
      "edition": "4.3.0",
      "see": "DIAG-01",
      "seeUrl": "https://pauta-project.dev/4.5.0/diagnostics/#diag-01"
    }
  ]
}
