index-updater

Index Updater - Incremental Index Maintenance

Keeps .claude/crew-index.json and .claude/crew-symbols.json up-to-date after code changes without rebuilding the entire index.

When to Activate

• After any agent makes file edits (triggered by afterFileEdit hook or agent self-reporting)
• When an agent notices the index is stale (hash mismatch)
• Manually via /crew reindex for full rebuild

Incremental Update Process

Step 1: Identify changed files

The agent that made changes should report which files were modified. Alternatively, check file hashes:

For each file in crew-index.json:
  1. Compute current hash: shasum -a 256 <filepath>
  2. Compare with stored hash
  3. If different → mark for update
  4. If file deleted → mark for removal

Step 2: Update Layer 1 (crew-index.json)

For each changed file:

1. Read the file
2. Recompute: hash, size, lines, exports, imports, functions, classes
3. Regenerate summary
4. Replace the file's entry in crew-index.json

For deleted files:

1. Remove the file's entry from crew-index.json

For new files (detected via Glob that aren't in index):

1. Read and extract full metadata
2. Add new entry to crew-index.json

Step 3: Update Layer 2 (crew-symbols.json)

For each changed file:

1. Re-extract all symbols (functions, classes, methods) with signatures and line ranges
2. Re-scan for calls to known symbols
3. Update calledBy relationships for affected symbols in other files
4. Replace all symbols for this file in crew-symbols.json
5. Rebuild affected callGraph entries

Step 4: Update global metadata

1. Recompute contentHash from all file hashes
2. Update stats (totalFiles, totalLines)
3. Update lastIndexed timestamp

Performance Rules

• Never rebuild entire index for a single file change
• Batch updates: If 3+ files changed in one edit cycle, update all at once
• Skip non-source files: Don't index changes to .json, .md, .yml unless they're in the monitored set
• Lazy callGraph: Only rebuild callGraph edges that involve the changed file