@panaversity/ksor 0.0.20 → 0.0.22

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. package/CHANGELOG.md +498 -0
  2. package/dist/cli.mjs +71 -19
  3. package/package.json +3 -3
  4. package/templates/scaffold/.agents/skills/format-checker/check.mjs +232 -9
  5. package/templates/scaffold/.claude/skills/format-checker/check.mjs +232 -9
  6. package/templates/scaffold/AGENTS.md +52 -4
  7. package/templates/scaffold/gitignore +3 -0
  8. package/templates/scaffold/instance.md +28 -20
  9. package/templates/scaffold/knowledge/governance-ladder.md +36 -0
  10. package/templates/scaffold/knowledge/surfaces/for-agents.md +29 -0
  11. package/templates/scaffold/knowledge/surfaces/for-people.md +35 -0
  12. package/templates/scaffold/knowledge/surfaces/index.md +21 -0
  13. package/templates/scaffold/knowledge/what-is-a-ksor.md +39 -0
  14. package/templates/scaffold/pnpm-lock.yaml +1198 -228
  15. package/templates/scaffold/system/site/app/(home)/layout.tsx +6 -0
  16. package/templates/scaffold/system/site/app/(home)/page.tsx +65 -70
  17. package/templates/scaffold/system/site/app/docs/[[...slug]]/page.tsx +122 -14
  18. package/templates/scaffold/system/site/app/docs/layout.tsx +2 -21
  19. package/templates/scaffold/system/site/app/global.css +552 -9
  20. package/templates/scaffold/system/site/app/layout.tsx +23 -4
  21. package/templates/scaffold/system/site/app/llms-full.txt/route.ts +4 -2
  22. package/templates/scaffold/system/site/app/llms.txt/route.ts +11 -9
  23. package/templates/scaffold/system/site/app/md/[[...slug]]/route.ts +51 -0
  24. package/templates/scaffold/system/site/components/copy-markdown.tsx +70 -0
  25. package/templates/scaffold/system/site/components/governance.tsx +262 -0
  26. package/templates/scaffold/system/site/components/home-cover.tsx +137 -0
  27. package/templates/scaffold/system/site/components/record-index.tsx +120 -0
  28. package/templates/scaffold/system/site/components/record-shell.tsx +68 -0
  29. package/templates/scaffold/system/site/components/record-stack.tsx +131 -0
  30. package/templates/scaffold/system/site/components/record-toc.tsx +160 -0
  31. package/templates/scaffold/system/site/components/search-dialog.tsx +130 -0
  32. package/templates/scaffold/system/site/components/sidebar-status.tsx +35 -0
  33. package/templates/scaffold/system/site/components/ui/badge.tsx +46 -0
  34. package/templates/scaffold/system/site/components/ui/button.tsx +62 -0
  35. package/templates/scaffold/system/site/components/ui/separator.tsx +28 -0
  36. package/templates/scaffold/system/site/components.json +25 -0
  37. package/templates/scaffold/system/site/lib/governance.ts +432 -0
  38. package/templates/scaffold/system/site/lib/layout.shared.tsx +1 -1
  39. package/templates/scaffold/system/site/lib/shared.ts +38 -0
  40. package/templates/scaffold/system/site/lib/source.ts +221 -5
  41. package/templates/scaffold/system/site/lib/stage-knowledge.ts +193 -40
  42. package/templates/scaffold/system/site/lib/utils.ts +6 -0
  43. package/templates/scaffold/system/site/package.json +9 -3
  44. package/templates/scaffold/knowledge/example.md +0 -23
@@ -0,0 +1,39 @@
1
+ ---
2
+ title: What a Knowledge System of Record is
3
+ description: The authoritative, governed knowledge layer humans, agents and software operate from.
4
+ status: approved
5
+ owner: Product
6
+ order: 1
7
+ effective: 2026-08-22
8
+ provenance:
9
+ - KSoR README, "What Is a Knowledge System of Record?"
10
+ ---
11
+
12
+ A traditional system of record establishes what is true about the current state
13
+ of a business: the ledger is authoritative for transactions, the HRIS for
14
+ employee records. When a spreadsheet disagrees with the ledger, the ledger wins.
15
+
16
+ A Knowledge System of Record establishes something else — what the organization
17
+ knows and how it should operate. Which policies apply, which thresholds are
18
+ approved, what a term means here, and what to do when the answer is not known.
19
+
20
+ ## The problem it solves
21
+
22
+ That knowledge is usually scattered across wikis, decks, PDFs, prompts and
23
+ someone's memory, with no authoritative answer to the question an agent has to
24
+ ask: which knowledge should I trust?
25
+
26
+ ### Why an assistant cannot answer that question
27
+
28
+ An assistant answers from everything it has ever read, which is exactly why it
29
+ cannot tell you which of its sentences were checked. Businesses have had a
30
+ system of record for decades. AI never did.
31
+
32
+ ## What this record settles, and what it does not
33
+
34
+ It settles which copy governs. Every answer traces to a document here, and that
35
+ document names who stands behind it and when it took effect.
36
+
37
+ It does not settle whether that document is right. Provenance proves who said
38
+ what, and when — the judgement of whether a source is any good is a separate
39
+ matter, and this record never claims otherwise.