fusion/plugins/fusion-plugin-even-cards

Even Cards Plugin

Standalone Fusion plugin for the Even Realities on-device card flow focused on glanceable board/task status.

Reading the board

All endpoints are mounted under /api/plugins/fusion-plugin-even-cards.

Authentication header (required):

Authorization: Bearer <apiKey>

Method	Path	Query params	Response
GET	/board/cards	columns (comma-separated columns), max (1-20 total cards)	{ deck, generatedAt }
GET	/board	columns (optional)	{ summary, updatedAt }
GET	/tasks/:id/cards	none	{ deck, generatedAt } or 404

max is total deck size (summary + tasks). Example: max=20 returns 1 summary card and up to 19 task cards.

Card data model

type GlassesCard = {
  id: string;
  kind: "summary" | "task";
  title: string;
  lines: string[];
  badge: { label: string; tone: "triage" | "todo" | "in-progress" | "in-review" | "done" | "neutral" };
  taskId?: string;
  updatedAt: string;
};

type CardDeck = {
  cards: GlassesCard[];
  summary: {
    counts: Record<string, number>;
    updatedAt: string | null;
  };
};

Display defaults

Current defaults in src/cards/format.ts:

• DEFAULT_MAX_CHARS_PER_LINE = 24
• DEFAULT_MAX_LINES_PER_CARD = 4
• DEFAULT_MAX_CARDS_PER_DECK = 8

These are provisional fallback values because FN-3737 research artifacts were unavailable in this worktree; revisit task is tracked in FN-3754.