zernio-cli 0.4.0

package/docs/project-changelog.md

@@ -0,0 +1,15 @@
+# Project Changelog
+
+## 2026-06-14
+
+- Renamed package identity from official-style `@zernio/cli` to unofficial `zernio-cli`.
+- Added deterministic OpenAPI catalog generation from bundled Zernio spec.
+- Added `api:catalog`, `api:describe`, and `api:call`.
+- Added header, raw-body, and safe retry header support for generic `api:call`.
+- Added `doctor` and `platforms:list`.
+- Replaced vulnerable `tsup` build path with plain `tsc`.
+- Added CI, semantic-release, tests, audit gate, and release workflow validation gates.
+- Hardened config handling: cwd dotenv loading is explicit opt-in, saved config files are private, and saved keys are not sent to arbitrary one-off hosts.
+- Fixed `doctor --connection` so failed API checks exit non-zero for CI and scripts.
+- Added coverage-gated tests for critical agent CLI paths: `api:*`, `doctor`, `platforms`, config, request construction, parsing, output, and error handling.
+- Updated docs and skill guidance for media uploads, queue scheduling, errors, rate limits, and platforms.

package/docs/project-overview-pdr.md

@@ -0,0 +1,25 @@
+# Project Overview PDR
+
+## Goal
+
+Ship an unofficial Zernio CLI that is useful for humans and agents.
+
+## Users
+
+- Developers automating social media workflows.
+- Agents that need JSON-first command output.
+- Operators testing Zernio API endpoints from terminal.
+
+## Requirements
+
+- Install with `npm install -g zernio-cli`.
+- Keep `zernio` binary and deprecated `late` alias.
+- Support curated workflows and full OpenAPI endpoint access.
+- Release stable from `main`, beta from `dev`.
+- Never expose `NPM_TOKEN` or `ZERNIO_API_KEY`.
+
+## Non-Goals
+
+- No MCP server.
+- No replacement for official Zernio docs.
+- No local scheduling engine; Zernio remains source of truth.

package/docs/system-architecture.md

@@ -0,0 +1,28 @@
+# System Architecture
+
+```text
+User / Agent
+    |
+    v
+zernio CLI (yargs)
+    |
+    +-- curated commands -> @zernio/node SDK -> Zernio API
+    |
+    +-- api:* commands -> raw fetch helper -> Zernio API
+    |
+    +-- media:upload -> presign endpoint -> direct PUT upload URL
+```
+
+## Release Flow
+
+```text
+conventional commit
+    |
+push main/dev
+    |
+CI: install, generate, typecheck, test, audit
+    |
+semantic-release
+    |
+npm + GitHub release + changelog
+```

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "zernio-cli",
+  "version": "0.4.0",
+  "description": "Unofficial agent-friendly CLI for the Zernio API",
+  "type": "module",
+  "bin": {
+    "late": "./dist/index.js",
+    "zernio": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "claude/skills/zernio",
+    "claude/plugin.json",
+    "docs",
+    "SKILL.md",
+    "README.md"
+  ],
+  "scripts": {
+    "generate:openapi": "node scripts/generate-openapi-catalog.mjs",
+    "build": "npm run generate:openapi && tsc -p tsconfig.json && node scripts/add-cli-shebang.mjs",
+    "dev": "tsx src/index.ts",
+    "test": "npm run generate:openapi && vitest run",
+    "test:coverage": "npm run generate:openapi && vitest run --coverage",
+    "typecheck": "npm run generate:openapi && tsc --noEmit",
+    "lint": "npm run typecheck",
+    "release": "semantic-release",
+    "prepublishOnly": "npm run build && npm run test:coverage"
+  },
+  "keywords": [
+    "social-media",
+    "scheduling",
+    "cli",
+    "ai-agent",
+    "instagram",
+    "tiktok",
+    "twitter",
+    "linkedin",
+    "facebook",
+    "threads",
+    "youtube",
+    "bluesky",
+    "pinterest"
+  ],
+  "author": "mrgoonie",
+  "license": "MIT",
+  "homepage": "https://github.com/mrgoonie/zernio-cli#readme",
+  "bugs": {
+    "url": "https://github.com/mrgoonie/zernio-cli/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mrgoonie/zernio-cli.git"
+  },
+  "dependencies": {
+    "@zernio/node": "^0.2.261",
+    "dotenv": "^17.4.2",
+    "open": "^11.0.0",
+    "yargs": "^18.0.0"
+  },
+  "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.8",
+    "@semantic-release/npm": "^13.1.5",
+    "@types/node": "^20.19.43",
+    "@types/yargs": "^17.0.35",
+    "@vitest/coverage-v8": "^4.1.8",
+    "semantic-release": "^25.0.5",
+    "tsx": "^4.22.4",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8",
+    "yaml": "^2.9.0"
+  }
+}