skyboard-cli 0.1.0 → 0.1.1

package/src/commands/show.ts

@@ -1,100 +0,0 @@
-import { requireAgent } from "../lib/auth.js";
-import { fetchBoardData } from "../lib/pds.js";
-import { getDefaultBoard } from "../lib/config.js";
-import { resolveCardRef } from "../lib/card-ref.js";
-import { shortRkey, formatDate } from "../lib/display.js";
-import { buildAtUri, TASK_COLLECTION } from "../lib/tid.js";
-import chalk from "chalk";
-
-export async function showCommand(ref: string, opts: { board?: string; json?: boolean }): Promise<void> {
-  const { did } = await requireAgent();
-
-  const boardRef = resolveBoard(opts.board);
-
-  const data = await fetchBoardData(boardRef.did, boardRef.rkey, did);
-  if (!data) {
-    console.error(chalk.red("Board not found."));
-    process.exit(1);
-  }
-
-  let task;
-  try {
-    task = resolveCardRef(ref, data.tasks);
-  } catch (err) {
-    console.error(chalk.red(err instanceof Error ? err.message : String(err)));
-    process.exit(1);
-  }
-
-  const col = data.board.columns.find((c) => c.id === task.effectiveColumnId);
-  const labels = task.effectiveLabelIds
-    .map((id) => data.board.labels?.find((l) => l.id === id))
-    .filter(Boolean);
-
-  const taskUri = buildAtUri(task.did, TASK_COLLECTION, task.rkey);
-  const comments = data.comments
-    .filter((c) => c.targetTaskUri === taskUri)
-    .sort((a, b) => a.createdAt.localeCompare(b.createdAt));
-
-  if (opts.json) {
-    console.log(JSON.stringify({
-      rkey: task.rkey,
-      did: task.did,
-      title: task.effectiveTitle,
-      description: task.effectiveDescription,
-      column: col?.name,
-      labels: labels.map((l) => ({ id: l!.id, name: l!.name, color: l!.color })),
-      createdAt: task.createdAt,
-      lastModifiedAt: task.lastModifiedAt,
-      lastModifiedBy: task.lastModifiedBy,
-      opsApplied: task.appliedOps.length,
-      comments: comments.map((c) => ({
-        did: c.did,
-        text: c.text,
-        createdAt: c.createdAt,
-      })),
-    }, null, 2));
-    return;
-  }
-
-  console.log();
-  console.log(chalk.bold(task.effectiveTitle));
-  console.log(chalk.dim(`${shortRkey(task.rkey)}  by ${task.did.slice(0, 20)}...  ${formatDate(task.createdAt)}`));
-  console.log();
-
-  if (col) {
-    console.log(`${chalk.bold("Column:")}  ${col.name}`);
-  }
-  if (labels.length > 0) {
-    const labelStr = labels.map((l) => chalk.hex(l!.color)(`[${l!.name}]`)).join(" ");
-    console.log(`${chalk.bold("Labels:")}  ${labelStr}`);
-  }
-  if (task.effectiveDescription) {
-    console.log();
-    console.log(task.effectiveDescription);
-  }
-
-  if (task.appliedOps.length > 0) {
-    console.log();
-    console.log(chalk.dim(`${task.appliedOps.length} edit(s) applied`));
-  }
-
-  if (comments.length > 0) {
-    console.log();
-    console.log(chalk.bold.underline("Comments"));
-    for (const comment of comments) {
-      console.log();
-      console.log(`  ${chalk.dim(comment.did.slice(0, 20) + "...")}  ${chalk.dim(formatDate(comment.createdAt))}`);
-      console.log(`  ${comment.text}`);
-    }
-  }
-  console.log();
-}
-
-function resolveBoard(boardOpt?: string): { did: string; rkey: string } {
-  const defaultBoard = getDefaultBoard();
-  if (!defaultBoard) {
-    console.error(chalk.red("No default board set. Run `sb use <board>` first."));
-    process.exit(1);
-  }
-  return defaultBoard;
-}

package/src/commands/status.ts

@@ -1,78 +0,0 @@
-import { loadAuthInfo, getDefaultBoard } from "../lib/config.js";
-import { requireAgent } from "../lib/auth.js";
-import { fetchBoardData } from "../lib/pds.js";
-import chalk from "chalk";
-
-export async function statusCommand(opts: { json?: boolean }): Promise<void> {
-  const info = loadAuthInfo();
-
-  if (!info) {
-    if (opts.json) {
-      console.log(JSON.stringify({ loggedIn: false }, null, 2));
-    } else {
-      console.log("Not logged in. Run `sb login <handle>` first.");
-    }
-    return;
-  }
-
-  const boardRef = getDefaultBoard();
-
-  if (!boardRef) {
-    if (opts.json) {
-      console.log(JSON.stringify({ loggedIn: true, ...info, board: null }, null, 2));
-    } else {
-      console.log(`${chalk.bold("Handle:")}  ${info.handle}`);
-      console.log(`${chalk.bold("DID:")}     ${info.did}`);
-      console.log(`\nNo default board set. Run ${chalk.cyan("sb use <board>")} to select one.`);
-    }
-    return;
-  }
-
-  const { did } = await requireAgent();
-  const data = await fetchBoardData(boardRef.did, boardRef.rkey, did);
-
-  if (!data) {
-    if (opts.json) {
-      console.log(JSON.stringify({ loggedIn: true, ...info, board: null }, null, 2));
-    } else {
-      console.log(`${chalk.bold("Handle:")}  ${info.handle}`);
-      console.log(`${chalk.bold("DID:")}     ${info.did}`);
-      console.log(`\n${chalk.red("Board not found.")}`);
-    }
-    return;
-  }
-
-  const sortedColumns = [...data.board.columns].sort((a, b) => a.order - b.order);
-  const columns = sortedColumns.map((col, i) => {
-    const taskCount = data.tasks.filter((t) => t.effectiveColumnId === col.id).length;
-    return { index: i + 1, name: col.name, id: col.id, taskCount };
-  });
-  const totalCards = data.tasks.length;
-
-  if (opts.json) {
-    console.log(JSON.stringify({
-      loggedIn: true,
-      handle: info.handle,
-      did: info.did,
-      board: {
-        name: data.board.name,
-        rkey: boardRef.rkey,
-        did: boardRef.did,
-        columns: columns.map(({ index, name, taskCount }) => ({ index, name, taskCount })),
-        totalCards,
-      },
-    }, null, 2));
-    return;
-  }
-
-  console.log(`${chalk.bold("Handle:")}  ${info.handle}`);
-  console.log(`${chalk.bold("DID:")}     ${info.did}`);
-  console.log(`${chalk.bold("Board:")}   ${data.board.name}`);
-  console.log();
-
-  for (const col of columns) {
-    console.log(`  ${chalk.dim(`${col.index}.`)} ${col.name} ${chalk.dim(`(${col.taskCount})`)}`);
-  }
-
-  console.log(`\n  ${totalCards} cards total`);
-}

package/src/commands/use.ts

@@ -1,72 +0,0 @@
-import { requireAgent } from "../lib/auth.js";
-import { fetchMyBoards, fetchBoard, resolveHandle } from "../lib/pds.js";
-import { setDefaultBoard, loadConfig } from "../lib/config.js";
-import { BOARD_COLLECTION } from "../lib/tid.js";
-import chalk from "chalk";
-
-/**
- * Parse a board reference: name, rkey, AT URI, or web URL.
- * Returns { did, rkey } or null.
- */
-async function parseBoardRef(
-  ref: string,
-  currentDid: string,
-): Promise<{ did: string; rkey: string } | null> {
-  // AT URI: at://did:plc:xxx/dev.skyboard.board/rkey
-  if (ref.startsWith("at://")) {
-    const parts = ref.replace("at://", "").split("/");
-    if (parts.length >= 3 && parts[1] === BOARD_COLLECTION) {
-      return { did: parts[0], rkey: parts[2] };
-    }
-    return null;
-  }
-
-  // Web URL: https://skyboard.dev/board/did:plc:xxx/rkey
-  if (ref.startsWith("http://") || ref.startsWith("https://")) {
-    const url = new URL(ref);
-    const pathParts = url.pathname.split("/").filter(Boolean);
-    // /board/did:plc:xxx/rkey
-    if (pathParts.length >= 3 && pathParts[0] === "board") {
-      return { did: pathParts[1], rkey: pathParts[2] };
-    }
-    // /board/rkey (own board)
-    if (pathParts.length === 2 && pathParts[0] === "board") {
-      return { did: currentDid, rkey: pathParts[1] };
-    }
-    return null;
-  }
-
-  // Check known boards by name (fuzzy)
-  const config = loadConfig();
-  const lowerRef = ref.toLowerCase();
-  const nameMatch = config.knownBoards.find(
-    (b) => b.name.toLowerCase().includes(lowerRef),
-  );
-  if (nameMatch) return { did: nameMatch.did, rkey: nameMatch.rkey };
-
-  // Try as rkey for own board
-  const board = await fetchBoard(currentDid, ref);
-  if (board) return { did: currentDid, rkey: ref };
-
-  return null;
-}
-
-export async function useCommand(boardRef: string): Promise<void> {
-  const { did } = await requireAgent();
-
-  const parsed = await parseBoardRef(boardRef, did);
-  if (!parsed) {
-    console.error(chalk.red(`Could not resolve board: ${boardRef}`));
-    console.error("Try a board name, rkey, AT URI, or web URL.");
-    process.exit(1);
-  }
-
-  const board = await fetchBoard(parsed.did, parsed.rkey);
-  if (!board) {
-    console.error(chalk.red(`Board not found at ${parsed.did}/${parsed.rkey}`));
-    process.exit(1);
-  }
-
-  setDefaultBoard({ did: parsed.did, rkey: parsed.rkey, name: board.name });
-  console.log(chalk.green(`Default board set to: ${chalk.bold(board.name)}`));
-}

package/src/commands/whoami.ts

@@ -1,22 +0,0 @@
-import { loadAuthInfo } from "../lib/config.js";
-import chalk from "chalk";
-
-export function whoamiCommand(opts: { json?: boolean }): void {
-  const info = loadAuthInfo();
-  if (!info) {
-    if (opts.json) {
-      console.log(JSON.stringify({ loggedIn: false }));
-    } else {
-      console.log("Not logged in. Run `sb login <handle>` first.");
-    }
-    return;
-  }
-
-  if (opts.json) {
-    console.log(JSON.stringify({ loggedIn: true, ...info }, null, 2));
-  } else {
-    console.log(`${chalk.bold("Handle:")}  ${info.handle}`);
-    console.log(`${chalk.bold("DID:")}     ${info.did}`);
-    console.log(`${chalk.bold("PDS:")}     ${info.service}`);
-  }
-}

package/src/index.ts

@@ -1,143 +0,0 @@
-#!/usr/bin/env node
-import { Command } from "commander";
-import { loginCommand } from "./commands/login.js";
-import { logoutCommand } from "./commands/logout.js";
-import { whoamiCommand } from "./commands/whoami.js";
-import { statusCommand } from "./commands/status.js";
-import { boardsCommand } from "./commands/boards.js";
-import { useCommand } from "./commands/use.js";
-import { addCommand } from "./commands/add.js";
-import { colsCommand } from "./commands/cols.js";
-import { cardsCommand } from "./commands/cards.js";
-import { showCommand } from "./commands/show.js";
-import { newCommand } from "./commands/new.js";
-import { mvCommand } from "./commands/mv.js";
-import { editCommand } from "./commands/edit.js";
-import { commentCommand } from "./commands/comment.js";
-import { rmCommand } from "./commands/rm.js";
-
-const program = new Command();
-
-program
-  .name("sb")
-  .description("Skyboard CLI — manage kanban boards on AT Protocol")
-  .version("0.1.0");
-
-// Auth commands
-program
-  .command("login")
-  .description("Log in via AT Protocol OAuth (opens browser)")
-  .argument("<handle>", "Your AT Protocol handle (e.g. alice.bsky.social)")
-  .action(loginCommand);
-
-program
-  .command("logout")
-  .description("Log out and clear stored session")
-  .action(logoutCommand);
-
-program
-  .command("whoami")
-  .description("Show current authenticated user")
-  .option("--json", "Output as JSON")
-  .action(whoamiCommand);
-
-program
-  .command("status")
-  .description("Show current auth state and board summary")
-  .option("--json", "Output as JSON")
-  .action(statusCommand);
-
-// Board navigation
-program
-  .command("boards")
-  .description("List all boards (owned + joined)")
-  .option("--json", "Output as JSON")
-  .action(boardsCommand);
-
-program
-  .command("use")
-  .description("Set default board for subsequent commands")
-  .argument("<board>", "Board name, rkey, AT URI, or web URL")
-  .action(useCommand);
-
-program
-  .command("add")
-  .description("Join a board by AT URI or web URL")
-  .argument("<link>", "AT URI or web URL of the board")
-  .action(addCommand);
-
-program
-  .command("cols")
-  .description("Show columns for the current board")
-  .option("--board <ref>", "Override default board")
-  .option("--json", "Output as JSON")
-  .action(colsCommand);
-
-// Card operations
-program
-  .command("cards")
-  .description("List cards grouped by column")
-  .option("-c, --column <column>", "Filter by column (name, prefix, or number)")
-  .option("-l, --label <label>", "Filter by label name")
-  .option("-s, --search <text>", "Search in title and description")
-  .option("--board <ref>", "Override default board")
-  .option("--json", "Output as JSON")
-  .action(cardsCommand);
-
-program
-  .command("new")
-  .description("Create a new card")
-  .argument("<title>", "Card title")
-  .option("-c, --column <column>", "Target column (default: first column)")
-  .option("-d, --description <desc>", "Card description")
-  .option("--board <ref>", "Override default board")
-  .option("--json", "Output as JSON")
-  .action(newCommand);
-
-program
-  .command("show")
-  .description("Show card details, comments, and history")
-  .argument("<ref>", "Card reference (rkey prefix, min 4 chars)")
-  .option("--board <ref>", "Override default board")
-  .option("--json", "Output as JSON")
-  .action(showCommand);
-
-program
-  .command("mv")
-  .description("Move a card to a different column")
-  .argument("<ref>", "Card reference (rkey prefix)")
-  .argument("<column>", "Target column (name, prefix, or number)")
-  .option("--board <ref>", "Override default board")
-  .option("--json", "Output as JSON")
-  .action(mvCommand);
-
-program
-  .command("edit")
-  .description("Edit card fields")
-  .argument("<ref>", "Card reference (rkey prefix)")
-  .option("-t, --title <title>", "New title")
-  .option("-d, --description <desc>", "New description")
-  .option("-l, --label <label...>", "Set labels (by name)")
-  .option("--board <ref>", "Override default board")
-  .option("--json", "Output as JSON")
-  .action(editCommand);
-
-program
-  .command("comment")
-  .description("Add a comment to a card")
-  .argument("<ref>", "Card reference (rkey prefix)")
-  .argument("<text>", "Comment text")
-  .option("--board <ref>", "Override default board")
-  .option("--json", "Output as JSON")
-  .action(commentCommand);
-
-program
-  .command("rm")
-  .description("Delete a card (owner only)")
-  .argument("<ref>", "Card reference (rkey prefix)")
-  .option("-f, --force", "Skip confirmation")
-  .option("--board <ref>", "Override default board")
-  .option("--json", "Output as JSON")
-  .action(rmCommand);
-
-program.parse();

package/src/lib/auth.ts

@@ -1,244 +0,0 @@
-import { Agent } from "@atproto/api";
-import { NodeOAuthClient } from "@atproto/oauth-client-node";
-import type { NodeSavedSession, NodeSavedState } from "@atproto/oauth-client-node";
-import { requestLocalLock } from "@atproto/oauth-client";
-import { createServer } from "node:http";
-import {
-  writeStateFile,
-  readStateFile,
-  deleteStateFile,
-  writeSessionFile,
-  readSessionFile,
-  deleteSessionFile,
-  loadAuthInfo,
-  saveAuthInfo,
-  clearAuthInfo,
-} from "./config.js";
-
-const OAUTH_SCOPE =
-  "atproto repo:dev.skyboard.board repo:dev.skyboard.task repo:dev.skyboard.op repo:dev.skyboard.trust repo:dev.skyboard.comment repo:dev.skyboard.approval repo:dev.skyboard.reaction";
-
-// File-based stores implementing the NodeOAuthClient interfaces
-const stateStore = {
-  async set(key: string, state: NodeSavedState): Promise<void> {
-    writeStateFile(key, state);
-  },
-  async get(key: string): Promise<NodeSavedState | undefined> {
-    return readStateFile(key) as NodeSavedState | undefined;
-  },
-  async del(key: string): Promise<void> {
-    deleteStateFile(key);
-  },
-};
-
-const sessionStore = {
-  async set(sub: string, session: NodeSavedSession): Promise<void> {
-    writeSessionFile(sub, session);
-  },
-  async get(sub: string): Promise<NodeSavedSession | undefined> {
-    return readSessionFile(sub) as NodeSavedSession | undefined;
-  },
-  async del(sub: string): Promise<void> {
-    deleteSessionFile(sub);
-  },
-};
-
-function createOAuthClient(port: number): NodeOAuthClient {
-  const redirectUri = `http://127.0.0.1:${port}/callback`;
-  return new NodeOAuthClient({
-    clientMetadata: {
-      client_id: `http://localhost?redirect_uri=${encodeURIComponent(redirectUri)}&scope=${encodeURIComponent(OAUTH_SCOPE)}`,
-      client_name: "Skyboard CLI",
-      redirect_uris: [redirectUri],
-      scope: OAUTH_SCOPE,
-      grant_types: ["authorization_code", "refresh_token"],
-      response_types: ["code"],
-      token_endpoint_auth_method: "none",
-      application_type: "native",
-      dpop_bound_access_tokens: true,
-    },
-    stateStore,
-    sessionStore,
-    requestLock: requestLocalLock,
-  });
-}
-
-/**
- * Find a free port by binding to port 0.
- */
-async function findFreePort(): Promise<number> {
-  return new Promise((resolve, reject) => {
-    const srv = createServer();
-    srv.listen(0, "127.0.0.1", () => {
-      const addr = srv.address();
-      if (addr && typeof addr === "object") {
-        const port = addr.port;
-        srv.close(() => resolve(port));
-      } else {
-        srv.close(() => reject(new Error("Could not determine port")));
-      }
-    });
-    srv.on("error", reject);
-  });
-}
-
-/**
- * Perform OAuth loopback login. Opens browser for authorization,
- * starts a local HTTP server for the callback.
- * Returns the DID and handle of the authenticated user.
- */
-export async function login(handle: string): Promise<{ did: string; handle: string }> {
-  const port = await findFreePort();
-  const client = createOAuthClient(port);
-
-  const authUrl = await client.authorize(handle, {
-    scope: OAUTH_SCOPE,
-  });
-
-  // Start callback server
-  return new Promise((resolve, reject) => {
-    const timeout = setTimeout(() => {
-      server.close();
-      reject(new Error("Login timed out after 120 seconds"));
-    }, 120_000);
-
-    const server = createServer(async (req, res) => {
-      if (!req.url?.startsWith("/callback")) {
-        res.writeHead(404);
-        res.end("Not found");
-        return;
-      }
-
-      try {
-        const url = new URL(req.url, `http://127.0.0.1:${port}`);
-        const { session } = await client.callback(url.searchParams);
-
-        const did = session.did;
-        // Resolve handle from DID
-        const agent = new Agent(session);
-        let resolvedHandle = handle;
-        try {
-          const profile = await agent.getProfile({ actor: did });
-          resolvedHandle = profile.data.handle;
-        } catch {
-          // Use the provided handle as fallback
-        }
-
-        // Find the PDS endpoint for this DID
-        let service = "https://bsky.social";
-        try {
-          const didDoc = await resolveDIDDocument(did);
-          if (didDoc) {
-            const services = (didDoc as Record<string, unknown>).service as
-              | Array<{ id: string; type: string; serviceEndpoint: string }>
-              | undefined;
-            const pds = services?.find(
-              (s) => s.id === "#atproto_pds" || s.type === "AtprotoPersonalDataServer",
-            );
-            if (pds?.serviceEndpoint) {
-              service = pds.serviceEndpoint;
-            }
-          }
-        } catch {
-          // fallback to default
-        }
-
-        saveAuthInfo({ did, handle: resolvedHandle, service });
-
-        res.writeHead(200, { "Content-Type": "text/html" });
-        res.end(`
-          <html><body style="font-family: system-ui; text-align: center; padding: 40px;">
-            <h2>Logged in to Skyboard CLI</h2>
-            <p>You can close this tab and return to your terminal.</p>
-          </body></html>
-        `);
-
-        clearTimeout(timeout);
-        server.close();
-        resolve({ did, handle: resolvedHandle });
-      } catch (err) {
-        res.writeHead(500, { "Content-Type": "text/html" });
-        res.end(`
-          <html><body style="font-family: system-ui; text-align: center; padding: 40px;">
-            <h2>Login failed</h2>
-            <p>${err instanceof Error ? err.message : "Unknown error"}</p>
-          </body></html>
-        `);
-        clearTimeout(timeout);
-        server.close();
-        reject(err);
-      }
-    });
-
-    server.listen(port, "127.0.0.1", async () => {
-      // Open browser
-      try {
-        const open = (await import("open")).default;
-        await open(authUrl.toString());
-        console.log(`\nOpened browser for login. Waiting for authorization...`);
-        console.log(`If the browser didn't open, visit:\n${authUrl.toString()}\n`);
-      } catch {
-        console.log(`\nOpen this URL in your browser to log in:\n${authUrl.toString()}\n`);
-      }
-    });
-  });
-}
-
-/**
- * Get an authenticated Agent for the currently logged-in user.
- * Restores the OAuth session and returns an Agent that auto-refreshes tokens.
- */
-export async function getAgent(): Promise<{ agent: Agent; did: string; handle: string } | null> {
-  const authInfo = loadAuthInfo();
-  if (!authInfo) return null;
-
-  try {
-    // We need to create a client to restore the session.
-    // Since we don't know the original port, use a dummy port — session
-    // restoration doesn't need the redirect_uri to match.
-    const client = createOAuthClient(0);
-    const session = await client.restore(authInfo.did);
-    const agent = new Agent(session);
-    return { agent, did: authInfo.did, handle: authInfo.handle };
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Require authentication — exit with error if not logged in.
- */
-export async function requireAgent(): Promise<{ agent: Agent; did: string; handle: string }> {
-  const result = await getAgent();
-  if (!result) {
-    console.error("Not logged in. Run `sb login <handle>` first.");
-    process.exit(1);
-  }
-  return result;
-}
-
-export function logout(): void {
-  const authInfo = loadAuthInfo();
-  if (authInfo) {
-    deleteSessionFile(authInfo.did);
-  }
-  clearAuthInfo();
-}
-
-async function resolveDIDDocument(did: string): Promise<unknown | null> {
-  try {
-    if (did.startsWith("did:plc:")) {
-      const res = await fetch(`https://plc.directory/${did}`);
-      if (!res.ok) return null;
-      return await res.json();
-    } else if (did.startsWith("did:web:")) {
-      const host = did.slice("did:web:".length).replaceAll(":", "/");
-      const res = await fetch(`https://${host}/.well-known/did.json`);
-      if (!res.ok) return null;
-      return await res.json();
-    }
-    return null;
-  } catch {
-    return null;
-  }
-}

package/src/lib/card-ref.ts

@@ -1,32 +0,0 @@
-import type { MaterializedTask } from "./types.js";
-
-const MIN_PREFIX_LEN = 4;
-
-/**
- * Resolve a card reference (TID rkey prefix) to a unique task.
- * Returns the matching task, or throws with a helpful message if
- * ambiguous or not found.
- */
-export function resolveCardRef(
-  ref: string,
-  tasks: MaterializedTask[],
-): MaterializedTask {
-  if (ref.length < MIN_PREFIX_LEN) {
-    throw new Error(`Card reference too short (min ${MIN_PREFIX_LEN} chars): ${ref}`);
-  }
-
-  const matches = tasks.filter((t) => t.rkey.startsWith(ref));
-
-  if (matches.length === 0) {
-    throw new Error(`No card found matching "${ref}"`);
-  }
-
-  if (matches.length > 1) {
-    const list = matches
-      .map((t) => `  ${t.rkey.slice(0, 7)}  ${t.effectiveTitle}`)
-      .join("\n");
-    throw new Error(`Ambiguous reference "${ref}". Matches:\n${list}`);
-  }
-
-  return matches[0];
-}