skillwiki 0.9.28 → 0.9.29

package/dist/{chunk-IP3RKVMF.js → chunk-T7XG3WFK.js}

@@ -8467,6 +8467,7 @@ export {
   runOrphans,
   extractCitationMarkers,
   runAudit,
+  findPlugin,
   extractTaxonomy,
   readLastOp,
   appendLastOp,

package/dist/cli.js

@@ -11,6 +11,7 @@ import {
   extractCitationMarkers,
   extractFrontmatter,
   extractTaxonomy,
+  findPlugin,
   fixPathTooLong,
   isBlockedHost,
   ok,
@@ -59,7 +60,7 @@ import {
   triggerAutoUpdate,
   writeCache,
   writeDotenv
-} from "./chunk-IP3RKVMF.js";
+} from "./chunk-T7XG3WFK.js";
 import {
   normalizeDistTag
 } from "./chunk-E6UWZ3S3.js";
@@ -297,6 +298,28 @@ async function runInstall(input) {
   if (entries.length === 0) {
     return { exitCode: ExitCode.PREFLIGHT_FAILED, result: err("PREFLIGHT_FAILED", { reason: "no skills found" }) };
   }
+  const defaultTarget = join2(input.home, ".claude", "skills");
+  const isDefaultTarget = resolve(input.target) === resolve(defaultTarget);
+  const plugin = input.force || !isDefaultTarget ? null : findPlugin(input.home);
+  if (plugin) {
+    const manifest_path2 = join2(input.target, "wiki-manifest.json");
+    const hintLines2 = [
+      `deferred to plugin: skillwiki@llm-wiki v${plugin.version}`,
+      `plugin provides skills at ${plugin.installPath}`,
+      `use --force to install CLI copies into ${input.target} anyway`
+    ];
+    return {
+      exitCode: ExitCode.OK,
+      result: ok({
+        installed: [],
+        backed_up: [],
+        manifest_path: manifest_path2,
+        version_warnings: [],
+        deferred_to_plugin: true,
+        humanHint: hintLines2.join("\n")
+      })
+    };
+  }
   const installed = [];
   const backed_up = [];
   const version_warnings = [];
@@ -377,7 +400,7 @@ async function runInstall(input) {
     for (const w of version_warnings) hintLines.push(`  ${w}`);
   }
   const exitCode = version_warnings.length > 0 ? ExitCode.SKILL_VERSION_MISMATCH : ExitCode.OK;
-  return { exitCode, result: ok({ installed, backed_up, manifest_path, version_warnings, humanHint: hintLines.join("\n") }) };
+  return { exitCode, result: ok({ installed, backed_up, manifest_path, version_warnings, deferred_to_plugin: false, humanHint: hintLines.join("\n") }) };
 }
 
 // src/commands/path.ts
@@ -1827,19 +1850,23 @@ function resolveGlobalSkillsRoot() {
     return null;
   }
 }
-async function refreshInstalledSkills(target) {
+async function refreshInstalledSkills(home, target) {
   const skillsRoot = resolveGlobalSkillsRoot();
   if (!skillsRoot) {
-    return { warnings: ["could not locate global skillwiki installation for skill refresh"], refreshed: false };
+    return { warnings: ["could not locate global skillwiki installation for skill refresh"], refreshed: false, deferred_to_plugin: false };
   }
   try {
-    const result = await runInstall({ skillsRoot, target, dryRun: false, symlink: false });
+    const result = await runInstall({ skillsRoot, target, dryRun: false, symlink: false, home, force: false });
     if (result.result.ok) {
-      return { warnings: result.result.data.version_warnings, refreshed: true };
+      return {
+        warnings: result.result.data.version_warnings,
+        refreshed: !result.result.data.deferred_to_plugin,
+        deferred_to_plugin: result.result.data.deferred_to_plugin
+      };
     }
-    return { warnings: [`skill refresh failed: ${result.result.error}`], refreshed: false };
+    return { warnings: [`skill refresh failed: ${result.result.error}`], refreshed: false, deferred_to_plugin: false };
   } catch (e) {
-    return { warnings: [`skill refresh error: ${String(e)}`], refreshed: false };
+    return { warnings: [`skill refresh error: ${String(e)}`], refreshed: false, deferred_to_plugin: false };
   }
 }
 async function runUpdate(input) {
@@ -1875,6 +1902,7 @@ async function runUpdate(input) {
         wasAlreadyLatest: true,
         version_warnings: [],
         skills_refreshed: false,
+        deferred_to_plugin: false,
         humanHint: `Already on npm@${tag}: v${currentVersion}`
       })
     };
@@ -1891,12 +1919,13 @@ async function runUpdate(input) {
     };
   }
   writeCache(input.home, { ...cache, updateAppliedAt: Date.now() });
-  const installResult = await refreshInstalledSkills(target);
+  const installResult = await refreshInstalledSkills(input.home, target);
   const version_warnings = installResult.warnings;
   const skills_refreshed = installResult.refreshed;
+  const deferred_to_plugin = installResult.deferred_to_plugin;
   const hintLines = [
     `Updated skillwiki ${currentVersion} \u2192 ${latest} via npm@${tag}`,
-    `skills refreshed: ${skills_refreshed}`
+    deferred_to_plugin ? `skills deferred to plugin channel (skillwiki@llm-wiki)` : `skills refreshed: ${skills_refreshed}`
   ];
   if (version_warnings.length > 0) {
     hintLines.push(`version warnings: ${version_warnings.length}`);
@@ -1910,6 +1939,7 @@ async function runUpdate(input) {
       wasAlreadyLatest: false,
       version_warnings,
       skills_refreshed,
+      deferred_to_plugin,
       humanHint: hintLines.join("\n")
     })
   };
@@ -4407,9 +4437,9 @@ program.command("orphans [vault]").description("find pages not referenced by any
   wiki: opts.wiki
 })));
 program.command("audit <file>").description("audit citation markers and source provenance for a vault page").action(async (file) => emit(await runAudit({ file })));
-program.command("install").description("install skillwiki SKILL.md files into ~/.claude/skills/").option("--target <dir>", "target install directory", `${process.env.HOME ?? ""}/.claude/skills/`).option("--dry-run", "preview only", false).option("--skills-root <dir>", "source skills directory (defaults to packaged)").option("--symlink", "create symlinks instead of copies (dev mode \u2014 edits to source are immediately visible)", false).action(async (opts) => {
+program.command("install").description("install skillwiki SKILL.md files into ~/.claude/skills/").option("--target <dir>", "target install directory", `${process.env.HOME ?? ""}/.claude/skills/`).option("--dry-run", "preview only", false).option("--skills-root <dir>", "source skills directory (defaults to packaged)").option("--symlink", "create symlinks instead of copies (dev mode \u2014 edits to source are immediately visible)", false).option("--force", "install CLI copies even when the skillwiki@llm-wiki plugin channel is active", false).action(async (opts) => {
   const skillsRoot = opts.skillsRoot ?? new URL("../skills/", import.meta.url).pathname;
-  emit(await runInstall({ skillsRoot, target: opts.target, dryRun: !!opts.dryRun, symlink: !!opts.symlink }));
+  emit(await runInstall({ skillsRoot, target: opts.target, dryRun: !!opts.dryRun, symlink: !!opts.symlink, home: process.env.HOME ?? "", force: !!opts.force }));
 });
 program.command("path").description("show the resolved vault path").option("--vault <dir>", "explicit vault override (runtime)").option("--target <dir>", "explicit target override (init-time)").option("--wiki <name>", "wiki profile name").option("--init-time", "use init-time chain instead of runtime", false).option("--explain", "include resolution chain in output", false).action(async (opts) => {
   const initTime = !!opts.initTime;

package/dist/skillwiki-mcp.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runSkillwikiMcpStdio
-} from "./chunk-IP3RKVMF.js";
+} from "./chunk-T7XG3WFK.js";
 import "./chunk-E6UWZ3S3.js";
 
 // src/mcp-entry.ts

package/package.json

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

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

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.9.28",
+  "version": "0.9.29",
   "skills": "./",
   "description": "Project-aware Karpathy-style knowledge base for Claude Code: 18 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.9.28",
+  "version": "0.9.29",
   "description": "Project-aware Karpathy-style knowledge base for Codex with 18 prompt-only skills backed by the deterministic skillwiki CLI.",
   "author": {
     "name": "karlorz",
@@ -18,7 +18,6 @@
     "karpathy"
   ],
   "skills": "./skills/",
-  "mcpServers": "./.mcp.json",
   "hooks": "./hooks/hooks-codex.json",
   "interface": {
     "displayName": "SkillWiki",

package/skills/package.json

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

package/skills/.mcp.json

@@ -1,7 +0,0 @@
-{
-  "skillwiki": {
-    "command": "skillwiki-mcp",
-    "args": [],
-    "env": {}
-  }
-}