tasktree-manager 2.13.1__tar.gz → 2.13.3__tar.gz

{tasktree_manager-2.13.1 → tasktree_manager-2.13.3}/.github/workflows/release.yml

@@ -14,6 +14,9 @@
 #   - Manual dispatch: choose release type, pre-release, and draft options.
 #     Both `draft` and `pre_release` skip the PyPI upload (the pipeline can
 #     only produce final X.Y.Z versions) and only shape the GitHub release.
+#     workflow_dispatch can target ANY branch, not just main (branch
+#     protection also has enforce_admins=false), so prepare-release and
+#     tag-release both refuse to run off main — see their `if:` guards.
 
 name: Release
 
@@ -46,6 +49,12 @@ on:
 jobs:
   prepare-release:
     name: Prepare Release
+    # workflow_dispatch can target any branch; the push trigger is already
+    # restricted to main via `on.push.branches`, so this only closes the
+    # workflow_dispatch path. Everything downstream (lint/test/tag-release/
+    # build/publish-pypi) needs this job and is skipped by cascade when it
+    # is; github-release guards itself separately via needs.build.result.
+    if: github.ref == 'refs/heads/main'
     runs-on: ubuntu-latest
     outputs:
       new_version: ${{ steps.determine_version.outputs.new_version }}
@@ -174,6 +183,10 @@ jobs:
   tag-release:
     name: Commit and Tag
     needs: [prepare-release, lint, test]
+    # Belt and suspenders: this is the job that pushes to main and pushes
+    # the tag using the owner PAT, so it gets its own explicit ref guard
+    # rather than relying only on the cascade from prepare-release.
+    if: github.ref == 'refs/heads/main'
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code
@@ -206,8 +219,10 @@ jobs:
           git diff --cached --quiet && echo "No changes to commit" || \
             git commit -m "chore(release): ${new_version} [skip ci]"
           git tag -a "v${new_version}" -m "Release v${new_version}"
-          git push origin HEAD:main
-          git push origin "v${new_version}"
+          # Atomic: one push carrying both refs, so a rejected tag (already
+          # exists, race with another push) can never leave main bumped
+          # without the tag that's supposed to go with it.
+          git push --atomic origin HEAD:main "v${new_version}"
 
   build:
     name: Build Package

{tasktree_manager-2.13.1 → tasktree_manager-2.13.3}/.gitignore

@@ -49,11 +49,10 @@ Thumbs.db
 
 # Project specific
 *.log
-tasktree/_version.py
+tasktree_manager/_version.py
 
 # Documentation (tracked separately)
 PRD.md
-specs/
 CLAUDE.md
 
 # uv project-mode lockfile — tooling installs via `uv pip`/pip from pyproject.toml,

{tasktree_manager-2.13.1 → tasktree_manager-2.13.3}/CHANGELOG.md

@@ -15,6 +15,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Git hooks support
 - Custom task metadata
 
+## [2.13.3] - 2026-10-16
+
+### Changed
+- Remove unused specs and refresh the README roadmap
+
+### Fixed
+- **archive**: Keep task-folder files when a task is finished
+
+
+## [2.13.2] - 2026-09-28
+
+### Changed
+- Document list error state, config value types and task name rules
+- **release**: Release only from main and push main and tag atomically
+
+### Fixed
+- **tui**: Harden workers, refresh and selection handling
+- **cli**: Report status errors, setup failures and missing git correctly
+- **claude**: Resolve symlinked paths and write settings atomically
+- **config**: Validate booleans and section tables in config.toml
+- **git**: Count partially staged files as staged and modified
+- **tasks**: Protect existing branches and unchecked worktrees on create/delete
+
+
 ## [2.13.1] - 2026-09-16
 
 ### Fixed

{tasktree_manager-2.13.1 → tasktree_manager-2.13.3}/CONTRIBUTING.md

@@ -18,7 +18,7 @@ Be respectful, inclusive, and constructive. We're all here to build something us
 
 1. **Fork and clone**
    ```bash
-   git clone https://github.com/yourusername/tasktree-manager.git
+   git clone https://github.com/ruslanfialkovskii/tasktree-manager.git
    cd tasktree-manager
    ```
 
@@ -149,7 +149,7 @@ def create_task(name: str, repos: list[str]) -> Task:
 - Add docstrings to all public functions/classes
 - Use Google-style docstrings
 - Update README.md for user-facing changes
-- Update OPENSPEC.md for architecture changes
+- Update the Architecture section of CLAUDE.md for architecture changes
 
 Example docstring:
 ```python
@@ -206,18 +206,15 @@ tasktree-manager/
 │   ├── themes/         # Color themes
 │   └── app.py          # Main app
 ├── tests/              # Test suite
-├── specs/              # Technical specs
 └── docs/               # Documentation
 ```
 
 ### Adding New Features
 
-1. **Check specs**: Review existing specs in `specs/`
-2. **Create spec**: Write a new spec (SPEC-XXX) if needed
-3. **Write tests**: Add tests first (TDD approach)
-4. **Implement**: Write the code
-5. **Document**: Update README/specs
-6. **PR**: Submit for review
+1. **Write tests**: Add tests first (TDD approach)
+2. **Implement**: Write the code
+3. **Document**: Update README.md and `docs/`
+4. **PR**: Submit for review
 
 ## Submitting Issues
 
@@ -260,7 +257,7 @@ Include:
 
 ## Questions?
 
-- Open a [Discussion](https://github.com/yourusername/tasktree-manager/discussions)
+- Open a [Discussion](https://github.com/ruslanfialkovskii/tasktree-manager/discussions)
 - Ask in Pull Request
 - Check existing issues
 

{tasktree_manager-2.13.1 → tasktree_manager-2.13.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: tasktree-manager
-Version: 2.13.1
+Version: 2.13.3
 Summary: TUI application for managing worktree-based tasks
 License-File: LICENSE
 Requires-Python: >=3.10

{tasktree_manager-2.13.1 → tasktree_manager-2.13.3}/README.md

@@ -4,7 +4,7 @@
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
-[![Tests](https://img.shields.io/badge/tests-228%20passed-green.svg)](./tests/)
+[![Tests](https://img.shields.io/badge/tests-pytest-green.svg)](./tests/)
 
 **tasktree-manager** is a terminal user interface (TUI) application for managing development tasks that span multiple git repositories. Create tasks, organize worktrees, and track status across your entire codebase—all from a beautiful, keyboard-driven interface inspired by [lazygit](https://github.com/jesseduffield/lazygit).
 
@@ -22,7 +22,7 @@
 - 🛰️ **Agent Dashboard** - Live Claude Code session state per worktree (from `claude agents`), plus one-key background-agent dispatch — the multi-repo agent view Claude Code lacks natively
 - ✻ **Session Recap** - The Info panel shows each task's latest Claude Code session: title, last turn duration, and Claude's own idle recap of what was done and what comes next — read straight from the transcript, no CLI call
 - 🔀 **Forge-Aware Safety** - MR/PR and CI state via `glab`/`gh`; squash- and rebase-merged branches count as merged instead of blocking deletion forever
-- 📦 **Finish Flow with Archives** - Ending a task saves its combined diff (committed-but-unmerged + uncommitted) to an archive before deleting
+- 📦 **Finish Flow with Archives** - Ending a task saves its combined diff (committed-but-unmerged + uncommitted) and the task-folder files outside the worktrees (plans, ADRs, notes) to an archive before deleting
 
 ## 📊 Status Indicators
 
@@ -78,17 +78,27 @@ workflows (e.g. a skill that creates a Jira ticket and then the matching task):
 
 ```bash
 tasktree-manager create DIC-1901-argocd-tls --repos backend,frontend  # --base overrides the default base branch
-tasktree-manager list --json     # tasks with repos and dirty state (plain text without --json)
+tasktree-manager list --json     # tasks with repos and state: clean / dirty / error (plain text without --json)
 tasktree-manager repos           # available repos in REPOS_DIR
 tasktree-manager add-repo DIC-1901-argocd-tls infra
 tasktree-manager status                       # current task inferred from $PWD; also --json / --oneline / --forge
-tasktree-manager finish DIC-1901-argocd-tls   # safety sweep -> archive diff -> delete; --push / --no-archive / --force
-tasktree-manager delete DIC-1901-argocd-tls   # archive diff -> delete; refuses on unfinished work; --force overrides
+tasktree-manager finish DIC-1901-argocd-tls   # safety sweep -> archive diff + task files -> delete; --push / --no-archive / --force
+tasktree-manager delete DIC-1901-argocd-tls   # archive diff + task files -> delete; refuses on unfinished work; --force overrides
 ```
 
 Exit code is 0 on success, 1 on failure with the reason on stderr. `delete` and `finish` run
 the same safety check as the TUI (uncommitted, unpushed, or unmerged work blocks deletion);
-with `glab`/`gh` installed, squash/rebase-merged branches are recognized as merged.
+with `glab`/`gh` installed, squash/rebase-merged branches are recognized as merged. If the
+diff cannot be archived for any repo, the CLI stops before deleting and prints the path of
+the partial archive; the TUI warns and deletes anyway. Files in the task folder outside the
+worktrees are copied to `<task>-<timestamp>.files/` next to the patch:
+
+- Skipped silently: hidden files, symlinks, `node_modules`/`vendor`/`.terraform` folders and
+  an unedited generated `CLAUDE.md`.
+- Left out with a warning: key material (`*.pem`, `*.key`, `id_rsa`, kubeconfigs,
+  `*.tfstate`, `credentials*.json`), files over 10 MB and files past 100 MB in total.
+- A file that cannot be read or copied stops `delete`/`finish` before anything is removed,
+  unless `--force`; the TUI warns and deletes anyway.
 `status --oneline` emits a compact `TASK repoA✓ repoB●2↑1` summary that slots straight into
 a Claude Code statusline or shell prompt.
 
@@ -145,7 +155,7 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed development setup and guidel
 
 **Quick Start:**
 ```bash
-git clone https://github.com/yourusername/tasktree-manager.git
+git clone https://github.com/ruslanfialkovskii/tasktree-manager.git
 cd tasktree-manager
 mise install
 mise run install
@@ -195,14 +205,13 @@ For comprehensive troubleshooting, see the [Troubleshooting Guide](docs/troubles
 
 Recently shipped: agent dashboard (per-worktree Claude session badges + background dispatch),
 forge-aware merged detection (glab/gh, squash/rebase merges), MR/CI status badges,
-guided `finish` flow with diff archiving, `status` subcommand for scripts and statuslines.
+guided `finish` flow that archives the diff and the task-folder files, `status` subcommand
+for scripts and statuslines, Claude session recap in the Info panel.
 
-Upcoming:
-- **v0.3.0** - Search/filter, task templates
-- **v0.4.0** - JIRA status column, git hooks, automation
-- **v1.0.0** - Stable release
+Next: epics, a layer that groups related tasks (for example a Jira epic and its child
+tasks) in the task list.
 
-See [ROADMAP.md](ROADMAP.md) and [CHANGELOG.md](CHANGELOG.md) for details.
+See [CHANGELOG.md](CHANGELOG.md) for the release history.
 
 ## 📄 License
 
@@ -216,11 +225,11 @@ MIT License - see [LICENSE](./LICENSE) for details.
 
 ## 💬 Support & Community
 
-- 🐛 [Bug Reports](https://github.com/yourusername/tasktree-manager/issues)
-- 💡 [Feature Requests](https://github.com/yourusername/tasktree-manager/issues)
-- 💬 [Discussions](https://github.com/yourusername/tasktree-manager/discussions)
+- 🐛 [Bug Reports](https://github.com/ruslanfialkovskii/tasktree-manager/issues)
+- 💡 [Feature Requests](https://github.com/ruslanfialkovskii/tasktree-manager/issues)
+- 💬 [Discussions](https://github.com/ruslanfialkovskii/tasktree-manager/discussions)
 - 📖 [Documentation](docs/)
 
 ---
 
-**Made with ❤️ by developers, for developers** | [⭐ Star this repo](https://github.com/yourusername/tasktree-manager)
+**Made with ❤️ by developers, for developers** | [⭐ Star this repo](https://github.com/ruslanfialkovskii/tasktree-manager)

{tasktree_manager-2.13.1 → tasktree_manager-2.13.3}/docs/configuration.md

@@ -59,6 +59,13 @@ rm ~/.config/tasktree-manager/config.toml
 tasktree-manager
 ```
 
+### Value Types
+
+Boolean settings take TOML `true`/`false`; the quoted strings `"true"`/`"yes"`/`"1"`
+and `"false"`/`"no"`/`"0"` (any case) are accepted too. Any other value, or a section such
+as `[keybindings]` set to a plain value instead of a table, stops startup with an error that
+names the key.
+
 ## Complete Configuration Example
 
 Here's a fully annotated `config.toml` with all available options:
@@ -79,7 +86,7 @@ repos_dir = "/Users/username/repos"
 # Created automatically if it doesn't exist
 tasks_dir = "/Users/username/tasks"
 
-# Directory for finished-task diff archives
+# Directory for finished-task archives (diffs and task-folder files)
 # Relative paths resolve under tasks_dir (never the current directory)
 # Default: "" (uses <tasks_dir>/.archive)
 archive_dir = ""
@@ -298,7 +305,7 @@ blocklist = [
 |------------|------|-----------|---------------------|------------------------------------------------|
 | `repos_dir` | path | `~/repos` | `REPOS_DIR`         | Directory containing your git repositories     |
 | `tasks_dir` | path | `~/tasks` | `TASKS_DIR`         | Directory where task worktrees will be created |
-| `archive_dir` | path | `""` (`<tasks_dir>/.archive`) | - | Directory for finished-task diff archives |
+| `archive_dir` | path | `""` (`<tasks_dir>/.archive`) | - | Directory for finished-task archives (diffs and task-folder files) |
 
 ### Details
 

{tasktree_manager-2.13.1 → tasktree_manager-2.13.3}/docs/troubleshooting.md

@@ -921,7 +921,7 @@ Yes! Each task creates its own worktree and branch:
 
 - Worktrees are removed from `TASKS_DIR`
 - The local task branch is deleted from the main repository (`git branch -D`);
-  the remaining diff is archived under `archive_dir` first
+  the remaining diff and the task-folder files are archived under `archive_dir` first
 - Remote branches remain on GitHub/GitLab (if pushed)
 
 **Manual cleanup (only for branches created outside tasktree):**

{tasktree_manager-2.13.1 → tasktree_manager-2.13.3}/docs/user-guide.md

@@ -328,8 +328,9 @@ what is displayed. Press `?` for the full reference at any time.
 6. Tab to "Create" button, press `Enter`
 
 Task names may contain letters, numbers, `.`, `_` and `-`. The name becomes a
-single directory under your tasks dir (and a git branch), so `/`, `.`, `..` and a
-leading `-` are rejected; base branch names must be plain branch names too (no
+single directory under your tasks dir (and a git branch), so `/`, a leading `.`
+(hidden from the task list, and `.archive` is the archive dir) and a leading `-`
+are rejected; base branch names must be plain branch names too (no
 leading `-`/`+`, no `:` refspecs, none of the characters git forbids in refs).
 
 **Clone task workflow:**
@@ -686,6 +687,12 @@ d (delete task)
 - ✅ The task's remaining diff (committed-but-unmerged + uncommitted work) is archived to
   `archive_dir` (default `<tasks_dir>/.archive/<task>-<timestamp>.patch`) before anything
   is removed — the messages panel (`m`) shows the archive path
+- ✅ Files in the task folder outside the worktrees (`PLAN.md`, ADRs, notes, scripts) are
+  copied to `<task>-<timestamp>.files/` next to the patch. Hidden files, symlinks,
+  `node_modules`/`vendor`/`.terraform` folders and an unedited generated `CLAUDE.md` are
+  skipped silently. Key material (`*.pem`, `*.key`, `id_rsa`, kubeconfigs, `*.tfstate`,
+  `credentials*.json`), files over 10 MB, files past 100 MB in total and files that cannot
+  be read or copied are listed in the messages panel
 - ✅ Worktrees removed from `TASKS_DIR`
 - ✅ Branches remain on remote (if pushed)
 - ✅ Original repos in `REPOS_DIR` untouched

{tasktree_manager-2.13.1 → tasktree_manager-2.13.3}/pyproject.toml

@@ -71,7 +71,7 @@ version-file = "tasktree_manager/_version.py"
 # Semantic Release Configuration
 [tool.semantic_release]
 version_toml = ["pyproject.toml:tool.semantic_release.version"]
-version = "2.13.1"
+version = "2.13.3"
 tag_format = "v{version}"
 branch = "main"
 commit_message = "chore(release): {version} [skip ci]"

{tasktree_manager-2.13.1 → tasktree_manager-2.13.3}/scripts/bump_version.py

@@ -117,8 +117,14 @@ def update_pyproject_version(current_version: str, new_version: str, dry_run: bo
         if in_section and re.match(
             r'^version\s*=\s*"' + re.escape(current_version) + '"', stripped
         ):
-            line = line.replace(f'"{current_version}"', f'"{new_version}"')
-            changed = True
+            new_line = line.replace(f'"{current_version}"', f'"{new_version}"')
+            # A `--set` to the version that's already current (e.g. a retried
+            # release re-running against an already-bumped commit) makes the
+            # regex match but shouldn't count as a change — only the text
+            # actually differing does.
+            if new_line != line:
+                changed = True
+            line = new_line
 
         updated_lines.append(line)
 
@@ -236,6 +242,15 @@ def update_changelog(new_version: str, message: str = "", dry_run: bool = False)
                 "and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n\n"
             )
 
+    content = CHANGELOG_PATH.read_text() if CHANGELOG_PATH.exists() else ""
+
+    # A retried release (e.g. re-running after tag-release failed partway)
+    # can call this again for a version that's already documented — don't
+    # insert a second copy of its section.
+    if f"## [{new_version}]" in content:
+        print(f"CHANGELOG.md already has an entry for version {new_version}, skipping")
+        return False
+
     today = datetime.now().strftime("%Y-%m-%d")
 
     if message:
@@ -252,8 +267,6 @@ def update_changelog(new_version: str, message: str = "", dry_run: bool = False)
         print(f"Would add new entry to CHANGELOG.md for version {new_version}")
         return True
 
-    content = CHANGELOG_PATH.read_text()
-
     # Insert after [Unreleased] section or at top after header
     if "## [Unreleased]" in content:
         # Find [Unreleased] section and insert new version after it

{tasktree_manager-2.13.1 → tasktree_manager-2.13.3}/tasktree_manager/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '2.13.1'
-__version_tuple__ = version_tuple = (2, 13, 1)
+__version__ = version = '2.13.3'
+__version_tuple__ = version_tuple = (2, 13, 3)
 
 __commit_id__ = commit_id = None