@gethmy/agent 1.7.1 → 1.7.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gethmy/agent",
-  "version": "1.7.1",
+  "version": "1.7.2",
   "description": "Push-based agent daemon for Harmony — watches board assignments and spawns Claude CLI workers",
   "type": "module",
   "main": "dist/index.js",
@@ -38,7 +38,7 @@
   "scripts": {
     "start": "node dist/index.js",
     "prebuild": "cd ../harmony-shared && bun run build && cd ../memory && bun run build",
-    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "build": "rm -rf dist && bun build src/index.ts src/cli.ts --outdir dist --target node --external @supabase/supabase-js --external @gethmy/mcp --external \"@gethmy/mcp/*\"",
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "npm run build",
     "test": "vitest run"

package/dist/board-helpers.d.ts

@@ -1,31 +0,0 @@
-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

@@ -1,150 +0,0 @@
-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/budget.d.ts

@@ -1,39 +0,0 @@
-import type { FailureSummaryRecord, StateStore } from "./state-store.js";
-import type { AgentConfig } from "./types.js";
-export type GuardDecision = {
-    allow: true;
-} | {
-    allow: false;
-    reason: GuardReason;
-    detail: string;
-};
-export type GuardReason = "max_attempts" | "daily_budget";
-/**
- * BudgetGuard is consulted on every implement pickup. It protects the
- * daemon from two failure modes:
- *   1. Cards that can never succeed — after N failed attempts the daemon
- *      gives up quietly (`max_attempts`) and pings once via a comment.
- *   2. Runaway daily spend across the entire daemon (`daily_budget`).
- *
- * Both are recoverable: `max_attempts` resets when the card is reassigned
- * (see `StateStore.resetAttempts`), and `daily_budget` resets at UTC
- * midnight. There is no per-card cost cap and no permanent dead-letter
- * quarantine — the guard never blocks a card forever.
- */
-export declare class BudgetGuard {
-    private config;
-    private store;
-    constructor(config: AgentConfig["budget"], store: StateStore);
-    /**
-     * Inspect a card before we commit to picking it up. `max_attempts` means
-     * the daemon has given up (the worker has already posted a comment);
-     * `daily_budget` is a soft pause until the UTC day rolls over.
-     */
-    check(cardId: string): GuardDecision;
-}
-/**
- * Build the one-shot "agent gave up" comment posted when a card exhausts
- * its attempt budget. Lists the recent failure summaries so a human has a
- * post-mortem trail and a recovery branch to check out.
- */
-export declare function buildGaveUpComment(maxAttempts: number, failures: FailureSummaryRecord[]): string;

package/dist/budget.js

@@ -1,73 +0,0 @@
-/**
- * BudgetGuard is consulted on every implement pickup. It protects the
- * daemon from two failure modes:
- *   1. Cards that can never succeed — after N failed attempts the daemon
- *      gives up quietly (`max_attempts`) and pings once via a comment.
- *   2. Runaway daily spend across the entire daemon (`daily_budget`).
- *
- * Both are recoverable: `max_attempts` resets when the card is reassigned
- * (see `StateStore.resetAttempts`), and `daily_budget` resets at UTC
- * midnight. There is no per-card cost cap and no permanent dead-letter
- * quarantine — the guard never blocks a card forever.
- */
-export class BudgetGuard {
-    config;
-    store;
-    constructor(config, store) {
-        this.config = config;
-        this.store = store;
-    }
-    /**
-     * Inspect a card before we commit to picking it up. `max_attempts` means
-     * the daemon has given up (the worker has already posted a comment);
-     * `daily_budget` is a soft pause until the UTC day rolls over.
-     */
-    check(cardId) {
-        const card = this.store.getCard(cardId);
-        if (card && card.attempts >= this.config.maxAttemptsPerCard) {
-            return {
-                allow: false,
-                reason: "max_attempts",
-                detail: `${card.attempts} of ${this.config.maxAttemptsPerCard} attempts exhausted`,
-            };
-        }
-        const dailySpent = this.store.getDailyCostCents();
-        if (dailySpent >= this.config.dailyBudgetCents) {
-            return {
-                allow: false,
-                reason: "daily_budget",
-                detail: `daily budget ${formatCents(dailySpent)}/${formatCents(this.config.dailyBudgetCents)} exhausted`,
-            };
-        }
-        return { allow: true };
-    }
-}
-/**
- * Build the one-shot "agent gave up" comment posted when a card exhausts
- * its attempt budget. Lists the recent failure summaries so a human has a
- * post-mortem trail and a recovery branch to check out.
- */
-export function buildGaveUpComment(maxAttempts, failures) {
-    const lines = [
-        "**Agent gave up — needs a human.**",
-        `Stopped after ${maxAttempts} failed attempt${maxAttempts === 1 ? "" : "s"}. Reassign the card to try again.`,
-    ];
-    if (failures.length > 0) {
-        lines.push("", "Recent failures:");
-        for (const f of failures) {
-            const when = new Date(f.ts).toISOString().replace("T", " ").slice(0, 16);
-            const tag = f.reason ? ` [${f.reason}]` : "";
-            const branch = f.recoveryBranch
-                ? `\n  recover: \`git fetch && git checkout ${f.recoveryBranch}\``
-                : "";
-            lines.push(`- ${when} UTC${tag} — ${f.summary}${branch}`);
-        }
-    }
-    else {
-        lines.push("", "_No prior failure summaries recorded._");
-    }
-    return lines.join("\n");
-}
-function formatCents(cents) {
-    return `$${(cents / 100).toFixed(2)}`;
-}

package/dist/cli.d.ts

@@ -1,14 +0,0 @@
-#!/usr/bin/env node
-/**
- * Harmony Agent CLI entry point.
- *
- * Subcommands:
- *   (no args)       — run the daemon (same as `run`)
- *   run             — run the daemon
- *   status          — GET /status from the running daemon, pretty-print
- *   health          — GET /health, exit 0 if healthy, 1 otherwise
- *   doctor          — run preflight checks without starting the daemon
- *   gc              — one-shot worktree garbage collection
- *   help            — show usage
- */
-export {};

package/dist/completion.d.ts

@@ -1,36 +0,0 @@
-import type { HarmonyApiClient } from "@gethmy/mcp/src/api-client.js";
-import type { Card } from "@harmony/shared";
-import type { StateStore } from "./state-store.js";
-import type { CostUpdate } from "./stream-parser.js";
-import { type AgentConfig } from "./types.js";
-export interface SessionStats {
-    filesEdited: number;
-    /** Edited file paths tracked by the ProgressTracker (#272). */
-    filesEditedPaths?: string[];
-    filesRead: number;
-    toolCalls: number;
-    cost: CostUpdate | null;
-    /** Trimmed last assistant text — feeds the episode write hook (Phase 1.5). */
-    lastAssistantText?: string;
-    /** All non-trivial assistant text blocks — richer summary source (#272). */
-    assistantTextBlocks?: string[];
-}
-export declare function buildTokenPayload(stats?: SessionStats | null): {
-    costCents?: undefined;
-    inputTokens?: undefined;
-    outputTokens?: undefined;
-    cacheCreationInputTokens?: undefined;
-    cacheReadInputTokens?: undefined;
-    modelName?: undefined;
-} | {
-    costCents: number;
-    inputTokens: number;
-    outputTokens: number;
-    cacheCreationInputTokens: number;
-    cacheReadInputTokens: number;
-    modelName: string | undefined;
-};
-/**
- * Post-work pipeline: push branch, create PR, move card, post summary.
- */
-export declare function runCompletion(client: HarmonyApiClient, card: Card, branchName: string, worktreePath: string, config: AgentConfig, workerId: number, sessionStats: SessionStats | undefined, workspaceId: string | undefined, agentSessionId: string | null | undefined, stateStore: StateStore): Promise<boolean>;