Run one gate command and keep a log that setup validation accepts

At a glanceCopy Anchor Link

• Who: Agents and maintainers who run lint, test or build gates and need the result as evidence.
• What: Run a shell command and write a gate log in the CMD: / START: / END: / EXIT:<code> shape that zedkit-ai validate --setup checks, with the V8 heap capped and a CAUSE: line when the command times out, is killed or runs out of memory.
• Use when: When a setup run, a handoff or a PR cites a gate and the log must outlive the chat.
• Avoid when: For interactive commands or when a CI job already stores its own log.
• See also: Check that skills, subagents, commands and provider copies are valid

InstallCopy Anchor Link

pnpm add @zedtech/zedkit-ai

Latest: 1.0.0 (via changesets).

ExampleCopy Anchor Link

import { runGate } from "@zedtech/zedkit-ai";
const result = await runGate({
  cmd: "pnpm exec turbo run test --concurrency=2",
  log: ".agents/setup-log/gates/test.log",
  timeoutMs: 20 * 60_000,
});
if (!result.ok) throw result.error;
process.exitCode = result.value.code;

Wraps: (none)