Skip to content

Open-source manufacturing ERP, MES and QMS. Quoting, MRP, inventory, shop floor, quality and lot/serial traceability on one Postgres schema, with a REST API and MCP server. Self-host or use Carbon Cloud.

1.2 KB
Raw Blame

@carbon/harness

The deterministic substrate that powers the build conductor skill (loop conductor).

Concepts

  • Bindings — specs for a loop iteration, parsed from .ai/runs/<id>/binding.loop.md frontmatter.
  • Ledger — append-only JSONL log of each iteration's outcome, stored at .ai/runs/<id>/ledger.jsonl.
  • Floor gates — cheap, deterministic checks that must pass before any iteration is recorded as keep.

Usage

import { parseBinding, appendLedger, readLedger, runGates, FLOOR_GATES } from "@carbon/harness";

Run the floor gates manually:

pnpm --filter @carbon/harness gates

Growing the gate list

Add a row to FLOOR_GATES in src/gates.ts. Each gate is { id: string, cmd: string }. The CLI in src/scripts/run-gates.ts shells out via execSync; the runGates function itself stays pure (injected Exec) so it is unit-testable without spawning processes.

File layout

src/
  binding.ts          parse .loop.md frontmatter
  ledger.ts           append-only JSONL ledger
  gates.ts            gate runner (pure) + FLOOR_GATES
  scripts/
    run-gates.ts      CLI entry point
  index.ts            barrel