@fougere/cli 0.12.5-alpha.0 → 0.13.0-alpha.0

package/dist/fronds/analysis/handlers/ExplainHandler.js

@@ -0,0 +1,157 @@
+import { addressOf, resolveEffectiveOperations, } from '@fougere/core';
+import { relative } from 'node:path';
+import { ANONYMOUS_SCHEMA_NAME } from '@fougere/schema';
+import { remotesOf } from '@fougere/core/node';
+/** Read one operation directly from the model boot and check also consume. */
+export default class ExplainHandler {
+    projectScan;
+    constructor(projectScan) {
+        this.projectScan = projectScan;
+    }
+    /** The names this project serves — the list `explain` used to spell in a refusal only. */
+    async list(input) {
+        const { scan, model } = await this.modelOf(input.root);
+        const remotes = remotesOf(scan.config);
+        const counted = new Map();
+        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' : 'local',
+                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(),
+        };
+    }
+    async modelOf(root) {
+        const scan = await this.projectScan.at(root);
+        return {
+            scan,
+            model: resolveEffectiveOperations(scan.fronds, {
+                diagnostics: scan.diagnostics,
+                remotes: remotesOf(scan.config),
+                adapters: scan.config.adapters,
+            }),
+        };
+    }
+    /** Print the contract one operation will be served under. */
+    async execute(input) {
+        const requested = input.operation?.trim();
+        if (!requested)
+            throw new Error('Usage: fougere explain <Operation> [--json] [--root <directory>]');
+        const selector = parseSelector(requested);
+        const { scan, model } = await this.modelOf(input.root);
+        const candidates = model.operations.filter((operation) => matches(operation, selector));
+        if (candidates.length === 0) {
+            const failed = model.resolutionDiagnostics.find((diagnostic) => diagnostic.subject?.toLowerCase().includes(`.${selector.op.toLowerCase()}`)
+                && diagnostic.subject.toLowerCase().includes(selector.address.toLowerCase()));
+            if (failed)
+                throw new Error(`[${failed.code}] ${failed.message}`);
+            const available = model.operations.map((operation) => operation.id).sort();
+            throw new Error(`Unknown operation '${requested}'. `
+                + (available.length > 0
+                    ? `Available operations: ${available.join(', ')}.`
+                    : 'This project exposes no resolved operation.'));
+        }
+        if (candidates.length > 1) {
+            throw new Error(`Ambiguous operation '${requested}'. Matches: `
+                + `${candidates.map((operation) => operation.id).sort().join(', ')}. `
+                + 'Use one of these qualified names.');
+        }
+        const selected = candidates[0];
+        const invalid = model.resolutionDiagnostics.find((diagnostic) => diagnostic.subject?.startsWith(`${selected.handler.className}.${selected.name}`));
+        if (invalid)
+            throw new Error(`[${invalid.code}] ${invalid.message}`);
+        return project(selected, scan.root);
+    }
+}
+function project(operation, root) {
+    return {
+        operation: operation.operation,
+        handler: {
+            class: operation.implementation.className,
+            address: operation.handler.address,
+            method: operation.implementation.method,
+            file: operation.implementation.filePath
+                ? relative(root, operation.implementation.filePath)
+                : null,
+        },
+        kind: operation.kind,
+        description: operation.description ?? null,
+        input: inputTypeOf(operation),
+        output: outputOf(operation),
+        parameters: operation.parameters.map((parameter) => ({
+            name: parameter.name,
+            type: parameter.type,
+            optional: parameter.optional,
+            nullable: parameter.nullable,
+            undefinable: parameter.undefinable,
+            binding: bindingOf(parameter.binding),
+        })),
+        collectors: operation.collectors.map((collector) => ({
+            typeName: collector.typeName,
+            class: collector.className,
+            file: relative(root, collector.filePath),
+        })),
+        contexts: operation.contexts,
+        semantics: operation.semantics,
+        exposure: operation.exposure,
+        placement: {
+            frond: operation.placement.frond,
+            runtime: operation.placement.runtime,
+            remote: operation.placement.remote ?? null,
+        },
+        reach: operation.reach,
+    };
+}
+function parseSelector(value) {
+    const dot = value.lastIndexOf('.');
+    if (dot <= 0 || dot === value.length - 1) {
+        throw new Error(`Invalid operation '${value}'. Expected '<Handler>.<method>', for example 'Post.publish'.`);
+    }
+    const path = value.slice(0, dot).split('/').filter(Boolean);
+    if (path.length === 0 || path.length > 3) {
+        throw new Error(`Invalid operation '${value}'. Expected 'Post.publish', 'blog/Post.publish', or 'blog/public/Post.publish'.`);
+    }
+    const qualifiers = path.slice(0, -1);
+    return {
+        ...(qualifiers[0] ? { frond: qualifiers[0] } : {}),
+        ...(qualifiers[1] ? { surface: qualifiers[1] } : {}),
+        address: addressOf(path.at(-1)),
+        op: value.slice(dot + 1),
+    };
+}
+function matches(operation, selector) {
+    return operation.handler.address.toLowerCase() === selector.address.toLowerCase()
+        && operation.name === selector.op
+        && (!selector.frond || operation.placement.frond === selector.frond)
+        && (!selector.surface || operation.exposure.surfaces.includes(selector.surface));
+}
+function inputTypeOf(operation) {
+    const body = operation.parameters.find((parameter) => parameter.binding.source.kind === 'input');
+    return body?.type ?? schemaName(operation.input) ?? null;
+}
+function outputOf(operation) {
+    const type = schemaName(operation.output) ?? parsedOutput(operation.signature?.returnType?.raw);
+    return type ? { type, cardinality: operation.cardinality ?? null } : null;
+}
+function schemaName(schema) {
+    if (!schema)
+        return undefined;
+    if (schema.name && schema.name !== ANONYMOUS_SCHEMA_NAME)
+        return schema.name;
+    return schema.derivation?.sourceName;
+}
+function parsedOutput(raw) {
+    if (!raw)
+        return undefined;
+    return raw.startsWith('Promise<') && raw.endsWith('>') ? raw.slice(8, -1) : raw;
+}
+function bindingOf(binding) {
+    return { ...binding.source };
+}
+//# sourceMappingURL=ExplainHandler.js.map

package/dist/fronds/analysis/handlers/ExplainHandler.js.map

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

package/dist/fronds/analysis/handlers/FreezeHandler.d.ts

@@ -0,0 +1,55 @@
+import { type SetDiff } from '@fougere/schema';
+import ProjectScan from '../services/ProjectScan.js';
+import type Freeze from '../entities/Freeze.js';
+export interface FreezeInspection {
+    version: string;
+    /** The version this one follows, or absent when it is the first. */
+    previous?: string;
+    entities: string[];
+    /** 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, {
+        removed: string;
+        added: string;
+    }[]>;
+    /** Whether anything reached the disk — false while a question stands. */
+    written: boolean;
+}
+/**
+ * Freezing a version — the artefact three readers share.
+ *
+ * A snapshot alone loses the INTENT (a field gone plus a field appeared cannot be told
+ * from a rename), and a step alone corrupts in silence. Both are written, and replaying
+ * the step over the previous snapshot must reproduce this one — which is what catches a
+ * missing step or a hand-edited file.
+ *
+ * Nothing is written while an ambiguity stands: the only information the code does not
+ * hold is what the person who made the change meant, and this is the one place asking
+ * for it is justified.
+ */
+export default class FreezeHandler {
+    private projectScan;
+    constructor(projectScan: ProjectScan);
+    /**
+     * Record this version — or report what stops it, having written nothing.
+     *
+     * One op and not two: it is idempotent while it refuses, so a caller settles the
+     * ambiguities and calls again with `renamed`. Splitting it would let a caller write
+     * a version it never inspected.
+     *
+     * `json` is the presentation's, so it is not part of what this operation receives.
+     */
+    execute(input: Omit<Freeze, 'json'> & {
+        renamed?: Record<string, Record<string, string>>;
+    }): Promise<FreezeInspection>;
+    private record;
+    /**
+     * Today's shapes and the version before them, one entry per frond.
+     *
+     * `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 read;
+}
+//# sourceMappingURL=FreezeHandler.d.ts.map

package/dist/fronds/analysis/handlers/FreezeHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FreezeHandler.d.ts","sourceRoot":"","sources":["../../../../fronds/analysis/handlers/FreezeHandler.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0D,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACvG,OAAO,WAAW,MAAM,4BAA4B,CAAC;AAErD,OAAO,KAAK,MAAM,MAAM,uBAAuB,CAAC;AAEhD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,iFAAiF;IACjF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,2FAA2F;IAC3F,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAC;IAChE,yEAAyE;IACzE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,OAAO,aAAa;IACpB,OAAO,CAAC,WAAW;IAA/B,YAAoB,WAAW,EAAE,WAAW,EAAI;IAEhD;;;;;;;;OAQG;IACG,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2C3H;YAEa,MAAM;IAMpB;;;;;OAKG;YACW,IAAI;CAgBnB"}

package/dist/fronds/analysis/handlers/FreezeHandler.js

@@ -0,0 +1,145 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { Bundle, lowerFirst } from '@fougere/schema';
+import { VERSIONS, chainOf } from '../versions.js';
+/**
+ * Freezing a version — the artefact three readers share.
+ *
+ * A snapshot alone loses the INTENT (a field gone plus a field appeared cannot be told
+ * from a rename), and a step alone corrupts in silence. Both are written, and replaying
+ * the step over the previous snapshot must reproduce this one — which is what catches a
+ * missing step or a hand-edited file.
+ *
+ * Nothing is written while an ambiguity stands: the only information the code does not
+ * hold is what the person who made the change meant, and this is the one place asking
+ * for it is justified.
+ */
+export default class FreezeHandler {
+    projectScan;
+    constructor(projectScan) {
+        this.projectScan = projectScan;
+    }
+    /**
+     * Record this version — or report what stops it, having written nothing.
+     *
+     * One op and not two: it is idempotent while it refuses, so a caller settles the
+     * ambiguities and calls again with `renamed`. Splitting it would let a caller write
+     * a version it never inspected.
+     *
+     * `json` is the presentation's, so it is not part of what this operation receives.
+     */
+    async execute(input) {
+        const fronds = await this.read(input);
+        const version = input.version;
+        const entities = fronds.flatMap(({ bundle }) => Object.keys(bundle.$defs ?? {}));
+        // Two entrances, one map: what the entities declare, and what a caller answered.
+        // The answer wins — it is the later word on a question the declaration left open.
+        const renamed = settled(fronds.map(({ declared }) => declared), input.renamed ?? {});
+        // Every frond is inspected before ANY of them writes: a question standing in one
+        // frond must not leave the others recorded, or a second run cuts half a version.
+        const inspected = fronds.map(({ path, bundle, previous }) => ({
+            path,
+            bundle,
+            previous,
+            step: previous
+                ? Bundle.fromDescriptor(previous.bundle).diff(Bundle.fromDescriptor(bundle), { renamed })
+                : undefined,
+        }));
+        const ambiguous = {};
+        for (const { step } of inspected) {
+            for (const [name, answer] of Object.entries(step?.entities ?? {})) {
+                if (answer.ambiguous.length > 0)
+                    ambiguous[name] = answer.ambiguous;
+            }
+        }
+        // Nothing on disk while a question stands. The only information the code does not
+        // hold is what the person who made the change meant.
+        if (Object.keys(ambiguous).length > 0) {
+            return { version, previous: previousName(inspected), entities, step: merge(inspected), ambiguous, written: false };
+        }
+        for (const { path, bundle, previous, step } of inspected) {
+            await this.record(path, version, bundle);
+            if (!previous || !step)
+                continue;
+            // `previous` is recorded rather than re-derived: the chain is a fact of the moment
+            // this version was cut, and a later sort of directory names is not that fact.
+            await writeFile(join(path, VERSIONS, version, 'from.json'), `${JSON.stringify({ previous: previous.name, renamed, ...step }, null, 2)}\n`);
+        }
+        return { version, previous: previousName(inspected), entities, step: merge(inspected), ambiguous: {}, written: true };
+    }
+    async record(root, version, bundle) {
+        const directory = join(root, VERSIONS, version);
+        await mkdir(directory, { recursive: true });
+        await writeFile(join(directory, 'shape.json'), `${JSON.stringify(bundle, null, 2)}\n`);
+    }
+    /**
+     * Today's shapes and the version before them, one entry per frond.
+     *
+     * `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.
+     */
+    async read(input) {
+        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: 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),
+        })));
+    }
+}
+/**
+ * What the entities state about themselves — `previous` says what a field WAS, while
+ * `Bundle.diff` reads old to new, so the pair is turned around here and nowhere else.
+ */
+function declaredRenames(entities) {
+    const out = {};
+    for (const { name, entityClass } of entities) {
+        const previous = entityClass.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 = lowerFirst(name);
+        if (previous)
+            out[key] = Object.fromEntries(Object.entries(previous).map(([now, was]) => [was, now]));
+    }
+    return out;
+}
+/** Every source of an answer, folded per entity — later sources win field by field. */
+function settled(sources, answers) {
+    const out = {};
+    for (const source of [...sources, answers]) {
+        for (const [entity, pairs] of Object.entries(source))
+            out[entity] = { ...out[entity], ...pairs };
+    }
+    return out;
+}
+/** The version every frond steps from. They are cut together, so they agree. */
+function previousName(inspected) {
+    return inspected.find(({ previous }) => previous)?.previous?.name;
+}
+/**
+ * One report out of several fronds — entity names are unique across a scan, so the
+ * union loses nothing. Writing stays per frond; only the telling is gathered.
+ */
+function merge(inspected) {
+    const steps = inspected.map(({ step }) => step).filter((step) => Boolean(step));
+    if (steps.length === 0)
+        return undefined;
+    return {
+        entities: Object.assign({}, ...steps.map((step) => step.entities)),
+        entitiesAdded: steps.flatMap((step) => step.entitiesAdded),
+        entitiesRemoved: steps.flatMap((step) => step.entitiesRemoved),
+    };
+}
+/** The version this one steps from: the tip of the chain, the links read rather than sorted. */
+async function previousOf(root, version) {
+    const chain = (await chainOf(root)).filter((cut) => cut.name !== version);
+    const last = chain.at(-1)?.name;
+    if (!last)
+        return undefined;
+    const raw = await readFile(join(root, VERSIONS, last, 'shape.json'), 'utf8').catch(() => undefined);
+    return raw ? { name: last, bundle: JSON.parse(raw) } : undefined;
+}
+//# sourceMappingURL=FreezeHandler.js.map

package/dist/fronds/analysis/handlers/FreezeHandler.js.map

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

package/dist/fronds/analysis/handlers/GraphHandler.d.ts

@@ -0,0 +1,23 @@
+import { type DeclaredTopology, type EntityNode, type DomainCluster } from '@fougere/core';
+import ProjectScan from '../services/ProjectScan.js';
+export interface GraphResult {
+    /** How many fronds the scan found — the descriptors themselves hold classes, which no
+     * operation answers: a reader outside this process would receive the husk JSON makes of them. */
+    totalFronds: number;
+    /** Where the fronds run and which reaches which — the same picture, one altitude up. */
+    declared: DeclaredTopology;
+    nodes: Record<string, EntityNode>;
+    clusters: DomainCluster[];
+    totalEntities: number;
+    totalRefs: number;
+}
+export default class GraphHandler {
+    private projectScan;
+    constructor(projectScan: ProjectScan);
+    /** Report how a workspace's fronds and entities reference each other. */
+    execute(input: {
+        root?: string;
+        minEntities?: number;
+    }): Promise<GraphResult>;
+}
+//# sourceMappingURL=GraphHandler.d.ts.map

package/dist/fronds/analysis/handlers/GraphHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphHandler.d.ts","sourceRoot":"","sources":["../../../../fronds/analysis/handlers/GraphHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAC3D,MAAM,eAAe,CAAC;AACvB,OAAO,WAAW,MAAM,4BAA4B,CAAC;AAGrD,MAAM,WAAW,WAAW;IAC1B;qGACiG;IACjG,WAAW,EAAE,MAAM,CAAC;IACpB,wFAAwF;IACxF,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,CAAC,OAAO,OAAO,YAAY;IACnB,OAAO,CAAC,WAAW;IAA/B,YAAoB,WAAW,EAAE,WAAW,EAAI;IAEhD,yEAAyE;IACnE,OAAO,CAAC,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAalF;CACF"}

package/dist/fronds/analysis/handlers/GraphHandler.js

@@ -0,0 +1,23 @@
+import { buildGraph, declaredTopologyOf, suggestSplit, } from '@fougere/core';
+import { remotesOf } from '@fougere/core/node';
+export default class GraphHandler {
+    projectScan;
+    constructor(projectScan) {
+        this.projectScan = projectScan;
+    }
+    /** Report how a workspace's fronds and entities reference each other. */
+    async execute(input) {
+        const { fronds, config } = await this.projectScan.at(input.root);
+        const nodes = buildGraph(fronds);
+        const clusters = suggestSplit(nodes);
+        return {
+            totalFronds: fronds.length,
+            declared: declaredTopologyOf({ fronds, remotes: remotesOf(config) }),
+            nodes: Object.fromEntries(nodes),
+            clusters,
+            totalEntities: nodes.size,
+            totalRefs: [...nodes.values()].reduce((sum, n) => sum + n.refs.length, 0),
+        };
+    }
+}
+//# sourceMappingURL=GraphHandler.js.map

package/dist/fronds/analysis/handlers/GraphHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphHandler.js","sourceRoot":"","sources":["../../../../fronds/analysis/handlers/GraphHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAAE,kBAAkB,EAAE,YAAY,GAE7C,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAc/C,MAAM,CAAC,OAAO,OAAO,YAAY;IACX,WAAW;IAA/B,YAAoB,WAAwB;2BAAxB,WAAW;IAAgB,CAAC;IAEhD,yEAAyE;IACzE,KAAK,CAAC,OAAO,CAAC,KAA8C;QAC1D,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjE,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAErC,OAAO;YACL,WAAW,EAAE,MAAM,CAAC,MAAM;YAC1B,QAAQ,EAAE,kBAAkB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACpE,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC;YAChC,QAAQ;YACR,aAAa,EAAE,KAAK,CAAC,IAAI;YACzB,SAAS,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;SAC1E,CAAC;IACJ,CAAC;CACF"}

package/dist/fronds/analysis/handlers/LoadHandler.d.ts

@@ -0,0 +1,26 @@
+import ProjectScan from '../services/ProjectScan.js';
+export interface LoadScenario {
+    /** Where it was written, or `null` when it was only printed. */
+    file: string | null;
+    facade: string;
+    /** Every operation the scenario calls, in the order it lists them. */
+    operations: string[];
+    script: string;
+}
+/**
+ * A load scenario, written from what the project serves.
+ *
+ * Read from the SCAN rather than a boot: an app that boots runs its migrations and plants its
+ * seeds, and a command that describes a project has no business writing to its database.
+ */
+export default class LoadHandler {
+    private projectScan;
+    constructor(projectScan: ProjectScan);
+    /** Generate a k6 scenario covering every operation the default facade answers. */
+    execute(input: {
+        root?: string;
+        facade?: string;
+        out?: string;
+    }): Promise<LoadScenario>;
+}
+//# sourceMappingURL=LoadHandler.d.ts.map

package/dist/fronds/analysis/handlers/LoadHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoadHandler.d.ts","sourceRoot":"","sources":["../../../../fronds/analysis/handlers/LoadHandler.ts"],"names":[],"mappings":"AAGA,OAAO,WAAW,MAAM,4BAA4B,CAAC;AAGrD,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,WAAW;IAClB,OAAO,CAAC,WAAW;IAA/B,YAAoB,WAAW,EAAE,WAAW,EAAI;IAEhD,kFAAkF;IAC5E,OAAO,CAAC,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAiB5F;CACF"}

package/dist/fronds/analysis/handlers/LoadHandler.js

@@ -0,0 +1,35 @@
+import { loadScript, reachableOps } from '@fougere/testing/load';
+import { writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { remotesOf } from '@fougere/core/node';
+/**
+ * A load scenario, written from what the project serves.
+ *
+ * Read from the SCAN rather than a boot: an app that boots runs its migrations and plants its
+ * seeds, and a command that describes a project has no business writing to its database.
+ */
+export default class LoadHandler {
+    projectScan;
+    constructor(projectScan) {
+        this.projectScan = projectScan;
+    }
+    /** Generate a k6 scenario covering every operation the default facade answers. */
+    async execute(input) {
+        const { root, fronds, config } = await this.projectScan.at(input.root);
+        const facade = input.facade?.trim() || undefined;
+        // The topology statement travels with it: an op that crosses a process is not held to the
+        // same figure as one that never leaves, and `remotes:` is what says which is which.
+        const remotes = remotesOf(config);
+        const script = loadScript({ fronds }, { ...(facade ? { facade } : {}), remotes });
+        const file = input.out === undefined ? join(root, 'load.js') : input.out || null;
+        if (file)
+            await writeFile(file, script, 'utf8');
+        return {
+            file,
+            facade: facade ?? 'http://127.0.0.1:3000/_fougere/call',
+            operations: reachableOps({ fronds }, {}, remotes).map((one) => one.method),
+            script,
+        };
+    }
+}
+//# sourceMappingURL=LoadHandler.js.map

package/dist/fronds/analysis/handlers/LoadHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoadHandler.js","sourceRoot":"","sources":["../../../../fronds/analysis/handlers/LoadHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAW/C;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,WAAW;IACV,WAAW;IAA/B,YAAoB,WAAwB;2BAAxB,WAAW;IAAgB,CAAC;IAEhD,kFAAkF;IAClF,KAAK,CAAC,OAAO,CAAC,KAAuD;QACnE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;QACjD,0FAA0F;QAC1F,oFAAoF;QACpF,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAElF,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;QACjF,IAAI,IAAI;YAAE,MAAM,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAEhD,OAAO;YACL,IAAI;YACJ,MAAM,EAAE,MAAM,IAAI,qCAAqC;YACvD,UAAU,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC;YAC1E,MAAM;SACP,CAAC;IACJ,CAAC;CACF"}

package/dist/fronds/analysis/handlers/MigrateHandler.d.ts

@@ -0,0 +1,34 @@
+import type { Plan, StepChange } from '@fougere/adapter-sql';
+import ProjectScan from '../services/ProjectScan.js';
+import type Migrate from '../entities/Migrate.js';
+export interface MigrationPlan {
+    /** Versions whose step was read, oldest first. */
+    chain: string[];
+    changes: StepChange[];
+    refusals: Plan['refusals'];
+    /** The statements actually run — empty unless `apply` was asked for. */
+    ran: string[];
+}
+/**
+ * Catching the database up with the frozen chain.
+ *
+ * Every step is replayed in order and what has already happened is SKIPPED, read off the
+ * columns themselves rather than a ledger of applied migrations. That is what makes the
+ * chain safe to replay whole: nothing here has to know which version the database sits
+ * at, and a column renamed by hand is seen rather than contradicted.
+ *
+ * The additive pass is not repeated here — a boot already creates missing tables and
+ * columns. What this adds is the half that touches live data, and only what a human
+ * declared at `fougere freeze`.
+ */
+export default class MigrateHandler {
+    private projectScan;
+    constructor(projectScan: ProjectScan);
+    /**
+     * Realise the frozen steps this database has not caught up with.
+     *
+     * `json` is the presentation's, so it is not part of what this operation receives.
+     */
+    execute(input: Omit<Migrate, 'json'>): Promise<MigrationPlan>;
+}
+//# sourceMappingURL=MigrateHandler.d.ts.map

package/dist/fronds/analysis/handlers/MigrateHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MigrateHandler.d.ts","sourceRoot":"","sources":["../../../../fronds/analysis/handlers/MigrateHandler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,WAAW,MAAM,4BAA4B,CAAC;AAErD,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3B,wEAAwE;IACxE,GAAG,EAAE,MAAM,EAAE,CAAC;CACf;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,OAAO,cAAc;IACrB,OAAO,CAAC,WAAW;IAA/B,YAAoB,WAAW,EAAE,WAAW,EAAI;IAEhD;;;;OAIG;IACG,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAmDlE;CACF"}