@sponson/core 0.4.0 → 0.5.0

package/dist/engine/manual.d.ts

@@ -0,0 +1,47 @@
+import type { ResolveResult } from "../resolve.js";
+import type { Change, LedgerEntry, ManualStep, OpSpec, ReceiptLine } from "../types.js";
+import type { Inspection } from "./inspect.js";
+import type { RunContext } from "./run-context.js";
+import type { ManualTodo, RunOptions } from "./types.js";
+/** What inspection found out about a manual line whose inputs are all known. */
+export interface ManualState {
+    step: ManualStep;
+    /** Done: seen by its verify request, or confirmed by a person for these instructions. */
+    done: boolean;
+    /** Seen done by its verify request in this inspection. */
+    verified: boolean;
+}
+/** The receipt's `waitingFor` of a manual step (and of the lines that depend on it) until it is confirmed. */
+export declare const CONFIRMATION = "confirmation";
+/** The label a manual step's resource and diff carry. */
+export declare function manualLabel(step: Pick<ManualStep, "title">): string;
+/**
+ * Inspect a manual line: read its verify request (if any), and judge it against the ledger instead of the generic
+ * drift rules (`judge`): a step has no provider object another scope could own or a console could edit.
+ */
+export declare function inspectManual(rc: RunContext, change: Change, op: OpSpec, provider: Record<string, unknown>, resolved: ResolveResult): Promise<Inspection>;
+/** The step as shown to the person who must do it. Text is masked like every output. */
+export declare function todoOf(rc: RunContext, line: string, step: ManualStep, action: ManualTodo["action"]): ManualTodo;
+/** The waiting receipt line of a manual step nobody confirmed yet. */
+export declare function pendingLine(line: ReceiptLine, title: string, action: ManualTodo["action"]): void;
+/**
+ * The ledger entry that records a done step: who confirmed it and when, or when a verify request first saw it.
+ * Keeps the previous record when nothing about the step changed, so the first confirmation stays on file.
+ */
+export declare function manualEntry(rc: RunContext, change: Change, provider: Record<string, unknown>, state: ManualState, confirmedNow: boolean, at: string): {
+    entry: LedgerEntry;
+    changed: boolean;
+};
+/** `confirm` needs a person's name, and may name only manual lines active in this run. */
+export declare function checkConfirm(opts: RunOptions, lines: Array<{
+    id: string;
+    op: OpSpec;
+}>): void;
+/**
+ * Destroy a manual step's record: there is nothing to delete at a provider, but a person may have to undo it. With
+ * no `undo`, or once confirmed, the record is forgotten; otherwise the line waits for that confirmation and the undo
+ * instructions are returned for the person.
+ */
+export declare function destroyManual(rc: RunContext, line: ReceiptLine, entries: LedgerEntry[], at: string): ManualTodo[];
+/** Lines `confirm` named that this run did not confirm (still waiting on an input, or done already). */
+export declare function unusedConfirmations(opts: RunOptions, used: Set<string>): string | undefined;

package/dist/engine/manual.js

@@ -0,0 +1,124 @@
+/**
+ * Manual steps (ADR 0021): lines a person does by hand, for state no API can change (a Google OAuth client's
+ * redirect URIs). The op describes the step (`OpSpec.manual`); the engine owns its state:
+ *
+ * - done when its verify request sees it (`observable` steps: `read` returns its resource), or when the ledger
+ *   records a person's confirmation of these very instructions; otherwise a `todo`;
+ * - apply records a todo only when the run confirms it (`RunOptions.confirm`), and otherwise leaves the line waiting
+ *   for a confirmation with MANUAL_STEP_PENDING (its dependents wait too, nothing is rolled back);
+ * - a step a verify request saw done and no longer sees is `missing` drift, and a todo again;
+ * - rollback never undoes one (a person did it); destroy shows its `undo` and forgets it only once confirmed.
+ */
+import { SponsonError } from "../errors.js";
+/** The receipt's `waitingFor` of a manual step (and of the lines that depend on it) until it is confirmed. */
+export const CONFIRMATION = "confirmation";
+/** The label a manual step's resource and diff carry. */
+export function manualLabel(step) {
+    return `manual step: ${step.title}`;
+}
+/** The ledger entry of the step, unless it is only an intent (never written for manual steps, but be strict). */
+function recorded(rc, change, provider, key) {
+    const e = rc.ledger.get(change.adapter, provider, key);
+    return e && e.createdBy !== "intent" ? e : undefined;
+}
+/**
+ * Inspect a manual line: read its verify request (if any), and judge it against the ledger instead of the generic
+ * drift rules (`judge`): a step has no provider object another scope could own or a console could edit.
+ */
+export async function inspectManual(rc, change, op, provider, resolved) {
+    const step = op.manual(resolved.params, rc.opts.ctx);
+    const base = { change, op, provider, resolved, drift: [] };
+    if (!step)
+        return { ...base, live: null, diffs: op.diff(null, resolved.params), desired: new Set() };
+    const e = recorded(rc, change, provider, step.key);
+    const verified = step.observable && (await op.read(rc.adapterContext(change.adapter, provider), resolved.params)) !== null;
+    const confirmed = e?.manual?.how === "confirmed" && e.hash === rc.ledger.keyed(step.hash);
+    const done = verified || confirmed;
+    const label = manualLabel(step);
+    const live = done ? { resources: [{ key: step.key, id: "manual", hash: step.hash, label }], outputs: {} } : null;
+    const inspection = { ...base, live, diffs: [manualDiff(step, e, done)], desired: new Set([step.key]), manual: { step, done, verified } };
+    if (e?.manual?.how === "verified" && !verified) {
+        inspection.drift.push({ kind: "missing", adapter: change.adapter, line: change.id, resource: { key: step.key, id: e.id, label }, message: `${label} was seen done by its verify request, which no longer sees it. It is a step to do again.` });
+    }
+    return inspection;
+}
+function manualDiff(step, e, done) {
+    const label = manualLabel(step);
+    if (done)
+        return { key: step.key, kind: "unchanged", label };
+    // Recorded before with other instructions (or seen done before): to do again, as an update of the step.
+    const before = e?.manual ? { state: "literal", value: e.manual.title } : { state: "absent" };
+    return { key: step.key, kind: e ? "update" : "create", label, before, after: { state: "literal", value: step.title } };
+}
+/** The step as shown to the person who must do it. Text is masked like every output. */
+export function todoOf(rc, line, step, action) {
+    const instructions = action === "do" ? step.instructions : (step.undo ?? "");
+    return { line, title: rc.redactor.redact(step.title), action, instructions: rc.redactor.redact(instructions), observable: step.observable };
+}
+/** The waiting receipt line of a manual step nobody confirmed yet. */
+export function pendingLine(line, title, action) {
+    Object.assign(line, {
+        status: "waiting",
+        waitingFor: CONFIRMATION,
+        errorCode: "MANUAL_STEP_PENDING",
+        error: `manual step \`${title}\` ${action === "do" ? "is not done" : "must be undone"}; a person does it, then confirms it`,
+    });
+}
+/**
+ * The ledger entry that records a done step: who confirmed it and when, or when a verify request first saw it.
+ * Keeps the previous record when nothing about the step changed, so the first confirmation stays on file.
+ */
+export function manualEntry(rc, change, provider, state, confirmedNow, at) {
+    const { step } = state;
+    const prev = recorded(rc, change, provider, step.key);
+    const hash = rc.ledger.keyed(step.hash);
+    const how = confirmedNow ? "confirmed" : state.verified ? "verified" : (prev?.manual?.how ?? "confirmed");
+    const kept = prev?.manual && prev.hash === hash && prev.manual.how === how && !confirmedNow;
+    const redact = (t) => rc.redactor.redact(t);
+    const manual = kept
+        ? prev.manual
+        : { title: redact(step.title), ...(step.undo ? { undo: redact(step.undo) } : {}), how, ...(confirmedNow ? { by: rc.opts.confirmedBy.trim() } : {}), at };
+    const entry = { adapter: change.adapter, op: change.op, provider, key: step.key, id: "manual", hash, label: manualLabel(step), createdBy: "sponson", line: change.id, manual };
+    return { entry, changed: !kept || prev.line !== change.id };
+}
+/** `confirm` needs a person's name, and may name only manual lines active in this run. */
+export function checkConfirm(opts, lines) {
+    const confirm = opts.confirm ?? [];
+    if (confirm.length === 0)
+        return;
+    if (!(opts.confirmedBy ?? "").trim())
+        throw new SponsonError("USAGE", `Confirming ${confirm.map((l) => `\`${l}\``).join(", ")} needs the name of the person who did it (confirmedBy).`, { confirm });
+    const manual = new Set(lines.filter((l) => l.op.manual).map((l) => l.id));
+    const wrong = confirm.filter((id) => !manual.has(id));
+    if (wrong.length) {
+        throw new SponsonError("USAGE", `Cannot confirm ${wrong.map((id) => `\`${id}\``).join(", ")}: only manual steps can be confirmed. Manual steps here: ${[...manual].join(", ") || "(none)"}`, { confirm: wrong });
+    }
+}
+/**
+ * Destroy a manual step's record: there is nothing to delete at a provider, but a person may have to undo it. With
+ * no `undo`, or once confirmed, the record is forgotten; otherwise the line waits for that confirmation and the undo
+ * instructions are returned for the person.
+ */
+export function destroyManual(rc, line, entries, at) {
+    const todos = [];
+    const confirmed = (rc.opts.confirm ?? []).includes(line.id);
+    for (const e of entries) {
+        const m = e.manual;
+        if (m.undo && !confirmed) {
+            pendingLine(line, m.title, "undo");
+            todos.push({ line: line.id, title: m.title, action: "undo", instructions: m.undo, observable: false });
+            continue;
+        }
+        rc.ledger.delete(e);
+        line.notes = { ...line.notes, manual: m.undo ? { undoneBy: rc.opts.confirmedBy.trim(), undoneAt: at } : { nothingToUndo: true } };
+    }
+    return todos;
+}
+/** Lines `confirm` named that this run did not confirm (still waiting on an input, or done already). */
+export function unusedConfirmations(opts, used) {
+    const unused = (opts.confirm ?? []).filter((id) => !used.has(id));
+    if (unused.length === 0)
+        return undefined;
+    return `Not confirmed: ${unused.map((id) => `\`${id}\``).join(", ")} (done already, or still waiting on an input, so there was nothing to confirm yet).`;
+}
+//# sourceMappingURL=manual.js.map

package/dist/engine/manual.js.map

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

package/dist/engine/once.d.ts

@@ -0,0 +1,26 @@
+import type { LineOutputs, ResolveResult } from "../resolve.js";
+import type { ApplyResult, LedgerEntry, Literal, OpSpec } from "../types.js";
+/**
+ * Once-only outputs (ADR 0018): a value only the create response carries. The ledger never holds the value, only
+ * keyed fingerprints of it: on the producer, the one its create returned (`onceFingerprints`); on each dependent, the
+ * one it was last written with (`onceInputs`). Equal fingerprints mean the dependent still holds the current value,
+ * so a later run that cannot know the value may leave it alone (`{ keep: true }`); anything else is refused.
+ */
+/** Keyed fingerprint of a value: never reversible, keyed per scope like every hash in the ledger. */
+export type Fingerprint = (value: Literal) => string;
+/**
+ * The producer's fingerprints after a write: those of the once outputs `result` returned, over the previous
+ * resource's unless the write created something (a create starts a new value).
+ */
+export declare function producedFingerprints(op: OpSpec, result: ApplyResult, before: LedgerEntry[], fp: Fingerprint): Record<string, string>;
+/**
+ * A dependent's fingerprints after a write: the once values it was resolved with in this run, and, for references
+ * that stood as `{ keep: true }`, the fingerprints it already had.
+ */
+export declare function consumedFingerprints(resolved: ResolveResult, before: LedgerEntry[], outputs: Map<string, LineOutputs>, fp: Fingerprint): Record<string, string>;
+/**
+ * True when every resource of line `lineId` was last written with the once value `line.output` that the producer's
+ * current resource returned. False for a dependent added later, an adopted producer (no fingerprint), or a dependent
+ * that never held it.
+ */
+export declare function holdsCurrentValue(ledger: LedgerEntry[], lineId: string, ref: string, line: string, output: string): boolean;

package/dist/engine/once.js

@@ -0,0 +1,48 @@
+/**
+ * The producer's fingerprints after a write: those of the once outputs `result` returned, over the previous
+ * resource's unless the write created something (a create starts a new value).
+ */
+export function producedFingerprints(op, result, before, fp) {
+    const out = result.created.length ? {} : { ...before.find((e) => e.onceFingerprints)?.onceFingerprints };
+    for (const [name, spec] of Object.entries(op.outputs)) {
+        const v = result.outputs[name];
+        if (spec.once && v !== undefined)
+            out[name] = fp(v);
+    }
+    return out;
+}
+/**
+ * A dependent's fingerprints after a write: the once values it was resolved with in this run, and, for references
+ * that stood as `{ keep: true }`, the fingerprints it already had.
+ */
+export function consumedFingerprints(resolved, before, outputs, fp) {
+    const out = {};
+    const had = before.find((e) => e.onceInputs)?.onceInputs ?? {};
+    for (const s of resolved.spent) {
+        const was = had[s.ref];
+        if (s.kept && was)
+            out[s.ref] = was;
+    }
+    for (const input of Object.values(resolved.inputs)) {
+        if (input.state !== "resolved" || !input.dependsOn || !input.ref)
+            continue;
+        const lo = outputs.get(input.dependsOn);
+        const output = input.ref.slice(input.dependsOn.length + 1);
+        const value = lo?.values[output];
+        if (lo?.specs[output]?.once && value !== undefined)
+            out[input.ref] = fp(value);
+    }
+    return out;
+}
+/**
+ * True when every resource of line `lineId` was last written with the once value `line.output` that the producer's
+ * current resource returned. False for a dependent added later, an adopted producer (no fingerprint), or a dependent
+ * that never held it.
+ */
+export function holdsCurrentValue(ledger, lineId, ref, line, output) {
+    const entries = ledger.filter((e) => e.createdBy !== "intent");
+    const current = entries.find((e) => e.line === line && e.onceFingerprints?.[output])?.onceFingerprints?.[output];
+    const mine = entries.filter((e) => e.line === lineId);
+    return current !== undefined && mine.length > 0 && mine.every((e) => e.onceInputs?.[ref] === current);
+}
+//# sourceMappingURL=once.js.map

package/dist/engine/once.js.map

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

package/dist/engine/plan.js

@@ -2,6 +2,7 @@ import { dependenciesOf } from "../plan.js";
 import { scopeDrift } from "./drift.js";
 import { staleness } from "./history.js";
 import { inspectLine, waitingOn } from "./inspect.js";
+import { todoOf } from "./manual.js";
 import { hasExternalOutputs, planOutputs } from "./outputs.js";
 import { prepare } from "./prepare.js";
 import { RunContext } from "./run-context.js";
@@ -93,12 +94,28 @@ async function planLine(rc, prepared, walk, c) {
         if (wait.event)
             line.waitingFor = wait.event;
     }
-    else if (inspection.diffs.some((d) => d.kind === "create"))
-        line.status = "create";
-    else if (inspection.diffs.some((d) => d.kind === "update"))
-        line.status = "update";
+    else if (inspection.manual && !inspection.manual.done) {
+        line.status = "todo";
+        line.manual = todoOf(rc, c.id, inspection.manual.step, "do");
+    }
+    else
+        line.status = writeStatus(rc, inspection);
     return line;
 }
+/** What apply would write for an inspected line that is neither refused, waiting nor a manual step to do. */
+function writeStatus(rc, inspection) {
+    if (inspection.action)
+        return inspection.action.run ? "run" : "unchanged";
+    if (inspection.diffs.some((d) => d.kind === "create") || recreating(rc, inspection))
+        return "create";
+    if (inspection.diffs.some((d) => d.kind === "update"))
+        return "update";
+    return "unchanged";
+}
+/** The run recreates this existing line (`recreate`), so its `once` outputs will flow again. */
+function recreating(rc, inspection) {
+    return inspection.live !== null && (rc.opts.recreate ?? []).includes(inspection.change.id);
+}
 /** The line's outputs as they are live right now, including external ones whose event already happened. */
 async function knownOutputs(rc, walk, inspection) {
     const { change: c, op, live } = inspection;
@@ -110,7 +127,9 @@ async function knownOutputs(rc, walk, inspection) {
             values = { ...values, ...ext };
     }
     rc.guardOutputs(values, op.outputs);
-    walk.outputs.set(c.id, { values: values, specs: op.outputs });
+    // A resource that exists and that apply would not create again has shown its `once` outputs already.
+    const spent = live !== null && !inspection.diffs.some((d) => d.kind === "create") && !recreating(rc, inspection);
+    walk.outputs.set(c.id, { values: values, specs: op.outputs, spent });
     return planOutputs(values, op.outputs);
 }
 //# sourceMappingURL=plan.js.map

package/dist/engine/plan.js.map

@@ -1 +1 @@
-{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/engine/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAmB,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAiB,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAgB;IAC5C,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,EAAE,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;IAChB,MAAM,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACvF,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE;QAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,MAAM,kEAAkE,CAAC,CAAC;IAClK,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,IAAI,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1F,IAAI,EAAE,CAAC,KAAK;QAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,0CAA0C,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,uCAAuC,CAAC,CAAC;IAErK,MAAM,IAAI,GAAa,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;IACxG,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAEpF,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,UAAU,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACvH,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG;QACzB,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK;QACrB,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;QACxB,KAAK;QACL,KAAK;QACL,QAAQ,EAAE,EAAE,CAAC,QAAQ;QACrB,QAAQ,EAAE,EAAE,CAAC,QAAQ;QACrB,IAAI;QACJ,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;KAC5C,CAAC;AACJ,CAAC;AAaD,KAAK,UAAU,QAAQ,CAAC,EAAc,EAAE,QAAkB,EAAE,IAAc,EAAE,CAAS;IACnF,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAE,CAAC;IACnC,MAAM,IAAI,GAAa,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAE3H,MAAM,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACpE,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,gBAAgB,SAAS,6BAA6B,EAAE,SAAS,EAAE,oBAAoB,EAAE,CAAC,CAAC;QAC3I,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,UAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,UAAU,GAAG,MAAM,WAAW,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACtF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3G,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;IAC9B,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC;IACzC,IAAI,CAAC,OAAO,GAAG,MAAM,YAAY,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAExD,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;IACjD,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;QACvB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAClH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC;SAAM,IAAI,IAAI,EAAE,CAAC;QAChB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC;QAC3B,IAAI,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC;IAC/C,CAAC;SAAM,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;QAAE,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;SAChF,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;QAAE,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;IACnF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,2GAA2G;AAC3G,KAAK,UAAU,YAAY,CAAC,EAAc,EAAE,IAAc,EAAE,UAAsB;IAChF,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC;IAC3C,IAAI,MAAM,GAA4B,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3D,IAAI,IAAI,IAAI,EAAE,CAAC,aAAa,IAAI,kBAAkB,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/D,0FAA0F;QAC1F,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,EAAE,UAAU,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAC1I,IAAI,GAAG;YAAE,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,GAAG,GAAG,EAAE,CAAC;IAC1C,CAAC;IACD,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAA+B,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IACvF,OAAO,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/engine/plan.ts"],"names":[],"mappings":"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"}

package/dist/engine/prepare.d.ts

@@ -1,4 +1,4 @@
-import type { Change, OpSpec } from "../types.js";
+import { type Change, type OpSpec } from "../types.js";
 import type { RunOptions } from "./types.js";
 /** Everything about a run that follows from the plan and context alone, before touching any provider. */
 export interface Prepared {

package/dist/engine/prepare.js

@@ -3,6 +3,8 @@ import { SponsonError } from "../errors.js";
 import { orderChanges, outputRefs } from "../graph.js";
 import { changesFor } from "../plan.js";
 import { secretRefs } from "../resolve.js";
+import { isFromRef, isSecretRef } from "../types.js";
+import { providerOf } from "./run-context.js";
 export function prepare(opts) {
     const { plan, ctx, registry } = opts;
     if (!plan.environments.includes(ctx.env)) {
@@ -12,29 +14,29 @@ export function prepare(opts) {
         });
     }
     const ordered = orderChanges(changesFor(plan, ctx.env), plan.changes);
+    checkRecreate(opts.recreate ?? [], ordered, ctx.env, registry);
     const ops = new Map();
+    const providers = new Map();
     const params = new Map();
     const refs = new Set();
     const productionLines = [];
-    for (const c of ordered)
-        ops.set(c.id, registry.op(c.adapter, c.op));
+    for (const c of ordered) {
+        const op = specialize(registry.op(c.adapter, c.op), c);
+        // A provider block the op cannot use (an unknown API name) must fail here, before any provider call.
+        providers.set(c.id, providerOf(plan.providers[c.adapter] ?? {}, op, c));
+        ops.set(c.id, op);
+    }
     for (const c of ordered) {
         const op = ops.get(c.id);
-        // Output names are static: a typo must fail at plan time, not after half an apply.
-        for (const ref of outputRefs(c)) {
-            const target = ordered.find((x) => x.id === ref.line);
-            const known = Object.keys(ops.get(target.id).outputs);
-            if (!known.includes(ref.output)) {
-                throw new SponsonError("REF_OUTPUT_UNKNOWN", `Line \`${c.id}\` reads \`${ref.line}.${ref.output}\`, but ${target.adapter}.${target.op} has no output \`${ref.output}\`. Known: ${known.join(", ") || "(none)"}`, { id: c.id, ref: `${ref.line}.${ref.output}`, known });
-            }
-        }
+        checkRefs(c, ordered, ops);
         let p = interpolate(c.params, ctx, `line \`${c.id}\``);
         if (op.defaults)
             p = op.defaults(p, ctx);
         params.set(c.id, p);
         for (const r of secretRefs(p))
             refs.add(r);
-        if (ctx.env !== "production" && op.writesEnvironment?.(p, ctx) === "production")
+        // The provider block counts too: a LaunchDarkly block naming a production environment writes production.
+        if (ctx.env !== "production" && op.writesEnvironment?.(p, ctx, providers.get(c.id)) === "production")
             productionLines.push(c.id);
     }
     return {
@@ -46,6 +48,51 @@ export function prepare(opts) {
         productionLines,
     };
 }
+/** A line's references, before any provider call: every output it reads exists, every credential it takes is masked. */
+function checkRefs(c, ordered, ops) {
+    // Output names are static: a typo must fail at plan time, not after half an apply.
+    for (const ref of outputRefs(c)) {
+        const target = ordered.find((x) => x.id === ref.line);
+        const known = Object.keys(ops.get(target.id).outputs);
+        if (!known.includes(ref.output)) {
+            throw new SponsonError("REF_OUTPUT_UNKNOWN", `Line \`${c.id}\` reads \`${ref.line}.${ref.output}\`, but ${target.adapter}.${target.op} has no output \`${ref.output}\`. Known: ${known.join(", ") || "(none)"}`, { id: c.id, ref: `${ref.line}.${ref.output}`, known });
+        }
+    }
+    for (const name of ops.get(c.id).credentialInputs?.(c.params) ?? [])
+        checkCredentialInput(c, name, ordered, ops);
+}
+/**
+ * A param that carries a credential (`OpSpec.credentialInputs`) must be a reference whose value Sponson masks: a
+ * `{ secret }`, or a `{ from }` naming a sensitive output that later runs can read again (not `once`, ADR 0018).
+ * A literal would put the credential in the plan file; a non-sensitive output would show it in receipts.
+ */
+function checkCredentialInput(c, name, ordered, ops) {
+    const v = c.params[name];
+    if (isSecretRef(v))
+        return;
+    const fail = (why) => new SponsonError("PARAM_INVALID", `${c.adapter}: line \`${c.id}\`: \`${name}\` ${why}`, { adapter: c.adapter, id: c.id, param: name });
+    if (!isFromRef(v) || Object.keys(v).length !== 1)
+        throw fail("must be `{ secret: <reference> }` or `{ from: <line>.<output> }` naming a sensitive output, never a literal credential");
+    const [line, ...rest] = v.from.split(".");
+    const target = ordered.find((x) => x.id === line);
+    const spec = target ? ops.get(target.id).outputs[rest.join(".")] : undefined;
+    if (!spec)
+        return; // an unknown line or output is reported as REF_UNKNOWN / REF_OUTPUT_UNKNOWN
+    if (spec.sensitive !== true)
+        throw fail(`reads \`${v.from}\`, which is not a sensitive output: a credential must never reach receipts or output`);
+    if (spec.once === true)
+        throw fail(`reads \`${v.from}\`, which the provider shows only when it is created (once): later runs could not authenticate with it`);
+}
+/**
+ * The op as this line uses it: with the outputs the line declares when the op derives them from its params
+ * (`OpSpec.outputsFor`), so references to them are checked here like any other output. The prototype keeps every
+ * other member of the op.
+ */
+function specialize(op, c) {
+    if (!op.outputsFor)
+        return op;
+    return Object.assign(Object.create(op), { outputs: op.outputsFor(c.params) });
+}
 /**
  * Approval is a non-empty name; whitespace is not a person. Only `opts.approvedBy` counts: where it comes from
  * (a flag, an environment variable, an approval workflow) is the caller's business.
@@ -66,4 +113,17 @@ export function requireApproval(opts, prepared) {
     }
     return approvedBy;
 }
+/** `recreate` may name only lines active in this environment, and never a manual step (a person did it). */
+function checkRecreate(recreate, ordered, env, registry) {
+    const unknown = recreate.filter((id) => !ordered.some((c) => c.id === id));
+    if (unknown.length) {
+        throw new SponsonError("USAGE", `Cannot recreate ${unknown.map((id) => `\`${id}\``).join(", ")}: no such line in environment ${env}. Lines: ${ordered.map((c) => c.id).join(", ")}`, {
+            recreate: unknown,
+        });
+    }
+    const manual = ordered.filter((c) => recreate.includes(c.id) && registry.op(c.adapter, c.op).manual);
+    if (manual.length) {
+        throw new SponsonError("USAGE", `Cannot recreate ${manual.map((c) => `\`${c.id}\``).join(", ")}: a manual step is done by a person; change its instructions to make it a step to do again.`, { recreate: manual.map((c) => c.id) });
+    }
+}
 //# sourceMappingURL=prepare.js.map

package/dist/engine/prepare.js.map

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

package/dist/engine/run-context.d.ts

@@ -1,6 +1,6 @@
 import { type ErrorCode } from "../errors.js";
 import { Redactor } from "../redact.js";
-import type { AdapterContext, LedgerEntry, Receipt } from "../types.js";
+import type { AdapterContext, Change, LedgerEntry, OpSpec, Receipt } from "../types.js";
 import { Ledger } from "./ledger.js";
 import type { Prepared } from "./prepare.js";
 import type { RunOptions } from "./types.js";
@@ -40,7 +40,11 @@ export declare class RunContext {
     guardOutputs(values: Record<string, unknown>, specs: Record<string, {
         sensitive?: boolean;
     }>): void;
-    provider(adapter: string): Record<string, unknown>;
+    /**
+     * The provider block a line's resources live in: `providers.<adapter>`, narrowed by the op's `providerFor` when it
+     * has one (the generic `http` adapter keeps one block per API there). It is part of every ledger identity.
+     */
+    provider(change: Change): Record<string, unknown>;
     foreignScopeOf(entry: Pick<LedgerEntry, "adapter" | "provider" | "key">): string | undefined;
     adapterContext(adapter: string, provider: Record<string, unknown>, intend?: (keys: string[]) => Promise<void>): AdapterContext;
     /** What was thrown, redacted, with its code when it is a SponsonError. Anything may be thrown, not only Errors. */
@@ -49,3 +53,5 @@ export declare class RunContext {
         code?: ErrorCode;
     };
 }
+/** `block` as the op narrows it for `change` (see `OpSpec.providerFor`); the whole block when the op does not. */
+export declare function providerOf(block: Record<string, unknown>, op: OpSpec, change: Change): Record<string, unknown>;

package/dist/engine/run-context.js

@@ -101,8 +101,12 @@ export class RunContext {
             if (specs[k]?.sensitive && typeof v === "string")
                 this.redactor.register(v);
     }
-    provider(adapter) {
-        return this.opts.plan.providers[adapter] ?? {};
+    /**
+     * The provider block a line's resources live in: `providers.<adapter>`, narrowed by the op's `providerFor` when it
+     * has one (the generic `http` adapter keeps one block per API there). It is part of every ledger identity.
+     */
+    provider(change) {
+        return providerOf(this.opts.plan.providers[change.adapter] ?? {}, this.opts.registry.op(change.adapter, change.op), change);
     }
     foreignScopeOf(entry) {
         return this.foreign.get(identity(entry.adapter, entry.provider, entry.key));
@@ -116,6 +120,7 @@ export class RunContext {
             log: (m) => log(this.redactor.redact(`[${adapter}] ${m}`)),
             intend,
             redact: (t) => this.redactor.redact(t),
+            secret: (v) => this.redactor.register(v),
         };
     }
     /** What was thrown, redacted, with its code when it is a SponsonError. Anything may be thrown, not only Errors. */
@@ -125,4 +130,8 @@ export class RunContext {
         return isSponsonError(e) ? { message, code: e.code } : { message };
     }
 }
+/** `block` as the op narrows it for `change` (see `OpSpec.providerFor`); the whole block when the op does not. */
+export function providerOf(block, op, change) {
+    return op.providerFor ? op.providerFor(block, change.params) : block;
+}
 //# sourceMappingURL=run-context.js.map

package/dist/engine/run-context.js.map

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