Skip to content

docs(deps): establish monitoring_system as canonical vcpkg port registry#540

Merged
kcenon merged 1 commit into
mainfrom
chore/issue-533-vcpkg-port-management-sot
Mar 15, 2026
Merged

docs(deps): establish monitoring_system as canonical vcpkg port registry#540
kcenon merged 1 commit into
mainfrom
chore/issue-533-vcpkg-port-management-sot

Conversation

@kcenon

@kcenon kcenon commented Mar 15, 2026

Copy link
Copy Markdown
Owner

What

Formally documents monitoring_system/vcpkg-ports/ as the single source of
truth for all eight kcenon vcpkg port definitions.

Changes

File Change Type
docs/guides/PORT_MANAGEMENT.md New — authoritative port management strategy
docs/guides/VCPKG_OVERLAY_PORTS.md Updated — all 8 ports, corrected notes
vcpkg-ports/README.md Updated — canonical registry framing, full inventory

Why

Three locations previously held port definitions (central registry, stale local
copies in individual repos, remote registry) with no documented ownership.
Contributors had no clear guidance on which port to update and why.

  • Stale SHA512 0 placeholders in database_system, network_system, and
    pacs_system gave a false impression of vcpkg readiness in those repos
  • VCPKG_OVERLAY_PORTS.md incorrectly stated "SHA512 hashes are placeholder
    values" even though the central ports have had real hashes for some time
  • No documented procedure for updating ports across an upstream release

Relates to #533

How

Implementation

  1. PORT_MANAGEMENT.md (new): Records the Option A decision (centralize in
    monitoring_system), documents the full port update procedure with exact
    commands, consumer repo setup options, the stale-port cleanup requirement
    for other repos, and the relationship between this directory and
    kcenon/vcpkg-registry.git

  2. vcpkg-ports/README.md: Updated to list all 8 canonical ports with
    their current versions, port-versions, and patch inventory; replaces
    vague overlay-ports framing with explicit "canonical registry" language

  3. VCPKG_OVERLAY_PORTS.md: All 8 ports in the available-ports table;
    corrected dependency graph (includes database/network/pacs); removed the
    outdated placeholder SHA512 note; added consumer repo and port update
    cross-references

Acceptance Criteria Status

  • Port management strategy chosen and documented (PORT_MANAGEMENT.md)
  • Single authoritative location for each port definition (this repo)
  • Port update procedure documented (PORT_MANAGEMENT.md §Port Update Procedure)
  • CI validates port builds from the canonical location (existing validate-vcpkg-chain workflow)
  • Stale local ports removed from database_system / network_system / pacs_system — tracked in PORT_MANAGEMENT.md §Stale Local Ports, requires separate PRs to those repos

Testing

No code changes — documentation only. The validate-vcpkg-chain workflow
will confirm that existing ports still build correctly.

Closes #533

Document monitoring_system/vcpkg-ports/ as the single source of truth for
all eight kcenon ecosystem port definitions, replacing the previous implicit
arrangement with an explicit, documented strategy.

- Add PORT_MANAGEMENT.md: records the centralization decision, port update
  procedure (hash, portfile, vcpkg.json, sync to registry), consumer repo
  setup, and cleanup requirements for stale local ports in database_system,
  network_system, and pacs_system

- Update vcpkg-ports/README.md: list all 8 canonical ports with versions,
  port-versions, and patch inventory; replace vague "overlay ports" framing
  with "canonical registry" language; add CI validation note

- Update VCPKG_OVERLAY_PORTS.md: reflect all 8 ports in the available-ports
  table; correct the full dependency graph including database/network/pacs;
  remove the outdated "SHA512 hashes are placeholder values" note; add
  consumer repo setup and port update cross-references

Closes #533
@kcenon kcenon merged commit 95820ff into main Mar 15, 2026
29 checks passed
@kcenon kcenon deleted the chore/issue-533-vcpkg-port-management-sot branch March 15, 2026 09:22
kcenon added a commit that referenced this pull request Apr 13, 2026
…try (#540)

Document monitoring_system/vcpkg-ports/ as the single source of truth for
all eight kcenon ecosystem port definitions, replacing the previous implicit
arrangement with an explicit, documented strategy.

- Add PORT_MANAGEMENT.md: records the centralization decision, port update
  procedure (hash, portfile, vcpkg.json, sync to registry), consumer repo
  setup, and cleanup requirements for stale local ports in database_system,
  network_system, and pacs_system

- Update vcpkg-ports/README.md: list all 8 canonical ports with versions,
  port-versions, and patch inventory; replace vague "overlay ports" framing
  with "canonical registry" language; add CI validation note

- Update VCPKG_OVERLAY_PORTS.md: reflect all 8 ports in the available-ports
  table; correct the full dependency graph including database/network/pacs;
  remove the outdated "SHA512 hashes are placeholder values" note; add
  consumer repo setup and port update cross-references

Closes #533
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

chore(deps): Establish single source of truth for vcpkg port management

1 participant