conatus 0.1.0

package/dist/adapters/github-issue-datasource.d.ts

@@ -0,0 +1,45 @@
+import type { IDataSourceAdapter } from "../observation/data-source-adapter.js";
+import type { DataSourceType, DataSourceConfig, DataSourceQuery, DataSourceResult } from "../types/data-source.js";
+interface GhDataSourceResult extends DataSourceResult {
+    error?: string;
+}
+export declare class GitHubIssueDataSourceAdapter implements IDataSourceAdapter {
+    readonly sourceType: DataSourceType;
+    readonly config: DataSourceConfig;
+    private ghPath;
+    constructor(config: DataSourceConfig, ghPath?: string);
+    get sourceId(): string;
+    /**
+     * Store the DataSourceConfig. Does not make network calls.
+     * gh CLI availability is checked at query/healthCheck time.
+     */
+    connect(): Promise<void>;
+    query(params: DataSourceQuery): Promise<GhDataSourceResult>;
+    getSupportedDimensions(): string[];
+    disconnect(): Promise<void>;
+    healthCheck(): Promise<boolean>;
+    private resolveRepo;
+    private resolveLabel;
+    /**
+     * Spawn `gh issue list` for a single state and call back with results.
+     * Uses a callback so the result can be returned synchronously inside
+     * the close handler — enabling proper test sequencing.
+     */
+    private queryOneState;
+    /**
+     * Spawn two `gh issue list` calls in sequence (open then closed) using
+     * nested callbacks so both spawns happen synchronously in the close handler
+     * chain — enabling proper test sequencing without microtask gaps.
+     */
+    private queryBothStates;
+    /**
+     * Low-level spawn helper using raw callbacks. The callback fires synchronously
+     * inside the close event handler so that nested spawns can be chained without
+     * microtask gaps.
+     */
+    private spawnList;
+    private buildListArgs;
+    private parseIssueList;
+}
+export {};
+//# sourceMappingURL=github-issue-datasource.d.ts.map

package/dist/adapters/github-issue-datasource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-issue-datasource.d.ts","sourceRoot":"","sources":["../../src/adapters/github-issue-datasource.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EACjB,MAAM,yBAAyB,CAAC;AAIjC,UAAU,kBAAmB,SAAQ,gBAAgB;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAcD,qBAAa,4BAA6B,YAAW,kBAAkB;IACrE,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAY;IAC/C,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAElC,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAE,MAAa;IAK3D,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAoH3D,sBAAsB,IAAI,MAAM,EAAE;IAI5B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAoC/B,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,YAAY;IAKpB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAgDrB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IA6BvB;;;;OAIG;IACH,OAAO,CAAC,SAAS;IA8CjB,OAAO,CAAC,aAAa;IA2BrB,OAAO,CAAC,cAAc;CAWvB"}

package/dist/adapters/github-issue-datasource.js

@@ -0,0 +1,329 @@
+// ─── GitHubIssueDataSourceAdapter ───
+//
+// IDataSourceAdapter implementation that observes GitHub issue state via the `gh` CLI.
+//
+// Supported dimension_name values:
+//   "open_issue_count"   — number of open issues matching the configured label
+//   "closed_issue_count" — number of closed issues matching the configured label
+//   "total_issue_count"  — open + closed
+//   "completion_ratio"   — closed / (open + closed); returns 0 if no issues exist
+//
+// Config fields used from DataSourceConfig:
+//   connection.repo   — "owner/name" repo identifier (optional; gh CLI auto-detects)
+//   dimension_mapping — optional map; key "_label" overrides the default label filter
+import { spawn } from "node:child_process";
+// ─── Adapter ───
+export class GitHubIssueDataSourceAdapter {
+    sourceType = "custom";
+    config;
+    ghPath;
+    constructor(config, ghPath = "gh") {
+        this.config = config;
+        this.ghPath = ghPath;
+    }
+    get sourceId() {
+        return this.config.id;
+    }
+    /**
+     * Store the DataSourceConfig. Does not make network calls.
+     * gh CLI availability is checked at query/healthCheck time.
+     */
+    async connect() {
+        // No-op network validation — gh CLI availability is checked at query/healthCheck time.
+    }
+    query(params) {
+        const config = this.config;
+        const repo = this.resolveRepo(config);
+        const label = this.resolveLabel(config);
+        const timeoutMs = params.timeout_ms ?? 10_000;
+        const sourceId = this.sourceId;
+        // Check dimension_mapping for redirect
+        const dimMapping = config.dimension_mapping ?? {};
+        const dimension = params.expression ?? params.dimension_name;
+        const resolvedDimension = dimMapping[dimension] ?? dimension;
+        // Unknown dimension — return immediately without spawning
+        const knownDimensions = new Set([
+            "open_issue_count",
+            "closed_issue_count",
+            "total_issue_count",
+            "completion_ratio",
+        ]);
+        if (!knownDimensions.has(resolvedDimension)) {
+            return Promise.resolve({
+                value: null,
+                raw: [],
+                timestamp: new Date().toISOString(),
+                source_id: sourceId,
+            });
+        }
+        // ── Dimensions that require only open issues ──────────────────────────
+        if (resolvedDimension === "open_issue_count") {
+            return this.queryOneState("open", repo, label, timeoutMs, (openIssues, err) => {
+                if (err !== null) {
+                    return {
+                        value: null,
+                        raw: [],
+                        timestamp: new Date().toISOString(),
+                        source_id: sourceId,
+                        error: err,
+                    };
+                }
+                return {
+                    value: openIssues.length,
+                    raw: openIssues,
+                    timestamp: new Date().toISOString(),
+                    source_id: sourceId,
+                };
+            });
+        }
+        if (resolvedDimension === "closed_issue_count") {
+            return this.queryOneState("closed", repo, label, timeoutMs, (closedIssues, err) => {
+                if (err !== null) {
+                    return {
+                        value: null,
+                        raw: [],
+                        timestamp: new Date().toISOString(),
+                        source_id: sourceId,
+                        error: err,
+                    };
+                }
+                return {
+                    value: closedIssues.length,
+                    raw: closedIssues,
+                    timestamp: new Date().toISOString(),
+                    source_id: sourceId,
+                };
+            });
+        }
+        // ── Dimensions that require both open and closed issues ───────────────
+        // (completion_ratio, total_issue_count)
+        return this.queryBothStates(repo, label, timeoutMs, (openIssues, closedIssues, err) => {
+            if (err !== null) {
+                return {
+                    value: null,
+                    raw: [],
+                    timestamp: new Date().toISOString(),
+                    source_id: sourceId,
+                    error: err,
+                };
+            }
+            const openCount = openIssues.length;
+            const closedCount = closedIssues.length;
+            const totalCount = openCount + closedCount;
+            const completionRatio = totalCount === 0 ? 0 : closedCount / totalCount;
+            const allIssues = [...openIssues, ...closedIssues];
+            let value;
+            switch (resolvedDimension) {
+                case "total_issue_count":
+                    value = totalCount;
+                    break;
+                case "completion_ratio":
+                    value = completionRatio;
+                    break;
+                default:
+                    value = 0;
+            }
+            return {
+                value,
+                raw: allIssues,
+                timestamp: new Date().toISOString(),
+                source_id: sourceId,
+                metadata: {
+                    open_count: openCount,
+                    closed_count: closedCount,
+                    total_count: totalCount,
+                    completion_ratio: completionRatio,
+                },
+            };
+        });
+    }
+    getSupportedDimensions() {
+        return ["open_issue_count", "closed_issue_count", "total_issue_count", "completion_ratio"];
+    }
+    async disconnect() {
+        // no-op
+    }
+    healthCheck() {
+        return new Promise((resolve) => {
+            let timedOut = false;
+            let resolved = false;
+            const child = spawn(this.ghPath, ["auth", "status"], {
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+            const timeoutHandle = setTimeout(() => {
+                timedOut = true;
+                child.kill("SIGTERM");
+            }, 8_000);
+            child.on("error", () => {
+                if (resolved)
+                    return;
+                resolved = true;
+                clearTimeout(timeoutHandle);
+                resolve(false);
+            });
+            child.on("close", (code) => {
+                if (resolved)
+                    return;
+                resolved = true;
+                clearTimeout(timeoutHandle);
+                if (timedOut) {
+                    resolve(false);
+                    return;
+                }
+                resolve(code === 0);
+            });
+        });
+    }
+    // ─── Private helpers ───
+    resolveRepo(config) {
+        // Use connection.repo if available, fallback to connection.url
+        const conn = config.connection;
+        const repo = conn["repo"];
+        if (typeof repo === "string" && repo.trim())
+            return repo.trim();
+        if (typeof config.connection.url === "string" && config.connection.url.trim()) {
+            return config.connection.url.trim();
+        }
+        return undefined;
+    }
+    resolveLabel(config) {
+        const mapping = config.dimension_mapping ?? {};
+        return mapping["_label"] ?? "motiva";
+    }
+    /**
+     * Spawn `gh issue list` for a single state and call back with results.
+     * Uses a callback so the result can be returned synchronously inside
+     * the close handler — enabling proper test sequencing.
+     */
+    queryOneState(state, repo, label, timeoutMs, cb) {
+        return new Promise((resolve) => {
+            let stdout = "";
+            let stderr = "";
+            let timedOut = false;
+            const args = this.buildListArgs(state, repo, label);
+            const child = spawn(this.ghPath, args, { stdio: ["ignore", "pipe", "pipe"] });
+            const timeoutHandle = setTimeout(() => {
+                timedOut = true;
+                child.kill("SIGTERM");
+            }, timeoutMs);
+            child.stdout.on("data", (chunk) => {
+                stdout += chunk.toString("utf8");
+            });
+            child.stderr.on("data", (chunk) => {
+                stderr += chunk.toString("utf8");
+            });
+            child.on("error", (err) => {
+                clearTimeout(timeoutHandle);
+                resolve(cb([], err.message));
+            });
+            child.on("close", (code) => {
+                clearTimeout(timeoutHandle);
+                if (timedOut) {
+                    resolve(cb([], `gh issue list timed out after ${timeoutMs}ms`));
+                    return;
+                }
+                if (code !== 0) {
+                    resolve(cb([], stderr.trim() || `gh issue list exited with code ${code}`));
+                    return;
+                }
+                resolve(cb(this.parseIssueList(stdout), null));
+            });
+        });
+    }
+    /**
+     * Spawn two `gh issue list` calls in sequence (open then closed) using
+     * nested callbacks so both spawns happen synchronously in the close handler
+     * chain — enabling proper test sequencing without microtask gaps.
+     */
+    queryBothStates(repo, label, timeoutMs, cb) {
+        return new Promise((resolve) => {
+            // First: fetch open issues
+            this.spawnList("open", repo, label, timeoutMs, (openIssues, openErr) => {
+                if (openErr !== null) {
+                    resolve(cb([], [], openErr));
+                    return;
+                }
+                // Second: fetch closed issues (spawned inside close handler of first)
+                this.spawnList("closed", repo, label, timeoutMs, (closedIssues, closedErr) => {
+                    if (closedErr !== null) {
+                        resolve(cb([], [], closedErr));
+                        return;
+                    }
+                    resolve(cb(openIssues, closedIssues, null));
+                });
+            });
+        });
+    }
+    /**
+     * Low-level spawn helper using raw callbacks. The callback fires synchronously
+     * inside the close event handler so that nested spawns can be chained without
+     * microtask gaps.
+     */
+    spawnList(state, repo, label, timeoutMs, cb) {
+        let stdout = "";
+        let stderr = "";
+        let timedOut = false;
+        const args = this.buildListArgs(state, repo, label);
+        const child = spawn(this.ghPath, args, { stdio: ["ignore", "pipe", "pipe"] });
+        const timeoutHandle = setTimeout(() => {
+            timedOut = true;
+            child.kill("SIGTERM");
+        }, timeoutMs);
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString("utf8");
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk.toString("utf8");
+        });
+        child.on("error", (err) => {
+            clearTimeout(timeoutHandle);
+            cb([], err.message);
+        });
+        child.on("close", (code) => {
+            clearTimeout(timeoutHandle);
+            if (timedOut) {
+                cb([], `gh issue list timed out after ${timeoutMs}ms`);
+                return;
+            }
+            if (code !== 0) {
+                cb([], stderr.trim() || `gh issue list exited with code ${code}`);
+                return;
+            }
+            cb(this.parseIssueList(stdout), null);
+        });
+    }
+    buildListArgs(state, repo, label) {
+        const args = [
+            "issue",
+            "list",
+            "--state",
+            state,
+            "--json",
+            "number,title,state,labels,createdAt",
+            "--limit",
+            "1000",
+        ];
+        if (label) {
+            args.push("--label", label);
+        }
+        if (repo) {
+            args.push("--repo", repo);
+        }
+        return args;
+    }
+    parseIssueList(stdout) {
+        const trimmed = stdout.trim();
+        if (!trimmed || trimmed === "null")
+            return [];
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (!Array.isArray(parsed))
+                return [];
+            return parsed;
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=github-issue-datasource.js.map

package/dist/adapters/github-issue-datasource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-issue-datasource.js","sourceRoot":"","sources":["../../src/adapters/github-issue-datasource.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,EAAE;AACF,uFAAuF;AACvF,EAAE;AACF,mCAAmC;AACnC,+EAA+E;AAC/E,iFAAiF;AACjF,yCAAyC;AACzC,kFAAkF;AAClF,EAAE;AACF,4CAA4C;AAC5C,qFAAqF;AACrF,sFAAsF;AAEtF,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAyB3C,kBAAkB;AAElB,MAAM,OAAO,4BAA4B;IAC9B,UAAU,GAAmB,QAAQ,CAAC;IACtC,MAAM,CAAmB;IAE1B,MAAM,CAAS;IAEvB,YAAY,MAAwB,EAAE,SAAiB,IAAI;QACzD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO;QACX,uFAAuF;IACzF,CAAC;IAED,KAAK,CAAC,MAAuB;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACxC,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAE/B,uCAAuC;QACvC,MAAM,UAAU,GAA2B,MAAM,CAAC,iBAAiB,IAAI,EAAE,CAAC;QAC1E,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,cAAc,CAAC;QAC7D,MAAM,iBAAiB,GAAG,UAAU,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC;QAE7D,0DAA0D;QAC1D,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;YAC9B,kBAAkB;YAClB,oBAAoB;YACpB,mBAAmB;YACnB,kBAAkB;SACnB,CAAC,CAAC;QAEH,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAC5C,OAAO,OAAO,CAAC,OAAO,CAAC;gBACrB,KAAK,EAAE,IAAI;gBACX,GAAG,EAAE,EAAE;gBACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,SAAS,EAAE,QAAQ;aACpB,CAAC,CAAC;QACL,CAAC;QAED,yEAAyE;QACzE,IAAI,iBAAiB,KAAK,kBAAkB,EAAE,CAAC;YAC7C,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,UAAU,EAAE,GAAG,EAAE,EAAE;gBAC5E,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;oBACjB,OAAO;wBACL,KAAK,EAAE,IAAI;wBACX,GAAG,EAAE,EAAE;wBACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;wBACnC,SAAS,EAAE,QAAQ;wBACnB,KAAK,EAAE,GAAG;qBACX,CAAC;gBACJ,CAAC;gBACD,OAAO;oBACL,KAAK,EAAE,UAAU,CAAC,MAAM;oBACxB,GAAG,EAAE,UAAU;oBACf,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,SAAS,EAAE,QAAQ;iBACpB,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,iBAAiB,KAAK,oBAAoB,EAAE,CAAC;YAC/C,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,YAAY,EAAE,GAAG,EAAE,EAAE;gBAChF,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;oBACjB,OAAO;wBACL,KAAK,EAAE,IAAI;wBACX,GAAG,EAAE,EAAE;wBACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;wBACnC,SAAS,EAAE,QAAQ;wBACnB,KAAK,EAAE,GAAG;qBACX,CAAC;gBACJ,CAAC;gBACD,OAAO;oBACL,KAAK,EAAE,YAAY,CAAC,MAAM;oBAC1B,GAAG,EAAE,YAAY;oBACjB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,SAAS,EAAE,QAAQ;iBACpB,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;QAED,yEAAyE;QACzE,wCAAwC;QACxC,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,EAAE,EAAE;YACpF,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gBACjB,OAAO;oBACL,KAAK,EAAE,IAAI;oBACX,GAAG,EAAE,EAAE;oBACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,SAAS,EAAE,QAAQ;oBACnB,KAAK,EAAE,GAAG;iBACX,CAAC;YACJ,CAAC;YAED,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC;YACpC,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC;YACxC,MAAM,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;YAC3C,MAAM,eAAe,GAAG,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,UAAU,CAAC;YACxE,MAAM,SAAS,GAAG,CAAC,GAAG,UAAU,EAAE,GAAG,YAAY,CAAC,CAAC;YAEnD,IAAI,KAAa,CAAC;YAClB,QAAQ,iBAAiB,EAAE,CAAC;gBAC1B,KAAK,mBAAmB;oBACtB,KAAK,GAAG,UAAU,CAAC;oBACnB,MAAM;gBACR,KAAK,kBAAkB;oBACrB,KAAK,GAAG,eAAe,CAAC;oBACxB,MAAM;gBACR;oBACE,KAAK,GAAG,CAAC,CAAC;YACd,CAAC;YAED,OAAO;gBACL,KAAK;gBACL,GAAG,EAAE,SAAS;gBACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,SAAS,EAAE,QAAQ;gBACnB,QAAQ,EAAE;oBACR,UAAU,EAAE,SAAS;oBACrB,YAAY,EAAE,WAAW;oBACzB,WAAW,EAAE,UAAU;oBACvB,gBAAgB,EAAE,eAAe;iBAClC;aACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,sBAAsB;QACpB,OAAO,CAAC,kBAAkB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,kBAAkB,CAAC,CAAC;IAC7F,CAAC;IAED,KAAK,CAAC,UAAU;QACd,QAAQ;IACV,CAAC;IAED,WAAW;QACT,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,IAAI,QAAQ,GAAG,KAAK,CAAC;YAErB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE;gBACnD,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;aAClC,CAAC,CAAC;YAEH,MAAM,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;gBACpC,QAAQ,GAAG,IAAI,CAAC;gBAChB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC,EAAE,KAAK,CAAC,CAAC;YAEV,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBACrB,IAAI,QAAQ;oBAAE,OAAO;gBACrB,QAAQ,GAAG,IAAI,CAAC;gBAChB,YAAY,CAAC,aAAa,CAAC,CAAC;gBAC5B,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAmB,EAAE,EAAE;gBACxC,IAAI,QAAQ;oBAAE,OAAO;gBACrB,QAAQ,GAAG,IAAI,CAAC;gBAChB,YAAY,CAAC,aAAa,CAAC,CAAC;gBAC5B,IAAI,QAAQ,EAAE,CAAC;oBACb,OAAO,CAAC,KAAK,CAAC,CAAC;oBACf,OAAO;gBACT,CAAC;gBACD,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;YACtB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,0BAA0B;IAElB,WAAW,CAAC,MAAwB;QAC1C,+DAA+D;QAC/D,MAAM,IAAI,GAAG,MAAM,CAAC,UAAqC,CAAC;QAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE;YAAE,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;QAChE,IAAI,OAAO,MAAM,CAAC,UAAU,CAAC,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;YAC9E,OAAO,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACtC,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,YAAY,CAAC,MAAwB;QAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,iBAAiB,IAAI,EAAE,CAAC;QAC/C,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACK,aAAa,CACnB,KAAwB,EACxB,IAAwB,EACxB,KAAyB,EACzB,SAAiB,EACjB,EAAiE;QAEjE,OAAO,IAAI,OAAO,CAAqB,CAAC,OAAO,EAAE,EAAE;YACjD,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,QAAQ,GAAG,KAAK,CAAC;YAErB,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YACpD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;YAE9E,MAAM,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;gBACpC,QAAQ,GAAG,IAAI,CAAC;gBAChB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC,EAAE,SAAS,CAAC,CAAC;YAEd,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBACxC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBACxC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;gBAC/B,YAAY,CAAC,aAAa,CAAC,CAAC;gBAC5B,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;YAC/B,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAmB,EAAE,EAAE;gBACxC,YAAY,CAAC,aAAa,CAAC,CAAC;gBAC5B,IAAI,QAAQ,EAAE,CAAC;oBACb,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,iCAAiC,SAAS,IAAI,CAAC,CAAC,CAAC;oBAChE,OAAO;gBACT,CAAC;gBACD,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,kCAAkC,IAAI,EAAE,CAAC,CAAC,CAAC;oBAC3E,OAAO;gBACT,CAAC;gBACD,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;YACjD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACK,eAAe,CACrB,IAAwB,EACxB,KAAyB,EACzB,SAAiB,EACjB,EAIuB;QAEvB,OAAO,IAAI,OAAO,CAAqB,CAAC,OAAO,EAAE,EAAE;YACjD,2BAA2B;YAC3B,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE;gBACrE,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;oBACrB,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;oBAC7B,OAAO;gBACT,CAAC;gBACD,sEAAsE;gBACtE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,EAAE;oBAC3E,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;wBACvB,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;wBAC/B,OAAO;oBACT,CAAC;oBACD,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC;gBAC9C,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACK,SAAS,CACf,KAAwB,EACxB,IAAwB,EACxB,KAAyB,EACzB,SAAiB,EACjB,EAAmD;QAEnD,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QACpD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAE9E,MAAM,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;YACpC,QAAQ,GAAG,IAAI,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACxC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACxC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;YAC/B,YAAY,CAAC,aAAa,CAAC,CAAC;YAC5B,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAmB,EAAE,EAAE;YACxC,YAAY,CAAC,aAAa,CAAC,CAAC;YAC5B,IAAI,QAAQ,EAAE,CAAC;gBACb,EAAE,CAAC,EAAE,EAAE,iCAAiC,SAAS,IAAI,CAAC,CAAC;gBACvD,OAAO;YACT,CAAC;YACD,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,kCAAkC,IAAI,EAAE,CAAC,CAAC;gBAClE,OAAO;YACT,CAAC;YACD,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,aAAa,CACnB,KAAwB,EACxB,IAAwB,EACxB,KAAyB;QAEzB,MAAM,IAAI,GAAG;YACX,OAAO;YACP,MAAM;YACN,SAAS;YACT,KAAK;YACL,QAAQ;YACR,qCAAqC;YACrC,SAAS;YACT,MAAM;SACP,CAAC;QAEF,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC9B,CAAC;QAED,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,cAAc,CAAC,MAAc;QACnC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,MAAM;YAAE,OAAO,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAY,CAAC;YAC9C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;gBAAE,OAAO,EAAE,CAAC;YACtC,OAAO,MAAmB,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/adapters/github-issue.d.ts

@@ -0,0 +1,87 @@
+import type { IAdapter, AgentTask, AgentResult } from "../execution/adapter-layer.js";
+import type { Logger } from "../runtime/logger.js";
+export interface GitHubIssueAdapterConfig {
+    /** "owner/name". Reads MOTIVA_GITHUB_REPO env var if not set; auto-detects via gh CLI otherwise. */
+    repo?: string;
+    /** Labels always applied to every created issue. Default: ["motiva"] */
+    defaultLabels?: string[];
+    /** Path to the gh executable. Default: "gh" */
+    ghPath?: string;
+    /** When true, log the command instead of running it. Default: false */
+    dryRun?: boolean;
+    /** Ignored — kept for API compatibility. Timeout is taken from AgentTask.timeout_ms. */
+    timeout_ms?: number;
+}
+export interface ParsedIssue {
+    title: string;
+    body: string;
+    labels: string[];
+}
+export declare class GitHubIssueAdapter implements IAdapter {
+    readonly adapterType = "github_issue";
+    readonly capabilities: readonly ["create_issue"];
+    private readonly repo;
+    private readonly defaultLabels;
+    private readonly ghPath;
+    private readonly dryRun;
+    private readonly logger?;
+    constructor(config?: GitHubIssueAdapterConfig, logger?: Logger);
+    execute(task: AgentTask): Promise<AgentResult>;
+    /**
+     * Check whether an open GitHub issue with a similar title already exists.
+     *
+     * Runs `gh issue list --state open --label <label> --search "<title>" --json number,title --limit 10`
+     * and returns the issue number of the first match (>60% word overlap), or null if no match / on any error.
+     *
+     * Returns null (not a match) on any error so the adapter stays functional when gh is unavailable.
+     */
+    checkOpenIssueExists(title: string): Promise<number | null>;
+    /**
+     * IAdapter.checkDuplicate — returns true if an open issue with a similar title already
+     * exists. Delegates to checkOpenIssueExists, which is already fail-open (returns null
+     * on any error), so this method always returns false on error.
+     */
+    checkDuplicate(task: AgentTask): Promise<boolean>;
+    /**
+     * Return titles of all open issues labelled with the default label (e.g. "motiva").
+     * Used by CoreLoop to inject existing task context into the prompt so the LLM can
+     * avoid creating duplicates.
+     *
+     * Runs `gh issue list --state open --label <label> --json title --limit 20`.
+     * Returns an empty array on any error (fail-open).
+     */
+    listExistingTasks(): Promise<string[]>;
+    /**
+     * Parse the task prompt to extract issue title, body, and labels.
+     *
+     * Preferred format — a fenced ```github-issue block containing JSON:
+     *   ```github-issue
+     *   { "title": "...", "body": "...", "labels": ["bug"] }
+     *   ```
+     *
+     * Fallback: first non-empty line = title, remainder = body, labels = defaultLabels only.
+     *
+     * Labels from the JSON block are merged with defaultLabels (deduplicated).
+     */
+    parsePrompt(prompt: string): ParsedIssue;
+    private buildGhArgs;
+    /**
+     * Spawn `gh repo view --json nameWithOwner` and call back with the detected
+     * repo string or an error message. Uses raw callbacks (not Promise/await) so
+     * the callback fires synchronously inside the close event handler, allowing
+     * the caller to immediately spawn the next child process without any
+     * microtask gap.
+     */
+    private spawnDetect;
+    /**
+     * Fallback: parse git remote URL. Same callback-based pattern.
+     */
+    private spawnGitRemote;
+    /**
+     * Spawn `gh issue create` and resolve the outer Promise. Uses raw callbacks
+     * for the same reason as spawnDetect — synchronous close-handler chaining.
+     */
+    private spawnCreate;
+    private classifyGhError;
+}
+//# sourceMappingURL=github-issue.d.ts.map

package/dist/adapters/github-issue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-issue.d.ts","sourceRoot":"","sources":["../../src/adapters/github-issue.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAInD,MAAM,WAAW,wBAAwB;IACvC,oGAAoG;IACpG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wFAAwF;IACxF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAID,qBAAa,kBAAmB,YAAW,QAAQ;IACjD,QAAQ,CAAC,WAAW,kBAAkB;IACtC,QAAQ,CAAC,YAAY,4BAA6B;IAElD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAW;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;gBAErB,MAAM,CAAC,EAAE,wBAAwB,EAAE,MAAM,CAAC,EAAE,MAAM;IAQxD,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAgEpD;;;;;;;OAOG;IACG,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAyDjE;;;;OAIG;IACG,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAOvD;;;;;;;OAOG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAkD5C;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW;IA+CxC,OAAO,CAAC,WAAW;IAmBnB;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IAiFnB;;OAEG;IACH,OAAO,CAAC,cAAc;IAoEtB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAsEnB,OAAO,CAAC,eAAe;CAaxB"}