@lumerahq/cli 0.10.0 → 0.11.0

package/templates/default/CLAUDE.md

@@ -1,238 +0,0 @@
-# {{projectTitle}} - Claude Code Instructions
-
-**Full Architecture**: See `ARCHITECTURE.md`
-
----
-
-## AI Agent Skills
-
-This project includes Lumera skills for AI coding agents in `.claude/skills/`. Read the relevant skill file when you need detailed API docs and usage patterns for that capability.
-
-<!-- LUMERA_SKILLS_START -->
-_Run `lumera skills install` to populate skill descriptions._
-<!-- LUMERA_SKILLS_END -->
-
-### Managing Skills
-
-```bash
-lumera skills update              # Update all skills to latest
-lumera skills install --force     # Re-install from scratch
-```
-
----
-
-## Quick Reference
-
-### Lumera CLI
-
-All `lumera` commands are run via `pnpm dlx`:
-
-```bash
-# Shortcuts
-pnpm dev              # Start dev server
-pnpm deploy           # Deploy frontend
-
-# All other commands
-pnpm dlx @lumerahq/cli plan
-pnpm dlx @lumerahq/cli apply
-pnpm dlx @lumerahq/cli destroy
-pnpm dlx @lumerahq/cli run scripts/seed-demo.py
-pnpm dlx @lumerahq/cli status
-```
-
-### Running the Frontend
-
-```bash
-# Login first (stores credentials in .lumera/credentials.json)
-lumera login
-
-# Start dev server
-pnpm dev
-
-# With custom port
-lumera dev --port 3000
-
-# With ngrok tunnel
-lumera dev --url https://my-tunnel.ngrok.io
-
-# Plain vite (no Lumera registration)
-pnpm dev:vite
-```
-
-### Linting & Formatting
-
-```bash
-# Type check without emitting
-pnpm typecheck
-
-# Lint and auto-fix
-pnpm lint
-
-# Format code
-pnpm format
-
-# Run all checks (lint + format + typecheck) - use in CI
-pnpm check:ci
-```
-
-### Deploying
-
-```bash
-# Deploy frontend
-lumera apply app
-
-# Apply all resources (collections, automations, hooks, app)
-lumera apply
-
-# Preview changes first
-lumera plan
-```
-
-### Running Scripts
-
-All scripts are **idempotent** - safe to run multiple times during iterative development.
-
-```bash
-# Run a script locally
-lumera run scripts/seed-demo.py
-
-# Dependencies can be declared inline (PEP 723)
-```
-
-### Running Automations via External ID
-
-Always run automations using their `external_id` (not the internal Lumera ID which changes per tenant).
-
-```python
-uv run python << 'EOF'
-from lumera import automations
-
-# Run automation by external_id (returns Run object immediately)
-run = automations.run_by_external_id(
-    "{{projectName}}:my_automation",
-    inputs={"param": "value"}
-)
-print(f"Run ID: {run.id}")
-print(f"Status: {run.status}")
-
-# Wait for completion (blocks until done or timeout)
-result = run.wait(timeout=600)  # 10 min timeout
-print(f"Result: {result}")
-EOF
-```
-
-**Run object properties**: `id`, `status`, `result`, `error`, `inputs`, `is_terminal`
-**Run object methods**: `wait(timeout)`, `refresh()`, `cancel()`
-**Status values**: `queued`, `running`, `succeeded`, `failed`, `cancelled`, `timeout`
-
----
-
-## Important Rules
-
-1. **Authenticate first** - Before running any CLI or SDK commands, ensure the user has run `lumera login`. This stores credentials in `.lumera/credentials.json` which the SDK reads automatically.
-
-2. **Source of truth is code** - `platform/` contains all schemas, automations, hooks. Update local code first, then deploy.
-
-3. **Never edit Lumera directly** - Don't change data/schema in Lumera UI without explicit user approval.
-
-4. **Offer to deploy** - When schemas, hooks, or automations change, offer to deploy to Lumera.
-
-5. **Use lumera-sdk skill for Python** - When writing scripts or automations, refer to the **lumera-sdk** skill (`.claude/skills/lumera-sdk.md`) for available SDK functions and usage patterns. The SDK source code is also available in `.venv/lib/python*/site-packages/lumera/` for detailed implementation reference. Key modules:
-   - `lumera.pb` - Record and collection operations (search, get, create, update, delete)
-   - `lumera.storage` - File uploads and downloads
-   - `lumera.llm` - LLM completions
-   - `lumera.automations` - Running and managing automations
-   - `lumera.integrations` - Third-party integrations (Google, Slack, etc.)
-
-6. **Use Python SDK for ad-hoc investigation** - When you need to quickly query data, inspect records, or debug issues, use the Python SDK with `uv run python` (uses `.venv` automatically via `pyproject.toml`):
-   ```bash
-   uv run python -c "from lumera import pb; print(pb.search('collection_name'))"
-   ```
-
----
-
-## Key Directories
-
-```
-platform/
-├── automations/    # Automation scripts (Python)
-├── collections/    # Collection schemas (JSON)
-└── hooks/          # Server-side JavaScript hooks
-
-scripts/            # Local scripts (seed, migrate, etc.)
-
-src/                # React frontend
-├── routes/         # TanStack Router pages
-├── lib/            # queries.ts, api helpers
-└── components/     # React components
-
-.venv/              # Python venv with lumera SDK (for IDE autocomplete)
-```
-
-### Python Environment
-
-A Python virtual environment is created at `.venv/` with the `lumera` SDK pre-installed. This provides IDE autocomplete when writing automations and scripts.
-
-```bash
-# Activate venv (optional - for IDE integration)
-source .venv/bin/activate
-
-# SDK is available for import
-python -c "from lumera import pb; print(pb)"
-```
-
-> **Note:** You don't need to activate the venv to run scripts - `lumera run` handles this automatically.
-
----
-
-## Frontend Patterns
-
-### Fetching Data
-
-```typescript
-import { pbSql, pbList } from '@lumerahq/ui/lib';
-
-const result = await pbSql<{ id: string; name: string }>({
-  sql: 'SELECT id, name FROM users WHERE active = true'
-});
-
-const items = await pbList<User>('users', {
-  filter: JSON.stringify({ status: "active" }),
-  sort: '-created',
-  perPage: 50,
-});
-```
-
-### Running Automations from Frontend
-
-```typescript
-import { createRun, pollRun } from '@lumerahq/ui/lib';
-
-const run = await createRun({
-  automationId: '{{projectName}}:process_data',
-  inputs: { file_id: 'abc123' },
-});
-
-const result = await pollRun(run.id);
-```
-
----
-
-## Debugging with Lumera SDK
-
-```python
-uv run python << 'EOF'
-from lumera import pb
-
-# List collections
-print(pb.list_collections())
-
-# Search records
-result = pb.search("my_collection", per_page=10)
-print(result)
-
-# Get single record
-record = pb.get("my_collection", "record_id")
-print(record)
-EOF
-```

package/templates/default/README.md

@@ -1,59 +0,0 @@
-# {{projectTitle}}
-
-Lumera custom embedded app.
-
-## Getting Started
-
-1. Install dependencies:
-   ```bash
-   pnpm install
-   ```
-
-2. Login to Lumera:
-   ```bash
-   lumera login
-   ```
-
-3. Start development server:
-   ```bash
-   pnpm dev
-   ```
-
-## CLI Commands
-
-```bash
-# Development
-lumera dev                        # Start dev server
-lumera dev --port 3000            # Custom port
-
-# Deployment
-lumera apply app                  # Build and deploy frontend
-lumera apply                      # Apply all resources
-lumera plan                       # Preview changes
-
-# Scripts
-lumera run scripts/seed-demo.py   # Run seed script
-
-# Project info
-lumera status                     # Show project info
-```
-
-## Project Structure
-
-```
-├── src/                # Frontend (React + TanStack)
-│   ├── routes/         # TanStack Router pages
-│   ├── components/     # React components
-│   └── lib/            # API utilities
-├── platform/           # Backend resources
-│   ├── collections/    # Collection schemas (JSON)
-│   ├── automations/    # Automation scripts (Python)
-│   └── hooks/          # Server-side hooks (JS)
-├── scripts/            # Local scripts
-└── CLAUDE.md           # AI assistant instructions
-```
-
-## Documentation
-
-- `CLAUDE.md` - AI coding assistant instructions
-- `ARCHITECTURE.md` - System architecture (customize for your app)

package/templates/default/biome.json

@@ -1,38 +0,0 @@
-{
-  "$schema": "https://biomejs.dev/schemas/2.0.0/schema.json",
-  "vcs": {
-    "enabled": true,
-    "clientKind": "git",
-    "useIgnoreFile": true
-  },
-  "files": {
-    "ignoreUnknown": false,
-    "includes": ["**", "!!**/node_modules", "!!**/dist", "!!**/*routeTree.gen.ts"]
-  },
-  "formatter": {
-    "enabled": true,
-    "indentStyle": "space",
-    "indentWidth": 2,
-    "lineWidth": 100
-  },
-  "linter": {
-    "enabled": true,
-    "rules": {
-      "recommended": true,
-      "suspicious": { "noExplicitAny": "off" },
-      "style": { "noNonNullAssertion": "off" }
-    }
-  },
-  "javascript": {
-    "formatter": {
-      "quoteStyle": "single",
-      "semicolons": "always",
-      "trailingCommas": "es5"
-    }
-  },
-  "css": {
-    "parser": {
-      "tailwindDirectives": true
-    }
-  }
-}

package/templates/default/gitignore

@@ -1,9 +0,0 @@
-node_modules
-dist
-.env
-.env.local
-*.local
-__pycache__
-*.pyc
-.venv/
-.lumera/

package/templates/default/index.html

@@ -1,13 +0,0 @@
-<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="theme-color" content="#000000" />
-    <title>{{projectTitle}}</title>
-  </head>
-  <body>
-    <div id="app"></div>
-    <script type="module" src="/src/main.tsx"></script>
-  </body>
-</html>

package/templates/default/package.json.hbs

@@ -1,47 +0,0 @@
-{
-  "name": "{{projectName}}",
-  "private": true,
-  "type": "module",
-  "pnpm": {
-    "overrides": {
-      "@tanstack/router-core": "1.155.0"
-    }
-  },
-  "lumera": {
-    "version": 1,
-    "name": "{{projectTitle}}"
-  },
-  "scripts": {
-    "dev": "pnpm dlx @lumerahq/cli dev",
-    "deploy": "pnpm dlx @lumerahq/cli apply app",
-    "dev:vite": "vite",
-    "build": "vite build && tsc",
-    "preview": "vite preview",
-    "typecheck": "tsr generate && tsc --noEmit",
-    "lint": "biome lint --write .",
-    "format": "biome format --write .",
-    "check": "biome check --write .",
-    "check:ci": "biome check . && tsr generate && tsc --noEmit"
-  },
-  "dependencies": {
-    "@lumerahq/ui": "^0.5.0",
-    "@tanstack/react-query": "^5.90.11",
-    "@tanstack/react-router": "1.155.0",
-    "@tanstack/router-plugin": "1.155.0",
-    "lucide-react": "^0.469.0",
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0",
-    "sonner": "^2.0.7",
-    "tailwindcss": "^4.0.6"
-  },
-  "devDependencies": {
-    "@biomejs/biome": "^2.0.0",
-    "@tailwindcss/vite": "^4.0.6",
-    "@tanstack/router-cli": "1.155.0",
-    "@types/react": "^19.2.0",
-    "@types/react-dom": "^19.2.0",
-    "@vitejs/plugin-react": "^5.0.4",
-    "typescript": "^5.7.2",
-    "vite": "^7.1.7"
-  }
-}

package/templates/default/platform/collections/example_items.json

@@ -1,26 +0,0 @@
-{
-  "id": "example_items",
-  "name": "example_items",
-  "fields": [
-    {
-      "name": "name",
-      "type": "text",
-      "required": true
-    },
-    {
-      "name": "status",
-      "type": "select",
-      "values": ["pending", "processing", "completed"],
-      "default": "pending"
-    },
-    {
-      "name": "description",
-      "type": "text"
-    },
-    {
-      "name": "source_id",
-      "type": "text"
-    }
-  ],
-  "indexes": [{ "fields": ["source_id"], "unique": true }]
-}

package/templates/default/pyproject.toml.hbs

@@ -1,14 +0,0 @@
-[project]
-name = "{{projectName}}"
-version = "0.1.0"
-description = "{{projectTitle}} - Lumera custom app"
-requires-python = ">=3.11"
-dependencies = [
-    "lumera",
-]
-
-[project.optional-dependencies]
-dev = [
-    "ruff",
-    "pytest",
-]

package/templates/default/scripts/seed-demo.py

@@ -1,35 +0,0 @@
-# /// script
-# dependencies = ["lumera"]
-# ///
-"""
-Seed demo data into Lumera (idempotent - safe to run multiple times).
-
-Usage:
-    lumera run scripts/seed-demo.py
-"""
-
-from lumera import pb
-
-# Seed demo items
-demo_items = [
-    {
-        "external_id": "demo:item_1",
-        "name": "Example Item 1",
-        "status": "pending",
-        "description": "This is an example item",
-    },
-    {
-        "external_id": "demo:item_2",
-        "name": "Example Item 2",
-        "status": "pending",
-        "description": "Another example item",
-    },
-]
-
-print("Seeding demo data...")
-
-for item in demo_items:
-    pb.upsert("example_items", item)
-    print(f"  ✓ {item['name']}")
-
-print(f"\nSeeded {len(demo_items)} items")

package/templates/default/src/components/Sidebar.tsx

@@ -1,82 +0,0 @@
-import { cn } from '@lumerahq/ui/lib';
-import { Link, useRouterState } from '@tanstack/react-router';
-import { ChevronLeft, ChevronRight, LayoutDashboard, Settings } from 'lucide-react';
-import { useState } from 'react';
-
-type NavItem = {
-  to: string;
-  label: string;
-  icon: React.ElementType;
-};
-
-const navItems: NavItem[] = [
-  { to: '/', label: 'Dashboard', icon: LayoutDashboard },
-  { to: '/settings', label: 'Settings', icon: Settings },
-];
-
-export function Sidebar() {
-  const [collapsed, setCollapsed] = useState(false);
-  const routerState = useRouterState();
-  const currentPath = routerState.location.pathname;
-
-  const isActive = (path: string) => {
-    if (path === '/') return currentPath === '/';
-    return currentPath.startsWith(path);
-  };
-
-  return (
-    <aside
-      className={cn(
-        'flex flex-col bg-slate-900 text-white border-r border-slate-800 transition-all duration-200',
-        collapsed ? 'w-16' : 'w-56'
-      )}
-    >
-      {/* Logo */}
-      <div className="flex items-center h-14 px-4 border-b border-slate-800">
-        <Link to="/" className="flex items-center gap-2">
-          <div className="size-8 rounded-lg bg-primary flex items-center justify-center text-primary-foreground font-bold text-sm">
-            {{projectInitial}}
-          </div>
-          {!collapsed && <span className="font-semibold text-sm">{{projectTitle}}</span>}
-        </Link>
-      </div>
-
-      {/* Navigation */}
-      <nav className="flex-1 p-2 space-y-1">
-        {navItems.map((item) => {
-          const active = isActive(item.to);
-          return (
-            <Link
-              key={item.to}
-              to={item.to}
-              className={cn(
-                'flex items-center gap-3 px-3 py-2 rounded-md text-sm font-medium transition-colors',
-                active
-                  ? 'bg-slate-800 text-white'
-                  : 'text-slate-400 hover:bg-slate-800/50 hover:text-white'
-              )}
-            >
-              <item.icon className="size-4 shrink-0" />
-              {!collapsed && <span>{item.label}</span>}
-            </Link>
-          );
-        })}
-      </nav>
-
-      {/* Collapse toggle */}
-      <div className="p-2 border-t border-slate-800">
-        <button
-          type="button"
-          onClick={() => setCollapsed(!collapsed)}
-          className={cn(
-            'flex items-center gap-2 w-full px-3 py-2 rounded-md text-sm text-slate-400 hover:text-white hover:bg-slate-800/50 transition-colors',
-            collapsed && 'justify-center'
-          )}
-        >
-          {collapsed ? <ChevronRight className="size-4" /> : <ChevronLeft className="size-4" />}
-          {!collapsed && <span>Collapse</span>}
-        </button>
-      </div>
-    </aside>
-  );
-}

package/templates/default/src/components/StatCard.tsx

@@ -1,25 +0,0 @@
-import { cn } from '@lumerahq/ui/lib';
-import type { ReactNode } from 'react';
-
-interface StatCardProps {
-  title: string;
-  value: string | number;
-  subtitle?: string;
-  icon?: ReactNode;
-  className?: string;
-}
-
-export function StatCard({ title, value, subtitle, icon, className }: StatCardProps) {
-  return (
-    <div className={cn('rounded-xl border bg-card p-5', className)}>
-      <div className="flex items-start justify-between">
-        <div className="space-y-1">
-          <p className="text-sm font-medium text-muted-foreground">{title}</p>
-          <p className="text-2xl font-semibold tracking-tight">{value}</p>
-          {subtitle && <p className="text-sm text-muted-foreground">{subtitle}</p>}
-        </div>
-        {icon && <div className="rounded-lg bg-muted p-2.5 text-muted-foreground">{icon}</div>}
-      </div>
-    </div>
-  );
-}

package/templates/default/src/components/layout.tsx

@@ -1,13 +0,0 @@
-import type { ReactNode } from 'react';
-import { Sidebar } from './Sidebar';
-
-export function AppLayout({ children }: { children: ReactNode }) {
-  return (
-    <div className="flex h-screen bg-background">
-      <Sidebar />
-      <main className="flex-1 overflow-auto">
-        <div className="p-6">{children}</div>
-      </main>
-    </div>
-  );
-}

package/templates/default/src/lib/queries.ts

@@ -1,27 +0,0 @@
-import { type PbRecord, pbList } from '@lumerahq/ui/lib';
-
-export type ExampleRecord = PbRecord & {
-  name: string;
-  status: string;
-};
-
-export async function getExampleData() {
-  // Replace with your actual data fetching logic
-  return {
-    message: 'Replace this with your data fetching logic',
-    timestamp: new Date().toISOString(),
-    instructions: [
-      '1. Edit src/lib/queries.ts',
-      '2. Use pbSql or pbList from @lumerahq/ui/lib',
-      '3. Create query functions for your data',
-    ],
-  };
-}
-
-export async function listExampleRecords(page = 1) {
-  return pbList<ExampleRecord>('your_collection', {
-    page,
-    perPage: 20,
-    sort: '-created',
-  });
-}