@bagdock/cli 0.2.0 → 0.4.0

package/skills/bagdock-cli/references/dev.md

@@ -0,0 +1,45 @@
+# Local Development Reference
+
+## `bagdock dev`
+
+Starts a local development server using Wrangler, mimicking the Cloudflare Workers environment.
+
+```bash
+bagdock dev
+bagdock dev --port 3000
+```
+
+### Options
+
+| Flag | Description | Default |
+| --- | --- | --- |
+| `-p, --port <port>` | Local dev server port | `8787` |
+
+### How It Works
+
+1. Reads `bagdock.json` from the current directory
+2. Generates a temporary `wrangler.toml` from the project config
+3. Starts `wrangler dev` with the appropriate settings
+4. Hot-reloads on file changes
+
+### Requirements
+
+- Wrangler must be installed (globally or as a dev dependency)
+- `bagdock.json` must exist with a valid `main` entry point
+
+### Wrangler Overrides
+
+Add a `wrangler` key to `bagdock.json` to override generated Wrangler config:
+
+```json
+{
+  "name": "my-adapter",
+  "slug": "my-adapter",
+  "main": "src/index.ts",
+  "wrangler": {
+    "kv_namespaces": [
+      { "binding": "CACHE", "id": "abc123" }
+    ]
+  }
+}
+```

package/skills/bagdock-cli/references/env.md

@@ -0,0 +1,37 @@
+# Environment Variables Reference
+
+## `bagdock env list`
+
+Lists environment variable keys (not values) for the current app.
+
+```bash
+bagdock env list
+```
+
+Requires `bagdock.json` in the current directory (uses the `slug` field).
+
+## `bagdock env set <key> <value>`
+
+Sets an environment variable. Takes effect on the next deploy.
+
+```bash
+bagdock env set VENDOR_API_KEY sk_live_xxx
+bagdock env set DATABASE_URL "postgres://..."
+```
+
+Values are stored in Infisical (platform secret manager) and synced to the Worker's Cloudflare secrets on deploy.
+
+## `bagdock env remove <key>`
+
+Removes an environment variable. Takes effect on the next deploy.
+
+```bash
+bagdock env remove VENDOR_API_KEY
+```
+
+## Notes
+
+- Environment variables are scoped to the app (by slug)
+- Values are never returned by the API — only keys and last-updated timestamps
+- Changes take effect on the next `bagdock deploy`, not immediately
+- The API endpoint is `PUT /developer/apps/:slug/env` (set) and `DELETE /developer/apps/:slug/env/:key` (remove)

package/skills/bagdock-cli/references/error-codes.md

@@ -0,0 +1,53 @@
+# Error Codes Reference
+
+All errors follow the structure:
+
+```json
+{
+  "error": {
+    "code": "ERROR_CODE",
+    "message": "Human-readable description"
+  }
+}
+```
+
+## Authentication Errors
+
+| Code | Description | Resolution |
+| --- | --- | --- |
+| `UNAUTHENTICATED` | No valid credentials found | Run `bagdock login` or set `BAGDOCK_API_KEY` |
+| `UNAUTHORIZED` | Token is valid but lacks required permissions | Use a token with the correct scopes/role |
+| `SESSION_EXPIRED` | OAuth session has expired | Run `bagdock login` again |
+
+## Validation Errors
+
+| Code | Description | Resolution |
+| --- | --- | --- |
+| `VALIDATION_ERROR` | Request body failed validation | Check the `details` array for specific field errors |
+| `MISSING_CONFIG` | No `bagdock.json` found | Run `bagdock init` in the project directory |
+| `CONFIRMATION_REQUIRED` | Destructive operation needs confirmation | Pass `--yes` flag |
+
+## API Errors
+
+| Code | Description | Resolution |
+| --- | --- | --- |
+| `NOT_FOUND` | Resource does not exist | Verify the ID or slug |
+| `CONFLICT` | Operation conflicts with current state | e.g., revoking an already-revoked key |
+| `REVIEW_REQUIRED` | Public app needs approval for production | Run `bagdock submit` first |
+| `SERVICE_UNAVAILABLE` | Backend temporarily unavailable | Retry after a short delay |
+| `INTERNAL_ERROR` | Unexpected server error | Report to support |
+| `API_ERROR` | Generic API failure | Check the message for details |
+
+## Deploy Errors
+
+| Code | Description | Resolution |
+| --- | --- | --- |
+| `BUILD_FAILED` | Local build step failed | Check build output for errors |
+| `UPLOAD_FAILED` | CF Workers upload failed | Check script size limits and compatibility |
+
+## Exit Codes
+
+| Code | Meaning |
+| --- | --- |
+| `0` | Success |
+| `1` | Error (details in stderr) |

package/skills/bagdock-cli/references/marketplace.md

@@ -0,0 +1,69 @@
+# Marketplace Submission Lifecycle
+
+The Bagdock marketplace uses a reviewed submission model. Developers submit, Bagdock reviews, then approves or rejects. `bagdock publish` is intentionally not a CLI command — final publication is handled by Bagdock staff.
+
+## Workflow
+
+1. `bagdock validate` — Run local checks before uploading
+2. `bagdock submit` — Upload bundle and request review (draft -> submitted)
+3. `bagdock submission list` — View all submissions
+4. `bagdock submission status <id>` — Check review progress
+5. `bagdock submission withdraw <id>` — Cancel before approval (submitted -> draft)
+
+## Commands
+
+### `bagdock validate`
+
+Local-only checks — no API call needed. Validates:
+
+- `bagdock.json` exists and parses
+- Required fields present (name, slug, version, type, category, main)
+- Type is `edge` or `app`
+- Entry point file exists
+- Bundle size under 10 MB
+
+```bash
+bagdock validate
+bagdock validate --json
+```
+
+Exit code 0 = pass/warn, 1 = fail.
+
+### `bagdock submission list`
+
+```bash
+bagdock submission list --app my-adapter
+bagdock submission list --json
+```
+
+### `bagdock submission status <id>`
+
+```bash
+bagdock submission status iadpv_abc123 --json
+```
+
+Returns: app name, version, review_status, type, visibility, change_reason, submitted_by, date.
+
+### `bagdock submission withdraw <id>`
+
+```bash
+bagdock submission withdraw iadpv_abc123
+```
+
+Only works when `review_status` is `submitted`. Returns the app to `draft` status so you can make changes and re-submit.
+
+## Status Values
+
+| Status | Meaning |
+|--------|---------|
+| `draft` | Not yet submitted |
+| `submitted` | Under review |
+| `approved` | Cleared for production |
+| `rejected` | Changes requested |
+
+## API Endpoints
+
+- `POST /v1/developer/apps/:slug/submit` — Submit
+- `GET /v1/developer/apps/:slug/submissions` — List
+- `GET /v1/developer/apps/:slug/submissions/:id` — Detail
+- `POST /v1/developer/apps/:slug/submissions/:id/withdraw` — Withdraw