@aiwg/cli 2026.9.15 → 2026.9.16

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

@@ -6,59 +6,150 @@
   "providers": {
     "antigravity": {
       "roles": {
-        "reasoning": { "id": "configured/reasoning", "status": "unverified", "observed": false },
-        "coding": { "id": "configured/coding", "status": "unverified", "observed": false },
-        "efficiency": { "id": "configured/efficiency", "status": "unverified", "observed": false }
+        "reasoning": {
+          "id": "configured/reasoning",
+          "status": "unverified",
+          "observed": false
+        },
+        "coding": {
+          "id": "configured/coding",
+          "status": "unverified",
+          "observed": false
+        },
+        "efficiency": {
+          "id": "configured/efficiency",
+          "status": "unverified",
+          "observed": false
+        }
       },
-      "sourceUrl": "https://antigravity.google/docs/cli/overview/", "verifiedAt": "2026-09-04"
+      "sourceUrl": "https://antigravity.google/docs/cli/overview/",
+      "verifiedAt": "2026-09-04"
     },
     "claude": {
       "roles": {
-        "reasoning": { "id": "claude-opus-4-7", "status": "active", "observed": false },
-        "coding": { "id": "claude-sonnet-4-6", "status": "active", "observed": false },
-        "efficiency": { "id": "claude-haiku-4-5", "status": "active", "observed": false }
+        "reasoning": {
+          "id": "claude-opus-4-7",
+          "status": "active",
+          "observed": false
+        },
+        "coding": {
+          "id": "claude-sonnet-4-6",
+          "status": "active",
+          "observed": false
+        },
+        "efficiency": {
+          "id": "claude-haiku-4-5",
+          "status": "active",
+          "observed": false
+        }
       },
-      "sourceUrl": "https://docs.anthropic.com/en/docs/about-claude/models/overview", "verifiedAt": "2026-07-20"
+      "sourceUrl": "https://docs.anthropic.com/en/docs/about-claude/models/overview",
+      "verifiedAt": "2026-07-20"
     },
     "codex": {
       "roles": {
-        "reasoning": { "id": "gpt-5.4", "status": "active", "observed": true },
-        "coding": { "id": "gpt-5.5", "status": "active", "observed": true },
-        "efficiency": { "id": "gpt-5.4-mini", "status": "active", "observed": true }
+        "reasoning": {
+          "id": "gpt-5.4",
+          "status": "active",
+          "observed": true
+        },
+        "coding": {
+          "id": "gpt-5.5",
+          "status": "active",
+          "observed": true
+        },
+        "efficiency": {
+          "id": "gpt-5.4-mini",
+          "status": "active",
+          "observed": true
+        }
       },
-      "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": {
       "roles": {
-        "reasoning": { "id": "claude-opus-4.6", "status": "unverified", "observed": false },
-        "coding": { "id": "claude-sonnet-4.6", "status": "unverified", "observed": false },
-        "efficiency": { "id": "gpt-5.1-codex-mini", "status": "unverified", "observed": false }
+        "reasoning": {
+          "id": "claude-opus-4.6",
+          "status": "unverified",
+          "observed": false
+        },
+        "coding": {
+          "id": "claude-sonnet-4.6",
+          "status": "unverified",
+          "observed": false
+        },
+        "efficiency": {
+          "id": "gpt-5.1-codex-mini",
+          "status": "unverified",
+          "observed": false
+        }
       },
-      "sourceUrl": "https://docs.github.com/en/copilot/reference/ai-models/supported-models", "verifiedAt": "2026-07-20"
+      "sourceUrl": "https://docs.github.com/en/copilot/reference/ai-models/supported-models",
+      "verifiedAt": "2026-07-20"
     },
     "cursor": {
       "roles": {
-        "reasoning": { "id": "claude-4.6-opus-high-thinking", "status": "unverified", "observed": false },
-        "coding": { "id": "claude-4.6-sonnet", "status": "unverified", "observed": false },
-        "efficiency": { "id": "auto", "status": "unverified", "observed": false }
+        "reasoning": {
+          "id": "claude-4.6-opus-high-thinking",
+          "status": "unverified",
+          "observed": false
+        },
+        "coding": {
+          "id": "claude-4.6-sonnet",
+          "status": "unverified",
+          "observed": false
+        },
+        "efficiency": {
+          "id": "auto",
+          "status": "unverified",
+          "observed": false
+        }
       },
-      "sourceUrl": "https://cursor.com/docs/models", "verifiedAt": "2026-07-20"
+      "sourceUrl": "https://cursor.com/docs/models",
+      "verifiedAt": "2026-07-20"
     },
     "factory": {
       "roles": {
-        "reasoning": { "id": "heavy", "status": "active", "observed": false },
-        "coding": { "id": "medium", "status": "active", "observed": false },
-        "efficiency": { "id": "light", "status": "active", "observed": false }
+        "reasoning": {
+          "id": "heavy",
+          "status": "active",
+          "observed": false
+        },
+        "coding": {
+          "id": "medium",
+          "status": "active",
+          "observed": false
+        },
+        "efficiency": {
+          "id": "light",
+          "status": "active",
+          "observed": false
+        }
       },
-      "sourceUrl": "https://docs.factory.ai/cli/user-guides/choosing-your-model", "verifiedAt": "2026-07-20"
+      "sourceUrl": "https://docs.factory.ai/cli/user-guides/choosing-your-model",
+      "verifiedAt": "2026-07-20"
     },
     "opencode": {
       "roles": {
-        "reasoning": { "id": "anthropic/claude-opus-4-7", "status": "unverified", "observed": false },
-        "coding": { "id": "anthropic/claude-sonnet-4-6", "status": "unverified", "observed": false },
-        "efficiency": { "id": "anthropic/claude-haiku-4-5", "status": "unverified", "observed": false }
+        "reasoning": {
+          "id": "anthropic/claude-opus-4-7",
+          "status": "unverified",
+          "observed": false
+        },
+        "coding": {
+          "id": "anthropic/claude-sonnet-4-6",
+          "status": "unverified",
+          "observed": false
+        },
+        "efficiency": {
+          "id": "anthropic/claude-haiku-4-5",
+          "status": "unverified",
+          "observed": false
+        }
       },
-      "sourceUrl": "https://opencode.ai/docs/models", "verifiedAt": "2026-07-20"
+      "sourceUrl": "https://opencode.ai/docs/models",
+      "verifiedAt": "2026-07-20"
     },
     "omp": {
       "roles": {
@@ -83,59 +174,171 @@
     },
     "pi": {
       "roles": {
-        "reasoning": { "id": "configured/reasoning", "status": "unverified", "observed": false },
-        "coding": { "id": "configured/coding", "status": "unverified", "observed": false },
-        "efficiency": { "id": "configured/efficiency", "status": "unverified", "observed": false }
+        "reasoning": {
+          "id": "configured/reasoning",
+          "status": "unverified",
+          "observed": false
+        },
+        "coding": {
+          "id": "configured/coding",
+          "status": "unverified",
+          "observed": false
+        },
+        "efficiency": {
+          "id": "configured/efficiency",
+          "status": "unverified",
+          "observed": false
+        }
       },
-      "sourceUrl": "https://github.com/earendil-works/pi/tree/main/packages/coding-agent#providers--models", "verifiedAt": "2026-09-04"
+      "sourceUrl": "https://github.com/earendil-works/pi/tree/main/packages/coding-agent#providers--models",
+      "verifiedAt": "2026-09-04"
     },
     "deepseek-harness": {
       "roles": {
-        "reasoning": { "id": "configured/reasoning", "status": "unverified", "observed": false },
-        "coding": { "id": "configured/coding", "status": "unverified", "observed": false },
-        "efficiency": { "id": "configured/efficiency", "status": "unverified", "observed": false }
+        "reasoning": {
+          "id": "configured/reasoning",
+          "status": "unverified",
+          "observed": false
+        },
+        "coding": {
+          "id": "configured/coding",
+          "status": "unverified",
+          "observed": false
+        },
+        "efficiency": {
+          "id": "configured/efficiency",
+          "status": "unverified",
+          "observed": false
+        }
       },
-      "sourceUrl": "https://github.com/deepseek-ai/deepseek-harness", "verifiedAt": "2026-09-05"
+      "sourceUrl": "https://github.com/deepseek-ai/deepseek-harness",
+      "verifiedAt": "2026-09-05"
     },
     "warp": {
       "roles": {
-        "reasoning": { "id": "profile-selected", "status": "unverified", "observed": false },
-        "coding": { "id": "profile-selected", "status": "unverified", "observed": false },
-        "efficiency": { "id": "profile-selected", "status": "unverified", "observed": false }
+        "reasoning": {
+          "id": "profile-selected",
+          "status": "unverified",
+          "observed": false
+        },
+        "coding": {
+          "id": "profile-selected",
+          "status": "unverified",
+          "observed": false
+        },
+        "efficiency": {
+          "id": "profile-selected",
+          "status": "unverified",
+          "observed": false
+        }
       },
-      "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"
     },
     "windsurf": {
       "roles": {
-        "reasoning": { "id": "inherited", "status": "unverified", "observed": false },
-        "coding": { "id": "inherited", "status": "unverified", "observed": false },
-        "efficiency": { "id": "inherited", "status": "unverified", "observed": false }
+        "reasoning": {
+          "id": "inherited",
+          "status": "unverified",
+          "observed": false
+        },
+        "coding": {
+          "id": "inherited",
+          "status": "unverified",
+          "observed": false
+        },
+        "efficiency": {
+          "id": "inherited",
+          "status": "unverified",
+          "observed": false
+        }
       },
-      "sourceUrl": "https://docs.devin.ai/desktop/cascade/models", "verifiedAt": "2026-07-20"
+      "sourceUrl": "https://docs.devin.ai/desktop/cascade/models",
+      "verifiedAt": "2026-07-20"
     },
     "openclaw": {
       "roles": {
-        "reasoning": { "id": "configured/reasoning", "status": "unverified", "observed": false },
-        "coding": { "id": "configured/coding", "status": "unverified", "observed": false },
-        "efficiency": { "id": "configured/efficiency", "status": "unverified", "observed": false }
+        "reasoning": {
+          "id": "configured/reasoning",
+          "status": "unverified",
+          "observed": false
+        },
+        "coding": {
+          "id": "configured/coding",
+          "status": "unverified",
+          "observed": false
+        },
+        "efficiency": {
+          "id": "configured/efficiency",
+          "status": "unverified",
+          "observed": false
+        }
       },
-      "sourceUrl": "https://docs.openclaw.ai/tools/subagents", "verifiedAt": "2026-07-20"
+      "sourceUrl": "https://docs.openclaw.ai/tools/subagents",
+      "verifiedAt": "2026-07-20"
+    },
+    "grokbot": {
+      "roles": {
+        "reasoning": {
+          "id": "global-delegation-model",
+          "status": "unverified",
+          "observed": false
+        },
+        "coding": {
+          "id": "global-delegation-model",
+          "status": "unverified",
+          "observed": false
+        },
+        "efficiency": {
+          "id": "global-delegation-model",
+          "status": "unverified",
+          "observed": false
+        }
+      },
+      "sourceUrl": "https://github.com/jmagly/aiwg/blob/main/docs/architecture/adr-grokbot-provider-target.md",
+      "verifiedAt": "2026-09-15"
     },
     "hermes": {
       "roles": {
-        "reasoning": { "id": "global-delegation-model", "status": "unverified", "observed": false },
-        "coding": { "id": "global-delegation-model", "status": "unverified", "observed": false },
-        "efficiency": { "id": "global-delegation-model", "status": "unverified", "observed": false }
+        "reasoning": {
+          "id": "global-delegation-model",
+          "status": "unverified",
+          "observed": false
+        },
+        "coding": {
+          "id": "global-delegation-model",
+          "status": "unverified",
+          "observed": false
+        },
+        "efficiency": {
+          "id": "global-delegation-model",
+          "status": "unverified",
+          "observed": false
+        }
       },
-      "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": {
       "roles": {
-        "reasoning": { "id": "Hint(reasoning)", "status": "active", "observed": false },
-        "coding": { "id": "Hint(coding)", "status": "active", "observed": false },
-        "efficiency": { "id": "Hint(efficiency)", "status": "active", "observed": false }
+        "reasoning": {
+          "id": "Hint(reasoning)",
+          "status": "active",
+          "observed": false
+        },
+        "coding": {
+          "id": "Hint(coding)",
+          "status": "active",
+          "observed": false
+        },
+        "efficiency": {
+          "id": "Hint(efficiency)",
+          "status": "active",
+          "observed": false
+        }
       },
-      "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"
     }
   }
 }

package/dist/src/models/model-discovery.js

@@ -39,6 +39,13 @@ export const PROVIDER_DISCOVERY_DECISIONS = {
         reason: 'Droid exposes model selection through policy and interactive surfaces, but no documented non-interactive model-list command.',
         documentation: 'https://docs.factory.ai/cli/configuration/models',
     },
+    grokbot: {
+        provider: 'grokbot',
+        status: 'unsupported',
+        interface: null,
+        reason: 'Grok Bot is a desktop multi-agent runtime with no verified non-interactive model-list command; AIWG does not invent xAI/Grok API enumeration as Grok Bot entitlement.',
+        documentation: 'https://github.com/jmagly/aiwg/blob/main/docs/architecture/adr-grokbot-provider-target.md',
+    },
     hermes: {
         provider: 'hermes',
         status: 'unsupported',

package/dist/src/models/provider-policy.js

@@ -26,7 +26,7 @@ function requireModelResource(filename) {
 const capabilityData = requireModelResource('model-capabilities.v1.json');
 const catalogData = requireModelResource('model-catalog.v1.json');
 const ProviderSchema = z.enum([
-    'antigravity', 'claude', 'codex', 'copilot', 'cursor', 'deepseek-harness', 'factory', 'hermes',
+    'antigravity', 'claude', 'codex', 'copilot', 'cursor', 'deepseek-harness', 'factory', 'grokbot', 'hermes',
     'opencode', 'openclaw', 'openhuman', 'omp', 'pi', 'warp', 'windsurf',
 ]);
 const OutcomeSchema = z.enum([

package/dist/src/plugin/skill-command-translator.js

@@ -92,6 +92,7 @@ const SKILLS_ONLY_PROVIDERS = new Set([
     'antigravity',
     'claude',
     'cursor',
+    'grokbot',
     'hermes',
     'openhuman',
     'pi',

package/dist/src/providers/capability-matrix.yaml

@@ -359,6 +359,48 @@ providers:
     deploy_target: project
     aggregated_output: true
 
+  grokbot:
+    display_name: Grok Bot
+    status: stable
+    # Multi-agent desktop assistant runtime. Distinct from Cursor IDE and from
+    # xAI Grok Build / API. Native skill root is operator-configured via
+    # AIWG_GROKBOT_SKILLS_DIR (fail-closed; no invented ~/.grokbot).
+    # ADR: docs/architecture/adr-grokbot-provider-target.md · epic #196.
+    # Optional natives (routines/CreateAgent/connectors) deferred #209 — does not block stable.
+    # #210: stable via Linux PUW + security + migration + maintainer waiver (no macOS/Windows gate).
+    daemon_tier: unsupported
+    daemon_pty_adapter: false
+    artifact_paths:
+      agents: "Indexed: aiwg discover / aiwg show agent"   # native CreateAgent teammates are Grok-owned (#209)
+      commands: "Indexed: aiwg discover / aiwg show command"
+      skills: "AIWG_GROKBOT_SKILLS_DIR when configured (fail-closed)"
+      skills_cross_agent: "AIWG_GROKBOT_SKILLS_DIR/.aiwg/skills with --copy-all"
+      rules: "Indexed: aiwg show rule + AGENTS.md discover-first bridge"
+      behaviors: "Unsupported as automatic AIWG artifact; map manually to Grok routines (#209)"
+    native_features:
+      cron: true            # Grok routines — capability present; AIWG does not own the clock
+      agent_teams: true     # CreateAgent/teammates — Grok-owned orchestration
+      tasks: false          # no verified separate task contract
+      mcp: true             # connectors/dynamic tools — capability; AIWG MCP install deferred #209
+      behaviors: false
+      mission_control: false
+      daemon: false
+    emulation:
+      cron: null
+      agent_teams: null
+      tasks: aiwg-mc
+      mcp: null
+      behaviors: aiwg-mc
+      mission_control: aiwg-mc
+      daemon: null
+    hook_wiring:
+      at_link_support: false
+      hook_file: null
+      fallback: full-inject
+      context_file: AGENTS.md
+    deploy_target: mixed
+    aggregated_output: false
+
   hermes:
     display_name: Hermes
     status: stable

package/dist/src/providers/grokbot-paths.js

@@ -0,0 +1,103 @@
+/**
+ * Grok Bot skill-root resolution — fail-closed until explicitly configured.
+ *
+ * Unlike Hermes (HERMES_HOME with a documented default) or Pi
+ * (PI_CODING_AGENT_DIR with ~/.pi/agent fallback), Grok Bot's native skill
+ * filesystem root is not yet verified in AIWG. This module therefore:
+ *
+ *   1. Honors AIWG_GROKBOT_SKILLS_DIR when set to an absolute path
+ *   2. Rejects relative paths, `~`-only values that would invent a home layout,
+ *      and path segments that attempt traversal after resolution
+ *   3. Returns null when unset — callers MUST fail closed for user-scope writes
+ *
+ * Never invent ~/.grokbot or ~/.cursor as a fallback.
+ *
+ * @see docs/architecture/adr-grokbot-provider-target.md
+ * @issue #205 #207
+ */
+import { homedir } from 'node:os';
+import * as path from 'node:path';
+export const GROKBOT_SKILLS_DIR_ENV = 'AIWG_GROKBOT_SKILLS_DIR';
+/**
+ * Expand a leading `~/` against the operator home directory.
+ * Bare `~` is rejected — it would invent a home skill root.
+ */
+function expandHomePrefix(raw, userHome = homedir()) {
+    if (raw === '~')
+        return raw;
+    if (raw.startsWith('~/'))
+        return path.join(userHome, raw.slice(2));
+    return raw;
+}
+/**
+ * Validate and resolve the configured Grok Bot skills directory.
+ * Returns a structured result so CLI/doctor can print actionable remediation.
+ */
+export function resolveGrokbotSkillsDirResult(env = process.env, userHome = homedir()) {
+    const raw = (env[GROKBOT_SKILLS_DIR_ENV] || '').trim();
+    if (!raw) {
+        return {
+            ok: false,
+            reason: 'unset',
+            message: `Grok Bot user-scope skill root is not configured. Set ${GROKBOT_SKILLS_DIR_ENV} to the absolute path of the Grok Bot skills/workflows directory before using --scope user or --global. AIWG does not invent ~/.grokbot.`,
+        };
+    }
+    const expanded = expandHomePrefix(raw, userHome);
+    if (expanded === '~' || expanded.startsWith('~')) {
+        return {
+            ok: false,
+            reason: 'not-absolute',
+            message: `${GROKBOT_SKILLS_DIR_ENV} must be an absolute path (got '${raw}'). Bare '~' is rejected so AIWG never invents a Grok home layout.`,
+        };
+    }
+    if (!path.isAbsolute(expanded)) {
+        return {
+            ok: false,
+            reason: 'not-absolute',
+            message: `${GROKBOT_SKILLS_DIR_ENV} must be an absolute path (got '${raw}'). Relative values are rejected.`,
+        };
+    }
+    const resolved = path.resolve(expanded);
+    // After resolve(), reject any attempt to escape via .. that still looks suspicious
+    // relative to a normalized absolute root — path.resolve already collapses '..',
+    // so the main remaining check is that we did not start relative.
+    if (raw.includes('\0') || resolved.includes('\0')) {
+        return {
+            ok: false,
+            reason: 'traversal',
+            message: `${GROKBOT_SKILLS_DIR_ENV} contains an invalid path character.`,
+        };
+    }
+    // Defensive: if the pre-resolve value contained '..' segments that would
+    // escape a declared parent, surface traversal. Absolute resolve is fine;
+    // we still refuse paths that are only '..' noise without a real root.
+    const normalizedInput = path.normalize(expanded);
+    if (normalizedInput === path.sep || normalizedInput === '') {
+        return {
+            ok: false,
+            reason: 'empty',
+            message: `${GROKBOT_SKILLS_DIR_ENV} resolves to an empty or root-only path; refuse to deploy there.`,
+        };
+    }
+    return { ok: true, path: resolved, source: 'env' };
+}
+/** Absolute skills dir when configured; otherwise null (fail closed). */
+export function resolveGrokbotSkillsDir(env = process.env, userHome = homedir()) {
+    const result = resolveGrokbotSkillsDirResult(env, userHome);
+    return result.ok ? result.path : null;
+}
+/** True when user-scope skill writes are allowed. */
+export function isGrokbotUserScopeConfigured(env = process.env, userHome = homedir()) {
+    return resolveGrokbotSkillsDir(env, userHome) !== null;
+}
+/**
+ * User-facing remediation for missing/invalid Grok Bot skill root.
+ * Shared by `aiwg use`, doctor, and the provider writer.
+ */
+export function grokbotMissingRootRemediation(env = process.env, userHome = homedir()) {
+    const result = resolveGrokbotSkillsDirResult(env, userHome);
+    if (result.ok)
+        return '';
+    return result.message;
+}
+//# sourceMappingURL=grokbot-paths.js.map