clinkx 1.3.0 → 1.4.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.
Files changed (123) hide show
  1. package/CHANGELOG.md +28 -0
  2. package/README.md +13 -6
  3. package/clinkx-workflows/dist/child-env.d.ts +3 -0
  4. package/clinkx-workflows/dist/child-env.js +11 -0
  5. package/clinkx-workflows/dist/child-env.js.map +1 -1
  6. package/clinkx-workflows/dist/dashboard/api-routes.d.ts +21 -0
  7. package/clinkx-workflows/dist/dashboard/api-routes.js +27 -0
  8. package/clinkx-workflows/dist/dashboard/api-routes.js.map +1 -1
  9. package/clinkx-workflows/dist/dashboard/auth/challenge-store.d.ts +13 -0
  10. package/clinkx-workflows/dist/dashboard/auth/challenge-store.js.map +1 -1
  11. package/clinkx-workflows/dist/dashboard/auth/controller.d.ts +27 -0
  12. package/clinkx-workflows/dist/dashboard/auth/controller.js +262 -23
  13. package/clinkx-workflows/dist/dashboard/auth/controller.js.map +1 -1
  14. package/clinkx-workflows/dist/dashboard/auth/settings-step-up.d.ts +62 -0
  15. package/clinkx-workflows/dist/dashboard/auth/settings-step-up.js +70 -0
  16. package/clinkx-workflows/dist/dashboard/auth/settings-step-up.js.map +1 -0
  17. package/clinkx-workflows/dist/dashboard/request-admission.d.ts +6 -0
  18. package/clinkx-workflows/dist/dashboard/request-admission.js +9 -0
  19. package/clinkx-workflows/dist/dashboard/request-admission.js.map +1 -1
  20. package/clinkx-workflows/dist/dashboard/server-factory.js +15 -1
  21. package/clinkx-workflows/dist/dashboard/server-factory.js.map +1 -1
  22. package/clinkx-workflows/dist/dashboard/settings-contract.d.ts +1806 -0
  23. package/clinkx-workflows/dist/dashboard/settings-contract.js +630 -0
  24. package/clinkx-workflows/dist/dashboard/settings-contract.js.map +1 -0
  25. package/clinkx-workflows/dist/dashboard/settings-process-reader.d.ts +48 -0
  26. package/clinkx-workflows/dist/dashboard/settings-process-reader.js +195 -0
  27. package/clinkx-workflows/dist/dashboard/settings-process-reader.js.map +1 -0
  28. package/clinkx-workflows/dist/dashboard/settings-routes.d.ts +87 -0
  29. package/clinkx-workflows/dist/dashboard/settings-routes.js +690 -0
  30. package/clinkx-workflows/dist/dashboard/settings-routes.js.map +1 -0
  31. package/clinkx-workflows/dist/dashboard-ui/assets/index-DSOtuS0p.js +122 -0
  32. package/clinkx-workflows/dist/dashboard-ui/assets/style-C5guUjwN.css +1 -0
  33. package/clinkx-workflows/dist/dashboard-ui/index.html +2 -2
  34. package/clinkx-workflows/dist/durable-file-core.d.ts +76 -0
  35. package/clinkx-workflows/dist/durable-file-core.js +146 -0
  36. package/clinkx-workflows/dist/durable-file-core.js.map +1 -0
  37. package/clinkx-workflows/dist/durable-file.d.ts +8 -64
  38. package/clinkx-workflows/dist/durable-file.js +14 -137
  39. package/clinkx-workflows/dist/durable-file.js.map +1 -1
  40. package/clinkx-workflows/dist/index.js +68 -2
  41. package/clinkx-workflows/dist/index.js.map +1 -1
  42. package/clinkx-workflows/dist/settings/audit.d.ts +101 -0
  43. package/clinkx-workflows/dist/settings/audit.js +318 -0
  44. package/clinkx-workflows/dist/settings/audit.js.map +1 -0
  45. package/clinkx-workflows/dist/settings/bootstrap.d.ts +35 -0
  46. package/clinkx-workflows/dist/settings/bootstrap.js +52 -0
  47. package/clinkx-workflows/dist/settings/bootstrap.js.map +1 -0
  48. package/clinkx-workflows/dist/settings/codec.d.ts +51 -0
  49. package/clinkx-workflows/dist/settings/codec.js +410 -0
  50. package/clinkx-workflows/dist/settings/codec.js.map +1 -0
  51. package/clinkx-workflows/dist/settings/durable-write.d.ts +48 -0
  52. package/clinkx-workflows/dist/settings/durable-write.js +31 -0
  53. package/clinkx-workflows/dist/settings/durable-write.js.map +1 -0
  54. package/clinkx-workflows/dist/settings/index.d.ts +20 -0
  55. package/clinkx-workflows/dist/settings/index.js +23 -0
  56. package/clinkx-workflows/dist/settings/index.js.map +1 -0
  57. package/clinkx-workflows/dist/settings/loader.d.ts +80 -0
  58. package/clinkx-workflows/dist/settings/loader.js +577 -0
  59. package/clinkx-workflows/dist/settings/loader.js.map +1 -0
  60. package/clinkx-workflows/dist/settings/lock.d.ts +108 -0
  61. package/clinkx-workflows/dist/settings/lock.js +344 -0
  62. package/clinkx-workflows/dist/settings/lock.js.map +1 -0
  63. package/clinkx-workflows/dist/settings/paths.d.ts +65 -0
  64. package/clinkx-workflows/dist/settings/paths.js +173 -0
  65. package/clinkx-workflows/dist/settings/paths.js.map +1 -0
  66. package/clinkx-workflows/dist/settings/process-heartbeat.d.ts +47 -0
  67. package/clinkx-workflows/dist/settings/process-heartbeat.js +305 -0
  68. package/clinkx-workflows/dist/settings/process-heartbeat.js.map +1 -0
  69. package/clinkx-workflows/dist/settings/registry.d.ts +178 -0
  70. package/clinkx-workflows/dist/settings/registry.js +1285 -0
  71. package/clinkx-workflows/dist/settings/registry.js.map +1 -0
  72. package/clinkx-workflows/dist/settings/schema.d.ts +404 -0
  73. package/clinkx-workflows/dist/settings/schema.js +415 -0
  74. package/clinkx-workflows/dist/settings/schema.js.map +1 -0
  75. package/clinkx-workflows/dist/settings/store.d.ts +157 -0
  76. package/clinkx-workflows/dist/settings/store.js +842 -0
  77. package/clinkx-workflows/dist/settings/store.js.map +1 -0
  78. package/clinkx-workflows/dist/stdio-entry.d.ts +2 -0
  79. package/clinkx-workflows/dist/stdio-entry.js +52 -0
  80. package/clinkx-workflows/dist/stdio-entry.js.map +1 -0
  81. package/dist/dashboard-cli.js +50 -1
  82. package/dist/dashboard-cli.js.map +1 -1
  83. package/dist/dashboard-companion/protocol.js +17 -0
  84. package/dist/dashboard-companion/protocol.js.map +1 -1
  85. package/dist/dashboard-gateway/control-plane/contracts.d.ts +38 -38
  86. package/dist/dashboard-gateway/tunnel-http.js +20 -0
  87. package/dist/dashboard-gateway/tunnel-http.js.map +1 -1
  88. package/dist/elaris/config.d.ts +10 -0
  89. package/dist/elaris/config.js +27 -1
  90. package/dist/elaris/config.js.map +1 -1
  91. package/dist/elaris/tools.js +4 -1
  92. package/dist/elaris/tools.js.map +1 -1
  93. package/dist/index.d.ts +0 -31
  94. package/dist/index.js +41 -404
  95. package/dist/index.js.map +1 -1
  96. package/dist/lib.d.ts +17 -0
  97. package/dist/lib.js +17 -0
  98. package/dist/lib.js.map +1 -0
  99. package/dist/progress-report/lock.d.ts +17 -59
  100. package/dist/progress-report/lock.js +25 -329
  101. package/dist/progress-report/lock.js.map +1 -1
  102. package/dist/server.js +75 -4
  103. package/dist/server.js.map +1 -1
  104. package/dist/settings-cli/clients.d.ts +137 -0
  105. package/dist/settings-cli/clients.js +1124 -0
  106. package/dist/settings-cli/clients.js.map +1 -0
  107. package/dist/settings-cli/commands.d.ts +67 -0
  108. package/dist/settings-cli/commands.js +726 -0
  109. package/dist/settings-cli/commands.js.map +1 -0
  110. package/dist/settings-cli/format.d.ts +34 -0
  111. package/dist/settings-cli/format.js +40 -0
  112. package/dist/settings-cli/format.js.map +1 -0
  113. package/dist/settings-cli/main.d.ts +18 -0
  114. package/dist/settings-cli/main.js +256 -0
  115. package/dist/settings-cli/main.js.map +1 -0
  116. package/dist/stdio-main.d.ts +73 -0
  117. package/dist/stdio-main.js +455 -0
  118. package/dist/stdio-main.js.map +1 -0
  119. package/docs/configuration.md +340 -39
  120. package/docs/security.md +150 -6
  121. package/package.json +2 -2
  122. package/clinkx-workflows/dist/dashboard-ui/assets/index-DRId2DVA.js +0 -119
  123. package/clinkx-workflows/dist/dashboard-ui/assets/style-CHAw57y5.css +0 -1
package/dist/index.js CHANGED
@@ -1,346 +1,28 @@
1
1
  #!/usr/bin/env node
2
- import { realpathSync } from "node:fs";
3
- import { fileURLToPath, pathToFileURL } from "node:url";
4
- import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
5
- import { serializeMessage } from "@modelcontextprotocol/sdk/shared/stdio.js";
6
- import { createServer } from "./server.js";
7
- import { latchVerificationAdmissionForShutdown, shutdownVerificationTools } from "./verification-tools.js";
8
- import { logger, assertStderrLogger } from "./logger.js";
9
- import { assertNotRootDir } from "./paths.js";
10
- import { activeProcesses, killAllActive, latchSubprocessAdmissionForShutdown, } from "./runner.js";
11
- import { latchAppServerAdmissionForShutdown, setAppServerActivityObserver, shutdownAppServerRegistry, } from "./codex/app-server-registry.js";
12
- import { createRootStdioActivity } from "./stdio-activity.js";
13
- import { setWorkflowActivityObserver, } from "../clinkx-workflows/dist/workflow-tools.js";
14
- import { shutdownCoordinator } from "../clinkx-workflows/dist/shutdown.js";
15
- import { createStdioWatchdog } from "../clinkx-workflows/dist/stdio-watchdog.js";
16
- const SHUTDOWN_DEADLINE_MS = 10_000;
17
- const SEND_TIMEOUT_MS = 30_000;
18
- const patchedTransports = new WeakSet();
19
2
  /**
20
- * Run every root-owned cleanup surface, preserving later cleanup when an
21
- * earlier surface fails. The first failure is rethrown after all surfaces have
22
- * had their bounded opportunity to clean up.
3
+ * ClinkX bin entry (dist/index.js) — startup bootstrap shim (A2-1).
4
+ *
5
+ * The ONLY static import is the settings bootstrap, whose import closure is
6
+ * logger/config/pino-free (loader-import-graph.test.ts walks it). Everything
7
+ * else — the logger, the server, the pipeline — is loaded dynamically after
8
+ * applyStartupSettings(process.env) has overlaid dashboard settings file
9
+ * values, so module-load env readers (CLINKX_LOG_LEVEL, the concurrency
10
+ * singleton) observe the overlay. This file deliberately exports nothing: a
11
+ * static re-export of the stdio-main helpers would pull the runtime graph
12
+ * ahead of the bootstrap and silently defeat the overlay. Library consumers
13
+ * import the package main (dist/lib.js — src/lib.ts), which re-exports those
14
+ * helpers side-effect-free; only the bin path runs this shim.
15
+ *
16
+ * Behavior:
17
+ * - library import (main: dist/lib.js): nothing runs — importing the package
18
+ * never starts a server and never mutates env;
19
+ * - `clinkx settings …`: dynamic-imports the settings CLI (A3-1 replaces its
20
+ * body); no server starts and no settings file is read;
21
+ * - otherwise: applyStartupSettings, then dynamic-import ./stdio-main.js.
23
22
  */
24
- export function createRootCleanup(options = {}) {
25
- const cleanups = [
26
- {
27
- name: "shutdownVerificationTools",
28
- run: options.shutdownVerificationToolsFn ?? shutdownVerificationTools,
29
- },
30
- {
31
- name: "killAllActive",
32
- run: options.killAllActiveFn ?? (async () => {
33
- await killAllActive();
34
- }),
35
- },
36
- {
37
- name: "shutdownAppServerRegistry",
38
- run: options.shutdownAppServerRegistryFn ?? shutdownAppServerRegistry,
39
- },
40
- {
41
- name: "shutdownWorkflowCoordinator",
42
- run: options.shutdownWorkflowCoordinatorFn ?? ((reason) => shutdownCoordinator.shutdown(reason)),
43
- },
44
- ];
45
- return async (reason) => {
46
- let failed = false;
47
- let firstError;
48
- const recordFailure = (cleanupName, err) => {
49
- failed = true;
50
- firstError ??= err;
51
- try {
52
- logger.error({
53
- reason,
54
- cleanup: cleanupName,
55
- err: err instanceof Error ? err.message : String(err),
56
- }, "shutdown cleanup surface failed");
57
- }
58
- catch {
59
- // A broken logger must not prevent the remaining cleanup surfaces from
60
- // settling or replace the cleanup failure being reported.
61
- }
62
- };
63
- const pending = [];
64
- for (const cleanup of cleanups) {
65
- try {
66
- // Invoke each surface before awaiting any result. Workflow shutdown
67
- // must latch active runs even if generic process cleanup is draining.
68
- pending.push(Promise.resolve(cleanup.run(reason)).catch((err) => {
69
- recordFailure(cleanup.name, err);
70
- }));
71
- }
72
- catch (err) {
73
- recordFailure(cleanup.name, err);
74
- }
75
- }
76
- await Promise.all(pending);
77
- if (failed) {
78
- throw firstError instanceof Error
79
- ? firstError
80
- : new Error("one or more shutdown cleanup surfaces failed");
81
- }
82
- };
83
- }
84
- export function createShutdownOnce(server, options = {}) {
85
- let shuttingDown = false;
86
- const killAllActiveFn = options.killAllActiveFn ?? killAllActive;
87
- const latchSubprocessAdmissionFn = options.latchSubprocessAdmissionFn ?? latchSubprocessAdmissionForShutdown;
88
- const exitFn = options.exitFn ?? ((exitCode) => {
89
- process.exit(exitCode);
90
- });
91
- return async function shutdownOnce(reason, exitCode) {
92
- if (shuttingDown)
93
- return;
94
- shuttingDown = true;
95
- // Synchronous and first: no generic request may cross into spawn while
96
- // cleanup drains the registry or before server.close stops new requests.
97
- latchSubprocessAdmissionFn();
98
- (options.latchVerificationAdmissionFn ?? latchVerificationAdmissionForShutdown)();
99
- try {
100
- // Close singleton app-server admission before any asynchronous cleanup
101
- // can observe or replace the current registry.
102
- options.latchAppServerAdmissionFn?.(reason);
103
- }
104
- catch (err) {
105
- logger.error({
106
- reason,
107
- err: err instanceof Error ? err.message : String(err),
108
- }, "app-server shutdown latch failed");
109
- }
110
- try {
111
- // The workflow coordinator must latch its own admission before any
112
- // asynchronous cleanup surface begins to drain.
113
- options.beginWorkflowShutdownFn?.(reason);
114
- }
115
- catch (err) {
116
- logger.error({
117
- reason,
118
- err: err instanceof Error ? err.message : String(err),
119
- }, "workflow shutdown latch failed");
120
- }
121
- try {
122
- options.clearWorkflowActivityObserverFn?.();
123
- }
124
- catch (err) {
125
- logger.error({
126
- reason,
127
- err: err instanceof Error ? err.message : String(err),
128
- }, "workflow activity observer clear failed");
129
- }
130
- try {
131
- options.clearAppServerActivityObserverFn?.();
132
- }
133
- catch (err) {
134
- logger.error({
135
- reason,
136
- err: err instanceof Error ? err.message : String(err),
137
- }, "app-server activity observer clear failed");
138
- }
139
- try {
140
- options.stopWatchdogFn?.();
141
- }
142
- catch (err) {
143
- logger.error({
144
- reason,
145
- err: err instanceof Error ? err.message : String(err),
146
- }, "shutdown watchdog stop failed");
147
- }
148
- const deadline = new Promise((_, reject) => {
149
- setTimeout(() => reject(new Error("shutdown deadline exceeded")), SHUTDOWN_DEADLINE_MS).unref();
150
- });
151
- try {
152
- await Promise.race([
153
- (async () => {
154
- let effectiveExitCode = exitCode;
155
- logger.info({ reason, activeProcesses: activeProcesses.size, writableLength: process.stdout.writableLength }, "clinkx:shutdown");
156
- logger.info({ reason, exit_code: exitCode }, "shutdown requested, cleaning up");
157
- try {
158
- await killAllActiveFn(reason);
159
- }
160
- catch (err) {
161
- effectiveExitCode = 1;
162
- logger.error({ reason, err: err instanceof Error ? err.message : String(err) }, "killAllActive failed during shutdown");
163
- }
164
- try {
165
- await server.close();
166
- }
167
- catch (err) {
168
- effectiveExitCode = 1;
169
- logger.error({ reason, err: err instanceof Error ? err.message : String(err) }, "server close failed during shutdown");
170
- }
171
- if (process.stdout.writableLength > 0 && process.stdout.writable) {
172
- await new Promise((resolve) => {
173
- const onDrain = () => {
174
- clearTimeout(timer);
175
- resolve();
176
- };
177
- const timer = setTimeout(() => {
178
- process.stdout.off("drain", onDrain);
179
- resolve();
180
- }, 2_000);
181
- timer.unref();
182
- process.stdout.once("drain", onDrain);
183
- });
184
- }
185
- exitFn(effectiveExitCode);
186
- })(),
187
- deadline,
188
- ]);
189
- }
190
- catch {
191
- try {
192
- logger.error({ reason }, "shutdown deadline exceeded, forcing exit");
193
- }
194
- catch {
195
- // stderr may be broken
196
- }
197
- process.exit(1);
198
- }
199
- };
200
- }
201
- function runShutdown(shutdownOnce, reason, exitCode) {
202
- void shutdownOnce(reason, exitCode).catch((err) => {
203
- try {
204
- logger.fatal({ err, reason }, "shutdown failed");
205
- }
206
- catch {
207
- // stderr may already be broken
208
- }
209
- process.exit(1);
210
- });
211
- }
212
- function logFatal(reason, err) {
213
- try {
214
- logger.fatal({ err, reason }, "fatal process event");
215
- }
216
- catch {
217
- // stderr may already be broken
218
- }
219
- }
220
- function toError(err) {
221
- return err instanceof Error ? err : new Error(String(err));
222
- }
223
- function extractRpcMeta(msg) {
224
- if ("method" in msg) {
225
- return "id" in msg && msg.id !== undefined ? { id: msg.id, method: msg.method } : { method: msg.method };
226
- }
227
- if ("id" in msg && msg.id !== undefined)
228
- return { id: msg.id };
229
- return {};
230
- }
231
- export function patchTransportSend(transport, stdout = process.stdout, onBrokenStdout, activity) {
232
- if (patchedTransports.has(transport))
233
- return;
234
- patchedTransports.add(transport);
235
- let brokenError;
236
- let sendChain = Promise.resolve();
237
- const pendingRejects = [];
238
- let shuttingDown = false;
239
- function markBroken(err) {
240
- brokenError ??= err;
241
- const rejects = pendingRejects.splice(0);
242
- for (const reject of rejects) {
243
- reject(brokenError);
244
- }
245
- if (!shuttingDown) {
246
- shuttingDown = true;
247
- stdout.off("error", onError);
248
- onBrokenStdout?.();
249
- }
250
- }
251
- function onError(err) {
252
- markBroken(err);
253
- }
254
- stdout.on("error", onError);
255
- function sendOne(message) {
256
- if (brokenError !== undefined) {
257
- return Promise.reject(brokenError);
258
- }
259
- const json = serializeMessage(message);
260
- const payloadBytes = Buffer.byteLength(json, "utf8");
261
- const { id: rpcId, method: rpcMethod } = extractRpcMeta(message);
262
- return new Promise((resolve, reject) => {
263
- if (brokenError !== undefined) {
264
- reject(brokenError);
265
- return;
266
- }
267
- let settled = false;
268
- let drainAttached = false;
269
- let drainStartedAt = 0;
270
- const timeout = setTimeout(() => {
271
- logger.error({ rpcId, rpcMethod, payloadBytes }, "transport:send:timeout");
272
- markBroken(new Error(`stdout write timed out after ${SEND_TIMEOUT_MS}ms`));
273
- }, SEND_TIMEOUT_MS);
274
- timeout.unref();
275
- function cleanup() {
276
- clearTimeout(timeout);
277
- const index = pendingRejects.indexOf(onStdoutError);
278
- if (index !== -1) {
279
- pendingRejects.splice(index, 1);
280
- }
281
- if (drainAttached) {
282
- stdout.off("drain", onDrain);
283
- }
284
- }
285
- function settleResolve() {
286
- if (settled)
287
- return;
288
- settled = true;
289
- const drainMs = drainStartedAt === 0 ? 0 : Date.now() - drainStartedAt;
290
- cleanup();
291
- logger.debug({ rpcId, rpcMethod, payloadBytes, drainMs }, "transport:send:ok");
292
- resolve();
293
- }
294
- function settleReject(err) {
295
- if (settled)
296
- return;
297
- settled = true;
298
- cleanup();
299
- reject(err);
300
- }
301
- function onStdoutError(err) {
302
- settleReject(err);
303
- }
304
- function onDrain() {
305
- settleResolve();
306
- }
307
- pendingRejects.push(onStdoutError);
308
- try {
309
- logger.debug({ rpcId, rpcMethod, payloadBytes, writableLength: stdout.writableLength }, "transport:send:start");
310
- if (stdout.write(json)) {
311
- settleResolve();
312
- }
313
- else {
314
- drainAttached = true;
315
- drainStartedAt = Date.now();
316
- stdout.once("drain", onDrain);
317
- }
318
- }
319
- catch (err) {
320
- const error = toError(err);
321
- const nodeError = error;
322
- logger.error({
323
- rpcId,
324
- rpcMethod,
325
- payloadBytes,
326
- errCode: nodeError.code,
327
- errSyscall: nodeError.syscall,
328
- }, "transport:send:error");
329
- markBroken(error);
330
- settleReject(error);
331
- }
332
- });
333
- }
334
- transport.send = (message) => {
335
- const releaseSend = activity?.beginSend();
336
- const send = sendChain.then(() => sendOne(message), () => sendOne(message));
337
- sendChain = send.catch(() => undefined);
338
- if (releaseSend !== undefined) {
339
- void send.then(() => releaseSend(), () => releaseSend());
340
- }
341
- return send;
342
- };
343
- }
23
+ import { realpathSync } from "node:fs";
24
+ import { fileURLToPath, pathToFileURL } from "node:url";
25
+ import { applyStartupSettings } from "../clinkx-workflows/dist/settings/bootstrap.js";
344
26
  function isEntrypoint() {
345
27
  const entry = process.argv[1];
346
28
  if (entry == null)
@@ -352,72 +34,27 @@ function isEntrypoint() {
352
34
  return import.meta.url === pathToFileURL(entry).href;
353
35
  }
354
36
  }
355
- /**
356
- * ClinkX MCP server entry point.
357
- *
358
- * 1. Verify logger writes to stderr (STDIO correctness invariant).
359
- * 2. Create the MCP server with tool handlers.
360
- * 3. Connect STDIO transport (stdin/stdout for JSON-RPC, stderr for logs).
361
- */
362
- async function main() {
363
- // Startup self-check: logger must target stderr
364
- assertStderrLogger();
365
- // Startup safety guard: refuse running from filesystem root unless explicitly allowlisted
366
- assertNotRootDir();
367
- const activity = createRootStdioActivity();
368
- const server = createServer({ activity });
369
- const transport = new StdioServerTransport();
370
- logger.info("ClinkX MCP server starting (STDIO transport)");
371
- logger.info({ pid: process.pid, ppid: process.ppid }, "clinkx:startup");
372
- let watchdog;
373
- const shutdownOnce = createShutdownOnce(server, {
374
- killAllActiveFn: createRootCleanup(),
375
- latchAppServerAdmissionFn: (reason) => latchAppServerAdmissionForShutdown(reason),
376
- beginWorkflowShutdownFn: (reason) => shutdownCoordinator.beginShutdown(reason),
377
- clearWorkflowActivityObserverFn: () => setWorkflowActivityObserver(undefined),
378
- clearAppServerActivityObserverFn: () => setAppServerActivityObserver(undefined),
379
- stopWatchdogFn: () => watchdog?.stop(),
380
- });
381
- watchdog = createStdioWatchdog({
382
- isBusy: activity.isBusy,
383
- onShutdown: (reason, exitCode) => {
384
- runShutdown(shutdownOnce, reason, exitCode);
385
- },
386
- });
387
- activity.attachWatchdog(watchdog.recordActivity);
388
- setWorkflowActivityObserver(activity.recordActivity);
389
- setAppServerActivityObserver(activity.recordActivity);
390
- const previousOnMessage = transport.onmessage;
391
- transport.onmessage = (message) => {
392
- activity.recordActivity();
393
- previousOnMessage?.(message);
394
- };
395
- // The transport patch must retain activity until the SDK's response send or
396
- // stdout drain settles; otherwise an idle timer can race the handler return.
397
- patchTransportSend(transport, process.stdout, () => {
398
- runShutdown(shutdownOnce, "stdout:error", 1);
399
- }, activity);
400
- process.on("SIGTERM", () => runShutdown(shutdownOnce, "SIGTERM", 0));
401
- process.once("SIGINT", () => runShutdown(shutdownOnce, "SIGINT", 0));
402
- process.on("SIGHUP", () => runShutdown(shutdownOnce, "SIGHUP", 0));
403
- process.stdin.once("end", () => runShutdown(shutdownOnce, "stdin:end", 0));
404
- process.stdin.once("close", () => runShutdown(shutdownOnce, "stdin:close", 0));
405
- process.stdin.once("error", () => runShutdown(shutdownOnce, "stdin:error", 1));
406
- process.stderr.on("error", () => runShutdown(shutdownOnce, "stderr:error", 0));
407
- process.on("uncaughtException", (err) => {
408
- logFatal("uncaughtException", err);
409
- runShutdown(shutdownOnce, "uncaughtException", 1);
410
- });
411
- process.on("unhandledRejection", (reason) => {
412
- logFatal("unhandledRejection", reason);
413
- runShutdown(shutdownOnce, "unhandledRejection", 1);
414
- });
415
- await server.connect(transport);
416
- logger.info("ClinkX MCP server connected and ready");
37
+ async function runEntry() {
38
+ if (process.argv[2] === "settings") {
39
+ const cli = await import("./settings-cli/main.js");
40
+ process.exitCode = await cli.runSettingsCli(process.argv.slice(3));
41
+ return;
42
+ }
43
+ const application = applyStartupSettings(process.env);
44
+ const stdioMain = await import("./stdio-main.js");
45
+ await stdioMain.runStdioMain(application);
417
46
  }
418
47
  if (isEntrypoint()) {
419
- main().catch((err) => {
420
- logger.fatal({ err }, "ClinkX failed to start");
48
+ runEntry().catch(async (err) => {
49
+ // The logger lives in the dynamically imported graph; load it lazily so
50
+ // this failure path still honors the (possibly file-sourced) log level.
51
+ try {
52
+ const { logger } = await import("./logger.js");
53
+ logger.fatal({ err }, "ClinkX failed to start");
54
+ }
55
+ catch {
56
+ process.stderr.write(`clinkx: failed to start: ${err instanceof Error ? err.message : String(err)}\n`);
57
+ }
421
58
  process.exitCode = 1;
422
59
  });
423
60
  }
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AAEtF,SAAS,YAAY;IACnB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IAChC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,KAAK,CAAC,KAAK,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;IACvD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,QAAQ;IACrB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;QACnD,OAAO,CAAC,QAAQ,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,OAAO;IACT,CAAC;IACD,MAAM,WAAW,GAAG,oBAAoB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAClD,MAAM,SAAS,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;AAC5C,CAAC;AAED,IAAI,YAAY,EAAE,EAAE,CAAC;IACnB,QAAQ,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,GAAY,EAAE,EAAE;QACtC,wEAAwE;QACxE,wEAAwE;QACxE,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YAC/C,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,wBAAwB,CAAC,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,4BAA4B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CACjF,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC"}
package/dist/lib.d.ts ADDED
@@ -0,0 +1,17 @@
1
+ /**
2
+ * Side-effect-free library entry — package.json `main` points here
3
+ * (dist/lib.js, R3/A2#10).
4
+ *
5
+ * `dist/index.js` must stay the bin shim: clients launch it directly, and its
6
+ * ONLY static import is the settings bootstrap so the startup overlay applies
7
+ * before any module-load env reader. That makes it a poor library entry — a
8
+ * library consumer would drag the bootstrap closure and the whole runtime
9
+ * graph through an entry shaped for process launch. This module re-exports
10
+ * the 1.3.0 `import "clinkx"` API from stdio-main instead. stdio-main has no
11
+ * top-level side effects beyond the import graph 1.3.0's index already
12
+ * loaded (its only module-scope state is two constants and a WeakSet; the
13
+ * sole module-scope env access anywhere in that graph is a read), so
14
+ * importing the package as a library starts no server and mutates no env.
15
+ */
16
+ export { createRootCleanup, createShutdownOnce, patchTransportSend } from "./stdio-main.js";
17
+ export type { RootCleanupOptions } from "./stdio-main.js";
package/dist/lib.js ADDED
@@ -0,0 +1,17 @@
1
+ /**
2
+ * Side-effect-free library entry — package.json `main` points here
3
+ * (dist/lib.js, R3/A2#10).
4
+ *
5
+ * `dist/index.js` must stay the bin shim: clients launch it directly, and its
6
+ * ONLY static import is the settings bootstrap so the startup overlay applies
7
+ * before any module-load env reader. That makes it a poor library entry — a
8
+ * library consumer would drag the bootstrap closure and the whole runtime
9
+ * graph through an entry shaped for process launch. This module re-exports
10
+ * the 1.3.0 `import "clinkx"` API from stdio-main instead. stdio-main has no
11
+ * top-level side effects beyond the import graph 1.3.0's index already
12
+ * loaded (its only module-scope state is two constants and a WeakSet; the
13
+ * sole module-scope env access anywhere in that graph is a read), so
14
+ * importing the package as a library starts no server and mutates no env.
15
+ */
16
+ export { createRootCleanup, createShutdownOnce, patchTransportSend } from "./stdio-main.js";
17
+ //# sourceMappingURL=lib.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}
@@ -1,26 +1,10 @@
1
- export declare const LOCK_FILENAME = ".lock";
2
- /** Give up rather than block an MCP request forever on a contended session. */
3
- export declare const LOCK_ACQUIRE_TIMEOUT_MS = 10000;
4
- /**
5
- * How often a holder refreshes its own lock's mtime. This is what makes a lock
6
- * observably ALIVE to a reader that cannot probe our PID, and it is also what
7
- * lets a stolen-from holder notice and abort. Matches the interval the workflow
8
- * `run.lock` and the dashboard credential store already use.
9
- */
10
- export declare const LOCK_HEARTBEAT_MS = 10000;
11
- /**
12
- * Floor for the foreign-host staleness window. A lock is only judged abandoned
13
- * on heartbeat evidence once it has missed several beats AND at least this long
14
- * has passed, so ordinary scheduling jitter never looks like death.
15
- */
16
- export declare const LOCK_HEARTBEAT_STALE_FLOOR_MS = 60000;
1
+ export { LOCK_FILENAME, LOCK_ACQUIRE_TIMEOUT_MS } from "../../clinkx-workflows/dist/settings/lock.js";
17
2
  /**
18
3
  * A holder's live claim on the critical section.
19
4
  *
20
- * `assertHeld` is not decoration. Reclamation is racy in principle — see the
21
- * residuals below — so any caller that is about to make a durable change must
22
- * re-establish ownership immediately beforehand, which collapses the window in
23
- * which a stolen-from holder can still commit down to the syscall that follows.
5
+ * `assertHeld` is not decoration: callers that are about to make a durable
6
+ * change must re-establish ownership immediately beforehand. See the shared
7
+ * lock core for the full rationale.
24
8
  */
25
9
  export interface SessionLockGuard {
26
10
  assertHeld(): Promise<void>;
@@ -28,46 +12,20 @@ export interface SessionLockGuard {
28
12
  /**
29
13
  * Run `fn` while holding an exclusive cross-process lock on `sessionDir`.
30
14
  *
31
- * THE EXCLUSION PRIMITIVE. `open(path, "wx")` is `O_CREAT | O_EXCL`, which the
32
- * kernel guarantees is atomic against every other creator on the same
33
- * filesystem — including a second ClinkX server process, which is the real case
34
- * here (a `clinkx` and a `clinkx-test` server are routinely connected at once).
35
- * A revision compare-and-swap alone is NOT a substitute: read -> compare ->
36
- * replace has a window between the compare and the rename, so the CAS detects a
37
- * lost update while this is what prevents one.
38
- *
39
- * RECLAMATION REQUIRES PROOF, NOT AGE. `O_EXCL` arbitrates creation only, so an
40
- * unconditional unlink of a lock merely judged old is unsafe: two contenders can
41
- * both judge the same abandoned lock, the first can unlink-recreate-and-enter,
42
- * and the second's already-justified unlink then deletes the FIRST's live lock
43
- * and lets it enter too. Both would then read the same revision, both pass the
44
- * CAS, and one write would be silently lost. So a lock is reclaimed only on
45
- * positive evidence of death: a dead PID on this host, or — for a lock written
46
- * on another host, where no probe is possible — a heartbeat that has been
47
- * missing for several declared intervals. Every other case waits. A holder that
48
- * declared no heartbeat is never reclaimed on silence, which is what keeps a
49
- * lock written by an older producer safe. Evidence alone is still not enough to
50
- * make two simultaneous reclaimers safe, so the unlink itself is serialized
51
- * behind a second `O_EXCL` file (`reclaimAbandonedLock`).
52
- *
53
- * Release is ownership-checked: the holder re-reads the lock body and unlinks
54
- * only if the token is still its own, so a holder that was stolen from does not
55
- * normally delete the new owner's lock. Node exposes no atomic
56
- * compare-and-unlink, so that check is read-then-unlink and a steal landing
57
- * inside that window is still possible; the guarantee is "will not", not
58
- * "cannot".
15
+ * Thin wrapper (P9/R1): the exclusion primitive, the fail-closed foreign-host
16
+ * rule, the link-published atomic lock body and the steal-lock-serialized
17
+ * reclaim all live in ONE place — the settings lock in clinkx-workflows — so
18
+ * the two surfaces cannot drift apart again. This module only adapts that core
19
+ * to the progress-report surface: `warn` goes to the root logger, and
20
+ * `SettingsLockError` (the cw package must not import root error classes)
21
+ * maps onto `ExecutionError` with the message kept verbatim, including the
22
+ * lock path and the manual `rm` recovery step a foreign-host timeout names.
59
23
  *
60
- * Honest residuals, all accepted under a single-user local-filesystem model:
61
- * `O_EXCL` is not reliable on some network filesystems (NFSv2/v3); a PID can be
62
- * recycled, so a probe can report a live process that is not the original
63
- * holder; and a holder suspended (SIGSTOP, a paused container) stops beating and
64
- * looks abandoned to a foreign-host reader. These are the same class of residual
65
- * the repo already accepts for `run.lock` and `contained-file.ts`. The steal
66
- * lock adds one of its own: a process that dies while holding `.lock.steal`
67
- * leaves it behind, which disables AUTOMATIC RECLAMATION for that session —
68
- * normal acquisition and release are unaffected — until an operator removes the
69
- * file. That is strictly the better failure mode: a session that needs a manual
70
- * unwedge, rather than two writers in the critical section.
24
+ * A legacy lock body written by an older build of THIS module is still
25
+ * reclaimed: lock identity is `token`/`pid`/`hostname`, which the old
26
+ * snake_case body (`acquired_at`, `heartbeat_interval_ms`) already carries,
27
+ * and the shared core tolerates the missing camelCase `startedAt` — pinned by
28
+ * a test so same-host dead-PID reclaim keeps working across an upgrade.
71
29
  */
72
30
  export declare function withSessionLock<T>(sessionDir: string, fn: (guard: SessionLockGuard) => Promise<T>, options?: {
73
31
  readonly acquireTimeoutMs?: number;