C8: One-shot consumer upgrade capability — skill + command #31

Activity

1. diegohb

   added

   ready-for-agentFully specified, ready for an AFK agentFully specified, ready for an AFK agent

   on Oct 6, 2026
2. diegohb

   marked this as blocked by 3 issues on Oct 6, 2026

   • C5: Rewrite guidance suite and repo content to v2 (Effect-first) #28
   • C6: Migrate templates — generated packages are v2-native and Effect-first #29
   • C7: Update all ten agent definitions to v2 facts #30
3. diegohb

   marked this as blocking on Oct 6, 2026

   • C9: Release 1.0.0 — version bump, changelog, tag-push publish #32
4. diegohb

   added a parent issue on Oct 6, 2026

   • Spec: opencode-architect 1.0.0 — v2-native plugin, Effect-first guidance suite, one-shot consumer v2 upgrade #23
5. diegohb commented on Oct 7, 2026

   

   diegohb

   on Oct 7, 2026

   MemberAuthor

   More actions

   Implementation landed on v2/issue-31-oneshot-upgrade (3 commits, typecheck + 217 tests green).

   Deliverable (scope: skill + command + load-time registration, agreed with the maintainer — no deterministic upgrade engine):

   • skills/opencode-v2-upgrade/SKILL.md — the one-shot v1→v2 upgrade skill: inventory, project classification, config rewrite mapping (facts §5/§6), plugin port (facts §1/§2/§9), v1 tool-file port (facts §8), recommendations report (facts §4/§9/§10/§11), and a safety contract (no-op on v2, skip consumer-modified files by manifest hash, never touch the app installation, preserve unparseable configs).
   • commands/upgrade-opencode-v2.md — the /upgrade-opencode-v2 slash command.
   • src/skill-loader.ts + src/command-loader.ts + shared src/frontmatter.ts; the plugin registers both at load via ctx.skill.transform and ctx.command.transform (command execute re-submits its template through ctx.session.prompt with the skill attached).
   • Harness + load-hook now audit skill/command registration; package.json ships skills/commands; README/AGENTS/CONTEXT/architect/oneshots updated.

   Acceptance evidence:

   • tests/fixtures/v1-extension-package (agent-inspired v1 config + plugin + tool + agent/skill/command) and tests/fixtures/v2-extension-package (its upgraded output + report). Tests prove the rewritten config validates against the pinned @opencode/schema Config.Info and carries no v1 key — i.e. the clean no-op precondition.
   • Ran the flow on the v1 fixture out-of-tree: produced upgraded plugin code, a rewritten config (schema-valid, zero remaining v1 keys), and a recommendations report. Consumer-modified skip and app-untouched guarantees are in the skill's safety contract, backed by the existing manifest/hash machinery.
   • Skill/command pass the frontmatter-hygiene and docs-fact gates, ship in the npm tarball, and follow the suite's authoring conventions (third-person description, facts citations, D6-quoted frontmatter).

   Not closing yet — confirm and I'll close, and I can open the PR.
6. diegohb

   closed this as completedin 955f846on Oct 7, 2026