pi-outpost

Projetos que seguem as melhores práticas abaixo podem se autocertificar voluntariamente e mostrar que alcançaram um selo de melhores práticas da Open Source Security Foundation (OpenSSF).

Não existe um conjunto de práticas que possa garantir que o software nunca terá defeitos ou vulnerabilidades; mesmo métodos formais podem falhar se as especificações ou suposições estiverem erradas. Nem existe qualquer conjunto de práticas que possa garantir que um projeto sustentará uma comunidade de desenvolvimento saudável e bem-funcionada. No entanto, seguir as melhores práticas pode ajudar a melhorar os resultados dos projetos. Por exemplo, algumas práticas permitem revisão multipessoal antes do lançamento, o que pode ajudar a encontrar vulnerabilidades técnicas difíceis de encontrar e ajudar a construir confiança e desejo de interação repetida entre desenvolvedores de diferentes empresas. Para ganhar um selo, todos os critérios DEVE e NÃO DEVE devem ser atendidos, todos os critérios DEVERIA devem ser atendidos OU não atendidos com justificativa, e todos os critérios SUGERIDO devem ser atendidos OU não atendidos (queremos que sejam considerados pelo menos). Se você quiser inserir texto de justificativa como um comentário genérico, em vez de ser uma justificativa de que a situação é aceitável, inicie o bloco de texto com '//' seguido de um espaço. Feedback é bem-vindo via site do GitHub como questões ou pull requests Há também uma lista de discussão para discussão geral.

Fornecemos com prazer as informações em vários idiomas, no entanto, se houver qualquer conflito ou inconsistência entre as traduções, a versão em inglês é a versão autoritativa.
Se este é o seu projeto, por favor mostre o status do seu selo básico na página do seu projeto! O status do selo básico se parece com isto: O nível do selo básico para o projeto 16423 é baseline-1 Aqui está como incorporar o selo básico:
Você pode mostrar o status do seu selo básico incorporando isto no seu arquivo markdown:
[![OpenSSF Baseline](https://www.bestpractices.dev/projects/16423/baseline)](https://www.bestpractices.dev/projects/16423)
ou incorporando isto no seu HTML:
<a href="https://www.bestpractices.dev/projects/16423"><img src="https://www.bestpractices.dev/projects/16423/baseline"></a>


Estes são os critérios de Nível Básico 2. Estes são critérios da versão v2026.08.28.

Baseline Series: Nível Básico 1 Nível Básico 2 Nível Básico 3

        

 Fundamentos

  • Geral

    Observe que outros projetos podem usar o mesmo nome.

    Self-hosted web interface for the pi coding agent: chat, files, documents and an integrated terminal, with the agent's shell confined by OS sandboxes.

    Use o formato de expressão de licença SPDX; exemplos incluem "Apache-2.0", "BSD-2-Clause", "BSD-3-Clause", "GPL-2.0+", "LGPL-3.0+", "MIT" e "(BSD-2-Clause OR Ruby)". Não inclua aspas simples ou aspas duplas.
    Se houver mais de uma linguagem, liste-as como valores separados por vírgula (espaços opcionais) e ordene-as da mais usada para a menos usada. Se houver uma longa lista, liste pelo menos as três primeiras mais comuns. Se não houver linguagem (por exemplo, este é um projeto apenas de documentação ou apenas de teste), use o caractere único "-". Use uma capitalização convencional para cada linguagem, por exemplo, "JavaScript".
    O Common Platform Enumeration (CPE) é um esquema de nomenclatura estruturado para sistemas de tecnologia da informação, software e pacotes. Ele é usado em vários sistemas e bancos de dados ao relatar vulnerabilidades.

 Controles 15/19 ●

  • Controles


    Quando uma tarefa de CI/CD é executada sem permissões especificadas, o sistema de CI/CD DEVE definir como padrão as permissões da tarefa para as menores permissões concedidas no pipeline. [OSPS-AC-04.01]
    Configure as definições do projeto para atribuir as menores permissões disponíveis a novos pipelines por padrão, concedendo permissões adicionais somente quando necessário para tarefas específicas.

    https://github.com/laurentftech/pi-outpost/blob/main/.github/workflows/ci.yml
    GitHub Actions repository settings were checked on 2026-11-08: default_workflow_permissions=read and workflows cannot approve PRs. CI, release, Docker and CodeQL declare contents: read defaults. Write permissions are declared explicitly on the jobs that publish releases/images, attest provenance, update the coverage badge or upload security results. Scorecard has a read-only workflow default and explicitly scoped analysis-job permissions.



    Quando um lançamento oficial é criado, esse lançamento DEVE receber um identificador de versão único. [OSPS-BR-02.01]
    Atribua um identificador de versão único a cada versão de lançamento produzida pelo projeto, seguindo uma convenção de nomenclatura ou esquema de numeração consistente. Exemplos incluem SemVer, CalVer ou id de commit git.

    https://github.com/laurentftech/pi-outpost/releases/tag/v0.61.0
    Official releases have unique Semantic Versioning identifiers, recorded in manifests and git tags (for example v0.61.0). The release workflow checks tag/package-version consistency and avoids republishing versions already on npm. Packages, executables, GitHub Releases and versioned container tags are associated with that version.



    Quando um lançamento oficial é criado, esse lançamento DEVE conter um registro descritivo de modificações funcionais e de segurança. [OSPS-BR-04.01]
    Certifique-se de que todos os lançamentos incluam um registro de alterações descritivo. É recomendado garantir que o registro de alterações seja legível por humanos e inclua detalhes além das mensagens de commit, como descrições do impacto de segurança ou relevância para diferentes casos de uso. Para garantir a legibilidade por máquina, coloque o conteúdo sob um cabeçalho markdown como \"## Changelog\"."

    Non-trivial release notes file in repository: https://github.com/laurentftech/pi-outpost/blob/main/CHANGELOG.md.
    CHANGELOG.md has a human-readable section per release (Added / Changed / Fixed), written for users, not a raw commit log. The release workflow refuses to publish a version without its changelog section, uses that section as the GitHub Release notes, and ships the changelog inside the package so the app shows it after an update. [release_notes]



    Quando um pipeline de compilação e lançamento ingere dependências, ele DEVE usar ferramentas padronizadas quando disponíveis. [OSPS-BR-05.01]
    Use ferramentas comuns para o seu ecossistema, como gerenciadores de pacotes ou ferramentas de gerenciamento de dependências para ingerir dependências no momento da compilação. Isso pode incluir o uso de um arquivo de dependências, arquivo de bloqueio ou manifesto para especificar as dependências necessárias, que são então incorporadas pelo sistema de compilação.

    https://github.com/laurentftech/pi-outpost/blob/main/package-lock.json
    Workspace package.json manifests declare dependencies and package-lock.json records the resolved dependency graph in machine-readable JSON. [external_dependencies]



    Quando um lançamento oficial é criado, esse lançamento DEVE ser assinado ou contabilizado em um manifesto assinado incluindo os hashes criptográficos de cada ativo. [OSPS-BR-06.01]
    Assine todos os ativos de software lançados no momento da construção com uma assinatura criptográfica ou atestados, como assinatura GPG ou PGP, assinaturas Sigstore, proveniência SLSA ou VSAs SLSA. Inclua os hashes criptográficos de cada ativo em um manifesto assinado ou arquivo de metadados.

    https://github.com/laurentftech/pi-outpost/releases/tag/v0.61.0
    All five released software files (three platform executables and two MCP bundles) are covered by the signed SLSA provenance statement in pi-outpost-0.61.0.sigstore.json. On 2026-11-08 each downloaded file passed gh attestation verify against that bundle, repository laurentftech/pi-outpost, signer workflow .github/workflows/release.yml and source ref refs/tags/v0.61.0; GitHub-hosted runners were required. An altered MCP bundle was rejected. The certificate binds the release to commit d8928a87d57e419aab78a89756e5b64ce37898e0. npm packages are published through OIDC with provenance. Verification instructions: https://github.com/laurentftech/pi-outpost/blob/main/docs/sea-packaging.md#verify-a-download



    Quando o projeto tiver feito um lançamento, a documentação do projeto DEVE incluir uma descrição de como o projeto seleciona, obtém e rastreia suas dependências. [OSPS-DO-06.01]
    É recomendado publicar essas informações juntamente com a documentação técnica e de design do projeto em um recurso publicamente visível, como o repositório de código-fonte, site do projeto ou outro canal.

    https://github.com/laurentftech/pi-outpost/blob/main/docs/development.md#dependency-maintenance
    Dependency choices and constraints are documented: jsdom is held for Blob/object-URL compatibility, TypeBox is pinned for validator-contract compatibility, and KaTeX overrides address a named advisory. CONTRIBUTING.md requires review of new install scripts and retention of third-party license notices. Dependencies are obtained through npm ci with committed manifests/lockfiles and integrity hashes; the pinned npm toolchain has its own lockfile. The guide documents how to update the toolchain, track upstream fixes and assess exceptions; Dependabot tracks advisories.



    A documentação do projeto DEVE incluir instruções sobre como compilar o software, incluindo bibliotecas, frameworks, SDKs e dependências necessários. [OSPS-DO-07.01]
    Recomenda-se publicar essas informações junto com a documentação de colaboradores do projeto, como em CONTRIBUTING.md ou outra documentação de tarefas de desenvolvimento. Isso também pode ser documentado usando alvos de Makefile ou outros scripts de automação.

    https://github.com/laurentftech/pi-outpost/blob/main/CONTRIBUTING.md#development-setup
    The development guide specifies Node.js 24, Git, npm 12.2.2, native dependency prerequisites, npm ci, development and build commands. Node 26 is used for release executables. The testing guide documents suite commands and Playwright installation.



    A documentação do projeto DEVE incluir uma lista dos membros do projeto com acesso a recursos sensíveis. [OSPS-GV-01.01]
    Documente os participantes do projeto e seus papéis através de artefatos como members.md, governance.md, maintainers.md ou arquivo similar dentro do repositório de código-fonte do projeto. Isso pode ser tão simples quanto incluir nomes ou identificadores de conta em uma lista de mantenedores, ou mais complexo dependendo da governança do projeto.

    https://github.com/laurentftech/pi-outpost/blob/main/GOVERNANCE.md#roles
    The governance document identifies Laurent Francoise (laurentftech) as the sole person with repository write access and npm publication rights. The GitHub collaborator inventory checked on 2026-11-08 contained only laurentftech (administrator). Future roles/access must be documented before permission is granted.



    A documentação do projeto DEVE incluir descrições dos papéis e responsabilidades dos membros do projeto [OSPS-GV-01.02]
    Documente os participantes do projeto e seus papéis através de artefatos como members.md, governance.md, maintainers.md ou arquivo similar dentro do repositório de código-fonte do projeto.

    GOVERNANCE.md § Roles (https://github.com/laurentftech/pi-outpost/blob/main/GOVERNANCE.md#roles) lists the roles and their responsibilities. The maintainer (the only account with write access and npm publish rights) sets direction, reviews and merges, releases, handles vulnerability reports and enforces the code of conduct. Contributors propose changes by issue or pull request and get no access by contributing. New roles are documented there before any permission is granted. [roles_responsibilities]



    A documentação do projeto DEVE incluir um guia para contribuidores de código que inclua os requisitos para contribuições aceitáveis. [OSPS-GV-03.02]
    Estenda o conteúdo de CONTRIBUTING.md ou CONTRIBUTING/ na documentação do projeto para delinear os requisitos para contribuições aceitáveis, incluindo padrões de codificação, requisitos de testes e diretrizes de submissão para contribuidores de código. É recomendado que este guia seja a fonte da verdade tanto para contribuidores quanto para aprovadores.

    https://github.com/laurentftech/pi-outpost/blob/main/CONTRIBUTING.md#changes-and-tests

    CONTRIBUTING.md states the requirements for acceptable contributions: follow the surrounding TypeScript/React conventions, keep each PR focused, avoid unrelated formatting and dependency churn, and pass npm run typecheck (strict TypeScript), npm run lint (Oxlint, enforced in CI) and the server/UI test suites, plus the e2e suite for user-visible changes. Security-sensitive changes require negative-case tests and a review of the trust boundary ("Dependencies and security-sensitive changes"), and PRs must update affected documentation and include a Documentation impact note ("Pull requests"). What each check enforces is described in docs/quality.md. [contribution_requirements]



    O sistema de controle de versão DEVE exigir que todos os contribuidores de código afirmem que estão legalmente autorizados a fazer as contribuições associadas em cada commit. [OSPS-LE-01.01]
    Inclua um DCO no repositório do projeto, exigindo que os contribuidores de código afirmem que estão legalmente autorizados a confirmar as contribuições associadas em cada commit. Use uma verificação de status para garantir que a afirmação seja feita. Um CLA também satisfaz este requisito. Alguns sistemas de controle de versão, como o GitHub, podem incluir isso nos termos de serviço da plataforma.

    https://github.com/laurentftech/pi-outpost/blob/main/CONTRIBUTING.md
    Contributions are licensed under MIT, but the contribution policy, CI workflows and active repository rules do not require contributors to assert legal authorization on every commit. No mandatory DCO/CLA or equivalent per-commit control is configured.



    Quando um commit é feito na branch primária, quaisquer verificações de status automatizadas para commits DEVEM passar ou ser manualmente ignoradas. [OSPS-QA-03.01]
    Configure o sistema de controle de versão do projeto para exigir que todas as verificações de status automatizadas passem ou exijam reconhecimento manual antes que um commit possa ser mesclado na branch primária. É recomendado que quaisquer verificações de status opcionais NÃO sejam configuradas como um requisito de aprovação ou reprovação que os aprovadores possam ser tentados a ignorar.

    https://github.com/laurentftech/pi-outpost/rules/22049027
    The active protect_main ruleset requires CI ok and Analyze (actions), Analyze (csharp), and Analyze (javascript-typescript), with an up-to-date branch and no bypass actors. CI ok fails when an applicable job fails or is cancelled. The documentation-only test exemption is explicitly documented in docs/quality.md.



    Antes de um commit ser aceito, os pipelines de CI/CD do projeto DEVEM executar pelo menos um conjunto de testes automatizados para garantir que as alterações atendam às expectativas. [OSPS-QA-06.01]
    Testes automatizados devem ser executados antes de cada mesclagem na branch primária. O conjunto de testes deve ser executado em um pipeline de CI/CD e os resultados devem ser visíveis a todos os contribuidores. O conjunto de testes deve ser executado em um ambiente consistente e deve ser executado de uma maneira que permita aos contribuidores executar os testes localmente. Exemplos de conjuntos de testes incluem testes unitários, testes de integração e testes de ponta a ponta.

    https://github.com/laurentftech/pi-outpost/blob/main/docs/quality.md#documentation-only-pull-requests
    Code PRs must pass automated test suites before merge through CI ok. Documentation-only PRs deliberately skip all test suites and can merge after classification and CodeQL. Therefore the literal requirement to run at least one automated test suite before every accepted commit is not met; post-merge tests on main do not close that pre-merge exception.



    Quando o projeto tiver feito um lançamento, a documentação do projeto DEVE incluir documentação de design demonstrando todas as ações e atores dentro do sistema. [OSPS-SA-01.01]
    Inclua designs na documentação do projeto que expliquem as ações e atores. Atores incluem qualquer subsistema ou entidade que possa influenciar outro segmento no sistema. Certifique-se de que isso seja atualizado para novos recursos ou mudanças que quebrem compatibilidade.

    https://github.com/laurentftech/pi-outpost/blob/main/docs/development.md#runtime-architecture
    Design documentation is distributed across the runtime architecture (UI/widget, Fastify/WebSocket, per-project sessions, embedded/RPC agent runtimes), sandboxing and configuration guides (tools, terminal, extensions, MCP and operator controls), openwebui-architecture.md (actors, components, end-to-end tool-call sequence, storage and trust), and claude-desktop.md (stdio MCP hosts, local revisioned stores and shared apps-core/posters components). These cover the standalone, embedded, Open WebUI and Claude Desktop distributions and their principal actors/actions.



    Quando o projeto tiver feito um lançamento, a documentação do projeto DEVE incluir descrições de todas as interfaces de software externas dos ativos de software lançados. [OSPS-SA-02.01]
    Documente todas as interfaces de software (APIs) dos ativos de software lançados, explicando como os usuários podem interagir com o software e quais dados são esperados ou produzidos. Certifique-se de que isso seja atualizado para novos recursos ou mudanças que quebrem compatibilidade.

    https://github.com/laurentftech/pi-outpost/blob/main/server/src/index.ts
    CLI, configuration, embedding and integration guides exist, and the Open WebUI server exposes an OpenAPI description. Comparing the actual HTTP routes against the documentation found GET /files/download implemented in server/src/index.ts but absent from the user/developer reference documents. There is also no complete external WebSocket message reference accompanying the protocol types. The requirement to document all external interfaces is consequently not met.



    Quando o projeto tiver feito um lançamento, o projeto DEVE realizar uma avaliação de segurança para compreender os problemas de segurança potenciais mais prováveis e impactantes que poderiam ocorrer dentro do software. [OSPS-SA-03.01]
    Realizar uma avaliação de segurança informa tanto os membros do projeto quanto os consumidores a jusante que o projeto compreende quais problemas poderiam surgir dentro do software. Compreender quais ameaças poderiam se concretizar ajuda o projeto a gerenciar e tratar riscos. Essa informação é útil para os consumidores a jusante demonstrarem a perspicácia e as práticas de segurança do projeto. Certifique-se de que isso seja atualizado para novos recursos ou mudanças disruptivas.

    https://github.com/laurentftech/pi-outpost/blob/main/SECURITY.md#relevant-security-boundaries
    Security assessment is recorded in the security-boundary policy, sandbox investigations and feature design risk analyses. The auth-token design assesses XSS token theft, intermediary URL logs, brute force and browser-origin attacks; document extraction designs assess hostile documents, path confinement and resource exhaustion. openwebui-architecture.md assesses forged/replayed identities, cross-user access, iframe isolation, scoped poster-save capabilities and unencrypted data at rest. The Docker design assesses namespace/procfs/network boundaries and records actual confinement probes. These assessments identify concrete impacts, mitigations and accepted limitations rather than relying on test pass counts alone.



    A documentação do projeto DEVE incluir uma política de divulgação coordenada de vulnerabilidades (CVD), com um prazo claro para resposta. [OSPS-VM-01.01]
    Crie um arquivo SECURITY.md na raiz do diretório, descrevendo a política do projeto para divulgação coordenada de vulnerabilidades. Inclua um método para relatar vulnerabilidades. Estabeleça expectativas sobre como o projeto responderá e tratará problemas relatados.

    https://github.com/laurentftech/pi-outpost/blob/main/SECURITY.md#reporting-a-vulnerability
    A private coordinated disclosure process exists, but SECURITY.md explicitly says response/remediation times depend on availability and impact and no fixed deadline is promised. The required clear response timeframe is therefore not currently documented.



    A documentação do projeto DEVE fornecer um meio de relatar vulnerabilidades de forma privada diretamente aos contatos de segurança do projeto. [OSPS-VM-03.01]
    Forneça um meio para que pesquisadores de segurança relatem vulnerabilidades privadamente ao projeto. Isso pode ser um endereço de e-mail dedicado, um formulário web, ferramentas especializadas do VCS, endereços de e-mail para contatos de segurança ou outros métodos.

    URL : https://github.com/laurentftech/pi-outpost/security/advisories/new
    Private vulnerability reporting is enabled on the repository; SECURITY.md points to the private form and asks reporters to keep details out of public issues. [vulnerability_report_private]



    A documentação do projeto DEVE publicar publicamente dados sobre vulnerabilidades descobertas. [OSPS-VM-04.01]
    Forneça informações sobre vulnerabilidades conhecidas em um canal público previsível, como uma entrada CVE, postagem em blog ou outro meio. Na medida do possível, essa informação deve incluir versão(ões) afetada(s), como um consumidor pode determinar se está vulnerável e instruções para mitigação ou remediação.

    https://github.com/laurentftech/pi-outpost/blob/main/SECURITY.md#reporting-a-vulnerability
    The documented policy publishes a GitHub security advisory with its GHSA identifier when a confirmed pi-outpost vulnerability is fixed, requests a CVE, and records the identifiers and affected/fixed versions in a Security section of the release notes. This states the publication process and does not invent a previously published vulnerability.



Você pode usar ferramentas e sistemas de IA para propor alterações por meio de uma URL simples, como https://www.bestpractices.dev/pt-BR/projects/16423/choose/edit?osps_ac_01_01_status=Met&osps_ac_01_01_justification=GitHub+enforced. Veja nosso sistema de propostas de automação para saber como fazer isso. Estes dados estão disponíveis sob o Community Data License Agreement – Permissive, Version 2.0 (CDLA-Permissive-2.0). Isso significa que um Destinatário de Dados pode compartilhar os Dados, com ou sem modificações, desde que o Destinatário de Dados disponibilize o texto deste acordo com os Dados compartilhados. Por favor, dê crédito a Laurent e aos contribuidores do selo de melhores práticas OpenSSF.

Entrada de selo do projeto de propriedade de: Laurent.
Entrada criada em 2026-11-07 12:35:44 UTC, última atualização em 2026-11-08 19:31:42 UTC. Selo de aprovação alcançado pela última vez em 2026-11-07 13:32:38 UTC.