typebulb 0.39.2 → 0.39.3

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-25 21:21:48" : "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/index.js

@@ -2007,5 +2007,5 @@ ${vO}
 `);let c=0,l=Promise.resolve();Ct({target:r,onChange:()=>{let f=++c;l=l.then(async()=>{if(f===c)try{console.log("Re-running..."),await a()}catch(u){console.error("Error:",u)}})}})}}xt();Me();import{Console as AO}from"node:console";je();async function vb(r,e,t,n,s){_O();try{let p=Nr(await Q(),r)[0];p&&(Zi(p.pid,Be(p.pid).offset),console.error(`note: 'call' boots a fresh server.ts instance; the running server (${p.url}) is not contacted \u2014 state shared with it must live on disk.`))}catch{}let i=Se(t),{bulb:o,config:a}=await Ne(r);o.server||us("This bulb has no **server.ts** block; nothing to call."),kt(i,r,o.server),s&&await Or(r,s);let c;try{c=await Un(o.server,r,n,a.dependencies,s)}catch(p){us(p instanceof Error?p.message:String(p))}let l=Vo(c,e.fn);if(!l){let p=[...Object.keys(c).filter(y=>typeof c[y]=="function"),...Object.keys(Yo)];us(`Function '${e.fn}' not found. Available: ${p.length?p.join(", "):"(none)"}.`)}let f=await TO(e);if(Go(l)){try{for await(let p of l(...f))await wb(JSON.stringify(p,Sb)+`
 `)}catch(p){us(p instanceof Error?p.stack??p.message:String(p))}return bb(0)}let u;try{u=await l(...f)}catch(p){us(p instanceof Error?p.stack??p.message:String(p))}let d=CO(u);d!==void 0&&await wb(d+`
 `),bb(0)}function bb(r){process.exitCode=r,setTimeout(()=>process.exit(r),2e3).unref?.()}async function TO(r){if(r.hasArgsFlag){let e=r.argsJson??"";return e==="-"&&(e=await RO()),OO(e)}return PO(r.positional)}function PO(r){return r.map(e=>{try{return JSON.parse(e)}catch{return e}})}function OO(r){let e;try{e=JSON.parse(r)}catch(t){throw new Error(`--args must be a JSON array: ${t instanceof Error?t.message:String(t)}`)}if(!Array.isArray(e))throw new Error(`--args must be a JSON array, got ${e===null?"null":typeof e}`);return e}function CO(r){if(r!==void 0)return JSON.stringify(r,Sb,2)}function Sb(r,e){return typeof e=="bigint"?e.toString():e}function us(r){process.stderr.write(r+`
-`),process.exit(1)}function _O(){let r=new AO(process.stderr,process.stderr);console.log=r.log.bind(r),console.info=r.info.bind(r),console.debug=r.debug.bind(r),console.dir=r.dir.bind(r)}function wb(r){return new Promise((e,t)=>{process.stdout.write(r,n=>n?t(n):e())})}async function RO(){let r=[];for await(let e of process.stdin)r.push(e);return Buffer.concat(r).toString("utf-8")}var ju="0.39.2";function kb(r,e){r||(console.error(`This bulb runs server-side Node code (server.ts), which --trust must authorize:
+`),process.exit(1)}function _O(){let r=new AO(process.stderr,process.stderr);console.log=r.log.bind(r),console.info=r.info.bind(r),console.debug=r.debug.bind(r),console.dir=r.dir.bind(r)}function wb(r){return new Promise((e,t)=>{process.stdout.write(r,n=>n?t(n):e())})}async function RO(){let r=[];for await(let e of process.stdin)r.push(e);return Buffer.concat(r).toString("utf-8")}var ju="0.39.3";function kb(r,e){r||(console.error(`This bulb runs server-side Node code (server.ts), which --trust must authorize:
   ${e}`),process.exit(1))}async function NO(){let r=gm(process.argv.slice(2));if(r.version&&(console.log(`typebulb ${ju}`),process.exit(0)),r.help&&(ym(),process.exit(0)),Ly(),r.subcommand==="logs"){await Hy(r.file||void 0,{follow:r.follow,clear:r.clear,run:r.run,lines:r.lines});return}if(r.subcommand==="wait"){await Wy(r.file||void 0,{match:r.match,timeoutSec:r.timeoutSec});return}if(r.subcommand==="stop"){r.stopScope?await Vy(r.stopScope):await Yy(r.file||void 0);return}if(r.subcommand==="send"){await zy(r.file,r.sendMessage,r.sendWaitMs??0);return}if(r.subcommand==="skill"){await Uy(ju);return}if(r.subcommand==="models"){await Fy(r.mode);return}if(r.subcommand==="pull"){await Fh(r.file||void 0,{force:r.force,mode:r.mode});return}if(r.subcommand==="push"){await Uh(r.file||void 0,{force:r.force,mode:r.mode});return}if(r.subcommand==="agent"){await(r.agentTarget?hb(r):jy(ju));return}if(r.subcommand==="trust"||r.subcommand==="untrust"){await $y(r.file||void 0,r.subcommand==="trust");return}let e;if(!r.file||r.file==="."){let c=await oh(process.cwd());c||(console.error("No .bulb.md file found in current directory"),process.exit(1)),e=c}else e=rr.resolve(r.file);if(await xb.access(e).then(()=>!0,()=>!1)||(qr().includes(r.file)&&(console.error(`To open the ${r.file} agent mirror, run: npx typebulb agent:${r.file}`),process.exit(1)),console.error(`File not found: ${e}`),process.exit(1)),e.endsWith(".bulb.md")||(console.error("File must have .bulb.md extension"),process.exit(1)),r.subcommand==="get"){await Qy(e,r.blockKind);return}if(r.subcommand==="put"){await tb(e,r.blockPairs);return}let n=r.file&&r.file!=="."?r.file:rr.relative(process.cwd(),e)||rr.basename(e),s=`npx typebulb --trust ${n.includes(" ")?`"${n}"`:n}`;if(r.subcommand==="predict"){await Iy(e,s);return}let i=!r.noTrust&&Yt(e);i&&!r.trust&&console.error("trust: granted from memory (run `typebulb untrust` to revoke)"),r.trust=r.noTrust?!1:r.trust||i;let o;try{o=await Ne(e)}catch{}let a;if(r.local){o&&!(r.local.name in(o.config.dependencies??{}))&&(console.error(`--replace: '${r.local.name}' is not a dependency in this bulb's config.json; nothing to replace.`),process.exit(1)),o&&r.subcommand!=="call"&&(!o.bulb.code||r.server)&&console.warn("warning: --replace has no effect in server mode (the override is client-only).");try{a=await Xu(r.local)}catch(c){console.error(c instanceof Error?c.message:String(c)),process.exit(1)}console.error(`replace: ${a.name} \u2192 ${rr.relative(process.cwd(),a.dir)||"."}`)}if(r.subcommand==="check"){await Ny(e,a);return}if(r.subcommand==="call"){kb(r.trust,s),await vb(e,{fn:r.fn,positional:r.callArgs,argsJson:r.argsJson,hasArgsFlag:r.hasArgsFlag},r.mode,a,r.batch);return}if(o&&o.bulb.server&&(hi(o.bulb)||r.server)){kb(r.trust,s),await yb(e,r.watch,r.mode,a,r.batch);return}await db(e,r,s,a)}NO().catch(r=>{console.error("Error:",r.message),process.exit(1)});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "typebulb",
-  "version": "0.39.2",
+  "version": "0.39.3",
   "description": "Typebulb CLI to run single-file markdown apps called bulbs, either as standalone web apps or embedded in agent responses.",
   "license": "MIT",
   "repository": {
@@ -93,7 +93,7 @@
     "highlight.js": "^11.10.0",
     "katex": "^0.16.22",
     "markdown-it": "^14.1.0",
-    "matchu-patchu": "^0.3.1",
+    "matchu-patchu": "^0.3.3",
     "playwright": "^1.60.0",
     "rimraf": "^6.0.1",
     "typebox": "^1.3.4",