EdamAme-x / EdamAme-x/pentect

Document and verify Pentect's own trust and network boundaries

Open
#349 1 comment 0 reactions 0 assignees View on GitHub
enhancement priority:P2
Dominant language
Rust
Stars
26
Forks
6
Avg merge
1h 13m
Merged PRs (30d)
384

Description

## Source

Several intermediate-presentation participants said that Pentect can read sensitive local data and asked why they should trust it more than the coding agent or model provider.

## Problem

Being open source is useful but does not by itself show what data Pentect reads, stores, or sends. Users need a concrete, testable description of Pentect's privileges and outbound network behavior.

## Acceptance criteria

- Publish a concise threat model covering the local user account, same-user processes, child processes, plugins, model providers, remote tools, and logs.
- List every intended outbound destination class and why it is contacted.
- Explain which components can read project files, environment files, the memory store, and restored plaintext.
- Document local persistence, file permissions, retention, rotation, and deletion.
- Provide a reproducible network-capture test showing that synthetic secrets are not sent outside the configured model destination.
- Document plugin isolation and the limits of that isolation.
- Clearly state what Pentect does not protect against.
- Keep claims tied to automated evidence or reproducible manual verification.

Contributor guide

Open the contributing guide

Research direction

Start by mapping the proxy's model-provider, child-process, plugin, logging, memory-store, persistence, and network paths. Identify the existing automated checks or reproducible manual steps that can support each claim, then define the threat model, destination classes, access boundaries, retention behavior, and plugin-isolation limits. Done means the documentation is published and the network-capture test demonstrates that synthetic secrets stay within the configured model destination.

Written by the indexing model from the issue text.

Assessment

Tech stack
rust
Domain
documentation, security
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.