Solution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors
Rust
fix(capture): one Windows spelling for cwd, marker and patterns; literal backslashes; both /a/x readings
AkitaOnRailscb9b576a6749
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 54354c48..ce194167 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -80,7 +80,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0`/cygdrive/c/...`), a rooted path without a drive, the `\\?\`, `\\.\` and`\\localhost\C$` prefixes, an alternate data stream suffix and trailing dotsor spaces are read as the file they open, so they no longer slip past a- pattern. Hermes `execute_code` is metadata-only under an active policy, like+ pattern. The `cwd`, the marker's directory and an absolute pattern get the+ same reading, so a session started from `\\?\C:\repo` or+ `\\localhost\C$\repo` matches its relative patterns again. A bare or+ double-quoted `\\server\share\...` or `\\?\C:\...` argument keeps both+ backslashes, as PowerShell and cmd read it, and `/a/x` is also read from the+ root of the `cwd`'s drive, as a native tool reads it. The generated+ TypeScript marker reader no longer takes a line inside a multi-line array+ (`["docs"]`) for a table header. Hermes `execute_code` is metadata-only under an active policy, like`python3 -c`, and a shell command longer than 1 MiB is metadata-only insteadof being split. The generated TypeScript integrations now read a dotted`capture.ignore_paths` key and quoted `[capture]` headers, reject the shapesdiff --git a/crates/ai-memory-cli/src/commands/render_shared.rs b/crates/ai-memory-cli/src/commands/render_shared.rsindex 0d4b65eb..5b3183d2 100644--- a/crates/ai-memory-cli/src/commands/render_shared.rs+++ b/crates/ai-memory-cli/src/commands/render_shared.rs@@ -288,18 +288,26 @@ function captureClassGlob(pattern: string[], text: string[]): boolean { if (!pat// Whether the POSIX class `[:name:]` admits `c`; an unknown class may admit anything. Mirrors `ClassMember::admits`.function captureNamedClass(name: string, c: string): boolean { const code = c.codePointAt(0)!; const ascii = code < 128; switch (name) { case "alnum": return /[\p{L}\p{N}]/u.test(c); case "alpha": return /\p{L}/u.test(c); case "blank": return c === " " || c === "\t"; case "cntrl": return /\p{Cc}/u.test(c); case "digit": return /[0-9]/.test(c); case "lower": return /\p{Ll}/u.test(c); case "space": return /\s/.test(c); case "upper": return /\p{Lu}/u.test(c); case "word": return /[\p{L}\p{N}_]/u.test(c); case "xdigit": return /[0-9A-Fa-f]/.test(c); case "punct": return ascii && /[!-\/:-@\[-`{-~]/.test(c); case "graph": return code > 32 && code < 127; case "print": return code >= 32 && code < 127; case "ascii": return ascii; default: return true; } }function captureJoin(base: string, child: string): string { if (/^[^A-Za-z]?:|^[A-Za-z]:[^/\\]/.test(child)) return child; return `${base.replace(/[\\/]+$/, "")}/${child}`; }-// Under a Windows host, the absolute path Windows opens for `path` from `base`, `/`-separated with its `.` and `..` still in place: the `\\?\`, `\\.\` and `\??\` prefixes and the local administrative share (`\\localhost\C$`) name the drive or share (any other device is no path), Git Bash/MSYS2/Cygwin `/c/x` and `/cygdrive/c/x` are `C:/x`, any other rooted path is on the base's drive or share, and each segment loses an alternate data stream suffix and its trailing dots and spaces. Undefined when it is not usable; mirrors `windows_spelling`.-function captureWindowsSpelling(path: string, base: string): string | undefined { if (/^[\x00-\x7f]:/.test(path) && !/^[A-Za-z]:[\\/]/.test(path)) return undefined; const b = captureNormalize(base)?.path ?? ""; let p = path.replace(/\\/g, "/"); if (/^(?:\/\/[?.]\/|\/\?\?\/)/.test(p)) { const rest = p.slice(4); if (/^unc\//i.test(rest)) p = `//${rest.slice(4)}`; else if (/^[A-Za-z]:/.test(rest)) p = rest; else return undefined; } if (/^[A-Za-z]:$/.test(p)) p += "/"; if (p.startsWith("//")) { const [server = "", share = "", ...rest] = p.slice(2).split("/"); if ((/^localhost$/i.test(server) || server === "127.0.0.1") && /^[A-Za-z]\$$/.test(share)) p = `${share[0]}:/${rest.join("/")}`; } else if (p.startsWith("/")) { const forward = path.startsWith("/"); const [first, ...after] = p.slice(1).split("/"); if (forward && /^[A-Za-z]$/.test(first)) p = `${first.toUpperCase()}:/${after.join("/")}`; else if (forward && first.toLowerCase() === "cygdrive" && /^[A-Za-z]$/.test(after[0] ?? "")) p = `${after[0].toUpperCase()}:/${after.slice(1).join("/")}`; else { const root = /^[A-Za-z]:/.test(b) ? b.slice(0, 2) : /^\/\/[^/]+\/[^/]+/.exec(b)?.[0]; if (root === undefined) return undefined; p = root + p; } } else if (!/^[A-Za-z]:\//.test(p)) { if (!b) return undefined; p = `${b.replace(/\/+$/, "")}/${p}`; } let root: string; let tail: string[]; if (p.startsWith("//")) { const x = p.slice(2).split("/").filter(Boolean); if (x.length < 2) return undefined; root = `//${x.shift()}/${x.shift()}`; tail = x; } else if (/^[A-Za-z]:\//.test(p)) { root = `${p[0].toUpperCase()}:/`; tail = p.slice(3).split("/"); } else return undefined; const parts = tail.map(captureWindowsSegment).filter((x): x is string => x !== undefined); return root + (parts.length ? (root.endsWith("/") ? "" : "/") + parts.join("/") : ""); }+// Under a Windows host, every absolute path Windows can open for `path` from `base`, `/`-separated with its `.` and `..` still in place: the `\\?\`, `\\.\` and `\??\` prefixes and the local administrative share (`\\localhost\C$`) name the drive or share (any other device is no path), Git Bash/MSYS2/Cygwin `/c/x` and `/cygdrive/c/x` are `C:/x`, any other rooted path is on the base's drive or share, and each segment loses an alternate data stream suffix and its trailing dots and spaces. A native tool reads `/c/x` and `/cygdrive/c/x` from the root of the base's drive instead, so those give that path too. Undefined when it is not usable; mirrors `windows_spellings`.+function captureWindowsSpellings(path: string, base: string): string[] | undefined { if (/^[\x00-\x7f]:/.test(path) && !/^[A-Za-z]:[\\/]/.test(path)) return undefined; const b = captureNormalize(base)?.path ?? ""; let p = path.replace(/\\/g, "/"); let alternate: string | undefined; if (/^(?:\/\/[?.]\/|\/\?\?\/)/.test(p)) { const rest = p.slice(4); if (/^unc\//i.test(rest)) p = `//${rest.slice(4)}`; else if (/^[A-Za-z]:/.test(rest)) p = rest; else return undefined; } if (/^[A-Za-z]:$/.test(p)) p += "/"; if (p.startsWith("//")) { const [server = "", share = "", ...rest] = p.slice(2).split("/"); if ((/^localhost$/i.test(server) || server === "127.0.0.1") && /^[A-Za-z]\$$/.test(share)) p = `${share[0]}:/${rest.join("/")}`; } else if (p.startsWith("/")) { const forward = path.startsWith("/"); const [first, ...after] = p.slice(1).split("/"); const driveRoot = /^[A-Za-z]:/.test(b) ? b.slice(0, 2) : /^\/\/[^/]+\/[^/]+/.exec(b)?.[0]; if (driveRoot === undefined) return undefined; const native = driveRoot + p; if (forward && /^[A-Za-z]$/.test(first)) { p = `${first.toUpperCase()}:/${after.join("/")}`; alternate = native; } else if (forward && first.toLowerCase() === "cygdrive" && /^[A-Za-z]$/.test(after[0] ?? "")) { p = `${after[0].toUpperCase()}:/${after.slice(1).join("/")}`; alternate = native; } else p = native; } else if (!/^[A-Za-z]:\//.test(p)) { if (!b) return undefined; p = `${b.replace(/\/+$/, "")}/${p}`; } const segments = (p: string): string | undefined => { let root: string; let tail: string[]; if (p.startsWith("//")) { const x = p.slice(2).split("/").filter(Boolean); if (x.length < 2) return undefined; root = `//${x.shift()}/${x.shift()}`; tail = x; } else if (/^[A-Za-z]:\//.test(p)) { root = `${p[0].toUpperCase()}:/`; tail = p.slice(3).split("/"); } else return undefined; const parts = tail.map(captureWindowsSegment).filter((x): x is string => x !== undefined); return root + (parts.length ? (root.endsWith("/") ? "" : "/") + parts.join("/") : ""); }; const spellings: string[] = []; for (const reading of alternate === undefined ? [p] : [p, alternate]) { const spelled = segments(reading); if (spelled === undefined) return undefined; spellings.push(spelled); } return spellings; }+// The first of `captureWindowsSpellings`: Git Bash's reading of `/c/x`; mirrors `windows_spelling`.+function captureWindowsSpelling(path: string, base: string): string | undefined { return captureWindowsSpellings(path, base)?.[0]; }+// An absolute directory (cwd, marker directory) or pattern, normalized; a Windows one is read as Windows opens it, so it shares one spelling with every candidate compared with it (`\\?\C:\repo` is `C:/repo`); mirrors `normalize_root`.+function captureRoot(path: string): { path: string; windows: boolean } | undefined { if (!captureHostWindows(path)) return captureNormalize(path); const spelled = captureWindowsSpelling(path, ""); return spelled === undefined ? undefined : captureNormalize(spelled); }// One segment as Windows reads it; undefined when nothing is left. Mirrors `windows_segment`.function captureWindowsSegment(segment: string): string | undefined { const name = segment.split(":")[0]; const unspaced = name.replace(/ +$/, ""); if (unspaced === "." || unspaced === "..") return unspaced; return name.replace(/[. ]+$/, "") || undefined; }-// The path a candidate names from `base`, read as Windows reads it on a Windows host.-function captureResolve(path: string, base: string, windowsHost: boolean): string | undefined { if (windowsHost) return captureWindowsSpelling(path, base); return /^(?:\/|\\\\|[A-Za-z]:[\\/])/.test(path) ? path : captureJoin(base, path); }+// Every path a candidate names from `base`, read as Windows reads it on a Windows host.+function captureResolve(path: string, base: string, windowsHost: boolean): string[] | undefined { if (windowsHost) return captureWindowsSpellings(path, base); return [/^(?:\/|\\\\|[A-Za-z]:[\\/])/.test(path) ? path : captureJoin(base, path)]; }+// Every reading (`captureReadings`) of every path `resolved` holds: undefined when one is unusable, false past CAPTURE_MAX_GLOBSTAR_READINGS in all.+function captureAllReadings(resolved: string[] | undefined, windowsHost: boolean): { path: string; windows: boolean }[] | undefined | false { if (resolved === undefined) return undefined; const all: { path: string; windows: boolean }[] = []; for (const path of resolved) { const readings = captureReadings(path, windowsHost); if (!readings) return readings; all.push(...readings); if (all.length > CAPTURE_MAX_GLOBSTAR_READINGS) return false; } return all; }// Longer than CAPTURE_MAX_COMMAND_CHARS characters summed over its argv elements; mirrors `ShellCommand::oversized`.function captureCommandOversized(command: string | string[]): boolean { let total = 0; for (const item of typeof command === "string" ? [command] : command) for (const _c of item) if (++total > CAPTURE_MAX_COMMAND_CHARS) return true; return false; }// A TOML key (`a`, `"a"`, `'a'`, dotted `a . "b"`) at the start of `text`: its parts and the index past it and any blanks, or undefined. Enough of the key grammar to see every spelling of `capture`.function captureTomlKey(text: string): { parts: string[]; end: number } | undefined { const parts: string[] = []; let i = 0; for (;;) { while (text[i] === " " || text[i] === "\t") i++; if (text[i] === '"') { let j = i + 1; while (j < text.length && text[j] !== '"') j += text[j] === "\\" ? 2 : 1; if (j >= text.length) return undefined; const decoded = captureParseArray(`[${text.slice(i, j + 1)}]`); if (!decoded) return undefined; parts.push(decoded[0]); i = j + 1; } else if (text[i] === "'") { const j = text.indexOf("'", i + 1); if (j < 0) return undefined; parts.push(text.slice(i + 1, j)); i = j + 1; } else { const bare = /^[A-Za-z0-9_-]+/.exec(text.slice(i)); if (!bare) return undefined; parts.push(bare[0]); i += bare[0].length; } while (text[i] === " " || text[i] === "\t") i++; if (text[i] !== ".") return { parts, end: i }; i++; } }function captureValidGlob(p: string): boolean { return !!p && [...p].length <= CAPTURE_MAX_PATTERN_CHARS && !/[!{}\[\]()|^$%]/.test(p) && !p.includes("${") && !p.includes("***") && !p.replace(/\\/g, "/").split("/").includes("..") && (!p.startsWith("~") || p.startsWith("~/")) && !/^[^A-Za-z]?:/.test(p) && !/^[A-Za-z]:[^/\\]/.test(p); }function captureParseArray(value: string): string[] | undefined { let i = 0; const out: string[] = []; const ws = () => { while (/\s/.test(value[i] ?? "")) i++; }; const basic = { b: "\b", t: "\t", n: "\n", f: "\f", r: "\r", '"': '"', "\\": "\\" } as Record<string, string>; ws(); if (value[i++] !== "[") return undefined; for (;;) { ws(); if (value[i] === "]") { i++; ws(); return i === value.length ? out : undefined; } const quote = value[i++]; if (quote !== '"' && quote !== "'") return undefined; let s = ""; for (;;) { if (i >= value.length) return undefined; const c = value[i++]; if (c === quote) break; if (c === "\\" && quote === '"') { const e = value[i++]; if (e in basic) s += basic[e]; else if (e === "u" || e === "U") { const count = e === "u" ? 4 : 8; const hex = value.slice(i, i + count); if (!new RegExp(`^[0-9A-Fa-f]{${count}}$`).test(hex)) return undefined; const n = Number.parseInt(hex, 16); if (n > 0x10ffff || (n >= 0xd800 && n <= 0xdfff)) return undefined; s += String.fromCodePoint(n); i += count; } else return undefined; } else if (c === "\n" || c === "\r") return undefined; else s += c; } out.push(s); ws(); if (value[i] === ",") { i++; continue; } if (value[i] === "]") continue; return undefined; } }+// Follows the arrays and inline tables a TOML value leaves open across lines, each open `[` or `{` on `stack`. False when `text` cannot be (part of) a TOML 1.0 value: a close that matches nothing open, a `=` directly inside an array (a key line swallowed by one), text after the outermost close of a `continued` value, or an inline table still open at the end of the line.+function captureValueScan(text: string, stack: string[], continued: boolean): boolean { let quote = ""; for (let i = 0; i < text.length; i++) { const c = text[i]; if (quote) { if (c === "\\" && quote === '"') i++; else if (c === quote) quote = ""; continue; } if (continued && !stack.length && !/\s/.test(c)) return false; if (c === '"' || c === "'") quote = c; else if (c === "[" || c === "{") stack.push(c); else if (c === "]" || c === "}") { if (stack.pop() !== (c === "]" ? "[" : "{")) return false; } else if (c === "=" && stack[stack.length - 1] === "[") return false; } return stack[stack.length - 1] !== "{"; }function captureHostWindows(path: string): boolean { return path.startsWith("\\\\") || path.startsWith("//") || /^[A-Za-z]:/.test(path); }function captureConfig(cwd: string | undefined): CaptureConfig { return captureConfigAt(findMarker(cwd), cwd); }// The policy one marker declares, for an event reported from `cwd`.@@ -311,28 +319,33 @@ function captureConfigAt(marker: string | undefined, cwd: string | undefined): C// exactly like the native hook's pure-string `flavor_of(cwd)`; a Windows// cwd is normalized lexically for the same reason.const windowsHost = captureHostWindows(cwd ?? "");- const candidateBase = (windowsHost ? captureNormalize(cwd ?? "") : captureNormalize(cwd ? resolve(cwd) : ""))?.path ?? "";+ const candidateBase = (windowsHost ? captureRoot(cwd ?? "") : captureNormalize(cwd ? resolve(cwd) : ""))?.path ?? "";if (!marker) return { state: "inactive", patterns: [], base: candidateBase, windowsHost };try {const bytes = readFileSync(marker);- const markerBase = captureNormalize(dirname(marker))?.path ?? candidateBase;+ // A Windows marker's directory is cut lexically and spelled like the cwd.+ const markerBase = (windowsHost ? captureRoot(marker.replace(/[\\/][^\\/]*$/, "")) : captureNormalize(dirname(marker)))?.path ?? candidateBase;if (bytes.byteLength > CAPTURE_MARKER_MAX_BYTES) return { state: "invalid", patterns: [], base: candidateBase, windowsHost };// Every TOML spelling of the capture table the native parser honours// (`[capture]`, `[ "capture" ]`, a top-level dotted `capture.ignore_paths`)// is read; any other shape of a `capture` key (an inline table,// `[[capture]]`, `[capture.x]`, a second definition) is invalid, as// `read_capture_config` finds it.+ // A value's arrays may span lines (`stack`), and a line inside one,+ // `["docs"]` among them, is never a table header.let section: "top" | "capture" | "other" = "top";let value = "";let collecting = false;+ const stack: string[] = [];let seen = false;let defined = false;for (const raw of bytes.toString("utf8").split(/\r?\n/)) {const line = captureTrimComment(raw).trim();if (!line) continue;- if (collecting) {- value += ` ${line}`;- collecting = !value.includes("]");+ if (stack.length) {+ if (!captureValueScan(line, stack, true)) return { state: "invalid", patterns: [], base: candidateBase, windowsHost };+ if (collecting) value += ` ${line}`;+ collecting &&= stack.length > 0;continue;}if (line.startsWith("[")) {@@ -347,18 +360,20 @@ function captureConfigAt(marker: string | undefined, cwd: string | undefined): Cdefined = true;continue;}- if (section === "other") continue;const key = captureTomlKey(line);const kv = key && line[key.end] === "=" ? key : undefined;- if (section === "top" && kv?.parts[0] !== "capture") continue;+ // Neither a header nor a key/value line: not TOML, as toml_edit finds it.+ if (!kv || !captureValueScan(line.slice(kv.end + 1), stack, false)) return { state: "invalid", patterns: [], base: candidateBase, windowsHost };+ if (section === "other") continue;+ if (section === "top" && kv.parts[0] !== "capture") continue;const path = kv ? (section === "top" ? kv.parts.slice(1) : kv.parts) : [];if (!kv || seen || path.length !== 1 || path[0] !== "ignore_paths") return { state: "invalid", patterns: [], base: candidateBase, windowsHost };seen = true;defined = true;value = line.slice(kv.end + 1).trim();- collecting = !value.includes("]");+ collecting = stack.length > 0;}- if (collecting) return { state: "invalid", patterns: [], base: candidateBase, windowsHost };+ if (stack.length) return { state: "invalid", patterns: [], base: candidateBase, windowsHost };if (!seen) return { state: "inactive", patterns: [], base: candidateBase, windowsHost };const strings = captureParseArray(value);if (!strings || strings.length > CAPTURE_MAX_PATTERNS) return { state: "invalid", patterns: [], base: candidateBase, windowsHost };@@ -370,7 +385,7 @@ function captureConfigAt(marker: string | undefined, cwd: string | undefined): C: /^(?:\/|\\\\|[A-Za-z]:[\\/])/.test(source)? source: captureJoin(markerBase, source);- const parsed = captureNormalize(expanded);+ const parsed = captureRoot(expanded);if (!parsed) return undefined;const normalized = { path: captureFold(parsed.path), windows: parsed.windows };return { path: normalized.path, windows: normalized.windows, directory: normalized.path.endsWith("/**") ? (normalized.path.slice(0, -3) || "/") : undefined, prefix: captureLiteralPrefix(normalized.path) };@@ -406,15 +421,15 @@ function captureShellCommand(args: Record<string, unknown> | undefined): string// quoted message, is literal, except under PowerShell, which reads `~` itself.// `expanded` holds the words of each script with such syntax as the shell expands them where that changes the directory a path names (a zsh glob group kept in its word, ANSI-C numeric escapes decoded), for the marker lookup only; mirrors `ShellWords::expanded`.type CaptureSplit = { words: [string, boolean][]; opaque: boolean; expanded: [string, boolean][] };-function captureShellSplit(command: string | string[], windows = false): CaptureSplit { const split: CaptureSplit = { words: [], opaque: false, expanded: [] }; if (typeof command === "string") { split.opaque = captureUnevaluatedExpansion(command); if (split.opaque) split.expanded.push(...captureMarkedWords(command, true)); captureNestedWords(captureMarkedWords(command), CAPTURE_MAX_SHELL_NESTING, split); const plain = windows ? captureWithoutWindowsEscapes(command) : undefined; if (plain !== undefined) captureNestedWords(captureMarkedWords(plain), CAPTURE_MAX_SHELL_NESTING, split); } else { split.opaque = command.some((item) => captureUnevaluatedExpansion(item)) || captureInlineCode(command); for (const item of command) if (captureUnevaluatedExpansion(item)) split.expanded.push(...captureMarkedWords(item, true)); command.forEach((item, index) => { const script = captureShellScript(command, index); captureArgvItem(item, script, split); const plain = windows ? captureWithoutWindowsEscapes(item) : undefined; if (plain !== undefined) captureArgvItem(plain, script, split); }); } if (windows) for (const word of split.words) word[1] = true; if (split.words.some(([word, tilde]) => tilde && captureShellArguments(word).some(([argument]) => captureUnknownDirectory(argument)))) split.opaque = true; return split; }-function captureArgvItem(item: string, script: boolean, split: CaptureSplit): void { const tokens = captureMarkedWords(item); if (tokens.length === 1 && tokens[0][0] === item) { capturePushWord(item, false, split); return; } if ([...item].length <= 256) split.words.push([item, false]); captureNestedWords(captureLiteralTildes(tokens, script), CAPTURE_MAX_SHELL_NESTING - 1, split); }+function captureShellSplit(command: string | string[], windows = false): CaptureSplit { const split: CaptureSplit = { words: [], opaque: false, expanded: [] }; const readings = (text: string): [string, boolean][] => { const texts = [text]; const plain = windows ? captureWithoutWindowsEscapes(text) : undefined; if (plain !== undefined) texts.push(plain); const out: [string, boolean][] = []; for (const t of texts) { out.push([t, false]); if (windows && t.includes("\\")) out.push([t, true]); } return out; }; if (typeof command === "string") { split.opaque = captureUnevaluatedExpansion(command); if (split.opaque) split.expanded.push(...captureMarkedWords(command, true)); for (const [text, literal] of readings(command)) captureNestedWords(captureMarkedWords(text, false, literal), CAPTURE_MAX_SHELL_NESTING, split, literal); } else { split.opaque = command.some((item) => captureUnevaluatedExpansion(item)) || captureInlineCode(command); for (const item of command) if (captureUnevaluatedExpansion(item)) split.expanded.push(...captureMarkedWords(item, true)); command.forEach((item, index) => { const script = captureShellScript(command, index); for (const [text, literal] of readings(item)) captureArgvItem(text, script, split, literal); }); } if (windows) for (const word of split.words) word[1] = true; if (split.words.some(([word, tilde]) => tilde && captureShellArguments(word).some(([argument]) => captureUnknownDirectory(argument)))) split.opaque = true; return split; }+function captureArgvItem(item: string, script: boolean, split: CaptureSplit, literal = false): void { const tokens = captureMarkedWords(item, false, literal); if (tokens.length === 1 && tokens[0][0] === item) { capturePushWord(item, false, split); return; } if ([...item].length <= 256) split.words.push([item, false]); captureNestedWords(captureLiteralTildes(tokens, script), CAPTURE_MAX_SHELL_NESTING - 1, split, literal); }// Only a script a shell runs expands a tilde; mirrors `literal_tildes`.function captureLiteralTildes(tokens: [string, boolean][], script: boolean): [string, boolean][] { return script ? tokens : tokens.map(([token]) => [token, false] as [string, boolean]); }// PowerShell's backquote and cmd's caret each stand for the next character; mirrors `without_windows_escapes`.function captureWithoutWindowsEscapes(command: string): string | undefined { if (!/[`^]/.test(command)) return undefined; const chars = [...command]; let plain = ""; for (let i = 0; i < chars.length; i++) { if (chars[i] === "`" || chars[i] === "^") { i++; if (i < chars.length) plain += chars[i]; } else plain += chars[i]; } return plain; }function captureUnknownDirectory(argument: string): boolean { if (!argument.startsWith("~")) return false; const prefix = argument.slice(1).split(/[\/\\]/)[0]; return prefix !== "" && prefix !== "+"; }// Only a script a shell runs expands braces, classes and tildes; a quoted message or pattern does not.-function captureNestedWords(words: [string, boolean][], depth: number, split: CaptureSplit): void { const texts = words.map(([word]) => word); if (captureInlineCode(texts)) split.opaque = true; words.forEach(([word, tilde], index) => { capturePushWord(word, tilde, split); const tokens = captureMarkedWords(word); if (tokens.length === 1 && tokens[0][0] === word) return; if (depth === 0) { split.opaque = true; return; } const script = word.includes("$(") || word.includes("`") || captureShellScript(texts, index); if (script && captureUnevaluatedExpansion(word)) { split.opaque = true; split.expanded.push(...captureMarkedWords(word, true)); } captureNestedWords(captureLiteralTildes(tokens, script), depth - 1, split); }); }+function captureNestedWords(words: [string, boolean][], depth: number, split: CaptureSplit, literal = false): void { const texts = words.map(([word]) => word); if (captureInlineCode(texts)) split.opaque = true; words.forEach(([word, tilde], index) => { capturePushWord(word, tilde, split); const tokens = captureMarkedWords(word, false, literal); if (tokens.length === 1 && tokens[0][0] === word) return; if (depth === 0) { split.opaque = true; return; } const script = word.includes("$(") || word.includes("`") || captureShellScript(texts, index); if (script && captureUnevaluatedExpansion(word)) { split.opaque = true; split.expanded.push(...captureMarkedWords(word, true)); } captureNestedWords(captureLiteralTildes(tokens, script), depth - 1, split, literal); }); }// Also adds the POSIX reading of a word with `\o` escapes, which the shell reads as `o`, and the reading of each with every parameter default (`${X:-docs/x.md}`) replaced by its operand; a default nested deeper than the matcher reads makes the command unprovable.function capturePushWord(word: string, tilde: boolean, split: CaptureSplit): void { capturePushReading(word, tilde, split); if (!word.includes("\\")) return; const chars = [...word]; let plain = ""; for (let i = 0; i < chars.length; i++) { if (chars[i] === "\\") { i++; if (i < chars.length) plain += chars[i]; } else plain += chars[i]; } if (plain !== word) capturePushReading(plain, tilde, split); }function capturePushReading(word: string, tilde: boolean, split: CaptureSplit): void { split.words.push([word, tilde]); const operands = captureParameterOperands(word); if (operands === undefined) return; split.words.push([operands[0], tilde]); if (operands[1]) split.opaque = true; }@@ -427,8 +442,8 @@ function captureShellScript(words: string[], index: number): boolean { let flaggfunction captureShellValueOption(flag: string): boolean { return ["--rcfile","--init-file","--init-command","-C"].includes(flag) || (flag.length > 1 && (flag.startsWith("+") || (flag.startsWith("-") && !flag.startsWith("--"))) && /[oO]$/.test(flag)); }// Inline interpreter code (`python3 -c`, `node -e`, `ruby -e`, `perl -e`, `php -r`, `lua -e`, `Rscript -e`, `osascript -e`, `deno eval`) builds paths at run time; mirrors `runs_inline_code`.function captureInlineCode(words: string[]): boolean { return words.some((word, index) => { const name = captureCommandName(word); const versioned = (prefix: string) => name.startsWith(prefix) && /^[0-9.]*$/.test(name.slice(prefix.length)); if (name === "deno") return words[index + 1] === "eval"; const spec: [string, string[]] | undefined = versioned("python") || versioned("pypy") || name === "py" ? ["c", ["-W","-X","--check-hash-based-pycs"]] : versioned("perl") ? ["eE", ["-I","-M","-m"]] : versioned("ruby") ? ["e", ["-I","-r","-C","-E"]] : ["node","nodejs","bun"].includes(name) ? ["ep", ["-r","--require","--import","--loader","--experimental-loader","-C","--conditions","--input-type","--title","--env-file"]] : versioned("php") ? ["r", ["-d","-c","-z"]] : ["lua","luajit","rscript","osascript"].includes(name) ? ["e", ["-l"]] : undefined; if (!spec) return false; const [letters, values] = spec; for (let i = index + 1; i < words.length; i++) { const flag = words[i]; if (!flag.startsWith("-")) return false; if (["--eval","--print"].includes(flag) || flag.startsWith("--eval=") || flag.startsWith("--print=") || (!flag.startsWith("--") && [...flag.slice(1)].some((c) => letters.includes(c)))) return true; if (values.includes(flag)) i++; } return false; }); }-// Each word with whether it holds a `~` outside quotes and not after a backslash; mirrors `marked_shell_words`. With `expand`, a zsh glob group stays in its word and ANSI-C numeric and control escapes are decoded; mirrors `shell_tokens`.-function captureMarkedWords(command: string, expand = false): [string, boolean][] { const special = (c: string) => /\s/.test(c) || "|&;<>()`".includes(c); const chars = [...command]; const words: [string, boolean][] = []; let word = ""; let tilde = false; let inWord = false; let quote = ""; for (let i = 0; i < chars.length; i++) { const c = chars[i]; const next = chars[i + 1]; if (quote === "$") { if (c === "'") quote = ""; else if (c === "\\" && next !== undefined) { const plain = captureAnsiEscape(next); const numeric = plain === undefined && expand ? captureAnsiNumeric(chars, i + 1) : undefined; if (plain !== undefined) { word += plain; i++; } else if (numeric) { word += numeric[0]; i = numeric[1]; } else { word += c + next; i++; } } else word += c; } else if (quote) { if (c === quote) quote = ""; else if (quote === '"' && c === "\\" && next === "\n") i++; else if (quote === '"' && c === "\\" && (next === '"' || next === "\\" || next === "$" || next === "`")) { word += next; i++; } else word += c; } else if (c === "'" || c === '"') { quote = c; inWord = true; } else if (c === "$" && (next === "'" || next === '"')) { quote = next === "'" ? "$" : '"'; i++; inWord = true; } else if (c === "\\" && next === "\n") { i++; } else if (c === "\\" && next !== undefined && (special(next) || next === "'" || next === '"' || next === "\\")) { word += next; i++; inWord = true; } else if (c === "(" && expand && (!inWord || !/[$=]$/.test(word)) && captureGlobGroup(chars, i, inWord) !== undefined) { const end = captureGlobGroup(chars, i, inWord)!; word += chars.slice(i, end + 1).join(""); i = end; inWord = true; } else if (special(c)) { if (inWord) words.push([word, tilde]); word = ""; tilde = false; inWord = false; } else { if (c === "~" && !word.endsWith("\\")) tilde = true; word += c; inWord = true; } } if (inWord) words.push([word, tilde]); return words; }+// Each word with whether it holds a `~` outside quotes and not after a backslash; mirrors `marked_shell_words`. With `expand`, a zsh glob group stays in its word and ANSI-C numeric and control escapes are decoded; mirrors `shell_tokens`. With `literal`, every backslash is an ordinary character, as PowerShell and cmd read it; mirrors `literal_shell_words`.+function captureMarkedWords(command: string, expand = false, literal = false): [string, boolean][] { const special = (c: string) => /\s/.test(c) || "|&;<>()`".includes(c); const chars = [...command]; const words: [string, boolean][] = []; let word = ""; let tilde = false; let inWord = false; let quote = ""; for (let i = 0; i < chars.length; i++) { const c = chars[i]; const next = chars[i + 1]; if (quote === "$") { if (c === "'") quote = ""; else if (c === "\\" && next !== undefined && !literal) { const plain = captureAnsiEscape(next); const numeric = plain === undefined && expand ? captureAnsiNumeric(chars, i + 1) : undefined; if (plain !== undefined) { word += plain; i++; } else if (numeric) { word += numeric[0]; i = numeric[1]; } else { word += c + next; i++; } } else word += c; } else if (quote) { if (c === quote) quote = ""; else if (!literal && quote === '"' && c === "\\" && next === "\n") i++; else if (!literal && quote === '"' && c === "\\" && (next === '"' || next === "\\" || next === "$" || next === "`")) { word += next; i++; } else word += c; } else if (c === "'" || c === '"') { quote = c; inWord = true; } else if (c === "$" && (next === "'" || next === '"')) { quote = next === "'" ? "$" : '"'; i++; inWord = true; } else if (!literal && c === "\\" && next === "\n") { i++; } else if (!literal && c === "\\" && next !== undefined && (special(next) || next === "'" || next === '"' || next === "\\")) { word += next; i++; inWord = true; } else if (c === "(" && expand && (!inWord || !/[$=]$/.test(word)) && captureGlobGroup(chars, i, inWord) !== undefined) { const end = captureGlobGroup(chars, i, inWord)!; word += chars.slice(i, end + 1).join(""); i = end; inWord = true; } else if (special(c)) { if (inWord) words.push([word, tilde]); word = ""; tilde = false; inWord = false; } else { if (c === "~" && !word.endsWith("\\")) tilde = true; word += c; inWord = true; } } if (inWord) words.push([word, tilde]); return words; }// The index of the `)` closing the zsh glob group `(` opens at `open`: inside a word, or at a word's start when a word character follows; undefined for a subshell or when whitespace, a quote, an escape or another operator comes first. Mirrors `glob_group`.function captureGlobGroup(chars: string[], open: number, inWord: boolean): number | undefined { let depth = 0; for (let i = open; i < chars.length; i++) { const c = chars[i]; if (/\s/.test(c) || "'\"\\;&<>`".includes(c)) return undefined; if (c === "(") depth++; else if (c === ")" && --depth === 0) { const next = chars[i + 1]; return inWord || (next !== undefined && !/\s/.test(next) && !"|&;<>()`".includes(next)) ? i : undefined; } } return undefined; }// A numeric or control ANSI-C escape whose letter or first digit is at `at` (`\xHH`, `\uHHHH`, `\UHHHHHHHH`, `\NNN`, `\cX`): the character and the index of its last source character, or undefined. Mirrors `ansi_c_numeric_escape`.@@ -445,7 +460,7 @@ function captureGitObjectPath(word: string): string | undefined { if (word.start// Lexical only, like the native hook: nothing is expanded or executed, so// variables, command substitution, and `cd` state are not followed. A tool's// own `workdir` replaces the event cwd for relative arguments.-function captureMatchCommand(words: [string, boolean][], config: CaptureConfig, workdir?: string): { match: boolean | undefined; spool: boolean } { const budget = { work: 0 }; const home = homedir(); const base = captureBase(config, workdir); let spool = false; for (const [word, tilde] of words) for (const [argument, fromRoot] of captureShellArguments(word)) { const expanded = captureExpandTilde(argument, tilde, home, base); if ([...expanded].length > CAPTURE_MAX_PATH_CHARS) continue; const absolute = /^(?:\/|\\\\|[A-Za-z]:[\\/])/.test(expanded); for (const root of fromRoot && !absolute && config.root ? [base, config.root] : [base]) { if (!absolute && !root) continue; const resolved = captureResolve(expanded, root, config.windowsHost); const readings = resolved === undefined ? undefined : captureReadings(resolved, config.windowsHost); if (readings === false) return { match: undefined, spool }; if (!readings) continue; for (const candidate of readings) { const spooled = captureOutputSpool(candidate.path, budget); if (spooled === undefined) return { match: undefined, spool }; if (spooled) spool = true; const match = captureMatchCandidate(candidate, false, config, budget); if (match !== false) return { match, spool }; } } } return { match: false, spool }; }+function captureMatchCommand(words: [string, boolean][], config: CaptureConfig, workdir?: string): { match: boolean | undefined; spool: boolean } { const budget = { work: 0 }; const home = homedir(); const base = captureBase(config, workdir); let spool = false; for (const [word, tilde] of words) for (const [argument, fromRoot] of captureShellArguments(word)) { const expanded = captureExpandTilde(argument, tilde, home, base); if ([...expanded].length > CAPTURE_MAX_PATH_CHARS) continue; const absolute = /^(?:\/|\\\\|[A-Za-z]:[\\/])/.test(expanded); for (const root of fromRoot && !absolute && config.root ? [base, config.root] : [base]) { if (!absolute && !root) continue; const readings = captureAllReadings(captureResolve(expanded, root, config.windowsHost), config.windowsHost); if (readings === false) return { match: undefined, spool }; if (!readings) continue; for (const candidate of readings) { const spooled = captureOutputSpool(candidate.path, budget); if (spooled === undefined) return { match: undefined, spool }; if (spooled) spool = true; const match = captureMatchCandidate(candidate, false, config, budget); if (match !== false) return { match, spool }; } } } return { match: false, spool }; }// The directory a shell tool's relative arguments resolve from; mirrors `command_base`.function captureBase(config: CaptureConfig, workdir?: string): string { const spelled = workdir !== undefined && config.windowsHost && config.base ? captureWindowsSpelling(workdir, config.base) : undefined; if (spelled !== undefined) return spelled; return workdir === undefined ? config.base : /^(?:\/|\\\\|[A-Za-z]:[\\/])/.test(workdir) ? workdir : config.base && captureJoin(config.base, workdir); }// A leading unquoted `~/` (PowerShell `~\`) is home and `~+` the working directory; mirrors `expand_tilde`.@@ -460,7 +475,7 @@ function captureGlobsIntersect(left: string[], right: string[]): boolean { const// recursing to any depth: a literal path matches like a file tool's, a glob// drops when it could expand into an ignored path, and glob syntax the matcher// cannot evaluate (classes, braces, extglobs, negation) fails closed.-function captureMatchGlobs(paths: string[], config: CaptureConfig): boolean | undefined { const budget = { work: 0 }; for (const path of paths) { if (/[\[\]{}()!]/.test(path)) return undefined; const resolved = captureResolve(path, config.base, config.windowsHost); const readings = resolved === undefined ? undefined : captureReadings(resolved, config.windowsHost); if (!readings) return undefined; for (const candidate of readings) { const match = captureMatchCandidate(candidate, true, config, budget); if (match !== false) return match; } } return false; }+function captureMatchGlobs(paths: string[], config: CaptureConfig): boolean | undefined { const budget = { work: 0 }; for (const path of paths) { if (/[\[\]{}()!]/.test(path)) return undefined; const readings = captureAllReadings(captureResolve(path, config.base, config.windowsHost), config.windowsHost); if (!readings) return undefined; for (const candidate of readings) { const match = captureMatchCandidate(candidate, true, config, budget); if (match !== false) return match; } } return false; }function captureMatchCandidate(raw: { path: string; windows: boolean }, toolGlob: boolean, config: CaptureConfig, budget: { work: number }): boolean | undefined { const candidate = { path: captureFold(raw.path), windows: raw.windows }; const glob = /[*?]/.test(candidate.path); const directory = toolGlob && !glob; for (const pattern of config.patterns) { if (candidate.windows !== pattern.windows) continue; const insensitive = toolGlob || pattern.windows || captureFoldCase; const under = captureStartsWith(candidate.path, pattern.prefix, insensitive); if (!under && !glob && !directory) continue; if (under) { const directory = pattern.directory ? captureGlob(pattern.directory, candidate.path, insensitive, budget) : false; if (directory !== false) return directory; const match = captureGlob(pattern.path, candidate.path, insensitive, budget); if (match !== false) return match; } if (glob) { const reaches = captureGlobstarReaches(candidate.path, pattern.prefix, insensitive, budget); if (reaches !== false) return reaches; } if (directory) { const below = captureGlobBelow(pattern.path, candidate.path, insensitive, budget); if (below !== false) return below; } } return false; }function captureGlobstarReaches(glob: string, prefix: string, insensitive: boolean, budget: { work: number }): boolean | undefined { const star = glob.indexOf("**"); if (star < 0) return captureGlobReaches(glob, prefix, insensitive, budget); const slash = glob.lastIndexOf("/", star); const head = slash < 0 ? "" : glob.slice(0, slash); const depth = head.split("/").filter(Boolean).length; let seen = 0; let offset = 0; for (const part of prefix.split("/")) { if (seen === depth) break; offset += part.length; if (part) seen++; if (seen < depth) offset++; } if (seen < depth) return captureGlobReaches(glob, prefix, insensitive, budget); return captureGlob(head, prefix.slice(0, offset), insensitive, budget); }function captureTool(payload: Record<string, unknown>): { family: CaptureProtocol["tool_family"]; paths?: string[]; extraction: CaptureProtocol["extraction_state"]; callID?: string; command?: string | string[]; shell?: boolean; powershell?: boolean; inline?: boolean; workdir?: string; globs?: boolean; reader?: boolean; search?: { roots: string[]; patterns: string[] }; patch?: string[] } { const name = typeof payload.tool === "string" ? payload.tool.toLowerCase() : ""; const args = payload.args as Record<string, unknown> | undefined; const call = ["tool_use_id","toolUseId","tool_call_id","toolCallId","call_id","callId","callID"].map((k) => payload[k]).find((v): v is string => typeof v === "string" && /^[A-Za-z0-9_.-]{1,128}$/.test(v)); if (CAPTURE_SEARCH_TOOLS.includes(name)) return { family: "search-list", extraction: "not-applicable", callID: call, search: captureSearchScope(name, args) }; if (CAPTURE_NON_FILE_TOOLS.includes(name)) { const workdir = ["workdir","dir_path","directory"].map((k) => args?.[k]).find((v) => v !== undefined); return { family: "non-file", extraction: "extracted", callID: call, command: captureShellCommand(args), shell: name !== "web_search", powershell: name === "powershell", inline: CAPTURE_INLINE_CODE_TOOLS.includes(name), workdir: typeof workdir === "string" && workdir.trim() ? workdir : undefined }; } if (!CAPTURE_FILE_TOOLS.includes(name)) return { family: "unknown", extraction: "extracted", callID: call, reader: CAPTURE_OUTPUT_READER_TOOLS.includes(name) }; const direct = (o: any): string[] | undefined => { if (!o || typeof o !== "object") return undefined; const r: string[] = []; for (const k of ["file_path","filePath","path","absolute_path","AbsolutePath","notebook_path","TargetFile"]) if (k in o) { if (typeof o[k] !== "string") return undefined; r.push(o[k]); } if ("paths" in o) { if (!Array.isArray(o.paths) || o.paths.some((x: unknown) => typeof x !== "string")) return undefined; r.push(...o.paths); } return r.length && r.length <= CAPTURE_MAX_CANDIDATES ? r : undefined; }; let paths = direct(args); if (["multi_edit","multiedit","replace_all"].includes(name)) { const entries = args?.edits ?? args?.replacements; if (!Array.isArray(entries) || !entries.length || entries.length > CAPTURE_MAX_CANDIDATES) paths = undefined; else { paths = paths ?? []; for (const entry of entries) { const more = direct(entry); if (!more || paths.length + more.length > CAPTURE_MAX_CANDIDATES) { paths = undefined; break; } paths.push(...more); } } } if (name === "read_many_files" && args && "include" in args) { const include = args.include; if (!Array.isArray(include) || include.some((x: unknown) => typeof x !== "string") || (paths?.length ?? 0) + include.length > CAPTURE_MAX_CANDIDATES) paths = undefined; else paths = [...(paths ?? []), ...(include as string[])]; } if ((name === "read" || name === "fs_read") && args && "operations" in args) { const entries = args.operations; if (!Array.isArray(entries) || !entries.length || entries.length > CAPTURE_MAX_CANDIDATES) paths = undefined; else { paths = paths ?? []; for (const entry of entries) { const more = direct(entry); if (!more || paths.length + more.length > CAPTURE_MAX_CANDIDATES) { paths = undefined; break; } paths.push(...more); } } } if (!paths || !paths.length || paths.some((p) => !p.trim() || [...p].length > CAPTURE_MAX_PATH_CHARS)) return { family: "file", extraction: "missing-or-malformed", callID: call, patch: capturePatchPaths(name, payload.args) }; return { family: "file", paths, extraction: "extracted", callID: call, globs: name === "read_many_files" }; }@@ -515,10 +530,10 @@ function captureOwnedExternally(): boolean { const owner = typeof process === "ufunction captureServerRouted(cwd: string | undefined): boolean { let dir = resolve(cwd ?? process.cwd()); const home = homedir(); let boundary: string | undefined; for (let probe = dir; ; probe = dirname(probe)) { if (probe === home) { boundary = home; break; } if (probe === dirname(probe)) break; } for (;;) { try { if (/^\s*server\s*=/m.test(readFileSync(join(dir, ".ai-memory.toml"), "utf8"))) return true; } catch (e) { if (!["ENOENT", "ENOTDIR", "EISDIR"].includes((e as { code?: string })?.code ?? "")) return true; } if (dir === boundary || dir === dirname(dir)) return false; dir = dirname(dir); } }type CaptureTool = ReturnType<typeof captureTool>;// One policy's disposition for one call, shared by the event's own marker and every other marker it reaches.-function captureDecide(tool: CaptureTool, config: CaptureConfig): CaptureDisposition { if (config.state === "invalid" && (tool.family === "file" || tool.family === "search-list" || tool.shell || tool.reader)) return "metadata-only"; if (config.state !== "active") return "keep"; if (tool.reader) return "metadata-only"; if (tool.family === "search-list") return "drop"; if (tool.family === "file") { if (!tool.paths) return "metadata-only"; const parsed = tool.paths.map((p) => { const resolved = captureResolve(p, config.base, config.windowsHost); return resolved === undefined ? undefined : captureNormalize(resolved, config.windowsHost); }); if (parsed.some((p) => !p)) return "metadata-only"; const candidates = parsed as { path: string; windows: boolean }[]; const spoolBudget = { work: 0 }; if (tool.globs) { const match = captureMatchGlobs(tool.paths, config); if (match !== false) return match ? "drop" : "metadata-only"; for (const p of tool.paths) { const resolved = captureResolve(p, config.base, config.windowsHost); const readings = resolved === undefined ? undefined : captureReadings(resolved, config.windowsHost); if (!readings) continue; for (const candidate of readings) if (captureOutputSpool(candidate.path, spoolBudget) !== false) return "metadata-only"; } return "keep"; } const budget = { work: 0 }; for (const raw of candidates) { const candidate = { path: captureFold(raw.path), windows: raw.windows }; for (const pattern of config.patterns) { if (candidate.windows !== pattern.windows) continue; if (pattern.directory && captureGlob(pattern.directory, candidate.path, pattern.windows || captureFoldCase, budget)) return "drop"; const match = captureGlob(pattern.path, candidate.path, pattern.windows || captureFoldCase, budget); if (match === undefined) return "metadata-only"; if (match) return "drop"; } } for (const candidate of candidates) if (captureOutputSpool(candidate.path, spoolBudget) !== false) return "metadata-only"; return "keep"; } if (tool.family === "non-file" && (tool.inline || (tool.command !== undefined && captureCommandOversized(tool.command)))) return "metadata-only"; if (tool.family === "non-file" && tool.command !== undefined) { const split = captureShellSplit(tool.command, tool.powershell || config.windowsHost); const matched = captureMatchCommand(split.words, config, tool.workdir); if (matched.match !== false) return "drop"; if (split.opaque || matched.spool) return "metadata-only"; } return "keep"; }+function captureDecide(tool: CaptureTool, config: CaptureConfig): CaptureDisposition { if (config.state === "invalid" && (tool.family === "file" || tool.family === "search-list" || tool.shell || tool.reader)) return "metadata-only"; if (config.state !== "active") return "keep"; if (tool.reader) return "metadata-only"; if (tool.family === "search-list") return "drop"; if (tool.family === "file") { if (!tool.paths) return "metadata-only"; const parsed = tool.paths.map((p) => { const resolved = captureResolve(p, config.base, config.windowsHost); const normalized = resolved?.map((path) => captureNormalize(path, config.windowsHost)); return normalized?.every(Boolean) ? normalized as { path: string; windows: boolean }[] : undefined; }); if (parsed.some((p) => !p)) return "metadata-only"; const candidates = (parsed as { path: string; windows: boolean }[][]).flat(); const spoolBudget = { work: 0 }; if (tool.globs) { const match = captureMatchGlobs(tool.paths, config); if (match !== false) return match ? "drop" : "metadata-only"; for (const p of tool.paths) { const readings = captureAllReadings(captureResolve(p, config.base, config.windowsHost), config.windowsHost); if (!readings) continue; for (const candidate of readings) if (captureOutputSpool(candidate.path, spoolBudget) !== false) return "metadata-only"; } return "keep"; } const budget = { work: 0 }; for (const raw of candidates) { const candidate = { path: captureFold(raw.path), windows: raw.windows }; for (const pattern of config.patterns) { if (candidate.windows !== pattern.windows) continue; if (pattern.directory && captureGlob(pattern.directory, candidate.path, pattern.windows || captureFoldCase, budget)) return "drop"; const match = captureGlob(pattern.path, candidate.path, pattern.windows || captureFoldCase, budget); if (match === undefined) return "metadata-only"; if (match) return "drop"; } } for (const candidate of candidates) if (captureOutputSpool(candidate.path, spoolBudget) !== false) return "metadata-only"; return "keep"; } if (tool.family === "non-file" && (tool.inline || (tool.command !== undefined && captureCommandOversized(tool.command)))) return "metadata-only"; if (tool.family === "non-file" && tool.command !== undefined) { const split = captureShellSplit(tool.command, tool.powershell || config.windowsHost); const matched = captureMatchCommand(split.words, config, tool.workdir); if (matched.match !== false) return "drop"; if (split.opaque || matched.spool) return "metadata-only"; } return "keep"; }const captureRank: Record<CaptureDisposition, number> = { keep: 0, "metadata-only": 1, drop: 2 };// Every other marker governing a path the call names (a file-tool target or the files an `apply_patch` names, a search/list directory, file or path-like glob argument, or a shell argument with a separator resolved from its workdir, plus that directory) inspects it too, so a checkout's `ignore_paths` hold for a call made from elsewhere. Lexical; each directory is looked up once and remembered for every lookup that passes it; a glob location is looked up from its literal root (before the walk, whose one listing may spend the time budget) and, when that root lies outside the event's own checkout, every directory it could pass through is checked for a marker of its own; a glob whose `..` follows a `**` is looked up in every reading. Locations outside the own checkout come first: there unreadable targets, glob syntax the walk cannot follow, and anything past the bounds are unprovable, while running out of budget inside the own checkout ends the lookup. Mirrors `capture_lookup_locations` and `foreign_capture_decision`.-function captureForeignConfigs(tool: CaptureTool, config: CaptureConfig, cwd: string | undefined, own: string | undefined): CaptureConfig[] { const invalid: CaptureConfig[] = [{ state: "invalid", patterns: [], base: config.base, windowsHost: config.windowsHost }]; const locations = new Set<string>(); let overflow = false; const add = (path: string, base: string): string[] | undefined => { const absolute = /^(?:\/|\\\\|[A-Za-z]:[\\/])/.test(path); if (!absolute && !base) return undefined; const resolved = captureResolve(path, base, config.windowsHost); if (resolved === undefined) return undefined; const readings = captureReadings(resolved, config.windowsHost); if (readings === false) { overflow = true; return undefined; } if (!readings) return undefined; return readings.map((candidate) => { const location = candidate.windows ? candidate.path.replace(/\//g, "\\") : candidate.path; locations.add(location); return location; }); }; if (tool.family === "file") { const paths = tool.paths ?? tool.patch; if (!paths) return invalid; for (const path of paths) if (add(path, config.base) === undefined) return invalid; } else if (tool.family === "search-list") { if (!tool.search) return invalid; const roots: string[] = []; for (const root of tool.search.roots) { const found = add(root, config.base); if (found === undefined) return invalid; roots.push(...found); } if (!roots.length) roots.push(config.base); for (const pattern of tool.search.patterns.filter((p) => /[\/\\]/.test(p))) for (const root of roots) if (add(pattern, root) === undefined) return invalid; } else if (tool.family === "non-file" && tool.command !== undefined) { if (captureCommandOversized(tool.command)) return invalid; const base = captureBase(config, tool.workdir); if (base) add(base, base); const home = homedir(); const split = captureShellSplit(tool.command, tool.powershell || config.windowsHost); for (const [word, tilde] of [...split.words, ...split.expanded]) for (const [argument] of captureShellArguments(word)) { const expanded = captureExpandTilde(argument, tilde, home, base); if (/[\/\\]/.test(expanded)) add(expanded, base); } } if (overflow || locations.size > CAPTURE_MAX_LOOKUP_LOCATIONS) return invalid; const markers: string[] = []; const memo: CaptureMarkerMemo = { governing: new Map(), checkouts: new Map() }; let checkout: string | undefined; if (cwd) { const root = captureMemoCheckout(resolve(cwd), memo, { dirs: 0, entries: 0, deadline: Infinity, now: Date.now, probes: -Infinity }); checkout = root && captureOwnCheckout(root) ? root : undefined; captureMemoRemember(cwd, own, memo); if (statSync(resolve(cwd), { throwIfNoEntry: false })?.isDirectory()) captureMemoNote(cwd, memo); } const budget: CaptureGlobBudget = { dirs: 0, entries: 0, deadline: captureNow() + CAPTURE_MAX_GLOB_MS, now: captureNow, probes: 0 }; const remember = (marker: string | undefined): boolean => { if (!marker || marker === own || markers.includes(marker)) return true; if (markers.length === CAPTURE_MAX_FOREIGN_MARKERS) return false; markers.push(marker); return true; }; const insideOwn = (location: string) => checkout !== undefined && (location === checkout || location.startsWith(join(checkout, "x").slice(0, -1))); const ordered = [...locations].filter((location) => !insideOwn(location)); const insideFrom = ordered.length; ordered.push(...[...locations].filter(insideOwn).sort((a, b) => a.split(/[\\/]/).length - b.split(/[\\/]/).length)); for (let index = 0; index < ordered.length; index++) { const location = ordered[index]; const walk = captureGlobWalk(location); if (walk === undefined) return invalid; const lookup = walk ? walk.root : location; const dir = captureExistingDirWithin(lookup, memo, budget); if (dir === undefined) { if (index >= insideFrom) break; return invalid; } const marker = dir === null ? null : captureMemoMarker(dir, memo, budget); if (marker === undefined) { if (index >= insideFrom) break; return invalid; } if (!remember(marker ?? undefined)) return invalid; if (walk) { const found = captureMarkersBelow(walk.root, walk.steps, checkout, budget); if (!found) return invalid; for (const marker of found) if (!remember(marker)) return invalid; } } return markers.map((marker) => captureConfigAt(marker, cwd)); }+function captureForeignConfigs(tool: CaptureTool, config: CaptureConfig, cwd: string | undefined, own: string | undefined): CaptureConfig[] { const invalid: CaptureConfig[] = [{ state: "invalid", patterns: [], base: config.base, windowsHost: config.windowsHost }]; const locations = new Set<string>(); let overflow = false; const add = (path: string, base: string): string[] | undefined => { const absolute = /^(?:\/|\\\\|[A-Za-z]:[\\/])/.test(path); if (!absolute && !base) return undefined; const readings = captureAllReadings(captureResolve(path, base, config.windowsHost), config.windowsHost); if (readings === false) { overflow = true; return undefined; } if (!readings) return undefined; return readings.map((candidate) => { const location = candidate.windows ? candidate.path.replace(/\//g, "\\") : candidate.path; locations.add(location); return location; }); }; if (tool.family === "file") { const paths = tool.paths ?? tool.patch; if (!paths) return invalid; for (const path of paths) if (add(path, config.base) === undefined) return invalid; } else if (tool.family === "search-list") { if (!tool.search) return invalid; const roots: string[] = []; for (const root of tool.search.roots) { const found = add(root, config.base); if (found === undefined) return invalid; roots.push(...found); } if (!roots.length) roots.push(config.base); for (const pattern of tool.search.patterns.filter((p) => /[\/\\]/.test(p))) for (const root of roots) if (add(pattern, root) === undefined) return invalid; } else if (tool.family === "non-file" && tool.command !== undefined) { if (captureCommandOversized(tool.command)) return invalid; const base = captureBase(config, tool.workdir); if (base) add(base, base); const home = homedir(); const split = captureShellSplit(tool.command, tool.powershell || config.windowsHost); for (const [word, tilde] of [...split.words, ...split.expanded]) for (const [argument] of captureShellArguments(word)) { const expanded = captureExpandTilde(argument, tilde, home, base); if (/[\/\\]/.test(expanded)) add(expanded, base); } } if (overflow || locations.size > CAPTURE_MAX_LOOKUP_LOCATIONS) return invalid; const markers: string[] = []; const memo: CaptureMarkerMemo = { governing: new Map(), checkouts: new Map() }; let checkout: string | undefined; if (cwd) { const root = captureMemoCheckout(resolve(cwd), memo, { dirs: 0, entries: 0, deadline: Infinity, now: Date.now, probes: -Infinity }); checkout = root && captureOwnCheckout(root) ? root : undefined; captureMemoRemember(cwd, own, memo); if (statSync(resolve(cwd), { throwIfNoEntry: false })?.isDirectory()) captureMemoNote(cwd, memo); } const budget: CaptureGlobBudget = { dirs: 0, entries: 0, deadline: captureNow() + CAPTURE_MAX_GLOB_MS, now: captureNow, probes: 0 }; const remember = (marker: string | undefined): boolean => { if (!marker || marker === own || markers.includes(marker)) return true; if (markers.length === CAPTURE_MAX_FOREIGN_MARKERS) return false; markers.push(marker); return true; }; const insideOwn = (location: string) => checkout !== undefined && (location === checkout || location.startsWith(join(checkout, "x").slice(0, -1))); const ordered = [...locations].filter((location) => !insideOwn(location)); const insideFrom = ordered.length; ordered.push(...[...locations].filter(insideOwn).sort((a, b) => a.split(/[\\/]/).length - b.split(/[\\/]/).length)); for (let index = 0; index < ordered.length; index++) { const location = ordered[index]; const walk = captureGlobWalk(location); if (walk === undefined) return invalid; const lookup = walk ? walk.root : location; const dir = captureExistingDirWithin(lookup, memo, budget); if (dir === undefined) { if (index >= insideFrom) break; return invalid; } const marker = dir === null ? null : captureMemoMarker(dir, memo, budget); if (marker === undefined) { if (index >= insideFrom) break; return invalid; } if (!remember(marker ?? undefined)) return invalid; if (walk) { const found = captureMarkersBelow(walk.root, walk.steps, checkout, budget); if (!found) return invalid; for (const marker of found) if (!remember(marker)) return invalid; } } return markers.map((marker) => captureConfigAt(marker, cwd)); }function capturePolicy(payload: Record<string, unknown>, cwd: string | undefined): { disposition: CaptureDisposition; protocol?: CaptureProtocol; payload: Record<string, unknown> } { if (captureOwnedExternally()) return { disposition: "drop", payload }; if (captureServerRouted(cwd)) return { disposition: "drop", payload }; const markerPresent = !!findMarker(cwd); if (CAPTURE_MODE === "allowlist" && !markerPresent) return { disposition: "drop", payload }; const own = findMarker(cwd); let config = captureConfigAt(own, cwd); const tool = captureTool(payload); let disposition = captureDecide(tool, config); if (disposition !== "drop" && tool.family !== "unknown") for (const other of captureForeignConfigs(tool, config, cwd, own)) { const decided = captureDecide(tool, other); if (captureRank[decided] > captureRank[disposition]) { disposition = decided; config = other; } } if (config.state === "inactive") return { disposition, payload }; const protocol: CaptureProtocol = { version: CAPTURE_POLICY_V1, disposition, policy_state: config.state, tool_family: tool.family, path_count: tool.paths?.length ?? 0, extraction_state: tool.extraction }; if (disposition === "metadata-only") { const session = payload.sessionID ?? payload.sessionId ?? payload.session_id; const routing = typeof payload.cwd === "string" ? payload.cwd : cwd; return { disposition, protocol, payload: { ...(typeof session === "string" ? { session_id: session } : {}), ...(typeof routing === "string" ? { cwd: routing } : {}), tool_family: tool.family, tool_name: tool.family, ...(tool.callID ? { tool_call_id: tool.callID } : {}), _ai_memory_capture: protocol } }; } if (disposition === "keep") return { disposition, protocol, payload: { ...payload, _ai_memory_capture: protocol } }; return { disposition, protocol, payload }; }"##;let names = |names: &[&str]| {@@ -2711,10 +2726,14 @@ mod tests {let fixture = include_str!("../../../ai-memory-hooks/tests/fixtures/capture-policy.json");let fixture = serde_json::to_string(fixture).unwrap();let source = format!(- r#"import {{ closeSync, mkdirSync, opendirSync as realOpendirSync, openSync, readFileSync as readMarkerText, readSync, readdirSync, statSync, writeFileSync }} from "node:fs";+ r#"import {{ closeSync, mkdirSync, opendirSync as realOpendirSync, openSync as realOpenSync, readFileSync as readMarkerText, readSync, readdirSync, statSync, writeFileSync }} from "node:fs";import {{ basename, dirname, join, resolve }} from "node:path";import {{ homedir }} from "node:os";+// A marker spelled as a Windows path (`\\?\C:\repo\.ai-memory.toml`) is read from the real file it stands for, so its directory is the Windows one.+const markerAliases = new Map<string, string>();+function openSync(path: string, flags: string) {{ return realOpenSync(markerAliases.get(path) ?? path, flags); }}+// Counts the entries the policy's directory walk reads.let opendirReads = 0;function opendirSync(path: string) {{ const dir = realOpendirSync(path); return {{ readSync() {{ opendirReads++; return dir.readSync(); }}, closeSync() {{ dir.closeSync(); }} }}; }}@@ -2953,6 +2972,14 @@ for (const section of [fixture.windows, fixture.windows_posix_controls]) {{for (const vector of section.files) {{ const result = capturePolicy({{ tool: "edit", args: {{ path: vector.path }} }}, section.cwd); check(result.disposition === vector.disposition && result.protocol?.tool_family === "file", `windows-file ${{section.cwd}} ${{JSON.stringify(vector)}}: ${{result.disposition}}`); }}for (const vector of section.shell ?? []) {{ const result = capturePolicy(vector.payload ?? bash(vector.command), section.cwd); check(result.disposition === vector.disposition, `windows-shell ${{JSON.stringify(vector)}}: ${{result.disposition}}`); }}}}+// A Windows session whose cwd, marker directory or pattern is spelled with a device prefix, an administrative share or a UNC path; PowerShell's literal backslashes; both readings of `/a/x` (shared vectors; mirrors `windows_spelling_fixture_vectors`). The marker sits in the cwd itself, so relative patterns resolve from its Windows spelling.+for (const section of fixture.windows_scopes) {{+ const markerPath = `${{section.cwd}}\\.ai-memory.toml`;+ markerAliases.set(markerPath, markerFixtures.get(marker(`[capture]\nignore_paths = ${{JSON.stringify(section.ignore_paths)}}\n`))!);+ markerFixtures.set(section.cwd, markerPath);+ for (const vector of section.files) {{ const result = capturePolicy({{ tool: "edit", args: {{ path: vector.path }} }}, section.cwd); check(result.disposition === vector.disposition && result.protocol?.tool_family === "file", `windows-file ${{section.cwd}} ${{JSON.stringify(vector)}}: ${{result.disposition}}`); }}+ for (const vector of section.shell ?? []) {{ const result = capturePolicy(vector.payload ?? bash(vector.command), section.cwd); check(result.disposition === vector.disposition, `windows-shell ${{JSON.stringify(vector)}}: ${{result.disposition}}`); }}+}}// Every TOML spelling of the capture table the native parser honours, and the ones it rejects (shared vectors; mirrors `capture_section_spellings_match_toml_semantics`).for (const text of fixture.marker_spellings.honoured) check(capturePolicy({{ tool: "edit", args: {{ path: "secret/x" }} }}, marker(text)).disposition === "drop", `marker-honoured ${{JSON.stringify(text)}}`);for (const text of fixture.marker_spellings.rejected) {{ const result = capturePolicy({{ tool: "edit", args: {{ path: "public/x" }} }}, marker(text)); check(result.disposition === "metadata-only" && result.protocol?.policy_state === "invalid", `marker-rejected ${{JSON.stringify(text)}}`); }}diff --git a/crates/ai-memory-hooks/src/capture_policy.rs b/crates/ai-memory-hooks/src/capture_policy.rsindex 758aac9c..7f8ee1d0 100644--- a/crates/ai-memory-hooks/src/capture_policy.rs+++ b/crates/ai-memory-hooks/src/capture_policy.rs@@ -655,7 +655,7 @@ impl CapturePolicy {let readings = if extracted.globs {normalize_readings(path, cwd).ok().flatten()} else {- normalize_candidate(path, cwd).map(|c| vec![c])+ normalize_candidates(path, cwd)};for candidate in readings.into_iter().flatten() {if output_spool(&candidate.path, &mut work)? {@@ -734,9 +734,9 @@ impl CapturePolicy {fn match_paths(&self, paths: &[String], cwd: &str) -> Result<bool, ()> {let candidates: Option<Vec<_>> = paths.iter()- .map(|path| normalize_candidate(path, cwd))+ .map(|path| normalize_candidates(path, cwd)).collect();- let candidates = candidates.ok_or(())?;+ let candidates = candidates.ok_or(())?.into_iter().flatten();let mut work = 0_usize;for candidate in candidates {let candidate = self.fold_candidate(candidate);@@ -2236,18 +2236,39 @@ impl ShellCommand<'_> {/// re-split paths with spaces and let one stray quote swallow the rest.////// `windows` also reads the command without PowerShell and cmd escapes- /// ([`without_windows_escapes`]).+ /// ([`without_windows_escapes`]), and each reading again with its+ /// backslashes kept as written ([`literal_shell_words`]): PowerShell and+ /// cmd escape nothing with a backslash, so `\\srv\share\x` names a UNC+ /// path there, not the `\srv\share\x` a POSIX shell reads.fn split(&self, windows: bool) -> ShellWords {let mut split = ShellWords::default();+ // The readings of one command line or argv element.+ let readings = |text: &str| -> Vec<(String, bool)> {+ let mut texts = vec![text.to_owned()];+ texts.extend(windows.then(|| without_windows_escapes(text)).flatten());+ let mut readings = Vec::with_capacity(texts.len() * 2);+ for text in texts {+ let literal = windows && text.contains('\\');+ readings.push((text.clone(), false));+ if literal {+ readings.push((text, true));+ }+ }+ readings+ };match self {Self::Line(command) => {split.opaque = has_unevaluated_expansion(command);if split.opaque {split.expanded.extend(shell_tokens(command, true));}- push_nested_words(&marked_shell_words(command), MAX_SHELL_NESTING, &mut split);- if let Some(plain) = windows.then(|| without_windows_escapes(command)).flatten() {- push_nested_words(&marked_shell_words(&plain), MAX_SHELL_NESTING, &mut split);+ for (text, literal) in readings(command) {+ push_nested_words(+ &split_words(&text, literal),+ MAX_SHELL_NESTING,+ literal,+ &mut split,+ );}}Self::Argv(items) => {@@ -2262,9 +2283,8 @@ impl ShellCommand<'_> {// An element reaches the program as is, so only a script// a shell runs expands a tilde in it.let script = is_shell_script(items, index);- push_argv_item(item, script, &mut split);- if let Some(plain) = windows.then(|| without_windows_escapes(item)).flatten() {- push_argv_item(&plain, script, &mut split);+ for (text, literal) in readings(item) {+ push_argv_item(&text, script, literal, &mut split);}}}@@ -2287,8 +2307,8 @@ impl ShellCommand<'_> {}}-fn push_argv_item(item: &str, script: bool, split: &mut ShellWords) {- let tokens = marked_shell_words(item);+fn push_argv_item(item: &str, script: bool, literal: bool, split: &mut ShellWords) {+ let tokens = split_words(item, literal);if tokens.len() == 1 && tokens[0].0 == item {push_word(item, false, split);return;@@ -2300,6 +2320,7 @@ fn push_argv_item(item: &str, script: bool, split: &mut ShellWords) {push_nested_words(&literal_tildes(tokens, script),MAX_SHELL_NESTING - 1,+ literal,split,);}@@ -2370,14 +2391,21 @@ fn expand_tilde(argument: String, tilde: bool, home: Option<&str>, cwd: &str) ->/// How many quoting levels a script inside a word is re-split.const MAX_SHELL_NESTING: usize = 4;-fn push_nested_words(words: &[(String, bool)], depth: usize, split: &mut ShellWords) {+/// `literal` re-splits each word with its backslashes kept+/// ([`split_words`]).+fn push_nested_words(+ words: &[(String, bool)],+ depth: usize,+ literal: bool,+ split: &mut ShellWords,+) {let texts: Vec<&str> = words.iter().map(|(word, _)| word.as_str()).collect();if runs_inline_code(&texts) {split.opaque = true;}for (index, (word, tilde)) in words.iter().enumerate() {push_word(word, *tilde, split);- let tokens = marked_shell_words(word);+ let tokens = split_words(word, literal);if tokens.len() == 1 && tokens[0].0 == *word {continue;}@@ -2393,7 +2421,7 @@ fn push_nested_words(words: &[(String, bool)], depth: usize, split: &mut ShellWosplit.opaque = true;split.expanded.extend(shell_tokens(word, true));}- push_nested_words(&literal_tildes(tokens, script), depth, split);+ push_nested_words(&literal_tildes(tokens, script), depth, literal, split);}}@@ -2763,6 +2791,28 @@ fn marked_shell_words(command: &str) -> Vec<(String, bool)> {/// word (`docs/(a|b)/x`, `(a|b)/x`) instead of splitting it as a subshell, and/// the numeric and control escapes of an ANSI-C string are decoded.fn shell_tokens(command: &str, expand: bool) -> Vec<(String, bool)> {+ tokenize(command, expand, false)+}++/// [`marked_shell_words`] with every backslash an ordinary character, as+/// PowerShell and cmd read it: `\\srv\share\x`, bare or double-quoted, keeps+/// both leading backslashes.+fn literal_shell_words(command: &str) -> Vec<(String, bool)> {+ tokenize(command, false, true)+}++/// The words of `command` read with POSIX quoting ([`shell_tokens`]), or,+/// with `literal`, with backslashes kept as written ([`literal_shell_words`]).+fn split_words(command: &str, literal: bool) -> Vec<(String, bool)> {+ if literal {+ literal_shell_words(command)+ } else {+ marked_shell_words(command)+ }+}++/// [`shell_tokens`]; `literal` reads every backslash as an ordinary character.+fn tokenize(command: &str, expand: bool, literal: bool) -> Vec<(String, bool)> {let is_operator = |c: char| matches!(c, '|' | '&' | ';' | '<' | '>' | '(' | ')' | '`');let mut words = Vec::new();let mut word = String::new();@@ -2774,16 +2824,18 @@ fn shell_tokens(command: &str, expand: bool) -> Vec<(String, bool)> {match (quote, c) {(Some('\'' | '$'), '\'') | (Some('"'), '"') => quote = None,// A backslash-newline outside single quotes continues the line.- (Some('"') | None, '\\') if chars.peek() == Some(&'\n') => {+ (Some('"') | None, '\\') if !literal && chars.peek() == Some(&'\n') => {chars.next();}// Inside double quotes a backslash escapes `"`, `\`, `$` and a// backquote, so a script a shell re-reads (`bash -c "cat \$'…'"`)// sees the `$` itself.- (Some('"'), '\\') if matches!(chars.peek(), Some('"' | '\\' | '$' | '`')) => {+ (Some('"'), '\\')+ if !literal && matches!(chars.peek(), Some('"' | '\\' | '$' | '`')) =>+ {word.extend(chars.next());}- (Some('$'), '\\') => match chars.next() {+ (Some('$'), '\\') if !literal => match chars.next() {Some(escape) => match ansi_c_escape(escape).or_else(|| {expand.then(|| ansi_c_numeric_escape(escape, &mut chars))@@ -2811,9 +2863,12 @@ fn shell_tokens(command: &str, expand: bool) -> Vec<(String, bool)> {in_word = true;}(None, '\\')- if chars.peek().is_some_and(|next| {- next.is_whitespace() || is_operator(*next) || matches!(next, '\'' | '"' | '\\')- }) =>+ if !literal+ && chars.peek().is_some_and(|next| {+ next.is_whitespace()+ || is_operator(*next)+ || matches!(next, '\'' | '"' | '\\')+ }) =>{word.extend(chars.next());in_word = true;@@ -3034,12 +3089,23 @@ struct Normalized {path: String,flavor: Flavor,}+/// [`normalize_candidates`]'s first reading.fn normalize_candidate(candidate: &str, cwd: &str) -> Option<Normalized> {- let (raw, flavor) = candidate_raw(candidate, cwd)?;- Some(Normalized {- path: normalize_segments(&raw)?,- flavor,- })+ normalize_candidates(candidate, cwd)?.into_iter().next()+}++/// Every normalized path a candidate can name ([`candidate_raw`]); `None`+/// when it is not a usable path.+fn normalize_candidates(candidate: &str, cwd: &str) -> Option<Vec<Normalized>> {+ let (raws, flavor) = candidate_raw(candidate, cwd)?;+ raws.iter()+ .map(|raw| {+ Some(Normalized {+ path: normalize_segments(raw)?,+ flavor,+ })+ })+ .collect()}/// Upper bound on the readings [`normalize_readings`] gives one glob.@@ -3056,10 +3122,25 @@ const MAX_GLOBSTAR_READINGS: usize = 16;/// when the candidate is not a usable path; `Err` past/// [`MAX_GLOBSTAR_READINGS`], which proves nothing.fn normalize_readings(candidate: &str, cwd: &str) -> Result<Option<Vec<Normalized>>, ()> {- let Some((raw, flavor)) = candidate_raw(candidate, cwd) else {+ let Some((raws, flavor)) = candidate_raw(candidate, cwd) else {return Ok(None);};- let Some((root, tail)) = split_root(&raw) else {+ let mut all = Vec::new();+ for raw in &raws {+ let Some(readings) = raw_readings(raw, flavor)? else {+ return Ok(None);+ };+ all.extend(readings);+ if all.len() > MAX_GLOBSTAR_READINGS {+ return Err(());+ }+ }+ Ok(Some(all))+}++/// [`normalize_readings`] for one joined path.+fn raw_readings(raw: &str, flavor: Flavor) -> Result<Option<Vec<Normalized>>, ()> {+ let Some((root, tail)) = split_root(raw) else {return Ok(None);};let segments: Vec<&str> = tail@@ -3320,8 +3401,9 @@ impl ClassMember {}/// A candidate joined to `cwd` when relative, with the flavor its matching-/// uses, before segment normalization.-fn candidate_raw(candidate: &str, cwd: &str) -> Option<(String, Flavor)> {+/// uses, before segment normalization: every path it can name, more than one+/// only for an ambiguous Windows spelling ([`windows_spellings`]).+fn candidate_raw(candidate: &str, cwd: &str) -> Option<(Vec<String>, Flavor)> {if candidate.trim().is_empty()|| candidate.chars().count() > MAX_CANDIDATE_PATH_CHARS|| is_drive_relative(candidate)@@ -3330,7 +3412,7 @@ fn candidate_raw(candidate: &str, cwd: &str) -> Option<(String, Flavor)> {}let cwd = normalize_root(cwd).ok()?;if flavor_of(&cwd) == Flavor::Windows {- return Some((windows_spelling(candidate, &cwd)?, Flavor::Windows));+ return Some((windows_spellings(candidate, &cwd)?, Flavor::Windows));}// Flavor must come from the host (the cwd), never from the candidate// string alone: on a POSIX host a leading `//` is an ordinary doubled@@ -3351,7 +3433,7 @@ fn candidate_raw(candidate: &str, cwd: &str) -> Option<(String, Flavor)> {raw};let flavor = flavor_of(&raw);- Some((raw, flavor))+ Some((vec![raw], flavor))}/// The absolute path Windows opens for `candidate` from the normalized/// Windows `cwd`, spelled with `/`, its `.` and `..` segments still in place.@@ -3368,12 +3450,20 @@ fn candidate_raw(candidate: &str, cwd: &str) -> Option<(String, Flavor)> {/// `name::$DATA`, the file's own content) and the trailing dots and spaces/// of every segment (`private.md.`, `secrets. `).///-/// A native tool reads `/c/x` as `C:\c\x`; only the MSYS reading is kept, so-/// a pattern under a one-letter top-level directory misses that spelling.+/// [`windows_spellings`]'s first reading: Git Bash's for `/c/x`.fn windows_spelling(candidate: &str, cwd: &str) -> Option<String> {+ windows_spellings(candidate, cwd)?.into_iter().next()+}++/// Every path Windows can open for `candidate` ([`windows_spelling`]): Git+/// Bash, MSYS2 and Cygwin read `/c/x` and `/cygdrive/c/x` as `C:\x`, but a+/// native tool reads them from the root of the cwd's drive (`C:\c\x` from+/// any directory on `C:`), so those spellings give both paths.+fn windows_spellings(candidate: &str, cwd: &str) -> Option<Vec<String>> {let one_letter =|segment: &str| segment.len() == 1 && segment.as_bytes()[0].is_ascii_alphabetic();let mut path = candidate.replace('\\', "/");+ let mut alternate = None;if let Some(rest) = ["//?/", "//./", "/??/"].iter().find_map(|prefix| path.strip_prefix(prefix))@@ -3407,20 +3497,30 @@ fn windows_spelling(candidate: &str, cwd: &str) -> Option<String> {let forward = candidate.starts_with('/');let (first, after) = rest.split_once('/').unwrap_or((rest, ""));let cygdrive = after.split_once('/').unwrap_or((after, ""));- path = if forward && one_letter(first) {- format!("{}:/{after}", first.to_ascii_uppercase())+ let (root, _) = split_root(cwd)?;+ let native = format!("{}{path}", root.trim_end_matches('/'));+ if forward && one_letter(first) {+ path = format!("{}:/{after}", first.to_ascii_uppercase());+ alternate = Some(native);} else if forward && first.eq_ignore_ascii_case("cygdrive") && one_letter(cygdrive.0) {- format!("{}:/{}", cygdrive.0.to_ascii_uppercase(), cygdrive.1)+ path = format!("{}:/{}", cygdrive.0.to_ascii_uppercase(), cygdrive.1);+ alternate = Some(native);} else {- let (root, _) = split_root(cwd)?;- format!("{}{path}", root.trim_end_matches('/'))- };+ path = native;+ }} else if !is_absolute(&path) {path = join(cwd, &path);}- let (root, tail) = split_root(&path)?;- let parts: Vec<&str> = tail.into_iter().filter_map(windows_segment).collect();- Some(join_segments(root, &parts))+ let segments = |path: &str| -> Option<String> {+ let (root, tail) = split_root(path)?;+ let parts: Vec<&str> = tail.into_iter().filter_map(windows_segment).collect();+ Some(join_segments(root, &parts))+ };+ let mut spellings = vec![segments(&path)?];+ if let Some(native) = alternate {+ spellings.push(segments(&native)?);+ }+ Some(spellings)}/// One segment as Windows reads it ([`windows_spelling`]); `None` when nothing@@ -3481,9 +3581,19 @@ fn compile(join(&marker, source)};let flavor = flavor_of(&expanded);- let path = normalize_segments(&expanded).ok_or_else(|| {- format!("ignore_paths entry {source:?} could not be normalized into a path")- })?;+ // A Windows pattern is spelled like the candidates it is compared+ // with ([`windows_spelling`]): `\\?\C:\repo\x\**` is `C:/repo/x/**`.+ let spelled = if flavor == Flavor::Windows {+ windows_spelling(&expanded, "")+ } else {+ Some(expanded)+ };+ let path = spelled+ .as_deref()+ .and_then(normalize_segments)+ .ok_or_else(|| {+ format!("ignore_paths entry {source:?} could not be normalized into a path")+ })?;Ok(CompiledPattern {literal_prefix: literal_prefix(&path).into(),directory_base: path.strip_suffix("/**").map(|base| {@@ -3580,11 +3690,20 @@ fn is_drive_relative(path: &str) -> bool {&& path.as_bytes()[1] == b':'&& (!path.as_bytes()[0].is_ascii_alphabetic() || !is_absolute(path))}+/// An absolute directory (a cwd, the marker directory, home), normalized. A+/// Windows one is read as Windows opens it ([`windows_spelling`]), so it shares+/// one spelling with every candidate and pattern resolved from it: from+/// `\\?\C:\repo`, `docs/x` and `C:\repo\docs\x` must name the same file.fn normalize_root(path: &str) -> Result<String, ()> {- (is_absolute(path) && !is_drive_relative(path))- .then(|| normalize_segments(path))- .flatten()- .ok_or(())+ if !is_absolute(path) || is_drive_relative(path) {+ return Err(());+ }+ if flavor_of(path) == Flavor::Windows {+ // Absolute, so no cwd is consulted.+ let spelled = windows_spelling(path, "").ok_or(())?;+ return normalize_segments(&spelled).ok_or(());+ }+ normalize_segments(path).ok_or(())}fn normalize_segments(path: &str) -> Option<String> {let (root, tail) = split_root(path)?;@@ -4752,8 +4871,17 @@ mod tests {fn windows_spelling_fixture_vectors() {let fixture: Value =serde_json::from_str(include_str!("../tests/fixtures/capture-policy.json")).unwrap();- for name in ["windows", "windows_posix_controls"] {- let section = &fixture[name];+ let sections = ["windows", "windows_posix_controls"]+ .iter()+ .map(|name| (*name, &fixture[*name]))+ .chain(+ fixture["windows_scopes"]+ .as_array()+ .unwrap()+ .iter()+ .map(|section| ("windows_scopes", section)),+ );+ for (name, section) in sections {let cwd = section["cwd"].as_str().unwrap();let config = CaptureConfig {ignore_paths: section["ignore_paths"]@@ -4783,7 +4911,7 @@ mod tests {assert_eq!(serde_json::to_value(decision.protocol().disposition()).unwrap(),vector["disposition"],- "{name}: {vector}"+ "{name} ({cwd}): {vector}");}}diff --git a/crates/ai-memory-hooks/tests/fixtures/capture-policy.json b/crates/ai-memory-hooks/tests/fixtures/capture-policy.jsonindex 377ce1e2..20ab9dd7 100644--- a/crates/ai-memory-hooks/tests/fixtures/capture-policy.json+++ b/crates/ai-memory-hooks/tests/fixtures/capture-policy.json@@ -395,6 +395,7 @@"protocol": {"accept":{"version":1,"disposition":"drop","policy_state":"active","tool_family":"file","path_count":1,"extraction_state":"extracted"},"reject":{"version":1,"disposition":"drop","policy_state":"active","tool_family":"file","path_count":1,"extraction_state":"extracted","paths":["SENTINEL"]}},"windows": {"note": "A Windows session (cwd C:\\repo) reads Git Bash/MSYS/Cygwin, rooted, device, administrative-share, trailing dot/space and alternate-data-stream spellings as the file they open; both matchers run `files` as an `edit` path and `shell` as a `bash` call.", "cwd": "C:\\repo", "ignore_paths": ["C:/repo/secrets/**", "C:/repo/private.md"], "files": [{"path": "/c/repo/secrets/a", "disposition": "drop"}, {"path": "/C/repo/secrets/a", "disposition": "drop"}, {"path": "/cygdrive/c/repo/secrets/a", "disposition": "drop"}, {"path": "/repo/secrets/a", "disposition": "drop"}, {"path": "\\repo\\secrets\\a", "disposition": "drop"}, {"path": "secrets.\\a", "disposition": "drop"}, {"path": "secrets \\a", "disposition": "drop"}, {"path": "C:\\repo\\secrets. .\\a", "disposition": "drop"}, {"path": "private.md.", "disposition": "drop"}, {"path": "private.md ", "disposition": "drop"}, {"path": "private.md...", "disposition": "drop"}, {"path": "private.md::$DATA", "disposition": "drop"}, {"path": "private.md:stream", "disposition": "drop"}, {"path": "PRIVATE.MD", "disposition": "drop"}, {"path": "\\\\?\\C:\\repo\\private.md", "disposition": "drop"}, {"path": "\\\\.\\C:\\repo\\private.md", "disposition": "drop"}, {"path": "\\??\\C:\\repo\\private.md", "disposition": "drop"}, {"path": "\\\\localhost\\C$\\repo\\private.md", "disposition": "drop"}, {"path": "\\\\127.0.0.1\\c$\\repo\\private.md", "disposition": "drop"}, {"path": "\\\\?\\UNC\\localhost\\C$\\repo\\private.md", "disposition": "drop"}, {"path": "/c/repo/public.md", "disposition": "keep"}, {"path": "/d/repo/secrets/a", "disposition": "keep"}, {"path": "/cygdrive/d/repo/secrets/a", "disposition": "keep"}, {"path": "/repo/public/a", "disposition": "keep"}, {"path": "private.md.bak", "disposition": "keep"}, {"path": "public.md:private.md", "disposition": "keep"}, {"path": "\\\\localhost\\D$\\repo\\private.md", "disposition": "keep"}, {"path": "\\\\server\\C$\\repo\\private.md", "disposition": "keep"}, {"path": "\\\\.\\pipe\\private.md", "disposition": "metadata-only"}], "shell": [{"command": "cat /c/repo/secrets/a", "disposition": "drop"}, {"command": "cat /C/repo/secrets/a", "disposition": "drop"}, {"command": "cat /cygdrive/c/repo/secrets/a", "disposition": "drop"}, {"command": "cat /repo/secrets/a", "disposition": "drop"}, {"command": "type \\repo\\secrets\\a", "disposition": "drop"}, {"command": "cat secrets./a", "disposition": "drop"}, {"command": "cat 'private.md.'", "disposition": "drop"}, {"command": "cat 'private.md '", "disposition": "drop"}, {"command": "cat 'private.md::$DATA'", "disposition": "drop"}, {"command": "more < private.md:stream", "disposition": "drop"}, {"command": "type '\\\\?\\C:\\repo\\private.md'", "disposition": "drop"}, {"command": "type '\\\\localhost\\C$\\repo\\private.md'", "disposition": "drop"}, {"payload": {"tool": "bash", "args": {"command": "cat secrets/a", "workdir": "/c/repo"}}, "disposition": "drop"}, {"command": "cat /c/repo/public.md", "disposition": "keep"}, {"command": "cat /d/repo/secrets/a", "disposition": "keep"}, {"command": "cat 'private.md.bak'", "disposition": "keep"}, {"payload": {"tool": "bash", "args": {"command": "cat secrets/a", "workdir": "/c/other"}}, "disposition": "keep"}]},"windows_posix_controls": {"note": "The Windows readings never apply to a POSIX session: there a trailing dot, a colon or a one-letter top-level directory is part of the name.", "cwd": "/repo", "ignore_paths": ["/repo/secrets/**", "/repo/private.md", "/c/repo/drive/**"], "files": [{"path": "/repo/secrets/a", "disposition": "drop"}, {"path": "/c/repo/drive/a", "disposition": "drop"}, {"path": "/c/repo/secrets/a", "disposition": "keep"}, {"path": "secrets./a", "disposition": "keep"}, {"path": "private.md.", "disposition": "keep"}, {"path": "private.md:stream", "disposition": "keep"}, {"path": "/cygdrive/c/repo/drive/a", "disposition": "keep"}]},- "marker_spellings": {"note": "Every TOML spelling of the capture table the native parser (toml_edit) honours, and the ones it rejects; the TypeScript reader must agree. Each declares `secret/**`.", "honoured": ["capture.ignore_paths = [\"secret/**\"]\n", "capture . \"ignore_paths\" = [\"secret/**\"]\n[other]\nx = 1\n", "[ capture ]\nignore_paths = [\"secret/**\"]\n", "[\"capture\"]\nignore_paths = [\"secret/**\"]\n", "['capture']\n'ignore_paths' = [\"secret/**\"]\n", "[\"\\u0063apture\"]\nignore_paths = [\"secret/**\"]\n", "[[tools]]\nname = \"x\"\n[capture]\nignore_paths = [\"secret/**\"]\n"], "rejected": ["capture = { ignore_paths = [\"secret/**\"] }\n", "[[capture]]\nignore_paths = [\"secret/**\"]\n", "[capture.extra]\nx = 1\n", "capture = 1\n", "[capture]\nignore_paths = [\"secret/**\"]\n[capture]\n", "capture.ignore_paths = [\"secret/**\"]\n[capture]\n"], "unrelated": ["[tool]\ncapture.ignore_paths = [\"secret/**\"]\n", "x = 1\n"]},+ "windows_scopes": [{"note": "F1: a device-prefixed cwd and marker directory share the candidates' spelling.", "cwd": "\\\\?\\C:\\repo", "ignore_paths": ["docs/private/**"], "files": [{"path": "\\\\?\\C:\\repo\\docs\\private\\a.md", "disposition": "drop"}, {"path": "docs\\private\\a.md", "disposition": "drop"}, {"path": "C:\\repo\\docs\\private\\a.md", "disposition": "drop"}, {"path": "/c/repo/docs/private/a.md", "disposition": "drop"}, {"path": "\\\\?\\C:\\repo\\docs\\public\\a.md", "disposition": "keep"}, {"path": "docs/public/a.md", "disposition": "keep"}, {"path": "D:\\repo\\docs\\private\\a.md", "disposition": "keep"}], "shell": [{"command": "cat docs/private/a.md", "disposition": "drop"}, {"command": "Get-Content \\\\?\\C:\\repo\\docs\\private\\a.md", "disposition": "drop"}, {"command": "cat docs/public/a.md", "disposition": "keep"}]}, {"cwd": "\\\\?\\UNC\\srv\\sh\\repo", "ignore_paths": ["docs/private/**"], "files": [{"path": "\\\\?\\UNC\\srv\\sh\\repo\\docs\\private\\a.md", "disposition": "drop"}, {"path": "\\\\srv\\sh\\repo\\docs\\private\\a.md", "disposition": "drop"}, {"path": "docs\\private\\a.md", "disposition": "drop"}, {"path": "\\\\srv\\sh\\repo\\docs\\public\\a.md", "disposition": "keep"}, {"path": "\\\\srv\\other\\repo\\docs\\private\\a.md", "disposition": "keep"}], "shell": [{"command": "type docs\\private\\a.md", "disposition": "drop"}, {"command": "type docs\\public\\a.md", "disposition": "keep"}]}, {"cwd": "\\\\localhost\\C$\\repo", "ignore_paths": ["docs/private/**"], "files": [{"path": "\\\\localhost\\C$\\repo\\docs\\private\\a.md", "disposition": "drop"}, {"path": "C:\\repo\\docs\\private\\a.md", "disposition": "drop"}, {"path": "docs\\private\\a.md", "disposition": "drop"}, {"path": "D:\\repo\\docs\\private\\a.md", "disposition": "keep"}, {"path": "docs\\public\\a.md", "disposition": "keep"}]}, {"note": "F1: an absolute device-prefixed pattern is spelled like the candidates.", "cwd": "C:\\repo", "ignore_paths": ["\\\\?\\C:\\repo\\docs\\private\\**", "\\\\.\\C:\\repo\\secret.md"], "files": [{"path": "C:\\repo\\docs\\private\\a.md", "disposition": "drop"}, {"path": "docs\\private\\a.md", "disposition": "drop"}, {"path": "\\\\?\\C:\\repo\\docs\\private\\a.md", "disposition": "drop"}, {"path": "secret.md", "disposition": "drop"}, {"path": "C:\\repo\\docs\\public\\a.md", "disposition": "keep"}, {"path": "secret.md.bak", "disposition": "keep"}], "shell": [{"command": "cat docs/private/a.md", "disposition": "drop"}, {"command": "cat docs/public/a.md", "disposition": "keep"}]}, {"note": "F2: PowerShell and cmd keep a backslash literal, so a bare or double-quoted `\\\\` path is a UNC or device path.", "cwd": "C:\\Users\\u\\repo", "ignore_paths": ["\\\\srv\\share\\repo\\docs\\private\\**", "C:\\Users\\u\\repo\\docs\\private\\**"], "files": [], "shell": [{"command": "Get-Content \\\\srv\\share\\repo\\docs\\private\\a.md", "disposition": "drop"}, {"command": "Get-Content \"\\\\srv\\share\\repo\\docs\\private\\a.md\"", "disposition": "drop"}, {"command": "type \\\\?\\C:\\Users\\u\\repo\\docs\\private\\a.md", "disposition": "drop"}, {"command": "type \"\\\\.\\C:\\Users\\u\\repo\\docs\\private\\a.md\"", "disposition": "drop"}, {"command": "Get-Content \\\\localhost\\c$\\Users\\u\\repo\\docs\\private\\a.md", "disposition": "drop"}, {"command": "type \\\\?\\UNC\\srv\\share\\repo\\docs\\private\\a.md", "disposition": "drop"}, {"command": "type \\\\sr^v\\share\\repo\\docs\\private\\a.md", "disposition": "drop"}, {"payload": {"tool": "shell", "args": {"command": ["powershell", "-Command", "Get-Content \\\\srv\\share\\repo\\docs\\private\\a.md"]}}, "disposition": "drop"}, {"payload": {"tool": "run_shell_command", "args": {"command": "Get-Content \\\\srv\\share\\repo\\docs\\private\\a.md"}}, "disposition": "drop"}, {"payload": {"tool": "powershell", "args": {"command": "Get-Content \\\\srv\\share\\repo\\docs\\private\\a.md"}}, "disposition": "drop"}, {"command": "Get-Content \\\\srv\\share\\repo\\docs\\public\\a.md", "disposition": "keep"}, {"command": "type \"\\\\.\\C:\\Users\\u\\repo\\docs\\public\\a.md\"", "disposition": "keep"}, {"payload": {"tool": "shell", "args": {"command": ["powershell", "-Command", "Get-Content \\\\srv\\share\\repo\\docs\\public\\a.md"]}}, "disposition": "keep"}]}, {"cwd": "\\\\srv\\share\\repo", "ignore_paths": ["docs/private/**"], "files": [{"path": "\\\\srv\\share\\repo\\docs\\private\\a.md", "disposition": "drop"}], "shell": [{"command": "Get-Content \\\\srv\\share\\repo\\docs\\private\\a.md", "disposition": "drop"}, {"command": "cat \"\\\\srv\\share\\repo\\docs\\private\\a.md\"", "disposition": "drop"}, {"command": "Get-Content \\\\srv\\share\\repo\\docs\\public\\a.md", "disposition": "keep"}]}, {"note": "F3: a native tool reads `/a/x` from the root of the cwd's drive, Git Bash as `A:\\x`; both readings count.", "cwd": "D:\\a\\proj\\proj", "ignore_paths": ["docs/private/**"], "files": [{"path": "/a/proj/proj/docs/private/a.md", "disposition": "drop"}, {"path": "/d/a/proj/proj/docs/private/a.md", "disposition": "drop"}, {"path": "/a/proj/proj/docs/public/a.md", "disposition": "keep"}, {"path": "/b/proj/proj/docs/private/a.md", "disposition": "keep"}], "shell": [{"command": "cat /a/proj/proj/docs/private/a.md", "disposition": "drop"}, {"command": "cat /a/proj/proj/docs/public/a.md", "disposition": "keep"}]}],+ "marker_spellings": {"note": "Every TOML spelling of the capture table the native parser (toml_edit) honours, and the ones it rejects; the TypeScript reader must agree. Each declares `secret/**`.", "honoured": ["capture.ignore_paths = [\"secret/**\"]\n", "capture . \"ignore_paths\" = [\"secret/**\"]\n[other]\nx = 1\n", "[ capture ]\nignore_paths = [\"secret/**\"]\n", "[\"capture\"]\nignore_paths = [\"secret/**\"]\n", "['capture']\n'ignore_paths' = [\"secret/**\"]\n", "[\"\\u0063apture\"]\nignore_paths = [\"secret/**\"]\n", "[[tools]]\nname = \"x\"\n[capture]\nignore_paths = [\"secret/**\"]\n", "tags = [\n [\"docs\"]\n]\ncapture.ignore_paths = [\"secret/**\"]\n", "[capture]\nignore_paths = [\n \"secret/**\",\n]\n[other]\nlist = [\n [\"a\", \"[b]\"],\n { k = \"[x]\" },\n]\n", "x = { a = [\n [1]\n] }\n[capture]\nignore_paths = [\"secret/**\"]\n"], "rejected": ["capture = { ignore_paths = [\"secret/**\"] }\n", "[[capture]]\nignore_paths = [\"secret/**\"]\n", "[capture.extra]\nx = 1\n", "capture = 1\n", "[capture]\nignore_paths = [\"secret/**\"]\n[capture]\n", "capture.ignore_paths = [\"secret/**\"]\n[capture]\n", "x = [\ncapture.ignore_paths = [\"secret/**\"]\n]\n", "x = [\n \"a\",\n] y = 1\ncapture.ignore_paths = [\"secret/**\"]\n", "x = {\n}\ncapture.ignore_paths = [\"secret/**\"]\n"], "unrelated": ["[tool]\ncapture.ignore_paths = [\"secret/**\"]\n", "x = 1\n", "x = [\n [\"capture\"],\n \"ignore_paths\",\n]\n"]},"tool_families": [{"name": "read", "family": "file"}, {"name": "write", "family": "file"}, {"name": "edit", "family": "file"}, {"name": "apply_patch", "family": "file"}, {"name": "notebookedit", "family": "file"}, {"name": "notebook_edit", "family": "file"}, {"name": "create_file", "family": "file"}, {"name": "delete_file", "family": "file"}, {"name": "remove", "family": "file"}, {"name": "rename_file", "family": "file"}, {"name": "move_file", "family": "file"}, {"name": "multi_edit", "family": "file"}, {"name": "multiedit", "family": "file"}, {"name": "replace", "family": "file"}, {"name": "replace_all", "family": "file"}, {"name": "view_file", "family": "file"}, {"name": "replace_file_content", "family": "file"}, {"name": "multi_replace_file_content", "family": "file"}, {"name": "write_to_file", "family": "file"}, {"name": "fs_read", "family": "file"}, {"name": "fs_write", "family": "file"}, {"name": "read_file", "family": "file"}, {"name": "write_file", "family": "file"}, {"name": "edit_file", "family": "file"}, {"name": "patch", "family": "file"}, {"name": "read_many_files", "family": "file"}, {"name": "search", "family": "search-list"}, {"name": "grep", "family": "search-list"}, {"name": "glob", "family": "search-list"}, {"name": "find", "family": "search-list"}, {"name": "list", "family": "search-list"}, {"name": "ls", "family": "search-list"}, {"name": "list_files", "family": "search-list"}, {"name": "read_dir", "family": "search-list"}, {"name": "list_dir", "family": "search-list"}, {"name": "grep_search", "family": "search-list"}, {"name": "search_files", "family": "search-list"}, {"name": "find_by_name", "family": "search-list"}, {"name": "list_directory", "family": "search-list"}, {"name": "search_file_content", "family": "search-list"}, {"name": "bash", "family": "non-file"}, {"name": "shell", "family": "non-file"}, {"name": "shell_command", "family": "non-file"}, {"name": "exec", "family": "non-file"}, {"name": "execute", "family": "non-file"}, {"name": "run_command", "family": "non-file"}, {"name": "web_search", "family": "non-file"}, {"name": "search_web", "family": "non-file"}, {"name": "manage_task", "family": "non-file"}, {"name": "manage_subagents", "family": "non-file"}, {"name": "terminal", "family": "non-file"}, {"name": "execute_bash", "family": "non-file"}, {"name": "execute_cmd", "family": "non-file"}, {"name": "powershell", "family": "non-file"}, {"name": "run_shell_command", "family": "non-file"}, {"name": "execute_code", "family": "non-file"}, {"name": "browser_exec", "family": "non-file"}, {"name": "browser_navigate", "family": "non-file"}, {"name": "web_extract", "family": "non-file"}, {"name": "web_fetch", "family": "non-file"}, {"name": "delegate_task", "family": "non-file"}, {"name": "bashoutput", "family": "unknown"}, {"name": "taskoutput", "family": "unknown"}, {"name": "write_stdin", "family": "unknown"}, {"name": "process", "family": "unknown"}, {"name": "read_bash", "family": "unknown"}, {"name": "write_bash", "family": "unknown"}, {"name": "read_powershell", "family": "unknown"}, {"name": "write_powershell", "family": "unknown"}, {"name": "todowrite", "family": "unknown"}, {"name": "mcp__x__read", "family": "unknown"}, {"name": "view", "family": "unknown"}, {"name": "Read_File", "family": "file"}, {"name": "Execute_Code", "family": "non-file"}]}diff --git a/docs/marker-file.md b/docs/marker-file.mdindex 6753ef1f..869bb3a5 100644--- a/docs/marker-file.md+++ b/docs/marker-file.md@@ -645,7 +645,16 @@ path without a drive (`/repo/x`, `\repo\x`) is on the `cwd`'s drive; thealternate data stream suffix (`private.md::$DATA`, `private.md:stream`) and thetrailing dots and spaces of each segment (`private.md.`, `secrets. \x`) aredropped. Any other device path (`\\.\pipe\x`) makes a file tool-metadata-only. None of this applies to a POSIX session, where `/c/x`, a+metadata-only. A native tool reads `/c/x` from the root of the `cwd`'s drive+(`D:\c\x` from `D:\repo`) rather than as Git Bash does, so both readings are+checked and either one matching drops the call. The `cwd`, the marker's+directory and an absolute pattern are read the same way, so a session started+from `\\?\C:\repo`, `\\?\UNC\server\share\repo` or `\\localhost\C$\repo`+matches `docs/private/**` against `C:\repo\docs\private\a.md`, and a pattern+spelled `\\?\C:\repo\docs\private\**` matches it from `C:\repo`. PowerShell+and cmd do not escape with a backslash, so a shell command is also read with+every backslash kept: `Get-Content \\server\share\x`, bare or double-quoted,+names the UNC path. None of this applies to a POSIX session, where `/c/x`, atrailing dot or a colon is part of the name.A checkout's exclusions protect its files wherever a call is made from. For@@ -763,9 +772,10 @@ can be mentioned.- a value glued to a short flag is read after the flag's first letter only,not after a cluster (`-rf…`), and a `file:` URL's non-ASCII percent-escapesare not decoded;-- in a Windows session `/c/x` is read only as Git Bash reads it- (`C:\x`), so a native tool's reading of it (`C:\c\x`, under a one-letter- top-level directory) is not matched;+- in a Windows session a shell tool's `workdir` spelled `/c/x` is read only+ as Git Bash reads it (`C:\x`), so arguments resolved from it miss a native+ tool's reading (`D:\c\x` from a `cwd` on `D:`); a file-tool path or shell+ argument spelled that way is read both ways;- the generated TypeScript integrations check the `[capture]` table asstrictly as the native hook but do not validate the rest of the marker'sTOML, so a syntax error elsewhere in the file invalidates the policy only indiff --git a/docs/security-boundaries.md b/docs/security-boundaries.mdindex 5d3106bc..481cc273 100644--- a/docs/security-boundaries.md+++ b/docs/security-boundaries.md@@ -66,7 +66,7 @@ means the boundary is not built yet.| 10e | Reconcile-tombstone of a disk-deleted page is opt-in, soft, scope-bound, and false-positive-guarded (invariant #16, #929 delete-half) | `ai-memory-wiki/src/watcher.rs` — off by default (`[maintenance] reconcile_tombstones_deleted_pages`); a page is tombstoned only after its file is observed missing on two consecutive passes (streak resets if the path's `PageId` changed), re-verified against the live filesystem immediately before acting, with reserved/indexed-but-unwalked paths (`bootstrap.md`, `_meta.md`, `_pending/`, `sessions/*.md`) excluded and a circuit breaker that skips a whole scope when `> max(3, 50%)` of its pages look missing or a non-partial walk finds nothing; `ai-memory-store/src/ops.rs` `soft_delete_for_reconcile_if_latest` is a soft tombstone (`is_latest=0` + `superseded_at`, decay's shape) through the single writer actor in one transaction — never a filesystem write — scoped to the page's own `(workspace_id, project_id)` | `watcher.rs` `reconcile_delete_disabled_by_default_never_tombstones_a_missing_page`, `reconcile_delete_cross_project_isolation` (project A's deletion never tombstones project B's same-path page), `reconcile_tombstone_refuses_a_stale_latest_id`, `reconcile_tombstone_refuses_when_the_file_still_exists`, `reconcile_tombstone_never_touches_the_filesystem`; `ops.rs` `reconcile_tombstone_resurrects_instead_of_orphaning_on_recreate` | STRONG || 10f | Session-time repair is scope-bound (no cross-project timestamp rewrite) | `ai-memory-store/src/ops.rs` `repair_session_times` — every candidate is read back and updated with `WHERE id=? AND workspace_id=? AND project_id=?`; a row outside that 3-tuple is reported `NotFound` and untouched, same code path as an id that does not exist at all; `ai-memory-mcp/src/admin.rs` `handle_repair_session_times` passes the caller's `(workspace, project)` straight through, never the candidate's own | `ops.rs` `repair_session_times_does_not_touch_a_session_of_another_project` (control: sibling session in-scope repaired in the same batch); `admin_repair_session_times.rs` `cross_project_session_is_not_found_and_untouched`; both bite-checked by dropping the `project_id` filter | STRONG || 11a | Hook backpressure (202/429) + bounded fan-out (invariant #5) | `ai-memory-hooks/src/router.rs` semaphore→429, 202 immediately, `MAX_HOOK_BATCH_ITEMS`, bounded LRU limiter; batch acknowledgements retain only processed indices and classify terminal drops without consuming capacity | `router.rs` `handle_hook_returns_429_when_ingest_saturated`, `ingest_rate_limiter_is_bounded`; `router.rs` `handle_hook_batch_skips_rate_limited_first_item_and_accepts_later_source`, `handle_hook_batch_reports_failed_index_after_rate_limited_skip`, `handle_hook_batch_drops_subagent_events_before_capacity_check` (each asserts result indices and includes an accepted control) | STRONG |-| 11b | Capture exclusions drop before storage | `ai-memory-hooks` `capture_policy.rs` `inspect`→`Drop` (before semaphore/spawn), including shell commands whose arguments name an ignored path (`match_command`; argv elements matched whole and tokenized, and every word that holds several words, such as a quoted `sh -c` script or a `"$(…)"` substitution, re-split to four levels by `ShellCommand::split`/`push_nested_words`, a deeper script metadata-only; ANSI-C strings decoded and a backslash before an ordinary letter dropped (`shell_words`, `push_word`); backslash-newline continuations joined (`shell_words`); a parameter default's operand, a value glued to a short flag and a `file:` URL's path read as candidates (`parameter_operands`, `shell_arguments`, `file_url_path`); PowerShell and cmd escape characters read out under the `PowerShell` tool or on a Windows host (`without_windows_escapes`); `~+` resolved to the cwd and a `~-`/`~N`/`~name` prefix metadata-only (`names_unknown_directory`); shell and interpreter options that take a value skipped while looking for a `-c` script or inline code (`takes_shell_value`, `runs_inline_code`, which also lists `lua`/`Rscript`/`osascript -e`, and `su -c`/`script -c` as script runners); paths compared without regard to case on a macOS host (`fold_case`, set by `resolve`; patterns and candidates composed to NFC and lowercased in full by `fold_path`, TS `captureFold`; client-only, the server's sentinel re-inspection never depends on it); a `file:` URL cut at its query or fragment before decoding (`file_url_path`); a parameter default nested past four levels metadata-only and a default read again after backslash removal (`parameter_operands`, `push_word_reading`); a tilde expanded or treated as an unknown directory only when the shell expands it, unquoted and in a script rather than a quoted message or argv element, every tilde under PowerShell (`marked_shell_words`, `literal_tildes`, `expand_tilde`); a file or shell read of a harness's saved tool output, or a glob that could match one, metadata-only under an active policy (`output_spool`: Claude Code `tool-results/` and `tasks/*.output`, OpenCode `tool-output/`, Pi `pi-bash-*.log`; glob segments fit a name they share a match with, `globs_intersect`, TS `captureGlobsIntersect`, and one fitting segment must spell three characters in a row of that name's distinctive text literally, `spells`, TS `captureSpells`, so `*.log` is not read as `pi-bash-*.log`, a trade-off that leaves a glob with no such literal run, `/tmp/p?-b*`, outside the rule; the TS matcher applies it to `read_many_files` entries too); every other marker governing a file-tool target (an `apply_patch`'s header paths, read after leading whitespace, `patch_paths`), a search/list tool's directory, file or path-like glob argument (`search_scope`, Hermes `file_glob` included; a grep `pattern` is not read) or a separator-bearing shell argument also inspects the call, found by the lexical marker walk from each location's nearest existing directory, each directory's answer remembered for every lookup that passes it (`marker.rs` `MarkerMemo`, TS `captureMemoMarker`, seeded with the event's own walk, `remember`, TS `captureMemoRemember`), bounded (4,096 locations, 16 markers, and 16,384 probes sharing the glob walk's 50 ms, `MAX_LOOKUP_PROBES`, TS `CAPTURE_MAX_LOOKUP_PROBES`; locations outside the own checkout are looked up first, a glob's literal root before the walk below it (whose single listing can spend the time budget on a large directory), and past a bound fail closed as under an invalid policy, while running out inside the own checkout, whose locations are looked up shallowest first, ends the lookup, its own policy governing there) and combined strictest-first (`capture_lookup_locations`, `CaptureDecision::stricter`, `hook.rs` `foreign_capture_decision`, also applied by `transcript_capture.rs` `decide_call`; TS `captureForeignConfigs`, `captureDecide`, `captureSearchScope`, `capturePatchPaths`); a location with glob syntax is looked up from its literal root and, when that root lies outside the event's `.git` checkout, every directory the glob could pass through is checked for a marker (`glob_walk`, `hook.rs` `GlobBudget::markers_below`; TS `captureGlobWalk`, `captureMarkersBelow`, `captureOwnCheckout`: a `*`/`?` segment lists the child directories it matches, a class/brace/group every child, a `**` the subtree except the event's checkout's; a glob rooted inside the event's checkout is not walked; a checkout root at or above the home directory, or the filesystem root, is never the own checkout for these rules (`own_checkout`), so a dotfiles `~/.git` does not stop the walk from `~/Projects`; symlinks never followed; 256 directories, counted as a `**` lists, 32,768 entries and 50 ms, `MAX_GLOB_TIME`, TS `CAPTURE_MAX_GLOB_MS`, injectable clock, past which, or for a brace/group spanning a separator, a `..`/`~` alternative or one a bounded brace expansion builds, `brace_alternatives`, TS `captureBraceAlternatives`, a directory alternative bash before 5.2 expands to `..` (`.{*,x}/`), or an expansion too large to list whose pieces could build one of these (`brace_overflow_could_leave`, TS `captureBraceOverflowLeaves`: integer and letter sequences cannot, so `file{1..200}.txt` is walked like any glob), the call fails closed); a `..` after a `**` is read both as the `**` matching no directory and as matching some, by the event's own matcher and the lookup (`normalize_readings`, TS `captureReadings`, at most 16 readings, past which the call fails closed), and so is a directory segment that bash before 5.2 can expand to `..` (`could_name_parent`, `class_glob_matches` with POSIX classes such as `[[:punct:]]` and extglob groups such as `@(.)`, `?(.)`, `*(.)`, `+(.)`, `!(x)`; TS `captureCouldNameParent`, `captureClassGlob`, `captureNamedClass`), read as `..` too; inside double quotes a backslash before `$` or a backquote is dropped, so a quoted script (`bash -c "…"`, `eval "…"`) re-split for its words reads an ANSI-C string as the shell it runs does (`shell_tokens`, TS `captureMarkedWords`); a zsh glob group kept in its word and ANSI-C numeric escapes decoded are fed to the lookup (`shell_tokens` with `expand`, `ShellWords::expanded`, `glob_group`, `ansi_c_numeric_escape`; TS `captureMarkedWords(…, true)`, `captureGlobGroup`, `captureAnsiNumeric`); a file tool whose targets cannot be read or resolved, and a search/list argument that is not a string, fail closed; the path of a git `REV:path` object name tried from the cwd and the marker directory (`git_object_path`); Antigravity `run_command` resolved from its `Cwd`); an invalid marker makes file, search/list and shell calls metadata-only; an active one makes a shell call metadata-only when a word uses unquoted brace expansion, a bracket class (a leading `]` included), a zsh glob group or extglob, or a numeric/control ANSI-C escape (`has_unevaluated_expansion`, also run on scripts given to `sh -c`, `eval` or a substitution), or when it runs inline interpreter code (`runs_inline_code`: `python -c`, `node -e`, `ruby -e`, `perl -e`, `php -r`, `deno eval`), and either makes tools that read back an earlier command's output metadata-only (`reads_earlier_output`: `BashOutput`, `TaskOutput`, `write_stdin`, `process`, `read_bash`/`write_bash` and PowerShell twins); the server admits a metadata-only shell or unknown-family body only under an active or invalid marker, with no paths and an `extracted` state (`router.rs` `metadata_protocol_is_legal`), and its own re-inspection strips an older client's keep for either; a Gemini `read_many_files` literal entry is also read as `entry/**` (`glob_matches_below`), and Copilot CLI's runtime `view`/`create`/`str_replace_editor` are file tools for that agent only (`agent_family`); generated OpenCode/OMP/Pi/OpenClaw integrations mirror it in `render_shared.rs` `ts_capture_policy_v1` (`captureMatchCommand`, `captureShellSplit`, `captureUnevaluatedExpansion`, `captureInlineCode`, `captureGitObjectPath`, `captureGlobBelow`, the `reader` flag). Candidate/argument flavor (`Flavor::Posix` vs `Flavor::Windows`, used to pick which `ignore_paths` patterns even apply) is derived from the **host** (the cwd), never from the candidate string alone — a POSIX-host candidate spelled with a leading `//` is collapsed to a single `/` before flavor detection (`normalize_candidate`; TS `captureNormalize`'s `windowsHost` parameter, sourced from `captureHostWindows(cwd)`), fixing GHSA-vh98 (a `//`-prefixed candidate used to self-classify as `Flavor::Windows` regardless of host, matching zero POSIX patterns and being captured instead of dropped); a genuine Windows/UNC host (cwd itself windows-flavored) is unaffected; `hook.rs` `--check-capture` preflight uses the same capture policy before any spool or spawn; transcript imports (`ai-memory backfill`, including the automatic first-boot run, and the `ai-memory run` ledger upload) apply the same decision table through `commands/transcript_capture.rs`: each recorded tool call is rebuilt in its agent's hook shape (`capture_policy.rs` `tool_call_payload`) and inspected by the checkout's policy, and by a reroute destination's policy too; a Drop removes the call and its result (paired by native id, else the strictest call of the turn when the result has no id; a result whose id matches no call, or with no call, follows the orphan rule: dropped under a policy, content-free without one), metadata-only posts the hook's metadata-only body with its protocol (backfill) or a withheld placeholder keeping only the family and a call id that passes the server's `valid_call_id` (ledger), and a shell call whose recorded arguments cannot be parsed drops; both imports also apply the hook's repository admission gate (`hook.rs` `checkout_admits_capture`: persisted capture mode, marker opt-in, readable routing marker — the same helpers the hook's own gate uses), so under allowlist mode an unmarked checkout imports nothing, prompts included: `backfill` stops before contacting the server and the run ledger finishes with no events; a tool the transcript names differently from the hook is rebuilt under the hook's name and fields (`capture_policy.rs` `hook_tool_call`: Codex `exec_command` `{cmd, workdir}` → `Bash` `{command, workdir}`); the Claude Code and Codex JSONL adapters label each event with its record's cwd (`transcript.rs` `stamp_record_cwd`, `RECORD_CWD_KEY`), from which the import resolves arguments, policy and reroutes, falling back to the session cwd, and which is removed before a ledger upload; a rerouted call, and an event whose record cwd lies outside the checkout, must pass that directory's admission gate, resolve to the same server-profile route as the checkout and to the same project scope (`transcript_capture.rs` `admits_elsewhere` → `hook.rs` `checkout_admits_capture` + `delivers_to_same_server`, which compares two `resolve_hook_route` results and never matches a refused selection, + `routes_to_same_project`, which compares the two `hook_scope` hint sets and, when they leave the project to the server, under `repo-root` the repository/marker anchor or the directory itself, under the default `basename` the directory itself or a destination inside the repository whose root is the source), else it drops with its result, since the import files every event under the importing project; compaction, checkpoint and annotation events answer to the same record-cwd checks; Claude Code `!` shell-mode output (a user message opening with a `<bash-stdout>`/`<bash-stderr>`/`<local-command-stdout>` block, whatever it holds) is dropped (`shell_mode_output`); the Claude Code adapter excludes harness-written background-task turns (`transcript.rs` `claude_task_notification`: `origin.kind` `task-notification` in any case, or a first text block opening with a `<task-notification` tag in any case, attributes allowed, after a byte-order mark, zero-width characters or whitespace) and records a compaction summary (`isCompactSummary` true, `"true"` or `1`, `truthy`) as a compaction event, which backfill does not post; a tool the matcher does not recognize (unknown family: MCP tools, Codex `view_image`, …) keeps only its family whatever the policy, as the live server stores for it (`EventCapture::Unrecognized`: backfill posts title `tool unknown` and body `tool_family: unknown`, the ledger a withheld placeholder), and so does a result with no call to inherit from ; in a Windows session every candidate, shell argument and `workdir` is read as the file Windows opens before matching (`windows_spelling`, `windows_segment`, `command_base`; TS `captureWindowsSpelling`/`captureResolve`/`captureBase`): Git Bash/MSYS2/Cygwin `/c/…` and `/cygdrive/c/…`, a drive-less rooted path on the cwd's drive, the `\\?\`/`\\.\`/`\??\` and `UNC` prefixes, the local administrative share (`\\localhost\C$`), and per-segment alternate-data-stream suffixes and trailing dots/spaces, any other device path unusable (metadata-only for a file tool); the harness-spool check is linear in the path and charged to the match budget, past it fail-closed (`output_spool`, TS `captureOutputSpool`); a shell command over `MAX_SHELL_COMMAND_CHARS` (1 MiB) is metadata-only and its marker lookup unprovable (`ShellCommand::oversized`, TS `captureCommandOversized`); Hermes `execute_code` is metadata-only under an active policy (`INLINE_CODE_TOOL_NAMES`); the TS file/search/non-file/inline-code/output-reader tool lists and the command limit are generated from the native constants (`FILE_TOOL_NAMES` and siblings, spliced by `ts_capture_policy_v1`), and the TS marker reader honours every TOML spelling of the capture table toml_edit does (dotted `capture.ignore_paths`, quoted or spaced `[capture]` headers) and fails closed on the shapes it rejects (inline table, `[[capture]]`, `[capture.x]`, a second definition) (`captureTomlKey` and the `captureConfigAt` section loop); the TS glob walk reads a directory one entry at a time with `opendirSync`, stopping at the entry bound (GHSA-gcpc-88hm-3xqr) | `capture_policy.rs` per-agent `…honors_exclusions` tests, `shell_fixture_vectors` (shared `capture-policy.json` `shell` drop/keep vectors: tool aliases incl. OpenClaw/Devin `exec` and `PowerShell`, `workdir`, glob directories, Windows paths, and a POSIX-host leading-`//` command via `/{root}/docs/adr/x.md`), `shell_tool_shapes_of_every_adapter_honor_exclusions`, `claude_code_powershell_honors_ignored_paths_on_a_windows_host` (#1186: Windows-spelled and `-Param:value` paths drop, public-path and `git status` controls kept, invalid marker metadata-only), `gemini_cli_shell_and_read_many_files_honor_ignored_paths` (Gemini `run_shell_command` incl. `dir_path`/`directory`, and `read_many_files` globs via `match_globs`: excluded literal, mixed public+excluded, `docs/*`, recursive `**` and case-variant entries drop, an `exclude` list cannot rescue them, unsupported glob syntax and malformed lists are metadata-only, public entries kept, POSIX and Windows hosts) and `globstar_reaches_lets_double_star_span_any_depth`, `fixture_vectors` (incl. TS-adapter `bash`/`exec` vectors, and `normalization`'s leading-`//` POSIX vectors alongside the kept Windows-cwd UNC vectors as the no-regression control); `shell_matching_is_off_when_inactive_and_fails_closed_when_invalid_or_over_budget`; `router.rs` `capture_protocol_shell_decisions_survive_server_reinspection`, `capture_protocol_invalid_marker_shell_is_metadata_only` (active metadata-only shell admitted for an unevaluated expansion, inactive refused, older client's invalid-marker keep stripped, commandless control kept), `capture_protocol_unparseable_marker_strips_shell_events` (server fallback for an unparseable marker), `capture_protocol_invalid_shell_metadata_claim_must_be_canonical` (a stripped shell claim with a path count or non-`extracted` state is refused); `capture_policy.rs` `invalid_marker_strips_shell_calls_with_unparseable_commands`, `long_bash_lc_script_in_argv_is_not_dropped_by_the_match_budget`, **`a_leading_double_slash_candidate_does_not_escape_posix_ignore_paths_via_flavor_mismatch`** (GHSA-vh98 adversarial: attempts the `//repo/secret/...` violation on a POSIX host, proves it now drops, with a plain-single-slash control and a Windows-hosted genuine-UNC control both still correct — fails on the pre-fix code); `hook.rs` `shell_command_reading_an_ignored_path_is_dropped_before_spool`, `gemini_cli_shell_and_read_many_files_exclusions_drop_before_spool` (pre- and post-tool events with an excluded path are never spooled; public controls spool with their family); `capture_policy.rs` `read_many_files_directory_entries_cannot_reach_ignored_paths` (shared `read_many_files_directories` vectors: `docs`, `.`, `./`, `docs/`, case and `..` variants drop; `src`, `README.md`, `docs/adrx` kept), `output_reader_tools_are_metadata_only_only_under_a_policy` (active and invalid strip, inactive and an unrelated unknown tool keep), `copilot_cli_runtime_file_tools_are_scoped_to_copilot`, `unevaluated_shell_expansions_respect_quoting` (also leading-`]` classes, zsh groups and extglobs, ANSI-C numeric escapes; subshells, `$((…))`, `<(…)`, array assignments kept), the shell fixture's brace/class vectors (quoted, escaped, `${…}`, `{}`, `[ … ]`, `HEAD@{1}` controls kept); `quoted_scripts_in_string_commands_are_read_like_command_lines` (`sh -c`, `timeout … bash -c`, `"$(…)"`, `NAME="$(…)"`, backquotes, two nested shells and an inline-interpreter literal drop; `bash -c 'cargo test'` and `"$(git rev-parse HEAD)"` kept; four levels read, a fifth metadata-only), `inline_interpreter_code_is_metadata_only_under_an_active_policy` (inline code metadata-only, kept with no policy; modules, script files and `grep -e` unaffected), `git_object_names_are_path_candidates` (`HEAD:`, `:`, `:N:` and `@{n}` names drop, also from a subdirectory; drive letters, URLs, `NAME=a:b` and flags are not object names; a public object name kept), `ansi_c_strings_and_escaped_letters_are_read_like_the_shell`, `antigravity_run_command_resolves_arguments_from_its_cwd` (absolute and relative `Cwd` drop, a public `Cwd` kept, another agent's `Cwd` key ignored), `windows_escape_characters_are_read_on_a_windows_host` (caret and backquote spellings drop on a Windows host, public controls kept, a POSIX host reads both literally), `a_case_folding_host_matches_paths_without_regard_to_case` (file tool and shell drop with folding, keep without, public control kept; folding injected through `resolve_for_host` so it runs on every CI OS), the shell fixture's continuation, PowerShell/cmd escape, option-value, runner, interpreter, glued-flag, `file:` URL, tilde, parameter-default and `fold_case` vectors with their controls, the near-miss controls added to `common_commands_stay_kept_under_an_active_policy` (also quoted tildes, a `file:` URL with a query, a shallow nested default and a scratchpad log), the shell fixture's `file:` query/fragment, deep-default, escaped-default, quoted/argv/script tilde, PowerShell tilde, harness-output and Unicode `fold_case` vectors and the `decisions` harness-output vectors with their controls, `reading_a_harness_output_spool_is_metadata_only_under_a_policy` (active and invalid strip, inactive keeps, same-named files elsewhere kept, an ignored path still drops), `capture_lookup_locations_name_every_path_a_call_spells`, the Unicode rows of `a_case_folding_host_matches_paths_without_regard_to_case`, **`hook.rs` `another_checkouts_exclusions_hold_for_a_call_made_elsewhere`** (relative, absolute, glob and unmarked-Hermes shell calls naming another checkout's excluded file never spool; a broken foreign marker and too many foreign markers spool metadata-only; public, own-file and few-marker controls spool with content), **`hook.rs` `globs_searches_and_unreadable_targets_answer_to_another_checkout`** (sibling and parent-folder `*`, brace, bracket, `**` and separator-spanning-brace shell globs, a Grep path, a Glob pattern, a parent-folder Grep filter, a Gemini `search_file_content` directory, a Codex `apply_patch` header and a target-less Read never spool content; public-glob, own-glob, own-`**`, own-search, own-Glob-`**`, public-search and own-patch controls spool with content), `transcript_capture.rs` `globs_and_searches_reaching_another_checkout_honor_its_policy`, `capture_policy.rs` `glob_walk_follows_every_segment_a_glob_could_pass_through`, `an_invalid_policy_makes_a_search_metadata_only`, `a_brace_that_builds_a_parent_step_cannot_be_walked`, `a_parent_step_after_a_globstar_is_read_both_ways`, `glob_groups_and_ansi_c_escapes_reach_the_marker_lookup`, `a_saved_output_glob_needs_its_distinctive_name_in_literal_text`, `indented_patch_headers_and_hermes_file_globs_reach_the_marker_lookup`, `a_dot_glob_directory_that_can_match_the_parent_is_read_as_it` (POSIX classes and extglob groups included), `an_oversized_brace_expansion_is_walked_unless_its_pieces_could_leave` (each attack with its control), the shell fixture's double-quoted `bash -c`/`eval` ANSI-C vectors and their controls, `marker.rs` `marker_memo_answers_like_find_marker_once_per_directory`, **`hook.rs` `a_globstar_above_the_checkout_skips_the_own_subtree`** (regression: `ls ../**/README.md` from a 300-directory checkout with no policy is not metadata-only; the sibling `cat ../**/secrets.env` drops), **`hook.rs` `marker_lookups_in_a_deep_tree_cost_one_probe_per_directory`** (regression: 300 paths in a 300-level tree cost fewer than five probes per level; out of budget inside the checkout kept, outside it metadata-only, the sibling checkout's location looked up before a long list inside the checkout, and a shallow nested marker before a deep list), **`hook.rs` `a_dotfiles_checkout_at_home_is_not_the_own_checkout`** (with `~/.git`, `cat */secrets.env` from `~/Projects` drops; a harmless glob kept), the shell fixture's dot-glob directory vectors and their controls, the shell fixture's `**`-then-`..` and `*.log` vectors and the `read_many_files_directories` `**`-then-`..` vectors, **`hook.rs` `constructed_parent_steps_answer_to_another_checkout`** (a `..` after a `**` through a shell, a Glob pattern and a Grep filter, four brace expansions that build a parent step, two zsh glob groups, hex and octal ANSI-C escapes, two dot-glob directory segments, a POSIX-class and four extglob dot-glob segments, a brace-built dot-glob, an oversized brace sequence over `.`, ANSI-C strings in a double-quoted `bash -c` and `eval`, an indented `apply_patch` header next to an unindented one and a Hermes `file_glob` never spool content; the same shapes inside the checkout spool with it, and so do four brace expansions too large to list that cannot leave it, which v2.6.3 kept), **`hook.rs` `a_monorepo_glob_inside_the_own_checkout_is_not_walked`** (in a 300-package checkout, with and without a policy of its own, `packages/*` shell globs stay kept and the sibling `../*/secrets.env` and `../a/*.env` attacks still drop), `hook.rs` `a_glob_walk_outside_the_checkout_stops_at_its_bounds` (directory bound counted while a `**` lists, time budget through an injected clock, no walk inside the checkout), the Node evidence test's `monorepo-*`, `walk-*`, `con-*`, `globstar-*`, `deep-*` and `dotfiles-*` checks, and the Node evidence test's `glob-*`, `search-*`, `patch-*` and `unreadable-target` checks with their controls and `transcript_capture.rs` `a_shell_command_naming_another_checkouts_file_honors_its_policy`, both failing with the foreign lookup disabled, and the Node evidence test's `cross-*` and `fold-unicode` checks, which fail with `captureForeignConfigs` disabled, and the shell fixture's quoted-script, git-object, ANSI-C, escaped-letter and inline-interpreter vectors with their controls (`cargo test`, `git status`/`log`, `pytest`, `python3 -m pytest`, `node build.js`, `npm run test`, a quoted commit message with braces); `router.rs` `capture_protocol_active_keep_of_unprovable_output_is_stripped`; `hook.rs` `excluded_content_cannot_reach_the_spool_through_unevaluated_tool_shapes` (directory entries and Copilot `view`/`create` never spool, readers and brace shells spool without content, public controls spool with it); `render_shared.rs` `generated_capture_policy_v1_node_runtime_evidence` (runs the same fixture sections, including the GHSA-vh98 and Gemini `read_many_files`/`run_shell_command` vectors, plus unsupported-glob, empty-list and recursive-`**` checks, against the emitted TypeScript; `#[ignore]` locally, run with `--ignored` under Node 24 by the Linux CI test job); `hook.rs` `check_capture_refuses_partial_scope_and_excluded_content` (ignored-path and partial-scope violations refused, complete public-path control passes), `check_capture_bounds_marker_hints_and_refuses_oversized_scope` (513-byte hints refused, 512-byte control passes; native routing preserved); **`backfill.rs` `backfill_never_posts_tool_content_the_capture_policy_excludes`** (planted Claude transcript: the excluded read's call and output never reach `/hook/batch`, a malformed read posts only the metadata-only body, public read control posted) and **`run.rs` `ledger_upload_drops_tool_content_the_capture_policy_excludes`** (excluded call and output absent from the finish request, public control present, cursor still advances), both failing with the guard removed; `transcript_capture.rs` `an_excluded_read_drops_its_call_and_result_by_id`, `id_less_results_take_the_strictest_call_of_their_turn`, `unrecoverable_arguments_and_orphan_results_fail_closed_under_a_policy`, `a_call_into_another_checkout_honors_its_policy`, `ledger_events_are_dropped_or_stripped_before_upload`, `without_a_policy_every_event_is_kept` (control); `capture_policy.rs` `tool_call_payload_reaches_the_live_decision_for_every_supported_agent`; **`backfill.rs` `allowlist_mode_backfills_nothing_from_an_unmarked_checkout`** (no request reaches the server; marked-checkout and denylist controls do), **`run.rs` `ledger_upload_under_allowlist_mode_carries_nothing_from_an_unmarked_checkout`** (finish carries no prompt or tool content; marked and denylist controls upload both), `transcript_capture.rs` `allowlist_mode_admits_nothing_from_an_unmarked_checkout`, all failing with the admission gate removed; **`backfill.rs` `backfill_inspects_codex_exec_command_as_the_hook_shell_call`** and **`run.rs` `ledger_upload_inspects_codex_exec_command_as_the_hook_shell_call`** (a planted Codex `exec_command` whose `workdir`-relative argument names an ignored file never posts its call or output; the same command from a public `workdir` does), `capture_policy.rs` `codex_transcript_exec_command_is_inspected_as_the_hook_bash_call` (absolute, relative and absent `workdir` and an argv `cmd` drop, public control kept, the `workdir` locates the call, another agent's `exec_command` stays unknown), all failing with `hook_tool_call` removed; **`backfill.rs` `backfill_resolves_each_call_from_its_record_cwd`** (`cat adr/x.md` recorded from `docs/` never posts; the same command from the root does) and `transcript.rs` `jsonl_events_carry_their_record_cwd` (Claude per line, Codex per turn context, a relative cwd ignored), failing with the record cwd ignored or unstamped; **`backfill.rs` `backfill_drops_reroutes_the_live_hook_would_not_deliver_here`** (under allowlist mode, reads rerouted to an unmarked git repository, to a marker selecting an unregistered profile, and to a marker selecting a registered profile while the source uses the install default are never posted; a read in a marked checkout with no server selection is the posted control), failing with either the admission check or the route comparison removed (each refused case checked on its own); `transcript_capture.rs` `a_record_cwd_answers_to_the_hook_admission_gate_there` (prompt, call and result recorded in an unmarked repository drop under allowlist; a subdirectory of the opted-in checkout is kept and its record cwd never reaches the ledger) and `claude_shell_mode_output_is_not_imported` (stdout, stderr, local-command and size-capped blocks drop; `<bash-input>`, a prompt quoting a tag, and another agent's message kept); **`backfill.rs` `backfill_posts_no_content_for_unrecognized_tools`** (a planted Codex MCP call's arguments and output never post, the call and output post as `tool unknown`; a recognized shell output is the posted control) and `transcript_capture.rs` `unrecognized_tools_keep_no_content_with_or_without_a_policy` (no policy and an active one; ledger content withheld; public read kept; a call-less result content-free), failing with the unknown-family rule removed, the backfill one also with its content-free body removed; **`backfill.rs` `backfill_keeps_reroutes_to_the_same_server_profile_only`** (a reroute into a checkout selecting the source's registered profile and project is posted; one selecting a different registered profile is not, nor one of another project on the same profile, nor a prompt recorded there), failing with the profile comparison forced either way and with the project comparison removed; `transcript_capture.rs` `a_record_cwd_in_another_project_is_dropped` and `a_reroute_into_another_project_is_dropped` (prompt, call and result recorded in, or a read reaching into, a checkout declaring another project drop; one declaring the same project is kept), failing with `routes_to_same_project` removed; `hook.rs` `subdirectories_of_one_repository_are_one_project_only_under_repo_root` (two subdirectories of an unmarked repository, and a subdirectory importing its root, are two projects; the same directory, the root importing a subdirectory and a `repo-root` marker agree), failing with the basename rule removed; **`backfill.rs` `backfill_posts_no_task_notification_or_compact_summary_as_a_prompt`** and `transcript.rs` `claude_adapter_keeps_task_notifications_and_compact_summaries_out_of_prompts` (a monitored command's notification, a background agent's report and an origin-tagged notice are excluded, also behind a byte-order mark and zero-width characters, in another case, with attributes, after a non-text block, or with an origin kind in another case; a compact summary, also flagged `"true"` or `1`, becomes a compaction event; the typed prompt, also one quoting the tag, and a look-alike tag are the controls), failing with either adapter rule removed or with the spelling rules reverted; `transcript_capture.rs` `boundary_events_answer_to_the_record_cwd_admission_gate` (compaction and annotation recorded in a refused directory drop; in the checkout kept), `a_result_whose_id_matches_no_call_is_an_orphan` (an unmatched id cannot borrow a public read's keep; the read's own result kept), `claude_shell_mode_output_is_not_imported` (a block holding a literal closing tag drops) and `unrecognized_tools_keep_no_content_with_or_without_a_policy` (ledger keeps no tool name and no invalid call id), each failing with its rule reverted; `windows_spelling_fixture_vectors` (shared `capture-policy.json` `windows` drop vectors for every spelling above, file tool and shell, with other-drive, other-share, longer-name and pipe controls, and `windows_posix_controls` proving a POSIX session keeps `/c/…`, trailing-dot and colon names), `tool_family_fixture_vectors` (shared `tool_families`, every native name per family), new `decisions` vectors (`execute_code` metadata-only, `read_file`/`patch`/`fs_read` operations drop, `write_to_file`/`browser_navigate` keep), `output_spool_work_is_linear_and_budgeted` (a 2,040-wildcard-segment path stays under a linear work bound; 32 such paths fail closed; one long or 32 short paths keep), `an_oversized_shell_command_is_unprovable` (one character over the limit is metadata-only and unlooked-up, at the limit keeps, argv summed, inactive untouched), `inline_code_tools_are_unprovable_under_a_policy`, `hook_capture::capture_section_spellings_match_toml_semantics` (shared `marker_spellings`), and the Node evidence test running all of these vectors against the generated TypeScript plus its entry-bound read count for the directory walk; each fails with its rule reverted (Windows reading off, spool memo dropped or budget failing open, length check off, inline-code rule off, a name dropped from the list, TS dotted key or inline-table rule reverted, TS walk back on `readdirSync`) | STRONG with listed residuals. Matching is lexical by design, so these stay open: shell variables (`$VAR`, `FILE=… sh -c 'cat $FILE'`) and the output of a command substitution, a `cd` inside the command, a script read from a file or a heredoc fed to an interpreter (read only for the words it spells out), git's repository root approximated by the marker directory, symlinks (paths are never resolved on disk), a recursive search of a parent directory (`grep -r x docs`, `rg x`) through a shell, a search tool rooted at a literal directory above another checkout (it is not walked) and a glob whose literal root lies inside the event's own checkout reaching a checkout nested there (it is not walked), a marker nested inside the own checkout below what the lookup budget reaches, a `.git` the same command creates (`touch .git; cat */x`: the hook reads the tree after the command ran, so that directory counts as the own checkout; a `.git` at or above the home directory never does), a parameter expansion next to glob syntax (`${X}/*/x`, not walked), a glob through a symlinked directory, a tool's own directory option (`git -C`), script runners and interpreters the matcher does not list (their words are still read, but expansion or inline code in them is not recognized), a value glued after the first letter of a short-flag cluster, non-ASCII percent-escapes in a `file:` URL, a bare word naming another checkout's directory (only separator-bearing arguments are looked up for another marker), harness output files outside the listed default locations, and tools the matcher does not list, which keep their current unknown-tool behavior. Transcript imports add: assistant prose quoting an excluded file is kept (as live prompt/assistant capture keeps it), harnesses whose hook schema the matcher does not read (Crush, Kimi Code) keep their tool events as live capture would, adapters that record no per-record cwd (Pi, OMP, OpenCode, Crush, Kimi Code, Command Code, Kiro, Grok) judge every event from the session cwd, a Codex ledger upload resumed from a mid-file cursor judges the events before the next turn context from the session cwd, and id-less adapters over-drop a whole turn's results when one call is excluded, and when the routing hints leave the project to the server, events from inside one repository count as the importing project even where the server has a separate project registered for a subdirectory (anywhere under `repo-root`; under `basename` only when the import runs from the repository root); a metadata-only import keeps an `event_id` (ledger) and `ingest_key` (backfill) derived from a SHA-256 of the original content plus session and record ids, left in place because those ids are the retry-dedupe keys and a content-free id would merge distinct events — it only confirms a guess of low-entropy content. Under allowlist mode a refused checkout's `ai-memory run` still records repository checkpoint metadata (HEAD, branch, a status hash and changed-path names, never file content), which the run also sends at launch. Re-splitting quoted words over-drops a quoted message naming an ignored path, and inline interpreter code is metadata-only under an active policy. Mitigation: allowlist capture mode (`install-hooks --capture-mode allowlist`) for sensitive projects. Bite checks: removing the nested re-split, the git object path or its marker-root base, Antigravity's `Cwd` key, the leading-`]` rule, either zsh-group rule, ANSI-C decoding or its numeric-escape rule, the `\o` reading, the inline-code rule, the nesting-depth rule, the nested-script scan, the line-continuation join, the Windows escape reading, the shell-option and interpreter-option value skips, the added runners and interpreters, the glued-flag value, the `file:` URL path, the `~+` resolution, the unknown-tilde rule, the parameter-default reading or case folding each fails the Rust tests, and each TypeScript counterpart fails the Node evidence test; so does reverting the `file:` URL cut, the deep-default rule, the escaped-default reading, the quoted-tilde rule, the harness-output rule or Unicode folding (the new fixture vectors fail against the previous matchers in both languages), and disabling the foreign-marker lookup fails the native, import and Node cross-checkout tests; reading every glob location as literal, skipping search/list locations, or skipping a file tool whose targets cannot be read each fails the native, import and Node glob/search/unreadable tests, removing `apply_patch` header reading fails the own-patch control, and reverting the saved-output glob rule fails the new fixture vectors in both languages; walking globs rooted inside the event's checkout fails the monorepo tests, accepting any literal text for a saved-output glob fails the `*.log` vectors, removing the time budget or counting a `**`'s directories only after it lists fails the bounds tests, and removing the `**`-then-`..` readings, the brace-expansion check, the expanded lookup words, the patch-header trim, the `file_glob` key or the dot-glob parent reading each fails the Rust tests and the Node evidence test; treating every oversized brace expansion as leaving, dropping the brace-built dot-glob check, listing the own checkout's subtree under a `**`, looking up locations in their given order (outside before inside, then shallowest first), dropping the per-directory memo, counting a checkout at home as the own one, keeping the backslash before `$` in double quotes, or dropping the POSIX-class or extglob reading each fails its Rust test and the Node evidence test; in a Windows session `/c/x` is read only as Git Bash reads it, so a native tool's `C:\c\x` reading is not matched, and the TS marker reader does not validate TOML outside the capture table (a syntax error elsewhere invalidates the policy only natively); a `**/` matches one or more directories, never zero (documented in `marker-file.md`) |+| 11b | Capture exclusions drop before storage | `ai-memory-hooks` `capture_policy.rs` `inspect`→`Drop` (before semaphore/spawn), including shell commands whose arguments name an ignored path (`match_command`; argv elements matched whole and tokenized, and every word that holds several words, such as a quoted `sh -c` script or a `"$(…)"` substitution, re-split to four levels by `ShellCommand::split`/`push_nested_words`, a deeper script metadata-only; ANSI-C strings decoded and a backslash before an ordinary letter dropped (`shell_words`, `push_word`); backslash-newline continuations joined (`shell_words`); a parameter default's operand, a value glued to a short flag and a `file:` URL's path read as candidates (`parameter_operands`, `shell_arguments`, `file_url_path`); PowerShell and cmd escape characters read out under the `PowerShell` tool or on a Windows host (`without_windows_escapes`); `~+` resolved to the cwd and a `~-`/`~N`/`~name` prefix metadata-only (`names_unknown_directory`); shell and interpreter options that take a value skipped while looking for a `-c` script or inline code (`takes_shell_value`, `runs_inline_code`, which also lists `lua`/`Rscript`/`osascript -e`, and `su -c`/`script -c` as script runners); paths compared without regard to case on a macOS host (`fold_case`, set by `resolve`; patterns and candidates composed to NFC and lowercased in full by `fold_path`, TS `captureFold`; client-only, the server's sentinel re-inspection never depends on it); a `file:` URL cut at its query or fragment before decoding (`file_url_path`); a parameter default nested past four levels metadata-only and a default read again after backslash removal (`parameter_operands`, `push_word_reading`); a tilde expanded or treated as an unknown directory only when the shell expands it, unquoted and in a script rather than a quoted message or argv element, every tilde under PowerShell (`marked_shell_words`, `literal_tildes`, `expand_tilde`); a file or shell read of a harness's saved tool output, or a glob that could match one, metadata-only under an active policy (`output_spool`: Claude Code `tool-results/` and `tasks/*.output`, OpenCode `tool-output/`, Pi `pi-bash-*.log`; glob segments fit a name they share a match with, `globs_intersect`, TS `captureGlobsIntersect`, and one fitting segment must spell three characters in a row of that name's distinctive text literally, `spells`, TS `captureSpells`, so `*.log` is not read as `pi-bash-*.log`, a trade-off that leaves a glob with no such literal run, `/tmp/p?-b*`, outside the rule; the TS matcher applies it to `read_many_files` entries too); every other marker governing a file-tool target (an `apply_patch`'s header paths, read after leading whitespace, `patch_paths`), a search/list tool's directory, file or path-like glob argument (`search_scope`, Hermes `file_glob` included; a grep `pattern` is not read) or a separator-bearing shell argument also inspects the call, found by the lexical marker walk from each location's nearest existing directory, each directory's answer remembered for every lookup that passes it (`marker.rs` `MarkerMemo`, TS `captureMemoMarker`, seeded with the event's own walk, `remember`, TS `captureMemoRemember`), bounded (4,096 locations, 16 markers, and 16,384 probes sharing the glob walk's 50 ms, `MAX_LOOKUP_PROBES`, TS `CAPTURE_MAX_LOOKUP_PROBES`; locations outside the own checkout are looked up first, a glob's literal root before the walk below it (whose single listing can spend the time budget on a large directory), and past a bound fail closed as under an invalid policy, while running out inside the own checkout, whose locations are looked up shallowest first, ends the lookup, its own policy governing there) and combined strictest-first (`capture_lookup_locations`, `CaptureDecision::stricter`, `hook.rs` `foreign_capture_decision`, also applied by `transcript_capture.rs` `decide_call`; TS `captureForeignConfigs`, `captureDecide`, `captureSearchScope`, `capturePatchPaths`); a location with glob syntax is looked up from its literal root and, when that root lies outside the event's `.git` checkout, every directory the glob could pass through is checked for a marker (`glob_walk`, `hook.rs` `GlobBudget::markers_below`; TS `captureGlobWalk`, `captureMarkersBelow`, `captureOwnCheckout`: a `*`/`?` segment lists the child directories it matches, a class/brace/group every child, a `**` the subtree except the event's checkout's; a glob rooted inside the event's checkout is not walked; a checkout root at or above the home directory, or the filesystem root, is never the own checkout for these rules (`own_checkout`), so a dotfiles `~/.git` does not stop the walk from `~/Projects`; symlinks never followed; 256 directories, counted as a `**` lists, 32,768 entries and 50 ms, `MAX_GLOB_TIME`, TS `CAPTURE_MAX_GLOB_MS`, injectable clock, past which, or for a brace/group spanning a separator, a `..`/`~` alternative or one a bounded brace expansion builds, `brace_alternatives`, TS `captureBraceAlternatives`, a directory alternative bash before 5.2 expands to `..` (`.{*,x}/`), or an expansion too large to list whose pieces could build one of these (`brace_overflow_could_leave`, TS `captureBraceOverflowLeaves`: integer and letter sequences cannot, so `file{1..200}.txt` is walked like any glob), the call fails closed); a `..` after a `**` is read both as the `**` matching no directory and as matching some, by the event's own matcher and the lookup (`normalize_readings`, TS `captureReadings`, at most 16 readings, past which the call fails closed), and so is a directory segment that bash before 5.2 can expand to `..` (`could_name_parent`, `class_glob_matches` with POSIX classes such as `[[:punct:]]` and extglob groups such as `@(.)`, `?(.)`, `*(.)`, `+(.)`, `!(x)`; TS `captureCouldNameParent`, `captureClassGlob`, `captureNamedClass`), read as `..` too; inside double quotes a backslash before `$` or a backquote is dropped, so a quoted script (`bash -c "…"`, `eval "…"`) re-split for its words reads an ANSI-C string as the shell it runs does (`shell_tokens`, TS `captureMarkedWords`); a zsh glob group kept in its word and ANSI-C numeric escapes decoded are fed to the lookup (`shell_tokens` with `expand`, `ShellWords::expanded`, `glob_group`, `ansi_c_numeric_escape`; TS `captureMarkedWords(…, true)`, `captureGlobGroup`, `captureAnsiNumeric`); a file tool whose targets cannot be read or resolved, and a search/list argument that is not a string, fail closed; the path of a git `REV:path` object name tried from the cwd and the marker directory (`git_object_path`); Antigravity `run_command` resolved from its `Cwd`); an invalid marker makes file, search/list and shell calls metadata-only; an active one makes a shell call metadata-only when a word uses unquoted brace expansion, a bracket class (a leading `]` included), a zsh glob group or extglob, or a numeric/control ANSI-C escape (`has_unevaluated_expansion`, also run on scripts given to `sh -c`, `eval` or a substitution), or when it runs inline interpreter code (`runs_inline_code`: `python -c`, `node -e`, `ruby -e`, `perl -e`, `php -r`, `deno eval`), and either makes tools that read back an earlier command's output metadata-only (`reads_earlier_output`: `BashOutput`, `TaskOutput`, `write_stdin`, `process`, `read_bash`/`write_bash` and PowerShell twins); the server admits a metadata-only shell or unknown-family body only under an active or invalid marker, with no paths and an `extracted` state (`router.rs` `metadata_protocol_is_legal`), and its own re-inspection strips an older client's keep for either; a Gemini `read_many_files` literal entry is also read as `entry/**` (`glob_matches_below`), and Copilot CLI's runtime `view`/`create`/`str_replace_editor` are file tools for that agent only (`agent_family`); generated OpenCode/OMP/Pi/OpenClaw integrations mirror it in `render_shared.rs` `ts_capture_policy_v1` (`captureMatchCommand`, `captureShellSplit`, `captureUnevaluatedExpansion`, `captureInlineCode`, `captureGitObjectPath`, `captureGlobBelow`, the `reader` flag). Candidate/argument flavor (`Flavor::Posix` vs `Flavor::Windows`, used to pick which `ignore_paths` patterns even apply) is derived from the **host** (the cwd), never from the candidate string alone — a POSIX-host candidate spelled with a leading `//` is collapsed to a single `/` before flavor detection (`normalize_candidate`; TS `captureNormalize`'s `windowsHost` parameter, sourced from `captureHostWindows(cwd)`), fixing GHSA-vh98 (a `//`-prefixed candidate used to self-classify as `Flavor::Windows` regardless of host, matching zero POSIX patterns and being captured instead of dropped); a genuine Windows/UNC host (cwd itself windows-flavored) is unaffected; `hook.rs` `--check-capture` preflight uses the same capture policy before any spool or spawn; transcript imports (`ai-memory backfill`, including the automatic first-boot run, and the `ai-memory run` ledger upload) apply the same decision table through `commands/transcript_capture.rs`: each recorded tool call is rebuilt in its agent's hook shape (`capture_policy.rs` `tool_call_payload`) and inspected by the checkout's policy, and by a reroute destination's policy too; a Drop removes the call and its result (paired by native id, else the strictest call of the turn when the result has no id; a result whose id matches no call, or with no call, follows the orphan rule: dropped under a policy, content-free without one), metadata-only posts the hook's metadata-only body with its protocol (backfill) or a withheld placeholder keeping only the family and a call id that passes the server's `valid_call_id` (ledger), and a shell call whose recorded arguments cannot be parsed drops; both imports also apply the hook's repository admission gate (`hook.rs` `checkout_admits_capture`: persisted capture mode, marker opt-in, readable routing marker — the same helpers the hook's own gate uses), so under allowlist mode an unmarked checkout imports nothing, prompts included: `backfill` stops before contacting the server and the run ledger finishes with no events; a tool the transcript names differently from the hook is rebuilt under the hook's name and fields (`capture_policy.rs` `hook_tool_call`: Codex `exec_command` `{cmd, workdir}` → `Bash` `{command, workdir}`); the Claude Code and Codex JSONL adapters label each event with its record's cwd (`transcript.rs` `stamp_record_cwd`, `RECORD_CWD_KEY`), from which the import resolves arguments, policy and reroutes, falling back to the session cwd, and which is removed before a ledger upload; a rerouted call, and an event whose record cwd lies outside the checkout, must pass that directory's admission gate, resolve to the same server-profile route as the checkout and to the same project scope (`transcript_capture.rs` `admits_elsewhere` → `hook.rs` `checkout_admits_capture` + `delivers_to_same_server`, which compares two `resolve_hook_route` results and never matches a refused selection, + `routes_to_same_project`, which compares the two `hook_scope` hint sets and, when they leave the project to the server, under `repo-root` the repository/marker anchor or the directory itself, under the default `basename` the directory itself or a destination inside the repository whose root is the source), else it drops with its result, since the import files every event under the importing project; compaction, checkpoint and annotation events answer to the same record-cwd checks; Claude Code `!` shell-mode output (a user message opening with a `<bash-stdout>`/`<bash-stderr>`/`<local-command-stdout>` block, whatever it holds) is dropped (`shell_mode_output`); the Claude Code adapter excludes harness-written background-task turns (`transcript.rs` `claude_task_notification`: `origin.kind` `task-notification` in any case, or a first text block opening with a `<task-notification` tag in any case, attributes allowed, after a byte-order mark, zero-width characters or whitespace) and records a compaction summary (`isCompactSummary` true, `"true"` or `1`, `truthy`) as a compaction event, which backfill does not post; a tool the matcher does not recognize (unknown family: MCP tools, Codex `view_image`, …) keeps only its family whatever the policy, as the live server stores for it (`EventCapture::Unrecognized`: backfill posts title `tool unknown` and body `tool_family: unknown`, the ledger a withheld placeholder), and so does a result with no call to inherit from ; in a Windows session every candidate, shell argument and `workdir` is read as the file Windows opens before matching (`windows_spelling`, `windows_segment`, `command_base`; TS `captureWindowsSpelling`/`captureResolve`/`captureBase`): Git Bash/MSYS2/Cygwin `/c/…` and `/cygdrive/c/…`, a drive-less rooted path on the cwd's drive, the `\\?\`/`\\.\`/`\??\` and `UNC` prefixes, the local administrative share (`\\localhost\C$`), and per-segment alternate-data-stream suffixes and trailing dots/spaces, any other device path unusable (metadata-only for a file tool); `/c/…` and `/cygdrive/c/…` are also read from the root of the cwd's drive, as a native tool reads them, and either reading matching drops (`windows_spellings`, `normalize_candidates`, `normalize_readings`; TS `captureWindowsSpellings`/`captureAllReadings`); the cwd, the marker directory, home and an absolute pattern get the same reading so every side shares one spelling (`normalize_root`, `compile`; TS `captureRoot`, the marker directory cut lexically); a Windows session also reads each shell command and argv element with every backslash literal, as PowerShell and cmd do, so a bare or double-quoted `\\server\share\…` or `\\?\C:\…` argument keeps its prefix (`literal_shell_words`, threaded through `push_nested_words`/`push_argv_item`; TS `captureMarkedWords(…, literal)`); the harness-spool check is linear in the path and charged to the match budget, past it fail-closed (`output_spool`, TS `captureOutputSpool`); a shell command over `MAX_SHELL_COMMAND_CHARS` (1 MiB) is metadata-only and its marker lookup unprovable (`ShellCommand::oversized`, TS `captureCommandOversized`); Hermes `execute_code` is metadata-only under an active policy (`INLINE_CODE_TOOL_NAMES`); the TS file/search/non-file/inline-code/output-reader tool lists and the command limit are generated from the native constants (`FILE_TOOL_NAMES` and siblings, spliced by `ts_capture_policy_v1`), and the TS marker reader honours every TOML spelling of the capture table toml_edit does (dotted `capture.ignore_paths`, quoted or spaced `[capture]` headers) and fails closed on the shapes it rejects (inline table, `[[capture]]`, `[capture.x]`, a second definition) (`captureTomlKey` and the `captureConfigAt` section loop), tracks every multi-line array so a line inside one (`["docs"]`) is never a header, and fails closed on a line that is neither header nor key/value, a key line swallowed by an open array, text after a continued array closes, or an inline table left open at a line end (`captureValueScan`); the TS glob walk reads a directory one entry at a time with `opendirSync`, stopping at the entry bound (GHSA-gcpc-88hm-3xqr) | `capture_policy.rs` per-agent `…honors_exclusions` tests, `shell_fixture_vectors` (shared `capture-policy.json` `shell` drop/keep vectors: tool aliases incl. OpenClaw/Devin `exec` and `PowerShell`, `workdir`, glob directories, Windows paths, and a POSIX-host leading-`//` command via `/{root}/docs/adr/x.md`), `shell_tool_shapes_of_every_adapter_honor_exclusions`, `claude_code_powershell_honors_ignored_paths_on_a_windows_host` (#1186: Windows-spelled and `-Param:value` paths drop, public-path and `git status` controls kept, invalid marker metadata-only), `gemini_cli_shell_and_read_many_files_honor_ignored_paths` (Gemini `run_shell_command` incl. `dir_path`/`directory`, and `read_many_files` globs via `match_globs`: excluded literal, mixed public+excluded, `docs/*`, recursive `**` and case-variant entries drop, an `exclude` list cannot rescue them, unsupported glob syntax and malformed lists are metadata-only, public entries kept, POSIX and Windows hosts) and `globstar_reaches_lets_double_star_span_any_depth`, `fixture_vectors` (incl. TS-adapter `bash`/`exec` vectors, and `normalization`'s leading-`//` POSIX vectors alongside the kept Windows-cwd UNC vectors as the no-regression control); `shell_matching_is_off_when_inactive_and_fails_closed_when_invalid_or_over_budget`; `router.rs` `capture_protocol_shell_decisions_survive_server_reinspection`, `capture_protocol_invalid_marker_shell_is_metadata_only` (active metadata-only shell admitted for an unevaluated expansion, inactive refused, older client's invalid-marker keep stripped, commandless control kept), `capture_protocol_unparseable_marker_strips_shell_events` (server fallback for an unparseable marker), `capture_protocol_invalid_shell_metadata_claim_must_be_canonical` (a stripped shell claim with a path count or non-`extracted` state is refused); `capture_policy.rs` `invalid_marker_strips_shell_calls_with_unparseable_commands`, `long_bash_lc_script_in_argv_is_not_dropped_by_the_match_budget`, **`a_leading_double_slash_candidate_does_not_escape_posix_ignore_paths_via_flavor_mismatch`** (GHSA-vh98 adversarial: attempts the `//repo/secret/...` violation on a POSIX host, proves it now drops, with a plain-single-slash control and a Windows-hosted genuine-UNC control both still correct — fails on the pre-fix code); `hook.rs` `shell_command_reading_an_ignored_path_is_dropped_before_spool`, `gemini_cli_shell_and_read_many_files_exclusions_drop_before_spool` (pre- and post-tool events with an excluded path are never spooled; public controls spool with their family); `capture_policy.rs` `read_many_files_directory_entries_cannot_reach_ignored_paths` (shared `read_many_files_directories` vectors: `docs`, `.`, `./`, `docs/`, case and `..` variants drop; `src`, `README.md`, `docs/adrx` kept), `output_reader_tools_are_metadata_only_only_under_a_policy` (active and invalid strip, inactive and an unrelated unknown tool keep), `copilot_cli_runtime_file_tools_are_scoped_to_copilot`, `unevaluated_shell_expansions_respect_quoting` (also leading-`]` classes, zsh groups and extglobs, ANSI-C numeric escapes; subshells, `$((…))`, `<(…)`, array assignments kept), the shell fixture's brace/class vectors (quoted, escaped, `${…}`, `{}`, `[ … ]`, `HEAD@{1}` controls kept); `quoted_scripts_in_string_commands_are_read_like_command_lines` (`sh -c`, `timeout … bash -c`, `"$(…)"`, `NAME="$(…)"`, backquotes, two nested shells and an inline-interpreter literal drop; `bash -c 'cargo test'` and `"$(git rev-parse HEAD)"` kept; four levels read, a fifth metadata-only), `inline_interpreter_code_is_metadata_only_under_an_active_policy` (inline code metadata-only, kept with no policy; modules, script files and `grep -e` unaffected), `git_object_names_are_path_candidates` (`HEAD:`, `:`, `:N:` and `@{n}` names drop, also from a subdirectory; drive letters, URLs, `NAME=a:b` and flags are not object names; a public object name kept), `ansi_c_strings_and_escaped_letters_are_read_like_the_shell`, `antigravity_run_command_resolves_arguments_from_its_cwd` (absolute and relative `Cwd` drop, a public `Cwd` kept, another agent's `Cwd` key ignored), `windows_escape_characters_are_read_on_a_windows_host` (caret and backquote spellings drop on a Windows host, public controls kept, a POSIX host reads both literally), `a_case_folding_host_matches_paths_without_regard_to_case` (file tool and shell drop with folding, keep without, public control kept; folding injected through `resolve_for_host` so it runs on every CI OS), the shell fixture's continuation, PowerShell/cmd escape, option-value, runner, interpreter, glued-flag, `file:` URL, tilde, parameter-default and `fold_case` vectors with their controls, the near-miss controls added to `common_commands_stay_kept_under_an_active_policy` (also quoted tildes, a `file:` URL with a query, a shallow nested default and a scratchpad log), the shell fixture's `file:` query/fragment, deep-default, escaped-default, quoted/argv/script tilde, PowerShell tilde, harness-output and Unicode `fold_case` vectors and the `decisions` harness-output vectors with their controls, `reading_a_harness_output_spool_is_metadata_only_under_a_policy` (active and invalid strip, inactive keeps, same-named files elsewhere kept, an ignored path still drops), `capture_lookup_locations_name_every_path_a_call_spells`, the Unicode rows of `a_case_folding_host_matches_paths_without_regard_to_case`, **`hook.rs` `another_checkouts_exclusions_hold_for_a_call_made_elsewhere`** (relative, absolute, glob and unmarked-Hermes shell calls naming another checkout's excluded file never spool; a broken foreign marker and too many foreign markers spool metadata-only; public, own-file and few-marker controls spool with content), **`hook.rs` `globs_searches_and_unreadable_targets_answer_to_another_checkout`** (sibling and parent-folder `*`, brace, bracket, `**` and separator-spanning-brace shell globs, a Grep path, a Glob pattern, a parent-folder Grep filter, a Gemini `search_file_content` directory, a Codex `apply_patch` header and a target-less Read never spool content; public-glob, own-glob, own-`**`, own-search, own-Glob-`**`, public-search and own-patch controls spool with content), `transcript_capture.rs` `globs_and_searches_reaching_another_checkout_honor_its_policy`, `capture_policy.rs` `glob_walk_follows_every_segment_a_glob_could_pass_through`, `an_invalid_policy_makes_a_search_metadata_only`, `a_brace_that_builds_a_parent_step_cannot_be_walked`, `a_parent_step_after_a_globstar_is_read_both_ways`, `glob_groups_and_ansi_c_escapes_reach_the_marker_lookup`, `a_saved_output_glob_needs_its_distinctive_name_in_literal_text`, `indented_patch_headers_and_hermes_file_globs_reach_the_marker_lookup`, `a_dot_glob_directory_that_can_match_the_parent_is_read_as_it` (POSIX classes and extglob groups included), `an_oversized_brace_expansion_is_walked_unless_its_pieces_could_leave` (each attack with its control), the shell fixture's double-quoted `bash -c`/`eval` ANSI-C vectors and their controls, `marker.rs` `marker_memo_answers_like_find_marker_once_per_directory`, **`hook.rs` `a_globstar_above_the_checkout_skips_the_own_subtree`** (regression: `ls ../**/README.md` from a 300-directory checkout with no policy is not metadata-only; the sibling `cat ../**/secrets.env` drops), **`hook.rs` `marker_lookups_in_a_deep_tree_cost_one_probe_per_directory`** (regression: 300 paths in a 300-level tree cost fewer than five probes per level; out of budget inside the checkout kept, outside it metadata-only, the sibling checkout's location looked up before a long list inside the checkout, and a shallow nested marker before a deep list), **`hook.rs` `a_dotfiles_checkout_at_home_is_not_the_own_checkout`** (with `~/.git`, `cat */secrets.env` from `~/Projects` drops; a harmless glob kept), the shell fixture's dot-glob directory vectors and their controls, the shell fixture's `**`-then-`..` and `*.log` vectors and the `read_many_files_directories` `**`-then-`..` vectors, **`hook.rs` `constructed_parent_steps_answer_to_another_checkout`** (a `..` after a `**` through a shell, a Glob pattern and a Grep filter, four brace expansions that build a parent step, two zsh glob groups, hex and octal ANSI-C escapes, two dot-glob directory segments, a POSIX-class and four extglob dot-glob segments, a brace-built dot-glob, an oversized brace sequence over `.`, ANSI-C strings in a double-quoted `bash -c` and `eval`, an indented `apply_patch` header next to an unindented one and a Hermes `file_glob` never spool content; the same shapes inside the checkout spool with it, and so do four brace expansions too large to list that cannot leave it, which v2.6.3 kept), **`hook.rs` `a_monorepo_glob_inside_the_own_checkout_is_not_walked`** (in a 300-package checkout, with and without a policy of its own, `packages/*` shell globs stay kept and the sibling `../*/secrets.env` and `../a/*.env` attacks still drop), `hook.rs` `a_glob_walk_outside_the_checkout_stops_at_its_bounds` (directory bound counted while a `**` lists, time budget through an injected clock, no walk inside the checkout), the Node evidence test's `monorepo-*`, `walk-*`, `con-*`, `globstar-*`, `deep-*` and `dotfiles-*` checks, and the Node evidence test's `glob-*`, `search-*`, `patch-*` and `unreadable-target` checks with their controls and `transcript_capture.rs` `a_shell_command_naming_another_checkouts_file_honors_its_policy`, both failing with the foreign lookup disabled, and the Node evidence test's `cross-*` and `fold-unicode` checks, which fail with `captureForeignConfigs` disabled, and the shell fixture's quoted-script, git-object, ANSI-C, escaped-letter and inline-interpreter vectors with their controls (`cargo test`, `git status`/`log`, `pytest`, `python3 -m pytest`, `node build.js`, `npm run test`, a quoted commit message with braces); `router.rs` `capture_protocol_active_keep_of_unprovable_output_is_stripped`; `hook.rs` `excluded_content_cannot_reach_the_spool_through_unevaluated_tool_shapes` (directory entries and Copilot `view`/`create` never spool, readers and brace shells spool without content, public controls spool with it); `render_shared.rs` `generated_capture_policy_v1_node_runtime_evidence` (runs the same fixture sections, including the GHSA-vh98 and Gemini `read_many_files`/`run_shell_command` vectors, plus unsupported-glob, empty-list and recursive-`**` checks, against the emitted TypeScript; `#[ignore]` locally, run with `--ignored` under Node 24 by the Linux CI test job); `hook.rs` `check_capture_refuses_partial_scope_and_excluded_content` (ignored-path and partial-scope violations refused, complete public-path control passes), `check_capture_bounds_marker_hints_and_refuses_oversized_scope` (513-byte hints refused, 512-byte control passes; native routing preserved); **`backfill.rs` `backfill_never_posts_tool_content_the_capture_policy_excludes`** (planted Claude transcript: the excluded read's call and output never reach `/hook/batch`, a malformed read posts only the metadata-only body, public read control posted) and **`run.rs` `ledger_upload_drops_tool_content_the_capture_policy_excludes`** (excluded call and output absent from the finish request, public control present, cursor still advances), both failing with the guard removed; `transcript_capture.rs` `an_excluded_read_drops_its_call_and_result_by_id`, `id_less_results_take_the_strictest_call_of_their_turn`, `unrecoverable_arguments_and_orphan_results_fail_closed_under_a_policy`, `a_call_into_another_checkout_honors_its_policy`, `ledger_events_are_dropped_or_stripped_before_upload`, `without_a_policy_every_event_is_kept` (control); `capture_policy.rs` `tool_call_payload_reaches_the_live_decision_for_every_supported_agent`; **`backfill.rs` `allowlist_mode_backfills_nothing_from_an_unmarked_checkout`** (no request reaches the server; marked-checkout and denylist controls do), **`run.rs` `ledger_upload_under_allowlist_mode_carries_nothing_from_an_unmarked_checkout`** (finish carries no prompt or tool content; marked and denylist controls upload both), `transcript_capture.rs` `allowlist_mode_admits_nothing_from_an_unmarked_checkout`, all failing with the admission gate removed; **`backfill.rs` `backfill_inspects_codex_exec_command_as_the_hook_shell_call`** and **`run.rs` `ledger_upload_inspects_codex_exec_command_as_the_hook_shell_call`** (a planted Codex `exec_command` whose `workdir`-relative argument names an ignored file never posts its call or output; the same command from a public `workdir` does), `capture_policy.rs` `codex_transcript_exec_command_is_inspected_as_the_hook_bash_call` (absolute, relative and absent `workdir` and an argv `cmd` drop, public control kept, the `workdir` locates the call, another agent's `exec_command` stays unknown), all failing with `hook_tool_call` removed; **`backfill.rs` `backfill_resolves_each_call_from_its_record_cwd`** (`cat adr/x.md` recorded from `docs/` never posts; the same command from the root does) and `transcript.rs` `jsonl_events_carry_their_record_cwd` (Claude per line, Codex per turn context, a relative cwd ignored), failing with the record cwd ignored or unstamped; **`backfill.rs` `backfill_drops_reroutes_the_live_hook_would_not_deliver_here`** (under allowlist mode, reads rerouted to an unmarked git repository, to a marker selecting an unregistered profile, and to a marker selecting a registered profile while the source uses the install default are never posted; a read in a marked checkout with no server selection is the posted control), failing with either the admission check or the route comparison removed (each refused case checked on its own); `transcript_capture.rs` `a_record_cwd_answers_to_the_hook_admission_gate_there` (prompt, call and result recorded in an unmarked repository drop under allowlist; a subdirectory of the opted-in checkout is kept and its record cwd never reaches the ledger) and `claude_shell_mode_output_is_not_imported` (stdout, stderr, local-command and size-capped blocks drop; `<bash-input>`, a prompt quoting a tag, and another agent's message kept); **`backfill.rs` `backfill_posts_no_content_for_unrecognized_tools`** (a planted Codex MCP call's arguments and output never post, the call and output post as `tool unknown`; a recognized shell output is the posted control) and `transcript_capture.rs` `unrecognized_tools_keep_no_content_with_or_without_a_policy` (no policy and an active one; ledger content withheld; public read kept; a call-less result content-free), failing with the unknown-family rule removed, the backfill one also with its content-free body removed; **`backfill.rs` `backfill_keeps_reroutes_to_the_same_server_profile_only`** (a reroute into a checkout selecting the source's registered profile and project is posted; one selecting a different registered profile is not, nor one of another project on the same profile, nor a prompt recorded there), failing with the profile comparison forced either way and with the project comparison removed; `transcript_capture.rs` `a_record_cwd_in_another_project_is_dropped` and `a_reroute_into_another_project_is_dropped` (prompt, call and result recorded in, or a read reaching into, a checkout declaring another project drop; one declaring the same project is kept), failing with `routes_to_same_project` removed; `hook.rs` `subdirectories_of_one_repository_are_one_project_only_under_repo_root` (two subdirectories of an unmarked repository, and a subdirectory importing its root, are two projects; the same directory, the root importing a subdirectory and a `repo-root` marker agree), failing with the basename rule removed; **`backfill.rs` `backfill_posts_no_task_notification_or_compact_summary_as_a_prompt`** and `transcript.rs` `claude_adapter_keeps_task_notifications_and_compact_summaries_out_of_prompts` (a monitored command's notification, a background agent's report and an origin-tagged notice are excluded, also behind a byte-order mark and zero-width characters, in another case, with attributes, after a non-text block, or with an origin kind in another case; a compact summary, also flagged `"true"` or `1`, becomes a compaction event; the typed prompt, also one quoting the tag, and a look-alike tag are the controls), failing with either adapter rule removed or with the spelling rules reverted; `transcript_capture.rs` `boundary_events_answer_to_the_record_cwd_admission_gate` (compaction and annotation recorded in a refused directory drop; in the checkout kept), `a_result_whose_id_matches_no_call_is_an_orphan` (an unmatched id cannot borrow a public read's keep; the read's own result kept), `claude_shell_mode_output_is_not_imported` (a block holding a literal closing tag drops) and `unrecognized_tools_keep_no_content_with_or_without_a_policy` (ledger keeps no tool name and no invalid call id), each failing with its rule reverted; `windows_spelling_fixture_vectors` (shared `capture-policy.json` `windows` drop vectors for every spelling above, file tool and shell, with other-drive, other-share, longer-name and pipe controls, and `windows_posix_controls` proving a POSIX session keeps `/c/…`, trailing-dot and colon names; `windows_scopes` drop vectors for a `\\?\C:\`, `\\?\UNC\…`, `\\localhost\C$\…` or UNC cwd and marker directory with relative patterns, a `\\?\C:\…` absolute pattern from `C:\repo`, bare and double-quoted `\\server\share\…`/`\\?\…`/`\\.\…`/`\\localhost\c$\…` PowerShell, cmd, `run_shell_command` and argv commands, and both readings of `/a/x` from `D:\a\…`, each with public-path, other-drive and other-share keep controls; the Node runtime evidence runs the same vectors with the marker spelled in the Windows cwd), `tool_family_fixture_vectors` (shared `tool_families`, every native name per family), new `decisions` vectors (`execute_code` metadata-only, `read_file`/`patch`/`fs_read` operations drop, `write_to_file`/`browser_navigate` keep), `output_spool_work_is_linear_and_budgeted` (a 2,040-wildcard-segment path stays under a linear work bound; 32 such paths fail closed; one long or 32 short paths keep), `an_oversized_shell_command_is_unprovable` (one character over the limit is metadata-only and unlooked-up, at the limit keeps, argv summed, inactive untouched), `inline_code_tools_are_unprovable_under_a_policy`, `hook_capture::capture_section_spellings_match_toml_semantics` (shared `marker_spellings`, including a nested-array line `["docs"]` before a dotted `capture.ignore_paths` that must still drop, and a key line inside an open array, text after a closed array and a multi-line inline table that must fail closed), and the Node evidence test running all of these vectors against the generated TypeScript plus its entry-bound read count for the directory walk; each fails with its rule reverted (Windows reading off, spool memo dropped or budget failing open, length check off, inline-code rule off, a name dropped from the list, TS dotted key or inline-table rule reverted, TS walk back on `readdirSync`, Windows reading of the cwd/marker directory or of an absolute pattern off, literal-backslash reading off, the cwd-drive reading of `/a/x` off, TS array tracking or any `captureValueScan` refusal off, Rust and TS alike) | STRONG with listed residuals. Matching is lexical by design, so these stay open: shell variables (`$VAR`, `FILE=… sh -c 'cat $FILE'`) and the output of a command substitution, a `cd` inside the command, a script read from a file or a heredoc fed to an interpreter (read only for the words it spells out), git's repository root approximated by the marker directory, symlinks (paths are never resolved on disk), a recursive search of a parent directory (`grep -r x docs`, `rg x`) through a shell, a search tool rooted at a literal directory above another checkout (it is not walked) and a glob whose literal root lies inside the event's own checkout reaching a checkout nested there (it is not walked), a marker nested inside the own checkout below what the lookup budget reaches, a `.git` the same command creates (`touch .git; cat */x`: the hook reads the tree after the command ran, so that directory counts as the own checkout; a `.git` at or above the home directory never does), a parameter expansion next to glob syntax (`${X}/*/x`, not walked), a glob through a symlinked directory, a tool's own directory option (`git -C`), script runners and interpreters the matcher does not list (their words are still read, but expansion or inline code in them is not recognized), a value glued after the first letter of a short-flag cluster, non-ASCII percent-escapes in a `file:` URL, a bare word naming another checkout's directory (only separator-bearing arguments are looked up for another marker), harness output files outside the listed default locations, and tools the matcher does not list, which keep their current unknown-tool behavior. Transcript imports add: assistant prose quoting an excluded file is kept (as live prompt/assistant capture keeps it), harnesses whose hook schema the matcher does not read (Crush, Kimi Code) keep their tool events as live capture would, adapters that record no per-record cwd (Pi, OMP, OpenCode, Crush, Kimi Code, Command Code, Kiro, Grok) judge every event from the session cwd, a Codex ledger upload resumed from a mid-file cursor judges the events before the next turn context from the session cwd, and id-less adapters over-drop a whole turn's results when one call is excluded, and when the routing hints leave the project to the server, events from inside one repository count as the importing project even where the server has a separate project registered for a subdirectory (anywhere under `repo-root`; under `basename` only when the import runs from the repository root); a metadata-only import keeps an `event_id` (ledger) and `ingest_key` (backfill) derived from a SHA-256 of the original content plus session and record ids, left in place because those ids are the retry-dedupe keys and a content-free id would merge distinct events — it only confirms a guess of low-entropy content. Under allowlist mode a refused checkout's `ai-memory run` still records repository checkpoint metadata (HEAD, branch, a status hash and changed-path names, never file content), which the run also sends at launch. Re-splitting quoted words over-drops a quoted message naming an ignored path, and inline interpreter code is metadata-only under an active policy. Mitigation: allowlist capture mode (`install-hooks --capture-mode allowlist`) for sensitive projects. Bite checks: removing the nested re-split, the git object path or its marker-root base, Antigravity's `Cwd` key, the leading-`]` rule, either zsh-group rule, ANSI-C decoding or its numeric-escape rule, the `\o` reading, the inline-code rule, the nesting-depth rule, the nested-script scan, the line-continuation join, the Windows escape reading, the shell-option and interpreter-option value skips, the added runners and interpreters, the glued-flag value, the `file:` URL path, the `~+` resolution, the unknown-tilde rule, the parameter-default reading or case folding each fails the Rust tests, and each TypeScript counterpart fails the Node evidence test; so does reverting the `file:` URL cut, the deep-default rule, the escaped-default reading, the quoted-tilde rule, the harness-output rule or Unicode folding (the new fixture vectors fail against the previous matchers in both languages), and disabling the foreign-marker lookup fails the native, import and Node cross-checkout tests; reading every glob location as literal, skipping search/list locations, or skipping a file tool whose targets cannot be read each fails the native, import and Node glob/search/unreadable tests, removing `apply_patch` header reading fails the own-patch control, and reverting the saved-output glob rule fails the new fixture vectors in both languages; walking globs rooted inside the event's checkout fails the monorepo tests, accepting any literal text for a saved-output glob fails the `*.log` vectors, removing the time budget or counting a `**`'s directories only after it lists fails the bounds tests, and removing the `**`-then-`..` readings, the brace-expansion check, the expanded lookup words, the patch-header trim, the `file_glob` key or the dot-glob parent reading each fails the Rust tests and the Node evidence test; treating every oversized brace expansion as leaving, dropping the brace-built dot-glob check, listing the own checkout's subtree under a `**`, looking up locations in their given order (outside before inside, then shallowest first), dropping the per-directory memo, counting a checkout at home as the own one, keeping the backslash before `$` in double quotes, or dropping the POSIX-class or extglob reading each fails its Rust test and the Node evidence test; in a Windows session a shell `workdir` spelled `/c/x` is read only as Git Bash reads it, so arguments resolved from it miss a native tool's `D:\c\x` reading, and the TS marker reader does not validate TOML outside the capture table (a syntax error elsewhere invalidates the policy only natively); a `**/` matches one or more directories, never zero (documented in `marker-file.md`) || 11c | Capture hook ≤200ms budget (invariant #5) | `hooks/_lib.sh` capture path `curl --max-time 0.2` (context-fetch 1.0s and background drain 2.0s are separate, larger-budget paths) | none (shell-script timeout; hard to unit-test) — watch on any capture-path change | WATCH || 11d | Hook server-profile routing: a marker-selected server gets only its own capture and its own token (#992) | `ai-memory-cli/src/server_profiles.rs` `resolve` (validated `ProfileName`, strict `servers.toml` parse, `roots` required once two profiles exist, component-wise root match) and `marker.rs` `find_server_selection` (inherited down the tree, any value shape counts); `commands/hook.rs` `resolve_hook_route` drops a `Rejected` route before spool, handoff and backfill, and hands the drainer no live token for a profile route; `commands/hook_spool.rs` `static_retry_token` (a profile entry retries only with its own stored token), the loopback reroot skip, and chunk splitting on `profile`; generated TS `captureServerRouted` drops a routed repository and gates `fetchHandoff`; `hooks/_lib.sh` `ai_memory_server_routed` (flag refused by `ai_memory_post_hook`/`ai_memory_get_handoff`) and `hooks/lib/ai-memory-hook.ps1` `Test-AiMemoryServerRouted` drop it in the script hooks; `--check-capture` refuses a rejected server-profile selection without printing its token or URL | `hook.rs` `each_repository_spools_to_its_own_profile_with_its_own_token`, `a_selection_that_does_not_resolve_emits_nothing` (unknown / tokenless / outside roots / roots required / invalid name, plus a resolving control), `session_start_handoff_comes_from_the_profile_server_only`, `a_repository_without_a_server_key_keeps_the_install_default`; `hook_spool.rs` `a_profile_entry_is_never_retried_with_the_install_live_token` (server B accepts exactly the install's live token and must still not get it), `a_profile_entry_recovers_with_its_own_rotated_token` (control), `a_profile_entry_on_a_dead_loopback_port_is_not_rerouted_to_the_default`, `profile_and_default_entries_at_one_address_ride_separate_batches`; `server_profiles.rs` roots/registry/name tests; `marker.rs` `nested_markers_without_server_inherit_the_ancestor_selection`; `install_hooks.rs` `generated_integrations_fail_closed_on_a_server_profile_marker`, `openclaw_plugin.rs` `openclaw_plugin_fails_closed_on_a_server_profile_marker`, and the `server-routed-*` checks in `generated_capture_policy_v1_node_runtime_evidence`; `hook.rs` `an_event_without_a_payload_cwd_routes_by_the_process_cwd`, `a_refused_route_prints_nothing_for_kimi_user_prompts`; `hook_spool.rs` `a_profile_entry_is_not_retried_with_a_token_issued_for_a_new_url`; `server_profiles.rs` `changing_the_url_without_a_token_discards_the_old_token`, `omitted_roots_keep_the_registered_ones`; `marker.rs` `outside_home_the_walk_reaches_a_marker_above_the_checkout_root`, `encoding_noise_cannot_hide_a_server_key`, `an_unreadable_marker_is_a_refused_selection`; `backfill.rs` `a_spawned_backfill_authenticates_like_the_hook_that_spawned_it`; `tests/hooks/test_lib.sh` "server profiles (#992)" section; `hook.rs` `a_mixed_spool_drains_each_event_only_to_its_own_server` (two token-gated servers, one spool, one drain: each server receives exactly its own event with exactly its own bearer); `tests/suite/server_profiles.rs` (the built binary: `server add` → `hook` spools to the profile with its token, unknown profile spools nothing, `uninstall` removes the tokens; `two_real_servers_each_receive_only_their_own_repository` runs two real `ai-memory serve` children with different root tokens and checks on each server which repository landed there); `ai-memory-hooks` `powershell_server_routed.rs` `server_routed_guard_mirrors_the_native_walk` (runs `Test-AiMemoryServerRouted` under real PowerShell: inherited, BOM, look-alike keys, the `$HOME` boundary with its control, past a checkout root outside home, current directory); `hook.rs` `a_selection_that_does_not_resolve_emits_nothing` (rejected routes refuse preflight; resolved profile control passes); `tests/hooks/test_lib.sh` and `powershell_home.rs` `a_trailing_separator_on_home_keeps_the_walk_boundary` (a `$HOME` ending in `/` or `\` keeps both script walks at home: a `server` marker above it routes nothing, with a root-home control that does) | STRONG for native hooks, generated TS, `.sh` and `.ps1` hooks. Known gap: an older binary draining a shared spool ignores `profile` || 11e | Native self-upgrade archive confinement (#1025) | `ai-memory-cli/src/commands/upgrade.rs` normalizes every tar/zip path, rejects links and special entries, extracts only the binary and `hooks/`, accepts only the exact non-runtime support layout emitted by `release.yml`, and caps both entry count and declared expanded bytes before writing | `upgrade.rs` `release_workflow_support_assets_are_exact_and_ignored` (shipped support paths admitted, near-miss docs/packaging/template paths refused), `extracts_archive_built_like_release_yml` and `extracts_zip_happy_path_with_hooks` (real workflow-shaped archives succeed but support assets are not written), `validate_rejects_path_traversal`, `zip_extract_rejects_path_traversal`, `tar_extract_rejects_declared_expansion_past_limit`, with binary/hooks extraction as the legitimate control | STRONG |