@fitlab-ai/agent-infra 0.6.0 → 0.6.1

package/README.md

@@ -666,15 +666,15 @@ Use the top-level `.agents/.airc.json` `customTUIs` array when your team uses an
 
 | Field | Required | Meaning |
 |-------|----------|---------|
-| `name` | Yes | Display name shown in reports and next-step guidance, for example `Acme TUI`. |
-| `dir` | Yes | Command directory relative to the project root, for example `.acme/commands`. The path must stay inside the project root. |
+| `name` | Yes | Display name shown in reports and next-step guidance, for example `<your-tui-name>`. |
+| `dir` | Yes | Command directory relative to the project root, for example `.<your-tui>/commands`. The path must stay inside the project root. |
 | `invoke` | Yes | User-facing command template used in next-step guidance. |
 
 Supported `invoke` placeholders:
 
 | Placeholder | Replaced with | Example |
 |-------------|---------------|---------|
-| `${skillName}` | The skill command name, such as `review-task` or `commit`. | `acme ${skillName}` -> `acme review-task` |
+| `${skillName}` | The skill command name, such as `review-task` or `commit`. | `<your-cli> ${skillName}` -> `<your-cli> review-task` |
 | `${projectName}` | The `.airc.json` `project` value. Use this for namespaced commands. | `/${projectName}:${skillName}` -> `/agent-infra:review-task` |
 
 Non-namespaced custom TUI:
@@ -683,9 +683,9 @@ Non-namespaced custom TUI:
 {
   "customTUIs": [
     {
-      "name": "Acme TUI",
-      "dir": ".acme/commands",
-      "invoke": "acme ${skillName}"
+      "name": "<your-tui-name>",
+      "dir": ".<your-tui>/commands",
+      "invoke": "<your-cli> ${skillName}"
     }
   ]
 }
@@ -698,8 +698,8 @@ Namespaced custom TUI:
   "project": "agent-infra",
   "customTUIs": [
     {
-      "name": "Internal Gemini",
-      "dir": ".internal-gemini/commands",
+      "name": "<your-tui-name>",
+      "dir": ".<your-tui>/commands",
       "invoke": "/${projectName}:${skillName}"
     }
   ]
@@ -777,7 +777,7 @@ The generated `.agents/.airc.json` file is the central contract between the boot
   "project": "my-project",
   "org": "my-org",
   "language": "en",
-  "templateVersion": "v0.6.0",
+  "templateVersion": "v0.6.1",
   "templates": {
     "sources": [
       { "type": "local", "path": "~/private-templates" }
@@ -790,9 +790,9 @@ The generated `.agents/.airc.json` file is the central contract between the boot
   },
   "customTUIs": [
     {
-      "name": "Acme TUI",
-      "dir": ".acme/commands",
-      "invoke": "acme ${skillName}"
+      "name": "<your-tui-name>",
+      "dir": ".<your-tui>/commands",
+      "invoke": "<your-cli> ${skillName}"
     }
   ],
   "files": {

package/README.zh-CN.md

@@ -642,15 +642,15 @@ args: "<task-id>"   # 可选
 
 | 字段 | 必填 | 含义 |
 |------|------|------|
-| `name` | 是 | 报告和下一步提示中展示的工具名称，例如 `Acme TUI`。 |
-| `dir` | 是 | 相对项目根目录的命令目录，例如 `.acme/commands`。路径必须位于项目根目录内。 |
+| `name` | 是 | 报告和下一步提示中展示的工具名称，例如 `<your-tui-name>`。 |
+| `dir` | 是 | 相对项目根目录的命令目录，例如 `.<your-tui>/commands`。路径必须位于项目根目录内。 |
 | `invoke` | 是 | 面向用户展示的命令模板，用于生成下一步提示。 |
 
 `invoke` 支持的占位符：
 
 | 占位符 | 替换为 | 示例 |
 |--------|--------|------|
-| `${skillName}` | skill 命令名，例如 `review-task` 或 `commit`。 | `acme ${skillName}` -> `acme review-task` |
+| `${skillName}` | skill 命令名，例如 `review-task` 或 `commit`。 | `<your-cli> ${skillName}` -> `<your-cli> review-task` |
 | `${projectName}` | `.airc.json` 中的 `project` 值，适用于带命名空间的命令。 | `/${projectName}:${skillName}` -> `/agent-infra:review-task` |
 
 不带命名空间的自定义 TUI：
@@ -659,9 +659,9 @@ args: "<task-id>"   # 可选
 {
   "customTUIs": [
     {
-      "name": "Acme TUI",
-      "dir": ".acme/commands",
-      "invoke": "acme ${skillName}"
+      "name": "<your-tui-name>",
+      "dir": ".<your-tui>/commands",
+      "invoke": "<your-cli> ${skillName}"
     }
   ]
 }
@@ -674,8 +674,8 @@ args: "<task-id>"   # 可选
   "project": "agent-infra",
   "customTUIs": [
     {
-      "name": "Internal Gemini",
-      "dir": ".internal-gemini/commands",
+      "name": "<your-tui-name>",
+      "dir": ".<your-tui>/commands",
       "invoke": "/${projectName}:${skillName}"
     }
   ]
@@ -753,7 +753,7 @@ import-issue #42                    从 GitHub Issue 导入任务
   "project": "my-project",
   "org": "my-org",
   "language": "en",
-  "templateVersion": "v0.6.0",
+  "templateVersion": "v0.6.1",
   "templates": {
     "sources": [
       { "type": "local", "path": "~/private-templates" }
@@ -766,9 +766,9 @@ import-issue #42                    从 GitHub Issue 导入任务
   },
   "customTUIs": [
     {
-      "name": "Acme TUI",
-      "dir": ".acme/commands",
-      "invoke": "acme ${skillName}"
+      "name": "<your-tui-name>",
+      "dir": ".<your-tui>/commands",
+      "invoke": "<your-cli> ${skillName}"
     }
   ],
   "files": {

package/bin/cli.ts

@@ -97,7 +97,11 @@ switch (command) {
     break;
   }
   case 'version': {
-    console.log(`agent-infra ${VERSION}`);
+    if (process.argv[3] === '--raw') {
+      console.log(VERSION);
+    } else {
+      console.log(`agent-infra ${VERSION}`);
+    }
     break;
   }
   case 'help':

package/dist/bin/cli.js

@@ -100,7 +100,12 @@ switch (command) {
         break;
     }
     case 'version': {
-        console.log(`agent-infra ${VERSION}`);
+        if (process.argv[3] === '--raw') {
+            console.log(VERSION);
+        }
+        else {
+            console.log(`agent-infra ${VERSION}`);
+        }
         break;
     }
     case 'help':

package/dist/lib/defaults.json

@@ -10,8 +10,8 @@
     "tools": [
       "claude-code",
       "codex",
-      "opencode",
-      "gemini-cli"
+      "gemini-cli",
+      "opencode"
     ],
     "dockerfile": null,
     "vm": {
@@ -27,6 +27,7 @@
     "managed": [
       ".agents/QUICKSTART.md",
       ".agents/README.md",
+      ".agents/hooks/",
       ".agents/rules/",
       ".agents/scripts/",
       ".agents/skills/",
@@ -34,7 +35,7 @@
       ".agents/workflows/",
       ".agents/workspace/README.md",
       ".claude/commands/",
-      ".claude/hooks/",
+      ".codex/hooks.json",
       ".gemini/commands/",
       ".git-hooks/check-version-format.sh",
       ".github/scripts/",

package/dist/lib/sandbox/config.js

@@ -7,7 +7,7 @@ import { hostJoin } from "./engines/wsl2-paths.js";
 const DEFAULTS = Object.freeze({
     engine: null,
     runtimes: ['node20'],
-    tools: ['claude-code', 'codex', 'opencode', 'gemini-cli'],
+    tools: ['claude-code', 'codex', 'gemini-cli', 'opencode'],
     dockerfile: null,
     vm: {
         cpu: null,

package/dist/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@fitlab-ai/agent-infra",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "type": "module"
 }

package/lib/defaults.json

@@ -10,8 +10,8 @@
     "tools": [
       "claude-code",
       "codex",
-      "opencode",
-      "gemini-cli"
+      "gemini-cli",
+      "opencode"
     ],
     "dockerfile": null,
     "vm": {
@@ -27,6 +27,7 @@
     "managed": [
       ".agents/QUICKSTART.md",
       ".agents/README.md",
+      ".agents/hooks/",
       ".agents/rules/",
       ".agents/scripts/",
       ".agents/skills/",
@@ -34,7 +35,7 @@
       ".agents/workflows/",
       ".agents/workspace/README.md",
       ".claude/commands/",
-      ".claude/hooks/",
+      ".codex/hooks.json",
       ".gemini/commands/",
       ".git-hooks/check-version-format.sh",
       ".github/scripts/",

package/lib/sandbox/config.ts

@@ -8,7 +8,7 @@ import { hostJoin } from './engines/wsl2-paths.ts';
 const DEFAULTS = Object.freeze({
   engine: null,
   runtimes: ['node20'],
-  tools: ['claude-code', 'codex', 'opencode', 'gemini-cli'],
+  tools: ['claude-code', 'codex', 'gemini-cli', 'opencode'],
   dockerfile: null,
   vm: {
     cpu: null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fitlab-ai/agent-infra",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Bootstrap tool for AI multi-tool collaboration infrastructure — works with Claude Code, Codex, Gemini CLI, and OpenCode",
   "license": "MIT",
   "type": "module",
@@ -60,7 +60,7 @@
   },
   "devDependencies": {
     "@types/cross-spawn": "^6.0.6",
-    "@types/node": "^22.19.19",
-    "typescript": "~5.9"
+    "@types/node": "^25.9.1",
+    "typescript": "~6.0"
   }
 }

package/templates/.agents/README.en.md

@@ -199,15 +199,15 @@ Use the top-level `.agents/.airc.json` `customTUIs` array when your team uses an
 
 | Field | Required | Meaning |
 |-------|----------|---------|
-| `name` | Yes | Display name shown in reports and next-step guidance, for example `Acme TUI`. |
-| `dir` | Yes | Command directory relative to the project root, for example `.acme/commands`. The path must stay inside the project root. |
+| `name` | Yes | Display name shown in reports and next-step guidance, for example `<your-tui-name>`. |
+| `dir` | Yes | Command directory relative to the project root, for example `.<your-tui>/commands`. The path must stay inside the project root. |
 | `invoke` | Yes | User-facing command template used in next-step guidance. |
 
 Supported `invoke` placeholders:
 
 | Placeholder | Replaced with | Example |
 |-------------|---------------|---------|
-| `${skillName}` | The skill command name, such as `review-task` or `commit`. | `acme ${skillName}` -> `acme review-task` |
+| `${skillName}` | The skill command name, such as `review-task` or `commit`. | `<your-cli> ${skillName}` -> `<your-cli> review-task` |
 | `${projectName}` | The `.airc.json` `project` value. Use this for namespaced commands. | `/${projectName}:${skillName}` -> `/agent-infra:review-task` |
 
 Non-namespaced custom TUI:
@@ -216,9 +216,9 @@ Non-namespaced custom TUI:
 {
   "customTUIs": [
     {
-      "name": "Acme TUI",
-      "dir": ".acme/commands",
-      "invoke": "acme ${skillName}"
+      "name": "<your-tui-name>",
+      "dir": ".<your-tui>/commands",
+      "invoke": "<your-cli> ${skillName}"
     }
   ]
 }
@@ -231,8 +231,8 @@ Namespaced custom TUI:
   "project": "agent-infra",
   "customTUIs": [
     {
-      "name": "Internal Gemini",
-      "dir": ".internal-gemini/commands",
+      "name": "<your-tui-name>",
+      "dir": ".<your-tui>/commands",
       "invoke": "/${projectName}:${skillName}"
     }
   ]

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

@@ -199,15 +199,15 @@ args: "<task-id>"   # 可选
 
 | 字段 | 必填 | 含义 |
 |------|------|------|
-| `name` | 是 | 报告和下一步提示中展示的工具名称，例如 `Acme TUI`。 |
-| `dir` | 是 | 相对项目根目录的命令目录，例如 `.acme/commands`。路径必须位于项目根目录内。 |
+| `name` | 是 | 报告和下一步提示中展示的工具名称，例如 `<your-tui-name>`。 |
+| `dir` | 是 | 相对项目根目录的命令目录，例如 `.<your-tui>/commands`。路径必须位于项目根目录内。 |
 | `invoke` | 是 | 面向用户展示的命令模板，用于生成下一步提示。 |
 
 `invoke` 支持的占位符：
 
 | 占位符 | 替换为 | 示例 |
 |--------|--------|------|
-| `${skillName}` | skill 命令名，例如 `review-task` 或 `commit`。 | `acme ${skillName}` -> `acme review-task` |
+| `${skillName}` | skill 命令名，例如 `review-task` 或 `commit`。 | `<your-cli> ${skillName}` -> `<your-cli> review-task` |
 | `${projectName}` | `.airc.json` 中的 `project` 值，适用于带命名空间的命令。 | `/${projectName}:${skillName}` -> `/agent-infra:review-task` |
 
 不带命名空间的自定义 TUI：
@@ -216,9 +216,9 @@ args: "<task-id>"   # 可选
 {
   "customTUIs": [
     {
-      "name": "Acme TUI",
-      "dir": ".acme/commands",
-      "invoke": "acme ${skillName}"
+      "name": "<your-tui-name>",
+      "dir": ".<your-tui>/commands",
+      "invoke": "<your-cli> ${skillName}"
     }
   ]
 }
@@ -231,8 +231,8 @@ args: "<task-id>"   # 可选
   "project": "agent-infra",
   "customTUIs": [
     {
-      "name": "Internal Gemini",
-      "dir": ".internal-gemini/commands",
+      "name": "<your-tui-name>",
+      "dir": ".<your-tui>/commands",
       "invoke": "/${projectName}:${skillName}"
     }
   ]

package/templates/{.claude → .agents}/hooks/check-version-format.sh

@@ -10,7 +10,7 @@ hook_command=$(
       try {
         const payload = JSON.parse(Buffer.concat(chunks).toString());
         process.stdout.write(payload.tool_input && payload.tool_input.command || "");
-      } catch (error) {
+      } catch {
         process.stdout.write("");
       }
     });
@@ -30,14 +30,14 @@ repo_root=$(
 )
 
 if sh "$repo_root/.git-hooks/check-version-format.sh"; then
-  echo "Claude hook: version check passed."
+  echo "AI hook: version check passed."
   exit 0
 else
   status=$?
 fi
 
 if [ "$status" -eq 1 ]; then
-  echo "Claude hook: blocking git commit (version format error)."
+  echo "AI hook: blocking git commit (version format error)." >&2
   exit 2
 fi
 

package/templates/.agents/rules/create-issue.github.en.md

@@ -149,6 +149,12 @@ gh api "repos/$upstream_repo/issues/{issue-number}" -X PATCH \
 
 Failure is non-blocking.
 
+### 6.5 Set Issue Fields (Optional)
+
+If `has_push=true`, read `.agents/rules/issue-fields.md` and follow Flow A to write any applicable non-empty `priority`, `effort`, `start_date`, and `target_date` values from `task.md`.
+
+Field write failures are non-blocking.
+
 ### 7. Write Back task.md
 
 Update task.md:

package/templates/.agents/rules/create-issue.github.zh-CN.md

@@ -149,6 +149,12 @@ gh api "repos/$upstream_repo/issues/{issue-number}" -X PATCH \
 
 设置失败不阻断流程。
 
+### 6.5 设置 Issue 字段（可选）
+
+如果 `has_push=true`，读取 `.agents/rules/issue-fields.md`，按流程 A 写入 `task.md` 中适用且非空的 `priority`、`effort`、`start_date` 和 `target_date`。
+
+字段写入失败不阻断流程。
+
 ### 7. 回写 task.md
 
 更新 task.md：

package/templates/.agents/rules/issue-fields.github.en.md

@@ -0,0 +1,155 @@
+# Issue Fields
+
+Read this file before writing or verifying Issue Type pinned custom fields.
+
+## Boundary
+
+- Use this rule only after `upstream_repo`, `has_push`, and the Issue number are known.
+- If `has_push=false`, skip direct field writes and continue.
+- Fetch the organization's current Issue Type schema before each write; do not hard-code the field set.
+- Missing, empty, or unresolvable values are skipped. Field writes are best-effort and must not block the workflow.
+
+## Supported Task Frontmatter
+
+All fields are optional:
+
+| task.md field | Issue field | Value format |
+|---|---|---|
+| `priority` | `Priority` | `Urgent`, `High`, `Medium`, or `Low` |
+| `effort` | `Effort` | `High`, `Medium`, or `Low` |
+| `start_date` | `Start date` | `YYYY-MM-DD` |
+| `target_date` | `Target date` | `YYYY-MM-DD` |
+
+Localized option input may be normalized before writing:
+
+| Input | Stored option |
+|---|---|
+| `紧急` | `Urgent` |
+| `高` | `High` |
+| `中` | `Medium` |
+| `低` | `Low` |
+
+AI agents may infer `priority` and `effort` from the title and description when creating or refining tasks, but must keep date fields empty unless the user or source Issue provides explicit dates. Human edits in `task.md` take precedence.
+
+## GraphQL Reference
+
+Read Issue Type pinned fields:
+
+```graphql
+query($owner:String!){
+  organization(login:$owner){ issueTypes(first:20){ nodes{
+    id name
+    pinnedFields{
+      __typename
+      ... on IssueFieldSingleSelect{ id name options{ id name } }
+      ... on IssueFieldDate{ id name }
+      ... on IssueFieldText{ id name }
+      ... on IssueFieldNumber{ id name }
+    }
+  } } }
+}
+```
+
+Read one Issue's current type and field values:
+
+```graphql
+query($owner:String!,$name:String!,$number:Int!){
+  repository(owner:$owner,name:$name){ issue(number:$number){
+    id
+    issueType{ name pinnedFields{
+      __typename
+      ... on IssueFieldSingleSelect{ id name options{ id name } }
+      ... on IssueFieldDate{ id name }
+      ... on IssueFieldText{ id name }
+      ... on IssueFieldNumber{ id name }
+    } }
+    issueFieldValues(first:50){ nodes{
+      __typename
+      ... on IssueFieldSingleSelectValue{ name optionId field{ ... on IssueFieldSingleSelect{ name } } }
+      ... on IssueFieldDateValue{ value field{ ... on IssueFieldDate{ name } } }
+      ... on IssueFieldTextValue{ value field{ ... on IssueFieldText{ name } } }
+      ... on IssueFieldNumberValue{ value field{ ... on IssueFieldNumber{ name } } }
+    } }
+  } }
+}
+```
+
+Write or clear fields and update Issue Type:
+
+```graphql
+mutation($issueId:ID!,$issueFields:[IssueFieldCreateOrUpdateInput!]!){
+  setIssueFieldValue(input:{issueId:$issueId,issueFields:$issueFields}){ issue{ id } }
+}
+
+mutation($issueId:ID!,$issueTypeId:ID){
+  updateIssueIssueType(input:{issueId:$issueId,issueTypeId:$issueTypeId}){ issue{ id } }
+}
+```
+
+`IssueFieldCreateOrUpdateInput` supports `fieldId`, `singleSelectOptionId`, `dateValue`, `textValue`, `numberValue`, and `delete`.
+
+Minimal command shells:
+
+```bash
+gh api graphql \
+  -f query='query($owner:String!){organization(login:$owner){issueTypes(first:20){nodes{id name pinnedFields{__typename ... on IssueFieldSingleSelect{id name options{id name}} ... on IssueFieldDate{id name} ... on IssueFieldText{id name} ... on IssueFieldNumber{id name}}}}}}' \
+  -F owner="{owner}"
+
+gh api graphql \
+  -f query='query($owner:String!,$name:String!,$number:Int!){repository(owner:$owner,name:$name){issue(number:$number){id issueType{name pinnedFields{__typename ... on IssueFieldSingleSelect{id name options{id name}} ... on IssueFieldDate{id name} ... on IssueFieldText{id name} ... on IssueFieldNumber{id name}}} issueFieldValues(first:50){nodes{__typename ... on IssueFieldSingleSelectValue{name optionId field{... on IssueFieldSingleSelect{name}}} ... on IssueFieldDateValue{value field{... on IssueFieldDate{name}}} ... on IssueFieldTextValue{value field{... on IssueFieldText{name}}} ... on IssueFieldNumberValue{value field{... on IssueFieldNumber{name}}}}}}}}' \
+  -F owner="{owner}" -F name="{repo}" -F number="{issue-number}"
+
+gh api graphql --input - <<'JSON'
+{
+  "query": "mutation($issueId:ID!,$issueFields:[IssueFieldCreateOrUpdateInput!]!){setIssueFieldValue(input:{issueId:$issueId,issueFields:$issueFields}){issue{id}}}",
+  "variables": {
+    "issueId": "{issue-id}",
+    "issueFields": [
+      { "fieldId": "{field-id}", "singleSelectOptionId": "{option-id}" },
+      { "fieldId": "{date-field-id}", "dateValue": "YYYY-MM-DD" },
+      { "fieldId": "{old-field-id}", "delete": true }
+    ]
+  }
+}
+JSON
+
+gh api graphql --input - <<'JSON'
+{
+  "query": "mutation($issueId:ID!,$issueTypeId:ID){updateIssueIssueType(input:{issueId:$issueId,issueTypeId:$issueTypeId}){issue{id}}}",
+  "variables": {
+    "issueId": "{issue-id}",
+    "issueTypeId": "{issue-type-id}"
+  }
+}
+JSON
+```
+
+Values not listed in the localization table are treated as literal option names, which is intended for canonical English input.
+
+## Flow A: Write Fields After Issue Creation
+
+1. Stop if `has_push` is not `true`.
+2. Resolve `{owner}` from `$upstream_repo` and query `organization.issueTypes`.
+3. Select the target Issue Type's `pinnedFields`.
+4. Read non-empty `priority`, `effort`, `start_date`, and `target_date` values from `task.md`.
+5. For each value:
+   - Skip it when the target type does not pin a same-name field.
+   - For single-select fields, normalize localized input and match the option by name.
+   - For date fields, write only `YYYY-MM-DD` values.
+6. Submit one `setIssueFieldValue` mutation with all resolved inputs. If no input remains, skip.
+
+## Flow B: Set Type And Migrate Fields
+
+Use this flow whenever an existing Issue Type is changed.
+
+1. Stop if `has_push` is not `true`.
+2. Read the Issue id, current Issue Type, pinned fields, and current field values.
+3. Query the organization Issue Type list and resolve the target Issue Type id.
+4. Run `updateIssueIssueType` with the target Issue Type id.
+5. Resolve the target type's pinned fields.
+6. For each old field value:
+   - If the target type has a same-name field, write the value again. For single-select values, resolve the target option id by option name.
+   - If the target type does not have a same-name field, send `{ fieldId, delete: true }` for the old field.
+7. Submit one `setIssueFieldValue` mutation with all migration inputs. Empty migrations are skipped.
+
+Both flows are idempotent. Rewriting an unchanged value or deleting an already empty field is acceptable.