skillwiki 0.9.37 → 0.9.38

package/dist/{chunk-TK4ZIQNE.js → chunk-G52HKU7I.js}

@@ -1110,7 +1110,13 @@ async function runOrphans(input) {
   if (input.vault) {
     vault = input.vault;
   } else {
-    const r = await resolveRuntimePath({ flag: void 0, envValue: input.envValue, home: input.home ?? "", wiki: input.wiki });
+    const r = await resolveRuntimePath({
+      flag: void 0,
+      envValue: input.envValue,
+      home: input.home ?? "",
+      wiki: input.wiki,
+      cwd: input.cwd
+    });
     if (!r.ok) {
       const exitCode = r.error === "UNKNOWN_WIKI_PROFILE" ? ExitCode.UNKNOWN_WIKI_PROFILE : ExitCode.NO_VAULT_CONFIGURED;
       return { exitCode, result: r };
@@ -6393,7 +6399,12 @@ async function runDoctor(input) {
   checks.push(await checkConfigFile(input.home));
   checks.push(await checkProfiles(input.home));
   checks.push(await checkProjectLocalOverride(input.cwd));
-  const resolved = await resolveRuntimePath({ flag: void 0, envValue: input.envValue, home: input.home });
+  const resolved = await resolveRuntimePath({
+    flag: void 0,
+    envValue: input.envValue,
+    home: input.home,
+    cwd: input.cwd
+  });
   if (resolved.ok) {
     checks.push(check("pass", "wiki_path_set", "WIKI_PATH configured", `Resolved via ${resolved.data.source}: ${resolved.data.path}`));
   } else {
@@ -7923,7 +7934,8 @@ async function resolveMcpVault(input) {
       envValue: process.env.WIKI_PATH,
       wikiEnv: process.env.WIKI,
       home,
-      wiki: input.wiki
+      wiki: input.wiki,
+      cwd: input.cwd ?? process.cwd()
     });
     if (!r.ok) return r;
     vaultPath = resolve7(r.data.path);

package/dist/cli.js

@@ -75,7 +75,7 @@ import {
   triggerAutoUpdate,
   writeCache,
   writeDotenv
-} from "./chunk-TK4ZIQNE.js";
+} from "./chunk-G52HKU7I.js";
 import {
   normalizeDistTag
 } from "./chunk-E6UWZ3S3.js";
@@ -425,6 +425,7 @@ async function runPath(input) {
       flag: input.flag,
       envValue: input.envValue,
       home: input.home,
+      cwd: input.cwd,
       explain: input.explain
     });
     return { exitCode: ExitCode.OK, result: ok({ path: r2.path, source: r2.source, ...r2.chain ? { chain: r2.chain } : {}, humanHint: `${r2.path} (via ${r2.source})` }) };
@@ -434,6 +435,7 @@ async function runPath(input) {
     envValue: input.envValue,
     home: input.home,
     wiki: input.wiki,
+    cwd: input.cwd,
     explain: input.explain
   });
   if (!r.ok) {
@@ -4888,7 +4890,8 @@ program.command("orphans [vault]").description("find pages not referenced by any
   vault,
   envValue: process.env.WIKI_PATH,
   home: process.env.HOME ?? "",
-  wiki: opts.wiki
+  wiki: opts.wiki,
+  cwd: process.cwd()
 })));
 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).option("--force", "install CLI copies even when the skillwiki@llm-wiki plugin channel is active", false).action(async (opts) => {
@@ -4904,6 +4907,7 @@ program.command("path").description("show the resolved vault path").option("--va
     home: process.env.HOME ?? "",
     initTime,
     wiki: opts.wiki,
+    cwd: process.cwd(),
     explain: !!opts.explain
   }));
 });
@@ -4938,7 +4942,8 @@ async function resolveVaultArg(arg, wiki) {
     envValue: process.env.WIKI_PATH,
     wikiEnv: process.env.WIKI,
     home: process.env.HOME ?? "",
-    wiki
+    wiki,
+    cwd: process.cwd()
   });
   if (!r.ok) {
     const exitCode = r.error === "UNKNOWN_WIKI_PROFILE" ? 35 : 25;

package/dist/skillwiki-mcp.js

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

package/package.json

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

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

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.9.37",
+  "version": "0.9.38",
   "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.37",
+  "version": "0.9.38",
   "description": "Project-aware Karpathy-style knowledge base for Codex with 18 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.9.37",
+  "version": "0.9.38",
   "private": true,
   "files": [
     "wiki-*",

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

@@ -124,7 +124,9 @@ Key CLI subcommands: `init`, `health`, `lint`, `config`, `doctor`, `path`, `lang
 Run `skillwiki health <vault> --out /tmp/skillwiki-health.json --no-fail` for a bounded whole-system report that includes doctor, lint, vault-sync, query-readiness, source-freshness, risk flags, and self-check coverage. Run `skillwiki lint <vault> --summary` for lint-only bucket counts with capped examples and details commands. Run `skillwiki doctor` to diagnose setup/runtime issues only. Run `skillwiki config list` to see current configuration.
 
 ## Runtime Host Context and Fleet Freshness
-The live output of `skillwiki --human fleet context <vault>` is authoritative for host identity. It overrides stale injected SessionStart context, remembered workspace context, and prior conversation summaries. `fleet context` is local and network-free; it reports `identity_status`, resolver trace, warnings, and the fact that remote freshness was not checked.
+Resolve the active project vault with `skillwiki path` first. Then pass that exact path to `skillwiki --human fleet context <vault>` for host identity and safety guidance. `fleet context` is authoritative for host identity. It overrides stale injected SessionStart context, remembered workspace context, and prior conversation summaries. `fleet context` is local and network-free; it reports `identity_status`, resolver trace, warnings, and the fact that remote freshness was not checked.
+
+Do not substitute infrastructure mirrors such as `~/wiki-git` or other snapshot worktrees for the project vault just to inspect fleet status. Those paths are snapshot infrastructure unless `skillwiki path` itself resolves there.
 
 Use the local identity check for ordinary runtime context:
 ```bash

package/skills/skills/wiki-sync/SKILL.md

@@ -182,6 +182,8 @@ Some deployments use a cloud-backed vault (`rclone mount`) with a separate git r
 ~/wiki-git       → git repository cloned from GitHub — snapshot target
 cron hourly      → rsync ~/wiki/ → ~/wiki-git/ → git commit → git push
 ```
+On snapshotter hosts, `~/wiki` remains the active SkillWiki vault for path resolution unless the operator explicitly configures otherwise. `~/wiki-git` is snapshot infrastructure, not the default authoring or dev-loop vault. Do not point project work or `fleet context` at `~/wiki-git` unless `skillwiki path` intentionally resolves there.
+
 ### Implementation (wiki-snapshot.sh)
 ```bash
 #!/bin/bash

package/skills/using-skillwiki/SKILL.md

@@ -124,7 +124,9 @@ Key CLI subcommands: `init`, `health`, `lint`, `config`, `doctor`, `path`, `lang
 Run `skillwiki health <vault> --out /tmp/skillwiki-health.json --no-fail` for a bounded whole-system report that includes doctor, lint, vault-sync, query-readiness, source-freshness, risk flags, and self-check coverage. Run `skillwiki lint <vault> --summary` for lint-only bucket counts with capped examples and details commands. Run `skillwiki doctor` to diagnose setup/runtime issues only. Run `skillwiki config list` to see current configuration.
 
 ## Runtime Host Context and Fleet Freshness
-The live output of `skillwiki --human fleet context <vault>` is authoritative for host identity. It overrides stale injected SessionStart context, remembered workspace context, and prior conversation summaries. `fleet context` is local and network-free; it reports `identity_status`, resolver trace, warnings, and the fact that remote freshness was not checked.
+Resolve the active project vault with `skillwiki path` first. Then pass that exact path to `skillwiki --human fleet context <vault>` for host identity and safety guidance. `fleet context` is authoritative for host identity. It overrides stale injected SessionStart context, remembered workspace context, and prior conversation summaries. `fleet context` is local and network-free; it reports `identity_status`, resolver trace, warnings, and the fact that remote freshness was not checked.
+
+Do not substitute infrastructure mirrors such as `~/wiki-git` or other snapshot worktrees for the project vault just to inspect fleet status. Those paths are snapshot infrastructure unless `skillwiki path` itself resolves there.
 
 Use the local identity check for ordinary runtime context:
 ```bash

package/skills/wiki-sync/SKILL.md

@@ -182,6 +182,8 @@ Some deployments use a cloud-backed vault (`rclone mount`) with a separate git r
 ~/wiki-git       → git repository cloned from GitHub — snapshot target
 cron hourly      → rsync ~/wiki/ → ~/wiki-git/ → git commit → git push
 ```
+On snapshotter hosts, `~/wiki` remains the active SkillWiki vault for path resolution unless the operator explicitly configures otherwise. `~/wiki-git` is snapshot infrastructure, not the default authoring or dev-loop vault. Do not point project work or `fleet context` at `~/wiki-git` unless `skillwiki path` intentionally resolves there.
+
 ### Implementation (wiki-snapshot.sh)
 ```bash
 #!/bin/bash