✨ 同步原版 v0.16.0

Author: Minidoracat

.changeset/sync-upstream-v0.16.0.md

@@ -0,0 +1,19 @@
+---
+"@minidoracat/openspec-tw": minor
+---
+
+同步原版 v0.16.0
+
+**新增 AI 工具支援**：
+- iFlow-cli
+- Antigravity
+
+**程式碼重構**：
+- 新增 TomlSlashCommandConfigurator 基底類別
+- 重構 Gemini 和 Qwen 配置器使用新基底類別
+
+**功能改進**：
+- 新增 IDE 重啟提示（繁體中文本地化）
+
+**Bug 修復**：
+- 修正 Qwen Code slash 命令檔名（.md → .toml）

CLAUDE.md

@@ -54,7 +54,7 @@ pnpm run release:local                # 本地發布測試
 # 原版同步（使用 openspec-upstream/ 目錄）
 cd openspec-upstream && git fetch origin --tags  # 獲取最新標籤
 git tag -l | sort -V | tail -5                   # 查看最新版本
-git checkout v0.15.0                              # 檢出目標版本
+git checkout v0.16.0                              # 檢出目標版本
 cd .. && diff -r --brief src openspec-upstream/src  # 比對差異
 ```
 
@@ -111,11 +111,11 @@ cd .. && diff -r --brief src openspec-upstream/src  # 比對差異
 | 原版追蹤     | `openspec-upstream/`               | 不提交   | 原版 git 倉庫，用於追蹤原版更新 |
 
 ### 版本對應關係
-- **當前版本**：v0.15.0（查看 `package.json` 中的 `version` 欄位）
-- **原版版本**：v0.15.0（Git tag）
-- **同步狀態**：✅ 已同步（基於原版 v0.15.0）
-- **同步日期**：2025-11-18
-- **核心功能**：新增 Qwen Code、Qoder、CoStrict、Gemini CLI、RooCode 支援；改進工具檢測邏輯
+- **當前版本**：v0.16.0（查看 `package.json` 中的 `version` 欄位）
+- **原版版本**：v0.16.0（Git tag）
+- **同步狀態**：✅ 已同步（基於原版 v0.16.0）
+- **同步日期**：2025-11-25
+- **核心功能**：新增 iFlow-cli、Antigravity 支援；重構 TOML 基底類別；新增 IDE 重啟提示；修復 Qwen Code TOML 檔名
 - **本地化狀態**：✅ 完成繁體中文本地化
 
 ### 緊急情況處理

src/core/configurators/iflow.ts

@@ -0,0 +1,23 @@
+import path from "path";
+import { ToolConfigurator } from "./base.js";
+import { FileSystemUtils } from "../../utils/file-system.js";
+import { TemplateManager } from "../templates/index.js";
+import { OPENSPEC_MARKERS } from "../config.js";
+
+export class IflowConfigurator implements ToolConfigurator {
+  name = "iFlow";
+  configFileName = "IFLOW.md";
+  isAvailable = true;
+
+  async configure(projectPath: string, openspecDir: string): Promise<void> {
+    const filePath = path.join(projectPath, this.configFileName);
+    const content = TemplateManager.getClaudeTemplate();
+
+    await FileSystemUtils.updateFileWithMarkers(
+      filePath,
+      content,
+      OPENSPEC_MARKERS.start,
+      OPENSPEC_MARKERS.end
+    );
+  }
+}

src/core/configurators/registry.ts

@@ -4,6 +4,7 @@ import { ClineConfigurator } from './cline.js';
 import { CodeBuddyConfigurator } from './codebuddy.js';
 import { CostrictConfigurator } from './costrict.js';
 import { QoderConfigurator } from './qoder.js';
+import { IflowConfigurator } from './iflow.js';
 import { AgentsStandardConfigurator } from './agents.js';
 import { QwenConfigurator } from './qwen.js';
 
@@ -16,6 +17,7 @@ export class ToolRegistry {
     const codeBuddyConfigurator = new CodeBuddyConfigurator();
     const costrictConfigurator = new CostrictConfigurator();
     const qoderConfigurator = new QoderConfigurator();
+    const iflowConfigurator = new IflowConfigurator();
     const agentsConfigurator = new AgentsStandardConfigurator();
     const qwenConfigurator = new QwenConfigurator();
     // Register with the ID that matches the checkbox value
@@ -24,6 +26,7 @@ export class ToolRegistry {
     this.tools.set('codebuddy', codeBuddyConfigurator);
     this.tools.set('costrict', costrictConfigurator);
     this.tools.set('qoder', qoderConfigurator);
+    this.tools.set('iflow', iflowConfigurator);
     this.tools.set('agents', agentsConfigurator);
     this.tools.set('qwen', qwenConfigurator);
   }

src/core/configurators/slash/antigravity.ts

@@ -0,0 +1,28 @@
+import { SlashCommandConfigurator } from './base.js';
+import { SlashCommandId } from '../../templates/index.js';
+
+const FILE_PATHS: Record<SlashCommandId, string> = {
+  proposal: '.agent/workflows/openspec-proposal.md',
+  apply: '.agent/workflows/openspec-apply.md',
+  archive: '.agent/workflows/openspec-archive.md'
+};
+
+const DESCRIPTIONS: Record<SlashCommandId, string> = {
+  proposal: 'Scaffold a new OpenSpec change and validate strictly.',
+  apply: 'Implement an approved OpenSpec change and keep tasks in sync.',
+  archive: 'Archive a deployed OpenSpec change and update specs.'
+};
+
+export class AntigravitySlashCommandConfigurator extends SlashCommandConfigurator {
+  readonly toolId = 'antigravity';
+  readonly isAvailable = true;
+
+  protected getRelativePath(id: SlashCommandId): string {
+    return FILE_PATHS[id];
+  }
+
+  protected getFrontmatter(id: SlashCommandId): string | undefined {
+    const description = DESCRIPTIONS[id];
+    return `---\ndescription: ${description}\n---`;
+  }
+}

src/core/configurators/slash/gemini.ts

@@ -1,7 +1,5 @@
-import { FileSystemUtils } from '../../../utils/file-system.js';
-import { SlashCommandConfigurator } from './base.js';
-import { SlashCommandId, TemplateManager } from '../../templates/index.js';
-import { OPENSPEC_MARKERS } from '../../config.js';
+import { TomlSlashCommandConfigurator } from './toml-base.js';
+import { SlashCommandId } from '../../templates/index.js';
 
 const FILE_PATHS: Record<SlashCommandId, string> = {
   proposal: '.gemini/commands/openspec/proposal.toml',
@@ -15,69 +13,15 @@ const DESCRIPTIONS: Record<SlashCommandId, string> = {
   archive: 'Archive a deployed OpenSpec change and update specs.'
 };
 
-export class GeminiSlashCommandConfigurator extends SlashCommandConfigurator {
+export class GeminiSlashCommandConfigurator extends TomlSlashCommandConfigurator {
   readonly toolId = 'gemini';
   readonly isAvailable = true;
 
   protected getRelativePath(id: SlashCommandId): string {
     return FILE_PATHS[id];
   }
 
-  protected getFrontmatter(_id: SlashCommandId): string | undefined {
-    // TOML doesn't use separate frontmatter - it's all in one structure
-    return undefined;
-  }
-
-  // Override to generate TOML format with markers inside the prompt field
-  async generateAll(projectPath: string, _openspecDir: string): Promise<string[]> {
-    const createdOrUpdated: string[] = [];
-
-    for (const target of this.getTargets()) {
-      const body = this.getBody(target.id);
-      const filePath = FileSystemUtils.joinPath(projectPath, target.path);
-
-      if (await FileSystemUtils.fileExists(filePath)) {
-        await this.updateBody(filePath, body);
-      } else {
-        const tomlContent = this.generateTOML(target.id, body);
-        await FileSystemUtils.writeFile(filePath, tomlContent);
-      }
-
-      createdOrUpdated.push(target.path);
-    }
-
-    return createdOrUpdated;
-  }
-
-  private generateTOML(id: SlashCommandId, body: string): string {
-    const description = DESCRIPTIONS[id];
-
-    // TOML format with triple-quoted string for multi-line prompt
-    // Markers are inside the prompt value
-    return `description = "${description}"
-
-prompt = """
-${OPENSPEC_MARKERS.start}
-${body}
-${OPENSPEC_MARKERS.end}
-"""
-`;
-  }
-
-  // Override updateBody to handle TOML format
-  protected async updateBody(filePath: string, body: string): Promise<void> {
-    const content = await FileSystemUtils.readFile(filePath);
-    const startIndex = content.indexOf(OPENSPEC_MARKERS.start);
-    const endIndex = content.indexOf(OPENSPEC_MARKERS.end);
-
-    if (startIndex === -1 || endIndex === -1 || endIndex <= startIndex) {
-      throw new Error(`Missing OpenSpec markers in ${filePath}`);
-    }
-
-    const before = content.slice(0, startIndex + OPENSPEC_MARKERS.start.length);
-    const after = content.slice(endIndex);
-    const updatedContent = `${before}\n${body}\n${after}`;
-
-    await FileSystemUtils.writeFile(filePath, updatedContent);
+  protected getDescription(id: SlashCommandId): string {
+    return DESCRIPTIONS[id];
   }
 }

src/core/configurators/slash/iflow.ts

@@ -0,0 +1,42 @@
+import { SlashCommandConfigurator } from './base.js';
+import { SlashCommandId } from '../../templates/index.js';
+
+const FILE_PATHS: Record<SlashCommandId, string> = {
+  proposal: '.iflow/commands/openspec-proposal.md',
+  apply: '.iflow/commands/openspec-apply.md',
+  archive: '.iflow/commands/openspec-archive.md'
+};
+
+const FRONTMATTER: Record<SlashCommandId, string> = {
+  proposal: `---
+name: /openspec-proposal
+id: openspec-proposal
+category: OpenSpec
+description: Scaffold a new OpenSpec change and validate strictly.
+---`,
+  apply: `---
+name: /openspec-apply
+id: openspec-apply
+category: OpenSpec
+description: Implement an approved OpenSpec change and keep tasks in sync.
+---`,
+  archive: `---
+name: /openspec-archive
+id: openspec-archive
+category: OpenSpec
+description: Archive a deployed OpenSpec change and update specs.
+---`
+};
+
+export class IflowSlashCommandConfigurator extends SlashCommandConfigurator {
+  readonly toolId = 'iflow';
+  readonly isAvailable = true;
+
+  protected getRelativePath(id: SlashCommandId): string {
+    return FILE_PATHS[id];
+  }
+
+  protected getFrontmatter(id: SlashCommandId): string {
+    return FRONTMATTER[id];
+  }
+}

src/core/configurators/slash/qwen.ts

@@ -5,43 +5,23 @@
  *
  * @implements {SlashCommandConfigurator}
  */
-import { SlashCommandConfigurator } from './base.js';
+import { TomlSlashCommandConfigurator } from './toml-base.js';
 import { SlashCommandId } from '../../templates/index.js';
 
 /**
  * Mapping of slash command IDs to their corresponding file paths in .qwen/commands directory.
  * @type {Record<SlashCommandId, string>}
  */
 const FILE_PATHS: Record<SlashCommandId, string> = {
-  proposal: '.qwen/commands/openspec-proposal.md',
-  apply: '.qwen/commands/openspec-apply.md',
-  archive: '.qwen/commands/openspec-archive.md'
+  proposal: '.qwen/commands/openspec-proposal.toml',
+  apply: '.qwen/commands/openspec-apply.toml',
+  archive: '.qwen/commands/openspec-archive.toml'
 };
 
-/**
- * YAML frontmatter definitions for Qwen command files.
- * These provide metadata for each slash command to ensure proper recognition by Qwen Code.
- * @type {Record<SlashCommandId, string>}
- */
-const FRONTMATTER: Record<SlashCommandId, string> = {
-  proposal: `---
-name: /openspec-proposal
-id: openspec-proposal
-category: OpenSpec
-description: Scaffold a new OpenSpec change and validate strictly.
----`,
-  apply: `---
-name: /openspec-apply
-id: openspec-apply
-category: OpenSpec
-description: Implement an approved OpenSpec change and keep tasks in sync.
----`,
-  archive: `---
-name: /openspec-archive
-id: openspec-archive
-category: OpenSpec
-description: Archive a deployed OpenSpec change and update specs.
----`
+const DESCRIPTIONS: Record<SlashCommandId, string> = {
+  proposal: 'Scaffold a new OpenSpec change and validate strictly.',
+  apply: 'Implement an approved OpenSpec change and keep tasks in sync.',
+  archive: 'Archive a deployed OpenSpec change and update specs.'
 };
 
 /**
@@ -53,7 +33,7 @@ description: Archive a deployed OpenSpec change and update specs.
  * - /openspec-apply: Apply an approved OpenSpec change
  * - /openspec-archive: Archive a deployed OpenSpec change
  */
-export class QwenSlashCommandConfigurator extends SlashCommandConfigurator {
+export class QwenSlashCommandConfigurator extends TomlSlashCommandConfigurator {
   /** Unique identifier for the Qwen tool */
   readonly toolId = 'qwen';
 
@@ -69,12 +49,7 @@ export class QwenSlashCommandConfigurator extends SlashCommandConfigurator {
     return FILE_PATHS[id];
   }
 
-  /**
-   * Returns the YAML frontmatter for a given slash command ID.
-   * @param {SlashCommandId} id - The slash command identifier
-   * @returns {string} The YAML frontmatter string
-   */
-  protected getFrontmatter(id: SlashCommandId): string {
-    return FRONTMATTER[id];
+  protected getDescription(id: SlashCommandId): string {
+    return DESCRIPTIONS[id];
   }
 }

src/core/configurators/slash/registry.ts

@@ -17,6 +17,8 @@ import { CrushSlashCommandConfigurator } from './crush.js';
 import { CostrictSlashCommandConfigurator } from './costrict.js';
 import { QwenSlashCommandConfigurator } from './qwen.js';
 import { RooCodeSlashCommandConfigurator } from './roocode.js';
+import { AntigravitySlashCommandConfigurator } from './antigravity.js';
+import { IflowSlashCommandConfigurator } from './iflow.js';
 
 export class SlashCommandRegistry {
   private static configurators: Map<string, SlashCommandConfigurator> = new Map();
@@ -40,6 +42,8 @@ export class SlashCommandRegistry {
     const costrict = new CostrictSlashCommandConfigurator();
     const qwen = new QwenSlashCommandConfigurator();
     const roocode = new RooCodeSlashCommandConfigurator();
+    const antigravity = new AntigravitySlashCommandConfigurator();
+    const iflow = new IflowSlashCommandConfigurator();
 
     this.configurators.set(claude.toolId, claude);
     this.configurators.set(codeBuddy.toolId, codeBuddy);
@@ -59,6 +63,8 @@ export class SlashCommandRegistry {
     this.configurators.set(costrict.toolId, costrict);
     this.configurators.set(qwen.toolId, qwen);
     this.configurators.set(roocode.toolId, roocode);
+    this.configurators.set(antigravity.toolId, antigravity);
+    this.configurators.set(iflow.toolId, iflow);
   }
 
   static register(configurator: SlashCommandConfigurator): void {