@fougere/cli 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fougere contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,17 @@
+# @fougere/cli
+> The Fougere CLI
+Compose a workspace (`new`), serve a frond on its own (`serve`), call an operation
+(`call`), read the application graph (`graph`).
+
+The CLI is itself a Fougere app: its commands ride on the call contract.
+
+## Installation
+```bash
+pnpm add @fougere/cli
+```
+
+---
+
+Part of [Fougere](https://github.com/chok/fougere) — one schema, a gradient from
+monolith to distributed, the same user code.
+Reference documentation: [the site](https://chok.github.io/fougere/) (en/fr).

package/app/commands/CallCommand.ts

@@ -0,0 +1,68 @@
+import { createAppRunner } from '@fougere/core';
+import { toRegistrationName } from '@fougere/core/contract';
+import { bootAppFromConfig } from '@fougere/runtime';
+import type { App } from '@fougere/core';
+import type { ui as createUi } from '@fougere/cli-ui';
+
+type Ui = ReturnType<typeof createUi>;
+
+/**
+ * Parse `--field value` / `--field=value` / `--flag` from the raw argv.
+ * `call`'s payload is free-form (any entity's fields), so it can't be declared
+ * on the Call entity — citty would boolean-ify undeclared flags. We read the
+ * tail ourselves; positionals (the target) are ignored (not `--`-prefixed).
+ */
+function parseFlags(tokens: string[]): Record<string, unknown> {
+  const out: Record<string, unknown> = {};
+  for (let i = 0; i < tokens.length; i++) {
+    const t = tokens[i];
+    if (!t.startsWith('--')) continue;
+    const eq = t.indexOf('=');
+    if (eq !== -1) { out[t.slice(2, eq)] = t.slice(eq + 1); continue; }
+    const key = t.slice(2);
+    const next = tokens[i + 1];
+    if (next === undefined || next.startsWith('--')) out[key] = true;
+    else { out[key] = next; i++; }
+  }
+  return out;
+}
+
+/**
+ * The client end of the gradient: drive one operation on the project's app and
+ * print the result. It follows the topology — if `remotes:` sends the frond
+ * elsewhere, the call travels there. Same envelope every consumer uses.
+ */
+export default class CallCommand {
+  constructor(private app: App, private ui: Ui) {}
+
+  async run(raw: Record<string, unknown>) {
+    const target = raw.target as string | undefined;
+    if (!target || !target.includes('.')) {
+      this.ui.error('Usage: fougere call <entity>.<op> [--field value …]');
+      return;
+    }
+    const [entityName, op] = target.split('.');
+
+    // Flags → invocation, by the same rule the framework's binding uses:
+    // a primitive param (like `id`) resolves from `params`, an object from
+    // `body`. So `--id` is a route param, every other flag is the body.
+    const flags = parseFlags(process.argv.slice(2));
+    const params: Record<string, string> = {};
+    const body: Record<string, unknown> = {};
+    for (const [k, v] of Object.entries(flags)) {
+      if (k === 'id') params.id = String(v);
+      else body[k] = v;
+    }
+
+    const app = await bootAppFromConfig(process.cwd(), {});
+    try {
+      const result = await createAppRunner(app)(
+        { entity: toRegistrationName(entityName), op },
+        { params, query: {}, body, state: {} },
+      );
+      this.ui.note(JSON.stringify(result, null, 2), target);
+    } finally {
+      await app.dispose();
+    }
+  }
+}

package/app/commands/CheckCommand.ts

@@ -0,0 +1,61 @@
+import type { CheckResult, Finding } from '../../fronds/analysis/handlers/CheckHandler.js';
+import type { App } from '@fougere/core';
+import { createAppRunner } from '@fougere/core';
+import type { ui as createUi } from '@fougere/cli-ui';
+import pc from 'picocolors';
+import { relative } from 'node:path';
+
+type Ui = ReturnType<typeof createUi>;
+
+export default class CheckCommand {
+  constructor(private app: App, private ui: Ui) {}
+
+  async run(raw: Record<string, unknown>) {
+    // Ride the call contract — the same envelope every consumer uses.
+    const result = await createAppRunner(this.app)(
+      { entity: 'check', op: 'execute' },
+      { params: {}, query: {}, body: raw, state: {} },
+    ) as CheckResult;
+
+    if (result.fronds === 0) {
+      this.ui.warn('No fronds found. Run this from a Fougere project root.');
+      return;
+    }
+
+    this.ui.step(`${pc.bold(String(result.fronds))} frond(s), ${pc.bold(String(result.handlers))} handler(s)`);
+
+    if (result.findings.length === 0) {
+      this.ui.success('Nothing to report.');
+      return;
+    }
+
+    this.ui.note(result.findings.map(render).join('\n\n'), 'Findings');
+
+    const blocking = result.findings.filter((f) => f.severity === 'blocking').length;
+    const warnings = result.findings.length - blocking;
+    this.ui.info(`${blocking} blocking, ${warnings} warning(s)`);
+
+    // A non-zero exit is what makes this usable in CI. Warnings do not fail:
+    // an unresolvable base class with no operation is ordinary, and a check that
+    // cries wolf stops being read.
+    if (blocking > 0) process.exitCode = 1;
+  }
+}
+
+function render(f: Finding): string {
+  const mark = f.severity === 'blocking' ? pc.red('✗') : pc.yellow('⚠');
+  const where = relative(process.cwd(), f.filePath) || f.filePath;
+  return `  ${mark} ${pc.bold(`[${f.code}]`)}\n${wrap(f.message, 76, '    ')}\n    ${pc.dim(where)}`;
+}
+
+/** A box grows to its longest line, so a one-line sentence makes an unreadable box. */
+function wrap(text: string, width: number, indent: string): string {
+  const lines: string[] = [];
+  let line = '';
+  for (const word of text.split(' ')) {
+    if (line && line.length + 1 + word.length > width) { lines.push(line); line = word; }
+    else line = line ? `${line} ${word}` : word;
+  }
+  if (line) lines.push(line);
+  return lines.map((l) => indent + l).join('\n');
+}

package/app/commands/CompletionCommand.ts

@@ -0,0 +1,23 @@
+import type { App } from '@fougere/core';
+// `dist/`, not `src/` — app/ ships raw and is loaded by jiti at runtime, but the
+// published package carries only dist/, app/, fronds/ and templates/.
+import { generateZshCompletion, generateBashCompletion } from '../../dist/completion.js';
+
+export default class CompletionCommand {
+  constructor(private app: App) {}
+
+  async run(raw: Record<string, unknown>) {
+    const shell = (raw.shell as string) || detectShell();
+    const script = shell === 'bash'
+      ? generateBashCompletion(this.app)
+      : generateZshCompletion(this.app);
+    console.log(script);
+  }
+}
+
+function detectShell(): string {
+  const shell = process.env.SHELL ?? '';
+  if (shell.includes('zsh')) return 'zsh';
+  if (shell.includes('bash')) return 'bash';
+  return 'zsh';
+}

package/app/commands/GraphCommand.ts

@@ -0,0 +1,61 @@
+import type { GraphResult } from '../../fronds/analysis/handlers/GraphHandler.js';
+import type { EntityNode, DomainCluster, App } from '@fougere/core';
+import { createAppRunner } from '@fougere/core';
+import type { ui as createUi } from '@fougere/cli-ui';
+import pc from 'picocolors';
+
+type Ui = ReturnType<typeof createUi>;
+
+export default class GraphCommand {
+  constructor(private app: App, private ui: Ui) {}
+
+  async run(raw: Record<string, unknown>) {
+    // Ride the call contract — the same envelope every consumer uses.
+    const result = await createAppRunner(this.app)(
+      { entity: 'graph', op: 'execute' },
+      { params: {}, query: {}, body: raw, state: {} },
+    ) as GraphResult;
+
+    if (result.fronds.length === 0) {
+      this.ui.warn('No fronds found. Run this from a Fougere project root.');
+      return;
+    }
+
+    this.ui.step(`${pc.bold(String(result.totalEntities))} entities, ${pc.bold(String(result.totalRefs))} refs, ${pc.bold(String(result.fronds.length))} frond(s)`);
+    this.ui.note(renderGraph(result.nodes), 'Entity Graph');
+
+    const min = (raw.minEntities as number) ?? 6;
+    if (result.clusters.length > 1 && result.totalEntities >= min) {
+      this.ui.note(renderClusters(result.clusters), 'Suggested Domains');
+    }
+
+    if (result.fronds.length === 1 && result.clusters.length > 1 && result.totalEntities >= min) {
+      this.ui.info(`${pc.dim('Tip:')} ${result.clusters.length} natural domains detected. Consider splitting into separate fronds.`);
+    }
+
+  }
+}
+
+function renderGraph(nodes: Map<string, EntityNode>): string {
+  return [...nodes.entries()].map(([name, node]) => {
+    const refs = node.refs.length > 0
+      ? ` ${pc.dim('→')} ${node.refs.map((r) => pc.cyan(r)).join(', ')}`
+      : '';
+    const badge = node.referencedBy.length > 0
+      ? pc.dim(` (${node.referencedBy.length} incoming)`)
+      : '';
+    return `  ${pc.bold(name)}${refs}${badge}`;
+  }).join('\n');
+}
+
+function renderClusters(clusters: DomainCluster[]): string {
+  return clusters.map((cluster) => {
+    const header = `  ${pc.green(pc.bold(cluster.name + '/'))}  ${pc.dim(`(${cluster.entities.length} entities)`)}`;
+    const entities = cluster.entities.map((e) => `    ${e}`);
+    const crossRefs = cluster.crossRefs.length > 0
+      ? [`    ${pc.dim('cross-refs:')}`, ...cluster.crossRefs.map((r) =>
+          `      ${r.from} ${pc.dim('→')} ${pc.yellow(r.to)} ${pc.dim(`(${r.targetCluster})`)}`)]
+      : [];
+    return [header, ...entities, ...crossRefs, ''].join('\n');
+  }).join('\n');
+}

package/app/commands/NewCommand.ts

@@ -0,0 +1,122 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import ProjectWriter from '../../fronds/scaffold/services/ProjectWriter.js';
+import type { ui as createUi } from '@fougere/cli-ui';
+import type { App } from '@fougere/core';
+
+type Ui = ReturnType<typeof createUi>;
+
+/**
+ * The guided composer: a workspace, then its fronds (domains), then the apps
+ * that consume them — in that dependency order. ProjectWriter is a plain,
+ * dependency-free service, so the presentation command drives it directly.
+ */
+export default class NewCommand {
+  constructor(private app: App, private ui: Ui) {}
+
+  async run(raw: Record<string, unknown>) {
+    const pw = new ProjectWriter();
+
+    let name = raw.name as string | undefined;
+    if (!name) name = (await this.ui.text({ message: 'Workspace', placeholder: 'shop' })) as string;
+
+    const dir = join(process.cwd(), name);
+    if (existsSync(dir) && !raw.force) {
+      const ok = await this.ui.confirm({ message: `${name}/ existe déjà. Écraser ?` });
+      if (!ok) { this.ui.cancel(); return; }
+    }
+
+    // A shape, decided before anything is written — the flat form has no workspace shell
+    // to put the domain beside, because the root IS the domain.
+    if (raw.flat) {
+      if (raw.app) throw new Error('--flat is one app and it is the root — drop --app.');
+      const template = ((raw.frond as string) || 'blank').split(':')[0].trim();
+      const available = pw.listTemplates('fronds');
+      if (!available.includes(template)) {
+        throw new Error(`Unknown fronds template '${template}' — available: ${available.join(', ') || '(none)'}`);
+      }
+      pw.createFlat(dir, name);
+      pw.addRootFrond(dir, template);
+      if (raw.local) pw.linkLocal(dir);
+      this.ui.info(`${template} at the root`);
+      const flatInstall = raw.local ? 'pnpm install' : 'pnpm install   # needs @fougere/* published (or re-run with --local)';
+      this.ui.note([`cd ${name}`, flatInstall, `pnpm dev`].join('\n'), `${name} — one frond, at the root`);
+      this.ui.outro('Prêt.');
+      return;
+    }
+
+    pw.createWorkspace(dir, name);
+
+    if (raw.bare) {
+      if (raw.local) pw.linkLocal(dir);
+      this.ui.note([`cd ${name}`, `fougere new   # compose it (guided)`].join('\n'), `${name} — empty workspace`);
+      this.ui.outro('Prêt.');
+      return;
+    }
+
+    // Stated composition wins over the prompts: it is the only form a script, a CI
+    // job or an agent can drive — the guided flow needs a TTY and hangs without one.
+    const stated = (raw.frond as string) || (raw.app as string);
+    const fronds = stated
+      ? this.state(dir, pw, 'fronds', raw.frond as string)
+      : await this.compose(dir, pw, 'fronds', 'Fronds — tes domaines', pw.listTemplates('fronds'));
+    const apps = stated
+      ? this.state(dir, pw, 'apps', raw.app as string)
+      : await this.compose(dir, pw, 'apps', 'Apps — ce qui les consomme', pw.listTemplates('apps'));
+
+    // Every app depends on every frond — stated here, where both names are known.
+    pw.linkFronds(dir);
+    if (raw.local) pw.linkLocal(dir);
+    const install = raw.local ? 'pnpm install' : 'pnpm install   # needs @fougere/* published (or re-run with --local)';
+    this.ui.note([`cd ${name}`, install, `pnpm dev`].join('\n'), `${name} — ${fronds} frond(s), ${apps} app(s)`);
+    this.ui.outro('Prêt.');
+  }
+
+  /**
+   * One phase, stated rather than prompted — `blog,api:catalog` is two pieces, the
+   * second renamed. The template name is the default name: a piece you don't rename
+   * is called what it is.
+   */
+  private state(dir: string, pw: ProjectWriter, kind: 'fronds' | 'apps', spec: string): number {
+    const available = pw.listTemplates(kind);
+    let count = 0;
+    for (const piece of spec.split(',').map((s) => s.trim()).filter(Boolean)) {
+      const [template, itemName = template] = piece.split(':');
+      if (!available.includes(template)) {
+        throw new Error(`Unknown ${kind} template '${template}' — available: ${available.join(', ') || '(none)'}`);
+      }
+      if (kind === 'fronds') pw.addFrond(dir, template, itemName);
+      else pw.addApp(dir, template, itemName);
+      this.ui.info(`${kind}/${itemName}`);
+      count++;
+    }
+    return count;
+  }
+
+  /** One phase — loop "template → name" until the user is done. Returns the count added. */
+  private async compose(
+    dir: string,
+    pw: ProjectWriter,
+    kind: 'fronds' | 'apps',
+    header: string,
+    templates: string[],
+  ): Promise<number> {
+    this.ui.step(header);
+    let count = 0;
+    for (;;) {
+      const doneLabel = count === 0 ? (kind === 'fronds' ? 'passer' : 'aucune') : 'terminé';
+      const template = (await this.ui.select({
+        message: count === 0 ? 'Template' : 'Encore un ?',
+        options: [...templates.map((v) => ({ value: v, label: v })), { value: '__done__', label: doneLabel }],
+      })) as string;
+      if (template === '__done__') break;
+
+      const itemName = (await this.ui.text({ message: 'Nom' })) as string;
+      if (kind === 'fronds') pw.addFrond(dir, template, itemName);
+      else pw.addApp(dir, template, itemName);
+      this.ui.info(`${kind}/${itemName}`);
+      count++;
+    }
+    return count;
+  }
+}

package/app/commands/ServeCommand.ts

@@ -0,0 +1,34 @@
+import { createLocalRunner } from '@fougere/core';
+import { bootAppFromConfig } from '@fougere/runtime';
+import { serve } from '@fougere/transport-http';
+import type { App } from '@fougere/core';
+import type { ui as createUi } from '@fougere/cli-ui';
+
+type Ui = ReturnType<typeof createUi>;
+
+/**
+ * The host end of the gradient: one frond, alone in this process, reachable
+ * over HTTP. `topology: false` — a served frond IS the host, it never routes
+ * back out through `remotes:`. The same fronds/** an app runs in-process;
+ * only the runtime moves.
+ */
+export default class ServeCommand {
+  constructor(private app: App, private ui: Ui) {}
+
+  async run(raw: Record<string, unknown>) {
+    const frond = raw.frond as string | undefined;
+    if (!frond) { this.ui.error('Usage: fougere serve <frond>'); return; }
+
+    const app = await bootAppFromConfig(process.cwd(), { fronds: [frond], topology: false });
+    if (!app.fronds.some((f) => f.name === frond)) {
+      this.ui.error(`Frond '${frond}' introuvable dans ce projet.`);
+      return;
+    }
+
+    const port = raw.port != null ? Number(raw.port) : 4100;
+    const { port: bound } = await serve(createLocalRunner(app), { port });
+    this.ui.step(`frond ${frond} servie — POST http://127.0.0.1:${bound}/_fougere/call`);
+    this.ui.info('Ctrl-C pour arrêter.');
+    // The listening server keeps the event loop alive; the command returns and stays up.
+  }
+}

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,28 @@
+#!/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)
+ */
+import { createApp, setModuleLoader } from '@fougere/core';
+import { createContainer } from '@fougere/container-fougere';
+import { ui } from '@fougere/cli-ui';
+import { run } from './runner.js';
+const { createJiti } = await import('jiti');
+const jiti = createJiti(import.meta.url, { interopDefault: true });
+setModuleLoader((filePath) => jiti.import(filePath));
+const cliRoot = new URL('..', import.meta.url).pathname;
+const container = createContainer();
+container.registerValue('ui', ui());
+container.registerValue('cwd', process.cwd());
+// The CLI is a Fougere app — silence its boot chatter unless explicitly asked.
+process.env.FOUGERE_LOG_LEVEL ??= 'warn';
+const app = await createApp({
+    root: cliRoot,
+    createContainer: () => container,
+});
+container.registerValue('app', app);
+await run(app);
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA;;;;;;GAMG;AACH,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AACrC,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;AAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;AACnE,eAAe,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAqC,CAAC,CAAC;AAEzF,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;AACxD,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;AACpC,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;AACpC,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AAE9C,+EAA+E;AAC/E,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,MAAM,CAAC;AAEzC,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC;IAC1B,IAAI,EAAE,OAAO;IACb,eAAe,EAAE,GAAG,EAAE,CAAC,SAAS;CACjC,CAAC,CAAC;AAEH,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAEpC,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC"}

package/dist/bridge.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Entity → citty bridge.
+ *
+ * Converts Entity fields into citty ArgsDef.
+ * The Entity IS the CLI definition — no duplicate schema.
+ */
+import type { Fields } from '@fougere/schema';
+import type { ArgsDef } from 'citty';
+/** Convert an Entity's fields into citty args definition. */
+export declare function entityToArgs(fields: Fields): ArgsDef;
+//# sourceMappingURL=bridge.d.ts.map

package/dist/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,KAAK,EAAE,OAAO,EAAU,MAAM,OAAO,CAAC;AAM7C,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAgDpD"}

package/dist/bridge.js

@@ -0,0 +1,54 @@
+import { anatomy, inputFields } from '@fougere/schema';
+function toKebab(name) {
+    return name.replace(/[A-Z]/g, (c) => '-' + c.toLowerCase());
+}
+/** Convert an Entity's fields into citty args definition. */
+export function entityToArgs(fields) {
+    const args = {};
+    let positionalIndex = 0;
+    // Axes-derived ingress membership; the CLI additionally skips ALL relations
+    // (a ref is not a flag — supplying related rows is not a CLI gesture).
+    for (const [key, field] of Object.entries(inputFields(fields))) {
+        if (field.role?.relation)
+            continue;
+        // A `default(v)` travels as the create rule `{ value }` — citty shows it.
+        const create = field.lifecycle?.create;
+        const defaultValue = typeof create === 'object' && 'value' in create ? create.value : undefined;
+        const { base: shape, nullable } = anatomy(field.shape);
+        const kebab = toKebab(key);
+        const def = {
+            description: field.meta?.description,
+            required: !nullable && field.lifecycle?.create === undefined,
+        };
+        switch (shape?.type) {
+            case 'boolean':
+                def.type = 'boolean';
+                if (defaultValue !== undefined)
+                    def.default = defaultValue;
+                break;
+            case 'number':
+            case 'integer':
+            case 'string':
+                // A date-time string stays a named string — never a positional arg.
+                if (shape.type === 'string' && shape.format === 'date-time') {
+                    def.type = 'string';
+                }
+                else if (positionalIndex === 0 && def.required && key !== 'force') {
+                    // First non-bool required field becomes positional
+                    def.type = 'positional';
+                    positionalIndex++;
+                }
+                else {
+                    def.type = 'string';
+                }
+                if (defaultValue !== undefined)
+                    def.default = String(defaultValue);
+                break;
+            default:
+                def.type = 'string';
+        }
+        args[kebab === key ? key : kebab] = def;
+    }
+    return args;
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGvD,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,IAAI,GAAY,EAAE,CAAC;IACzB,IAAI,eAAe,GAAG,CAAC,CAAC;IAExB,4EAA4E;IAC5E,uEAAuE;IACvE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QAC/D,IAAI,KAAK,CAAC,IAAI,EAAE,QAAQ;YAAE,SAAS;QAEnC,0EAA0E;QAC1E,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC;QACvC,MAAM,YAAY,GAAG,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QAChG,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAEvD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3B,MAAM,GAAG,GAAW;YAClB,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,WAAW;YACpC,QAAQ,EAAE,CAAC,QAAQ,IAAI,KAAK,CAAC,SAAS,EAAE,MAAM,KAAK,SAAS;SAC7D,CAAC;QAEF,QAAQ,KAAK,EAAE,IAAI,EAAE,CAAC;YACpB,KAAK,SAAS;gBACX,GAA+B,CAAC,IAAI,GAAG,SAAS,CAAC;gBAClD,IAAI,YAAY,KAAK,SAAS;oBAAE,GAAG,CAAC,OAAO,GAAG,YAAuB,CAAC;gBACtE,MAAM;YACR,KAAK,QAAQ,CAAC;YACd,KAAK,SAAS,CAAC;YACf,KAAK,QAAQ;gBACX,oEAAoE;gBACpE,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;oBAC3D,GAA+B,CAAC,IAAI,GAAG,QAAQ,CAAC;gBACnD,CAAC;qBAAM,IAAI,eAAe,KAAK,CAAC,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;oBACpE,mDAAmD;oBAClD,GAA+B,CAAC,IAAI,GAAG,YAAY,CAAC;oBACrD,eAAe,EAAE,CAAC;gBACpB,CAAC;qBAAM,CAAC;oBACL,GAA+B,CAAC,IAAI,GAAG,QAAQ,CAAC;gBACnD,CAAC;gBACD,IAAI,YAAY,KAAK,SAAS;oBAAE,GAAG,CAAC,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;gBACnE,MAAM;YACR;gBACG,GAA+B,CAAC,IAAI,GAAG,QAAQ,CAAC;QACrD,CAAC;QAED,IAAI,CAAC,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC;IAC1C,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/completion.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shell completion generator — outputs a script for bash/zsh.
+ *
+ * Sources: scanned frond handlers (commands) + entity fields (flags).
+ */
+import type { App } from '@fougere/core';
+export declare function generateZshCompletion(app: App, binName?: string): string;
+export declare function generateBashCompletion(app: App, binName?: string): string;
+//# sourceMappingURL=completion.d.ts.map

package/dist/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../src/completion.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAsCzC,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,SAAY,GAAG,MAAM,CAmC3E;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,SAAY,GAAG,MAAM,CA8B5E"}

package/dist/completion.js

@@ -0,0 +1,93 @@
+import { inputFields } from '@fougere/schema';
+function toKebab(name) {
+    return name.replace(/[A-Z]/g, (c) => '-' + c.toLowerCase()).replace(/^-/, '');
+}
+function extractCommandMeta(app) {
+    const commands = [];
+    for (const frond of app.fronds) {
+        const handlerMap = new Map(frond.handlers.map((h) => [h.address, h]));
+        for (const entity of frond.entities) {
+            const handler = handlerMap.get(entity.name);
+            if (!handler)
+                continue;
+            let facade;
+            try {
+                facade = app.resolve(handler.name);
+            }
+            catch {
+                continue;
+            }
+            if (typeof facade.execute !== 'function')
+                continue;
+            const fields = entity.entityClass.getFields();
+            const flags = Object.keys(inputFields(fields))
+                .map((key) => `--${toKebab(key)}`);
+            commands.push({ name: toKebab(entity.name), flags });
+        }
+    }
+    return commands;
+}
+export function generateZshCompletion(app, binName = 'fougere') {
+    const commands = extractCommandMeta(app);
+    const cmdNames = commands.map((c) => c.name).join(' ');
+    const flagCases = commands
+        .map((cmd) => {
+        const flags = cmd.flags.join(' ');
+        return `      ${cmd.name}) flags="${flags}" ;;`;
+    })
+        .join('\n');
+    return `# Auto-generated by @fougere/cli
+
+_${binName}() {
+  local -a commands flags
+  commands=(${commands.map((c) => `'${c.name}'`).join(' ')})
+
+  if (( CURRENT == 2 )); then
+    _describe 'command' commands
+    return
+  fi
+
+  local cmd=\${words[2]}
+  case "$cmd" in
+${flagCases}
+      *) flags="" ;;
+  esac
+
+  if [[ "\${words[CURRENT]}" == --* ]]; then
+    _values 'flags' \${(s: :)flags}
+  fi
+}
+
+compdef _${binName} ${binName}
+`;
+}
+export function generateBashCompletion(app, binName = 'fougere') {
+    const commands = extractCommandMeta(app);
+    const cmdNames = commands.map((c) => c.name).join(' ');
+    const flagCases = commands
+        .map((cmd) => {
+        const flags = cmd.flags.join(' ');
+        return `      ${cmd.name}) COMPREPLY=( $(compgen -W "${flags}" -- "\${cur}") ) ;;`;
+    })
+        .join('\n');
+    return `# Auto-generated by @fougere/cli
+_${binName}_completions() {
+  local cur prev cmd
+  cur="\${COMP_WORDS[COMP_CWORD]}"
+  prev="\${COMP_WORDS[COMP_CWORD-1]}"
+  cmd="\${COMP_WORDS[1]}"
+
+  if [[ \${COMP_CWORD} -eq 1 ]]; then
+    COMPREPLY=( $(compgen -W "${cmdNames}" -- "\${cur}") )
+    return
+  fi
+
+  case "$cmd" in
+${flagCases}
+  esac
+}
+
+complete -F _${binName}_completions ${binName}
+`;
+}
+//# sourceMappingURL=completion.js.map

package/dist/completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.js","sourceRoot":"","sources":["../src/completion.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAChF,CAAC;AAOD,SAAS,kBAAkB,CAAC,GAAQ;IAClC,MAAM,QAAQ,GAAkB,EAAE,CAAC;IAEnC,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAEtE,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,CAAC,OAAO;gBAAE,SAAS;YAEvB,IAAI,MAAgC,CAAC;YACrC,IAAI,CAAC;gBAAC,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,SAAS;YAAC,CAAC;YAC/D,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU;gBAAE,SAAS;YAEnD,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC;YAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;iBAC3C,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAErC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAQ,EAAE,OAAO,GAAG,SAAS;IACjE,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEvD,MAAM,SAAS,GAAG,QAAQ;SACvB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO,SAAS,GAAG,CAAC,IAAI,YAAY,KAAK,MAAM,CAAC;IAClD,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;;GAEN,OAAO;;cAEI,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;;;;;;;;;EASxD,SAAS;;;;;;;;;WASA,OAAO,IAAI,OAAO;CAC5B,CAAC;AACF,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,GAAQ,EAAE,OAAO,GAAG,SAAS;IAClE,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEvD,MAAM,SAAS,GAAG,QAAQ;SACvB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO,SAAS,GAAG,CAAC,IAAI,+BAA+B,KAAK,sBAAsB,CAAC;IACrF,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;GACN,OAAO;;;;;;;gCAOsB,QAAQ;;;;;EAKtC,SAAS;;;;eAII,OAAO,gBAAgB,OAAO;CAC5C,CAAC;AACF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { run } from './runner.js';
+export { entityToArgs } from './bridge.js';
+export { generateZshCompletion, generateBashCompletion } from './completion.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}