@enrichlayer/el-linear 1.5.0 → 1.7.0

package/dist/commands/issues.js

@@ -7,10 +7,10 @@ import { resolveDefaultStatus } from "../config/status-defaults.js";
 import { enforceTerms } from "../config/term-enforcer.js";
 import { LIST_COMMENTS_QUERY } from "../queries/comments.js";
 import { GET_ISSUE_RELATIONS_QUERY, GET_ISSUE_STATE_HISTORY_QUERY, ISSUE_RELATION_CREATE_MUTATION, SCAN_ISSUES_QUERY, UPDATE_ISSUE_MUTATION, } from "../queries/issues.js";
-import { getApiToken } from "../utils/auth.js";
 import { autoLinkReferences, } from "../utils/auto-link-references.js";
 import { downloadLinearUploads } from "../utils/download-uploads.js";
-import { FileService } from "../utils/file-service.js";
+import { createFileService } from "../utils/file-service.js";
+import { applyFooter } from "../utils/footer.js";
 import { createGraphQLAttachmentsService } from "../utils/graphql-attachments-service.js";
 import { GraphQLIssuesService } from "../utils/graphql-issues-service.js";
 import { createGraphQLService, } from "../utils/graphql-service.js";
@@ -19,6 +19,7 @@ import { wrapIssueReferencesAsLinks } from "../utils/issue-reference-wrapper.js"
 import { createLinearService, } from "../utils/linear-service.js";
 import { logger } from "../utils/logger.js";
 import { handleAsyncCommand, outputSuccess, outputWarning, } from "../utils/output.js";
+import { getRootOpts } from "../utils/root-opts.js";
 import { formatCsv, formatMarkdown, formatTable, } from "../utils/table-formatter.js";
 import { validateReferences } from "../utils/validate-references.js";
 import { parsePriorityFilter, splitList, validatePriority, } from "../utils/validators.js";
@@ -78,14 +79,43 @@ function readDescriptionFile(filePath) {
     return fs.readFileSync(filePath, "utf8").trim();
 }
 /**
- * Resolve the description from --description, --description-file, or both.
- * --description-file takes precedence when both are provided.
+ * Resolve the description from --description, --description-file, or
+ * --template (looked up in `config.descriptionTemplates`).
+ *
+ * Precedence:
+ *   --description-file > --description > --template
+ *
+ * Passing --template alongside --description or --description-file is a
+ * usage error — the explicit body and a template both producing content
+ * would be silently dropping one. We throw so the user picks one.
  */
 function resolveDescription(options) {
-    if (options.descriptionFile) {
+    const hasInline = typeof options.description === "string" && options.description.length > 0;
+    const hasFile = Boolean(options.descriptionFile);
+    const hasTemplate = typeof options.template === "string" && options.template;
+    if (hasTemplate && (hasInline || hasFile)) {
+        throw new Error("--template is mutually exclusive with --description / --description-file. " +
+            "Pick one.");
+    }
+    if (hasFile) {
         return readDescriptionFile(options.descriptionFile);
     }
-    return options.description;
+    if (hasInline) {
+        return options.description;
+    }
+    if (hasTemplate) {
+        const templates = loadConfig().descriptionTemplates ?? {};
+        const body = templates[options.template];
+        if (!body) {
+            const available = Object.keys(templates).sort();
+            const hint = available.length
+                ? `Available templates: ${available.join(", ")}`
+                : "No templates configured. Add one under `descriptionTemplates` in your config.";
+            throw new Error(`Template "${options.template}" not found. ${hint}`);
+        }
+        return body;
+    }
+    return undefined;
 }
 function isImageFile(filename) {
     const ext = filename.lastIndexOf(".");
@@ -233,12 +263,20 @@ function buildUpdateArgs(issueId, options, assigneeId) {
     else if (options.labels) {
         labelIds = splitList(options.labels);
     }
+    // On update, fall back to config.defaultPriority only when --priority
+    // wasn't passed. This keeps every update setting a priority for users who
+    // want a workspace-wide baseline (e.g. all unassigned triage tickets bump
+    // to "medium"). To leave priority untouched, omit defaultPriority from
+    // config — the field is opt-in.
+    const priorityInput = typeof options.priority === "string"
+        ? options.priority
+        : loadConfig().defaultPriority;
     return {
         id: issueId,
         title: options.title,
         description: options.description,
         statusId: options.status,
-        priority: options.priority ? validatePriority(options.priority) : undefined,
+        priority: priorityInput ? validatePriority(priorityInput) : undefined,
         assigneeId,
         projectId: options.project,
         labelIds,
@@ -296,9 +334,9 @@ async function handleListIssues(options, command) {
     if (options.label && !options.labels) {
         options.labels = options.label;
     }
-    const rootOpts = command.parent.parent.opts();
-    const graphQLService = createGraphQLService(rootOpts);
-    const linearService = createLinearService(rootOpts);
+    const rootOpts = getRootOpts(command);
+    const graphQLService = await createGraphQLService(rootOpts);
+    const linearService = await createLinearService(rootOpts);
     const issuesService = new GraphQLIssuesService(graphQLService, linearService);
     const hasFilters = options.team ||
         options.labels ||
@@ -337,9 +375,9 @@ async function handleSearchIssues(query, options, command) {
     if (options.label && !options.labels) {
         options.labels = options.label;
     }
-    const rootOpts = command.parent.parent.opts();
-    const graphQLService = createGraphQLService(rootOpts);
-    const linearService = createLinearService(rootOpts);
+    const rootOpts = getRootOpts(command);
+    const graphQLService = await createGraphQLService(rootOpts);
+    const linearService = await createLinearService(rootOpts);
     const issuesService = new GraphQLIssuesService(graphQLService, linearService);
     const searchArgs = {
         query,
@@ -362,6 +400,21 @@ async function handleSearchIssues(query, options, command) {
 async function resolveCreateInputs(title, options, rootOpts) {
     const config = loadConfig();
     enforceTerms([title, options.description], { strict: options.strict });
+    // Effective assignee: explicit --assignee wins; --no-assignee (commander
+    // parses as `assignee === false`) skips both flag and config; otherwise
+    // fall back to config.defaultAssignee. Computed BEFORE validation so the
+    // "assignee required" rule sees the resolved value, not undefined.
+    const noAssignee = options.assignee === false;
+    const explicitAssignee = typeof options.assignee === "string" ? options.assignee : undefined;
+    const effectiveAssignee = noAssignee
+        ? undefined
+        : (explicitAssignee ?? config.defaultAssignee);
+    // Effective priority: explicit --priority wins; otherwise fall back to
+    // config.defaultPriority. Both go through validatePriority so a bad config
+    // value fails fast with a useful error.
+    const effectivePriorityInput = typeof options.priority === "string"
+        ? options.priority
+        : config.defaultPriority;
     // --- Validation (labels, description, assignee, project, title) ---
     // Controlled by config.validation.enabled (default: true).
     // Bypassed by --skip-validation flag.
@@ -372,7 +425,7 @@ async function resolveCreateInputs(title, options, rootOpts) {
             labels: rawLabels,
             description: description || undefined,
             title,
-            assignee: options.assignee,
+            assignee: effectiveAssignee,
             project: options.project,
         });
         // Apply normalized labels back so resolution uses the canonical names
@@ -381,13 +434,13 @@ async function resolveCreateInputs(title, options, rootOpts) {
         }
         enforceValidation(validationResult);
     }
-    if (!options.priority) {
+    if (!effectivePriorityInput) {
         outputWarning("Creating issue without --priority. Consider specifying it for better triage.", "missing_fields");
     }
     const teamInput = options.team || config.defaultTeam;
     const teamId = resolveTeam(teamInput);
-    const assigneeId = options.assignee
-        ? await resolveAssignee(options.assignee, rootOpts)
+    const assigneeId = effectiveAssignee
+        ? await resolveAssignee(effectiveAssignee, rootOpts)
         : undefined;
     let labelIds = [];
     if (options.labels) {
@@ -408,7 +461,18 @@ async function resolveCreateInputs(title, options, rootOpts) {
     if (options.subscriber) {
         subscriberIds = splitList(options.subscriber).map((s) => resolveMember(s));
     }
-    return { teamInput, teamId, assigneeId, labelIds, status, subscriberIds };
+    const priority = effectivePriorityInput
+        ? validatePriority(effectivePriorityInput)
+        : undefined;
+    return {
+        teamInput,
+        teamId,
+        assigneeId,
+        labelIds,
+        status,
+        subscriberIds,
+        priority,
+    };
 }
 async function uploadAttachmentsIfNeeded(options, rootOpts) {
     if (!options.attachment) {
@@ -417,8 +481,7 @@ async function uploadAttachmentsIfNeeded(options, rootOpts) {
     const paths = Array.isArray(options.attachment)
         ? options.attachment
         : [options.attachment];
-    const apiToken = getApiToken(rootOpts);
-    const fileService = new FileService(apiToken);
+    const fileService = await createFileService(rootOpts);
     const results = [];
     for (const filePath of paths) {
         const result = await fileService.uploadFile(filePath);
@@ -442,12 +505,21 @@ function buildDescriptionWithAttachments(baseDescription, uploadResults) {
     return description;
 }
 async function handleCreateIssue(title, options, command) {
-    const rootOpts = command.parent.parent.opts();
-    const { teamInput, teamId, assigneeId, labelIds, status, subscriberIds } = await resolveCreateInputs(title, options, rootOpts);
+    const rootOpts = getRootOpts(command);
+    const { teamInput, teamId, assigneeId, labelIds, status, subscriberIds, priority, } = await resolveCreateInputs(title, options, rootOpts);
     const uploadResults = await uploadAttachmentsIfNeeded(options, rootOpts);
-    const description = buildDescriptionWithAttachments(resolveDescription(options) || "", uploadResults);
-    const graphQLService = createGraphQLService(rootOpts);
-    const linearService = createLinearService(rootOpts);
+    const descriptionWithAttachments = buildDescriptionWithAttachments(resolveDescription(options) || "", uploadResults);
+    // Append messageFooter (config or --footer flag) so auto-link picks up any
+    // issue refs in the footer too. --no-footer skips both flag and config.
+    // Commander parses --no-footer as `options.footer === false`.
+    const noFooter = options.footer === false;
+    const explicitFooter = typeof options.footer === "string" ? options.footer : undefined;
+    const description = applyFooter(descriptionWithAttachments, {
+        footer: explicitFooter,
+        noFooter,
+    }) ?? "";
+    const graphQLService = await createGraphQLService(rootOpts);
+    const linearService = await createLinearService(rootOpts);
     const issuesService = new GraphQLIssuesService(graphQLService, linearService);
     // Wrap valid issue identifiers as markdown links before creating, so the description
     // saved on Linear has clickable refs from the start. Self-reference can't apply here
@@ -459,7 +531,7 @@ async function handleCreateIssue(title, options, command) {
         teamInput,
         description: prepared.description,
         assigneeId,
-        priority: options.priority ? validatePriority(options.priority) : undefined,
+        priority,
         projectId: options.project,
         statusId: status,
         labelIds: labelIds.length > 0 ? labelIds : undefined,
@@ -486,7 +558,7 @@ async function handleCreateIssue(title, options, command) {
     // so only create separate attachment records for non-image files.
     const attachments = [];
     if (uploadResults.length > 0) {
-        const attachmentsService = createGraphQLAttachmentsService(rootOpts);
+        const attachmentsService = await createGraphQLAttachmentsService(rootOpts);
         for (const uploadResult of uploadResults) {
             if (!isImageFile(uploadResult.filename)) {
                 const attachment = await attachmentsService.createAttachment({
@@ -517,9 +589,9 @@ async function handleCreateIssue(title, options, command) {
     outputSuccess(output);
 }
 async function handleHistoryIssue(issueId, _options, command) {
-    const rootOpts = command.parent.parent.opts();
-    const graphQLService = createGraphQLService(rootOpts);
-    const linearService = createLinearService(rootOpts);
+    const rootOpts = getRootOpts(command);
+    const graphQLService = await createGraphQLService(rootOpts);
+    const linearService = await createLinearService(rootOpts);
     const resolvedId = await linearService.resolveIssueId(issueId);
     const result = await graphQLService.rawRequest(GET_ISSUE_STATE_HISTORY_QUERY, {
         id: resolvedId,
@@ -547,9 +619,9 @@ async function handleHistoryIssue(issueId, _options, command) {
     });
 }
 async function handleRelateIssue(issueId, options, command) {
-    const rootOpts = command.parent.parent.opts();
-    const graphQLService = createGraphQLService(rootOpts);
-    const linearService = createLinearService(rootOpts);
+    const rootOpts = getRootOpts(command);
+    const graphQLService = await createGraphQLService(rootOpts);
+    const linearService = await createLinearService(rootOpts);
     const sourceId = await linearService.resolveIssueId(issueId);
     const relations = await createRelations(sourceId, options, graphQLService, linearService);
     if (relations.length === 0) {
@@ -620,9 +692,9 @@ function buildRelationEntries(nodes, peerKey, direction, normalizeType) {
     return entries;
 }
 async function handleRelatedIssues(issueId, _options, command) {
-    const rootOpts = command.parent.parent.opts();
-    const graphQLService = createGraphQLService(rootOpts);
-    const linearService = createLinearService(rootOpts);
+    const rootOpts = getRootOpts(command);
+    const graphQLService = await createGraphQLService(rootOpts);
+    const linearService = await createLinearService(rootOpts);
     const resolvedId = await linearService.resolveIssueId(issueId);
     const result = await graphQLService.rawRequest(GET_ISSUE_RELATIONS_QUERY, {
         id: resolvedId,
@@ -813,10 +885,10 @@ async function handleLinkReferencesBatch(teamInput, options, graphQLService, lin
         },
     });
 }
-function handleLinkReferencesIssue(issueIdOrTeamFlag, options, command) {
-    const rootOpts = command.parent.parent.opts();
-    const graphQLService = createGraphQLService(rootOpts);
-    const linearService = createLinearService(rootOpts);
+async function handleLinkReferencesIssue(issueIdOrTeamFlag, options, command) {
+    const rootOpts = getRootOpts(command);
+    const graphQLService = await createGraphQLService(rootOpts);
+    const linearService = await createLinearService(rootOpts);
     if (options.team) {
         if (issueIdOrTeamFlag) {
             throw new Error("Provide either an issueId positional argument OR --team, not both. With --team, omit the issueId.");
@@ -832,20 +904,20 @@ function handleLinkReferencesIssue(issueIdOrTeamFlag, options, command) {
     return handleLinkReferencesSingle(issueIdOrTeamFlag, options, graphQLService, linearService);
 }
 async function handleReadIssue(issueIds, _options, command) {
-    const rootOpts = command.parent.parent.opts();
-    const graphQLService = createGraphQLService(rootOpts);
-    const linearService = createLinearService(rootOpts);
+    const rootOpts = getRootOpts(command);
+    const graphQLService = await createGraphQLService(rootOpts);
+    const linearService = await createLinearService(rootOpts);
     const issuesService = new GraphQLIssuesService(graphQLService, linearService);
-    const apiToken = getApiToken(rootOpts);
+    const fileService = await createFileService(rootOpts);
     if (issueIds.length === 1) {
         const issue = await issuesService.getIssueById(issueIds[0]);
-        const resolved = await downloadLinearUploads(issue, apiToken);
+        const resolved = await downloadLinearUploads(issue, fileService);
         outputSuccess(resolved);
     }
     else {
         const results = await Promise.all(issueIds.map(async (id) => {
             const issue = await issuesService.getIssueById(id);
-            return downloadLinearUploads(issue, apiToken);
+            return downloadLinearUploads(issue, fileService);
         }));
         outputSuccess(results);
     }
@@ -863,9 +935,9 @@ async function handleUpdateIssue(issueId, options, command) {
         options.description = readDescriptionFile(options.descriptionFile);
     }
     validateUpdateOptions(options);
-    const rootOpts = command.parent.parent.opts();
-    const graphQLService = createGraphQLService(rootOpts);
-    const linearService = createLinearService(rootOpts);
+    const rootOpts = getRootOpts(command);
+    const graphQLService = await createGraphQLService(rootOpts);
+    const linearService = await createLinearService(rootOpts);
     if (options.appendDescription) {
         const resolved = await linearService.resolveIssueId(issueId);
         const current = await graphQLService.rawRequest("query($id: String!) { issue(id: $id) { description } }", { id: resolved });
@@ -952,9 +1024,9 @@ async function handleRetrolink(options, command) {
     const description = commits.length > 0
         ? commits.map((msg) => `- ${msg}`).join("\n")
         : `Retrolinked from branch: ${currentBranch}`;
-    const rootOpts = command.parent.parent.opts();
-    const graphQLService = createGraphQLService(rootOpts);
-    const linearService = createLinearService(rootOpts);
+    const rootOpts = getRootOpts(command);
+    const graphQLService = await createGraphQLService(rootOpts);
+    const linearService = await createLinearService(rootOpts);
     const issuesService = new GraphQLIssuesService(graphQLService, linearService);
     let result;
     if (options.issue) {
@@ -1035,8 +1107,10 @@ export function setupIssuesCommands(program) {
         .option("-t, --title <title>", "issue title (alternative to positional argument)")
         .option("-d, --description <desc>", "issue description")
         .option("--description-file <path>", "read description from file (use - for stdin)")
+        .option("--template <name>", "use a named description template from config.descriptionTemplates")
         .option("-a, --assignee <assignee>", "assign to user (name, alias, or UUID)")
-        .option("-p, --priority <priority>", "priority: name (urgent/high/medium/low) or number (1-4)")
+        .option("--no-assignee", "create unassigned even when config.defaultAssignee is set")
+        .option("-p, --priority <priority>", "priority: name (none/urgent/high/medium/normal/low) or number (0-4)")
         .option("--project <project>", "add to project (name or ID)")
         .option("--team <team>", "team key or name (default: from config)")
         .option("--labels <labels>", "labels (comma-separated names, auto-resolved per team)")
@@ -1056,6 +1130,8 @@ export function setupIssuesCommands(program) {
         .option("--checkout", "create and checkout a git branch named after the issue")
         .option("--skip-validation", "skip all validation (labels, description, assignee, project)")
         .option("--no-auto-link", "skip auto-linking issue references found in the description")
+        .option("--footer <text>", "text appended to the description (overrides config.messageFooter)")
+        .option("--no-footer", "skip the configured messageFooter for this issue")
         .action(handleAsyncCommand((titleArg, options, command) => {
         // Normalize --label alias to --labels
         if (options.label && !options.labels) {
@@ -1087,7 +1163,7 @@ export function setupIssuesCommands(program) {
         .option("--append-description <text>", "append text to the existing description")
         .option("-s, --status <status>", "new status name or ID")
         .option("--state <status>", "alias for --status (new status name or ID)")
-        .option("-p, --priority <priority>", "new priority: name (urgent/high/medium/low) or number (1-4)")
+        .option("-p, --priority <priority>", "new priority: name (none/urgent/high/medium/normal/low) or number (0-4)")
         .option("--assignee <assignee>", "new assignee (name, alias, or UUID)")
         .option("--project <project>", "new project (name or ID)")
         .option("--labels <labels>", "labels (comma-separated names or IDs)")

package/dist/commands/labels.js

@@ -1,13 +1,16 @@
+import { loadConfig } from "../config/config.js";
 import { resolveTeam } from "../config/resolver.js";
 import { CREATE_LABEL_MUTATION, FIND_PARENT_LABEL_QUERY, RESTORE_LABEL_MUTATION, RETIRE_LABEL_MUTATION, } from "../queries/labels.js";
+import { cached, resolveCacheTTL } from "../utils/disk-cache.js";
 import { createGraphQLService } from "../utils/graphql-service.js";
 import { createLinearService } from "../utils/linear-service.js";
 import { handleAsyncCommand, outputSuccess } from "../utils/output.js";
+import { getRootOpts } from "../utils/root-opts.js";
 import { validateHexColor } from "../utils/validators.js";
 async function handleCreateLabel(name, options, command) {
-    const rootOpts = command.parent.parent.opts();
+    const rootOpts = getRootOpts(command);
     const teamId = resolveTeam(options.team);
-    const graphQLService = createGraphQLService(rootOpts);
+    const graphQLService = await createGraphQLService(rootOpts);
     const input = { name, teamId };
     if (options.color) {
         input.color = validateHexColor(options.color);
@@ -37,8 +40,8 @@ async function handleCreateLabel(name, options, command) {
     outputSuccess(createResult.issueLabel);
 }
 async function handleRetireLabel(labelId, _options, command) {
-    const rootOpts = command.parent.parent.opts();
-    const graphQLService = createGraphQLService(rootOpts);
+    const rootOpts = getRootOpts(command);
+    const graphQLService = await createGraphQLService(rootOpts);
     const result = await graphQLService.rawRequest(RETIRE_LABEL_MUTATION, {
         id: labelId,
     });
@@ -49,8 +52,8 @@ async function handleRetireLabel(labelId, _options, command) {
     outputSuccess(retireResult.issueLabel);
 }
 async function handleRestoreLabel(labelId, _options, command) {
-    const rootOpts = command.parent.parent.opts();
-    const graphQLService = createGraphQLService(rootOpts);
+    const rootOpts = getRootOpts(command);
+    const graphQLService = await createGraphQLService(rootOpts);
     const result = await graphQLService.rawRequest(RESTORE_LABEL_MUTATION, {
         id: labelId,
     });
@@ -72,10 +75,21 @@ export function setupLabelsCommands(program) {
         .option("--team <team>", "filter by team key, name, or ID")
         .option("-l, --limit <number>", "limit results", "100")
         .action(handleAsyncCommand(async (options, command) => {
-        const rootOpts = command.parent.parent.opts();
+        const rootOpts = getRootOpts(command);
         const teamFilter = options.team ? resolveTeam(options.team) : undefined;
-        const service = createLinearService(rootOpts);
-        const result = await service.getLabels(teamFilter, Number.parseInt(options.limit, 10));
+        const limit = Number.parseInt(options.limit, 10);
+        const ttl = resolveCacheTTL({
+            configTTL: loadConfig().cacheTTLSeconds,
+            noCacheFlag: rootOpts.cache === false,
+        });
+        // Cache key includes the team filter so list-with-team and list-
+        // without-team don't collide. Same `limit` participates because
+        // a smaller list isn't a valid cached answer for a larger ask.
+        const cacheKey = `labels-list-team:${teamFilter ?? "_all"}-limit:${limit}`;
+        const result = await cached(cacheKey, ttl, async () => {
+            const service = await createLinearService(rootOpts);
+            return service.getLabels(teamFilter, limit);
+        });
         outputSuccess({
             data: result.labels,
             meta: { count: result.labels.length },

package/dist/commands/profile/migrate-legacy.js

@@ -157,7 +157,6 @@ async function resolveAndValidateToken(options, prompts, validate) {
         }
         catch (err) {
             const raw = err instanceof Error ? err.message : String(err);
-            // biome-ignore lint/suspicious/noConsole: interactive prompt feedback
             console.log(`  ✗ ${sanitizeForLog(raw)}`);
         }
     }

package/dist/commands/project-milestones.js

@@ -3,6 +3,7 @@ import { multipleMatchesError, notFoundError, } from "../utils/error-messages.js
 import { createGraphQLService, } from "../utils/graphql-service.js";
 import { createLinearService, } from "../utils/linear-service.js";
 import { handleAsyncCommand, outputSuccess } from "../utils/output.js";
+import { getRootOpts } from "../utils/root-opts.js";
 import { isUuid } from "../utils/uuid.js";
 import { validateIsoDate } from "../utils/validators.js";
 async function resolveMilestoneId(milestoneNameOrId, graphQLService, linearService, projectNameOrId) {
@@ -37,9 +38,9 @@ async function resolveMilestoneId(milestoneNameOrId, graphQLService, linearServi
     return nodes[0].id;
 }
 async function handleListMilestones(options, command) {
-    const rootOpts = command.parent.parent.opts();
-    const graphQLService = createGraphQLService(rootOpts);
-    const linearService = createLinearService(rootOpts);
+    const rootOpts = getRootOpts(command);
+    const graphQLService = await createGraphQLService(rootOpts);
+    const linearService = await createLinearService(rootOpts);
     const projectId = await linearService.resolveProjectId(options.project);
     const result = await graphQLService.rawRequest(LIST_PROJECT_MILESTONES_QUERY, {
         projectId,
@@ -51,9 +52,9 @@ async function handleListMilestones(options, command) {
     outputSuccess({ data: nodes, meta: { count: nodes.length } });
 }
 async function handleReadMilestone(milestoneIdOrName, options, command) {
-    const rootOpts = command.parent.parent.opts();
-    const graphQLService = createGraphQLService(rootOpts);
-    const linearService = createLinearService(rootOpts);
+    const rootOpts = getRootOpts(command);
+    const graphQLService = await createGraphQLService(rootOpts);
+    const linearService = await createLinearService(rootOpts);
     const milestoneId = await resolveMilestoneId(milestoneIdOrName, graphQLService, linearService, options.project);
     const result = await graphQLService.rawRequest(GET_PROJECT_MILESTONE_BY_ID_QUERY, {
         id: milestoneId,
@@ -62,9 +63,9 @@ async function handleReadMilestone(milestoneIdOrName, options, command) {
     outputSuccess(result.projectMilestone);
 }
 async function handleCreateMilestone(name, options, command) {
-    const rootOpts = command.parent.parent.opts();
-    const graphQLService = createGraphQLService(rootOpts);
-    const linearService = createLinearService(rootOpts);
+    const rootOpts = getRootOpts(command);
+    const graphQLService = await createGraphQLService(rootOpts);
+    const linearService = await createLinearService(rootOpts);
     const projectId = await linearService.resolveProjectId(options.project);
     if (options.targetDate) {
         validateIsoDate(options.targetDate);
@@ -82,9 +83,9 @@ async function handleCreateMilestone(name, options, command) {
     outputSuccess(createData.projectMilestone);
 }
 async function handleUpdateMilestone(milestoneIdOrName, options, command) {
-    const rootOpts = command.parent.parent.opts();
-    const graphQLService = createGraphQLService(rootOpts);
-    const linearService = createLinearService(rootOpts);
+    const rootOpts = getRootOpts(command);
+    const graphQLService = await createGraphQLService(rootOpts);
+    const linearService = await createLinearService(rootOpts);
     const milestoneId = await resolveMilestoneId(milestoneIdOrName, graphQLService, linearService, options.project);
     const updateVars = { id: milestoneId };
     if (options.name !== undefined) {

package/dist/commands/projects.js

@@ -1,9 +1,12 @@
+import { loadConfig } from "../config/config.js";
 import { resolveTeam } from "../config/resolver.js";
 import { CREATE_PROJECT_MUTATION, GET_PROJECT_QUERY, GET_PROJECT_TEAM_ISSUES_QUERY, PROJECT_BY_ID_QUERY, SEARCH_PROJECTS_BY_NAME_QUERY, UPDATE_PROJECT_MUTATION, } from "../queries/projects.js";
+import { cached, resolveCacheTTL } from "../utils/disk-cache.js";
 import { createGraphQLService } from "../utils/graphql-service.js";
 import { createLinearService } from "../utils/linear-service.js";
 import { logger } from "../utils/logger.js";
 import { handleAsyncCommand, outputSuccess } from "../utils/output.js";
+import { getRootOpts } from "../utils/root-opts.js";
 import { isUuid } from "../utils/uuid.js";
 import { splitList } from "../utils/validators.js";
 function formatProjectsOutput(projects, format, fieldNames) {
@@ -126,9 +129,10 @@ function formatTeamsOutput(projectUpdate) {
     };
 }
 async function handleAddTeam(projectNameOrId, teamInput, _options, command) {
-    const rootOpts = command.parent.parent.opts();
-    const graphQLService = createGraphQLService(rootOpts);
-    const finalTeamId = await createLinearService(rootOpts).resolveTeamId(resolveTeam(teamInput));
+    const rootOpts = getRootOpts(command);
+    const graphQLService = await createGraphQLService(rootOpts);
+    const linearService = await createLinearService(rootOpts);
+    const finalTeamId = await linearService.resolveTeamId(resolveTeam(teamInput));
     const { projectId, currentTeams } = await resolveProjectWithTeams(graphQLService, projectNameOrId);
     const currentTeamIds = currentTeams.map((t) => t.id);
     if (currentTeamIds.includes(finalTeamId)) {
@@ -149,9 +153,10 @@ async function handleAddTeam(projectNameOrId, teamInput, _options, command) {
     outputSuccess(formatTeamsOutput(projectUpdate));
 }
 async function handleAddTeams(projectNameOrId, teamInputs, _options, command) {
-    const rootOpts = command.parent.parent.opts();
-    const graphQLService = createGraphQLService(rootOpts);
-    const resolvedTeamIds = await Promise.all(teamInputs.map((t) => createLinearService(rootOpts).resolveTeamId(resolveTeam(t))));
+    const rootOpts = getRootOpts(command);
+    const graphQLService = await createGraphQLService(rootOpts);
+    const linearService = await createLinearService(rootOpts);
+    const resolvedTeamIds = await Promise.all(teamInputs.map((t) => linearService.resolveTeamId(resolveTeam(t))));
     const { projectId, currentTeams } = await resolveProjectWithTeams(graphQLService, projectNameOrId);
     const currentTeamIds = currentTeams.map((t) => t.id);
     const newTeamIds = resolvedTeamIds.filter((id) => !currentTeamIds.includes(id));
@@ -181,9 +186,10 @@ async function handleAddTeams(projectNameOrId, teamInputs, _options, command) {
     });
 }
 async function handleRemoveTeam(projectNameOrId, teamInput, options, command) {
-    const rootOpts = command.parent.parent.opts();
-    const graphQLService = createGraphQLService(rootOpts);
-    const finalTeamId = await createLinearService(rootOpts).resolveTeamId(resolveTeam(teamInput));
+    const rootOpts = getRootOpts(command);
+    const graphQLService = await createGraphQLService(rootOpts);
+    const linearService = await createLinearService(rootOpts);
+    const finalTeamId = await linearService.resolveTeamId(resolveTeam(teamInput));
     const { projectId, projectName, currentTeams } = await resolveProjectWithTeams(graphQLService, projectNameOrId);
     const currentTeamIds = currentTeams.map((t) => t.id);
     if (!currentTeamIds.includes(finalTeamId)) {
@@ -220,8 +226,8 @@ async function handleRemoveTeam(projectNameOrId, teamInput, options, command) {
     });
 }
 async function handleCreateProject(name, options, command) {
-    const rootOpts = command.parent.parent.opts();
-    const graphQLService = createGraphQLService(rootOpts);
+    const rootOpts = getRootOpts(command);
+    const graphQLService = await createGraphQLService(rootOpts);
     // Step 1: Check for duplicate projects (case-insensitive)
     const searchResult = await graphQLService.rawRequest(SEARCH_PROJECTS_BY_NAME_QUERY, { name });
     const existing = (searchResult.projects
@@ -236,7 +242,7 @@ async function handleCreateProject(name, options, command) {
             `Use --force to create anyway, or use the existing project.`);
     }
     // Step 2: Resolve team IDs
-    const service = createLinearService(rootOpts);
+    const service = await createLinearService(rootOpts);
     const teamKeys = options.team ? splitList(options.team) : [];
     const teamIds = [];
     for (const key of teamKeys) {
@@ -300,9 +306,16 @@ export function setupProjectsCommands(program) {
         .option("--format <format>", "output format (json, table, md, csv)", "json")
         .option("--fields <fields>", "columns for table/csv (comma-separated: name,state,progress,teams,lead,targetDate)")
         .action(handleAsyncCommand(async (options, command) => {
-        const rootOpts = command.parent.parent.opts();
-        const service = createLinearService(rootOpts);
-        const result = await service.getProjects(Number.parseInt(options.limit, 10));
+        const rootOpts = getRootOpts(command);
+        const limit = Number.parseInt(options.limit, 10);
+        const ttl = resolveCacheTTL({
+            configTTL: loadConfig().cacheTTLSeconds,
+            noCacheFlag: rootOpts.cache === false,
+        });
+        const result = await cached(`projects-list-limit:${limit}`, ttl, async () => {
+            const service = await createLinearService(rootOpts);
+            return service.getProjects(limit);
+        });
         const format = options.format;
         if (format === "table" ||
             format === "md" ||

package/dist/commands/read-shortcut.js

@@ -1,9 +1,10 @@
-import { getApiToken } from "../utils/auth.js";
 import { downloadLinearUploads } from "../utils/download-uploads.js";
+import { createFileService } from "../utils/file-service.js";
 import { GraphQLIssuesService } from "../utils/graphql-issues-service.js";
 import { createGraphQLService } from "../utils/graphql-service.js";
 import { createLinearService } from "../utils/linear-service.js";
 import { handleAsyncCommand, outputSuccess } from "../utils/output.js";
+import { getRootOpts } from "../utils/root-opts.js";
 /**
  * Issue ID pattern: 1-5 uppercase letters, dash, 1+ digits (e.g. ADM-652, DEV-12).
  */
@@ -49,20 +50,20 @@ export function setupReadShortcut(program) {
     };
 }
 async function readIssues(issueIds, _options, command) {
-    const rootOpts = command.parent.opts();
-    const graphQLService = createGraphQLService(rootOpts);
-    const linearService = createLinearService(rootOpts);
+    const rootOpts = getRootOpts(command);
+    const graphQLService = await createGraphQLService(rootOpts);
+    const linearService = await createLinearService(rootOpts);
     const issuesService = new GraphQLIssuesService(graphQLService, linearService);
-    const apiToken = getApiToken(rootOpts);
+    const fileService = await createFileService(rootOpts);
     if (issueIds.length === 1) {
         const issue = await issuesService.getIssueById(issueIds[0]);
-        const resolved = await downloadLinearUploads(issue, apiToken);
+        const resolved = await downloadLinearUploads(issue, fileService);
         outputSuccess(resolved);
     }
     else {
         const results = await Promise.all(issueIds.map(async (id) => {
             const issue = await issuesService.getIssueById(id);
-            return downloadLinearUploads(issue, apiToken);
+            return downloadLinearUploads(issue, fileService);
         }));
         outputSuccess(results);
     }