skillwiki 0.10.79 → 0.10.81

package/dist/{chunk-CLF6DZ6C.js → chunk-G7I34RQW.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,17 +6275,17 @@ 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);
     const body = split.ok ? split.data.body : text;
-    const keywordScore = computeKeywordScore(queryTerms, title, tags, body);
+    const keywordScore = computeKeywordScore(queryTerms, title, tags, body, p.relPath);
     pages.push({
       relPath: p.relPath,
       title,
@@ -6242,38 +6296,21 @@ async function runQuery(input) {
       historicalCycle: isHistoricalCyclePage(p.relPath, title)
     });
   }
-  const seedPaths = /* @__PURE__ */ new Set();
-  const operationalSeedPaths = /* @__PURE__ */ new Set();
-  let historicalCyclePageCount = 0;
-  let hasDirectOperationalSeed = false;
-  for (const page of pages) {
-    if (page.historicalCycle) historicalCyclePageCount += 1;
-    if (page.keywordScore <= 0) continue;
-    seedPaths.add(page.relPath);
-    if (!page.historicalCycle) {
-      operationalSeedPaths.add(page.relPath);
-      hasDirectOperationalSeed = true;
-    }
+  let structural;
+  let results;
+  let rankingGuardrails;
+  if (scope === "all") {
+    const rankedWork = rankPages(pages.filter((page) => isWorkPath(page.relPath)), graph, queryTerms);
+    const rankedTyped = rankPages(pages.filter((page) => !isWorkPath(page.relPath)), graph, queryTerms);
+    structural = [...rankedWork.results, ...rankedTyped.results];
+    results = zipMergeScopeResults(rankedWork.results, rankedTyped.results, limit);
+    rankingGuardrails = rankedTyped.rankingGuardrails;
+  } else {
+    const ranked = rankPages(pages, graph, queryTerms);
+    structural = ranked.results;
+    results = structural.slice(0, limit);
+    rankingGuardrails = ranked.rankingGuardrails;
   }
-  const suppressRepetitiveHistoricalCycles = historicalCyclePageCount >= 3 && hasDirectOperationalSeed;
-  const structuralSeedPaths = suppressRepetitiveHistoricalCycles ? operationalSeedPaths : seedPaths;
-  const structural = pages.map((page) => {
-    const sourceOverlap = scoreSourceOverlap(page, pages, structuralSeedPaths);
-    const wikilink = scoreWikilink(page.relPath, structuralSeedPaths, graph);
-    const aa = scoreAdamicAdar(page.relPath, structuralSeedPaths, graph);
-    const typeAffinity = scoreTypeAffinity(page.type, queryTerms);
-    const isSeed = page.keywordScore > 0;
-    const structuralBoost = sourceOverlap * W_SOURCE_OVERLAP + wikilink * W_WIKILINK + aa * W_ADAMIC_ADAR;
-    const composite = isSeed ? page.keywordScore * W_KEYWORD + structuralBoost + typeAffinity * W_TYPE_AFFINITY : structuralBoost * NON_SEED_FACTOR + typeAffinity * W_TYPE_AFFINITY;
-    const guardedComposite = suppressRepetitiveHistoricalCycles && page.historicalCycle ? composite * HISTORICAL_CYCLE_FACTOR : composite;
-    return {
-      path: page.relPath,
-      score: Math.round(guardedComposite * 1e3) / 1e3,
-      title: page.title,
-      type: page.type
-    };
-  }).filter((r) => r.score > 0).sort((a, b) => b.score - a.score || a.path.localeCompare(b.path));
-  let results = structural.slice(0, limit);
   let hybridMeta;
   if (input.hybrid) {
     const index = await loadVectorIndex(input.vault);
@@ -6305,10 +6342,6 @@ async function runQuery(input) {
   }
   const humanHint = results.length === 0 ? pendingSources && pendingSources.length > 0 ? `no matching typed pages found
 ${pendingSources.length} matching pending source(s)` : "no matching pages found" : results.map((r) => `${r.path} (score: ${r.score})`).join("\n");
-  const rankingGuardrails = suppressRepetitiveHistoricalCycles ? {
-    repetitive_historical_cycles_suppressed: true,
-    historical_cycle_page_count: historicalCyclePageCount
-  } : void 0;
   return {
     exitCode: ExitCode.OK,
     result: ok({
@@ -6320,6 +6353,97 @@ ${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 isWorkPath(relPath) {
+  return relPath.includes("/work/");
+}
+var GENERIC_PATH_TERMS = /* @__PURE__ */ new Set([
+  "work",
+  "open",
+  "projects",
+  "spec",
+  "plan",
+  "log",
+  "md",
+  "http",
+  "mcp",
+  "and",
+  "the",
+  "for",
+  "with",
+  "from",
+  "item",
+  "items"
+]);
+function pathSegmentBonus(terms, relPath) {
+  if (!isWorkPath(relPath)) return 0;
+  const segments = new Set(
+    relPath.toLowerCase().split("/").flatMap((part) => {
+      const noExt = part.replace(/\.(md|markdown)$/i, "");
+      return noExt === part ? [part] : [part, noExt];
+    })
+  );
+  let bonus = 0;
+  for (const term of terms) {
+    if (GENERIC_PATH_TERMS.has(term)) continue;
+    if (segments.has(term)) bonus += 100;
+  }
+  return bonus;
+}
+function zipMergeScopeResults(work, typed, limit) {
+  const merged = [];
+  const n = Math.max(work.length, typed.length);
+  for (let i = 0; i < n && merged.length < limit; i++) {
+    if (i < work.length) merged.push(work[i]);
+    if (merged.length >= limit) break;
+    if (i < typed.length) merged.push(typed[i]);
+  }
+  return merged;
+}
+function rankPages(pages, graph, queryTerms) {
+  const seedPaths = /* @__PURE__ */ new Set();
+  const operationalSeedPaths = /* @__PURE__ */ new Set();
+  let historicalCyclePageCount = 0;
+  let hasDirectOperationalSeed = false;
+  for (const page of pages) {
+    if (page.historicalCycle) historicalCyclePageCount += 1;
+    if (page.keywordScore <= 0) continue;
+    seedPaths.add(page.relPath);
+    if (!page.historicalCycle) {
+      operationalSeedPaths.add(page.relPath);
+      hasDirectOperationalSeed = true;
+    }
+  }
+  const suppressRepetitiveHistoricalCycles = historicalCyclePageCount >= 3 && hasDirectOperationalSeed;
+  const structuralSeedPaths = suppressRepetitiveHistoricalCycles ? operationalSeedPaths : seedPaths;
+  const results = pages.map((page) => {
+    const sourceOverlap = scoreSourceOverlap(page, pages, structuralSeedPaths);
+    const wikilink = scoreWikilink(page.relPath, structuralSeedPaths, graph);
+    const aa = scoreAdamicAdar(page.relPath, structuralSeedPaths, graph);
+    const typeAffinity = scoreTypeAffinity(page.type, queryTerms);
+    const isSeed = page.keywordScore > 0;
+    const structuralBoost = sourceOverlap * W_SOURCE_OVERLAP + wikilink * W_WIKILINK + aa * W_ADAMIC_ADAR;
+    const composite = isSeed ? page.keywordScore * W_KEYWORD + structuralBoost + typeAffinity * W_TYPE_AFFINITY : structuralBoost * NON_SEED_FACTOR + typeAffinity * W_TYPE_AFFINITY;
+    const guardedComposite = suppressRepetitiveHistoricalCycles && page.historicalCycle ? composite * HISTORICAL_CYCLE_FACTOR : composite;
+    return {
+      path: page.relPath,
+      score: Math.round(guardedComposite * 1e3) / 1e3,
+      title: page.title,
+      type: page.type
+    };
+  }).filter((r) => r.score > 0).sort((a, b) => b.score - a.score || a.path.localeCompare(b.path));
+  return {
+    results,
+    rankingGuardrails: suppressRepetitiveHistoricalCycles ? {
+      repetitive_historical_cycles_suppressed: true,
+      historical_cycle_page_count: historicalCyclePageCount
+    } : void 0
+  };
+}
 function scoreSourceOverlap(page, allPages, seedPaths) {
   if (page.sources.length === 0) return 0;
   let total = 0;
@@ -6362,7 +6486,7 @@ function isHistoricalCyclePage(relPath, title) {
 function tokenize2(text) {
   return text.toLowerCase().split(/\s+/).filter((t) => t.length > 0);
 }
-function computeKeywordScore(terms, title, tags, body) {
+function computeKeywordScore(terms, title, tags, body, relPath) {
   const lowerTitle = title.toLowerCase();
   const lowerTags = tags.map((t) => t.toLowerCase());
   const lowerBody = body.toLowerCase();
@@ -6372,6 +6496,7 @@ function computeKeywordScore(terms, title, tags, body) {
     if (lowerTags.some((t) => t.includes(term))) score += 2;
     if (lowerBody.includes(term)) score += 1;
   }
+  if (relPath) score += pathSegmentBonus(terms, relPath);
   return score;
 }
 async function loadOrBuildGraph(vault) {
@@ -6601,17 +6726,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/{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/cli.js

@@ -50,7 +50,7 @@ import {
   snapshotterHealthChecks,
   upsertIndexEntry,
   vectorIndexStatus
-} from "./chunk-CLF6DZ6C.js";
+} from "./chunk-G7I34RQW.js";
 import {
   normalizeDistTag,
   readCache,
@@ -151,7 +151,7 @@ import {
   supersedeStaleReviewRequiredJournals,
   taxonomyCommentForPage,
   writeDotenv
-} from "./chunk-5XT6MBWA.js";
+} from "./chunk-GPUK2IAW.js";
 import {
   assertTargetInsideVault,
   atomicWriteText,
@@ -10559,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,
@@ -10608,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({
@@ -10616,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-G7I34RQW.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.79",
+  "version": "0.10.81",
   "type": "module",
   "bin": {
     "skillwiki": "dist/cli.js",

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

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.10.79",
+  "version": "0.10.81",
   "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.79",
+  "version": "0.10.81",
   "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.79",
+  "version": "0.10.81",
   "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.79",
+  "version": "0.10.81",
   "private": true,
   "files": [
     "wiki-*",

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

@@ -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 |
@@ -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/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

@@ -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 |
@@ -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/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>`.