Endpoint telemetry, PC Detail rework and a checked backup/restore path

tests/test_docs_publishable.py

@@ -94,7 +94,23 @@ def documentation_files():
 
 def test_there_are_docs_to_check():
     """A path change that silently matched nothing would make this suite pass
-    while checking absolutely nothing."""
+    while checking absolutely nothing.
+
+    FLAG FOR DOC AUTHORS: if this fails with a SMALL number (3, not 0), you have
+    almost certainly just committed a docs/*.md file. Don't lower the threshold
+    to make it pass - that is the exact failure this assertion exists to catch,
+    and it would silently disable the whole scrub suite.
+
+    docs/*.md prose is wiki-published and MUST stay untracked. The gates decide
+    'is this a published checkout?' by the ABSENCE of docs/*.md, so one tracked
+    prose file makes CI look internal while carrying no prose, and takes down
+    backend AND gates together. the DEV-BUILD-TEST wiki page and the PLUGIN-HOOKS wiki page
+    did exactly this and held the branch red for eight runs; both were untracked
+    (kept on disk) and .gitignore now ignores docs/*.md wholesale.
+
+    Authoring a doc is still fine - write it in docs/, it just stays local and
+    goes to the wiki. docs/notes/ and docs/openapi.json are unaffected.
+    """
     assert len(documentation_files()) > 20