dsh-codebase-chat 0.16.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 shinzarou-eng
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,249 @@
+# dsh-codebase-chat
+
+[![Release](https://img.shields.io/github/v/release/shinzarou-eng/dsh-codebase-chat?logo=github)](https://github.com/shinzarou-eng/dsh-codebase-chat/releases)
+[![License](https://img.shields.io/github/license/shinzarou-eng/dsh-codebase-chat?color=blue)](./LICENSE)
+[![Node](https://img.shields.io/badge/node-%3E%3D20-brightgreen?logo=nodedotjs)](https://nodejs.org)
+[![MCP](https://img.shields.io/badge/MCP-Compatible-purple)](https://modelcontextprotocol.io)
+
+> A powerful, multi-language codebase intelligence engine for **DeepSeek Harness** and any **MCP-compatible** IDE (Windsurf, Cursor, Claude, etc.).
+> Chat, search, explain, refactor, audit, and generate board-ready reports from a local codebase — without leaking data to third-party services.
+
+<p align="center">
+  <a href="https://github.com/shinzarou-eng/dsh-codebase-chat/releases">Releases</a> ·
+  <a href="#install">Install</a> ·
+  <a href="#mcp-server">MCP</a> ·
+  <a href="#commands">Commands</a> ·
+  <a href="#github-pages-docs">Docs</a>
+</p>
+
+---
+
+## Why dsh-codebase-chat?
+
+Most codebase assistants are slow, paywalled, or force you to upload source code to the cloud. **dsh-codebase-chat** runs locally, reads only the files you point at, and turns raw code into structured intelligence:
+
+| Capability | What it gives you |
+| --- | --- |
+| **Chat** | Ask anything about the project in plain language. |
+| **Search** | Find symbols, terms, and usages with line references. |
+| **Explain** | Understand a file or function with real code excerpts. |
+| **Refactor** | Get production-ready code changes with diff rationale. |
+| **Intelligence Pro** | CTO-level audit: architecture, tech radar, debt, security, competitors, roadmap. |
+| **Audit** | Dedicated non-conformity and tech-debt scan with fixes. |
+| **Strategic Report** | Board-ready SWOT, score cards, 90-day roadmap, marketing angle. |
+| **Tasks** | Auto-generate `TASKS.md` with sprints, Before/After blocks, and patch application. |
+| **Player Brief** | UX / playthrough analysis from a real user perspective. |
+| **Crea** | Slogans, taglines, and feature ideas inspired by the code. |
+
+Every output is **grounded in real source files** with file and line citations. No guesswork, no cloud, no data leakage.
+
+---
+
+## Quick start
+
+### 1. DeepSeek Harness plugin
+
+```powershell
+# Install in any profile
+pnpm add "file:C:/path/to/dsh-codebase-chat"
+# or
+npm install "file:C:/path/to/dsh-codebase-chat"
+```
+
+Then open `http://127.0.0.1:3080` and click the **Codebase Pro** button in the sidebar.
+
+### 2. Standalone MCP server
+
+```bash
+# Install globally
+npm install -g dsh-codebase-chat-mcp
+
+# Or run without installing
+npx dsh-codebase-chat-mcp
+```
+
+Configure Windsurf / Cursor / Claude:
+
+```json
+{
+  "mcpServers": {
+    "dsh-codebase-chat": {
+      "command": "npx",
+      "args": ["dsh-codebase-chat-mcp"],
+      "env": {
+        "DEEPSEEK_API_KEY": "sk-...",
+        "CODEBASE_MODEL": "deepseek-chat"
+      }
+    }
+  }
+}
+```
+
+See [`mcp/README.md`](mcp/README.md) for the full config.
+
+### 3. From source
+
+```bash
+git clone https://github.com/shinzarou-eng/dsh-codebase-chat.git
+cd dsh-codebase-chat
+pnpm install
+```
+
+---
+
+## Commands
+
+```powershell
+# Ask a question (auto-detect project from current directory)
+dsh --profile headless '/codebase "how is auth handled?"'
+
+# Ask with explicit project
+dsh --profile headless '/codebase "how is auth handled?" --project C:\my-app'
+
+# Append a creative idea at the end
+dsh --profile headless '/codebase "how does storage work?" --project C:\my-app --crea --crea-theme "slogan"'
+
+# Search, explain, refactor
+dsh --profile headless '/codebase-search "usePetStore" --project C:\my-app'
+dsh --profile headless '/codebase-explain "storage.ts" --project C:\my-app'
+dsh --profile headless '/codebase-refactor "split this hook" --file storage.ts --project C:\my-app'
+
+# Professional briefs
+dsh --profile headless '/codebase-intel --project C:\my-app'
+dsh --profile headless '/codebase-audit --project C:\my-app'
+dsh --profile headless '/codebase-report --project C:\my-app'
+dsh --profile headless '/codebase-ceo --project C:\my-app'
+dsh --profile headless '/codebase-player --project C:\my-app'
+
+# Tasks & apply
+dsh --profile headless '/codebase-tasks --project C:\my-app'
+dsh --profile headless '/codebase-tasks-raw --project C:\my-app'
+dsh --profile headless '/codebase-apply-tasks --project C:\my-app'
+
+# Build & git
+dsh --profile headless '/codebase-build --project C:\my-app'
+dsh --profile headless '/codebase-git --project C:\my-app'
+```
+
+---
+
+## Architecture
+
+```mermaid
+graph LR
+  A[User query] --> B[Codebase Pro UI / MCP / CLI]
+  B --> C[Context collector]
+  C --> D[Project files]
+  C --> E[Module graph / debt / tests]
+  C --> F[Prompt builder]
+  F --> G[LLM]
+  G --> H[Structured response with citations]
+```
+
+1. **Context collector** reads package.json, source files, tests, config, git, build output.
+2. **Module graph** maps who calls who.
+3. **Debt scanner** flags TODO/FIXME/HACK/console.log/any/etc.
+4. **Prompt builder** assembles a language-aware, evidence-based prompt.
+5. **LLM** returns a response that includes source citations, confidence scores, and severity badges.
+
+---
+
+## Web UI
+
+When installed in the **web** profile, the plugin adds a **Codebase Pro** button in the sidebar footer:
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/shinzarou-eng/dsh-codebase-chat/main/docs/assets/codebase-pro-button.svg" alt="Codebase Pro button" width="240">
+</p>
+
+One click opens the brief selector and launches the chosen mode in the user's language.
+
+---
+
+## Tools exposed
+
+- `codebase_chat`
+- `codebase_search`
+- `codebase_explain`
+- `codebase_refactor`
+- `codebase_crea`
+- `codebase_intelligence`
+- `codebase_audit`
+- `codebase_report`
+- `codebase_tasks`
+- `codebase_apply_tasks`
+- `codebase_ceo`
+- `codebase_build`
+- `codebase_git`
+- `codebase_apply`
+- `codebase_player`
+
+---
+
+## Evidence & scoring
+
+Every professional brief now requires the model to:
+
+- Cite sources as `[source: relative/path/file.ts:line]`
+- Mark recommendations with `[Confidence: X%]`
+- Mark risks and issues with `[Severity: Critical/High/Medium/Low]`
+
+No fabricated citations, no hand-waving.
+
+---
+
+## Multi-language
+
+The plugin detects the user's language and generates the entire prompt in that language. Supported locales:
+
+- `fr` — French
+- `en` — English
+
+More languages can be added by extending the `build*Prompt` functions.
+
+---
+
+## Install as a DSH plugin
+
+```powershell
+dsh plugin --profile headless add "file:C:/Users/YOU/dsh-codebase-chat"
+dsh plugin --profile web add "file:C:/Users/YOU/dsh-codebase-chat"
+```
+
+---
+
+## Troubleshooting
+
+### `EADDRINUSE` — port 3080 already in use
+
+```powershell
+Get-NetTCPConnection -LocalPort 3080 | ForEach-Object { Stop-Process -Id $_.OwningProcess -Force }
+```
+
+Then restart `dsh --profile web`.
+
+---
+
+## Roadmap
+
+- [ ] More language packs
+- [ ] VS Code extension
+- [ ] Indexed project cache for huge repos
+- [ ] Interactive diff viewer in DSH UI
+
+---
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Run `node --check lib/index.js` before committing
+4. Open a PR against `main`
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for details.
+
+---
+
+## License
+
+[MIT](./LICENSE) — Built and maintained by [shinzarou-eng](https://github.com/shinzarou-eng).

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: codebase-chat
+      name: dsh-codebase-chat

package/lib/cache.js

@@ -0,0 +1,84 @@
+import { createHash } from "node:crypto";
+import { readFile, writeFile, mkdir, stat } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { homedir } from "node:os";
+
+const CACHE_VERSION = 1;
+
+function getCacheDir() {
+  const base = process.env.CODEBASE_CACHE_DIR
+    || process.env.LOCALAPPDATA
+    || process.env.APPDATA
+    || join(homedir(), ".cache");
+  return join(base, "dsh-codebase-chat-cache");
+}
+
+function projectHash(absProject) {
+  return createHash("sha256").update(absProject.toLowerCase()).digest("hex").slice(0, 16);
+}
+
+export function cachePath(absProject) {
+  return join(getCacheDir(), `${projectHash(absProject)}.json`);
+}
+
+export async function loadCache(absProject) {
+  const p = cachePath(absProject);
+  if (!existsSync(p)) return null;
+  try {
+    const raw = await readFile(p, "utf8");
+    const data = JSON.parse(raw);
+    if (data?.version !== CACHE_VERSION) return null;
+    return data;
+  } catch {
+    return null;
+  }
+}
+
+export async function saveCache(absProject, data) {
+  const p = cachePath(absProject);
+  await mkdir(dirname(p), { recursive: true });
+  const payload = {
+    version: CACHE_VERSION,
+    projectPath: absProject,
+    updatedAt: Date.now(),
+    ...data
+  };
+  await writeFile(p, JSON.stringify(payload), "utf8");
+}
+
+export function hashFile(stats, firstBytes = "") {
+  return createHash("sha256")
+    .update(`${stats.mtimeMs}:${stats.size}:${firstBytes.slice(0, 512)}`)
+    .digest("hex")
+    .slice(0, 24);
+}
+
+export async function fileStats(filePath) {
+  try {
+    return await stat(filePath);
+  } catch {
+    return null;
+  }
+}
+
+export function estimateTokens(text) {
+  return Math.ceil(text.length / 3.5);
+}
+
+export function truncateByTokens(text, maxTokens) {
+  if (estimateTokens(text) <= maxTokens) return text;
+  const targetChars = Math.floor(maxTokens * 3.5);
+  const lines = text.split("\n");
+  let acc = [];
+  let chars = 0;
+  for (const line of lines) {
+    if (chars + line.length + 1 > targetChars) {
+      acc.push("[... tronque pour respecter le budget de tokens ...]");
+      break;
+    }
+    acc.push(line);
+    chars += line.length + 1;
+  }
+  return acc.join("\n");
+}