@schema-weaver/pg-connector 0.0.0-stage → 2.0.1

package/dist/cjs/cli/commands/stop.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runStop = runStop;
+const paths_1 = require("../../config/paths");
+const pid_file_1 = require("../daemon/pid-file");
+const readiness_1 = require("../daemon/readiness");
+const prompt_1 = require("../prompt");
+const ui_1 = require("../ui");
+function exit_(code) {
+    if ((0, prompt_1.isReplMode)()) {
+        throw { __exitCode: code };
+    }
+    process.exit(code);
+}
+async function runStop(args, opts = {}) {
+    const force = opts.force || args.includes('--force') || args.includes('-f');
+    const timeoutMs = opts.timeoutMs ?? 30_000;
+    const pidFile = (0, paths_1.getPidFilePath)();
+    const pidInfo = await (0, pid_file_1.readPidFile)({ path: pidFile });
+    if (!pidInfo) {
+        console.log(`  ${ui_1.C.yellow(ui_1.S.warning)} No agent running (no PID file found)`);
+        exit_(0);
+    }
+    const { pid, started_at, version } = pidInfo;
+    if (!(0, pid_file_1.isProcessAlive)(pid)) {
+        console.log(`  ${ui_1.C.yellow(ui_1.S.warning)} Agent (pid ${pid}) is not running. Cleaning up stale PID file.`);
+        await (0, pid_file_1.deletePidFile)({ path: pidFile });
+        exit_(0);
+    }
+    console.log();
+    console.log(`  ${ui_1.C.dim('Stopping agent...')}`);
+    console.log(`    PID:      ${ui_1.C.white(String(pid))}`);
+    console.log(`    Started:  ${ui_1.C.dim(started_at)}`);
+    console.log(`    Version:  ${ui_1.C.dim(version)}`);
+    console.log();
+    const spinner = (0, ui_1.createSpinner)();
+    if (force) {
+        spinner.start('Sending SIGTERM...');
+        try {
+            process.kill(pid, 'SIGTERM');
+        }
+        catch {
+            // ignore
+        }
+        const deadline = Date.now() + timeoutMs;
+        while ((0, pid_file_1.isProcessAlive)(pid) && Date.now() < deadline) {
+            await new Promise((resolve) => setTimeout(resolve, 500));
+        }
+        if ((0, pid_file_1.isProcessAlive)(pid)) {
+            spinner.update('SIGTERM failed, sending SIGKILL...');
+            try {
+                process.kill(pid, 'SIGKILL');
+            }
+            catch {
+                // ignore
+            }
+            await new Promise((resolve) => setTimeout(resolve, 1000));
+        }
+        spinner.stop();
+        if ((0, pid_file_1.isProcessAlive)(pid)) {
+            console.log(`  ${ui_1.C.red(ui_1.S.cross)} Failed to kill process ${pid}`);
+            exit_(1);
+        }
+    }
+    else {
+        spinner.start('Sending SIGTERM...');
+        try {
+            process.kill(pid, 'SIGTERM');
+        }
+        catch {
+            spinner.stop();
+            console.log(`  ${ui_1.C.red(ui_1.S.cross)} Failed to send SIGTERM to process ${pid}`);
+            exit_(1);
+        }
+        // Wait for process to actually exit
+        const deadline = Date.now() + timeoutMs;
+        while ((0, pid_file_1.isProcessAlive)(pid) && Date.now() < deadline) {
+            await new Promise((resolve) => setTimeout(resolve, 500));
+        }
+        spinner.stop();
+        if ((0, pid_file_1.isProcessAlive)(pid)) {
+            console.log(`  ${ui_1.C.yellow(ui_1.S.warning)} Process did not exit gracefully. Use ${ui_1.C.cyan('--force')} to kill.`);
+            exit_(1);
+        }
+    }
+    // Clean up PID file
+    await (0, pid_file_1.deletePidFile)({ path: pidFile });
+    // Confirm the process is truly gone so a follow-up status check is accurate.
+    const gone = await (0, readiness_1.waitForAgentGone)(pidFile, { timeoutMs: 3_000 });
+    if (gone.gone) {
+        console.log(`  ${ui_1.C.green(ui_1.S.check)} Agent stopped and PID file cleaned up.`);
+    }
+    else {
+        console.log(`  ${ui_1.C.yellow(ui_1.S.warning)} PID file removed, but process may still be exiting.`);
+    }
+    console.log();
+    exit_(0);
+}
+//# sourceMappingURL=stop.js.map

package/dist/cjs/cli/commands/stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../../../src/cli/commands/stop.ts"],"names":[],"mappings":"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"}

package/dist/cjs/cli/daemon/error-tracker.d.ts

@@ -0,0 +1,119 @@
+import { type FaultShutdownController, type FaultShutdownDeps } from './fault-shutdown';
+export interface ErrorRecord {
+    ts: string;
+    level: 'error' | 'warn' | 'fatal';
+    op?: string;
+    code?: string;
+    message: string;
+    stack?: string;
+    agent_id?: string;
+    pid: number;
+}
+/** Rotate at 2 MiB. A daemon that logs an error per query must not fill a disk. */
+export declare const MAX_ERROR_LOG_BYTES: number;
+/** Keep the active file plus this many rotated archives. */
+export declare const MAX_ERROR_ARCHIVES = 3;
+/**
+ * Strip SQL text and absolute filesystem paths out of free-form text.
+ *
+ * `pg` error messages embed the offending statement and stack frames embed the
+ * absolute path of the agent home directory and of `node_modules`. Neither
+ * belongs in an error log that no operator is looking at.
+ */
+export declare function redactErrorText(input: string): string;
+/**
+ * Roll `errors.jsonl` to `errors-1.jsonl`, shifting older archives down and
+ * dropping anything past the retention window. Mirrors the rotation the audit
+ * writer performs for `audit.jsonl`.
+ */
+export declare function rotateErrorLog(): void;
+/**
+ * Track an error to the local, size-capped, rotated `errors.jsonl` log.
+ * Structured, one JSON object per line. Never throws: losing the error record
+ * must not turn a recoverable failure into a crash.
+ *
+ * The record is redacted before it is written — SQL fragments and absolute
+ * filesystem paths (the agent home directory, `node_modules`) are stripped from
+ * both `message` and `stack`. The file stays local; nothing in this module
+ * transmits it anywhere.
+ */
+export declare function trackError(err: unknown, opts?: {
+    op?: string;
+    level?: 'error' | 'warn' | 'fatal';
+}): void;
+/** Path to the active local error log file. */
+export declare function getErrorsPath(): string;
+/** Paths to every file that makes up the error log, oldest archive first. */
+export declare function getErrorLogFiles(): string[];
+export interface ErrorLogStats {
+    path: string;
+    /** Bytes across the active file and every retained archive. */
+    size_bytes: number;
+    /** Records in the active file. */
+    records: number;
+    /** Retained archive files that currently exist. */
+    archives: number;
+    /** ISO timestamp of the most recent record, if any. */
+    last_error_ts: string | null;
+}
+/**
+ * Summarise the on-disk error log for `sw-agent status` and `sw-agent debug`.
+ * A missing log is a valid state, not an error.
+ */
+export declare function getErrorLogStats(): ErrorLogStats;
+/**
+ * fsync the active error log so the record that describes a fatal fault is on
+ * the disk before the process exits.
+ *
+ * `appendLine` uses `appendFileSync`, which hands the data to the kernel and
+ * returns — it does not wait for the storage. A process that exits
+ * milliseconds later can therefore lose the one record that explains why. Best
+ * effort: a missing `errors.jsonl`, a rotated-away active file, or a filesystem
+ * that rejects `fsync` must not stop the exit, because the exit is the part that
+ * matters.
+ */
+export declare function fsyncErrorLog(): boolean;
+/** The live fault controller, or null before the handlers are installed. */
+export declare function getFaultShutdownController(): FaultShutdownController | null;
+/**
+ * Register the audit-sink and pool handles the fault path must drain before it
+ * exits. Safe to call before or after {@link installGlobalHandlers}.
+ *
+ * Without this, a fault still exits non-zero and still fsyncs `errors.jsonl`, but
+ * the audit sink is left unflushed, so the final record of the action that
+ * caused the fault may never reach the chain. See the report's
+ * OTHER-FILE CHANGE REQUESTED for the one-line call site in `runtime.ts`.
+ */
+export declare function registerFaultShutdownHooks(hooks: Pick<FaultShutdownDeps, 'flushAudit' | 'closePools'>): void;
+/**
+ * Install process-level handlers for an uncaught exception or an unhandled
+ * promise rejection.
+ *
+ * Both are FAIL-CLOSED: the fault is recorded and redacted, the audit
+ * sink and the pools are drained on a bounded timer, and the process then exits
+ * non-zero so `Restart=on-failure` brings up a clean one. The previous version
+ * only recorded the fault, which OVERRODE Node's terminate-by-default behaviour
+ * and left a daemon serving database traffic in an undefined state.
+ *
+ * `unhandledRejection` is the one place that continues — and only for a reason
+ * a call site explicitly tagged with `markNonFatalRejection`. See
+ * `fault-shutdown.ts` for why the tag is a non-enumerable symbol.
+ *
+ * Also emits the startup posture lines. This is the daemon-startup hook the
+ * runtime already owns (`runAgent()` calls it right after
+ * `stripUnrecognisedSecurityEnv()`), and the resolved agent home has to be
+ * logged from somewhere that runs exactly once per daemon start. An
+ * `AgentHomeMismatchError` thrown from here propagates out of `runAgent()` and
+ * is reported by the CLI with a non-zero exit, which is the intended
+ * fail-closed outcome: a daemon running against a home nobody configured would
+ * apply a different permission default, a different database scope and a
+ * different audit key.
+ */
+export declare function installGlobalHandlers(currentAgentId?: string, hooks?: Pick<FaultShutdownDeps, 'flushAudit' | 'closePools'>): void;
+/** Reset the install latch. Test helper; a second install in one process is a no-op. */
+export declare function resetGlobalHandlersForTests(): void;
+/** Read recent error records from the local log, newest last. */
+export declare function readRecentErrors(limit: number): Promise<ErrorRecord[]>;
+/** Reset the cached active-file size and directory memo. Test and lifecycle helper. */
+export declare function resetErrorLogCache(): void;
+//# sourceMappingURL=error-tracker.d.ts.map

package/dist/cjs/cli/daemon/error-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-tracker.d.ts","sourceRoot":"","sources":["../../../../src/cli/daemon/error-tracker.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAG1B,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IAClC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,mFAAmF;AACnF,eAAO,MAAM,mBAAmB,QAAkB,CAAC;AAEnD,4DAA4D;AAC5D,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAsEpC;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOrD;AAsBD;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAyBrC;AA2BD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,OAAO,EACZ,IAAI,GAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAA;CAAO,GAC7D,IAAI,CAkBN;AAED,+CAA+C;AAC/C,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAQ3C;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAuChD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAkBvC;AAeD,4EAA4E;AAC5E,wBAAgB,0BAA0B,IAAI,uBAAuB,GAAG,IAAI,CAE3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,GAAG,YAAY,CAAC,GAC1D,IAAI,CAGN;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,CAAC,EAAE,MAAM,EACvB,KAAK,GAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,GAAG,YAAY,CAAM,GAC/D,IAAI,CAmEN;AAED,wFAAwF;AACxF,wBAAgB,2BAA2B,IAAI,IAAI,CAKlD;AAED,iEAAiE;AACjE,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAuB5E;AAED,uFAAuF;AACvF,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC"}