chartremotely 0.2.16__tar.gz → 0.2.17__tar.gz

{chartremotely-0.2.16 → chartremotely-0.2.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chartremotely
-Version: 0.2.16
+Version: 0.2.17
 Summary: Remote control of desktop charting applications on macOS
 Author: Lonnie VanZandt
 License: 
@@ -206,6 +206,8 @@ License:
            See the License for the specific language governing permissions and
            limitations under the License.
         
+Project-URL: Repository, https://github.com/lonniev/ChartRemotely-agent
+Project-URL: Changelog, https://github.com/lonniev/ChartRemotely-agent/blob/main/CHANGELOG.md
 Keywords: thinkorswim,accessibility,automation,charting
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown

{chartremotely-0.2.16 → chartremotely-0.2.17}/chartremotely/hearing.py

@@ -243,7 +243,9 @@ def warm_in_background() -> threading.Thread:
 
 
 def fetch_model(say: Callable[[str], None] = print) -> bool:
-    """Download the model ahead of the first sentence (setup's step). Shows progress.
+    """Download the model ahead of the first sentence (setup's step).
+
+    Silent when it is already on this Mac; a download shows its progress.
 
     Returns whether it is ready. Skipped, with a reason, where it cannot run.
     """
@@ -255,7 +257,18 @@ def fetch_model(say: Callable[[str], None] = print) -> bool:
     except ImportError:
         say("The speech model's downloader is missing; reinstall ChartRemotely, then run setup.")
         return False
-    say(f"Fetching the speech model ({MODEL_SIZE}, once; later runs skip this)…")
+    from huggingface_hub.utils import disable_progress_bars, enable_progress_bars
+
+    disable_progress_bars()
+    try:
+        snapshot_download(repo_id=MODEL, local_files_only=True)
+        cached = True
+    except Exception:  # noqa: BLE001 - not cached yet: fetch it, with progress
+        cached = False
+    finally:
+        enable_progress_bars()
+    if cached:
+        return True
+    say(f"Fetching the speech model ({MODEL_SIZE}, once)…")
     snapshot_download(repo_id=MODEL)
-    say("The speech model is on this Mac.")
     return True

{chartremotely-0.2.16 → chartremotely-0.2.17}/chartremotely/services.py

@@ -105,7 +105,10 @@ def probe_permissions(request: bool, out: Path, timeout: float = 30.0) -> dict:
     args = [executable(), "permissions", "--out", str(out)] + (["--request"] if request else [])
     path.write_text(render(PROBE_LABEL, args, keep_alive=False, log=LOG_DIR / "chartremotely-permissions.log"))
     subprocess.run(["launchctl", "bootout", f"{_domain()}/{PROBE_LABEL}"], capture_output=True, check=False)
-    subprocess.run(["launchctl", "bootstrap", _domain(), str(path)], check=True)
+    ran = subprocess.run(["launchctl", "bootstrap", _domain(), str(path)],
+                         capture_output=True, text=True, check=False)
+    if ran.returncode != 0:
+        raise ServiceError(f"launchd would not run the permission check: {(ran.stderr or ran.stdout).strip()[:200]}")
     try:
         deadline = time.time() + timeout
         while time.time() < deadline and not out.exists():

{chartremotely-0.2.16 → chartremotely-0.2.17}/chartremotely/setup.py

@@ -1,24 +1,25 @@
 """``chartremotely setup``: from a fresh Mac to a paired, voice-driven display.
 
-Each step checks first and skips what is already done, so running setup
-again is always safe:
+It first shows what is installing - version, where it came from (PyPI and
+its release, or a local checkout), the Python it runs on - and the steps
+ahead, and asks before changing anything. Each step checks first and skips
+what is already done, so running setup again is always safe:
 
 1. **Identity.** Either the patron's existing npub, proven by the Nostr DM
    challenge (setup never sees their nsec), or a key made here for them.
    A made key is kept for the human - their Keychain, then Safari's saved
    passwords - and used once, in memory, to sign the pairing. It is never
-   written to this agent's config.
-2. **Pairing**, without a code to copy: setup adopts this machine's code itself.
-   **Voice sign-in**: the ``dpop_token`` from the owner's DM proof, kept in
+   written to this agent's config. Then **pairing**, without a code to copy: setup adopts this machine's code itself.
+   and **voice sign-in**: the ``dpop_token`` from the owner's DM proof, kept in
    the login Keychain (their npub goes in the config), so the listener can
    call the operator's priced tools as that patron.
-3. **Tailscale**: the Mac's tailnet address, with ``/chart`` forwarded to the agent.
-4. **Services**: the listener and the relay, under launchd.
-5. **Permissions**: Accessibility and Screen Recording, asked for by the
+2. **Tailscale**: the Mac's tailnet address, with ``/chart`` forwarded to the agent.
+3. **Services**: the listener and the relay, under launchd.
+4. **Permissions**: Accessibility and Screen Recording, asked for by the
    services' own Python, since that is the process macOS grants them to.
-6. **Hearing**: the Whisper speech model, fetched once (about 1.6 GB), and
+5. **Hearing**: the Whisper speech model, fetched once (about 1.6 GB), and
    the owner's display names, so a sentence can say where.
-7. **The Shortcut**: this Mac's "ChartRemotely" - talk, or type when it
+6. **The Shortcut**: this Mac's "ChartRemotely" - talk, or type when it
    asks - opened for import. A "ChartRemotely Ask" left by an older setup is
    removed from the library (by "Shortcuts Events"; named for deleting by
    hand if that fails).
@@ -26,12 +27,15 @@ again is always safe:
 
 from __future__ import annotations
 
+import json
 import subprocess
+import sys
 import tempfile
 from collections.abc import Callable
 from pathlib import Path
 
 from . import config, mcpclient, relay
+from .terminal import Terminal, wants_color
 
 OPERATOR_URL = "https://chartremotely-mcp.fastmcp.app"
 SITE = "https://chartremotely.tollbooth-dpyc.com"
@@ -60,9 +64,9 @@ def prove_by_dm(client: mcpclient.Client, npub: str, ask: Ask, say: Say) -> str:
         raise SetupError(sent.get("error") or "the operator did not send a proof request")
     say(f"A Nostr DM is on its way to {npub[:12]}…")
     say(f"Its confirmation code is: {phrase}")
-    say("Reply to the DM from your Nostr client only if the codes match.")
-    say("In your reply you may set cache_duration - e.g. 30 days, or unlimited - so voice")
-    say("keeps working that long; left alone, the sign-in lasts 2 hours.")
+    say("Reply to it from your Nostr client only if the codes match. In the reply you")
+    say("may set cache_duration (30 days, or unlimited) so voice keeps working that")
+    say("long; left alone, the sign-in lasts 2 hours.")
     ask("Press Return once you have replied… ")
     got = client.call("chart_receive_npub_proof", {"patron_npub": npub, "dpop_token": phrase})
     if got.get("error"):
@@ -108,7 +112,7 @@ def identity(client: mcpclient.Client, ask: Ask, say: Say) -> tuple[str, str, bo
     Returns (npub, proof for chart_pair_agent, whether that proof is a DM
     sign-in the listener can keep using).
     """
-    say("Your Nostr identity owns this display.")
+    say("Your Nostr identity owns this display:")
     say("  1  I have an npub (I'll answer a Nostr DM to prove it)")
     say("  2  Use a key saved on this Mac")
     say("  3  Make me a new key")
@@ -184,90 +188,151 @@ def pair(client: mcpclient.Client, base: str, npub: str, proof: str, label: str)
     return relay.collect(base, code, expires_in)
 
 
+# -- what is being installed -------------------------------------------------
+
+PLAN = [
+    ("Identity", "prove who owns this display, by Nostr DM or a key made here"),
+    ("Tailscale", "reach this Mac's listener at its tailnet address, /chart"),
+    ("Services", "run the listener and the relay under launchd, from login"),
+    ("Permissions", "allow Accessibility and Screen Recording"),
+    ("Hearing", "fetch the Whisper speech model (about 1.6 GB, once)"),
+    ("Shortcut", "make “ChartRemotely” and open it for you to add"),
+]
+
+
+def provenance() -> list[tuple[str, str]]:
+    """What is running setup, and where it came from: version, source, release, runtime."""
+    from importlib import metadata
+
+    dist = metadata.distribution("chartremotely")
+    version = dist.version
+    urls = dict(u.split(", ", 1) for u in dist.metadata.get_all("Project-URL") or [] if ", " in u)
+    direct = json.loads(dist.read_text("direct_url.json") or "null")
+    running = Path(__file__).resolve().parent
+    rows = [("Version", version)]
+    if "site-packages" not in running.parts:
+        # Imported straight from a source tree: its metadata may be a stale
+        # egg-info beside it, so claim nothing about PyPI.
+        rows = [("Version", f"{version} (source; releases stamp their own)"),
+                ("From", f"source checkout {running.parent}")]
+    elif direct is None:
+        rows.append(("From", f"PyPI  https://pypi.org/project/{dist.metadata['Name']}/{version}/"))
+        if urls.get("Repository"):
+            rows.append(("Release", f"{urls['Repository']}/releases/tag/v{version}"))
+    else:
+        where = direct.get("url", "").removeprefix("file://")
+        commit = (direct.get("vcs_info") or {}).get("commit_id")
+        editable = (direct.get("dir_info") or {}).get("editable")
+        rows.append(("From", f"{where}{'@' + commit[:12] if commit else ''}{' (editable)' if editable else ''}"))
+    rows.append(("Python", f"{sys.executable} ({sys.version.split()[0]})"))
+    home = str(Path.home())
+    return [(label, value.replace(home, "~")) for label, value in rows]
+
+
 # -- the whole run ------------------------------------------------------------
 
 def run(ask: Ask = input, say: Say = print, operator_url: str = OPERATOR_URL) -> int:
+    out = Terminal(write=say, read=ask, color=say is print and wants_color())
+    from importlib import metadata
+
+    out.title("ChartRemotely setup", metadata.distribution("chartremotely").metadata["Summary"])
+    out.facts(provenance())
+    out.plan("Setup will, skipping anything already done:", PLAN)
+    out.write("")
+    if not out.confirm("Continue?"):
+        out.say("Nothing was changed.")
+        return 0
+    total = len(PLAN)
+
     cfg = config.load()
     base = (cfg.get("operator_url") or operator_url).rstrip("/")
     token = config.ensure_token()
 
-    # 1-2. Identity and pairing, unless this Mac is already paired.
+    # 1. Identity and pairing, unless this Mac is already paired.
+    out.step(1, total, "Identity")
     client = mcpclient.Client(base)
     if cfg.get("agent_id") and cfg.get("agent_secret"):
-        say(f"This Mac is already paired ({cfg['agent_id']}).")
-        npub = cfg.get("owner_npub") or ask("Your npub (whose display this is): ").strip()
+        out.ok(f"This Mac is already paired ({cfg['agent_id']}).")
+        npub = cfg.get("owner_npub") or out.ask("Your npub (whose display this is): ").strip()
         if not npub.startswith("npub1"):
             raise SetupError("that is not an npub")
         if has_sign_in(npub):
             config.update(owner_npub=npub)
-            say("Voice is already signed in.")
+            out.ok("Voice is already signed in.")
         else:
-            voice_sign_in(client, npub, ask, say)
+            voice_sign_in(client, npub, out.ask, out.say)
     else:
-        npub, proof, by_dm = identity(client, ask, say)
-        label = ask("Name this display (e.g. Desk, Office wall): ").strip() or "display"
+        npub, proof, by_dm = identity(client, out.ask, out.say)
+        label = out.ask("Name this display (e.g. Desk, Office wall): ").strip() or "display"
         pair(client, base, npub, proof, label)
-        say(f"Paired as “{label}”.")
+        out.ok(f"Paired as “{label}”.")
         if by_dm:
             keep_sign_in(npub, proof)
-            say("Voice is signed in with the same DM.")
+            out.ok("Voice is signed in with the same DM.")
         else:
-            voice_sign_in(client, npub, ask, say)
+            voice_sign_in(client, npub, out.ask, out.say)
         del proof
 
-    # 3. Tailscale.
+    # 2. Tailscale.
     from . import tailnet
 
+    out.step(2, total, "Tailscale")
     url = tailnet.chart_url(tailnet.status())
     tailnet.serve(int(cfg.get("port") or 8899))
-    say(f"Your Shortcut will reach this Mac at {url}")
+    out.ok(f"The Shortcut reaches this Mac at {url}")
 
-    # 4. Services.
+    # 3. Services.
     from . import services
 
+    out.step(3, total, "Services")
     for command in ("serve", "relay"):
         services.install(command)
-    say("The listener and the relay are running, and start with this Mac.")
+    out.ok("The listener and the relay are running, and start with this Mac.")
 
-    # 5. Permissions, as the services' own Python sees them.
+    # 4. Permissions, as the services' own Python sees them.
+    out.step(4, total, "Permissions")
     probe = Path(tempfile.gettempdir()) / "chartremotely-permissions.json"
     granted = services.probe_permissions(request=True, out=probe)
     while not (granted.get("accessibility") and granted.get("screen_recording")):
         python = granted.get("python", "the Python that runs ChartRemotely")
         missing = [name for name, key in (("Accessibility", "accessibility"),
                                           ("Screen Recording", "screen_recording")) if not granted.get(key)]
-        say(f"macOS needs you to allow {' and '.join(missing)} for: {python}")
+        out.warn(f"macOS needs you to allow {' and '.join(missing)} for:")
+        out.say(python)
         pane = "Privacy_Accessibility" if not granted.get("accessibility") else "Privacy_ScreenCapture"
         subprocess.run(["open", f"x-apple.systempreferences:com.apple.preference.security?{pane}"], check=False)
-        ask("Turn it on in System Settings, then press Return… ")
+        out.ask("Turn it on in System Settings, then press Return… ")
         granted = services.probe_permissions(request=False, out=probe)
-    say("Accessibility and Screen Recording are allowed.")
+    out.ok("Accessibility and Screen Recording are allowed.")
 
-    # 6. Hearing: the speech model, and the display names a sentence may say.
+    # 5. Hearing: the speech model, and the display names a sentence may say.
     from . import displays, hearing
 
+    out.step(5, total, "Hearing")
     try:
-        hearing.fetch_model(say)
+        if hearing.fetch_model(out.say):
+            out.ok("The speech model is on this Mac.")
     except Exception as exc:  # noqa: BLE001 - the typing box works without it
-        say(f"The speech model could not be fetched ({type(exc).__name__}); run setup again later.")
+        out.warn(f"The speech model could not be fetched ({type(exc).__name__}); run setup again later.")
     if displays.refresh() is not None:
-        say(f"Displays you can name: {', '.join(displays.load()) or 'none yet'}.")
+        out.ok(f"Displays you can name: {', '.join(displays.load()) or 'none yet'}.")
 
-    # 7. The Shortcut.
+    # 6. The Shortcut.
     from . import shortcut
 
+    out.step(6, total, "Shortcut")
     subprocess.run(["open", str(shortcut.build(url, token))], check=False)
-    say("Add the Shortcut when it opens; iCloud brings it to your iPhone, iPad and Watch.")
+    out.ok("“ChartRemotely” is open: add it (or Replace). iCloud brings it to your iPhone, iPad and Watch.")
     removed, left = shortcut.remove_retired()
     if removed:
-        say(f"Removed {', '.join(f'“{n}”' for n in removed)}; “ChartRemotely” does it all now.")
+        out.ok(f"Removed {', '.join(f'“{n}”' for n in removed)}; “ChartRemotely” does it all now.")
     if left:
-        say(f"Delete {', '.join(f'“{n}”' for n in left)} in the Shortcuts app; “ChartRemotely” does it all now.")
-
-    say("")
-    say("Done. Say “Hey Siri, ChartRemotely”, then one sentence: “Palantir, half, on mac mini”.")
-    say("No microphone, or it didn't hear you? It shows a box: type the same sentence.")
-    if npub:
-        say(f"Your npub: {npub}")
-    say(f"Sign in at {SITE} to see your screens.")
+        out.warn(f"Delete {', '.join(f'“{n}”' for n in left)} in the Shortcuts app; “ChartRemotely” does it all now.")
+
+    out.write("")
+    out.write(out.bold("Ready."))
+    out.say("Say “Hey Siri, ChartRemotely”, then one sentence: “Palantir, half, on mac mini”.")
+    out.say("No microphone, or it didn't hear you? It shows a box: type the same sentence.")
+    out.facts([("Your npub", npub), ("Your screens", SITE)])
+    out.write("")
     return 0

chartremotely-0.2.17/chartremotely/terminal.py

@@ -0,0 +1,75 @@
+"""How ``chartremotely setup`` looks: a header, numbered steps, quiet detail.
+
+Colour only on a terminal that wants it (not piped, no ``NO_COLOR``, not
+``TERM=dumb``); everywhere else the same lines print plain, so tests read
+exactly what a person reads.
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+from collections.abc import Callable
+
+INDENT = "    "
+
+
+def wants_color(stream=sys.stdout) -> bool:
+    return (hasattr(stream, "isatty") and stream.isatty()
+            and not os.environ.get("NO_COLOR") and os.environ.get("TERM") != "dumb")
+
+
+class Terminal:
+    """Lines for a person: :meth:`step` headings, :meth:`ok` and :meth:`warn` marks,
+    :meth:`say` detail and :meth:`ask` prompts, all indented under their step."""
+
+    def __init__(self, write: Callable[[str], None] = print, read: Callable[[str], str] = input,
+                 color: bool = False):
+        self.write, self.read, self.color = write, read, color
+
+    def _paint(self, code: str, text: str) -> str:
+        return f"\033[{code}m{text}\033[0m" if self.color else text
+
+    def bold(self, text: str) -> str:
+        return self._paint("1", text)
+
+    def dim(self, text: str) -> str:
+        return self._paint("2", text)
+
+    def title(self, name: str, summary: str) -> None:
+        self.write("")
+        self.write(self.bold(name))
+        self.write(self.dim(summary))
+
+    def facts(self, rows: list[tuple[str, str]]) -> None:
+        """Label/value rows, labels aligned."""
+        width = max(len(label) for label, _ in rows)
+        self.write("")
+        for label, value in rows:
+            self.write(f"  {self.dim(label.ljust(width))}  {value}")
+
+    def plan(self, heading: str, steps: list[tuple[str, str]]) -> None:
+        width = max(len(name) for name, _ in steps)
+        self.write("")
+        self.write(heading)
+        for i, (name, what) in enumerate(steps, 1):
+            self.write(f"  {self._paint('36', str(i))}  {self.bold(name.ljust(width))}  {what}")
+
+    def step(self, number: int, total: int, name: str) -> None:
+        self.write("")
+        self.write(f"{self._paint('36', f'[{number}/{total}]')} {self.bold(name)}")
+
+    def say(self, text: str) -> None:
+        self.write(f"{INDENT}{text}" if text else "")
+
+    def ok(self, text: str) -> None:
+        self.write(f"  {self._paint('32', '✓')} {text}")
+
+    def warn(self, text: str) -> None:
+        self.write(f"  {self._paint('33', '!')} {text}")
+
+    def ask(self, prompt: str) -> str:
+        return self.read(f"  {self._paint('36', '›')} {prompt}")
+
+    def confirm(self, prompt: str) -> bool:
+        return not self.ask(f"{prompt} [Y/n] ").strip().lower().startswith("n")

{chartremotely-0.2.16 → chartremotely-0.2.17}/chartremotely.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chartremotely
-Version: 0.2.16
+Version: 0.2.17
 Summary: Remote control of desktop charting applications on macOS
 Author: Lonnie VanZandt
 License: 
@@ -206,6 +206,8 @@ License:
            See the License for the specific language governing permissions and
            limitations under the License.
         
+Project-URL: Repository, https://github.com/lonniev/ChartRemotely-agent
+Project-URL: Changelog, https://github.com/lonniev/ChartRemotely-agent/blob/main/CHANGELOG.md
 Keywords: thinkorswim,accessibility,automation,charting
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown

{chartremotely-0.2.16 → chartremotely-0.2.17}/chartremotely.egg-info/SOURCES.txt

@@ -31,6 +31,7 @@ chartremotely/snapshot.py
 chartremotely/studies.py
 chartremotely/symbol.py
 chartremotely/tailnet.py
+chartremotely/terminal.py
 chartremotely/timeframe.py
 chartremotely/understand.py
 chartremotely/vocab.py

{chartremotely-0.2.16 → chartremotely-0.2.17}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "chartremotely"
-version = "0.2.16"
+version = "0.2.17"
 description = "Remote control of desktop charting applications on macOS"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -28,6 +28,10 @@ macos = [
 setup = ["tollbooth-dpyc[nostr]==0.90.0"]
 dev = ["pytest>=8", "ruff>=0.6"]
 
+[project.urls]
+Repository = "https://github.com/lonniev/ChartRemotely-agent"
+Changelog = "https://github.com/lonniev/ChartRemotely-agent/blob/main/CHANGELOG.md"
+
 [project.scripts]
 chartremotely = "chartremotely.cli:main"
 

{chartremotely-0.2.16 → chartremotely-0.2.17}/tests/test_setup.py

@@ -264,7 +264,7 @@ def test_a_made_key_never_reaches_the_agents_config(monkeypatch, tmp_path):
     _no_hearing(monkeypatch)
     monkeypatch.setattr(setup.subprocess, "run", lambda *a, **k: None)
 
-    answers = iter(["3", "Desk", "n"])
+    answers = iter(["", "3", "Desk", "n"])
     said = []
     assert setup.run(ask=lambda q: next(answers), say=said.append) == 0
 
@@ -311,7 +311,7 @@ def test_a_dm_proven_owner_keeps_the_sign_in_in_the_keychain_not_the_config(monk
         "chart_request_npub_proof": {"dpop_token": "seven-amber-door"},
         "chart_receive_npub_proof": {"success": True, "dpop_token": "seven-amber-door"},
         "chart_pair_agent": {"ok": True, "display": "Desk", "agent_id": "a1"}})
-    answers = iter(["1", NPUB, "", "Desk"])
+    answers = iter(["", "1", NPUB, "", "Desk"])
     said = []
     assert setup.run(ask=lambda q: next(answers), say=said.append) == 0
     assert vault == {NPUB: "seven-amber-door"}
@@ -325,7 +325,7 @@ def test_an_already_paired_mac_is_signed_in_for_voice_by_dm(monkeypatch, tmp_pat
         "chart_request_npub_proof": {"dpop_token": "seven-amber-door"},
         "chart_receive_npub_proof": {"success": True, "dpop_token": "seven-amber-door"}})
     config.update(operator_url="https://op.test", agent_id="a1", agent_secret="agent-secret")
-    answers = iter([NPUB, "y", ""])
+    answers = iter(["", NPUB, "y", ""])
     assert setup.run(ask=lambda q: next(answers), say=lambda s: None) == 0
     assert vault == {NPUB: "seven-amber-door"}
     assert "seven-amber-door" not in (tmp_path / "config.json").read_text()
@@ -337,11 +337,55 @@ def test_setup_removes_a_retired_ask_shortcut_and_names_any_it_could_not(monkeyp
         "chart_receive_npub_proof": {"success": True, "dpop_token": "seven-amber-door"}})
     config.update(operator_url="https://op.test", agent_id="a1", agent_secret="agent-secret")
     monkeypatch.setattr(shortcut, "remove_retired", lambda: (["ChartRemotely Ask"], ["ChartRemotely Ask 2"]))
-    answers = iter([NPUB, "y", ""])
+    answers = iter(["", NPUB, "y", ""])
     said = []
     assert setup.run(ask=lambda q: next(answers), say=said.append) == 0
-    assert "Removed “ChartRemotely Ask”; “ChartRemotely” does it all now." in said
-    assert "Delete “ChartRemotely Ask 2” in the Shortcuts app; “ChartRemotely” does it all now." in said
+    assert any(s.endswith("Removed “ChartRemotely Ask”; “ChartRemotely” does it all now.") for s in said)
+    assert any(s.endswith("Delete “ChartRemotely Ask 2” in the Shortcuts app; “ChartRemotely” does it all now.")
+               for s in said)
+
+
+def test_setup_says_what_it_installs_and_changes_nothing_when_declined(monkeypatch, tmp_path):
+    touched = []
+    monkeypatch.setattr(config, "load", lambda: touched.append("config") or {})
+    said = []
+    assert setup.run(ask=lambda q: "n", say=said.append) == 0
+    text = "\n".join(said)
+    assert "ChartRemotely setup" in text and "Version" in text and "Python" in text
+    assert all(name in text for name, _ in setup.PLAN)
+    assert said[-1].strip() == "Nothing was changed." and touched == []
+    assert not any("\033[" in s for s in said), "no colour codes when not printing to a terminal"
+
+
+def test_provenance_names_pypi_and_its_release_or_the_local_checkout(monkeypatch):
+    from importlib import metadata
+
+    class Dist:
+        version = "9.9.9"
+
+        def __init__(self, direct):
+            self.direct = direct
+            self.metadata = type("M", (), {"__getitem__": lambda s, k: "chartremotely",
+                                            "get_all": lambda s, k: ["Repository, https://example.test/repo"]})()
+
+        def read_text(self, name):
+            return self.direct
+
+    monkeypatch.setattr(metadata, "distribution", lambda name: Dist(None))
+    monkeypatch.setattr(setup, "__file__", "/venv/lib/python3.12/site-packages/chartremotely/setup.py")
+    rows = dict(setup.provenance())
+    assert rows["Version"] == "9.9.9"
+    assert rows["From"] == "PyPI  https://pypi.org/project/chartremotely/9.9.9/"
+    assert rows["Release"] == "https://example.test/repo/releases/tag/v9.9.9"
+
+    monkeypatch.setattr(metadata, "distribution", lambda name: Dist(json.dumps(
+        {"url": "file:///src/agent", "dir_info": {"editable": True}})))
+    rows = dict(setup.provenance())
+    assert rows["From"] == "/src/agent (editable)" and "Release" not in rows
+
+    monkeypatch.setattr(setup, "__file__", "/src/agent/chartremotely/setup.py")
+    rows = dict(setup.provenance())
+    assert rows["From"] == "source checkout /src/agent", "a source tree never claims PyPI"
 
 
 class Library: