@elnora-ai/linear 1.0.1 → 2.0.0

package/dist/config/types.js

@@ -9,5 +9,6 @@ export const REFERENCE_NAMES = [
     "repos",
     "signal-sources",
     "workflows",
+    "label-policy",
 ];
 //# sourceMappingURL=types.js.map

package/dist/config/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,yEAAyE;AACzE,gEAAgE;AAIhE,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC/C,OAAO;IACP,UAAU;IACV,OAAO;IACP,OAAO;IACP,OAAO;IACP,gBAAgB;IAChB,WAAW;CACX,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,yEAAyE;AACzE,gEAAgE;AAYhE,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC/C,OAAO;IACP,UAAU;IACV,OAAO;IACP,OAAO;IACP,OAAO;IACP,gBAAgB;IAChB,WAAW;IACX,cAAc;CACd,CAAC"}

package/dist/curator/dispatch.d.ts

@@ -0,0 +1,52 @@
+import type { LinearClient } from "@linear/sdk";
+import type { CuratorAction, CuratorHighAction } from "./llm.js";
+import { type CuratorState } from "./state.js";
+export declare const MAX_MUTATIONS = 20;
+export declare const MAX_MEDIUM_QUEUED = 10;
+export interface DispatchOptions {
+    dryRun?: boolean;
+    stateDir?: string;
+    maxMutations?: number;
+    maxMedium?: number;
+    now?: Date;
+    /** Test hook: override the actual Linear mutation path. */
+    applyHigh?: (client: LinearClient, action: CuratorHighAction) => Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        error: string;
+    }>;
+}
+export interface DispatchResult {
+    applied: {
+        issue_id: string;
+        rule: string;
+        from: string;
+        to: string;
+    }[];
+    queued: {
+        issue_id: string;
+        rule: string;
+        thread_key: string;
+    }[];
+    reported: {
+        issue_id: string;
+        rule: string;
+        rationale: string;
+    }[];
+    skipped: {
+        issue_id: string;
+        rule: string;
+        reason: string;
+    }[];
+}
+/**
+ * Has this action been queued or applied within the debounce window?
+ */
+declare function isDebounced(state: CuratorState, action: CuratorAction, _now: Date): boolean;
+export declare function dispatchActions(client: LinearClient, actions: CuratorAction[], state: CuratorState, opts?: DispatchOptions): Promise<DispatchResult>;
+export declare const _internal: {
+    isDebounced: typeof isDebounced;
+};
+export {};
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/curator/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/curator/dispatch.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAuB,MAAM,UAAU,CAAC;AACtF,OAAO,EAAoB,KAAK,YAAY,EAAe,MAAM,YAAY,CAAC;AAE9E,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,MAAM,WAAW,eAAe;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,2DAA2D;IAC3D,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,iBAAiB,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtH;AAED,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACxE,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjE,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClE,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC9D;AAED;;GAEG;AACH,iBAAS,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAmBpF;AA6BD,wBAAsB,eAAe,CACpC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,aAAa,EAAE,EACxB,KAAK,EAAE,YAAY,EACnB,IAAI,GAAE,eAAoB,GACxB,OAAO,CAAC,cAAc,CAAC,CAkFzB;AAED,eAAO,MAAM,SAAS;;CAAkB,CAAC"}

package/dist/curator/dispatch.js

@@ -0,0 +1,144 @@
+// Curator action dispatcher.
+//
+// HIGH actions auto-apply (state change + rationale comment) up to MAX_MUTATIONS.
+// MEDIUM actions queue as pending questions in the state file — the Slack
+// integration (or a bot) is responsible for actually posting them; the
+// dispatcher just stages the question + sets the debounce key.
+// LOW actions go straight to the report (no side effects).
+//
+// All applied actions are recorded in `curator-report.jsonl` for audit.
+import { resolveStateId } from "../lib/bulk-graphql.js";
+import { withRateLimit } from "../utils/rate-limit.js";
+import { appendReportLine, debounceKey } from "./state.js";
+export const MAX_MUTATIONS = 20;
+export const MAX_MEDIUM_QUEUED = 10;
+/**
+ * Has this action been queued or applied within the debounce window?
+ */
+function isDebounced(state, action, _now) {
+    if (action.tier === "HIGH") {
+        const key = debounceKey(action.issue_id, {
+            from: action.from_state,
+            to: action.to_state,
+        });
+        return state.pending_questions.some((q) => q.thread_key === key) || state.processed_thread_keys.includes(key);
+    }
+    if (action.tier === "MEDIUM") {
+        const proposed = action.proposed_action;
+        const key = debounceKey(action.issue_id, { type: proposed.type, from: proposed.from, to: proposed.to });
+        const recentlyAsked = state.pending_questions.some((q) => q.thread_key === key);
+        if (recentlyAsked)
+            return true;
+        if (!state.processed_thread_keys.includes(key))
+            return false;
+        // Even processed keys age out — but we don't have per-key timestamps,
+        // so we conservatively skip if the key is in the processed set.
+        return true;
+    }
+    return false;
+}
+async function applyHighAction(client, action) {
+    // Look up the state ID for the team prefix the issue belongs to.
+    const match = action.issue_id.match(/^([A-Z]+)-\d+$/);
+    if (!match) {
+        return { ok: false, error: `Cannot parse team prefix from issue_id ${action.issue_id}` };
+    }
+    const teamKey = match[1];
+    const stateId = await withRateLimit(() => resolveStateId(teamKey, action.to_state));
+    if (!stateId) {
+        return { ok: false, error: `State "${action.to_state}" not found on team ${teamKey}` };
+    }
+    // Resolve the issue UUID via the public CLI's findIssueByIdentifier — but we
+    // only need the UUID for the SDK update call. Cheapest path: client.issue.
+    const issue = await withRateLimit(() => client.issue(action.issue_id));
+    const update = await withRateLimit(() => client.updateIssue(issue.id, { stateId }));
+    if (!update.success) {
+        return { ok: false, error: "Linear API rejected the state update" };
+    }
+    // Comment with rationale.
+    const body = `${action.rationale}\n\n_Auto-applied by elnora-linear curator (rule ${action.rule})._`;
+    await withRateLimit(() => client.createComment({ issueId: issue.id, body }));
+    return { ok: true };
+}
+export async function dispatchActions(client, actions, state, opts = {}) {
+    const now = opts.now ?? new Date();
+    const maxMutations = opts.maxMutations ?? MAX_MUTATIONS;
+    const maxMedium = opts.maxMedium ?? MAX_MEDIUM_QUEUED;
+    const result = { applied: [], queued: [], reported: [], skipped: [] };
+    let highCount = 0;
+    let mediumCount = 0;
+    for (const action of actions) {
+        if (isDebounced(state, action, now)) {
+            result.skipped.push({ issue_id: action.issue_id, rule: action.rule, reason: "debounced" });
+            continue;
+        }
+        if (action.tier === "LOW") {
+            result.reported.push({ issue_id: action.issue_id, rule: action.rule, rationale: action.rationale });
+            appendReportLine({ tier: "LOW", action }, { stateDir: opts.stateDir });
+            continue;
+        }
+        if (action.tier === "HIGH") {
+            if (highCount >= maxMutations) {
+                result.skipped.push({ issue_id: action.issue_id, rule: action.rule, reason: "cap_high" });
+                continue;
+            }
+            if (opts.dryRun) {
+                highCount++;
+                result.applied.push({
+                    issue_id: action.issue_id,
+                    rule: action.rule,
+                    from: action.from_state,
+                    to: action.to_state,
+                });
+                appendReportLine({ tier: "HIGH", action, dryRun: true }, { stateDir: opts.stateDir });
+                continue;
+            }
+            try {
+                const apply = opts.applyHigh ?? applyHighAction;
+                const res = await apply(client, action);
+                if (res.ok) {
+                    highCount++;
+                    result.applied.push({
+                        issue_id: action.issue_id,
+                        rule: action.rule,
+                        from: action.from_state,
+                        to: action.to_state,
+                    });
+                    const key = debounceKey(action.issue_id, { from: action.from_state, to: action.to_state });
+                    state.processed_thread_keys.push(key);
+                    appendReportLine({ tier: "HIGH", action, applied: true }, { stateDir: opts.stateDir });
+                }
+                else {
+                    result.skipped.push({ issue_id: action.issue_id, rule: action.rule, reason: res.error });
+                    appendReportLine({ tier: "HIGH", action, error: res.error }, { stateDir: opts.stateDir });
+                }
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                result.skipped.push({ issue_id: action.issue_id, rule: action.rule, reason: msg });
+                appendReportLine({ tier: "HIGH", action, error: msg }, { stateDir: opts.stateDir });
+            }
+            continue;
+        }
+        // MEDIUM
+        if (mediumCount >= maxMedium) {
+            result.skipped.push({ issue_id: action.issue_id, rule: action.rule, reason: "cap_medium" });
+            continue;
+        }
+        mediumCount++;
+        const m = action;
+        const proposed = m.proposed_action;
+        const key = debounceKey(m.issue_id, { type: proposed.type, from: proposed.from, to: proposed.to });
+        state.pending_questions.push({
+            issue_id: m.issue_id,
+            thread_key: key,
+            posted_at: now.toISOString(),
+            question_text: m.question_text,
+        });
+        result.queued.push({ issue_id: m.issue_id, rule: m.rule, thread_key: key });
+        appendReportLine({ tier: "MEDIUM", action, queued: true }, { stateDir: opts.stateDir });
+    }
+    return result;
+}
+export const _internal = { isDebounced };
+//# sourceMappingURL=dispatch.js.map

package/dist/curator/dispatch.js.map

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

package/dist/curator/index.d.ts

@@ -0,0 +1,5 @@
+export { type DispatchOptions, type DispatchResult, dispatchActions, MAX_MEDIUM_QUEUED, MAX_MUTATIONS, } from "./dispatch.js";
+export { type CuratorAction, type CuratorHighAction, type CuratorLlmOptions, type CuratorLowAction, type CuratorMediumAction, type CuratorResponse, callCuratorLlm, loadCuratorSystemPrompt, parseActionsJson, } from "./llm.js";
+export { buildSnapshot, type PendingQuestion, type SnapshotInput } from "./snapshot.js";
+export { appendReportLine, type CuratorRunStats, type CuratorState, debounceKey, loadState, reportPath, resolveStateDir, type StateDirOptions, saveState, statePath, } from "./state.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/curator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/curator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,eAAe,EACf,iBAAiB,EACjB,aAAa,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,cAAc,EACd,uBAAuB,EACvB,gBAAgB,GAChB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AACxF,OAAO,EACN,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,WAAW,EACX,SAAS,EACT,UAAU,EACV,eAAe,EACf,KAAK,eAAe,EACpB,SAAS,EACT,SAAS,GACT,MAAM,YAAY,CAAC"}

package/dist/curator/index.js

@@ -0,0 +1,5 @@
+export { dispatchActions, MAX_MEDIUM_QUEUED, MAX_MUTATIONS, } from "./dispatch.js";
+export { callCuratorLlm, loadCuratorSystemPrompt, parseActionsJson, } from "./llm.js";
+export { buildSnapshot } from "./snapshot.js";
+export { appendReportLine, debounceKey, loadState, reportPath, resolveStateDir, saveState, statePath, } from "./state.js";
+//# sourceMappingURL=index.js.map

package/dist/curator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/curator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,eAAe,EACf,iBAAiB,EACjB,aAAa,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EAON,cAAc,EACd,uBAAuB,EACvB,gBAAgB,GAChB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAA4C,MAAM,eAAe,CAAC;AACxF,OAAO,EACN,gBAAgB,EAGhB,WAAW,EACX,SAAS,EACT,UAAU,EACV,eAAe,EAEf,SAAS,EACT,SAAS,GACT,MAAM,YAAY,CAAC"}

package/dist/curator/llm.d.ts

@@ -0,0 +1,70 @@
+export interface CuratorActionBase {
+    issue_id: string;
+    tier: "HIGH" | "MEDIUM" | "LOW";
+    rule: string;
+    rationale: string;
+}
+export interface CuratorHighAction extends CuratorActionBase {
+    tier: "HIGH";
+    decision: "set_state";
+    from_state: string;
+    to_state: string;
+    signals_cited: string[];
+}
+export interface CuratorMediumAction extends CuratorActionBase {
+    tier: "MEDIUM";
+    decision: "ask_in_slack";
+    proposed_action: {
+        type: "set_state";
+        from: string;
+        to: string;
+    };
+    alternative_action?: {
+        type: "set_state";
+        from: string;
+        to: string;
+    };
+    question_text: string;
+    signals_cited: string[];
+}
+export interface CuratorLowAction extends CuratorActionBase {
+    tier: "LOW";
+    decision: "report_only";
+}
+export type CuratorAction = CuratorHighAction | CuratorMediumAction | CuratorLowAction;
+export interface CuratorResponse {
+    actions: CuratorAction[];
+    summary: {
+        total_issues_reviewed?: number;
+        high_count?: number;
+        medium_count?: number;
+        low_count?: number;
+        skipped_no_signal?: number;
+        notes?: string;
+    };
+}
+export declare function loadCuratorSystemPrompt(opts?: {
+    agentPath?: string;
+}): string;
+/**
+ * Strip ```json fences (the LLM sometimes adds them despite the contract).
+ */
+declare function stripFences(text: string): string;
+export declare function parseActionsJson(raw: string): CuratorResponse;
+export interface CuratorLlmOptions {
+    model?: string;
+    apiKey?: string;
+    maxTokens?: number;
+    agentPath?: string;
+}
+/**
+ * Run the curator LLM call. Returns the parsed response. Throws on missing
+ * ANTHROPIC_API_KEY (caller catches and surfaces in the report).
+ */
+export declare function callCuratorLlm(snapshot: string, opts?: CuratorLlmOptions): Promise<CuratorResponse>;
+export declare const _internal: {
+    stripFences: typeof stripFences;
+    BUNDLED_AGENT_PATH: string;
+};
+export {};
+//# sourceMappingURL=llm.d.ts.map

package/dist/curator/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/curator/llm.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,iBAAiB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC7D,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,cAAc,CAAC;IACzB,eAAe,EAAE;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,kBAAkB,CAAC,EAAE;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IAC1D,IAAI,EAAE,KAAK,CAAC;IACZ,QAAQ,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,gBAAgB,CAAC;AAEvF,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,OAAO,EAAE;QACR,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACF;AAED,wBAAgB,uBAAuB,CAAC,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAmBjF;AAED;;GAEG;AACH,iBAAS,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGzC;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CA0B7D;AAED,MAAM,WAAW,iBAAiB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAKD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC,CA6B7G;AAED,eAAO,MAAM,SAAS;;;CAAsC,CAAC"}

package/dist/curator/llm.js

@@ -0,0 +1,107 @@
+// Anthropic-API client for the curator.
+//
+// One Messages.create() call per curator run. The system prompt is the body
+// of `agents/linear-state-curator.md` (loaded at runtime); the user content is
+// the markdown snapshot from `snapshot.ts`. Response shape is parsed by
+// `parseActionsJson`.
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const HERE = dirname(fileURLToPath(import.meta.url));
+// dist/curator/llm.js → package root is two up; same for src/curator/llm.ts.
+const PACKAGE_ROOT = resolve(HERE, "..", "..");
+const BUNDLED_AGENT_PATH = join(PACKAGE_ROOT, "agents", "linear-state-curator.md");
+export function loadCuratorSystemPrompt(opts = {}) {
+    const candidates = [];
+    if (opts.agentPath)
+        candidates.push(opts.agentPath);
+    candidates.push(BUNDLED_AGENT_PATH);
+    for (const path of candidates) {
+        try {
+            if (existsSync(path)) {
+                const raw = readFileSync(path, "utf-8");
+                // Strip the YAML frontmatter; the body is the prompt.
+                const match = raw.match(/^---\n[\s\S]*?\n---\n([\s\S]*)$/);
+                return (match ? match[1] : raw).trim();
+            }
+        }
+        catch {
+            // Try next candidate.
+        }
+    }
+    throw new Error("Could not locate agents/linear-state-curator.md for curator system prompt. Pass agentPath explicitly.");
+}
+/**
+ * Strip ```json fences (the LLM sometimes adds them despite the contract).
+ */
+function stripFences(text) {
+    const fenced = text.match(/^```(?:json)?\s*([\s\S]*?)\s*```\s*$/);
+    return fenced ? fenced[1].trim() : text.trim();
+}
+export function parseActionsJson(raw) {
+    const trimmed = stripFences(raw);
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch (err) {
+        throw new Error(`Curator LLM output is not valid JSON: ${err.message}`);
+    }
+    if (typeof parsed !== "object" || parsed === null) {
+        throw new Error("Curator LLM output must be a JSON object.");
+    }
+    const obj = parsed;
+    if (!Array.isArray(obj.actions)) {
+        throw new Error("Curator LLM output is missing `actions` array.");
+    }
+    const validActions = [];
+    for (const raw of obj.actions) {
+        if (typeof raw !== "object" || raw === null)
+            continue;
+        const a = raw;
+        if (!a.issue_id || !a.tier || !a.rule)
+            continue;
+        if (a.tier !== "HIGH" && a.tier !== "MEDIUM" && a.tier !== "LOW")
+            continue;
+        validActions.push(a);
+    }
+    const summary = typeof obj.summary === "object" && obj.summary !== null ? obj.summary : {};
+    return { actions: validActions, summary };
+}
+const DEFAULT_MODEL = "claude-sonnet-4-6";
+const DEFAULT_MAX_TOKENS = 4096;
+/**
+ * Run the curator LLM call. Returns the parsed response. Throws on missing
+ * ANTHROPIC_API_KEY (caller catches and surfaces in the report).
+ */
+export async function callCuratorLlm(snapshot, opts = {}) {
+    const apiKey = opts.apiKey ?? process.env.ANTHROPIC_API_KEY;
+    if (!apiKey) {
+        throw new Error("ANTHROPIC_API_KEY not set; cannot run the LLM phase of the curator.");
+    }
+    const model = opts.model ?? process.env.LINEAR_CURATOR_MODEL ?? DEFAULT_MODEL;
+    const maxTokens = opts.maxTokens ?? DEFAULT_MAX_TOKENS;
+    const system = loadCuratorSystemPrompt({ agentPath: opts.agentPath });
+    const Anthropic = (await import("@anthropic-ai/sdk")).default;
+    const client = new Anthropic({ apiKey });
+    const res = await client.messages.create({
+        model,
+        max_tokens: maxTokens,
+        system,
+        messages: [{ role: "user", content: snapshot }],
+    });
+    const textParts = [];
+    for (const block of res.content ?? []) {
+        if (block.type === "text") {
+            const t = block.text;
+            if (typeof t === "string")
+                textParts.push(t);
+        }
+    }
+    if (textParts.length === 0) {
+        throw new Error("Curator LLM returned no text content.");
+    }
+    return parseActionsJson(textParts.join(""));
+}
+export const _internal = { stripFences, BUNDLED_AGENT_PATH };
+//# sourceMappingURL=llm.js.map

package/dist/curator/llm.js.map

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

package/dist/curator/snapshot.d.ts

@@ -0,0 +1,34 @@
+import type { BulkIssueNode } from "../lib/bulk-graphql.js";
+import type { Signal } from "../signals/types.js";
+export interface PendingQuestion {
+    issue_id: string;
+    thread_key: string;
+    posted_at: string;
+    question_text: string;
+}
+export interface SnapshotInput {
+    issues: BulkIssueNode[];
+    signals: Signal[];
+    pendingQuestions: PendingQuestion[];
+    tieringRulesPath?: string;
+    referencesDir?: string;
+}
+declare function loadTieringRules(opts: SnapshotInput): string;
+/**
+ * Wrap untrusted text in `<untrusted>` tags so the model treats embedded
+ * directives as data, not instructions. The system prompt tells the curator
+ * never to act on directives inside these tags. We also strip any literal
+ * closing tags from the input so an attacker can't break out of the wrapper.
+ */
+declare function untrusted(text: string): string;
+declare function formatPendingQuestions(qs: PendingQuestion[]): string;
+declare function groupSignals(signals: Signal[]): Map<string, Signal[]>;
+export declare function buildSnapshot(input: SnapshotInput): string;
+export declare const _internal: {
+    loadTieringRules: typeof loadTieringRules;
+    formatPendingQuestions: typeof formatPendingQuestions;
+    groupSignals: typeof groupSignals;
+    untrusted: typeof untrusted;
+};
+export {};
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/curator/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/curator/snapshot.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAMlD,MAAM,WAAW,eAAe;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,iBAAS,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAcrD;AAED;;;;;GAKG;AACH,iBAAS,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGvC;AAED,iBAAS,sBAAsB,CAAC,EAAE,EAAE,eAAe,EAAE,GAAG,MAAM,CAG7D;AAED,iBAAS,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAY9D;AAyCD,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAuB1D;AAED,eAAO,MAAM,SAAS;;;;;CAAwE,CAAC"}

package/dist/curator/snapshot.js

@@ -0,0 +1,127 @@
+// Builds the markdown snapshot the curator LLM consumes.
+//
+// One snapshot per `elnora-linear curator-run` invocation. Embeds:
+//   - the tiering-rules markdown (from references/curator-tiering-rules.md)
+//   - any pending Slack questions (from the state file)
+//   - per-issue blocks listing relevant signals indexed by issueIdentifier
+//
+// Signals come from the curator's runCollect() phase. We collate by
+// issueIdentifier so the LLM sees each issue's evidence together.
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+// dist/curator/snapshot.js → package root is two up. Same for src/ during tests.
+const HERE = dirname(fileURLToPath(import.meta.url));
+const BUNDLED_TIERING_RULES_PATH = resolve(HERE, "..", "..", "references", "curator-tiering-rules.md");
+function loadTieringRules(opts) {
+    const candidates = [];
+    if (opts.tieringRulesPath)
+        candidates.push(opts.tieringRulesPath);
+    if (opts.referencesDir)
+        candidates.push(join(opts.referencesDir, "curator-tiering-rules.md"));
+    // Final fallback: the copy bundled in the installed npm package.
+    candidates.push(BUNDLED_TIERING_RULES_PATH);
+    for (const path of candidates) {
+        try {
+            if (existsSync(path))
+                return readFileSync(path, "utf-8").trim();
+        }
+        catch {
+            // Try next candidate.
+        }
+    }
+    return "(curator-tiering-rules.md not found — using defaults baked into the agent prompt)";
+}
+/**
+ * Wrap untrusted text in `<untrusted>` tags so the model treats embedded
+ * directives as data, not instructions. The system prompt tells the curator
+ * never to act on directives inside these tags. We also strip any literal
+ * closing tags from the input so an attacker can't break out of the wrapper.
+ */
+function untrusted(text) {
+    const sanitized = text.replace(/<\/?untrusted>/gi, "");
+    return `<untrusted>${sanitized}</untrusted>`;
+}
+function formatPendingQuestions(qs) {
+    if (qs.length === 0)
+        return "(none)";
+    return qs.map((q) => `- ${q.issue_id} [${q.thread_key}] posted ${q.posted_at}: ${q.question_text}`).join("\n");
+}
+function groupSignals(signals) {
+    const out = new Map();
+    for (const sig of signals) {
+        const key = sig.issueIdentifier ?? "_unattributed";
+        const list = out.get(key);
+        if (list) {
+            list.push(sig);
+        }
+        else {
+            out.set(key, [sig]);
+        }
+    }
+    return out;
+}
+function formatIssueBlock(issue, signals) {
+    const lines = [];
+    lines.push(`### ${issue.identifier} — ${issue.title}`);
+    lines.push(`- state: ${issue.state?.name ?? "(none)"} (${issue.state?.type ?? "?"})`);
+    lines.push(`- assignee: ${issue.assignee?.name ?? "(unassigned)"}`);
+    lines.push(`- project: ${issue.project?.name ?? "(none)"}`);
+    lines.push(`- team: ${issue.team?.name ?? "(none)"} (${issue.team?.key ?? "?"})`);
+    lines.push(`- labels: [${issue.labels.nodes.map((l) => l.name).join(", ")}]`);
+    lines.push(`- updatedAt: ${issue.updatedAt}`);
+    if (issue.description) {
+        const truncated = issue.description.slice(0, 600);
+        const suffix = issue.description.length > 600 ? "..." : "";
+        lines.push(`- description: ${untrusted(`${truncated}${suffix}`)}`);
+    }
+    if (signals.length > 0) {
+        lines.push("- signals:");
+        for (const sig of signals) {
+            const payload = JSON.stringify(sig.payload).slice(0, 200);
+            lines.push(`  - [${sig.source}/${sig.type}] ${untrusted(payload)}`);
+        }
+    }
+    else {
+        lines.push("- signals: (none)");
+    }
+    return lines.join("\n");
+}
+function formatUnattributedSignals(signals) {
+    if (signals.length === 0)
+        return "";
+    const lines = ["", "## Unattributed signals (no issueIdentifier)"];
+    for (const sig of signals.slice(0, 50)) {
+        const payload = JSON.stringify(sig.payload).slice(0, 200);
+        lines.push(`- [${sig.source}/${sig.type}] ${untrusted(payload)}`);
+    }
+    if (signals.length > 50) {
+        lines.push(`- (+${signals.length - 50} more elided)`);
+    }
+    return lines.join("\n");
+}
+export function buildSnapshot(input) {
+    const rules = loadTieringRules(input);
+    const grouped = groupSignals(input.signals);
+    const issueBlocks = [];
+    for (const issue of input.issues) {
+        const signals = grouped.get(issue.identifier) ?? [];
+        issueBlocks.push(formatIssueBlock(issue, signals));
+    }
+    const unattributed = formatUnattributedSignals(grouped.get("_unattributed") ?? []);
+    return [
+        "## Tiering rules",
+        rules,
+        "",
+        "## Pending Slack questions (awareness only — do NOT emit actions for these)",
+        formatPendingQuestions(input.pendingQuestions),
+        "",
+        "## Open issues snapshot",
+        issueBlocks.join("\n\n"),
+        unattributed,
+    ]
+        .join("\n")
+        .trim();
+}
+export const _internal = { loadTieringRules, formatPendingQuestions, groupSignals, untrusted };
+//# sourceMappingURL=snapshot.js.map

package/dist/curator/snapshot.js.map

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