zero-slop 2.7.0 → 2.7.1

package/README.md

@@ -5,7 +5,7 @@
   <img alt="tests" src="https://img.shields.io/badge/tests-passing-227B5B">
   <img alt="dependencies" src="https://img.shields.io/badge/runtime%20dependencies-0-227B5B">
   <img alt="privacy" src="https://img.shields.io/badge/learning-private-227B5B">
-  <img alt="version" src="https://img.shields.io/badge/version-2.7.0-72528F">
+  <img alt="version" src="https://img.shields.io/badge/version-2.7.1-72528F">
 </p>
 
 Score your writing 0 to 100 for AI slop, then edit it out without changing a single fact.

package/SKILL.md

@@ -2,7 +2,7 @@
 name: zero-slop
 license: MIT
 metadata:
-  version: "2.7.0"
+  version: "2.7.1"
   author: manavmishra
 description: Turn drafts into sharp, natural prose or inspect them without rewriting. Zero Slop runs inside the user's existing AI assistant; Claude, GPT, or another compatible model reads and edits in context while local tools point to exact phrases and protect the source. Use when the user asks to humanize or de-slop writing, inspect AI-sounding patterns, fix text that reads like ChatGPT, polish outward-facing prose, draft social or LinkedIn content, or apply a final quality check to prose the agent generated. The workflow preserves facts, voice, and format and learns privately from repeated, reason-labelled human edits.
 ---
@@ -449,6 +449,8 @@ the most reader value. `references/rewrite-moves.md` expands each rung.
   "decided". Kill participial openers ("Leveraging X, …"). Translate internal
   workflow labels into plain language; never let evaluator or harness language
   leak into reader-facing prose.
+  Strong claims the author owns are content, not register: cut an intensifier
+  only for a defect you can name in context, never for strength alone.
   Prefer an explicit actor and an active verb when responsibility matters. Keep
   passive voice when the actor is unknown, irrelevant, deliberately withheld, or
   native to the genre; passive voice alone is not evidence of AI writing.
@@ -595,6 +597,13 @@ format, and non-prose structure. Apply these contextual checks too:
   `_coverage` map by dispositioning every paragraph; the verdict fails on any
   paragraph nobody dispositioned, exactly as it fails on an unanswered check.
   A non-zero exit is a failed check.
+- **The delta.** Run
+  `python3 <skill-root>/scripts/register.py --delta <original> <final>` and
+  answer for what it prints: every inserted run must restate source meaning,
+  every cut emphasis word needs a named defect, and every rewritten span passes
+  the three direction tests — purpose has not become outcome, agency has not
+  moved, a warned future has not become an asserted present. The fact gate
+  cannot see any of these; this is where a reframed claim gets caught.
 - **Performed register.** Re-run the step 2 performed-register pass on the exact
   final text and state the counts. An exceeded antithesis budget, or a surviving
   significance-scaffolding sentence, is a failed check: the text returns through

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zero-slop",
-  "version": "2.7.0",
+  "version": "2.7.1",
   "description": "An Agent Skill that scores AI-sounding prose 0-100 locally and rewrites it without losing a fact. Runs inside Claude Code, Codex, Cursor, Warp, Zed and other SKILL.md agents. Offline, zero dependencies, MIT.",
   "keywords": [
     "agent-skill",

package/references/eval.md

@@ -187,7 +187,13 @@ the report even when they are zero.
 51. **Qualifiers survive.** Hedges, scope limits, and caveats carry the same strength
     as the source.
 52. **Claims not reframed.** Same names and numbers can still carry a changed
-    emphasis or implication. Compare meaning, not tokens.
+    emphasis or implication. Compare meaning, not tokens, and run three direction
+    tests on every span `register.py --delta` reports as inserted or rewritten:
+    purpose has not become outcome ("changed tactics to achieve its objective" is
+    not "changed tactics until it reached its objective"); agency has not moved
+    ("helps teams generate fixes" is not "generates fixes"); a warned future has
+    not become an asserted present. These are contextual comparisons against this
+    source, never a word list.
 53. **Non-prose untouched.** Code, front matter, tables, blockquotes, identifiers,
     paths, and heading hierarchy intact.
 
@@ -207,44 +213,55 @@ the report even when they are zero.
 59. **Proportional cutting.** No compression that stripped character. Density is
     information per word, not fewer words.
 60. **Read aloud.** Would this sound natural read to a sharp colleague?
-61. **No over-correction.** AI slop was not traded for edgy slop: forced hot takes,
+61. **Emphasis survives.** `register.py --delta` lists every intensifier or
+    absolute the rewrite cut from this source. Each cut needs a defect named from
+    this file, judged in its own context: puffery, hyperbole universal, filler.
+    "Too strong" is not a defect, and a falsifiable claim the author owns keeps
+    its full strength whatever word carries it. Cutting "changed overnight" from
+    a claim the author would defend cost a blind head-to-head once.
+62. **Earned length.** `--delta` lists every run of three or more words the rewrite
+    added. Each must restate meaning already in this source for this audience; a
+    bridge or an unpacked definition can qualify, scaffolding the author never
+    wrote cannot. A rewrite longer than its original defends every insertion or
+    loses them.
+63. **No over-correction.** AI slop was not traded for edgy slop: forced hot takes,
     fake first person, performed candor, staccato drama.
 
 ## E. Form
 
-62. **Returned in the format it arrived in.** A .docx comes back a .docx.
-63. **Reader language.** No evaluator or harness vocabulary leaked into the copy:
+64. **Returned in the format it arrived in.** A .docx comes back a .docx.
+65. **Reader language.** No evaluator or harness vocabulary leaked into the copy:
     candidate, artifact, overlay, gate, scorecard, burstiness.
-64. **Formatting slop.** No emoji headings, decorative bold, or bullets that should be
+66. **Formatting slop.** No emoji headings, decorative bold, or bullets that should be
     prose. Count the headings over one or two sentences: four consecutive H3s each
     wrapping a code block and one line is a section that wants to be one section.
-65. **Em dashes.** None in short copy. One or two in a long draft only where they
+67. **Em dashes.** None in short copy. One or two in a long draft only where they
     clearly beat a comma, period, or parenthesis.
-66. **Hyphenated modifier stacking.** "AI-powered cloud-native data-driven platform".
+68. **Hyphenated modifier stacking.** "AI-powered cloud-native data-driven platform".
    Two stacked compound modifiers in one noun phrase is a tell; keep the hyphens
    grammar requires and cut the rest.
-67. **List-label periods and bare-noun bullets.** Bullets that are fragments ending in
+69. **List-label periods and bare-noun bullets.** Bullets that are fragments ending in
    full stops, or a list of bare noun phrases with no predicate. Either make them
    sentences or make them a real list.
-68. **Numbered-list inflation.** A numbered list where order carries no meaning, or a
+70. **Numbered-list inflation.** A numbered list where order carries no meaning, or a
    list padded to a round number. Use a bulleted list, or prose.
-69. **Chatbot artifacts.** Citation markup leaks, "Regenerate response", tool URL
+71. **Chatbot artifacts.** Citation markup leaks, "Regenerate response", tool URL
    parameters such as utm_source, and any assistant scaffolding left in the copy.
-70. **Attribution accurate.** The report names who did what without guessing which
+72. **Attribution accurate.** The report names who did what without guessing which
     model is running, and never implies a Zero Slop service read the draft.
 
 ## F. Process integrity
 
 Role 8 answers this section. It is the check no single-agent eval can make.
 
-71. **Roles stayed separate.** The copy desk, read-aloud pass, verification, and
+73. **Roles stayed separate.** The copy desk, read-aloud pass, verification, and
     fresh-eyes review each ran as a distinct pass.
-72. **No self-certification.** No role graded text it generated.
-73. **Counts reported.** Every count in section A appears in the summary, including
+74. **No self-certification.** No role graded text it generated.
+75. **Counts reported.** Every count in section A appears in the summary, including
     the zeros.
-74. **The exact final text cleared every check.** Not an earlier draft, not a version
+76. **The exact final text cleared every check.** Not an earlier draft, not a version
     that was repaired afterward.
-75. **Role 8 approved without changes.** If it changed anything, roles 5 through 8
+77. **Role 8 approved without changes.** If it changed anything, roles 5 through 8
     ran again on the revision.
-76. **Fallbacks named honestly.** If the three-round limit was reached, the report
+78. **Fallbacks named honestly.** If the three-round limit was reached, the report
     says which check failed and does not describe the result as fully verified.

package/scripts/register.py

@@ -611,6 +611,68 @@ def verdict(text: str, answers: dict) -> tuple[int, str]:
     return 0, "\n".join(out)
 
 
+# Emphasis words: cutting one is sometimes right (puffery) and sometimes voice
+# flattening ("changed overnight" is a falsifiable claim the author owns). The
+# tool cannot tell which, so it reports every cut and the eval demands a defect
+# name for each. "Too strong" is not a defect.
+EMPHASIS = {
+    "overnight", "never", "always", "every", "entire", "all", "nothing",
+    "worst", "best", "first", "only", "immediately", "instantly", "forever",
+    "massive", "enormous", "catastrophically", "obsessively", "extraordinary",
+    "unprecedented", "remarkable", "completely", "exactly",
+}
+
+
+def delta(original: str, rewrite: str) -> dict:
+    """Word-level diff: what the rewrite added that the author never wrote, and
+    what emphasis it took away. Insertions are never free; each run must carry
+    meaning already in the source. A rewrite 27 words longer than the original
+    once lost a blind head-to-head on exactly this."""
+    import difflib
+    a = original.split()
+    b = rewrite.split()
+    sm = difflib.SequenceMatcher(a=[w.lower().strip(".,;:!?\"'()") for w in a],
+                                 b=[w.lower().strip(".,;:!?\"'()") for w in b])
+    inserted, deleted, cut_emphasis = [], [], []
+    for op, i1, i2, j1, j2 in sm.get_opcodes():
+        if op in ("insert", "replace") and j2 - j1 >= 3:
+            inserted.append(" ".join(b[j1:j2])[:90])
+        if op in ("delete", "replace"):
+            for w in a[i1:i2]:
+                if w.lower().strip(".,;:!?\"'()") in EMPHASIS:
+                    ctx = " ".join(a[max(0, i1 - 4):min(len(a), i2 + 4)])
+                    cut_emphasis.append(f"{w}  ({ctx[:70]})")
+            if op == "delete" and i2 - i1 >= 3:
+                deleted.append(" ".join(a[i1:i2])[:90])
+    return {
+        "original_words": len(a), "rewrite_words": len(b),
+        "net": len(b) - len(a),
+        "inserted_runs": inserted[:12], "deleted_runs": deleted[:12],
+        "cut_emphasis": cut_emphasis[:12],
+    }
+
+
+def render_delta(d: dict) -> str:
+    out = [f"Length: {d['original_words']} -> {d['rewrite_words']} words "
+           f"({'+' if d['net'] >= 0 else ''}{d['net']})"]
+    if d["net"] > 0:
+        out.append("  The rewrite is LONGER than the original. Every inserted run below")
+        out.append("  must carry meaning already in the source, or it goes.")
+    out.append("")
+    out.append(f"  Inserted runs the author never wrote ({len(d['inserted_runs'])}):")
+    for r in d["inserted_runs"] or ["(none)"]:
+        out.append(f"    + {r}")
+    out.append(f"  Cut emphasis, each needs a defect name, not 'too strong' ({len(d['cut_emphasis'])}):")
+    for r in d["cut_emphasis"] or ["(none)"]:
+        out.append(f"    - {r}")
+    if d["deleted_runs"]:
+        out.append(f"  Deleted runs ({len(d['deleted_runs'])}):")
+        for r in d["deleted_runs"]:
+            out.append(f"    - {r}")
+    return "\n".join(out)
+
+
+
 MUST_FLAG = EVAL_PATH.resolve().parent.parent / "data" / "corpus" / "must-flag"
 
 
@@ -736,6 +798,8 @@ def main() -> int:
     ap.add_argument("--gate", action="store_true", help="exit 1 when any rate is over budget")
     ap.add_argument("--calibrate", metavar="DIR", help="recompute budgets from a human corpus")
     ap.add_argument("--selftest", action="store_true", help="check the gate against the checklist")
+    ap.add_argument("--delta", nargs=2, metavar=("ORIGINAL", "REWRITE"),
+                    help="what the rewrite inserted, and what emphasis it cut")
     ap.add_argument("--recall", action="store_true", help="verify every recorded miss in data/corpus/must-flag still gets caught")
     ap.add_argument("--read", action="store_true", help="emit the reading brief for the host model")
     ap.add_argument("--verdict", metavar="ANSWERS_JSON", help="gate on the measured rates plus the model's answers")
@@ -745,6 +809,11 @@ def main() -> int:
         return _selftest()
     if args.recall:
         return recall()
+    if args.delta:
+        a = pathlib.Path(args.delta[0]).read_text(encoding="utf-8", errors="ignore")
+        b = pathlib.Path(args.delta[1]).read_text(encoding="utf-8", errors="ignore")
+        print(render_delta(delta(a, b)))
+        return 0
     if args.calibrate:
         calibrate(args.calibrate)
         return 0