skillwiki 0.10.80 → 0.10.81

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

@@ -6285,7 +6285,7 @@ async function runQuery(input) {
     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,
@@ -6296,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);
@@ -6359,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({
@@ -6379,6 +6358,92 @@ function queryCandidates(typedKnowledge, workItems, scope) {
   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;
@@ -6421,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();
@@ -6431,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) {

package/dist/cli.js

@@ -50,7 +50,7 @@ import {
   snapshotterHealthChecks,
   upsertIndexEntry,
   vectorIndexStatus
-} from "./chunk-NX3PJ3NK.js";
+} from "./chunk-G7I34RQW.js";
 import {
   normalizeDistTag,
   readCache,

package/dist/skillwiki-mcp.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runSkillwikiMcpStdio
-} from "./chunk-NX3PJ3NK.js";
+} from "./chunk-G7I34RQW.js";
 import "./chunk-7I2TPIV5.js";
 import "./chunk-KFEOMMWK.js";
 import "./chunk-GPUK2IAW.js";

package/package.json

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