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

package/dist/invariant.js

@@ -0,0 +1,34 @@
+/**
+ * Package-owned invariant companion for `@hy-sde-org/dsh-tool-codebase-memory`.
+ * @module @hy-sde-org/dsh-tool-codebase-memory/invariant
+ */
+import { checkCodebaseMemoryCli } from "./cli-check.js";
+const PACKAGE_NAME = '@hy-sde-org/dsh-tool-codebase-memory';
+/** Cordis companion plugin name. */
+export const name = 'tool-codebase-memory-invariant';
+/** Service required before the companion can reserve package ownership. */
+export const inject = ['invariants'];
+/**
+ * Install the activation invariant: the `codebase-memory-mcp` CLI must resolve
+ * and run, otherwise the tools would error on every call. Config-level
+ * `cliPath` overrides are per-call concerns; the companion check uses the PATH
+ * default.
+ */
+const install = async (_ctx, fail) => {
+    try {
+        await checkCodebaseMemoryCli();
+    }
+    catch (err) {
+        fail(err.message);
+    }
+};
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+/* jscpd:ignore-end */
+/** Standalone availability probe re-export (usable outside the registry). */
+export { checkCodebaseMemoryCli } from "./cli-check.js";
+//# sourceMappingURL=invariant.js.map

package/dist/invariant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.js","sourceRoot":"","sources":["../src/invariant.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AAEvD,MAAM,YAAY,GAAG,sCAAsC,CAAA;AAE3D,oCAAoC;AACpC,MAAM,CAAC,MAAM,IAAI,GAAG,gCAAgC,CAAA;AACpD,2EAA2E;AAC3E,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,YAAY,CAAC,CAAA;AAEpC;;;;;GAKG;AACH,MAAM,OAAO,GAAuB,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;IACvD,IAAI,CAAC;QACH,MAAM,sBAAsB,EAAE,CAAA;IAChC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAE,GAAa,CAAC,OAAO,CAAC,CAAA;IAC9B,CAAC;AACH,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAY,EAAuB,EAAE,CACzD,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAA;AACjE,sBAAsB;AAEtB,6EAA6E;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/prompt.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `codebase:tools` system-prompt section: a compact contract card on the
+ * codebase-memory tool surface and the operational rules that keep the graph
+ * authoritative (index before asking, prefer graph answers over repeated
+ * greps, page with limit/offset, and know the project vocabulary).
+ * @module @hy-sde-org/dsh-tool-codebase-memory/prompt
+ */
+import type { PromptSection } from '@deepseek-ai/dsh-system-prompt';
+/**
+ * Build the codebase-tools prompt section.
+ * @param config - configuration; `enabled: false` disables the section.
+ * @returns the {@link PromptSection} to register.
+ */
+export declare function buildCodebaseMemoryPromptSection(config?: {
+    enabled?: boolean;
+}): PromptSection;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAcnE;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,aAAa,CAMlG"}

package/dist/prompt.js

@@ -0,0 +1,30 @@
+/**
+ * `codebase:tools` system-prompt section: a compact contract card on the
+ * codebase-memory tool surface and the operational rules that keep the graph
+ * authoritative (index before asking, prefer graph answers over repeated
+ * greps, page with limit/offset, and know the project vocabulary).
+ * @module @hy-sde-org/dsh-tool-codebase-memory/prompt
+ */
+const SECTION_NAME = 'codebase:tools';
+const SECTION_ORDER = 131;
+const TEXT = [
+    'Codebase intelligence runs over the codebase-memory CLI tools (`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`) — one-shot queries against the local codebase-memory daemon, not a long-lived MCP server.',
+    'Before relying on graph answers, confirm the project is indexed (`codebase_list_projects` / `codebase_index_status`); index new repos with `codebase_index_repository` (full mode for deep research).',
+    'Prefer `codebase_search_graph` over repeated grep/read cycles for definitions, callers, call chains, routes, and architecture; use `codebase_query_graph` (Cypher) for patterns the curated tools cannot express.',
+    'Page with `limit`/`offset` until `has_more` is false; result sizes are capped and truncation is reported explicitly.',
+    '`codebase_delete_project` is destructive — use only for superseded indexes.',
+    'Underlying CLI: `codebase-memory-mcp cli --json <tool>`; it shares the same daemon as any MCP client, so indexes are consistent across sessions.',
+].join('\n');
+/**
+ * Build the codebase-tools prompt section.
+ * @param config - configuration; `enabled: false` disables the section.
+ * @returns the {@link PromptSection} to register.
+ */
+export function buildCodebaseMemoryPromptSection(config = {}) {
+    return {
+        name: SECTION_NAME,
+        order: SECTION_ORDER,
+        text: config.enabled === false ? '' : TEXT,
+    };
+}
+//# sourceMappingURL=prompt.js.map

package/dist/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,YAAY,GAAG,gBAAgB,CAAA;AACrC,MAAM,aAAa,GAAG,GAAG,CAAA;AAEzB,MAAM,IAAI,GAAG;IACX,wgBAAwgB;IACxgB,uMAAuM;IACvM,mNAAmN;IACnN,sHAAsH;IACtH,6EAA6E;IAC7E,kJAAkJ;CACnJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAEZ;;;;GAIG;AACH,MAAM,UAAU,gCAAgC,CAAC,SAAgC,EAAE;IACjF,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,aAAa;QACpB,IAAI,EAAE,MAAM,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI;KAC3C,CAAA;AACH,CAAC"}

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "@hy-sde-org/dsh-tool-codebase-memory",
+  "description": "Model-facing codebase-memory CLI tools (codebase_list_projects/index_repository/index_status/search_graph/query_graph/trace_path/get_code_snippet/get_graph_schema/get_architecture/search_code/detect_changes/manage_adr/ingest_traces/delete_project) that run one-shot queries against the codebase-memory daemon from the terminal — the local alternative to the stdio MCP client row",
+  "version": "0.1.2-rc.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hy-sde/dsh-tool-codebase-memory.git"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./codebase-memory": {
+      "types": "./dist/codebase-memory.d.ts",
+      "default": "./dist/codebase-memory.js"
+    },
+    "./prompt": {
+      "types": "./dist/prompt.d.ts",
+      "default": "./dist/prompt.js"
+    },
+    "./invariant": {
+      "types": "./dist/invariant.d.ts",
+      "default": "./dist/invariant.js"
+    },
+    "./cli-check": {
+      "types": "./dist/cli-check.d.ts",
+      "default": "./dist/cli-check.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "cordis.patch.yml",
+    "README.md",
+    "README.zh.md",
+    "README.i18n.yaml",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "license": "MIT",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "dependencies": {},
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-invariants": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.1.2-rc.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-invariants": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.1.2-rc.1",
+    "@types/node": "^24.13.3",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.7"
+  },
+  "keywords": [
+    "deepseek",
+    "agent",
+    "harness",
+    "dsh-plugin",
+    "codebase-memory",
+    "code-intelligence",
+    "knowledge-graph",
+    "tool"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc -p tsconfig.build.json",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}