@dotdotgod/claude-code 0.3.0 → 0.3.2

package/commands/dd/load.md

@@ -14,7 +14,7 @@ User focus, if provided: `$ARGUMENTS`
 
 ## CLI Context
 
-Run `dotdotgod config <root> --json` and apply `config.load.documentationSummary.exclude` before building the documentation tree. With focus text, run `dotdotgod query <root> "<focus>" --limit 30 --json`. If the CLI is unavailable, continue from the documentation tree and README indexes.
+Run `dotdotgod map <root> --depth 5 --json` for a broad documentation map. With focus text, run `dotdotgod query <root> "<focus>" --limit 30 --json` and `dotdotgod map <root> --depth 3 --json`. The map command resolves the configured documentation root and exclusions. If the CLI is unavailable, continue from the documentation tree and README indexes.
 
 ## Goal
 
@@ -24,9 +24,10 @@ Load the repository's dotdotgod project memory without modifying maintained file
 
 1. Identify the repository root. Expose `Help: dotdotgod --help` as optional CLI discovery guidance without checking or reporting installation status, and do not require Help execution for Load to continue.
 2. When baseline context is missing, read `AGENTS.md`, the adapter entrypoint, `README.md`, and `docs/README.md` when present.
-3. Build a prefix-compressed tree of `docs/**/*.md` after `load.documentationSummary.exclude`. Count `docs/` as depth 1; without arguments, expand through depth 5. At the boundary, list every direct Markdown file and immediate child directory regardless of item count, then summarize hidden descendants separately under each named child with exact recursive directory and Markdown-file counts.
-4. With arguments, use focused query results to return at most 30 distinct Markdown files and render the tree through depth 3 with the same named boundary-child summaries.
-5. Read bodies selectively from query results, explicit paths, and README indexes. Read relevant active plans only when needed, use `docs/archive/README.md` as the history map, and avoid broad generated, dependency, cache, or secret reads.
+3. Without arguments, run `dotdotgod map <root> --depth 5 --json` and use its configured prefix-compressed documentation tree. The command owns `documentation.root`, `load.documentationSummary.exclude`, deterministic Markdown discovery, and boundary summaries.
+4. With arguments, run `dotdotgod query <root> "<focus>" --limit 30 --json` for at most 30 distinct Markdown files and `dotdotgod map <root> --depth 3 --json` for the configured navigation tree.
+5. If the CLI or shell execution is unavailable, preserve Load behavior by building the same tree from the configured documentation root when known, excluding local memory, and using README routing. At the depth boundary, list every direct Markdown file and immediate child directory, then summarize hidden descendants separately under each named child with exact recursive directory and Markdown-file counts.
+6. Read bodies selectively from query results, explicit paths, and README indexes. Read relevant active plans only when needed, use `docs/archive/README.md` (or the configured archive `README.md` under an alternate documentation root) as the history map, and avoid broad generated, dependency, cache, or secret reads.
 
 ## Output
 

package/hooks/runtime.mjs

@@ -1,3 +1,120 @@
 #!/usr/bin/env node
-import { hookMain } from '@dotdotgod/context/hooks';
-hookMain(process.argv[2] || '');
+// Generated by scripts/build-adapter-runtime.mjs; do not edit.
+
+// packages/context/src/hooks.mjs
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { createHash } from "node:crypto";
+import { dirname, join, resolve } from "node:path";
+function inputText() {
+  return readFileSync(0, "utf8");
+}
+function parseInput() {
+  const text = inputText().trim();
+  return text ? JSON.parse(text) : {};
+}
+function projectRoot(input) {
+  return resolve(input.cwd || input.project_dir || process.env.CLAUDE_PROJECT_DIR || process.cwd());
+}
+function sessionId(input) {
+  return String(input.session_id || input.sessionId || "default").replace(/[^a-zA-Z0-9._-]/g, "_");
+}
+function statePath(input) {
+  return join(projectRoot(input), ".dotdotgod", "context", "runtime", `${sessionId(input)}.json`);
+}
+function readState(input) {
+  try {
+    return JSON.parse(readFileSync(statePath(input), "utf8"));
+  } catch {
+    return { loadRequired: false, pending: {} };
+  }
+}
+function writeState(input, state) {
+  const path = statePath(input);
+  mkdirSync(dirname(path), { recursive: true });
+  const temp = `${path}.${process.pid}.tmp`;
+  writeFileSync(temp, `${JSON.stringify(state, null, 2)}
+`);
+  renameSync(temp, path);
+}
+function fileHash(path) {
+  try {
+    return createHash("sha256").update(readFileSync(path)).digest("hex");
+  } catch {
+    return "missing";
+  }
+}
+function toolName(input) {
+  return String(input.tool_name || input.toolName || "");
+}
+function toolInput(input) {
+  return input.tool_input || input.toolInput || {};
+}
+function mcpTool(name, suffix) {
+  return name === suffix || name.endsWith(`__${suffix}`) || name.endsWith(`_${suffix}`);
+}
+function deny(reason) {
+  return { hookSpecificOutput: { hookEventName: "PreToolUse", permissionDecision: "deny", permissionDecisionReason: reason } };
+}
+function commandFrom(input) {
+  const value = toolInput(input);
+  return String(value.command || value.cmd || "");
+}
+function isSubstantive(name) {
+  return /^(Bash|Shell|local_shell|shell|shell_command|exec_command|Edit|Write|apply_patch)$/i.test(name);
+}
+function isImpactGate(name, input) {
+  if (!/^(Bash|Shell|local_shell|shell|shell_command|exec_command)$/i.test(name)) return false;
+  return /(^|\s)(test|build|lint|verify|commit|push|publish|deploy)(\s|:|$)|\b(git\s+(commit|push)|npm\s+(test|publish)|pnpm\s+[^\n]*(test|build|lint|verify|publish))\b/i.test(commandFrom(input));
+}
+function changedPath(input) {
+  const value = toolInput(input);
+  const path = value.file_path || value.path;
+  return typeof path === "string" ? resolve(projectRoot(input), path) : null;
+}
+function runHook(event) {
+  const input = parseInput();
+  const name = toolName(input);
+  const state = readState(input);
+  state.pending ||= {};
+  if (event === "sessionstart") {
+    state.loadRequired = true;
+    writeState(input, state);
+    return { hookSpecificOutput: { hookEventName: "SessionStart", additionalContext: "Dotdotgod project memory has not been loaded for this session. Before substantive shell or write work, call dotdotgod_project_load once with a concise task-specific focus." } };
+  }
+  if (event === "pretooluse") {
+    if (mcpTool(name, "dotdotgod_project_load") || mcpTool(name, "dotdotgod_project_impact")) return {};
+    if (state.loadRequired && isSubstantive(name)) return deny("Project memory is required first. Call dotdotgod_project_load with the current project root and a concise task-specific focus, then retry this tool.");
+    const pendingPaths = Object.keys(state.pending);
+    if (pendingPaths.length && isImpactGate(name, input)) return deny(`Graph impact is pending. Call dotdotgod_project_impact with paths=${JSON.stringify(pendingPaths)} and then retry this tool.`);
+    return {};
+  }
+  if (event === "posttooluse") {
+    if (mcpTool(name, "dotdotgod_project_load")) state.loadRequired = false;
+    else if (mcpTool(name, "dotdotgod_project_impact")) {
+      const checked = toolInput(input).paths;
+      if (Array.isArray(checked)) for (const path of checked) {
+        const absolute = resolve(projectRoot(input), path);
+        if (state.pending[absolute] === fileHash(absolute)) delete state.pending[absolute];
+      }
+    } else if (/^(Edit|Write|apply_patch)$/i.test(name)) {
+      const path = changedPath(input);
+      if (path) state.pending[path] = fileHash(path);
+    }
+    writeState(input, state);
+    return {};
+  }
+  return {};
+}
+function hookMain(event) {
+  try {
+    process.stdout.write(`${JSON.stringify(runHook(event))}
+`);
+  } catch (error) {
+    process.stderr.write(`dotdotgod hook error: ${error instanceof Error ? error.message : String(error)}
+`);
+    process.stdout.write("{}\n");
+  }
+}
+
+// packages/claude-code/hooks/runtime-entry.mjs
+hookMain(process.argv[2] || "");