@almadar/orb 6.13.0 → 6.15.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/orb",
-  "version": "6.13.0",
+  "version": "6.15.0",
   "description": "Orb CLI - deterministic when it can be, intelligent when it needs to be",
   "license": "BSL-1.1",
   "repository": {
@@ -49,10 +49,10 @@
     "node": ">=16.0.0"
   },
   "optionalDependencies": {
-    "@almadar/orb-darwin-x64": "6.13.0",
-    "@almadar/orb-darwin-arm64": "6.13.0",
-    "@almadar/orb-linux-x64": "6.13.0",
-    "@almadar/orb-linux-arm64": "6.13.0",
-    "@almadar/orb-windows-x64": "6.13.0"
+    "@almadar/orb-darwin-x64": "6.15.0",
+    "@almadar/orb-darwin-arm64": "6.15.0",
+    "@almadar/orb-linux-x64": "6.15.0",
+    "@almadar/orb-linux-arm64": "6.15.0",
+    "@almadar/orb-windows-x64": "6.15.0"
   }
 }

package/shells/almadar-shell/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/shell",
-  "version": "2.13.19",
+  "version": "2.14.0",
   "private": false,
   "description": "Minimal full-stack shell template for Almadar applications",
   "packageManager": "pnpm@10.30.3",

package/shells/almadar-shell/packages/client/eslint.config.cjs

@@ -1,11 +1,31 @@
 "use strict";
 const tsParser = require("@typescript-eslint/parser");
 const almadarPlugin = require("@almadar/eslint-plugin");
+// react-hooks plugin registered so the codegen-emitted
+// `// eslint-disable-next-line react-hooks/exhaustive-deps` comments are
+// well-formed (eslint errors on disable directives that reference
+// unknown rules). The actual rules are left off — enabling them would
+// surface a backlog of dep-array warnings the codegen knows are
+// intentional. Tightening is a separate codegen-fix pass.
+let reactHooksPlugin;
+try {
+  reactHooksPlugin = require("eslint-plugin-react-hooks");
+} catch (_) {
+  reactHooksPlugin = { rules: { "exhaustive-deps": { meta: {}, create: () => ({}) }, "rules-of-hooks": { meta: {}, create: () => ({}) } } };
+}
 
 module.exports = [
   { ignores: ["dist/**", "node_modules/**", "**/*.test.ts", "**/*.test.tsx"] },
   {
     files: ["src/**/*.ts", "src/**/*.tsx"],
+    // The codegen emits `// eslint-disable-next-line react-hooks/exhaustive-deps`
+    // ahead of every mount-only effect's `[]` dep array. Until the real
+    // `eslint-plugin-react-hooks` is wired (it would fire the rule and
+    // make these directives meaningful), the shim's no-op create() means
+    // the rule never reports — so ESLint flags the directives as
+    // "Unused eslint-disable directive". That's a false alarm at this
+    // stage; suppress it so the strict-error rule set still hard-fails.
+    linterOptions: { reportUnusedDisableDirectives: "off" },
     languageOptions: {
       parser: tsParser,
       parserOptions: {
@@ -14,9 +34,22 @@ module.exports = [
         sourceType: "module",
       },
     },
-    plugins: { almadar: almadarPlugin },
+    plugins: { almadar: almadarPlugin, "react-hooks": reactHooksPlugin },
     rules: {
+      // Zero escape hatches in emitted shell code. Each rule pairs with a
+      // codegen-template fix in orbital-rust (see docs/Almadar_Compiler_Gaps.md):
+      // - no-as-any:           catches `as any` casts.
+      // - no-unknown-type:     catches `: unknown` annotations.
+      //                        Service results are typed via the integrations
+      //                        contract; every other "unknown" is a typed
+      //                        shape the codegen knows.
+      // - no-record-string-unknown: catches `as Record<string, unknown>` casts
+      //                        the codegen used to index into entity rows by
+      //                        string key. The entity has a typed interface
+      //                        — emit against that.
       "almadar/no-as-any": "error",
+      "almadar/no-unknown-type": "error",
+      "almadar/no-record-string-unknown": "error",
       "almadar/no-import-generated": "error",
     },
   },

package/shells/almadar-shell/packages/client/package.json

@@ -7,7 +7,7 @@
     "dev": "vite",
     "build": "tsc && vite build",
     "typecheck": "tsc --noEmit",
-    "lint": "eslint src/",
+    "lint": "eslint --max-warnings 0 src/",
     "preview": "vite preview",
     "test": "vitest run --passWithNoTests",
     "test:watch": "vitest"

package/shells/almadar-shell/packages/server/eslint.config.cjs

@@ -12,7 +12,11 @@ module.exports = [
     },
     plugins: { almadar: almadarPlugin },
     rules: {
+      // Zero escape hatches in emitted shell code — same rule set as client;
+      // see docs/Almadar_Compiler_Gaps.md for the per-rule codegen fix.
       "almadar/no-as-any": "error",
+      "almadar/no-unknown-type": "error",
+      "almadar/no-record-string-unknown": "error",
       "almadar/no-import-generated": "error",
     },
   },

package/shells/almadar-shell/packages/server/package.json

@@ -8,7 +8,7 @@
     "build": "esbuild src/index.ts --bundle --platform=node --format=esm --packages=external --outfile=dist/index.js",
     "start": "node dist/index.js",
     "typecheck": "tsc --noEmit",
-    "lint": "eslint src/",
+    "lint": "eslint --max-warnings 0 src/",
     "test": "vitest run --passWithNoTests",
     "test:watch": "vitest"
   },

package/shells/almadar-shell/packages/server/src/types/express.d.ts

@@ -1,3 +1,5 @@
+import type { EventPayloadValue } from '@almadar/core';
+
 declare global {
   namespace Express {
     interface Request {
@@ -6,7 +8,7 @@ declare global {
         email?: string;
         name?: string;
         picture?: string;
-        [key: string]: unknown;
+        [key: string]: EventPayloadValue;
       };
     }
   }