@ultimat3/cli 27.3.0 → 27.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/cli",
-  "version": "27.3.0",
+  "version": "27.4.0",
   "description": "The `x` binary: new, dev, build, verify, generate, db, mcp, doctor, deploy",
   "license": "MIT",
   "type": "module",
@@ -39,33 +39,33 @@
   },
   "dependencies": {
     "@babel/core": "^8.0.1",
-    "@ultimat3/action": "27.3.0",
-    "@ultimat3/admin": "27.3.0",
-    "@ultimat3/ai": "27.3.0",
-    "@ultimat3/auth": "27.3.0",
-    "@ultimat3/cache": "27.3.0",
-    "@ultimat3/core": "27.3.0",
-    "@ultimat3/db": "27.3.0",
-    "@ultimat3/entity": "27.3.0",
-    "@ultimat3/flags": "27.3.0",
-    "@ultimat3/http": "27.3.0",
-    "@ultimat3/i18n": "27.3.0",
-    "@ultimat3/jobs": "27.3.0",
-    "@ultimat3/mail": "27.3.0",
-    "@ultimat3/manifest": "27.3.0",
-    "@ultimat3/mcp": "27.3.0",
-    "@ultimat3/money": "27.3.0",
-    "@ultimat3/notify": "27.3.0",
-    "@ultimat3/policy": "27.3.0",
-    "@ultimat3/pwa": "27.3.0",
-    "@ultimat3/query": "27.3.0",
-    "@ultimat3/realtime": "27.3.0",
-    "@ultimat3/render": "27.3.0",
-    "@ultimat3/schema": "27.3.0",
-    "@ultimat3/seo": "27.3.0",
-    "@ultimat3/storage": "27.3.0",
-    "@ultimat3/testing": "27.3.0",
-    "@ultimat3/time": "27.3.0",
+    "@ultimat3/action": "27.4.0",
+    "@ultimat3/admin": "27.4.0",
+    "@ultimat3/ai": "27.4.0",
+    "@ultimat3/auth": "27.4.0",
+    "@ultimat3/cache": "27.4.0",
+    "@ultimat3/core": "27.4.0",
+    "@ultimat3/db": "27.4.0",
+    "@ultimat3/entity": "27.4.0",
+    "@ultimat3/flags": "27.4.0",
+    "@ultimat3/http": "27.4.0",
+    "@ultimat3/i18n": "27.4.0",
+    "@ultimat3/jobs": "27.4.0",
+    "@ultimat3/mail": "27.4.0",
+    "@ultimat3/manifest": "27.4.0",
+    "@ultimat3/mcp": "27.4.0",
+    "@ultimat3/money": "27.4.0",
+    "@ultimat3/notify": "27.4.0",
+    "@ultimat3/policy": "27.4.0",
+    "@ultimat3/pwa": "27.4.0",
+    "@ultimat3/query": "27.4.0",
+    "@ultimat3/realtime": "27.4.0",
+    "@ultimat3/render": "27.4.0",
+    "@ultimat3/schema": "27.4.0",
+    "@ultimat3/seo": "27.4.0",
+    "@ultimat3/storage": "27.4.0",
+    "@ultimat3/testing": "27.4.0",
+    "@ultimat3/time": "27.4.0",
     "babel-preset-solid": "^1.9.15"
   }
 }

package/src/app-layout.ts

@@ -0,0 +1,46 @@
+// The one feature layout, made a build error: a primitive module `actions.ts` (or `live`,
+// `queries`, `jobs`, `tasks`) beside the directory of the same name is refused. `x g` writes the
+// directory form — `<slice>/actions/<name>.ts`, one primitive per file — and an app that also keeps
+// `actions.ts` has two homes for one kind of thing, where `./actions` resolves to the file and never
+// the directory. A component module beside its folder (`ui.tsx` + `ui/`) is not a primitive's home,
+// and `x g resource` writes exactly that pair.
+
+import { ERROR_DOCS_URL } from '@ultimat3/core';
+import type { SourceFile } from './app-boundaries';
+import type { Finding } from './output';
+
+/** The directories `x g` writes primitives into — the only names the refusal reads. */
+export const PRIMITIVE_DIRS: ReadonlySet<string> = new Set([
+  'actions',
+  'live',
+  'queries',
+  'jobs',
+  'tasks',
+]);
+
+const MODULE = /^(?<stem>.+)\.(?:ts|tsx)$/;
+
+/** Every primitive module `X.ts` among `files` beside a directory `X/` holding another of them. */
+export function siblingModuleFindings(files: readonly SourceFile[]): readonly Finding[] {
+  const directories = new Set<string>();
+  for (const { path } of files) {
+    const parts = path.split('/');
+    for (let depth = 1; depth < parts.length; depth += 1) {
+      directories.add(parts.slice(0, depth).join('/'));
+    }
+  }
+  return files.flatMap(({ path }): Finding[] => {
+    const stem = MODULE.exec(path)?.groups?.['stem'];
+    const name = stem?.split('/').at(-1) ?? '';
+    if (stem === undefined || !PRIMITIVE_DIRS.has(name) || !directories.has(stem)) return [];
+    return [
+      {
+        code: 'X_LAYOUT_SIBLING_MODULE',
+        cause: `${path} sits beside the directory ${stem}/ — \`./${name}\` resolves to the file, and the directory form is the one layout`,
+        fix: `x verify --only boundaries --json   # move each declaration in ${path} to ${stem}/<its-export-in-kebab-case>.ts, then delete ${path}`,
+        docs: ERROR_DOCS_URL,
+        at: path,
+      },
+    ];
+  });
+}

package/src/boundary-findings.ts

@@ -5,6 +5,7 @@
 
 import type { SourceFile } from './app-boundaries';
 import { appImportGraph, checkImportRules, readAppSources } from './app-boundaries';
+import { siblingModuleFindings } from './app-layout';
 import { appTransportFindings } from './app-transport';
 import { planBoundaryCuts } from './boundary-cuts';
 import type { Finding } from './output';
@@ -44,5 +45,6 @@ export async function appBoundaryFindings(
   return [
     ...withCutEdits(checkImportRules(files), appImportGraph(files)),
     ...(await appTransportFindings(root, files)),
+    ...siblingModuleFindings(files),
   ];
 }

package/src/error-codes.ts

@@ -232,6 +232,7 @@ export const CLI_OWNED_ERROR_CODES = [
   'X_PACKAGE_TEST_ONLY_SHIPPED',
   'X_ISLAND_MODULE_DUPLICATED',
   'X_BACKFILL_SLICE_ENTITY',
+  'X_LAYOUT_SIBLING_MODULE',
 ] as const;
 
 /**
@@ -420,6 +421,7 @@ export const CLI_ERROR_TITLES: Readonly<Record<CliOwnedErrorCode, string>> = {
   X_PACKAGE_TEST_ONLY_SHIPPED: 'a test-only module ships in the tarball',
   X_ISLAND_MODULE_DUPLICATED: 'An island chunk bundles one module more than once',
   X_BACKFILL_SLICE_ENTITY: 'the slice holds no entity a generated backfill can sweep',
+  X_LAYOUT_SIBLING_MODULE: 'a primitive module beside its directory',
 };
 
 // One unconditional call, so a second package claiming one of the CLI's codes throws

package/src/mcp-errors.ts

@@ -302,6 +302,8 @@ const CLI_FIXES: Readonly<Record<CliErrorCode, string>> = {
     'gh issue create --repo developerz-ai/ultimate --title "X_ISLAND_MODULE_DUPLICATED"   # paste this error\'s --json as the body: the framework bundled one of its own modules twice',
   X_BACKFILL_SLICE_ENTITY:
     'x errors explain X_BACKFILL_SLICE_ENTITY --json   # the refusal itself names the x g job line for this slice',
+  X_LAYOUT_SIBLING_MODULE:
+    'x verify --only boundaries --json   # then move each declaration in X.ts to X/<name>.ts, one primitive per file',
 };
 
 const isCliCode = (code: string): code is CliErrorCode =>