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.
- package/CHANGELOG.md +28 -0
- package/README.md +13 -6
- package/clinkx-workflows/dist/child-env.d.ts +3 -0
- package/clinkx-workflows/dist/child-env.js +11 -0
- package/clinkx-workflows/dist/child-env.js.map +1 -1
- package/clinkx-workflows/dist/dashboard/api-routes.d.ts +21 -0
- package/clinkx-workflows/dist/dashboard/api-routes.js +27 -0
- package/clinkx-workflows/dist/dashboard/api-routes.js.map +1 -1
- package/clinkx-workflows/dist/dashboard/auth/challenge-store.d.ts +13 -0
- package/clinkx-workflows/dist/dashboard/auth/challenge-store.js.map +1 -1
- package/clinkx-workflows/dist/dashboard/auth/controller.d.ts +27 -0
- package/clinkx-workflows/dist/dashboard/auth/controller.js +262 -23
- package/clinkx-workflows/dist/dashboard/auth/controller.js.map +1 -1
- package/clinkx-workflows/dist/dashboard/auth/settings-step-up.d.ts +62 -0
- package/clinkx-workflows/dist/dashboard/auth/settings-step-up.js +70 -0
- package/clinkx-workflows/dist/dashboard/auth/settings-step-up.js.map +1 -0
- package/clinkx-workflows/dist/dashboard/request-admission.d.ts +6 -0
- package/clinkx-workflows/dist/dashboard/request-admission.js +9 -0
- package/clinkx-workflows/dist/dashboard/request-admission.js.map +1 -1
- package/clinkx-workflows/dist/dashboard/server-factory.js +15 -1
- package/clinkx-workflows/dist/dashboard/server-factory.js.map +1 -1
- package/clinkx-workflows/dist/dashboard/settings-contract.d.ts +1806 -0
- package/clinkx-workflows/dist/dashboard/settings-contract.js +630 -0
- package/clinkx-workflows/dist/dashboard/settings-contract.js.map +1 -0
- package/clinkx-workflows/dist/dashboard/settings-process-reader.d.ts +48 -0
- package/clinkx-workflows/dist/dashboard/settings-process-reader.js +195 -0
- package/clinkx-workflows/dist/dashboard/settings-process-reader.js.map +1 -0
- package/clinkx-workflows/dist/dashboard/settings-routes.d.ts +87 -0
- package/clinkx-workflows/dist/dashboard/settings-routes.js +690 -0
- package/clinkx-workflows/dist/dashboard/settings-routes.js.map +1 -0
- package/clinkx-workflows/dist/dashboard-ui/assets/index-DSOtuS0p.js +122 -0
- package/clinkx-workflows/dist/dashboard-ui/assets/style-C5guUjwN.css +1 -0
- package/clinkx-workflows/dist/dashboard-ui/index.html +2 -2
- package/clinkx-workflows/dist/durable-file-core.d.ts +76 -0
- package/clinkx-workflows/dist/durable-file-core.js +146 -0
- package/clinkx-workflows/dist/durable-file-core.js.map +1 -0
- package/clinkx-workflows/dist/durable-file.d.ts +8 -64
- package/clinkx-workflows/dist/durable-file.js +14 -137
- package/clinkx-workflows/dist/durable-file.js.map +1 -1
- package/clinkx-workflows/dist/index.js +68 -2
- package/clinkx-workflows/dist/index.js.map +1 -1
- package/clinkx-workflows/dist/settings/audit.d.ts +101 -0
- package/clinkx-workflows/dist/settings/audit.js +318 -0
- package/clinkx-workflows/dist/settings/audit.js.map +1 -0
- package/clinkx-workflows/dist/settings/bootstrap.d.ts +35 -0
- package/clinkx-workflows/dist/settings/bootstrap.js +52 -0
- package/clinkx-workflows/dist/settings/bootstrap.js.map +1 -0
- package/clinkx-workflows/dist/settings/codec.d.ts +51 -0
- package/clinkx-workflows/dist/settings/codec.js +410 -0
- package/clinkx-workflows/dist/settings/codec.js.map +1 -0
- package/clinkx-workflows/dist/settings/durable-write.d.ts +48 -0
- package/clinkx-workflows/dist/settings/durable-write.js +31 -0
- package/clinkx-workflows/dist/settings/durable-write.js.map +1 -0
- package/clinkx-workflows/dist/settings/index.d.ts +20 -0
- package/clinkx-workflows/dist/settings/index.js +23 -0
- package/clinkx-workflows/dist/settings/index.js.map +1 -0
- package/clinkx-workflows/dist/settings/loader.d.ts +80 -0
- package/clinkx-workflows/dist/settings/loader.js +577 -0
- package/clinkx-workflows/dist/settings/loader.js.map +1 -0
- package/clinkx-workflows/dist/settings/lock.d.ts +108 -0
- package/clinkx-workflows/dist/settings/lock.js +344 -0
- package/clinkx-workflows/dist/settings/lock.js.map +1 -0
- package/clinkx-workflows/dist/settings/paths.d.ts +65 -0
- package/clinkx-workflows/dist/settings/paths.js +173 -0
- package/clinkx-workflows/dist/settings/paths.js.map +1 -0
- package/clinkx-workflows/dist/settings/process-heartbeat.d.ts +47 -0
- package/clinkx-workflows/dist/settings/process-heartbeat.js +305 -0
- package/clinkx-workflows/dist/settings/process-heartbeat.js.map +1 -0
- package/clinkx-workflows/dist/settings/registry.d.ts +178 -0
- package/clinkx-workflows/dist/settings/registry.js +1285 -0
- package/clinkx-workflows/dist/settings/registry.js.map +1 -0
- package/clinkx-workflows/dist/settings/schema.d.ts +404 -0
- package/clinkx-workflows/dist/settings/schema.js +415 -0
- package/clinkx-workflows/dist/settings/schema.js.map +1 -0
- package/clinkx-workflows/dist/settings/store.d.ts +157 -0
- package/clinkx-workflows/dist/settings/store.js +842 -0
- package/clinkx-workflows/dist/settings/store.js.map +1 -0
- package/clinkx-workflows/dist/stdio-entry.d.ts +2 -0
- package/clinkx-workflows/dist/stdio-entry.js +52 -0
- package/clinkx-workflows/dist/stdio-entry.js.map +1 -0
- package/dist/dashboard-cli.js +50 -1
- package/dist/dashboard-cli.js.map +1 -1
- package/dist/dashboard-companion/protocol.js +17 -0
- package/dist/dashboard-companion/protocol.js.map +1 -1
- package/dist/dashboard-gateway/control-plane/contracts.d.ts +38 -38
- package/dist/dashboard-gateway/tunnel-http.js +20 -0
- package/dist/dashboard-gateway/tunnel-http.js.map +1 -1
- package/dist/elaris/config.d.ts +10 -0
- package/dist/elaris/config.js +27 -1
- package/dist/elaris/config.js.map +1 -1
- package/dist/elaris/tools.js +4 -1
- package/dist/elaris/tools.js.map +1 -1
- package/dist/index.d.ts +0 -31
- package/dist/index.js +41 -404
- package/dist/index.js.map +1 -1
- package/dist/lib.d.ts +17 -0
- package/dist/lib.js +17 -0
- package/dist/lib.js.map +1 -0
- package/dist/progress-report/lock.d.ts +17 -59
- package/dist/progress-report/lock.js +25 -329
- package/dist/progress-report/lock.js.map +1 -1
- package/dist/server.js +75 -4
- package/dist/server.js.map +1 -1
- package/dist/settings-cli/clients.d.ts +137 -0
- package/dist/settings-cli/clients.js +1124 -0
- package/dist/settings-cli/clients.js.map +1 -0
- package/dist/settings-cli/commands.d.ts +67 -0
- package/dist/settings-cli/commands.js +726 -0
- package/dist/settings-cli/commands.js.map +1 -0
- package/dist/settings-cli/format.d.ts +34 -0
- package/dist/settings-cli/format.js +40 -0
- package/dist/settings-cli/format.js.map +1 -0
- package/dist/settings-cli/main.d.ts +18 -0
- package/dist/settings-cli/main.js +256 -0
- package/dist/settings-cli/main.js.map +1 -0
- package/dist/stdio-main.d.ts +73 -0
- package/dist/stdio-main.js +455 -0
- package/dist/stdio-main.js.map +1 -0
- package/docs/configuration.md +340 -39
- package/docs/security.md +150 -6
- package/package.json +2 -2
- package/clinkx-workflows/dist/dashboard-ui/assets/index-DRId2DVA.js +0 -119
- 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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"}
|