v0.4.0 — Refresh Mode, Custom Skills, & Module Split

[mvoutov]

aspens v0.4.0 is out — release notes | npm

Highlights

doc sync --refresh

Review and update all skills against your current codebase — no git diff needed. Run it periodically to catch drift, or after big refactors:

aspens doc sync --refresh

add skill

Create custom skills for team conventions, workflows, or processes:

aspens add skill ui-conventions          # scaffold a blank skill
aspens add skill release --from dev/release.md  # generate from a reference doc

Interactive file picker

Large diffs (>80k chars) now show a file picker so you control what Claude analyzes. Skill-relevant files are pre-selected.

Under the hood

• doc-sync.js split from 813 → 540 lines into focused modules
• All git commands hardened with execFileSync (no shell interpolation)
• 35 new tests (162 → 197)
• skill-rules.json now regenerated on every sync write

Upgrade

npm install -g aspens@latest
aspens doc init --hooks-only   # update hooks

Existing skills are fully compatible — no migration needed.

Full changelog: CHANGELOG.md