friction-log 0.0.0-stage → 0.6.0

package/dist/scanners/claude-code.js

@@ -0,0 +1,202 @@
+import { existsSync, readFileSync, statSync } from "node:fs";
+const FRICTION_PHRASE_PATTERNS = [
+    /\bdidn['']?t work\b/i,
+    /\bdoesn['']?t work\b/i,
+    /\bnot working\b/i,
+    /\bunexpected(ly)?\b/i,
+    /\bblocked by\b/i,
+    /\bfunktioniert nicht\b/i,
+    /\bklappt nicht\b/i,
+    /\bunerwartet\b/i,
+    /\bschl[äa]gt fehl\b/i,
+];
+const MAX_PHRASE_LINE_CHARS = 280;
+export class ClaudeCodeAdapter {
+    name = "claude-code";
+    async scan(input) {
+        const transcriptPath = input.transcriptPath;
+        if (!transcriptPath) {
+            throw new Error("friction-log: claude-code adapter requires --transcript <path>");
+        }
+        if (!existsSync(transcriptPath)) {
+            throw new Error(`friction-log: transcript not found at ${transcriptPath}`);
+        }
+        const raw = readFileSync(transcriptPath, "utf8");
+        const lines = raw.split("\n");
+        const entries = [];
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                entries.push(JSON.parse(trimmed));
+            }
+            catch {
+                continue;
+            }
+        }
+        const sessionId = input.sessionId ?? deriveSessionIdFromPath(transcriptPath);
+        const { startedAt, endedAt, cwds } = sessionBounds(entries);
+        const candidates = extractCandidates(entries);
+        return {
+            session: {
+                id: sessionId,
+                startedAt,
+                endedAt,
+                projectPaths: cwds.length > 0 ? cwds : null,
+                transcriptPath,
+            },
+            frictionCandidates: candidates,
+        };
+    }
+}
+function deriveSessionIdFromPath(transcriptPath) {
+    const base = transcriptPath.replace(/\\/g, "/").split("/").pop() ?? transcriptPath;
+    return base.replace(/\.jsonl$/i, "");
+}
+function sessionBounds(entries) {
+    let startedAt = null;
+    let endedAt = null;
+    const cwds = new Set();
+    for (const e of entries) {
+        const ts = isMessageEntry(e) ? e.timestamp : undefined;
+        if (ts) {
+            if (!startedAt || ts < startedAt)
+                startedAt = ts;
+            if (!endedAt || ts > endedAt)
+                endedAt = ts;
+        }
+        if (isMessageEntry(e) && typeof e.cwd === "string" && e.cwd.length > 0) {
+            cwds.add(e.cwd);
+        }
+    }
+    return {
+        startedAt: startedAt ?? fileMtimeIso(),
+        endedAt,
+        cwds: [...cwds],
+    };
+}
+function fileMtimeIso() {
+    return new Date().toISOString();
+}
+function isMessageEntry(e) {
+    return e.type === "user" || e.type === "assistant";
+}
+function extractCandidates(entries) {
+    const toolUseById = new Map();
+    const out = [];
+    const seenTitles = new Set();
+    for (const entry of entries) {
+        if (!isMessageEntry(entry))
+            continue;
+        const blocks = normalizeContent(entry.message?.content);
+        for (const block of blocks) {
+            if (block.type === "tool_use") {
+                const tu = block;
+                toolUseById.set(tu.id, tu.name);
+            }
+            else if (block.type === "tool_result") {
+                const tr = block;
+                if (!tr.is_error)
+                    continue;
+                const toolName = toolUseById.get(tr.tool_use_id) ?? "unknown-tool";
+                const errText = stringifyContent(tr.content);
+                const candidate = toolErrorCandidate(toolName, errText);
+                addUnique(out, seenTitles, candidate);
+            }
+            else if (block.type === "text" && entry.type === "assistant") {
+                const text = block.text ?? "";
+                for (const c of phraseCandidates(text)) {
+                    addUnique(out, seenTitles, c);
+                }
+            }
+        }
+    }
+    return out;
+}
+function addUnique(out, seen, candidate) {
+    const key = `${candidate.toolSurface ?? ""}|${candidate.title}`;
+    if (seen.has(key))
+        return;
+    seen.add(key);
+    out.push(candidate);
+}
+function normalizeContent(content) {
+    if (!content)
+        return [];
+    if (typeof content === "string")
+        return [{ type: "text", text: content }];
+    return content;
+}
+function stringifyContent(content) {
+    if (typeof content === "string")
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .map((c) => {
+            if (typeof c === "string")
+                return c;
+            if (c && typeof c === "object" && "text" in c)
+                return String(c.text);
+            return JSON.stringify(c);
+        })
+            .join("\n");
+    }
+    if (content == null)
+        return "";
+    return JSON.stringify(content);
+}
+function toolErrorCandidate(toolName, errText) {
+    const firstLine = errText.split("\n")[0]?.trim() ?? "";
+    const exitMatch = /^Exit code (\d+)/i.exec(firstLine);
+    if (toolName === "Bash" && exitMatch) {
+        const code = exitMatch[1];
+        return {
+            toolSurface: "bash",
+            title: `Bash exited with code ${code}`,
+            description: truncate(errText, 2000),
+            severity: "medium",
+            category: "tool-error",
+        };
+    }
+    const summary = truncate(firstLine || errText, 120);
+    return {
+        toolSurface: toolName,
+        title: `${toolName} returned an error: ${summary}`,
+        description: truncate(errText, 2000),
+        severity: "medium",
+        category: "tool-error",
+    };
+}
+function phraseCandidates(text) {
+    const candidates = [];
+    const paragraphs = text.split(/\n{2,}/);
+    for (const para of paragraphs) {
+        const trimmed = para.trim();
+        if (trimmed.length === 0 || trimmed.length > MAX_PHRASE_LINE_CHARS)
+            continue;
+        if (trimmed.endsWith("?"))
+            continue;
+        for (const pattern of FRICTION_PHRASE_PATTERNS) {
+            const m = pattern.exec(trimmed);
+            if (m) {
+                candidates.push({
+                    toolSurface: null,
+                    title: `friction phrase: ${truncate(trimmed, 100)}`,
+                    description: trimmed,
+                    severity: "low",
+                    category: "workflow-friction",
+                });
+                break;
+            }
+        }
+    }
+    return candidates;
+}
+function truncate(s, max) {
+    return s.length <= max ? s : s.slice(0, max - 1) + "…";
+}
+export function fileExistsCheck(p) {
+    return existsSync(p) && statSync(p).isFile();
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/scanners/claude-code.js.map

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

package/dist/scanners/index.d.ts

@@ -0,0 +1,4 @@
+import type { Scanner } from "../types.js";
+export type ScannerName = "claude-code";
+export declare function loadScanner(name: string): Scanner;
+export declare const availableScanners: readonly string[];

package/dist/scanners/index.js

@@ -0,0 +1,12 @@
+import { ClaudeCodeAdapter } from "./claude-code.js";
+export function loadScanner(name) {
+    switch (name) {
+        case "claude-code":
+            return new ClaudeCodeAdapter();
+        default:
+            throw new Error(`friction-log: unknown scanner "${name}". Available in M2: claude-code. ` +
+                `Other adapters (cursor, aider, opencode) are planned for later milestones.`);
+    }
+}
+export const availableScanners = ["claude-code"];
+//# sourceMappingURL=index.js.map

package/dist/scanners/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scanners/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAIrD,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,aAAa;YAChB,OAAO,IAAI,iBAAiB,EAAE,CAAC;QACjC;YACE,MAAM,IAAI,KAAK,CACb,kCAAkC,IAAI,mCAAmC;gBACvE,4EAA4E,CAC/E,CAAC;IACN,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAsB,CAAC,aAAa,CAAC,CAAC"}

package/dist/sinks/agent-tasks.d.ts

@@ -0,0 +1,36 @@
+import type { FileOptions, FileResult, Friction, Priority, RenderedTemplate, Sink } from "../types.js";
+export interface AgentTasksOpts {
+    /** Defaults to "rest". "mcp-emit" prints the equivalent
+     * mcp__agent-tasks__task_create JSON to stdout instead of POSTing.
+     */
+    mode: "rest" | "mcp-emit";
+    projectId?: string;
+    /** REST base URL, e.g. https://agent-tasks.opentriologue.ai */
+    apiBase?: string;
+    /** Bearer token. Defaults to env var AGENT_TASKS_TOKEN. */
+    token?: string;
+    priority?: Priority;
+    labels?: string[];
+}
+export type Fetcher = (url: string, init: RequestInit) => Promise<Response>;
+export type StdoutWriter = (line: string) => void;
+/**
+ * agent-tasks sink. Two paths, both supported per spec:
+ *
+ *   - mode=rest (default): POST /api/projects/<id>/tasks with the friction's
+ *     rendered title/body, returns the new task UUID as external_ref.
+ *   - mode=mcp-emit: print the equivalent mcp__agent-tasks__task_create JSON
+ *     to stdout for an agent harness to pick up and execute. No network call
+ *     is made. Useful when friction-log is run inside a Claude Code session
+ *     where the agent already holds the MCP scope.
+ *
+ * mcp-emit is the honest version of "the MCP path" for a standalone Node CLI:
+ * it doesn't pretend to speak MCP, it just emits the structured intent.
+ */
+export declare class AgentTasksSink implements Sink {
+    private readonly fetchImpl;
+    private readonly write;
+    readonly name = "agent-tasks";
+    constructor(fetchImpl?: Fetcher, write?: StdoutWriter);
+    file(friction: Friction, rendered: RenderedTemplate, opts: FileOptions): Promise<FileResult>;
+}

package/dist/sinks/agent-tasks.js

@@ -0,0 +1,153 @@
+/**
+ * agent-tasks sink. Two paths, both supported per spec:
+ *
+ *   - mode=rest (default): POST /api/projects/<id>/tasks with the friction's
+ *     rendered title/body, returns the new task UUID as external_ref.
+ *   - mode=mcp-emit: print the equivalent mcp__agent-tasks__task_create JSON
+ *     to stdout for an agent harness to pick up and execute. No network call
+ *     is made. Useful when friction-log is run inside a Claude Code session
+ *     where the agent already holds the MCP scope.
+ *
+ * mcp-emit is the honest version of "the MCP path" for a standalone Node CLI:
+ * it doesn't pretend to speak MCP, it just emits the structured intent.
+ */
+export class AgentTasksSink {
+    fetchImpl;
+    write;
+    name = "agent-tasks";
+    constructor(fetchImpl = (url, init) => fetch(url, init), write = (line) => process.stdout.write(line)) {
+        this.fetchImpl = fetchImpl;
+        this.write = write;
+    }
+    async file(friction, rendered, opts) {
+        const parsed = parseOpts(opts);
+        const payload = buildPayload(friction, rendered, parsed);
+        if (parsed.mode === "mcp-emit") {
+            const intent = {
+                tool: "mcp__agent-tasks__task_create",
+                params: payload,
+            };
+            this.write(JSON.stringify(intent) + "\n");
+            return {
+                ok: true,
+                sinkTarget: `agent-tasks:mcp-emit:${payload.projectId}`,
+                message: "emitted MCP task_create intent to stdout (no network call)",
+            };
+        }
+        const apiBase = parsed.apiBase;
+        if (!apiBase) {
+            throw new Error(`friction-log: agent-tasks sink in REST mode requires "apiBase". Set sinks.agent-tasks.apiBase in config.yml or pass --sink-opt apiBase=https://...`);
+        }
+        const token = parsed.token ?? process.env.AGENT_TASKS_TOKEN;
+        if (!token) {
+            throw new Error(`friction-log: agent-tasks REST mode requires a token. Set AGENT_TASKS_TOKEN env var or sinks.agent-tasks.token.`);
+        }
+        const url = `${apiBase.replace(/\/$/, "")}/api/projects/${encodeURIComponent(payload.projectId)}/tasks`;
+        const response = await this.fetchImpl(url, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                accept: "application/json",
+                authorization: `Bearer ${token}`,
+            },
+            body: JSON.stringify({
+                title: payload.title,
+                description: payload.description,
+                priority: payload.priority,
+                labels: payload.labels,
+            }),
+        });
+        if (!response.ok) {
+            const body = await safeText(response);
+            throw new Error(`friction-log: agent-tasks REST returned ${response.status}: ${body.slice(0, 400)}`);
+        }
+        const parsedBody = (await response.json());
+        const taskId = parsedBody.task?.id ?? parsedBody.id;
+        if (typeof taskId !== "string") {
+            throw new Error(`friction-log: agent-tasks REST response missing task id: ${JSON.stringify(parsedBody).slice(0, 400)}`);
+        }
+        return {
+            ok: true,
+            sinkTarget: `agent-tasks:${payload.projectId}`,
+            externalRef: taskId,
+            message: `created task ${taskId}`,
+        };
+    }
+}
+function buildPayload(friction, rendered, opts) {
+    if (!opts.projectId) {
+        throw new Error(`friction-log: agent-tasks sink requires "projectId" (uuid). Set sinks.agent-tasks.projectId in config.yml or pass --sink-opt projectId=...`);
+    }
+    const labels = Array.from(new Set([...(opts.labels ?? []), ...rendered.labels]));
+    const description = renderDescription(friction, rendered);
+    return {
+        projectId: opts.projectId,
+        title: rendered.title,
+        description,
+        priority: opts.priority ?? rendered.priority,
+        labels,
+    };
+}
+function parseOpts(opts) {
+    const raw = opts.sinkOpts ?? {};
+    const mode = parseMode(raw.mode);
+    const projectId = optionalString(raw.projectId, "projectId");
+    const apiBase = optionalString(raw.apiBase, "apiBase");
+    const token = optionalString(raw.token, "token");
+    const priority = parsePriority(raw.priority);
+    const labels = parseStringList(raw.labels, "labels");
+    return { mode, projectId, apiBase, token, priority, labels };
+}
+function parseMode(value) {
+    if (value == null)
+        return "rest";
+    if (value === "rest" || value === "mcp-emit")
+        return value;
+    throw new Error(`friction-log: agent-tasks "mode" must be "rest" or "mcp-emit", got ${JSON.stringify(value)}`);
+}
+function optionalString(value, name) {
+    if (value == null)
+        return undefined;
+    if (typeof value === "string")
+        return value;
+    throw new Error(`friction-log: agent-tasks "${name}" must be a string`);
+}
+function parsePriority(value) {
+    if (value == null)
+        return undefined;
+    const valid = ["LOW", "MEDIUM", "HIGH", "CRITICAL"];
+    if (typeof value === "string" && valid.includes(value))
+        return value;
+    throw new Error(`friction-log: agent-tasks "priority" must be one of ${valid.join("|")}`);
+}
+function parseStringList(value, name) {
+    if (value == null)
+        return undefined;
+    if (typeof value === "string")
+        return [value];
+    if (Array.isArray(value) && value.every((v) => typeof v === "string"))
+        return value;
+    throw new Error(`friction-log: agent-tasks "${name}" must be a string or array of strings`);
+}
+function renderDescription(friction, rendered) {
+    const meta = [];
+    meta.push(`friction-log id ${friction.id} captured ${friction.capturedAt}`);
+    if (friction.toolSurface)
+        meta.push(`tool: ${friction.toolSurface}`);
+    if (friction.category)
+        meta.push(`category: ${friction.category}`);
+    if (friction.severity)
+        meta.push(`severity: ${friction.severity}`);
+    if (friction.recurrenceOfId != null)
+        meta.push(`recurrence of friction #${friction.recurrenceOfId}`);
+    return `${rendered.body}\n\n---\n${meta.join("\n")}\n`;
+}
+async function safeText(response) {
+    try {
+        return await response.text();
+    }
+    catch {
+        return "(no body)";
+    }
+}
+//# sourceMappingURL=agent-tasks.js.map

package/dist/sinks/agent-tasks.js.map

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

package/dist/sinks/github-issues.d.ts

@@ -0,0 +1,20 @@
+import { type SpawnSyncReturns } from "node:child_process";
+import type { FileOptions, FileResult, Friction, RenderedTemplate, Sink } from "../types.js";
+export interface GithubIssuesOpts {
+    repo: string;
+    labels?: string[];
+    assignee?: string;
+    milestone?: string;
+}
+export type GhRunner = (args: string[], input: string) => SpawnSyncReturns<string>;
+/**
+ * Create a GitHub issue by spawning `gh issue create`. No HTTP client in the
+ * package: gh handles auth, retries, and proxy config. Required option `repo`
+ * is owner/name; everything else is optional.
+ */
+export declare class GithubIssuesSink implements Sink {
+    private readonly runGh;
+    readonly name = "github-issues";
+    constructor(runGh?: GhRunner);
+    file(friction: Friction, rendered: RenderedTemplate, opts: FileOptions): Promise<FileResult>;
+}

package/dist/sinks/github-issues.js

@@ -0,0 +1,98 @@
+import { spawnSync } from "node:child_process";
+const defaultRunner = (args, input) => spawnSync("gh", args, {
+    input,
+    encoding: "utf8",
+});
+/**
+ * Create a GitHub issue by spawning `gh issue create`. No HTTP client in the
+ * package: gh handles auth, retries, and proxy config. Required option `repo`
+ * is owner/name; everything else is optional.
+ */
+export class GithubIssuesSink {
+    runGh;
+    name = "github-issues";
+    constructor(runGh = defaultRunner) {
+        this.runGh = runGh;
+    }
+    async file(friction, rendered, opts) {
+        const parsed = parseOpts(opts);
+        const labels = Array.from(new Set([...(parsed.labels ?? []), ...rendered.labels]));
+        const args = [
+            "issue",
+            "create",
+            "--repo",
+            parsed.repo,
+            "--title",
+            rendered.title,
+            "--body-file",
+            "-",
+        ];
+        for (const label of labels) {
+            args.push("--label", label);
+        }
+        if (parsed.assignee)
+            args.push("--assignee", parsed.assignee);
+        if (parsed.milestone)
+            args.push("--milestone", parsed.milestone);
+        const body = renderBody(friction, rendered);
+        const result = this.runGh(args, body);
+        if (result.error) {
+            throw new Error(`friction-log: gh CLI not runnable: ${result.error.message}`);
+        }
+        if (result.status !== 0) {
+            const stderr = (result.stderr ?? "").trim();
+            throw new Error(`friction-log: gh issue create failed (exit ${result.status}): ${stderr || "no stderr"}`);
+        }
+        const issueUrl = (result.stdout ?? "").trim().split("\n").pop() ?? "";
+        if (!/^https:\/\/github\.com\//.test(issueUrl)) {
+            throw new Error(`friction-log: gh stdout did not contain an issue URL: ${result.stdout}`);
+        }
+        return {
+            ok: true,
+            sinkTarget: parsed.repo,
+            externalRef: issueUrl,
+            message: `created ${issueUrl}`,
+        };
+    }
+}
+function parseOpts(opts) {
+    const raw = opts.sinkOpts ?? {};
+    const repo = raw.repo;
+    if (typeof repo !== "string" || !/^[^/\s]+\/[^/\s]+$/.test(repo)) {
+        throw new Error(`friction-log: github-issues sink requires "repo" (owner/name). Set sinks.github-issues.repo in config.yml or pass --sink-opt repo=owner/name.`);
+    }
+    const labels = normalizeStringList(raw.labels, "labels");
+    const assignee = optionalString(raw.assignee, "assignee");
+    const milestone = optionalString(raw.milestone, "milestone");
+    return { repo, labels, assignee, milestone };
+}
+function normalizeStringList(value, name) {
+    if (value == null)
+        return undefined;
+    if (typeof value === "string")
+        return [value];
+    if (Array.isArray(value) && value.every((v) => typeof v === "string"))
+        return value;
+    throw new Error(`friction-log: github-issues "${name}" must be a string or array of strings`);
+}
+function optionalString(value, name) {
+    if (value == null)
+        return undefined;
+    if (typeof value === "string")
+        return value;
+    throw new Error(`friction-log: github-issues "${name}" must be a string`);
+}
+function renderBody(friction, rendered) {
+    const meta = [];
+    meta.push(`<sub>friction-log id ${friction.id} captured ${friction.capturedAt}</sub>`);
+    if (friction.toolSurface)
+        meta.push(`<sub>tool: \`${friction.toolSurface}\`</sub>`);
+    if (friction.category)
+        meta.push(`<sub>category: ${friction.category}</sub>`);
+    if (friction.severity)
+        meta.push(`<sub>severity: ${friction.severity}</sub>`);
+    if (friction.recurrenceOfId != null)
+        meta.push(`<sub>recurrence of friction #${friction.recurrenceOfId}</sub>`);
+    return `${rendered.body}\n\n---\n${meta.join("  \n")}\n`;
+}
+//# sourceMappingURL=github-issues.js.map

package/dist/sinks/github-issues.js.map

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

package/dist/sinks/index.d.ts

@@ -0,0 +1,11 @@
+import type { Sink } from "../types.js";
+export type SinkName = "markdown-file" | "stdout-json" | "github-issues" | "agent-tasks" | "linear";
+export declare const availableSinks: readonly SinkName[];
+type SinkFactory = () => Promise<Sink>;
+export declare function loadSink(name: string): Promise<Sink>;
+/**
+ * Replace a sink factory for the duration of a test. Returns a restore
+ * function. Production code never calls this.
+ */
+export declare function registerSinkFactory(name: SinkName, factory: SinkFactory): () => void;
+export {};

package/dist/sinks/index.js

@@ -0,0 +1,48 @@
+export const availableSinks = [
+    "markdown-file",
+    "stdout-json",
+    "github-issues",
+    "agent-tasks",
+    "linear",
+];
+const factories = {
+    "markdown-file": async () => {
+        const m = await import("./markdown-file.js");
+        return new m.MarkdownFileSink();
+    },
+    "stdout-json": async () => {
+        const m = await import("./stdout-json.js");
+        return new m.StdoutJsonSink();
+    },
+    "github-issues": async () => {
+        const m = await import("./github-issues.js");
+        return new m.GithubIssuesSink();
+    },
+    "agent-tasks": async () => {
+        const m = await import("./agent-tasks.js");
+        return new m.AgentTasksSink();
+    },
+    linear: async () => {
+        const m = await import("./linear.js");
+        return new m.LinearSink();
+    },
+};
+export async function loadSink(name) {
+    const factory = factories[name];
+    if (!factory) {
+        throw new Error(`friction-log: unknown sink "${name}". Known sinks: ${availableSinks.join(", ")}.`);
+    }
+    return factory();
+}
+/**
+ * Replace a sink factory for the duration of a test. Returns a restore
+ * function. Production code never calls this.
+ */
+export function registerSinkFactory(name, factory) {
+    const previous = factories[name];
+    factories[name] = factory;
+    return () => {
+        factories[name] = previous;
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/sinks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sinks/index.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,cAAc,GAAwB;IACjD,eAAe;IACf,aAAa;IACb,eAAe;IACf,aAAa;IACb,QAAQ;CACT,CAAC;AASF,MAAM,SAAS,GAAkC;IAC/C,eAAe,EAAE,KAAK,IAAI,EAAE;QAC1B,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC,CAAC,gBAAgB,EAAE,CAAC;IAClC,CAAC;IACD,aAAa,EAAE,KAAK,IAAI,EAAE;QACxB,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC,CAAC,cAAc,EAAE,CAAC;IAChC,CAAC;IACD,eAAe,EAAE,KAAK,IAAI,EAAE;QAC1B,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC,CAAC,gBAAgB,EAAE,CAAC;IAClC,CAAC;IACD,aAAa,EAAE,KAAK,IAAI,EAAE;QACxB,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC,CAAC,cAAc,EAAE,CAAC;IAChC,CAAC;IACD,MAAM,EAAE,KAAK,IAAI,EAAE;QACjB,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;IAC5B,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAY;IACzC,MAAM,OAAO,GAAG,SAAS,CAAC,IAAgB,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,+BAA+B,IAAI,mBAAmB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACnF,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,EAAE,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAc,EACd,OAAoB;IAEpB,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACjC,SAAS,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;IAC1B,OAAO,GAAG,EAAE;QACV,SAAS,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC;IAC7B,CAAC,CAAC;AACJ,CAAC"}

package/dist/sinks/linear.d.ts

@@ -0,0 +1,25 @@
+import type { FileOptions, FileResult, Friction, RenderedTemplate, Sink } from "../types.js";
+export interface LinearOpts {
+    teamId: string;
+    state?: string;
+    assignee?: string;
+    /** LINEAR_API_KEY env var by default. */
+    apiKey?: string;
+    /** Default https://api.linear.app/graphql. */
+    endpoint?: string;
+}
+export type Fetcher = (url: string, init: RequestInit) => Promise<Response>;
+/**
+ * Create a Linear issue via GraphQL. LINEAR_API_KEY env var supplies the
+ * personal access token by default; teamId is required.
+ *
+ * The `state` option is matched case-insensitively against the team's
+ * workflow-state names so callers can write "Backlog" instead of a UUID.
+ * Looking up the workflow state requires one extra query, kept minimal.
+ */
+export declare class LinearSink implements Sink {
+    private readonly fetchImpl;
+    readonly name = "linear";
+    constructor(fetchImpl?: Fetcher);
+    file(friction: Friction, rendered: RenderedTemplate, opts: FileOptions): Promise<FileResult>;
+}