@gethmy/agent 1.0.0 → 1.0.2

package/README.md

@@ -4,19 +4,20 @@ Push-based agent daemon for [Harmony](https://gethmy.com). Watches board assignm
 
 ## Prerequisites
 
-- [Bun](https://bun.sh) >= 1.0.0
-- [Claude CLI](https://docs.anthropic.com/en/docs/claude-code)
+- [Node.js](https://nodejs.org) >= 20 or [Bun](https://bun.sh) >= 1.0
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI installed
 - Git
 - A [Harmony](https://gethmy.com) account with an API key
+- [@gethmy/mcp](https://www.npmjs.com/package/@gethmy/mcp) configured (`npx @gethmy/mcp setup`)
 
 ## Installation
 
 ```bash
-# Run directly
-bunx @gethmy/agent
+# Run directly (works with any package manager)
+npx @gethmy/agent
 
 # Or install globally
-bun install -g @gethmy/agent
+npm install -g @gethmy/agent
 harmony-agent
 ```
 
@@ -53,7 +54,7 @@ npx @gethmy/mcp setup
 Run from your git repository root:
 
 ```bash
-harmony-agent
+npx @gethmy/agent
 ```
 
 The daemon will:

package/dist/board-helpers.d.ts

@@ -0,0 +1,31 @@
+import type { HarmonyApiClient } from "@gethmy/mcp/src/api-client.js";
+import type { Card, Label } from "@harmony/shared";
+/**
+ * Build a label lookup map from board-level label definitions.
+ */
+export declare function buildLabelMap(boardLabels: Label[]): Map<string, Label>;
+/**
+ * Resolve a card's `labelIds` to full Label objects using a label map.
+ */
+export declare function resolveCardLabels(card: Card, labelMap: Map<string, Label>): Label[];
+/**
+ * Check if a card has a label by name (case-insensitive).
+ */
+export declare function hasLabel(cardLabels: Label[], labelName: string): boolean;
+/**
+ * Move a card to a column by name. Fetches the board to resolve column ID.
+ */
+export declare function moveCardToColumn(client: HarmonyApiClient, card: Card, targetColumnName: string): Promise<void>;
+/**
+ * Find a label by name (case-insensitive) or create it if missing.
+ */
+export declare function findOrCreateLabel(client: HarmonyApiClient, projectId: string, labelName: string, color?: string): Promise<string | null>;
+/**
+ * Add a label to a card by name, creating the label if it doesn't exist.
+ */
+export declare function addLabelByName(client: HarmonyApiClient, card: Card, labelName: string, color?: string): Promise<void>;
+/**
+ * Move a card to a column and add a label in one pass, fetching the board only once.
+ * Returns true if the move succeeded, false otherwise.
+ */
+export declare function moveCardAndAddLabel(client: HarmonyApiClient, card: Card, targetColumnName: string, labelName: string, labelColor?: string): Promise<boolean>;

package/dist/board-helpers.js

@@ -0,0 +1,150 @@
+import { log } from "./log.js";
+const TAG = "board";
+/**
+ * Build a label lookup map from board-level label definitions.
+ */
+export function buildLabelMap(boardLabels) {
+    const map = new Map();
+    for (const label of boardLabels) {
+        map.set(label.id, label);
+    }
+    return map;
+}
+/**
+ * Resolve a card's `labelIds` to full Label objects using a label map.
+ */
+export function resolveCardLabels(card, labelMap) {
+    const ids = card.labelIds ?? [];
+    return ids
+        .map((id) => labelMap.get(id))
+        .filter((l) => l !== undefined);
+}
+/**
+ * Check if a card has a label by name (case-insensitive).
+ */
+export function hasLabel(cardLabels, labelName) {
+    return cardLabels.some((l) => l.name.toLowerCase() === labelName.toLowerCase());
+}
+/**
+ * Move a card to a column by name. Fetches the board to resolve column ID.
+ */
+export async function moveCardToColumn(client, card, targetColumnName) {
+    try {
+        const board = await client.getBoard(card.project_id);
+        const targetColumn = board.columns.find((c) => c.name.toLowerCase() === targetColumnName.toLowerCase());
+        if (!targetColumn) {
+            log.warn(TAG, `Column "${targetColumnName}" not found, skipping move`);
+            return;
+        }
+        if (card.column_id === targetColumn.id) {
+            log.debug(TAG, `Card already in "${targetColumnName}"`);
+            return;
+        }
+        await client.moveCard(card.id, targetColumn.id);
+        log.info(TAG, `Moved #${card.short_id} to "${targetColumnName}"`);
+    }
+    catch (err) {
+        log.error(TAG, `Failed to move card: ${err instanceof Error ? err.message : err}`);
+    }
+}
+/**
+ * Find a label by name (case-insensitive) or create it if missing.
+ */
+export async function findOrCreateLabel(client, projectId, labelName, color = "#22c55e") {
+    try {
+        const board = await client.getBoard(projectId);
+        const labels = board.labels ?? [];
+        const existing = labels.find((l) => l.name.toLowerCase() === labelName.toLowerCase());
+        if (existing)
+            return existing.id;
+        const result = await client.createLabel(projectId, {
+            name: labelName,
+            color,
+        });
+        const labelId = result?.label?.id;
+        if (labelId) {
+            log.info(TAG, `Created label "${labelName}"`);
+            return labelId;
+        }
+        log.warn(TAG, `createLabel succeeded but returned no id`);
+        return null;
+    }
+    catch (err) {
+        log.error(TAG, `Failed to find/create label "${labelName}": ${err instanceof Error ? err.message : err}`);
+        return null;
+    }
+}
+/**
+ * Add a label to a card by name, creating the label if it doesn't exist.
+ */
+export async function addLabelByName(client, card, labelName, color) {
+    const labelId = await findOrCreateLabel(client, card.project_id, labelName, color);
+    if (!labelId)
+        return;
+    try {
+        await client.addLabelToCard(card.id, labelId);
+        log.info(TAG, `Added label "${labelName}" to #${card.short_id}`);
+    }
+    catch (err) {
+        log.error(TAG, `Failed to add label to card: ${err instanceof Error ? err.message : err}`);
+    }
+}
+/**
+ * Move a card to a column and add a label in one pass, fetching the board only once.
+ * Returns true if the move succeeded, false otherwise.
+ */
+export async function moveCardAndAddLabel(client, card, targetColumnName, labelName, labelColor = "#8b5cf6") {
+    let moved = false;
+    try {
+        const board = await client.getBoard(card.project_id);
+        const columns = board.columns;
+        const labels = board.labels ?? [];
+        // Move card
+        const targetColumn = columns.find((c) => c.name.toLowerCase() === targetColumnName.toLowerCase());
+        if (!targetColumn) {
+            log.warn(TAG, `Column "${targetColumnName}" not found on board (available: ${columns.map((c) => c.name).join(", ")})`);
+        }
+        else if (card.column_id === targetColumn.id) {
+            log.debug(TAG, `Card #${card.short_id} already in "${targetColumnName}"`);
+            moved = true;
+        }
+        else {
+            try {
+                await client.moveCard(card.id, targetColumn.id);
+                log.info(TAG, `Moved #${card.short_id} to "${targetColumnName}"`);
+                moved = true;
+            }
+            catch (err) {
+                log.error(TAG, `Failed to move #${card.short_id} to "${targetColumnName}": ${err instanceof Error ? err.message : err}`);
+            }
+        }
+        // Resolve label ID (find or create)
+        let labelId;
+        const existing = labels.find((l) => l.name.toLowerCase() === labelName.toLowerCase());
+        if (existing) {
+            labelId = existing.id;
+        }
+        else {
+            const result = await client.createLabel(card.project_id, {
+                name: labelName,
+                color: labelColor,
+            });
+            labelId = result?.label?.id;
+            if (labelId)
+                log.info(TAG, `Created label "${labelName}"`);
+        }
+        if (labelId) {
+            try {
+                await client.addLabelToCard(card.id, labelId);
+                log.info(TAG, `Added label "${labelName}" to #${card.short_id}`);
+            }
+            catch (err) {
+                log.error(TAG, `Failed to add label "${labelName}" to #${card.short_id}: ${err instanceof Error ? err.message : err}`);
+            }
+        }
+    }
+    catch (err) {
+        log.error(TAG, `Failed to prepare move/label for #${card.short_id}: ${err instanceof Error ? err.message : err}`);
+    }
+    return moved;
+}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "./index.js";