feat: rename package to @opensea/cli with stub redirect (#24)

Move from `opensea-cli` to the scoped `@opensea/cli` package name.
The old `opensea-cli` name becomes a minimal stub that warns users
to install `@opensea/cli` instead. Bumps version to 0.2.0.

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: ryanio

.agents/rules.md

@@ -228,3 +228,7 @@ All CI checks must pass before merging.
 ### Publishing
 
 - GitHub Actions workflow (`.github/workflows/npm-publish.yml`) publishes to npm on GitHub release.
+- **Dual-package publishing**: The workflow publishes two packages:
+  1. `@opensea/cli` — the main package (from repo root).
+  2. `opensea-cli` — a stub redirect package (from `packages/opensea-cli-stub/`) that warns users to install `@opensea/cli`. The stub publish uses `continue-on-error: true` since its version rarely changes.
+- Auth uses OIDC via `id-token: write` + `setup-node` with `registry-url` + `--provenance` flag. No npm token secret needed.

.github/workflows/npm-publish.yml

@@ -16,5 +16,11 @@ jobs:
         with:
           node-version-file: .nvmrc
           registry-url: https://registry.npmjs.org/
+      # Publish @opensea/cli
       - run: npm install
       - run: npm publish --provenance --access public
+
+      # Publish opensea-cli stub (skip if version already exists)
+      - run: npm publish --provenance --access public
+        working-directory: packages/opensea-cli-stub
+        continue-on-error: true

README.md

@@ -35,13 +35,13 @@ Query the OpenSea API from the command line or programmatically. Designed for bo
 ## Install
 
 ```bash
-npm install -g opensea-cli
+npm install -g @opensea/cli
 ```
 
 Or use without installing:
 
 ```bash
-npx opensea-cli collections get mfers
+npx @opensea/cli collections get mfers
 ```
 
 ## Authentication
@@ -149,7 +149,7 @@ opensea accounts get <address>
 Use as a TypeScript/JavaScript library:
 
 ```typescript
-import { OpenSeaCLI } from "opensea-cli"
+import { OpenSeaCLI } from "@opensea/cli"
 
 const client = new OpenSeaCLI({ apiKey: process.env.OPENSEA_API_KEY })
 
@@ -335,8 +335,8 @@ opensea accounts get 0x21130e908bba2d41b63fbca7caa131285b8724f8
 
 [version-badge]: https://img.shields.io/github/package-json/v/ProjectOpenSea/opensea-cli
 [version-link]: https://github.com/ProjectOpenSea/opensea-cli/releases
-[npm-badge]: https://img.shields.io/npm/v/opensea-cli?color=red
-[npm-link]: https://www.npmjs.com/package/opensea-cli
+[npm-badge]: https://img.shields.io/npm/v/@opensea/cli?color=red
+[npm-link]: https://www.npmjs.com/package/@opensea/cli
 [ci-badge]: https://github.com/ProjectOpenSea/opensea-cli/actions/workflows/ci.yml/badge.svg
 [ci-link]: https://github.com/ProjectOpenSea/opensea-cli/actions/workflows/ci.yml
 [license-badge]: https://img.shields.io/github/license/ProjectOpenSea/opensea-cli

package-lock.json

@@ -1,6 +1,6 @@
 {
-  "name": "opensea-cli",
-  "version": "0.1.6",
+  "name": "@opensea/cli",
+  "version": "0.2.0",
   "type": "module",
   "description": "OpenSea CLI - Query the OpenSea API from the command line or programmatically",
   "main": "dist/index.js",

package.json

@@ -0,0 +1,13 @@
+{
+  "name": "opensea-cli",
+  "version": "0.2.0",
+  "description": "This package has moved to @opensea/cli",
+  "scripts": {
+    "postinstall": "node postinstall.js"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ProjectOpenSea/opensea-cli"
+  }
+}

packages/opensea-cli-stub/package.json

@@ -0,0 +1,11 @@
+console.warn(`
+╔═══════════════════════════════════════════════════════════════╗
+║                                                               ║
+║  You installed "opensea-cli" — this package has moved.        ║
+║                                                               ║
+║  Install the correct package:                                 ║
+║                                                               ║
+║    npm install -g @opensea/cli                                ║
+║                                                               ║
+╚═══════════════════════════════════════════════════════════════╝
+`)