Skip to content

chore(AI-011): archive spec + correct opencode.jsonc Layer 1 comment#39

Merged
mlorentedev merged 1 commit into
mainfrom
chore/AI-011-archive
May 18, 2026
Merged

chore(AI-011): archive spec + correct opencode.jsonc Layer 1 comment#39
mlorentedev merged 1 commit into
mainfrom
chore/AI-011-archive

Conversation

@mlorentedev
Copy link
Copy Markdown
Owner

Summary

AI-011-opencode-bootstrap validation closed 2026-05-17. Closes the lifecycle.

  • git mv specs/AI-011-opencode-bootstrap/ specs/archive/ — durable artifact is the runbook, not the spec scaffolding
  • Correct misleading "Layer 1 of PAYG guardrail" comment in ai/opencode/opencode.jsonc. Empirical finding during validation: the provider.opencode-go.models block does not restrict the /models picker — it only enriches display names. Real PAYG protection lives entirely in Layers 2 (Zen workspace cap) + 3 (no PAYG payment method) + the Go subscription's inherent catalog (~12 cheap Chinese LLMs, no frontier models routable via opencode-go)
  • Update spec path comment at top of opencode.jsonc to point at archived location

Findings folded into runbook (vault, separate commit)

40-runbooks/guide-opencode-go-setup.md already updated with six empirical findings:

  1. models block ≠ /models whitelist (only display metadata)
  2. Cost in TUI status bar = theoretical PAYG-equivalent, not actual billing
  3. opencode TUI slow under tmux (ANSI re-emission overhead); opencode run unaffected; recommended workflow Ghostty native splits/tabs for opencode TUI + tmux for shell/SSH
  4. DeepSeek V4 Pro first-token ~1–3s from Europe vs Sonnet 0.3–0.8s
  5. Full Go catalog has 12 models; UI-driven activation selects subset
  6. Ghostty theme name format = literal capitalization with space (Catppuccin Mocha)

Test plan

  • git mv preserves history (3 renames, all files staged as R)
  • opencode.jsonc still parses as JSONC (no structural changes, only comment text)
  • Healthcheck section 10/11 still passes (config sync check, unaffected by comment rewrite)
  • CI green

AI-011-opencode-bootstrap validation closed (2026-05-17):
- /connect to OpenCode Go succeeded, deepseek-v4-pro responding
- Layers 2-3 PAYG guardrail confirmed in Zen dashboard
- Six empirical findings folded into runbook before archive

Archive: specs/AI-011-opencode-bootstrap/ → specs/archive/

Fix in opencode.jsonc: the original "Layer 1" comment claimed the
provider.opencode-go.models block restricts the /models picker. Empirically
false — that block enriches display names only; the picker shows whatever
the user activates via the UI. Real PAYG protection lives entirely in
Layers 2 (Zen workspace cap) + 3 (no PAYG payment method) + the Go
subscription's inherent catalog limitation (~12 cheap Chinese LLMs).
Comment rewritten to reflect reality.

Spec header path updated to point at the archived location.

CHANGELOG.md update remains pending separate PR.
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