Skip to content

Releases

v0.2.8 — Eager MCP Tool Loading & Host-Compat Alignment

Choose a tag to compare

@INK-Q INK-Q released this 21 Nov 16:05

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": true setting for all 4 tools (batch_search, apply_edits, read_slices, run_checks), registering mcp_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-file edits payloads from collapsing into [], [null], [-1], or [true]—while keeping token-saving native JSON array edits (~3× fewer output tokens than double-escaped JSON strings).
  • Seamless Fallback (rules/AGENTS.md): Updated Rule 1 & Rule 6 to invoke mcp_agy-fast_fast_* directly when eagerly loaded, while keeping direct lazy call_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-edits rule at maxVersionExclusive: "1.5.8" so eager-capable Antigravity CLI ≥1.5.8 (including 1.5.12–1.5.14), Desktop 2.0, IDE, and third-party hosts uniformly receive typed native array schemas and 0 extra SessionStart bytes—eliminating any split-brain mismatch between eager tool declarations and SessionStart compat hints.
  • Pre-eager CLI 1.5.0–1.5.7, explicit AGY_FAST_EDITS_FORMAT / config.json overrides, 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 零额外字节(消除急加载声明与启动提示脑裂),同时保留旧版懒加载 CLI 1.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

Choose a tag to compare

@INK-Q INK-Q released this 21 Nov 11:26

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 MCP initialize clientInfo, SessionStart .gemini/antigravity* paths, and ANTIGRAVITY_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 array edits (~2.6x–3.3x fewer output tokens and 0 extra SessionStart bytes) on Desktop 2.0, IDE, third-party hosts, and unaffected CLI versions; automatically switches apply_edits to JSON array string schema + a compact 1-line [agy-fast compat] SessionStart directive on affected Antigravity CLI 1.5.x builds to avoid call_mcp_tool edits: [] payload loss (server runtime always accepts both).
  • Overrides & Diagnostics: Configurable via AGY_FAST_EDITS_FORMAT=auto|array|string, AGY_FAST_HOST, and node scripts/install.mjs config --edits-format ..., with live Host compat output in doctor.
  • Argument Corruption & JSON Diagnostics: Treats edits: [] / "[]" and stringified "true" / "false" / "null" as call_mcp_tool serialization corruption (with decoded type labels and benchmark accounting), and returns precise JSON.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 MCP roots/list on notifications/initialized and notifications/roots/list_changed, resolving omitted and relative cwd against the first valid workspace root without mutating global process.cwd(); hardened with bounded wait timeouts, EOF/error/out-of-order sequencing, 64-entry knownRootsIds cap, batch queue flushing before waitForRoots(), mixed \n\r\n Content-Length framing, and graceful stdout EPIPE exit.
  • 170 s Shared Call Budget: Caps run_checks and apply_edits verify timeouts at 170 s (under Antigravity's 180 s MCP limit) using monotonic performance.now(), reporting unstarted commands as [NOT RUN] and rejecting boolean/non-numeric timeout coercion.
  • Deterministic batch_search Truncation & rg/Node Parity: 2-pass --count -> --json flow keeps first matches in deterministic path order on maxResults truncation; adds unconditional --no-config & --crlf, guards bare - filenames, enforces 2 MB / binary / glob checks on single-file targets, avoids line-number gaps when truncating with contextLines > 0, tolerates transient Pass-2 ENOENT when stderr is empty, and aligns negated !glob in 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 = ..., $(...), @(...)) through pwsh -> powershell.exe -> cmd.exe (caching resolved executable paths) with forced UTF-8 output while keeping plain commands on cmd.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):通过加固版 MCP roots/list 解析工作区默认 cwd;run_checks 与 apply_edits verify 上限调整为 170s 并采用单调时钟共享预算;batch_search 2-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

Choose a tag to compare

@INK-Q INK-Q released this 21 Nov 07:00

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 both batch_search and SessionStart snapshots (-c core.fsmonitor=false -c diff.external= -c gpg*.program=false, --no-ext-diff --no-textconv for diff/log/show/shortlog, --no-textconv for blame, blocking --ext*/--textc* prefixes); restores --merged/--no-merged/--contains/--no-contains/--points-at and tag -n while blocking dash-prefixed tokens (including --) after commit-filter flags and keeping tag -v/--verify disabled; adds offline -n and URL/path rejection to remote show, and default HEAD to shortlog.
  • MCP framing, SessionStart lifecycle & UTF-8 / UTF-16 surrogate safety: Fixes mixed \n\n / \r\n\r\n Content-Length framing, strictly anchors Content-Length headers with latin1 decoding and a 64 MiB frame cap, rejects {} with -32600, normalizes stringified JSON object params.arguments; bounds SessionStart stdin to 256 KB, releases open stdin cleanly (pause() + unref() + no-op error listener), enforces <= 1,500 UTF-8 bytes across snapshot + updateNotice, and adds surrogate-safe slicing (sliceSafeChars) plus Number.isFinite byte-budget guards.
  • apply_edits, EOL detection & auto-updater reliability: Protects dangling symlinks on create (with rollback restore and unlink before rename-fallback writes), deduplicates symlinked parent directories, validates verify upfront, uses majority EOL detection; fixes main-channel downgrade/overwrite guards, writes plugin.json last in atomic swaps with finally temp cleanup, fetches git-clone updates from verified local staging (no remote TOCTOU), protects dev-source even with --force, and reclaims dead-PID locks (ESRCH).

Added & Improved

  • Auto-sync global installs to T3 Code ACP & isolated GEMINI_HOME profiles (#7): install / update / doctor / uninstall automatically discover and sync ~/.t3/userdata/providers/antigravity/*/ and GEMINI_HOME profiles while keeping profile config.json untouched and enforcing ownership guards (--no-acp to opt out).
  • Search, outliners & multi-surface benchmark accuracy (#7): Fixes single-file truncation reporting, cross-file contextLines, Node fallback multi-batch continuation past perFileCap, and phantom EOF ^$ matches; improves TSX/TS (JSX </Tag> & scoped self-closing /> without breaking />/g regexes, multiline templates), Python (.pyi & multiline signatures), Rust, Go, and Shell outliners; expands benchmark --local across Desktop 2.0, CLI, IDE, T3 Code ACP, GEMINI_HOME, and ANTIGRAVITY_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 帧上限、SessionStart 256 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

Choose a tag to compare

@INK-Q INK-Q released this 21 Nov 05:02

Security & Safety Release (v0.2.5)

Fixes three P0 safety and data-integrity issues (#5, thanks @ErrantSnow):

Fixed

  • Read-only git branch / git tag sandbox 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 setting expectValue = true to skip validation on the next space-separated token (blocking bypasses like branch --color -D --column target, branch --color -m main hacked, branch --abbrev new-branch, and tag --color -d --column v0.2.2).
    • Removed --abbrev, --color, and --column from GIT_BRANCH_VALUE_FLAGS in src/benchmark-core.ts.
  • Installer source-repo protection & --target ownership verification (scripts/install.mjs):
    • Resolves fs.realpath with case folding on win32/darwin to prevent same-repo deletion across symlinked paths or case variants.
    • Refuses deleting REPO_ROOT or any strict ancestor directory of REPO_ROOT.
    • Requires non-empty, non-symlink target directories to contain plugin.json with "name": "agy-fast" before deletion, and unlinks symlinks/junctions (including broken links) directly without touching link targets.
  • apply_edits Phase-2 fallback truncation & create rollback safety (src/tools/apply-edits.ts):
    • Isolates temp-file writeFile/chmod failures (cleans up the temp file and rethrows without falling back to O_TRUNC direct writes on the target).
    • Records the file in written before 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 ENOENT as missing in Phase-1 create, failing fast on EACCES/EBUSY/ENOTDIR instead of misclassifying an existing file as non-existent.

简体中文更新摘要(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-1 create 仅将 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

Choose a tag to compare

@INK-Q INK-Q released this 21 Nov 04:20

Highlights

Fixed

  • Circuit-breaker for corrupted call_mcp_tool nested arguments across all 4 MCP tools (apply_edits, batch_search, read_slices, run_checks):
    • Detects when Antigravity's untyped call_mcp_tool argument parser collapses nested edit/query/slice/command objects into booleans or null (e.g., edits: [true], [false, true], [null], or hunks: [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 TypeError crashes on null/primitive array entries and transparently accepts stringified JSON arrays.
  • Read-only git shell chaining guard: Rejects standalone shell operators (&&, ||, ;, |) in batch_search git queries 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 ICU localeCompare to deterministic code-unit comparison, and replaced regex matchAll scanning of rg summary output with direct \0 index scanning.
  • Rules & benchmark diagnostics:
    • Updated rules/AGENTS.md Rule 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, and swarmWorkerSessions metrics to dist/benchmark.mjs.
  • 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 noisy verify, 12-way run_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 快速路径、热路径移除昂贵 ICU localeCompare、rg 汇总输出改为直接 \0 扫描,并拦截只读 git 查询中的独立 &&/||/;/| 链式符。
  • 规则、基准与 12 场景全链路压测:Rule 3 扩展至任意图片(防 >150k 长对话缓存清零)、Rule 5 补入熔断指引、Rule 6 优化 Swarm Worker 协作提示;benchmark 新增参数损坏耗时与 Swarm Worker 覆盖率指标;新增 npm run bench:stress 12 场景端到端压测套件。
  • README 全面改版(#4,感谢 @GoodCoder666):中英文 README 新增状态徽章、核心指标速览表、混合架构 Mermaid 图、折叠示例与更完整的 FAQ。

Full Changelog: v0.2.3...v0.2.4

v0.2.3 — GDScript Outlines & Extended batch_search Modes

Choose a tag to compare

@INK-Q INK-Q released this 20 Nov 15:02

Added

  • Godot GDScript (.gd) symbol outlining in read_slices (#2, thanks @star-dino)
    • Extracts class_name, nested inner class (with accurate depth), func / static func, single- and multiline signal, and named/anonymous single- and multiline enum blocks.
    • 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.
  • Extended batch_search modes, 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 fileType language/extension filtering (e.g., typescript, ts, python, gdscript) across text, regex, and fuzzy queries.
    • Added multiline: true cross-line text/regex matching across both rg and Node.js fallback (with automatic retry without strict u mode 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" for glob queries to list recently modified files first.

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.md and README.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

Choose a tag to compare

@INK-Q INK-Q released this 20 Nov 07:56

Improved

  • Smart fallback & hints for batch_search glob queries (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).
  • Higher-density large outline batches (src/tools/read-slices.ts)
    • Tuned perFileSymbolLimit for larger batches (11–20 files: 16 symbols; >20 files: 10 depth-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 >20 files exceeds the 8.8 KB inline budget, steering callers toward 10–20 files per batch.
  • 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 ranged read_file instead of serial ls/grep shell calls, since swarm workers do not receive the SessionStart snapshot.
    • Clarified batch_search glob syntax (*/{a,b}, not regex |) and recommended read_slices outline batch sizes (10–20 files, max 40) in both AGENTS.md and MCP tool schemas.

简体中文摘要(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

Choose a tag to compare

@INK-Q INK-Q released this 19 Nov 13:39

[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 SessionStart emits 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 --link dev symlinks, local source directories, and dirty git clones from overwriting (notify-only), while auto-updating standard copied installs and clean direct git clone installs safely.
    • Concurrency lock (~/.gemini/cache/agy-fast/update.lock with 10-minute stale recovery) prevents duplicate parallel updates across subagents; surfaces a one-time notice in the next SessionStart snapshot.
  • Manual update & config CLI subcommands (scripts/install.mjs, install.sh, install.ps1)
    • Added update [--check] [--force] [--channel release|main] [--repo <url>] and config --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) and npm run update:plugin.
    • Updated doctor to display installed version, auto-update mode/interval/channel, and last check status (with background checks disabled during doctor smoke tests).

简体中文摘要(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

Choose a tag to compare

@INK-Q INK-Q released this 19 Nov 13:04

[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/.svelte files.
    • Extracts :root, [data-theme], @layer/@media/@keyframes/@container/@supports, section comments, and top-level rule groups for .css/.scss/.less files.
    • Detects app/router/server/fastify.(get|post|put|patch|delete|all|route) handlers inside large setup functions and describe/it/test blocks in test suites.
    • Raised outlines batch cap from 20 to 40 files with depth-0-first multi-file fairness so a single large class never crowds out other files in the batch.
  • apply_edits partial-commit mode (bestEffort), fuzzy recovery & line-drift hints
    • Added bestEffort: true so 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 (<= 26 lines), and whole-file exact-match detection when startLine/endLine has drifted.
  • batch_search glob truncation directory summary
    • Deterministic sorted glob results with an omitted dirs: per-directory breakdown when matches exceed maxResults.
  • Inlined MCP tool schemas & multimodal/long-context TTFT hygiene in rules/AGENTS.md
    • Inlined compact tool schemas directly in AGENTS.md to 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-in read_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 >=2 independent non-interactive shell commands into run_checks (compact for build/test, full for diagnostic scripts).
  • Enhanced benchmark CLI & health diagnostics
    • Added --since <ISO>, --until <ISO>, and --split-usage flags plus tracking for lazy-loaded call_mcp_tool invocations and async idle waits.
    • Added health & multimodal metrics: mcpSpillCalls (output.txt spills), agyTruncatedCalls, agyErrorCalls, multiMcpTurns, multiRunCommandTurns, mediaLoadedCount, and multimodalHighCtxTurns (>=180k context with media loaded).
  • Multi-module SessionStart snapshots & 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.

Changed

  • Hard <= 8,800 B UTF-8 inline cap across all 4 MCP tools
    • Enforced strict UTF-8 byte-budgeted water-filling (<= 8,800 B) unconditionally in read_slices, batch_search, run_checks, and apply_edits (even when callers explicitly pass a larger maxChars/maxVerifyChars), eliminating Antigravity's ~10 KB MCP output.txt spill-to-disk extra turns.
    • Appends a concise 1-line hint when read_slices slices are truncated to steer bulk range reads back to parallel built-in read_file.
  • Smarter verify / run_checks failure filtering
    • Strips Pino/Bunyan info/debug JSON request logs (level: 10/20/30), Maven [Help 1] boilerplate footers, and Node ExperimentalWarning noise before budgeting failure output.
    • Expands context windows around Spring Boot Description: / Action:, Java Caused by:, compilation errors, and Vitest failure summaries so root causes are preserved.
  • Budgeted SessionStart snapshots
    • 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.

Fixed

  • TS/JS outliner (findBraceBlockEnd): Fixed no-semicolon (semi: false) single-line type aliases swallowing the following interface block, 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 via irm ... | iex.

简体中文摘要(v0.2.0)

  • 全工具硬封顶 <= 8.8 KB UTF-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 测试提取;修复无分号 TS type 吞并、参数对象类型提前截断与长多行函数签名 Bug;outlines 上限提至 40 文件并按顶层结构公平分配。
  • apply_edits 容错与 verify 过滤增强:支持 bestEffort 部分落盘、行号漂移精确命中提示、有界宽窗口提示;verify 失败过滤剔除 Pino info JSON 与 Maven 尾注,保留 Spring Boot Description: 与 Java Caused 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.1 install.ps1 兼容性。

Full Changelog: v0.1.0...v0.2.0