@agent-forge/plugin-git-repository

Git repository capability plugin for Agent Forge, extracted from the host's src/plugins/git-repository (D-075 S3). It registers a single read-only tool, git_repository_inspect, which returns bounded git status, diff summary, or log summary aggregates through a host-owned workspace reference; no diff hunk, raw log, branch, or command output is exposed.

The plugin has no standalone git binding at load time. Without host-injected resolver/runner seams the tool reports an explicit unsupported result; the host owns every git command and repository path.

Install

# from a local checkout
agent-forge plugin install ./plugins/git-repository

# from npm
agent-forge plugin install @ai-agent-forge/plugin-git-repository

The package ships two manifests: agent-forge.json (ecosystem manifest for the deterministic plugin resolver) and plugin.json (host-load manifest consumed by loadCapabilityPluginFromManifest, entry ./dist/entry.js).

Library surface

import { createNodeGitRepositoryAdapterV1, createGitRepositoryCapabilityFactoryV1 } from "@agent-forge/plugin-git-repository";

• createNodeGitRepositoryAdapterV1(options?) — read-only adapter; requires host-injected resolver/runner to produce results, otherwise returns unsupported.
• createDeterministicGitRepositoryAdapterV1(fixtures) — deterministic fixture adapter for tests.
• createGitRepositoryCapabilityFactoryV1(adapter) — registers git_repository_inspect on a CapabilityAPI.
• Default export of dist/entry.js — the precomposed factory used by external plugin loading.

Development

npm install --ignore-scripts        # repo root, creates the workspace symlink
npm run build                       # plugins/git-repository (tsgo)
npm test                            # vitest; the entry fidelity test requires `npm run build` first