@enrichlayer/el-linear 1.7.0 → 1.10.0

package/dist/commands/issues.js

@@ -1,29 +1,26 @@
 import { execFileSync } from "node:child_process";
-import fs from "node:fs";
 import { loadConfig } from "../config/config.js";
 import { enforceValidation, validateIssueCreation, } from "../config/issue-validation.js";
 import { resolveAssignee, resolveLabels, resolveMember, resolveTeam, } from "../config/resolver.js";
 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 { autoLinkReferences, } from "../utils/auto-link-references.js";
-import { downloadLinearUploads } from "../utils/download-uploads.js";
+import { GET_ISSUE_RELATIONS_QUERY, GET_ISSUE_STATE_HISTORY_QUERY, } from "../queries/issues.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";
-import { extractIssueReferences } from "../utils/issue-reference-extractor.js";
-import { wrapIssueReferencesAsLinks } from "../utils/issue-reference-wrapper.js";
-import { createLinearService, } from "../utils/linear-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 { 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";
-import { getWorkspaceUrlKey } from "../utils/workspace-url.js";
+import { parsePositiveInt, parsePriorityFilter, splitList, validatePriority, } from "../utils/validators.js";
+import { gitCheckoutBranch, toBranchName } from "./issues/branch.js";
+import { maybeAutoLink, prepareAutoLinkedDescription, readDescriptionFile, resolveDescription, } from "./issues/description.js";
+import { handleLinkReferencesIssue } from "./issues/link-references.js";
+import { buildIncomingRelationEntries, buildOutgoingRelationEntries, createRelations, } from "./issues/relations.js";
+import { readIssues } from "./read-shortcut.js";
 const IMAGE_EXTENSIONS = new Set([
     ".png",
     ".jpg",
@@ -33,202 +30,11 @@ const IMAGE_EXTENSIONS = new Set([
     ".svg",
     ".ico",
 ]);
-const LINEAR_BRANCH_REGEX = /^([a-zA-Z]+)-(\d+)-(.+)$/;
 const COMMIT_HASH_PREFIX_REGEX = /^[a-f0-9]+ /;
-/**
- * Transform Linear's branchName (e.g. "dev-3549-slug") into our convention:
- * "feature/DEV-3549-slug" — uppercase team key with a configurable prefix.
- */
-function toBranchName(linearBranchName, prefix = "feature/") {
-    // Linear branch names look like "dev-123-some-slug"
-    // We need to uppercase the team key: "DEV-123-some-slug"
-    const match = linearBranchName.match(LINEAR_BRANCH_REGEX);
-    if (!match) {
-        return `${prefix}${linearBranchName}`;
-    }
-    const [, teamKey, number, slug] = match;
-    return `${prefix}${teamKey.toUpperCase()}-${number}-${slug}`;
-}
-/**
- * Check out a new git branch. Warns and skips if not in a git repo.
- * Throws if the branch already exists.
- */
-function gitCheckoutBranch(branchName) {
-    try {
-        execFileSync("git", ["rev-parse", "--is-inside-work-tree"], {
-            stdio: "pipe",
-        });
-    }
-    catch {
-        outputWarning("Not inside a git repository — skipping branch checkout.");
-        return;
-    }
-    execFileSync("git", ["checkout", "-b", branchName], { stdio: "pipe" });
-}
-/**
- * Read description from a file path or stdin ("-").
- * Avoids shell escaping issues when descriptions contain special characters.
- */
-function readDescriptionFile(filePath) {
-    if (filePath === "-") {
-        return fs.readFileSync(0, "utf8").trim();
-    }
-    if (!fs.existsSync(filePath)) {
-        throw new Error(`Description file not found: ${filePath}`);
-    }
-    return fs.readFileSync(filePath, "utf8").trim();
-}
-/**
- * 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) {
-    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);
-    }
-    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(".");
     return ext !== -1 && IMAGE_EXTENSIONS.has(filename.slice(ext).toLowerCase());
 }
-function transformIssueRelation(rel) {
-    const issue = rel.issue;
-    const relatedIssue = rel.relatedIssue;
-    return {
-        id: rel.id,
-        type: rel.type,
-        issue: {
-            id: issue.id,
-            identifier: issue.identifier,
-            title: issue.title,
-        },
-        relatedIssue: {
-            id: relatedIssue.id,
-            identifier: relatedIssue.identifier,
-            title: relatedIssue.title,
-        },
-    };
-}
-async function createRelations(sourceId, options, graphQLService, linearService) {
-    const relations = [];
-    const relationSpecs = [
-        { option: "relatedTo", type: "related" },
-        { option: "blocks", type: "blocks" },
-        { option: "blockedBy", type: "blocks", reverse: true },
-        { option: "duplicateOf", type: "duplicate" },
-    ];
-    for (const spec of relationSpecs) {
-        const value = options[spec.option];
-        if (!value) {
-            continue;
-        }
-        for (const id of splitList(value)) {
-            const targetId = await linearService.resolveIssueId(id);
-            const rel = await graphQLService.rawRequest(ISSUE_RELATION_CREATE_MUTATION, {
-                input: {
-                    issueId: spec.reverse ? targetId : sourceId,
-                    relatedIssueId: spec.reverse ? sourceId : targetId,
-                    type: spec.type,
-                },
-            });
-            const create = rel.issueRelationCreate;
-            const issueRelation = create?.issueRelation;
-            relations.push(transformIssueRelation(issueRelation));
-        }
-    }
-    return relations;
-}
-/**
- * Pre-process a description before sending to Linear:
- * 1. Extract all issue references from the description.
- * 2. Validate them (drop those that don't resolve in this workspace — handles "ISO-1424"-style false positives).
- * 3. Wrap valid identifiers as markdown links — skipping any already inside a link, code block, or backtick span.
- *
- * Returns the rewritten description plus the validated map for downstream auto-linking.
- *
- * No-ops (returns the original description with an empty map) when:
- * - description is empty/undefined
- * - the user passed `--no-auto-link`
- */
-async function prepareAutoLinkedDescription(description, options, selfIdentifier, linearService, graphQLService) {
-    if (!description || options.autoLink === false) {
-        return { description, preResolved: new Map(), rewritten: false };
-    }
-    const refs = extractIssueReferences(description, selfIdentifier);
-    if (refs.length === 0) {
-        return { description, preResolved: new Map(), rewritten: false };
-    }
-    const preResolved = await validateReferences(refs.map((r) => r.identifier), linearService);
-    if (preResolved.size === 0) {
-        return { description, preResolved, rewritten: false };
-    }
-    const validIds = new Set(preResolved.keys());
-    const urlKey = await getWorkspaceUrlKey(graphQLService);
-    const wrapped = wrapIssueReferencesAsLinks(description, validIds, urlKey);
-    return {
-        description: wrapped,
-        preResolved,
-        rewritten: wrapped !== description,
-    };
-}
-/**
- * Run auto-linking for issue references found in a description, unless the user opted out
- * with --no-auto-link or no description was provided. Returns undefined when nothing was linked
- * and nothing was skipped/failed (so callers can omit the field from JSON output).
- */
-async function maybeAutoLink(input) {
-    const { issueId, identifier, description, options, graphQLService, linearService, preResolved, } = input;
-    if (options.autoLink === false) {
-        return;
-    }
-    if (!description) {
-        return;
-    }
-    const result = await autoLinkReferences({
-        issueId,
-        identifier,
-        description,
-        graphQLService,
-        linearService,
-        preResolved,
-    });
-    if (result.linked.length === 0 &&
-        result.skipped.length === 0 &&
-        result.failed.length === 0) {
-        return;
-    }
-    return result;
-}
 function validateUpdateOptions(options) {
     if (options.parentTicket && options.clearParentTicket) {
         throw new Error("Cannot use --parent-ticket and --clear-parent-ticket together");
@@ -359,7 +165,7 @@ async function handleListIssues(options, command) {
                 ? parsePriorityFilter(options.priority)
                 : undefined,
             orderBy: options.sort === "created" ? "createdAt" : "updatedAt",
-            limit: Number.parseInt(options.limit, 10),
+            limit: parsePositiveInt(options.limit, "--limit"),
         };
         const result = sortIssues(await issuesService.searchIssues(searchArgs), options.sort);
         outputIssues(result, options.format, options.fields, {
@@ -367,7 +173,7 @@ async function handleListIssues(options, command) {
         });
     }
     else {
-        const result = sortIssues(await issuesService.getIssues(Number.parseInt(options.limit, 10)), options.sort);
+        const result = sortIssues(await issuesService.getIssues(parsePositiveInt(options.limit, "--limit")), options.sort);
         outputIssues(result, options.format, options.fields, {});
     }
 }
@@ -392,7 +198,7 @@ async function handleSearchIssues(query, options, command) {
         priority: options.priority
             ? parsePriorityFilter(options.priority)
             : undefined,
-        limit: Number.parseInt(options.limit, 10),
+        limit: parsePositiveInt(options.limit, "--limit"),
     };
     const result = sortIssues(await issuesService.searchIssues(searchArgs), options.sort);
     outputIssues(result, options.format, options.fields, { query });
@@ -417,8 +223,14 @@ async function resolveCreateInputs(title, options, rootOpts) {
         : config.defaultPriority;
     // --- Validation (labels, description, assignee, project, title) ---
     // Controlled by config.validation.enabled (default: true).
-    // Bypassed by --skip-validation flag.
-    if (!options.skipValidation) {
+    // Bypassed by --skip-validation flag, OR by --from-template which
+    // defers field provision to Linear's server-side template
+    // instantiation. With --from-template + no overrides, the
+    // resulting issue inherits title/description/labels/etc. from the
+    // template — running the local validator against undefined fields
+    // would produce a false-negative "Missing --labels" error.
+    const hasFromTemplate = typeof options.fromTemplate === "string" && options.fromTemplate;
+    if (!options.skipValidation && !hasFromTemplate) {
         const rawLabels = options.labels ? splitList(options.labels) : null;
         const description = resolveDescription(options);
         const validationResult = validateIssueCreation({
@@ -435,7 +247,7 @@ async function resolveCreateInputs(title, options, rootOpts) {
         enforceValidation(validationResult);
     }
     if (!effectivePriorityInput) {
-        outputWarning("Creating issue without --priority. Consider specifying it for better triage.", "missing_fields");
+        outputWarning("Creating issue without --priority. Consider specifying it for better triage.");
     }
     const teamInput = options.team || config.defaultTeam;
     const teamId = resolveTeam(teamInput);
@@ -506,7 +318,7 @@ function buildDescriptionWithAttachments(baseDescription, uploadResults) {
 }
 async function handleCreateIssue(title, options, command) {
     const rootOpts = getRootOpts(command);
-    const { teamInput, teamId, assigneeId, labelIds, status, subscriberIds, priority, } = await resolveCreateInputs(title, options, rootOpts);
+    const { teamInput, teamId, assigneeId, labelIds, status, subscriberIds, priority, } = await resolveCreateInputs(title ?? "", options, rootOpts);
     const uploadResults = await uploadAttachmentsIfNeeded(options, rootOpts);
     const descriptionWithAttachments = buildDescriptionWithAttachments(resolveDescription(options) || "", uploadResults);
     // Append messageFooter (config or --footer flag) so auto-link picks up any
@@ -526,7 +338,9 @@ async function handleCreateIssue(title, options, command) {
     // because the issue doesn't exist yet — pass undefined.
     const prepared = await prepareAutoLinkedDescription(description || undefined, options, undefined, linearService, graphQLService);
     const result = await issuesService.createIssue({
-        title,
+        // title is omitted when --from-template is set without an override,
+        // so Linear copies the template's title server-side.
+        ...(title ? { title } : {}),
         teamId,
         teamInput,
         description: prepared.description,
@@ -540,6 +354,12 @@ async function handleCreateIssue(title, options, command) {
         cycleId: options.cycle,
         subscriberIds,
         dueDate: options.dueDate,
+        // Linear server-side template instantiation. When set,
+        // Linear copies the template's title/description/labels/priority
+        // onto the new issue; any explicit field above wins by override.
+        ...(typeof options.fromTemplate === "string" && options.fromTemplate
+            ? { templateId: options.fromTemplate }
+            : {}),
     });
     const relations = await createRelations(result.id, options, graphQLService, linearService);
     // Pass the ORIGINAL description (pre-wrap) so the extractor's prose-keyword inference
@@ -593,22 +413,19 @@ async function handleHistoryIssue(issueId, _options, 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,
-    });
+    const result = await graphQLService.rawRequest(GET_ISSUE_STATE_HISTORY_QUERY, { id: resolvedId });
     if (!result.issue) {
         throw new Error(`Issue "${issueId}" not found`);
     }
     const issue = result.issue;
-    const stateHistory = issue.stateHistory;
-    const spans = (stateHistory?.nodes ?? []).map((span) => ({
+    const spans = issue.stateHistory.nodes.map((span) => ({
         state: {
             id: span.state.id,
             name: span.state.name,
             type: span.state.type,
         },
         startedAt: span.startedAt,
-        endedAt: span.endedAt || undefined,
+        endedAt: span.endedAt ?? undefined,
     }));
     outputSuccess({
         id: issue.id,
@@ -632,82 +449,19 @@ async function handleRelateIssue(issueId, options, command) {
         meta: { count: relations.length, source: issueId },
     });
 }
-/**
- * Invert relation type for incoming (inverse) relations so the output
- * reads naturally from the perspective of the queried issue.
- * e.g. if DEV-100 "blocks" DEV-200, and we query DEV-200,
- * the inverse relation type is "blocks" but direction is incoming → "blockedBy".
- */
-function normalizeInverseType(type) {
-    if (type === "blocks") {
-        return "blockedBy";
-    }
-    return type;
-}
-function buildRelatedIssueSummary(peer) {
-    const state = peer.state;
-    const assignee = peer.assignee;
-    const team = peer.team;
-    return {
-        id: peer.id,
-        identifier: peer.identifier,
-        title: peer.title,
-        ...(state
-            ? { state: { id: state.id, name: state.name } }
-            : {}),
-        ...(peer.priority == null ? {} : { priority: peer.priority }),
-        ...(assignee
-            ? {
-                assignee: {
-                    id: assignee.id,
-                    name: assignee.name,
-                },
-            }
-            : {}),
-        ...(team
-            ? {
-                team: {
-                    id: team.id,
-                    key: team.key,
-                    name: team.name,
-                },
-            }
-            : {}),
-    };
-}
-function buildRelationEntries(nodes, peerKey, direction, normalizeType) {
-    const entries = [];
-    for (const rel of nodes ?? []) {
-        const peer = rel[peerKey];
-        if (!peer) {
-            continue;
-        }
-        entries.push({
-            id: rel.id,
-            type: normalizeType(rel.type),
-            direction,
-            issue: buildRelatedIssueSummary(peer),
-        });
-    }
-    return entries;
-}
 async function handleRelatedIssues(issueId, _options, command) {
     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,
-    });
+    const result = await graphQLService.rawRequest(GET_ISSUE_RELATIONS_QUERY, { id: resolvedId });
     if (!result.issue) {
         throw new Error(`Issue "${issueId}" not found`);
     }
     const issue = result.issue;
-    const relations = issue.relations;
-    const inverseRelations = issue.inverseRelations;
     const entries = [
-        ...buildRelationEntries(relations?.nodes, "relatedIssue", "outgoing", (raw) => raw),
-        ...buildRelationEntries(inverseRelations?.nodes, "issue", "incoming", normalizeInverseType),
+        ...buildOutgoingRelationEntries(issue.relations.nodes),
+        ...buildIncomingRelationEntries(issue.inverseRelations.nodes),
     ];
     outputSuccess({
         id: issue.id,
@@ -717,211 +471,6 @@ async function handleRelatedIssues(issueId, _options, command) {
         meta: { count: entries.length },
     });
 }
-async function fetchCommentBodies(issueUuid, graphQLService) {
-    const result = await graphQLService.rawRequest(LIST_COMMENTS_QUERY, {
-        issueId: issueUuid,
-        first: 250,
-    });
-    const issue = result.issue;
-    const comments = issue?.comments;
-    const nodes = comments?.nodes ?? [];
-    return nodes
-        .map((c) => c.body)
-        .filter((b) => typeof b === "string" && b.length > 0);
-}
-async function linkReferencesForIssue(args) {
-    const comments = args.includeComments
-        ? await fetchCommentBodies(args.issueUuid, args.graphQLService)
-        : undefined;
-    return autoLinkReferences({
-        issueId: args.issueUuid,
-        identifier: args.identifier,
-        description: args.description,
-        comments,
-        dryRun: args.dryRun,
-        graphQLService: args.graphQLService,
-        linearService: args.linearService,
-        preResolved: args.preResolved,
-    });
-}
-/**
- * Prepare a description rewrite: validate refs, wrap valid IDs as markdown links,
- * and return the rewritten text (or undefined if nothing would change).
- */
-async function prepareDescriptionRewrite(description, selfIdentifier, linearService, graphQLService) {
-    if (!description) {
-        return { preResolved: undefined, wrapped: undefined };
-    }
-    const refs = extractIssueReferences(description, selfIdentifier);
-    if (refs.length === 0) {
-        return { preResolved: undefined, wrapped: undefined };
-    }
-    const preResolved = await validateReferences(refs.map((r) => r.identifier), linearService);
-    if (preResolved.size === 0) {
-        return { preResolved, wrapped: undefined };
-    }
-    const validIds = new Set(preResolved.keys());
-    const urlKey = await getWorkspaceUrlKey(graphQLService);
-    const wrapped = wrapIssueReferencesAsLinks(description, validIds, urlKey);
-    return {
-        preResolved,
-        wrapped: wrapped === description ? undefined : wrapped,
-    };
-}
-async function pushDescriptionUpdate(issueUuid, description, graphQLService) {
-    const updateResult = await graphQLService.rawRequest(UPDATE_ISSUE_MUTATION, {
-        id: issueUuid,
-        input: { description },
-    });
-    const mutation = updateResult.issueUpdate;
-    if (!mutation?.success) {
-        throw new Error("Failed to rewrite description");
-    }
-}
-async function handleLinkReferencesSingle(issueId, options, graphQLService, linearService) {
-    const resolvedId = await linearService.resolveIssueId(issueId);
-    // GET_ISSUE_RELATIONS_QUERY also returns description, so this single call gives us everything
-    // we need for the description-only path. Comments are fetched separately on demand.
-    const issueResult = await graphQLService.rawRequest(GET_ISSUE_RELATIONS_QUERY, {
-        id: resolvedId,
-    });
-    if (!issueResult.issue) {
-        throw new Error(`Issue "${issueId}" not found`);
-    }
-    const issue = issueResult.issue;
-    const identifier = issue.identifier;
-    const description = issue.description ?? "";
-    const dryRun = Boolean(options.dryRun);
-    const includeComments = Boolean(options.includeComments);
-    const rewriteDescription = Boolean(options.rewriteDescription);
-    // If rewriting, validate refs once up front so we can both wrap the description and
-    // pass the resolved map down to autoLink — avoids a second resolve round trip.
-    const rewrite = rewriteDescription
-        ? await prepareDescriptionRewrite(description, identifier, linearService, graphQLService)
-        : { preResolved: undefined, wrapped: undefined };
-    const autoLinked = await linkReferencesForIssue({
-        issueUuid: resolvedId,
-        identifier,
-        description,
-        includeComments,
-        dryRun,
-        graphQLService,
-        linearService,
-        preResolved: rewrite.preResolved,
-    });
-    let descriptionRewritten = false;
-    if (rewriteDescription && rewrite.wrapped && !dryRun) {
-        await pushDescriptionUpdate(resolvedId, rewrite.wrapped, graphQLService);
-        descriptionRewritten = true;
-    }
-    outputSuccess({
-        id: resolvedId,
-        identifier,
-        title: issue.title,
-        autoLinked,
-        ...(rewriteDescription
-            ? {
-                descriptionRewritten,
-                ...(dryRun && rewrite.wrapped
-                    ? { descriptionPreview: rewrite.wrapped }
-                    : {}),
-            }
-            : {}),
-        meta: {
-            dryRun,
-            includeComments,
-            ...(rewriteDescription ? { rewriteDescription: true } : {}),
-        },
-    });
-}
-async function handleLinkReferencesBatch(teamInput, options, graphQLService, linearService) {
-    const teamId = resolveTeam(teamInput);
-    const limit = options.limit
-        ? Number.parseInt(options.limit, 10)
-        : 100;
-    if (!Number.isFinite(limit) || limit <= 0) {
-        throw new Error(`--limit must be a positive integer, got: ${options.limit}`);
-    }
-    const dryRun = Boolean(options.dryRun);
-    const includeComments = Boolean(options.includeComments);
-    const scan = await graphQLService.rawRequest(SCAN_ISSUES_QUERY, {
-        filter: { team: { id: { eq: teamId } } },
-        first: limit,
-    });
-    const issues = scan.issues?.nodes;
-    const nodes = issues ?? [];
-    const entries = [];
-    for (const node of nodes) {
-        const issueUuid = node.id;
-        const identifier = node.identifier;
-        const description = node.description ?? "";
-        const autoLinked = await linkReferencesForIssue({
-            issueUuid,
-            identifier,
-            description,
-            includeComments,
-            dryRun,
-            graphQLService,
-            linearService,
-        });
-        entries.push({ identifier, autoLinked });
-    }
-    // Summary counts across the batch
-    const totalLinked = entries.reduce((n, e) => n + e.autoLinked.linked.length, 0);
-    const totalSkipped = entries.reduce((n, e) => n + e.autoLinked.skipped.length, 0);
-    const totalFailed = entries.reduce((n, e) => n + e.autoLinked.failed.length, 0);
-    outputSuccess({
-        data: entries,
-        meta: {
-            count: entries.length,
-            team: teamInput,
-            dryRun,
-            includeComments,
-            totals: {
-                linked: totalLinked,
-                skipped: totalSkipped,
-                failed: totalFailed,
-            },
-        },
-    });
-}
-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.");
-        }
-        if (options.rewriteDescription) {
-            throw new Error("--rewrite-description is single-issue only. Use it case by case (one issueId per invocation) — bulk description rewrites bot-author the whole team's history.");
-        }
-        return handleLinkReferencesBatch(options.team, options, graphQLService, linearService);
-    }
-    if (!issueIdOrTeamFlag) {
-        throw new Error("issueId is required (or use --team <key> to scan a whole team)");
-    }
-    return handleLinkReferencesSingle(issueIdOrTeamFlag, options, graphQLService, linearService);
-}
-async function handleReadIssue(issueIds, _options, command) {
-    const rootOpts = getRootOpts(command);
-    const graphQLService = await createGraphQLService(rootOpts);
-    const linearService = await createLinearService(rootOpts);
-    const issuesService = new GraphQLIssuesService(graphQLService, linearService);
-    const fileService = await createFileService(rootOpts);
-    if (issueIds.length === 1) {
-        const issue = await issuesService.getIssueById(issueIds[0]);
-        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, fileService);
-        }));
-        outputSuccess(results);
-    }
-}
 async function handleUpdateIssue(issueId, options, command) {
     // Normalize aliases
     if (options.state && !options.status) {
@@ -940,9 +489,10 @@ async function handleUpdateIssue(issueId, options, command) {
     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 });
-        const issue = current.issue;
-        const existing = issue?.description ?? "";
+        const current = await graphQLService.rawRequest("query($id: String!) { issue(id: $id) { description } }", {
+            id: resolved,
+        });
+        const existing = current.issue?.description ?? "";
         options.description = `${existing}\n${options.appendDescription}`;
     }
     if (options.title || options.description) {
@@ -985,6 +535,34 @@ async function handleUpdateIssue(issueId, options, command) {
         : undefined;
     outputSuccess(autoLinked ? { ...result, autoLinked } : result);
 }
+async function handleArchiveIssue(issueId, _options, command) {
+    const rootOpts = getRootOpts(command);
+    const graphQLService = await createGraphQLService(rootOpts);
+    const linearService = await createLinearService(rootOpts);
+    const issuesService = new GraphQLIssuesService(graphQLService, linearService);
+    const result = await issuesService.archiveIssue(issueId);
+    outputSuccess({
+        success: true,
+        archived: true,
+        ...result,
+    });
+}
+async function handleDeleteIssue(issueId, options, command) {
+    const rootOpts = getRootOpts(command);
+    const graphQLService = await createGraphQLService(rootOpts);
+    const linearService = await createLinearService(rootOpts);
+    const issuesService = new GraphQLIssuesService(graphQLService, linearService);
+    const permanentlyDelete = Boolean(options.permanentlyDelete || options.hard);
+    const result = await issuesService.deleteIssue(issueId, {
+        permanentlyDelete,
+    });
+    outputSuccess({
+        success: true,
+        deleted: true,
+        permanentlyDeleted: permanentlyDelete,
+        ...result,
+    });
+}
 async function handleRetrolink(options, command) {
     // 1. Read current branch
     let currentBranch;
@@ -1082,7 +660,7 @@ export function setupIssuesCommands(program) {
         .option("--status <status>", "filter by status (comma-separated, e.g. Todo,Backlog)")
         .option("--priority <priority>", "filter by priority (comma-separated: urgent,high,medium,low,none or 0-4)")
         .option("--sort <field>", "sort results (priority, status, created, updated)")
-        .option("--format <format>", "output format (json, table, md, csv)", "json")
+        .option("--format <format>", "output format (json, summary, table, md, csv)", "json")
         .option("--fields <fields>", "columns for table/csv (comma-separated: identifier,title,status,priority,assignee,project,team,labels,updated)")
         .action(handleAsyncCommand(handleListIssues));
     issues
@@ -1097,7 +675,7 @@ export function setupIssuesCommands(program) {
         .option("--label <labels>", "alias for --labels")
         .option("--priority <priority>", "filter by priority (comma-separated: urgent,high,medium,low,none or 0-4)")
         .option("--sort <field>", "sort results (priority, status, created, updated)")
-        .option("--format <format>", "output format (json, table, md, csv)", "json")
+        .option("--format <format>", "output format (json, summary, table, md, csv)", "json")
         .option("--fields <fields>", "columns for table/csv output")
         .option("-l, --limit <number>", "limit results", "10")
         .action(handleAsyncCommand(handleSearchIssues));
@@ -1108,6 +686,7 @@ export function setupIssuesCommands(program) {
         .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("--from-template <id>", "instantiate the issue from a Linear server-side template (UUID from `el-linear templates list`). Sets templateId on the underlying issueCreate mutation; Linear copies the template's title, description, labels, priority, etc. as the new issue's defaults. Override any field with the matching --title / --description / --labels flag.")
         .option("-a, --assignee <assignee>", "assign to user (name, alias, or UUID)")
         .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)")
@@ -1138,8 +717,12 @@ export function setupIssuesCommands(program) {
             options.labels = options.label;
         }
         const title = options.title || titleArg;
-        if (!title) {
-            throw new Error("Title is required. Provide it as a positional argument or with --title.");
+        // --from-template lets Linear copy the template's title, so a
+        // local title is optional in that path. Without --from-template,
+        // the create mutation requires a title up front.
+        const fromTemplate = typeof options.fromTemplate === "string" && options.fromTemplate;
+        if (!title && !fromTemplate) {
+            throw new Error("Title is required. Provide it as a positional argument, with --title, or use --from-template to copy the template's title.");
         }
         return handleCreateIssue(title, options, command);
     }));
@@ -1150,7 +733,7 @@ export function setupIssuesCommands(program) {
         .alias("show")
         .description("Get issue details. Accepts multiple IDs for batch retrieval.")
         .addHelpText("after", "\nBoth UUID and identifiers like ABC-123 are supported.\nMultiple IDs: el-linear issue get DEV-123 DEV-456 DEV-789")
-        .action(handleAsyncCommand(handleReadIssue));
+        .action(handleAsyncCommand(readIssues));
     issues
         .command("update <issueId>")
         .alias("edit")
@@ -1181,6 +764,23 @@ export function setupIssuesCommands(program) {
         .option("--strict", "strict brand validation")
         .option("--no-auto-link", "skip auto-linking issue references found in the description")
         .action(handleAsyncCommand(handleUpdateIssue));
+    issues
+        .command("archive <issueId>")
+        .description("Archive an issue.")
+        .addHelpText("after", "\nBoth UUID and identifiers like ABC-123 are supported.")
+        .action(handleAsyncCommand(handleArchiveIssue));
+    issues
+        .command("delete <issueId>")
+        .description("Delete (trash) an issue.")
+        .addHelpText("after", "\nBoth UUID and identifiers like ABC-123 are supported. Use --permanently-delete only when you intend to skip Linear's grace period; Linear requires admin permissions.")
+        .option("--permanently-delete", "skip Linear's 30-day grace period (admin only)")
+        .option("--hard", "alias for --permanently-delete")
+        .action(handleAsyncCommand(handleDeleteIssue));
+    issues
+        .command("hard-delete <issueId>")
+        .description("Permanently delete an issue immediately (admin only).")
+        .addHelpText("after", "\nBoth UUID and identifiers like ABC-123 are supported.")
+        .action(handleAsyncCommand((issueId, options, command) => handleDeleteIssue(issueId, { ...options, permanentlyDelete: true }, command)));
     issues
         .command("history <issueId>")
         .description("Show issue state transition history (time in each status).")