@fougere/cli 0.5.0-alpha.1 → 0.7.0-alpha.0

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

@@ -4,7 +4,7 @@ import {
   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 +52,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 +87,35 @@ 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 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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fougere/cli",
-  "version": "0.5.0-alpha.1",
+  "version": "0.7.0-alpha.0",
   "description": "The Fougere CLI — compose a workspace, serve a frond, call an operation.",
   "keywords": [
     "fougere",
@@ -41,12 +41,12 @@
     "consola": "^3.4.2",
     "jiti": "^2.4.2",
     "picocolors": "^1.1.1",
-    "@fougere/core": "0.5.0-alpha.1",
-    "@fougere/adapter-sql": "0.5.0-alpha.1",
-    "@fougere/transport-http": "0.5.0-alpha.1",
-    "@fougere/schema": "0.5.0-alpha.1",
-    "@fougere/container": "0.5.0-alpha.1",
-    "@fougere/defaults": "0.5.0-alpha.1"
+    "@fougere/container": "0.7.0-alpha.0",
+    "@fougere/core": "0.7.0-alpha.0",
+    "@fougere/adapter-sql": "0.7.0-alpha.0",
+    "@fougere/transport-http": "0.7.0-alpha.0",
+    "@fougere/schema": "0.7.0-alpha.0",
+    "@fougere/defaults": "0.7.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);

package/src/runner.ts

@@ -1,11 +1,6 @@
 /**
- * CLI runner — scans frond entities for flags, looks for app commands
- * for presentation, dispatches via citty.
- *
- * Architecture:
- * - fronds/  → entities (flags) + handlers (domain logic)
- * - app/     → commands (prompts, TUI, presentation)
- * - src/     → runner + bridge (framework)
+ * CLI runner — scans frond entities for flags, looks for app commands for presentation, dispatches
+ * via citty.
  */
 import type { App } from '@fougere/core';
 import { createAppRunner } from '@fougere/core';
@@ -83,7 +78,7 @@ export async function run(app: App): Promise<void> {
       // App commands handle their own prompting — don't let citty reject missing args
       if (AppCommand) {
         for (const def of Object.values(args)) {
-          if (typeof def === 'object' && def) (def as Record<string, unknown>).required = false;
+          if (typeof def === 'object' && def) def.required = false;
         }
       }
 
@@ -121,15 +116,15 @@ export async function run(app: App): Promise<void> {
               // Ride the call contract — the same envelope every consumer uses.
               await createAppRunner(app)(
                 { entity: lowerFirst(entity.name), op: 'execute' },
-                { params: {}, query: {}, body: input, state: {} },
+                { params: {}, query: {}, input: input, state: {} },
               );
             }
           } catch (err) {
-            const said = err instanceof Error ? err.message : String(err);
+            const message = err instanceof Error ? err.message : String(err);
             // A machine reader parses stdout: a refusal printed there is a refusal that
             // breaks the parse instead of being read. stderr is where it belongs.
-            if (machineOutput) process.stderr.write(said + '\n');
-            else terminal.error(said);
+            if (machineOutput) process.stderr.write(message + '\n');
+            else terminal.error(message);
             process.exit(1);
           }
         },

package/src/typescript/EntityTypes.ts

@@ -0,0 +1,86 @@
+import { upperFirst, type FieldDescriptor, type SchemaDescriptor } from '@fougere/schema';
+import { docCommentOf, propertyKey } from './syntax.js';
+
+/** So a nullable field lands as a union. */
+function typeOf(field: FieldDescriptor): string {
+  const types = Array.isArray(field.type) ? field.type : field.type ? [field.type] : [];
+  const nullable = types.includes('null');
+  const base = types.find((t) => t !== 'null');
+  const inner = baseTypeOf(base, field);
+  return nullable ? `${inner} | null` : inner;
+}
+
+/** So `date-time` becomes a `Date`, the same thing the boundary decodes to. */
+function baseTypeOf(base: string | undefined, field: FieldDescriptor): string {
+  if (field.enum?.length) {
+    return field.enum.map((v) => (v === null ? 'null' : JSON.stringify(v))).join(' | ');
+  }
+  switch (base) {
+    case 'string':
+      return field.format === 'date-time' ? 'Date' : 'string';
+    case 'number':
+    case 'integer':
+      return 'number';
+    case 'boolean':
+      return 'boolean';
+    case 'array':
+      return field.items ? `${typeOf(field.items)}[]` : 'string[]';
+    case 'object':
+      return field.properties ? objectTypeOf(field.properties, field.required ?? []) : 'Record<string, unknown>';
+    default:
+      return 'unknown';
+  }
+}
+
+/** So a nested object keeps its optionality. */
+function objectTypeOf(properties: Record<string, FieldDescriptor>, required: readonly string[]): string {
+  const members = Object.entries(properties).map(([name, field]) => {
+    const optional = required.includes(name) ? '' : '?';
+    return `${propertyKey(name)}${optional}: ${typeOf(field)}`;
+  });
+  return `{ ${members.join('; ')} }`;
+}
+
+export interface EntityTypesOptions {
+  name?: string;
+  exported?: boolean;
+}
+
+/** So the generated class carries its row type. */
+function shapeTypeOf(descriptor: SchemaDescriptor, indent = ''): string {
+  const entries = Object.entries(descriptor.properties ?? {});
+  if (entries.length === 0) return '{}';
+
+  const lines = entries.map(([key, field]) => {
+    const doc = docCommentOf(field.description, `${indent}  `);
+    return `${doc}${indent}  ${propertyKey(key)}: ${typeOf(field)};`;
+  });
+  return `{\n${lines.join('\n')}\n${indent}}`;
+}
+
+export class EntityTypes {
+  private constructor(private readonly descriptor: SchemaDescriptor) {}
+
+  static of(descriptor: SchemaDescriptor): EntityTypes {
+    return new EntityTypes(descriptor);
+  }
+
+  render(options: EntityTypesOptions = {}): string {
+    const name = identifierOf(options.name ?? upperFirst(this.descriptor.title ?? 'Schema'));
+    const exported = options.exported === false ? '' : 'export ';
+    const card = JSON.stringify(this.descriptor, null, 2)
+      .split('\n')
+      .map((line, i) => (i === 0 ? line : `  ${line}`))
+      .join('\n');
+
+    return `${exported}class ${name} extends Card.fromDescriptor<${shapeTypeOf(this.descriptor)}>(${card}).toSchema() {}`;
+  }
+}
+
+/** So a name that cannot declare a class is refused before it reaches a file. */
+function identifierOf(name: string): string {
+  if (!/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name)) {
+    throw new Error(`'${name}' is not a TypeScript identifier — it cannot name a generated declaration`);
+  }
+  return name;
+}