tasktree-manager 2.8.0__tar.gz → 2.10.0__tar.gz

{tasktree_manager-2.8.0 → tasktree_manager-2.10.0}/CHANGELOG.md

@@ -15,6 +15,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Git hooks support
 - Custom task metadata
 
+## [2.10.0] - 2026-07-23
+
+### Added
+- **cli**: Add headless CLI for task management
+
+
+## [2.9.0] - 2026-07-14
+
+### Added
+- **app**: Move blocking git work off the UI thread
+
+### Changed
+- Format worktree settings call with ruff
+- **app**: Extract Claude session preparation helper
+
+### Fixed
+- Address review findings in async refresh and hook merging
+- Harden task/branch validation, hook merging, markup rendering
+
+
 ## [2.8.0] - 2026-07-14
 
 ### Added

{tasktree_manager-2.8.0 → tasktree_manager-2.10.0}/PKG-INFO

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

{tasktree_manager-2.8.0 → tasktree_manager-2.10.0}/README.md

@@ -18,6 +18,7 @@
 - ⌨️ **Keyboard-First** - Navigate and control everything without touching the mouse
 - 🚀 **Fast & Responsive** - Parallel git operations with loading indicators
 - 🔧 **Flexible Configuration** - TOML config file, custom keybindings, environment variables
+- 🤖 **Headless CLI** - Create, list, and delete tasks from scripts and AI agents without opening the TUI
 
 ## 📊 Status Indicators
 
@@ -63,6 +64,22 @@ On first run, you'll configure:
 
 For detailed workflows and examples, see the [User Guide](docs/user-guide.md).
 
+### Headless CLI
+
+Running `tasktree-manager` with arguments skips the TUI — useful for scripts and AI-agent
+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 repos           # available repos in REPOS_DIR
+tasktree-manager add-repo DIC-1901-argocd-tls infra
+tasktree-manager delete DIC-1901-argocd-tls   # refuses on unfinished work; --force overrides
+```
+
+Exit code is 0 on success, 1 on failure with the reason on stderr. `delete` runs the same
+safety check as the TUI (uncommitted, unpushed, or unmerged work blocks deletion).
+
 ## 📖 Documentation
 
 **Complete guides:**

{tasktree_manager-2.8.0 → tasktree_manager-2.10.0}/docs/configuration.md

@@ -222,7 +222,7 @@ cycle_theme = "t"           # Cycle through the design-system themes
 # Symlinks
 # ============================================================================
 # When creating worktrees, gitignored files are symlinked from the source repo.
-# Blocklist specifies patterns to exclude (e.g., cache files).
+# Blocklist specifies patterns to exclude (e.g., cache files, key material).
 [symlinks]
 blocklist = [
     "*.pyc",
@@ -233,6 +233,9 @@ blocklist = [
     ".ruff_cache",
     ".coverage",
     "*.log",
+    "*.pem",
+    "*.key",
+    "id_rsa",
 ]
 ```
 
@@ -388,7 +391,9 @@ When creating worktrees, tasktree-manager automatically symlinks gitignored file
 
 ### Default Blocklist
 
-By default, these patterns are excluded from symlinking:
+By default, these patterns are excluded from symlinking. Caches and build
+artifacts are excluded as noise; key material (`*.pem`, `*.key`, SSH keys)
+is excluded so private keys never spread beyond the main checkout:
 
 ```toml
 [symlinks]
@@ -409,14 +414,28 @@ blocklist = [
     ".nox",
     "*.so",
     "*.dylib",
+    "*.pem",
+    "*.key",
+    "*.p12",
+    "*.pfx",
+    "*.keystore",
+    "id_rsa",
+    "id_ecdsa",
+    "id_ed25519",
 ]
 ```
 
 ### How It Works
 
-1. When a worktree is created, tasktree-manager reads the source repo's `.gitignore`
-2. For each gitignored file pattern, it finds matching files
-3. Files matching the blocklist are skipped
+1. When a worktree is created, tasktree-manager asks git for the repo's
+   ignored files (`git ls-files --others --ignored --exclude-standard`), so
+   full gitignore semantics apply: nested `.gitignore` files work, and a
+   root pattern like `*.log` matches in subdirectories
+2. Wholly-ignored directories (e.g. `node_modules/`) are skipped entirely —
+   their contents are never walked or symlinked
+3. Files matching the blocklist (by filename or repo-relative path, so
+   patterns like `secrets/*` work) and anything under `.git/` or `.claude/`
+   are skipped
 4. Remaining files are symlinked to the worktree
 
 ### Customizing the Blocklist
@@ -437,7 +456,9 @@ blocklist = [
 ]
 ```
 
-**Add to default blocklist (must include all patterns):**
+**Add to default blocklist (must include ALL default patterns — an explicit
+blocklist replaces the defaults entirely, including the key-material
+protection):**
 ```toml
 [symlinks]
 blocklist = [
@@ -445,22 +466,47 @@ blocklist = [
     "*.pyc",
     "*.pyo",
     "__pycache__",
+    ".pytest_cache",
+    ".mypy_cache",
+    ".ruff_cache",
     ".coverage",
     "*.log",
+    "*.egg-info",
+    ".eggs",
+    "dist",
+    "build",
+    ".tox",
+    ".nox",
+    "*.so",
+    "*.dylib",
+    "*.pem",
+    "*.key",
+    "*.p12",
+    "*.pfx",
+    "*.keystore",
+    "id_rsa",
+    "id_ecdsa",
+    "id_ed25519",
     # Your additions
     "*.tmp",
     ".DS_Store",
 ]
 ```
 
+> **Upgrading note:** if your existing `config.toml` already contains a
+> `blocklist`, it keeps overriding the defaults — the key-material patterns
+> added in newer versions do NOT apply until you add them (or delete the
+> `blocklist` line to inherit the defaults).
+
 ### Common Use Cases
 
-**Symlink environment files, block caches:**
+**Symlink environment files, block caches and keys:**
 ```toml
 [symlinks]
-blocklist = ["*.pyc", "__pycache__", ".coverage", "*.log"]
+blocklist = ["*.pyc", "__pycache__", ".coverage", "*.log", "*.pem", "*.key", "id_rsa"]
 ```
-This allows `.env`, `.mise.toml` to be symlinked while blocking cache files.
+This allows `.env`, `.mise.toml` to be symlinked while blocking cache files
+and private keys.
 
 **Block everything (disable symlinks):**
 ```toml

{tasktree_manager-2.8.0 → tasktree_manager-2.10.0}/docs/user-guide.md

@@ -309,6 +309,11 @@ what is displayed. Press `?` for the full reference at any time.
 5. Select repos with `Space` (can select multiple)
 6. Tab to "Create" button, press `Enter`
 
+Task names may contain letters, numbers, `.`, `_`, `/` and `-`. Because the
+name becomes a directory under your tasks dir (and a git branch), names with
+`.`/`..` path segments, empty segments, or a leading `-` are rejected; base
+branch names must not start with `-` either.
+
 **Clone task workflow:**
 Useful when you're spinning up several similar tasks that share the same set of repos.
 

{tasktree_manager-2.8.0 → tasktree_manager-2.10.0}/pyproject.toml

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

{tasktree_manager-2.8.0 → tasktree_manager-2.10.0}/tasktree_manager/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '2.8.0'
-__version_tuple__ = version_tuple = (2, 8, 0)
+__version__ = version = '2.10.0'
+__version_tuple__ = version_tuple = (2, 10, 0)
 
 __commit_id__ = commit_id = None