skillwiki 0.10.78 → 0.10.80

package/dist/{chunk-5XT6MBWA.js → chunk-GPUK2IAW.js}

@@ -3304,7 +3304,7 @@ function buildCliSurface() {
   program.command("canvas");
   program.command("eval").option("--base <git-ref>").option("--top <n>").option("--wiki <name>");
   program.command("overlap").option("--wiki <name>");
-  program.command("query").option("--limit <n>").option("--include-pending").option("--hybrid").option("--wiki <name>");
+  program.command("query").option("--limit <n>").option("--include-pending").option("--scope <scope>").option("--hybrid").option("--wiki <name>");
   program.command("vectors");
   program.command("sources");
   program.command("orphans").option("--wiki <name>");

package/dist/{chunk-CLF6DZ6C.js → chunk-NX3PJ3NK.js}

@@ -40,7 +40,7 @@ import {
   snapshotterAliasForLocalHost,
   toUndirectedWeighted,
   writeDotenv
-} from "./chunk-5XT6MBWA.js";
+} from "./chunk-GPUK2IAW.js";
 import {
   atomicWriteText,
   prepareTypedPage
@@ -1125,8 +1125,46 @@ function findPluginInstallations(home, key = PLUGIN_KEY) {
   }
   const codexPlugin = findCodexPlugin(home, key, parsed.pluginName, parsed.marketplace);
   if (codexPlugin) installs.push(codexPlugin);
+  const grokPlugin = findGrokPlugin(home, key, parsed.pluginName, parsed.marketplace);
+  if (grokPlugin) installs.push(grokPlugin);
   return installs;
 }
+function findGrokPlugin(home, key, pluginName, marketplace) {
+  const pluginsRoot = join6(home, ".grok", "installed-plugins");
+  if (!existsSync3(pluginsRoot)) return null;
+  let entries;
+  try {
+    entries = readdirSync(pluginsRoot, { withFileTypes: true });
+  } catch {
+    return null;
+  }
+  let best = null;
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const installPath = join6(pluginsRoot, entry.name);
+    let manifest;
+    try {
+      manifest = JSON.parse(readFileSync2(join6(installPath, ".claude-plugin", "plugin.json"), "utf8"));
+    } catch {
+      continue;
+    }
+    if (manifest.name !== pluginName) continue;
+    if (typeof manifest.version !== "string" || manifest.version.length === 0) continue;
+    const candidate = {
+      channel: "grok",
+      label: "Grok",
+      key,
+      pluginName,
+      marketplace,
+      installPath,
+      version: manifest.version
+    };
+    if (!best || semverGt(candidate.version, best.version)) {
+      best = candidate;
+    }
+  }
+  return best;
+}
 function findCodexPlugin(home, key, pluginName, marketplace) {
   const config = readCodexPluginConfig(home, key, marketplace);
   if (!config?.enabled) return null;
@@ -2676,6 +2714,9 @@ function pluginUpdateCommand(plugin, currentVersion) {
   if (plugin.channel === "claude") {
     return "claude plugin update skillwiki@llm-wiki";
   }
+  if (plugin.channel === "grok") {
+    return "grok plugin update skillwiki";
+  }
   if (plugin.sourceType === "git") {
     return "codex plugin marketplace upgrade llm-wiki && codex plugin remove skillwiki@llm-wiki && codex plugin add skillwiki@llm-wiki";
   }
@@ -6208,11 +6249,24 @@ var CONCEPT_INDICATORS = /* @__PURE__ */ new Set([
   "model",
   "definition"
 ]);
+function resolveQueryScope(value) {
+  const scope = value ?? "typed";
+  if (scope === "typed" || scope === "work" || scope === "all") return scope;
+  return null;
+}
 async function runQuery(input) {
   const scan = await scanVault(input.vault);
   if (!scan.ok) return { exitCode: ExitCode.VAULT_PATH_INVALID, result: scan };
+  const scope = resolveQueryScope(input.scope);
+  if (!scope) {
+    return {
+      exitCode: ExitCode.USAGE,
+      result: err("USAGE", { message: "scope must be typed, work, or all" })
+    };
+  }
   const limit = input.limit ?? 10;
   const queryTerms = tokenize2(input.text);
+  const candidates = queryCandidates(scan.data.typedKnowledge, scan.data.workItems, scope);
   if (queryTerms.length === 0) {
     return {
       exitCode: ExitCode.OK,
@@ -6221,12 +6275,12 @@ async function runQuery(input) {
   }
   const graph = await loadOrBuildGraph(input.vault);
   const pages = [];
-  for (const p of scan.data.typedKnowledge) {
+  for (const p of candidates) {
     const text = await readPage(p);
     const fm = extractFrontmatter(text);
     if (!fm.ok) continue;
     const title = String(fm.data.title ?? "");
-    const type = String(fm.data.type ?? "");
+    const type = String(fm.data.type ?? (p.relPath.includes("/work/") ? "work" : ""));
     const tags = Array.isArray(fm.data.tags) ? fm.data.tags.map(String) : [];
     const sources = Array.isArray(fm.data.sources) ? fm.data.sources.map(String) : [];
     const split = splitFrontmatter(text);
@@ -6320,6 +6374,11 @@ ${pendingSources.length} matching pending source(s)` : "no matching pages found"
     })
   };
 }
+function queryCandidates(typedKnowledge, workItems, scope) {
+  if (scope === "work") return workItems;
+  if (scope === "all") return [...typedKnowledge, ...workItems];
+  return typedKnowledge;
+}
 function scoreSourceOverlap(page, allPages, seedPaths) {
   if (page.sources.length === 0) return 0;
   let total = 0;
@@ -6601,17 +6660,18 @@ function registerMcpTools(server) {
   server.registerTool(
     "skillwiki.query",
     {
-      description: "Ranked vault query over typed knowledge (read-only). Returns Result envelope JSON.",
+      description: "Ranked vault query. Default scope is typed knowledge. Use scope=work or all for Layer-3 work items. Returns Result envelope JSON.",
       inputSchema: z.object({
         ...vaultFields,
         text: z.string().min(1).describe("Query text"),
-        limit: z.number().int().positive().optional().describe("Max results (default 10)")
+        limit: z.number().int().positive().optional().describe("Max results (default 10)"),
+        scope: z.enum(["typed", "work", "all"]).optional().describe("typed (default), work, or all")
       })
     },
-    async ({ vault, wiki, text, limit }) => runMcpToolHandler("skillwiki.query", { vault, wiki }, async () => {
+    async ({ vault, wiki, text, limit, scope }) => runMcpToolHandler("skillwiki.query", { vault, wiki }, async () => {
       const v = await resolveMcpVault({ vault, wiki });
       if (!v.ok) return formatToolResult({ exitCode: 25, result: v });
-      const r = await runQuery({ vault: v.data.vault, text, limit });
+      const r = await runQuery({ vault: v.data.vault, text, limit, scope });
       return formatToolResult(r);
     })
   );

package/dist/cli.js

@@ -50,7 +50,7 @@ import {
   snapshotterHealthChecks,
   upsertIndexEntry,
   vectorIndexStatus
-} from "./chunk-CLF6DZ6C.js";
+} from "./chunk-NX3PJ3NK.js";
 import {
   normalizeDistTag,
   readCache,
@@ -151,7 +151,7 @@ import {
   supersedeStaleReviewRequiredJournals,
   taxonomyCommentForPage,
   writeDotenv
-} from "./chunk-5XT6MBWA.js";
+} from "./chunk-GPUK2IAW.js";
 import {
   assertTargetInsideVault,
   atomicWriteText,
@@ -1456,13 +1456,13 @@ function mergeLogConflictStages(input) {
   const out = [];
   const deduped = [];
   const push = (entry) => {
-    const marker2 = publishId(entry);
-    if (marker2) {
-      if (seenMarkers.has(marker2)) {
-        deduped.push(marker2);
+    const marker = publishId(entry);
+    if (marker) {
+      if (seenMarkers.has(marker)) {
+        deduped.push(marker);
         return;
       }
-      seenMarkers.add(marker2);
+      seenMarkers.add(marker);
     } else if (seenExact.has(entry)) {
       return;
     } else {
@@ -1768,10 +1768,27 @@ import { join as join10 } from "path";
 function day(event) {
   return event.occurred_at.slice(0, 10);
 }
-function marker(event) {
+function renderLogEventMarker(event) {
   return `<!-- skillwiki-log-event:${event.operation_id} -->`;
 }
-function bodyFor(event) {
+function verbatimField(event) {
+  if (event.kind === "legacy-log-entry" && typeof event.metadata.legacy_markdown === "string") {
+    return event.metadata.legacy_markdown;
+  }
+  if (event.kind === "log-append" && typeof event.metadata.appended_markdown === "string") {
+    return event.metadata.appended_markdown;
+  }
+  return void 0;
+}
+function verbatimMarkdown(raw, event) {
+  const text = raw.trimEnd();
+  const mark = renderLogEventMarker(event);
+  return text.includes(mark) ? text : `${text}
+${mark}`;
+}
+function renderLogEventBody(event) {
+  const raw = verbatimField(event);
+  if (raw !== void 0) return verbatimMarkdown(raw, event);
   if (event.kind === "page-publish" || event.kind === "project-page-publish") {
     const tax = Array.isArray(event.metadata.taxonomy_added) ? event.metadata.taxonomy_added : [];
     const project = typeof event.metadata.project === "string" ? event.metadata.project : void 0;
@@ -1782,12 +1799,6 @@ function bodyFor(event) {
       event.note ? `- Note: ${event.note}` : ""
     ].filter(Boolean).join("\n");
   }
-  if (event.kind === "legacy-log-entry" && typeof event.metadata.legacy_markdown === "string") {
-    const legacy = event.metadata.legacy_markdown.trimEnd();
-    if (legacy.includes(marker(event))) return legacy;
-    return `${legacy}
-${marker(event)}`;
-  }
   if (event.kind === "session-brief" || event.kind === "archive" || event.kind === "remove" || event.kind === "log-entry") {
     return [
       `- Target: ${event.target}`,
@@ -1817,12 +1828,18 @@ function renderLogProjection(events) {
     ""
   ];
   for (const event of ordered) {
-    if (event.kind === "legacy-log-entry" && typeof event.metadata.legacy_markdown === "string") {
-      const block = bodyFor(event);
+    if (verbatimField(event) !== void 0) {
+      const block = renderLogEventBody(event);
       lines.push(block.endsWith("\n") ? block.trimEnd() : block, "");
       continue;
     }
-    lines.push(`## [${day(event)}] ${event.kind} | ${event.target}`, "", bodyFor(event), marker(event), "");
+    lines.push(
+      `## [${day(event)}] ${event.kind} | ${event.target}`,
+      "",
+      renderLogEventBody(event),
+      renderLogEventMarker(event),
+      ""
+    );
   }
   return `${lines.join("\n").replace(/\n+$/, "")}
 `;
@@ -6292,8 +6309,8 @@ async function runPipelinePreview(strategy, prepared, vault) {
   let logAppended;
   try {
     const logText = await readFile13(logPath, "utf8");
-    const marker2 = strategy.publisherKind === "page" ? `<!-- skillwiki-page-publish:${prepared.operationId} -->` : `<!-- skillwiki-project-page-publish:${prepared.operationId} -->`;
-    logAppended = !logText.includes(marker2);
+    const marker = strategy.publisherKind === "page" ? `<!-- skillwiki-page-publish:${prepared.operationId} -->` : `<!-- skillwiki-project-page-publish:${prepared.operationId} -->`;
+    logAppended = !logText.includes(marker);
   } catch (error) {
     const result = err("FILE_NOT_FOUND", { path: logPath, ...strategy.publisherKind === "page" ? { message: String(error) } : {} });
     return { exitCode: ExitCode.FILE_NOT_FOUND, result };
@@ -10542,7 +10559,7 @@ async function emitManagedVaultWrite(vault, command, mutate, opts) {
   if (dirty) {
     return emit(dirty, void 0, { postCommit: false });
   }
-  const { runManagedWriteTransaction: runManagedWriteTransaction2 } = await import("./managed-write-preflight-LSG2Y24X.js");
+  const { runManagedWriteTransaction: runManagedWriteTransaction2 } = await import("./managed-write-preflight-DEPLZAA6.js");
   const run = await runManagedWriteTransaction2({
     vault,
     command,
@@ -10591,7 +10608,7 @@ program.command("overlap [vault]").description("detect typed-knowledge pages tha
   if (!v.ok) emit({ exitCode: v.exitCode, result: v.payload });
   else emit(await runOverlap({ vault: v.vault }), v.vault);
 });
-program.command("query <text> [vault]").description("score and rank vault pages by relevance to a query").option("--limit <n>", "max results to return", (s) => parseInt(s, 10), 10).option("--include-pending", "include a separate pending-evidence channel").option("--hybrid", "RRF-fuse 4-signal ranks with the local TF-IDF cache").option("--wiki <name>", "wiki profile name").action(async (text, vault, opts) => {
+program.command("query <text> [vault]").description("score and rank vault pages by relevance to a query").option("--limit <n>", "max results to return", (s) => parseInt(s, 10), 10).option("--include-pending", "include a separate pending-evidence channel").option("--scope <scope>", "typed, work, or all (default typed)").option("--hybrid", "RRF-fuse 4-signal ranks with the local TF-IDF cache").option("--wiki <name>", "wiki profile name").action(async (text, vault, opts) => {
   const v = await resolveVaultArg(vault, opts.wiki);
   if (!v.ok) emit({ exitCode: v.exitCode, result: v.payload });
   else emit(await runQuery({
@@ -10599,7 +10616,8 @@ program.command("query <text> [vault]").description("score and rank vault pages
     vault: v.vault,
     limit: opts.limit,
     includePending: opts.includePending,
-    hybrid: opts.hybrid
+    hybrid: opts.hybrid,
+    scope: opts.scope
   }), v.vault, { postCommit: false });
 });
 var sourcesCmd = program.command("sources").description("inspect raw-source lifecycle state");

package/dist/{managed-write-preflight-LSG2Y24X.js → managed-write-preflight-DEPLZAA6.js}

@@ -6,7 +6,7 @@ import {
   runManagedWritePeerGate,
   runManagedWritePreflight,
   runManagedWriteTransaction
-} from "./chunk-5XT6MBWA.js";
+} from "./chunk-GPUK2IAW.js";
 import "./chunk-BPJ5KWIT.js";
 import "./chunk-OMO45AHI.js";
 import "./chunk-HJ4ALQG6.js";

package/dist/skillwiki-mcp.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   runSkillwikiMcpStdio
-} from "./chunk-CLF6DZ6C.js";
+} from "./chunk-NX3PJ3NK.js";
 import "./chunk-7I2TPIV5.js";
 import "./chunk-KFEOMMWK.js";
-import "./chunk-5XT6MBWA.js";
+import "./chunk-GPUK2IAW.js";
 import "./chunk-BPJ5KWIT.js";
 import "./chunk-NPTIYO2S.js";
 import "./chunk-OMO45AHI.js";

package/package.json

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

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

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

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

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.10.78",
+  "version": "0.10.80",
   "description": "Project-aware Karpathy-style knowledge base for Codex with 21 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.78",
+  "version": "0.10.80",
   "description": "Project-aware Karpathy-style knowledge base: 21 prompt-only skills (wiki-*, proj-*, using-skillwiki, skillwiki-mcp) backed by HTTP MCP wiki_capture.",
   "author": {
     "name": "karlorz"

package/skills/package.json

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

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

@@ -33,7 +33,7 @@ Remotes still on a pre-HTTP-MCP plugin or CLI must upgrade the plugin channel (a
 On leaf hosts, wiki captures go through MCP. Do **not** write `raw/transcripts/` or `log.md` as local files.
 
 1. Call MCP `wiki_capture` with `kind` (`task` | `idea` | `bug` | `note`), `project`, `title`, and `content`. Optional `agent_note`.
-2. Call MCP `wiki_log_append` when a structural `log.md` line is needed. Pass append-only `content`. Do not rewrite log history.
+2. Call MCP `wiki_log_append` when a structural `log.md` line is needed. Pass append-only `content` (optional `operation_id` is 64 hex). Success returns a receipt (`operation_id`, `event_path`, hashes, `s3_verified`). Verify the exact block via `wiki_read_page(event_path)`. Do not require reading `log.md`. If `log.md` is over 256 KiB, full `wiki_read_page("log.md")` returns `PAGE_TOO_LARGE`; use `tail_bytes` only to browse the newest end.
 3. **Feature-detect work-item and page-publish tools**:
    - When the server advertises `wiki_workitem_write`: use it to create, mutate, or close work items under `projects/<slug>/work/**` or update `projects/<slug>/knowledge.md`, and to save Layer-3 workspace markdown: `projects/<slug>/README.md`, `projects/<slug>/architecture/**/*.md`, `projects/<slug>/requirements/**/*.md`, `projects/<slug>/compound/**/*.md`. Pass `path`, `content`, and `base_sha256` of existing bytes (from `wiki_read_page` or local mirror). On `FILE_CHANGED`, re-read and retry once. Deployed servers that predate the workspace-family allowlist deny those paths — treat that `PATH_DENIED` as "server predates this release"; STOP, do not fall back.
    - When the server advertises `wiki_page_publish`: use it to publish typed Layer-2 pages (`entities/`, `concepts/`, `comparisons/`, `queries/`, `meta/`) using the same CAS protocol.
@@ -44,6 +44,8 @@ On leaf hosts, wiki captures go through MCP. Do **not** write `raw/transcripts/`
 
 Local `~/wiki` (or `skillwiki path`) is fine for reads. MCP read tools are optional. Prefer ordinary file reads of the local mirror.
 
+`wiki_query` is typed knowledge only unless `scope` is `work` or `all`. For queued work, doctor, plugin-drift, or MCP diagnose questions, call `wiki_context` first (active_work) or pass `scope: "work"` / `"all"`. Do not treat a top typed packet hit as the live work queue.
+
 ## Errors
 
 Report handshake, capture, and append failures literally. If tools are missing after a 401 or `missing_prereq`, stop and tell the operator to export `SKILLWIKI_MCP_TOKEN`, run `grok plugin update skillwiki`, and start a new session. Do not fall back to local `raw/transcripts/` writes.

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

@@ -184,7 +184,7 @@ If the vault has `.WIKI_GIT_FROZEN`:
 |-------|----------------|
 | `wiki-init` | Bootstrap a vault and install `_Templates/web-clipper/llm-wiki-clippings.json` plus import guidance |
 | `wiki-ingest` | Convert URLs, files, or pasted text into typed-knowledge pages |
-| `wiki-query` | Search typed knowledge by default; explicitly requested fresh/raw evidence uses the separate pending channel |
+| `wiki-query` | Search typed knowledge by default; work-queue / doctor / MCP diagnose questions use `wiki_context` or `--scope work` / `--scope all`; explicitly requested fresh/raw evidence uses the separate pending channel |
 | `wiki-lint` | Vault health and lint checks; use `health` for whole-system reports and `lint --summary` for bounded lint buckets |
 | `wiki-crystallize` | Distill the current working session into a typed-knowledge page |
 | `wiki-audit` | Verify raw provenance references and source frontmatter integrity |
@@ -192,7 +192,7 @@ If the vault has `.WIKI_GIT_FROZEN`:
 | `wiki-remove` | Remove maintained pages; exact raw disposal uses the separate attended `sources dispose` flow |
 | `wiki-reingest` | Detect drift in raw sources (sha256 comparison) and re-ingest updated content |
 | `wiki-add-task` | Quick-capture ideas, bugs, tasks, notes (captures via wiki_capture on leaf hosts; local raw/transcripts/ only on authoring hosts) |
-| `skillwiki-mcp` | HTTP MCP captures (`wiki_capture` / `wiki_log_append`); never local raw/transcripts on leaf hosts |
+| `skillwiki-mcp` | HTTP MCP captures (`wiki_capture` / `wiki_log_append`); never local raw/transcripts on leaf hosts. `wiki_log_append` returns a receipt; verify via `wiki_read_page(event_path)`. Use `wiki_read_page` `tail_bytes` to browse oversized `log.md`. |
 | `wiki-adapter-prd` | Map foreign PRD formats (CodeStable, RFC, AIDE, Hermes) into vault pages |
 | `proj-init` | Bootstrap a project workspace (README, requirements, architecture) |
 | `proj-work` | Open or run a work item under a project's work/ directory |
@@ -286,7 +286,7 @@ Before asking questions or running scheduled maintenance, resolve the session ki
 ## Typical Workflow
 1. **Init** (`wiki-init`) — create vault, set domain and taxonomy
 2. **Ingest** (`wiki-ingest`) — add sources, build pages
-3. **Query** (`wiki-query`) — search typed knowledge; explicitly include pending captures for fresh/raw intent
+3. **Query** (`wiki-query`) — search typed knowledge; work-queue / doctor / MCP questions use `wiki_context` or `--scope work` / `--scope all`; explicitly include pending captures for fresh/raw intent
 4. **Lint** (`wiki-lint`) — periodic health checks
 5. **Crystallize** (`wiki-crystallize`) — save session insights as pages
 6. **Audit** (`wiki-audit`) — verify source integrity

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

@@ -80,7 +80,7 @@ Mutating tools (wiki_workitem_write, wiki_page_publish) enforce CAS concurrency
 
 ### Capture Kinds
 Ad-hoc records via wiki_capture require kind in: task | idea | bug | note.
-Captures append remotely to raw/transcripts/ and never overwrite existing files. Use wiki_log_append for append-only log entries.
+Captures append remotely to raw/transcripts/ and never overwrite existing files. Use wiki_log_append for append-only log entries. Success returns a receipt; verify via wiki_read_page(event_path). Do not require reading log.md. wiki_read_page accepts optional tail_bytes for browsing oversized pages.
 
 ### Sensitive Content
 Never send credentials, API keys, auth tokens, passwords, or PII. Redact sensitive values using [REDACTED:<kind>] (e.g. [REDACTED:token]) before writing.

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

@@ -14,6 +14,7 @@ Standard four reads (SCHEMA, index, log, project context if applicable).
 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. 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.
+   - Setup, MCP, doctor, plugin-drift, or "open work" questions are not typed-knowledge searches. Call `wiki_context` (active_work) or `skillwiki query "<text>" --scope work` / `--scope all`. Default typed query never ranks `projects/*/work`.
    - 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/skillwiki-mcp/SKILL.md

@@ -33,7 +33,7 @@ Remotes still on a pre-HTTP-MCP plugin or CLI must upgrade the plugin channel (a
 On leaf hosts, wiki captures go through MCP. Do **not** write `raw/transcripts/` or `log.md` as local files.
 
 1. Call MCP `wiki_capture` with `kind` (`task` | `idea` | `bug` | `note`), `project`, `title`, and `content`. Optional `agent_note`.
-2. Call MCP `wiki_log_append` when a structural `log.md` line is needed. Pass append-only `content`. Do not rewrite log history.
+2. Call MCP `wiki_log_append` when a structural `log.md` line is needed. Pass append-only `content` (optional `operation_id` is 64 hex). Success returns a receipt (`operation_id`, `event_path`, hashes, `s3_verified`). Verify the exact block via `wiki_read_page(event_path)`. Do not require reading `log.md`. If `log.md` is over 256 KiB, full `wiki_read_page("log.md")` returns `PAGE_TOO_LARGE`; use `tail_bytes` only to browse the newest end.
 3. **Feature-detect work-item and page-publish tools**:
    - When the server advertises `wiki_workitem_write`: use it to create, mutate, or close work items under `projects/<slug>/work/**` or update `projects/<slug>/knowledge.md`, and to save Layer-3 workspace markdown: `projects/<slug>/README.md`, `projects/<slug>/architecture/**/*.md`, `projects/<slug>/requirements/**/*.md`, `projects/<slug>/compound/**/*.md`. Pass `path`, `content`, and `base_sha256` of existing bytes (from `wiki_read_page` or local mirror). On `FILE_CHANGED`, re-read and retry once. Deployed servers that predate the workspace-family allowlist deny those paths — treat that `PATH_DENIED` as "server predates this release"; STOP, do not fall back.
    - When the server advertises `wiki_page_publish`: use it to publish typed Layer-2 pages (`entities/`, `concepts/`, `comparisons/`, `queries/`, `meta/`) using the same CAS protocol.
@@ -44,6 +44,8 @@ On leaf hosts, wiki captures go through MCP. Do **not** write `raw/transcripts/`
 
 Local `~/wiki` (or `skillwiki path`) is fine for reads. MCP read tools are optional. Prefer ordinary file reads of the local mirror.
 
+`wiki_query` is typed knowledge only unless `scope` is `work` or `all`. For queued work, doctor, plugin-drift, or MCP diagnose questions, call `wiki_context` first (active_work) or pass `scope: "work"` / `"all"`. Do not treat a top typed packet hit as the live work queue.
+
 ## Errors
 
 Report handshake, capture, and append failures literally. If tools are missing after a 401 or `missing_prereq`, stop and tell the operator to export `SKILLWIKI_MCP_TOKEN`, run `grok plugin update skillwiki`, and start a new session. Do not fall back to local `raw/transcripts/` writes.

package/skills/using-skillwiki/SKILL.md

@@ -184,7 +184,7 @@ If the vault has `.WIKI_GIT_FROZEN`:
 |-------|----------------|
 | `wiki-init` | Bootstrap a vault and install `_Templates/web-clipper/llm-wiki-clippings.json` plus import guidance |
 | `wiki-ingest` | Convert URLs, files, or pasted text into typed-knowledge pages |
-| `wiki-query` | Search typed knowledge by default; explicitly requested fresh/raw evidence uses the separate pending channel |
+| `wiki-query` | Search typed knowledge by default; work-queue / doctor / MCP diagnose questions use `wiki_context` or `--scope work` / `--scope all`; explicitly requested fresh/raw evidence uses the separate pending channel |
 | `wiki-lint` | Vault health and lint checks; use `health` for whole-system reports and `lint --summary` for bounded lint buckets |
 | `wiki-crystallize` | Distill the current working session into a typed-knowledge page |
 | `wiki-audit` | Verify raw provenance references and source frontmatter integrity |
@@ -192,7 +192,7 @@ If the vault has `.WIKI_GIT_FROZEN`:
 | `wiki-remove` | Remove maintained pages; exact raw disposal uses the separate attended `sources dispose` flow |
 | `wiki-reingest` | Detect drift in raw sources (sha256 comparison) and re-ingest updated content |
 | `wiki-add-task` | Quick-capture ideas, bugs, tasks, notes (captures via wiki_capture on leaf hosts; local raw/transcripts/ only on authoring hosts) |
-| `skillwiki-mcp` | HTTP MCP captures (`wiki_capture` / `wiki_log_append`); never local raw/transcripts on leaf hosts |
+| `skillwiki-mcp` | HTTP MCP captures (`wiki_capture` / `wiki_log_append`); never local raw/transcripts on leaf hosts. `wiki_log_append` returns a receipt; verify via `wiki_read_page(event_path)`. Use `wiki_read_page` `tail_bytes` to browse oversized `log.md`. |
 | `wiki-adapter-prd` | Map foreign PRD formats (CodeStable, RFC, AIDE, Hermes) into vault pages |
 | `proj-init` | Bootstrap a project workspace (README, requirements, architecture) |
 | `proj-work` | Open or run a work item under a project's work/ directory |
@@ -286,7 +286,7 @@ Before asking questions or running scheduled maintenance, resolve the session ki
 ## Typical Workflow
 1. **Init** (`wiki-init`) — create vault, set domain and taxonomy
 2. **Ingest** (`wiki-ingest`) — add sources, build pages
-3. **Query** (`wiki-query`) — search typed knowledge; explicitly include pending captures for fresh/raw intent
+3. **Query** (`wiki-query`) — search typed knowledge; work-queue / doctor / MCP questions use `wiki_context` or `--scope work` / `--scope all`; explicitly include pending captures for fresh/raw intent
 4. **Lint** (`wiki-lint`) — periodic health checks
 5. **Crystallize** (`wiki-crystallize`) — save session insights as pages
 6. **Audit** (`wiki-audit`) — verify source integrity

package/skills/using-skillwiki/activation.md

@@ -80,7 +80,7 @@ Mutating tools (wiki_workitem_write, wiki_page_publish) enforce CAS concurrency
 
 ### Capture Kinds
 Ad-hoc records via wiki_capture require kind in: task | idea | bug | note.
-Captures append remotely to raw/transcripts/ and never overwrite existing files. Use wiki_log_append for append-only log entries.
+Captures append remotely to raw/transcripts/ and never overwrite existing files. Use wiki_log_append for append-only log entries. Success returns a receipt; verify via wiki_read_page(event_path). Do not require reading log.md. wiki_read_page accepts optional tail_bytes for browsing oversized pages.
 
 ### Sensitive Content
 Never send credentials, API keys, auth tokens, passwords, or PII. Redact sensitive values using [REDACTED:<kind>] (e.g. [REDACTED:token]) before writing.

package/skills/wiki-query/SKILL.md

@@ -14,6 +14,7 @@ Standard four reads (SCHEMA, index, log, project context if applicable).
 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. 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.
+   - Setup, MCP, doctor, plugin-drift, or "open work" questions are not typed-knowledge searches. Call `wiki_context` (active_work) or `skillwiki query "<text>" --scope work` / `--scope all`. Default typed query never ranks `projects/*/work`.
    - 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>`.