cf_package_contracts

cf_package_contracts is the single public C/C++ contract surface for Cogniflow pipeline runtime interaction.

Downstream native consumers resolve the packaged include directory through:

import cf_package_contracts

cf_package_contracts.cf_contracts_include_path()

Publishing

cf-package-contracts is published with the dedicated Windows workflow:

• Workflow: .github/workflows/cf_package_contracts_windows_publish.yml
• Package directory: sandcastle/cf_package_contracts
• PyPI tag: cf-package-contracts-v<version>
• TestPyPI tag: cf-package-contracts-v<version>-test
• Release order: publish this package before first-party native consumers

Local preflight:

powershell -ExecutionPolicy Bypass -File scripts/mimic_windows_python_publish_workflow.ps1 `
  -WorkflowFile .github/workflows/cf_package_contracts_windows_publish.yml `
  -PackageDir sandcastle/cf_package_contracts `
  -PythonExe py `
  -PythonVersion 3.14

Queue a dry-run dispatch:

powershell -ExecutionPolicy Bypass -File scripts/queue_windows_python_publish_workflow.ps1 `
  -WorkflowFile .github/workflows/cf_package_contracts_windows_publish.yml `
  -PackageDir sandcastle/cf_package_contracts `
  -PublishTarget none `
  -Ref main `
  -RequireLocalPass `
  -DryRun `
  -ReleaseTag cf-package-contracts-v0.1.0