@pipeline-builder/pipeline-manager 0.0.1

package/dist/commands/provision.d.ts

@@ -0,0 +1,122 @@
+import { Command } from 'commander';
+import { type BootstrapSpec } from '../agent/bootstrap.js';
+import { type PostStep, type SkippedStep } from '../agent/post-steps.js';
+import { 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 the new `--init <mode>` flag, falling back to the DEPRECATED
+ * aliases (`--no-init` → skip, `--auto-init` → auto, `--no-auto-init` → manual), then the
+ * default (`auto`). Returns `null` when `--init` was given an invalid value (caller errors).
+ */
+export declare function resolveInitMode(options: {
+    init?: unknown;
+    autoInit?: 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), matching the old inline behavior; 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[];
+}>;
+/**
+ * Registers the `provision` command — an AI-assisted installer for the Pipeline
+ * Builder PLATFORM (local/minikube/EC2/EKS). It prints the assembled plan
+ * (prereq checks, NL-goal parsing, command assembly) and then DEPLOYS, gated by
+ * confirmation prompts (`--yes` to auto-accept; `--json` is the only non-executing
+ * mode, printing the plan for tooling). With `--repo` it can bootstrap a fresh
+ * machine by sparsely cloning only the deploy folders the selected target +
+ * options need, then runs post-install steps (register admin, opt-in loads,
+ * smoke test, custom commands). `--teardown` removes a deployment instead.
+ *
+ * @param program - The root Commander program instance to attach the command to.
+ */
+export declare function provision(program: Command): void;
+//# sourceMappingURL=provision.d.ts.map

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

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