codebase-wiki 0.1.0 → 0.2.1

package/CHANGELOG.md

@@ -1,8 +1,24 @@
 # Changelog
 
+## 0.2.0
+
+### Minor Changes
+
+- 03a4d29: Initial v0.1.0 release of `code-wiki`.
+
+  - M1: scaffold + walker + minimal render.
+  - M2: tree-sitter extraction for TS/JS/TSX/JSX.
+  - M3: 7 more language extractors (Python / Go / Rust / Java / C / C++ / Ruby).
+  - M4: graph extraction — imports + dependents; usable by `wiki_callers` / `wiki_callees` MCP tools.
+  - M5: MCP resource pagination, smarter auto-nudge hooks (config-driven, freshness-aware).
+  - M6: incremental refresh — `codewiki refresh` uses git diff; `codewiki watch` runs chokidar.
+  - M7: optional LLM enrichment — file-level Haiku + module-level Sonnet, content-hash cached.
+  - M8: Mermaid diagrams in architecture.md and module pages.
+
 ## [Unreleased]
 
 ### Fixed
+
 - Slash commands now invoke `${CLAUDE_PLUGIN_ROOT}/dist/codewiki.mjs` directly
   instead of relying on a globally-installed `codewiki` binary. Plugin is fully
   self-contained.
@@ -18,11 +34,13 @@
   similar packages had escaped inlining under the old config).
 
 ### Pending
+
 - v0.1.0 tag — all 9 milestones + install fix ready.
 
 ## v0.1.0 (in progress, target tag)
 
 ### Added
+
 - M1: scaffolding, walker, minimal render, hooks, MCP server stub.
 - M2: tree-sitter extraction (TS / JS / TSX / JSX).
 - M3: 7 more language extractors (Python / Go / Rust / Java / C / C++ / Ruby).

package/dist/CHANGELOG.md

@@ -1,8 +1,24 @@
 # Changelog
 
+## 0.2.0
+
+### Minor Changes
+
+- 03a4d29: Initial v0.1.0 release of `code-wiki`.
+
+  - M1: scaffold + walker + minimal render.
+  - M2: tree-sitter extraction for TS/JS/TSX/JSX.
+  - M3: 7 more language extractors (Python / Go / Rust / Java / C / C++ / Ruby).
+  - M4: graph extraction — imports + dependents; usable by `wiki_callers` / `wiki_callees` MCP tools.
+  - M5: MCP resource pagination, smarter auto-nudge hooks (config-driven, freshness-aware).
+  - M6: incremental refresh — `codewiki refresh` uses git diff; `codewiki watch` runs chokidar.
+  - M7: optional LLM enrichment — file-level Haiku + module-level Sonnet, content-hash cached.
+  - M8: Mermaid diagrams in architecture.md and module pages.
+
 ## [Unreleased]
 
 ### Fixed
+
 - Slash commands now invoke `${CLAUDE_PLUGIN_ROOT}/dist/codewiki.mjs` directly
   instead of relying on a globally-installed `codewiki` binary. Plugin is fully
   self-contained.
@@ -18,11 +34,13 @@
   similar packages had escaped inlining under the old config).
 
 ### Pending
+
 - v0.1.0 tag — all 9 milestones + install fix ready.
 
 ## v0.1.0 (in progress, target tag)
 
 ### Added
+
 - M1: scaffolding, walker, minimal render, hooks, MCP server stub.
 - M2: tree-sitter extraction (TS / JS / TSX / JSX).
 - M3: 7 more language extractors (Python / Go / Rust / Java / C / C++ / Ruby).

package/dist/chunks/build.mjs

@@ -1,10 +1,11 @@
 import path__default from 'node:path';
 import { promises } from 'node:fs';
-import { c as repoRel, a as log, t as toPosix, l as loadConfig, d as child, f as configSummary, w as writeJson, b as atomicWriteText, e as exists } from './config.mjs';
+import { b as repoRel, l as log, t as toPosix, c as child, w as writeJson, a as atomicWriteText, e as exists } from '../shared/codebase-wiki.CzOYKZWm.mjs';
+import { loadConfig, configSummary } from './config.mjs';
 import ignore from 'ignore';
 import { globby } from 'globby';
+import { c as countTokens, g as groupModules, m as moduleForFile } from '../shared/codebase-wiki.Wp4qpPB-.mjs';
 import { createHash } from 'node:crypto';
-import { encode } from 'gpt-tokenizer/encoding/cl100k_base';
 import { Language, Parser, Query } from 'web-tree-sitter';
 
 const EXT_TO_LANG = {
@@ -83,82 +84,10 @@ const walker = {
   walkFiles: walkFiles
 };
 
-const TEST_PATTERNS = [
-  /(^|\/)__tests__\//,
-  /\.test\.[a-z]+$/,
-  /\.spec\.[a-z]+$/,
-  /(^|\/)test_(.+)\.[a-z]+$/,
-  /(^|\/)(.+)_test\.[a-z]+$/,
-  /(^|\/)spec\//
-];
-function isTestFile(repoPath) {
-  return TEST_PATTERNS.some((re) => re.test(repoPath));
-}
-function moduleForFile(repoPath, cfg) {
-  if (isTestFile(repoPath)) return "_tests";
-  for (const [from, to] of Object.entries(cfg.modules.alias)) {
-    if (repoPath === from || repoPath.startsWith(`${from}/`)) {
-      const remainder = repoPath.slice(from.length).replace(/^\//, "");
-      const top2 = remainder.split("/")[0] || "_root";
-      const candidate = `${to}/${remainder === "" ? "" : top2}`.replace(/\/$/, "");
-      return candidate.split("/")[0] || "_root";
-    }
-  }
-  const top = repoPath.split("/")[0];
-  return top || "_root";
-}
-function groupModules(files, cfg) {
-  const map = /* @__PURE__ */ new Map();
-  for (const f of files) {
-    if (f.repoPath.startsWith(".codewiki/")) continue;
-    const id = moduleForFile(f.repoPath, cfg);
-    let entry = map.get(id);
-    if (!entry) {
-      entry = {
-        id,
-        title: id,
-        files: [],
-        publicSurface: []
-      };
-      map.set(id, entry);
-    }
-    entry.files.push(f.repoPath);
-    for (const s of f.publicSymbols) {
-      entry.publicSurface.push(`${s.kind === "method" ? "method" : s.kind} ${s.name}`);
-    }
-  }
-  for (const id of [...map.keys()]) {
-    if (cfg.modules.ignore.includes(id)) {
-      map.delete(id);
-    }
-  }
-  return map;
-}
-
 function sha256Hex(input) {
   return createHash("sha256").update(input).digest("hex");
 }
 
-function countTokens(input) {
-  if (!input) return 0;
-  return encode(input).length;
-}
-function truncateToTokens(text, budget, ellipsis = "\u2026") {
-  const current = countTokens(text);
-  if (current <= budget) return text;
-  let lo = 0;
-  let hi = text.length;
-  while (lo < hi) {
-    const mid = lo + hi + 1 >> 1;
-    if (countTokens(text.slice(0, mid)) <= budget - 1) {
-      lo = mid;
-    } else {
-      hi = mid - 1;
-    }
-  }
-  return text.slice(0, lo).trimEnd() + (lo > 0 ? " " + ellipsis : "");
-}
-
 const GENERATOR = `code-wiki`;
 const VERSION = "0.1.0";
 function frontmatter(page) {
@@ -1973,4 +1902,4 @@ async function replaceDir(target, replacement) {
   await promises.rename(replacement, target);
 }
 
-export { walker as a, buildWiki as b, countTokens as c, detectLanguage as d, groupModules as g, moduleForFile as m, truncateToTokens as t, walkFiles as w };
+export { walker as a, buildWiki as b, detectLanguage as d, walkFiles as w };

package/dist/chunks/config.mjs

@@ -1,59 +1,9 @@
-import pino from 'pino';
 import { promises } from 'node:fs';
 import path__default from 'node:path';
+import { r as readJson, t as toPosix } from '../shared/codebase-wiki.CzOYKZWm.mjs';
+import 'pino';
 import 'node:os';
 
-const level = process.env.CODEWIKI_LOG ?? (process.env.NODE_ENV === "test" ? "silent" : "info");
-const log = pino({
-  level,
-  base: { name: "code-wiki" },
-  timestamp: pino.stdTimeFunctions.isoTime
-});
-const child = (bindings) => log.child(bindings);
-
-function toPosix(p) {
-  return p.replace(/\\/g, "/");
-}
-async function exists(filePath) {
-  try {
-    await promises.access(filePath);
-    return true;
-  } catch {
-    return false;
-  }
-}
-async function readText(filePath) {
-  return promises.readFile(filePath, "utf8");
-}
-async function readJson(filePath) {
-  try {
-    const text = await readText(filePath);
-    return JSON.parse(text);
-  } catch {
-    return null;
-  }
-}
-async function writeText(filePath, content) {
-  const dir = path__default.dirname(filePath);
-  await promises.mkdir(dir, { recursive: true });
-  await promises.writeFile(filePath, content, "utf8");
-}
-async function writeJson(filePath, value) {
-  const text = JSON.stringify(value, null, 2) + "\n";
-  await writeText(filePath, text);
-}
-async function atomicWriteText(target, content) {
-  const dir = path__default.dirname(target);
-  await promises.mkdir(dir, { recursive: true });
-  const tmp = path__default.join(dir, `.tmp.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2, 8)}`);
-  await promises.writeFile(tmp, content, "utf8");
-  await promises.rename(tmp, target);
-}
-function repoRel(absolute, root) {
-  const rel = path__default.relative(root, absolute);
-  return toPosix(rel).replace(/^\.\//, "");
-}
-
 const DEFAULT_CONFIG = {
   outDir: ".codewiki",
   sourceRoots: ["."],
@@ -164,11 +114,4 @@ function configSummary(c) {
   ].join(" ");
 }
 
-const config = {
-  __proto__: null,
-  DEFAULT_CONFIG: DEFAULT_CONFIG,
-  configSummary: configSummary,
-  loadConfig: loadConfig
-};
-
-export { DEFAULT_CONFIG as D, log as a, atomicWriteText as b, repoRel as c, child as d, exists as e, configSummary as f, config as g, loadConfig as l, readJson as r, toPosix as t, writeJson as w };
+export { DEFAULT_CONFIG, configSummary, loadConfig };

package/dist/chunks/llm.mjs

@@ -4,14 +4,11 @@ import { createHash } from 'node:crypto';
 import Anthropic from '@anthropic-ai/sdk';
 import PQueue from 'p-queue';
 import pRetry from 'p-retry';
-import { a as log, r as readJson, w as writeJson } from './config.mjs';
-import { g as groupModules, c as countTokens } from './build.mjs';
+import { l as log, r as readJson, w as writeJson } from '../shared/codebase-wiki.CzOYKZWm.mjs';
+import { g as groupModules, c as countTokens } from '../shared/codebase-wiki.Wp4qpPB-.mjs';
 import 'pino';
 import 'node:os';
-import 'ignore';
-import 'globby';
 import 'gpt-tokenizer/encoding/cl100k_base';
-import 'web-tree-sitter';
 
 const SYSTEM_PROMPT = "You are a precise code summarizer. Output ONLY a one-line PURPOSE and a 1-3 sentence NOTES section. No bullet lists, no headings, no markdown formatting. Tone: terse, technical, factual.";
 function client(opts) {
@@ -188,7 +185,7 @@ async function enrichAll(opts) {
   return { files, modules };
 }
 async function runEnrichmentCli(cwd, opts = {}) {
-  const { loadConfig } = await import('./config.mjs').then(function (n) { return n.g; });
+  const { loadConfig } = await import('./config.mjs');
   const { walkFiles } = await import('./build.mjs').then(function (n) { return n.a; });
   const cfg = await loadConfig(cwd);
   const walked = await walkFiles({ root: cwd, ignoreGlobs: cfg.ignore });

package/dist/code-wiki-mcp.mjs

@@ -4,7 +4,8 @@ import path__default from 'node:path';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';
-import { l as loadConfig, r as readJson, a as log } from './chunks/config.mjs';
+import { r as readJson, l as log } from './shared/codebase-wiki.CzOYKZWm.mjs';
+import { loadConfig } from './chunks/config.mjs';
 import 'pino';
 import 'node:fs';
 import 'node:os';

package/dist/code-wiki.mjs

@@ -1,11 +1,13 @@
-export { b as buildWiki, c as countTokens, d as detectLanguage, g as groupModules, m as moduleForFile, t as truncateToTokens, w as walkFiles } from './chunks/build.mjs';
-export { D as DEFAULT_CONFIG, l as loadConfig } from './chunks/config.mjs';
+export { b as buildWiki, d as detectLanguage, w as walkFiles } from './chunks/build.mjs';
+export { DEFAULT_CONFIG, loadConfig } from './chunks/config.mjs';
+export { c as countTokens, g as groupModules, m as moduleForFile, t as truncateToTokens } from './shared/codebase-wiki.Wp4qpPB-.mjs';
 import 'node:path';
 import 'node:fs';
+import './shared/codebase-wiki.CzOYKZWm.mjs';
+import 'pino';
+import 'node:os';
 import 'ignore';
 import 'globby';
 import 'node:crypto';
-import 'gpt-tokenizer/encoding/cl100k_base';
 import 'web-tree-sitter';
-import 'pino';
-import 'node:os';
+import 'gpt-tokenizer/encoding/cl100k_base';

package/dist/codewiki.mjs

@@ -2,6 +2,7 @@
 import process$1 from 'node:process';
 import * as path from 'node:path';
 import path__default, { resolve, join, relative, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { Command } from 'commander';
 import { EventEmitter } from 'node:events';
 import { unwatchFile, watchFile, watch as watch$1, stat as stat$1 } from 'node:fs';
@@ -9,12 +10,14 @@ import { lstat, stat, readdir, realpath, open } from 'node:fs/promises';
 import { Readable } from 'node:stream';
 import { type } from 'node:os';
 import { b as buildWiki } from './chunks/build.mjs';
-import { r as readJson, w as writeJson, b as atomicWriteText, l as loadConfig, e as exists } from './chunks/config.mjs';
+import { loadConfig } from './chunks/config.mjs';
+import { r as readJson, w as writeJson, a as atomicWriteText, e as exists } from './shared/codebase-wiki.CzOYKZWm.mjs';
 import { simpleGit } from 'simple-git';
 import 'ignore';
 import 'globby';
-import 'node:crypto';
+import './shared/codebase-wiki.Wp4qpPB-.mjs';
 import 'gpt-tokenizer/encoding/cl100k_base';
+import 'node:crypto';
 import 'web-tree-sitter';
 import 'pino';
 
@@ -1768,7 +1771,24 @@ async function enqueueInvalidation(cwd, repoPath) {
   await atomicWriteText(p, JSON.stringify(state, null, 2));
 }
 
-const pkg = { version: "0.1.0" };
+const here = path__default.dirname(fileURLToPath(import.meta.url));
+let pkgVersion = "0.0.0";
+for (const candidate of [
+  path__default.join(here, "..", "package.json"),
+  path__default.join(here, "..", "..", "package.json"),
+  path__default.join(here, "..", "..", "..", "package.json")
+]) {
+  try {
+    const txt = await import('node:fs/promises').then((m) => m.readFile(candidate, "utf8"));
+    const parsed = JSON.parse(txt);
+    if (parsed?.name === "codebase-wiki" && parsed.version) {
+      pkgVersion = parsed.version;
+      break;
+    }
+  } catch {
+  }
+}
+const pkg = { version: pkgVersion };
 async function main() {
   const program = new Command();
   program.name("codewiki").description("Token-efficient code wiki generator and Claude Code plugin entry point").version(pkg.version).option("--cwd <path>", "project root", process$1.cwd());
@@ -1935,11 +1955,12 @@ async function main() {
     const cfg = await loadConfig(cwd);
     const wikiBase = path__default.join(cwd, cfg.outDir);
     const rel = String(pathOrSymbol).replace(/^\.\//, "");
+    const symbolPath = rel.includes("::") ? rel.replace(/::/g, "/") + ".md" : null;
     const candidates = [
       path__default.join(wikiBase, rel.endsWith(".md") ? rel : `${rel}.md`),
       path__default.join(wikiBase, "files", `${rel}.md`),
       path__default.join(wikiBase, "modules", `${rel}.md`),
-      path__default.join(wikiBase, "symbols", `${rel.replace("::", "/")}.md`)
+      ...symbolPath ? [path__default.join(wikiBase, "symbols", symbolPath)] : []
     ];
     for (const c of candidates) {
       if (await exists(c)) {

package/dist/shared/codebase-wiki.CzOYKZWm.mjs

@@ -0,0 +1,57 @@
+import pino from 'pino';
+import { promises } from 'node:fs';
+import path__default from 'node:path';
+import 'node:os';
+
+const level = process.env.CODEWIKI_LOG ?? (process.env.NODE_ENV === "test" ? "silent" : "info");
+const log = pino({
+  level,
+  base: { name: "code-wiki" },
+  timestamp: pino.stdTimeFunctions.isoTime
+});
+const child = (bindings) => log.child(bindings);
+
+function toPosix(p) {
+  return p.replace(/\\/g, "/");
+}
+async function exists(filePath) {
+  try {
+    await promises.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function readText(filePath) {
+  return promises.readFile(filePath, "utf8");
+}
+async function readJson(filePath) {
+  try {
+    const text = await readText(filePath);
+    return JSON.parse(text);
+  } catch {
+    return null;
+  }
+}
+async function writeText(filePath, content) {
+  const dir = path__default.dirname(filePath);
+  await promises.mkdir(dir, { recursive: true });
+  await promises.writeFile(filePath, content, "utf8");
+}
+async function writeJson(filePath, value) {
+  const text = JSON.stringify(value, null, 2) + "\n";
+  await writeText(filePath, text);
+}
+async function atomicWriteText(target, content) {
+  const dir = path__default.dirname(target);
+  await promises.mkdir(dir, { recursive: true });
+  const tmp = path__default.join(dir, `.tmp.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2, 8)}`);
+  await promises.writeFile(tmp, content, "utf8");
+  await promises.rename(tmp, target);
+}
+function repoRel(absolute, root) {
+  const rel = path__default.relative(root, absolute);
+  return toPosix(rel).replace(/^\.\//, "");
+}
+
+export { atomicWriteText as a, repoRel as b, child as c, exists as e, log as l, readJson as r, toPosix as t, writeJson as w };

package/dist/shared/codebase-wiki.Wp4qpPB-.mjs

@@ -0,0 +1,75 @@
+import { encode } from 'gpt-tokenizer/encoding/cl100k_base';
+
+const TEST_PATTERNS = [
+  /(^|\/)__tests__\//,
+  /\.test\.[a-z]+$/,
+  /\.spec\.[a-z]+$/,
+  /(^|\/)test_(.+)\.[a-z]+$/,
+  /(^|\/)(.+)_test\.[a-z]+$/,
+  /(^|\/)spec\//
+];
+function isTestFile(repoPath) {
+  return TEST_PATTERNS.some((re) => re.test(repoPath));
+}
+function moduleForFile(repoPath, cfg) {
+  if (isTestFile(repoPath)) return "_tests";
+  for (const [from, to] of Object.entries(cfg.modules.alias)) {
+    if (repoPath === from || repoPath.startsWith(`${from}/`)) {
+      const remainder = repoPath.slice(from.length).replace(/^\//, "");
+      const top2 = remainder.split("/")[0] || "_root";
+      const candidate = `${to}/${remainder === "" ? "" : top2}`.replace(/\/$/, "");
+      return candidate.split("/")[0] || "_root";
+    }
+  }
+  const top = repoPath.split("/")[0];
+  return top || "_root";
+}
+function groupModules(files, cfg) {
+  const map = /* @__PURE__ */ new Map();
+  for (const f of files) {
+    if (f.repoPath.startsWith(".codewiki/")) continue;
+    const id = moduleForFile(f.repoPath, cfg);
+    let entry = map.get(id);
+    if (!entry) {
+      entry = {
+        id,
+        title: id,
+        files: [],
+        publicSurface: []
+      };
+      map.set(id, entry);
+    }
+    entry.files.push(f.repoPath);
+    for (const s of f.publicSymbols) {
+      entry.publicSurface.push(`${s.kind === "method" ? "method" : s.kind} ${s.name}`);
+    }
+  }
+  for (const id of [...map.keys()]) {
+    if (cfg.modules.ignore.includes(id)) {
+      map.delete(id);
+    }
+  }
+  return map;
+}
+
+function countTokens(input) {
+  if (!input) return 0;
+  return encode(input).length;
+}
+function truncateToTokens(text, budget, ellipsis = "\u2026") {
+  const current = countTokens(text);
+  if (current <= budget) return text;
+  let lo = 0;
+  let hi = text.length;
+  while (lo < hi) {
+    const mid = lo + hi + 1 >> 1;
+    if (countTokens(text.slice(0, mid)) <= budget - 1) {
+      lo = mid;
+    } else {
+      hi = mid - 1;
+    }
+  }
+  return text.slice(0, lo).trimEnd() + (lo > 0 ? " " + ellipsis : "");
+}
+
+export { countTokens as c, groupModules as g, moduleForFile as m, truncateToTokens as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codebase-wiki",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Token-efficient code wiki for Claude Code. Generates a browsable .codewiki/ index so models read summaries on-demand.",
   "homepage": "https://github.com/harrycjs/code-wiki",
   "repository": {