@gajae-gateway/cli 0.1.0

package/dist/list.d.ts

@@ -0,0 +1,55 @@
+import type { MonitorRecord } from "@gajae-gateway/protocol";
+import { originKey } from "@gajae-gateway/protocol";
+export interface Column<T> {
+    readonly name: string;
+    /** Raw value used verbatim by `--json` projection. */
+    readonly value: (row: T, index: number) => unknown;
+}
+export interface ListOptions {
+    readonly json: boolean;
+    readonly fields?: readonly string[];
+    readonly limit?: number;
+    readonly offset: number;
+}
+export declare function columnNames<T>(columns: readonly Column<T>[]): string[];
+export declare function parseListOptions<T>(args: readonly string[], columns: readonly Column<T>[]): ListOptions;
+export declare function selectColumns<T>(columns: readonly Column<T>[], fields?: readonly string[]): Column<T>[];
+/** Rows survive paging with their original index so `index` columns stay stable. */
+export declare function pageRows<T>(rows: readonly T[], options: ListOptions): Array<{
+    row: T;
+    index: number;
+}>;
+/** `lastActivityAt` reads as `LAST_ACTIVITY_AT`, not as an unreadable letter run. */
+export declare function headerLabel(name: string): string;
+export declare function formatCell(value: unknown): string;
+export declare function renderTable<T>(columns: readonly Column<T>[], entries: ReadonlyArray<{
+    row: T;
+    index: number;
+}>): string[];
+export declare function projectRows<T>(columns: readonly Column<T>[], entries: ReadonlyArray<{
+    row: T;
+    index: number;
+}>): Array<Record<string, unknown>>;
+export declare const MONITOR_COLUMNS: readonly Column<MonitorRecord>[];
+export interface SessionListRow {
+    readonly origin: Parameters<typeof originKey>[0];
+    readonly epoch: number;
+    readonly createdAt: string;
+    readonly lastActivityAt: string | null;
+    readonly bootstrap: {
+        readonly pending: boolean;
+        readonly byteCount: number;
+        readonly truncated: boolean;
+    };
+}
+export declare const SESSION_COLUMNS: readonly Column<SessionListRow>[];
+/**
+ * Shared `list` output path: table by default, envelope-preserving JSON under
+ * `--json`. `envelopeKey` is the array field of the gateway result so the
+ * machine shape is identical to the pre-table output.
+ */
+export declare function renderList<T>(columns: readonly Column<T>[], rows: readonly T[], options: ListOptions, envelope: {
+    readonly key: string;
+    readonly result: unknown;
+}): string[];
+//# sourceMappingURL=list.d.ts.map

package/dist/list.d.ts.map

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

package/dist/main.d.ts

@@ -0,0 +1,50 @@
+#!/usr/bin/env bun
+import type { OpsCycleResult } from "@gajae-gateway/protocol";
+import { type InstallServicesOptions } from "./services";
+export declare function socketPath(home?: string | undefined): string;
+/**
+ * Every dispatchable top-level subcommand. An empty argv used to fall through
+ * the switch into the shared catch, which only *sets* an exit code — a probe
+ * with no arguments has to terminate before `main` opens a gateway socket,
+ * 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)";
+/** 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. */
+export declare function usageFor(command: string | undefined): string | undefined;
+export declare function parseArgs(args: string[]): {
+    command?: string;
+    rest: string[];
+    socket: string;
+};
+export interface MainOptions {
+    readonly services?: Pick<InstallServicesOptions, "loginPathRunner" | "writeFile">;
+}
+export type ServicesAction = "install" | "repair";
+export interface ParsedServicesArgs {
+    readonly action: ServicesAction;
+    readonly binDir: string;
+    readonly launchAgentsDir?: string;
+}
+export declare function parseServicesArgs(args: readonly string[]): ParsedServicesArgs;
+/**
+ * Operator runtime-cycle view (`gajaeway ops cycle`).
+ *
+ * Rendering contract:
+ * - The aggregate phase line always prints.
+ * - Any gate prints under `gates:` and forces exit code 1 — a gated cycle is
+ *   never reported as healthy, so scripting cannot mistake it for idle.
+ * - `--json` emits the typed OpsCycleResult verbatim; the exit-code contract
+ *   is identical.
+ */
+export declare function renderCycle(cycle: OpsCycleResult): string[];
+/**
+ * Exit-code contract for `gajaeway ops cycle`: 0 only when the projection is
+ * healthy. Extracted so the automation-facing contract is pinned by tests.
+ */
+export declare function cycleExitCode(cycle: OpsCycleResult): number;
+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

@@ -0,0 +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"}