fix(plugin): load local toolkit and expose status tool

REQUIREMENTS.md

@@ -0,0 +1,28 @@
+# 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.