@enrichlayer/el-linear 1.5.0 → 1.7.0

package/dist/commands/init/defaults.d.ts

@@ -1,5 +1,6 @@
 /**
- * Step 4 of the wizard: default labels, status defaults, term enforcement.
+ * Step 4 of the wizard: default labels, default assignee, default priority,
+ * status defaults, term enforcement, cache TTL.
  *
  * All optional. Each subsection asks "change?" with default=N so re-running
  * with no input is a no-op.
@@ -7,6 +8,19 @@
 import { type WizardConfig } from "./shared.js";
 export interface DefaultsStepResult {
     defaultLabels: string[] | undefined;
+    /**
+     * Default assignee identifier (alias / display name / email / UUID — same
+     * shapes resolveAssignee accepts) for `issues create`. The wizard does NOT
+     * validate this against Linear (no API call) — the runtime resolver handles
+     * validation at issue-create time, keeping the wizard offline.
+     */
+    defaultAssignee: string | undefined;
+    /**
+     * Default priority keyword: `none|urgent|high|medium|normal|low`. Stored
+     * as-is; the runtime path runs it through validatePriority() to get the
+     * Linear priority number.
+     */
+    defaultPriority: string | undefined;
     /**
      * Status defaults. Both fields are optional so the wizard preserves
      * partial existing configs (`{ noProject: "Backlog" }` only) byte-for-byte
@@ -21,5 +35,8 @@ export interface DefaultsStepResult {
         canonical: string;
         reject: string[];
     }> | undefined;
+    /** TTL (seconds) for `teams list` / `labels list` / `projects list` disk
+     * cache. `0` disables. */
+    cacheTTLSeconds: number | undefined;
 }
 export declare function runDefaultsStep(existing: WizardConfig): Promise<DefaultsStepResult>;

package/dist/commands/init/defaults.js

@@ -1,12 +1,22 @@
 /**
- * Step 4 of the wizard: default labels, status defaults, term enforcement.
+ * Step 4 of the wizard: default labels, default assignee, default priority,
+ * status defaults, term enforcement, cache TTL.
  *
  * All optional. Each subsection asks "change?" with default=N so re-running
  * with no input is a no-op.
  */
-import { confirm, input } from "@inquirer/prompts";
+import { confirm, input, select } from "@inquirer/prompts";
 import { parseCsvList } from "./shared.js";
 const STATUS_FALLBACK = { noProject: "Triage", withAssigneeAndProject: "Todo" };
+const CACHE_TTL_FALLBACK = 3600;
+const PRIORITY_CHOICES = [
+    { name: "none", value: "none" },
+    { name: "urgent", value: "urgent" },
+    { name: "high", value: "high" },
+    { name: "medium", value: "medium" },
+    { name: "normal", value: "normal" },
+    { name: "low", value: "low" },
+];
 export async function runDefaultsStep(existing) {
     // Idempotency rule: when the user skips a sub-section, return the existing
     // value byte-for-byte. We deliberately do NOT spread or backfill optional
@@ -14,12 +24,14 @@ export async function runDefaultsStep(existing) {
     // with no input produces a byte-identical config.
     const result = {
         defaultLabels: existing.defaultLabels,
+        defaultAssignee: existing.defaultAssignee,
+        defaultPriority: existing.defaultPriority,
         statusDefaults: existing.statusDefaults,
         terms: existing.terms,
+        cacheTTLSeconds: existing.cacheTTLSeconds,
     };
     // ── Default labels ────────────────────────────────────────────────
     const currentLabels = existing.defaultLabels ?? [];
-    // biome-ignore lint/suspicious/noConsole: wizard
     console.log(`  Current default labels: ${currentLabels.length > 0 ? currentLabels.join(", ") : "(none)"}`);
     const editLabels = await confirm({
         message: "Change default labels for new issues?",
@@ -33,9 +45,47 @@ export async function runDefaultsStep(existing) {
         const parsed = parseCsvList(raw);
         result.defaultLabels = parsed.length > 0 ? parsed : undefined;
     }
+    // ── Default assignee ──────────────────────────────────────────────
+    console.log(`  Current default assignee: ${existing.defaultAssignee ?? "(none)"}`);
+    const editAssignee = await confirm({
+        message: "Change default assignee for new issues?",
+        default: false,
+    });
+    if (editAssignee) {
+        // We deliberately don't validate against Linear here — the wizard runs
+        // offline-friendly. The runtime resolver (resolveAssignee) catches
+        // typos at issue-create time. "none" is the explicit-clear sentinel
+        // so users have an unambiguous way to wipe the field.
+        const raw = (await input({
+            message: "Default assignee (alias, name, email, or 'none' to clear):",
+            default: existing.defaultAssignee ?? "",
+        })).trim();
+        if (!raw || raw.toLowerCase() === "none") {
+            result.defaultAssignee = undefined;
+        }
+        else {
+            result.defaultAssignee = raw;
+        }
+    }
+    // ── Default priority ──────────────────────────────────────────────
+    console.log(`  Current default priority: ${existing.defaultPriority ?? "(none)"}`);
+    const editPriority = await confirm({
+        message: "Change default priority for new issues?",
+        default: false,
+    });
+    if (editPriority) {
+        // `select` always picks one option — so picking "none" stores the
+        // keyword string "none" (Linear's "No priority"), distinct from
+        // `undefined` which means "no default at all".
+        const choice = await select({
+            message: "Default priority:",
+            choices: PRIORITY_CHOICES,
+            default: existing.defaultPriority ?? "none",
+        });
+        result.defaultPriority = choice;
+    }
     // ── Status defaults ────────────────────────────────────────────────
     const cur = existing.statusDefaults;
-    // biome-ignore lint/suspicious/noConsole: wizard
     console.log(`  Current status defaults: noProject=${cur?.noProject ?? STATUS_FALLBACK.noProject}, ` +
         `withAssigneeAndProject=${cur?.withAssigneeAndProject ?? STATUS_FALLBACK.withAssigneeAndProject}`);
     const editStatus = await confirm({
@@ -56,12 +106,39 @@ export async function runDefaultsStep(existing) {
             withAssigneeAndProject: withAP.trim(),
         };
     }
+    // ── Cache TTL ─────────────────────────────────────────────────────
+    const currentTTL = existing.cacheTTLSeconds ?? CACHE_TTL_FALLBACK;
+    console.log(`  Current cache TTL: ${currentTTL}s`);
+    const editTTL = await confirm({
+        message: "Change cache TTL?",
+        default: false,
+    });
+    if (editTTL) {
+        const raw = await input({
+            message: "Cache TTL in seconds (0 to disable):",
+            default: String(currentTTL),
+            // `validate` runs per submit; we reject anything that isn't a
+            // non-negative integer literal. Number("") is `0` (truthy by
+            // the integer test) so we explicitly require non-empty input —
+            // otherwise an empty submission would silently store 0.
+            validate: (value) => {
+                const trimmed = value.trim();
+                if (trimmed === "") {
+                    return "Enter a non-negative integer (e.g. 3600 for 1 hour, 0 to disable).";
+                }
+                const n = Number(trimmed);
+                if (!Number.isFinite(n) || !Number.isInteger(n) || n < 0) {
+                    return "Enter a non-negative integer (e.g. 3600 for 1 hour, 0 to disable).";
+                }
+                return true;
+            },
+        });
+        result.cacheTTLSeconds = Number(raw);
+    }
     // ── Term enforcement ───────────────────────────────────────────────
     const currentTerms = existing.terms ?? [];
-    // biome-ignore lint/suspicious/noConsole: wizard
     console.log(`  Current term-enforcement rules: ${currentTerms.length}`);
     for (const t of currentTerms) {
-        // biome-ignore lint/suspicious/noConsole: wizard
         console.log(`    "${t.canonical}" rejects: ${t.reject.join(", ")}`);
     }
     const editTerms = await confirm({
@@ -77,7 +154,6 @@ export async function runDefaultsStep(existing) {
 }
 async function collectTermsInteractively(initial) {
     const terms = [...initial];
-    // biome-ignore lint/suspicious/noConsole: wizard
     console.log("  Term enforcement catches misspellings of brand or product names in issue titles " +
         "and descriptions. Define the canonical form and a list of rejected variants.");
     if (terms.length > 0) {
@@ -102,7 +178,6 @@ async function collectTermsInteractively(initial) {
         });
         const reject = parseCsvList(rejectRaw);
         if (reject.length === 0) {
-            // biome-ignore lint/suspicious/noConsole: wizard
             console.log("  No variants given — skipping this rule.");
             continue;
         }

package/dist/commands/init/index.js

@@ -33,7 +33,6 @@ function withCleanExit(fn) {
         }
         catch (err) {
             if (err instanceof Error && err.name === "ExitPromptError") {
-                // biome-ignore lint/suspicious/noConsole: wizard
                 console.log("\n  Cancelled.");
                 process.exit(130);
             }
@@ -94,7 +93,6 @@ export function setupInitCommands(program) {
             workspaceUrlKey: existing.workspaceUrlKey ?? ws.workspaceUrlKey,
         });
         await writeConfig(merged);
-        // biome-ignore lint/suspicious/noConsole: wizard
         console.log("  ✓ Workspace defaults saved.");
     }));
     init
@@ -111,7 +109,6 @@ export function setupInitCommands(program) {
             const result = await runAliasesImport(tokenResult.token, options.import);
             updates = result.updates;
             if (result.skipped.length > 0) {
-                // biome-ignore lint/suspicious/noConsole: wizard
                 console.log(`  Skipped ${result.skipped.length} unmatched email(s): ${result.skipped.join(", ")}`);
             }
         }
@@ -121,29 +118,29 @@ export function setupInitCommands(program) {
             });
         }
         if (updates.size === 0) {
-            // biome-ignore lint/suspicious/noConsole: wizard
             console.log("  No alias changes — config unchanged.");
             return;
         }
         const merged = mergeAliasesIntoConfig(existing, updates);
         await writeConfig(merged);
-        // biome-ignore lint/suspicious/noConsole: wizard
         console.log(`  ✓ Updated aliases for ${updates.size} user(s).`);
     }));
     init
         .command("defaults")
-        .description("Default labels, status defaults, term enforcement rules")
+        .description("Default labels, default assignee, default priority, status defaults, cache TTL, term enforcement")
         .action(withCleanExit(async () => {
         const existing = await readConfig();
         printStep("defaults", "Defaults");
         const result = await runDefaultsStep(existing);
         const merged = assignDefined(existing, {
             defaultLabels: result.defaultLabels,
+            defaultAssignee: result.defaultAssignee,
+            defaultPriority: result.defaultPriority,
             statusDefaults: result.statusDefaults,
             terms: result.terms,
+            cacheTTLSeconds: result.cacheTTLSeconds,
         });
         await writeConfig(merged);
-        // biome-ignore lint/suspicious/noConsole: wizard
         console.log("  ✓ Defaults saved.");
     }));
 }
@@ -156,9 +153,7 @@ export async function runFullWizard(options = {}) {
     await runFullWizardImpl(opts);
 }
 async function runFullWizardImpl(options) {
-    // biome-ignore lint/suspicious/noConsole: wizard
     console.log("Welcome to el-linear. This wizard will set up your config.");
-    // biome-ignore lint/suspicious/noConsole: wizard
     console.log("Skip is the default at every prompt; only the API token is required.\n");
     const existing = await readConfig();
     // Step 1: token (required)
@@ -183,8 +178,11 @@ async function runFullWizardImpl(options) {
         // defaults step: result is `existing.X` itself when the user skipped
         // the edit branch, so direct assignment is safe.
         defaultLabels: defaults.defaultLabels,
+        defaultAssignee: defaults.defaultAssignee,
+        defaultPriority: defaults.defaultPriority,
         statusDefaults: defaults.statusDefaults,
         terms: defaults.terms,
+        cacheTTLSeconds: defaults.cacheTTLSeconds,
         // workspace step: `ws.defaultTeam` may be the existing value (user
         // skipped) or a new pick.
         defaultTeam: ws.defaultTeam,
@@ -197,12 +195,8 @@ async function runFullWizardImpl(options) {
         merged = mergeAliasesIntoConfig(merged, aliasUpdates);
     }
     await writeConfig(merged);
-    // biome-ignore lint/suspicious/noConsole: wizard
     console.log("\n✓ Setup complete.");
-    // biome-ignore lint/suspicious/noConsole: wizard
     console.log("  Token:  ~/.config/el-linear/token (mode 0600)");
-    // biome-ignore lint/suspicious/noConsole: wizard
     console.log("  Config: ~/.config/el-linear/config.json");
-    // biome-ignore lint/suspicious/noConsole: wizard
     console.log("\nTry: el-linear teams list");
 }

package/dist/commands/init/oauth.d.ts

@@ -2,10 +2,10 @@
  * Wizard step for OAuth 2.0 (PKCE flow) authorization.
  *
  * Flow:
- *   1. Present a "what is this?" intro pointing the user at Linear's OAuth
- *      app registration page. (Until we ship a shared OAuth client_id,
- *      every user registers their own app.)
- *   2. Prompt for `client_id`, optional `client_secret`, port, scopes.
+ *   1. Read optional local/team OAuth app defaults, if present.
+ *   2. Otherwise present a "what is this?" intro pointing the user at
+ *      Linear's OAuth app registration page, then prompt for `client_id`,
+ *      optional `client_secret`, port, scopes.
  *   3. Generate PKCE verifier + state, build the authorize URL.
  *   4. Try to open the system browser; fall back to printing the URL.
  *   5. Spin a localhost listener (or fall back to pasted-code prompt) to

package/dist/commands/init/oauth.js

@@ -2,10 +2,10 @@
  * Wizard step for OAuth 2.0 (PKCE flow) authorization.
  *
  * Flow:
- *   1. Present a "what is this?" intro pointing the user at Linear's OAuth
- *      app registration page. (Until we ship a shared OAuth client_id,
- *      every user registers their own app.)
- *   2. Prompt for `client_id`, optional `client_secret`, port, scopes.
+ *   1. Read optional local/team OAuth app defaults, if present.
+ *   2. Otherwise present a "what is this?" intro pointing the user at
+ *      Linear's OAuth app registration page, then prompt for `client_id`,
+ *      optional `client_secret`, port, scopes.
  *   3. Generate PKCE verifier + state, build the authorize URL.
  *   4. Try to open the system browser; fall back to printing the URL.
  *   5. Spin a localhost listener (or fall back to pasted-code prompt) to
@@ -19,6 +19,7 @@
  */
 import { spawn } from "node:child_process";
 import { checkbox, input, password, select } from "@inquirer/prompts";
+import { readTeamOAuthConfig } from "../../auth/oauth-app-config.js";
 import { DEFAULT_CALLBACK_PATH, runLocalhostCallback, } from "../../auth/oauth-callback.js";
 import { ALL_SCOPES, buildAuthorizeUrl, DEFAULT_SCOPES, generatePkce, generateState, SCOPE_DESCRIPTIONS, validateScopes, } from "../../auth/oauth-client.js";
 import { promptForPastedCode } from "../../auth/oauth-headless.js";
@@ -165,6 +166,22 @@ async function promptRegistration(defaults) {
         scopes: validateScopes(scopes),
     };
 }
+async function resolveRegistration(defaults) {
+    const teamConfig = await readTeamOAuthConfig();
+    if (!teamConfig) {
+        return promptRegistration({ port: defaults.manualPort });
+    }
+    const port = defaults.requestedPort ?? teamConfig.redirectPort;
+    logLine("");
+    logLine(TS(`Using Linear OAuth app defaults from ${teamConfig.sourcePath}.`));
+    logLine(TS(`Callback URL: http://localhost:${port}${DEFAULT_CALLBACK_PATH}`));
+    logLine("");
+    return {
+        clientId: teamConfig.clientId,
+        port,
+        scopes: teamConfig.scopes,
+    };
+}
 /**
  * Default viewer-validation routine. Calls `viewer { ... }` with the new
  * bearer token to confirm Linear accepted it. Reused for both the wizard
@@ -213,8 +230,9 @@ export async function runOAuthStep(options = {}) {
         }
         // Both `reauth` and `revoked` fall through to the re-auth flow.
     }
-    const reg = await promptRegistration({
-        port: options.port ?? extractPortFromRedirect(existing) ?? DEFAULT_PORT,
+    const reg = await resolveRegistration({
+        manualPort: options.port ?? extractPortFromRedirect(existing) ?? DEFAULT_PORT,
+        requestedPort: options.port,
     });
     const redirectUri = `http://localhost:${reg.port}${DEFAULT_CALLBACK_PATH}`;
     const pkce = generatePkce();

package/dist/commands/init/shared.js

@@ -174,7 +174,6 @@ export async function clearAliasesProgress() {
  * Print a step header in the wizard. Step strings like "1/4" or "2/4 (skipped)".
  */
 export function printStep(label, title) {
-    // biome-ignore lint/suspicious/noConsole: wizard output is meant for stdout
     console.log(`\n[${label}] ${title}`);
 }
 /**

package/dist/commands/init/token.js

@@ -91,7 +91,6 @@ export async function runTokenStep(options = {}) {
     if (existing && !options.force) {
         try {
             const viewer = await validateToken(existing);
-            // biome-ignore lint/suspicious/noConsole: wizard
             console.log(`  Existing token works — authenticated as ${viewer.displayName} <${viewer.email}>.`);
             const replace = await confirm({
                 message: "Replace this token?",
@@ -104,13 +103,10 @@ export async function runTokenStep(options = {}) {
         catch (err) {
             const raw = err instanceof Error ? err.message : String(err);
             const message = sanitizeForLog(raw);
-            // biome-ignore lint/suspicious/noConsole: wizard
             console.log(`  Existing token failed validation (${message}). You'll need to provide a new one.`);
         }
     }
-    // biome-ignore lint/suspicious/noConsole: wizard
     console.log(`  Generate a personal API token: ${TOKEN_GENERATION_URL}`);
-    // biome-ignore lint/suspicious/noConsole: wizard
     console.log("  The token stays on your machine. el-linear only sends it to Linear's API. " +
         "It's stored at ~/.config/el-linear/token (mode 0600).");
     // Up to three attempts before giving up.
@@ -123,17 +119,14 @@ export async function runTokenStep(options = {}) {
             validate: (input) => input.trim().length > 0 || "Token cannot be empty",
         })).trim();
         try {
-            // biome-ignore lint/suspicious/noConsole: wizard
             console.log("  Validating…");
             const viewer = await validateToken(token);
             await writeToken(token);
-            // biome-ignore lint/suspicious/noConsole: wizard
             console.log(`  ✓ Authenticated as ${viewer.displayName} <${viewer.email}> (${viewer.organization.name}).`);
             return { token, viewer };
         }
         catch (err) {
             const raw = err instanceof Error ? err.message : String(err);
-            // biome-ignore lint/suspicious/noConsole: wizard
             console.log(`  ✗ ${sanitizeForLog(raw)}`);
         }
     }

package/dist/commands/init/workspace.js

@@ -33,7 +33,6 @@ export async function runWorkspaceStep(token, workspaceUrlKey, existing) {
     for (const t of teams) {
         teamMap[t.key] = t.id;
     }
-    // biome-ignore lint/suspicious/noConsole: wizard
     console.log(`  Workspace: ${workspaceUrlKey} (${teams.length} teams)`);
     const currentDefault = existing.defaultTeam || "";
     // `change` reflects what the user agreed to: `true` means "open the picker
@@ -53,7 +52,6 @@ export async function runWorkspaceStep(token, workspaceUrlKey, existing) {
         };
     }
     if (teams.length === 0) {
-        // biome-ignore lint/suspicious/noConsole: wizard
         console.log("  No teams visible to this token. Skipping default-team picker.");
         return {
             workspaceUrlKey,

package/dist/commands/issue-id.js

@@ -72,7 +72,9 @@ export function setupIssueIdCommand(program) {
             return;
         }
         const rootOpts = command.parent?.opts() ?? {};
-        const service = createGraphQLService({ apiToken: rootOpts.apiToken });
+        const service = await createGraphQLService({
+            apiToken: rootOpts.apiToken,
+        });
         const result = (await service.rawRequest(ISSUE_QUERY, {
             id: parsed.issueId,
         }));