Repository navigation
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