zero-slop 2.7.6 → 2.7.7

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.6-72528F">
+  <img alt="version" src="https://img.shields.io/badge/version-2.7.7-72528F">
 </p>
 
 Take all the slop out of your AI writing. The #1 agentic anti-slop skill.
@@ -153,10 +153,10 @@ rates, and a method-hidden quality ranking.
 This is a small LLM-reviewed regression study. It measures neither field accuracy nor a
 universal ranking. Drafts, mappings, verdicts, hashes and limits:
 [`bench/incumbent-blind-replay/`](bench/incumbent-blind-replay/). On the 38-item
-editorial panel ([`bench/README.md`](bench/README.md)), v2.7.6 matched the prior 84.2% result
+editorial panel ([`bench/README.md`](bench/README.md)), v2.7.7 matched the prior 84.2% result
 with every frozen document score unchanged, all 18 human controls clear and all 18 search
 cases still caught: the release moves what the gate asks and leaves the meter
-untouched. Median throughput was 2.32% lower across 12 runs, which is local timing
+untouched. Median throughput was 3.51% lower across 12 runs, which is local timing
 noise and no kind of speed claim.
 
 ### Speed

package/SKILL.md

@@ -2,7 +2,7 @@
 name: zero-slop
 license: MIT
 metadata:
-  version: "2.7.6"
+  version: "2.7.7"
   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.
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zero-slop",
-  "version": "2.7.6",
+  "version": "2.7.7",
   "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.",
   "bin": {
     "zero-slop": "bin/zero-slop.mjs"

package/scripts/slopscore.py

@@ -45,6 +45,89 @@ class PatternData(dict):
     """JSON-compatible pattern mapping with an out-of-band compiled plan."""
 
 
+# One-time note asking for a GitHub star.
+#
+# 448 machines cloned this in a fortnight and seventeen people had starred it,
+# because nothing ever asked. The risk in fixing that is obvious: a tool whose
+# whole job is deleting manipulative filler cannot itself nag, so every rule
+# below is a restriction rather than a reach.
+#
+#   - Once per machine, ever. A marker in the state directory, not a counter
+#     that resets.
+#   - Not until the third run, so it asks people who kept using it rather than
+#     people evaluating it once.
+#   - Never when the output is being read by a machine: --json, --batch,
+#     --gate, or any run whose stdout is not a terminal. CI logs stay clean.
+#   - No prompt, no keypress, no opening a browser, no network call. One line
+#     to stderr, so it cannot corrupt piped output even if the checks above
+#     were somehow wrong.
+#   - ZERO_SLOP_NO_NOTES=1 turns it off for good.
+NOTES_FILE = HOME / "notes.json"
+STAR_NOTE_AFTER_RUNS = 3
+
+
+def _load_notes():
+    try:
+        with open(NOTES_FILE, encoding="utf-8") as fh:
+            data = json.load(fh)
+        return data if isinstance(data, dict) else {}
+    except (OSError, ValueError):
+        return {}
+
+
+def _save_notes(state):
+    try:
+        HOME.mkdir(parents=True, exist_ok=True)
+        tmp = NOTES_FILE.with_suffix(".json.tmp")
+        with open(tmp, "w", encoding="utf-8") as fh:
+            json.dump(state, fh)
+        os.replace(tmp, NOTES_FILE)
+    except OSError:
+        pass  # a read-only home must never break a score
+
+
+def star_note_is_due(argv=None, isatty=None, env=None):
+    """Decide without writing anything, so the rule is testable in isolation."""
+    argv = sys.argv[1:] if argv is None else argv
+    env = os.environ if env is None else env
+    if env.get("ZERO_SLOP_NO_NOTES"):
+        return False
+    if any(flag in argv for flag in ("--json", "--batch", "--gate")):
+        return False
+    if not (sys.stdout.isatty() if isatty is None else isatty):
+        return False
+    state = _load_notes()
+    if state.get("star_note_shown"):
+        return False
+    return int(state.get("human_runs", 0)) + 1 >= STAR_NOTE_AFTER_RUNS
+
+
+def record_human_run(argv=None, isatty=None, env=None):
+    """Count this run and, if it is the one, return the note to print."""
+    argv = sys.argv[1:] if argv is None else argv
+    env = os.environ if env is None else env
+    if env.get("ZERO_SLOP_NO_NOTES"):
+        return None
+    if any(flag in argv for flag in ("--json", "--batch", "--gate")):
+        return None
+    if not (sys.stdout.isatty() if isatty is None else isatty):
+        return None
+    state = _load_notes()
+    if state.get("star_note_shown"):
+        return None
+    state["human_runs"] = int(state.get("human_runs", 0)) + 1
+    due = state["human_runs"] >= STAR_NOTE_AFTER_RUNS
+    if due:
+        state["star_note_shown"] = True
+    _save_notes(state)
+    if not due:
+        return None
+    return ("\n  If Zero Slop has been useful, a star helps people find it: "
+            "https://github.com/manavmishra/ZeroSlop\n"
+            "  This is the only time you will see this. "
+            "ZERO_SLOP_NO_NOTES=1 silences all notes.")
+
+
 def _voice_path(name):
     """Resolve a profile name without letting it become a filesystem path."""
     if not VOICE_NAME.fullmatch(name or "") or name in (".", ".."):
@@ -159,6 +242,39 @@ def _apply_voice(base, name):
 SENT_SPLIT = re.compile(r"(?<=[.!?])[\")”’]?\s+(?=[A-Z“\"(0-9])")
 WORD = re.compile(r"[A-Za-z’']+")
 
+
+# A quoted span longer than this is a passage, not a named tell, and stays in
+# scope. Short enough to exempt "delve" or "it's not just X, it's Y"; short
+# enough that quoting cannot be used to smuggle paragraphs past the meter.
+QUOTE_SKIP_LIMIT = 200
+
+_BLOCKQUOTE_SCAN_RX = re.compile(r"(?m)^[ \t]*>[ \t]?.*$")
+_INLINE_QUOTE_RXS = (
+    re.compile(rf'"[^"\n]{{0,{QUOTE_SKIP_LIMIT}}}"'),
+    re.compile(rf"“[^”\n]{{0,{QUOTE_SKIP_LIMIT}}}”"),
+)
+
+
+def mask_quoted(text):
+    """Blank quoted material for the pattern meter, keeping every offset.
+
+    Naming a cliche in order to discuss it is the opposite of committing it,
+    and step 0 of SKILL.md has always said to skip quotes. Only the phrase
+    meter and the lexicon honour that: rhythm, readability, word variety and
+    formatting still read the quotation, because a quote a writer chose to
+    include is part of how the finished page reads.
+
+    Spans are replaced character for character, so sentence offsets, word
+    counts and hit positions are identical to the unmasked text.
+    """
+    def blank(match):
+        return re.sub(r"[^\n]", " ", match.group(0))
+
+    text = _BLOCKQUOTE_SCAN_RX.sub(blank, text)
+    for rx in _INLINE_QUOTE_RXS:
+        text = rx.sub(blank, text)
+    return text
+
 # Normalise only detector-evasion characters, never ordinary non-Latin prose.
 # A Cyrillic or Greek lookalike is mapped only when it appears in the same word
 # as an ASCII letter (for example, dеlvе). This keeps Russian and Greek text
@@ -418,6 +534,10 @@ def score_text(text, data, formal=False):
                         if n_words >= 200 else None)
     sent_spans = _sentence_spans(text)
     sents = [text[a:b].replace("\n", " ") for a, b in sent_spans]
+    # Same string with quotations blanked out, used only by the phrase meter
+    # and the lexicon. Offsets match `text` exactly.
+    scan_text = mask_quoted(text)
+    scan_sents = [scan_text[a:b].replace("\n", " ") for a, b in sent_spans]
     hits = []
     pattern_spans = []  # (start, end, lower-rx, compiled-rx) for dedup below
 
@@ -449,10 +569,10 @@ def score_text(text, data, formal=False):
             continue
         if hints:
             if lowercase_text is None:
-                lowercase_text = text.lower()
+                lowercase_text = scan_text.lower()
             if not any(hint in lowercase_text for hint in hints):
                 continue
-        for m in compiled.finditer(text):
+        for m in compiled.finditer(scan_text):
             hits.append({
                 "cat": category, "name": name, "w": weight,
                 "quote": m.group(0)[:90].strip(),
@@ -484,7 +604,7 @@ def score_text(text, data, formal=False):
                    and (term in rx_lower or compiled.search(matched))
                    for ps, pe, rx_lower, compiled in pattern_spans)
 
-    candidates = [candidate for candidate in _term_candidates(text, data["lexicon"])
+    candidates = [candidate for candidate in _term_candidates(scan_text, data["lexicon"])
                   if not _pattern_owns(candidate[:2], candidate[2], candidate[4])]
     last_end = 0
     for s, e, term, w, quote in candidates:
@@ -494,7 +614,7 @@ def score_text(text, data, formal=False):
         hits.append({"cat": "lexicon", "name": term, "w": w, "quote": quote})
     riders, triggers = data.get("riders", {}), data.get("rider_triggers", [])
     if riders:
-        for (a, _), sent in zip(sent_spans, sents):
+        for (a, _), sent in zip(sent_spans, scan_sents):
             sl = sent.lower()
             if not any(t in sl for t in triggers):
                 continue
@@ -1787,6 +1907,11 @@ def main():
               f"layout; your AI assistant still reviews the ideas, voice, and facts.")
         sys.exit(0 if ok else 1)
 
+    # Last line of a human run, and only ever once. See record_human_run.
+    note = record_human_run()
+    if note:
+        print(note, file=sys.stderr)
+
 
 if __name__ == "__main__":
     main()