typebulb 0.39.2 → 0.40.0

package/dist/agents/pi/matchu-patchu.ts

@@ -5,7 +5,7 @@ import { existsSync, readFileSync, writeFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { Type } from "typebox";
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/utils/textUtils.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/utils/textUtils.js
 var TextUtils = class _TextUtils {
   static NormalizeToLf(text) {
     return (text ?? "").replace(/\r\n/g, "\n").replace(/\r/g, "\n");
@@ -89,6 +89,36 @@ var TextUtils = class _TextUtils {
       return false;
     return cp < 32 || cp >= 127 && cp <= 159 || cp === 173 || cp === 1564 || cp === 6158 || cp >= 8203 && cp <= 8207 || cp >= 8234 && cp <= 8238 || cp >= 8288 && cp <= 8292 || cp >= 8294 && cp <= 8297 || cp === 65279;
   }
+  // En/em dashes are exempt from the audit: this authoring stack emits them in all
+  // comment prose, so warning on them fires on nearly every apply and trains readers
+  // to skip the audit (warning-blindness). They stay in the homoglyph table, so match
+  // tolerance is unchanged. Curly quotes still warn: the motivating mangle was a quote
+  // lookalike inside code, and prose here uses straight quotes — a curly quote is more
+  // likely damage than intent.
+  static IsIntentionalTypography(c) {
+    const cp = c.codePointAt(0);
+    return cp === 8211 || cp === 8212;
+  }
+  /// <summary>Names the invisible/lookalike code points in the given lines, or null if
+  /// there are none. Escape mangling at a tool-call boundary writes unintended bytes
+  /// silently; intent is unrecoverable afterwards, so the audit states the facts (which
+  /// code point, what it resembles, how many) and leaves the judgment to the caller.
+  /// </summary>
+  static DescribeSuspectCodePoints(lines) {
+    const counts = /* @__PURE__ */ new Map();
+    for (const line of lines)
+      for (const c of line)
+        if (_TextUtils.IsInvisible(c) || _TextUtils.MapHomoglyph(c) !== c && !_TextUtils.IsIntentionalTypography(c))
+          counts.set(c, (counts.get(c) ?? 0) + 1);
+    if (counts.size === 0)
+      return null;
+    return [...counts.entries()].sort((a, b) => a[0].codePointAt(0) - b[0].codePointAt(0)).map(([c, n]) => {
+      const mapped = _TextUtils.MapHomoglyph(c);
+      const what = _TextUtils.IsInvisible(c) ? "invisible" : mapped === " " ? "looks like a space" : `looks like ${mapped}`;
+      const hex = c.codePointAt(0).toString(16).toUpperCase().padStart(4, "0");
+      return `U+${hex} (${what}) x${n}`;
+    }).join(", ");
+  }
   /// <summary>Round-trip variant that accepts updated LF lines.</summary>
   static RoundTripWhitespace(originalSnapshot, updatedLines) {
     const joined = updatedLines.join("\n");
@@ -103,7 +133,7 @@ var TextUtils = class _TextUtils {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/utils/arrayUtils.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/utils/arrayUtils.js
 var ArrayUtils = class {
   /// <summary>
   /// Groups items by key, preserving first-seen key order (like LINQ's GroupBy).
@@ -141,7 +171,7 @@ var ArrayUtils = class {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/models.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/models.js
 var PatchInputFile = class {
   Key;
   InputFullText;
@@ -179,10 +209,8 @@ var PatchOutputFile = class {
   OutputFullText;
   Errors;
   AlreadyAppliedCount;
-  CollapsedMarkerLines;
-  TruncationSuspected;
-  ControlCharsSuspected;
-  constructor(Key, Fuzz, Edits, InputSelectedText, InputFullText, OutputFullText, Errors, AlreadyAppliedCount = 0, CollapsedMarkerLines = [], TruncationSuspected = false, ControlCharsSuspected = false) {
+  Notices;
+  constructor(Key, Fuzz, Edits, InputSelectedText, InputFullText, OutputFullText, Errors, AlreadyAppliedCount = 0, Notices = []) {
     this.Key = Key;
     this.Fuzz = Fuzz;
     this.Edits = Edits;
@@ -191,9 +219,7 @@ var PatchOutputFile = class {
     this.OutputFullText = OutputFullText;
     this.Errors = Errors;
     this.AlreadyAppliedCount = AlreadyAppliedCount;
-    this.CollapsedMarkerLines = CollapsedMarkerLines;
-    this.TruncationSuspected = TruncationSuspected;
-    this.ControlCharsSuspected = ControlCharsSuspected;
+    this.Notices = Notices;
   }
 };
 var PatchOutput = class {
@@ -295,9 +321,11 @@ var DiffLocation = class {
 var FileHunkGroup = class {
   Key;
   Hunks;
-  constructor(Key, Hunks) {
+  ContextOnlyHunkLines;
+  constructor(Key, Hunks, ContextOnlyHunkLines = []) {
     this.Key = Key;
     this.Hunks = Hunks;
+    this.ContextOnlyHunkLines = ContextOnlyHunkLines;
   }
 };
 var Chunk = class _Chunk {
@@ -369,7 +397,7 @@ var UniqueMatch = class _UniqueMatch {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/utils/yaml.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/utils/yaml.js
 var Yaml = class _Yaml {
   _sb = [];
   // -------- Public API --------
@@ -426,7 +454,7 @@ var Yaml = class _Yaml {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/exceptions.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/exceptions.js
 var PatchException = class extends Error {
   Error;
   constructor(error) {
@@ -488,7 +516,7 @@ ${this.SuggestedFixYaml}`;
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/applier/guards.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/applier/guards.js
 var DuplicateGuard = class _DuplicateGuard {
   // Two chunks that resolve to the same anchor with the same deletes and inserts are
   // provably the same edit (an LLM re-emitting a hunk). Applying it once is
@@ -538,7 +566,7 @@ var OverlapGuard = class {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/applier/editMinimizer.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/applier/editMinimizer.js
 var EditMinimizer = class _EditMinimizer {
   static Same(a, b) {
     return a === b;
@@ -572,7 +600,7 @@ var EditMinimizer = class _EditMinimizer {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/applier/indenter.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/applier/indenter.js
 var Anchor = class {
   BaseIndent;
   Shift;
@@ -663,7 +691,7 @@ var Indenter = class _Indenter {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/applier/matchHint.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/applier/matchHint.js
 var MatchHint = class _MatchHint {
   // A quoted line inside exactly one longer file line is the prose line-model
   // mistake: the author's "line" (a sentence of an unwrapped paragraph, or a
@@ -696,7 +724,7 @@ var MatchHint = class _MatchHint {
   static MinHintLineContent = 12;
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/applier/chunkApplier.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/applier/chunkApplier.js
 var InputChunks = class {
   InputFullText;
   Chunks;
@@ -765,7 +793,7 @@ var ChunkApplier = class _ChunkApplier {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/parser/heuristics.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/parser/heuristics.js
 var DiffContentHeuristics = class _DiffContentHeuristics {
   /**
    * Checks if a line starts with a doubled marker (++ or --)
@@ -990,7 +1018,7 @@ var DiffContentHeuristics = class _DiffContentHeuristics {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/parser/hunkBuilder.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/parser/hunkBuilder.js
 var Header = class _Header {
   Path;
   OldStart;
@@ -1033,12 +1061,25 @@ var HunkBuilder = class _HunkBuilder {
   ClearTruncation() {
     this.LastHunkTruncated = false;
   }
+  // Diff line of the first @@-headed body with real content but no change lines.
+  // Such a hunk can never be intentional (its '+'/'-' markers were lost, and the
+  // loss is ambiguous — adds or deletes?), so the parser rejects the whole diff
+  // instead of silently dropping it. Bodies outside any hunk (prose before or
+  // after a diff) and blank-only bodies keep flowing through silently.
+  // Diff line of each @@-headed body that had real content but no change lines. Such a
+  // hunk states no change, so it is skipped and its siblings apply — but the lines are
+  // surfaced so the caller can name the skip rather than report a clean success. Bodies
+  // outside any hunk (prose before or after a diff) and blank-only bodies are not hunks
+  // at all and are never recorded.
+  ContextOnlyHunkLines = [];
   CommitIfAny(hdr, body, fileLines) {
     if (body.length == 0)
       return;
     const blankContextDeletion = _HunkBuilder.IsBlankContextDeletion(hdr.OldCount, hdr.NewCount, body);
     if (!blankContextDeletion && !body.some((l) => l.length > 0 && (l[0] == "-" || l[0] == "+"))) {
       this.LastHunkTruncated = false;
+      if (hdr.DiffBodyStartLine >= 0 && body.some((l) => l.trim().length > 0))
+        this.ContextOnlyHunkLines.push(hdr.DiffBodyStartLine);
       body.length = 0;
       return;
     }
@@ -1198,7 +1239,7 @@ ${h.NewText}`;
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/parser/unifiedDiffParser.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/parser/unifiedDiffParser.js
 var UnifiedDiffParser = class _UnifiedDiffParser {
   /**
    * Parse a unified diff into structured hunks.
@@ -1208,21 +1249,25 @@ var UnifiedDiffParser = class _UnifiedDiffParser {
    * @param controlChars - Verdict for raw control characters in insert lines
    */
   static Parse(diff, files, truncation = "warn", controlChars = "error") {
-    const hunks = diff == null || diff.trim().length == 0 ? [] : _UnifiedDiffParser.ParseHunks(diff, files, truncation, controlChars);
+    const parsed = diff == null || diff.trim().length == 0 ? { Hunks: [], ContextOnlyLines: [] } : _UnifiedDiffParser.ParseHunks(diff, files, truncation, controlChars);
+    const hunks = parsed.Hunks;
+    const ctxOnly = parsed.ContextOnlyLines;
     const fileKeySet = new Set(files.keys());
     const headerless = hunks.filter((h) => h.Key == null || h.Key == "");
     const explicitKnown = hunks.filter((h) => h.Key != null && h.Key != "" && fileKeySet.has(h.Key));
     const explicitFallback = hunks.filter((h) => h.Key != null && h.Key != "" && !fileKeySet.has(h.Key));
     const groups = [];
     if (headerless.length > 0)
-      groups.push(new FileHunkGroup("", headerless));
+      groups.push(new FileHunkGroup("", headerless, ctxOnly));
     if (explicitKnown.length > 0)
-      ArrayUtils.GroupBy(explicitKnown, (h) => h.Key).map((g) => new FileHunkGroup(g.key, g.values)).forEach((x) => groups.push(x));
+      ArrayUtils.GroupBy(explicitKnown, (h) => h.Key).map((g) => new FileHunkGroup(g.key, g.values, ctxOnly)).forEach((x) => groups.push(x));
     const treatAsSingleFile = fileKeySet.size == 1 && fileKeySet.has("") && explicitKnown.length == 0 && headerless.length == 0 && Array.from(new Set(explicitFallback.map((h) => h.Key))).length == 1;
     if (treatAsSingleFile && explicitFallback.length > 0)
-      groups.push(new FileHunkGroup("", explicitFallback));
+      groups.push(new FileHunkGroup("", explicitFallback, ctxOnly));
     else if (explicitFallback.length > 0)
-      ArrayUtils.GroupBy(explicitFallback, (h) => h.Key).map((g) => new FileHunkGroup(g.key, g.values)).forEach((x) => groups.push(x));
+      ArrayUtils.GroupBy(explicitFallback, (h) => h.Key).map((g) => new FileHunkGroup(g.key, g.values, ctxOnly)).forEach((x) => groups.push(x));
+    if (groups.length == 0 && ctxOnly.length > 0)
+      groups.push(new FileHunkGroup("", [], ctxOnly));
     return groups;
   }
   static ParseHunks(diff, fileContents, truncation = "warn", controlChars = "error") {
@@ -1252,6 +1297,7 @@ var UnifiedDiffParser = class _UnifiedDiffParser {
       if (inFence && line.startsWith("```")) {
         hunkBuilder.CommitIfAny(header, body, currentFileLines);
         hunkBuilder.ClearTruncation();
+        header.DiffBodyStartLine = -1;
         inFence = false;
         inHunkBody = false;
         continue;
@@ -1294,7 +1340,7 @@ var UnifiedDiffParser = class _UnifiedDiffParser {
         hunk.ControlCharsSuspected = true;
       }
     }
-    return hunks;
+    return { Hunks: hunks, ContextOnlyLines: hunkBuilder.ContextOnlyHunkLines };
   }
   static IsSuspectControlChar(c) {
     const cp = c.charCodeAt(0);
@@ -1437,7 +1483,7 @@ var UnifiedDiffParser = class _UnifiedDiffParser {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/anchorer/hunkSlicer.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/anchorer/hunkSlicer.js
 var Block = class {
   StartIndex;
   EndIndex;
@@ -1490,7 +1536,7 @@ var HunkSlicer = class _HunkSlicer {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/anchorer/search.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/anchorer/search.js
 var Match = class {
   LineIndex;
   Fuzz;
@@ -1628,7 +1674,7 @@ var Search = class _Search {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/anchorer/blockAnchorer.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/anchorer/blockAnchorer.js
 var BlockAnchorer = class _BlockAnchorer {
   static AnchorBlocks(hunk, blocks, lines, options) {
     return blocks.map((focus, index) => {
@@ -1746,7 +1792,7 @@ var BlockAnchorer = class _BlockAnchorer {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/anchorer/hunkAnchorer.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/anchorer/hunkAnchorer.js
 var AnchorOutcome = class {
   Chunks;
   AlreadyAppliedCount;
@@ -1762,7 +1808,7 @@ var HunkAnchorer = class _HunkAnchorer {
     const chunks = [];
     for (const sliced of slicedHunks)
       for (const chunk of BlockAnchorer.AnchorBlocks(sliced.Hunk, sliced.Blocks, lines, options))
-        chunks.push(_HunkAnchorer.UseFallbackAnchorIfNecessary(sliced.Hunk, chunk, lines.length));
+        chunks.push(_HunkAnchorer.UseFallbackAnchorIfNecessary(sliced.Hunk, chunk, lines, slicedHunks.length == 1));
     const deleteCounts = /* @__PURE__ */ new Map();
     for (const l of chunks.flatMap((c) => c.DeleteLines))
       if (l.trim().length > 0)
@@ -1771,8 +1817,12 @@ var HunkAnchorer = class _HunkAnchorer {
     const kept = chunks.filter((c) => !_HunkAnchorer.AppliedAtAnchor(lines, c) && (c.InsertLines.some((l) => movedFromElsewhere(c, l)) || !_HunkAnchorer.AlreadyApplied(lines, c))).map((c) => _HunkAnchorer.TrySubLineSplice(c, lines));
     return new AnchorOutcome(kept, chunks.length - kept.length);
   }
-  static UseFallbackAnchorIfNecessary(hunk, chunk, lineCount) {
+  static UseFallbackAnchorIfNecessary(hunk, chunk, lines, soleHunk) {
+    const lineCount = lines.length;
     if (chunk.Match.IsNotFound && hunk.Lines.length == chunk.InsertLines.length) {
+      const targetIsEmpty = lineCount == 0 || lineCount == 1 && lines[0].length == 0;
+      if (hunk.OldStart < 0 && !soleHunk && !targetIsEmpty)
+        return chunk;
       const anchorLine = hunk.OldStart <= 1 ? 0 : hunk.OldStart;
       if (anchorLine > lineCount)
         return chunk;
@@ -1914,7 +1964,7 @@ var HunkAnchorer = class _HunkAnchorer {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/selectionTarget.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/selectionTarget.js
 var SelectionTarget = class {
   FullText;
   SelectedText;
@@ -1946,7 +1996,7 @@ var SelectionTarget = class {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/parser/sanitizers/shared.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/parser/sanitizers/shared.js
 function isDiffMarker(line) {
   return line.startsWith("--- ") || line.startsWith("+++ ") || line.startsWith("@@") || line.startsWith("diff --git");
 }
@@ -2003,7 +2053,7 @@ function isLikelyFileHeader(trimmed) {
   return trimmed.startsWith("diff --git") || (trimmed.startsWith("--- ") || trimmed.startsWith("+++ ")) && (trimmed.includes(".") || trimmed.includes("/") || trimmed.includes("\\"));
 }
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/parser/sanitizers/customFormatSanitizer.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/parser/sanitizers/customFormatSanitizer.js
 var CustomFormatSanitizer = class _CustomFormatSanitizer {
   static OPERATIONS = [
     { header: /^\s*\*\*\* Update File: (.+)$/i, fromPath: (p) => `a/${p}`, toPath: (p) => `b/${p}` },
@@ -2028,7 +2078,7 @@ var CustomFormatSanitizer = class _CustomFormatSanitizer {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/parser/sanitizers/decoratedHeaderSanitizer.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/parser/sanitizers/decoratedHeaderSanitizer.js
 var DecoratedHeaderSanitizer = class _DecoratedHeaderSanitizer {
   static DECORATED_HEADER_REGEX = /^(---|\+\+\+)\s+(.+?)\s+(---|\+\+\+)+\s*$/;
   static process(text) {
@@ -2041,7 +2091,7 @@ var DecoratedHeaderSanitizer = class _DecoratedHeaderSanitizer {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/parser/sanitizers/decorativeMarkerSanitizer.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/parser/sanitizers/decorativeMarkerSanitizer.js
 var DecorativeMarkerSanitizer = class _DecorativeMarkerSanitizer {
   static process(text) {
     return transformOutsideHunkBodies(text, (line) => _DecorativeMarkerSanitizer.isDecorativeMarker(line.trim()) ? null : line);
@@ -2062,14 +2112,14 @@ var DecorativeMarkerSanitizer = class _DecorativeMarkerSanitizer {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/parser/sanitizers/backtickSanitizer.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/parser/sanitizers/backtickSanitizer.js
 var BacktickSanitizer = class {
   static process(text) {
     return text.replace(/^```+\s*diff\b/gmi, "```diff").replace(/^```+$/gm, "```");
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/parser/sanitizers/diffBlockReunifier.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/parser/sanitizers/diffBlockReunifier.js
 var DiffBlockReunifier = class {
   static process(text) {
     const lines = text.split("\n");
@@ -2105,7 +2155,7 @@ var DiffBlockReunifier = class {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/parser/sanitizers/devNullSanitizer.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/parser/sanitizers/devNullSanitizer.js
 var DevNullSanitizer = class {
   static process(text, fileKeys) {
     if (!fileKeys?.length)
@@ -2148,7 +2198,7 @@ var DevNullSanitizer = class {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/parser/sanitizers/prefixInjector.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/parser/sanitizers/prefixInjector.js
 var PrefixInjector = class {
   static process(text) {
     const lines = text.split("\n");
@@ -2207,7 +2257,7 @@ var PrefixInjector = class {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/parser/diffSanitizer.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/parser/diffSanitizer.js
 var DiffSanitizer = class {
   static Process(diff, fileKeys) {
     if (!diff?.trim())
@@ -2223,7 +2273,7 @@ var DiffSanitizer = class {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/headerlessRouter.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/headerlessRouter.js
 var HeaderlessRouter = class {
   static Route(fileHunks, files, options) {
     const group = fileHunks.find((g) => g.Key == "");
@@ -2248,7 +2298,31 @@ var HeaderlessRouter = class {
   }
 };
 
-// ../node_modules/.pnpm/matchu-patchu@0.3.1/node_modules/matchu-patchu/dist/patcher.js
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/patchNotices.js
+var PatchNotices = class {
+  static For(hunks, file, contextOnlyHunkLines) {
+    const notices = [];
+    if (file.Edits.length === 0)
+      notices.push(file.AlreadyAppliedCount > 0 ? `Note: no edits were applied because the file already contains this change (${file.AlreadyAppliedCount} chunk(s) detected as already applied).` : "Note: no edits were applied \u2014 the diff parsed but expressed no change for this file.");
+    if (file.Fuzz > 0)
+      notices.push(`Note: applied with fuzz factor ${file.Fuzz} \u2014 the diff did not match exactly, so confirm the edits landed where you intended.`);
+    const suspects = TextUtils.DescribeSuspectCodePoints(file.Edits.flatMap((e) => e.InsertLines));
+    if (suspects)
+      notices.push(`Warning: written lines contain invisible or lookalike characters: ${suspects}. If these were authored as \\uXXXX escapes or plain ASCII, the tool-call layer may have mangled them; verify the file content.`);
+    const collapsed = hunks.flatMap((h) => h.Lines).filter((l) => l.CollapsedFrom != null).map((l) => l.CollapsedFrom);
+    if (collapsed.length > 0)
+      notices.push(`Note: ${collapsed.length} body line(s) starting '++' were read as sloppy doubled insert markers and written without the leading '+' (first: "${collapsed[0]}"). If the inserted content was meant to keep a '+' prefix (diff-shaped payload), verify the file.`);
+    if (hunks.some((h) => h.TruncationSuspected))
+      notices.push("Note: the diff's final hunk looks truncated (its header declares more lines than the body delivered). The delivered lines were applied; verify the tail of that change landed.");
+    if (hunks.some((h) => h.ControlCharsSuspected))
+      notices.push("Note: insert lines contained raw control characters and were written verbatim. That is usually transport damage rather than intended content; verify the written bytes.");
+    if (contextOnlyHunkLines.length > 0)
+      notices.push(`Note: the hunk${contextOnlyHunkLines.length === 1 ? "" : "s"} at diff line ${contextOnlyHunkLines.join(", ")} stated no change (context only), so nothing was applied there while the other edits landed. If an edit was intended, its '+'/'-' lines were lost \u2014 re-send that hunk and verify.`);
+    return notices;
+  }
+};
+
+// ../node_modules/.pnpm/matchu-patchu@0.3.3/node_modules/matchu-patchu/dist/patcher.js
 var Patcher = class {
   static Apply(diff, files, options) {
     options = options ?? new PatchOptions();
@@ -2269,10 +2343,13 @@ var Patcher = class {
     const patchOutputFiles = files.map((f) => {
       const targetSelection = new SelectionTarget(f.InputFullText, f.InputSelectedText);
       const targetText = targetSelection.TargetText;
-      const hunks = fileHunks.find((h) => h.Key == f.Key)?.Hunks ?? [];
+      const group = fileHunks.find((h) => h.Key == f.Key);
+      const hunks = group?.Hunks ?? [];
       const anchored = HunkAnchorer.Anchor(targetText, hunks, options);
       const outputEdits = ChunkApplier.Apply(targetText, anchored.Chunks, options);
-      return new PatchOutputFile(f.Key, outputEdits.Edits.map((h) => h.Fuzz).reduce((a, b) => a + b, 0), outputEdits.Edits.map((e) => e.Shift(targetSelection.LineOffset)), f.InputSelectedText, f.InputFullText, targetSelection.Replace(outputEdits.OutputText), [...outputEdits.Errors], anchored.AlreadyAppliedCount, hunks.flatMap((h) => h.Lines).filter((l) => l.CollapsedFrom != null).map((l) => l.CollapsedFrom), hunks.some((h) => h.TruncationSuspected), hunks.some((h) => h.ControlCharsSuspected));
+      const file = new PatchOutputFile(f.Key, outputEdits.Edits.map((h) => h.Fuzz).reduce((a, b) => a + b, 0), outputEdits.Edits.map((e) => e.Shift(targetSelection.LineOffset)), f.InputSelectedText, f.InputFullText, targetSelection.Replace(outputEdits.OutputText), [...outputEdits.Errors], anchored.AlreadyAppliedCount);
+      file.Notices = PatchNotices.For(hunks, file, group?.ContextOnlyHunkLines ?? []);
+      return file;
     });
     return new PatchOutput([...patchOutputFiles, ...reportFiles]);
   }
@@ -2280,14 +2357,13 @@ var Patcher = class {
 
 // cli/agents/pi/server/piPatcherExtension.ts
 var DESCRIPTION = true ? "Apply unified diffs to files \u2014 tolerant of form, strict about intent. Repairs sloppy AI-generated diffs (mangled headers, whitespace drift, missing prefixes; line numbers can be wrong or absent \u2014 hunks anchor by fuzzy-matched context lines) and applies all hunks atomically when the intent is unambiguous; fails with a precise, typed error when it isn't. Use for multi-hunk edits in one step, or when exact string-replacement editing fails on whitespace or invisible characters." : "Apply unified diffs to files.";
-var BUILD_TAG = true ? "matchu-patchu-pi 0.3.1, built 2026-07-25 03:11:48" : "matchu-patchu-pi dev";
+var BUILD_TAG = true ? "matchu-patchu-pi 0.3.3, built 2026-07-26 13:14:27" : "matchu-patchu-pi dev";
 var errorBlocks = (errors) => {
   const parts = [`Patch failed with ${errors.length} error(s):`];
   for (const e of errors) parts.push("", e.toString());
   return parts.join("\n");
 };
-var noOpMessage = (target, alreadyApplied) => alreadyApplied > 0 ? `Applied 0 edit(s) to ${target}: the file already contains this change (${alreadyApplied} chunk(s) detected as already applied). File left unmodified.` : `Applied 0 edit(s) to ${target}: the patch parsed but produced no changes for this file. File left unmodified.`;
-var fuzzNote = (fuzz) => fuzz > 0 ? ` (applied with fuzz factor ${fuzz})` : "";
+var outcomeMessage = (target, out) => `Applied ${out.Edits.length} edit(s) to ${target}.` + (out.Edits.length > 0 ? "" : " File left unmodified.") + out.Notices.map((n) => " " + n).join("");
 function discoverDiffKeys(diff) {
   const keys = [];
   for (const f of Patcher.Apply(diff, []).Files) {
@@ -2300,11 +2376,10 @@ function applySingle(cwd, filePath, diff, dryRun) {
   if (!existsSync(abs)) return { ok: false, message: `Error: file not found: ${filePath}` };
   const out = Patcher.Apply(diff, [new PatchInputFile("", readFileSync(abs, "utf-8"))]).Files[0];
   if (out.Errors.length > 0) return { ok: false, message: errorBlocks(out.Errors) };
-  if (out.Edits.length === 0) return { ok: true, message: noOpMessage(filePath, out.AlreadyAppliedCount) };
-  if (!dryRun) writeFileSync(abs, out.OutputFullText);
+  if (out.Edits.length > 0 && !dryRun) writeFileSync(abs, out.OutputFullText);
   return {
     ok: true,
-    message: `Successfully applied ${out.Edits.length} edit(s) to ${filePath}${fuzzNote(out.Fuzz)}.` + (dryRun ? `
+    message: outcomeMessage(filePath, out) + (dryRun ? `
 
 --- patched output ---
 ${out.OutputFullText}` : "")
@@ -2324,14 +2399,12 @@ function applyMulti(cwd, diff, dryRun) {
   const lines = [];
   const dryOutputs = [];
   for (const out of result.Files) {
-    if (out.Edits.length === 0) {
-      lines.push(noOpMessage(out.Key, out.AlreadyAppliedCount));
-      continue;
-    }
-    if (!dryRun) writeFileSync(resolve(cwd, out.Key), out.OutputFullText);
-    else dryOutputs.push(`--- patched output: ${out.Key} ---
+    if (out.Edits.length > 0) {
+      if (!dryRun) writeFileSync(resolve(cwd, out.Key), out.OutputFullText);
+      else dryOutputs.push(`--- patched output: ${out.Key} ---
 ${out.OutputFullText}`);
-    lines.push(`Successfully applied ${out.Edits.length} edit(s) to ${out.Key}${fuzzNote(out.Fuzz)}.`);
+    }
+    lines.push(outcomeMessage(out.Key, out));
   }
   return { ok: true, message: [lines.join("\n"), ...dryOutputs].join("\n\n") };
 }

package/dist/agents/pi/styles.css

@@ -118,21 +118,27 @@ body {
   gap: .4rem;
   align-items: center;
 }
-/* Chip shape shared by EVERY word-label control — the status-bar pills (interactive and
-   passive) AND the floating overlay pills (copy, breakout, code⇄run). One rule = one source
-   of vertical alignment; when these drift apart it reads as amateurish.
-   THE CENTERING RECIPE (don't re-tweak per button — fix it here or nowhere): Segoe UI's font
+/* THE CENTERING RECIPE for EVERY word-label control on any surface — the status-bar pills and
+   floating overlay pills below, and the launcher row's trust switch + B scope chip. One rule = one
+   source of vertical alignment; when these drift apart it reads as amateurish, so a new word
+   control joins this selector rather than centering itself (don't re-tweak per button — fix it
+   here or nowhere). Icon buttons opt back out, keeping flex (see .pill.glyph). Segoe UI's font
    ascent (~1.08em) dwarfs its descent (~0.25em), so anything that centers the LINE BOX —
    flex, line-height, padding — parks the glyphs ~2px low at pill sizes. `text-box` trims the
    line box to the glyphs (cap→baseline) so centering centers the letters themselves. It only
    applies to block containers (not flex), hence inline-block + align-content, not inline-flex
-   + align-items. Browsers without text-box (Firefox) fall back to plain line-box centering.
-   Opaque so pills read cleanly over the message text the transparent strip lets through. */
-.pill, .token, .overlay-pill {
+   + align-items. Browsers without text-box (Firefox) fall back to plain line-box centering. */
+.pill, .token, .overlay-pill, .trust-toggle, .batch-b {
   display: inline-block;
   align-content: center;
   text-align: center;
   text-box: trim-both cap alphabetic;
+}
+/* Chip shape shared by the status-bar pills (interactive and passive) AND the floating overlay
+   pills (copy, breakout, code⇄run) — opaque, so they read cleanly over the message text the
+   transparent strip lets through. The launcher row's pills take only the recipe above; their
+   shape is the row's (.trust-toggle, .batch-b). */
+.pill, .token, .overlay-pill {
   height: var(--pill-h);
   padding: 0 .7rem;
   border-radius: 7px;
@@ -821,9 +827,10 @@ a.server-port:hover { text-decoration: underline; }
    row's snippet line bleeds under the next row as overlapping text. max-content tracks never
    compress; the list scrolls, rows keep their content height. */
 .bulb-list { display: grid; grid-template-columns: auto 1fr auto auto auto auto; grid-auto-rows: max-content; column-gap: .6rem; row-gap: .15rem; align-items: center; align-content: start; padding-right: 4px; flex: 1; min-height: 0; overflow-y: auto; }
-/* The scope column (TB-Batch.md Invariant 7): a seventh track between name and the control
-   cluster, present only while some row carries a scope (bulbsPill.ts anyScope — rows emit a
-   matching cell, spacer included). The B affordance keeps it ~1.3rem wide. */
+/* The scope column (TB-Batch.md Invariant 7): a seventh track heading the control cluster (before
+   trust — a launch scope is an execution concern, like a trust tier), present only while some row
+   carries a scope (bulbsPill.ts anyScope — rows emit a matching cell, spacer included). The B
+   affordance keeps it one --pill-h square. */
 .bulb-list.has-scope { grid-template-columns: auto 1fr auto auto auto auto auto; }
 /* A stopped bulb's name isn't a link (no running URL), so it stays plain foreground. */
 .server-name.stopped { color: var(--fg); }
@@ -839,7 +846,11 @@ a.server-port:hover { text-decoration: underline; }
    the row shows THAT a scope applies, the tooltip and click-menu name it. Dim = batches exist but
    launch is unscoped; lit (.on) = play launches scoped (newest default) or running scoped.
    Static (running) keeps the lit look without the hand cursor. */
-.batch-b { font-size: .72rem; font-family: ui-monospace, monospace; line-height: 1; color: var(--muted); background: transparent; border: 1px solid var(--border); border-radius: 4px; width: 1.3rem; height: 1.15rem; padding: 0; cursor: pointer; display: inline-flex; align-items: center; justify-content: center; }
+/* Square (its one glyph has no text pill's width to earn) and otherwise typography-free: the shared
+   pill box, font and trim, so its B is the same size and sits on the same baseline as the trust
+   switch beside it. Its own font-family was the bug — a monospace cap is a different size from a
+   Segoe cap at one font-size, which reads as two badly-aligned widgets. */
+.batch-b { font-size: var(--pill-font); color: var(--muted); background: transparent; border: 1px solid var(--border); border-radius: 5px; width: var(--pill-h); height: var(--pill-h); padding: 0; cursor: pointer; }
 .batch-b.on { color: var(--accent); border-color: var(--accent); }
 .batch-b.static { cursor: default; }
 /* The B's menu rides the composer popup register (.at-popup/.at-row/.dlg-catcher — one mini-menu
@@ -876,18 +887,21 @@ a.server-port:hover { text-decoration: underline; }
 .bulb-list .picker-snippet { grid-column: 2 / -1; margin: 0 .4rem .2rem 0; }
 .bulb-time { color: var(--muted); font-size: .72rem; font-variant-numeric: tabular-nums; text-align: right; margin-right: .4rem; }
 /* The row's chrome buttons share one reset; sizing + colour differ below. Play/stop are round icon
-   buttons (friendlier, space-economic); the trust switch is text. Logs is a link, not a button
-   (see .server-logs above), so it's not in this group. */
+   buttons (friendlier, space-economic) and stay flex — a replaced SVG mis-seats under the
+   word-pill trim, the .pill.glyph case; the trust switch is a word, so it seats via the shared
+   recipe. Logs is a link, not a button (see .server-logs above), so it's not in this group. */
 .server-stop, .bulb-launch, .trust-toggle {
   font: inherit; appearance: none; margin: 0; cursor: pointer; box-sizing: border-box;
   background: transparent; border: 1px solid var(--border); border-radius: 5px;
-  height: 1.7rem; display: inline-flex; align-items: center; justify-content: center;
+  height: 1.7rem;
 }
 /* Shorter than the icon buttons: a bordered text pill at full row height reads as cramped, where
-   the round play/stop icons are meant to fill it. */
-.trust-toggle { font-size: .76rem; height: 1.45rem; padding: 0 .5rem; color: var(--muted); justify-self: center; }
+   the round play/stop icons are meant to fill it. The shared pill box + font, not a bespoke pair —
+   its own .76rem/1.45rem seated the word a full 1px below every statusbar pill, which is exactly how
+   this drifts (measured: a per-control size is a per-control seating). */
+.trust-toggle { font-size: var(--pill-font); height: var(--pill-h); padding: 0 .5rem; color: var(--muted); justify-self: center; }
 .trust-toggle:hover, .trust-toggle.on { color: var(--accent); border-color: var(--accent); }
-.server-stop, .bulb-launch { width: 1.7rem; padding: 0; border-radius: 50%; margin-left: .4rem; }
+.server-stop, .bulb-launch { display: inline-flex; align-items: center; justify-content: center; width: 1.7rem; padding: 0; border-radius: 50%; margin-left: .4rem; }
 .btn-icon { width: 16px; height: 16px; }
 /* A stopped bulb's play button is dormant — the title is the primary launch target — so it's
    hidden until the row is hovered or keyboard-selected. visibility (not display) reserves its slot,
@@ -895,9 +909,10 @@ a.server-port:hover { text-decoration: underline; }
    :port link: green is the live-app axis (play to launch → :port to open it), distinct from the
    blue source/name. The green even travels left→right as a bulb goes stopped→running. */
 .bulb-launch { color: var(--fold-marker); visibility: hidden; }
-/* A right triangle's visual mass sits left of its bounding box, so geometric centring reads
-   too-far-left in a round button — shift the play glyph. */
-.bulb-launch .icon svg { transform: translateX(1px); }
+/* No optical nudge on the play glyph, deliberately: Material's play_arrow already carries one (its
+   path spans 320→760 in a 0→960 frame — ~1px right at icon size, compensating a right triangle's
+   left-leaning mass). Our own translateX(1px) stacked a second correction and measured 2px right of
+   the button's centre. Any glyph that reads off-centre here is the frame's business, not the app's. */
 .server-row:hover .bulb-launch, .server-row.active .bulb-launch { visibility: visible; }
 .bulb-launch:hover { border-color: var(--fold-marker); background: color-mix(in srgb, var(--fold-marker) 12%, transparent); }
 /* Launching: stays visible (hover-independent) and shimmers until the row flips to a stop button,

package/dist/format/parse.d.ts

@@ -11,6 +11,13 @@ export interface ParsedBulb {
     frontmatter: BulbFrontmatter;
     /** Block contents keyed by filename (e.g. `code.tsx`). */
     files: Map<string, string>;
+    /**
+     * 1-based line number, in the `.bulb.md`, of each block's FIRST content line (the line after its
+     * opening fence), keyed by filename. A bulb is a container: every tool inside it — tsc, lint, a
+     * browser stack trace — reports block coordinates, while the only file the user can open and link
+     * to is the bulb. This is the offset that maps one to the other (TB-CLI.md, One coordinate space).
+     */
+    starts: Map<string, number>;
     /** Structural defects tolerated during parse (an unterminated fence); empty when well-formed. */
     warnings: string[];
     /**

package/dist/format/parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../format/src/parse.ts"],"names":[],"mappings":"AAAA,uGAAuG;AAEvG,OAAO,EAAE,KAAK,aAAa,EAAsC,MAAM,eAAe,CAAA;AAOtF,eAAO,MAAM,aAAa,QAAsB,CAAA;AAGhD,wGAAwG;AACxG,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,MAAsC,CAAA;AAEnF,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,eAAe,CAAA;IAC5B,0DAA0D;IAC1D,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1B,iGAAiG;IACjG,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,mDAAmD;AACnD,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;AAEvE,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAqE5D;AA6CD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAE/D;AAED;;sGAEsG;AACtG,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE,CAkBjE;AAED,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,CAKvD"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../format/src/parse.ts"],"names":[],"mappings":"AAAA,uGAAuG;AAEvG,OAAO,EAAE,KAAK,aAAa,EAAsC,MAAM,eAAe,CAAA;AAOtF,eAAO,MAAM,aAAa,QAAsB,CAAA;AAGhD,wGAAwG;AACxG,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,MAAsC,CAAA;AAEnF,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,eAAe,CAAA;IAC5B,0DAA0D;IAC1D,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1B;;;;;OAKG;IACH,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC3B,iGAAiG;IACjG,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,mDAAmD;AACnD,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;AAEvE,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAwE5D;AA6CD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAE/D;AAED;;sGAEsG;AACtG,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE,CAkBjE;AAED,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,CAKvD"}