@agendapanda/cli 0.3.0 → 0.3.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Agenda Panda
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,208 @@
+# @agendapanda/cli
+
+CLI for [Agenda Panda](https://agendapanda.com) — schedule and manage social media posts from the terminal.
+
+Works with X (Twitter), LinkedIn, Facebook Pages, Instagram, and Threads.
+
+## Install
+
+```bash
+npm install -g @agendapanda/cli
+```
+
+Or run directly:
+
+```bash
+npx @agendapanda/cli <command>
+```
+
+## Quick start
+
+```bash
+# 1. Create an API key at https://agendapanda.com/account-settings
+# 2. Authenticate
+ap auth login --key ap_your_key_here
+
+# 3. Set active workspace
+ap projects list
+ap projects use <project-id>
+
+# 4. Post something
+ap post create --content "Hello world" --connection <connection-id> --now
+```
+
+## Commands
+
+### Authentication
+
+```
+ap auth login --key <key>       Store API key (or set AP_API_KEY env var)
+ap auth logout                  Clear stored credentials
+ap auth status                  Show current user and active project
+ap auth api-keys list           List API keys
+ap auth api-keys create --name  Create a new API key
+ap auth api-keys revoke <id>    Revoke an API key
+```
+
+### Workspaces
+
+```
+ap projects list                List workspaces
+ap projects use <id>            Set active workspace
+ap projects get                 Show full workspace details
+ap projects update              Update workspace settings
+```
+
+`ap projects update` accepts `--name`, `--website`, `--industry`, `--target-audience`, `--brand-voice`, `--timezone`, `--soul-file <path>`, `--art-file <path>`, `--clear-soul`, `--clear-art`.
+
+### Connections
+
+```
+ap connections list             List connected social accounts
+ap connections health           Check connection health status
+ap connections add <platform>   Start OAuth flow (twitter, linkedin, facebook, threads, instagram)
+ap connections add-all          Start OAuth flow for all platforms
+```
+
+### Posts
+
+```
+ap post create                  Create a post
+ap post list                    List all posts
+ap post get <id>                Get a single post
+ap post update <id>             Update a post
+ap post delete <id>             Delete a post
+ap post retry <id>              Retry a failed post
+```
+
+Create options: `--content <text>`, `--connection <id>`, `--schedule <datetime>`, `--now`, `--media <path>`, `--project <id>`.
+
+Content can also be piped via stdin:
+
+```bash
+echo "Hello from a pipe" | ap post create --connection <id> --now
+```
+
+### Calendar
+
+```
+ap calendar import --file <path>   Import posts from a JSON file
+ap calendar sync --file <path>     Sync a calendar file (create/update/delete by external_id)
+ap calendar pull                   Pull scheduled posts as JSON
+```
+
+#### Import
+
+Bulk-create posts from a JSON array:
+
+```json
+[
+  {
+    "content": "Post text here",
+    "connection": "<connection-id>",
+    "schedule": "2026-03-15T14:00:00Z"
+  }
+]
+```
+
+Options: `--dry-run`, `--project <id>`, `--json`.
+
+#### Sync
+
+Two-way sync using `external_id` for stable identity:
+
+```json
+[
+  {
+    "content": "Updated text",
+    "connection": "<connection-id>",
+    "schedule": "2026-03-15T14:00:00Z",
+    "external_id": "post-001"
+  }
+]
+```
+
+Options: `--delete-missing`, `--dry-run`, `--project <id>`, `--json`.
+
+#### Pull
+
+Fetch current posts from the server as a CalendarItem JSON array:
+
+```bash
+# Pull to file
+ap calendar pull --file cal.json
+
+# Filter by date range
+ap calendar pull --from 2026-03-01 --to 2026-03-31
+
+# Include published posts
+ap calendar pull --include-published
+```
+
+**Round-trip workflow:**
+
+```bash
+ap calendar pull --file cal.json        # pull current state
+# edit cal.json (or feed to AI with ap context)
+ap calendar sync --file cal.json        # push changes back
+```
+
+### Context
+
+Dump brand context, connections, and platform rules — useful for feeding to AI tools:
+
+```bash
+# Markdown output (default)
+ap context
+
+# JSON output
+ap context --json
+
+# Include connection IDs
+ap context --verbose
+```
+
+### Media
+
+```
+ap media upload <file>          Upload an image or video
+```
+
+Supported formats: JPEG, PNG, GIF, WebP, MP4, MOV, WebM.
+
+## Configuration
+
+Config is stored at `~/.config/agendapanda/config.json`.
+
+Environment variable overrides:
+
+| Variable | Description |
+|----------|-------------|
+| `AP_API_KEY` | API key (overrides stored key) |
+| `AP_API_URL` | API base URL (default: `https://agendapanda.com`) |
+| `AP_PROJECT` | Active project ID (overrides stored project) |
+
+## JSON output
+
+All commands support `--json` for machine-readable output. JSON mode is also enabled automatically when stdout is piped.
+
+Response envelopes:
+
+- Lists: `{ "items": [...] }`
+- Mutations: `{ "success": true, "item": {...} }`
+- Errors: `{ "error": "message", "code": "ERROR_CODE" }` (stderr)
+
+## Schedule format
+
+All schedule times must be **UTC ISO 8601 with Z suffix**:
+
+```
+"schedule": "2026-03-15T14:00:00Z"   # correct
+"schedule": "2026-03-15T14:00:00"    # rejected (no Z)
+```
+
+The optional `timezone` field is display/planning metadata only — it does not affect when the post is published.
+
+## License
+
+MIT

package/package.json

@@ -1,7 +1,29 @@
 {
   "name": "@agendapanda/cli",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Agenda Panda CLI - schedule social media posts from the terminal",
+  "license": "MIT",
+  "author": "Agenda Panda <hello@agendapanda.com> (https://agendapanda.com)",
+  "homepage": "https://agendapanda.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nicejobhq/agendapanda-cli"
+  },
+  "bugs": {
+    "url": "https://github.com/nicejobhq/agendapanda-cli/issues"
+  },
+  "keywords": [
+    "social-media",
+    "scheduler",
+    "cli",
+    "twitter",
+    "linkedin",
+    "instagram",
+    "threads",
+    "facebook",
+    "content-calendar",
+    "automation"
+  ],
   "bin": {
     "ap": "dist/bin/ap.js"
   },
@@ -10,7 +32,8 @@
     "node": ">=20.0.0"
   },
   "files": [
-    "dist/"
+    "dist/",
+    "README.md"
   ],
   "scripts": {
     "build": "tsc",