@almadar/orb 4.3.0 → 4.6.4

package/README.md

@@ -1,45 +1,83 @@
-# @almadar/cli
+# @almadar/orb
 
-Almadar CLI - Compile Almadar schemas to full-stack applications.
+Orb CLI — compile .orb programs to full-stack applications.
 
 ## Installation
 
 ```bash
-npm install -g @almadar/cli
+npm install -g @almadar/orb
+```
+
+Or use the curl installer:
+
+```bash
+curl -fsSL https://orb.almadar.io/install.sh | sh
 ```
 
 ## Usage
 
 ```bash
-# Validate a schema
-almadar validate schema.orb
+# Validate an .orb file (0 errors, 0 warnings required)
+orbital validate app.orb
 
-# Compile to TypeScript (React + Express)
-almadar compile schema.orb --shell typescript
+# Lower .lolo syntax to .orb JSON IR
+orbital emit-orb app.orb
 
-# Compile to Python (FastAPI + PyTorch)
-almadar compile schema.orb --shell python
+# Compile to TypeScript shell
+orbital compile app.orb --shell typescript
 
 # Start development server
-almadar dev schema.orb
+orbital dev app.orb
+```
+
+## Quick Example
+
+```lolo
+orbital TaskApp {
+  entity Task [persistent: tasks] {
+    id     : string!
+    title  : string!
+    status : string = "pending"
+  }
+
+  trait TaskBrowser -> Task [interaction] {
+    state browsing {
+      INIT -> browsing
+        (fetch Task)
+        (render-ui main { type: "entity-table", entity: "Task", fields: ["title", "status"] })
+      CREATE -> creating
+        (render-ui modal { type: "modal", isOpen: true, title: "New Task",
+          children: [{ type: "form-section", entity: "Task", fields: ["title", "status"], mode: "create" }] })
+    }
+    state creating {
+      SAVE -> browsing
+        (persist create Task @payload.data)
+        (render-ui modal null)
+      CANCEL -> browsing
+        (render-ui modal null)
+    }
+  }
+
+  page "/tasks" -> TaskBrowser
+}
 ```
 
 ## Commands
 
 | Command | Description |
 |---------|-------------|
-| `almadar validate <file>` | Validate an Almadar schema |
-| `almadar parse <file>` | Parse and display schema information |
-| `almadar compile <file>` | Compile schema to generated code |
-| `almadar serve <file>` | Start the Almadar server runtime |
-| `almadar gui <file>` | Start the Almadar desktop GUI |
-| `almadar dev <file>` | Start both server and client (dev mode) |
+| `orbital validate <file>` | Validate an .orb file |
+| `orbital emit-orb <file>` | Lower .lolo to .orb JSON (stdout) |
+| `orbital compile <file>` | Compile to generated code |
+| `orbital dev <file>` | Start development server |
+| `orbital new <name>` | Create a new project |
 
 ## Documentation
 
-- [Getting Started](https://almadar.io/docs/en/getting-started)
-- [CLI Reference](https://almadar.io/docs/en/reference/cli)
+- [Getting Started](https://orb.almadar.io/docs/getting-started/introduction)
+- [CLI Reference](https://orb.almadar.io/docs/reference/cli)
+- [Language Reference](https://orb.almadar.io/docs/core-concepts/entities)
 
 ## License
 
-MIT
+BSL 1.1

package/bin/{almadar → orb}

@@ -4,19 +4,18 @@ const { execFileSync } = require('child_process');
 const path = require('path');
 const fs = require('fs');
 
-const BINARY_NAME = process.platform === 'win32' ? 'almadar.exe' : 'almadar';
+const BINARY_NAME = process.platform === 'win32' ? 'orb.exe' : 'orb';
 
 function getBinaryPath() {
   const platform = process.platform;
   const arch = process.arch;
 
-  // Map Node.js platform/arch to package names
   const platformMap = {
-    'darwin-x64': '@almadar/cli-darwin-x64',
-    'darwin-arm64': '@almadar/cli-darwin-arm64',
-    'linux-x64': '@almadar/cli-linux-x64',
-    'linux-arm64': '@almadar/cli-linux-arm64',
-    'win32-x64': '@almadar/cli-windows-x64',
+    'darwin-x64': '@almadar/orb-darwin-x64',
+    'darwin-arm64': '@almadar/orb-darwin-arm64',
+    'linux-x64': '@almadar/orb-linux-x64',
+    'linux-arm64': '@almadar/orb-linux-arm64',
+    'win32-x64': '@almadar/orb-windows-x64',
   };
 
   const key = `${platform}-${arch}`;
@@ -24,64 +23,71 @@ function getBinaryPath() {
 
   if (!packageName) {
     console.error(`Unsupported platform: ${platform}-${arch}`);
-    console.error('Supported platforms: darwin-x64, darwin-arm64, linux-x64, linux-arm64, win32-x64');
+    console.error('Supported: darwin-x64, darwin-arm64, linux-x64, linux-arm64, win32-x64');
     process.exit(1);
   }
 
-  // Try to find the binary in node_modules
   const possiblePaths = [
-    // Installed as dependency
     path.join(__dirname, '..', 'node_modules', packageName, BINARY_NAME),
-    // Hoisted to parent node_modules
     path.join(__dirname, '..', '..', packageName, BINARY_NAME),
-    // Global install
     path.join(__dirname, '..', '..', '..', packageName, BINARY_NAME),
   ];
 
   for (const binaryPath of possiblePaths) {
     if (fs.existsSync(binaryPath)) {
-      return binaryPath;
+      return { binaryPath, platformDir: path.dirname(binaryPath) };
     }
   }
 
-  console.error(`Could not find Almadar binary for ${platform}-${arch}`);
-  console.error('Please try reinstalling: npm install -g @almadar/cli');
+  console.error(`Could not find Orb binary for ${platform}-${arch}`);
+  console.error('Try reinstalling: npm install -g @almadar/orb');
   process.exit(1);
 }
 
 function getShellsDir() {
-  // If user has set ORBITAL_SHELLS_DIR, respect it
   if (process.env.ORBITAL_SHELLS_DIR) {
     return process.env.ORBITAL_SHELLS_DIR;
   }
 
-  // Look for shells bundled with this package
   const possiblePaths = [
-    // Shells in same package
     path.join(__dirname, '..', 'shells'),
-    // Global install - shells might be one level up
-    path.join(__dirname, '..', '..', '@almadar', 'cli', 'shells'),
+    path.join(__dirname, '..', '..', '@almadar', 'orb', 'shells'),
   ];
 
   for (const shellsPath of possiblePaths) {
-    if (fs.existsSync(shellsPath) && fs.existsSync(path.join(shellsPath, 'typescript-shell'))) {
+    if (fs.existsSync(shellsPath) && (
+      fs.existsSync(path.join(shellsPath, 'almadar-shell')) ||
+      fs.existsSync(path.join(shellsPath, 'typescript-shell'))
+    )) {
       return shellsPath;
     }
   }
 
-  // No bundled shells found - binary will use its fallback or error
   return null;
 }
 
-const binaryPath = getBinaryPath();
+const { binaryPath, platformDir } = getBinaryPath();
 const shellsDir = getShellsDir();
 
-// Build environment with ORBITAL_SHELLS_DIR if we found shells
 const env = { ...process.env };
+
 if (shellsDir) {
   env.ORBITAL_SHELLS_DIR = shellsDir;
 }
 
+// Bun runtime (sibling to Rust binary in platform package)
+const bunName = process.platform === 'win32' ? 'bun.exe' : 'bun';
+const bunPath = path.join(platformDir, bunName);
+if (fs.existsSync(bunPath)) {
+  env.ORB_BUN_PATH = bunPath;
+}
+
+// Agent dist (agent/ directory in platform package)
+const agentDir = path.join(platformDir, 'agent');
+if (fs.existsSync(agentDir)) {
+  env.ORB_AGENT_DIR = agentDir;
+}
+
 try {
   execFileSync(binaryPath, process.argv.slice(2), {
     stdio: 'inherit',

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@almadar/orb",
-  "version": "4.3.0",
-  "description": "Orb CLI - Compile Orbital schemas to full-stack applications",
+  "version": "4.6.4",
+  "description": "Orb CLI - deterministic when it can be, intelligent when it needs to be",
   "license": "BSL-1.1",
   "repository": {
     "type": "git",
-    "url": "https://github.com/almadar-io/almadar.git",
+    "url": "https://github.com/almadar-io/orb.git",
     "directory": "cli/npm"
   },
   "homepage": "https://orb.almadar.io",
   "bugs": {
-    "url": "https://github.com/almadar-io/almadar/issues"
+    "url": "https://github.com/almadar-io/orb/issues"
   },
   "keywords": [
     "orb",
@@ -49,10 +49,10 @@
     "node": ">=16.0.0"
   },
   "optionalDependencies": {
-    "@almadar/orb-darwin-x64": "4.3.0",
-    "@almadar/orb-darwin-arm64": "4.3.0",
-    "@almadar/orb-linux-x64": "4.3.0",
-    "@almadar/orb-linux-arm64": "4.3.0",
-    "@almadar/orb-windows-x64": "4.3.0"
+    "@almadar/orb-darwin-x64": "4.6.4",
+    "@almadar/orb-darwin-arm64": "4.6.4",
+    "@almadar/orb-linux-x64": "4.6.4",
+    "@almadar/orb-linux-arm64": "4.6.4",
+    "@almadar/orb-windows-x64": "4.6.4"
   }
 }

package/scripts/postinstall.js

@@ -7,35 +7,45 @@ const platform = process.platform;
 const arch = process.arch;
 
 const platformMap = {
-  'darwin-x64': '@almadar/cli-darwin-x64',
-  'darwin-arm64': '@almadar/cli-darwin-arm64',
-  'linux-x64': '@almadar/cli-linux-x64',
-  'linux-arm64': '@almadar/cli-linux-arm64',
-  'win32-x64': '@almadar/cli-windows-x64',
+  'darwin-x64': '@almadar/orb-darwin-x64',
+  'darwin-arm64': '@almadar/orb-darwin-arm64',
+  'linux-x64': '@almadar/orb-linux-x64',
+  'linux-arm64': '@almadar/orb-linux-arm64',
+  'win32-x64': '@almadar/orb-windows-x64',
 };
 
 const key = `${platform}-${arch}`;
 const packageName = platformMap[key];
 
 if (!packageName) {
-  console.warn(`\n⚠️  Almadar CLI: No pre-built binary for ${platform}-${arch}`);
-  console.warn('   You can build from source: https://github.com/almadar-io/almadar#building-from-source\n');
+  console.warn(`\n  Orb CLI: No pre-built binary for ${platform}-${arch}`);
+  console.warn('  Build from source: https://github.com/almadar-io/orb#building-from-source\n');
   process.exit(0);
 }
 
-// Check if the platform-specific package was installed
 const possiblePaths = [
   path.join(__dirname, '..', 'node_modules', packageName),
   path.join(__dirname, '..', '..', packageName),
   path.join(__dirname, '..', '..', '..', packageName),
 ];
 
-const found = possiblePaths.some(p => fs.existsSync(p));
+const platformDir = possiblePaths.find(p => fs.existsSync(p));
 
-if (found) {
-  console.log(`✅ Almadar CLI installed for ${platform}-${arch}`);
-} else {
-  console.warn(`\n⚠️  Almadar CLI: Platform package ${packageName} not found`);
-  console.warn('   This may happen if optional dependencies were skipped.');
-  console.warn('   Try: npm install -g @almadar/cli --include=optional\n');
+if (!platformDir) {
+  console.warn(`\n  Orb CLI: Platform package ${packageName} not found`);
+  console.warn('  Try: npm install -g @almadar/orb --include=optional\n');
+  process.exit(0);
 }
+
+// Verify components
+const binaryName = platform === 'win32' ? 'orb.exe' : 'orb';
+const bunName = platform === 'win32' ? 'bun.exe' : 'bun';
+
+const hasBinary = fs.existsSync(path.join(platformDir, binaryName));
+const hasBun = fs.existsSync(path.join(platformDir, bunName));
+const hasAgent = fs.existsSync(path.join(platformDir, 'agent', 'cli.js'));
+
+console.log(`Orb CLI installed for ${platform}-${arch}:`);
+console.log(`  Binary:  ${hasBinary ? 'ok' : 'missing'}`);
+console.log(`  Bun:     ${hasBun ? 'ok' : 'not bundled (agent features require bun on PATH)'}`);
+console.log(`  Agent:   ${hasAgent ? 'ok' : 'not bundled (agent features unavailable)'}`);

package/shells/almadar-shell/package.json

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

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

@@ -13,11 +13,11 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@almadar/ui": ">=2.34.1",
-    "@almadar/syntax": ">=1.1.0",
-    "@almadar/evaluator": ">=2.6.0",
-    "@almadar/patterns": ">=2.8.12",
-    "@almadar/core": ">=2.9.0",
+    "@almadar/ui": ">=4.4.1",
+    "@almadar/syntax": ">=1.4.0",
+    "@almadar/evaluator": ">=2.9.2",
+    "@almadar/patterns": ">=2.18.1",
+    "@almadar/core": ">=5.8.0",
     "firebase": "^11.4.0",
     "@tanstack/react-query": "^5.67.3",
     "react": "^19.0.0",
@@ -42,7 +42,7 @@
     "postprocessing": "^6.39.0"
   },
   "devDependencies": {
-    "@almadar/eslint-plugin": ">=2.3.0",
+    "@almadar/eslint-plugin": ">=2.8.0",
     "@typescript-eslint/parser": "8.56.0",
     "eslint": "10.0.0",
     "@testing-library/react": "^16.1.0",

package/shells/almadar-shell/packages/client/src/App.tsx

@@ -16,7 +16,6 @@ import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
 import { ThemeProvider, UISlotProvider } from '@almadar/ui/context';
 import { UISlotComponent, NotifyListener } from '@almadar/ui/components';
 import {
-  EntityStoreProvider,
   EventBusProvider,
   VerificationProvider,
 } from '@almadar/ui/providers';
@@ -49,7 +48,6 @@ function App() {
     <I18nProvider value={i18nValue}>
     <QueryClientProvider client={queryClient}>
       <ThemeProvider>
-        <EntityStoreProvider>
         <EventBusProvider>
           <VerificationProvider>
             <UISlotProvider>
@@ -74,7 +72,6 @@ function App() {
             </UISlotProvider>
           </VerificationProvider>
         </EventBusProvider>
-        </EntityStoreProvider>
       </ThemeProvider>
     </QueryClientProvider>
     </I18nProvider>

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

@@ -13,10 +13,11 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@almadar/server": ">=2.1.5",
-    "@almadar/evaluator": ">=2.6.0",
-    "@almadar/core": ">=2.9.0",
-    "@almadar/integrations": ">=2.3.0",
+    "@almadar/server": ">=2.5.0",
+    "@almadar/runtime": ">=4.13.2",
+    "@almadar/evaluator": ">=2.9.2",
+    "@almadar/core": ">=5.8.0",
+    "@almadar/integrations": ">=2.6.1",
     "cors": "^2.8.5",
     "dotenv": "^16.4.7",
     "express": "^4.21.2",
@@ -24,7 +25,7 @@
     "zod": "^3.22.0"
   },
   "devDependencies": {
-    "@almadar/eslint-plugin": ">=2.3.0",
+    "@almadar/eslint-plugin": ">=2.8.0",
     "@typescript-eslint/parser": "8.56.0",
     "@types/cors": "^2.8.17",
     "@types/express": "^5.0.0",

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

@@ -5,6 +5,7 @@
   "main": "src/index.ts",
   "types": "src/index.ts",
   "dependencies": {
+    "@almadar/core": ">=5.8.0",
     "zod": "^3.22.0"
   }
 }

package/shells/almadar-shell/packages/shared/pnpm-lock.yaml

@@ -0,0 +1,22 @@
+lockfileVersion: '9.0'
+
+settings:
+  autoInstallPeers: true
+  excludeLinksFromLockfile: false
+
+importers:
+
+  .:
+    dependencies:
+      zod:
+        specifier: ^3.22.0
+        version: 3.25.76
+
+packages:
+
+  zod@3.25.76:
+    resolution: {integrity: sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ==}
+
+snapshots:
+
+  zod@3.25.76: {}