@pipeline-builder/pipeline-manager 4.1.23 → 4.1.25

package/dist/commands/provision.d.ts

@@ -1,149 +1,12 @@
-import { Command } from 'commander';
-import { type AiOptions } from '../agent/ai.js';
-import { type BootstrapSpec } from '../agent/bootstrap.js';
-import { type PostStep, type SkippedStep } from '../agent/post-steps.js';
-import { type PrereqCheck } from '../agent/prereqs.js';
-import { type AssembleResult, type TargetId, type TargetSpec } from '../agent/targets.js';
-/**
- * Post-deploy initialization mode (the single `--init <mode>` flag):
- *   - `auto`   — init-platform runs once the platform is up (register admin + load plugins/
- *                compliance/samples). On ec2 the instance does it itself on first boot; on
- *                local/minikube/eks `provision` runs it for you. This is the DEFAULT.
- *   - `manual` — don't self-init; surface the exact step for you to run yourself.
- *   - `skip`   — don't initialize at all (no register, no loads).
- */
-export type InitMode = 'auto' | 'manual' | 'skip';
-/**
- * Resolve the init mode from `--init <mode>`, defaulting to `auto` when the flag is absent.
- * Returns `null` when `--init` was given an invalid value (caller errors).
- */
-export declare function resolveInitMode(options: {
-    init?: unknown;
-}): InitMode | null;
-/**
- * Host-port pre-flight (local/minikube). Ports are DERIVED from the target's cloned
- * deploy source (compose / setup.sh) so the list can't drift — hence this runs AFTER
- * the clone. A taken port makes a container/forward fail to bind mid-deploy (for the
- * gateway, a silent unreachable hang). Prints a ✓/✗ summary and returns false ONLY
- * when the caller must ABORT (a fatal local conflict). minikube ports are managed
- * forwards (setup.sh pkills/restarts them), so a conflict there warns but proceeds.
- * Remote targets (ec2/eks) bind nothing locally → returns true.
- */
-export declare function preflightPorts(spec: TargetSpec, target: TargetId, cwd: string): Promise<boolean>;
-/**
- * Teardown mode — the destroy counterpart of provisioning, gated HARDER than deploy:
- * AWS targets are irreversible, so the operator must TYPE the target id (--force
- * bypasses for CI; --yes alone does NOT). Terminal: owns its output + exitCode.
- */
-export declare function runTeardown(spec: TargetSpec, target: TargetId, cwd: string, executionId: string, opts: {
-    stackName?: string;
-    clusterName?: string;
-    region?: string;
-    domain?: string;
-    hostedZoneId?: string;
-    force?: boolean;
-    yes?: boolean;
-    json?: boolean;
-}): Promise<void>;
-/**
- * Run the deploy command (real, secrets unmasked, streamed + captured) with a
- * bounded auto-fix + retry loop — the deploy scripts are idempotent, so a fixed
- * re-run resumes rather than starting over. Returns whether it succeeded plus the
- * (possibly fix-adjusted) params, which the caller needs for SES guidance.
- */
-export declare function runDeployWithRetry(spec: TargetSpec, url: string | null, cwd: string, params: Record<string, unknown>, aiOpts: {
-    provider?: string;
-    model?: string;
-}, opts: {
-    retries?: string;
-    yes?: boolean;
-}): Promise<{
-    succeeded: boolean;
-    runParams: Record<string, unknown>;
-}>;
-/**
- * Execute the post-install steps (register → loads → smoke → events → custom). On
- * EC2/EKS the register step + the events bundle (store-token → setup-events) are
- * SURFACED as ordered manual next-steps instead of auto-run: ec2 register must run
- * ON the box (the minikube user owns the cluster), and the events bundle needs a
- * registered platform + AWS creds. (eks register itself port-forwards, so it runs
- * from anywhere with kubectl access.) Sets exitCode on a step failure.
- */
-export declare function runPostSteps(postSteps: PostStep[], skippedSteps: SkippedStep[], target: TargetId, cwd: string, adminEnv: Record<string, string>, opts: {
-    yes?: boolean;
-    autoRun?: boolean;
-    autoInit?: boolean;
-}): Promise<void>;
 /**
- * Sparse-clone the platform repo (when --repo, or accepted via the interactive
- * offer), repoint cwd into it, and verify the deploy entrypoint exists. Owns the
- * cwd/bootstrapped state. Sets exitCode on a hard failure (clone error / missing
- * entrypoint); a plain decline leaves exitCode
- * untouched. Returns ok:false when the caller must abort.
- */
-export declare function bootstrapAndLocate(spec: TargetSpec, bootstrap: BootstrapSpec, bootstrapCmd: string | null, sparsePaths: readonly string[], startCwd: string, opts: {
-    yes?: boolean;
-}): Promise<{
-    cwd: string;
-    bootstrapped: boolean;
-    ok: boolean;
-}>;
-/**
- * Interactive opt-in loads, offered AFTER the clone (so we only ask once the operator
- * has agreed to proceed). Prompts per load, additively sparse-fetches the picked
- * folders into a bootstrapped sparse clone, then re-resolves the post-install steps
- * with the selections. Returns the chosen ids + the recomputed steps.
- */
-export declare function resolveLoadsInteractively(target: TargetId, url: string | null, region: string | undefined, cwd: string, bootstrapped: boolean, bootstrap: BootstrapSpec, postStepFlags: {
-    init: boolean;
-    autoInit: boolean;
-    buildBootstrap: boolean;
-    smokeTest: boolean;
-    events: boolean;
-    steps: string[];
-}): Promise<{
-    enabledLoadIds: string[];
-    steps: PostStep[];
-    skipped: SkippedStep[];
-}>;
-/**
- * Assemble deploy params from explicit flags (flags always win over the NL
- * parse, which only fills gaps).
- */
-export declare function buildParams(options: Record<string, unknown>, selfInit: boolean): Record<string, unknown>;
-/**
- * `--diagnose <file>`: explain a deploy failure with the configured model. A
- * read-only inspection mode — the caller returns afterwards whether or not a
- * target was given, so it never falls through into a (possibly --yes) deploy.
- */
-export declare function runDiagnose(file: string, json: boolean, aiOpts: AiOptions, executionId: string): Promise<void>;
-/** Print the provision plan (shown before the gated execution). */
-export declare function printPlan(p: {
-    spec: TargetSpec;
-    target: TargetId;
-    prereqs: PrereqCheck[];
-    missing: AssembleResult['missing'];
-    bootstrap: BootstrapSpec;
-    bootstrapCmd: string | null;
-    sparsePaths: string[];
-    command: string;
-    postSteps: PostStep[];
-    skippedSteps: SkippedStep[];
-}): void;
-/**
- * local/minikube's setup.sh REQUIRES a `.env` and aborts without it — create
- * it from .env.example with generated secrets so the deploy is non-interactive.
- * ec2 and eks don't need a local `.env`: ec2 bootstraps its secrets on the
- * instance, and eks's setup.sh creates the k8s secrets itself.
- */
-export declare function ensureLocalEnvFile(target: TargetId, spec: TargetSpec, cwd: string, yes: boolean): Promise<void>;
-/**
- * Any missing required prereq that's a single static binary (e.g. yq) can be
- * fetched into the tools cache instead of a system install — no brew/apt.
- * Offer it, then re-check (the cache dir is already on PATH). Returns the
- * (possibly refreshed) prereq list.
+ * The `provision` command: its ~40-option table, and the sequencing narrative
+ * that runs a provision end to end.
+ *
+ * The phases themselves live in `./provision-steps.ts` — one exported function
+ * each — so this file can be read as what it is: which flags exist, and in what
+ * order the steps run behind which gates.
  */
-export declare function offerToolFetch(prereqs: PrereqCheck[], yes: boolean, recheck: () => PrereqCheck[]): Promise<PrereqCheck[]>;
+import { Command } from 'commander';
 /**
  * Registers the `provision` command — an AI-assisted installer for the Pipeline
  * Builder PLATFORM (local/minikube/EC2/EKS). It prints the assembled plan

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

@@ -1 +1 @@
-{"version":3,"file":"provision.d.ts","sourceRoot":"","sources":["../../src/commands/provision.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"provision.d.ts","sourceRoot":"","sources":["../../src/commands/provision.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6CpC;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2ShD"}