skillwiki 0.9.36 → 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) {
@@ -3303,6 +3305,7 @@ ${body}`;
 // src/commands/sync.ts
 import { existsSync as existsSync7 } from "fs";
 import { join as join18 } from "path";
+import { execFileSync as execFileSync2 } from "child_process";
 
 // src/utils/git.ts
 import { execFileSync } from "child_process";
@@ -3453,6 +3456,33 @@ function stageVaultContentChanges(vault) {
 }
 
 // src/commands/sync.ts
+function parseDirtyPaths(porcelain) {
+  if (!porcelain) return [];
+  return porcelain.split("\n").map((line) => line.trimEnd()).filter((line) => line.length >= 4).map((line) => {
+    const payload = line.length >= 3 && line[2] === " " ? line.slice(3) : line.length >= 2 && line[1] === " " ? line.slice(2) : line;
+    const arrow = payload.lastIndexOf(" -> ");
+    return arrow >= 0 ? payload.slice(arrow + 4) : payload;
+  }).filter((path) => path.length > 0);
+}
+function splitNonEmptyLines(text) {
+  if (!text) return [];
+  return text.split("\n").map((line) => line.trim()).filter((line) => line.length > 0);
+}
+function isTrackedNotePath(path) {
+  if (!path.endsWith(".md")) return false;
+  return !/^\.(skillwiki|claude|obsidian|antigravitycli|playwright-cli)\//.test(path);
+}
+function refHasPath(vault, ref, path) {
+  try {
+    execFileSync2("git", ["cat-file", "-e", `${ref}:${path}`], {
+      cwd: vault,
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
 function runSyncStatus(input) {
   const vault = input.vault;
   const includeStashes = input.includeStashes ?? false;
@@ -3464,6 +3494,8 @@ function runSyncStatus(input) {
         dirty: 0,
         ahead: 0,
         behind: 0,
+        unpromoted_note_paths: 0,
+        unpromoted_note_examples: [],
         last_commit: "never",
         status: "not_a_repo",
         humanHint: "not a git repository"
@@ -3473,6 +3505,8 @@ function runSyncStatus(input) {
   enableGitLongPathsOnWindows(vault);
   const porcelain = git(vault, ["status", "--porcelain"]);
   const dirty = porcelain ? porcelain.split("\n").filter((l) => l.trim().length > 0).length : 0;
+  const dirtyPaths = parseDirtyPaths(porcelain);
+  const untrackedPaths = splitNonEmptyLines(git(vault, ["ls-files", "--others", "--exclude-standard"]));
   const revOutput = git(vault, ["rev-list", "--left-right", "--count", "origin/HEAD...HEAD"]);
   let ahead = 0;
   let behind = 0;
@@ -3493,6 +3527,10 @@ function runSyncStatus(input) {
   } else {
     last_commit = "never";
   }
+  const remoteRef = git(vault, ["rev-parse", "--verify", "origin/main"]) ? "origin/main" : git(vault, ["rev-parse", "--verify", "origin/HEAD"]) ? "origin/HEAD" : "HEAD";
+  const unpromotedNoteAll = Array.from(/* @__PURE__ */ new Set([...dirtyPaths, ...untrackedPaths])).filter(isTrackedNotePath).filter((path) => !refHasPath(vault, remoteRef, path));
+  const unpromotedNoteExamples = unpromotedNoteAll.slice(0, 5);
+  const unpromotedNotePaths = unpromotedNoteAll.length;
   let status;
   if (dirty > 0) {
     status = "dirty";
@@ -3508,6 +3546,7 @@ function runSyncStatus(input) {
     `dirty: ${dirty}`,
     `ahead: ${ahead}`,
     `behind: ${behind}`,
+    `unpromoted_note_paths: ${unpromotedNotePaths}`,
     `last_commit: ${last_commit}`
   ];
   const exitCode = status === "clean" ? ExitCode.OK : ExitCode.LINT_HAS_WARNINGS;
@@ -3520,6 +3559,8 @@ function runSyncStatus(input) {
     dirty,
     ahead,
     behind,
+    unpromoted_note_paths: unpromotedNotePaths,
+    unpromoted_note_examples: unpromotedNoteExamples,
     last_commit,
     status,
     humanHint: hintLines.join("\n")
@@ -4849,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) => {
@@ -4865,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
   }));
 });
@@ -4899,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.36",
+  "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.36",
+  "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.36",
+  "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.36",
+  "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