@ankhorage/repository 0.4.18 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,148 @@
 # @ankhorage/repository
 
+## 0.5.0
+
+### Minor Changes
+
+- 106bc0d: Add read-only GitHub repository materialization with exact revision pinning and an Ankh CLI command.
+
+### Patch Changes
+
+- 3bbeb8e: Document repository usage from the runnable example and keep Renovate configuration out of package documentation.
+- 0b57e77: Update dependencies from Renovate pull request #117.
+- 0d371cc: Update dependencies from Renovate pull request #118.
+- c4f17c1: Update dependencies: `@ankhorage/devtools`.
+- 8b31cc8: Update dependencies from Renovate pull request #137.
+- 83103d9: Update dependencies from Renovate pull request #138.
+- 3257db7: Update Ankhorage dependencies: `@ankhorage/contracts`.
+- 01c01e2: Update dependencies: `ignore`.
+- a7f79f8: Update Renovate-managed workflows.
+- 9c0766d: Update dependencies: `@types/node`.
+- 3f5743e: Update dependencies: `@ankhorage/contracts`.
+- 97578a9: Update dependencies: `@ankhorage/contracts`.
+- f5afeaa: Update Renovate-managed workflows.
+- d8f5437: Update dependencies: `@ankhorage/contracts`.
+- d70430a: Update Renovate-managed workflows.
+- be3886b: Update dependencies: `@ankhorage/contracts`.
+- f44f522: Update Renovate-managed workflows.
+- 9ac27b8: Update dependencies: `@ankhorage/contracts`.
+- 6e88cf0: Update Renovate-managed workflows.
+- 1304e5a: Update dependencies: `@ankhorage/contracts`.
+- e0614c0: Update dependencies: `@ankhorage/contracts`.
+- 290b073: Update Renovate-managed workflows.
+- cf47a85: Update dependencies: `@ankhorage/contracts`.
+- c4e2a83: Update Renovate-managed workflows.
+- 5138514: Update dependencies: `@ankhorage/contracts`.
+- 8839f8a: Update Renovate-managed workflows.
+- 2035fef: Update dependencies: `@ankhorage/contracts`.
+- 8ea58b4: Update Renovate-managed workflows.
+- a08a558: Update dependencies: `@ankhorage/contracts`.
+- b066dba: Update Renovate-managed workflows.
+- af63db9: Update dependencies: `@ankhorage/contracts`.
+- 0a3d958: Update dependencies: `@ankhorage/contracts`.
+- 74305c4: Update Renovate-managed workflows.
+- 69236ac: Update Renovate-managed workflows.
+- 6e935e9: Update dependencies: `@ankhorage/contracts`.
+- d0cb3e2: Update Renovate-managed workflows.
+- b815d04: Update dependencies: `@ankhorage/contracts`.
+- 7766b0b: Update dependencies: `@ankhorage/contracts`.
+- f1926c2: Update Renovate-managed workflows.
+- 5179e03: Update dependencies: `@ankhorage/contracts`.
+- 566b70d: Update dependencies: `@ankhorage/contracts`, `@ankhorage/paradox`.
+- 90fb9a4: Update Renovate-managed workflows.
+- 150e54a: Update dependencies: `@ankhorage/contracts`.
+- 066c896: Update Renovate-managed workflows.
+- b042cbb: Update dependencies: `@ankhorage/contracts`, `@ankhorage/paradox`.
+- 83c7bdd: Update Renovate-managed workflows.
+- db6ec1b: Update dependencies: `@ankhorage/contracts`.
+- 242a3b9: Update dependencies: `@ankhorage/contracts`.
+- 9f5fea6: Update Renovate-managed workflows.
+- 5b08df0: Update dependencies: `@ankhorage/contracts`.
+- ae96fc6: Update dependencies: `@ankhorage/paradox`.
+- 717644a: Update Renovate-managed workflows.
+- bc598fc: Update Renovate-managed workflows.
+- 3ded140: Update dependencies: `@ankhorage/contracts`, `@ankhorage/paradox`.
+- 6c1463c: Update dependencies: `@ankhorage/contracts`.
+- 0ce4a32: Update Renovate-managed workflows.
+- 0c79dc4: Update dependencies: `@ankhorage/contracts`, `@ankhorage/paradox`.
+- 74b7765: Update Renovate-managed workflows.
+- 8ad0a42: Update dependencies: `@types/node`.
+- 2e8384b: Update dependencies: `@ankhorage/contracts`.
+- b360a77: Update Renovate-managed workflows.
+- 78f904e: Update dependencies: `@ankhorage/contracts`, `@ankhorage/paradox`.
+- f3a4be9: Update Renovate-managed workflows.
+- e12e937: Update dependencies: `@ankhorage/contracts`, `@ankhorage/paradox`.
+- 17e4584: Update dependencies: `@ankhorage/contracts`.
+- c9b7a2e: Update Renovate-managed workflows.
+- 36039c1: Update dependencies: `@ankhorage/contracts`, `@ankhorage/paradox`.
+- c759709: Update dependencies: `@ankhorage/contracts`.
+- 6c88cda: Update Renovate-managed workflows.
+- 12c94c8: Update dependencies: `@ankhorage/contracts`, `@ankhorage/paradox`.
+- 4557b07: Update Renovate-managed workflows.
+- aadddcc: Update dependencies: `@ankhorage/contracts`.
+- f19e997: Update Renovate-managed workflows.
+- 3d6153a: Update dependencies: `@ankhorage/contracts`, `@ankhorage/paradox`.
+- e0b87b6: Update Renovate-managed workflows.
+- 97027ad: Update dependencies: `@ankhorage/contracts`, `@ankhorage/paradox`.
+- 761a722: Update Renovate-managed workflows.
+- 4976f9f: Update dependencies: `@ankhorage/contracts`, `@ankhorage/paradox`.
+- 1f13104: Update Renovate-managed workflows.
+- f0ebf5d: Update dependencies: `@ankhorage/contracts`.
+- c63ebe8: Update Renovate-managed workflows.
+- ec40f4b: Update dependencies: `@ankhorage/contracts`, `@ankhorage/paradox`.
+- bd684b9: Update Renovate-managed workflows.
+- 7a3aabe: Update dependencies: `@ankhorage/contracts`.
+- 58e37f5: Update dependencies: `@ankhorage/contracts`.
+- 6239f66: Update Renovate-managed workflows.
+- 1f1bf1b: Update dependencies: `@ankhorage/contracts`.
+- 07cf4f4: Update Renovate-managed workflows.
+- 4d8adf8: Update Renovate-managed workflows.
+- 822721a: Update dependencies: `@ankhorage/contracts`.
+- 6ddbbcc: Update Renovate-managed workflows.
+- 08a1083: Update dependencies: `@ankhorage/contracts`, `@ankhorage/paradox`.
+- 2cbfb10: Update Renovate-managed workflows.
+- 841d59a: Update Renovate-managed workflows.
+- 8250839: Update dependencies: `@ankhorage/contracts`.
+- d1dad6f: Update Renovate-managed workflows.
+- 3892c18: Update Renovate-managed workflows.
+- 4f51b2f: Update Renovate-managed workflows.
+- c6546f6: Update dependencies: `@ankhorage/contracts`.
+- 23e5e1b: Update Renovate-managed workflows.
+- 41c172f: Update dependencies: `@ankhorage/contracts`, `@ankhorage/paradox`.
+- c0ed749: Update Renovate-managed workflows.
+- 246345c: Update dependencies: `@ankhorage/contracts`.
+- 694c526: Update Renovate-managed workflows.
+- f7aded4: Update dependencies: `@ankhorage/contracts`.
+- 3f85796: Update dependencies: `@ankhorage/contracts`.
+- 22e0c2d: Update Renovate-managed workflows.
+- d505dbe: Update dependencies: `@ankhorage/contracts`.
+- 1bd191c: Update Renovate-managed workflows.
+- 05f9256: Update dependencies: `@ankhorage/contracts`.
+- 7ef3977: Update dependencies: `ignore`.
+- 10b1e06: Update Renovate-managed workflows.
+- d3c1e48: Update dependencies: `@ankhorage/contracts`.
+- 87cb178: Update Renovate-managed workflows.
+- aedcfec: Update dependencies: `@ankhorage/contracts`.
+- 676a8e3: Update Renovate-managed workflows.
+- c1eefce: Update dependencies: `@ankhorage/contracts`.
+- 2fc0941: Update Renovate-managed workflows.
+- 5062abb: Update Renovate-managed workflows.
+- d0bc585: Update dependencies: `@ankhorage/contracts`.
+- 68ffe74: Update dependencies: `@ankhorage/contracts`.
+- d898450: Update dependencies: `@ankhorage/contracts`.
+- d450bc0: Update Renovate-managed workflows.
+- 9ce5632: Update dependencies: `@ankhorage/devtools`.
+- 6242afd: Update Renovate-managed workflows.
+- cd2da38: Update dependencies: `@ankhorage/contracts`, `@ankhorage/paradox`.
+- 91aa2d7: Update dependencies: `@ankhorage/devtools`.
+- 8fde348: Update dependencies: `@ankhorage/devtools`.
+
+## 0.4.19
+
+### Patch Changes
+
+- 2659575: Update Ankhorage dependencies: `@ankhorage/contracts`.
+
 ## 0.4.18
 
 ### Patch Changes

package/README.md

@@ -3,44 +3,33 @@
 
 # @ankhorage/repository
 
-![license: MIT](./paradox/badges/license.svg) ![npm: v0.4.18](./paradox/badges/npm.svg) ![runtime: bun](./paradox/badges/runtime.svg) ![typescript: strict](./paradox/badges/typescript.svg) ![eslint: checked](./paradox/badges/eslint.svg) ![prettier: checked](./paradox/badges/prettier.svg) ![build: checked](./paradox/badges/build.svg) ![tests: checked](./paradox/badges/tests.svg) ![docs: paradox](./paradox/badges/docs.svg)
+![license: MIT](./paradox/badges/license.svg) ![npm: v0.5.0](./paradox/badges/npm.svg) ![runtime: bun](./paradox/badges/runtime.svg) ![typescript: strict](./paradox/badges/typescript.svg) ![eslint: checked](./paradox/badges/eslint.svg) ![prettier: checked](./paradox/badges/prettier.svg) ![build: checked](./paradox/badges/build.svg) ![tests: checked](./paradox/badges/tests.svg) ![paradox: warnings](./paradox/badges/docs.svg)
 
 Standalone repository capability for connecting and managing an app project's source repository.
 
 ## Usage
 
-### Connect a project folder to its source repository
+### CLI
 
-`@ankhorage/repository` consumes only the project's `RepositoryManifest` slice and delegates
-GitHub operations to the local authenticated `gh` adapter. It creates a missing repository,
-publishes the project snapshot to `main`, stores only the repository slice in
-`.ankhorage/repository.json`, and refuses unrelated existing repositories.
+Ankhorage packages expose their command-line interface through `ankh`. Use `ankh --help` to discover available package commands, or run a package command with `--help` for package-specific usage.
 
-See [`examples/basic-usage.ts`](../examples/basic-usage.ts) for a complete programmatic example.
+```zsh
+# Install the Ankhorage CLI
+bun add --global @ankhorage/ankh
 
-Source: `src/readme-usage.ts`
+# Show usage information for repository
+ankh repository --help
+```
+
+### Connect a repository
+
+Connect a project folder to its source repository.
+
+This example creates a missing GitHub repository, publishes the project snapshot, and reports
+whether the repository is ready for use.
 
 ```ts
 import { connectRepositoryAsync } from '@ankhorage/repository';
-
-const result = await connectRepositoryAsync({
-  projectPath: './my-project',
-  repository: {
-    provider: 'github',
-    owner: 'ankhorage',
-    name: 'my-project',
-    url: 'https://github.com/ankhorage/my-project',
-    defaultBranch: 'main',
-  },
-  visibility: 'private',
-});
-
-if (result.status === 'conflict' || result.status === 'recoverable-failure') {
-  console.error(`${result.status}: ${result.message}`);
-  process.exitCode = 1;
-} else {
-  console.log(JSON.stringify(result));
-}
 ```
 
 ## Generated documentation

package/dist/cli/commands/materialize/definitions/MaterializeCommandOptions.d.ts

@@ -0,0 +1,6 @@
+export interface MaterializeCommandOptions {
+    readonly repositoryUrl: string;
+    readonly ref?: string;
+    readonly destinationPath?: string;
+}
+//# sourceMappingURL=MaterializeCommandOptions.d.ts.map

package/dist/cli/commands/materialize/definitions/MaterializeCommandOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaterializeCommandOptions.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/materialize/definitions/MaterializeCommandOptions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC"}

package/dist/cli/commands/materialize/definitions/MaterializeCommandOptions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=MaterializeCommandOptions.js.map

package/dist/cli/commands/materialize/definitions/MaterializeCommandOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaterializeCommandOptions.js","sourceRoot":"","sources":["../../../../../src/cli/commands/materialize/definitions/MaterializeCommandOptions.ts"],"names":[],"mappings":""}

package/dist/cli/commands/materialize/parseMaterializeCommandOptions.d.ts

@@ -0,0 +1,4 @@
+import type { MaterializeCommandOptions } from './definitions/MaterializeCommandOptions.js';
+/*** Parse `ankh repository materialize <github-url>` and its optional ref/output flags. */
+export declare function parseMaterializeCommandOptions(argv: readonly string[]): MaterializeCommandOptions;
+//# sourceMappingURL=parseMaterializeCommandOptions.d.ts.map

package/dist/cli/commands/materialize/parseMaterializeCommandOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseMaterializeCommandOptions.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/materialize/parseMaterializeCommandOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AAE5F,2FAA2F;AAC3F,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,yBAAyB,CA2BjG"}

package/dist/cli/commands/materialize/parseMaterializeCommandOptions.js

@@ -0,0 +1,33 @@
+/*** Parse `ankh repository materialize <github-url>` and its optional ref/output flags. */
+export function parseMaterializeCommandOptions(argv) {
+    let repositoryUrl;
+    let ref;
+    let destinationPath;
+    for (let index = 0; index < argv.length; index += 1) {
+        const [argument] = argv.slice(index);
+        if (argument === undefined)
+            continue;
+        if (argument === '--ref' || argument === '--out') {
+            const [value] = argv.slice(index + 1);
+            if (!value || value.startsWith('--'))
+                throw new Error(`${argument} requires a value.`);
+            index += 1;
+            if (argument === '--ref')
+                ref = value;
+            else
+                destinationPath = value;
+            continue;
+        }
+        if (argument.startsWith('--'))
+            throw new Error(`Unknown option: ${argument}`);
+        if (repositoryUrl !== undefined) {
+            throw new Error('Only one GitHub repository URL may be provided.');
+        }
+        repositoryUrl = argument;
+    }
+    if (repositoryUrl === undefined) {
+        throw new Error('A GitHub repository URL is required.');
+    }
+    return { repositoryUrl, ref, destinationPath };
+}
+//# sourceMappingURL=parseMaterializeCommandOptions.js.map

package/dist/cli/commands/materialize/parseMaterializeCommandOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseMaterializeCommandOptions.js","sourceRoot":"","sources":["../../../../src/cli/commands/materialize/parseMaterializeCommandOptions.ts"],"names":[],"mappings":"AAEA,2FAA2F;AAC3F,MAAM,UAAU,8BAA8B,CAAC,IAAuB;IACpE,IAAI,aAAiC,CAAC;IACtC,IAAI,GAAuB,CAAC;IAC5B,IAAI,eAAmC,CAAC;IAExC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,QAAQ,KAAK,SAAS;YAAE,SAAS;QACrC,IAAI,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YACjD,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YACtC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,oBAAoB,CAAC,CAAC;YACvF,KAAK,IAAI,CAAC,CAAC;YACX,IAAI,QAAQ,KAAK,OAAO;gBAAE,GAAG,GAAG,KAAK,CAAC;;gBACjC,eAAe,GAAG,KAAK,CAAC;YAC7B,SAAS;QACX,CAAC;QACD,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;QAC9E,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QACD,aAAa,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,eAAe,EAAE,CAAC;AACjD,CAAC"}

package/dist/cli/commands/materialize/parseMaterializeCommandOptions.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=parseMaterializeCommandOptions.test.d.ts.map

package/dist/cli/commands/materialize/parseMaterializeCommandOptions.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseMaterializeCommandOptions.test.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/materialize/parseMaterializeCommandOptions.test.ts"],"names":[],"mappings":""}

package/dist/cli/commands/materialize/parseMaterializeCommandOptions.test.js

@@ -0,0 +1,23 @@
+import { expect, test } from 'bun:test';
+import { parseMaterializeCommandOptions } from './parseMaterializeCommandOptions.js';
+test('parses the repository URL, ref, and output path', () => {
+    expect(parseMaterializeCommandOptions([
+        'https://github.com/ankhorage/zora',
+        '--ref',
+        'main',
+        '--out',
+        './zora',
+    ])).toEqual({
+        repositoryUrl: 'https://github.com/ankhorage/zora',
+        ref: 'main',
+        destinationPath: './zora',
+    });
+});
+test('requires exactly one repository URL', () => {
+    expect(() => parseMaterializeCommandOptions([])).toThrow('repository URL is required');
+    expect(() => parseMaterializeCommandOptions([
+        'https://github.com/ankhorage/zora',
+        'https://github.com/ankhorage/surface',
+    ])).toThrow('Only one GitHub repository URL');
+});
+//# sourceMappingURL=parseMaterializeCommandOptions.test.js.map

package/dist/cli/commands/materialize/parseMaterializeCommandOptions.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseMaterializeCommandOptions.test.js","sourceRoot":"","sources":["../../../../src/cli/commands/materialize/parseMaterializeCommandOptions.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAExC,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AAErF,IAAI,CAAC,iDAAiD,EAAE,GAAG,EAAE;IAC3D,MAAM,CACJ,8BAA8B,CAAC;QAC7B,mCAAmC;QACnC,OAAO;QACP,MAAM;QACN,OAAO;QACP,QAAQ;KACT,CAAC,CACH,CAAC,OAAO,CAAC;QACR,aAAa,EAAE,mCAAmC;QAClD,GAAG,EAAE,MAAM;QACX,eAAe,EAAE,QAAQ;KAC1B,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,qCAAqC,EAAE,GAAG,EAAE;IAC/C,MAAM,CAAC,GAAG,EAAE,CAAC,8BAA8B,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;IACvF,MAAM,CAAC,GAAG,EAAE,CACV,8BAA8B,CAAC;QAC7B,mCAAmC;QACnC,sCAAsC;KACvC,CAAC,CACH,CAAC,OAAO,CAAC,gCAAgC,CAAC,CAAC;AAC9C,CAAC,CAAC,CAAC"}

package/dist/cli/commands/materialize/runMaterializeCommandAsync.d.ts

@@ -0,0 +1,10 @@
+export interface MaterializeCommandRequest {
+    readonly argv?: readonly string[];
+    readonly stdout?: (line: string) => void;
+    readonly stderr?: (line: string) => void;
+}
+/*** Materialize one GitHub repository and print the immutable revision plus local root. */
+export declare function runMaterializeCommandAsync(request?: MaterializeCommandRequest): Promise<{
+    readonly exitCode: number;
+}>;
+//# sourceMappingURL=runMaterializeCommandAsync.d.ts.map

package/dist/cli/commands/materialize/runMaterializeCommandAsync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runMaterializeCommandAsync.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/materialize/runMaterializeCommandAsync.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAED,2FAA2F;AAC3F,wBAAsB,0BAA0B,CAC9C,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAyBxC"}

package/dist/cli/commands/materialize/runMaterializeCommandAsync.js

@@ -0,0 +1,28 @@
+import { materializeGitHubRepositoryAsync } from '../../../providers/github/services/materializeGitHubRepositoryAsync.js';
+import { parseMaterializeCommandOptions } from './parseMaterializeCommandOptions.js';
+/*** Materialize one GitHub repository and print the immutable revision plus local root. */
+export async function runMaterializeCommandAsync(request = {}) {
+    const stdout = request.stdout ?? console.log;
+    const stderr = request.stderr ?? console.error;
+    try {
+        const options = parseMaterializeCommandOptions(request.argv ?? []);
+        const result = await materializeGitHubRepositoryAsync({
+            url: options.repositoryUrl,
+            ...(options.ref === undefined ? {} : { ref: options.ref }),
+            ...(options.destinationPath === undefined
+                ? {}
+                : { destinationPath: options.destinationPath }),
+        });
+        stdout(JSON.stringify({
+            rootPath: result.rootPath,
+            revision: result.revision,
+            repository: result.repository,
+        }));
+        return { exitCode: 0 };
+    }
+    catch (error) {
+        stderr(error instanceof Error ? error.message : 'Repository materialization failed.');
+        return { exitCode: 1 };
+    }
+}
+//# sourceMappingURL=runMaterializeCommandAsync.js.map

package/dist/cli/commands/materialize/runMaterializeCommandAsync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runMaterializeCommandAsync.js","sourceRoot":"","sources":["../../../../src/cli/commands/materialize/runMaterializeCommandAsync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,wEAAwE,CAAC;AAC1H,OAAO,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AAQrF,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,UAAqC,EAAE;IAEvC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC;IAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC;IAE/C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,8BAA8B,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,MAAM,gCAAgC,CAAC;YACpD,GAAG,EAAE,OAAO,CAAC,aAAa;YAC1B,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;YAC1D,GAAG,CAAC,OAAO,CAAC,eAAe,KAAK,SAAS;gBACvC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC;SAClD,CAAC,CAAC;QACH,MAAM,CACJ,IAAI,CAAC,SAAS,CAAC;YACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC,CACH,CAAC;QACF,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,oCAAoC,CAAC,CAAC;QACtF,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/cli/provider/createRepositoryRuntimeProvider.d.ts

@@ -1,14 +1,20 @@
 import { type ConnectCommandRequest } from '../commands/connect/runConnectCommandAsync.js';
+import { type MaterializeCommandRequest } from '../commands/materialize/runMaterializeCommandAsync.js';
 export interface RepositoryRuntimeProvider {
     readonly id: 'repository';
     readonly category: 'repository';
     readonly version: string;
-    readonly capabilities: readonly ['repository.connect'];
+    readonly capabilities: readonly ['repository.connect', 'repository.materialize'];
     readonly commands: readonly [
         {
             readonly path: readonly ['connect'];
             readonly capability: 'repository.connect';
             readonly summary: string;
+        },
+        {
+            readonly path: readonly ['materialize'];
+            readonly capability: 'repository.materialize';
+            readonly summary: string;
         }
     ];
     readonly handlers: readonly [
@@ -17,9 +23,15 @@ export interface RepositoryRuntimeProvider {
             readonly handler: (request: ConnectCommandRequest) => Promise<{
                 readonly exitCode: number;
             }>;
+        },
+        {
+            readonly path: readonly ['materialize'];
+            readonly handler: (request: MaterializeCommandRequest) => Promise<{
+                readonly exitCode: number;
+            }>;
         }
     ];
 }
-/** Create the package-level Ankh provider for `ankh repository connect`. */
+/*** Create the package-level Ankh provider for repository connect and materialization commands. */
 export declare function createRepositoryRuntimeProvider(): RepositoryRuntimeProvider;
 //# sourceMappingURL=createRepositoryRuntimeProvider.d.ts.map

package/dist/cli/provider/createRepositoryRuntimeProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createRepositoryRuntimeProvider.d.ts","sourceRoot":"","sources":["../../../src/cli/provider/createRepositoryRuntimeProvider.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,qBAAqB,EAE3B,MAAM,+CAA+C,CAAC;AAEvD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,oBAAoB,CAAC,CAAC;IACvD,QAAQ,CAAC,QAAQ,EAAE,SAAS;QAC1B;YACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;YACpC,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;YAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;SAC1B;KACF,CAAC;IACF,QAAQ,CAAC,QAAQ,EAAE,SAAS;QAC1B;YACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;YACpC,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,OAAO,CAAC;gBAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;SAC9F;KACF,CAAC;CACH;AAED,4EAA4E;AAC5E,wBAAgB,+BAA+B,IAAI,yBAAyB,CAe3E"}
+{"version":3,"file":"createRepositoryRuntimeProvider.d.ts","sourceRoot":"","sources":["../../../src/cli/provider/createRepositoryRuntimeProvider.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,qBAAqB,EAE3B,MAAM,+CAA+C,CAAC;AACvD,OAAO,EACL,KAAK,yBAAyB,EAE/B,MAAM,uDAAuD,CAAC;AAE/D,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,oBAAoB,EAAE,wBAAwB,CAAC,CAAC;IACjF,QAAQ,CAAC,QAAQ,EAAE,SAAS;QAC1B;YACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;YACpC,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;YAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;SAC1B;QACD;YACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;YACxC,QAAQ,CAAC,UAAU,EAAE,wBAAwB,CAAC;YAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;SAC1B;KACF,CAAC;IACF,QAAQ,CAAC,QAAQ,EAAE,SAAS;QAC1B;YACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;YACpC,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,OAAO,CAAC;gBAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;SAC9F;QACD;YACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;YACxC,QAAQ,CAAC,OAAO,EAAE,CAChB,OAAO,EAAE,yBAAyB,KAC/B,OAAO,CAAC;gBAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;SAC7C;KACF,CAAC;CACH;AAED,mGAAmG;AACnG,wBAAgB,+BAA+B,IAAI,yBAAyB,CAY3E"}

package/dist/cli/provider/createRepositoryRuntimeProvider.js

@@ -1,20 +1,18 @@
 import { repositoryPackageMetadata } from '../../metadata/repositoryPackageMetadata.js';
 import { runConnectCommandAsync, } from '../commands/connect/runConnectCommandAsync.js';
-/** Create the package-level Ankh provider for `ankh repository connect`. */
+import { runMaterializeCommandAsync, } from '../commands/materialize/runMaterializeCommandAsync.js';
+/*** Create the package-level Ankh provider for repository connect and materialization commands. */
 export function createRepositoryRuntimeProvider() {
     return {
         id: repositoryPackageMetadata.provider,
         category: repositoryPackageMetadata.category,
         version: repositoryPackageMetadata.version,
-        capabilities: ['repository.connect'],
-        commands: [
-            {
-                path: ['connect'],
-                capability: 'repository.connect',
-                summary: repositoryPackageMetadata.command.summary,
-            },
+        capabilities: repositoryPackageMetadata.capabilities,
+        commands: [repositoryPackageMetadata.command, repositoryPackageMetadata.materializeCommand],
+        handlers: [
+            { path: ['connect'], handler: runConnectCommandAsync },
+            { path: ['materialize'], handler: runMaterializeCommandAsync },
         ],
-        handlers: [{ path: ['connect'], handler: runConnectCommandAsync }],
     };
 }
 //# sourceMappingURL=createRepositoryRuntimeProvider.js.map

package/dist/cli/provider/createRepositoryRuntimeProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"createRepositoryRuntimeProvider.js","sourceRoot":"","sources":["../../../src/cli/provider/createRepositoryRuntimeProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AACxF,OAAO,EAEL,sBAAsB,GACvB,MAAM,+CAA+C,CAAC;AAsBvD,4EAA4E;AAC5E,MAAM,UAAU,+BAA+B;IAC7C,OAAO;QACL,EAAE,EAAE,yBAAyB,CAAC,QAAQ;QACtC,QAAQ,EAAE,yBAAyB,CAAC,QAAQ;QAC5C,OAAO,EAAE,yBAAyB,CAAC,OAAO;QAC1C,YAAY,EAAE,CAAC,oBAAoB,CAAC;QACpC,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,CAAC,SAAS,CAAC;gBACjB,UAAU,EAAE,oBAAoB;gBAChC,OAAO,EAAE,yBAAyB,CAAC,OAAO,CAAC,OAAO;aACnD;SACF;QACD,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;KACnE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"createRepositoryRuntimeProvider.js","sourceRoot":"","sources":["../../../src/cli/provider/createRepositoryRuntimeProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AACxF,OAAO,EAEL,sBAAsB,GACvB,MAAM,+CAA+C,CAAC;AACvD,OAAO,EAEL,0BAA0B,GAC3B,MAAM,uDAAuD,CAAC;AAiC/D,mGAAmG;AACnG,MAAM,UAAU,+BAA+B;IAC7C,OAAO;QACL,EAAE,EAAE,yBAAyB,CAAC,QAAQ;QACtC,QAAQ,EAAE,yBAAyB,CAAC,QAAQ;QAC5C,OAAO,EAAE,yBAAyB,CAAC,OAAO;QAC1C,YAAY,EAAE,yBAAyB,CAAC,YAAY;QACpD,QAAQ,EAAE,CAAC,yBAAyB,CAAC,OAAO,EAAE,yBAAyB,CAAC,kBAAkB,CAAC;QAC3F,QAAQ,EAAE;YACR,EAAE,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,sBAAsB,EAAE;YACtD,EAAE,IAAI,EAAE,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,0BAA0B,EAAE;SAC/D;KACF,CAAC;AACJ,CAAC"}

package/dist/cli/provider/createRepositoryRuntimeProvider.test.js

@@ -1,12 +1,16 @@
 import { expect, test } from 'bun:test';
 import packageJson from '../../../package.json';
 import { createRepositoryRuntimeProvider } from './createRepositoryRuntimeProvider.js';
-test('reports the installed package version and canonical repository capability', () => {
+test('reports the installed package version and canonical repository capabilities', () => {
     expect(createRepositoryRuntimeProvider()).toMatchObject({
         id: 'repository',
         category: 'repository',
         version: packageJson.version,
-        capabilities: ['repository.connect'],
+        capabilities: ['repository.connect', 'repository.materialize'],
+        commands: [
+            { path: ['connect'], capability: 'repository.connect' },
+            { path: ['materialize'], capability: 'repository.materialize' },
+        ],
     });
 });
 //# sourceMappingURL=createRepositoryRuntimeProvider.test.js.map

package/dist/cli/provider/createRepositoryRuntimeProvider.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"createRepositoryRuntimeProvider.test.js","sourceRoot":"","sources":["../../../src/cli/provider/createRepositoryRuntimeProvider.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAExC,OAAO,WAAW,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AAEvF,IAAI,CAAC,2EAA2E,EAAE,GAAG,EAAE;IACrF,MAAM,CAAC,+BAA+B,EAAE,CAAC,CAAC,aAAa,CAAC;QACtD,EAAE,EAAE,YAAY;QAChB,QAAQ,EAAE,YAAY;QACtB,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,YAAY,EAAE,CAAC,oBAAoB,CAAC;KACrC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"createRepositoryRuntimeProvider.test.js","sourceRoot":"","sources":["../../../src/cli/provider/createRepositoryRuntimeProvider.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAExC,OAAO,WAAW,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AAEvF,IAAI,CAAC,6EAA6E,EAAE,GAAG,EAAE;IACvF,MAAM,CAAC,+BAA+B,EAAE,CAAC,CAAC,aAAa,CAAC;QACtD,EAAE,EAAE,YAAY;QAChB,QAAQ,EAAE,YAAY;QACtB,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,YAAY,EAAE,CAAC,oBAAoB,EAAE,wBAAwB,CAAC;QAC9D,QAAQ,EAAE;YACR,EAAE,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,oBAAoB,EAAE;YACvD,EAAE,IAAI,EAAE,CAAC,aAAa,CAAC,EAAE,UAAU,EAAE,wBAAwB,EAAE;SAChE;KACF,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/github/index.d.ts

@@ -1,5 +1,8 @@
 export type { GitHubRepositoryConnectionOptions } from '../providers/github/definitions/GitHubRepositoryConnectionOptions.js';
 export type { GitHubRepositoryConnectionFailure, GitHubRepositoryConnectionResult, GitHubRepositoryConnectionStatus, } from '../providers/github/definitions/GitHubRepositoryConnectionResult.js';
+export type { GitHubRepositoryMaterializationOptions } from '../providers/github/definitions/GitHubRepositoryMaterializationOptions.js';
+export type { GitHubRepositoryMaterializationResult } from '../providers/github/definitions/GitHubRepositoryMaterializationResult.js';
 export type { GitHubRepositoryVisibility } from '../providers/github/definitions/GitHubRepositoryVisibility.js';
 export { connectGitHubRepositoryAsync } from '../providers/github/services/connectGitHubRepositoryAsync.js';
+export { materializeGitHubRepositoryAsync } from '../providers/github/services/materializeGitHubRepositoryAsync.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/github/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iCAAiC,EAAE,MAAM,sEAAsE,CAAC;AAC9H,YAAY,EACV,iCAAiC,EACjC,gCAAgC,EAChC,gCAAgC,GACjC,MAAM,qEAAqE,CAAC;AAC7E,YAAY,EAAE,0BAA0B,EAAE,MAAM,+DAA+D,CAAC;AAChH,OAAO,EAAE,4BAA4B,EAAE,MAAM,8DAA8D,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/github/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iCAAiC,EAAE,MAAM,sEAAsE,CAAC;AAC9H,YAAY,EACV,iCAAiC,EACjC,gCAAgC,EAChC,gCAAgC,GACjC,MAAM,qEAAqE,CAAC;AAC7E,YAAY,EAAE,sCAAsC,EAAE,MAAM,2EAA2E,CAAC;AACxI,YAAY,EAAE,qCAAqC,EAAE,MAAM,0EAA0E,CAAC;AACtI,YAAY,EAAE,0BAA0B,EAAE,MAAM,+DAA+D,CAAC;AAChH,OAAO,EAAE,4BAA4B,EAAE,MAAM,8DAA8D,CAAC;AAC5G,OAAO,EAAE,gCAAgC,EAAE,MAAM,kEAAkE,CAAC"}

package/dist/github/index.js

@@ -1,2 +1,3 @@
 export { connectGitHubRepositoryAsync } from '../providers/github/services/connectGitHubRepositoryAsync.js';
+export { materializeGitHubRepositoryAsync } from '../providers/github/services/materializeGitHubRepositoryAsync.js';
 //# sourceMappingURL=index.js.map

package/dist/github/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/github/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,4BAA4B,EAAE,MAAM,8DAA8D,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/github/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,4BAA4B,EAAE,MAAM,8DAA8D,CAAC;AAC5G,OAAO,EAAE,gCAAgC,EAAE,MAAM,kEAAkE,CAAC"}

package/dist/metadata/index.d.ts

@@ -3,7 +3,7 @@ export declare const REPOSITORY_PACKAGE_METADATA: {
     readonly manifestProperty: "repository";
     readonly contractSubpath: "@ankhorage/contracts/repository";
     readonly providers: readonly ["github"];
-    readonly capabilities: readonly ["repository.connect"];
+    readonly capabilities: readonly ["repository.connect", "repository.materialize"];
     readonly github: {
         readonly cli: "gh";
         readonly defaultBranch: "main";

package/dist/metadata/index.js

@@ -3,7 +3,7 @@ export const REPOSITORY_PACKAGE_METADATA = {
     manifestProperty: 'repository',
     contractSubpath: '@ankhorage/contracts/repository',
     providers: ['github'],
-    capabilities: ['repository.connect'],
+    capabilities: ['repository.connect', 'repository.materialize'],
     github: {
         cli: 'gh',
         defaultBranch: 'main',

package/dist/metadata/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/metadata/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,WAAW,EAAE,uBAAuB;IACpC,gBAAgB,EAAE,YAAY;IAC9B,eAAe,EAAE,iCAAiC;IAClD,SAAS,EAAE,CAAC,QAAQ,CAAC;IACrB,YAAY,EAAE,CAAC,oBAAoB,CAAC;IACpC,MAAM,EAAE;QACN,GAAG,EAAE,IAAI;QACT,aAAa,EAAE,MAAM;KACtB;CACO,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/metadata/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,WAAW,EAAE,uBAAuB;IACpC,gBAAgB,EAAE,YAAY;IAC9B,eAAe,EAAE,iCAAiC;IAClD,SAAS,EAAE,CAAC,QAAQ,CAAC;IACrB,YAAY,EAAE,CAAC,oBAAoB,EAAE,wBAAwB,CAAC;IAC9D,MAAM,EAAE;QACN,GAAG,EAAE,IAAI;QACT,aAAa,EAAE,MAAM;KACtB;CACO,CAAC"}

package/dist/metadata/repositoryPackageMetadata.d.ts

@@ -3,11 +3,16 @@ export declare const repositoryPackageMetadata: {
     readonly provider: "repository";
     readonly category: "repository";
     readonly version: string;
-    readonly capabilities: readonly ["repository.connect"];
+    readonly capabilities: readonly ["repository.connect", "repository.materialize"];
     readonly command: {
         readonly path: readonly ["connect"];
         readonly capability: "repository.connect";
         readonly summary: "Create or safely resume a source repository connection.";
     };
+    readonly materializeCommand: {
+        readonly path: readonly ["materialize"];
+        readonly capability: "repository.materialize";
+        readonly summary: "Materialize a GitHub repository URL as a local filesystem snapshot.";
+    };
 };
 //# sourceMappingURL=repositoryPackageMetadata.d.ts.map

package/dist/metadata/repositoryPackageMetadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repositoryPackageMetadata.d.ts","sourceRoot":"","sources":["../../src/metadata/repositoryPackageMetadata.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,yBAAyB;;;;;;;;;;;CAW5B,CAAC"}
+{"version":3,"file":"repositoryPackageMetadata.d.ts","sourceRoot":"","sources":["../../src/metadata/repositoryPackageMetadata.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;CAgB5B,CAAC"}

package/dist/metadata/repositoryPackageMetadata.js

@@ -4,11 +4,16 @@ export const repositoryPackageMetadata = {
     provider: 'repository',
     category: 'repository',
     version: packageJson.version,
-    capabilities: ['repository.connect'],
+    capabilities: ['repository.connect', 'repository.materialize'],
     command: {
         path: ['connect'],
         capability: 'repository.connect',
         summary: 'Create or safely resume a source repository connection.',
     },
+    materializeCommand: {
+        path: ['materialize'],
+        capability: 'repository.materialize',
+        summary: 'Materialize a GitHub repository URL as a local filesystem snapshot.',
+    },
 };
 //# sourceMappingURL=repositoryPackageMetadata.js.map

package/dist/metadata/repositoryPackageMetadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"repositoryPackageMetadata.js","sourceRoot":"","sources":["../../src/metadata/repositoryPackageMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,oBAAoB,CAAC;AAE7C,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,WAAW,EAAE,WAAW,CAAC,IAAI;IAC7B,QAAQ,EAAE,YAAqB;IAC/B,QAAQ,EAAE,YAAqB;IAC/B,OAAO,EAAE,WAAW,CAAC,OAAO;IAC5B,YAAY,EAAE,CAAC,oBAAoB,CAAU;IAC7C,OAAO,EAAE;QACP,IAAI,EAAE,CAAC,SAAS,CAAU;QAC1B,UAAU,EAAE,oBAA6B;QACzC,OAAO,EAAE,yDAAyD;KACnE;CACO,CAAC"}
+{"version":3,"file":"repositoryPackageMetadata.js","sourceRoot":"","sources":["../../src/metadata/repositoryPackageMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,oBAAoB,CAAC;AAE7C,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,WAAW,EAAE,WAAW,CAAC,IAAI;IAC7B,QAAQ,EAAE,YAAqB;IAC/B,QAAQ,EAAE,YAAqB;IAC/B,OAAO,EAAE,WAAW,CAAC,OAAO;IAC5B,YAAY,EAAE,CAAC,oBAAoB,EAAE,wBAAwB,CAAU;IACvE,OAAO,EAAE;QACP,IAAI,EAAE,CAAC,SAAS,CAAU;QAC1B,UAAU,EAAE,oBAA6B;QACzC,OAAO,EAAE,yDAAyD;KACnE;IACD,kBAAkB,EAAE;QAClB,IAAI,EAAE,CAAC,aAAa,CAAU;QAC9B,UAAU,EAAE,wBAAiC;QAC7C,OAAO,EAAE,qEAAqE;KAC/E;CACO,CAAC"}

package/dist/providers/github/adapters/createGitHubHttpRepositoryReadGateway.d.ts

@@ -0,0 +1,4 @@
+import type { GitHubRepositoryReadGateway } from '../ports/GitHubRepositoryReadGateway.js';
+/*** Create the read-only GitHub gateway used to materialize repository snapshots over HTTPS. */
+export declare function createGitHubHttpRepositoryReadGateway(fetcher?: typeof fetch): GitHubRepositoryReadGateway;
+//# sourceMappingURL=createGitHubHttpRepositoryReadGateway.d.ts.map

package/dist/providers/github/adapters/createGitHubHttpRepositoryReadGateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createGitHubHttpRepositoryReadGateway.d.ts","sourceRoot":"","sources":["../../../../src/providers/github/adapters/createGitHubHttpRepositoryReadGateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAM5B,MAAM,yCAAyC,CAAC;AAEjD,gGAAgG;AAChG,wBAAgB,qCAAqC,CACnD,OAAO,GAAE,OAAO,KAAa,GAC5B,2BAA2B,CAO7B"}