feat(registry): implement reference resolution — parse refs, version aliases, local scheme #26

New issue

Open

opened 2026-06-05 17:34:10 +00:00 by CoreRasurae · 0 comments

CoreRasurae commented

2026-06-05 17:34:10 +00:00

Member

Metadata

Commit Message: feat(registry): implement ReferenceResolver with version alias resolution
Branch: feature/m1-registry-reference-resolver

Background and context

The Package Registry Standard v1.0.0 (§5.3, §4.2) defines three reference formats and a version resolution scheme with both immutable concrete versions and mutable aliases (latest, vx, vX.Y.x, vX.x). All three reserved schemes (ID:, registry:, local:) must be supported.

Part of Epic: Package Registry Client — Support Package Registry Standard v1.0.0

Current behavior

No reference parsing or version resolution exists. Templates use only simple name strings.

Expected behavior

ReferenceResolver.parse(ref_str: str) -> PackageReference handles all three schemes
registry.example.com:acme/search@v1.2.3 parses with all fields populated
ID:pkg_act_<40-hex> parses without server/namespace
local:./my-actor resolves to local package lookup
Missing @version defaults to latest
Version resolution resolves concrete and all alias types
original_reference preserved exactly as user typed

Acceptance criteria

All three reference schemes parse correctly
Version aliases resolve per §4.2 semantics
Invalid formats raise InvalidPackageReferenceError
original_reference survives round-trip through resolution

Subtasks

Create src/cleveractors/registry/resolver.py with ReferenceResolver class
Implement server:namespace/name@version parsing
Implement ID:pkg_xxx_<40-hex> parsing
Implement local: scheme parsing
Implement version resolution: concrete + all alias types
Integrate with RegistryClient for remote resolution
Tests (Behave): features/registry_reference_resolver.feature — all formats, edge cases, version matrices
Verify coverage >=97% via nox -s coverage_report
Run nox (all default sessions), fix any errors

Definition of Done

This issue is complete when:

All subtasks above are completed and checked off.
A Git commit is created where the first line matches the Commit Message in Metadata exactly.
The commit is pushed to the branch matching the Branch in Metadata exactly.
The commit is submitted as a PR to master, reviewed, and merged.

## Metadata Commit Message: feat(registry): implement ReferenceResolver with version alias resolution Branch: feature/m1-registry-reference-resolver ## Background and context The Package Registry Standard v1.0.0 (§5.3, §4.2) defines three reference formats and a version resolution scheme with both immutable concrete versions and mutable aliases (`latest`, `vx`, `vX.Y.x`, `vX.x`). All three reserved schemes (`ID:`, `registry:`, `local:`) must be supported. Part of Epic: Package Registry Client — Support Package Registry Standard v1.0.0 ## Current behavior No reference parsing or version resolution exists. Templates use only simple name strings. ## Expected behavior - `ReferenceResolver.parse(ref_str: str) -> PackageReference` handles all three schemes - `registry.example.com:acme/search@v1.2.3` parses with all fields populated - `ID:pkg_act_<40-hex>` parses without server/namespace - `local:./my-actor` resolves to local package lookup - Missing @version defaults to `latest` - Version resolution resolves concrete and all alias types - `original_reference` preserved exactly as user typed ## Acceptance criteria - All three reference schemes parse correctly - Version aliases resolve per §4.2 semantics - Invalid formats raise `InvalidPackageReferenceError` - `original_reference` survives round-trip through resolution ## Subtasks - [ ] Create `src/cleveractors/registry/resolver.py` with `ReferenceResolver` class - [ ] Implement `server:namespace/name@version` parsing - [ ] Implement `ID:pkg_xxx_<40-hex>` parsing - [ ] Implement `local:` scheme parsing - [ ] Implement version resolution: concrete + all alias types - [ ] Integrate with `RegistryClient` for remote resolution - [ ] Tests (Behave): features/registry_reference_resolver.feature — all formats, edge cases, version matrices - [ ] Verify coverage >=97% via nox -s coverage_report - [ ] Run nox (all default sessions), fix any errors ## Definition of Done This issue is complete when: - All subtasks above are completed and checked off. - A Git commit is created where the first line matches the Commit Message in Metadata exactly. - The commit is pushed to the branch matching the Branch in Metadata exactly. - The commit is submitted as a PR to master, reviewed, and merged.

CoreRasurae added this to the v2.1.0 milestone

2026-06-05 17:34:10 +00:00

~~CoreRasurae referenced this issue 2026-06-05 17:36:35 +00:00~~

Epic: Package Registry Client — Support Package Registry Standard v1.0.0 #22

~~CoreRasurae referenced this issue 2026-06-05 17:36:50 +00:00~~

feat(registry): implement async HTTP client using httpx #24

~~CoreRasurae referenced this issue 2026-06-05 17:36:52 +00:00~~

feat(registry): extend TemplateType and integrate PackageReference into template system #27

~~CoreRasurae referenced this issue 2026-06-05 17:36:55 +00:00~~

feat(registry): implement BDD test features and compliance test vectors #30

CoreRasurae added a new dependency

2026-06-05 17:41:10 +00:00

#22 Epic: Package Registry Client — Support Package Registry Standard v1.0.0

CoreRasurae changed title from ~~Reference resolution — parse references, version resolution, local scheme~~ to feat(registry): implement reference resolution — parse refs, version aliases, local scheme

2026-06-05 17:47:28 +00:00

CoreRasurae referenced this issue from a commit

2026-06-07 22:27:43 +00:00

feat(registry): implement ReferenceResolver with version alias resolution

CoreRasurae referenced this issue from a pull request that will close it,

2026-06-07 22:27:53 +00:00

feat(registry): implement ReferenceResolver with version alias resolution #37

CoreRasurae added reference feature/m1-registry-reference-resolver

2026-06-07 22:29:30 +00:00

CoreRasurae referenced this issue from a commit

2026-06-07 22:31:13 +00:00

feat(registry): implement ReferenceResolver with version alias resolution