Files
stack/docs/PRDs/2026-08-31_PRD_rev1/PROV.1-providers.md
T
jason.woltje ad21ad7ac5
ci/woodpecker/pr/ci Pipeline failed
docs: ratify PRD rev1 — consolidated bundle, permanent shim, rev0 archived
Ratifies the Mosaic Stack PRD rev1 (Jason Woltje, 2026-09-01) as project
source of truth and installs the GOV.1 lifecycle model:

- docs/PRD.md becomes a permanent shim (kind: shim, current_rev ->
  docs/PRDs/2026-08-31_PRD_rev1/). Its path never changes again.
- docs/PRDs/2026-08-26_PRD_rev0/PRD.md archives the 2026-08-26 North Star
  verbatim (sha256 60cc2f98...36afdf unchanged). Archive, never delete.
- docs/PRDs/2026-08-31_PRD_rev1/ is the frozen rev1 bundle: 18 sectioned
  documents (VIS, DATA, AUTHN, AUTHZ, SEAT, ROLE, HARN, PROV, SESS, UI, CLI,
  GOV.1-5) consolidating rev0 D1-D15, the fleet north star, the agent-runtime
  L1/L2 contracts and the control-plane-surfaces lane findings, with a single
  decision map (GOV.3) and a closed open-questions frontier (GOV.5, grill
  rounds 1-8). Drafting inputs (_source-* snapshots) are not shipped.

Consequences of the ratified rulings carried in the same change:

- Q-T1 (ruling B, "shipped but frozen"): D3 amended in GOV.3/VIS.1;
  federation M1-M3 acknowledged as shipped behind tier === 'federated',
  excluded from the v1 bar and frozen, with a security re-audit gate before
  any resumption. docs/MISSION-MANIFEST.md, docs/federation/MISSION-MANIFEST.md
  and docs/scratchpads/mvp-20260312.md get status: superseded + banners
  (content preserved verbatim); docs/guides/deployment.md gains a
  "Relationship to the PRD (D15)" section. NORTH_STAR.yaml adds dormant
  workstream M (projects no goals by design); NORTH_STAR.md regenerated.
- Q-G2 (distinct registry prefixes): every citation of the operator
  DECISION-REGISTER in the bundle reads OD-nn; the stack registry stays
  D1-D15; L1-Dnn/L2-Dnn untouched. Prefix rule recorded in GOV.1.

Follow-ups (not in this PR): CI parity drift-gate witness (Q-C1); brain-side
DECISION-REGISTER rename to OD- with redirect table on its next touch.
2026-09-01 18:32:14 -05:00

1.4 KiB

id, status, ratified
id status ratified
PROV.1 ratified 2026-09-01 (Jason Woltje; PRD rev1 ratification PR)

PROV.1 — Provider configuration

A provider is a model-inference source: hosted (Claude, OpenAI, ZAI, N others) or local (Ollama, LM Studio, other).

Provider configuration surface (WebUI page + CLI)

Control Notes
provider selection dropdown of supported providers
name user-chosen instance name (multiple named instances of one provider type are expected)
auth mode OAuth or API key — the account itself lives in AUTHN.1-auth-accounts
local provider setup endpoint/port for Ollama, LM Studio, other local providers
activate / deactivate inactive providers are not selectable downstream

Provider records are runtime state (Postgres-owned, projected). Credentials never enter provider records; they live with the credential broker (AUTHN.1-auth-accounts).

E2 inputs (triage 2026-08-31; see GOV.2-docs-inventory)

Canonical ground truth: DEVELOPER-GUIDE/architecture/decisions/mos-runtime-portability-m1.md (the only current ADR for the logical-agent/connector-lease identity model); ADMIN-GUIDE/operations/mos-connector-lease-operations.md — connector activation is a deliberate deny-all hold; nothing in this section may imply it is live. Drafts noted: rfcs/optional-ai-egress-gateways.md (non-operative; separates IProviderAdapter from egress-gateway concerns).