update-code-index

Update Code Index

Regenerates CODE_INDEX.md by scanning the codebase for all functions, classes, hooks, and components. Organizes by capability to prevent semantic duplication.

---

What This Command Does

1. Scans source files - Finds all exported functions, classes, hooks, components
2. Extracts docstrings - Gets descriptions from JSDoc/docstrings
3. Categorizes by capability - Groups by what things DO, not where they live
4. Generates CODE_INDEX.md - Creates/updates the semantic index

---

Phase 1: Detect Project Type

# Check language
ls package.json pyproject.toml 2>/dev/null

# Check source directories
ls -d src/ lib/ app/ 2>/dev/null

---

Phase 2: Scan Codebase

For TypeScript/JavaScript

Scan for exports:

# Find all exported functions
grep -rn "export function\|export const\|export class\|export default" src/ --include="*.ts" --include="*.tsx" --include="*.js" --include="*.jsx"

# Find React hooks
grep -rn "export function use[A-Z]\|export const use[A-Z]" src/ --include="*.ts" --include="*.tsx"

# Find React components (PascalCase exports)
grep -rn "export function [A-Z]\|export const [A-Z].*=.*=>" src/ --include="*.tsx" --include="*.jsx"

For Python

# Find all function definitions
grep -rn "^def \|^async def \|^class " src/ --include="*.py"

# Check __all__ exports
grep -rn "__all__" src/ --include="*.py"

---

Phase 3: Extract Documentation

For each found export, extract:

1. Name - Function/class name
2. Location - File path and line number
3. Description - From JSDoc @description or first line of docstring
4. Parameters - Function signature
5. Returns - Return type if available

TypeScript Example

/**
 * Formats a date into a human-readable relative string.
 * @param date - The date to format
 * @returns Relative time string like "2 days ago"
 */
export function formatRelative(date: Date): string {

Extract:

• Name: formatRelative
• Description: "Formats a date into a human-readable relative string"
• Params: (date: Date)
• Returns: string