@gzl10/nexus-backend 0.21.0 → 1.0.0-alpha.0

package/claude-commands/nexus-new-action.md

@@ -91,10 +91,10 @@ npx tsc --noEmit
 
 ## Gotchas
 
-- Handler signature: `handler: async (ctx, input, req?, res?) => {}` — direct function, NOT factory pattern
+- Handler signature: `handler: async (ctx, input, c?) => {}` — direct function, NOT factory pattern. `c` is the Hono `Context`.
 - Hooks use factory pattern `(ctx) => ({...})`, but action handlers do NOT
 - `key` is the route identifier (NOT `name`)
-- `scope: 'row'` actions receive `req.params.id` — import `AuthRequest` from SDK if you need `req`
+- `scope: 'row'` actions receive the entity id via `c.req.param('id')` if `c` is needed
 - `input` defines the form shown before execution (Record<string, FieldDefinition>)
 - `output: {}` shows raw JSON result, `output` with fields shows structured modal
 - `batch: true` + `timeout: number` for batch processing with SSE progress

package/claude-commands/nexus-test.md

@@ -76,11 +76,13 @@ Check if the backend is reachable:
 $CLI client health
 ```
 
-If it fails (connection refused), start the backend in background:
+If it fails (connection refused), start the backend in background **forcing JSON logs** so you can parse them reliably (sin códigos ANSI ni multilínea de pino-pretty):
 
-- **Monorepo core:** `cd packages/backend && pnpm dev &`
-- **Monorepo demo:** `cd demos/demo-backend && pnpm dev &`
-- **Project:** `pnpm dev &` (from project root)
+- **Monorepo core:** `cd packages/backend && LOG_FORMAT=json pnpm dev &`
+- **Monorepo demo:** `cd demos/demo-backend && LOG_FORMAT=json pnpm dev &`
+- **Project:** `LOG_FORMAT=json pnpm dev &` (from project root)
+
+`LOG_FORMAT=json` produce una línea JSON por evento — útil para grep/jq y para que la IA filtre logs sin parsear ANSI. Si el `.env` ya define `LOG_FORMAT`, el override del entorno tiene prioridad solo si no se exporta antes.
 
 Wait until `$CLI client health` succeeds (poll every 2s, max 30s).
 
@@ -131,15 +133,26 @@ Available commands:
 - `$CLI client fetch POST /mail/send '{"to":"x"}'` — example write
 - `$CLI client fetch GET /some/endpoint --pat <token>` — bypass session, use PAT directly
 
+**Storage:**
+
+- `$CLI client storage upload <file...> [--folder X] [--scope X] [--visibility public|internal|private]` — upload one or more files
+- `$CLI client storage download <id> [--output path]` — download file to disk (default: original filename in CWD)
+- `$CLI client storage list [--mimetype X] [--folder X] [--scope X] [--limit N]` — list storage files
+- `$CLI client storage delete <id>` — delete file by ID
+- `$CLI client storage stats` — storage statistics (total files, size, by type)
+
 **Other:**
 
 - `$CLI client health` — health check
 - `$CLI client login [email] [password]` — authenticate (creates PAT)
 - `$CLI client me` — current user info
+- `$CLI logs [--lines N] [--file path]` — tail backend log file in real time (requires LOG_FILE in .env)
+- `$CLI migrate list` — show migration status (alias for `migrate status`)
 
 **Command selection guide:**
 - **entity** — CRUD on entities (list, get, create, update, delete)
 - **action** — declared actions in modules/plugins (have a key, may need body or row id)
+- **storage** — file upload/download/list/delete/stats
 - **fetch** — anything else (custom routes, plugin endpoints, non-standard paths)
 
 Use `--debug` flag on any command for verbose HTTP logging.