← Docs
Helix CLI docs
Browse Helix CLI docs

page_id: component-component:pyproject.toml page_type: component generation_mode: inferred freshness_status: reused updated_at: 2026-07-06T01:44:11.039Z

<details> <summary>Build metadata</summary>
{
  "freshnessKey": "ed43a4096d98bc928ce93a9c3202203f76742728",
  "plannerReason": "Generated because the component was ranked as significant for repo navigation.",
  "changedPaths": [],
  "dependencyPaths": [
    "src/helix/edge/basespace_client.py",
    "src/helix/ogn/client.py",
    "src/helix/ogn/ingest_status_client.py",
    "src/helix/server/analysis_client.py",
    "pyproject.toml",
    "src/helix_api.py",
    "src/helix_cuda_fields.py",
    "src/helix_engine/__init__.py",
    "src/helix_engine/CMakeLists.txt",
    "src/helix_engine/include/helix/ctmc_tau_leap_cuda.hpp",
    "src/helix_engine/include/helix/l0_thermo_cuda.hpp",
    "src/helix_engine/include/helix/physics_cuda.hpp",
    "Makefile"
  ],
  "dependencyEvidenceIds": [
    "component:pyproject.toml",
    "workflow:Makefile",
    "workflow:pyproject.toml"
  ],
  "evidenceIds": [
    "component:pyproject.toml",
    "workflow:Makefile",
    "workflow:pyproject.toml"
  ],
  "qualityWarnings": []
}

</details>

helix-governance

helix-governance python component

Implementation Roles

src/helix/edge/basespace_client.py

Role classification: inferred adapter. Proved signals: Why this role fits: These proved signals suggest this unit translates or brokers interactions across an internal or external boundary. Supporting implementation citations:

  • src/helix/edge/basespace_client.py:32

src/helix/ogn/client.py

Role classification: inferred adapter. Proved signals: Why this role fits: These proved signals suggest this unit translates or brokers interactions across an internal or external boundary. Supporting implementation citations:

  • src/helix/ogn/client.py:50

src/helix/ogn/ingest_status_client.py

Role classification: inferred adapter. Proved signals: Why this role fits: These proved signals suggest this unit translates or brokers interactions across an internal or external boundary. Supporting implementation citations:

  • src/helix/ogn/ingest_status_client.py:21

src/helix/server/analysis_client.py

Role classification: inferred adapter. Proved signals: Why this role fits: These proved signals suggest this unit translates or brokers interactions across an internal or external boundary. Supporting implementation citations:

  • src/helix/server/analysis_client.py:15
<details> <summary>Related files:</summary>
  • src/helix/edge/basespace_client.py
  • src/helix/ogn/client.py
  • src/helix/ogn/ingest_status_client.py
  • src/helix/server/analysis_client.py
</details> <details> <summary>Citations:</summary>
  • src/helix/edge/basespace_client.py:32
  • src/helix/ogn/client.py:50
  • src/helix/ogn/ingest_status_client.py:21
  • src/helix/server/analysis_client.py:15
</details>

Module Responsibilities

Insufficient evidence to infer module responsibilities confidently.

<details> <summary>Supporting citations:</summary>
  • none
</details>

Key Symbols

Insufficient evidence to infer key symbol behavior confidently.

<details> <summary>Supporting citations:</summary>
  • none
</details>

State Boundaries

Insufficient evidence to infer state boundaries confidently.

<details> <summary>Supporting citations:</summary>
  • none
</details>

State Ownership and Handoffs

Insufficient evidence to infer state ownership and handoffs confidently.

<details> <summary>Supporting citations:</summary>
  • none
</details>

Request Lifecycle

Insufficient evidence to infer a bounded request lifecycle confidently.

<details> <summary>Supporting citations:</summary>
  • none
</details>

Responsibilities

helix-governance python component

Type: application Root path: . Ecosystem: python

<details> <summary>Related files:</summary>
  • pyproject.toml
  • src/helix_api.py
  • src/helix_cuda_fields.py
  • src/helix_engine/__init__.py
  • src/helix_engine/CMakeLists.txt
  • src/helix_engine/include/helix/ctmc_tau_leap_cuda.hpp
  • src/helix_engine/include/helix/l0_thermo_cuda.hpp
  • src/helix_engine/include/helix/physics_cuda.hpp
</details> <details> <summary>Citations:</summary>
  • pyproject.toml
  • src/helix_api.py
  • src/helix_cuda_fields.py
  • src/helix_engine/__init__.py
</details>

Entrypoints and Runtime Surface

  • none

Interfaces and Config

  • none

Dependencies and Relationships

  • none
<details> <summary>Related files:</summary>
  • pyproject.toml
  • src/helix_api.py
  • src/helix_cuda_fields.py
  • src/helix_engine/__init__.py
  • src/helix_engine/CMakeLists.txt
  • src/helix_engine/include/helix/ctmc_tau_leap_cuda.hpp
  • src/helix_engine/include/helix/l0_thermo_cuda.hpp
  • src/helix_engine/include/helix/physics_cuda.hpp
</details> <details> <summary>Citations:</summary>
  • pyproject.toml
  • src/helix_api.py
  • src/helix_cuda_fields.py
  • src/helix_engine/__init__.py
</details>

Why This Hotspot Matters

Architectural role: Hotspot score 9432 with 3143 inbound and 0 outbound inferred edges marks helix-governance as a coordination-heavy component. It bridges src.

Main coupling surfaces:

  • Dependency-heavy surface with 3143 inferred dependency edges.

Likely failure modes:

  • Upstream breakage risk: 3143 inbound edges suggest downstream callers depend on this boundary staying stable.
  • Cross-subsystem regression risk: changes can disrupt handoffs across src.
<details> <summary>Supporting citations:</summary>
  • pyproject.toml
  • src/helix_api.py
  • src/helix_cuda_fields.py
  • src/helix_engine/__init__.py
</details> <details> <summary>Related files:</summary>
  • pyproject.toml
  • src/helix_api.py
  • src/helix_cuda_fields.py
  • src/helix_engine/__init__.py
</details> <details> <summary>Citations:</summary>
  • pyproject.toml
  • src/helix_api.py
  • src/helix_cuda_fields.py
  • src/helix_engine/__init__.py
</details>

Operational Risk Surface

Likely fault domains:

  • Cross-subsystem handoffs: src.

High-cost dependencies:

  • 3143 inbound edges raise the cost of breaking this component's callers.

First validation checks:

  • Run make (build) from ..
  • Run helix-pilot-verify (run) from ..
  • Run python -m pytest (test) from ..
<details> <summary>Supporting citations:</summary>
  • pyproject.toml
  • src/helix_api.py
  • src/helix_cuda_fields.py
  • Makefile
</details> <details> <summary>Related files:</summary>
  • pyproject.toml
  • src/helix_api.py
  • src/helix_cuda_fields.py
  • Makefile
</details> <details> <summary>Citations:</summary>
  • pyproject.toml
  • src/helix_api.py
  • src/helix_cuda_fields.py
  • Makefile
</details>

Invariants and Failure Handling

Insufficient evidence to infer invariants and failure handling confidently.

<details> <summary>Supporting citations:</summary>
  • none
</details>

Where to Edit

Likely change entry files:

  • pyproject.toml
  • src/helix_api.py
  • src/helix_cuda_fields.py

Owned interfaces:

  • none

Nearby verification surfaces:

  • Run make (build) from ..
  • Run helix (run) from ..
  • Run helix-campaign (run) from ..
  • Run helix-cli (run) from ..
<details> <summary>Supporting citations:</summary>
  • pyproject.toml
  • src/helix_api.py
  • src/helix_cuda_fields.py
  • Makefile
</details> <details> <summary>Related files:</summary>
  • pyproject.toml
  • src/helix_api.py
  • src/helix_cuda_fields.py
  • Makefile
</details> <details> <summary>Citations:</summary>
  • pyproject.toml
  • src/helix_api.py
  • src/helix_cuda_fields.py
  • Makefile
</details>

Change Planning

Impacted areas:

  • Cross-subsystem risk touches src.
  • Hotspot score 9432 with 3143 inbound and 0 outbound edges suggests higher coordination risk.

Suggested verification steps:

  • Run make (build) from ..
  • Run helix (run) from ..
  • Run helix-campaign (run) from ..
  • Run helix-cli (run) from ..
<details> <summary>Supporting citations:</summary>
  • pyproject.toml
  • src/helix_api.py
  • src/helix_cuda_fields.py
  • Makefile
</details> <details> <summary>Related files:</summary>
  • pyproject.toml
  • src/helix_api.py
  • src/helix_cuda_fields.py
  • src/helix_engine/__init__.py
  • Makefile
</details> <details> <summary>Citations:</summary>
  • pyproject.toml
  • src/helix_api.py
  • src/helix_cuda_fields.py
  • Makefile
</details>

Nearby Workflows

  • make (build)
  • helix (run)
  • helix-campaign (run)
  • helix-cli (run)
  • helix-pilot-verify (run)
  • helix-studio (run)
  • omnis-helix (run)
  • python -m pytest (test)
<details> <summary>Related files:</summary>
  • Makefile
  • pyproject.toml
</details> <details> <summary>Citations:</summary>
  • Makefile
  • pyproject.toml
</details>

Citations

<details> <summary>Citations:</summary>
  • src/helix/edge/basespace_client.py:32
  • src/helix/ogn/client.py:50
  • src/helix/ogn/ingest_status_client.py:21
  • src/helix/server/analysis_client.py:15
  • pyproject.toml
  • src/helix_api.py
  • src/helix_cuda_fields.py
  • src/helix_engine/__init__.py
  • Makefile
</details>