axstack 0.17.0 → 0.18.0

package/README.md

@@ -77,7 +77,7 @@ targets are reported without normal-path adoption. Install exits nonzero when
 an instruction conflict is preserved, while clean and idempotent installs exit
 successfully.
 
-The public bundle preserves three canonical 24-role inputs:
+The public bundle preserves three canonical 25-role inputs:
 [mixed](profiles/presets/mixed.json),
 [codex-only](profiles/presets/codex-only.json), and
 [claude-only](profiles/presets/claude-only.json). Each is exactly
@@ -90,9 +90,10 @@ Mixed configures independent Astra and Fable advisers at high. Single-provider
 presets preserve both adviser IDs and mark the unavailable one with `model:
 null` inside that preset's provider bounds; installation remains ready, while
 Align and Spec hold because both receipts are required. The mixed
-`axstack-checker` model is also intentionally `null`; that role stays held
-instead of inheriting a provider default. The single-provider presets configure
-the checker. Preset changes affect new runs only. Stored model, effort, and permission
+`axstack-checker` and `axstack-research-web-google` roles launch Antigravity by
+agent ID with explicit `model: null`; the run records the model reported by the
+TUI. The single-provider presets configure the checker and record the Google
+research branch as intentionally absent. Preset changes affect new runs only. Stored model, effort, and permission
 fields are declared intent until actual Orca launch receipts establish effective
 behavior; installation never proves provider availability or permission parity.
 Subscription availability and quota never select a fallback model.

package/docs/installation.md

@@ -51,7 +51,7 @@ profiles/presets/codex-only.json
 profiles/presets/claude-only.json
 ```
 
-Each has exactly `{ "version": 1, "roles": [...] }` with the same 24 stable
+Each has exactly `{ "version": 1, "roles": [...] }` with the same 25 stable
 role IDs. Installation writes `<skills-dir>/axstack/roles.json` as
 `{ "version": 1, "preset": "<selected preset>", "roles": [...] }` and records
 its ownership hash like every other installed skill asset. There is no second
@@ -118,10 +118,11 @@ The complete bundle is validated before writes:
 - each preset is a real JSON file with version 1, a non-empty `roles` array,
   the filename's selected identity supplied by the caller, and the same role-ID
   set as its peers;
-- every role has valid preserved fields, while the mixed checker and the mixed
-  `axstack-research-x` launch-by-agent-id route explicitly permit `model: null`;
+- every role has valid preserved fields, while the mixed checker,
+  `axstack-research-web-google`, and `axstack-research-x` launch-by-agent-id
+  routes explicitly permit `model: null`;
   in each single-provider preset, the unavailable adviser and its matching arena
-  judge seat explicitly permit `model: null`, as does `axstack-research-x`;
+  judge seat explicitly permit `model: null`, as do both cross-provider research routes;
 - obsolete runtime configuration flags fail before mutation with migration
   guidance.
 
@@ -149,16 +150,16 @@ to rewrite them.
 ## Role behavior after installation
 
 The runtime reads `roles.json` from the installed shared root `skills/axstack/`.
-A new run records the selected preset plus all 24 role rows. An active run keeps
+A new run records the selected preset plus all 25 role rows. An active run keeps
 that snapshot after a later preset install unless the user explicitly changes
 it and accepts the resulting evidence invalidation.
 
-The mixed checker has `model: null`; checker dispatch is held and never inherits
-a provider default. Mixed `axstack-research-x` has `model: null` because Orca exposes
-no `--model` override for `grok`; its explicit note authorizes launch by agent ID,
-and the run record snapshots the model reported by the TUI. The single-provider
-presets configure the checker and keep `axstack-research-x` as an intentional
-absence. Their
+The mixed checker and `axstack-research-web-google` have provider
+`antigravity`; mixed `axstack-research-x` has provider `grok`. All three use
+`model: null` because Orca exposes no model override for those agent-ID routes;
+their notes authorize launch by agent ID, and the run record snapshots the model
+reported by the TUI. The single-provider presets configure the checker and keep
+both cross-provider research routes as intentional absences. Their
 unavailable adviser and its matching arena judge seat remain explicit
 same-provider `model: null` roles, which do not make installation unready;
 Align and Spec still hold until both Astra and Fable can return independent

package/docs/workflows.md

@@ -40,7 +40,7 @@ only affected work.
 
 Installation requires one explicit canonical preset. The three bundle files
 under `profiles/presets/` each contain exactly
-`{ "version": 1, "roles": [...] }` and the same 24 stable IDs.
+`{ "version": 1, "roles": [...] }` and the same 25 stable IDs.
 
 The current chat drives on whatever model runs it; no preset carries a driver
 role.
@@ -63,9 +63,9 @@ selected preset.
 The unavailable adviser in each single-provider preset stays explicitly
 `model: null` within that provider's bounds. Installer readiness accepts that
 intentional absence, but Align and Spec hold because both independent receipts
-are required. The mixed checker also stays explicitly `model: null`; checker work holds instead of
-launching a provider default. Launch-by-agent-id routes for which Orca exposes no
-`--model` override (today: `grok`) record `model: null` with an explicit note and are
+are required. The mixed checker and Google web-research route use provider
+`antigravity`; the X route uses `grok`. Launch-by-agent-id routes for which Orca
+exposes no model override (today: `grok`, `antigravity`) record `model: null` with an explicit note and are
 launchable; the run record snapshots the model the TUI reports. Missing or unavailable roles hold only affected
 work. Model, effort, and permission values express requested intent until real
 Orca receipts establish the effective session. Stored `modeId` is not permission

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "axstack",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "Axstack installer and setup CLI: installs owned chat skills and role data, configures supported harness settings, and checks Orca capabilities.",
   "keywords": [
     "claude-code",

package/profiles/presets/claude-only.json

@@ -91,6 +91,15 @@
       "thinkingOptionId": "low",
       "notes": "Research web reader: gathers primary-source facts efficiently. Validate configured availability at launch; hold affected work without fallback."
     },
+    {
+      "id": "axstack-research-web-google",
+      "name": "Axstack research web (Google unavailable)",
+      "provider": "claude",
+      "model": null,
+      "modeId": "bypassPermissions",
+      "thinkingOptionId": "high",
+      "notes": "Intentional single-provider absence: Google-Search-grounded web research via Gemini/Antigravity is unavailable in claude-only. The explicit null holds this route without provider substitution."
+    },
     {
       "id": "axstack-research-x",
       "name": "Axstack research X (unavailable)",

package/profiles/presets/codex-only.json

@@ -91,6 +91,15 @@
       "thinkingOptionId": "low",
       "notes": "Research web reader: gathers primary-source facts efficiently. Validate configured availability at launch; hold affected work without fallback."
     },
+    {
+      "id": "axstack-research-web-google",
+      "name": "Axstack research web (Google unavailable)",
+      "provider": "codex",
+      "model": null,
+      "modeId": "full-access",
+      "thinkingOptionId": "high",
+      "notes": "Intentional single-provider absence: Google-Search-grounded web research via Gemini/Antigravity is unavailable in codex-only. The explicit null holds this route without provider substitution."
+    },
     {
       "id": "axstack-research-x",
       "name": "Axstack research X (unavailable)",

package/profiles/presets/mixed.json

@@ -58,11 +58,11 @@
     {
       "id": "axstack-checker",
       "name": "Axstack Linear checker",
-      "provider": "codex",
+      "provider": "antigravity",
       "model": null,
       "modeId": "full-access",
       "thinkingOptionId": "low",
-      "notes": "Report-only Linear discrepancy checker. Never mutates Linear; the driver independently verifies evidence before applying updates. A null model means explicit user selection is required before dispatch and must never launch a provider default."
+      "notes": "Report-only Linear discrepancy checker. Never mutates Linear; the driver independently verifies evidence before applying updates. Cheap report-only seat on Gemini Flash; launch by agent id antigravity."
     },
     {
       "id": "axstack-research-requirements",
@@ -91,6 +91,15 @@
       "thinkingOptionId": "low",
       "notes": "Research web reader: gathers primary-source facts efficiently. Validate configured availability at launch; hold affected work without fallback."
     },
+    {
+      "id": "axstack-research-web-google",
+      "name": "Axstack research web (Google)",
+      "provider": "antigravity",
+      "model": null,
+      "modeId": "full-access",
+      "thinkingOptionId": "high",
+      "notes": "Google-Search-grounded web research branch on Gemini via the Antigravity CLI; launch by agent id antigravity; model selected by the TUI default (Gemini 3.8 Flash High observed 2026-09-19; ids from agy models: gemini-3.8-flash-{low,medium,high}, gemini-3.1-pro-{low,high}); cites URL + access date per claim and re-opens sources because the CLI's search citation format is undocumented; report-only."
+    },
     {
       "id": "axstack-research-x",
       "name": "Axstack research X",

package/skills/axstack/references/orca-runtime.md

@@ -26,12 +26,12 @@ Read `roles.json` from the installed shared root `skills/axstack/`. The installe
 shape is `{ "version": 1, "preset": "<name>", "roles": [...] }`. Bundled
 profiles are setup inputs shaped as
 `{ "version": 1, "roles": [...] }`. A new run records the selected preset and
-all 24 role rows once. An active run keeps the exact snapshot until the user
+all 25 role rows once. An active run keeps the exact snapshot until the user
 explicitly changes it.
 
 Select the requested role by stable ID. A missing or null model holds only that role;
 never launch a provider default. Launch-by-agent-id routes for which Orca exposes no
-`--model` override (today: `grok`) record `model: null` with an explicit note and are
+`--model` override (today: `grok`, `antigravity`) record `model: null` with an explicit note and are
 launchable; the run record snapshots the model the TUI reports. Validate provider, model, and effort
 against the guide and actual launch capability. Stored `modeId` and other
 permission fields are conservative intent, not proof of effective permission

package/skills/axstack/references/routing.md

@@ -11,7 +11,7 @@ only with exactly one unambiguous preset; missing or contradictory sources are
 a setup gap: hold. Never infer from live profiles or `list_profiles`, harness,
 tools, credentials, quota, subscription, or default to `mixed`.
 
-At run start, capture one **routing snapshot**: the complete map of all 24 role
+At run start, capture one **routing snapshot**: the complete map of all 25 role
 IDs with provider/model/mode/effort, absent or unconfigured roles recorded
 explicitly, and no invented provider default. An absent or unconfigured role
 holds only that role's work, not the run. A role installed or changed later

package/skills/axstack-research/SKILL.md

@@ -24,19 +24,23 @@ is part of research.
    question in one run; separate only genuinely independent questions. Start
    gathering evidence only after the target and stopping boundary are explicit.
 
-2. **Choose the smallest route.** Handle a single factual lookup directly in
-   the current chat. Use a profile only when its specialization or independent
-   work is useful. Before an actual dispatch, read and follow the
-   [Orca runtime boundary](../axstack/references/orca-runtime.md). Give each
-   research branch one owner; keep implementation out of every branch.
-
-   These routes are data presets, not proof of live readiness. Confirm profile
-   availability through the shared launch sequence:
+2. **Fan out research:** A single factual lookup stays in the current chat.
+   Every other research run dispatches every configured research branch through
+   Orca: requirements (Claude), code (Codex), web (Claude), web-google
+   (Gemini/Antigravity, with Google Search built in), and X (Grok).
+   Give each branch one owner, allow no cross-reading, and require a cited note
+   with a URL and access date per claim; re-open sources and never trust a search
+   summary. The driver reconciles agreements/disagreements per claim.
+   An unconfigured or unavailable branch is recorded as absent, never substituted.
+   These routes are data presets, not proof of live readiness; before dispatch,
+   follow the [Orca runtime boundary](../axstack/references/orca-runtime.md),
+   confirm availability, and keep implementation out of every branch:
 
    - `axstack-research-requirements`: requirements and intent.
    - `axstack-research-code`: code behavior.
    - `axstack-research-web`: web and external sources.
-   - `axstack-research-x`: X (Twitter) posts and threads via Grok — only when X evidence is answer-changing; cite post URLs and dates.
+   - `axstack-research-web-google`: Google-Search-grounded web sources via Gemini/Antigravity.
+   - `axstack-research-x`: X (Twitter) posts and threads via Grok; cite post URLs and dates.
    - `axstack-explore-codebase`: broad codebase mapping.
    - `axstack-explore-execution`: execution and runtime traces.
 

package/src/roles.js

@@ -1,5 +1,5 @@
 const PROVIDER_BOUNDS = Object.freeze({
-  mixed: new Set(['codex', 'claude', 'grok']),
+  mixed: new Set(['codex', 'claude', 'grok', 'antigravity']),
   'codex-only': new Set(['codex']),
   'claude-only': new Set(['claude']),
 });
@@ -63,10 +63,11 @@ export function assessRoleReadiness(roles, preset) {
   const byId = new Map(roles.map((role) => [role.id, role]));
   const gaps = [];
   const isIntentionalAbsence = (role) => role.model === null && (
-    (preset === 'mixed' && role.id === 'axstack-checker') ||
+    (preset === 'mixed' && role.id === 'axstack-checker' && role.provider === 'antigravity') ||
+    (preset === 'mixed' && role.id === 'axstack-research-web-google' && role.provider === 'antigravity') ||
     (preset === 'mixed' && role.id === 'axstack-research-x' && role.provider === 'grok') ||
-    (preset === 'codex-only' && ['axstack-advisor-fable', 'axstack-arena-judge-fable', 'axstack-research-x'].includes(role.id)) ||
-    (preset === 'claude-only' && ['axstack-advisor-astra', 'axstack-arena-judge-astra', 'axstack-research-x'].includes(role.id))
+    (preset === 'codex-only' && ['axstack-advisor-fable', 'axstack-arena-judge-fable', 'axstack-research-web-google', 'axstack-research-x'].includes(role.id)) ||
+    (preset === 'claude-only' && ['axstack-advisor-astra', 'axstack-arena-judge-astra', 'axstack-research-web-google', 'axstack-research-x'].includes(role.id))
   );
   for (const role of roles) {
     if (!bounds.has(role.provider)) {