@hasna/skills 0.1.66 → 0.1.68

package/bin/index.js

@@ -36860,7 +36860,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/skills",
-    version: "0.1.66",
+    version: "0.1.68",
     description: "Skills library for AI coding agents",
     type: "module",
     bin: {
@@ -36901,6 +36901,7 @@ var init_package = __esm(() => {
     scripts: {
       clean: "rm -rf bin/ dist/",
       build: "bun run clean && bun build ./src/cli/index.tsx --outdir ./bin --target bun && bun build ./src/mcp/index.ts --outfile ./bin/mcp.js --target bun && bun build ./src/server/index.ts --outfile ./bin/server.js --target bun && bun build ./src/server/worker.ts --outfile ./bin/worker.js --target bun && bun build ./src/server/migrate.ts --outfile ./bin/migrate.js --target bun && bun build ./src/index.ts ./src/storage.ts ./src/sdk/index.ts --outdir ./dist --target bun && tsc --emitDeclarationOnly --declaration --outDir dist",
+      "build:js": "rm -rf dist && bun build ./src/index.ts ./src/storage.ts ./src/sdk/index.ts --outdir ./dist --target bun && tsc --emitDeclarationOnly --declaration --outDir dist",
       test: "bun test --timeout 30000",
       dev: "bun run ./src/cli/index.tsx",
       "dev:watch": "bun --watch run ./src/cli/index.tsx",
@@ -36910,6 +36911,7 @@ var init_package = __esm(() => {
       migrate: "bun run ./src/server/migrate.ts",
       typecheck: "tsc --noEmit",
       "verify:release": "bun run scripts/release-guard.ts",
+      prepare: "bun run build:js",
       prepack: "bun run build && bun run verify:release",
       prepublishOnly: "bun run typecheck && bun run test",
       postinstall: "mkdir -p $HOME/.hasna/skills/custom 2>/dev/null || true"
@@ -56486,6 +56488,42 @@ var init_types2 = __esm(() => {
 });
 
 // ../../node_modules/.bun/@modelcontextprotocol+sdk@1.30.0/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/stdio.js
+class ReadBuffer {
+  constructor(options) {
+    this._maxBufferSize = options?.maxBufferSize ?? STDIO_DEFAULT_MAX_BUFFER_SIZE;
+  }
+  append(chunk2) {
+    const newSize = (this._buffer?.length ?? 0) + chunk2.length;
+    if (newSize > this._maxBufferSize) {
+      this.clear();
+      throw new Error(`ReadBuffer exceeded maximum size of ${this._maxBufferSize} bytes`);
+    }
+    this._buffer = this._buffer ? Buffer.concat([this._buffer, chunk2]) : chunk2;
+  }
+  readMessage() {
+    if (!this._buffer) {
+      return null;
+    }
+    const index = this._buffer.indexOf(`
+`);
+    if (index === -1) {
+      return null;
+    }
+    const line = this._buffer.toString("utf8", 0, index).replace(/\r$/, "");
+    this._buffer = this._buffer.subarray(index + 1);
+    return deserializeMessage(line);
+  }
+  clear() {
+    this._buffer = undefined;
+  }
+}
+function deserializeMessage(line) {
+  return JSONRPCMessageSchema.parse(JSON.parse(line));
+}
+function serializeMessage(message) {
+  return JSON.stringify(message) + `
+`;
+}
 var STDIO_DEFAULT_MAX_BUFFER_SIZE;
 var init_stdio = __esm(() => {
   init_types2();
@@ -56493,6 +56531,69 @@ var init_stdio = __esm(() => {
 });
 
 // ../../node_modules/.bun/@modelcontextprotocol+sdk@1.30.0/node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
+import process14 from "process";
+
+class StdioServerTransport {
+  constructor(_stdin = process14.stdin, _stdout = process14.stdout, options) {
+    this._stdin = _stdin;
+    this._stdout = _stdout;
+    this._started = false;
+    this._ondata = (chunk2) => {
+      try {
+        this._readBuffer.append(chunk2);
+        this.processReadBuffer();
+      } catch (error2) {
+        this.onerror?.(error2);
+        this.close().catch(() => {});
+      }
+    };
+    this._onerror = (error2) => {
+      this.onerror?.(error2);
+    };
+    this._readBuffer = new ReadBuffer({ maxBufferSize: options?.maxBufferSize });
+  }
+  async start() {
+    if (this._started) {
+      throw new Error("StdioServerTransport already started! If using Server class, note that connect() calls start() automatically.");
+    }
+    this._started = true;
+    this._stdin.on("data", this._ondata);
+    this._stdin.on("error", this._onerror);
+  }
+  processReadBuffer() {
+    while (true) {
+      try {
+        const message = this._readBuffer.readMessage();
+        if (message === null) {
+          break;
+        }
+        this.onmessage?.(message);
+      } catch (error2) {
+        this.onerror?.(error2);
+      }
+    }
+  }
+  async close() {
+    this._stdin.off("data", this._ondata);
+    this._stdin.off("error", this._onerror);
+    const remainingDataListeners = this._stdin.listenerCount("data");
+    if (remainingDataListeners === 0) {
+      this._stdin.pause();
+    }
+    this._readBuffer.clear();
+    this.onclose?.();
+  }
+  send(message) {
+    return new Promise((resolve) => {
+      const json = serializeMessage(message);
+      if (this._stdout.write(json)) {
+        resolve();
+      } else {
+        this._stdout.once("drain", resolve);
+      }
+    });
+  }
+}
 var init_stdio2 = __esm(() => {
   init_stdio();
 });
@@ -70164,6 +70265,7 @@ var init_http = __esm(() => {
 // src/mcp/index.ts
 var exports_mcp = {};
 __export(exports_mcp, {
+  startMcpStdio: () => startMcpStdio,
   buildServer: () => buildServer
 });
 function printHelp() {
@@ -70177,6 +70279,10 @@ Options:
   --http         run Streamable HTTP transport on 127.0.0.1 (default port 8836)
   --port <n>     HTTP port (--http or MCP_HTTP=1)`);
 }
+async function startMcpStdio() {
+  const server2 = buildServer();
+  await server2.connect(new StdioServerTransport);
+}
 var args;
 var init_mcp2 = __esm(() => {
   init_stdio2();
@@ -70232,7 +70338,8 @@ async function handleMcp(options) {
       process.exitCode = 1;
     return;
   }
-  await Promise.resolve().then(() => (init_mcp2(), exports_mcp));
+  const { startMcpStdio: startMcpStdio2 } = await Promise.resolve().then(() => (init_mcp2(), exports_mcp));
+  await startMcpStdio2();
 }
 async function registerMcpForAgent(agent, command) {
   switch (agent) {
@@ -70435,7 +70542,14 @@ function registerRuntime(parent) {
   const exportsCommand = parent.command("exports").description("Inspect or open skill run exports");
   exportsCommand.command("open").argument("<run-id>", "Run id").option("--json", "Output as JSON", false).description("Open the export directory for a run").action((runId, options) => handleExportsOpen(runId, options));
   exportsCommand.command("download").argument("<run-id>", "Remote run id").option("--json", "Output as JSON", false).description("Download remote run artifacts into .skills/exports").action((runId, options) => handleExportsDownload(runId, options));
-  parent.command("mcp").option("--register <agent>", "Register MCP server with agent").option("--json", "Output registration result as JSON", false).description("Start MCP server (stdio) or register with an agent").action(async (options) => handleMcp(options));
+  parent.command("mcp").option("--register <agent>", "Register MCP server with agent").option("--json", "Output registration result as JSON", false).allowExcessArguments(true).description("Start MCP server (stdio) or register with an agent").action(async (options, command) => {
+    const stray = command.args[0];
+    if (stray !== undefined) {
+      console.error(source_default.red(`error: unknown argument '${stray}'. 'skills mcp' takes no positional arguments. ` + `Valid forms: 'skills mcp' (start the MCP stdio server), ` + `'skills mcp --register <agent>', 'skills mcp --register all'`));
+      process.exit(1);
+    }
+    await handleMcp(options);
+  });
   const setup = parent.command("setup").description("Point this CLI at a Skills API server, or register agent integrations").option("--api-url <url>", "Skills API origin to send remote work to").option("--global", "Save the API origin globally instead of in this project", false).option("--json", "Output setup result as JSON", false).action(async (options) => handleSetup(options));
   setup.command("agents").option("--json", "Output registration result as JSON", false).description("Register the Skills MCP server with all supported agents").action(async (options) => handleMcp({ register: "all", json: options.json }));
   parent.command("self-update").description("Update @hasna/skills to the latest version").option("--json", "Output result as JSON", false).action(async (options) => {
@@ -81394,7 +81508,13 @@ if (process.argv.includes("--no-color")) {
 }
 var program2 = new Command;
 program2.name("skills").description("Discover and run AI agent skills through the Skills CLI/MCP").version(package_default.version).option("--verbose", "Enable verbose logging", false).option("--no-color", "Disable colored output (also respects NO_COLOR env var)").enablePositionalOptions();
-program2.command("interactive", { isDefault: true }).alias("i").description("Interactive skill browser (TUI)").action(() => {
+program2.command("interactive", { isDefault: true }).alias("i").allowExcessArguments(true).description("Interactive skill browser (TUI)").action((_options, command) => {
+  const stray = command.args[0];
+  if (stray !== undefined) {
+    const verbs = program2.commands.map((c) => c.name()).filter((n) => n !== "interactive").sort();
+    console.error(source_default.red(`error: unknown command '${stray}'. Valid commands: ${verbs.join(", ")}`));
+    process.exit(1);
+  }
   if (!isTTY2) {
     console.log(JSON.stringify(loadBasicRegistry().map(getCompactSkillDiscovery)));
     process.exit(0);

package/bin/mcp.js

@@ -12943,7 +12943,7 @@ class StdioServerTransport {
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.1.66",
+  version: "0.1.68",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {
@@ -12984,6 +12984,7 @@ var package_default = {
   scripts: {
     clean: "rm -rf bin/ dist/",
     build: "bun run clean && bun build ./src/cli/index.tsx --outdir ./bin --target bun && bun build ./src/mcp/index.ts --outfile ./bin/mcp.js --target bun && bun build ./src/server/index.ts --outfile ./bin/server.js --target bun && bun build ./src/server/worker.ts --outfile ./bin/worker.js --target bun && bun build ./src/server/migrate.ts --outfile ./bin/migrate.js --target bun && bun build ./src/index.ts ./src/storage.ts ./src/sdk/index.ts --outdir ./dist --target bun && tsc --emitDeclarationOnly --declaration --outDir dist",
+    "build:js": "rm -rf dist && bun build ./src/index.ts ./src/storage.ts ./src/sdk/index.ts --outdir ./dist --target bun && tsc --emitDeclarationOnly --declaration --outDir dist",
     test: "bun test --timeout 30000",
     dev: "bun run ./src/cli/index.tsx",
     "dev:watch": "bun --watch run ./src/cli/index.tsx",
@@ -12993,6 +12994,7 @@ var package_default = {
     migrate: "bun run ./src/server/migrate.ts",
     typecheck: "tsc --noEmit",
     "verify:release": "bun run scripts/release-guard.ts",
+    prepare: "bun run build:js",
     prepack: "bun run build && bun run verify:release",
     prepublishOnly: "bun run typecheck && bun run test",
     postinstall: "mkdir -p $HOME/.hasna/skills/custom 2>/dev/null || true"
@@ -28409,10 +28411,13 @@ if (args.includes("--version") || args.includes("-V")) {
   console.log(package_default.version);
   process.exit(0);
 }
+async function startMcpStdio() {
+  const server2 = buildServer();
+  await server2.connect(new StdioServerTransport);
+}
 async function main() {
   if (isMcpStdioMode(args)) {
-    const server2 = buildServer();
-    await server2.connect(new StdioServerTransport);
+    await startMcpStdio();
     return;
   }
   const port = parseMcpHttpPort(args);
@@ -28425,5 +28430,6 @@ if (import.meta.main) {
   });
 }
 export {
+  startMcpStdio,
   buildServer
 };

package/bin/server.js

@@ -22939,7 +22939,7 @@ var init_dist_es9 = __esm(() => {
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.1.66",
+  version: "0.1.68",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {
@@ -22980,6 +22980,7 @@ var package_default = {
   scripts: {
     clean: "rm -rf bin/ dist/",
     build: "bun run clean && bun build ./src/cli/index.tsx --outdir ./bin --target bun && bun build ./src/mcp/index.ts --outfile ./bin/mcp.js --target bun && bun build ./src/server/index.ts --outfile ./bin/server.js --target bun && bun build ./src/server/worker.ts --outfile ./bin/worker.js --target bun && bun build ./src/server/migrate.ts --outfile ./bin/migrate.js --target bun && bun build ./src/index.ts ./src/storage.ts ./src/sdk/index.ts --outdir ./dist --target bun && tsc --emitDeclarationOnly --declaration --outDir dist",
+    "build:js": "rm -rf dist && bun build ./src/index.ts ./src/storage.ts ./src/sdk/index.ts --outdir ./dist --target bun && tsc --emitDeclarationOnly --declaration --outDir dist",
     test: "bun test --timeout 30000",
     dev: "bun run ./src/cli/index.tsx",
     "dev:watch": "bun --watch run ./src/cli/index.tsx",
@@ -22989,6 +22990,7 @@ var package_default = {
     migrate: "bun run ./src/server/migrate.ts",
     typecheck: "tsc --noEmit",
     "verify:release": "bun run scripts/release-guard.ts",
+    prepare: "bun run build:js",
     prepack: "bun run build && bun run verify:release",
     prepublishOnly: "bun run typecheck && bun run test",
     postinstall: "mkdir -p $HOME/.hasna/skills/custom 2>/dev/null || true"

package/dist/index.js

@@ -10342,7 +10342,7 @@ import { dirname as dirname8, relative as relative3 } from "path";
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.1.66",
+  version: "0.1.68",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {
@@ -10383,6 +10383,7 @@ var package_default = {
   scripts: {
     clean: "rm -rf bin/ dist/",
     build: "bun run clean && bun build ./src/cli/index.tsx --outdir ./bin --target bun && bun build ./src/mcp/index.ts --outfile ./bin/mcp.js --target bun && bun build ./src/server/index.ts --outfile ./bin/server.js --target bun && bun build ./src/server/worker.ts --outfile ./bin/worker.js --target bun && bun build ./src/server/migrate.ts --outfile ./bin/migrate.js --target bun && bun build ./src/index.ts ./src/storage.ts ./src/sdk/index.ts --outdir ./dist --target bun && tsc --emitDeclarationOnly --declaration --outDir dist",
+    "build:js": "rm -rf dist && bun build ./src/index.ts ./src/storage.ts ./src/sdk/index.ts --outdir ./dist --target bun && tsc --emitDeclarationOnly --declaration --outDir dist",
     test: "bun test --timeout 30000",
     dev: "bun run ./src/cli/index.tsx",
     "dev:watch": "bun --watch run ./src/cli/index.tsx",
@@ -10392,6 +10393,7 @@ var package_default = {
     migrate: "bun run ./src/server/migrate.ts",
     typecheck: "tsc --noEmit",
     "verify:release": "bun run scripts/release-guard.ts",
+    prepare: "bun run build:js",
     prepack: "bun run build && bun run verify:release",
     prepublishOnly: "bun run typecheck && bun run test",
     postinstall: "mkdir -p $HOME/.hasna/skills/custom 2>/dev/null || true"

package/dist/mcp/index.d.ts

@@ -8,4 +8,14 @@
  *   skills-mcp          # Direct binary
  *   skills-mcp --http   # Streamable HTTP on 127.0.0.1:8836
  */
+/**
+ * Start the Skills MCP server on stdio (newline-delimited JSON-RPC).
+ *
+ * Exported so the `skills mcp` CLI subcommand can start the server directly:
+ * a bare dynamic import of this module is inert, because `import.meta.main`
+ * is false when the module is not the process entry point — which made
+ * `skills mcp` exit rc=0 with zero bytes instead of starting the documented
+ * stdio server (BUG e3997558).
+ */
+export declare function startMcpStdio(): Promise<void>;
 export { buildServer } from "./server.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/skills",
-  "version": "0.1.66",
+  "version": "0.1.68",
   "description": "Skills library for AI coding agents",
   "type": "module",
   "bin": {
@@ -41,6 +41,7 @@
   "scripts": {
     "clean": "rm -rf bin/ dist/",
     "build": "bun run clean && bun build ./src/cli/index.tsx --outdir ./bin --target bun && bun build ./src/mcp/index.ts --outfile ./bin/mcp.js --target bun && bun build ./src/server/index.ts --outfile ./bin/server.js --target bun && bun build ./src/server/worker.ts --outfile ./bin/worker.js --target bun && bun build ./src/server/migrate.ts --outfile ./bin/migrate.js --target bun && bun build ./src/index.ts ./src/storage.ts ./src/sdk/index.ts --outdir ./dist --target bun && tsc --emitDeclarationOnly --declaration --outDir dist",
+    "build:js": "rm -rf dist && bun build ./src/index.ts ./src/storage.ts ./src/sdk/index.ts --outdir ./dist --target bun && tsc --emitDeclarationOnly --declaration --outDir dist",
     "test": "bun test --timeout 30000",
     "dev": "bun run ./src/cli/index.tsx",
     "dev:watch": "bun --watch run ./src/cli/index.tsx",
@@ -50,6 +51,7 @@
     "migrate": "bun run ./src/server/migrate.ts",
     "typecheck": "tsc --noEmit",
     "verify:release": "bun run scripts/release-guard.ts",
+    "prepare": "bun run build:js",
     "prepack": "bun run build && bun run verify:release",
     "prepublishOnly": "bun run typecheck && bun run test",
     "postinstall": "mkdir -p $HOME/.hasna/skills/custom 2>/dev/null || true"