@intentius/chant 0.124.43 → 0.124.45

package/dist/components/pr-env-run.js

@@ -0,0 +1,440 @@
+/**
+ * Running a pull request's environment (#4330): `up`, `down` and `sweep` as
+ * functions over an adapter, so a product that plans and applies with a tool
+ * chant does not run (terragucci, with Terraform roots under suffixed state
+ * keys) keeps its own plan, apply and teardown and takes the rest from chant:
+ *
+ * - the gate: a non-empty plan applies only once a person's approval of its
+ *   digest stands under gate `pr-env` (ws-080, ws-104), and an empty one
+ *   applies at once;
+ * - the records on chant/lifecycle (`_pr-envs/records.jsonl`), the TTL and
+ *   which environments stand ({@link livePrEnvironments});
+ * - the ownership check on teardown ({@link teardownRefusal}), and the
+ *   marker check on every candidate before anything is deleted
+ *   ({@link tearDownPrEnvironment});
+ * - the sweep over expired and closed pull requests;
+ * - the report and the note ({@link renderPrEnvNote}).
+ *
+ * `chant components pr-env` (../cli/handlers/pr-env.ts) runs these with the
+ * components adapter and the lexicons' teardown. The ports default to
+ * chant/lifecycle in the working directory and the gate ledger there
+ * ({@link lifecyclePrEnvPorts}).
+ */
+import { spawnSync } from "node:child_process";
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { withoutForgeTokens } from "../ci-handover.js";
+import { PR_ENV_EXIT, PR_ENV_GATE, PR_ENV_LEDGER_DIR, PR_ENV_LEDGER_FILE, expired, livePrEnvironments, parsePrEnvRecords, prEnvNoteMarker, prEnvStatusContext, prEnvStatusDescription, prEnvStatusState, prEnvironmentName, renderPrEnvNote, teardownComplete, teardownCounts, tearDownPrEnvironment, ttlMs, } from "./pr-environment.js";
+/** The op a pull request's gate is recorded under, as `prOp` in ../pr-loop.ts names it. */
+export function prEnvOp(pr, member) {
+    return member ? `pr-${pr}-${member}` : `pr-${pr}`;
+}
+/** The approve command an adapter's caller prints, the same the note shows. */
+export { prEnvApproveCommand } from "./pr-environment.js";
+const ttlOf = (ttl) => (ttl ? ttlMs(ttl) : undefined) ?? ttlMs("72h");
+/**
+ * Plan pull request `pr`'s environment through the adapter and apply it once
+ * the plan is empty or an approval of its digest stands under gate `pr-env`.
+ * An apply that failed part way is kept as live too, so what applied is torn
+ * down with the rest.
+ */
+export async function prEnvUp(input) {
+    const { pr, ports } = input;
+    const env = prEnvironmentName(pr);
+    const target = {
+        pr,
+        env,
+        template: input.template,
+        marker: { stack: input.stack, env },
+        head: input.head,
+        ...(input.member ? { member: input.member } : {}),
+        op: prEnvOp(pr, input.member),
+        ...(input.endpoint ? { endpoint: input.endpoint } : {}),
+    };
+    const base = {
+        stage: "up",
+        pr,
+        env,
+        ...(input.member ? { member: input.member } : {}),
+        template: input.template,
+        head: input.head,
+        op: target.op,
+        gate: PR_ENV_GATE,
+        digest: "",
+        status: "nothing",
+        ...(input.endpoint ? { endpoint: input.endpoint } : {}),
+        components: [],
+    };
+    const settle = async (report, exit, record) => {
+        await ports.publish?.(report);
+        return { exit, report, ...(record ? { record } : {}) };
+    };
+    let planned;
+    try {
+        planned = await input.adapter.plan(target);
+    }
+    catch (err) {
+        return settle({ ...base, status: "plan-failed", message: messageOf(err) }, PR_ENV_EXIT.failed);
+    }
+    if (planned.rows.length === 0) {
+        ports.log?.(`pr-env up: nothing this change touches is deployed, so ${env} gets nothing`);
+        return settle({ ...base, ...(planned.message ? { message: planned.message } : {}) }, PR_ENV_EXIT.done);
+    }
+    const digest = planned.digest;
+    if (planned.failed) {
+        return settle({ ...base, digest, status: "plan-failed", ...(planned.message ? { message: planned.message } : {}), components: planned.rows }, PR_ENV_EXIT.failed);
+    }
+    // ws-080, ws-104: a non-empty plan applies only under a person's approval of its digest. An empty one passes.
+    let approvedBy;
+    if (!planned.empty) {
+        let approval;
+        try {
+            approval = await ports.decideGate({ op: target.op, gate: PR_ENV_GATE, digest, description: `${env}: ${planned.rows.map((r) => r.component).join(", ")}` });
+        }
+        catch (err) {
+            return settle({ ...base, digest, status: "failed", message: `could not read the gate ledger, so ${env} does not apply: ${messageOf(err)}`, components: planned.rows }, PR_ENV_EXIT.failed);
+        }
+        if (approval.status !== "approved") {
+            ports.log?.(`pr-env up: ${env} waits for an approval of ${digest}`);
+            return settle({ ...base, digest, status: approval.status === "changed" ? "changed" : "waiting", components: planned.rows }, PR_ENV_EXIT.waiting);
+        }
+        approvedBy = approval.approvedBy ?? [];
+    }
+    let applied;
+    try {
+        applied = await input.adapter.apply(target, { planned, ...(approvedBy ? { approvedBy } : {}) });
+    }
+    catch (err) {
+        applied = { status: "failed", rows: planned.rows, message: messageOf(err) };
+    }
+    if (applied.status === "stopped") {
+        return settle({ ...base, digest, status: "failed", components: applied.rows, ...(approvedBy ? { approvedBy } : {}), ...(applied.message ? { message: applied.message } : {}) }, PR_ENV_EXIT.failed);
+    }
+    const ok = applied.status === "applied";
+    const now = (input.now ?? (() => new Date()))();
+    const expiresAt = new Date(now.getTime() + ttlOf(input.ttl)).toISOString();
+    const record = {
+        version: 1,
+        kind: "up",
+        pr,
+        env,
+        ...(input.member ? { member: input.member } : {}),
+        template: input.template,
+        marker: { ...target.marker },
+        commit: input.head,
+        components: planned.rows.map((r) => r.component),
+        ...(applied.locations && Object.keys(applied.locations).length > 0 ? { locations: { ...applied.locations } } : {}),
+        planDigest: digest,
+        result: ok ? "applied" : "failed",
+        by: input.actor ?? "chant",
+        timestamp: now.toISOString(),
+        expiresAt,
+        ...(approvedBy ? { approvedBy } : {}),
+        releaseTarget: false,
+        ...(input.runUrl ? { runUrl: input.runUrl } : {}),
+    };
+    // A copy that failed part way is live too: what applied is torn down on close or at expiry like the rest.
+    await ports.appendRecord(record);
+    const message = ok
+        ? applied.afterFailure ?? applied.message
+        : applied.message ?? (applied.status === "waiting" ? "A component read an upstream output that moved when it applied; run the job again to plan it against the new value." : "A component failed to apply; what applied stays in the environment and is torn down with it.");
+    ports.log?.(`pr-env up: ${env} ${ok ? "applied" : applied.status}; it expires ${expiresAt}`);
+    return settle({ ...base, digest, status: ok ? "applied" : "failed", components: applied.rows, ...(approvedBy ? { approvedBy } : {}), expiresAt, ...(message ? { message } : {}) }, ok && !applied.afterFailure ? PR_ENV_EXIT.done : PR_ENV_EXIT.failed, record);
+}
+/**
+ * Tear down pull request `pr`'s environment: the ownership check first, then
+ * only what carries `{ stack, env: "pr-<n>" }`, through the lexicons and the
+ * adapters. No gate holds it: closing the pull request, or the TTL the base
+ * set, is the decision. A teardown that left something keeps the
+ * environment live for the next sweep.
+ */
+export async function prEnvDown(input) {
+    const { pr, ports, reason } = input;
+    const env = prEnvironmentName(pr);
+    const live = input.live ?? livePrEnvironments(await ports.readRecords()).get(env);
+    const report = { stage: "down", pr, env, ...(input.member ? { member: input.member } : {}), template: live?.template ?? "", head: "", op: prEnvOp(pr, input.member), gate: PR_ENV_GATE, digest: "", status: "absent", components: [] };
+    if (!live) {
+        ports.log?.(`pr-env down: ${env} has no live record, so there is nothing to tear down`);
+        await ports.publish?.(report);
+        return { exit: PR_ENV_EXIT.done, report };
+    }
+    const torn = await tearDownPrEnvironment({ pr, live, ...(input.config ? { config: input.config } : {}), ...(input.plugins ? { plugins: input.plugins } : {}), ...(input.adapters ? { adapters: input.adapters } : {}), ...(ports.warn ? { warn: ports.warn } : {}) });
+    if ("refusal" in torn) {
+        const refused = { ...report, template: live.template, status: "refused", message: torn.refusal };
+        await ports.publish?.(refused);
+        return { exit: PR_ENV_EXIT.failed, report: refused };
+    }
+    const { report: result, dropped, marker } = torn;
+    const counts = teardownCounts(result);
+    const complete = teardownComplete(result);
+    const now = (input.now ?? (() => new Date()))();
+    const record = {
+        version: 1,
+        kind: "down",
+        pr,
+        env,
+        ...(live.member ? { member: live.member } : {}),
+        template: live.template,
+        marker,
+        commit: input.commit,
+        components: [...new Set(result.outcomes.map((o) => o.lexicon))].sort(),
+        planDigest: "",
+        result: complete ? "destroyed" : "incomplete",
+        by: input.actor ?? "chant",
+        timestamp: now.toISOString(),
+        reason,
+        outcomes: counts,
+        releaseTarget: false,
+        ...(input.runUrl ? { runUrl: input.runUrl } : {}),
+    };
+    await ports.appendRecord(record);
+    const why = [];
+    if (dropped > 0)
+        why.push(`${dropped} candidate${dropped === 1 ? "" : "s"} whose marker was not ${marker.stack}/${env} left alone`);
+    if (result.unimplemented.length > 0)
+        why.push(`no teardown execution in ${result.unimplemented.join(", ")}`);
+    if (result.plan.holes.length > 0)
+        why.push(`${result.plan.holes.length} part${result.plan.holes.length === 1 ? "" : "s"} could not be read`);
+    for (const o of result.outcomes.filter((x) => x.outcome === "failed"))
+        why.push(`${o.lexicon} ${o.name}: ${o.detail ?? "failed"}`);
+    const done = { ...report, template: live.template, status: complete ? "destroyed" : "incomplete", outcomes: counts, ...(why.length > 0 ? { message: why.join("; ") } : {}) };
+    ports.log?.(`pr-env down: ${env} ${complete ? "torn down" : "not wholly torn down; it stays live and the sweep tries again"} (${counts.deleted} deleted, ${counts.failed} failed, ${counts.skipped} skipped)`);
+    await ports.publish?.(done);
+    return { exit: complete ? PR_ENV_EXIT.done : PR_ENV_EXIT.failed, report: done, record };
+}
+/**
+ * Tear down each live environment whose TTL passed, or whose pull request
+ * the forge says is closed or merged. A state that cannot be read leaves the
+ * TTL to decide. Exits 1 when any teardown did not finish.
+ */
+export async function prEnvSweep(input) {
+    const { ports } = input;
+    const live = [...livePrEnvironments(await ports.readRecords()).values()].filter((e) => input.member === undefined || e.member === input.member);
+    if (live.length === 0) {
+        ports.log?.("pr-env sweep: no pull request environment is live");
+        return { exit: PR_ENV_EXIT.done, results: [] };
+    }
+    const now = (input.now ?? (() => new Date()))();
+    let exit = PR_ENV_EXIT.done;
+    const results = [];
+    for (const e of live) {
+        let reason = expired(e, now) ? "expired" : undefined;
+        if (!reason && ports.pullRequestState) {
+            try {
+                if ((await ports.pullRequestState(e.pr)) !== "open")
+                    reason = "closed";
+            }
+            catch (err) {
+                ports.warn?.(`could not read whether #${e.pr} is open (${messageOf(err)}); its TTL still holds`);
+            }
+        }
+        if (!reason) {
+            ports.log?.(`pr-env sweep: ${e.env} stays; it expires ${e.expiresAt}`);
+            continue;
+        }
+        const r = await prEnvDown({ ...input, pr: e.pr, reason, live: e, ...(e.member ? { member: e.member } : {}) });
+        results.push(r);
+        if (r.exit !== PR_ENV_EXIT.done)
+            exit = PR_ENV_EXIT.failed;
+    }
+    return { exit, results };
+}
+// ── the ports chant itself uses ────────────────────────────────────────────
+/**
+ * The note and the `chant/pr-env` status on the forge. A refusal from the
+ * forge warns and never fails the run.
+ */
+export function forgePrEnvPublisher(forge, warn = () => { }) {
+    return async (report) => {
+        const { forgePrincipalOf } = await import("../pr-forge.js");
+        const note = renderPrEnvNote(report, forgePrincipalOf(forge.kind, forge.host, "<your-login>"));
+        if (report.head) {
+            try {
+                await forge.setStatus(report.head, { context: prEnvStatusContext(report.member), state: prEnvStatusState(report), description: prEnvStatusDescription(report), ...(forge.runUrl ? { url: forge.runUrl } : {}) });
+            }
+            catch (err) {
+                warn(`could not set the ${prEnvStatusContext(report.member)} status: ${messageOf(err)}`);
+            }
+        }
+        try {
+            await forge.upsertNote(report.pr, prEnvNoteMarker(report.env, report.member), note);
+        }
+        catch (err) {
+            warn(`could not post the note on #${report.pr}: ${messageOf(err)}`);
+        }
+    };
+}
+/**
+ * The ports over chant/lifecycle in `cwd` (default the working directory):
+ * the records at `_pr-envs/records.jsonl`, appended and pushed, and the gate
+ * ledger read without writing a pending fact. With `forge`, the note and
+ * status are posted and the sweep asks it whether a pull request is open.
+ */
+export function lifecyclePrEnvPorts(opts = {}) {
+    const at = opts.cwd ? { cwd: opts.cwd } : undefined;
+    const warn = opts.warn ?? (() => { });
+    const forge = opts.forge;
+    return {
+        async readRecords() {
+            const { fetchLifecycle, readBlobFromPath } = await import("../lifecycle/git.js");
+            await fetchLifecycle(at).catch(() => false);
+            return parsePrEnvRecords(await readBlobFromPath(PR_ENV_LEDGER_DIR, PR_ENV_LEDGER_FILE, at));
+        },
+        async appendRecord(record) {
+            const { appendLedgerLine, fetchLifecycle, pushLifecycleReport } = await import("../lifecycle/git.js");
+            try {
+                await fetchLifecycle(at).catch(() => false);
+                await appendLedgerLine(PR_ENV_LEDGER_DIR, PR_ENV_LEDGER_FILE, JSON.stringify(record), `Pull request environment ${record.env} ${record.kind} (${record.result})`, at);
+                const pushed = await pushLifecycleReport(at);
+                if (pushed.pushWarning)
+                    warn(pushed.pushWarning);
+            }
+            catch (err) {
+                warn(`could not record ${record.env}'s ${record.kind} on chant/lifecycle: ${messageOf(err)}`);
+            }
+        },
+        async decideGate(input) {
+            const { approvalOf, decidePrGate, readOnlyLedger } = await import("./pr-run.js");
+            const { gitGateLedgerPort } = await import("../op/gate.js");
+            const approval = approvalOf(await decidePrGate(readOnlyLedger(gitGateLedgerPort(at)), input));
+            return { status: approval.status, ...(approval.approvedBy ? { approvedBy: approval.approvedBy } : {}) };
+        },
+        ...(forge ? { publish: forgePrEnvPublisher(forge, warn) } : {}),
+        ...(forge?.pullRequestState ? { pullRequestState: (pr) => forge.pullRequestState(pr) } : {}),
+        ...(opts.log ? { log: opts.log } : {}),
+        warn,
+    };
+}
+/** The variables a teardown command reads. */
+export const PR_ENV_TEARDOWN_ENV = {
+    /** `owned` or `teardown`. */
+    stage: "CHANT_PR_ENV_STAGE",
+    /** `pr-<n>`. */
+    env: "CHANT_PR_ENV",
+    pr: "CHANT_PR_NUMBER",
+    stack: "CHANT_PR_ENV_STACK",
+    template: "CHANT_PR_ENV_TEMPLATE",
+    /** The commit last applied to the environment. */
+    commit: "CHANT_PR_ENV_COMMIT",
+    /** A JSON file: `{ components, locations }` from the records. */
+    live: "CHANT_PR_ENV_LIVE",
+    /** `teardown` only: a JSON file holding the candidates to delete. */
+    candidates: "CHANT_PR_ENV_CANDIDATES",
+    /** The JSON file the command writes its answer to. */
+    result: "CHANT_PR_ENV_RESULT",
+};
+const spawnTeardown = (argv, cwd, env) => {
+    const r = spawnSync(argv[0], argv.slice(1), { cwd, env, stdio: ["ignore", "inherit", "inherit"] });
+    if (r.error)
+        throw r.error;
+    return r.status ?? 1;
+};
+const MARKER_OK = (m) => typeof m === "object" && m !== null && typeof m.stack === "string" && typeof m.env === "string";
+/** The candidates and holes a teardown command wrote, checked as data. Throws when they do not read. */
+export function readTeardownEnumeration(raw) {
+    const doc = raw;
+    if (typeof doc !== "object" || doc === null || !Array.isArray(doc.candidates))
+        throw new Error("the teardown command's owned stage wrote no { candidates: [...] }");
+    const candidates = [];
+    for (const c of doc.candidates) {
+        if (typeof c?.name !== "string" || typeof c.type !== "string" || !MARKER_OK(c.marker))
+            throw new Error("each candidate needs a name, a type and the marker { stack, env } read back from it");
+        candidates.push({ name: c.name, type: c.type, ...(typeof c.physicalId === "string" ? { physicalId: c.physicalId } : {}), marker: { stack: c.marker.stack, env: c.marker.env } });
+    }
+    const holes = [];
+    for (const h of Array.isArray(doc.holes) ? doc.holes : []) {
+        if (typeof h?.name !== "string")
+            continue;
+        holes.push({ name: h.name, reason: "read-failed", ...(typeof h.type === "string" ? { type: h.type } : {}), ...(typeof h.detail === "string" ? { detail: h.detail } : {}) });
+    }
+    return { candidates, holes };
+}
+/** The outcomes a teardown command wrote, checked as data. A candidate it leaves out counts as failed in core. */
+export function readTeardownOutcomes(raw) {
+    const doc = raw;
+    if (typeof doc !== "object" || doc === null || !Array.isArray(doc.outcomes))
+        throw new Error("the teardown command's teardown stage wrote no { outcomes: [...] }");
+    const kinds = new Set(["deleted", "failed", "not-prunable", "retained"]);
+    return doc.outcomes
+        .filter((o) => typeof o?.name === "string" && typeof o.outcome === "string" && kinds.has(o.outcome))
+        .map((o) => ({ name: o.name, outcome: o.outcome, ...(typeof o.detail === "string" ? { detail: o.detail } : {}) }));
+}
+/**
+ * `ci.prEnvironment.teardown` as an adapter (#4330). chant runs the command
+ * twice, in `cwd`, with the job's environment less every forge token
+ * variable, and these besides ({@link PR_ENV_TEARDOWN_ENV}):
+ *
+ * - `CHANT_PR_ENV_STAGE=owned`: the command writes `{ candidates, holes }`
+ *   to `CHANT_PR_ENV_RESULT`, each candidate with the marker it read back.
+ * - `CHANT_PR_ENV_STAGE=teardown`: it deletes the candidates in
+ *   `CHANT_PR_ENV_CANDIDATES`, which chant has checked against the marker,
+ *   and writes `{ outcomes }` to `CHANT_PR_ENV_RESULT`.
+ *
+ * A non-zero exit, or an answer that does not read, is a hole (`owned`) or a
+ * failure for every candidate (`teardown`), so the environment stays live.
+ */
+export function commandTeardownAdapter(hook, opts) {
+    const exec = opts.exec ?? spawnTeardown;
+    const name = hook.name ?? "teardown";
+    const run = (stage, input, candidates) => {
+        const dir = mkdtempSync(join(tmpdir(), "chant-pr-env-teardown-"));
+        try {
+            const result = join(dir, "result.json");
+            const liveFile = join(dir, "live.json");
+            writeFileSync(liveFile, JSON.stringify({ components: input.live.components, locations: input.live.locations ?? {} }));
+            const extra = {
+                [PR_ENV_TEARDOWN_ENV.stage]: stage,
+                [PR_ENV_TEARDOWN_ENV.env]: input.environment,
+                [PR_ENV_TEARDOWN_ENV.pr]: String(input.live.pr),
+                [PR_ENV_TEARDOWN_ENV.stack]: input.marker.stack,
+                [PR_ENV_TEARDOWN_ENV.template]: input.live.template,
+                [PR_ENV_TEARDOWN_ENV.commit]: input.live.commit,
+                [PR_ENV_TEARDOWN_ENV.live]: liveFile,
+                [PR_ENV_TEARDOWN_ENV.result]: result,
+            };
+            if (candidates) {
+                const file = join(dir, "candidates.json");
+                writeFileSync(file, JSON.stringify(candidates));
+                extra[PR_ENV_TEARDOWN_ENV.candidates] = file;
+            }
+            const base = {};
+            for (const [k, v] of Object.entries(withoutForgeTokens(opts.env ?? process.env)))
+                if (v !== undefined)
+                    base[k] = v;
+            const argv = hook.command.map((a) => a.split("{env}").join(input.environment).split("{pr}").join(String(input.live.pr)).split("{stage}").join(stage));
+            const code = exec(argv, opts.cwd, { ...base, ...extra });
+            if (code !== 0)
+                throw new Error(`${argv.join(" ")} exited ${code} in its ${stage} stage`);
+            let text;
+            try {
+                text = readFileSync(result, "utf-8");
+            }
+            catch {
+                throw new Error(`${argv.join(" ")} wrote nothing to ${PR_ENV_TEARDOWN_ENV.result} in its ${stage} stage`);
+            }
+            return JSON.parse(text);
+        }
+        finally {
+            rmSync(dir, { recursive: true, force: true });
+        }
+    };
+    return {
+        name,
+        ...(hook.lexicons ? { lexicons: [...hook.lexicons] } : {}),
+        async owned(input) {
+            return readTeardownEnumeration(run("owned", input));
+        },
+        async teardown(input) {
+            try {
+                return { outcomes: readTeardownOutcomes(run("teardown", input, input.candidates)) };
+            }
+            catch (err) {
+                return { outcomes: input.candidates.map((c) => ({ name: c.name, outcome: "failed", detail: messageOf(err) })) };
+            }
+        },
+    };
+}
+function messageOf(err) {
+    return err instanceof Error ? err.message : String(err);
+}

package/dist/components/pr-environment.d.ts

@@ -32,12 +32,17 @@
  *
  * terragucci's `ephemeral.ts` gives each copy a suffixed Terraform state key.
  * That part is Terraform's own and stays there; chant keys ownership on the
- * marker its lexicons stamp and read back (`../lifecycle/teardown.ts`).
+ * marker its lexicons stamp and read back (`../lifecycle/teardown.ts`). A
+ * product supplies the rest as adapters (#4330): its plan and apply
+ * (`./pr-env-run.ts`), and a teardown for what no lexicon tears down
+ * ({@link PrEnvTeardownAdapter}), which reads the marker back from the copy
+ * as a lexicon does.
  */
 import { type ChantConfig, type EnvironmentDeclaration } from "../config.js";
 import type { OwnershipMarker } from "../ownership.js";
 import { type TeardownPlan, type TeardownPlanEntry, type TeardownReport } from "../lifecycle/teardown.js";
-import type { ObservationLexicon } from "../lexicon.js";
+import type { ObservationLexicon, TeardownCandidate, TeardownEnumeration, TeardownExecution } from "../lexicon.js";
+import type { ComponentEnvironmentDeclaration } from "./component.js";
 /** The gate a pull request's environment waits on, under the pull request's op `pr-<n>`. */
 export declare const PR_ENV_GATE = "pr-env";
 /** Where the records live on chant/lifecycle, under the member's ledger prefix. */
@@ -97,6 +102,18 @@ export type PrEnvDerivation = {
  * would not take the name, or does not declare the template.
  */
 export declare function derivePrEnvironment(config: ChantConfig, template: string, pr: number): PrEnvDerivation;
+/** The placeholder a template's site URL or domain names the environment with (#4330). */
+export declare const PR_ENV_SITE_PLACEHOLDER = "{env}";
+/**
+ * A component's site in `env`, a pull request's environment, carried over
+ * from its site in `template` (#4330). An entry the component declares for
+ * `env` itself wins. Otherwise the template's runtime and lifecycle remote
+ * carry over as they are. Its URL and domain carry over only when they name
+ * the environment with `{env}`, which becomes `pr-<n>`: a literal URL or
+ * domain is the template's own release, so it is left out rather than
+ * pointing pr-<n> at it. Undefined when neither is declared.
+ */
+export declare function prEnvironmentSite(declared: readonly ComponentEnvironmentDeclaration[] | undefined, template: string, env: string): ComponentEnvironmentDeclaration | undefined;
 /** One line of `_pr-envs/records.jsonl`: an apply, or a teardown. */
 export interface PrEnvRecord {
     version: 1;
@@ -117,6 +134,12 @@ export interface PrEnvRecord {
     commit: string;
     /** The components applied (up) or the lexicons torn down (down). */
     components: string[];
+    /**
+     * Up (#4330): where each component's copy lives, by component, as the
+     * adapter that applied it says (a Terraform root's suffixed state key).
+     * A teardown adapter reads it back from the live environment.
+     */
+    locations?: Record<string, string>;
     /** The change-set digest applied; empty for a teardown. */
     planDigest: string;
     /** `incomplete`: a teardown that left something, so the environment stays live and the sweep tries again. */
@@ -157,6 +180,8 @@ export interface LivePrEnvironment {
     commit: string;
     /** Every component an apply of it ever touched. */
     components: string[];
+    /** Where each component's copy lives, merged over every up (#4330). */
+    locations?: Record<string, string>;
     applied: string;
     expiresAt: string;
     /** Its last teardown left something, so the sweep tries again. */
@@ -188,12 +213,51 @@ export declare function ownedEntries(plan: TeardownPlan, marker: OwnershipMarker
     plan: TeardownPlan;
     dropped: TeardownPlanEntry[];
 };
+/**
+ * A teardown a product supplies for what no lexicon tears down (#4330), such
+ * as a Terraform root's copy under a suffixed state key: chant has no
+ * Terraform runner, so terragucci supplies this. It takes part in the same
+ * two halves a lexicon's teardown does (`../lifecycle/teardown.ts`): `owned`
+ * names what the environment owns, each with the marker read back from it,
+ * and `teardown` deletes the candidates chant hands back. Every candidate
+ * whose marker is not exactly `{ stack, env: "pr-<n>" }` is dropped before
+ * `teardown` sees it, and a candidate it says nothing about counts as failed.
+ */
+export interface PrEnvTeardownAdapter {
+    /** The name outcomes are attributed to, as a lexicon's are. */
+    name: string;
+    /**
+     * The lexicons this adapter tears down in place of (`terraform`). Their own
+     * teardown is left out, so a lexicon with no teardown execution does not
+     * leave the environment incomplete when the adapter covers it.
+     */
+    lexicons?: string[];
+    /** What the environment owns: candidates with their read-back markers, and what could not be read. */
+    owned(input: PrEnvTeardownAdapterInput): Promise<TeardownEnumeration>;
+    /** Delete the candidates: one outcome per candidate, keyed by name. */
+    teardown(input: PrEnvTeardownAdapterInput & {
+        candidates: TeardownCandidate[];
+    }): Promise<TeardownExecution>;
+}
+/** What a {@link PrEnvTeardownAdapter} is told about the environment. */
+export interface PrEnvTeardownAdapterInput {
+    /** `pr-<n>`. */
+    environment: string;
+    /** The marker everything is selected on. */
+    marker: OwnershipMarker;
+    /** The environment as its records say it stands: the commit last applied, its components and their locations. */
+    live: LivePrEnvironment;
+}
 /** What {@link tearDownPrEnvironment} needs. */
 export interface PrEnvTeardownInput {
     pr: number;
     live: LivePrEnvironment;
-    config: ChantConfig;
-    plugins: ObservationLexicon[];
+    /** The project's config, for its environments and stacks. Absent: a product with no chant.config.ts, whose adapters do the teardown. */
+    config?: ChantConfig;
+    /** The lexicons whose teardown runs. Default none. */
+    plugins?: ObservationLexicon[];
+    /** Teardowns a product supplies (#4330), run after the lexicons'. */
+    adapters?: PrEnvTeardownAdapter[];
     warn?: (message: string) => void;
 }
 /**
@@ -201,8 +265,9 @@ export interface PrEnvTeardownInput {
  * before any read when {@link teardownRefusal} says so; otherwise the live
  * resources under the record's marker are planned, every entry whose marker
  * is not exactly `{ stack, env: "pr-<n>" }` is dropped ({@link ownedEntries}),
- * and only the rest go to each lexicon's teardown. The endpoint is the one
- * the environment was applied at: its own `pr-*` entry's, else the template's.
+ * and only the rest go to each lexicon's or adapter's teardown. The endpoint
+ * is the one the environment was applied at: its own `pr-*` entry's, else the
+ * template's. A lexicon an adapter covers (`lexicons`) is left out.
  */
 export declare function tearDownPrEnvironment(input: PrEnvTeardownInput): Promise<{
     refusal: string;
@@ -263,6 +328,23 @@ export declare function handedPrEnvReport(raw: unknown, check: {
 } | {
     refusal: string;
 };
+/** One component's row in the report and the note. */
+export interface PrEnvReportRow {
+    component: string;
+    status: string;
+    create: number;
+    update: number;
+    replace: number;
+    delete: number;
+    /** Where its copy lives, as the adapter says (#4330). */
+    location?: string;
+    /** Its site in pr-<n>: the runtime, URL and domain carried over from the template's (#4330, {@link prEnvironmentSite}). */
+    site?: {
+        runtime?: string;
+        url?: string;
+        domain?: string;
+    };
+}
 /** What one `pr-env up` or `down` run came to, as `pr-env.json` holds it. */
 export interface PrEnvReport {
     stage: "up" | "down";
@@ -277,14 +359,7 @@ export interface PrEnvReport {
     status: "applied" | "nothing" | "waiting" | "changed" | "plan-failed" | "failed" | "refused" | "destroyed" | "incomplete" | "absent";
     message?: string;
     endpoint?: string;
-    components: Array<{
-        component: string;
-        status: string;
-        create: number;
-        update: number;
-        replace: number;
-        delete: number;
-    }>;
+    components: PrEnvReportRow[];
     approvedBy?: string[];
     expiresAt?: string;
     outcomes?: PrEnvRecord["outcomes"];

package/dist/components/pr-environment.d.ts.map

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