@intentius/chant 0.124.51 → 0.124.54

package/dist/cli/handlers/misc.js

@@ -3,6 +3,7 @@ import { describeCommand, printDescribeResult } from "../commands/describe.js";
 import { importCommand, importFromContent, importFromLive, importFromLiveStacks, printImportResult } from "../commands/import.js";
 import { loadChantConfig } from "../../config.js";
 import { resolve } from "path";
+import { existsSync, readFileSync } from "fs";
 import { auditCommand, printAuditResult } from "../commands/audit.js";
 import { AGENT_RUNTIMES, AGENT_SCOPES } from "../../agents/types.js";
 import { registeredProjectRoots } from "../../agents/discover.js";
@@ -239,6 +240,60 @@ export async function runDescribe(ctx) {
     printDescribeResult(result);
     return result.success ? 0 : 1;
 }
+/**
+ * The selection for `chant import --index` (#4524). `--type` and `--name`
+ * take comma-separated lists, `--tag key=value` repeats, `--select` is a JSON
+ * file of node ids (a list of ids, of `{ id }` or `{ node }` objects, or an
+ * object holding `nodes` or `results`) or a comma-separated list of ids, and
+ * `--all` takes every node.
+ */
+export function indexSelectionFromArgs(args) {
+    const list = (v) => (v ? v.split(",").map((s) => s.trim()).filter(Boolean) : undefined);
+    const selection = {};
+    if (args.all)
+        selection.all = true;
+    const types = list(args.selectType);
+    if (types)
+        selection.types = types;
+    const names = list(args.selectName);
+    if (names)
+        selection.names = names;
+    if (args.selectTags && args.selectTags.length > 0) {
+        const tags = {};
+        for (const t of args.selectTags) {
+            const eq = t.indexOf("=");
+            tags[t.slice(0, eq)] = t.slice(eq + 1);
+        }
+        selection.tags = tags;
+    }
+    if (args.selectAddress) {
+        const path = resolve(args.selectAddress);
+        if (existsSync(path)) {
+            let parsed;
+            try {
+                parsed = JSON.parse(readFileSync(path, "utf-8"));
+            }
+            catch (err) {
+                return new Error(`--select ${args.selectAddress} is not JSON: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            const rows = Array.isArray(parsed)
+                ? parsed
+                : parsed && typeof parsed === "object"
+                    ? (parsed.nodes ?? parsed.results ?? [])
+                    : [];
+            const ids = rows
+                .map((r) => (typeof r === "string" ? r : r && typeof r === "object" ? (r.id ?? r.node) : undefined))
+                .filter((x) => typeof x === "string");
+            if (ids.length === 0)
+                return new Error(`--select ${args.selectAddress} names no node ids`);
+            selection.nodes = ids;
+        }
+        else {
+            selection.nodes = list(args.selectAddress);
+        }
+    }
+    return selection;
+}
 export async function runImport(ctx) {
     const { args } = ctx;
     // `--agents` (#chant audit --agents' other half): the source is this
@@ -318,6 +373,28 @@ export async function runImport(ctx) {
         printImportResult(result);
         return result.success ? 0 : 1;
     }
+    // `--index <ref>` (#4524): typed source for indexed resources; nothing is applied.
+    if (args.index) {
+        const { importFromIndex, summarizeIndexImport } = await import("../commands/import-index.js");
+        const selection = indexSelectionFromArgs(args);
+        if (selection instanceof Error) {
+            console.error(formatError({ message: selection.message }));
+            return 1;
+        }
+        const result = await importFromIndex({
+            index: args.index,
+            selection,
+            output: args.output,
+            force: args.force,
+            report: args.reportFile,
+            adoptOut: args.adoptOut,
+            src: args.src,
+        });
+        printImportResult(result);
+        if (result.report)
+            console.error(summarizeIndexImport(result.report));
+        return result.success ? 0 : 1;
+    }
     // `--from <env>` switches import from a template file to a live source.
     if (args.migrateFrom) {
         const selector = args.selectType || args.selectName

package/dist/cli/handlers/pr.d.ts.map

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

package/dist/cli/handlers/pr.js

@@ -69,6 +69,7 @@ import { join, relative, resolve, sep } from "node:path";
 import { loadChantConfig, resolveAutoReleaseDisabled } from "../../config.js";
 import { resolveCommit, resolveMergeBase } from "../../components/changed-files.js";
 import { deriveFanOut, fanOutRegistry } from "../../components/fan-out-support.js";
+import { findComponentGroups, groupFanOut } from "../../components/groups.js";
 import { applyPrSet, approvalOf, approversWhoAuthored, approversWithoutReview, decidePrGate, planPrSet, prReport, readOnlyLedger, prWavePlan, resumePrSet, waveNotCovered, } from "../../components/pr-run.js";
 import { composeChangeSet, verifyChangeSetDigest } from "../../change-set.js";
 import { waveGateName } from "../../gated-waves.js";
@@ -153,6 +154,7 @@ export async function prepare(ctx, stage) {
     const signal = await resolveChangedUnits(ctx, config, { base, stacksOnly: true });
     if ("error" in signal)
         return fail(signal.error, signal.hint);
+    const registry = await fanOutRegistry(projectPath, config);
     let derived;
     try {
         derived = await deriveFanOut({
@@ -161,6 +163,7 @@ export async function prepare(ctx, stage) {
             sandbox: args.sandbox,
             buildParams: paramsResolution.provenance,
             config,
+            registry,
         });
     }
     catch (err) {
@@ -204,10 +207,19 @@ export async function prepare(ctx, stage) {
     if (policy.note)
         console.error(formatInfo(policy.note));
     const env = args.env ?? "local";
-    const registry = await fanOutRegistry(projectPath, config);
     const routedAway = member ? await routing(ctx, stage, projectPath, member, base, forge) : undefined;
     if (routedAway)
         console.error(formatInfo(routedAway));
+    // ws-107: the groups a capability plans and applies as one, placed in the waves every stage and wave job reads.
+    let plan = derived.plan;
+    if (!routedAway && plan.order.length > 0) {
+        try {
+            plan = groupFanOut(plan, derived.components, await findComponentGroups({ components: derived.components, plan, registry, env }));
+        }
+        catch (err) {
+            return fail(err instanceof Error ? err.message : String(err));
+        }
+    }
     return {
         config,
         env,
@@ -217,7 +229,7 @@ export async function prepare(ctx, stage) {
         gate: args.gate ?? PR_APPLY_GATE,
         ...(forge ? { forge } : {}),
         components: derived.components,
-        plan: routedAway ? { ...derived.plan, order: [], waves: [], seeds: [], indeterminate: [] } : derived.plan,
+        plan: routedAway ? { ...derived.plan, order: [], waves: [], seeds: [], indeterminate: [] } : plan,
         signal: derived.signal,
         ...(derived.sites ? { sites: derived.sites } : {}),
         registry,
@@ -956,6 +968,7 @@ async function prApply(ctx, stage, beforeMerge) {
         env: p.env,
         set,
         gate: p.gate,
+        approval,
         decideRound,
         ...(resumed ? { resumed: prior } : {}),
         // The apply is this run's waves, so the fan-out's own run framing is
@@ -1554,6 +1567,7 @@ async function tryResume(p, attempt, file, op, inputsNow) {
         seededOutputs: p.seededOutputs,
         record,
         completed,
+        applied: outputs,
     });
     if (!resumed.ok)
         return skip(`what is left is not what was approved. ${resumed.reasons.join("; ")}`);
@@ -1870,7 +1884,7 @@ async function prApplyWaves(ctx, p, at) {
                 planFailedIn ?? (planFailedIn = k);
                 continue;
             }
-            const moved = waveNotCovered(approvedSet.doc, fresh.doc, approvedSet.members);
+            const moved = waveNotCovered(approvedSet.doc, fresh.doc, approvedSet.members, { approved: approvedSet.shapes, fresh: fresh.shapes });
             set = fresh;
             if (moved.length === 0) {
                 console.error(formatInfo(`wave ${k}: the approved plan covers what it plans now, so it applies under the pull request's approval`));

package/dist/cli/handlers/promote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"promote.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/promote.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAiDH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAuzBlD,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAmF/E;AAED,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAsChF;AAsCD,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BhF"}
+{"version":3,"file":"promote.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/promote.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAkDH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAi4BlD,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAmF/E;AAED,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAsChF;AAsCD,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BhF"}

package/dist/cli/handlers/promote.js

@@ -31,6 +31,7 @@ import { fetchLifecycle, getHeadCommit, pushLifecycle } from "../../lifecycle/gi
 import { appendReleaseRecord, latestPerComponent, readReleaseLedger, resolveRunId, } from "../../lifecycle/release-ledger.js";
 import { isComponentList, resolveComponentTargets } from "../../components/cli-support.js";
 import { applyConfigDefaults } from "../../components/config-defaults.js";
+import { withDeclaredReads } from "../../components/declared-reads.js";
 import { fanOutRegistry } from "../../components/fan-out-support.js";
 import { renderDriverHuman } from "../../components/driver-output.js";
 import { ndjsonProgressSink } from "../../components/run-progress.js";
@@ -161,17 +162,26 @@ async function bindReleaseGate(input) {
         unsettled.set(component, `the ${u.outcome.verb} run ${u.outcome.runId} left ${component} ${u.state} in "${env}" and nothing has been recorded for it since, so what it runs is not known`);
     }
     const digests = new Map(plan.items.map((i) => [i.component, i.digest]));
-    const planSet = (only, outputs) => gate.planReleaseSet({
-        release: under.release,
-        env,
-        components: input.prepared,
-        digests,
-        registry: input.registry,
-        current,
-        unsettled,
-        seededOutputs: outputs,
-        ...(only ? { only } : {}),
-    });
+    const planSet = async (only, outputs) => {
+        const planned = await gate.planReleaseSet({
+            release: under.release,
+            env,
+            components: input.prepared,
+            digests,
+            registry: input.registry,
+            current,
+            unsettled,
+            seededOutputs: outputs,
+            ...(only ? { only } : {}),
+            ...(input.grouped ? { grouped: input.grouped } : {}),
+        });
+        // #4465: the run applies the plan the gate bound, the newest one for a group planned again.
+        for (const g of planned.groups ?? [])
+            if (g.run)
+                input.groupRuns.unshift(g.run);
+        return planned;
+    };
+    const groupsOf = (p) => ({ ...(p.groups ? { groups: p.groups } : {}), ...(p.fallbacks ? { fallbacks: p.fallbacks } : {}) });
     const { storeGateChangeSet } = await import("../../lifecycle/gate-change-set.js");
     const { readStoredChangeSet } = await import("../../lifecycle/change-set-store.js");
     const { isEmptyChangeSet } = await import("../../change-set.js");
@@ -248,6 +258,7 @@ async function bindReleaseGate(input) {
                     binding: { op: gate.RELEASE_GATE_OP, planDigest: stored.document.digest, releaseDigest, verifyEmpty },
                     reads: fresh.reads,
                     resumedFrom: stored.document.digest,
+                    ...groupsOf(fresh),
                     ...(fresh.plannedOutputs ? { plannedOutputs: fresh.plannedOutputs } : {}),
                     ...(fresh.unknownInputs ? { unknownInputs: fresh.unknownInputs } : {}),
                     ...later,
@@ -259,7 +270,7 @@ async function bindReleaseGate(input) {
         const bound = await bindDoc(fresh.doc, gates, "change set");
         if (typeof bound === "number")
             return bound;
-        return { doc: fresh.doc, ...bound, reads: fresh.reads, ...(fresh.plannedOutputs ? { plannedOutputs: fresh.plannedOutputs } : {}), ...(fresh.unknownInputs ? { unknownInputs: fresh.unknownInputs } : {}), ...later };
+        return { doc: fresh.doc, ...bound, reads: fresh.reads, ...groupsOf(fresh), ...(fresh.plannedOutputs ? { plannedOutputs: fresh.plannedOutputs } : {}), ...(fresh.unknownInputs ? { unknownInputs: fresh.unknownInputs } : {}), ...later };
     }
     const first = await planSet(undefined, input.seededOutputs);
     const bound = await bindDoc(first.doc, gates, "change set");
@@ -268,7 +279,7 @@ async function bindReleaseGate(input) {
     for (const [component, refs] of Object.entries(first.unknownInputs ?? {})) {
         console.error(formatInfo(`${component} reads ${refs.join(", ")}, known only once its upstream applies; it is planned again then, and needs its own approval if its plan moves`));
     }
-    return { doc: first.doc, ...bound, reads: first.reads, ...(first.plannedOutputs ? { plannedOutputs: first.plannedOutputs } : {}), ...(first.unknownInputs ? { unknownInputs: first.unknownInputs } : {}), ...later };
+    return { doc: first.doc, ...bound, reads: first.reads, ...groupsOf(first), ...(first.plannedOutputs ? { plannedOutputs: first.plannedOutputs } : {}), ...(first.unknownInputs ? { unknownInputs: first.unknownInputs } : {}), ...later };
 }
 /** A later round's or wave's plan was refused (provisional or failed members); the refusal is already printed. */
 class PromoteStageRefused extends Error {
@@ -426,6 +437,12 @@ async function deployPlanIn(ctx, verb, plan, project, actor, record, under) {
         }
     }
     const registry = await fanOutRegistry(project.projectPath, project.config);
+    // #4516: the reads a capability finds in its steps' files (a template's
+    // Fn::ImportValue) order the promote as `deriveFanOut` orders a fan-out, so
+    // an importer deploys after the exporter it reads. Read once the release's
+    // templates are written, so they are the files read; a read of a component
+    // this promote does not deploy is left out.
+    prepared.splice(0, prepared.length, ...(await withDeclaredReads(prepared, registry, project.projectPath)));
     const port = gitGateLedgerPort();
     // #4045: under a release, every gate binds the release's change set for this environment.
     let releaseGate;
@@ -447,10 +464,52 @@ async function deployPlanIn(ctx, verb, plan, project, actor, record, under) {
             console.error(formatWarning({ message: `could not read the resume record ${resumePath}: ${err instanceof Error ? err.message : String(err)}` }));
         }
     }
+    // ws-107 (#4465): under a release, the components a capability takes as one
+    // plan and apply as one group; under --wave-gate none forms (ruling 1).
+    // A resume groups again what is left of each group.
+    let grouped;
+    const groupRuns = [];
+    if (under) {
+        const groups = await import("../../components/groups.js");
+        const whole = await groups.formRunGroups({
+            components: prepared,
+            plan: groups.componentSetFanOut(prepared),
+            registry,
+            env: plan.to,
+            ...(args.waveGate !== undefined ? { waveGate: true } : {}),
+        });
+        if (resume && whole.groups?.length) {
+            const { remainingFanOut } = await import("../../components/fan-out.js");
+            grouped = await groups.regroupRemaining({
+                components: prepared,
+                plan: remainingFanOut(whole, prepared, { completed: resume.completed }),
+                registry,
+                env: plan.to,
+                groups: whole.groups,
+                ...(whole.fallbacks ? { fallbacks: whole.fallbacks } : {}),
+            });
+        }
+        else {
+            grouped = whole;
+        }
+    }
     let pullRequests = [];
     if (under) {
         try {
-            const result = await bindReleaseGate({ plan, prepared, under, registry, port, seededOutputs, actor: actor, projectPath: project.projectPath, head, ...(resume ? { resume } : {}) });
+            const result = await bindReleaseGate({
+                plan,
+                prepared,
+                under,
+                registry,
+                port,
+                seededOutputs,
+                actor: actor,
+                projectPath: project.projectPath,
+                head,
+                ...(resume ? { resume } : {}),
+                ...(grouped ? { grouped } : {}),
+                groupRuns,
+            });
             if (typeof result === "number") {
                 tidy();
                 return result;
@@ -507,6 +566,7 @@ async function deployPlanIn(ctx, verb, plan, project, actor, record, under) {
                 ...(args.waveGate ? { waveGate: args.waveGate } : {}),
                 replan: bound.replan,
                 bind: bound.bind,
+                ...(grouped?.groups?.length ? { grouped } : {}),
                 run: (components, outputs, binding) => runPromotion({
                     plan: { ...plan, items: plan.items.filter((i) => components.some((c) => c.name === i.component)) },
                     components,
@@ -514,6 +574,7 @@ async function deployPlanIn(ctx, verb, plan, project, actor, record, under) {
                     componentOutputs: outputs,
                     gates: port,
                     releaseGate: binding,
+                    ...(grouped?.groups?.length ? { grouped, groupRuns } : {}),
                     ...(args.progressJson ? { onProgress: ndjsonProgressSink() } : {}),
                     ...(events ? { onRunEvent: events.emit } : {}),
                 }),
@@ -528,6 +589,8 @@ async function deployPlanIn(ctx, verb, plan, project, actor, record, under) {
                 componentOutputs: seededOutputs,
                 gates: port,
                 ...(releaseGate ? { releaseGate } : {}),
+                // #4465: with no release gate to bind, nothing planned the groups beforehand, so each plans in its wave.
+                ...(grouped?.groups?.length ? { grouped, groupRuns, planGroupsAtWave: bound === undefined } : {}),
                 ...(args.progressJson ? { onProgress: ndjsonProgressSink() } : {}),
                 ...(events ? { onRunEvent: events.emit } : {}),
             });
@@ -571,6 +634,17 @@ async function deployPlanIn(ctx, verb, plan, project, actor, record, under) {
             console.error(formatInfo(`resume record: ${resumePath}; the same promote carries on from here`));
         }
     }
+    // #4465: the groups applied as one, and how each member ended, as pr-report says it.
+    const { runGroupsReport, renderRunGroups } = await import("../../components/run-groups.js");
+    const groupsReport = runGroupsReport({
+        grouped,
+        ...(bound?.groups ? { planned: bound.groups } : {}),
+        ...(bound ? { doc: bound.doc } : {}),
+        ...(run.groupOutcomes ? { outcomes: run.groupOutcomes } : {}),
+    });
+    if (!args.json)
+        for (const line of renderRunGroups(groupsReport, `the same ${verb}`))
+            console.error(formatInfo(line));
     // The driver settles the stream; this only ends one it left open.
     events?.settle(run.status === "fail" ? "failed" : run.status);
     if (!args.json)
@@ -609,7 +683,7 @@ async function deployPlanIn(ctx, verb, plan, project, actor, record, under) {
         const withChangeSet = under && changeSetJson ? { release: { ...releaseJson.release, ...changeSetJson } } : releaseJson;
         const stagedJson = staged ? { stages: staged.stages, ...(bound?.plannedOutputs ? { plannedOutputs: bound.plannedOutputs } : {}), ...(bound?.unknownInputs ? { unknownInputs: bound.unknownInputs } : {}) } : {};
         const prJson = pullRequests.length > 0 ? { pullRequests: pullRequests.map((r) => ({ commit: r.commit, source: r.source, plan: r.plan, digest: r.digest, approvedBy: r.approvedBy, ...(r.authorApproved ? { authorApproved: r.authorApproved } : {}) })) } : {};
-        console.log(JSON.stringify({ ...planJson(plan, removed), ...withChangeSet, ...stagedJson, ...prJson, run, recorded, ...(outcome ? { outcome } : {}) }, null, 2));
+        console.log(JSON.stringify({ ...planJson(plan, removed), ...withChangeSet, ...stagedJson, ...prJson, ...groupsReport, run, recorded, ...(outcome ? { outcome } : {}) }, null, 2));
     }
     else {
         for (const r of recorded) {

package/dist/cli/handlers/query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/query.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAKzD;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA8BhH;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CA+B1E"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/query.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAKzD;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAoDhH;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CA+B1E"}

package/dist/cli/handlers/query.js

@@ -1,7 +1,8 @@
 /**
  * `chant query "<sql>" [dir] [--member <name>] [--json]` (#4297): one
- * read-only SQL statement over the snapshots, Op runs, gates, deploys and
- * releases on the local `chant/lifecycle` branch. The tables and the engine
+ * read-only SQL statement over the snapshots in the index store (#4519) and
+ * the Op runs, gates, deploys and releases on the local `chant/lifecycle`
+ * branch. The tables and the engine
  * live in `../../lifecycle/query.ts`; this reads the ledgers and prints.
  *
  * Inside a workspace every member's ledger is read, each row naming its
@@ -30,8 +31,12 @@ export async function queryLedgers(cwd, members, at) {
         const commit = resolveLedgerRevision(repo, at);
         return (member) => revisionLedgerReadPort(repo, commit, member === null ? "" : memberLedgerPrefix([member]));
     })();
+    // Snapshots come from the index store (#4519). `--at` names a commit of
+    // chant/lifecycle, so it reads that commit's snapshots as before.
+    const { resolveSnapshotStore, snapshotReadPort } = await import("../../lifecycle/snapshot-store.js");
+    const store = at === undefined ? await resolveSnapshotStore({ cwd: found?.dir ?? cwd }) : undefined;
     if (!found)
-        return [{ member: null, port: atPort ? atPort(null) : gitLedgerReadPort({ cwd }) }];
+        return [{ member: null, port: atPort ? atPort(null) : gitLedgerReadPort({ cwd }), ...(store ? { snapshots: snapshotReadPort(store, { cwd }) } : {}) }];
     // Workspace code loads only when there is a workspace, so a level-0 project never pays for it.
     const { readDeclaration, WorkspaceReadError } = await import("../../workspace/declaration.js");
     const { workingTree } = await import("../../workspace/tree.js");
@@ -51,9 +56,28 @@ export async function queryLedgers(cwd, members, at) {
         if (unknown.length > 0)
             throw new QueryError(`--member ${unknown.join(", ")} names no member of the workspace`);
     }
+    // #4482: a TerraformApplyOp run names its root's directory; the member that holds it is `root_member`.
+    const { ownerOf, resolveGroups } = await import("../../workspace/declaration.js");
+    const groups = (() => {
+        try {
+            return resolveGroups(declaration, workingTree(found.dir));
+        }
+        catch {
+            return [];
+        }
+    })();
+    const ownerOfPath = (path) => {
+        const owner = ownerOf(declaration, groups, path);
+        return owner && "member" in owner ? owner.member.name : null;
+    };
     return declaration.members
         .filter((m) => !wanted || wanted.has(m.name))
-        .map((m) => ({ member: m.name, port: atPort ? atPort(m.dir === "." ? null : m.name) : gitLedgerReadPort({ cwd: found.dir, member: m.dir === "." ? "." : m.name }) }));
+        .map((m) => ({
+        member: m.name,
+        port: atPort ? atPort(m.dir === "." ? null : m.name) : gitLedgerReadPort({ cwd: found.dir, member: m.dir === "." ? "." : m.name }),
+        ...(store ? { snapshots: snapshotReadPort(store, { cwd: found.dir, member: m.dir === "." ? "." : m.name }) } : {}),
+        ownerOfPath,
+    }));
 }
 export async function runQueryCommand(ctx) {
     const { args } = ctx;

package/dist/cli/handlers/scenario.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scenario.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/scenario.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKlD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAyE3E;AA2OD,0FAA0F;AAC1F,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAM7E"}
+{"version":3,"file":"scenario.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/scenario.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKlD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAyE3E;AA4OD,0FAA0F;AAC1F,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAM7E"}

package/dist/cli/handlers/scenario.js

@@ -2,7 +2,7 @@ import { resolve } from "node:path";
 import { readFile } from "node:fs/promises";
 import { commandBuildParams } from "../build-params-cli.js";
 import { build } from "../../build.js";
-import { readEnvironmentSnapshots, fetchLifecycle } from "../../lifecycle/git.js";
+import { readEnvironmentSnapshotsFrom, resolveSnapshotStore } from "../../lifecycle/snapshot-store.js";
 import { buildChangeSet } from "../../lifecycle/change-set.js";
 import { planReceipts, mergeReceiptEntries, observedValueResolver, readReceiptValue, } from "../../lifecycle/receipt-plan.js";
 import { collectEffectReceipts, isEffectReceipt } from "../../effect-receipt.js";
@@ -73,11 +73,11 @@ export async function runScenarioCheck(ctx) {
     // ahead of the per-scenario loop, since it's a property of the build, not
     // of any one scenario's fixture.
     const receipts = collectEffectReceipts(buildResult.entities);
-    // `snapshot(env)` reads the chant/lifecycle orphan branch — fetch once,
-    // up front, the same pre-read `runLifecyclePlan` does, rather than once per
-    // scenario that needs it.
+    // `snapshot(env)` reads the index store (#4519) — fetch once, up front,
+    // the same pre-read `runLifecyclePlan` does, rather than once per scenario
+    // that needs it.
     if ([...scenarios.values()].some((s) => s.given.kind === "env")) {
-        await fetchLifecycle();
+        await (await resolveSnapshotStore()).fetch();
     }
     const results = [];
     for (const [entityName, scenario] of scenarios) {
@@ -194,9 +194,10 @@ async function resolveGiven(given) {
             behaviour: behaviourFrom([snap], given.path),
         };
     }
-    const stored = await readEnvironmentSnapshots(given.env);
+    const store = await resolveSnapshotStore();
+    const stored = await readEnvironmentSnapshotsFrom(store, given.env);
     if (stored.size === 0) {
-        const error = `no recorded snapshot for environment "${given.env}" on chant/lifecycle — record one with \`chant lifecycle snapshot ${given.env}\``;
+        const error = `no recorded snapshot for environment "${given.env}" in ${store.where} — record one with \`chant lifecycle snapshot ${given.env}\`, or name a checked-in fixture`;
         return { env: given.env, perLexicon: new Map(), error, behaviour: { missing: error } };
     }
     const perLexicon = new Map();

package/dist/cli/handlers/search.d.ts

@@ -7,6 +7,7 @@ import type { ObservationDepth } from "../../lifecycle/types.js";
 import { type CountBy } from "./search-count.js";
 import type { CommandContext } from "../registry.js";
 import { type SearchErrorCode, type SearchFailure } from "../../workspace/search-contract.js";
+import { type IndexJoin } from "../../lifecycle/index-join.js";
 /**
  * `chant search <query> [--live --env <name>]` — answer an estate question with
  * a COMPACT result instead of the whole graph. The point (measured on aws-bench,
@@ -19,11 +20,17 @@ import { type SearchErrorCode, type SearchFailure } from "../../workspace/search
  *                        on a terraform resource, its type (kind:aws_instance, kind:aws_iam_)
  *   tag:<key>=<val>      a Tags entry with Key=key and Value containing val
  *   attr:<name>=<val>    attribute <name> equals/contains <val>
+ *   id:<cloud id>        physicalId or an engine cloudIds value is exactly <cloud id> (#4534)
  *   ->kind:X / ->attr:.. this node has an edge TO a node matching the right side
  *   <-kind:X / <-attr:.. this node has an edge FROM a node matching the right side
  *   ->*X, ->{n}X, ->{m,n}X  the far end is any depth / n / m..n hops away (#4359)
  *   ->[via=a]X, ->[to=a]X   only edges through consumer attr a / reading producer attr a
  *
+ * `--index <ref>` (#4525) answers from an index version in the store instead
+ * of a live read: the declared rows joined to it through each lexicon's index
+ * match, each row with its verdict, or, with no project, the index alone.
+ * See ../../lifecycle/index-join.ts.
+ *
  * The edge operators are the point of "edge-aware" search (#1139): a small
  * model shouldn't hand-join instance→subnet→public across many results — one
  * query does the traversal. `kind:Instance ->attr:MapPublicIpOnLaunch=true`
@@ -60,6 +67,8 @@ export declare function checkSearchArgs(args: {
     failOnDrift?: boolean;
     live?: boolean;
     env?: string;
+    index?: string;
+    ambient?: boolean;
 }, query: string, snapshot: {
     ref?: string;
     flag: string;
@@ -77,6 +86,7 @@ export declare function printCapabilities(args: {
     env?: string;
     snapshot?: string;
     at?: string;
+    index?: string;
     countBy?: string;
     explain?: boolean;
     show?: string;
@@ -126,6 +136,23 @@ export type AnswerSource = {
     snapshot?: string;
     commit: string;
     timestamp: string;
+}
+/**
+ * `--index <ref>` (#4525): the index version answered from and its stamp.
+ * `index` is the ref resolved (`<scope key>@<version>`); `by` the source
+ * that wrote it; `project` false when there was no project, so every row
+ * is an indexed node.
+ */
+ | {
+    kind: "index";
+    index: string;
+    scopeKey: string;
+    version: string;
+    observedAt: string;
+    completedAt?: string;
+    digest: string;
+    by: string;
+    project: boolean;
 };
 /**
  * Name the `--show` columns nothing carries (#1279).
@@ -185,9 +212,9 @@ declare function ambientHint(matches: IRNode[], ambientKinds: string[], asked: b
  * already done. That is a fact about the query, printed for every query, and it
  * encodes no expected answer.
  */
-declare function provenanceLine(matches: IRNode[], source: AnswerSource, recorded?: string, liveFailures?: string[], derived?: string[]): string;
+declare function provenanceLine(matches: IRNode[], source: AnswerSource, recorded?: string, liveFailures?: string[], derived?: string[], joins?: Record<string, IndexJoin>): string;
 /** Print {@link provenanceLine}: the text footer. */
-declare function provenance(matches: IRNode[], source: AnswerSource, recorded?: string, liveFailures?: string[], derived?: string[]): void;
+declare function provenance(matches: IRNode[], source: AnswerSource, recorded?: string, liveFailures?: string[], derived?: string[], joins?: Record<string, IndexJoin>): void;
 /** Union `LiveObservation.resources` across lexicons into one name-keyed map. */
 declare function mergeResources(observations: LiveObservation[]): Record<string, ResourceMetadata>;
 /** Restrict a name-keyed map to the matched ids — the whole of "query-scoped". */
@@ -360,6 +387,8 @@ export interface SearchJson {
                 hops: PathHop[];
             }[];
         }[];
+        /** `--index` with a project (#4525): how the declared row joined to the index version. */
+        join?: IndexJoin;
     }[];
     provenance?: string;
     /** Present when every match is a planned create (#4372): how many. See the schema. */
@@ -411,11 +440,12 @@ declare function searchJson(query: string, source: AnswerSource, matches: IRNode
     capabilities?: SearchJson["capabilities"];
     explain?: ReturnType<typeof explainData>;
     drift?: SearchDriftJson;
+    joins?: Record<string, IndexJoin>;
 }): SearchJson;
 /** A term as the query grammar spells it, `!` and ASCII arrows included (#4367). */
 declare function termText(t: Term): string;
 export interface Term {
-    kind: "word" | "kind" | "tag" | "attr" | "edge" | "cap";
+    kind: "word" | "kind" | "tag" | "attr" | "edge" | "cap" | "id";
     /** `!term` — the node must NOT satisfy this (#1280). */
     negated?: boolean;
     a: string;
@@ -528,7 +558,7 @@ declare function findPath(n: IRNode, t: Term, ir: GraphIR, byId: Map<string, IRN
  * `producer.attr <- consumer.via`. Hops are joined with `; `.
  */
 declare function formatPath(hops: PathHop[], dir: "out" | "in"): string;
-declare function formatRow(n: IRNode, show: string[]): string;
+declare function formatRow(n: IRNode, show: string[], join?: IndexJoin): string;
 /** Internals exposed for unit tests. */
 export declare const __searchInternals: {
     parseQuery: typeof parseQuery;