@dombaras/agent-harness 0.1.8 → 0.1.9

package/README.md

@@ -98,6 +98,14 @@ warns but does not block; the guarantee only applies to registered flows.
 - `npm run test:dispatch` mechanically verifies model pins against
   `scripts/qa/models.allowlist.txt` and that `model-routing.md` does not name a
   stale model no longer pinned anywhere (doc↔config drift).
+- **`/switch-model` command** — every deploy ships an opencode command
+  (`.opencode/command/switch-model.md`) plus `scripts/switch-reasoning-model.ps1`
+  that rewrites the main `opencode.json` `model` and the six reasoning-tier
+  agents (planner, system-architect, security-engineer, diagnostics-expert,
+  product-manager, qa-architect) in one step. Aliases: `deepseek`/`direct` →
+  `deepseek/deepseek-v4-pro` (default, direct API key), `zen`/`opencode` →
+  `opencode/deepseek-v4-pro` (gateway), `pickle` → `opencode/big-pickle`, or any
+  explicit `provider/model`. Restart opencode after switching (config reads once).
 
 ## QA gates
 

package/bin/agent-harness.js

@@ -473,7 +473,9 @@ function printSummary(result, isUpdate) {
 
 /* Best-effort warning: when this CLI's version is not the latest published on
  * the registry, flag it. This catches the "bumped + ran update from a local
- * checkout, but never published" silent gap. */
+ * checkout, but never published" silent gap. Publish guidance stays inline so a
+ * failed `npm publish` (401/404 auth/permission) never leaves the developer
+ * staring at a raw npm error — it points them at `npm login`. */
 function printUnpublishedWarning() {
   const published = publishedLatestVersion();
   if (published == null || published === "" || published === PKG.version) return;
@@ -485,6 +487,12 @@ function printUnpublishedWarning() {
       `NOT published — Publish first, then \`update\` other projects, or they will ` +
       `branch off an older harness.`
   );
+  console.log(
+    `    To publish: run \`npm publish\` from the harness repo. If it fails with ` +
+      `E401/E404 (auth or permission), you are not logged in as the package owner ` +
+      `(\`npm owner ls ${PKG.name}\` shows who owns it) — run \`npm login\` first, ` +
+      `then publish again. Login: https://www.npmjs.com/login`
+  );
 }
 
 function printNextSteps() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dombaras/agent-harness",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Reusable multi-agent harness for AI-assisted development: personas, skills, operating rules, model routing, and QA gates. Deploy into any project with `npx @dombaras/agent-harness init`.",
   "bin": {
     "agent-harness": "bin/agent-harness.js"

package/templates/.opencode/agents/diagnostics-expert.md

@@ -1,7 +1,7 @@
 ---
 description: Use when debugging errors, performance regressions, or API anomalies — log-first investigation, ExternalServiceLog, cold-start profiling, authentic reproduction.
 mode: subagent
-model: opencode/deepseek-v4-pro
+model: deepseek/deepseek-v4-pro
 temperature: 0.1
 steps: 30
 permission:

package/templates/.opencode/agents/planner.md

@@ -1,7 +1,7 @@
 ---
 description: Use to plan/decompose a task and emit the Step Zero subagent dispatch plan (personas, models, order, parallel batches) before any file is touched.
 mode: subagent
-model: opencode/deepseek-v4-pro
+model: deepseek/deepseek-v4-pro
 temperature: 0.1
 steps: 15
 hidden: true

package/templates/.opencode/agents/product-manager.md

@@ -1,7 +1,7 @@
 ---
 description: Use when designing features, gamification, or user journeys — maps DB logic to UX with the 5 UI states.
 mode: subagent
-model: opencode/deepseek-v4-pro
+model: deepseek/deepseek-v4-pro
 steps: 20
 permission:
   edit: deny

package/templates/.opencode/agents/qa-architect.md

@@ -1,7 +1,7 @@
 ---
 description: Use to design the QA plan for a change — inspects the diff, assesses risk, selects the minimal tier, and authors progression tests (thinker only; does not run suites).
 mode: subagent
-model: opencode/deepseek-v4-pro
+model: deepseek/deepseek-v4-pro
 temperature: 0.1
 steps: 20
 permission:

package/templates/.opencode/agents/security-engineer.md

@@ -1,7 +1,7 @@
 ---
 description: Use when a change touches auth, secrets, input validation, external services, or dependencies — security review + audit.
 mode: subagent
-model: opencode/deepseek-v4-pro
+model: deepseek/deepseek-v4-pro
 steps: 30
 permission:
   edit:

package/templates/.opencode/agents/system-architect.md

@@ -1,7 +1,7 @@
 ---
 description: Use when changing the Prisma schema, data model, multi-tenant boundaries, privacy tiers, or sync protocol.
 mode: subagent
-model: opencode/deepseek-v4-pro
+model: deepseek/deepseek-v4-pro
 steps: 40
 permission:
   edit:

package/templates/.opencode/command/switch-model.md

@@ -0,0 +1,25 @@
+---
+description: Switch the reasoning-tier model (default deepseek/deepseek-v4-pro direct).
+---
+
+Change the reasoning-tier model to `$ARGUMENTS`.
+
+Valid values:
+- `deepseek` / `direct` (default) -> `deepseek/deepseek-v4-pro` (direct API key)
+- `zen` / `opencode` -> `opencode/deepseek-v4-pro` (Zen gateway)
+- `pickle` / `big-pickle` -> `opencode/big-pickle`
+- any other explicit model id (e.g. `opencode/gpt-5.6-luna`)
+
+Run:
+
+```
+powershell -ExecutionPolicy Bypass -File scripts/switch-reasoning-model.ps1 -Target $ARGUMENTS
+```
+
+This rewrites the `model` field in `opencode.json` and the `model:` frontmatter
+of the six reasoning-tier agents (planner, system-architect, security-engineer,
+diagnostics-expert, product-manager, qa-architect).
+
+Report the old model -> new model delta, and remind the user that opencode
+does not hot-reload config, so they must quit and restart for it to take
+effect.

package/templates/opencode.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://opencode.ai/config.json",
-  "model": "opencode/deepseek-v4-pro",
+  "model": "deepseek/deepseek-v4-pro",
   "small_model": "opencode/gpt-5-nano",
   "instructions": [".agents/rules/00-operating.md"]
 }

package/templates/scripts/switch-reasoning-model.ps1

@@ -0,0 +1,70 @@
+param(
+  [Parameter(Mandatory = $true)][string]$Target
+)
+
+$ErrorActionPreference = "Stop"
+
+$root = Split-Path -Parent $PSScriptRoot
+
+$aliases = @{
+  "deepseek"       = "deepseek/deepseek-v4-pro"
+  "deepseek-v4-pro" = "deepseek/deepseek-v4-pro"
+  "direct"         = "deepseek/deepseek-v4-pro"
+  "zen"            = "opencode/deepseek-v4-pro"
+  "opencode"       = "opencode/deepseek-v4-pro"
+  "big-pickle"     = "opencode/big-pickle"
+  "pickle"         = "opencode/big-pickle"
+  "bigpickle"      = "opencode/big-pickle"
+}
+
+$targetModel = $Target
+if ($aliases.ContainsKey($Target.ToLowerInvariant())) {
+  $targetModel = $aliases[$Target.ToLowerInvariant()]
+}
+elseif (-not ($targetModel -match "^[a-zA-Z0-9._-]+/")) {
+  $targetModel = "deepseek/$targetModel"
+}
+
+$reasoningModels = @(
+  "deepseek/deepseek-v4-pro",
+  "opencode/deepseek-v4-pro",
+  "opencode/big-pickle"
+)
+
+$files = @(
+  "opencode.json",
+  ".opencode/agents/planner.md",
+  ".opencode/agents/system-architect.md",
+  ".opencode/agents/security-engineer.md",
+  ".opencode/agents/diagnostics-expert.md",
+  ".opencode/agents/product-manager.md",
+  ".opencode/agents/qa-architect.md"
+)
+
+$changed = @()
+foreach ($rel in $files) {
+  $path = Join-Path $root $rel
+  if (-not (Test-Path -LiteralPath $path)) {
+    Write-Warning "missing: $rel"
+    continue
+  }
+  $content = Get-Content -LiteralPath $path -Raw
+  $new = $content
+  foreach ($m in $reasoningModels) {
+    $new = $new -replace [regex]::Escape($m), $targetModel
+  }
+  if ($new -ne $content) {
+    Set-Content -LiteralPath $path -Value $new -NoNewline
+    $changed += $rel
+  }
+}
+
+Write-Output ("Switched reasoning-tier model -> {0}" -f $targetModel)
+if ($changed.Count -gt 0) {
+  Write-Output "Updated:"
+  $changed | ForEach-Object { Write-Output "  - $_" }
+}
+else {
+  Write-Output "No files changed (already set)."
+}
+Write-Output "Restart opencode for the change to take effect."