pi-outpost

Проекты, которые следуют приведенным ниже лучшим практикам, могут добровольно и самостоятельно оценить себя и продемонстрировать, что они получили значок Open Source Security Foundation (OpenSSF).

Не существует набора практик, гарантирующего, что у программного обеспечения никогда не будет недостатков или уязвимостей; даже формальные методы могут не помочь, если спецификации или допущения ошибочны. Также не существует какой-либо практики, которая могла бы гарантировать, что проект будет поддерживать здоровое и хорошо функционирующее сообщество разработчиков. Однако следующие хорошие правила могут помочь улучшить результаты проектов. Например, некоторые правила описывают ревью несколькими участниками перед выпуском, что может помочь найти технические уязвимости, которые было бы сложно найти другим способом, и помочь построить доверие и желание дальнейшего взаимодействия между разработчиками из разных компаний. Чтобы получить значок, нужно выполнить все критерии с ключевыми словами "НЕОБХОДИМО"/"ОБЯЗАН"/"НЕДОПУСТИМО", все критерии со словом "СЛЕДУЕТ" либо должны удовлетворяться, либо должно быть приведено обоснование их невыполнения, и все критерии со словом "ЖЕЛАТЕЛЬНО" могут быть удовлетворены ИЛИ неудовлетворены (желательно, чтобы они были хотя бы рассмотрены). Если вы хотите ввести общий комментарий вместо объяснения, почему текущая ситуация приемлема, начните текст с '//' и пробела. Приветствуется обратная связь через сайт на GitHub в виде issues или pull requests. Существует также список рассылки для общих вопросов.

Мы с удовольствием предоставляем информацию на нескольких языках, однако, если есть какой-либо конфликт или несоответствие между переводами, английская версия является авторитетной.
Если это ваш проект, пожалуйста, отобразите статус вашего базового значка на странице проекта! Статус базового значка выглядит так: Базовый уровень значка для проекта 16423 - baseline-1 Вот как встроить базовый значок:
Вы можете показать статус базового значка, вставив это в ваш файл markdown:
[![OpenSSF Baseline](https://www.bestpractices.dev/projects/16423/baseline)](https://www.bestpractices.dev/projects/16423)
или вставив это в ваш HTML:
<a href="https://www.bestpractices.dev/projects/16423"><img src="https://www.bestpractices.dev/projects/16423/baseline"></a>


Это критерии Базового Уровня 2. Это критерии версии v2026.08.28.

Baseline Series: Базовый уровень 1 Базовый Уровень 2 Базовый Уровень 3

        

 Основы

  • Общая

    Обратите внимание, что другие проекты могут использовать то же имя.

    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.

    Используйте формат выражения лицензии SPDX; примеры включают «Apache-2.0», «BSD-2-Clause», «BSD-3-Clause», «GPL-2.0+», «LGPL-3.0+», «MIT» и «(BSD-2-Clause OR Ruby)».
    Если используется более одного языка, перечислите их через запятую (пробелы необязательны), и отсортируйте их от наиболее до наименее используемого. Если список длинный, пожалуйста, перечислите по крайней мере три наиболее распространенных. Если языка нет (например, это проект только для документации или только для тестирования), используйте один символ «-» (минус). Для каждого языка используйте общепринятую капитализацию названия, например «JavaScript».
    Common Platform Enumeration (CPE) - это структурированная схема именования для информационных систем, программного обеспечения и пакетов. Она используется в ряде систем и баз данных для отчетов об уязвимостях.

 Элементы управления 15/19 ●

  • Элементы управления


    Когда задача CI/CD выполняется без указания прав доступа, система CI/CD ОБЯЗАНА по умолчанию назначать задаче минимальные права, предоставленные в конвейере. [OSPS-AC-04.01]
    Настройте параметры проекта для назначения минимальных доступных прав новым конвейерам по умолчанию, предоставляя дополнительные права только при необходимости для конкретных задач.

    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.



    Когда создается официальный выпуск, этому выпуску ОБЯЗАН быть назначен уникальный идентификатор версии. [OSPS-BR-02.01]
    Присваивайте уникальный идентификатор версии каждому выпуску, создаваемому проектом, следуя согласованному соглашению о наименовании или схеме нумерации. Примеры включают SemVer, CalVer или идентификатор коммита 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.



    Когда создается официальный выпуск, этот выпуск ОБЯЗАН содержать описательный журнал функциональных изменений и изменений безопасности. [OSPS-BR-04.01]
    Убедитесь, что все выпуски содержат описательный журнал изменений. Рекомендуется обеспечить, чтобы журнал изменений был читаемым человеком и содержал более подробные сведения, чем сообщения коммитов, такие как описания влияния на безопасность или релевантность для различных сценариев использования. Для обеспечения машиночитаемости размещайте содержимое под заголовком markdown, таким как "## 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]



    Когда конвейер сборки и выпуска загружает зависимости, он ОБЯЗАН использовать стандартизированные инструменты, где они доступны. [OSPS-BR-05.01]
    Используйте общие инструменты для вашей экосистемы, такие как менеджеры пакетов или инструменты управления зависимостями для загрузки зависимостей во время сборки. Это может включать использование файла зависимостей, lock-файла или манифеста для указания требуемых зависимостей, которые затем подключаются системой сборки.

    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]



    Когда создается официальный выпуск, этот выпуск ОБЯЗАН быть подписан или учтен в подписанном манифесте, включающем криптографические хеши каждого актива. [OSPS-BR-06.01]
    Подписывайте все выпущенные программные активы во время сборки с использованием криптографической подписи или аттестаций, таких как подпись GPG или PGP, подписи Sigstore, происхождение SLSA или SLSA VSA. Включите криптографические хеши каждого актива в подписанный манифест или файл метаданных.

    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



    Когда проект создал выпуск, документация проекта ОБЯЗАНА включать описание того, как проект выбирает, получает и отслеживает свои зависимости. [OSPS-DO-06.01]
    Рекомендуется публиковать эту информацию вместе с технической документацией и документацией по дизайну проекта в общедоступном ресурсе, таком как репозиторий исходного кода, веб-сайт проекта или другой канал.

    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.



    Документация проекта ДОЛЖНА включать инструкции по сборке программного обеспечения, включая необходимые библиотеки, фреймворки, SDK и зависимости. [OSPS-DO-07.01]
    Рекомендуется публиковать эту информацию вместе с документацией для участников проекта, например в файле CONTRIBUTING.md или другой документации по задачам разработчика. Это также может быть задокументировано с помощью целей Makefile или других сценариев автоматизации.

    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.



    Документация проекта ОБЯЗАНА включать список участников проекта, имеющих доступ к чувствительным ресурсам. [OSPS-GV-01.01]
    Документируйте участников проекта и их роли с помощью таких артефактов, как members.md, governance.md, maintainers.md или аналогичного файла в репозитории исходного кода проекта. Это может быть просто включение имен или учетных записей в список сопровождающих или более сложное в зависимости от управления проектом.

    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.



    Документация проекта ОБЯЗАНА включать описания ролей и обязанностей участников проекта. [OSPS-GV-01.02]
    Документируйте участников проекта и их роли с помощью таких артефактов, как members.md, governance.md, maintainers.md или аналогичного файла в репозитории исходного кода проекта.

    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]



    Документация проекта ОБЯЗАНА включать руководство для авторов кода, содержащее требования к приемлемым вкладам. [OSPS-GV-03.02]
    Расширьте содержимое CONTRIBUTING.md или CONTRIBUTING/ в документации проекта, чтобы изложить требования к приемлемым вкладам, включая стандарты кодирования, требования к тестированию и руководства по отправке для участников кода. Рекомендуется, чтобы это руководство было источником истины как для участников, так и для утверждающих.

    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]



    Система управления версиями ОБЯЗАНА требовать от всех авторов кода подтверждения того, что они юридически уполномочены вносить соответствующие изменения, при каждом коммите. [OSPS-LE-01.01]
    Включите DCO в репозиторий проекта, требуя от участников кода утверждать, что они имеют законное право вносить соответствующий вклад в каждом коммите. Используйте проверку статуса, чтобы убедиться, что утверждение сделано. CLA также удовлетворяет этому требованию. Некоторые системы контроля версий, такие как GitHub, могут включать это в условия обслуживания платформы.

    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.



    При внесении коммита в основную ветку все автоматические проверки статуса для коммитов ДОЛЖНЫ пройти успешно или быть явно обойдены вручную. [OSPS-QA-03.01]
    Настройте систему контроля версий проекта таким образом, чтобы все автоматические проверки статуса должны были пройти успешно или требовать ручного подтверждения перед тем, как коммит может быть объединен с основной веткой. Рекомендуется НЕ настраивать необязательные проверки статуса как требование успешного прохождения или провала, которые утверждающие могут быть склонны обойти.

    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.



    Перед принятием коммита в проекте ДОЛЖЕН выполняться хотя бы один автоматизированный набор тестов в конвейере CI/CD для обеспечения соответствия изменений ожиданиям. [OSPS-QA-06.01]
    Автоматизированные тесты должны выполняться перед каждым объединением с основной веткой. Набор тестов должен выполняться в конвейере CI/CD, и результаты должны быть видны всем участникам. Набор тестов должен выполняться в согласованной среде и таким образом, чтобы участники могли выполнять тесты локально. Примеры наборов тестов включают модульные тесты, интеграционные тесты и сквозные тесты.

    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.



    Когда проект выпустил релиз, документация проекта ДОЛЖНА включать проектную документацию, демонстрирующую все действия и участников в системе. [OSPS-SA-01.01]
    Включите в документацию проекта проектные описания, объясняющие действия и участников. Участники включают любую подсистему или сущность, которая может повлиять на другой сегмент в системе. Убедитесь, что эта информация обновляется для новых функций или критических изменений.

    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.



    Когда проект выпустил релиз, документация проекта ДОЛЖНА включать описания всех внешних программных интерфейсов выпущенных программных активов. [OSPS-SA-02.01]
    Документируйте все программные интерфейсы (API) выпущенных программных активов, объясняя, как пользователи могут взаимодействовать с программным обеспечением и какие данные ожидаются или производятся. Убедитесь, что эта информация обновляется для новых функций или критических изменений.

    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.



    Когда проект выпустил релиз, проект ДОЛЖЕН провести оценку безопасности для понимания наиболее вероятных и значимых потенциальных проблем безопасности, которые могут возникнуть в программном обеспечении. [OSPS-SA-03.01]
    Проведение оценки безопасности информирует как членов проекта, так и конечных потребителей о том, что проект понимает, какие проблемы могут возникнуть в программном обеспечении. Понимание того, какие угрозы могут быть реализованы, помогает проекту управлять рисками и справляться с ними. Эта информация полезна для конечных потребителей для демонстрации компетентности в области безопасности и практик проекта. Убедитесь, что эта информация обновляется для новых функций или критических изменений.

    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.



    Документация проекта ОБЯЗАНА включать политику скоординированного раскрытия информации об уязвимостях (CVD) с четко определенными сроками реагирования. [OSPS-VM-01.01]
    Создайте файл SECURITY.md в корневом каталоге, описывающий политику проекта для координированного раскрытия уязвимостей. Включите метод сообщения об уязвимостях. Установите ожидания относительно того, как проект будет реагировать и решать сообщенные проблемы.

    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.



    Документация проекта ОБЯЗАНА предоставлять способ конфиденциального сообщения об уязвимостях непосредственно контактам по вопросам безопасности в проекте. [OSPS-VM-03.01]
    Предоставьте средства для того, чтобы исследователи безопасности могли приватно сообщать об уязвимостях в проект. Это может быть специальный адрес электронной почты, веб-форма, специализированные инструменты системы контроля версий, адреса электронной почты контактов по безопасности или другие методы.

    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]



    Документация проекта ОБЯЗАНА публично публиковать данные об обнаруженных уязвимостях. [OSPS-VM-04.01]
    Предоставляйте информацию об известных уязвимостях в предсказуемом публичном канале, таком как запись CVE, запись в блоге или другом носителе. По мере возможности эта информация должна включать затронутые версии, как потребитель может определить, уязвим ли он, и инструкции по смягчению последствий или исправлению.

    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.



Вы можете использовать инструменты и системы ИИ для предложения изменений через простой URL, например https://www.bestpractices.dev/ru/projects/16423/choose/edit?osps_ac_01_01_status=Met&osps_ac_01_01_justification=GitHub+enforced. Смотрите нашу систему автоматизированных предложений о том, как это сделать. Эти данные доступны по лицензии Community Data License Agreement – Permissive, Version 2.0 (CDLA-Permissive-2.0). Это означает, что получатель данных может распространять данные с изменениями или без них, при условии, что получатель данных предоставляет текст данного соглашения вместе с распространяемыми данными. Пожалуйста, укажите в качестве источника Laurent и участников OpenSSF Best Practices badge.

Владелец анкеты на значок проекта: Laurent.
2026-11-07 12:35:44 UTC, последнее изменение сделано 2026-11-08 19:31:42 UTC. Последний раз условия для получения значка были выполнены 2026-11-07 13:32:38 UTC.