---
name: f005-adapter-distribution-ruling
description: "F-005 (perri) end-user adapter distribution/activation — triaged; activation = `adapter add --github` (shipped, doc-gap); auto file_pull = roadmap"
metadata: 
  node_type: memory
  type: project
  originSessionId: 7f5a5890-9c8c-4043-bcb6-647b6f7a36d7
---

perri F-005 (2026-06-15, dogfooding cplugs publish): a fresh-install agent saw `spt` binary present, reported "no install needed", but `spt adapter list` showed `claude-spt: deregistered` — binary present != adapter active, and no published path tells an end-user machine how to acquire+register the adapter manifest (plugin ships no manifest per ADR-0001).

**Triaged against source — decomposes into 3 (NOT one gap):**
1. `self_verifies` (her #2) = DOCS-NOT-READ — manifest.md `[update]` documents it ("attests the updater verifies its content; unattested delegated update is SKIPPED as unverifiable"). Author SETS self_verifies=true to assert; not a silent CC requirement.
2. `file_pull` shape (her #1) = MOSTLY DOCUMENTED (manifest.md: repo + signing_key Ed25519 64hex + "you sign with your own key"). Genuine gap: author-side Ed25519 key PROVISIONING undocumented.
3. Zero-touch AUTO-activation via file_pull network-pull (her #3) = ROADMAP. Evidence: adapter_update.rs is DECISION+VERIFICATION only — "the actual byte transport for file_pull (the network pull) is REQ-UPD-1/M4; v1 receives the payload via self-fetch/out-of-band ... does not itself fetch." Install-conduct emits ADAPTER_INSTALL_DEFERRED.

**THE PATH THAT WORKS TODAY:** `spt adapter add --github <author>/<repo>` (cli.rs:480 — clones under adapters/_github/, manifest-first, conducts the [update] avenue once). Shipped (REQ-INSTALL-4 impl/unit; only real-repo E2E deferred, DEFERRED.md). So /sptc:setup must run `adapter add --github` after the binary check = the missing activation step.

**Disposition: (a)+(b) mix, nothing unbuildable.** Auto file_pull = (b) roadmap (REQ-UPD-1). Activation step + signing-key provisioning = (a) doc-gaps.

**DOC ACTION I OWN (docs-site):** (i) post-install ACTIVATION step (`adapter add [--github]`) in install-on-demand + integration-checklist; (ii) author Ed25519 signing-key provisioning; (iii) explicit "zero-touch file_pull auto-distribution is roadmap (REQ-UPD-1)" note. Publish via [[adapter-tips-published-docs]] mechanics (xtask check+site → docs-publish dispatch). See [[perri-question-triage-protocol]].