Repository navigation
Releases
Releases · INK-Q/agy-fast
v0.2.8 — Eager MCP Tool Loading & Host-Compat Alignment
What's New in v0.2.8
Eager MCP Tool Loading ("eager": true) — Root-Cause Fix for call_mcp_tool Argument Corruption (#13, thanks @kf953741)
- Typed Native Tool Declarations (
mcp_config.json): Enables Antigravity's official per-tool"eager": truesetting for all 4 tools (batch_search,apply_edits,read_slices,run_checks), registeringmcp_agy-fast_fast_*upfront (~7.2 KB / ~1.9K cached input tokens total). - Eliminates Corruption Across Both Desktop 2.0 & CLI ≥1.5.8: Completely bypasses untyped lazy
call_mcp_tool, preventing large multi-fileeditspayloads from collapsing into[],[null],[-1], or[true]—while keeping token-saving native JSON arrayedits(~3× fewer output tokens than double-escaped JSON strings). - Seamless Fallback (
rules/AGENTS.md): Updated Rule 1 & Rule 6 to invokemcp_agy-fast_fast_*directly when eagerly loaded, while keeping direct lazycall_mcp_tool+ quick-schema fallback intact for older hosts.
Host Compatibility Controller Alignment (src/utils/host-compat.ts)
- Capped the default
agy-cli-1.5-call-mcp-tool-empty-editsrule atmaxVersionExclusive: "1.5.8"so eager-capable Antigravity CLI≥1.5.8(including1.5.12–1.5.14), Desktop 2.0, IDE, and third-party hosts uniformly receive typed nativearrayschemas and0extraSessionStartbytes—eliminating any split-brain mismatch between eager tool declarations andSessionStartcompat hints. - Pre-eager CLI
1.5.0–1.5.7, explicitAGY_FAST_EDITS_FORMAT/config.jsonoverrides, dual-format runtime acceptance, and corrupted-argument circuit-breakers remain fully intact as a safety net.
简体中文摘要
- 启用官方
"eager": true急加载,从根因消除call_mcp_tool嵌套参数损坏(#13,感谢@kf953741):在mcp_config.json为 4 个工具开启官方"eager": true急加载,直接注册带完整 JSON Schema 的原生声明mcp_agy-fast_fast_*(4 工具总计仅 ~7.2 KB / ~1.9K 可缓存输入 tokens),在 Antigravity 桌面端 2.0 与 CLI ≥1.5.8 上彻底绕过无类型call_mcp_tool,根治edits: []/[null]/[-1]/[true]丢参并保留省 3× 输出 token 的原生数组传参;同时更新rules/AGENTS.md优先急加载直调并保留老宿主懒加载回退。 - 宿主兼容控制器边界对齐(
src/utils/host-compat.ts):为agy-cli-1.5-call-mcp-tool-empty-edits增加maxVersionExclusive: "1.5.8",使支持急加载的 CLI ≥1.5.8、桌面端 2.0、IDE 与第三方客户端统一使用强类型原生数组且SessionStart零额外字节(消除急加载声明与启动提示脑裂),同时保留旧版懒加载 CLI1.5.0–1.5.7的自动保护与AGY_FAST_EDITS_FORMAT/config.json覆盖。
Full Changelog: v0.2.7...v0.2.8
v0.2.7 — Host Version Controller, Workspace Root CWD, 170s Budget & Windows PowerShell
What's New in v0.2.7
Antigravity Host Surface & Version Compatibility Controller (#10, building on @fwyc0573)
- Surface & SemVer 2.0 Detection (
src/utils/host-compat.ts): Identifies Antigravity CLI, Desktop 2.0, IDE, and third-party MCP hosts via MCPinitializeclientInfo,SessionStart.gemini/antigravity*paths, andANTIGRAVITY_LS_VERSION(supporting 4-part builds and SemVer 2.0 prerelease precedence, with strict cross-surface and third-party client isolation). - Token-Saving Defaults + Targeted CLI 1.5.x Protection: Defaults to native
arrayedits(~2.6x–3.3x fewer output tokens and0extraSessionStartbytes) on Desktop 2.0, IDE, third-party hosts, and unaffected CLI versions; automatically switchesapply_editsto JSON array string schema + a compact 1-line[agy-fast compat]SessionStart directive on affected Antigravity CLI 1.5.x builds to avoidcall_mcp_tooledits: []payload loss (server runtime always accepts both). - Overrides & Diagnostics: Configurable via
AGY_FAST_EDITS_FORMAT=auto|array|string,AGY_FAST_HOST, andnode scripts/install.mjs config --edits-format ..., with liveHost compatoutput indoctor. - Argument Corruption & JSON Diagnostics: Treats
edits: []/"[]"and stringified"true"/"false"/"null"ascall_mcp_toolserialization corruption (with decoded type labels and benchmark accounting), and returns preciseJSON.parse/ non-array errors for malformed JSON strings.
Workspace Root cwd, 170 s Call Budget, Stable batch_search & Python Outlines (#9, thanks @fwyc0573)
- Workspace Root as Default
cwd: Queries MCProots/listonnotifications/initializedandnotifications/roots/list_changed, resolving omitted and relativecwdagainst the first valid workspace root without mutating globalprocess.cwd(); hardened with bounded wait timeouts, EOF/error/out-of-order sequencing, 64-entryknownRootsIdscap, batch queue flushing beforewaitForRoots(), mixed\n\r\nContent-Lengthframing, and gracefulstdoutEPIPEexit. - 170 s Shared Call Budget: Caps
run_checksandapply_editsverifytimeouts at170 s(under Antigravity's180 sMCP limit) using monotonicperformance.now(), reporting unstarted commands as[NOT RUN]and rejecting boolean/non-numeric timeout coercion. - Deterministic
batch_searchTruncation &rg/Node Parity: 2-pass--count->--jsonflow keeps first matches in deterministic path order onmaxResultstruncation; adds unconditional--no-config&--crlf, guards bare-filenames, enforces 2 MB / binary /globchecks on single-file targets, avoids line-number gaps when truncating withcontextLines > 0, tolerates transient Pass-2 ENOENT when stderr is empty, and aligns negated!globin Node fallback. - Python Symbol Outline Hardening: Fixes decorator/body ranges across triple-quoted strings, multiline calls/signatures, backslash continuations inside quoted strings, Python 3.12+ PEP 701 f-strings, and mid-edit unclosed bracket recovery.
Windows Selective PowerShell Routing & Codepage Decoding (#1, thanks @BLACK-BIRTHDAY)
- Routes Windows commands containing PowerShell syntax (
$env:, cmdlets,$x = ...,$(...),@(...)) throughpwsh->powershell.exe->cmd.exe(caching resolved executable paths) with forced UTF-8 output while keeping plain commands oncmd.exe. - Decodes non-UTF-8 Windows console codepages (CP936/GBK, CP950/Big5, CP932/Shift_JIS, CP949/EUC-KR, CP1250–1258, CP850/CP437) cleanly without mojibake.
简体中文摘要
- Antigravity 宿主端与版本检查控制器(#10,基于
@fwyc0573扩展):识别 CLI / 桌面端 2.0 / IDE / 第三方客户端及版本(支持 4 段版本号与 SemVer 2.0 预发布比较,严格隔离跨端与第三方客户端);默认优先省 token 的原生数组(桌面端/IDE/其他客户端 0 额外SessionStart字节),在受影响的 CLI 1.5.x 自动切换apply_edits.edits为 JSON 数组字符串以防[]丢参;支持AGY_FAST_EDITS_FORMAT/AGY_FAST_HOST/install.mjs config --edits-format覆盖与doctor诊断;补齐edits: []/"true"/"null"熔断与非法 JSON 精确报错。 - 工作区默认
cwd与 170s 预算 / 稳定搜索 / Python 大纲(#9,感谢@fwyc0573):通过加固版 MCProots/list解析工作区默认cwd;run_checks与apply_editsverify上限调整为170s并采用单调时钟共享预算;batch_search2-pass 路径有序截断并补齐--no-config/--crlf/单文件过滤/中途删文件容错与!glob一致性;Python 大纲支持字符串内\续行、PEP 701 f-string 与未闭合括号恢复。 - Windows 选择性 PowerShell 路由与多代码页解码(#1,感谢
@BLACK-BIRTHDAY):仅对含 PowerShell 语法的命令按pwsh -> powershell.exe -> cmd.exe路由并强制 UTF-8 输出,无乱码解码 GBK/Big5/Shift_JIS/EUC-KR 及 CP1250–1258 等控制台编码。
Full Changelog: v0.2.6...v0.2.7
v0.2.6 — Runtime Safety Hardening, T3 Code ACP Sync, Multi-Surface Benchmark & New Logo/Diagrams
What's Changed in v0.2.6
Security & Runtime Hardening (#7, thanks @hzhe0083-source)
- Untrusted
.git/config& read-only Git sandbox hardening: Neutralizes untrusted repo config execution across bothbatch_searchandSessionStartsnapshots (-c core.fsmonitor=false -c diff.external= -c gpg*.program=false,--no-ext-diff --no-textconvfordiff/log/show/shortlog,--no-textconvforblame, blocking--ext*/--textc*prefixes); restores--merged/--no-merged/--contains/--no-contains/--points-atandtag -nwhile blocking dash-prefixed tokens (including--) after commit-filter flags and keepingtag -v/--verifydisabled; adds offline-nand URL/path rejection toremote show, and defaultHEADtoshortlog. - MCP framing,
SessionStartlifecycle & UTF-8 / UTF-16 surrogate safety: Fixes mixed\n\n/\r\n\r\nContent-Lengthframing, strictly anchorsContent-Lengthheaders withlatin1decoding and a 64 MiB frame cap, rejects{}with-32600, normalizes stringified JSON objectparams.arguments; boundsSessionStartstdin to 256 KB, releases open stdin cleanly (pause()+unref()+ no-op error listener), enforces<= 1,500UTF-8 bytes acrosssnapshot + updateNotice, and adds surrogate-safe slicing (sliceSafeChars) plusNumber.isFinitebyte-budget guards. apply_edits, EOL detection & auto-updater reliability: Protects dangling symlinks oncreate(with rollback restore and unlink before rename-fallback writes), deduplicates symlinked parent directories, validatesverifyupfront, uses majority EOL detection; fixesmain-channel downgrade/overwrite guards, writesplugin.jsonlast in atomic swaps withfinallytemp cleanup, fetchesgit-cloneupdates from verified local staging (no remote TOCTOU), protectsdev-sourceeven with--force, and reclaims dead-PID locks (ESRCH).
Added & Improved
- Auto-sync global installs to T3 Code ACP & isolated
GEMINI_HOMEprofiles (#7):install/update/doctor/uninstallautomatically discover and sync~/.t3/userdata/providers/antigravity/*/andGEMINI_HOMEprofiles while keeping profileconfig.jsonuntouched and enforcing ownership guards (--no-acpto opt out). - Search, outliners & multi-surface benchmark accuracy (#7): Fixes single-file truncation reporting, cross-file
contextLines, Node fallback multi-batch continuation pastperFileCap, and phantom EOF^$matches; improves TSX/TS (JSX</Tag>& scoped self-closing/>without breaking/>/gregexes, multiline templates), Python (.pyi& multiline signatures), Rust, Go, and Shell outliners; expandsbenchmark --localacross Desktop 2.0, CLI, IDE, T3 Code ACP,GEMINI_HOME, andANTIGRAVITY_APP_DATA_DIR, preserving coordinator/worker/snapshot identity across--since. - Redesigned geometric logo & dual-theme SVG architecture diagrams (#6, thanks
@GoodCoder666): Updated to a flat two-tone geometric "A" mark with light/dark theme switching (assets/logo-{light,dark}.svg) and custom light/dark English & Chinese SVG architecture diagrams (assets/architecture-*.svg).
简体中文摘要(v0.2.6)
- 不可信
.git/config与只读 Git 沙箱全面加固(#7,感谢@hzhe0083-source):为batch_search与SessionStart统一注入-c core.fsmonitor=false -c diff.external= -c gpg*.program=false及--no-ext-diff/--no-textconv;恢复branch/tag过滤参数并封堵紧跟--的选项解析绕过;保持禁用tag -v/--verify;remote show离线注入-n并拒绝 URL/路径,shortlog默认HEAD。 - 全局安装自动同步 T3 Code ACP 与隔离
GEMINI_HOME(#7):install/update/doctor/uninstall自动同步~/.t3/userdata/providers/antigravity/*/与GEMINI_HOME配置(支持--no-acp关闭,不触碰config.json)。 - MCP、SessionStart、UTF-8/代理对安全与全面修复(#7):严格行锚定
Content-Length与 64 MiB 帧上限、SessionStart256 KB 限流与 1500B UTF-8 预算、零孤立代理对、apply_edits悬空符号链接与多数行尾保护、自动更新器防降级/末位plugin.json/本地 staging 防 TOCTOU/死 PID 锁回收、Node 回退多批次与多语言大纲修复,以及多端--local基准发现与--since身份保持。 - 全新几何 Logo 与双主题 SVG 架构图(#6,感谢
@GoodCoder666):明暗双主题几何 "A" Logo 与中英文双主题定制 SVG 架构图。
Full Changelog: v0.2.5...v0.2.6
v0.2.5 — P0 Safety Fixes: Git Sandbox, Installer Protection & apply_edits Rollback
Security & Safety Release (v0.2.5)
Fixes three P0 safety and data-integrity issues (#5, thanks @ErrantSnow):
Fixed
- Read-only
git branch/git tagsandbox bypass (src/tools/batch-search.ts,src/benchmark-core.ts):- Separated Git optional-value flags (
--merged,--no-merged,--abbrev,--color,--column) from value-consuming flags so they accept=-attached values without settingexpectValue = trueto skip validation on the next space-separated token (blocking bypasses likebranch --color -D --column target,branch --color -m main hacked,branch --abbrev new-branch, andtag --color -d --column v0.2.2). - Removed
--abbrev,--color, and--columnfromGIT_BRANCH_VALUE_FLAGSinsrc/benchmark-core.ts.
- Separated Git optional-value flags (
- Installer source-repo protection &
--targetownership verification (scripts/install.mjs):- Resolves
fs.realpathwith case folding onwin32/darwinto prevent same-repo deletion across symlinked paths or case variants. - Refuses deleting
REPO_ROOTor any strict ancestor directory ofREPO_ROOT. - Requires non-empty, non-symlink target directories to contain
plugin.jsonwith"name": "agy-fast"before deletion, and unlinks symlinks/junctions (including broken links) directly without touching link targets.
- Resolves
apply_editsPhase-2 fallback truncation &createrollback safety (src/tools/apply-edits.ts):- Isolates temp-file
writeFile/chmodfailures (cleans up the temp file and rethrows without falling back toO_TRUNCdirect writes on the target). - Records the file in
writtenbefore the rename-fallback direct write so any mid-write failure rolls back the target's original content/permissions or removes a newly created file. - Treats only
ENOENTas missing in Phase-1create, failing fast onEACCES/EBUSY/ENOTDIRinstead of misclassifying an existing file as non-existent.
- Isolates temp-file
简体中文更新摘要(v0.2.5)
安全与数据完整性加固版本,修复三项 P0 级安全与防误删漏洞(#5,感谢 @ErrantSnow):
- 封堵只读
git branch/git tag沙箱绕过:将 Git 可选值参数(--merged、--no-merged、--abbrev、--color、--column)拆离消费下个参数的白名单,彻底拦截branch --color -D --column target、branch --color -m ...、tag --color -d ...等绕过,并同步修正benchmark-core.ts。 - 安装器防误删源仓库与
--target归属校验:通过fs.realpath+win32/darwin大小写归一化避免软链/大小写变体误删源仓库;拦截对源仓库及任意祖先目录的删除;删除非空非软链目录前强校验plugin.json的name === "agy-fast";软链/Windows junction/死链直接fs.unlink不触碰目标目录。 - 修复
apply_edits写盘截断与create回滚误删:将临时文件写入/chmod失败与rename隔离,不再触发回退直写截断原文件;真正rename失败走回退直写前先加入回滚队列;Phase-1create仅将ENOENT视为文件不存在,遇到EACCES/EBUSY等错误直接快速失败,避免回滚误删已有文件。
Full Changelog: v0.2.4...v0.2.5
v0.2.4 — Corrupted MCP Arg Circuit-Breaker, Search Perf, Stress Benchmark & README Overhaul
Highlights
Fixed
- Circuit-breaker for corrupted
call_mcp_toolnested arguments across all 4 MCP tools (apply_edits,batch_search,read_slices,run_checks):- Detects when Antigravity's untyped
call_mcp_toolargument parser collapses nested edit/query/slice/command objects into booleans ornull(e.g.,edits: [true],[false, true],[null], orhunks: [true]). - Immediately returns an actionable circuit-breaker message instructing the caller not to retry the same payload and to fall back to parallel built-in tools—eliminating multi-minute retry loops observed in live sessions.
- Prevents uncaught
TypeErrorcrashes onnull/primitive array entries and transparently accepts stringified JSON arrays.
- Detects when Antigravity's untyped
- Read-only
gitshell chaining guard: Rejects standalone shell operators (&&,||,;,|) inbatch_searchgitqueries with guidance to split into separate queries.
Improved
- Search & fuzzy-path performance: Added a zero-allocation ASCII fast path in
fuzzy-match.ts, switched hot-path filename sorting from ICUlocaleCompareto deterministic code-unit comparison, and replaced regexmatchAllscanning ofrgsummary output with direct\0index scanning. - Rules & benchmark diagnostics:
- Updated
rules/AGENTS.mdRule 3 (keep all images out of>150k-token main sessions to prevent prompt-cache invalidation), Rule 5 (corrupted-arg circuit-breaker fallback), and Rule 6 (swarm worker brief guidance). - Added
agyCorruptedArgCalls,agyCorruptedArgWastedSec,agyCorruptedArgWastedOutTokens, andswarmWorkerSessionsmetrics todist/benchmark.mjs.
- Updated
- Reproducible 12-scenario stress benchmark (
npm run bench:stress): Covers 3,000–6,000 file monorepos,rg+ pure-Node fallback, 5×5,000-line / 40-file outlines + ReDoS resilience, 50-file atomic & Phase-2 disk rollback /bestEffort/ 2 MB noisyverify, 12-wayrun_checks+ 5 MB log flood + grandchild process-tree kill, 400-request soak under a strict 128 MB V8 heap cap, 20-attack read-only git red-team checks, and all 14 outline formats + 4-byte emoji UTF-8 truncation safety.
Documentation
- Reorganized English and Simplified Chinese READMEs (#4, thanks
@GoodCoder666): Added badges, KPI summary table, bottleneck breakdown, hybrid execution Mermaid diagram, collapsible install/example/env sections, expanded FAQ, and Star History chart.
简体中文更新摘要
- 全 4 工具接入
call_mcp_tool嵌套参数序列化损坏熔断与容错:精准识别edits: [true]/[false, true]/[null]等底层序列化损坏,直接返回明确熔断提示引导立即回退并行原生工具(消除实测中反复重试白烧十余分钟的问题),同时修补queries/outlines/hunks收到null/原始值可能崩溃的隐患,并兼容 JSON 字符串化数组参数。 - 大规模搜索性能优化与只读 Git 链式拦截:
fuzzy-match新增零分配 ASCII 快速路径、热路径移除昂贵 ICUlocaleCompare、rg汇总输出改为直接\0扫描,并拦截只读git查询中的独立&&/||/;/|链式符。 - 规则、基准与 12 场景全链路压测:Rule 3 扩展至任意图片(防 >150k 长对话缓存清零)、Rule 5 补入熔断指引、Rule 6 优化 Swarm Worker 协作提示;
benchmark新增参数损坏耗时与 Swarm Worker 覆盖率指标;新增npm run bench:stress12 场景端到端压测套件。 - README 全面改版(#4,感谢
@GoodCoder666):中英文 README 新增状态徽章、核心指标速览表、混合架构 Mermaid 图、折叠示例与更完整的 FAQ。
Full Changelog: v0.2.3...v0.2.4
v0.2.3 — GDScript Outlines & Extended batch_search Modes
Added
- Godot GDScript (
.gd) symbol outlining inread_slices(#2, thanks@star-dino)- Extracts
class_name, nested innerclass(with accuratedepth),func/static func, single- and multilinesignal, and named/anonymous single- and multilineenumblocks. - Handles Godot 4 annotations (
@tool,@rpc(...),@abstract, etc.), multiline typed signatures,#/##comments,"""/'''triple-quoted strings, Tab/space indentation, and UTF-8 BOM / CRLF line endings.
- Extracts
- Extended
batch_searchmodes, language filtering, multiline matching, fuzzy path lookup & mtime sorting (#3, thanks@onezero-harmony)- Added
outputMode("content"|"files_with_matches"|"count") to return only matching file paths or per-file match counts within the 8.8 KB inline budget. - Added
fileTypelanguage/extension filtering (e.g.,typescript,ts,python,gdscript) acrosstext,regex, andfuzzyqueries. - Added
multiline: truecross-linetext/regexmatching across bothrgand Node.js fallback (with automatic retry without strictumode for ripgrep-valid identity escapes like\:/\#). - Added
type: "fuzzy"case-insensitive multi-token path lookup (src/utils/fuzzy-match.ts) with Windows backslash normalization and contiguous-substring-first ranking. - Added
sortBy: "mtime"forglobqueries to list recently modified files first.
- Added
Documentation
- Added sanitized 10-day real-world latency, token-quota, and upload-bandwidth benchmarks, an explicit non-invasive UI/diff guarantee, and a concise FAQ to
README.mdandREADME.zh-CN.md.
简体中文摘要(v0.2.3)
read_slices新增 Godot GDScript(.gd)大纲提取(#2,感谢@star-dino):完整支持class_name、嵌套内部class、func/static func、单行/多行signal与具名/匿名enum,兼容 Godot 4 行内注解、三引号字符串、Tab/空格缩进及 BOM/CRLF。batch_search新增多模式检索、语言过滤、跨行匹配、模糊路径与按修改时间排序(#3,感谢@onezero-harmony):支持outputMode(content/files_with_matches/count)、fileType、multiline: true(rg与 Node 双路径一致,且兼容\:/\#等转义)、type: "fuzzy"(兼容 Windows 反斜杠与连续子串优先排序)以及glob的sortBy: "mtime"最新优先排序。- 文档增强:中英文 README 新增 10 天脱敏实测数据(耗时、额度、上传流量)、无侵入声明(不影响原生 Diff 窗口与文件修改列表)及常见问题 FAQ。
v0.2.2 — Glob Fallback, Outline Batch Tuning & Swarm Guidance
Improved
- Smart fallback & hints for
batch_searchglobqueries (src/tools/batch-search.ts)- Preserves exact glob matching first; only when exact matching returns 0 files, automatically recovers two common LLM mistakes observed in live transcripts:
- Regex alternation passed to
glob(e.g.,test|smoke|live) is auto-expanded with a concise inline note (or returns a syntax hint when still empty). - Bare keywords without wildcards, slashes, or extension dots (e.g.,
proxy) fall back to case-insensitive path substring matching (*proxy*) while keeping missing explicit filenames (e.g.,missing.ts) cleanly as(no files matched).
- Regex alternation passed to
- Preserves exact glob matching first; only when exact matching returns 0 files, automatically recovers two common LLM mistakes observed in live transcripts:
- Higher-density large outline batches (
src/tools/read-slices.ts)- Tuned
perFileSymbolLimitfor larger batches (11–20files:16symbols;>20files:10depth-0-prioritized symbols) and shortened per-file omission footers (... (+N more symbols)) so 30–40 file calls spend less of the 8.8 KB cap on truncation boilerplate. - Appends a 1-line batching tip when outlining
>20files exceeds the 8.8 KB inline budget, steering callers toward 10–20 files per batch.
- Tuned
- Swarm worker & schema guidance (
rules/AGENTS.md,src/mcp-server.ts)- Added concise guidance in Rule 6 to remind swarm workers in their brief to batch searches/edits via
agy-fast_fast(if available) or parallel rangedread_fileinstead of serialls/grepshell calls, since swarm workers do not receive theSessionStartsnapshot. - Clarified
batch_searchglob syntax (*/{a,b}, not regex|) and recommendedread_slicesoutline batch sizes (10–20files, max 40) in bothAGENTS.mdand MCP tool schemas.
- Added concise guidance in Rule 6 to remind swarm workers in their brief to batch searches/edits via
简体中文摘要(v0.2.2)
batch_search的glob智能容错与提示:精确匹配优先不变;仅在精确命中为 0 时,自动恢复实测对话中常见的两类误传——正则交替符|(如test|smoke|live)与无通配符/扩展名的裸关键词(如proxy),并在输出头部附带简短语法提示,同时保持明确缺失文件名(如missing.ts)的原样空结果。read_slices大批量大纲预算优化:收紧11–20文件(16 符号)与>20文件(10 顶层优先符号)的单文件上限并精简省略提示,减少 8.8 KB 上限内被截断尾注吃掉的字节;一次请求>20文件超预算时尾部提示改用 10–20 文件分批。- Swarm Worker 路由与 Schema 补充:在
rules/AGENTS.md补充协调者拉起 swarm worker 时在brief中提示使用agy-fast_fast或并行带行号read_file(避免因缺少SessionStart快照而退化为串行ls/grep),并在规则与 MCP Schema 同步注明glob语法及大纲推荐批量。
v0.2.1 — Zero-Latency Background Auto-Updater & CLI Update/Config
[0.2.1] - 2026-11-19
Added
- Zero-latency background auto-update (
dist/updater.mjs+SessionStart)- Checks for newer stable release tags every 12 hours via a detached, unref'd background process after
SessionStartemits its workspace snapshot (0 ms added to session startup). - Uses
git ls-remote --tags --refs(avoiding GitHub REST API rate limits and respecting native git/system proxy settings) with automatic fallback to the GitHub Releases API. - Stages downloads in an isolated temp directory, validates all runtime files and runs a live MCP 4-tool handshake smoke test before atomically replacing live files (
tmp -> rename); broken staged releases are rejected without touching the existing install. - Protects
--linkdev symlinks, local source directories, and dirty git clones from overwriting (notify-only), while auto-updating standard copied installs and clean directgit cloneinstalls safely. - Concurrency lock (
~/.gemini/cache/agy-fast/update.lockwith 10-minute stale recovery) prevents duplicate parallel updates across subagents; surfaces a one-time notice in the nextSessionStartsnapshot.
- Checks for newer stable release tags every 12 hours via a detached, unref'd background process after
- Manual
update&configCLI subcommands (scripts/install.mjs,install.sh,install.ps1)- Added
update [--check] [--force] [--channel release|main] [--repo <url>]andconfig --auto-update auto|notify|off --interval <hours> --channel release|main --repo <url>. - Added environment variable overrides (
AGY_FAST_AUTO_UPDATE,AGY_FAST_UPDATE_INTERVAL_HOURS,AGY_FAST_UPDATE_CHANNEL,AGY_FAST_REPO) andnpm run update:plugin. - Updated
doctorto display installed version, auto-update mode/interval/channel, and last check status (with background checks disabled duringdoctorsmoke tests).
- Added
简体中文摘要(v0.2.1)
- 零启动延迟的后台自动更新(
dist/updater.mjs+SessionStart):每 12 小时在SessionStart输出快照后异步拉起完全分离的后台更新进程,0 ms 启动阻塞;支持并发锁防重入,并在下一次新会话展示一次性更新提示。 - 先暂存冒烟校验、再原子替换:优先走
git ls-remote --tags(规避 GitHub API 限流并原生走系统/git 代理),暂存目录先做全运行文件与实时 MCP 4 工具握手校验,通过后再按文件原子替换;损坏版本自动拦截。 - 安全保护与可控配置:常规复制安装与干净
git clone自动更新,--link软链接与脏仓库仅提示不覆盖;新增update [--check]与config --auto-update auto|notify|off子命令(兼容install.sh/install.ps1)及环境变量覆盖,doctor同步展示版本号与自动更新状态。
Full Changelog: v0.2.0...v0.2.1
v0.2.0 — Inline Cap Hardening, Vue/CSS/Route Outliner & TTFT Hygiene
[0.2.0] - 2026-11-19
Production-hardening release driven by real-world Antigravity CLI & Desktop 2.0 transcript telemetry.
Added
- Vue/Svelte SFC, CSS/SCSS, Fastify/Express route & test-suite outlining (
read_slices)- Extracts
<script>,<template>(handling nested<template #slot>+ semantic/Modal landmarks), and<style>block boundaries for.vue/.sveltefiles. - Extracts
:root,[data-theme],@layer/@media/@keyframes/@container/@supports, section comments, and top-level rule groups for.css/.scss/.lessfiles. - Detects
app/router/server/fastify.(get|post|put|patch|delete|all|route)handlers inside large setup functions anddescribe/it/testblocks in test suites. - Raised
outlinesbatch cap from20to40files with depth-0-first multi-file fairness so a single large class never crowds out other files in the batch.
- Extracts
apply_editspartial-commit mode (bestEffort), fuzzy recovery & line-drift hints- Added
bestEffort: trueso valid files in a multi-file batch commit atomically per file even when another file fails validation, preventing redundant full-batch regeneration. - Added closest-region snippet hints (
findClosestRegionSnippet), bounded wide-range failure snippets (<= 26lines), and whole-file exact-match detection whenstartLine/endLinehas drifted.
- Added
batch_searchglob truncation directory summary- Deterministic sorted glob results with an
omitted dirs:per-directory breakdown when matches exceedmaxResults.
- Deterministic sorted glob results with an
- Inlined MCP tool schemas & multimodal/long-context TTFT hygiene in
rules/AGENTS.md- Inlined compact tool schemas directly in
AGENTS.mdto eliminate the lazy-load schema-read turn (mcp/agy-fast_fast/*.json). - Added empirical routing & TTFT hygiene rules: outline via
read_slices({ outlines })then read known ranges via parallel built-inread_file(StartLine, EndLine)(~7 ms, 46 KB/call inline, 0 remote check); keep screenshots/images in dedicated subagents returning text-only findings to avoid the 3–7× multimodal TTFT cliff (>180k context); pack>=2independent non-interactive shell commands intorun_checks(compactfor build/test,fullfor diagnostic scripts).
- Inlined compact tool schemas directly in
- Enhanced
benchmarkCLI & health diagnostics- Added
--since <ISO>,--until <ISO>, and--split-usageflags plus tracking for lazy-loadedcall_mcp_toolinvocations and async idle waits. - Added health & multimodal metrics:
mcpSpillCalls(output.txtspills),agyTruncatedCalls,agyErrorCalls,multiMcpTurns,multiRunCommandTurns,mediaLoadedCount, andmultimodalHighCtxTurns(>=180k context with media loaded).
- Added
- Multi-module
SessionStartsnapshots & update guide- Auto-detects multi-module subproject manifests (
pom.xml,web/package.json,desktop/package.json, monorepo subpackages) alongside root manifests. - Added dedicated update instructions in README.md and README.zh-CN.md.
- Auto-detects multi-module subproject manifests (
Changed
- Hard
<= 8,800 BUTF-8 inline cap across all 4 MCP tools- Enforced strict UTF-8 byte-budgeted water-filling (
<= 8,800 B) unconditionally inread_slices,batch_search,run_checks, andapply_edits(even when callers explicitly pass a largermaxChars/maxVerifyChars), eliminating Antigravity's ~10 KB MCPoutput.txtspill-to-disk extra turns. - Appends a concise 1-line hint when
read_slicesslices are truncated to steer bulk range reads back to parallel built-inread_file.
- Enforced strict UTF-8 byte-budgeted water-filling (
- Smarter
verify/run_checksfailure filtering- Strips Pino/Bunyan info/debug JSON request logs (
level: 10/20/30), Maven[Help 1]boilerplate footers, and NodeExperimentalWarningnoise before budgeting failure output. - Expands context windows around Spring Boot
Description:/Action:, JavaCaused by:, compilation errors, and Vitest failure summaries so root causes are preserved.
- Strips Pino/Bunyan info/debug JSON request logs (
- Budgeted
SessionStartsnapshots- Allocates fixed per-section budgets (
Project→Git→Layout) so dirty repos with 100+ modified files never truncate scripts or directory layout. - Collapses noisy directories (
tmp/,output/,artifacts/,SSL/,logs/) and prioritizes source/test directories (src/,tests/,scripts/) while filtering build/report artifacts (dist-*,playwright-report/) in 2nd-level trees.
- Allocates fixed per-section budgets (
Fixed
- TS/JS outliner (
findBraceBlockEnd): Fixed no-semicolon (semi: false) single-linetypealiases swallowing the followinginterfaceblock, fixed inline object types inside parameter parentheses prematurely closing function end lines, and raised multiline signature lookahead from 15 to 40 lines. - Windows PowerShell 5.1 installer (
install.ps1): Avoided single-string splatting and unexpected terminal exit when executed viairm ... | iex.
简体中文摘要(v0.2.0)
- 全工具硬封顶
<= 8.8 KBUTF-8 内联输出:彻底杜绝显式大maxChars触发 Antigravity MCP 10 KB 落盘output.txt导致的额外轮次损耗,并在read_slices切片截断时提示改用并行内置read_file。 - 大纲提取器全面升级:新增
.vue/.svelte(<script>/<template>/<style>)、.css/.scss(:root/[data-theme]/@media/@keyframes/分区注释)、Fastify/Express 路由与describe/it测试提取;修复无分号 TStype吞并、参数对象类型提前截断与长多行函数签名 Bug;outlines上限提至 40 文件并按顶层结构公平分配。 apply_edits容错与verify过滤增强:支持bestEffort部分落盘、行号漂移精确命中提示、有界宽窗口提示;verify失败过滤剔除 Pino info JSON 与 Maven 尾注,保留 Spring BootDescription:与 JavaCaused by:根因。- 路由规则与 TTFT 卫生规范:内联 MCP Schema 免去懒加载读 Schema 轮次;明确
read_slices探大纲 + 并行read_file读正文;扩展run_checks至多条诊断命令(outputMode: "full");明确多模态截图隔离给子 Agent、长会话分阶段/compact以避免 40–97s TTFT 悬崖。 - 快照、搜索与基准完善:多模块子项目快照与二级目录源码置顶;
glob截断按目录汇总;benchmark支持--since/--until/--split-usage及落盘/截断/报错/并发泄漏/多模态高危轮次指标;修复 Windows PowerShell 5.1install.ps1兼容性。
Full Changelog: v0.1.0...v0.2.0