@rolino/cli 0.6.0 → 0.7.0

package/dist/index.cjs

@@ -50,7 +50,7 @@ var import_commander = require("commander");
 // package.json
 var package_default = {
   name: "@rolino/cli",
-  version: "0.6.0",
+  version: "0.7.0",
   description: "Agent-friendly command-line interface for Rolino",
   type: "module",
   license: "MIT",
@@ -107,9 +107,9 @@ var package_default = {
     dev: "tsx src/bin.ts"
   },
   dependencies: {
-    "@rolino/contracts": "0.6.0",
-    "@rolino/local-auth": "0.6.0",
-    "@rolino/sdk": "0.6.0",
+    "@rolino/contracts": "0.7.0",
+    "@rolino/local-auth": "0.7.0",
+    "@rolino/sdk": "0.7.0",
     commander: "^15.0.0",
     open: "^11.0.0"
   },
@@ -665,12 +665,18 @@ function removeExistingCodexEntry(source, newline) {
   return kept.join(newline).trimEnd();
 }
 function codexBlock(server, newline) {
+  const configuration = server.transport === "http" ? [
+    `url = ${tomlString(server.url)}`,
+    `auth = ${tomlString(server.auth)}`
+  ] : [
+    `command = ${tomlString(server.command)}`,
+    `args = [${server.args.map(tomlString).join(", ")}]`,
+    `env = { ROLINO_URL = ${tomlString(server.env.ROLINO_URL)} }`
+  ];
   return [
     CODEX_BEGIN,
     "[mcp_servers.rolino]",
-    `command = ${tomlString(server.command)}`,
-    `args = [${server.args.map(tomlString).join(", ")}]`,
-    `env = { ROLINO_URL = ${tomlString(server.env.ROLINO_URL)} }`,
+    ...configuration,
     CODEX_END
   ].join(newline);
 }
@@ -710,7 +716,12 @@ function updateClaudeProjectConfig(source, server) {
     ...parsed,
     mcpServers: {
       ...currentServers,
-      rolino: { type: "stdio", ...server }
+      rolino: server.transport === "http" ? { type: "http", url: server.url } : {
+        type: "stdio",
+        command: server.command,
+        args: server.args,
+        env: server.env
+      }
     }
   }, null, 2)}
 `;
@@ -742,6 +753,7 @@ async function setupCodex(options, server) {
     backupPath,
     changed,
     dryRun: options.dryRun ?? false,
+    transport: server.transport,
     server
   };
 }
@@ -762,6 +774,7 @@ async function setupClaudeCode(options, server) {
       backupPath,
       changed,
       dryRun: options.dryRun ?? false,
+      transport: server.transport,
       server
     };
   }
@@ -774,6 +787,7 @@ async function setupClaudeCode(options, server) {
       backupPath: null,
       changed: true,
       dryRun: true,
+      transport: server.transport,
       server
     };
   }
@@ -787,7 +801,12 @@ async function setupClaudeCode(options, server) {
     "mcp",
     "add-json",
     "rolino",
-    JSON.stringify({ type: "stdio", ...server }),
+    JSON.stringify(server.transport === "http" ? { type: "http", url: server.url } : {
+      type: "stdio",
+      command: server.command,
+      args: server.args,
+      env: server.env
+    }),
     "--scope",
     "user"
   ], options);
@@ -803,14 +822,51 @@ async function setupClaudeCode(options, server) {
     backupPath: null,
     changed: true,
     dryRun: false,
+    transport: server.transport,
     server
   };
 }
+function remoteMcpUrl(baseUrl) {
+  return new URL("mcp", `${baseUrl.replace(/\/$/, "")}/`).toString();
+}
+async function advertisedRemoteMcp(options) {
+  const fetchImplementation = options.fetch ?? globalThis.fetch;
+  try {
+    const response = await fetchImplementation(
+      new URL("api/v1/meta", `${options.baseUrl.replace(/\/$/, "")}/`),
+      {
+        headers: { accept: "application/json" },
+        signal: AbortSignal.timeout(5e3)
+      }
+    );
+    if (!response.ok) return false;
+    const payload = await response.json();
+    return payload.data?.mcp?.streamableHttp === true;
+  } catch {
+    return false;
+  }
+}
+async function resolveTransport(options) {
+  const requested = options.transport ?? "stdio";
+  if (requested === "stdio") return "stdio";
+  if (await advertisedRemoteMcp(options)) return "http";
+  if (requested === "http") {
+    throw new TypeError(
+      "This Rolino instance does not advertise Streamable HTTP MCP. Use --transport stdio, or enable and verify remote MCP on the server."
+    );
+  }
+  return "stdio";
+}
 async function setupMcp(options) {
-  const serverPath = await resolveServerPath(options);
-  const server = {
+  const transport = await resolveTransport(options);
+  const server = transport === "http" ? {
+    transport: "http",
+    url: remoteMcpUrl(options.baseUrl),
+    auth: "oauth"
+  } : {
+    transport: "stdio",
     command: options.nodePath,
-    args: [serverPath],
+    args: [await resolveServerPath(options)],
     env: { ROLINO_URL: options.baseUrl }
   };
   return options.client === "codex" ? setupCodex(options, server) : setupClaudeCode(options, server);
@@ -951,6 +1007,10 @@ function mcpScope(value) {
   if (value === "user" || value === "project") return value;
   throw new import_commander.InvalidArgumentError("MCP setup scope must be user or project.");
 }
+function mcpTransport(value) {
+  if (value === "auto" || value === "http" || value === "stdio") return value;
+  throw new import_commander.InvalidArgumentError("MCP transport must be auto, http, or stdio.");
+}
 function isoDateTime(value) {
   const date = new Date(value);
   if (Number.isNaN(date.getTime())) {
@@ -1011,13 +1071,21 @@ function requireBlogExecutionConsent(options) {
   throw new TypeError("This Blog execute command requires explicit consent. Review the confirmed operation and pass --yes.");
 }
 function formatMcpSetupPreview(result) {
+  const connection = result.server.transport === "http" ? [
+    `Transport: Streamable HTTP`,
+    `Endpoint: ${result.server.url}`,
+    "Authentication: OAuth in the MCP client"
+  ] : [
+    "Transport: local STDIO",
+    `Command: ${result.server.command}`,
+    `Arguments: ${result.server.args.join(" ")}`,
+    `Rolino URL: ${result.server.env.ROLINO_URL}`
+  ];
   return [
     `Client: ${result.client === "codex" ? "Codex" : "Claude Code"}`,
     `Scope: ${result.scope}`,
     `Target: ${result.target}`,
-    `Command: ${result.server.command}`,
-    `Arguments: ${result.server.args.join(" ")}`,
-    `Rolino URL: ${result.server.env.ROLINO_URL}`,
+    ...connection,
     "No token will be written to MCP configuration."
   ].join("\n");
 }
@@ -1480,7 +1548,7 @@ async function runCli(argv = process.argv, overrides = {}) {
     });
   });
   const setup = program.command("setup").description("Configure local agent tools for Rolino");
-  setup.command("mcp").description("Configure the Rolino stdio MCP server for a supported client").requiredOption("--client <client>", "codex or claude-code", mcpClient).option("--scope <scope>", "user or project", mcpScope, "user").option("--server-path <path>", "absolute or working-directory-relative MCP server path").option("--dry-run", "show the intended configuration without writing it").option("--yes", "apply without an interactive confirmation").option("--force", "replace an existing Claude Code user-scoped Rolino server").action(async (local) => {
+  setup.command("mcp").description("Configure Rolino MCP with Streamable HTTP or local STDIO").requiredOption("--client <client>", "codex or claude-code", mcpClient).option("--scope <scope>", "user or project", mcpScope, "user").option("--transport <transport>", "auto, http, or stdio", mcpTransport, "auto").option("--server-path <path>", "absolute or working-directory-relative MCP server path").option("--dry-run", "show the intended configuration without writing it").option("--yes", "apply without an interactive confirmation").option("--force", "replace an existing Claude Code user-scoped Rolino server").action(async (local) => {
     const global = program.opts();
     commandExitCode = await execute({
       command: "setup mcp",
@@ -1493,7 +1561,8 @@ async function runCli(argv = process.argv, overrides = {}) {
           cwd: runtime.cwd,
           env: runtime.env,
           nodePath: runtime.nodePath,
-          cliEntryPath: runtime.cliEntryPath
+          cliEntryPath: runtime.cliEntryPath,
+          fetch: runtime.fetch
         };
         const preview = await setupMcp({ ...setupOptions, dryRun: true });
         let result = preview;
@@ -1520,11 +1589,12 @@ async function runCli(argv = process.argv, overrides = {}) {
             `${state} Rolino MCP for ${clientLabel}.`,
             `Scope: ${result.scope}`,
             `Target: ${result.target}`,
+            `Transport: ${result.transport === "http" ? "Streamable HTTP" : "local STDIO"}`,
             ...result.backupPath && !result.dryRun ? [`Backup: ${result.backupPath}`] : [],
             `Rolino URL: ${client.baseUrl}`,
             "No token was written to MCP configuration."
           ].join("\n"),
-          result.client === "codex" ? ["codex mcp list", "rolino auth login"] : ["claude mcp get rolino", "rolino auth login"]
+          result.client === "codex" ? result.transport === "http" ? ["codex mcp login rolino", "codex mcp list"] : ["rolino auth login", "codex mcp list"] : result.transport === "http" ? ["claude mcp get rolino", "Complete OAuth when Claude prompts you"] : ["rolino auth login", "claude mcp get rolino"]
         );
       }
     });
@@ -2263,6 +2333,106 @@ Revision: ${local.revision}` });
       writeSuccess(context, data, JSON.stringify(data, null, 2));
     } });
   });
+  const backlinks = program.command("backlinks").description("Review backlink prospects and public contact drafts. Rolino never sends email.");
+  const backlinkTargets = backlinks.command("targets");
+  backlinkTargets.command("list").requiredOption("--project <project-id>").action(async (local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "backlinks targets list", global, runtime, async action(context, client) {
+      const data = await client.backlinks.targets.list(local.project, { requestId: context.requestId });
+      writeSuccess(context, data, JSON.stringify(data, null, 2));
+    } });
+  });
+  backlinkTargets.command("add").requiredOption("--project <project-id>").requiredOption("--url <url>").requiredOption("--label <label>").action(async (local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "backlinks targets add", global, runtime, async action(context, client) {
+      const data = await client.backlinks.targets.add(local.project, { url: local.url, label: local.label }, context.requestId, { requestId: context.requestId });
+      writeSuccess(context, data, JSON.stringify(data, null, 2));
+    } });
+  });
+  backlinks.command("discover").requiredOption("--project <project-id>").option("--limit <number>", "maximum saved prospects", Number, 20).option("--idempotency-key <key>").action(async (local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "backlinks discover", global, runtime, async action(context, client) {
+      const data = await client.backlinks.discoveries.start(local.project, { limit: local.limit }, local.idempotencyKey ?? context.requestId, { requestId: context.requestId });
+      writeSuccess(context, data, JSON.stringify(data, null, 2));
+    } });
+  });
+  const backlinkRuns = backlinks.command("runs");
+  backlinkRuns.command("get").requiredOption("--project <project-id>").requiredOption("--run <run-id>").action(async (local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "backlinks runs get", global, runtime, async action(context, client) {
+      const data = await client.backlinks.discoveries.get(local.project, local.run, { requestId: context.requestId });
+      writeSuccess(context, data, JSON.stringify(data, null, 2));
+    } });
+  });
+  const backlinkProspects = backlinks.command("prospects");
+  backlinkProspects.command("list").requiredOption("--project <project-id>").option("--stage <stage>").action(async (local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "backlinks prospects list", global, runtime, async action(context, client) {
+      const stage = local.stage ? import_contracts.BacklinkProspectStageSchema.parse(local.stage.toUpperCase()) : void 0;
+      const data = await client.backlinks.prospects.list(local.project, { stage }, { requestId: context.requestId });
+      writeSuccess(context, data, JSON.stringify(data, null, 2));
+    } });
+  });
+  backlinkProspects.command("get").requiredOption("--project <project-id>").requiredOption("--prospect <prospect-id>").action(async (local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "backlinks prospects get", global, runtime, async action(context, client) {
+      const data = await client.backlinks.prospects.get(local.project, local.prospect, { requestId: context.requestId });
+      writeSuccess(context, data, JSON.stringify(data, null, 2));
+    } });
+  });
+  backlinkProspects.command("approve").requiredOption("--project <project-id>").requiredOption("--prospect <prospect-id>").requiredOption("--expected-version <number>", "current optimistic version", Number).action(async (local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "backlinks prospects approve", global, runtime, async action(context, client) {
+      const data = await client.backlinks.prospects.updateStage(local.project, local.prospect, { stage: "APPROVED", expectedVersion: local.expectedVersion }, context.requestId, { requestId: context.requestId });
+      writeSuccess(context, data, JSON.stringify(data, null, 2));
+    } });
+  });
+  const backlinkContacts = backlinks.command("contacts");
+  backlinkContacts.command("research").requiredOption("--project <project-id>").requiredOption("--prospect <prospect-id>").action(async (local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "backlinks contacts research", global, runtime, async action(context, client) {
+      const data = await client.backlinks.prospects.researchContact(local.project, local.prospect, context.requestId, { requestId: context.requestId });
+      writeSuccess(context, data, JSON.stringify(data, null, 2));
+    } });
+  });
+  backlinkContacts.command("list").requiredOption("--project <project-id>").action(async (local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "backlinks contacts list", global, runtime, async action(context, client) {
+      const data = await client.backlinks.contacts.list(local.project, { limit: 50 }, { requestId: context.requestId });
+      writeSuccess(context, data, JSON.stringify(data, null, 2));
+    } });
+  });
+  backlinkContacts.command("export").requiredOption("--project <project-id>").option("--format <format>", "json or csv", "csv").action(async (local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "backlinks contacts export", global, runtime, async action(context, client) {
+      const data = await client.backlinks.contacts.list(local.project, { limit: 50 }, { requestId: context.requestId });
+      if (local.format !== "csv") return writeSuccess(context, data, JSON.stringify(data, null, 2));
+      const cell = (value) => {
+        let text = String(value ?? "").replace(/[\r\n]+/g, " ");
+        if (/^[=+\-@\t]/.test(text)) text = `'${text}`;
+        return `"${text.replaceAll('"', '""')}"`;
+      };
+      const csv = ["prospectId,name,role,email,sourceUrl,checkedAt", ...data.items.map((item) => [item.prospectId, item.name, item.role, item.email, item.sourceUrl, item.checkedAt].map(cell).join(","))].join("\n");
+      context.stdout.write(`${csv}
+`);
+    } });
+  });
+  const backlinkOutreach = backlinks.command("outreach");
+  backlinkOutreach.command("update").requiredOption("--project <project-id>").requiredOption("--prospect <prospect-id>").requiredOption("--file <file>").requiredOption("--expected-version <number>", "current draft version", Number).action(async (local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "backlinks outreach update", global, runtime, async action(context, client) {
+      const payload = JSON.parse(await (0, import_promises2.readFile)((0, import_node_path2.resolve)(runtime.cwd, local.file), "utf8"));
+      const data = await client.backlinks.prospects.updateOutreach(local.project, local.prospect, { ...payload, expectedVersion: local.expectedVersion }, context.requestId, { requestId: context.requestId });
+      writeSuccess(context, data, JSON.stringify(data, null, 2));
+    } });
+  });
+  backlinks.command("verify").requiredOption("--project <project-id>").requiredOption("--prospect <prospect-id>").requiredOption("--url <url>").requiredOption("--expected-version <number>", "current prospect version", Number).action(async (local) => {
+    const global = program.opts();
+    commandExitCode = await execute({ command: "backlinks verify", global, runtime, async action(context, client) {
+      const data = await client.backlinks.prospects.verify(local.project, local.prospect, { url: local.url, expectedVersion: local.expectedVersion }, context.requestId, { requestId: context.requestId });
+      writeSuccess(context, data, JSON.stringify(data, null, 2));
+    } });
+  });
   const seo = program.command("seo").description("Read authorized SEO opportunities and weekly reports");
   const seoOpportunities = seo.command("opportunities").description("Read accepted SEO opportunities");
   seoOpportunities.command("list").description("List bounded SEO opportunities").requiredOption("--project <project-id>", "exact Rolino project ID").option("--limit <number>", "maximum opportunities to return", (value) => {