FylloCode v0.14.0-beta.2

这个 beta 版本继续强化 Agent 工作流和项目准则治理。Chat 与 Apply 现在会自动注入项目准则索引，Agent 能在修改代码前读取相关约定；同时 fyllo-cortex 的 guidelines 工具改为专注维护准则。Plan、Proposal、健康检查与归档流程的提示边界也更清晰，减少 Agent 在不同工作流之间的误判。

Highlights

• Chat 与 Apply 自动注入 guidelines/**/*.md 索引，帮助 Agent 按项目约定执行工作。
• 健康检查现在会单独检查项目准则状态，并直接引导修复缺失、损坏或过期的准则。
• Slash Command 和配置项菜单补齐搜索、hint 与 hover 详情，命令发现更顺手。
• Proposal 详情新增“可归档”“归档中”等更准确的状态展示。
• Plan、Proposal、Apply 与 Archive 的 Agent instruction 更聚焦，反馈语言和下一步入口
  更明确。

Breaking Changes

• fyllo-cortex MCP server 升级到 0.4.0，guidelines 工具移除了 read / write 模式，改用 init、create 或 update。

Notes

• fyllo-specs MCP server 升级到 0.6.1，主要更新 Agent instruction，不新增 tool。

---

This beta release tightens Agent workflow guidance and project guideline governance. Chat and Apply now inject a project guideline index so agents can read relevant conventions before changing code, while the fyllo-cortex guidelines tool focuses on maintaining those documents. Plan, Proposal, health-check, and archive prompts are also clearer, reducing ambiguity between FylloCode workflows.

Highlights

• Chat and Apply now inject a guidelines/**/*.md index so agents can work against project conventions.
• Health checks now inspect project guideline health separately and guide direct fixes for missing, broken, or stale guidelines.
• Slash Command and config-option menus now show richer search, hints, and hover details.
• Proposal details now distinguish ready-to-archive and archiving states more clearly.
• Agent instructions for Plan, Proposal, Apply, and Archive are more focused, with clearer progress language and next-step guidance.

Breaking Changes

• fyllo-cortex MCP server is now 0.4.0; the guidelines tool removed read / write modes. Use init, create, or update instead.

Notes

• fyllo-specs MCP server is now 0.6.1, updating Agent instructions without adding new tools.

---

Full Changelog: v0.14.0-beta.1...v0.14.0-beta.2

FylloCode v0.14.0-beta.1

这个 beta 版本新增轻量 Plan 工作流，让复杂但不改变外部契约的任务可以先形成可审阅方案，再进入实施。Chat 现在支持创建、审阅、编辑并批准 session 级 plan，并把批准记录接入 lineage。这个版本也改善了长会话阅读体验，并修复 Proposal 详情元数据可能过期的问题。

Highlights

• 新增 session-scoped Plan 工作流：通过 fyllo-specs create-plan 创建轻量计划，并用 plan.create action 在应用内审阅。
• Plan Slideover 支持编辑、保存和批准方案；批准后会提示 Agent 重新读取最新 plan 再实施。
• Chat 新增用户 prompt 时间线、消息复制、发送时间展示，以及可折叠的会话侧栏。
• Proposal 详情打开时会后台刷新元数据，避免任务数量、状态或日期显示旧数据。
• MCP 更新：fyllo-specs 升级到 0.6.0，新增 create-plan；fyllo-cortex 升级到 0.3.1，lineage session 输出包含 plans。

Notes

• 本地 lineage session link 新增 plans 字段；既有数据会按空数组读取，不需要手动迁移。

---

This beta release adds a lightweight Plan workflow for complex work that needs review before implementation but does not change external contracts. Chat can now create, review, edit, and approve session-scoped plans, with approvals connected to lineage. The release also improves long-conversation navigation and fixes stale Proposal detail metadata.

Highlights

• Added a session-scoped Plan workflow: fyllo-specs create-plan creates lightweight plans, and plan.create opens them for in-app review.
• Plan Slideover supports editing, saving, and approving plans; after approval, the agent is prompted to reread the latest plan before implementation.
• Chat now includes a user prompt timeline, message copy actions, sent-time display, and a collapsible session sidebar.
• Proposal details refresh metadata in the background when opened, avoiding stale task counts, status, or dates.
• MCP updates: fyllo-specs is now 0.6.0 with create-plan; fyllo-cortex is now 0.3.1 with plans in lineage session output.

Notes

• Local lineage session links now include a plans field. Existing data is read as an empty array and requires no manual migration.

---

Full Changelog: v0.13.3...v0.14.0-beta.1

FylloCode v0.13.3

这个版本强化了项目治理信息的阅读与回溯体验。你现在可以从 Overview 进入只读能力规约浏览页，在当前页面上下文中打开 Proposal 详情，并直接查看 proposal 对能力规约的变更影响。Chat 也减少了连续工具调用带来的噪音，并修复了重启后历史 proposal 关联可能丢失的问题。

Highlights

• 新增 /specs 只读能力规约浏览页，可查看当前项目的 Purpose、Requirement、Scenario 和更新时间。
• Proposal 详情改为右侧 Slideover，支持从列表、Overview 和 Chat EventRail 原地打开。
• Proposal 详情新增 Specs tab，用 badge 展示能力规约的新增、修改、移除和重命名变更。
• Chat 连续工具调用现在会折叠为可展开工具组，消息流更容易阅读。
• 修复 session 重开后历史 proposal 可能无法回填到 Chat EventRail 的问题。

Notes

• /proposal/:id 独立详情路由已移除。请从 /proposal 列表、Overview 进行中变更或 Chat EventRail 打开 Proposal 详情。

---

This release improves how project governance artifacts are read and traced in the app. You can now open a read-only capability specs browser from Overview, view Proposal details without leaving the current context, and inspect how a proposal changes capability contracts. Chat also reduces noise from consecutive tool calls and fixes proposal
associations after restarts.

Highlights

• Added the read-only /specs browser for Purpose, Requirements, Scenarios, and update metadata.
• Proposal details now open in a right-side Slideover from the list, Overview, and Chat EventRail.
• Proposal details now include a Specs tab with added, modified, removed, and renamed capability deltas.
• Consecutive Chat tool calls now collapse into expandable tool groups for easier reading.
• Fixed historical proposals not being restored into Chat EventRail after reopening sessions.

Notes

• The standalone /proposal/:id detail route has been removed. Open Proposal details from the /proposal list, Overview active changes, or Chat EventRail.

---

Full Changelog: v0.13.2...v0.13.3

FylloCode v0.13.2

这个版本继续把 Chat 收敛为项目治理的主要操作入口。你现在可以在会话事件轨中直接查看当前会话关联的 proposal，跟随状态变化开始实现、查看详情，并在实现完成后归档。文档站也补齐了中英文结构、博客入口和 sitemap；项目许可证同步切换为 MIT。

Highlights

• Chat 事件轨新增会话 proposal 面板，可实时展示 proposal 状态并支持开始实现、查看详情和归档。
• 待处理 Fyllo action 现在会出现在事件轨中，点击后可定位回原始 action card。
• Chat session 列表新增关联任务提示，可按需查看任务来源和 lineage 中保存的任务标题。
• Activity Bar、App Header、tooltip 和共享 surface 样式完成一轮统一，界面层级和交互反馈更一致。
• 文档站新增英文站点、博客索引、ACP Agent 分层与 lineage 设计文章，并支持 sitemap。
• 项目许可证从 AGPL-3.0 切换为 MIT。

Fixed

• 修复新 proposal 状态先于列表加载到达时，事件轨可能只显示 raw change id 的问题。
• 修复长 change id 挤压 proposal 状态 badge 的布局问题。
• 修复 creating 状态 proposal 仍显示不可用操作入口的问题。
• 修复新绑定任务的 session 需要重新加载列表才显示来源任务信息的问题。

Notes

• 本次没有更新 fyllo-specs / fyllo-cortex MCP server 本体。
• 无破坏性变更或手动迁移要求。

---

This release continues turning Chat into the main operating surface for project governance. The session event rail can now show proposals linked to the current session, follow their status changes, start implementation, open details, and archive completed proposals. The documentation site also gains a bilingual structure, blog entry points, and sitemap support, while the project license moves to MIT.

Highlights

• Chat event rail now includes linked session proposals with live status, implementation, detail, and archive actions.
• Pending Fyllo actions now appear in the event rail and can locate the original action card.
• Chat session list now shows linked-task indicators with task source and lineage snapshot titles on hover.
• Activity Bar, App Header, tooltips, and shared surface styling were unified for more consistent hierarchy and feedback.
• Documentation site now includes an English locale, blog indexes, ACP agent layer and lineage design posts, plus sitemap support.
• Project license changed from AGPL-3.0 to MIT.

Fixed

• Fixed cases where early proposal status updates could leave the event rail showing only a raw change id.
• Fixed long change ids squeezing proposal status badges.
• Fixed creating-state proposals showing unavailable action entry points.
• Fixed newly task-bound sessions requiring a session-list reload before origin task information appeared.

Notes

• This release does not update the fyllo-specs or fyllo-cortex MCP server implementations.
• No breaking changes or manual migration required.

---

Full Changelog: v0.13.1...v0.13.2

FylloCode v0.13.1

这个补丁版本继续收敛项目治理与 Chat 体验，同时提升 ACP Agent 扩展性与主进程稳定性。新增自定义 ACP Agent 配置、Chat 会话事件轨，以及 fyllo-cortex 的 lineage 工具；主进程存储与通信也更加安全。

Highlights

• 现在可以通过 custom-agents.json 接入自定义 ACP Agent，扩展 Agent 选择范围
• Chat 的执行计划面板整合到会话事件轨，执行进度更清晰，输入区更简洁
• fyllo-cortex MCP server 新增 lineage 工具，支持按文件、commit 或 proposal 追溯代码变更的设计来源
• Proposal 导航并入 Overview，项目治理视图更加统一
• 主进程存储改为原子写入，并加固了解析、启动与日志脱敏，提升稳定性与安全性

Fixed

• 修复 overview 与 lineage 中 proposalStatus 推导不一致的问题
• 修复 ACP 二进制归档解压的 zip slip 风险
• 限制外部导航仅允许 http/https scheme

---

This patch release tightens project governance and the Chat experience while improving ACP Agent extensibility and main-process stability. Custom ACP agents, a new Chat session event rail, and the fyllo-cortex lineage tool make it easier to trace and control your work.

Highlights

• Register custom ACP agents via custom-agents.json to extend the agent roster
• The Chat execution plan panel is now part of the session event rail, keeping progress visible while decluttering the input area
• The fyllo-cortex MCP server adds a lineage tool to trace the design history behind code changes by file, commit, or OpenSpec proposal
• Proposal navigation moves into Overview for a more unified project governance view
• Main-process storage now uses atomic writes, with hardened parsing, startup, and log redaction for better stability and safety

Fixed

• Corrected inconsistent proposalStatus derivation between overview and lineage
• Guarded ACP binary archive extraction against zip-slip path traversal
• Restricted external navigation to http/https schemes

---

Full Changelog: v0.13.0...v0.13.1

FylloCode v0.13.0

这个版本聚焦可追溯的项目治理。新的 Overview 成为项目默认入口，Task、Chat、Proposal 通
过 lineage 串联成可回溯主线，同时 Chat 获得 Fyllo action 交互能力，并修复了多会话流式
输出和 ACP 工具调用展示的稳定性问题。

Highlights

• 新增项目 Overview，集中展示治理指标、进行中变更、近期讨论和 lineage 数据。
• 新增 lineage 链路，把任务、聊天会话和 proposal 持久化关联起来。
• Chat 支持 ，首个 task.create 可由用户确认后创建并绑定本地任务。
• 恢复多会话并行流式输出，切换会话不再丢失其他运行中会话的更新。
• 新增 VitePress 文档站，补齐产品指南、功能参考和内置 MCP server 文档。

Fixed

• 修复 ACP Agent 启动时未读取 registry args / env 的问题。
• 修复并发 Chat stream 的 MessagePort 交接错绑风险。
• 改进不同 ACP Agent 的工具调用卡片兼容性。

Notes

• 本地 task 与 session metadata 新增 lineage 和 action-state 字段；既有数据仍可读取，
  不需要手动迁移。

---

This release focuses on traceable project governance. Overview is now the default
project entry, Task, Chat, and Proposal are connected through lineage, Chat can
render confirmed Fyllo actions, and parallel streaming plus ACP tool-call
compatibility are more reliable.

Highlights

• Added the Project Overview page for governance metrics, active changes, recent
  threads, and lineage data.

• Added persisted lineage links across tasks, chat sessions, and proposals.

• Added Chat support, starting with confirmed task.create actions.

• Restored parallel Chat session streaming so switching sessions no longer drops
  updates.

• Added the VitePress documentation site with guides, feature references, and bundled
  MCP server docs.

Fixed

• Fixed ACP Agent startup so registry args and env are applied.
• Fixed MessagePort handoff risks for concurrent Chat streams.
• Improved tool-call card compatibility across different ACP Agents.

Notes

• Local task and session metadata now includes lineage and action-state fields.
  Existing data remains readable; no manual migration is required.

---

Full Changelog: v0.12.1...v0.13.0

FylloCode v0.12.1

本版本修复 codex-acp 权限请求处理中的紧急问题。FylloCode 在自动处理 ACP Agent 权限请求
时，现在会选择 allow_once，避免未预先批准的命令被 codex-acp 的已批准前缀匹配逻辑直接
返回 user abort。

Highlights

• 修复 ACP Agent 执行命令时可能因 user abort 无法继续的问题
• 权限请求改为一次性允许路径，让当前未批准命令可以通过本次授权继续执行
• 无破坏性变更，建议使用 codex-acp 的用户升级

---

This release fixes an urgent codex-acp permission request handling issue. When
FylloCode auto-handles ACP Agent permission requests, it now selects allow_once,
avoiding codex-acp's approved-prefix matching path that returned user abort for
commands that had not already been approved.

Highlights

• Fixed ACP Agent command execution getting blocked by user abort
• Permission requests now use one-time approval so the current unapproved command can
  proceed through the active request
• No breaking changes; upgrading is recommended for users running codex-acp

FylloCode v0.12.0

这个版本聚焦 Chat 体验收敛、会话执行进度可见性，以及版本信息补齐。你现在可以在 About 面板里直接检查 GitHub 正式 Release 是否有新版本；Chat 也补上了执行计划展示、消息加载骨架屏，以及更稳定的 Slash Commands 数据来源。

Highlights

• About 面板新增 GitHub 正式 Release 检测，可直接跳转到对应版本页面
• Chat 会话新增内联 ACP 执行计划面板，可查看当前计划进度、条目状态与优先级
• Agent 可用命令现在会按会话捕获并回显，让草稿态和正式会话中的 Slash Commands 更稳定
• 聊天历史加载新增骨架屏，并优化了 Markdown 渲染开销，减少等待感与长消息渲染压力
• 渲染层确认弹窗交互已统一，设置、任务和 Agent 相关操作的一致性更好

Fixed

• 修复流式回复在停止生成或异常中断时，部分助手内容可能直接丢失的问题
• 修复 Chat 中 mode 类配置项仍可能被显示的问题；在权限控制准备好之前，这些控件现已隐藏

---

This release focuses on tightening the Chat experience, exposing session execution progress, and improving version visibility. You can now check GitHub official releases directly from the About panel, while Chat gains inline plan visibility, a loading skeleton for session history, and a more stable data source for Slash Commands.

Highlights

• Added GitHub official release checking in the About panel, with a direct link to the matching release page
• Added an inline ACP execution plan panel in Chat sessions to show plan progress, item status, and priority
• Agent available commands are now captured and restored per session, making Slash Commands more reliable in both draft and regular sessions
• Added a loading skeleton for chat history and reduced Markdown rendering overhead for smoother long-message and loading states
• Unified confirmation dialog behavior across renderer flows, improving consistency in settings, tasks, and Agent actions

Fixed

• Fixed cases where partially generated assistant content could be lost when a streaming reply was stopped or interrupted by an error
• Fixed a case where mode config options could still appear in Chat before the related permission gating was ready, and those controls are now hidden

FylloCode v0.11.3

[0.11.3] - 2026-06-01

中文版

This patch release focuses on consolidating the local JSON persistence model and introducing a proper migration path. The app now runs data migrations automatically at startup, bringing persisted field naming and time formats into a single consistent shape instead of letting historical formats diverge over time. It also fixes a case where the config options bar could stay empty when starting a new draft session with the same Agent as before.

Added

• Local JSON data migration framework, running migrations in version order during app startup and providing a baseline mechanism so new installs do not replay historical migrations
• Initial persistence migration scripts to rename the historical config_options field to configOptions and convert timestamp fields in several caches and install records to ISO 8601 strings

Changed

• Unified field naming conventions across persisted JSON files around camelCase
• Unified time field formats in the ACP registry cache, status cache, and installed records to ISO 8601 strings, reducing cross-module read/write inconsistencies
• Reorganized migration script registration into a dedicated scripts directory with a static registry for easier future extension and maintenance
• Corrected runtime dependency classification by moving @nuxt/ui into production dependencies so the component library is not treated as development-only

Fixed

• Fixed a case where creating a new draft session with the same Agent as the previous draft would not re-trigger config option probing, leaving the config bar empty
• Fixed migration runner tests to improve regression coverage stability for the migration flow
• Fixed invalid warning output in the icon build script

FylloCode v0.11.2

[0.11.2] - 2026-06-01

中文版

This patch release focuses on ACP Agent management improvements. Installed Agents can now be uninstalled from inside the app, Agent lists show clearer kind information, and the Chat empty-state picker layout is more stable. Agent installation status detection is also much faster, reducing wait time in settings and selection surfaces.

Added

• ACP Agent uninstall flow, allowing installed Agents to be removed from settings after confirmation and using the correct uninstall command for each installation method
• ACP Agent kind classification, shown in registry cache, settings cards, and Chat empty-state cards to help distinguish different Agent categories
• Agent installation status cache with background refresh, allowing the app to show the most recent known result first and then update status asynchronously

Changed

• Agent installation status detection now runs in batched distribution-level probes, significantly reducing the time spent checking Agents one by one
• In the Chat empty state, Agent picker tiles now center automatically when fewer than four Agents are installed, avoiding left-heavy sparse layouts
• ACP Agent cards now share a common presentation base, move uninstall into the overflow menu, and use top-right badges for installed and selected states
• Agent card external links now prioritize website and repository, and the "latest version" hint has been removed from installed states

Fixed

• Fixed cases where the Chat empty-state "More Agents" tile could stretch or appear visually unbalanced when only a small number of Agents were installed
• Fixed stale local install records and capability caches that could remain after a successful uninstall
• Fixed cases where uninstall could be misreported as successful after a silent underlying command failure by rechecking the real installation state after completion