@smartspec/cli 0.0.0-stage → 0.1.0

package/lib/wait.js

@@ -0,0 +1,84 @@
+import http from 'node:http';
+import { parseArgs } from 'node:util';
+import { readToken } from './launch.js';
+import { mcpUrl } from './platform.js';
+
+// `smartspec wait`: stays until something the AI asked of the user has happened, then says what and
+// exits. An AI runs it in the background, and its ending wakes the AI. It asks the app, which holds
+// the request open until then; it uses http, as fetch gives up on a reply after five minutes.
+
+export const EXIT = { happened: 0, usage: 1, timedOut: 2, refused: 3, noApp: 4 };
+
+export const WAIT_HELP = `Usage: npx @smartspec/cli wait proposal --id <id> [--timeout <seconds>]
+
+  proposal --id <id>   The user has accepted or discarded this proposal, or it was replaced
+
+Prints what happened as JSON. Exits with 0 when it has happened, 1 if the command is wrong, 2 if
+the timeout passed, 3 if the app says this can never happen, and 4 if the app isn't running or quits.`;
+
+export async function wait(argv, { env = process.env, out = console.log, err = console.error } = {}) {
+  let values;
+  let positionals;
+  try {
+    ({ values, positionals } = parseArgs({ args: argv, allowPositionals: true, options: { id: { type: 'string' }, timeout: { type: 'string' } } }));
+  } catch (error) {
+    err(error.message);
+    return EXIT.usage;
+  }
+  const [what] = positionals;
+  const timeout = values.timeout === undefined ? null : Number(values.timeout);
+  const id = values.id;
+  if (positionals.length !== 1 || what !== 'proposal' || !id || (timeout !== null && !(timeout > 0))) {
+    err(WAIT_HELP);
+    return EXIT.usage;
+  }
+  const token = readToken({ env });
+  if (!token) {
+    err("SmartSpec hasn't been run on this computer yet.");
+    return EXIT.noApp;
+  }
+
+  const reply = await ask(`${mcpUrl(env)}/wait`, token, { what, proposal: id }, timeout);
+  if (reply.timedOut) {
+    err(`Nothing yet after ${timeout} seconds.`);
+    return EXIT.timedOut;
+  }
+  if (reply.lost) {
+    err('SmartSpec isn’t running. Open it, then wait again.');
+    return EXIT.noApp;
+  }
+  if (reply.status === 200) {
+    out(reply.text);
+    return EXIT.happened;
+  }
+  let reason = `SmartSpec refused the request (HTTP ${reply.status}).`;
+  try {
+    reason = JSON.parse(reply.text).error ?? reason;
+  } catch {}
+  err(reason);
+  return reply.status === 401 || reply.status === 403 ? EXIT.noApp : EXIT.refused;
+}
+
+function ask(url, token, body, timeoutSeconds) {
+  return new Promise((resolve) => {
+    let timer = null;
+    const done = (reply) => {
+      clearTimeout(timer);
+      resolve(reply);
+    };
+    const request = http.request(url, { method: 'POST', headers: { authorization: `Bearer ${token}`, 'content-type': 'application/json' } }, (res) => {
+      const chunks = [];
+      res.on('data', (chunk) => chunks.push(chunk));
+      res.on('end', () => done({ status: res.statusCode, text: Buffer.concat(chunks).toString('utf8').trim() }));
+      res.on('error', () => done({ lost: true }));
+    });
+    request.on('error', () => done({ lost: true }));
+    if (timeoutSeconds !== null) {
+      timer = setTimeout(() => {
+        done({ timedOut: true });
+        request.destroy();
+      }, timeoutSeconds * 1000);
+    }
+    request.end(JSON.stringify(body));
+  });
+}

package/mcp.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+// SmartSpec's MCP server, as AI apps start it: the copy inside the SmartSpec app (run by the app's
+// own executable as Node), or `npx @smartspec/cli mcp` (see cli.js). It opens the installed SmartSpec app when the
+// AI first uses it, and passes the AI's messages to it. Only MCP messages go to stdout; progress
+// and errors go to stderr.
+import { readFileSync } from 'node:fs';
+import { runBridge } from './lib/bridge.js';
+import { ensureRunning, readToken } from './lib/launch.js';
+import { VERSION } from './lib/platform.js';
+
+const log = (message) => process.stderr.write(`[smartspec] ${message}\n`);
+const offline = JSON.parse(readFileSync(new URL('./lib/server.json', import.meta.url), 'utf8'));
+
+await runBridge({
+  ensure: () => ensureRunning({ log }),
+  token: () => readToken(),
+  log,
+  offline,
+  version: VERSION,
+});

package/package.json

@@ -1,6 +1,30 @@
 {
   "name": "@smartspec/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "The smartspec command: installs the SmartSpec app, sets up Claude Desktop and Claude Code to use it, checks the connection, and runs SmartSpec's MCP connection for agents set up with npx.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "smartspec": "cli.js"
+  },
+  "files": [
+    "cli.js",
+    "mcp.js",
+    "lib/"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tw050x/smartspec.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/tw050x/smartspec",
+  "keywords": [
+    "mcp",
+    "planning",
+    "contracts",
+    "claude"
+  ]
+}