Accept

1#!/usr/bin/env python3
2"""Record that the user ACKNOWLEDGED the usage-data notice.
3
4    python3 scripts/telemetry/consent/accept.py
5
6Run only after `cli.py show` has printed the notice and the user has acknowledged
7it in their own words. Nothing here can verify that, which is why accept and
8opt-out are two scripts rather than one script with a flag: the agent's action is
9unambiguous in the transcript and a host can permission-gate them separately.
10
11Writes {"installId": "<uuid>", "consentStatus": "ACCEPTED"}, minting the install ID
12on first write and preserving any existing one. Exits non-zero and explains itself
13if the write fails, so a failure is never silently taken as consent.
14
15Then sends a `consentRecorded` event. The record is written first and is what gates
16every future emission, so a failed POST costs one event and nothing else. It cannot
17fail this script and is not mentioned in the output — a user who just said yes
18learns nothing from being told whether one HTTPS request succeeded.
19"""
20
21import sys
22from pathlib import Path
23
24_TELEMETRY = Path(__file__).resolve().parents[1]
25sys.path[:0] = [str(_TELEMETRY / "consent"), str(_TELEMETRY / "metric_emission")]
26
27import client  # noqa: E402  (paths set above so these resolve in-plugin)
28import record  # noqa: E402
29
30
31def main():
32    try:
33        written = record.write_state(record.ACCEPTED)
34    except OSError as exc:
35        print(
36            "Could not record your choice at %s: %s\n"
37            "Nothing was saved, so no usage data will be collected. The notice "
38            "will be shown again next session." % (record.state_path(), exc),
39            file=sys.stderr,
40        )
41        return 1
42
43    client.send_consent_recorded()  # fire and forget
44
45    print(
46        "Acknowledged — usage data collection is ON.\n"
47        "Recorded at %s (install ID %s).\n"
48        "\n"
49        "%s"
50        % (
51            record.state_path(),
52            written["installId"],
53            record.opt_out_help(),
54        )
55    )
56    return 0
57
58
59if __name__ == "__main__":
60    sys.exit(main())