@cat-factory/cli 0.10.4 → 0.11.0

package/dist/k3s-ingress.js

@@ -0,0 +1,372 @@
+import { connect } from 'node:net';
+import { COMMAND_NOT_FOUND, COMMAND_TIMED_OUT, runCommand, } from './host-shell.js';
+/**
+ * Whether an environment URL derived from an ingress HOST TEMPLATE can actually be served, which
+ * takes two independent things and not one:
+ *
+ *   1. an ingress CONTROLLER inside the cluster (an `IngressClass` is its observable trace), and
+ *   2. a HOST PORT published into it, because every local distribution runs the cluster inside
+ *      Docker and forwards only the ports it was asked for at create time.
+ *
+ * Both were previously assumed. `cat-factory k3s` printed `{{branch}}.127.0.0.1.nip.io` as wired
+ * on every path, including a reused cluster it had never looked at, and the failure landed at the
+ * `tester` step against a URL that answered nothing: environment readiness is WORKLOAD readiness,
+ * so provisioning still reported success.
+ */
+/**
+ * Default host port published into the ingress controller's plain-HTTP entrypoint.
+ *
+ * ONE port is published and it maps to the controller's plain-HTTP entrypoint, so `http` is the
+ * scheme that port serves and the only one the CLI can claim. Publishing the TLS entrypoint
+ * instead would trade a connection error for a CERTIFICATE error, because a local ingress
+ * controller serves a self-signed default cert: a worse version of the failure this module exists
+ * to remove, since it surfaces at the tester rather than here.
+ */
+export const DEFAULT_INGRESS_PORT = 80;
+/**
+ * The host the rendered template resolves to. `nip.io` is wildcard DNS that maps
+ * `<anything>.127.0.0.1.nip.io` to loopback with no local DNS setup, so the port probe below
+ * targets loopback directly rather than resolving a sample hostname.
+ */
+export const INGRESS_PROBE_HOST = '127.0.0.1';
+/**
+ * The ingress HOST template, with no port in it. It is deliberately portless: the rendered value
+ * is also the Ingress `spec.rules[].host` a service's manifests declare, and Kubernetes rejects a
+ * `host` carrying a port. A non-default host port travels as the URL source's own `port` field
+ * instead (see {@link ingressUrlPort}).
+ */
+export const INGRESS_HOST_TEMPLATE = '{{branch}}.127.0.0.1.nip.io';
+/** The container port an ingress controller serves plain HTTP on (Traefik `web`, nginx `http`). */
+export const INGRESS_CONTAINER_HTTP_PORT = 80;
+// ---------------------------------------------------------------------------
+// Pure planners + reduction: no shell-out, no sockets, so unit-testable alone.
+// ---------------------------------------------------------------------------
+/** `kubectl get ingressclass -o json`, targeting `context` when one is supplied. */
+export function listIngressClassesCommand(context) {
+    const args = ['get', 'ingressclass', '-o', 'json', '--request-timeout=5s'];
+    return { cmd: 'kubectl', args: context ? [...args, '--context', context] : args };
+}
+/**
+ * `docker port <cluster container>`: every host port the cluster's own container forwards. This is
+ * the ONLY check that attributes an answering host port to the cluster rather than to whatever
+ * else may be bound there, and it is the same one used by hand to establish that a default k3d
+ * create publishes nothing but the apiserver.
+ *
+ * The container is the one each distribution puts the forward on: k3d's load balancer, kind's
+ * control-plane node. The whole table is asked for rather than one port, because a container that
+ * forwards NOTHING answers that with an empty success, where naming the port makes the same
+ * cluster fail exactly as an unknown container does.
+ */
+export function publishedPortsCommand(runtime, clusterName) {
+    const container = runtime === 'k3d' ? `k3d-${clusterName}-serverlb` : `${clusterName}-control-plane`;
+    return { cmd: 'docker', args: ['port', container] };
+}
+/**
+ * Host ports mapped to the ingress container port, out of `docker port` output
+ * (`80/tcp -> 0.0.0.0:18080`, one mapping per line). Reads the text after the LAST colon so an
+ * IPv6 bind address (`[::]:18080`) does not parse as the port.
+ */
+export function parsePublishedHostPorts(stdout) {
+    const ports = new Set();
+    for (const line of stdout.split('\n')) {
+        const [containerPort, hostAddress] = line.split('->').map((part) => part.trim());
+        if (containerPort !== `${INGRESS_CONTAINER_HTTP_PORT}/tcp` || !hostAddress)
+            continue;
+        const port = Number(hostAddress.slice(hostAddress.lastIndexOf(':') + 1));
+        if (Number.isInteger(port) && port > 0)
+            ports.add(port);
+    }
+    return [...ports];
+}
+/**
+ * Controller names out of a `kubectl get ingressclass -o json` payload (an `items` list).
+ * Returns `null` for anything unparseable, which the reduction reports as `unknown` rather than
+ * as an absent controller.
+ */
+export function parseIngressClasses(stdout) {
+    try {
+        const parsed = JSON.parse(stdout);
+        if (!Array.isArray(parsed.items))
+            return null;
+        return parsed.items
+            .map((item) => {
+            const spec = item?.spec;
+            const name = item?.metadata?.name;
+            if (typeof spec?.controller === 'string' && spec.controller.length > 0)
+                return spec.controller;
+            return typeof name === 'string' && name.length > 0 ? name : undefined;
+        })
+            .filter((c) => c !== undefined);
+    }
+    catch {
+        return null;
+    }
+}
+/** How much of a command's own error output a message carries before it stops being readable. */
+const DETAIL_CAP = 300;
+/** The first line of a failure's output, capped, so a message names the cause it was given. */
+function firstDetailLine(result) {
+    const raw = (result.stderr || result.stdout).trim().split('\n')[0]?.trim() ?? '';
+    return raw.length > DETAIL_CAP ? `${raw.slice(0, DETAIL_CAP)}…` : raw;
+}
+/**
+ * Turn the `kubectl get ingressclass` result into a read outcome that NAMES its cause.
+ *
+ * The shell already distinguishes a missing binary from a watchdog kill from a real non-zero
+ * exit, and the exit carries the apiserver's own words (an RBAC refusal, a bad context). Throwing
+ * that away and reporting "could not read the cluster's IngressClasses" is the degrade-quietly
+ * failure: four fixes, one message, and a remedy that fits none of them.
+ */
+export function readIngressClasses(result) {
+    if (result.code === COMMAND_NOT_FOUND) {
+        return {
+            ok: false,
+            cause: 'kubectl-missing',
+            detail: 'kubectl is not installed, or not on PATH',
+        };
+    }
+    if (result.code === COMMAND_TIMED_OUT) {
+        return {
+            ok: false,
+            cause: 'cluster-unreachable',
+            detail: 'the apiserver did not answer before the probe timed out',
+        };
+    }
+    if (result.code !== 0) {
+        return {
+            ok: false,
+            cause: 'cluster-refused',
+            detail: firstDetailLine(result) || `kubectl exited ${result.code}`,
+        };
+    }
+    const controllers = parseIngressClasses(result.stdout);
+    if (controllers === null) {
+        return {
+            ok: false,
+            cause: 'unparseable',
+            detail: 'kubectl answered with something this could not read as an IngressClass list',
+        };
+    }
+    return { ok: true, controllers };
+}
+/**
+ * Reduce the probed facts to one verdict.
+ *
+ * An UNREADABLE cluster is `unknown` outright: with no controller list, neither half is settled.
+ * An EMPTY list is a definitive `missing`, even when the port probe could not tell, because a
+ * cluster with no ingress controller cannot serve the URL whatever the host port does.
+ *
+ * The PUBLICATION check outranks the socket on the port half, in both directions: a runtime that
+ * reports the cluster forwarding no such host port makes an answering socket somebody ELSE'S
+ * listener (the case that used to read as ready), and one that reports the forward makes an
+ * answering socket attributable to the cluster rather than merely coincident with it.
+ */
+export function classifyIngress(facts) {
+    const { port, classes, hostPort, publication } = facts;
+    if (!classes.ok) {
+        return {
+            status: 'unknown',
+            port,
+            cause: classes.cause,
+            probeFailure: classes.detail,
+        };
+    }
+    const published = publication.checked ? publication.hostPorts.includes(port) : undefined;
+    const gaps = [];
+    if (classes.controllers.length === 0)
+        gaps.push('controller');
+    if (hostPort === 'closed' || published === false)
+        gaps.push('hostPort');
+    if (gaps.length > 0) {
+        const elsewhere = publication.checked
+            ? publication.hostPorts.find((p) => p !== port)
+            : undefined;
+        return {
+            status: 'missing',
+            port,
+            gaps,
+            ...(published === false && elsewhere !== undefined ? { publishedOn: elsewhere } : {}),
+        };
+    }
+    if (hostPort === 'unknown') {
+        return {
+            status: 'unknown',
+            port,
+            cause: 'host-port-filtered',
+            probeFailure: `nothing answered on host port ${port} and the probe could not tell whether it is closed or filtered`,
+        };
+    }
+    return {
+        status: 'ready',
+        port,
+        controller: classes.controllers[0] ?? 'unknown',
+        attribution: published === true ? 'cluster' : 'unattributed',
+    };
+}
+/**
+ * The remedy for each gap, rendered from what the probe just read.
+ *
+ * A missing HOST PORT has exactly one fix on every local distribution: neither k3d's `-p` nor
+ * kind's `extraPortMappings` can be added to a cluster that already exists, so the cluster has to
+ * be built again. That is why a recreate is named here rather than a `docker` incantation that
+ * does not work.
+ */
+export function ingressRemedies(readiness, context = {}) {
+    const { runtime, recreateCommand } = context;
+    if (readiness.status === 'ready')
+        return [];
+    if (readiness.status === 'unknown')
+        return [...unknownRemedies(readiness), URL_SOURCE_ALTERNATIVE];
+    const lines = [];
+    if (readiness.gaps.includes('controller')) {
+        lines.push(runtime === 'kind'
+            ? 'kind ships no ingress controller. Install one, e.g. `kubectl apply -f https://kind.sigs.k8s.io/examples/ingress/deploy-ingress-nginx.yaml`, then wait for it to be Ready.'
+            : 'The cluster has no ingress controller. A default k3d/k3s cluster installs Traefik unless it was created with `--disable=traefik`; install an ingress controller, or build the cluster again without that flag.');
+    }
+    if (readiness.gaps.includes('hostPort')) {
+        lines.push(readiness.publishedOn !== undefined
+            ? `The cluster publishes its ingress controller on host port ${readiness.publishedOn}, not ${readiness.port}. Re-run with \`--ingress-port ${readiness.publishedOn}\` to use it as it is.`
+            : `Nothing on the host serves port ${readiness.port} for this cluster. A published host port cannot be added to an existing k3d/kind cluster, so the cluster has to be created again:`);
+        if (readiness.publishedOn === undefined) {
+            lines.push(recreateCommand
+                ? `  ${recreateCommand}`
+                : 'This command can only rebuild a k3d/kind cluster it can name, which this is not, so re-create it with the tool that made it, publishing the host port into the ingress controller.');
+        }
+    }
+    lines.push(URL_SOURCE_ALTERNATIVE);
+    return lines;
+}
+/** The fix that needs no cluster change at all, and therefore applies to every negative verdict. */
+const URL_SOURCE_ALTERNATIVE = 'Or leave ingress alone and switch the connect form\'s "Environment URL source" to "Service status", naming the Service your manifests expose.';
+/** One remedy per {@link IngressProbeCause}, because each cause needs a different thing done. */
+function unknownRemedies(readiness) {
+    const byHand = `Check it by hand: \`kubectl get ingressclass\` and \`curl -sv http://cat-factory-probe.127.0.0.1.nip.io:${readiness.port}/\`.`;
+    switch (readiness.cause) {
+        case 'kubectl-missing':
+            return [
+                'Install `kubectl` (or put it on PATH) and re-run `cat-factory k3s`: without it nothing can read what the cluster runs.',
+            ];
+        case 'cluster-unreachable':
+            return [
+                'The apiserver did not answer. Check the cluster is up and the context points at it (`kubectl cluster-info`), then re-run `cat-factory k3s`.',
+                byHand,
+            ];
+        case 'cluster-refused':
+            return [
+                `The cluster refused the read: ${readiness.probeFailure}. If that is an RBAC refusal, use a context allowed to list ingressclasses; then re-run \`cat-factory k3s\`.`,
+                byHand,
+            ];
+        case 'unparseable':
+            return [`Read it by hand: \`kubectl get ingressclass -o json\`.`];
+        case 'host-port-filtered':
+            return [
+                `Nothing answered on host port ${readiness.port}, and a dropped packet is not a closed port, so this is undecided rather than missing. Check what is bound there (a firewall silently dropping the connection looks the same), then re-run \`cat-factory k3s\`.`,
+                byHand,
+            ];
+        default:
+            return refuseUnknownCause(readiness.cause);
+    }
+}
+/**
+ * A cause outside {@link IngressProbeCause}. The `never` parameter keeps the switch above total at
+ * COMPILE time (a new cause with no remedy stops building) while still refusing a value the union
+ * never had, rather than falling off the end and rendering an empty remedy list.
+ */
+function refuseUnknownCause(cause) {
+    throw new Error(`Unhandled ingress probe cause '${String(cause)}'`);
+}
+export function ingressHostTemplate(readiness) {
+    return readiness.status === 'ready' ? INGRESS_HOST_TEMPLATE : null;
+}
+/**
+ * The `port` an `ingressTemplate` URL source should carry: the verified host port when it is not
+ * the scheme's default, else `null` (the derivation composes `scheme://host` with no port).
+ */
+export function ingressUrlPort(readiness) {
+    if (readiness.status !== 'ready')
+        return null;
+    return readiness.port === DEFAULT_INGRESS_PORT ? null : readiness.port;
+}
+/**
+ * The real, socket-backed probe.
+ *
+ * `ECONNREFUSED` is the one error that settles the negative: something answered the SYN with a
+ * reset, so nothing is listening. A timeout or any other error leaves it undecided (a firewall
+ * drops packets silently), and the reduction above keeps that distinct.
+ */
+export function createNodeTcpProbe() {
+    return {
+        probe(host, port, timeoutMs) {
+            return new Promise((resolve) => {
+                let settled = false;
+                const finish = (state) => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    socket.destroy();
+                    resolve(state);
+                };
+                const socket = connect({ host, port });
+                socket.setTimeout(timeoutMs);
+                socket.on('connect', () => finish('open'));
+                socket.on('timeout', () => finish('unknown'));
+                socket.on('error', (err) => finish(err.code === 'ECONNREFUSED' ? 'closed' : 'unknown'));
+            });
+        },
+    };
+}
+/** How long a freshly created cluster is given to bring its bundled controller up. */
+export const INGRESS_SETTLE_WAIT_MS = 90_000;
+const ATTEMPT_INTERVAL_MS = 2_000;
+const PORT_PROBE_TIMEOUT_MS = 2_000;
+const realSleep = (ms) => new Promise((r) => setTimeout(r, ms));
+/**
+ * Probe every half and reduce, retrying while `waitMs` of WALL CLOCK remains.
+ *
+ * The wait exists because a k3d cluster's bundled Traefik is installed by a Job that completes
+ * ~20-30s AFTER `k3d cluster create` returns: probing once, immediately, would report a
+ * definitive `missing` for a cluster that is merely still starting, which is the same class of
+ * lie as the promise this replaces. A settled cluster answers on the first attempt, so the wait
+ * costs nothing on the reuse path, where callers pass 0.
+ *
+ * The budget covers the attempts as well as the gaps between them, so a run whose every probe is
+ * slow gives up on time rather than multiplying the deadline by the cost of an attempt.
+ */
+export async function probeIngress(deps, options) {
+    const sleep = deps.sleep ?? realSleep;
+    const now = deps.now ?? Date.now;
+    const deadline = now() + (options.waitMs ?? 0);
+    for (;;) {
+        const [classes, hostPort, publication] = await Promise.all([
+            runCommand(deps.shell, listIngressClassesCommand(options.context)),
+            deps.tcp.probe(INGRESS_PROBE_HOST, options.port, PORT_PROBE_TIMEOUT_MS),
+            readPortPublication(deps.shell, options.cluster),
+        ]);
+        const last = classifyIngress({
+            port: options.port,
+            classes: readIngressClasses(classes),
+            hostPort,
+            publication,
+        });
+        if (last.status === 'ready' || now() + ATTEMPT_INTERVAL_MS > deadline)
+            return last;
+        await sleep(ATTEMPT_INTERVAL_MS);
+    }
+}
+/**
+ * Ask the container runtime which host ports the cluster forwards its controller entrypoint to.
+ *
+ * Any failure is `checked: false`, never "publishes nothing": the container may be named
+ * differently (a `--no-lb` k3d cluster has no load balancer at all), Docker may not be the
+ * runtime, or there may be no Docker. Reading a failure as a definitive negative would send an
+ * operator to rebuild a cluster whose port was fine.
+ */
+async function readPortPublication(shell, cluster) {
+    if (!cluster)
+        return { checked: false };
+    const result = await runCommand(shell, publishedPortsCommand(cluster.runtime, cluster.clusterName));
+    if (result.code !== 0)
+        return { checked: false };
+    return { checked: true, hostPorts: parsePublishedHostPorts(result.stdout) };
+}
+//# sourceMappingURL=k3s-ingress.js.map

package/dist/k3s-ingress.js.map

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

package/dist/k3s-probe.d.ts

@@ -28,7 +28,42 @@ export interface HostDetections {
     kindClusters: string[];
 }
 /** The setup paths the probe can offer. */
-export type OfferId = 'use-existing' | 'create-k3d' | 'create-kind' | 'install-k3s';
+export type OfferId = 'use-existing' | 'create-k3d' | 'create-kind' | 'recreate-k3d' | 'recreate-kind' | 'install-k3s';
+/**
+ * The DESTRUCTIVE offers, keyed by the runtime each one rebuilds. This is the ONE definition of
+ * the recreate set: {@link recreateOfferFor} resolves `--recreate`'s target from it and
+ * {@link isRecreateOffer} recognises one, so a `K3sRuntime` with no entry cannot be folded into a
+ * neighbour's branch by a two-way ternary.
+ *
+ * `k3s` has no entry deliberately: it is a HOST SERVICE (a systemd unit installed by `curl | sh`,
+ * which this CLI only ever prints), so there is no cluster for the CLI to delete and build again.
+ */
+export declare const RECREATE_OFFERS: {
+    readonly k3d: 'recreate-k3d';
+    readonly kind: 'recreate-kind';
+};
+/** A runtime `--recreate` can target: one with an entry in {@link RECREATE_OFFERS}. */
+export type RecreatableRuntime = keyof typeof RECREATE_OFFERS;
+export type RecreateOfferId = (typeof RECREATE_OFFERS)[RecreatableRuntime];
+/** The recreate offer for a runtime, or `null` when that runtime has no recreate at all. */
+export declare function recreateOfferFor(runtime: K3sRuntime): RecreateOfferId | null;
+/** Whether an offer is one of the destructive ones. */
+export declare function isRecreateOffer(id: OfferId): id is RecreateOfferId;
+/**
+ * The k3d/kind cluster a REUSED kubeconfig context names, when the CLI can both name it and build
+ * it again. `null` for anything else (a bare k3s host service, a shared cluster, a context whose
+ * cluster the runtime no longer reports).
+ *
+ * This exists because a remedy has to be a command that WORKS. `--recreate`'s target rule is
+ * exactly "a k3d/kind cluster this command can name", and on the reuse path nothing else knows
+ * which cluster that is: the offer was `use-existing`, so no name was passed. Without this, the
+ * missing-host-port remedy printed `cat-factory k3s --recreate` against the DEFAULT name, which
+ * `chooseOffer` then refused for any cluster not called `cat-factory`.
+ */
+export declare function recreateTargetForContext(d: HostDetections): {
+    runtime: RecreatableRuntime;
+    clusterName: string;
+} | null;
 /** One offered setup path, with whether it's currently possible + why not. */
 export interface Offer {
     id: OfferId;
@@ -51,7 +86,7 @@ export interface HostState {
  * `install-k3s` offer's copy — k3s is Linux-only, so on Windows/macOS that path points at
  * k3s-in-Docker via k3d instead of a `curl | sh` install that can't run there.
  */
-export declare function classifyHost(d: HostDetections, preferred?: K3sRuntime, platform?: NodeJS.Platform): HostState;
+export declare function classifyHost(d: HostDetections, preferred?: K3sRuntime, platform?: NodeJS.Platform, clusterName?: string): HostState;
 /** Parse `k3d cluster list --output json` (an array of `{ name }`) into cluster names. */
 export declare function parseK3dClusters(stdout: string): string[];
 /** Parse `kind get clusters` (newline-separated names; a "No kind clusters" note ⇒ empty). */
@@ -74,5 +109,5 @@ export declare function hasServerVersion(stdout: string): boolean;
  * `--request-timeout` — a kubeconfig pointing at a down cluster then fails fast instead of hanging
  * the probe (the {@link HostShell} watchdog is the outer backstop).
  */
-export declare function probeHost(shell: HostShell, preferred?: K3sRuntime, platform?: NodeJS.Platform): Promise<HostState>;
+export declare function probeHost(shell: HostShell, preferred?: K3sRuntime, platform?: NodeJS.Platform, clusterName?: string): Promise<HostState>;
 //# sourceMappingURL=k3s-probe.d.ts.map

package/dist/k3s-probe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"k3s-probe.d.ts","sourceRoot":"","sources":["../src/k3s-probe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEnE,wFAAwF;AACxF,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,aAAa,CAAA;IACtB,GAAG,EAAE,aAAa,CAAA;IAClB,IAAI,EAAE,aAAa,CAAA;IACnB,GAAG,EAAE,aAAa,CAAA;IAClB,MAAM,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAA;IAChD,gGAAgG;IAChG,gBAAgB,EAAE,OAAO,CAAA;IACzB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,uDAAuD;IACvD,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,wDAAwD;IACxD,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,2CAA2C;AAC3C,MAAM,MAAM,OAAO,GAAG,cAAc,GAAG,YAAY,GAAG,aAAa,GAAG,aAAa,CAAA;AAEnF,8EAA8E;AAC9E,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,OAAO,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,OAAO,CAAA;IAClB,WAAW,EAAE,OAAO,CAAA;IACpB,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,mGAAmG;AACnG,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,cAAc,CAAA;IAC1B,MAAM,EAAE,KAAK,EAAE,CAAA;IACf,WAAW,EAAE,OAAO,CAAA;CACrB;AAmBD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,CAAC,EAAE,cAAc,EACjB,SAAS,GAAE,UAAkB,EAC7B,QAAQ,GAAE,MAAM,CAAC,QAAkB,GAClC,SAAS,CA0DX;AAgBD,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAYzD;AAED,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAK1D;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQ5E;AAED,8FAA8F;AAC9F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAOxD;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,SAAS,EAChB,SAAS,GAAE,UAAkB,EAC7B,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,OAAO,CAAC,SAAS,CAAC,CA0CpB"}
+{"version":3,"file":"k3s-probe.d.ts","sourceRoot":"","sources":["../src/k3s-probe.ts"],"names":[],"mappings":"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"}

package/dist/k3s-probe.js

@@ -1,9 +1,66 @@
-import {} from './args.js';
+import { OPTION_DEFAULTS } from './args.js';
 import { COMMAND_NOT_FOUND } from './host-shell.js';
+/** The cluster name the recreate offers key off when `--cluster-name` was not supplied. */
+const DEFAULT_CLUSTER_NAME = OPTION_DEFAULTS.k3sClusterName;
+/**
+ * The DESTRUCTIVE offers, keyed by the runtime each one rebuilds. This is the ONE definition of
+ * the recreate set: {@link recreateOfferFor} resolves `--recreate`'s target from it and
+ * {@link isRecreateOffer} recognises one, so a `K3sRuntime` with no entry cannot be folded into a
+ * neighbour's branch by a two-way ternary.
+ *
+ * `k3s` has no entry deliberately: it is a HOST SERVICE (a systemd unit installed by `curl | sh`,
+ * which this CLI only ever prints), so there is no cluster for the CLI to delete and build again.
+ */
+export const RECREATE_OFFERS = {
+    k3d: 'recreate-k3d',
+    kind: 'recreate-kind',
+};
+/** The recreate offer for a runtime, or `null` when that runtime has no recreate at all. */
+export function recreateOfferFor(runtime) {
+    return runtime in RECREATE_OFFERS ? RECREATE_OFFERS[runtime] : null;
+}
+/** Whether an offer is one of the destructive ones. */
+export function isRecreateOffer(id) {
+    return Object.values(RECREATE_OFFERS).includes(id);
+}
+/** kubeconfig context prefixes k3d/kind assign, paired with the runtime that owns them. */
+const CONTEXT_RUNTIMES = [
+    ['k3d-', 'k3d'],
+    ['kind-', 'kind'],
+];
+/**
+ * The k3d/kind cluster a REUSED kubeconfig context names, when the CLI can both name it and build
+ * it again. `null` for anything else (a bare k3s host service, a shared cluster, a context whose
+ * cluster the runtime no longer reports).
+ *
+ * This exists because a remedy has to be a command that WORKS. `--recreate`'s target rule is
+ * exactly "a k3d/kind cluster this command can name", and on the reuse path nothing else knows
+ * which cluster that is: the offer was `use-existing`, so no name was passed. Without this, the
+ * missing-host-port remedy printed `cat-factory k3s --recreate` against the DEFAULT name, which
+ * `chooseOffer` then refused for any cluster not called `cat-factory`.
+ */
+export function recreateTargetForContext(d) {
+    const context = d.clusterContext;
+    if (!context)
+        return null;
+    for (const [prefix, runtime] of CONTEXT_RUNTIMES) {
+        if (!context.startsWith(prefix))
+            continue;
+        const clusterName = context.slice(prefix.length);
+        const known = runtime === 'kind' ? d.kindClusters : d.k3dClusters;
+        if (clusterName.length > 0 && known.includes(clusterName))
+            return { runtime, clusterName };
+    }
+    return null;
+}
 /**
  * Priority order for picking the recommendation, given the user's preferred runtime. A live cluster
  * always wins; otherwise the preferred distribution's create/install path is tried first, then the
  * others as fallbacks. Every list ends with `install-k3s`, which is always available.
+ *
+ * The `recreate-*` offers appear in NO list, deliberately: they destroy a cluster, and a
+ * recommendation is what `--yes` follows when nobody is watching. They are reachable only by an
+ * explicit `--recreate` or an interactive pick, so the destructive intent is always stated.
  */
 function offerPriority(preferred) {
     switch (preferred) {
@@ -23,7 +80,7 @@ function offerPriority(preferred) {
  * `install-k3s` offer's copy — k3s is Linux-only, so on Windows/macOS that path points at
  * k3s-in-Docker via k3d instead of a `curl | sh` install that can't run there.
  */
-export function classifyHost(d, preferred = 'k3d', platform = 'linux') {
+export function classifyHost(d, preferred = 'k3d', platform = 'linux', clusterName = DEFAULT_CLUSTER_NAME) {
     const useExisting = {
         id: 'use-existing',
         label: d.clusterContext
@@ -67,7 +124,38 @@ export function classifyHost(d, preferred = 'k3d', platform = 'linux') {
         available: true,
         recommended: false,
     };
-    const offers = [useExisting, createK3d, createKind, installK3s];
+    // Recreating is a first-class operation rather than the remedy for any one condition: these
+    // clusters are transient and the reasons to want a fresh one are open-ended (wedged, created by
+    // hand with the wrong flags, a version bump, a pile of leftover namespaces, or no stated reason
+    // at all). What does NOT open up is the TARGET, and that is a safety boundary: it is offered
+    // only for a cluster this CLI can both NAME and build again, which is why there is no recreate
+    // for `use-existing` (that fires for any reachable kubeconfig, including a shared cluster, and
+    // there is no recipe for re-creating "whatever this context points at").
+    const recreate = (runtime) => {
+        const id = RECREATE_OFFERS[runtime];
+        const tooling = runtime === 'kind' ? d.kind : d.k3d;
+        const clusters = runtime === 'kind' ? d.kindClusters : d.k3dClusters;
+        const known = clusters.includes(clusterName);
+        return {
+            id,
+            label: `Recreate the ${runtime} cluster "${clusterName}" (DESTROYS it and everything on it)`,
+            available: d.docker.running && tooling.installed && known,
+            recommended: false,
+            reason: dockerReason ??
+                (!tooling.installed
+                    ? `${runtime} is not installed`
+                    : !known
+                        ? `no ${runtime} cluster named "${clusterName}" exists`
+                        : undefined),
+        };
+    };
+    const offers = [
+        useExisting,
+        createK3d,
+        createKind,
+        ...Object.keys(RECREATE_OFFERS).map(recreate),
+        installK3s,
+    ];
     const recommended = offerPriority(preferred).find((id) => offers.find((o) => o.id === id)?.available) ??
         'install-k3s';
     for (const o of offers)
@@ -142,7 +230,7 @@ export function hasServerVersion(stdout) {
  * `--request-timeout` — a kubeconfig pointing at a down cluster then fails fast instead of hanging
  * the probe (the {@link HostShell} watchdog is the outer backstop).
  */
-export async function probeHost(shell, preferred = 'k3d', platform = process.platform) {
+export async function probeHost(shell, preferred = 'k3d', platform = process.platform, clusterName = DEFAULT_CLUSTER_NAME) {
     const [kubectlVersion, kubectlContext, k3dVersion, k3dList, kindVersion, kindList, k3sVersion, dockerVersion,] = await Promise.all([
         shell.run('kubectl', ['version', '--output=json', '--request-timeout=3s']),
         shell.run('kubectl', ['config', 'current-context']),
@@ -171,6 +259,6 @@ export async function probeHost(shell, preferred = 'k3d', platform = process.pla
         k3dClusters: k3dList.code === 0 ? parseK3dClusters(k3dList.stdout) : [],
         kindClusters: kindList.code === 0 ? parseKindClusters(kindList.stdout) : [],
     };
-    return classifyHost(detections, preferred, platform);
+    return classifyHost(detections, preferred, platform, clusterName);
 }
 //# sourceMappingURL=k3s-probe.js.map

package/dist/k3s-probe.js.map

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