cleveragents/cleveragents-core
4
0
Fork 3
Code Issues 6.0k Pull Requests 115 Actions Packages Projects Releases Wiki Activity

feat(resource): add virtual resource equivalence tracking #664

Closed
hamza.khyari wants to merge 1 commits from feature/m7-post-resource-equivalence into master
pull from: feature/m7-post-resource-equivalence
merge into: cleveragents:master
Conversation 10 Commits 1 Files Changed 31
+3841 -18

1 Commits

Author SHA1 Message Date
hamza.khyari 29b62587f9 feat(resource): add virtual resource equivalence tracking
CI / helm (pull_request) Successful in 23s
Details
CI / build (pull_request) Successful in 25s
Details
CI / lint (pull_request) Successful in 3m18s
Details
CI / quality (pull_request) Successful in 3m40s
Details
CI / typecheck (pull_request) Successful in 3m57s
Details
CI / security (pull_request) Successful in 4m5s
Details
CI / unit_tests (pull_request) Successful in 9m37s
Details
CI / docker (pull_request) Successful in 1m32s
Details
CI / coverage (pull_request) Successful in 12m36s
Details
CI / integration_tests (pull_request) Successful in 24m32s
Details
CI / e2e_tests (pull_request) Failing after 10m11s
Details
CI / status-check (pull_request) Failing after 1s
Details
CI / benchmark-publish (pull_request) Has been skipped
Details
CI / benchmark-regression (pull_request) Successful in 55m58s
Details 
Virtual-to-physical resource equivalence linking system for tracking
which physical resources are manifestations of the same virtual identity.

Database:
- VirtualResourceLinkModel ORM with ULID PK, FK cascades, unique
  constraint on (virtual_resource_id, physical_resource_id), CHECK
  constraints on link_type and confidence, 4 indexes
- Alembic migration: m7_001_virtual_resource_links.py (depends on
  m8_002_merge_profile_rename_and_corrections)

Domain model:
- LinkType enum (content_hash, name, identity)
- VirtualResourceLink frozen Pydantic model with confidence [0.0-1.0]

Service (ResourceEquivalenceService — 498 lines):
- create_link() with type-mismatch guard via ALLOWED_PAIRINGS
- remove_link() by virtual+physical ID pair
- list_links() with pagination (limit/offset)
- merge_virtual_resources() — batch N+1-free with IntegrityError guard
- check_divergence() — removes stale content_hash links
- reconcile() — delegated to _resource_equivalence_reconciler.py

Helpers (_resource_equivalence_helpers.py — 228 lines):
- compute_equivalence_key() for string content (SHA-256/name/identity)
- compute_equivalence_key_from_path() streaming file hash (64 KiB chunks)
- ALLOWED_PAIRINGS type compatibility map (unprefixed virtual type names)
- validate_link_inputs() shared validation

CLI (resource_equivalence.py):
- agents resource equivalence list (--virtual, --physical, --format)
- agents resource equivalence add (--key, --type, --confidence, --format)
- agents resource equivalence remove (--yes, --format)

Tests:
- 50 Behave scenarios (CRUD, merge, divergence, reconciliation, boundaries)
- 9 Robot integration tests
- 5 ASV benchmark suites

ISSUES CLOSED: #334
 2026-04-02 13:08:54 +00:00