@beignet/cli 0.0.48 → 0.0.49

package/src/check.ts

@@ -1,4 +1,4 @@
-import { readFile } from "node:fs/promises";
+import { readdir, readFile, stat } from "node:fs/promises";
 import path from "node:path";
 import { createPainter } from "./ansi.js";
 import { detectPackageManager, spawnCommand } from "./db.js";
@@ -75,6 +75,7 @@ export async function checkApp(
   options: CheckAppOptions = {},
 ): Promise<CheckAppResult> {
   const targetDir = path.resolve(options.cwd ?? process.cwd());
+  const scripts = await readAppPackageScripts(targetDir);
   const runner = await detectPackageManager(targetDir);
   const steps: CheckStep[] = [];
   const record = (step: CheckStep): void => {
@@ -99,7 +100,6 @@ export async function checkApp(
     );
   }
 
-  const scripts = await readPackageScripts(targetDir);
   for (const script of scriptStepNames) {
     options.signal?.throwIfAborted();
     record(await scriptStep(targetDir, runner, script, scripts, options));
@@ -269,7 +269,7 @@ async function scriptStep(
   };
 }
 
-async function readPackageScripts(
+async function readAppPackageScripts(
   targetDir: string,
 ): Promise<Record<string, string>> {
   let source: string;
@@ -282,11 +282,59 @@ async function readPackageScripts(
   }
 
   const parsed = JSON.parse(source) as {
+    dependencies?: Record<string, string>;
+    optionalDependencies?: Record<string, string>;
     scripts?: Record<string, string>;
   };
+  const dependencies = {
+    ...parsed.dependencies,
+    ...parsed.optionalDependencies,
+  };
+  if (
+    !["@beignet/core", "@beignet/next", "@beignet/web"].some(
+      (packageName) => dependencies[packageName] !== undefined,
+    )
+  ) {
+    throw new Error(
+      "package.json does not declare a Beignet runtime dependency. Run beignet check from a Beignet app root that depends on @beignet/core, @beignet/next, or @beignet/web.",
+    );
+  }
+  if (!(await hasBeignetAppStructure(targetDir))) {
+    throw new Error(
+      "package.json declares a Beignet runtime dependency, but no Beignet app structure was found. Run beignet check from an app root containing app-context.ts, beignet.config.*, or features/ with server/index.ts.",
+    );
+  }
   return parsed.scripts ?? {};
 }
 
+async function hasBeignetAppStructure(targetDir: string): Promise<boolean> {
+  const entries = await readdir(targetDir, { withFileTypes: true });
+  const entryByName = new Map(entries.map((entry) => [entry.name, entry]));
+  if (entryByName.get("app-context.ts")?.isFile()) return true;
+  if (
+    [
+      "beignet.config.ts",
+      "beignet.config.json",
+      "beignet.config.mjs",
+      "beignet.config.js",
+    ].some((file) => entryByName.get(file)?.isFile())
+  ) {
+    return true;
+  }
+  if (
+    !entryByName.get("features")?.isDirectory() ||
+    !entryByName.get("server")?.isDirectory()
+  ) {
+    return false;
+  }
+
+  try {
+    return (await stat(path.join(targetDir, "server/index.ts"))).isFile();
+  } catch {
+    return false;
+  }
+}
+
 async function preflightStep(
   targetDir: string,
   options: {

package/src/explain.ts

@@ -795,7 +795,7 @@ const conventionsByTargetKind = {
   ],
   job: [
     "Jobs represent background work and remain explicit at provider-backed execution boundaries.",
-    "Feature jobs register through central runtime or outbox registries before workers can dispatch them.",
+    "Feature jobs register through central runtime or outbox registries before workers can dispatch them; registration does not install the required jobs port.",
   ],
   schedule: [
     "Schedules represent time-based triggers and delegate work to application workflows.",
@@ -819,11 +819,11 @@ const conventionsByTargetKind = {
   ],
   registry: [
     "Registries explicitly compose feature declarations into the runtime surface inspected by doctor and app-map.",
-    "Central registries remain the source of truth for runtime wiring and integrity checks.",
+    "Central registries remain the source of truth for runtime wiring and integrity checks; outbox registries containing jobs depend on a bound or deferred jobs dispatcher.",
   ],
   port: [
     "Ports define app-facing dependency interfaces; infrastructure adapters provide their concrete implementations.",
-    "App ports wire through infra/port-wiring.ts and remain available to use cases through application context.",
+    "App ports wire through the configured port-wiring file and remain available to use cases through application context; deferred ports are verified during server startup.",
   ],
   provider: [
     "Ports define app-facing interfaces, providers adapt external systems, and app infrastructure wires them together.",
@@ -839,7 +839,7 @@ const conventionsByTargetKind = {
   ],
   entrypoint: [
     "Runtime entrypoints compose the server or expose thin framework adapters over registered routes.",
-    "Entrypoints reuse central context, routes, providers, and workflow registries instead of duplicating application behavior.",
+    "Entrypoints reuse central context, routes, providers, and workflow registries instead of duplicating application behavior; outbox drains require delivery ports before they claim messages.",
   ],
   test: [
     "Feature behavior tests stay under features/<feature>/tests and exercise use cases, routes, policies, workflows, and UI.",