forge-cc 0.1.0

package/dist/linear/client.js

@@ -0,0 +1,388 @@
+/**
+ * Typed wrapper around the Linear GraphQL API.
+ * Used by lifecycle modules (projects.ts, milestones.ts, issues.ts)
+ * and the execution engine for programmatic Linear management.
+ */
+const LINEAR_API_URL = "https://api.linear.app/graphql";
+const MAX_RETRIES = 3;
+const INITIAL_BACKOFF_MS = 500;
+const REQUEST_TIMEOUT_MS = 30_000; // 30 seconds per request
+// ---------------------------------------------------------------------------
+// Error
+// ---------------------------------------------------------------------------
+export class LinearClientError extends Error {
+    statusCode;
+    errors;
+    constructor(message, statusCode, errors) {
+        super(message);
+        this.statusCode = statusCode;
+        this.errors = errors;
+        this.name = "LinearClientError";
+    }
+}
+// ---------------------------------------------------------------------------
+// Client
+// ---------------------------------------------------------------------------
+export class LinearClient {
+    apiKey;
+    constructor(apiKey) {
+        const key = apiKey ?? process.env.LINEAR_API_KEY;
+        if (!key) {
+            throw new LinearClientError("Linear API key not found. Set the LINEAR_API_KEY environment variable or pass it to the constructor.");
+        }
+        this.apiKey = key;
+    }
+    // -------------------------------------------------------------------------
+    // Projects
+    // -------------------------------------------------------------------------
+    async listProjects(opts) {
+        const filter = {};
+        if (opts?.query) {
+            filter.name = { containsIgnoreCase: opts.query };
+        }
+        if (opts?.state) {
+            filter.state = { eq: opts.state };
+        }
+        const hasFilter = Object.keys(filter).length > 0;
+        const filterVar = hasFilter ? ", $filter: ProjectFilter" : "";
+        const filterArg = hasFilter ? ", filter: $filter" : "";
+        const query = `
+      query ListProjects($after: String${filterVar}) {
+        projects(first: 50, after: $after${filterArg}) {
+          pageInfo { hasNextPage endCursor }
+          nodes {
+            id name description state url
+          }
+        }
+      }
+    `;
+        return this.paginate(query, "projects", {
+            ...(hasFilter ? { filter } : {}),
+        });
+    }
+    async createProject(input) {
+        const mutation = `
+      mutation CreateProject($input: ProjectCreateInput!) {
+        projectCreate(input: $input) {
+          success
+          project { id name description state url }
+        }
+      }
+    `;
+        const variables = {
+            input: {
+                name: input.name,
+                ...(input.description != null && { description: input.description }),
+                teamIds: input.teamIds,
+                ...(input.state != null && { state: input.state }),
+            },
+        };
+        const data = await this.request(mutation, variables);
+        const result = data.projectCreate;
+        if (!result?.success) {
+            throw new LinearClientError("Failed to create project");
+        }
+        return result.project;
+    }
+    async updateProject(id, input) {
+        const mutation = `
+      mutation UpdateProject($id: String!, $input: ProjectUpdateInput!) {
+        projectUpdate(id: $id, input: $input) {
+          success
+          project { id name description state url }
+        }
+      }
+    `;
+        const data = await this.request(mutation, { id, input });
+        const result = data.projectUpdate;
+        if (!result?.success) {
+            throw new LinearClientError(`Failed to update project ${id}`);
+        }
+        return result.project;
+    }
+    // -------------------------------------------------------------------------
+    // Milestones (Project Milestones)
+    // -------------------------------------------------------------------------
+    async listMilestones(projectId) {
+        const query = `
+      query ListMilestones($projectId: String!, $after: String) {
+        project(id: $projectId) {
+          projectMilestones(first: 50, after: $after) {
+            pageInfo { hasNextPage endCursor }
+            nodes {
+              id name description progress sortOrder
+            }
+          }
+        }
+      }
+    `;
+        // Custom pagination because the nodes are nested under project
+        const all = [];
+        let after = null;
+        for (;;) {
+            const data = await this.request(query, { projectId, after });
+            const connection = data.project?.projectMilestones;
+            if (!connection)
+                break;
+            all.push(...connection.nodes);
+            if (connection.pageInfo.hasNextPage) {
+                after = connection.pageInfo.endCursor;
+            }
+            else {
+                break;
+            }
+        }
+        return all;
+    }
+    async createMilestone(input) {
+        const mutation = `
+      mutation CreateMilestone($input: ProjectMilestoneCreateInput!) {
+        projectMilestoneCreate(input: $input) {
+          success
+          projectMilestone { id name description progress sortOrder }
+        }
+      }
+    `;
+        const variables = {
+            input: {
+                projectId: input.projectId,
+                name: input.name,
+                ...(input.description != null && { description: input.description }),
+                ...(input.targetDate != null && { targetDate: input.targetDate }),
+            },
+        };
+        const data = await this.request(mutation, variables);
+        const result = data.projectMilestoneCreate;
+        if (!result?.success) {
+            throw new LinearClientError("Failed to create milestone");
+        }
+        return result.projectMilestone;
+    }
+    // -------------------------------------------------------------------------
+    // Issues
+    // -------------------------------------------------------------------------
+    async listIssues(opts) {
+        const filter = {};
+        if (opts?.projectId) {
+            filter.project = { id: { eq: opts.projectId } };
+        }
+        if (opts?.milestoneId) {
+            filter.projectMilestone = { id: { eq: opts.milestoneId } };
+        }
+        if (opts?.state) {
+            filter.state = { name: { eqIgnoreCase: opts.state } };
+        }
+        const hasFilter = Object.keys(filter).length > 0;
+        const filterVar = hasFilter ? ", $filter: IssueFilter" : "";
+        const filterArg = hasFilter ? ", filter: $filter" : "";
+        const query = `
+      query ListIssues($after: String${filterVar}) {
+        issues(first: 50, after: $after${filterArg}) {
+          pageInfo { hasNextPage endCursor }
+          nodes {
+            id identifier title description url
+            state { name }
+            project { id }
+            projectMilestone { id }
+          }
+        }
+      }
+    `;
+        const raw = await this.paginate(query, "issues", hasFilter ? { filter } : {});
+        return raw.map((node) => this.mapIssue(node));
+    }
+    async createIssue(input) {
+        const mutation = `
+      mutation CreateIssue($input: IssueCreateInput!) {
+        issueCreate(input: $input) {
+          success
+          issue {
+            id identifier title description url
+            state { name }
+            project { id }
+            projectMilestone { id }
+          }
+        }
+      }
+    `;
+        const issueInput = {
+            title: input.title,
+            teamId: input.teamId,
+            ...(input.description != null && { description: input.description }),
+            ...(input.projectId != null && { projectId: input.projectId }),
+            ...(input.milestoneId != null && {
+                projectMilestoneId: input.milestoneId,
+            }),
+            ...(input.priority != null && { priority: input.priority }),
+        };
+        // state is a name string; Linear expects stateId. The caller should resolve
+        // this upstream, but if provided we pass it as-is and let Linear resolve.
+        if (input.state != null) {
+            issueInput.stateId = input.state;
+        }
+        const data = await this.request(mutation, { input: issueInput });
+        const result = data.issueCreate;
+        if (!result?.success) {
+            throw new LinearClientError("Failed to create issue");
+        }
+        return this.mapIssue(result.issue);
+    }
+    async updateIssue(id, input) {
+        const mutation = `
+      mutation UpdateIssue($id: String!, $input: IssueUpdateInput!) {
+        issueUpdate(id: $id, input: $input) {
+          success
+          issue {
+            id identifier title description url
+            state { name }
+            project { id }
+            projectMilestone { id }
+          }
+        }
+      }
+    `;
+        const issueInput = {};
+        if (input.title != null)
+            issueInput.title = input.title;
+        if (input.description != null)
+            issueInput.description = input.description;
+        if (input.state != null)
+            issueInput.stateId = input.state;
+        if (input.milestoneId != null)
+            issueInput.projectMilestoneId = input.milestoneId;
+        if (input.priority != null)
+            issueInput.priority = input.priority;
+        const data = await this.request(mutation, { id, input: issueInput });
+        const result = data.issueUpdate;
+        if (!result?.success) {
+            throw new LinearClientError(`Failed to update issue ${id}`);
+        }
+        return this.mapIssue(result.issue);
+    }
+    async createComment(issueId, body) {
+        const mutation = `
+      mutation CreateComment($input: CommentCreateInput!) {
+        commentCreate(input: $input) {
+          success
+        }
+      }
+    `;
+        const data = await this.request(mutation, {
+            input: { issueId, body },
+        });
+        if (!data.commentCreate?.success) {
+            throw new LinearClientError(`Failed to create comment on issue ${issueId}`);
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Teams
+    // -------------------------------------------------------------------------
+    async listTeams() {
+        const query = `
+      query ListTeams($after: String) {
+        teams(first: 50, after: $after) {
+          pageInfo { hasNextPage endCursor }
+          nodes { id name key }
+        }
+      }
+    `;
+        return this.paginate(query, "teams", {});
+    }
+    // -------------------------------------------------------------------------
+    // Internals
+    // -------------------------------------------------------------------------
+    /**
+     * Execute a GraphQL request against the Linear API with retry + backoff.
+     */
+    async request(query, variables = {}) {
+        let lastError;
+        for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+            if (attempt > 0) {
+                const delay = INITIAL_BACKOFF_MS * 2 ** (attempt - 1);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+            }
+            let res;
+            try {
+                const controller = new AbortController();
+                const timeoutId = globalThis.setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+                try {
+                    res = await fetch(LINEAR_API_URL, {
+                        method: "POST",
+                        headers: {
+                            "Content-Type": "application/json",
+                            Authorization: this.apiKey,
+                        },
+                        body: JSON.stringify({ query, variables }),
+                        signal: controller.signal,
+                    });
+                }
+                finally {
+                    clearTimeout(timeoutId);
+                }
+            }
+            catch (err) {
+                if (err instanceof DOMException && err.name === "AbortError" || (err instanceof Error && err.name === "AbortError")) {
+                    lastError = new LinearClientError(`Linear API request timed out after ${REQUEST_TIMEOUT_MS / 1000}s`);
+                }
+                else {
+                    lastError =
+                        err instanceof Error ? err : new Error(String(err));
+                }
+                continue;
+            }
+            if (res.status === 429 || res.status >= 500) {
+                lastError = new LinearClientError(`Linear API returned ${res.status}`, res.status);
+                continue;
+            }
+            if (!res.ok) {
+                const body = await res.text().catch(() => "");
+                throw new LinearClientError(`Linear API error ${res.status}: ${body}`, res.status);
+            }
+            const json = (await res.json());
+            if (json.errors?.length) {
+                throw new LinearClientError(`GraphQL errors: ${json.errors.map((e) => e.message).join("; ")}`, undefined, json.errors);
+            }
+            if (!json.data) {
+                throw new LinearClientError("No data in Linear API response");
+            }
+            return json.data;
+        }
+        throw lastError ?? new LinearClientError("Request failed after retries");
+    }
+    /**
+     * Auto-paginate a connection query. The query MUST accept `$after: String`
+     * and the root field must return `{ pageInfo { hasNextPage endCursor } nodes { ... } }`.
+     */
+    async paginate(query, rootField, variables) {
+        const all = [];
+        let after = null;
+        for (;;) {
+            const data = await this.request(query, { ...variables, after });
+            const connection = data[rootField];
+            if (!connection)
+                break;
+            all.push(...connection.nodes);
+            if (connection.pageInfo.hasNextPage) {
+                after = connection.pageInfo.endCursor;
+            }
+            else {
+                break;
+            }
+        }
+        return all;
+    }
+    /** Normalize a raw issue node from GraphQL into our flat LinearIssue shape. */
+    mapIssue(node) {
+        return {
+            id: node.id,
+            identifier: node.identifier,
+            title: node.title,
+            description: node.description ?? undefined,
+            state: node.state?.name ?? "Unknown",
+            projectId: node.project?.id ?? undefined,
+            milestoneId: node.projectMilestone?.id ?? undefined,
+            url: node.url,
+        };
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/linear/client.js.map

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

package/dist/linear/issues.d.ts

@@ -0,0 +1,20 @@
+import { LinearClient, type LinearIssue } from "./client.js";
+/** Valid issue states */
+export declare const ISSUE_STATES: readonly ["Backlog", "Todo", "In Progress", "In Review", "Done", "Canceled"];
+export type IssueState = (typeof ISSUE_STATES)[number];
+/** Create an issue under a project milestone */
+export declare function createMilestoneIssue(client: LinearClient, input: {
+    title: string;
+    description?: string;
+    teamId: string;
+    projectId: string;
+    milestoneId: string;
+    priority?: number;
+}): Promise<LinearIssue>;
+/** Transition all issues in a milestone to a target state */
+export declare function transitionMilestoneIssues(client: LinearClient, projectId: string, milestoneId: string, targetState: string): Promise<{
+    updated: number;
+    issues: LinearIssue[];
+}>;
+/** Add a progress comment to an issue */
+export declare function addProgressComment(client: LinearClient, issueId: string, message: string): Promise<void>;

package/dist/linear/issues.js

@@ -0,0 +1,39 @@
+/** Valid issue states */
+export const ISSUE_STATES = [
+    "Backlog",
+    "Todo",
+    "In Progress",
+    "In Review",
+    "Done",
+    "Canceled",
+];
+/** Create an issue under a project milestone */
+export async function createMilestoneIssue(client, input) {
+    return client.createIssue({
+        title: input.title,
+        description: input.description,
+        teamId: input.teamId,
+        projectId: input.projectId,
+        milestoneId: input.milestoneId,
+        priority: input.priority,
+    });
+}
+/** Transition all issues in a milestone to a target state */
+export async function transitionMilestoneIssues(client, projectId, milestoneId, targetState) {
+    const issues = await client.listIssues({ projectId, milestoneId });
+    const updatedIssues = [];
+    for (const issue of issues) {
+        if (issue.state !== targetState) {
+            const updated = await client.updateIssue(issue.id, {
+                state: targetState,
+            });
+            updatedIssues.push(updated);
+        }
+    }
+    return { updated: updatedIssues.length, issues: updatedIssues };
+}
+/** Add a progress comment to an issue */
+export async function addProgressComment(client, issueId, message) {
+    await client.createComment(issueId, message);
+}
+//# sourceMappingURL=issues.js.map

package/dist/linear/issues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issues.js","sourceRoot":"","sources":["../../src/linear/issues.ts"],"names":[],"mappings":"AAEA,yBAAyB;AACzB,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,SAAS;IACT,MAAM;IACN,aAAa;IACb,WAAW;IACX,MAAM;IACN,UAAU;CACF,CAAC;AAGX,gDAAgD;AAChD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAoB,EACpB,KAOC;IAED,OAAO,MAAM,CAAC,WAAW,CAAC;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC,CAAC;AACL,CAAC;AAED,6DAA6D;AAC7D,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,MAAoB,EACpB,SAAiB,EACjB,WAAmB,EACnB,WAAmB;IAEnB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;IAEnE,MAAM,aAAa,GAAkB,EAAE,CAAC;IACxC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE;gBACjD,KAAK,EAAE,WAAW;aACnB,CAAC,CAAC;YACH,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;AAClE,CAAC;AAED,yCAAyC;AACzC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAoB,EACpB,OAAe,EACf,OAAe;IAEf,MAAM,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC"}

package/dist/linear/milestones.d.ts

@@ -0,0 +1,11 @@
+import { LinearClient, type LinearMilestone } from "./client.js";
+/** Create a milestone under a project */
+export declare function createProjectMilestone(client: LinearClient, projectId: string, name: string, description?: string, targetDate?: string): Promise<LinearMilestone>;
+/** Get milestone progress: total and completed issue counts */
+export declare function getMilestoneProgress(client: LinearClient, projectId: string, milestoneName: string): Promise<{
+    milestone: LinearMilestone;
+    totalIssues: number;
+    completedIssues: number;
+}>;
+/** Find a milestone by name within a project */
+export declare function findMilestoneByName(client: LinearClient, projectId: string, name: string): Promise<LinearMilestone | null>;

package/dist/linear/milestones.js

@@ -0,0 +1,32 @@
+/** Create a milestone under a project */
+export async function createProjectMilestone(client, projectId, name, description, targetDate) {
+    return client.createMilestone({
+        projectId,
+        name,
+        description,
+        targetDate,
+    });
+}
+/** Get milestone progress: total and completed issue counts */
+export async function getMilestoneProgress(client, projectId, milestoneName) {
+    const milestone = await findMilestoneByName(client, projectId, milestoneName);
+    if (!milestone) {
+        throw new Error(`Milestone not found: "${milestoneName}" in project ${projectId}`);
+    }
+    const issues = await client.listIssues({
+        projectId,
+        milestoneId: milestone.id,
+    });
+    const completedIssues = issues.filter((i) => i.state === "Done" || i.state === "Canceled").length;
+    return {
+        milestone,
+        totalIssues: issues.length,
+        completedIssues,
+    };
+}
+/** Find a milestone by name within a project */
+export async function findMilestoneByName(client, projectId, name) {
+    const milestones = await client.listMilestones(projectId);
+    return milestones.find((m) => m.name === name) ?? null;
+}
+//# sourceMappingURL=milestones.js.map

package/dist/linear/milestones.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"milestones.js","sourceRoot":"","sources":["../../src/linear/milestones.ts"],"names":[],"mappings":"AAEA,yCAAyC;AACzC,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAoB,EACpB,SAAiB,EACjB,IAAY,EACZ,WAAoB,EACpB,UAAmB;IAEnB,OAAO,MAAM,CAAC,eAAe,CAAC;QAC5B,SAAS;QACT,IAAI;QACJ,WAAW;QACX,UAAU;KACX,CAAC,CAAC;AACL,CAAC;AAED,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAoB,EACpB,SAAiB,EACjB,aAAqB;IAMrB,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IAC9E,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,yBAAyB,aAAa,gBAAgB,SAAS,EAAE,CAClE,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC;QACrC,SAAS;QACT,WAAW,EAAE,SAAS,CAAC,EAAE;KAC1B,CAAC,CAAC;IACH,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CACnC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,IAAI,CAAC,CAAC,KAAK,KAAK,UAAU,CACpD,CAAC,MAAM,CAAC;IAET,OAAO;QACL,SAAS;QACT,WAAW,EAAE,MAAM,CAAC,MAAM;QAC1B,eAAe;KAChB,CAAC;AACJ,CAAC;AAED,gDAAgD;AAChD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAoB,EACpB,SAAiB,EACjB,IAAY;IAEZ,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IAC1D,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC;AACzD,CAAC"}

package/dist/linear/projects.d.ts

@@ -0,0 +1,16 @@
+import { LinearClient, type LinearProject } from "./client.js";
+/** Valid project states in forward-only order */
+export declare const PROJECT_STATES: readonly ["Backlog", "Planned", "In Progress", "In Review", "Done"];
+export type ProjectState = (typeof PROJECT_STATES)[number];
+/**
+ * Validate that a project state transition is forward-only.
+ * Backlog -> Planned -> In Progress -> In Review -> Done.
+ * Same-state transitions are not valid (no-op).
+ */
+export declare function isValidTransition(from: string, to: string): boolean;
+/** Create a new project in Backlog state (used during triage) */
+export declare function createTriageProject(client: LinearClient, name: string, description: string, teamIds: string[]): Promise<LinearProject>;
+/** Transition a project to a target state with forward-only validation */
+export declare function transitionProject(client: LinearClient, projectId: string, targetState: string): Promise<LinearProject>;
+/** Find an existing project by exact name (for dedup during triage) */
+export declare function findProjectByName(client: LinearClient, name: string): Promise<LinearProject | null>;

package/dist/linear/projects.js

@@ -0,0 +1,50 @@
+/** Valid project states in forward-only order */
+export const PROJECT_STATES = [
+    "Backlog",
+    "Planned",
+    "In Progress",
+    "In Review",
+    "Done",
+];
+/** State index map for transition validation */
+const stateIndex = new Map(PROJECT_STATES.map((s, i) => [s, i]));
+/**
+ * Validate that a project state transition is forward-only.
+ * Backlog -> Planned -> In Progress -> In Review -> Done.
+ * Same-state transitions are not valid (no-op).
+ */
+export function isValidTransition(from, to) {
+    const fromIdx = stateIndex.get(from);
+    const toIdx = stateIndex.get(to);
+    if (fromIdx === undefined || toIdx === undefined)
+        return false;
+    return toIdx > fromIdx;
+}
+/** Create a new project in Backlog state (used during triage) */
+export async function createTriageProject(client, name, description, teamIds) {
+    return client.createProject({
+        name,
+        description,
+        teamIds,
+        state: "Backlog",
+    });
+}
+/** Transition a project to a target state with forward-only validation */
+export async function transitionProject(client, projectId, targetState) {
+    // Fetch current project to validate transition
+    const projects = await client.listProjects();
+    const project = projects.find((p) => p.id === projectId);
+    if (!project) {
+        throw new Error(`Project not found: ${projectId}`);
+    }
+    if (!isValidTransition(project.state, targetState)) {
+        throw new Error(`Invalid project transition: ${project.state} -> ${targetState}`);
+    }
+    return client.updateProject(projectId, { state: targetState });
+}
+/** Find an existing project by exact name (for dedup during triage) */
+export async function findProjectByName(client, name) {
+    const projects = await client.listProjects({ query: name });
+    return projects.find((p) => p.name === name) ?? null;
+}
+//# sourceMappingURL=projects.js.map

package/dist/linear/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../src/linear/projects.ts"],"names":[],"mappings":"AAEA,iDAAiD;AACjD,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,SAAS;IACT,SAAS;IACT,aAAa;IACb,WAAW;IACX,MAAM;CACE,CAAC;AAGX,gDAAgD;AAChD,MAAM,UAAU,GAAG,IAAI,GAAG,CACxB,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CACrC,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,EAAU;IACxD,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjC,IAAI,OAAO,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC/D,OAAO,KAAK,GAAG,OAAO,CAAC;AACzB,CAAC;AAED,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAoB,EACpB,IAAY,EACZ,WAAmB,EACnB,OAAiB;IAEjB,OAAO,MAAM,CAAC,aAAa,CAAC;QAC1B,IAAI;QACJ,WAAW;QACX,OAAO;QACP,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC;AACL,CAAC;AAED,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAoB,EACpB,SAAiB,EACjB,WAAmB;IAEnB,+CAA+C;IAC/C,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC;IAC7C,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;IACzD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,KAAK,EAAE,WAAW,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CACb,+BAA+B,OAAO,CAAC,KAAK,OAAO,WAAW,EAAE,CACjE,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAoB,EACpB,IAAY;IAEZ,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC;AACvD,CAAC"}

package/dist/reporter/human.d.ts

@@ -0,0 +1,2 @@
+import type { PipelineResult } from "../types.js";
+export declare function formatHumanReport(result: PipelineResult): string;

package/dist/reporter/human.js

@@ -0,0 +1,63 @@
+export function formatHumanReport(result) {
+    const lines = [];
+    // Header
+    const status = result.passed ? "PASSED" : "FAILED";
+    lines.push("## Verification Report");
+    lines.push(`**Status:** ${status}`);
+    lines.push(`**Iterations:** ${result.iteration}/${result.maxIterations}`);
+    const totalMs = result.gates.reduce((sum, g) => sum + g.duration_ms, 0);
+    lines.push(`**Duration:** ${formatDuration(totalMs)}`);
+    lines.push("");
+    // Gate results
+    lines.push("### Gates");
+    for (const gate of result.gates) {
+        const icon = gate.passed ? "[x]" : "[ ]";
+        const statusText = gate.passed ? "PASS" : "FAIL";
+        const dur = formatDuration(gate.duration_ms);
+        let suffix = "";
+        if (!gate.passed && gate.errors.length > 0) {
+            suffix = ` — ${gate.errors.length} error${gate.errors.length === 1 ? "" : "s"}`;
+        }
+        else if (gate.passed && gate.warnings.length > 0) {
+            suffix = ` — ${gate.warnings.length} warning${gate.warnings.length === 1 ? "" : "s"}`;
+        }
+        lines.push(`- ${icon} ${gate.gate}: ${statusText} (${dur})${suffix}`);
+    }
+    lines.push("");
+    // Errors section
+    const gatesWithErrors = result.gates.filter((g) => g.errors.length > 0);
+    if (gatesWithErrors.length > 0) {
+        lines.push("### Errors");
+        for (const gate of gatesWithErrors) {
+            lines.push(`#### ${gate.gate}`);
+            for (const err of gate.errors) {
+                const loc = err.file
+                    ? `${err.file}${err.line ? `:${err.line}` : ""}`
+                    : "";
+                const prefix = loc ? `${loc}: ` : "";
+                lines.push(`- ${prefix}${err.message}`);
+                if (err.remediation) {
+                    lines.push(`  > Fix: ${err.remediation}`);
+                }
+            }
+            lines.push("");
+        }
+    }
+    // Warnings section
+    const gatesWithWarnings = result.gates.filter((g) => g.warnings.length > 0);
+    if (gatesWithWarnings.length > 0) {
+        lines.push("### Warnings");
+        for (const gate of gatesWithWarnings) {
+            lines.push(`#### ${gate.gate}`);
+            for (const warning of gate.warnings) {
+                lines.push(`- ${warning}`);
+            }
+            lines.push("");
+        }
+    }
+    return lines.join("\n");
+}
+function formatDuration(ms) {
+    return `${(ms / 1000).toFixed(1)}s`;
+}
+//# sourceMappingURL=human.js.map