@shipd-ai/cli 0.1.0

package/dist/report.js

@@ -0,0 +1,107 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { EXIT_CANCELLED, EXIT_CHECK_FAILED, EXIT_OK } from "./errors.js";
+import { formatDuration, formatTable, statusBadge, truncate } from "./format.js";
+export function modeLabel(mode) {
+    return mode === "harbor" ? "stateless, nothing written" : "live: writes to production";
+}
+/** The precheck stage status, as the product spells it, mapped to a verdict. */
+export function precheckVerdict(status) {
+    const lower = status.toLowerCase();
+    if (lower === "missing_fields")
+        return "skipped";
+    return lower;
+}
+/** A one-line human detail for a check row. */
+export function checkDetail(check) {
+    if (check.error)
+        return check.error;
+    if (check.reason)
+        return check.reason;
+    const output = check.output;
+    if (output && typeof output === "object") {
+        const o = output;
+        if (check.kind === "precheck" && Array.isArray(o.checks)) {
+            const checks = o.checks;
+            const passed = checks.filter((c) => String(c.status).toLowerCase() === "pass").length;
+            return `${passed}/${checks.length} checks pass`;
+        }
+        for (const key of ["summary", "message", "reasoning"]) {
+            if (typeof o[key] === "string" && o[key].trim())
+                return o[key];
+        }
+        const evaluation = o.evaluation;
+        if (evaluation && typeof evaluation === "object") {
+            const summary = evaluation.summary;
+            if (typeof summary === "string")
+                return summary;
+        }
+    }
+    return "";
+}
+export function renderTable(report, opts = {}) {
+    const color = opts.color ?? false;
+    const checks = Object.values(report.checks);
+    const rows = checks.map((check) => ({
+        check: check.key,
+        kind: check.kind,
+        status: statusBadge(check.status, color),
+        verdict: check.verdict ? statusBadge(String(check.verdict), color) : "",
+        time: formatDuration(check.durationMs),
+        detail: truncate(checkDetail(check), 70),
+    }));
+    const lines = [
+        `  Quest: ${report.quest} (${modeLabel(report.mode)})`,
+        ...sourceLines(report.source),
+        "",
+        ...formatTable(rows, [
+            { key: "check", label: "Check" },
+            { key: "kind", label: "Kind" },
+            { key: "status", label: "Status" },
+            { key: "verdict", label: "Verdict" },
+            { key: "time", label: "Time" },
+            { key: "detail", label: "Detail" },
+        ]),
+    ];
+    return lines.join("\n");
+}
+function sourceLines(source) {
+    const lines = [];
+    if (source.dir)
+        lines.push(`  Bundle: ${source.dir}`);
+    if (source.inputHash)
+        lines.push(`  Input:  ${source.inputHash}`);
+    if (source.problemId) {
+        const title = source.title ? ` "${source.title}"` : "";
+        lines.push(`  Task:   ${source.problemId}${title} (version ${source.versionId})`);
+    }
+    if (source.url)
+        lines.push(`  URL:    ${source.url}`);
+    return lines;
+}
+const BAD_VERDICTS = new Set(["fail", "error"]);
+/**
+ * 0 when every run check passed or warned; 1 when any failed or errored (or
+ * an explicitly requested check was skipped); 3 when any check was cancelled.
+ */
+export function exitCodeFor(report) {
+    const checks = Object.values(report.checks);
+    if (checks.some((c) => c.status === "cancelled"))
+        return EXIT_CANCELLED;
+    for (const check of checks) {
+        if (check.status === "failed" || check.status === "error")
+            return EXIT_CHECK_FAILED;
+        if (check.status === "skipped" && report.selection === "explicit")
+            return EXIT_CHECK_FAILED;
+        if (check.status === "completed" && check.verdict && BAD_VERDICTS.has(String(check.verdict))) {
+            return EXIT_CHECK_FAILED;
+        }
+    }
+    return EXIT_OK;
+}
+export async function writeReport(report, path) {
+    const target = resolve(path);
+    await mkdir(dirname(target), { recursive: true });
+    await writeFile(target, `${JSON.stringify(report, null, 2)}\n`);
+    return target;
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@shipd-ai/cli",
+  "version": "0.1.0",
+  "description": "Shipd admin CLI — run quest checks on Harbor tasks or existing tasks",
+  "type": "module",
+  "homepage": "https://shipd.ai",
+  "keywords": [
+    "shipd",
+    "harbor",
+    "cli",
+    "convex"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "shipd": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc && chmod +x dist/index.js",
+    "cli": "tsx src/index.ts",
+    "prepack": "pnpm build",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "citty": "^0.2.1",
+    "convex": "1.39.1",
+    "smol-toml": "^1.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.21.0",
+    "typescript": "~5.7.0",
+    "vitest": "^3.0.5"
+  }
+}