skillwiki 0.10.49 → 0.10.51

package/dist/{index-projection-BJNZUPH6.js → index-projection-EXBX32RR.js}

@@ -4,9 +4,9 @@ import {
   UNMANAGED_START,
   renderRootIndex,
   writeRootIndexProjection
-} from "./chunk-GAU4D25O.js";
-import "./chunk-UHZBOOMK.js";
-import "./chunk-EVQASYII.js";
+} from "./chunk-O3HCB7R2.js";
+import "./chunk-74OSLCXE.js";
+import "./chunk-IJ7DD7QZ.js";
 export {
   UNMANAGED_END,
   UNMANAGED_START,

package/dist/{managed-write-preflight-H7KVK2KI.js → managed-write-preflight-7GDFRPUT.js}

@@ -2,10 +2,10 @@
 import {
   runManagedWritePreflight,
   runManagedWriteTransaction
-} from "./chunk-FXASPB3C.js";
-import "./chunk-UHZBOOMK.js";
-import "./chunk-PLUHIOCQ.js";
-import "./chunk-EVQASYII.js";
+} from "./chunk-UPQ6XJSV.js";
+import "./chunk-74OSLCXE.js";
+import "./chunk-GAHMWLWU.js";
+import "./chunk-IJ7DD7QZ.js";
 export {
   runManagedWritePreflight,
   runManagedWriteTransaction

package/dist/skillwiki-mcp.js

@@ -1,13 +1,14 @@
 #!/usr/bin/env node
 import {
   runSkillwikiMcpStdio
-} from "./chunk-F7LXKP4T.js";
+} from "./chunk-3IBRZTLF.js";
 import "./chunk-7I2TPIV5.js";
-import "./chunk-GAU4D25O.js";
-import "./chunk-FXASPB3C.js";
-import "./chunk-UHZBOOMK.js";
-import "./chunk-PLUHIOCQ.js";
-import "./chunk-EVQASYII.js";
+import "./chunk-O3HCB7R2.js";
+import "./chunk-UPQ6XJSV.js";
+import "./chunk-74OSLCXE.js";
+import "./chunk-HBQTTYXZ.js";
+import "./chunk-GAHMWLWU.js";
+import "./chunk-IJ7DD7QZ.js";
 
 // src/mcp-entry.ts
 runSkillwikiMcpStdio().catch((error) => {

package/dist/sources-BFYEFTS4.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import {
+  runSourcesPending
+} from "./chunk-HBQTTYXZ.js";
+import "./chunk-GAHMWLWU.js";
+import "./chunk-IJ7DD7QZ.js";
+export {
+  runSourcesPending
+};

package/package.json

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

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

@@ -1,8 +1,8 @@
 {
   "name": "skillwiki",
-  "version": "0.10.49",
+  "version": "0.10.51",
   "skills": "./",
-  "description": "Project-aware Karpathy-style knowledge base for Claude Code: 19 prompt-only skills (wiki-*, proj-*, using-skillwiki) backed by the deterministic `skillwiki` CLI.",
+  "description": "Project-aware Karpathy-style knowledge base for Claude Code: 20 prompt-only skills (wiki-*, proj-*, using-skillwiki) backed by the deterministic `skillwiki` CLI.",
   "author": {
     "name": "karlorz",
     "url": "https://github.com/karlorz"

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

@@ -1,7 +1,7 @@
 {
   "name": "skillwiki",
-  "version": "0.10.49",
-  "description": "Project-aware Karpathy-style knowledge base for Codex with 19 prompt-only skills backed by the deterministic skillwiki CLI.",
+  "version": "0.10.51",
+  "description": "Project-aware Karpathy-style knowledge base for Codex with 20 prompt-only skills backed by the deterministic skillwiki CLI.",
   "author": {
     "name": "karlorz",
     "url": "https://github.com/karlorz"
@@ -22,7 +22,7 @@
   "interface": {
     "displayName": "SkillWiki",
     "shortDescription": "Project-aware wiki skills for Codex agents",
-    "longDescription": "19 prompt-only skills (wiki-*, proj-*, using-skillwiki) for deterministic, project-aware knowledge workflows.",
+    "longDescription": "20 prompt-only skills (wiki-*, proj-*, using-skillwiki) for deterministic, project-aware knowledge workflows.",
     "developerName": "karlorz",
     "category": "Productivity",
     "capabilities": [

package/skills/README.md

@@ -3,7 +3,7 @@
 Prompt-only Markdown skills for Claude Code. Installed via `skillwiki install`
 or the Claude/Codex/Antigravity plugin packaging paths.
 
-Current package inventory: **19 skills**.
+Current package inventory: **20 skills**.
 
 Publication policy: new or updated typed-knowledge and meta pages must use
 `skillwiki page publish` from a temporary draft, inspect its dry-run, and add

package/skills/agents/wiki-ingest.md

@@ -63,11 +63,13 @@ Return:
 - `skillwiki ingest` returns nonzero; retain any raw-only result for retry
 - sha256 already exists in vault (skip, don't duplicate)
 - Source or generated content contains unredacted live credentials or other authenticating secrets
+- The source is already a pending raw article/paper. Do not call `skillwiki ingest` again and do not drain `sources compile` from this maintenance agent. Report the path for an attended interactive session.
 
 **Forbidden:**
 - Skipping `fetch-guard` for URL sources
 - Creating a final typed page or editing index.md/log.md directly
 - Modifying existing raw files (N9)
+- Unattended `sources compile claim` / `published` / `review` writes (interactive only)
 - Writing `[[wikilinks]]` to nonexistent pages — verify first
 - Writing raw ephemeral data to cloud-mounted wiki paths
 - Writing live credentials, access keys, tokens, passwords, cookies, bearer headers, private keys, or other authenticating secrets to the vault

package/skills/package.json

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

package/skills/skills/using-skillwiki/SKILL.md

@@ -127,6 +127,8 @@ Also mirror these pointers in vault-presync / vault-sync-status skills when oper
 - typed pages: `skillwiki page publish <draft> <vault> --target <path>` then the same command with `--write`
 - archive: `skillwiki archive <path> <vault>`
 - pending source inventory: `skillwiki sources pending <vault>`
+- attended compile-turn: `skillwiki sources compile claim|release|published|status`
+- post-compile reviews: `skillwiki sources review` / `skillwiki sources reviews`
 - editorial disposition: `skillwiki sources disposition <exact-raw-path> <vault> ...`
 - exceptional raw disposal: `skillwiki sources dispose <exact-raw-path> <vault> --reason ...` then attended `--write --approve <token>`
 - ad-hoc structural log: `skillwiki log-append <vault> --content '<entry>'` (Release A dual-write) or event materialization (Release B)
@@ -226,7 +228,8 @@ for code changes.
 
 ## CLI Backbone
 All skills are backed by the `skillwiki` CLI — a deterministic tool with no LLM calls. It handles path resolution, config management, validation, health reporting, and linting. Skills invoke it via Bash for the mechanical parts and use the active agent for the creative parts.
-Key CLI subcommands: `init`, `health`, `lint`, `config`, `doctor`, `path`, `lang`, `install`, `fleet context`, `fleet validate`, `graph build`, `query`, `sources pending`, `sources disposition`, `sources dispose`, `archive`, `remove`, `drift`, `dedup`, `compound`, `tag-sync`, `tag reconcile`, `page publish`, `sync status`, `seed`, `stale`, `claim`, `claims audit`, `observe`, `canvas generate`.
+Key CLI subcommands: `init`, `health`, `lint`, `config`, `doctor`, `path`, `lang`, `install`, `fleet context`, `fleet validate`, `graph build`, `query`, `vectors rebuild`, `vectors status`, `sources pending`, `sources compile`, `sources review`, `sources reviews`, `sources disposition`, `sources dispose`, `archive`, `remove`, `drift`, `dedup`, `compound`, `tag-sync`, `tag reconcile`, `page publish`, `sync status`, `seed`, `stale`, `claim`, `claims audit`, `observe`, `canvas generate`, `mcp`.
+Optional read-only MCP (`skillwiki mcp`) exposes pending/compile/review list tools. Do not use MCP for compile claim, publish, or review writes.
 `skillwiki claim` binds a transcript to a work item only through an exact `raw/transcripts/...` path in `source:` / `sources:` / `closes:`. A `--project` that contradicts the capture's explicit project is rejected. `skillwiki stale --project` uses exact normalized slugs, not substring matching. `skillwiki claims audit` is the read-only integrity report for duplicate, malformed, dangling, cross-project, and unbacked claims; it never rewrites captures or work items.
 
 Run `skillwiki health <vault> --out /tmp/skillwiki-health.json --no-fail` for a bounded whole-system report that includes the nonblocking source-lifecycle backlog. Pending captures are informational and do not make health fail. Run `skillwiki lint <vault> --summary` for lint-only bucket counts with capped examples and details commands. Run `skillwiki doctor` to diagnose setup/runtime issues only. Run `skillwiki config list` to see current configuration.

package/skills/skills/wiki-freshness-repair/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: wiki-freshness-repair
+description: Repair stale vault sources end to end. Consumes skillwiki drift --affected-pages, re-ingests changed sources through wiki-reingest, then republishes the affected typed pages through the page publish approval flow. Attended only; never auto-repairs.
+---
+
+# wiki-freshness-repair
+
+## When This Skill Activates
+
+- A `skillwiki drift --affected-pages` report lists typed pages citing drifted raw sources and the user wants them repaired.
+- User explicitly asks to repair stale sources or refresh pages that cite changed sources.
+- Attended post-drift maintenance; scheduled/headless runs are report-only.
+
+## Output language
+
+Run `skillwiki lang` at the start. Generate log entries in the resolved language.
+
+## Pre-orientation reads
+
+Standard four reads (SCHEMA, index, log, project context if applicable).
+
+## Input contract
+
+`skillwiki drift --affected-pages [vault]` emits the normal drift report where
+every drifted entry additionally carries `affected_pages: string[]` —
+vault-relative paths of typed pages that cite the drifted raw source (via body
+`^[raw/...]` citation markers and `sources:` frontmatter). An empty array means
+the drifted source has no citing pages: raw-only repair, no republish step.
+
+## Steps
+
+0. Resolve vault: `skillwiki path` and `skillwiki lang`.
+1. Run `skillwiki drift --affected-pages [vault]`. Read the JSON output.
+2. Present findings grouped by status, exactly as wiki-reingest does:
+   - **drifted:** source content changed. Show stored vs current sha256 AND the
+     `affected_pages` list per source.
+   - **identity_conflicts:** STOP and surface; a human chooses the correct
+     source/filename pair before any repair.
+   - **fetch_failed:** show error details.
+   - **unchanged:** no action needed.
+3. Report-only is the default. Present the repair plan: per drifted source, the
+   new capture to create and the affected pages that would be republished.
+4. For each drifted source the user explicitly approves:
+   a. Follow wiki-reingest steps 5a–5c: create the updated content as a NEW raw
+      capture and verify it; preview `skillwiki archive <exact-old-raw-path>`;
+      apply only with the live `--apply --approve <token>` flow. Old bytes move
+      to `raw/archived/<category>/...` and are never rewritten.
+   b. Update maintained citations to the new capture where editorially required.
+   c. For each page in that source's `affected_pages`: re-verify the page
+      against the new capture. If the page content must change, republish ONLY
+      through `skillwiki page publish <draft> <vault> --target <page>`:
+      dry-run first, capture the approval token, then `--write --approve
+      "$token"` in one shell chain. A stale token fails with APPROVAL_INVALID —
+      re-run the dry-run for a fresh token instead of retrying the old one.
+      If the publish returns `held: true`, surface the `hold_reasons`
+      (schema-invalid, broken-wikilink, citation-marker-missing) to the user
+      and stop for that page; never force a held page.
+5. Run `skillwiki audit [vault]` to verify every citation resolves after the
+   repairs.
+6. Append a log entry summarizing: scanned, drifted, repaired (new captures),
+   archived, pages republished, pages skipped/held.
+
+## N9 Compliance
+
+Raw files are immutable (N9). Repairs never modify an existing raw file: the
+old raw is preserve-archived and a new raw capture is created with updated
+content and sha256, preserving full provenance history.
+
+## Hard boundary (third-harvest program)
+
+- This skill is ATTENDED ONLY. Never run repairs from scheduled or headless
+  maintenance; those runs stop after step 3 (the report).
+- The third-harvest program shipped this skill with parse-only validation
+  against a dry-run `drift --affected-pages` report. Zero live repairs were
+  performed as part of program delivery; the first real repair run happens
+  only when the user invokes this skill attended.
+
+## Stop conditions
+
+- `skillwiki drift` returns a non-zero exit code other than DRIFT_DETECTED.
+- User declines all repair actions.
+- A source is listed under `identity_conflicts` (needs a human decision first).
+- Page publish dry-run fails or the publish returns held (surface, do not
+  force).
+
+## Forbidden
+
+- Modifying files in `raw/` directly (N9).
+- Repairing any source without explicit per-source user approval.
+- Writing or editing typed pages directly — always the page publish flow.
+- Retrying `--write --approve` with a stale approval token.
+- Running raw structural apply from scheduled or headless maintenance.
+- Re-ingesting a source whose fetched content contains live credentials or
+  other authenticating secrets (stop and ask, per wiki-reingest).

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

@@ -34,6 +34,14 @@ Run `skillwiki lang` at the start. Generate page-body prose, narrative sections,
 6. **Feature-detect publication.** Run `skillwiki page publish --help`. If unavailable, fail closed and leave typed output unpublished; update the active SkillWiki CLI/plugin channel first.
 7. **Ingest and publish.** Use `skillwiki ingest` for deterministic source capture and typed-page publication. The command writes an immutable raw source first and delegates the typed page, taxonomy, index, and structural log entry to the shared page publisher. Supply the resolved vault, type, title, tags, and provenance through the command options.
 8. **Recovery.** Never create the final typed page or edit index.md/log.md directly. A raw-only result after publication failure is valid recovery state. Keep the exact command inputs and retry; do not delete or overwrite the raw source.
+9. **Pending-compile path** (raw already exists; clipper / `sources pending`). Do **not** run `skillwiki ingest` again — that would create a second raw object. Interactive sessions only:
+   1. `skillwiki sources pending [vault]`
+   2. `skillwiki sources compile claim <raw-path> [vault] --reason "<why>"` then the same command with `--write --approve <token>`
+   3. Read the raw; compose unpublished drafts **outside** the vault
+   4. `skillwiki page publish` each typed page
+   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.
 ## Provenance defaults
 - Default `provenance: research`.
 - If cwd is inside `projects/{slug}/`, set `provenance: project` and add `provenance_projects: ["[[slug]]"]`.

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

@@ -13,7 +13,7 @@ Standard four reads (SCHEMA, index, log, project context if applicable).
 ## Steps
 0. **Resolve vault and language.** Run `skillwiki path` (fail if NO_VAULT_CONFIGURED) and `skillwiki lang`.
 1. **Determine scope.** Ask the user once if ambiguous: vault | current project | project+concepts.
-   - Ordinary questions are typed-knowledge-first. Run `skillwiki query "<text>" [vault]` without widening into raw captures.
+   - Ordinary questions are typed-knowledge-first. Run `skillwiki query "<text>" [vault]` without widening into raw captures. Default ranking is 4-signal only. Optional `skillwiki query "<text>" --hybrid` RRF-fuses that ranking with a rebuildable TF-IDF cache (`skillwiki vectors rebuild`); if the cache is missing, stop and rebuild instead of silently falling back.
    - Explicit freshness language — `new`, `recent`, `fresh`, `clipped`, `raw`, `pending`, `undigested`, `unprocessed`, `not yet ingested`, or `not yet integrated` — requests the pending evidence channel. Run `skillwiki sources pending [vault]` for inventory and `skillwiki query "<text>" [vault] --include-pending` for synthesis support.
 2. **Refresh graph.** If `.skillwiki/graph.json` is missing or older than 24h: `skillwiki graph build <vault>`.
 3. **Compute overlap.** `skillwiki overlap <vault>`.

package/skills/using-skillwiki/SKILL.md

@@ -127,6 +127,8 @@ Also mirror these pointers in vault-presync / vault-sync-status skills when oper
 - typed pages: `skillwiki page publish <draft> <vault> --target <path>` then the same command with `--write`
 - archive: `skillwiki archive <path> <vault>`
 - pending source inventory: `skillwiki sources pending <vault>`
+- attended compile-turn: `skillwiki sources compile claim|release|published|status`
+- post-compile reviews: `skillwiki sources review` / `skillwiki sources reviews`
 - editorial disposition: `skillwiki sources disposition <exact-raw-path> <vault> ...`
 - exceptional raw disposal: `skillwiki sources dispose <exact-raw-path> <vault> --reason ...` then attended `--write --approve <token>`
 - ad-hoc structural log: `skillwiki log-append <vault> --content '<entry>'` (Release A dual-write) or event materialization (Release B)
@@ -226,7 +228,8 @@ for code changes.
 
 ## CLI Backbone
 All skills are backed by the `skillwiki` CLI — a deterministic tool with no LLM calls. It handles path resolution, config management, validation, health reporting, and linting. Skills invoke it via Bash for the mechanical parts and use the active agent for the creative parts.
-Key CLI subcommands: `init`, `health`, `lint`, `config`, `doctor`, `path`, `lang`, `install`, `fleet context`, `fleet validate`, `graph build`, `query`, `sources pending`, `sources disposition`, `sources dispose`, `archive`, `remove`, `drift`, `dedup`, `compound`, `tag-sync`, `tag reconcile`, `page publish`, `sync status`, `seed`, `stale`, `claim`, `claims audit`, `observe`, `canvas generate`.
+Key CLI subcommands: `init`, `health`, `lint`, `config`, `doctor`, `path`, `lang`, `install`, `fleet context`, `fleet validate`, `graph build`, `query`, `vectors rebuild`, `vectors status`, `sources pending`, `sources compile`, `sources review`, `sources reviews`, `sources disposition`, `sources dispose`, `archive`, `remove`, `drift`, `dedup`, `compound`, `tag-sync`, `tag reconcile`, `page publish`, `sync status`, `seed`, `stale`, `claim`, `claims audit`, `observe`, `canvas generate`, `mcp`.
+Optional read-only MCP (`skillwiki mcp`) exposes pending/compile/review list tools. Do not use MCP for compile claim, publish, or review writes.
 `skillwiki claim` binds a transcript to a work item only through an exact `raw/transcripts/...` path in `source:` / `sources:` / `closes:`. A `--project` that contradicts the capture's explicit project is rejected. `skillwiki stale --project` uses exact normalized slugs, not substring matching. `skillwiki claims audit` is the read-only integrity report for duplicate, malformed, dangling, cross-project, and unbacked claims; it never rewrites captures or work items.
 
 Run `skillwiki health <vault> --out /tmp/skillwiki-health.json --no-fail` for a bounded whole-system report that includes the nonblocking source-lifecycle backlog. Pending captures are informational and do not make health fail. Run `skillwiki lint <vault> --summary` for lint-only bucket counts with capped examples and details commands. Run `skillwiki doctor` to diagnose setup/runtime issues only. Run `skillwiki config list` to see current configuration.

package/skills/wiki-freshness-repair/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: wiki-freshness-repair
+description: Repair stale vault sources end to end. Consumes skillwiki drift --affected-pages, re-ingests changed sources through wiki-reingest, then republishes the affected typed pages through the page publish approval flow. Attended only; never auto-repairs.
+---
+
+# wiki-freshness-repair
+
+## When This Skill Activates
+
+- A `skillwiki drift --affected-pages` report lists typed pages citing drifted raw sources and the user wants them repaired.
+- User explicitly asks to repair stale sources or refresh pages that cite changed sources.
+- Attended post-drift maintenance; scheduled/headless runs are report-only.
+
+## Output language
+
+Run `skillwiki lang` at the start. Generate log entries in the resolved language.
+
+## Pre-orientation reads
+
+Standard four reads (SCHEMA, index, log, project context if applicable).
+
+## Input contract
+
+`skillwiki drift --affected-pages [vault]` emits the normal drift report where
+every drifted entry additionally carries `affected_pages: string[]` —
+vault-relative paths of typed pages that cite the drifted raw source (via body
+`^[raw/...]` citation markers and `sources:` frontmatter). An empty array means
+the drifted source has no citing pages: raw-only repair, no republish step.
+
+## Steps
+
+0. Resolve vault: `skillwiki path` and `skillwiki lang`.
+1. Run `skillwiki drift --affected-pages [vault]`. Read the JSON output.
+2. Present findings grouped by status, exactly as wiki-reingest does:
+   - **drifted:** source content changed. Show stored vs current sha256 AND the
+     `affected_pages` list per source.
+   - **identity_conflicts:** STOP and surface; a human chooses the correct
+     source/filename pair before any repair.
+   - **fetch_failed:** show error details.
+   - **unchanged:** no action needed.
+3. Report-only is the default. Present the repair plan: per drifted source, the
+   new capture to create and the affected pages that would be republished.
+4. For each drifted source the user explicitly approves:
+   a. Follow wiki-reingest steps 5a–5c: create the updated content as a NEW raw
+      capture and verify it; preview `skillwiki archive <exact-old-raw-path>`;
+      apply only with the live `--apply --approve <token>` flow. Old bytes move
+      to `raw/archived/<category>/...` and are never rewritten.
+   b. Update maintained citations to the new capture where editorially required.
+   c. For each page in that source's `affected_pages`: re-verify the page
+      against the new capture. If the page content must change, republish ONLY
+      through `skillwiki page publish <draft> <vault> --target <page>`:
+      dry-run first, capture the approval token, then `--write --approve
+      "$token"` in one shell chain. A stale token fails with APPROVAL_INVALID —
+      re-run the dry-run for a fresh token instead of retrying the old one.
+      If the publish returns `held: true`, surface the `hold_reasons`
+      (schema-invalid, broken-wikilink, citation-marker-missing) to the user
+      and stop for that page; never force a held page.
+5. Run `skillwiki audit [vault]` to verify every citation resolves after the
+   repairs.
+6. Append a log entry summarizing: scanned, drifted, repaired (new captures),
+   archived, pages republished, pages skipped/held.
+
+## N9 Compliance
+
+Raw files are immutable (N9). Repairs never modify an existing raw file: the
+old raw is preserve-archived and a new raw capture is created with updated
+content and sha256, preserving full provenance history.
+
+## Hard boundary (third-harvest program)
+
+- This skill is ATTENDED ONLY. Never run repairs from scheduled or headless
+  maintenance; those runs stop after step 3 (the report).
+- The third-harvest program shipped this skill with parse-only validation
+  against a dry-run `drift --affected-pages` report. Zero live repairs were
+  performed as part of program delivery; the first real repair run happens
+  only when the user invokes this skill attended.
+
+## Stop conditions
+
+- `skillwiki drift` returns a non-zero exit code other than DRIFT_DETECTED.
+- User declines all repair actions.
+- A source is listed under `identity_conflicts` (needs a human decision first).
+- Page publish dry-run fails or the publish returns held (surface, do not
+  force).
+
+## Forbidden
+
+- Modifying files in `raw/` directly (N9).
+- Repairing any source without explicit per-source user approval.
+- Writing or editing typed pages directly — always the page publish flow.
+- Retrying `--write --approve` with a stale approval token.
+- Running raw structural apply from scheduled or headless maintenance.
+- Re-ingesting a source whose fetched content contains live credentials or
+  other authenticating secrets (stop and ask, per wiki-reingest).

package/skills/wiki-ingest/SKILL.md

@@ -34,6 +34,14 @@ Run `skillwiki lang` at the start. Generate page-body prose, narrative sections,
 6. **Feature-detect publication.** Run `skillwiki page publish --help`. If unavailable, fail closed and leave typed output unpublished; update the active SkillWiki CLI/plugin channel first.
 7. **Ingest and publish.** Use `skillwiki ingest` for deterministic source capture and typed-page publication. The command writes an immutable raw source first and delegates the typed page, taxonomy, index, and structural log entry to the shared page publisher. Supply the resolved vault, type, title, tags, and provenance through the command options.
 8. **Recovery.** Never create the final typed page or edit index.md/log.md directly. A raw-only result after publication failure is valid recovery state. Keep the exact command inputs and retry; do not delete or overwrite the raw source.
+9. **Pending-compile path** (raw already exists; clipper / `sources pending`). Do **not** run `skillwiki ingest` again — that would create a second raw object. Interactive sessions only:
+   1. `skillwiki sources pending [vault]`
+   2. `skillwiki sources compile claim <raw-path> [vault] --reason "<why>"` then the same command with `--write --approve <token>`
+   3. Read the raw; compose unpublished drafts **outside** the vault
+   4. `skillwiki page publish` each typed page
+   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.
 ## Provenance defaults
 - Default `provenance: research`.
 - If cwd is inside `projects/{slug}/`, set `provenance: project` and add `provenance_projects: ["[[slug]]"]`.

package/skills/wiki-query/SKILL.md

@@ -13,7 +13,7 @@ Standard four reads (SCHEMA, index, log, project context if applicable).
 ## Steps
 0. **Resolve vault and language.** Run `skillwiki path` (fail if NO_VAULT_CONFIGURED) and `skillwiki lang`.
 1. **Determine scope.** Ask the user once if ambiguous: vault | current project | project+concepts.
-   - Ordinary questions are typed-knowledge-first. Run `skillwiki query "<text>" [vault]` without widening into raw captures.
+   - Ordinary questions are typed-knowledge-first. Run `skillwiki query "<text>" [vault]` without widening into raw captures. Default ranking is 4-signal only. Optional `skillwiki query "<text>" --hybrid` RRF-fuses that ranking with a rebuildable TF-IDF cache (`skillwiki vectors rebuild`); if the cache is missing, stop and rebuild instead of silently falling back.
    - Explicit freshness language — `new`, `recent`, `fresh`, `clipped`, `raw`, `pending`, `undigested`, `unprocessed`, `not yet ingested`, or `not yet integrated` — requests the pending evidence channel. Run `skillwiki sources pending [vault]` for inventory and `skillwiki query "<text>" [vault] --include-pending` for synthesis support.
 2. **Refresh graph.** If `.skillwiki/graph.json` is missing or older than 24h: `skillwiki graph build <vault>`.
 3. **Compute overlap.** `skillwiki overlap <vault>`.