interface.md
markdown
sha256:c079680aa72b38cf20f7891daeadbb28f6ec71301dff7c1973565401e6f23a34
docs: align public documentation and website with bounded v1
Human
minor
⚠ breaking
7 days ago
Historical pre-reset product. This document describes the pre-reset historical product. Its legacy commands are not exposed by the bounded-v1 entrypoint. Do not use it as current onboarding. See the root README and current docs index.
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
1 commit
sha256:c079680aa72b38cf20f7891daeadbb28f6ec71301dff7c1973565401e6f23a34
docs: align public documentation and website with bounded v1
Human
minor
⚠
7 days ago