shoplazza-ai-dev-cli 0.1.21 → 0.1.22-snapshot.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.
@@ -0,0 +1,1653 @@
1
+ import { a as SESSION_ASK_PATH, c as SESSION_TASK_PATH, l as SESSION_TOKEN_HEADER, n as ENV_RUNNER_URL, o as SESSION_BROWSER_PATH, r as ENV_SESSION_TOKEN, s as SESSION_SUBMIT_PATH, t as ENV_OUTPUT_SCHEMA } from "./executor.mjs";
2
+ import { request } from "node:http";
3
+ import { readFile, writeFile } from "node:fs/promises";
4
+ function defaultIO() {
5
+ return {
6
+ env: process.env,
7
+ out: (l) => process.stdout.write(l + "\n"),
8
+ err: (l) => process.stderr.write(l + "\n"),
9
+ fetch: globalThis.fetch
10
+ };
11
+ }
12
+ const EXIT_OK = 0;
13
+ const EXIT_REJECTED = 1;
14
+ const EXIT_USAGE = 2;
15
+ async function readJSON(file, io) {
16
+ if (!file) {
17
+ io.err("usage: af submit|ask <file>");
18
+ return;
19
+ }
20
+ try {
21
+ return JSON.parse(await readFile(file, "utf8"));
22
+ } catch (err) {
23
+ io.err(`cannot read ${file} as JSON: ${String(err)}`);
24
+ return;
25
+ }
26
+ }
27
+ async function forward(path, file, io) {
28
+ const body = await readJSON(file, io);
29
+ if (body === void 0) return EXIT_USAGE;
30
+ return post(path, body, io);
31
+ }
32
+ function isEnvelope(v) {
33
+ return typeof v === "object" && v !== null && typeof v.schema === "string" && "payload" in v;
34
+ }
35
+ async function outputSchemaName(io) {
36
+ const file = io.env[ENV_OUTPUT_SCHEMA];
37
+ if (!file) return "";
38
+ try {
39
+ const schema = JSON.parse(await readFile(file, "utf8"));
40
+ return typeof schema.title === "string" ? schema.title : "";
41
+ } catch {
42
+ return "";
43
+ }
44
+ }
45
+ async function post(path, body, io) {
46
+ const base = io.env[ENV_RUNNER_URL];
47
+ const token = io.env[ENV_SESSION_TOKEN];
48
+ if (!base || !token) {
49
+ io.err(`not inside a forge runner session: ${ENV_RUNNER_URL} / ${ENV_SESSION_TOKEN} missing`);
50
+ return EXIT_USAGE;
51
+ }
52
+ const res = await io.fetch(base.replace(/\/$/, "") + path, {
53
+ method: "POST",
54
+ headers: {
55
+ "content-type": "application/json",
56
+ [SESSION_TOKEN_HEADER]: token
57
+ },
58
+ body: JSON.stringify(body)
59
+ });
60
+ const text = await res.text();
61
+ if (res.ok) {
62
+ io.out(text || "{\"code\":\"ok\"}");
63
+ return EXIT_OK;
64
+ }
65
+ io.err(text || `request failed: ${res.status}`);
66
+ return res.status === 400 || res.status === 422 || res.status === 409 ? EXIT_REJECTED : EXIT_USAGE;
67
+ }
68
+ async function afSubmit(file, io = defaultIO()) {
69
+ const content = await readJSON(file, io);
70
+ if (content === void 0) return EXIT_USAGE;
71
+ if (isEnvelope(content)) return post(SESSION_SUBMIT_PATH, content, io);
72
+ const schema = await outputSchemaName(io);
73
+ if (!schema) {
74
+ io.err(`this node has no output schema (${ENV_OUTPUT_SCHEMA} missing); nothing to submit`);
75
+ return EXIT_USAGE;
76
+ }
77
+ return post(SESSION_SUBMIT_PATH, {
78
+ schema,
79
+ payload: content
80
+ }, io);
81
+ }
82
+ function afAsk(file, io = defaultIO()) {
83
+ return forward(SESSION_ASK_PATH, file, io);
84
+ }
85
+ function afBrowser(args, io = defaultIO()) {
86
+ const [op, ...values] = args;
87
+ let body;
88
+ switch (op) {
89
+ case "snapshot":
90
+ if (values.length === 0) body = { op };
91
+ break;
92
+ case "navigate":
93
+ if (values.length === 1 && /^https?:\/\//.test(values[0])) body = {
94
+ op,
95
+ url: values[0]
96
+ };
97
+ break;
98
+ case "click": {
99
+ const coordinates = values.map(Number);
100
+ if (coordinates.length === 2 && coordinates.every((n) => Number.isInteger(n) && n >= 0)) body = {
101
+ op,
102
+ x: coordinates[0],
103
+ y: coordinates[1]
104
+ };
105
+ break;
106
+ }
107
+ case "scroll":
108
+ if (values.length === 1 && Number.isInteger(Number(values[0]))) body = {
109
+ op,
110
+ delta_y: Number(values[0])
111
+ };
112
+ break;
113
+ case "type":
114
+ if (values.length === 1 && values[0]) body = {
115
+ op,
116
+ text: values[0]
117
+ };
118
+ break;
119
+ case "key":
120
+ if (values.length === 1 && values[0]) body = {
121
+ op,
122
+ key: values[0]
123
+ };
124
+ break;
125
+ }
126
+ if (!body) {
127
+ io.err("usage: af browser snapshot|navigate <url>|click <x> <y>|scroll <delta>|type <text>|key <key>");
128
+ return Promise.resolve(EXIT_USAGE);
129
+ }
130
+ return post(SESSION_BROWSER_PATH, body, io);
131
+ }
132
+ function afTask(args, io = defaultIO()) {
133
+ const [action, taskNo] = args;
134
+ if (!action || !taskNo || ![
135
+ "status",
136
+ "pause",
137
+ "resume"
138
+ ].includes(action)) {
139
+ io.err("usage: af task status|pause|resume <task_no>");
140
+ return Promise.resolve(EXIT_USAGE);
141
+ }
142
+ return post(SESSION_TASK_PATH, {
143
+ action,
144
+ task_no: taskNo
145
+ }, io);
146
+ }
147
+ const CALL_TIMEOUT_MS = 33e4;
148
+ const nodeTransport = (call) => new Promise((resolve, reject) => {
149
+ const req = request(call.url, {
150
+ method: call.method,
151
+ headers: call.headers,
152
+ timeout: call.timeoutMs
153
+ }, (res) => {
154
+ const chunks = [];
155
+ res.on("data", (c) => chunks.push(c));
156
+ res.on("end", () => {
157
+ const data = Buffer.concat(chunks);
158
+ resolve({
159
+ status: res.statusCode ?? 0,
160
+ text: data.toString("utf8"),
161
+ ...call.wantBytes ? { data } : {}
162
+ });
163
+ });
164
+ res.on("error", reject);
165
+ });
166
+ req.on("timeout", () => {
167
+ const e = /* @__PURE__ */ new Error(`no response within ${call.timeoutMs}ms`);
168
+ e.name = "TimeoutError";
169
+ req.destroy(e);
170
+ });
171
+ req.on("error", reject);
172
+ req.end(call.body);
173
+ });
174
+ const HTTP_GATEWAY_TIMEOUT = 504;
175
+ const HTTP_BAD_REQUEST = 400;
176
+ const HTTP_CONFLICT = 409;
177
+ const HTTP_UNPROCESSABLE = 422;
178
+ const TIMEOUT_HINT = "请求超时:平台长时间没有返回(单次最长约 5 分钟),请缩小范围后重试,或稍后再试。";
179
+ const TIMEOUT_NAMES = new Set(["TimeoutError", "AbortError"]);
180
+ const TIMEOUT_CODES = new Set([
181
+ "UND_ERR_HEADERS_TIMEOUT",
182
+ "UND_ERR_BODY_TIMEOUT",
183
+ "ETIMEDOUT"
184
+ ]);
185
+ async function callSession(method, path, body, io, wantBytes = false) {
186
+ const base = io.env[ENV_RUNNER_URL];
187
+ const token = io.env[ENV_SESSION_TOKEN];
188
+ if (!base || !token) {
189
+ io.err(`not inside a forge runner session: ${ENV_RUNNER_URL} / ${ENV_SESSION_TOKEN} missing`);
190
+ return { exit: EXIT_USAGE };
191
+ }
192
+ try {
193
+ const res = await (io.transport ?? nodeTransport)({
194
+ method,
195
+ url: base.replace(/\/$/, "") + path,
196
+ headers: {
197
+ [SESSION_TOKEN_HEADER]: token,
198
+ ...body === void 0 ? {} : { "content-type": "application/json" }
199
+ },
200
+ body,
201
+ timeoutMs: io.timeoutMs ?? CALL_TIMEOUT_MS,
202
+ ...wantBytes ? { wantBytes } : {}
203
+ });
204
+ if (res.status === HTTP_GATEWAY_TIMEOUT) {
205
+ io.err(TIMEOUT_HINT);
206
+ return { exit: EXIT_REJECTED };
207
+ }
208
+ return res;
209
+ } catch (err) {
210
+ if (isTimeout(err)) {
211
+ io.err(TIMEOUT_HINT);
212
+ return { exit: EXIT_REJECTED };
213
+ }
214
+ io.err(`无法连接本机 runner 守护进程(${ENV_RUNNER_URL}),请确认 runner 在运行:${String(err)}`);
215
+ return { exit: EXIT_USAGE };
216
+ }
217
+ }
218
+ function failureExit(status) {
219
+ return status === HTTP_BAD_REQUEST || status === HTTP_CONFLICT || status === HTTP_UNPROCESSABLE ? EXIT_REJECTED : EXIT_USAGE;
220
+ }
221
+ function isOK(status) {
222
+ return status >= 200 && status < 300;
223
+ }
224
+ function reportFailure(reply, io) {
225
+ io.err(reply.text || `request failed: ${reply.status}`);
226
+ return failureExit(reply.status);
227
+ }
228
+ function unwrapData(text) {
229
+ try {
230
+ const data = JSON.parse(text)?.data;
231
+ return typeof data === "object" && data !== null && !Array.isArray(data) ? data : void 0;
232
+ } catch {
233
+ return;
234
+ }
235
+ }
236
+ function isTimeout(err) {
237
+ for (let e = err; e instanceof Error; e = e.cause) {
238
+ const code = e.code;
239
+ if (TIMEOUT_NAMES.has(e.name) || typeof code === "string" && TIMEOUT_CODES.has(code)) return true;
240
+ }
241
+ return false;
242
+ }
243
+ const SESSION_TASK_DRAFTS_PATH = "/session/task-drafts";
244
+ const REQUIRED_FIELDS = [
245
+ "title",
246
+ "module_id",
247
+ "summary",
248
+ "kind",
249
+ "feishu_mode"
250
+ ];
251
+ const ID_FLAG = "--id";
252
+ const USAGE$1 = "usage: af task draft <file> [--id <draft_id>]";
253
+ async function afTaskDraft(args, io) {
254
+ const parsed = parseArgs$1(args);
255
+ if (typeof parsed === "string") {
256
+ io.err(parsed);
257
+ return EXIT_USAGE;
258
+ }
259
+ const draft = await readDraft(parsed.file, io);
260
+ if (draft === void 0) return EXIT_USAGE;
261
+ const problems = REQUIRED_FIELDS.filter((f) => !validField(draft[f]));
262
+ if (problems.length > 0) {
263
+ io.err(`draft file is missing required fields: ${problems.join(", ")} (all must be non-empty strings; ids must be quoted strings)`);
264
+ return EXIT_USAGE;
265
+ }
266
+ const imprecise = impreciseIDFields(draft, parsed.id !== void 0);
267
+ if (imprecise.length > 0) {
268
+ io.err(`ids must be quoted strings, not JSON numbers (a number above 2^53 is silently altered by JSON parsing): ${imprecise.join(", ")}`);
269
+ return EXIT_USAGE;
270
+ }
271
+ const body = parsed.id === void 0 ? draft : {
272
+ ...draft,
273
+ draft_id: parsed.id
274
+ };
275
+ const reply = await callSession("POST", SESSION_TASK_DRAFTS_PATH, JSON.stringify(body), io);
276
+ if ("exit" in reply) return reply.exit;
277
+ if (!isOK(reply.status)) return reportFailure(reply, io);
278
+ io.out(summarize(reply.text));
279
+ return EXIT_OK;
280
+ }
281
+ function parseArgs$1(args) {
282
+ let file;
283
+ let id;
284
+ for (let i = 0; i < args.length; i++) {
285
+ const a = args[i];
286
+ if (a === ID_FLAG) {
287
+ id = args[++i];
288
+ if (id === void 0 || id === "" || id.startsWith("--")) return `${ID_FLAG} needs a draft id; ${USAGE$1}`;
289
+ } else if (a.startsWith(`${ID_FLAG}=`)) {
290
+ id = a.slice(5);
291
+ if (id === "") return `${ID_FLAG} needs a draft id; ${USAGE$1}`;
292
+ } else if (a.startsWith("--")) return `unknown option ${a}; ${USAGE$1}`;
293
+ else if (file === void 0) file = a;
294
+ else return `unexpected argument ${a}; ${USAGE$1}`;
295
+ }
296
+ return file === void 0 ? USAGE$1 : {
297
+ file,
298
+ id
299
+ };
300
+ }
301
+ async function readDraft(file, io) {
302
+ let parsed;
303
+ try {
304
+ parsed = JSON.parse(await readFile(file, "utf8"));
305
+ } catch (err) {
306
+ io.err(`cannot read ${file} as JSON: ${String(err)}`);
307
+ return;
308
+ }
309
+ if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
310
+ io.err(`${file} must contain a JSON object (task_draft.v1)`);
311
+ return;
312
+ }
313
+ return parsed;
314
+ }
315
+ function impreciseIDFields(draft, idOverridden) {
316
+ const bad = [];
317
+ if (!idOverridden && draft.draft_id !== void 0 && typeof draft.draft_id !== "string") bad.push("draft_id");
318
+ if (draft.workflow_id !== void 0 && typeof draft.workflow_id !== "string") bad.push("workflow_id");
319
+ const repos = draft.repo_ids;
320
+ if (repos !== void 0 && !(Array.isArray(repos) && repos.every((r) => typeof r === "string"))) bad.push("repo_ids");
321
+ return bad;
322
+ }
323
+ function validField(value) {
324
+ return typeof value === "string" && value.trim() !== "";
325
+ }
326
+ function summarize(text) {
327
+ const data = unwrapData(text);
328
+ if (data !== void 0 && "draft_id" in data && "card_id" in data && "version" in data) return JSON.stringify({
329
+ draft_id: data.draft_id,
330
+ card_id: data.card_id,
331
+ version: data.version
332
+ });
333
+ return text || "{\"code\":\"ok\"}";
334
+ }
335
+ const PAGE_SLUG_RE = /^[a-z0-9][a-z0-9_-]*$/;
336
+ const ALL_DIGITS_RE = /^[0-9]+$/;
337
+ const PAGE_SLUG_MAX_LEN = 64;
338
+ const BASE_SLUG_RE = /^[a-z0-9][a-z0-9-]*$/;
339
+ const BASE_SLUG_MAX_LEN = 64;
340
+ const VERSION_RE = /^(d(0|[1-9]\d*)|[1-9]\d*)$/;
341
+ const REF_HELP = "引用格式:页面 id,或 <库 slug>:<路径>(路径是祖先 slug 用 / 拼接,如 work:flow/apollo-key)";
342
+ function isPageSlug(s) {
343
+ return s.length <= PAGE_SLUG_MAX_LEN && PAGE_SLUG_RE.test(s) && !ALL_DIGITS_RE.test(s);
344
+ }
345
+ function parseRef(text) {
346
+ if (ALL_DIGITS_RE.test(text)) return {
347
+ kind: "id",
348
+ raw: text
349
+ };
350
+ const colon = text.indexOf(":");
351
+ const slug = colon < 0 ? "" : text.slice(0, colon);
352
+ const path = colon < 0 ? "" : text.slice(colon + 1);
353
+ return slug.length <= BASE_SLUG_MAX_LEN && BASE_SLUG_RE.test(slug) && path !== "" && path.split("/").every(isPageSlug) ? {
354
+ kind: "path",
355
+ raw: text
356
+ } : `页面引用 ${JSON.stringify(text)} 不合法。${REF_HELP}`;
357
+ }
358
+ function parseVersion(v) {
359
+ return VERSION_RE.test(v);
360
+ }
361
+ function parseOutput(args) {
362
+ const rest = [];
363
+ let output = "table";
364
+ for (let i = 0; i < args.length; i++) {
365
+ const a = args[i];
366
+ let value;
367
+ if (a === "--") {
368
+ rest.push(...args.slice(i));
369
+ break;
370
+ }
371
+ if (a === "--output" || a === "-o") value = args[++i] ?? "";
372
+ else if (a.startsWith("--output=")) value = a.slice(9);
373
+ else {
374
+ rest.push(a);
375
+ continue;
376
+ }
377
+ if (value !== "table" && value !== "json") return `--output 只能是 table 或 json(收到 ${JSON.stringify(value)})`;
378
+ output = value;
379
+ }
380
+ return {
381
+ output,
382
+ rest
383
+ };
384
+ }
385
+ function parseArgs(args, spec) {
386
+ const bools = spec.bools ?? [];
387
+ const known = new Set([...spec.values, ...bools]);
388
+ const pos = [];
389
+ const flags = /* @__PURE__ */ new Map();
390
+ const fail = (msg) => `${msg};${spec.usage}`;
391
+ for (let i = 0; i < args.length; i++) {
392
+ const a = args[i];
393
+ if (a === "--") {
394
+ pos.push(...args.slice(i + 1));
395
+ break;
396
+ }
397
+ if (!a.startsWith("--")) {
398
+ pos.push(a);
399
+ continue;
400
+ }
401
+ const eq = a.indexOf("=");
402
+ const name = eq < 0 ? a.slice(2) : a.slice(2, eq);
403
+ if (!known.has(name)) return fail(`未知选项 --${name}`);
404
+ if (flags.has(name)) return fail(`--${name} 重复了`);
405
+ if (bools.includes(name)) {
406
+ if (eq >= 0) return fail(`--${name} 不带值`);
407
+ flags.set(name, "true");
408
+ continue;
409
+ }
410
+ const value = eq < 0 ? args[++i] : a.slice(eq + 1);
411
+ if (value === void 0 || eq < 0 && value.startsWith("--") && known.has(value.slice(2))) return fail(`--${name} 需要一个值`);
412
+ flags.set(name, value);
413
+ }
414
+ if (pos.length < spec.min || pos.length > spec.max) return fail(pos.length < spec.min ? "缺少参数" : `多余的参数 ${pos[spec.max]}`);
415
+ return {
416
+ pos,
417
+ flags
418
+ };
419
+ }
420
+ function formatTable(headers, rows) {
421
+ const cell = (v) => str(v).replace(/\s*\n\s*/g, " ");
422
+ return [headers.join(" "), ...rows.map((r) => r.map(cell).join(" "))];
423
+ }
424
+ function str(v) {
425
+ if (v === void 0 || v === null) return "";
426
+ return typeof v === "string" ? v : typeof v === "object" ? JSON.stringify(v) : String(v);
427
+ }
428
+ function list(data, key) {
429
+ const v = data[key];
430
+ return Array.isArray(v) ? v : [];
431
+ }
432
+ function query(params) {
433
+ const qs = new URLSearchParams();
434
+ for (const [k, v] of Object.entries(params)) if (v !== void 0) qs.set(k, v);
435
+ const s = qs.toString();
436
+ return s === "" ? "" : `?${s}`;
437
+ }
438
+ function seg(v) {
439
+ return encodeURIComponent(v);
440
+ }
441
+ const KB_PATH = "/session/kb";
442
+ function checkLine(item) {
443
+ const where = [str(item.page_id) === "" ? "" : `页面 ${str(item.page_id)}`, str(item.block_id) === "" ? "" : `段 ${str(item.block_id)}`].filter((s) => s !== "").join(" ");
444
+ return `[${str(item.code)}]${where === "" ? "" : ` ${where}`}:${str(item.message)}`;
445
+ }
446
+ function conflictLine(item) {
447
+ const blocks = Array.isArray(item.block_ids) ? item.block_ids.map(str) : [];
448
+ const whole = item.whole_page === true;
449
+ if (blocks.length === 0) return `页面 ${str(item.page_id)} 整页冲突`;
450
+ return `页面 ${str(item.page_id)} 的段 ${blocks.join(", ")}${whole ? ";另有整页冲突(页头、位置或删改)" : ""}`;
451
+ }
452
+ function emit(ctx, data, render) {
453
+ if (ctx.output === "json") {
454
+ ctx.io.out(JSON.stringify(data));
455
+ return;
456
+ }
457
+ for (const line of render()) ctx.io.out(line);
458
+ }
459
+ function usageError(ctx, message) {
460
+ ctx.io.err(message);
461
+ return EXIT_USAGE;
462
+ }
463
+ function kvLines(pairs) {
464
+ return pairs.filter(([, v]) => str(v) !== "").map(([k, v]) => `${k}:${str(v)}`);
465
+ }
466
+ const SCOPES = [
467
+ "full",
468
+ "outline",
469
+ "section",
470
+ "keyword",
471
+ "range"
472
+ ];
473
+ const DETAILS = ["simple", "with-ids"];
474
+ const DEFAULT_RAW_FILE_PREFIX = "raw-";
475
+ const kbList = async (args, ctx) => {
476
+ const p = parseArgs(args, {
477
+ values: [],
478
+ min: 0,
479
+ max: 0,
480
+ usage: "用法:af kb list"
481
+ });
482
+ if (typeof p === "string") return usageError(ctx, p);
483
+ const r = await ctx.request("GET", KB_PATH);
484
+ if ("exit" in r) return r.exit;
485
+ emit(ctx, r.data, () => formatTable([
486
+ "库",
487
+ "名称",
488
+ "页数",
489
+ "工作库",
490
+ "简介"
491
+ ], list(r.data, "bases").map((b) => [
492
+ b.slug,
493
+ b.name,
494
+ b.page_count,
495
+ b.is_work === true ? "是" : "",
496
+ b.description
497
+ ])));
498
+ return EXIT_OK;
499
+ };
500
+ const kbGet = async (args, ctx) => {
501
+ const p = parseArgs(args, {
502
+ values: [],
503
+ min: 1,
504
+ max: 1,
505
+ usage: "用法:af kb get <库>"
506
+ });
507
+ if (typeof p === "string") return usageError(ctx, p);
508
+ const r = await ctx.request("GET", `${KB_PATH}/${seg(p.pos[0])}`);
509
+ if ("exit" in r) return r.exit;
510
+ emit(ctx, r.data, () => [
511
+ ...kvLines([
512
+ ["库", r.data.slug],
513
+ ["名称", r.data.name],
514
+ ["简介", r.data.description],
515
+ ["页数", r.data.page_count]
516
+ ]),
517
+ ...str(r.data.purpose) === "" ? [] : [
518
+ "",
519
+ "目标:",
520
+ str(r.data.purpose)
521
+ ],
522
+ ...str(r.data.schema) === "" ? [] : [
523
+ "",
524
+ "Schema:",
525
+ str(r.data.schema)
526
+ ]
527
+ ]);
528
+ return EXIT_OK;
529
+ };
530
+ const kbSearch = async (args, ctx) => {
531
+ const p = parseArgs(args, {
532
+ values: [
533
+ "kb",
534
+ "type",
535
+ "limit"
536
+ ],
537
+ min: 1,
538
+ max: 1,
539
+ usage: "用法:af kb search \"<关键词>\" [--kb <库>] [--type <页面类型>] [--limit <条数>]"
540
+ });
541
+ if (typeof p === "string") return usageError(ctx, p);
542
+ const limit = p.flags.get("limit");
543
+ if (limit !== void 0 && !/^[1-9]\d*$/.test(limit)) return usageError(ctx, `--limit 必须是正整数(收到 ${JSON.stringify(limit)})`);
544
+ if (p.pos[0].trim() === "") return usageError(ctx, "检索词不能为空");
545
+ const r = await ctx.request("GET", `${KB_PATH}/search${query({
546
+ q: p.pos[0],
547
+ kb: p.flags.get("kb"),
548
+ type: p.flags.get("type"),
549
+ limit
550
+ })}`);
551
+ if ("exit" in r) return r.exit;
552
+ emit(ctx, r.data, () => [`检索模式:${str(r.data.mode)}`, ...formatTable([
553
+ "库",
554
+ "路径",
555
+ "段 id",
556
+ "标题",
557
+ "摘录",
558
+ "引用"
559
+ ], list(r.data, "hits").map((h) => [
560
+ h.kb,
561
+ h.path,
562
+ h.block_id,
563
+ h.title,
564
+ h.excerpt,
565
+ h.mention
566
+ ]))]);
567
+ return EXIT_OK;
568
+ };
569
+ const kbPageList = async (args, ctx) => {
570
+ const p = parseArgs(args, {
571
+ values: [
572
+ "parent",
573
+ "cursor",
574
+ "draft"
575
+ ],
576
+ min: 1,
577
+ max: 1,
578
+ usage: "用法:af kb page list <库> [--parent <路径>] [--cursor <游标>] [--draft <草稿 id>]"
579
+ });
580
+ if (typeof p === "string") return usageError(ctx, p);
581
+ const qs = query({
582
+ parent: p.flags.get("parent"),
583
+ cursor: p.flags.get("cursor"),
584
+ draft: p.flags.get("draft")
585
+ });
586
+ const r = await ctx.request("GET", `${KB_PATH}/${seg(p.pos[0])}/pages${qs}`);
587
+ if ("exit" in r) return r.exit;
588
+ emit(ctx, r.data, () => [...formatTable([
589
+ "路径",
590
+ "类型",
591
+ "标题",
592
+ "说明",
593
+ "有子页"
594
+ ], list(r.data, "items").map((i) => [
595
+ i.path,
596
+ i.type,
597
+ i.title,
598
+ i.description,
599
+ i.has_children === true ? "是" : ""
600
+ ])), ...str(r.data.next_cursor) === "" ? [] : [`下一页:加 --cursor ${str(r.data.next_cursor)}`]]);
601
+ return EXIT_OK;
602
+ };
603
+ const kbPageFetch = async (args, ctx) => {
604
+ const usage = "用法:af kb page fetch <引用> [--scope full|outline|section|keyword|range] [--start-block-id <段 id>] [--end-block-id <段 id>] [--keyword <词>] [--draft <草稿 id>] [--detail simple|with-ids]";
605
+ const p = parseArgs(args, {
606
+ values: [
607
+ "scope",
608
+ "start-block-id",
609
+ "end-block-id",
610
+ "keyword",
611
+ "draft",
612
+ "detail"
613
+ ],
614
+ min: 1,
615
+ max: 1,
616
+ usage
617
+ });
618
+ if (typeof p === "string") return usageError(ctx, p);
619
+ const ref = parseRef(p.pos[0]);
620
+ if (typeof ref === "string") return usageError(ctx, ref);
621
+ const problem = checkFetchFlags(p.flags);
622
+ if (problem !== void 0) return usageError(ctx, `${problem};${usage}`);
623
+ const qs = query({
624
+ scope: p.flags.get("scope"),
625
+ start_block_id: p.flags.get("start-block-id"),
626
+ end_block_id: p.flags.get("end-block-id"),
627
+ keyword: p.flags.get("keyword"),
628
+ draft: p.flags.get("draft"),
629
+ detail: p.flags.get("detail")
630
+ });
631
+ const r = await ctx.request("GET", `${KB_PATH}/pages/${seg(ref.raw)}${qs}`);
632
+ if ("exit" in r) return r.exit;
633
+ emit(ctx, r.data, () => renderPage(r.data));
634
+ return EXIT_OK;
635
+ };
636
+ function checkFetchFlags(flags) {
637
+ const scope = flags.get("scope");
638
+ const detail = flags.get("detail");
639
+ if (scope !== void 0 && !SCOPES.includes(scope)) return `--scope 只能是 ${SCOPES.join(" | ")}`;
640
+ if (detail !== void 0 && !DETAILS.includes(detail)) return `--detail 只能是 ${DETAILS.join(" | ")}`;
641
+ if ((scope === "section" || scope === "range") && !flags.get("start-block-id")) return `--scope ${scope} 需要 --start-block-id`;
642
+ if (scope === "keyword" && !flags.get("keyword")) return "--scope keyword 需要 --keyword";
643
+ }
644
+ function renderPage(d) {
645
+ const fm = typeof d.frontmatter === "object" && d.frontmatter !== null ? d.frontmatter : {};
646
+ const lines = kvLines([
647
+ ["路径", d.path],
648
+ ["页面 id", d.page_id],
649
+ ["标题", fm.title],
650
+ ["版本", d.version],
651
+ ["修订", d.revision_id]
652
+ ]);
653
+ lines.push("");
654
+ for (const b of list(d, "blocks")) lines.push(str(b.id) === "" ? str(b.content) : `[${str(b.id)}] ${str(b.content)}`);
655
+ const claims = list(d, "claims");
656
+ if (claims.length > 0) lines.push("", "论断:", ...claimRows(claims));
657
+ return lines;
658
+ }
659
+ const kbStale = async (args, ctx) => {
660
+ const p = parseArgs(args, {
661
+ values: [],
662
+ min: 1,
663
+ max: 1,
664
+ usage: "用法:af kb stale <库>"
665
+ });
666
+ if (typeof p === "string") return usageError(ctx, p);
667
+ const r = await ctx.request("GET", `${KB_PATH}/${seg(p.pos[0])}/stale`);
668
+ if ("exit" in r) return r.exit;
669
+ emit(ctx, r.data, () => formatTable([
670
+ "路径",
671
+ "标题",
672
+ "复核到期"
673
+ ], list(r.data, "pages").map((x) => [
674
+ x.path,
675
+ x.title,
676
+ x.stale_after
677
+ ])));
678
+ return EXIT_OK;
679
+ };
680
+ const kbRawList = async (args, ctx) => {
681
+ const p = parseArgs(args, {
682
+ values: [],
683
+ min: 1,
684
+ max: 1,
685
+ usage: "用法:af kb raw list <库>"
686
+ });
687
+ if (typeof p === "string") return usageError(ctx, p);
688
+ const r = await ctx.request("GET", `${KB_PATH}/${seg(p.pos[0])}/raw`);
689
+ if ("exit" in r) return r.exit;
690
+ emit(ctx, r.data, () => formatTable([
691
+ "id",
692
+ "名称",
693
+ "大小",
694
+ "类型",
695
+ "状态"
696
+ ], list(r.data, "raws").map((x) => [
697
+ x.id,
698
+ x.name,
699
+ x.size,
700
+ x.kind,
701
+ x.status
702
+ ])));
703
+ return EXIT_OK;
704
+ };
705
+ const kbRawGet = async (args, ctx) => {
706
+ const p = parseArgs(args, {
707
+ values: ["out"],
708
+ min: 1,
709
+ max: 1,
710
+ usage: "用法:af kb raw get <资料 id> [--out <本地文件>]"
711
+ });
712
+ if (typeof p === "string") return usageError(ctx, p);
713
+ const id = p.pos[0];
714
+ const file = p.flags.get("out") || `${DEFAULT_RAW_FILE_PREFIX}${id}`;
715
+ const r = await ctx.request("GET", `${KB_PATH}/raw/${seg(id)}/content`, void 0, true);
716
+ if ("exit" in r) return r.exit;
717
+ if (r.bytes === void 0) {
718
+ ctx.io.err("下载失败:本机服务没有返回文件内容");
719
+ return EXIT_USAGE;
720
+ }
721
+ try {
722
+ await writeFile(file, r.bytes);
723
+ } catch (err) {
724
+ ctx.io.err(`无法写入 ${file}:${String(err)}`);
725
+ return EXIT_USAGE;
726
+ }
727
+ if (ctx.output === "json") ctx.io.out(JSON.stringify({
728
+ id,
729
+ file,
730
+ size: r.bytes.length
731
+ }));
732
+ else ctx.io.out(`已保存到 ${file}(${r.bytes.length} 字节)`);
733
+ return EXIT_OK;
734
+ };
735
+ function claimRows(claims) {
736
+ return formatTable([
737
+ "页面",
738
+ "键",
739
+ "段 id",
740
+ "内容",
741
+ "证据"
742
+ ], claims.map((c) => [
743
+ c.path,
744
+ c.key,
745
+ c.block_id,
746
+ c.text,
747
+ (Array.isArray(c.evidence) ? c.evidence : []).map((e) => str(e.uri)).join(", ")
748
+ ]));
749
+ }
750
+ const kbClaimsGet = async (args, ctx) => {
751
+ const p = parseArgs(args, {
752
+ values: ["draft"],
753
+ min: 1,
754
+ max: 1,
755
+ usage: "用法:af kb claims get <引用> [--draft <草稿 id>]"
756
+ });
757
+ if (typeof p === "string") return usageError(ctx, p);
758
+ const ref = parseRef(p.pos[0]);
759
+ if (typeof ref === "string") return usageError(ctx, ref);
760
+ const r = await ctx.request("GET", `${KB_PATH}/pages/${seg(ref.raw)}/claims${query({ draft: p.flags.get("draft") })}`);
761
+ if ("exit" in r) return r.exit;
762
+ emit(ctx, r.data, () => claimRows(list(r.data, "claims")));
763
+ return EXIT_OK;
764
+ };
765
+ const kbClaimsList = async (args, ctx) => {
766
+ const usage = "用法:af kb claims list <库> --evidence <证据前缀,如 task://>";
767
+ const p = parseArgs(args, {
768
+ values: ["evidence"],
769
+ min: 1,
770
+ max: 1,
771
+ usage
772
+ });
773
+ if (typeof p === "string") return usageError(ctx, p);
774
+ const evidence = p.flags.get("evidence");
775
+ if (!evidence) return usageError(ctx, `缺少 --evidence;${usage}`);
776
+ const r = await ctx.request("GET", `${KB_PATH}/${seg(p.pos[0])}/claims${query({ evidence })}`);
777
+ if ("exit" in r) return r.exit;
778
+ emit(ctx, r.data, () => claimRows(list(r.data, "claims")));
779
+ return EXIT_OK;
780
+ };
781
+ const kbSourceGet = async (args, ctx) => {
782
+ const p = parseArgs(args, {
783
+ values: [],
784
+ min: 1,
785
+ max: 1,
786
+ usage: "用法:af kb source get <资料 id>"
787
+ });
788
+ if (typeof p === "string") return usageError(ctx, p);
789
+ const r = await ctx.request("GET", `${KB_PATH}/sources/${seg(p.pos[0])}`);
790
+ if ("exit" in r) return r.exit;
791
+ emit(ctx, r.data, () => [
792
+ ...kvLines([
793
+ ["id", r.data.id],
794
+ ["类型", r.data.kind],
795
+ ["标题", r.data.title],
796
+ ["来源", r.data.uri]
797
+ ]),
798
+ "",
799
+ str(r.data.content)
800
+ ]);
801
+ return EXIT_OK;
802
+ };
803
+ const RISKS = [
804
+ "low",
805
+ "medium",
806
+ "high"
807
+ ];
808
+ const DRAFT_ID_RE = /^\d+$/;
809
+ const MR_NUMBER_RE = /^#?([1-9]\d*)$/;
810
+ const OP_FIELD = "op";
811
+ const VERSION_FIELD = "version";
812
+ async function readText(file) {
813
+ try {
814
+ return { text: await readFile(file, "utf8") };
815
+ } catch (err) {
816
+ return `无法读取文件 ${file}:${String(err)}`;
817
+ }
818
+ }
819
+ async function readJSONFile(file) {
820
+ const r = await readText(file);
821
+ if (typeof r === "string") return r;
822
+ try {
823
+ return { value: JSON.parse(r.text) };
824
+ } catch (err) {
825
+ return `${file} 不是合法的 JSON:${String(err)}`;
826
+ }
827
+ }
828
+ function isObject(v) {
829
+ return typeof v === "object" && v !== null && !Array.isArray(v);
830
+ }
831
+ function checkDraftID(id) {
832
+ return id !== void 0 && DRAFT_ID_RE.test(id) ? void 0 : "--draft 需要草稿 id(af kb draft create 返回的 id)";
833
+ }
834
+ function checkVersion(v) {
835
+ return v !== void 0 && parseVersion(v) ? void 0 : "--version 需要版本串:d<草稿版本>(页面已在草稿里)或主线修订 id(af kb page fetch 返回的 version)";
836
+ }
837
+ function parseNumber(text) {
838
+ return MR_NUMBER_RE.exec(text)?.[1];
839
+ }
840
+ const kbNote = async (args, ctx) => {
841
+ const usage = "用法:af kb note \"<要记的内容>\" [--link <网址>]";
842
+ const p = parseArgs(args, {
843
+ values: ["link"],
844
+ min: 1,
845
+ max: 1,
846
+ usage
847
+ });
848
+ if (typeof p === "string") return usageError(ctx, p);
849
+ if (p.pos[0].trim() === "") return usageError(ctx, `内容不能为空;${usage}`);
850
+ const link = p.flags.get("link");
851
+ const body = {
852
+ text: p.pos[0],
853
+ ...link ? { link } : {}
854
+ };
855
+ const r = await ctx.request("POST", `${KB_PATH}/sources`, JSON.stringify(body));
856
+ if ("exit" in r) return r.exit;
857
+ emit(ctx, r.data, () => [`已记入资料池:${str(r.data.uri)}`]);
858
+ return EXIT_OK;
859
+ };
860
+ const kbPoolClaim = async (args, ctx) => {
861
+ const p = parseArgs(args, {
862
+ values: [],
863
+ min: 0,
864
+ max: 0,
865
+ usage: "用法:af kb pool claim"
866
+ });
867
+ if (typeof p === "string") return usageError(ctx, p);
868
+ const r = await ctx.request("POST", `${KB_PATH}/pool/claim`);
869
+ if ("exit" in r) return r.exit;
870
+ emit(ctx, r.data, () => {
871
+ const sources = list(r.data, "sources");
872
+ if (sources.length === 0) return ["资料池里没有待整理的资料,本次没有领到。"];
873
+ return [`领到 ${sources.length} 份待整理的资料(读原文用 af kb source get <id>):`, ...formatTable([
874
+ "id",
875
+ "类型",
876
+ "标题",
877
+ "uri"
878
+ ], sources.map((x) => [
879
+ x.id,
880
+ x.kind,
881
+ x.title,
882
+ x.uri
883
+ ]))];
884
+ });
885
+ return EXIT_OK;
886
+ };
887
+ const kbAnnotate = async (args, ctx) => {
888
+ const usage = "用法:af kb annotate [--kb <库>] [--page <页面 id> [--block <段 id> --quote \"<原句>\"]] \"<批注内容>\"";
889
+ const p = parseArgs(args, {
890
+ values: [
891
+ "kb",
892
+ "page",
893
+ "block",
894
+ "quote"
895
+ ],
896
+ min: 1,
897
+ max: 1,
898
+ usage
899
+ });
900
+ if (typeof p === "string") return usageError(ctx, p);
901
+ if (p.pos[0].trim() === "") return usageError(ctx, `批注内容不能为空;${usage}`);
902
+ if ((p.flags.has("block") || p.flags.has("quote")) && !p.flags.has("page")) return usageError(ctx, `--block / --quote 需要同时给 --page;${usage}`);
903
+ const body = {};
904
+ for (const [flag, field] of [
905
+ ["kb", "kb"],
906
+ ["page", "page_id"],
907
+ ["block", "block_id"],
908
+ ["quote", "quote"]
909
+ ]) {
910
+ const v = p.flags.get(flag);
911
+ if (v) body[field] = v;
912
+ }
913
+ body.body = p.pos[0];
914
+ const r = await ctx.request("POST", `${KB_PATH}/annotations`, JSON.stringify(body));
915
+ if ("exit" in r) return r.exit;
916
+ emit(ctx, r.data, () => ["已记录批注"]);
917
+ return EXIT_OK;
918
+ };
919
+ const kbDraftCreate = async (args, ctx) => {
920
+ const p = parseArgs(args, {
921
+ values: ["title"],
922
+ min: 1,
923
+ max: 1,
924
+ usage: "用法:af kb draft create <库> [--title <标题>]"
925
+ });
926
+ if (typeof p === "string") return usageError(ctx, p);
927
+ const title = p.flags.get("title");
928
+ const body = {
929
+ kb: p.pos[0],
930
+ ...title ? { title } : {}
931
+ };
932
+ const r = await ctx.request("POST", `${KB_PATH}/drafts`, JSON.stringify(body));
933
+ if ("exit" in r) return r.exit;
934
+ emit(ctx, r.data, () => kvLines([["草稿 id", r.data.id], ["版本", r.data.version]]));
935
+ return EXIT_OK;
936
+ };
937
+ const kbDraftCheck = async (args, ctx) => {
938
+ const p = parseArgs(args, {
939
+ values: [],
940
+ min: 1,
941
+ max: 1,
942
+ usage: "用法:af kb draft check <草稿 id>"
943
+ });
944
+ if (typeof p === "string") return usageError(ctx, p);
945
+ const r = await ctx.request("GET", `${KB_PATH}/drafts/${seg(p.pos[0])}`);
946
+ if ("exit" in r) return r.exit;
947
+ const checks = isObject(r.data.checks) ? r.data.checks : {};
948
+ const errors = list(checks, "errors");
949
+ const warnings = list(checks, "warnings");
950
+ emit(ctx, r.data, () => [
951
+ ...kvLines([["版本", r.data.version], ["改动页数", Array.isArray(r.data.changes) ? r.data.changes.length : ""]]),
952
+ ...errors.length === 0 ? ["检查通过:没有 error"] : [`有 ${errors.length} 个 error,必须修好才能提交:`, ...errors.map((e) => ` error ${checkLine(e)}`)],
953
+ ...warnings.map((w) => ` warning ${checkLine(w)}`)
954
+ ]);
955
+ return errors.length > 0 ? EXIT_REJECTED : EXIT_OK;
956
+ };
957
+ const kbDraftSync = async (args, ctx) => {
958
+ const p = parseArgs(args, {
959
+ values: [],
960
+ min: 1,
961
+ max: 1,
962
+ usage: "用法:af kb draft sync <草稿 id>"
963
+ });
964
+ if (typeof p === "string") return usageError(ctx, p);
965
+ const r = await ctx.request("POST", `${KB_PATH}/drafts/${seg(p.pos[0])}/sync`);
966
+ if ("exit" in r) return r.exit;
967
+ const conflicts = list(r.data, "conflicts");
968
+ emit(ctx, r.data, () => [...kvLines([["版本", r.data.version]]), ...conflicts.length === 0 ? ["已同步:没有冲突"] : [`有 ${conflicts.length} 处冲突,冲突标记已写进草稿的对应段,处理后再 af kb draft sync:`, ...conflicts.map((c) => ` ${conflictLine(c)}`)]]);
969
+ return conflicts.length > 0 ? EXIT_REJECTED : EXIT_OK;
970
+ };
971
+ function findingLine(w) {
972
+ if (!isObject(w)) return `警告:${str(w)}`;
973
+ return `${w.severity === "error" ? "error" : "警告"}:${checkLine(w)}`;
974
+ }
975
+ function renderPageWrite(d) {
976
+ const blocks = (Array.isArray(d.new_blocks) ? d.new_blocks : []).map((b) => isObject(b) ? str(b.id) : str(b));
977
+ const warnings = Array.isArray(d.warnings) ? d.warnings : [];
978
+ return [...kvLines([
979
+ ["页面 id", d.page_id],
980
+ ["新版本", d.version],
981
+ ["新段 id", blocks.join(", ")]
982
+ ]), ...warnings.map(findingLine)];
983
+ }
984
+ function draftPagePath(draft, refText) {
985
+ const bad = checkDraftID(draft);
986
+ if (bad !== void 0) return bad;
987
+ const ref = parseRef(refText);
988
+ return typeof ref === "string" ? ref : {
989
+ base: `${KB_PATH}/drafts/${seg(draft)}/pages`,
990
+ ref: ref.raw
991
+ };
992
+ }
993
+ const kbPageCreate = async (args, ctx) => {
994
+ const usage = "用法:af kb page create --draft <草稿 id> --slug <页面 slug> --type <类型> --title <标题> --description <一句话说明> --parent <父页路径,建在顶层写 --parent=> [--after <前一个同级页引用>] [--content-file <正文文件>]";
995
+ const p = parseArgs(args, {
996
+ values: [
997
+ "draft",
998
+ "parent",
999
+ "slug",
1000
+ "type",
1001
+ "title",
1002
+ "description",
1003
+ "after",
1004
+ "content-file"
1005
+ ],
1006
+ min: 0,
1007
+ max: 0,
1008
+ usage
1009
+ });
1010
+ if (typeof p === "string") return usageError(ctx, p);
1011
+ const bad = checkDraftID(p.flags.get("draft"));
1012
+ if (bad !== void 0) return usageError(ctx, `${bad};${usage}`);
1013
+ if (!p.flags.has("parent")) return usageError(ctx, `缺少 --parent(建在顶层写 --parent=);${usage}`);
1014
+ for (const f of [
1015
+ "slug",
1016
+ "type",
1017
+ "title",
1018
+ "description"
1019
+ ]) if (!p.flags.get(f)?.trim()) return usageError(ctx, `缺少 --${f};${usage}`);
1020
+ if (!isPageSlug(p.flags.get("slug"))) return usageError(ctx, "--slug 只能是小写字母、数字、下划线、短横线,以字母或数字开头,不超过 64 个字符,且不能全是数字");
1021
+ const body = {};
1022
+ for (const f of [
1023
+ "parent",
1024
+ "slug",
1025
+ "type",
1026
+ "title",
1027
+ "description",
1028
+ "after"
1029
+ ]) {
1030
+ const v = p.flags.get(f);
1031
+ if (v !== void 0 && (v !== "" || f === "parent")) body[f] = v;
1032
+ }
1033
+ const file = p.flags.get("content-file");
1034
+ if (file) {
1035
+ const c = await readText(file);
1036
+ if (typeof c === "string") return usageError(ctx, c);
1037
+ body.content = c.text;
1038
+ }
1039
+ const r = await ctx.request("POST", `${KB_PATH}/drafts/${seg(p.flags.get("draft"))}/pages`, JSON.stringify(body));
1040
+ if ("exit" in r) return r.exit;
1041
+ emit(ctx, r.data, () => renderPageWrite(r.data));
1042
+ return EXIT_OK;
1043
+ };
1044
+ const kbPagePatch = async (args, ctx) => {
1045
+ const usage = [
1046
+ "用法:af kb page patch <引用> --draft <草稿 id> --version <版本> --file <op.json>",
1047
+ "--file 是一个 op 的 JSON 对象,一次只提交一个 op;各 op 的字段:",
1048
+ " block_replace:block, content | block_insert_after:after, content | block_delete:block | block_move_after:block, after",
1049
+ " str_replace:find, replace | append:content | set_meta:meta | move:parent, slug | delete:无",
1050
+ "最小示例:{\"op\":\"block_replace\",\"block\":\"a1b2\",\"content\":\"新的段落内容\"}"
1051
+ ].join("\n");
1052
+ const p = parseArgs(args, {
1053
+ values: [
1054
+ "draft",
1055
+ "version",
1056
+ "file"
1057
+ ],
1058
+ min: 1,
1059
+ max: 1,
1060
+ usage
1061
+ });
1062
+ if (typeof p === "string") return usageError(ctx, p);
1063
+ const target = draftPagePath(p.flags.get("draft"), p.pos[0]);
1064
+ if (typeof target === "string") return usageError(ctx, `${target};${usage}`);
1065
+ const file = p.flags.get("file");
1066
+ if (!file) return usageError(ctx, `缺少 --file;${usage}`);
1067
+ const parsed = await readJSONFile(file);
1068
+ if (typeof parsed === "string") return usageError(ctx, parsed);
1069
+ if (!isObject(parsed.value) || typeof parsed.value[OP_FIELD] !== "string") return usageError(ctx, `${file} 必须是带 op 字段的 JSON 对象(一次提交一个 op)`);
1070
+ const version = pickVersion(p.flags.get("version"), parsed.value[VERSION_FIELD]);
1071
+ if (version instanceof Error) return usageError(ctx, `${version.message};${usage}`);
1072
+ const badVersion = checkVersion(version);
1073
+ if (badVersion !== void 0) return usageError(ctx, `${badVersion};${usage}`);
1074
+ return postOp(target, {
1075
+ ...parsed.value,
1076
+ [VERSION_FIELD]: version
1077
+ }, ctx);
1078
+ };
1079
+ function pickVersion(flag, inFile) {
1080
+ const fromFile = typeof inFile === "string" ? inFile : void 0;
1081
+ if (flag !== void 0 && fromFile !== void 0 && flag !== fromFile) return /* @__PURE__ */ new Error(`--version ${flag} 与文件里的 version ${fromFile} 不一致`);
1082
+ return flag ?? fromFile;
1083
+ }
1084
+ async function postOp(target, body, ctx) {
1085
+ const r = await ctx.request("POST", `${target.base}/${seg(target.ref)}/ops`, JSON.stringify(body));
1086
+ if ("exit" in r) return r.exit;
1087
+ emit(ctx, r.data, () => renderPageWrite(r.data));
1088
+ return EXIT_OK;
1089
+ }
1090
+ const kbPageMove = async (args, ctx) => {
1091
+ const usage = "用法:af kb page move <引用> --draft <草稿 id> --version <版本> [--parent <新父页路径,留空=顶层>] [--slug <新 slug>]";
1092
+ const p = parseArgs(args, {
1093
+ values: [
1094
+ "draft",
1095
+ "version",
1096
+ "parent",
1097
+ "slug"
1098
+ ],
1099
+ min: 1,
1100
+ max: 1,
1101
+ usage
1102
+ });
1103
+ if (typeof p === "string") return usageError(ctx, p);
1104
+ const target = draftPagePath(p.flags.get("draft"), p.pos[0]);
1105
+ if (typeof target === "string") return usageError(ctx, `${target};${usage}`);
1106
+ const badVersion = checkVersion(p.flags.get("version"));
1107
+ if (badVersion !== void 0) return usageError(ctx, `${badVersion};${usage}`);
1108
+ const parent = p.flags.get("parent");
1109
+ const slug = p.flags.get("slug");
1110
+ if (parent === void 0 && slug === void 0) return usageError(ctx, `至少给 --parent 或 --slug 之一;${usage}`);
1111
+ if (slug !== void 0 && !isPageSlug(slug)) return usageError(ctx, "--slug 不合规:小写字母、数字、下划线、短横线,以字母或数字开头,不超过 64 个字符,且不能全是数字");
1112
+ return postOp(target, {
1113
+ version: p.flags.get("version"),
1114
+ op: "move",
1115
+ ...parent === void 0 ? {} : { parent },
1116
+ ...slug === void 0 ? {} : { slug }
1117
+ }, ctx);
1118
+ };
1119
+ const kbPageDelete = async (args, ctx) => {
1120
+ const usage = "用法:af kb page delete <引用> --draft <草稿 id> --version <版本>";
1121
+ const p = parseArgs(args, {
1122
+ values: ["draft", "version"],
1123
+ min: 1,
1124
+ max: 1,
1125
+ usage
1126
+ });
1127
+ if (typeof p === "string") return usageError(ctx, p);
1128
+ const target = draftPagePath(p.flags.get("draft"), p.pos[0]);
1129
+ if (typeof target === "string") return usageError(ctx, `${target};${usage}`);
1130
+ const badVersion = checkVersion(p.flags.get("version"));
1131
+ if (badVersion !== void 0) return usageError(ctx, `${badVersion};${usage}`);
1132
+ return postOp(target, {
1133
+ version: p.flags.get("version"),
1134
+ op: "delete"
1135
+ }, ctx);
1136
+ };
1137
+ const kbClaimsSet = async (args, ctx) => {
1138
+ const usage = "用法:af kb claims set <引用> --draft <草稿 id> --version <版本> --file <claims.json>(论断数组,或 {\"claims\": [...]})";
1139
+ const p = parseArgs(args, {
1140
+ values: [
1141
+ "draft",
1142
+ "version",
1143
+ "file"
1144
+ ],
1145
+ min: 1,
1146
+ max: 1,
1147
+ usage
1148
+ });
1149
+ if (typeof p === "string") return usageError(ctx, p);
1150
+ const target = draftPagePath(p.flags.get("draft"), p.pos[0]);
1151
+ if (typeof target === "string") return usageError(ctx, `${target};${usage}`);
1152
+ const badVersion = checkVersion(p.flags.get("version"));
1153
+ if (badVersion !== void 0) return usageError(ctx, `${badVersion};${usage}`);
1154
+ const file = p.flags.get("file");
1155
+ if (!file) return usageError(ctx, `缺少 --file;${usage}`);
1156
+ const parsed = await readJSONFile(file);
1157
+ if (typeof parsed === "string") return usageError(ctx, parsed);
1158
+ const claims = Array.isArray(parsed.value) ? parsed.value : isObject(parsed.value) ? parsed.value.claims : void 0;
1159
+ if (!Array.isArray(claims)) return usageError(ctx, `${file} 必须是论断数组,或带 claims 数组的对象`);
1160
+ const r = await ctx.request("PUT", `${target.base}/${seg(target.ref)}/claims`, JSON.stringify({
1161
+ version: p.flags.get("version"),
1162
+ claims
1163
+ }));
1164
+ if ("exit" in r) return r.exit;
1165
+ emit(ctx, r.data, () => kvLines([["新版本", r.data.version], ["论断数", Array.isArray(r.data.claims) ? r.data.claims.length : ""]]));
1166
+ return EXIT_OK;
1167
+ };
1168
+ const kbMrCreate = async (args, ctx) => {
1169
+ const usage = "用法:af kb mr create --draft <草稿 id> --title <标题> --summary <说明> --risk low|medium|high";
1170
+ const p = parseArgs(args, {
1171
+ values: [
1172
+ "draft",
1173
+ "title",
1174
+ "summary",
1175
+ "risk"
1176
+ ],
1177
+ min: 0,
1178
+ max: 0,
1179
+ usage
1180
+ });
1181
+ if (typeof p === "string") return usageError(ctx, p);
1182
+ const bad = checkDraftID(p.flags.get("draft"));
1183
+ if (bad !== void 0) return usageError(ctx, `${bad};${usage}`);
1184
+ for (const f of ["title", "summary"]) if (!p.flags.get(f)?.trim()) return usageError(ctx, `缺少 --${f};${usage}`);
1185
+ const risk = p.flags.get("risk");
1186
+ if (risk === void 0 || !RISKS.includes(risk)) return usageError(ctx, `--risk 只能是 ${RISKS.join(" | ")};${usage}`);
1187
+ const body = {
1188
+ draft_id: p.flags.get("draft"),
1189
+ title: p.flags.get("title"),
1190
+ summary: p.flags.get("summary"),
1191
+ risk
1192
+ };
1193
+ const r = await ctx.request("POST", `${KB_PATH}/merge-requests`, JSON.stringify(body));
1194
+ if ("exit" in r) return r.exit;
1195
+ emit(ctx, r.data, () => [`已提交变更请求 #${str(r.data.number)},等待本人审核合并`]);
1196
+ return EXIT_OK;
1197
+ };
1198
+ const kbMrUpdate = async (args, ctx) => {
1199
+ const usage = "用法:af kb mr update <编号> [--title <标题>] [--summary <说明>] [--risk low|medium|high]";
1200
+ const p = parseArgs(args, {
1201
+ values: [
1202
+ "title",
1203
+ "summary",
1204
+ "risk"
1205
+ ],
1206
+ min: 1,
1207
+ max: 1,
1208
+ usage
1209
+ });
1210
+ if (typeof p === "string") return usageError(ctx, p);
1211
+ const n = parseNumber(p.pos[0]);
1212
+ if (n === void 0) return usageError(ctx, `编号必须是正整数(如 3 或 #3);${usage}`);
1213
+ const body = {};
1214
+ for (const f of [
1215
+ "title",
1216
+ "summary",
1217
+ "risk"
1218
+ ]) {
1219
+ const v = p.flags.get(f);
1220
+ if (v) body[f] = v;
1221
+ }
1222
+ if (Object.keys(body).length === 0) return usageError(ctx, `至少改一项:--title / --summary / --risk;${usage}`);
1223
+ if (body.risk !== void 0 && !RISKS.includes(body.risk)) return usageError(ctx, `--risk 只能是 ${RISKS.join(" | ")};${usage}`);
1224
+ const r = await ctx.request("PATCH", `${KB_PATH}/merge-requests/${n}`, JSON.stringify(body));
1225
+ if ("exit" in r) return r.exit;
1226
+ emit(ctx, r.data, () => [`已更新变更请求 #${n}`]);
1227
+ return EXIT_OK;
1228
+ };
1229
+ const kbMrReady = async (args, ctx) => {
1230
+ const usage = "用法:af kb mr ready <编号>";
1231
+ const p = parseArgs(args, {
1232
+ values: [],
1233
+ min: 1,
1234
+ max: 1,
1235
+ usage
1236
+ });
1237
+ if (typeof p === "string") return usageError(ctx, p);
1238
+ const n = parseNumber(p.pos[0]);
1239
+ if (n === void 0) return usageError(ctx, `编号必须是正整数(如 3 或 #3);${usage}`);
1240
+ const r = await ctx.request("POST", `${KB_PATH}/merge-requests/${n}:ready`);
1241
+ if ("exit" in r) return r.exit;
1242
+ emit(ctx, r.data, () => [`已重新请求审核 #${n}`]);
1243
+ return EXIT_OK;
1244
+ };
1245
+ function commentRows(comments, depth = 0) {
1246
+ return comments.flatMap((c) => [[
1247
+ c.id,
1248
+ c.author_name,
1249
+ c.page_id,
1250
+ c.block_id,
1251
+ `${depth > 0 ? "↳ " : ""}${str(c.body)}`
1252
+ ], ...commentRows(list(c, "replies"), depth + 1)]);
1253
+ }
1254
+ const kbMrCommentList = async (args, ctx) => {
1255
+ const usage = "用法:af kb mr comment list <编号>";
1256
+ const p = parseArgs(args, {
1257
+ values: [],
1258
+ min: 1,
1259
+ max: 1,
1260
+ usage
1261
+ });
1262
+ if (typeof p === "string") return usageError(ctx, p);
1263
+ const n = parseNumber(p.pos[0]);
1264
+ if (n === void 0) return usageError(ctx, `编号必须是正整数(如 3 或 #3);${usage}`);
1265
+ const r = await ctx.request("GET", `${KB_PATH}/merge-requests/${n}/comments`);
1266
+ if ("exit" in r) return r.exit;
1267
+ emit(ctx, r.data, () => formatTable([
1268
+ "评论 id",
1269
+ "作者",
1270
+ "页面",
1271
+ "段 id",
1272
+ "内容"
1273
+ ], commentRows(list(r.data, "comments"))));
1274
+ return EXIT_OK;
1275
+ };
1276
+ const kbMrCommentAdd = async (args, ctx) => {
1277
+ const usage = "用法:af kb mr comment add <编号> [--reply-to <评论 id>] \"<内容>\"";
1278
+ const p = parseArgs(args, {
1279
+ values: ["reply-to"],
1280
+ min: 2,
1281
+ max: 2,
1282
+ usage
1283
+ });
1284
+ if (typeof p === "string") return usageError(ctx, p);
1285
+ const n = parseNumber(p.pos[0]);
1286
+ if (n === void 0) return usageError(ctx, `编号必须是正整数(如 3 或 #3);${usage}`);
1287
+ if (p.pos[1].trim() === "") return usageError(ctx, `评论内容不能为空;${usage}`);
1288
+ const replyTo = p.flags.get("reply-to");
1289
+ const body = {
1290
+ body: p.pos[1],
1291
+ ...replyTo ? { parent_id: replyTo } : {}
1292
+ };
1293
+ const r = await ctx.request("POST", `${KB_PATH}/merge-requests/${n}/comments`, JSON.stringify(body));
1294
+ if ("exit" in r) return r.exit;
1295
+ emit(ctx, r.data, () => [`已发表评论 ${str(r.data.id)}`]);
1296
+ return EXIT_OK;
1297
+ };
1298
+ const KB_USAGE = [
1299
+ "用法:af kb <子命令> [--output table|json]",
1300
+ "读取:af kb list | get <库> | search \"<词>\" [--kb --type --limit] | page list <库> [--parent --cursor --draft] |",
1301
+ " page fetch <引用> [--scope full|outline|section|keyword|range --start-block-id --end-block-id --keyword --draft --detail simple|with-ids] |",
1302
+ " stale <库> | raw list <库> | raw get <id> [--out <文件>] | claims get <引用> [--draft] | claims list <库> --evidence <前缀> | source get <id>",
1303
+ "收录作业:af kb pool claim(领取资料池里待整理的资料)",
1304
+ "记录:af kb note \"<内容>\" [--link <网址>] | annotate [--kb <库>] [--page <页面 id> --block <段 id> --quote \"<原句>\"] \"<批注>\"",
1305
+ "改写(仅知识库作业):af kb draft create <库> [--title] | draft check <草稿 id> | draft sync <草稿 id> |",
1306
+ " page create --draft <id> --slug --type --title --description [--parent --after --content-file] |",
1307
+ " page patch <引用> --draft <id> --version <版本> --file <op.json> | page move <引用> --draft --version [--parent --slug] | page delete <引用> --draft --version |",
1308
+ " claims set <引用> --draft --version --file <claims.json> | mr create --draft --title --summary --risk low|medium|high |",
1309
+ " mr update <编号> [--title --summary --risk] | mr ready <编号> | mr comment list <编号> | mr comment add <编号> [--reply-to <评论 id>] \"<内容>\"",
1310
+ "引用 = 页面 id 或 <库>:<路径>(如 work:flow/apollo-key)。"
1311
+ ];
1312
+ const KB_ERROR_HINTS = {
1313
+ kb_version_conflict: "草稿里这页已被改动,你手上的版本过期了。先重新读取最新内容和版本(af kb page fetch <引用> --draft <草稿 id> --detail with-ids),基于新版本重新修改后再提交。",
1314
+ kb_check_failed: "提交前检查没通过。逐条修好(af kb draft check <草稿 id> 看明细)后再提交。",
1315
+ kb_merge_conflict: "草稿与主线冲突,冲突标记已写进草稿的对应段。处理掉冲突段后再执行 af kb draft sync <草稿 id>。",
1316
+ kb_state_invalid: "当前状态不允许这个操作(草稿、变更请求或作业已不在可操作的状态),确认状态后再试。",
1317
+ kb_not_found: "库、页面、草稿、资料或变更请求不存在,核对库简称、路径、id 或编号。",
1318
+ forbidden: "没有权限:这个命令只在知识库作业会话里可用,且只能访问你本人的库;健康检查作业只能批注与只读。普通任务会话只能用 list、get、search、page list、page fetch、note、annotate。",
1319
+ validation_failed: "参数不合法,按服务端说明修改后重试。",
1320
+ session_token_invalid: "会话令牌无效或已过期,请重新开始会话。"
1321
+ };
1322
+ const KB_DETAIL_PRINTERS = {
1323
+ kb_check_failed: (d) => list(d, "errors").map(checkLine),
1324
+ kb_merge_conflict: (d) => list(d, "conflicts").map(conflictLine)
1325
+ };
1326
+ const HTTP_BODY_PREVIEW = 200;
1327
+ function reportKbFailure(status, text, io) {
1328
+ let env;
1329
+ try {
1330
+ env = JSON.parse(text);
1331
+ } catch {
1332
+ env = void 0;
1333
+ }
1334
+ const code = typeof env?.code === "string" ? env.code : "";
1335
+ if (code === "") {
1336
+ io.err(`请求失败(HTTP ${status}):${text.slice(0, HTTP_BODY_PREVIEW) || "没有响应内容"}`);
1337
+ return failureExit(status);
1338
+ }
1339
+ const hint = KB_ERROR_HINTS[code];
1340
+ const message = typeof env?.message === "string" ? env.message : "";
1341
+ io.err(`平台拒绝(${code}):${hint ?? "未登记的错误,按服务端说明处理。"}`);
1342
+ if (message !== "" && message !== code) io.err(`服务端说明:${message}`);
1343
+ const data = env?.data;
1344
+ const detail = KB_DETAIL_PRINTERS[code];
1345
+ if (detail !== void 0 && typeof data === "object" && data !== null) for (const line of detail(data)) io.err(` ${line}`);
1346
+ return failureExit(status);
1347
+ }
1348
+ function makeCtx(io, output) {
1349
+ return {
1350
+ io,
1351
+ output,
1352
+ async request(method, path, body, wantBytes) {
1353
+ const reply = await callSession(method, path, body, io, wantBytes);
1354
+ if ("exit" in reply) return reply;
1355
+ if (!isOK(reply.status)) return { exit: reportKbFailure(reply.status, reply.text, io) };
1356
+ return {
1357
+ data: unwrap(reply.text),
1358
+ bytes: reply.data
1359
+ };
1360
+ }
1361
+ };
1362
+ }
1363
+ function unwrap(text) {
1364
+ try {
1365
+ const data = JSON.parse(text).data;
1366
+ return typeof data === "object" && data !== null && !Array.isArray(data) ? data : {};
1367
+ } catch {
1368
+ return {};
1369
+ }
1370
+ }
1371
+ function group(name, actions) {
1372
+ return async (args, ctx) => {
1373
+ const [action, ...rest] = args;
1374
+ const handler = action !== void 0 && Object.hasOwn(actions, action) ? actions[action] : void 0;
1375
+ if (handler === void 0) {
1376
+ ctx.io.err(`af kb ${name} 需要子命令:${Object.keys(actions).join(" | ")}`);
1377
+ printUsage(ctx.io.err);
1378
+ return EXIT_USAGE;
1379
+ }
1380
+ return handler(rest, ctx);
1381
+ };
1382
+ }
1383
+ const COMMANDS = {
1384
+ list: kbList,
1385
+ get: kbGet,
1386
+ search: kbSearch,
1387
+ stale: kbStale,
1388
+ note: kbNote,
1389
+ annotate: kbAnnotate,
1390
+ pool: group("pool", { claim: kbPoolClaim }),
1391
+ source: group("source", { get: kbSourceGet }),
1392
+ raw: group("raw", {
1393
+ list: kbRawList,
1394
+ get: kbRawGet
1395
+ }),
1396
+ claims: group("claims", {
1397
+ get: kbClaimsGet,
1398
+ list: kbClaimsList,
1399
+ set: kbClaimsSet
1400
+ }),
1401
+ page: group("page", {
1402
+ list: kbPageList,
1403
+ fetch: kbPageFetch,
1404
+ create: kbPageCreate,
1405
+ patch: kbPagePatch,
1406
+ move: kbPageMove,
1407
+ delete: kbPageDelete
1408
+ }),
1409
+ draft: group("draft", {
1410
+ create: kbDraftCreate,
1411
+ check: kbDraftCheck,
1412
+ sync: kbDraftSync
1413
+ }),
1414
+ mr: group("mr", {
1415
+ create: kbMrCreate,
1416
+ update: kbMrUpdate,
1417
+ ready: kbMrReady,
1418
+ comment: group("mr comment", {
1419
+ list: kbMrCommentList,
1420
+ add: kbMrCommentAdd
1421
+ })
1422
+ })
1423
+ };
1424
+ function printUsage(write) {
1425
+ for (const line of KB_USAGE) write(line);
1426
+ }
1427
+ async function afKb(args, io) {
1428
+ const parsed = parseOutput(args);
1429
+ if (typeof parsed === "string") {
1430
+ io.err(parsed);
1431
+ return EXIT_USAGE;
1432
+ }
1433
+ const [sub, ...rest] = parsed.rest;
1434
+ const handler = sub !== void 0 && Object.hasOwn(COMMANDS, sub) ? COMMANDS[sub] : void 0;
1435
+ if (handler === void 0) {
1436
+ const asked = sub === void 0 || sub === "--help" || sub === "-h";
1437
+ if (!asked) io.err(`af kb ${sub} 不是已知子命令`);
1438
+ printUsage(asked ? io.out : io.err);
1439
+ return EXIT_USAGE;
1440
+ }
1441
+ return handler(rest, makeCtx(io, parsed.output));
1442
+ }
1443
+ const SESSION_SCHEDULES_PATH = "/session/schedules";
1444
+ const TEMPLATES = ["kb_ingest", "kb_health"];
1445
+ const USAGE = "usage: af schedule create --template kb_ingest|kb_health --kb <slug> [--name <name>] [--at HH:MM] [--weekday 1-7] [--agent <agent_id>]";
1446
+ const AT_PATTERN = /^([01]\d|2[0-3]):[0-5]\d$/;
1447
+ const WEEKDAY_MIN = 1;
1448
+ const WEEKDAY_MAX = 7;
1449
+ const OPTIONS = {
1450
+ template: "template_key",
1451
+ kb: "kb_slug",
1452
+ name: "name",
1453
+ at: "at",
1454
+ weekday: "weekday",
1455
+ agent: "agent_id"
1456
+ };
1457
+ async function afSchedule(args, io) {
1458
+ const [sub, ...rest] = args;
1459
+ if (sub !== "create") {
1460
+ io.err(USAGE);
1461
+ return EXIT_USAGE;
1462
+ }
1463
+ const body = parseCreateArgs(rest);
1464
+ if (typeof body === "string") {
1465
+ io.err(body);
1466
+ return EXIT_USAGE;
1467
+ }
1468
+ const reply = await callSession("POST", SESSION_SCHEDULES_PATH, serialize(body), io);
1469
+ if ("exit" in reply) return reply.exit;
1470
+ if (!isOK(reply.status)) return reportFailure(reply, io);
1471
+ const data = unwrapData(reply.text);
1472
+ io.out(data === void 0 ? reply.text : JSON.stringify(data));
1473
+ return EXIT_OK;
1474
+ }
1475
+ function serialize(body) {
1476
+ return JSON.stringify(body);
1477
+ }
1478
+ function parseCreateArgs(args) {
1479
+ const given = /* @__PURE__ */ new Map();
1480
+ for (let i = 0; i < args.length; i++) {
1481
+ const a = args[i];
1482
+ if (!a.startsWith("--")) return `unexpected argument ${a}; ${USAGE}`;
1483
+ const eq = a.indexOf("=");
1484
+ const name = eq < 0 ? a.slice(2) : a.slice(2, eq);
1485
+ if (!(name in OPTIONS)) return `unknown option --${name}; ${USAGE}`;
1486
+ const value = eq < 0 ? args[++i] : a.slice(eq + 1);
1487
+ if (value === void 0 || value.trim() === "" || value.startsWith("--")) return `--${name} needs a value; ${USAGE}`;
1488
+ given.set(name, value);
1489
+ }
1490
+ return buildBody(given);
1491
+ }
1492
+ function buildBody(given) {
1493
+ const template = given.get("template");
1494
+ if (template === void 0 || !TEMPLATES.includes(template)) return `--template must be one of ${TEMPLATES.join(", ")}; ${USAGE}`;
1495
+ if (!given.has("kb")) return `--kb is required; ${USAGE}`;
1496
+ const at = given.get("at");
1497
+ if (at !== void 0 && !AT_PATTERN.test(at)) return `--at must be HH:MM (24-hour); ${USAGE}`;
1498
+ const weekday = given.get("weekday");
1499
+ if (weekday !== void 0 && !isWeekday(weekday)) return `--weekday must be an integer from ${WEEKDAY_MIN} to ${WEEKDAY_MAX} (1 = Monday); ${USAGE}`;
1500
+ const body = {};
1501
+ for (const [name, field] of Object.entries(OPTIONS)) {
1502
+ const value = given.get(name);
1503
+ if (value !== void 0) body[field] = name === "weekday" ? Number(value) : value;
1504
+ }
1505
+ return body;
1506
+ }
1507
+ function isWeekday(text) {
1508
+ const n = Number(text);
1509
+ return /^\d+$/.test(text) && n >= WEEKDAY_MIN && n <= WEEKDAY_MAX;
1510
+ }
1511
+ const SESSION_WIKI_ASK_PATH = "/session/wiki/ask";
1512
+ const SESSION_WIKI_LINES_PATH = "/session/wiki/lines";
1513
+ const LINE_FLAG = "--line";
1514
+ const USAGE_ASK = "usage: af wiki ask \"<question>\" [--line <line_id>]";
1515
+ const USAGE_WIKI = "usage: af wiki ask \"<question>\" [--line <line_id>] | af wiki lines";
1516
+ const NO_LINES = "没有可问的产品线(当前账号在知识库里没有任何产品线的访问权限)。";
1517
+ const PICK_LINE = "有多个产品线可问,请用 --line <产品线 id> 指定其一后重新提问:";
1518
+ async function afWiki(args, io) {
1519
+ const [sub, ...rest] = args;
1520
+ switch (sub) {
1521
+ case "ask": return ask(rest, io);
1522
+ case "lines": return lines(rest, io);
1523
+ default:
1524
+ io.err(USAGE_WIKI);
1525
+ return EXIT_USAGE;
1526
+ }
1527
+ }
1528
+ async function lines(args, io) {
1529
+ if (args.length > 0) {
1530
+ io.err("usage: af wiki lines");
1531
+ return EXIT_USAGE;
1532
+ }
1533
+ const found = await fetchLines(io);
1534
+ if (typeof found === "number") return found;
1535
+ if (found.length === 0) {
1536
+ io.err(NO_LINES);
1537
+ return EXIT_OK;
1538
+ }
1539
+ printLines(found, io);
1540
+ return EXIT_OK;
1541
+ }
1542
+ async function ask(args, io) {
1543
+ const parsed = parseAskArgs(args);
1544
+ if (typeof parsed === "string") {
1545
+ io.err(parsed);
1546
+ return EXIT_USAGE;
1547
+ }
1548
+ let lineID = parsed.line;
1549
+ if (lineID === void 0) {
1550
+ const found = await fetchLines(io);
1551
+ if (typeof found === "number") return found;
1552
+ if (found.length === 0) {
1553
+ io.err(NO_LINES);
1554
+ return EXIT_REJECTED;
1555
+ }
1556
+ if (found.length > 1) {
1557
+ io.err(PICK_LINE);
1558
+ printLines(found, io);
1559
+ return EXIT_USAGE;
1560
+ }
1561
+ lineID = found[0].id;
1562
+ }
1563
+ const reply = await callSession("POST", SESSION_WIKI_ASK_PATH, JSON.stringify({
1564
+ question: parsed.question,
1565
+ line_id: lineID
1566
+ }), io);
1567
+ if ("exit" in reply) return reply.exit;
1568
+ if (!isOK(reply.status)) return reportFailure(reply, io);
1569
+ printAnswer(reply.text, io);
1570
+ return EXIT_OK;
1571
+ }
1572
+ function parseAskArgs(args) {
1573
+ let question;
1574
+ let line;
1575
+ for (let i = 0; i < args.length; i++) {
1576
+ const a = args[i];
1577
+ if (a === LINE_FLAG) {
1578
+ line = args[++i];
1579
+ if (line === void 0 || line === "" || line.startsWith("--")) return `${LINE_FLAG} needs a line id; ${USAGE_ASK}`;
1580
+ } else if (a.startsWith(`${LINE_FLAG}=`)) {
1581
+ line = a.slice(7);
1582
+ if (line === "") return `${LINE_FLAG} needs a line id; ${USAGE_ASK}`;
1583
+ } else if (a.startsWith("--")) return `unknown option ${a}; ${USAGE_ASK}`;
1584
+ else if (question === void 0) question = a;
1585
+ else return `unexpected argument ${a} (quote the whole question); ${USAGE_ASK}`;
1586
+ }
1587
+ return question === void 0 || question.trim() === "" ? USAGE_ASK : {
1588
+ question,
1589
+ line
1590
+ };
1591
+ }
1592
+ async function fetchLines(io) {
1593
+ const reply = await callSession("GET", SESSION_WIKI_LINES_PATH, void 0, io);
1594
+ if ("exit" in reply) return reply.exit;
1595
+ if (!isOK(reply.status)) return reportFailure(reply, io);
1596
+ const raw = unwrapData(reply.text)?.lines;
1597
+ const found = [];
1598
+ for (const v of Array.isArray(raw) ? raw : []) {
1599
+ const line = toLine(v);
1600
+ if (line === void 0) {
1601
+ io.err(`platform returned a wiki line whose id is not a string: ${JSON.stringify(v)}`);
1602
+ return EXIT_USAGE;
1603
+ }
1604
+ found.push(line);
1605
+ }
1606
+ return found;
1607
+ }
1608
+ function toLine(v) {
1609
+ const o = v;
1610
+ return o && typeof o.id === "string" ? {
1611
+ id: o.id,
1612
+ name: typeof o.name === "string" ? o.name : ""
1613
+ } : void 0;
1614
+ }
1615
+ function printLines(found, io) {
1616
+ for (const l of found) io.out(`${l.id} ${l.name}`);
1617
+ }
1618
+ function printAnswer(text, io) {
1619
+ const data = unwrapData(text);
1620
+ if (typeof data?.answer !== "string") {
1621
+ io.out(text);
1622
+ return;
1623
+ }
1624
+ io.out(data.answer);
1625
+ const sources = Array.isArray(data.sources) ? data.sources : [];
1626
+ if (sources.length === 0) return;
1627
+ io.out("");
1628
+ io.out("来源:");
1629
+ for (const s of sources) io.out(`- ${String(s.title ?? "")} ${String(s.url ?? "")}`.trimEnd());
1630
+ }
1631
+ const AF_USAGE = "用法:af submit <产出文件> | af ask <提问文件> | af task status|pause|resume <任务号> | af task draft <草稿文件> [--id <草稿 id>] | af wiki ask \"<问题>\" [--line <产品线>] | af wiki lines | af schedule create --template <模板> --kb <库> | af kb <子命令>(af kb --help 看全部:list / get / search / page / note / annotate 等)| af browser snapshot|navigate|click|scroll|type|key";
1632
+ async function runAf(args, io = defaultIO()) {
1633
+ const [sub, ...rest] = args;
1634
+ switch (sub) {
1635
+ case "submit": return afSubmit(rest[0], io);
1636
+ case "ask": return afAsk(rest[0], io);
1637
+ case "browser": return afBrowser(rest, io);
1638
+ case "task":
1639
+ if (rest[0] === "draft") return afTaskDraft(rest.slice(1), io);
1640
+ return afTask(rest, io);
1641
+ case "wiki": return afWiki(rest, io);
1642
+ case "schedule": return afSchedule(rest, io);
1643
+ case "kb": return afKb(rest, io);
1644
+ case void 0:
1645
+ case "--help":
1646
+ case "-h":
1647
+ io.out(AF_USAGE);
1648
+ return EXIT_USAGE;
1649
+ }
1650
+ io.err(`af ${sub} 在当前环境还不可用。本节点需要的规格、上游产出与知识都已写在提示词和工作区里,直接读取即可;进度不用另行记录。`);
1651
+ return EXIT_USAGE;
1652
+ }
1653
+ export { runAf };