Skip to content

refactor(dispatch): return crew routing to agent judgment with advisory capacity - #76

Merged
quinnbot-ai merged 3 commits into
mainfrom
fm/kun-converge-startpath
Aug 2, 2026
Merged

quinnbot-ai merged 3 commits into
mainfrom
fm/kun-converge-startpath

Conversation

@quinnbot-ai

Copy link
Copy Markdown
Owner

Convergence step 1 of the pure-upstream reconciliation: remove the start-path blockers so crew dispatch is an agent-owned natural-language routing decision again, with exactly one launch-and-identity preflight after selection.

What was blocking the start path

Blocker Resolution
quota-axi was a required bootstrap tool with a 0.1.16 version floor, so a missing or old capacity tool emitted MISSING: - and AGENTS.md section 3 forbids dispatching until required tools are present Removed from the universal toolchain; version gate and bin/fm-quota-axi-lib.sh retired
Section 4 mandated a quota-axi --json snapshot plus full per-candidate evidence accounting before any routing decision Replaced with agent judgment over task fit and reasoning class; capacity explicitly advisory
quota-array-dispatch - 113 lines of mechanical selection order with hard stops on tight quota and on genuine ties Retired
bin/fm-vendor-auth-probe.sh - a pre-selection credential preflight in front of the launch preflight Retired, leaving exactly one preflight
harness-adapters still required credential discovery through quota-axi auth --json and let a model listing "block that candidate" Re-scoped to advisory; launch-time refusal belongs to fm-spawn.sh alone

The new contract

Capacity may separate otherwise comparable candidates, but headroom, runway, pace, an unmeasurable window, or a missing reading never refuses a dispatch or downgrades the captain's strongest-reasoning class. Work stops only when the selected capability actually fails, or when every remaining fallback would cross an identity boundary - another account, credential surface, or home.

Preserved deliberately

bin/fm-spawn.sh is untouched, so its fail-closed launch validation, the worktree-isolation assertion, and secondmate home identity all stand. Malformed dispatch configuration still surfaces as an actionable CREW_DISPATCH error. Identity is still never inferred from a harness, model, or source name, and the harness=pi / model=xai/grok-* adapter split survives. Herdr lifecycle behavior is untouched - a separate task owns it.

The select: "quota-balanced" key stays in the config schema for backward compatibility with existing local files, now documented as marking an array capacity-informed rather than as authority to refuse a dispatch.

Verification

bin/fm-lint.sh clean, bin/fm-doc-audience-check.sh ok (61 surfaces, 184 local links), and all 21 tests/fm-bootstrap.test.sh assertions pass. The bootstrap tests that asserted the old blocking contract were inverted rather than deleted: test_quota_axi_is_never_a_start_path_blocker now pins the new guarantee through the executable interface, covering absent, old, and unparseable capacity tools.

Net -1,137 lines.

QuinnBot added 3 commits August 2, 2026 14:06
…ry capacity

Dispatch had accumulated a mechanical control plane in front of the routing
decision: a required quota-axi with a version floor, a 113-line selection
procedure, and a pre-selection vendor credential probe. Together they gated the
start path before any judgment happened, and a capacity or credential reading
could refuse a dispatch outright.

Section 4 now states the routing decision as agent judgment over task fit and
reasoning class. Capacity is advisory: quota-axi is read when installed and may
separate otherwise comparable candidates, but headroom, runway, pace, an
unmeasurable window, or a missing reading never refuses a dispatch or downgrades
the captain's strongest-reasoning class. Selection is followed by exactly one
preflight - fm-spawn.sh validating the concrete selected profile at launch - and
work stops only when the selected capability actually fails or every remaining
fallback would cross an identity boundary.

Retires the quota-array-dispatch skill, the pre-selection vendor auth probe, the
quota-axi compatibility floor, and their verification record. quota-axi leaves
the required universal toolchain, so an absent or older capacity tool no longer
emits a start-path blocker; bootstrap tests pin that guarantee directly.

Preserved unchanged: fm-spawn.sh's fail-closed launch validation and worktree
isolation assertion, secondmate home identity, malformed dispatch config as an
actionable error, and the explicit-harness consultation backstop.
@quinnbot-ai
quinnbot-ai merged commit c3d6c8b into main Aug 2, 2026
10 of 11 checks passed
quinnbot-ai added a commit that referenced this pull request Aug 10, 2026
…ry capacity (#76)

* refactor(dispatch): return crew routing to agent judgment with advisory capacity

Dispatch had accumulated a mechanical control plane in front of the routing
decision: a required quota-axi with a version floor, a 113-line selection
procedure, and a pre-selection vendor credential probe. Together they gated the
start path before any judgment happened, and a capacity or credential reading
could refuse a dispatch outright.

Section 4 now states the routing decision as agent judgment over task fit and
reasoning class. Capacity is advisory: quota-axi is read when installed and may
separate otherwise comparable candidates, but headroom, runway, pace, an
unmeasurable window, or a missing reading never refuses a dispatch or downgrades
the captain's strongest-reasoning class. Selection is followed by exactly one
preflight - fm-spawn.sh validating the concrete selected profile at launch - and
work stops only when the selected capability actually fails or every remaining
fallback would cross an identity boundary.

Retires the quota-array-dispatch skill, the pre-selection vendor auth probe, the
quota-axi compatibility floor, and their verification record. quota-axi leaves
the required universal toolchain, so an absent or older capacity tool no longer
emits a start-path blocker; bootstrap tests pin that guarantee directly.

Preserved unchanged: fm-spawn.sh's fail-closed launch validation and worktree
isolation assertion, secondmate home identity, malformed dispatch config as an
actionable error, and the explicit-harness consultation backstop.

* no-mistakes(review): Remove residual preselection dispatch gates

* no-mistakes(document): Correct stale session-start quota documentation

---------

Co-authored-by: QuinnBot <quinnbot@proton.me>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant