ace-git-worktree 0.19.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a2f1810626e76250d2106f5561d908f325334100bb5f35d08a477ab5edfaa104
+  data.tar.gz: 001c87228d14339e3b9817d18d443451d12a6d2eaa4759a586fc09cf155fda72
+SHA512:
+  metadata.gz: a0b04c12cf8b99c609a1d70653f69ca3cfbd16d7d26ad74b7990a20b69a8be706324efa55d2615507587e5f2142645b9f8f1077e342218534f36e12e25cb19a2
+  data.tar.gz: cde7c5e87510e8a2239c16baf02142455d7d857aec1976eed93d8f1d8ad0c3b86f0b1ea502ce5aa32946bafb32a1eb8fd41af1d116f60e11c47da87173c5ccf3

data/.ace-defaults/git/worktree.yml

@@ -0,0 +1,250 @@
+# ace-git-worktree configuration
+#
+# This file provides default configuration for task-aware git worktree management.
+# Copy this file to .ace/git/worktree.yml and customize as needed.
+#
+# Configuration is loaded in this priority (highest to lowest):
+# 1. .ace/git/worktree.yml (project-specific)
+# 2. ~/.ace/git/worktree.yml (user-specific)
+# 3. .ace-defaults/git/worktree.yml (these defaults)
+
+git:
+  worktree:
+    # Root directory for all worktrees (relative to project root)
+    # This is where worktree directories will be created
+    root_path: ".ace-wt"
+
+    # Timeout settings (in seconds)
+    # These control timeout for various git and shell operations
+    timeouts:
+      default: 30      # Default timeout for general git operations
+      max: 300         # Maximum allowed timeout for any operation
+      hook: 30         # Timeout for after_create hook commands
+      list: 30         # Timeout for worktree list operations
+      commit: 30       # Timeout for git commit operations
+      remove: 30       # Timeout for worktree removal operations
+
+    # Automatically navigate to worktree after creation
+    # If true, provides enhanced navigation experience after worktree creation
+    auto_navigate: true
+
+    # Launch tmux session after worktree creation
+    # Requires ace-tmux to be installed. When enabled, replaces "cd ..." hint
+    # with automatic tmux session launch rooted at the new worktree.
+    # Values: true | false
+    tmux: false
+
+    # Task-based naming and behavior configuration
+    task:
+      # Directory naming format for task worktrees
+      # Available variables: {id}, {task_id}, {slug}
+      # Examples:
+      #   "t.{task_id}"     -> t.081
+      #   "{id}"            -> 081
+      #   "{task_id}"       -> t.081
+      directory_format: "t.{task_id}"
+
+      # Branch naming format for task worktrees
+      # Available variables: {id}, {task_id}, {slug}
+      # Examples:
+      #   "{id}-{slug}"       -> 081-fix-authentication-bug
+      #   "task-{id}-{slug}"  -> task-081-fix-authentication-bug
+      branch_format: "{id}-{slug}"
+
+      # Automatically mark tasks as in-progress when creating worktrees
+      # If true, updates task status to "in-progress" via ace-task
+      auto_mark_in_progress: true
+
+      # Automatically commit task changes before creating worktree
+      # If true, commits task status and metadata changes to main branch
+      auto_commit_task: true
+
+      # Commit message format for task updates
+      # Available variables: {id}, {task_id}, {slug}
+      commit_message_format: "chore({task_id}): mark as in-progress, creating worktree for {slug}"
+
+      # Add worktree metadata to task frontmatter
+      # If true, adds worktree info (branch, path, created_at) to task file
+      add_worktree_metadata: true
+
+      # Automatically push task changes after commit
+      # If true, pushes commits to remote after task status updates
+      auto_push_task: true
+
+      # Remote name for pushing task changes
+      push_remote: "origin"
+
+      # Automatically push new branch to remote with upstream tracking
+      # If true, runs 'git push -u origin <branch>' after worktree creation
+      # NOTE: Defaults to false - enable explicitly for automated workflows
+      auto_setup_upstream: false
+
+      # Automatically create draft PR after pushing branch
+      # If true, creates a draft PR via 'gh pr create --draft'
+      # Requires: gh CLI installed and authenticated
+      # NOTE: Defaults to false - enable explicitly for automated workflows
+      auto_create_pr: false
+
+      # PR title format when auto-creating PRs
+      # Available variables: {id}, {task_id}, {slug}
+      pr_title_format: "{id} - {slug}"
+
+      # Create _current symlink inside worktree pointing to task directory
+      # When you cd into the worktree, enables quick access: cat _current/*.s.md, ls _current/
+      # Symlink is created at worktree root (e.g., .ace-wt/t.145/_current)
+      # Uses relative paths for portability
+      create_current_symlink: true
+
+      # Name of the current task symlink
+      # Default: "_current"
+      current_symlink_name: "_current"
+
+    # Pull Request-based naming and behavior configuration
+    pr:
+      # Directory naming format for PR worktrees
+      # Available variables: {number}, {slug}, {title_slug}, {base_branch}
+      # Examples:
+      #   "ace-pr-{number}"     -> ace-pr-26
+      #   "pr-{number}"         -> pr-26
+      #   "{number}-{slug}"     -> 26-create-ace-git-package
+      directory_format: "ace-pr-{number}"
+
+      # Branch naming format for PR worktrees
+      # Available variables: {number}, {slug}, {title_slug}, {base_branch}
+      # Examples:
+      #   "pr-{number}"                    -> pr-26
+      #   "pr-{number}-{slug}"             -> pr-26-create-ace-git-package
+      #   "{number}/{slug}"                -> 26/create-ace-git-package
+      #   "pr-{number}-{base_branch}-{slug}" -> pr-26-main-create-ace-git-package
+      branch_format: "pr-{number}-{slug}"
+
+      # Remote name to use for fetching PR branches
+      remote_name: "origin"
+
+      # Fetch latest PR information before creating worktree
+      # If true, runs 'git fetch {remote_name} {pr_branch}' before worktree creation
+      fetch_before_create: true
+
+    # Branch-based naming and behavior configuration
+    branch:
+      # Fetch branch from remote if it exists locally
+      # If true, attempts to fetch from remote before creating local worktree
+      fetch_if_remote: true
+
+      # Automatically detect remote name
+      # If true, searches for remotes that contain the target branch
+      auto_detect_remote: true
+
+    # Cleanup policies for worktree management
+    cleanup:
+      # Automatically remove worktrees when their branches are merged
+      # If true, worktrees are cleaned up after branch merge
+      on_merge: false
+
+      # Automatically remove worktrees when their branches are deleted
+      # If true, worktrees are cleaned up after branch deletion
+      on_delete: true
+
+    # Hooks: Commands to run at specific lifecycle points
+    # Commands execute sequentially from the PROJECT ROOT by default
+    # Available variables: {worktree_path}, {task_id}, {task_title}, {worktree_dir}
+    # Environment variables: ACE_PROJECT_ROOT, ACE_WORKTREE_PATH, ACE_TASK_ID, ACE_TASK_TITLE
+    hooks:
+      # after_create: Commands to run after worktree creation
+      # Hook configuration:
+      #   command: Shell command to execute (required)
+      #   working_dir: Directory to run in (default: project root)
+      #     - "." or empty: project root (default)
+      #     - "worktree": the worktree directory
+      #     - relative path: relative to project root
+      #     - absolute path: as specified
+      #   timeout: Maximum execution time in seconds (default: 30, max: 300)
+      #   continue_on_error: Continue if this hook fails (default: false)
+      #   env: Additional environment variables (key-value pairs)
+      after_create:
+        # Example 1: Trust all mise configuration files in the worktree
+        - command: "find {worktree_path} -maxdepth 1 -name 'mise*.toml' -exec mise trust {} \\;"
+          timeout: 30
+          continue_on_error: true
+
+        # Example 2: Same using environment variable
+        # - command: "find $ACE_WORKTREE_PATH -maxdepth 1 -name 'mise*.toml' -exec mise trust {} \\;"
+        #   timeout: 30
+        #   continue_on_error: true
+
+        # Example 3: Run command IN the worktree directory
+        # - command: "bundle install --quiet"
+        #   working_dir: "worktree"
+        #   timeout: 120
+        #   continue_on_error: true
+
+        # Example 4: Run custom setup script from project root
+        # - command: "[ -f .ace/git/worktree/hooks/setup.sh ] && bash .ace/git/worktree/hooks/setup.sh || true"
+        #   timeout: 60
+        #   continue_on_error: false
+
+        # Example 5: With custom environment and variable interpolation
+        # - command: "echo 'Setup complete for task {task_id} at {worktree_path}'"
+        #   env:
+        #     CUSTOM_VAR: "value"
+        #   continue_on_error: true
+
+# Additional configuration examples:
+
+# Example 1: Custom directory structure
+# git:
+#   worktree:
+#     root_path: "~/worktrees"
+#     task:
+#       directory_format: "work/{task_id}"
+#       branch_format: "work/{id}-{slug}"
+
+# Example 2: Minimal automation
+# git:
+#   worktree:
+#     root_path: ".worktrees"
+#     task:
+#       auto_mark_in_progress: false
+#       auto_commit_task: false
+#       add_worktree_metadata: true
+#     hooks:
+#       after_create: []  # No hooks
+
+# Example 3: Development-focused setup
+# git:
+#   worktree:
+#     root_path: ".dev"
+#     task:
+#       directory_format: "{id}-dev"
+#       branch_format: "dev/{id}-{slug}"
+#       auto_mark_in_progress: true
+#       auto_commit_task: true
+#       add_worktree_metadata: true
+#     hooks:
+#       after_create:
+#         - command: "mise trust mise*.toml"
+#         - command: "bundle install --quiet"
+
+# Example 4: Full automation with upstream push and PR creation
+# Enables complete worktree-to-PR workflow in one command
+# git:
+#   worktree:
+#     task:
+#       auto_mark_in_progress: true
+#       auto_commit_task: true
+#       auto_push_task: true
+#       auto_setup_upstream: true    # Push branch with -u flag
+#       auto_create_pr: true         # Create draft PR automatically
+#       pr_title_format: "{id} - {slug}"
+
+# Template Variable Reference:
+# {id}        -> Numeric task ID (e.g., 081)
+# {task_id}   -> Full task ID (e.g., t.081)
+# {slug}      -> URL-safe slug from title (e.g., fix-authentication-bug)
+# {number}    -> PR number (e.g., 26)
+# {title_slug}-> Alternative slug variable (same as {slug})
+# {base_branch}-> PR base branch (e.g., main, develop)
+
+# For more information, see:
+# - ace-git-worktree create --help
+# - ace-git-worktree config --help

data/.ace-defaults/nav/protocols/wfi-sources/ace-git-worktree.yml

@@ -0,0 +1,19 @@
+---
+# WFI Sources Protocol Configuration for ace-git-worktree gem
+# This enables workflow discovery from the installed ace-git-worktree gem
+
+name: ace-git-worktree
+type: gem
+description: Git worktree workflow instructions from ace-git-worktree gem
+priority: 10
+
+# Configuration for workflow discovery within the gem
+config:
+  # Relative path within the gem (default: handbook/workflow-instructions)
+  relative_path: handbook/workflow-instructions
+
+  # Pattern for finding workflow files (default: *.wf.md)
+  pattern: "*.wf.md"
+
+  # Enable discovery
+  enabled: true