@panaversity/ksor 0.0.39 → 0.0.41

package/README.md

@@ -10,7 +10,7 @@ when the corpus does not cover the question.
 ## Start
 
 ```bash
-npx @panaversity/ksor init my-sor
+npx @panaversity/ksor@latest init my-sor
 cd my-sor
 pnpm install
 pnpm dev        # the site, live at http://localhost:3000
@@ -23,15 +23,33 @@ search and `llms.txt`, adopter CI, a dependency-free format checker
 operate it. Everything emitted is yours (the templates are MIT-0), the
 scaffold is deterministic and offline, and every refusal explains itself.
 
-> **`0.x` status:** `init` works, and `serve` runs the MCP server over a built
-> record (with `ingest`/`schema`/`calibrate`/`gc` — the climbed rung, needing
-> Postgres and a provider key). Only `dev` and `build` are designed, not
-> implemented — each prints an honest notice and exits `2` (inside a scaffolded
-> project, `pnpm dev` / `pnpm build` cover local work).
+> **`0.x` status:** `init` works, `build` checks the record and writes its
+> lock, `migrate` rewrites a pre-profile record into the profile, and `serve`
+> runs the MCP server over a built record (with `ingest`/`schema`/`calibrate`/
+> `gc` — the climbed rung, needing Postgres and a provider key). Only `dev` is
+> designed, not implemented — it prints an honest notice and exits `2` (inside
+> a scaffolded project, `pnpm dev` covers local work), as does
+> `build --bundles`.
 > [`docs/status.md`](https://github.com/panaversity/ksor/blob/main/docs/status.md)
 > and the released version number are authoritative for the exact released
 > functionality.
 
+### What a document can do
+
+`knowledge/` is CommonMark, and stays CommonMark — every affordance below is
+syntax that other readers already handle, so a record renders honestly on
+GitHub, in a plain editor, at `/md/` and in `llms-full.txt`.
+
+| Write | The site renders |
+| ----- | ---------------- |
+| `> [!WARNING]` as a blockquote's first line | a callout, tinted in that kind's colour |
+| ` ```bash tab="Claude Code" ` on consecutive fences | one tab group, the choice remembered |
+| a fence with no language | a passage to reproduce, set for reading |
+
+Nothing to author for the rest: a table's head reads as a head, a numbered list
+counts in the record's accent, and a code block wider than the column gets a
+button that unwraps it.
+
 ### Study attachments
 
 A document may carry companions named after it, and the site renders each on
@@ -53,8 +71,10 @@ covers the opening and trails off leaves a reader believing they have the whole
 document.
 
 An attachment is **part of its document**: no URL, no sidebar row, no
-`llms.txt` line, and no id an agent can cite. It takes its `visibility:` and
-any takedown from its parent, so restricting the document restricts them all.
+`llms.txt` line, and no id an agent can cite. It takes its audience and any
+takedown from its parent, so restricting the document restricts them all. A
+`<doc>.summary.md` carries exactly `type: Summary` and nothing else — a marker,
+never governance of its own.
 A quiz whose answers are guessable is refused by the build, and because ingest
 creates no node for an attachment, a quiz's answer key can never reach the
 agent surface at all.
@@ -72,7 +92,7 @@ Full concept, design goals, and project status:
 
 ```bash
 npm install -g @panaversity/ksor   # command installed: ksor
-npx @panaversity/ksor              # or run without installing
+npx @panaversity/ksor@latest       # or run without installing
 ```
 
 ## License