@hy-sde-org/dsh-tool-codebase-memory 0.1.2-rc.1

package/LICENSE

@@ -0,0 +1,30 @@
+MIT License
+
+Copyright (c) 2026 hy-sde
+
+This package is a standalone port of `@deepseek-ai/dsh-tool-codebase-memory`
+(the model-facing `codebase_*` CLI tools) onto the hy-sde npm scope. The
+ported portions are distributed under the same MIT license with their original
+copyright held by their respective authors:
+
+  Copyright (c) 2026 DeepSeek
+
+See THIRD-PARTY-NOTICES.md at the repository root for full provenance.
+
+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.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record: the git blob hash of each side as of the
+# last confirmed-consistent state. Both languages carry equal authority; after
+# editing either side, bring the other along and re-record with:
+#   git hash-object README.md README.zh.md
+README.md: fd586ae4e33b6d5e1a42812e612c2b7740838e78
+README.zh.md: 4ca5becdfdd3cf709ecfb6f6e728afff1b764dcf

package/README.md

@@ -0,0 +1,123 @@
+---
+description: "Model-facing codebase-memory tools that run one-shot queries against the local codebase-memory daemon, spawning the CLI once per call and sharing the same daemon the stdio MCP client fronts."
+kind: "package-reference"
+---
+
+# @hy-sde-org/dsh-tool-codebase-memory
+
+English | [中文](README.zh.md)
+
+## Summary
+
+`dsh-tool-codebase-memory` exposes the local codebase-memory daemon as model-facing `codebase_*` tools that run one-shot queries from the terminal. Each call spawns `codebase-memory-mcp cli --json <tool>` once and parses the raw MCP result envelope against the same daemon the MCP server fronts, so indexes, project mutation locks, and the index supervisor are fully shared — warm daemon calls cost ~0.2 s. Choose it over the stdio MCP client row when you want one process per call, tightened schemas, and per-preset configuration instead of a long-lived server inside every session, keeping the MCP row disabled as a zero-maintenance fallback. The main boundary is that the curated schemas are a hand-maintained mirror of the CLI's input schemas, so a codebase-memory release that adds tools needs this package updated.
+
+## Table of Contents
+
+- [Tool surface](#tool-surface)
+- [Why CLI over MCP](#why-cli-over-mcp)
+- [Configuration](#configuration)
+- [Model Experience](#model-experience)
+- [Known Limitations and Deferred Work](#known-limitations-and-deferred-work)
+- [Dev Note](#dev-note)
+
+-----
+
+Model-facing [codebase-memory](https://github.com/DeusData/codebase-memory-mcp) tools that run one-shot queries against the local codebase-memory daemon from the terminal. The surface is the local alternative to the stdio MCP client row: instead of holding a long-lived MCP server inside every session, each call spawns `codebase-memory-mcp cli --json <tool>` once and parses the raw MCP result envelope — **the same daemon the MCP server fronts**, so indexes, project mutation locks and the index supervisor are fully shared. Warm daemon calls cost ~0.2 s on this machine (cold spawn ~1.3 s; `codebase-memory-mcp daemon start` keeps one warm).
+
+## Tool surface
+
+- `codebase_list_projects` — all indexed projects (name, root path, git state); the vocabulary source for `project` everywhere else.
+- `codebase_index_repository [repoPath] [mode=full|moderate|fast|cross-repo-intelligence] [targetProjects] [name] [persistence]` — index a repo once, query it repeatedly.
+- `codebase_index_status [project]` — node/edge counts, freshness, skipped & partially-parsed files, last run's logfile.
+- `codebase_search_graph [query|namePattern|semanticQuery|label|filePattern|limit|offset|...]` — the primary finder: definitions, implementations, relationships; pages with `limit`/`offset` until `has_more` is false.
+- `codebase_query_graph [query] [maxRows]` — raw Cypher over the graph (multi-hop, aggregation, cross-service), including complexity/loop hot-path properties.
+- `codebase_trace_path [functionName] [direction] [depth] [mode=calls|data_flow|cross_service] [...]` — callers/callees, value flow, cross-service hops.
+- `codebase_get_code_snippet [qualifiedName] [includeNeighbors]` — source of one symbol, no file hunting.
+- `codebase_get_graph_schema [project]` — node labels + edge types (Cypher vocabulary).
+- `codebase_get_architecture [path] [aspects]` — packages/services/dependencies + Leiden clusters over the call/import graph.
+- `codebase_search_code [pattern] [mode=compact|full|files] [filePattern|pathFilter|limit]` — grep-augmented, deduped into containing functions, ranked.
+- `codebase_detect_changes [baseBranch|since|depth|scope]` — git diff mapped onto the graph: what a change touches.
+- `codebase_manage_adr [mode=get|update|sections] [content] [sections]` — read/write Architecture Decision Records.
+- `codebase_ingest_traces [traces]` — fold `{caller, callee, count}` runtime traces into the graph.
+- `codebase_delete_project [project]` — destructive; use only for superseded indexes.
+
+## Why CLI over MCP
+
+The MCP client row (`@deepseek-ai/dsh-mcp-client` with `command: codebase-memory-mcp`) works, but it keeps a long-lived stdio server running inside **every** session and exposes all tools verbatim with the `mcp__codebase__*` prefix. The CLI wrapper spawns per call and exits — nothing to recycle, nothing to crash, nothing warm in the session — with clean `codebase_*` names, tightened schemas, and per-preset configuration. Functionally identical: the `cli` mode executes through the same daemon (`main_local_cli_daemon_execute` → `cbm_daemon_application_client_tool`), which is exactly what made the logseq CLI-first pivot viable. Keep the MCP row around disabled if you want a zero-maintenance fallback.
+
+## Configuration
+
+```ts
+import { Context } from '@deepseek-ai/cordis'
+import toolCodebaseMemoryPackage from '@hy-sde-org/dsh-tool-codebase-memory'
+
+const ctx = new Context()
+ctx.plugin(toolCodebaseMemoryPackage, {
+  cliPath: 'codebase-memory-mcp', // CLI executable (default: on PATH)
+  project: 'deepseek-harness', // default project for tools that can omit it
+  timeoutMs: 60000, // per-call process timeout (index calls use indexTimeoutMs)
+  indexTimeoutMs: 600000, // timeout for codebase_index_repository
+  maxChars: 200000, // cap on rendered JSON payload before explicit truncation
+})
+```
+
+Setting `project` makes every call explicit about its graph target while still allowing overrides. The plugin activation invariant fails fast with an install hint when the CLI is missing. Verify at any time with `codebase-memory-mcp cli list_projects`.
+
+## Model Experience
+
+### Tool schemas
+
+#### What the model sees
+
+Fourteen hand-authored `codebase_*` schemas (see the [tool surface](#tool-surface)) encode the graph contract so the model prefers graph answers (`codebase_search_graph` / `codebase_trace_path` / `codebase_get_code_snippet`) over repeated grep/read cycles, pages with `limit`/`offset`, and indexes new repos before relying on answers.
+
+#### Token effect
+
+Fourteen static schemas are added once to the request prefix (~3–5 KB total), far smaller than streaming fifteen MCP schemas with their full paragraphs into every session; results are JSON payloads capped by `maxChars` (default 200000), so a runaway Cypher cannot blow the context.
+
+#### KV Cache effect
+
+All schemas are static; per-call args vary but never condition the request prefix. Cached prefixes stay valid across calls.
+
+### Result values
+
+#### What the model sees
+
+Structured JSON payloads parsed out of the MCP result envelope (content text is JSON too — the wrapper re-parses it), so the model sees the same objects the MCP tools returned, e.g. `search_graph`'s `{total, results, has_more}` tree rows. Tool errors (`isError: true` in the envelope, exit 0 under `--json`) surface as `CodebaseMemoryCliError` with argv/exit code attached — never as fake success.
+
+#### Token effect
+
+Payloads are passed through and truncated only past the `maxChars` cap with an explicit marker; the CLI's own `limit`/`offset` paging is the primary cost control.
+
+#### KV Cache effect
+
+Results are per-call snapshots; no read-back that would change the model's rerun prefix.
+
+### Prompt section
+
+#### What the model sees
+
+One `codebase:tools` card: index before asking, prefer graph answers over repeated greps, page with `limit`/`offset`, Cypher for what the curated tools cannot express, `codebase_delete_project` is destructive.
+
+#### Token effect
+
+Six short lines added once to the request prefix; negligible per turn.
+
+#### KV Cache effect
+
+Static section text — no invalidation.
+
+## Known Limitations and Deferred Work
+
+- The curated schemas are a hand-maintained mirror of the CLI's input schemas; a codebase-memory release that adds tools needs this package updated (the harness's MCP row auto-follows — a good reason to keep it as a disabled fallback).
+- `check_index_coverage` is declared by the binary's tool table but not dispatchable through `cli` ("unknown tool"), so it is intentionally not wrapped.
+- No host-plane service or GUI surface: the binary already ships a graph visualizer at `localhost:9749`; an in-GUI drawer (like the logseq wiki pane) is future work.
+
+### Dev Note
+
+<details>
+<summary>Working context for maintainers — click to expand</summary>
+
+None.
+
+</details>

package/README.zh.md

@@ -0,0 +1,129 @@
+---
+description: "面向模型的 codebase-memory 工具：经 CLI 对本地 codebase-memory daemon 发起一次性查询，与 stdio MCP 客户端共享同一 daemon。"
+kind: "package-reference"
+---
+
+# @hy-sde-org/dsh-tool-codebase-memory
+
+[English](README.md) | 中文
+
+## 概述
+
+`dsh-tool-codebase-memory` 把本地 codebase-memory daemon 暴露为模型侧的 `codebase_*` 工具，从终端发起一次性查询。每次调用派发一次 `codebase-memory-mcp cli --json <tool>` 并解析原始 MCP 结果信封，与 MCP server 前端的是同一个 daemon，因此索引、项目变更锁与索引 supervisor 完全共享——热 daemon 调用约 0.2 秒。与 stdio MCP 客户端行相比，选择它可获得每次调用一个进程、schema 精简、可按 preset 配置，而不是每个会话常驻一个长寿命 server；可把 MCP 行禁用挂起作为零维护备选。主要边界是精选 schema 是 CLI 输入 schema 的手工维护镜像，codebase-memory 发布新增工具时本包需要更新。
+
+## 目录
+
+- [工具面](#tool-surface)
+- [为什么用 CLI 而不是 MCP](#why-cli-over-mcp)
+- [配置](#configuration)
+- [模型体验](#model-experience)
+- [已知限制与待办工作](#known-limitations-and-deferred-work)
+- [开发备注](#dev-note)
+
+-----
+
+基于 [codebase-memory](https://github.com/DeusData/codebase-memory-mcp) 的模型侧工具：从终端对本地 codebase-memory daemon 发起一次性查询。该工具面是 stdio MCP 客户端行（`@deepseek-ai/dsh-mcp-client` 配 `command: codebase-memory-mcp`）的本地替代方案——不在每个会话里常驻一个 MCP server，而是每次调用派发一次 `codebase-memory-mcp cli --json <tool>` 并解析原始 MCP 结果信封——**与 MCP server 前端的是同一个 daemon**，因此索引、项目变更锁与索引 supervisor 完全共享。本机实测热 daemon 调用约 0.2 秒（冷启动约 1.3 秒；`codebase-memory-mcp daemon start` 可保持常暖）。
+
+<a id="tool-surface"></a>
+## 工具面
+
+- `codebase_list_projects` —— 列出全部已索引项目（名称、根路径、git 状态）；是其他地方 `project` 词汇的来源。
+- `codebase_index_repository [repoPath] [mode=full|moderate|fast|cross-repo-intelligence] [targetProjects] [name] [persistence]` —— 索引一次、反复查询。
+- `codebase_index_status [project]` —— 节点/边数量、新鲜度、跳过与部分解析的文件、上次运行的日志文件。
+- `codebase_search_graph [query|namePattern|semanticQuery|label|filePattern|limit|offset|...]` —— 主要查找器：定义、实现、关系；用 `limit`/`offset` 翻页直到 `has_more` 为假。
+- `codebase_query_graph [query] [maxRows]` —— 对图执行原始 Cypher（多跳、聚合、跨服务），含复杂度/循环热点属性。
+- `codebase_trace_path [functionName] [direction] [depth] [mode=calls|data_flow|cross_service] [...]` —— 调用者/被调者、值流、跨服务跳转。
+- `codebase_get_code_snippet [qualifiedName] [includeNeighbors]` —— 单个符号的源码，无需翻文件。
+- `codebase_get_graph_schema [project]` —— 节点标签 + 边类型（Cypher 词汇表）。
+- `codebase_get_architecture [path] [aspects]` —— 包/服务/依赖 + 对调用/导入图做 Leiden 社区检测得到的 de-facto 模块。
+- `codebase_search_code [pattern] [mode=compact|full|files] [filePattern|pathFilter|limit]` —— grep 增强、去重进包含函数并按结构重要性排序。
+- `codebase_detect_changes [baseBranch|since|depth|scope]` —— 把 git diff 映射到图上：一次改动会波及什么。
+- `codebase_manage_adr [mode=get|update|sections] [content] [sections]` —— 读写架构决策记录（ADR）。
+- `codebase_ingest_traces [traces]` —— 把 `{caller, callee, count}` 运行时 trace 折入图。
+- `codebase_delete_project [project]` —— 破坏性操作；仅用于清理被取代的索引。
+
+<a id="why-cli-over-mcp"></a>
+## 为什么用 CLI 而不是 MCP
+
+MCP 客户端行（`@deepseek-ai/dsh-mcp-client` 配 `command: codebase-memory-mcp`）能工作，但会在**每个**会话里常驻一个 stdio server，且把所有工具原样暴露为 `mcp__codebase__*` 前缀。CLI 包装每次调用派发一次、随即退出——无需回收、不会崩、会话内无常驻进程——且工具名干净（`codebase_*`）、schema 精简、可按 preset 配置。功能上完全一致：`cli` 模式经由同一个 daemon 执行（`main_local_cli_daemon_execute` → `cbm_daemon_application_client_tool`），这正是当初 logseq 转向 CLI-first 得以成立的原因。若想保留零维护的备选，可把 MCP 行禁用挂起。
+
+<a id="configuration"></a>
+## 配置
+
+```ts
+import { Context } from '@deepseek-ai/cordis'
+import toolCodebaseMemoryPackage from '@hy-sde-org/dsh-tool-codebase-memory'
+
+const ctx = new Context()
+ctx.plugin(toolCodebaseMemoryPackage, {
+  cliPath: 'codebase-memory-mcp', // CLI executable (default: on PATH)
+  project: 'deepseek-harness', // default project for tools that can omit it
+  timeoutMs: 60000, // per-call process timeout (index calls use indexTimeoutMs)
+  indexTimeoutMs: 600000, // timeout for codebase_index_repository
+  maxChars: 200000, // cap on rendered JSON payload before explicit truncation
+})
+```
+
+设置 `project` 会让每次调用显式指向目标图，同时仍允许按调用覆盖。插件激活不变量在 CLI 缺失时快速失败并给出安装提示。可随时用 `codebase-memory-mcp cli list_projects` 验证。
+
+<a id="model-experience"></a>
+## 模型体验
+
+### 工具 schema
+
+#### 模型看到什么
+
+十四个手写 `codebase_*` schema（见[工具面](#tool-surface)）把图契约编码进去：模型优先用图答案（`codebase_search_graph` / `codebase_trace_path` / `codebase_get_code_snippet`）而非反复 grep/read，用 `limit`/`offset` 翻页，并在依赖答案前先索引新仓库。
+
+#### Token 影响
+
+十四个静态 schema 只加入请求前缀一次（合计约 3–5 KB），远小于把十五个 MCP schema 连同整段说明流进每个会话；结果以 JSON 载荷返回并受 `maxChars`（默认 200000）限制，失控的 Cypher 不会撑爆上下文。
+
+#### KV 缓存影响
+
+全部 schema 为静态；每次调用的参数不同但不会改变请求前缀。此前缀跨调用保持有效。
+
+### 结果值
+
+#### 模型看到什么
+
+从 MCP 结果信封解析出的结构化 JSON 载荷（信封正文本身就是 JSON——包装器会二次解析），模型看到与 MCP 工具相同的对象，例如 `search_graph` 的 `{total, results, has_more}` 树行。工具错误（信封内 `isError: true`，`--json` 下进程退出码为 0）以带 argv/退出码的 `CodebaseMemoryCliError` 浮出——绝不会伪装成成功。
+
+#### Token 影响
+
+载荷原样透传，仅在超过 `maxChars` 上限时截断并带显式标记；CLI 自身的 `limit`/`offset` 分页是主要成本控制。
+
+#### KV 缓存影响
+
+结果为每次调用的快照，无读取回写改变模型的重复运行前缀。
+
+### 提示段
+
+#### 模型看到什么
+
+一张 `codebase:tools` 卡片：先索引再提问、图答案优先于反复 grep、用 `limit`/`offset` 翻页、曲线工具表达不了的用 Cypher、`codebase_delete_project` 具破坏性。
+
+#### Token 影响
+
+六行短文本只加入请求前缀一次；每轮成本可忽略。
+
+#### KV 缓存影响
+
+静态段落文本——无失效。
+
+<a id="known-limitations-and-deferred-work"></a>
+## 已知限制与待办工作
+
+- 精选 schema 是 CLI 输入 schema 的手工维护镜像；codebase-memory 发布新增工具时本包需要更新（harness 的 MCP 行会自动跟随——这也是保留其作为禁用备选的好理由）。
+- `check_index_coverage` 虽在二进制的工具表中声明，但无法通过 `cli` 派发（"unknown tool"），因此有意不包装它。
+- 无主机面服务或 GUI 面：二进制自带 `localhost:9749` 图谱可视化；类 logseq wiki 面板的画中抽屉属未来工作。
+
+<a id="dev-note"></a>
+### 开发备注
+
+<details>
+<summary>维护者工作上下文 — 点击展开</summary>
+
+无。
+
+</details>

package/cordis.patch.yml

@@ -0,0 +1,34 @@
+# @hy-sde-org/dsh-tool-codebase-memory — a self-contained model-facing
+# codebase-memory CLI tool surface.
+#
+# The plugin mounts as ONE plain agent-plane row, exactly like the official
+# harness's own `tool-codebase-memory` row in the stock base bundle. It
+# consumes the deployment's host services — `tools` and `systemPrompt` (stock
+# base provides both via the agent bundle) — so it needs no service or
+# filesystem realm of its own: each call spawns `codebase-memory-mcp cli
+# --json <tool>` once against the same local daemon the stdio MCP client
+# fronts, so indexes, mutation locks and index supervisors are shared.
+#
+# The row id carries the `hy-sde-` prefix to avoid clashing with any shipped
+# row of the same name (a duplicate loader id fails the boot); if the
+# deployment already mounts a `tool-codebase-memory` row of its own, disable
+# this one or drop the insert and keep the stock row.
+#
+# Override per deployment (e.g. point at a non-PATH CLI binary) by patching
+# the row by id:
+#
+#   - id: hy-sde-cbm-tool-codebase-memory
+#     config:
+#       cliPath: /opt/codebase-memory-mcp/bin/codebase-memory-mcp
+#       project: my-monorepo
+#
+# The `codebase:tools` prompt section is registered by the same plugin, so no
+# separate prompt row is needed.
+- insert:
+    - id: hy-sde-cbm-tool-codebase-memory
+      name: '@hy-sde-org/dsh-tool-codebase-memory'
+      config:
+        cliPath: codebase-memory-mcp
+        timeoutMs: 60000
+        indexTimeoutMs: 600000
+        maxChars: 200000

package/dist/cli-check.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Standalone CLI availability probe for `@hy-sde-org/dsh-tool-codebase-memory`.
+ * Spawns `<cli> --version` once with an 8s budget.
+ * @module @hy-sde-org/dsh-tool-codebase-memory/cli-check
+ */
+/**
+ * Verify the `codebase-memory-mcp` CLI resolves and runs.
+ * @param cliPath - CLI executable to verify (default `codebase-memory-mcp` on PATH).
+ * @returns a promise settling once the probe succeeds.
+ * @throws a descriptive error with an install hint when the probe fails.
+ */
+export declare function checkCodebaseMemoryCli(cliPath?: string): Promise<void>;
+//# sourceMappingURL=cli-check.d.ts.map

package/dist/cli-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-check.d.ts","sourceRoot":"","sources":["../src/cli-check.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,MAA8B,GAAG,OAAO,CAAC,IAAI,CAAC,CAc7F"}

package/dist/cli-check.js

@@ -0,0 +1,28 @@
+/**
+ * Standalone CLI availability probe for `@hy-sde-org/dsh-tool-codebase-memory`.
+ * Spawns `<cli> --version` once with an 8s budget.
+ * @module @hy-sde-org/dsh-tool-codebase-memory/cli-check
+ */
+import { execFile } from 'node:child_process';
+/**
+ * Verify the `codebase-memory-mcp` CLI resolves and runs.
+ * @param cliPath - CLI executable to verify (default `codebase-memory-mcp` on PATH).
+ * @returns a promise settling once the probe succeeds.
+ * @throws a descriptive error with an install hint when the probe fails.
+ */
+export function checkCodebaseMemoryCli(cliPath = 'codebase-memory-mcp') {
+    return new Promise((resolve, reject) => {
+        execFile(cliPath, ['--version'], { timeout: 8000, windowsHide: true }, (err, _stdout, stderr) => {
+            if (!err) {
+                resolve();
+                return;
+            }
+            const code = typeof err.code === 'number';
+            const hint = code
+                ? `the \`${cliPath}\` CLI exited with code ${err.code}: ${(stderr || '').trim().slice(0, 200)}`
+                : `\`${cliPath}\` was not found on PATH`;
+            reject(new Error(`tool-codebase-memory: ${hint}. Install the codebase-memory CLI from the codebase-memory-mcp releases (https://github.com/DeusData/codebase-memory-mcp/releases): tar xzf then ./install.sh, or set config.cliPath.`));
+        });
+    });
+}
+//# sourceMappingURL=cli-check.js.map

package/dist/cli-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-check.js","sourceRoot":"","sources":["../src/cli-check.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAE7C;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAkB,qBAAqB;IAC5E,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,QAAQ,CAAC,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;YAC9F,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,OAAO,EAAE,CAAA;gBACT,OAAM;YACR,CAAC;YACD,MAAM,IAAI,GAAG,OAAQ,GAA0B,CAAC,IAAI,KAAK,QAAQ,CAAA;YACjE,MAAM,IAAI,GAAG,IAAI;gBACf,CAAC,CAAC,SAAS,OAAO,2BAA4B,GAAwB,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;gBACrH,CAAC,CAAC,KAAK,OAAO,0BAA0B,CAAA;YAC1C,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,IAAI,uLAAuL,CAAC,CAAC,CAAA;QACzO,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/codebase-memory.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Model-facing codebase-memory CLI tools over the `codebase-memory-mcp cli`
+ * one-shot mode: `codebase_list_projects`, `codebase_index_repository`,
+ * `codebase_index_status`, `codebase_search_graph`, `codebase_query_graph`,
+ * `codebase_trace_path`, `codebase_get_code_snippet`,
+ * `codebase_get_graph_schema`, `codebase_get_architecture`,
+ * `codebase_search_code`, `codebase_detect_changes`, `codebase_manage_adr`,
+ * `codebase_ingest_traces`, `codebase_delete_project`.
+ *
+ * Each call spawns `codebase-memory-mcp cli --json <tool>` once with a temp
+ * `--args-file` and parses the raw MCP result envelope — the same daemon the
+ * stdio MCP server fronts, so indexes, mutation locks and index supervisors
+ * are shared. Long-lived process: none; the daemon stays warm across calls.
+ * @module @hy-sde-org/dsh-tool-codebase-memory/codebase-memory
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Tool-level configuration (all optional; defaults apply). */
+export interface CodebaseMemoryToolConfig {
+    /** CLI executable (default `codebase-memory-mcp` on PATH). */
+    cliPath?: string;
+    /** Default project name applied when a tool call omits `project`. */
+    project?: string;
+    /** Per-call process timeout in ms (default 60000). */
+    timeoutMs?: number;
+    /** Timeout for `codebase_index_repository` in ms (default 600000). */
+    indexTimeoutMs?: number;
+    /** Cap on rendered JSON payload chars before truncation (default 200000). */
+    maxChars?: number;
+}
+/** Raised when the CLI exits non-zero, the envelope reports isError, or the output is unreadable. */
+export declare class CodebaseMemoryCliError extends Error {
+    /** CLI invocation that failed. */
+    readonly args: string[];
+    /** Captured stdout (may hold a partial MCP envelope). */
+    readonly stdout: string;
+    /** Captured stderr (mem.init/progress noise plus human errors). */
+    readonly stderr: string;
+    /** Process exit code, or null when no process ran (e.g. ENOENT). */
+    readonly exitCode: number | null;
+    /** Parsed error payload from the envelope, when available. */
+    readonly payload?: unknown;
+    constructor(message: string, args: string[], stdout: string, stderr: string, exitCode: number | null, payload?: unknown);
+}
+interface RunResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+}
+/**
+ * Run the CLI once; stdout/stderr/exit-code are returned as-is.
+ * @param cmd - CLI executable path.
+ * @param args - full argv (including `cli --json <tool>` and, when args exist, `--args-file`).
+ * @param options - run options (per-call timeout).
+ * @returns the captured stdout/stderr and exit code.
+ * @throws {@link CodebaseMemoryCliError} when the process fails or times out.
+ */
+export declare function runCli(cmd: string, args: string[], options: {
+    timeoutMs: number;
+}): Promise<RunResult>;
+interface Envelope {
+    /** The MCP envelope's text payload, re-parsed into a value. */
+    payload: unknown;
+    /** The envelope's text, verbatim (double-encoded JSON for structured tools). */
+    text: string;
+    /** Raw stdout captured from the CLI. */
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+}
+/**
+ * Parse the raw MCP result envelope printed by `cli --json <tool>`.
+ *
+ * Under `--json` the CLI always exits 0 and reports tool errors inside the
+ * envelope (`{"content":[{"type":"text","text":...}],"isError":true}`), so the
+ * envelope — not the process exit code — is the source of truth.
+ * @param run - captured run output.
+ * @returns the parsed envelope.
+ * @throws {@link CodebaseMemoryCliError} when the envelope reports `isError`.
+ */
+export declare function parseEnvelope(run: RunResult): Envelope;
+/**
+ * Render a JSON payload into the tool result text, truncating when it exceeds
+ * the cap so oversized graph payloads cannot blow the session context.
+ * @param payload - parsed envelope payload.
+ * @param maxChars - truncation cap.
+ * @returns the rendered text.
+ */
+export declare function renderPayload(payload: unknown, maxChars: number): string;
+/**
+ * Register all fourteen codebase-memory tools (the prompt section is added by
+ * the index plugin; this stays separable for tests).
+ * @param ctx - Cordis context carrying `tools` and `systemPrompt`.
+ * @param config - tool-level configuration (CLI path/project/timeouts/caps).
+ */
+export declare function applyCodebaseMemoryTools(ctx: Context, config?: CodebaseMemoryToolConfig): void;
+export {};
+//# sourceMappingURL=codebase-memory.d.ts.map

package/dist/codebase-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codebase-memory.d.ts","sourceRoot":"","sources":["../src/codebase-memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAqBlD,+DAA+D;AAC/D,MAAM,WAAW,wBAAwB;IACvC,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,qGAAqG;AACrG,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAA;IACvB,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;gBAEd,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO;CASxH;AAED,UAAU,SAAS;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED;;;;;;;GAOG;AACH,wBAAsB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAyB5G;AAED,UAAU,QAAQ;IAChB,+DAA+D;IAC/D,OAAO,EAAE,OAAO,CAAA;IAChB,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAA;IACZ,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAWD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,GAAG,QAAQ,CAgCtD;AAWD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIxE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,wBAA6B,GAAG,IAAI,CA4TlG"}