@elnora-ai/linear 1.0.0

package/commands/linear-my-issues.md

@@ -0,0 +1,25 @@
+---
+name: linear-my-issues
+description: List Linear issues assigned to you, grouped by state
+allowed-tools: Bash, Read
+---
+
+# My Linear Issues
+
+List every Linear issue currently assigned to the viewer.
+
+## Run
+
+```bash
+elnora-linear my-issues --limit 50 --output json
+```
+
+## Present
+
+Group by state in this order: `In Progress`, `Todo`, `Backlog`, `Done` (last 7 days only), `Canceled` (hide unless asked). Within each state, sort by `updatedAt` descending. Show identifier, title, team, project.
+
+If the list is empty, say so cleanly: "Nothing assigned." Don't fabricate.
+
+## Don't
+
+- Don't include closed/cancelled issues older than 7 days — the user wants their active load

package/commands/linear-search.md

@@ -0,0 +1,32 @@
+---
+name: linear-search
+description: Search Linear issues by keyword, team, assignee, or state
+argument-hint: "<query>"
+allowed-tools: Bash, Read
+---
+
+# Linear Search
+
+Search Linear issues for: **{{query}}**
+
+## Run
+
+```bash
+elnora-linear search --query "{{query}}" --limit 25 --output json
+```
+
+For more focused queries, add flags:
+- `--team ENG` — restrict to a team
+- `--assignee me` — only your issues (or `--assignee "Alice Smith"`)
+- `--state "In Progress"` — by workflow state
+- `--limit <n>` — default 25
+- `--output text` — for human-readable; default here is JSON for parsing
+
+## Present
+
+Render the JSON as a table: identifier, state, assignee, title. Highlight any issue whose state matches what the user is looking for.
+
+## Don't
+
+- Don't paginate; the `--limit` flag controls volume
+- Don't apply mutations — that's `/linear-bulk`, `/linear-cleanup`, or the `linear-issue-updater` agent

package/commands/linear-sync.md

@@ -0,0 +1,54 @@
+---
+name: linear-sync
+description: Populate or refresh the Linear reference files (teams, projects, users, workflows)
+allowed-tools: Bash, Read
+---
+
+# Linear Sync
+
+Refresh the reference files the rest of `elnora-linear` reads — teams, projects, users, workflow states. Run this on first install and any time your Linear workspace changes (new team, renamed project, etc.).
+
+## Run
+
+The fast path: refresh everything auto-discoverable from the Linear API.
+
+```bash
+elnora-linear sync all
+```
+
+Pick one target:
+
+```bash
+elnora-linear sync teams
+elnora-linear sync projects
+elnora-linear sync users
+elnora-linear sync workflows
+```
+
+Validate references:
+
+```bash
+elnora-linear sync verify
+```
+
+Reports each reference as `user-file` (populated) or `placeholder` (default, empty).
+
+Import an existing config bundle:
+
+```bash
+elnora-linear sync import --from /path/to/bundle.json
+```
+
+## Where it writes
+
+In precedence order:
+1. `--references-dir <path>` flag
+2. `LINEAR_REFERENCES_DIR` env var
+3. `~/.config/elnora-linear/` (auto-created if needed)
+
+Never writes to the bundled defaults in the installed package — those stay clean.
+
+## Don't
+
+- Don't run `sync all` repeatedly in a loop — it issues N×teams API calls
+- Don't commit the populated reference files to a public repo — they're user-specific data

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+// elnora-linear CLI entrypoint.
+//
+// Commander-based subcommand dispatcher. Each subcommand is a thin wrapper
+// over a function in src/commands/*; the heavy lifting (auth, API calls,
+// formatting) happens there.
+import { Command, Option } from "commander";
+import { runBulk } from "./commands/bulk.js";
+import { runCleanup } from "./commands/cleanup.js";
+import { runCurator } from "./commands/curator.js";
+import { runMyIssues } from "./commands/my-issues.js";
+import { runSearch } from "./commands/search.js";
+import { AUTO_SYNC_TARGETS, runSyncAll, runSyncImport, runSyncTarget, runSyncVerify, } from "./commands/sync.js";
+const VERSION = "0.0.0";
+const program = new Command()
+    .name("elnora-linear")
+    .description("Linear workspace CLI for Claude Code — search, bulk edit, agents, config-driven curator.")
+    .version(VERSION, "-v, --version", "Print version")
+    .helpOption("-h, --help", "Show this help");
+program
+    .command("search")
+    .description("Search Linear issues")
+    .option("-q, --query <text>", "Search text (matches issue title + description)")
+    .option("-t, --team <key>", "Restrict to team key, e.g. ENG")
+    .option("-a, --assignee <name>", "Assignee name, email, or 'me'")
+    .option("-s, --state <name>", "Workflow state name, e.g. 'In Progress'")
+    .option("-l, --limit <n>", "Max results", (v) => Number.parseInt(v, 10), 25)
+    .option("-o, --output <mode>", "Output mode: text or json", "text")
+    .action(async (opts) => {
+    await runSearch(opts);
+});
+program
+    .command("my-issues")
+    .description("List issues assigned to you")
+    .option("-l, --limit <n>", "Max results", (v) => Number.parseInt(v, 10), 25)
+    .option("-o, --output <mode>", "Output mode: text or json", "text")
+    .action(async (opts) => {
+    await runMyIssues(opts);
+});
+program
+    .command("bulk")
+    .description("Apply the same change to many issues. Default is dry-run; pass --yes to commit.")
+    .option("-q, --query <text>", "Filter: search text")
+    .option("-t, --team <key>", "Filter: team key")
+    .option("-a, --assignee <name>", "Filter: assignee name, email, or 'me'")
+    .option("-s, --state <name>", "Filter: workflow state name")
+    .option("--set-state <name>", "Mutation: move matching issues to this state")
+    .option("--add-comment <text>", "Mutation: add this comment to each matching issue")
+    .option("-l, --limit <n>", "Max issues to touch", (v) => Number.parseInt(v, 10), 100)
+    .option("-y, --yes", "Commit the mutations (default is dry-run)", false)
+    .option("-o, --output <mode>", "Output mode: text or json", "text")
+    .action(async (opts) => {
+    await runBulk(opts);
+});
+program
+    .command("cleanup")
+    .description("Find stale issues and act on them. Default is dry-run; pass --yes to commit.")
+    .option("-t, --team <key>", "Filter: team key")
+    .option("-s, --states <names>", 'Filter: comma-separated state names (default "Todo,Backlog")', (v) => v.split(",").map((s) => s.trim()))
+    .option("--inactive-days <n>", "Issues with no activity for at least N days", (v) => Number.parseInt(v, 10), 30)
+    .addOption(new Option("--action <action>", "What to do with stale issues")
+    .choices(["close", "cancel", "comment"])
+    .default("comment"))
+    .option("--message <text>", "Comment text (overrides default cleanup message)")
+    .option("-l, --limit <n>", "Max issues to consider", (v) => Number.parseInt(v, 10), 100)
+    .option("-y, --yes", "Commit the mutations (default is dry-run)", false)
+    .option("-o, --output <mode>", "Output mode: text or json", "text")
+    .action(async (opts) => {
+    await runCleanup(opts);
+});
+const sync = program
+    .command("sync")
+    .description("Populate or refresh reference files. Run `elnora-linear sync --help` for subcommands.");
+sync
+    .command("all")
+    .description("Refresh every auto-discoverable target (teams, projects, users, workflows)")
+    .option("--references-dir <path>", "Override default references directory")
+    .option("-o, --output <mode>", "Output mode: text or json", "text")
+    .action(async (opts) => {
+    await runSyncAll(opts);
+});
+for (const target of AUTO_SYNC_TARGETS) {
+    sync
+        .command(target)
+        .description(`Fetch ${target} from the Linear API and write references/${target}.json`)
+        .option("--references-dir <path>", "Override default references directory")
+        .option("-o, --output <mode>", "Output mode: text or json", "text")
+        .action(async (opts) => {
+        await runSyncTarget(target, opts);
+    });
+}
+sync
+    .command("verify")
+    .description("Validate every reference file against its schema; report which are user-populated vs placeholder.")
+    .option("--references-dir <path>", "Override default references directory")
+    .option("-o, --output <mode>", "Output mode: text or json", "text")
+    .action((opts) => {
+    runSyncVerify(opts);
+});
+sync
+    .command("import")
+    .description("Import a JSON bundle (top-level keys = reference names) into individual reference files.")
+    .requiredOption("--from <path>", "Path to the bundle JSON file")
+    .option("--references-dir <path>", "Override default references directory")
+    .option("-o, --output <mode>", "Output mode: text or json", "text")
+    .action((opts) => {
+    runSyncImport(opts);
+});
+program
+    .command("curator-run")
+    .description("Collect signals from configured signal sources and report. (Rule engine coming in a follow-up.)")
+    .option("--source <name>", "Run only the named source (matches signal_sources[].name)")
+    .option("--references-dir <path>", "Override default references directory")
+    .option("-o, --output <mode>", "Output mode: text or json", "text")
+    .action(async (opts) => {
+    await runCurator(opts);
+});
+try {
+    await program.parseAsync(process.argv);
+}
+catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`${message}\n`);
+    process.exit(1);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,gCAAgC;AAChC,EAAE;AACF,2EAA2E;AAC3E,yEAAyE;AACzE,6BAA6B;AAE7B,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EACN,iBAAiB,EAEjB,UAAU,EACV,aAAa,EACb,aAAa,EACb,aAAa,GACb,MAAM,oBAAoB,CAAC;AAE5B,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE;KAC3B,IAAI,CAAC,eAAe,CAAC;KACrB,WAAW,CAAC,0FAA0F,CAAC;KACvG,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,eAAe,CAAC;KAClD,UAAU,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;AAE7C,OAAO;KACL,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,sBAAsB,CAAC;KACnC,MAAM,CAAC,oBAAoB,EAAE,iDAAiD,CAAC;KAC/E,MAAM,CAAC,kBAAkB,EAAE,gCAAgC,CAAC;KAC5D,MAAM,CAAC,uBAAuB,EAAE,+BAA+B,CAAC;KAChE,MAAM,CAAC,oBAAoB,EAAE,yCAAyC,CAAC;KACvE,MAAM,CAAC,iBAAiB,EAAE,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;KAC3E,MAAM,CAAC,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,CAAC;KAClE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACtB,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC;AAEJ,OAAO;KACL,OAAO,CAAC,WAAW,CAAC;KACpB,WAAW,CAAC,6BAA6B,CAAC;KAC1C,MAAM,CAAC,iBAAiB,EAAE,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;KAC3E,MAAM,CAAC,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,CAAC;KAClE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACtB,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC,CAAC,CAAC;AAEJ,OAAO;KACL,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,iFAAiF,CAAC;KAC9F,MAAM,CAAC,oBAAoB,EAAE,qBAAqB,CAAC;KACnD,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;KAC9C,MAAM,CAAC,uBAAuB,EAAE,uCAAuC,CAAC;KACxE,MAAM,CAAC,oBAAoB,EAAE,6BAA6B,CAAC;KAC3D,MAAM,CAAC,oBAAoB,EAAE,8CAA8C,CAAC;KAC5E,MAAM,CAAC,sBAAsB,EAAE,mDAAmD,CAAC;KACnF,MAAM,CAAC,iBAAiB,EAAE,qBAAqB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC;KACpF,MAAM,CAAC,WAAW,EAAE,2CAA2C,EAAE,KAAK,CAAC;KACvE,MAAM,CAAC,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,CAAC;KAClE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACtB,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC,CAAC,CAAC;AAEJ,OAAO;KACL,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,8EAA8E,CAAC;KAC3F,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;KAC9C,MAAM,CAAC,sBAAsB,EAAE,8DAA8D,EAAE,CAAC,CAAS,EAAE,EAAE,CAC7G,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CACjC;KACA,MAAM,CAAC,qBAAqB,EAAE,6CAA6C,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;KAC/G,SAAS,CACT,IAAI,MAAM,CAAC,mBAAmB,EAAE,8BAA8B,CAAC;KAC7D,OAAO,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;KACvC,OAAO,CAAC,SAAS,CAAC,CACpB;KACA,MAAM,CAAC,kBAAkB,EAAE,kDAAkD,CAAC;KAC9E,MAAM,CAAC,iBAAiB,EAAE,wBAAwB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC;KACvF,MAAM,CAAC,WAAW,EAAE,2CAA2C,EAAE,KAAK,CAAC;KACvE,MAAM,CAAC,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,CAAC;KAClE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACtB,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC,CAAC,CAAC;AAEJ,MAAM,IAAI,GAAG,OAAO;KAClB,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,uFAAuF,CAAC,CAAC;AAEvG,IAAI;KACF,OAAO,CAAC,KAAK,CAAC;KACd,WAAW,CAAC,4EAA4E,CAAC;KACzF,MAAM,CAAC,yBAAyB,EAAE,uCAAuC,CAAC;KAC1E,MAAM,CAAC,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,CAAC;KAClE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACtB,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC,CAAC,CAAC;AAEJ,KAAK,MAAM,MAAM,IAAI,iBAAiB,EAAE,CAAC;IACxC,IAAI;SACF,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,SAAS,MAAM,6CAA6C,MAAM,OAAO,CAAC;SACtF,MAAM,CAAC,yBAAyB,EAAE,uCAAuC,CAAC;SAC1E,MAAM,CAAC,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,CAAC;SAClE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,MAAM,aAAa,CAAC,MAAwB,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI;KACF,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,mGAAmG,CAAC;KAChH,MAAM,CAAC,yBAAyB,EAAE,uCAAuC,CAAC;KAC1E,MAAM,CAAC,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,CAAC;KAClE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;IAChB,aAAa,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC,CAAC,CAAC;AAEJ,IAAI;KACF,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,0FAA0F,CAAC;KACvG,cAAc,CAAC,eAAe,EAAE,8BAA8B,CAAC;KAC/D,MAAM,CAAC,yBAAyB,EAAE,uCAAuC,CAAC;KAC1E,MAAM,CAAC,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,CAAC;KAClE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;IAChB,aAAa,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC,CAAC,CAAC;AAEJ,OAAO;KACL,OAAO,CAAC,aAAa,CAAC;KACtB,WAAW,CAAC,iGAAiG,CAAC;KAC9G,MAAM,CAAC,iBAAiB,EAAE,2DAA2D,CAAC;KACtF,MAAM,CAAC,yBAAyB,EAAE,uCAAuC,CAAC;KAC1E,MAAM,CAAC,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,CAAC;KAClE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACtB,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC,CAAC,CAAC;AAEJ,IAAI,CAAC;IACJ,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC;AAAC,OAAO,GAAG,EAAE,CAAC;IACd,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC"}

package/dist/client/auth.d.ts

@@ -0,0 +1,21 @@
+export declare class AuthError extends Error {
+    constructor(message: string);
+}
+declare function validateKey(key: string): string;
+declare function readKeyFromEnvFile(path: string): string | null;
+declare function saveKeyToEnvFile(key: string, path?: string): void;
+export interface GetApiKeyOptions {
+    /** Override env-file path (default: ~/.config/elnora-linear/.env). */
+    envFilePath?: string;
+    /** If true and key isn't found, prompt user interactively (requires TTY). */
+    allowPrompt?: boolean;
+}
+export declare function getApiKey(opts?: GetApiKeyOptions): Promise<string>;
+export declare const _internal: {
+    validateKey: typeof validateKey;
+    readKeyFromEnvFile: typeof readKeyFromEnvFile;
+    saveKeyToEnvFile: typeof saveKeyToEnvFile;
+    DEFAULT_ENV_FILE: string;
+};
+export {};
+//# sourceMappingURL=auth.d.ts.map

package/dist/client/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/client/auth.ts"],"names":[],"mappings":"AAcA,qBAAa,SAAU,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAI3B;AAKD,iBAAS,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMxC;AAED,iBAAS,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQvD;AAED,iBAAS,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAyB,GAAG,IAAI,CAI5E;AAED,MAAM,WAAW,gBAAgB;IAChC,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAsB,SAAS,CAAC,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0B5E;AAGD,eAAO,MAAM,SAAS;;;;;CAA0E,CAAC"}

package/dist/client/auth.js

@@ -0,0 +1,74 @@
+// Linear API key resolution.
+//
+// Precedence (highest first):
+//   1. LINEAR_API_KEY env var
+//   2. ~/.config/elnora-linear/.env (or path passed via envFilePath)
+//   3. Interactive prompt (only if allowPrompt: true and stdin is a TTY)
+//
+// All Linear keys must start with "lin_api_" — validated before return.
+import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { createInterface } from "node:readline/promises";
+export class AuthError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "AuthError";
+    }
+}
+const KEY_PREFIX = "lin_api_";
+const DEFAULT_ENV_FILE = join(homedir(), ".config", "elnora-linear", ".env");
+function validateKey(key) {
+    const trimmed = key.trim().replace(/^["']|["']$/g, "");
+    if (!trimmed.startsWith(KEY_PREFIX)) {
+        throw new AuthError(`Linear API key must start with "${KEY_PREFIX}". Got: ${trimmed.slice(0, 12)}…`);
+    }
+    return trimmed;
+}
+function readKeyFromEnvFile(path) {
+    if (!existsSync(path))
+        return null;
+    const content = readFileSync(path, "utf8");
+    for (const line of content.split("\n")) {
+        const match = line.match(/^LINEAR_API_KEY\s*=\s*(.+?)\s*$/);
+        if (match)
+            return match[1];
+    }
+    return null;
+}
+function saveKeyToEnvFile(key, path = DEFAULT_ENV_FILE) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `LINEAR_API_KEY=${key}\n`, { mode: 0o600 });
+    chmodSync(path, 0o600);
+}
+export async function getApiKey(opts = {}) {
+    if (process.env.LINEAR_API_KEY) {
+        return validateKey(process.env.LINEAR_API_KEY);
+    }
+    const envFile = opts.envFilePath ?? DEFAULT_ENV_FILE;
+    const fileKey = readKeyFromEnvFile(envFile);
+    if (fileKey)
+        return validateKey(fileKey);
+    if (!opts.allowPrompt) {
+        throw new AuthError(`Linear API key not found. Set LINEAR_API_KEY env var, or place it in ${envFile} (mode 0600).`);
+    }
+    if (!process.stdin.isTTY) {
+        throw new AuthError("Linear API key not found and stdin is not a TTY; cannot prompt. Set LINEAR_API_KEY env var.");
+    }
+    process.stdout.write("Linear API key not found.\nGet one at https://linear.app/settings/api\nPaste it here: ");
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    let response;
+    try {
+        response = (await rl.question("")).trim();
+    }
+    finally {
+        rl.close();
+    }
+    const validated = validateKey(response);
+    saveKeyToEnvFile(validated, envFile);
+    process.stdout.write(`Saved to ${envFile} (mode 0600).\n`);
+    return validated;
+}
+// Exported for testing.
+export const _internal = { validateKey, readKeyFromEnvFile, saveKeyToEnvFile, DEFAULT_ENV_FILE };
+//# sourceMappingURL=auth.js.map

package/dist/client/auth.js.map

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

package/dist/client/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./auth.js";
+export * from "./linear-client.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,3 @@
+export * from "./auth.js";
+export * from "./linear-client.js";
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC"}

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

@@ -0,0 +1,5 @@
+import { LinearClient } from "@linear/sdk";
+import { type GetApiKeyOptions } from "./auth.js";
+export declare function getLinearClient(opts?: GetApiKeyOptions): Promise<LinearClient>;
+export declare function resetLinearClient(): void;
+//# sourceMappingURL=linear-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"linear-client.d.ts","sourceRoot":"","sources":["../../src/client/linear-client.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,KAAK,gBAAgB,EAAa,MAAM,WAAW,CAAC;AAI7D,wBAAsB,eAAe,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAKpF;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/client/linear-client.js

@@ -0,0 +1,18 @@
+// Thin singleton wrapper around @linear/sdk's LinearClient.
+//
+// Process-wide cache so a single CLI invocation only auths + constructs once,
+// no matter how many commands invoke it. Tests can reset via resetLinearClient.
+import { LinearClient } from "@linear/sdk";
+import { getApiKey } from "./auth.js";
+let cached = null;
+export async function getLinearClient(opts) {
+    if (cached)
+        return cached;
+    const apiKey = await getApiKey(opts);
+    cached = new LinearClient({ apiKey });
+    return cached;
+}
+export function resetLinearClient() {
+    cached = null;
+}
+//# sourceMappingURL=linear-client.js.map

package/dist/client/linear-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear-client.js","sourceRoot":"","sources":["../../src/client/linear-client.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAEhF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAyB,SAAS,EAAE,MAAM,WAAW,CAAC;AAE7D,IAAI,MAAM,GAAwB,IAAI,CAAC;AAEvC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAuB;IAC5D,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,GAAG,IAAI,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB;IAChC,MAAM,GAAG,IAAI,CAAC;AACf,CAAC"}

package/dist/commands/bulk.d.ts

@@ -0,0 +1,39 @@
+import type { OutputMode } from "../output/index.js";
+import { type SearchOptions } from "./search.js";
+export interface BulkOptions extends Omit<SearchOptions, "limit" | "output"> {
+    setState?: string;
+    addComment?: string;
+    limit: number;
+    yes: boolean;
+    output: OutputMode;
+}
+export interface BulkActionPlan {
+    issueIdentifier: string;
+    issueTitle: string;
+    currentState?: string;
+    changes: {
+        stateChange?: {
+            from: string;
+            to: string;
+        };
+        commentAdded?: string;
+    };
+    skipped?: {
+        reason: string;
+    };
+}
+export interface BulkPlan {
+    actions: BulkActionPlan[];
+    totalMatched: number;
+    dryRun: boolean;
+}
+/** Pure: given options + matched issues, compute the plan of changes. */
+export declare function buildBulkPlan(opts: BulkOptions, issues: Array<{
+    identifier: string;
+    title: string;
+    state?: string;
+}>): BulkPlan;
+/** Pure: format a plan for the user. */
+export declare function formatBulkPlan(plan: BulkPlan, mode: OutputMode): string;
+export declare function runBulk(opts: BulkOptions): Promise<void>;
+//# sourceMappingURL=bulk.d.ts.map

package/dist/commands/bulk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk.d.ts","sourceRoot":"","sources":["../../src/commands/bulk.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAiC,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAEhF,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,QAAQ,CAAC;IAE3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE;QACR,WAAW,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,OAAO,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7B;AAED,MAAM,WAAW,QAAQ;IACxB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CAChB;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAC5B,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,KAAK,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAClE,QAAQ,CAwBV;AAED,wCAAwC;AACxC,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAevE;AAUD,wBAAsB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAkC9D"}

package/dist/commands/bulk.js

@@ -0,0 +1,103 @@
+// `elnora-linear bulk` — apply the same change to many Linear issues at once.
+//
+// Safety design:
+//   - Default behaviour is dry-run. The plan is printed; nothing is mutated.
+//   - `--yes` is required to commit mutations.
+//   - At least one of `--set-state` or `--add-comment` must be specified;
+//     otherwise the command errors out early.
+import { getLinearClient } from "../client/index.js";
+import { buildFilter } from "./search.js";
+/** Pure: given options + matched issues, compute the plan of changes. */
+export function buildBulkPlan(opts, issues) {
+    if (!opts.setState && !opts.addComment) {
+        throw new Error("bulk requires at least one of --set-state or --add-comment.");
+    }
+    const actions = issues.map((issue) => {
+        const action = {
+            issueIdentifier: issue.identifier,
+            issueTitle: issue.title,
+            currentState: issue.state,
+            changes: {},
+        };
+        if (opts.setState) {
+            if (issue.state && issue.state.toLowerCase() === opts.setState.toLowerCase()) {
+                action.skipped = { reason: `already in state "${issue.state}"` };
+            }
+            else {
+                action.changes.stateChange = { from: issue.state ?? "?", to: opts.setState };
+            }
+        }
+        if (opts.addComment) {
+            action.changes.commentAdded = opts.addComment;
+        }
+        return action;
+    });
+    return { actions, totalMatched: issues.length, dryRun: !opts.yes };
+}
+/** Pure: format a plan for the user. */
+export function formatBulkPlan(plan, mode) {
+    if (mode === "json")
+        return JSON.stringify(plan, null, 2);
+    const willMutate = plan.actions.filter((a) => !a.skipped).length;
+    const header = plan.dryRun
+        ? `DRY RUN — ${willMutate} of ${plan.totalMatched} matched issues would change (pass --yes to commit)`
+        : `Applied changes to ${willMutate} of ${plan.totalMatched} matched issues`;
+    if (plan.actions.length === 0)
+        return `${header}\n  (no matching issues)`;
+    const lines = plan.actions.map((a) => {
+        if (a.skipped)
+            return `  ${a.issueIdentifier}  SKIPPED — ${a.skipped.reason}  ${a.issueTitle}`;
+        const parts = [];
+        if (a.changes.stateChange)
+            parts.push(`state: ${a.changes.stateChange.from} → ${a.changes.stateChange.to}`);
+        if (a.changes.commentAdded)
+            parts.push("+ comment");
+        return `  ${a.issueIdentifier}  ${parts.join(" | ")}  ${a.issueTitle}`;
+    });
+    return [header, ...lines].join("\n");
+}
+async function findStateIdByName(client, teamId, name) {
+    const team = await client.team(teamId);
+    const states = await team.states();
+    const match = states.nodes.find((s) => s.name.toLowerCase() === name.toLowerCase());
+    if (!match)
+        throw new Error(`No workflow state named "${name}" in team ${team.key}.`);
+    return match.id;
+}
+export async function runBulk(opts) {
+    const client = await getLinearClient({ allowPrompt: true });
+    const filter = await buildFilter({ ...opts, limit: opts.limit, output: opts.output }, client);
+    const issuesResult = await client.issues({ filter, first: opts.limit });
+    const fetched = issuesResult.nodes;
+    const projected = await Promise.all(fetched.map(async (issue) => {
+        const state = await issue.state;
+        return { identifier: issue.identifier, title: issue.title, state: state?.name };
+    }));
+    const plan = buildBulkPlan(opts, projected);
+    process.stdout.write(`${formatBulkPlan(plan, opts.output)}\n`);
+    if (plan.dryRun)
+        return;
+    // Apply mutations.
+    const indexByIdentifier = new Map(fetched.map((i) => [i.identifier, i]));
+    for (const action of plan.actions) {
+        if (action.skipped)
+            continue;
+        const issue = indexByIdentifier.get(action.issueIdentifier);
+        if (!issue)
+            continue;
+        const updates = {};
+        if (action.changes.stateChange) {
+            const team = await issue.team;
+            if (!team)
+                throw new Error(`Issue ${issue.identifier} has no team`);
+            updates.stateId = await findStateIdByName(client, team.id, action.changes.stateChange.to);
+        }
+        if (Object.keys(updates).length > 0) {
+            await issue.update(updates);
+        }
+        if (action.changes.commentAdded) {
+            await client.createComment({ issueId: issue.id, body: action.changes.commentAdded });
+        }
+    }
+}
+//# sourceMappingURL=bulk.js.map

package/dist/commands/bulk.js.map

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

package/dist/commands/cleanup.d.ts

@@ -0,0 +1,39 @@
+import type { OutputMode } from "../output/index.js";
+export type CleanupAction = "close" | "cancel" | "comment";
+export interface CleanupOptions {
+    team?: string;
+    /** Comma-separated state names; default ["Todo","Backlog"]. */
+    states?: string[];
+    inactiveDays: number;
+    action: CleanupAction;
+    message?: string;
+    limit: number;
+    yes: boolean;
+    output: OutputMode;
+}
+export interface CleanupActionPlan {
+    issueIdentifier: string;
+    issueTitle: string;
+    currentState?: string;
+    daysInactive: number;
+    proposed: {
+        setStateType?: "completed" | "canceled";
+        addComment?: string;
+    };
+}
+export interface CleanupPlan {
+    actions: CleanupActionPlan[];
+    totalConsidered: number;
+    dryRun: boolean;
+}
+/** Pure: given options and the candidate issues, compute the plan. */
+export declare function buildCleanupPlan(opts: CleanupOptions, issues: Array<{
+    identifier: string;
+    title: string;
+    state?: string;
+    updatedAt: Date;
+}>, now?: Date): CleanupPlan;
+/** Pure: format a plan for the user. */
+export declare function formatCleanupPlan(plan: CleanupPlan, mode: OutputMode): string;
+export declare function runCleanup(opts: CleanupOptions): Promise<void>;
+//# sourceMappingURL=cleanup.d.ts.map

package/dist/commands/cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../src/commands/cleanup.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE;QACT,YAAY,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;QACxC,UAAU,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACF;AAED,MAAM,WAAW,WAAW;IAC3B,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;CAChB;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,KAAK,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,IAAI,CAAA;CAAE,CAAC,EACrF,GAAG,GAAE,IAAiB,GACpB,WAAW,CAqBb;AAED,wCAAwC;AACxC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAa7E;AAUD,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAsCpE"}