Skip to content

v1.0.0

Latest

Choose a tag to compare

@github-actions github-actions released this 11 Oct 01:23

Changed

  • 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.json name, 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.json and opencode.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/schema Config.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).