ccg-workflow 3.0.10 → 3.1.1

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import cac from 'cac';
 import ansis from 'ansis';
-import { A as diagnoseMcpConfig, B as isWindows, C as readClaudeCodeConfig, D as fixWindowsMcpConfig, E as writeClaudeCodeConfig, r as readCcgConfig, b as initI18n, a as i18n, s as showMainMenu, i as init, F as configMcp, G as version } from './shared/ccg-workflow.Btj19K42.mjs';
+import { B as diagnoseMcpConfig, C as isWindows, D as readClaudeCodeConfig, E as fixWindowsMcpConfig, F as writeClaudeCodeConfig, r as readCcgConfig, b as initI18n, a as i18n, s as showMainMenu, i as init, G as configMcp, H as version } from './shared/ccg-workflow.k-Wk5rrs.mjs';
 import 'inquirer';
 import 'ora';
 import 'node:child_process';

package/dist/index.d.mts

@@ -13,7 +13,7 @@ interface CliOptions {
 }
 
 type SupportedLang = 'zh-CN' | 'en';
-type ModelType = 'codex' | 'gemini' | 'claude';
+type ModelType = 'codex' | 'gemini' | 'claude' | 'antigravity';
 type CollaborationMode = 'parallel' | 'smart' | 'sequential';
 type RoutingStrategy = 'parallel' | 'fallback' | 'round-robin';
 interface ModelRouting {
@@ -162,6 +162,14 @@ declare function installCodexMode(): Promise<{
     success: boolean;
     message: string;
 }>;
+/**
+ * Uninstall CCG Codex mode — only removes files installed by CCG, preserves user files.
+ */
+declare function uninstallCodexMode(): Promise<{
+    success: boolean;
+    removed: string[];
+    skipped: string[];
+}>;
 declare function installWorkflows(workflowIds: string[], installDir: string, force?: boolean, config?: {
     routing?: {
         mode?: string;
@@ -244,5 +252,5 @@ declare function checkForUpdates(): Promise<{
     latestVersion: string | null;
 }>;
 
-export { changeLanguage, checkForUpdates, compareVersions, createDefaultConfig, createDefaultRouting, getCcgDir, getConfigPath, getCurrentVersion, getLatestVersion, getWorkflowById, getWorkflowConfigs, i18n, init, initI18n, installAceTool, installAceToolRs, installCodexMode, installWorkflows, migrateToV1_4_0, needsMigration, readCcgConfig, showMainMenu, uninstallAceTool, uninstallWorkflows, update, writeCcgConfig };
+export { changeLanguage, checkForUpdates, compareVersions, createDefaultConfig, createDefaultRouting, getCcgDir, getConfigPath, getCurrentVersion, getLatestVersion, getWorkflowById, getWorkflowConfigs, i18n, init, initI18n, installAceTool, installAceToolRs, installCodexMode, installWorkflows, migrateToV1_4_0, needsMigration, readCcgConfig, showMainMenu, uninstallAceTool, uninstallCodexMode, uninstallWorkflows, update, writeCcgConfig };
 export type { AceToolConfig, CcgConfig, CliOptions, CollaborationMode, FastContextConfig, InitOptions, InstallResult, ModelRouting, ModelType, RoutingStrategy, SupportedLang, WorkflowConfig };

package/dist/index.d.ts

@@ -13,7 +13,7 @@ interface CliOptions {
 }
 
 type SupportedLang = 'zh-CN' | 'en';
-type ModelType = 'codex' | 'gemini' | 'claude';
+type ModelType = 'codex' | 'gemini' | 'claude' | 'antigravity';
 type CollaborationMode = 'parallel' | 'smart' | 'sequential';
 type RoutingStrategy = 'parallel' | 'fallback' | 'round-robin';
 interface ModelRouting {
@@ -162,6 +162,14 @@ declare function installCodexMode(): Promise<{
     success: boolean;
     message: string;
 }>;
+/**
+ * Uninstall CCG Codex mode — only removes files installed by CCG, preserves user files.
+ */
+declare function uninstallCodexMode(): Promise<{
+    success: boolean;
+    removed: string[];
+    skipped: string[];
+}>;
 declare function installWorkflows(workflowIds: string[], installDir: string, force?: boolean, config?: {
     routing?: {
         mode?: string;
@@ -244,5 +252,5 @@ declare function checkForUpdates(): Promise<{
     latestVersion: string | null;
 }>;
 
-export { changeLanguage, checkForUpdates, compareVersions, createDefaultConfig, createDefaultRouting, getCcgDir, getConfigPath, getCurrentVersion, getLatestVersion, getWorkflowById, getWorkflowConfigs, i18n, init, initI18n, installAceTool, installAceToolRs, installCodexMode, installWorkflows, migrateToV1_4_0, needsMigration, readCcgConfig, showMainMenu, uninstallAceTool, uninstallWorkflows, update, writeCcgConfig };
+export { changeLanguage, checkForUpdates, compareVersions, createDefaultConfig, createDefaultRouting, getCcgDir, getConfigPath, getCurrentVersion, getLatestVersion, getWorkflowById, getWorkflowConfigs, i18n, init, initI18n, installAceTool, installAceToolRs, installCodexMode, installWorkflows, migrateToV1_4_0, needsMigration, readCcgConfig, showMainMenu, uninstallAceTool, uninstallCodexMode, uninstallWorkflows, update, writeCcgConfig };
 export type { AceToolConfig, CcgConfig, CliOptions, CollaborationMode, FastContextConfig, InitOptions, InstallResult, ModelRouting, ModelType, RoutingStrategy, SupportedLang, WorkflowConfig };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { c as changeLanguage, y as checkForUpdates, z as compareVersions, d as createDefaultConfig, e as createDefaultRouting, g as getCcgDir, f as getConfigPath, v as getCurrentVersion, x as getLatestVersion, j as getWorkflowById, h as getWorkflowConfigs, a as i18n, i as init, b as initI18n, l as installAceTool, m as installAceToolRs, n as installCodexMode, k as installWorkflows, q as migrateToV1_4_0, t as needsMigration, r as readCcgConfig, s as showMainMenu, p as uninstallAceTool, o as uninstallWorkflows, u as update, w as writeCcgConfig } from './shared/ccg-workflow.Btj19K42.mjs';
+export { c as changeLanguage, z as checkForUpdates, A as compareVersions, d as createDefaultConfig, e as createDefaultRouting, g as getCcgDir, f as getConfigPath, x as getCurrentVersion, y as getLatestVersion, j as getWorkflowById, h as getWorkflowConfigs, a as i18n, i as init, b as initI18n, l as installAceTool, m as installAceToolRs, n as installCodexMode, k as installWorkflows, t as migrateToV1_4_0, v as needsMigration, r as readCcgConfig, s as showMainMenu, q as uninstallAceTool, o as uninstallCodexMode, p as uninstallWorkflows, u as update, w as writeCcgConfig } from './shared/ccg-workflow.k-Wk5rrs.mjs';
 import 'ansis';
 import 'inquirer';
 import 'ora';

package/dist/shared/{ccg-workflow.Btj19K42.mjs → ccg-workflow.k-Wk5rrs.mjs}

@@ -10,7 +10,7 @@ import fs from 'fs-extra';
 import { parse, stringify } from 'smol-toml';
 import i18next from 'i18next';
 
-const version = "3.0.10";
+const version = "3.1.1";
 
 function cmd(id, order, category, name, nameEn, description, descriptionEn, cmdOverride) {
   return {
@@ -131,15 +131,15 @@ const MCP_PROVIDERS = {
 function injectConfigVariables(content, config) {
   let processed = content;
   const routing = config.routing || {};
-  const frontendModels = routing.frontend?.models || ["gemini"];
-  const frontendPrimary = routing.frontend?.primary || "gemini";
+  const frontendModels = routing.frontend?.models || ["antigravity"];
+  const frontendPrimary = routing.frontend?.primary || "antigravity";
   processed = processed.replace(/\{\{FRONTEND_MODELS\}\}/g, JSON.stringify(frontendModels));
   processed = processed.replace(/\{\{FRONTEND_PRIMARY\}\}/g, frontendPrimary);
   const backendModels = routing.backend?.models || ["codex"];
   const backendPrimary = routing.backend?.primary || "codex";
   processed = processed.replace(/\{\{BACKEND_MODELS\}\}/g, JSON.stringify(backendModels));
   processed = processed.replace(/\{\{BACKEND_PRIMARY\}\}/g, backendPrimary);
-  const reviewModels = routing.review?.models || ["codex", "gemini"];
+  const reviewModels = routing.review?.models || ["codex", "antigravity"];
   processed = processed.replace(/\{\{REVIEW_MODELS\}\}/g, JSON.stringify(reviewModels));
   const routingMode = routing.mode || "smart";
   processed = processed.replace(/\{\{ROUTING_MODE\}\}/g, routingMode);
@@ -197,6 +197,79 @@ function replaceHomePathsInTemplate(content, installDir) {
   return processed;
 }
 
+const CCG_DIR = join(homedir(), ".claude", ".ccg");
+const CONFIG_FILE = join(CCG_DIR, "config.toml");
+function getCcgDir() {
+  return CCG_DIR;
+}
+function getConfigPath() {
+  return CONFIG_FILE;
+}
+async function ensureCcgDir() {
+  await fs.ensureDir(CCG_DIR);
+}
+async function readCcgConfig() {
+  try {
+    if (await fs.pathExists(CONFIG_FILE)) {
+      const content = await fs.readFile(CONFIG_FILE, "utf-8");
+      return parse(content);
+    }
+  } catch {
+  }
+  return null;
+}
+async function writeCcgConfig(config) {
+  await ensureCcgDir();
+  const content = stringify(config);
+  await fs.writeFile(CONFIG_FILE, content, "utf-8");
+}
+function createDefaultConfig(options) {
+  return {
+    general: {
+      version: version,
+      language: options.language,
+      createdAt: (/* @__PURE__ */ new Date()).toISOString()
+    },
+    routing: options.routing,
+    workflows: {
+      installed: options.installedWorkflows
+    },
+    paths: {
+      commands: join(homedir(), ".claude", "commands", "ccg"),
+      prompts: join(CCG_DIR, "prompts"),
+      // v1.4.0: 移到配置目录
+      backup: join(CCG_DIR, "backup")
+    },
+    mcp: {
+      provider: options.mcpProvider || "fast-context",
+      setup_url: "https://augmentcode.com/"
+    },
+    performance: {
+      liteMode: options.liteMode || false,
+      skipImpeccable: options.skipImpeccable || false
+    }
+  };
+}
+function createDefaultRouting() {
+  return {
+    frontend: {
+      models: ["antigravity"],
+      primary: "antigravity",
+      strategy: "parallel"
+    },
+    backend: {
+      models: ["codex"],
+      primary: "codex",
+      strategy: "parallel"
+    },
+    review: {
+      models: ["codex", "antigravity"],
+      strategy: "parallel"
+    },
+    mode: "smart"
+  };
+}
+
 const DEFAULT_ALLOWED_TOOLS = ["Read"];
 const NAME_SLUG_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 const TOOL_NAME_RE = /^[A-Z][A-Za-z0-9]*$/;
@@ -814,7 +887,7 @@ async function removeFastContextPrompt() {
   await removeFromFile(join(homedir(), ".gemini", "GEMINI.md"));
 }
 
-const EXPECTED_BINARY_VERSION = "5.10.0";
+const EXPECTED_BINARY_VERSION = "5.11.0";
 const GITHUB_REPO = "fengshao1227/ccg-workflow";
 const RELEASE_TAG = "preset";
 const BINARY_SOURCES = [
@@ -957,7 +1030,7 @@ async function installPromptFiles(ctx) {
     ctx.result.errors.push(`Prompts template directory not found: ${promptsTemplateDir}`);
     return;
   }
-  for (const model of ["codex", "gemini", "claude"]) {
+  for (const model of ["codex", "gemini", "claude", "antigravity"]) {
     try {
       const installed = await copyMdTemplates(
         ctx,
@@ -1111,7 +1184,18 @@ async function installCodexMode() {
     }
     const agentsMdSrc = join(codexTemplateDir, "AGENTS.md");
     if (await fs.pathExists(agentsMdSrc)) {
-      await fs.copy(agentsMdSrc, join(codexHome, "AGENTS.md"), { overwrite: true });
+      const config = await readCcgConfig();
+      if (config) {
+        let content = await fs.readFile(agentsMdSrc, "utf-8");
+        content = injectConfigVariables(content, {
+          routing: config.routing,
+          liteMode: config.performance?.liteMode || false,
+          mcpProvider: config.mcp?.provider || "skip"
+        });
+        await fs.writeFile(join(codexHome, "AGENTS.md"), content, "utf-8");
+      } else {
+        await fs.copy(agentsMdSrc, join(codexHome, "AGENTS.md"), { overwrite: true });
+      }
     }
     const hooksSrc = join(codexTemplateDir, "hooks");
     if (await fs.pathExists(hooksSrc)) {
@@ -1137,6 +1221,50 @@ async function installCodexMode() {
     return { success: false, message: `Failed to install Codex mode: ${error}` };
   }
 }
+async function uninstallCodexMode() {
+  const codexHome = join(homedir(), ".codex");
+  const removed = [];
+  const skipped = [];
+  const ccgFiles = [
+    join(codexHome, "agents", "ccg-implement.toml"),
+    join(codexHome, "agents", "ccg-review.toml"),
+    join(codexHome, "agents", "ccg-research.toml"),
+    join(codexHome, "hooks", "ccg-workflow.py"),
+    join(codexHome, "hooks.json")
+  ];
+  const agentsMd = join(codexHome, "AGENTS.md");
+  try {
+    for (const file of ccgFiles) {
+      if (await fs.pathExists(file)) {
+        await fs.remove(file);
+        removed.push(file.replace(homedir(), "~"));
+      }
+    }
+    if (await fs.pathExists(agentsMd)) {
+      const content = await fs.readFile(agentsMd, "utf-8");
+      if (content.includes("<!-- CCG:START")) {
+        await fs.remove(agentsMd);
+        removed.push("~/.codex/AGENTS.md");
+      } else {
+        skipped.push("~/.codex/AGENTS.md (not managed by CCG)");
+      }
+    }
+    skipped.push("~/.codex/config.toml (preserved \u2014 may contain user settings)");
+    for (const dir of ["agents", "hooks"]) {
+      const dirPath = join(codexHome, dir);
+      if (await fs.pathExists(dirPath)) {
+        const files = await fs.readdir(dirPath);
+        if (files.length === 0) {
+          await fs.remove(dirPath);
+          removed.push(`~/.codex/${dir}/ (empty, removed)`);
+        }
+      }
+    }
+    return { success: true, removed, skipped };
+  } catch (error) {
+    return { success: false, removed, skipped: [...skipped, `Error: ${error}`] };
+  }
+}
 async function installRuleFiles(ctx) {
   try {
     const installed = await copyMdTemplates(
@@ -1348,9 +1476,9 @@ async function installWorkflows(workflowIds, installDir, force = false, config)
     config: {
       routing: config?.routing || {
         mode: "smart",
-        frontend: { models: ["gemini"], primary: "gemini" },
+        frontend: { models: ["antigravity"], primary: "antigravity" },
         backend: { models: ["codex"], primary: "codex" },
-        review: { models: ["codex", "gemini"] }
+        review: { models: ["codex", "antigravity"] }
       },
       liteMode: config?.liteMode || false,
       mcpProvider: config?.mcpProvider || "fast-context",
@@ -1492,6 +1620,7 @@ const installer = {
   syncMcpToCodex: syncMcpToCodex,
   syncMcpToGemini: syncMcpToGemini,
   uninstallAceTool: uninstallAceTool,
+  uninstallCodexMode: uninstallCodexMode,
   uninstallContextWeaver: uninstallContextWeaver,
   uninstallFastContext: uninstallFastContext,
   uninstallMcpServer: uninstallMcpServer,
@@ -2843,79 +2972,6 @@ async function changeLanguage(lang) {
   await i18n.changeLanguage(lang);
 }
 
-const CCG_DIR = join(homedir(), ".claude", ".ccg");
-const CONFIG_FILE = join(CCG_DIR, "config.toml");
-function getCcgDir() {
-  return CCG_DIR;
-}
-function getConfigPath() {
-  return CONFIG_FILE;
-}
-async function ensureCcgDir() {
-  await fs.ensureDir(CCG_DIR);
-}
-async function readCcgConfig() {
-  try {
-    if (await fs.pathExists(CONFIG_FILE)) {
-      const content = await fs.readFile(CONFIG_FILE, "utf-8");
-      return parse(content);
-    }
-  } catch {
-  }
-  return null;
-}
-async function writeCcgConfig(config) {
-  await ensureCcgDir();
-  const content = stringify(config);
-  await fs.writeFile(CONFIG_FILE, content, "utf-8");
-}
-function createDefaultConfig(options) {
-  return {
-    general: {
-      version: version,
-      language: options.language,
-      createdAt: (/* @__PURE__ */ new Date()).toISOString()
-    },
-    routing: options.routing,
-    workflows: {
-      installed: options.installedWorkflows
-    },
-    paths: {
-      commands: join(homedir(), ".claude", "commands", "ccg"),
-      prompts: join(CCG_DIR, "prompts"),
-      // v1.4.0: 移到配置目录
-      backup: join(CCG_DIR, "backup")
-    },
-    mcp: {
-      provider: options.mcpProvider || "fast-context",
-      setup_url: "https://augmentcode.com/"
-    },
-    performance: {
-      liteMode: options.liteMode || false,
-      skipImpeccable: options.skipImpeccable || false
-    }
-  };
-}
-function createDefaultRouting() {
-  return {
-    frontend: {
-      models: ["gemini"],
-      primary: "gemini",
-      strategy: "parallel"
-    },
-    backend: {
-      models: ["codex"],
-      primary: "codex",
-      strategy: "parallel"
-    },
-    review: {
-      models: ["codex", "gemini"],
-      strategy: "parallel"
-    },
-    mode: "smart"
-  };
-}
-
 async function migrateToV1_4_0() {
   const result = {
     success: true,
@@ -3158,7 +3214,7 @@ async function init(options = {}) {
     language = options.lang;
     await initI18n(language);
   }
-  let frontendModels = ["gemini"];
+  let frontendModels = ["antigravity"];
   let backendModels = ["codex"];
   let geminiModel = "gemini-3.1-pro-preview";
   const mode = "smart";
@@ -3166,7 +3222,7 @@ async function init(options = {}) {
   if (options.skipPrompt) {
     const existingConfig = await readCcgConfig();
     if (existingConfig?.routing) {
-      frontendModels = existingConfig.routing.frontend?.models || ["gemini"];
+      frontendModels = existingConfig.routing.frontend?.models || ["antigravity"];
       backendModels = existingConfig.routing.backend?.models || ["codex"];
       geminiModel = existingConfig.routing.geminiModel || "gemini-3.1-pro-preview";
     }
@@ -3290,11 +3346,12 @@ async function init(options = {}) {
         name: "selectedFrontend",
         message: i18n.t("init:model.selectFrontend"),
         choices: [
-          { name: `Gemini ${ansis.green(`(${i18n.t("init:model.recommended")})`)}`, value: "gemini" },
+          { name: `Antigravity ${ansis.green(`(${i18n.t("init:model.recommended")})`)}`, value: "antigravity" },
+          { name: "Gemini", value: "gemini" },
           { name: "Codex", value: "codex" },
           ...navSentinels(canGoBack)
         ],
-        default: frontendModels[0] || "gemini"
+        default: frontendModels[0] || "antigravity"
       }]);
       if (selectedFrontend === BACK_SENTINEL)
         return "back";
@@ -3305,8 +3362,9 @@ async function init(options = {}) {
         name: "selectedBackend",
         message: i18n.t("init:model.selectBackend"),
         choices: [
-          { name: "Gemini", value: "gemini" },
-          { name: `Codex ${ansis.green(`(${i18n.t("init:model.recommended")})`)}`, value: "codex" }
+          { name: `Codex ${ansis.green(`(${i18n.t("init:model.recommended")})`)}`, value: "codex" },
+          { name: "Antigravity", value: "antigravity" },
+          { name: "Gemini", value: "gemini" }
         ],
         default: backendModels[0] || "codex"
       }]);
@@ -4634,7 +4692,7 @@ async function configModelRouting() {
   console.log();
   console.log(ansis.cyan.bold(`  ${i18n.t("init:model.title")}`));
   console.log();
-  const currentFrontend = config?.routing?.frontend?.primary || "gemini";
+  const currentFrontend = config?.routing?.frontend?.primary || "antigravity";
   const currentBackend = config?.routing?.backend?.primary || "codex";
   const currentGeminiModel = config?.routing?.geminiModel || "gemini-3.1-pro-preview";
   console.log(ansis.gray(`  ${i18n.t("init:model.currentRouting")}:`));
@@ -4649,7 +4707,8 @@ async function configModelRouting() {
     name: "selectedFrontend",
     message: i18n.t("init:model.selectFrontend"),
     choices: [
-      { name: `Gemini ${ansis.green(`(${i18n.t("init:model.recommended")})`)}`, value: "gemini" },
+      { name: `Antigravity ${ansis.green(`(${i18n.t("init:model.recommended")})`)}`, value: "antigravity" },
+      { name: "Gemini", value: "gemini" },
       { name: "Codex", value: "codex" }
     ],
     default: currentFrontend
@@ -4659,8 +4718,9 @@ async function configModelRouting() {
     name: "selectedBackend",
     message: i18n.t("init:model.selectBackend"),
     choices: [
-      { name: "Gemini", value: "gemini" },
-      { name: `Codex ${ansis.green(`(${i18n.t("init:model.recommended")})`)}`, value: "codex" }
+      { name: `Codex ${ansis.green(`(${i18n.t("init:model.recommended")})`)}`, value: "codex" },
+      { name: "Antigravity", value: "antigravity" },
+      { name: "Gemini", value: "gemini" }
     ],
     default: currentBackend
   }]);
@@ -4784,16 +4844,48 @@ async function handleCodexMode() {
   console.log();
   console.log(ansis.cyan.bold(isZh ? "  Codex \u591A\u6A21\u578B\u7F16\u6392\u6A21\u5F0F" : "  Codex Multi-Model Orchestration Mode"));
   console.log();
+  const { action } = await inquirer.prompt([{
+    type: "list",
+    name: "action",
+    message: isZh ? "\u9009\u62E9\u64CD\u4F5C" : "Select action",
+    choices: [
+      { name: isZh ? "\u5B89\u88C5 / \u66F4\u65B0 Codex \u6A21\u5F0F" : "Install / Update Codex Mode", value: "install" },
+      { name: isZh ? "\u5378\u8F7D Codex \u6A21\u5F0F\uFF08\u53EA\u5220 CCG \u6587\u4EF6\uFF0C\u4FDD\u7559\u7528\u6237\u914D\u7F6E\uFF09" : "Uninstall Codex Mode (CCG files only, preserves user config)", value: "uninstall" },
+      { name: isZh ? "\u8FD4\u56DE" : "Back", value: "back" }
+    ]
+  }]);
+  if (action === "back") return;
+  if (action === "uninstall") {
+    const spinner2 = ora(isZh ? "\u5378\u8F7D Codex \u6A21\u5F0F..." : "Uninstalling Codex mode...").start();
+    const result2 = await uninstallCodexMode();
+    if (result2.success) {
+      spinner2.succeed(isZh ? "Codex \u6A21\u5F0F\u5DF2\u5378\u8F7D" : "Codex mode uninstalled");
+      if (result2.removed.length > 0) {
+        console.log();
+        for (const f of result2.removed) {
+          console.log(`  ${ansis.red("\u2717")} ${f}`);
+        }
+      }
+      if (result2.skipped.length > 0) {
+        console.log();
+        for (const f of result2.skipped) {
+          console.log(`  ${ansis.gray("\u25CB")} ${f}`);
+        }
+      }
+    } else {
+      spinner2.fail(isZh ? "\u5378\u8F7D\u5931\u8D25" : "Uninstall failed");
+    }
+    return;
+  }
   console.log(
-    isZh ? "  \u5B89\u88C5 CCG Codex \u6A21\u5F0F\u5230 ~/.codex/\uFF0C\u8BA9 Codex CLI \u4F5C\u4E3A\u4E3B\u5BFC\u8005\u7F16\u6392 Gemini + Claude\u3002" : "  Install CCG Codex mode to ~/.codex/, enabling Codex CLI as lead orchestrator for Gemini + Claude."
+    isZh ? "  \u5B89\u88C5 CCG Codex \u6A21\u5F0F\u5230 ~/.codex/\uFF0C\u8BA9 Codex CLI \u4F5C\u4E3A\u4E3B\u5BFC\u8005\u7F16\u6392\u591A\u6A21\u578B\u3002" : "  Install CCG Codex mode to ~/.codex/, enabling Codex CLI as lead orchestrator."
   );
   console.log();
   console.log(isZh ? "  \u5C06\u5B89\u88C5:" : "  Will install:");
-  console.log("    ~/.codex/AGENTS.md              \u2014 Codex auto-read instructions");
+  console.log("    ~/.codex/AGENTS.md              \u2014 orchestration instructions");
   console.log("    ~/.codex/config.toml             \u2014 multi-agent + timeout config");
-  console.log("    ~/.codex/agents/ccg-implement.toml");
-  console.log("    ~/.codex/agents/ccg-review.toml");
-  console.log("    ~/.codex/agents/ccg-research.toml");
+  console.log("    ~/.codex/hooks.json + hooks/     \u2014 adaptive guardrail hook");
+  console.log("    ~/.codex/agents/ccg-*.toml       \u2014 sub-agent definitions");
   console.log();
   const { confirm } = await inquirer.prompt([{
     type: "confirm",
@@ -5070,4 +5162,4 @@ async function uninstallCCometixLine() {
   }
 }
 
-export { diagnoseMcpConfig as A, isWindows as B, readClaudeCodeConfig as C, fixWindowsMcpConfig as D, writeClaudeCodeConfig as E, configMcp as F, version as G, i18n as a, initI18n as b, changeLanguage as c, createDefaultConfig as d, createDefaultRouting as e, getConfigPath as f, getCcgDir as g, getWorkflowConfigs as h, init as i, getWorkflowById as j, installWorkflows as k, installAceTool as l, installAceToolRs as m, installCodexMode as n, uninstallWorkflows as o, uninstallAceTool as p, migrateToV1_4_0 as q, readCcgConfig as r, showMainMenu as s, needsMigration as t, update as u, getCurrentVersion as v, writeCcgConfig as w, getLatestVersion as x, checkForUpdates as y, compareVersions as z };
+export { compareVersions as A, diagnoseMcpConfig as B, isWindows as C, readClaudeCodeConfig as D, fixWindowsMcpConfig as E, writeClaudeCodeConfig as F, configMcp as G, version as H, i18n as a, initI18n as b, changeLanguage as c, createDefaultConfig as d, createDefaultRouting as e, getConfigPath as f, getCcgDir as g, getWorkflowConfigs as h, init as i, getWorkflowById as j, installWorkflows as k, installAceTool as l, installAceToolRs as m, installCodexMode as n, uninstallCodexMode as o, uninstallWorkflows as p, uninstallAceTool as q, readCcgConfig as r, showMainMenu as s, migrateToV1_4_0 as t, update as u, needsMigration as v, writeCcgConfig as w, getCurrentVersion as x, getLatestVersion as y, checkForUpdates as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccg-workflow",
-  "version": "3.0.10",
+  "version": "3.1.1",
   "description": "Claude + Codex + Gemini multi-model collaboration system - smart routing development workflow",
   "type": "module",
   "packageManager": "pnpm@10.17.1",
@@ -42,6 +42,7 @@
     "templates/prompts/gemini/reviewer.md",
     "templates/prompts/gemini/tester.md",
     "templates/prompts/claude/",
+    "templates/prompts/antigravity/",
     "templates/output-styles/",
     "templates/skills/",
     "templates/rules/"

package/templates/codex/AGENTS.md

@@ -127,13 +127,13 @@ ls .ccg/spec/ 2>/dev/null
 ### ⛔ 默认调用方式：双模型并行（M+ 复杂度必须用这个）
 
 ```bash
-~/.claude/bin/codeagent-wrapper --progress --backend gemini - "$(pwd)" <<'GEMINI_EOF'
-ROLE_FILE: ~/.claude/.ccg/prompts/gemini/$ROLE.md
+~/.claude/bin/codeagent-wrapper --progress --backend {{FRONTEND_PRIMARY}} - "$(pwd)" <<'FRONTEND_EOF'
+ROLE_FILE: ~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/$ROLE.md
 <TASK>
 {任务描述 + 上下文}
 </TASK>
 OUTPUT: {期望输出格式}
-GEMINI_EOF
+FRONTEND_EOF
 &
 ~/.claude/bin/codeagent-wrapper --progress --backend claude - "$(pwd)" <<'CLAUDE_EOF'
 ROLE_FILE: ~/.claude/.ccg/prompts/claude/$ROLE.md
@@ -152,8 +152,8 @@ wait
 
 #### Gemini（前端/UI 分析）
 ```bash
-~/.claude/bin/codeagent-wrapper --progress --backend gemini - "$(pwd)" <<'EOF'
-ROLE_FILE: ~/.claude/.ccg/prompts/gemini/$ROLE.md
+~/.claude/bin/codeagent-wrapper --progress --backend {{FRONTEND_PRIMARY}} - "$(pwd)" <<'EOF'
+ROLE_FILE: ~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/$ROLE.md
 <TASK>
 {任务描述 + 上下文}
 </TASK>
@@ -178,27 +178,94 @@ EOF
 ### 并行调用提醒
 M+ 复杂度的分析和审查，使用上方的"双模型并行"模板。不要分开调用，用 `&` + `wait` 并行执行。
 
-## 5. Implementation — 你自己写代码
+## 5. Implementation — 写代码
 
-### 执行模式：Inline（你自己按 plan 顺序逐文件写）
+### 模式选择
 
-**不要 spawn 子代理。** 你自己按 plan.md 的步骤顺序逐个文件写代码。这比子代理更稳定、更快、更可控。
+| 复杂度 | 模式 | 说明 |
+|--------|------|------|
+| **S-M** | **Inline** — 你自己写 | 逐文件按 plan 顺序，最稳定 |
+| **L+** | **Parallel** — spawn 子代理 | 按文件归属拆分，并行写，快 2-4x |
 
-### 执行流程
+### 模式 A: Inline（S-M 复杂度）
+
+按 plan.md 步骤顺序逐个文件写：
+1. 先写底层（store/model/util），再写上层（route/middleware）
+2. 每写完一个文件跑测试/类型检查
+3. 全部完成后跑完整测试套件
+4. `git diff` 确认变更在 plan 范围内
+
+### 模式 B: Parallel Spawn（L+ 复杂度）
+
+#### Step 1: 从 plan.md 拆分子任务
+
+按**文件归属**拆分，确保子任务互不重叠：
+- **Layer 1** — 无依赖的任务（可并行）
+- **Layer 2** — 依赖 Layer 1 的任务
+
+#### Step 2: 并行 spawn Layer 1
+
+**⛔ 关键：必须传 `fork_turns="none"`。** 否则子代理继承你的上下文，看到你的 spawn 记录，尝试 wait 自己 → 死锁。
+
+```
+# 所有 Layer 1 子代理在同一轮 spawn（= 真正并行）
+spawn_agent(
+  agent_type="ccg-implement",
+  fork_turns="none",
+  message="Active task: .ccg/tasks/{name}\n\n## 文件范围（⛔ 硬性规则）\n只能创建或修改：\n- {file1}\n- {file2}\n严禁修改其他文件。\n\n## 实施步骤\n{steps from plan.md}\n\n## 验收标准\n{criteria}"
+)
+spawn_agent(
+  agent_type="ccg-implement",
+  fork_turns="none",
+  message="Active task: .ccg/tasks/{name}\n\n## 文件范围\n- {file3}\n- {file4}\n\n## 实施步骤\n{steps}\n\n## 验收标准\n{criteria}"
+)
+```
+
+#### Step 3: Wait + Verify + Close
 
 ```
-1. 读 plan.md（如有）或回顾分析阶段的结论
-2. 按依赖顺序逐文件写：先写底层（store/model/util），再写上层（route/middleware）
-3. 每写完一个文件，跑一次测试/类型检查，确保不破坏现有功能
-4. 全部写完后，跑完整测试套件
-5. git diff 确认所有变更在 plan 范围内
+expected_agents = [agent_1, agent_2, ...]
+
+while expected_agents is not empty:
+  wait(agent_id, timeout=480000)   # 8 min
+  list_agents()                     # 检查所有存活代理状态
+  for each terminal agent:
+    - 检查交付物是否存在（文件已创建/修改）
+    - close_agent(agent_id)
+    - 从 expected_agents 移除
 ```
 
-### 写代码原则
+#### Step 4: Layer 2（有依赖的任务）
+
+Layer 1 全部完成后，再 spawn Layer 2 子代理（同样的模式）。
+
+#### Step 5: 审查
+
+spawn 审查代理：
+```
+spawn_agent(
+  agent_type="ccg-review",
+  fork_turns="none",
+  message="审查 .ccg/tasks/{name} 的所有变更。\n运行: git diff\n检查: 正确性/安全/性能/规范\n输出: Critical/Warning/Info 分级报告"
+)
+wait(review_agent)
+close_agent(review_agent)
+```
+
+Critical 问题 → spawn 修复代理。Warning → 视情况修复。
+
+#### ⛔ Spawn 铁律
+
+1. **fork_turns="none" 永远不可省略** — 省略 = 死锁
+2. **子代理禁止再 spawn** — ccg-implement.toml 已关闭 multi_agent
+3. **每个文件同一时刻只有一个子代理可写** — 文件归属不可重叠
+4. **wait 超时要够长** — 默认 480s，复杂任务调到 600s
+5. **所有子代理必须 close** — 不 close = 资源泄漏
+
+### 写代码原则（两种模式通用）
 
 - **先读再写** — 修改文件前先读取完整内容，理解现有模式
 - **遵守 Spec** — .ccg/spec/ 里的约定是法律
-- **一个文件一个 commit 思路** — 每个文件的变更应该是自包含的
 - **不扩大范围** — plan 没说改的文件不要动
 - **测试驱动** — 新功能先写测试骨架，再写实现
 
@@ -220,8 +287,8 @@ M+ 复杂度的分析和审查，使用上方的"双模型并行"模板。不要
 
 ```bash
 # 必须并行调用两个模型审查 git diff
-~/.claude/bin/codeagent-wrapper --progress --backend gemini - "$(pwd)" <<'EOF'
-ROLE_FILE: ~/.claude/.ccg/prompts/gemini/reviewer.md
+~/.claude/bin/codeagent-wrapper --progress --backend {{FRONTEND_PRIMARY}} - "$(pwd)" <<'EOF'
+ROLE_FILE: ~/.claude/.ccg/prompts/{{FRONTEND_PRIMARY}}/reviewer.md
 <TASK>审查以下代码变更：$(git diff)</TASK>
 OUTPUT: Critical/Warning/Info 分级审查报告
 EOF