Guardrail template

Files

templates/guardrail-bot/
  README.md
  bot.ts
  config.schema.json
  default.config.json
  input.fixture.json
  expected.output.json
  tests.spec.ts

Bot interface bound

This template implements Bot<OrderIntent, RiskVote>. The contract is the canonical bot interface.

The only function you write

async decide(input: OrderIntent, ctx: BotContext): Promise<RiskVote> {
  // 1. Cheap rejects first
  if (ctx.killSwitchActive) {
    return reject(input.intentId, "RISK_KILL_SWITCH_ACTIVE", ctx);
  }

  // 2. Freshness check
  const snap = ctx.signal<MarketSnapshot>("market_snapshot");
  if (!snap || ctx.now() - snap.observedAt > this.config.parameters.max_market_data_age_ms) {
    return reject(input.intentId, "RISK_STALE_BOOK", ctx);
  }

  // 3. Domain check
  if (!isWithinExposureCap(input, this.portfolio)) {
    return reject(input.intentId, "RISK_PORTFOLIO_LIMIT", ctx);
  }

  // 4. Approve
  return approve(input.intentId, ctx);
}

What's already wired for you

• init(), validateInput(), explain(), emit(), health(), setMode().
• ReportEnvelope construction with correlation IDs, builderCode, killSwitchState.
• The full test harness — unit, integration, property, failure-injection.
• Config schema validation; the bot crashes on init if its config violates a hard threshold.

Promotion checklist

1. Implement decide().
2. Run npm test — all four test classes must pass.
3. Open a PR with the bot's spec page linked in the description.
4. Promote through the modes ladder: stub → shadow → advisory → enforced.