@10et/cli 1.0.0

package/dist/lib/kanban.js

@@ -0,0 +1,340 @@
+/**
+ * Kanban — append-only event log for task board state
+ *
+ * Unix philosophy: .jfl/kanban.jsonl is the source of truth.
+ * Everything else (CLI, dashboard, API) is a view.
+ *
+ * @purpose Kanban data layer — create, move, pick, list cards
+ */
+import { readFileSync, appendFileSync, existsSync, mkdirSync } from "fs";
+import { join } from "path";
+import { randomUUID } from "crypto";
+/** Fire-and-forget MAP event to Context Hub */
+async function emitKanbanEvent(projectRoot, eventType, data) {
+    try {
+        const configPath = join(projectRoot, ".jfl", "config.json");
+        if (!existsSync(configPath))
+            return;
+        const config = JSON.parse(readFileSync(configPath, "utf-8"));
+        const port = config.hub_port ?? 4242;
+        const tokenPath = join(projectRoot, ".jfl", "hub-token");
+        const token = existsSync(tokenPath) ? readFileSync(tokenPath, "utf-8").trim() : "";
+        fetch(`http://localhost:${port}/api/events`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json", ...(token ? { Authorization: `Bearer ${token}` } : {}) },
+            body: JSON.stringify({ type: `kanban:${eventType}`, source: "kanban", data }),
+            signal: AbortSignal.timeout(3000),
+        }).catch(() => { });
+    }
+    catch { }
+}
+const COLUMNS = ["backlog", "in_progress", "eval", "done", "archived"];
+export class Kanban {
+    logPath;
+    projectRoot;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+        const jflDir = join(projectRoot, ".jfl");
+        if (!existsSync(jflDir))
+            mkdirSync(jflDir, { recursive: true });
+        this.logPath = join(jflDir, "kanban.jsonl");
+    }
+    append(event) {
+        appendFileSync(this.logPath, JSON.stringify(event) + "\n");
+    }
+    readEvents() {
+        if (!existsSync(this.logPath))
+            return [];
+        return readFileSync(this.logPath, "utf-8")
+            .split("\n")
+            .filter(Boolean)
+            .map(line => {
+            try {
+                return JSON.parse(line);
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter(Boolean);
+    }
+    /** Replay events to get current card state */
+    getCards() {
+        const events = this.readEvents();
+        const cards = new Map();
+        for (const e of events) {
+            switch (e.action) {
+                case "create": {
+                    const meta = e.metadata ?? {};
+                    cards.set(e.id, {
+                        id: e.id,
+                        title: e.title ?? "",
+                        description: e.description ?? "",
+                        column: e.column ?? "backlog",
+                        source: e.source ?? "human",
+                        agent: e.agent ?? "",
+                        priority: e.priority ?? 0,
+                        score: null,
+                        scope: e.scope ?? meta.scope ?? "",
+                        labels: e.labels ?? meta.labels ?? [],
+                        createdAt: e.ts,
+                        updatedAt: e.ts,
+                        metadata: meta,
+                        links: {
+                            journal: meta.journal_entry_id,
+                            eval: meta.eval_agent,
+                            pr: meta.pr_number,
+                            pr_url: meta.pr_url,
+                            violation: meta.violation,
+                            session: meta.session_id,
+                            docs: meta.docs,
+                        },
+                    });
+                    break;
+                }
+                case "move":
+                case "pick":
+                case "done": {
+                    const card = cards.get(e.id);
+                    if (!card)
+                        break;
+                    if (e.action === "done")
+                        card.column = "done";
+                    else if (e.action === "pick")
+                        card.column = "in_progress";
+                    else if (e.column)
+                        card.column = e.column;
+                    if (e.agent)
+                        card.agent = e.agent;
+                    if (e.score !== undefined)
+                        card.score = e.score;
+                    card.updatedAt = e.ts;
+                    if (e.metadata)
+                        card.metadata = { ...card.metadata, ...e.metadata };
+                    break;
+                }
+                case "archive": {
+                    const card = cards.get(e.id);
+                    if (card) {
+                        card.column = "archived";
+                        card.updatedAt = e.ts;
+                    }
+                    break;
+                }
+                case "update": {
+                    const card = cards.get(e.id);
+                    if (!card)
+                        break;
+                    if (e.title)
+                        card.title = e.title;
+                    if (e.description)
+                        card.description = e.description;
+                    if (e.priority !== undefined)
+                        card.priority = e.priority;
+                    if (e.scope)
+                        card.scope = e.scope;
+                    if (e.labels)
+                        card.labels = e.labels;
+                    if (e.metadata) {
+                        card.metadata = { ...card.metadata, ...e.metadata };
+                        // Update links from metadata
+                        const m = e.metadata;
+                        if (m.journal_entry_id)
+                            card.links.journal = m.journal_entry_id;
+                        if (m.eval_agent)
+                            card.links.eval = m.eval_agent;
+                        if (m.pr_number)
+                            card.links.pr = m.pr_number;
+                        if (m.pr_url)
+                            card.links.pr_url = m.pr_url;
+                        if (m.violation)
+                            card.links.violation = m.violation;
+                        if (m.session_id)
+                            card.links.session = m.session_id;
+                        if (m.docs)
+                            card.links.docs = m.docs;
+                    }
+                    card.updatedAt = e.ts;
+                    break;
+                }
+            }
+        }
+        return [...cards.values()];
+    }
+    /** Get cards, optionally filtered by scope or label */
+    getFiltered(opts) {
+        let cards = this.getCards();
+        if (opts?.scope)
+            cards = cards.filter(c => c.scope === opts.scope || c.scope === "");
+        if (opts?.label)
+            cards = cards.filter(c => c.labels.includes(opts.label));
+        if (opts?.source)
+            cards = cards.filter(c => c.source === opts.source);
+        return cards;
+    }
+    /** Get cards grouped by column */
+    getBoard(filter) {
+        const cards = filter ? this.getFiltered(filter) : this.getCards();
+        const board = {
+            backlog: [], in_progress: [], eval: [], done: [], archived: [],
+        };
+        for (const card of cards) {
+            const col = (COLUMNS.includes(card.column) ? card.column : "backlog");
+            board[col].push(card);
+        }
+        // Sort each column by priority (higher first), then by updatedAt
+        for (const col of COLUMNS) {
+            board[col].sort((a, b) => b.priority - a.priority || a.updatedAt.localeCompare(b.updatedAt));
+        }
+        return board;
+    }
+    /** Create a new card */
+    create(opts) {
+        const id = `k_${randomUUID().slice(0, 8)}`;
+        // Auto-detect scope from config if not provided
+        const scope = opts.scope ?? this.getDefaultScope();
+        if (scope && !this.isValidScope(scope)) {
+            const valid = this.getValidScopes();
+            throw new Error(`Invalid scope "${scope}". Valid scopes: ${valid.join(", ")}`);
+        }
+        this.append({
+            ts: new Date().toISOString(),
+            action: "create",
+            id,
+            title: opts.title,
+            description: opts.description,
+            column: "backlog",
+            source: opts.source ?? "human",
+            agent: opts.agent,
+            priority: opts.priority ?? 0,
+            scope,
+            labels: opts.labels,
+            metadata: opts.metadata,
+        });
+        emitKanbanEvent(this.projectRoot, "card:created", { id, title: opts.title, source: opts.source ?? "human", priority: opts.priority ?? 0, scope });
+        return id;
+    }
+    /** Get the default scope from .jfl/config.json */
+    getDefaultScope() {
+        try {
+            const configPath = join(this.projectRoot, ".jfl", "config.json");
+            if (!existsSync(configPath))
+                return "";
+            const config = JSON.parse(readFileSync(configPath, "utf-8"));
+            return config.name ?? "";
+        }
+        catch {
+            return "";
+        }
+    }
+    /** Read the workspace config (.jfl/config.json) */
+    readConfig() {
+        try {
+            const configPath = join(this.projectRoot, ".jfl", "config.json");
+            if (!existsSync(configPath))
+                return {};
+            return JSON.parse(readFileSync(configPath, "utf-8"));
+        }
+        catch {
+            return {};
+        }
+    }
+    /** Get registered services from config (the source of truth for scopes) */
+    getRegisteredServices() {
+        const config = this.readConfig();
+        return (config.registered_services ?? []).map((s) => ({
+            name: s.name ?? "",
+            path: s.path ?? "",
+            type: s.type ?? "",
+        }));
+    }
+    /** Get registered agents from config */
+    getRegisteredAgents() {
+        const config = this.readConfig();
+        return (config.openclaw_agents ?? []).map((a) => ({
+            id: a.id ?? "",
+            runtime: a.runtime ?? "",
+        }));
+    }
+    /** Get workspace type and name */
+    getWorkspaceInfo() {
+        const config = this.readConfig();
+        return { name: config.name ?? "", type: config.type ?? "standalone" };
+    }
+    /** Valid scopes = registered service names */
+    getValidScopes() {
+        return this.getRegisteredServices().map(s => s.name).filter(Boolean);
+    }
+    /** Validate scope against registered services */
+    isValidScope(scope) {
+        if (!scope)
+            return true;
+        const valid = this.getValidScopes();
+        if (valid.length === 0)
+            return true;
+        return valid.includes(scope);
+    }
+    /** Move a card to a column */
+    move(id, column, opts) {
+        this.append({
+            ts: new Date().toISOString(),
+            action: "move",
+            id,
+            column,
+            agent: opts?.agent,
+            score: opts?.score,
+        });
+        emitKanbanEvent(this.projectRoot, "card:moved", { id, column, agent: opts?.agent, score: opts?.score });
+    }
+    /** Agent picks top card from backlog */
+    pick(agentName) {
+        const board = this.getBoard();
+        const top = board.backlog[0];
+        if (!top)
+            return null;
+        this.append({
+            ts: new Date().toISOString(),
+            action: "pick",
+            id: top.id,
+            agent: agentName,
+        });
+        top.column = "in_progress";
+        top.agent = agentName ?? top.agent;
+        emitKanbanEvent(this.projectRoot, "card:picked", { id: top.id, title: top.title, agent: agentName });
+        return top;
+    }
+    /** Mark card done */
+    done(id, opts) {
+        this.append({
+            ts: new Date().toISOString(),
+            action: "done",
+            id,
+            score: opts?.score,
+            agent: opts?.agent,
+        });
+        emitKanbanEvent(this.projectRoot, "card:done", { id, score: opts?.score, agent: opts?.agent });
+    }
+    /** Import cards from jfl setup recommendations or verify violations */
+    importFromSetup(recommendations) {
+        return recommendations.map(rec => this.create({
+            title: rec.name,
+            description: rec.rationale,
+            source: "setup",
+            priority: Math.round(rec.confidence * 10),
+            metadata: { confidence: rec.confidence },
+        }));
+    }
+    importFromViolations(violations) {
+        return violations.map(v => this.create({
+            title: `TLC violation: ${v.invariant}`,
+            description: v.trace,
+            source: "verify",
+            priority: 10, // violations are high priority
+        }));
+    }
+    /** Get log path for piping */
+    get path() { return this.logPath; }
+    /** Get column names */
+    static get columns() { return COLUMNS; }
+}
+//# sourceMappingURL=kanban.js.map

package/dist/lib/kanban.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kanban.js","sourceRoot":"","sources":["../../src/lib/kanban.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAA;AACxE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAEnC,+CAA+C;AAC/C,KAAK,UAAU,eAAe,CAC5B,WAAmB,EACnB,SAAiB,EACjB,IAA6B;IAE7B,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,CAAC,CAAA;QAC3D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAM;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAA;QAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAA;QACpC,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,CAAA;QACxD,MAAM,KAAK,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAElF,KAAK,CAAC,oBAAoB,IAAI,aAAa,EAAE;YAC3C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;YACvG,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,SAAS,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC7E,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;SAClC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IACpB,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;AACZ,CAAC;AA8CD,MAAM,OAAO,GAAa,CAAC,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,CAAA;AAEhF,MAAM,OAAO,MAAM;IACT,OAAO,CAAQ;IACf,WAAW,CAAQ;IAE3B,YAAY,WAAmB;QAC7B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;QACxC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC/D,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IAC7C,CAAC;IAEO,MAAM,CAAC,KAAkB;QAC/B,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAA;IAC5D,CAAC;IAEO,UAAU;QAChB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,EAAE,CAAA;QACxC,OAAO,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC;aACvC,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,OAAO,CAAC;aACf,GAAG,CAAC,IAAI,CAAC,EAAE;YACV,IAAI,CAAC;gBAAC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAAC,CAAC;YAC/B,MAAM,CAAC;gBAAC,OAAO,IAAI,CAAA;YAAC,CAAC;QACvB,CAAC,CAAC;aACD,MAAM,CAAC,OAAO,CAAkB,CAAA;IACrC,CAAC;IAED,8CAA8C;IAC9C,QAAQ;QACN,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAA;QAChC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAA;QAE3C,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC;gBACjB,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACd,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAA;oBAC7B,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;wBACd,EAAE,EAAE,CAAC,CAAC,EAAE;wBACR,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;wBACpB,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE;wBAChC,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,SAAS;wBAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,OAAO;wBAC3B,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;wBACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,CAAC;wBACzB,KAAK,EAAE,IAAI;wBACX,KAAK,EAAE,CAAC,CAAC,KAAK,IAAK,IAAI,CAAC,KAAgB,IAAI,EAAE;wBAC9C,MAAM,EAAE,CAAC,CAAC,MAAM,IAAK,IAAI,CAAC,MAAmB,IAAI,EAAE;wBACnD,SAAS,EAAE,CAAC,CAAC,EAAE;wBACf,SAAS,EAAE,CAAC,CAAC,EAAE;wBACf,QAAQ,EAAE,IAAI;wBACd,KAAK,EAAE;4BACL,OAAO,EAAE,IAAI,CAAC,gBAAsC;4BACpD,IAAI,EAAE,IAAI,CAAC,UAAgC;4BAC3C,EAAE,EAAE,IAAI,CAAC,SAA+B;4BACxC,MAAM,EAAE,IAAI,CAAC,MAA4B;4BACzC,SAAS,EAAE,IAAI,CAAC,SAA+B;4BAC/C,OAAO,EAAE,IAAI,CAAC,UAAgC;4BAC9C,IAAI,EAAE,IAAI,CAAC,IAA4B;yBACxC;qBACF,CAAC,CAAA;oBACF,MAAK;gBACP,CAAC;gBACD,KAAK,MAAM,CAAC;gBACZ,KAAK,MAAM,CAAC;gBACZ,KAAK,MAAM,CAAC,CAAC,CAAC;oBACZ,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;oBAC5B,IAAI,CAAC,IAAI;wBAAE,MAAK;oBAChB,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM;wBAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;yBACxC,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM;wBAAE,IAAI,CAAC,MAAM,GAAG,aAAa,CAAA;yBACpD,IAAI,CAAC,CAAC,MAAM;wBAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAA;oBACzC,IAAI,CAAC,CAAC,KAAK;wBAAE,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAA;oBACjC,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS;wBAAE,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAA;oBAC/C,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,CAAA;oBACrB,IAAI,CAAC,CAAC,QAAQ;wBAAE,IAAI,CAAC,QAAQ,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAA;oBACnE,MAAK;gBACP,CAAC;gBACD,KAAK,SAAS,CAAC,CAAC,CAAC;oBACf,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;oBAC5B,IAAI,IAAI,EAAE,CAAC;wBAAC,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC;wBAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,CAAA;oBAAC,CAAC;oBAC7D,MAAK;gBACP,CAAC;gBACD,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACd,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;oBAC5B,IAAI,CAAC,IAAI;wBAAE,MAAK;oBAChB,IAAI,CAAC,CAAC,KAAK;wBAAE,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAA;oBACjC,IAAI,CAAC,CAAC,WAAW;wBAAE,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAA;oBACnD,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS;wBAAE,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAA;oBACxD,IAAI,CAAC,CAAC,KAAK;wBAAE,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAA;oBACjC,IAAI,CAAC,CAAC,MAAM;wBAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAA;oBACpC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;wBACf,IAAI,CAAC,QAAQ,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAA;wBACnD,6BAA6B;wBAC7B,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAA;wBACpB,IAAI,CAAC,CAAC,gBAAgB;4BAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,gBAA0B,CAAA;wBACzE,IAAI,CAAC,CAAC,UAAU;4BAAE,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,UAAoB,CAAA;wBAC1D,IAAI,CAAC,CAAC,SAAS;4BAAE,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,SAAmB,CAAA;wBACtD,IAAI,CAAC,CAAC,MAAM;4BAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,MAAgB,CAAA;wBACpD,IAAI,CAAC,CAAC,SAAS;4BAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,SAAmB,CAAA;wBAC7D,IAAI,CAAC,CAAC,UAAU;4BAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,UAAoB,CAAA;wBAC7D,IAAI,CAAC,CAAC,IAAI;4BAAE,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,IAAgB,CAAA;oBAClD,CAAC;oBACD,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,CAAA;oBACrB,MAAK;gBACP,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;IAC5B,CAAC;IAED,uDAAuD;IACvD,WAAW,CAAC,IAA0D;QACpE,IAAI,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAA;QAC3B,IAAI,IAAI,EAAE,KAAK;YAAE,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,CAAA;QACpF,IAAI,IAAI,EAAE,KAAK;YAAE,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAM,CAAC,CAAC,CAAA;QAC1E,IAAI,IAAI,EAAE,MAAM;YAAE,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,CAAA;QACrE,OAAO,KAAK,CAAA;IACd,CAAC;IAED,kCAAkC;IAClC,QAAQ,CAAC,MAA4D;QACnE,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAA;QACjE,MAAM,KAAK,GAAiC;YAC1C,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE;SAC/D,CAAA;QACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAW,CAAA;YACzF,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACvB,CAAC;QACD,iEAAiE;QACjE,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAA;QAC9F,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IAED,wBAAwB;IACxB,MAAM,CAAC,IASN;QACC,MAAM,EAAE,GAAG,KAAK,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAA;QAC1C,gDAAgD;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,eAAe,EAAE,CAAA;QAClD,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,EAAE,CAAA;YACnC,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,oBAAoB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAChF,CAAC;QACD,IAAI,CAAC,MAAM,CAAC;YACV,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5B,MAAM,EAAE,QAAQ;YAChB,EAAE;YACF,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,OAAO;YAC9B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,CAAC;YAC5B,KAAK;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAA;QACF,eAAe,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;QACjJ,OAAO,EAAE,CAAA;IACX,CAAC;IAED,kDAAkD;IAC1C,eAAe;QACrB,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,CAAC,CAAA;YAChE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;gBAAE,OAAO,EAAE,CAAA;YACtC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAA;YAC5D,OAAO,MAAM,CAAC,IAAI,IAAI,EAAE,CAAA;QAC1B,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,EAAE,CAAA;QAAC,CAAC;IACvB,CAAC;IAED,mDAAmD;IAC3C,UAAU;QAChB,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,CAAC,CAAA;YAChE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;gBAAE,OAAO,EAAE,CAAA;YACtC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAA;QACtD,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,EAAE,CAAA;QAAC,CAAC;IACvB,CAAC;IAED,2EAA2E;IAC3E,qBAAqB;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAA;QAChC,OAAO,CAAC,MAAM,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;YACzD,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE;YAClB,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE;YAClB,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE;SACnB,CAAC,CAAC,CAAA;IACL,CAAC;IAED,wCAAwC;IACxC,mBAAmB;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAA;QAChC,OAAO,CAAC,MAAM,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;YACrD,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE;YACd,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE;SACzB,CAAC,CAAC,CAAA;IACL,CAAC;IAED,kCAAkC;IAClC,gBAAgB;QACd,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAA;QAChC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,YAAY,EAAE,CAAA;IACvE,CAAC;IAED,8CAA8C;IAC9C,cAAc;QACZ,OAAO,IAAI,CAAC,qBAAqB,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACtE,CAAC;IAED,iDAAiD;IACjD,YAAY,CAAC,KAAa;QACxB,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAA;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,EAAE,CAAA;QACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAA;QACnC,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC9B,CAAC;IAED,8BAA8B;IAC9B,IAAI,CAAC,EAAU,EAAE,MAAc,EAAE,IAAyC;QACxE,IAAI,CAAC,MAAM,CAAC;YACV,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5B,MAAM,EAAE,MAAM;YACd,EAAE;YACF,MAAM;YACN,KAAK,EAAE,IAAI,EAAE,KAAK;YAClB,KAAK,EAAE,IAAI,EAAE,KAAK;SACnB,CAAC,CAAA;QACF,eAAe,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IACzG,CAAC;IAED,wCAAwC;IACxC,IAAI,CAAC,SAAkB;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAA;QAC7B,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;QAC5B,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAA;QACrB,IAAI,CAAC,MAAM,CAAC;YACV,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5B,MAAM,EAAE,MAAM;YACd,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,KAAK,EAAE,SAAS;SACjB,CAAC,CAAA;QACF,GAAG,CAAC,MAAM,GAAG,aAAa,CAAA;QAC1B,GAAG,CAAC,KAAK,GAAG,SAAS,IAAI,GAAG,CAAC,KAAK,CAAA;QAClC,eAAe,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;QACpG,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,qBAAqB;IACrB,IAAI,CAAC,EAAU,EAAE,IAAyC;QACxD,IAAI,CAAC,MAAM,CAAC;YACV,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5B,MAAM,EAAE,MAAM;YACd,EAAE;YACF,KAAK,EAAE,IAAI,EAAE,KAAK;YAClB,KAAK,EAAE,IAAI,EAAE,KAAK;SACnB,CAAC,CAAA;QACF,eAAe,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IAChG,CAAC;IAED,uEAAuE;IACvE,eAAe,CAAC,eAA+E;QAC7F,OAAO,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAC/B,IAAI,CAAC,MAAM,CAAC;YACV,KAAK,EAAE,GAAG,CAAC,IAAI;YACf,WAAW,EAAE,GAAG,CAAC,SAAS;YAC1B,MAAM,EAAE,OAAO;YACf,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,GAAG,EAAE,CAAC;YACzC,QAAQ,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE;SACzC,CAAC,CACH,CAAA;IACH,CAAC;IAED,oBAAoB,CAAC,UAAuD;QAC1E,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CACxB,IAAI,CAAC,MAAM,CAAC;YACV,KAAK,EAAE,kBAAkB,CAAC,CAAC,SAAS,EAAE;YACtC,WAAW,EAAE,CAAC,CAAC,KAAK;YACpB,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,EAAE,EAAE,+BAA+B;SAC9C,CAAC,CACH,CAAA;IACH,CAAC;IAED,8BAA8B;IAC9B,IAAI,IAAI,KAAa,OAAO,IAAI,CAAC,OAAO,CAAA,CAAC,CAAC;IAE1C,uBAAuB;IACvB,MAAM,KAAK,OAAO,KAAe,OAAO,OAAO,CAAA,CAAC,CAAC;CAClD"}

package/dist/lib/kuva.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Kuva Terminal Plotting
+ *
+ * Pipes structured data to the kuva CLI for terminal-rendered plots.
+ * Kuva is a Rust scientific plotting tool (github.com/Psy-Fer/kuva).
+ *
+ * @purpose Bridge between JFL data (telemetry, arena, RL, events) and terminal visualization via kuva
+ */
+export interface BarEntry {
+    label: string;
+    value: number;
+}
+export interface ScatterPoint {
+    x: number;
+    y: number;
+    label?: string;
+}
+export interface TimeSeriesPoint {
+    ts: string;
+    value: number;
+    series?: string;
+}
+export declare function isKuvaInstalled(): boolean;
+export declare function barChart(entries: BarEntry[], title?: string): string | null;
+export declare function scatterPlot(points: ScatterPoint[], title?: string): string | null;
+export declare function linePlot(points: TimeSeriesPoint[], title?: string): string | null;
+/**
+ * Render a simple ASCII bar chart without kuva dependency.
+ * Fallback for when kuva isn't installed, and useful for agents
+ * that want zero-dependency terminal visualization.
+ */
+export declare function asciiBars(entries: BarEntry[], opts?: {
+    width?: number;
+    title?: string;
+}): string;
+/**
+ * Render a sparkline for time-series data.
+ * Single line of Unicode block characters showing trend.
+ */
+export declare function sparkline(values: number[]): string;
+/**
+ * Render data using kuva if available, fall back to ASCII.
+ */
+export declare function renderBars(entries: BarEntry[], title?: string): string;
+//# sourceMappingURL=kuva.d.ts.map

package/dist/lib/kuva.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kuva.d.ts","sourceRoot":"","sources":["../../src/lib/kuva.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,wBAAgB,eAAe,IAAI,OAAO,CAOzC;AAsBD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW3E;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYjF;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAejF;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAiBhG;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAOlD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAMtE"}

package/dist/lib/kuva.js

@@ -0,0 +1,131 @@
+/**
+ * Kuva Terminal Plotting
+ *
+ * Pipes structured data to the kuva CLI for terminal-rendered plots.
+ * Kuva is a Rust scientific plotting tool (github.com/Psy-Fer/kuva).
+ *
+ * @purpose Bridge between JFL data (telemetry, arena, RL, events) and terminal visualization via kuva
+ */
+import { execSync, spawnSync } from 'child_process';
+export function isKuvaInstalled() {
+    try {
+        execSync('which kuva', { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function toTsv(headers, rows) {
+    const lines = [headers.join('\t')];
+    for (const row of rows) {
+        lines.push(row.join('\t'));
+    }
+    return lines.join('\n');
+}
+function runKuva(plotType, tsv, args) {
+    const result = spawnSync('kuva', [plotType, ...args, '--terminal'], {
+        input: tsv,
+        encoding: 'utf-8',
+        timeout: 10000,
+    });
+    if (result.status !== 0) {
+        return null;
+    }
+    return result.stdout || null;
+}
+export function barChart(entries, title) {
+    if (entries.length === 0)
+        return null;
+    const tsv = toTsv(['label', 'value'], entries.map(e => [e.label, String(e.value)]));
+    const args = ['--label-col', 'label', '--value-col', 'value'];
+    if (title)
+        args.push('--title', title);
+    const output = runKuva('bar', tsv, args);
+    if (!output)
+        return null;
+    return output;
+}
+export function scatterPlot(points, title) {
+    if (points.length === 0)
+        return null;
+    const hasGroups = points.some(p => p.label);
+    const headers = hasGroups ? ['x', 'y', 'group'] : ['x', 'y'];
+    const rows = points.map(p => hasGroups ? [String(p.x), String(p.y), p.label || ''] : [String(p.x), String(p.y)]);
+    const tsv = toTsv(headers, rows);
+    const args = ['--x', 'x', '--y', 'y'];
+    if (hasGroups)
+        args.push('--color-by', 'group');
+    if (title)
+        args.push('--title', title);
+    const output = runKuva('scatter', tsv, args);
+    if (!output)
+        return null;
+    return output;
+}
+export function linePlot(points, title) {
+    if (points.length === 0)
+        return null;
+    const hasSeries = points.some(p => p.series);
+    const headers = hasSeries ? ['step', 'value', 'series'] : ['step', 'value'];
+    const rows = points.map((p, i) => hasSeries
+        ? [String(i), String(p.value), p.series || '']
+        : [String(i), String(p.value)]);
+    const tsv = toTsv(headers, rows);
+    const args = ['--x', 'step', '--y', 'value'];
+    if (hasSeries)
+        args.push('--color-by', 'series');
+    if (title)
+        args.push('--title', title);
+    const output = runKuva('line', tsv, args);
+    if (!output)
+        return null;
+    return output;
+}
+/**
+ * Render a simple ASCII bar chart without kuva dependency.
+ * Fallback for when kuva isn't installed, and useful for agents
+ * that want zero-dependency terminal visualization.
+ */
+export function asciiBars(entries, opts) {
+    if (entries.length === 0)
+        return '';
+    const width = opts?.width ?? 40;
+    const maxVal = Math.max(...entries.map(e => e.value));
+    const maxLabelLen = Math.max(...entries.map(e => e.label.length), 5);
+    const lines = [];
+    if (opts?.title)
+        lines.push(`  ${opts.title}`);
+    for (const entry of entries) {
+        const barLen = maxVal > 0 ? Math.round((entry.value / maxVal) * width) : 0;
+        const bar = '\u2588'.repeat(barLen);
+        const label = entry.label.padEnd(maxLabelLen);
+        lines.push(`  ${label} ${bar} ${entry.value}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Render a sparkline for time-series data.
+ * Single line of Unicode block characters showing trend.
+ */
+export function sparkline(values) {
+    if (values.length === 0)
+        return '';
+    const blocks = ['\u2581', '\u2582', '\u2583', '\u2584', '\u2585', '\u2586', '\u2587', '\u2588'];
+    const min = Math.min(...values);
+    const max = Math.max(...values);
+    const range = max - min || 1;
+    return values.map(v => blocks[Math.min(Math.floor(((v - min) / range) * 7), 7)]).join('');
+}
+/**
+ * Render data using kuva if available, fall back to ASCII.
+ */
+export function renderBars(entries, title) {
+    if (isKuvaInstalled()) {
+        const kuvaOutput = barChart(entries, title);
+        if (kuvaOutput)
+            return kuvaOutput;
+    }
+    return asciiBars(entries, { title });
+}
+//# sourceMappingURL=kuva.js.map

package/dist/lib/kuva.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kuva.js","sourceRoot":"","sources":["../../src/lib/kuva.ts"],"names":[],"mappings":"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"}

package/dist/lib/linear-client.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Linear Client Wrapper
+ *
+ * Typed helpers around the @linear/sdk LinearClient.
+ * Keeps API calls centralized and testable.
+ *
+ * @purpose Wrapper for Linear API — auth, teams, projects, issues
+ */
+import { LinearClient } from "@linear/sdk";
+export type { LinearClient };
+export declare function getLinearClient(apiKey: string): LinearClient;
+export interface LinearTeam {
+    id: string;
+    name: string;
+    key: string;
+}
+export interface LinearProject {
+    id: string;
+    name: string;
+    description?: string;
+}
+export interface LinearState {
+    id: string;
+    name: string;
+    type: string;
+    color: string;
+    position: number;
+}
+export interface LinearIssue {
+    id: string;
+    identifier: string;
+    title: string;
+    description?: string;
+    priority: number;
+    state: LinearState;
+    assignee?: {
+        id: string;
+        name: string;
+        email: string;
+    };
+    labels: Array<{
+        id: string;
+        name: string;
+        color: string;
+    }>;
+    url: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export declare function getLinearTeams(client: LinearClient): Promise<LinearTeam[]>;
+export declare function getLinearProjects(client: LinearClient, teamId: string): Promise<LinearProject[]>;
+export declare function getTeamStates(client: LinearClient, teamId: string): Promise<LinearState[]>;
+export declare function getLinearIssue(client: LinearClient, issueId: string): Promise<LinearIssue | null>;
+export declare function getProjectIssues(client: LinearClient, projectId: string): Promise<LinearIssue[]>;
+export interface CreateIssueInput {
+    title: string;
+    description?: string;
+    teamId: string;
+    projectId?: string;
+    stateId?: string;
+    priority?: number;
+    labelIds?: string[];
+    assigneeId?: string;
+}
+export declare function createLinearIssue(client: LinearClient, opts: CreateIssueInput): Promise<LinearIssue | null>;
+export interface UpdateIssueInput {
+    title?: string;
+    description?: string;
+    stateId?: string;
+    priority?: number;
+}
+export declare function updateLinearIssue(client: LinearClient, issueId: string, opts: UpdateIssueInput): Promise<boolean>;
+//# sourceMappingURL=linear-client.d.ts.map

package/dist/lib/linear-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear-client.d.ts","sourceRoot":"","sources":["../../src/lib/linear-client.ts"],"names":[],"mappings":"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"}