@42ws/cli 0.0.3 → 0.0.5

package/README.md

@@ -73,7 +73,7 @@ CLI arguments take precedence over the configuration file.
 
 ## JSON output mode
 
-Use `--json` for machine-readable output (useful in CI):
+Use `--json` for machine-readable output (useful in CI / AI agents):
 
 **Success:**
 ```json
@@ -84,3 +84,56 @@ Use `--json` for machine-readable output (useful in CI):
 ```json
 {"ok":false,"error":{"code":"NOT_LOGGED_IN","message":"You are not logged in.","suggestedFix":"Run `42ws login --token <your-token>` to authenticate."}}
 ```
+
+Every error includes a `code`, `message`, and `suggestedFix`. AI agents should read `suggestedFix` and apply the suggested change before retrying.
+
+## For AI Agents
+
+This CLI is designed to be driven by AI coding agents (Claude Code, Cursor, etc.).
+
+### Recommended invocation
+
+```
+npx @42ws/cli@latest publish --yes --json
+```
+
+- `--yes` skips all interactive prompts
+- `--json` makes output machine-readable
+
+### Behavior contract
+
+- All commands return `{"ok": true, ...}` on success or `{"ok": false, "error": {...}}` on failure.
+- Errors always include `code`, `message`, and `suggestedFix`. Read `suggestedFix` and apply it before retrying.
+- The CLI never opens a browser or asks for input when `--yes` is set.
+- Site names are auto-derived from the directory name when `--yes` is set and no `--site` is given.
+- Frameworks (Vite / Astro / Next static export / SvelteKit static / plain HTML) are auto-detected from `package.json` and the directory contents.
+
+### Rules for AI agents
+
+- **Do not** ask the user for AWS credentials, S3 buckets, or CloudFront — 42ws abstracts these away.
+- **Do not** publish backend code (API routes, server functions, databases). Only static files.
+- **Do not** publish secret files. The CLI rejects `.env`, `.git/`, `node_modules/`, `*.pem`, `*.key`, `id_rsa`, `id_ed25519` automatically.
+- **Do** read `error.suggestedFix` and apply it before retrying.
+- **Do** return the published URL to the user.
+
+### Common error codes
+
+| Code | Meaning | Fix |
+|---|---|---|
+| `NOT_LOGGED_IN` | No saved auth | Run `npx @42ws/cli@latest login` (browser auth) |
+| `INVALID_SITE_NAME` | Site name missing or invalid | Add `--site <name>` or pass `--yes` to use directory name |
+| `RESERVED_SITE_NAME` | Subdomain reserved | Pick a different name |
+| `SITE_NAME_TAKEN` | Site already owned by someone | Pick a different name |
+| `OUTPUT_DIR_NOT_FOUND` | `dist/` etc. missing | Run the build command first or pass `--dir <path>` |
+| `NO_FILES_FOUND` | No files to publish | Check `--dir` is correct |
+| `BLOCKED_FILE` | Secret file would be uploaded | Remove the file or add to `.gitignore` |
+| `BUILD_FAILED` | Build command exited non-zero | Fix the build error first |
+| `FORBIDDEN` | License not enabled or not site owner | Ask the account owner |
+
+### Suggested user-facing prompt
+
+Users can paste this into their AI assistant:
+
+> このプロジェクトを 42ws に公開してください。`npx @42ws/cli@latest publish` を使ってください。エラーが出たら `error.suggestedFix` の指示に従ってください。
+
+(English: "Publish this project to 42ws using `npx @42ws/cli@latest publish`. If an error occurs, follow `error.suggestedFix`.")

package/dist/commands/logout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logout.d.ts","sourceRoot":"","sources":["../../src/commands/logout.ts"],"names":[],"mappings":"AAGA,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAoB5C"}
+{"version":3,"file":"logout.d.ts","sourceRoot":"","sources":["../../src/commands/logout.ts"],"names":[],"mappings":"AAIA,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CA0B5C"}

package/dist/commands/logout.js

@@ -1,4 +1,5 @@
 import { loadConfig, saveConfig } from '../lib/config.js';
+import { apiRequest } from '../lib/api.js';
 import { success, successMessage, isJsonMode } from '../lib/output.js';
 export async function logout() {
     const config = loadConfig();
@@ -11,7 +12,13 @@ export async function logout() {
         }
         return;
     }
-    // Remove token, keep apiUrl
+    // Best-effort: invalidate the token on the server too
+    try {
+        await apiRequest(config, 'DELETE', '/v1/cli/session');
+    }
+    catch {
+        // ignore — local cleanup is what matters
+    }
     saveConfig({ removeToken: true, apiUrl: config.apiUrl });
     if (isJsonMode()) {
         success({ status: 'logged-out' });

package/dist/commands/logout.js.map

@@ -1 +1 @@
-{"version":3,"file":"logout.js","sourceRoot":"","sources":["../../src/commands/logout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEvE,MAAM,CAAC,KAAK,UAAU,MAAM;IAC1B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAE5B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,UAAU,EAAE,EAAE,CAAC;YACjB,OAAO,CAAC,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAChD,CAAC;QACD,OAAO;IACT,CAAC;IAED,4BAA4B;IAC5B,UAAU,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAEzD,IAAI,UAAU,EAAE,EAAE,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,cAAc,CAAC,aAAa,CAAC,CAAC;IAChC,CAAC;AACH,CAAC"}
+{"version":3,"file":"logout.js","sourceRoot":"","sources":["../../src/commands/logout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEvE,MAAM,CAAC,KAAK,UAAU,MAAM;IAC1B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAE5B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,UAAU,EAAE,EAAE,CAAC;YACjB,OAAO,CAAC,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAChD,CAAC;QACD,OAAO;IACT,CAAC;IAED,sDAAsD;IACtD,IAAI,CAAC;QACH,MAAM,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,yCAAyC;IAC3C,CAAC;IAED,UAAU,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAEzD,IAAI,UAAU,EAAE,EAAE,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,cAAc,CAAC,aAAa,CAAC,CAAC;IAChC,CAAC;AACH,CAAC"}

package/dist/index.js

@@ -7,7 +7,7 @@ import { open } from './commands/open.js';
 import { init } from './commands/init.js';
 import { pull } from './commands/pull.js';
 import { setJsonMode } from './lib/output.js';
-const VERSION = '0.0.3';
+const VERSION = '0.0.5';
 const HELP = `
 42ws — Publish static sites in one command
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@42ws/cli",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Publish static sites in one command",
   "publishConfig": {
     "access": "public"