ui-automation-control-plane

A browser automation governance and verification platform.

This repository is public. Runtime evidence, failure bundles, and operational artifacts still follow a private-only default boundary unless a path is explicitly allowlisted as public-safe.

Current truth surfaces:

• Documentation entrypoint: docs/index.md
• Canonical rules: docs/ai/agent-guide.md
• Architecture contract: docs/architecture.md
• Public boundary: docs/reference/public-readiness.md
• CI and branch-protection truth: docs/reference/ci-governance.md

Security posture:

• GitHub Secret Scanning and push protection are enabled on the live repository.
• GitHub CodeQL analysis runs through .github/workflows/codeql.yml.

Version baseline:

• Python = 3.12.x
• Node.js = 20.x
• pnpm = 10.22.0

1. Set up the workspace:

./scripts/setup.sh

1. Verify repo-side structure first:

pnpm gate:repo:fast
pnpm doctor:repo

1. Verify code-quality fast path:

pnpm gate:delivery:fast

1. Run the publication and redaction audit when evaluating public readiness:

pnpm audit:oss:redaction

• docs/index.md: documentation router
• docs/ai/agent-guide.md: canonical execution rules
• docs/architecture.md: architecture contract
• docs/reference/public-readiness.md: public boundary
• docs/reference/ci-governance.md: CI and branch-protection truth
• docs/reference/configuration.md: environment and configuration reference
• docs/reference/dependency-governance.md: dependency and package policy
• docs/reference/universal-api.md: API contract reference
• docs/reference/public-artifact-policy.md: publication boundary for public-safe artifacts
• docs/quality-gates.md: repo and release gate semantics
• docs/mcp.md: MCP contract
• docs/how-to/mcp-clients-setup.md: MCP client setup
• docs/how-to/mcp-quickstart-1pager.md: MCP quickstart

• This repository intentionally