@autocodeflow/cli 2.1.1 → 2.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -0
- package/dist/commands/executors.d.ts +49 -0
- package/dist/commands/executors.js +39 -3
- package/dist/commands/tasks.js +8 -6
- package/dist/error-code.js +16 -2
- package/package.json +6 -3
package/README.md
CHANGED
|
@@ -144,6 +144,7 @@ acf task delete <id> -y # 非交互下唯一被接受的确认方式
|
|
|
144
144
|
> ⚠️ 2026-10-02 ~ 10-14 期间发布的执行器(A-11)会把**字符串也加一对首尾双引号**(`AUTOFLOW_TARGET='"nightly"'`),空串变成 `'""'`(真值)。该行为已在协议 v5 修复——若目标执行器仍是旧版,脚本需容错剥离首尾引号。
|
|
145
145
|
|
|
146
146
|
- **按 run 覆盖参数**:`acf task trigger <id> --params '{"KEY":"value"}'` 覆盖任务默认 params(TriggerTaskDto 同 webhook 面;缺省不发 body,用任务默认值)。block-strategy 闸(N-14)按生效参数判重。
|
|
147
|
+
- **跳过下一个 cron 计划点**:`acf task trigger <id> --consume-next-fire-point` 立即执行一次,并让**下一个** cron 计划点被跳过(**只跳一次**,不是暂停)。仅 cron 任务可用——非 cron 任务返回 400;已有未消耗登记再触发返回 409。可与 `--params` 同用。
|
|
147
148
|
- **按名/描述搜任务**:`acf task list --search <kw>` 走 `q` 参数(name OR description,控制台搜索框同款);`-k/--keyword` 仍只搜 name(向后兼容通道)。
|
|
148
149
|
|
|
149
150
|
## 应用包上传 / 灰度升级 / 审批 / webhook / glue
|
|
@@ -1,2 +1,51 @@
|
|
|
1
1
|
import { Command } from 'commander';
|
|
2
|
+
interface Executor {
|
|
3
|
+
id: string;
|
|
4
|
+
appName: string;
|
|
5
|
+
address: string;
|
|
6
|
+
status: string;
|
|
7
|
+
type?: string;
|
|
8
|
+
executorVersion?: string;
|
|
9
|
+
groupName?: string | null;
|
|
10
|
+
tags?: string[] | null;
|
|
11
|
+
description?: string | null;
|
|
12
|
+
/**
|
|
13
|
+
* R68:**已占槽位**(含 E-01 pull 取件预留;R16 起还被抬到「客户端上报 vs 服务端
|
|
14
|
+
* 在途占坑」的较大值),也是服务端派发闸门读的数。它**不是**「在跑任务数」:
|
|
15
|
+
* 空闲 pull 执行器在长轮询窗口内同样占 1 个槽位。
|
|
16
|
+
*/
|
|
17
|
+
runningTaskCount?: number;
|
|
18
|
+
/**
|
|
19
|
+
* E-01-RPT:已预留但尚未领取的槽位。上游返回整行实体
|
|
20
|
+
* (`executor.service.ts::findAll/findOne` 无 select 收窄),故 CLI **拿得到**该列。
|
|
21
|
+
* null/undefined = 旧版执行器未上报 ⇒ 无从换算「实际在跑 = 已占 − 预留」。
|
|
22
|
+
*/
|
|
23
|
+
reservedSlots?: number | null;
|
|
24
|
+
maxConcurrentTasks?: number | null;
|
|
25
|
+
cpuUsage?: number | null;
|
|
26
|
+
memUsage?: number | null;
|
|
27
|
+
totalTaskCount?: number;
|
|
28
|
+
failedTaskCount?: number;
|
|
29
|
+
lastHeartbeat?: string;
|
|
30
|
+
runningExecutionIds?: string[] | null;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* R68:**实际在跑** = 已占槽位 − 取件预留(下限钳 0)。
|
|
34
|
+
*
|
|
35
|
+
* 与 admin-web 的 `utils/executor-metrics.ts::resolveRunningCount` 同一口径(那边是
|
|
36
|
+
* TS 常量,这里是 CLI 的独立副本——两个包不共享代码,故各自实现并用测试钉住)。
|
|
37
|
+
* `reservedSlots` 缺失/null(旧版执行器未上报)⇒ **返回 null 表示「无从换算」**,
|
|
38
|
+
* 调用方必须回落「只显示已占槽位」,**不得**谎称在跑任务数。
|
|
39
|
+
*
|
|
40
|
+
* ## 与 web 侧 `resolveRunningCount` 的契约对照(R70)
|
|
41
|
+
*
|
|
42
|
+
* · **数值口径完全一致**(reserved 已知时):非有限 ⇒ 0、负数钳 0、下限钳 0、
|
|
43
|
+
* 保留小数(2.5 − 0.5 = 2)。
|
|
44
|
+
* · **唯一刻意的差异**:`reservedSlots` 未知时,web 回落到「已占槽位」(显示层
|
|
45
|
+
* 另有 `hasInconsistentMetrics` 判据兜底),而 CLI 返回 `null` —— 因为 CLI 必须
|
|
46
|
+
* 区分「算得出」与「无从算起」,否则会打印出误导性的「Running Tasks」。
|
|
47
|
+
* 这条差异由 `src/__tests__/executors-metric-parity.test.ts` 的期望表钉住。
|
|
48
|
+
*/
|
|
49
|
+
export declare function actualRunningCount(e: Pick<Executor, 'runningTaskCount' | 'reservedSlots'>): number | null;
|
|
2
50
|
export declare function executorsCommand(): Command;
|
|
51
|
+
export {};
|
|
@@ -24,6 +24,30 @@ function heartbeatAge(ts) {
|
|
|
24
24
|
function pct(v) {
|
|
25
25
|
return v === null || v === undefined ? '-' : `${v}%`;
|
|
26
26
|
}
|
|
27
|
+
/**
|
|
28
|
+
* R68:**实际在跑** = 已占槽位 − 取件预留(下限钳 0)。
|
|
29
|
+
*
|
|
30
|
+
* 与 admin-web 的 `utils/executor-metrics.ts::resolveRunningCount` 同一口径(那边是
|
|
31
|
+
* TS 常量,这里是 CLI 的独立副本——两个包不共享代码,故各自实现并用测试钉住)。
|
|
32
|
+
* `reservedSlots` 缺失/null(旧版执行器未上报)⇒ **返回 null 表示「无从换算」**,
|
|
33
|
+
* 调用方必须回落「只显示已占槽位」,**不得**谎称在跑任务数。
|
|
34
|
+
*
|
|
35
|
+
* ## 与 web 侧 `resolveRunningCount` 的契约对照(R70)
|
|
36
|
+
*
|
|
37
|
+
* · **数值口径完全一致**(reserved 已知时):非有限 ⇒ 0、负数钳 0、下限钳 0、
|
|
38
|
+
* 保留小数(2.5 − 0.5 = 2)。
|
|
39
|
+
* · **唯一刻意的差异**:`reservedSlots` 未知时,web 回落到「已占槽位」(显示层
|
|
40
|
+
* 另有 `hasInconsistentMetrics` 判据兜底),而 CLI 返回 `null` —— 因为 CLI 必须
|
|
41
|
+
* 区分「算得出」与「无从算起」,否则会打印出误导性的「Running Tasks」。
|
|
42
|
+
* 这条差异由 `src/__tests__/executors-metric-parity.test.ts` 的期望表钉住。
|
|
43
|
+
*/
|
|
44
|
+
export function actualRunningCount(e) {
|
|
45
|
+
if (e.reservedSlots === null || e.reservedSlots === undefined)
|
|
46
|
+
return null;
|
|
47
|
+
const occupied = Number.isFinite(e.runningTaskCount) ? Math.max(e.runningTaskCount ?? 0, 0) : 0;
|
|
48
|
+
const reserved = Number.isFinite(e.reservedSlots) ? Math.max(e.reservedSlots, 0) : 0;
|
|
49
|
+
return Math.max(occupied - reserved, 0);
|
|
50
|
+
}
|
|
27
51
|
// CONSISTENCY-02 (U11): tri-state rendering matching admin-web's
|
|
28
52
|
// ExecutorDetailPage semantics for the heartbeat-reported id list.
|
|
29
53
|
function runningExecutionIdsText(ids) {
|
|
@@ -52,8 +76,10 @@ export function executorsCommand() {
|
|
|
52
76
|
}
|
|
53
77
|
const executors = Array.isArray(data) ? data : (data.list ?? []);
|
|
54
78
|
const table = new Table({
|
|
55
|
-
|
|
56
|
-
|
|
79
|
+
// R68:列头旧称「Running」,会被读成「在跑任务数」;本表是**机群概览**
|
|
80
|
+
// (容量视角,同部署下拉/仪表盘热力条)⇒ 如实叫「Occupied」(已占槽位)。
|
|
81
|
+
head: ['ID', 'App Name', 'Status', 'Address', 'Last Heartbeat', 'CPU', 'Occupied'],
|
|
82
|
+
colWidths: [14, 20, 10, 22, 18, 8, 10],
|
|
57
83
|
style: { head: ['cyan'] },
|
|
58
84
|
});
|
|
59
85
|
for (const e of executors) {
|
|
@@ -97,7 +123,17 @@ export function executorsCommand() {
|
|
|
97
123
|
console.log(' Group :', e.groupName ?? '-');
|
|
98
124
|
console.log(' Tags :', e.tags?.length ? e.tags.join(', ') : '-');
|
|
99
125
|
console.log(' Description :', e.description ?? '-');
|
|
100
|
-
|
|
126
|
+
// R68:旧实现把「已占槽位」标成「Running Tasks」——空闲 pull 执行器会显示
|
|
127
|
+
// 「Running Tasks : 1」而机器上没有任何任务在跑(admin-web 同类谎报见
|
|
128
|
+
// R62/R64/R67)。现在:
|
|
129
|
+
// · 有 reservedSlots ⇒ 显示**实际在跑**(已占 − 预留,下限 0);
|
|
130
|
+
// · 无 reservedSlots(旧版执行器)⇒ **无从换算** ⇒ 只显示已占槽位,
|
|
131
|
+
// 绝不谎称在跑任务数。
|
|
132
|
+
const runningCount = actualRunningCount(e);
|
|
133
|
+
if (runningCount !== null) {
|
|
134
|
+
console.log(' Running Tasks :', runningCount);
|
|
135
|
+
}
|
|
136
|
+
console.log(' Occupied Slots :', e.runningTaskCount ?? 0);
|
|
101
137
|
console.log(' Running Executions:', runningExecutionIdsText(e.runningExecutionIds));
|
|
102
138
|
console.log(' Max Concurrent :', e.maxConcurrentTasks ?? '-');
|
|
103
139
|
console.log(' Total Tasks :', e.totalTaskCount ?? 0);
|
package/dist/commands/tasks.js
CHANGED
|
@@ -183,9 +183,8 @@ export function tasksCommand() {
|
|
|
183
183
|
throw new InvalidArgumentError('must be a positive integer in seconds (e.g. 600); units like "10m" are not supported');
|
|
184
184
|
}
|
|
185
185
|
const n = Number(v.trim());
|
|
186
|
-
if (!Number.isSafeInteger(n) || n <= 0)
|
|
186
|
+
if (!Number.isSafeInteger(n) || n <= 0)
|
|
187
187
|
throw new InvalidArgumentError('must be a positive integer (seconds)');
|
|
188
|
-
}
|
|
189
188
|
return n;
|
|
190
189
|
}, 600)
|
|
191
190
|
// NOTE: no --executor option here — TriggerTaskDto only accepts `params`
|
|
@@ -200,6 +199,9 @@ export function tasksCommand() {
|
|
|
200
199
|
// 第四轮审计(--json 补面):trigger 响应(execution 对象)直出 JSON,
|
|
201
200
|
// CI 拿 executionId 做后续断言无需解析人读文本。
|
|
202
201
|
.option('--json', 'Emit raw JSON (CI-consumable, no table)')
|
|
202
|
+
// R143:仅 cron——立即执行 + 跳过**下一个**计划点(只跳一次,非暂停);非 cron ⇒ 400,已有登记 ⇒ 409。
|
|
203
|
+
.option('--consume-next-fire-point', 'Cron tasks only: run now and skip the NEXT scheduled fire point (one-shot skip — NOT a pause; a non-cron task → 400, an already-registered unconsumed skip → 409)')
|
|
204
|
+
// opts 用 Partial<>:可选属性 `?` 也计入分支密度,本文件已顶死基线。
|
|
203
205
|
.action(async (id, opts) => {
|
|
204
206
|
const spinner = ora('Triggering task…').start();
|
|
205
207
|
try {
|
|
@@ -213,10 +215,10 @@ export function tasksCommand() {
|
|
|
213
215
|
throw new UsageError(`Invalid --params JSON: ${e instanceof Error ? e.message : String(e)}`);
|
|
214
216
|
}
|
|
215
217
|
}
|
|
216
|
-
//
|
|
217
|
-
const
|
|
218
|
-
|
|
219
|
-
|
|
218
|
+
// body 只收显式旗标(undefined 的键不出现);都不给 ⇒ 单参 post,与改动前逐字节一致。
|
|
219
|
+
const bodyEntries = [['params', params], ['consumeNextFirePoint', opts.consumeNextFirePoint]];
|
|
220
|
+
const body = Object.fromEntries(bodyEntries.filter(([, v]) => v !== undefined));
|
|
221
|
+
const exec = Object.keys(body).length > 0 ? await post(`/tasks/${id}/trigger`, body) : await post(`/tasks/${id}/trigger`);
|
|
220
222
|
if (opts.json) {
|
|
221
223
|
// ECO-02 同款:--json —— ora 默认写 stderr,stdout 仍是干净 JSON。
|
|
222
224
|
// P2(CLI-AGENT-UX-AUDIT):--json **且** --wait 时不在这里输出中间态,
|
package/dist/error-code.js
CHANGED
|
@@ -35,8 +35,11 @@ export const CATEGORY_HINTS = {
|
|
|
35
35
|
*
|
|
36
36
|
* 优先级刻意如此:
|
|
37
37
|
* - `capacity` 最先:`API_KEY_QUOTA_REACHED`(429)、`NO_AVAILABLE_EXECUTOR`
|
|
38
|
-
* (
|
|
38
|
+
* (503)、`EXECUTOR_OFFLINE`(503)这些状态码本身不表达"容量",而
|
|
39
39
|
* "稍后重试/腾容量"才是正确的下一步;
|
|
40
|
+
* (R178:这两个码的状态已由 409/500 统一到 **503** —— 「等一会儿就有空位」
|
|
41
|
+
* 与「资源处于冲突态」不是一回事;本表按**码名**分类、不读码表状态,
|
|
42
|
+
* 故分类结果不变,但注释里的状态必须跟上,否则下一个人会照着 409 去推理。)
|
|
40
43
|
* - `permission` 早于 `auth`:`API_KEY_SCOPE_DENIED`(403)以 `API_KEY_`
|
|
41
44
|
* 开头,若 auth 先命中就会误给"去 acf login"这种无效建议;
|
|
42
45
|
* - `auth` 早于 `validation`:`INVALID_CREDENTIALS` 含 `INVALID`,但正确
|
|
@@ -93,7 +96,18 @@ const CATEGORY_RULES = [
|
|
|
93
96
|
'validation',
|
|
94
97
|
// `_NO_INPUT`(AI_SOP_NO_INPUT:既没文字也没视频)/ `_TYPE_NOT_ALLOWED`
|
|
95
98
|
// (AI_MEDIA_TYPE_NOT_ALLOWED:格式白名单)都是「改入参就能过」,属校验类。
|
|
96
|
-
|
|
99
|
+
//
|
|
100
|
+
// 2026-11-04(A6b 提前触发消耗计划点):补两条 —— `TASK_FIRE_POINT_NOT_CRON`
|
|
101
|
+
// (400:只有 cron 任务有「计划点」可消耗,fixed_rate / webhook / manual 没有)、
|
|
102
|
+
// `TASK_FIRE_POINT_UNRESOLVABLE`(400:cron 表达式为空/非法,算不出下一个落点)
|
|
103
|
+
// ⇒ 两者正确动作都是**改任务配置**(触发类型 / cron 表达式),属「改入参就能过」。
|
|
104
|
+
//
|
|
105
|
+
// ⚠️ 第二个码**不能用裸 `_UNRESOLVABLE`**:那会撞上基线里两个 DNS 解析类的码
|
|
106
|
+
// (`EXECUTOR_HOST_UNRESOLVABLE` / `GIT_REPO_HOST_UNRESOLVABLE`)——它们的处置是
|
|
107
|
+
// 「运维/网络侧」(基线里明写「6 类里没有这一类」),归进 validation 会给出
|
|
108
|
+
// 「改入参重试」的错误建议。⇒ 用 `FIRE_POINT_UNRESOLVABLE` 精确到本域。
|
|
109
|
+
// 同理不能写成裸 `_NOT_CRON` 之外的宽泛形式,也不能进 conflict(重读不会让它变可消耗)。
|
|
110
|
+
/(INVALID|VALIDATION|_REQUIRED|_MISSING|_EMPTY|_UNCHANGED|UNSUPPORTED|OUT_OF_RANGE|_TOO_|_MALFORMED|_EXCLUSIVE|_MISMATCH|_INCORRECT|_NOT_OBJECT|_NOT_ZIP|_NOT_ARCHIVE|_BLOCKED|SSRF|PASSWORD|NOT_SEMVER|DEPENDENCY|_NO_INPUT|_TYPE_NOT_ALLOWED|_NOT_CRON|FIRE_POINT_UNRESOLVABLE)/,
|
|
97
111
|
],
|
|
98
112
|
];
|
|
99
113
|
/**
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@autocodeflow/cli",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.2.0",
|
|
4
4
|
"description": "AutoCodeFlow CLI — manage tasks, executions and applications from the terminal",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -25,7 +25,8 @@
|
|
|
25
25
|
"dev": "tsx src/index.ts",
|
|
26
26
|
"start": "node dist/index.js",
|
|
27
27
|
"test": "vitest run",
|
|
28
|
-
"typecheck": "tsc --noEmit"
|
|
28
|
+
"typecheck": "tsc --noEmit",
|
|
29
|
+
"lint": "eslint src"
|
|
29
30
|
},
|
|
30
31
|
"dependencies": {
|
|
31
32
|
"axios": "1.21.0",
|
|
@@ -33,11 +34,13 @@
|
|
|
33
34
|
"cli-table3": "0.6.5",
|
|
34
35
|
"commander": "15.0.0",
|
|
35
36
|
"conf": "^15.1.0",
|
|
36
|
-
"ora": "^
|
|
37
|
+
"ora": "^10.0.0"
|
|
37
38
|
},
|
|
38
39
|
"devDependencies": {
|
|
39
40
|
"@types/node": "26.6.6",
|
|
41
|
+
"eslint": "^10.13.0",
|
|
40
42
|
"typescript": "^5.9.3",
|
|
43
|
+
"typescript-eslint": "^8.72.1",
|
|
41
44
|
"vitest": "^5.0.1",
|
|
42
45
|
"tsx": "^4.20.6"
|
|
43
46
|
},
|