claude-capsule-kit 3.0.0

package/templates/statusline-command.sh

@@ -0,0 +1,208 @@
+#!/bin/bash
+
+# Read JSON input from stdin
+input=$(cat)
+
+# Extract current working directory from JSON
+cwd=$(echo "$input" | jq -r '.workspace.current_dir')
+
+# Change to the working directory for git commands
+cd "$cwd" 2>/dev/null || cd "$HOME"
+
+# Get directory path with home substitution
+dir_path="${PWD/#$HOME/~}"
+
+# --- Config: load section visibility ---
+config_file="$HOME/.claude/statusline-config.json"
+cfg_model=true; cfg_duration=true; cfg_context=true
+cfg_worktree=true; cfg_crew=true; cfg_capsule_pill=true
+cfg_compact_threshold=85
+if [ -f "$config_file" ]; then
+    _cfg_val() { jq -r "if has(\"$1\") then .$1 else true end" "$config_file" 2>/dev/null; }
+    cfg_model=$(_cfg_val model)
+    cfg_duration=$(_cfg_val duration)
+    cfg_context=$(_cfg_val context)
+    cfg_worktree=$(_cfg_val worktree)
+    cfg_crew=$(_cfg_val crew)
+    cfg_capsule_pill=$(_cfg_val capsule_pill)
+    ct=$(jq -r 'if has("compact_threshold") then .compact_threshold else 85 end' "$config_file" 2>/dev/null)
+    [ -n "$ct" ] && [ "$ct" != "null" ] && cfg_compact_threshold=$ct
+fi
+
+# --- Colors ---
+C_RESET='\033[0m'
+C_TEAL='\033[38;5;116m'
+C_LAVENDER='\033[38;5;183m'
+C_ORANGE='\033[38;5;214m'
+C_GREEN='\033[38;5;114m'
+C_YELLOW='\033[38;5;221m'
+C_RED='\033[38;5;203m'
+C_CYAN='\033[38;5;117m'
+C_DIM='\033[38;5;245m'
+C_SEPARATOR='\033[38;5;240m'
+C_THRESHOLD='\033[38;5;198m'
+C_BOLD='\033[1m'
+
+# Initialize output
+output=""
+
+# ── Section 1: Directory ──
+output+="$(printf "${C_TEAL}%s${C_RESET}" "$dir_path")"
+
+# ── Section 2: Git info ──
+is_worktree=false
+if git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+    # Detect if this is a git worktree (not the main working tree)
+    git_common=$(git rev-parse --git-common-dir 2>/dev/null)
+    git_dir=$(git rev-parse --git-dir 2>/dev/null)
+    if [ -n "$git_common" ] && [ -n "$git_dir" ] && [ "$git_common" != "$git_dir" ]; then
+        is_worktree=true
+    fi
+
+    # Get git remote symbol
+    git_remote=$(git ls-remote --get-url 2>/dev/null)
+    git_symbol=""
+
+    if [[ "$git_remote" =~ "github" ]]; then
+        git_symbol=" "
+    elif [[ "$git_remote" =~ "gitlab" ]]; then
+        git_symbol=" "
+    elif [[ "$git_remote" =~ "bitbucket" ]]; then
+        git_symbol=" "
+    elif [[ "$git_remote" =~ "git" ]]; then
+        git_symbol=" "
+    else
+        git_symbol=" "
+    fi
+
+    output+=" $git_symbol "
+
+    # Get git branch (bold lavender)
+    git_branch=$(git branch --show-current 2>/dev/null || git rev-parse --short HEAD 2>/dev/null)
+    if [ -n "$git_branch" ]; then
+        output+="$(printf "on ${C_LAVENDER}${C_BOLD}%s${C_RESET} " "$git_branch")"
+    fi
+
+    # Worktree indicator (pill badge, right after branch)
+    if [ "$is_worktree" = true ] && [ "$cfg_worktree" = true ]; then
+        C_WT_BG='\033[48;5;54m'    # purple background
+        C_WT_FG='\033[38;5;177m'   # light magenta text
+        output+="$(printf "${C_WT_BG}${C_WT_FG}${C_BOLD}  worktree ${C_RESET} ")"
+    fi
+
+    # Get git status
+    git_status_output=""
+
+    porcelain=$(git status --porcelain 2>/dev/null)
+    if [ -n "$porcelain" ]; then
+        modified=$(echo "$porcelain" | grep -c '^ M' 2>/dev/null || true)
+        added=$(echo "$porcelain" | grep -c '^A' 2>/dev/null || true)
+        deleted=$(echo "$porcelain" | grep -c '^ D' 2>/dev/null || true)
+        untracked=$(echo "$porcelain" | grep -c '^??' 2>/dev/null || true)
+        modified=$((modified + 0))
+        added=$((added + 0))
+        deleted=$((deleted + 0))
+        untracked=$((untracked + 0))
+
+        [ "$modified" -gt 0 ] && git_status_output+="!${modified} "
+        [ "$added" -gt 0 ] && git_status_output+="+${added} "
+        [ "$deleted" -gt 0 ] && git_status_output+="✘${deleted} "
+        [ "$untracked" -gt 0 ] && git_status_output+="?${untracked} "
+    fi
+
+    ahead_behind=$(git -c core.fileMode=false rev-list --left-right --count HEAD...@{upstream} 2>/dev/null | tr -s '[:space:]' ' ')
+    if [ -n "$ahead_behind" ]; then
+        ahead=$(echo "$ahead_behind" | awk '{print $1+0}')
+        behind=$(echo "$ahead_behind" | awk '{print $2+0}')
+        [ "$ahead" -gt 0 ] 2>/dev/null && git_status_output+="⇡${ahead} "
+        [ "$behind" -gt 0 ] 2>/dev/null && git_status_output+="⇣${behind} "
+    fi
+
+    if [ -n "$git_status_output" ]; then
+        output+=" $(printf '%s' "$git_status_output")"
+    fi
+fi
+
+# ── Separator ──
+output+="$(printf " ${C_SEPARATOR}║${C_RESET} ")"
+
+# ── Section 3: Model ──
+if [ "$cfg_model" = true ]; then
+    model_name=$(echo "$input" | jq -r '.model.display_name // empty')
+    if [ -n "$model_name" ]; then
+        output+="$(printf "${C_ORANGE} %s${C_RESET}" "$model_name")"
+    fi
+fi
+
+# ── Section 3b: Session duration ──
+if [ "$cfg_duration" = true ]; then
+    duration_ms=$(echo "$input" | jq -r '.cost.total_duration_ms // empty')
+    if [ -n "$duration_ms" ] && [ "$duration_ms" != "0" ]; then
+        total_sec=$((duration_ms / 1000))
+        if [ "$total_sec" -ge 3600 ]; then
+            hrs=$((total_sec / 3600))
+            mins=$(( (total_sec % 3600) / 60 ))
+            dur_str="${hrs}h ${mins}m"
+        elif [ "$total_sec" -ge 60 ]; then
+            mins=$((total_sec / 60))
+            dur_str="${mins}m"
+        else
+            dur_str="${total_sec}s"
+        fi
+        output+="$(printf " ${C_DIM}%s${C_RESET}" "$dur_str")"
+    fi
+fi
+
+
+# ── Section 4: Context window usage ──
+if [ "$cfg_context" = true ]; then
+    ctx_pct=$(echo "$input" | jq -r '.context_window.used_percentage // empty')
+    if [ -n "$ctx_pct" ] && [ "$ctx_pct" != "null" ]; then
+        pct_int=${ctx_pct%.*}
+        pct_int=${pct_int:-0}
+        filled=$((pct_int / 10))
+
+        if [ "$pct_int" -ge 80 ]; then
+            bar_color="$C_RED"
+        elif [ "$pct_int" -ge 50 ]; then
+            bar_color="$C_YELLOW"
+        else
+            bar_color="$C_GREEN"
+        fi
+
+        # Build bar with auto-compact threshold marker
+        threshold_seg=$((cfg_compact_threshold / 10))
+        bar=""
+        for ((i=0; i<10; i++)); do
+            if [ "$i" -eq "$threshold_seg" ]; then
+                bar+="$(printf "${C_THRESHOLD}┃${C_RESET}")"
+            elif [ "$i" -lt "$filled" ]; then
+                bar+="$(printf "${bar_color}█${C_RESET}")"
+            else
+                bar+="$(printf "${C_DIM}░${C_RESET}")"
+            fi
+        done
+
+        output+="$(printf " ${C_DIM}context${C_RESET} %s ${bar_color}%s%%${C_RESET}" "$bar" "$pct_int")"
+    fi
+fi
+
+# ── Section 5: CCK active (pill badge) ──
+if [ "$cfg_capsule_pill" = true ] && [ -d "$HOME/.claude/cck" ]; then
+    C_PILL_BG='\033[48;5;22m'   # dark green background
+    C_PILL_FG='\033[38;5;157m'  # light green text
+    output+="$(printf " ${C_SEPARATOR}║${C_RESET} ${C_PILL_BG}${C_PILL_FG}${C_BOLD} capsule kit ${C_RESET}")"
+fi
+
+# ── Section 6: Crew mode ──
+if [ "$cfg_crew" = true ]; then
+    crew_file="$cwd/crew-identity.json"
+    if [ -f "$crew_file" ]; then
+        crew_name=$(jq -r '.teammate_name // empty' "$crew_file" 2>/dev/null)
+        if [ -n "$crew_name" ]; then
+            output+="$(printf " ${C_CYAN}${C_BOLD}@crew${C_RESET}${C_DIM}=${C_RESET}${C_CYAN}%s${C_RESET}" "$crew_name")"
+        fi
+    fi
+fi
+
+echo "$output"

package/tools/context-query/context-query.js

@@ -0,0 +1,312 @@
+#!/usr/bin/env node
+/**
+ * Context-Query Tool v3.0 - Query Capsule context database
+ * Uses blink-query for namespace/type-aware querying
+ */
+
+import { Blink } from 'blink-query';
+import { existsSync } from 'fs';
+import { dirname, join } from 'path';
+import { homedir } from 'os';
+import { createHash } from 'crypto';
+import { execSync } from 'child_process';
+
+function findCapsuleDb() {
+  const globalDb = join(homedir(), '.claude', 'capsule.db');
+  if (existsSync(globalDb)) return globalDb;
+  let dir = process.cwd();
+  while (dir !== '/') {
+    const dbPath = join(dir, '.claude', 'capsule.db');
+    if (existsSync(dbPath)) return dbPath;
+    dir = dirname(dir);
+  }
+  return null;
+}
+
+function getProjectHash() {
+  let identifier;
+  try {
+    identifier = execSync('git remote get-url origin', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+  } catch {
+    identifier = process.cwd();
+  }
+  return createHash('sha256').update(identifier).digest('hex').slice(0, 12);
+}
+
+function getAllRecords(blink) {
+  const hash = getProjectHash();
+  let projRecords = [];
+  try { projRecords = blink.list(`proj/${hash}/session`, 'recent'); } catch { /* no proj records */ }
+  let projCrew = [];
+  try { projCrew = blink.list(`proj/${hash}/crew`, 'recent'); } catch { /* no crew records */ }
+  let solo = [];
+  try { solo = blink.list('session', 'recent'); } catch { /* no legacy records */ }
+  let crew = [];
+  try { crew = blink.list('crew', 'recent'); } catch { /* no crew records */ }
+  return [...projRecords, ...projCrew, ...solo, ...crew];
+}
+
+const dbPath = findCapsuleDb();
+if (!dbPath) {
+  console.log('No capsule.db found. Context will be available after your first session.');
+  process.exit(0);
+}
+
+const blink = new Blink({ dbPath });
+const [,, cmd = 'help', arg, limitArg] = process.argv;
+
+try {
+  switch (cmd) {
+    case 'search': {
+      if (!arg) {
+        console.log('Usage: context-query search <term>');
+        process.exit(1);
+      }
+      const results = blink.search(arg, undefined, parseInt(limitArg) || 10);
+      console.log(`## Capsule Search: ${arg}\n`);
+      if (results.length === 0) {
+        console.log(`No results found for '${arg}'`);
+      } else {
+        results.forEach(r => {
+          console.log(`- **[${r.type}]** ${r.title}`);
+          if (r.summary) console.log(`  ${r.summary.replace(/\n/g, ' ').slice(0, 120)}`);
+        });
+      }
+      break;
+    }
+
+    case 'files': {
+      const limit = parseInt(arg) || 20;
+      const all = getAllRecords(blink);
+      const fileRecords = all.filter(r => r.namespace?.includes('/files')).slice(0, limit);
+      console.log(`## Recent File Operations (${fileRecords.length})\n`);
+      if (fileRecords.length === 0) {
+        console.log('No file operations recorded yet');
+      } else {
+        fileRecords.forEach(r => {
+          console.log(`- **${r.title}**: ${r.summary?.replace(/\n/g, ' ').slice(0, 100) || ''}`);
+        });
+      }
+      break;
+    }
+
+    case 'agents': {
+      const limit = parseInt(arg) || 10;
+      const all = getAllRecords(blink);
+      const agentRecords = all.filter(r => r.namespace?.includes('/subagents')).slice(0, limit);
+      console.log(`## Sub-Agent History (${agentRecords.length})\n`);
+      if (agentRecords.length === 0) {
+        console.log('No sub-agent records found');
+      } else {
+        agentRecords.forEach(r => {
+          console.log(`- **${r.title}**`);
+          if (r.summary) console.log(`  ${r.summary.replace(/\n/g, ' ').slice(0, 120)}`);
+        });
+      }
+      break;
+    }
+
+    case 'sessions': {
+      const limit = parseInt(arg) || 5;
+      const all = getAllRecords(blink);
+      const sessionRecords = all.filter(r =>
+        r.namespace?.endsWith('/session') || r.namespace === 'session' || (r.namespace?.includes('crew') && r.type === 'META')
+      ).slice(0, limit);
+      console.log(`## Session History (${sessionRecords.length})\n`);
+      if (sessionRecords.length === 0) {
+        console.log('No session records found');
+      } else {
+        sessionRecords.forEach(r => {
+          console.log(`- **${r.title}**`);
+          if (r.summary) console.log(`  ${r.summary.replace(/\n/g, ' ').slice(0, 120)}`);
+        });
+      }
+      break;
+    }
+
+    case 'recent': {
+      const limit = parseInt(arg) || 15;
+      const all = getAllRecords(blink).slice(0, limit);
+      console.log(`## Recent Activity (${all.length})\n`);
+      all.forEach(r => {
+        console.log(`- [${r.type}] **${r.title}** (${r.namespace})`);
+        if (r.summary) console.log(`  ${r.summary.replace(/\n/g, ' ').slice(0, 80)}`);
+      });
+      break;
+    }
+
+    case 'ns': {
+      if (!arg) {
+        console.log('Usage: context-query ns <namespace> [limit]');
+        console.log('Example: context-query ns "session" 10');
+        process.exit(1);
+      }
+      const limit = parseInt(limitArg) || 10;
+      const results = blink.query(`${arg} limit ${limit}`);
+      console.log(`## Namespace: ${arg} (${results.length})\n`);
+      if (results.length === 0) {
+        console.log('No records in this namespace');
+      } else {
+        results.forEach(r => {
+          console.log(`- **[${r.type}]** ${r.title}`);
+          if (r.summary) console.log(`  ${r.summary.replace(/\n/g, ' ').slice(0, 120)}`);
+        });
+      }
+      break;
+    }
+
+    case 'save': {
+      if (!arg) {
+        console.log('Usage: context-query save <namespace> <title> <summary> [type]');
+        console.log('Types: SUMMARY (default), META, COLLECTION, SOURCE, ALIAS');
+        console.log('');
+        console.log('Examples:');
+        console.log('  save discoveries "OAuth flow" "Uses PKCE with refresh tokens"');
+        console.log('  save session/notes "DB schema" "Users table has soft deletes" META');
+        process.exit(1);
+      }
+      const namespace = arg;
+      const title = process.argv[4];
+      const summary = process.argv[5];
+      const type = process.argv[6] || 'SUMMARY';
+      if (!title || !summary) {
+        console.log('Error: title and summary are required');
+        console.log('Usage: context-query save <namespace> <title> <summary> [type]');
+        process.exit(1);
+      }
+      blink.save({ namespace, title, summary, type, tags: [] });
+      console.log(`Saved to ${namespace}: "${title}" [${type}]`);
+      break;
+    }
+
+    case 'update': {
+      if (!arg) {
+        console.log('Usage: context-query update <search-term> <new-summary>');
+        console.log('');
+        console.log('Finds the most recent record matching the search term and updates it.');
+        console.log('');
+        console.log('Examples:');
+        console.log('  update "OAuth flow" "Now uses PKCE + DPoP with 15min token expiry"');
+        process.exit(1);
+      }
+      const searchTerm = arg;
+      const newSummary = process.argv[4];
+      if (!newSummary) {
+        console.log('Error: new summary is required');
+        process.exit(1);
+      }
+      const matches = blink.search(searchTerm, undefined, 1);
+      if (matches.length === 0) {
+        console.log(`No record found matching '${searchTerm}'`);
+        process.exit(1);
+      }
+      const record = matches[0];
+      blink.save({
+        namespace: record.namespace,
+        title: record.title,
+        summary: newSummary,
+        type: record.type,
+        tags: record.tags || []
+      });
+      console.log(`Updated "${record.title}" in ${record.namespace}`);
+      console.log(`  Old: ${record.summary?.replace(/\n/g, ' ').slice(0, 80)}`);
+      console.log(`  New: ${newSummary.slice(0, 80)}`);
+      break;
+    }
+
+    case 'discoveries': {
+      const limit = parseInt(arg) || 50;
+      const hash = getProjectHash();
+      let allDiscoveries = [];
+
+      // Query all possible discovery namespaces
+      const namespaces = [
+        'discoveries',                            // legacy global
+        `proj/${hash}/discoveries`,              // project-scoped
+        `proj/${hash}/crew/_shared/discoveries`, // crew shared
+      ];
+
+      namespaces.forEach(ns => {
+        try {
+          const result = blink.resolve(ns);
+          // blink.resolve returns {status, record} — content has child refs
+          // Resolve each child fully to get created_at, summary, etc.
+          if (result?.record?.content && Array.isArray(result.record.content)) {
+            for (const child of result.record.content) {
+              try {
+                const full = blink.resolve(child.path);
+                if (full?.record) allDiscoveries.push(full.record);
+              } catch { /* skip unresolvable */ }
+            }
+          } else if (result?.record?.summary) {
+            allDiscoveries.push(result.record);
+          }
+        } catch {
+          // Namespace doesn't exist, skip
+        }
+      });
+
+      // Sort by timestamp descending
+      allDiscoveries.sort((a, b) => (b.created_at || 0) - (a.created_at || 0));
+      const discoveries = allDiscoveries.slice(0, limit);
+
+      console.log(`## Discoveries (${discoveries.length})\n`);
+      if (discoveries.length === 0) {
+        console.log('No discoveries saved yet.');
+        console.log('');
+        console.log('Save a discovery:');
+        console.log('  context-query save discoveries "Finding title" "Summary of the discovery"');
+      } else {
+        discoveries.forEach(r => {
+          const date = r.created_at ? new Date(r.created_at).toISOString().split('T')[0] : 'unknown';
+          console.log(`- **${r.title}** (${date})`);
+          if (r.summary) {
+            console.log(`  ${r.summary.replace(/\n/g, ' ')}`);
+          }
+          console.log('');
+        });
+      }
+      break;
+    }
+
+    case 'stats': {
+      const all = getAllRecords(blink);
+      const byType = {};
+      let files = 0, agents = 0;
+      const sessions = new Set();
+      all.forEach(r => {
+        byType[r.type] = (byType[r.type] || 0) + 1;
+        if (r.namespace?.includes('/files')) files++;
+        if (r.namespace?.includes('/subagents')) agents++;
+        const match = r.namespace?.match(/session\/([^/]+)/);
+        if (match) sessions.add(match[1]);
+      });
+      console.log(`## Capsule Stats\n`);
+      console.log(`- Total records: ${all.length}`);
+      console.log(`- Files tracked: ${files}`);
+      console.log(`- Sub-agents: ${agents}`);
+      console.log(`- Sessions: ${sessions.size}`);
+      console.log(`- Types: ${Object.entries(byType).map(([k,v]) => `${k}(${v})`).join(', ')}`);
+      break;
+    }
+
+    default:
+      console.log(`## Capsule Context Query\n`);
+      console.log(`Usage: bash $HOME/.claude/cck/tools/context-query/context-query.sh <command> [args]\n`);
+      console.log(`Read:`);
+      console.log(`  search <term>      Search records by keyword`);
+      console.log(`  files [limit]      Recent file operations (default: 20)`);
+      console.log(`  agents [limit]     Sub-agent invocation history (default: 10)`);
+      console.log(`  sessions [limit]   Session summaries (default: 5)`);
+      console.log(`  recent [limit]     All recent activity (default: 15)`);
+      console.log(`  discoveries [limit] All saved discoveries (default: 50)`);
+      console.log(`  ns <namespace>     Query specific Capsule namespace`);
+      console.log(`  stats              Database statistics`);
+      console.log(``);
+      console.log(`Write:`);
+      console.log(`  save <ns> <title> <summary> [type]   Save a record`);
+      console.log(`  update <search> <new-summary>        Update most recent match`);
+  }
+} finally {
+  blink.close();
+}

package/tools/context-query/context-query.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Context-Query Tool - Bash wrapper for global CCK
+# Queries Capsule context database
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+exec node "$SCRIPT_DIR/context-query.js" "$@"

package/tools/context-query/tool.json

@@ -0,0 +1,42 @@
+{
+  "name": "context-query",
+  "version": "3.0.0",
+  "description": "Query Capsule context database for session history, file operations, and sub-agent results",
+  "type": "node",
+  "entry": "context-query.js",
+  "author": "Arpit Nath",
+  "keywords": ["context", "capsule", "retrieval", "session", "history"],
+  "usage": {
+    "command": "bash .claude/tools/context-query/context-query.sh <command> [args]",
+    "args": {
+      "command": "One of: search, files, agents, sessions, recent"
+    },
+    "examples": [
+      {
+        "description": "Search for context about authentication",
+        "command": "bash .claude/tools/context-query/context-query.sh search authentication"
+      },
+      {
+        "description": "List recent file operations",
+        "command": "bash .claude/tools/context-query/context-query.sh files"
+      },
+      {
+        "description": "Show sub-agent history",
+        "command": "bash .claude/tools/context-query/context-query.sh agents"
+      },
+      {
+        "description": "Show last 3 session summaries",
+        "command": "bash .claude/tools/context-query/context-query.sh sessions 3"
+      }
+    ]
+  },
+  "requires": {
+    "bash": ">=4.0",
+    "sqlite3": "any"
+  },
+  "permissions": {
+    "read": [".claude/capsule.db"],
+    "write": [],
+    "network": false
+  }
+}

package/tools/dependency-scanner/dependency-scanner.sh

@@ -0,0 +1,53 @@
+#!/bin/bash
+# Dependency Scanner Wrapper
+# Rebuilds the dependency graph for current project
+
+set -euo pipefail
+
+# Find .claude directory by searching parent directories
+find_claude_dir() {
+  local current_dir="$PWD"
+  while [ "$current_dir" != "/" ]; do
+    if [ -d "$current_dir/.claude" ]; then
+      echo "$current_dir/.claude"
+      return 0
+    fi
+    current_dir=$(dirname "$current_dir")
+  done
+  echo ".claude"
+  return 1
+}
+
+CLAUDE_DIR=$(find_claude_dir)
+
+# Check if dependency-scanner binary exists
+if [ ! -x "${HOME}/.claude/bin/dependency-scanner" ]; then
+  echo "Error: dependency-scanner binary not found at ~/.claude/bin/dependency-scanner"
+  echo "Run installation to build it."
+  exit 1
+fi
+
+echo "Building dependency graph..."
+echo ""
+
+# Run the scanner
+"${HOME}/.claude/bin/dependency-scanner" \
+  --output "${CLAUDE_DIR}/dep-graph.toon" \
+  --languages typescript,javascript,python,go \
+  . 2>&1
+
+if [ -f "${CLAUDE_DIR}/dep-graph.toon" ]; then
+  FILE_COUNT=$(grep -c "^FILE{" "${CLAUDE_DIR}/dep-graph.toon" || echo "0")
+  echo ""
+  echo "✓ Dependency graph built successfully"
+  echo "  Files analyzed: ${FILE_COUNT}"
+  echo "  Graph saved to: ${CLAUDE_DIR}/dep-graph.toon"
+  echo ""
+  echo "Query with:"
+  echo "  bash $HOME/.claude/cck/tools/query-deps/query-deps.sh <file>"
+  echo "  bash $HOME/.claude/cck/tools/find-circular/find-circular.sh"
+  echo "  bash $HOME/.claude/cck/tools/find-dead-code/find-dead-code.sh"
+else
+  echo "Error: Failed to create dependency graph"
+  exit 1
+fi

package/tools/dependency-scanner/tool.json

@@ -0,0 +1,8 @@
+{
+  "name": "dependency-scanner",
+  "description": "Rebuild dependency graph for current project (analyzes imports/exports)",
+  "type": "bash",
+  "command": "bash .claude/tools/dependency-scanner/dependency-scanner.sh",
+  "entry": "dependency-scanner.sh",
+  "when_to_use": "When dependency graph is stale or needs manual refresh"
+}

package/tools/find-circular/find-circular.sh

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+# Find circular dependencies
+
+set -eo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LIB_DIR="${CCK_LIB_DIR:-$(cd "$SCRIPT_DIR/../../lib" && pwd 2>/dev/null || echo "$HOME/.claude/cck/lib")}"
+
+source "$LIB_DIR/toon-parser.sh"
+
+GRAPH_FILE="${DEP_GRAPH_FILE:-.claude/dep-graph.toon}"
+
+if [ $# -ge 1 ]; then
+    GRAPH_FILE="$1"
+fi
+
+if [ ! -f "$GRAPH_FILE" ]; then
+    echo "Error: Graph file not found: $GRAPH_FILE"
+    echo "Run the dependency scanner first to generate the graph"
+    exit 1
+fi
+
+CIRCULAR=$(toon_get_circular "$GRAPH_FILE")
+
+if [ -z "$CIRCULAR" ]; then
+    echo "No circular dependencies found"
+    exit 0
+fi
+
+CYCLE_COUNT=$(echo "$CIRCULAR" | wc -l | tr -d ' ')
+
+echo "Found $CYCLE_COUNT circular dependency cycle(s):"
+echo ""
+
+INDEX=1
+echo "$CIRCULAR" | while IFS= read -r cycle; do
+    echo "Cycle $INDEX:"
+    echo "  $cycle" | tr '>' $'\n  → '
+    echo ""
+    INDEX=$((INDEX + 1))
+done