v0.2.1 cARL has receipts 🧾

v0.2.1 — cARL has receipts 🧾

Until now, cARL CLI could install a runtime, map a repository, repair canonical artefacts, and project governance into multiple agent harnesses.

What it couldn't do was update its understanding when repository reality changed (but agents using the cARL principles could and would).

This release introduces carl reconcile.

What's New

carl reconcile

carl reconcile updates repository-specific durable knowledge using the current repository map.

The command reads:

• .github/carl/repo-map.json
• .github/carl/memory.md

and refreshes repository-specific memory while preserving human-authored content.

Reconcile updates:

• Languages
• Entry points
• Key directories
• Workflows
• Governance artefacts
• Documentation
• Repository snapshot metadata

while leaving:

• runtime.json
• Harness adapter files
• Canonical runtime artefacts

untouched.

Runtime Lifecycle Management

With the addition of reconcile, cARL CLI now supports a complete lifecycle for runtime knowledge:

carl init
    ↓
Install runtime

carl map
    ↓
Observe repository reality

carl reconcile
    ↓
Update durable memory

carl harness sync
    ↓
Project runtime into agent harnesses

carl doctor
carl status
    ↓
Operate and inspect

carl repair
    ↓
Restore canonical state

Safety Improvements

carl reconcile now validates generated-section markers before making any changes.

Malformed generated sections are detected and reported with actionable errors rather than risking duplicate or corrupted memory content.

Why This Matters

Repository maps are observations.

Durable artefacts are memory.

carl reconcile is the bridge between the two.

Repository Reality
        ↓
    carl map
        ↓
    repo-map.json
        ↓
  carl reconcile
        ↓
     memory.md

Or put another way:

cARL now has receipts.

What's Changed

• feat: add carl reconcile command by @goldjg with @Copilot in #14
• harden reconcile against malformed generated-section markers by @goldjg with @Copilot in #14

Full Changelog: v0.2.0...v0.2.1