turbo-index

Turbo Index

You are running the turbo-index skill to set up optimized search for this project.

Instructions

Follow these phases in order. Use the Bash tool to run commands. Report progress to the user after each phase.

Phase 1: Check Dependencies

Run the dependency checker:

uv run python -c "
import simba.search.deps
missing = simba.search.deps.check_deps()
if missing:
    print('Missing dependencies:')
    for name, info in missing.items():
        print(f'  {name}: {info}')
else:
    print('All dependencies satisfied.')
"

If dependencies are missing, ask the user if they want to install them. If yes, run:

uv run python -c "import simba.search.deps; simba.search.deps.install_deps()"

Phase 2: Initialize Project Memory

Initialize the SQLite memory database for this project:

uv run python -m simba.search init

Phase 3: Run Cartographer (if needed)

Check if codebase map exists and its age:

if [ -f docs/CODEBASE_MAP.md ]; then
  # Check if older than 24 hours (86400 seconds)
  AGE=$(($(date +%s) - $(stat -f %m docs/CODEBASE_MAP.md 2>/dev/null || stat -c %Y docs/CODEBASE_MAP.md 2>/dev/null)))
  if [ $AGE -gt 86400 ]; then
    echo "CODEBASE_MAP_STALE"
  else
    echo "CODEBASE_MAP_FRESH"
  fi
else
  echo "CODEBASE_MAP_MISSING"
fi

If missing or stale, use the Skill tool to invoke cartographer:

Skill: cartographer

Phase 4: Index with QMD

Get the project name and create/update the QMD collection:

PROJECT_NAME=$(basename "$PWD")
echo "Indexing project: $PROJECT_NAME"

# Add the project directory as a QMD collection
# Using correct QMD syntax: qmd collection add [path] --name <name> --mask <pattern>
qmd collection add . --name "$PROJECT_NAME" --mask "**/*.md"

# Add context for the collection
qmd context add . "Codebase documentation and structure for $PROJECT_NAME"

# Create vector embeddings for semantic search
echo "Creating vector embeddings (this may take a moment on first run)..."
qmd embed