converge git:20260909.302c64aA

Immutable. This exact content is served forever at /api/v1/blob/efbcad4f49842aa9.

---
name: converge
description: Append-only gap closure and the cadence engine for research theses. Evaluates artifact CURRENT state (never git history, never task checkboxes) against current pins and wrong_if falsifiers, then appends a Convergence section to tasks.md re-proposing the gaps. A clean run leaves tasks.md byte-identical. Deterministic gaps (stale, invalidated) are uncapped; judgment-class gaps are capped per spec 046 Q40.
role: kit
market_data_stage: none
allowed_tools: []
retrieval_scope: structured_only
---

# agentii.converge

Append-only gap closure — the cadence engine of the research orchestration system (spec 046 Q26).

## When to run

- After every `agentii.implement` batch (the system detects its own staleness).
- On any cadence cycle (quarterly re-visits, post-earnings, post-constitution-bump).
- Before any IC review (the conflict list must be current).

## What it does

1. **Evaluates current state** — artifacts on disk, pins in frontmatter, `wrong_if`
   falsifiers in `thesis.md`. It never reads git history and never trusts `[x]`
   checkboxes (Q26 A+: the ledger may lie; the correction is deterministic and has
   a bounded expiry — the next converge).
2. **Appends, never rewrites** — the only write is a `## Phase N: Convergence`
   section at the end of `tasks.md`, with `src:` refs and content-derived finding
   IDs. Existing lines, including previous Convergence sections, are untouched.
3. **Clean run = byte-identical** — no gaps means no empty section header.

## Gap types

| Type | Class | Cap |
|---|---|---|
| `stale` (pins older than current) | deterministic | uncapped |
| `invalidated` (`wrong_if` metric+threshold triggered) | deterministic | uncapped |
| `missing` / `partial` / `contradicts` / `unrequested` | judgment | Q40 cap (≈50) |

## Invocation

```bash
python3 scripts/converge.py --thesis theses/001-ai-semiconductors \
  --pins '{"assumption_pin": 1, "corpus_version": "2026-08", "as_of": "2026-09-08", "constitution_pin": "0.1.0", "skill_pin": "recent-quarter:abc"}'
```

## Hard rules (Q26)

- Never modify `spec.md` or `plan.md`.
- Never rewrite, renumber, reorder, or delete any existing task.
- Finding IDs are content-derived (`hash(entity+metric+period+gap_type)`) — an
  unchanged re-run appends nothing.