@framers/agentos-ext-github 0.7.0 → 0.8.0

package/dist/__tests__/refs.test.js

@@ -0,0 +1,420 @@
+/**
+ * @fileoverview A link's ref settled through GitHub's matching references, a tree planned with what it leaves out and
+ * why, and a repository's documentation listed and compared at a named branch or commit, over a fetch stand-in that
+ * answers a repository's branches, references and trees and records each request.
+ */
+import { generateKeyPairSync } from 'node:crypto';
+import { describe, expect, it } from 'vitest';
+import { DEFAULT_MAX_FILE_BYTES, GitHubApiError, GitHubAppCredential, GitHubDocumentsConnector, GitHubNoAnswer, IMAGE_EXTENSIONS, pathFilter, planTree, } from '../documents/index.js';
+/** A JSON answer. */
+function json(body, status = 200) {
+    return new Response(JSON.stringify(body), { status, headers: { 'content-type': 'application/json' } });
+}
+const BASE = 'https://stand-in.test';
+const INSTALLATION = 5;
+const HANDBOOK = { id: 77, fullName: 'acme-team/handbook', defaultBranch: 'main' };
+/** A repository with no commit yet: GitHub answers its references 409. */
+const EMPTY = { id: 80, fullName: 'acme-team/empty', defaultBranch: 'main' };
+const MAIN = '1'.repeat(40);
+const RELEASE = '2'.repeat(40);
+const RELEASE_10 = '3'.repeat(40);
+const RELEASE_NOTES = '4'.repeat(40);
+const DOCS_1 = '5'.repeat(40);
+/** The release branch's head after a push. */
+const RELEASE_NEXT = '6'.repeat(40);
+/** A commit a link pins. */
+const PINNED = '9f2c4e6a'.repeat(5);
+/** The handbook's branches by name. Git keeps no branch beside one under its name; the stand-in does, so the longest wins. */
+const BRANCHES = {
+    main: MAIN,
+    release: RELEASE,
+    'release/1.0': RELEASE_10,
+    'release-notes': RELEASE_NOTES,
+    'docs#1': DOCS_1,
+};
+/** The handbook's trees by commit. */
+const TREES = {
+    [MAIN]: [
+        { path: 'README.md', sha: 'r1', size: 120 },
+        { path: 'docs/agenda.md', sha: 'a1', size: 300 },
+    ],
+    [RELEASE]: [
+        { path: 'README.md', sha: 'r1', size: 120 },
+        { path: 'docs/agenda.md', sha: 'a2', size: 320 },
+        { path: 'docs/setup.md', sha: 's1', size: 200 },
+    ],
+    [RELEASE_NEXT]: [
+        { path: 'README.md', sha: 'r1', size: 120 },
+        { path: 'docs/agenda.md', sha: 'a3', size: 330 },
+    ],
+    [RELEASE_10]: [{ path: 'docs/setup.md', sha: 's10', size: 210 }],
+    [PINNED]: [
+        { path: 'README.md', sha: 'r0', size: 100 },
+        { path: 'docs/old.md', sha: 'o1', size: 50 },
+    ],
+};
+/** A stand-in GitHub holding the handbook and the empty repository. */
+function github() {
+    const seen = [];
+    const fetchImpl = async (input, init) => {
+        const href = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;
+        seen.push({ method: init?.method ?? 'GET', url: href, headers: new Headers(init?.headers) });
+        const url = new URL(href);
+        const path = url.pathname;
+        if (path === `/app/installations/${INSTALLATION}/access_tokens`) {
+            return json({ token: 'ghs_documents', expires_at: new Date(Date.now() + 3_600_000).toISOString() }, 201);
+        }
+        const matching = '/repositories/77/git/matching-refs/heads/';
+        if (path.startsWith(matching)) {
+            // GitHub answers every reference whose name starts with the one asked for.
+            const prefix = `refs/heads/${decodeURIComponent(path.slice(matching.length))}`;
+            const references = Object.entries(BRANCHES).map(([name, sha]) => ({ ref: `refs/heads/${name}`, object: { type: 'commit', sha } }));
+            return json(references.filter((reference) => reference.ref.startsWith(prefix)));
+        }
+        if (path.startsWith('/repositories/80/git/matching-refs/'))
+            return json({ message: 'Git Repository is empty.' }, 409);
+        const branches = '/repositories/77/branches/';
+        if (path.startsWith(branches)) {
+            const name = decodeURIComponent(path.slice(branches.length));
+            const sha = BRANCHES[name];
+            return sha === undefined ? json({ message: 'Branch not found' }, 404) : json({ name, commit: { sha } });
+        }
+        const trees = '/repositories/77/git/trees/';
+        const entries = path.startsWith(trees) && url.searchParams.get('recursive') === '1' ? TREES[path.slice(trees.length)] : undefined;
+        if (entries !== undefined) {
+            return json({ sha: path.slice(trees.length), truncated: false, tree: entries.map((entry) => ({ mode: '100644', type: 'blob', ...entry })) });
+        }
+        return json({ message: 'Not Found' }, 404);
+    };
+    return { fetchImpl, seen };
+}
+const keys = generateKeyPairSync('rsa', {
+    modulusLength: 2048,
+    publicKeyEncoding: { type: 'spki', format: 'pem' },
+    privateKeyEncoding: { type: 'pkcs1', format: 'pem' },
+});
+/** A connector to the handbook and the empty repository, on the stand-in. */
+function connectorOn(stand, filter = {}) {
+    const credential = new GitHubAppCredential({ clientId: 'Iv23liTESTCLIENT', privateKey: keys.privateKey }, stand.fetchImpl, BASE);
+    return new GitHubDocumentsConnector(credential, INSTALLATION, [HANDBOOK, EMPTY], filter, stand.fetchImpl, BASE);
+}
+/** The requests made other than for an installation token, as their paths and queries. */
+function reads(seen) {
+    return seen.filter((request) => !request.url.endsWith('/access_tokens')).map((request) => request.url.slice(BASE.length));
+}
+/** A plan as its paths and outcomes. */
+function outcomes(plan) {
+    return plan.map((planned) => [planned.path, planned.outcome]);
+}
+/** A blob of ten bytes, or of `size`. */
+function blob(path, size = 10) {
+    return { path, sha: `b-${path}`, size };
+}
+describe('resolveRef', () => {
+    it("settles a branch holding a slash with one request to GitHub's matching references, by the repository's id", async () => {
+        const stand = github();
+        expect(await connectorOn(stand).resolveRef(77, 'release/1.0/docs/setup.md')).toEqual({ ref: 'release/1.0', path: 'docs/setup.md', commit: false });
+        expect(reads(stand.seen)).toEqual(['/repositories/77/git/matching-refs/heads/release']);
+        const request = stand.seen.find((seen) => seen.url.includes('/matching-refs/'));
+        expect(request?.headers.get('authorization')).toBe('Bearer ghs_documents');
+        expect(request?.headers.get('x-github-api-version')).toBe('2026-03-10');
+    });
+    it('takes the longest branch that is the text or starts it at a slash, never one that only starts with the same letters', async () => {
+        const connector = connectorOn(github());
+        expect(await connector.resolveRef(77, 'main/docs')).toEqual({ ref: 'main', path: 'docs', commit: false });
+        expect(await connector.resolveRef(77, 'release/docs/setup.md')).toEqual({ ref: 'release', path: 'docs/setup.md', commit: false });
+        expect(await connector.resolveRef(77, 'release/1.0')).toEqual({ ref: 'release/1.0', path: '', commit: false });
+        expect(await connector.resolveRef(77, 'release-notes/2026.md')).toEqual({ ref: 'release-notes', path: '2026.md', commit: false });
+        // No branch starts with the segment: the segment alone is the ref, and the listing at it answers GitHub's 404.
+        expect(await connector.resolveRef(77, 'nightly/docs')).toEqual({ ref: 'nightly', path: 'docs', commit: false });
+    });
+    it('asks for the first segment encoded, so a branch holding a # is asked for whole', async () => {
+        const stand = github();
+        expect(await connectorOn(stand).resolveRef(77, 'docs#1/guide.md')).toEqual({ ref: 'docs#1', path: 'guide.md', commit: false });
+        expect(reads(stand.seen)).toEqual(['/repositories/77/git/matching-refs/heads/docs%231']);
+    });
+    it('takes a commit of 40 hexadecimal characters in either case, and HEAD as the default branch, with no request', async () => {
+        const stand = github();
+        const connector = connectorOn(stand);
+        expect(await connector.resolveRef(77, `${PINNED}/docs/old.md`)).toEqual({ ref: PINNED, path: 'docs/old.md', commit: true });
+        expect(await connector.resolveRef(77, `${PINNED.toUpperCase()}/docs`)).toEqual({ ref: PINNED, path: 'docs', commit: true });
+        expect(await connector.resolveRef(77, PINNED)).toEqual({ ref: PINNED, path: '', commit: true });
+        expect(await connector.resolveRef(77, 'HEAD/docs/agenda.md')).toEqual({ ref: 'main', path: 'docs/agenda.md', commit: false });
+        expect(stand.seen).toEqual([]);
+    });
+    it('refuses, before any request, a text with an empty, . or .. segment, a repository outside the link and an aborted call', async () => {
+        const stand = github();
+        const connector = connectorOn(stand);
+        for (const text of ['', '/main/docs', 'main/', 'main//docs', './docs', 'main/./docs', 'main/../secret', '..']) {
+            const failure = await connector.resolveRef(77, text).catch((error) => error);
+            expect(failure, text).toBeInstanceOf(TypeError);
+            expect(failure.message).not.toContain('secret');
+        }
+        await expect(connector.resolveRef(79, 'main/docs')).rejects.toThrow('repository 79 is not part of this link');
+        const aborted = await connector.resolveRef(77, '', AbortSignal.abort()).catch((error) => error);
+        expect(aborted).toBeInstanceOf(GitHubNoAnswer);
+        expect(aborted.reason).toBe('cancelled');
+        expect(stand.seen).toEqual([]);
+    });
+    it("throws GitHub's refusal of the references, never a ref it did not read", async () => {
+        const failure = await connectorOn(github())
+            .resolveRef(80, 'main/docs')
+            .catch((error) => error);
+        expect(failure).toBeInstanceOf(GitHubApiError);
+        expect(failure.status).toBe(409);
+    });
+});
+describe('planTree', () => {
+    const TREE = [
+        blob('src/index.ts', 50),
+        blob('README.md', 120),
+        blob('docs/big.md', 12 * 1024 * 1024),
+        blob('assets/logo.png', 4096),
+        blob('docs/budget.pdf', 2048),
+        blob('node_modules/x/README.md'),
+        blob('docs/agenda.md', 300),
+    ];
+    it('answers every file in path order: the documentation a note, the rest skipped with its reason', () => {
+        expect(outcomes(planTree(TREE))).toEqual([
+            ['README.md', 'note'],
+            ['assets/logo.png', { skipped: 'image' }],
+            ['docs/agenda.md', 'note'],
+            ['docs/big.md', { skipped: 'size' }],
+            ['docs/budget.pdf', 'note'],
+            ['node_modules/x/README.md', { skipped: 'folder' }],
+            ['src/index.ts', { skipped: 'code' }],
+        ]);
+        expect(planTree(TREE, { includeCode: true }).find((planned) => planned.path === 'src/index.ts')?.outcome).toBe('note');
+    });
+    it('tells code left out from code a tool wrote, a file of no kind it reads, and a code file past its own bound', () => {
+        const blobs = [
+            blob('package.json'),
+            blob('config/settings.yaml'),
+            blob('LICENSE'),
+            blob('web/app.min.js'),
+            blob('web/app.js'),
+            blob('src/huge.ts', 2_000_000),
+            blob('docs/long.md', 2_000_000),
+        ];
+        expect(outcomes(planTree(blobs))).toEqual([
+            ['LICENSE', { skipped: 'kind' }],
+            ['config/settings.yaml', { skipped: 'kind' }],
+            ['docs/long.md', 'note'],
+            ['package.json', { skipped: 'kind' }],
+            ['src/huge.ts', { skipped: 'code' }],
+            ['web/app.js', { skipped: 'code' }],
+            ['web/app.min.js', { skipped: 'code' }],
+        ]);
+        expect(outcomes(planTree(blobs, { includeCode: true, maxCodeBytes: 1_048_576 }))).toEqual([
+            ['LICENSE', { skipped: 'kind' }],
+            ['config/settings.yaml', { skipped: 'kind' }],
+            ['docs/long.md', 'note'],
+            ['package.json', { skipped: 'kind' }],
+            ['src/huge.ts', { skipped: 'size' }],
+            ['web/app.js', 'note'],
+            ['web/app.min.js', { skipped: 'generated' }],
+        ]);
+    });
+    it('bounds a code file by maxCodeBytes while code is asked for, even when the filter names its extension as documentation', () => {
+        const blobs = [blob('docs/guide.md', 2_000_000), blob('src/huge.ts', 2_000_000), blob('src/small.ts', 100)];
+        const filter = { extensions: ['.md', '.ts'], maxCodeBytes: 1_048_576 };
+        expect(outcomes(planTree(blobs, { ...filter, includeCode: true }))).toEqual([
+            ['docs/guide.md', 'note'],
+            ['src/huge.ts', { skipped: 'size' }],
+            ['src/small.ts', 'note'],
+        ]);
+        // Without code asked for, an extension the filter names is documentation alone, under maxFileBytes.
+        expect(outcomes(planTree(blobs, filter))).toEqual([
+            ['docs/guide.md', 'note'],
+            ['src/huge.ts', 'note'],
+            ['src/small.ts', 'note'],
+        ]);
+    });
+    it('keeps the documentation first under the file count and the code in the room left, the rest past the count', () => {
+        const blobs = [blob('api/a.ts'), blob('api/b.ts'), blob('app/c.py'), blob('docs/guide.md'), blob('docs/z.md')];
+        expect(outcomes(planTree(blobs, { includeCode: true, maxFiles: 3 }))).toEqual([
+            ['api/a.ts', 'note'],
+            ['api/b.ts', { skipped: 'count' }],
+            ['app/c.py', { skipped: 'count' }],
+            ['docs/guide.md', 'note'],
+            ['docs/z.md', 'note'],
+        ]);
+        expect(outcomes(planTree(blobs, { maxFiles: 1 }))).toEqual([
+            ['api/a.ts', { skipped: 'code' }],
+            ['api/b.ts', { skipped: 'code' }],
+            ['app/c.py', { skipped: 'code' }],
+            ['docs/guide.md', 'note'],
+            ['docs/z.md', { skipped: 'count' }],
+        ]);
+    });
+    it('answers as notes exactly what pathFilter keeps under the same filter', () => {
+        const blobs = [
+            ...TREE,
+            blob('web/app.min.js'),
+            blob('web/app.js'),
+            blob('docs/x.min.js'),
+            blob('package.json'),
+            blob('vendor/y.md'),
+            blob('src/big.ts', DEFAULT_MAX_FILE_BYTES + 1),
+            ...Array.from({ length: 6 }, (_, index) => blob(`notes/n${index}.md`)),
+            ...Array.from({ length: 6 }, (_, index) => blob(`lib/m${index}.py`)),
+        ];
+        const filters = [
+            {},
+            { includeCode: true },
+            { maxFiles: 4 },
+            { includeCode: true, maxFiles: 9 },
+            { includeCode: true, maxFiles: 12 },
+            { extensions: ['.md', '.js'] },
+            { includeCode: true, extensions: ['.md', '.js'] },
+            { skipFolders: [] },
+            { maxFileBytes: 100 },
+        ];
+        for (const filter of filters) {
+            const notes = planTree(blobs, filter)
+                .filter((planned) => planned.outcome === 'note')
+                .map(({ path, sha, size }) => ({ path, sha, size }));
+            expect(notes, JSON.stringify(filter)).toEqual(pathFilter(filter)(blobs));
+        }
+    });
+    it('reads the image extensions it is given, and keeps as documentation any extension the filter names', () => {
+        const blobs = [blob('art/cover.png'), blob('art/scan.jxl')];
+        expect(outcomes(planTree(blobs))).toEqual([
+            ['art/cover.png', { skipped: 'image' }],
+            ['art/scan.jxl', { skipped: 'kind' }],
+        ]);
+        expect(outcomes(planTree(blobs, { imageExtensions: ['.JXL'] }))).toEqual([
+            ['art/cover.png', { skipped: 'kind' }],
+            ['art/scan.jxl', { skipped: 'image' }],
+        ]);
+        expect(outcomes(planTree(blobs, { extensions: ['.png'] }))).toEqual([
+            ['art/cover.png', 'note'],
+            ['art/scan.jxl', { skipped: 'kind' }],
+        ]);
+        expect(IMAGE_EXTENSIONS).toContain('.svg');
+    });
+    it('answers new objects holding the path, the sha, the size and the outcome alone, and refuses a code bound that is not a size', () => {
+        const held = { path: 'README.md', sha: 'r1', size: 120, mode: '100644' };
+        expect(planTree([held])).toEqual([{ path: 'README.md', sha: 'r1', size: 120, outcome: 'note' }]);
+        for (const maxCodeBytes of [-1, Number.NaN, 1.5, Number.POSITIVE_INFINITY]) {
+            expect(() => planTree([], { maxCodeBytes }), String(maxCodeBytes)).toThrow(TypeError);
+        }
+    });
+});
+describe('the listing at a named branch or commit', () => {
+    it("lists the head of the branch at names, a slash in its name included, and a commit with no branch read", async () => {
+        const stand = github();
+        const connector = connectorOn(stand);
+        expect(await connector.list({ ids: ['77'], at: 'release' })).toEqual({
+            items: [
+                { id: '77:README.md', title: 'README.md', size: 120, version: `r1@${RELEASE}` },
+                { id: '77:docs/agenda.md', title: 'docs/agenda.md', size: 320, version: `a2@${RELEASE}` },
+                { id: '77:docs/setup.md', title: 'docs/setup.md', size: 200, version: `s1@${RELEASE}` },
+            ],
+            gone: [],
+        });
+        expect((await connector.list({ ids: ['77'], at: 'release/1.0' })).items).toEqual([
+            { id: '77:docs/setup.md', title: 'docs/setup.md', size: 210, version: `s10@${RELEASE_10}` },
+        ]);
+        expect((await connector.list({ ids: ['77'], at: PINNED.toUpperCase() })).items).toEqual([
+            { id: '77:README.md', title: 'README.md', size: 100, version: `r0@${PINNED}` },
+            { id: '77:docs/old.md', title: 'docs/old.md', size: 50, version: `o1@${PINNED}` },
+        ]);
+        expect(reads(stand.seen)).toEqual([
+            '/repositories/77/branches/release',
+            `/repositories/77/git/trees/${RELEASE}?recursive=1`,
+            '/repositories/77/branches/release%2F1.0',
+            `/repositories/77/git/trees/${RELEASE_10}?recursive=1`,
+            `/repositories/77/git/trees/${PINNED}?recursive=1`,
+        ]);
+    });
+    it("compares at the head of the branch at names when no push names a commit", async () => {
+        const stand = github();
+        const changes = await connectorOn(stand).changesSince(JSON.stringify({ 'README.md': 'r1' }), { ids: ['77'], at: 'release' });
+        expect(changes.changed.map((item) => item.version)).toEqual([`a2@${RELEASE}`, `s1@${RELEASE}`]);
+        expect(changes.gone).toEqual([]);
+        expect(reads(stand.seen)).toEqual(['/repositories/77/branches/release', `/repositories/77/git/trees/${RELEASE}?recursive=1`]);
+    });
+    it('compares a push to the branch at names, and answers a push to any other branch, the default included, with no change and no request', async () => {
+        const stand = github();
+        const connector = connectorOn(stand);
+        const previous = JSON.stringify({ 'README.md': 'r1', 'docs/agenda.md': 'a2', 'docs/setup.md': 's1' });
+        const changes = await connector.changesSince(previous, { ids: ['77'], at: 'release', ref: 'refs/heads/release', after: RELEASE_NEXT });
+        expect(changes.changed).toEqual([{ id: '77:docs/agenda.md', title: 'docs/agenda.md', size: 330, version: `a3@${RELEASE_NEXT}` }]);
+        expect(changes.gone).toEqual([{ id: '77:docs/setup.md', reason: 'removed' }]);
+        expect(reads(stand.seen)).toEqual([`/repositories/77/git/trees/${RELEASE_NEXT}?recursive=1`]);
+        const before = stand.seen.length;
+        expect(await connector.changesSince(previous, { ids: ['77'], at: 'release', ref: 'refs/heads/main', after: MAIN })).toEqual({ changed: [], gone: [], cursor: previous });
+        expect(await connector.changesSince(previous, { ids: ['77'], at: 'release/1.0', ref: 'refs/heads/release', after: RELEASE_NEXT })).toEqual({
+            changed: [],
+            gone: [],
+            cursor: previous,
+        });
+        expect(stand.seen.length).toBe(before);
+    });
+    it('compares a commit at itself, so a push never changes it, and refuses an after naming another commit', async () => {
+        const stand = github();
+        const connector = connectorOn(stand);
+        const cursor = JSON.stringify({ 'README.md': 'r0', 'docs/old.md': 'o1' });
+        expect(await connector.changesSince(cursor, { ids: ['77'], at: PINNED })).toEqual({ changed: [], gone: [], cursor });
+        expect(await connector.changesSince(null, { ids: ['77'], at: PINNED.toUpperCase(), after: PINNED })).toEqual({
+            changed: [
+                { id: '77:README.md', title: 'README.md', size: 100, version: `r0@${PINNED}` },
+                { id: '77:docs/old.md', title: 'docs/old.md', size: 50, version: `o1@${PINNED}` },
+            ],
+            gone: [],
+            cursor,
+        });
+        expect(reads(stand.seen)).toEqual([`/repositories/77/git/trees/${PINNED}?recursive=1`, `/repositories/77/git/trees/${PINNED}?recursive=1`]);
+        const before = stand.seen.length;
+        expect(await connector.changesSince(cursor, { ids: ['77'], at: PINNED, ref: 'refs/heads/main', after: MAIN })).toEqual({ changed: [], gone: [], cursor });
+        await expect(connector.changesSince(cursor, { ids: ['77'], at: PINNED, after: MAIN })).rejects.toBeInstanceOf(TypeError);
+        expect(stand.seen.length).toBe(before);
+    });
+    it('reads head at a named branch or commit, and at the default branch when handed a signal alone as before', async () => {
+        const stand = github();
+        const connector = connectorOn(stand);
+        expect(await connector.head(77, 'release/1.0')).toBe(RELEASE_10);
+        expect(await connector.head(77, PINNED.toUpperCase())).toBe(PINNED);
+        expect(await connector.head(77)).toBe(MAIN);
+        expect(await connector.head(77, new AbortController().signal)).toBe(MAIN);
+        expect(await connector.head(77, undefined, new AbortController().signal)).toBe(MAIN);
+        expect(reads(stand.seen)).toEqual([
+            '/repositories/77/branches/release%2F1.0',
+            '/repositories/77/branches/main',
+            '/repositories/77/branches/main',
+            '/repositories/77/branches/main',
+        ]);
+    });
+    it('refuses, before any request, an at that is neither a branch name nor a commit, and an at over other than one repository', async () => {
+        const stand = github();
+        const connector = connectorOn(stand);
+        const names = ['', 'feature..x', 'feature x', '-x', 'HEAD', '@', 'release/', '/release', 'release//1.0', 'x.lock', 'docs/.hidden', 'end.'];
+        for (const at of [...names, 'a~1', 'a^', 'a:b', 'a?', 'a*', 'a[1]', 'a\\b', 'a@{1}', 'a\tb']) {
+            await expect(connector.list({ ids: ['77'], at }), at).rejects.toBeInstanceOf(TypeError);
+            await expect(connector.changesSince(null, { ids: ['77'], at }), at).rejects.toBeInstanceOf(TypeError);
+            await expect(connector.head(77, at), at).rejects.toBeInstanceOf(TypeError);
+        }
+        await expect(connector.list({ ids: ['77', '80'], at: 'release' })).rejects.toBeInstanceOf(TypeError);
+        await expect(connector.list({ ids: [], at: 'release' })).rejects.toBeInstanceOf(TypeError);
+        expect(stand.seen).toEqual([]);
+    });
+    it('answers an aborted call cancelled before it checks at', async () => {
+        const stand = github();
+        const connector = connectorOn(stand);
+        const aborted = AbortSignal.abort();
+        const calls = [
+            () => connector.list({ ids: ['77'], at: '' }, aborted),
+            () => connector.changesSince(null, { ids: ['77'], at: '' }, aborted),
+            () => connector.head(77, '', aborted),
+            () => connector.head(77, 'release', aborted),
+        ];
+        for (const call of calls) {
+            const failure = await call().catch((error) => error);
+            expect(failure).toBeInstanceOf(GitHubNoAnswer);
+            expect(failure.reason).toBe('cancelled');
+        }
+        expect(stand.seen).toEqual([]);
+    });
+});
+//# sourceMappingURL=refs.test.js.map

package/dist/__tests__/refs.test.js.map

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

package/dist/documents/GitHubDocumentsConnector.d.ts

@@ -1,8 +1,9 @@
 /**
  * @fileoverview A repository's documentation as account sources, read through a GitHub App's installation: each
- * repository read by its id, its tree read once a commit within a request budget, the documentation kept by a filter,
- * each file read as raw bytes under a cap, and a push compared by the tree at its `after` commit. A selection, an item
- * or a call it cannot answer whole is refused before any request.
+ * repository read by its id at its default branch or at a named branch or commit, its tree read once a commit within a
+ * request budget, the documentation kept by a filter, each file read as raw bytes under a cap, a push compared by the
+ * tree at its `after` commit, and a link's ref settled where a branch name holds a slash. A selection, an item or a
+ * call it cannot answer whole is refused before any request.
  * @module agentos-ext-github/documents/GitHubDocumentsConnector
  */
 import { type AccountSourceConnector, type SourceChanges, type SourceGone, type SourceItem, type SourceRead, type SourceSelection } from '@framers/agentos-ext-account-sources';
@@ -16,17 +17,40 @@ export interface LinkedRepository {
     fullName: string;
     defaultBranch: string;
 }
+/** What `list` reads: the repositories (`ids`), and the branch or commit a listing is made at. */
+export interface GitHubListSelection extends SourceSelection {
+    /**
+     * A branch name, or a commit as 40 hexadecimal characters in either case, the listing is made at: the branch's head,
+     * or the commit itself. The default branch's head when absent. Given, the selection names one repository.
+     */
+    at?: string;
+}
 /**
- * What `changesSince` compares: one repository (`ids` holds its id alone), and from a push its `after` commit and its
- * `ref`, with the listing at `after` when the caller holds it.
+ * What `changesSince` compares: one repository (`ids` holds its id alone), the branch or commit the comparison follows
+ * (`at`), and from a push its `after` commit and its `ref`, with the listing at `after` when the caller holds it.
  */
-export interface GitHubChangesSelection extends SourceSelection {
-    /** The commit to compare at; the default branch's head when absent. */
+export interface GitHubChangesSelection extends GitHubListSelection {
+    /** The commit to compare at; the head of the branch `at` names when absent, or `at` itself when it is a commit. */
     after?: string;
-    /** The push's ref, such as `refs/heads/main`; a push to another branch than the default changes nothing. */
+    /** The push's ref, such as `refs/heads/main`; a push to another branch than the one followed changes nothing. */
     ref?: string;
     /** The documentation's listing at `after`, which spares the tree's read; taken only with the `after` it was read at. */
     listing?: readonly TreeBlob[];
+    /**
+     * A branch name, or a commit as 40 hexadecimal characters, the listing and the comparison are made at; the default
+     * branch's head when absent. A push's `ref` is read against `refs/heads/<at>` when `at` is a branch; a commit never
+     * changes, so a push answers no change and an `after` naming another commit is refused.
+     */
+    at?: string;
+}
+/** The ref and the path a link's `<ref>/<path>` text names, as `resolveRef` settles them. */
+export interface ResolvedRef {
+    /** The branch's name, or the commit in lower case. */
+    ref: string;
+    /** The path under the ref, with no leading or trailing slash; `''` for the ref's root. */
+    path: string;
+    /** True when `ref` is a commit, which never moves. */
+    commit: boolean;
 }
 /**
  * A repository's documentation as account sources: an item's id is `<repositoryId>:<path>`, its version
@@ -34,8 +58,13 @@ export interface GitHubChangesSelection extends SourceSelection {
  * read. A repository id is a positive integer in decimal. A call whose signal is already aborted throws
  * `GitHubNoAnswer` (`cancelled`) before it checks anything else. What a call cannot answer whole then throws before any
  * request: a `TypeError` for an id that is not a repository id, a repository named twice, an item id that names no
- * file or a change set of other than one repository, and an `Error` for a repository outside the link. An
- * installation is removed by the app's own call (`uninstallInstallation`), never by a link's connector.
+ * file, a change set of other than one repository, an `at` that is neither a branch name nor a commit or that names
+ * other than one repository, and a link's text with an empty, `.` or `..` segment, and an `Error` for a repository
+ * outside the link. An installation is removed by the app's own call (`uninstallInstallation`), never by a link's
+ * connector.
+ *
+ * A listing and a comparison follow the default branch, or the branch or commit a selection's `at` names: a branch's
+ * head is read when the call is made, a commit is read as it is and never changes.
  *
  * Every read addresses a linked repository by its id (`/repositories/<id>/...`, where GitHub's own redirects for a
  * renamed or moved repository lead), never by its name. A name can come to mean another repository (a renamed
@@ -67,8 +96,16 @@ export declare class GitHubDocumentsConnector implements AccountSourceConnector
     private token;
     /** A linked repository's address under the API, by its id. */
     private address;
+    /** The head commit of a branch of a linked repository, its name encoded as one segment of the address. */
+    private branchHead;
     /** The head commit of a repository's default branch. */
     head(repositoryId: number, signal?: AbortSignal): Promise<string>;
+    /**
+     * The head commit of the branch `at` names, the default branch's when `at` is undefined; for a commit of 40
+     * hexadecimal characters, the commit itself in lower case, with no request. An `at` that is neither throws a
+     * `TypeError` before any request; a branch the repository does not have throws GitHub's 404 as `GitHubApiError`.
+     */
+    head(repositoryId: number, at: string | undefined, signal?: AbortSignal): Promise<string>;
     /**
      * The documentation files of a repository at a commit: its tree read once within the request budget, never walking
      * a skipped folder, then filtered. A caller keeps it for that commit and hands it to `changesSince` with that commit
@@ -76,11 +113,14 @@ export declare class GitHubDocumentsConnector implements AccountSourceConnector
      */
     listing(repositoryId: number, commit: string, signal?: AbortSignal): Promise<TreeBlob[]>;
     /**
-     * The documentation of each selected repository (its id in `ids`) at its default branch's head. Every id is checked
-     * before any repository is read, so a selection is listed whole or not at all: an id that is not a repository id, or
-     * a repository named twice, throws a `TypeError`, and a repository outside the link an `Error`.
+     * The documentation of each selected repository (its id in `ids`) at its default branch's head, or of one repository
+     * at the branch or commit `at` names: the branch's head, or the commit itself with no branch read. Every id and `at`
+     * are checked before any repository is read, so a selection is listed whole or not at all: an id that is not a
+     * repository id, a repository named twice, an `at` that is neither a branch name nor a commit, and an `at` beside
+     * other than one repository throw a `TypeError`, and a repository outside the link an `Error`. A selection's other
+     * fields are `changesSince`'s, and a listing reads none of them.
      */
-    list(selection: SourceSelection, signal?: AbortSignal): Promise<{
+    list(selection: GitHubListSelection, signal?: AbortSignal): Promise<{
         items: SourceItem[];
         gone: SourceGone[];
     }>;
@@ -101,11 +141,28 @@ export declare class GitHubDocumentsConnector implements AccountSourceConnector
      * none) against the blobs read before (`cursor`: the JSON of each path's blob). A push's own commit lists are never
      * read, so a force push, or a push of more commits than its event lists, is read like any other. A cursor this
      * connector did not answer throws a `TypeError` before any request, whatever the push's branch, and so does a
-     * selection of other than one repository, or a `listing` without the `after` commit it was read at: call it once
-     * per repository, each with that repository's cursor. A push to another branch than the default answers no change
-     * and the cursor it was given.
+     * selection of other than one repository, a `listing` without the `after` commit it was read at, or an `at` that is
+     * neither a branch name nor a commit: call it once per repository, each with that repository's cursor.
+     *
+     * The comparison follows the default branch, or the branch or commit `at` names. Without `after` it is made at the
+     * followed branch's head, or at the commit. A push to another branch than the one followed answers no change and the
+     * cursor it was given, and so does any push when `at` is a commit, which never changes; without a push, an `after`
+     * naming another commit than `at`'s throws a `TypeError` before any request.
      */
     changesSince(cursor: string | null, selection: GitHubChangesSelection, signal?: AbortSignal): Promise<SourceChanges>;
+    /**
+     * The ref and the path of a folder's or a file's `<ref>/<path>` text (`parseGitHubLink`'s `refAndPath`), whose
+     * branch name may hold a slash. A first segment of 40 hexadecimal characters is a commit, in lower case, and `HEAD`
+     * the default branch (git names no branch `HEAD`), each settled with no request. Otherwise one request to GitHub's
+     * matching references (`/repositories/<id>/git/matching-refs/heads/<first segment>`, under an installation token
+     * narrowed to the repository), which answers every branch whose name starts with that segment
+     * (https://docs.github.com/en/rest/git/refs#list-matching-references): the longest branch name that is the text, or
+     * starts it at a slash, is the ref and the rest the path, and the first segment alone when none is longer. A first
+     * segment no branch has is answered as the ref all the same, and a listing at it then answers GitHub's 404. A text
+     * with an empty, `.` or `..` segment throws a `TypeError` that quotes none of it, before any request; GitHub's
+     * refusal of the read, such as 409 for a repository with no commit, throws `GitHubApiError`.
+     */
+    resolveRef(repositoryId: number, refAndPath: string, signal?: AbortSignal): Promise<ResolvedRef>;
     /** Nothing to end here: an installation is removed by the app's own call (`uninstallInstallation`). */
     revoke(): Promise<void>;
 }