@azure-id/orc 1.6.0 → 1.7.1

package/bin/webui/fixtures/wiki-one.js

@@ -0,0 +1,198 @@
+"use strict";
+/**
+ * fixtures/wiki-one.js — the wiki's one-doc-at-a-time probes.
+ *
+ * CAPTURED FROM THE REAL CLI against a throwaway two-doc wiki with one
+ * undocumented area, then the paths rewritten. Three payloads, because the
+ * three verdicts are three different cards and only one of them is reachable
+ * on any given repo:
+ *
+ *   wikiResolveNew        nothing covers it — with a proposed scope
+ *   wikiResolveMatch      one doc clearly does — routes to an update
+ *   wikiResolveAmbiguous  two cover it about equally — a QUESTION, never a
+ *                         guess, and the card offers no command until a human
+ *                         picks one
+ *
+ * `wikiRefs` carries a RESERVED row and three behind surfaces, because a sweep
+ * where everything is clean renders six identical green lines and teaches
+ * nothing about the state it exists to show.
+ */
+
+module.exports.wikiResolveNew = {
+  "ok": true,
+  "topic": "remittance",
+  "terms": [
+    "remittance"
+  ],
+  "verdict": "new",
+  "match": null,
+  "candidates": [],
+  "suggested_slug": "remittance",
+  "suggested_covers": [
+    {
+      "glob": "src/remittance/**",
+      "matches": 3
+    }
+  ],
+  "next": "/orc-wiki add \"remittance\"",
+  "note": "the suggested covers are a STARTING POINT derived from path names, never an answer — the user corrects them before anything is scanned."
+};
+
+module.exports.wikiResolveMatch = {
+  "ok": true,
+  "topic": "login session",
+  "terms": [
+    "login",
+    "session"
+  ],
+  "verdict": "match",
+  "match": {
+    "file": "wiki/orc-feature-auth-overview.md",
+    "area": "auth",
+    "title": "auth Overview",
+    "keywords": [
+      "login",
+      "session",
+      "token"
+    ],
+    "covers": [
+      "src/auth/**"
+    ],
+    "score": 8,
+    "why": [
+      "login in keywords",
+      "session in keywords"
+    ]
+  },
+  "candidates": [
+    {
+      "file": "wiki/orc-feature-auth-overview.md",
+      "area": "auth",
+      "title": "auth Overview",
+      "keywords": [
+        "login",
+        "session",
+        "token"
+      ],
+      "covers": [
+        "src/auth/**"
+      ],
+      "score": 8,
+      "why": [
+        "login in keywords",
+        "session in keywords"
+      ]
+    }
+  ],
+  "suggested_slug": "login-session",
+  "suggested_covers": [],
+  "next": "/orc-wiki update wiki/orc-feature-auth-overview.md",
+  "note": "the suggested covers are a STARTING POINT derived from path names, never an answer — the user corrects them before anything is scanned."
+};
+
+module.exports.wikiRefs = {
+  "ok": true,
+  "mode": "check",
+  "registration": "drifted",
+  "items": [
+    {
+      "id": "registration",
+      "state": "drifted",
+      "what": "registration is DRIFTED",
+      "fix": "orc wiki sync",
+      "cost": "free"
+    },
+    {
+      "id": "reserved",
+      "state": "outstanding",
+      "what": "1 reserved row with no scan behind it: wiki/orc-feature-remittance-overview.md",
+      "fix": "/orc-wiki update wiki/orc-feature-remittance-overview.md",
+      "cost": "money"
+    },
+    {
+      "id": "orientation",
+      "state": "missing",
+      "what": "wiki/orc-orientation.md does not exist — it is the page every consumer reads first",
+      "fix": "/orc-wiki refresh wiki/orc-orientation.md",
+      "cost": "free"
+    },
+    {
+      "id": "architecture",
+      "state": "absent",
+      "what": "no architecture overview — optional, and a small wiki may not need one",
+      "fix": null,
+      "cost": "free"
+    },
+    {
+      "id": "claude-md",
+      "state": "missing",
+      "what": "no CLAUDE.md — future sessions are never told the wiki exists",
+      "fix": "/orc-wiki (the pointer-injection step)",
+      "cost": "free"
+    },
+    {
+      "id": "crosslink",
+      "state": "clean",
+      "what": "every crosslink tag's anchor still exists",
+      "fix": null,
+      "cost": "free"
+    }
+  ],
+  "open": [
+    "registration",
+    "reserved",
+    "orientation",
+    "claude-md"
+  ],
+  "repaired": [],
+  "clean": false,
+  "note": "only registration is repaired here, because `orc wiki sync` is free and already the single writer of wiki-meta.json and INDEX.md. Everything else is REPORTED with its command — a sweep that silently regenerated prose would be spending money nobody asked it to spend."
+};
+
+module.exports.wikiResolveAmbiguous = {
+  "ok": true,
+  "topic": "invoice",
+  "terms": [
+    "invoice"
+  ],
+  "verdict": "ambiguous",
+  "match": null,
+  "candidates": [
+    {
+      "file": "wiki/orc-feature-billing-overview.md",
+      "area": "billing",
+      "title": "billing Overview",
+      "keywords": [
+        "invoice",
+        "charge"
+      ],
+      "covers": [
+        "src/billing/**"
+      ],
+      "score": 4,
+      "why": [
+        "invoice in keywords"
+      ]
+    },
+    {
+      "file": "wiki/orc-feature-payments-overview.md",
+      "area": "payments",
+      "title": "payments Overview",
+      "keywords": [
+        "invoice",
+        "refund"
+      ],
+      "covers": [
+        "src/billing/**"
+      ],
+      "score": 4,
+      "why": [
+        "invoice in keywords"
+      ]
+    }
+  ],
+  "suggested_slug": "login-session",
+  "suggested_covers": [],
+  "next": "ask which doc this belongs to — two or more cover it about equally",
+  "note": "the suggested covers are a STARTING POINT derived from path names, never an answer — the user corrects them before anything is scanned."
+};

package/bin/webui/i18n/en/knowledge.json

@@ -1,141 +1,151 @@
 {
-  "knowledge.title": "Knowledge",
-  "knowledge.sub": "What ORC already knows about this repo: the wiki, cached code-patterns, and repair memory.",
-  "knowledge.wiki": "Wiki",
-  "knowledge.wiki.none": "No wiki yet.",
-  "knowledge.wiki.noneHint": "Run /orc-wiki in Claude Code to build one. This panel never scans — that costs a model.",
-  "knowledge.wiki.unregistered": "The wiki is {state} — nothing can read it until it is registered.",
-  "knowledge.wiki.syncHint": "`orc wiki sync` fixes this instantly: registration is derived from the docs, so it is free and never a re-scan.",
-  "knowledge.wiki.freshNote": "Freshness is coverage-relative: a doc is stale only when commits since its OWN anchor touched files IT covers.",
-  "knowledge.wiki.why": "why: {reason}",
-  "knowledge.impact.title": "Refresh scope (orc wiki impact)",
-  "knowledge.impact.counts": "{registered} registered · {touched} touched · {structural} structural · {pct}% affected (threshold {threshold}%)",
+  "knowledge.archive.empty": "Nothing has been archived yet.",
+  "knowledge.archive.load": "Show the archive",
+  "knowledge.archive.note": "Nothing is ever deleted here. Entries pushed out by the limit are moved, and they keep their id forever.",
+  "knowledge.archive.title": "Archive",
+  "knowledge.blind.none": "Nothing changed that no doc covers.",
+  "knowledge.blind.note": "These files changed and no doc claims them. That is a gap in what is written down, not rot in what already exists — so it never makes the wiki stale on its own.",
+  "knowledge.blind.title": "Changed, and no doc covers it",
+  "knowledge.coverage.col.dir": "Folder",
+  "knowledge.coverage.col.files": "Files",
+  "knowledge.coverage.col.last": "Last touched",
+  "knowledge.coverage.na": "Cannot be measured here.",
+  "knowledge.coverage.naHint": "It needs a registered wiki and a git repository.",
+  "knowledge.coverage.notATarget": "This is a report, not a target. There is no threshold, nothing anywhere reacts to it, and a repo that deliberately writes about four subsystems out of forty is not broken.",
+  "knowledge.coverage.sub": "{covered} of {tracked} tracked files are covered by at least one doc",
+  "knowledge.coverage.title": "How much of the code is written about",
+  "knowledge.coverage.uncovered": "Not covered",
+  "knowledge.coverage.uncoveredNote": "Grouped by folder and biggest first, because \"240 files, all in vendor\" and \"12 files, all in payments\" are opposite situations.",
+  "knowledge.debt.none": "No refresh owed.",
+  "knowledge.debt.nothingBroken": "Nothing is broken. These pages are behind, not wrong - and clearing the top of the list is far cheaper than a full re-scan.",
+  "knowledge.debt.oldest": "oldest 1 commit behind",
+  "knowledge.debt.oldestPlural": "oldest {n} commits behind",
+  "knowledge.debt.pending": "1 page pending",
+  "knowledge.debt.pendingPlural": "{n} pages pending",
+  "knowledge.docs.col.covers": "Covers",
+  "knowledge.docs.col.distance": "Behind",
+  "knowledge.docs.col.doc": "Doc",
+  "knowledge.docs.col.tags": "Tags",
+  "knowledge.docs.col.tier": "State",
+  "knowledge.docs.col.used": "Used",
+  "knowledge.docs.field.coveredFiles": "Files it names",
+  "knowledge.docs.field.covers": "Covers",
+  "knowledge.docs.field.lastUsed": "Last used",
+  "knowledge.docs.field.scanned": "Scanned at commit",
+  "knowledge.docs.field.title": "Title",
+  "knowledge.docs.field.type": "Type",
+  "knowledge.docs.none": "Nothing registered.",
+  "knowledge.docs.noneHint": "Docs on disk have to be registered before anything can read them, and registering is free and instant.",
+  "knowledge.docs.note": "Every registered doc, in the order the CLI returned them. Open a row to see what it covers and what it was scanned against. Each distance is measured against that doc's own files, so a doc about payments does not age because the README changed.",
+  "knowledge.docs.title": "What is in the wiki",
+  "knowledge.field.anchor": "anchor",
+  "knowledge.field.blind": "structural blind spots",
+  "knowledge.field.distance": "distance",
+  "knowledge.field.distanceValue": "{n} commits on the worst doc's covered files",
+  "knowledge.field.docs": "docs",
+  "knowledge.field.edges": "edges",
+  "knowledge.field.lastScan": "last scan",
+  "knowledge.field.tags": "crosslink tags",
+  "knowledge.field.unmeasurable": "unmeasurable",
+  "knowledge.field.worst": "Oldest doc (this is what sets the tier)",
+  "knowledge.gotchas.headroom": "{n} of {max} kept",
+  "knowledge.gotchas.none": "Nothing recorded yet.",
+  "knowledge.gotchas.noneHint": "A repair loop that goes red → green writes the first one.",
+  "knowledge.gotchas.note": "One entry per project-specific failure a repair already solved. Pruning ARCHIVES the low-value tail — it never deletes.",
+  "knowledge.gotchas.preview": "Show what would be archived",
+  "knowledge.gotchas.prune": "Prune to gotchas_max",
+  "knowledge.gotchas.pruneNone": "Nothing would be archived — you are under the limit.",
+  "knowledge.gotchas.pruneWould": "{n} entry(ies) would be moved to the archive:",
+  "knowledge.gotchas.title": "Repair memory (gotchas)",
   "knowledge.impact.blind": "Structural blind spot — changed files no doc covers:",
+  "knowledge.impact.col.detail": "Detail",
   "knowledge.impact.col.doc": "Doc",
   "knowledge.impact.col.state": "State",
-  "knowledge.impact.col.detail": "Detail",
-  "knowledge.patterns.title": "Code patterns",
-  "knowledge.patterns.note": "Reconciled per-language conventions, injected literally into executor slices. Project conventions win; security and correctness invariants are always kept.",
+  "knowledge.impact.counts": "{registered} registered · {touched} touched · {structural} structural · {pct}% affected (threshold {threshold}%)",
+  "knowledge.impact.title": "Refresh scope (orc wiki impact)",
+  "knowledge.one.cannot": "Could not resolve that topic.",
+  "knowledge.one.files": "1 file",
+  "knowledge.one.filesPlural": "{n} files",
+  "knowledge.one.lead": "Update one doc, or add one topic, without re-planning a single other area. Both probes below are free and neither scans anything. The refresh or the add that follows is a lane, so it is a command to copy rather than a button.",
+  "knowledge.one.next": "Run this in Claude Code. It costs model tokens, so nothing here starts it for you.",
+  "knowledge.one.placeholder": "A topic, in your own words — \"the remittance feature\"",
+  "knowledge.one.proposed": "A starting point, from path names only. Correct it before anything is scanned.",
+  "knowledge.one.resolve": "Is it in the wiki?",
+  "knowledge.one.sweep": "Derived references, checked",
+  "knowledge.one.title": "One doc at a time",
+  "knowledge.orientation.missing": "No orientation doc. Every reader opens it first, so this one is worth having — and regenerating it is free.",
+  "knowledge.orientation.present": "Orientation doc present: {file}. Every reader opens it first.",
+  "knowledge.patterns.conflicts": "Where the project and the playbook disagree",
+  "knowledge.patterns.field.codified": "Written on",
+  "knowledge.patterns.field.counts": "Conventions · invariants",
+  "knowledge.patterns.field.playbook": "Playbook it was reconciled against",
+  "knowledge.patterns.field.size": "Lines · bytes",
+  "knowledge.patterns.field.source": "From commit",
+  "knowledge.patterns.inspect": "What is in it",
+  "knowledge.patterns.known": "Known language keys: {list}",
+  "knowledge.patterns.literalNote": "This exact text is put in front of every agent that writes code here. If you cannot read it, you cannot trust it.",
   "knowledge.patterns.none": "No cached patterns.",
   "knowledge.patterns.noneHint": "Run /orc-pattern in Claude Code to codify one. Codifying costs a model, so this panel never does it.",
-  "knowledge.patterns.known": "Known language keys: {list}",
-  "knowledge.gotchas.title": "Repair memory (gotchas)",
-  "knowledge.gotchas.note": "One entry per project-specific failure a repair already solved. Pruning ARCHIVES the low-value tail — it never deletes.",
-  "knowledge.gotchas.none": "Nothing recorded yet.",
-  "knowledge.gotchas.noneHint": "A repair loop that goes red → green writes the first one.",
-  "knowledge.gotchas.prune": "Prune to gotchas_max",
-  "knowledge.field.docs": "docs",
-  "knowledge.field.lastScan": "last scan",
-  "knowledge.field.distance": "distance",
-  "knowledge.field.distanceValue": "{n} commits on the worst doc's covered files",
-  "knowledge.field.unmeasurable": "unmeasurable",
-  "knowledge.field.anchor": "anchor",
-  "knowledge.field.edges": "edges",
-  "knowledge.field.tags": "crosslink tags",
-  "knowledge.field.blind": "structural blind spots",
+  "knowledge.patterns.note": "Reconciled per-language conventions, injected literally into executor slices. Project conventions win; security and correctness invariants are always kept.",
+  "knowledge.patterns.paidWhy": "Learning a language's conventions reads a lot of your code, so it costs model tokens — a command to copy, not a button.",
+  "knowledge.patterns.title": "Code patterns",
+  "knowledge.patterns.unheadered": "This file has no readable header, so there is no date to show. A date is never guessed from when the file was last saved.",
+  "knowledge.peers.col.repo": "Repo",
+  "knowledge.peers.col.state": "State",
+  "knowledge.peers.col.tags": "Tags it offers",
+  "knowledge.peers.col.tier": "Freshness",
+  "knowledge.peers.none": "No repos are linked yet.",
+  "knowledge.peers.note": "Linked repos, read-only. Every word here is what the other repo reported — this side never recalculates it. Editing the links happens on Crosslink; there is one picture of the boundary, and it lives there.",
+  "knowledge.peers.open": "Open Crosslink",
+  "knowledge.peers.title": "What ORC knows from next door",
   "knowledge.plan": "Refresh plan",
-  "knowledge.plan.na": "Nothing to plan",
-  "knowledge.plan.naHint": "Build a wiki first, or register the pages already on disk - both are free.",
   "knowledge.plan.clean": "Every page still covers the current code. Nothing to refresh.",
-  "knowledge.debt.pending": "1 page pending",
-  "knowledge.debt.pendingPlural": "{n} pages pending",
-  "knowledge.debt.oldest": "oldest 1 commit behind",
-  "knowledge.debt.oldestPlural": "oldest {n} commits behind",
-  "knowledge.debt.nothingBroken": "Nothing is broken. These pages are behind, not wrong - and clearing the top of the list is far cheaper than a full re-scan.",
-  "knowledge.debt.none": "No refresh owed.",
-  "knowledge.plan.freeFirst": "Free repairs first - never pay for something a free step fixes",
-  "knowledge.plan.free": "free",
+  "knowledge.plan.col.delta": "changed",
   "knowledge.plan.col.doc": "page",
   "knowledge.plan.col.state": "state",
-  "knowledge.plan.col.delta": "changed",
-  "knowledge.plan.col.used": "used",
   "knowledge.plan.col.tier": "scan",
   "knowledge.plan.col.tokens": "est. tokens",
   "knowledge.plan.col.usd": "est. $",
+  "knowledge.plan.col.used": "used",
+  "knowledge.plan.free": "free",
+  "knowledge.plan.freeFirst": "Free repairs first - never pay for something a free step fixes",
   "knowledge.plan.gone": "A file this page documents is gone: {files}",
-  "knowledge.plan.retireHint": "No run has used this page in the last {n}. Retiring it may be better value than refreshing it.",
+  "knowledge.plan.na": "Nothing to plan",
+  "knowledge.plan.naHint": "Build a wiki first, or register the pages already on disk - both are free.",
   "knowledge.plan.noEstimate": "No cost estimate yet - there is not enough history to measure one, and none will be invented.",
-  "knowledge.plan.tierNote": "Scan mode {mode}: {deep} deep, {light} light. A cheaper scan is always shown, never a quiet substitution.",
   "knowledge.plan.refreshWhy": "A refresh re-reads your code with a model, so it costs money. That is why it is a command you run, not a button here.",
+  "knowledge.plan.retireHint": "No run has used this page in the last {n}. Retiring it may be better value than refreshing it.",
+  "knowledge.plan.tierNote": "Scan mode {mode}: {deep} deep, {light} light. A cheaper scan is always shown, never a quiet substitution.",
+  "knowledge.reveal": "Show the text",
+  "knowledge.strip.blind": "blind",
+  "knowledge.strip.covered": "covered",
+  "knowledge.strip.docs": "docs",
+  "knowledge.strip.gotchas": "repair notes",
+  "knowledge.strip.patterns": "patterns",
+  "knowledge.strip.pending": "pending",
+  "knowledge.strip.wiki": "wiki",
+  "knowledge.sub": "What ORC already knows about this repo: the wiki, cached code-patterns, and repair memory.",
   "knowledge.syncFree": "Register pages (free)",
   "knowledge.syncOk": "Pages registered",
+  "knowledge.tab.coverage": "Coverage",
+  "knowledge.tab.memory": "Memory",
+  "knowledge.tab.patterns": "Code patterns",
+  "knowledge.tab.peers": "Peers",
+  "knowledge.tab.wiki": "Wiki",
+  "knowledge.title": "Knowledge",
   "knowledge.usage": "Which pages get used",
-  "knowledge.usage.rebuild": "Recount",
-  "knowledge.usage.rebuilt": "Recounted from the traces",
-  "knowledge.usage.registered": "{n} registered",
   "knowledge.usage.active": "{n} in active use",
   "knowledge.usage.never": "{n} unused in {runs} runs",
   "knowledge.usage.neverUsed": "never",
   "knowledge.usage.note": "Counted from what runs actually put into a slice. A page nobody reads still costs money on every full refresh, and context room whenever it is included.",
-  "knowledge.tab.wiki": "Wiki",
-  "knowledge.tab.coverage": "Coverage",
-  "knowledge.tab.patterns": "Code patterns",
-  "knowledge.tab.memory": "Memory",
-  "knowledge.tab.peers": "Peers",
-  "knowledge.strip.wiki": "wiki",
-  "knowledge.strip.docs": "docs",
-  "knowledge.strip.covered": "covered",
-  "knowledge.strip.blind": "blind",
-  "knowledge.strip.pending": "pending",
-  "knowledge.strip.patterns": "patterns",
-  "knowledge.strip.gotchas": "repair notes",
-  "knowledge.field.worst": "Oldest doc (this is what sets the tier)",
-  "knowledge.orientation.present": "Orientation doc present: {file}. Every reader opens it first.",
-  "knowledge.orientation.missing": "No orientation doc. Every reader opens it first, so this one is worth having — and regenerating it is free.",
-  "knowledge.docs.title": "What is in the wiki",
-  "knowledge.docs.note": "Every registered doc, in the order the CLI returned them. Open a row to see what it covers and what it was scanned against. Each distance is measured against that doc's own files, so a doc about payments does not age because the README changed.",
-  "knowledge.docs.none": "Nothing registered.",
-  "knowledge.docs.noneHint": "Docs on disk have to be registered before anything can read them, and registering is free and instant.",
-  "knowledge.docs.col.doc": "Doc",
-  "knowledge.docs.col.tier": "State",
-  "knowledge.docs.col.distance": "Behind",
-  "knowledge.docs.col.covers": "Covers",
-  "knowledge.docs.col.used": "Used",
-  "knowledge.docs.col.tags": "Tags",
-  "knowledge.docs.field.title": "Title",
-  "knowledge.docs.field.type": "Type",
-  "knowledge.docs.field.scanned": "Scanned at commit",
-  "knowledge.docs.field.covers": "Covers",
-  "knowledge.docs.field.coveredFiles": "Files it names",
-  "knowledge.docs.field.lastUsed": "Last used",
-  "knowledge.reveal": "Show the text",
-  "knowledge.coverage.title": "How much of the code is written about",
-  "knowledge.coverage.sub": "{covered} of {tracked} tracked files are covered by at least one doc",
-  "knowledge.coverage.notATarget": "This is a report, not a target. There is no threshold, nothing anywhere reacts to it, and a repo that deliberately writes about four subsystems out of forty is not broken.",
-  "knowledge.coverage.na": "Cannot be measured here.",
-  "knowledge.coverage.naHint": "It needs a registered wiki and a git repository.",
-  "knowledge.coverage.uncovered": "Not covered",
-  "knowledge.coverage.uncoveredNote": "Grouped by folder and biggest first, because \"240 files, all in vendor\" and \"12 files, all in payments\" are opposite situations.",
-  "knowledge.coverage.col.dir": "Folder",
-  "knowledge.coverage.col.files": "Files",
-  "knowledge.coverage.col.last": "Last touched",
-  "knowledge.blind.title": "Changed, and no doc covers it",
-  "knowledge.blind.none": "Nothing changed that no doc covers.",
-  "knowledge.blind.note": "These files changed and no doc claims them. That is a gap in what is written down, not rot in what already exists — so it never makes the wiki stale on its own.",
-  "knowledge.patterns.inspect": "What is in it",
-  "knowledge.patterns.field.codified": "Written on",
-  "knowledge.patterns.field.source": "From commit",
-  "knowledge.patterns.field.playbook": "Playbook it was reconciled against",
-  "knowledge.patterns.field.size": "Lines · bytes",
-  "knowledge.patterns.field.counts": "Conventions · invariants",
-  "knowledge.patterns.unheadered": "This file has no readable header, so there is no date to show. A date is never guessed from when the file was last saved.",
-  "knowledge.patterns.conflicts": "Where the project and the playbook disagree",
-  "knowledge.patterns.literalNote": "This exact text is put in front of every agent that writes code here. If you cannot read it, you cannot trust it.",
-  "knowledge.patterns.paidWhy": "Learning a language's conventions reads a lot of your code, so it costs model tokens — a command to copy, not a button.",
-  "knowledge.gotchas.headroom": "{n} of {max} kept",
-  "knowledge.gotchas.preview": "Show what would be archived",
-  "knowledge.gotchas.pruneWould": "{n} entry(ies) would be moved to the archive:",
-  "knowledge.gotchas.pruneNone": "Nothing would be archived — you are under the limit.",
-  "knowledge.archive.title": "Archive",
-  "knowledge.archive.note": "Nothing is ever deleted here. Entries pushed out by the limit are moved, and they keep their id forever.",
-  "knowledge.archive.load": "Show the archive",
-  "knowledge.archive.empty": "Nothing has been archived yet.",
-  "knowledge.peers.title": "What ORC knows from next door",
-  "knowledge.peers.note": "Linked repos, read-only. Every word here is what the other repo reported — this side never recalculates it. Editing the links happens on Crosslink; there is one picture of the boundary, and it lives there.",
-  "knowledge.peers.open": "Open Crosslink",
-  "knowledge.peers.none": "No repos are linked yet.",
-  "knowledge.peers.col.repo": "Repo",
-  "knowledge.peers.col.state": "State",
-  "knowledge.peers.col.tier": "Freshness",
-  "knowledge.peers.col.tags": "Tags it offers"
+  "knowledge.usage.rebuild": "Recount",
+  "knowledge.usage.rebuilt": "Recounted from the traces",
+  "knowledge.usage.registered": "{n} registered",
+  "knowledge.wiki": "Wiki",
+  "knowledge.wiki.freshNote": "Freshness is coverage-relative: a doc is stale only when commits since its OWN anchor touched files IT covers.",
+  "knowledge.wiki.none": "No wiki yet.",
+  "knowledge.wiki.noneHint": "Run /orc-wiki in Claude Code to build one. This panel never scans — that costs a model.",
+  "knowledge.wiki.syncHint": "`orc wiki sync` fixes this instantly: registration is derived from the docs, so it is free and never a re-scan.",
+  "knowledge.wiki.unregistered": "The wiki is {state} — nothing can read it until it is registered.",
+  "knowledge.wiki.why": "why: {reason}"
 }

package/bin/webui/i18n/en/nav.json

@@ -1,6 +1,7 @@
 {
   "nav.overview": "Overview",
   "nav.settings": "Settings",
+  "nav.rules": "Rules",
   "nav.lanes": "Lanes",
   "nav.runs": "Runs",
   "nav.knowledge": "Knowledge",

package/bin/webui/i18n/en/rules.json

@@ -0,0 +1,55 @@
+{
+  "rules.title": "Rules",
+  "rules.sub": "The anti-slop rules. ORC ships 65 of them, read-only. Yours win.",
+  "rules.unavailable": "Could not read the rules",
+  "rules.unavailableHint": "`orc rules --json` returned nothing this panel could parse. Run it in a terminal to see what it said.",
+
+  "rules.precedence.title": "Precedence",
+  "rules.precedence.lead": "Three layers, and the order never changes.",
+  "rules.precedence.beats": "beats {what}",
+  "rules.precedence.houseScope": "The house rules are CODE and behaviour only. They govern how a change is made — surgical, simple, honest. They say nothing about the words an agent writes, so they never overrule a writing rule.",
+
+  "rules.overrides.head": "1 ORC rule your rules replaced",
+  "rules.overrides.headPlural": "{n} ORC rules your rules replaced",
+  "rules.overrides.unknownId": "not a known ORC rule id",
+
+  "rules.user.title": "Your rules",
+  "rules.user.wins": "This project's own standing instructions. They are read BEFORE ORC's rules, and they win wherever the two disagree.",
+  "rules.user.howto": "Three headings — P0, P1, P2 — and as much text under each as you want. The whole block is handed to every agent verbatim, so write it the way you would say it. Anything above the first heading is a note to yourself and is never dispatched.",
+  "rules.user.turnOff": "To switch an ORC rule off, name its id in a rule of your own: \"OSW-13: em dashes are our house voice.\" The override is then counted, printed at preflight, and stated inside every slice.",
+  "rules.user.staged": "your rules, rewritten",
+  "rules.user.refresh": "Reload from disk",
+
+  "rules.packs.title": "ORC rules",
+  "rules.packs.readOnly": "read-only",
+  "rules.packs.lead": "{n} rules in four packs, shipped with ORC. Adapted, with credit, from other people's work — see below.",
+  "rules.packs.filter": "Filter by id, title or text",
+  "rules.packs.tier": "Tier",
+  "rules.packs.allTiers": "All tiers",
+  "rules.packs.rules": "1 rule",
+  "rules.packs.rulesPlural": "{n} rules",
+  "rules.packs.off": "off here",
+  "rules.packs.showing": "Showing {shown} of {total}.",
+  "rules.packs.noMatch": "No rule matches that filter.",
+  "rules.packs.changeHow": "These change with `orc update` and with nothing else. To change what ORC writes in this project, write your own rule above.",
+  "rules.packs.englishOnly": "The rule text stays English in every language. It is shipped content that rule ids point at, and a translated rule would be a different rule.",
+
+  "rules.credits.title": "Credits",
+  "rules.credits.lead": "These rules are other people's work. Each source is named with its licence and what ORC took from it.",
+  "rules.credits.readOn": "read {date}",
+  "rules.credits.none": "No credit data — run `orc update`.",
+
+  "rules.lint.title": "Lint",
+  "rules.lint.lead": "A free check, zero tokens. It reads only what a string match can prove, and it always says how many rules it could not check. It reports; it never fixes.",
+  "rules.lint.pathPlaceholder": "A file or folder, relative to the project",
+  "rules.lint.run": "Run the lint",
+  "rules.lint.files": "1 file",
+  "rules.lint.filesPlural": "{n} files",
+  "rules.lint.findings": "1 finding",
+  "rules.lint.findingsPlural": "{n} findings",
+  "rules.lint.clean": "Clean, on the rules a matcher can prove.",
+  "rules.lint.nothing": "Nothing lintable there.",
+  "rules.lint.suppressed": "Off here, because your own rules name these ids: {ids}",
+  "rules.lint.skipped": "1 file skipped",
+  "rules.lint.skippedPlural": "{n} files skipped"
+}