@aggc/or-info 0.1.0 → 0.1.2

package/README.md

@@ -13,6 +13,16 @@ to make informed decisions about which model to use.
 
 ```bash
 npm install -g @aggc/or-info
+or-info --version
+```
+
+The npm package is published as `@aggc/or-info`, but the installed executable is
+`or-info`.
+
+You can also run it without a global install:
+
+```bash
+npx -y @aggc/or-info models --limit 5
 ```
 
 Requires Node.js 22 or later.
@@ -285,6 +295,36 @@ Additional entry points:
 - `npm run test:online:smoke` for the live smoke subset used by CI as a non-blocking signal
 - `npm run test:online` for the full live CLI/MCP suite, including edge cases
 
+## Release
+
+Releases are published automatically to npm from GitHub Actions when a version tag is pushed.
+The package is public under the `@aggc` npm scope.
+
+Release checklist:
+
+1. Update `CHANGELOG.md`.
+2. Bump `version` in `package.json`.
+3. Run `npm test`.
+4. Commit and push to `main`.
+5. Create and push a matching tag:
+
+```bash
+git tag v0.x.0
+git push origin v0.x.0
+```
+
+The publish workflow runs `npm ci`, `npm run test:local`, then
+`npm publish --provenance --access public`.
+
+Repository release requirements:
+
+- GitHub secret `NPM_TOKEN` must exist for `jmtrs/or-info`.
+- The token must have npm publish permission for `@aggc/or-info`.
+- `id-token: write` is enabled so npm provenance is attached to published versions.
+
+After the initial package bootstrap, prefer migrating to npm Trusted Publishing and then
+remove `NPM_TOKEN` from the repository secrets.
+
 ## Contributing
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) — adding new CLI commands or new MCP tools.

package/bin/or-info.mjs

@@ -40,7 +40,7 @@ async function apiKey() {
 program
   .name('or-info')
   .description('OpenRouter model info: prices, benchmarks, context and comparisons')
-  .version('0.1.0')
+  .version('0.1.2')
   .option('--mcp', 'Start MCP server (stdio transport)');
 
 // ── models ─────────────────────────────────────────────────────────────────

package/lib/lmarena.mjs

@@ -29,7 +29,7 @@ async function fetchPage(offset) {
     let res;
     try {
       res = await fetch(url, {
-        headers: { 'User-Agent': 'or-info-cli/0.1.0' },
+        headers: { 'User-Agent': 'or-info-cli/0.1.2' },
         signal: AbortSignal.timeout(15_000),
       });
     } catch (err) {

package/lib/openrouter.mjs

@@ -2,7 +2,7 @@ import { get, set, TTL } from './cache.mjs';
 import { MODELS_CACHE } from './paths.mjs';
 
 const OR_BASE = 'https://openrouter.ai/api/v1';
-const USER_AGENT = 'or-info-cli/0.1.0 (https://github.com/jmtrs/or-info)';
+const USER_AGENT = 'or-info-cli/0.1.2 (https://github.com/jmtrs/or-info)';
 const RETRYABLE_STATUSES = new Set([429, 500, 502, 503, 504]);
 const MAX_FETCH_RETRIES = 2;
 

package/mcp/server.mjs

@@ -183,7 +183,7 @@ async function handleTool(name, args) {
 
 export async function startMcp() {
   const server = new Server(
-    { name: 'or-info', version: '0.1.0' },
+    { name: 'or-info', version: '0.1.2' },
     { capabilities: { tools: {} } }
   );
 

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@aggc/or-info",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "CLI + MCP server for OpenRouter models: prices, benchmarks, context and comparisons",
   "type": "module",
   "engines": {
     "node": ">=22"
   },
   "bin": {
-    "or-info": "./bin/or-info.mjs"
+    "or-info": "bin/or-info.mjs"
   },
   "files": [
     "bin",