@fougere/cli 0.6.0-alpha.0 → 0.8.0-alpha.0

package/dist/typescript/FacadeTypes.d.ts

@@ -0,0 +1,19 @@
+import type { SchemaDescriptor } from '@fougere/schema';
+export interface FacadeTypesOptions {
+    name?: string;
+    exported?: boolean;
+    rowType?: string;
+}
+export interface OpDescriptor {
+    name: string;
+    description?: string;
+    output?: SchemaDescriptor;
+    cardinality?: 'one' | 'maybe' | 'many' | 'page' | 'none';
+}
+export declare class FacadeTypes {
+    private readonly operations;
+    private constructor();
+    static of(operations: readonly OpDescriptor[]): FacadeTypes;
+    render(options?: FacadeTypesOptions): string;
+}
+//# sourceMappingURL=FacadeTypes.d.ts.map

package/dist/typescript/FacadeTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FacadeTypes.d.ts","sourceRoot":"","sources":["../../src/typescript/FacadeTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGxD,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,WAAW,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CAC1D;AAcD,qBAAa,WAAW;IACF,OAAO,CAAC,QAAQ,CAAC,UAAU;IAA/C,OAAO,eAAqE;IAE5E,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,SAAS,YAAY,EAAE,GAAG,WAAW,CAE1D;IAED,MAAM,CAAC,OAAO,GAAE,kBAAuB,GAAG,MAAM,CAW/C;CACF"}

package/dist/typescript/FacadeTypes.js

@@ -0,0 +1,34 @@
+import { docCommentOf, propertyKey } from './syntax.js';
+/** So a consumer sees the cardinality in the type, not in a doc line. */
+function returnTypeOf(op, rowType) {
+    switch (op.cardinality) {
+        case 'many': return `${rowType}[]`;
+        case 'page': return `${rowType}[] & { total?: number; endCursor?: string; hasMore?: boolean }`;
+        case 'maybe': return `${rowType} | undefined`;
+        case 'one': return rowType;
+        case 'none': return 'unknown';
+        default: return 'unknown';
+    }
+}
+export class FacadeTypes {
+    operations;
+    constructor(operations) {
+        this.operations = operations;
+    }
+    static of(operations) {
+        return new FacadeTypes(operations);
+    }
+    render(options = {}) {
+        const name = options.name ?? 'Facade';
+        const exported = options.exported === false ? '' : 'export ';
+        const rowType = options.rowType ?? 'unknown';
+        const members = this.operations.map((operation) => {
+            const doc = docCommentOf(operation.description, '  ');
+            return `${doc}  ${propertyKey(operation.name)}(invocation?: Invocation): Promise<${returnTypeOf(operation, rowType)}>;`;
+        });
+        if (members.length === 0)
+            return `${exported}interface ${name} {}`;
+        return `${exported}interface ${name} {\n${members.join('\n')}\n}`;
+    }
+}
+//# sourceMappingURL=FacadeTypes.js.map

package/dist/typescript/FacadeTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FacadeTypes.js","sourceRoot":"","sources":["../../src/typescript/FacadeTypes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAexD,yEAAyE;AACzE,SAAS,YAAY,CAAC,EAAgB,EAAE,OAAe;IACrD,QAAQ,EAAE,CAAC,WAAW,EAAE,CAAC;QACvB,KAAK,MAAM,EAAE,OAAO,GAAG,OAAO,IAAI,CAAC;QACnC,KAAK,MAAM,EAAE,OAAO,GAAG,OAAO,gEAAgE,CAAC;QAC/F,KAAK,OAAO,EAAE,OAAO,GAAG,OAAO,cAAc,CAAC;QAC9C,KAAK,KAAK,EAAE,OAAO,OAAO,CAAC;QAC3B,KAAK,MAAM,EAAE,OAAO,SAAS,CAAC;QAC9B,SAAS,OAAO,SAAS,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,MAAM,OAAO,WAAW;IACe,UAAU;IAA/C,YAAqC,UAAmC;0BAAnC,UAAU;IAA4B,CAAC;IAE5E,MAAM,CAAC,EAAE,CAAC,UAAmC;QAC3C,OAAO,IAAI,WAAW,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,CAAC,OAAO,GAAuB,EAAE;QACrC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,QAAQ,CAAC;QACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,SAAS,CAAC;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE;YAChD,MAAM,GAAG,GAAG,YAAY,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YACtD,OAAO,GAAG,GAAG,KAAK,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,sCAAsC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC;QAC1H,CAAC,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,GAAG,QAAQ,aAAa,IAAI,KAAK,CAAC;QACnE,OAAO,GAAG,QAAQ,aAAa,IAAI,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;IACpE,CAAC;CACF"}

package/dist/typescript/syntax.d.ts

@@ -0,0 +1,5 @@
+/** So a name that is not an identifier is still written as a key. */
+export declare function propertyKey(name: string): string;
+/** So a sentence shows on hover — and cannot close the comment it sits in. */
+export declare function docCommentOf(text: string | undefined, indent: string): string;
+//# sourceMappingURL=syntax.d.ts.map

package/dist/typescript/syntax.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax.d.ts","sourceRoot":"","sources":["../../src/typescript/syntax.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAI7E"}

package/dist/typescript/syntax.js

@@ -0,0 +1,11 @@
+/** So a name that is not an identifier is still written as a key. */
+export function propertyKey(name) {
+    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name) ? name : JSON.stringify(name);
+}
+/** So a sentence shows on hover — and cannot close the comment it sits in. */
+export function docCommentOf(text, indent) {
+    if (!text)
+        return '';
+    return `${indent}/** ${text.replace(/\*\//g, '*\\/')} */\n`;
+}
+//# sourceMappingURL=syntax.js.map

package/dist/typescript/syntax.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax.js","sourceRoot":"","sources":["../../src/typescript/syntax.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAC/E,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,YAAY,CAAC,IAAwB,EAAE,MAAc;IACnE,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAErB,OAAO,GAAG,MAAM,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC;AAC9D,CAAC"}

package/dist/ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAcA,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAE5D,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CAC/B;AAED,wBAAgB,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO;IAMhC,qDAAqD;;IAKrD,sCAAsC;mBACvB,MAAM;IAIrB,uBAAuB;;IAQvB,kBAAkB;eACD;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;KAAE;IAMnI,2BAA2B;kBACP;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE;IAM/D,8BAA8B;iBACX;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB;IAMD,gCAAgC;sBACR;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB;IAQD,sDAAsD;sBACpC,MAAM;QAIpB,MAAM,QAAQ,MAAM;QACpB,IAAI,SAAS,MAAM;;IAMvB,6BAA6B;kBACf,MAAM;IAIpB,uBAAuB;qBACN,MAAM;IAIvB,uBAAuB;kBACT,MAAM;IAIpB,qBAAqB;mBACN,MAAM;IAIrB,sBAAsB;kBACR,MAAM;IAIpB,6CAA6C;kBAC/B,MAAM,UAAU,MAAM;;;;;;;;;;;;;EAUvC"}
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAIA,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAE5D,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CAC/B;AAED,wBAAgB,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO;IAMhC,qDAAqD;;IAKrD,sCAAsC;mBACvB,MAAM;IAIrB,uBAAuB;;IAQvB,kBAAkB;eACD;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;KAAE;IAMnI,2BAA2B;kBACP;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE;IAM/D,8BAA8B;iBACX;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB;IAMD,gCAAgC;sBACR;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB;IAQD,sDAAsD;sBACpC,MAAM;QAIpB,MAAM,QAAQ,MAAM;QACpB,IAAI,SAAS,MAAM;;IAMvB,6BAA6B;kBACf,MAAM;IAIpB,uBAAuB;qBACN,MAAM;IAIvB,uBAAuB;kBACT,MAAM;IAIpB,qBAAqB;mBACN,MAAM;IAIrB,sBAAsB;kBACR,MAAM;IAIpB,6CAA6C;kBAC/B,MAAM,UAAU,MAAM;;;;;;;;;;;;;EAUvC"}

package/dist/ui.js

@@ -1,14 +1,4 @@
-/**
- * Fougere CLI UI — beautiful terminal interface.
- *
- * Wraps @clack/prompts + picocolors + consola into a cohesive API.
- *
- * This was `@fougere/cli-ui`, a published package with exactly one consumer —
- * the CLI it is named after. A second name in the registry that nobody would
- * ever install on purpose is a name, not a boundary. Same dependency profile,
- * so it folds in as a module; a subpath export is one line the day something
- * outside the CLI wants it.
- */
+/** Fougere CLI UI — beautiful terminal interface. */
 import * as clack from '@clack/prompts';
 import pc from 'picocolors';
 import { consola } from 'consola';

package/dist/ui.js.map

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

package/fronds/analysis/handlers/CheckHandler.ts

@@ -1,10 +1,12 @@
+import { Shapes } from '@fougere/schema';
+import safeRegex from 'safe-regex';
 import {
   buildGraph,
   clusterEntities,
   resolveEffectiveOperations,
   type ScanDiagnostic,
 } from '@fougere/core';
-import { crossFrondImports } from '@fougere/core/node';
+import { adaptersOf, crossFrondImports } from '@fougere/core/node';
 import ProjectScan from '../services/ProjectScan.js';
 
 /** One thing that does not hold, in the terms of whoever has to fix it. */
@@ -52,7 +54,7 @@ export default class CheckHandler {
 
   /** Report what does not hold in a Fougere app, without booting it. */
   async execute(input: { root?: string }): Promise<CheckResult> {
-    const { fronds, diagnostics, config } = await this.projectScan.at(input.root);
+    const { fronds, diagnostics, config, root } = await this.projectScan.at(input.root);
     // This is the same pure resolution the boot consumes. No app lifecycle, database,
     // migration, seed or adapter mount is needed for a global semantic check.
     const model = resolveEffectiveOperations(fronds, {
@@ -87,6 +89,63 @@ export default class CheckHandler {
       }
     }
 
+    /**
+     * An entity addressing an adapter this project does not depend on. Judged HERE and
+     * not at boot: a process only knows the adapters it loaded, so an entity stating a
+     * Postgres column type in an app running on `adapter/memory` is indistinguishable
+     * from a typo. A project's dependencies name every adapter it could ever load.
+     *
+     * Silent when the project depends on none — there would be nothing to compare against,
+     * and reporting every key as unknown is worse than saying nothing.
+     */
+    const known = await adaptersOf(root);
+    if (known.length > 0) {
+      for (const frond of fronds) {
+        for (const entity of frond.entities) {
+          for (const name of Object.keys(entity.entityClass.getAdapters() ?? {})) {
+            if (known.includes(name)) continue;
+            findings.push({
+              severity: 'warning',
+              code: 'unknown-adapter',
+              filePath: entity.filePath,
+              subject: entity.name,
+              message: `states \`adapters: { ${name} }\`, and this project depends on no adapter `
+                + `that answers to it. It depends on ${known.join(', ')}. Nothing reads the entry, `
+                + 'so it is inert — a typo, or a dependency that was never added.',
+            });
+          }
+        }
+      }
+    }
+
+    /**
+     * A `pattern` that backtracks super-linearly. The pattern is fixed at declaration and
+     * the string tested against it is not: whoever calls the door chooses it, so the cost
+     * of one match is theirs to set. Judged HERE because a regex says the same thing on
+     * every run — checking it per row would pay for a verdict that never changes.
+     *
+     * `safe-regex` reads the star height, which is the common shape and not every one:
+     * `(a|a)*b` backtracks too and passes. Reported as a suspicion, never as a refusal.
+     */
+    for (const frond of fronds) {
+      for (const entity of frond.entities) {
+        for (const [key, field] of Object.entries(entity.entityClass.getFields())) {
+          for (const pattern of Shapes.patterns(field.shape)) {
+            if (safeRegex(pattern)) continue;
+            findings.push({
+              severity: 'warning',
+              code: 'super-linear-pattern',
+              filePath: entity.filePath,
+              subject: `${entity.name}.${key}`,
+              message: `states \`pattern: ${JSON.stringify(pattern)}\`, whose nested repetition `
+                + 'backtracks super-linearly. A value a caller chooses can hold the event loop '
+                + 'for seconds — rewrite the repeated group, or bound the field with `max`.',
+            });
+          }
+        }
+      }
+    }
+
     /**
      * A warning, not a refusal: it resolves today and the app runs. What it costs is
      * paid once, late — the day the frond it reaches into is deployed on its own.

package/fronds/analysis/handlers/DevtoolsHandler.ts

@@ -42,7 +42,7 @@ export default class DevtoolsHandler {
       try {
         const page = await createHttpTransport(one.url)(
           { entity: 'rpc', op: 'calls' },
-          { params: {}, query: {}, body: { since: since[one.url] ?? 0 }, state: {} },
+          { params: {}, query: {}, input: { since: since[one.url] ?? 0 }, state: {} },
         ) as CallPage;
 
         return { ...one, cursor: page.cursor, inFlight: page.inFlight, dropped: page.dropped, calls: page.calls };

package/fronds/analysis/handlers/ExplainHandler.ts

@@ -14,7 +14,7 @@ export type ExplainedBinding =
   | { kind: 'collector'; typeName: string }
   | { kind: 'fact'; factName: string }
   | { kind: 'param'; name: string; coerce?: 'number' | 'boolean' }
-  | { kind: 'body' }
+  | { kind: 'input' }
   | { kind: 'context' }
   | { kind: 'query' };
 
@@ -229,7 +229,7 @@ function addressOf(value: string): string {
 }
 
 function inputTypeOf(operation: EffectiveOperation): string | null {
-  const body = operation.parameters.find((parameter) => parameter.binding.source.kind === 'body');
+  const body = operation.parameters.find((parameter) => parameter.binding.source.kind === 'input');
   return body?.type ?? schemaName(operation.input) ?? null;
 }
 

package/fronds/analysis/handlers/MigrateHandler.ts

@@ -39,7 +39,9 @@ export default class MigrateHandler {
     if (steps.length === 0) return { chain: [], changes: [], refusals: [], ran: [] };
 
     const config = await loadConfig(scan.root);
-    const storage = resolveStorage(config.db ?? {});
+    // `fougere migrate --root ../app` read that project's config and planned against a
+    // database beside the CLI's own directory — the loudest form of this bug.
+    const storage = resolveStorage(config.db ?? {}, undefined, scan.root);
     if (!storage.db) {
       return {
         chain: versionsOf(steps),

package/fronds/scaffold/handlers/SyncHandler.ts

@@ -1,6 +1,8 @@
 import { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync, rmSync } from 'node:fs';
 import { join } from 'node:path';
-import { upperFirst, EntityTypeSource, FacadeTypeSource, type SchemaDescriptor } from '@fougere/schema';
+import { upperFirst, type SchemaDescriptor } 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.
@@ -35,7 +37,7 @@ export function entityClassName(name: string): string {
 }
 
 /**
- * One entry — a door or a fact — judged the same way, because sync consumes the same two
+ * One entry — a door 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 door that
@@ -52,7 +54,7 @@ function assertEntry(kind: string, frondName: string, entry: { name: string; sch
   // `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. Judge what you consume.
+  // kind and their views — and so refused every real host. Validate what you consume.
   const descriptor = entry.schema as unknown;
   if (
     !descriptor
@@ -70,7 +72,7 @@ function assertEntry(kind: string, frondName: string, entry: { name: string; sch
 }
 
 function identityCardOf(value: unknown): IdentityCard {
-  // The card's own shape is judged by the package that declares it — `fronds`, and each
+  // The card's own shape is validated by the package that declares it — `fronds`, and each
   // frond's `doors`. 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');
@@ -170,7 +172,7 @@ export default class SyncHandler {
         `import { Card } from '@fougere/schema';`,
         ``,
         `// Generated by \`fougere sync\` from ${baseUrl} — do not edit.`,
-        EntityTypeSource.of(descriptor).render({ name: className }),
+        EntityTypes.of(descriptor).render({ name: className }),
         ``,
         `export default ${className};`,
         ``,
@@ -203,7 +205,7 @@ export default class SyncHandler {
         `// 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> };`,
         ``,
-        FacadeTypeSource.of(ops ?? []).render({
+        FacadeTypes.of(ops ?? []).render({
           name: `${className}Handler`,
           ...(descriptor !== undefined ? { rowType: className } : {}),
         }),
@@ -263,7 +265,7 @@ export default class SyncHandler {
      * 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 judge accepts, and the call
+     * behind it answers for. The consumer compiles, its local validator accepts, and the call
      * comes back NOT_FOUND at the door — or never leaves, because the page dropped the
      * call and kept the type.
      */

package/fronds/scaffold/services/ProjectWriter.ts

@@ -30,6 +30,11 @@ function monorepoPackages(): string | undefined {
  */
 const TEMPLATES = fileURLToPath(new URL('../../../templates/', import.meta.url));
 
+/** The version that scaffolds is the version the templates were written for. */
+const scaffoldVersion = (): string =>
+  (JSON.parse(readFileSync(fileURLToPath(new URL('../../../package.json', import.meta.url)), 'utf8')) as
+    { version: string }).version;
+
 // npm strips a literal .gitignore from published packages — it ships as
 // _gitignore and the name is restored on copy.
 function restoreGitignore(dir: string): void {
@@ -146,6 +151,44 @@ export default class ProjectWriter {
     }
   }
 
+  /**
+   * 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 = DEFAULT_CONVENTIONS): void {
+    const version = scaffoldVersion();
+    const manifests = [
+      join(wsDir, 'package.json'),
+      ...['apps', conventions.fronds].flatMap((kind) => {
+        const dir = join(wsDir, kind);
+        if (!existsSync(dir)) return [];
+
+        return readdirSync(dir, { withFileTypes: true })
+          .filter((e) => e.isDirectory())
+          .map((e) => join(dir, e.name, 'package.json'));
+      }),
+    ];
+
+    for (const path of manifests) {
+      if (!existsSync(path)) continue;
+      const pkg = JSON.parse(readFileSync(path, 'utf8')) as { dependencies?: Record<string, string> };
+      let moved = false;
+      for (const [name, range] of Object.entries(pkg.dependencies ?? {})) {
+        if (!name.startsWith('@fougere/') || range !== 'latest') continue;
+        pkg.dependencies![name] = version;
+        moved = true;
+      }
+      if (moved) writeFileSync(path, JSON.stringify(pkg, null, 2) + '\n');
+    }
+  }
+
   /**
    * Dev mode: rewrite every `@fougere/*` dependency in the workspace to a
    * `link:` into this monorepo, so `pnpm install` resolves offline (the

package/fronds/shims.d.ts

@@ -0,0 +1,9 @@
+// `safe-regex` ships no types, and `@types/safe-regex` describes its version 1 while the
+// package here is version 2. The exported signature did not move between the two, so the
+// shim states it rather than pinning a types package a major behind.
+declare module 'safe-regex' {
+  export default function safeRegex(
+    pattern: string | RegExp,
+    options?: { limit?: number },
+  ): boolean;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fougere/cli",
-  "version": "0.6.0-alpha.0",
+  "version": "0.8.0-alpha.0",
   "description": "The Fougere CLI — compose a workspace, serve a frond, call an operation.",
   "keywords": [
     "fougere",
@@ -41,12 +41,13 @@
     "consola": "^3.4.2",
     "jiti": "^2.4.2",
     "picocolors": "^1.1.1",
-    "@fougere/adapter-sql": "0.6.0-alpha.0",
-    "@fougere/container": "0.6.0-alpha.0",
-    "@fougere/defaults": "0.6.0-alpha.0",
-    "@fougere/core": "0.6.0-alpha.0",
-    "@fougere/transport-http": "0.6.0-alpha.0",
-    "@fougere/schema": "0.6.0-alpha.0"
+    "safe-regex": "^2.1.1",
+    "@fougere/container": "0.8.0-alpha.0",
+    "@fougere/core": "0.8.0-alpha.0",
+    "@fougere/adapter-sql": "0.8.0-alpha.0",
+    "@fougere/schema": "0.8.0-alpha.0",
+    "@fougere/transport-http": "0.8.0-alpha.0",
+    "@fougere/defaults": "0.8.0-alpha.0"
   },
   "devDependencies": {
     "vitest": "^4.1.0"

package/src/bin.ts

@@ -1,11 +1,5 @@
 #!/usr/bin/env node
-/**
- * fougere CLI — a Fougere app powered by citty.
- *
- * src/   → compiled (tsc → dist/)
- * fronds/ → loaded at runtime by jiti (domain)
- * app/   → loaded at runtime by jiti (presentation)
- */
+/** fougere CLI — a Fougere app powered by citty. */
 import { createApp, setLogLevel, envLevel, type ScanResult } from '@fougere/core';
 import { scanProject, getModuleLoader, frondDirsOf, DEFAULT_CONVENTIONS } from '@fougere/core/node';
 import { readdir, stat } from 'node:fs/promises';
@@ -50,13 +44,8 @@ async function newestDeclaration(root: string): Promise<number> {
 }
 
 /**
- * The CLI is a Fougere app, so it reads its own written-down scan like any deployment —
- * producing the description reads the project, consuming it does not.
- *
- * Reading its own 44 declarations through the compiler cost 617 ms on every invocation,
- * for a domain fixed at publish time. Staleness is decided by mtime rather than by a flag:
- * editing a frond must not need a command, and a published package has nothing newer than
- * its artefact.
+ * The CLI is a Fougere app, so it reads its own written-down scan like any deployment — producing
+ * the description reads the project, consuming it does not.
  */
 async function scanOf(root: string): Promise<ScanResult> {
   const written = join(root, '.fougere/scan.generated.ts');

package/src/bridge.ts

@@ -1,12 +1,7 @@
 import { Lifecycle, Role } from '@fougere/schema';
-/**
- * Entity → citty bridge.
- *
- * Converts Entity fields into citty ArgsDef.
- * The Entity IS the CLI definition — no duplicate schema.
- */
+/** Entity → citty bridge. */
 import type { Fields } from '@fougere/schema';
-import { Anatomy, Visibility } from '@fougere/schema';
+import { Shapes, Visibility } from '@fougere/schema';
 import type { ArgsDef, ArgDef } from 'citty';
 
 function toKebab(name: string): string {
@@ -25,46 +20,62 @@ export function entityToArgs(fields: Fields): ArgsDef {
 
     // A `default(v)` travels as the create rule `{ value }` — citty shows it.
     const defaultValue = Lifecycle.of(field).literal?.value;
-    const { base: shape, nullable } = Anatomy.of(field.shape);
-
-    const kebab = toKebab(key);
-    const def: ArgDef = {
+    const { base: shape, nullable } = Shapes.of(field.shape);
+    const common = {
       description: field.meta?.description,
       required: !nullable && Lifecycle.of(field).requiredAtCreate,
     };
 
-    switch (shape?.type) {
-      case 'boolean':
-        (def as Record<string, unknown>).type = 'boolean';
-        if (defaultValue !== undefined) def.default = defaultValue as boolean;
-        break;
-      case 'number':
-      case 'integer':
-      case 'string':
-        // A closed set is citty's `enum`: the shape already names the legal values, so the
-        // refusal and the `--help` listing come from the declaration rather than a check
-        // written beside it.
-        if (shape.type === 'string' && shape.enum?.length) {
-          (def as Record<string, unknown>).type = 'enum';
-          (def as Record<string, unknown>).options = shape.enum.filter((v) => v !== null);
-        // A date-time string stays a named string — never a positional arg.
-        } else if (shape.type === 'string' && shape.format === 'date-time') {
-          (def as Record<string, unknown>).type = 'string';
-        } else if (positionalIndex === 0 && def.required && key !== 'force') {
-          // First non-bool required field becomes positional
-          (def as Record<string, unknown>).type = 'positional';
-          positionalIndex++;
-        } else {
-          (def as Record<string, unknown>).type = 'string';
-        }
-        if (defaultValue !== undefined) def.default = String(defaultValue);
-        break;
-      default:
-        (def as Record<string, unknown>).type = 'string';
-    }
+    // A closed set is citty's `enum`: the shape already names the legal values, so the
+    // refusal and the `--help` listing come from the declaration rather than a check
+    // written beside it.
+    const options = shape?.type === 'string' && shape.enum?.length
+      ? shape.enum.filter((value): value is string => value !== null)
+      : undefined;
+    // First required field becomes positional — but never a boolean, a closed set, or a
+    // date-time, which stay named flags.
+    const positional = positionalIndex === 0
+      && common.required
+      && key !== 'force'
+      && options === undefined
+      && shape?.type !== 'boolean'
+      && !(shape?.type === 'string' && shape.format === 'date-time');
+    if (positional) positionalIndex++;
 
-    args[kebab === key ? key : kebab] = def;
+    args[toKebab(key) === key ? key : toKebab(key)] = argFor(
+      shape?.type,
+      common,
+      defaultValue,
+      options,
+      positional,
+    );
   }
 
   return args;
 }
+
+/** One arg, built WITH its `type`. */
+function argFor(
+  type: string | undefined,
+  common: { description?: string; required: boolean },
+  defaultValue: unknown,
+  options: string[] | undefined,
+  positional: boolean,
+): ArgDef {
+  if (type === 'boolean') {
+    return defaultValue === undefined
+      ? { ...common, type: 'boolean' }
+      : { ...common, type: 'boolean', default: defaultValue as boolean };
+  }
+
+  // Only these three shapes carry a default onto the CLI; anything else is named and bare.
+  const carriesDefault = type === 'number' || type === 'integer' || type === 'string';
+  const withDefault = carriesDefault && defaultValue !== undefined
+    ? { default: String(defaultValue) }
+    : {};
+
+  if (options) return { ...common, ...withDefault, type: 'enum', options };
+  if (positional) return { ...common, ...withDefault, type: 'positional' };
+
+  return { ...common, ...withDefault, type: 'string' };
+}

package/src/completion.ts

@@ -1,11 +1,4 @@
-/**
- * Shell completion generator — outputs a script for bash/zsh.
- *
- * Commands and flags are the CLI's own entities, read once at generation. The VALUES a
- * positional accepts belong to the project the shell sits in, so they are not written
- * down here: the script asks `fougere explain --names` at the moment of the TAB. A list
- * frozen into a script is stale the first time a handler is added.
- */
+/** Shell completion generator — outputs a script for bash/zsh. */
 import type { App } from '@fougere/core';
 import { entityToArgs } from './bridge.js';
 

package/src/loader.ts

@@ -3,14 +3,7 @@ import {
 } from '@fougere/core/node';
 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.
- */
+/** The loader every command needs. */
 export async function installLoader(root: string, reread = false): Promise<Conventions> {
   const { createJiti } = await import('jiti');
   const bare = createJiti(import.meta.url, { interopDefault: true });

package/src/machine.ts

@@ -1,18 +1,12 @@
-/**
- * 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.
- */
+/** A command's machine output — the one shape a pipe reads. */
 export function machineWanted(raw: Record<string, unknown>): boolean {
   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.
+ * 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: unknown): string {
   return JSON.stringify(value, (_key, held) => (held instanceof Map ? Object.fromEntries(held) : held), 2);