cf-setup 0.1.0__tar.gz

cf_setup-0.1.0/PKG-INFO

@@ -0,0 +1,70 @@
+Metadata-Version: 2.4
+Name: cf-setup
+Version: 0.1.0
+Summary: Manifest-driven Cogniflow workspace setup orchestration
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Provides-Extra: test
+Requires-Dist: pytest<9.0,>=8.0; extra == "test"
+
+# 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:
+
+```powershell
+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
+
+## 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
+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
+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.0-test
+```

cf_setup-0.1.0/README.md

@@ -0,0 +1,61 @@
+# 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:
+
+```powershell
+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
+
+## 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
+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
+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.0-test
+```

cf_setup-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["setuptools>=70"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "cf-setup"
+version = "0.1.0"
+description = "Manifest-driven Cogniflow workspace setup orchestration"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = []
+
+[project.optional-dependencies]
+test = [
+    "pytest>=8.0,<9.0"
+]
+
+[project.scripts]
+cf-setup = "cf_setup.cli:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.package-data]
+cf_setup = ["install_manifest.toml"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["cf_setup*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = ["--basetemp=.pytest_tmp"]

cf_setup-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

cf_setup-0.1.0/src/cf_setup/__init__.py

@@ -0,0 +1,21 @@
+"""Cogniflow setup orchestration package."""
+
+from pathlib import Path
+
+__version__ = "0.1.0"
+PACKAGE_ROOT = Path(__file__).resolve().parent
+DEFAULT_MANIFEST_PATH = PACKAGE_ROOT / "install_manifest.toml"
+
+
+def find_repo_root(start: Path | None = None) -> Path | None:
+    candidate = (start or Path.cwd()).resolve()
+    search_roots = [candidate, *candidate.parents]
+    for root in search_roots:
+        if (root / "scripts" / "fresh_install_v2.ps1").exists() and (root / "sandcastle").exists():
+            return root
+    return None
+
+
+REPO_ROOT = find_repo_root(PACKAGE_ROOT)
+
+__all__ = ["__version__", "DEFAULT_MANIFEST_PATH", "REPO_ROOT", "find_repo_root"]

cf_setup-0.1.0/src/cf_setup/__main__.py

@@ -0,0 +1,5 @@
+from .cli import main
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

cf_setup-0.1.0/src/cf_setup/cli.py

@@ -0,0 +1,117 @@
+from __future__ import annotations
+
+import argparse
+import json
+from pathlib import Path
+import sys
+
+from . import DEFAULT_MANIFEST_PATH
+from .installer import build_options_from_namespace, detect_execution_mode, execute_install, manifest_path_from_args, output_payload, plan_installation
+from .providers.windows import WindowsProvider
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(prog="cf_setup", description="Cogniflow setup orchestration CLI")
+    subparsers = parser.add_subparsers(dest="command", required=True)
+
+    plan_parser = subparsers.add_parser("plan", help="Resolve profile modules and source decisions.")
+    plan_parser.add_argument("--repo-root")
+    plan_parser.add_argument("--manifest", default=str(DEFAULT_MANIFEST_PATH))
+    plan_parser.add_argument("--profile", default="full")
+    plan_parser.add_argument("--editable", action="append", default=[])
+    plan_parser.add_argument("--mode", choices=["auto", "repo", "distribution"], default="auto")
+    plan_parser.add_argument("--format", choices=["json"], default="json")
+    plan_parser.add_argument("--output")
+
+    diagnose_parser = subparsers.add_parser("diagnose", help="Report prerequisite diagnostics.")
+    diagnose_parser.add_argument("--provider", choices=["windows"], default="windows")
+    diagnose_parser.add_argument("--format", choices=["json"], default="json")
+    diagnose_parser.add_argument("--output")
+
+    install_parser = subparsers.add_parser("install", help="Execute the setup plan.")
+    install_parser.add_argument("--repo-root")
+    install_parser.add_argument("--manifest", default=str(DEFAULT_MANIFEST_PATH))
+    install_parser.add_argument("--profile", default="full")
+    install_parser.add_argument("--mode", choices=["auto", "repo", "distribution"], default="auto")
+    install_parser.add_argument("--python", default=sys.executable)
+    install_parser.add_argument("--editable", action="append", default=[])
+    install_parser.add_argument("--wheel-only", action=argparse.BooleanOptionalAction, default=True)
+    install_parser.add_argument("--clean", action="store_true")
+    install_parser.add_argument("--delete-native-deps", action="store_true")
+    install_parser.add_argument("--skip-native-deps", action="store_true")
+    install_parser.add_argument("--auto-install-missing-prereqs", action="store_true")
+    install_parser.add_argument("--skip-engine-build", action="store_true")
+    install_parser.add_argument("--skip-web-build", action="store_true")
+    install_parser.add_argument("--duckdb-version", default="1.4.2")
+    install_parser.add_argument("--native-arch", default="x64-windows-static")
+    install_parser.add_argument("--show-details", action="store_true")
+    install_parser.add_argument("--run-demo", action="store_true")
+    install_parser.add_argument("--dry-run", action="store_true")
+    install_parser.add_argument("--output")
+
+    return parser
+
+
+def _handle_plan(args: argparse.Namespace) -> int:
+    repo_root = Path(args.repo_root).resolve() if args.repo_root else None
+    manifest_path = manifest_path_from_args(args.manifest, repo_root or Path.cwd())
+    manifest, plan = plan_installation(
+        manifest_path=manifest_path,
+        repo_root=repo_root,
+        profile=args.profile,
+        editable_overrides=args.editable,
+        execution_mode=args.mode,
+    )
+    payload = {
+        "repo_root": str(repo_root) if repo_root else None,
+        "manifest_path": str(manifest.path),
+        "execution_mode": detect_execution_mode(repo_root, args.mode),
+        "profile": plan.profile,
+        "requested_modules": list(plan.requested_modules),
+        "ordered_modules": [
+            {
+                "package_name": item.package_name,
+                "path": item.module.path,
+                "source": item.source,
+                "reason": item.reason,
+                "local_version": item.local_version,
+                "pypi_version": item.pypi_version,
+                "depends_on": list(item.module.depends_on),
+            }
+            for item in plan.ordered_modules
+        ],
+        "hooks": [{"hook_id": hook.hook_id, "action": hook.action} for hook in plan.hooks],
+    }
+    output_payload(payload, Path(args.output).resolve() if args.output else None)
+    return 0
+
+
+def _handle_diagnose(args: argparse.Namespace) -> int:
+    provider = WindowsProvider()
+    payload = {"provider": provider.name, "tools": [item.to_dict() for item in provider.diagnose()]}
+    output_payload(payload, Path(args.output).resolve() if args.output else None)
+    return 0
+
+
+def _handle_install(args: argparse.Namespace) -> int:
+    options = build_options_from_namespace(args)
+    payload = execute_install(options)
+    if not args.output:
+        print(json.dumps(payload, indent=2))
+    return 0
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+    try:
+        if args.command == "plan":
+            return _handle_plan(args)
+        if args.command == "diagnose":
+            return _handle_diagnose(args)
+        if args.command == "install":
+            return _handle_install(args)
+        parser.error(f"Unsupported command: {args.command}")
+        return 2
+    except Exception as exc:
+        print(f"cf_setup error: {exc}", file=sys.stderr)
+        return 1

cf_setup-0.1.0/src/cf_setup/install_manifest.toml

@@ -0,0 +1,148 @@
+[profiles]
+core = [
+  "cf-ontology",
+  "cf-datahive",
+  "cf-opcua-server",
+  "cf-pipeline-cert",
+  "cf-pipeline-report",
+  "cf-pipeline-sdk",
+  "cf-pipeline-engine",
+  "cf-core-cli",
+]
+steps = [
+  "cf-basic-dev",
+  "cf-basic-io",
+  "cf-basic-signal",
+  "cf-basic-sinks",
+]
+web = [
+  "cf-web",
+]
+full = [
+  "profile:core",
+  "profile:steps",
+  "profile:web",
+]
+
+[modules.cf-ontology]
+path = "sandcastle/cf_ontology"
+aliases = ["cf_ontology", "ontology"]
+editable = true
+native_prereqs = false
+engine_build = false
+web_build = false
+depends_on = []
+
+[modules.cf-datahive]
+path = "sandcastle/cf_datahive"
+aliases = ["cf_datahive", "datahive"]
+editable = true
+native_prereqs = true
+engine_build = false
+web_build = false
+depends_on = []
+
+[modules.cf-opcua-server]
+path = "sandcastle/cf_opcua_server"
+aliases = ["cf_opcua_server", "opcua-server"]
+editable = true
+native_prereqs = false
+engine_build = false
+web_build = false
+depends_on = []
+
+[modules.cf-pipeline-cert]
+path = "sandcastle/cf_pipeline/cf_pipeline_cert"
+aliases = ["cf_pipeline_cert", "pipeline-cert"]
+editable = true
+native_prereqs = false
+engine_build = false
+web_build = false
+depends_on = []
+
+[modules.cf-pipeline-report]
+path = "sandcastle/cf_pipeline/cf_pipeline_report"
+aliases = ["cf_pipeline_report", "pipeline-report", "report"]
+editable = true
+native_prereqs = false
+engine_build = false
+web_build = false
+depends_on = []
+
+[modules.cf-pipeline-sdk]
+path = "sandcastle/cf_pipeline/cf_pipeline_sdk"
+aliases = ["cf_pipeline_sdk", "pipeline-sdk", "sdk"]
+editable = true
+native_prereqs = true
+engine_build = false
+web_build = false
+depends_on = ["cf-ontology"]
+
+[modules.cf-pipeline-engine]
+path = "sandcastle/cf_pipeline/cf_pipeline_engine"
+aliases = ["cf_pipeline_engine", "pipeline-engine", "engine"]
+editable = true
+native_prereqs = true
+engine_build = true
+web_build = false
+depends_on = ["cf-datahive", "cf-opcua-server", "cf-pipeline-sdk", "cf-ontology"]
+
+[modules.cf-core-cli]
+path = "sandcastle/cf_cli"
+aliases = ["cf-cli", "cf_core_cli", "cli"]
+editable = true
+native_prereqs = false
+engine_build = false
+web_build = false
+depends_on = []
+
+[modules.cf-basic-dev]
+path = "sandcastle/cf_basic_steps/cf_basic_dev"
+aliases = ["cf_basic_dev", "basic-dev"]
+editable = true
+native_prereqs = false
+engine_build = false
+web_build = false
+depends_on = ["cf-ontology"]
+
+[modules.cf-basic-io]
+path = "sandcastle/cf_basic_steps/cf_basic_io"
+aliases = ["cf_basic_io", "basic-io"]
+editable = true
+native_prereqs = true
+engine_build = false
+web_build = false
+depends_on = ["cf-ontology"]
+
+[modules.cf-basic-signal]
+path = "sandcastle/cf_basic_steps/cf_basic_signal"
+aliases = ["cf_basic_signal", "basic-signal"]
+editable = true
+native_prereqs = true
+engine_build = false
+web_build = false
+depends_on = ["cf-ontology"]
+
+[modules.cf-basic-sinks]
+path = "sandcastle/cf_basic_steps/cf_basic_sinks"
+aliases = ["cf_basic_sinks", "basic-sinks"]
+editable = true
+native_prereqs = false
+engine_build = false
+web_build = false
+depends_on = []
+
+[modules.cf-web]
+path = "sandcastle/cf_web"
+aliases = ["cf_web", "web"]
+editable = true
+native_prereqs = false
+engine_build = false
+web_build = true
+depends_on = ["cf-ontology", "cf-pipeline-engine"]
+
+[[hooks]]
+id = "ingest-installed-steps"
+when = "post_install"
+action = "cf_ontology_ingest_installed_steps"
+requires_modules = ["cf-ontology"]