@intentius/chant 0.111.0 → 0.112.0

package/dist/op/steward.d.ts

@@ -208,7 +208,7 @@ export declare function readinessKeys(result: unknown): {
     keys: string[];
 } | null;
 /** The form a steward takes in `env` (`local` when none is named). */
-export declare function stewardFormFor(steward: StewardDeclaration, env?: string): StewardForm;
+export declare function stewardFormFor(steward: Pick<StewardDeclaration, "form">, env?: string): StewardForm;
 /**
  * The lease a local steward holds for as long as it runs, so a second
  * `chant operator --steward` for the same steward is refused. It sits under

package/dist/op/steward.d.ts.map

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

package/dist/workspace/status-stewards.d.ts

@@ -4,7 +4,8 @@
  * its Ops with their schedules, and each Op's last run.
  *
  * The steward itself is read from its declaration, the same `*.op.ts` files
- * `chant operator --steward` reads (`../op/discover.ts`), and only for a member
+ * `chant operator --steward` reads (`../op/discover.ts`), through the index
+ * kept per tree (`./steward-index.ts`, #3636), and only for a member
  * of kind `chant` that is a chant project of its own (a `chant.config.ts` or
  * `.json` in its directory), so a member never lists a parent project's
  * steward. Everything
@@ -46,6 +47,7 @@
  */
 import { type StewardForm } from "../op/steward.js";
 import { type ConvergeTickRecord } from "../lifecycle/converge-ledger.js";
+import { type StewardIndex } from "./steward-index.js";
 import type { OpRunRecord } from "../op/runtime.js";
 /** Why a member's stewards can't be fully listed. Closed: a new code is a contract change. */
 export declare const STEWARD_REASON_CODES: readonly ["stewards-unreadable", "stewards-conflict", "steward-runs-unreadable"];
@@ -264,5 +266,6 @@ export declare function readMemberStewards(memberDir: string, env: string, now:
     }[];
 } | null, deps?: {
     readQuestions?: ReadQuestionStates;
+    readIndex?: (memberDir: string) => Promise<StewardIndex>;
 }): Promise<MemberStewards>;
 //# sourceMappingURL=status-stewards.d.ts.map

package/dist/workspace/status-stewards.d.ts.map

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

package/dist/workspace/steward-index.d.ts

@@ -0,0 +1,89 @@
+/**
+ * What `chant workspace status` reads of a project's stewards and Ops
+ * (#3636), kept per tree so a status doesn't import every `*.op.ts` file
+ * each time it runs.
+ *
+ * Discovery (`../op/discover.ts`) has to import the Op modules, and an Op
+ * module may do work when it is imported: run git, read files, even start
+ * another chant. Status needs only plain fields of what it finds: each
+ * steward's name, file, form, vault, capabilities and Ops, and of each Op
+ * its name, schedule, labels, work lease kind and `changesCheckout`. The
+ * first status on a tree discovers them and writes that index to
+ * `<cache dir>/workspace-stewards/<checkout>/<key>.json`; later ones read
+ * it back, until the tree changes. The cache dir is the one the graph cache
+ * uses (`./graph-cache.ts`): `$CHANT_CACHE_DIR`, else
+ * `$XDG_CACHE_HOME/chant`, else `~/.cache/chant`, outside the workspace,
+ * since a read never changes the workspace it reads.
+ *
+ * The tree is the checkout's `HEAD` tree plus every changed or untracked
+ * file `git status` lists (its path and contents), and the chant version,
+ * so a commit, an edit or a new file anywhere in the checkout discovers
+ * again. Files git ignores (`node_modules`) are not part of it. An index is
+ * only written when every Op file imported, so an import that failed is
+ * tried again by the next status. `CHANT_STEWARD_INDEX=0` turns the index
+ * off, for an Op module whose declaration depends on more than its tree.
+ */
+import { type StewardForm } from "../op/steward.js";
+/** What status reads of an Op. */
+export interface IndexedOp {
+    name: string;
+    schedule: {
+        cron: string;
+    } | null;
+    /** Absent when the Op has none. */
+    labels?: Record<string, string>;
+    workLease: {
+        kind: string | null;
+    } | null;
+    changesCheckout: boolean;
+}
+/** What status reads of a steward. */
+export interface IndexedSteward {
+    name: string;
+    /** The `*.op.ts` file declaring it, absolute. */
+    filePath: string;
+    /** Every Op it runs: its turns' Ops, then those beside them. */
+    ops: IndexedOp[];
+    /** The Ops it runs beside its turns (#2861), and whether each declares a ready step. */
+    beside: {
+        op: string;
+        ready: boolean;
+    }[];
+    form: {
+        default: StewardForm;
+        environments: Record<string, StewardForm>;
+    };
+    capabilities: string[];
+    vault: string | null;
+}
+export interface StewardIndex {
+    /** In discovery's order. */
+    stewards: IndexedSteward[];
+    /** Files that could not be imported. */
+    errors: string[];
+    /** Stewards dropped as second writers. */
+    conflicts: string[];
+    /** The project's Ops that no steward lists, or null when they couldn't be discovered. */
+    otherOps: IndexedOp[] | null;
+}
+/** Discover the stewards and Ops under `memberDir`, importing every Op file. Throws as `discoverStewards` does. */
+export declare function discoverStewardIndex(memberDir: string): Promise<StewardIndex>;
+/**
+ * The key of the tree `memberDir` is in: its `HEAD` tree, each changed or
+ * untracked file's path and contents, the chant version and `memberDir`.
+ * Null outside a checkout, or when git can't say.
+ */
+export declare function treeKey(memberDir: string): Promise<{
+    key: string;
+    dir: string;
+    checkout: string;
+} | null>;
+/**
+ * The stewards and Ops under `memberDir`: from the index for its tree when
+ * there is one, else discovered and indexed. Throws as `discoverStewards`
+ * does.
+ */
+export declare function readStewardIndex(memberDir: string, deps?: {
+    discover?: typeof discoverStewardIndex;
+}): Promise<StewardIndex>;
+//# sourceMappingURL=steward-index.d.ts.map

package/dist/workspace/steward-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steward-index.d.ts","sourceRoot":"","sources":["../../src/workspace/steward-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAUH,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAuBlE,kCAAkC;AAClC,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAClC,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1C,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,GAAG,EAAE,SAAS,EAAE,CAAC;IACjB,wFAAwF;IACxF,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IACzC,IAAI,EAAE;QAAE,OAAO,EAAE,WAAW,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;KAAE,CAAC;IAC1E,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,wCAAwC;IACxC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,yFAAyF;IACzF,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;CAC9B;AAYD,mHAAmH;AACnH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAsBnF;AASD;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAyB/G;AA8BD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,oBAAoB,CAAA;CAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CA0BtI"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant",
-  "version": "0.111.0",
+  "version": "0.112.0",
   "description": "Declarative infrastructure-as-code toolkit — TypeScript on Node.js",
   "license": "Apache-2.0",
   "homepage": "https://intentius.io/chant",

package/src/op/steward.ts

@@ -352,7 +352,7 @@ export function readinessKeys(result: unknown): { ready: boolean; keys: string[]
 }
 
 /** The form a steward takes in `env` (`local` when none is named). */
-export function stewardFormFor(steward: StewardDeclaration, env: string = DEFAULT_STEWARD_ENV): StewardForm {
+export function stewardFormFor(steward: Pick<StewardDeclaration, "form">, env: string = DEFAULT_STEWARD_ENV): StewardForm {
   return steward.form.environments[env] ?? steward.form.default;
 }
 

package/src/workspace/status-stewards.ts

@@ -4,7 +4,8 @@
  * its Ops with their schedules, and each Op's last run.
  *
  * The steward itself is read from its declaration, the same `*.op.ts` files
- * `chant operator --steward` reads (`../op/discover.ts`), and only for a member
+ * `chant operator --steward` reads (`../op/discover.ts`), through the index
+ * kept per tree (`./steward-index.ts`, #3636), and only for a member
  * of kind `chant` that is a chant project of its own (a `chant.config.ts` or
  * `.json` in its directory), so a member never lists a parent project's
  * steward. Everything
@@ -47,8 +48,7 @@
 
 import { existsSync, realpathSync } from "node:fs";
 import { dirname, join, relative, resolve } from "node:path";
-import { discoverOps, discoverStewards } from "../op/discover";
-import { stewardBesideFor, stewardFormFor, stewardLeaseName, type StewardForm } from "../op/steward";
+import { stewardFormFor, stewardLeaseName, type StewardForm } from "../op/steward";
 import { readRunLedger, runEnvOf } from "../lifecycle/run-ledger";
 import { readConvergeLedger, type ConvergeTickRecord } from "../lifecycle/converge-ledger";
 import { leaseRef } from "../lifecycle/lease";
@@ -56,7 +56,7 @@ import { readBlobBySha, readRefSha } from "../lifecycle/git";
 import { resolveMemberLedger } from "../lifecycle/member-ledger";
 import { listWorkLeases } from "../lifecycle/work-lease";
 import { stewardWorkHolder } from "../op/work-lease-run";
-import type { OpConfig } from "../op/types";
+import { readStewardIndex, type IndexedOp, type IndexedSteward, type StewardIndex } from "./steward-index";
 import type { OpRunRecord } from "../op/runtime";
 import { readInFlightRun } from "../op/run-live";
 import { approveCommand } from "./status-gates";
@@ -342,19 +342,14 @@ async function readLeaseRef(leaseName: string, memberDir: string, now: string):
 }
 
 /** An Op's `beside` entry (#2861): null for an Op run as one of the steward's turns. */
-async function besideOf(
-  declaration: Parameters<typeof stewardBesideFor>[0],
-  op: string,
-  memberDir: string,
-  now: string,
-): Promise<StatusStewardOp["beside"]> {
-  const beside = stewardBesideFor(declaration, op);
+async function besideOf(steward: IndexedSteward, op: string, memberDir: string, now: string): Promise<StatusStewardOp["beside"]> {
+  const beside = steward.beside.find((b) => b.op === op);
   if (!beside) return null;
-  return { ready: beside.ready !== null && beside.ready !== undefined, lease: await readLeaseRef(op, memberDir, now) };
+  return { ready: beside.ready, lease: await readLeaseRef(op, memberDir, now) };
 }
 
 /** The work leases `steward`'s turns of `op` hold, from the ledger of the Op's kind or the member's. */
-async function readHeldWorkLeases(steward: string, op: OpConfig, memberDir: string, now: string): Promise<StatusStewardWorkLease[]> {
+async function readHeldWorkLeases(steward: string, op: IndexedOp, memberDir: string, now: string): Promise<StatusStewardWorkLease[]> {
   try {
     const kind = op.workLease?.kind;
     const cwd = kind ? dirname(resolve(memberDir, kind)) : memberDir;
@@ -378,7 +373,7 @@ export async function readMemberStewards(
   now: string,
   kind = "chant",
   box: { capabilities: { name: string; broker: string | null }[] } | null = null,
-  deps: { readQuestions?: ReadQuestionStates } = {},
+  deps: { readQuestions?: ReadQuestionStates; readIndex?: (memberDir: string) => Promise<StewardIndex> } = {},
 ): Promise<MemberStewards> {
   const reasons: MemberStewards["reasons"] = [];
   // Read once per member, and only when a run stopped on a question.
@@ -386,19 +381,18 @@ export async function readMemberStewards(
   const questionStates = () => (states ??= (deps.readQuestions ?? readQuestionStates)(memberDir));
   if (kind !== "chant" || !isChantProject(memberDir)) return { stewards: [], reasons };
 
-  let discovered: Awaited<ReturnType<typeof discoverStewards>>;
+  let index: StewardIndex;
   try {
-    discovered = await discoverStewards({ cwd: memberDir });
+    index = await (deps.readIndex ?? readStewardIndex)(memberDir);
   } catch (err) {
     reasons.push({ code: "stewards-unreadable", message: err instanceof Error ? err.message.split("\n")[0] : String(err) });
     return { stewards: [], reasons };
   }
-  const { stewards: found, errors, conflicts } = discovered;
-  for (const message of errors) reasons.push({ code: "stewards-unreadable", message });
-  for (const message of conflicts) reasons.push({ code: "stewards-conflict", message });
+  for (const message of index.errors) reasons.push({ code: "stewards-unreadable", message });
+  for (const message of index.conflicts) reasons.push({ code: "stewards-conflict", message });
 
   const stewards: StatusSteward[] = [];
-  for (const { declaration, filePath } of [...found.values()].sort((a, b) => a.declaration.name.localeCompare(b.declaration.name))) {
+  for (const declaration of [...index.stewards].sort((a, b) => a.name.localeCompare(b.name))) {
     const ops: StatusStewardOp[] = [];
     const waiting: StatusSteward["waiting"] = [];
     for (const op of declaration.ops) {
@@ -467,11 +461,11 @@ export async function readMemberStewards(
     }
     stewards.push({
       name: declaration.name,
-      file: relative(realpathSync(memberDir), realpathSync(filePath)).split("\\").join("/"),
+      file: relative(realpathSync(memberDir), realpathSync(declaration.filePath)).split("\\").join("/"),
       form: stewardFormFor(declaration, env),
       forms: { default: declaration.form.default, environments: { ...declaration.form.environments } },
-      vault: typeof declaration.vault === "string" ? declaration.vault : null,
-      capabilities: (Array.isArray(declaration.capabilities) ? declaration.capabilities : []).map((name) => {
+      vault: declaration.vault,
+      capabilities: declaration.capabilities.map((name) => {
         const declared = box?.capabilities.find((c) => c.name === name);
         return { name, broker: declared?.broker ?? null, declared: declared !== undefined };
       }),
@@ -480,7 +474,7 @@ export async function readMemberStewards(
       waiting,
     });
   }
-  if (stewards.length > 0) await addUndeclaredWaits(memberDir, stewards, found, reasons, now, questionStates);
+  if (stewards.length > 0 && index.otherOps) await addUndeclaredWaits(memberDir, stewards, index.otherOps, reasons, now, questionStates);
   return { stewards, reasons };
 }
 
@@ -489,26 +483,20 @@ export async function readMemberStewards(
  * steward its record names. A steward's process can start an Op itself
  * with `CHANT_STEWARD` set (studio#137), and the run ledger then records
  * the run as the steward's though the declaration does not list the Op.
- * Import failures are left out here: `discoverStewards` read the same files
- * and reported them as `stewards-unreadable`.
+ * `ops` are the member's Ops no steward lists, from the index; import
+ * failures are left out there, as discovering the stewards reported them as
+ * `stewards-unreadable`.
  */
 async function addUndeclaredWaits(
   memberDir: string,
   stewards: StatusSteward[],
-  found: Awaited<ReturnType<typeof discoverStewards>>["stewards"],
+  ops: IndexedOp[],
   reasons: MemberStewards["reasons"],
   now: string,
   questionStates: () => Promise<Map<string, string> | null>,
 ): Promise<void> {
-  const declared = new Set([...found.values()].flatMap(({ declaration }) => declaration.ops.map((op) => op.name)));
-  let ops: OpConfig[];
-  try {
-    ops = [...(await discoverOps({ cwd: memberDir })).ops.values()].map((d) => d.config).filter((op) => !declared.has(op.name));
-  } catch {
-    return;
-  }
   const byName = new Map(stewards.map((s) => [s.name, s]));
-  for (const op of ops.sort((a, b) => a.name.localeCompare(b.name))) {
+  for (const op of [...ops].sort((a, b) => a.name.localeCompare(b.name))) {
     const opEnv = runEnvOf(op);
     try {
       const newest = (await readRunLedger(opEnv, op.name, { cwd: memberDir })).records.at(-1);

package/src/workspace/steward-index.test.ts

@@ -0,0 +1,171 @@
+/**
+ * The steward index behind `chant workspace status` (#3636): discovered
+ * once per tree, read back while the tree is the same, discovered again
+ * after an edit, a new file or a commit, and never written into the
+ * checkout.
+ */
+
+import { existsSync, mkdirSync, readdirSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { afterAll, afterEach, beforeEach, describe, expect, test } from "vitest";
+import { cleanScratch, commitAll, git, repo, scratchDir } from "./__fixtures__/contract-repo";
+import { declareSteward } from "../op/steward";
+import type { OpConfig } from "../op/types";
+import { discoverStewardIndex, readStewardIndex, type StewardIndex } from "./steward-index";
+import { readMemberStewards } from "./status-stewards";
+
+afterAll(cleanScratch);
+
+let cache: string;
+let before: string | undefined;
+beforeEach(() => {
+  before = process.env.CHANT_CACHE_DIR;
+  cache = scratchDir("chant-steward-index-cache-");
+  process.env.CHANT_CACHE_DIR = cache;
+});
+afterEach(() => {
+  if (before === undefined) delete process.env.CHANT_CACHE_DIR;
+  else process.env.CHANT_CACHE_DIR = before;
+  delete process.env.CHANT_STEWARD_INDEX;
+});
+
+function op(name: string, extra: Partial<OpConfig> = {}): OpConfig {
+  return {
+    name,
+    overview: `${name} fixture`,
+    phases: [{ name: "only", steps: [{ kind: "activity", fn: "noop", args: {} }] }],
+    ...extra,
+  } as OpConfig;
+}
+
+/** A chant project whose one Op file declares a steward and exports another Op it doesn't list. */
+function project(): string {
+  const tick = op("tick", { schedule: { cron: "0 * * * *" }, labels: { Env: "box" } });
+  const build = op("build", { workLease: { item: "W-001", kind: "work/work.kind.mjs" }, changesCheckout: true });
+  const steward = declareSteward({
+    name: "box-steward",
+    ops: [tick],
+    beside: [{ op: build, ready: { kind: "activity", fn: "ready", args: {} } }],
+    form: { default: "local", environments: { k3d: "fountain" } },
+    capabilities: ["inference"],
+  });
+  return repo(
+    {
+      "chant.config.json": "{}\n",
+      "ops/steward.op.ts": `export const steward = ${JSON.stringify(steward)};\nexport const lonely = { props: ${JSON.stringify(op("lonely"))} };\n`,
+    },
+    true,
+  );
+}
+
+/** `readStewardIndex`, counting the discoveries it makes. */
+function counted(dir: string) {
+  let n = 0;
+  const discover = async (d: string): Promise<StewardIndex> => {
+    n++;
+    return discoverStewardIndex(d);
+  };
+  return { read: () => readStewardIndex(dir, { discover }), discoveries: () => n };
+}
+
+describe("the steward index (#3636)", () => {
+  test("holds what status reads of the stewards and Ops", async () => {
+    const root = project();
+    const index = await discoverStewardIndex(root);
+    expect(index.errors).toEqual([]);
+    expect(index.conflicts).toEqual([]);
+    expect(index.stewards).toHaveLength(1);
+    const [s] = index.stewards;
+    expect(s).toMatchObject({
+      name: "box-steward",
+      beside: [{ op: "build", ready: true }],
+      form: { default: "local", environments: { k3d: "fountain" } },
+      capabilities: ["inference"],
+      vault: null,
+    });
+    expect(s.filePath.endsWith(join("ops", "steward.op.ts"))).toBe(true);
+    expect(s.ops).toEqual([
+      { name: "tick", schedule: { cron: "0 * * * *" }, labels: { Env: "box" }, workLease: null, changesCheckout: false },
+      { name: "build", schedule: null, workLease: { kind: "work/work.kind.mjs" }, changesCheckout: true },
+    ]);
+    expect(index.otherOps).toEqual([{ name: "lonely", schedule: null, workLease: null, changesCheckout: false }]);
+  });
+
+  test("a second read of the same tree discovers nothing", async () => {
+    const root = project();
+    const c = counted(root);
+    const first = await c.read();
+    const second = await c.read();
+    expect(c.discoveries()).toBe(1);
+    expect(second).toEqual(JSON.parse(JSON.stringify(first)));
+  });
+
+  test("an edit, a new file or a commit discovers again", async () => {
+    const root = project();
+    const c = counted(root);
+    await c.read();
+    // A module already imported in this process isn't read again, so only the count is checked.
+    writeFileSync(join(root, "ops", "steward.op.ts"), "export const nothing = 1;\n");
+    await c.read();
+    expect(c.discoveries()).toBe(2);
+    await c.read();
+    expect(c.discoveries()).toBe(2);
+    mkdirSync(join(root, "lib"));
+    writeFileSync(join(root, "lib", "helper.ts"), "export const x = 1;\n");
+    await c.read();
+    expect(c.discoveries()).toBe(3);
+    commitAll(root);
+    await c.read();
+    expect(c.discoveries()).toBe(4);
+  });
+
+  test("an Op file that fails to import is not indexed, so the next read tries again", async () => {
+    const root = project();
+    writeFileSync(join(root, "ops", "broken.op.ts"), "throw new Error('not today');\n");
+    const c = counted(root);
+    expect((await c.read()).errors).toHaveLength(1);
+    expect((await c.read()).errors).toHaveLength(1);
+    expect(c.discoveries()).toBe(2);
+  });
+
+  test("CHANT_STEWARD_INDEX=0 discovers every time", async () => {
+    const root = project();
+    process.env.CHANT_STEWARD_INDEX = "0";
+    const c = counted(root);
+    await c.read();
+    await c.read();
+    expect(c.discoveries()).toBe(2);
+    expect(existsSync(join(cache, "workspace-stewards"))).toBe(false);
+  });
+
+  test("the index lives in the cache dir, never in the checkout", async () => {
+    const root = project();
+    const status = git(root, "status", "--porcelain", "--ignored");
+    await readStewardIndex(root);
+    expect(git(root, "status", "--porcelain", "--ignored")).toBe(status);
+    const [dir] = readdirSync(join(cache, "workspace-stewards"));
+    expect(readdirSync(join(cache, "workspace-stewards", dir)).filter((f) => f.endsWith(".json"))).toHaveLength(1);
+  });
+
+  test("the indexes of a checkout that is gone go on the next write", async () => {
+    const gone = project();
+    await readStewardIndex(gone);
+    rmSync(gone, { recursive: true, force: true });
+    await readStewardIndex(project());
+    expect(readdirSync(join(cache, "workspace-stewards"))).toHaveLength(1);
+  });
+
+  test("status lists the same stewards from the index as from discovery", async () => {
+    const root = project();
+    const now = "2027-01-01T00:00:00Z";
+    process.env.CHANT_STEWARD_INDEX = "0";
+    const discovered = await readMemberStewards(root, "k3d", now);
+    delete process.env.CHANT_STEWARD_INDEX;
+    await readMemberStewards(root, "k3d", now);
+    const indexed = await readMemberStewards(root, "k3d", now, "chant", null, {
+      readIndex: (d) => readStewardIndex(d, { discover: () => Promise.reject(new Error("should have been read from the index")) }),
+    });
+    expect(indexed).toEqual(discovered);
+    expect(indexed.stewards[0]).toMatchObject({ name: "box-steward", form: "fountain", file: "ops/steward.op.ts" });
+  });
+});

package/src/workspace/steward-index.ts

@@ -0,0 +1,226 @@
+/**
+ * What `chant workspace status` reads of a project's stewards and Ops
+ * (#3636), kept per tree so a status doesn't import every `*.op.ts` file
+ * each time it runs.
+ *
+ * Discovery (`../op/discover.ts`) has to import the Op modules, and an Op
+ * module may do work when it is imported: run git, read files, even start
+ * another chant. Status needs only plain fields of what it finds: each
+ * steward's name, file, form, vault, capabilities and Ops, and of each Op
+ * its name, schedule, labels, work lease kind and `changesCheckout`. The
+ * first status on a tree discovers them and writes that index to
+ * `<cache dir>/workspace-stewards/<checkout>/<key>.json`; later ones read
+ * it back, until the tree changes. The cache dir is the one the graph cache
+ * uses (`./graph-cache.ts`): `$CHANT_CACHE_DIR`, else
+ * `$XDG_CACHE_HOME/chant`, else `~/.cache/chant`, outside the workspace,
+ * since a read never changes the workspace it reads.
+ *
+ * The tree is the checkout's `HEAD` tree plus every changed or untracked
+ * file `git status` lists (its path and contents), and the chant version,
+ * so a commit, an edit or a new file anywhere in the checkout discovers
+ * again. Files git ignores (`node_modules`) are not part of it. An index is
+ * only written when every Op file imported, so an import that failed is
+ * tried again by the next status. `CHANT_STEWARD_INDEX=0` turns the index
+ * off, for an Op module whose declaration depends on more than its tree.
+ */
+
+import { execFile } from "node:child_process";
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readdirSync, readFileSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { promisify } from "node:util";
+import { CHANT_VERSION } from "../cli/version";
+import { discoverOps, discoverStewards } from "../op/discover";
+import { stewardBesideOf, type StewardForm } from "../op/steward";
+import type { OpConfig } from "../op/types";
+
+const execFileAsync = promisify(execFile);
+
+/** Bumped when the index's shape changes, so an older index is never read. */
+const INDEX_FORMAT = 1;
+
+/** Where the indexes of the checkout at `top` live, and the checkout's real path. */
+function indexDir(top: string, env: NodeJS.ProcessEnv = process.env): { dir: string; checkout: string } {
+  const base = env.CHANT_CACHE_DIR || join(env.XDG_CACHE_HOME || join(homedir(), ".cache"), "chant");
+  let checkout = resolve(top);
+  try {
+    checkout = realpathSync(checkout);
+  } catch {
+    // Keyed on the path as given.
+  }
+  return { dir: join(base, "workspace-stewards", createHash("sha256").update(checkout).digest("hex").slice(0, 16)), checkout };
+}
+
+/** How many indexes a checkout keeps: the newest, by when they were written. */
+const KEPT = 32;
+
+/** What status reads of an Op. */
+export interface IndexedOp {
+  name: string;
+  schedule: { cron: string } | null;
+  /** Absent when the Op has none. */
+  labels?: Record<string, string>;
+  workLease: { kind: string | null } | null;
+  changesCheckout: boolean;
+}
+
+/** What status reads of a steward. */
+export interface IndexedSteward {
+  name: string;
+  /** The `*.op.ts` file declaring it, absolute. */
+  filePath: string;
+  /** Every Op it runs: its turns' Ops, then those beside them. */
+  ops: IndexedOp[];
+  /** The Ops it runs beside its turns (#2861), and whether each declares a ready step. */
+  beside: { op: string; ready: boolean }[];
+  form: { default: StewardForm; environments: Record<string, StewardForm> };
+  capabilities: string[];
+  vault: string | null;
+}
+
+export interface StewardIndex {
+  /** In discovery's order. */
+  stewards: IndexedSteward[];
+  /** Files that could not be imported. */
+  errors: string[];
+  /** Stewards dropped as second writers. */
+  conflicts: string[];
+  /** The project's Ops that no steward lists, or null when they couldn't be discovered. */
+  otherOps: IndexedOp[] | null;
+}
+
+function indexOp(op: OpConfig): IndexedOp {
+  return {
+    name: op.name,
+    schedule: op.schedule ? { cron: op.schedule.cron } : null,
+    ...(op.labels ? { labels: { ...op.labels } } : {}),
+    workLease: op.workLease ? { kind: op.workLease.kind ?? null } : null,
+    changesCheckout: op.changesCheckout === true,
+  };
+}
+
+/** Discover the stewards and Ops under `memberDir`, importing every Op file. Throws as `discoverStewards` does. */
+export async function discoverStewardIndex(memberDir: string): Promise<StewardIndex> {
+  const { stewards, errors, conflicts } = await discoverStewards({ cwd: memberDir });
+  const listed = [...stewards.values()].map(({ declaration, filePath }) => ({
+    name: declaration.name,
+    filePath,
+    ops: declaration.ops.map(indexOp),
+    beside: stewardBesideOf(declaration).map((b) => ({ op: b.op, ready: b.ready !== null && b.ready !== undefined })),
+    form: { default: declaration.form.default, environments: { ...declaration.form.environments } },
+    capabilities: Array.isArray(declaration.capabilities) ? [...declaration.capabilities] : [],
+    vault: typeof declaration.vault === "string" ? declaration.vault : null,
+  }));
+  let otherOps: IndexedOp[] | null = null;
+  // Only a project with a steward has waits to look for among its other Ops.
+  if (listed.length > 0) {
+    const declared = new Set(listed.flatMap((s) => s.ops.map((op) => op.name)));
+    try {
+      otherOps = [...(await discoverOps({ cwd: memberDir })).ops.values()].map((d) => indexOp(d.config)).filter((op) => !declared.has(op.name));
+    } catch {
+      otherOps = null;
+    }
+  }
+  return { stewards: listed, errors, conflicts, otherOps };
+}
+
+async function git(args: string[], cwd: string): Promise<string> {
+  // A read: `git status` must not take the index lock from a writer.
+  const env = { ...process.env, GIT_OPTIONAL_LOCKS: "0" };
+  const { stdout } = await execFileAsync("git", args, { cwd, env, maxBuffer: 64 * 1024 * 1024 });
+  return stdout;
+}
+
+/**
+ * The key of the tree `memberDir` is in: its `HEAD` tree, each changed or
+ * untracked file's path and contents, the chant version and `memberDir`.
+ * Null outside a checkout, or when git can't say.
+ */
+export async function treeKey(memberDir: string): Promise<{ key: string; dir: string; checkout: string } | null> {
+  try {
+    const top = (await git(["rev-parse", "--show-toplevel"], memberDir)).trim();
+    const head = (await git(["rev-parse", "--verify", "--quiet", "HEAD^{tree}"], top).catch(() => "")).trim();
+    const changed = (await git(["status", "--porcelain=v1", "-z", "--untracked-files=all", "--no-renames"], top))
+      .split("\0")
+      .filter((e) => e.length > 3)
+      .map((e) => e.slice(3))
+      .sort();
+    const h = createHash("sha256");
+    h.update(`${INDEX_FORMAT}\0${CHANT_VERSION}\0${resolve(memberDir)}\0${head}\0`);
+    for (const path of changed) {
+      h.update(`${path}\0`);
+      try {
+        const full = join(top, path);
+        h.update(statSync(full).isFile() ? readFileSync(full) : "dir");
+      } catch {
+        h.update("gone");
+      }
+      h.update("\0");
+    }
+    return { key: h.digest("hex"), ...indexDir(top) };
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Remove all but the {@link KEPT} newest indexes of this checkout, and the
+ * indexes of checkouts that are gone (each directory names its checkout in
+ * its `checkout` file).
+ */
+function prune(dir: string): void {
+  const files = readdirSync(dir)
+    .filter((f) => f.endsWith(".json"))
+    .map((f) => ({ f, at: statSync(join(dir, f)).mtimeMs }))
+    .sort((a, b) => b.at - a.at);
+  for (const { f } of files.slice(KEPT)) rmSync(join(dir, f), { force: true });
+  const parent = dirname(dir);
+  for (const other of readdirSync(parent)) {
+    const at = join(parent, other);
+    if (at === dir) continue;
+    try {
+      if (!existsSync(readFileSync(join(at, "checkout"), "utf-8"))) rmSync(at, { recursive: true, force: true });
+    } catch {
+      // No checkout file, or being written: left alone.
+    }
+  }
+}
+
+function isIndex(v: unknown): v is StewardIndex {
+  const i = v as StewardIndex;
+  return !!i && Array.isArray(i.stewards) && Array.isArray(i.errors) && Array.isArray(i.conflicts) && (i.otherOps === null || Array.isArray(i.otherOps));
+}
+
+/**
+ * The stewards and Ops under `memberDir`: from the index for its tree when
+ * there is one, else discovered and indexed. Throws as `discoverStewards`
+ * does.
+ */
+export async function readStewardIndex(memberDir: string, deps: { discover?: typeof discoverStewardIndex } = {}): Promise<StewardIndex> {
+  const discover = deps.discover ?? discoverStewardIndex;
+  if (process.env.CHANT_STEWARD_INDEX === "0") return discover(memberDir);
+  const tree = await treeKey(memberDir);
+  if (!tree) return discover(memberDir);
+  const file = join(tree.dir, `${tree.key}.json`);
+  try {
+    const kept = JSON.parse(readFileSync(file, "utf-8")) as unknown;
+    if (isIndex(kept)) return kept;
+  } catch {
+    // None yet, or unreadable: discover.
+  }
+  const index = await discover(memberDir);
+  if (index.errors.length === 0) {
+    try {
+      mkdirSync(tree.dir, { recursive: true });
+      writeFileSync(join(tree.dir, "checkout"), tree.checkout);
+      const tmp = `${file}.${process.pid}.tmp`;
+      writeFileSync(tmp, JSON.stringify(index));
+      renameSync(tmp, file);
+      prune(tree.dir);
+    } catch {
+      // A cache dir that can't be written: status still works, discovering each time.
+    }
+  }
+  return index;
+}