skillwiki 0.10.112 → 0.10.113

package/dist/{index-projection-UNZG5UJZ.js → index-projection-RQSOEDXM.js}

@@ -4,11 +4,11 @@ import {
   UNMANAGED_START,
   renderRootIndex,
   writeRootIndexProjection
-} from "./chunk-IR2DI4Y5.js";
-import "./chunk-KJG2CSYD.js";
-import "./chunk-TKX6PSWZ.js";
-import "./chunk-EE7W3GLA.js";
-import "./chunk-7POLZOFY.js";
+} from "./chunk-IJWZDQDH.js";
+import "./chunk-3TKNAOJH.js";
+import "./chunk-JL2SCLXT.js";
+import "./chunk-6VUK2FTX.js";
+import "./chunk-VNSZCK5V.js";
 export {
   UNMANAGED_END,
   UNMANAGED_START,

package/dist/{journal-5IW3TZ5F.js → journal-V5XHBEI5.js}

@@ -3,9 +3,9 @@ import {
   readJournal,
   upsertJournal,
   writeJournal
-} from "./chunk-FCA3RRNF.js";
-import "./chunk-EE7W3GLA.js";
-import "./chunk-7POLZOFY.js";
+} from "./chunk-SEY4N4CT.js";
+import "./chunk-6VUK2FTX.js";
+import "./chunk-VNSZCK5V.js";
 export {
   readJournal,
   upsertJournal,

package/dist/{managed-write-preflight-L7IRQ76C.js → managed-write-preflight-2BMHZWVJ.js}

@@ -6,13 +6,13 @@ import {
   runManagedWritePeerGate,
   runManagedWritePreflight,
   runManagedWriteTransaction
-} from "./chunk-Q6EZF37H.js";
-import "./chunk-CKQPUHM2.js";
-import "./chunk-KJG2CSYD.js";
-import "./chunk-TKX6PSWZ.js";
-import "./chunk-EE7W3GLA.js";
-import "./chunk-SKOLE6US.js";
-import "./chunk-7POLZOFY.js";
+} from "./chunk-FQERKMD7.js";
+import "./chunk-K3YZESND.js";
+import "./chunk-3TKNAOJH.js";
+import "./chunk-JL2SCLXT.js";
+import "./chunk-6VUK2FTX.js";
+import "./chunk-IJKJGQKL.js";
+import "./chunk-VNSZCK5V.js";
 export {
   DEFAULT_MANAGED_WRITE_WAIT_MS,
   MANAGED_WRITE_POLL_INTERVAL_MS,

package/dist/{mcp-auth-env-X5MI5IX6.js → mcp-auth-env-QONKW4EO.js}

@@ -9,9 +9,9 @@ import {
   nonEmptyEnvValue,
   redactMcpSecret,
   resolveMcpAuthEnv
-} from "./chunk-DOHWNPAZ.js";
-import "./chunk-SKOLE6US.js";
-import "./chunk-7POLZOFY.js";
+} from "./chunk-OGEAFXON.js";
+import "./chunk-IJKJGQKL.js";
+import "./chunk-VNSZCK5V.js";
 export {
   MCP_HOST_ID_ENV,
   MCP_TOKEN_ENV,

package/dist/{migrate-RO4BJP5T.js → migrate-SRRCXI2K.js}

@@ -6,12 +6,12 @@ import {
   refreshInstalledClipPlist,
   stableCliBinary,
   xml
-} from "./chunk-25OXNFDV.js";
-import "./chunk-EE7W3GLA.js";
-import "./chunk-ABRYBO4T.js";
-import "./chunk-LOVLZNLX.js";
-import "./chunk-SKOLE6US.js";
-import "./chunk-7POLZOFY.js";
+} from "./chunk-XJ5VEIH7.js";
+import "./chunk-6VUK2FTX.js";
+import "./chunk-OWWWO2XS.js";
+import "./chunk-5D5HFQ76.js";
+import "./chunk-IJKJGQKL.js";
+import "./chunk-VNSZCK5V.js";
 export {
   CLIP_MIGRATION_HINT,
   migrateClipOutbox,

package/dist/{runtime-VMFYW2K3.js → runtime-LQZIG3XN.js}

@@ -6,10 +6,10 @@ import {
   isRfc1918OrLoopback,
   loadClipCredentials,
   validateRuntime
-} from "./chunk-ABRYBO4T.js";
-import "./chunk-LOVLZNLX.js";
-import "./chunk-SKOLE6US.js";
-import "./chunk-7POLZOFY.js";
+} from "./chunk-OWWWO2XS.js";
+import "./chunk-5D5HFQ76.js";
+import "./chunk-IJKJGQKL.js";
+import "./chunk-VNSZCK5V.js";
 export {
   assertClipS3Endpoint,
   conditionalCreateProven,

package/dist/skillwiki-mcp.js

@@ -1,21 +1,21 @@
 #!/usr/bin/env node
 import {
   runSkillwikiMcpStdio
-} from "./chunk-APKDTEVV.js";
-import "./chunk-RR6VDWSI.js";
+} from "./chunk-5RHR4FEK.js";
+import "./chunk-CBT35FAW.js";
 import "./chunk-7I2TPIV5.js";
-import "./chunk-IR2DI4Y5.js";
-import "./chunk-Q6EZF37H.js";
-import "./chunk-CKQPUHM2.js";
-import "./chunk-KJG2CSYD.js";
-import "./chunk-TKX6PSWZ.js";
-import "./chunk-DOHWNPAZ.js";
-import "./chunk-25OXNFDV.js";
-import "./chunk-EE7W3GLA.js";
-import "./chunk-ABRYBO4T.js";
-import "./chunk-LOVLZNLX.js";
-import "./chunk-SKOLE6US.js";
-import "./chunk-7POLZOFY.js";
+import "./chunk-IJWZDQDH.js";
+import "./chunk-FQERKMD7.js";
+import "./chunk-K3YZESND.js";
+import "./chunk-3TKNAOJH.js";
+import "./chunk-JL2SCLXT.js";
+import "./chunk-OGEAFXON.js";
+import "./chunk-XJ5VEIH7.js";
+import "./chunk-6VUK2FTX.js";
+import "./chunk-OWWWO2XS.js";
+import "./chunk-5D5HFQ76.js";
+import "./chunk-IJKJGQKL.js";
+import "./chunk-VNSZCK5V.js";
 
 // src/mcp-entry.ts
 runSkillwikiMcpStdio().catch((error) => {

package/dist/sources-E6KHDRDE.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import {
+  runSourcesPending
+} from "./chunk-CBT35FAW.js";
+import "./chunk-K3YZESND.js";
+import "./chunk-JL2SCLXT.js";
+import "./chunk-VNSZCK5V.js";
+export {
+  runSourcesPending
+};

package/dist/{watcher-MGHQD3UI.js → watcher-VJ3TOU6J.js}

@@ -3,7 +3,7 @@ import {
   readJournal,
   upsertJournal,
   writeJournal
-} from "./chunk-FCA3RRNF.js";
+} from "./chunk-SEY4N4CT.js";
 import {
   buildReadyHint
 } from "./chunk-OSL4J7GF.js";
@@ -14,11 +14,11 @@ import {
   sha256Hex
 } from "./chunk-ZRGZBAVS.js";
 import "./chunk-QESNTTVY.js";
-import "./chunk-EE7W3GLA.js";
+import "./chunk-6VUK2FTX.js";
 import {
   assertPublicHttpsUrl
-} from "./chunk-LOVLZNLX.js";
-import "./chunk-7POLZOFY.js";
+} from "./chunk-5D5HFQ76.js";
+import "./chunk-VNSZCK5V.js";
 
 // src/clip-outbox/watcher.ts
 import { createRequire } from "module";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.10.112",
+  "version": "0.10.113",
   "type": "module",
   "bin": {
     "skillwiki": "dist/cli.js",

package/skills/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.10.112",
+  "version": "0.10.113",
   "skills": "./",
   "description": "Project-aware Karpathy-style knowledge base for Claude Code: 22 prompt-only skills (wiki-*, proj-*, using-skillwiki, skillwiki-mcp, skillwiki-connect) backed by the deterministic `skillwiki` CLI.",
   "author": {

package/skills/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.10.112",
+  "version": "0.10.113",
   "description": "Project-aware Karpathy-style knowledge base for Codex with 22 prompt-only skills backed by the deterministic skillwiki CLI.",
   "author": {
     "name": "karlorz",

package/skills/.cursor-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.10.112",
+  "version": "0.10.113",
   "description": "Project-aware Karpathy-style knowledge base: 22 prompt-only skills (wiki-*, proj-*, using-skillwiki, skillwiki-mcp, skillwiki-connect) backed by HTTP MCP wiki_capture.",
   "author": {
     "name": "karlorz"

package/skills/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillwiki/skills",
-  "version": "0.10.112",
+  "version": "0.10.113",
   "private": true,
   "files": [
     "wiki-*",

package/skills/skills/wiki-ingest/SKILL.md

@@ -42,6 +42,53 @@ Run `skillwiki lang` at the start. Generate page-body prose, narrative sections,
    5. `skillwiki sources compile published <raw-path> [vault] --pages "<typed/a.md,typed/b.md>" --reason "<why>"` then `--write --approve <token>`
    6. Leave the review `open` unless the human resolves it with `skillwiki sources review <raw-path> --status accepted|needs-fix|dismissed --reason "<why>"`
    Goal, satellite, and headless sessions may list pending / compile status / reviews but must not claim or publish compile turns.
+## Output standard v2
+`skillwiki ingest` stamps `output_standard: v2` on every new typed stub. v2 is an authoring contract. CLI lint reports advisory warnings on marked pages only. Publish, health, and lint exit stay unchanged by these checks.
+
+### Rung 1 — STE-80 (default)
+STE is Simplified Technical English.
+- Use at most 20 words for each instruction. Use at most 25 words for each description.
+- One topic per paragraph. Each paragraph <= 6 sentences.
+- One word, one meaning. Prefer simple verbs: use, start, stop, find, check.
+- Keep technical terms (API, cache, Docker). Define each term once at first use.
+- No hedges except in `## Uncertainty`. Never drop facts to shorten.
+- Hedge list: might, may, perhaps, possibly, probably, likely, seems, appears to, arguably, somewhat, could be.
+- Use `## Uncertainty` only for uncertainty the source itself reports. If the source reports none, omit the section or write "The source reports no open uncertainty."
+
+### Rung 2 — diagrams (default when content has structure)
+Add one Mermaid diagram when the page has flow, components, timeline, hierarchy, or comparison. Keep a text summary beside the diagram. Directly after the diagram, add `**Least certain:**` and a bullet list of labels or edges.
+
+The `**Least certain:**` bullets name diagram labels or edges. State why that part of the diagram is the least certain representation. Use one of these reasons: an interpretive grouping, a simplified step, an omitted condition, or a mapping the source does not state directly.
+
+Never add doubt about a fact the source states as settled. Never turn a decision, constraint, or policy into an open question.
+
+If a diagram has fewer than 3 labels and edges in total, list all of them. Otherwise list the 3 least-certain labels or edges.
+
+A diagram must not present a shortened executable procedure. For safety or recovery flows, keep all required steps or point the node to the full text procedure.
+
+### Rung 3 — HTML (opt-in)
+Set `html_render: true` by hand or with `skillwiki ingest --html`. Render outside the vault:
+
+```bash
+skillwiki page render-html <page> [vault] --out <file>
+```
+
+HTML is always opt-in. The renderer writes one self-contained file (TOC, tabs per H2, `<details>`, inline CSS and JS). Mermaid stays as readable source. No network fetch.
+
+### Rung 4 — video
+Explainer video is out of scope. Use STE text plus a diagram.
+
+### Format table
+
+| Content type | Format | Rung | Policy |
+| --- | --- | --- | --- |
+| Exact procedure (re-read later) | STE text | 1 | default |
+| Relationships (structure / flow / hierarchy) | Mermaid diagram + text | 2 | default |
+| Comparison / hands-on exploration | HTML interactive page | 3 | opt-in; otherwise STE + table or diagram |
+| Concept from zero | Explainer video | 4 | out of scope; use STE + diagram |
+
+Rules: formats stack; HTML is always opt-in; video is outside the current scope.
+
 ## Provenance defaults
 - Default `provenance: research`.
 - If cwd is inside `projects/{slug}/`, set `provenance: project` and add `provenance_projects: ["[[slug]]"]`.

package/skills/skills/wiki-lint/SKILL.md

@@ -19,6 +19,13 @@ Standard four reads.
 6. If `log_rotate_needed` is present and the user consents, run `skillwiki log-rotate <vault> --apply`. Otherwise leave alone.
 7. **Post-migration verification**: If the user recently migrated **vault content** (e.g., moved entity/concept pages to another vault), re-run `skillwiki lint <vault> --summary` and verify that broken_wikilinks count decreased. Remaining broken links for migrated content indicate pages still referencing the moved files — these should be cleaned up (remove citations or migrate the referencing pages too). This step is content moves only — not HTTP MCP client/plugin upgrades (those use `skillwiki doctor --check-mcp`).
 8. Append a `log.md` entry summarizing lint counts only when the user asked to record the maintenance result. Do not log routine `health` reports by default.
+## Output standard v2 WARN buckets
+These four buckets apply only to typed pages whose frontmatter has `output_standard: v2`. They are advisory WARN findings. They do not change the lint exit code, publish, health exit, or release CI on content.
+- `ste_sentence_length`: prose sentences > 25 words; ordered-list items and list items under Steps/Procedure headings > 20 words.
+- `ste_hedge_words`: whole-word hedges outside `## Uncertainty`, outside the `**Least certain:**` list, and outside code and blockquotes.
+- `ste_diagram_uncertainty`: a Mermaid block with no `**Least certain:**` bullet list after it.
+- `ste_comparison_visual`: a `type: comparison` page with neither a Markdown table nor a Mermaid block.
+Drill with `skillwiki lint <vault> --only <bucket>`.
 ## Stop conditions
 None — lint reports all findings even on per-page errors.
 ## Forbidden

package/skills/wiki-ingest/SKILL.md

@@ -42,6 +42,53 @@ Run `skillwiki lang` at the start. Generate page-body prose, narrative sections,
    5. `skillwiki sources compile published <raw-path> [vault] --pages "<typed/a.md,typed/b.md>" --reason "<why>"` then `--write --approve <token>`
    6. Leave the review `open` unless the human resolves it with `skillwiki sources review <raw-path> --status accepted|needs-fix|dismissed --reason "<why>"`
    Goal, satellite, and headless sessions may list pending / compile status / reviews but must not claim or publish compile turns.
+## Output standard v2
+`skillwiki ingest` stamps `output_standard: v2` on every new typed stub. v2 is an authoring contract. CLI lint reports advisory warnings on marked pages only. Publish, health, and lint exit stay unchanged by these checks.
+
+### Rung 1 — STE-80 (default)
+STE is Simplified Technical English.
+- Use at most 20 words for each instruction. Use at most 25 words for each description.
+- One topic per paragraph. Each paragraph <= 6 sentences.
+- One word, one meaning. Prefer simple verbs: use, start, stop, find, check.
+- Keep technical terms (API, cache, Docker). Define each term once at first use.
+- No hedges except in `## Uncertainty`. Never drop facts to shorten.
+- Hedge list: might, may, perhaps, possibly, probably, likely, seems, appears to, arguably, somewhat, could be.
+- Use `## Uncertainty` only for uncertainty the source itself reports. If the source reports none, omit the section or write "The source reports no open uncertainty."
+
+### Rung 2 — diagrams (default when content has structure)
+Add one Mermaid diagram when the page has flow, components, timeline, hierarchy, or comparison. Keep a text summary beside the diagram. Directly after the diagram, add `**Least certain:**` and a bullet list of labels or edges.
+
+The `**Least certain:**` bullets name diagram labels or edges. State why that part of the diagram is the least certain representation. Use one of these reasons: an interpretive grouping, a simplified step, an omitted condition, or a mapping the source does not state directly.
+
+Never add doubt about a fact the source states as settled. Never turn a decision, constraint, or policy into an open question.
+
+If a diagram has fewer than 3 labels and edges in total, list all of them. Otherwise list the 3 least-certain labels or edges.
+
+A diagram must not present a shortened executable procedure. For safety or recovery flows, keep all required steps or point the node to the full text procedure.
+
+### Rung 3 — HTML (opt-in)
+Set `html_render: true` by hand or with `skillwiki ingest --html`. Render outside the vault:
+
+```bash
+skillwiki page render-html <page> [vault] --out <file>
+```
+
+HTML is always opt-in. The renderer writes one self-contained file (TOC, tabs per H2, `<details>`, inline CSS and JS). Mermaid stays as readable source. No network fetch.
+
+### Rung 4 — video
+Explainer video is out of scope. Use STE text plus a diagram.
+
+### Format table
+
+| Content type | Format | Rung | Policy |
+| --- | --- | --- | --- |
+| Exact procedure (re-read later) | STE text | 1 | default |
+| Relationships (structure / flow / hierarchy) | Mermaid diagram + text | 2 | default |
+| Comparison / hands-on exploration | HTML interactive page | 3 | opt-in; otherwise STE + table or diagram |
+| Concept from zero | Explainer video | 4 | out of scope; use STE + diagram |
+
+Rules: formats stack; HTML is always opt-in; video is outside the current scope.
+
 ## Provenance defaults
 - Default `provenance: research`.
 - If cwd is inside `projects/{slug}/`, set `provenance: project` and add `provenance_projects: ["[[slug]]"]`.

package/skills/wiki-lint/SKILL.md

@@ -19,6 +19,13 @@ Standard four reads.
 6. If `log_rotate_needed` is present and the user consents, run `skillwiki log-rotate <vault> --apply`. Otherwise leave alone.
 7. **Post-migration verification**: If the user recently migrated **vault content** (e.g., moved entity/concept pages to another vault), re-run `skillwiki lint <vault> --summary` and verify that broken_wikilinks count decreased. Remaining broken links for migrated content indicate pages still referencing the moved files — these should be cleaned up (remove citations or migrate the referencing pages too). This step is content moves only — not HTTP MCP client/plugin upgrades (those use `skillwiki doctor --check-mcp`).
 8. Append a `log.md` entry summarizing lint counts only when the user asked to record the maintenance result. Do not log routine `health` reports by default.
+## Output standard v2 WARN buckets
+These four buckets apply only to typed pages whose frontmatter has `output_standard: v2`. They are advisory WARN findings. They do not change the lint exit code, publish, health exit, or release CI on content.
+- `ste_sentence_length`: prose sentences > 25 words; ordered-list items and list items under Steps/Procedure headings > 20 words.
+- `ste_hedge_words`: whole-word hedges outside `## Uncertainty`, outside the `**Least certain:**` list, and outside code and blockquotes.
+- `ste_diagram_uncertainty`: a Mermaid block with no `**Least certain:**` bullet list after it.
+- `ste_comparison_visual`: a `type: comparison` page with neither a Markdown table nor a Mermaid block.
+Drill with `skillwiki lint <vault> --only <bucket>`.
 ## Stop conditions
 None — lint reports all findings even on per-page errors.
 ## Forbidden

package/dist/sources-AOYP6ROO.js

@@ -1,10 +0,0 @@
-#!/usr/bin/env node
-import {
-  runSourcesPending
-} from "./chunk-RR6VDWSI.js";
-import "./chunk-CKQPUHM2.js";
-import "./chunk-TKX6PSWZ.js";
-import "./chunk-7POLZOFY.js";
-export {
-  runSourcesPending
-};