@fitlab-ai/agent-infra 0.8.5 → 0.9.1

package/templates/.git-hooks/check-large-files.cjs

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+
+const fs = require("node:fs");
+const path = require("node:path");
+const { spawnSync } = require("node:child_process");
+
+const MAX_BLOB_BYTES = 1024 * 1024;
+const ALLOWLIST_FILE = ".git-large-file-allowlist";
+
+function runGit(args, options = {}) {
+  const result = spawnSync("git", args, {
+    encoding: "utf8",
+    maxBuffer: 16 * 1024 * 1024,
+    ...options
+  });
+
+  if (result.status !== 0) {
+    process.stderr.write(result.stderr || `git ${args[0]} failed.\n`);
+    process.exit(result.status || 1);
+  }
+
+  return result.stdout;
+}
+
+function readAllowlist(repositoryRoot) {
+  const allowlistPath = path.join(repositoryRoot, ALLOWLIST_FILE);
+  if (!fs.existsSync(allowlistPath)) {
+    return new Set();
+  }
+
+  return new Set(
+    fs.readFileSync(allowlistPath, "utf8")
+      .split(/\r?\n/)
+      .map((line) => line.trim())
+      .filter((line) => line.length > 0 && !line.startsWith("#"))
+  );
+}
+
+function stagedBlob(repositoryRoot, relativePath) {
+  const entry = runGit(["ls-files", "--stage", "-z", "--", relativePath], {
+    cwd: repositoryRoot
+  }).split("\0").find(Boolean);
+
+  if (!entry) {
+    return null;
+  }
+
+  const tabIndex = entry.indexOf("\t");
+  const [mode, objectId, stage] = entry.slice(0, tabIndex).split(" ");
+  if (stage !== "0" || mode === "160000") {
+    return null;
+  }
+
+  const size = Number(runGit(["cat-file", "-s", objectId], { cwd: repositoryRoot }).trim());
+  return Number.isFinite(size) ? { objectId, size } : null;
+}
+
+function formatBytes(bytes) {
+  return `${(bytes / (1024 * 1024)).toFixed(2)} MiB`;
+}
+
+const repositoryRoot = runGit(["rev-parse", "--show-toplevel"]).trim();
+const allowlist = readAllowlist(repositoryRoot);
+const stagedPaths = runGit(
+  ["diff", "--cached", "--name-only", "--diff-filter=ACMR", "-z"],
+  { cwd: repositoryRoot }
+).split("\0").filter(Boolean);
+
+const oversized = [];
+for (const relativePath of stagedPaths) {
+  if (allowlist.has(relativePath)) {
+    continue;
+  }
+
+  const blob = stagedBlob(repositoryRoot, relativePath);
+  if (blob && blob.size > MAX_BLOB_BYTES) {
+    oversized.push({ relativePath, size: blob.size });
+  }
+}
+
+if (oversized.length > 0) {
+  process.stderr.write(`Large-file check failed: staged Git blobs must not exceed 1 MiB.\n`);
+  for (const { relativePath, size } of oversized) {
+    process.stderr.write(`  - ${relativePath} (${formatBytes(size)})\n`);
+  }
+  process.stderr.write(
+    `Use Git LFS so Git stores a small pointer, or add an exact repository-relative path to ${ALLOWLIST_FILE}.\n`
+  );
+  process.exit(1);
+}
+
+process.stdout.write("Large-file check passed.\n");

package/templates/.git-hooks/check-version-format.sh

@@ -21,7 +21,11 @@ template_version=$(
   exit 1
 }
 
-if ! printf '%s\n' "$template_version" | grep -Eq '^v[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9.]+)?$'; then
+if ! node -e '
+  const version = process.argv[1];
+  const semver = /^v(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?:-(?:(?:0|[1-9]\d*)|\d*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:(?:0|[1-9]\d*)|\d*[A-Za-z-][0-9A-Za-z-]*))*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
+  process.exit(semver.test(version) ? 0 : 1);
+' "$template_version"; then
   echo "Error: .agents/.airc.json templateVersion must use v-prefixed semver (found: $template_version)."
   exit 1
 fi

package/templates/.git-hooks/pre-commit

@@ -6,3 +6,4 @@ script_dir=$(
 )
 
 "$script_dir/check-version-format.sh"
+node "$script_dir/check-large-files.cjs"

package/templates/.opencode/commands/analyze-task.en.md

@@ -4,7 +4,7 @@ agent: general
 subtask: false
 ---
 
-Analyze task $1.
+Analyze task $ARGUMENTS.
 
 Read and execute the analyze-task skill from `.agents/skills/analyze-task/SKILL.md`.
 

package/templates/.opencode/commands/analyze-task.zh-CN.md

@@ -4,7 +4,7 @@ agent: general
 subtask: false
 ---
 
-分析任务 $1。
+分析任务 $ARGUMENTS。
 
 读取并执行 `.agents/skills/analyze-task/SKILL.md` 中的 analyze-task 技能。
 

package/templates/.opencode/commands/check-task.en.md

@@ -4,7 +4,7 @@ agent: general
 subtask: false
 ---
 
-Check status of task $1.
+Check status of task $ARGUMENTS.
 
 Read and execute the check-task skill from `.agents/skills/check-task/SKILL.md`.
 

package/templates/.opencode/commands/check-task.zh-CN.md

@@ -4,7 +4,7 @@ agent: general
 subtask: false
 ---
 
-查看任务 $1 的状态。
+查看任务 $ARGUMENTS 的状态。
 
 读取并执行 `.agents/skills/check-task/SKILL.md` 中的 check-task 技能。
 

package/templates/.opencode/commands/code-task.en.md

@@ -4,7 +4,7 @@ agent: general
 subtask: false
 ---
 
-Code task $1.
+Code task $ARGUMENTS.
 
 Read and execute the code-task skill from `.agents/skills/code-task/SKILL.md`.
 

package/templates/.opencode/commands/code-task.zh-CN.md

@@ -4,7 +4,7 @@ agent: general
 subtask: false
 ---
 
-编码任务 $1。
+编码任务 $ARGUMENTS。
 
 读取并执行 `.agents/skills/code-task/SKILL.md` 中的 code-task 技能。
 

package/templates/.opencode/commands/commit.en.md

@@ -4,6 +4,8 @@ agent: general
 subtask: false
 ---
 
+Commit scope: $ARGUMENTS
+
 Read and execute the commit skill from `.agents/skills/commit/SKILL.md`.
 
 Follow all steps defined in the skill exactly.

package/templates/.opencode/commands/commit.zh-CN.md

@@ -4,6 +4,8 @@ agent: general
 subtask: false
 ---
 
+提交 scope：$ARGUMENTS
+
 读取并执行 `.agents/skills/commit/SKILL.md` 中的 commit 技能。
 
 严格按照技能中定义的所有步骤执行。

package/templates/.opencode/commands/complete-task.en.md

@@ -4,7 +4,7 @@ agent: general
 subtask: false
 ---
 
-Complete task $1.
+Complete task $ARGUMENTS.
 
 Read and execute the complete-task skill from `.agents/skills/complete-task/SKILL.md`.
 

package/templates/.opencode/commands/complete-task.zh-CN.md

@@ -4,7 +4,7 @@ agent: general
 subtask: false
 ---
 
-完成任务 $1。
+完成任务 $ARGUMENTS。
 
 读取并执行 `.agents/skills/complete-task/SKILL.md` 中的 complete-task 技能。
 

package/templates/.opencode/commands/plan-task.en.md

@@ -4,7 +4,7 @@ agent: general
 subtask: false
 ---
 
-Design plan for task $1.
+Design plan for task $ARGUMENTS.
 
 Read and execute the plan-task skill from `.agents/skills/plan-task/SKILL.md`.
 

package/templates/.opencode/commands/plan-task.zh-CN.md

@@ -4,7 +4,7 @@ agent: general
 subtask: false
 ---
 
-为任务 $1 设计方案。
+为任务 $ARGUMENTS 设计方案。
 
 读取并执行 `.agents/skills/plan-task/SKILL.md` 中的 plan-task 技能。
 

package/templates/.opencode/commands/review-analysis.en.md

@@ -4,7 +4,7 @@ agent: general
 subtask: false
 ---
 
-Review analysis for task $1.
+Review analysis for task $ARGUMENTS.
 
 Read and execute the review-analysis skill from `.agents/skills/review-analysis/SKILL.md`.
 

package/templates/.opencode/commands/review-analysis.zh-CN.md

@@ -4,7 +4,7 @@ agent: general
 subtask: false
 ---
 
-审查任务 $1 的需求分析。
+审查任务 $ARGUMENTS 的需求分析。
 
 读取并执行 `.agents/skills/review-analysis/SKILL.md` 中的 review-analysis 技能。
 

package/templates/.opencode/commands/review-code.en.md

@@ -4,7 +4,7 @@ agent: general
 subtask: false
 ---
 
-Review code for task $1.
+Review code for task $ARGUMENTS.
 
 Read and execute the review-code skill from `.agents/skills/review-code/SKILL.md`.
 

package/templates/.opencode/commands/review-code.zh-CN.md

@@ -4,7 +4,7 @@ agent: general
 subtask: false
 ---
 
-审查任务 $1 的代码。
+审查任务 $ARGUMENTS 的代码。
 
 读取并执行 `.agents/skills/review-code/SKILL.md` 中的 review-code 技能。
 

package/templates/.opencode/commands/review-plan.en.md

@@ -4,7 +4,7 @@ agent: general
 subtask: false
 ---
 
-Review plan for task $1.
+Review plan for task $ARGUMENTS.
 
 Read and execute the review-plan skill from `.agents/skills/review-plan/SKILL.md`.
 

package/templates/.opencode/commands/review-plan.zh-CN.md

@@ -4,7 +4,7 @@ agent: general
 subtask: false
 ---
 
-审查任务 $1 的技术方案。
+审查任务 $ARGUMENTS 的技术方案。
 
 读取并执行 `.agents/skills/review-plan/SKILL.md` 中的 review-plan 技能。
 

package/templates/.agents/scripts/platform-adapters/platform-sync.github.js

@@ -1,40 +0,0 @@
-import { pathToFileURL } from "node:url";
-
-import {
-  formatAgentInfraPackageError,
-  resolveAgentInfraPackage
-} from "../lib/agent-infra-package.js";
-
-const CHECK_TYPE = "platform-sync";
-const packageResolution = resolveAgentInfraPackage();
-let runtime = null;
-let loadError = null;
-
-if (packageResolution.runtimePath) {
-  try {
-    runtime = await import(pathToFileURL(packageResolution.runtimePath).href);
-  } catch (error) {
-    loadError = error;
-  }
-}
-
-function resolutionError() {
-  if (loadError) {
-    return [
-      formatAgentInfraPackageError(packageResolution),
-      `The package runtime could not be loaded: ${loadError instanceof Error ? loadError.message : String(loadError)}`
-    ].join("\n");
-  }
-  return formatAgentInfraPackageError(packageResolution);
-}
-
-export function getDefaults() {
-  return runtime?.getDefaults?.() || { statusLabels: {}, markers: {} };
-}
-
-export function check(context, shared) {
-  if (!runtime?.check) {
-    return shared.blockedResult(CHECK_TYPE, resolutionError(), "dependency_error");
-  }
-  return runtime.check(context, shared);
-}

package/templates/.agents/scripts/platform-adapters/platform-sync.js

@@ -1,13 +0,0 @@
-export function getDefaults() {
-  return {
-    statusLabels: {},
-    markers: {}
-  };
-}
-
-export function check(_context, shared) {
-  return shared.passResult(
-    "platform-sync",
-    "Skipped: this code platform does not provide a built-in platform-sync adapter"
-  );
-}

package/templates/.agents/scripts/review-diff-fingerprint.js

@@ -1,170 +0,0 @@
-import crypto from "node:crypto";
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import process from "node:process";
-import { execFileSync } from "node:child_process";
-
-import { resolvePostReviewGlobs } from "./lib/post-review-commit.js";
-
-const repoRoot = execFileSync("git", ["rev-parse", "--show-toplevel"], {
-  cwd: process.cwd(),
-  encoding: "utf8"
-}).trim();
-
-function usage() {
-  console.error("Usage: node .agents/scripts/review-diff-fingerprint.js <worktree|staged> <baseline> [--format json]");
-  console.error("   or: node .agents/scripts/review-diff-fingerprint.js compare <expected-tree> <actual-tree> [--format json]");
-  process.exit(2);
-}
-
-function git(args, options = {}) {
-  return execFileSync("git", args, {
-    cwd: repoRoot,
-    encoding: options.encoding || "utf8",
-    env: options.env || process.env
-  });
-}
-
-function loadReviewConfig() {
-  const configPath = path.join(repoRoot, ".agents", ".airc.json");
-  if (!fs.existsSync(configPath)) {
-    return {};
-  }
-
-  try {
-    return JSON.parse(fs.readFileSync(configPath, "utf8")).review || {};
-  } catch {
-    return {};
-  }
-}
-
-function splitNull(output) {
-  return output.split("\0").filter((value) => value !== "");
-}
-
-function pathExists(filePath) {
-  try {
-    fs.lstatSync(filePath);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-function hashDiff(args, env = process.env) {
-  const diff = execFileSync("git", args, {
-    cwd: repoRoot,
-    encoding: "buffer",
-    env
-  });
-  return `sha256:${crypto.createHash("sha256").update(diff).digest("hex")}`;
-}
-
-function withTemporaryIndex(baseline, callback) {
-  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "agent-infra-review-index-"));
-  const tempIndex = path.join(tempDir, "index");
-  const env = { ...process.env, GIT_INDEX_FILE: tempIndex };
-
-  try {
-    execFileSync("git", ["read-tree", baseline], { cwd: repoRoot, env });
-    return callback(env);
-  } finally {
-    fs.rmSync(tempDir, { recursive: true, force: true });
-  }
-}
-
-function projectWorktree(baseline, globs, env) {
-  const tracked = splitNull(git(["diff", "--name-only", "-z", baseline, "--", ...globs]));
-  const untracked = splitNull(git(["ls-files", "-o", "--exclude-standard", "-z", "--", ...globs]));
-  const paths = [...new Set([...tracked, ...untracked])];
-
-  for (const filePath of paths) {
-    const absolutePath = path.join(repoRoot, filePath);
-    if (pathExists(absolutePath)) {
-      execFileSync("git", ["update-index", "--add", "--", filePath], { cwd: repoRoot, env });
-    } else {
-      execFileSync("git", ["update-index", "--remove", "--", filePath], { cwd: repoRoot, env });
-    }
-  }
-}
-
-function projectStaged(baseline, globs, env) {
-  const paths = splitNull(git(["diff", "--cached", "--name-only", "-z", baseline, "--", ...globs]));
-  for (const filePath of paths) {
-    const entry = execFileSync(
-      "git",
-      ["--literal-pathspecs", "ls-files", "--stage", "-z", "--", filePath],
-      { cwd: repoRoot, encoding: "buffer" }
-    );
-    const indexInfo = entry.length > 0
-      ? entry
-      : Buffer.from(`0 ${"0".repeat(40)}\t${filePath}\0`);
-    execFileSync("git", ["update-index", "-z", "--index-info"], {
-      cwd: repoRoot,
-      env,
-      input: indexInfo
-    });
-  }
-}
-
-function snapshot(mode, baseline, globs) {
-  return withTemporaryIndex(baseline, (env) => {
-    if (mode === "worktree") {
-      projectWorktree(baseline, globs, env);
-    } else {
-      projectStaged(baseline, globs, env);
-    }
-    return {
-      baseline,
-      fingerprint: hashDiff(["diff", "--cached", "--binary", baseline, "--", ...globs], env),
-      tree: git(["write-tree"], { env }).trim()
-    };
-  });
-}
-
-function compareTrees(expected, actual) {
-  git(["rev-parse", "--verify", `${expected}^{tree}`]);
-  git(["rev-parse", "--verify", `${actual}^{tree}`]);
-  const fields = splitNull(git(["diff", "--name-status", "-z", "--no-renames", expected, actual]));
-  const result = { equal: fields.length === 0, added: [], missing: [], different: [] };
-  for (let index = 0; index < fields.length; index += 2) {
-    const status = fields[index];
-    const filePath = fields[index + 1];
-    if (status === "A") {
-      result.added.push(filePath);
-    } else if (status === "D") {
-      result.missing.push(filePath);
-    } else {
-      result.different.push(filePath);
-    }
-  }
-  return result;
-}
-
-function main(argv) {
-  const [mode, first, second] = argv;
-  const json = argv.includes("--format") && argv[argv.indexOf("--format") + 1] === "json";
-
-  if (mode === "compare") {
-    if (!first || !second) {
-      usage();
-    }
-    const result = compareTrees(first, second);
-    process.stdout.write(json ? `${JSON.stringify(result)}\n` : `${result.equal ? "equal" : "different"}\n`);
-    process.exitCode = result.equal ? 0 : 1;
-    return;
-  }
-
-  const baseline = first;
-  if (!["worktree", "staged"].includes(mode) || !baseline) {
-    usage();
-  }
-
-  const resolvedBaseline = git(["rev-parse", "--verify", `${baseline}^{commit}`]).trim();
-  const globs = resolvePostReviewGlobs({}, loadReviewConfig());
-  const result = snapshot(mode, resolvedBaseline, globs);
-  process.stdout.write(json ? `${JSON.stringify(result)}\n` : `${result.fingerprint}\n`);
-}
-
-main(process.argv.slice(2));