llm-wiki-kit 0.1.4 → 0.1.5

package/docs/troubleshooting.md

@@ -71,6 +71,32 @@ sudo npm install -g llm-wiki-kit@latest
 
 If the proxy performs TLS inspection, install the organization's CA and set `cafile` instead of disabling TLS verification. As a temporary diagnostic only, `sudo npm config set strict-ssl false` can confirm that the failure is CA-related, but do not keep that setting in production.
 
+## npm install -g Succeeds But llm-wiki Is Still Old
+
+If `npm install -g llm-wiki-kit@latest` succeeds but `llm-wiki --help` does not show newer commands such as `projects` or `version`, the shell is probably executing an older source checkout or stale shim before the npm global binary.
+
+Confirm what is actually running:
+
+```bash
+which -a llm-wiki
+readlink -f "$(command -v llm-wiki)"
+npm ls -g llm-wiki-kit --depth=0
+npm root -g
+node "$(npm root -g)/llm-wiki-kit/bin/llm-wiki.js" version
+```
+
+If the direct `node "$(npm root -g)/llm-wiki-kit/bin/llm-wiki.js" version` command prints the latest version but plain `llm-wiki` is old, fix `PATH` or replace the stale shim:
+
+```bash
+mkdir -p "$HOME/.local/bin"
+ln -sfn "$(npm root -g)/llm-wiki-kit/bin/llm-wiki.js" "$HOME/.local/bin/llm-wiki"
+export PATH="$HOME/.local/bin:$PATH"
+hash -r
+llm-wiki status
+```
+
+If `readlink -f "$(command -v llm-wiki)"` points at a repository checkout such as `/mnt/d/dev_proj/llm-wiki-kit/bin/llm-wiki.js`, `npm install -g` is not updating that checkout. Either switch the shim to the npm package as above, or update the checkout itself with `git pull` and run it intentionally as source.
+
 ## npm install -g Fails With EACCES
 
 If npm tries to write under `/usr` and fails with `EACCES`, use sudo when the server policy allows system-wide global packages:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "llm-wiki-kit",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Hook-first living LLM Wiki runtime for Codex and Claude Code.",
   "type": "module",
   "files": [

package/src/cli.js

@@ -183,6 +183,8 @@ function formatStatus(value) {
     `- version: ${value.runtimeVersion}`,
     `- runtime: ${value.runtimeVersion} (${value.installSource})`,
     `- bin: ${value.binPath}`,
+    `- command: ${value.commandPath || 'not found'}`,
+    `- command matches runtime: ${value.commandMatchesRuntime ? 'yes' : 'no'}`,
     `- hooks current: ${value.hooksCurrent ? 'yes' : 'no'}`,
     `- codex hook: ${value.codexInstalled ? 'current' : 'missing/outdated'}`,
     `- claude hook: ${value.claudeInstalled ? 'current' : 'missing/outdated'}`,

package/src/doctor.js

@@ -17,6 +17,8 @@ export async function runDoctor() {
   add('node >= 20', nodeMajor() >= 20, process.version);
   add('runtime version detected', Boolean(stat.runtimeVersion), stat.runtimeVersion || 'unknown');
   add('llm-wiki bin exists', await exists(stat.binPath), stat.binPath);
+  add('runtime installed from npm', stat.installSource === 'npm', `${stat.installSource}; npm install -g does not update source checkouts`);
+  add('llm-wiki command resolves to current runtime', stat.commandMatchesRuntime, stat.commandPath ? `command=${stat.commandPath}; runtime=${stat.binPath}` : 'command not found on PATH');
   add('Codex hook installed', stat.codexInstalled, stat.codexHooksPath);
   add('Claude hook installed', stat.claudeInstalled, stat.claudeSettingsPath);
   add('project templates current', stat.project.managedFilesCurrent, stat.project.statePath);

package/src/install.js

@@ -1,4 +1,6 @@
+import { realpathSync } from 'fs';
 import { chmod } from 'fs/promises';
+import { spawnSync } from 'child_process';
 import { join, resolve } from 'path';
 import { CLAUDE_EVENTS, CODEX_EVENTS, KIT_NAME } from './constants.js';
 import { backupFile, ensureDir, exists, homeDir, readJson, safeSymlink, writeJson } from './fs-utils.js';
@@ -15,6 +17,23 @@ export function hookCommand(provider, eventName) {
   return `${shellQuote(process.execPath)} ${shellQuote(binPath)} hook ${provider} ${eventName}`;
 }
 
+function llmWikiCommandPaths() {
+  const result = spawnSync('sh', ['-lc', 'which -a llm-wiki 2>/dev/null || true'], {
+    encoding: 'utf8',
+  });
+  if (result.error) return [];
+  return [...new Set(result.stdout.split(/\r?\n/).map((line) => line.trim()).filter(Boolean))];
+}
+
+function realpathOrOriginal(path) {
+  if (!path) return null;
+  try {
+    return realpathSync(path);
+  } catch {
+    return path;
+  }
+}
+
 function addHook(hooks, eventName, command, options = {}) {
   hooks[eventName] = Array.isArray(hooks[eventName]) ? hooks[eventName] : [];
   const already = JSON.stringify(hooks[eventName]).includes(command);
@@ -151,11 +170,18 @@ export async function status(options = {}) {
   const claude = await readJson(claudeSettingsPath, {});
   const codexInstalled = JSON.stringify(codex.hooks || {}).includes(binPath);
   const claudeInstalled = JSON.stringify(claude.hooks || {}).includes(binPath);
+  const commandPaths = llmWikiCommandPaths();
+  const commandPath = commandPaths[0] || null;
+  const resolvedCommandPath = realpathOrOriginal(commandPath);
+  const resolvedBinPath = realpathOrOriginal(binPath);
   return {
     runtimeVersion: runtimeVersion(),
     packageRoot,
     installSource: detectInstallSource(),
     binPath,
+    commandPath,
+    commandPaths,
+    commandMatchesRuntime: Boolean(resolvedCommandPath && resolvedBinPath && resolvedCommandPath === resolvedBinPath),
     codexInstalled,
     claudeInstalled,
     hooksCurrent: codexInstalled && claudeInstalled,