# CARBON plugin runtime

This directory is the canonical engine beneath CARBON, the first AI Agentic
Verification Harness. It contains the framework
implementation, selectors, durable evidence/reporting machinery, and the
progressively loaded test and flow libraries shared by every supported host.
Its read-only `scripts/carbon_advisor.py` inventories the current project and
change and recommends the best CARBON workflow sequence for CARBON Help.
`scripts/carbon_intent.py` normalizes local TestRail, Xray, XML, XLSX, DOCX,
framework, and manual exports. `scripts/carbon_bake.py` then owns the durable
evidence-gated execution, bounded test-definition repair/rerun, activation, and
responsive report contract for imported tests.
`scripts/carbon_context.py` provides the safe global local-execution profile and
injects its username, password, prompt, and document manifest only into an
approved child test runner; the password is never emitted by its read command.
`scripts/carbon_browser.py` owns the versioned `carbon-browser/v1` execution
contract, adapter validation and capability negotiation, durable session state,
redacted operation envelopes, and evidence provenance. `scripts/carbon_vibium.py`
is the executable official-Vibium bridge: it preserves native CLI commands,
runs existing Vibium tests through no-shell runners, records their results in
CARBON sessions, and exposes CARBON's additive generation API. Other host-agent,
Playwright/CDP, Selenium/WebDriver, and testers.ai managed-device integrations
remain capability-based adapters beneath this CARBON-owned semantic boundary.

Skills under `../../skills/` are intentionally thin routing and safety
contracts. They must not duplicate framework algorithms, test libraries, or
report logic. Use `../../bin/carbon-runtime` as the stable launcher so runtime
paths can evolve without expanding the skills again.

The runtime is local-first. It does not turn plans or inspected artifacts into
passes, and it does not grant authority for destructive, paid, public, or
release actions.
