codebase-wiki 0.1.0

package/dist/plugin/hooks/session-start.mjs

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+// SessionStart hook: emit a banner that the model sees as a system reminder.
+// Output format: JSON to stdout; Claude Code parses the hookSpecificOutput.
+// Falls back to plain stdout text when JSON is not supported.
+
+import { promises as fs } from 'node:fs'
+import path from 'node:path'
+
+async function main() {
+  const cwd = process.env.CODEWIKI_CWD || process.cwd()
+  const metaPath = path.join(cwd, '.codewiki', '.meta.json')
+  const reminders = []
+
+  try {
+    const meta = JSON.parse(await fs.readFile(metaPath, 'utf8'))
+    reminders.push(
+      `<system-reminder>\n` +
+        `code-wiki is enabled for this repo. A .codewiki/ index exists (built ${meta.updatedAt ?? 'recently'}, modules=${meta.moduleCount ?? '?'} files=${meta.fileCount ?? '?'} symbols=${meta.symbolCount ?? '?'}).\n` +
+        `Prefer reading .codewiki/INDEX.md and .codewiki/files/**/*.md over grepping source. Use the \`wiki_search\` MCP tool before grep.\n` +
+        `Commands: /wiki-build /wiki-refresh /wiki-search /wiki-symbol /wiki-architecture /wiki-graph /wiki-enrich /wiki-help.\n` +
+        `</system-reminder>`,
+    )
+  } catch {
+    reminders.push(
+      `<system-reminder>\n` +
+        `code-wiki is enabled but no .codewiki/ index yet. Run /wiki-build to create one before expecting wiki-aware behavior.\n` +
+        `</system-reminder>`,
+    )
+  }
+
+  // Output to stdout. Claude Code picks this up as additional context.
+  process.stdout.write(reminders.join('\n'))
+}
+
+main().catch(() => {
+  // never block session start on hook failure
+  process.exit(0)
+})

package/dist/plugin/hooks/user-prompt-submit.mjs

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+// UserPromptSubmit hook: emit a brief reminder after every user prompt.
+// Only fires when .codewiki/ exists.
+
+import { promises as fs } from 'node:fs'
+import path from 'node:path'
+
+async function main() {
+  const cwd = process.env.CODEWIKI_CWD || process.cwd()
+  const metaPath = path.join(cwd, '.codewiki', '.meta.json')
+
+  let exists = false
+  try {
+    await fs.stat(metaPath)
+    exists = true
+  } catch {
+    /* ignore */
+  }
+  if (!exists) return
+
+  process.stdout.write(
+    `<system-reminder>\n` +
+      `Reminder: prefer .codewiki/ pages (or the wiki_search MCP tool) over reading source files directly. If you edit files since the last index, run /wiki-refresh.\n` +
+      `</system-reminder>\n`,
+  )
+}
+
+main().catch(() => process.exit(0))

package/dist/plugin/manifest.json

@@ -0,0 +1,54 @@
+{
+  "name": "codebase-wiki",
+  "version": "0.1.0",
+  "description": "Token-efficient code wiki: builds a browsable .codewiki/ index and nudges the model toward reading summaries instead of raw source files.",
+  "author": {
+    "name": "code-wiki contributors"
+  },
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/<your-github-username>/code-wiki",
+  "repository": "https://github.com/<your-github-username>/code-wiki.git",
+  "keywords": [
+    "claude-code",
+    "plugin",
+    "code-search",
+    "wiki",
+    "tree-sitter",
+    "tokens",
+    "mcp"
+  ],
+  "mcpServers": {
+    "code-wiki": {
+      "command": "node",
+      "args": [
+        "${CLAUDE_PLUGIN_ROOT}/dist/code-wiki-mcp.mjs"
+      ],
+      "env": {
+        "CODEWIKI_CWD": "${workspaceFolder}"
+      }
+    }
+  },
+  "commands": "./commands",
+  "permissions": {
+    "allow": [
+      "Bash(codewiki build:*)",
+      "Bash(codewiki refresh:*)",
+      "Bash(codewiki search:*)",
+      "Bash(codewiki show:*)",
+      "Bash(codewiki enrich:*)",
+      "Bash(codewiki invalidate:*)",
+      "Bash(codewiki validate:*)",
+      "Read(./.codewiki/**)"
+    ],
+    "deny": [
+      "Write(./.codewiki/modules/**)",
+      "Write(./.codewiki/files/**)",
+      "Write(./.codewiki/symbols/**)",
+      "Write(./.codewiki/architecture.md)",
+      "Write(./.codewiki/INDEX.md)"
+    ],
+    "ask": [
+      "Bash(codewiki clean:*)"
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "codebase-wiki",
+  "version": "0.1.0",
+  "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": {
+    "type": "git",
+    "url": "git+https://github.com/harrycjs/code-wiki.git"
+  },
+  "bugs": {
+    "url": "https://github.com/harrycjs/code-wiki/issues"
+  },
+  "funding": "https://github.com/harrycjs",
+  "license": "Apache-2.0",
+  "type": "module",
+  "bin": {
+    "codewiki": "./dist/codewiki.mjs"
+  },
+  "main": "./dist/code-wiki.mjs",
+  "exports": {
+    ".": {
+      "import": "./dist/code-wiki.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "unbuild && node scripts/postbuild.mjs",
+    "dev": "unbuild --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check src tests examples",
+    "lint:fix": "biome check --write src tests examples",
+    "format": "biome format --write src tests examples",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "verify:grammars": "node scripts/verify-grammars.mjs",
+    "changeset": "changeset",
+    "version": "changeset version",
+    "release": "changeset publish"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.110.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "commander": "^15.0.0",
+    "globby": "^16.0.0",
+    "gpt-tokenizer": "^3.4.0",
+    "ignore": "^7.0.0",
+    "p-queue": "^9.3.0",
+    "p-retry": "^8.0.0",
+    "pino": "^10.0.0",
+    "simple-git": "^3.36.0",
+    "tree-sitter-c": "^0.24.1",
+    "tree-sitter-cpp": "^0.23.4",
+    "tree-sitter-go": "^0.25.0",
+    "tree-sitter-java": "^0.23.5",
+    "tree-sitter-javascript": "^0.25.0",
+    "tree-sitter-python": "^0.25.0",
+    "tree-sitter-ruby": "^0.23.1",
+    "tree-sitter-rust": "^0.24.0",
+    "tree-sitter-typescript": "^0.23.2",
+    "web-tree-sitter": "^0.26.10"
+  },
+  "optionalDependencies": {
+    "tree-sitter-cli": "^0.26.10"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.0",
+    "@changesets/cli": "^2.31.0",
+    "@types/node": "^22.10.0",
+    "chokidar": "^5.0.0",
+    "happy-dom": "^20.0.0",
+    "tsx": "^4.23.0",
+    "typescript": "^5.7.0",
+    "unbuild": "^3.6.0",
+    "vitest": "^4.0.0"
+  },
+  "keywords": [
+    "claude-code",
+    "plugin",
+    "code-search",
+    "wiki",
+    "tree-sitter",
+    "mcp",
+    "context",
+    "tokens",
+    "anthropic",
+    "ai",
+    "llm"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}