@shipd-ai/cli 0.1.0 → 0.1.2

package/README.md

@@ -3,8 +3,10 @@
 `shipd` is the admin command line for Shipd quests. Point it at a Harbor task
 directory (or an existing task) and it runs the quest's checks on the quest's
 own infrastructure, then returns the same structured output the product shows.
-Olympus is the first quest; every quest that implements the small
-`adhocChecks:*` contract works the same way.
+The CLI is quest-agnostic: every command takes `--quest <quest>`, and any
+quest that implements the small `adhocChecks:*` contract works the same way.
+`shipd quests` lists the quests available (olympus today, which is also the
+default when `--quest` is omitted).
 
 Admins only: every quest entrypoint checks the caller's effective admin role.
 
@@ -14,8 +16,9 @@ Admin docs, the supported checks, and a copy-paste setup prompt for coding agent
 
 ```bash
 npm install -g @shipd-ai/cli
-shipd login            # opens https://shipd.ai/quests/olympus/cli-auth
+shipd login            # opens https://shipd.ai/cli-auth (one token for every quest); or: shipd login --token <jwt>
 shipd whoami
+shipd quests           # which quests this CLI can talk to
 ```
 
 `login` opens the token page in your browser; paste the token back into the
@@ -107,6 +110,7 @@ check with `status`, `verdict`, `output`, `error`, `durationMs`, and `steps`
 
 | Variable | Effect |
 | --- | --- |
+| `SHIPD_AUTH_URL` | Override the platform login page `shipd login` opens (default `https://shipd.ai/cli-auth`). |
 | `SHIPD_<QUEST>_URL` | Override the quest's base URL (for example `SHIPD_OLYMPUS_URL`). |
 | `SHIPD_<QUEST>_CONVEX_URL` | Skip `/api/cli/config` and talk to this Convex deployment. |
 | `SHIPD_HOME` | Credentials and caches directory (default `~/.shipd`). |

package/dist/commands/auth.d.ts

@@ -9,8 +9,7 @@ export declare const login: import("citty").CommandDef<{
     };
     readonly quest: {
         readonly type: "string";
-        readonly description: "Quest whose login page to open (default: olympus)";
-        readonly default: "olympus";
+        readonly description: "Open this quest's own login page instead of the platform page (the token works for every quest either way)";
     };
 }>;
 export declare const logout: import("citty").CommandDef<import("citty").ArgsDef>;

package/dist/commands/auth.js

@@ -4,7 +4,7 @@ import { defineCommand } from "citty";
 import { clearCredentials, loadCredentials, saveCredentials } from "../auth.js";
 import { UsageError } from "../errors.js";
 import { printJson } from "../format.js";
-import { DEFAULT_QUEST, questAuthUrl } from "../quests.js";
+import { platformAuthUrl, questAuthUrl } from "../quests.js";
 function openBrowser(url) {
     if (process.platform === "win32") {
         // `start` is a cmd.exe built-in, not a standalone executable.
@@ -27,8 +27,7 @@ function prompt(question) {
 const questArg = {
     quest: {
         type: "string",
-        description: `Quest whose login page to open (default: ${DEFAULT_QUEST})`,
-        default: DEFAULT_QUEST,
+        description: "Open this quest's own login page instead of the platform page (the token works for every quest either way)",
     },
 };
 export const login = defineCommand({
@@ -39,7 +38,7 @@ export const login = defineCommand({
         "no-browser": { type: "boolean", description: "Print the login URL instead of opening it" },
     },
     run: async ({ args }) => {
-        const authUrl = questAuthUrl(args.quest);
+        const authUrl = args.quest ? questAuthUrl(args.quest) : platformAuthUrl();
         let token = args.token?.trim();
         if (!token) {
             if (args["no-browser"]) {

package/dist/commands/quests.d.ts

@@ -0,0 +1,13 @@
+export type QuestRow = {
+    quest: string;
+    baseUrl: string;
+    default: boolean;
+};
+/** The quests this CLI knows how to talk to, with their resolved base URLs. */
+export declare function listQuests(): QuestRow[];
+export declare const quests: import("citty").CommandDef<{
+    readonly json: {
+        readonly type: "boolean";
+        readonly description: "Output as JSON";
+    };
+}>;

package/dist/commands/quests.js

@@ -0,0 +1,37 @@
+import { defineCommand } from "citty";
+import { printJson, printTable } from "../format.js";
+import { DEFAULT_QUEST, knownQuests, questBaseUrl } from "../quests.js";
+/** The quests this CLI knows how to talk to, with their resolved base URLs. */
+export function listQuests() {
+    return knownQuests().map((quest) => ({
+        quest,
+        baseUrl: questBaseUrl(quest),
+        default: quest === DEFAULT_QUEST,
+    }));
+}
+export const quests = defineCommand({
+    meta: {
+        name: "quests",
+        description: "List the quests this CLI can run checks for (and which one --quest defaults to)",
+    },
+    args: {
+        json: { type: "boolean", description: "Output as JSON" },
+    },
+    run: async ({ args }) => {
+        const rows = listQuests();
+        if (args.json) {
+            printJson(rows);
+            return;
+        }
+        printTable(rows.map((row) => ({
+            quest: row.quest,
+            baseUrl: row.baseUrl,
+            default: row.default ? "yes" : "",
+        })), [
+            { key: "quest", label: "Quest" },
+            { key: "baseUrl", label: "Base URL" },
+            { key: "default", label: "Default" },
+        ]);
+        console.log("\n  Every command takes --quest <quest>; the default is used when omitted.\n");
+    },
+});

package/dist/index.js

@@ -3,6 +3,7 @@ import { execFileSync } from "node:child_process";
 import { defineCommand, runCommand, showUsage } from "citty";
 import { login, logout, whoami } from "./commands/auth.js";
 import checks from "./commands/checks.js";
+import { quests } from "./commands/quests.js";
 import { EXIT_USAGE, errorMessage, exitCodeForError } from "./errors.js";
 import { checkVersion, PACKAGE_NAME, VERSION } from "./quests.js";
 const update = defineCommand({
@@ -35,7 +36,7 @@ const main = defineCommand({
         version: VERSION,
         description: "Shipd admin CLI: run quest checks on Harbor tasks or existing tasks",
     },
-    subCommands: { login, logout, whoami, checks, update, version },
+    subCommands: { login, logout, whoami, quests, checks, update, version },
 });
 async function run() {
     const rawArgs = process.argv.slice(2);

package/dist/quests.d.ts

@@ -4,7 +4,9 @@ export declare const DEFAULT_QUEST = "olympus";
 export declare function knownQuests(): string[];
 /** `SHIPD_<QUEST>_URL` override, or NODE_ENV=development → localhost. */
 export declare function questBaseUrl(quest: string): string;
-/** The page that mints the CLI token for the browser login flow. */
+/** `SHIPD_AUTH_URL` override, or NODE_ENV=development → localhost. */
+export declare function platformAuthUrl(): string;
+/** A quest's own copy of the token page (the platform page is the default). */
 export declare function questAuthUrl(quest: string): string;
 export interface QuestConfig {
     convexUrl: string;

package/dist/quests.js

@@ -32,7 +32,21 @@ export function questBaseUrl(quest) {
     }
     return process.env.NODE_ENV === "development" ? entry.dev : entry.prod;
 }
-/** The page that mints the CLI token for the browser login flow. */
+// The platform-level token page. The shipd-cli token works for every quest,
+// so the browser login lands here; `questAuthUrl` stays for a quest's own
+// copy of the page (`shipd login --quest <quest>`).
+const PLATFORM_AUTH_URL = {
+    prod: "https://shipd.ai/cli-auth",
+    dev: "http://localhost:3010/cli-auth",
+};
+/** `SHIPD_AUTH_URL` override, or NODE_ENV=development → localhost. */
+export function platformAuthUrl() {
+    const override = process.env.SHIPD_AUTH_URL;
+    if (override)
+        return override;
+    return process.env.NODE_ENV === "development" ? PLATFORM_AUTH_URL.dev : PLATFORM_AUTH_URL.prod;
+}
+/** A quest's own copy of the token page (the platform page is the default). */
 export function questAuthUrl(quest) {
     return `${questBaseUrl(quest)}/cli-auth`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shipd-ai/cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Shipd admin CLI — run quest checks on Harbor tasks or existing tasks",
   "type": "module",
   "homepage": "https://shipd.ai",