@pleri/olam-cli 0.1.201 → 0.1.205

package/dist/commands/setup.d.ts

@@ -1,231 +0,0 @@
-/**
- * olam setup — substrate-aware fresh-host wizard.
- *
- * Phase C2 of olam-operator-onboarding-parity (plan
- * ~/.claude/plans/olam-operator-onboarding-parity.md).
- *
- * Substrate-aware orchestration. Default substrate = kubernetes (k3d on all
- * platforms — macOS and Linux alike). Existing installs whose ~/.olam/config.json
- * carries host.substrate: 'compose' are protected — they continue on docker/compose
- * and see a one-line migration hint; no auto-migration.
- *
- * Kubernetes substrate phases (default for fresh installs):
- *   Phase 1:   System check     (kubectl on PATH + docker daemon + Node ≥20)
- *   Phase 1.5: Install k3d      (brew install k3d when available; else upstream install.sh)
- *   Phase 2:   olam CLI sanity  (--version returns)
- *   Phase 2.5: Provision cluster (k3d cluster create olam-dev; k3d updates ~/.kube/config)
- *   Phase 2.6: Pin kubectl context (writes host.kubectl_context_pinned = k3d-olam-dev)
- *   Phase 3:   Bootstrap        (subprocess: olam bootstrap with kubernetes substrate)
- *   Phase 3.5: K3d HTTPS bootstrap (mkcert install + TLS Secret → Traefik IngressRoute)
- *   …        same as docker thereafter
- *
- * Docker substrate phases (existing compose installs or --substrate=docker):
- *   Phase 1:   System check     (Docker daemon reachable + Node ≥20)
- *   Phase 1.5: (no-op for docker)
- *   Phase 2:   olam CLI sanity  (--version returns)
- *   Phase 2.5: (no-op for docker)
- *   Phase 3:   Bootstrap        (subprocess: olam bootstrap)
- *   Phase 3.5: (no-op for docker)
- *   Phase 4:   Shell init       (idempotent append of completion eval-line)
- *   Phase 5:   Init global config (ensure ~/.olam/config.json has host.substrate set)
- *   Phase 5a:  Skill source picker (runs unconditionally; auto-skips when sources already registered)
- *   Phase 5b:  Project sweep
- *   Phase 6:   Auth prompt      (offer interactive `olam auth login`)
- *   Phase 7:   Final verify     (subprocess: olam doctor; halt on non-zero)
- *
- * End-state prints "next steps" pointing at the 3-contract docs per
- * CLAUDE.md's "Reading order for new orgs."
- *
- * Failure semantics: setup fails fast at the first failed phase + prints
- * a named remedy. All phases are idempotent so re-running is safe.
- *
- * Flags:
- *   --substrate=<docker|kubernetes>  substrate to target (default: kubernetes; alias k3s→kubernetes)
- *   --cluster-name=<name>            k3d cluster name (default: olam-dev). Useful for operators with
- *                                    pre-existing clusters or running multiple olam stacks side-by-side.
- *   --skip-https-bootstrap           skip Phase 3.5 (operator manages TLS certs manually)
- *   --skip-shell-init                skip Phase 4 (operator manages shell rc manually)
- *   --skip-auth                      skip Phase 6 (operator will run `olam auth login` later)
- *   --yes / -y                       auto-affirm every prompt (non-interactive)
- *
- * Reversibility: clean-revert; each phase delegates to a separately-
- * tested primitive. Phase 4 keeps a `<rc>.olam-bak.<ts>` backup.
- */
-import type { Command } from 'commander';
-import { type DockerExec } from '../lib/health-probes.js';
-import { type KubeContextDeps, type KubeContextProbe } from '../lib/k8s-context-discovery.js';
-import { type AddSkillSourceFn, type CloneSkillSourceFn, type AppendTrustAuditFn, type RedactUrlFn, type SelectPromptFn, type InputPromptFn } from './setup-phase-5a-skill-source.js';
-/** k3d cluster name provisioned by olam setup --substrate=kubernetes. */
-export declare const SETUP_K3D_CLUSTER_NAME = "olam-dev";
-/** Exported type so callers can reference the substrate union. */
-export type SetupSubstrate = 'docker' | 'kubernetes';
-export interface RunSetupOptions {
-    readonly skipShellInit?: boolean;
-    readonly skipAuth?: boolean;
-    readonly yes?: boolean;
-    readonly skipSkillSource?: boolean;
-    readonly skipProjectSweep?: boolean;
-    /** Non-interactive skill-source selection: a curated name/value or a git URL. */
-    readonly skillSource?: string;
-    /** Phase 5b: project root path to walk (default: ~/Projects). */
-    readonly projects?: string;
-    /** Phase 5b: print matches without registering or building (no side effects). */
-    readonly dryRun?: boolean;
-    /** Phase 5b: additional skip patterns for the walker (additive to defaults). */
-    readonly exclude?: string[];
-    /** Phase 5b: skip KG eager-build sub-step (sources still registered). */
-    readonly skipKg?: boolean;
-    /**
-     * Substrate to target. Default: 'kubernetes' for fresh installs;
-     * auto-detected from ~/.olam/config.json when present. Existing installs
-     * with host.substrate='compose' in config stay on docker and see a migration
-     * hint. Explicit --substrate=kubernetes (or alias --substrate=k3s) targets
-     * the k3d path. --substrate=docker forces docker even on fresh machines.
-     */
-    readonly substrate?: SetupSubstrate;
-    /**
-     * k3d cluster name to create/use (kubernetes substrate only).
-     * Default: SETUP_K3D_CLUSTER_NAME ('olam-dev').
-     * Use a different name to avoid colliding with a pre-existing olam-dev cluster
-     * or to run multiple olam stacks side-by-side on the same machine.
-     * Ignored when --substrate=docker.
-     * Must match DNS-label rules: ^[a-z0-9]([a-z0-9-]*[a-z0-9])?$
-     */
-    readonly clusterName?: string;
-    /**
-     * Phase 3.5: skip the K3d HTTPS bootstrap (mkcert install + TLS Secret).
-     * Set when the operator manages certs manually or mkcert is not on PATH.
-     * olam services tls-install can still be run later to provision certs.
-     */
-    readonly skipHttpsBootstrap?: boolean;
-    /**
-     * Phase 7: skip final `olam doctor` verification.
-     * Useful in CI where doctor probes expect a fully-wired production stack
-     * (credentials, docker-socket-proxy, etc.) that is not present in the
-     * smoke-test environment. The real stack health is verified by the
-     * subsequent `kubectl wait deployment --all` and `curl /health` steps.
-     */
-    readonly skipDoctor?: boolean;
-    /**
-     * Phase 0.5 (ADR 021): reuse an existing kubeconfig context instead of
-     * provisioning a new k3d cluster. When set, Phase 1.5 (k3d install) and
-     * Phase 2.5 (cluster provision) are skipped. Phase 2.6 pins to this context.
-     * Pair with --substrate=kubernetes. Operator owns lifecycle (teardown not
-     * handled by olam setup).
-     */
-    readonly reuseCluster?: string;
-    /**
-     * DEV-ONLY: mount a local `olam` source checkout into the k3d node at
-     * `/host/olam` so the host-cp deployment's `operator-repo` hostPath
-     * resolves to live source. Regular operators DO NOT set this — the
-     * published image is fully self-contained and degrades gracefully
-     * (`version-status` reports `unknown`, `/api/prs` runs in an empty
-     * cwd). Setting this is strictly for olam maintainers iterating on
-     * host-cp behavior against a running cluster.
-     *
-     * Pair with --substrate=kubernetes. Absolute path required; warning
-     * printed if the path doesn't exist.
-     */
-    readonly hostCpDevPath?: string;
-    /**
-     * Phase 0: skip the substrate picker (operator manages it manually
-     * via olam config set host.substrate). For non-interactive setups.
-     */
-    readonly skipSubstratePicker?: boolean;
-    /**
-     * --continue: skip Phases 1-7 (assumes initial setup is already complete)
-     * and run ONLY Phase 8 (KG hook) + Phase 9 (memory bridge).
-     *
-     * Use after `olam setup` has run once successfully to add the two optional
-     * integration phases without re-running the full wizard.
-     */
-    readonly continueMode?: boolean;
-    /**
-     * Phase 8: skip KG hook install (operator will run `olam kg install-hook` later).
-     */
-    readonly skipKgHook?: boolean;
-    /**
-     * Phase 9: skip agent memory bridge install (operator will run
-     * `olam memory install` later).
-     */
-    readonly skipMemoryBridge?: boolean;
-    /**
-     * [k3s] Forwarded to `olam bootstrap`: stream all phase output sequentially
-     * instead of collapsing each long phase to a live spinner line.
-     */
-    readonly verbose?: boolean;
-    /**
-     * [k3s] Forwarded to `olam bootstrap`: skip pre-pulling olam-* images into
-     * the k3d node (pods cold-pull on demand).
-     */
-    readonly skipPrepull?: boolean;
-}
-export type SpawnSubprocess = (cmd: string, args: ReadonlyArray<string>) => Promise<{
-    readonly status: number | null;
-}>;
-export type PromptYesNo = (question: string, defaultYes: boolean) => Promise<boolean>;
-export interface RunSetupDeps {
-    readonly dockerExec?: DockerExec;
-    readonly spawnSubprocess?: SpawnSubprocess;
-    readonly prompt?: PromptYesNo;
-    readonly home?: string;
-    readonly cwd?: string;
-    readonly shellEnv?: string | undefined;
-    readonly nodeVersion?: string;
-    readonly olamCliVersion?: string;
-    readonly clock?: () => Date;
-    readonly addSkillSourceFn?: AddSkillSourceFn;
-    readonly cloneSkillSourceFn?: CloneSkillSourceFn;
-    readonly appendTrustAuditFn?: AppendTrustAuditFn;
-    readonly redactUrlFn?: RedactUrlFn;
-    readonly selectPromptFn?: SelectPromptFn;
-    readonly inputPromptFn?: InputPromptFn;
-    /** Injectable listSkillSources — returns existing registered sources (used for auto-detect). */
-    readonly listSkillSourcesFn?: () => readonly import('@olam/core/src/skill-sources/schema.js').SkillSource[];
-    /**
-     * Injectable platform detection.
-     * Default: os.platform(). Inject 'darwin' | 'linux' in tests.
-     */
-    readonly osPlatform?: NodeJS.Platform;
-    /**
-     * Override config path for substrate auto-detection.
-     * Default: ~/.olam/config.json. Inject in tests to pin substrate.
-     */
-    readonly configPath?: string;
-    /**
-     * Injectable kubeconfig context discovery deps (Phase 0.5).
-     * Default: real kubectl-based implementations in k8s-context-discovery.ts.
-     */
-    readonly kubeContextDeps?: KubeContextDeps;
-    /**
-     * Injectable cluster-info probe used when --reuse-cluster=<name> is passed.
-     * Default: defaultClusterInfo from k8s-context-discovery.ts.
-     */
-    readonly kubectlClusterInfo?: (context: string) => KubeContextProbe;
-}
-export interface PhaseResult {
-    readonly ok: boolean;
-    readonly skipped?: boolean;
-    readonly message: string;
-    readonly remedy?: string;
-}
-export interface SetupReport {
-    readonly phases: ReadonlyArray<{
-        name: string;
-        result: PhaseResult;
-    }>;
-    readonly failureAt: number | null;
-    readonly exitCode: number;
-}
-/**
- * Validate the --cluster-name value.
- * Returns an error message when invalid, or null when valid.
- */
-export declare function validateClusterName(name: string): string | null;
-/** Migration hint printed once when an existing docker/compose install is detected. */
-export declare const DOCKER_MIGRATION_HINT: string;
-export declare function phase0SubstratePicker(opts: RunSetupOptions, deps: RunSetupDeps): Promise<PhaseResult>;
-export declare function phase3_5K3dHttpsBootstrap(substrate: SetupSubstrate, opts: RunSetupOptions, _deps: RunSetupDeps): Promise<PhaseResult>;
-export declare function runSetup(opts: RunSetupOptions, deps?: RunSetupDeps): Promise<SetupReport>;
-export declare function registerSetup(program: Command): void;
-//# sourceMappingURL=setup.d.ts.map

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

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