skillwiki 0.2.0 → 0.2.1-beta.2

package/dist/cli.js

@@ -878,6 +878,10 @@ function hasOrphanedCitations(body) {
   }
   return false;
 }
+function hasWikilinkCitations(body) {
+  const stripped = stripFences(body);
+  return /\[\[raw\/[^\]]+\]\]/.test(stripped);
+}
 
 // src/commands/audit.ts
 async function runAudit(input) {
@@ -1704,7 +1708,7 @@ function hasDuplicateFrontmatter(body) {
 }
 var ERROR_ORDER = ["broken_wikilinks", "invalid_frontmatter", "raw_dedup", "tag_not_in_taxonomy"];
 var WARNING_ORDER = ["index_incomplete", "index_link_format", "stale_page", "page_too_large", "log_rotate_needed", "orphans", "legacy_citation_style", "orphaned_citations", "duplicate_frontmatter", "missing_overview"];
-var INFO_ORDER = ["bridges", "page_structure", "topic_map_recommended", "frontmatter_wikilink"];
+var INFO_ORDER = ["bridges", "page_structure", "topic_map_recommended", "frontmatter_wikilink", "wikilink_citation"];
 async function runLint(input) {
   const buckets = {};
   const links = await runLinks({ vault: input.vault });
@@ -1757,6 +1761,7 @@ async function runLint(input) {
     const dupFrontmatter = [];
     const noOverview = [];
     const fmWikilinkFlags = [];
+    const wikilinkCitationFlags = [];
     for (const page of scan.data.typedKnowledge) {
       const text = await readPage(page);
       const split = splitFrontmatter(text);
@@ -1766,6 +1771,7 @@ async function runLint(input) {
       if (hasDuplicateFrontmatter(body)) dupFrontmatter.push(page.relPath);
       if (isLegacyCitationStyle(body)) legacyPages.push(page.relPath);
       if (hasOrphanedCitations(body)) orphanedPages.push(page.relPath);
+      if (hasWikilinkCitations(body)) wikilinkCitationFlags.push(page.relPath);
       const fmLinks = rawFm.match(/\[\[([^\[\]|]+)(?:\|[^\[\]]*)?\]\]/g) ?? [];
       for (const link of fmLinks) {
         const target = link.replace(/^\[\[/, "").replace(/(?:\|[^\[\]]*)?\]\]$/, "").trim();
@@ -1794,6 +1800,7 @@ async function runLint(input) {
     if (dupFrontmatter.length > 0) buckets.duplicate_frontmatter = dupFrontmatter;
     if (noOverview.length > 0) buckets.missing_overview = noOverview;
     if (fmWikilinkFlags.length > 0) buckets.frontmatter_wikilink = fmWikilinkFlags;
+    if (wikilinkCitationFlags.length > 0) buckets.wikilink_citation = wikilinkCitationFlags;
   }
   const errorOut = ERROR_ORDER.flatMap((k) => buckets[k] ? [{ kind: k, items: buckets[k] }] : []);
   const warningOut = WARNING_ORDER.flatMap((k) => buckets[k] ? [{ kind: k, items: buckets[k] }] : []);
@@ -1888,8 +1895,8 @@ async function runConfigPath(input) {
 }
 
 // src/commands/doctor.ts
-import { existsSync as existsSync3, readdirSync, readFileSync as readFileSync3, statSync } from "fs";
-import { join as join16 } from "path";
+import { existsSync as existsSync3, readdirSync, statSync } from "fs";
+import { join as join17 } from "path";
 import { execSync } from "child_process";
 
 // src/utils/auto-update.ts
@@ -1953,6 +1960,27 @@ function triggerAutoUpdate(home, currentVersion) {
   child.unref();
 }
 
+// src/utils/plugin-registry.ts
+import { readFileSync as readFileSync3 } from "fs";
+import { join as join16 } from "path";
+var REGISTRY_PATH = join16(".claude", "plugins", "installed_plugins.json");
+var PLUGIN_KEY = "skillwiki@llm-wiki";
+function readInstalledPlugins(home) {
+  try {
+    const raw = readFileSync3(join16(home, REGISTRY_PATH), "utf8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+function findPlugin(home, key = PLUGIN_KEY) {
+  const registry = readInstalledPlugins(home);
+  if (!registry?.plugins) return null;
+  const entries = registry.plugins[key];
+  if (!entries || entries.length === 0) return null;
+  return entries[0];
+}
+
 // src/commands/doctor.ts
 function check(status, id, label, detail) {
   return { id, label, status, detail };
@@ -2008,9 +2036,9 @@ function checkVaultStructure(resolvedPath) {
     return check("error", "vault_structure", "Vault structure valid", "Cannot check \u2014 vault directory does not exist");
   }
   const missing = [];
-  if (!existsSync3(join16(resolvedPath, "SCHEMA.md"))) missing.push("SCHEMA.md");
+  if (!existsSync3(join17(resolvedPath, "SCHEMA.md"))) missing.push("SCHEMA.md");
   for (const dir of ["raw", "entities", "concepts", "meta"]) {
-    if (!existsSync3(join16(resolvedPath, dir))) missing.push(dir + "/");
+    if (!existsSync3(join17(resolvedPath, dir))) missing.push(dir + "/");
   }
   if (missing.length === 0) {
     return check("pass", "vault_structure", "Vault structure valid", "All required files and directories present");
@@ -2018,15 +2046,21 @@ function checkVaultStructure(resolvedPath) {
   return check("warn", "vault_structure", "Vault structure valid", `Missing: ${missing.join(", ")} \u2014 run \`skillwiki init\` to add CodeWiki structure`);
 }
 function checkSkillsInstalled(home) {
-  const skillsDir = join16(home, ".claude", "skills");
-  if (!existsSync3(skillsDir)) {
-    return check("warn", "skills_installed", "Skills installed", `${skillsDir} not found`);
+  const plugin = findPlugin(home);
+  if (plugin) {
+    const found = findSkillMd(plugin.installPath);
+    if (found.length > 0) {
+      return check("pass", "skills_installed", "Skills installed", `${found.length} SKILL.md file(s) found (plugin v${plugin.version})`);
+    }
   }
-  const found = findSkillMd(skillsDir);
-  if (found.length > 0) {
-    return check("pass", "skills_installed", "Skills installed", `${found.length} SKILL.md file(s) found`);
+  const skillsDir = join17(home, ".claude", "skills");
+  if (existsSync3(skillsDir)) {
+    const found = findSkillMd(skillsDir);
+    if (found.length > 0) {
+      return check("pass", "skills_installed", "Skills installed", `${found.length} SKILL.md file(s) found (CLI install)`);
+    }
   }
-  return check("warn", "skills_installed", "Skills installed", "No SKILL.md files found in ~/.claude/skills/");
+  return check("warn", "skills_installed", "Skills installed", "No SKILL.md files found");
 }
 function checkNpmUpdate(home, currentVersion) {
   const { hasUpdate, latest } = latestFromCache(home, currentVersion);
@@ -2039,30 +2073,21 @@ function checkNpmUpdate(home, currentVersion) {
   return check("pass", "npm_update", "npm CLI version", `v${currentVersion} (latest: v${latest})`);
 }
 function checkPluginVersionDrift(home, currentVersion) {
-  const pluginJsonPath = join16(home, ".claude", "plugins", "cache", "llm-wiki", "plugin.json");
-  if (!existsSync3(pluginJsonPath)) {
-    return check("pass", "plugin_version_drift", "Plugin/CLI version", "Plugin cache not found \u2014 plugin not installed");
+  const plugin = findPlugin(home);
+  if (!plugin) {
+    return check("pass", "plugin_version_drift", "Plugin/CLI version", "Plugin not installed \u2014 CLI only");
   }
-  try {
-    const content = readFileSync3(pluginJsonPath, { encoding: "utf8" });
-    const pluginData = JSON.parse(content);
-    const pluginVersion = pluginData.version;
-    if (!pluginVersion) {
-      return check("pass", "plugin_version_drift", "Plugin/CLI version", "Plugin version not found in cache");
-    }
-    if (pluginVersion === currentVersion) {
-      return check("pass", "plugin_version_drift", "Plugin/CLI version", `Both at v${currentVersion}`);
-    }
-    const updateCmd = semverGt(pluginVersion, currentVersion) ? "npm install -g skillwiki@beta" : "claude plugin update skillwiki@llm-wiki";
-    return check(
-      "warn",
-      "plugin_version_drift",
-      "Plugin/CLI version",
-      `Plugin v${pluginVersion} \u2260 CLI v${currentVersion} \u2014 run \`${updateCmd}\``
-    );
-  } catch {
-    return check("pass", "plugin_version_drift", "Plugin/CLI version", "Could not read plugin cache");
+  const pluginVersion = plugin.version;
+  if (pluginVersion === currentVersion) {
+    return check("pass", "plugin_version_drift", "Plugin/CLI version", `Both at v${currentVersion}`);
   }
+  const updateCmd = semverGt(pluginVersion, currentVersion) ? "npm install -g skillwiki@beta" : "claude plugin update skillwiki@llm-wiki";
+  return check(
+    "warn",
+    "plugin_version_drift",
+    "Plugin/CLI version",
+    `Plugin v${pluginVersion} \u2260 CLI v${currentVersion} \u2014 run \`${updateCmd}\``
+  );
 }
 async function checkProfiles(home) {
   const map = await parseDotenvFile(configPath(home));
@@ -2086,7 +2111,7 @@ async function checkProfiles(home) {
 }
 async function checkProjectLocalOverride(cwd) {
   const dir = cwd ?? process.cwd();
-  const envPath = join16(dir, ".skillwiki", ".env");
+  const envPath = join17(dir, ".skillwiki", ".env");
   if (existsSync3(envPath)) {
     return check("pass", "project_local", "Project-local config", `Found: ${envPath}`);
   }
@@ -2102,9 +2127,9 @@ function findSkillMd(dir) {
   }
   for (const entry of entries) {
     if (entry.isFile() && entry.name === "SKILL.md") {
-      results.push(join16(dir, entry.name));
+      results.push(join17(dir, entry.name));
     } else if (entry.isDirectory()) {
-      results.push(...findSkillMd(join16(dir, entry.name)));
+      results.push(...findSkillMd(join17(dir, entry.name)));
     }
   }
   return results;
@@ -2148,7 +2173,7 @@ async function runDoctor(input) {
 
 // src/commands/archive.ts
 import { rename as rename3, mkdir as mkdir5, readFile as readFile13, writeFile as writeFile6 } from "fs/promises";
-import { join as join17, dirname as dirname7 } from "path";
+import { join as join18, dirname as dirname7 } from "path";
 async function runArchive(input) {
   const scan = await scanVault(input.vault);
   if (!scan.ok) return { exitCode: ExitCode.VAULT_PATH_INVALID, result: scan };
@@ -2160,10 +2185,10 @@ async function runArchive(input) {
   }
   if (!relPath) return { exitCode: ExitCode.ARCHIVE_TARGET_NOT_FOUND, result: err("ARCHIVE_TARGET_NOT_FOUND", { page: input.page }) };
   if (relPath.startsWith("_archive/")) return { exitCode: ExitCode.ARCHIVE_ALREADY_ARCHIVED, result: err("ARCHIVE_ALREADY_ARCHIVED", { page: relPath }) };
-  const archivePath = join17("_archive", relPath);
-  await mkdir5(dirname7(join17(input.vault, archivePath)), { recursive: true });
+  const archivePath = join18("_archive", relPath);
+  await mkdir5(dirname7(join18(input.vault, archivePath)), { recursive: true });
   let indexUpdated = false;
-  const indexPath = join17(input.vault, "index.md");
+  const indexPath = join18(input.vault, "index.md");
   try {
     const idx = await readFile13(indexPath, "utf8");
     const slug = relPath.replace(/\.md$/, "").split("/").pop();
@@ -2176,7 +2201,7 @@ async function runArchive(input) {
   } catch (e) {
     if (e?.code !== "ENOENT") throw e;
   }
-  await rename3(join17(input.vault, relPath), join17(input.vault, archivePath));
+  await rename3(join18(input.vault, relPath), join18(input.vault, archivePath));
   return { exitCode: ExitCode.OK, result: ok({ archived_from: relPath, archived_to: archivePath, index_updated: indexUpdated, humanHint: `${relPath} -> ${archivePath}${indexUpdated ? " (index updated)" : ""}` }) };
 }
 

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "skillwiki",
-  "version": "0.2.0",
+  "version": "0.2.1-beta.2",
+  "version": "0.2.1-beta.2",
   "type": "module",
   "bin": {
     "skillwiki": "dist/cli.js"

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

@@ -1,6 +1,7 @@
 {
   "name": "skillwiki",
-  "version": "0.2.0",
+  "version": "0.2.1-beta.2",
+  "version": "0.2.1-beta.2",
   "skills": "./",
   "description": "Project-aware Karpathy-style knowledge base for Claude Code: 11 prompt-only skills (wiki-*, proj-*, using-skillwiki) backed by the deterministic `skillwiki` CLI (8 subcommands, JSON-by-default).",
   "author": {

package/skills/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@skillwiki/skills",
-  "version": "0.2.0",
+  "version": "0.2.1-beta.2",
+  "version": "0.2.1-beta.2",
   "private": true,
   "files": [
     "wiki-*",