@panaversity/ksor 0.0.0 → 0.0.2

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 (52) hide show
  1. package/CHANGELOG.md +44 -0
  2. package/NOTICE +8 -0
  3. package/README.md +29 -1307
  4. package/dist/cli.d.mts +1 -0
  5. package/dist/cli.mjs +384 -0
  6. package/dist/index.d.mts +34 -0
  7. package/dist/index.mjs +37 -0
  8. package/docs/index.md +53 -0
  9. package/package.json +52 -23
  10. package/templates/LICENSE +23 -0
  11. package/templates/scaffold/.agents/skills/add-sources/SKILL.md +43 -0
  12. package/templates/scaffold/.agents/skills/format-checker/SKILL.md +39 -0
  13. package/templates/scaffold/.agents/skills/format-checker/check.mjs +782 -0
  14. package/templates/scaffold/.agents/skills/intake-interview/SKILL.md +46 -0
  15. package/templates/scaffold/.claude/skills/add-sources/SKILL.md +43 -0
  16. package/templates/scaffold/.claude/skills/format-checker/SKILL.md +39 -0
  17. package/templates/scaffold/.claude/skills/format-checker/check.mjs +782 -0
  18. package/templates/scaffold/.claude/skills/intake-interview/SKILL.md +46 -0
  19. package/templates/scaffold/.gemini/settings.json +5 -0
  20. package/templates/scaffold/.gitattributes +5 -0
  21. package/templates/scaffold/.github/workflows/validate.yml +23 -0
  22. package/templates/scaffold/AGENTS.md +104 -0
  23. package/templates/scaffold/CLAUDE.md +1 -0
  24. package/templates/scaffold/README.md +63 -0
  25. package/templates/scaffold/gitignore +13 -0
  26. package/templates/scaffold/instance.md +26 -0
  27. package/templates/scaffold/knowledge/example.md +23 -0
  28. package/templates/scaffold/package.json +15 -0
  29. package/templates/scaffold/pnpm-lock.yaml +4041 -0
  30. package/templates/scaffold/pnpm-workspace.yaml +19 -0
  31. package/templates/scaffold/system/site/app/(home)/layout.tsx +6 -0
  32. package/templates/scaffold/system/site/app/(home)/page.tsx +83 -0
  33. package/templates/scaffold/system/site/app/api/search/route.ts +11 -0
  34. package/templates/scaffold/system/site/app/docs/[[...slug]]/page.tsx +53 -0
  35. package/templates/scaffold/system/site/app/docs/layout.tsx +24 -0
  36. package/templates/scaffold/system/site/app/global.css +26 -0
  37. package/templates/scaffold/system/site/app/icon.png +0 -0
  38. package/templates/scaffold/system/site/app/layout.tsx +41 -0
  39. package/templates/scaffold/system/site/app/llms-full.txt/route.ts +10 -0
  40. package/templates/scaffold/system/site/app/llms.txt/route.ts +15 -0
  41. package/templates/scaffold/system/site/components/built-with.tsx +18 -0
  42. package/templates/scaffold/system/site/components/mdx.tsx +15 -0
  43. package/templates/scaffold/system/site/lib/layout.shared.tsx +17 -0
  44. package/templates/scaffold/system/site/lib/shared.ts +51 -0
  45. package/templates/scaffold/system/site/lib/source.ts +119 -0
  46. package/templates/scaffold/system/site/next-env.d.ts +6 -0
  47. package/templates/scaffold/system/site/next.config.mjs +32 -0
  48. package/templates/scaffold/system/site/package.json +29 -0
  49. package/templates/scaffold/system/site/postcss.config.mjs +7 -0
  50. package/templates/scaffold/system/site/source.config.ts +35 -0
  51. package/templates/scaffold/system/site/tsconfig.json +35 -0
  52. package/bin/ksor.js +0 -22
package/CHANGELOG.md ADDED
@@ -0,0 +1,44 @@
1
+ # @panaversity/ksor
2
+
3
+ ## 0.0.2
4
+
5
+ ### Patch Changes
6
+
7
+ - 54a8f5f: `ksor init` is implemented — the first working verb. One command emits a
8
+ complete governed knowledge project: the record (`knowledge/`), a working
9
+ Fumadocs site (`system/site/`, static export, hot reload, static search,
10
+ llms.txt), the agent kit (AGENTS.md constitution, CLAUDE.md pointer,
11
+ `.agents/skills` with byte-identical `.claude/skills` copies, Gemini
12
+ pointer), adopter CI, and a dependency-free format checker (`pnpm check`).
13
+ Deterministic (every emitted byte ships as template content, lockfile
14
+ included), atomic, offline. Refusals carry stable slugs with working
15
+ remedies; environment failures exit 3 with slugs, never raw stack traces.
16
+
17
+ The scaffold ships branded and self-explaining: the KSoR mark as the
18
+ default favicon, a real landing page led by the instance name with the
19
+ first document derived (never hardcoded), a deletable "Built with KSoR"
20
+ maker's mark, a README that explains every emitted file, and a governed
21
+ `order:` frontmatter key that drives the sidebar, `llms.txt`, and the
22
+ home page from one declaration. The site shell is replaceable behind a
23
+ four-clause surface contract, proven by a second (Docusaurus) shell and
24
+ a shell-agnostic conformance suite in the ksor repository.
25
+
26
+ ## 0.0.1
27
+
28
+ ### Patch Changes
29
+
30
+ - 98aae4a: Rebuilt the package on the real toolchain: the CLI is now compiled TypeScript
31
+ (pure ESM, Node >= 24) instead of a hand-written script, and it exports the CLI
32
+ contract — `exitCodes` (1 refused, 2 not implemented, 3 environment), `verbs`,
33
+ and `resolveCommand` — so scripts and agents can rely on documented exit
34
+ semantics. `ksor --help`/`-h` and `--version` now answer with exit 0; every designed
35
+ verb still answers honestly that it is not implemented and exits 2, and an
36
+ unknown word is refused with exit 1 and a stable `error: unknown-verb` slug. Documentation now ships inside the
37
+ package under `docs/`.
38
+
39
+ ## 0.0.0
40
+
41
+ Name reservation (published 2026-08-11). The package holds the scope, states
42
+ the intent, and ships an honest placeholder CLI: any invocation prints the
43
+ reservation notice and exits `2`. Nothing in this version is a released
44
+ capability.
package/NOTICE ADDED
@@ -0,0 +1,8 @@
1
+ KSoR — Knowledge System of Record
2
+ Copyright 2026 Panaversity
3
+
4
+ Licensed under the Apache License, Version 2.0 (the "License");
5
+ you may not use this work except in compliance with the License.
6
+ You may obtain a copy of the License at
7
+
8
+ http://www.apache.org/licenses/LICENSE-2.0