@sanqianx/project-knowledge 4.6.1

package/docs/assets/architecture.svg

@@ -0,0 +1,182 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1180 620" role="img" aria-label="Architecture">
+  <defs>
+    <linearGradient id="card" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0" stop-color="#1a2330"/>
+      <stop offset="1" stop-color="#141c26"/>
+    </linearGradient>
+    <linearGradient id="cardHover" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0" stop-color="#1f2a3a"/>
+      <stop offset="1" stop-color="#192331"/>
+    </linearGradient>
+    <marker id="arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse">
+      <path d="M 0 0 L 10 5 L 0 10 z" fill="#7492a5"/>
+    </marker>
+  </defs>
+
+  <rect width="1180" height="620" fill="#0c1118"/>
+
+  <!-- Title -->
+  <text x="590" y="42" text-anchor="middle" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="17" font-weight="600" fill="#e3ebf5" letter-spacing="-0.2">How project-knowledge works</text>
+  <text x="590" y="62" text-anchor="middle" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif" font-size="11.5" fill="#94a3b8">Local-first pipeline · every byte stays under your home directory</text>
+
+  <!-- Layer labels -->
+  <g font-family="ui-monospace, Consolas, monospace" font-size="9.5" fill="#64748b" letter-spacing="1.5" font-weight="600">
+    <text x="28" y="150">USER · UI</text>
+    <text x="28" y="282">SERVER</text>
+    <text x="28" y="438">DATA · GIT</text>
+    <text x="28" y="582">EXTERNAL</text>
+  </g>
+
+  <!-- Layer 1: User-facing -->
+  <g transform="translate(120,86)" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif">
+    <g>
+      <rect width="252" height="116" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
+      <text x="16" y="22" font-size="12" font-weight="600" fill="#cbd5e1">Browser Dashboard</text>
+      <text x="16" y="38" font-size="10" fill="#64748b" font-family="ui-monospace, Consolas, monospace">127.0.0.1:5757</text>
+      <g font-size="10.5" fill="#94a3b8">
+        <text x="16" y="60">· Project sidebar</text>
+        <text x="16" y="76">· Supervision cards</text>
+        <text x="16" y="92">· Runs / Drafts review</text>
+        <text x="16" y="108">· Claude workbench</text>
+      </g>
+    </g>
+
+    <g transform="translate(264,0)">
+      <rect width="252" height="116" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
+      <text x="16" y="22" font-size="12" font-weight="600" fill="#cbd5e1">CLI daemon</text>
+      <text x="16" y="38" font-size="10" fill="#64748b" font-family="ui-monospace, Consolas, monospace">start · stop · status · --fg</text>
+      <g font-size="10.5" fill="#94a3b8">
+        <text x="16" y="60">· Port fallback 5757–5776</text>
+        <text x="16" y="76">· PID file in os.tmpdir()</text>
+        <text x="16" y="92">· Auto-open browser</text>
+        <text x="16" y="108">· Survives terminal close</text>
+      </g>
+    </g>
+
+    <g transform="translate(528,0)">
+      <rect width="252" height="116" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
+      <text x="16" y="22" font-size="12" font-weight="600" fill="#cbd5e1">Post-commit hook</text>
+      <text x="16" y="38" font-size="10" fill="#64748b" font-family="ui-monospace, Consolas, monospace">.git/hooks/post-commit</text>
+      <g font-size="10.5" fill="#94a3b8">
+        <text x="16" y="60">· Fires on git commit</text>
+        <text x="16" y="76">· Triggers scan + analysis</text>
+        <text x="16" y="92">· Injects KB reading rule</text>
+        <text x="16" y="108">  into project's CLAUDE.md</text>
+      </g>
+    </g>
+
+    <g transform="translate(792,0)">
+      <rect width="252" height="116" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
+      <text x="16" y="22" font-size="12" font-weight="600" fill="#cbd5e1">Claude Code / agents</text>
+      <text x="16" y="38" font-size="10" fill="#64748b" font-family="ui-monospace, Consolas, monospace">reads KB indexes first</text>
+      <g font-size="10.5" fill="#94a3b8">
+        <text x="16" y="60">· Reads GOAL.md</text>
+        <text x="16" y="76">· Reads modules/00-index.md</text>
+        <text x="16" y="92">· Reads changes/00-index.md</text>
+        <text x="16" y="108">· Opens only top-matched files</text>
+      </g>
+    </g>
+  </g>
+
+  <!-- Layer 2: Server -->
+  <g transform="translate(120,220)" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif">
+    <rect width="1044" height="124" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
+    <text x="16" y="22" font-size="12" font-weight="600" fill="#cbd5e1">Local HTTP server · Node.js · 127.0.0.1 only</text>
+
+    <g font-size="10">
+      <g transform="translate(16,40)">
+        <rect width="148" height="32" rx="6" fill="rgba(125,211,252,0.08)" stroke="rgba(125,211,252,0.25)"/>
+        <text x="74" y="14" font-size="10.5" fill="#7dd3fc" text-anchor="middle" font-weight="600">scanner.js</text>
+        <text x="74" y="26" font-size="9" fill="#64748b" text-anchor="middle">git state walker</text>
+      </g>
+      <g transform="translate(176,40)">
+        <rect width="170" height="32" rx="6" fill="rgba(125,211,252,0.08)" stroke="rgba(125,211,252,0.25)"/>
+        <text x="85" y="14" font-size="10.5" fill="#7dd3fc" text-anchor="middle" font-weight="600">analysis-orchestrator</text>
+        <text x="85" y="26" font-size="9" fill="#64748b" text-anchor="middle">commit / initial</text>
+      </g>
+      <g transform="translate(358,40)">
+        <rect width="160" height="32" rx="6" fill="rgba(125,211,252,0.08)" stroke="rgba(125,211,252,0.25)"/>
+        <text x="80" y="14" font-size="10.5" fill="#7dd3fc" text-anchor="middle" font-weight="600">context-pack-builder</text>
+        <text x="80" y="26" font-size="9" fill="#64748b" text-anchor="middle">prompt assembly</text>
+      </g>
+      <g transform="translate(530,40)">
+        <rect width="132" height="32" rx="6" fill="rgba(125,211,252,0.08)" stroke="rgba(125,211,252,0.25)"/>
+        <text x="66" y="14" font-size="10.5" fill="#7dd3fc" text-anchor="middle" font-weight="600">kb-framework</text>
+        <text x="66" y="26" font-size="9" fill="#64748b" text-anchor="middle">layout / validate</text>
+      </g>
+      <g transform="translate(674,40)">
+        <rect width="120" height="32" rx="6" fill="rgba(125,211,252,0.08)" stroke="rgba(125,211,252,0.25)"/>
+        <text x="60" y="14" font-size="10.5" fill="#7dd3fc" text-anchor="middle" font-weight="600">draft-apply</text>
+        <text x="60" y="26" font-size="9" fill="#64748b" text-anchor="middle">review / merge</text>
+      </g>
+      <g transform="translate(806,40)">
+        <rect width="222" height="32" rx="6" fill="rgba(125,211,252,0.08)" stroke="rgba(125,211,252,0.25)"/>
+        <text x="111" y="14" font-size="10.5" fill="#7dd3fc" text-anchor="middle" font-weight="600">github-team-store</text>
+        <text x="111" y="26" font-size="9" fill="#64748b" text-anchor="middle">Gitea OAuth · sparse checkout</text>
+      </g>
+    </g>
+    <text x="16" y="100" font-size="10" font-family="ui-monospace, Consolas, monospace" fill="#64748b">REST + WebSocket on a single port · SPA shell from _site/index.html</text>
+  </g>
+
+  <!-- Layer 3: Data + git -->
+  <g transform="translate(120,376)" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif">
+    <g>
+      <rect width="252" height="124" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
+      <text x="16" y="22" font-size="12" font-weight="600" fill="#cbd5e1">~/.project-knowledge/</text>
+      <text x="16" y="38" font-size="10" fill="#64748b" font-family="ui-monospace, Consolas, monospace">or $KB_DATA_DIR</text>
+      <g font-size="10.5" font-family="ui-monospace, Consolas, monospace" fill="#94a3b8">
+        <text x="16" y="62">projects.json</text>
+        <text x="16" y="78">ai-profiles.json</text>
+        <text x="16" y="94">knowledge-store.json</text>
+        <text x="16" y="110">logs/  ·  _ai/  ·  projects/</text>
+      </g>
+    </g>
+    <g transform="translate(264,0)">
+      <rect width="252" height="124" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
+      <text x="16" y="22" font-size="12" font-weight="600" fill="#cbd5e1">Your Git projects</text>
+      <text x="16" y="38" font-size="10" fill="#64748b" font-family="ui-monospace, Consolas, monospace">local paths · local repos</text>
+      <g font-size="10.5" font-family="ui-monospace, Consolas, monospace" fill="#94a3b8">
+        <text x="16" y="62">git status / log / branch</text>
+        <text x="16" y="78">HEAD metadata</text>
+        <text x="16" y="94">.git/hooks/post-commit</text>
+        <text x="16" y="110">CLAUDE.md (managed block)</text>
+      </g>
+    </g>
+    <g transform="translate(528,0)">
+      <rect width="636" height="124" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
+      <text x="16" y="22" font-size="12" font-weight="600" fill="#cbd5e1">Generated knowledge base (per project)</text>
+      <text x="16" y="38" font-size="10" fill="#64748b" font-family="ui-monospace, Consolas, monospace">bilingual · module + change docs · reviewed drafts only</text>
+      <g font-size="10.5" font-family="ui-monospace, Consolas, monospace" fill="#94a3b8">
+        <text x="16" y="62">  &lt;kbPath&gt;/GOAL.md</text>
+        <text x="16" y="78">  modules/00-index.md  ·  changes/00-index.md</text>
+        <text x="16" y="94">  modules/&lt;area&gt;.md  ·  changes/release-v*.md</text>
+        <text x="16" y="110">  drafts/&lt;pending&gt;.md  (reviewable before apply)</text>
+      </g>
+    </g>
+  </g>
+
+  <!-- Layer 4: External -->
+  <g transform="translate(120,520)" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif">
+    <rect width="1044" height="44" rx="9" fill="url(#card)" stroke="rgba(255,255,255,0.08)"/>
+    <text x="16" y="20" font-size="12" font-weight="600" fill="#cbd5e1">Anthropic-compatible LLM API</text>
+    <text x="200" y="20" font-size="10.5" fill="#94a3b8" font-family="ui-monospace, Consolas, monospace">Claude · GLM · DeepSeek · Kimi · self-hosted — any provider exposing the Anthropic Messages API shape</text>
+    <text x="200" y="36" font-size="9.5" fill="#64748b">Keys stored locally in ai-profiles.json · never leave your machine except in the request body itself</text>
+  </g>
+
+  <!-- Connectors -->
+  <g stroke="#7492a5" stroke-width="1.2" fill="none" marker-end="url(#arrow)" opacity="0.55">
+    <!-- User -> Server -->
+    <line x1="246" y1="202" x2="246" y2="216"/>
+    <line x1="510" y1="202" x2="510" y2="216"/>
+    <line x1="774" y1="202" x2="774" y2="216"/>
+    <!-- Server -> Data -->
+    <line x1="246" y1="344" x2="246" y2="372"/>
+    <line x1="510" y1="344" x2="510" y2="372"/>
+    <line x1="774" y1="344" x2="774" y2="372"/>
+    <!-- Server -> External -->
+    <line x1="640" y1="344" x2="640" y2="516"/>
+    <!-- User agents <-> Server (read KB) -->
+    <line x1="918" y1="202" x2="918" y2="216"/>
+    <line x1="918" y1="468" x2="918" y2="496" stroke-dasharray="3,3" opacity="0.4"/>
+  </g>
+</svg>

package/docs/assets/logo.svg

@@ -0,0 +1,50 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 560 160" role="img" aria-label="project-knowledge logo">
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="560" y2="160" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#0c1118"/>
+      <stop offset="1" stop-color="#141c26"/>
+    </linearGradient>
+    <linearGradient id="core" x1="80" y1="40" x2="120" y2="120" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#dff8ff"/>
+      <stop offset=".55" stop-color="#7dd3fc"/>
+      <stop offset="1" stop-color="#2f7d64"/>
+    </linearGradient>
+    <linearGradient id="book" x1="78" y1="92" x2="148" y2="128" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#f8fafc"/>
+      <stop offset="1" stop-color="#b8c6d8"/>
+    </linearGradient>
+    <filter id="glow" x="-40%" y="-40%" width="180%" height="180%">
+      <feGaussianBlur stdDeviation="3.5"/>
+    </filter>
+  </defs>
+  <rect width="560" height="160" rx="18" fill="url(#bg)"/>
+  <!-- Logo mark -->
+  <g transform="translate(36,28)">
+    <!-- Glow halo -->
+    <circle cx="60" cy="52" r="42" fill="#7492a5" opacity="0.18" filter="url(#glow)"/>
+    <!-- Book base -->
+    <path d="M22 78 L98 78 L98 118 Q60 110 22 118 Z" fill="url(#book)" opacity="0.92"/>
+    <path d="M60 84 L60 116" stroke="#7492a5" stroke-width="1.2" opacity="0.55"/>
+    <!-- Core orb -->
+    <circle cx="60" cy="52" r="26" fill="url(#core)"/>
+    <!-- Orbiting nodes -->
+    <circle cx="60" cy="14" r="4.5" fill="#7dd3fc"/>
+    <circle cx="100" cy="36" r="4.5" fill="#75b798"/>
+    <circle cx="100" cy="68" r="4.5" fill="#c5a15d"/>
+    <circle cx="20" cy="36" r="4.5" fill="#60a5fa"/>
+    <circle cx="20" cy="68" r="4.5" fill="#d36d6d"/>
+    <!-- Connectors -->
+    <g stroke="#7492a5" stroke-width="1.1" opacity="0.55" fill="none">
+      <line x1="60" y1="14" x2="60" y2="26"/>
+      <line x1="100" y1="36" x2="84" y2="46"/>
+      <line x1="100" y1="68" x2="84" y2="58"/>
+      <line x1="20" y1="36" x2="36" y2="46"/>
+      <line x1="20" y1="68" x2="36" y2="58"/>
+    </g>
+  </g>
+  <!-- Wordmark -->
+  <g transform="translate(184,52)" fill="#e3ebf5" font-family="-apple-system, BlinkMacSystemFont, Segoe UI, sans-serif">
+    <text x="0" y="28" font-size="34" font-weight="700" letter-spacing="-0.5">project-knowledge</text>
+    <text x="2" y="58" font-size="15" font-weight="500" fill="#7492a5" letter-spacing="0.5">Local KB · Git-aware · AI-reviewed</text>
+  </g>
+</svg>

package/docs/project-registry-schema.md

@@ -0,0 +1,33 @@
+# Project Registry Schema
+
+Status: current
+Date: 2026-06-21
+
+`projects.json` stores local project configuration. The current KB layout marker is:
+
+```json
+{
+  "kbSchemaVersion": "minimal"
+}
+```
+
+## Relevant Fields
+
+| Field | Default | Notes |
+|---|---|---|
+| `slug` | required | Registry key and project identifier |
+| `displayName` | slug | UI label |
+| `gitPath` | required | Source repository path |
+| `kbPath` | generated from knowledge-store root | Final minimal KB location |
+| `kbSchemaVersion` | `"minimal"` | Current KB framework marker |
+| `goalStatus` | `"not-created"` | Review state of `GOAL.md` |
+| `trackingStartCommit` | current `HEAD` on first import | Baseline commit for incremental KB tracking; commits before it are not analyzed |
+| `trackingStartedAt` | current timestamp on first import | Time the tracking baseline was established |
+| `lastAnalyzedCommit` | `null` | Advanced only after accepted apply |
+| `knowledgeLanguage` | `"zh-CN"` | Human-readable output language |
+
+Old values may exist in local runtime files, but initialization and migration now target the final minimal framework.
+
+Soft-removed projects are remembered in runtime state so re-importing the same
+repository can restore the original `trackingStartCommit`, `lastAnalyzedCommit`,
+and `kbPath`. Hard removal with KB deletion starts fresh.

package/docs/team-knowledge-mode-a-plan.md

@@ -0,0 +1,73 @@
+# Team Knowledge Mode A Plan
+
+## Goal
+
+Support a team knowledge base without a project-knowledge cloud server by using GitHub as the identity, permission, discovery, and Git transport layer.
+
+Mode A assumes one GitHub repository stores multiple project knowledge bases:
+
+```text
+knowledge.git
+  .project-knowledge/team-store.json
+  acc/
+  project-knowledge-pro/
+  devtask-radar/
+```
+
+Each developer may name their local source project differently. The local project slug no longer determines the shared knowledge-base directory.
+
+## Manifest
+
+The GitHub knowledge repository should contain `.project-knowledge/team-store.json`:
+
+```json
+{
+  "schema": "project-knowledge/team-store/v1",
+  "storeId": "team-store-sanqian",
+  "displayName": "SanQian Knowledge",
+  "knowledgeBases": [
+    {
+      "kbId": "kb-acc",
+      "slug": "acc",
+      "path": "acc",
+      "displayName": "ACC"
+    }
+  ]
+}
+```
+
+## User Flow
+
+1. Owner pushes the shared `knowledge` repository to GitHub.
+2. Owner grants a teammate access to that repository through GitHub.
+3. Teammate opens Project Knowledge locally.
+4. Teammate saves a GitHub token in the import view.
+5. The app lists accessible GitHub repositories that contain a team-store manifest.
+6. Teammate selects `knowledge.git`, syncs it to a local path, and selects `acc`.
+7. Teammate imports their local source project, for example `BCC`, and binds it to `knowledge/acc`.
+
+The resulting project config persists:
+
+```json
+{
+  "knowledgeMode": "team",
+  "teamProvider": "github",
+  "kbStoreRemoteUrl": "https://github.com/org/knowledge.git",
+  "kbStorePath": "D:/SanQian.Xu/knowledge",
+  "kbSubdir": "acc",
+  "kbId": "kb-acc",
+  "kbPath": "D:/SanQian.Xu/knowledge/acc"
+}
+```
+
+## Permission Boundary
+
+GitHub repository permissions are repository-level. If a teammate can access `knowledge.git`, they can technically access every subdirectory in that repository. The UI can present only selected knowledge bases, but strict per-project isolation requires separate GitHub repositories per knowledge base.
+
+## Implemented Scope
+
+- Store GitHub auth locally in the user data directory.
+- Discover accessible GitHub repositories that contain a team-store manifest.
+- Clone or pull a selected knowledge repository to a local path.
+- Import a local project while binding it to a selected knowledge-base subdirectory.
+- Preserve personal-mode import behavior when no team binding is selected.

package/docs/testing-strategy.md

@@ -0,0 +1,33 @@
+# Testing Strategy
+
+Status: current
+Date: 2026-07-23
+
+## Framework Tests
+
+- New initialization creates the minimal KB structure.
+- Generated `00-index.md` files remain protected from AI writes.
+- Validation rejects legacy framework artifacts and KB-local AI workspaces.
+
+## Commit Automation Tests
+
+- One source Git commit renders one exact prompt.
+- A project processes commits oldest-to-newest through a FIFO queue.
+- Repeated Hook and startup reconciliation cannot create duplicate tasks.
+- A completed commit is never automatically dispatched again.
+- `queued` and `running` records recover after a restart.
+- Failed tasks remain retryable and do not become silently completed.
+- Different projects may run independently.
+
+## Write-boundary Tests
+
+- Automation can write only inside the selected project's KB.
+- The source repository and other project KBs remain read-only.
+- Bash is restricted to the read-only allowlist.
+- There is no draft apply/reject or human-review API.
+
+## Consumer Tests
+
+- `buildPrContextPack` reads the final KB layout directly.
+- The pack includes goal, architecture, indexes, and trusted Markdown files.
+- The pack never includes AI workspace state.

package/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "@sanqianx/project-knowledge",
+  "version": "4.6.1",
+  "description": "Knowledge base manager with Git integration, AI-driven analysis, and bilingual (zh-CN/en-US) knowledge output",
+  "main": "_site/server.js",
+  "scripts": {
+    "start": "node _site/server.js",
+    "test": "node _site/_test/run-all-tests.js",
+    "release:sync": "node _site/scripts/sync-release-version.js",
+    "release:verify": "node _site/scripts/sync-release-version.js --check && node _site/_test/integration-adapters-test.js",
+    "preversion": "npm run release:verify",
+    "version": "node _site/scripts/sync-release-version.js --stage",
+    "postversion": "npm run release:verify"
+  },
+  "bin": {
+    "project-knowledge": "bin/project-knowledge.js",
+    "project-knowledge-kb": "bin/project-knowledge-kb.js",
+    "project-knowledge-mcp": "bin/project-knowledge-mcp.js",
+    "project-knowledge-integrations": "bin/project-knowledge-integrations.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "_site/server.js",
+    "ui/index.html",
+    "ui/app.css",
+    "ui/app.js",
+    "ui/i18n.js",
+    "ui/favicon.svg",
+    "_site/lib/",
+    "_site/scripts/",
+    "_site/_test/*.js",
+    "_site/_test/fixtures/",
+    "_site/start.bat",
+    "_site/stop.bat",
+    "claude-prompts.json",
+    "bin/",
+    "plugins/",
+    ".claude-plugin/",
+    ".agents/plugins/",
+    "templates/",
+    "docs/assets/",
+    "docs/README.zh-CN.md",
+    "docs/project-registry-schema.md",
+    "docs/team-knowledge-mode-a-plan.md",
+    "docs/testing-strategy.md",
+    "README.md",
+    "NOTICE",
+    "CHANGELOG.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SanQianX/project-knowledge-base.git"
+  },
+  "keywords": [
+    "knowledge-base",
+    "git",
+    "ai",
+    "claude",
+    "codex",
+    "opencode",
+    "mcp",
+    "documentation",
+    "scanner",
+    "context-pack",
+    "post-commit-hook"
+  ],
+  "author": "SanQianX",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.141",
+    "@grpc/grpc-js": "^1.14.5",
+    "@grpc/proto-loader": "^0.8.1",
+    "@huggingface/transformers": "3.8.1",
+    "@lancedb/lancedb": "0.31.0",
+    "@modelcontextprotocol/sdk": "1.29.0",
+    "@sanqianx/ai-coding-event-bridge": "^0.1.2",
+    "@sanqianx/ai-coding-event-bridge-console": "0.4.0",
+    "@sanqianx/vector-hub": "^1.0.2",
+    "buffer": "^6.0.3",
+    "cheerio": "^1.2.0",
+    "claude-ai-workbench": "0.4.1",
+    "cross-spawn": "7.0.6",
+    "dotenv": "^17.4.2",
+    "gpt-tokenizer": "^3.4.0",
+    "http-proxy-agent": "7.0.2",
+    "https-proxy-agent": "7.0.6",
+    "json-colorizer": "^3.0.1",
+    "jsonc-parser": "3.3.1",
+    "openai": "^6.49.0",
+    "socks-proxy-agent": "8.0.5",
+    "turndown": "^7.2.4",
+    "uuid": "^13.0.2",
+    "wink-bm25-text-search": "^3.1.2",
+    "wink-nlp": "^2.4.0",
+    "ws": "^8.21.0",
+    "yargs": "^18.1.0"
+  }
+}

package/plugins/project-knowledge/.claude-plugin/plugin.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
+  "name": "project-knowledge",
+  "version": "4.6.1",
+  "description": "Read durable project decisions and implementation history from Project Knowledge.",
+  "author": {
+    "name": "SanQianX",
+    "url": "https://github.com/SanQianX"
+  },
+  "homepage": "https://github.com/SanQianX/project-knowledge-base#readme",
+  "repository": "https://github.com/SanQianX/project-knowledge-base",
+  "license": "Apache-2.0",
+  "keywords": [
+    "knowledge-base",
+    "claude-code",
+    "mcp",
+    "project-history"
+  ]
+}

package/plugins/project-knowledge/.codex-plugin/plugin.json

@@ -0,0 +1,38 @@
+{
+  "name": "project-knowledge",
+  "version": "4.6.1",
+  "description": "Read durable project decisions and implementation history from Project Knowledge.",
+  "author": {
+    "name": "SanQianX",
+    "url": "https://github.com/SanQianX"
+  },
+  "homepage": "https://github.com/SanQianX/project-knowledge-base#readme",
+  "repository": "https://github.com/SanQianX/project-knowledge-base",
+  "license": "Apache-2.0",
+  "keywords": [
+    "knowledge-base",
+    "codex",
+    "mcp",
+    "project-history"
+  ],
+  "skills": "./skills/",
+  "mcpServers": "./.mcp.json",
+  "interface": {
+    "displayName": "Project Knowledge",
+    "shortDescription": "Query durable knowledge from registered projects.",
+    "longDescription": "Resolve the current repository, search prior decisions and implementation history, and retrieve focused knowledge before making non-trivial changes.",
+    "developerName": "SanQianX",
+    "category": "Productivity",
+    "capabilities": [
+      "Interactive",
+      "Read"
+    ],
+    "websiteURL": "https://github.com/SanQianX/project-knowledge-base",
+    "defaultPrompt": [
+      "Find prior decisions relevant to the task I am about to start.",
+      "Search the project knowledge base before changing this implementation.",
+      "Show the recent history for the current registered project."
+    ],
+    "brandColor": "#2563EB"
+  }
+}

package/plugins/project-knowledge/.mcp.json

@@ -0,0 +1,14 @@
+{
+  "mcpServers": {
+    "project-knowledge": {
+      "type": "stdio",
+      "command": "npx",
+      "args": [
+        "-y",
+        "--package",
+        "project-knowledge@4.6.1",
+        "project-knowledge-mcp"
+      ]
+    }
+  }
+}

package/plugins/project-knowledge/opencode/project-knowledge.md

@@ -0,0 +1,3 @@
+# Project Knowledge
+
+For non-trivial work in a Git repository, load the `project-knowledge` Skill and resolve the current repository before relying on prior project decisions or implementation history. Treat knowledge search/get/history results as read-only, retrieve full entries only after focused search, and verify older knowledge against the current code. Automatic OpenCode capture is the primary conversation truth. Call `project_knowledge_record_requirement` only for an explicitly requested supplement or when automatic capture is known to be unavailable; it appends one user Prompt to the same ConversationStore and never starts analysis.

package/plugins/project-knowledge/skills/project-knowledge/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: project-knowledge
+description: Query durable Project Knowledge records for prior decisions, implementation history, known constraints, and related-project context. Use when starting non-trivial work in a registered repository, investigating why code was designed a certain way, checking whether a problem was solved before, or answering questions about earlier commits and project history.
+---
+
+# Project Knowledge
+
+Use Project Knowledge as a read-only source of durable project context. Automatic client capture is the primary conversation truth. Its one write-capable tool only supplements that truth with an explicit user Prompt event and never starts knowledge analysis. Verify returned knowledge against the current source whenever the repository may have changed since the knowledge entry was produced.
+
+## Workflow
+
+1. Call `project_knowledge_resolve` with the current Git root before substantial implementation, diagnosis, or design work. Do not guess the project slug.
+2. Call `project_knowledge_search` for focused matching records, or `project_knowledge_ask` when a compact cited synthesis is more useful.
+3. Review titles and summaries before loading complete entries.
+4. Call `project_knowledge_get` only for the most relevant entries. Call `project_knowledge_history` when sequence or recent change history matters.
+5. Cite the returned project, entry, and commit information when it materially supports an answer or decision.
+6. Call `project_knowledge_record_requirement` only when the user explicitly requests supplemental capture or automatic client capture is known to be unavailable. Supply the exact user request, resolved project, client, and stable session identifier; never record assistant output, system prompts, credentials, or tool transcripts.
+
+Client integrations may prefix MCP tool names with the server name. Match the tools by their final names: `project_knowledge_resolve`, `project_knowledge_record_requirement`, `project_knowledge_search`, `project_knowledge_ask`, `project_knowledge_get`, and `project_knowledge_history`.
+
+## Boundaries
+
+- Treat knowledge search/get/history results as read-only. The explicit adapter may only append a user Prompt event to ConversationStore.
+- Do not write directly to the knowledge database or knowledge files.
+- Recording a requirement must not be used as a signal that analysis already ran or succeeded.
+- Do not substitute remembered conversation context for a knowledge lookup when prior project work is relevant.
+- Do not treat old knowledge as stronger evidence than current code, tests, or explicit user direction.
+- If the repository is not registered, continue using the source tree and tell the user that no matching Project Knowledge project was found.

package/plugins/project-knowledge/skills/project-knowledge/agents/openai.yaml

@@ -0,0 +1,11 @@
+interface:
+  display_name: "Project Knowledge"
+  short_description: "Query durable knowledge from registered projects"
+  default_prompt: "Use $project-knowledge to find prior decisions relevant to this task."
+dependencies:
+  tools:
+    - type: "mcp"
+      value: "project-knowledge"
+      description: "Read-only project knowledge search and history tools"
+policy:
+  allow_implicit_invocation: true

package/templates/change.md

@@ -0,0 +1,30 @@
+---
+schema: minimal-kb/v1
+title: __SHORTCOMMIT__ __SUBJECT__
+change: __SHORTCOMMIT__
+commit: __COMMIT__
+classification: __CLASSIFICATION__
+tags: [__CLASSIFICATION__]
+affectedModules: []
+developmentIntent: __DEVELOPMENT_INTENT__
+updatedAt: __DATE__
+---
+
+# __SHORTCOMMIT__ __SUBJECT__
+
+## Development Intent
+
+__DEVELOPMENT_INTENT__
+
+## Implementation Result
+
+- Classification: __CLASSIFICATION__
+- Goal impact: __GOAL_IMPACT__
+
+## Evidence
+
+__EVIDENCE__
+
+## Proposed Knowledge Updates
+
+__PROPOSED_OPERATIONS__