vigiles API reference
    Preparing search index...

    Interface ContainerRuntimeExperimental

    The container-lifecycle PORT — the seam a concrete backend implements (raw docker is the planned v0 default; podman / testcontainers / the macOS os-isolation backend swap in by injection, never a conditional). Kept harness-agnostic and dependency-free at the core, exactly like the five harness ports: the abstraction exists so a second backend is a NEW OBJECT, not an edit threaded through the orchestrator.

    start is responsible for HONOURING ServiceSpec.ready + running ServiceSpec.seed, so it resolves only with a ready, seeded service.

    interface ContainerRuntime {
        name: string;
        available(): boolean | Promise<boolean>;
        start(name: string, spec: ServiceSpec): Promise<ServiceHandle>;
        stop(handle: ServiceHandle): Promise<void>;
    }
    Index

    Properties

    Methods

    Properties

    name: string

    Backend name for diagnostics, e.g. "docker".

    Methods

    • Experimental

      Whether this backend can actually run here (e.g. docker info succeeds).

      Returns boolean | Promise<boolean>