@gitkraken/core-gitlens 0.4.0 → 0.4.101

package/dist/plus/integrations/reads/filters.js

@@ -0,0 +1,87 @@
+import { providersMetadata } from '../providers/models.js';
+/**
+ * Validates a repo-scoped PR filter set, so an unsupported filter never trips the read core's "Unsupported
+ * filters" guard. `unsupported: true` when the caller DID request filters and the provider can't express even
+ * ONE of them — the exact negation of the read core's `providerSupportsPullRequestFilters` (`every`), so this
+ * can only ever pre-empt that guard, never disagree with it.
+ *
+ * Returns `{ filters }` (possibly undefined when none were requested — an unfiltered read is intended). Genuine
+ * "my pull requests" self-scoping is delivered by the account-wide path
+ * (`GitHostIntegration.getMyPullRequestsForUserResult`); this only governs the optional repo-scoped narrowing.
+ */
+export function resolvePullRequestFilters(id, filters) {
+    if (filters == null || filters.length === 0)
+        return { unsupported: false };
+    const supported = providersMetadata[id]?.supportedPullRequestFilters;
+    if (supported == null || filters.some(f => !supported.includes(f)))
+        return { unsupported: true };
+    return { filters: filters, unsupported: false };
+}
+/**
+ * Validates an account-wide PR relationship union independently from the repo-scoped capability. Dropping an
+ * unsupported member would change the requested OR set, so validation is all-or-nothing.
+ */
+export function resolveAccountWidePullRequestFilters(id, filters) {
+    if (filters == null || filters.length === 0)
+        return { unsupported: false };
+    const supported = providersMetadata[id]?.supportedAccountWidePullRequestFilters;
+    if (supported == null || filters.some(f => !supported.includes(f)))
+        return { unsupported: true };
+    return { filters: [...new Set(filters)], unsupported: false };
+}
+/**
+ * Validates a caller-provided issue filter set against what the provider's ACCOUNT-WIDE issue read can express
+ * server-side (`ProviderMetadata.supportedAccountWideIssueFilters`), which is a different — usually narrower —
+ * set than the repo-scoped `ProviderMetadata.supportedIssueFilters`.
+ *
+ * Dropping the unexpressible members would silently widen the read back toward the provider's own union
+ * (authored ∪ assigned ∪ mentioned for GitHub), which is the opposite of what a caller narrowing to
+ * `[Assignee]` asked for.
+ */
+export function resolveAccountWideIssueFilters(id, filters) {
+    if (filters == null || filters.length === 0)
+        return { unsupported: false };
+    const supported = providersMetadata[id]?.supportedAccountWideIssueFilters;
+    if (supported == null || filters.some(f => !supported.includes(f)))
+        return { unsupported: true };
+    return { filters: filters, unsupported: false };
+}
+/**
+ * The filters `listPullRequestsPage`/`listIssuesPage` (and the sweeps) accept for a provider, so a caller can
+ * narrow to what the provider can express BEFORE issuing the read.
+ *
+ * This matters because the filter contract is all-or-nothing: a set containing even one unsupported filter is
+ * refused outright ({@link resolvePullRequestFilters}) rather than silently narrowed, since falling through to
+ * an unfiltered fetch would return every PR instead of the user's. Without this accessor a consumer had to
+ * hardcode its own copy of the table — reachable only by importing the internal `providers/models.js`
+ * subpath — and a copy that drifts turns a supported read into an empty page with `fetchFailed`.
+ *
+ * Empty means "no filter of that kind is expressible": either the provider has no such surface (issue trackers
+ * have no pull requests; Bitbucket exposes no issues) or its metadata declares none. Callers should treat it as
+ * "don't pass filters", not as an error. Returns copies, so mutating the result can't corrupt the metadata.
+ *
+ * `issues` and `issuesAccountWide` are separate because the repo-scoped and account-wide issue reads are
+ * different provider queries with different filter surfaces, and the same `filters` input is validated against
+ * whichever one the read uses (`repos` present or not). `issuesAccountWide` is generally the narrower of the
+ * two: GitLab, for instance, can express `Assignee` and `Author` account-wide, but not `Mention`.
+ *
+ * That split describes the GIT-HOST reads only. An issue tracker (Jira/Linear/Trello) has neither — its issues
+ * live under resource → project — so it reports its filters under `issues`, which is what
+ * {@link IntegrationService.listIssueTrackerIssuesPage} validates against, and leaves `issuesAccountWide`
+ * empty. Reading a tracker's capability off `issuesAccountWide` therefore under-reports it.
+ *
+ * Note this is a CAPABILITY table — "what the provider can express" — not a recommendation. A consumer
+ * matching another tool's behavior may deliberately pass fewer filters than are listed here (or none, where an
+ * already-scoped read would only be narrowed by them). Intersecting against this table is what keeps a
+ * filtered read from being refused; it isn't a directive to use every filter in it.
+ */
+export function getSupportedFilters(providerId) {
+    const metadata = providersMetadata[providerId];
+    return {
+        pullRequests: [...(metadata?.supportedPullRequestFilters ?? [])],
+        pullRequestsAccountWide: [...(metadata?.supportedAccountWidePullRequestFilters ?? [])],
+        issues: [...(metadata?.supportedIssueFilters ?? [])],
+        issuesAccountWide: [...(metadata?.supportedAccountWideIssueFilters ?? [])],
+    };
+}
+//# sourceMappingURL=filters.js.map

package/dist/plus/integrations/reads/filters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.js","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/filters.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAoB3D;;;;;;;;;GASG;AACH,MAAM,UAAU,yBAAyB,CACxC,EAAkB,EAClB,OAAwC;IAExC,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAE3E,MAAM,SAAS,GAAG,iBAAiB,CAAC,EAAE,CAAC,EAAE,2BAA2B,CAAC;IACrE,IAAI,SAAS,IAAI,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAEjG,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oCAAoC,CACnD,EAAkB,EAClB,OAAwC;IAExC,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAE3E,MAAM,SAAS,GAAG,iBAAiB,CAAC,EAAE,CAAC,EAAE,sCAAsC,CAAC;IAChF,IAAI,SAAS,IAAI,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAEjG,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AAC/D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,8BAA8B,CAC7C,EAAkB,EAClB,OAAkC;IAElC,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAE3E,MAAM,SAAS,GAAG,iBAAiB,CAAC,EAAE,CAAC,EAAE,gCAAgC,CAAC;IAC1E,IAAI,SAAS,IAAI,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAEjG,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAA0B;IAM7D,MAAM,QAAQ,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAC/C,OAAO;QACN,YAAY,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,2BAA2B,IAAI,EAAE,CAAC,CAAC;QAChE,uBAAuB,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,sCAAsC,IAAI,EAAE,CAAC,CAAC;QACtF,MAAM,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,qBAAqB,IAAI,EAAE,CAAC,CAAC;QACpD,iBAAiB,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,gCAAgC,IAAI,EAAE,CAAC,CAAC;KAC1E,CAAC;AACH,CAAC"}

package/dist/plus/integrations/reads/hierarchy.d.ts

@@ -0,0 +1,17 @@
+import type { IntegrationIds } from '../constants.js';
+import type { ListOrgsOptions, ListProjectsOptions } from '../manager.js';
+import type { ProviderOrganization, ProviderPagedResult, ProviderRepositoryShape, ProviderResult } from '../results.js';
+import type { ProviderReadContext } from './context.js';
+export declare function listOrgs(ctx: ProviderReadContext, options?: ListOrgsOptions): Promise<ProviderResult<ProviderOrganization>>;
+export declare function listProjects(ctx: ProviderReadContext, options?: ListProjectsOptions): Promise<ProviderResult<ProviderOrganization>>;
+export declare function listRepos(ctx: ProviderReadContext, options: {
+    providerId: IntegrationIds;
+    org?: string;
+    project?: string;
+    page?: number;
+    cursor?: string;
+    itemsPerPage?: number;
+    connectionId?: string;
+    domain?: string;
+}): Promise<ProviderPagedResult<ProviderRepositoryShape>>;
+//# sourceMappingURL=hierarchy.d.ts.map

package/dist/plus/integrations/reads/hierarchy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy.d.ts","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/hierarchy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAQtD,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAG1E,OAAO,KAAK,EACX,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EAEd,MAAM,eAAe,CAAC;AAOvB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAaxD,wBAAsB,QAAQ,CAC7B,GAAG,EAAE,mBAAmB,EACxB,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC,CA8F/C;AAED,wBAAsB,YAAY,CACjC,GAAG,EAAE,mBAAmB,EACxB,OAAO,CAAC,EAAE,mBAAmB,GAC3B,OAAO,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC,CA8H/C;AAED,wBAAsB,SAAS,CAC9B,GAAG,EAAE,mBAAmB,EACxB,OAAO,EAAE;IACR,UAAU,EAAE,cAAc,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,GACC,OAAO,CAAC,mBAAmB,CAAC,uBAAuB,CAAC,CAAC,CA+LvD"}

package/dist/plus/integrations/reads/hierarchy.js

@@ -0,0 +1,320 @@
+import { mapBounded } from '../../../utils/promise.js';
+import { mergeAssessmentInto } from '../collectionMetadata.js';
+import { GitCloudHostIntegrationId, GitSelfManagedHostIntegrationId, providerFanOutConcurrency, supportedOrderedCloudIntegrationIds, supportedOrderedCloudIssuesIntegrationIds, } from '../constants.js';
+import { isIssuesIntegration } from '../models/issuesIntegration.js';
+import { toProviderRepositoryShape } from '../providers/models.js';
+import { appendDedupedWarning } from '../results.js';
+import { isGitHostIntegration, isIssuesHostIntegrationId, warnOnMissingSessionForDomain, } from '../utils/integration.utils.js';
+import { runCaptured } from './drains.js';
+import { assertHierarchyReadTarget, mergeHierarchyResults, orgForProject, resourceMatchesOrg, resourceToOrg, withProviderContext, } from './hierarchy.utils.js';
+import { pageToCursor, refusedPage, resolveContinuation, resolveCurrentPage, toProviderPageInfo } from './paging.js';
+import { gitHostOnlySurfaceWarning, otherWarning } from './warnings.js';
+export async function listOrgs(ctx, options) {
+    assertHierarchyReadTarget('listOrgs', options);
+    const ids = options?.providerId != null ? [options.providerId] : supportedOrderedCloudIntegrationIds;
+    const singleProvider = ids.length === 1;
+    const connectionId = singleProvider ? options?.connectionId : undefined;
+    const requestedDomain = singleProvider ? options?.domain : undefined;
+    const results = await mapBounded(ids, providerFanOutConcurrency, async (id) => {
+        const integration = await ctx.getIntegrationForRead(id, connectionId, requestedDomain);
+        if (integration == null) {
+            // A specifically requested connection that can't be resolved is a broken connection, not a
+            // provider with no orgs — surface it (warning + fetchFailed) instead of dropping the id
+            // silently, so a caller can tell it apart from an account that genuinely has no orgs.
+            const early = ctx.earlyReturnConnectionWarnings(id, connectionId, requestedDomain);
+            return {
+                items: [],
+                warnings: early.warnings,
+                fetchFailed: early.fetchFailed,
+            };
+        }
+        const items = [];
+        const warnings = [];
+        let fetchFailed = false;
+        const domain = ctx.domainForRead(integration, id, connectionId, requestedDomain);
+        const warnOnMissingSession = warnOnMissingSessionForDomain(id, requestedDomain);
+        if (isIssuesIntegration(integration)) {
+            // Issue trackers expose "resources" (Jira sites, Linear orgs, …) as their org analogue.
+            const { value: resources, warning } = await runCaptured(id, domain, connectionId, () => integration.getResourcesForUserResult(connectionId), { warnOnMissingSession: warnOnMissingSession });
+            if (resources != null) {
+                items.push(...resources.map(r => resourceToOrg(id, r)));
+            }
+            if (warning != null) {
+                warnings.push(warning);
+                // A warning with no value is a hard read failure, not an empty account.
+                if (resources == null) {
+                    fetchFailed = true;
+                }
+            }
+        }
+        else if (!integration.supportsOrganizationDiscovery) {
+            // The provider registers no org-discovery hook (e.g. Bitbucket Data Center). Report it as
+            // explicitly unsupported rather than contributing a silent empty list that a caller can't
+            // tell apart from "this account has no orgs".
+            fetchFailed = true;
+            warnings.push(otherWarning(id, domain, connectionId, `Organization discovery is not supported by '${id}'.`));
+        }
+        else {
+            const { value, warning } = await runCaptured(id, domain, connectionId, () => integration.getOrganizationsForUserResult(connectionId), { warnOnMissingSession: warnOnMissingSession });
+            if (value != null) {
+                items.push(...value.values.map(org => withProviderContext(id, org)));
+                if (value.truncated) {
+                    warnings.push(otherWarning(id, domain, connectionId, 'Organization listing was truncated before the upstream results were exhausted.'));
+                    // `ProviderResult` has no page object on which to carry truncation. Mark the flat
+                    // hierarchy result incomplete so consumers don't treat omitted orgs as authoritative.
+                    fetchFailed = true;
+                }
+                const assessment = mergeAssessmentInto(warnings, id, domain, connectionId, value.metadata);
+                if (assessment.fetchFailed || assessment.truncated) {
+                    fetchFailed = true;
+                }
+            }
+            if (warning != null) {
+                warnings.push(warning);
+                if (value == null) {
+                    fetchFailed = true;
+                }
+            }
+        }
+        return { items: items, warnings: warnings, fetchFailed: fetchFailed };
+    });
+    return mergeHierarchyResults(results);
+}
+export async function listProjects(ctx, options) {
+    assertHierarchyReadTarget('listProjects', options);
+    const ids = options?.providerId != null
+        ? [options.providerId]
+        : [
+            ...supportedOrderedCloudIssuesIntegrationIds,
+            GitCloudHostIntegrationId.AzureDevOps,
+            GitSelfManagedHostIntegrationId.AzureDevOpsServer,
+        ];
+    const singleProvider = ids.length === 1;
+    const connectionId = singleProvider ? options?.connectionId : undefined;
+    const requestedDomain = singleProvider ? options?.domain : undefined;
+    const results = await mapBounded(ids, providerFanOutConcurrency, async (id) => {
+        const integration = await ctx.getIntegrationForRead(id, connectionId, requestedDomain);
+        if (integration == null) {
+            // A requested connection that can't be resolved is a broken connection, not a provider with
+            // no projects — surface it (warning + fetchFailed) instead of dropping the id silently.
+            const early = ctx.earlyReturnConnectionWarnings(id, connectionId, requestedDomain);
+            return {
+                items: [],
+                warnings: early.warnings,
+                fetchFailed: early.fetchFailed,
+            };
+        }
+        const items = [];
+        const warnings = [];
+        let fetchFailed = false;
+        const domain = ctx.domainForRead(integration, id, connectionId, requestedDomain);
+        const org = options?.org;
+        const warnOnMissingSession = warnOnMissingSessionForDomain(id, requestedDomain);
+        // Git hosts with a project tier (Azure DevOps) read projects through their own hierarchy hook,
+        // scoped to `org` when given. Non-Azure git hosts have no project tier and return undefined.
+        if (!isIssuesIntegration(integration)) {
+            // Check the capability first, like listOrgs/listRepos/listIssuesPage do. Without it, a host
+            // with no project tier returns `undefined` from a successful read, which `runCaptured` can't
+            // tell apart from an unresolvable session — turning a healthy provider into a `no-connection`
+            // warning + `fetchFailed` (and, in Kepler, a spurious reconnect prompt).
+            if (!integration.supportsProjectDiscovery) {
+                return { items: items, warnings: warnings, fetchFailed: false };
+            }
+            const { value: projects, warning } = await runCaptured(id, domain, connectionId, () => integration.getProjectsForOrgResult(org, connectionId), { warnOnMissingSession: warnOnMissingSession });
+            if (warning != null) {
+                warnings.push(warning);
+                if (projects == null) {
+                    fetchFailed = true;
+                }
+            }
+            if (projects != null) {
+                items.push(...projects.values.map(project => withProviderContext(id, project)));
+                if (projects.truncated) {
+                    warnings.push(otherWarning(id, domain, connectionId, 'Project listing was truncated before the upstream results were exhausted.'));
+                    // Unlike paged repository reads, this flattened hierarchy result has no continuation
+                    // or page metadata. `fetchFailed` is its structural non-authoritative signal.
+                    fetchFailed = true;
+                }
+                const assessment = mergeAssessmentInto(warnings, id, domain, connectionId, projects.metadata);
+                if (assessment.fetchFailed || assessment.truncated) {
+                    fetchFailed = true;
+                }
+            }
+            return { items: items, warnings: warnings, fetchFailed: fetchFailed };
+        }
+        const { value: resources, warning: resourcesWarning } = await runCaptured(id, domain, connectionId, () => integration.getResourcesForUserResult(connectionId), { warnOnMissingSession: warnOnMissingSession });
+        if (resourcesWarning != null) {
+            warnings.push(resourcesWarning);
+            if (resources == null) {
+                fetchFailed = true;
+            }
+        }
+        const scopedResources = org != null ? resources?.filter(resource => resourceMatchesOrg(resource, org)) : resources;
+        if (scopedResources != null && scopedResources.length !== 0) {
+            const { value: projects, warning: projectsWarning } = await runCaptured(id, domain, connectionId, () => integration.getProjectsForResourcesWithMetadataResult(scopedResources, connectionId));
+            if (projectsWarning != null) {
+                warnings.push(projectsWarning);
+                if (projects == null) {
+                    fetchFailed = true;
+                }
+            }
+            if (projects != null) {
+                items.push(...projects.values.map(project => resourceToOrg(id, project, orgForProject(id, project, scopedResources))));
+            }
+            const assessment = mergeAssessmentInto(warnings, id, domain, connectionId, projects?.metadata);
+            if (assessment.fetchFailed || assessment.truncated) {
+                fetchFailed = true;
+            }
+        }
+        return { items: items, warnings: warnings, fetchFailed: fetchFailed };
+    });
+    return mergeHierarchyResults(results);
+}
+export async function listRepos(ctx, options) {
+    const page = Math.max(1, options.page ?? 1);
+    if (isIssuesHostIntegrationId(options.providerId)) {
+        return refusedPage(page, [gitHostOnlySurfaceWarning(options.providerId, undefined, options.connectionId, 'repository discovery')], true);
+    }
+    const integration = await ctx.getIntegrationForRead(options.providerId, options.connectionId, options.domain);
+    if (integration == null) {
+        // A supplied connection or domain that no longer resolves is a broken target, not an empty account —
+        // surface a no-connection warning + fetchFailed rather than a silent empty page.
+        const early = ctx.earlyReturnConnectionWarnings(options.providerId, options.connectionId, options.domain);
+        return refusedPage(page, early.warnings, early.fetchFailed);
+    }
+    if (!isGitHostIntegration(integration)) {
+        return refusedPage(page, [gitHostOnlySurfaceWarning(options.providerId, undefined, options.connectionId, 'repository discovery')], true);
+    }
+    const domain = ctx.domainForRead(integration, options.providerId, options.connectionId, options.domain);
+    const accountWide = options.org == null;
+    const supported = accountWide
+        ? integration.supportsUserRepositoryDiscovery
+        : integration.supportsRepositoryDiscovery;
+    if (!supported) {
+        // No matching repo-discovery hook — org-scoped (e.g. Bitbucket Data Center) or account-wide (e.g.
+        // Bitbucket/Azure, whose repos can only be walked per workspace/org). Report unsupported rather than
+        // a silent empty page indistinguishable from "no repos"; for the account-wide case the caller should
+        // fan out per org from listOrgs instead.
+        return refusedPage(page, [
+            otherWarning(options.providerId, domain, options.connectionId, accountWide
+                ? `Account-wide repository discovery is not supported by '${options.providerId}'; list repositories per org instead.`
+                : `Repository discovery is not supported by '${options.providerId}'.`),
+        ], true);
+    }
+    const org = options.org;
+    const warnOnMissingSession = warnOnMissingSessionForDomain(options.providerId, options.domain);
+    const readPage = (cursor) => runCaptured(options.providerId, domain, options.connectionId, () => org == null
+        ? integration.getRepositoriesForUserResult({ cursor: cursor, connectionId: options.connectionId })
+        : integration.getRepositoriesForOrgResult(org, {
+            project: options.project,
+            cursor: cursor,
+            connectionId: options.connectionId,
+        }), { warnOnMissingSession: warnOnMissingSession });
+    /**
+     * Builds one page's result from what the provider returned. Shared by the initial read and by every round of
+     * the cursor walk below, so a walked page N is described by exactly the same rules as a directly-requested one
+     * (position, continuation, truncation) rather than by a second copy of them.
+     */
+    const toResult = ({ value, warning }, requestedPage, suppliedCursor) => {
+        const items = value?.values ?? [];
+        const warnings = warning != null ? [warning] : [];
+        // The repos read core is cursor-only and can't accept a page size, so don't echo the requested
+        // `itemsPerPage` as if it were applied — report what the provider returned (its own pageSize when
+        // available, else the actual item count).
+        const paged = toProviderPageInfo(items.length, value?.paging);
+        // Convert the SDK collection metadata into scope-aware warnings + failure/truncation flags, appending
+        // them to any captured thrown-error warning without discarding the partial result's items.
+        const assessment = mergeAssessmentInto(warnings, options.providerId, domain, options.connectionId, value?.metadata);
+        // Whether this read honors a page NUMBER, decided from what the provider actually reported rather than
+        // guessed from the absence of a cursor. A numbered-page repos host reports its position (`paging.page`)
+        // and/or its successor (`paging.nextPage`) — Bitbucket's workspace walk consumes `page` as a real 1-based
+        // page and reports `nextPage` without echoing `currentPage`, so both signals have to count. Every wired
+        // cursor-based repos read (GitHub's org/user walks, GitLab's user walk, Bitbucket's cursor read) reports
+        // neither. Keying off `paged.cursor == null` instead read the paging layer's "reported another page,
+        // handed back no continuation" sentinel as evidence of a numbered host, which is exactly backwards.
+        const pageAdvanceable = value?.paging?.page != null || value?.paging?.nextPage != null;
+        // Numbered-page hosts that don't echo `currentPage` may still be advanced by the requested `page` (initial
+        // read) or by the cursor the caller threaded back. A cursor-only host ignores an UNTHREADED `page`
+        // request, so its page-less first page is page 1.
+        const currentPage = resolveCurrentPage({
+            providerPage: paged.page.currentPage,
+            requestedPage: requestedPage,
+            suppliedCursor: suppliedCursor,
+            pageAdvanceable: pageAdvanceable,
+        });
+        // Never advertise `hasMore` without a continuation the caller can act on — the same contract
+        // `listPullRequestsPage`, `listIssuesPage` and `broadenIssues` hold, via the same helper. A provider that
+        // reports another page but hands back neither `endCursor` nor `nextPage` (surfaced as the `'{}'` sentinel,
+        // which `toProviderPageInfo` drops) is terminal-but-incomplete: `hasMore: false` + `page.truncated`.
+        // Synthesizing a page-number cursor for a cursor-only host instead — which is what this read used to do
+        // unconditionally — handed back a continuation the provider ignores, so it answered with its FIRST page
+        // again while still reporting `hasMore: true`. A consumer draining until `hasMore` clears (Kepler's repo
+        // drain does exactly that) then looped to its own page cap, accumulating a duplicate copy of every repo
+        // per round, and never saw a truncation signal.
+        const continuation = resolveContinuation(paged, pageAdvanceable ? currentPage + 1 : undefined);
+        // The org-hierarchy read can also stop at a defensive backstop with more repos unlisted and no cursor to
+        // resume (top-level `truncated`, or `paging.truncated` on a single-page read). Metadata incompleteness and
+        // a demoted continuation are two further, independent sources of the same signal.
+        const truncated = (value?.truncated ?? false) ||
+            (value?.paging?.truncated ?? false) ||
+            assessment.truncated ||
+            continuation.truncated;
+        return {
+            // Normalize the raw provider-apis repos to the GitLens-owned shape at the surface boundary.
+            items: items.map(toProviderRepositoryShape),
+            warnings: warnings,
+            page: { ...paged.page, currentPage: currentPage, truncated: truncated || undefined },
+            hasMore: continuation.hasMore,
+            cursor: continuation.cursor,
+            fetchFailed: assessment.fetchFailed || (warning != null && value == null) || undefined,
+        };
+    };
+    const first = await readPage(options.cursor ?? pageToCursor(page));
+    const result = toResult(first, page, options.cursor);
+    // A numbered-page host honored the synthesized cursor, so this IS page N; a cursor-only host ignored it and
+    // answered with page 1, which the walk below advances. Decided from the provider's own paging metadata rather
+    // than assumed, hence after the read.
+    const pageAdvanceable = first.value?.paging?.page != null || first.value?.paging?.nextPage != null;
+    if (options.cursor != null || page === 1 || pageAdvanceable)
+        return result;
+    // Walk the provider's real continuations to the requested page. Only the last page's items are kept — pages
+    // 1..N returned as "page N" would duplicate items for a normal paged consumer — while warnings, truncation,
+    // and failure accumulate across the whole walked prefix, since an earlier round's problem still means this
+    // result isn't authoritative. The provider read is re-issued per round, but the integration is resolved once:
+    // re-entering this function per page would repeat its auth resolution N times for page N.
+    const walkedWarnings = [...result.warnings];
+    let walkedFetchFailed = result.fetchFailed === true;
+    let walkedTruncated = result.page.truncated === true;
+    let previous = result;
+    for (let currentPage = 2; currentPage <= page; currentPage++) {
+        if (!previous.hasMore || previous.cursor == null) {
+            // The requested page lies past the provider's terminal cursor: an EMPTY page N, never the last
+            // available page relabeled (see ProviderPageInfo.currentPage).
+            return {
+                items: [],
+                warnings: walkedWarnings,
+                page: { currentPage: page, itemsPerPage: 0, truncated: walkedTruncated || undefined },
+                hasMore: false,
+                fetchFailed: walkedFetchFailed || undefined,
+            };
+        }
+        const suppliedCursor = previous.cursor;
+        const requested = toResult(await readPage(suppliedCursor), currentPage, suppliedCursor);
+        for (const warning of requested.warnings) {
+            appendDedupedWarning(walkedWarnings, warning);
+        }
+        walkedFetchFailed ||= requested.fetchFailed === true;
+        walkedTruncated ||= requested.page.truncated === true;
+        if (currentPage === page) {
+            return {
+                ...requested,
+                warnings: walkedWarnings,
+                page: { ...requested.page, truncated: walkedTruncated || undefined },
+                fetchFailed: walkedFetchFailed || undefined,
+            };
+        }
+        previous = requested;
+    }
+    return result;
+}
+//# sourceMappingURL=hierarchy.js.map

package/dist/plus/integrations/reads/hierarchy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy.js","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/hierarchy.ts"],"names":[],"mappings":"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"}

package/dist/plus/integrations/reads/hierarchy.utils.d.ts

@@ -0,0 +1,77 @@
+import type { ResourceDescriptor } from '../../../git/models/resourceDescriptor.js';
+import type { IntegrationIds } from '../constants.js';
+import type { ProviderOrganization, ProviderResult, ProviderWarning } from '../results.js';
+/**
+ * Mapping of a provider's own hierarchy vocabulary onto the single {@link ProviderOrganization} shape the facade
+ * publishes.
+ *
+ * Providers disagree about what sits above a repo or an issue: git hosts have orgs (and Azure DevOps a project
+ * tier below that), while issue trackers have "resources" (Jira sites, Linear orgs, Trello workspaces) with
+ * projects beneath them. `listOrgs`/`listProjects` unify all of it, so these helpers exist to keep the
+ * per-provider shape-guessing — which field is the id, which is the display label, which resource is a
+ * project's parent — in one place instead of inline in those reads.
+ *
+ * Everything here reads through the base {@link ResourceDescriptor} (which only guarantees `key`) and casts to
+ * the concrete {@link IssueResourceDescriptor} for the optional `id`/`name`. That cast is why the fallbacks are
+ * spelled out rather than assumed.
+ */
+/** The label to show for a resource: its name, else its id, else the key that is always present. */
+export declare function resourceLabel(resource: ResourceDescriptor): string;
+/** Whether `org` addresses this resource by any of the identifiers a caller could reasonably have. */
+export declare function resourceMatchesOrg(resource: ResourceDescriptor, org: string): boolean;
+/**
+ * The id of the RESOURCE a project belongs to, used to look up which account (and therefore which user) that
+ * project's issues should be scoped to. Falls back through the project's own identifiers because some providers
+ * (and test doubles) return project descriptors without naming their parent.
+ */
+export declare function resourceIdForProject(project: ResourceDescriptor): string | undefined;
+/**
+ * A stable identity for one project across facade pages, for the retry/completed bookkeeping an issue-tracker
+ * cursor carries. All three identifiers are included rather than one preferred value: two trackers can reuse the
+ * same project id, so keying on a single field would collapse them into one entry.
+ */
+export declare function projectKey(project: ResourceDescriptor): string;
+/**
+ * Maps an issue-tracker resource descriptor to the unified {@link ProviderOrganization} org shape. `url` is
+ * synthesized when the descriptor carries none, rather than widening the shared `ProviderOrganization.url` to
+ * optional for the one provider family that may omit it.
+ */
+export declare function resourceToOrg(providerId: IntegrationIds, resource: ResourceDescriptor, org?: string): ProviderOrganization;
+/**
+ * The resource a project belongs under, as a display label — the `org` of the project's unified org shape.
+ *
+ * A project doesn't reliably name its parent, so try each identifier it does carry against the resources that
+ * were read alongside it. When none matches but only ONE resource was in scope, that resource is the parent by
+ * construction. Trello is excluded: its boards have no enclosing resource to name.
+ */
+export declare function orgForProject(providerId: IntegrationIds, project: ResourceDescriptor, resources: ResourceDescriptor[]): string | undefined;
+/**
+ * Stamps the provider onto an org the provider's own client produced. A git host's client fills the rest of the
+ * shape but doesn't know which integration id it was reached through — and on a self-managed host the same
+ * client serves several — so the fan-out attributes it here.
+ */
+export declare function withProviderContext(providerId: IntegrationIds, item: ProviderOrganization): ProviderOrganization;
+/**
+ * Merges the per-provider slices of a hierarchy fan-out into one flat result.
+ *
+ * `ProviderResult` has no page object, so `fetchFailed` is its only non-authoritative signal — any slice that
+ * failed or came back incomplete has to set it, or a caller would treat a short list as the whole account.
+ * Warnings are deduped because the same account can surface under two ids in one fan-out.
+ */
+export declare function mergeHierarchyResults<T>(results: readonly ({
+    items: T[];
+    warnings: ProviderWarning[];
+    fetchFailed: boolean;
+} | undefined)[]): ProviderResult<T>;
+/**
+ * Rejects a hierarchy read whose scoped selectors have no provider to apply to. `connectionId` and `domain`
+ * both select among the connections OF a provider, so either one without `providerId` is ambiguous rather than
+ * merely redundant — the fan-out would have to guess which provider the caller meant, and silently picking one
+ * would read that connection's data under another provider's name.
+ */
+export declare function assertHierarchyReadTarget(method: 'listOrgs' | 'listProjects', options: {
+    providerId?: IntegrationIds;
+    connectionId?: string;
+    domain?: string;
+} | undefined): void;
+//# sourceMappingURL=hierarchy.utils.d.ts.map

package/dist/plus/integrations/reads/hierarchy.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy.utils.d.ts","sourceRoot":"","sources":["../../../../src/plus/integrations/reads/hierarchy.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA2B,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAE7G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAG3F;;;;;;;;;;;;;GAaG;AAEH,oGAAoG;AACpG,wBAAgB,aAAa,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAGlE;AAED,sGAAsG;AACtG,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAGrF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,GAAG,SAAS,CAGpF;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAG9D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC5B,UAAU,EAAE,cAAc,EAC1B,QAAQ,EAAE,kBAAkB,EAC5B,GAAG,CAAC,EAAE,MAAM,GACV,oBAAoB,CAStB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC5B,UAAU,EAAE,cAAc,EAC1B,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,kBAAkB,EAAE,GAC7B,MAAM,GAAG,SAAS,CAcpB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,cAAc,EAAE,IAAI,EAAE,oBAAoB,GAAG,oBAAoB,CAMhH;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACtC,OAAO,EAAE,SAAS,CAAC;IAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAAC,QAAQ,EAAE,eAAe,EAAE,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAAC,EAAE,GACjG,cAAc,CAAC,CAAC,CAAC,CAiBnB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACxC,MAAM,EAAE,UAAU,GAAG,cAAc,EACnC,OAAO,EAAE;IAAE,UAAU,CAAC,EAAE,cAAc,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GAC1F,IAAI,CAIN"}