artifact-cafe 0.0.4 → 0.0.5

package/dist/index.js

@@ -1,10 +1,37 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { defineCommand, runMain } from "citty";
+import { defineCommand, runMain, showUsage } from "citty";
+
+// src/banner.ts
+var AMBER = "\x1B[38;2;214;138;57m";
+var BOLD = "\x1B[1m";
+var RESET = "\x1B[0m";
+var MUG = [
+  "        \u2596",
+  "      \u2598   \u259D",
+  "   \u256D\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256E",
+  "   \u2502        \u251C\u2500\u256E",
+  "   \u2502        \u2502 \u2502",
+  "   \u2502        \u251C\u2500\u256F",
+  "   \u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256F",
+  "    \u203E\u203E\u203E\u203E\u203E\u203E\u203E\u203E"
+];
+var WORDMARK = "   artifact.cafe";
+function printBanner() {
+  const color = Boolean(process.stdout.isTTY) && !process.env.NO_COLOR;
+  const paint = (line, codes) => color ? `${codes}${line}${RESET}` : line;
+  console.log();
+  for (const line of MUG) {
+    console.log(paint(line, AMBER));
+  }
+  console.log();
+  console.log(paint(WORDMARK, AMBER + BOLD));
+  console.log();
+}
 
 // src/comments.ts
-import path2 from "path";
+import path3 from "path";
 
 // ../shared/src/account.ts
 import { z } from "zod";
@@ -519,37 +546,99 @@ async function uploadFile(uploadUrl, content, mimeType) {
 // src/config.ts
 import {
   appendFileSync,
-  existsSync,
-  mkdirSync,
-  readFileSync,
-  writeFileSync
+  existsSync as existsSync2,
+  mkdirSync as mkdirSync2,
+  readFileSync as readFileSync2,
+  writeFileSync as writeFileSync2
 } from "fs";
+import path2 from "path";
+import { z as z13 } from "zod";
+
+// src/credentials.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
 import path from "path";
 import { z as z12 } from "zod";
-var configSchema = z12.object({
-  apiUrl: z12.string(),
-  artifactId: z12.string(),
-  publishToken: z12.string(),
-  slug: z12.string(),
-  url: z12.string()
+var DEFAULT_API_URL = "https://artifact.cafe";
+var credentialsSchema = z12.object({
+  keys: z12.record(z12.string(), z12.string()),
+  version: z12.literal(1)
+});
+function credentialsPath() {
+  return path.join(homedir(), ".artifactcafe", "credentials");
+}
+function apiOrigin(apiUrl2) {
+  return new URL(apiUrl2).origin;
+}
+function readCredentials() {
+  const file = credentialsPath();
+  if (!existsSync(file)) {
+    return { keys: {}, version: 1 };
+  }
+  try {
+    return credentialsSchema.parse(JSON.parse(readFileSync(file, "utf8")));
+  } catch {
+    return { keys: {}, version: 1 };
+  }
+}
+function writeCredentials(credentials) {
+  const file = credentialsPath();
+  mkdirSync(path.dirname(file), { mode: 448, recursive: true });
+  writeFileSync(file, `${JSON.stringify(credentials, null, 2)}
+`, {
+    mode: 384
+  });
+}
+function storedApiKey(apiUrl2) {
+  return readCredentials().keys[apiOrigin(apiUrl2)] ?? null;
+}
+function storeApiKey(apiUrl2, key) {
+  const credentials = readCredentials();
+  credentials.keys[apiOrigin(apiUrl2)] = key;
+  writeCredentials(credentials);
+}
+function removeApiKey(apiUrl2) {
+  const credentials = readCredentials();
+  const origin = apiOrigin(apiUrl2);
+  if (!(origin in credentials.keys)) {
+    return false;
+  }
+  delete credentials.keys[origin];
+  writeCredentials(credentials);
+  return true;
+}
+function resolveApiKey(apiUrl2, flag) {
+  return flag ?? process.env.ARTIFACT_CAFE_API_KEY ?? storedApiKey(apiUrl2) ?? void 0;
+}
+
+// src/config.ts
+var configSchema = z13.object({
+  apiUrl: z13.string(),
+  artifactId: z13.string(),
+  // Optional: a folder linked by `link` to an artifact you own carries no
+  // token — owner actions authorize via your stored login instead. A first
+  // publish still writes the anonymous-mode token here.
+  publishToken: z13.string().optional(),
+  slug: z13.string(),
+  url: z13.string()
 });
 var CONFIG_DIR = ".artifactcafe";
 var CONFIG_FILE = "config.json";
 function readConfig(dir) {
-  const file = path.join(dir, CONFIG_DIR, CONFIG_FILE);
-  if (!existsSync(file)) {
+  const file = path2.join(dir, CONFIG_DIR, CONFIG_FILE);
+  if (!existsSync2(file)) {
     return null;
   }
   try {
-    return configSchema.parse(JSON.parse(readFileSync(file, "utf8")));
+    return configSchema.parse(JSON.parse(readFileSync2(file, "utf8")));
   } catch {
     return null;
   }
 }
 function writeConfig(dir, config) {
-  mkdirSync(path.join(dir, CONFIG_DIR), { recursive: true });
-  writeFileSync(
-    path.join(dir, CONFIG_DIR, CONFIG_FILE),
+  mkdirSync2(path2.join(dir, CONFIG_DIR), { recursive: true });
+  writeFileSync2(
+    path2.join(dir, CONFIG_DIR, CONFIG_FILE),
     `${JSON.stringify(config, null, 2)}
 `,
     { mode: 384 }
@@ -557,11 +646,11 @@ function writeConfig(dir, config) {
   ensureGitignored(dir);
 }
 function ensureGitignored(dir) {
-  const gitignore = path.join(dir, ".gitignore");
-  if (!existsSync(gitignore)) {
+  const gitignore = path2.join(dir, ".gitignore");
+  if (!existsSync2(gitignore)) {
     return;
   }
-  const lines = readFileSync(gitignore, "utf8").split(/\r?\n/);
+  const lines = readFileSync2(gitignore, "utf8").split(/\r?\n/);
   const present = lines.some((l) => {
     const t = l.trim();
     return t === CONFIG_DIR || t === `${CONFIG_DIR}/` || t === `/${CONFIG_DIR}` || t === `/${CONFIG_DIR}/`;
@@ -576,6 +665,23 @@ ${CONFIG_DIR}/
     );
   }
 }
+function reviewUrl(apiUrl2, slug) {
+  return `${apiUrl2.replace(/\/$/, "")}/a/${slug}`;
+}
+function resolveArtifactTarget(dir, opts = {}) {
+  const config = readConfig(dir);
+  const apiUrl2 = process.env.ARTIFACT_CAFE_URL ?? config?.apiUrl ?? DEFAULT_API_URL;
+  const artifactId = opts.artifact ?? process.env.ARTIFACT_CAFE_ARTIFACT_ID ?? config?.artifactId ?? null;
+  if (!artifactId) {
+    throw new Error(
+      `No artifact linked in ${dir}. Run \`artifact-cafe publish\` here, \`artifact-cafe link\` to bind one you own, or pass --artifact <id> (or set ARTIFACT_CAFE_ARTIFACT_ID) to act on an artifact linked elsewhere.`
+    );
+  }
+  const folderToken = artifactId === config?.artifactId ? config.publishToken : void 0;
+  const credential = folderToken ?? process.env.ARTIFACT_CAFE_TOKEN ?? resolveApiKey(apiUrl2, opts.apiKey);
+  const url = artifactId === config?.artifactId ? config.url : void 0;
+  return { apiUrl: apiUrl2, artifactId, credential, url };
+}
 
 // src/comments.ts
 var STATUSES = ["open", "resolved", "all"];
@@ -596,17 +702,16 @@ async function comments(opts) {
   }
   const status = opts.status;
   const version = opts.version;
-  const dir = path2.resolve(opts.dir);
-  const config = readConfig(dir);
-  if (!config) {
-    throw new Error(
-      `No artifact linked in ${dir} \u2014 run \`artifact-cafe publish\` there first (.artifactcafe/config.json not found).`
-    );
-  }
-  const apiUrl2 = process.env.ARTIFACT_CAFE_URL ?? config.apiUrl;
-  const client = createApiClient(apiUrl2, config.publishToken);
+  const dir = path3.resolve(opts.dir);
+  const target = resolveArtifactTarget(dir, {
+    apiKey: opts.apiKey,
+    artifact: opts.artifact
+  });
+  const client = createApiClient(target.apiUrl, target.credential);
+  const url = target.url ?? (opts.json ? "" : await deriveReviewUrl(client, target));
+  const ref = { artifactId: target.artifactId, url };
   if (opts.wait) {
-    await waitForFeedback(client, config, {
+    await waitForFeedback(client, ref, {
       json: opts.json,
       status,
       timeoutSeconds: opts.timeout,
@@ -614,7 +719,7 @@ async function comments(opts) {
     });
     return;
   }
-  const data = await client.exportComments(config.artifactId, {
+  const data = await client.exportComments(target.artifactId, {
     status,
     version
   });
@@ -622,7 +727,11 @@ async function comments(opts) {
     console.log(JSON.stringify(data, null, 2));
     return;
   }
-  printHuman(data, config.url, status, version);
+  printHuman(data, url, status, version);
+}
+async function deriveReviewUrl(client, target) {
+  const artifact = await client.getArtifact(target.artifactId);
+  return reviewUrl(target.apiUrl, artifact.slug);
 }
 var sleep = (s) => new Promise((r) => setTimeout(r, s * 1e3));
 function messageCounts(data) {
@@ -777,63 +886,6 @@ function indent(text, pad) {
 // src/dashboard.ts
 import path6 from "path";
 
-// src/credentials.ts
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
-import { homedir } from "os";
-import path3 from "path";
-import { z as z13 } from "zod";
-var DEFAULT_API_URL = "https://artifact.cafe";
-var credentialsSchema = z13.object({
-  keys: z13.record(z13.string(), z13.string()),
-  version: z13.literal(1)
-});
-function credentialsPath() {
-  return path3.join(homedir(), ".artifactcafe", "credentials");
-}
-function apiOrigin(apiUrl2) {
-  return new URL(apiUrl2).origin;
-}
-function readCredentials() {
-  const file = credentialsPath();
-  if (!existsSync2(file)) {
-    return { keys: {}, version: 1 };
-  }
-  try {
-    return credentialsSchema.parse(JSON.parse(readFileSync2(file, "utf8")));
-  } catch {
-    return { keys: {}, version: 1 };
-  }
-}
-function writeCredentials(credentials) {
-  const file = credentialsPath();
-  mkdirSync2(path3.dirname(file), { mode: 448, recursive: true });
-  writeFileSync2(file, `${JSON.stringify(credentials, null, 2)}
-`, {
-    mode: 384
-  });
-}
-function storedApiKey(apiUrl2) {
-  return readCredentials().keys[apiOrigin(apiUrl2)] ?? null;
-}
-function storeApiKey(apiUrl2, key) {
-  const credentials = readCredentials();
-  credentials.keys[apiOrigin(apiUrl2)] = key;
-  writeCredentials(credentials);
-}
-function removeApiKey(apiUrl2) {
-  const credentials = readCredentials();
-  const origin = apiOrigin(apiUrl2);
-  if (!(origin in credentials.keys)) {
-    return false;
-  }
-  delete credentials.keys[origin];
-  writeCredentials(credentials);
-  return true;
-}
-function resolveApiKey(apiUrl2, flag) {
-  return flag ?? process.env.ARTIFACT_CAFE_API_KEY ?? storedApiKey(apiUrl2) ?? void 0;
-}
-
 // src/publish.ts
 import { exec } from "child_process";
 import { readFileSync as readFileSync4 } from "fs";
@@ -1169,6 +1221,102 @@ function printCliError(err, json) {
   }
 }
 
+// src/link.ts
+import path7 from "path";
+import { createInterface } from "readline";
+async function link(opts) {
+  const apiUrl2 = (process.env.ARTIFACT_CAFE_URL ?? DEFAULT_API_URL).replace(
+    /\/$/,
+    ""
+  );
+  const key = resolveApiKey(apiUrl2, opts.apiKey);
+  if (!key) {
+    throw new Error(
+      `Linking needs an account \u2014 run \`artifact-cafe login\` first (no API key for ${apiOrigin(apiUrl2)}).`
+    );
+  }
+  const { artifacts } = await createApiClient(apiUrl2, key).listArtifacts();
+  if (artifacts.length === 0) {
+    throw new Error(
+      "No artifacts in your account yet \u2014 publish one first, or claim one via its claim link."
+    );
+  }
+  const selector = opts.artifact ?? opts.slug;
+  let chosen;
+  if (opts.artifact) {
+    chosen = artifacts.find((a) => a.id === opts.artifact);
+  } else if (opts.slug) {
+    chosen = artifacts.find((a) => a.slug === opts.slug);
+  }
+  if (selector && !chosen) {
+    throw new Error(
+      `No artifact "${selector}" in your account \u2014 run \`artifact-cafe list\` to see them.`
+    );
+  }
+  if (opts.json && !chosen) {
+    console.log(JSON.stringify({ artifacts }, null, 2));
+    return;
+  }
+  if (!chosen) {
+    if (!process.stdin.isTTY) {
+      throw new Error(
+        "Pick an artifact with --artifact <id> or --slug <slug> (or --json to list them). Interactive selection needs a terminal."
+      );
+    }
+    chosen = await pickArtifact(artifacts);
+  }
+  const dir = path7.resolve(opts.dir);
+  writeConfig(dir, {
+    apiUrl: apiUrl2,
+    artifactId: chosen.id,
+    slug: chosen.slug,
+    url: chosen.url
+    // No publishToken — this folder authorizes via your login, not a secret.
+  });
+  if (opts.json) {
+    console.log(
+      JSON.stringify(
+        {
+          artifactId: chosen.id,
+          linked: true,
+          slug: chosen.slug,
+          url: chosen.url
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+  console.log(`
+\u2713 Linked ${dir} \u2192 "${chosen.title}"  \u2014  ${chosen.url}`);
+  console.log(
+    "  Owner actions (publish, comments --wait, protect) use your login.\n"
+  );
+}
+function pickArtifact(artifacts) {
+  console.log("Your artifacts:\n");
+  artifacts.forEach((a, i) => {
+    const v = a.currentVersionNumber ? `v${a.currentVersionNumber}` : "\u2014";
+    console.log(
+      `  ${String(i + 1).padStart(2)}. ${a.title}  \xB7  ${v}  \xB7  ${a.url}`
+    );
+  });
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve, reject) => {
+    rl.question(`
+Link which? [1-${artifacts.length}]: `, (answer) => {
+      rl.close();
+      const n = Number(answer.trim());
+      if (!(Number.isInteger(n) && n >= 1 && n <= artifacts.length)) {
+        reject(new Error(`Enter a number between 1 and ${artifacts.length}.`));
+        return;
+      }
+      resolve(artifacts[n - 1]);
+    });
+  });
+}
+
 // src/list.ts
 async function list(opts) {
   const apiUrl2 = (process.env.ARTIFACT_CAFE_URL ?? DEFAULT_API_URL).replace(
@@ -1226,13 +1374,13 @@ function relativeTime(iso) {
 }
 
 // src/login.ts
-import { createInterface } from "readline";
+import { createInterface as createInterface2 } from "readline";
 function apiUrl() {
   return (process.env.ARTIFACT_CAFE_URL ?? DEFAULT_API_URL).replace(/\/$/, "");
 }
 function promptSecret(question) {
   return new Promise((resolve) => {
-    const rl = createInterface({
+    const rl = createInterface2({
       input: process.stdin,
       output: process.stdout
     });
@@ -1340,23 +1488,27 @@ function logout(opts) {
 }
 
 // src/open.ts
-import path7 from "path";
-function openArtifact(opts) {
-  const dir = path7.resolve(opts.dir);
-  const config = readConfig(dir);
-  if (!config) {
-    throw new Error(
-      `No artifact linked in ${dir} \u2014 run \`artifact-cafe publish\` there first (.artifactcafe/config.json not found).`
-    );
-  }
-  console.log(config.url);
+import path8 from "path";
+async function openArtifact(opts) {
+  const dir = path8.resolve(opts.dir);
+  const target = resolveArtifactTarget(dir, {
+    apiKey: opts.apiKey,
+    artifact: opts.artifact
+  });
+  const url = target.url ?? reviewUrl(
+    target.apiUrl,
+    (await createApiClient(target.apiUrl, target.credential).getArtifact(
+      target.artifactId
+    )).slug
+  );
+  console.log(url);
   if (process.stdout.isTTY) {
-    openInBrowser(config.url);
+    openInBrowser(url);
   }
 }
 
 // src/protect.ts
-import path8 from "path";
+import path9 from "path";
 async function protect(opts) {
   if (opts.off && opts.password !== void 0) {
     throw new Error("Pass either --password or --off, not both.");
@@ -1373,26 +1525,26 @@ async function protect(opts) {
       throw new Error(parsed.error.issues[0]?.message ?? "Invalid password.");
     }
   }
-  const dir = path8.resolve(opts.dir);
-  const config = readConfig(dir);
-  if (!config) {
-    throw new Error(
-      `No artifact linked in ${dir} \u2014 run \`artifact-cafe publish\` there first (.artifactcafe/config.json not found).`
-    );
-  }
-  const apiUrl2 = process.env.ARTIFACT_CAFE_URL ?? config.apiUrl;
-  const token = config.publishToken ?? process.env.ARTIFACT_CAFE_TOKEN;
-  const client = createApiClient(apiUrl2, token);
-  const res = await client.setProtection(config.artifactId, password);
+  const dir = path9.resolve(opts.dir);
+  const target = resolveArtifactTarget(dir, {
+    apiKey: opts.apiKey,
+    artifact: opts.artifact
+  });
+  const client = createApiClient(target.apiUrl, target.credential);
+  const res = await client.setProtection(target.artifactId, password);
   if (opts.json) {
     console.log(JSON.stringify({ protected: res.protected }, null, 2));
     return;
   }
+  const url = target.url ?? reviewUrl(
+    target.apiUrl,
+    (await client.getArtifact(target.artifactId)).slug
+  );
   console.log(
     res.protected ? `
-\u2713 Password protection on \u2014 ${config.url}
+\u2713 Password protection on \u2014 ${url}
 ` : `
-\u2713 Password protection removed \u2014 ${config.url}
+\u2713 Password protection removed \u2014 ${url}
 `
   );
 }
@@ -1517,8 +1669,56 @@ var list2 = defineCommand({
     }
   }
 });
+var link2 = defineCommand({
+  args: {
+    "api-key": {
+      description: "Link with this API key (default: stored login)",
+      type: "string"
+    },
+    artifact: {
+      description: "Link this artifact id (skip the picker)",
+      type: "string"
+    },
+    dir: {
+      default: ".",
+      description: "Directory to link",
+      type: "positional"
+    },
+    json: { description: "Machine-readable output", type: "boolean" },
+    slug: {
+      description: "Link this artifact slug (skip the picker)",
+      type: "string"
+    }
+  },
+  meta: {
+    description: "Link a folder to one of your artifacts (pick from your account)",
+    name: "link"
+  },
+  async run({ args }) {
+    try {
+      await link({
+        apiKey: args["api-key"],
+        artifact: args.artifact,
+        dir: args.dir,
+        json: Boolean(args.json),
+        slug: args.slug
+      });
+    } catch (err) {
+      printCliError(err, Boolean(args.json));
+      process.exit(1);
+    }
+  }
+});
 var comments2 = defineCommand({
   args: {
+    "api-key": {
+      description: "Authorize with an account API key (default: stored login)",
+      type: "string"
+    },
+    artifact: {
+      description: "Act on an artifact ID instead of the linked folder",
+      type: "string"
+    },
     dir: {
       default: ".",
       description: "Published directory",
@@ -1558,6 +1758,8 @@ var comments2 = defineCommand({
         );
       }
       await comments({
+        apiKey: args["api-key"],
+        artifact: args.artifact,
         dir: args.dir,
         json: Boolean(args.json),
         status: args.status,
@@ -1573,6 +1775,14 @@ var comments2 = defineCommand({
 });
 var protect2 = defineCommand({
   args: {
+    "api-key": {
+      description: "Authorize with an account API key (default: stored login)",
+      type: "string"
+    },
+    artifact: {
+      description: "Act on an artifact ID instead of the linked folder",
+      type: "string"
+    },
     dir: {
       default: ".",
       description: "Published directory",
@@ -1589,6 +1799,8 @@ var protect2 = defineCommand({
   async run({ args }) {
     try {
       await protect({
+        apiKey: args["api-key"],
+        artifact: args.artifact,
         dir: args.dir,
         json: Boolean(args.json),
         off: Boolean(args.off),
@@ -1602,6 +1814,14 @@ var protect2 = defineCommand({
 });
 var open = defineCommand({
   args: {
+    "api-key": {
+      description: "Authorize with an account API key (default: stored login)",
+      type: "string"
+    },
+    artifact: {
+      description: "Open an artifact ID instead of the linked folder",
+      type: "string"
+    },
     dir: {
       default: ".",
       description: "Published directory",
@@ -1609,9 +1829,13 @@ var open = defineCommand({
     }
   },
   meta: { description: "Open the linked artifact's review URL", name: "open" },
-  run({ args }) {
+  async run({ args }) {
     try {
-      openArtifact({ dir: args.dir });
+      await openArtifact({
+        apiKey: args["api-key"],
+        artifact: args.artifact,
+        dir: args.dir
+      });
     } catch (err) {
       printCliError(err, false);
       process.exit(1);
@@ -1644,9 +1868,21 @@ var main = defineCommand({
     description: "Publish AI-generated artifacts for review \u2014 https://artifact.cafe",
     name: "artifact-cafe"
   },
+  // Bare `artifact-cafe` (no subcommand) → brand banner + usage. citty
+  // still calls this parent run *after* a matched subcommand, so bail when
+  // a subcommand token is present (any non-flag arg; citty has already
+  // rejected unknown ones with E_UNKNOWN_COMMAND before we get here).
+  async run({ cmd, rawArgs }) {
+    if (rawArgs.some((arg) => !arg.startsWith("-"))) {
+      return;
+    }
+    printBanner();
+    await showUsage(cmd);
+  },
   subCommands: {
     comments: comments2,
     dashboard,
+    link: link2,
     list: list2,
     login: login2,
     logout: logout2,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "artifact-cafe",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Publish AI-generated artifacts for review on artifact.cafe",
   "type": "module",
   "bin": {
@@ -9,19 +9,19 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsup",
-    "typecheck": "tsc --noEmit",
-    "dev": "tsup --watch"
-  },
   "dependencies": {
     "citty": "^0.1.6",
     "zod": "^4.1.0"
   },
   "devDependencies": {
-    "@artifact-cafe/shared": "workspace:*",
     "@types/node": "^24.0.0",
     "tsup": "^8.5.0",
-    "typescript": "^5.9.0"
+    "typescript": "^5.9.0",
+    "@artifact-cafe/shared": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "dev": "tsup --watch"
   }
-}
+}