Skip to content

Releases: Aloim/charon

Release list

Charon v1.1

Charon v1.1 Latest
Latest

Choose a tag to compare

View all tags
@Aloim Aloim released this 10 Jul 10:13
v1.1
8416797

Charon v1.1 adds gated resolution on top of the v1.0 advisory audit, restyled in the Phanes v2.1 document format. The audit stays strictly read-only; what is new is that Charon can now remove confirmed dead code itself, but only in the mode you choose, only past an independent Critic review, and only on a cleanup branch you merge yourself.

Deliberate contract change: v1.0 was advisory-only and never deleted anything. v1.1 replaces that with mode-gated resolution. The old non-goal "auto-fix will not be built" becomes "no ungated fix will ever be built."

  • Two loops: a read-only Audit Loop (identical in every mode and world) and a Resolution Loop that consumes the report as its only input.
  • Mode contract, asked once: AUTORESOLVE (execute clean removal candidates, each change-set still Critic-reviewed) or APPROVE-FIRST (report, then execute only your CH-id selection).
  • Universal Critic gate: Phanes projects route removals through their own Critic and Executor workflows; standalone runs spawn an adversarial reviewer subagent tasked with proving the code is alive.
  • Hard rails in every mode: judgment-required findings are never executed, clone merges are never auto-resolved, all writes land on a charon-cleanup-<date> branch Charon never merges, and any build or test failure triggers revert-and-reclassify.
  • JSON companion output next to the markdown report, with stable identity keys for CI and agent consumers.
  • Trend tracking against the previous audit: NEW / LINGERING / FIXED per finding, matched on identity rather than per-run ids.
  • Deeper Phanes integration: registry drift flags, Documentation Debt routing, api-monitor tier-1 regen after removals, and tier-2 annotation proposals for the architect.

Install:

mkdir -p ~/.claude/commands
curl -L https://raw.githubusercontent.com/Aloim/charon/main/Charon.md -o ~/.claude/commands/charon.md

Then run /charon in your project. See the README for Windows commands and report interpretation.

Assets 3
Loading

Charon v1.0

Charon v1.0

Choose a tag to compare

View all tags
@Aloim Aloim released this 10 Jul 01:32
v1.0
620e939

First release of Charon, a single-file audit prompt for Claude Code that finds dead code, unused files, unused dependencies, and duplicated code, then writes an evidence-backed report instead of touching anything.

  • Advisory only: no deletions, no edits, ever. Findings carry file:line, the detecting tool, verbatim evidence, and last-touched dates.
  • Mandatory false-positive triage: reflection/dynamic dispatch, DI wiring, framework entry points, public APIs, fixtures, and plugin registries are flagged for judgment, never auto-confirmed.
  • Dated tool table (knip, vulture, staticcheck/deadcode, cargo-machete, Roslyn analyzers, jscpd), re-verified on every run.
  • Cooperates with Phanes-managed projects: report filed into the documentation tree, session-summary TODOs, registry annotation proposals for the architect.

Install:

mkdir -p ~/.claude/commands
curl -L https://raw.githubusercontent.com/Aloim/charon/main/Charon.md -o ~/.claude/commands/charon.md

Then run /charon in your project. See the README for Windows commands and report interpretation.

Loading