v0.3.0 — Import Graph + Windows Support

[mvoutov]

aspens v0.3.0 is out on npm.

npm update -g aspens

What's new

Import graph persistence

aspens now builds a structural map of your codebase that persists across sessions. Three artifacts land in .claude/:

• graph.json — full import graph (hubs, clusters, edges, hotspots)
• graph-index.json — tiny lookup index for fast prompt matching
• code-map.md — codebase overview injected into every Claude prompt

Run aspens doc graph . to build it. aspens doc sync rebuilds it automatically on every commit.

Graph context hook

Install the hook to get smart per-prompt context injection — Claude sees which files are hubs, what depends on what, and which cluster a file belongs to, automatically:

aspens add hook graph-context-prompt
aspens doc graph .

--domains flag for targeted retries

Retry specific failed domains without touching the base skill or CLAUDE.md:

aspens doc init --mode chunked --domains "auth,payments" /path/to/repo

Fixed

• Windows users: spawn claude ENOENT is fixed — aspens now correctly finds claude.cmd on Windows (Bug: spawn claude ENOENT on Windows #25, thanks @ckwich)
• --mode base-only now correctly generates the base skill (regression introduced in 0.2.x)
• Graph hook works on macOS without GNU coreutils
• Silent graph failures in doc sync now surface as warnings
• Several null-safety fixes in graph context building

Upgrade steps

No breaking changes. After updating:

aspens doc sync   # rebuilds graph + refreshes skills

Full release notes: https://github.com/aspenkit/aspens/releases/tag/v0.3.0