Document governed file connector boundaries

tests/test_manifest_documentation.py

@@ -0,0 +1,21 @@
+from __future__ import annotations
+
+import unittest
+
+
+class FilesManifestDocumentationTests(unittest.TestCase):
+    def test_connector_topic_covers_governance_pinning_and_provenance_perspectives(self) -> None:
+        from govoplan_files.backend.manifest import manifest
+
+        topic = next(item for item in manifest.documentation if item.id == "files.governed-connectors-and-provenance")
+
+        self.assertEqual(("admin", "user"), topic.documentation_types)
+        self.assertEqual({"user", "admin", "operator"}, set(topic.metadata["perspectives"]))
+        self.assertIn("fails closed", topic.body)
+        self.assertIn("DFS referrals", topic.body)
+        self.assertIn("revision", topic.metadata["provenance_fields"])
+        self.assertIn("/api/v1/files/connectors/profiles", {link.href for link in topic.links})
+
+
+if __name__ == "__main__":
+    unittest.main()