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

package/dist/fronds/scaffold/handlers/CallHandler.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The client end lives in app/commands/CallCommand (it boots the project app
+ * and drives one operation). This handler exists only so the runner registers
+ * the `call` subcommand.
+ */
+export default class CallHandler {
+    /** Invoke one operation of a frond from the terminal. */
+    execute(): Promise<void>;
+}
+//# sourceMappingURL=CallHandler.d.ts.map

package/dist/fronds/scaffold/handlers/CallHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CallHandler.d.ts","sourceRoot":"","sources":["../../../../fronds/scaffold/handlers/CallHandler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,WAAW;IAC9B,yDAAyD;IACnD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;CAClC"}

package/{fronds/scaffold/handlers/CallHandler.ts → dist/fronds/scaffold/handlers/CallHandler.js}

@@ -4,6 +4,7 @@
  * the `call` subcommand.
  */
 export default class CallHandler {
-  /** Invoke one operation of a frond from the terminal. */
-  async execute(): Promise<void> {}
+    /** Invoke one operation of a frond from the terminal. */
+    async execute() { }
 }
+//# sourceMappingURL=CallHandler.js.map

package/dist/fronds/scaffold/handlers/CallHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CallHandler.js","sourceRoot":"","sources":["../../../../fronds/scaffold/handlers/CallHandler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,WAAW;IAC9B,yDAAyD;IACzD,KAAK,CAAC,OAAO,KAAmB,CAAC;CAClC"}

package/dist/fronds/scaffold/handlers/CompletionHandler.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The completion script is produced by CompletionCommand (it holds the app and
+ * prints it). This handler exists only so the runner registers the subcommand.
+ */
+export default class CompletionHandler {
+    /** Print the shell completion script for this CLI. */
+    execute(): Promise<void>;
+}
+//# sourceMappingURL=CompletionHandler.d.ts.map

package/dist/fronds/scaffold/handlers/CompletionHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompletionHandler.d.ts","sourceRoot":"","sources":["../../../../fronds/scaffold/handlers/CompletionHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,iBAAiB;IACpC,sDAAsD;IAChD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;CAClC"}

package/{fronds/scaffold/handlers/CompletionHandler.ts → dist/fronds/scaffold/handlers/CompletionHandler.js}

@@ -3,6 +3,7 @@
  * prints it). This handler exists only so the runner registers the subcommand.
  */
 export default class CompletionHandler {
-  /** Print the shell completion script for this CLI. */
-  async execute(): Promise<void> {}
+    /** Print the shell completion script for this CLI. */
+    async execute() { }
 }
+//# sourceMappingURL=CompletionHandler.js.map

package/dist/fronds/scaffold/handlers/CompletionHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompletionHandler.js","sourceRoot":"","sources":["../../../../fronds/scaffold/handlers/CompletionHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,iBAAiB;IACpC,sDAAsD;IACtD,KAAK,CAAC,OAAO,KAAmB,CAAC;CAClC"}

package/dist/fronds/scaffold/handlers/GrantHandler.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The work lives in app/commands/GrantCommand (it prints secrets). This handler
+ * exists only so the runner registers the `grant` subcommand.
+ */
+export default class GrantHandler {
+    /** Bind a frond's name to a fresh key, signed by the root. */
+    execute(): Promise<void>;
+}
+//# sourceMappingURL=GrantHandler.d.ts.map

package/dist/fronds/scaffold/handlers/GrantHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GrantHandler.d.ts","sourceRoot":"","sources":["../../../../fronds/scaffold/handlers/GrantHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,YAAY;IAC/B,8DAA8D;IACxD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;CAClC"}

package/{fronds/scaffold/handlers/GrantHandler.ts → dist/fronds/scaffold/handlers/GrantHandler.js}

@@ -3,6 +3,7 @@
  * exists only so the runner registers the `grant` subcommand.
  */
 export default class GrantHandler {
-  /** Bind a frond's name to a fresh key, signed by the root. */
-  async execute(): Promise<void> {}
+    /** Bind a frond's name to a fresh key, signed by the root. */
+    async execute() { }
 }
+//# sourceMappingURL=GrantHandler.js.map

package/dist/fronds/scaffold/handlers/GrantHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GrantHandler.js","sourceRoot":"","sources":["../../../../fronds/scaffold/handlers/GrantHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,YAAY;IAC/B,8DAA8D;IAC9D,KAAK,CAAC,OAAO,KAAmB,CAAC;CAClC"}

package/dist/fronds/scaffold/handlers/KeysHandler.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The work lives in app/commands/KeysCommand (it writes the root key). This
+ * handler exists only so the runner registers the `keys` subcommand.
+ */
+export default class KeysHandler {
+    /** Create the root key a split deployment's grants are signed by. */
+    execute(): Promise<void>;
+}
+//# sourceMappingURL=KeysHandler.d.ts.map

package/dist/fronds/scaffold/handlers/KeysHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeysHandler.d.ts","sourceRoot":"","sources":["../../../../fronds/scaffold/handlers/KeysHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,WAAW;IAC9B,qEAAqE;IAC/D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;CAClC"}

package/{fronds/scaffold/handlers/KeysHandler.ts → dist/fronds/scaffold/handlers/KeysHandler.js}

@@ -3,6 +3,7 @@
  * handler exists only so the runner registers the `keys` subcommand.
  */
 export default class KeysHandler {
-  /** Create the root key a split deployment's grants are signed by. */
-  async execute(): Promise<void> {}
+    /** Create the root key a split deployment's grants are signed by. */
+    async execute() { }
 }
+//# sourceMappingURL=KeysHandler.js.map

package/dist/fronds/scaffold/handlers/KeysHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeysHandler.js","sourceRoot":"","sources":["../../../../fronds/scaffold/handlers/KeysHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,WAAW;IAC9B,qEAAqE;IACrE,KAAK,CAAC,OAAO,KAAmB,CAAC;CAClC"}

package/dist/fronds/scaffold/handlers/NewHandler.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The guided flow lives in app/commands/NewCommand (it prompts and composes).
+ * This handler exists only so the runner registers the `new` subcommand.
+ */
+export default class NewHandler {
+    /** Create a Fougere workspace. */
+    execute(): Promise<void>;
+}
+//# sourceMappingURL=NewHandler.d.ts.map

package/dist/fronds/scaffold/handlers/NewHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NewHandler.d.ts","sourceRoot":"","sources":["../../../../fronds/scaffold/handlers/NewHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,UAAU;IAC7B,kCAAkC;IAC5B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;CAClC"}

package/{fronds/scaffold/handlers/NewHandler.ts → dist/fronds/scaffold/handlers/NewHandler.js}

@@ -3,6 +3,7 @@
  * This handler exists only so the runner registers the `new` subcommand.
  */
 export default class NewHandler {
-  /** Create a Fougere project, workspace or flat. */
-  async execute(): Promise<void> {}
+    /** Create a Fougere workspace. */
+    async execute() { }
 }
+//# sourceMappingURL=NewHandler.js.map

package/dist/fronds/scaffold/handlers/NewHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NewHandler.js","sourceRoot":"","sources":["../../../../fronds/scaffold/handlers/NewHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,UAAU;IAC7B,kCAAkC;IAClC,KAAK,CAAC,OAAO,KAAmB,CAAC;CAClC"}

package/dist/fronds/scaffold/handlers/ServeHandler.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The host lives in app/commands/ServeCommand (it boots the frond alone and
+ * exposes it over HTTP). This handler exists only so the runner registers the
+ * `serve` subcommand.
+ */
+export default class ServeHandler {
+    /** Host a frond in its own process, behind JSON-RPC. */
+    execute(): Promise<void>;
+}
+//# sourceMappingURL=ServeHandler.d.ts.map

package/dist/fronds/scaffold/handlers/ServeHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServeHandler.d.ts","sourceRoot":"","sources":["../../../../fronds/scaffold/handlers/ServeHandler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,YAAY;IAC/B,wDAAwD;IAClD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;CAClC"}

package/{fronds/scaffold/handlers/ServeHandler.ts → dist/fronds/scaffold/handlers/ServeHandler.js}

@@ -4,6 +4,7 @@
  * `serve` subcommand.
  */
 export default class ServeHandler {
-  /** Host a frond in its own process, behind JSON-RPC. */
-  async execute(): Promise<void> {}
+    /** Host a frond in its own process, behind JSON-RPC. */
+    async execute() { }
 }
+//# sourceMappingURL=ServeHandler.js.map

package/dist/fronds/scaffold/handlers/ServeHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServeHandler.js","sourceRoot":"","sources":["../../../../fronds/scaffold/handlers/ServeHandler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,YAAY;IAC/B,wDAAwD;IACxD,KAAK,CAAC,OAAO,KAAmB,CAAC;CAClC"}

package/dist/fronds/scaffold/handlers/SyncHandler.d.ts

@@ -0,0 +1,18 @@
+export declare function entityClassName(name: string): string;
+export default class SyncHandler {
+    private cwd;
+    /** Mirror a remote frond's contract into local entities. */
+    execute(input: {
+        frond: string;
+        from: string;
+    }): Promise<{
+        path: string;
+        entities: string[];
+        removed: string[];
+    }>;
+    /** Delete the files this run did not write — and only the ones sync itself produced. */
+    private prune;
+    /** Write/update .fougere/remotes.json — read by @fougere/nuxt for auto-aliasing. */
+    private updateRemotesRegistry;
+}
+//# sourceMappingURL=SyncHandler.d.ts.map

package/dist/fronds/scaffold/handlers/SyncHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SyncHandler.d.ts","sourceRoot":"","sources":["../../../../fronds/scaffold/handlers/SyncHandler.ts"],"names":[],"mappings":"AAyCA,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYpD;AAyDD,MAAM,CAAC,OAAO,OAAO,WAAW;IAE9B,OAAO,CAAC,GAAG,CAAiB;IAE5B,4DAA4D;IACtD,OAAO,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAqMtH;IAED,wFAAwF;IACxF,OAAO,CAAC,KAAK;IAeb,oFAAoF;IACpF,OAAO,CAAC,qBAAqB;CAmB9B"}

package/dist/fronds/scaffold/handlers/SyncHandler.js

@@ -0,0 +1,327 @@
+import { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { upperFirst } from '@fougere/schema';
+import { EntityTypes } from '../../../src/typescript/EntityTypes.js';
+import { FacadeTypes } from '../../../src/typescript/FacadeTypes.js';
+// The card's shape is declared once, in core, and imported here. A private copy of it
+// lived in this file and went stale the day an op stopped being a bare name: nothing
+// compared the copy to the original, so the drift cost nothing until someone read it.
+import { assertIdentityCard } from '@fougere/core';
+import { resolveConventions, frondPackage } from '@fougere/core';
+import { loadConfig } from '@fougere/core/node';
+import { facadeModule } from '@fougere/compiler';
+import { ErrorCode } from '@fougere/core/contract';
+/**
+ * A union of enum MEMBERS, from what the card said this operation refuses.
+ *
+ * `ErrorCode` is a string enum, so `'CONFLICT'` is not assignable to it: a literal reads as the
+ * right thing and then refuses to narrow `FougereError<Code>`, which is the whole point. A code
+ * this version does not know is dropped rather than written — the far side may be newer, and a
+ * name that resolves to nothing would stop the consumer's build.
+ */
+function codesOf(errors) {
+    const known = (errors ?? []).filter((code) => code in ErrorCode);
+    if (known.length === 0)
+        return 'never';
+    return known.map((code) => `ErrorCode.${code}`).join(' | ');
+}
+function assertSafeName(kind, name) {
+    if (typeof name !== 'string' || !/^[A-Za-z_$][A-Za-z0-9_$-]*$/.test(name)) {
+        throw new Error(`Invalid ${kind} name '${name}' received from remote`);
+    }
+}
+/**
+ * The line every generated file carries. It is what makes pruning safe: sync removes what
+ * IT wrote and nothing else, so a file a human dropped into the folder survives.
+ */
+const GENERATED = 'Generated by `fougere sync`';
+export function entityClassName(name) {
+    assertSafeName('entity', name);
+    const identifier = name
+        .split('-')
+        .filter(Boolean)
+        .map(upperFirst)
+        .join('');
+    if (!/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(identifier)) {
+        throw new Error(`Entity name '${name}' cannot be represented as a TypeScript identifier`);
+    }
+    return identifier;
+}
+/**
+ * One entry — a facade or a fact — validated the same way, because sync consumes the same two
+ * values from both: a name it can turn into a class, and a descriptor it can rebuild.
+ *
+ * A missing descriptor is legal on either side and means different things: a facade that
+ * stores nothing (a health check, a search across shapes), or a fact whose announced type
+ * is not a declared entity. Neither produces a row class, and demanding one here refused
+ * the WHOLE card over a single entry.
+ */
+function assertEntry(kind, frondName, entry) {
+    if (!entry || typeof entry !== 'object') {
+        throw new Error(`Remote frond '${frondName}' contains an invalid ${kind} entry`);
+    }
+    assertSafeName(kind, entry.name);
+    if (entry.schema === undefined)
+        return;
+    // `ops` is not checked because it is not used: sync writes entities, and the name
+    // and the descriptor below are the only two values that reach a file. The clause
+    // that stood here demanded strings — the shape ops had before they carried their
+    // kind and their views — and so refused every real host. Validate what you consume.
+    const descriptor = entry.schema;
+    if (!descriptor
+        || typeof descriptor !== 'object'
+        || Array.isArray(descriptor)
+        || descriptor.type !== 'object'
+        || !descriptor.properties
+        || typeof descriptor.properties !== 'object'
+        || Array.isArray(descriptor.properties)
+        || descriptor['x-fougere-version'] !== 1
+        || descriptor['x-fougere-vendor'] !== 'fougere') {
+        throw new Error(`Remote ${kind} '${entry.name}' has no valid schema descriptor`);
+    }
+}
+function identityCardOf(value) {
+    // The card's own shape is validated by the package that declares it — `fronds`, and each
+    // frond's `facades`. What stays here is what only a writer of files needs: a name safe to
+    // become one, and the descriptor a class is generated from.
+    const card = assertIdentityCard(value, 'Remote rpc.discover');
+    for (const frond of card.fronds) {
+        assertSafeName('frond', frond.name);
+        // Absent rather than empty is tolerated: a host older than the fact list says nothing
+        // about facts, and refusing it would break sync against every previous version for a
+        // feature the consumer may not use.
+        if (frond.facts !== undefined && !Array.isArray(frond.facts)) {
+            throw new Error(`Remote frond '${frond.name}' has no valid facts array`);
+        }
+        for (const facade of frond.facades)
+            assertEntry('facade', frond.name, facade);
+        for (const fact of frond.facts ?? [])
+            assertEntry('fact', frond.name, fact);
+    }
+    return card;
+}
+export default class SyncHandler {
+    // cwd is ambient in a CLI — not a DI service (the container resolves by type).
+    cwd = process.cwd();
+    /** Mirror a remote frond's contract into local entities. */
+    async execute(input) {
+        assertSafeName('frond', input.frond);
+        let remoteUrl;
+        try {
+            remoteUrl = new URL(input.from);
+        }
+        catch {
+            throw new Error(`Invalid remote URL '${input.from}'`);
+        }
+        if (remoteUrl.protocol !== 'http:' && remoteUrl.protocol !== 'https:') {
+            throw new Error(`Remote URL must use http or https, got '${remoteUrl.protocol}'`);
+        }
+        const baseUrl = remoteUrl.toString().replace(/\/$/, '');
+        // The served frond answers `rpc.discover` on its call endpoint with its
+        // identity card — the same surface every consumer reads, no side endpoint.
+        const res = await fetch(`${baseUrl}/_fougere/call`, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'rpc.discover', params: { params: {}, query: {}, state: {} } }),
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (!res.ok) {
+            throw new Error(`Failed to reach ${baseUrl}/_fougere/call: ${res.status} ${res.statusText}`);
+        }
+        const rpc = (await res.json());
+        if (rpc.error)
+            throw new Error(`Remote error: ${rpc.error.message}`);
+        const card = identityCardOf(rpc.result);
+        const target = card.fronds.find((f) => f.name === input.frond);
+        if (!target) {
+            throw new Error(`Frond '${input.frond}' not found on ${baseUrl}. Available: ${card.fronds.map((f) => f.name).join(', ')}`);
+        }
+        // The consumer's own convention: a synced frond is laid out like the ones they wrote,
+        // and the export map below is what makes `@fronds/<name>/<dir>/X.js` resolve.
+        const conventions = resolveConventions((await loadConfig(this.cwd)).conventions);
+        const entities = conventions.dirs.entities;
+        const handlers = conventions.dirs.handlers;
+        const frondDir = join(this.cwd, '.fougere', 'remotes', input.frond);
+        const entitiesDir = join(frondDir, entities);
+        const handlersDir = join(frondDir, handlers);
+        mkdirSync(entitiesDir, { recursive: true });
+        mkdirSync(handlersDir, { recursive: true });
+        /**
+         * What was written under each name — the barrel below is a projection of exactly this.
+         *
+         * Three combinations, and all three occur: a facade with rows behind it (both files), a
+         * facade with none (the façade type alone), and a fact (the row class alone, because
+         * nothing calls a fact).
+         */
+        const generated = new Map();
+        /** Absolute paths written by THIS run — anything else generated here is now stale. */
+        const written = new Set();
+        const claim = (name) => {
+            const className = entityClassName(name);
+            if (generated.has(className))
+                throw new Error(`Remote declares duplicate entity '${className}'`);
+            generated.set(className, { row: false, facade: false });
+            return className;
+        };
+        /**
+         * One card, one class.
+         *
+         * `Card.toSchema` gives the JUDGE — validate, from, getFields — and now takes the
+         * row shape as a type argument, so the same declaration gives the TYPE. Both
+         * come off the same card: nothing to keep in step, and the file a consumer reads
+         * has the shape of the one they would have written by hand
+         * (`class Post extends entity({…}) {}`).
+         */
+        const writeRow = (className, descriptor) => {
+            written.add(join(entitiesDir, `${className}.ts`));
+            writeFileSync(join(entitiesDir, `${className}.ts`), [
+                `import { Card } from '@fougere/schema';`,
+                ``,
+                `// Generated by \`fougere sync\` from ${baseUrl} — do not edit.`,
+                EntityTypes.of(descriptor).render({ name: className }),
+                ``,
+                `export default ${className};`,
+                ``,
+            ].join('\n'));
+            generated.get(className).row = true;
+        };
+        /** What the card says of each address — the same three facts a scan gives. */
+        const served = [];
+        for (const { name, schema: descriptor, ops } of target.facades) {
+            const className = claim(name);
+            generated.get(className).facade = true;
+            served.push({
+                at: name,
+                handler: `import('./${handlers}/${className}Handler.js').${className}Handler`,
+                ops: (ops ?? []).map((op) => ({ name: op.name, codes: codesOf(op.errors) })),
+            });
+            // No shape behind this facade: its operations still travel, its rows do not exist.
+            // `rowType` falls back to `unknown`, which is the truth rather than an empty class.
+            if (descriptor !== undefined)
+                writeRow(className, descriptor);
+            /**
+             * The facade's type, next to the row's — what `Facade<T>` needs and what nothing
+             * carried across a repository boundary.
+             *
+             * Writing `Facade<ArticleHandler>` used to require importing the handler's class.
+             * `sync` does not ship handlers and should not: a handler is behaviour with state,
+             * and behaviour does not travel. Its OPERATIONS do — the card names them, says how
+             * much each returns, and that is exactly a signature.
+             */
+            written.add(join(handlersDir, `${className}Handler.ts`));
+            writeFileSync(join(handlersDir, `${className}Handler.ts`), [
+                ...(descriptor !== undefined ? [`import type { ${className} } from '../entities/${className}.js';`, ``] : []),
+                `// Generated by \`fougere sync\` from ${baseUrl} — do not edit.`,
+                `// The shape of an invocation, restated rather than imported: this file is a`,
+                `// contract, and a contract that drags a runtime dependency is not one.`,
+                `type Invocation = { params?: Record<string, string>; query?: Record<string, unknown>; body?: unknown; state?: Record<string, unknown> };`,
+                ``,
+                FacadeTypes.of(ops ?? []).render({
+                    name: `${className}Handler`,
+                    ...(descriptor !== undefined ? { rowType: className } : {}),
+                }),
+                ``,
+            ].join('\n'));
+        }
+        /**
+         * The facts, which is the only reason a subscriber needs this command at all.
+         *
+         * A fact has no operation, so no façade type is written: a listener spells
+         * `reindex(fact: Fact<PostPublished>)` and the class is the whole of what it needs.
+         * Announced without a declared shape, there is nothing to write — a class built from
+         * a bare name would validate everything, which is worse than the absence.
+         */
+        for (const { name, schema: descriptor } of target.facts ?? []) {
+            const className = claim(name);
+            if (descriptor === undefined) {
+                generated.delete(className);
+                continue;
+            }
+            writeRow(className, descriptor);
+        }
+        /**
+         * The facade module, written from the CARD rather than from a scan.
+         *
+         * A frond in another repository cannot be scanned — there are no sources here. What the
+         * card carries is exactly the three facts the module needs: the addresses, the operations,
+         * and what each one refuses. The handler TYPE is the one thing it cannot carry, so the
+         * synthetic interface written above stands in its place: it names the same operations with
+         * the same answers, which is what a page reads.
+         *
+         * `facadeModule` is the compiler's own, not a copy: two spellings of one format would
+         * drift the day either gained a member.
+         */
+        writeFileSync(join(frondDir, 'facade.ts'), facadeModule(served, `${baseUrl} — a card, not a scan`));
+        // Barrel index
+        // One binding carries the value AND the type, because a class is both — the pair of
+        // re-exports that stood here was the price of declaring them separately.
+        const indexLines = [...generated].flatMap(([name, { row, facade }]) => [
+            ...(row ? [`export { default as ${name} } from './${entities}/${name}.js';`] : []),
+            ...(facade ? [`export type { ${name}Handler } from './${handlers}/${name}Handler.js';`] : []),
+        ]);
+        writeFileSync(join(frondDir, 'index.ts'), indexLines.join('\n') + '\n');
+        // Package.json
+        writeFileSync(join(frondDir, 'package.json'), JSON.stringify({
+            name: frondPackage(input.frond, conventions),
+            version: '0.0.0-synced',
+            type: 'module',
+            fougere: { frond: input.frond, synced: true, source: baseUrl },
+            exports: {
+                '.': './index.ts',
+                [`./${entities}/*`]: `./${entities}/*.ts`,
+                [`./${handlers}/*`]: `./${handlers}/*.ts`,
+                './package.json': './package.json',
+            },
+        }, null, 2) + '\n');
+        // .fougere/remotes.json is the central registry of synced remotes.
+        this.updateRemotesRegistry(input.frond, baseUrl, frondDir);
+        /**
+         * What the host no longer serves stops being importable here.
+         *
+         * The barrel is rewritten every run, so a dropped entity loses its export on its own
+         * — but the FILE stayed, and the generated `package.json` exports `'./entities/*'` as
+         * a wildcard, so `@fronds/blog/entities/Ticket.js` kept resolving to a class nothing
+         * behind it answers for. The consumer compiles, its local validator accepts, and the call
+         * comes back NOT_FOUND at the facade — or never leaves, because the page dropped the
+         * call and kept the type.
+         */
+        const removed = [...this.prune(entitiesDir, written), ...this.prune(handlersDir, written)];
+        return { path: entitiesDir, entities: [...generated.keys()], removed };
+    }
+    /** Delete the files this run did not write — and only the ones sync itself produced. */
+    prune(dir, written) {
+        const dropped = [];
+        for (const name of readdirSync(dir)) {
+            const path = join(dir, name);
+            if (written.has(path))
+                continue;
+            // Never remove what sync did not write. The folder is sync's, but a human who put
+            // something there meant it, and a delete is not the place to be clever.
+            if (!readFileSync(path, 'utf-8').includes(GENERATED))
+                continue;
+            rmSync(path);
+            dropped.push(name);
+        }
+        return dropped;
+    }
+    /** Write/update .fougere/remotes.json — read by @fougere/nuxt for auto-aliasing. */
+    updateRemotesRegistry(name, baseUrl, localPath) {
+        const registryPath = join(this.cwd, '.fougere', 'remotes.json');
+        let registry = {};
+        if (existsSync(registryPath)) {
+            try {
+                const parsed = JSON.parse(readFileSync(registryPath, 'utf-8'));
+                if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+                    throw new Error('expected an object');
+                registry = parsed;
+            }
+            catch (cause) {
+                throw new Error(`Cannot update corrupt remote registry at ${registryPath}`, { cause });
+            }
+        }
+        registry[name] = { url: baseUrl, path: localPath };
+        mkdirSync(join(this.cwd, '.fougere'), { recursive: true });
+        writeFileSync(registryPath, JSON.stringify(registry, null, 2) + '\n');
+    }
+}
+//# sourceMappingURL=SyncHandler.js.map

package/dist/fronds/scaffold/handlers/SyncHandler.js.map

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

package/dist/fronds/scaffold/services/ProjectWriter.d.ts

@@ -0,0 +1,54 @@
+import { type Conventions } from '@fougere/core';
+export default class ProjectWriter {
+    /** The workspace shell — fougere.config, pnpm-workspace (fronds/* apps/*), package.json. */
+    createWorkspace(dir: string, name: string): {
+        path: string;
+    };
+    /** Add a frond (business hexagon) under fronds/<name>. */
+    addFrond(wsDir: string, template: string, name: string, conventions?: Conventions): {
+        path: string;
+    };
+    /** Add an app (consumer) under apps/<name>, from the host package that owns its wiring. */
+    addApp(wsDir: string, template: string, name: string): {
+        path: string;
+    };
+    /**
+     * What can be scaffolded, of a kind.
+     *
+     * A FROND comes from this package: it is Fougere's own vocabulary, entities and handlers,
+     * and no other package owns it. An APP comes from its HOST — the registry is the hosts this
+     * CLI depends on, so `fougere new` offers what is published rather than what was copied here.
+     */
+    listTemplates(kind: 'fronds' | 'apps'): string[];
+    /**
+     * Every app depends on every frond of the workspace — stated once composition is done,
+     * because that is when the names exist.
+     *
+     * A template cannot carry it: the frond is named at composition time (`blog:catalog`),
+     * so a dependency written into `templates/apps/nuxt` would name the template instead
+     * and resolve to nothing. Which is what happened — the generated app imported
+     * `@fronds/blog` whatever you had called it, and did not start.
+     *
+     * `fronds/` and `apps/` are the registry, like `listTemplates`: nothing to declare.
+     */
+    linkFronds(wsDir: string, conventions?: Conventions): void;
+    /**
+     * Every `@fougere/*` dependency, pinned to the version that scaffolded it.
+     *
+     * The templates say `latest`, which reads as "whatever is current" and is not: pnpm
+     * answers from a metadata cache, and a fresh project installed 0.6 while the registry
+     * said 0.7 — measured. A version is also what makes an install reproducible, which
+     * `latest` never was.
+     *
+     * Read off this CLI's own package, because the scaffold and the packages it names ship
+     * together: the version that wrote the file is the one it was written for.
+     */
+    pinVersions(wsDir: string, conventions?: Conventions): void;
+    /**
+     * Dev mode: rewrite every `@fougere/*` dependency in the workspace to a
+     * `link:` into this monorepo, so `pnpm install` resolves offline (the
+     * packages aren't on npm yet). No-op once the packages are published.
+     */
+    linkLocal(wsDir: string): void;
+}
+//# sourceMappingURL=ProjectWriter.d.ts.map

package/dist/fronds/scaffold/services/ProjectWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectWriter.d.ts","sourceRoot":"","sources":["../../../../fronds/scaffold/services/ProjectWriter.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,WAAW,EAAqC,MAAM,eAAe,CAAC;AA2IpF,MAAM,CAAC,OAAO,OAAO,aAAa;IAChC,4FAA4F;IAC5F,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAM3D;IAED,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,GAAE,WAAiC,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAcxH;IAED,2FAA2F;IAC3F,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAUtE;IAED;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,EAAE,CAO/C;IAED;;;;;;;;;;OAUG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,GAAE,WAAiC,GAAG,IAAI,CAoB9E;IAED;;;;;;;;;;OAUG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,GAAE,WAAiC,GAAG,IAAI,CAyB/E;IAED;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAwC7B;CACF"}