@nexusclawhq/cli 0.3.80 → 0.3.82

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.
Files changed (72) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/dist/build-info.json +4 -4
  3. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/command-routing.types.d.ts +99 -0
  4. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/command-routing.types.js +3 -0
  5. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/agent-executable-assets/command-routing.types.js.map +1 -0
  6. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/locales/en-US.d.ts +32 -0
  7. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/locales/en-US.js +32 -0
  8. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/locales/en-US.js.map +1 -1
  9. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/locales/index.d.ts +64 -0
  10. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/locales/zh-CN.d.ts +32 -0
  11. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/locales/zh-CN.js +32 -0
  12. package/dist/nexus-cli/node_modules/@nexusclaw/shared/dist/locales/zh-CN.js.map +1 -1
  13. package/dist/nexus-cli/src/cli.js +0 -0
  14. package/dist/nexus-cli/src/commands/data/import-records.d.ts +40 -0
  15. package/dist/nexus-cli/src/commands/data/import-records.js +100 -0
  16. package/dist/nexus-cli/src/commands/data/import-records.js.map +1 -0
  17. package/dist/nexus-cli/src/commands/data/import-records.test.d.ts +1 -0
  18. package/dist/nexus-cli/src/commands/data/import-records.test.js +40 -0
  19. package/dist/nexus-cli/src/commands/data/import-records.test.js.map +1 -0
  20. package/dist/nexus-cli/src/commands/data/index.js +3 -0
  21. package/dist/nexus-cli/src/commands/data/index.js.map +1 -1
  22. package/dist/nexus-cli/src/commands/metadata/diff.d.ts +2 -0
  23. package/dist/nexus-cli/src/commands/metadata/diff.js +5 -1
  24. package/dist/nexus-cli/src/commands/metadata/diff.js.map +1 -1
  25. package/dist/nexus-cli/src/commands/metadata/diff.test.d.ts +1 -0
  26. package/dist/nexus-cli/src/commands/metadata/diff.test.js +87 -0
  27. package/dist/nexus-cli/src/commands/metadata/diff.test.js.map +1 -0
  28. package/dist/nexus-cli/src/contracts/command-inventory.test.js +4 -4
  29. package/dist/nexus-cli/src/contracts/command-policy.exporter.test.js +2 -2
  30. package/dist/nexus-cli/src/contracts/command-policy.registry.js +8 -2
  31. package/dist/nexus-cli/src/contracts/command-policy.registry.js.map +1 -1
  32. package/dist/nexus-cli/src/contracts/command-policy.registry.test.js +4 -4
  33. package/dist/nexus-cli/src/contracts/command-policy.validator.test.js +2 -2
  34. package/dist/nexus-cli/src/contracts/command-routing.d.ts +25 -0
  35. package/dist/nexus-cli/src/contracts/command-routing.js +488 -0
  36. package/dist/nexus-cli/src/contracts/command-routing.js.map +1 -0
  37. package/dist/nexus-cli/src/contracts/command-routing.test.d.ts +1 -0
  38. package/dist/nexus-cli/src/contracts/command-routing.test.js +73 -0
  39. package/dist/nexus-cli/src/contracts/command-routing.test.js.map +1 -0
  40. package/dist/nexus-cli/src/contracts/task-route.registry.d.ts +40 -0
  41. package/dist/nexus-cli/src/contracts/task-route.registry.js +234 -0
  42. package/dist/nexus-cli/src/contracts/task-route.registry.js.map +1 -0
  43. package/dist/nexus-cli/src/contracts/task-route.registry.test.d.ts +1 -0
  44. package/dist/nexus-cli/src/contracts/task-route.registry.test.js +65 -0
  45. package/dist/nexus-cli/src/contracts/task-route.registry.test.js.map +1 -0
  46. package/dist/nexus-cli/src/services/api-client.d.ts +3 -0
  47. package/dist/nexus-cli/src/services/api-client.js +48 -11
  48. package/dist/nexus-cli/src/services/api-client.js.map +1 -1
  49. package/dist/nexus-cli/src/services/api-client.test.js +50 -0
  50. package/dist/nexus-cli/src/services/api-client.test.js.map +1 -1
  51. package/dist/nexus-cli/src/services/incremental-source-artifact.d.ts +8 -2
  52. package/dist/nexus-cli/src/services/incremental-source-artifact.js +13 -4
  53. package/dist/nexus-cli/src/services/incremental-source-artifact.js.map +1 -1
  54. package/dist/nexus-cli/src/services/incremental-source-artifact.test.js +30 -1
  55. package/dist/nexus-cli/src/services/incremental-source-artifact.test.js.map +1 -1
  56. package/dist/nexus-cli/src/services/incremental-source-stage.js +2 -0
  57. package/dist/nexus-cli/src/services/incremental-source-stage.js.map +1 -1
  58. package/dist/nexus-cli/src/services/incremental-source-stage.test.js +7 -0
  59. package/dist/nexus-cli/src/services/incremental-source-stage.test.js.map +1 -1
  60. package/dist/nexus-cli/src/services/source-tracker.d.ts +3 -1
  61. package/dist/nexus-cli/src/services/source-tracker.js +11 -2
  62. package/dist/nexus-cli/src/services/source-tracker.js.map +1 -1
  63. package/dist/nexus-cli/src/services/update-check.js +2 -3
  64. package/dist/nexus-cli/src/services/update-check.js.map +1 -1
  65. package/dist/nexus-cli/src/services/update-check.test.js +6 -2
  66. package/dist/nexus-cli/src/services/update-check.test.js.map +1 -1
  67. package/dist/nexus-cli/src/services/workforce-bundle-archive.d.ts +1 -1
  68. package/dist/nexus-cli/src/services/workforce-bundle-remote.d.ts +1 -1
  69. package/dist/nexus-cli/src/services/workforce-test-remote.d.ts +1 -1
  70. package/dist/nexus-cli/src/services/workforce-test-remote.js +1 -1
  71. package/dist/tsconfig.tsbuildinfo +1 -1
  72. package/package.json +1 -1
@@ -0,0 +1,234 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.CLI_TASK_ROUTE_SCHEMA_VERSION = void 0;
4
+ exports.matchTaskRouteCandidates = matchTaskRouteCandidates;
5
+ exports.resolveTaskRoute = resolveTaskRoute;
6
+ exports.listTaskRoutes = listTaskRoutes;
7
+ const shared_1 = require("@nexusclaw/shared");
8
+ const command_contract_1 = require("./command-contract");
9
+ const command_contract_registry_1 = require("./command-contract.registry");
10
+ exports.CLI_TASK_ROUTE_SCHEMA_VERSION = 'nexusclaw.cli-task-route/v1';
11
+ const STOP_POLICY = {
12
+ successEvidence: 'Record the required evidence once, then stop the route.',
13
+ nonRetryableErrors: ['usage', 'permission', 'validation', 'quota'],
14
+ maxNetworkRetries: 1,
15
+ noProgressLimit: 2,
16
+ };
17
+ const ROUTE_SEEDS = [
18
+ {
19
+ routeId: 'author.code-action.inspect',
20
+ goalPatterns: ['code action', 'code-action', '代码动作', '创建代码动作'],
21
+ phase: 'inspect',
22
+ commandId: 'employee.code.describe',
23
+ modeId: 'describe',
24
+ expectedCommandPath: 'employee code describe',
25
+ argvTemplate: 'nexus employee code describe --contract <version> --json',
26
+ expectedEffects: ['none'],
27
+ preconditions: ['A code-action contract identifier is available.'],
28
+ requiredEvidence: ['The resolved code-action contract and its digest.'],
29
+ stopPolicy: STOP_POLICY,
30
+ },
31
+ {
32
+ routeId: 'author.flow.inspect',
33
+ goalPatterns: ['flow', '流程', '创建流程', '编写流程'],
34
+ phase: 'inspect',
35
+ commandId: 'employee.flow.describe',
36
+ modeId: 'describe',
37
+ expectedCommandPath: 'employee flow describe',
38
+ argvTemplate: 'nexus employee flow describe --contract <version> --json',
39
+ expectedEffects: ['none'],
40
+ preconditions: ['A Flow contract identifier is available.'],
41
+ requiredEvidence: ['The resolved Flow contract and its digest.'],
42
+ stopPolicy: STOP_POLICY,
43
+ },
44
+ {
45
+ routeId: 'workforce.learning-signals.inspect',
46
+ goalPatterns: ['learning signal', 'learning signals', '学习信号', '查看学习信号', '请查看学习信号'],
47
+ phase: 'inspect',
48
+ commandId: 'workforce.learning.signals',
49
+ modeId: 'default',
50
+ expectedCommandPath: 'workforce learning signals',
51
+ argvTemplate: 'nexus workforce learning signals --target-org <org> --json',
52
+ expectedEffects: ['remote_read'],
53
+ preconditions: ['The target organization is explicitly selected.'],
54
+ requiredEvidence: ['The returned signal ids and query receipt.'],
55
+ stopPolicy: STOP_POLICY,
56
+ },
57
+ {
58
+ routeId: 'workforce.learning-candidates.inspect',
59
+ goalPatterns: ['learning candidate', 'learning candidates', '学习候选', '查看学习候选', '请查看学习候选'],
60
+ phase: 'inspect',
61
+ commandId: 'workforce.learning.candidates',
62
+ modeId: 'default',
63
+ expectedCommandPath: 'workforce learning candidates',
64
+ argvTemplate: 'nexus workforce learning candidates --target-org <org> --json',
65
+ expectedEffects: ['remote_read'],
66
+ preconditions: ['The target organization is explicitly selected.'],
67
+ requiredEvidence: ['The returned candidate ids and query receipt.'],
68
+ stopPolicy: STOP_POLICY,
69
+ },
70
+ {
71
+ routeId: 'workforce.task-dispatch.prepare',
72
+ goalPatterns: ['dispatch task', 'task dispatch', '分派任务', '派发任务'],
73
+ phase: 'prepare',
74
+ commandId: 'workforce.task.dispatch',
75
+ modeId: 'default',
76
+ expectedCommandPath: 'workforce task dispatch',
77
+ argvTemplate: 'nexus workforce task dispatch --target-org <org> --input <json> --json',
78
+ expectedEffects: ['remote_write'],
79
+ preconditions: [
80
+ 'The target organization and task input are explicit.',
81
+ 'The caller has reviewed the remote-write effect.',
82
+ ],
83
+ requiredEvidence: ['A plan digest and explicit authorization before execution.'],
84
+ stopPolicy: STOP_POLICY,
85
+ },
86
+ {
87
+ routeId: 'workforce.execution-stop.prepare',
88
+ goalPatterns: ['stop execution', 'cancel execution', '停止执行', '取消执行'],
89
+ phase: 'prepare',
90
+ commandId: 'workforce.execution.cancel',
91
+ modeId: 'default',
92
+ expectedCommandPath: 'workforce execution cancel',
93
+ argvTemplate: 'nexus workforce execution cancel --target-org <org> --execution-id <id> --request-id <id> --json',
94
+ expectedEffects: ['remote_write'],
95
+ preconditions: [
96
+ 'The execution id and stop request id are explicit.',
97
+ 'The caller has reviewed the remote-write effect.',
98
+ ],
99
+ requiredEvidence: ['A plan digest and the cancellation acknowledgement.'],
100
+ stopPolicy: STOP_POLICY,
101
+ },
102
+ ];
103
+ function normalizeGoal(value) {
104
+ return value
105
+ .trim()
106
+ .toLocaleLowerCase('en-US')
107
+ .replace(/[\u2010-\u2015\u2212]/g, '-')
108
+ .replace(/[,。!?、,:;!?]+/g, ' ')
109
+ .replace(/\s+/g, ' ')
110
+ .trim();
111
+ }
112
+ function scorePattern(goal, pattern) {
113
+ const normalizedPattern = normalizeGoal(pattern);
114
+ if (!normalizedPattern)
115
+ return 0;
116
+ return goal === normalizedPattern ? 1 : 0;
117
+ }
118
+ function resolveTarget(seed) {
119
+ const registered = command_contract_registry_1.commandContractRegistry.find(seed.commandId);
120
+ if (!registered) {
121
+ return { ok: false, message: `Route target is missing from the command registry: ${seed.commandId}` };
122
+ }
123
+ const modes = (0, command_contract_1.implementedModesOf)(registered.contract);
124
+ const mode = modes.find((candidate) => candidate.modeId === seed.modeId);
125
+ if (!mode) {
126
+ return { ok: false, message: `Route target mode is not implemented: ${seed.commandId}#${seed.modeId}` };
127
+ }
128
+ if (registered.contract.path !== seed.expectedCommandPath) {
129
+ return { ok: false, message: `Route target path drifted: ${seed.commandId}` };
130
+ }
131
+ if (JSON.stringify(mode.effects) !== JSON.stringify(seed.expectedEffects)) {
132
+ return { ok: false, message: `Route target effects drifted: ${seed.commandId}#${seed.modeId}` };
133
+ }
134
+ const contractDigest = (0, shared_1.canonicalJsonDigest)({
135
+ contract: registered.contract,
136
+ mode,
137
+ });
138
+ const route = {
139
+ routeId: seed.routeId,
140
+ goalPatterns: seed.goalPatterns,
141
+ phase: seed.phase,
142
+ commandId: seed.commandId,
143
+ modeId: seed.modeId,
144
+ commandPath: registered.contract.path,
145
+ argvTemplate: seed.argvTemplate,
146
+ preconditions: seed.preconditions,
147
+ requiredEvidence: seed.requiredEvidence,
148
+ allowedEffects: mode.effects,
149
+ stopPolicy: seed.stopPolicy,
150
+ };
151
+ return { ok: true, contract: route, mode, contractDigest };
152
+ }
153
+ function scoreRoute(goal, route) {
154
+ return Math.max(goal === normalizeGoal(route.routeId) ? 1 : 0, ...route.goalPatterns.map((pattern) => scorePattern(goal, pattern)));
155
+ }
156
+ function matchTaskRouteCandidates(goal, routes = ROUTE_SEEDS) {
157
+ const normalizedGoal = normalizeGoal(goal);
158
+ if (!normalizedGoal)
159
+ return [];
160
+ const matches = routes
161
+ .map((route) => ({ route, score: scoreRoute(normalizedGoal, route) }))
162
+ .filter((entry) => entry.score > 0)
163
+ .sort((left, right) => right.score - left.score || left.route.routeId.localeCompare(right.route.routeId));
164
+ if (matches.length === 0)
165
+ return [];
166
+ const topScore = matches[0].score;
167
+ return matches
168
+ .filter((entry) => entry.score === topScore)
169
+ .map((entry) => entry.route.routeId);
170
+ }
171
+ function resolveTaskRoute(goal) {
172
+ const normalizedGoal = normalizeGoal(goal);
173
+ if (!normalizedGoal) {
174
+ return {
175
+ ok: false,
176
+ code: 'CLI_ROUTE_NOT_FOUND',
177
+ message: 'A non-empty goal is required to resolve a task route.',
178
+ candidates: [],
179
+ };
180
+ }
181
+ const matches = ROUTE_SEEDS
182
+ .map((seed) => ({ seed, score: scoreRoute(normalizedGoal, seed) }))
183
+ .filter((entry) => entry.score > 0)
184
+ .sort((left, right) => right.score - left.score || left.seed.routeId.localeCompare(right.seed.routeId));
185
+ if (matches.length === 0) {
186
+ return {
187
+ ok: false,
188
+ code: 'CLI_ROUTE_NOT_FOUND',
189
+ message: `No registered task route matches goal: ${goal}`,
190
+ candidates: [],
191
+ };
192
+ }
193
+ const topScore = matches[0].score;
194
+ const top = matches.filter((entry) => entry.score === topScore);
195
+ if (top.length > 1) {
196
+ return {
197
+ ok: false,
198
+ code: 'CLI_ROUTE_AMBIGUOUS',
199
+ message: `Multiple task routes match goal: ${goal}`,
200
+ candidates: top.map((entry) => entry.seed.routeId),
201
+ };
202
+ }
203
+ const target = resolveTarget(top[0].seed);
204
+ if (!target.ok) {
205
+ return {
206
+ ok: false,
207
+ code: 'CLI_ROUTE_REGISTRY_DRIFT',
208
+ message: target.message,
209
+ candidates: [top[0].seed.routeId],
210
+ };
211
+ }
212
+ const planWithoutDigest = {
213
+ schemaVersion: exports.CLI_TASK_ROUTE_SCHEMA_VERSION,
214
+ route: target.contract,
215
+ contractDigest: target.contractDigest,
216
+ };
217
+ return {
218
+ ok: true,
219
+ plan: {
220
+ ...planWithoutDigest,
221
+ planDigest: (0, shared_1.canonicalJsonDigest)(planWithoutDigest),
222
+ },
223
+ };
224
+ }
225
+ function listTaskRoutes() {
226
+ return ROUTE_SEEDS.map((seed) => {
227
+ const target = resolveTarget(seed);
228
+ if (!target.ok) {
229
+ throw new Error(`CLI_ROUTE_REGISTRY_DRIFT: ${target.message}`);
230
+ }
231
+ return Object.freeze(target.contract);
232
+ });
233
+ }
234
+ //# sourceMappingURL=task-route.registry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"task-route.registry.js","sourceRoot":"","sources":["../../../../src/contracts/task-route.registry.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,65 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ const strict_1 = __importDefault(require("node:assert/strict"));
7
+ const node_test_1 = __importDefault(require("node:test"));
8
+ const task_route_registry_1 = require("./task-route.registry");
9
+ (0, node_test_1.default)('task routes resolve a unique canonical command and bounded plan', () => {
10
+ const result = (0, task_route_registry_1.resolveTaskRoute)('请查看学习信号');
11
+ strict_1.default.equal(result.ok, true);
12
+ if (!result.ok)
13
+ return;
14
+ strict_1.default.equal(result.plan.schemaVersion, task_route_registry_1.CLI_TASK_ROUTE_SCHEMA_VERSION);
15
+ strict_1.default.equal(result.plan.route.routeId, 'workforce.learning-signals.inspect');
16
+ strict_1.default.equal(result.plan.route.commandId, 'workforce.learning.signals');
17
+ strict_1.default.equal(result.plan.route.modeId, 'default');
18
+ strict_1.default.equal(result.plan.route.argvTemplate, 'nexus workforce learning signals --target-org <org> --json');
19
+ strict_1.default.deepEqual(result.plan.route.allowedEffects, ['remote_read']);
20
+ strict_1.default.match(result.plan.contractDigest, /^sha256:[0-9a-f]{64}$/);
21
+ strict_1.default.match(result.plan.planDigest, /^sha256:[0-9a-f]{64}$/);
22
+ strict_1.default.equal(result.plan.route.stopPolicy.maxNetworkRetries, 1);
23
+ strict_1.default.equal(result.plan.route.stopPolicy.noProgressLimit, 2);
24
+ const byRouteId = (0, task_route_registry_1.resolveTaskRoute)('workforce.learning-signals.inspect');
25
+ strict_1.default.equal(byRouteId.ok, true);
26
+ if (byRouteId.ok)
27
+ strict_1.default.equal(byRouteId.plan.planDigest, result.plan.planDigest);
28
+ strict_1.default.equal((0, task_route_registry_1.resolveTaskRoute)('查看学习信号。').ok, true);
29
+ });
30
+ (0, node_test_1.default)('task routes fail closed for unknown goals and duplicate catalog candidates', () => {
31
+ const unknown = (0, task_route_registry_1.resolveTaskRoute)('帮我随便处理一下');
32
+ strict_1.default.equal(unknown.ok, false);
33
+ if (unknown.ok)
34
+ return;
35
+ strict_1.default.equal(unknown.code, 'CLI_ROUTE_NOT_FOUND');
36
+ strict_1.default.deepEqual(unknown.candidates, []);
37
+ strict_1.default.deepEqual((0, task_route_registry_1.matchTaskRouteCandidates)('flow code action'), []);
38
+ strict_1.default.deepEqual((0, task_route_registry_1.matchTaskRouteCandidates)('shared intent', [
39
+ { routeId: 'route-a', goalPatterns: ['shared intent'] },
40
+ { routeId: 'route-b', goalPatterns: ['shared intent'] },
41
+ ]), [
42
+ 'route-a',
43
+ 'route-b',
44
+ ]);
45
+ });
46
+ (0, node_test_1.default)('task routes do not match negated goals or substrings inside other words', () => {
47
+ const negated = (0, task_route_registry_1.resolveTaskRoute)('不要停止执行');
48
+ strict_1.default.equal(negated.ok, false);
49
+ if (!negated.ok)
50
+ strict_1.default.equal(negated.code, 'CLI_ROUTE_NOT_FOUND');
51
+ const substring = (0, task_route_registry_1.resolveTaskRoute)('workflow status');
52
+ strict_1.default.equal(substring.ok, false);
53
+ if (!substring.ok)
54
+ strict_1.default.equal(substring.code, 'CLI_ROUTE_NOT_FOUND');
55
+ });
56
+ (0, node_test_1.default)('every catalog route points to a resolvable implemented target', () => {
57
+ const routes = (0, task_route_registry_1.listTaskRoutes)();
58
+ strict_1.default.equal(routes.length, 6);
59
+ strict_1.default.equal(new Set(routes.map((route) => route.routeId)).size, routes.length);
60
+ for (const route of routes) {
61
+ const result = (0, task_route_registry_1.resolveTaskRoute)(route.goalPatterns[0]);
62
+ strict_1.default.equal(result.ok, true, route.routeId);
63
+ }
64
+ });
65
+ //# sourceMappingURL=task-route.registry.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"task-route.registry.test.js","sourceRoot":"","sources":["../../../../src/contracts/task-route.registry.test.ts"],"names":[],"mappings":";;;;;AAAA,gEAAwC;AACxC,0DAA6B;AAC7B,+DAK+B;AAE/B,IAAA,mBAAI,EAAC,iEAAiE,EAAE,GAAG,EAAE;IAC3E,MAAM,MAAM,GAAG,IAAA,sCAAgB,EAAC,SAAS,CAAC,CAAC;IAC3C,gBAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO;IACvB,gBAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,mDAA6B,CAAC,CAAC;IACvE,gBAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,oCAAoC,CAAC,CAAC;IAC9E,gBAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,4BAA4B,CAAC,CAAC;IACxE,gBAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClD,gBAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,4DAA4D,CAAC,CAAC;IAC3G,gBAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;IACpE,gBAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,uBAAuB,CAAC,CAAC;IAClE,gBAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,uBAAuB,CAAC,CAAC;IAC9D,gBAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC;IAChE,gBAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;IAE9D,MAAM,SAAS,GAAG,IAAA,sCAAgB,EAAC,oCAAoC,CAAC,CAAC;IACzE,gBAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACjC,IAAI,SAAS,CAAC,EAAE;QAAE,gBAAM,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAElF,gBAAM,CAAC,KAAK,CAAC,IAAA,sCAAgB,EAAC,SAAS,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;AACrD,CAAC,CAAC,CAAC;AAEH,IAAA,mBAAI,EAAC,4EAA4E,EAAE,GAAG,EAAE;IACtF,MAAM,OAAO,GAAG,IAAA,sCAAgB,EAAC,UAAU,CAAC,CAAC;IAC7C,gBAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAChC,IAAI,OAAO,CAAC,EAAE;QAAE,OAAO;IACvB,gBAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;IAClD,gBAAM,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAEzC,gBAAM,CAAC,SAAS,CAAC,IAAA,8CAAwB,EAAC,kBAAkB,CAAC,EAAE,EAAE,CAAC,CAAC;IACnE,gBAAM,CAAC,SAAS,CAAC,IAAA,8CAAwB,EAAC,eAAe,EAAE;QACzD,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,eAAe,CAAC,EAAE;QACvD,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,eAAe,CAAC,EAAE;KACxD,CAAC,EAAE;QACF,SAAS;QACT,SAAS;KACV,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,mBAAI,EAAC,yEAAyE,EAAE,GAAG,EAAE;IACnF,MAAM,OAAO,GAAG,IAAA,sCAAgB,EAAC,QAAQ,CAAC,CAAC;IAC3C,gBAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAChC,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,gBAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;IAEnE,MAAM,SAAS,GAAG,IAAA,sCAAgB,EAAC,iBAAiB,CAAC,CAAC;IACtD,gBAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAClC,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,gBAAM,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;AACzE,CAAC,CAAC,CAAC;AAEH,IAAA,mBAAI,EAAC,+DAA+D,EAAE,GAAG,EAAE;IACzE,MAAM,MAAM,GAAG,IAAA,oCAAc,GAAE,CAAC;IAChC,gBAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC/B,gBAAM,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAChF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,IAAA,sCAAgB,EAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAE,CAAC,CAAC;QACxD,gBAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC,CAAC,CAAC"}
@@ -255,6 +255,7 @@ export interface ApiResponse<T = unknown> {
255
255
  data?: T;
256
256
  error?: string;
257
257
  errors?: string[];
258
+ statusCode?: number;
258
259
  }
259
260
  export interface DeployResult {
260
261
  jobId: string;
@@ -964,6 +965,7 @@ export declare class ApiClient {
964
965
  private refreshOAuthTokenPair;
965
966
  private getHeaders;
966
967
  private request;
968
+ private requestOnce;
967
969
  private putRawBytes;
968
970
  uploadContentDocument(input: {
969
971
  filename: string;
@@ -984,6 +986,7 @@ export declare class ApiClient {
984
986
  put<T>(endpoint: string, body?: unknown): Promise<ApiResponse<T>>;
985
987
  delete<T>(endpoint: string): Promise<ApiResponse<T>>;
986
988
  graphql<T>(query: string, variables?: Record<string, unknown>): Promise<T>;
989
+ private graphqlRequest;
987
990
  graphqlWithStepUp<T>(query: string, variables: Record<string, unknown>, stepUpToken: string): Promise<T>;
988
991
  getCurrentUser(): Promise<{
989
992
  id: string;
@@ -334,8 +334,27 @@ class ApiClient {
334
334
  }
335
335
  return headers;
336
336
  }
337
- async request(method, endpoint, body, extraHeaders) {
337
+ async request(method, endpoint, body, extraHeaders, retrySafe = false) {
338
338
  await this.ensureValidToken();
339
+ const deadline = Date.now() + this.requestTimeoutMs;
340
+ for (let attempt = 0;; attempt++) {
341
+ const remaining = Math.max(1, deadline - Date.now());
342
+ try {
343
+ const result = await this.requestOnce(method, endpoint, body, extraHeaders, remaining);
344
+ if (!retrySafe || attempt >= 1 || ![429, 500, 502, 503, 504].includes(result.statusCode ?? 0) || deadline - Date.now() <= 500)
345
+ return result;
346
+ }
347
+ catch (error) {
348
+ const code = error?.code;
349
+ if (!retrySafe || attempt >= 1 || !['ECONNRESET', 'EAI_AGAIN', 'ETIMEDOUT'].includes(code ?? '') || deadline - Date.now() <= 500)
350
+ throw error;
351
+ }
352
+ if (!process.argv.includes('--json'))
353
+ process.stderr.write('网络暂时不可用,正在重试只读请求(第 2 次)…\n');
354
+ await new Promise(resolve => setTimeout(resolve, 200 + Math.floor(Math.random() * 100)));
355
+ }
356
+ }
357
+ async requestOnce(method, endpoint, body, extraHeaders, timeoutMs) {
339
358
  return new Promise((resolve, reject) => {
340
359
  const url = new url_1.URL(endpoint, this.baseUrl);
341
360
  const isHttps = url.protocol === 'https:';
@@ -396,6 +415,7 @@ class ApiClient {
396
415
  success: false,
397
416
  error: detail,
398
417
  errors: parsed.errors,
418
+ statusCode: res.statusCode,
399
419
  });
400
420
  }
401
421
  }
@@ -403,6 +423,7 @@ class ApiClient {
403
423
  const preview = data.replace(/\s+/gu, ' ').trim().slice(0, 160);
404
424
  resolve({
405
425
  success: false,
426
+ statusCode: res.statusCode,
406
427
  error: `响应解析失败:${endpointLabel(url)} 返回了无法解析的内容(HTTP ${res.statusCode ?? 'unknown'},` +
407
428
  `content-type: ${res.headers['content-type'] ?? 'unknown'})。` +
408
429
  '常见原因是实例地址(NEXUS_BASE_URL / login-web --instance-url)指向了错误的服务,或被网关/代理拦截。' +
@@ -419,10 +440,10 @@ class ApiClient {
419
440
  '请运行 nexus org login-web --instance-url <实例地址> 配置实际实例;可运行 nexus doctor 查看诊断。'));
420
441
  return;
421
442
  }
422
- reject(new Error(`网络请求失败:${endpointLabel(url)} ${err.message}。` +
423
- '请先确认实例地址正确、本机网络/代理可以访问该地址;若地址与网络均正常且持续失败,再作为平台问题上报(附 nexus doctor 输出)。'));
443
+ reject(Object.assign(new Error(`网络请求失败:${endpointLabel(url)} ${err.message}。` +
444
+ '请先确认实例地址正确、本机网络/代理可以访问该地址;若地址与网络均正常且持续失败,再作为平台问题上报(附 nexus doctor 输出)。'), { code: errnoCode }));
424
445
  });
425
- req.setTimeout(this.requestTimeoutMs, () => {
446
+ req.setTimeout(timeoutMs, () => {
426
447
  req.destroy();
427
448
  reject(new Error(`请求超时:${endpointLabel(url)} 在 ${this.requestTimeoutMs}ms 内未响应。` +
428
449
  `可能是网络链路较慢或平台服务繁忙;可通过 NEXUS_API_TIMEOUT_MS 调大超时后重试(当前 ${this.requestTimeoutMs}ms)。`));
@@ -565,7 +586,7 @@ class ApiClient {
565
586
  });
566
587
  }
567
588
  get(endpoint) {
568
- return this.request('GET', endpoint);
589
+ return this.request('GET', endpoint, undefined, undefined, true);
569
590
  }
570
591
  post(endpoint, body) {
571
592
  return this.request('POST', endpoint, body);
@@ -649,7 +670,10 @@ class ApiClient {
649
670
  return this.request('DELETE', endpoint);
650
671
  }
651
672
  async graphql(query, variables) {
652
- const res = await this.post('/graphql', { query, variables });
673
+ return this.graphqlRequest(query, variables, false);
674
+ }
675
+ async graphqlRequest(query, variables, retrySafe) {
676
+ const res = await this.request('POST', '/graphql', { query, variables }, undefined, retrySafe);
653
677
  if (res.errors?.length) {
654
678
  throw new GraphQLApiError(res.errors
655
679
  .map(normalizeGraphQLError));
@@ -1274,7 +1298,7 @@ class ApiClient {
1274
1298
  return plan;
1275
1299
  }
1276
1300
  async getSourceStatus() {
1277
- const response = await this.graphql(`query SourceStatus {
1301
+ const response = await this.graphqlRequest(`query SourceStatus {
1278
1302
  sourceStatus {
1279
1303
  remoteRevision
1280
1304
  remoteHash
@@ -1306,7 +1330,7 @@ class ApiClient {
1306
1330
  drift
1307
1331
  tracking
1308
1332
  }
1309
- }`);
1333
+ }`, undefined, true);
1310
1334
  return response.sourceStatus;
1311
1335
  }
1312
1336
  async getRemoteChanges(workspaceId) {
@@ -1338,7 +1362,7 @@ class ApiClient {
1338
1362
  return response.localChanges;
1339
1363
  }
1340
1364
  async getSourceFiles(input) {
1341
- const response = await this.graphql(`query SourceFiles($paths: [String!], $recordAccess: Boolean) {
1365
+ const response = await this.graphqlRequest(`query SourceFiles($paths: [String!], $recordAccess: Boolean) {
1342
1366
  sourceFiles(paths: $paths, recordAccess: $recordAccess) {
1343
1367
  remoteRevision
1344
1368
  files {
@@ -1353,7 +1377,7 @@ class ApiClient {
1353
1377
  releaseSetId
1354
1378
  }
1355
1379
  }
1356
- }`, input);
1380
+ }`, input, input?.recordAccess !== true);
1357
1381
  const sourceFiles = response.sourceFiles;
1358
1382
  return {
1359
1383
  remoteRevision: sourceFiles?.remoteRevision ?? '',
@@ -1394,7 +1418,20 @@ class ApiClient {
1394
1418
  responseDetail: options?.responseDetail ?? 'summary',
1395
1419
  });
1396
1420
  if (!res.success) {
1397
- throw new Error(res.error || 'metadata runtime 导入失败');
1421
+ const gatewayTimeout = res.statusCode === 408 || res.statusCode === 504;
1422
+ const hint = gatewayTimeout
1423
+ ? `(HTTP ${res.statusCode} 通常来自网关/代理超时:导入可能已在服务端完成。请先用 nexus metadata diff 或 import --dry-run 回读核对实际状态,再决定是否重试,避免重复导入。)`
1424
+ : '';
1425
+ const error = new Error(`${res.error || 'metadata runtime 导入失败'}${hint}`);
1426
+ Object.assign(error, {
1427
+ code: 'METADATA_IMPORT_REQUEST_FAILED',
1428
+ details: {
1429
+ httpStatus: res.statusCode ?? null,
1430
+ endpoint: '/api/metadata/runtime/import',
1431
+ ...(gatewayTimeout ? { possiblyAppliedServerSide: true } : {}),
1432
+ },
1433
+ });
1434
+ throw error;
1398
1435
  }
1399
1436
  if (!res.data) {
1400
1437
  throw new Error('metadata runtime 导入响应缺少 data');