Metadata-Version: 2.4
Name: cf-package-contracts
Version: 0.1.0
Summary: Cogniflow public pipeline runtime contracts and native headers.
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Provides-Extra: test
Requires-Dist: pytest<9.0,>=8.0; extra == "test"

# 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:

```python
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
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
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
```
