You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Upgraded to the OpenCode v2 plugin system. The plugin entrypoint is now an Effect-first Plugin.define({ id, effect }) in src/plugin.ts, default-re-exported from index.ts; the root plugin.ts shim is removed and dropped from files, and package.json declares content: "code" with exports for both . and ./server. This replaces the v1 config() hook on @opencode-ai/plugin. Load-time behavior is unchanged: scope-aware, manifest-gated install-on-load, read-only registration detection, once-per-session not-installed advisory, skipped-file warnings. The direct dependency is @opencode/plugin at latest (2.0.26); effect intentionally stays on the ^4.0.0-rc.112 caret the entire @opencode plugin stack pins — latest (4.0.2) would fork Effect across the plugin boundary.
Installer writes v2-native config keys.bunx aurelia-expert install adds aurelia-expert@latest to the plugins array and grants skills via the ordered permissions ruleset ({ action: "skill", resource: "<skill-id>", effect: "allow" }); uninstall cleans both plugins and a legacy plugin entry. Detection reads plugins first and falls back read-only to the legacy singular plugin key, so v1-era registrations are not duplicated.
Load-time installs never write consumer config. Permission-ruleset writes and legacy permission.skill migration are gated behind explicit CLI installs (configurePermissions); the load path performs zero config writes (ADR-0007, refining ADR-0005).
Config edits are byte-preserving text splices.plugins/permissions mutations anchor into the raw file text and preserve every other byte — comments, indentation, key order — refusing to write when no anchor exists instead of reformatting the file; only fresh-file creation still parses and serializes.
Consumer docs realigned. README badges collapse to a single row under the title with canonical aurelia-expert@latest snippets, and the install snippets and load-contract description now teach the plugins array; CONTRIBUTING is rewritten against the current surface (v1 plugin-key snippet and stale v1 prose removed); the release workflow verifies the publishable tarball with npm pack --dry-run before publishing.
Skill frontmatter values are double-quoted across all eight skills (native booleans stay bare); contract tests parse frontmatter as YAML and assert the quoting.
Dev self-config (.opencode/opencode.json) rewritten to v2-native keys: plugins: ["opencode-architect@latest"] (1.0.0 is the latest release; expressed as @latest per policy). The skills: { paths: [...] } entry was dropped — .agents/skills is natively discovered by OpenCode v2 from any working directory inside the repo, which is more robust than a CWD-relative explicit path.
Added
Path-form self-registration detection. Registration detection recognizes plugins/plugin entries that are file:// URLs or filesystem paths resolving to this package — the package root, an entrypoint file such as index.ts, a package.json, or a symlink — by the resolved package.jsonname, with the same normalization as bare names. Best-effort and read-only: unresolvable or missing paths never match and never throw. bunx aurelia-expert install recognizes existing path-form entries instead of adding a duplicate npm-name entry beside them.
bunx aurelia-expert clear-cache plus install-time pruning of this package's own npm cache generations (aurelia-expert, aurelia-expert@latest, aurelia-expert@<version>) — self-only, warn-and-continue; the load hook instructs and never deletes.
Failure advisory hardened: emitted at most once per process under its own guard, independent of the not-installed advisory, naming the remediation command (bunx aurelia-expert install --scope global) and the package-qualified npm cache key, with a literal <version> fallback when package metadata is unavailable. Missing bundled skill sources error with the path, package version, cache directory, and reinstall command — CLI hard-exits, load warns.
Detection now reads opencode.jsonandopencode.jsonc, warns once per path on unparseable candidates, and advises read-only when a legacy global config.json mentions the package.
tests/plugin.test.ts — first coverage of the plugin entrypoint: v2 export shape through both entrypoints, install-on-load, advisory-once with zero writes when uninstalled, and skipped-consumer-modified-file warning. tests/v2-host.test.ts and tests/fixture-config-schema.test.ts harness the v2 host contract and @opencode/schemaConfig.Info decoding; tests/config-splice.test.ts and tests/advisory.test.ts pin the splice-writer and advisory contracts.
ADR-0006: config-key migration to OpenCode v2 (supersedes the key shapes in ADR-0005's letter; its installer-owns-config principle stands).
ADR-0007: the load path never writes consumer config — permission-ruleset writes and legacy permission.skill migration are CLI-only (refines ADR-0005's installer-owns-config principle).