@aligndottech/connector-core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Align Technologies Ltd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/fetchers/confluence.d.ts

@@ -0,0 +1,9 @@
+import type { ConnectorFetcher, ConnectorFetcherOptions, FetcherItem } from '../types/fetcher.js';
+/**
+ * Read-only personal Confluence fetcher (API v2): pages the token can read.
+ * OAuth (cloudId) or basic-auth (domain+email). Author = the page author.
+ */
+export declare class ConfluenceFetcher implements ConnectorFetcher {
+    fetch(opts: ConnectorFetcherOptions): Promise<FetcherItem[]>;
+}
+//# sourceMappingURL=confluence.d.ts.map

package/dist/fetchers/confluence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confluence.d.ts","sourceRoot":"","sources":["../../src/fetchers/confluence.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAuClG;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,gBAAgB;IAClD,KAAK,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CA0DnE"}

package/dist/fetchers/confluence.js

@@ -0,0 +1,89 @@
+import { fetch } from 'undici';
+import { FetcherAuthError } from './errors.js';
+function stripHtml(html) {
+    return html.replace(/<[^>]+>/g, ' ').replace(/\s+/g, ' ').trim();
+}
+/** Resolve a Confluence accountId to a display name (cached). Degrades to undefined
+ *  if the token lacks read:confluence-user or the lookup fails. */
+function makeConfluenceUserResolver(base, headers) {
+    const cache = new Map();
+    return async (accountId) => {
+        if (!accountId)
+            return undefined;
+        if (cache.has(accountId))
+            return cache.get(accountId) ?? undefined;
+        try {
+            const res = await fetch(`${base}/rest/api/user?accountId=${encodeURIComponent(accountId)}`, { headers });
+            if (!res.ok) {
+                cache.set(accountId, null);
+                return undefined;
+            }
+            const u = (await res.json());
+            const name = u.displayName || u.publicName;
+            const resolved = name ? { name, ...(u.email ? { email: u.email } : {}) } : null;
+            cache.set(accountId, resolved);
+            return resolved ?? undefined;
+        }
+        catch {
+            cache.set(accountId, null);
+            return undefined;
+        }
+    };
+}
+/**
+ * Read-only personal Confluence fetcher (API v2): pages the token can read.
+ * OAuth (cloudId) or basic-auth (domain+email). Author = the page author.
+ */
+export class ConfluenceFetcher {
+    async fetch(opts) {
+        const cloudId = opts.cloudId;
+        const siteBase = opts.siteBase;
+        const email = opts.email;
+        const domain = opts.domain;
+        const isOAuth = Boolean(cloudId);
+        const base = isOAuth
+            ? `https://api.atlassian.com/ex/confluence/${cloudId}/wiki`
+            : `https://${domain}/wiki`;
+        const headers = isOAuth
+            ? { Authorization: `Bearer ${opts.token}`, Accept: 'application/json' }
+            : {
+                Authorization: `Basic ${Buffer.from(`${email}:${opts.token}`).toString('base64')}`,
+                Accept: 'application/json',
+            };
+        const limit = opts.limit ?? 50;
+        const url = `${base}/api/v2/pages?limit=${limit}&body-format=storage`;
+        const res = await fetch(url, { headers });
+        if (!res.ok) {
+            if (res.status === 401)
+                throw new FetcherAuthError('Confluence');
+            if (res.status === 403) {
+                throw new Error('Confluence access denied (403): the token lacks Confluence scopes or this site has no Confluence. ' +
+                    "Re-auth won't help - check the Atlassian app's Confluence API permissions (or skip Confluence).");
+            }
+            throw new Error(`Confluence API failed (${res.status}). ${isOAuth ? 'Check your OAuth token.' : 'Check your email, token, and domain.'}`);
+        }
+        const data = (await res.json());
+        const humanBase = isOAuth
+            ? (siteBase ?? `https://api.atlassian.com/ex/confluence/${cloudId}`)
+            : `https://${domain}`;
+        const linkBase = data._links?.base ?? `${humanBase}/wiki`;
+        const resolveUser = makeConfluenceUserResolver(base, headers);
+        const items = [];
+        for (const page of data.results ?? []) {
+            const bodyHtml = page.body?.storage?.value ?? '';
+            const bodyText = stripHtml(bodyHtml).slice(0, 2000);
+            const webui = page._links?.webui ?? '';
+            const pageUrl = webui.startsWith('http') ? webui : `${linkBase}${webui}`;
+            const author = await resolveUser(page.authorId);
+            items.push({
+                source_url: pageUrl,
+                platform: 'confluence',
+                raw_text: [page.title, bodyText].filter(Boolean).join('\n\n'),
+                title: page.title,
+                ...(author ? { author } : {}),
+            });
+        }
+        return items;
+    }
+}
+//# sourceMappingURL=confluence.js.map

package/dist/fetchers/confluence.js.map

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

package/dist/fetchers/errors.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Thrown by a fetcher when the provider returns 401 (token expired/revoked) -
+ * i.e. re-authenticating would help. Callers (e.g. the CLI) can catch this to
+ * trigger a reconnect flow, vs. a generic Error (403 / lacking scopes) where
+ * re-auth won't help.
+ */
+export declare class FetcherAuthError extends Error {
+    readonly connector: string;
+    constructor(connector: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/fetchers/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/fetchers/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;aACb,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM;CAI9C"}

package/dist/fetchers/errors.js

@@ -0,0 +1,15 @@
+/**
+ * Thrown by a fetcher when the provider returns 401 (token expired/revoked) -
+ * i.e. re-authenticating would help. Callers (e.g. the CLI) can catch this to
+ * trigger a reconnect flow, vs. a generic Error (403 / lacking scopes) where
+ * re-auth won't help.
+ */
+export class FetcherAuthError extends Error {
+    connector;
+    constructor(connector) {
+        super(`${connector} authentication expired or revoked`);
+        this.connector = connector;
+        this.name = 'FetcherAuthError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/fetchers/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/fetchers/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACb;IAA5B,YAA4B,SAAiB;QAC3C,KAAK,CAAC,GAAG,SAAS,oCAAoC,CAAC,CAAC;QAD9B,cAAS,GAAT,SAAS,CAAQ;QAE3C,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF"}

package/dist/fetchers/git.d.ts

@@ -0,0 +1,23 @@
+import type { ConnectorFetcher, ConnectorFetcherOptions, FetcherItem } from '../types/fetcher.js';
+import { type GitCommit } from './util/git.js';
+export type { GitCommit } from './util/git.js';
+/**
+ * The git I/O the {@link GitFetcher} needs, injected by the caller (e.g. the CLI
+ * wraps `git log` / `git remote` via execa). Keeps connector-core process-free.
+ */
+export interface GitCommitSource {
+    getCommitHistory(opts: {
+        limit: number;
+    }): Promise<GitCommit[]>;
+    getRemoteUrl(): Promise<string | null | undefined>;
+}
+/**
+ * Read-only local-git fetcher: maps decision-relevant commits to FetcherItems.
+ * Author = the commit author ("who to talk to"). `token` is unused (local).
+ */
+export declare class GitFetcher implements ConnectorFetcher {
+    private readonly source;
+    constructor(source: GitCommitSource);
+    fetch(opts: ConnectorFetcherOptions): Promise<FetcherItem[]>;
+}
+//# sourceMappingURL=git.d.ts.map

package/dist/fetchers/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/fetchers/git.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClG,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAEnF,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,gBAAgB,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAChE,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CACpD;AAED;;;GAGG;AACH,qBAAa,UAAW,YAAW,gBAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAE9C,KAAK,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAenE"}

package/dist/fetchers/git.js

@@ -0,0 +1,27 @@
+import { buildCommitUrl, formatCommitAsText } from './util/git.js';
+/**
+ * Read-only local-git fetcher: maps decision-relevant commits to FetcherItems.
+ * Author = the commit author ("who to talk to"). `token` is unused (local).
+ */
+export class GitFetcher {
+    source;
+    constructor(source) {
+        this.source = source;
+    }
+    async fetch(opts) {
+        const limit = opts.limit ?? 100;
+        const commits = await this.source.getCommitHistory({ limit });
+        const remoteUrl = await this.source.getRemoteUrl();
+        return commits.map((c) => {
+            const url = buildCommitUrl(remoteUrl, c.sha);
+            return {
+                source_url: url,
+                platform: 'git',
+                raw_text: formatCommitAsText(c, url),
+                title: c.subject,
+                ...(c.author ? { author: { name: c.author } } : {}),
+            };
+        });
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/fetchers/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/fetchers/git.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAkB,MAAM,eAAe,CAAC;AAanF;;;GAGG;AACH,MAAM,OAAO,UAAU;IACQ;IAA7B,YAA6B,MAAuB;QAAvB,WAAM,GAAN,MAAM,CAAiB;IAAG,CAAC;IAExD,KAAK,CAAC,KAAK,CAAC,IAA6B;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC;QAChC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9D,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;QACnD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACvB,MAAM,GAAG,GAAG,cAAc,CAAC,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;YAC7C,OAAO;gBACL,UAAU,EAAE,GAAG;gBACf,QAAQ,EAAE,KAAK;gBACf,QAAQ,EAAE,kBAAkB,CAAC,CAAC,EAAE,GAAG,CAAC;gBACpC,KAAK,EAAE,CAAC,CAAC,OAAO;gBAChB,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9B,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/fetchers/github.d.ts

@@ -0,0 +1,9 @@
+import type { ConnectorFetcher, ConnectorFetcherOptions, FetcherItem } from '../types/fetcher.js';
+/**
+ * Read-only personal GitHub fetcher: the caller's merged PRs and issues they
+ * commented on. Author = the PR/issue user ("who to talk to").
+ */
+export declare class GitHubFetcher implements ConnectorFetcher {
+    fetch(opts: ConnectorFetcherOptions): Promise<FetcherItem[]>;
+}
+//# sourceMappingURL=github.d.ts.map

package/dist/fetchers/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/fetchers/github.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAWlG;;;GAGG;AACH,qBAAa,aAAc,YAAW,gBAAgB;IAC9C,KAAK,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAwDnE"}

package/dist/fetchers/github.js

@@ -0,0 +1,53 @@
+import { fetch } from 'undici';
+/**
+ * Read-only personal GitHub fetcher: the caller's merged PRs and issues they
+ * commented on. Author = the PR/issue user ("who to talk to").
+ */
+export class GitHubFetcher {
+    async fetch(opts) {
+        const headers = {
+            Authorization: `Bearer ${opts.token}`,
+            Accept: 'application/vnd.github+json',
+            'X-GitHub-Api-Version': '2022-11-28',
+        };
+        const userRes = await fetch('https://api.github.com/user', { headers });
+        if (!userRes.ok) {
+            throw new Error(`GitHub auth failed (${userRes.status}). Check your token has 'repo' scope.`);
+        }
+        const user = (await userRes.json());
+        const limit = opts.limit ?? 100;
+        const items = [];
+        const prRes = await fetch(`https://api.github.com/search/issues?q=author:${user.login}+type:pr+is:merged&sort=updated&per_page=${Math.min(limit, 50)}`, { headers });
+        if (prRes.ok) {
+            const data = (await prRes.json());
+            for (const pr of data.items) {
+                const repo = (pr.repository_url ?? '').replace('https://api.github.com/repos/', '');
+                items.push({
+                    source_url: pr.html_url,
+                    platform: 'github',
+                    raw_text: `${pr.title}\n\n${pr.body ?? ''}\n\nStatus: ${pr.state}\nRepo: ${repo}`.trim(),
+                    title: pr.title,
+                    ...(pr.user ? { author: { name: pr.user.login, handle: pr.user.login, url: pr.user.html_url } } : {}),
+                });
+            }
+        }
+        if (items.length < limit) {
+            const remaining = Math.min(limit - items.length, 50);
+            const issueRes = await fetch(`https://api.github.com/search/issues?q=commenter:${user.login}+type:issue&sort=updated&per_page=${remaining}`, { headers });
+            if (issueRes.ok) {
+                const data = (await issueRes.json());
+                for (const issue of data.items) {
+                    items.push({
+                        source_url: issue.html_url,
+                        platform: 'github',
+                        raw_text: `${issue.title}\n\n${issue.body ?? ''}\n\nStatus: ${issue.state}`.trim(),
+                        title: issue.title,
+                        ...(issue.user ? { author: { name: issue.user.login, handle: issue.user.login, url: issue.user.html_url } } : {}),
+                    });
+                }
+            }
+        }
+        return items.slice(0, limit);
+    }
+}
+//# sourceMappingURL=github.js.map

package/dist/fetchers/github.js.map

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

package/dist/fetchers/gitlab.d.ts

@@ -0,0 +1,9 @@
+import type { ConnectorFetcher, ConnectorFetcherOptions, FetcherItem } from '../types/fetcher.js';
+/**
+ * Read-only personal GitLab fetcher: the caller's merged merge requests.
+ * `domain` (default gitlab.com) rides on the options index signature.
+ */
+export declare class GitLabFetcher implements ConnectorFetcher {
+    fetch(opts: ConnectorFetcherOptions): Promise<FetcherItem[]>;
+}
+//# sourceMappingURL=gitlab.d.ts.map

package/dist/fetchers/gitlab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlab.d.ts","sourceRoot":"","sources":["../../src/fetchers/gitlab.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AASlG;;;GAGG;AACH,qBAAa,aAAc,YAAW,gBAAgB;IAC9C,KAAK,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAgCnE"}

package/dist/fetchers/gitlab.js

@@ -0,0 +1,33 @@
+import { fetch } from 'undici';
+/**
+ * Read-only personal GitLab fetcher: the caller's merged merge requests.
+ * `domain` (default gitlab.com) rides on the options index signature.
+ */
+export class GitLabFetcher {
+    async fetch(opts) {
+        const domain = opts.domain ?? 'gitlab.com';
+        const base = `https://${domain}/api/v4`;
+        const headers = { Authorization: `Bearer ${opts.token}` };
+        const userRes = await fetch(`${base}/user`, { headers });
+        if (!userRes.ok) {
+            throw new Error(`GitLab auth failed (${userRes.status}). Check your token has 'read_api' scope.`);
+        }
+        const user = (await userRes.json());
+        const limit = opts.limit ?? 100;
+        const items = [];
+        const mrRes = await fetch(`${base}/merge_requests?author_id=${user.id}&state=merged&per_page=${Math.min(limit, 50)}&order_by=updated_at`, { headers });
+        if (mrRes.ok) {
+            const mrs = (await mrRes.json());
+            for (const mr of mrs) {
+                items.push({
+                    source_url: mr.web_url,
+                    platform: 'gitlab',
+                    raw_text: `${mr.title}\n\n${mr.description ?? ''}\n\nStatus: ${mr.state}`.trim(),
+                    title: mr.title,
+                });
+            }
+        }
+        return items.slice(0, limit);
+    }
+}
+//# sourceMappingURL=gitlab.js.map

package/dist/fetchers/gitlab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlab.js","sourceRoot":"","sources":["../../src/fetchers/gitlab.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAU/B;;;GAGG;AACH,MAAM,OAAO,aAAa;IACxB,KAAK,CAAC,KAAK,CAAC,IAA6B;QACvC,MAAM,MAAM,GAAI,IAAI,CAAC,MAA6B,IAAI,YAAY,CAAC;QACnE,MAAM,IAAI,GAAG,WAAW,MAAM,SAAS,CAAC;QACxC,MAAM,OAAO,GAAG,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;QAE1D,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,uBAAuB,OAAO,CAAC,MAAM,2CAA2C,CAAC,CAAC;QACpG,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,OAAO,CAAC,IAAI,EAAE,CAAmB,CAAC;QAEtD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC;QAChC,MAAM,KAAK,GAAkB,EAAE,CAAC;QAEhC,MAAM,KAAK,GAAG,MAAM,KAAK,CACvB,GAAG,IAAI,6BAA6B,IAAI,CAAC,EAAE,0BAA0B,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,sBAAsB,EAC9G,EAAE,OAAO,EAAE,CACZ,CAAC;QACF,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAyB,CAAC;YACzD,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;gBACrB,KAAK,CAAC,IAAI,CAAC;oBACT,UAAU,EAAE,EAAE,CAAC,OAAO;oBACtB,QAAQ,EAAE,QAAQ;oBAClB,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,WAAW,IAAI,EAAE,eAAe,EAAE,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE;oBAChF,KAAK,EAAE,EAAE,CAAC,KAAK;iBAChB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/fetchers/index.d.ts

@@ -0,0 +1,20 @@
+import type { ConnectorFetcher } from '../types/fetcher.js';
+export { GitHubFetcher } from './github.js';
+export { GitLabFetcher } from './gitlab.js';
+export { JiraFetcher } from './jira.js';
+export { ConfluenceFetcher } from './confluence.js';
+export { SlackFetcher } from './slack.js';
+export { TeamsFetcher } from './teams.js';
+export { ZoomFetcher } from './zoom.js';
+export { LinearFetcher } from './linear.js';
+export { NotionFetcher } from './notion.js';
+export { GitFetcher, type GitCommitSource, type GitCommit } from './git.js';
+export { buildCommitUrl, formatCommitAsText } from './util/git.js';
+export { FetcherAuthError } from './errors.js';
+/**
+ * Registry of token-based read-only fetchers, keyed by platform. The CLI and the
+ * gateway discover scan both resolve fetchers from here. `git` is not registered
+ * because it needs an injected {@link GitCommitSource} (local process I/O).
+ */
+export declare const FETCHERS: Record<string, () => ConnectorFetcher>;
+//# sourceMappingURL=index.d.ts.map

package/dist/fetchers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fetchers/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAW5D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,gBAAgB,CAU3D,CAAC"}

package/dist/fetchers/index.js

@@ -0,0 +1,38 @@
+import { GitHubFetcher } from './github.js';
+import { GitLabFetcher } from './gitlab.js';
+import { JiraFetcher } from './jira.js';
+import { ConfluenceFetcher } from './confluence.js';
+import { SlackFetcher } from './slack.js';
+import { TeamsFetcher } from './teams.js';
+import { ZoomFetcher } from './zoom.js';
+import { LinearFetcher } from './linear.js';
+import { NotionFetcher } from './notion.js';
+export { GitHubFetcher } from './github.js';
+export { GitLabFetcher } from './gitlab.js';
+export { JiraFetcher } from './jira.js';
+export { ConfluenceFetcher } from './confluence.js';
+export { SlackFetcher } from './slack.js';
+export { TeamsFetcher } from './teams.js';
+export { ZoomFetcher } from './zoom.js';
+export { LinearFetcher } from './linear.js';
+export { NotionFetcher } from './notion.js';
+export { GitFetcher } from './git.js';
+export { buildCommitUrl, formatCommitAsText } from './util/git.js';
+export { FetcherAuthError } from './errors.js';
+/**
+ * Registry of token-based read-only fetchers, keyed by platform. The CLI and the
+ * gateway discover scan both resolve fetchers from here. `git` is not registered
+ * because it needs an injected {@link GitCommitSource} (local process I/O).
+ */
+export const FETCHERS = {
+    github: () => new GitHubFetcher(),
+    gitlab: () => new GitLabFetcher(),
+    jira: () => new JiraFetcher(),
+    confluence: () => new ConfluenceFetcher(),
+    slack: () => new SlackFetcher(),
+    teams: () => new TeamsFetcher(),
+    zoom: () => new ZoomFetcher(),
+    linear: () => new LinearFetcher(),
+    notion: () => new NotionFetcher(),
+};
+//# sourceMappingURL=index.js.map

package/dist/fetchers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fetchers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAwC,MAAM,UAAU,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAA2C;IAC9D,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,aAAa,EAAE;IACjC,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,aAAa,EAAE;IACjC,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,WAAW,EAAE;IAC7B,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,iBAAiB,EAAE;IACzC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,YAAY,EAAE;IAC/B,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,YAAY,EAAE;IAC/B,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,WAAW,EAAE;IAC7B,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,aAAa,EAAE;IACjC,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,aAAa,EAAE;CAClC,CAAC"}

package/dist/fetchers/jira.d.ts

@@ -0,0 +1,9 @@
+import type { ConnectorFetcher, ConnectorFetcherOptions, FetcherItem } from '../types/fetcher.js';
+/**
+ * Read-only personal Jira fetcher: issues assigned to or reported by the caller.
+ * OAuth (cloudId) or basic-auth (domain+email). Author = the issue reporter.
+ */
+export declare class JiraFetcher implements ConnectorFetcher {
+    fetch(opts: ConnectorFetcherOptions): Promise<FetcherItem[]>;
+}
+//# sourceMappingURL=jira.d.ts.map

package/dist/fetchers/jira.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira.d.ts","sourceRoot":"","sources":["../../src/fetchers/jira.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAuBlG;;;GAGG;AACH,qBAAa,WAAY,YAAW,gBAAgB;IAC5C,KAAK,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CA8DnE"}

package/dist/fetchers/jira.js

@@ -0,0 +1,73 @@
+import { fetch } from 'undici';
+import { FetcherAuthError } from './errors.js';
+function extractAdfText(adf) {
+    if (!adf)
+        return '';
+    return (adf.content ?? [])
+        .flatMap((block) => (block.content ?? []).map((inline) => inline.text ?? ''))
+        .join(' ')
+        .trim();
+}
+/**
+ * Read-only personal Jira fetcher: issues assigned to or reported by the caller.
+ * OAuth (cloudId) or basic-auth (domain+email). Author = the issue reporter.
+ */
+export class JiraFetcher {
+    async fetch(opts) {
+        const cloudId = opts.cloudId;
+        const siteBase = opts.siteBase;
+        const email = opts.email;
+        const domain = opts.domain;
+        const isOAuth = Boolean(cloudId);
+        const base = isOAuth ? `https://api.atlassian.com/ex/jira/${cloudId}` : `https://${domain}`;
+        const headers = isOAuth
+            ? { Authorization: `Bearer ${opts.token}`, Accept: 'application/json' }
+            : {
+                Authorization: `Basic ${Buffer.from(`${email}:${opts.token}`).toString('base64')}`,
+                Accept: 'application/json',
+            };
+        const limit = opts.limit ?? 100;
+        const jql = 'assignee = currentUser() OR reporter = currentUser() ORDER BY updated DESC';
+        const res = await fetch(`${base}/rest/api/3/search/jql`, {
+            method: 'POST',
+            headers: { ...headers, 'Content-Type': 'application/json' },
+            body: JSON.stringify({ jql, maxResults: limit, fields: ['summary', 'description', 'status', 'key', 'reporter'] }),
+        });
+        if (!res.ok) {
+            if (res.status === 401)
+                throw new FetcherAuthError('Jira');
+            if (res.status === 403) {
+                throw new Error("Jira access denied (403): the token lacks Jira scopes or access. Re-auth won't help - " +
+                    "check the Atlassian app's Jira API permissions.");
+            }
+            const text = await res.text();
+            throw new Error(`Jira API failed (${res.status}): ${text.slice(0, 200)}`);
+        }
+        const data = (await res.json());
+        const browseBase = isOAuth ? (siteBase ?? `https://api.atlassian.com/ex/jira/${cloudId}`) : base;
+        return data.issues.map((issue) => {
+            const desc = extractAdfText(issue.fields.description);
+            return {
+                source_url: `${browseBase}/browse/${issue.key}`,
+                platform: 'jira',
+                raw_text: [
+                    `[${issue.key}] ${issue.fields.summary}`,
+                    desc,
+                    issue.fields.status?.name ? `Status: ${issue.fields.status.name}` : '',
+                ]
+                    .filter(Boolean)
+                    .join('\n\n'),
+                title: `[${issue.key}] ${issue.fields.summary}`,
+                ...(issue.fields.reporter?.displayName
+                    ? {
+                        author: {
+                            name: issue.fields.reporter.displayName,
+                            ...(issue.fields.reporter.emailAddress ? { email: issue.fields.reporter.emailAddress } : {}),
+                        },
+                    }
+                    : {}),
+            };
+        });
+    }
+}
+//# sourceMappingURL=jira.js.map

package/dist/fetchers/jira.js.map

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

package/dist/fetchers/linear.d.ts

@@ -0,0 +1,9 @@
+import type { ConnectorFetcher, ConnectorFetcherOptions, FetcherItem } from '../types/fetcher.js';
+/**
+ * Read-only personal Linear fetcher: the caller's assigned + created issues.
+ * Author = the issue creator ("who to talk to").
+ */
+export declare class LinearFetcher implements ConnectorFetcher {
+    fetch(opts: ConnectorFetcherOptions): Promise<FetcherItem[]>;
+}
+//# sourceMappingURL=linear.d.ts.map

package/dist/fetchers/linear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear.d.ts","sourceRoot":"","sources":["../../src/fetchers/linear.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAiClG;;;GAGG;AACH,qBAAa,aAAc,YAAW,gBAAgB;IAC9C,KAAK,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAgDnE"}

package/dist/fetchers/linear.js

@@ -0,0 +1,71 @@
+import { fetch } from 'undici';
+const LINEAR_GQL = 'https://api.linear.app/graphql';
+const ISSUES_QUERY = `
+query PersonalIssues($first: Int!) {
+  viewer {
+    assignedIssues(first: $first, orderBy: updatedAt) {
+      nodes {
+        id title description url
+        state { name }
+        team { name }
+        creator { name email }
+        comments { nodes { body user { name } } }
+      }
+    }
+    createdIssues(first: $first, orderBy: updatedAt) {
+      nodes { id title description url state { name } team { name } creator { name email } }
+    }
+  }
+}`;
+/**
+ * Read-only personal Linear fetcher: the caller's assigned + created issues.
+ * Author = the issue creator ("who to talk to").
+ */
+export class LinearFetcher {
+    async fetch(opts) {
+        const limit = opts.limit ?? 50;
+        const res = await fetch(LINEAR_GQL, {
+            method: 'POST',
+            headers: { Authorization: `Bearer ${opts.token}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify({ query: ISSUES_QUERY, variables: { first: limit } }),
+        });
+        if (!res.ok)
+            throw new Error(`Linear API failed (${res.status}). Check your personal API token.`);
+        const data = (await res.json());
+        if (data.errors?.length)
+            throw new Error(data.errors[0].message);
+        const seen = new Set();
+        const items = [];
+        const allIssues = [
+            ...(data.data.viewer.assignedIssues?.nodes ?? []),
+            ...(data.data.viewer.createdIssues?.nodes ?? []),
+        ];
+        for (const issue of allIssues) {
+            if (seen.has(issue.id))
+                continue;
+            seen.add(issue.id);
+            const comments = (issue.comments?.nodes ?? [])
+                .map((c) => `${c.user?.name ?? 'Unknown'}: ${c.body}`)
+                .join('\n');
+            items.push({
+                source_url: issue.url,
+                platform: 'linear',
+                raw_text: [
+                    issue.title,
+                    issue.description ?? '',
+                    issue.team?.name ? `Team: ${issue.team.name}` : '',
+                    issue.state?.name ? `Status: ${issue.state.name}` : '',
+                    comments ? `Comments:\n${comments}` : '',
+                ]
+                    .filter(Boolean)
+                    .join('\n\n'),
+                title: issue.title,
+                ...(issue.creator?.name
+                    ? { author: { name: issue.creator.name, ...(issue.creator.email ? { email: issue.creator.email } : {}) } }
+                    : {}),
+            });
+        }
+        return items.slice(0, limit);
+    }
+}
+//# sourceMappingURL=linear.js.map

package/dist/fetchers/linear.js.map

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