@marcfargas/go-easy 0.0.1 → 0.3.0

package/skills/go-easy/calendar.md

@@ -0,0 +1,366 @@
+# go-easy: Calendar Reference
+
+## Gateway CLI: `npx go-calendar`
+
+```
+npx go-calendar <account> <command> [args...] [--flags]
+```
+
+All commands output JSON to stdout. Errors output JSON to stderr with exit code 1.
+
+### Commands
+
+#### calendars
+List all calendars for the account.
+```bash
+npx go-calendar <account> calendars
+```
+Returns: `Array<{ id, summary, description?, primary?, timeZone?, backgroundColor? }>` (bare array)
+
+Use `primary` as calendarId for the main calendar in other commands.
+
+#### events
+List events on a calendar. By default returns ALL event types (regular, out-of-office,
+working location, focus time, birthdays).
+```bash
+# Upcoming events (all types)
+npx go-calendar <account> events primary
+
+# Date range
+npx go-calendar <account> events primary \
+  --from=2026-02-01T00:00:00Z \
+  --to=2026-02-28T23:59:59Z
+
+# With text search and pagination
+npx go-calendar <account> events primary --query="meeting" --max=10
+npx go-calendar <account> events primary --max=50 --page-token=<token>
+
+# Filter by event type
+npx go-calendar <account> events primary --event-types=workingLocation
+npx go-calendar <account> events primary --event-types=default,outOfOffice
+```
+Returns: `{ items: CalendarEvent[], nextPageToken? }`
+
+**Defaults:**
+- `--max`: 20 per page
+- `--from`: now (if omitted, returns events from current time onward)
+- `--to`: no upper bound (if omitted, returns all future events up to `--max`)
+- Recurring events are expanded into individual instances (singleEvents=true)
+- All event types included (the Google API hides workingLocation and birthday by default — go-easy includes them)
+
+**Event types**: `default`, `outOfOffice`, `workingLocation`, `focusTime`, `birthday`
+
+#### event
+Get a single event by ID.
+```bash
+npx go-calendar <account> event <calendarId> <eventId>
+```
+Returns: `CalendarEvent`
+
+For recurring events, this returns the recurring event definition, not individual instances.
+Use the `recurringEventId` from a listed instance to find its parent.
+
+#### create (WRITE)
+Create a new event.
+
+**Required flags:** `--summary`, `--start`, `--end`
+**Optional flags:** `--description`, `--location`, `--tz`, `--attendees`, `--all-day`, `--type` + type-specific flags
+
+```bash
+# Regular timed event
+npx go-calendar <account> create primary \
+  --summary="Team Meeting" \
+  --start=2026-02-10T10:00:00+01:00 \
+  --end=2026-02-10T11:00:00+01:00 \
+  --description="Weekly sync" \
+  --location="Office"
+
+# All-day event (end date is EXCLUSIVE — Feb 14 only)
+npx go-calendar <account> create primary \
+  --summary="Company Holiday" \
+  --start=2026-02-14 \
+  --end=2026-02-15 \
+  --all-day
+
+# With attendees (invitation emails sent automatically)
+npx go-calendar <account> create primary \
+  --summary="Project Review" \
+  --start=2026-02-12T14:00:00+01:00 \
+  --end=2026-02-12T15:00:00+01:00 \
+  --attendees=alice@example.com,bob@example.com
+
+# Working location — home office
+npx go-calendar <account> create primary \
+  --type=workingLocation \
+  --summary="Home" \
+  --start=2026-02-10 --end=2026-02-11 --all-day \
+  --wl-type=homeOffice
+
+# Working location — office
+npx go-calendar <account> create primary \
+  --type=workingLocation \
+  --summary="Barcelona" \
+  --start=2026-02-10 --end=2026-02-11 --all-day \
+  --wl-type=officeLocation --wl-label="Barcelona Office"
+
+# Out of office ⚠️ --auto-decline sends decline emails to existing invitations
+npx go-calendar <account> create primary \
+  --type=outOfOffice \
+  --summary="Vacation" \
+  --start=2026-02-14T00:00:00+01:00 \
+  --end=2026-02-21T00:00:00+01:00 \
+  --auto-decline=declineAllConflictingInvitations \
+  --decline-message="On vacation, back Feb 21"
+
+# Focus time ⚠️ --auto-decline sends decline emails to existing invitations
+npx go-calendar <account> create primary \
+  --type=focusTime \
+  --summary="Deep Work" \
+  --start=2026-02-10T09:00:00+01:00 \
+  --end=2026-02-10T12:00:00+01:00 \
+  --auto-decline=declineOnlyNewConflictingInvitations \
+  --chat-status=doNotDisturb
+```
+Returns: `{ ok: true, id, htmlLink? }`
+
+#### update (WRITE)
+Update an existing event. Uses PATCH — only provided fields are changed, others are preserved.
+
+⚠️ If the event has attendees, update notifications will be sent automatically.
+
+```bash
+# Update just the summary (other fields unchanged)
+npx go-calendar <account> update primary <eventId> \
+  --summary="Updated Meeting"
+
+# Reschedule
+npx go-calendar <account> update primary <eventId> \
+  --summary="Updated Meeting" \
+  --start=2026-02-10T11:00:00+01:00 \
+  --end=2026-02-10T12:00:00+01:00
+
+# Update attendees
+npx go-calendar <account> update primary <eventId> \
+  --summary="Review" \
+  --start=2026-02-10T14:00:00+01:00 \
+  --end=2026-02-10T15:00:00+01:00 \
+  --attendees=alice@example.com,bob@example.com,carol@example.com
+```
+Returns: `{ ok: true, id, htmlLink? }`
+
+**Required flags:** `--summary`, `--start`, `--end` (always required even for PATCH — Google API needs them)
+**Optional flags:** `--description`, `--location`, `--tz`, `--attendees`, `--all-day`
+
+#### delete ⚠️ DESTRUCTIVE
+Delete an event. Requires `--confirm`.
+```bash
+npx go-calendar <account> delete primary <eventId> --confirm
+```
+Returns: `{ ok: true, id }`
+
+⚠️ If the event has attendees, cancellation emails will be sent automatically.
+
+Without `--confirm`:
+```json
+{ "blocked": true, "operation": "calendar.delete", "description": "Delete event \"Meeting\" with 3 attendees — cancellation emails will be sent", "hint": "Add --confirm" }
+```
+
+#### freebusy
+Check availability across calendars.
+```bash
+# Single calendar
+npx go-calendar <account> freebusy primary \
+  --from=2026-02-10T00:00:00Z \
+  --to=2026-02-10T23:59:59Z
+
+# Multiple calendars
+npx go-calendar <account> freebusy primary,colleague@example.com \
+  --from=2026-02-10T08:00:00Z \
+  --to=2026-02-10T18:00:00Z
+```
+Returns: `Array<{ calendarId, busy: [{ start, end }] }>`
+
+**Required flags:** `--from`, `--to`
+
+## Library API
+
+```typescript
+import { getAuth } from '@marcfargas/go-easy/auth';
+import { listCalendars, listEvents, getEvent, createEvent,
+         updateEvent, deleteEvent, queryFreeBusy
+} from '@marcfargas/go-easy/calendar';
+import { setSafetyContext } from '@marcfargas/go-easy';
+
+const auth = await getAuth('calendar', '<account>');
+
+// List calendars
+const cals = await listCalendars(auth);
+
+// List events (with pagination)
+const page1 = await listEvents(auth, 'primary', {
+  timeMin: '2026-02-01T00:00:00Z',
+  timeMax: '2026-02-28T23:59:59Z',
+  maxResults: 50,
+});
+if (page1.nextPageToken) {
+  const page2 = await listEvents(auth, 'primary', {
+    timeMin: '2026-02-01T00:00:00Z',
+    timeMax: '2026-02-28T23:59:59Z',
+    maxResults: 50,
+    pageToken: page1.nextPageToken,
+  });
+}
+
+// Get single event
+const event = await getEvent(auth, 'primary', 'eventId');
+
+// Create event (WRITE — no safety gate)
+const created = await createEvent(auth, 'primary', {
+  summary: 'Meeting',
+  start: '2026-02-10T10:00:00+01:00',
+  end: '2026-02-10T11:00:00+01:00',
+  timeZone: 'Europe/Madrid',
+  location: 'Office',
+  attendees: ['alice@example.com'],
+});
+
+// Update event (WRITE — PATCH semantics)
+await updateEvent(auth, 'primary', 'eventId', {
+  summary: 'Updated',
+  start: '2026-02-10T11:00:00+01:00',
+  end: '2026-02-10T12:00:00+01:00',
+});
+
+// Delete event (DESTRUCTIVE — needs safety context)
+setSafetyContext({ confirm: async (op) => { /* ... */ return true; } });
+await deleteEvent(auth, 'primary', 'eventId');
+
+// Free/busy
+const availability = await queryFreeBusy(
+  auth,
+  ['primary', 'colleague@example.com'],
+  '2026-02-10T08:00:00Z',
+  '2026-02-10T18:00:00Z'
+);
+```
+
+## Date/Time Formats
+
+- **Timed events**: ISO 8601 with offset — `2026-02-10T10:00:00+01:00` or UTC `2026-02-10T09:00:00Z`
+- **All-day events**: Date only — `2026-02-14` (with `--all-day` flag in CLI)
+- **Timezone (`--tz`)**: IANA format — `Europe/Madrid`, `America/New_York`, etc.
+
+### Timezone semantics
+
+- If `--start`/`--end` include an offset (e.g. `+01:00`), that offset is used directly
+- `--tz` sets the calendar display timezone (e.g. for recurring events or DST transitions)
+- If `--start`/`--end` are UTC (`Z`) and `--tz` is set, the event displays in that timezone
+
+### All-day event end date
+
+All-day end dates are **exclusive** (Google Calendar convention):
+- One day event on Feb 14: `--start=2026-02-14 --end=2026-02-15`
+- Three day event Feb 14–16: `--start=2026-02-14 --end=2026-02-17`
+
+### Recurring events
+
+Recurring events are not directly supported for creation/update.
+When listing events, recurring events are expanded into individual instances by default (`singleEvents=true`).
+Each instance has a `recurringEventId` pointing to the parent definition.
+
+## Types
+
+```typescript
+type EventType = 'default' | 'outOfOffice' | 'workingLocation' | 'focusTime' | 'birthday';
+
+interface CalendarEvent {
+  id: string;
+  summary: string;
+  description?: string;
+  start: string;              // ISO 8601 datetime or date
+  end: string;
+  timeZone?: string;
+  location?: string;
+  attendees?: Attendee[];
+  status?: 'confirmed' | 'tentative' | 'cancelled';
+  htmlLink?: string;
+  recurringEventId?: string;  // parent recurring event (for instances)
+  allDay?: boolean;
+  organizer?: { email: string; displayName?: string };
+  creator?: { email: string; displayName?: string };
+  eventType?: EventType;
+  workingLocation?: WorkingLocationProperties;
+  outOfOffice?: OutOfOfficeProperties;
+  focusTime?: FocusTimeProperties;
+  birthday?: BirthdayProperties;  // read-only
+}
+
+interface Attendee {
+  email: string;
+  displayName?: string;
+  responseStatus?: 'needsAction' | 'declined' | 'tentative' | 'accepted';
+  organizer?: boolean;
+  self?: boolean;
+}
+
+interface WorkingLocationProperties {
+  type: 'homeOffice' | 'officeLocation' | 'customLocation';
+  homeOffice?: true;
+  officeLocation?: { buildingId?; deskId?; floorId?; floorSectionId?; label? };
+  customLocation?: { label? };
+}
+
+interface OutOfOfficeProperties {
+  autoDeclineMode?: 'declineNone' | 'declineAllConflictingInvitations' | 'declineOnlyNewConflictingInvitations';
+  declineMessage?: string;
+}
+
+interface FocusTimeProperties {
+  autoDeclineMode?: 'declineNone' | 'declineAllConflictingInvitations' | 'declineOnlyNewConflictingInvitations';
+  chatStatus?: string;        // 'available' or 'doNotDisturb'
+  declineMessage?: string;
+}
+
+interface BirthdayProperties {  // read-only, cannot be created
+  contact?: string;
+  type?: 'birthday' | 'anniversary' | 'custom' | 'self';
+  customTypeName?: string;
+}
+
+interface CalendarInfo {
+  id: string;
+  summary: string;
+  description?: string;
+  primary?: boolean;
+  timeZone?: string;
+  backgroundColor?: string;
+}
+
+interface FreeBusyResult {
+  calendarId: string;
+  busy: { start: string; end: string }[];
+}
+```
+
+## Error Codes
+
+| Code | Meaning | Exit Code |
+|------|---------|-----------|
+| `AUTH_NO_ACCOUNT` | Account not configured | 1 |
+| `AUTH_MISSING_SCOPE` | Account exists but missing Calendar scope | 1 |
+| `AUTH_TOKEN_REVOKED` | Refresh token revoked — re-auth needed | 1 |
+| `AUTH_NO_CREDENTIALS` | OAuth credentials missing | 1 |
+| `NOT_FOUND` | Event not found (404) | 1 |
+| `QUOTA_EXCEEDED` | Calendar API rate limit (429) — wait 30s and retry | 1 |
+| `SAFETY_BLOCKED` | Destructive op without `--confirm` | 2 |
+| `CALENDAR_ERROR` | Other Calendar API error | 1 |
+
+Auth errors include a `fix` field: `{ "error": "AUTH_NO_ACCOUNT", "fix": "npx go-easy auth add <email>" }`
+
+## Available Accounts
+
+```bash
+npx go-easy auth list
+```
+
+If an account is missing, add it: `npx go-easy auth add <email>` (see [SKILL.md](SKILL.md) for the full auth workflow).

package/skills/go-easy/drive.md

@@ -0,0 +1,309 @@
+# go-easy: Drive Reference
+
+## Gateway CLI: `npx go-drive`
+
+```
+npx go-drive <account> <command> [args...] [--flags]
+```
+
+All commands output JSON to stdout. Errors output JSON to stderr with exit code 1.
+Shared Drives are supported transparently.
+
+### Commands
+
+#### ls
+List files in a folder or by metadata query.
+```bash
+# List root folder (most recently modified first)
+npx go-drive <account> ls
+
+# List specific folder
+npx go-drive <account> ls <folderId>
+
+# With metadata query
+npx go-drive <account> ls --query="name contains 'report'"
+
+# Combine folder + query + pagination
+npx go-drive <account> ls <folderId> --query="mimeType = 'application/pdf'" --max=10
+npx go-drive <account> ls --max=50 --page-token=<token>
+
+# Order by name
+npx go-drive <account> ls --order="name"
+```
+Returns: `{ items: DriveFile[], nextPageToken? }`
+
+**Defaults:**
+- `--max`: 20 per page
+- `--order`: `modifiedTime desc` (most recently modified first)
+
+**Valid `--order` values:** `name`, `modifiedTime`, `modifiedTime desc`, `createdTime`, `createdTime desc`, `folder`, `quotaBytesUsed`, `recency`
+
+#### search
+Full-text content search (searches inside file contents).
+```bash
+npx go-drive <account> search "quarterly revenue"
+npx go-drive <account> search "contract clause 5" --max=5
+npx go-drive <account> search "budget" --page-token=<token>
+```
+Returns: `{ items: DriveFile[], nextPageToken? }`
+
+- `--max`: no default (returns all matches, Drive API decides page size)
+
+**Note**: `search` searches file *contents*. Use `ls --query` to search by filename/metadata.
+
+#### get
+Get file metadata by ID.
+```bash
+npx go-drive <account> get <fileId>
+```
+Returns: `DriveFile`
+
+#### download
+Download a file (writes to disk).
+```bash
+npx go-drive <account> download <fileId>              # saves as original filename in CWD
+npx go-drive <account> download <fileId> ./output.pdf  # saves to specific path
+```
+Returns: `{ ok: true, path, size, mimeType }`
+
+⚠️ Without a destination path, the file is saved to the **current working directory**. Use `$TEMP` or a specific path for agent workflows:
+```bash
+npx go-drive <account> download <fileId> "$TEMP/downloaded.pdf"
+```
+
+**Note**: Cannot download Google Workspace files (Docs/Sheets/Slides) — they have no binary content. Use `export` instead. Attempting to download one throws `DRIVE_EXPORT_REQUIRED`.
+
+#### export
+Export Google Workspace files to standard formats.
+```bash
+npx go-drive <account> export <fileId> pdf
+npx go-drive <account> export <fileId> docx ./output.docx
+npx go-drive <account> export <fileId> xlsx
+```
+Returns: `{ ok: true, path, size, mimeType }`
+
+⚠️ Without a destination path, the file is saved to the **current working directory**.
+
+**Export format matrix:**
+
+| Source type | Available formats |
+|-------------|-------------------|
+| Google Docs | `pdf`, `docx`, `txt`, `html` |
+| Google Sheets | `pdf`, `xlsx`, `csv` |
+| Google Slides | `pdf`, `pptx` |
+| Google Drawings | `pdf` |
+
+Not all combinations work — the table shows supported ones. Unsupported combos return `DRIVE_ERROR`.
+
+#### upload (WRITE)
+Upload a file.
+```bash
+npx go-drive <account> upload ./report.pdf
+npx go-drive <account> upload ./report.pdf --folder=<folderId>
+npx go-drive <account> upload ./report.pdf --name="Q1 Report.pdf"
+```
+Returns: `{ ok: true, id, name, webViewLink? }`
+
+#### mkdir (WRITE)
+Create a folder.
+```bash
+npx go-drive <account> mkdir "New Folder"
+npx go-drive <account> mkdir "Subfolder" --parent=<folderId>
+```
+Returns: `{ ok: true, id, name, webViewLink? }`
+
+#### move (WRITE)
+Move a file to a different folder.
+```bash
+npx go-drive <account> move <fileId> <newParentId>
+```
+Returns: `{ ok: true, id, name, webViewLink? }`
+
+#### rename (WRITE)
+Rename a file.
+```bash
+npx go-drive <account> rename <fileId> "new-name.pdf"
+```
+Returns: `{ ok: true, id, name, webViewLink? }`
+
+#### copy (WRITE)
+Copy a file.
+```bash
+npx go-drive <account> copy <fileId>
+npx go-drive <account> copy <fileId> --name="Copy of report" --parent=<folderId>
+```
+Returns: `{ ok: true, id, name, webViewLink? }`
+
+Without `--name`, the copy is named "Copy of \<original name\>". Without `--parent`, it stays in the same folder.
+
+#### trash ⚠️ DESTRUCTIVE
+Trash a file. Requires `--confirm`.
+```bash
+npx go-drive <account> trash <fileId> --confirm
+```
+Returns: `{ ok: true, id, name }`
+
+#### permissions
+List sharing permissions on a file.
+```bash
+npx go-drive <account> permissions <fileId>
+```
+Returns: `Array<{ id, type, role, emailAddress?, displayName? }>` (bare array)
+
+#### share ⚠️ DESTRUCTIVE (when type=anyone or type=domain)
+Share a file. Requires `--confirm` when sharing with "anyone" or "domain" (exposes data broadly).
+```bash
+# Share with specific user (WRITE — no --confirm needed)
+npx go-drive <account> share <fileId> --type=user --role=reader --email=other@example.com
+
+# Share publicly (DESTRUCTIVE — needs --confirm)
+npx go-drive <account> share <fileId> --type=anyone --role=reader --confirm
+
+# Share with domain (DESTRUCTIVE — needs --confirm)
+npx go-drive <account> share <fileId> --type=domain --role=reader --domain=example.com --confirm
+```
+Returns: `{ ok: true, id, name, webViewLink? }`
+
+**Roles:** `reader`, `commenter`, `writer`
+
+#### unshare ⚠️ DESTRUCTIVE
+Remove a permission. Requires `--confirm`.
+```bash
+npx go-drive <account> unshare <fileId> <permissionId> --confirm
+```
+Returns: `{ ok: true, id, name }`
+
+Get the `permissionId` from the `permissions` command.
+
+## Library API
+
+```typescript
+import { getAuth } from '@marcfargas/go-easy/auth';
+import { listFiles, searchFiles, getFile, downloadFile, exportFile,
+         uploadFile, createFolder, moveFile, renameFile, copyFile,
+         trashFile, listPermissions, shareFile, unshareFile
+} from '@marcfargas/go-easy/drive';
+
+const auth = await getAuth('drive', '<account>');
+
+// List with pagination
+const page1 = await listFiles(auth, { folderId: 'folder-id', maxResults: 50 });
+if (page1.nextPageToken) {
+  const page2 = await listFiles(auth, { folderId: 'folder-id', maxResults: 50, pageToken: page1.nextPageToken });
+}
+
+// Full-text search
+const results = await searchFiles(auth, { query: 'contract' });
+
+// Get metadata
+const file = await getFile(auth, 'file-id');
+
+// Download (returns Buffer — library does NOT write to disk)
+const { data, name, mimeType } = await downloadFile(auth, 'file-id');
+// data is a Buffer — write it yourself: fs.writeFileSync('out.pdf', data)
+
+// Export (returns Buffer — library does NOT write to disk)
+const exported = await exportFile(auth, 'doc-id', 'pdf');
+// exported.data is a Buffer
+
+// Write operations
+const uploaded = await uploadFile(auth, './file.pdf', { folderId: 'folder-id' });
+const folder = await createFolder(auth, 'New Folder', 'parent-id');
+await moveFile(auth, 'file-id', 'new-parent-id');
+await renameFile(auth, 'file-id', 'new-name.pdf');
+await copyFile(auth, 'file-id', 'Copy', 'parent-id');
+
+// Destructive (needs safety context)
+await trashFile(auth, 'file-id');
+await shareFile(auth, 'file-id', { type: 'anyone', role: 'reader' });
+await unshareFile(auth, 'file-id', 'permission-id');
+
+// Permissions
+const perms = await listPermissions(auth, 'file-id');
+```
+
+**Library vs CLI difference:** `downloadFile` and `exportFile` return `{ data: Buffer, ... }` in the library. The CLI writes to disk and returns `{ path, size }`.
+
+## Drive Query Syntax (for ls --query)
+
+Same as Drive API v3 query syntax. **Shell quoting**: wrap the whole query in double quotes; use single quotes for string values inside:
+
+```bash
+npx go-drive <account> ls --query="name contains 'report'"
+npx go-drive <account> ls --query="mimeType = 'application/pdf' and name contains 'invoice'"
+```
+
+Common queries:
+- `name = 'report.pdf'` — exact name match
+- `name contains 'report'` — name contains text
+- `mimeType = 'application/pdf'` — by MIME type
+- `modifiedTime > '2026-01-01'` — modified after date
+- `'me' in owners` — owned by me
+- `sharedWithMe` — shared with me
+- `trashed = false` — not in trash (default)
+
+Combine with `and`/`or`:
+```
+name contains 'report' and mimeType = 'application/pdf'
+```
+
+### Google Workspace MIME types
+
+| Type | MIME type |
+|------|-----------|
+| Folder | `application/vnd.google-apps.folder` |
+| Document | `application/vnd.google-apps.document` |
+| Spreadsheet | `application/vnd.google-apps.spreadsheet` |
+| Presentation | `application/vnd.google-apps.presentation` |
+| Drawing | `application/vnd.google-apps.drawing` |
+| Form | `application/vnd.google-apps.form` |
+
+## Types
+
+```typescript
+interface DriveFile {
+  id: string;
+  name: string;
+  mimeType: string;
+  size?: number;           // not present for Google Workspace files
+  createdTime?: string;
+  modifiedTime?: string;
+  parents?: string[];
+  webViewLink?: string;
+  driveId?: string;        // Shared Drive ID (present for Shared Drive files)
+  shared?: boolean;
+  trashed?: boolean;
+}
+
+interface DrivePermission {
+  id: string;
+  type: 'user' | 'group' | 'domain' | 'anyone';
+  role: 'owner' | 'organizer' | 'fileOrganizer' | 'writer' | 'commenter' | 'reader';
+  emailAddress?: string;
+  displayName?: string;
+}
+```
+
+## Error Codes
+
+| Code | Meaning | Exit Code |
+|------|---------|-----------|
+| `AUTH_NO_ACCOUNT` | Account not configured | 1 |
+| `AUTH_MISSING_SCOPE` | Account exists but missing Drive scope | 1 |
+| `AUTH_TOKEN_REVOKED` | Refresh token revoked — re-auth needed | 1 |
+| `AUTH_NO_CREDENTIALS` | OAuth credentials missing | 1 |
+| `NOT_FOUND` | File not found (404) | 1 |
+| `QUOTA_EXCEEDED` | Drive API rate limit (429) — wait 30s and retry | 1 |
+| `SAFETY_BLOCKED` | Destructive op without `--confirm` | 2 |
+| `DRIVE_ERROR` | Other Drive API error | 1 |
+| `DRIVE_EXPORT_REQUIRED` | Tried to download a Google Workspace file — use `export` | 1 |
+
+Auth errors include a `fix` field: `{ "error": "AUTH_NO_ACCOUNT", "fix": "npx go-easy auth add <email>" }`
+
+## Available Accounts
+
+```bash
+npx go-easy auth list
+```
+
+If an account is missing, add it: `npx go-easy auth add <email>` (see [SKILL.md](SKILL.md) for the full auth workflow).