@fitlab-ai/agent-infra 0.3.1 → 0.4.0

package/lib/update.js

@@ -1,15 +1,75 @@
 import fs from 'node:fs';
 import path from 'node:path';
-import { execSync } from 'node:child_process';
 import { info, ok, err } from './log.js';
-import { resolveTemplateDir, resolveInstallDir, isCloneInstall } from './paths.js';
+import { resolveTemplateDir } from './paths.js';
 import { renderFile, copySkillDir } from './render.js';
 
 const defaults = JSON.parse(
   fs.readFileSync(new URL('./defaults.json', import.meta.url), 'utf8')
 );
 
+const CONFIG_DIR = '.agents';
+const CONFIG_PATH = path.join(CONFIG_DIR, '.airc.json');
+const LEGACY_CONFIG_PATHS = ['.airc.json', path.join('.agent-infra', 'config.json')];
+const WORKSPACE_PATH = path.join(CONFIG_DIR, 'workspace');
+const LEGACY_WORKSPACE_PATHS = ['.agent-workspace', path.join('.agent-infra', 'workspace')];
+
+function migrateLegacyPaths() {
+  let migratedConfig = false;
+  let migratedWorkspace = false;
+  let configFrom = null;
+  let workspaceFrom = null;
+
+  if (!fs.existsSync(CONFIG_PATH)) {
+    for (const legacyPath of LEGACY_CONFIG_PATHS) {
+      if (!fs.existsSync(legacyPath)) {
+        continue;
+      }
+      fs.mkdirSync(CONFIG_DIR, { recursive: true });
+      fs.renameSync(legacyPath, CONFIG_PATH);
+      migratedConfig = true;
+      configFrom = legacyPath;
+      break;
+    }
+  }
+
+  if (!fs.existsSync(WORKSPACE_PATH)) {
+    for (const legacyPath of LEGACY_WORKSPACE_PATHS) {
+      if (!fs.existsSync(legacyPath)) {
+        continue;
+      }
+      fs.mkdirSync(CONFIG_DIR, { recursive: true });
+      fs.renameSync(legacyPath, WORKSPACE_PATH);
+      migratedWorkspace = true;
+      workspaceFrom = legacyPath;
+      break;
+    }
+  }
+
+  try {
+    if (fs.existsSync('.agent-infra') && fs.readdirSync('.agent-infra').length === 0) {
+      fs.rmdirSync('.agent-infra');
+    }
+  } catch {
+    // Ignore cleanup failures for partially migrated directories.
+  }
+
+  return { migratedConfig, migratedWorkspace, configFrom, workspaceFrom };
+}
+
 function syncFileRegistry(config) {
+  config.files ||= {};
+  const before = JSON.stringify({
+    files: {
+      managed: config.files.managed || [],
+      merged: config.files.merged || [],
+      ejected: config.files.ejected || []
+    }
+  });
+  config.files.managed = config.files.managed || [];
+  config.files.merged = config.files.merged || [];
+  config.files.ejected = config.files.ejected || [];
+
   const allExisting = [
     ...config.files.managed,
     ...config.files.merged,
@@ -30,7 +90,15 @@ function syncFileRegistry(config) {
     }
   }
 
-  return added;
+  const after = JSON.stringify({
+    files: {
+      managed: config.files.managed,
+      merged: config.files.merged,
+      ejected: config.files.ejected
+    }
+  });
+
+  return { added, changed: before !== after };
 }
 
 async function cmdUpdate() {
@@ -39,9 +107,18 @@ async function cmdUpdate() {
   console.log('  ==================================');
   console.log('');
 
-  // check .airc.json exists
-  if (!fs.existsSync('.airc.json')) {
-    err('No .airc.json found in current directory.');
+  const { migratedConfig, migratedWorkspace, configFrom, workspaceFrom } = migrateLegacyPaths();
+
+  if (migratedConfig) {
+    ok(`Migrated ${configFrom} -> ${CONFIG_PATH}`);
+  }
+  if (migratedWorkspace) {
+    ok(`Migrated ${workspaceFrom} -> ${WORKSPACE_PATH}`);
+  }
+
+  // check config exists
+  if (!fs.existsSync(CONFIG_PATH)) {
+    err(`No ${CONFIG_PATH} found in current directory.`);
     err('Run "ai init" first to initialize the project.');
     process.exitCode = 1;
     return;
@@ -52,27 +129,12 @@ async function cmdUpdate() {
   if (!templateDir) {
     err('Template directory not found.');
     err('Install via npm: npm install -g @fitlab-ai/agent-infra');
-    err('Or via clone: curl -fsSL https://raw.githubusercontent.com/fitlab-ai/agent-infra/main/install.sh | sh');
     process.exitCode = 1;
     return;
   }
 
-  // auto-update: only for clone installs
-  if (isCloneInstall()) {
-    const installDir = resolveInstallDir();
-    if (fs.existsSync(path.join(installDir, '.git'))) {
-      info('Updating templates to latest version...');
-      try {
-        execSync('git pull --rebase --quiet', { cwd: installDir, stdio: 'pipe' });
-        ok('Templates updated.');
-      } catch {
-        err('Failed to update templates (network issue?). Using local version.');
-      }
-    }
-  }
-
   // read project config
-  const config = JSON.parse(fs.readFileSync('.airc.json', 'utf8'));
+  const config = JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf8'));
   const { project, org, language } = config;
   const replacements = { project, org };
 
@@ -130,20 +192,24 @@ async function cmdUpdate() {
   ok('Updated .opencode/commands/update-agent-infra.md');
 
   // sync file registry
-  const added = syncFileRegistry(config);
+  const { added, changed } = syncFileRegistry(config);
   const hasNewEntries = added.managed.length > 0 || added.merged.length > 0;
 
-  if (hasNewEntries) {
+  if (changed) {
     console.log('');
-    info('New file entries synced to .airc.json:');
-    for (const entry of added.managed) {
-      ok(`  managed: ${entry}`);
-    }
-    for (const entry of added.merged) {
-      ok(`  merged: ${entry}`);
+    if (hasNewEntries) {
+      info(`New file entries synced to ${CONFIG_PATH}:`);
+      for (const entry of added.managed) {
+        ok(`  managed: ${entry}`);
+      }
+      for (const entry of added.merged) {
+        ok(`  merged: ${entry}`);
+      }
+    } else {
+      info(`File registry changed in ${CONFIG_PATH}.`);
     }
-    fs.writeFileSync('.airc.json', JSON.stringify(config, null, 2) + '\n', 'utf8');
-    ok('Updated .airc.json');
+    fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2) + '\n', 'utf8');
+    ok(`Updated ${CONFIG_PATH}`);
   }
 
   // done

package/lib/version.js

@@ -1,7 +1,8 @@
 import { readFileSync } from 'node:fs';
 
-const { version: VERSION } = JSON.parse(
+const { version } = JSON.parse(
   readFileSync(new URL('../package.json', import.meta.url), 'utf8')
 );
+const VERSION = `v${version}`;
 
 export { VERSION };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fitlab-ai/agent-infra",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Bootstrap tool for AI multi-tool collaboration infrastructure — works with Claude Code, Codex, Gemini CLI, and OpenCode",
   "license": "MIT",
   "type": "module",
@@ -42,6 +42,7 @@
   ],
   "scripts": {
     "build": "node scripts/build-inline.js",
+    "prepare": "git config core.hooksPath .github/hooks || true",
     "test": "node scripts/build-inline.js --check && node --test tests/*.test.js",
     "prepublishOnly": "node scripts/build-inline.js --check && node --test tests/*.test.js"
   }

package/templates/.agents/QUICKSTART.md

@@ -13,7 +13,7 @@ This guide walks you through using multiple AI coding assistants together on a p
 1. Copy the task template to the active workspace:
 
 ```bash
-cp .agents/templates/task.md .agent-workspace/active/task-001.md
+cp .agents/templates/task.md .agents/workspace/active/task-001.md
 ```
 
 2. Fill in the task metadata:
@@ -49,7 +49,7 @@ Claude Code excels at codebase exploration and understanding complex relationshi
 gemini
 
 # Example prompt:
-# "Based on the analysis in .agent-workspace/active/task-001.md,
+# "Based on the analysis in .agents/workspace/active/task-001.md,
 #  create a technical design. Define interfaces and outline the approach."
 ```
 
@@ -60,7 +60,7 @@ gemini
 codex
 
 # Example prompt:
-# "Implement the changes described in .agent-workspace/active/task-001.md.
+# "Implement the changes described in .agents/workspace/active/task-001.md.
 #  Follow the design section. Create a new branch for this work."
 ```
 
@@ -87,7 +87,7 @@ claude
 
 ```bash
 # Quick bug fix workflow
-cp .agents/templates/task.md .agent-workspace/active/bugfix-001.md
+cp .agents/templates/task.md .agents/workspace/active/bugfix-001.md
 # Edit the task, then:
 # 1. Use Claude Code to analyze
 # 2. Use Codex/Cursor to fix
@@ -101,7 +101,7 @@ cp .agents/templates/task.md .agent-workspace/active/bugfix-001.md
 3. **Report**: Generate review report from template.
 
 ```bash
-cp .agents/templates/review-report.md .agent-workspace/active/review-pr-42.md
+cp .agents/templates/review-report.md .agents/workspace/active/review-pr-42.md
 # Use Claude Code to fill in the review
 ```
 
@@ -113,7 +113,7 @@ cp .agents/templates/review-report.md .agent-workspace/active/review-pr-42.md
 4. **Verify** (Claude Code): Ensure no regressions, run tests.
 
 ```bash
-cp .agents/templates/task.md .agent-workspace/active/refactor-001.md
+cp .agents/templates/task.md .agents/workspace/active/refactor-001.md
 # Follow the refactoring workflow in .agents/workflows/refactoring.yaml
 ```
 
@@ -122,7 +122,7 @@ cp .agents/templates/task.md .agent-workspace/active/refactor-001.md
 When switching between AI tools, create a handoff document:
 
 ```bash
-cp .agents/templates/handoff.md .agent-workspace/active/handoff-task-001-phase2.md
+cp .agents/templates/handoff.md .agents/workspace/active/handoff-task-001-phase2.md
 ```
 
 Fill in:

package/templates/.agents/QUICKSTART.zh-CN.md

@@ -13,7 +13,7 @@
 1. 将任务模板复制到活跃工作区：
 
 ```bash
-cp .agents/templates/task.zh-CN.md .agent-workspace/active/task-001.md
+cp .agents/templates/task.zh-CN.md .agents/workspace/active/task-001.md
 ```
 
 2. 填写任务元数据：
@@ -49,7 +49,7 @@ Claude Code 擅长代码库探索和理解文件间的复杂关系。
 gemini
 
 # 示例提示：
-# "基于 .agent-workspace/active/task-001.md 中的分析结果，
+# "基于 .agents/workspace/active/task-001.md 中的分析结果，
 #  创建技术设计方案。定义接口并概述实现思路。"
 ```
 
@@ -60,7 +60,7 @@ gemini
 codex
 
 # 示例提示：
-# "实现 .agent-workspace/active/task-001.md 中描述的变更。
+# "实现 .agents/workspace/active/task-001.md 中描述的变更。
 #  遵循设计部分。为此工作创建新分支。"
 ```
 
@@ -87,7 +87,7 @@ claude
 
 ```bash
 # 快速缺陷修复工作流
-cp .agents/templates/task.zh-CN.md .agent-workspace/active/bugfix-001.md
+cp .agents/templates/task.zh-CN.md .agents/workspace/active/bugfix-001.md
 # 编辑任务，然后：
 # 1. 使用 Claude Code 分析
 # 2. 使用 Codex/Cursor 修复
@@ -101,7 +101,7 @@ cp .agents/templates/task.zh-CN.md .agent-workspace/active/bugfix-001.md
 3. **报告**：从模板生成审查报告。
 
 ```bash
-cp .agents/templates/review-report.zh-CN.md .agent-workspace/active/review-pr-42.md
+cp .agents/templates/review-report.zh-CN.md .agents/workspace/active/review-pr-42.md
 # 使用 Claude Code 填写审查内容
 ```
 
@@ -113,7 +113,7 @@ cp .agents/templates/review-report.zh-CN.md .agent-workspace/active/review-pr-42
 4. **验证**（Claude Code）：确保没有回归问题，运行测试。
 
 ```bash
-cp .agents/templates/task.zh-CN.md .agent-workspace/active/refactor-001.md
+cp .agents/templates/task.zh-CN.md .agents/workspace/active/refactor-001.md
 # 按照 .agents/workflows/refactoring.zh-CN.yaml 中的重构工作流执行
 ```
 
@@ -122,7 +122,7 @@ cp .agents/templates/task.zh-CN.md .agent-workspace/active/refactor-001.md
 在 AI 工具之间切换时，创建交接文档：
 
 ```bash
-cp .agents/templates/handoff.zh-CN.md .agent-workspace/active/handoff-task-001-phase2.md
+cp .agents/templates/handoff.zh-CN.md .agents/workspace/active/handoff-task-001-phase2.md
 ```
 
 填写：

package/templates/.agents/README.md

@@ -37,7 +37,7 @@ This dual-config approach ensures every AI tool receives appropriate project con
     code-review.yaml            # Code review workflow
     refactoring.yaml            # Refactoring workflow
 
-.agent-workspace/               # Runtime workspace (git-ignored)
+.agents/workspace/         # Runtime workspace (git-ignored)
   active/                       # Currently active tasks
   blocked/                      # Blocked tasks
   completed/                    # Completed tasks
@@ -95,11 +95,23 @@ Each AI tool has different strengths. Use them accordingly:
 ## Quick Start
 
 1. **Read the quick start guide**: See `QUICKSTART.md` for step-by-step instructions.
-2. **Create a task**: Copy `.agents/templates/task.md` to `.agent-workspace/active/`.
+2. **Create a task**: Copy `.agents/templates/task.md` to `.agents/workspace/active/`.
 3. **Assign to an AI**: Update the `assigned_to` field in the task metadata.
 4. **Run the workflow**: Follow the appropriate workflow in `.agents/workflows/`.
 5. **Hand off**: When switching AIs, create a handoff document from the template.
 
+## Label Conventions
+
+GitHub Labels in this project use the following prefixes, each with a defined scope:
+
+| Label prefix | Issue | PR | Notes |
+|---|---|---|---|
+| `type:` | — | Yes | Issues use the native GitHub Type field; PRs use `type:` labels for changelog generation and categorization |
+| `status:` | Yes | — | PRs already have their own state flow (Open / Draft / Merged / Closed); Issues use `status:` labels for project tracking states |
+| `in:` | Yes | Yes | Both Issues and PRs can be filtered by module |
+
+Initialize the label set with the `/init-labels` command.
+
 ## Skill Authoring Conventions
 
 When writing or updating `.agents/skills/*/SKILL.md` files and their templates, keep step numbering consistent:
@@ -119,7 +131,7 @@ No. Claude Code reads from `.claude/CLAUDE.md`, and all other tools read from `A
 
 ### Q: How do tasks get passed between AI tools?
 
-Through handoff documents stored in `.agent-workspace/`. Each handoff includes context, progress, and next steps so the receiving AI can continue seamlessly.
+Through handoff documents stored in `.agents/workspace/`. Each handoff includes context, progress, and next steps so the receiving AI can continue seamlessly.
 
 ### Q: What if an AI tool doesn't support AGENTS.md?
 
@@ -131,4 +143,4 @@ It's not recommended. The workflow model is sequential -- one AI per phase. Para
 
 ### Q: Where are runtime files stored?
 
-In `.agent-workspace/`, which is git-ignored. Only templates and workflow definitions in `.agents/` are version-controlled.
+In `.agents/workspace/`, which is git-ignored. Only templates and workflow definitions in `.agents/` are version-controlled.

package/templates/.agents/README.zh-CN.md

@@ -37,7 +37,7 @@
     code-review.yaml            # 代码审查工作流
     refactoring.yaml            # 重构工作流
 
-.agent-workspace/               # 运行时工作区（已被 git ignore）
+.agents/workspace/         # 运行时工作区（已被 git ignore）
   active/                       # 当前活跃任务
   blocked/                      # 被阻塞的任务
   completed/                    # 已完成的任务
@@ -95,11 +95,23 @@
 ## 快速入门
 
 1. **阅读快速入门指南**：参见 `QUICKSTART.zh-CN.md` 获取分步说明。
-2. **创建任务**：将 `.agents/templates/task.zh-CN.md` 复制到 `.agent-workspace/active/`。
+2. **创建任务**：将 `.agents/templates/task.zh-CN.md` 复制到 `.agents/workspace/active/`。
 3. **分配给 AI**：更新任务元数据中的 `assigned_to` 字段。
 4. **执行工作流**：按照 `.agents/workflows/` 中相应的工作流执行。
 5. **交接**：切换 AI 时，从模板创建交接文档。
 
+## Label 规范
+
+本项目的 GitHub Labels 按以下前缀分类，各前缀有明确的适用范围：
+
+| Label 前缀 | Issue | PR | 说明 |
+|---|---|---|---|
+| `type:` | — | Yes | Issue 使用 GitHub 原生 Type 字段；PR 无原生类型字段，通过 `type:` label 驱动 changelog 和分类 |
+| `status:` | Yes | — | PR 有自身状态流转（Open / Draft / Merged / Closed）；Issue 使用 `status:` label 标记等待反馈、已确认等项目管理状态 |
+| `in:` | Yes | Yes | Issue 和 PR 均可按模块筛选 |
+
+初始化 Label 体系：使用 `/init-labels` 命令一次性创建标准 labels。
+
 ## Skill 编写规范
 
 编写或维护 `.agents/skills/*/SKILL.md` 及其模板时，步骤编号遵循以下规则：
@@ -119,7 +131,7 @@
 
 ### Q：任务如何在 AI 工具之间传递？
 
-通过存储在 `.agent-workspace/` 中的交接文档。每份交接文档包含上下文、进度和后续步骤，让接收方 AI 能无缝接续。
+通过存储在 `.agents/workspace/` 中的交接文档。每份交接文档包含上下文、进度和后续步骤，让接收方 AI 能无缝接续。
 
 ### Q：如果某个 AI 工具不支持 AGENTS.md 怎么办？
 
@@ -131,4 +143,4 @@
 
 ### Q：运行时文件存储在哪里？
 
-在 `.agent-workspace/` 中，该目录已被 git ignore。只有 `.agents/` 中的模板和工作流定义受版本控制。
+在 `.agents/workspace/` 中，该目录已被 git ignore。只有 `.agents/` 中的模板和工作流定义受版本控制。