@archlast/cli 0.1.0 → 0.1.3

package/README.md

@@ -1,149 +1,118 @@
-# Archlast CLI
-
-CLI tool for Archlast development and deployment.
-
-## Installation
+# Archlast CLI
+
+CLI tool for Archlast development, deployment, and Docker lifecycle management.
+
+## Requirements
+
+- Node.js 18+
+- Docker Desktop or Docker Engine
 
-### npm (recommended for users)
+## Installation
 
 ```bash
 npm install -g @archlast/cli
 ```
 
-### Local development (repo)
+## Quick start
+
+```bash
+archlast start
+archlast status
+archlast logs --follow
+```
+
+To watch and auto-deploy functions during development:
+
+```bash
+archlast dev --path ./archlast --server http://localhost:4000
+```
+
+## Commands
+
+- `dev` - watch `archlast/src` for changes, regenerate types, and deploy deltas
+- `deploy` - one-time deployment to the server
+- `build` - generate types without deploying
+- `pull` - pull schema/files from the server, or use `--docker` to pull an image
+- `start` / `stop` / `restart` - manage the Docker container
+- `status` - print container status and health
+- `logs` - stream container logs
+- `upgrade` - pull a new image and restart the container
+- `config` - show resolved Docker config (use `--json` for JSON)
+- `generate crud <collection>` - scaffold CRUD handlers from schema
+- `data` - snapshot/export/import/restore data (requires `ARCHLAST_API_KEY`)
+
+## Common options
+
+- `--path <path>` points to your Archlast project folder
+- `--server <url>` sets the API base URL (default: `http://localhost:4000`)
+- `--port <port>` overrides the container port for `start` and `upgrade`
+- `--config <path>` points to `archlast.config.js`
+
+## Configuration
+
+The CLI reads configuration in this order:
+1. CLI flags
+2. `archlast.config.js`
+3. `.env` or `.env.local`
+4. defaults
+
+Example `archlast.config.js`:
+
+```js
+export default {
+  docker: {
+    image: "algochad/archlast-server",
+    tag: "0.1.0",
+    containerName: "archlast-server",
+    volumeName: "archlast-data",
+  },
+  server: { port: 4000 },
+  paths: {
+    config: ".archlast/config",
+    deploy: ".archlast-deploy",
+  },
+  cors: { origins: ["http://localhost:3000"] },
+  env: {
+    ARCHLAST_DASHBOARD_PORT: "4001",
+    ARCHLAST_STORE_PORT: "7001",
+  },
+};
+```
+
+Environment variables starting with `ARCHLAST_`, `S3_`, `AWS_`, and `STORAGE_`
+are forwarded into the container.
+
+## Dev and deploy flow
+
+The server receives deployments at `POST /_archlast/deploy` with payload:
+
+```ts
+{
+  functions: Array<{
+    name: string;
+    type: "query" | "mutation" | "action";
+    filePath: string;
+    code: string;
+  }>;
+  schema: { filePath: string; code: string } | null;
+  timestamp: number;
+}
+```
+
+## Data management
+
+Use the `data` command group to snapshot, export, import, and restore data.
+Set `ARCHLAST_API_KEY` in your environment for authentication.
+
+Examples:
 
 ```bash
-bun install
-bun run build
+archlast data snapshot --name "pre-migration"
+archlast data export ./backup.zip
+archlast data import ./backup.zip --strategy merge
+archlast data restore snapshot-2026-01-01.zip
 ```
-
-## Usage
-
-### Development Mode
-
-Watch for file changes and auto-generate types:
-
-```bash
-bun run archlast:dev
-# or
-bun archlast dev
-```
-
-Options:
-
-- `--path <path>` - Path to archlast folder (default: `./archlast`)
-- `--port <port>` - Server port (default: `3001`)
-- `--server <url>` - Server URL for code upload (default: `http://localhost:3001`)
-
-### Deploy Mode
-
-One-time deployment:
-
-```bash
-bun run archlast:deploy
-# or
-bun archlast deploy
-```
-
-Options:
-
-- `--path <path>` - Path to archlast folder (default: `./archlast`)
-- `--server <url>` - Server URL for code upload (default: `http://localhost:3001`)
-
-## Features
-
-- 📁 **File Watching**: Monitors `archlast/src/` folder for changes
-- 🔍 **Code Analysis**: Detects functions (query, mutation, action) and schema changes
-- 🎯 **Type Generation**: Auto-generates client-side TypeScript types to `_generated/`
-- 🔄 **Diff Detection**: Shows added, modified, and removed functions
-- ⚡ **Fast Rebuilds**: Only regenerates on actual changes
-- 🌐 **HTTP Upload**: Uploads code to server via `/_archlast/deploy` endpoint
-
-## How It Works
-
-1. Watches all `.ts` files in the `archlast/src/` folder
-2. Analyzes exports to find `query`, `mutation`, and `action` functions
-3. Detects schema changes in `src/schema.ts`
-4. Generates type definitions in `archlast/_generated/api.ts`
-5. **Uploads code to server via HTTP** (POST to `/_archlast/deploy`)
-6. Shows a diff of changes in the console
-
-## Project Structure
-
-```
-archlast/
-├── src/              # Your function definitions
-│   ├── schema.ts     # Database schema
-│   ├── tasks.ts      # Function exports
-│   └── ...
-├── _generated/       # Auto-generated by CLI
-│   ├── api.ts        # Type-safe API object
-│   ├── index.ts      # Barrel export
-│   └── server.ts     # Server types (manual)
-├── package.json
-└── tsconfig.json
-```
-
-Run `bun run dev` from the archlast folder to start development mode.
-
-Similar to Convex's `npx convex dev` workflow.
-
-## Server Endpoint
-
-The server receives deployments at `POST /_archlast/deploy` with payload:
-
-```typescript
-{
-  functions: Array<{
-    name: string;
-    type: 'query' | 'mutation' | 'action';
-    filePath: string;
-    code: string;
-  }>;
-  schema: {
-    filePath: string;
-    code: string;
-  } | null;
-  timestamp: number;
-}
-```
-
-Server responds with:
-
-```typescript
-{
-    success: boolean;
-    message: string;
-    functions: number;
-    schema: boolean;
-}
-```
-
-Similar to Convex's `npx convex dev` workflow.
-
-## Testing
-
-Run the test suite:
-
-```bash
-bun test
-```
-
-Run with coverage:
-
-```bash
-bun test --coverage
-```
-
-The test suite includes:
-
-- **Unit tests**: Individual module testing (analyzer, generator, uploader, watcher, DI generator)
-- **Integration tests**: Command orchestration (dev, deploy)
-- **CLI tests**: Entry point and command parsing
-- **Fixtures**: Comprehensive test data for malformed exports, complex handlers, schema variations, and mock manifests
-
-Coverage target: 90%+ lines/branches/functions
 
 ## Publishing (maintainers)
 
-See `docs/npm-publishing.md` for the release workflow and manual publish steps.
+See `docs/npm-publishing.md` for the release workflow and manual publish steps.

package/dist/cli.js

@@ -320990,8 +320990,8 @@ import * as path10 from "path";
 import { createRequire as createRequire2 } from "module";
 var DEFAULTS = {
   docker: {
-    image: "archlast/server",
-    tag: "latest",
+    image: "algochad/archlast-server",
+    tag: "0.1.0",
     containerName: "archlast-server",
     volumeName: "archlast-data"
   },
@@ -322320,7 +322320,7 @@ async function configCommand(options) {
 
 // src/cli.ts
 var program2 = new Command;
-program2.name("archlast").description("Archlast CLI for development and deployment").version("0.1.0");
+program2.name("archlast").description("Archlast CLI for development and deployment").version("0.1.1");
 program2.command("build").description("Generate types without deploying").option("--path <path>", "Path to archlast folder", ".").action(buildCommand);
 program2.command("dev").description("Start development mode with file watching").option("-p, --port <port>", "Server port", "3001").option("--path <path>", "Path to archlast folder", ".").option("--server <url>", "Server URL for code upload", "http://localhost:4000").option("--max-poll <number>", "Maximum server polling retries", "30").action(devCommand);
 program2.command("deploy").description("Deploy to production").option("--path <path>", "Path to archlast folder", ".").option("--server <url>", "Server URL for code upload", "http://localhost:4000").option("--max-poll <number>", "Maximum server polling retries", "30").action(deployCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@archlast/cli",
-    "version": "0.1.0",
+    "version": "0.1.3",
     "description": "Archlast CLI for development and deployment",
     "type": "module",
     "main": "dist/index.js",