cf-setup 0.1.3

Manifest-driven Cogniflow workspace setup orchestration

cf-setup

cf-setup is the first-party setup orchestrator for the Cogniflow Windows workspace.

It centralizes:

• module and profile definitions
• deterministic install planning
• PyPI-first vs editable source decisions
• Windows prerequisite diagnostics
• delegated native or frontend build steps
• post-install hooks
• structured installation reporting

Typical usage:

py -3.14 -m cf_setup plan --profile core --format json
py -3.14 -m cf_setup diagnose --provider windows --format json
py -3.14 -m cf_setup install --profile full --editable cf-pipeline-engine

The repository entrypoint remains scripts/fresh_install_v2.ps1, but it now acts as a thin Windows wrapper that bootstraps Python and delegates orchestration into cf_setup.

cf_setup now supports two practical modes:

• repository mode: used by scripts/fresh_install_v2.ps1 and local workspace maintainers
• distribution mode: used when cf install runs without a repository checkout and must rely on packaged manifest resources plus published package artifacts

In distribution mode, cf install now also prepares the user workspace under ~/.cogniflow/workspace by default, initializes the semantics DuckDB files, and runs installed-step ingestion so the environment is usable immediately after setup.

cf install --run-demo in distribution mode now runs a small published demo from packaged cf-pipeline-engine example resources. It uses the distribution workspace rather than repository paths and is intentionally smaller than the full repo-maintainer demo path.

Publishing

cf-setup is prepared for the dedicated Windows workflow:

• Workflow: .github/workflows/cf_setup_windows_publish.yml
• Package directory: sandcastle/cf_setup
• PyPI tag: cf-setup-v<version>
• TestPyPI tag: cf-setup-v<version>-test
• Release order: publish cf-core-cli 0.1.5 first, then cf-setup, then cogniflow

Local preflight:

powershell -ExecutionPolicy Bypass -File scripts/mimic_windows_python_publish_workflow.ps1 `
  -WorkflowFile .github/workflows/cf_setup_windows_publish.yml `
  -PackageDir sandcastle/cf_setup `
  -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_setup_windows_publish.yml `
  -PackageDir sandcastle/cf_setup `
  -PublishTarget testpypi `
  -Ref main `
  -RequireLocalPass `
  -DryRun `
  -ReleaseTag cf-setup-v0.1.3-test