@gajae-gateway/cli 0.1.1 → 0.1.2

package/dist/main.d.ts

@@ -1,6 +1,7 @@
 #!/usr/bin/env bun
 import type { OpsCycleResult } from "@gajae-gateway/protocol";
-import { type InstallServicesOptions } from "./services";
+import { type LaunchRestartOptions, type RunRestartOptions } from "./restart-stack";
+import { type InstallServicesOptions, type ServicePlatform } from "./services";
 export declare function socketPath(home?: string | undefined): string;
 /**
  * Every dispatchable top-level subcommand. An empty argv used to fall through
@@ -9,7 +10,7 @@ export declare function socketPath(home?: string | undefined): string;
  * never after, so the list is checked up front.
  */
 export declare const COMMANDS: readonly ["status", "shutdown", "chat", "daemon", "sessions", "ops", "memory", "monitors", "work", "services"];
-export declare const CLI_USAGE = "usage: gajaeway [--socket PATH] status|shutdown|chat|daemon run|sessions list [--json] [--fields a,b,c] [--limit N] [--offset N]|sessions inspect <originKey-or-index>|memory audit|memory search <query>|monitors ...|work run|start <name> [--cwd DIR] [--resume] [--model ID|--preset NAME] [--notify originKey (start only)] <text>|work status <name>|work steer <name> <text>|work retire <name>|work jobs|ops backup <path>|ops cycle [--json]|ops integrity|ops restore <backupPath>|services install|repair --bin-dir DIR [--launch-agents-dir DIR] (work run waits for a response; caller timeout does not end the attempt)";
+export declare const CLI_USAGE = "usage: gajaeway [--socket PATH] status|shutdown|chat|daemon run|sessions list [--json] [--fields a,b,c] [--limit N] [--offset N]|sessions inspect <originKey-or-index>|memory audit|memory search <query>|monitors ... (test <id> [--type T] [--payload J] [--wait[=SECONDS]])|work run|start <name> [--cwd DIR] [--resume] [--model ID|--preset NAME] <text>|work status <name>|work steer <name> <text>|work retire <name>|work jobs|ops backup <path>|ops redeliver <deliveryId>|ops redeliver --since <iso>|ops cycle [--json]|ops integrity|ops restore <backupPath>|ops restart-stack [--status]|services install|repair --bin-dir DIR [--launch-agents-dir DIR] [--unit-dir DIR] [--platform darwin|linux] (work run waits for a response; caller timeout does not end the attempt)";
 /** Usage errors exit 2, as `gajaeway-gateway` does; 1 stays a runtime failure. */
 export declare const USAGE_EXIT_CODE = 2;
 /** The usage text when `command` cannot be dispatched, undefined when it can. */
@@ -21,12 +22,19 @@ export declare function parseArgs(args: string[]): {
 };
 export interface MainOptions {
     readonly services?: Pick<InstallServicesOptions, "loginPathRunner" | "writeFile">;
+    /** Test seams for `ops restart-stack`; the real path spawns the service manager. */
+    readonly restartStack?: {
+        readonly launch?: Omit<LaunchRestartOptions, "home">;
+        readonly run?: Omit<RunRestartOptions, "home" | "id">;
+    };
 }
 export type ServicesAction = "install" | "repair";
 export interface ParsedServicesArgs {
     readonly action: ServicesAction;
     readonly binDir: string;
     readonly launchAgentsDir?: string;
+    readonly unitDir?: string;
+    readonly platform?: ServicePlatform;
 }
 export declare function parseServicesArgs(args: readonly string[]): ParsedServicesArgs;
 /**
@@ -45,6 +53,34 @@ export declare function renderCycle(cycle: OpsCycleResult): string[];
  * healthy. Extracted so the automation-facing contract is pinned by tests.
  */
 export declare function cycleExitCode(cycle: OpsCycleResult): number;
+/**
+ * The same acceptance the gateway applies at boot (`PRAGMA integrity_check`
+ * must answer `ok`), run read-only against the backup before it replaces
+ * anything. A 16-byte header match is not a database: a truncated or
+ * bit-flipped file passes it, gets copied into place, and the next boot
+ * fails while the restore already reported success.
+ *
+ * An empty file is also refused: SQLite treats a zero-length file as a valid
+ * empty database and `integrity_check` answers `ok` for it, but restoring it
+ * would boot a gateway with every table freshly created and nothing in them.
+ *
+ * Opening a WAL-mode backup read-only may leave empty `-wal`/`-shm` sidecars
+ * next to the backup; `ops backup` writes delete-mode files, which gain none.
+ */
+export declare function verifyBackupIntegrity(backupPath: string): void;
+/**
+ * The database the gateway actually opens: `config.json` `dbPath` when set,
+ * otherwise `<home>/gateway.db` — the same file-based resolution as the
+ * gateway's `loadConfig`. An absent `config.json` means defaults, exactly as
+ * at boot. A present-but-unreadable one (EACCES, EISDIR, or a dangling symlink,
+ * which reports ENOENT while the entry exists) refuses the restore instead of
+ * guessing, as boot refuses to start: copying a backup over the wrong file
+ * reports success while the live database stays broken.
+ *
+ * `schemaVersion` is deliberately not checked: `dbPath` is a version-independent
+ * string, and disaster recovery must not be blocked by an unrelated schema bump.
+ */
+export declare function restoreTargetPath(home?: string): Promise<string>;
 export declare function restoreDatabase(socket: string, backupPath: string): Promise<void>;
 export declare function main(args?: string[], options?: MainOptions): Promise<void>;
 //# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AAGA,OAAO,KAAK,EAEX,cAAc,EASd,MAAM,yBAAyB,CAAC;AAYjC,OAAO,EAAE,KAAK,sBAAsB,EAAiC,MAAM,YAAY,CAAC;AAExF,wBAAgB,UAAU,CAAC,IAAI,qBAA4B,GAAG,MAAM,CAEnE;AAED;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,gHAWX,CAAC;AAEX,eAAO,MAAM,SAAS,0mBACklB,CAAC;AAEzmB,kFAAkF;AAClF,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAExE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAQ9F;AAMD,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,iBAAiB,GAAG,WAAW,CAAC,CAAC;CAClF;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,CAAC;AAElD,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,kBAAkB,CAiB7E;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,EAAE,CAkC3D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAE3D;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBvF;AAyDD,wBAAsB,IAAI,CAAC,IAAI,WAAwB,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0UjG"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AAIA,OAAO,KAAK,EAIX,cAAc,EAQd,MAAM,yBAAyB,CAAC;AAYjC,OAAO,EAEN,KAAK,oBAAoB,EAEzB,KAAK,iBAAiB,EAItB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,sBAAsB,EAAmB,KAAK,eAAe,EAAgB,MAAM,YAAY,CAAC;AAE9G,wBAAgB,UAAU,CAAC,IAAI,qBAA4B,GAAG,MAAM,CAEnE;AAED;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,gHAWX,CAAC;AAEX,eAAO,MAAM,SAAS,+vBACuuB,CAAC;AAE9vB,kFAAkF;AAClF,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAExE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAQ9F;AAMD,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,iBAAiB,GAAG,WAAW,CAAC,CAAC;IAClF,oFAAoF;IACpF,QAAQ,CAAC,YAAY,CAAC,EAAE;QACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;QACrD,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;KACtD,CAAC;CACF;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,CAAC;AAElD,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC;CACpC;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,kBAAkB,CA8B7E;AAqID;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,EAAE,CA+C3D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAE3D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAwB9D;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,SAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B7E;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBvF;AA8DD,wBAAsB,IAAI,CAAC,IAAI,WAAwB,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+XjG"}