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

package/dist/{ui.js → src/ui.js}

@@ -1,30 +1,33 @@
 /** Fougere CLI UI — beautiful terminal interface. */
-import * as clack from '@clack/prompts';
+import { createRequire } from 'node:module';
 import pc from 'picocolors';
-import { consola } from 'consola';
 import { defaultTheme } from './theme.js';
+const load = createRequire(import.meta.url);
+let loaded;
+/** Loaded at the first prompt or line it draws — `fougere --help` draws none. */
+const clack = () => (loaded ??= load('@clack/prompts'));
 export function ui(options) {
     const c = { ...defaultTheme, ...options?.colors };
     return {
         // ── Lifecycle ─────────────────────────────────
         /** Start a new CLI session with a branded header. */
         intro(title = 'Fougere') {
-            clack.intro(c.brand(title));
+            clack().intro(c.brand(title));
         },
         /** End the session with a message. */
         outro(message) {
-            clack.outro(c.success(message));
+            clack().outro(c.success(message));
         },
         /** Cancel and exit. */
         cancel(message = 'Cancelled.') {
-            clack.cancel(c.muted(message));
+            clack().cancel(c.muted(message));
             process.exit(0);
         },
         // ── Prompts ───────────────────────────────────
         /** Text input. */
         async text(opts) {
-            const result = await clack.text(opts);
-            if (clack.isCancel(result)) {
+            const result = await clack().text(opts);
+            if (clack().isCancel(result)) {
                 this.cancel();
                 return '';
             }
@@ -32,8 +35,8 @@ export function ui(options) {
         },
         /** Yes/no confirmation. */
         async confirm(opts) {
-            const result = await clack.confirm(opts);
-            if (clack.isCancel(result)) {
+            const result = await clack().confirm(opts);
+            if (clack().isCancel(result)) {
                 this.cancel();
                 return false;
             }
@@ -41,8 +44,8 @@ export function ui(options) {
         },
         /** Select one from a list. */
         async select(opts) {
-            const result = await clack.select(opts);
-            if (clack.isCancel(result)) {
+            const result = await clack().select(opts);
+            if (clack().isCancel(result)) {
                 this.cancel();
                 return '';
             }
@@ -50,8 +53,8 @@ export function ui(options) {
         },
         /** Multi-select from a list. */
         async multiselect(opts) {
-            const result = await clack.multiselect(opts);
-            if (clack.isCancel(result)) {
+            const result = await clack().multiselect(opts);
+            if (clack().isCancel(result)) {
                 this.cancel();
                 return [];
             }
@@ -60,7 +63,7 @@ export function ui(options) {
         // ── Spinner ───────────────────────────────────
         /** Start a spinner. Returns stop/update functions. */
         spinner(message) {
-            const s = clack.spinner();
+            const s = clack().spinner();
             s.start(message);
             return {
                 update: (msg) => s.message(msg),
@@ -70,32 +73,31 @@ export function ui(options) {
         // ── Output ────────────────────────────────────
         /** Informational message. */
         info(message) {
-            clack.log.info(message);
+            clack().log.info(message);
         },
         /** Success message. */
         success(message) {
-            clack.log.success(c.success(message));
+            clack().log.success(c.success(message));
         },
         /** Warning message. */
         warn(message) {
-            clack.log.warn(c.warn(message));
+            clack().log.warn(c.warn(message));
         },
         /** Error message. */
         error(message) {
-            clack.log.error(c.error(message));
+            clack().log.error(c.error(message));
         },
         /** Step indicator. */
         step(message) {
-            clack.log.step(message);
+            clack().log.step(message);
         },
         /** Note box — multiline content in a box. */
         note(message, title) {
-            clack.note(message, title);
+            clack().note(message, title);
         },
-        // ── Raw colors/consola ────────────────────────
+        // ── Raw colors ────────────────────────────────
         colors: c,
         pc,
-        consola,
     };
 }
 //# sourceMappingURL=ui.js.map

package/dist/src/ui.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fougere/cli",
-  "version": "0.12.5-alpha.0",
+  "version": "0.13.0-alpha.0",
   "description": "The Fougere CLI — compose a workspace, serve a frond, call an operation.",
   "keywords": [
     "fougere",
@@ -16,54 +16,50 @@
     "directory": "packages/cli"
   },
   "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
   "bin": {
-    "fougere": "dist/bin.js"
+    "fougere": "dist/src/bin.js"
   },
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
     },
-    "./bin": "./dist/bin.js"
+    "./bin": "./dist/src/bin.js"
   },
   "files": [
     "dist",
-    "app",
-    "fronds",
-    "templates",
-    "src"
+    "templates"
   ],
   "dependencies": {
     "@clack/prompts": "^0.10.0",
+    "@fougere/compiler": "0.13.0-alpha.0",
+    "@fougere/container": "0.13.0-alpha.0",
+    "@fougere/core": "0.13.0-alpha.0",
+    "@fougere/defaults": "0.13.0-alpha.0",
+    "@fougere/schema": "0.13.0-alpha.0",
+    "@fougere/testing": "0.13.0-alpha.0",
+    "@fougere/transport-http": "0.13.0-alpha.0",
     "citty": "^0.2.1",
-    "consola": "^3.4.2",
     "jiti": "^2.4.2",
     "picocolors": "^1.1.1",
-    "safe-regex": "^2.1.1",
-    "@fougere/compiler": "0.12.5-alpha.0",
-    "@fougere/container": "0.12.5-alpha.0",
-    "@fougere/core": "0.12.5-alpha.0",
-    "@fougere/schema": "0.12.5-alpha.0",
-    "@fougere/testing": "0.12.5-alpha.0",
-    "@fougere/transport-http": "0.12.5-alpha.0",
-    "@fougere/defaults": "0.12.5-alpha.0"
+    "safe-regex": "^2.1.1"
   },
   "devDependencies": {
-    "vitest": "^4.1.0",
-    "@fougere/next": "0.12.5-alpha.0",
-    "@fougere/nuxt": "0.12.5-alpha.0",
-    "@fougere/oclif": "0.12.5-alpha.0",
-    "@fougere/react": "0.12.5-alpha.0",
-    "@fougere/admin": "0.12.5-alpha.0",
-    "@fougere/svelte": "0.12.5-alpha.0"
+    "@fougere/admin": "0.13.0-alpha.0",
+    "@fougere/next": "0.13.0-alpha.0",
+    "@fougere/nuxt": "0.13.0-alpha.0",
+    "@fougere/oclif": "0.13.0-alpha.0",
+    "@fougere/react": "0.13.0-alpha.0",
+    "@fougere/svelte": "0.13.0-alpha.0",
+    "vitest": "^4.1.0"
   },
   "publishConfig": {
     "access": "public"
   },
   "peerDependencies": {
-    "@fougere/adapter-sql": "^0.12.5-alpha.0"
+    "@fougere/adapter-sql": "^0.13.0-alpha.0"
   },
   "peerDependenciesMeta": {
     "@fougere/adapter-sql": {
@@ -71,7 +67,7 @@
     }
   },
   "scripts": {
-    "build": "rm -rf dist && tsc && chmod +x dist/bin.js && node dist/bin.js build",
+    "build": "rm -rf dist && node scripts/scan.ts && tsc && chmod +x dist/src/bin.js",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit && tsc -p tsconfig.runtime.json && tsc -p tsconfig.templates.json"

package/templates/frond/fronds/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  // A frond is autonomous TypeScript domain code — it typechecks on its own, against this file.
+  "extends": "@fougere/core/tsconfig",
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "lib": ["ESNext"],
+    "types": ["node"],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "rootDir": "."
+  },
+  "include": ["."]
+}

package/templates/workspace/fronds/tsconfig.json

@@ -2,6 +2,7 @@
   // A frond is autonomous TypeScript domain code — it typechecks on its own, against
   // this file, without Nuxt and without `.nuxt/tsconfig.json`. `pnpm typecheck` at the
   // workspace root runs it, and it is the cheapest judge you have.
+  "extends": "@fougere/core/tsconfig",
   "compilerOptions": {
     "target": "ES2022",
     "module": "Node16",
@@ -12,10 +13,7 @@
     "esModuleInterop": true,
     "skipLibCheck": true,
     "noEmit": true,
-    "rootDir": ".",
-    // A frond names its neighbours, it does not walk to them: the alias the Nuxt module
-    // registers at runtime (`@fronds/<name>` → the frond directory), stated for the compiler.
-    "paths": { "@fronds/*": ["./*"] }
+    "rootDir": "."
   },
   "include": ["."]
 }

package/templates/workspace/package.json

@@ -2,7 +2,7 @@
   "name": "fougere-workspace",
   "private": true,
   "type": "module",
-  "packageManager": "pnpm@11.20.0",
+  "packageManager": "pnpm@12.6.0",
   "scripts": {
     "dev": "pnpm --filter './apps/*' --parallel dev",
     "build": "pnpm --filter './apps/*' -r build",

package/templates/workspace/pnpm-workspace.yaml

@@ -2,9 +2,11 @@ packages:
   - fronds/*
   - apps/*
 
-# pnpm 11 fails an install rather than warning about a build script it was not
-# told to run, and it reads the allowlist here — `pnpm.onlyBuiltDependencies` in
-# package.json is the pnpm 10 location, now ignored in silence.
 allowBuilds:
   better-sqlite3: true
   esbuild: true
+
+# A project is created the day a version is published: the delay pnpm can apply to a fresh
+# release would hold back the very version the scaffold was written for.
+minimumReleaseAgeExclude:
+  - '@fougere/*'

package/app/commands/BuildCommand.ts

@@ -1,43 +0,0 @@
-import { createAppRunner } from '@fougere/core';
-import type { App } from '@fougere/core';
-import type { ui as createUi } from '../../src/ui.js';
-import type { BuildReport } from '../../fronds/analysis/handlers/BuildHandler.js';
-import pc from 'picocolors';
-import { machineWanted, printMachine } from '../../src/machine.js';
-
-type Ui = ReturnType<typeof createUi>;
-
-/**
- * `fougere build` — the scan, written down.
- *
- * It reports what the module HOLDS rather than that it was written: a build that found
- * one frond where the project has three has succeeded at the wrong thing, and the path
- * alone does not say so.
- */
-export default class BuildCommand {
-  constructor(private app: App, private ui: Ui) {}
-
-  async run(raw: Record<string, unknown>) {
-    const built = (await createAppRunner(this.app)(
-      { entity: 'build', op: 'execute' },
-      { params: {}, query: {}, input: raw, state: {} },
-    )) as BuildReport;
-
-    if (machineWanted(raw)) return printMachine(built);
-
-    if (built.fronds.length === 0) {
-      this.ui.warn('No fronds found. Run this from a Fougere project root.');
-
-      return;
-    }
-
-    this.ui.success(`${built.path} — ${built.fronds.length} frond(s), ${built.entities} entities, ${built.handlers} handlers`);
-    this.ui.step(built.fronds.map((name) => pc.bold(name)).join(', '));
-
-    // A diagnostic travels INTO the module, so a boot from it says the same thing. Saying
-    // it here too is not a duplicate: this is the moment someone can still fix the source.
-    for (const diagnostic of built.diagnostics) this.ui.warn(diagnostic);
-
-    this.ui.step(pc.dim('hand it to createApp as `scan:` — nothing reads a disk after this'));
-  }
-}

package/app/commands/CallCommand.ts

@@ -1,70 +0,0 @@
-import { createAppRunner } from '@fougere/core';
-import { lowerFirst } from '@fougere/core/contract';
-import { bootApp } from '@fougere/defaults';
-import type { App } from '@fougere/core';
-import type { ui as createUi } from '../../src/ui.js';
-
-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.operation 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 input: Record<string, unknown> = {};
-    for (const [k, v] of Object.entries(flags)) {
-      if (k === 'id') params.id = String(v);
-      else input[k] = v;
-    }
-
-    const app = await bootApp(process.cwd(), {});
-    try {
-      const result = await createAppRunner(app)(
-        { entity: lowerFirst(entityName), op },
-        { params, query: {}, input, state: {} },
-      );
-      this.ui.note(JSON.stringify(result, null, 2), target);
-    } finally {
-      await app.dispose();
-    }
-  }
-}

package/app/commands/CheckCommand.ts

@@ -1,70 +0,0 @@
-import type { CheckResult } from '../../fronds/analysis/handlers/CheckHandler.js';
-import type { Diagnostic } from '@fougere/core';
-import type { App } from '@fougere/core';
-import { createAppRunner } from '@fougere/core';
-import type { ui as createUi } from '../../src/ui.js';
-import pc from 'picocolors';
-import { relative } from 'node:path';
-import { machineWanted, printMachine } from '../../src/machine.js';
-
-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: {}, input: raw, state: {} },
-    ) as CheckResult;
-
-    // A non-zero exit is what makes this usable in CI, so it is decided before the two
-    // renderings rather than inside the terminal one.
-    const blocking = result.findings.filter((f) => f.severity === 'blocking').length;
-    if (blocking > 0) process.exitCode = 1;
-
-    if (machineWanted(raw)) return printMachine(result);
-
-    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');
-
-    // Warnings do not fail: an unresolvable base class with no operation is ordinary,
-    // and a check that cries wolf stops being read.
-    this.ui.info(`${blocking} blocking, ${result.findings.length - blocking} warning(s)`);
-  }
-}
-
-function render(f: Diagnostic): string {
-  const mark = f.severity === 'blocking' ? pc.red('✗') : pc.yellow('⚠');
-  const where = relative(process.cwd(), f.filePath) || f.filePath;
-  const what = f.subject ? ` ${f.subject}` : '';
-
-  return `  ${mark} ${pc.bold(`[${f.code}]`)}${what}\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

@@ -1,24 +0,0 @@
-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/DevtoolsCommand.ts

@@ -1,92 +0,0 @@
-import { createAppRunner } from '@fougere/core';
-import type { App, CallRecord } from '@fougere/core';
-import type { CallsView } from '../../fronds/analysis/handlers/DevtoolsHandler.js';
-import type { ui as createUi } from '../../src/ui.js';
-import { machineWanted, printMachine } from '../../src/machine.js';
-import pc from 'picocolors';
-
-type Ui = ReturnType<typeof createUi>;
-
-/** How long between two reads. Fast enough to read as a stream, cheap enough to ignore. */
-const EVERY_MS = 500;
-
-const ROUTE = { local: pc.green, remote: pc.cyan, system: pc.magenta } as const;
-
-/**
- * `fougere devtools` — the call log of every running app of this project, followed.
- *
- * A cursor per address, because each app numbers its own ring: asking for what this reader
- * has not seen is the whole protocol, and it is per source or nothing.
- */
-export default class DevtoolsCommand {
-  constructor(private app: App, private ui: Ui) {}
-
-  async run(raw: Record<string, unknown>) {
-    const since: Record<string, number> = {};
-
-    if (machineWanted(raw)) return printMachine(await this.view(raw, since));
-
-    const first = await this.view(raw, since);
-    this.announce(first);
-
-    const told: Record<string, number> = {};
-    for (let view = first; ; view = await this.view(raw, since)) {
-      for (const source of view.sources) {
-        since[source.url] = source.cursor;
-
-        // Said once per address, and only when it grows: a ring that dropped is not a
-        // quiet period, and repeating it every half second would bury the calls.
-        if (source.dropped > (told[source.url] ?? 0)) {
-          this.ui.warn(`${source.url} dropped ${source.dropped - (told[source.url] ?? 0)} call(s) — its ring is smaller than this traffic`);
-          told[source.url] = source.dropped;
-        }
-      }
-
-      for (const call of view.calls) process.stdout.write(render(call, view.sources.length > 1) + '\n');
-      await new Promise((wake) => setTimeout(wake, EVERY_MS));
-    }
-  }
-
-  /** What is being watched, and what refused — stated before the first line scrolls. */
-  private announce(view: CallsView): void {
-    for (const source of view.sources) {
-      const name = source.frond ? `${pc.bold(source.frond)} ${pc.dim(source.url)}` : pc.bold(source.url);
-      if (source.refusal) this.ui.warn(`${name} — ${source.refusal}`);
-      else this.ui.step(`following ${name}`);
-    }
-    this.ui.info(pc.dim('ctrl-c to stop'));
-  }
-
-  private view(raw: Record<string, unknown>, since: Record<string, number>): Promise<CallsView> {
-    return createAppRunner(this.app)(
-      { entity: 'devtools', op: 'execute' },
-      { params: {}, query: {}, input: { ...raw, since }, state: {} },
-    ) as Promise<CallsView>;
-  }
-}
-
-function render(call: CallRecord & { source: string }, many: boolean): string {
-  // Padded BEFORE colouring: an escape sequence counts in a string's length, so padding a
-  // coloured value moves the column by however many bytes the colour took.
-  const at = many ? pc.dim(pad(new URL(call.source).port || call.source, 5)) : '';
-  const frond = pc.dim(pad(call.frond ?? '—', 9));
-  const address = pc.bold(pad(`${call.entity}.${call.operation}${call.surface ? `/${call.surface}` : ''}`, 22));
-  const route = call.route
-    ? (ROUTE[call.route] ?? pc.dim)(pad(call.route, 9))
-    : pc.red(pad('unrouted', 9));
-  const took = pc.dim(lead(call.ms === undefined ? '' : `${call.ms}ms`, 7));
-  const verdict = call.verdict === 'failed'
-    ? pc.red(call.refusal?.code ?? 'failed')
-    : call.verdict === 'ok' ? pc.dim('ok') : pc.yellow('running');
-
-  return [at, frond, address, route, took, verdict, call.trace ? pc.dim(call.trace.slice(3, 11)) : '']
-    .filter(Boolean).join(' ');
-}
-
-function pad(value: string, width: number): string {
-  return value.length >= width ? value : value + ' '.repeat(width - value.length);
-}
-
-function lead(value: string, width: number): string {
-  return value.length >= width ? value : ' '.repeat(width - value.length) + value;
-}