Garazyk Laweta

Garazyk Laweta — Docker Infrastructure

Generic Docker Engine API client over Unix socket with Compose, health, events, and stats. No ATProto-specific code — protocol orchestration lives in hamownia.

When to Use

• Create a Docker API client or interact with the Docker daemon
• Bring up or tear down Docker Compose stacks
• Wait for services to become healthy (HTTP or container health)
• Watch container events (health transitions, crashes, state changes)
• Sample container CPU/memory stats
• Detect port conflicts or stale Docker projects

Quick Start

import {
  createDockerClient,
  composeUp,
  composeDown,
  waitForService,
  ContainerEventWatcher,
  ContainerStatsSampler,
} from "@garazyk/laweta";

Compose subpath:

import { composeProjectName, composeServiceName } from "@garazyk/laweta/compose";

API Reference

Docker Client

Compose

Health Checks

Container Events

Container Stats

Port & Project Detection

Log Parsing

Key Patterns

Create a client and check Docker version

const docker = createDockerClient();
const version = await docker.version();
console.log(version.ApiVersion);

Bring up a Compose stack and wait for health

await composeUp("docker-compose.yml", "my-project");
const watcher = await ContainerEventWatcher.create();
const ok = await waitForService("pds", "my-project", "docker-compose.yml", 60, watcher);

Sample container stats

const sampler = new ContainerStatsSampler(docker, "my-container", { intervalMs: 1000 });
sampler.start();
// ... later
const snapshot = sampler.latest();
console.log(`CPU: ${cpuPercent(snapshot)}%, Mem: ${formatMemory(memoryUsage(snapshot))}`);
sampler.stop();

Detect port conflicts before starting

const conflicts = await findPortConflicts([2583, 2584]);
if (conflicts.length > 0) {
  console.log("Port conflicts:", conflicts.map(c => `${c.port} → ${c.process}`));
}

Boundary Rules

Laweta can only import from gruszka and laweta. No ATProto-specific code — all protocol orchestration lives in hamownia.

Related Skills

• garazyk-hamownia — scenario orchestration that uses laweta for Docker
• garazyk-schemat — topology definitions that produce compose configs
• garazyk-narzedzia — boundary checker enforces laweta's import rules

Source: jvalinsky/garazyk — distributed by TomeVault.