IDKMesh may eventually execute work from untrusted participants on heterogeneous machines, so security and supply-chain integrity are foundational project concerns.
Please do not open a public GitHub issue for an undisclosed vulnerability.
Preferred reporting path:
- Use GitHub's private vulnerability reporting / Security tab for this repository if the option is available.
- If private vulnerability reporting is unavailable, contact the repository maintainer privately through the contact information available on the maintainer's GitHub profile.
- Share only the information needed to reproduce and assess the issue until a coordinated disclosure plan is agreed.
As the maintainer team grows, IDKMesh should establish a dedicated security team and documented private security contact independent of any single individual.
A useful report includes:
- affected component or document;
- impact;
- reproduction steps or proof of concept where safe;
- assumptions required for exploitation;
- suggested mitigation if known;
- whether the issue has been disclosed elsewhere.
High-priority areas include:
- remote code execution on volunteer worker machines;
- sandbox escapes;
- malicious Work Units;
- malicious or forged worker results;
- dependency and supply-chain compromise;
- artifact/provenance tampering;
- credential/token leakage;
- privilege escalation;
- unsafe automatic merging or deployment;
- model/tool prompt injection that crosses trust boundaries;
- Sybil/collusion attacks on reputation or verification;
- privacy leakage in distributed workloads.
GitHub secret scanning and push protection are enabled in repository settings.
The pinned .github/workflows/codeql.yml workflow analyzes Python changes on
pull requests, pushes to main, and a weekly schedule. .github/dependabot.yml
checks GitHub Actions and Python dependency declarations weekly with a bounded
open-PR limit. Routine update automation excludes semantic major versions;
major migrations require a focused compatibility and trust-boundary review. A
pinned weekly OpenSSF Scorecard workflow uploads SARIF to GitHub code scanning
and retains a five-day diagnostic artifact. It deliberately does not publish
results to the external Scorecard service or request an OIDC token.
Every third-party GitHub Action is pinned to an immutable commit SHA rather
than a floating tag. A tag resolves at run time to whatever it points at then,
so whoever controls it can change what executes in CI without any change landing
in this repository. tests/test_workflow_action_pinning.py enforces this: it
fails with the offending file and line if a tag reappears, and also fails if one
version comment maps to two different SHAs, which would mean one of them is
stale.
These controls supplement review; they do not establish that a candidate, dependency update, or release is safe.
IDKMesh is currently pre-release research software. There is not yet a stable supported-version matrix. Security fixes should normally target the current main branch and any explicitly maintained release branches once releases begin.
The project favors coordinated disclosure: verify the issue, develop a mitigation, communicate impact accurately, then publish enough information for the community to learn from the failure without unnecessarily increasing risk before a fix exists.