Skip to content

docs: consolidate Coven security policy, threat boundary, and support claims - #883

Draft
CompleteDotTech wants to merge 3 commits into
OpenCoven:mainfrom
CompleteDotTech:agent/issue-808-p1-consolidate-coven-security-policy-threat
Draft

docs: consolidate Coven security policy, threat boundary, and support claims#883
CompleteDotTech wants to merge 3 commits into
OpenCoven:mainfrom
CompleteDotTech:agent/issue-808-p1-consolidate-coven-security-policy-threat

Conversation

@CompleteDotTech

Copy link
Copy Markdown
Member

Summary

Issue

Refs #808

Vehicle note: opened in the fork CompleteDotTech/coven as the CI vehicle — this token cannot write to OpenCoven/coven. Re-target upstream once write access is restored. Refs #808.

Implementation

  • Approach: docs-only rewrite of SECURITY.md (~114 → ~215 lines), preserving the still-accurate operational content of the current policy (privacy-guard baseline, retention defaults, redaction coverage, synthetic placeholder rules) reorganized under the required structure. Internal links are relative repo links so they resolve in repository and deployed-doc contexts; external pointers (docs.opencoven.ai safety overview, org-level policy, releases, Security Advisories) are full URLs.
  • User-visible behavior: the repository security policy rendered on GitHub and by docs tooling changes; no runtime, API, or build behavior changes.
  • Compatibility notes: none (documentation only). The retired addendum's commitments are intentionally removed; researchers are directed to GitHub Security Advisories and the org-level policy for organization-wide scope.

Test plan

Local (docs-only change; Rust/npm suites unaffected and not executable in this environment — no cargo/python toolchain available, deferred to CI):

  • Link validation: every relative link resolves against the tree; section anchors (#2-enforced-properties-today, #5-design-goals-vs-guarantees) verified against heading slugs; all five external URLs point at live, verified targets (org-level policy verified via REST).
  • git diff --check (whitespace) — clean.
  • Claim freshness pass against current source: retention defaults (7/30 days, coven logs prune), redaction implementation and unit tests (crates/coven-cli/src/privacy.rs), client peer-fingerprint negotiation tests (crates/coven-client/tests/health.rs), AFS conformance tests (crates/coven-afs/tests/spec_consistency.rs), mount feature gating (crates/coven-afs/Cargo.toml), release family (v0.4.x) — all verified at base SHA.
  • Synthetic placeholders only; no real session ids, chat ids, phone numbers, absolute home paths, or credentials in examples.
  • python scripts/check-secrets.py and python scripts/check-coven-privacy.py — deferred to CI Policy guard (no local Python).
  • Maintainer/security-owner review of the operational commitments (advisory intake, no-SLA stance, scope split) — requested via review.

CI (docs-only classification expects changes, Policy guard, and PR gate):

  • Policy guard (secret scan + privacy guard + workflow/script checks) green.
  • PR gate green.

Risk and Rollback

  • Risk level: low — documentation only; worst case is imprecise wording, mitigated by linking each claim to its owning contract/spec and keeping non-guarantees in a separate labeled section.
  • Rollback plan: revert the single commit.

Agent Handoff

  • Current state: single signed commit on agent/issue-808-p1-consolidate-coven-security-policy-threat; draft until CI is green.
  • Follow-ups: link this policy from the canonical docs/support path in OpenCoven/coven-docs (that repository is outside this diff) and keep the AgentFS section synchronized with test: certify Coven end-to-end from packaged artifact through recovery and release evidence #779; fold in a maintainer/security-owner review of the reporting process.
  • Known gaps: no accountable on-call rotation exists for advisory triage yet, so no acknowledgment/remediation SLA is published; fallback contact beyond GitHub Security Advisories is intentionally left unspecified rather than pointing at a personal channel.

CI note (fork vehicle)

  • No CI exists on this fork vehicle. 11+ minutes after opening, the head commit has 0 check runs, 0 workflow runs, and 0 commit statuses (gh api repos/CompleteDotTech/coven/commits/<sha>/check-runstotal_count=0; actions/runs → 0) even though Actions are enabled on the fork. The upstream OpenCoven/coven CI (Classify changes → Policy guard → PR gate) has not run and cannot be triggered from here. The local verification checkboxes above are the only executed evidence; treat the Policy guard/PR gate boxes as pending until the PR is re-targeted upstream or CI runs on this vehicle.

Recreated upstream from CompleteDotTech#1, preserving source head f670660 and branch agent/issue-808-p1-consolidate-coven-security-policy-threat.

CompleteDotTech and others added 3 commits August 30, 2026 13:27
… claims

Replace the duplicated SECURITY.md (repository policy plus a copied
organization-wide disclosure addendum) with one Coven-specific operational
security contract that visibly separates:

- supported release family and security-supported surfaces, with
  experimental/disabled surfaces (AFS mount backend, OpenClaw plugin,
  remote transports) marked explicitly;
- enforced properties today, each tied to its normative contract and
  verification family (Rust authority checks, capability advertisement,
  pre-effect validation, owner-protected local transport, redaction and
  artifact defaults, secret/privacy guards, explicit mutation replay);
- residual risk and safe configuration (same-user trust vs sandboxing,
  raw-artifact opt-in, retention limits, untrusted harnesses, AgentFS
  mount posture synced with OpenCoven#779);
- private reporting via GitHub Security Advisories as the primary path,
  with no personal-channel dependency and no unsupported response-time
  commitment, plus scoped third-party dependency/provider handling;
- design goals (session/memory/agent isolation) moved out of guarantees,
  cross-referencing OpenCoven#803/OpenCoven#804 instead of claiming unimplemented A2A
  isolation.

Removes the stale OpenTrust-scope addendum, the personal Discord DM
reporting path, and the 48-hour/14-day response promises that no
accountable process currently backs.

Refs OpenCoven#808

Signed-off-by: Timothy Wayne Gregg <5861166+CompleteDotTech@users.noreply.github.com>
Signed-off-by: Timothy Wayne Gregg <5861166+CompleteDotTech@users.noreply.github.com>
@CompleteDotTech
CompleteDotTech marked this pull request as draft August 30, 2026 21:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant