Skip to content

Repository files navigation

TTFHW Runner

Verification runner and sandbox worker implementation for TTFHW.

Responsibility

This repository owns execution, not product UI or historical data storage:

  • clone and prepare target repositories
  • run document scan, static checks, build, tests, and samples
  • manage local, container, or remote execution environments
  • collect logs and raw artifacts
  • emit step-level JSON outputs using versioned schemas
  • clean up containers and temporary workspaces

It must not own the dashboard, the long-term archive, or the control-plane API state store.

Recommended Stack

  • Python for runner CLI and worker process
  • Docker/Podman as the primary sandbox abstraction
  • Structured step contracts with JSON Schema or Pydantic
  • Plug-in style executors for local, remote SSH, and future Kubernetes execution
  • OpenTelemetry-compatible logs and trace IDs passed from the control plane

Boundary

Inputs: immutable run spec from ttfhw-control-plane.

Outputs: raw step artifacts and machine-readable step results for ttfhw-data-pipeline.

About

TTFHW verification runner and sandbox execution workers

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages