mercury-agent 0.18.2 → 0.20.0

package/examples/extensions/napkin/pi-spawn.ts

@@ -22,7 +22,7 @@
  *    pi happens to be on PATH.
  */
 
-import { delimiter, join } from "node:path";
+import { posix, win32 } from "node:path";
 import type { ModelLeg } from "mercury-agent/core/model-leg";
 
 // Rule 2's resolver is shared with every other host-side spawn (longview's
@@ -152,6 +152,10 @@ export function composePiSearchPath(opts: {
   appData?: string;
 }): string {
   const { base, piNodeModulesBin, home, isWindows } = opts;
+  // isWindows selects the whole path module, not just the literal directory
+  // and the dedupe case-folding below — join and delimiter must agree with
+  // it, or the composed PATH mixes separators from the wrong platform.
+  const { join, delimiter } = isWindows ? win32 : posix;
   const globalBins = [
     join(home, ".bun", "bin"),
     isWindows

package/examples/extensions/overview/index.ts

@@ -35,6 +35,14 @@ const SKILL_SOURCE = join(EXT_DIR, "skill", "SKILL.md");
 const managementSpaceId = (): string | undefined =>
   process.env[MANAGEMENT_SPACE_ENV];
 
+const MANAGEMENT_SPACE_PROMPT =
+  "This is the deployment's management space. Other spaces ARE readable from here " +
+  "through the `overview` skill (`mrctl capability overview <action>`): a request about " +
+  "another space — its recent messages, where something was said, who is admin, what runs " +
+  "tonight — is answered by reading that skill and running its action, never by saying the " +
+  'space is not visible from here. Exception to the "never show ids" rule: a space `id` is ' +
+  "the handle every overview action takes — show it beside the name.";
+
 /**
  * Install the skill into the management space's own workspace.
  *
@@ -97,6 +105,18 @@ export default function (mercury: MercuryExtensionAPI) {
     return undefined;
   });
 
+  // Fact, not prose in AGENTS.md: only this extension knows which space is
+  // the management space, so the fragment lives here (layer 3a) and is
+  // scoped to that one space by the same check `workspace_init` uses above.
+  // Without it, the description alone loses the coin flip against the
+  // model's "mrctl is space-scoped" prior on a non-English, unprompted ask.
+  mercury.on("before_container", async (event) => {
+    const configured = managementSpaceId()?.trim() ?? "";
+    return configured !== "" && event.spaceId === configured
+      ? { systemPrompt: MANAGEMENT_SPACE_PROMPT }
+      : undefined;
+  });
+
   mercury.capability(
     "overview",
     async (req: CapabilityRequest, ctx: MercuryExtensionContext) => {

package/examples/extensions/overview/skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: overview
-description: Read other spaces from this management space — list spaces, pull recent messages, search across all spaces, inspect scheduled tasks and role assignments. Use when asked what is happening in another space, where something was discussed, who is admin where, or what runs tonight.
+description: Read other spaces from this management space — list spaces, pull recent messages, search across all spaces, inspect scheduled tasks and role assignments. Use when asked, in any wording, what is happening in another space, what was said or sent there recently, where something was discussed, who is admin where, or what runs tonight — e.g. "show me the recent messages from X", "מה קורה בספייס X", "מה נשלח ב-X לאחרונה", "תראה לי את ההודעות האחרונות מ-X", "איפה דיברו על …", "מי אדמין ב-X". Not for this space's own history (that is mrctl recall).
 ---
 
 # Cross-space overview
@@ -17,6 +17,14 @@ The capability may be inert — it answers `403` when this deployment has not
 designated a management space, or when the caller is not a global admin. That is
 configuration, not a bug: report the error and stop.
 
+## Before answering
+
+A question that names another space is answered by running the action below,
+not by saying the space is not reachable; if you have not run `list` in this
+conversation, run it first. **Space ids are shown.** The platform's
+never-show-ids rule does not apply to a space `id` here; put it beside each
+name.
+
 ## Usage
 
 ```bash

package/examples/extensions/pinchtab/index.ts

@@ -21,6 +21,7 @@ export default function (mercury: {
   local bind="\${BRIDGE_BIND:-127.0.0.1}"
   local port="\${BRIDGE_PORT:-9867}"
   local log="\${PINCHTAB_LOG:-/tmp/pinchtab.log}"
+  local pidfile="\${PINCHTAB_PIDFILE:-/tmp/pinchtab.pid}"
   local max_wait="\${1:-120}"
   mkdir -p "$(dirname "$log")" 2>/dev/null || true
   # Belt and braces alongside the container-level "--ulimit core=0": Chromium
@@ -52,7 +53,27 @@ export default function (mercury: {
   if command -v pinchtab >/dev/null 2>&1 && _pinchtab_port_open; then
     return 0
   fi
-  pkill -f '[p]inchtab' 2>/dev/null || true
+  # Kill only the daemon THIS function started (and its Chromium children).
+  # This used to be a pkill sweep over the whole command line of every process,
+  # matching a bare "pinchtab" substring: the caller's own shell, a grep, an
+  # editor -- anything whose argv merely mentions the tool -- was killed with a
+  # bare "Terminated" and no explanation. The bracket trick in that old pattern
+  # only excluded pkill's own argv, never the caller's. Record the pid instead.
+  # grep -qa on /proc/PID/cmdline (NUL-separated) avoids writing a NUL escape
+  # inside this TS template literal, where it would collapse before reaching
+  # disk -- the same collapse that produced the multiPartTld wildcard bug.
+  _pinchtab_kill_stale() {
+    local old
+    old="$(cat "$pidfile" 2>/dev/null)" || return 0
+    [ -n "$old" ] || return 0
+    # PIDs are reused: only kill if it is still a pinchtab.
+    if grep -qa pinchtab "/proc/$old/cmdline" 2>/dev/null; then
+      pkill -TERM -P "$old" 2>/dev/null || true
+      kill -TERM "$old" 2>/dev/null || true
+    fi
+    rm -f "$pidfile"
+  }
+  _pinchtab_kill_stale
   # pinchtab >=0.13 ships IDPI enforcing with a loopback-only website
   # whitelist, so every public URL is refused with 403 idpi_domain_blocked --
   # including the Brave search this skill tells the agent to run. Widen the
@@ -89,6 +110,7 @@ export default function (mercury: {
   fi
   nohup pinchtab server >>"$log" 2>&1 &
   local pid=$!
+  echo "$pid" >"$pidfile"
   sleep 2
   if ! kill -0 "$pid" 2>/dev/null; then
     echo "pinchtab exited immediately (pid $pid). Log:" >&2
@@ -119,6 +141,17 @@ export default function (mercury: {
     let sessionPromptFragment = "";
 
     if (process.env.MERCURY_BROWSER_SESSIONS) {
+      // The `multiPartTld` regex below writes both of its dots as `\\.`, and
+      // that doubling is load-bearing: this is a TS template literal, so one
+      // backslash collapses on evaluation and a single `\.` would reach disk as
+      // a bare dot — a wildcard where a literal dot is meant. That was the bug
+      // in `pinchtab-multipart-tld-regex-dots-are-wildcards`; Biome's
+      // noUselessEscapeInString does not flag a doubled backslash, so the
+      // autofix that erased the original escapes cannot recur. This note lives
+      // out here because everything inside the backticks is shipped to the
+      // container, where "TS template literal" means nothing.
+      // tests/pinchtab-prompt.test.ts pins the EMITTED form, not this source.
+      //
       // Node.js injection script — pure ES5-style, no backticks or ${} so no TS escaping needed.
       // Reads MERCURY_BROWSER_SESSIONS from env, looks up the domain, injects cookies +
       // localStorage via the pinchtab HTTP bridge, then reloads. Exits 0 on success (session
@@ -131,12 +164,8 @@ var sessions;
 try { sessions = JSON.parse(Buffer.from(raw, "base64").toString()); } catch (e) { process.exit(1); }
 var hostname = (new URL(url)).hostname;
 var parts = hostname.split(".");
-// The two dots below are WILDCARDS, not literal dots, and always have been: a
-// backslash before a dot collapses to a bare dot when this TS template literal
-// is evaluated, long before the script reaches disk. Spelled out in words here
-// because writing the escape itself would be stripped the same way. Left as-is:
-// restoring the intent would change emitted behaviour, so it is filed, not fixed.
-var multiPartTld = /.(co|com|org|net|gov|ac|edu|or|ne|gr|gen|plc|ltd|me).[a-z]{2}$/i;
+// eTLD+1: the dots are literal, so only a genuine multi-part TLD takes slice(-3).
+var multiPartTld = /\\.(co|com|org|net|gov|ac|edu|or|ne|gr|gen|plc|ltd|me)\\.[a-z]{2}$/i;
 var domain = parts.length <= 2 ? hostname : (multiPartTld.test(hostname) ? parts.slice(-3).join(".") : parts.slice(-2).join("."));
 var b64 = sessions[domain];
 if (!b64) process.exit(1);

package/examples/extensions/pinchtab/skill/SKILL.md

@@ -38,6 +38,7 @@ pinchtab_ensure() {
   local bind="${BRIDGE_BIND:-127.0.0.1}"
   local port="${BRIDGE_PORT:-9867}"
   local log="${PINCHTAB_LOG:-/tmp/pinchtab.log}"
+  local pidfile="${PINCHTAB_PIDFILE:-/tmp/pinchtab.pid}"
   local max_wait="${1:-120}"
   mkdir -p "$(dirname "$log")" 2>/dev/null || true
   # Chromium helper processes segfault under the container sandbox; each dump is
@@ -66,7 +67,24 @@ pinchtab_ensure() {
   if command -v pinchtab >/dev/null 2>&1 && _pinchtab_port_open; then
     return 0
   fi
-  pkill -f '[p]inchtab' 2>/dev/null || true
+  # Kill only the daemon THIS function started (and its Chromium children).
+  # This used to be a pkill sweep over the whole command line of every process,
+  # matching a bare "pinchtab" substring: the caller's own shell, a grep, an
+  # editor -- anything whose argv merely mentions the tool -- was killed with a
+  # bare "Terminated" and no explanation. The bracket trick in that old pattern
+  # only excluded pkill's own argv, never the caller's. Record the pid instead.
+  _pinchtab_kill_stale() {
+    local old
+    old="$(cat "$pidfile" 2>/dev/null)" || return 0
+    [ -n "$old" ] || return 0
+    # PIDs are reused: only kill if it is still a pinchtab.
+    if grep -qa pinchtab "/proc/$old/cmdline" 2>/dev/null; then
+      pkill -TERM -P "$old" 2>/dev/null || true
+      kill -TERM "$old" 2>/dev/null || true
+    fi
+    rm -f "$pidfile"
+  }
+  _pinchtab_kill_stale
   # pinchtab >=0.13 ships IDPI enforcing with a loopback-only website whitelist,
   # so every public URL is refused with 403 idpi_domain_blocked -- including the
   # Brave search this skill tells the agent to run. Widen the allowlist but keep
@@ -98,6 +116,7 @@ pinchtab_ensure() {
   fi
   nohup pinchtab server >>"$log" 2>&1 &
   local pid=$!
+  echo "$pid" >"$pidfile"
   sleep 2
   if ! kill -0 "$pid" 2>/dev/null; then
     echo "pinchtab exited immediately (pid $pid). Log:" >&2
@@ -134,6 +153,14 @@ pinchtab text
 
 If `pinchtab_ensure` fails, show the user the tail of `/tmp/pinchtab.log`; do not only increase `sleep` and retry blindly.
 
+**Inside the container, start the daemon only through `pinchtab_ensure`.** It
+records the daemon's pid in `$PINCHTAB_PIDFILE` (default `/tmp/pinchtab.pid`)
+and that record is the only thing a later call uses to clear a stale daemon. A
+daemon started as a bare `pinchtab server &` — the quick-start above and the
+"Advanced" options below both show that form, which is correct outside Mercury —
+writes no pidfile, so it is never cleaned up and will hold the port against the
+next `pinchtab_ensure`.
+
 ### Recommended Secure Setup
 
 ```bash

package/examples/profiles/_template/AGENTS.md

@@ -70,7 +70,12 @@ the ones that apply, delete the rest:>
   "users here are developers; show the command you ran when asked">.
 - Standing instructions from members: <what you do with "from now on…" from
   a non-admin — relay to the admin in one line / decline once / treat as
-  banter — instead of the default "set a preference / only the admin can">.
+  banter>. Know what you are overriding: a personality, tone, greeting or
+  character request already gets a one-line "the owner sets it" decline from
+  the platform text, which every caller receives. Any *other* standing request
+  (a language, a length, a format) has **no** platform default for a member —
+  the procedure that would turn it into a preference is gated on `prefs.set`,
+  so if you do not say what happens here, nothing does.
 - Concision / clarification: <"a factual question gets a full answer, not a
   teaser" | "act on a reasonable reading; do not ask before acting">.
 

package/examples/profiles/football-reporter/AGENTS.md

@@ -6,11 +6,17 @@
 ## תפקיד
 
 כתב הכדורגל של הקבוצה. הסיקור: ישראלים בחו"ל, הפועל תל אביב, בית"ר ירושלים,
-מכבי חיפה, מנצ'סטר יונייטד, ברצלונה, ריאל מדריד, וקבוצות ישראליות באירופה.
+מכבי חיפה, מכבי תל אביב, מנצ'סטר יונייטד, ברצלונה, ריאל מדריד, וקבוצות
+ישראליות באירופה.
 לשלושת המועדונים הגדולים, יונייטד וברצלונה וריאל, משקל שווה בדיוק: אף אחד לא
 מקבל יותר מקום מהאחרים. שאלה עובדתית מקבלת תשובה מלאה, לא טיזר. שטות מקבלת
 שטות.
 
+כדורגל נשים וכדורגל נוער הם מחוץ לסיקור, בכל שפה ובכל תחרות — גם כשמדובר
+באחד הנושאים שכן מסוקרים, וגם כשהפריט הגיע אליך כי סינון הכותרות פספס
+אותו. פריט כזה לא נכנס לסריקה ולא לכתבה. אם חבר שואל עליו במפורש, עונים
+כרגיל אבל בלי לפתוח לזה פנקס; פשוט לא מדווחים עליו ביוזמתך.
+
 ## עדיפויות
 
 כששני כללים כאן מושכים לכיוונים שונים, זה הסדר:
@@ -162,9 +168,10 @@
 - תאריך בסוגריים: יום וחודש בלבד (למשל 25/08), בלי שנה. השנה עדיין חובה
   לוודא במקור לפני הכתיבה — היא פשוט לא מוצגת.
 - אימוג'י מועדון קבוע, בתחילת השורה, רק בסריקה (לא בכתבה, לא בצ'אט):
-  מנצ'סטר יונייטד 😈, ברצלונה 🔵, ריאל מדריד ⚪, הפועל תל אביב 🔴,
-  בית"ר ירושלים 💛, מכבי חיפה 🟢. פריט שלא נוגע לאף אחד מהם (למשל סאגת
-  העברות כללית, או ישראלי במועדון אחר) בלי אימוג'י בכלל — לא ממציאים אחד.
+  מנצ'סטר יונייטד 👹, ברצלונה ❤️💙, ריאל מדריד 🤍, הפועל תל אביב ❤️,
+  בית"ר ירושלים 💛🖤, מכבי חיפה 💚, מכבי תל אביב 💛💙. פריט שלא נוגע לאף אחד
+  מהם (למשל סאגת העברות כללית, או ישראלי במועדון אחר) בלי אימוג'י בכלל —
+  לא ממציאים אחד.
 - קיבוץ: כשכמה פריטים באותה סריקה נוגעים לאותו מועדון, הם נכתבים ברצף עם
   שורת כותרת אחת לשם המועדון (בלי אימוג'י כפול על כל שורה בתוך הקבוצה,
   האימוג'י יושב פעם אחת ליד שם הכותרת). מועדון עם פריט בודד לא מקבל כותרת,
@@ -196,6 +203,11 @@
   או הערה באנגלית (למשל "Good, already up to date. Now the chat reply.")
   לא נכנס להודעה בשום צורה, גם לא כשורה ראשונה. אם יש צורך לחשוב בקול, זה
   קורה מחוץ להודעה שנשלחת, לא בתוכה.
+- שורה נכתבת פעם אחת. אם באמצע הכתיבה מתברר שהפרט שגוי, מוחקים את השורה
+  וכותבים אותה מחדש נכון: התיקון מחליף את השורה, אף פעם לא נוסף אחריה.
+  בהודעה שנשלחת אין "רגע,", אין "סליחה," ואין "תיקון:". הקורא בקבוצה רואה
+  בוט שמתקן את עצמו בקול, והפרט השגוי נשאר מול העיניים גם אחרי התיקון. זה
+  אותו כלל כמו הסעיף שמעל, בעברית במקום באנגלית.
 
 ## שתיקה
 

package/examples/profiles/football-reporter/README.md

@@ -17,7 +17,7 @@ ambient traffic is therefore **0**, member-facing checks in
 member rows from the space's earlier life are kept on purpose (owner's
 decision D7, 2026-09-02): the real group is the same people, so the rows
 become correct again at the link. Posting budget is the real-group setting
-already (`feed-watch.max_per_hour: 1`, `batch_minutes: 15`; D8). Task 24
+already (`feed-watch.max_per_hour: 3`, `batch_minutes: 15`; D-024). Task 24
 (the 09:00 article) runs on demand here; the harness runs with
 `--allow-linked` and rewrites history.
 

package/examples/profiles/football-reporter/config.yaml

@@ -117,10 +117,11 @@ extension_config:
   # setter of any profile-owned key whose live value a person wrote.
   #
   # The list a fresh space starts from, for the record. Maccabi Haifa was
-  # missing until M2.3 — it is one of the seven coverage topics in AGENTS.md
-  # and one of the seeded notebooks. Maccabi Tel Aviv and Hapoel Be'er Sheva
-  # are not standing coverage topics; they are watched because "Israeli clubs
-  # in Europe" is one.
+  # missing until M2.3 — it is one of the coverage topics in AGENTS.md and one
+  # of the seeded notebooks. Maccabi Tel Aviv joined the standing coverage on
+  # 2026-09-03 (the owner, from chat; D-023) and has a seeded notebook too.
+  # Hapoel Be'er Sheva is not a standing coverage topic; it is watched because
+  # "Israeli clubs in Europe" is one.
   #   feed-watch.terms: |
   #   ["מנצ'סטר יונייטד","מאן יונייטד","Manchester United","Man Utd",
   #   "ברצלונה","Barcelona","ריאל מדריד","Real Madrid",
@@ -131,7 +132,35 @@ extension_config:
   # stripped, so `מנצ'סטר יונייטד` also catches `למנצ'סטר יונייטד`. The bare
   # word `יונייטד` is deliberately absent: it would match Newcastle and Leeds
   # every match day.
-  feed-watch.exclude: '["נוער","נשים","fantasy","WSL","U21","U19","טוטו","הימור"]'
+  # The exclude list is matched over title plus summary like the terms, but
+  # anchored at the **start of a word** since 2026-09-06 (Hebrew prefixes
+  # looked through, the end of the word still open — see
+  # `docs/debug/minor/2026-09-06-feed-watch-hebrew-exclude-term-over-matches-a-longer-word.md`,
+  # where `נשים` was dropping every headline containing `אנשים`, "people").
+  # An exclusion still only catches headlines in the language it was written
+  # in. `נשים` and `WSL` said "women's football is out of scope" and let three
+  # English items through in two days on 2026-09-04/05
+  # (`docs/debug/minor/2026-09-06-football-womens-football-slips-past-feed-watch-exclude.md`),
+  # because `Arsenal to face Barca & Lyon in Women's Champions League` carries
+  # neither. Every added form is a title the live feeds actually publish:
+  # `Women` still covers `Women's` and `Womens` (the apostrophe is stripped,
+  # and only the front of the word is anchored). `NWSL` is listed in its own
+  # right — under the anchor `WSL` no longer reaches inside it.
+  #
+  # The Catalan `Femení` is deliberately NOT here, and neither is the shorter
+  # `Femen` that would have covered it. **Kiko Femenía** is a men's La Liga
+  # right-back, the two Marca feeds above are Spanish-language, and `normalize`
+  # does not strip Latin diacritics — so both `Femen` and `Femení` open the
+  # word `femenía` and would drop a men's item naming him, silently and with no
+  # trace. The front anchor does not help here: the surname *starts* with those
+  # letters. It is the same silent-drop failure the terms comment warns about
+  # (`City` inside *Capacity*), in the direction that loses a story instead of
+  # posting a bad one. `Femenino`/`Femenina` are safe (the `í` and the second
+  # `n` both differ), so Spanish is filtered and Catalan is left to the prose.
+  #
+  # The list is still only as good as its substrings — the backstop for what it
+  # misses is the coverage rule in `AGENTS.md § תפקיד`, not another substring.
+  feed-watch.exclude: '["נוער","נשים","fantasy","WSL","NWSL","U21","U19","טוטו","הימור","Women","UWCL","Lionesses","Femenino","Femenina"]'
   # Nothing is opened between 00:30 and 07:30 local; matched items still reach
   # the 09:00 article through the digest, which is the whole point of buffering
   # separately from reporting.
@@ -144,11 +173,14 @@ extension_config:
   # which answered NO_UPDATE. Lowered 2026-08-31 to 1/hour and a 15-minute
   # batch: a wider batch also merges more outlets carrying one story into a
   # single run, which is what the verify prompt asks the model to do anyway.
+  # Back to 3/hour on 2026-09-03 (owner's call, set from the dashboard and then
+  # confirmed in writing; D-024). The batch stays at 15 minutes, so at most four
+  # batches an hour can open and the cap only bites on a burst.
   #
   # These reduce the *number* of runs. They are not the digest fix — see
   # `docs/debug/major/2026-08-31-feed-watch-digest-persisted-and-replayed.md` for the prefix size,
   # which is the other factor in the same product.
-  feed-watch.max_per_hour: "1"
+  feed-watch.max_per_hour: "3"
   feed-watch.batch_minutes: "15"
 
   # The other factor in the same product: how big each run's prompt is. The
@@ -216,3 +248,7 @@ workspace_seed:
   knowledge/episodes/real-madrid-2026-27.md: ./seed/episodes/real-madrid-2026-27.md
   knowledge/episodes/beitar-jerusalem-2026-27.md: ./seed/episodes/beitar-jerusalem-2026-27.md
   knowledge/episodes/maccabi-haifa-2026-27.md: ./seed/episodes/maccabi-haifa-2026-27.md
+  # Added 2026-09-03 with the club (D-023). The live space already had this
+  # notebook — napkin opened it on 2026-08-31 — so `apply` there writes nothing;
+  # the seed is for a space that starts from this profile.
+  knowledge/episodes/maccabi-tel-aviv-2026-27.md: ./seed/episodes/maccabi-tel-aviv-2026-27.md

package/examples/profiles/football-reporter/seed/MEMORY.md

@@ -13,7 +13,7 @@
 "מחברת". כאן רק הרשימה, כדי שלא אצטרך לחפש:
 
 `man-united-2026-27`, `barcelona-2026-27`, `real-madrid-2026-27`,
-`beitar-jerusalem-2026-27`, `maccabi-haifa-2026-27`,
+`beitar-jerusalem-2026-27`, `maccabi-haifa-2026-27`, `maccabi-tel-aviv-2026-27`,
 `israeli-clubs-europe-2026-qualifiers` (וגם הפועל ת"א נמצאת שם, אין לה
 פנקס נפרד), `summer-2026-transfer-window`, `toto-cup-2026`.
 

package/examples/profiles/football-reporter/seed/episodes/beitar-jerusalem-2026-27.md

@@ -4,7 +4,7 @@ status: active
 started: 2026-08-21
 last_mentioned: 2026-08-21
 mentions: 1
-keywords: ["ביתר", "בית", "ירושלים", "beitar", "jerusalem", "גדראני", "טוטו"]
+keywords: ["ביתר", "ירושלים", "beitar", "jerusalem", "גדראני", "טוטו"]
 summary: בית"ר ירושלים 2026-27 — בלי אירופה אחרי ההדחה בווינה; העונה היא ליגה וגביע הטוטו.
 ---
 

package/examples/profiles/football-reporter/seed/episodes/maccabi-tel-aviv-2026-27.md

@@ -0,0 +1,24 @@
+---
+type: episode
+status: active
+started: 2026-09-03
+last_mentioned: 2026-09-03
+mentions: 1
+keywords: ["מכבי", "תל", "אביב", "maccabi", "tel", "aviv", "בלומפילד"]
+summary: מכבי תל אביב 2026-27 — הפנקס נפתח כמעט ריק ביום שהמועדון נכנס לסיקור הקבוע (03/09); מה שאני מוסר עליו נכתב כאן, עם מקור ותאריך, לפני שהוא נשלח.
+---
+
+# מכבי תל אביב 2026-27
+
+הפנקס הקבוע של המועדון בליגת העל ובחלון ההעברות. מכבי תל אביב נכנסה לסיקור
+הקבוע ב-03/09 (הכרעת המנהל בצ'אט), ולכן הפנקס קיים גם כשאין בו כמעט כלום:
+מה שאני מוסר עליה נכתב כאן, עם מקור ותאריך, לפני שהוא נשלח. המסע האירופי
+של העונה יושב ב-[[israeli-clubs-europe-2026-qualifiers]] ולא כאן.
+
+## Current State
+<!-- נכון ל-2026-09-03. הכותרת חייבת להיות בדיוק "## Current State" — סיומת בסוגריים מפילה את ההזרקה. -->
+- (אין עובדה) אין עדיין פריט מאומת על הליגה או על סגל העונה.
+
+## History
+<!-- append-only; newest first -->
+- 2026-09-03: הפנקס נפתח על ידי הפרופיל ביום שהמועדון נוסף לסיקור הקבוע. נפתח כמעט ריק בכוונה — עדיף פנקס שאומר "אין לי כלום" על פני השלמה מהזיכרון.

package/examples/profiles/football-reporter/seed/napkin-distill.md

@@ -1,55 +1,56 @@
 # מה לזקק במרחב הזה
 
-המרחב הזה הוא קבוצת חברים שמדברת כדורגל, והבוט בה הוא כתב. הזיקוק נועד
-לשרת את הכתב: מה שנשמר צריך להיות שימושי בתשובה עובדתית למחרת.
+המרחב הזה הוא קבוצת חברים שמדברת כדורגל, והבוט בה הוא כתב. מה שנשמר צריך
+להיות שימושי בתשובה עובדתית למחרת.
 
 ## ישויות
 
-- **מועדון** → פנקס קבוע אחד, בשם `<club>-2026-27.md` (למשל
-  `man-united-2026-27.md`, `barcelona-2026-27.md`). אל תפתח פנקס שני
-  לאותו מועדון — עדכן את הקיים.
-- **מפעל** (ליגה, גביע, מוקדמות) → פנקס אחד למפעל ולעונה, למשל
-  `toto-cup-2026.md`, `israeli-clubs-europe-2026-qualifiers.md`.
-- **סאגה** (העברה מתמשכת, פציעה, סכסוך) → פנקס משלה, עם `status: resolved`
-  כשהיא נסגרת.
-- שיחות על עבודת פיתוח, על הבוט עצמו, ומשחקי חברה בקבוצה — לא נכנסים
-  לפנקסי המועדונים. פנקס נפרד, אם בכלל.
+- **מועדון** → פנקס קבוע אחד, `<club>-2026-27.md` (`barcelona-2026-27.md`).
+  אל תפתח פנקס שני לאותו מועדון — עדכן את הקיים.
+- **מפעל** (ליגה, גביע, מוקדמות) → פנקס אחד למפעל ולעונה, `toto-cup-2026.md`.
+- **סאגה** (העברה מתמשכת, פציעה, סכסוך) → פנקס משלה, `status: resolved` בסגירה.
+- שיחות על פיתוח, על הבוט עצמו ומשחקי חברה — לא נכנסים לפנקסי המועדונים.
+  פנקס נפרד, אם בכלל.
 
 ## מילות מפתח
 
 `keywords` הן מה שמחבר הודעה בצ'אט לפנקס, ולכן:
 
-- **עברית ואנגלית לאותו דבר**: `["יונייטד", "united", "ברצלונה",
-  "barcelona"]`. חברים כותבים בשתי השפות באותה שיחה.
-- **מילה אחת, בלי פיסוק.** ההודעה מפוצלת למילים על רווח ועל פיסוק ASCII,
-  ובכלל זה `'` ו-`"`, ואז מחפשים התאמה מדויקת למילה. לכן `מנצ'סטר` ו-`ת"א`
-  לעולם לא יתאימו — הם מתפצלים לשניים. במקומם: `יונייטד`, `הפועל`,
-  `ירושלים`, `חיפה`.
+- **עברית ואנגלית לאותו דבר**: `["יונייטד", "united"]` — כותבים בשתי השפות.
+- **מילה אחת, בלי פיסוק ובלי מקף.** גרש וגרשיים בתוך מילה בהודעה מוסרים
+  (`לבית"ר` מוצא את `ביתר`), אבל מילת מפתח לא עוברת ניקוי — `מנצ'סטר`
+  ו-`ת"א` לא יתאימו. במקומן: `יונייטד`, `ביתר`, `ירושלים`, `חיפה`.
+- **המילה הבסיסית, פעם אחת.** אותיות שימוש (ו, ה, ב, ל, מ, ש, כ) בתחילת
+  המילה בהודעה מתאימות מעצמן — `ליונייטד` ו-`וכשיונייטד` מוצאים את
+  `יונייטד` — כל עוד נשארות ארבע אותיות, וחמש אחרי מ'. אל תוסיף צורות כמו
+  `ליונייטד` כמילות מפתח: כל מילת מפתח נוספת מורידה את ציון הפנקס. במילה
+  קצרה בדוק ו/ה/ב/ל/ש/כ + המילה (מ' מטופלת כבר): אם יוצאת מילה אחרת
+  קיימת, בחר אחרת.
 
 ## עובדות
 
 - הרכב, תוצאה, פציעה, תאריך משחק ומעבר הם עובדות. כל שורה נושאת **מקור
   ותאריך** בסוגריים בסופה: `(ONE, 20/08)`. שורה בלי מקור ותאריך לא נכתבת.
 - שתי שורות מותרות בלי מקור, ורק הן, ושתיהן נפתחות בסימון: `(אין עובדה)`
-  לשורה שאומרת שאין עדיין מה לדעת, ו-`(מצביע)` לשורה שכל תוכנה הפניה
-  לקובץ אחר. אל תמחק את הסימונים ואל תמציא סימונים נוספים.
-- כותרת הסעיף היא בדיוק `## Current State`, בלי שום סיומת. סיומת כמו
-  `(as of 2026-08-20)` נראית תמימה ומפילה את כל הסעיף: המנגנון שמזריק את
-  הפנקס לשיחה מחפש את הכותרת המדויקת ומקבל סעיף ריק, כך שהעובדות לא
-  מגיעות לבוט בכלל. תאריך העדכון נכתב בשורה נפרדת מתחת לכותרת.
-- `## Current State` מחזיק **רק את מה שנכון עכשיו**. הרכב משוער שהוחלף
-  ברשמי, תוצאה שהתעדכנה, פציעה שהחלימה — יורדים ל-`## History` עם התאריך
-  ועם הסיבה, ולא נשארים למעלה.
+  לשורה שאומרת שאין עדיין מה לדעת, ו-`(מצביע)` לשורה שכולה הפניה לקובץ
+  אחר. אל תמחק סימונים ואל תמציא חדשים.
+- כותרת הסעיף היא בדיוק `## Current State`, בלי שום סיומת. תאריך העדכון
+  נכתב בשורה נפרדת מתחת לכותרת.
+- `## Current State` מחזיק **רק את מה שנכון עכשיו, ולא יותר מ-12 שורות**.
+  שורה שהוחלפה (הרכב משוער שהוחלף ברשמי, תוצאה שהתעדכנה, פציעה שהחלימה)
+  ושורה שהתאריך בסוגריים שלה ישן מ-14 יום — גם אם היא עדיין נכונה — יורדות
+  ל-`## History` עם התאריך ועם הסיבה. אם אחרי זה נשארו יותר מ-12 שורות,
+  מורידים את הישנות ביותר עד שנשארות 12. לא מוחקים, רק מורידים.
 - דרגת ודאות שהמקור נתן (רשמי / סגור / מתקדם / שמועה) נשמרת כמו שהיא.
   אל תשדרג שמועה לעובדה ואל תוריד עובדה לשמועה.
 - הפנקס בעברית, כמו הקבוצה.
 
 ## אנשים
 
-בפנקסי `people/` נשמרות העדפות והרגלים, לא מזהים: בלי מספרי טלפון, בלי
-מזהי וואטסאפ ובלי כתובות.
+בפנקסי `people/` נשמרות העדפות והרגלים, לא מזהים: בלי טלפונים, בלי מזהי
+וואטסאפ ובלי כתובות.
 
 ## תיקיית `.napkin`
 
 `.napkin/distill.md` — הקובץ הזה — הוא הנחיה, לא ידע. אל תערוך אותו, אל
-תעביר ממנו תוכן לפנקסים ואל תכתוב שום דבר אחר לתוך `.napkin/`.
+תעביר ממנו תוכן לפנקסים ואל תכתוב דבר אחר לתוך `.napkin/`.

package/examples/profiles/football-reporter/standard.json

@@ -14,13 +14,22 @@
     "this file second, and let the test tell you if you missed one."
   ],
 
+  "$clubEmoji_comment": [
+    "The marker a scan item opens with. Since the owner's 2026-09-03 edit (D-023)",
+    "a marker may be TWO emoji; the lint compares the whole run at line start as",
+    "one unit, so ❤\uFE0F💙 is Barcelona and a bare ❤\uFE0F is Hapoel, never half of both.",
+    "The heart is written with an escaped U+FE0F because the bot writes it that",
+    "way and the selector is invisible in an editor; the lint ignores selectors",
+    "when it compares, so a phone that drops or adds one still matches."
+  ],
   "clubEmoji": [
-    { "emoji": "😈", "names": ["מנצ'סטר יונייטד", "מאן יונייטד", "יונייטד", "Manchester United", "Man Utd"] },
-    { "emoji": "🔵", "names": ["ברצלונה", "Barcelona", "ברסה"] },
-    { "emoji": "⚪", "names": ["ריאל מדריד", "ריאל", "Real Madrid"] },
-    { "emoji": "🔴", "names": ["הפועל תל אביב", "הפועל ת\"א", "Hapoel Tel Aviv"] },
-    { "emoji": "💛", "names": ["בית\"ר ירושלים", "ביתר ירושלים", "בית\"ר", "Beitar Jerusalem"] },
-    { "emoji": "🟢", "names": ["מכבי חיפה", "Maccabi Haifa"] }
+    { "emoji": "👹", "names": ["מנצ'סטר יונייטד", "מאן יונייטד", "יונייטד", "Manchester United", "Man Utd"] },
+    { "emoji": "❤\uFE0F💙", "names": ["ברצלונה", "Barcelona", "ברסה"] },
+    { "emoji": "🤍", "names": ["ריאל מדריד", "ריאל", "Real Madrid"] },
+    { "emoji": "❤\uFE0F", "names": ["הפועל תל אביב", "הפועל ת\"א", "Hapoel Tel Aviv"] },
+    { "emoji": "💛🖤", "names": ["בית\"ר ירושלים", "ביתר ירושלים", "בית\"ר", "Beitar Jerusalem"] },
+    { "emoji": "💚", "names": ["מכבי חיפה", "Maccabi Haifa"] },
+    { "emoji": "💛💙", "names": ["מכבי תל אביב", "מכבי ת\"א", "Maccabi Tel Aviv"] }
   ],
 
   "caps": {
@@ -107,6 +116,33 @@
 
   "fillerAcks": ["בוצע", "Done", "סיימתי", "בדקתי", "מקובל."],
 
+  "$selfCorrectionMarkers_comment": [
+    "N-4: the markers a published mid-sentence self-correction is written with.",
+    "Read by the no-self-correction lint rule. Message #4107 (2026-09-02) is the",
+    "case: `… ובית\"ר... רגע, על פיינורד-ברצלונה …`.",
+    "",
+    "Two lists, because each of these is also an ordinary Hebrew word and the",
+    "shape is what distinguishes a correction from prose:",
+    "",
+    "  afterBreak - counts only behind a sentence break (… ... . ! ? — –) AND in",
+    "               front of a comma. Either half alone has a counter-example in",
+    "               football copy: 'ביקש סליחה, ואז' is the comma with no break,",
+    "               'הוא הבקיע. רגע קסם' is the break with no comma.",
+    "  always     - a correction marker wherever it stands.",
+    "",
+    "AGENTS.md § פורמט owns the rule and quotes three of these verbatim; the",
+    "lint's list is wider, the same trade writeClaimPhrases makes -- the prose",
+    "teaches the model the shape, the lint has to catch it however it is",
+    "written. `לא -` with an ASCII hyphen is deliberately absent: the hyphen is",
+    "a working connector in Hebrew (ל-3.5 שנים) and the long dash is already",
+    "ruled out by § פורמט's punctuation bullet."
+  ],
+  "selfCorrectionMarkers": {
+    "afterBreak": ["רגע", "סליחה"],
+    "always": ["תיקון:", "כלומר לא", "לא —", "לא –"]
+  },
+  "$selfCorrectionMarkersFromProse": ["רגע,", "סליחה,", "תיקון:"],
+
   "escalationPhrases": {
     "$comment": "`fromStandard` is quoted in AGENTS.md as the wrong answer; `fromDecision` is the phrasing D-016 recorded from the live failure. The lint flags either.",
     "fromStandard": ["אין לך הרשאה", "זה לא בסמכות שלי", "המנהל צריך לאשר"],
@@ -118,7 +154,7 @@
   "lineupSectionLabels": ["שוער", "הגנה", "קישור", "חוליה התקפית", "חלוץ", "חלוצים"],
 
   "$sources": {
-    "clubEmoji": "AGENTS.md § פורמט",
+    "clubEmoji": "AGENTS.md § פורמט — seven clubs since 2026-09-03; a marker is the whole emoji run at line start",
     "caps.itemMaxChars": "AGENTS.md § פורמט — 'עד 200 תווים'",
     "caps.summaryMaxChars": "tasks/daily-article.md § בלוק הסיכום — 'עד 900 תווים'; must equal config.yaml longview.summary_max_chars",
     "caps.articleMinChars": "tasks/daily-article.md § אורך — '2,500–4,500 תווים'",
@@ -132,6 +168,7 @@
     "hedgePhrases": "AGENTS.md § ייחוס — 'בלי מילוי מהוסס'",
     "clickbaitWords": "tasks/daily-article.md § אסור",
     "escalationPhrases": "AGENTS.md § היקף + § סגנון (D-016)",
-    "relativeDateWords": "AGENTS.md § טריות + D-004"
+    "relativeDateWords": "AGENTS.md § טריות + D-004",
+    "selfCorrectionMarkers": "AGENTS.md § פורמט — the 'a line is written once' bullet, which quotes רגע, / סליחה, / תיקון: as the words that never reach a sent message (N-4)"
   }
 }