@gethmy/agent 1.7.0 → 1.7.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gethmy/agent",
-  "version": "1.7.0",
+  "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,47 +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 { AgentConfig } from "./types.js";
-export type GuardDecision = {
-    allow: true;
-} | {
-    allow: false;
-    reason: GuardReason;
-    detail: string;
-};
-export type GuardReason = "dlq" | "max_attempts" | "card_cost_cap" | "daily_budget";
-/**
- * BudgetGuard is consulted on every pickup and on every run start.
- * It protects the daemon from three failure modes:
- *   1. Cards that can never succeed (DLQ after N failed attempts).
- *   2. Cards that burn unbounded tokens on a single attempt.
- *   3. Runaway daily spend across the entire daemon.
- *
- * The guard is advisory for the hot path (returns a decision); the
- * caller is responsible for marking DLQ and skipping the enqueue.
- */
-export declare class BudgetGuard {
-    private config;
-    private store;
-    constructor(config: AgentConfig["budget"], store: StateStore);
-    /**
-     * Inspect a card before we commit to picking it up. If any threshold
-     * is already exceeded, return a skip decision — the caller should
-     * apply the DLQ label (for `dlq`/`max_attempts`/`card_cost_cap`) or
-     * simply hold until the daily budget resets (`daily_budget`).
-     */
-    check(cardId: string): GuardDecision;
-    /**
-     * Does the guard's decision warrant a permanent DLQ marker? The daily
-     * budget is *not* permanent — it resets at UTC midnight — so we only
-     * DLQ for terminal states.
-     */
-    isTerminal(reason: GuardReason): boolean;
-    /**
-     * Apply the DLQ label to a card, persist the reason, and append a
-     * post-mortem block to the card description listing the last 3 failure
-     * summaries. Safe to call repeatedly — labels are idempotent and the
-     * description block is delimited so reruns replace rather than stack.
-     */
-    markDlq(client: HarmonyApiClient, card: Card, reason: GuardReason, detail: string): Promise<void>;
-}

package/dist/budget.js

@@ -1,161 +0,0 @@
-import { log } from "./log.js";
-import { runTransition } from "./transitions.js";
-const TAG = "budget";
-/**
- * BudgetGuard is consulted on every pickup and on every run start.
- * It protects the daemon from three failure modes:
- *   1. Cards that can never succeed (DLQ after N failed attempts).
- *   2. Cards that burn unbounded tokens on a single attempt.
- *   3. Runaway daily spend across the entire daemon.
- *
- * The guard is advisory for the hot path (returns a decision); the
- * caller is responsible for marking DLQ and skipping the enqueue.
- */
-export class BudgetGuard {
-    config;
-    store;
-    constructor(config, store) {
-        this.config = config;
-        this.store = store;
-    }
-    /**
-     * Inspect a card before we commit to picking it up. If any threshold
-     * is already exceeded, return a skip decision — the caller should
-     * apply the DLQ label (for `dlq`/`max_attempts`/`card_cost_cap`) or
-     * simply hold until the daily budget resets (`daily_budget`).
-     */
-    check(cardId) {
-        if (this.store.isDlq(cardId)) {
-            const rec = this.store.getCard(cardId);
-            return {
-                allow: false,
-                reason: "dlq",
-                detail: rec?.dlqReason ?? "previously marked DLQ",
-            };
-        }
-        const card = this.store.getCard(cardId);
-        if (card) {
-            if (card.attempts >= this.config.maxAttemptsPerCard) {
-                return {
-                    allow: false,
-                    reason: "max_attempts",
-                    detail: `${card.attempts} of ${this.config.maxAttemptsPerCard} attempts exhausted`,
-                };
-            }
-            if (card.totalCostCents >= this.config.maxCentsPerCard) {
-                return {
-                    allow: false,
-                    reason: "card_cost_cap",
-                    detail: `spent ${formatCents(card.totalCostCents)} of ${formatCents(this.config.maxCentsPerCard)} per-card cap`,
-                };
-            }
-        }
-        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 };
-    }
-    /**
-     * Does the guard's decision warrant a permanent DLQ marker? The daily
-     * budget is *not* permanent — it resets at UTC midnight — so we only
-     * DLQ for terminal states.
-     */
-    isTerminal(reason) {
-        return (reason === "dlq" ||
-            reason === "max_attempts" ||
-            reason === "card_cost_cap");
-    }
-    /**
-     * Apply the DLQ label to a card, persist the reason, and append a
-     * post-mortem block to the card description listing the last 3 failure
-     * summaries. Safe to call repeatedly — labels are idempotent and the
-     * description block is delimited so reruns replace rather than stack.
-     */
-    async markDlq(client, card, reason, detail) {
-        await this.store.markDlq(card.id, `${reason}: ${detail}`);
-        try {
-            await runTransition(client, card, {
-                addLabels: [
-                    { name: this.config.dlqLabel, color: this.config.dlqLabelColor },
-                ],
-            });
-        }
-        catch (err) {
-            log.warn(TAG, `failed to add dlq label to #${card.short_id}: ${err instanceof Error ? err.message : err}`);
-        }
-        try {
-            const recent = this.store.getRecentFailures(card.id, 3);
-            const block = buildDlqDescriptionBlock(reason, detail, recent);
-            const existing = card.description ?? "";
-            const stripped = stripDlqBlock(existing);
-            await client.updateCard(card.id, {
-                description: `${stripped}${stripped ? "\n\n" : ""}${block}`,
-            });
-        }
-        catch (err) {
-            log.warn(TAG, `failed to post DLQ summary to #${card.short_id}: ${err instanceof Error ? err.message : err}`);
-        }
-        log.warn(TAG, `#${card.short_id} DLQ'd — ${reason}: ${detail}`);
-    }
-}
-const DLQ_FENCE_START = "<!-- agent-dlq:start -->";
-const DLQ_FENCE_END = "<!-- agent-dlq:end -->";
-// Legacy marker — pre-fence DLQ blocks written before 2026-05-23. Strip path
-// only; new blocks always emit the fenced form.
-const LEGACY_DLQ_MARKER = "---\n**Agent DLQ**";
-function buildDlqDescriptionBlock(reason, detail, failures) {
-    const lines = [
-        DLQ_FENCE_START,
-        "---",
-        "**Agent DLQ**",
-        `Cap hit: ${reason} — ${detail}`,
-    ];
-    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._");
-    }
-    lines.push(DLQ_FENCE_END);
-    return lines.join("\n");
-}
-function stripDlqBlock(description) {
-    const start = description.indexOf(DLQ_FENCE_START);
-    if (start >= 0) {
-        const end = description.indexOf(DLQ_FENCE_END, start);
-        if (end < 0) {
-            // Malformed: opening fence with no closer. Treat the rest of the
-            // description as the block — safer than preserving an orphan fence.
-            return description.slice(0, start).trimEnd();
-        }
-        const prefix = description.slice(0, start).trimEnd();
-        const suffix = description
-            .slice(end + DLQ_FENCE_END.length)
-            .replace(/^\s+/, "");
-        if (prefix && suffix)
-            return `${prefix}\n\n${suffix}`;
-        return prefix || suffix;
-    }
-    // Legacy unfenced block — match the original behavior (no suffix to
-    // preserve, since the legacy emitter always wrote to end-of-description).
-    const legacy = description.indexOf(LEGACY_DLQ_MARKER);
-    if (legacy >= 0)
-        return description.slice(0, legacy).trimEnd();
-    return description.trimEnd();
-}
-function formatCents(cents) {
-    return `$${(cents / 100).toFixed(2)}`;
-}

package/dist/cli.d.ts

@@ -1,16 +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
- *   dlq list        — print DLQ entries
- *   dlq clear <id>  — clear a card's DLQ mark
- *   help            — show usage
- */
-export {};

package/dist/completion.d.ts

@@ -1,32 +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;
-    filesRead: number;
-    toolCalls: number;
-    cost: CostUpdate | null;
-    /** Trimmed last assistant text — feeds the episode write hook (Phase 1.5). */
-    lastAssistantText?: 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<void>;