@fitlab-ai/agent-infra 0.9.12 → 0.9.14

package/README.md

@@ -55,10 +55,10 @@ Once initialized, open the project in your AI TUI and install the latest skills:
 
 ```bash
 /import-issue 42           # AI reads the issue, creates a task, extracts requirements
-/analyze-task <task-id>    # AI scans the codebase, finds the root cause, writes analysis.md
-/review-analysis <task-id> # An isolated reviewer checks the analysis
-/plan-task <task-id>       # AI proposes a fix plan
-/review-plan <task-id>     # A fresh isolated reviewer checks the plan
+/analyze-task --task <task-id>    # AI scans the codebase, finds the root cause, writes analysis.md
+/review-analysis --task <task-id> # An isolated reviewer checks the analysis
+/plan-task --task <task-id>       # AI proposes a fix plan
+/review-plan --task <task-id>     # A fresh isolated reviewer checks the plan
 ```
 
 > **You review the plan and reply in natural language:**
@@ -71,12 +71,12 @@ Just fix it at the application layer in LoginService.
 > AI re-runs `/plan-task` to update the plan accordingly and confirms.
 
 ```bash
-/code-task <task-id>       # AI writes the fix, tests it, and creates a local checkpoint commit
-/review-code <task-id>     # A fresh isolated reviewer reports one minor finding
-/code-task <task-id>       # AI fixes the minor issue, re-validates, and creates a new checkpoint
-/review-code <task-id>     # The reviewer approves the current checkpoint
-/create-pr <task-id>       # The reviewed branch is published to its task-bound target; PR links issue #42
-/complete-task <task-id>   # task archived
+/code-task --task <task-id>       # AI writes the fix, tests it, and creates a local checkpoint commit
+/review-code --task <task-id>     # A fresh isolated reviewer reports one minor finding
+/code-task --task <task-id>       # AI fixes the minor issue, re-validates, and creates a new checkpoint
+/review-code --task <task-id>     # The reviewer approves the current checkpoint
+/create-pr --task <task-id>       # The reviewed branch is published to its task-bound target; PR links issue #42
+/complete-task --task <task-id>   # task archived
 ```
 
 **11 commands. 1 natural-language correction. From issue to merged PR.** That is the entire SOP — programming can have a standard operating procedure too.
@@ -192,7 +192,7 @@ The most-used lifecycle commands, in delivery order. The command prefix varies b
 | `code-task` → `review-code` | Implement and test; `code-task` creates a local checkpoint, then a structured review checks that checkpoint |
 | `create-pr` → `complete-task` | Publish the approved checkpoint to the task-bound target branch, then archive after merge and final gates |
 
-Start with one atomic role policy, for example: `$run-task 42 --executor-model <id> --executor-reasoning-effort <value> --reviewer-model <id> --reviewer-reasoning-effort <value>`. Both roles may use the same model. With no explicit policy, `run-task` reads the current Agent Client's optional `agentClients[].orchestration`; if neither source is complete, it shows the host model-selection guidance before creating any run. Re-entry uses the persisted run policy. Finish or clear active runs before upgrading agent-infra; unsupported disk state fails closed without rewriting.
+Start with one atomic role policy, for example: `$run-task --task 42 --executor-model <id> --executor-reasoning-effort <value> --reviewer-model <id> --reviewer-reasoning-effort <value>`. Both roles may use the same model. With no explicit policy, `run-task` reads the current Agent Client's optional `agentClients[].orchestration`; if neither source is complete, it shows the host model-selection guidance before creating any run. Re-entry uses the persisted run policy. Finish or clear active runs before upgrading agent-infra; unsupported disk state fails closed without rewriting.
 
 See the full catalog — task status, release, security, and project-maintenance skills — in [Built-in AI Skills](./docs/en/skills.md).
 

package/README.zh-CN.md

@@ -54,10 +54,10 @@ agent-infra 的目标就是把这层共享基础设施标准化。它为所有
 
 ```bash
 /import-issue 42           # AI 读取 Issue，创建任务，提取需求
-/analyze-task <task-id>    # AI 扫描代码库，定位根因，输出 analysis.md
-/review-analysis <task-id> # 隔离 reviewer 审查分析产物
-/plan-task <task-id>       # AI 提出修复方案
-/review-plan <task-id>     # fresh 隔离 reviewer 审查方案
+/analyze-task --task <task-id>    # AI 扫描代码库，定位根因，输出 analysis.md
+/review-analysis --task <task-id> # 隔离 reviewer 审查分析产物
+/plan-task --task <task-id>       # AI 提出修复方案
+/review-plan --task <task-id>     # fresh 隔离 reviewer 审查方案
 ```
 
 > **你审查方案后用自然语言回复：**
@@ -70,12 +70,12 @@ agent-infra 的目标就是把这层共享基础设施标准化。它为所有
 > AI 按你的要求重跑 `/plan-task` 更新方案并确认。
 
 ```bash
-/code-task <task-id>       # AI 编写修复代码、测试，并创建本地 checkpoint commit
-/review-code <task-id>     # fresh 隔离 reviewer 报告一个次要问题
-/code-task <task-id>       # AI 修复次要问题、重新验证，并创建新的 checkpoint
-/review-code <task-id>     # reviewer 审查并通过当前 checkpoint
-/create-pr <task-id>       # 将已审查分支发布到任务绑定目标分支；PR 自动关联 Issue #42
-/complete-task <task-id>   # 任务归档
+/code-task --task <task-id>       # AI 编写修复代码、测试，并创建本地 checkpoint commit
+/review-code --task <task-id>     # fresh 隔离 reviewer 报告一个次要问题
+/code-task --task <task-id>       # AI 修复次要问题、重新验证，并创建新的 checkpoint
+/review-code --task <task-id>     # reviewer 审查并通过当前 checkpoint
+/create-pr --task <task-id>       # 将已审查分支发布到任务绑定目标分支；PR 自动关联 Issue #42
+/complete-task --task <task-id>   # 任务归档
 ```
 
 **11 条命令，1 次自然语言纠正，从 Issue 到合并 PR。** 这就是完整的 SOP —— 编程也可以有标准作业流程。
@@ -191,7 +191,7 @@ ai agent-client configure
 | `code-task` → `review-code` | 实现并测试；`code-task` 创建本地 checkpoint，再由结构化审查检视该 checkpoint |
 | `create-pr` → `complete-task` | 将已通过审查的 checkpoint 发布到任务绑定目标分支，并在合并和最终门禁通过后归档 |
 
-启动时可提供原子角色策略，例如：`$run-task 42 --executor-model <id> --executor-reasoning-effort <值> --reviewer-model <id> --reviewer-reasoning-effort <值>`。两个角色可以使用同一模型。完全没有显式策略时，`run-task` 读取当前 Agent Client 可选的 `agentClients[].orchestration`；两个来源都不完整时，会在创建任何 run 前展示宿主模型选择指引。重入使用已持久化的 run 策略。升级 agent-infra 前必须完成或清空 active run；不受支持的磁盘状态会失败关闭且不改写。
+启动时可提供原子角色策略，例如：`$run-task --task 42 --executor-model <id> --executor-reasoning-effort <值> --reviewer-model <id> --reviewer-reasoning-effort <值>`。两个角色可以使用同一模型。完全没有显式策略时，`run-task` 读取当前 Agent Client 可选的 `agentClients[].orchestration`；两个来源都不完整时，会在创建任何 run 前展示宿主模型选择指引。重入使用已持久化的 run 策略。升级 agent-infra 前必须完成或清空 active run；不受支持的磁盘状态会失败关闭且不改写。
 
 完整清单（任务状态、发布、安全、项目维护等 skill）见 [内置 AI Skills](./docs/zh-CN/skills.md)。
 

package/bin/cli.ts

@@ -1,5 +1,11 @@
 #!/usr/bin/env node
 import { VERSION } from '../lib/version.ts';
+import {
+  formatTaskViewDiagnostic,
+  guardTaskOperation,
+  TaskViewOperationError
+} from '../lib/internal/task-operation-registry.ts';
+import { PUBLIC_CLI_COMMAND_ALIASES } from '../lib/internal/cli-route-inventory.ts';
 
 // Node.js version check
 const [major = 0, minor = 0] = process.versions.node.split('.').map((part) => parseInt(part, 10));
@@ -15,7 +21,7 @@ const USAGE = `agent-infra ${VERSION} - bootstrap AI collaboration infrastructur
 Usage: ai <command> [options]
 
 Commands:
-  agent-client    List, inspect, enable, disable, or configure Agent Clients
+  agent-client    List, status, enable, disable, or configure Agent Clients
   cp <ssh-alias>  Copy local clipboard image to a remote macOS clipboard or Linux sandbox over SSH
   data            Capture, verify, audit, repair, and export process data
   decide          Record a ruling; code-stage decisions require explicit implementation intent
@@ -43,16 +49,27 @@ Examples:
   npx @fitlab-ai/agent-infra init
 `;
 
-const COMMAND_ALIASES: Record<string, string> = {
-  s: 'sandbox',
-  t: 'task'
-};
-
 const rawCommand = process.argv[2] || '';
-const command = Object.hasOwn(COMMAND_ALIASES, rawCommand)
-  ? COMMAND_ALIASES[rawCommand]
+const command = Object.hasOwn(PUBLIC_CLI_COMMAND_ALIASES, rawCommand)
+  ? PUBLIC_CLI_COMMAND_ALIASES[rawCommand as keyof typeof PUBLIC_CLI_COMMAND_ALIASES]
   : rawCommand;
 
+let taskViewGuardFailed = false;
+try {
+  const guard = guardTaskOperation('public', command ?? '', process.argv.slice(3));
+  if (guard.taskView && guard.descriptor.effect === 'diagnostic') {
+    process.stderr.write(formatTaskViewDiagnostic(guard.taskView));
+  }
+} catch (error) {
+  taskViewGuardFailed = true;
+  if (error instanceof TaskViewOperationError) {
+    process.stderr.write(`${error.message}\n`);
+    process.exitCode = error.exitCode;
+  } else {
+    throw error;
+  }
+}
+
 function errorMessage(error: unknown): string {
   return error instanceof Error ? error.message : String(error);
 }
@@ -73,7 +90,7 @@ async function importCommand(importPath: string) {
   }
 }
 
-switch (command) {
+if (!taskViewGuardFailed) switch (command) {
   case 'agent-client': {
     const imported = await importCommand('../lib/agent-client.ts');
     if (!imported) break;

package/dist/bin/cli.js

@@ -8,6 +8,8 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
     return path;
 };
 import { VERSION } from '../lib/version.js';
+import { formatTaskViewDiagnostic, guardTaskOperation, TaskViewOperationError } from '../lib/internal/task-operation-registry.js';
+import { PUBLIC_CLI_COMMAND_ALIASES } from '../lib/internal/cli-route-inventory.js';
 // Node.js version check
 const [major = 0, minor = 0] = process.versions.node.split('.').map((part) => parseInt(part, 10));
 if (major < 22 || (major === 22 && minor < 9)) {
@@ -19,7 +21,7 @@ const USAGE = `agent-infra ${VERSION} - bootstrap AI collaboration infrastructur
 Usage: ai <command> [options]
 
 Commands:
-  agent-client    List, inspect, enable, disable, or configure Agent Clients
+  agent-client    List, status, enable, disable, or configure Agent Clients
   cp <ssh-alias>  Copy local clipboard image to a remote macOS clipboard or Linux sandbox over SSH
   data            Capture, verify, audit, repair, and export process data
   decide          Record a ruling; code-stage decisions require explicit implementation intent
@@ -46,14 +48,27 @@ Examples:
   cd my-project && ai init
   npx @fitlab-ai/agent-infra init
 `;
-const COMMAND_ALIASES = {
-    s: 'sandbox',
-    t: 'task'
-};
 const rawCommand = process.argv[2] || '';
-const command = Object.hasOwn(COMMAND_ALIASES, rawCommand)
-    ? COMMAND_ALIASES[rawCommand]
+const command = Object.hasOwn(PUBLIC_CLI_COMMAND_ALIASES, rawCommand)
+    ? PUBLIC_CLI_COMMAND_ALIASES[rawCommand]
     : rawCommand;
+let taskViewGuardFailed = false;
+try {
+    const guard = guardTaskOperation('public', command ?? '', process.argv.slice(3));
+    if (guard.taskView && guard.descriptor.effect === 'diagnostic') {
+        process.stderr.write(formatTaskViewDiagnostic(guard.taskView));
+    }
+}
+catch (error) {
+    taskViewGuardFailed = true;
+    if (error instanceof TaskViewOperationError) {
+        process.stderr.write(`${error.message}\n`);
+        process.exitCode = error.exitCode;
+    }
+    else {
+        throw error;
+    }
+}
 function errorMessage(error) {
     return error instanceof Error ? error.message : String(error);
 }
@@ -71,164 +86,165 @@ async function importCommand(importPath) {
         throw error;
     }
 }
-switch (command) {
-    case 'agent-client': {
-        const imported = await importCommand('../lib/agent-client.ts');
-        if (!imported)
-            break;
-        const { cmdAgentClient } = imported;
-        const code = await cmdAgentClient(process.argv.slice(3)).catch((e) => {
-            process.stderr.write(`Error: ${errorMessage(e)}\n`);
-            return 1;
-        });
-        if (code)
-            process.exitCode = code;
-        break;
-    }
-    case 'cp': {
-        const imported = await importCommand('../lib/cp.ts');
-        if (!imported)
-            break;
-        const { cmdCp } = imported;
-        const code = await cmdCp(process.argv.slice(3)).catch((e) => {
-            process.stderr.write(`Error: ${errorMessage(e)}\n`);
-            return 1;
-        });
-        if (code)
-            process.exitCode = code;
-        break;
-    }
-    case 'data': {
-        const imported = await importCommand('../lib/process-data/index.ts');
-        if (!imported)
-            break;
-        const { cmdData } = imported;
-        const code = await cmdData(process.argv.slice(3)).catch((e) => {
-            process.stderr.write(`Error: ${errorMessage(e)}\n`);
-            return 1;
-        });
-        if (code)
-            process.exitCode = code;
-        break;
-    }
-    case 'decide': {
-        const imported = await importCommand('../lib/decide.ts');
-        if (!imported)
+if (!taskViewGuardFailed)
+    switch (command) {
+        case 'agent-client': {
+            const imported = await importCommand('../lib/agent-client.ts');
+            if (!imported)
+                break;
+            const { cmdAgentClient } = imported;
+            const code = await cmdAgentClient(process.argv.slice(3)).catch((e) => {
+                process.stderr.write(`Error: ${errorMessage(e)}\n`);
+                return 1;
+            });
+            if (code)
+                process.exitCode = code;
             break;
-        const { cmdDecide } = imported;
-        await cmdDecide(process.argv.slice(3));
-        break;
-    }
-    case 'init': {
-        const imported = await importCommand('../lib/init.ts');
-        if (!imported)
+        }
+        case 'cp': {
+            const imported = await importCommand('../lib/cp.ts');
+            if (!imported)
+                break;
+            const { cmdCp } = imported;
+            const code = await cmdCp(process.argv.slice(3)).catch((e) => {
+                process.stderr.write(`Error: ${errorMessage(e)}\n`);
+                return 1;
+            });
+            if (code)
+                process.exitCode = code;
             break;
-        const { cmdInit } = imported;
-        await cmdInit().catch((e) => {
-            process.stderr.write(`Error: ${errorMessage(e)}\n`);
-            process.exitCode = 1;
-        });
-        break;
-    }
-    case 'merge': {
-        const imported = await importCommand('../lib/merge.ts');
-        if (!imported)
+        }
+        case 'data': {
+            const imported = await importCommand('../lib/process-data/index.ts');
+            if (!imported)
+                break;
+            const { cmdData } = imported;
+            const code = await cmdData(process.argv.slice(3)).catch((e) => {
+                process.stderr.write(`Error: ${errorMessage(e)}\n`);
+                return 1;
+            });
+            if (code)
+                process.exitCode = code;
             break;
-        const { cmdMerge } = imported;
-        await cmdMerge(process.argv.slice(3)).catch((e) => {
-            process.stderr.write(`Error: ${errorMessage(e)}\n`);
-            process.exitCode = 1;
-        });
-        break;
-    }
-    case 'run': {
-        const imported = await importCommand('../lib/run/index.ts');
-        if (!imported)
+        }
+        case 'decide': {
+            const imported = await importCommand('../lib/decide.ts');
+            if (!imported)
+                break;
+            const { cmdDecide } = imported;
+            await cmdDecide(process.argv.slice(3));
             break;
-        const { cmdRun } = imported;
-        await cmdRun(process.argv.slice(3));
-        break;
-    }
-    case 'sandbox': {
-        const imported = await importCommand('../lib/sandbox/index.ts');
-        if (!imported)
-            break;
-        const { runSandbox } = imported;
-        await runSandbox(process.argv.slice(3)).catch((e) => {
-            process.stderr.write(`Error: ${errorMessage(e)}\n`);
-            process.exit(1);
-        });
-        break;
-    }
-    case 'server': {
-        const imported = await importCommand('../lib/server/index.ts');
-        if (!imported)
-            break;
-        const { runServer } = imported;
-        await runServer(process.argv.slice(3)).catch((e) => {
-            process.stderr.write(`Error: ${errorMessage(e)}\n`);
-            process.exit(1);
-        });
-        break;
-    }
-    case 'task': {
-        const imported = await importCommand('../lib/task/index.ts');
-        if (!imported)
-            break;
-        const { runTask } = imported;
-        await runTask(process.argv.slice(3)).catch((e) => {
-            process.stderr.write(`Error: ${errorMessage(e)}\n`);
-            process.exit(1);
-        });
-        break;
-    }
-    case 'update': {
-        const imported = await importCommand('../lib/self-update.ts');
-        if (!imported)
+        }
+        case 'init': {
+            const imported = await importCommand('../lib/init.ts');
+            if (!imported)
+                break;
+            const { cmdInit } = imported;
+            await cmdInit().catch((e) => {
+                process.stderr.write(`Error: ${errorMessage(e)}\n`);
+                process.exitCode = 1;
+            });
             break;
-        const { cmdUpdate } = imported;
-        const code = await cmdUpdate().catch((e) => {
-            process.stderr.write(`Error: ${errorMessage(e)}\n`);
-            process.exitCode = 1;
-            return 1;
-        });
-        if (code !== 0)
-            process.exitCode = code;
-        break;
-    }
-    case 'sync': {
-        const imported = await importCommand('../lib/update.ts');
-        if (!imported)
+        }
+        case 'merge': {
+            const imported = await importCommand('../lib/merge.ts');
+            if (!imported)
+                break;
+            const { cmdMerge } = imported;
+            await cmdMerge(process.argv.slice(3)).catch((e) => {
+                process.stderr.write(`Error: ${errorMessage(e)}\n`);
+                process.exitCode = 1;
+            });
+            break;
+        }
+        case 'run': {
+            const imported = await importCommand('../lib/run/index.ts');
+            if (!imported)
+                break;
+            const { cmdRun } = imported;
+            await cmdRun(process.argv.slice(3));
+            break;
+        }
+        case 'sandbox': {
+            const imported = await importCommand('../lib/sandbox/index.ts');
+            if (!imported)
+                break;
+            const { runSandbox } = imported;
+            await runSandbox(process.argv.slice(3)).catch((e) => {
+                process.stderr.write(`Error: ${errorMessage(e)}\n`);
+                process.exit(1);
+            });
+            break;
+        }
+        case 'server': {
+            const imported = await importCommand('../lib/server/index.ts');
+            if (!imported)
+                break;
+            const { runServer } = imported;
+            await runServer(process.argv.slice(3)).catch((e) => {
+                process.stderr.write(`Error: ${errorMessage(e)}\n`);
+                process.exit(1);
+            });
             break;
-        const { cmdSync } = imported;
-        await cmdSync().catch((e) => {
-            process.stderr.write(`Error: ${errorMessage(e)}\n`);
-            process.exitCode = 1;
-        });
-        break;
-    }
-    case 'version': {
-        if (process.argv[3] === '--raw') {
-            console.log(VERSION);
         }
-        else {
+        case 'task': {
+            const imported = await importCommand('../lib/task/index.ts');
+            if (!imported)
+                break;
+            const { runTask } = imported;
+            await runTask(process.argv.slice(3)).catch((e) => {
+                process.stderr.write(`Error: ${errorMessage(e)}\n`);
+                process.exit(1);
+            });
+            break;
+        }
+        case 'update': {
+            const imported = await importCommand('../lib/self-update.ts');
+            if (!imported)
+                break;
+            const { cmdUpdate } = imported;
+            const code = await cmdUpdate().catch((e) => {
+                process.stderr.write(`Error: ${errorMessage(e)}\n`);
+                process.exitCode = 1;
+                return 1;
+            });
+            if (code !== 0)
+                process.exitCode = code;
+            break;
+        }
+        case 'sync': {
+            const imported = await importCommand('../lib/update.ts');
+            if (!imported)
+                break;
+            const { cmdSync } = imported;
+            await cmdSync().catch((e) => {
+                process.stderr.write(`Error: ${errorMessage(e)}\n`);
+                process.exitCode = 1;
+            });
+            break;
+        }
+        case 'version': {
+            if (process.argv[3] === '--raw') {
+                console.log(VERSION);
+            }
+            else {
+                console.log(`agent-infra ${VERSION}`);
+            }
+            break;
+        }
+        case '--version':
+        case '-v': {
             console.log(`agent-infra ${VERSION}`);
+            break;
         }
-        break;
-    }
-    case '--version':
-    case '-v': {
-        console.log(`agent-infra ${VERSION}`);
-        break;
+        case 'help':
+        case '':
+            process.stdout.write(USAGE);
+            break;
+        default:
+            process.stderr.write(`Unknown command: ${command}\n\n`);
+            process.stdout.write(USAGE);
+            process.exitCode = 1;
+            break;
     }
-    case 'help':
-    case '':
-        process.stdout.write(USAGE);
-        break;
-    default:
-        process.stderr.write(`Unknown command: ${command}\n\n`);
-        process.stdout.write(USAGE);
-        process.exitCode = 1;
-        break;
-}
 //# sourceMappingURL=cli.js.map