@enrichlayer/el-linear 1.22.0 → 1.23.0

package/dist/commands/projects.js

@@ -1,6 +1,6 @@
 import { loadConfig } from "../config/config.js";
 import { resolveTeam } from "../config/resolver.js";
-import { ARCHIVE_PROJECT_MUTATION, CREATE_PROJECT_MUTATION, DELETE_PROJECT_MUTATION, GET_PROJECT_QUERY, GET_PROJECT_TEAM_ISSUES_QUERY, PROJECT_BY_ID_QUERY, SEARCH_PROJECTS_BY_NAME_QUERY, UPDATE_PROJECT_MUTATION, } from "../queries/projects.js";
+import { ARCHIVE_PROJECT_MUTATION, CREATE_PROJECT_MUTATION, DELETE_PROJECT_MUTATION, GET_PROJECT_QUERY, GET_PROJECT_TEAM_ISSUES_QUERY, PROJECT_BY_ID_QUERY, PROJECT_READ_QUERY, SEARCH_PROJECTS_BY_NAME_QUERY, UPDATE_PROJECT_MUTATION, } from "../queries/projects.js";
 import { cached, resolveCacheTTL } from "../utils/disk-cache.js";
 import { createGraphQLService } from "../utils/graphql-service.js";
 import { createLinearService } from "../utils/linear-service.js";
@@ -413,6 +413,30 @@ async function handleDeleteProject(projectNameOrId, _options, command) {
         lastSyncId: payload.lastSyncId,
     });
 }
+/**
+ * Read a single project (DEV-4610). Resolves the identifier through the same
+ * `resolveProjectId` path the `--project` flags use (UUID / slug / URL / name),
+ * fetches the full project, and emits it. `teams.nodes` is flattened to a plain
+ * array so the `--format summary` project renderer (and the JSON shape) match
+ * `projects list` — the formatter expects a flat team list, not a `{ nodes }`
+ * connection. Replaces the raw-`graphql` workaround for grabbing a project's
+ * url / content / lead.
+ */
+async function handleReadProject(projectNameOrId, _options, command) {
+    const rootOpts = getRootOpts(command);
+    const graphQLService = await createGraphQLService(rootOpts);
+    const linearService = await createLinearService(rootOpts);
+    const projectId = await linearService.resolveProjectId(projectNameOrId);
+    const result = await graphQLService.rawRequest(PROJECT_READ_QUERY, { id: projectId });
+    if (!result.project) {
+        throw new Error(`Project "${projectNameOrId}" not found`);
+    }
+    const { teams, ...rest } = result.project;
+    outputSuccess({
+        ...rest,
+        teams: teams.nodes.map((t) => ({ id: t.id, key: t.key, name: t.name })),
+    });
+}
 export function setupProjectsCommands(program) {
     const projects = program
         .command("projects")
@@ -435,6 +459,10 @@ export function setupProjectsCommands(program) {
         .command("delete <project>")
         .description("Delete (trash) a project (resolves names)")
         .action(handleAsyncCommand(handleDeleteProject));
+    projects
+        .command("read <project>")
+        .description("Read one project's full details (resolves name/slug/URL/ID). `--format summary` shows state, lead, teams, target, progress, url; JSON includes description/content.")
+        .action(handleAsyncCommand(handleReadProject));
     projects
         .command("list")
         .description("List projects")

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

@@ -34,6 +34,24 @@ interface ProjectWithIssuesNode extends ProjectBaseNode {
 export interface ProjectByIdResponse {
     project: ProjectBaseNode | null;
 }
+/** Full project read (`PROJECT_READ_QUERY`) — base fields + summary/JSON fields. */
+interface ProjectReadNode extends ProjectBaseNode {
+    state: string;
+    progress: number;
+    url: string;
+    startDate: string | null;
+    targetDate: string | null;
+    description: string | null;
+    content: string | null;
+    lead: {
+        id: string;
+        name: string;
+        displayName: string;
+    } | null;
+}
+export interface ProjectReadResponse {
+    project: ProjectReadNode | null;
+}
 export interface GetProjectResponse {
     projects: {
         nodes: ProjectBaseNode[];

package/dist/queries/projects.d.ts

@@ -1,5 +1,14 @@
 export declare const TEAM_LOOKUP_QUERY = "\n  query TeamLookup($key: String) {\n    teams(filter: { or: [{ key: { eq: $key } }, { name: { eq: $key } }] }, first: 1) {\n      nodes { id key name }\n    }\n  }\n";
 export declare const PROJECT_BY_ID_QUERY = "\n  query ProjectById($id: String!) {\n    project(id: $id) {\n      id\n      name\n      teams {\n        nodes { id key name }\n      }\n    }\n  }\n";
+/**
+ * Full single-project read for `el-linear projects read` (DEV-4610). Carries
+ * everything the `--format summary` project renderer shows (name, state, lead,
+ * teams, target, progress, url) plus the long-form `description`/`content` the
+ * JSON envelope exposes — so callers no longer fall back to a raw `graphql`
+ * query for a project URL or its content. The `progress` + `teams` fields also
+ * make the payload self-describing to the summary kind-inference.
+ */
+export declare const PROJECT_READ_QUERY = "\n  query ProjectRead($id: String!) {\n    project(id: $id) {\n      id\n      name\n      state\n      progress\n      url\n      startDate\n      targetDate\n      description\n      content\n      lead { id name displayName }\n      teams {\n        nodes { id key name }\n      }\n    }\n  }\n";
 export declare const GET_PROJECT_QUERY = "\n  query GetProject($name: String!) {\n    projects(filter: { name: { eqIgnoreCase: $name } }, first: 1) {\n      nodes {\n        id\n        name\n        teams {\n          nodes {\n            id\n            key\n            name\n          }\n        }\n      }\n    }\n  }\n";
 export declare const GET_PROJECT_TEAM_ISSUES_QUERY = "\n  query GetProjectTeamIssues($projectId: String!, $teamId: String!) {\n    project(id: $projectId) {\n      id\n      name\n      teams {\n        nodes {\n          id\n          key\n          name\n        }\n      }\n      issues(filter: { team: { id: { eq: $teamId } } }, first: 50) {\n        nodes {\n          id\n          identifier\n          title\n        }\n      }\n    }\n  }\n";
 export declare const SEARCH_PROJECTS_BY_NAME_QUERY = "\n  query SearchProjectsByName($name: String!) {\n    projects(filter: { name: { containsIgnoreCase: $name } }, first: 10) {\n      nodes {\n        id\n        name\n        state\n        teams {\n          nodes { id key name }\n        }\n      }\n    }\n  }\n";

package/dist/queries/projects.js

@@ -16,6 +16,33 @@ export const PROJECT_BY_ID_QUERY = `
     }
   }
 `;
+/**
+ * Full single-project read for `el-linear projects read` (DEV-4610). Carries
+ * everything the `--format summary` project renderer shows (name, state, lead,
+ * teams, target, progress, url) plus the long-form `description`/`content` the
+ * JSON envelope exposes — so callers no longer fall back to a raw `graphql`
+ * query for a project URL or its content. The `progress` + `teams` fields also
+ * make the payload self-describing to the summary kind-inference.
+ */
+export const PROJECT_READ_QUERY = `
+  query ProjectRead($id: String!) {
+    project(id: $id) {
+      id
+      name
+      state
+      progress
+      url
+      startDate
+      targetDate
+      description
+      content
+      lead { id name displayName }
+      teams {
+        nodes { id key name }
+      }
+    }
+  }
+`;
 export const GET_PROJECT_QUERY = `
   query GetProject($name: String!) {
     projects(filter: { name: { eqIgnoreCase: $name } }, first: 1) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enrichlayer/el-linear",
-  "version": "1.22.0",
+  "version": "1.23.0",
   "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",