fix(update): keep re-checking a KEPT (frozen) capability on every run (PHARN-13)

[PrzemekGalarowicz]

Problem

When update kept an unparseable ("frozen") capability, it still bumped skillsVersion. The next run at the same version then hit "Already up to date" without fetching, which broke the docs' promise in docs/commands/update.md:

• the KEPT report did not repeat;
• the capability's files stayed stale, even after upgrading pharn.

Fix

• New optional frozenCapabilities field in the config (existing configs still load). It holds the sorted role:name of each installed capability that update kept unparsed, and is left out when there are none.
• While that field is non-empty, update skips the same-version early return, so every run fetches and re-checks.
• On load, a malformed value is dropped whole, so update returns early as before.
• The version bump is unchanged, so add stays unblocked.

Tests

11 new tests fail on the old code and pass now:

• 8 ingest cases that drop a malformed value;
• only KEPT capabilities are written;
• the second run fetches again and re-reports KEPT;
• once the capability parses, its files are refreshed and the field is cleared.

One more test checks that the early return still fires when no capability is frozen. The pipeline artifacts are in .dev/features/frozen-capability-recheck/.

Local gates, run as a non-root user on node 22: all green. 1384/1384 tests pass and statement coverage is 97.18%.

🤖 Generated with Claude Code

https://claude.ai/code/session_01TvcuVhk8hTeDskp5pAJhnc

---

Generated by Claude Code

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: 59385b74-4619-4704-be9d-5bc334610930

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}