pi-outpost

Projekte, die den nachfolgenden Best Practices folgen, können sich freiwillig selbst zertifizieren und zeigen, dass sie einen Core-Infrastruktur-Initiative-/OpenSSF-Badge erhalten haben.

Es gibt keine Auswahl an Praktiken, die garantieren können, dass Software niemals Fehler oder Schwachstellen hat. Selbst formale Methoden können fehlschlagen, wenn die Spezifikationen oder Annahmen falsch sind. Auch gibt es keine Auswahl an Praktiken, die garantieren können, dass ein Projekt eine gesunde und gut funktionierende Entwicklungsgemeinschaft erhalten wird. Allerdings können Best Practices dabei helfen, die Ergebnisse von Projekten zu verbessern. Zum Beispiel ermöglichen einige Praktiken die Mehrpersonen-Überprüfung vor der Freigabe, die sowohl helfen können ansonsten schwer zu findende technische Schwachstellen zu finden und gleichzeitig dazu beitragen Vertrauen und den Wunsch nach wiederholter Zusammenarbeit zwischen Entwicklern verschiedener Unternehmen zu schaffen. Um ein Badge zu verdienen, müssen alle MÜSSEN und MÜSSEN NICHT Kriterien erfüllt sein, alle SOLLTEN Kriterien müssen erfüllt sein oder eine Rechtfertigung enthalten, und alle EMPFHOLEN Kriterien müssen erfüllt sein oder nicht (wir wollen sie zumindest berücksichtigt wissen). Wenn lediglich ein allgemeiner Kommentar angebeben werden soll, keine direkte Begründung, dann ist das erlaubt, wenn der Text mit "//" und einem Leerzeichen beginnt. Feedback ist willkommen auf derGitHub-Website als Issue oder Pull-Request. Es gibt auch eine E-Mail-Liste für allgemeine Diskussionen.

Wir stellen Ihnen gerne die Informationen in mehreren Sprachen zur Verfügung, allerdings ist die englische Version maßgeblich, insbesondere wenn es Konflikte oder Inkonsistenzen zwischen den Übersetzungen gibt.
Wenn dies Ihr Projekt ist, zeigen Sie bitte Ihren Baseline-Badge-Status auf Ihrer Projektseite! Der Baseline-Badge-Status sieht so aus: Baseline-Badge-Level für Projekt 16423 ist baseline-1 So betten Sie das Baseline-Badge ein:
Sie können Ihren Baseline-Badge-Status anzeigen, indem Sie Folgendes in Ihre Markdown-Datei einbetten:
[![OpenSSF Baseline](https://www.bestpractices.dev/projects/16423/baseline)](https://www.bestpractices.dev/projects/16423)
oder indem Sie Folgendes in Ihr HTML einbetten:
<a href="https://www.bestpractices.dev/projects/16423"><img src="https://www.bestpractices.dev/projects/16423/baseline"></a>


Dies sind die Baseline Niveau 2 Kriterien. Dies sind Kriterienversion v2026.08.28.

Baseline Series: Baseline Niveau 1 Baseline Niveau 2 Baseline Niveau 3

        

 Grundlagen

  • Allgemein

    Hinweis: Andere Projekte können den selben Namen benutzen.

    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.

    Bitte verwenden Sie das SPDX-License-Expression-Format; Beispiele sind "Apache-2.0", "BSD-2-Clause", "BSD-3-Clause", "GPL-2.0+", "LGPL-3.0+", "MIT" und "(BSD-2-Clause OR Ruby)". Geben sie nicht die einfachen oder doppelten Anführungszeichen mit an.
    Wenn es mehr als eine Programmiersprache gibt, listen Sie sie als kommagetrennte Werte (Leerzeichen sind optional) auf und sortieren Sie sie von am häufigsten zum am wenigsten verwendeten. Wenn es eine lange Liste gibt, bitte mindestens die ersten drei häufigsten auflisten. Wenn es keine Programmiersprache gibt (z. B. ist dies nur ein Dokumentations- oder Testprojekt), verwenden Sie das einzelne Zeichen "-". Bitte verwenden Sie eine herkömmliche Großschreibung für jede Sprache, z.B. "JavaScript".
    Das Common Platform Enumeration (CPE) ist ein strukturiertes Namensschema für IT-Systeme, Software und Pakete. Es wird in diversen Systemen und Datenbanken bei der Meldung von Schwachstellen verwendet.

 Steuerelemente 15/19 ●

  • Steuerelemente


    Wenn eine CI/CD-Aufgabe ohne angegebene Berechtigungen ausgeführt wird, MUSS das CI/CD-System die Berechtigungen der Aufgabe standardmäßig auf die niedrigsten in der Pipeline gewährten Berechtigungen setzen. [OSPS-AC-04.01]
    Konfigurieren Sie die Einstellungen des Projekts so, dass neuen Pipelines standardmäßig die niedrigsten verfügbaren Berechtigungen zugewiesen werden, wobei zusätzliche Berechtigungen nur bei Bedarf für bestimmte Aufgaben gewährt werden.

    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.



    Wenn ein offizieller Release erstellt wird, MUSS diesem Release eine eindeutige Versionskennung zugewiesen werden. [OSPS-BR-02.01]
    Weisen Sie jedem vom Projekt erstellten Release eine eindeutige Versionskennung zu und folgen Sie dabei einer konsistenten Namenskonvention oder einem Nummerierungsschema. Beispiele sind SemVer, CalVer oder Git-Commit-ID.

    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.



    Wenn ein offizieller Release erstellt wird, MUSS dieser Release ein beschreibendes Protokoll funktionaler und sicherheitsrelevanter Änderungen enthalten. [OSPS-BR-04.01]
    Stellen Sie sicher, dass alle Releases ein beschreibendes Änderungsprotokoll enthalten. Es wird empfohlen sicherzustellen, dass das Änderungsprotokoll von Menschen lesbar ist und Details über Commit-Nachrichten hinaus enthält, wie z.B. Beschreibungen der Sicherheitsauswirkung oder Relevanz für verschiedene Anwendungsfälle. Um Maschinenlesbarkeit zu gewährleisten, platzieren Sie den Inhalt unter einer Markdown-Überschrift wie "## 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]



    Wenn eine Build- und Release-Pipeline Abhängigkeiten einbindet, MUSS sie standardisierte Tools verwenden, wo verfügbar. [OSPS-BR-05.01]
    Verwenden Sie ein gängiges Tool für Ihr Ökosystem, wie z.B. Paketmanager oder Abhängigkeits-Management-Tools, um Abhängigkeiten zur Build-Zeit einzubinden. Dies kann die Verwendung einer Abhängigkeitsdatei, Lock-Datei oder Manifest umfassen, um die erforderlichen Abhängigkeiten zu spezifizieren, die dann vom Build-System eingezogen werden.

    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]



    Wenn ein offizieller Release erstellt wird, MUSS dieser Release signiert sein oder in einem signierten Manifest erfasst werden, das die kryptographischen Hashes jedes Assets enthält. [OSPS-BR-06.01]
    Signieren Sie alle freigegebenen Software-Assets zur Build-Zeit mit einer kryptographischen Signatur oder Attestierungen, wie z.B. GPG- oder PGP-Signatur, Sigstore-Signaturen, SLSA-Provenance oder SLSA-VSAs. Fügen Sie die kryptographischen Hashes jedes Assets in eine signierte Manifest- oder Metadaten-Datei ein.

    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



    Wenn das Projekt ein Release erstellt hat, MUSS die Projektdokumentation eine Beschreibung enthalten, wie das Projekt seine Abhängigkeiten auswählt, bezieht und verfolgt. [OSPS-DO-06.01]
    Es wird empfohlen, diese Informationen zusammen mit der technischen und Design-Dokumentation des Projekts auf einer öffentlich zugänglichen Ressource wie dem Quellcode-Repository, der Projektwebsite oder einem anderen Kanal zu veröffentlichen.

    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.



    Die Projektdokumentation MUSS Anweisungen enthalten, wie die Software gebaut wird, einschließlich erforderlicher Bibliotheken, Frameworks, SDKs und Abhängigkeiten. [OSPS-DO-07.01]
    Es wird empfohlen, diese Informationen zusammen mit der Beiträgerdokumentation des Projekts zu veröffentlichen, z. B. in CONTRIBUTING.md oder anderen Entwickleraufgabendokumentationen. Dies kann auch mithilfe von Makefile-Zielen oder anderen Automatisierungsskripten dokumentiert werden.

    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.



    Die Projektdokumentation MUSS eine Liste der Projektmitglieder mit Zugriff auf sensible Ressourcen enthalten. [OSPS-GV-01.01]
    Dokumentieren Sie Projektteilnehmer und ihre Rollen durch Artefakte wie members.md, governance.md, maintainers.md oder eine ähnliche Datei im Quellcode-Repository des Projekts. Dies kann so einfach sein wie die Aufnahme von Namen oder Account-Handles in einer Liste von Maintainern, oder komplexer sein, abhängig von der Governance des Projekts.

    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.



    Die Projektdokumentation MUSS Beschreibungen der Rollen und Verantwortlichkeiten der Projektmitglieder enthalten. [OSPS-GV-01.02]
    Dokumentieren Sie Projektteilnehmer und ihre Rollen durch Artefakte wie members.md, governance.md, maintainers.md oder ähnliche Dateien im Quellcode-Repository des Projekts.

    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]



    Die Projektdokumentation MUSS einen Leitfaden für Code-Mitwirkende enthalten, der die Anforderungen für akzeptable Beiträge beschreibt. [OSPS-GV-03.02]
    Erweitern Sie die Inhalte von CONTRIBUTING.md oder CONTRIBUTING/ in der Projektdokumentation, um die Anforderungen für akzeptable Beiträge zu beschreiben, einschließlich Codierungsstandards, Testanforderungen und Einreichungsrichtlinien für Code-Beitragende. Es wird empfohlen, dass dieser Leitfaden die verbindliche Quelle sowohl für Beitragende als auch für Genehmiger ist.

    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]



    Das Versionskontrollsystem MUSS bei jedem Commit von allen Code-Mitwirkenden verlangen zu bestätigen, dass sie rechtlich befugt sind, die zugehörigen Beiträge zu leisten. [OSPS-LE-01.01]
    Fügen Sie ein DCO in das Repository des Projekts ein, das Code-Beitragende dazu verpflichtet zu bestätigen, dass sie rechtlich berechtigt sind, die zugehörigen Beiträge bei jedem Commit zu leisten. Verwenden Sie eine Statusüberprüfung, um sicherzustellen, dass die Bestätigung erfolgt ist. Ein CLA erfüllt diese Anforderung ebenfalls. Einige Versionskontrollsysteme, wie GitHub, können dies in den Nutzungsbedingungen der Plattform enthalten.

    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.



    Wenn ein Commit in den primären Branch erfolgt, MÜSSEN alle automatisierten Statusüberprüfungen für Commits bestanden werden oder manuell umgangen werden. [OSPS-QA-03.01]
    Konfigurieren Sie das Versionskontrollsystem des Projekts so, dass alle automatisierten Statusüberprüfungen bestanden werden müssen oder eine manuelle Bestätigung erforderlich ist, bevor ein Commit in den primären Branch zusammengeführt werden kann. Es wird empfohlen, dass optionale Statusüberprüfungen NICHT als Bestehen-oder-Durchfallen-Anforderung konfiguriert werden, die Genehmiger versucht sein könnten zu umgehen.

    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.



    Bevor ein Commit akzeptiert wird, MÜSSEN die CI/CD-Pipelines des Projekts mindestens eine automatisierte Test-Suite ausführen, um sicherzustellen, dass die Änderungen den Erwartungen entsprechen. [OSPS-QA-06.01]
    Automatisierte Tests sollten vor jedem Merge in den primären Branch ausgeführt werden. Die Test-Suite sollte in einer CI/CD-Pipeline ausgeführt werden und die Ergebnisse sollten für alle Beitragenden sichtbar sein. Die Test-Suite sollte in einer konsistenten Umgebung ausgeführt werden und so ausgeführt werden, dass Beitragende die Tests lokal ausführen können. Beispiele für Test-Suites sind Unit-Tests, Integrationstests und End-to-End-Tests.

    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.



    Wenn das Projekt eine Veröffentlichung vorgenommen hat, MUSS die Projektdokumentation Design-Dokumentation enthalten, die alle Aktionen und Akteure innerhalb des Systems demonstriert. [OSPS-SA-01.01]
    Fügen Sie Designs in die Projektdokumentation ein, die die Aktionen und Akteure erklären. Akteure umfassen jedes Subsystem oder jede Entität, die ein anderes Segment im System beeinflussen kann. Stellen Sie sicher, dass dies für neue Funktionen oder Breaking Changes aktualisiert wird.

    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.



    Wenn das Projekt eine Veröffentlichung vorgenommen hat, MUSS die Projektdokumentation Beschreibungen aller externen Software-Schnittstellen der veröffentlichten Software-Assets enthalten. [OSPS-SA-02.01]
    Dokumentieren Sie alle Software-Schnittstellen (APIs) der veröffentlichten Software-Assets und erklären Sie, wie Benutzer mit der Software interagieren können und welche Daten erwartet oder produziert werden. Stellen Sie sicher, dass dies für neue Funktionen oder Breaking Changes aktualisiert wird.

    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.



    Wenn das Projekt eine Veröffentlichung vorgenommen hat, MUSS das Projekt eine Sicherheitsbewertung durchführen, um die wahrscheinlichsten und folgenschwersten potenziellen Sicherheitsprobleme zu verstehen, die innerhalb der Software auftreten könnten. [OSPS-SA-03.01]
    Die Durchführung einer Sicherheitsbewertung informiert sowohl Projektmitglieder als auch nachgelagerte Verbraucher darüber, dass das Projekt versteht, welche Probleme innerhalb der Software auftreten könnten. Das Verständnis darüber, welche Bedrohungen realisiert werden könnten, hilft dem Projekt, Risiken zu verwalten und anzugehen. Diese Informationen sind für nachgelagerte Verbraucher nützlich, um den Sicherheitssachverstand und die Praktiken des Projekts zu demonstrieren. Stellen Sie sicher, dass dies für neue Funktionen oder Breaking Changes aktualisiert wird.

    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.



    Die Projektdokumentation MUSS eine Richtlinie für die koordinierte Offenlegung von Schwachstellen (Coordinated Vulnerability Disclosure, CVD) mit einem klaren Zeitrahmen für die Reaktion enthalten. [OSPS-VM-01.01]
    Erstellen Sie eine SECURITY.md-Datei im Stammverzeichnis, die die Richtlinie des Projekts für koordinierte Offenlegung von Schwachstellen beschreibt. Fügen Sie eine Methode zur Meldung von Schwachstellen hinzu. Setzen Sie Erwartungen dafür, wie das Projekt reagieren und gemeldete Probleme angehen wird.

    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.



    Die Projektdokumentation MUSS eine Möglichkeit zur privaten Meldung von Schwachstellen direkt an die Sicherheitskontakte des Projekts bereitstellen. [OSPS-VM-03.01]
    Bieten Sie Sicherheitsforschern eine Möglichkeit, Schwachstellen privat an das Projekt zu melden. Dies kann eine dedizierte E-Mail-Adresse, ein Webformular, spezialisierte VCS-Tools, E-Mail-Adressen für Sicherheitskontakte oder andere Methoden sein.

    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]



    Die Projektdokumentation MUSS Daten über entdeckte Schwachstellen öffentlich veröffentlichen. [OSPS-VM-04.01]
    Bereitstellen von Informationen über bekannte Schwachstellen in einem vorhersehbaren öffentlichen Kanal, wie z.B. einem CVE-Eintrag, Blogbeitrag oder einem anderen Medium. Soweit möglich sollten diese Informationen betroffene Version(en) enthalten, wie ein Verbraucher feststellen kann, ob er betroffen ist, und Anweisungen zur Schadensbegrenzung oder Behebung.

    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.



Sie können Tools und KI-Systeme nutzen, um Änderungen über eine einfache URL vorzuschlagen, z. B. https://www.bestpractices.dev/de/projects/16423/choose/edit?osps_ac_01_01_status=Met&osps_ac_01_01_justification=GitHub+enforced. Wie das geht, erfahren Sie in unserem Automatisierungsvorschlagssystem. Diese Daten sind unter der Community Data License Agreement – Permissive, Version 2.0 (CDLA-Permissive-2.0) verfügbar. Dies bedeutet, dass ein Datenempfänger die Daten mit oder ohne Änderungen weitergeben darf, solange der Datenempfänger den Text dieser Vereinbarung mit den weitergegebenen Daten zur Verfügung stellt. Bitte nennen Sie Laurent und die OpenSSF Best Practices Badge-Mitwirkenden als Urheber.

Projekt-Badge-Eintrag im Besitz von: Laurent.
Eintrag erstellt: 2026-11-07 12:35:44 UTC, zuletzt aktualisiert: 2026-11-08 19:31:42 UTC. Letztes erreichtes Badge: 2026-11-07 13:32:38 UTC.