loop

vyuh-dxkit loop + vyuh-dxkit hook stop-gate

Run as: vyuh-dxkit <cmd> after npm install -g @vyuhlabs/dxkit, or npx @vyuhlabs/dxkit <cmd> for one-shot use.

The loop pack is dxkit's deterministic preflight/postflight layer for autonomous coding loops — a Claude Code session that keeps working until it decides to stop. It stops a loop from declaring "done" while it has introduced net-new findings, by re-running the guardrail on every Stop and feeding any net-new findings back to the model for repair.

The value is predictability, not new detection: the gate bounds the "loop shipped debt and never fixed it" failure mode to zero using the findings, baseline, and identity contract dxkit already computes. It is not a new scanner.

Setup

# Register the Stop hook + CLAUDE.md loop norm + default preset.
# Additive: merges into an existing .claude/settings.json + CLAUDE.md
# without clobbering your hooks or prose. Implies the dxkit skills.
vyuh-dxkit init --claude-loop [--loop-preset security-only|full-debt]

This is opt-in even under init --full, because it registers a hook that blocks the agent from stopping. See init.

vyuh-dxkit hook stop-gate

The body of the Claude Code Stop hook. Not run by hand — init --claude-loop registers it in .claude/settings.json:

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "cd \"${CLAUDE_PROJECT_DIR:-.}\" && npx vyuh-dxkit hook stop-gate"
          }
        ]
      }
    ]
  }
}

It reads the hook payload from stdin, runs the guardrail against the baseline, and decides:

Outcome	Condition	Mechanism
Allow stop	No net-new findings (and the optional test command passed)	exit 0, no decision
Block → model	Net-new findings the model can fix	exit 0 + {"decision":"block","reason":"…"} on stdout — the reason reaches the model so it repairs, then tries to stop again
Block → operator	Guardrail couldn't run (no baseline / config error)	exit 2 + stderr to the operator (the model can't fix a preflight problem); allows on the next attempt to avoid thrashing