diff --git a/builds/packages/base/internetworking/README.md b/builds/packages/base/internetworking/README.md index 136e1b1..3f09b0b 100644 --- a/builds/packages/base/internetworking/README.md +++ b/builds/packages/base/internetworking/README.md @@ -73,6 +73,7 @@ The core package intentionally ships only compact, curated static registries wit - `computecommons-data-iana` for complete IANA protocol, port, and media-type registries - `computecommons-data-pci` for PCI vendor and device identifiers - `computecommons-data-usb` for USB vendor and product identifiers +- `computecommons-data-oui` for IEEE OUI and MAC address assignment data ## Package boundaries diff --git a/builds/packages/base/internetworking/src/computecommons/static/architectures.py b/builds/packages/base/internetworking/src/computecommons/static/architectures.py index 4227241..1f38be6 100644 --- a/builds/packages/base/internetworking/src/computecommons/static/architectures.py +++ b/builds/packages/base/internetworking/src/computecommons/static/architectures.py @@ -9,7 +9,9 @@ ARCHITECTURE_ALIASES_METADATA = RegistryMetadata( name="architecture-aliases", source="Curated aliases for common CPU architectures", - version="0.1.0", + source_url="package://computecommons/static/architectures.py", + package_curation_version="0.1.0", + compactness_notes="Hand-picked aliases for common runtime and packaging architecture names.", published_at="2026-07-15", ) diff --git a/builds/packages/base/internetworking/src/computecommons/static/filesystems.py b/builds/packages/base/internetworking/src/computecommons/static/filesystems.py index f469aa2..ff311e2 100644 --- a/builds/packages/base/internetworking/src/computecommons/static/filesystems.py +++ b/builds/packages/base/internetworking/src/computecommons/static/filesystems.py @@ -17,7 +17,9 @@ class Filesystem: FILESYSTEMS_METADATA = RegistryMetadata( name="filesystems", source="Curated aliases for common filesystems", - version="0.1.0", + source_url="package://computecommons/static/filesystems.py", + package_curation_version="0.1.0", + compactness_notes="Compact list of common local, server, and image filesystems only.", published_at="2026-07-15", ) diff --git a/builds/packages/base/internetworking/src/computecommons/static/media_types.py b/builds/packages/base/internetworking/src/computecommons/static/media_types.py index 4f8ee2d..ac08d41 100644 --- a/builds/packages/base/internetworking/src/computecommons/static/media_types.py +++ b/builds/packages/base/internetworking/src/computecommons/static/media_types.py @@ -22,6 +22,10 @@ def value(self) -> str: name="media-types", source="Curated subset of the IANA Media Types registry", source_url="https://www.iana.org/assignments/media-types/media-types.xhtml", + package_curation_version="0.1.0", + compactness_notes=( + "Subset limited to frequently encountered application, text, and image media types." + ), retrieved_at="2026-07-15", ) diff --git a/builds/packages/base/internetworking/src/computecommons/static/metadata.py b/builds/packages/base/internetworking/src/computecommons/static/metadata.py index 8b970c8..c9c3762 100644 --- a/builds/packages/base/internetworking/src/computecommons/static/metadata.py +++ b/builds/packages/base/internetworking/src/computecommons/static/metadata.py @@ -5,11 +5,18 @@ @dataclass(frozen=True, slots=True) class RegistryMetadata: - """Provenance metadata for a compact static registry.""" + """Provenance and curation metadata for a compact static registry. + + Static registries in the core package are intentionally small, curated + snapshots. Complete externally maintained registries should be distributed + through optional data packages instead of being embedded here. + """ name: str source: str + package_curation_version: str + compactness_notes: str source_url: str | None = None - version: str | None = None + source_version: str | None = None published_at: str | None = None retrieved_at: str | None = None diff --git a/builds/packages/base/internetworking/src/computecommons/static/operating_systems.py b/builds/packages/base/internetworking/src/computecommons/static/operating_systems.py index f0ec5ee..d17132f 100644 --- a/builds/packages/base/internetworking/src/computecommons/static/operating_systems.py +++ b/builds/packages/base/internetworking/src/computecommons/static/operating_systems.py @@ -18,7 +18,12 @@ class OperatingSystemRelease: OPERATING_SYSTEMS_METADATA = RegistryMetadata( name="operating-systems", source="Curated aliases for common operating-system releases and families", - version="0.1.0", + source_url="package://computecommons/static/operating_systems.py", + package_curation_version="0.1.0", + compactness_notes=( + "Representative OS families and releases used for normalization, " + "not a distribution catalog." + ), published_at="2026-07-15", ) diff --git a/builds/packages/base/internetworking/src/computecommons/static/ports.py b/builds/packages/base/internetworking/src/computecommons/static/ports.py index d1fec3c..ad50beb 100644 --- a/builds/packages/base/internetworking/src/computecommons/static/ports.py +++ b/builds/packages/base/internetworking/src/computecommons/static/ports.py @@ -23,6 +23,8 @@ def __post_init__(self) -> None: name="well-known-ports", source="Curated subset of the IANA Service Name and Transport Protocol Port Number Registry", source_url="https://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.xhtml", + package_curation_version="0.1.0", + compactness_notes="Subset limited to foundational well-known ports needed by core helpers.", retrieved_at="2026-07-15", ) diff --git a/builds/packages/base/internetworking/src/computecommons/static/protocols.py b/builds/packages/base/internetworking/src/computecommons/static/protocols.py index cee4c35..cfafebe 100644 --- a/builds/packages/base/internetworking/src/computecommons/static/protocols.py +++ b/builds/packages/base/internetworking/src/computecommons/static/protocols.py @@ -8,6 +8,10 @@ name="ip-protocol-numbers", source="Curated subset of the IANA Protocol Numbers registry", source_url="https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml", + package_curation_version="0.1.0", + compactness_notes=( + "Subset limited to common IP protocol numbers used by lightweight networking models." + ), retrieved_at="2026-07-15", ) diff --git a/builds/packages/base/internetworking/src/computecommons/static/vendors.py b/builds/packages/base/internetworking/src/computecommons/static/vendors.py index e3f6caa..8fb452a 100644 --- a/builds/packages/base/internetworking/src/computecommons/static/vendors.py +++ b/builds/packages/base/internetworking/src/computecommons/static/vendors.py @@ -16,7 +16,12 @@ class Vendor: VENDORS_METADATA = RegistryMetadata( name="vendors", source="Curated aliases for common compute vendors", - version="0.1.0", + source_url="package://computecommons/static/vendors.py", + package_curation_version="0.1.0", + compactness_notes=( + "Small alias set for common compute vendors; PCI, USB, and OUI identifiers " + "are out of core." + ), published_at="2026-07-15", ) diff --git a/builds/packages/base/internetworking/tests/test_static.py b/builds/packages/base/internetworking/tests/test_static.py index 570a012..7a44629 100644 --- a/builds/packages/base/internetworking/tests/test_static.py +++ b/builds/packages/base/internetworking/tests/test_static.py @@ -57,6 +57,9 @@ def test_static_registry_metadata_is_present() -> None: "well-known-ports", } assert all(item.source for item in metadata) + assert all(item.source_url for item in metadata) + assert all(item.package_curation_version == "0.1.0" for item in metadata) + assert all(item.compactness_notes for item in metadata) with pytest.raises(FrozenInstanceError): WELL_KNOWN_PORTS_METADATA.name = "other" # type: ignore[misc]