@enrichlayer/el-linear 1.36.0 → 1.37.1

package/README.md

@@ -160,6 +160,18 @@ The active profile is selected by, in priority:
 The legacy fallback means **existing single-profile users see no
 behavior change** — profiles are purely opt-in.
 
+**Automation and concurrent sessions: prefer `--profile`/`$EL_LINEAR_PROFILE`
+over `profile use`.** `~/.config/el-linear/active-profile` is a single,
+machine-global marker file — `profile use <name>` mutates it for *every*
+el-linear invocation on the machine, including other terminals, scripts, and
+agent sessions that don't set an explicit override. Two processes wanting
+different workspaces at the same time will silently clobber each other. The
+flag and env var are per-invocation and never touch the marker file, so they
+compose safely with any number of concurrent sessions each pinned to their
+own workspace. Reserve `profile use` for a human's own interactive default
+switch; `profile use`/`profile add` print a loud warning when they change the
+global marker so the blast radius is visible instead of silent.
+
 ## Migrating from v1.0–1.3
 
 Versions 1.0–1.3 stored everything in the single-file layout
@@ -556,9 +568,9 @@ Currently wired through:
 
 | Resource | Defaults | Extras you can request |
 |----------|----------|------------------------|
-| `issues list` | `id, title, state, assignee` | `project, cycle, milestone, labels, url, priority, estimate, createdAt, updatedAt, team` |
+| `issues list` | `id, title, state, assignee` | `project, cycle, milestone, labels, url, priority, estimate, createdAt, updatedAt, completedAt, team` |
 | `projects list` | `name, state, progress, lead` | `teams, target, url, updatedAt` |
-| `issues read` (single) | `state, assignee, project, cycle, milestone, labels, url` | `priority, estimate, created, updated` |
+| `issues read` (single) | `state, assignee, project, cycle, milestone, labels, url` | `priority, estimate, created, updated, completed` |
 | `projects read` (single) | `state, lead, teams, target, progress, url` | (filter only — no extras) |
 
 `identifier`, `id`, `title` and `name` are headline-only on single-resource summaries and are filtered out of the labelled block (they remain on the title line above). `status` is accepted as a synonym for `state`, `owner` for `assignee`, `targetDate` for `target`.

package/claude-skills/linear-operations/SKILL.md

@@ -143,8 +143,8 @@ For tools that aren't `el-linear` (e.g. `gh`, `glab`, `kubectl`), prefer `jq` fo
 
 `--format summary` is implemented for:
 
-- **Single resources:** `issues read`, `comments read`, `projects read`, `cycles read`, `project-milestones read`, `documents read`, `templates read`, releases (`graphql` query results), `users read`
-- **Lists:** `issues list`, `issues search`, `projects list`, `comments list`, `cycles list`, `project-milestones list`, `labels list`, `teams list`, `users list`, `documents list`, `templates list`, `attachments list`, `releases list`, and the cross-resource `search` command
+- **Single resources:** `issues read`, `comments read`, `projects read`, `cycles read`, `project-milestones read`, `project-updates read`, `documents read`, `templates read`, releases (`graphql` query results), `users read`
+- **Lists:** `issues list`, `issues search`, `projects list`, `comments list`, `cycles list`, `project-milestones list`, `project-updates list`, `labels list`, `teams list`, `users list`, `documents list`, `templates list`, `attachments list`, `releases list`, and the cross-resource `search` command
 
 Commands without a dedicated formatter (e.g. `config show`, custom `graphql` queries) fall back to a generic key/value rendering of their JSON payload.
 
@@ -241,11 +241,10 @@ el-linear issues search "keywords from proposed title" --include-closed 2>&1
 
 The dup-check above guards against duplicating an *issue*. This guards against duplicating *reality*: before filing an issue to **add** a flag / guard / command / subcommand, confirm it doesn't **already exist**.
 
-- `<cli> <subcommand> --help` (the flag may be a global option absent from the subcommand's help — check `<cli> --help` too).
-- `el-catalog commands --search "<intent>"` / `el-catalog clis --search` (the snapshot likely already lists it).
-- For a hook/guard, grep the source — e.g. `cli/el-hook/src/checks`.
+- **`el-catalog commands --search "<intent>"`** / `el-catalog clis --search` — the **authoritative** check for a command/subcommand; it deterministically indexes every `<cli> <subcommand>`. Confirm with `<cli> <subcommand> --help` (and `<cli> --help` — a flag may be a global option absent from the subcommand's help).
+- For a hook/guard, grep the source (e.g. `cli/el-hook/src/checks`) — but **empty grep output is inconclusive, not proof of absence**. A mis-quoted glob or bad flag makes grep exit silently with zero matches (`grep --include=*.ts …` errors under zsh, returning nothing for a symbol that exists). Never read a raw grep's silence as "doesn't exist" for the command check — that is exactly what `el-catalog` is for.
 
-Skipping it cost two needless branch+MR cycles in one session: a "feature" issue to add a hook guard that already existed and was firing, and one to add `--jq`/`--fields` flags that already worked — both premises only caught at implementation.
+Skipping it cost real rework across sessions: a hook guard and `--jq`/`--fields` flags filed as "features" though both already existed and worked, and a near-duplicate `el-git` subcommand built after a raw grep silently misfired (the `el-catalog` search would have found the existing one) — every premise caught only at implementation.
 
 When `el-linear issues search` (or the cross-resource `search`) returns rows
 carrying issue identifiers, the JSON envelope embeds a `_warnings` line
@@ -532,6 +531,25 @@ el-linear projects add-team "Project Name" ENG 2>&1
 
 **Never use raw `projectUpdate` with `teamIds`** — it replaces the entire team list. Always use `projects add-team` / `remove-team`.
 
+### Project Updates (status posts) — mind the naming collision
+
+Linear has two unrelated things spelled almost the same:
+
+- `projectUpdate(id, input)` — the mutation that **edits a project** (the one warned about just above). Surfaced by the `projects` command.
+- `ProjectUpdate` — a **status post** in a project's Updates feed (progress + a health color). Surfaced by the dedicated `project-updates` command:
+
+```bash
+# Post a status update to a project (appears in the Updates feed)
+el-linear project-updates create --project "Auth Refactor" \
+  --body "Shipped the session-store migration; rollout at 60%." \
+  --health onTrack   # onTrack | atRisk | offTrack — omit to leave unset
+
+el-linear project-updates list --project "Auth Refactor"
+el-linear project-updates read <updateId>
+```
+
+`--body` / `--body-file` are mutually exclusive (one required); `--body-file` avoids shell-quoting for markdown/tables. `--health` is validated against the enum before the API call. `--diff-hidden` hides the auto-generated progress diff on the update. `-q/--quiet` prints `<health>  <url>`. A status update is not the same as a project **document** (`documents create --project`) — use a document for durable reference content, a project update for point-in-time progress.
+
 ### Discovery Before Creation
 
 Always check if a project exists before creating: `el-linear projects list`.

package/dist/commands/config.js

@@ -33,6 +33,8 @@ function sourceLabel(source) {
             return "teamConfigPath in personal config";
         case "marker":
             return "auto-discovered via ~/.config/el-tools-root";
+        case "disabled":
+            return 'disabled for this profile via teamConfigPath: "" in personal config';
         case null:
             return null;
     }

package/dist/commands/issues.js

@@ -18,7 +18,7 @@ import { createLinearService, } from "../utils/linear-service.js";
 import { logger } from "../utils/logger.js";
 import { handleAsyncCommand, outputSuccess, outputWarning, warnIfTruncated, } from "../utils/output.js";
 import { buildRelationCandidatePrompt } from "../utils/relation-candidate-prompt.js";
-import { getRootOpts } from "../utils/root-opts.js";
+import { effectiveOption, getRootOpts } from "../utils/root-opts.js";
 import { formatCsv, formatMarkdown, formatTable, } from "../utils/table-formatter.js";
 import { parsePositiveInt, parsePriorityFilter, splitList, validatePriority, } from "../utils/validators.js";
 import { currentGitBranch, extractIssueIdentifierFromBranch, getBranchLinearIssue, gitCheckoutBranch, setBranchLinearIssue, toBranchName, } from "./issues/branch.js";
@@ -121,7 +121,17 @@ function buildUpdateArgs(issueId, options, assigneeId, delegateId) {
         dueDate: options.dueDate || (options.clearDueDate ? null : undefined),
     };
 }
-function outputIssues(issues, format, fields, meta) {
+/**
+ * `--format` / `--fields` are registered on both the root program and the
+ * list/search subcommands, and commander 15 assigns the CLI token to the
+ * root registration — so the values must be resolved via
+ * {@link effectiveOption} rather than read off the subcommand's own
+ * options (DEV-5376: `--format table --fields …` silently fell through to
+ * the JSON envelope because `options.format` stayed at its default).
+ */
+function outputIssues(issues, command, meta) {
+    const format = effectiveOption(command, "format");
+    const fields = effectiveOption(command, "fields");
     const fieldList = fields ? splitList(fields) : undefined;
     if (format === "table") {
         logger.info(formatTable(issues, fieldList));
@@ -134,6 +144,13 @@ function outputIssues(issues, format, fields, meta) {
         logger.info(formatCsv(issues, fieldList));
     }
     else {
+        // JSON path: the `--fields` projection is applied by the global
+        // `fieldsFilter` inside `outputSuccess` (set in main.ts's preAction),
+        // NOT by `fieldList` here — `fieldList` only feeds the tabular
+        // formatters above. Keeping the projection in one place is what
+        // prevents double-application; a future refactor that routes
+        // table/csv/md through `outputSuccess` would need to drop the global
+        // filter or it would project twice.
         outputSuccess({ data: issues, meta: { count: issues.length, ...meta } });
     }
 }
@@ -228,14 +245,14 @@ async function handleListIssues(options, command) {
             outputWarning("excluded terminal states (Done / Canceled) by default; pass --include-closed to include them");
         }
         warnIfTruncated(result.length, limit);
-        outputIssues(result, options.format, options.fields, {
+        outputIssues(result, command, {
             team: options.team,
         });
     }
     else {
         const result = sortIssues(await issuesService.getIssues(limit), options.sort);
         warnIfTruncated(result.length, limit);
-        outputIssues(result, options.format, options.fields, {});
+        outputIssues(result, command, {});
     }
 }
 async function handleSearchIssues(query, options, command) {
@@ -282,7 +299,7 @@ async function handleSearchIssues(query, options, command) {
     if (relationPrompt) {
         outputWarning(relationPrompt);
     }
-    outputIssues(result, options.format, options.fields, { query });
+    outputIssues(result, command, { query });
 }
 /**
  * Run an `issuesService.createIssue` / `.updateIssue` call and, if it

package/dist/commands/profile.js

@@ -23,7 +23,7 @@
 import { promises as fsp } from "node:fs";
 import path from "node:path";
 import { confirm } from "@inquirer/prompts";
-import { ACTIVE_PROFILE_FILE, CONFIG_DIR, CONFIG_PATH, isSafeProfileName as isSafeName, PROFILES_DIR, profilePaths, resolveActiveProfile, setActiveProfileForSession, TOKEN_PATH, } from "../config/paths.js";
+import { ACTIVE_PROFILE_FILE, CONFIG_DIR, CONFIG_PATH, isSafeProfileName as isSafeName, PROFILES_DIR, profilePaths, readActiveProfileMarker, resolveActiveProfile, setActiveProfileForSession, TOKEN_PATH, } from "../config/paths.js";
 import { outputSuccess, outputWarning } from "../utils/output.js";
 import { runFullWizard } from "./init/index.js";
 import { registerMigrateLegacy } from "./profile/migrate-legacy.js";
@@ -120,8 +120,27 @@ export async function runProfileUse(name) {
     if (!isSafeName(trimmed)) {
         throw new Error(`Profile name "${trimmed}" must contain only [a-z0-9_-]. Pick a different name.`);
     }
+    // DEV-5610: `active-profile` is a single, machine-global marker — every
+    // el-linear invocation anywhere on this machine that doesn't set
+    // --profile/$EL_LINEAR_PROFILE resolves through it. Warn loudly on an
+    // actual switch so the blast radius is visible instead of silently
+    // redirecting some other concurrent session/tool to a different
+    // workspace. `--profile`/$EL_LINEAR_PROFILE remain the correct,
+    // non-mutating choice for automation and concurrent sessions.
+    //
+    // Read the raw marker (readActiveProfileMarker), not
+    // resolveActiveProfile().name — the latter resolves through the
+    // --profile/$EL_LINEAR_PROFILE precedence layers too, so a concurrent
+    // override in place while `profile use` runs would make it report the
+    // wrong "previous" value (a false-positive warning when the marker
+    // didn't actually change, or a false-negative when it did) — cycle-1
+    // review finding on PR #229.
+    const previous = readActiveProfileMarker();
     await fsp.mkdir(CONFIG_DIR, { recursive: true, mode: 0o700 });
     await fsp.writeFile(ACTIVE_PROFILE_FILE, `${trimmed}\n`, { mode: 0o644 });
+    if (previous !== trimmed) {
+        outputWarning(`Switched the GLOBAL active profile to "${trimmed}" (${ACTIVE_PROFILE_FILE}). This affects every other el-linear invocation on this machine that doesn't set --profile/$EL_LINEAR_PROFILE explicitly — concurrent sessions/tools relying on a different profile will silently start hitting the wrong workspace.`);
+    }
 }
 export async function runProfileAdd(name) {
     const trimmed = name.trim();

package/dist/commands/projects.js

@@ -6,7 +6,7 @@ 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 { effectiveOption, getRootOpts } from "../utils/root-opts.js";
 import { renderCsv, renderFixedWidthTable, renderMarkdownTable, } from "../utils/table-formatter.js";
 import { isUuid } from "../utils/uuid.js";
 import { parsePositiveInt, splitList } from "../utils/validators.js";
@@ -516,7 +516,11 @@ export function setupProjectsCommands(program) {
         // ahead of completed/canceled in every format, so the active
         // set always fits within `--limit`. DEV-4175.
         const sorted = sortActiveFirst(result);
-        const format = options.format;
+        // Resolved via effectiveOption because commander 15 hands the
+        // CLI token to the root program's same-named --format/--fields
+        // registration, leaving the subcommand's option at its default
+        // (DEV-5376).
+        const format = effectiveOption(command, "format") ?? "json";
         const isTabular = format === "table" ||
             format === "md" ||
             format === "markdown" ||
@@ -530,9 +534,8 @@ export function setupProjectsCommands(program) {
             warnProjectsTruncated(sorted.length, limit, format);
         }
         if (isTabular) {
-            const fieldList = options.fields
-                ? splitList(options.fields)
-                : undefined;
+            const fields = effectiveOption(command, "fields");
+            const fieldList = fields ? splitList(fields) : undefined;
             formatProjectsOutput(sorted, format, fieldList);
             if (format === "table") {
                 logger.info(`\n${sorted.length} projects`);

package/dist/config/config.d.ts

@@ -7,9 +7,11 @@ import type { TermRule } from "./term-enforcer.js";
  * - `env`: `EL_LINEAR_TEAM_CONFIG` is set in the environment (highest).
  * - `personal`: `teamConfigPath` field in personal `config.json`.
  * - `marker`: auto-discovered via `~/.config/el-tools-root` (DEV-4258).
+ * - `disabled`: explicitly opted out via `teamConfigPath: ""` in personal
+ *   config — the layer is off even when the marker would otherwise apply.
  * - `null`: no team layer active.
  */
-export type TeamConfigSource = "env" | "personal" | "marker" | null;
+export type TeamConfigSource = "env" | "personal" | "marker" | "disabled" | null;
 /**
  * Canonical shape of `~/.config/el-linear/config.json`. This is the single source
  * of truth for the on-disk config — the wizard reads/writes the same shape
@@ -142,6 +144,15 @@ export interface ElLinearConfig {
      * maps, and term rules across a team by checking the file into a shared
      * repository. Override at runtime with the `EL_LINEAR_TEAM_CONFIG` env var
      * (env var takes precedence over this field).
+     *
+     * Set to the empty string (`""`) to explicitly DISABLE the team layer for
+     * this profile, including `~/.config/el-tools-root` marker auto-discovery.
+     * This is the multi-account escape hatch: a marker-discovered team config
+     * carries workspace-specific member/label UUIDs, and applying it to a
+     * profile pointed at a different Linear workspace makes `--assignee <name>`
+     * resolve to a foreign UUID that the API rejects with an opaque
+     * "Entity not found in validateAccess" error. Profiles for secondary
+     * workspaces should set `"teamConfigPath": ""`.
      */
     teamConfigPath?: string;
 }

package/dist/config/config.js

@@ -112,6 +112,10 @@ export function loadConfig() {
         // The marker is the opt-in consent signal — only developers who ran
         // `link-project.sh` get the auto-discovery; OSS users hit the silent
         // no-op path. DEV-4258 / ALL-964.
+        //
+        // An EMPTY string is a deliberate per-profile opt-out (see the
+        // `teamConfigPath` JSDoc): it is defined, so marker discovery is
+        // skipped, and falsy, so no team layer is loaded below.
         personalRaw = readRawPersonalConfig(active);
         teamConfigPath = personalRaw.teamConfigPath;
         if (teamConfigPath === undefined) {
@@ -181,7 +185,14 @@ export function getActiveTeamConfigInfo() {
     }
     const personalRaw = readRawPersonalConfig(resolveActiveProfile());
     const personalPath = personalRaw.teamConfigPath;
-    if (personalPath !== undefined && personalPath !== "") {
+    if (personalPath === "") {
+        // Explicit per-profile opt-out — must be attributed as such, and must
+        // NOT fall through to the marker: loadConfig skips marker discovery
+        // for a defined-but-empty path, so reporting "marker" here would
+        // contradict what actually loads.
+        return { path: undefined, source: "disabled" };
+    }
+    if (personalPath !== undefined) {
         return { path: personalPath, source: "personal" };
     }
     const markerPath = discoverTeamConfigViaMarker();

package/dist/config/paths.d.ts

@@ -51,3 +51,12 @@ export declare function getSessionProfileOverride(): string | null;
 export declare function resolveActiveProfile(env?: NodeJS.ProcessEnv, fsImpl?: ProfileFsOps): ProfilePaths;
 /** Build profile-relative paths for a named profile. Pure. */
 export declare function profilePaths(name: string): ProfilePaths;
+/**
+ * Read the raw on-disk marker content, bypassing the `--profile`/
+ * `EL_LINEAR_PROFILE` precedence layers `resolveActiveProfile` applies.
+ * Exported (DEV-5610) so `profile use` can detect whether *the file itself*
+ * is about to change, independent of any per-invocation override that might
+ * otherwise make `resolveActiveProfile().name` report a different "previous"
+ * value than what's actually on disk.
+ */
+export declare function readActiveProfileMarker(fsImpl?: ProfileFsOps): string | null;

package/dist/config/paths.js

@@ -127,7 +127,15 @@ export function profilePaths(name) {
         tokenPath: path.join(dir, "token"),
     };
 }
-function readActiveProfileMarker(fsImpl) {
+/**
+ * Read the raw on-disk marker content, bypassing the `--profile`/
+ * `EL_LINEAR_PROFILE` precedence layers `resolveActiveProfile` applies.
+ * Exported (DEV-5610) so `profile use` can detect whether *the file itself*
+ * is about to change, independent of any per-invocation override that might
+ * otherwise make `resolveActiveProfile().name` report a different "previous"
+ * value than what's actually on disk.
+ */
+export function readActiveProfileMarker(fsImpl = DEFAULT_FS_OPS) {
     if (!fsImpl.existsSync(ACTIVE_PROFILE_FILE))
         return null;
     try {

package/dist/main.js

@@ -70,7 +70,9 @@ program
     "Warnings (e.g. --fields fields_unresolved) can't ride on a bare array, so " +
     "they are written to stderr prefixed `_warnings: `, keeping stdout a pure JSON array")
     .option("--jq <filter>", "apply a jq filter to the JSON output")
-    .option("--fields <fields>", "filter output to specific fields (comma-separated). Unresolved fields are " +
+    .option("--fields <fields>", "filter output to specific fields (comma-separated). Dot-paths resolve nested " +
+    "values; the column aliases status (state.name) and updated (updatedAt) " +
+    "resolve too. Unresolved fields are " +
     "emitted as null plus a `fields_unresolved:` warning — in the JSON " +
     "envelope's `_warnings`, or on stderr when output is a bare array (with --raw)")
     .option("--no-cache", "bypass the on-disk cache for `teams list` / `labels list` / `projects list`");

package/dist/queries/common.d.ts

@@ -1,2 +1,2 @@
-export declare const COMPLETE_ISSUE_FRAGMENT = "\n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n\n  \n  state {\n    id\n    name\n    type\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n";
-export declare const COMPLETE_ISSUE_WITH_COMMENTS_FRAGMENT = "\n  \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n\n  \n  state {\n    id\n    name\n    type\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n  \n  comments {\n    nodes {\n      id\n      body\n      createdAt\n      updatedAt\n      user {\n        id\n        name\n        url\n      }\n    }\n  }\n\n";
+export declare const COMPLETE_ISSUE_FRAGMENT = "\n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n  completedAt\n\n  \n  state {\n    id\n    name\n    type\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n";
+export declare const COMPLETE_ISSUE_WITH_COMMENTS_FRAGMENT = "\n  \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n  completedAt\n\n  \n  state {\n    id\n    name\n    type\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n  \n  comments {\n    nodes {\n      id\n      body\n      createdAt\n      updatedAt\n      user {\n        id\n        name\n        url\n      }\n    }\n  }\n\n";

package/dist/queries/common.js

@@ -11,6 +11,7 @@ const ISSUE_CORE_FIELDS = `
   url
   createdAt
   updatedAt
+  completedAt
 `;
 const ISSUE_STATE_FRAGMENT = `
   state {

package/dist/queries/issue-tree.d.ts

@@ -39,6 +39,8 @@ export interface IssueTreeNode {
         id: string;
         name: string;
     } | null;
+    /** ISO timestamp the node reached a terminal state; null while open. */
+    completedAt?: string | null;
     children?: {
         nodes: IssueTreeNode[];
     };

package/dist/queries/issue-tree.js

@@ -23,6 +23,10 @@ export const DEFAULT_TREE_DEPTH = 3;
 // Field set per tree node — kept minimal so the depth-N query stays small.
 // `state.type` is required client-side for `--no-include-closed` pruning;
 // `state.name` for the [Done]/[Canceled] suffix on terminal nodes.
+// `completedAt` is the moment a node reached a terminal state (null while
+// open) — consumers that reason about how long a subtree has been finished
+// (e.g. el-sop health's completed-children grace period, DEV-5454) need the
+// per-child timestamp, which no other field carries.
 // `priority` was intentionally dropped after cycle-1: the ASCII formatter
 // doesn't render it and including it inflates the query string by ~N nodes.
 const TREE_NODE_FIELDS = `
@@ -31,6 +35,7 @@ const TREE_NODE_FIELDS = `
 	title
 	state { id name type }
 	assignee { id name }
+	completedAt
 `;
 /**
  * Recursive children fragment generator. `depth=0` emits nothing (no

package/dist/queries/issues-types.d.ts

@@ -106,6 +106,7 @@ export interface IssueNode {
     url: string;
     createdAt: string;
     updatedAt: string;
+    completedAt: string | null;
     state: IdNameRef | null;
     assignee: AssigneeNode | null;
     delegate: AssigneeNode | null;
@@ -152,6 +153,17 @@ export interface GetIssuesResponse {
         nodes: IssueNode[];
     };
 }
+/**
+ * Response shape for `TEAM_SCOPED_FILTERED_ISSUES_QUERY` (DEV-5578).
+ * `team` is null when the resolved team UUID does not exist.
+ */
+export interface TeamScopedFilteredIssuesResponse {
+    team: {
+        issues: {
+            nodes: IssueNode[];
+        };
+    } | null;
+}
 /** Response shape for `SEARCH_ISSUES_QUERY` (full-text). */
 export interface SearchIssuesResponse {
     searchIssues: {

package/dist/queries/issues.d.ts

@@ -1,6 +1,25 @@
-export declare const GET_ISSUES_QUERY = "\n  query GetIssues($first: Int!, $orderBy: PaginationOrderBy) {\n    issues(\n      first: $first\n      orderBy: $orderBy\n      filter: {\n        state: { type: { neq: \"completed\" } }\n      }\n    ) {\n      nodes {\n        \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n\n  \n  state {\n    id\n    name\n    type\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n      }\n    }\n  }\n";
-export declare const SEARCH_ISSUES_QUERY = "\n  query SearchIssues($term: String!, $first: Int!) {\n    searchIssues(term: $term, first: $first, includeArchived: false) {\n      nodes {\n        \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n\n  \n  state {\n    id\n    name\n    type\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n      }\n    }\n  }\n";
-export declare const FILTERED_SEARCH_ISSUES_QUERY = "\n  query FilteredSearchIssues(\n    $first: Int!\n    $filter: IssueFilter\n    $orderBy: PaginationOrderBy\n  ) {\n    issues(\n      first: $first\n      filter: $filter\n      orderBy: $orderBy\n      includeArchived: false\n    ) {\n      nodes {\n        \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n\n  \n  state {\n    id\n    name\n    type\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n      }\n    }\n  }\n";
+export declare const GET_ISSUES_QUERY = "\n  query GetIssues($first: Int!, $orderBy: PaginationOrderBy) {\n    issues(\n      first: $first\n      orderBy: $orderBy\n      filter: {\n        state: { type: { neq: \"completed\" } }\n      }\n    ) {\n      nodes {\n        \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n  completedAt\n\n  \n  state {\n    id\n    name\n    type\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n      }\n    }\n  }\n";
+export declare const SEARCH_ISSUES_QUERY = "\n  query SearchIssues($term: String!, $first: Int!) {\n    searchIssues(term: $term, first: $first, includeArchived: false) {\n      nodes {\n        \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n  completedAt\n\n  \n  state {\n    id\n    name\n    type\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n      }\n    }\n  }\n";
+export declare const FILTERED_SEARCH_ISSUES_QUERY = "\n  query FilteredSearchIssues(\n    $first: Int!\n    $filter: IssueFilter\n    $orderBy: PaginationOrderBy\n  ) {\n    issues(\n      first: $first\n      filter: $filter\n      orderBy: $orderBy\n      includeArchived: false\n    ) {\n      nodes {\n        \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n  completedAt\n\n  \n  state {\n    id\n    name\n    type\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n      }\n    }\n  }\n";
+/**
+ * Team-scoped variant of `FILTERED_SEARCH_ISSUES_QUERY` (DEV-5578).
+ *
+ * When a `--team` filter is present, the team boundary is applied
+ * *structurally* — the `issues` connection is rooted at the `Team` node
+ * (`team(id: $teamId).issues(...)`) rather than passed as a top-level
+ * `issues(filter: { team: { id: { eq } } })` relation filter.
+ *
+ * The top-level relation-filter form is unreliable at scale: Linear's API
+ * silently leaks issues from *other* teams once `$first` grows past a small
+ * page (~20), so `issues list --team DEV --limit 100` returned issues from
+ * EMW/INF/FE too. This is the same class of bug DEV-5325 fixed for
+ * `projects list --team` (`ProjectFilter` had no working `teams` relation, so
+ * project scoping moved to `Team.projects`). Rooting at the team node keeps
+ * the team boundary server-side and exact. The remaining `$filter`
+ * (state / labels / assignee / priority / project) is applied on top of the
+ * already-team-scoped connection.
+ */
+export declare const TEAM_SCOPED_FILTERED_ISSUES_QUERY = "\n  query TeamScopedFilteredIssues(\n    $teamId: String!\n    $first: Int!\n    $filter: IssueFilter\n    $orderBy: PaginationOrderBy\n  ) {\n    team(id: $teamId) {\n      issues(\n        first: $first\n        filter: $filter\n        orderBy: $orderBy\n        includeArchived: false\n      ) {\n        nodes {\n          \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n  completedAt\n\n  \n  state {\n    id\n    name\n    type\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n        }\n      }\n    }\n  }\n";
 /**
  * Batch-resolves a search's team/project/assignee/delegate filter inputs.
  *
@@ -11,8 +30,8 @@ export declare const FILTERED_SEARCH_ISSUES_QUERY = "\n  query FilteredSearchIss
  * name-resolution arm is needed here.)
  */
 export declare const BATCH_RESOLVE_FOR_SEARCH_QUERY = "\n  query BatchResolveForSearch(\n    $teamKey: String\n    $teamName: String\n    $projectName: String\n    $hasProjectName: Boolean = false\n    $assigneeEmail: String\n    $delegateEmail: String\n  ) {\n    teams(\n      filter: {\n        or: [\n          { key: { eq: $teamKey } }\n          { name: { eqIgnoreCase: $teamName } }\n        ]\n      }\n      first: 1\n    ) {\n      nodes {\n        id\n        key\n        name\n      }\n    }\n\n    projects(\n      filter: { name: { eqIgnoreCase: $projectName } }\n      first: 1\n    ) @include(if: $hasProjectName) {\n      nodes {\n        id\n        name\n      }\n    }\n\n    users(filter: { email: { eq: $assigneeEmail } }, first: 1) {\n      nodes {\n        id\n        name\n        email\n      }\n    }\n\n    delegates: users(filter: { email: { eq: $delegateEmail } }, first: 1) {\n      nodes {\n        id\n        name\n        email\n      }\n    }\n  }\n";
-export declare const GET_ISSUE_BY_ID_QUERY = "\n  query GetIssue($id: String!) {\n    issue(id: $id) {\n      \n  \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n\n  \n  state {\n    id\n    name\n    type\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n  \n  comments {\n    nodes {\n      id\n      body\n      createdAt\n      updatedAt\n      user {\n        id\n        name\n        url\n      }\n    }\n  }\n\n\n    }\n  }\n";
-export declare const GET_ISSUE_BY_IDENTIFIER_QUERY = "\n  query GetIssueByIdentifier($teamKey: String!, $number: Float!) {\n    issues(\n      filter: {\n        team: { key: { eq: $teamKey } }\n        number: { eq: $number }\n      }\n      first: 1\n    ) {\n      nodes {\n        \n  \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n\n  \n  state {\n    id\n    name\n    type\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n  \n  comments {\n    nodes {\n      id\n      body\n      createdAt\n      updatedAt\n      user {\n        id\n        name\n        url\n      }\n    }\n  }\n\n\n      }\n    }\n  }\n";
+export declare const GET_ISSUE_BY_ID_QUERY = "\n  query GetIssue($id: String!) {\n    issue(id: $id) {\n      \n  \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n  completedAt\n\n  \n  state {\n    id\n    name\n    type\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n  \n  comments {\n    nodes {\n      id\n      body\n      createdAt\n      updatedAt\n      user {\n        id\n        name\n        url\n      }\n    }\n  }\n\n\n    }\n  }\n";
+export declare const GET_ISSUE_BY_IDENTIFIER_QUERY = "\n  query GetIssueByIdentifier($teamKey: String!, $number: Float!) {\n    issues(\n      filter: {\n        team: { key: { eq: $teamKey } }\n        number: { eq: $number }\n      }\n      first: 1\n    ) {\n      nodes {\n        \n  \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n  completedAt\n\n  \n  state {\n    id\n    name\n    type\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n  \n  comments {\n    nodes {\n      id\n      body\n      createdAt\n      updatedAt\n      user {\n        id\n        name\n        url\n      }\n    }\n  }\n\n\n      }\n    }\n  }\n";
 /**
  * Batch issue fetch. Used by `issues read <id...>` (DEV-4477) to collapse
  * N parallel single-issue queries into one round-trip. The `$filter` is
@@ -34,7 +53,7 @@ export declare const GET_ISSUE_BY_IDENTIFIER_QUERY = "\n  query GetIssueByIdenti
  * CLAUDE.md ("Performance-critical loops where the SDK's per-edge
  * resolver promises produce N+1 round-trips") explicitly authorizes this.
  */
-export declare const BATCH_GET_ISSUES_QUERY = "\n  query BatchGetIssues($filter: IssueFilter!, $first: Int!) {\n    issues(filter: $filter, first: $first) {\n      nodes {\n        \n  \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n\n  \n  state {\n    id\n    name\n    type\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n  \n  comments {\n    nodes {\n      id\n      body\n      createdAt\n      updatedAt\n      user {\n        id\n        name\n        url\n      }\n    }\n  }\n\n\n      }\n    }\n  }\n";
+export declare const BATCH_GET_ISSUES_QUERY = "\n  query BatchGetIssues($filter: IssueFilter!, $first: Int!) {\n    issues(filter: $filter, first: $first) {\n      nodes {\n        \n  \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n  completedAt\n\n  \n  state {\n    id\n    name\n    type\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n  \n  comments {\n    nodes {\n      id\n      body\n      createdAt\n      updatedAt\n      user {\n        id\n        name\n        url\n      }\n    }\n  }\n\n\n      }\n    }\n  }\n";
 /**
  * Batch-resolves an update's project/milestone/issue inputs.
  *
@@ -45,8 +64,8 @@ export declare const BATCH_GET_ISSUES_QUERY = "\n  query BatchGetIssues($filter:
  * `--project-milestone` name resolution; a name uses `projectsByName`.
  */
 export declare const BATCH_RESOLVE_FOR_UPDATE_QUERY = "\n  query BatchResolveForUpdate(\n    $projectName: String\n    $projectId: ID\n    $hasProjectName: Boolean = false\n    $hasProjectId: Boolean = false\n    $teamKey: String\n    $issueNumber: Float\n    $milestoneName: String\n    $hasMilestoneName: Boolean = false\n  ) {\n    projectsByName: projects(\n      filter: { name: { eqIgnoreCase: $projectName } }\n      first: 5\n    ) @include(if: $hasProjectName) {\n      nodes {\n        id\n        name\n        teams {\n          nodes { id key }\n        }\n        projectMilestones {\n          nodes {\n            id\n            name\n          }\n        }\n      }\n    }\n\n    projectsById: projects(\n      filter: { id: { eq: $projectId } }\n      first: 1\n    ) @include(if: $hasProjectId) {\n      nodes {\n        id\n        name\n        projectMilestones {\n          nodes {\n            id\n            name\n          }\n        }\n      }\n    }\n\n    milestones: projectMilestones(\n      filter: { name: { eq: $milestoneName } }\n      first: 1\n    ) @include(if: $hasMilestoneName) {\n      nodes {\n        id\n        name\n      }\n    }\n\n    issues(\n      filter: {\n        and: [\n          { team: { key: { eq: $teamKey } } }\n          { number: { eq: $issueNumber } }\n        ]\n      }\n      first: 1\n    ) {\n      nodes {\n        id\n        identifier\n        team {\n          id\n          key\n        }\n        labels {\n          nodes {\n            id\n            name\n          }\n        }\n        project {\n          id\n          projectMilestones {\n            nodes {\n              id\n              name\n            }\n          }\n        }\n      }\n    }\n  }\n";
-export declare const CREATE_ISSUE_MUTATION = "\n  mutation CreateIssue($input: IssueCreateInput!) {\n    issueCreate(input: $input) {\n      success\n      issue {\n        \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n\n  \n  state {\n    id\n    name\n    type\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n      }\n    }\n  }\n";
-export declare const UPDATE_ISSUE_MUTATION = "\n  mutation UpdateIssue($id: String!, $input: IssueUpdateInput!) {\n    issueUpdate(id: $id, input: $input) {\n      success\n      issue {\n        \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n\n  \n  state {\n    id\n    name\n    type\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n      }\n    }\n  }\n";
+export declare const CREATE_ISSUE_MUTATION = "\n  mutation CreateIssue($input: IssueCreateInput!) {\n    issueCreate(input: $input) {\n      success\n      issue {\n        \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n  completedAt\n\n  \n  state {\n    id\n    name\n    type\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n      }\n    }\n  }\n";
+export declare const UPDATE_ISSUE_MUTATION = "\n  mutation UpdateIssue($id: String!, $input: IssueUpdateInput!) {\n    issueUpdate(id: $id, input: $input) {\n      success\n      issue {\n        \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n  completedAt\n\n  \n  state {\n    id\n    name\n    type\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n      }\n    }\n  }\n";
 export declare const ARCHIVE_ISSUE_MUTATION = "\n  mutation ArchiveIssue($id: String!) {\n    issueArchive(id: $id) {\n      success\n      lastSyncId\n      entity {\n        id\n      }\n    }\n  }\n";
 export declare const DELETE_ISSUE_MUTATION = "\n  mutation DeleteIssue($id: String!, $permanentlyDelete: Boolean) {\n    issueDelete(id: $id, permanentlyDelete: $permanentlyDelete) {\n      success\n      lastSyncId\n      entity {\n        id\n      }\n    }\n  }\n";
 /**

package/dist/queries/issues.js

@@ -41,6 +41,45 @@ export const FILTERED_SEARCH_ISSUES_QUERY = `
     }
   }
 `;
+/**
+ * Team-scoped variant of `FILTERED_SEARCH_ISSUES_QUERY` (DEV-5578).
+ *
+ * When a `--team` filter is present, the team boundary is applied
+ * *structurally* — the `issues` connection is rooted at the `Team` node
+ * (`team(id: $teamId).issues(...)`) rather than passed as a top-level
+ * `issues(filter: { team: { id: { eq } } })` relation filter.
+ *
+ * The top-level relation-filter form is unreliable at scale: Linear's API
+ * silently leaks issues from *other* teams once `$first` grows past a small
+ * page (~20), so `issues list --team DEV --limit 100` returned issues from
+ * EMW/INF/FE too. This is the same class of bug DEV-5325 fixed for
+ * `projects list --team` (`ProjectFilter` had no working `teams` relation, so
+ * project scoping moved to `Team.projects`). Rooting at the team node keeps
+ * the team boundary server-side and exact. The remaining `$filter`
+ * (state / labels / assignee / priority / project) is applied on top of the
+ * already-team-scoped connection.
+ */
+export const TEAM_SCOPED_FILTERED_ISSUES_QUERY = `
+  query TeamScopedFilteredIssues(
+    $teamId: String!
+    $first: Int!
+    $filter: IssueFilter
+    $orderBy: PaginationOrderBy
+  ) {
+    team(id: $teamId) {
+      issues(
+        first: $first
+        filter: $filter
+        orderBy: $orderBy
+        includeArchived: false
+      ) {
+        nodes {
+          ${COMPLETE_ISSUE_FRAGMENT}
+        }
+      }
+    }
+  }
+`;
 /**
  * Batch-resolves a search's team/project/assignee/delegate filter inputs.
  *

package/dist/queries/project-milestones.d.ts

@@ -1,5 +1,5 @@
 export declare const LIST_PROJECT_MILESTONES_QUERY = "\n  query ListProjectMilestones($projectId: String!, $first: Int!) {\n    project(id: $projectId) {\n      id\n      name\n      projectMilestones(first: $first) {\n        nodes {\n          id\n          name\n          description\n          targetDate\n          sortOrder\n          createdAt\n          updatedAt\n        }\n      }\n    }\n  }\n";
-export declare const GET_PROJECT_MILESTONE_BY_ID_QUERY = "\n  query GetProjectMilestone($id: String!, $issuesFirst: Int) {\n    projectMilestone(id: $id) {\n      id\n      name\n      description\n      targetDate\n      sortOrder\n      createdAt\n      updatedAt\n      project {\n        id\n        name\n      }\n      issues(first: $issuesFirst) {\n        nodes {\n          \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n\n  \n  state {\n    id\n    name\n    type\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n        }\n      }\n    }\n  }\n";
+export declare const GET_PROJECT_MILESTONE_BY_ID_QUERY = "\n  query GetProjectMilestone($id: String!, $issuesFirst: Int) {\n    projectMilestone(id: $id) {\n      id\n      name\n      description\n      targetDate\n      sortOrder\n      createdAt\n      updatedAt\n      project {\n        id\n        name\n      }\n      issues(first: $issuesFirst) {\n        nodes {\n          \n  \n  id\n  identifier\n  title\n  description\n  summary { content generationStatus }\n  branchName\n  priority\n  estimate\n  dueDate\n  url\n  createdAt\n  updatedAt\n  completedAt\n\n  \n  state {\n    id\n    name\n    type\n  }\n\n  \n  assignee {\n    id\n    name\n    url\n  }\n\n  \n  delegate {\n    id\n    name\n    url\n  }\n\n  \n  team {\n    id\n    key\n    name\n  }\n\n  \n  project {\n    id\n    name\n  }\n\n  \n  labels {\n    nodes {\n      id\n      name\n    }\n  }\n\n  \n  cycle {\n    id\n    name\n    number\n  }\n\n  \n  projectMilestone {\n    id\n    name\n    targetDate\n  }\n\n  \n  parent {\n    id\n    identifier\n    title\n  }\n\n  \n  children {\n    nodes {\n      id\n      identifier\n      title\n    }\n  }\n\n\n        }\n      }\n    }\n  }\n";
 export declare const FIND_PROJECT_MILESTONE_BY_NAME_SCOPED = "\n  query FindProjectMilestoneScoped($name: String!, $projectId: String!) {\n    project(id: $projectId) {\n      projectMilestones(filter: { name: { eq: $name } }, first: 10) {\n        nodes {\n          id\n          name\n          targetDate\n          sortOrder\n          project {\n            id\n            name\n          }\n        }\n      }\n    }\n  }\n";
 export declare const FIND_PROJECT_MILESTONE_BY_NAME_GLOBAL = "\n  query FindProjectMilestoneGlobal($name: String!) {\n    projectMilestones(filter: { name: { eq: $name } }, first: 10) {\n      nodes {\n        id\n        name\n        targetDate\n        sortOrder\n        project {\n          id\n          name\n        }\n      }\n    }\n  }\n";
 export declare const CREATE_PROJECT_MILESTONE_MUTATION = "\n  mutation CreateProjectMilestone($projectId: String!, $name: String!, $description: String, $targetDate: TimelessDate) {\n    projectMilestoneCreate(input: {\n      projectId: $projectId\n      name: $name\n      description: $description\n      targetDate: $targetDate\n    }) {\n      success\n      projectMilestone {\n        id\n        name\n        description\n        targetDate\n        sortOrder\n        createdAt\n        updatedAt\n        project {\n          id\n          name\n        }\n      }\n    }\n  }\n";

package/dist/types/linear.d.ts

@@ -114,6 +114,7 @@ export interface LinearIssue {
     assignee?: UserRef;
     branchName?: string;
     comments?: LinearComment[];
+    completedAt?: string;
     createdAt: string;
     cycle?: CycleRef;
     delegate?: UserRef;

package/dist/utils/formatters/summary.js

@@ -301,6 +301,7 @@ const ISSUE_SUMMARY_SYNONYMS = {
     owner: "assignee",
     createdat: "created",
     updatedat: "updated",
+    completedat: "completed",
     prioritylabel: "priority",
     projectmilestone: "milestone",
 };
@@ -316,6 +317,7 @@ function buildIssueHeaderFields(issue) {
         { label: "Estimate", value: s(issue.estimate) },
         { label: "Created", value: s(issue.createdAt) },
         { label: "Updated", value: s(issue.updatedAt) },
+        { label: "Completed", value: s(issue.completedAt) },
         { label: "URL", value: s(issue.url) },
     ];
 }
@@ -424,6 +426,11 @@ const ISSUE_LIST_EXTRAS = {
         minWidth: 7,
         extract: (i) => s(i.updatedAt).slice(0, 10),
     },
+    completedat: {
+        header: "COMPLETED",
+        minWidth: 9,
+        extract: (i) => s(i.completedAt).slice(0, 10),
+    },
     team: {
         header: "TEAM",
         minWidth: 4,

package/dist/utils/graphql-issues-service.js

@@ -1,9 +1,9 @@
 import { isRegistryConfigured, resolveViaRegistry, } from "../config/registry-resolve.js";
 import { resolveUserDisplayName } from "../config/resolver.js";
-import { ARCHIVE_ISSUE_MUTATION, BATCH_GET_ISSUES_QUERY, BATCH_RESOLVE_FOR_CREATE_QUERY, BATCH_RESOLVE_FOR_SEARCH_QUERY, BATCH_RESOLVE_FOR_UPDATE_QUERY, buildResolveLabelsByNameQuery, CREATE_ISSUE_MUTATION, DELETE_ISSUE_MUTATION, FILTERED_SEARCH_ISSUES_QUERY, GET_ISSUE_BY_ID_QUERY, GET_ISSUE_BY_IDENTIFIER_QUERY, GET_ISSUE_CLAIM_CONTEXT_QUERY, GET_ISSUE_START_CONTEXT_QUERY, GET_ISSUE_TEAM_QUERY, GET_ISSUES_QUERY, SEARCH_ISSUES_QUERY, TEAM_STARTED_STATUSES_QUERY, UPDATE_ISSUE_MUTATION, } from "../queries/issues.js";
+import { ARCHIVE_ISSUE_MUTATION, BATCH_GET_ISSUES_QUERY, BATCH_RESOLVE_FOR_CREATE_QUERY, BATCH_RESOLVE_FOR_SEARCH_QUERY, BATCH_RESOLVE_FOR_UPDATE_QUERY, buildResolveLabelsByNameQuery, CREATE_ISSUE_MUTATION, DELETE_ISSUE_MUTATION, FILTERED_SEARCH_ISSUES_QUERY, GET_ISSUE_BY_ID_QUERY, GET_ISSUE_BY_IDENTIFIER_QUERY, GET_ISSUE_CLAIM_CONTEXT_QUERY, GET_ISSUE_START_CONTEXT_QUERY, GET_ISSUE_TEAM_QUERY, GET_ISSUES_QUERY, SEARCH_ISSUES_QUERY, TEAM_SCOPED_FILTERED_ISSUES_QUERY, TEAM_STARTED_STATUSES_QUERY, UPDATE_ISSUE_MUTATION, } from "../queries/issues.js";
 import { CREATE_LABEL_MUTATION } from "../queries/labels.js";
 import { TERMINAL_STATE_TYPES } from "../types/linear.js";
-import { toISOStringOrNow } from "./date-format.js";
+import { toISOStringOrNow, toISOStringOrUndefined } from "./date-format.js";
 import { extractEmbeds } from "./embed-parser.js";
 import { multipleMatchesError, notFoundError } from "./error-messages.js";
 import { parseIssueIdentifier, tryParseIssueIdentifier, } from "./identifier-parser.js";
@@ -556,8 +556,14 @@ export class GraphQLIssuesService {
                 priority: args.priority,
             });
         }
+        // DEV-5578: the team boundary is NOT put in the IssueFilter. Linear's
+        // top-level `issues(filter: { team: { id: { eq } } })` relation filter
+        // leaks other teams' issues once `first` grows past a small page (~20),
+        // so `--team` was silently contaminated on paginated (`--limit > ~20`)
+        // results. When a team is present we scope structurally through the
+        // `Team.issues` connection below (same class of fix as DEV-5325's
+        // `Team.projects`); the rest of the filter rides on top of it.
         const filter = this.buildSearchFilter({
-            teamId: finalTeamId,
             assigneeId: finalAssigneeId,
             delegateId: finalDelegateId,
             project: projectFilter,
@@ -566,10 +572,25 @@ export class GraphQLIssuesService {
             labelNames: args.labelNames,
             priority: args.priority,
         });
+        const filterArg = Object.keys(filter).length > 0 ? filter : undefined;
+        const orderBy = args.orderBy ?? "updatedAt";
+        if (finalTeamId) {
+            const teamScoped = await this.graphQLService.rawRequest(TEAM_SCOPED_FILTERED_ISSUES_QUERY, {
+                teamId: finalTeamId,
+                first: limit,
+                filter: filterArg,
+                orderBy,
+            });
+            const nodes = teamScoped.team?.issues?.nodes;
+            if (!nodes?.length) {
+                return [];
+            }
+            return nodes.map((issue) => this.transformIssueData(issue));
+        }
         const searchResult = await this.graphQLService.rawRequest(FILTERED_SEARCH_ISSUES_QUERY, {
             first: limit,
-            filter: Object.keys(filter).length > 0 ? filter : undefined,
-            orderBy: args.orderBy ?? "updatedAt",
+            filter: filterArg,
+            orderBy,
         });
         const filteredIssues = searchResult.issues;
         if (!filteredIssues?.nodes) {
@@ -999,11 +1020,12 @@ export class GraphQLIssuesService {
         }
         return filtered;
     }
+    // DEV-5578: `teamId` is intentionally NOT a member — the team boundary is
+    // applied structurally via `TEAM_SCOPED_FILTERED_ISSUES_QUERY`, never as a
+    // top-level `team` relation filter (which Linear leaks past ~20 rows). Do
+    // not reintroduce a `filter.team = …` branch here.
     buildSearchFilter(filters) {
         const filter = {};
-        if (filters.teamId) {
-            filter.team = { id: { eq: filters.teamId } };
-        }
         if (filters.assigneeId) {
             filter.assignee = { id: { eq: filters.assigneeId } };
         }
@@ -1270,6 +1292,9 @@ export class GraphQLIssuesService {
                 : [],
             createdAt: toISOStringOrNow(issue.createdAt),
             updatedAt: toISOStringOrNow(issue.updatedAt),
+            // Nullable, not `-OrNow`: an open issue has no completion, so it must
+            // stay `undefined` rather than be fabricated as the current time.
+            completedAt: toISOStringOrUndefined(issue.completedAt),
         };
     }
     transformIssueCoreFields(issue) {

package/dist/utils/output.js

@@ -1,4 +1,5 @@
 import { execFileSync } from "node:child_process";
+import { resolveActiveProfile } from "../config/paths.js";
 import { dispatch as dispatchSummary, drainSummaryFieldWarnings, formatLine, inferKindFromPayload, } from "./formatters/summary.js";
 import { logger } from "./logger.js";
 import { sanitizeForLog } from "./sanitize-for-log.js";
@@ -57,6 +58,19 @@ function getNestedPath(obj, path) {
     }
     return cur;
 }
+/**
+ * Aliases for the table/csv column names that don't exist as literal keys
+ * on the JSON payload (DEV-5376). Tried only after the literal key and the
+ * dot-path both miss, and only kept when the alias target actually
+ * resolves — so a resource that genuinely lacks `state`/`updatedAt` still
+ * gets the explicit-null + `fields_unresolved` treatment. The requested
+ * name stays the output key (`{"status": "Todo"}`), matching the
+ * "consumers read exactly what they asked for" contract.
+ */
+const FIELD_ALIASES = {
+    status: "state.name",
+    updated: "updatedAt",
+};
 /**
  * Project `obj` down to the requested fields.
  *
@@ -64,6 +78,8 @@ function getNestedPath(obj, path) {
  * - Dot-separated paths (DEV-5323) resolve nested values; the requested path
  *   string becomes a flat output key (`{"pipeline.status": "success"}`), so
  *   consumers read exactly what they asked for.
+ * - Documented column aliases resolve when the literal key is absent
+ *   (`status` → `state.name`, `updated` → `updatedAt`; DEV-5376).
  * - A field that resolves nowhere is emitted as an explicit `null` AND
  *   reported via `unresolved` — never silently omitted. Silent omission made
  *   a typo'd field indistinguishable from an empty value (DEV-5323).
@@ -114,6 +130,12 @@ function filterFields(obj, fields, unresolved) {
                 result[field] = nested;
                 continue;
             }
+            const alias = FIELD_ALIASES[field];
+            const aliased = alias !== undefined ? getNestedPath(source, alias) : undefined;
+            if (aliased !== undefined) {
+                result[field] = aliased;
+                continue;
+            }
             result[field] = null;
             unresolved?.add(field);
         }
@@ -354,7 +376,25 @@ function outputError(error) {
     // `lin_oauth_…` / `Bearer <payload>` in error text can't leak a token
     // into stdout, shell history, or CI logs. The wizard already sanitizes
     // its own log paths; this is the central error path on every command.
-    const payload = JSON.stringify({ error: sanitizeForLog(error.message) }, null, 2);
+    //
+    // `activeProfile` is included so a "not found" error is distinguishable
+    // from "wrong workspace" without manually inspecting
+    // ~/.config/el-linear/active-profile (DEV-5610) — the active profile can
+    // change between commands (an explicit `profile use`, a different
+    // $EL_LINEAR_PROFILE, or another process on the machine switching the
+    // shared marker file), and a bare "X not found" reads as data loss or an
+    // API outage when the real cause is often just the wrong workspace.
+    // Guarded: resolveActiveProfile() throws on an invalid $EL_LINEAR_PROFILE
+    // value (a real, separate user error) — outputError is the last-resort
+    // error path, so this addition must not itself throw uncaught.
+    let activeProfile = "<unknown>";
+    try {
+        activeProfile = resolveActiveProfile().name ?? "<legacy default>";
+    }
+    catch {
+        // leave activeProfile as "<unknown>"
+    }
+    const payload = JSON.stringify({ error: sanitizeForLog(error.message), activeProfile }, null, 2);
     // Write to stdout (same channel as success) so machine callers always
     // receive exactly one parseable JSON object regardless of stream capture.
     logger.info(payload);

package/dist/utils/root-opts.d.ts

@@ -9,3 +9,16 @@ import type { Command, OptionValues } from "commander";
  * assertions live here so call sites can stay clean and typed.
  */
 export declare function getRootOpts(command: Command): OptionValues;
+/**
+ * Resolve an option that is registered on BOTH the root program and a
+ * subcommand (`--format` / `--fields` on `issues list|search`,
+ * `projects list`).
+ *
+ * Commander 15 hands a same-named option to the OUTERMOST registration
+ * even when it appears after the subcommand: `issues list --format table`
+ * sets the program's global `--format` and leaves the subcommand's local
+ * option at its default, so handlers reading `options.format` silently
+ * saw `"json"` (DEV-5376). Precedence here: local CLI-set value, then the
+ * nearest ancestor's CLI-set value, then the local default.
+ */
+export declare function effectiveOption(command: Command, key: string): string | undefined;

package/dist/utils/root-opts.js

@@ -11,3 +11,26 @@ export function getRootOpts(command) {
     // biome-ignore lint/style/noNonNullAssertion: command.parent / .parent.parent are guaranteed by commander inside subcommand actions; see docstring
     return (command.parent?.parent ?? command.parent).opts();
 }
+/**
+ * Resolve an option that is registered on BOTH the root program and a
+ * subcommand (`--format` / `--fields` on `issues list|search`,
+ * `projects list`).
+ *
+ * Commander 15 hands a same-named option to the OUTERMOST registration
+ * even when it appears after the subcommand: `issues list --format table`
+ * sets the program's global `--format` and leaves the subcommand's local
+ * option at its default, so handlers reading `options.format` silently
+ * saw `"json"` (DEV-5376). Precedence here: local CLI-set value, then the
+ * nearest ancestor's CLI-set value, then the local default.
+ */
+export function effectiveOption(command, key) {
+    if (command.getOptionValueSource(key) === "cli") {
+        return command.getOptionValue(key);
+    }
+    for (let c = command.parent; c; c = c.parent) {
+        if (c.getOptionValueSource(key) === "cli") {
+            return c.getOptionValue(key);
+        }
+    }
+    return command.getOptionValue(key);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enrichlayer/el-linear",
-  "version": "1.36.0",
+  "version": "1.37.1",
   "description": "A pragmatic CLI for Linear.app — deterministic team/label/member resolution, structured issue validation, configurable term enforcement, and a GraphQL escape hatch.",
   "main": "dist/main.js",
   "types": "dist/main.d.ts",