Repository navigation
Releases
Releases · Expert-Vision-Software/aurelia-expert
v1.0.0
Changed
- Upgraded to the OpenCode v2 plugin system. The plugin entrypoint is now an Effect-first
Plugin.define({ id, effect })insrc/plugin.ts, default-re-exported fromindex.ts; the rootplugin.tsshim is removed and dropped fromfiles, andpackage.jsondeclarescontent: "code"withexportsfor both.and./server. This replaces the v1config()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/pluginatlatest(2.0.26);effectintentionally stays on the^4.0.0-rc.112caret the entire@opencodeplugin stack pins —latest(4.0.2) would fork Effect across the plugin boundary. - Installer writes v2-native config keys.
bunx aurelia-expert installaddsaurelia-expert@latestto thepluginsarray and grants skills via the orderedpermissionsruleset ({ action: "skill", resource: "<skill-id>", effect: "allow" }); uninstall cleans bothpluginsand a legacypluginentry. Detection readspluginsfirst and falls back read-only to the legacy singularpluginkey, so v1-era registrations are not duplicated. - Load-time installs never write consumer config. Permission-ruleset writes and legacy
permission.skillmigration 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/permissionsmutations 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@latestsnippets, and the install snippets and load-contract description now teach thepluginsarray; CONTRIBUTING is rewritten against the current surface (v1plugin-key snippet and stale v1 prose removed); the release workflow verifies the publishable tarball withnpm pack --dry-runbefore 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@latestper policy). Theskills: { paths: [...] }entry was dropped —.agents/skillsis 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/pluginentries that arefile://URLs or filesystem paths resolving to this package — the package root, an entrypoint file such asindex.ts, apackage.json, or a symlink — by the resolvedpackage.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 installrecognizes existing path-form entries instead of adding a duplicate npm-name entry beside them. bunx aurelia-expert clear-cacheplus 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 globalconfig.jsonmentions 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.tsandtests/fixture-config-schema.test.tsharness the v2 host contract and@opencode/schemaConfig.Infodecoding;tests/config-splice.test.tsandtests/advisory.test.tspin 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.skillmigration are CLI-only (refines ADR-0005's installer-owns-config principle).
v0.6.0
Changed
- Surgical config writes.
writeJsonConfigno longer parses-and-reserializes consumer configs. A newConfigSpliceWriter(+JsoncScanner) splices only the missingpluginentries /permission.skillgrants into the raw text, preserving comments, indentation, key order, and unrelated bytes; ambiguous or unscannable shapes abort with a warning instead of rewriting. Handlesopencode.jsoncend to end. - jsonc-aware scope detection. Registration detection now reads
opencode.jsonandopencode.jsonc(global config, repo.opencode/, repo root). An existing-but-unparseable candidate yields anunknowncontext that short-circuits the load path with zero writes and a warning, instead of being silently treated as unregistered. - Permission writes are CLI-only. The load path never writes
permission.skillgrants anymore;ensureSkillPermissionsruns only on explicitbunx aurelia-expert install. - Deployment plan declared.
package.jsonnow carries"content": "code".bunx aurelia-expert install --mode copyraisesCopyModeUnsupportedError— code-backed packages register only;--mode registerremains the default. - Hook implementation moved under
src/. Rootplugin.tsis now a one-line re-export ofsrc/plugin.ts; all code lives undersrc/. - Release workflow verifies the tarball. The publish job runs
npm pack --dry-runand asserts the expected file set (index.ts, plugin.ts, src, skills, README.md, AGENTS.md, CHANGELOG.md, LICENSE) beforenpm publish.
Fixed
- The load hook can no longer throw into OpenCode startup. The entire
config()body is wrapped; a failure emits a remediation advisory (bunx aurelia-expert install --scope global|local, the exact~/.cache/opencode/packages/aurelia-expert@<version>dir, andbunx aurelia-expert clear-cache) guarded by its own once-guard, independent of the install advisory. - Missing bundled assets fail loudly and completely. A missing skill directory raises
MissingSkillAssetErrornaming the package version, the missing path, the cache directory, and the remediation commands, instead of a rawENOENT. - Cache hygiene. New
bunx aurelia-expert clear-cachesubcommand removes this package's current and stale@<version>cache directories. - README badge row collapsed to a single line directly below the heading; all eight SKILL.md frontmatter values are now double-quoted (colon-space guard and dispatch keys intact); CONTRIBUTING.md rewritten for the manifest-gated /
RegistrationDetectorera.
Added
- Contract tests for the new guarantees: jsonc detection and comment-preserving splices, byte-preservation of unrelated config bytes, unknown-config zero-writes, loud asset-absence errors, load-path no-writes (plugin arrays and permissions), hook never throwing with exactly-once advisories,
--mode copyrejection, andclear-cachebehavior.
v0.5.2
Changed
- Dev
.opencode/opencode.jsonnow registers theopencode-architectplugin by package name instead of a machine-specificfile:///path.
v0.5.1
Changed
- Root-config migration is now opt-in.
bunx aurelia-expert installno longer migrates a legacy rootopencode.jsonto.opencode/opencode.jsonimplicitly; pass--migrate-root-configto enable it (or--no-migrate-root-configto be explicit). Unparseable-config blocking behavior is unchanged.
Fixed
- Conformance hardening against the opencode-architect checklist: README badge row completed with Bun runtime and platforms badges; skill frontmatter
ground-truthURL values double-quoted for full YAML hygiene (descriptions untouched — em-dash separators preserved, colon-space guard intact).
v0.5.0
Changed
- Load-time installation rebuilt to the scope-aware, manifest-gated model.
plugin.ts#config()now detects where the plugin is registered — global config, repo.opencode/opencode.json, or a repo-rootopencode.json— using semantic,@latest-aware name matching (RegistrationDetector,src/registration.ts), then ensures the skills only in the detected scope(s). Detection is read-only. - Manifest-gated idempotency shared by the CLI and the load path. Each install writes
<configBase>/aurelia-expert.manifest.jsonwith per-file sha256 hashes. Present manifest + matching version + matching hashes → zero-write no-op; version drift → upgrade that scope only; consumer-modified files → skip + warn at load, overwrite only with CLI--force..versionmarkers are obsolete and reconciled/removed on first manifest-era install.
Fixed
- Cross-scope leak and dead fast path in the load hook. The old
ScopeResolverkeyed off the launch directory (which opencode always sets to the consumer repo), and the local fast path checked a marker at<repo>/skills/…while the installer wrote to<repo>/.opencode/skills/…— so every start reinstalled unconditionally. Hard invariants now enforced and tested: no cross-scope writes, the hook never editspluginarrays, rootopencode.jsonmigration is CLI-only, unparseable configs abort with a warning and are preserved byte-for-byte (never rewritten from{}), and plugin references are written canonically asaurelia-expert@latestwith semantic dedup.
v0.4.0
Added
- Skill content synced to Aurelia
2.0.0-rc.1/2.0.0-rc.2(validated against DeepWiki + raw source):useEagerLoadingrouter option, containerless<au-viewport>support,canUnloadroute-context restoration, writableRouteNode.title, task-queue timed slices withtasksSettled()andTaskQueueAggregateError(events-tasks.md), and the deprecated built-in.email()validation rule with its RFC-compliant replacement (validation.md).
Changed
.delegateand.callare removed from the v2 binding command set entirely — for custom AND native DOM events alike (source-verified inpackages/template-compiler/src/binding-command.ts; AUR0713's help text states the removal). All ~59 skill-body statements claiming ".delegatestays valid for native DOM events" corrected across 15 files;.capturedocumented as the capture-phase command and lambdas as the.callreplacement;@aurelia/compat-v1'scompatRegistrationnoted as the incremental-migration escape hatch.AGENTS.mdcritical rule 1 and the skill_content_rules ERROR-CODE taxonomy now scope the AUR0713 rule to.delegateon any event (previously "custom events" only).
Fixed
- DI error-code audit (DeepWiki +
kernel/template-compilersource):AUR0010corrected to "intrinsic type used as a DI token" (was "resolve() of unregistered token"); new rows forAUR0012(interface with no registration/default) andAUR0017(same vianewInstanceOf/newInstanceForScope, PR #2438);AUR0019corrected to invalid Event Aggregatorpublishevent name/instance;AUR0022corrected to@injecton an unsupported target type; containerless + Shadow DOM re-mapped fromAUR0901to the realAUR0501;AUR0907corrected to dialog cancel-with-rejectOnCancel(no error code exists for hyphen-less element names — kebab-case stays as a convention guardrail).AUR0713row broadened to "unknown binding command" with the verified valid-command list;AUR0177row sharpened to the confirmed destructuring triggers (nested patterns, duplicate locals, reserved names). @injectDEPRECATED violations: all remaining "removed"/"does not work"/"never" statements corrected to the canonical "deprecated —resolve()preferred":di.md(×2),au-northwind-pointer.md("Never use" list),ai-tooling.mdscaffold prompt,README.md("is gone in v2"),v1-removals.md(FORBIDDEN framing + example comment),components.mdcontamination list.
v0.3.0
Added
- New bundled skill
aurelia-ecosystem— leading word wire, seventh pillar (eighth skill overall). Owns the first-party plugin and runtime-ecosystem surface ported and adapted from the vendoraurelia/skillspackage:@aurelia/fetch-client(HTTP),@aurelia/validation,@aurelia/dialog,@aurelia/state,@aurelia/i18n, forms (model.bind/matcher.bind/submit.trigger:prevent), Vitest +@aurelia/testingcomponent testing, and SSR/prerendering (aurelia2-ssr, remount takeover, hydration, sitemap/robots). Each ported reference carries an upstream-lineage comment and adapts to this package's guardrails (resolve()DI,dispose-hook cleanup forIEventAggregator, narrow.stylerule, prohibitions deferred toaurelia-migration/reference/v1-removals.md). - New
aurelia-foundation/reference/cli.md— the deepernpx makes aureliafeature-flag reference (scaffold pillar), linked from the foundation reference table. - Router (
aurelia-expert) gains a seventh branch ladder position:wire → aurelia-ecosystemafterpackage. Description, branch table, pillar-location tree, and handoff block updated.
Changed
src/installer.tsSKILL_NAMESandtests/skills.test.tsSKILL_NAMES+REFERENCE_FILESnow includeaurelia-ecosystem(andcli.mdunderaurelia-foundation); the installer copies the new skill on every install/uninstall cycle and the test suite asserts every reference file is non-empty.- Removed the misguided
.opencode/opencode.json pre-allowsself-config test fromtests/skills.test.ts. The repo's.opencode/opencode.jsonis a dev-only config (not shipped viapackage.json#files; does not reference the package's own skills). Consumerpermission.skillallow-listing for every bundled skill is written byInstaller.ensureSkillPermissionsat install time and is already verified bytests/installer.test.ts("writes permission.skill.allow for every bundled skill").
Fixed
- Dangling
aurelia-testingdeferrals inaurelia-largespa/SKILL.mdandaurelia-migration/SKILL.mdnow point toaurelia-ecosystem(testing reference). The two pillars previously deferred to a non-existentaurelia-testingskill.
v0.2.0
Added
- New bundled skill
aurelia-component-library— leading word assemble, sixth pillar. Owns the styled, variable-driven component-library workflow on Aurelia v2 + Tailwind: design-token layer (CSS custom properties on the root element with the Tailwind@themebridge),shared/components/ui/library layout with theui-element prefix, component anatomy (@bindablevariants/sizes,<au-slot>projection in Light DOM,.styleproperty binding), a greenfield deploy procedure, and a migrate-existing procedure with a v1-source gate that defers toaurelia-migration(lift) before any structural move. - Router (
aurelia-expert) gains a fifth branch ladder position:assemble → aurelia-component-librarybetweenresolveandslice. The skill table, branch table, pillar-location tree, and precedence note all updated; precedence clarifies that mixed library + v1 prompts go toliftfirst (the more constrained case wins), thenassemblefor the lifted v2 code. - New bundled skill
aurelia-plugin— leading word package, seventh pillar. Owns the distributable-plugin workflow on Aurelia v2: theregister(container)duck-typed entry point, the.customize()options pattern withDI.createInterfacetokens, global resource registration with plugin-name prefixes, AppTask lifecycle hooks, rendering-pipeline extensions (IRenderer/@renderer,IRendering,registerHostNode), npm distribution (peerDependenciesonaurelia, dual ESM/CJS +.d.ts, explicit?rawtemplate imports,types/assets.d.ts), and an extract procedure (component-library / feature-slice / shared-dir → plugin) with a v1-source gate that defers toaurelia-migration(lift) before any packaging move. - Router (
aurelia-expert) gains a sixth branch ladder position:package → aurelia-pluginafterlift. Branch table, pillar-location tree, and precedence notes updated; three new precedence sub-rules disambiguate plugin vs component-library, largespa, and migration (v1 source → lift first). aurelia-expertrouter gains a ground-truth note: for SDK and API questions, prefer GitHub (aurelia/aureliamasterbranch) as canonical source for the latest. DeepWiki (deepwiki_ask_questionagainstaurelia/aurelia) is the preferred validator; docs.aurelia.io is fallback for overview content only.AGENTS.mdgains a<skill_content_rules>section with five codified lessons from a systematic DeepWiki validation sweep of all seven skills: source hierarchy (GitHub > DeepWiki > docs.aurelia.io > NotebookLM), error-code confirmation requirement,@injectseverity levels (REMOVED / DEPRECATED / ERROR CODE),.stylebinding narrow rule (not blanket prohibition), anddisposeas the mandatoryIEventAggregatorcleanup hook.
Changed
src/installer.tsSKILL_NAMESarray andtests/skills.test.tsSKILL_NAMES+REFERENCE_FILESnow includeaurelia-component-libraryandaurelia-plugin; the installer copies them on every install/uninstall cycle and the test suite asserts every reference file is non-empty..opencode/opencode.jsonpermission allow-list extended to seven skills.
Fixed
- AUR0009 → AUR0713 (compile-time):
.delegateon custom events throws AUR0713 (template compilation error), not AUR0009. All 25 occurrences corrected acrossreference/v1-removals.md,reference/debugging.md,skills/aurelia-runtime/SKILL.md,skills/aurelia-foundation/SKILL.md,skills/aurelia-plugin/SKILL.md,skills/aurelia-migration/SKILL.md, and all affected reference files. This was a v1-era error code that did not exist in the v2 template compiler. @injectreclassified as DEPRECATED:@injectis still valid in Aurelia v2 — it is not REMOVED. All skill bodies that stated "never use@inject" or "does not appear anywhere in v2" corrected to "preferresolve()(still valid but idiomatic v2)". The v1-removals table now says DEPRECATED — preferresolve(); the canonical severity levels inreference/v1-removals.mdare the source of truth and must not be contradicted in skill bodies..stylebinding — narrow rule, not blanket prohibition: Inlinestyle="width: ${value}%"is safe when the value is guaranteed non-falsy; the prod-optimizer bug only triggers for0/false/''. Four skill files that said "never inline style=" corrected to the precise conditional: prefer.stylebinding when the interpolated value can be falsy.IEventAggregatordisposal —dispose, notunbinding:disposeis the mandatory permanent cleanup hook forIEventAggregatorsubscriptions;unbindingruns before potential reactivation and is insufficient. Foundation pillar guardrail corrected; all skill bodies updated accordingly.- All skill-count references corrected: README.md (SEO title, H1, intro paragraph, v1-contamination bullet), package.json description,
aurelia-plugin/SKILL.mdV1 contamination section, andau-northwind-pointer.mdnow accurately state 7 skills / 6 pillars / 6 prohibited + 1 deprecated v1 pattern. - Description fields on
aurelia-foundation,aurelia-runtime, andaurelia-migrationSKILL.md frontmatter use em-dash (—) instead of colon-space (:) to avoid the YAML nested-mapping parse error in the skills CLI.
v0.1.0
Added
- Initial release of the
aurelia-expertOpenCode plugin + npm skill bundle. - Five router-routed Aurelia v2 MVVM skills:
aurelia-expert— leading word branch, dispatches to the right pillar.aurelia-foundation— leading word scaffold, philosophy, quickstart, components, lifecycle, AI tooling.aurelia-runtime— leading word resolve, DI, routing, events/tasks, cross-feature orchestration.aurelia-largespa— leading word slice (focal point), feature-first layout, hierarchicalAgents.md, orchestrator pattern, Model/DTO boundary.aurelia-migration— leading word lift, v1→v2 removals, debugging, performance, DeepWiki citation protocol.
plugin.tsOpenCode plugin factory with version-marker gatedconfig()hook that auto-installs on first load.src/installer.tsInstallerclass withinstall(),uninstall(),status(), idempotent version-marker copy, permission pre-grant, plugin entry add/remove, andmigrateRootConfig()for legacyopencode.json→.opencode/opencode.jsonmigration.src/plugin-name.tsPluginNameNormalizerclass with case-insensitive@<version>stripping (scoped-package safe).src/scope-resolver.tsScopeResolverclass that resolves local vs global scope from the plugin's working directory (cross-platform path separator).src/cli.tsBun-runnable CLI withinstall,uninstall,statussubcommands (no interactive prompts; CI-friendly)..opencode/opencode.jsonself-config registering../skillsand pre-allowing all 5 skills..github/workflows/release.ymltwo-job pipeline: GitHub Release (notes extracted fromCHANGELOG.md) +npm publish --provenance --access public.- Test suites:
tests/skills.test.ts(frontmatter + reference-file assertions, plugin-name normalization round-trip),tests/installer.test.ts(mocked temp project + global dirs, install/uninstall/status round-trips, idempotency, legacy migration). - MIT license,
AGENTS.mdmaintainer contract,CONTRIBUTING.mddeveloper guide,README.mdwith three-channel install story.