Skip to content

Add worktree load tool#105

Closed
dbpolito wants to merge 3 commits into
mainfrom
feature/worktree-load-tool
Closed

Add worktree load tool#105
dbpolito wants to merge 3 commits into
mainfrom
feature/worktree-load-tool

Conversation

@dbpolito

@dbpolito dbpolito commented Jun 25, 2026

Copy link
Copy Markdown
Contributor

Ticket

SKIPPED

Description

Adds a dedicated workflow tool for reading local branch and HEAD state so PR-oriented commands can align checkout context without ad hoc git discovery.

Checklist

Worktree Context

  • Add a worktree_load tool for local branch and HEAD state
  • Wire the tool into core and OpenCode tool registration

PR Workflow Alignment

  • Update shared PR-loading guidance to use worktree context
  • Refresh generated OpenCode command artifacts for PR workflows

Documentation And Configuration

  • Add the tool to bundled configs, schema, and public documentation
  • Cover tool behavior and registration in tests

Validation

  • Verify that worktree_load reports branch, HEAD, and detached state correctly
  • Confirm that PR review/fix workflows use worktree context instead of direct git commands
  • Check that docs and schema list worktree_load consistently

- register worktree_load in core and OpenCode tool configuration
- update PR workflows to load local branch and HEAD through worktree context
- document the new tool and cover registration/template behavior in tests
@dbpolito dbpolito self-assigned this Jun 25, 2026
@dbpolito dbpolito added the review trigger kompass review label Jun 25, 2026

@kompassdev kompassdev Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

★★★★☆

Solid, well-tested addition. The tool is correctly wired across core/OpenCode registration, schema, bundled configs, and generated command artifacts. The only material issues are two docs that describe a comparison feature the tool does not implement — worktree_load takes no args and never compares HEAD to an expected SHA. Fixing those keeps the public docs in sync with the actual surface (per AGENTS.md's source-of-truth rule).

Comment thread packages/web/src/content/docs/docs/reference/tools/index.mdx Outdated
Comment thread packages/web/src/content/docs/docs/reference/components/load-pr.mdx Outdated
@dbpolito dbpolito removed the review trigger kompass review label Jun 25, 2026
- load worktree context explicitly in PR fix and review commands
- avoid detached-head checkout during read-only PR reviews
- update generated OpenCode commands, docs, and tests
@dbpolito dbpolito closed this Jun 25, 2026
@dbpolito dbpolito deleted the feature/worktree-load-tool branch June 25, 2026 19:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant