agentty 0.1.13 → 0.2.0

package/CHANGELOG.md

@@ -5,9 +5,100 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [v0.2.0] - 2026-02-22
+
+### Added
+
+- **Plan:** Add iterative plan question flow with per-question answer options.
+- **Sync:** Run branch sync in background with loading popup and outcome display.
+- **Sync:** Add session branch sync action with sync-blocked popup.
+- **Sync:** Add assisted conflict resolution for sync main rebase.
+- **Stats:** Add Codex usage limits to stats dashboard.
+- **Stats:** Persist session-creation activity and render by local day.
+- **Stats:** Persist and display all-time model usage and longest session duration.
+- **Help:** Help system uses state-aware action projection.
+- **Dev Server:** Add editable Dev Server setting and run when opening session tmux window.
+- **UX:** Add `h`/`l` shortcuts for confirmation selection.
+
+### Changed
+
+- **Architecture:** Refactor agent infrastructure into provider modules.
+- **Architecture:** Split git infrastructure and UI utilities into focused modules.
+- **Architecture:** Inject `GitClient` into app workflows and isolate multi-command git tests.
+- **Refactor:** Move file indexing into infra module and parse using `pulldown-cmark`.
+- **Refactor:** Rename state, file, and mode modules for clarity.
+- **Refactor:** Move module roots from `mod.rs` to sibling files.
+- **Sync:** Add project and branch context to sync popups.
+- **Sync:** Sync main branch by pushing after rebase.
+- **Plan:** Improve plan follow-ups and Codex stats limit rendering.
+- **UX:** Use shared confirmation mode for quit and session deletion.
+- **UX:** Confirmation prompts default to "No" selection.
+- **UX:** Hide open-worktree shortcut for done sessions and restrict view actions while running.
+- **Commit:** Preserve a single evolving session commit.
+- **Search:** Prioritize basename matches in file list fuzzy scoring.
+
+### Fixed
+
+- **Codex:** Fix app-server error status recovery and wait for responses before parsing limits.
+- **Stability:** Fix launch and lint regressions after rebase.
+- **UI:** Deduplicate list background rendering and reset grouped session table offset.
+
+### Removed
+
+- **Refactor:** Remove orphaned top-level source files from `src/`.
+- **Refactor:** Remove `pr-testing` directory references.
+
+### Contributors
+
+- @andagaev
+- @minev-dev
+
+## [v0.1.14] - 2026-02-21
+
+### Added
+
+- **Stats:** Add activity heatmap to the Stats tab.
+- **Stats:** Track per-model session usage and render usage summaries.
+- **Settings:** Add settings tab and persist default model.
+- **Diff View:** Split diff view into file list and content panels with file explorer navigation.
+- **Diff View:** Render changed files as a tree in the file explorer.
+- **Diff View:** Filter diff view content by selected file explorer item.
+- **Site:** Add agentty.xyz documentation site with GitHub Pages deployment workflow.
+
+### Changed
+
+- **Architecture:** Refactor codebase into domain, infrastructure, and UI state modules.
+- **Architecture:** Move tab state into a dedicated tab manager.
+- **Session List:** Group sessions by merge queue and separate archived sessions with placeholders.
+- **Session List:** Align session navigation with grouped list order.
+- **Session Output:** Render session output and user prompt blocks as markdown.
+- **Session Output:** Preserve multiline user prompt block spacing and verbatim rendering.
+- **Merge Queue:** Queue session merges in FIFO order and handle queued sessions across app and UI.
+- **Merge Queue:** Advance merge queue progression and retry on git index lock failures.
+- **Merge:** Treat already-applied squash merges as successful.
+- **Rebase:** Harden rebase assist loop against partially resolved conflicts.
+- **Output:** Task service batches streamed output before flushing.
+- **Output:** Separate streamed response messages for Codex output spacing.
+- **Models:** Load default session model from persisted setting.
+- **Models:** Use npm semver for version checks and restore version display in status bar.
+- **Prompt:** Handle multiline paste and control-key newlines in prompt input.
+- **Site:** Redesign landing page with dark terminal theme, Tailwind CSS v4, and theme selector.
+- **Deps:** Bump dependency versions.
+
+### Fixed
+
+- **Build:** Fix refactor regressions and restore build stability after module restructure.
+
+### Contributors
+
+- @andagaev
+- @dependabot[bot]
+- @minev-dev
+
 ## [v0.1.13] - 2026-02-19
 
 ### Added
+
 - **Session Output:** Render styled markdown in session chat output.
 - **Session Output:** Switch to stream-json output and parse Gemini stream events.
 - **Session Output:** Extract session output into dedicated UI component.
@@ -16,6 +107,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Models:** Add verbose flag to Claude stream-json commands.
 
 ### Changed
+
 - **Session Metadata:** Move session status to output panel title and metadata to chat input border.
 - **Session Titles:** Persist session title and summary from squash commit message.
 - **Session Titles:** Use full prompt as session title for new sessions.
@@ -27,21 +119,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **NPM:** Update package name to `agentty` in docs and badges.
 
 ### Fixed
+
 - **UI:** Fix session list table column layout constraints.
 - **Runtime:** Add shutdown signal to event reader thread for cleaner exit.
 
 ### Contributors
+
 - @andagaev
 - @minev-dev
 
 ## [v0.1.12] - 2026-02-19
 
 ### Added
+
 - **Session UX:** Added a delete confirmation mode with selectable actions for session deletion.
 - **Output Streaming:** Added a live single-line progress indicator in chat and spacing before the first streamed response chunk.
 - **Agent Runtime:** Added Codex output streaming during non-interactive runs and follow-up actions for plan mode replies.
 
 ### Changed
+
 - **Git Runtime:** Completed async `git` module transition to `spawn_blocking` and updated call sites.
 - **Session Model:** Refactored sessions to derive `AgentKind` from `AgentModel`, removed the session `agent` column, and migrated legacy PR statuses to `Review`.
 - **Merge/Rebase:** Improved merge and rebase robustness by auto-committing pending changes before merge/rebase and broadening auto-commit assistance handling.
@@ -50,16 +146,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Config:** Removed `npm-scope` from `dist-workspace.toml`.
 
 ### Removed
+
 - **Pull Requests:** Removed pull request functionality.
 - **UI Cleanup:** Removed delete confirmation bottom hints.
 
 ### Contributors
+
 - @andagaev
 - @minev-dev
 
 ## [v0.1.11] - 2026-02-16
 
 ### Added
+
 - **Permissions:** Add per-session permission mode toggle and `Plan` permission mode with denial-gated response parsing.
 - **Session Control:** Add `Ctrl+c` to stop running agent sessions.
 - **Prompt History:** Implement prompt history navigation with up/down arrows.
@@ -70,6 +169,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Terminal Summaries:** Persist terminal summaries for session outcomes.
 
 ### Changed
+
 - **Architecture:** Refactor app into manager composition with event-driven session state updates and reducer-based routing for git status, PR control, and session mutations.
 - **Architecture:** Split session module and centralize lookups; separate session snapshots from runtime handles.
 - **Session Defaults:** New sessions inherit the latest session's agent, model, and permission mode.
@@ -82,20 +182,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Docs:** Document app module architecture and public API docs; add cargo install instructions to README.
 
 ### Removed
+
 - **Health Module:** Remove health check module and wiring.
 
 ### Contributors
+
 - @andagaev
 - @minev-dev
 
 ## [v0.1.10] - 2026-02-15
 
 ### Added
+
 - **Review Workflow:** Added an explicit `Merging` session status and a review-session rebase action.
 - **Session UX:** Added read-only controls for done sessions and a `/clear` slash command.
 - **Help UI:** Added a `?` keybinding with an updated overlay and descriptive slash-command menu.
 
 ### Changed
+
 - **Session List:** Split session metadata into `Project`, `Model`, and `Status` columns with dynamic width sizing.
 - **Runtime:** Run session commands through per-session workers and restore interrupted sessions into `Review`.
 - **Stats:** Accumulate token usage over time and preserve stats after `/clear`.
@@ -103,6 +207,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **UI Cleanup:** Removed agent labels from session list rows and session chat titles.
 
 ### Contributors
+
 - @andagaev
 - @dependabot[bot]
 - @minev-dev
@@ -110,55 +215,66 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [v0.1.9] - 2026-02-13
 
 ### Added
+
 - **Diff View:** Added diff content wrapping to render long changed lines without truncation.
 - **Diff View:** Added structured parsing with line-number gutters (`old│new`) for unified diffs.
 - **Docs:** Added a demo GIF to the README and documented GIF generation with VHS.
 
 ### Changed
+
 - **Diff View:** Compare against each session's base branch so review shows all accumulated changes.
 - **Workflow:** Simplified commit flow by auto-committing after agent iterations and removing manual commit mode.
 - **Release Docs:** Added contributor-list requirements and examples to the release workflow documentation.
 
 ### Contributors
+
 - @minev-dev
 
 ## [v0.1.8] - 2026-02-13
 
 ### Added
+
 - **Onboarding:** Added a full-screen onboarding page shown when no sessions exist.
 - **Tests:** Added onboarding behavior coverage for app state, list mode `Enter` handling, and UI rendering conditions.
 
 ### Changed
+
 - **UX:** Pressing `Enter` from the onboarding view now creates a new session and opens prompt mode directly.
 - **Error Handling:** Session creation errors in list mode are now surfaced instead of being silently ignored.
 - **UI:** Kept the footer visible during onboarding and simplified session list rendering to consistently use the table layout.
 
 ### Contributors
+
 - @minev-dev
 
 ## [v0.1.7] - 2026-02-12
 
 ### Added
+
 - **UI:** Show session worktree path and branch in the footer bar for better context awareness.
 - **UI:** Display commit count in the session chat title.
 - **Stats:** Add session token usage statistics to the Stats page.
 
 ### Changed
+
 - **Persistence:** Moved application data directory from `/var/tmp/.agentty` to `~/.agentty` for better persistence and standard compliance.
 - **UX:** Renamed "Roadmap" tab to "Stats" to better reflect its content.
 - **UX:** Use shortened 8-character UUIDs for session folders and git branches to reduce clutter.
 - **Internal:** Standardized session ID variable naming across the codebase.
 
 ### Contributors
+
 - @andagaev
 - @minev-dev
 
 ## [v0.1.6] - 2026-02-10
 
 ### Added
+
 - **Session Status:** Added a `Committing` status to make commit progress explicit in the session lifecycle.
 
 ### Changed
+
 - **Persistence:** Persist session prompt/output history in SQLite and load it on startup so chat history survives app reloads.
 - **Session Output:** Parse agent JSON output and display only the response message in session output.
 - **GitHub Integration:** Parse GitHub PR responses using typed serde structs and move GitHub CLI logic into a dedicated `gh` module.
@@ -167,21 +283,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Documentation:** Extract git commit guidance into the shared skills documentation.
 
 ### Fixed
+
 - **Tests:** Stabilized merge cleanup testing to avoid environment-dependent blocking during release verification.
 
 ### Contributors
+
 - @andagaev
 - @minev-dev
 
 ## [v0.1.5] - 2026-02-08
 
 ### Added
+
 - **Tests:** Added runtime mode handler coverage tests.
 - **Documentation:** Added local `AGENTS.md` files and enforced folder index checks.
 - **Documentation:** Added Context7-first rule for retrieving latest tool info.
 - **Documentation:** Documented dependency injection testability guidance.
 
 ### Changed
+
 - **Architecture:** Modularized app and runtime into focused modules (`app/` and `runtime/`).
 - **Runtime:** Injected event source into the runtime event loop for better testability.
 - **Session:** Made agent and model configurations session-scoped.
@@ -190,17 +310,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Refactor:** Refactored long handlers to enforce clippy line limits.
 
 ### Contributors
+
 - @minev-dev
 
 ## [v0.1.4] - 2026-02-08
 
 ### Added
+
 - **Session Identity:** Migrated session IDs to UUIDs for stable identification.
 - **Session Management:** Added a forward-only migration system for schema changes.
 - **UI:** Added nullable title support to sessions.
 - **UI:** Improved chat input with indentation preservation on wrapped lines.
 
 ### Changed
+
 - **Session Ordering:** Sessions are now strictly ordered by `updated_at` (latest first).
 - **Performance:** Implemented incremental session state refresh to reduce database load.
 - **UX:** Moved prompt cursor by visual wrapped lines for better navigation.
@@ -210,24 +333,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Database:** Use multiline SQL strings for better query readability.
 
 ### Removed
+
 - Removed project-filtered session loader.
 - Removed git worktree suffix from initial session prompt.
 - Removed Reply mode; unified into session chat page.
 
 ### Contributors
+
 - @minev-dev
 
 ## [v0.1.3] - 2026-02-08
 
 ### Added
+
 - **Backends:** Added Codex backend support.
 - **Project Management:** Added project switching with automatic sibling discovery.
 - **Diff View:** Show all file changes in diff view.
 - **Status:** Show status as text in session list and chat title.
 - **Health:** Added version normalization for agent checks.
-- **Testing:** Added `pr-testing` directory to root index.
 
 ### Changed
+
 - **Concurrency:** Converted event loop to async to fix TUI freezing on macOS.
 - **Input:** Improved multiline input editing.
 - **Workflow:** Enforced review-based session status transitions.
@@ -236,16 +362,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Formatting:** Added code formatting rules and applied to `ag-xtask`.
 
 ### Fixed
+
 - Fixed UI freezing on macOS during agent execution.
 - Clarified git worktree requirements in README.
 
 ### Contributors
+
 - @andagaev
 - @minev-dev
 
 ## [v0.1.2] - 2026-02-08
 
 ### Added
+
 - **GitHub Integration:** Added 'p' command to create GitHub Pull Requests (draft by default).
 - **GitHub Integration:** Added GitHub CLI health check with nested auth sub-check.
 - **UI:** Centralized icons into a reusable `Icon` enum.
@@ -253,6 +382,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Database:** Persist session status to the database.
 
 ### Changed
+
 - **UX:** Use `/` selector in command palette dropdowns.
 - **UX:** Ensure exactly one blank line before the spinner in chat view.
 - **Health:** Rename Claude health check label to Claude Code.
@@ -260,14 +390,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Internal:** Optimize quality gates for AI agents.
 
 ### Removed
+
 - Remove custom Gemini configuration creation.
 
 ### Contributors
+
 - @minev-dev
 
 ## [v0.1.1] - 2026-02-08
 
 ### Added
+
 - **Database:** Introduce SQLite via SQLx for session metadata.
 - **UI:** Add command palette with agents selection.
 - **UI:** Add health check splash screen via `/health` command.
@@ -275,12 +408,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Docs:** Add installation guide to README.
 
 ### Changed
+
 - **Async:** Convert sync DB wrapper and thread spawns to native async.
 - **Tooling:** Replace `cargo-machete` with `cargo-shear` in quality gates.
 - **UI:** Use tilde for home directory in footer.
 - **Internal:** Reorder struct fields by visibility and name.
 
 ### Contributors
+
 - @andagaev
 - @minev-dev
 
@@ -289,6 +424,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Initial release.
 
 ### Contributors
+
 - @andagaev
 - @dependabot[bot]
 - @minev-dev

package/README.md

@@ -4,7 +4,7 @@
 
 A terminal UI tool for managing agents, built with Rust and [Ratatui](https://ratatui.rs).
 
-![Demo](/docs/demo/demo.gif)
+![Demo](/docs/assets/demo/demo.gif)
 
 ## Installation
 
@@ -61,10 +61,21 @@ selection becomes the default for newly created sessions.
 - After a plan response in chat view, an inline action bar appears:
   - `Implement the plan`: switches that session to `auto_edit` and sends an implementation prompt.
   - `Type feedback`: opens prompt input so you can send feedback while keeping `plan` mode.
-  - Use `Left` / `Right` arrows to choose and `Enter` to confirm.
+  - Use `Up` / `Down` arrows to choose and `Enter` to confirm.
 - The active mode is shown in the session chat title.
 - Changes are persisted for that session and used as defaults for future sessions.
 
+## Codex Sessions
+
+- Codex sessions run through a persistent per-session `codex app-server` connection.
+- Each Agentty session keeps one Codex thread open across replies.
+- If the app-server connection fails, Agentty retries by restarting Codex app-server with a new thread.
+- When a Codex thread is reset, Agentty replays the session transcript in the next turn prompt so implementation can continue with prior context.
+- Codex session modes map to app-server permissions:
+  - `plan`: `approvalPolicy=on-request` and read-only sandbox. Pre-action file/command requests are declined.
+  - `auto_edit`: `approvalPolicy=on-request` and workspace-write sandbox. Pre-action file/command requests are accepted.
+  - `autonomous`: `approvalPolicy=never` and danger-full-access sandbox. If a pre-action request still appears, it is accepted for the session.
+
 ## Features
 
 ### Git Worktree Integration
@@ -75,6 +86,9 @@ Agentty creates isolated worktrees for each session:
 - **Separate Working Directory:** Sessions work in isolated directories under `~/.agentty/wt/`
 - **Diff View:** Press `d` in the chat view to see real-time changes made by the agent
 - **Rebase Action:** Press `r` in the chat view to rebase the session branch onto its base branch
+- **Sync Action:** Press `s` in the session list to run session sync (`pull --rebase` + `push`) for review sessions
+  - Sync is available only when the active project branch is `main`
+  - Sync is blocked until `main` has no uncommitted changes
 - **Automatic Cleanup:** Worktrees and branches are automatically removed when sessions are deleted
 
 This allows agents to work on code changes without affecting your main working directory.
@@ -85,10 +99,18 @@ This allows agents to work on code changes without affecting your main working d
 - Supported formatting includes headings, bold/italic text, inline code, fenced code blocks, lists, blockquotes, and horizontal rules.
 - User prompt lines (` › ...`) remain visually distinct in cyan bold styling.
 
+### Stats Activity Heatmap
+
+- The `Stats` tab now includes a GitHub-style activity heatmap for persisted session-creation activity over the last 53 weeks.
+- Heatmap history is retained even after deleting old sessions.
+- Heatmap intensity scales with daily session counts and now includes month labels for easier timeline scanning.
+- A right-side summary panel highlights favorite model usage, the longest session duration, and per-model input/output token totals.
+- The per-session token table and overall totals remain available below the heatmap.
+
 ### Version Update Notice
 
-- On startup, Agentty checks for the latest stable release tag from GitHub.
-- If a newer version exists, an inline `New version vX.Y.Z available` notice is shown:
+- On startup, Agentty checks npmjs for the latest `agentty` version.
+- If a newer version exists, an inline `vX.Y.Z version available update with npm i -g agentty@latest` notice is shown:
   - in the top status bar next to the current version
   - on the onboarding screen when there are no sessions
 
@@ -100,6 +122,18 @@ cd agentty
 cargo run # Builds and runs the 'agentty' binary
 ```
 
+## Website
+
+`agentty.xyz` is a Zola site stored in `docs/site/` and deployed through GitHub Pages.
+
+```sh
+# Preview locally
+zola serve --root docs/site
+
+# Build static output
+zola build --root docs/site
+```
+
 ## Development
 
 ```sh

package/npm-shrinkwrap.json

@@ -23,7 +23,7 @@
       "hasInstallScript": true,
       "license": "Apache-2.0",
       "name": "agentty",
-      "version": "0.1.13"
+      "version": "0.2.0"
     },
     "node_modules/@isaacs/balanced-match": {
       "engines": {
@@ -515,5 +515,5 @@
     }
   },
   "requires": true,
-  "version": "0.1.13"
+  "version": "0.2.0"
 }

package/package.json

@@ -1,5 +1,5 @@
 {
-  "artifactDownloadUrl": "https://github.com/opencloudtool/agentty/releases/download/v0.1.13",
+  "artifactDownloadUrl": "https://github.com/opencloudtool/agentty/releases/download/v0.2.0",
   "author": "Vladimir Minev",
   "bin": {
     "agentty": "run-agentty.js"
@@ -63,7 +63,7 @@
       "zipExt": ".tar.xz"
     }
   },
-  "version": "0.1.13",
+  "version": "0.2.0",
   "volta": {
     "node": "18.14.1",
     "npm": "9.5.0"