@jelou/cli 0.1.1 → 0.2.3

package/README.md

@@ -1,15 +1,16 @@
 # @jelou/cli
 
-Command-line tool for building, deploying, and managing
-[Jelou Functions](https://jelou.ai) — serverless TypeScript functions on the
-edge.
+Command-line tool for [Jelou Functions](https://jelou.ai) — serverless
+TypeScript functions on the edge.
 
-```bash
-jelou login
-jelou init
-jelou dev
-jelou deploy
-```
+One `define()` call gives you:
+
+- An **HTTP endpoint** with Zod validation and CORS
+- An **MCP tool** discoverable by AI agents
+- **Cron schedules** for recurring tasks
+
+Use it to build webhook handlers, chatbot integrations, scheduled cleanups, API
+proxies, and AI agent tools.
 
 ## Install
 
@@ -24,212 +25,88 @@ npx @jelou/cli deploy
 deno install -A -n jelou jsr:@jelou/cli
 ```
 
-After installing, the `jelou` binary is available globally.
-
-## Authentication
+Verify the installation:
 
 ```bash
-jelou login
-# Paste your access token (starts with jfn_pat_)
-```
-
-Or set the `JELOU_TOKEN` environment variable to skip interactive login:
-
-```bash
-export JELOU_TOKEN=jfn_pat_your_token_here
-jelou functions list
+jelou --version
 ```
 
-| Command        | Description                      |
-| -------------- | -------------------------------- |
-| `jelou login`  | Save access token to `~/.jelou/` |
-| `jelou logout` | Remove stored credentials        |
-| `jelou whoami` | Show current identity and scopes |
-
 ## Quick Start
 
 ```bash
+# Authenticate
+jelou login
+
+# Create a new function
 mkdir my-function && cd my-function
 jelou init
-# Creates index.ts, jelou.json, .env, .gitignore
 
+# Start local dev server with hot reload
 jelou dev
-# Local server at http://localhost:3000 with hot reload
+# → http://localhost:3000
 
+# Deploy to production
 jelou deploy
-# Ships to production
+# → https://my-function.fn.jelou.ai
 ```
 
 ## Commands
 
-### Project
-
-| Command      | Description                            |
-| ------------ | -------------------------------------- |
-| `jelou init` | Scaffold a new function project        |
-| `jelou dev`  | Start local dev server with hot reload |
-
-**`jelou dev` options:**
-
-| Flag         | Default | Description           |
-| ------------ | ------- | --------------------- |
-| `--port`     | `3000`  | Port to listen on     |
-| `--env`      | `.env`  | Path to env file      |
-| `--no-watch` | —       | Disable file watching |
-
-### Deploy & Rollback
-
-| Command                                | Description                     |
-| -------------------------------------- | ------------------------------- |
-| `jelou deploy`                         | Deploy current directory        |
-| `jelou rollback [slug] [deploymentId]` | Rollback to previous deployment |
-
-**`jelou deploy` options:**
-
-| Flag           | Description              |
-| -------------- | ------------------------ |
-| `--no-confirm` | Skip confirmation prompt |
-| `--follow, -f` | Tail logs after deploy   |
-
-### Functions
-
-| Command                  | Description           |
-| ------------------------ | --------------------- |
-| `jelou functions list`   | List all functions    |
-| `jelou functions info`   | Show function details |
-| `jelou functions create` | Create a new function |
-| `jelou functions delete` | Delete a function     |
-
-### Secrets
-
-| Command                                   | Description      |
-| ----------------------------------------- | ---------------- |
-| `jelou secrets list [slug]`               | List secret keys |
-| `jelou secrets set [slug] [...KEY=VALUE]` | Set secrets      |
-| `jelou secrets delete <slug> <key>`       | Delete a secret  |
-
-```bash
-# Inline
-jelou secrets set my-fn API_KEY=sk-123 DB_URL=postgres://...
-
-# From file
-jelou secrets set my-fn --from-env .env.production
-
-# Interactive
-jelou secrets set my-fn
-```
-
-### Tokens
-
-| Command                    | Description                         |
-| -------------------------- | ----------------------------------- |
-| `jelou tokens list`        | List all PAT tokens                 |
-| `jelou tokens create`      | Create a new token (admin required) |
-| `jelou tokens revoke <id>` | Revoke a token                      |
-
-### Monitoring
-
-| Command                       | Description            |
-| ----------------------------- | ---------------------- |
-| `jelou logs [slug]`           | Stream live logs       |
-| `jelou logs [slug] --history` | Fetch historical logs  |
-| `jelou cron list [slug]`      | List cron schedules    |
-| `jelou analytics`             | View company analytics |
+| Group        | Command           | Description                         |
+| ------------ | ----------------- | ----------------------------------- |
+| **Auth**     | `jelou login`     | Authenticate with your access token |
+|              | `jelou logout`    | Remove stored credentials           |
+|              | `jelou whoami`    | Show current identity and scopes    |
+| **Workflow** | `jelou init`      | Scaffold a new function project     |
+|              | `jelou dev`       | Local dev server with hot reload    |
+|              | `jelou deploy`    | Deploy to production                |
+|              | `jelou rollback`  | Roll back to a previous deployment  |
+|              | `jelou logs`      | Stream or fetch function logs       |
+| **Manage**   | `jelou functions` | List, create, delete functions      |
+|              | `jelou secrets`   | Manage environment secrets          |
+|              | `jelou tokens`    | Manage access tokens                |
+|              | `jelou cron`      | View cron schedules                 |
+|              | `jelou analytics` | View request/latency metrics        |
+| **Setup**    | `jelou skill`     | Install Jelou Functions agent skill |
+
+Run `jelou <command> --help` for flags and usage details.
 
 ## CI / Non-Interactive Mode
 
-Every command works in CI pipelines without hanging on prompts.
-
-### Global Flags
-
-| Flag         | Description                      |
-| ------------ | -------------------------------- |
-| `--no-input` | Disable all interactive prompts  |
-| `--json`     | Output structured JSON to stdout |
-
-Non-interactive mode is **auto-detected** when:
-
-- `CI=true` environment variable is set (GitHub Actions, GitLab CI, etc.)
-- `JELOU_NO_INPUT=1` is set
-- stdin is not a TTY (piped input)
-
-### JSON Output
-
-All data commands support `--json`. Output format: `{ "ok": true, "data": ... }`
+Every command works headlessly in CI pipelines.
 
 ```bash
-jelou functions list --json | jq '.data[].slug'
-jelou whoami --json | jq '.data.scopes'
-jelou deploy --no-confirm --json | jq '.data.url'
-```
+export JELOU_TOKEN=jfn_pat_your_token_here
 
-### Per-Command CI Flags
-
-| Command            | Flags                                          |
-| ------------------ | ---------------------------------------------- |
-| `login`            | `--token <token>`                              |
-| `init`             | `--slug`, `--description`, `--mode`, `--force` |
-| `functions create` | `--slug`, `--name`, `--description`            |
-| `functions delete` | `--yes, -y`                                    |
-| `tokens create`    | `--name`, `--scopes` (comma-separated)         |
-| `tokens revoke`    | `--yes, -y`                                    |
-| `deploy`           | `--no-confirm`                                 |
-
-### GitHub Actions Example
-
-```yaml
-- name: Deploy function
-  env:
-    JELOU_TOKEN: ${{ secrets.JELOU_TOKEN }}
-  run: |
-    npx @jelou/cli secrets set my-fn API_KEY=${{ secrets.API_KEY }}
-    npx @jelou/cli deploy --no-confirm --json | jq '.data.url'
+jelou deploy --no-confirm --json | jq '.data.url'
 ```
 
-### Full CI Example
-
-```bash
-export JELOU_TOKEN=jfn_pat_...
-
-# Create a token for CI
-jelou tokens create --name ci-deploy --scopes functions:read,functions:deploy --json
-
-# Init without prompts
-jelou init --slug my-fn --mode create --force
+- `--no-input` disables all prompts (auto-detected when `CI=true` or stdin is
+  not a TTY)
+- `--json` outputs `{ "ok": true, "data": ... }` to stdout
 
-# Deploy and capture URL
-DEPLOY_URL=$(jelou deploy --no-confirm --json | jq -r '.data.url')
-echo "Deployed to $DEPLOY_URL"
-```
+See the [full CI reference](../../docs/cli.md#ci--non-interactive-mode) for
+per-command flags and GitHub Actions examples.
 
 ## Configuration
 
-### Project — `jelou.json`
-
-Created by `jelou init` in your project root:
-
-```json
-{
-  "function": "my-function",
-  "entrypoint": "index.ts"
-}
-```
-
-### User — `~/.jelou/`
+| Source          | Purpose                                    |
+| --------------- | ------------------------------------------ |
+| `jelou.json`    | Project config (function slug, entrypoint) |
+| `~/.jelou/`     | User credentials and API URL override      |
+| `JELOU_TOKEN`   | Access token (overrides saved credentials) |
+| `JELOU_API_URL` | API base URL override                      |
 
-| File               | Purpose                        |
-| ------------------ | ------------------------------ |
-| `credentials.json` | Saved token from `jelou login` |
-| `config.json`      | API URL override (optional)    |
+See the
+[full configuration reference](../../docs/cli.md#configuration-reference) for
+details.
 
-### Environment Variables
+## Documentation
 
-| Variable         | Description                                   |
-| ---------------- | --------------------------------------------- |
-| `JELOU_TOKEN`    | Access token (overrides saved credentials)    |
-| `JELOU_API_URL`  | API base URL override                         |
-| `CI`             | Auto-enables non-interactive mode when `true` |
-| `JELOU_NO_INPUT` | Disables interactive prompts when `1`         |
+- [CLI Reference](../../docs/cli.md) — full command docs, flags, CI usage,
+  troubleshooting
+- [SDK Guide](../../docs/functions.md) — `define()` API, context, validation,
+  testing
 
 ## License
 

package/bin/jelou

@@ -1,22 +1,44 @@
 #!/usr/bin/env node
 
-const { existsSync } = require("fs");
-const { join } = require("path");
 const { execFileSync } = require("child_process");
+const { join } = require("path");
+
+const PLATFORMS = {
+  "darwin-arm64": "@jelou/cli-darwin-arm64",
+  "darwin-x64": "@jelou/cli-darwin-x64",
+  "linux-x64": "@jelou/cli-linux-x64",
+  "linux-arm64": "@jelou/cli-linux-arm64",
+  "win32-x64": "@jelou/cli-win32-x64",
+};
 
-const ext = process.platform === "win32" ? ".exe" : "";
-const bin = join(__dirname, `jelou${ext}`);
+const key = `${process.platform}-${process.arch}`;
+const pkg = PLATFORMS[key];
 
-if (!existsSync(bin)) {
+if (!pkg) {
+  console.error(
+    `@jelou/cli: unsupported platform ${key}\n` +
+    `Supported: ${Object.keys(PLATFORMS).join(", ")}\n` +
+    `Download manually from https://github.com/JelouLatam/jelou-functions-api/releases`
+  );
+  process.exit(1);
+}
+
+let binPath;
+try {
+  const pkgJson = require.resolve(`${pkg}/package.json`);
+  const ext = process.platform === "win32" ? ".exe" : "";
+  binPath = join(pkgJson, "..", "bin", `jelou${ext}`);
+} catch {
   console.error(
-    "jelou binary not found. Try reinstalling:\n\n" +
-    "  npm install -g @jelou/cli\n"
+    `@jelou/cli: platform package ${pkg} is not installed.\n\n` +
+    `This usually means npm was run with --no-optional. Reinstall with:\n\n` +
+    `  npm install -g @jelou/cli\n`
   );
   process.exit(1);
 }
 
 try {
-  execFileSync(bin, process.argv.slice(2), { stdio: "inherit" });
+  execFileSync(binPath, process.argv.slice(2), { stdio: "inherit" });
 } catch (err) {
   if (err.status !== undefined) process.exit(err.status);
   throw err;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jelou/cli",
-  "version": "0.1.1",
+  "version": "0.2.3",
   "description": "Jelou Functions CLI — deploy serverless TypeScript functions to the edge",
   "license": "SEE LICENSE IN LICENSE",
   "repository": {
@@ -12,15 +12,18 @@
   "bin": {
     "jelou": "bin/jelou"
   },
-  "scripts": {
-    "postinstall": "node scripts/postinstall.js"
-  },
   "files": [
     "bin/",
-    "scripts/",
     "README.md",
     "LICENSE"
   ],
+  "optionalDependencies": {
+    "@jelou/cli-darwin-arm64": "0.2.3",
+    "@jelou/cli-darwin-x64": "0.2.3",
+    "@jelou/cli-linux-x64": "0.2.3",
+    "@jelou/cli-linux-arm64": "0.2.3",
+    "@jelou/cli-win32-x64": "0.2.3"
+  },
   "keywords": [
     "jelou",
     "serverless",

package/scripts/postinstall.js

@@ -1,87 +0,0 @@
-#!/usr/bin/env node
-
-const { existsSync, mkdirSync, chmodSync, createWriteStream, unlinkSync } = require("fs");
-const { join } = require("path");
-const https = require("https");
-const { execSync } = require("child_process");
-
-const pkg = require("../package.json");
-const VERSION = pkg.version;
-const REPO = "JelouLatam/jelou-functions-api";
-const BIN_DIR = join(__dirname, "..", "bin");
-const BIN_PATH = join(BIN_DIR, process.platform === "win32" ? "jelou.exe" : "jelou");
-
-const PLATFORM_MAP = {
-  "darwin-arm64": "jelou-aarch64-apple-darwin",
-  "darwin-x64": "jelou-x86_64-apple-darwin",
-  "linux-x64": "jelou-x86_64-unknown-linux-gnu",
-  "linux-arm64": "jelou-aarch64-unknown-linux-gnu",
-  "win32-x64": "jelou-x86_64-pc-windows-msvc.exe",
-};
-
-function getAssetName() {
-  const key = `${process.platform}-${process.arch}`;
-  const name = PLATFORM_MAP[key];
-  if (!name) {
-    console.error(
-      `@jelou/cli: unsupported platform ${key}.\n` +
-      `Supported: ${Object.keys(PLATFORM_MAP).join(", ")}\n` +
-      `Install manually from https://github.com/${REPO}/releases`
-    );
-    process.exit(1);
-  }
-  return name;
-}
-
-function download(url, dest) {
-  return new Promise((resolve, reject) => {
-    const follow = (url) => {
-      https.get(url, { headers: { "User-Agent": "jelou-cli-postinstall" } }, (res) => {
-        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
-          follow(res.headers.location);
-          return;
-        }
-        if (res.statusCode !== 200) {
-          reject(new Error(`Download failed: HTTP ${res.statusCode} from ${url}`));
-          return;
-        }
-        const file = createWriteStream(dest);
-        res.pipe(file);
-        file.on("finish", () => file.close(resolve));
-        file.on("error", (err) => {
-          unlinkSync(dest);
-          reject(err);
-        });
-      }).on("error", reject);
-    };
-    follow(url);
-  });
-}
-
-async function main() {
-  if (process.env.JELOU_CLI_SKIP_INSTALL) {
-    console.log("@jelou/cli: skipping binary download (JELOU_CLI_SKIP_INSTALL)");
-    return;
-  }
-
-  const asset = getAssetName();
-  const url = `https://github.com/${REPO}/releases/download/cli-v${VERSION}/${asset}`;
-
-  if (!existsSync(BIN_DIR)) mkdirSync(BIN_DIR, { recursive: true });
-
-  console.log(`@jelou/cli: downloading ${asset} v${VERSION}...`);
-
-  try {
-    await download(url, BIN_PATH);
-    if (process.platform !== "win32") {
-      chmodSync(BIN_PATH, 0o755);
-    }
-    console.log("@jelou/cli: installed successfully");
-  } catch (err) {
-    console.error(`@jelou/cli: failed to download binary — ${err.message}`);
-    console.error(`Download manually from: https://github.com/${REPO}/releases/tag/cli-v${VERSION}`);
-    process.exit(0);
-  }
-}
-
-main();