Summary

Standardize vcpkg.json files across all unified_system modules to enable consistent vcpkg package distribution and resolve ecosystem dependency declarations.

5W1H Specification

• Who: All unified_system maintainers (common, thread, container, logger, monitoring, network, database, messaging)
• What: Standardize vcpkg.json structure, add missing ecosystem dependencies, resolve documentation inconsistencies
• Where: vcpkg.json and README.md files across all ecosystem repositories
• When: Target Q1 2025 release cycle
• Why:
  • Enable vcpkg registry distribution (public or private)
  • Prevent build failures from undeclared dependencies
  • Ensure consistent versioning and licensing across ecosystem
• How:
  1. Define vcpkg.json template standard
  2. Add missing ecosystem dependencies to each system
  3. Resolve document-code inconsistencies
  4. Validate with vcpkg manifest mode builds

vcpkg.json Standard Template

{
  "$schema": "https://raw.githubusercontent.com/microsoft/vcpkg-tool/main/docs/vcpkg.schema.json",
  "name": "kcenon-{system-name}",
  "version": "x.y.z",
  "port-version": 0,
  "description": "Description of the system",
  "homepage": "https://github.com/kcenon/{system-name}",
  "license": "BSD-3-Clause",
  "supports": "!(uwp | xbox)",
  "dependencies": [
    "kcenon-common-system"
  ],
  "features": {
    "testing": {
      "description": "Build unit tests",
      "dependencies": [
        { "name": "gtest", "features": ["gmock"] }
      ]
    }
  }
}

Implementation Status

Tier 1: Foundation Layer ✅ COMPLETED

Tier 2: Foundation Layer Dependencies ✅ COMPLETED

Tier 3: Core Layer ✅ COMPLETED

Tier 4: Core Layer Extended ✅ COMPLETED

Tier 5: Application Layer ✅ COMPLETED

Ecosystem Dependency Matrix

common_system (0 deps) ✅ COMPLETED
    ↓
thread_system → common_system ✅ COMPLETED
container_system → common_system ✅ COMPLETED
    ↓
logger_system → common_system, thread_system(opt) ✅ COMPLETED
monitoring_system → common_system, thread_system ✅ COMPLETED
    ↓
network_system → common, thread, logger, container ✅ COMPLETED
database_system → common, thread, logger, container, monitoring ✅ COMPLETED
    ↓
messaging_system → 6 systems ✅ COMPLETED

Acceptance Criteria

• All vcpkg.json files follow standard template
• All ecosystem dependencies declared correctly
• README and vcpkg.json C++ standard version match
• All systems use BSD-3-Clause license consistently
• vcpkg manifest mode build succeeds for all systems
• Documentation reflects actual dependency requirements

Progress Summary

Overall Progress: 8/8 completed (100%) ✅

Related Work

• Epic: Cross-Module Circular Dependency Resolution #232 Epic: Cross-Module Circular Dependency Resolution (completed)
• vcpkg: Standardize vcpkg.json and resolve documentation inconsistencies #252 Standardize vcpkg.json for common_system (closed by refactor(vcpkg): standardize vcpkg.json and resolve documentation inconsistencies #253)
• Future: vcpkg registry submission