Skip to content
HUEHUE Docs

HUE-027 — Implement repository service and managed worktree lifecycle

Canonical source: docs/roadmap/issues.json · HUE-027

Specification status: TBI · Readiness: agent:blocked

Goal

Section titled “Goal”

Provide safe isolated repository execution owned by HUE.

Scope

Section titled “Scope”
  • Git status/branch/diff abstractions
  • Create/reuse/cleanup managed worktrees
  • Detect dirty/conflicting/orphan state

Acceptance criteria

Section titled “Acceptance criteria”
  • Main workspace remains untouched by default
  • Worktree provenance links to run
  • Cleanup never deletes unmerged work silently
  • Restart reconciliation works

Dependencies

Section titled “Dependencies”
  • HUE-010
  • HUE-021

Non-goals

Section titled “Non-goals”
  • None beyond the documented scope.

Product contract

Section titled “Product contract”
  • Follow the milestone and repository product contract.

Implementation handoff requirements

Section titled “Implementation handoff requirements”
  • Preserve the documented security, project, memory and event boundaries.
  • Add or update automated tests for every observable acceptance criterion.
  • Provide real verification output; do not rely on a worker/agent self-report.
  • Update only the exact documentation sections whose status changed.
  • Include screenshots or a recording for user-interface changes.
  • Include migration, rollback and recovery notes for data/state changes.
  • Link the pull request to this issue with Closes #<issue-number>.