skillwiki 0.9.11 → 0.9.13

package/dist/cli.js

@@ -5455,6 +5455,12 @@ function checkCliChannels(argv, home) {
   const devChannels = channels.filter((c) => c.isDevLink);
   const prodChannels = channels.filter((c) => !c.isDevLink);
   if (devChannels.length > 0 && prodChannels.length > 0) {
+    const hasInstall2 = prodChannels.some((c) => c.name === "install");
+    if (!hasInstall2) {
+      const devNames2 = devChannels.map((c) => `${c.name}(dev)`);
+      const prodNames2 = prodChannels.map((c) => c.name);
+      return check("pass", "cli_channels", "CLI channels", `${channels.length} channels: ${[...devNames2, ...prodNames2].join(", ")} \u2014 dev source with installed production channels`);
+    }
     const devNames = devChannels.map((c) => `${c.name}(dev)`);
     const prodNames = prodChannels.map((c) => c.name);
     return check(
@@ -5476,6 +5482,9 @@ function checkCliChannels(argv, home) {
   }
   return check("pass", "cli_channels", "CLI channels", `${channels.length} channels: ${names.join(", ")}`);
 }
+function isDevSourceRun(argv) {
+  return argv.length >= 2 && argv[1].endsWith("cli.js");
+}
 async function checkConfigFile(home) {
   const cfgPath = configPath(home);
   if (!existsSync11(cfgPath)) {
@@ -5582,7 +5591,7 @@ function checkNpmUpdate(home, currentVersion) {
   }
   return check("pass", "npm_update", "npm CLI version", `v${currentVersion} (${distTag}: v${latest})`);
 }
-function checkPluginVersionDrift(home, currentVersion) {
+function checkPluginVersionDrift(home, currentVersion, devSourceRun) {
   const plugins = findPluginInstallations(home);
   if (plugins.length === 0) {
     return check("pass", "plugin_version_drift", "Plugin/CLI version", "Plugin not installed \u2014 CLI only");
@@ -5598,6 +5607,10 @@ function checkPluginVersionDrift(home, currentVersion) {
     const labels = plugins.map((plugin) => `${plugin.label} plugin`).join(", ");
     return check("pass", "plugin_version_drift", "Plugin/CLI version", `${labels}, and CLI all at v${currentVersion}`);
   }
+  if (devSourceRun && drifted.every((plugin) => semverGt(currentVersion, plugin.version))) {
+    const details2 = drifted.map((plugin) => `${plugin.label} plugin v${plugin.version}`).join(", ");
+    return check("info", "plugin_version_drift", "Plugin/CLI version", `Dev source v${currentVersion} is ahead of installed ${details2}`);
+  }
   const details = drifted.map((plugin) => {
     const updateCmd = pluginUpdateCommand(plugin, currentVersion);
     return `${plugin.label} plugin v${plugin.version} \u2260 CLI v${currentVersion} \u2014 run \`${updateCmd}\``;
@@ -6170,6 +6183,10 @@ function readVaultSyncConfig(home) {
     const content = readFileSync7(join29(home, ".skillwiki", ".env"), "utf8");
     let installed = false;
     let role;
+    let serviceScope;
+    let snapshotScript;
+    let snapshotProfile;
+    let snapshotWorktree;
     for (const line of content.split(/\r?\n/)) {
       const trimmed = line.trim();
       if (trimmed.length === 0 || trimmed.startsWith("#")) continue;
@@ -6180,12 +6197,42 @@ function readVaultSyncConfig(home) {
       if (v.length === 0) continue;
       if (k === "vault_sync.installed" && v === "true") installed = true;
       if (k === "vault_sync.role") role = v;
+      if (k === "vault_sync.service_scope") serviceScope = v;
+      if (k === "vault_sync.snapshot_script") snapshotScript = v;
+      if (k === "vault_sync.snapshot_profile") snapshotProfile = v;
+      if (k === "vault_sync.snapshot_worktree") snapshotWorktree = v;
     }
-    return { installed, role };
+    return { installed, role, serviceScope, snapshotScript, snapshotProfile, snapshotWorktree };
   } catch {
     return { installed: false };
   }
 }
+function readKeyFromEnvFile(path, keys) {
+  try {
+    const content = readFileSync7(path, "utf8");
+    for (const line of content.split(/\r?\n/)) {
+      const trimmed = line.trim();
+      if (trimmed.length === 0 || trimmed.startsWith("#")) continue;
+      const eq = trimmed.indexOf("=");
+      if (eq <= 0) continue;
+      const key = trimmed.slice(0, eq).trim();
+      if (!keys.includes(key)) continue;
+      const value = trimmed.slice(eq + 1).trim();
+      if (value.length > 0) return value;
+    }
+  } catch {
+  }
+  return void 0;
+}
+function resolveSnapshotGitWorktree(config) {
+  if (config.snapshotWorktree) return config.snapshotWorktree;
+  if (config.snapshotProfile) {
+    const fromProfile = readKeyFromEnvFile(config.snapshotProfile, ["WIKI_GIT_WORKTREE", "SNAPSHOT_WORKTREE", "GIT_DIR"]);
+    if (fromProfile) return fromProfile;
+  }
+  const defaultPath = "/root/wiki-git";
+  return existsSync11(defaultPath) ? defaultPath : void 0;
+}
 function vaultSyncChecks(input) {
   const os = input.os ?? platform2();
   const home = input.home;
@@ -6204,7 +6251,89 @@ function vaultSyncChecks(input) {
   const logDir = input.logDir ?? (isMac ? join29(home, "Library", "Logs") : join29(home, ".local", "state", "vault-sync", "log"));
   const shareDir = input.shareDir ?? (isMac ? join29(home, "Library", "Application Support", "vault-sync", "bin") : join29(home, ".local", "share", "vault-sync", "bin"));
   const filterPath = input.filterPath ?? join29(home, ".config", "rclone", "wiki-push-filters.txt");
-  const snapshotPath = input.snapshotScriptPath ?? "/root/.hermes/scripts/wiki-snapshot-v3.sh";
+  const packagedSnapshotPath = join29(shareDir, "wiki-snapshot.sh");
+  const legacySnapshotPath = "/root/.hermes/scripts/wiki-snapshot-v3.sh";
+  const snapshotPath = input.snapshotScriptPath ?? (existsSync11(packagedSnapshotPath) ? packagedSnapshotPath : legacySnapshotPath);
+  if (input.vaultSyncRole === "snapshotter") {
+    const c12 = existsSync11(snapshotPath) ? check("pass", "vault_sync_installed", "Vault sync installed", `Found snapshot script: ${snapshotPath}`) : check("error", "vault_sync_installed", "Vault sync installed", `Snapshot script not found at ${snapshotPath}`);
+    const serviceScope = input.vaultSyncServiceScope ?? "user";
+    const userTimerPath = join29(home, ".config", "systemd", "user", "wiki-snapshot.timer");
+    const systemTimerPath = "/etc/systemd/system/wiki-snapshot.timer";
+    let c22;
+    if (serviceScope === "user" && existsSync11(userTimerPath)) {
+      c22 = check("pass", "vault_sync_jobs_enabled", "Vault sync jobs enabled", `Found: ${userTimerPath}`);
+    } else if (serviceScope === "system" && existsSync11(systemTimerPath)) {
+      c22 = check("pass", "vault_sync_jobs_enabled", "Vault sync jobs enabled", `Found: ${systemTimerPath}`);
+    } else if (os !== "linux") {
+      c22 = check("warn", "vault_sync_jobs_enabled", "Vault sync jobs enabled", "Snapshotter scheduler is Linux-only and no wiki-snapshot.timer file was found");
+    } else {
+      try {
+        const command = serviceScope === "system" ? "systemctl is-enabled wiki-snapshot.timer" : "systemctl --user is-enabled wiki-snapshot.timer";
+        const out = execSync2(command, {
+          encoding: "utf8",
+          timeout: 2e3,
+          stdio: ["pipe", "pipe", "pipe"]
+        }).trim();
+        c22 = out === "enabled" ? check("pass", "vault_sync_jobs_enabled", "Vault sync jobs enabled", `systemd: wiki-snapshot.timer enabled (${serviceScope})`) : check("error", "vault_sync_jobs_enabled", "Vault sync jobs enabled", `systemd: wiki-snapshot.timer is ${out || "not enabled"} (${serviceScope})`);
+      } catch {
+        c22 = check("error", "vault_sync_jobs_enabled", "Vault sync jobs enabled", `wiki-snapshot.timer check failed (${serviceScope})`);
+      }
+    }
+    const c32 = check(
+      "pass",
+      "vault_sync_last_push_age",
+      "Vault sync last push recency",
+      "Snapshotter host \u2014 leaf wiki-push log not applicable"
+    );
+    const cFetch2 = check(
+      "pass",
+      "vault_sync_last_fetch_status",
+      "Vault sync last fetch status",
+      "Snapshotter host \u2014 leaf wiki-fetch-notify log not applicable"
+    );
+    const c42 = check(
+      "pass",
+      "vault_sync_filter_present",
+      "Vault sync filter file present",
+      "Snapshotter host \u2014 leaf wiki-push filter not applicable"
+    );
+    let c52;
+    try {
+      if (!existsSync11(snapshotPath)) {
+        c52 = check(
+          "error",
+          "vault_sync_snapshot_guard",
+          "Snapshot script guard",
+          `Snapshot script not found at ${snapshotPath}`
+        );
+      } else {
+        const content = readFileSync7(snapshotPath, "utf8");
+        if (!content.includes("--max-delete")) {
+          c52 = check(
+            "error",
+            "vault_sync_snapshot_guard",
+            "Snapshot script guard",
+            `${snapshotPath} is missing --max-delete guard \u2014 dangerous without it`
+          );
+        } else {
+          c52 = check(
+            "pass",
+            "vault_sync_snapshot_guard",
+            "Snapshot script guard",
+            `--max-delete present in ${snapshotPath}`
+          );
+        }
+      }
+    } catch {
+      c52 = check(
+        "error",
+        "vault_sync_snapshot_guard",
+        "Snapshot script guard",
+        `Cannot read ${snapshotPath}`
+      );
+    }
+    return [c12, c22, c32, cFetch2, c42, c52];
+  }
   const pushScriptPath = join29(shareDir, "wiki-push.sh");
   const c1 = existsSync11(pushScriptPath) ? check("pass", "vault_sync_installed", "Vault sync installed", `Found: ${pushScriptPath}`) : check("error", "vault_sync_installed", "Vault sync installed", `Script not found at ${pushScriptPath} \u2014 run vault-sync-install`);
   let c2;
@@ -6270,7 +6399,7 @@ function vaultSyncChecks(input) {
         "Log file is empty"
       );
     } else {
-      const lastLine = lines[lines.length - 1];
+      const lastLine = [...lines].reverse().find((line) => /FAIL|OK push/.test(line)) ?? lines[lines.length - 1];
       if (/FAIL/.test(lastLine)) {
         c3 = check(
           "error",
@@ -6549,6 +6678,7 @@ async function vaultMetrics(resolvedPath) {
 }
 async function runDoctor(input) {
   const checks = [];
+  const devSourceRun = isDevSourceRun(input.argv);
   const vsConfig = readVaultSyncConfig(input.home);
   checks.push(checkNodeVersion());
   checks.push(checkCliChannels(input.argv, input.home));
@@ -6562,20 +6692,21 @@ async function runDoctor(input) {
     checks.push(check("error", "wiki_path_set", "WIKI_PATH configured", "No vault configured. Run `skillwiki init` or pass --vault."));
   }
   const resolvedPath = resolved.ok ? resolved.data.path : void 0;
+  const gitCheckPath = vsConfig.role === "snapshotter" ? resolveSnapshotGitWorktree(vsConfig) ?? resolvedPath : resolvedPath;
   checks.push(checkWikiPathExists(resolvedPath));
   checks.push(checkVaultStructure(resolvedPath));
   checks.push(checkObsidianTemplates(resolvedPath));
-  checks.push(checkVaultGitRemote(resolvedPath));
+  checks.push(checkVaultGitRemote(gitCheckPath));
   checks.push(await checkFleetIdentity({
     vaultPath: resolvedPath,
     home: input.home,
     cwd: input.cwd,
     envValue: input.envValue
   }));
-  checks.push(checkSyncLastPush(resolvedPath));
-  checks.push(checkVaultGitDirty(resolvedPath));
-  checks.push(checkVaultGitAhead(resolvedPath));
-  checks.push(checkVaultGitBehind(resolvedPath));
+  checks.push(checkSyncLastPush(gitCheckPath));
+  checks.push(checkVaultGitDirty(gitCheckPath));
+  checks.push(checkVaultGitAhead(gitCheckPath));
+  checks.push(checkVaultGitBehind(gitCheckPath));
   checks.push(checkVaultGitPullFailures(input.home));
   checks.push(checkDotStoreClean(resolvedPath));
   checks.push(checkS3MountPerf(resolvedPath));
@@ -6587,11 +6718,13 @@ async function runDoctor(input) {
   checks.push(checkSkillsInstalled(input.home, input.cwd));
   checks.push(checkDuplicateSkills(input.home));
   checks.push(checkNpmUpdate(input.home, input.currentVersion));
-  checks.push(checkPluginVersionDrift(input.home, input.currentVersion));
+  checks.push(checkPluginVersionDrift(input.home, input.currentVersion, devSourceRun));
   checks.push(...vaultSyncChecks({
     home: input.home,
     vaultSyncInstalled: vsConfig.installed,
-    vaultSyncRole: vsConfig.role
+    vaultSyncRole: vsConfig.role,
+    vaultSyncServiceScope: vsConfig.serviceScope,
+    snapshotScriptPath: vsConfig.snapshotScript
   }));
   checks.push(...await vaultMetrics(resolvedPath));
   const summary = {

package/package.json

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

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

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.9.11",
+  "version": "0.9.13",
   "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.11",
+  "version": "0.9.13",
   "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.11",
+  "version": "0.9.13",
   "private": true,
   "files": [
     "wiki-*",