@forgezero/vault 0.1.19 → 0.1.20

package/README.md

@@ -193,16 +193,41 @@ import {
 } from '@forgezero/vault/providers';
 ```
 
-## @forgezero/vault/providers — Use this entry point
+## @forgezero/vault/providers — Attach a versioned Git forge to Git Connect
 
-This minimal executable use imports one concrete value from this exact entry point without a wildcard or package-root detour. Keep the value or values the application actually needs; the full named inventory remains directly above it.
+The service remains stable while each forge owns its API versions. Credentials are scoped Vault lookups and ordered arrays allow an explicitly reviewed legacy branch during migration.
 
 ```text
 import {
-  vaultConfig,
+  createService,
+} from '@forgezero/providers';
+import {
+  defineGitConnectProvider,
+  gitConnectService,
+} from '@forgezero/providers/git';
+import {
+  createVault,
+} from '@forgezero/vault';
+import {
+  vaultCredentials,
 } from '@forgezero/vault/providers';
 
-export const selectedCapability = vaultConfig;
+declare const githubAdapter: Parameters<typeof defineGitConnectProvider>[0]['adapter'];
+const vault = createVault({ project: 'control-plane', environment: 'production' });
+const github = defineGitConnectProvider({
+  id: 'github-app', label: 'GitHub App', version: '2026-03-10',
+  adapter: githubAdapter // Your HTTP boundary implements the five typed methods.
+});
+const git = createService(gitConnectService, {
+  listAccounts: [{ provider: github, method: 'listAccounts', version: '2026-03-10', credentials: vaultCredentials(vault, 'github-app'), priority: 1 }],
+  listRepositories: [{ provider: github, method: 'listRepositories', version: '2026-03-10', credentials: vaultCredentials(vault, 'github-app'), priority: 1 }],
+  listBranches: [{ provider: github, method: 'listBranches', version: '2026-03-10', credentials: vaultCredentials(vault, 'github-app'), priority: 1 }],
+  ensureWebhook: [{ provider: github, method: 'ensureWebhook', version: '2026-03-10', credentials: vaultCredentials(vault, 'github-app'), priority: 1 }],
+  cloneCredential: [{ provider: github, method: 'cloneCredential', version: '2026-03-10', credentials: vaultCredentials(vault, 'github-app'), priority: 1 }]
+});
+
+const accounts = await git.call('listAccounts', {});
+if (!accounts.ok) throw accounts.error;
 ```
 
 ## Three paths, and why they stay explicit

package/dist/index.d.ts

@@ -282,4 +282,4 @@ export declare function systemdCredentials(options?: SystemdCredentialOptions):
     readonly name: 'systemd';
     get(reference: string, field: string): Promise<string>;
 };
-export declare const VERSION = "0.1.19";
+export declare const VERSION = "0.1.20";

package/dist/index.js

@@ -382,7 +382,7 @@ function systemdCredentials(options = {}) {
     }
   };
 }
-var VERSION = "0.1.19";
+var VERSION = "0.1.20";
 export {
   vaultCredentials,
   systemdCredentials,

package/dist/providers.js

@@ -382,7 +382,7 @@ function systemdCredentials(options = {}) {
     }
   };
 }
-var VERSION = "0.1.19";
+var VERSION = "0.1.20";
 
 // src/providers.ts
 var MISSING = new Set(["ENTRY_NOT_FOUND", "VERSION_NOT_FOUND"]);

package/dist/schema.js

@@ -382,7 +382,7 @@ function systemdCredentials(options = {}) {
     }
   };
 }
-var VERSION = "0.1.19";
+var VERSION = "0.1.20";
 
 // src/schema.ts
 function managedSchemas(vault, options = {}) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgezero/vault",
-  "version": "0.1.19",
+  "version": "0.1.20",
   "type": "module",
   "publishConfig": {
     "access": "public",