Incremental Update

Usage

iw index update [options]

Re-indexes only files whose content has changed since the last build. Typical update time: < 1 second.

Options

Option	Default	Description
-v	off	Show what changed

How It Works

CARI tracks a SHA-256 content hash for every indexed file. When you run iw index update, it:

1. Scans the workspace for files
2. Computes the current hash for each file
3. Compares against the stored hash in .iw/index.db
4. Re-indexes only files that changed

Unchanged files are completely skipped — no AST parsing, no keyword extraction, no git analysis.

Example

# After editing src/auth/service.ts:
iw index update -v

# Updated 1 file:
#   src/auth/service.ts (content changed)
# Skipped 263 files (unchanged)
# Time: 0.3s

When to Use Update vs Build

Scenario	Command
First time	iw index build
After editing a few files	iw index update
After changing depth mode	iw index build --depth full
After pulling lots of changes	iw index build
In CI (fresh checkout)	iw index build

Next Steps

• Build the Index — full build options
• CI Drift Check — pair with incremental updates