sloptimize 0.3.0 → 0.3.1

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "sloptimize",
   "displayName": "sloptimize",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "The agent-native profiler for browser games: always-on incident recording, zero-setup attach with file:line attribution, budgets with exit codes — the agent's senses and ruler for performance work.",
   "license": "MIT",
   "keywords": ["profiler", "three.js", "webgpu", "performance", "draw-calls"]

package/README.md

@@ -1,5 +1,7 @@
 # sloptimize
 
+[![npm](https://img.shields.io/npm/v/sloptimize.svg)](https://www.npmjs.com/package/sloptimize)
+
 sloptimize optimizes your game's rendering performance by finding the
 bottlenecks and reporting them to Claude Code to fix — all while you just play
 the game. No action is required on your end.
@@ -64,12 +66,18 @@ and `sloptimize history` read that ledger back.
 
 ## Install
 
+Published on npm as [`sloptimize`](https://www.npmjs.com/package/sloptimize).
+Node 22+.
+
 ```bash
-npm i -D sloptimize        # in your game repo
-# or one-off: npx sloptimize attach --launch http://localhost:3000
-# or from a checkout: node sloptimize/bin/sloptimize.mjs … (bare Node, no install)
+npm i -D sloptimize          # in your game repo (recommended)
+npx sloptimize --version     # confirm: prints the installed version
 ```
 
+No install at all for a one-off: `npx sloptimize attach --launch http://localhost:3000`.
+Working from a git checkout instead? `node /path/to/sloptimize/bin/sloptimize.mjs …`
+runs on bare Node.
+
 Zero dependencies, no postinstall, no supply chain — npm is delivery only.
 
 ## Quickest start: zero integration (tier 0)
@@ -164,14 +172,17 @@ top where the engine grants scene access — see `docs/SPEC.md` §4.
 
 ## Claude Code integration — the whole point
 
-This repo IS a Claude Code plugin. One install:
+The npm package IS a Claude Code plugin — skill, prompt hook, and MCP server
+ship inside it. After `npm i -D sloptimize`, point Claude at it:
 
 ```bash
-claude --plugin-dir node_modules/sloptimize    # after npm i -D sloptimize
-claude --plugin-dir /path/to/sloptimize        # from a checkout
-# or via marketplace: /plugin marketplace add m0dE/sloptimize && /plugin install sloptimize
+claude --plugin-dir node_modules/sloptimize
 ```
 
+Alternatives: `claude --plugin-dir /path/to/sloptimize` from a git checkout,
+or via the marketplace:
+`/plugin marketplace add m0dE/sloptimize` then `/plugin install sloptimize`.
+
 Then let the agent wire your game: `/sloptimize:install` walks it through
 the tier-1 integration (runtime, sink, budgets, hooks) and refuses to call
 itself done until the feed is proven live end-to-end.

package/mcp/server.mjs

@@ -13,9 +13,12 @@
 // wake is not a contract this host documents; when it becomes one, the
 // watcher moves here (SPEC-attach §2, delivery edge).
 import { readFileSync, existsSync } from 'node:fs';
-import { join } from 'node:path';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { createInterface } from 'node:readline';
 
+const PKG_VERSION = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), '..', 'package.json'), 'utf8')).version;
+
 const DIR = () => join(process.cwd(), '.sloptimize');
 let attachSession = null;
 
@@ -111,7 +114,7 @@ rl.on('line', (line) => {
     try {
       if (msg.method === 'initialize') {
         reply(msg.id, { protocolVersion: msg.params?.protocolVersion ?? '2024-11-05',
-          capabilities: { tools: {} }, serverInfo: { name: 'sloptimize', version: '0.3.0' } });
+          capabilities: { tools: {} }, serverInfo: { name: 'sloptimize', version: PKG_VERSION } });
       } else if (msg.method === 'tools/list') {
         reply(msg.id, { tools: TOOLS });
       } else if (msg.method === 'tools/call') {

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "sloptimize",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "type": "module",
   "description": "The agent-native profiler for three.js games: an always-on flight recorder, per-entity cost attribution, and a deterministic bench — so a coding agent can measure, attribute, and verify instead of guessing.",
   "license": "MIT",
   "engines": {
-    "node": ">=18"
+    "node": ">=22"
   },
   "repository": {
     "type": "git",

package/skills/install/SKILL.md

@@ -16,7 +16,8 @@ not report success until step 7 shows your test keyframe in
 
 ## 1. Locate the package and the game's shape
 
-- Find sloptimize: `node_modules/sloptimize` (npm) or a sibling checkout.
+- Find sloptimize: `node_modules/sloptimize` (from `npm i -D sloptimize`) or a
+  sibling checkout. If neither exists, install it from npm first.
 - Identify: the render loop's stats site (wherever `renderer.info` is
   already read), the dev-server topology (vite? own server? esbuild?), and
   the dev-only switch the project already uses for debug endpoints.