plumbline

Affirm the Plumbline rules in this project. Creates `.claude/rules/` if absent and writes/overwrites `.claude/rules/plumbline-cheatsheet.md` to match the plugin's canonical cheatsheet. Idempotent — a project already in compliance is a silent no-op.

Audit the current project against the Plumbline lint. Runs the lint across the whole codebase, groups violations by check category and by file, and surfaces a remediation plan distinguishing mechanical fixes from structural issues. Read-only — proposes fixes; does not apply them.

One-way violation ratchet for projects whose Plumbline backlog is too large to clear at once. Records a baseline violation count in .plumbline-budget.json; CI fails any change that increases the count, accepts any that holds or decreases it.

Emit a CI workflow that runs the Plumbline lint and budget check on every PR. Supports GitHub Actions, GitLab CI, and pre-commit. Prints the workflow to stdout; user reviews and saves.

Diagnose the Plumbline installation in the current project — config present and valid, cheatsheet committed, plugin enabled, budget baseline if used. Reports each check with a status indicator.

Show the canonical definition and examples for a Plumbline concept — a check code, the citations config, or the docstring opt-in marker.

Cluster Plumbline lint violations by shape so a hundred similar violations surface as one cluster with a proposed bulk fix. Read-only — proposes, does not apply.

Generate a complete Plumbline port plan for the current project. Writes a markdown guide enumerating violations by category and the passes needed to drive the lint to zero. Output is a file, ready to be consumed by a planner or executed directly.

Turn a prose description into a stable kebab-case slug suitable for citation identifiers (e.g. an ok-planner concept slug). Deterministic — same input always yields the same slug.

Generate a project-shaped .plumbline.json by scanning the repo for known patterns (Go module, Node package, ok-planner sibling, generated dirs). Output to stdout; user reviews and saves.

Walk Plumbline lint violations and propose a fix for each — delete the comment, convert its load-bearing content to code (assertion / test / type / name), or resolve a citation. Read-only — proposes, does not apply.

Print the installed plumbline plugin version.