forkd-action v0.1.0 — first scaffold

First release of the forkd GitHub Action.

- uses: deeplethe/forkd-action@v1
  with:
    url: ${{ secrets.FORKD_URL }}
    token: ${{ secrets.FORKD_TOKEN }}
    snapshot_tag: python-3-12-slim
    n: 4
    command: pytest tests/

What's included

• Composite action that drives an already-running forkd-controller via REST.
• Spawn N sandboxes, exec a command or script in parallel, collect per-sandbox results as JSON.
• Outputs: results (JSON array) and any_failed (bool).
• Inputs: prewarm, per_child_netns, memory_limit_mib, exec_timeout_secs, fail_on_nonzero, cleanup.

Pinning

• @v1 — floating major (auto-track v1.x.y)
• @v0.1.0 — specific tag

Not in scope (yet)

The action does NOT try to bootstrap firecracker on GHA-hosted runners — they lack reliable KVM access. Point this at an already-running forkd-controller on your dev box / self-hosted runner / managed VM. See README.

Tracking

Closes deeplethe/forkd#114, item 2 of meta #112.