@inerrata-corporation/errata 2.0.22-dev.4130 → 2.0.22-dev.4148

package/errata.mjs

@@ -18205,6 +18205,603 @@ var init_sqlite_adapter = __esm({
   }
 });
 
+// ../../packages/local-shared/src/tag-grammar.ts
+function tagGrammarCopy() {
+  const copy = [];
+  for (const ref of ["its-handle", "its-id", "h", "id"]) {
+    for (const build of Object.values(TAG_EXAMPLES)) copy.push(build(ref));
+  }
+  for (const v of TAG_VERBS) {
+    copy.push(v.hint);
+    if (v.taughtBy) copy.push(v.taughtBy);
+    for (const q of v.qualifiers ?? []) copy.push(q.note);
+    for (const l of v.lowering) {
+      if (l.note) copy.push(l.note);
+      if (l.knownViolation) copy.push(l.knownViolation.finding);
+    }
+  }
+  for (const f of TAG_FENCES) copy.push(f.hint);
+  return copy;
+}
+function normalizeTemplateBody(body2) {
+  return body2.replace(/…|\.{3}/g, " ").replace(/\s+/g, " ").trim().replace(/^[\s,;:—–-]+|[\s,;:.—–-]+$/g, "").toLowerCase();
+}
+function deriveTagTemplates(copy) {
+  const bodies = /* @__PURE__ */ new Set();
+  const handles = new Set([...TAG_PLACEHOLDER_HANDLES].map((h) => h.toLowerCase()));
+  for (const text of copy) {
+    for (const m of text.matchAll(BRACKET_TOKEN)) {
+      const token = m[1].trim().toLowerCase();
+      if (!/^[!?]/.test(token) && !REAL_HANDLE_SHAPE.test(token)) handles.add(token);
+    }
+  }
+  for (const text of copy) {
+    for (const m of text.matchAll(TEMPLATE_VERB_GROUP)) {
+      const body2 = normalizeTemplateBody(m[2]);
+      bodies.add(body2);
+      const unthreaded = normalizeTemplateBody(body2.replace(/^#[a-z][\w-]*/i, ""));
+      bodies.add(unthreaded);
+      const rest2 = normalizeTemplateBody(unthreaded.replace(BRACKET_TOKEN, (t, h) => handles.has(h.trim().toLowerCase()) ? " " : t).replace(/,/g, " "));
+      bodies.add(rest2);
+    }
+  }
+  bodies.delete("");
+  return { bodies, handles };
+}
+function isTemplateSegment(verb, text, templates) {
+  const t = normalizeTemplateBody(text);
+  if (t === "" || templates.bodies.has(t)) return true;
+  const unthreaded = normalizeTemplateBody(t.replace(/^#[a-z][\w-]*/i, ""));
+  if (unthreaded === "" || templates.bodies.has(unthreaded)) return true;
+  let real = false;
+  let standIn = false;
+  const rest2 = unthreaded.replace(BRACKET_TOKEN, (token, inner) => {
+    const h = inner.trim().toLowerCase();
+    if (/^[!?]/.test(h)) return token;
+    if (templates.handles.has(h) || /…|\.{3}/.test(h) || !REAL_HANDLE_SHAPE.test(h)) standIn = true;
+    else real = true;
+    return " ";
+  });
+  if (standIn || real) return true;
+  const words = normalizeTemplateBody(rest2.replace(ANY_VERB_WORD, " ").replace(/,/g, " "));
+  if (words === "" || templates.bodies.has(words)) return true;
+  const spec = verb ? TAG_VERB_BY_NAME.get(verb) : void 0;
+  if (!spec || spec.handleRequired) return true;
+  return words.length < (spec.minText ?? 2);
+}
+function isTemplateTagBody(verb, body2, templates = TAG_TEMPLATES) {
+  const whole = normalizeTemplateBody(body2);
+  if (whole === "" || templates.bodies.has(whole)) return true;
+  const segments = body2.split(JOINED_VERB);
+  return segments.every((seg, i2) => {
+    const lead2 = i2 === 0 ? null : LEADING_VERB.exec(seg);
+    return isTemplateSegment(lead2 ? lead2[1].toLowerCase() : verb, lead2 ? seg.slice(lead2[0].length) : seg, templates);
+  });
+}
+function quotesOnlyTemplateTags(span, templates = TAG_TEMPLATES) {
+  let found = false;
+  for (const m of span.matchAll(QUOTED_TAG_OPENER)) {
+    found = true;
+    if (m.index > 0 && /[\w$.\])]/.test(span[m.index - 1])) continue;
+    const bodyStart = m.index + m[0].length;
+    let depth = 1;
+    let close = -1;
+    for (let i2 = bodyStart; i2 < span.length; i2++) {
+      if (span[i2] === "(") depth++;
+      else if (span[i2] === ")" && --depth === 0) {
+        close = i2;
+        break;
+      }
+    }
+    if (close < 0) continue;
+    if (!isTemplateTagBody(m[1]?.toLowerCase() ?? null, span.slice(bodyStart, close), templates)) return false;
+  }
+  return found;
+}
+var TAG_CANONICAL_ID_PREFIXES, TAG_HANDLE_SOURCE, TAG_THREAD_SOURCE, TAG_PLACEHOLDER_HANDLES, TAG_EXAMPLES, P, S, RC, CITE_LOWERING, INSTANCE_LOWERING, TRIAGE_TO_RC, TAG_VERBS, TAG_FENCES, TAG_VERB_BY_NAME, TAG_PAREN_VERBS, TAG_GRAMMAR_OPENERS, TAG_QUOTED_PAREN_SOURCE, TAG_QUOTED_RE, TAG_QUOTED_PAREN_RE, TEMPLATE_VERB_GROUP, BRACKET_TOKEN, REAL_HANDLE_SHAPE, TAG_TEMPLATES, VERB_WORDS_SOURCE, JOINED_VERB, LEADING_VERB, ANY_VERB_WORD, QUOTED_TAG_OPENER, TAG_VERDICT_TOKENS;
+var init_tag_grammar = __esm({
+  "../../packages/local-shared/src/tag-grammar.ts"() {
+    "use strict";
+    TAG_CANONICAL_ID_PREFIXES = ["pat", "sol", "drc", "dcause", "dfix", "dprob", "dvuln", "prob", "claim", "err"];
+    TAG_HANDLE_SOURCE = String.raw`\[([a-z0-9][\w-]{0,80})\]|((?:${TAG_CANONICAL_ID_PREFIXES.join("|")})_[0-9a-f]{6,})`;
+    TAG_THREAD_SOURCE = String.raw`#([a-z][\w-]{0,63})`;
+    TAG_PLACEHOLDER_HANDLES = /* @__PURE__ */ new Set([
+      "handle",
+      "its-handle",
+      "another",
+      "a-third",
+      "h",
+      "h1",
+      "h2",
+      "id",
+      "its-id",
+      "a",
+      "b",
+      "\u2026",
+      "..."
+    ]);
+    TAG_EXAMPLES = {
+      prior: (ref) => `([${ref}])`,
+      problem: () => `[!one line on what's wrong]`,
+      vulnerability: () => `[!vuln: who can do what; observed basis @ path:line]`,
+      suspectedVulnerability: () => `[?vuln: consequence; missing check]`,
+      vulnerabilityThread: () => `[!#v vuln: finding here]`,
+      fix: (ref) => `(fix:[${ref}])`,
+      // CONSTRAINT — the native capture path for a DIFFUSE problem (a constraint/tension/
+      // conflict that shaped a decision). Free text, attaches to the decision sentence the
+      // agent is already writing. Full rationale in the constraint note below + prior-tags.ts.
+      constraint: () => `(constraint: the limitation that forced it)`,
+      // TRIAGE — routes the problem/symptom in scope to its cause. `(cause:[handle])`
+      // links to a cited RootCause/Solution node; `(cause: free text)` mints a RootCause
+      // from the text. Harvested in prior-tags.ts → engine.ts (see the triage note below).
+      triage: (ref) => `(cause:[${ref}])`,
+      // Unlike a bare cause citation, this handle names the Problem being explained.
+      triageExplain: (ref) => `(cause:[${ref}] the mechanism)`,
+      // The MINT form — free-text cause that mints a RootCause. Prime-time surfacing
+      // (recallForFile) pastes this next to an open Problem that has no cause yet, so the
+      // diagnostic moment is cued when the agent is looking at the problem. Kept here so
+      // the grammar can't drift from parseInlineTags' `(cause: …)` acceptance.
+      triageMint: () => `(cause: why it happens)`,
+      // THREAD forms — the witness-declared symptom↔cause/fix binding. A `#id` on the
+      // flag names the diagnosis thread; the same `#id` on a later verb binds to it
+      // explicitly (across sentences AND turns), replacing proximity guessing. Adjacent
+      // tags never need one — the id is for diagnoses that unfold over distance.
+      problemThread: () => `[!#slug one line on what's wrong]`,
+      causeThread: () => `(cause:#slug the mechanism)`,
+      fixThread: (thread = "slug") => `(fix:#${thread} what you changed)`,
+      // ATTEMPT arc — what's being tried and what didn't work. A failed attempt is a
+      // witnessed NEGATIVE result: it saves the next agent the same dead end.
+      tried: () => `(tried: the approach you're attempting)`,
+      failed: () => `(failed: what didn't work and the dead end it rules out)`,
+      // `(failed:[h] …)` on a shown SOLUTION — the refute-by-failure form the context render teaches.
+      failedCite: (ref) => `(failed:[${ref}] what came back)`,
+      // LINK verbs (AC epic) — bind the problem in scope to CANONICAL priors and
+      // abstractions. Multi-target by design: single links are weak; ~3 links to 3
+      // DIFFERENT relevant priors is the target shape (see linkBullet).
+      instance: (ref) => `(instance:[${ref}],[another],[a-third])`,
+      pattern: () => `(pattern: name the general shape)`,
+      // DOMAIN — the abstract area a problem is about; the concept layer an
+      // anchor-less problem clusters on. Mints/resolves a Domain by name.
+      domain: () => `(domain: The Area)`,
+      // PACKAGE/COMPONENT — agent-named public anchors (OM-agent-anchors): the
+      // package a problem is ABOUT (even when not a dependency) and the
+      // framework/product-level unit it concerns. Public spine anchors → the
+      // knowledge can cross to the collective.
+      package: () => `(package: the-package-name)`,
+      component: () => `(component: The Component)`,
+      aids: (ref) => `(aids:[${ref}])`,
+      // SOLUTION-STRUCTURE (SS-structure) — taught in the link bullet; Solution→Solution.
+      buildsOn: (ref) => `(builds-on:[${ref}])`,
+      supersedes: (ref) => `(supersedes:[${ref}])`,
+      alternative: (ref) => `(alternative:[${ref}])`,
+      // VERDICT (VS-verdict-tags) — a judgment on a SHOWN prior, distinct from leaning on it.
+      // `confirm` rides the corroborate channel (it held); `refute` the contradict channel
+      // (it's wrong / didn't hold) and REQUIRES a reason. This is the inline producer the
+      // evidence channels lacked — refute sat dead (contradictionPressure 0) until now, while
+      // lean-on corroboration lived, because only corroboration had an inline path. Grammar
+      // single-sourced with parseInlineTags' CONFIRM_PREFIX/REFUTE_PREFIX.
+      confirm: (ref) => `(confirm:[${ref}])`,
+      refute: (ref) => `(refute:[${ref}] one line why)`,
+      // RETRACT — "not a real problem": the errata-resolved block with a disposition
+      // (parseDesignResolutions, turn.ts). No inline form exists; the block is the grammar.
+      retract: (id) => ["```errata-resolved", `id: ${id}`, "disposition: false_positive", "reason: why it was never a real problem", "```"].join("\n")
+    };
+    P = "Problem";
+    S = "Solution";
+    RC = "RootCause";
+    CITE_LOWERING = [
+      { target: RC, writes: [{ from: P, edge: "CAUSED_BY", to: RC }] },
+      { target: S, writes: [{ from: P, edge: "SOLVED_BY", to: S }] },
+      { target: "Pattern", writes: [{ from: P, edge: "INSTANCE_OF", to: "Pattern" }, { from: "Pattern", edge: "ANCHORED_AT", to: "File" }], note: "cite-anchor promotion after 2 sessions", decision: "d", knownViolation: { edge: "ANCHORED_AT", finding: "motif cite-anchor promotion writes a refused ANCHORED_AT" } },
+      { target: "Package", writes: [{ from: P, edge: "DEPENDS_ON", to: "Package" }] },
+      { target: "Language", writes: [{ from: P, edge: "OCCURS_IN", to: "Language" }] },
+      { target: "Tool", writes: [{ from: P, edge: "CONCERNS", to: "Tool" }] },
+      { target: "Component", writes: [{ from: P, edge: "CONCERNS", to: "Component" }] },
+      { target: P, writes: [{ from: P, edge: "RELATES_TO", to: P }, { from: P, edge: "ANCHORED_AT", to: "File" }], note: "corroboration witness + cite-anchor promotion" },
+      { target: "AntiPattern", writes: [{ from: P, edge: "RELATES_TO", to: "AntiPattern" }, { from: "AntiPattern", edge: "ANCHORED_AT", to: "File" }], decision: "e", knownViolation: { edge: "ANCHORED_AT", finding: "motif cite-anchor promotion writes a refused ANCHORED_AT" } },
+      { target: "Technique", writes: [{ from: P, edge: "RELATES_TO", to: "Technique" }, { from: "Technique", edge: "ANCHORED_AT", to: "File" }], decision: "e", knownViolation: { edge: "ANCHORED_AT", finding: "motif cite-anchor promotion writes a refused ANCHORED_AT" } },
+      { target: "Weakness", writes: [{ from: P, edge: "RELATES_TO", to: "Weakness" }], decision: "e" },
+      { target: "Domain", writes: [{ from: P, edge: "RELATES_TO", to: "Domain" }], decision: "e" },
+      { target: "Claim", writes: [{ from: P, edge: "RELATES_TO", to: "Claim" }, { from: "Claim", edge: "ANCHORED_AT", to: "File" }] }
+    ];
+    INSTANCE_LOWERING = [
+      { target: "Pattern", writes: [{ from: P, edge: "INSTANCE_OF", to: "Pattern" }] },
+      { target: P, writes: [{ from: P, edge: "RELATES_TO", to: P }] },
+      { target: S, writes: [{ from: P, edge: "SOLVED_BY", to: S }], note: "an instance cite on a Solution claims the problem is solved by it", decision: "a" },
+      { target: RC, writes: [{ from: P, edge: "CAUSED_BY", to: RC }] },
+      { target: "AntiPattern", writes: [{ from: P, edge: "RELATES_TO", to: "AntiPattern" }], decision: "e" },
+      { target: "Technique", writes: [{ from: P, edge: "RELATES_TO", to: "Technique" }], decision: "e" },
+      { target: "Weakness", writes: [{ from: P, edge: "RELATES_TO", to: "Weakness" }], decision: "e" },
+      { target: "Domain", writes: [{ from: P, edge: "RELATES_TO", to: "Domain" }], decision: "e" },
+      { target: "Package", writes: [{ from: P, edge: "DEPENDS_ON", to: "Package" }] },
+      { target: "Component", writes: [{ from: P, edge: "CONCERNS", to: "Component" }] }
+    ];
+    TRIAGE_TO_RC = [
+      { from: P, edge: "TRIAGED_BY", to: "Triage" },
+      { from: "Triage", edge: "INDICATES", to: RC },
+      { from: P, edge: "CAUSED_BY", to: RC }
+    ];
+    TAG_VERBS = [
+      {
+        verb: "cite",
+        form: "citation",
+        opener: "(",
+        kinds: ["prior"],
+        args: "handles",
+        thread: false,
+        handleRequired: true,
+        lowering: CITE_LOWERING,
+        examples: ["prior"],
+        hint: "cite a shown prior you leaned on: ([its-handle]) \u2014 handles only, no prose inside the parens",
+        taught: "taught"
+      },
+      {
+        verb: "!",
+        form: "flag",
+        opener: "[!",
+        kinds: ["problem", "triage", "vulnerability", "fix", "prior"],
+        args: "flag-body",
+        thread: true,
+        minText: 8,
+        qualifiers: [
+          { name: "vuln", taught: true, note: "[!vuln: \u2026] \u2192 Vulnerability (asserted)" },
+          { name: "fixed", taught: false, note: "[!fixed: X] \u2192 read as a self-found fix" },
+          { name: "resolved", taught: false, note: "[!resolved: X] \u2192 read as a self-found fix" }
+        ],
+        lowering: [
+          { target: P, writes: [], note: "mints a Problem; `@ path[:line]` anchors it (ANCHORED_AT to code)" },
+          { target: RC, writes: [...TRIAGE_TO_RC, { from: RC, edge: "CAUSED_BY", to: RC }], note: "`<-` segments: first \u2192 triage route, later \u2192 RootCause chain" },
+          { target: "Vulnerability", writes: [], note: "[!vuln: \u2026]; `<-` causes stay on the finding (vulnerabilityCauses)" }
+        ],
+        examples: ["problem", "problemThread", "vulnerability", "vulnerabilityThread"],
+        hint: "flag a problem on one line: [!what's wrong @ path:42]; fold causes with <- ; a fix goes in (fix: \u2026), not [!fixed: \u2026]",
+        taught: "taught"
+      },
+      {
+        verb: "?",
+        form: "flag",
+        opener: "[?",
+        kinds: ["todo", "vulnerability"],
+        args: "flag-body",
+        thread: true,
+        minText: 8,
+        qualifiers: [{ name: "vuln", taught: true, note: "[?vuln: \u2026] \u2192 Vulnerability (suspected)" }],
+        lowering: [{ target: P, writes: [], note: "mints a todo Problem; a fix can close it today", decision: "g" }],
+        examples: ["suspectedVulnerability"],
+        hint: "[?\u2026] marks an open question / todo; [?vuln: consequence; missing check] a suspected vulnerability",
+        taught: "untaught",
+        taughtBy: "only the [?vuln:] form is taught; the bare [?todo] form is not",
+        decisions: ["g"]
+      },
+      {
+        verb: "fix",
+        form: "verb",
+        opener: "(fix:",
+        kinds: ["fix"],
+        args: "handles-text",
+        thread: true,
+        minText: 12,
+        lowering: [
+          { target: P, writes: [{ from: P, edge: "SOLVED_BY", to: S }], note: "closes the Problem; a note \u226512 chars mints the Solution" },
+          { target: "Vulnerability", writes: [{ from: "Vulnerability", edge: "SOLVED_BY", to: S }] },
+          { target: RC, writes: [], note: "dropped: 'fix tag went nowhere' (not a Problem); no tag writes FIXED_BY", decision: "f" }
+        ],
+        examples: ["fix", "fixThread"],
+        hint: "one fix per tag: (fix:[its-handle]) or (fix:#thread what you changed) \u2014 put the cause in its own (cause: \u2026)",
+        taught: "taught",
+        decisions: ["f"]
+      },
+      {
+        verb: "cause",
+        form: "verb",
+        opener: "(cause:",
+        kinds: ["triage"],
+        args: "handles-text",
+        thread: true,
+        minText: 8,
+        lowering: [
+          { target: RC, writes: TRIAGE_TO_RC },
+          { target: P, writes: [{ from: P, edge: "TRIAGED_BY", to: "Triage" }, { from: "Triage", edge: "INDICATES", to: RC }, { from: P, edge: "CAUSED_BY", to: RC }], note: "(cause:[problem] mechanism) \u2014 the cited Problem is the symptom; the mechanism mints the RootCause" },
+          { target: S, writes: [{ from: P, edge: "TRIAGED_BY", to: "Triage" }, { from: "Triage", edge: "INDICATES", to: S }], decision: "b", knownViolation: { edge: "INDICATES", finding: "(cause:[solution]) writes a refused INDICATES \u2192 Solution" } }
+        ],
+        examples: ["triage", "triageExplain", "triageMint", "causeThread"],
+        hint: "(cause: the mechanism you'd change) or (cause:[root-cause-handle]); bind a distant symptom with (cause:#thread \u2026)",
+        taught: "taught",
+        decisions: ["b"]
+      },
+      {
+        verb: "constraint",
+        form: "verb",
+        opener: "(constraint:",
+        kinds: ["constraint"],
+        args: "text",
+        thread: false,
+        minText: 8,
+        textRequired: true,
+        lowering: [{ target: P, writes: [], note: "mints a constraint-kind Problem" }],
+        examples: ["constraint"],
+        hint: "(constraint: the limitation that forced the decision)",
+        taught: "taught"
+      },
+      {
+        verb: "tried",
+        form: "verb",
+        opener: "(tried:",
+        kinds: ["attempt"],
+        args: "text",
+        thread: true,
+        minText: 8,
+        textRequired: true,
+        lowering: [{ target: P, writes: [], note: "journals an attempt on the bound problem" }],
+        examples: ["tried"],
+        hint: "(tried: the approach) \u2014 bind with (tried:#thread \u2026)",
+        taught: "taught"
+      },
+      {
+        verb: "failed",
+        form: "verb",
+        opener: "(failed:",
+        kinds: ["failure"],
+        args: "handles-text",
+        thread: true,
+        minText: 8,
+        textRequired: true,
+        lowering: [
+          { target: P, writes: [], note: "journals a failed attempt on the bound problem" },
+          { target: S, writes: [], note: "(failed:[h]) refutes the cited prior (contradictionPressure); skips the label gate today", decision: "j" }
+        ],
+        examples: ["failed", "failedCite"],
+        hint: "(failed: what didn't work); (failed:[solution] what came back) refutes a shown fix",
+        taught: "taught",
+        decisions: ["j"]
+      },
+      {
+        verb: "instance",
+        form: "verb",
+        opener: "(instance:",
+        kinds: ["instance"],
+        args: "handles",
+        thread: false,
+        handleRequired: true,
+        lowering: INSTANCE_LOWERING,
+        examples: ["instance"],
+        hint: "(instance:[h1],[h2],[h3]) \u2014 ~3 DIFFERENT shown priors this problem instantiates; handles only",
+        taught: "taught",
+        decisions: ["a", "e"]
+      },
+      {
+        verb: "pattern",
+        form: "verb",
+        opener: "(pattern:",
+        kinds: ["pattern"],
+        args: "handle-or-text",
+        thread: false,
+        minText: 3,
+        lowering: [{ target: "Pattern", writes: [{ from: P, edge: "INSTANCE_OF", to: "Pattern" }], note: "a handle must be a Pattern; free text resolves-or-mints one" }],
+        examples: ["pattern"],
+        hint: "(pattern: name the general shape) or (pattern:[shown-pattern])",
+        taught: "taught"
+      },
+      {
+        verb: "domain",
+        form: "verb",
+        opener: "(domain:",
+        kinds: ["domain"],
+        args: "text",
+        thread: false,
+        minText: 2,
+        textRequired: true,
+        lowering: [{ target: "Domain", writes: [{ from: P, edge: "PERTAIN_TO", to: "Domain" }], note: '(domain:#t X) mints a Domain named "#t X" today', decision: "k" }],
+        examples: ["domain"],
+        hint: "(domain: The Area) \u2014 Title Case, no thread",
+        taught: "taught",
+        decisions: ["k"]
+      },
+      {
+        verb: "package",
+        form: "verb",
+        opener: "(package:",
+        kinds: ["package"],
+        args: "text",
+        thread: false,
+        minText: 2,
+        textRequired: true,
+        lowering: [{ target: "Package", writes: [{ from: P, edge: "DEPENDS_ON", to: "Package" }], note: "means 'concerns', written as DEPENDS_ON", decision: "c" }],
+        examples: ["package"],
+        hint: "(package: the-package-name) \u2014 the public package it's about",
+        taught: "taught",
+        decisions: ["c"]
+      },
+      {
+        verb: "component",
+        form: "verb",
+        opener: "(component:",
+        kinds: ["component"],
+        args: "text",
+        thread: false,
+        minText: 2,
+        textRequired: true,
+        lowering: [{ target: "Component", writes: [{ from: P, edge: "CONCERNS", to: "Component" }] }],
+        examples: ["component"],
+        hint: "(component: The Component) \u2014 the framework/product unit",
+        taught: "taught"
+      },
+      {
+        verb: "aids",
+        form: "verb",
+        opener: "(aids:",
+        kinds: ["transfer"],
+        args: "handles",
+        thread: true,
+        handleRequired: true,
+        lowering: [{ target: P, writes: [{ from: S, edge: "MAY_RESOLVE", to: P }], note: "source = the Solution in scope; non-Problem targets are skipped" }],
+        examples: ["aids"],
+        hint: "(aids:[problem-handle],\u2026) \u2014 other shown problems your fix might also resolve",
+        taught: "taught"
+      },
+      {
+        verb: "builds-on",
+        form: "verb",
+        opener: "(builds-on:",
+        kinds: ["builds-on"],
+        args: "handles",
+        thread: true,
+        handleRequired: true,
+        lowering: [{ target: S, writes: [{ from: S, edge: "BUILDS_ON", to: S }] }],
+        examples: ["buildsOn"],
+        hint: "(builds-on:[shown-solution]) \u2014 your fix layers on it",
+        taught: "taught",
+        taughtBy: "linkBullet instruction text"
+      },
+      {
+        verb: "supersedes",
+        form: "verb",
+        opener: "(supersedes:",
+        kinds: ["supersedes"],
+        args: "handles",
+        thread: true,
+        handleRequired: true,
+        lowering: [{ target: S, writes: [{ from: S, edge: "SUPERSEDES", to: S }] }],
+        examples: ["supersedes"],
+        hint: "(supersedes:[shown-solution]) \u2014 your fix replaces it",
+        taught: "taught",
+        taughtBy: "linkBullet instruction text"
+      },
+      {
+        verb: "alternative",
+        form: "verb",
+        opener: "(alternative:",
+        kinds: ["alternative"],
+        args: "handles",
+        thread: true,
+        handleRequired: true,
+        lowering: [{ target: S, writes: [{ from: S, edge: "ALTERNATIVE_TO", to: S }] }],
+        examples: ["alternative"],
+        hint: "(alternative:[shown-solution]) \u2014 a different valid approach",
+        taught: "taught",
+        taughtBy: "linkBullet instruction text"
+      },
+      {
+        verb: "confirm",
+        form: "verb",
+        opener: "(confirm:",
+        kinds: ["confirm"],
+        args: "handles",
+        thread: false,
+        handleRequired: true,
+        lowering: [{ target: S, writes: [], note: "corroboration witness (corroborationCount), no edge" }],
+        examples: ["confirm"],
+        hint: "(confirm:[shown-prior]) \u2014 it held",
+        taught: "taught",
+        taughtBy: "verdictBullet + context render",
+        decisions: ["j"]
+      },
+      {
+        verb: "refute",
+        form: "verb",
+        opener: "(refute:",
+        kinds: ["refute"],
+        args: "handles-text",
+        thread: false,
+        minText: 4,
+        handleRequired: true,
+        textRequired: true,
+        lowering: [{ target: S, writes: [], note: "contradiction witness (contradictionPressure), no edge; reason stays local" }],
+        examples: ["refute"],
+        hint: "(refute:[shown-prior] one line why) \u2014 the reason is required",
+        taught: "taught",
+        taughtBy: "verdictBullet + context render",
+        decisions: ["j"]
+      }
+    ];
+    TAG_FENCES = [
+      {
+        fence: "errata-problem",
+        fields: ["problem", "cause", "fix", "anchor", "kind"],
+        required: [["problem"]],
+        taught: "untaught",
+        parser: "apps/daemon/src/turn.ts parseDesignFlags",
+        decisions: ["h"],
+        hint: "use an inline [!\u2026] flag instead (errata-problem cause ids never meet inline ids)"
+      },
+      {
+        fence: "errata-resolved",
+        fields: ["id", "problem", "fix", "disposition", "reason"],
+        required: [["id", "problem"]],
+        taught: "taught",
+        taughtBy: "retract form only (TAG_EXAMPLE.retract); the fix form is untaught",
+        parser: "apps/daemon/src/turn.ts parseDesignResolutions",
+        hint: "```errata-resolved with id: and disposition: false_positive | invalid, reason: \u2026"
+      },
+      {
+        fence: "errata-triage",
+        fields: ["presenting", "cause", "test", "fix", "drift", "route"],
+        required: [["presenting", "route"], ["cause", "test"]],
+        taught: "taught",
+        taughtBy: "MCP errata_triage tool copy",
+        parser: "packages/local-graph/src/triage.ts parseTriageFences",
+        hint: "```errata-triage with presenting: and cause: (or route: + test: to answer one)"
+      },
+      {
+        fence: "errata-abstraction",
+        fields: ["candidate", "principle", "covers"],
+        required: [["candidate"], ["principle"], ["covers"]],
+        taught: "taught",
+        taughtBy: "MCP errata_pending_abstractions tool copy",
+        parser: "packages/local-graph/src/abstraction.ts parseAbstractionFences",
+        hint: "```errata-abstraction with candidate:, principle:, covers: (all required)"
+      },
+      {
+        fence: "errata-intent",
+        fields: ["intent"],
+        required: [["intent"]],
+        taught: "taught",
+        parser: "packages/local-graph/src/intent.ts parseIntentFences",
+        hint: "```errata-intent with intent: what you're about to do"
+      },
+      {
+        fence: "errata-share",
+        fields: ["priors"],
+        required: [["priors"]],
+        taught: "taught",
+        taughtBy: "subagent hand-off copy",
+        parser: "packages/local-graph/src/intent.ts parseShareFence",
+        hint: "```errata-share with priors: all | [h1], [h2]"
+      }
+    ];
+    TAG_VERB_BY_NAME = new Map(
+      TAG_VERBS.filter((v) => v.form === "verb").map((v) => [v.verb, v])
+    );
+    TAG_PAREN_VERBS = [...TAG_VERB_BY_NAME.keys()].sort((a, b) => b.length - a.length);
+    TAG_GRAMMAR_OPENERS = [
+      ...new Set(TAG_VERBS.filter((v) => v.form !== "citation").map((v) => v.opener))
+    ];
+    TAG_QUOTED_PAREN_SOURCE = String.raw`\(\s*(?:${TAG_PAREN_VERBS.map((v) => v.replace(/-/g, "\\-")).join("|")})\s*:|\(\[`;
+    TAG_QUOTED_RE = new RegExp(String.raw`\[[!?]|` + TAG_QUOTED_PAREN_SOURCE, "i");
+    TAG_QUOTED_PAREN_RE = new RegExp(TAG_QUOTED_PAREN_SOURCE, "i");
+    TEMPLATE_VERB_GROUP = new RegExp(
+      String.raw`\(\s*(${TAG_PAREN_VERBS.map((v) => v.replace(/-/g, "\\-")).join("|")})\s*:((?:[^()\n]|\([^()\n]*\))*)\)`,
+      "gi"
+    );
+    BRACKET_TOKEN = /\[([^\]\n]{1,80})\]/g;
+    REAL_HANDLE_SHAPE = new RegExp(
+      String.raw`^(?:[a-z0-9]+(?:-[a-z0-9]+)*-(?=[0-9a-f]{0,3}\d)[0-9a-f]{4}|(?:${TAG_CANONICAL_ID_PREFIXES.join("|")})_[0-9a-f]{6,})$`,
+      "i"
+    );
+    TAG_TEMPLATES = deriveTagTemplates(tagGrammarCopy());
+    VERB_WORDS_SOURCE = TAG_PAREN_VERBS.map((v) => v.replace(/-/g, "\\-")).join("|");
+    JOINED_VERB = new RegExp(String.raw`[,;]\s*(?=(?:${VERB_WORDS_SOURCE})\s*:)`, "i");
+    LEADING_VERB = new RegExp(String.raw`^\s*(${VERB_WORDS_SOURCE})\s*:`, "i");
+    ANY_VERB_WORD = new RegExp(String.raw`\b(?:${VERB_WORDS_SOURCE})\s*:`, "gi");
+    QUOTED_TAG_OPENER = new RegExp(String.raw`\(\s*(?:(${VERB_WORDS_SOURCE})\s*:|(?=\[))`, "gi");
+    TAG_VERDICT_TOKENS = {
+      confirm: (id) => TAG_EXAMPLES.confirm(id),
+      refute: (id) => TAG_EXAMPLES.refute(id),
+      failed: (id) => TAG_EXAMPLES.failedCite(id)
+    };
+  }
+});
+
 // ../../packages/local-shared/src/index.ts
 var init_src2 = __esm({
   "../../packages/local-shared/src/index.ts"() {
@@ -18218,6 +18815,7 @@ var init_src2 = __esm({
     init_review();
     init_anchorable();
     init_sqlite_adapter();
+    init_tag_grammar();
   }
 });
 
@@ -26743,7 +27341,7 @@ function renderSnapshot(s) {
         lines.push(`  - previously resolved as: ${g.closed.description.slice(0, 120)} \u2014 \`${g.closed.id}\``);
         if (g.solution) {
           lines.push(
-            `  - the fix on record: ${g.solution.description.slice(0, 120)} \u2014 \`${g.solution.id}\` \xB7 fix still holds \u2192 (confirm:[${g.solution.id}]) \xB7 hitting it again \u2192 flag it (a second independent witness reopens the close)`
+            `  - the fix on record: ${g.solution.description.slice(0, 120)} \u2014 \`${g.solution.id}\` \xB7 fix still holds \u2192 ${TAG_VERDICT_TOKENS.confirm(g.solution.id)} \xB7 hitting it again \u2192 flag it (a second independent witness reopens the close)`
           );
         } else {
           lines.push(
@@ -26840,7 +27438,7 @@ function renderSnapshot(s) {
             `  - still open \u2014 did this work settle it? fixed \u2192 (fix:[${h.id}]) \xB7 not a real problem \u2192 an \`errata-resolved\` block with \`id: ` + h.id + "`, `disposition: false_positive`, `reason: \u2026` \xB7 still open \u2192 say nothing"
           );
         } else if (h.verdict === "foreign") {
-          lines.push(`  - open in another membrane \u2014 not yours to close: (confirm:[${h.id}]) it held \xB7 (refute:[${h.id}] one line why)`);
+          lines.push(`  - open in another membrane \u2014 not yours to close: ${TAG_VERDICT_TOKENS.confirm(h.id)} it held \xB7 ${TAG_VERDICT_TOKENS.refute(h.id)}`);
         }
       }
     }
@@ -26911,7 +27509,7 @@ function renderSnapshot(s) {
         lines.push(`  - \u2713 ${p.description}`);
         for (const s2 of w.priors.solutionsByProblem[p.id] ?? []) {
           lines.push(
-            `    - fixed by: ${s2.description} \u2014 if that fix did NOT hold, refute it: \`(failed:[${s2.id}] what came back)\``
+            `    - fixed by: ${s2.description} \u2014 if that fix did NOT hold, refute it: \`${TAG_VERDICT_TOKENS.failed(s2.id)}\``
           );
         }
       }
@@ -33885,7 +34483,7 @@ function linkBullet(ref) {
     `    \xB7 ${TAG_EXAMPLE.package()} \u2014 the PUBLIC package it's about, dependency or not`,
     `    \xB7 ${TAG_EXAMPLE.component()} \u2014 the framework/product unit`,
     `    \xB7 (aids:[${ref}],\u2026) \u2014 other problems your fix might also resolve (hypothesis)`,
-    `    \xB7 your fix vs a shown solution: (builds-on:[${ref}]) \xB7 (supersedes:[${ref}]) \xB7 (alternative:[h]) \u2014 pick one`
+    `    \xB7 your fix vs a shown solution: ${TAG_EXAMPLE.buildsOn(ref)} \xB7 ${TAG_EXAMPLE.supersedes(ref)} \xB7 ${TAG_EXAMPLE.alternative("h")} \u2014 pick one`
   ].join("\n");
 }
 function verdictBullet(ref) {
@@ -33916,75 +34514,13 @@ function buildAgentInstruction(opts = {}) {
     tail
   ].join("\n");
 }
-var TAG_EXAMPLE, TAG_OPENERS, GLOSS;
+var TAG_EXAMPLE, TAG_OPENERS, GLOSS, ALL_SIGNALS, TAG_TEMPLATES2;
 var init_agent_signals = __esm({
   "src/agent-signals.ts"() {
     "use strict";
-    TAG_EXAMPLE = {
-      prior: (ref) => `([${ref}])`,
-      problem: () => `[!one line on what's wrong]`,
-      vulnerability: () => `[!vuln: who can do what; observed basis @ path:line]`,
-      suspectedVulnerability: () => `[?vuln: consequence; missing check]`,
-      vulnerabilityThread: () => `[!#v vuln: finding here]`,
-      fix: (ref) => `(fix:[${ref}])`,
-      // CONSTRAINT — the native capture path for a DIFFUSE problem (a constraint/tension/
-      // conflict that shaped a decision). Free text, attaches to the decision sentence the
-      // agent is already writing. Full rationale in the constraint note below + prior-tags.ts.
-      constraint: () => `(constraint: the limitation that forced it)`,
-      // TRIAGE — routes the problem/symptom in scope to its cause. `(cause:[handle])`
-      // links to a cited RootCause/Solution node; `(cause: free text)` mints a RootCause
-      // from the text. Harvested in prior-tags.ts → engine.ts (see the triage note below).
-      triage: (ref) => `(cause:[${ref}])`,
-      // Unlike a bare cause citation, this handle names the Problem being explained.
-      triageExplain: (ref) => `(cause:[${ref}] the mechanism)`,
-      // The MINT form — free-text cause that mints a RootCause. Prime-time surfacing
-      // (recallForFile) pastes this next to an open Problem that has no cause yet, so the
-      // diagnostic moment is cued when the agent is looking at the problem. Kept here so
-      // the grammar can't drift from parseInlineTags' `(cause: …)` acceptance.
-      triageMint: () => `(cause: why it happens)`,
-      // THREAD forms — the witness-declared symptom↔cause/fix binding. A `#id` on the
-      // flag names the diagnosis thread; the same `#id` on a later verb binds to it
-      // explicitly (across sentences AND turns), replacing proximity guessing. Adjacent
-      // tags never need one — the id is for diagnoses that unfold over distance.
-      problemThread: () => `[!#slug one line on what's wrong]`,
-      causeThread: () => `(cause:#slug the mechanism)`,
-      fixThread: (thread = "slug") => `(fix:#${thread} what you changed)`,
-      // ATTEMPT arc — what's being tried and what didn't work. A failed attempt is a
-      // witnessed NEGATIVE result: it saves the next agent the same dead end.
-      tried: () => `(tried: the approach you're attempting)`,
-      failed: () => `(failed: what didn't work and the dead end it rules out)`,
-      // LINK verbs (AC epic) — bind the problem in scope to CANONICAL priors and
-      // abstractions. Multi-target by design: single links are weak; ~3 links to 3
-      // DIFFERENT relevant priors is the target shape (see linkBullet).
-      instance: (ref) => `(instance:[${ref}],[another],[a-third])`,
-      pattern: () => `(pattern: name the general shape)`,
-      // DOMAIN — the abstract area a problem is about; the concept layer an
-      // anchor-less problem clusters on. Mints/resolves a Domain by name.
-      domain: () => `(domain: The Area)`,
-      // PACKAGE/COMPONENT — agent-named public anchors (OM-agent-anchors): the
-      // package a problem is ABOUT (even when not a dependency) and the
-      // framework/product-level unit it concerns. Public spine anchors → the
-      // knowledge can cross to the collective.
-      package: () => `(package: the-package-name)`,
-      component: () => `(component: The Component)`,
-      aids: (ref) => `(aids:[${ref}])`,
-      // VERDICT (VS-verdict-tags) — a judgment on a SHOWN prior, distinct from leaning on it.
-      // `confirm` rides the corroborate channel (it held); `refute` the contradict channel
-      // (it's wrong / didn't hold) and REQUIRES a reason. This is the inline producer the
-      // evidence channels lacked — refute sat dead (contradictionPressure 0) until now, while
-      // lean-on corroboration lived, because only corroboration had an inline path. Grammar
-      // single-sourced with parseInlineTags' CONFIRM_PREFIX/REFUTE_PREFIX.
-      confirm: (ref) => `(confirm:[${ref}])`,
-      refute: (ref) => `(refute:[${ref}] one line why)`,
-      // RETRACT — "not a real problem": the errata-resolved block with a disposition
-      // (parseDesignResolutions, turn.ts). No inline form exists; the block is the grammar.
-      retract: (id) => ["```errata-resolved", `id: ${id}`, "disposition: false_positive", "reason: why it was never a real problem", "```"].join("\n")
-    };
-    TAG_OPENERS = [
-      ...new Set(
-        Object.values(TAG_EXAMPLE).map((example) => /^(\([a-z][\w-]*:|\[[!?])/i.exec(example("x"))?.[1]?.toLowerCase()).filter((opener) => opener !== void 0)
-      )
-    ];
+    init_src2();
+    TAG_EXAMPLE = TAG_EXAMPLES;
+    TAG_OPENERS = TAG_GRAMMAR_OPENERS;
     GLOSS = {
       prior: "a shown prior helped, or you work in a primed language/package",
       // "even in code you just wrote" names the implementation phase explicitly. Field
@@ -34021,6 +34557,12 @@ var init_agent_signals = __esm({
       link: "the problem you flagged is an instance of priors/abstractions you can name \u2014 (instance:[h1],[h2],\u2026) / (pattern: \u2026) / (aids:[h]); rendered whole via linkBullet",
       verdict: "you can judge a prior we SHOWED you \u2014 confirm it if it held, refute it (with why) if it didn't; rendered whole via verdictBullet"
     };
+    ALL_SIGNALS = ["prior", "problem", "vulnerability", "domain", "fix", "constraint", "triage", "attempt", "link", "verdict"];
+    TAG_TEMPLATES2 = deriveTagTemplates([
+      ...tagGrammarCopy(),
+      ...["its-handle", "its-id"].map((referent) => buildAgentInstruction({ signals: ALL_SIGNALS, referent })),
+      buildFileRecallInstruction()
+    ]);
   }
 });
 
@@ -35553,7 +36095,13 @@ function summaryFromDoc(doc, kind) {
   }
   if (verb !== null) return null;
   const noun = clipped.replace(/^(?:the|a|an)\s+/i, "");
-  return tidy(`${lead(kind)} for ${noun.charAt(0).toLowerCase()}${noun.slice(1)}`);
+  const head2 = noun.split(/[\s-]/, 1)[0].replace(/[.,;:!?]+$/, "");
+  return tidy(`${lead(kind)} for ${isOrdinaryCapital(head2) ? noun.charAt(0).toLowerCase() + noun.slice(1) : noun}`);
+}
+function isOrdinaryCapital(word) {
+  const contraction = /^([A-Za-z]+)['’]s$/.exec(word);
+  if (contraction) return CONTRACTION_BASES.has(contraction[1].toLowerCase()) && /^[A-Z][a-z]*$/.test(contraction[1]);
+  return /^[A-Z][a-z]+$/.test(word);
 }
 function summaryFromName(name2, kind) {
   if (!NAME_DERIVED_ENABLED) return null;
@@ -35575,7 +36123,7 @@ function summaryCandidates(name2, kind, doc) {
   if (fromName !== null && fromName !== fromDoc) candidates.push(fromName);
   return candidates;
 }
-var NAME_DERIVED_ENABLED, KIND_ARTICLE, lead, MAX_PAYLOAD_CHARS, DANGLING, VERBS, tidy, VERB_PHRASE_KINDS;
+var NAME_DERIVED_ENABLED, KIND_ARTICLE, lead, MAX_PAYLOAD_CHARS, DANGLING, VERBS, tidy, CONTRACTION_BASES, VERB_PHRASE_KINDS;
 var init_derive_summary = __esm({
   "src/derive-summary.ts"() {
     "use strict";
@@ -35858,6 +36406,7 @@ var init_derive_summary = __esm({
       "yield"
     ]);
     tidy = (s) => s.replace(/\s+/g, " ").replace(/\s+([,.;:])/g, "$1").replace(/[\s,;:.]+$/, "").trim();
+    CONTRACTION_BASES = /* @__PURE__ */ new Set(["it", "that", "this", "there", "here", "what", "who", "where", "when", "why", "how", "let", "he", "she"]);
     VERB_PHRASE_KINDS = /* @__PURE__ */ new Set(["function", "method"]);
   }
 });
@@ -79553,26 +80102,14 @@ init_src5();
 import { readFileSync as readFileSync18, writeFileSync as writeFileSync14 } from "node:fs";
 var NEG = /n['']t|\b(?:not|never|no|none|neither|nor|unrelated|irrelevant|would|might|could|if)\b/i;
 var CITE_GROUP_RE = /\(((?:[^()\n]|\([^()\n]*\)){1,200})\)/g;
-var HANDLE_RE2 = /\[([a-z0-9][\w-]{0,80})\]|((?:pat|sol|drc|dcause|dfix|dprob|dvuln|prob|claim|err)_[0-9a-f]{6,})/gi;
-var PLACEHOLDER_HANDLES = /* @__PURE__ */ new Set([
-  "handle",
-  "its-handle",
-  "another",
-  "a-third",
-  "h",
-  "h1",
-  "h2",
-  "id",
-  "its-id",
-  "a",
-  "b"
-]);
+var HANDLE_RE2 = new RegExp(TAG_HANDLE_SOURCE, "gi");
+var PLACEHOLDER_HANDLES = TAG_PLACEHOLDER_HANDLES;
 var isPlaceholderHandle = (h) => PLACEHOLDER_HANDLES.has(h.toLowerCase());
 var FLAG_BODY_HANDLE_RE = /^(?:[a-z0-9]+(?:-[a-z0-9]+){2,}-(?=[0-9a-f]{0,3}\d)[0-9a-f]{4}|(?:pat|sol|drc|dcause|dfix|dprob|dvuln|prob|claim|err)_[0-9a-f]{6,})$/i;
 var FIX_PREFIX = /^\s*fix:(?:#([a-z][\w-]{0,63}))?\s*/i;
-var CONSTRAINT_RE = /\(\s*constraint:\s*([^()\n]{8,}?)\s*\)/gi;
 var CAUSE_PREFIX = /^\s*cause:(?:#([a-z][\w-]{0,63}))?\s*/i;
 var NEST2_UNIT = String.raw`(?:[^()\n]|\((?:[^()\n]|\([^()\n]*\))*\))`;
+var CONSTRAINT_RE = new RegExp(String.raw`\(\s*constraint:\s*(${NEST2_UNIT}{8,}?)\s*\)`, "gi");
 var FIX_LONG_RE = new RegExp(String.raw`\(\s*fix:(?:#([a-z][\w-]{0,63}))?\s*(${NEST2_UNIT}{12,}?)\s*\)`, "gi");
 var CAUSE_LONG_RE = new RegExp(String.raw`\(\s*cause:(?:#([a-z][\w-]{0,63}))?\s*(${NEST2_UNIT}{8,}?)\s*\)`, "gi");
 var CONFIRM_LONG_RE = new RegExp(String.raw`\(\s*confirm:\s*(${NEST2_UNIT}{4,}?)\s*\)`, "gi");
@@ -79588,7 +80125,7 @@ var BRACKETED_TOKEN_RE = /\[[^\]\n]{1,120}\]/;
 var CONFIRM_PREFIX = /^\s*confirm:\s*/i;
 var REFUTE_PREFIX = /^\s*refute:\s*/i;
 var REFUTE_REASON_MIN = 4;
-var PATTERN_RE = /\(\s*pattern:\s*([^()\n]{3,}?)\s*\)/gi;
+var PATTERN_RE = new RegExp(String.raw`\(\s*pattern:\s*(${NEST2_UNIT}{3,}?)\s*\)`, "gi");
 var DOMAIN_RE = /\(\s*domain:\s*([^()\n]{2,}?)\s*\)/gi;
 var PACKAGE_RE = /\(\s*package:\s*([^()\n]{2,}?)\s*\)/gi;
 var COMPONENT_RE = /\(\s*component:\s*([^()\n]{2,}?)\s*\)/gi;
@@ -79681,6 +80218,10 @@ function deriveFixRationale(sentence, startIdx, endIdx) {
   if (before.length >= FIX_RATIONALE_MIN) return before;
   return fixRationaleAfter(sentence, endIdx);
 }
+var TAG_GROUP_OPENER_RE = new RegExp(
+  TAG_OPENERS.filter((o) => o.startsWith("(")).map((o) => String.raw`\(\s*${o.slice(1, -1).replace(/-/g, "\\-")}\s*:`).join("|"),
+  "gi"
+);
 var LEADING_OPENER_RE = new RegExp(String.raw`^(?:${RESIDUAL_OPENER_RE.source})(?:#[a-z][\w-]{0,63})?\s*`, "i");
 var WRAPPER_PAIRS = [["(", ")"], ["[", "]"]];
 var LEADING_HANDLES_RE = /^(?:\[[a-z0-9][\w-]{0,80}\]\s*,?\s*)+/i;
@@ -79819,19 +80360,41 @@ function addTagDispositions(a, b) {
 function parseInlineTags(text) {
   return parseInlineTagsWithDispositions(text).tags;
 }
+function tagGroupSpans(line) {
+  const spans = [];
+  let after = 0;
+  for (const m of line.matchAll(TAG_GROUP_OPENER_RE)) {
+    const start2 = m.index;
+    if (start2 < after) continue;
+    let depth = 0;
+    const limit = Math.min(line.length, start2 + 4e3);
+    for (let i2 = start2; i2 < limit; i2++) {
+      if (line[i2] === "(") depth++;
+      else if (line[i2] === ")" && --depth === 0) {
+        spans.push({ start: start2, end: i2 + 1 });
+        after = i2 + 1;
+        break;
+      }
+    }
+  }
+  return spans;
+}
 function* captureSentences(text) {
   for (const line of text.split(/\n+/)) {
     if (line.length > 2e4) {
       yield line;
       continue;
     }
-    const flags2 = [...flagScanView(line).matchAll(new RegExp(FLAG_RE.source, FLAG_RE.flags))].map((m) => ({ start: m.index, end: m.index + m[0].length }));
+    const flags2 = [
+      ...[...flagScanView(line).matchAll(new RegExp(FLAG_RE.source, FLAG_RE.flags))].map((m) => ({ start: m.index, end: m.index + m[0].length })),
+      ...tagGroupSpans(line)
+    ].sort((a, b) => a.start - b.start);
     let flag = 0;
     let start2 = 0;
     for (const boundary of line.matchAll(/(?<=[.!?])\s+(?!\(fix:)/g)) {
       const index = boundary.index;
       while (flags2[flag] && flags2[flag].end <= index) flag++;
-      if (flags2[flag] && flags2[flag].start < index) continue;
+      if (flags2.slice(flag).some((f) => f.start < index && index < f.end)) continue;
       yield line.slice(start2, index);
       start2 = index + boundary[0].length;
     }
@@ -79850,22 +80413,28 @@ function parseInlineTagsWithDispositions(text) {
       continue;
     }
     const seqStart = out2.length;
-    const sentence = raw2.replace(/`[^`]*`/g, (m) => {
-      if (!/\[[!?]|\((?:fix|cause|constraint|tried|failed|confirm|refute):|\(\[/.test(m)) return m;
-      if (!/\((?:fix|cause|constraint|tried|failed|confirm|refute):|\(\[/.test(m)) {
+    const original = raw2;
+    const flagView = flagScanView(raw2);
+    const flagSpans = [...flagView.matchAll(new RegExp(FLAG_RE.source, FLAG_RE.flags))].map((m) => [m.index, m.index + m[0].length]);
+    const sentence = raw2.replace(/`[^`]*`/g, (m, at) => {
+      if (!TAG_QUOTED_RE.test(m)) return m;
+      if (!TAG_QUOTED_PAREN_RE.test(m)) {
         dispositions.codeSpanNeutralized++;
         return m;
       }
+      const inFlag = flagSpans.some(([a2, b]) => a2 < at && at < b);
+      if (!inFlag && !/\[[!?]/.test(m) && !quotesOnlyTemplateTags(m, TAG_TEMPLATES2)) return m;
       dispositions.codeSpanNeutralized++;
-      return " ";
+      return m.replace(/[()[\]]/g, " ");
     });
-    const sfield = sentence.replace(/\s+/g, " ").trim().slice(0, 160);
+    const sfield = raw2.replace(/\s+/g, " ").trim().slice(0, 160);
     const citeMatched = /* @__PURE__ */ new Set();
-    const flagSpans = [...flagScanView(sentence).matchAll(new RegExp(FLAG_RE.source, FLAG_RE.flags))].map((m) => [m.index, m.index + m[0].length]);
+    const codeOnly = [...sentence.matchAll(/`[^`]*`/g)].filter((m) => !TAG_QUOTED_PAREN_RE.test(m[0])).map((m) => [m.index, m.index + m[0].length]);
     CITE_GROUP_RE.lastIndex = 0;
     let g;
     while ((g = CITE_GROUP_RE.exec(sentence)) !== null) {
       citeMatched.add(g.index);
+      if (codeOnly.some(([a2, b]) => a2 < g.index && g.index < b)) continue;
       let content = g[1];
       if (/^\s*pattern:/i.test(content)) continue;
       if (/^\s*failed:/i.test(content)) continue;
@@ -79950,6 +80519,7 @@ function parseInlineTagsWithDispositions(text) {
       let h;
       let emittedHandle = false;
       while ((h = HANDLE_RE2.exec(content)) !== null) {
+        if (content[h.index + h[0].length] === "(") continue;
         const handle2 = h[1] ?? h[2];
         if (handle2 && isPlaceholderHandle(handle2)) {
           dispositions.placeholderEcho++;
@@ -80055,10 +80625,9 @@ function parseInlineTagsWithDispositions(text) {
       }
     }
     FLAG_RE.lastIndex = 0;
-    const flagView = flagScanView(sentence);
     let f;
     while ((f = FLAG_RE.exec(flagView)) !== null) {
-      f[3] = sentence.slice(...f.indices[3]);
+      f[3] = original.slice(...f.indices[3]);
       const flagThread = f[2];
       const raw3 = f[3].trim();
       if (/^vuln\b/i.test(raw3)) {
@@ -85217,7 +85786,7 @@ function createWatchBreaker(deps) {
 }
 
 // src/engine.ts
-var DAEMON_VERSION = true ? "2.0.22-dev.4130" : "2.0.0-alpha.0";
+var DAEMON_VERSION = true ? "2.0.22-dev.4148" : "2.0.0-alpha.0";
 var IGNORED_PATH = /[\\/](?:\.git|node_modules|\.errata|\.claude|\.codex|\.cursor|\.turbo|\.next|dist|coverage|test-results|playwright-report|__pycache__)(?:[\\/]|$)/;
 var IGNORED_NOISE = /castalia\.db|eventlog\.sqlite|turn-cursors/;
 var GIT_OP_MUTE_MS = 4e3;