@cesar-richard/git-connector-sdk 2.6.0 → 2.7.1

package/README.md

@@ -354,7 +354,26 @@ for (const wi of data.items) {
 
 ## API surface
 
-The `/v1/*` API exposes these resources: work items, iterations, work-item details, the unified events stream, raw activities, deliverables, and per-project delivery rules.
+The `/v1/*` API exposes these resources: tracked projects, work items, iterations, work-item details, the unified events stream (polled or server-sent), raw activities, deliverables, and per-project delivery rules.
+
+### `GET /v1/projects` — list tracked projects
+
+Every project the operator tracks, sorted by `(source, projectKey)`.
+
+```ts
+const { data } = await client.GET("/v1/projects");
+// data: { projects: { source, projectKey, name, webUrl, lastSyncedAt }[] }
+```
+
+This is the **only correct way** to enumerate projects. Deriving the list by
+paginating `/v1/work-items` or `/v1/activities` and deduplicating
+`(source, projectKey)` is wrong by construction: a tracked project with no
+activity in the window read is invisible that way, so it can never be configured
+downstream. `lastSyncedAt` is `null` when the project has never completed a sync
+— that means *never ingested*, not *quiet*.
+
+Pair `source` + `projectKey` to call
+`GET /v1/projects/{source}/{projectKey}/labels`.
 
 ### `GET /v1/work-items` — list aggregated work items
 
@@ -373,7 +392,24 @@ const { data } = await client.GET("/v1/work-items", {
 // data: { items: WorkItem[]; total: number; limit: number }
 ```
 
-Each `WorkItem` includes its `linkedActivities` (PRs/MRs with full enrichment: reviews summary, unresolved threads, volume, status history, reviewRequestedAt, mergedAt).
+Each `WorkItem` includes its `linkedActivities` (PRs/MRs with full enrichment: reviews summary, unresolved threads, volume, status history, reviewRequestedAt, mergedAt, and the current CI status).
+
+#### `linkedActivities[].ci` — current CI status
+
+The latest known CI **pipeline** for that PR/MR (not per-job `ci-run`), always
+computed on both the list and the detail route:
+
+```ts
+ci?: {
+  status: "success" | "failed" | "running" | "canceled" | "unknown";
+  url: string | null;
+  finishedAt: string | null;
+} | null
+```
+
+`null` means *no pipeline is known* — never read it as "green". Together with
+`hasConflicts`, `reviews` and `unresolvedThreads`, `status: "failed"` is the
+fourth signal for rendering a work item as blocked.
 
 ### `GET /v1/work-items/{source}/{projectKey}/{number}` — detail
 
@@ -426,6 +462,44 @@ Event types in the stream:
 | `review` | GH PR review / GL MR approval | resolves to PR/MR | `state`, `reviewer` |
 | `state-transition` | Derived from activity state diff | resolves to PR/MR/issue | `from`, `to` |
 | `ci-run` | GH Actions job / GL pipeline job | resolves to PR/MR via head SHA | `runId`, `jobName`, `conclusion`, `durationSec`, `sha`, `branch` |
+| `ci-pipeline` | GH Actions run / GL pipeline | resolves to PR/MR via head SHA | `runId`, `conclusion`, `status`, `durationSec`, `sha`, `branch` |
+
+#### Fetching one activity's events — `?parentActivityId`
+
+Pass `parentActivityId` (CSV for several) to get every event attached to a PR/MR
+— commits, pipelines, comments — without guessing a date window. **When this
+filter is given, `from`/`to` become optional**, and omitting them is usually what
+you want: a window silently drops anything older than it, which for a CI pipeline
+means reading "no pipeline" where there is a red one.
+
+```ts
+const { data } = await client.GET("/v1/events", {
+  params: {
+    query: {
+      parentActivityId: "github:acme/web:pr:42,github:acme/web:pr:43",
+      type: "ci-pipeline",
+    },
+  },
+});
+```
+
+### `GET /v1/events/stream` — server-sent events
+
+SSE on the consumer scope, authenticated with the same `gck_` Bearer token. It
+emits `events.ingested` frames only — operator-scope traffic (sync progress,
+config changes, provider-auth staleness) never crosses this boundary. A `:ping`
+comment every 30 s keeps proxies from dropping the socket.
+
+```ts
+const res = await fetch(`${baseUrl}/v1/events/stream`, {
+  headers: { Authorization: `Bearer ${token}` },
+});
+// text/event-stream: `event: events.ingested` frames whose data is
+// { type: "events.ingested", payload: { events: GitEvent[] } }
+```
+
+Polling `GET /v1/events?since=<ISO>` stays the simpler option and is cheap enough
+for most consumers; reach for the stream when you want push latency.
 
 ### `GET /v1/deliverables` — classified deliverables of a window
 

package/dist/schema.d.ts

@@ -68,6 +68,22 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/events/stream": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["getV1EventsStream"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/activities": {
         parameters: {
             query?: never;
@@ -116,6 +132,22 @@ export interface paths {
         patch: operations["patchV1ProjectsBySourceByProjectKeyDelivery-rules"];
         trace?: never;
     };
+    "/v1/projects": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["getV1Projects"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/projects/{source}/{projectKey}/labels": {
         parameters: {
             query?: never;
@@ -295,6 +327,11 @@ export interface components {
         } & {
             [key: string]: unknown;
         };
+        CiSummary: {
+            status: "success" | "failed" | "running" | "canceled" | "unknown";
+            url: string | null;
+            finishedAt: string | null;
+        };
         Comment: {
             id: string;
             source: "github" | "gitlab";
@@ -379,7 +416,7 @@ export interface components {
                 externalId: string;
                 /** @description Numeric form of externalId (cast for convenience). Useful for display like '!123' or '#123'. */
                 number: string | number;
-                /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> if you need commits attached to this activity. */
+                /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> (CSV accepted, no date window required) for the commits, pipelines and comments attached to this activity. */
                 type: "pr" | "mr";
                 title: string;
                 url: string;
@@ -453,6 +490,12 @@ export interface components {
                         url: string | null;
                     }[];
                 } | null;
+                /** @description Latest known CI pipeline for this PR/MR — derived from `ci-pipeline` events, NOT from per-job `ci-run`. Null when no pipeline is known: never read a null as 'green'. `status: 'failed'` is the CI half of a blocked signal, alongside hasConflicts, reviews and unresolvedThreads. */
+                ci?: {
+                    status: "success" | "failed" | "running" | "canceled" | "unknown";
+                    url: string | null;
+                    finishedAt: string | null;
+                } | null;
                 reviewStatus?: "draft" | "open-no-review" | "open-awaiting-my-review" | "open-awaiting-other-review" | "open-changes-requested" | "open-approved" | "merged" | "closed";
                 linkSource?: {
                     hintSource: string;
@@ -578,7 +621,7 @@ export interface components {
                     externalId: string;
                     /** @description Numeric form of externalId (cast for convenience). Useful for display like '!123' or '#123'. */
                     number: string | number;
-                    /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> if you need commits attached to this activity. */
+                    /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> (CSV accepted, no date window required) for the commits, pipelines and comments attached to this activity. */
                     type: "pr" | "mr";
                     title: string;
                     url: string;
@@ -652,6 +695,12 @@ export interface components {
                             url: string | null;
                         }[];
                     } | null;
+                    /** @description Latest known CI pipeline for this PR/MR — derived from `ci-pipeline` events, NOT from per-job `ci-run`. Null when no pipeline is known: never read a null as 'green'. `status: 'failed'` is the CI half of a blocked signal, alongside hasConflicts, reviews and unresolvedThreads. */
+                    ci?: {
+                        status: "success" | "failed" | "running" | "canceled" | "unknown";
+                        url: string | null;
+                        finishedAt: string | null;
+                    } | null;
                     reviewStatus?: "draft" | "open-no-review" | "open-awaiting-my-review" | "open-awaiting-other-review" | "open-changes-requested" | "open-approved" | "merged" | "closed";
                     linkSource?: {
                         hintSource: string;
@@ -1248,7 +1297,7 @@ export interface components {
             externalId: string;
             /** @description Numeric form of externalId (cast for convenience). Useful for display like '!123' or '#123'. */
             number: string | number;
-            /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> if you need commits attached to this activity. */
+            /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> (CSV accepted, no date window required) for the commits, pipelines and comments attached to this activity. */
             type: "pr" | "mr";
             title: string;
             url: string;
@@ -1322,6 +1371,12 @@ export interface components {
                     url: string | null;
                 }[];
             } | null;
+            /** @description Latest known CI pipeline for this PR/MR — derived from `ci-pipeline` events, NOT from per-job `ci-run`. Null when no pipeline is known: never read a null as 'green'. `status: 'failed'` is the CI half of a blocked signal, alongside hasConflicts, reviews and unresolvedThreads. */
+            ci?: {
+                status: "success" | "failed" | "running" | "canceled" | "unknown";
+                url: string | null;
+                finishedAt: string | null;
+            } | null;
             reviewStatus?: "draft" | "open-no-review" | "open-awaiting-my-review" | "open-awaiting-other-review" | "open-changes-requested" | "open-approved" | "merged" | "closed";
             linkSource?: {
                 hintSource: string;
@@ -1366,6 +1421,20 @@ export interface components {
             }[];
             fetchedAt: string;
         };
+        ProjectsListResponse: {
+            /** @description Every project the operator tracks, sorted by (source, projectKey). Sourced from the operator config, so a tracked project with no activity in any window still appears — do NOT derive this list by paginating /v1/work-items or /v1/activities, which silently omits quiet projects. */
+            projects: {
+                source: "github" | "gitlab";
+                /** @description Provider-side project path, verbatim from the operator config (`owner/repo` on GitHub, `group/sub/project` on GitLab). Pair with `source` to call /v1/projects/{source}/{projectKey}/labels. */
+                projectKey: string;
+                /** @description Last path segment of `projectKey`, for display. */
+                name: string;
+                /** @description Project homepage. Null on GitLab when no instance URL is configured. */
+                webUrl: string | null;
+                /** @description ISO timestamp of the most recent FINISHED sync run for this project, or null when it has never completed one. Null means 'tracked but never ingested' — NOT 'no recent activity'. */
+                lastSyncedAt: string | null;
+            }[];
+        };
         Provider: "github" | "gitlab";
         ResolvedUser: {
             id: string;
@@ -1428,6 +1497,17 @@ export interface components {
             firstNoteCreatedAt: string;
             url: string | null;
         };
+        TrackedProject: {
+            source: "github" | "gitlab";
+            /** @description Provider-side project path, verbatim from the operator config (`owner/repo` on GitHub, `group/sub/project` on GitLab). Pair with `source` to call /v1/projects/{source}/{projectKey}/labels. */
+            projectKey: string;
+            /** @description Last path segment of `projectKey`, for display. */
+            name: string;
+            /** @description Project homepage. Null on GitLab when no instance URL is configured. */
+            webUrl: string | null;
+            /** @description ISO timestamp of the most recent FINISHED sync run for this project, or null when it has never completed one. Null means 'tracked but never ingested' — NOT 'no recent activity'. */
+            lastSyncedAt: string | null;
+        };
         UnresolvedThreads: {
             count: string | number;
             digest: {
@@ -1483,7 +1563,7 @@ export interface components {
                 externalId: string;
                 /** @description Numeric form of externalId (cast for convenience). Useful for display like '!123' or '#123'. */
                 number: string | number;
-                /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> if you need commits attached to this activity. */
+                /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> (CSV accepted, no date window required) for the commits, pipelines and comments attached to this activity. */
                 type: "pr" | "mr";
                 title: string;
                 url: string;
@@ -1557,6 +1637,12 @@ export interface components {
                         url: string | null;
                     }[];
                 } | null;
+                /** @description Latest known CI pipeline for this PR/MR — derived from `ci-pipeline` events, NOT from per-job `ci-run`. Null when no pipeline is known: never read a null as 'green'. `status: 'failed'` is the CI half of a blocked signal, alongside hasConflicts, reviews and unresolvedThreads. */
+                ci?: {
+                    status: "success" | "failed" | "running" | "canceled" | "unknown";
+                    url: string | null;
+                    finishedAt: string | null;
+                } | null;
                 reviewStatus?: "draft" | "open-no-review" | "open-awaiting-my-review" | "open-awaiting-other-review" | "open-changes-requested" | "open-approved" | "merged" | "closed";
                 linkSource?: {
                     hintSource: string;
@@ -1650,7 +1736,7 @@ export interface components {
                     externalId: string;
                     /** @description Numeric form of externalId (cast for convenience). Useful for display like '!123' or '#123'. */
                     number: string | number;
-                    /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> if you need commits attached to this activity. */
+                    /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> (CSV accepted, no date window required) for the commits, pipelines and comments attached to this activity. */
                     type: "pr" | "mr";
                     title: string;
                     url: string;
@@ -1724,6 +1810,12 @@ export interface components {
                             url: string | null;
                         }[];
                     } | null;
+                    /** @description Latest known CI pipeline for this PR/MR — derived from `ci-pipeline` events, NOT from per-job `ci-run`. Null when no pipeline is known: never read a null as 'green'. `status: 'failed'` is the CI half of a blocked signal, alongside hasConflicts, reviews and unresolvedThreads. */
+                    ci?: {
+                        status: "success" | "failed" | "running" | "canceled" | "unknown";
+                        url: string | null;
+                        finishedAt: string | null;
+                    } | null;
                     reviewStatus?: "draft" | "open-no-review" | "open-awaiting-my-review" | "open-awaiting-other-review" | "open-changes-requested" | "open-approved" | "merged" | "closed";
                     linkSource?: {
                         hintSource: string;
@@ -1870,7 +1962,7 @@ export interface operations {
                                 externalId: string;
                                 /** @description Numeric form of externalId (cast for convenience). Useful for display like '!123' or '#123'. */
                                 number: string | number;
-                                /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> if you need commits attached to this activity. */
+                                /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> (CSV accepted, no date window required) for the commits, pipelines and comments attached to this activity. */
                                 type: "pr" | "mr";
                                 title: string;
                                 url: string;
@@ -1944,6 +2036,12 @@ export interface operations {
                                         url: string | null;
                                     }[];
                                 } | null;
+                                /** @description Latest known CI pipeline for this PR/MR — derived from `ci-pipeline` events, NOT from per-job `ci-run`. Null when no pipeline is known: never read a null as 'green'. `status: 'failed'` is the CI half of a blocked signal, alongside hasConflicts, reviews and unresolvedThreads. */
+                                ci?: {
+                                    status: "success" | "failed" | "running" | "canceled" | "unknown";
+                                    url: string | null;
+                                    finishedAt: string | null;
+                                } | null;
                                 reviewStatus?: "draft" | "open-no-review" | "open-awaiting-my-review" | "open-awaiting-other-review" | "open-changes-requested" | "open-approved" | "merged" | "closed";
                                 linkSource?: {
                                     hintSource: string;
@@ -2041,7 +2139,7 @@ export interface operations {
                                 externalId: string;
                                 /** @description Numeric form of externalId (cast for convenience). Useful for display like '!123' or '#123'. */
                                 number: string | number;
-                                /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> if you need commits attached to this activity. */
+                                /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> (CSV accepted, no date window required) for the commits, pipelines and comments attached to this activity. */
                                 type: "pr" | "mr";
                                 title: string;
                                 url: string;
@@ -2115,6 +2213,12 @@ export interface operations {
                                         url: string | null;
                                     }[];
                                 } | null;
+                                /** @description Latest known CI pipeline for this PR/MR — derived from `ci-pipeline` events, NOT from per-job `ci-run`. Null when no pipeline is known: never read a null as 'green'. `status: 'failed'` is the CI half of a blocked signal, alongside hasConflicts, reviews and unresolvedThreads. */
+                                ci?: {
+                                    status: "success" | "failed" | "running" | "canceled" | "unknown";
+                                    url: string | null;
+                                    finishedAt: string | null;
+                                } | null;
                                 reviewStatus?: "draft" | "open-no-review" | "open-awaiting-my-review" | "open-awaiting-other-review" | "open-changes-requested" | "open-approved" | "merged" | "closed";
                                 linkSource?: {
                                     hintSource: string;
@@ -2212,7 +2316,7 @@ export interface operations {
                                 externalId: string;
                                 /** @description Numeric form of externalId (cast for convenience). Useful for display like '!123' or '#123'. */
                                 number: string | number;
-                                /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> if you need commits attached to this activity. */
+                                /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> (CSV accepted, no date window required) for the commits, pipelines and comments attached to this activity. */
                                 type: "pr" | "mr";
                                 title: string;
                                 url: string;
@@ -2286,6 +2390,12 @@ export interface operations {
                                         url: string | null;
                                     }[];
                                 } | null;
+                                /** @description Latest known CI pipeline for this PR/MR — derived from `ci-pipeline` events, NOT from per-job `ci-run`. Null when no pipeline is known: never read a null as 'green'. `status: 'failed'` is the CI half of a blocked signal, alongside hasConflicts, reviews and unresolvedThreads. */
+                                ci?: {
+                                    status: "success" | "failed" | "running" | "canceled" | "unknown";
+                                    url: string | null;
+                                    finishedAt: string | null;
+                                } | null;
                                 reviewStatus?: "draft" | "open-no-review" | "open-awaiting-my-review" | "open-awaiting-other-review" | "open-changes-requested" | "open-approved" | "merged" | "closed";
                                 linkSource?: {
                                     hintSource: string;
@@ -2439,7 +2549,7 @@ export interface operations {
                             externalId: string;
                             /** @description Numeric form of externalId (cast for convenience). Useful for display like '!123' or '#123'. */
                             number: string | number;
-                            /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> if you need commits attached to this activity. */
+                            /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> (CSV accepted, no date window required) for the commits, pipelines and comments attached to this activity. */
                             type: "pr" | "mr";
                             title: string;
                             url: string;
@@ -2513,6 +2623,12 @@ export interface operations {
                                     url: string | null;
                                 }[];
                             } | null;
+                            /** @description Latest known CI pipeline for this PR/MR — derived from `ci-pipeline` events, NOT from per-job `ci-run`. Null when no pipeline is known: never read a null as 'green'. `status: 'failed'` is the CI half of a blocked signal, alongside hasConflicts, reviews and unresolvedThreads. */
+                            ci?: {
+                                status: "success" | "failed" | "running" | "canceled" | "unknown";
+                                url: string | null;
+                                finishedAt: string | null;
+                            } | null;
                             reviewStatus?: "draft" | "open-no-review" | "open-awaiting-my-review" | "open-awaiting-other-review" | "open-changes-requested" | "open-approved" | "merged" | "closed";
                             linkSource?: {
                                 hintSource: string;
@@ -2605,7 +2721,7 @@ export interface operations {
                             externalId: string;
                             /** @description Numeric form of externalId (cast for convenience). Useful for display like '!123' or '#123'. */
                             number: string | number;
-                            /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> if you need commits attached to this activity. */
+                            /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> (CSV accepted, no date window required) for the commits, pipelines and comments attached to this activity. */
                             type: "pr" | "mr";
                             title: string;
                             url: string;
@@ -2679,6 +2795,12 @@ export interface operations {
                                     url: string | null;
                                 }[];
                             } | null;
+                            /** @description Latest known CI pipeline for this PR/MR — derived from `ci-pipeline` events, NOT from per-job `ci-run`. Null when no pipeline is known: never read a null as 'green'. `status: 'failed'` is the CI half of a blocked signal, alongside hasConflicts, reviews and unresolvedThreads. */
+                            ci?: {
+                                status: "success" | "failed" | "running" | "canceled" | "unknown";
+                                url: string | null;
+                                finishedAt: string | null;
+                            } | null;
                             reviewStatus?: "draft" | "open-no-review" | "open-awaiting-my-review" | "open-awaiting-other-review" | "open-changes-requested" | "open-approved" | "merged" | "closed";
                             linkSource?: {
                                 hintSource: string;
@@ -2771,7 +2893,7 @@ export interface operations {
                             externalId: string;
                             /** @description Numeric form of externalId (cast for convenience). Useful for display like '!123' or '#123'. */
                             number: string | number;
-                            /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> if you need commits attached to this activity. */
+                            /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> (CSV accepted, no date window required) for the commits, pipelines and comments attached to this activity. */
                             type: "pr" | "mr";
                             title: string;
                             url: string;
@@ -2845,6 +2967,12 @@ export interface operations {
                                     url: string | null;
                                 }[];
                             } | null;
+                            /** @description Latest known CI pipeline for this PR/MR — derived from `ci-pipeline` events, NOT from per-job `ci-run`. Null when no pipeline is known: never read a null as 'green'. `status: 'failed'` is the CI half of a blocked signal, alongside hasConflicts, reviews and unresolvedThreads. */
+                            ci?: {
+                                status: "success" | "failed" | "running" | "canceled" | "unknown";
+                                url: string | null;
+                                finishedAt: string | null;
+                            } | null;
                             reviewStatus?: "draft" | "open-no-review" | "open-awaiting-my-review" | "open-awaiting-other-review" | "open-changes-requested" | "open-approved" | "merged" | "closed";
                             linkSource?: {
                                 hintSource: string;
@@ -2981,10 +3109,12 @@ export interface operations {
     getV1Events: {
         parameters: {
             query?: {
-                /** @description Inclusive lower bound, YYYY-MM-DD (Paris-TZ day). Required. */
+                /** @description Inclusive lower bound, YYYY-MM-DD (Paris-TZ day). Required unless `parentActivityId` is given. */
                 from?: string;
-                /** @description Inclusive upper bound, YYYY-MM-DD (Paris-TZ day). Required. */
+                /** @description Inclusive upper bound, YYYY-MM-DD (Paris-TZ day). Required unless `parentActivityId` is given. */
                 to?: string;
+                /** @description Filter by parent activity id (the `${source}:${repo}:${type}:${externalId}` key). CSV for several. When given, `from`/`to` become optional — use it to fetch every commit, pipeline and comment attached to a PR/MR without guessing a date window, which would silently drop older events. */
+                parentActivityId?: string;
                 /** @description Filter by author (case-insensitive). */
                 user?: string;
                 /** @description Filter by user identity ID (resolves to all aliases). Mutually exclusive with ?user. */
@@ -3629,6 +3759,23 @@ export interface operations {
             };
         };
     };
+    getV1EventsStream: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     getV1Activities: {
         parameters: {
             query?: {
@@ -3853,7 +4000,7 @@ export interface operations {
                                 externalId: string;
                                 /** @description Numeric form of externalId (cast for convenience). Useful for display like '!123' or '#123'. */
                                 number: string | number;
-                                /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> if you need commits attached to this activity. */
+                                /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> (CSV accepted, no date window required) for the commits, pipelines and comments attached to this activity. */
                                 type: "pr" | "mr";
                                 title: string;
                                 url: string;
@@ -3927,6 +4074,12 @@ export interface operations {
                                         url: string | null;
                                     }[];
                                 } | null;
+                                /** @description Latest known CI pipeline for this PR/MR — derived from `ci-pipeline` events, NOT from per-job `ci-run`. Null when no pipeline is known: never read a null as 'green'. `status: 'failed'` is the CI half of a blocked signal, alongside hasConflicts, reviews and unresolvedThreads. */
+                                ci?: {
+                                    status: "success" | "failed" | "running" | "canceled" | "unknown";
+                                    url: string | null;
+                                    finishedAt: string | null;
+                                } | null;
                                 reviewStatus?: "draft" | "open-no-review" | "open-awaiting-my-review" | "open-awaiting-other-review" | "open-changes-requested" | "open-approved" | "merged" | "closed";
                                 linkSource?: {
                                     hintSource: string;
@@ -4053,7 +4206,7 @@ export interface operations {
                                 externalId: string;
                                 /** @description Numeric form of externalId (cast for convenience). Useful for display like '!123' or '#123'. */
                                 number: string | number;
-                                /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> if you need commits attached to this activity. */
+                                /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> (CSV accepted, no date window required) for the commits, pipelines and comments attached to this activity. */
                                 type: "pr" | "mr";
                                 title: string;
                                 url: string;
@@ -4127,6 +4280,12 @@ export interface operations {
                                         url: string | null;
                                     }[];
                                 } | null;
+                                /** @description Latest known CI pipeline for this PR/MR — derived from `ci-pipeline` events, NOT from per-job `ci-run`. Null when no pipeline is known: never read a null as 'green'. `status: 'failed'` is the CI half of a blocked signal, alongside hasConflicts, reviews and unresolvedThreads. */
+                                ci?: {
+                                    status: "success" | "failed" | "running" | "canceled" | "unknown";
+                                    url: string | null;
+                                    finishedAt: string | null;
+                                } | null;
                                 reviewStatus?: "draft" | "open-no-review" | "open-awaiting-my-review" | "open-awaiting-other-review" | "open-changes-requested" | "open-approved" | "merged" | "closed";
                                 linkSource?: {
                                     hintSource: string;
@@ -4253,7 +4412,7 @@ export interface operations {
                                 externalId: string;
                                 /** @description Numeric form of externalId (cast for convenience). Useful for display like '!123' or '#123'. */
                                 number: string | number;
-                                /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> if you need commits attached to this activity. */
+                                /** @description PR/MR linked via git_activity_links. Commit-level linkage is NOT included here — fetch /v1/events?parentActivityId=<id> (CSV accepted, no date window required) for the commits, pipelines and comments attached to this activity. */
                                 type: "pr" | "mr";
                                 title: string;
                                 url: string;
@@ -4327,6 +4486,12 @@ export interface operations {
                                         url: string | null;
                                     }[];
                                 } | null;
+                                /** @description Latest known CI pipeline for this PR/MR — derived from `ci-pipeline` events, NOT from per-job `ci-run`. Null when no pipeline is known: never read a null as 'green'. `status: 'failed'` is the CI half of a blocked signal, alongside hasConflicts, reviews and unresolvedThreads. */
+                                ci?: {
+                                    status: "success" | "failed" | "running" | "canceled" | "unknown";
+                                    url: string | null;
+                                    finishedAt: string | null;
+                                } | null;
                                 reviewStatus?: "draft" | "open-no-review" | "open-awaiting-my-review" | "open-awaiting-other-review" | "open-changes-requested" | "open-approved" | "merged" | "closed";
                                 linkSource?: {
                                     hintSource: string;
@@ -4555,6 +4720,66 @@ export interface operations {
             };
         };
     };
+    getV1Projects: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Every project the operator tracks, sorted by (source, projectKey). Sourced from the operator config, so a tracked project with no activity in any window still appears — do NOT derive this list by paginating /v1/work-items or /v1/activities, which silently omits quiet projects. */
+                        projects: {
+                            source: "github" | "gitlab";
+                            /** @description Provider-side project path, verbatim from the operator config (`owner/repo` on GitHub, `group/sub/project` on GitLab). Pair with `source` to call /v1/projects/{source}/{projectKey}/labels. */
+                            projectKey: string;
+                            /** @description Last path segment of `projectKey`, for display. */
+                            name: string;
+                            /** @description Project homepage. Null on GitLab when no instance URL is configured. */
+                            webUrl: string | null;
+                            /** @description ISO timestamp of the most recent FINISHED sync run for this project, or null when it has never completed one. Null means 'tracked but never ingested' — NOT 'no recent activity'. */
+                            lastSyncedAt: string | null;
+                        }[];
+                    };
+                    "multipart/form-data": {
+                        /** @description Every project the operator tracks, sorted by (source, projectKey). Sourced from the operator config, so a tracked project with no activity in any window still appears — do NOT derive this list by paginating /v1/work-items or /v1/activities, which silently omits quiet projects. */
+                        projects: {
+                            source: "github" | "gitlab";
+                            /** @description Provider-side project path, verbatim from the operator config (`owner/repo` on GitHub, `group/sub/project` on GitLab). Pair with `source` to call /v1/projects/{source}/{projectKey}/labels. */
+                            projectKey: string;
+                            /** @description Last path segment of `projectKey`, for display. */
+                            name: string;
+                            /** @description Project homepage. Null on GitLab when no instance URL is configured. */
+                            webUrl: string | null;
+                            /** @description ISO timestamp of the most recent FINISHED sync run for this project, or null when it has never completed one. Null means 'tracked but never ingested' — NOT 'no recent activity'. */
+                            lastSyncedAt: string | null;
+                        }[];
+                    };
+                    "text/plain": {
+                        /** @description Every project the operator tracks, sorted by (source, projectKey). Sourced from the operator config, so a tracked project with no activity in any window still appears — do NOT derive this list by paginating /v1/work-items or /v1/activities, which silently omits quiet projects. */
+                        projects: {
+                            source: "github" | "gitlab";
+                            /** @description Provider-side project path, verbatim from the operator config (`owner/repo` on GitHub, `group/sub/project` on GitLab). Pair with `source` to call /v1/projects/{source}/{projectKey}/labels. */
+                            projectKey: string;
+                            /** @description Last path segment of `projectKey`, for display. */
+                            name: string;
+                            /** @description Project homepage. Null on GitLab when no instance URL is configured. */
+                            webUrl: string | null;
+                            /** @description ISO timestamp of the most recent FINISHED sync run for this project, or null when it has never completed one. Null means 'tracked but never ingested' — NOT 'no recent activity'. */
+                            lastSyncedAt: string | null;
+                        }[];
+                    };
+                };
+            };
+        };
+    };
     getV1ProjectsBySourceByProjectKeyLabels: {
         parameters: {
             query?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cesar-richard/git-connector-sdk",
-  "version": "2.6.0",
+  "version": "2.7.1",
   "description": "TypeScript SDK for the git-connector v1 API (work items + iterations aggregated from GitHub/GitLab). Version published on npm tracks server releases.",
   "license": "MIT",
   "repository": {