clinkx 1.3.0 → 1.4.1

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 (179) hide show
  1. package/CHANGELOG.md +57 -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-CX4FrhYN.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 +1290 -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.d.ts +11 -3
  82. package/dist/dashboard-cli.js +199 -33
  83. package/dist/dashboard-cli.js.map +1 -1
  84. package/dist/dashboard-companion/client.d.ts +14 -0
  85. package/dist/dashboard-companion/client.js +16 -0
  86. package/dist/dashboard-companion/client.js.map +1 -1
  87. package/dist/dashboard-companion/credential-expectation.d.ts +23 -0
  88. package/dist/dashboard-companion/credential-expectation.js +50 -0
  89. package/dist/dashboard-companion/credential-expectation.js.map +1 -0
  90. package/dist/dashboard-companion/host-channel.d.ts +36 -0
  91. package/dist/dashboard-companion/host-channel.js +78 -0
  92. package/dist/dashboard-companion/host-channel.js.map +1 -0
  93. package/dist/dashboard-companion/host-status.d.ts +179 -0
  94. package/dist/dashboard-companion/host-status.js +122 -0
  95. package/dist/dashboard-companion/host-status.js.map +1 -0
  96. package/dist/dashboard-companion/protocol.js +17 -0
  97. package/dist/dashboard-companion/protocol.js.map +1 -1
  98. package/dist/dashboard-companion/standalone-assets.d.ts +8 -0
  99. package/dist/dashboard-companion/standalone-assets.js +7 -1
  100. package/dist/dashboard-companion/standalone-assets.js.map +1 -1
  101. package/dist/dashboard-companion/standalone-entry.js +34 -13
  102. package/dist/dashboard-companion/standalone-entry.js.map +1 -1
  103. package/dist/dashboard-gateway/control-plane/contracts.d.ts +38 -38
  104. package/dist/dashboard-gateway/tunnel-http.js +20 -0
  105. package/dist/dashboard-gateway/tunnel-http.js.map +1 -1
  106. package/dist/desktop-host/child-env.d.ts +23 -0
  107. package/dist/desktop-host/child-env.js +70 -0
  108. package/dist/desktop-host/child-env.js.map +1 -0
  109. package/dist/desktop-host/daemon-entry.d.ts +2 -0
  110. package/dist/desktop-host/daemon-entry.js +50 -0
  111. package/dist/desktop-host/daemon-entry.js.map +1 -0
  112. package/dist/desktop-host/daemon-env.d.ts +12 -0
  113. package/dist/desktop-host/daemon-env.js +35 -0
  114. package/dist/desktop-host/daemon-env.js.map +1 -0
  115. package/dist/desktop-host/daemon-protocol.d.ts +210 -0
  116. package/dist/desktop-host/daemon-protocol.js +56 -0
  117. package/dist/desktop-host/daemon-protocol.js.map +1 -0
  118. package/dist/desktop-host/daemon.d.ts +50 -0
  119. package/dist/desktop-host/daemon.js +441 -0
  120. package/dist/desktop-host/daemon.js.map +1 -0
  121. package/dist/desktop-host/enrollment.d.ts +17 -0
  122. package/dist/desktop-host/enrollment.js +25 -0
  123. package/dist/desktop-host/enrollment.js.map +1 -0
  124. package/dist/desktop-host/import.d.ts +14 -0
  125. package/dist/desktop-host/import.js +95 -0
  126. package/dist/desktop-host/import.js.map +1 -0
  127. package/dist/desktop-host/profile.d.ts +130 -0
  128. package/dist/desktop-host/profile.js +176 -0
  129. package/dist/desktop-host/profile.js.map +1 -0
  130. package/dist/desktop-host/service.d.ts +6 -0
  131. package/dist/desktop-host/service.js +7 -0
  132. package/dist/desktop-host/service.js.map +1 -0
  133. package/dist/desktop-host/supervisor.d.ts +57 -0
  134. package/dist/desktop-host/supervisor.js +256 -0
  135. package/dist/desktop-host/supervisor.js.map +1 -0
  136. package/dist/desktop-host/view-state.d.ts +138 -0
  137. package/dist/desktop-host/view-state.js +27 -0
  138. package/dist/desktop-host/view-state.js.map +1 -0
  139. package/dist/elaris/config.d.ts +10 -0
  140. package/dist/elaris/config.js +27 -1
  141. package/dist/elaris/config.js.map +1 -1
  142. package/dist/elaris/tools.js +4 -1
  143. package/dist/elaris/tools.js.map +1 -1
  144. package/dist/index.d.ts +0 -31
  145. package/dist/index.js +41 -404
  146. package/dist/index.js.map +1 -1
  147. package/dist/lib.d.ts +17 -0
  148. package/dist/lib.js +17 -0
  149. package/dist/lib.js.map +1 -0
  150. package/dist/progress-report/lock.d.ts +17 -59
  151. package/dist/progress-report/lock.js +25 -329
  152. package/dist/progress-report/lock.js.map +1 -1
  153. package/dist/registry.d.ts +7 -0
  154. package/dist/registry.js +21 -7
  155. package/dist/registry.js.map +1 -1
  156. package/dist/server.js +75 -4
  157. package/dist/server.js.map +1 -1
  158. package/dist/settings-cli/clients.d.ts +137 -0
  159. package/dist/settings-cli/clients.js +1124 -0
  160. package/dist/settings-cli/clients.js.map +1 -0
  161. package/dist/settings-cli/commands.d.ts +67 -0
  162. package/dist/settings-cli/commands.js +726 -0
  163. package/dist/settings-cli/commands.js.map +1 -0
  164. package/dist/settings-cli/format.d.ts +34 -0
  165. package/dist/settings-cli/format.js +40 -0
  166. package/dist/settings-cli/format.js.map +1 -0
  167. package/dist/settings-cli/main.d.ts +18 -0
  168. package/dist/settings-cli/main.js +256 -0
  169. package/dist/settings-cli/main.js.map +1 -0
  170. package/dist/stdio-main.d.ts +73 -0
  171. package/dist/stdio-main.js +455 -0
  172. package/dist/stdio-main.js.map +1 -0
  173. package/docs/configuration.md +340 -39
  174. package/docs/security.md +150 -6
  175. package/docs/verification/README.md +28 -2
  176. package/docs/verification/workflow-handoff.md +86 -0
  177. package/package.json +3 -3
  178. package/clinkx-workflows/dist/dashboard-ui/assets/index-DRId2DVA.js +0 -119
  179. package/clinkx-workflows/dist/dashboard-ui/assets/style-CHAw57y5.css +0 -1
@@ -0,0 +1,173 @@
1
+ /**
2
+ * Settings filesystem locations — A1-1.
3
+ *
4
+ * Pure path computation and validation only: no filesystem access happens
5
+ * here, so the loader (and the `CLINKX_SETTINGS=off` fast path) can resolve
6
+ * locations without touching a single inode, and the startup import closure
7
+ * stays logger/config-free.
8
+ *
9
+ * Directory rules (OQ-4, TASKS.md):
10
+ * - `$CLINKX_SETTINGS_DIR` when it is a valid absolute path that is not a
11
+ * filesystem root, not `$HOME` (or an ancestor of it) and not under the
12
+ * EFFECTIVE ClinkX home — `CLINKX_HOME.trim() || $HOME/.clinkx` (the
13
+ * settings live OUTSIDE the Syncthing-marked `~/.clinkx` tree; owner
14
+ * decision 5). The effective-home rule holds even when `CLINKX_HOME` was
15
+ * never exported (S6).
16
+ * - Otherwise `$HOME/.config/clinkx/settings/`. `XDG_CONFIG_HOME` is
17
+ * deliberately ignored: Codex strips it while Claude Code passes the full
18
+ * shell env, so an XDG-based path would resolve differently per client.
19
+ * The DEFAULT candidate is validated too: when it lands inside the
20
+ * effective ClinkX home (e.g. `CLINKX_HOME=$HOME/.config/clinkx`), the
21
+ * resolution is `invalid` with a warning, not a silent accept (S6).
22
+ * - An INVALID override is not silently redirected to the default: the
23
+ * caller surfaces a warning and behaves as if no settings directory
24
+ * existed ("absent"). The server still starts (owner decision 7).
25
+ *
26
+ * All comparisons are lexical (`path.resolve`); a directory that does not
27
+ * exist yet is still a valid override because the store creates it on first
28
+ * save.
29
+ */
30
+ import { isAbsolute, join, parse, relative, resolve, sep } from "node:path";
31
+ import { SETTINGS_DIR_ENV } from "./registry.js";
32
+ /** Default directory segments under `$HOME` (XDG_CONFIG_HOME is ignored). */
33
+ export const DEFAULT_SETTINGS_DIR = ".config/clinkx/settings";
34
+ /** Name of the settings document inside the settings directory. */
35
+ export const SETTINGS_FILE_NAME = "settings.json";
36
+ /** Name of the 0600 secrets document inside the settings directory. */
37
+ export const SECRETS_FILE_NAME = "secrets.json";
38
+ /** Per-process heartbeat files live in this subdirectory. */
39
+ export const PROCESSES_DIR_NAME = "processes";
40
+ /** True when `child` equals `parent` or lives somewhere under it (lexical). */
41
+ function containsDir(parent, child) {
42
+ const rel = relative(parent, child);
43
+ return (rel === "" || (rel !== ".." && !rel.startsWith(`..${sep}`) && !isAbsolute(rel)));
44
+ }
45
+ function isFilesystemRoot(path) {
46
+ return parse(path).root === path;
47
+ }
48
+ /**
49
+ * Validate a `$CLINKX_SETTINGS_DIR` override. Returns a rejection reason or
50
+ * undefined when the override is acceptable. `clinkxHome` is the EFFECTIVE
51
+ * ClinkX home the directory must not live under (`CLINKX_HOME` when set,
52
+ * else `$HOME/.clinkx` — computed by the caller so both the override and the
53
+ * default candidate are held to the same rule, S6).
54
+ */
55
+ export function validateSettingsDirOverride(dir, home, clinkxHome) {
56
+ if (!isAbsolute(dir)) {
57
+ return `CLINKX_SETTINGS_DIR must be an absolute path; got ${JSON.stringify(dir)}`;
58
+ }
59
+ const resolved = resolve(dir);
60
+ if (isFilesystemRoot(resolved)) {
61
+ return "CLINKX_SETTINGS_DIR must not be a filesystem root";
62
+ }
63
+ if (home != null && home !== "") {
64
+ const resolvedHome = resolve(home);
65
+ if (resolved === resolvedHome) {
66
+ return "CLINKX_SETTINGS_DIR must not be the home directory itself";
67
+ }
68
+ if (containsDir(resolved, resolvedHome)) {
69
+ return "CLINKX_SETTINGS_DIR must not be an ancestor of the home directory";
70
+ }
71
+ }
72
+ if (clinkxHome != null && clinkxHome !== "") {
73
+ const resolvedClinkxHome = resolve(clinkxHome);
74
+ if (containsDir(resolvedClinkxHome, resolved)) {
75
+ return "CLINKX_SETTINGS_DIR must not be inside CLINKX_HOME (settings live outside the ~/.clinkx tree)";
76
+ }
77
+ }
78
+ return undefined;
79
+ }
80
+ /** The default settings directory under `home` (XDG is deliberately ignored). */
81
+ export function defaultSettingsDirFor(home) {
82
+ return join(home, DEFAULT_SETTINGS_DIR);
83
+ }
84
+ /**
85
+ * Resolve the settings directory from an env record. Never touches the
86
+ * filesystem and never throws; a rejected override yields
87
+ * `{ dir: "", origin: "invalid" }` plus a warning for the loader to surface.
88
+ * An empty/whitespace override is treated as unset (some clients export
89
+ * empty strings for unset variables).
90
+ */
91
+ export function resolveSettingsDir(input) {
92
+ const { env } = input;
93
+ const overrideRaw = env[SETTINGS_DIR_ENV];
94
+ const override = overrideRaw == null ? "" : overrideRaw.trim();
95
+ const homeRaw = env["HOME"];
96
+ const home = homeRaw == null ? "" : homeRaw.trim();
97
+ const clinkxHomeRaw = env["CLINKX_HOME"];
98
+ const clinkxHome = clinkxHomeRaw == null ? "" : clinkxHomeRaw.trim();
99
+ // Effective ClinkX home (S6): CLINKX_HOME when set (trimmed), else
100
+ // $HOME/.clinkx. The containment rule must hold even when CLINKX_HOME was
101
+ // never exported, and must apply to the FINAL candidate — default as well
102
+ // as override.
103
+ const effectiveClinkxHome = clinkxHome !== "" ? clinkxHome : home === "" ? "" : join(home, ".clinkx");
104
+ const clinkxHomeForCheck = effectiveClinkxHome === "" ? undefined : effectiveClinkxHome;
105
+ if (override !== "") {
106
+ const rejection = validateSettingsDirOverride(override, home === "" ? undefined : home, clinkxHomeForCheck);
107
+ if (rejection != null) {
108
+ return { dir: "", origin: "invalid", warning: `${rejection}; treating settings as absent` };
109
+ }
110
+ return { dir: resolve(override), origin: "override" };
111
+ }
112
+ if (home === "") {
113
+ return {
114
+ dir: "",
115
+ origin: "unresolvable",
116
+ warning: "HOME is not set; the default settings directory cannot be resolved; treating settings as absent",
117
+ };
118
+ }
119
+ const candidate = defaultSettingsDirFor(home);
120
+ if (clinkxHomeForCheck != null &&
121
+ containsDir(resolve(clinkxHomeForCheck), resolve(candidate))) {
122
+ return {
123
+ dir: "",
124
+ origin: "invalid",
125
+ warning: `the default settings directory ${JSON.stringify(candidate)} is inside CLINKX_HOME ${JSON.stringify(clinkxHomeForCheck)} (settings live outside the ClinkX home tree); treating settings as absent`,
126
+ };
127
+ }
128
+ return { dir: candidate, origin: "default" };
129
+ }
130
+ /** `<dir>/settings.json` */
131
+ export function settingsFilePath(dir) {
132
+ return join(dir, SETTINGS_FILE_NAME);
133
+ }
134
+ /** `<dir>/secrets.json` */
135
+ export function secretsFilePath(dir) {
136
+ return join(dir, SECRETS_FILE_NAME);
137
+ }
138
+ /** `<dir>/processes` */
139
+ export function processesDirPath(dir) {
140
+ return join(dir, PROCESSES_DIR_NAME);
141
+ }
142
+ /** `<hostname>-<pid>-<bootNonce>.json` (hostname may itself contain dashes). */
143
+ export function processHeartbeatFileName(hostname, pid, bootNonce) {
144
+ return `${hostname}-${pid}-${bootNonce}.json`;
145
+ }
146
+ /** `<dir>/processes/<hostname>-<pid>-<bootNonce>.json` */
147
+ export function processHeartbeatFilePath(dir, hostname, pid, bootNonce) {
148
+ return join(processesDirPath(dir), processHeartbeatFileName(hostname, pid, bootNonce));
149
+ }
150
+ /**
151
+ * Parse a heartbeat file name back into its parts, or undefined when the
152
+ * name does not match the `<host>-<pid>-<32-hex>.json` grammar. Used by the
153
+ * writer's dead-pid prune (and later by the dashboard reader).
154
+ */
155
+ export function parseProcessHeartbeatFileName(name) {
156
+ const match = /^(.+)-([1-9][0-9]*)-([0-9a-f]{32})\.json$/.exec(name);
157
+ if (match == null)
158
+ return undefined;
159
+ const pid = Number(match[2]);
160
+ if (!Number.isSafeInteger(pid) || pid < 1)
161
+ return undefined;
162
+ return { hostname: match[1], pid, bootNonce: match[3] };
163
+ }
164
+ /**
165
+ * Parse the durable writer's temp name for a heartbeat
166
+ * (`.<heartbeat name>.<pid>.<16-hex>.tmp`), or undefined for any other name.
167
+ * The parts identify the heartbeat, and so the process that wrote the temp.
168
+ */
169
+ export function parseProcessHeartbeatTempFileName(name) {
170
+ const match = /^\.(.+)\.[1-9][0-9]*\.[0-9a-f]{16}\.tmp$/.exec(name);
171
+ return match == null ? undefined : parseProcessHeartbeatFileName(match[1]);
172
+ }
173
+ //# sourceMappingURL=paths.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/settings/paths.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,47 @@
1
+ import { type DurableFsOps } from "./durable-write.js";
2
+ import { type ProcessHeartbeatEntry } from "./schema.js";
3
+ import { type SettingsApplication } from "./loader.js";
4
+ /** Liveness is signalled by mtime; refresh cadence matches the docs (30 s). */
5
+ export declare const SETTINGS_HEARTBEAT_INTERVAL_MS = 30000;
6
+ export interface SettingsHeartbeatFs extends DurableFsOps {
7
+ /** Richer than DurableFsOps.lstat: the mtime refresh also needs isFile(). */
8
+ lstat(path: string): Promise<{
9
+ isSymbolicLink(): boolean;
10
+ isFile(): boolean;
11
+ }>;
12
+ mkdir(path: string): Promise<void>;
13
+ readdir(path: string): Promise<readonly string[]>;
14
+ utimes(path: string, atime: Date, mtime: Date): Promise<void>;
15
+ readFileCapped(path: string): Promise<{
16
+ readonly ok: true;
17
+ readonly bytes: Uint8Array;
18
+ } | {
19
+ readonly ok: false;
20
+ readonly code: string;
21
+ }>;
22
+ }
23
+ export interface StartSettingsHeartbeatOptions {
24
+ readonly application: SettingsApplication;
25
+ readonly entry: ProcessHeartbeatEntry;
26
+ readonly version: string;
27
+ /** Settings directory root (the heartbeat lands in `<dir>/processes`). */
28
+ readonly dir: string;
29
+ readonly now?: () => Date;
30
+ readonly fs?: SettingsHeartbeatFs;
31
+ /** Diagnostics sink; the first failure warns exactly once. */
32
+ readonly warn?: (message: string) => void;
33
+ readonly intervalMs?: number;
34
+ readonly hostname?: string;
35
+ readonly pid?: number;
36
+ readonly bootNonce?: string;
37
+ readonly isProcessAlive?: (pid: number) => boolean;
38
+ }
39
+ export interface SettingsHeartbeatHandle {
40
+ stop(): void;
41
+ }
42
+ /**
43
+ * Start the heartbeat for this process. Returns immediately; the initial
44
+ * prune + write happen in the background. Never throws — a heartbeat is
45
+ * observability, not a startup dependency.
46
+ */
47
+ export declare function startSettingsHeartbeat(options: StartSettingsHeartbeatOptions): SettingsHeartbeatHandle;
@@ -0,0 +1,305 @@
1
+ /**
2
+ * Per-process settings heartbeat writer — A1-3.
3
+ *
4
+ * Publishes the loader's `SettingsApplication` as a
5
+ * `clinkx-settings-process-v1` document at
6
+ * `<settingsDir>/processes/<hostname>-<pid>-<bootNonce>.json` so the
7
+ * dashboard can list every process's loaded settings revision + provenance
8
+ * and flag stale servers (coordinator decision 8). The boot nonce (random
9
+ * 128-bit hex) distinguishes same-pid processes across pid recycling.
10
+ *
11
+ * Mechanics:
12
+ * - the document goes through the frozen schema before writing and the file
13
+ * is published via durable-write.ts (O_EXCL temp, fchmod 0644, fsync,
14
+ * rename, dir fsync; a symlinked target is refused);
15
+ * - an unref'd 30 s interval refreshes the file's mtime (the liveness
16
+ * signal; readers use `mtime < max(60 s, 6 × interval)` on foreign hosts);
17
+ * - same-host heartbeat files, and temps a killed writer left behind, are
18
+ * pruned at start when their pid is provably dead (ESRCH probe; foreign-host
19
+ * files are NEVER pruned — no probe is possible there); reads during prune
20
+ * never follow symlinks;
21
+ * - every failure path is non-fatal: the FIRST failure warns exactly once
22
+ * through the injected callback (deliberately not the logger — this
23
+ * module stays importable next to the loader) and the heartbeat stays
24
+ * down or stale without affecting the server;
25
+ * - `stop()` clears the timer and removes the file.
26
+ *
27
+ * Secret values never appear: provenance entries for secret-class keys are
28
+ * reduced to their bare source before the document is validated, and the
29
+ * schema would reject an `effective` value for them anyway.
30
+ */
31
+ import { randomBytes } from "node:crypto";
32
+ import { constants as fsConstants } from "node:fs";
33
+ import { lstat, mkdir, open, readdir, rename, unlink, utimes } from "node:fs/promises";
34
+ import { hostname as osHostname } from "node:os";
35
+ import { join } from "node:path";
36
+ import { createDurableWriter } from "./durable-write.js";
37
+ import { isSecretSettingKey } from "./registry.js";
38
+ import { MAX_PROCESS_HEARTBEAT_UNKNOWN_ENV_KEYS, MAX_PROCESS_HEARTBEAT_WARNINGS, PROCESS_HEARTBEAT_SCHEMA_VERSION, ProcessHeartbeatV1Schema, } from "./schema.js";
39
+ import { MAX_SETTINGS_FILE_BYTES } from "./loader.js";
40
+ import { parseProcessHeartbeatFileName, parseProcessHeartbeatTempFileName, processHeartbeatFilePath, processesDirPath, } from "./paths.js";
41
+ /** Liveness is signalled by mtime; refresh cadence matches the docs (30 s). */
42
+ export const SETTINGS_HEARTBEAT_INTERVAL_MS = 30_000;
43
+ /** Upper bound on files examined by the startup prune (defensive only). */
44
+ const MAX_PRUNE_SCAN_ENTRIES = 512;
45
+ const nodeHeartbeatFs = {
46
+ open: (path, flags, mode) => open(path, flags, mode),
47
+ lstat,
48
+ rename,
49
+ unlink,
50
+ mkdir: async (path) => {
51
+ await mkdir(path, { recursive: true });
52
+ },
53
+ readdir: async (path) => await readdir(path),
54
+ utimes,
55
+ readFileCapped: async (path) => {
56
+ const flags = fsConstants.O_RDONLY | fsConstants.O_NOFOLLOW | fsConstants.O_NONBLOCK;
57
+ try {
58
+ const stats = await lstat(path);
59
+ if (stats.isSymbolicLink())
60
+ return { ok: false, code: "SYMLINK" };
61
+ if (!stats.isFile())
62
+ return { ok: false, code: "NOT_REGULAR" };
63
+ if (stats.size > MAX_SETTINGS_FILE_BYTES)
64
+ return { ok: false, code: "TOO_LARGE" };
65
+ const handle = await open(path, flags);
66
+ try {
67
+ const openStats = await handle.stat();
68
+ if (!openStats.isFile())
69
+ return { ok: false, code: "NOT_REGULAR" };
70
+ if (openStats.size > MAX_SETTINGS_FILE_BYTES) {
71
+ return { ok: false, code: "TOO_LARGE" };
72
+ }
73
+ const buffer = Buffer.alloc(openStats.size);
74
+ let offset = 0;
75
+ while (offset < buffer.length) {
76
+ const { bytesRead } = await handle.read(buffer, offset, buffer.length - offset, null);
77
+ if (bytesRead === 0)
78
+ break;
79
+ offset += bytesRead;
80
+ }
81
+ return { ok: true, bytes: new Uint8Array(offset === buffer.length ? buffer : buffer.subarray(0, offset)) };
82
+ }
83
+ finally {
84
+ await handle.close();
85
+ }
86
+ }
87
+ catch (error) {
88
+ const code = typeof error === "object" && error !== null && "code" in error
89
+ ? String(error.code)
90
+ : "";
91
+ return { ok: false, code: code || "ERROR" };
92
+ }
93
+ },
94
+ };
95
+ function defaultIsProcessAlive(pid) {
96
+ try {
97
+ process.kill(pid, 0);
98
+ return true;
99
+ }
100
+ catch (error) {
101
+ // Only ESRCH proves the process is gone: EPERM means it exists but is not
102
+ // ours, and a temp file has no content to double-check before removal.
103
+ return error.code !== "ESRCH";
104
+ }
105
+ }
106
+ function buildHeartbeatDocument(application, meta) {
107
+ const provenance = {};
108
+ for (const key of Object.keys(application.perKey)) {
109
+ const entry = application.perKey[key];
110
+ if (entry == null)
111
+ continue;
112
+ if (isSecretSettingKey(key)) {
113
+ // Bare source only: no effective value, no equality hint.
114
+ provenance[key] = { source: entry.source };
115
+ continue;
116
+ }
117
+ const projected = {
118
+ source: entry.source,
119
+ };
120
+ if (entry.effective !== undefined)
121
+ projected.effective = entry.effective;
122
+ if (entry.envEqualsFile !== undefined)
123
+ projected.env_equals_file = entry.envEqualsFile;
124
+ provenance[key] = projected;
125
+ }
126
+ const settings = {
127
+ state: application.state,
128
+ };
129
+ if (application.revision !== undefined)
130
+ settings.revision = application.revision;
131
+ if (application.digest !== undefined)
132
+ settings.digest = application.digest;
133
+ // Always written (number, or null when no secrets document was read): the
134
+ // dashboard's three-way freshness rule needs it; an absent field means a
135
+ // pre-W3 build, whose freshness reports as unknown (T09).
136
+ settings.secrets_revision = application.secretsRevision;
137
+ return {
138
+ schema_version: PROCESS_HEARTBEAT_SCHEMA_VERSION,
139
+ pid: meta.pid,
140
+ hostname: meta.hostname,
141
+ entry: meta.entry,
142
+ version: meta.version,
143
+ started_at: meta.startedAtIso,
144
+ heartbeat_at: meta.startedAtIso,
145
+ boot_nonce: meta.bootNonce,
146
+ settings,
147
+ provenance,
148
+ unknown_env_keys: application.unknownEnvKeys.slice(0, MAX_PROCESS_HEARTBEAT_UNKNOWN_ENV_KEYS),
149
+ warnings: application.warnings.slice(0, MAX_PROCESS_HEARTBEAT_WARNINGS),
150
+ };
151
+ }
152
+ /**
153
+ * Start the heartbeat for this process. Returns immediately; the initial
154
+ * prune + write happen in the background. Never throws — a heartbeat is
155
+ * observability, not a startup dependency.
156
+ */
157
+ export function startSettingsHeartbeat(options) {
158
+ const warn = options.warn ?? (() => undefined);
159
+ let warned = false;
160
+ const warnOnce = (message) => {
161
+ if (warned)
162
+ return;
163
+ warned = true;
164
+ warn(message);
165
+ };
166
+ const fs = options.fs ?? nodeHeartbeatFs;
167
+ const hostname = options.hostname ?? osHostname();
168
+ const pid = options.pid ?? process.pid;
169
+ const bootNonce = options.bootNonce ?? randomBytes(16).toString("hex");
170
+ const intervalMs = options.intervalMs ?? SETTINGS_HEARTBEAT_INTERVAL_MS;
171
+ const now = options.now ?? (() => new Date());
172
+ const isAlive = options.isProcessAlive ?? defaultIsProcessAlive;
173
+ const processesDir = processesDirPath(options.dir);
174
+ const filePath = processHeartbeatFilePath(options.dir, hostname, pid, bootNonce);
175
+ const document = buildHeartbeatDocument(options.application, {
176
+ entry: options.entry,
177
+ version: options.version,
178
+ hostname,
179
+ pid,
180
+ bootNonce,
181
+ startedAtIso: now().toISOString(),
182
+ });
183
+ const validated = ProcessHeartbeatV1Schema.safeParse(document);
184
+ if (!validated.success) {
185
+ warnOnce(`settings heartbeat document failed its schema and was not written: ${validated.error.issues[0]?.message ?? "invalid document"}`);
186
+ return { stop: () => undefined };
187
+ }
188
+ const payload = `${JSON.stringify(validated.data, null, 2)}\n`;
189
+ const writer = createDurableWriter({
190
+ fs: { open: fs.open, lstat: fs.lstat, rename: fs.rename, unlink: fs.unlink },
191
+ warn: (_fields, message) => warnOnce(message),
192
+ });
193
+ let stopped = false;
194
+ let timer;
195
+ const mustKeep = (parts) => {
196
+ if (parts.hostname !== hostname)
197
+ return true; // foreign host: never pruned
198
+ // A stale boot of a recycled pid that is now us is prunable.
199
+ return parts.pid === pid ? parts.bootNonce === bootNonce : isAlive(parts.pid);
200
+ };
201
+ /**
202
+ * Same-host files whose pid is provably dead (plus stale same-pid boots),
203
+ * including temps left by a writer killed before its rename. A temp may be
204
+ * empty or partial, so its name alone identifies the owner.
205
+ */
206
+ const pruneDeadProcesses = async () => {
207
+ let names;
208
+ try {
209
+ names = await fs.readdir(processesDir);
210
+ }
211
+ catch {
212
+ return; // no processes dir yet — nothing to prune
213
+ }
214
+ for (const name of names.slice(0, MAX_PRUNE_SCAN_ENTRIES)) {
215
+ const temp = parseProcessHeartbeatTempFileName(name);
216
+ if (temp != null) {
217
+ if (mustKeep(temp))
218
+ continue;
219
+ try {
220
+ await fs.unlink(join(processesDir, name));
221
+ }
222
+ catch {
223
+ // Best-effort prune.
224
+ }
225
+ continue;
226
+ }
227
+ const parts = parseProcessHeartbeatFileName(name);
228
+ if (parts == null || mustKeep(parts))
229
+ continue;
230
+ const read = await fs.readFileCapped(join(processesDir, name));
231
+ if (!read.ok)
232
+ continue;
233
+ let parsed;
234
+ try {
235
+ parsed = JSON.parse(Buffer.from(read.bytes).toString("utf8"));
236
+ }
237
+ catch {
238
+ continue;
239
+ }
240
+ if (typeof parsed !== "object" || parsed === null)
241
+ continue;
242
+ const record = parsed;
243
+ if (record.pid !== parts.pid)
244
+ continue; // name/content mismatch: leave it
245
+ try {
246
+ await fs.unlink(join(processesDir, name));
247
+ }
248
+ catch {
249
+ // Best-effort prune.
250
+ }
251
+ }
252
+ };
253
+ const refreshMtime = async () => {
254
+ try {
255
+ // lstat first: utimes(2) follows symlinks, so a swapped-in link must
256
+ // not be touched. A missing or non-regular file simply stops the
257
+ // refresh (the heartbeat was removed or replaced).
258
+ const stats = await fs.lstat(filePath);
259
+ if (!stats.isFile())
260
+ return;
261
+ const stamp = now();
262
+ await fs.utimes(filePath, stamp, stamp);
263
+ }
264
+ catch {
265
+ // Non-fatal; the initial write failure already warned.
266
+ }
267
+ };
268
+ const start = async () => {
269
+ try {
270
+ await pruneDeadProcesses();
271
+ }
272
+ catch {
273
+ // Prune is best-effort.
274
+ }
275
+ try {
276
+ await fs.mkdir(processesDir);
277
+ await writer.writeFile(filePath, payload, { mode: 0o644 });
278
+ }
279
+ catch (error) {
280
+ warnOnce(`settings heartbeat could not be written and stays down (non-fatal): ${error instanceof Error ? error.message : String(error)}`);
281
+ }
282
+ if (intervalMs > 0 && !stopped) {
283
+ timer = setInterval(() => {
284
+ if (stopped)
285
+ return;
286
+ void refreshMtime();
287
+ }, intervalMs);
288
+ timer.unref();
289
+ }
290
+ };
291
+ void start().catch((error) => {
292
+ warnOnce(`settings heartbeat failed to start (non-fatal): ${error instanceof Error ? error.message : String(error)}`);
293
+ });
294
+ return {
295
+ stop() {
296
+ stopped = true;
297
+ if (timer != null) {
298
+ clearInterval(timer);
299
+ timer = undefined;
300
+ }
301
+ void fs.unlink(filePath).catch(() => undefined);
302
+ },
303
+ };
304
+ }
305
+ //# sourceMappingURL=process-heartbeat.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"process-heartbeat.js","sourceRoot":"","sources":["../../src/settings/process-heartbeat.ts"],"names":[],"mappings":"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"}