@automagik/omni 2.260409.6 → 2.260421.3

package/dist/install-helpers.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Install Helpers
+ *
+ * Extracted from commands/install.ts to keep the main command a thin wiring
+ * layer. Each helper is independently testable.
+ */
+export interface ReinstallSignals {
+    isReinstall: boolean;
+    hasConfig: boolean;
+    hasPm2Process: boolean;
+    hasDataDir: boolean;
+}
+/**
+ * Any single signal flags reinstall mode. We err toward reinstall because
+ * reinstall mode is strictly safer (preserves data, skips prompts).
+ */
+export declare function detectReinstall(dataDirOverride?: string): Promise<ReinstallSignals>;
+/** pm2-logrotate settings we enforce. */
+export declare const PM2_LOGROTATE_SETTINGS: {
+    readonly max_size: "10M";
+    readonly retain: "5";
+    readonly compress: "true";
+    readonly rotateInterval: "0 0 * * *";
+};
+/**
+ * Install and configure pm2-logrotate. Best-effort: WARN on failure but never
+ * throw. Idempotent — skips re-install if the module is already configured.
+ */
+export declare function installPm2Logrotate(): Promise<void>;
+/** Write systemd unit files for omni-api and omni-nats under `/etc/systemd/system/`. */
+export declare function writeSystemdUnit(dataDir: string): void;
+//# sourceMappingURL=install-helpers.d.ts.map

package/dist/install-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-helpers.d.ts","sourceRoot":"","sources":["../src/install-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAUzF;AAqCD,yCAAyC;AACzC,eAAO,MAAM,sBAAsB;;;;;CAKzB,CAAC;AAEX;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAiBzD;AAeD,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAsCtD"}

package/dist/nats-install.d.ts

@@ -0,0 +1,11 @@
+/**
+ * NATS Installer
+ *
+ * Downloads and installs the NATS server binary to `~/.omni/nats-server`.
+ * Extracted from install.ts so the install command stays focused on wiring,
+ * not platform-specific download logic.
+ */
+export declare const NATS_BINARY_PATH: string;
+/** Ensure NATS is installed. No-op if the binary already exists. */
+export declare function ensureNats(): Promise<void>;
+//# sourceMappingURL=nats-install.d.ts.map

package/dist/nats-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nats-install.d.ts","sourceRoot":"","sources":["../src/nats-install.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,eAAO,MAAM,gBAAgB,QAAgC,CAAC;AAoE9D,oEAAoE;AACpE,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAOhD"}

package/dist/output.d.ts

@@ -34,13 +34,22 @@ export declare function keyValue(key: string, value: unknown): void;
 export declare function header(title: string): void;
 /** Print dimmed/secondary text */
 export declare function dim(text: string): void;
-/** Raw console.log (for custom formatting) */
+/** Raw stdout line (for custom formatting) */
 export declare function raw(text: string): void;
 /**
- * Flush stdout to ensure all buffered data is written.
- * When stdout is a pipe (e.g., `--json | jq`), writes are buffered.
- * Without explicit flushing, the process can exit before all data is written,
- * causing truncated output.
+ * Flush stdout to ensure all buffered data is written before exit.
+ * When stdout is a pipe (e.g., `--json | cat > file`), writes above the kernel
+ * pipe buffer (64KB on Linux) trigger backpressure and get queued in Bun's
+ * internal stream buffer. If the process exits before those bytes drain,
+ * output is truncated at exactly 64KB boundaries.
+ *
+ * All output paths in this module route through `writeStdoutLine`, which uses
+ * `process.stdout.write(chunk, cb)`. The callback fires only after the chunk
+ * is actually drained; we track those promises in `pendingStdoutWrites` and
+ * await them here.
+ *
+ * A trailing empty-write drain gives any stdout bytes written outside this
+ * module (e.g., direct `process.stdout.write` calls) a final chance to drain.
  */
 export declare function flushStdout(): Promise<void>;
 //# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,2CAA2C;AAC3C,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,kCAAkC;AAClC,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAWD,yBAAyB;AACzB,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5C,4BAA4B;AAC5B,wBAAgB,gBAAgB,IAAI,YAAY,CAE/C;AAED,6BAA6B;AAC7B,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAc7D;AAED,oCAAoC;AACpC,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,QAAQ,SAAI,GAAG,KAAK,CAgB7E;AAED,2FAA2F;AAC3F,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAW1C;AAED,wFAAwF;AACxF,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAW1C;AAED,gCAAgC;AAChC,wBAAgB,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAgBzC;AAKD,6DAA6D;AAC7D,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED,4GAA4G;AAC5G,wBAAgB,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAA;CAAE,GAAG,IAAI,CAgBlG;AA2FD,6BAA6B;AAC7B,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAU1D;AAED,6BAA6B;AAC7B,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAK1C;AAED,kCAAkC;AAClC,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAKtC;AAED,8CAA8C;AAC9C,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAGtC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAM3C"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA+BH,2CAA2C;AAC3C,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,kCAAkC;AAClC,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAWD,yBAAyB;AACzB,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5C,4BAA4B;AAC5B,wBAAgB,gBAAgB,IAAI,YAAY,CAE/C;AAED,6BAA6B;AAC7B,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAW7D;AAED,oCAAoC;AACpC,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,QAAQ,SAAI,GAAG,KAAK,CAgB7E;AAED,2FAA2F;AAC3F,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAU1C;AAED,wFAAwF;AACxF,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAU1C;AAED,gCAAgC;AAChC,wBAAgB,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAczC;AAKD,6DAA6D;AAC7D,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED,4GAA4G;AAC5G,wBAAgB,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAA;CAAE,GAAG,IAAI,CAclG;AAsFD,6BAA6B;AAC7B,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAQ1D;AAED,6BAA6B;AAC7B,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAI1C;AAED,kCAAkC;AAClC,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAItC;AAED,8CAA8C;AAC9C,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEtC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAOjD"}

package/dist/pm2.d.ts

@@ -8,6 +8,52 @@ export declare const PM2_PROCESSES: {
     readonly api: "omni-api";
     readonly nats: "omni-nats";
 };
+/**
+ * Hardened PM2 launch flags for `omni-api` and `omni-nats`.
+ *
+ * Shared by install and start so both paths use identical restart/memory/log
+ * throttling. This is the fix for the 2026-04-09 incident where a crash loop
+ * grew `omni-api-error.log` to 283 GB because pm2 had no `--max-restarts` or
+ * log rotation configured. See WISH: omni-install-resilience.
+ */
+export declare const PM2_HARDENED_DEFAULTS: {
+    readonly maxRestarts: 10;
+    readonly restartDelayMs: 5000;
+    readonly apiMaxMemory: "2G";
+    readonly natsMaxMemory: "1G";
+    readonly logDateFormat: "YYYY-MM-DD HH:mm:ss.SSS";
+};
+/** Directory where hardened pm2 logs are written. */
+export declare function getPm2LogDir(): string;
+/** Hardened log path for a given pm2 process name. */
+export declare function getPm2LogPaths(processName: string): {
+    out: string;
+    error: string;
+};
+/**
+ * Options for `buildPm2StartArgs`. Either an `api` or `nats` launch.
+ */
+export interface Pm2StartArgsOptions {
+    /** Target process kind — controls memory limit and log paths. */
+    kind: 'api' | 'nats';
+    /** Script/binary to launch (e.g. the server launcher shell or the nats binary). */
+    script: string;
+    /** pm2 process name (`omni-api` or `omni-nats`). */
+    name: string;
+    /**
+     * Optional `--interpreter <name>` value. API launches via `bash` to hit the
+     * shell launcher; NATS runs as a native binary and should pass `'none'`.
+     */
+    interpreter?: string;
+    /** Arguments forwarded after `--` to the spawned process. */
+    scriptArgs?: string[];
+}
+/**
+ * Build the full `pm2 start ...` argv for hardened launches. Both install and
+ * start consume this so the restart/memory/log flags live in exactly one
+ * place.
+ */
+export declare function buildPm2StartArgs(options: Pm2StartArgsOptions): string[];
 /** Map CLI service arg to PM2 process name */
 export declare function resolveProcessName(service: string): string;
 /** Check if PM2 is available in PATH */

package/dist/pm2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pm2.d.ts","sourceRoot":"","sources":["../src/pm2.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,wCAAwC;AACxC,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAEX,8CAA8C;AAC9C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAI1D;AAED,wCAAwC;AACxC,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAYvD;AAED,gEAAgE;AAChE,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CASnG;AAED,2CAA2C;AAC3C,wBAAsB,UAAU,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAU7F;AAED,sDAAsD;AACtD,wBAAgB,gBAAgB,IAAI,KAAK,CAExC"}
+{"version":3,"file":"pm2.d.ts","sourceRoot":"","sources":["../src/pm2.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,wCAAwC;AACxC,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAEX;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB;;;;;;CAMxB,CAAC;AAEX,qDAAqD;AACrD,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAMlF;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IACrB,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,EAAE,CAiCxE;AAED,8CAA8C;AAC9C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAI1D;AAED,wCAAwC;AACxC,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAYvD;AAED,gEAAgE;AAChE,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CASnG;AAED,2CAA2C;AAC3C,wBAAsB,UAAU,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAU7F;AAED,sDAAsD;AACtD,wBAAgB,gBAAgB,IAAI,KAAK,CAExC"}