qbsm-init 0.1.0 → 0.2.0

package/README.md

@@ -1,44 +1,66 @@
 # qbsm-init
 
-One-shot CLI that wires **qb-skill-manager** (skills auto-extraction for Claude Code) into any project. After running this, Claude Code in that project can call the qbsm MCP server (SSE, hosted on Fly.io) to record skills demonstrated in the conversation.
+One-shot CLI that wires **qb-skill-manager** (skills auto-extraction for Claude Code) into any project. After running this, Claude Code in that project can call the qbsm MCP server (Streamable HTTP, hosted on Fly.io) to record skills demonstrated in the conversation.
 
 ## Quick start
 
 ```bash
-# 1. Sign up + issue an API token at https://qb-skill-manager.fly.dev/settings/tokens
+# 1. Sign up + issue an API token at https://qbsm.fly.dev/settings/tokens
 # 2. Run qbsm-init in your project directory:
 npx qbsm-init --api-key qbsm_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
 ```
 
 That writes three files in your project (all merged idempotently if they already exist):
 
-- `.mcp.json` — registers `qbsm` as a remote SSE MCP server
+- `.mcp.json` — registers `qbsm` as a remote Streamable HTTP MCP server
 - `CLAUDE.md` — appends a guidance section so Claude Code knows when to call the tools
 - `.claude/settings.json` — hooks that nudge the agent to call `register_skill` after package installs
 
 Then start a Claude Code session as usual; the `qbsm` server appears in `claude mcp list`.
 
+## What changed in 0.2.0
+
+- Default transport switched from **SSE** (`type: "sse"`) to **Streamable HTTP** (`type: "http"`). Streamable HTTP is the current MCP spec (2025-03-26), is stateless per request, and runs on multi-machine / HA hosts. Add `--legacy-sse` to keep the old behavior if your Claude Code client does not yet support `type: "http"`.
+- Default `--server-url` updated to `https://qbsm.fly.dev` (Fly.io app rename).
+
 ## Options
 
 | Flag | Description |
 |------|-------------|
-| `--api-key <key>` | Required (or interactive prompt). Get at `https://qb-skill-manager.fly.dev/settings/tokens` |
-| `--server-url <url>` | Override server (default `https://qb-skill-manager.fly.dev`) |
+| `--api-key <key>` | Required (or interactive prompt). Get at `https://qbsm.fly.dev/settings/tokens` |
+| `--server-url <url>` | Override server (default `https://qbsm.fly.dev`) |
 | `-y, --yes` | Non-interactive mode; `--api-key` becomes required |
 | `--no-hooks` | Skip `.claude/settings.json` hook registration |
 | `--overwrite` | Replace existing `<qbsm:start>…<qbsm:end>` section in CLAUDE.md |
+| `--legacy-sse` | Generate the older `type: "sse"` + `/api/mcp/sse` config |
 | `-h, --help` | Show help |
 
 Positional `[target-path]` (default `.`) lets you point at a sibling directory.
 
 ## Generated `.mcp.json` entry
 
+**Default (Streamable HTTP):**
+
+```json
+{
+  "mcpServers": {
+    "qbsm": {
+      "type": "http",
+      "url": "https://qbsm.fly.dev/api/mcp",
+      "headers": { "x-api-key": "qbsm_..." }
+    }
+  }
+}
+```
+
+**With `--legacy-sse`:**
+
 ```json
 {
   "mcpServers": {
     "qbsm": {
       "type": "sse",
-      "url": "https://qb-skill-manager.fly.dev/api/mcp/sse",
+      "url": "https://qbsm.fly.dev/api/mcp/sse",
       "headers": { "x-api-key": "qbsm_..." }
     }
   }
@@ -58,4 +80,4 @@ Positional `[target-path]` (default `.`) lets you point at a sibling directory.
 
 ## Tokens
 
-If a token is leaked, revoke it at `https://qb-skill-manager.fly.dev/settings/tokens` and re-run `qbsm-init --api-key <new>` to overwrite `.mcp.json`.
+If a token is leaked, revoke it at `https://qbsm.fly.dev/settings/tokens` and re-run `qbsm-init --api-key <new>` to overwrite `.mcp.json`.

package/dist/init.js

@@ -2,7 +2,7 @@
 import { readFileSync, writeFileSync, existsSync, mkdirSync, statSync, } from "node:fs";
 import { join, resolve } from "node:path";
 import { createInterface } from "node:readline";
-const DEFAULT_SERVER_URL = "https://qb-skill-manager.fly.dev";
+const DEFAULT_SERVER_URL = "https://qbsm.fly.dev";
 const SERVER_KEY = "qbsm";
 const CLAUDE_MD_SECTION_START = "<!-- qbsm:start -->";
 const CLAUDE_MD_SECTION_END = "<!-- qbsm:end -->";
@@ -14,6 +14,7 @@ function parseArgs(argv) {
         yes: false,
         noHooks: false,
         overwrite: false,
+        legacySse: false,
     };
     for (let i = 0; i < args.length; i++) {
         const a = args[i];
@@ -30,6 +31,9 @@ function parseArgs(argv) {
         else if (a === "--overwrite") {
             flags.overwrite = true;
         }
+        else if (a === "--legacy-sse") {
+            flags.legacySse = true;
+        }
         else if (a === "--api-key") {
             flags.apiKey = args[++i];
         }
@@ -55,10 +59,15 @@ Options:
   -y, --yes            Skip all prompts; use defaults
       --no-hooks       Skip .claude/settings.json hooks registration
       --overwrite      Overwrite .mcp.json / CLAUDE.md section if present
+      --legacy-sse     Generate legacy SSE config (type: "sse" + /api/mcp/sse)
+                       instead of Streamable HTTP. Use only if your Claude Code
+                       client does not yet support type: "http".
   -h, --help           Show this help
 
 What it does (idempotent merge):
-  - .mcp.json           adds an "${SERVER_KEY}" entry pointing to the SSE endpoint
+  - .mcp.json           adds an "${SERVER_KEY}" entry pointing to the Streamable
+                        HTTP endpoint (POST /api/mcp). Use --legacy-sse for the
+                        old SSE transport.
   - CLAUDE.md           appends a guidance section between qbsm:start/end markers
   - .claude/settings.json
                         registers PostToolUse (npm/pip/go/cargo install detector)
@@ -93,20 +102,25 @@ function readJson(path) {
 function writeJson(path, value, mode = 0o644) {
     writeFileSync(path, JSON.stringify(value, null, 2) + "\n", { mode });
 }
-function writeMcpJson(target, apiKey, serverUrl, overwrite) {
+function writeMcpJson(target, apiKey, serverUrl, legacySse) {
     const path = join(target, ".mcp.json");
-    const entry = {
-        type: "sse",
-        url: `${serverUrl.replace(/\/$/, "")}/api/mcp/sse`,
-        headers: { "x-api-key": apiKey },
-    };
-    let config = readJson(path) ?? {};
+    const base = serverUrl.replace(/\/$/, "");
+    const entry = legacySse
+        ? {
+            type: "sse",
+            url: `${base}/api/mcp/sse`,
+            headers: { "x-api-key": apiKey },
+        }
+        : {
+            type: "http",
+            url: `${base}/api/mcp`,
+            headers: { "x-api-key": apiKey },
+        };
+    const config = readJson(path) ?? {};
     const servers = (config.mcpServers && typeof config.mcpServers === "object"
         ? config.mcpServers
         : {});
-    if (servers[SERVER_KEY] && !overwrite) {
-        // upsert: replace existing qbsm entry (always — overwrite flag is for non-qbsm collisions)
-    }
+    // Always upsert the qbsm entry (overwrite flag is reserved for CLAUDE.md section replacement).
     servers[SERVER_KEY] = entry;
     config.mcpServers = servers;
     writeJson(path, config);
@@ -199,8 +213,8 @@ async function main() {
         console.error("✗ API key must start with 'qbsm_'");
         process.exit(1);
     }
-    const mcpPath = writeMcpJson(target, apiKey, flags.serverUrl, flags.overwrite);
-    console.log(`✓ .mcp.json   ${mcpPath}`);
+    const mcpPath = writeMcpJson(target, apiKey, flags.serverUrl, flags.legacySse);
+    console.log(`✓ .mcp.json   ${mcpPath} (${flags.legacySse ? "sse" : "http"})`);
     const claude = writeClaudeMd(target, flags.overwrite);
     console.log(`✓ CLAUDE.md   ${claude.path} (${claude.action})`);
     if (flags.noHooks) {
@@ -210,9 +224,10 @@ async function main() {
         const settings = writeClaudeSettings(target);
         console.log(`✓ .claude/settings.json   ${settings.path} (${settings.action})`);
     }
+    const endpointPath = flags.legacySse ? "/api/mcp/sse" : "/api/mcp";
     console.log(`
 Done. Start a Claude Code session in ${target} and the qbsm MCP server will be
-reachable at ${flags.serverUrl}/api/mcp/sse with your API key.
+reachable at ${flags.serverUrl}${endpointPath} with your API key.
 
 To verify quickly:
   cd ${target} && claude mcp list   # should include "qbsm"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qbsm-init",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "One-shot CLI to wire qb-skill-manager MCP into a project (.mcp.json + CLAUDE.md + hooks)",
   "type": "module",
   "bin": {