getprismo 0.1.30 → 0.1.31

package/README.md

@@ -719,7 +719,7 @@ no install needed. npx runs it directly.
 | `receipt` | run receipt for reads, repeats, output, artifacts, likely influence, and next-run scope |
 | `replay` | incident replay with root cause and recovery prompt |
 | `timeline` | recurring context-waste patterns across recent sessions |
-| `instructions audit` | instruction ROI audit for CLAUDE.md / AGENTS.md dead-weight rules |
+| `instructions audit` | instruction ROI audit for CLAUDE.md / AGENTS.md violations, partial compliance, duplicates, and influence-unknown rules |
 | `boundaries` | multi-agent boundary check for shared files/artifacts and worktree overlap |
 | `scan --usage` | full repo scan with local usage data |
 | `scan --optimizer-fit` | recommend which token-optimization path fits your repo/session |

package/lib/prismo-dev/instructions.js

@@ -83,9 +83,11 @@ module.exports = function createInstructionsAudit(deps) {
     let generatedArtifactMentions = 0;
     let repeatedReadMentions = 0;
     let repeatedCommandMentions = 0;
+    let failureMentions = 0;
     let loopSessions = 0;
     for (const session of sessions) {
       toolOutputTokens += Number(session.estimatedToolTokens || 0);
+      failureMentions += Number(session.failureMentions || 0);
       if (session.loopSuspicion) loopSessions += 1;
       for (const item of session.repeatedPathMentions || []) {
         evidenceText.push(item.value);
@@ -107,10 +109,55 @@ module.exports = function createInstructionsAudit(deps) {
       generatedArtifactMentions,
       repeatedReadMentions,
       repeatedCommandMentions,
+      failureMentions,
       loopSessions,
     };
   }
 
+  function normalizeEvidenceTerm(value) {
+    return normalizeRule(String(value || "").replace(/['"`]/g, ""));
+  }
+
+  function extractRuleTerms(ruleText) {
+    const source = String(ruleText || "");
+    const terms = [];
+    const pathPattern = /(?:[\w.@-]+\/)+[\w.@+-]+\.[A-Za-z0-9]{1,12}|[\w.@+-]+\.[A-Za-z0-9]{1,12}/g;
+    for (const match of source.matchAll(pathPattern)) terms.push(match[0]);
+
+    const beforeEditMatch = source.match(/\b(?:edit|editing|change|changing|modify|modifying|touch|touching)\s+([A-Za-z0-9_./@-]+(?:\s+[A-Za-z0-9_./@-]+){0,2})/i);
+    if (beforeEditMatch) terms.push(beforeEditMatch[1]);
+
+    return Array.from(new Set(terms.map(normalizeEvidenceTerm).filter((term) => term.length >= 3)));
+  }
+
+  function getRitualComplianceSignal(rule, evidence) {
+    const text = rule.normalized;
+    const asksReadBeforeEdit =
+      /\b(?:always|must|first|before|prior to)\b/.test(text) &&
+      /\b(?:read|review|check|inspect|open)\b/.test(text) &&
+      /\b(?:before|prior to)\b/.test(text) &&
+      /\b(?:edit|editing|change|changing|modify|modifying|touch|touching)\b/.test(text);
+    if (!asksReadBeforeEdit) return null;
+
+    const terms = extractRuleTerms(rule.text);
+    if (terms.length < 2) return null;
+
+    const matchedTerms = terms.filter((term) => evidence.text.includes(term));
+    const enoughRitualEvidence = matchedTerms.length >= 2;
+    const outcomeStillNoisy =
+      evidence.failureMentions > 0 ||
+      evidence.repeatedCommandMentions >= 3 ||
+      evidence.toolOutputTokens >= 25000 ||
+      evidence.loopSessions > 0;
+
+    if (!enoughRitualEvidence || !outcomeStillNoisy) return null;
+    return {
+      terms,
+      matchedTerms,
+      reason: "read-before-edit ritual appeared in session evidence, but noisy/failing session evidence suggests it may not have constrained the final work",
+    };
+  }
+
   function classifyRule(rule, evidence, duplicateCount) {
     const text = rule.normalized;
     const evidenceHits = rule.keywords.filter((keyword) => evidence.text.includes(keyword));
@@ -132,15 +179,24 @@ module.exports = function createInstructionsAudit(deps) {
 
     if (evidenceHits.length) signals.push("session-correlated");
     if (asksNoArtifacts || asksNoOutputFlood || asksNarrowReads) signals.push("guardrail");
+    const ritualCompliance = getRitualComplianceSignal(rule, evidence);
+    if (ritualCompliance) {
+      concerns.push("paraphrased-not-applied");
+      signals.push("ritual-compliance");
+    }
 
     let status = "unclear";
     let recommendation = "Keep for now, but review after more sessions.";
     let score = 35;
 
     if (concerns.includes("violated-by-session-evidence")) {
-      status = "ignored-or-ineffective";
+      status = "observably-violated";
       score = 15;
-      recommendation = `Move this rule into a live guardrail/firewall or make it more specific; session evidence suggests it is not changing behavior.`;
+      recommendation = `Keep the intent, but move it into a live guardrail/firewall or make it more enforceable; session evidence shows a measurable violation.`;
+    } else if (concerns.includes("paraphrased-not-applied")) {
+      status = "partial-compliance";
+      score = 40;
+      recommendation = "Rewrite this as an observable acceptance check; the session appears to perform the read/check ritual but still shows failure or noisy follow-through.";
     } else if (signals.includes("session-correlated") && signals.includes("directive")) {
       status = "pulling-weight";
       score = 80;
@@ -154,9 +210,9 @@ module.exports = function createInstructionsAudit(deps) {
       score = 25;
       recommendation = "Deduplicate this rule so it is paid for once, not in every instruction file.";
     } else if (concerns.includes("low-signal")) {
-      status = "dead-weight-candidate";
-      score = 20;
-      recommendation = "Rewrite with observable behavior or remove if it is generic preference text.";
+      status = "influence-unknown";
+      score = 45;
+      recommendation = "Do not prune automatically. This rule has no grep-able behavioral signal; use A/B ablation or rewrite it into observable instructions.";
     } else if (rule.tokens > 80) {
       status = "trim-candidate";
       score = 30;
@@ -170,6 +226,7 @@ module.exports = function createInstructionsAudit(deps) {
       signals,
       concerns,
       evidenceHits,
+      partialCompliance: ritualCompliance || null,
       recommendation,
     };
   }
@@ -189,10 +246,13 @@ module.exports = function createInstructionsAudit(deps) {
 
     const byStatus = {};
     for (const rule of auditedRules) byStatus[rule.status] = (byStatus[rule.status] || 0) + 1;
-    const deadWeight = auditedRules.filter((rule) => ["dead-weight-candidate", "ignored-or-ineffective", "duplicate", "trim-candidate"].includes(rule.status));
+    const prunable = auditedRules.filter((rule) => ["observably-violated", "duplicate", "trim-candidate"].includes(rule.status));
+    const partialCompliance = auditedRules.filter((rule) => rule.status === "partial-compliance");
+    const influenceUnknown = auditedRules.filter((rule) => rule.status === "influence-unknown");
     const pullingWeight = auditedRules.filter((rule) => rule.status === "pulling-weight" || rule.status === "guardrail-no-recent-violation");
     const duplicatedRules = auditedRules.filter((rule) => (duplicates.get(rule.normalized) || 0) > 1);
-    const wastedTokensPerLoad = deadWeight.reduce((sum, rule) => sum + Number(rule.tokens || 0), 0);
+    const prunableTokensPerLoad = prunable.reduce((sum, rule) => sum + Number(rule.tokens || 0), 0);
+    const sortedPrunable = prunable.sort((a, b) => a.score - b.score || b.tokens - a.tokens);
 
     return {
       schemaVersion: 1,
@@ -208,20 +268,30 @@ module.exports = function createInstructionsAudit(deps) {
         generatedArtifactMentions: evidence.generatedArtifactMentions,
         repeatedReadMentions: evidence.repeatedReadMentions,
         repeatedCommandMentions: evidence.repeatedCommandMentions,
+        failureMentions: evidence.failureMentions,
         loopSessions: evidence.loopSessions,
       },
       summary: {
         totalRules: auditedRules.length,
         byStatus,
-        deadWeightCandidates: deadWeight.length,
+        prunableCandidates: prunable.length,
+        partialCompliance: partialCompliance.length,
+        influenceUnknown: influenceUnknown.length,
         duplicatedRules: duplicatedRules.length,
-        wastedTokensPerLoad,
+        prunableTokensPerLoad,
+        deadWeightCandidates: prunable.length,
+        wastedTokensPerLoad: prunableTokensPerLoad,
       },
       pullingWeight: pullingWeight.sort((a, b) => b.score - a.score).slice(0, 10),
-      deadWeight: deadWeight.sort((a, b) => a.score - b.score || b.tokens - a.tokens).slice(0, 20),
+      prunable: sortedPrunable.slice(0, 20),
+      partialCompliance: partialCompliance.sort((a, b) => a.score - b.score || b.tokens - a.tokens).slice(0, 20),
+      influenceUnknown: influenceUnknown.sort((a, b) => b.tokens - a.tokens).slice(0, 20),
+      deadWeight: sortedPrunable.slice(0, 20),
       rules: auditedRules,
       next: [
-        deadWeight.length ? "Trim or rewrite dead-weight candidates first." : "No obvious dead-weight rules detected yet.",
+        prunable.length ? "Fix observably violated, duplicate, or trim-safe rules first." : "No safely prunable rules detected yet.",
+        partialCompliance.length ? "Rewrite partial-compliance rules as observable acceptance checks." : null,
+        influenceUnknown.length ? "Treat influence-unknown rules as A/B ablation candidates, not safe deletes." : null,
         duplicatedRules.length ? "Deduplicate repeated rules across CLAUDE.md / AGENTS.md / Codex instruction files." : null,
         evidence.sessions.length < 5 ? "Run this again after more sessions; multi-session evidence makes instruction ROI stronger." : null,
         `${NPX_COMMAND} firewall <task> for rules that only matter in one workflow.`,
@@ -242,7 +312,9 @@ module.exports = function createInstructionsAudit(deps) {
     lines.push(`Files: ${audit.files.map((file) => `${file.path} (${formatTokenCount(file.tokens)} tokens)`).join(", ")}`);
     lines.push(`Rules: ${audit.summary.totalRules}`);
     lines.push(`Sessions analyzed: ${audit.sessionsAnalyzed}`);
-    lines.push(`Dead-weight candidates: ${audit.summary.deadWeightCandidates} (~${formatTokenCount(audit.summary.wastedTokensPerLoad)} tokens/load)`);
+    lines.push(`Safely prunable candidates: ${audit.summary.prunableCandidates} (~${formatTokenCount(audit.summary.prunableTokensPerLoad)} tokens/load)`);
+    lines.push(`Partial compliance: ${audit.summary.partialCompliance}`);
+    lines.push(`Influence unknown: ${audit.summary.influenceUnknown}`);
     lines.push(`Duplicates: ${audit.summary.duplicatedRules}`);
     lines.push("");
     lines.push("Pulling Weight");
@@ -254,9 +326,9 @@ module.exports = function createInstructionsAudit(deps) {
       lines.push("- No high-confidence useful rules detected yet.");
     }
     lines.push("");
-    lines.push("Dead Weight / Rewrite Candidates");
-    if (audit.deadWeight.length) {
-      audit.deadWeight.slice(0, 8).forEach((rule) => {
+    lines.push("Safely Prunable / Rewrite Candidates");
+    if (audit.prunable.length) {
+      audit.prunable.slice(0, 8).forEach((rule) => {
         lines.push(`- ${rule.file}:${rule.line} [${rule.status}] ${rule.text}`);
         lines.push(`  ${rule.recommendation}`);
       });
@@ -264,6 +336,29 @@ module.exports = function createInstructionsAudit(deps) {
       lines.push("- No obvious candidates.");
     }
     lines.push("");
+    lines.push("Partial Compliance / Ritual Without Proof");
+    if (audit.partialCompliance.length) {
+      audit.partialCompliance.slice(0, 6).forEach((rule) => {
+        lines.push(`- ${rule.file}:${rule.line} [${rule.status}] ${rule.text}`);
+        if (rule.partialCompliance?.matchedTerms?.length) {
+          lines.push(`  Matched: ${rule.partialCompliance.matchedTerms.join(", ")}`);
+        }
+        lines.push(`  ${rule.recommendation}`);
+      });
+    } else {
+      lines.push("- None detected.");
+    }
+    lines.push("");
+    lines.push("Influence Unknown / A-B Candidates");
+    if (audit.influenceUnknown.length) {
+      audit.influenceUnknown.slice(0, 6).forEach((rule) => {
+        lines.push(`- ${rule.file}:${rule.line} [${rule.status}] ${rule.text}`);
+        lines.push(`  ${rule.recommendation}`);
+      });
+    } else {
+      lines.push("- None detected.");
+    }
+    lines.push("");
     lines.push("Next");
     audit.next.forEach((item, index) => lines.push(`${index + 1}. ${item}`));
     return lines.join("\n");

package/lib/prismo-dev/mcp.js

@@ -122,7 +122,7 @@ function createMcpTools(deps) {
       tool: { type: "string", enum: ["all", "codex", "claude", "cursor"], description: "Which local session logs to inspect." },
       limit: limitProperty,
     }),
-    makeTool("prismo_instructions_audit", "Audit persistent instruction files for useful rules, duplicates, and dead-weight candidates.", {
+    makeTool("prismo_instructions_audit", "Audit persistent instruction files for useful rules, observable violations, partial compliance, duplicates, and influence-unknown rules.", {
       path: pathProperty,
       limit: limitProperty,
     }),

package/lib/prismo-dev-scan.js

@@ -355,7 +355,7 @@ Commands:
   cc          Show Claude Code token cost, cache cost, and all-time totals.
   cursor      Show Cursor session data, AI authorship, and AI-generated file tracking.
   receipt     Generate a run receipt for reads, repeats, output, artifacts, and next-run scope.
-  instructions Audit CLAUDE.md / AGENTS.md rule ROI and dead-weight candidates.
+  instructions Audit CLAUDE.md / AGENTS.md rule ROI, violations, partial compliance, duplicates, and influence-unknown rules.
   timeline    Show recurring context-waste patterns across recent sessions.
   replay      Reconstruct why a session went sideways and print a recovery prompt.
   boundaries  Check whether parallel agents are isolated or overlapping.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "getprismo",
-  "version": "0.1.30",
+  "version": "0.1.31",
   "description": "Local AI coding workflow scanner for Codex, Claude Code, Cursor, and token-waste diagnostics.",
   "license": "MIT",
   "homepage": "https://github.com/shanirsh/prismodev#readme",