refactor(hosts): defineHost() factory — 10 copy-paste host files become declarations

hosts/*.ts were ten copies of one file: runtimeRoot byte-identical in 9/10,
pathRewrites mechanically derivable from the host name for 7/10, the 11-entry
toolRewrites map byte-identical between openclaw and gbrain, and every asset
change a 10-file edit (cursor and slate had already fallen out of three other
hand-maintained lists). defineHost() owns the defaults; each host file now
declares only what makes it different (slate/cursor: 8 lines each). Shared
constants: CROSS_MODEL_RESOLVERS, GBRAIN_RESOLVERS, EXEC_STYLE_TOOL_REWRITES.
Genuinely-different things stayed explicit: codex/factory $GSTACK_ROOT
rewrites, hermes's tool vocabulary, claude's denylist+prefixable install,
opencode's wider runtimeRoot.

Proof: JSON.stringify(ALL_HOST_CONFIGS) dump-diff before/after EMPTY (and a
runtime walk confirmed no function-valued or undefined-keyed fields, so the
JSON diff is complete); gen:skill-docs --host all zero-diff; host-config +
gen-skill-docs + idempotency suites 485/485. Host files 595 -> 285 lines.
docs/ADDING_A_HOST.md teaches the factory pattern.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

hosts/claude.ts

@@ -1,15 +1,10 @@
-import type { HostConfig } from '../scripts/host-config';
+import { defineHost } from './define-host';
 
-const claude: HostConfig = {
+const claude = defineHost({
   name: 'claude',
   displayName: 'Claude Code',
-  cliCommand: 'claude',
-  cliAliases: [],
 
-  globalRoot: '.claude/skills/gstack',
-  localSkillRoot: '.claude/skills/gstack',
-  hostSubdir: '.claude',
-  usesEnvVars: false,
+  usesEnvVars: false,  // primary host — literal ~ paths, no $GSTACK_ROOT env vars
 
   frontmatter: {
     mode: 'denylist',
@@ -24,14 +19,6 @@ const claude: HostConfig = {
 
   pathRewrites: [],  // Claude is the primary host — no rewrites needed
   toolRewrites: {},
-  suppressedResolvers: ['GBRAIN_CONTEXT_LOAD', 'GBRAIN_SAVE_RESULTS'],
-
-  runtimeRoot: {
-    globalSymlinks: ['bin', 'browse/dist', 'browse/bin', 'gstack-upgrade', 'ETHOS.md'],
-    globalFiles: {
-      'review': ['checklist.md', 'TODOS-format.md'],
-    },
-  },
 
   install: {
     prefixable: true,
@@ -40,6 +27,6 @@ const claude: HostConfig = {
 
   coAuthorTrailer: 'Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>',
   learningsMode: 'full',
-};
+});
 
 export default claude;

hosts/codex.ts

@@ -1,15 +1,12 @@
-import type { HostConfig } from '../scripts/host-config';
+import { defineHost, CROSS_MODEL_RESOLVERS, GBRAIN_RESOLVERS } from './define-host';
 
-const codex: HostConfig = {
+const codex = defineHost({
   name: 'codex',
   displayName: 'OpenAI Codex CLI',
-  cliCommand: 'codex',
   cliAliases: ['agents'],
 
-  globalRoot: '.codex/skills/gstack',
   localSkillRoot: '.agents/skills/gstack',
   hostSubdir: '.agents',
-  usesEnvVars: true,
 
   frontmatter: {
     mode: 'allowlist',
@@ -24,6 +21,9 @@ const codex: HostConfig = {
     skipSkills: ['codex'],  // Codex skill is a Claude wrapper around codex exec
   },
 
+  // Non-mechanical rewrites: the global path becomes $GSTACK_ROOT (resolved by
+  // the preamble env vars), plus an extra review-path rewrite the derived trio
+  // doesn't cover.
   pathRewrites: [
     { from: '~/.claude/skills/gstack', to: '$GSTACK_ROOT' },
     { from: '.claude/skills/gstack', to: '.agents/skills/gstack' },
@@ -31,35 +31,16 @@ const codex: HostConfig = {
     { from: '.claude/skills', to: '.agents/skills' },
   ],
 
-  suppressedResolvers: [
-    'DESIGN_OUTSIDE_VOICES',  // design.ts:485 — Codex can't invoke itself
-    'ADVERSARIAL_STEP',       // review.ts:408 — Codex can't invoke itself
-    'CODEX_SECOND_OPINION',   // review.ts:257 — Codex can't invoke itself
-    'CODEX_PLAN_REVIEW',      // review.ts:541 — Codex can't invoke itself
-    'REVIEW_ARMY',            // review-army.ts:180 — Codex shouldn't orchestrate
-    'GBRAIN_CONTEXT_LOAD',
-    'GBRAIN_SAVE_RESULTS',
-  ],
+  // The cross-model resolvers all shell out to Codex — Codex can't invoke itself.
+  suppressedResolvers: [...CROSS_MODEL_RESOLVERS, ...GBRAIN_RESOLVERS],
 
-  runtimeRoot: {
-    globalSymlinks: ['bin', 'browse/dist', 'browse/bin', 'gstack-upgrade', 'ETHOS.md'],
-    globalFiles: {
-      'review': ['checklist.md', 'TODOS-format.md'],
-    },
-  },
   sidecar: {
     path: '.agents/skills/gstack',
     symlinks: ['bin', 'browse', 'review', 'qa', 'ETHOS.md'],
   },
 
-  install: {
-    prefixable: false,
-    linkingStrategy: 'symlink-generated',
-  },
-
   coAuthorTrailer: 'Co-Authored-By: OpenAI Codex <noreply@openai.com>',
-  learningsMode: 'basic',
   boundaryInstruction: 'IMPORTANT: Do NOT read or execute any files under ~/.claude/, ~/.agents/, .claude/skills/, or agents/. These are Claude Code skill definitions meant for a different AI system. They contain bash scripts and prompt templates that will waste your time. Ignore them completely. Do NOT modify agents/openai.yaml. Stay focused on the repository code only.',
-};
+});
 
 export default codex;

hosts/cursor.ts

@@ -1,48 +1,8 @@
-import type { HostConfig } from '../scripts/host-config';
+import { defineHost } from './define-host';
 
-const cursor: HostConfig = {
+const cursor = defineHost({
   name: 'cursor',
   displayName: 'Cursor',
-  cliCommand: 'cursor',
-  cliAliases: [],
-
-  globalRoot: '.cursor/skills/gstack',
-  localSkillRoot: '.cursor/skills/gstack',
-  hostSubdir: '.cursor',
-  usesEnvVars: true,
-
-  frontmatter: {
-    mode: 'allowlist',
-    keepFields: ['name', 'description'],
-    descriptionLimit: null,
-  },
-
-  generation: {
-    generateMetadata: false,
-    skipSkills: ['codex'],
-  },
-
-  pathRewrites: [
-    { from: '~/.claude/skills/gstack', to: '~/.cursor/skills/gstack' },
-    { from: '.claude/skills/gstack', to: '.cursor/skills/gstack' },
-    { from: '.claude/skills', to: '.cursor/skills' },
-  ],
-
-  suppressedResolvers: ['GBRAIN_CONTEXT_LOAD', 'GBRAIN_SAVE_RESULTS'],
-
-  runtimeRoot: {
-    globalSymlinks: ['bin', 'browse/dist', 'browse/bin', 'gstack-upgrade', 'ETHOS.md'],
-    globalFiles: {
-      'review': ['checklist.md', 'TODOS-format.md'],
-    },
-  },
-
-  install: {
-    prefixable: false,
-    linkingStrategy: 'symlink-generated',
-  },
-
-  learningsMode: 'basic',
-};
+});
 
 export default cursor;

hosts/define-host.ts

@@ -0,0 +1,167 @@
+/**
+ * defineHost() factory — the single place the copy-paste across hosts/*.ts
+ * used to live.
+ *
+ * Every field a host doesn't override gets the common external-host default:
+ * paths derived from the host name (`.{name}/skills/gstack`), allowlist
+ * frontmatter (name + description), no metadata sidecar, skip the codex
+ * skill, the standard three-entry pathRewrite trio derived from the resolved
+ * paths, the shared runtimeRoot asset list, and symlink-generated install.
+ *
+ * Defaults are constructed fresh per call, so no two host configs ever share
+ * a mutable array/object. Fields that are absent today (staticFiles, adapter,
+ * sidecar, toolRewrites, coAuthorTrailer, boundaryInstruction) stay absent
+ * unless a host explicitly sets them — the factory never default-populates
+ * optional fields (test/host-config.test.ts pins e.g. openclaw.adapter as
+ * undefined).
+ */
+
+import type { HostConfig } from '../scripts/host-config';
+
+type PathRewrite = { from: string; to: string };
+
+/**
+ * Preamble resolvers that orchestrate cross-model second opinions (they shell
+ * out to Codex or spin up the review army). Suppressed on hosts that can't or
+ * shouldn't invoke other models — Codex itself (can't invoke itself) and the
+ * non-Claude agent runtimes (OpenClaw, Hermes, GBrain).
+ */
+export const CROSS_MODEL_RESOLVERS: string[] = [
+  'DESIGN_OUTSIDE_VOICES',  // design.ts:485 — invokes Codex for outside voices
+  'ADVERSARIAL_STEP',       // review.ts:408 — invokes Codex adversarially
+  'CODEX_SECOND_OPINION',   // review.ts:257 — invokes Codex
+  'CODEX_PLAN_REVIEW',      // review.ts:541 — invokes Codex
+  'REVIEW_ARMY',            // review-army.ts:180 — multi-model orchestration
+];
+
+/**
+ * Brain-aware resolvers. Suppressed by default on every host — only hosts
+ * that can run with a GBrain (hermes, gbrain) leave these active.
+ */
+export const GBRAIN_RESOLVERS: string[] = [
+  'GBRAIN_CONTEXT_LOAD',
+  'GBRAIN_SAVE_RESULTS',
+];
+
+/**
+ * Tool-name rewrites for OpenClaw-style agent runtimes (lowercase exec /
+ * read / write / edit tools, sessions_spawn for subagents). OpenClaw and
+ * GBrain share these byte-for-byte; spread into `toolRewrites` at the use
+ * site so each config owns its own copy.
+ */
+export const EXEC_STYLE_TOOL_REWRITES: Record<string, string> = {
+  'use the Bash tool': 'use the exec tool',
+  'use the Write tool': 'use the write tool',
+  'use the Read tool': 'use the read tool',
+  'use the Edit tool': 'use the edit tool',
+  'use the Agent tool': 'use sessions_spawn',
+  'use the Grep tool': 'search for',
+  'use the Glob tool': 'find files matching',
+  'the Bash tool': 'the exec tool',
+  'the Read tool': 'the read tool',
+  'the Write tool': 'the write tool',
+  'the Edit tool': 'the edit tool',
+};
+
+/**
+ * Host definition input: name + displayName are required, everything else is
+ * an override on the common external-host defaults documented above.
+ *
+ * `extraPathRewrites` appends to the derived standard trio
+ * (`~/.claude/skills/gstack` → `~/{globalRoot}`, `.claude/skills/gstack` →
+ * localSkillRoot, `.claude/skills` → `{hostSubdir}/skills`). Hosts whose
+ * rewrites aren't mechanically derivable (codex, factory use $GSTACK_ROOT and
+ * an extra review rewrite; claude has none) replace the whole list via
+ * `pathRewrites` instead. The two are mutually exclusive.
+ */
+export interface HostOverrides<N extends string = string>
+  extends Partial<Omit<HostConfig, 'name' | 'displayName'>> {
+  name: N;
+  displayName: string;
+  /** Appended after the derived pathRewrite trio. Mutually exclusive with `pathRewrites`. */
+  extraPathRewrites?: PathRewrite[];
+}
+
+export function defineHost<const N extends string>(overrides: HostOverrides<N>): HostConfig & { name: N } {
+  const {
+    name,
+    displayName,
+    cliCommand = name,
+    cliAliases = [],
+    globalRoot = `.${name}/skills/gstack`,
+    localSkillRoot = `.${name}/skills/gstack`,
+    hostSubdir = `.${name}`,
+    usesEnvVars = true,  // false only for Claude (literal ~ paths, no $GSTACK_ROOT)
+    frontmatter = {
+      mode: 'allowlist',
+      keepFields: ['name', 'description'],
+      descriptionLimit: null,
+    },
+    generation = {
+      generateMetadata: false,
+      skipSkills: ['codex'],  // Codex skill is a Claude wrapper around codex exec
+    },
+    pathRewrites,
+    extraPathRewrites,
+    toolRewrites,
+    suppressedResolvers = [...GBRAIN_RESOLVERS],
+    runtimeRoot = {
+      globalSymlinks: ['bin', 'browse/dist', 'browse/bin', 'gstack-upgrade', 'ETHOS.md'],
+      globalFiles: {
+        'review': ['checklist.md', 'TODOS-format.md'],
+      },
+    },
+    sidecar,
+    install = {
+      prefixable: false,
+      linkingStrategy: 'symlink-generated',
+    },
+    coAuthorTrailer,
+    learningsMode = 'basic',
+    boundaryInstruction,
+    staticFiles,
+    adapter,
+  } = overrides;
+
+  if (pathRewrites && extraPathRewrites) {
+    throw new Error(
+      `[${name}] pathRewrites and extraPathRewrites are mutually exclusive: ` +
+      `pathRewrites replaces the derived trio, extraPathRewrites appends to it`
+    );
+  }
+
+  const resolvedPathRewrites: PathRewrite[] = pathRewrites ?? [
+    { from: '~/.claude/skills/gstack', to: `~/${globalRoot}` },
+    { from: '.claude/skills/gstack', to: localSkillRoot },
+    { from: '.claude/skills', to: `${hostSubdir}/skills` },
+    ...(extraPathRewrites ?? []),
+  ];
+
+  // Field order below mirrors the HostConfig interface (and the original
+  // hand-written configs) so serialized output is stable. Optional fields are
+  // conditionally spread so absent overrides stay truly absent (no
+  // `key: undefined` entries).
+  return {
+    name,
+    displayName,
+    cliCommand,
+    cliAliases,
+    globalRoot,
+    localSkillRoot,
+    hostSubdir,
+    usesEnvVars,
+    frontmatter,
+    generation,
+    pathRewrites: resolvedPathRewrites,
+    ...(toolRewrites !== undefined ? { toolRewrites } : {}),
+    suppressedResolvers,
+    runtimeRoot,
+    ...(sidecar !== undefined ? { sidecar } : {}),
+    install,
+    ...(coAuthorTrailer !== undefined ? { coAuthorTrailer } : {}),
+    learningsMode,
+    ...(boundaryInstruction !== undefined ? { boundaryInstruction } : {}),
+    ...(staticFiles !== undefined ? { staticFiles } : {}),
+    ...(adapter !== undefined ? { adapter } : {}),
+  };
+}

hosts/factory.ts

@@ -1,16 +1,11 @@
-import type { HostConfig } from '../scripts/host-config';
+import { defineHost } from './define-host';
 
-const factory: HostConfig = {
+const factory = defineHost({
   name: 'factory',
   displayName: 'Factory Droid',
   cliCommand: 'droid',
   cliAliases: ['droid'],
 
-  globalRoot: '.factory/skills/gstack',
-  localSkillRoot: '.factory/skills/gstack',
-  hostSubdir: '.factory',
-  usesEnvVars: true,
-
   frontmatter: {
     mode: 'allowlist',
     keepFields: ['name', 'description', 'user-invocable'],
@@ -23,11 +18,9 @@ const factory: HostConfig = {
     ],
   },
 
-  generation: {
-    generateMetadata: false,
-    skipSkills: ['codex'],  // Codex skill is a Claude wrapper around codex exec
-  },
-
+  // Non-mechanical rewrites: the global path becomes $GSTACK_ROOT (resolved by
+  // the preamble env vars), plus an extra review-path rewrite the derived trio
+  // doesn't cover.
   pathRewrites: [
     { from: '~/.claude/skills/gstack', to: '$GSTACK_ROOT' },
     { from: '.claude/skills/gstack', to: '.factory/skills/gstack' },
@@ -43,22 +36,8 @@ const factory: HostConfig = {
     'use the Glob tool': 'find files matching',
   },
 
-  suppressedResolvers: ['GBRAIN_CONTEXT_LOAD', 'GBRAIN_SAVE_RESULTS'],
-
-  runtimeRoot: {
-    globalSymlinks: ['bin', 'browse/dist', 'browse/bin', 'gstack-upgrade', 'ETHOS.md'],
-    globalFiles: {
-      'review': ['checklist.md', 'TODOS-format.md'],
-    },
-  },
-
-  install: {
-    prefixable: false,
-    linkingStrategy: 'symlink-generated',
-  },
-
   coAuthorTrailer: 'Co-Authored-By: Factory Droid <droid@users.noreply.github.com>',
   learningsMode: 'full',
-};
+});
 
 export default factory;

hosts/gbrain.ts

@@ -1,20 +1,13 @@
-import type { HostConfig } from '../scripts/host-config';
+import { defineHost, CROSS_MODEL_RESOLVERS, EXEC_STYLE_TOOL_REWRITES } from './define-host';
 
 /**
  * GBrain host config.
  * Compatible with GBrain >= v0.10.0 (doctor --fast --json, search CLI, entity enrichment).
  * When updating, check INSTALL_FOR_AGENTS.md in the GBrain repo for breaking changes.
  */
-const gbrain: HostConfig = {
+const gbrain = defineHost({
   name: 'gbrain',
   displayName: 'GBrain',
-  cliCommand: 'gbrain',
-  cliAliases: [],
-
-  globalRoot: '.gbrain/skills/gstack',
-  localSkillRoot: '.gbrain/skills/gstack',
-  hostSubdir: '.gbrain',
-  usesEnvVars: true,
 
   frontmatter: {
     mode: 'allowlist',
@@ -28,51 +21,19 @@ const gbrain: HostConfig = {
     includeSkills: [],
   },
 
-  pathRewrites: [
-    { from: '~/.claude/skills/gstack', to: '~/.gbrain/skills/gstack' },
-    { from: '.claude/skills/gstack', to: '.gbrain/skills/gstack' },
-    { from: '.claude/skills', to: '.gbrain/skills' },
+  extraPathRewrites: [
     { from: 'CLAUDE.md', to: 'AGENTS.md' },
   ],
-  toolRewrites: {
-    'use the Bash tool': 'use the exec tool',
-    'use the Write tool': 'use the write tool',
-    'use the Read tool': 'use the read tool',
-    'use the Edit tool': 'use the edit tool',
-    'use the Agent tool': 'use sessions_spawn',
-    'use the Grep tool': 'search for',
-    'use the Glob tool': 'find files matching',
-    'the Bash tool': 'the exec tool',
-    'the Read tool': 'the read tool',
-    'the Write tool': 'the write tool',
-    'the Edit tool': 'the edit tool',
-  },
+  toolRewrites: { ...EXEC_STYLE_TOOL_REWRITES },
 
   // GBrain gets brain-aware resolvers. All other hosts suppress these.
   suppressedResolvers: [
-    'DESIGN_OUTSIDE_VOICES',
-    'ADVERSARIAL_STEP',
-    'CODEX_SECOND_OPINION',
-    'CODEX_PLAN_REVIEW',
-    'REVIEW_ARMY',
+    ...CROSS_MODEL_RESOLVERS,
     // NOTE: GBRAIN_CONTEXT_LOAD and GBRAIN_SAVE_RESULTS are NOT suppressed here.
     // GBrain is the only host that gets brain-first lookup and save-to-brain behavior.
   ],
 
-  runtimeRoot: {
-    globalSymlinks: ['bin', 'browse/dist', 'browse/bin', 'gstack-upgrade', 'ETHOS.md'],
-    globalFiles: {
-      'review': ['checklist.md', 'TODOS-format.md'],
-    },
-  },
-
-  install: {
-    prefixable: false,
-    linkingStrategy: 'symlink-generated',
-  },
-
   coAuthorTrailer: 'Co-Authored-By: GBrain Agent <agent@gbrain.dev>',
-  learningsMode: 'basic',
-};
+});
 
 export default gbrain;

hosts/hermes.ts

@@ -1,21 +1,8 @@
-import type { HostConfig } from '../scripts/host-config';
+import { defineHost, CROSS_MODEL_RESOLVERS } from './define-host';
 
-const hermes: HostConfig = {
+const hermes = defineHost({
   name: 'hermes',
   displayName: 'Hermes',
-  cliCommand: 'hermes',
-  cliAliases: [],
-
-  globalRoot: '.hermes/skills/gstack',
-  localSkillRoot: '.hermes/skills/gstack',
-  hostSubdir: '.hermes',
-  usesEnvVars: true,
-
-  frontmatter: {
-    mode: 'allowlist',
-    keepFields: ['name', 'description'],
-    descriptionLimit: null,
-  },
 
   generation: {
     generateMetadata: false,
@@ -23,10 +10,7 @@ const hermes: HostConfig = {
     includeSkills: [],
   },
 
-  pathRewrites: [
-    { from: '~/.claude/skills/gstack', to: '~/.hermes/skills/gstack' },
-    { from: '.claude/skills/gstack', to: '.hermes/skills/gstack' },
-    { from: '.claude/skills', to: '.hermes/skills' },
+  extraPathRewrites: [
     { from: 'CLAUDE.md', to: 'AGENTS.md' },
   ],
   toolRewrites: {
@@ -44,30 +28,13 @@ const hermes: HostConfig = {
   },
 
   suppressedResolvers: [
-    'DESIGN_OUTSIDE_VOICES',
-    'ADVERSARIAL_STEP',
-    'CODEX_SECOND_OPINION',
-    'CODEX_PLAN_REVIEW',
-    'REVIEW_ARMY',
+    ...CROSS_MODEL_RESOLVERS,
     // GBRAIN_CONTEXT_LOAD and GBRAIN_SAVE_RESULTS are NOT suppressed.
     // The resolvers handle GBrain-not-installed gracefully ("proceed without brain context").
     // If Hermes has GBrain as a mod, brain features activate automatically.
   ],
 
-  runtimeRoot: {
-    globalSymlinks: ['bin', 'browse/dist', 'browse/bin', 'gstack-upgrade', 'ETHOS.md'],
-    globalFiles: {
-      'review': ['checklist.md', 'TODOS-format.md'],
-    },
-  },
-
-  install: {
-    prefixable: false,
-    linkingStrategy: 'symlink-generated',
-  },
-
   coAuthorTrailer: 'Co-Authored-By: Hermes Agent <agent@nousresearch.com>',
-  learningsMode: 'basic',
-};
+});
 
 export default hermes;

hosts/kiro.ts

@@ -1,50 +1,17 @@
-import type { HostConfig } from '../scripts/host-config';
+import { defineHost } from './define-host';
 
-const kiro: HostConfig = {
+const kiro = defineHost({
   name: 'kiro',
   displayName: 'Kiro',
   cliCommand: 'kiro-cli',
-  cliAliases: [],
 
-  globalRoot: '.kiro/skills/gstack',
-  localSkillRoot: '.kiro/skills/gstack',
-  hostSubdir: '.kiro',
-  usesEnvVars: true,
-
-  frontmatter: {
-    mode: 'allowlist',
-    keepFields: ['name', 'description'],
-    descriptionLimit: null,
-  },
-
-  generation: {
-    generateMetadata: false,
-    skipSkills: ['codex'],  // Codex skill is a Claude wrapper around codex exec
-  },
-
-  pathRewrites: [
-    { from: '~/.claude/skills/gstack', to: '~/.kiro/skills/gstack' },
-    { from: '.claude/skills/gstack', to: '.kiro/skills/gstack' },
-    { from: '.claude/skills', to: '.kiro/skills' },
+  // Beyond the standard .claude/* trio, Kiro also cleans up codex-style paths:
+  // template prose that references ~/.codex/skills/gstack or .codex/skills
+  // (e.g. cross-host examples) must land on Kiro's own paths.
+  extraPathRewrites: [
     { from: '~/.codex/skills/gstack', to: '~/.kiro/skills/gstack' },
     { from: '.codex/skills', to: '.kiro/skills' },
   ],
-
-  suppressedResolvers: ['GBRAIN_CONTEXT_LOAD', 'GBRAIN_SAVE_RESULTS'],
-
-  runtimeRoot: {
-    globalSymlinks: ['bin', 'browse/dist', 'browse/bin', 'gstack-upgrade', 'ETHOS.md'],
-    globalFiles: {
-      'review': ['checklist.md', 'TODOS-format.md'],
-    },
-  },
-
-  install: {
-    prefixable: false,
-    linkingStrategy: 'symlink-generated',
-  },
-
-  learningsMode: 'basic',
-};
+});
 
 export default kiro;

hosts/openclaw.ts

@@ -1,15 +1,8 @@
-import type { HostConfig } from '../scripts/host-config';
+import { defineHost, CROSS_MODEL_RESOLVERS, GBRAIN_RESOLVERS, EXEC_STYLE_TOOL_REWRITES } from './define-host';
 
-const openclaw: HostConfig = {
+const openclaw = defineHost({
   name: 'openclaw',
   displayName: 'OpenClaw',
-  cliCommand: 'openclaw',
-  cliAliases: [],
-
-  globalRoot: '.openclaw/skills/gstack',
-  localSkillRoot: '.openclaw/skills/gstack',
-  hostSubdir: '.openclaw',
-  usesEnvVars: true,
 
   frontmatter: {
     mode: 'allowlist',
@@ -23,54 +16,18 @@ const openclaw: HostConfig = {
   generation: {
     generateMetadata: false,
     skipSkills: ['codex'],
-    includeSkills: [],
+    includeSkills: [],  // native ClawHub skills replaced the generated ones
   },
 
-  pathRewrites: [
-    { from: '~/.claude/skills/gstack', to: '~/.openclaw/skills/gstack' },
-    { from: '.claude/skills/gstack', to: '.openclaw/skills/gstack' },
-    { from: '.claude/skills', to: '.openclaw/skills' },
+  extraPathRewrites: [
     { from: 'CLAUDE.md', to: 'AGENTS.md' },
   ],
-  toolRewrites: {
-    'use the Bash tool': 'use the exec tool',
-    'use the Write tool': 'use the write tool',
-    'use the Read tool': 'use the read tool',
-    'use the Edit tool': 'use the edit tool',
-    'use the Agent tool': 'use sessions_spawn',
-    'use the Grep tool': 'search for',
-    'use the Glob tool': 'find files matching',
-    'the Bash tool': 'the exec tool',
-    'the Read tool': 'the read tool',
-    'the Write tool': 'the write tool',
-    'the Edit tool': 'the edit tool',
-  },
+  toolRewrites: { ...EXEC_STYLE_TOOL_REWRITES },
 
   // Suppress Claude-specific preamble sections that don't apply to OpenClaw
-  suppressedResolvers: [
-    'DESIGN_OUTSIDE_VOICES',
-    'ADVERSARIAL_STEP',
-    'CODEX_SECOND_OPINION',
-    'CODEX_PLAN_REVIEW',
-    'REVIEW_ARMY',
-    'GBRAIN_CONTEXT_LOAD',
-    'GBRAIN_SAVE_RESULTS',
-  ],
-
-  runtimeRoot: {
-    globalSymlinks: ['bin', 'browse/dist', 'browse/bin', 'gstack-upgrade', 'ETHOS.md'],
-    globalFiles: {
-      'review': ['checklist.md', 'TODOS-format.md'],
-    },
-  },
-
-  install: {
-    prefixable: false,
-    linkingStrategy: 'symlink-generated',
-  },
+  suppressedResolvers: [...CROSS_MODEL_RESOLVERS, ...GBRAIN_RESOLVERS],
 
   coAuthorTrailer: 'Co-Authored-By: OpenClaw Agent <agent@openclaw.ai>',
-  learningsMode: 'basic',
-};
+});
 
 export default openclaw;

hosts/opencode.ts

@@ -1,48 +1,19 @@
-import type { HostConfig } from '../scripts/host-config';
+import { defineHost } from './define-host';
 
-const opencode: HostConfig = {
+const opencode = defineHost({
   name: 'opencode',
   displayName: 'OpenCode',
-  cliCommand: 'opencode',
-  cliAliases: [],
 
-  globalRoot: '.config/opencode/skills/gstack',
-  localSkillRoot: '.opencode/skills/gstack',
-  hostSubdir: '.opencode',
-  usesEnvVars: true,
-
-  frontmatter: {
-    mode: 'allowlist',
-    keepFields: ['name', 'description'],
-    descriptionLimit: null,
-  },
-
-  generation: {
-    generateMetadata: false,
-    skipSkills: ['codex'],
-  },
-
-  pathRewrites: [
-    { from: '~/.claude/skills/gstack', to: '~/.config/opencode/skills/gstack' },
-    { from: '.claude/skills/gstack', to: '.opencode/skills/gstack' },
-    { from: '.claude/skills', to: '.opencode/skills' },
-  ],
-
-  suppressedResolvers: ['GBRAIN_CONTEXT_LOAD', 'GBRAIN_SAVE_RESULTS'],
+  globalRoot: '.config/opencode/skills/gstack',  // XDG config dir, not ~/.opencode
 
+  // OpenCode links a wider runtime asset set than the shared default
+  // (design binary, review specialists, qa templates/references, DX hall of fame).
   runtimeRoot: {
     globalSymlinks: ['bin', 'browse/dist', 'browse/bin', 'design/dist', 'gstack-upgrade', 'ETHOS.md', 'review/specialists', 'qa/templates', 'qa/references', 'plan-devex-review/dx-hall-of-fame.md'],
     globalFiles: {
       'review': ['checklist.md', 'design-checklist.md', 'greptile-triage.md', 'TODOS-format.md'],
     },
   },
-
-  install: {
-    prefixable: false,
-    linkingStrategy: 'symlink-generated',
-  },
-
-  learningsMode: 'basic',
-};
+});
 
 export default opencode;

hosts/slate.ts

@@ -1,48 +1,8 @@
-import type { HostConfig } from '../scripts/host-config';
+import { defineHost } from './define-host';
 
-const slate: HostConfig = {
+const slate = defineHost({
   name: 'slate',
   displayName: 'Slate',
-  cliCommand: 'slate',
-  cliAliases: [],
-
-  globalRoot: '.slate/skills/gstack',
-  localSkillRoot: '.slate/skills/gstack',
-  hostSubdir: '.slate',
-  usesEnvVars: true,
-
-  frontmatter: {
-    mode: 'allowlist',
-    keepFields: ['name', 'description'],
-    descriptionLimit: null,
-  },
-
-  generation: {
-    generateMetadata: false,
-    skipSkills: ['codex'],
-  },
-
-  pathRewrites: [
-    { from: '~/.claude/skills/gstack', to: '~/.slate/skills/gstack' },
-    { from: '.claude/skills/gstack', to: '.slate/skills/gstack' },
-    { from: '.claude/skills', to: '.slate/skills' },
-  ],
-
-  suppressedResolvers: ['GBRAIN_CONTEXT_LOAD', 'GBRAIN_SAVE_RESULTS'],
-
-  runtimeRoot: {
-    globalSymlinks: ['bin', 'browse/dist', 'browse/bin', 'gstack-upgrade', 'ETHOS.md'],
-    globalFiles: {
-      'review': ['checklist.md', 'TODOS-format.md'],
-    },
-  },
-
-  install: {
-    prefixable: false,
-    linkingStrategy: 'symlink-generated',
-  },
-
-  learningsMode: 'basic',
-};
+});
 
 export default slate;