rulereceipt 0.1.57 → 0.1.58

package/README.md

@@ -76,6 +76,7 @@ Published and live on npm, actively developed.
 ## Usage
 
 ```bash
+rulereceipt audit              # score your rules file for checkability — NO session needed
 rulereceipt check              # check the latest session in this project
 rulereceipt check --markdown   # same, formatted for pasting into a PR/Slack
 rulereceipt check --html       # write a shareable single-file HTML report you can send

package/dist/audit.d.ts

@@ -22,6 +22,11 @@ export interface RulesAudit {
     skipped: number;
     /** checkable / (checkable + judgment), whole %, 0 when there are no rules. */
     percentCheckable: number;
+    /** The highest-leverage rewrites — a concrete rule missing only its literal. */
+    topFixes: {
+        title: string;
+        suggestion: string;
+    }[];
 }
 export declare function auditRules(rules: Rule[]): RulesAudit;
 /** A short, readable audit. Never says "compliant" — it measures the file, not a session. */

package/dist/audit.js

@@ -1,4 +1,5 @@
 import { classifyRules } from "./checks/classify.js";
+import { adviseRules } from "./checkability.js";
 export function auditRules(rules) {
     let checkable = 0;
     let judgment = 0;
@@ -12,12 +13,17 @@ export function auditRules(rules) {
             checkable++;
     }
     const decided = checkable + judgment;
+    const topFixes = adviseRules(rules)
+        .filter((a) => a.actionable)
+        .slice(0, 5)
+        .map((a) => ({ title: a.ruleTitle, suggestion: a.suggestion }));
     return {
         total: checkable + judgment + skipped,
         checkable,
         judgment,
         skipped,
         percentCheckable: decided > 0 ? Math.round((checkable / decided) * 100) : 0,
+        topFixes,
     };
 }
 /** A short, readable audit. Never says "compliant" — it measures the file, not a session. */
@@ -39,6 +45,15 @@ export function renderAudit(a, md = false) {
     out.push(`  ${String(a.skipped).padStart(4)}  documentation    — structure/notes, not scored as rules`);
     out.push("");
     out.push(`${a.percentCheckable}% of your rules can be checked mechanically.`);
-    out.push("See which can't, and the smallest edit that would fix each:  rulereceipt rules --advise");
+    out.push("");
+    if (a.topFixes.length > 0) {
+        out.push(H("Top fixes to unlock more checks"));
+        for (const f of a.topFixes) {
+            out.push(`  • ${f.title.replace(/\s+/g, " ").trim().slice(0, 60)}`);
+            out.push(`      ${f.suggestion}`);
+        }
+        out.push("");
+    }
+    out.push("Full advice, rule by rule:  rulereceipt rules --advise");
     return out.join("\n");
 }

package/dist/checkability.d.ts

@@ -22,6 +22,14 @@ export interface RuleAdvice {
     kind: "judgment" | "notARule";
     /** One line: what is missing and the smallest edit that fixes it. */
     suggestion: string;
+    /**
+     * True when there is a concrete, high-leverage rewrite (name the command/
+     * file/branch in backticks) that would turn this into a real check — as
+     * opposed to a genuine judgment call or plain documentation, where the
+     * honest answer is "no edit makes it mechanical." `audit` surfaces the
+     * actionable ones as the top fixes.
+     */
+    actionable?: boolean;
 }
 /**
  * Advice for one rule, or null when the rule is already mechanically checked.

package/dist/checkability.js

@@ -53,6 +53,7 @@ export function adviseRule(rule) {
         return {
             ruleTitle: rule.title,
             kind,
+            actionable: true, // a concrete, high-leverage rewrite: just add the literal
             suggestion: `mentions ${subject} but names no exact term to match. Put the concrete command, file or branch in backticks (e.g. ${exampleFor(subject)}) and it becomes a mechanical check.`,
         };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rulereceipt",
-  "version": "0.1.57",
+  "version": "0.1.58",
   "description": "Checks whether your AI coding agent followed your rules, with evidence. Works with Claude Code (Codex in testing); reads CLAUDE.md, AGENTS.md, Cursor, Copilot and Windsurf rules.",
   "repository": {
     "type": "git",