Fioooooooo · Fioooooooo · May 20, 2026 · May 19, 2026 · May 19, 2026 · May 19, 2026
diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -0,0 +1,56 @@
+name: Bug report
+description: Report a reproducible issue
+labels: [bug]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Please provide reproducible details so the issue can be diagnosed quickly.
+  - type: textarea
+    id: summary
+    attributes:
+      label: Issue summary
+      description: What happened?
+      placeholder: Briefly describe the problem
+    validations:
+      required: true
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Steps to reproduce
+      description: Describe how to reproduce it step by step
+      placeholder: |
+        1. ...
+        2. ...
+        3. ...
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected result
+      placeholder: What should have happened
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual result
+      placeholder: What actually happened
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: Version
+      placeholder: e.g. 0.9.0 / commit hash / build version
+  - type: textarea
+    id: env
+    attributes:
+      label: Environment
+      placeholder: OS, architecture, Electron version, etc.
+  - type: textarea
+    id: extra
+    attributes:
+      label: Additional context
+      placeholder: Logs, screenshots, recordings, or extra notes
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Project README
+    url: https://github.com/Fioooooooo/FylloCode#readme
+    about: Check the README before opening a new issue
diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -0,0 +1,32 @@
+name: Feature request
+description: Suggest a new feature or improvement
+labels: [enhancement]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Please describe the scenario and value, not just the conclusion.
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem to solve
+      placeholder: What pain point are you trying to address?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      placeholder: How do you want this to work?
+    validations:
+      required: true
+  - type: textarea
+    id: impact
+    attributes:
+      label: Expected impact
+      placeholder: What value would this change bring?
+  - type: textarea
+    id: extra
+    attributes:
+      label: Additional context
+      placeholder: Links, sketches, screenshots, or notes
diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
@@ -0,0 +1,26 @@
+## Summary
+
+<!-- Briefly describe what this PR changes. -->
+
+## Related Issue
+
+<!-- Link related issues, if any. Example: Fixes #123 -->
+
+## What Changed
+
+<!-- List the main changes in this PR. -->
+
+## How Tested
+
+<!-- Describe the tests you ran and any manual verification. -->
+
+## Screenshots / Recordings
+
+<!-- Add screenshots or recordings if the UI changed. -->
+
+## Checklist
+
+- [ ] `test` passed
+- [ ] `lint` passed
+- [ ] `typecheck` passed
+- [ ] Documentation updated if needed
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -0,0 +1,46 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  quality:
+    name: Test, lint, and typecheck
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10.33.0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: pnpm
+          cache-dependency-path: pnpm-lock.yaml
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Run tests
+        run: pnpm test
+
+      - name: Run lint
+        run: pnpm lint
+
+      - name: Run typecheck
+        run: pnpm typecheck
diff --git a/.gitignore b/.gitignore
@@ -16,3 +16,4 @@ auto-imports.d.ts
 components.d.ts
 .eslintrc-auto-import.json
 *.tsbuildinfo
+.worktrees/
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -4,9 +4,9 @@ All notable changes to this project will be documented in this file.
 
 The format is based on Keep a Changelog, adapted for the current stage of the project.
 
-## [0.9.0] - 2026-05-13
+## [0.9.0] - 2026-05-20
 
-First structured pre-1.0 release. FylloCode has moved beyond the initial scaffold and now covers the main proposal, task, chat, workflow, and agent integration flows needed for MVP validation.
+First stable `0.9.0` release. On top of the initial beta baseline, FylloCode now further completes multi-worktree orchestration, session-list interaction refinements, built-in specs workspace capabilities, and a set of product-level UX and reliability improvements needed for broader day-to-day use.
 
 ### Added
 
@@ -17,22 +17,33 @@ First structured pre-1.0 release. FylloCode has moved beyond the initial scaffol
 - System reminder injection for new ACP sessions, including persistence and UI filtering
 - Built-in `fyllo-specs` MCP server for proposal, apply-change, archive-change, and explore workflows
 - Workflow editor and built-in workflow templates
+- Multi-worktree foundation, including chat orchestration, archive orchestration, and proposal list worktree scanning
+- Settings About panel for version visibility inside the desktop app
 
 ### Changed
 
 - Integration model refactored toward provider-based connections and project-level resource mounting
 - Activity bar, welcome flow, and navigation structure refined around current product layout
 - ACP agent process lifecycle and shutdown behavior improved for desktop stability
 - Packaging and bundled resource path handling refined for app distribution
+- Built-in `fyllo-specs` workspace upgraded to support the latest project workflow expectations
+- Session list behavior refined toward a conversation-first interaction model
+- Apply and archive prompt guardrails tightened, with `includeInstruction` handling made more explicit
+- System reminder template assets moved to standalone text resources for easier maintenance
+- Settings navigation width and chat status indicator styling refined
+- `.worktrees` is now ignored in the repository to reduce local workspace noise
 
 ### Fixed
 
 - Unpacked MCP server path resolution during packaging
 - macOS ARM64 build fatal issues and Fyllo icon loading problems
 - Streaming pipeline consistency between chat and proposal execution flows
 - Test assertions around reminder persistence and apply-change fixture handling
+- Chat submitted state is now preserved during `usage_update` events
+- Chat state is reset correctly when creating a new session
+- Documentation and test spec inconsistencies cleaned up
 
 ### Notes
 
-- Version `0.9.0` marks the start of formal changelog tracking
-- `1.0.0` is reserved for the point where MVP is fully validated and core product contracts are considered stable
+- This release consolidates everything shipped across `0.9.0-beta.1` through `0.9.0-beta.3` into the first stable `0.9.0`
+- `1.0.0` remains reserved for the point where MVP is fully validated and core product contracts are considered stable
diff --git a/CHANGELOG.zh-CN.md b/CHANGELOG.zh-CN.md
@@ -4,9 +4,9 @@
 
 格式参考 Keep a Changelog，并结合当前项目阶段做了简化调整。
 
-## [0.9.0] - 2026-05-13
+## [0.9.0] - 2026-05-20
 
-这是第一版结构化维护的预发布版本。FylloCode 已经从初始脚手架阶段进入可用于 MVP 验证的产品阶段，核心能力已经覆盖 proposal、task、chat、workflow 和 agent integration 等主要流程。
+这是首个稳定的 `0.9.0` 正式版。在最初 beta 基线之上，FylloCode 进一步补全了多 worktree 编排、session list 交互收敛、内置 specs workspace 能力，以及一组面向日常使用的体验与稳定性改进。
 
 ### 新增
 
@@ -17,22 +17,33 @@
 - 新 ACP session 的 system reminder 注入能力，包括持久化与前端过滤展示
 - 内置 `fyllo-specs` MCP server，支持 proposal、apply-change、archive-change 与 explore 工作流
 - Workflow 编辑能力与内置 workflow 模板
+- 多 worktree 基础能力，包括 chat orchestration、archive orchestration 与 proposal 列表的 worktree 扫描
+- 设置页 About 面板，支持在应用内查看当前版本信息
 
 ### 调整
 
 - Integration 能力重构为以 provider 连接和项目级资源挂载为中心的模型
 - Activity Bar、欢迎页流程与导航结构围绕当前产品布局做了收敛
 - ACP agent 进程生命周期与退出治理加强，提升桌面环境稳定性
 - 打包产物与 bundled resources 的路径处理进一步统一
+- 内置 `fyllo-specs` workspace 升级，以匹配最新项目工作流要求
+- Session list 交互进一步收敛为以 conversation-first 为中心的模型
+- Apply 与 Archive prompt 的 guardrails 收紧，`includeInstruction` 的处理更加明确
+- system reminder 模板资源迁移为独立文本文件，便于维护
+- 设置页导航宽度与聊天状态指示器样式做了细化调整
+- 仓库开始忽略 `.worktrees`，减少本地工作区噪音
 
 ### 修复
 
 - 打包后 unpacked MCP server 的路径解析问题
 - macOS ARM64 构建致命错误与 Fyllo 图标加载异常
 - Chat 与 Proposal 执行流之间的 streaming pipeline 一致性问题
 - reminder 持久化与 apply-change fixture 相关测试断言问题
+- `usage_update` 事件期间提交态被错误清空的问题
+- 创建新 session 时 chat 状态未正确重置的问题
+- 部分文档与测试 spec 不一致的问题
 
 ### 备注
 
-- `0.9.0` 标志着项目开始正式维护 changelog
+- 该版本汇总了 `0.9.0-beta.1` 到 `0.9.0-beta.3` 期间的全部已发布能力，作为首个稳定 `0.9.0` 正式版对外发布
 - `1.0.0` 将保留给 MVP 跑通且核心产品契约趋于稳定的阶段
diff --git a/README.md b/README.md
@@ -132,7 +132,7 @@ pnpm dev
 - [ ] Auto-update
 - [ ] i18n (English UI)
 - [ ] Auto build guidelines
-- [ ] Git linked workspace for task apply
+- [x] Git linked workspace for task apply
 - [ ] More ACP Agent control
 
 ## Built With

diff --git a/README.zh-CN.md b/README.zh-CN.md
@@ -131,7 +131,7 @@ pnpm dev
 - [ ] Auto-update
 - [ ] i18n (English UI)
 - [ ] Auto build guidelines
-- [ ] Git linked workspace for task apply
+- [x] Git linked workspace for task apply
 - [ ] More ACP Agent control
 
 ## 技术栈