@fitlab-ai/agent-infra 0.6.1 → 0.6.2-alpha.1

package/dist/lib/defaults.json

@@ -5,7 +5,7 @@
   "sandbox": {
     "engine": null,
     "runtimes": [
-      "node20"
+      "node22"
     ],
     "tools": [
       "claude-code",

package/dist/lib/sandbox/config.js

@@ -2,11 +2,13 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { homedir, platform } from 'node:os';
 import { execFileSync } from 'node:child_process';
+import pc from 'picocolors';
 import { validateSandboxEngine } from "./engine.js";
 import { hostJoin } from "./engines/wsl2-paths.js";
+import { findRuntimeEngineMismatches } from "./runtime-engines.js";
 const DEFAULTS = Object.freeze({
     engine: null,
-    runtimes: ['node20'],
+    runtimes: ['node22'],
     tools: ['claude-code', 'codex', 'gemini-cli', 'opencode'],
     dockerfile: null,
     vm: {
@@ -38,7 +40,7 @@ function cloneDefaults() {
         vm: { ...DEFAULTS.vm }
     };
 }
-export function loadConfig({ platformFn = platform } = {}) {
+export function loadConfig({ platformFn = platform, writeStderr = (chunk) => process.stderr.write(chunk) } = {}) {
     const repoRoot = detectRepoRoot();
     const home = homedir();
     if (!home) {
@@ -56,6 +58,24 @@ export function loadConfig({ platformFn = platform } = {}) {
     if (!project || typeof project !== 'string') {
         throw new Error('sandbox: .agents/.airc.json is missing a valid "project" field');
     }
+    const runtimes = Array.isArray(sandbox.runtimes) && sandbox.runtimes.length > 0
+        ? [...sandbox.runtimes]
+        : defaults.runtimes;
+    const dockerfile = typeof sandbox.dockerfile === 'string' ? sandbox.dockerfile : defaults.dockerfile ?? null;
+    if (!dockerfile) {
+        let enginesNode;
+        try {
+            const pkg = JSON.parse(fs.readFileSync(path.join(repoRoot, 'package.json'), 'utf8'));
+            enginesNode = typeof pkg.engines?.node === 'string' ? pkg.engines.node : undefined;
+        }
+        catch {
+            enginesNode = undefined;
+        }
+        for (const { runtimes: invalidRuntimes, enginesNode: range } of findRuntimeEngineMismatches(runtimes, enginesNode)) {
+            writeStderr(pc.yellow(`Warning: sandbox runtimes ${invalidRuntimes.map((runtime) => `"${runtime}"`).join(', ')} do not satisfy this project's package.json "engines.node" ("${range}").\n` +
+                '  Update "sandbox.runtimes" in .agents/.airc.json (e.g. "node22"), or relax "engines.node".\n'));
+        }
+    }
     return {
         repoRoot,
         configPath,
@@ -68,13 +88,11 @@ export function loadConfig({ platformFn = platform } = {}) {
         shareBase: hostJoin(home, '.agent-infra', 'share', project),
         dotfilesDir: hostJoin(home, '.agent-infra', 'dotfiles'),
         engine,
-        runtimes: Array.isArray(sandbox.runtimes) && sandbox.runtimes.length > 0
-            ? [...sandbox.runtimes]
-            : defaults.runtimes,
+        runtimes,
         tools: Array.isArray(sandbox.tools) && sandbox.tools.length > 0
             ? [...sandbox.tools]
             : defaults.tools,
-        dockerfile: typeof sandbox.dockerfile === 'string' ? sandbox.dockerfile : defaults.dockerfile ?? null,
+        dockerfile,
         vm: {
             cpu: asPositiveNumberOrNull(sandbox.vm?.cpu) ?? defaults.vm.cpu,
             memory: asPositiveNumberOrNull(sandbox.vm?.memory) ?? defaults.vm.memory,

package/dist/lib/sandbox/runtime-engines.js

@@ -0,0 +1,27 @@
+import semver from 'semver';
+function nodeMajor(runtime) {
+    const match = /^node(\d+)$/.exec(runtime);
+    return match ? Number(match[1]) : null;
+}
+export function findRuntimeEngineMismatches(runtimes, enginesNode) {
+    if (!enginesNode) {
+        return [];
+    }
+    const range = semver.validRange(enginesNode);
+    if (!range) {
+        return [];
+    }
+    const nodeRuntimes = [];
+    for (const runtime of runtimes) {
+        const major = nodeMajor(runtime);
+        if (major === null) {
+            continue;
+        }
+        nodeRuntimes.push(runtime);
+        if (semver.intersects(`${major}.x`, range)) {
+            return [];
+        }
+    }
+    return nodeRuntimes.length > 0 ? [{ runtimes: nodeRuntimes, enginesNode }] : [];
+}
+//# sourceMappingURL=runtime-engines.js.map

package/dist/package.json

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

package/lib/defaults.json

@@ -5,7 +5,7 @@
   "sandbox": {
     "engine": null,
     "runtimes": [
-      "node20"
+      "node22"
     ],
     "tools": [
       "claude-code",

package/lib/sandbox/config.ts

@@ -2,12 +2,14 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { homedir, platform } from 'node:os';
 import { execFileSync } from 'node:child_process';
+import pc from 'picocolors';
 import { validateSandboxEngine } from './engine.ts';
 import { hostJoin } from './engines/wsl2-paths.ts';
+import { findRuntimeEngineMismatches } from './runtime-engines.ts';
 
 const DEFAULTS = Object.freeze({
   engine: null,
-  runtimes: ['node20'],
+  runtimes: ['node22'],
   tools: ['claude-code', 'codex', 'gemini-cli', 'opencode'],
   dockerfile: null,
   vm: {
@@ -18,6 +20,7 @@ const DEFAULTS = Object.freeze({
 });
 
 type PlatformFn = typeof platform;
+type WriteStderr = (chunk: string) => unknown;
 
 type SandboxConfigInput = {
   engine?: string | null;
@@ -82,7 +85,10 @@ function cloneDefaults(): SandboxConfigInput & { vm: SandboxVmConfig; runtimes:
   };
 }
 
-export function loadConfig({ platformFn = platform }: { platformFn?: PlatformFn } = {}): SandboxConfig {
+export function loadConfig({
+  platformFn = platform,
+  writeStderr = (chunk) => process.stderr.write(chunk)
+}: { platformFn?: PlatformFn; writeStderr?: WriteStderr } = {}): SandboxConfig {
   const repoRoot = detectRepoRoot();
   const home = homedir();
 
@@ -105,6 +111,30 @@ export function loadConfig({ platformFn = platform }: { platformFn?: PlatformFn
     throw new Error('sandbox: .agents/.airc.json is missing a valid "project" field');
   }
 
+  const runtimes = Array.isArray(sandbox.runtimes) && sandbox.runtimes.length > 0
+    ? [...sandbox.runtimes]
+    : defaults.runtimes;
+  const dockerfile = typeof sandbox.dockerfile === 'string' ? sandbox.dockerfile : defaults.dockerfile ?? null;
+
+  if (!dockerfile) {
+    let enginesNode: string | undefined;
+    try {
+      const pkg = JSON.parse(fs.readFileSync(path.join(repoRoot, 'package.json'), 'utf8')) as {
+        engines?: { node?: unknown };
+      };
+      enginesNode = typeof pkg.engines?.node === 'string' ? pkg.engines.node : undefined;
+    } catch {
+      enginesNode = undefined;
+    }
+
+    for (const { runtimes: invalidRuntimes, enginesNode: range } of findRuntimeEngineMismatches(runtimes, enginesNode)) {
+      writeStderr(pc.yellow(
+        `Warning: sandbox runtimes ${invalidRuntimes.map((runtime) => `"${runtime}"`).join(', ')} do not satisfy this project's package.json "engines.node" ("${range}").\n` +
+        '  Update "sandbox.runtimes" in .agents/.airc.json (e.g. "node22"), or relax "engines.node".\n'
+      ));
+    }
+  }
+
   return {
     repoRoot,
     configPath,
@@ -117,13 +147,11 @@ export function loadConfig({ platformFn = platform }: { platformFn?: PlatformFn
     shareBase: hostJoin(home, '.agent-infra', 'share', project),
     dotfilesDir: hostJoin(home, '.agent-infra', 'dotfiles'),
     engine,
-    runtimes: Array.isArray(sandbox.runtimes) && sandbox.runtimes.length > 0
-      ? [...sandbox.runtimes]
-      : defaults.runtimes,
+    runtimes,
     tools: Array.isArray(sandbox.tools) && sandbox.tools.length > 0
       ? [...sandbox.tools]
       : defaults.tools,
-    dockerfile: typeof sandbox.dockerfile === 'string' ? sandbox.dockerfile : defaults.dockerfile ?? null,
+    dockerfile,
     vm: {
       cpu: asPositiveNumberOrNull(sandbox.vm?.cpu) ?? defaults.vm.cpu,
       memory: asPositiveNumberOrNull(sandbox.vm?.memory) ?? defaults.vm.memory,

package/lib/sandbox/runtime-engines.ts

@@ -0,0 +1,39 @@
+import semver from 'semver';
+
+export type RuntimeEngineMismatch = {
+  runtimes: string[];
+  enginesNode: string;
+};
+
+function nodeMajor(runtime: string): number | null {
+  const match = /^node(\d+)$/.exec(runtime);
+  return match ? Number(match[1]) : null;
+}
+
+export function findRuntimeEngineMismatches(
+  runtimes: string[],
+  enginesNode: string | undefined
+): RuntimeEngineMismatch[] {
+  if (!enginesNode) {
+    return [];
+  }
+
+  const range = semver.validRange(enginesNode);
+  if (!range) {
+    return [];
+  }
+
+  const nodeRuntimes: string[] = [];
+  for (const runtime of runtimes) {
+    const major = nodeMajor(runtime);
+    if (major === null) {
+      continue;
+    }
+    nodeRuntimes.push(runtime);
+    if (semver.intersects(`${major}.x`, range)) {
+      return [];
+    }
+  }
+
+  return nodeRuntimes.length > 0 ? [{ runtimes: nodeRuntimes, enginesNode }] : [];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fitlab-ai/agent-infra",
-  "version": "0.6.1",
+  "version": "0.6.2-alpha.1",
   "description": "Bootstrap tool for AI multi-tool collaboration infrastructure — works with Claude Code, Codex, Gemini CLI, and OpenCode",
   "license": "MIT",
   "type": "module",
@@ -46,6 +46,7 @@
     "@clack/prompts": "1.4.0",
     "cross-spawn": "^7.0.6",
     "picocolors": "1.1.1",
+    "semver": "^7.8.1",
     "smol-toml": "^1.6.1"
   },
   "scripts": {
@@ -61,6 +62,7 @@
   "devDependencies": {
     "@types/cross-spawn": "^6.0.6",
     "@types/node": "^25.9.1",
+    "@types/semver": "^7.7.1",
     "typescript": "~6.0"
   }
 }

package/templates/.agents/rules/release-commands.github.en.md

@@ -1,6 +1,6 @@
 # Release Platform Commands
 
-Read this file before loading release history, querying merged PRs, or creating a draft release.
+Read this file before loading release history, querying merged PRs, or publishing the Release notes.
 
 ## Query Releases
 
@@ -37,10 +37,16 @@ gh issue view {issue-number} --json number,title,labels,url,author
 
 Map GitHub no-reply emails with this rule: if `Name <email>` contains an email matching `(\d+\+)?(\S+?)@users\.noreply\.github\.com`, use the second capture group lowercased as the login. This covers both `{id}+{login}@users.noreply.github.com` and `{login}@users.noreply.github.com`.
 
-## Create a Draft Release
+## Publish the Release Notes
+
+The GitHub Release for `v{version}` is created and published automatically by the release workflow so Homebrew bottles have a stable upload target. This command writes the curated notes onto that existing Release, falling back to creating it if it does not exist yet.
 
 ```bash
-gh release create "v{version}" --draft --title "v{version}" --notes-file "{notes-file}"
+if gh release view "v{version}" >/dev/null 2>&1; then
+  gh release edit "v{version}" --notes-file "{notes-file}"
+else
+  gh release create "v{version}" --title "v{version}" --notes-file "{notes-file}"
+fi
 ```
 
 If commands fail, stop or escalate according to the calling skill.

package/templates/.agents/rules/release-commands.github.zh-CN.md

@@ -1,6 +1,6 @@
 # Release 平台命令
 
-在读取历史 release、查询已合并 PR，或创建 draft release 前先读取本文件。
+在读取历史 release、查询已合并 PR，或发布 Release notes 前先读取本文件。
 
 ## Release 查询
 
@@ -37,10 +37,16 @@ gh issue view {issue-number} --json number,title,labels,url,author
 
 GitHub no-reply 邮箱映射规则：如果 `Name <email>` 中的 email 匹配 `(\d+\+)?(\S+?)@users\.noreply\.github\.com`，使用第二个捕获组的小写形式作为 login。该规则同时覆盖 `{id}+{login}@users.noreply.github.com` 和 `{login}@users.noreply.github.com`。
 
-## 创建 Draft Release
+## 发布 Release notes
+
+`v{version}` 的 GitHub Release 由 release 工作流自动创建并发布，为 Homebrew bottle 提供稳定的上传落点。本命令把精修后的 notes 写到这个已存在的 Release 上；若 Release 尚不存在则兜底创建。
 
 ```bash
-gh release create "v{version}" --draft --title "v{version}" --notes-file "{notes-file}"
+if gh release view "v{version}" >/dev/null 2>&1; then
+  gh release edit "v{version}" --notes-file "{notes-file}"
+else
+  gh release create "v{version}" --title "v{version}" --notes-file "{notes-file}"
+fi
 ```
 
 失败时按调用方规则停止或提示人工介入。

package/templates/.agents/skills/create-release-note/SKILL.en.md

@@ -156,31 +156,28 @@ Show the generated release notes to the user.
 
 Ask:
 1. Need any adjustments?
-2. Create a draft release?
+2. Write these notes onto the Release for this version?
 
-### 9. Create Draft Release (If Confirmed)
+### 9. Publish the Release Notes (If Confirmed)
 
-Create the draft release by following `.agents/rules/release-commands.md`.
+Write the notes by following the "Publish the Release Notes" command in `.agents/rules/release-commands.md` (it updates the Release already created and published by the release workflow, falling back to creating it if missing).
 
 Output:
 ```
-Draft Release created.
+Release notes updated.
 
-- URL: {draft-release-url}
+- URL: {release-url}
 - Version: v{version}
-- Status: Draft
+- Status: Published
 
-Please review and publish on the platform:
-1. Open the URL above
-2. Review the release notes
-3. Click "Publish release"
+The notes have been written to the Release. Edit further at the URL above if needed.
 ```
 
 ## Notes
 
 1. **Requires the platform CLI**: Must have the platform CLI installed and authenticated
 2. **Tags must exist**: Run the release skill first to create tags
-3. **Draft mode**: Creates a draft - won't auto-publish
+3. **Release auto-published**: the `v{version}` Release is created and published by the release workflow (the upload target for Homebrew bottles); this skill writes/refreshes the notes on that Release
 4. **Classification accuracy**: Auto-classification is based on title/scope/files; complex PRs may need manual adjustment
 
 ## Error Handling

package/templates/.agents/skills/create-release-note/SKILL.zh-CN.md

@@ -156,31 +156,28 @@ git log v<prev-version>..v<version> \
 
 询问：
 1. 需要调整吗？
-2. 是否创建 draft release？
+2. 是否把 notes 写入该版本的 Release？
 
-### 9. 创建 Draft Release（如确认）
+### 9. 发布 Release notes（如确认）
 
-按 `.agents/rules/release-commands.md` 的 Draft Release 创建命令执行。
+按 `.agents/rules/release-commands.md` 的「发布 Release notes」命令执行（写入已由 release 工作流自动创建/发布的 Release；不存在时兜底创建）。
 
 输出：
 ```
-Draft Release created.
+Release notes 已更新。
 
-- URL: {draft-release-url}
+- URL: {release-url}
 - Version: v{version}
-- Status: Draft
+- Status: Published
 
-Please review and publish on the platform:
-1. Open the URL above
-2. Review the release notes
-3. Click "Publish release"
+发布说明已写入该 Release。如需进一步调整，可在上面的 URL 直接编辑。
 ```
 
 ## 注意事项
 
 1. **需要 the platform CLI**：必须安装并认证 the platform CLI
 2. **标签必须存在**：先执行 release 技能创建标签
-3. **草稿模式**：创建草稿 —— 不会自动发布
+3. **Release 已自动发布**：`v{version}` 的 Release 由 release 工作流自动创建并发布（给 Homebrew bottle 提供上传落点）；本技能往该 Release 写入/刷新 notes
 4. **分类准确性**：自动分类基于标题/scope/文件；复杂的 PR 可能需要手动调整
 
 ## 错误处理

package/templates/.agents/skills/update-agent-infra/scripts/sync-templates.js

@@ -26,7 +26,7 @@ const DEFAULTS = {
   "sandbox": {
     "engine": null,
     "runtimes": [
-      "node20"
+      "node22"
     ],
     "tools": [
       "claude-code",