@fougere/cli 0.3.0-alpha.0 → 0.5.0-alpha.0

package/dist/completion.js.map

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

package/dist/loader.d.ts

@@ -0,0 +1,11 @@
+import type { Conventions } from '@fougere/core/node';
+/**
+ * The loader every command needs: `alias` is what makes `@fronds/user/entities/User.js`
+ * resolve when one frond names its neighbour, in any command that loads user code.
+ *
+ * Two jitis, because the config is read BEFORE the aliases — it names the scope they are
+ * built from. `reread` drops the module cache: every loader caches by specifier, so a
+ * second boot in one process would be handed what the first one read.
+ */
+export declare function installLoader(root: string, reread?: boolean): Promise<Conventions>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,CActF"}

package/dist/loader.js

@@ -0,0 +1,23 @@
+import { setModuleLoader, loadConfig, resolveConventions, frondAliases, } from '@fougere/core/node';
+/**
+ * The loader every command needs: `alias` is what makes `@fronds/user/entities/User.js`
+ * resolve when one frond names its neighbour, in any command that loads user code.
+ *
+ * Two jitis, because the config is read BEFORE the aliases — it names the scope they are
+ * built from. `reread` drops the module cache: every loader caches by specifier, so a
+ * second boot in one process would be handed what the first one read.
+ */
+export async function installLoader(root, reread = false) {
+    const { createJiti } = await import('jiti');
+    const bare = createJiti(import.meta.url, { interopDefault: true });
+    setModuleLoader((filePath) => bare.import(filePath));
+    const conventions = resolveConventions((await loadConfig(root)).conventions);
+    const jiti = createJiti(import.meta.url, {
+        interopDefault: true,
+        alias: await frondAliases(root, conventions),
+        ...(reread ? { moduleCache: false } : {}),
+    });
+    setModuleLoader((filePath) => jiti.import(filePath));
+    return conventions;
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAAE,UAAU,EAAE,kBAAkB,EAAE,YAAY,GAC9D,MAAM,oBAAoB,CAAC;AAG5B;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,MAAM,GAAG,KAAK;IAC9D,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,eAAe,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAqC,CAAC,CAAC;IAEzF,MAAM,WAAW,GAAG,kBAAkB,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,GAAG,EAAE;QACvC,cAAc,EAAE,IAAI;QACpB,KAAK,EAAE,MAAM,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC;QAC5C,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1C,CAAC,CAAC;IACH,eAAe,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAqC,CAAC,CAAC;IAEzF,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/machine.d.ts

@@ -0,0 +1,16 @@
+/**
+ * A command's machine output — the one shape a pipe reads.
+ *
+ * There is no list of commands here: `json` is declared by an entity like any other
+ * field, so a command that declares it gets the door. The runner used to name `explain`
+ * in an `if`, and `graph --json` announced a flag it then ignored.
+ */
+export declare function machineWanted(raw: Record<string, unknown>): boolean;
+/**
+ * A `Map` serializes to `{}`, so the door converts it rather than each command flattening
+ * its own result: `GraphResult.nodes` is a Map, and `graph --json` would have printed a
+ * report with an empty graph in it.
+ */
+export declare function machineText(value: unknown): string;
+export declare function printMachine(value: unknown): void;
+//# sourceMappingURL=machine.d.ts.map

package/dist/machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine.d.ts","sourceRoot":"","sources":["../src/machine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAElD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAEjD"}

package/dist/machine.js

@@ -0,0 +1,22 @@
+/**
+ * A command's machine output — the one shape a pipe reads.
+ *
+ * There is no list of commands here: `json` is declared by an entity like any other
+ * field, so a command that declares it gets the door. The runner used to name `explain`
+ * in an `if`, and `graph --json` announced a flag it then ignored.
+ */
+export function machineWanted(raw) {
+    return raw.json === true || typeof raw.names === 'string';
+}
+/**
+ * A `Map` serializes to `{}`, so the door converts it rather than each command flattening
+ * its own result: `GraphResult.nodes` is a Map, and `graph --json` would have printed a
+ * report with an empty graph in it.
+ */
+export function machineText(value) {
+    return JSON.stringify(value, (_key, held) => (held instanceof Map ? Object.fromEntries(held) : held), 2);
+}
+export function printMachine(value) {
+    process.stdout.write(machineText(value) + '\n');
+}
+//# sourceMappingURL=machine.js.map

package/dist/machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine.js","sourceRoot":"","sources":["../src/machine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,GAA4B;IACxD,OAAO,GAAG,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC;AAC5D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AAC3G,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;AAClD,CAAC"}

package/dist/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAuCzC,wBAAsB,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAyFjD"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAwCzC,wBAAsB,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAgGjD"}

package/dist/runner.js

@@ -1,7 +1,8 @@
 import { createAppRunner } from '@fougere/core';
-import { registrationKeyOf } from '@fougere/core/contract';
+import { lowerFirst } from '@fougere/core/contract';
 import { defineCommand, runMain } from 'citty';
 import { ui } from './ui.js';
+import { machineWanted } from './machine.js';
 import { entityToArgs } from './bridge.js';
 import { readdir } from 'node:fs/promises';
 import { join } from 'node:path';
@@ -31,7 +32,6 @@ async function loadAppCommands(cliRoot, loader) {
 export async function run(app) {
     const terminal = ui();
     const cliRoot = new URL('..', import.meta.url).pathname;
-    // Load app commands (presentation layer)
     const { createJiti } = await import('jiti');
     const jiti = createJiti(import.meta.url, { interopDefault: true });
     const loader = (path) => jiti.import(path);
@@ -76,9 +76,12 @@ export async function run(app) {
                 },
                 args,
                 run: async ({ args: parsed }) => {
-                    // JSON is a protocol: a branded intro before `{` makes it unparsable. The
-                    // explain command owns its machine output and therefore gets a clean stdout.
-                    const machineOutput = cmdName === 'explain' && parsed.json === true;
+                    // JSON is a protocol: a branded intro before `{` makes it unparsable. Read from
+                    // the invocation's own args, so any command declaring `json` gets a clean stdout
+                    // — naming `explain` here is what let `graph --json` print its decorated box.
+                    const machineOutput = machineWanted(parsed);
+                    // `completion` is exempt by nature, not by flag: its output IS a shell script,
+                    // there is no invocation of it that wants decoration.
                     if (cmdName !== 'completion' && !machineOutput)
                         terminal.intro();
                     // citty adds `_` (raw positionals) and `--` (passthrough); strip them
@@ -93,11 +96,17 @@ export async function run(app) {
                         }
                         else {
                             // Ride the call contract — the same envelope every consumer uses.
-                            await createAppRunner(app)({ entity: registrationKeyOf(entity.name), op: 'execute' }, { params: {}, query: {}, body: input, state: {} });
+                            await createAppRunner(app)({ entity: lowerFirst(entity.name), op: 'execute' }, { params: {}, query: {}, body: input, state: {} });
                         }
                     }
                     catch (err) {
-                        terminal.error(err instanceof Error ? err.message : String(err));
+                        const said = err instanceof Error ? err.message : String(err);
+                        // A machine reader parses stdout: a refusal printed there is a refusal that
+                        // breaks the parse instead of being read. stderr is where it belongs.
+                        if (machineOutput)
+                            process.stderr.write(said + '\n');
+                        else
+                            terminal.error(said);
                         process.exit(1);
                     }
                 },

package/dist/runner.js.map

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

package/fronds/analysis/entities/Build.ts

@@ -1,7 +1,8 @@
-import { entity, text, optional } from "@fougere/schema";
+import { entity, bool, text, optional } from "@fougere/schema";
 
 /** `fougere build` — write down what a scan found, so a deployment reads no disk. */
 export default class Build extends entity({
   root: optional(text({ description: "Project to read. Default: the current directory" })),
   out: optional(text({ description: "Where to write it. Default: .fougere/scan.generated.ts" })),
+  json: bool({ default: false, description: "Print the report as JSON, with nothing else on stdout" }),
 }) {}

package/fronds/analysis/entities/Check.ts

@@ -1,5 +1,6 @@
-import { entity, text } from '@fougere/schema';
+import { entity, bool, text } from '@fougere/schema';
 
 export default class Check extends entity({
   root: text({ description: 'Project root directory (default: cwd)' }),
+  json: bool({ default: false, description: 'Print the report as JSON, with nothing else on stdout' }),
 }) {}

package/fronds/analysis/entities/Devtools.ts

@@ -0,0 +1,8 @@
+import { entity, bool, text, optional } from '@fougere/schema';
+
+/** `fougere devtools` — what the running apps of this project are dispatching. */
+export default class Devtools extends entity({
+  url: optional(text({ description: 'One app to read. Absent: every address this project declares' })),
+  root: optional(text({ description: 'Project to read the addresses from. Default: the current directory' })),
+  json: bool({ default: false, description: 'Print one page as JSON and stop, instead of following' }),
+}) {}

package/fronds/analysis/entities/Explain.ts

@@ -1,8 +1,9 @@
-import { bool, entity, optional, text } from '@fougere/schema';
+import { bool, entity, oneOf, optional, text } from '@fougere/schema';
 
 /** `fougere explain <Operation>` — print the operation contract Fougere will serve. */
 export default class Explain extends entity({
   operation: text({ min: 1, description: 'Operation to inspect (e.g. Post.publish)' }),
   root: optional(text({ description: 'Project to read. Default: the current directory' })),
   json: bool({ default: false, description: 'Print stable machine-readable JSON' }),
+  names: optional(oneOf('operations', 'fronds', { description: 'Print one name per line — what shell completion reads' })),
 }) {}

package/fronds/analysis/entities/Freeze.ts

@@ -1,7 +1,8 @@
-import { entity, text, optional } from "@fougere/schema";
+import { entity, bool, text, optional } from "@fougere/schema";
 
 /** `fougere freeze <version>` — record today's shapes under a name, for good. */
 export default class Freeze extends entity({
   version: text({ min: 1, description: "Name to record these shapes under (e.g. v2)" }),
   root: optional(text({ description: "Project to read. Default: the current directory" })),
+  json: bool({ default: false, description: "Print the report as JSON, with nothing else on stdout" }),
 }) {}

package/fronds/analysis/entities/Graph.ts

@@ -1,6 +1,7 @@
-import { entity, text, number } from '@fougere/schema';
+import { entity, bool, text, number } from '@fougere/schema';
 
 export default class Graph extends entity({
   root: text({ description: 'Project root directory (default: cwd)' }),
   minEntities: number({ default: 6, description: 'Minimum entities before suggesting split' }),
+  json: bool({ default: false, description: 'Print the report as JSON, with nothing else on stdout' }),
 }) {}

package/fronds/analysis/entities/Migrate.ts

@@ -4,4 +4,5 @@ import { entity, bool, optional, text } from "@fougere/schema";
 export default class Migrate extends entity({
   apply: bool({ default: false, description: "Run it. Without this the plan is printed and nothing moves" }),
   root: optional(text({ description: "Project to read. Default: the current directory" })),
+  json: bool({ default: false, description: "Print the report as JSON, with nothing else on stdout" }),
 }) {}

package/fronds/analysis/handlers/BuildHandler.ts

@@ -39,7 +39,8 @@ export default class BuildHandler {
   constructor(private projectScan: ProjectScan) {}
 
   /** Write down what a scan found, so a deployment reads no disk. */
-  async execute(input: Build): Promise<BuildReport> {
+  /** `json` is the presentation's, so it is not part of what this operation receives. */
+  async execute(input: Omit<Build, 'json'>): Promise<BuildReport> {
     const scan = await this.projectScan.at(input.root ?? undefined);
     const out = resolve(scan.root, input.out || DEFAULT_OUT);
 

package/fronds/analysis/handlers/DevtoolsHandler.ts

@@ -0,0 +1,86 @@
+import { createHttpTransport } from '@fougere/transport-http/client';
+import type { CallPage, CallRecord } from '@fougere/core';
+import ProjectScan from '../services/ProjectScan.js';
+
+/** The default address of an app in development — Nuxt, Next and the site all sit there. */
+const LOCAL = 'http://127.0.0.1:3000';
+
+/** One address that was asked, and what came back from it. */
+export interface CallSource {
+  url: string;
+  /** The frond `remotes:` names at this address, when that is where it came from. */
+  frond?: string;
+  cursor: number;
+  inFlight: number;
+  dropped: number;
+  /** Present instead of the numbers when the address did not answer, or serves no log. */
+  refusal?: string;
+}
+
+/**
+ * Every app of this project, read at once.
+ *
+ * A reader pulls: no app registers anywhere, and an app started alone depends on nothing.
+ * The price is knowing the addresses, which the project already states — `remotes:` says
+ * where a call goes, so it also says where the other half of a call can be watched.
+ */
+export interface CallsView {
+  sources: CallSource[];
+  /** Every call, oldest first, each carrying the address it was read from. */
+  calls: (CallRecord & { source: string })[];
+}
+
+export default class DevtoolsHandler {
+  constructor(private projectScan: ProjectScan) {}
+
+  /** Read what the running apps have dispatched since a cursor per address. */
+  async execute(input: { url?: string; root?: string; since?: Record<string, number> }): Promise<CallsView> {
+    const asked = input.url ? [{ url: trimmed(input.url) }] : await this.addresses(input.root);
+    const since = input.since ?? {};
+
+    const read = await Promise.all(asked.map(async (one): Promise<CallSource & { calls: CallRecord[] }> => {
+      try {
+        const page = await createHttpTransport(one.url)(
+          { entity: 'rpc', op: 'calls' },
+          { params: {}, query: {}, body: { since: since[one.url] ?? 0 }, state: {} },
+        ) as CallPage;
+
+        return { ...one, cursor: page.cursor, inFlight: page.inFlight, dropped: page.dropped, calls: page.calls };
+      } catch (err) {
+        // An address that does not answer is a source with a reason, not a missing source:
+        // an app not started and an app without the package are different facts, and both
+        // are worth seeing beside the ones that answered.
+        return { ...one, cursor: since[one.url] ?? 0, inFlight: 0, dropped: 0, calls: [], refusal: said(err) };
+      }
+    }));
+
+    return {
+      sources: read.map(({ calls: _calls, ...source }) => source),
+      calls: read
+        .flatMap(({ url, calls }) => calls.map((call) => ({ ...call, source: url })))
+        .sort((a, b) => a.startedAt - b.startedAt || a.seq - b.seq),
+    };
+  }
+
+  /**
+   * The addresses this project declares, plus the local one.
+   *
+   * `remotes:` is the operator's statement of where a call goes; reading it here is not a
+   * second source of truth, it is the same one read for the other direction.
+   */
+  private async addresses(root?: string): Promise<{ url: string; frond?: string }[]> {
+    const { config } = await this.projectScan.at(root);
+    const remotes = Object.entries(config.remotes ?? {})
+      .map(([frond, url]) => ({ url: trimmed(url), frond }));
+
+    return [{ url: LOCAL }, ...remotes.filter((one) => one.url !== LOCAL)];
+  }
+}
+
+function trimmed(url: string): string {
+  return url.replace(/\/$/, '');
+}
+
+function said(err: unknown): string {
+  return err instanceof Error ? err.message : String(err);
+}

package/fronds/analysis/handlers/ExplainHandler.ts

@@ -5,6 +5,7 @@ import {
 } from '@fougere/core';
 import { relative } from 'node:path';
 import ProjectScan from '../services/ProjectScan.js';
+import { ANONYMOUS_SCHEMA_NAME, lowerFirst, type SchemaView } from '@fougere/schema';
 
 type Cardinality = NonNullable<OperationContract['cardinality']>;
 type Binding = EffectiveOperation['binding'][number];
@@ -60,6 +61,17 @@ export interface ExplainResult {
   };
 }
 
+/** What this project serves, when no single operation was named. */
+export interface ExplainListing {
+  fronds: {
+    name: string;
+    runtime: 'local' | 'remote';
+    remote: string | null;
+    operations: number;
+  }[];
+  operations: string[];
+}
+
 interface Selector {
   frond?: string;
   surface?: string;
@@ -71,17 +83,46 @@ interface Selector {
 export default class ExplainHandler {
   constructor(private projectScan: ProjectScan) {}
 
+  /** The names this project serves — the list `explain` used to spell in a refusal only. */
+  async list(input: { root?: string }): Promise<ExplainListing> {
+    const { scan, model } = await this.modelOf(input.root);
+    const remotes = scan.config.remotes ?? {};
+    const counted = new Map<string, number>();
+    for (const operation of model.operations) {
+      const frond = operation.placement.frond;
+      counted.set(frond, (counted.get(frond) ?? 0) + 1);
+    }
+
+    return {
+      fronds: scan.fronds.map((frond) => ({
+        name: frond.name,
+        runtime: remotes[frond.name] ? 'remote' as const : 'local' as const,
+        remote: remotes[frond.name] ?? null,
+        operations: counted.get(frond.name) ?? 0,
+      })).sort((a, b) => a.name.localeCompare(b.name)),
+      operations: model.operations.map((operation) => operation.id).sort(),
+    };
+  }
+
+  private async modelOf(root?: string) {
+    const scan = await this.projectScan.at(root);
+    return {
+      scan,
+      model: resolveEffectiveOperations(scan.fronds, {
+        diagnostics: scan.diagnostics,
+        remotes: scan.config.remotes,
+        adapters: scan.config.adapters,
+      }),
+    };
+  }
+
+  /** Print the contract one operation will be served under. */
   async execute(input: { operation?: string; root?: string; json?: boolean }): Promise<ExplainResult> {
     const requested = input.operation?.trim();
     if (!requested) throw new Error('Usage: fougere explain <Operation> [--json] [--root <directory>]');
 
     const selector = parseSelector(requested);
-    const scan = await this.projectScan.at(input.root);
-    const model = resolveEffectiveOperations(scan.fronds, {
-      diagnostics: scan.diagnostics,
-      remotes: scan.config.remotes,
-      adapters: scan.config.adapters,
-    });
+    const { scan, model } = await this.modelOf(input.root);
     const candidates = model.operations.filter((operation) => matches(operation, selector));
 
     if (candidates.length === 0) {
@@ -184,7 +225,7 @@ function matches(operation: EffectiveOperation, selector: Selector): boolean {
 
 function addressOf(value: string): string {
   const base = value.endsWith('Handler') ? value.slice(0, -'Handler'.length) : value;
-  return base ? base[0]!.toLowerCase() + base.slice(1) : base;
+  return lowerFirst(base);
 }
 
 function inputTypeOf(operation: EffectiveOperation): string | null {
@@ -197,11 +238,10 @@ function outputOf(operation: EffectiveOperation): ExplainResult['output'] {
   return type ? { type, cardinality: operation.cardinality ?? null } : null;
 }
 
-function schemaName(schema: unknown): string | undefined {
-  const view = schema as { name?: string; source?: { name?: string } } | undefined;
-  if (!view) return undefined;
-  if (view.name && view.name !== 'Schema') return view.name;
-  return view.source?.name;
+function schemaName(schema: SchemaView | undefined): string | undefined {
+  if (!schema) return undefined;
+  if (schema.name && schema.name !== ANONYMOUS_SCHEMA_NAME) return schema.name;
+  return schema.derivation?.sourceName;
 }
 
 function parsedOutput(raw: string | undefined): string | undefined {

package/fronds/analysis/handlers/FreezeHandler.ts

@@ -1,6 +1,6 @@
 import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
-import { describeSet, diffSet, registrationKeyOf, type SchemaBundle, type SetDiff } from '@fougere/schema';
+import { Bundle, lowerFirst, type SchemaBundle, type SchemaView, type SetDiff } from '@fougere/schema';
 import ProjectScan from '../services/ProjectScan.js';
 import { VERSIONS, chainOf } from '../versions.js';
 import type Freeze from '../entities/Freeze.js';
@@ -13,7 +13,7 @@ export interface FreezeInspection {
   /** What the step contains — absent when there is nothing before to step from. */
   step?: SetDiff;
   /** Per entity, the pairs the calculation refuses to decide. Empty means it was written. */
-  ambiguous: Record<string, Array<{ removed: string; added: string }>>;
+  ambiguous: Record<string, { removed: string; added: string }[]>;
   /** Whether anything reached the disk — false while a question stands. */
   written: boolean;
 }
@@ -40,7 +40,8 @@ export default class FreezeHandler {
    * ambiguities and calls again with `renamed`. Splitting it would let a caller write
    * a version it never inspected.
    */
-  async execute(input: Freeze & { renamed?: Record<string, Record<string, string>> }): Promise<FreezeInspection> {
+  /** `json` is the presentation's, so it is not part of what this operation receives. */
+  async execute(input: Omit<Freeze, 'json'> & { renamed?: Record<string, Record<string, string>> }): Promise<FreezeInspection> {
     const fronds = await this.read(input);
     const version = input.version;
     const entities = fronds.flatMap(({ bundle }) => Object.keys(bundle.$defs ?? {}));
@@ -54,7 +55,9 @@ export default class FreezeHandler {
       path,
       bundle,
       previous,
-      step: previous ? diffSet(previous.bundle, bundle, { renamed }) : undefined,
+      step: previous
+        ? Bundle.fromDescriptor(previous.bundle).diff(Bundle.fromDescriptor(bundle), { renamed })
+        : undefined,
     }));
 
     const ambiguous: FreezeInspection['ambiguous'] = {};
@@ -95,14 +98,16 @@ export default class FreezeHandler {
    * `Fronds.schemas()` is deliberately flat — a fact heard in one frond is declared in
    * another — so the per-frond map is built here, where the question IS per frond.
    */
-  private async read(input: Freeze) {
+  private async read(input: Omit<Freeze, 'json'>) {
     const scan = await this.projectScan.at(input.root ?? undefined);
     return Promise.all(
       scan.fronds
         .filter((frond) => frond.entities.length > 0)
         .map(async (frond) => ({
           path: frond.source.path,
-          bundle: describeSet(Object.fromEntries(frond.entities.map((e) => [e.name, e.entityClass]))),
+          bundle: Bundle.fromSchemas(
+            Object.fromEntries(frond.entities.map((e) => [e.name, e.entityClass])),
+          ).descriptor,
           declared: declaredRenames(frond.entities),
           previous: await previousOf(frond.source.path, input.version),
         })),
@@ -114,17 +119,17 @@ type Inspected = { previous?: { name: string }; step?: SetDiff };
 
 /**
  * What the entities state about themselves — `previous` says what a field WAS, while
- * `diff` reads old → new, so the pair is turned around here and nowhere else.
+ * `Bundle.diff` reads old to new, so the pair is turned around here and nowhere else.
  */
 function declaredRenames(
-  entities: ReadonlyArray<{ name: string; entityClass: unknown }>,
+  entities: readonly { name: string; entityClass: unknown }[],
 ): Record<string, Record<string, string>> {
   const out: Record<string, Record<string, string>> = {};
   for (const { name, entityClass } of entities) {
-    const previous = (entityClass as { previous?: Record<string, string> }).previous;
-    // Keyed as `describeSet` keys `$defs`, which is what `diffSet` reads. Spelling the
+    const previous = (entityClass as SchemaView).previous;
+    // Keyed as `Bundle.fromSchemas` keys `$defs`, which is what `Bundle.diff` reads. Spelling the
     // convention a second way here is the defect this repo has already recorded twice.
-    const key = registrationKeyOf(name);
+    const key = lowerFirst(name);
     if (previous) out[key] = Object.fromEntries(Object.entries(previous).map(([now, was]) => [was, now]));
   }
   return out;
@@ -132,12 +137,12 @@ function declaredRenames(
 
 /** Every source of an answer, folded per entity — later sources win field by field. */
 function settled(
-  sources: ReadonlyArray<Record<string, Record<string, string>>>,
+  sources: readonly Record<string, Record<string, string>>[],
   answers: Record<string, Record<string, string>>,
 ): Record<string, Record<string, string>> {
   const out: Record<string, Record<string, string>> = {};
   for (const source of [...sources, answers]) {
-    for (const [entity, pairs] of Object.entries(source)) out[entity] = { ...(out[entity] ?? {}), ...pairs };
+    for (const [entity, pairs] of Object.entries(source)) out[entity] = { ...out[entity], ...pairs };
   }
   return out;
 }

package/fronds/analysis/handlers/MigrateHandler.ts

@@ -31,7 +31,8 @@ export default class MigrateHandler {
   constructor(private projectScan: ProjectScan) {}
 
   /** Realise the frozen steps this database has not caught up with. */
-  async execute(input: Migrate): Promise<MigrationPlan> {
+  /** `json` is the presentation's, so it is not part of what this operation receives. */
+  async execute(input: Omit<Migrate, 'json'>): Promise<MigrationPlan> {
     const scan = await this.projectScan.at(input.root ?? undefined);
     const perFrond = await Promise.all(scan.fronds.map((frond) => stepsOf(frond.source.path)));
     const steps = perFrond.flat();
@@ -77,7 +78,7 @@ export default class MigrateHandler {
 }
 
 /** The versions read, oldest first and each named once however many fronds cut it. */
-function versionsOf(steps: ReadonlyArray<{ version: string }>): string[] {
+function versionsOf(steps: readonly { version: string }[]): string[] {
   return [...new Set(steps.map(({ version }) => version))].sort((a, b) => a.localeCompare(b, 'en', { numeric: true }));
 }
 
@@ -90,7 +91,7 @@ function onSource(step: SetDiff, source: string, sourceOf: (entity: string) => s
 }
 
 /** Every recorded step, oldest first — the chain composes, so it is replayed whole. */
-async function stepsOf(frondPath: string): Promise<Array<{ version: string; step: SetDiff }>> {
+async function stepsOf(frondPath: string): Promise<{ version: string; step: SetDiff }[]> {
   const chain = await chainOf(frondPath);
   // The first version has a shape and no step — there was nothing before it to move from.
   return chain.flatMap(({ name, step }) => (step ? [{ version: name, step }] : []));

package/fronds/scaffold/entities/BuildFrond.ts

@@ -1,5 +1,5 @@
 import { entity, text } from '@fougere/schema';
 
 export default class BuildFrond extends entity({
-  name: text({ description: 'Frond name to build (e.g. blog)' }),
+  frond: text({ description: 'Frond name to build (e.g. blog)' }),
 }) {}

package/fronds/scaffold/entities/Call.ts

@@ -2,5 +2,5 @@ import { entity, text } from "@fougere/schema";
 
 /** `fougere call <entity>.<op> [--field value …]` — invoke one operation, print the result. */
 export default class Call extends entity({
-  target: text({ min: 1, description: "entity.op to invoke (e.g. post.create)" }),
+  operation: text({ min: 1, description: "entity.op to invoke (e.g. post.create)" }),
 }) {}

package/fronds/scaffold/entities/Sync.ts

@@ -1,6 +1,6 @@
 import { entity, text } from '@fougere/schema';
 
 export default class Sync extends entity({
-  name: text({ description: 'Frond name to sync (e.g. blog)' }),
+  frond: text({ description: 'Frond name to sync (e.g. blog)' }),
   from: text({ description: 'Remote URL (e.g. http://blog-service:3000)' }),
 }) {}