@enrichlayer/el-linear 1.5.0 → 1.6.0

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,
         }));

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(".");
@@ -296,9 +326,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 +367,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,
@@ -417,8 +447,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 +471,21 @@ function buildDescriptionWithAttachments(baseDescription, uploadResults) {
     return description;
 }
 async function handleCreateIssue(title, options, command) {
-    const rootOpts = command.parent.parent.opts();
+    const rootOpts = getRootOpts(command);
     const { teamInput, teamId, assigneeId, labelIds, status, subscriberIds } = 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
@@ -486,7 +524,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 +555,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 +585,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 +658,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 +851,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 +870,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 +901,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 +990,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 +1073,9 @@ 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("-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 +1095,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 +1128,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

@@ -3,11 +3,12 @@ import { CREATE_LABEL_MUTATION, FIND_PARENT_LABEL_QUERY, RESTORE_LABEL_MUTATION,
 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 +38,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 +50,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,9 +73,9 @@ 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 service = await createLinearService(rootOpts);
         const result = await service.getLabels(teamFilter, Number.parseInt(options.limit, 10));
         outputSuccess({
             data: result.labels,

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

@@ -4,6 +4,7 @@ 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 +127,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 +151,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 +184,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 +224,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 +240,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,8 +304,8 @@ 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 rootOpts = getRootOpts(command);
+        const service = await createLinearService(rootOpts);
         const result = await service.getProjects(Number.parseInt(options.limit, 10));
         const format = options.format;
         if (format === "table" ||

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);
     }

package/dist/commands/refs.js

@@ -4,6 +4,7 @@ import { extractIssueReferences } from "../utils/issue-reference-extractor.js";
 import { wrapIssueReferencesAsLinks, } from "../utils/issue-reference-wrapper.js";
 import { createLinearService } from "../utils/linear-service.js";
 import { handleAsyncCommand } from "../utils/output.js";
+import { getRootOpts } from "../utils/root-opts.js";
 import { validateReferences } from "../utils/validate-references.js";
 import { getWorkspaceUrlKey } from "../utils/workspace-url.js";
 const VALID_TARGETS = new Set(["markdown", "slack"]);
@@ -58,15 +59,15 @@ async function handleWrap(options, command) {
     const text = typeof options.file === "string" && options.file.length > 0
         ? readFileSync(options.file, "utf8")
         : await readAllStdin();
-    const rootOpts = command.parent.parent.opts();
+    const rootOpts = getRootOpts(command);
     const deps = {
         async resolveValidIdentifiers(ids) {
-            const linearService = createLinearService(rootOpts);
+            const linearService = await createLinearService(rootOpts);
             const map = await validateReferences(ids, linearService);
             return new Set(map.keys());
         },
         async resolveUrlKey() {
-            const graphQLService = createGraphQLService(rootOpts);
+            const graphQLService = await createGraphQLService(rootOpts);
             return getWorkspaceUrlKey(graphQLService);
         },
     };

package/dist/commands/releases.js

@@ -1,6 +1,7 @@
 import { CREATE_RELEASE_MUTATION, GET_RELEASE_BY_ID_QUERY, GET_RELEASE_PIPELINES_QUERY, GET_RELEASES_QUERY, } from "../queries/releases.js";
 import { createGraphQLService } from "../utils/graphql-service.js";
 import { handleAsyncCommand, outputSuccess } from "../utils/output.js";
+import { getRootOpts } from "../utils/root-opts.js";
 function transformRelease(release) {
     return {
         id: release.id,
@@ -36,8 +37,8 @@ function transformRelease(release) {
     };
 }
 async function handleCreateRelease(name, options, command) {
-    const rootOpts = command.parent.parent.opts();
-    const graphQLService = createGraphQLService(rootOpts);
+    const rootOpts = getRootOpts(command);
+    const graphQLService = await createGraphQLService(rootOpts);
     const pipelines = await graphQLService.rawRequest(GET_RELEASE_PIPELINES_QUERY, { first: 50 });
     const pipelineNodes = pipelines.releasePipelines
         ?.nodes;
@@ -84,8 +85,8 @@ export function setupReleasesCommands(program) {
         .option("--pipeline <pipeline>", "filter by pipeline name or ID")
         .option("-l, --limit <number>", "limit results", "25")
         .action(handleAsyncCommand(async (options, command) => {
-        const rootOpts = command.parent.parent.opts();
-        const graphQLService = createGraphQLService(rootOpts);
+        const rootOpts = getRootOpts(command);
+        const graphQLService = await createGraphQLService(rootOpts);
         const filter = {};
         if (options.pipeline) {
             filter.pipeline = { name: { eqIgnoreCase: options.pipeline } };
@@ -102,8 +103,8 @@ export function setupReleasesCommands(program) {
         .command("read <releaseId>")
         .description("Get release details including linked documents")
         .action(handleAsyncCommand(async (releaseId, _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(GET_RELEASE_BY_ID_QUERY, { id: releaseId });
         if (!result.release) {
             throw new Error(`Release "${releaseId}" not found`);
@@ -122,8 +123,8 @@ export function setupReleasesCommands(program) {
         .command("pipelines")
         .description("List release pipelines and their stages")
         .action(handleAsyncCommand(async (_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(GET_RELEASE_PIPELINES_QUERY, { first: 50 });
         const data = (result.releasePipelines
             ?.nodes ?? []).map((p) => ({

package/dist/commands/search.js

@@ -2,6 +2,7 @@ import { resolveTeam, resolveUserDisplayName } from "../config/resolver.js";
 import { SEMANTIC_SEARCH_QUERY } from "../queries/search.js";
 import { createGraphQLService } from "../utils/graphql-service.js";
 import { handleAsyncCommand, outputSuccess } from "../utils/output.js";
+import { getRootOpts } from "../utils/root-opts.js";
 const TEMPLATES_QUERY = `
   query {
     templates {
@@ -137,8 +138,8 @@ export function setupSearchCommands(program) {
         .option("--team <team>", "filter issue results by team key")
         .option("-l, --limit <number>", "max results", "10")
         .action(handleAsyncCommand(async (query, options, command) => {
-        const rootOpts = command.parent.opts();
-        const graphQLService = createGraphQLService(rootOpts);
+        const rootOpts = getRootOpts(command);
+        const graphQLService = await createGraphQLService(rootOpts);
         const limit = Number.parseInt(options.limit, 10);
         const requestedTypes = options.type
             ? options.type.split(",").map((t) => t.trim().toLowerCase())