@fitlab-ai/agent-infra 0.9.13 → 0.9.14

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

package/dist/bin/internal-cli.js

@@ -1,11 +1,32 @@
 #!/usr/bin/env node
+import { classifySandboxControlEnvironment } from '../lib/sandbox/control/client.js';
+import { formatTaskViewDiagnostic, guardTaskOperation, TaskViewOperationError } from '../lib/internal/task-operation-registry.js';
+import { INTERNAL_HANDLER_ROUTE_SELECTORS } from '../lib/internal/cli-route-inventory.js';
 const [major = 0, minor = 0] = process.versions.node.split('.').map((part) => parseInt(part, 10));
 if (major < 22 || (major === 22 && minor < 9)) {
     process.stderr.write(`agent-infra-internal requires Node.js >= 22.9.0 (current: ${process.version})\n`);
     process.exit(1);
 }
 const command = process.argv[2] || '';
+const internalRouteRegistered = Object.hasOwn(INTERNAL_HANDLER_ROUTE_SELECTORS, command);
 const taskControlCommand = command === 'task-lifecycle' || command === 'task-orchestration' || command === 'task-finalization';
+let taskViewGuardFailed = false;
+try {
+    const guard = guardTaskOperation('internal', 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 taskControlTransportFailure(message) {
     process.stdout.write(`${JSON.stringify({
         status: 'failed', changed: false,
@@ -13,26 +34,12 @@ function taskControlTransportFailure(message) {
     })}\n`);
     process.exit(1);
 }
-if (taskControlCommand) {
-    const env = process.env;
-    const executorMarked = Boolean(env.AGENT_INFRA_EXECUTOR_MANIFEST);
-    const controlKeys = [
-        'AGENT_INFRA_CONTROL_TOKEN', 'AGENT_INFRA_CONTROL_GENERATION',
-        'AGENT_INFRA_CONTROL_DIR', 'AGENT_INFRA_CONTROL_STATUS_DIR'
-    ];
-    const hasControlMarker = controlKeys.some((key) => Boolean(env[key]))
-        || Boolean(env.AGENT_INFRA_CONTROL_CONTROLLER_BINDING);
-    const taskBindingMarker = hasControlMarker && Boolean(env.AGENT_INFRA_TASK_ID);
-    const hasCompleteClientConfig = controlKeys.every((key) => Boolean(env[key]))
-        && !env.AGENT_INFRA_CONTROL_CONTROLLER_BINDING
-        && (!taskBindingMarker || Boolean(env.AGENT_INFRA_RUNTIME_DIR));
-    if (executorMarked) {
-        taskControlTransportFailure('executor context is only valid for sandbox-control execute');
-    }
-    if ((hasControlMarker || taskBindingMarker) && !hasCompleteClientConfig) {
-        taskControlTransportFailure('sandbox client control configuration is incomplete or conflicting');
+if (!taskViewGuardFailed && taskControlCommand) {
+    const environment = classifySandboxControlEnvironment();
+    if (environment.kind === 'invalid') {
+        taskControlTransportFailure(environment.message ?? 'sandbox client control configuration is invalid');
     }
-    if (hasCompleteClientConfig) {
+    if (environment.kind === 'controlled') {
         const { sandboxControl } = await import('../lib/internal/sandbox-control.js');
         await sandboxControl(['client', command, ...process.argv.slice(3)]);
     }
@@ -56,7 +63,7 @@ if (taskControlCommand) {
         }
     }
 }
-else
+else if (!taskViewGuardFailed && internalRouteRegistered)
     switch (command) {
         case 'task-create': {
             const { taskCreate } = await import('../lib/internal/task-create.js');
@@ -138,6 +145,16 @@ else
             await platformChecks(process.argv.slice(3));
             break;
         }
+        case 'platform-security': {
+            const { platformSecurity } = await import('../lib/internal/platform-security.js');
+            await platformSecurity(process.argv.slice(3));
+            break;
+        }
+        case 'platform-metadata': {
+            const { platformMetadata } = await import('../lib/internal/platform-metadata.js');
+            await platformMetadata(process.argv.slice(3));
+            break;
+        }
         case 'task-context': {
             const { taskContext } = await import('../lib/internal/task-context.js');
             taskContext(process.argv.slice(3));
@@ -148,6 +165,11 @@ else
             await taskLedger(process.argv.slice(3));
             break;
         }
+        case 'task-qualification': {
+            const { taskQualification } = await import('../lib/internal/task-qualification.js');
+            await taskQualification(process.argv.slice(3));
+            break;
+        }
         case 'task-warning': {
             const { taskWarning } = await import('../lib/internal/task-warning.js');
             await taskWarning(process.argv.slice(3));
@@ -226,5 +248,4 @@ else
             })}\n`);
             process.exitCode = 1;
     }
-export {};
 //# sourceMappingURL=internal-cli.js.map

package/dist/lib/agent-client.js

@@ -6,6 +6,8 @@ import { listAgentClientAdapters } from './agent-clients/registry.js';
 import { AGENT_CLIENT_IDS, isAgentClientId } from './agent-clients/types.js';
 import { closePrompt, multiSelect } from './prompt.js';
 import { resolveTemplateDir } from './paths.js';
+import { PUBLIC_CLI_ROUTE_SELECTORS } from './internal/cli-route-inventory.js';
+const AGENT_CLIENT_OPERATIONS = PUBLIC_CLI_ROUTE_SELECTORS['agent-client'];
 const USAGE = `Usage: ai agent-client <operation>
 
 Operations:
@@ -79,6 +81,9 @@ async function cmdAgentClient(args) {
         process.stdout.write(USAGE);
         return 0;
     }
+    if (!AGENT_CLIENT_OPERATIONS.includes(operation)) {
+        throw new AgentClientCommandError('AGENT_CLIENT_OPERATION_INVALID', `Unknown operation '${operation}'`);
+    }
     if (operation === 'list') {
         if (args.length !== 1) {
             throw new AgentClientCommandError('AGENT_CLIENT_ARGUMENT_INVALID', 'list accepts no arguments');

package/dist/lib/internal/agent-client.js

@@ -5,6 +5,7 @@ import { normalizeCustomTUIs } from '../agent-clients/custom-tuis.js';
 import { renderNextStepCommands } from '../agent-clients/next-steps.js';
 import { getAgentClientModelSelection } from '../agent-clients/registry.js';
 import { isAgentClientId } from '../agent-clients/types.js';
+import { ensureInternalHandlerRoute, internalHandlerRoute } from './cli-route-inventory.js';
 const USAGE = 'Usage: agent-infra-internal agent-client <next-steps|model-selection> [options]\n';
 function failure(code, message) {
     process.stdout.write(`${JSON.stringify({
@@ -21,7 +22,7 @@ function parseArgs(args) {
         process.stdout.write(USAGE);
         return null;
     }
-    if (args[0] !== 'next-steps') {
+    if (!internalHandlerRoute('agent-client', 'next-steps', args[0] ?? '')) {
         failure('AGENT_CLIENT_PAYLOAD_INVALID', "operation must be 'next-steps'");
         return null;
     }
@@ -72,7 +73,9 @@ function parseArgs(args) {
     };
 }
 function agentClient(args = []) {
-    if (args[0] === 'model-selection') {
+    if (!ensureInternalHandlerRoute('agent-client', args))
+        return;
+    if (internalHandlerRoute('agent-client', 'model-selection', args[0] ?? '')) {
         const values = {};
         const seen = new Set();
         for (let index = 1; index < args.length; index += 1) {