Skip to content

feat: Update command docs to use session_command tags - Add /merge command#72

Merged
dbpolito merged 2 commits intomainfrom
feature/merge-command-session-dispatch
Mar 31, 2026
Merged

feat: Update command docs to use session_command tags - Add /merge command#72
dbpolito merged 2 commits intomainfrom
feature/merge-command-session-dispatch

Conversation

@dbpolito
Copy link
Copy Markdown
Contributor

@dbpolito dbpolito commented Mar 31, 2026

Ticket

SKIPPED

Description

Updates command documentation to use <session_command> tags instead of <dispatch> tags for navigator-style command delegation. This aligns the docs with the current implementation where session commands are used for same-session dispatch.

Checklist

Documentation

  • Updated AGENTS.md to reflect session_command usage
  • Verified command authoring guidelines reference correct tags

Commands

  • Reviewed navigator delegation patterns in command docs
  • Confirmed session_command examples are accurate

Validation

  • Verify that all command docs use session_command consistently
  • Check that no dispatch tags remain in documentation
  • Confirm workflow subsections follow the new pattern

- add the merge command and session_command tool across core and OpenCode surfaces
- switch navigator-driven workflows from dispatch tags to literal session_command tags
- sync docs, config, schema, generated output, and tests for the new command flow
…ody/agent format

- Replace slash command parsing with explicit command/body/agent structure
- Update session_command tool to require command parameter
- Add command attribute to all session_command tags in command docs
- Update navigator agent docs for new session command format
- Update all tests to use new API signatures
- Update OpenCode adapter tool registration and execution
- Update web documentation for session command changes
- Add merge command documentation
- Add session-command tool documentation
@dbpolito dbpolito self-assigned this Mar 31, 2026
@dbpolito dbpolito changed the title feat: Update command docs to use session_command tags feat: Update command docs to use session_command tags - Add /merge command Mar 31, 2026
Copy link
Copy Markdown

@kompassdev kompassdev bot left a comment

Choose a reason for hiding this comment

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

★★★★★

This is a well-structured migration PR that cleanly replaces the <dispatch> mechanism with the <session_command> tool approach. The changes are consistent across all command documentation, configuration files, schema, tests, and generated output.

Key observations:

  1. Complete migration: All <dispatch> references have been replaced with <session_command> throughout the codebase - command docs, agent docs, AGENTS.md guidelines, compiled output, and tests.

  2. Correct tag format: All <session_command> tags use the proper format with both agent and command attributes (e.g., <session_command agent="worker" command="branch">).

  3. New implementation: The packages/core/tools/dispatch.ts introduces a clean resolveSessionCommand function that properly expands command templates and resolves agent routing.

  4. OpenCode adapter updates: The adapter correctly uses client.session.promptAsync to queue commands instead of the previous expansion approach.

  5. Tests validate the changes: All 42 tests pass (5 dispatch tests, 28 commands-config tests, 9 tool-registration tests). The only failing test (pr_load.test.ts) is unrelated to this PR - it's an environmental issue with viewerLogin expectations.

  6. Type checking passes: No TypeScript errors.

  7. New merge command: The PR also adds a new merge command that follows the established patterns.

Checklist verification:

  • ✅ Updated AGENTS.md to reflect session_command usage
  • ✅ Verified command authoring guidelines reference correct tags
  • ✅ Reviewed navigator delegation patterns in command docs
  • ✅ Confirmed session_command examples are accurate
  • ✅ Verified all command docs use session_command consistently
  • ✅ No dispatch tags remain in documentation
  • ✅ Workflow subsections follow the new pattern

No material issues found. The migration is thorough and consistent.

@dbpolito dbpolito merged commit 692ab44 into main Mar 31, 2026
1 check passed
@dbpolito dbpolito deleted the feature/merge-command-session-dispatch branch March 31, 2026 12:41
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