ccg-workflow 3.0.0 → 3.0.1

package/README.md

@@ -1,17 +1,31 @@
 # CCG - Claude + Codex + Gemini Multi-Model Collaboration
 
+<div align="center">
+
+<img src="assets/logo/ccg-logo-cropped.png" alt="CCG Workflow" width="400">
+
 [![GitHub stars](https://img.shields.io/github/stars/fengshao1227/ccg-workflow?style=social)](https://github.com/fengshao1227/ccg-workflow)
 [![NPM Downloads](https://img.shields.io/npm/dt/ccg-workflow?style=flat-square&color=blue)](https://www.npmjs.com/package/ccg-workflow)
 [![npm version](https://img.shields.io/npm/v/ccg-workflow.svg)](https://www.npmjs.com/package/ccg-workflow)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Claude Code](https://img.shields.io/badge/Claude%20Code-Compatible-green.svg)](https://claude.ai/code)
+[![Tests](https://img.shields.io/badge/Tests-139%20passed-brightgreen.svg)]()
+[![Follow on X](https://img.shields.io/badge/X-@CCG__Workflow-black?logo=x&logoColor=white)](https://x.com/CCG_Workflow)
+![star](https://atomgit.com/fengshao1227/ccg-workflow/star/badge.svg)
 
 [简体中文](./README.zh-CN.md) | English
 
-## Sponsor
+</div>
+
+## ♥️ Sponsor
 
-[302.AI](https://share.302.ai/oUDqQ6) — Pay-as-you-go enterprise AI resource hub with the latest AI models and APIs.
+[![302.AI](assets/sponsors/302.ai-en.jpg)](https://share.302.ai/oUDqQ6)
 
-[n1n.ai](https://api.n1n.ai/register?channel=c_ivgzug0w) — One API Key to access 500+ AI models.
+[302.AI](https://share.302.ai/oUDqQ6) is a pay-as-you-go enterprise AI resource hub that offers the latest and most comprehensive AI models and APIs on the market, along with a variety of ready-to-use online AI applications.
+
+---
+
+[**n1n.ai**](https://api.n1n.ai/register?channel=c_ivgzug0w) — Global LLM API Gateway. One API Key to access 500+ top AI models (GPT-5, Claude 4.5, Gemini 3 Pro, and more).
 
 ---
 
@@ -224,6 +238,11 @@ npx ccg-workflow            # Select "Uninstall" from menu
 - **Issues**: [GitHub Issues](https://github.com/fengshao1227/ccg-workflow/issues)
 - **Community**: [Linux.do](https://linux.do)
 
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=fengshao1227/ccg-workflow&type=timeline&legend=top-left)](https://www.star-history.com/#fengshao1227/ccg-workflow&type=timeline&legend=top-left)
+
 ## License
 
 MIT

package/README.zh-CN.md

@@ -1,15 +1,32 @@
 # CCG - Claude + Codex + Gemini 多模型协作
+# CCG - Claude + Codex + Gemini Multi-Model Collaboration
 
+<div align="center">
+
+<img src="assets/logo/ccg-logo-cropped.png" alt="CCG Workflow" width="400">
+
+[![GitHub stars](https://img.shields.io/github/stars/fengshao1227/ccg-workflow?style=social)](https://github.com/fengshao1227/ccg-workflow)
+[![NPM Downloads](https://img.shields.io/npm/dt/ccg-workflow?style=flat-square&color=blue)](https://www.npmjs.com/package/ccg-workflow)
 [![npm version](https://img.shields.io/npm/v/ccg-workflow.svg)](https://www.npmjs.com/package/ccg-workflow)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Claude Code](https://img.shields.io/badge/Claude%20Code-Compatible-green.svg)](https://claude.ai/code)
+[![Tests](https://img.shields.io/badge/Tests-139%20passed-brightgreen.svg)]()
+[![Follow on X](https://img.shields.io/badge/X-@CCG__Workflow-black?logo=x&logoColor=white)](https://x.com/CCG_Workflow)
+![star](https://atomgit.com/fengshao1227/ccg-workflow/star/badge.svg)
+
+[简体中文](./README.zh-CN.md) | English
 
-简体中文 | [English](./README.md)
+</div>
 
-## 赞助商
+## ♥️ Sponsor
 
-[302.AI](https://share.302.ai/oUDqQ6) — 按用量付费的企业级 AI 资源平台。
+[![302.AI](assets/sponsors/302.ai-en.jpg)](https://share.302.ai/oUDqQ6)
+
+[302.AI](https://share.302.ai/oUDqQ6) is a pay-as-you-go enterprise AI resource hub that offers the latest and most comprehensive AI models and APIs on the market, along with a variety of ready-to-use online AI applications.
+
+---
 
-[n1n.ai](https://api.n1n.ai/register?channel=c_ivgzug0w) — 一个 API Key 连接 500+ AI 模型。
+[**n1n.ai**](https://api.n1n.ai/register?channel=c_ivgzug0w) — Global LLM API Gateway. One API Key to access 500+ top AI models (GPT-5, Claude 4.5, Gemini 3 Pro, and more).
 
 ---
 

package/dist/cli.mjs

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

package/dist/index.mjs

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

package/dist/shared/{ccg-workflow.81OoN8XX.mjs → ccg-workflow.2vO_S-e7.mjs}

@@ -10,7 +10,7 @@ import fs from 'fs-extra';
 import { parse, stringify } from 'smol-toml';
 import i18next from 'i18next';
 
-const version = "3.0.0";
+const version = "3.0.1";
 
 function cmd(id, order, category, name, nameEn, description, descriptionEn, cmdOverride) {
   return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccg-workflow",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "Claude + Codex + Gemini multi-model collaboration system - smart routing development workflow",
   "type": "module",
   "packageManager": "pnpm@10.17.1",

package/templates/commands/go.md

@@ -127,7 +127,9 @@ $ARGUMENTS
 mkdir -p .ccg/tasks/{task-name}
 ```
 
-**Step 3**: 写入 `.ccg/tasks/{task-name}/task.json`：
+**Step 3**: 获取当前 git 分支名：`git rev-parse --abbrev-ref HEAD`
+
+**Step 4**: 写入 `.ccg/tasks/{task-name}/task.json`：
 
 ```json
 {
@@ -138,11 +140,15 @@ mkdir -p .ccg/tasks/{task-name}
   "currentPhase": "1",
   "nextAction": "{策略第一阶段的描述}",
   "gate": null,
+  "branch": "{当前 git 分支}",
+  "scope": "{task-name}",
   "createdAt": "{当前 ISO 日期时间}"
 }
 ```
 
-**Step 4**: 如果 `.ccg/spec/` 目录存在，创建 `.ccg/tasks/{task-name}/context.jsonl`，列出相关 spec 文件。
+**Step 5**: 创建 `.ccg/tasks/{task-name}/context.jsonl` 种子文件：
+- 第一行写种子示例：`{"_example": "Fill with {\"file\": \"path\", \"reason\": \"why\"}. Seed rows are skipped."}`
+- 如果 `.ccg/spec/` 存在 → 追加 spec 文件条目
 
 **复杂度 S → 跳过任务创建**（保持轻量）。
 

package/templates/engine/strategies/debug-investigate.md

@@ -144,7 +144,13 @@ Gate: 用户已确认修复方向 ✓
      📍 Next: /ccg commit 提交修复
    ```
 
-**Task 更新**：`status → "completed"`, `nextAction → "可用 /ccg:commit 提交修复"`
+**Task 更新**：`status → "archived"`
+
+**归档任务**：
+```bash
+mkdir -p .ccg/tasks/archive/$(date +%Y-%m) && mv .ccg/tasks/{task-name} .ccg/tasks/archive/$(date +%Y-%m)/
+git add .ccg/tasks/ && git commit -m "chore: archive ccg task"
+```
 
 ---
 

package/templates/engine/strategies/full-collaborate.md

@@ -277,7 +277,21 @@ SendMessage({ to: "reviewer", message: { type: "shutdown_request" } })
      📍 Next: /ccg commit 提交，或查看 .ccg/tasks/{task-name}/ 中的完整记录
    ```
 
-**Task 更新**：`status → "completed"`, `nextAction → "可用 /ccg:commit 提交"`
+**Task 更新**：`status → "archived"`
+
+**归档任务**：将 `.ccg/tasks/{task-name}/` 移动到 `.ccg/tasks/archive/YYYY-MM/{task-name}/`
+```bash
+mkdir -p .ccg/tasks/archive/$(date +%Y-%m) && mv .ccg/tasks/{task-name} .ccg/tasks/archive/$(date +%Y-%m)/
+```
+
+**自动提交归档**：
+```bash
+git add .ccg/tasks/ && git commit -m "chore: archive ccg task {task-name}"
+```
+
+```
+📍 Next: /ccg:commit 提交产品代码
+```
 
 ---
 

package/templates/engine/strategies/guided-develop.md

@@ -188,7 +188,13 @@ TaskOutput({ task_id: "<id>", block: true, timeout: 600000 })
      📍 Next: 可以用 /ccg:commit 提交
    ```
 
-**Task 更新**：`status → "completed"`, `nextAction → "可用 /ccg:commit 提交"`
+**Task 更新**：`status → "archived"`
+
+**归档任务**：
+```bash
+mkdir -p .ccg/tasks/archive/$(date +%Y-%m) && mv .ccg/tasks/{task-name} .ccg/tasks/archive/$(date +%Y-%m)/
+git add .ccg/tasks/ && git commit -m "chore: archive ccg task"
+```
 
 ---
 

package/templates/engine/strategies/refactor-safely.md

@@ -145,7 +145,13 @@ Step [N/M]: [描述] — ✅ 测试通过 / ❌ 测试失败
      📍 Next: /ccg:commit 提交
    ```
 
-**Task 更新**：`status → "completed"`, `nextAction → "可用 /ccg:commit 提交"`
+**Task 更新**：`status → "archived"`
+
+**归档任务**：
+```bash
+mkdir -p .ccg/tasks/archive/$(date +%Y-%m) && mv .ccg/tasks/{task-name} .ccg/tasks/archive/$(date +%Y-%m)/
+git add .ccg/tasks/ && git commit -m "chore: archive ccg task"
+```
 
 ---
 

package/templates/hooks/task-utils.js

@@ -25,9 +25,10 @@ function getActiveTask(projectRoot) {
   try {
     const dirs = fs.readdirSync(tasksDir)
       .filter(d => {
+        if (d === 'archive') return false;
         try {
-          return fs.statSync(path.join(tasksDir, d)).isDirectory()
-            && fs.existsSync(path.join(tasksDir, d, 'task.json'));
+          const full = path.join(tasksDir, d);
+          return fs.statSync(full).isDirectory() && fs.existsSync(path.join(full, 'task.json'));
         } catch { return false; }
       })
       .sort()
@@ -35,10 +36,12 @@ function getActiveTask(projectRoot) {
 
     for (const dir of dirs) {
       try {
-        const raw = fs.readFileSync(path.join(tasksDir, dir, 'task.json'), 'utf-8');
+        const taskPath = path.join(tasksDir, dir, 'task.json');
+        if (!fs.existsSync(taskPath)) continue; // stale pointer detection
+        const raw = fs.readFileSync(taskPath, 'utf-8');
         const task = JSON.parse(raw);
         if (task.status !== 'completed' && task.status !== 'archived') {
-          return { dir: path.join(tasksDir, dir), ...task };
+          return { dir: path.join(tasksDir, dir), ...task, _stale: false };
         }
       } catch { /* skip malformed */ }
     }
@@ -101,6 +104,54 @@ function outputHook(eventName, additionalContext) {
   }));
 }
 
+function archiveTask(taskDir, projectRoot) {
+  try {
+    const now = new Date();
+    const month = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}`;
+    const archiveDir = path.join(projectRoot, '.ccg', 'tasks', 'archive', month);
+    if (!fs.existsSync(archiveDir)) fs.mkdirSync(archiveDir, { recursive: true });
+    const name = path.basename(taskDir);
+    const dest = path.join(archiveDir, name);
+    fs.renameSync(taskDir, dest);
+    return dest;
+  } catch { return null; }
+}
+
+function autoCommitTask(projectRoot, message) {
+  try {
+    const { execSync } = require('child_process');
+    execSync('git add .ccg/tasks/', { cwd: projectRoot, stdio: 'pipe' });
+    const diff = execSync('git diff --cached --quiet', { cwd: projectRoot, stdio: 'pipe' }).toString();
+    return false; // nothing to commit
+  } catch {
+    try {
+      const { execSync } = require('child_process');
+      execSync(`git commit -m "${message || 'chore: archive ccg task'}"`, { cwd: projectRoot, stdio: 'pipe' });
+      return true;
+    } catch { return false; }
+  }
+}
+
+function seedContextJsonl(taskDir, projectRoot) {
+  const jsonlPath = path.join(taskDir, 'context.jsonl');
+  if (fs.existsSync(jsonlPath)) return;
+  const specDir = path.join(projectRoot, '.ccg', 'spec');
+  const lines = ['{"_example": "Fill with {\\\"file\\\": \\\"path\\\", \\\"reason\\\": \\\"why\\\"}. One entry per line. Seed rows (with _example key) are skipped."}'];
+  if (fs.existsSync(specDir)) {
+    try {
+      const walk = (dir, prefix) => {
+        for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
+          const rel = prefix ? `${prefix}/${e.name}` : e.name;
+          if (e.isDirectory()) walk(path.join(dir, e.name), rel);
+          else if (e.name.endsWith('.md')) lines.push(JSON.stringify({ file: `.ccg/spec/${rel}`, reason: 'project spec' }));
+        }
+      };
+      walk(specDir, '');
+    } catch { /* silent */ }
+  }
+  try { fs.writeFileSync(jsonlPath, lines.join('\n') + '\n', 'utf-8'); } catch { /* silent */ }
+}
+
 module.exports = {
   findProjectRoot,
   getActiveTask,
@@ -109,5 +160,8 @@ module.exports = {
   readContextJsonl,
   detectTechStack,
   getGitInfo,
-  outputHook
+  outputHook,
+  archiveTask,
+  autoCommitTask,
+  seedContextJsonl
 };