docs/README.md

Rama main · réplica de lectura del repositorio original.

# Documentation map

This repository is the public documentation source for the **Portico Community/runtime**.

It is not the canonical location for confidential commercial strategy, private SaaS implementation or internal product planning.

## Operator / user

Each installation document below has an EN and PT-BR version. The command and authority contracts are checked for parity in CI. Other reference pages may remain English-only; the complete guided-install path is available in both languages.

Start here:

1. [quick-start.md](quick-start.md) · [PT-BR](quick-start.pt-BR.md) - shortest supported path into the guided terminal flow.
   - [First installation and acceptance, for beginners](first-install-acceptance.md) · [PT-BR](first-install-acceptance.pt-BR.md) - exact-candidate guided walkthrough with expected screens and safe recovery.
2. [installation-contract.md](installation-contract.md) · [PT-BR](installation-contract.pt-BR.md) - normative user-installation boundary.
3. [installer-flow.md](installer-flow.md) · [PT-BR](installer-flow.pt-BR.md) - complete installation phases.
4. [product-model.md](product-model.md) - authority and capability model.
5. [chatgpt-integration.md](chatgpt-integration.md) · [PT-BR](chatgpt-integration.pt-BR.md) - ChatGPT/MCP connection path.
6. [authentication.md](authentication.md) - OAuth/OIDC path.
7. [operations.md](operations.md) - status, health, logs, audit, update, rollback and removal.
8. [troubleshooting.md](troubleshooting.md) - common failure paths.
9. [faq.md](faq.md) - common security/authority questions.
10. [compatibility.md](compatibility.md) - supported/tested/untested environments.
11. [privacy.md](privacy.md) - data, logs, secrets and telemetry.
12. [releases.md](releases.md) - SemVer and stable/RC/development channels.
13. [support.md](support.md) - Community support boundaries.
14. [operator-acceptance.md](operator-acceptance.md) - owner-operated final acceptance gate.
15. [vision.md](vision.md) - public product principles.
16. [roadmap-multinode-control-plane.md](roadmap-multinode-control-plane.md) - intentionally high-level public roadmap.
17. [operator-approval-fallback.md](operator-approval-fallback.md) - authenticated HTTPS and interactive SSH decisions.
18. [approval-compatibility.md](approval-compatibility.md) - adaptive authorization modes and evidence per client.

## Developer / security

- [competitive-landscape-and-interoperability.md](competitive-landscape-and-interoperability.md) - public competitor benchmark, vendor-neutral MCP compatibility and future engineering candidates.
- [project-status.md](project-status.md) - current public runtime maturity.
- [productization-status.md](productization-status.md) - public Community productization status.
- [execution-plan.md](execution-plan.md) - active public Community release path.
- [architecture.md](architecture.md) - runtime and trust boundaries.
- [policy-schema.md](policy-schema.md) - authorization model.
- [threat-model.md](threat-model.md) - threat model.
- [security-hardening-v2.md](security-hardening-v2.md) - hardening requirements.
- [security-release.md](security-release.md) - pre-release hardening matrix.
- [runtime-semantics-and-recovery.md](runtime-semantics-and-recovery.md) - durability, replay and recovery.
- [tool-trust-and-confused-deputy.md](tool-trust-and-confused-deputy.md) - downstream/tool trust.
- [transport-and-aggregation.md](transport-and-aggregation.md) - transport constraints.
- [implementation-validation.md](implementation-validation.md) - executable evidence.
- [runtime-version-identity.md](runtime-version-identity.md) - product release version in MCP initialize and diagnostics.
- [adaptive-operator-approvals.md](adaptive-operator-approvals.md) - explicit authenticated operator sessions and Broker authority.
- [operator-mcp-apps-gate.md](operator-mcp-apps-gate.md) - MCP Apps support and real-client acceptance gate.
- [adaptive-approvals-rollout.md](adaptive-approvals-rollout.md) - isolated staging and rollback.

## Precedence

For Community/runtime questions:

1. architecture.md
2. installation-contract.md
3. current project-status.md
4. policy-schema.md
5. security-hardening-v2.md
6. runtime-semantics-and-recovery.md
7. supporting public documents

## Public scope

Current Community promise:

**one compatible web AI chat <-> one Linux computer**

Broader commercial/SaaS planning is maintained outside this public repository.

- [Portico Cloud node connector](cloud-node-connector.md) — optional outbound managed-Cloud enrollment, signed task transport, and local Broker handoff.
- [Conector de nó do Portico Cloud (PT-BR)](cloud-node-connector.pt-BR.md) — enrollment, transporte assinado e entrega ao Broker local.