@aiwg/cli 2026.9.12 → 2026.9.16

package/dist/src/config/aiwg-config.js

@@ -172,6 +172,7 @@ export function resolveDelivery(delivery) {
  *     less aggressive at small fan-outs (10 is a safe middle ground)
  *   - hermes: MCP sidecar; rate-limit depends on upstream provider, operator
  *     should tune. Conservative 10 default.
+ *   - grokbot: desktop multi-agent; conservative 4 until native evidence.
  *   - unknown: conservative 4 default.
  */
 export const PROVIDER_PARALLELISM_DEFAULTS = {
@@ -186,6 +187,13 @@ export const PROVIDER_PARALLELISM_DEFAULTS = {
     windsurf: { max_parallel_subagents: 10, max_parallel_ralph_loops: 3, max_parallel_mc_missions: 6 },
     openclaw: { max_parallel_subagents: 10, max_parallel_ralph_loops: 3, max_parallel_mc_missions: 6 },
     hermes: { max_parallel_subagents: 10, max_parallel_ralph_loops: 3, max_parallel_mc_missions: 6 },
+    // Desktop multi-agent; conservative until native concurrency evidence exists.
+    grokbot: { max_parallel_subagents: 4, max_parallel_ralph_loops: 2, max_parallel_mc_missions: 4 },
+    // Conservative defaults for remaining stable/experimental harnesses (#249).
+    openhuman: { max_parallel_subagents: 4, max_parallel_ralph_loops: 2, max_parallel_mc_missions: 4 },
+    omp: { max_parallel_subagents: 4, max_parallel_ralph_loops: 2, max_parallel_mc_missions: 4 },
+    pi: { max_parallel_subagents: 4, max_parallel_ralph_loops: 2, max_parallel_mc_missions: 4 },
+    'deepseek-harness': { max_parallel_subagents: 4, max_parallel_ralph_loops: 2, max_parallel_mc_missions: 4 },
 };
 const UNKNOWN_PROVIDER_PARALLELISM = {
     max_parallel_subagents: 4,
@@ -928,6 +936,35 @@ export async function writeAiwgConfig(projectDir, config) {
         }
     }
 }
+/**
+ * Ensure `provider` appears in `config.providers` without wiping others (#247).
+ * First entry is the primary provider for parallelism/doctor labels.
+ * When `asPrimary` is true (explicit `--provider` deploy), move the provider to the front.
+ */
+export function ensureProviderListed(config, provider, opts = {}) {
+    const normalized = provider.trim();
+    if (!normalized)
+        return config;
+    const providers = Array.isArray(config.providers) ? [...config.providers] : [];
+    const idx = providers.indexOf(normalized);
+    if (opts.asPrimary) {
+        if (idx === 0) {
+            config.providers = providers;
+            return config;
+        }
+        if (idx > 0)
+            providers.splice(idx, 1);
+        providers.unshift(normalized);
+    }
+    else if (idx < 0) {
+        providers.push(normalized);
+    }
+    else {
+        return config;
+    }
+    config.providers = providers;
+    return config;
+}
 /**
  * Update the `installed` record for a framework after a successful deployment.
  * Returns the updated config (does not write to disk — caller must call writeAiwgConfig).
@@ -975,6 +1012,8 @@ export function updateInstalled(config, name, provider, counts, opts) {
         delete existing.deployedArtifactHashes;
     }
     config.installed[name] = existing;
+    // Keep providers[] aligned with deployedTo so doctor/parallelism see the right primary (#247).
+    ensureProviderListed(config, provider, { asPrimary: opts.asPrimary === true });
     return config;
 }
 /**

package/dist/src/config/user-registry.js

@@ -25,6 +25,15 @@ import { userScopeConfigPath } from '../cli/scope-resolver.js';
  * never set this — it exists so the test suite can avoid clobbering the real
  * `~/.aiwg/installed.json` on the developer's machine.
  */
+/** True when AIWG_USER_REGISTRY_PATH redirects away from ~/.aiwg/installed.json. */
+export function isUserRegistryPathOverrideActive() {
+    return Boolean(process.env.AIWG_USER_REGISTRY_PATH?.trim());
+}
+/**
+ * Operator-facing warning for a leftover test override (#246).
+ * Docs mark AIWG_USER_REGISTRY_PATH as test-only; doctor/status/use must surface it.
+ */
+export const USER_REGISTRY_PATH_OVERRIDE_WARN = 'AIWG_USER_REGISTRY_PATH is set (test override active); user registry is not writing to default ~/.aiwg/installed.json';
 export function userRegistryPath() {
     const override = process.env.AIWG_USER_REGISTRY_PATH;
     if (override)

package/dist/src/extensions/manifest.js

@@ -121,6 +121,7 @@ export const ProviderConfigSchema = z.object({
         'cursor',
         'deepseek-harness',
         'factory',
+        'grokbot',
         'hermes',
         'opencode',
         'openclaw',

package/dist/src/models/model-capabilities.v1.json

@@ -4,88 +4,130 @@
   "verifiedAt": "2026-07-20",
   "providers": {
     "antigravity": {
-      "agent": "native", "skill": "native", "globalChild": "inherited",
+      "agent": "native",
+      "skill": "native",
+      "globalChild": "inherited",
       "identifierSyntax": "model identifier accepted by Antigravity CLI 1.1.26 --model",
-      "effortValues": ["low", "medium", "high"],
+      "effortValues": [
+        "low",
+        "medium",
+        "high"
+      ],
       "inheritance": "Omitted model and effort inherit the invoking Antigravity session",
       "invalidPinFallback": "Provider validation/error; never assume fallback",
       "configTarget": "agy launch arguments; custom-agent model tiers are not projected from generic AIWG model ids",
       "artifactFormat": "YAML frontmatter plus Markdown; runtime --model and --effort flags",
       "verification": "Pinned offline contract; authenticated model selection was not executed",
-      "sourceUrl": "https://antigravity.google/docs/cli/subagents/", "verifiedAt": "2026-09-04"
+      "sourceUrl": "https://antigravity.google/docs/cli/subagents/",
+      "verifiedAt": "2026-09-04"
     },
     "claude": {
-      "agent": "native", "skill": "native", "globalChild": "inherited",
+      "agent": "native",
+      "skill": "native",
+      "globalChild": "inherited",
       "identifierSyntax": "Claude alias or accepted Anthropic model ID",
-      "effortValues": ["low", "medium", "high"],
+      "effortValues": [
+        "low",
+        "medium",
+        "high"
+      ],
       "inheritance": "Omitted agent or skill fields inherit the invoking session",
       "invalidPinFallback": "Provider validation/error; never assume fallback",
       "configTarget": ".claude/agents/*.md and skill SKILL.md frontmatter",
       "artifactFormat": "YAML frontmatter plus Markdown",
       "verification": "Inspect deployed frontmatter and bounded invocation metadata",
-      "sourceUrl": "https://code.claude.com/docs/en/sub-agents", "verifiedAt": "2026-07-20"
+      "sourceUrl": "https://code.claude.com/docs/en/sub-agents",
+      "verifiedAt": "2026-07-20"
     },
     "codex": {
-      "agent": "native", "skill": "unsupported", "globalChild": "inherited",
+      "agent": "native",
+      "skill": "unsupported",
+      "globalChild": "inherited",
       "identifierSyntax": "Codex model slug accepted by config.toml",
-      "effortValues": ["minimal", "low", "medium", "high", "xhigh"],
+      "effortValues": [
+        "minimal",
+        "low",
+        "medium",
+        "high",
+        "xhigh"
+      ],
       "inheritance": "Omitted model and model_reasoning_effort inherit the parent session",
       "invalidPinFallback": "Strict config or runtime validation; never assume fallback",
       "configTarget": ".codex/agents/*.toml",
       "artifactFormat": "Standalone TOML custom-agent configuration",
       "verification": "Parse TOML and load in Codex custom-agent registry",
-      "sourceUrl": "https://learn.chatgpt.com/docs/agent-configuration/subagents", "verifiedAt": "2026-07-20"
+      "sourceUrl": "https://learn.chatgpt.com/docs/agent-configuration/subagents",
+      "verifiedAt": "2026-07-20"
     },
     "copilot": {
-      "agent": "native", "skill": "unsupported", "globalChild": "inherited",
+      "agent": "native",
+      "skill": "unsupported",
+      "globalChild": "inherited",
       "identifierSyntax": "Current Copilot custom-agent model identifier",
       "inheritance": "Omitted model uses session or Auto selection",
       "invalidPinFallback": "Plan/admin/catalog dependent; report unresolved",
       "configTarget": ".github/agents/*.agent.md",
       "artifactFormat": "YAML frontmatter plus Markdown",
       "verification": "Schema fixture and entitled Copilot invocation",
-      "sourceUrl": "https://docs.github.com/en/copilot/reference/custom-agents-configuration", "verifiedAt": "2026-07-20"
+      "sourceUrl": "https://docs.github.com/en/copilot/reference/custom-agents-configuration",
+      "verifiedAt": "2026-07-20"
     },
     "cursor": {
-      "agent": "native", "skill": "unsupported", "globalChild": "inherited",
+      "agent": "native",
+      "skill": "unsupported",
+      "globalChild": "inherited",
       "identifierSyntax": "Cursor-supported exact model ID",
       "inheritance": "Omitted model inherits parent selection",
       "invalidPinFallback": "Plan/admin fallback may apply; record observed result",
       "configTarget": ".cursor/agents/*.md",
       "artifactFormat": "YAML frontmatter plus Markdown",
       "verification": "Schema fixture and entitled Cursor invocation",
-      "sourceUrl": "https://cursor.com/docs/subagents", "verifiedAt": "2026-07-20"
+      "sourceUrl": "https://cursor.com/docs/subagents",
+      "verifiedAt": "2026-07-20"
     },
     "factory": {
-      "agent": "native", "skill": "informational", "globalChild": "native",
+      "agent": "native",
+      "skill": "informational",
+      "globalChild": "native",
       "identifierSyntax": "Factory model ID or Light/Medium/Heavy complexity",
-      "effortValues": ["low", "medium", "high"],
+      "effortValues": [
+        "low",
+        "medium",
+        "high"
+      ],
       "inheritance": "Droid may inherit org/session model policy",
       "invalidPinFallback": "Organization policy may substitute; record observed result",
       "configTarget": ".factory/droids/*.md and Factory settings",
       "artifactFormat": "YAML frontmatter plus Markdown",
       "verification": "Fixture validation and Factory CLI model report",
-      "sourceUrl": "https://docs.factory.ai/cli/configuration/custom-droids", "verifiedAt": "2026-07-20"
+      "sourceUrl": "https://docs.factory.ai/cli/configuration/custom-droids",
+      "verifiedAt": "2026-07-20"
     },
     "opencode": {
-      "agent": "native", "skill": "unsupported", "globalChild": "inherited",
+      "agent": "native",
+      "skill": "unsupported",
+      "globalChild": "inherited",
       "identifierSyntax": "provider/model-id",
       "inheritance": "Omitted agent model inherits global primary model",
       "invalidPinFallback": "Installed provider catalog determines error/fallback",
       "configTarget": ".opencode/agent/*.md",
       "artifactFormat": "YAML frontmatter plus Markdown",
       "verification": "Inspect artifact and OpenCode model registry",
-      "sourceUrl": "https://opencode.ai/docs/agents", "verifiedAt": "2026-07-20"
+      "sourceUrl": "https://opencode.ai/docs/agents",
+      "verifiedAt": "2026-07-20"
     },
     "warp": {
-      "agent": "global-only", "skill": "unsupported", "globalChild": "native",
+      "agent": "global-only",
+      "skill": "unsupported",
+      "globalChild": "native",
       "identifierSyntax": "Warp saved-profile or run model identifier",
       "inheritance": "All delegated work uses run/profile selection",
       "invalidPinFallback": "Profile availability dependent",
       "configTarget": "Warp agent profile or run configuration",
       "artifactFormat": "Saved profile / run control plane",
       "verification": "Inspect active profile and run metadata",
-      "sourceUrl": "https://docs.warp.dev/agent-platform/capabilities/agent-profiles-permissions", "verifiedAt": "2026-07-20"
+      "sourceUrl": "https://docs.warp.dev/agent-platform/capabilities/agent-profiles-permissions",
+      "verifiedAt": "2026-07-20"
     },
     "omp": {
       "agent": "native",
@@ -108,66 +150,109 @@
       "verifiedAt": "2026-09-04"
     },
     "pi": {
-      "agent": "native", "skill": "inherited", "globalChild": "native",
+      "agent": "native",
+      "skill": "inherited",
+      "globalChild": "native",
       "identifierSyntax": "provider/model identifier accepted by Pi --model",
-      "effortValues": ["minimal", "low", "medium", "high", "xhigh"],
+      "effortValues": [
+        "minimal",
+        "low",
+        "medium",
+        "high",
+        "xhigh"
+      ],
       "inheritance": "Omitted model and thinking level inherit the invoking Pi session",
       "invalidPinFallback": "Pi resolves against its configured catalog and exits on invalid explicit selection",
       "configTarget": "Pi headless launch arguments",
       "artifactFormat": "Runtime --model and --thinking flags",
       "verification": "Inspect strict JSONL state and the selected provider/model",
-      "sourceUrl": "https://github.com/earendil-works/pi/tree/main/packages/coding-agent#cli-reference", "verifiedAt": "2026-09-04"
+      "sourceUrl": "https://github.com/earendil-works/pi/tree/main/packages/coding-agent#cli-reference",
+      "verifiedAt": "2026-09-04"
     },
     "deepseek-harness": {
-      "agent": "native", "skill": "inherited", "globalChild": "native",
+      "agent": "native",
+      "skill": "inherited",
+      "globalChild": "native",
       "identifierSyntax": "provider/model passed through the SDK initialize request or agent-default-model Cordis row",
-      "effortValues": ["minimal", "low", "medium", "high", "xhigh"],
+      "effortValues": [
+        "minimal",
+        "low",
+        "medium",
+        "high",
+        "xhigh"
+      ],
       "inheritance": "Subagents inherit the configured Harness route unless explicitly overridden",
       "invalidPinFallback": "Explicit unavailable routes or models fail the request",
       "configTarget": "Ephemeral Cordis route patch and SDK initialize request",
       "artifactFormat": "agent-default-model config; JSON-RPC initialize params",
       "verification": "Pinned source contract plus opt-in headless OpenRouter smoke",
-      "sourceUrl": "https://github.com/deepseek-ai/deepseek-harness", "verifiedAt": "2026-09-05"
+      "sourceUrl": "https://github.com/deepseek-ai/deepseek-harness",
+      "verifiedAt": "2026-09-05"
     },
     "windsurf": {
-      "agent": "unsupported", "skill": "unsupported", "globalChild": "inherited",
+      "agent": "unsupported",
+      "skill": "unsupported",
+      "globalChild": "inherited",
       "identifierSyntax": "UI-selected provider model",
       "inheritance": "Child behavior follows the main UI session",
       "invalidPinFallback": "No portable custom-child selector",
       "configTarget": "No supported portable artifact field",
       "artifactFormat": "Informational policy only",
       "verification": "Assert unsupported fields are omitted",
-      "sourceUrl": "https://docs.devin.ai/desktop/cascade/skills", "verifiedAt": "2026-07-20"
+      "sourceUrl": "https://docs.devin.ai/desktop/cascade/skills",
+      "verifiedAt": "2026-07-20"
     },
     "openclaw": {
-      "agent": "native", "skill": "unsupported", "globalChild": "native",
+      "agent": "native",
+      "skill": "unsupported",
+      "globalChild": "native",
       "identifierSyntax": "Configured provider/model identifier",
       "inheritance": "Per-agent or per-spawn override falls back to global subagent model",
       "invalidPinFallback": "Provider/account fallback must be observed",
       "configTarget": "OpenClaw subagent configuration",
       "artifactFormat": "JSON/JSONC runtime configuration",
       "verification": "Inspect resolved subagent metadata",
-      "sourceUrl": "https://docs.openclaw.ai/tools/subagents", "verifiedAt": "2026-07-20"
+      "sourceUrl": "https://docs.openclaw.ai/tools/subagents",
+      "verifiedAt": "2026-07-20"
+    },
+    "grokbot": {
+      "agent": "unsupported",
+      "skill": "unsupported",
+      "globalChild": "informational",
+      "identifierSyntax": "No verified Grok Bot native model pin surface",
+      "inheritance": "AIWG does not invent Grok Bot model IDs; routing remains informational",
+      "invalidPinFallback": "Report unsupported; do not fabricate xAI/Grok model pins as native",
+      "configTarget": "Grok Bot has no verified AIWG-owned model config path",
+      "artifactFormat": "Informational only",
+      "verification": "Confirm steward models --route --provider grokbot emits unsupported/informational",
+      "sourceUrl": "https://github.com/jmagly/aiwg/blob/main/docs/architecture/adr-grokbot-provider-target.md",
+      "verifiedAt": "2026-09-15"
     },
     "hermes": {
-      "agent": "global-only", "skill": "unsupported", "globalChild": "native",
+      "agent": "global-only",
+      "skill": "unsupported",
+      "globalChild": "native",
       "identifierSyntax": "Hermes delegation provider and model",
       "inheritance": "All delegated workers share one configured model",
       "invalidPinFallback": "Provider resolution is global; report actual model",
       "configTarget": "Hermes delegation configuration",
       "artifactFormat": "Global CLI/config setting",
       "verification": "Inspect Hermes delegation configuration",
-      "sourceUrl": "https://hermes-agent.nousresearch.com/docs/user-guide/features/delegation", "verifiedAt": "2026-07-20"
+      "sourceUrl": "https://hermes-agent.nousresearch.com/docs/user-guide/features/delegation",
+      "verifiedAt": "2026-07-20"
     },
     "openhuman": {
-      "agent": "compiled", "skill": "unsupported", "globalChild": "inherited",
+      "agent": "compiled",
+      "skill": "unsupported",
+      "globalChild": "inherited",
       "identifierSyntax": "Inherit, Exact(model), or semantic Hint",
       "inheritance": "Inherit delegates selection to router/provider defaults",
       "invalidPinFallback": "Exact pins validate; semantic hints route dynamically",
       "configTarget": "OpenHuman agent TOML",
       "artifactFormat": "Standalone TOML agent definition",
       "verification": "Parse against OpenHuman definition schema",
-      "sourceUrl": "https://github.com/tinyhumansai/openhuman/blob/main/src/openhuman/agent/harness/definition.rs", "verifiedAt": "2026-07-20"
+      "sourceUrl": "https://github.com/tinyhumansai/openhuman/blob/main/src/openhuman/agent/harness/definition.rs",
+      "verifiedAt": "2026-07-20"
     }
   }
 }