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

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

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

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

File History 1 commit

sha256:8461d44b77376fbf06fa7c3e085d309e3010fd8d5886d63c63e69ce118811ad4 docs: record AFF-b feature-tip SHAs after AFF-b-ISR commit. Human 4 days ago