All notable changes to this project are recorded in this file.
- Prepared the project for a public GitHub open-source release with a rewritten repository homepage README focused on discoverability.
- Added MIT licensing, contribution guidelines, security policy, code of conduct, and GitHub issue / PR templates.
- Added a repository preview image asset for the GitHub landing page.
- Verified
swift buildstill succeeds before public publishing.
- Fixed the center timeline auto-scroll so entering or switching into a conversation now lands on the newest content instead of staying at the top.
- Added delayed follow-up scroll passes after initial render and session switches to account for SwiftUI layout settling.
- Verified
swift buildsucceeds after the timeline auto-scroll fix.
- Migrated the center workspace to the chosen
Ops Timelinelayout so staged task progress now appears as balanced timeline cards instead of mixed chat/status blocks. - Rebuilt the right-side utility column around a dedicated
Agentdrawer and kept审阅/发布as secondary tabs, removing the temporary explanatory panel from the design. - Simplified the left sidebar again so it stays focused on task sessions instead of extra status copy.
- Finished the previously incomplete timeline migration by adding the missing timeline and agent-drawer support models/helpers.
- Verified
swift buildsucceeds after the UI migration.
- Added an explicit
新建对话flow so the app only creates a new session when you ask for one. - Changed the bottom send behavior to continue the currently selected conversation by default instead of opening a new task session for every message.
- Added a manual
停止任务control for running sessions, including pipeline cancellation and stopped-state updates in the UI. - Verified
swift buildsucceeds after the conversation-control and task-stop integration.
- Fixed the center conversation stream so it scrolls to the latest message after new output is laid out, instead of staying stuck at the top.
- Verified
swift buildsucceeds after the auto-scroll timing fix.
- Replaced the bottom
TextEditorwith a compact multiline input dock so the composer no longer expands into a large white panel. - Collapsed the write-mode control into a small menu to keep the entire bottom bar lighter and closer to the Codex app feel.
- Verified
swift buildsucceeds after the compact dock rewrite.
- Shrunk the bottom composer again so it behaves more like a compact Codex-style input dock.
- Added automatic scrolling in the center conversation stream so new orchestrator and agent updates stay pinned to the latest message.
- Reworked agent progress blocks into lighter message bubbles instead of nested log panels.
- Limited each agent bubble to the most recent streaming lines so the timeline stays readable while progress continues.
- Verified
swift buildsucceeds after the compact-composer and auto-scroll update.
- Reduced the bottom composer height so the input area no longer dominates the window.
- Reworked the center column into a streaming task conversation instead of showing plan, agent cards, and final result all at once.
- Added progressive center-stage output for the orchestrator, launched agents, per-agent live logs, and the final conclusion only after the flow reaches an end state.
- Verified
swift buildsucceeds after the streaming conversation refresh.
- Rebuilt the main window to follow a cleaner Codex App-style thread layout instead of a dashboard-heavy control surface.
- Reduced the left sidebar to a compact task-session list only and removed the extra history-dialog panel entirely.
- Moved the requirement, execution progress, active agents, and unified result output into the center conversation workspace.
- Simplified the right column into a tighter secondary tools area for review, logs, publish, and history.
- Verified
swift buildsucceeds after the Codex-style thread-layout refresh.
- Tightened the main window again to better match the requested Codex-style structure.
- Simplified the left column into compact history/session rows without showing detailed conversation content.
- Kept the unified result firmly in the center workspace and reduced competing explanatory UI.
- Reworked the right tools column so logs, review, publish, and history remain secondary and easier to scan.
- Verified
swift buildsucceeds after the Codex-style layout tightening.
- Reworked the main window into a workspace-first layout with conversation on the left, execution in the center, and secondary tools on the right.
- Replaced the previous card-heavy center panel with a clearer sequence: input, progress, active agents, and unified result output.
- Simplified the left column into a chat-style task conversation view instead of a dense control stack.
- Removed much of the explanatory microcopy so the interface reads more directly.
- Verified
swift buildsucceeds after the workspace-first UI simplification.
- Added a one-click re-review action that refreshes both review and publish inspection snapshots together.
- Added structured publish preflight checklist items for review readiness, reviewer completion, deliverable state, tracked changes, working-tree cleanliness, remote availability, and remote-action readiness.
- Recorded re-review triggers into session history so the inspection cycle stays auditable.
- Verified
swift buildsucceeds after the preflight-checklist and re-review integration.
- Added file-oriented review snapshots with per-file change metadata and diff previews.
- Upgraded the review tab into a compact file explorer so individual changed files can be selected and inspected.
- Added backward-compatible decoding defaults so older persisted sessions continue to load after the new review fields were introduced.
- Added commit-aware review extraction for automatic local commit mode instead of relying only on working-tree diffs.
- Verified
swift buildsucceeds after the file-review explorer upgrade.
- Added session lifecycle controls for pinning, archiving, restoring, and deleting local task sessions.
- Split the sidebar into pinned, active, and archived sections so long-running task history stays manageable.
- Added selected-session management buttons in the center header for faster pin/archive/delete access.
- Upgraded the review panel with last-refresh metadata, recovered-file chips, and horizontally scrollable code-style diff blocks.
- Verified
swift buildsucceeds after the session-lifecycle and review-workspace upgrade.
- Added JSON-backed session persistence so task sessions, review state, publish state, history, repository context, write mode, and draft input survive app relaunches.
- Added debounced state saving during runtime plus an immediate flush on app termination.
- Refreshed the main SwiftUI shell with calmer proportions, denser cards, adaptive agent layout, and more cohesive three-column panel styling.
- Reduced the default and minimum window sizes so the app no longer launches feeling oversized and unbalanced.
- Verified
swift buildsucceeds after the persistence and UI refresh integration.
- Added a dedicated
历史inspector tab for viewing the task lifecycle as a structured timeline. - Added session history entries for task creation, planning completion/fallback, write-gate outcomes, writer completion, recovery, local commits, pushes, and draft PR actions.
- Added history export support so the lifecycle timeline can be copied independently from logs, review, and publish state.
- Rendered history entries as timestamped cards with category chips for faster scanning.
- Verified
swift buildsucceeds after the session-history panel integration.
- Added explicit GitHub confirmation actions to the publish panel for pushing the current branch and creating a draft PR.
- Added UI confirmation prompts so no remote action runs until the user explicitly confirms it in the app.
- Added publish capability flags, preferred-remote detection, and action-result reporting in the publish snapshot.
- Added support for first-push upstream setup and draft PR creation through
gh pr create --draft. - Preserved the remote safety boundary: push and PR creation are now possible, but only after explicit in-app confirmation.
- Verified
swift buildsucceeds after the GitHub confirm-action integration.
- Added a new
发布inspector tab for local publish readiness and GitHub gate visibility. - Added structured publish snapshots covering current branch, upstream branch, ahead/behind counts, remote listings, blockers, and recent commits.
- Added publish refresh and copy actions so release-readiness data can be inspected independently from logs and diffs.
- Automatically refreshes publish gate data when switching to a session with repository context.
- Kept all GitHub actions gated: the app still does not push or publish without explicit user confirmation.
- Verified
swift buildsucceeds after the publish-gate panel integration.
- Upgraded the right-side inspector into a two-tab review workspace with separate
审阅and日志views. - Added refreshable diff and commit inspection sourced from either the writer worktree or the recovered task branch, depending on the write mode.
- Added structured review snapshots with Git status, diff statistics, diff excerpts, and local commit summaries.
- Added review copy support so the current diff / commit audit can be copied independently from the raw logs.
- Automatically refreshes review data when a session with recovered write results is selected.
- Verified
swift buildsucceeds after the inspector review-panel integration.
- Added a real write-result recovery layer after single-writer execution.
- Conservative mode now leaves changes only inside the isolated writer worktree.
- Semi-automatic mode now applies the writer diff back onto the task branch without creating a commit.
- Automatic local commit mode now applies the writer diff back onto the task branch and creates a local Git commit.
- Added session-level recovery details including task branch, writer branch, recovered files, recovery summary, and local commit hash.
- Expanded the UI to show recovery metadata in the main plan area, sidebar session cards, and inspector panel.
- Verified
swift buildsucceeds after the write recovery and local commit integration.
- Added three write execution modes in the task composer: conservative write, semi-automatic write, and automatic local Git write.
- Added an automatic write gate after read-only specialist analysis, with orchestrator-driven pass/fail logic and at most one rework retry.
- Added a single-writer execution path that prepares an isolated Git worktree and runs one selected specialist with
workspace-write. - Expanded the UI to surface write mode, gate status, rework count, selected writer, and worktree path across the main plan view and inspector.
- Hardened worktree setup by cleaning stale worktree paths before launching a new writer run.
- Verified
swift buildsucceeds after the gated single-writer integration.
- Added explicit log copy actions in the inspector for both the whole session and the currently viewed agent.
- Added inspector-side agent filtering so logs can be viewed by role instead of only as one long stream.
- Added structured log export formatting from app state for cleaner clipboard output.
- Verified
swift buildsucceeds after the log-copy inspector update.
- Added a real read-only specialist execution stage after orchestrator planning.
- Added a generic specialist Codex CLI runner with structured JSON decoding for summaries, key points, risks, and next steps.
- Automatically dispatches non-reviewer specialists after planning, then runs a reviewer handoff based on specialist outputs.
- Expanded the UI to show execution counts, per-agent findings, and risk summaries.
- Shared the non-ASCII path aliasing support between planner and specialist execution.
- Verified
swift buildsucceeds after the multi-agent read-only execution integration. - Manually validated that a read-only specialist prompt can run through
codex exec --jsonusing an ASCII alias path.
- Integrated a live
codex exec --jsonplanning pipeline for the orchestrator stage. - Added structured plan decoding for title, summary, plan steps, dynamic roles, and score summary output.
- Reworked task creation so the app now seeds a live session first, then applies the real Codex planning result asynchronously.
- Added a Chinese-path compatibility layer that runs Codex through an ASCII temporary alias when the repository path contains non-ASCII characters.
- Improved the inspector and center panel to show planning source, orchestrator progress, and live planning summaries.
- Verified
swift buildsucceeds after the planner integration. - Manually validated that running Codex through an ASCII alias avoids the earlier workspace header encoding failure seen on non-ASCII repository paths.
- Added the first runnable Swift Package macOS application shell for
CodexOpsStudio. - Built a native main-window desktop UI with a Codex App-inspired three-column layout.
- Set Simplified Chinese as the default application language and first-run copy baseline.
- Added repository picking, task session scaffolding, orchestrator plan cards, agent status cards, and inspector panels.
- Added initial state-transition test coverage drafts for task creation and role inference.
- Verified
swift buildsucceeds with Command Line Tools;swift testis currently blocked because the machine does not have full Xcode / XCTest available.
- Initialized the
CodexOpsStudioproject workspace. - Added the system design for a native macOS multi-agent Codex CLI development console.
- Added ADRs for the native Swift desktop shell, dynamic agent orchestration, and single-repository worktree execution.
- Set Simplified Chinese as the default UI language in the product baseline.