# mjmirza/app-store-compliance architecture

> Architecture diagram of the GitHub repository mjmirza/app-store-compliance, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mjmirza/app-store-compliance
- Repository: https://github.com/mjmirza/app-store-compliance

## Overview

App Store Compliance Playbook combines a human-readable compliance reference, an app-scanning guard, release-readiness tools, and policy-monitoring utilities. The principal workflow is a developer running the guard on an iOS or Android project, reviewing prioritized findings and fixing risks before submission; release and fleet audits extend that workflow. The graph preserves the indexed audit and monitoring modules as distinct capabilities. Relationships are limited to README statements and shown excerpts; unsampled modules are represented without inferred call chains.

Main entry points: [`agent-os/hooks/app-store-compliance-guard.sh`](https://github.com/mjmirza/app-store-compliance/blob/main/agent-os/hooks/app-store-compliance-guard.sh) (Compliance guard), [`scripts/release-audit.py`](https://github.com/mjmirza/app-store-compliance/blob/main/scripts/release-audit.py) (Release audit), [`scripts/install_harness.py`](https://github.com/mjmirza/app-store-compliance/blob/main/scripts/install_harness.py) (Tool installer), [`scripts/fleet-sweep.py`](https://github.com/mjmirza/app-store-compliance/blob/main/scripts/fleet-sweep.py) (Fleet sweep)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guard["Pre-submit checks"]
  node_guard_script["Compliance guard"]
  node_accessibility["Accessibility audit"]
  node_metadata["Listing audit<br/>[metadata-audit.py]"]
end

subgraph group_release["Release oversight"]
  node_release_audit["Release audit<br/>[release-audit.py]"]
  node_fleet["Fleet sweep<br/>[fleet-sweep.py]"]
  node_ruling["Ruling register<br/>[ruling-register.py]"]
  node_deadline["Deadline checker"]
end

subgraph group_monitor["Policy monitoring"]
  node_apple_monitor["Apple monitor<br/>[monitor.py]"]
  node_android_monitor["Android monitor<br/>[monitor-android.py]"]
  node_privacy_monitor["Privacy monitor<br/>[monitor-privacy.py]"]
  node_security_monitor["Security monitor"]
  node_regulatory_monitor["Regulatory monitor"]
  node_ai_monitor["AI policy monitor"]
end

subgraph group_reference["Compliance knowledge"]
  node_references["Store guidelines"]
  node_playbook["Compliance playbook"]
  node_patterns["Rejection patterns"]
  node_deadlines["Regulatory deadlines"]
end

subgraph group_install["AI tool integration"]
  node_installer["Tool installer<br/>[install_harness.py]"]
end

node_developer(("Developer"))
node_apple_google(("Apple and Google"))
node_ai_tools(("AI coding tools"))

node_developer -->|"runs on project"| node_guard_script
node_guard_script -->|"reports findings"| node_developer
node_developer -->|"audits release"| node_release_audit
node_release_audit -->|"runs guard"| node_guard_script
node_fleet -->|"runs guard"| node_guard_script
node_apple_monitor -.->|"fetches news"| node_apple_google
node_ai_monitor -->|"fetches feeds"| node_apple_google
node_developer -->|"installs integration"| node_installer
node_installer -->|"configures hooks"| node_ai_tools
node_developer -->|"consults guidelines"| node_references
node_developer -->|"follows checklist"| node_playbook

click node_guard_script "https://github.com/mjmirza/app-store-compliance/blob/main/agent-os/hooks/app-store-compliance-guard.sh"
click node_accessibility "https://github.com/mjmirza/app-store-compliance/blob/main/scripts/accessibility-audit.py"
click node_metadata "https://github.com/mjmirza/app-store-compliance/blob/main/scripts/metadata-audit.py"
click node_release_audit "https://github.com/mjmirza/app-store-compliance/blob/main/scripts/release-audit.py"
click node_fleet "https://github.com/mjmirza/app-store-compliance/blob/main/scripts/fleet-sweep.py"
click node_ruling "https://github.com/mjmirza/app-store-compliance/blob/main/scripts/ruling-register.py"
click node_deadline "https://github.com/mjmirza/app-store-compliance/blob/main/scripts/deadline-checker.py"
click node_apple_monitor "https://github.com/mjmirza/app-store-compliance/blob/main/scripts/monitor.py"
click node_android_monitor "https://github.com/mjmirza/app-store-compliance/blob/main/scripts/monitor-android.py"
click node_privacy_monitor "https://github.com/mjmirza/app-store-compliance/blob/main/scripts/monitor-privacy.py"
click node_security_monitor "https://github.com/mjmirza/app-store-compliance/blob/main/scripts/monitor-security.py"
click node_regulatory_monitor "https://github.com/mjmirza/app-store-compliance/blob/main/scripts/monitor-regulatory.py"
click node_ai_monitor "https://github.com/mjmirza/app-store-compliance/blob/main/scripts/monitor-ai-policy.py"
click node_references "https://github.com/mjmirza/app-store-compliance/tree/main/references"
click node_playbook "https://github.com/mjmirza/app-store-compliance/tree/main/docs"
click node_patterns "https://github.com/mjmirza/app-store-compliance/blob/main/data/rejection-patterns.json"
click node_deadlines "https://github.com/mjmirza/app-store-compliance/blob/main/data/regulatory-deadlines.json"
click node_installer "https://github.com/mjmirza/app-store-compliance/blob/main/scripts/install_harness.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_guard_script,node_accessibility,node_metadata toneBlue
class node_release_audit,node_fleet,node_ruling,node_deadline toneAmber
class node_apple_monitor,node_android_monitor,node_privacy_monitor,node_security_monitor,node_regulatory_monitor,node_ai_monitor toneMint
class node_references,node_playbook,node_patterns,node_deadlines toneRose
class node_installer,node_developer,node_apple_google,node_ai_tools toneIndigo
```

## Components

### Pre-submit checks

- [Compliance guard](https://github.com/mjmirza/app-store-compliance/blob/main/agent-os/hooks/app-store-compliance-guard.sh): `agent-os/hooks/app-store-compliance-guard.sh`
- [Accessibility audit](https://github.com/mjmirza/app-store-compliance/blob/main/scripts/accessibility-audit.py): `scripts/accessibility-audit.py`
- [Listing audit](https://github.com/mjmirza/app-store-compliance/blob/main/scripts/metadata-audit.py): `scripts/metadata-audit.py`

### Release oversight

- [Release audit](https://github.com/mjmirza/app-store-compliance/blob/main/scripts/release-audit.py): `scripts/release-audit.py`
- [Fleet sweep](https://github.com/mjmirza/app-store-compliance/blob/main/scripts/fleet-sweep.py): `scripts/fleet-sweep.py`
- [Ruling register](https://github.com/mjmirza/app-store-compliance/blob/main/scripts/ruling-register.py): `scripts/ruling-register.py`
- [Deadline checker](https://github.com/mjmirza/app-store-compliance/blob/main/scripts/deadline-checker.py): `scripts/deadline-checker.py`

### Policy monitoring

- [Apple monitor](https://github.com/mjmirza/app-store-compliance/blob/main/scripts/monitor.py): `scripts/monitor.py`
- [Android monitor](https://github.com/mjmirza/app-store-compliance/blob/main/scripts/monitor-android.py): `scripts/monitor-android.py`
- [Privacy monitor](https://github.com/mjmirza/app-store-compliance/blob/main/scripts/monitor-privacy.py): `scripts/monitor-privacy.py`
- [Security monitor](https://github.com/mjmirza/app-store-compliance/blob/main/scripts/monitor-security.py): `scripts/monitor-security.py`
- [Regulatory monitor](https://github.com/mjmirza/app-store-compliance/blob/main/scripts/monitor-regulatory.py): `scripts/monitor-regulatory.py`
- [AI policy monitor](https://github.com/mjmirza/app-store-compliance/blob/main/scripts/monitor-ai-policy.py): `scripts/monitor-ai-policy.py`

### Compliance knowledge

- [Store guidelines](https://github.com/mjmirza/app-store-compliance/tree/main/references): `references`
- [Compliance playbook](https://github.com/mjmirza/app-store-compliance/tree/main/docs): `docs`
- [Rejection patterns](https://github.com/mjmirza/app-store-compliance/blob/main/data/rejection-patterns.json): `data/rejection-patterns.json`
- [Regulatory deadlines](https://github.com/mjmirza/app-store-compliance/blob/main/data/regulatory-deadlines.json): `data/regulatory-deadlines.json`

### AI tool integration

- [Tool installer](https://github.com/mjmirza/app-store-compliance/blob/main/scripts/install_harness.py): `scripts/install_harness.py`

### Other components

- **Developer**
- **Apple and Google**
- **AI coding tools**

## Connections

- Developer → Compliance guard: runs on project (evidence: `README.md`)
- Compliance guard → Developer: reports findings (evidence: `README.md`)
- Developer → Release audit: audits release (evidence: `README.md`)
- Release audit → Compliance guard: runs guard (evidence: `scripts/release-audit.py`)
- Fleet sweep → Compliance guard: runs guard (evidence: `scripts/fleet-sweep.py`)
- Apple monitor → Apple and Google: fetches news (evidence: `scripts/monitor.py`)
- AI policy monitor → Apple and Google: fetches feeds (evidence: `scripts/monitor-ai-policy.py`)
- Developer → Tool installer: installs integration (evidence: `README.md`)
- Tool installer → AI coding tools: configures hooks (evidence: `README.md`)
- Developer → Store guidelines: consults guidelines (evidence: `README.md`)
- Developer → Compliance playbook: follows checklist (evidence: `README.md`)
