@fitlab-ai/agent-infra 0.9.6 → 0.9.8

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

@@ -82,7 +82,6 @@ const DEFAULTS = {
       ".agents/skills/",
       ".agents/templates/",
       ".agents/workflows/",
-      ".agents/workspace/README.md",
       ".git-hooks/check-large-files.cjs",
       ".git-hooks/check-version-format.sh",
       ".github/scripts/",
@@ -110,7 +109,16 @@ const DEFAULTS = {
       ".git-hooks/pre-commit",
       ".gitignore"
     ],
-    "ejected": []
+    "ejected": [],
+    "retiredManaged": [
+      {
+        "path": ".agents/workspace/README.md",
+        "templateHashes": [
+          "sha256:967b27ca4008154c5abf99a1df728242f80ed3ace9bd98eb2828bc1c76af826c",
+          "sha256:15aa21942cf2a1396d27834f1d3d723b61a46f8d14600b706f39f3bebc21aea3"
+        ]
+      }
+    ]
   }
 };
 
@@ -1224,6 +1232,26 @@ function entryVariantRels(entry, allSet, platform) {
   return rels;
 }
 
+function ensureRuntimeWorkspace(projectRoot) {
+  const directories = [
+    path.join(projectRoot, '.agents'),
+    path.join(projectRoot, '.agents', 'workspace'),
+    ...['active', 'blocked', 'completed', 'archive'].map((state) =>
+      path.join(projectRoot, '.agents', 'workspace', state)
+    )
+  ];
+  for (const directory of directories) {
+    if (fs.existsSync(directory)) {
+      const stat = fs.lstatSync(directory);
+      if (!stat.isDirectory() || stat.isSymbolicLink()) {
+        throw new Error(`Runtime workspace path must be a real directory: ${directory}`);
+      }
+      continue;
+    }
+    fs.mkdirSync(directory, { mode: 0o700 });
+  }
+}
+
 function syncTemplates(projectRoot, templateRootOverride) {
   const configDir = path.join(projectRoot, '.agents');
   const cfgPath = path.join(configDir, '.airc.json');
@@ -1234,6 +1262,7 @@ function syncTemplates(projectRoot, templateRootOverride) {
 
   const originalConfigText = fs.readFileSync(cfgPath, 'utf8');
   const cfg = JSON.parse(originalConfigText);
+  ensureRuntimeWorkspace(projectRoot);
   const configPathRel = norm(path.relative(projectRoot, cfgPath));
   let templateRoot = templateRootOverride;
   if (!templateRoot) {
@@ -1271,6 +1300,16 @@ function syncTemplates(projectRoot, templateRootOverride) {
     merged: [...(cfg.files.merged || [])],
     ejected: [...(cfg.files.ejected || [])]
   };
+  const retiredManaged = new Map((DEFAULTS.files.retiredManaged || []).map((retired) => {
+    const descriptor = typeof retired === 'string' ? { path: retired } : retired;
+    return [norm(descriptor.path), new Set(
+      (descriptor.templateHashes || []).map(trustedBaseline).filter(Boolean)
+    )];
+  }));
+  const planningRegistry = {
+    ...currentRegistry,
+    managed: currentRegistry.managed.filter((entry) => !retiredManaged.has(norm(entry)))
+  };
   const sharedDefaults = {
     managed: (DEFAULTS.files.managed || []).filter(
       (entry) => !isPathOwnedByOtherPlatform(entry, platformType)
@@ -1280,7 +1319,7 @@ function syncTemplates(projectRoot, templateRootOverride) {
     ),
     ejected: [...(DEFAULTS.files.ejected || [])]
   };
-  const assetPlan = planProjectRegistry(currentRegistry, sharedDefaults, enabledTUIs);
+  const assetPlan = planProjectRegistry(planningRegistry, sharedDefaults, enabledTUIs);
   const managed = [...assetPlan.registry.managed];
   const merged = [...assetPlan.registry.merged];
   const ejected = [...assetPlan.registry.ejected];
@@ -1295,6 +1334,7 @@ function syncTemplates(projectRoot, templateRootOverride) {
   for (const target of Object.keys(managedBaselines)) {
     if (
       !guardedManaged.has(norm(target))
+      && !retiredManaged.has(norm(target))
       && !allClientManaged.some((entry) => assetMatches(entry, target))
     ) {
       delete managedBaselines[target];
@@ -1369,6 +1409,38 @@ function syncTemplates(projectRoot, templateRootOverride) {
     )
   );
 
+  for (const [entry, historicalTemplateHashes] of retiredManaged) {
+    const target = path.join(projectRoot, entry);
+    const owned = currentRegistry.managed.some((candidate) => norm(candidate) === entry);
+    if (!fs.existsSync(target)) continue;
+    const stat = fs.lstatSync(target);
+    const baseline = trustedBaseline(managedBaselines[entry]);
+    const localHash = stat.isFile() && !stat.isSymbolicLink()
+      ? sha256(fs.readFileSync(target))
+      : null;
+    const safeToRemove = owned
+      && localHash !== null
+      && (localHash === baseline || historicalTemplateHashes.has(localHash));
+    if (safeToRemove) {
+      fs.unlinkSync(target);
+      report.managed.removed.push(entry);
+      if (Object.prototype.hasOwnProperty.call(managedBaselines, entry)) {
+        delete managedBaselines[entry];
+        baselinesChanged = true;
+      }
+    } else {
+      report.managed.protected.push({
+        target: entry,
+        reason: owned && localHash !== null && baseline !== null
+          ? 'user-modified'
+          : (owned && localHash === null ? 'invalid-type' : 'unknown-origin'),
+        baseline,
+        local: localHash,
+        template: null
+      });
+    }
+  }
+
   const templateSources = Array.isArray(cfg.templates?.sources) ? cfg.templates.sources : [];
   report.templateSources.configured = templateSources.length;
   const { mergedRels, sourceMap } = mergeTemplateSources(templateRoot, templateSources, report);

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

@@ -1,26 +0,0 @@
-# AI Workspace
-
-This directory is the runtime workspace for multi-AI collaboration. All contents are **git-ignored** except for this README and `.gitkeep` files.
-
-## Directory Structure
-
-```
-.agents/workspace/
-  active/           # Currently active tasks and handoff documents
-  blocked/          # Tasks that are blocked and waiting for resolution
-  completed/        # Completed tasks (kept for reference)
-  logs/             # Collaboration logs and session records
-```
-
-## Usage
-
-- **active/**: Place task files here when work begins. Move them to `completed/` or `blocked/` as appropriate.
-- **blocked/**: Move tasks here when they cannot proceed. Document the blocker in the task file.
-- **completed/**: Move tasks here when they are done. These serve as a historical record.
-- **logs/**: Store session logs, AI conversation exports, or collaboration notes.
-
-## Important
-
-- Contents of this directory are **not version-controlled** (git-ignored).
-- Do not store anything here that needs to be shared via git.
-- Templates and workflow definitions belong in `.agents/`, not here.

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

@@ -1,26 +0,0 @@
-# AI 工作区
-
-本目录是多 AI 协作的运行时工作区。除本 README 和 `.gitkeep` 文件外，所有内容均被 **git ignore**。
-
-## 目录结构
-
-```
-.agents/workspace/
-  active/           # 当前活跃的任务和交接文档
-  blocked/          # 被阻塞的任务，等待解决
-  completed/        # 已完成的任务（保留供参考）
-  logs/             # 协作日志和会话记录
-```
-
-## 使用方法
-
-- **active/**：工作开始时将任务文件放在这里。根据情况将其移至 `completed/` 或 `blocked/`。
-- **blocked/**：当任务无法继续时将其移至此处。在任务文件中记录阻塞原因。
-- **completed/**：任务完成后将其移至此处。这些作为历史记录保留。
-- **logs/**：存储会话日志、AI 对话导出或协作笔记。
-
-## 重要事项
-
-- 本目录的内容**不受版本控制**（已被 git ignore）。
-- 不要在这里存储需要通过 git 共享的内容。
-- 模板和工作流定义属于 `.agents/` 目录，而非此处。