@fitlab-ai/agent-infra 0.9.10 → 0.9.11

package/README.md

@@ -121,6 +121,15 @@ brew install fitlab-ai/tap/agent-infra
 
 ### Updating agent-infra
 
+```bash
+ai update
+```
+
+`ai update` updates the installed agent-infra CLI. In an initialized project,
+use `ai sync` to refresh project seed files and the file registry.
+
+The equivalent package-manager commands remain:
+
 ```bash
 npm update -g @fitlab-ai/agent-infra
 # or, if installed via Homebrew:
@@ -142,7 +151,7 @@ ai init
 # or: agent-infra init
 ```
 
-The CLI collects project metadata, lets you select the enabled Agent Clients, installs their `update-agent-infra` seed commands, and generates `.agents/.airc.json`.
+The CLI collects project metadata, lets you select the enabled Agent Clients, installs any client-specific `update-agent-infra` seed commands, and generates `.agents/.airc.json`.
 
 > `ai` is a shorthand for `agent-infra`. Both commands are equivalent.
 
@@ -156,12 +165,13 @@ Open the project in any AI TUI and run `update-agent-infra`:
 | Codex | `$update-agent-infra` |
 | Antigravity CLI | `/update-agent-infra` |
 | OpenCode | `/update-agent-infra` |
+| TraeCode CLI | `/update-agent-infra` |
 
 This detects the packaged template version and renders all managed files. The same command is used both for first-time setup and for future template upgrades.
 
 ## Core Commands
 
-Manage the four built-in Agent Clients independently from the project lifecycle:
+Manage the five built-in Agent Clients independently from the project lifecycle:
 
 ```bash
 ai agent-client list
@@ -171,7 +181,7 @@ ai agent-client disable antigravity-cli
 ai agent-client configure
 ```
 
-The most-used lifecycle commands, in delivery order. The command prefix varies by TUI (`/skill` in Claude Code/Antigravity/OpenCode and `$skill` in Codex); the workflow semantics stay the same.
+The most-used lifecycle commands, in delivery order. The command prefix varies by TUI (`/skill` in Claude Code/Antigravity/OpenCode/TraeCode and `$skill` in Codex); the workflow semantics stay the same.
 
 | Command | Purpose |
 |---------|---------|

package/README.zh-CN.md

@@ -120,6 +120,15 @@ brew install fitlab-ai/tap/agent-infra
 
 ### 更新 agent-infra
 
+```bash
+ai update
+```
+
+`ai update` 用于更新已安装的 agent-infra CLI。在已初始化项目中，使用
+`ai sync` 刷新项目 seed files 和文件注册表。
+
+对应的包管理器命令仍然是：
+
 ```bash
 npm update -g @fitlab-ai/agent-infra
 # 或者通过 Homebrew 安装时：
@@ -141,7 +150,7 @@ ai init
 # 或：agent-infra init
 ```
 
-CLI 会收集项目元数据，让你选择启用的 Agent Client，为其安装 `update-agent-infra` 种子命令，并生成 `.agents/.airc.json`。
+CLI 会收集项目元数据，让你选择启用的 Agent Client，安装该客户端需要的 `update-agent-infra` 种子命令，并生成 `.agents/.airc.json`。
 
 > `ai` 是 `agent-infra` 的简写命令，两者等价。
 
@@ -155,12 +164,13 @@ CLI 会收集项目元数据，让你选择启用的 Agent Client，为其安装
 | Codex | `$update-agent-infra` |
 | Antigravity CLI | `/update-agent-infra` |
 | OpenCode | `/update-agent-infra` |
+| TraeCode CLI | `/update-agent-infra` |
 
 该命令会检测当前打包模板版本并渲染所有受管理文件。首次安装和后续升级都使用同一条命令。
 
 ## 核心命令
 
-以下命令用于独立管理四个内建 Agent Client：
+以下命令用于独立管理五个内建 Agent Client：
 
 ```bash
 ai agent-client list
@@ -170,7 +180,7 @@ ai agent-client disable antigravity-cli
 ai agent-client configure
 ```
 
-最常用的生命周期命令，按交付顺序排列。命令前缀因 TUI 而异（Claude Code/Antigravity/OpenCode 用 `/skill`，Codex 用 `$skill`），工作流语义保持一致。
+最常用的生命周期命令，按交付顺序排列。命令前缀因 TUI 而异（Claude Code/Antigravity/OpenCode/TraeCode 用 `/skill`，Codex 用 `$skill`），工作流语义保持一致。
 
 | 命令 | 用途 |
 |------|------|

package/bin/cli.ts

@@ -21,12 +21,13 @@ Commands:
   decide          Record a ruling; code-stage decisions require explicit implementation intent
   help            Show this help message
   init            Initialize a new project with update-agent-infra seed command
-  merge           Merge tasks from another workspace directory (active/blocked/completed/archive)
+  merge           Merge tasks from another current workspace directory (active/blocked/completed/archive)
   run             Schedule a lifecycle skill in the task sandbox tmux session
   sandbox, s      Manage Docker-based AI sandboxes
   server          Run the local AI collaboration daemon (start/stop/status/logs)
   task, t         Read-only views of .agents/workspace tasks
-  update          Update seed files and sync file registry for an existing project
+  sync            Update seed files and sync file registry for an existing project
+  update          Update the agent-infra CLI itself
   version         Show version
 
 'ai' and 'agent-infra' are interchangeable; 'ai' is the shorter form.
@@ -171,10 +172,22 @@ switch (command) {
     break;
   }
   case 'update': {
-    const imported = await importCommand('../lib/update.ts');
+    const imported = await importCommand('../lib/self-update.ts');
     if (!imported) break;
     const { cmdUpdate } = imported;
-    await cmdUpdate().catch((e: unknown) => {
+    const code = await cmdUpdate().catch((e: unknown) => {
+      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: unknown) => {
       process.stderr.write(`Error: ${errorMessage(e)}\n`);
       process.exitCode = 1;
     });

package/dist/bin/cli.js

@@ -25,12 +25,13 @@ Commands:
   decide          Record a ruling; code-stage decisions require explicit implementation intent
   help            Show this help message
   init            Initialize a new project with update-agent-infra seed command
-  merge           Merge tasks from another workspace directory (active/blocked/completed/archive)
+  merge           Merge tasks from another current workspace directory (active/blocked/completed/archive)
   run             Schedule a lifecycle skill in the task sandbox tmux session
   sandbox, s      Manage Docker-based AI sandboxes
   server          Run the local AI collaboration daemon (start/stop/status/logs)
   task, t         Read-only views of .agents/workspace tasks
-  update          Update seed files and sync file registry for an existing project
+  sync            Update seed files and sync file registry for an existing project
+  update          Update the agent-infra CLI itself
   version         Show version
 
 'ai' and 'agent-infra' are interchangeable; 'ai' is the shorter form.
@@ -182,11 +183,25 @@ switch (command) {
         break;
     }
     case 'update': {
-        const imported = await importCommand('../lib/update.ts');
+        const imported = await importCommand('../lib/self-update.ts');
         if (!imported)
             break;
         const { cmdUpdate } = imported;
-        await cmdUpdate().catch((e) => {
+        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;
         });

package/dist/bin/internal-cli.js

@@ -5,10 +5,56 @@ if (major < 22 || (major === 22 && minor < 9)) {
     process.exit(1);
 }
 const command = process.argv[2] || '';
-if (process.env.AGENT_INFRA_CONTROL_TOKEN
-    && (command === 'task-lifecycle' || command === 'task-orchestration' || command === 'task-finalization')) {
-    const { sandboxControl } = await import('../lib/internal/sandbox-control.js');
-    await sandboxControl(['client', command, ...process.argv.slice(3)]);
+const taskControlCommand = command === 'task-lifecycle' || command === 'task-orchestration' || command === 'task-finalization';
+function taskControlTransportFailure(message) {
+    process.stdout.write(`${JSON.stringify({
+        status: 'failed', changed: false,
+        error: { code: 'TASK_CONTROL_TRANSPORT_INVALID', 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 (hasCompleteClientConfig) {
+        const { sandboxControl } = await import('../lib/internal/sandbox-control.js');
+        await sandboxControl(['client', command, ...process.argv.slice(3)]);
+    }
+    else {
+        switch (command) {
+            case 'task-orchestration': {
+                const { taskOrchestration } = await import('../lib/internal/task-orchestration.js');
+                await taskOrchestration(process.argv.slice(3));
+                break;
+            }
+            case 'task-lifecycle': {
+                const { taskLifecycle } = await import('../lib/internal/task-lifecycle.js');
+                taskLifecycle(process.argv.slice(3));
+                break;
+            }
+            case 'task-finalization': {
+                const { taskFinalization } = await import('../lib/internal/task-finalization.js');
+                taskFinalization(process.argv.slice(3));
+                break;
+            }
+        }
+    }
 }
 else
     switch (command) {

package/dist/lib/agent-client.js

@@ -96,7 +96,6 @@ async function cmdAgentClient(args) {
                 throw new AgentClientCommandError('AGENT_CLIENT_ARGUMENT_INVALID', 'status accepts no arguments');
             }
             const plan = workflowPlan(projectRoot, config, { type: 'none' });
-            process.stdout.write(`source: ${plan.source}\n`);
             printState(plan.desired);
             for (const seed of plan.seedOperations) {
                 process.stdout.write(`  seed ${seed.target}: ${seed.kind}\n`);

package/dist/lib/agent-clients/adapters/opencode-sandbox.js

@@ -20,12 +20,8 @@ function ensureOpenCodeSandboxState(toolDir, hostHome, hostEnv = {}) {
     const canonicalConfigDir = path.join(toolDir, '.xdg', 'config', 'opencode');
     const canonicalStateDir = path.join(toolDir, '.xdg', 'state', 'opencode');
     const canonicalConfigPath = path.join(canonicalConfigDir, 'opencode.json');
-    const legacyConfigPath = path.join(toolDir, 'opencode.json');
     fs.mkdirSync(canonicalConfigDir, { recursive: true });
     fs.mkdirSync(canonicalStateDir, { recursive: true });
-    if (!fs.existsSync(canonicalConfigPath) && fs.existsSync(legacyConfigPath)) {
-        fs.copyFileSync(legacyConfigPath, canonicalConfigPath, fs.constants.COPYFILE_EXCL);
-    }
     const hostConfigRoot = resolveXdgRoot(hostEnv.XDG_CONFIG_HOME, path.join(hostHome, '.config'));
     const hostConfig = readJsonObject(path.join(hostConfigRoot, 'opencode', 'opencode.json'));
     if (!hostConfig) {

package/dist/lib/agent-clients/adapters/traecli.js

@@ -24,22 +24,21 @@ const traecliAdapter = defineAgentClientAdapter({
         actualReasoningEffort: 'unavailable'
     },
     project: {
-        ownedPathPrefixes: ['.trae/'],
-        managed: ['.trae/skills/'],
+        ownedPathPrefixes: ['.traecli/'],
+        managed: ['.traecli/commands/'],
         merged: [],
         ejected: [],
         seedCommands: [{
                 templates: {
-                    en: '.trae/skills/update-agent-infra.en.md',
-                    'zh-CN': '.trae/skills/update-agent-infra.zh-CN.md'
+                    en: '.traecli/commands/update-agent-infra.en.md',
+                    'zh-CN': '.traecli/commands/update-agent-infra.zh-CN.md'
                 },
-                target: '.trae/skills/update-agent-infra.md'
+                target: '.traecli/commands/update-agent-infra.md'
             }],
         customCommand: {
-            target: '.trae/skills/${skillName}.md',
+            target: '.traecli/commands/${skillName}.md',
             frontmatter: {},
-            includeUsage: true,
-            inheritDisableModelInvocation: true
+            argumentsToken: '$ARGUMENTS'
         }
     },
     sandbox: {

package/dist/lib/agent-clients/config.js

@@ -101,114 +101,29 @@ function serializeAgentClients(state) {
             : {})
     }));
 }
-function projectLegacyTuis(value, diagnostics) {
-    if (!Array.isArray(value)) {
-        return Object.fromEntries(AGENT_CLIENT_IDS.map((id) => [id, true]));
-    }
-    const enabled = new Set();
-    for (const [index, candidate] of value.entries()) {
-        if (isAgentClientId(candidate)) {
-            enabled.add(candidate);
-        }
-        else {
-            diagnostics.push({
-                code: 'LEGACY_VALUE_IGNORED',
-                path: `tuis[${index}]`
-            });
-        }
-    }
-    return Object.fromEntries(AGENT_CLIENT_IDS.map((id) => [id, enabled.has(id)]));
-}
-function projectLegacySandbox(value, diagnostics) {
-    if (!Array.isArray(value) || value.length === 0) {
-        return {
-            installed: Object.fromEntries(AGENT_CLIENT_IDS.map((id) => [id, true])),
-            clientSignals: new Set(),
-            remainingTools: Array.isArray(value) ? [] : undefined
-        };
-    }
-    const installed = new Set();
-    const remainingTools = [];
-    for (const [index, candidate] of value.entries()) {
-        if (isAgentClientId(candidate)) {
-            installed.add(candidate);
-        }
-        else if (typeof candidate === 'string') {
-            remainingTools.push(candidate);
-        }
-        else {
-            diagnostics.push({
-                code: 'LEGACY_VALUE_IGNORED',
-                path: `sandbox.tools[${index}]`
-            });
-        }
-    }
-    return {
-        installed: Object.fromEntries(AGENT_CLIENT_IDS.map((id) => [id, installed.has(id)])),
-        clientSignals: installed,
-        remainingTools
-    };
-}
-function stateFromLegacy(enabled, installed) {
-    return Object.fromEntries(AGENT_CLIENT_IDS.map((id) => [
-        id,
-        {
-            enabled: enabled[id],
-            installInSandbox: installed[id]
-        }
-    ]));
-}
-function sameCanonicalOrder(value) {
-    return Array.isArray(value)
-        && value.every((entry, index) => isRecord(entry) && entry.id === AGENT_CLIENT_IDS[index]);
-}
 function normalizeAgentClients(input) {
-    const diagnostics = [];
-    const hasCanonical = hasOwn(input, 'agentClients');
-    const hasLegacyTuis = hasOwn(input, 'tuis');
-    const sandbox = isRecord(input.sandbox) ? input.sandbox : undefined;
-    const hasLegacySandboxTools = sandbox !== undefined && hasOwn(sandbox, 'tools');
-    const tuiProjection = projectLegacyTuis(input.tuis, diagnostics);
-    const sandboxProjection = projectLegacySandbox(sandbox?.tools, diagnostics);
-    if (!hasCanonical) {
-        const state = stateFromLegacy(tuiProjection, sandboxProjection.installed);
-        return {
-            source: 'legacy',
-            state,
-            canonical: serializeAgentClients(state),
-            remainingSandboxTools: sandboxProjection.remainingTools,
-            removeLegacyTuis: hasLegacyTuis,
-            changed: true,
-            diagnostics
-        };
-    }
+    if (!hasOwn(input, 'agentClients'))
+        fail('MISSING_AGENT_CLIENT', 'agentClients');
     const state = parseCanonical(input.agentClients);
-    if (hasLegacyTuis) {
-        for (const id of AGENT_CLIENT_IDS) {
-            if (state[id].enabled !== tuiProjection[id]) {
-                fail('LEGACY_CONFLICT', 'tuis');
-            }
+    for (const [index, id] of AGENT_CLIENT_IDS.entries()) {
+        const entry = Array.isArray(input.agentClients) ? input.agentClients[index] : undefined;
+        if (!isRecord(entry) || entry.id !== id) {
+            fail('INVALID_AGENT_CLIENTS', `agentClients[${index}].id`);
         }
     }
-    if (hasLegacySandboxTools) {
-        for (const id of sandboxProjection.clientSignals) {
-            if (!state[id].installInSandbox) {
-                fail('LEGACY_CONFLICT', 'sandbox.tools');
+    if (hasOwn(input, 'tuis'))
+        fail('INVALID_AGENT_CLIENTS', 'tuis');
+    const sandbox = isRecord(input.sandbox) ? input.sandbox : undefined;
+    if (Array.isArray(sandbox?.tools)) {
+        for (const [index, tool] of sandbox.tools.entries()) {
+            if (isAgentClientId(tool)) {
+                fail('INVALID_AGENT_CLIENTS', `sandbox.tools[${index}]`);
             }
         }
     }
     return {
-        source: 'canonical',
         state,
-        canonical: serializeAgentClients(state),
-        remainingSandboxTools: hasLegacySandboxTools
-            ? sandboxProjection.remainingTools
-            : undefined,
-        removeLegacyTuis: hasLegacyTuis,
-        changed: hasLegacyTuis
-            || sandboxProjection.clientSignals.size > 0
-            || !sameCanonicalOrder(input.agentClients),
-        diagnostics
+        canonical: serializeAgentClients(state)
     };
 }
 export { AgentClientConfigError, normalizeAgentClients, serializeAgentClients };

package/dist/lib/agent-clients/reconcile.js

@@ -71,15 +71,6 @@ function planAgentClientReconciliation(input) {
     });
     const nextConfig = structuredClone(input.config);
     nextConfig.agentClients = serializeAgentClients(desired);
-    delete nextConfig.tuis;
-    if (normalized.remainingSandboxTools !== undefined) {
-        const sandbox = isRecord(nextConfig.sandbox) ? { ...nextConfig.sandbox } : {};
-        sandbox.tools = [
-            'agent-infra',
-            ...normalized.remainingSandboxTools.filter((tool) => tool !== 'agent-infra')
-        ];
-        nextConfig.sandbox = sandbox;
-    }
     const existingFiles = isRecord(nextConfig.files) ? nextConfig.files : {};
     const existingBaselines = isRecord(existingFiles.managedBaselines)
         ? existingFiles.managedBaselines
@@ -161,14 +152,13 @@ function planAgentClientReconciliation(input) {
     const changed = JSON.stringify(nextConfig) !== JSON.stringify(input.config)
         || actionableSeed;
     return Object.freeze({
-        source: normalized.source,
         before: normalized.state,
         desired,
         nextConfig,
         projectAssets,
         seedOperations: Object.freeze(seedOperations),
         nextSteps,
-        diagnostics: Object.freeze([...normalized.diagnostics, ...custom.diagnostics]),
+        diagnostics: Object.freeze([...custom.diagnostics]),
         changed,
         projectRoot: input.projectRoot,
         configPath: path.join(input.projectRoot, '.agents', '.airc.json')

package/dist/lib/agent-clients/schema.js

@@ -10,14 +10,15 @@ const AGENT_CLIENTS_SCHEMA = {
             maxItems: AGENT_CLIENT_IDS.length,
             uniqueItems: true,
             description: 'Canonical Agent Client configuration. Object ID completeness and uniqueness are enforced by the runtime normalizer.',
-            items: {
+            additionalItems: false,
+            items: AGENT_CLIENT_IDS.map((id) => ({
                 type: 'object',
                 additionalProperties: false,
                 required: ['id', 'enabled', 'installInSandbox'],
                 properties: {
                     id: {
-                        type: 'string',
-                        enum: [...AGENT_CLIENT_IDS]
+                        const: id,
+                        type: 'string'
                     },
                     enabled: {
                         type: 'boolean'
@@ -35,7 +36,7 @@ const AGENT_CLIENTS_SCHEMA = {
                         }
                     }
                 }
-            }
+            }))
         },
         customTUIs: {
             type: 'array',

package/dist/lib/agent-clients/tokens.js

@@ -1,25 +1,15 @@
 // Active AI collaborator short tokens — the write-side whitelist for the
 // activity log. Migrated from lib/task/commands/log.ts so that the write-side
-// internal commands and the rendering side share one definition. Historical
-// Gemini tokens remain read-only and are handled by classifyAgent below.
+// internal commands and the rendering side share one definition.
 export const KNOWN_AI_AGENTS = new Set(['claude', 'codex', 'antigravity', 'opencode', 'cursor', 'traecli']);
-// Long name -> short name mapping (HD-4, decision A): `claude-code` reuses the
-// existing orchestration precedent, and `antigravity-cli` is the active
-// client. `gemini-cli` is intentionally not writable.
+// Long name -> short name mapping: `claude-code` reuses the existing
+// orchestration precedent, and `antigravity-cli` is the active client.
 export const AGENT_LONG_NAMES = {
     'claude-code': 'claude',
     'antigravity-cli': 'antigravity'
 };
 export const AGENT_USAGE_HINT = "agent must be a short token (claude/codex/antigravity/opencode/cursor/traecli), " +
     "a long name (claude-code -> claude, antigravity-cli -> antigravity), or 'human'";
-// Read-side historical compatibility for activity-log rendering: `gemini` and
-// `gemini-cli` stay recognizable when displaying old logs, but are never
-// accepted by normalizeAgentToken (write side).
-const READ_KNOWN_AI_AGENTS = new Set([...KNOWN_AI_AGENTS, 'gemini']);
-const READ_AGENT_LONG_NAMES = {
-    ...AGENT_LONG_NAMES,
-    'gemini-cli': 'gemini'
-};
 // Strict write-side validation: the value must be exactly a short token, a
 // long name, or 'human'; returns the normalized short token, or null when
 // the value is not a recognized agent.
@@ -41,9 +31,9 @@ export function classifyAgent(raw) {
         return { status: 'unknown', display: 'human' };
     if (token === 'human')
         return { status: 'human', display: 'human' };
-    if (READ_KNOWN_AI_AGENTS.has(token))
+    if (KNOWN_AI_AGENTS.has(token))
         return { status: 'ai', display: token };
-    const short = READ_AGENT_LONG_NAMES[token];
+    const short = AGENT_LONG_NAMES[token];
     return short ? { status: 'ai', display: short } : { status: 'unknown', display: 'human' };
 }
 //# sourceMappingURL=tokens.js.map

package/dist/lib/decide.js

@@ -3,7 +3,7 @@ import { parseTaskScope } from './task/command-options.js';
 import { applyHumanDecision } from './task/decision-intents.js';
 import { canonicalTimestamp } from './task/write.js';
 import { consumeHumanOverride, failureId } from './task/human-override.js';
-import { resolveTaskRef } from './task/resolve-ref.js';
+import { resolveTaskContext } from './task/resolve-ref.js';
 import { TaskExecutionLockError, withTaskExecutionLock } from './task/task-execution-lock.js';
 function parseDecisionParts(parts) {
     const decision = [];
@@ -66,47 +66,33 @@ export async function decide(args, options = {}) {
             }
         }
         else if (arg.startsWith('--item=')) {
-            if (item !== undefined) {
-                process.stderr.write("Error: duplicate option '--item'\n");
-                return 1;
-            }
-            item = arg.slice('--item='.length);
-            if (item === '') {
-                process.stderr.write('Error: --item requires a value\n');
-                return 1;
-            }
+            process.stderr.write('Error: --item=... is not supported; use --item <selector> or -i <selector>\n');
+            return 1;
         }
         else
             operands.push(arg);
     }
-    let taskRef = scope.taskRef;
-    let selector = item;
-    let decisionParts;
-    if (item !== undefined) {
-        decisionParts = operands;
-    }
-    else if (!scope.explicit) {
-        [taskRef, selector, ...decisionParts] = operands;
-    }
-    else {
-        decisionParts = [];
-    }
+    const taskRef = scope.taskRef;
+    const selector = item;
+    const decisionParts = operands;
     if (!selector || decisionParts.length === 0) {
-        process.stderr.write('Usage: ai decide [--task <ref>] --item <ordinal|ledger-id> [--needs-implementation true|false] <decision>\n       ai decide <task-ref> <ordinal|ledger-id> [--needs-implementation true|false] <decision>\n');
+        process.stderr.write('Usage: ai decide [--task <ref> | -t <ref>] (--item <ordinal|ledger-id> | -i <ordinal|ledger-id>) [--needs-implementation true|false] <decision>\n');
         return 1;
     }
     try {
         const parsedDecision = parseDecisionParts(decisionParts);
         const now = (options.now ?? canonicalTimestamp)();
+        const resolved = resolveTaskContext(taskRef, { repoRoot: options.repoRoot });
+        if (!resolved.ok)
+            throw new Error(resolved.message);
         const request = {
-            taskRef, selector, decision: parsedDecision.decision,
+            taskRef: resolved.taskId, selector, decision: parsedDecision.decision,
             needsImplementation: parsedDecision.needsImplementation
         };
         const writeOptions = {
-            repoRoot: options.repoRoot,
+            repoRoot: resolved.repoRoot,
             metadataProvider: () => ({ timestamp: now, agentInfraVersion: options.version ?? VERSION })
         };
-        const resolved = taskRef ? resolveTaskRef(taskRef, { repoRoot: options.repoRoot }) : null;
         let result;
         const execute = () => {
             let current = applyHumanDecision(request, writeOptions);
@@ -115,7 +101,7 @@ export async function decide(args, options = {}) {
             if (!parsedDecision.overrideTarget || !parsedDecision.overrideScope)
                 throw new Error('override ticket requires --override-target and --override-scope');
             const consumed = consumeHumanOverride({
-                taskRef: resolved?.ok ? resolved.taskId : String(taskRef ?? ''),
+                taskRef: resolved.taskId,
                 ticketId: parsedDecision.overrideTicket,
                 failureId: failureId('decision-intent', current.error?.code ?? 'TASK_STATE_MISMATCH'),
                 target: parsedDecision.overrideTarget,
@@ -134,9 +120,7 @@ export async function decide(args, options = {}) {
                 throw new Error(consumed.error.message);
             return current;
         };
-        result = resolved?.ok
-            ? withTaskExecutionLock(resolved.repoRoot, resolved.taskId, 'task-decision', execute)
-            : execute();
+        result = withTaskExecutionLock(resolved.repoRoot, resolved.taskId, 'task-decision', execute);
         if (result.error)
             throw new Error(result.error.message);
         return 0;

package/dist/lib/defaults.json

@@ -90,6 +90,10 @@
         ],
         "ejected": [],
         "retiredManaged": [
+            {
+                "path": ".trae/skills/",
+                "templateHashes": []
+            },
             {
                 "path": ".agents/workspace/README.md",
                 "templateHashes": [

package/dist/lib/init.js

@@ -71,7 +71,7 @@ async function cmdInit() {
     // check existing config
     if (fs.existsSync(configPath)) {
         err('This project already has agent-infra configuration.');
-        err('Use /update-agent-infra in your AI TUI to update.');
+        err('Use /update-agent-infra in your AI TUI to sync project files.');
         process.exitCode = 1;
         return;
     }
@@ -214,7 +214,7 @@ async function cmdInit() {
     console.log('');
     ok('Project initialized successfully!');
     console.log('');
-    console.log('  If this init used npx, install agent-infra persistently before update or validation:');
+    console.log('  If this init used npx, install agent-infra persistently before ai update or validation:');
     console.log('    npm install -g @fitlab-ai/agent-infra');
     console.log('');
     if (workflowPlan.nextSteps.length === 0) {

package/dist/lib/internal/release-workflow.js

@@ -21,7 +21,6 @@ const DEMO_INPUT_PATHS = [
     'lib/prompt.ts',
     'lib/paths.ts',
     'lib/render.ts',
-    'lib/builtin-tuis.ts',
     'lib/sandbox/engines/'
 ];
 const DEMO_DIGEST_PATH = 'assets/demo-init.inputs.sha256';