@pleri/olam-cli 0.1.201 → 0.1.205

package/dist/commands/services.d.ts

@@ -1,218 +0,0 @@
-/**
- * `olam services` — umbrella verb for managing Olam service containers.
- *
- * Subcommands:
- *   olam services up              — start all service containers (idempotent)
- *   olam services down            — stop all service containers
- *   olam services status          — show state of all service containers
- *   olam services restart <name>  — restart a named service
- *
- * Substrate-aware (D1 — Phase 2 Phase D):
- *   compose    → docker-based lifecycle (AuthContainerController / McpAuth / KgService)
- *   kubernetes → kubectl scale / rollout restart / get deployment
- *
- * `olam auth up/down/status` delegates here with a deprecation warning.
- */
-import type { Command } from 'commander';
-import { kubectlWrap } from '../lib/kubectl-wrap.js';
-type ContainerState = 'running' | 'stopped' | 'missing';
-interface ContainerStatus {
-    readonly state: ContainerState;
-    readonly port: number;
-    readonly containerId?: string;
-}
-export declare class McpAuthContainerController {
-    private imageTag;
-    status(): ContainerStatus;
-    private imageExists;
-    start(): void;
-    stop(): void;
-    remove(): void;
-    waitForReady(timeoutMs?: number): Promise<boolean>;
-}
-export interface ServicesKubernetesDeps {
-    readonly kubectlWrapImpl?: typeof kubectlWrap;
-    readonly configPath?: string;
-}
-/**
- * `olam services up` on kubernetes substrate.
- * Scales each peripheral deployment to replicas=1.
- * Applies the manifest if the Deployment is missing (not found).
- */
-export declare function servicesUpKubernetes(deps?: ServicesKubernetesDeps): Promise<{
-    exitCode: number;
-}>;
-/**
- * `olam services down` on kubernetes substrate.
- * Scales each peripheral deployment to replicas=0.
- */
-export declare function servicesDownKubernetes(deps?: ServicesKubernetesDeps): Promise<{
-    exitCode: number;
-}>;
-/**
- * `olam services status` on kubernetes substrate.
- * Fetches `kubectl get deployment -n olam -o wide` and formats it to match
- * the compose table shape: NAME | STATUS | IMAGE | AGE | RESTARTS.
- */
-/**
- * Collect k8s deployment statuses and emit as `ServiceStatusEntry[]` array.
- * Used by `servicesStatusJsonKubernetes()` for `--json` mode.
- * Probes kubectl for deployment readiness and maps to the compose schema.
- */
-export declare function collectServicesStatusKubernetes(deps?: ServicesKubernetesDeps): Promise<ServiceStatusEntry[]>;
-export declare function servicesStatusKubernetes(deps?: ServicesKubernetesDeps): Promise<void>;
-/**
- * Normalize a user-supplied service name to the k8s Deployment name form.
- *
- * All olam peripheral Deployments are named `olam-<short-name>` in the k8s
- * manifests (e.g. `olam-kg-service`, `olam-auth-service`). When the operator
- * types `olam services restart kg-service` the CLI must prepend `olam-` before
- * calling `kubectl rollout restart deployment/olam-kg-service`.
- *
- * Idempotent: if the user already types the full name (`olam-kg-service`), the
- * prefix is NOT doubled → `olam-kg-service` (NOT `olam-olam-kg-service`).
- *
- * Exported for unit testing (C1 — R3-D).
- */
-export declare function normalizeK8sDeploymentName(name: string): string;
-/**
- * `olam services restart <name>` on kubernetes substrate.
- * Uses `kubectl rollout restart deployment/olam-<name>`.
- * Prepends `olam-` to the user-supplied name (idempotent — no double-prefix).
- */
-export declare function servicesRestartKubernetes(name: string, deps?: ServicesKubernetesDeps): Promise<{
-    exitCode: number;
-}>;
-/** Start both auth containers, idempotent. */
-/**
- * Dump the last N lines of `docker logs <container>` to stderr so the
- * operator can see why /health didn't respond. Pre-fix, the timeout
- * branch printed only "started but /health did not respond within Ns"
- * and the operator had no way to know whether the container had
- * crashed, was stuck on an env var, or was just genuinely slow.
- */
-/**
- * Idempotently ensure `alpine/socat:latest` is present locally.
- *
- * Called during `olam services up` so the first `olam_port_expose` call
- * (which spawns an `alpine/socat` sidecar container via host-cp) doesn't
- * fail opaquely with an image-pull error on hosts where the image isn't
- * cached. See issue #964.
- *
- * Failure-mode contract: NEVER throws. Returns a status object the caller
- * renders as a printSuccess / printInfo / printWarning. If docker isn't
- * installed or the daemon is unreachable, returns `{ dockerAvailable: false }`
- * and the start flow continues — running services may still be useful even
- * when port-expose isn't.
- */
-export interface PullSocatImageDeps {
-    readonly spawnImpl?: (cmd: string, args: readonly string[], opts?: {
-        encoding?: 'utf-8';
-        timeout?: number;
-    }) => {
-        status: number | null;
-        stdout: string;
-        stderr: string;
-    };
-}
-export interface PullSocatImageResult {
-    readonly dockerAvailable: boolean;
-    readonly alreadyPresent: boolean;
-    readonly pulled: boolean;
-    readonly error?: string;
-}
-export declare function pullSocatImage(deps?: PullSocatImageDeps): PullSocatImageResult;
-export interface ServicesUpComposeDeps {
-    /**
-     * D1: when true, start the local olam-auth container (legacy mode).
-     * Defaults to false — cloud-only-vault is the new default.
-     * Auto-opt-in when OLAM_CREDENTIAL_BACKEND=local env var is present.
-     */
-    readonly withLocalAuth?: boolean;
-    /**
-     * D1: injectable docker-inspect function for stale-detection tests.
-     * Receives the container name; returns 'running' | 'stopped' | 'missing'.
-     */
-    readonly inspectContainerStateFn?: (name: string) => ContainerState;
-}
-/**
- * Resolve whether the local olam-auth container should be started.
- *
- * Priority (D1):
- *   1. `withLocalAuth` explicit option
- *   2. `OLAM_CREDENTIAL_BACKEND=local` env var → auto-opt-in (back-compat)
- *   3. Default false (cloud-only-vault default)
- */
-export declare function resolveWithLocalAuth(withLocalAuth?: boolean): boolean;
-export declare function servicesUp(deps?: ServicesUpComposeDeps): Promise<{
-    exitCode: number;
-}>;
-/** Stop all (or a named subset of) service containers.
- *
- * @param include - Optional list of container names to stop. When empty,
- *   all containers are stopped. When non-empty, only the named containers
- *   are stopped (e.g. `['olam-auth']`). Unknown names produce a warning
- *   and are skipped; they do NOT set exitCode = 1.
- */
-export declare function servicesDown(opts?: {
-    include?: string[];
-}): {
-    exitCode: number;
-};
-/** One service container's state in the `--json` projection. */
-export interface ServiceStatusEntry {
-    /** Stable docker container name (e.g. `olam-auth`). */
-    readonly name: string;
-    /** Container lifecycle: `running` (up), `stopped` (exists, not running), `missing` (no container). */
-    readonly state: ContainerState;
-    /** Published host port the service listens on. */
-    readonly port: number;
-    /**
-     * 12-char short container id (matches `docker ps` truncation), or `null`
-     * when the container is `missing`. Short — not the full 64-char id — so the
-     * payload mirrors what operators see and never doubles as a handle to a
-     * full-id-gated operation.
-     */
-    readonly containerId: string | null;
-}
-/** Injectable controller surface — just the `.status()` method each controller exposes. */
-interface ServiceStatusController {
-    status(): {
-        state: ContainerState;
-        port: number;
-        containerId?: string;
-    };
-}
-export interface ServicesStatusDeps {
-    readonly auth?: ServiceStatusController;
-    readonly mcpAuth?: ServiceStatusController;
-    readonly kgService?: ServiceStatusController;
-    readonly memoryService?: ServiceStatusController;
-}
-/**
- * Pure collector: probe each service controller and return a stable, ordered
- * array. Order is fixed (auth, mcp-auth, kg-service, memory-service) so JSON
- * consumers can index positionally AND the human table order is preserved.
- *
- * Controllers are injectable for unit testing (mirrors the kg-doctor deps
- * pattern) — no live docker daemon needed in tests.
- */
-export declare function collectServicesStatus(deps?: ServicesStatusDeps): ServiceStatusEntry[];
-/** Show container state for all services. */
-export declare function servicesStatus(deps?: ServicesStatusDeps): void;
-/**
- * `--json` projection of `services status` (compose path). Emits a stable
- * array to stdout. Exit-code contract is unchanged from the human path
- * (always 0 — `services status` has never gated its exit code on container
- * health).
- */
-export declare function servicesStatusJson(deps?: ServicesStatusDeps): void;
-/**
- * `--json` projection of `services status` (kubernetes path). Emits a stable
- * array to stdout, matching the compose JSON shape. Exit-code contract is
- * unchanged (always 0).
- */
-export declare function servicesStatusJsonKubernetes(deps?: ServicesKubernetesDeps): Promise<void>;
-export declare function registerServices(program: Command): void;
-export {};
-//# sourceMappingURL=services.d.ts.map

package/dist/commands/services.d.ts.map

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