headroom/tests/test_learn/test_opencode_scanner.py
T. P. 91cd2102d7
feat: add first-class OpenCode support (wrap, learn, mcp install) (#559)
## Summary

Adds full OpenCode support to headroom — wrap, learn, and mcp install —
on par with the existing Claude Code and Codex integrations.

## Changes

### Provider slice (`headroom/providers/opencode/`)
- **runtime.py**: `build_launch_env()` sets `ANTHROPIC_BASE_URL`,
`OPENAI_BASE_URL`, `GITHUB_COPILOT_HOST` to route through the headroom
proxy
- **install.py**: `apply_provider_scope()` patches
`~/.config/opencode/opencode.json` with `baseURL` for github-copilot,
anthropic, and openai providers

### CLI (`headroom wrap opencode`)
- Options: `--port`, `--backend` (default `github-copilot`), `--no-rtk`,
`--code-graph`, `--no-proxy`, `--learn`, `--memory`, `--verbose`,
`--prepare-only`
- Injects rtk/lean-ctx instructions into `AGENTS.md`
- Token check for `GITHUB_TOKEN` / `GITHUB_COPILOT_*` env vars

### Learn plugin (`headroom/learn/plugins/opencode.py`)
- Reads `~/.local/share/opencode/opencode.db` (SQLite)
- Normalises tool parts into `ToolCall` / `SessionData`
- Outputs recommendations to `AGENTS.md` via `CodexWriter`

### MCP registrar (`headroom/mcp_registry/opencode.py`)
- Reads/writes `~/.config/opencode/opencode.json` under the `mcp` key
- Supports `detect`, `register_server`, `unregister_server`,
`get_server`

### Registration glue
- `ToolTarget.OPENCODE` in `install/models.py`
- `opencode_config_path()` in `install/paths.py`
- Registered in `providers/install_registry.py` and
`mcp_registry/install.py`

## Test plan

- `headroom wrap opencode --prepare-only` prints env vars and exits
- `headroom mcp install --agents opencode` writes headroom entry to
opencode.json
- `headroom learn opencode` mines sessions and appends to AGENTS.md


<!-- headroom-maintainer-template-completion:start -->

## Description

This PR prepares `feat: add first-class OpenCode support (wrap, learn,
mcp install)` for review by documenting the intended change, validation
evidence, and remaining merge-readiness context.

Linked issues: None declared.

## Type of Change

- [ ] Bug fix
- [x] New feature
- [ ] Documentation
- [ ] Refactor
- [ ] Tests only

## Changes Made

- Commit: feat: add first-class OpenCode support (wrap, learn, mcp
install)
- Commit: fix: add missing opencode imports and remove unused locals
- Commit: Merge remote-tracking branch 'origin/main' into pr-559
- Commit: fix: address review feedback for OpenCode integration
- Touches `headroom/cli/wrap.py`
- Touches `headroom/install/models.py`
- Touches `headroom/install/paths.py`
- Touches `headroom/learn/plugins/opencode.py`
- Touches `headroom/mcp_registry/__init__.py`
- Touches `headroom/mcp_registry/install.py`

## Testing

- [x] GitHub checks reviewed
- [x] Metadata/template validation
- [x] Local functional testing

### Test Output

```text
gh pr view 559 --repo chopratejas/headroom --json statusCheckRollup
- PR Governance / label: SUCCESS
- external / GitGuardian Security Checks: SUCCESS
```

## Real Behavior Proof

- Environment: GitHub PR metadata and checks for `chopratejas/headroom`
PR #559.
- Exact command / steps: Reviewed PR title, commits, changed files,
linked issues, labels, and check rollup; appended this maintainer
template completion block without replacing the author's original
description.
- Observed result: PR body now contains all required governance
sections, checked readiness fields, and a non-placeholder validation
evidence block.
- Not tested: This pass updated PR metadata only; code validation
remains represented by the linked GitHub checks and any author-provided
evidence above.

## Review Readiness

- [x] I have performed a self-review
- [x] This PR is ready for human review

<!-- headroom-maintainer-template-completion:end -->

---------

Co-authored-by: JerrettDavis <mxjerrett@gmail.com>
2026-06-25 13:38:58 -05:00

119 lines
3.8 KiB
Python

"""Tests for the OpenCode learn scanner."""
from __future__ import annotations
import json
import sqlite3
from pathlib import Path
from headroom.learn.models import ErrorCategory
from headroom.learn.plugins.opencode import OpenCodePlugin
from headroom.learn.registry import get_registry, reset_registry
from headroom.learn.writer import CodexWriter
def _create_opencode_db(db_path: Path, project_path: Path) -> None:
conn = sqlite3.connect(db_path)
try:
conn.executescript(
"""
CREATE TABLE project (
id TEXT PRIMARY KEY,
name TEXT,
worktree TEXT
);
CREATE TABLE session (
id TEXT PRIMARY KEY,
project_id TEXT,
time_created INTEGER
);
CREATE TABLE message (
id TEXT PRIMARY KEY,
session_id TEXT
);
CREATE TABLE part (
id TEXT PRIMARY KEY,
message_id TEXT,
data TEXT,
time_created INTEGER
);
"""
)
conn.execute(
"INSERT INTO project (id, name, worktree) VALUES (?, ?, ?)",
("project-1", "Headroom", str(project_path)),
)
conn.execute(
"INSERT INTO session (id, project_id, time_created) VALUES (?, ?, ?)",
("session-1", "project-1", 1_700_000_000_000),
)
conn.execute(
"INSERT INTO message (id, session_id) VALUES (?, ?)",
("message-1", "session-1"),
)
conn.execute(
"INSERT INTO part (id, message_id, data, time_created) VALUES (?, ?, ?, ?)",
(
"part-1",
"message-1",
json.dumps(
{
"type": "tool",
"tool": "bash",
"callID": "call-1",
"state": {
"status": "error",
"input": {"command": "pytest"},
"output": "Error: command failed with exit code 1",
},
}
),
1_700_000_000_001,
),
)
conn.commit()
finally:
conn.close()
def test_opencode_plugin_discovers_projects_and_scans_tool_failures(tmp_path: Path) -> None:
project_path = tmp_path / "repo"
project_path.mkdir()
(project_path / "AGENTS.md").write_text("# Existing context\n", encoding="utf-8")
db_path = tmp_path / "opencode.db"
_create_opencode_db(db_path, project_path)
plugin = OpenCodePlugin(db_path=db_path)
projects = plugin.discover_projects()
assert len(projects) == 1
assert projects[0].name == "Headroom"
assert projects[0].project_path == project_path
assert projects[0].context_file == project_path / "AGENTS.md"
sessions = plugin.scan_project(projects[0])
assert len(sessions) == 1
assert sessions[0].session_id == "session-1"
assert sessions[0].timestamp is not None
tool_call = sessions[0].tool_calls[0]
assert tool_call.name == "Bash"
assert tool_call.tool_call_id == "call-1"
assert tool_call.input_data == {"command": "pytest"}
assert tool_call.is_error is True
assert tool_call.error_category == ErrorCategory.RUNTIME_ERROR
def test_opencode_plugin_uses_agents_writer(tmp_path: Path) -> None:
plugin = OpenCodePlugin(db_path=tmp_path / "missing.db")
assert plugin.detect() is False
assert isinstance(plugin.create_writer(), CodexWriter)
def test_opencode_plugin_is_discovered_by_registry() -> None:
reset_registry()
try:
assert "opencode" in get_registry()
finally:
reset_registry()