@shipd-ai/cli 0.1.0 → 0.1.1

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 the quest's login page (olympus by default); 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

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/package.json

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