opencode-toolkit/REQUIREMENTS.md

Requirements

Plugin loading and tools

• OpenCode V2 must load the plugin from the consuming project's installed local package directory without trying to download the provisional package name from npm.
• The package root must expose an OpenCode-loadable JavaScript entrypoint.
• Register toolkit_project_status in the toolkit Code Mode namespace. The tool must report the current project and VCS status through OpenCode's V2 API without mutating project state.

Installation safety

• Register the plugin with a config-relative path that works with either opencode.json or .opencode/opencode.json.
• Migrate an installer-owned legacy npm-name entry on update, and remove only the installer-owned local path on uninstall.
• Preserve JSONC comments and unrelated plugin entries; do not overwrite unmanaged project files.

Verification

• Keep unit and installer tests deterministic and independent of external model providers.
• Verify plugin activation and tool execution on OpenCode 2.0.24 using a local mock OpenAI-compatible endpoint; do not make a paid or remote provider call as part of deterministic validation.