@procedures/mark 0.0.0-stage → 0.2.0

package/dist/server-mode.js

@@ -0,0 +1,167 @@
+/**
+ * CLI Server Mode
+ *
+ * Runs the CLI as a persistent server, exposing all ecosystem procedures
+ * via HTTP. The server has the registry of mark (the module of each package, roadmap 3.1) and
+ * the host policy of the core (roadmap 2.3): the token in the lockfile.
+ */
+import { print } from "./print.js";
+import { loadEcosystemRegistry } from "./ecosystem.js";
+import { randomBytes } from "node:crypto";
+import { writeLockfile, removeLockfileForPort, getLockfilePath, currentBuild } from "./lockfile.js";
+/**
+ * Build transport configuration array
+ */
+function buildTransports(options) {
+    const transports = [];
+    // Loopback and no CORS by default: the server holds the whole registry, shell.* included.
+    // Before, it listened on 0.0.0.0 with Access-Control-Allow-Origin: * (deep dive CLI-1, TRN-1).
+    const { port, host = "127.0.0.1", transport = "http" } = options;
+    if (transport === "http" || transport === "both") {
+        transports.push({
+            type: "http",
+            port,
+            host,
+            basePath: "/api",
+        });
+    }
+    if (transport === "websocket" || transport === "both") {
+        transports.push({
+            type: "websocket",
+            port: transport === "both" ? port + 1 : port,
+            host,
+            path: "/ws",
+        });
+    }
+    return transports;
+}
+/**
+ * Start CLI in server mode
+ */
+export async function startServerMode(options) {
+    const { port = 3000, verbose = false } = options;
+    print.info("Starting CLI server mode...");
+    // The registry of mark (roadmap 3.1): the module of each workspace package, with the server
+    // procedures (client-server is in the workspace)
+    if (verbose) {
+        print.info("Loading ecosystem procedures...");
+    }
+    const { registry } = await loadEcosystemRegistry(verbose);
+    // Build transport config
+    const transports = buildTransports(options);
+    // Every request must send this token. Only the lockfile (readable by this user) holds it.
+    const token = randomBytes(32).toString("hex");
+    const host = options.host ?? "127.0.0.1";
+    if (!["127.0.0.1", "localhost", "::1"].includes(host)) {
+        print.warning(`The server listens on ${host}: other computers can reach it. Every request needs its token.`);
+    }
+    if (options.transport === "websocket") {
+        print.warning("A WebSocket-only server takes no `mark` commands: `mark` sends its commands over HTTP.");
+    }
+    // The host policy of the core (roadmap 2.3): the token of each transport. The server of mark
+    // serves every procedure of the workspace to its one user, so it has no expose list.
+    const { hostPolicy } = await import("@procedures/client");
+    const { createPeer } = await import("@procedures/peer");
+    const peer = await createPeer({
+        id: `peer-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+        transports,
+        registry,
+        policy: hostPolicy({ token }),
+    });
+    await peer.start();
+    const result = {
+        serverId: peer.id,
+        endpoints: peer.getEndpoints(),
+        procedureCount: peer.getServer().procedureCount,
+    };
+    // Write lockfile for client discovery. A client uses this server only from the same folder,
+    // with the same build of mark, and when the health endpoint answers with this peer id.
+    await writeLockfile({
+        pid: process.pid,
+        port,
+        transport: options.transport ?? "http",
+        endpoint: result.endpoints[0]?.address ?? `http://127.0.0.1:${port}/api`,
+        startedAt: new Date().toISOString(),
+        token,
+        cwd: process.cwd(),
+        build: currentBuild(),
+        peerId: result.serverId,
+    });
+    print.success("\nCLI Server running!");
+    print.info(`  PID: ${process.pid}`);
+    print.info(`  Server ID: ${result.serverId}`);
+    print.info(`  Procedures: ${result.procedureCount}`);
+    print.info(`  Lockfile: ${getLockfilePath()}`);
+    print.info("\nEndpoints:");
+    for (const endpoint of result.endpoints) {
+        print.info(`  [${endpoint.type}] ${endpoint.address}`);
+    }
+    print.info("\nPress Ctrl+C to stop.");
+    // Handle shutdown
+    const cleanup = async () => {
+        print.info("\nStopping server...");
+        removeLockfileForPort(port);
+        process.exit(0);
+    };
+    process.on("SIGINT", cleanup);
+    process.on("SIGTERM", cleanup);
+    // Keep the process alive
+    await new Promise(() => {
+        // Never resolves - keeps process running
+    });
+}
+/**
+ * The port number of a `--port` value. An invalid port is an error (before, it became 3000:
+ * deep dive CLI-16).
+ */
+export function parsePort(value) {
+    const port = /^\d+$/.test(value) ? Number(value) : NaN;
+    if (!Number.isInteger(port) || port < 1 || port > 65535) {
+        throw new Error(`Invalid port: "${value}". Give a number from 1 to 65535.`);
+    }
+    return port;
+}
+/** The transports `--transport` accepts */
+export const SERVER_TRANSPORTS = ["http", "websocket", "both"];
+/**
+ * The transport of a `--transport` value
+ */
+export function parseTransport(value) {
+    const transport = SERVER_TRANSPORTS.find((name) => name === value);
+    if (!transport) {
+        throw new Error(`Invalid transport: "${value}". Give one of: ${SERVER_TRANSPORTS.join(", ")}.`);
+    }
+    return transport;
+}
+/**
+ * Extract port from argv
+ */
+export function extractPort(argv) {
+    // --port 4000 and --port=4000 (before, the second form was ignored: deep dive CLI-1)
+    const inline = argv.find((arg) => arg.startsWith("--port="));
+    const portIdx = argv.indexOf("--port");
+    if (inline === undefined && portIdx === -1)
+        return null;
+    const portValue = inline !== undefined ? inline.slice("--port=".length) : argv[portIdx + 1];
+    if (portValue === undefined) {
+        throw new Error("--port needs a value");
+    }
+    return parsePort(portValue);
+}
+/**
+ * Extract host from argv
+ */
+export function extractHost(argv) {
+    const inline = argv.find((arg) => arg.startsWith("--host="));
+    if (inline !== undefined)
+        return inline.slice("--host=".length);
+    const hostIdx = argv.indexOf("--host");
+    if (hostIdx !== -1) {
+        const hostValue = argv[hostIdx + 1];
+        if (hostValue !== undefined) {
+            return hostValue;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=server-mode.js.map

package/dist/server-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-mode.js","sourceRoot":"","sources":["../src/server-mode.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,100 @@
 {
+  "$schema": "https://json.schemastore.org/package",
   "name": "@procedures/mark",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "mark: one CLI for every procedure package. It finds the procedures, parses flags by their Zod types, runs local or through a fast warm server, and asks for missing arguments.",
+  "keywords": [
+    "cli",
+    "command-line",
+    "procedures",
+    "developer-tools",
+    "automation",
+    "zod"
+  ],
+  "homepage": "https://mark1russell7.github.io/client/",
+  "bugs": {
+    "url": "https://github.com/mark1russell7/client/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mark1russell7/client.git",
+    "directory": "packages/mark"
+  },
+  "license": "MIT",
+  "author": "Mark Russell (https://github.com/mark1russell7)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "mark": "./dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/__tests__",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.7.0",
+    "@procedures/client": "0.2.0",
+    "@procedures/cli-run": "0.2.0",
+    "@procedures/lib": "0.2.0",
+    "@procedures/pnpm": "0.2.0",
+    "@procedures/procedure": "0.2.0",
+    "@procedures/peer": "0.2.0",
+    "@procedures/shell": "0.2.0",
+    "@procedures/vitest": "0.2.0",
+    "chalk": "^5.3.0",
+    "cli-table3": "^0.6.5",
+    "ora": "^8.0.0",
+    "tslib": "^2.8.1",
+    "zod": "^4.6.5",
+    "@procedures/server": "0.2.0",
+    "@procedures/mcp-dev-tools": "0.2.0"
+  },
+  "devDependencies": {
+    "@procedures/bundle-dev": "0.2.0",
+    "@procedures/bundle-mcp": "0.2.0",
+    "@procedures/cue": "0.2.0",
+    "@procedures/docker": "0.2.0",
+    "@procedures/fs": "0.2.0",
+    "@procedures/git": "0.2.0",
+    "@procedures/mongo": "0.2.0",
+    "@procedures/node": "0.2.0",
+    "@procedures/s3": "0.2.0",
+    "@procedures/snapshot": "0.2.0",
+    "@procedures/splay": "0.2.0",
+    "@procedures/sqlite": "0.2.0",
+    "@procedures/store": "0.2.0",
+    "@procedures/vite": "0.2.0",
+    "@mark1russell7/cue": "^1.0.0",
+    "@types/node": "^22.0.0",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.3"
+  },
+  "scripts": {
+    "build": "tsc -b && node dist/manifest-build.js",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .tsbuildinfo",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:e2e": "vitest run --config vitest.e2e.config.ts",
+    "test:e2e:watch": "vitest --config vitest.e2e.config.ts"
+  }
 }