Merge pull request #10 from BaseInfinity/v0.10.4-small-model

v0.10.4: small_model top-level pin (--small-* flags)

Author: BaseInfinity

CHANGELOG.md

@@ -2,6 +2,71 @@
 
 All notable changes to opencode-sdlc-wizard.
 
+## [0.10.4] - 2026-05-18
+
+### Added — `small_model` top-level pin (`--small-*` flags)
+
+May-17 community-patterns research found 35–40% of surveyed
+`opencode.json` files set the top-level `small_model` field — OpenCode's
+cross-cutting hint for "use this when the call is cheap" (title
+generation, summary blurbs, anywhere a small/fast model suffices over
+the global `model`). Distinct from `agent.plan.model` (which only
+affects plan-mode tasks); `small_model` is consulted by any agent.
+
+```bash
+# Set Opus as the build model, Haiku as the cheap fallback for
+# title/summary work
+npx opencode-sdlc-wizard pick \
+  --tier proprietary --provider anthropic \
+  --small-tier proprietary --small-provider anthropic --small-model claude-haiku-4-5
+```
+
+Yields:
+
+```json
+{
+  "model": "anthropic/claude-opus-4-7",
+  "small_model": "anthropic/claude-haiku-4-5",
+  "provider": { "anthropic": { ... } }
+}
+```
+
+`--small-*` composes cleanly with v0.10.0 reviewer, v0.10.1 sandboxes,
+v0.10.2 planner. Full v0.10.x stack in one call works.
+
+### Changed — `scripts/configure-backend.sh`
+
+- New `--small-tier T --small-provider P --small-model M` flags
+  (all-or-nothing triplet; partial spec exits 2)
+- `small_model` value is `"<canonical_provider>/<model>"` using the same
+  `PROVIDER_ALIASES` map
+- Small-side provider block deep-merges; same-provider as coder/reviewer/
+  planner collapses to one block
+- Canonical key order updated: top-level is now `$schema`, `model`,
+  `small_model`, `provider`, then rest alphabetical (matches the
+  joelhooks + ppries community configs we surveyed — keeps the two
+  top-level pins visually adjacent)
+
+### Changed — `scripts/pick-backend.sh`
+
+- New `--small-tier T --small-provider P [--small-model M]` flags
+- `--small-model` optional; filled from `default_model_for()` (same
+  source of truth used for coder / reviewer / planner)
+- Partial-spec validation via the existing `validate_agent_triplet()`
+  helper — no new error-handling code path
+
+### Tests
+
+- `tests/test-backend-picker.sh` adds T44–T48
+- `tests/test-pick.sh` adds T28–T32
+- **369 tests across 12 suites** (was 357 / 12 in v0.10.3)
+
+### Compat
+
+- 14 of 14 v0.10.3 default-model entries unchanged.
+- Opt-in only. Existing v0.9.x / v0.10.x configs unchanged unless
+  `--small-*` flags are passed.
+
 ## [0.10.3] - 2026-05-18
 
 ### Changed — two more research-verified default-model bumps

package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-sdlc-wizard",
-  "version": "0.10.3",
+  "version": "0.10.4",
   "description": "SDLC enforcement for OpenCode CLI — privacy-first, any-backend portability with a four-tier backend picker plus an OSS-tier cross-model-review skill so the full SDLC loop can run with zero Anthropic+OpenAI lock-in. Ships JSON Schemas for review artifacts so any consumer (cross-model-review, ditto, CI) can validate. Install with `npx opencode-sdlc-wizard init`. Sibling of agentic-sdlc-wizard and codex-sdlc-wizard.",
   "bin": {
     "opencode-sdlc-wizard": "cli/bin/opencode-sdlc-wizard.js"

scripts/configure-backend.sh

@@ -40,6 +40,13 @@ REVIEWER_MODEL=""
 PLANNER_TIER=""
 PLANNER_PROVIDER=""
 PLANNER_MODEL=""
+# v0.10.4 small_model: top-level fast/cheap fallback distinct from
+# agent.plan.model. Community signal: 35-40% of configs set this. Same
+# triplet shape, writes the top-level `small_model` field plus the
+# small-model provider block (deep-merged with coder/reviewer/planner).
+SMALL_TIER=""
+SMALL_PROVIDER=""
+SMALL_MODEL=""
 # v0.10.1 Per-agent permission sandboxing. Boolean flags inject canonical
 # permission.write blocks for the two highest-signal agents from May-2026
 # community-patterns research (9/15 configs use this): test-writer scoped
@@ -76,6 +83,12 @@ while [ $# -gt 0 ]; do
     --planner-provider=*) PLANNER_PROVIDER="${1#*=}" ;;
     --planner-model) shift; PLANNER_MODEL="${1:-}" ;;
     --planner-model=*) PLANNER_MODEL="${1#*=}" ;;
+    --small-tier) shift; SMALL_TIER="${1:-}" ;;
+    --small-tier=*) SMALL_TIER="${1#*=}" ;;
+    --small-provider) shift; SMALL_PROVIDER="${1:-}" ;;
+    --small-provider=*) SMALL_PROVIDER="${1#*=}" ;;
+    --small-model) shift; SMALL_MODEL="${1:-}" ;;
+    --small-model=*) SMALL_MODEL="${1#*=}" ;;
     --sandbox-test-writer) SANDBOX_TEST_WRITER=1 ;;
     --sandbox-docs) SANDBOX_DOCS=1 ;;
     -h|--help) usage; exit 0 ;;
@@ -110,6 +123,16 @@ if [ "$PL_SET" -ne 0 ] && [ "$PL_SET" -ne 3 ]; then
   exit 2
 fi
 
+# v0.10.4 small-model validation.
+SM_SET=0
+[ -n "$SMALL_TIER" ] && SM_SET=$((SM_SET+1))
+[ -n "$SMALL_PROVIDER" ] && SM_SET=$((SM_SET+1))
+[ -n "$SMALL_MODEL" ] && SM_SET=$((SM_SET+1))
+if [ "$SM_SET" -ne 0 ] && [ "$SM_SET" -ne 3 ]; then
+  echo "--small-tier / --small-provider / --small-model must all be set together (or none)" >&2
+  exit 2
+fi
+
 CONFIG_PATH="$TARGET_DIR/opencode.json"
 
 # Build the provider-specific fragment as a JSON string. We keep this in a
@@ -118,20 +141,23 @@ CONFIG_PATH="$TARGET_DIR/opencode.json"
 node - "$TIER" "$PROVIDER" "$MODEL" "$CONFIG_PATH" "$FORCE" "$PRINT_ONLY" \
      "$REVIEWER_TIER" "$REVIEWER_PROVIDER" "$REVIEWER_MODEL" \
      "$SANDBOX_TEST_WRITER" "$SANDBOX_DOCS" \
-     "$PLANNER_TIER" "$PLANNER_PROVIDER" "$PLANNER_MODEL" <<'NODE'
+     "$PLANNER_TIER" "$PLANNER_PROVIDER" "$PLANNER_MODEL" \
+     "$SMALL_TIER" "$SMALL_PROVIDER" "$SMALL_MODEL" <<'NODE'
 const fs = require("node:fs");
 const [
   tier, providerArg, model, configPath, forceStr, printOnlyStr,
   reviewerTier, reviewerProviderArg, reviewerModel,
   sandboxTestWriterStr, sandboxDocsStr,
   plannerTier, plannerProviderArg, plannerModel,
+  smallTier, smallProviderArg, smallModel,
 ] = process.argv.slice(2);
 const force = forceStr === "1";
 const printOnly = printOnlyStr === "1";
 const mixedMode = Boolean(reviewerTier && reviewerProviderArg && reviewerModel);
 const sandboxTestWriter = sandboxTestWriterStr === "1";
 const sandboxDocs = sandboxDocsStr === "1";
 const plannerMode = Boolean(plannerTier && plannerProviderArg && plannerModel);
+const smallMode = Boolean(smallTier && smallProviderArg && smallModel);
 
 // Canonical provider IDs. Detector emits user-friendly aliases; we accept both
 // and emit the canonical OpenCode/models.dev ID in the written config so model
@@ -451,6 +477,17 @@ if (plannerMode) {
   });
 }
 
+// v0.10.4 small_model: top-level field (not nested under agent). Distinct
+// from agent.plan.model — small_model is OpenCode's cross-cutting hint
+// for "use this when the call is cheap" (title generation, summary
+// blurbs, etc.). 35-40% of community configs set this.
+if (smallMode) {
+  const smallProvider = PROVIDER_ALIASES[smallProviderArg] || smallProviderArg;
+  const smallFragment = fragmentFor(smallTier, smallProvider, smallModel);
+  merged.provider = deepMerge(merged.provider, smallFragment.provider || {});
+  merged.small_model = smallFragment.model;
+}
+
 // v0.10.1 Per-agent permission sandboxing. Each flag injects the canonical
 // permission.write pattern for that agent — deep-merged so it composes
 // with Mixed-Mode (--reviewer-*) and any user-set sibling fields. Patterns
@@ -489,7 +526,10 @@ function sortKeysCanonical(obj, topLevel = false) {
     const keys = Object.keys(obj);
     let ordered;
     if (topLevel) {
-      const preferred = ["$schema", "model", "provider"];
+      // v0.10.4: small_model lives right after `model` per the joelhooks
+      // and ppries community configs we surveyed — keeps the two top-level
+      // pins visually adjacent.
+      const preferred = ["$schema", "model", "small_model", "provider"];
       const front = preferred.filter((k) => keys.includes(k));
       const rest = keys.filter((k) => !preferred.includes(k)).sort();
       ordered = [...front, ...rest];

scripts/pick-backend.sh

@@ -59,6 +59,12 @@ REVIEWER_MODEL=""
 PLANNER_TIER=""
 PLANNER_PROVIDER=""
 PLANNER_MODEL=""
+# v0.10.4 small_model: global fast/cheap fallback. Same triplet shape;
+# writes top-level `small_model` (not under agent.). Per May-17 research,
+# 35-40% of community configs set this.
+SMALL_TIER=""
+SMALL_PROVIDER=""
+SMALL_MODEL=""
 # v0.10.1 Per-agent permission sandboxing. Passthrough to configure-backend's
 # matching flags — canonical permission.write block per agent (test/spec
 # files for test-writer, .md only for docs).
@@ -90,6 +96,12 @@ while [ $# -gt 0 ]; do
     --planner-provider=*) PLANNER_PROVIDER="${1#*=}" ;;
     --planner-model) shift; PLANNER_MODEL="${1:-}" ;;
     --planner-model=*) PLANNER_MODEL="${1#*=}" ;;
+    --small-tier) shift; SMALL_TIER="${1:-}" ;;
+    --small-tier=*) SMALL_TIER="${1#*=}" ;;
+    --small-provider) shift; SMALL_PROVIDER="${1:-}" ;;
+    --small-provider=*) SMALL_PROVIDER="${1#*=}" ;;
+    --small-model) shift; SMALL_MODEL="${1:-}" ;;
+    --small-model=*) SMALL_MODEL="${1#*=}" ;;
     --sandbox-test-writer) SANDBOX_TEST_WRITER=1 ;;
     --sandbox-docs) SANDBOX_DOCS=1 ;;
     -h|--help) usage; exit 0 ;;
@@ -208,6 +220,7 @@ validate_agent_triplet() {
 }
 validate_agent_triplet "reviewer" "$REVIEWER_TIER" "$REVIEWER_PROVIDER" "$REVIEWER_MODEL"
 validate_agent_triplet "planner"  "$PLANNER_TIER"  "$PLANNER_PROVIDER"  "$PLANNER_MODEL"
+validate_agent_triplet "small"    "$SMALL_TIER"    "$SMALL_PROVIDER"    "$SMALL_MODEL"
 
 # Resolve reviewer-model default if --reviewer-tier + --reviewer-provider
 # set but --reviewer-model not. Same default-model map as the coder pin.
@@ -228,6 +241,15 @@ if [ -n "$PLANNER_TIER" ] && [ -n "$PLANNER_PROVIDER" ] && [ -z "$PLANNER_MODEL"
   }
 fi
 
+# Same default-model fallback for the small (cheap/fast) side.
+if [ -n "$SMALL_TIER" ] && [ -n "$SMALL_PROVIDER" ] && [ -z "$SMALL_MODEL" ]; then
+  SMALL_MODEL="$(default_model_for "$SMALL_TIER" "$SMALL_PROVIDER")" || {
+    echo "pick: no default model known for small $SMALL_TIER/$SMALL_PROVIDER." >&2
+    echo "  Pass --small-model <name> explicitly." >&2
+    exit 4
+  }
+fi
+
 # Forward to configure-backend.sh. --dry-run becomes --print-only on the
 # configurator (it prints the merged JSON but does not write the file).
 CONFIGURE_ARGS=(--tier "$TIER" --provider "$PROVIDER" --model "$MODEL")
@@ -248,6 +270,13 @@ if [ -n "$PLANNER_TIER" ]; then
     --planner-model "$PLANNER_MODEL"
   )
 fi
+if [ -n "$SMALL_TIER" ]; then
+  CONFIGURE_ARGS+=(
+    --small-tier "$SMALL_TIER"
+    --small-provider "$SMALL_PROVIDER"
+    --small-model "$SMALL_MODEL"
+  )
+fi
 [ "$SANDBOX_TEST_WRITER" = "1" ] && CONFIGURE_ARGS+=(--sandbox-test-writer)
 [ "$SANDBOX_DOCS" = "1" ]        && CONFIGURE_ARGS+=(--sandbox-docs)
 

tests/test-backend-picker.sh

@@ -928,6 +928,115 @@ console.log('ok');
   fi
 fi
 
+# --- v0.10.4 small_model: global fast/cheap fallback. May-17 research found
+# 35-40% of community configs set this top-level field. Distinct from
+# agent.plan.model (which only affects plan-mode tasks) — small_model is
+# the cross-cutting "use this when the call is cheap" hint. Flags mirror
+# the reviewer/planner triplet shape: --small-tier T --small-provider P
+# [--small-model M, optional; filled from default-model map].
+
+# --- T44: --small-* triplet writes top-level small_model + small provider block
+if [ -x "$CONFIG" ]; then
+  T="$TMP_ROOT/t44"; mkdir -p "$T"
+  (cd "$T" && "$CONFIG" \
+     --tier proprietary --provider anthropic --model claude-opus-4-7 \
+     --small-tier proprietary --small-provider anthropic --small-model claude-haiku-4-5 \
+     >/dev/null 2>&1) || true
+  if [ -f "$T/opencode.json" ]; then
+    ok="$(node -e "
+const j=require('$T/opencode.json');
+if(j.model!=='anthropic/claude-opus-4-7'){console.log('coder-wrong:'+j.model);process.exit(1)}
+if(j.small_model!=='anthropic/claude-haiku-4-5'){console.log('small_model-wrong:'+j.small_model);process.exit(1)}
+console.log('ok');
+" 2>/dev/null || echo 'failed')"
+    if [ "$ok" = "ok" ]; then
+      pass "--small-* writes top-level small_model pin"
+    else
+      fail "T44 — $ok"
+    fi
+  fi
+fi
+
+# --- T45: --small-* uses canonical alias (e.g., google_aistudio → google)
+if [ -x "$CONFIG" ]; then
+  T="$TMP_ROOT/t45"; mkdir -p "$T"
+  (cd "$T" && "$CONFIG" \
+     --tier proprietary --provider anthropic --model claude-opus-4-7 \
+     --small-tier proprietary --small-provider google_aistudio --small-model gemini-2.5-flash \
+     >/dev/null 2>&1) || true
+  if [ -f "$T/opencode.json" ]; then
+    ok="$(node -e "
+const j=require('$T/opencode.json');
+if(j.small_model!=='google/gemini-2.5-flash'){console.log('alias-pin-wrong:'+j.small_model);process.exit(1)}
+if(!j.provider.google){console.log('alias-provider-missing');process.exit(1)}
+console.log('ok');
+" 2>/dev/null || echo 'failed')"
+    if [ "$ok" = "ok" ]; then
+      pass "--small-provider alias resolves to canonical (google_aistudio → google)"
+    else
+      fail "T45 — $ok"
+    fi
+  fi
+fi
+
+# --- T46: --small-* composes with --reviewer-* + --planner-* + --sandbox-*
+if [ -x "$CONFIG" ]; then
+  T="$TMP_ROOT/t46"; mkdir -p "$T"
+  (cd "$T" && "$CONFIG" \
+     --tier proprietary --provider anthropic --model claude-opus-4-7 \
+     --small-tier proprietary --small-provider anthropic --small-model claude-haiku-4-5 \
+     --reviewer-tier hosted_oss --reviewer-provider cerebras --reviewer-model gpt-oss-120b \
+     --planner-tier hosted_oss --planner-provider groq --planner-model gpt-oss-120b \
+     --sandbox-test-writer --sandbox-docs >/dev/null 2>&1) || true
+  if [ -f "$T/opencode.json" ]; then
+    ok="$(node -e "
+const j=require('$T/opencode.json');
+if(j.small_model!=='anthropic/claude-haiku-4-5'){console.log('small-wrong');process.exit(1)}
+if(j.agent.review.model!=='cerebras/gpt-oss-120b'){console.log('rev-wrong');process.exit(1)}
+if(j.agent.plan.model!=='groq/gpt-oss-120b'){console.log('plan-wrong');process.exit(1)}
+if(!j.agent['test-writer'].permission.write){console.log('tw-wrong');process.exit(1)}
+console.log('ok');
+" 2>/dev/null || echo 'failed')"
+    if [ "$ok" = "ok" ]; then
+      pass "Full v0.10.x: --small-* + --reviewer-* + --planner-* + --sandbox-* all compose"
+    else
+      fail "T46 — $ok"
+    fi
+  fi
+fi
+
+# --- T47: partial --small-* spec rejected (all-or-nothing triplet)
+if [ -x "$CONFIG" ]; then
+  T="$TMP_ROOT/t47"; mkdir -p "$T"
+  rc=0
+  (cd "$T" && "$CONFIG" \
+     --tier private_local --provider ollama --model qwen3-coder:30b \
+     --small-tier proprietary >/dev/null 2>&1) || rc=$?
+  if [ "$rc" -ne 0 ] && [ ! -f "$T/opencode.json" ]; then
+    pass "partial --small-* spec rejected without writing opencode.json"
+  else
+    fail "T47 — partial small spec accepted (rc=$rc)"
+  fi
+fi
+
+# --- T48: no --small-* → no top-level small_model field (opt-in only)
+if [ -x "$CONFIG" ]; then
+  T="$TMP_ROOT/t48"; mkdir -p "$T"
+  (cd "$T" && "$CONFIG" --tier private_local --provider ollama --model qwen3-coder:30b >/dev/null 2>&1) || true
+  if [ -f "$T/opencode.json" ]; then
+    ok="$(node -e "
+const j=require('$T/opencode.json');
+if('small_model' in j){console.log('unexpected-small_model');process.exit(1)}
+console.log('ok');
+" 2>/dev/null || echo 'failed')"
+    if [ "$ok" = "ok" ]; then
+      pass "no --small-* → no small_model field (opt-in regression guard)"
+    else
+      fail "T48 — $ok"
+    fi
+  fi
+fi
+
 echo ""
 echo "=== Results: $PASS passed, $FAIL failed ==="
 [ "$FAIL" -eq 0 ] || exit 1