Git Delegation Management

Execute any git command on behalf of Workers without credentials by processing their git-request messages and managing workspace synchronization safely.

This skill enables the Manager to execute any git operation on behalf of Workers. Workers cannot access git credentials, so they delegate all git operations to the Manager.

Prerequisites

The Manager has access to:

• Host's .gitconfig via /host-share/.gitconfig (symlinked to /root/.gitconfig)
• Git credentials (SSH keys, credential helpers) configured on the host

This allows git operations to use the correct author name, email, and authentication.

---

Handling git-request: Messages

When a Worker sends a message containing git-request::

task-{task-id} git-request:
workspace: /root/hiclaw-fs/shared/tasks/{task-id}/workspace/{repo-name}
operations:
  - git clone https://github.com/org/repo.git
  - git checkout -b feature-auth
  - git add .
  - git commit -m "feat: add authentication"
  - git push origin feature-auth
---CONTEXT---
{description of what they're trying to accomplish}
---END---

Extract:

• task-id: Task identifier
• workspace: Path to work in (for clone: parent directory; for other ops: repo directory)
• operations: List of git commands to execute (literally what to run)
• context: (Optional) What the Worker is trying to accomplish

---

Execution Flow

1. Sync and Check Processing Marker

task_id="task-YYYYMMDD-HHMMSS"
workspace="/root/hiclaw-fs/shared/tasks/${task_id}/workspace/{repo-name}"

# Sync from MinIO
mc mirror "hiclaw/hiclaw-storage/shared/tasks/${task_id}/" \
  "/root/hiclaw-fs/shared/tasks/${task_id}/"

# Check for processing marker
bash /opt/hiclaw/agent/skills/task-coordination/scripts/check-processing-marker.sh "$task_id"
if [ $? -ne 0 ]; then
    # Respond with git-failed: explaining the conflict
    exit 1
fi

# Create processing marker
bash /opt/hiclaw/agent/skills/task-coordination/scripts/create-processing-marker.sh "$task_id" "manager" 15

2. Execute Git Commands

Navigate to the workspace and execute the git commands:

cd "$workspace"

# Execute each git command
git clone https://github.com/org/repo.git
git checkout -b feature-auth
# ... etc

# Log output for debugging

You know how to use git. Execute the commands the Worker requests. If something goes wrong (merge conflict, authentication failure, etc.), handle it appropriately.

3. Cleanup and Respond

# Remove processing marker
bash /opt/hiclaw/agent/skills/task-coordination/scripts/remove-processing-marker.sh "$task_id"

# Sync to MinIO
mc mirror "/root/hiclaw-fs/shared/tasks/${task_id}/" \
  "hiclaw/hiclaw-storage/shared/tasks/${task_id}/" --overwrite

On success — send to Worker:

@{worker}:DOMAIN task-{task-id} git-result:
Git operations completed successfully.
{Summary of what was done - commits, pushes, branches created, etc.}
Run `bash /opt/hiclaw/agent/skills/file-sync/scripts/hiclaw-sync.sh` to sync.

On failure — send to Worker:

@{worker}:DOMAIN task-{task-id} git-failed:
Git operation failed: {error message}
{Suggestion for how to fix it, if applicable}

---

What Operations Can Be Delegated

Any git operation, including but not limited to:

Category	Commands
Repository	git clone, git init
Branches	git branch, git checkout, git switch
Remote	git remote, git fetch, git pull, git push
Commits	git add, git commit, git reset, git revert
History	git log, git show, git diff
Rebase	git rebase, git rebase -i
Cherry-pick	git cherry-pick
Merge	git merge
Stash	git stash
Tags	git tag
Submodules	git submodule
Config	git config (local to repo)

If git can do it, the Worker can delegate it.

---

Error Handling

When git operations fail:

1. Read the error message and understand what went wrong
2. Try to fix it if it's a simple issue (e.g., set upstream, configure user locally)
3. Report to Worker if it requires their action (e.g., merge conflicts, rebasing decisions)
4. Escalate to admin if it's a credential or permission issue

Common issues:

• Merge conflicts → Ask Worker to resolve locally
• Authentication failure → Check /host-share/.gitconfig and credential helper
• Branch divergence → Worker may need to pull/rebase first

---

Integration with Task Coordination

Always use the .processing marker to prevent conflicts when both Worker and Manager might modify the workspace.

<!-- hiclaw-builtin-end -->