skillwiki 0.10.1 → 0.10.2

package/dist/{chunk-IZABIE44.js → chunk-U34B2XQJ.js}

@@ -9,8 +9,7 @@ import {
 } from "./chunk-C5OLZRRM.js";
 
 // src/utils/index-projection.ts
-import { readdirSync, readFileSync as readFileSync2 } from "fs";
-import { readFile as readFile3 } from "fs/promises";
+import { readFile as readFile4 } from "fs/promises";
 import { join as join3 } from "path";
 
 // src/utils/atomic-write.ts
@@ -59,6 +58,9 @@ async function atomicWriteText(path, text) {
   }
 }
 
+// src/utils/index-universe.ts
+import { readFile as readFile3 } from "fs/promises";
+
 // src/utils/typed-page.ts
 import { lstatSync, realpathSync } from "fs";
 import { dirname as dirname2, posix, relative, resolve, sep } from "path";
@@ -440,8 +442,15 @@ async function readPageCached(p, cache) {
   return pending;
 }
 
-// src/utils/index-projection.ts
-var SECTION_ORDER = ["Entities", "Concepts", "Comparisons", "Queries", "Meta", "Projects"];
+// src/utils/index-universe.ts
+var ROOT_INDEX_SECTION_ORDER = [
+  "Entities",
+  "Concepts",
+  "Comparisons",
+  "Queries",
+  "Meta",
+  "Projects"
+];
 var TYPE_SECTION = {
   entity: "Entities",
   concept: "Concepts",
@@ -450,6 +459,106 @@ var TYPE_SECTION = {
   meta: "Meta"
 };
 var compareText = (a, b) => a < b ? -1 : a > b ? 1 : 0;
+function projectTitleFromReadme(text, slug) {
+  const match = text.match(/^#\s+Project:\s+(.+)$/m);
+  return match?.[1]?.trim() || slug;
+}
+async function buildRootIndexUniverse(input) {
+  const scanned = input.scan ? ok(input.scan) : await scanVault(input.vault);
+  if (!scanned.ok) return scanned;
+  const required = [];
+  const rejectedTyped = [];
+  const seen = /* @__PURE__ */ new Map();
+  let duplicatesRemoved = 0;
+  const typedPages = [...scanned.data.typedKnowledge].sort((a, b) => compareText(a.relPath, b.relPath));
+  for (const page of typedPages) {
+    let text;
+    try {
+      text = await readFile3(page.absPath, "utf8");
+    } catch {
+      continue;
+    }
+    const prepared = prepareTypedPage(text, page.relPath);
+    if (!prepared.ok) {
+      rejectedTyped.push({
+        relPath: page.relPath,
+        error: prepared.error,
+        detail: prepared.detail
+      });
+      continue;
+    }
+    const section = TYPE_SECTION[prepared.data.type];
+    if (!section) {
+      rejectedTyped.push({
+        relPath: page.relPath,
+        error: "SCHEME_REJECTED",
+        detail: { type: prepared.data.type }
+      });
+      continue;
+    }
+    const target = prepared.data.target.replace(/\.md$/, "");
+    const previousTitle = seen.get(target);
+    if (previousTitle !== void 0) {
+      if (previousTitle !== prepared.data.title) {
+        return err("SCHEME_REJECTED", {
+          message: `duplicate index target ${target} with differing titles`,
+          titles: [previousTitle, prepared.data.title]
+        });
+      }
+      duplicatesRemoved += 1;
+      continue;
+    }
+    seen.set(target, prepared.data.title);
+    required.push({
+      section,
+      target,
+      title: prepared.data.title,
+      source: "typed"
+    });
+  }
+  const projectReadmes = scanned.data.allMarkdown.filter((page) => /^projects\/[^/]+\/README\.md$/.test(page.relPath)).sort((a, b) => compareText(a.relPath, b.relPath));
+  for (const readme of projectReadmes) {
+    let text;
+    try {
+      text = await readFile3(readme.absPath, "utf8");
+    } catch {
+      continue;
+    }
+    const projectSlug = readme.relPath.split("/")[1];
+    const target = `projects/${projectSlug}/README`;
+    const title = projectTitleFromReadme(text, projectSlug);
+    const previousTitle = seen.get(target);
+    if (previousTitle !== void 0) {
+      if (previousTitle !== title) {
+        return err("SCHEME_REJECTED", {
+          message: `duplicate index target ${target} with differing titles`
+        });
+      }
+      duplicatesRemoved += 1;
+      continue;
+    }
+    seen.set(target, title);
+    required.push({ section: "Projects", target, title, source: "project" });
+  }
+  required.sort((a, b) => {
+    const sectionA = ROOT_INDEX_SECTION_ORDER.indexOf(a.section);
+    const sectionB = ROOT_INDEX_SECTION_ORDER.indexOf(b.section);
+    if (sectionA !== sectionB) return sectionA - sectionB;
+    return compareText(a.target, b.target);
+  });
+  const knownTargets = new Set(required.map((entry) => entry.target));
+  for (const page of [...scanned.data.compound].sort((a, b) => compareText(a.relPath, b.relPath))) {
+    knownTargets.add(page.relPath.replace(/\.md$/, ""));
+  }
+  return ok({
+    required,
+    knownTargets,
+    rejectedTyped,
+    duplicatesRemoved
+  });
+}
+
+// src/utils/index-projection.ts
 var UNMANAGED_START = "<!-- skillwiki:index-unmanaged:start -->";
 var UNMANAGED_END = "<!-- skillwiki:index-unmanaged:end -->";
 function extractUnmanaged(currentText) {
@@ -480,94 +589,27 @@ function priorWikilinkTargets(text) {
   }
   return out;
 }
-function projectTitleFromReadme(text, slug) {
-  const m = text.match(/^#\s+Project:\s+(.+)$/m);
-  return m?.[1]?.trim() || slug;
-}
 async function renderRootIndex(input) {
   const vault = input.vault;
   let currentText = input.currentText;
   if (currentText === void 0) {
     try {
-      currentText = await readFile3(join3(vault, "index.md"), "utf8");
+      currentText = await readFile4(join3(vault, "index.md"), "utf8");
     } catch {
       currentText = "";
     }
   }
   const unmanaged = extractUnmanaged(currentText);
   if (!unmanaged.ok) return unmanaged;
-  const scan = await scanVault(vault);
-  if (!scan.ok) return scan;
-  const entries = [];
-  const seen = /* @__PURE__ */ new Map();
-  let duplicatesRemoved = 0;
-  for (const page of scan.data.typedKnowledge) {
-    let text;
-    try {
-      text = await readFile3(join3(vault, page.relPath), "utf8");
-    } catch {
-      continue;
-    }
-    const prepared = prepareTypedPage(text, page.relPath);
-    if (!prepared.ok) continue;
-    const section = TYPE_SECTION[prepared.data.type];
-    if (!section) continue;
-    const target = prepared.data.target.replace(/\.md$/, "");
-    const prev = seen.get(target);
-    if (prev !== void 0) {
-      if (prev !== prepared.data.title) {
-        return err("SCHEME_REJECTED", {
-          message: `duplicate index target ${target} with differing titles`,
-          titles: [prev, prepared.data.title]
-        });
-      }
-      duplicatesRemoved += 1;
-      continue;
-    }
-    seen.set(target, prepared.data.title);
-    entries.push({
-      section,
-      target,
-      title: prepared.data.title,
-      source: "typed"
-    });
-  }
-  try {
-    const projectsRoot = join3(vault, "projects");
-    for (const slug of readdirSync(projectsRoot, { withFileTypes: true })) {
-      if (!slug.isDirectory()) continue;
-      const readmePath = join3(projectsRoot, slug.name, "README.md");
-      let text;
-      try {
-        text = readFileSync2(readmePath, "utf8");
-      } catch {
-        continue;
-      }
-      const target = `projects/${slug.name}/README`;
-      const title = projectTitleFromReadme(text, slug.name);
-      const prev = seen.get(target);
-      if (prev !== void 0) {
-        if (prev !== title) {
-          return err("SCHEME_REJECTED", {
-            message: `duplicate index target ${target} with differing titles`
-          });
-        }
-        duplicatesRemoved += 1;
-        continue;
-      }
-      seen.set(target, title);
-      entries.push({ section: "Projects", target, title, source: "project" });
-    }
-  } catch {
-  }
-  entries.sort((a, b) => {
-    const sa = SECTION_ORDER.indexOf(a.section);
-    const sb = SECTION_ORDER.indexOf(b.section);
-    if (sa !== sb) return sa - sb;
-    return compareText(a.target, b.target);
-  });
+  const universe = await buildRootIndexUniverse({ vault });
+  if (!universe.ok) return universe;
+  const entries = universe.data.required;
+  let duplicatesRemoved = universe.data.duplicatesRemoved;
   const prior = priorWikilinkTargets(currentText);
-  const generatedTargets = new Set(entries.map((e) => e.target));
+  const knownTargets = universe.data.knownTargets;
+  const knownBasenames = new Set(
+    [...knownTargets].map((target) => target.split("/").pop().toLowerCase())
+  );
   const priorLower = /* @__PURE__ */ new Map();
   for (const t of prior) {
     const k = t.toLowerCase();
@@ -585,15 +627,10 @@ async function renderRootIndex(input) {
   const ghostsRemoved = [
     ...new Set(
       prior.filter((t) => {
-        const bare = t.includes("/") ? t : null;
-        if (bare && !generatedTargets.has(bare) && !generatedTargets.has(t)) {
-          if (!seen.has(t)) return true;
-        }
         if (!t.includes("/")) {
-          const matches = [...generatedTargets].filter((g) => g.split("/").pop() === t);
-          return matches.length === 0;
+          return !knownBasenames.has(t.toLowerCase());
         }
-        return !generatedTargets.has(t);
+        return !knownTargets.has(t);
       })
     )
   ];
@@ -603,7 +640,7 @@ async function renderRootIndex(input) {
     "Generated by `skillwiki index rebuild`. Generated sections are derived from typed-page frontmatter and project manifests.",
     ""
   ];
-  for (const section of SECTION_ORDER) {
+  for (const section of ROOT_INDEX_SECTION_ORDER) {
     lines.push(`## ${section}`, "");
     const sectionEntries = entries.filter((e) => e.section === section);
     for (const e of sectionEntries) {
@@ -642,6 +679,7 @@ export {
   scanVault,
   readPage,
   readPageCached,
+  buildRootIndexUniverse,
   renderRootIndex,
   writeRootIndexProjection
 };

package/dist/{chunk-XSTXPA34.js → chunk-Z3WS45PL.js}

@@ -5,6 +5,7 @@ import {
 } from "./chunk-7I2TPIV5.js";
 import {
   atomicWriteText,
+  buildRootIndexUniverse,
   extractFrontmatter,
   mapWithConcurrency,
   prepareTypedPage,
@@ -18,7 +19,7 @@ import {
   splitFrontmatter,
   vaultIoConcurrency,
   writeRootIndexProjection
-} from "./chunk-IZABIE44.js";
+} from "./chunk-U34B2XQJ.js";
 import {
   CONFIG_KEYS,
   isValidWikiProfileKey,
@@ -1561,8 +1562,11 @@ function normalizeIndexTarget(raw) {
   return raw.replace(/\.md$/, "").replace(/^\.?\//, "");
 }
 async function runIndexCheck(input) {
-  const scan = input.scan ? ok(input.scan) : await scanVault(input.vault);
-  if (!scan.ok) return { exitCode: ExitCode.VAULT_PATH_INVALID, result: scan };
+  const universe = await buildRootIndexUniverse({ vault: input.vault, scan: input.scan });
+  if (!universe.ok) {
+    const exitCode = universe.error === "VAULT_PATH_INVALID" ? ExitCode.VAULT_PATH_INVALID : ExitCode.SCHEME_REJECTED;
+    return { exitCode, result: universe };
+  }
   let indexText = "";
   try {
     indexText = await readFile6(join10(input.vault, "index.md"), "utf8");
@@ -1579,25 +1583,22 @@ async function runIndexCheck(input) {
     indexBare.set(bare, list);
   }
   const required = /* @__PURE__ */ new Map();
-  const known = /* @__PURE__ */ new Set();
-  for (const p of scan.data.typedKnowledge) {
-    const target = p.relPath.replace(/\.md$/, "");
-    required.set(target, p.relPath);
-    known.add(target);
+  for (const entry of universe.data.required) {
+    required.set(entry.target, `${entry.target}.md`);
   }
-  for (const p of scan.data.compound) {
-    known.add(p.relPath.replace(/\.md$/, ""));
+  const requiredBasenameCounts = /* @__PURE__ */ new Map();
+  for (const target of required.keys()) {
+    const basename3 = target.split("/").pop().toLowerCase();
+    requiredBasenameCounts.set(basename3, (requiredBasenameCounts.get(basename3) ?? 0) + 1);
   }
+  const known = universe.data.knownTargets;
   const missing_from_index = [];
   for (const [target, relPath] of required.entries()) {
     if (indexTargets.has(target)) continue;
     const bare = target.split("/").pop().toLowerCase();
     const bareHits = indexBare.get(bare) ?? [];
     const basenameOnly = bareHits.filter((t) => !t.includes("/"));
-    const sameNameRequired = [...required.keys()].filter(
-      (t) => t.split("/").pop().toLowerCase() === bare
-    );
-    if (basenameOnly.length === 1 && sameNameRequired.length === 1) continue;
+    if (basenameOnly.length === 1 && requiredBasenameCounts.get(bare) === 1) continue;
     missing_from_index.push(relPath);
   }
   const ghost_entries = [];

package/dist/cli.js

@@ -68,7 +68,7 @@ import {
   satelliteLatestRunPath,
   taxonomyCommentForPage,
   upsertIndexEntry
-} from "./chunk-XSTXPA34.js";
+} from "./chunk-Z3WS45PL.js";
 import {
   normalizeDistTag,
   readCache,
@@ -88,7 +88,7 @@ import {
   scanVault,
   splitFrontmatter,
   writeRootIndexProjection
-} from "./chunk-IZABIE44.js";
+} from "./chunk-U34B2XQJ.js";
 import {
   acquireManagedWriteLock,
   releaseManagedWriteLock,
@@ -2533,7 +2533,7 @@ ${fmRewritten}
   await rename2(join17(input.vault, relPath), join17(input.vault, archivePath));
   let indexUpdated = false;
   if (!isRaw) {
-    const { renderRootIndex: renderRootIndex2, writeRootIndexProjection: writeRootIndexProjection2 } = await import("./index-projection-ERFX76U5.js");
+    const { renderRootIndex: renderRootIndex2, writeRootIndexProjection: writeRootIndexProjection2 } = await import("./index-projection-VNJ3TLEK.js");
     const before = await readFile7(join17(input.vault, "index.md"), "utf8").catch(() => "");
     const fullTarget = relPath.replace(/\.md$/, "");
     const bare = fullTarget.split("/").pop() ?? fullTarget;
@@ -2644,7 +2644,7 @@ async function runRemove(input) {
   if (relPath.endsWith(".md") && !relPath.startsWith("raw/")) {
     const { readFile: readFile17 } = await import("fs/promises");
     const { join: pathJoin } = await import("path");
-    const { renderRootIndex: renderRootIndex2, writeRootIndexProjection: writeRootIndexProjection2 } = await import("./index-projection-ERFX76U5.js");
+    const { renderRootIndex: renderRootIndex2, writeRootIndexProjection: writeRootIndexProjection2 } = await import("./index-projection-VNJ3TLEK.js");
     const before = await readFile17(pathJoin(input.vault, "index.md"), "utf8").catch(() => "");
     const fullTarget = relPath.replace(/\.md$/, "");
     const bare = fullTarget.split("/").pop() ?? fullTarget;

package/dist/{index-projection-ERFX76U5.js → index-projection-VNJ3TLEK.js}

@@ -2,7 +2,7 @@
 import {
   renderRootIndex,
   writeRootIndexProjection
-} from "./chunk-IZABIE44.js";
+} from "./chunk-U34B2XQJ.js";
 import "./chunk-C5OLZRRM.js";
 export {
   renderRootIndex,

package/dist/skillwiki-mcp.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import {
   runSkillwikiMcpStdio
-} from "./chunk-XSTXPA34.js";
+} from "./chunk-Z3WS45PL.js";
 import "./chunk-7I2TPIV5.js";
-import "./chunk-IZABIE44.js";
+import "./chunk-U34B2XQJ.js";
 import "./chunk-R6BKJWVC.js";
 import "./chunk-C5OLZRRM.js";
 

package/package.json

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

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

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.10.1",
+  "version": "0.10.2",
   "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.",
   "author": {

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

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

package/skills/package.json

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