openpalm 0.10.2 → 0.11.0-beta.1

package/README.md

@@ -1,16 +1,14 @@
 # @openpalm/cli
 
-Bun CLI for bootstrapping and managing an OpenPalm installation. The CLI is the primary orchestrator -- all commands work without the admin container. When admin is running, commands optionally delegate to the admin API.
+Bun CLI for bootstrapping and managing an OpenPalm installation. The CLI is the primary orchestrator — all commands operate directly against Docker Compose. Use `openpalm` to start the UI host process.
 
 ## Self-Sufficient Mode
 
-The CLI operates directly against Docker Compose without requiring an admin container:
+The CLI operates directly against Docker Compose:
 
-- **Install** -- creates the `~/.openpalm/` home layout, downloads assets, serves the setup wizard locally via `Bun.serve()`, writes files to their final locations, and starts core services
+- **Install** -- creates the `~/.openpalm/` home layout, downloads assets, spawns the setup wizard via the admin UI, writes files to their final locations, and starts core services
 - **All lifecycle commands** -- refresh files in `~/.openpalm/` when needed, then run Docker Compose directly
-- **Admin delegation** -- the `install` command checks for a running admin and delegates if reachable. Other commands operate directly via Docker Compose.
-
-The admin container is optional. Use `--with-admin` to enable the admin addon overlay in the compose file set.
+- **Admin UI** -- start the host admin server with `openpalm` (no container required)
 
 ## Commands
 
@@ -19,12 +17,10 @@ The admin container is optional. Use `--with-admin` to enable the admin addon ov
 | `openpalm install` | Bootstrap `~/.openpalm/`, download assets, run setup wizard, start core services |
 | `openpalm uninstall` | Stop and remove the stack (preserves config and data) |
 | `openpalm update` | Pull latest images and recreate containers |
-| `openpalm upgrade` | Alias for `update` |
 | `openpalm self-update` | Replace the installed CLI binary with the latest release build |
 | `openpalm addon <enable|disable|list>` | Manage registry addons directly from the CLI |
-| `openpalm admin <enable|disable|status>` | Manage the admin addon directly from the CLI |
 | `openpalm start [svc...]` | Start all or named services |
-| `openpalm start --with-admin` | Start all services including admin UI and docker-socket-proxy |
+| `openpalm` | Start the UI host process server |
 | `openpalm stop [svc...]` | Stop all or named services |
 | `openpalm restart [svc...]` | Restart all or named services |
 | `openpalm logs [svc...]` | Tail last 100 log lines |
@@ -37,14 +33,10 @@ The admin container is optional. Use `--with-admin` to enable the admin addon ov
 
 `--force` skip "already installed" check and create a backup of the current `OP_HOME`, `--version TAG` install a specific ref (default: current CLI version), `--no-start` prepare files only, `--no-open` skip browser launch.
 
-### Admin addon
-
-Admin and docker-socket-proxy start only when explicitly requested:
+### Admin commands
 
 ```bash
-openpalm admin enable           # Enable the admin addon and start its services
-openpalm admin disable          # Stop and disable the admin addon
-openpalm admin status           # Show whether the admin addon is enabled
+openpalm            # Start the UI host process (binds to 127.0.0.1:3880)
 openpalm addon enable chat      # Enable a registry addon and start its services
 openpalm addon disable chat     # Stop and disable a registry addon
 openpalm addon list             # Show available addons and whether they are enabled
@@ -52,7 +44,7 @@ openpalm addon list             # Show available addons and whether they are ena
 
 ## Setup Wizard
 
-On first install, the CLI serves a setup wizard on port `8100` via `Bun.serve()`. That temporary setup port is separate from the admin container, which defaults to `http://localhost:3880` once installed. The wizard runs entirely in the browser (vanilla HTML/JS) and calls `performSetup()` from `@openpalm/lib` to write secrets, connection profiles, memory config, and other files to their final locations. No admin container is involved.
+On first install, the CLI spawns `openpalm` which serves the setup wizard via the SvelteKit admin UI at `http://localhost:3880/setup`. The wizard runs entirely in the browser and calls `performSetup()` from `@openpalm/lib` to write secrets, connection profiles, memory config, and other files to their final locations.
 
 ## Environment Variables
 
@@ -60,12 +52,12 @@ On first install, the CLI serves a setup wizard on port `8100` via `Bun.serve()`
 |---|---|---|
 | `OP_HOME` | `~/.openpalm` | Root of all OpenPalm state |
 | `OP_WORK_DIR` | `~/openpalm` | Assistant working directory |
-| `OP_ADMIN_API_URL` | `http://localhost:3880` | Admin API endpoint (for optional delegation) |
-| `OP_ADMIN_TOKEN` | (from `vault/stack/stack.env`) | Admin API auth token |
+| `OP_HOST_UI_PORT` | `3880` | Port for the host admin server (`openpalm`) |
+| `OP_UI_TOKEN` | (from `state/admin/token`) | Admin API auth token |
 
 ## How It Works
 
-1. **Bootstrap** (first install) -- creates the `~/.openpalm/` tree, downloads core assets from GitHub, seeds `vault/user/user.env` and `vault/stack/stack.env`, materializes the runtime registry catalog under `registry/`, serves the setup wizard, writes `stack/core.compose.yml`, enables requested addons under `stack/addons/`, and starts core services via `docker compose up`
+1. **Bootstrap** (first install) -- creates the `~/.openpalm/` tree, downloads core assets from GitHub, seeds `stash/vaults/user.env` and `config/stack/stack.env`, materializes the runtime registry catalog under `state/registry/`, serves the setup wizard, writes `stack/core.compose.yml`, enables requested addons under `stack/addons/`, and starts core services via `docker compose up`
 2. **Running stack** -- commands refresh files in `~/.openpalm/` when needed, then execute Docker Compose directly.
 3. **Admin absent** -- all commands work identically. Admin is never required for any operation.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openpalm",
-  "version": "0.10.2",
+  "version": "0.11.0-beta.1",
   "type": "module",
   "license": "MPL-2.0",
   "description": "OpenPalm CLI — install and manage a self-hosted OpenPalm stack",
@@ -17,6 +17,8 @@
     "test": "bun test",
     "test:e2e": "npx playwright test",
     "wizard:dev": "bun run src/main.ts install --no-start --force",
+    "_build_note": "Run 'bun run ui:build:tar' from repo root before any build:* target (Bun does not run prebuild hooks)",
+    "prebuild": "cd ../ui && npm run build && npm run build:tar",
     "build": "bun build src/main.ts --compile --outfile dist/openpalm-cli",
     "build:linux-x64": "bun build src/main.ts --compile --target=bun-linux-x64 --outfile dist/openpalm-cli-linux-x64",
     "build:linux-arm64": "bun build src/main.ts --compile --target=bun-linux-arm64 --outfile dist/openpalm-cli-linux-arm64",
@@ -26,7 +28,7 @@
     "build:windows-arm64": "bun build src/main.ts --compile --target=bun-windows-arm64 --outfile dist/openpalm-cli-windows-arm64.exe"
   },
   "dependencies": {
-    "@openpalm/lib": ">=0.10.1 <1.0.0",
+    "@openpalm/lib": "0.11.0",
     "citty": "^0.2.1",
     "yaml": "^2.8.0"
   }

package/src/commands/addon.ts

@@ -1,12 +1,13 @@
 import { defineCommand } from 'citty';
 import {
+  buildComposeCliArgs,
   getAddonServiceNames,
   listAvailableAddonIds,
   listEnabledAddonIds,
   setAddonEnabled,
 } from '@openpalm/lib';
 import { ensureValidState } from '../lib/cli-state.ts';
-import { fullComposeArgs, runComposeWithPreflight } from '../lib/cli-compose.ts';
+import { runComposeWithPreflight } from '../lib/cli-compose.ts';
 import { runDockerCompose } from '../lib/docker.ts';
 
 function requireKnownAddon(name: string): void {
@@ -35,7 +36,7 @@ export async function runAddonListAction(): Promise<void> {
 export async function runAddonEnableAction(name: string): Promise<void> {
   requireKnownAddon(name);
   const state = ensureValidState();
-  const mutation = setAddonEnabled(state.homeDir, state.vaultDir, name, true);
+  const mutation = setAddonEnabled(state.homeDir, state.stackDir, name, true);
   if (!mutation.ok) throw new Error(mutation.error);
 
   if (!mutation.changed) {
@@ -66,7 +67,7 @@ export async function runAddonDisableAction(name: string): Promise<void> {
 
   if (wasEnabled && services.length > 0) {
     try {
-      await runDockerCompose([...fullComposeArgs(state), 'stop', ...services]);
+      await runDockerCompose([...buildComposeCliArgs(state), 'stop', ...services]);
       console.log(`Stopped services: ${services.join(', ')}`);
     } catch (err) {
       console.warn(
@@ -75,7 +76,7 @@ export async function runAddonDisableAction(name: string): Promise<void> {
     }
   }
 
-  const mutation = setAddonEnabled(state.homeDir, state.vaultDir, name, false);
+  const mutation = setAddonEnabled(state.homeDir, state.stackDir, name, false);
   if (!mutation.ok) throw new Error(mutation.error);
 
   if (!mutation.changed) {

package/src/commands/automations.ts

@@ -0,0 +1,63 @@
+import { defineCommand } from 'citty';
+import { execFile } from 'node:child_process';
+import { existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { resolveOpenPalmHome } from '@openpalm/lib';
+
+async function automationsCheck(): Promise<void> {
+  const home = resolveOpenPalmHome();
+  const tasksDir = join(home, 'stash', 'tasks');
+
+  if (!existsSync(tasksDir)) {
+    console.log('No tasks directory found at', tasksDir);
+    process.exit(0);
+  }
+
+  const taskFiles = readdirSync(tasksDir).filter((f) => f.endsWith('.md'));
+  if (taskFiles.length === 0) {
+    console.log('No automation tasks installed.');
+    process.exit(0);
+  }
+
+  console.log(`Found ${taskFiles.length} automation task(s):`);
+  for (const file of taskFiles) {
+    console.log(`  - ${file.replace('.md', '')}`);
+  }
+
+  // Check crontab for registered tasks
+  await new Promise<void>((resolve) => {
+    execFile('crontab', ['-l'], (error, stdout) => {
+      if (error) {
+        console.log('No crontab found — tasks not yet registered (assistant not started?)');
+        resolve();
+        return;
+      }
+      const registered = taskFiles.filter((f) => stdout.includes(f.replace('.md', '')));
+      console.log(`Registered in crontab: ${registered.length}/${taskFiles.length}`);
+      if (registered.length < taskFiles.length) {
+        console.log(
+          "Run 'akm tasks sync' inside the assistant container to register remaining tasks."
+        );
+      }
+      resolve();
+    });
+  });
+}
+
+export default defineCommand({
+  meta: {
+    name: 'automations',
+    description: 'Manage automation tasks',
+  },
+  subCommands: {
+    check: defineCommand({
+      meta: {
+        name: 'check',
+        description: 'Report automation task registration status',
+      },
+      async run() {
+        await automationsCheck();
+      },
+    }),
+  },
+});