asc-analytics-reports

1# asc analytics reports
2 
3Collect a complete set of analytics report segments and verify the compressed
4files before handing them to a separate analysis workflow. Do not interpret,
5aggregate, or present the report contents as part of this skill.
6 
7## Guardrails
8 
9- Treat report inventories, signed URLs, downloaded segments, and identifiers as
10  confidential business data.
11- Prefer an existing request. Creating a request changes App Store Connect state
12  and requires an Admin-authorized profile; obtain explicit user approval before
13  running `asc analytics request`.
14- Never delete or replace a request as part of collection.
15- Use `asc analytics download`; do not fetch or persist signed segment URLs
16  separately.
17- Store private files outside the source repository with owner-only permissions.
18- Do not claim the collection is complete if any expected segment is missing or
19  fails verification.
20 
21## 1. Verify the CLI contract
22 
23Inspect the installed command before authentication or collection:
24 
25```bash
26asc analytics view --help
27```
28 
29Continue only when help lists `--processing-date`, `--granularity`,
30`--paginate`, and `--include-segments`. These filters require asc 3.5.0 or
31newer. If either filter is absent, ask the user to upgrade. Do not substitute
32the deprecated `--date` flag because it uses legacy local matching rather than
33Apple's server-side processing-date filter.
34 
35## 2. Prepare private storage
36 
37Create a private temporary directory outside the repository before capturing
38…