feat(hosts): add WorkBuddy coding agent host adapter - #26
Merged
Conversation
Add WorkBuddy (~/.workbuddy) as an analysis-capable source-local host at the partial-adapter level, following the Copilot/Pi host template: - Configured assets: scripts/agent-customize/providers/workbuddy.mjs inventories user skills, marketplace plugins under plugins/marketplaces/<marketplace>/plugins/ with enabled state from settings.json (<plugin>@<marketplace> keys), mcp.json MCP servers, the global AGENTS.md and SOUL/IDENTITY/USER identity context files, shared .agents/skills, and project .workbuddy assets. - Session evidence: scripts/session-analysis/platforms/workbuddy.mjs reads workspace-matching JSONL transcripts under ~/.workbuddy/projects/<cwd-slug>/, honors WORKBUDDY_DIR, verifies the per-record cwd, and normalizes user/assistant messages, function_call and function_call_result records, and providerData.usage into provider-labelled events with per-response usage de-duplication. - Register the workbuddy platform across session-analysis, evidence-bundle, asset-baseline/integrity, task-loop, report-run, and agent-lint surfaces with --workbuddy-home threading, and extend the canonical SUPPORTED_PLATFORMS support declaration. - No install shell: WorkBuddy skills install by copying into ~/.workbuddy/skills, so no manifest or npm-packaged artifact is added, and the host stays out of the README Quickstart and site installation pages per the capability-level policy. - Sync the host adapter matrix and capability references (platforms/workbuddy.md, routing, sessions diagnostics) plus concepts/glossary/ADR host lists and CHANGELOG; add a spec under docs/specs; add provider, inventory, baseline, and evidence-bundle tests with fixtures matching the real WorkBuddy 2.106.4 session format. Spec: docs/specs/2026-07-30-workbuddy-host-adapter.md Validated with npm test (920 tests) and npm run pack:verify on top of the merged Pi and Copilot hosts, and against real local WorkBuddy data: session discovery, insights usage totals, privacy-safe facts, and agent-customize inventory. Co-authored-by: QoderAI (Qwen 3.8 Max) <[email protected]>
Merge the current upstream topology and Cursor fixes while preserving WorkBuddy host routing through report and task-loop collection. The three content conflicts were resolved by retaining both host-home forwarding and the new topology scope, then regenerating the machine-readable CLI hashes. Validated with the focused report, task-loop, evidence-bundle, and scripts-refactor suites (72 tests). Co-authored-by: Codex (GPT 5.6 Sol) <[email protected]>
Extend docs/specs/2026-07-30-workbuddy-host-adapter.md with the locally observed 5.0.2 transcript, usage, and MCP layouts. The acceptance scenarios now require exact-directory admission for cwd-less sessions, sparse usage preservation, both MCP filenames, and explicit workbuddy-home help. The spec update was validated with the doc-link graph suite (6 tests) and git diff --check. Co-authored-by: Codex (GPT 5.6 Sol) <[email protected]>
Accept cwd-less WorkBuddy 5.x transcripts only from exact workspace slug directories, preserve sparse camelCase and snake_case usage, and align session attribution with workspace topology. Discover user and plugin MCP servers from both supported config filenames and expose the WorkBuddy home override consistently in CLI help. The host contract, references, and regression fixtures now cover both WorkBuddy 2.106.4 and 5.x. Validated with 992 Node 22 tests, npm/runtime package verification, doc-link checks, preview smoke, and native WorkBuddy evidence-bundle runs. Co-authored-by: Codex (GPT 5.6 Sol) <[email protected]>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds WorkBuddy as an analysis-capable source-local host and updates the adapter
for both observed native layouts:
cwd, camelCase usage,mcp.json.assistant/reasoning records,
.mcp.jsonat user and plugin roots.--platform workbuddyand--workbuddy-homerouting,configured-asset inventory, session evidence, docs, and deterministic
fixtures.
There is no WorkBuddy install shell or binary-state parsing in scope.
Traceability
docs/adapters/contributing-new-coding-agent.md.docs/specs/2026-07-30-workbuddy-host-adapter.md(AC1-AC5, statusImplemented).
scripts/session-analysis/platforms/workbuddy.mjs,scripts/agent-customize/providers/workbuddy.mjs, shared CLI/evidence-bundlerouting, adapter/reference docs.
Review fixes
mainand resolved the sharedreport/task-loop/hash conflicts.
prefix-only candidates still require a matching
cwd.sibling fields, including usage on reasoning records.
mcp.jsonand.mcp.json.--workbuddy-homeconsistently in session-analysis andevidence-bundle help.
Validation
/health=ok;/canvas-module.js= HTTP 200 JavaScriptcomplete; all three lanes and lead availableRisk and recovery
only from an exact requested-workspace directory; prefix-only matches fail
closed.
WorkBuddy 5.0.2.
workbuddy.db, connectors, automations, Memory bodies, writes, and migrationsremain out of scope.
AI involvement
traceability workflow.
table above. No external review or CI status is inferred.
Checklist
AGENTS.mdand the host contribution guide.