Skip to content

docs(privacy): disclose runtime rule fetches + decoupling story#169

Merged
yasirhamza merged 1 commit into
mainfrom
docs/privacy-rule-repo-disclosure
Apr 28, 2026
Merged

docs(privacy): disclose runtime rule fetches + decoupling story#169
yasirhamza merged 1 commit into
mainfrom
docs/privacy-rule-repo-disclosure

Conversation

@yasirhamza

Copy link
Copy Markdown
Owner

Summary

The privacy page had two real gaps surfaced while discussing AndroDR's positioning vs. consumer adblockers:

  1. Three runtime egress paths missing from the Network Requests table:
    • SIGMA rule manifest + per-rule YAML downloads (SigmaRuleFeed.kt)
    • Centralized IOC YAMLs from android-sigma-rules/rules/ioc-data/ (PublicRepoIocFeed.kt)
    • User-configured custom rule URLs (Settings → Custom Rule Sources)
  2. The "Open Source Transparency" section didn't articulate that detection logic lives in an independent public repo, decoupled from the compiled app — a core trust property for the high-risk-user audience.

Both are now disclosed:

  • Three new rows in the Network Requests table (one of them flagged as Optional, since custom rule URLs are off by default).
  • A new ### Detection rules live in a separate, public repository subsection under Open Source Transparency that explains the YAML-rules-as-data approach, the public 5-gate validation pipeline, and the validation/rule-schema.json contract.
  • One added sentence pointing users to the custom-URL toggle in Settings and back to the Network Requests table.

cloudflare-worker.js re-rendered via scripts/render_privacy.py so the PR-time sync check (#167) passes.

Test plan

  • CI: Check privacy sync workflow passes (worker is in sync with markdown).
  • Renderer is idempotent — running python3 scripts/render_privacy.py docs/PRIVACY_POLICY.md cloudflare-worker.js a second time prints no change.
  • No top-level ## sections were added or removed (renderer's EXPECTED_H2 = 18 invariant unchanged).
  • No new tables added (renderer's EXPECTED_TABLES = 3 invariant unchanged — only rows added to the existing Network Requests table).
  • Visual check: render docs/PRIVACY_POLICY.md (e.g., on the github.io page after merge) and confirm the new rows appear above the closing paragraph and the new subsection appears between the audit links and the "Google Play Data Safety Alignment" section.

🤖 Generated with Claude Code

The Network Requests table omitted three real egress paths:
  - SIGMA rule manifest + per-rule YAML downloads (SigmaRuleFeed)
  - Centralized IOC YAMLs from android-sigma-rules/rules/ioc-data/
    (PublicRepoIocFeed)
  - User-configured custom rule URLs (Settings → Custom Rule Sources)

The Open Source Transparency section also did not articulate that
detection logic lives in an independent public repo, decoupled from
the compiled app — a core trust property for high-risk users.

Adds three table rows + a "Detection rules live in a separate, public
repository" subsection. Re-renders cloudflare-worker.js so the PR-time
sync check passes.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@yasirhamza
yasirhamza merged commit f25788a into main Apr 28, 2026
9 checks passed
@yasirhamza
yasirhamza deleted the docs/privacy-rule-repo-disclosure branch April 28, 2026 17:16
yasirhamza pushed a commit to yasirhamza/androdr-site that referenced this pull request Apr 28, 2026
…closure)

Sync of docs/PRIVACY_POLICY.md following yasirhamza/AndroDR#169:
adds three rows to the Network Requests table (SIGMA rule downloads,
centralized IOC data, optional custom rule URLs) and a new
"Detection rules live in a separate, public repository" subsection.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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