feat: clarify routing attribution and add host preflight

[GrillerGeek]

Summary

Clarify what Guildhall can verify before users pay for routing studies. Add a bundled read-only preflight and explicit task-owned Claude/Codex capture importers. Routing schema v3 separates configuration evidence from observed model/effort, binds qualification to objective, and supports an explicitly selected configuration lane while preserving the stronger setup default.

Closes #36; addresses #37 finding4. Stacked on #39. All manifests advance to 0.12.0.

The inspected Codex runtime exposes configuration, not executed identity. A complete owned app-server capture can support the configuration lane; the desktop collaboration result alone cannot. Documentation explains that limitation and never silently substitutes CLI workers. Native-Claude concrete model observations remain distinct from effort and provider attestation.

Validation

104 tests passed, covering missing/mixed attribution, wrong worker/session, interruption/replay, reported substitution, alias drift, explicit evidence levels and objective binding. Native/portable validators and ten isolated installations passed, including installed synthetic capture import after source removal. Local version-specific Codex schemas were inspected without model calls.

No live host/profile qualification or routing activation is claimed. See the decision record and installed host-evidence guide for scope and migration.

[coldtea-pr-lens]

◈ PR Lens

🟢 +1 new · 🟠 ~10 changed · 🔴 -0 removed · 2 flows · 24 files · commit a9807b8

Architecture

11 components touched across 4 lanes.

Play the interactive walkthrough

Inside the changed components — 3 views

Component view — Evidence inspection and preflight

Read-only capture inspection, preflight diagnosis, and drift evaluation modules.

Component view — Schema v3 model routing and qualification

Schema v3 model routing with explicit evidence level checks and objective binding.

Component view — Plugin and packaging validation

CI validation, packaging checks for schema v3, and isolated installation testing.

Data flow

Inspecting host evidence and detecting drift · Evaluating candidate qualification under schema v3

Follow each request, response and payload

The other flows — 1 sequence

Evaluating candidate qualification under schema v3

View

• Architecture lens
• Data flow lens
• Expand every detail

Tip

Add .github/workflows/pr-lens.yml with coldteadotai/pr-lens/packages/action@v0 and your model provider's key as its api-key to run PR Lens from your own CI. Any /chat/completions endpoint works

🪧 More tips

• Run npx skills add coldteadotai/pr-lens, then tell your coding agent: "Diagram the change you just made with PR Lens and attach it to the pull request."
• Run npx @coldtea/pr-lens-cli analyze --base origin/main on a branch, then npx @coldtea/pr-lens-cli render .pr-lens/graph.json. Same lenses, your own model key, before the pull request exists
• Untick Architecture lens or Data flow lens under View to hide a diagram, or tick Expand every detail to open every section. The comment redraws in a few seconds
• Click the link under each diagram to open it on a canvas you can zoom, pan and step through
• The diagrams are links. Click one to open it on the canvas, then press W or click play to walk through the change
• Open a diagram on the canvas, then press W or click play to walk through the change one step at a time
• The CLI's render reads .github/pr-lens.yml and applies your renames, exclusions and lane pins at draw time
• Set github.comment.collapsed: true in .github/pr-lens.yml to fold the comment behind one View architecture and data flow row. Drawing still runs on every push
• Set github.draw: on-demand in .github/pr-lens.yml and PR Lens stops drawing every push. Comment @pr-lens draw on a pull request when you want that one drawn
• Push a commit and the comment redraws for the new head. A slow older run never overwrites a newer one
• Switch GitHub to dark mode and the diagrams follow. The moving dots are this pull request's data in motion

---

Thanks for using PR Lens! It's built by Coldtea, free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Bluesky
• Mastodon
• Reddit
• LinkedIn