VCS Adapter Interface

Canonical copy of docs/OVERSEER-KIT-SPEC.md §4. K2 implements these methods for three backends.

Methods (fail-closed)

Method	Purpose
`status()`	Regime, dirty tree, branch, notes
`read_head({ ref })`	SHA for a ref — never fabricated
`read_canonical_anchor()`	Muse↔Git anchor, muse tip, or origin/main
`realign({ dry_run, max_commits })`	Muse git-import recovery; no-op for single-history
`commit_feature({ branch, message, paths[] })`	Tier 1 feature-branch commit only
`mirror({ dry_run })`	Tier 3 mirror delta report; operator gate before push

Backends

Regime	Consumers	Notes
`muse+git-mirror`	Scooling, Knowtation	SD-14: never `git push origin main`
`muse-only`	MuseHub	git/mirror hard no-op
`git-only`	VideoFactory, external	Single-history; full governance still works

Backends (K2)

Regime	Package	Notes
`muse+git-mirror`	`adapters/muse_git_mirror/`	SD-14: never `git push origin main`
`muse-only`	`adapters/muse_only/`	git/mirror hard no-op
`git-only`	`adapters/git_only/`	Single-history; full governance still works

Load at runtime:

from adapters import load_adapter
adapter = load_adapter(repo_root)  # reads .overseer/config.yaml

Cross-repo safety

Every Muse invocation uses explicit muse -C <absolute-repo-root> and confirms branch + HEAD before writes.

File History 2 commits

sha256:a78e7e5a8740e03315f325d19edeb3aa1b306b3337d04abbaa9a9e0f3bbeb7a1 docs: MuseHub-first before ISR #74 — staging solidify NEXT Human 1 day ago

sha256:4671b7f787ddbe63ced31c895b688c77ab495653b65a730b423329f26b3c1439 feat: K1-P1 complete — agent provenance, build-verification… Sonnet 4.6 patch 53 days ago