@m1khal3v/dsh-tool-codegraph 0.0.1 → 1.0.1

package/README.md

@@ -36,7 +36,7 @@
 ### 1. Install the plugin
 
 ```sh
-dsh plugin add @m1khal3v/dsh-tool-codegraph
+dsh plugin add --profile web @m1khal3v/dsh-tool-codegraph
 ```
 
 ### 2. Check the wrapped CLI
@@ -46,7 +46,20 @@ codegraph status
 ```
 
 If the binary is missing, the tools reply with an install hint and the agent
-falls back to `bash`/`grep`.
+falls back to `grep`-based search.
+
+### 3. Initialize the index — your call
+
+There is deliberately **no init tool** in the set above: following the codegraph
+project's own recommendation, indexing should be kicked off by the user, not by
+an agent. When `codegraph status` reports a missing index, run it yourself:
+
+```sh
+codegraph init
+```
+
+Until you do, the tools report the missing index and the agent keeps working
+with other search tools.
 
 ## 🧰 Tools
 

package/lib/index.d.ts

@@ -11,9 +11,9 @@
  *
  * A system-prompt section teaches the model the orientation-first workflow:
  * status first; a missing index is the user's decision (the model tells the
- * user to run `codegraph init` and keeps working with bash/grep meanwhile);
+ * user to run `codegraph init` and keeps working with other tools meanwhile);
  * sync when stale; then lookups; callers/callees/impact are accelerators, not
- * exhaustive proofs — exhaustive searches fall back to bash/grep.
+ * exhaustive proofs — exhaustive searches fall back to grep.
  *
  * Execution follows the canonical-value flow: `execute` returns the structured
  * `CodegraphResult` validated against `CODEGRAPH_OUTPUT_SCHEMA`, and the

package/lib/index.js

@@ -53,7 +53,7 @@ function extractModelText(result) {
 	if (result.exitCode === 0) return (result.stdout.text.length > 0 ? result.stdout.text : NO_OUTPUT) + truncationMarker(result.stdout);
 	const stderr = result.stderr.text;
 	let text = stderr;
-	if (detectBinaryNotFound(stderr, result.exitCode ?? 0)) text += "\n[Codegraph executable not found. Please install it or rely on bash/grep.]";
+	if (detectBinaryNotFound(stderr, result.exitCode ?? 0)) text += "\n[Codegraph executable not found. Please install it or rely on grep (or similar) instead.]";
 	if (detectIndexMissing(stderr)) text += "\n[Codegraph error: Index missing. Run codegraph_init first.]";
 	return text;
 }
@@ -207,9 +207,9 @@ const codegraphToolSpecs = [
 *
 * A system-prompt section teaches the model the orientation-first workflow:
 * status first; a missing index is the user's decision (the model tells the
-* user to run `codegraph init` and keeps working with bash/grep meanwhile);
+* user to run `codegraph init` and keeps working with other tools meanwhile);
 * sync when stale; then lookups; callers/callees/impact are accelerators, not
-* exhaustive proofs — exhaustive searches fall back to bash/grep.
+* exhaustive proofs — exhaustive searches fall back to grep.
 *
 * Execution follows the canonical-value flow: `execute` returns the structured
 * `CodegraphResult` validated against `CODEGRAPH_OUTPUT_SCHEMA`, and the
@@ -246,11 +246,11 @@ function canonicalPath(input) {
 }
 /** System-prompt section text, verbatim contract of the tool catalog workflow. */
 const CODEGRAPH_PROMPT = `CodeGraph Usage Rules:
-- Workflow: ALWAYS check \`codegraph_status\` once per session first. If the index is missing, do NOT build it yourself — indexing is the user's decision: tell the user to run \`codegraph init\`, and continue with bash/grep meanwhile. If stale, run \`codegraph_sync\`.
+- Workflow: ALWAYS check \`codegraph_status\` once per session first. If the index is missing, do NOT build it yourself — indexing is the user's decision: tell the user to run \`codegraph init\`, and continue with other tools meanwhile. If stale, run \`codegraph_sync\`.
 - Orientation: Use \`codegraph_explore\` for mapping architecture or "how X works". Use \`codegraph_callers\` / \`codegraph_callees\` / \`codegraph_node\` for targeted lookups.
 - Subagents: For deep exploration, spawn a subagent and explicitly instruct it to use \`codegraph_explore\` — its verbatim source blocks are heavy, so keep them out of the main session.
 - DO NOT trust callers/callees/impact for completeness! They silently drop unresolved method/generic/trait-dispatch edges.
-- For exhaustive searches (e.g., finding ALL callers before a rename or signature change), you MUST use \`bash\` with \`grep\` or \`rg\`. Codegraph is only an accelerator.
+- For 100% accuracy (e.g., finding ALL callers before a rename or signature change), use \`grep\` or similar. Codegraph is only an accelerator.
 - Overloaded names: Do not query overloaded names with bare callers/callees. Use \`codegraph_node\` on a specific symbol ID or use grep.`;
 /**
 * Output contract validated against every successful `execute` value. The

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m1khal3v/dsh-tool-codegraph",
-  "version": "0.0.1",
+  "version": "1.0.1",
   "description": "CodeGraph integration for DeepSeek Harness",
   "license": "MIT",
   "author": "m1khal3v",
@@ -40,14 +40,6 @@
   "engines": {
     "node": "^22.19 || >=24"
   },
-  "scripts": {
-    "build": "tsdown && tsc -p tsconfig.types.json",
-    "prepublishOnly": "pnpm run build",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "verify": "pnpm run typecheck && pnpm run test"
-  },
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
@@ -83,5 +75,12 @@
     "tsdown": "^0.22.14",
     "typescript": "^5.9.0",
     "vitest": "^2.1.9"
+  },
+  "scripts": {
+    "build": "tsdown && tsc -p tsconfig.types.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "verify": "pnpm run typecheck && pnpm run test"
   }
-}
+}