Turn ENTITY-ROBOTICS into a v3.4 developer landing page

README.md

@@ -1,17 +1,27 @@
 # ENTITY-ROBOTICS
 
-ENTITY v3.4.0 executable Robotics implementation package.
+**ENTITY v3.4.0 executable Robotics implementation package.**
 
-This repository configures the **one ENTITY Global Passport** for the Robotics domain. It does not define a separate passport protocol and does not modify ENTITY core semantics.
+This repository configures the **one ENTITY Global Passport** for robotics and autonomous-system workflows. It does not define a separate passport protocol and does not modify ENTITY core semantics.
 
-## Release binding
+[ENTITY](https://github.com/blackmore-technology-group/ENTITY) · [v3.4.0 release](https://github.com/blackmore-technology-group/ENTITY/releases/tag/v3.4.0) · [Global Passport documentation](https://github.com/blackmore-technology-group/ENTITY/blob/main/docs/v3.4/GLOBAL_PASSPORT.md) · [Domain packages](https://github.com/blackmore-technology-group/ENTITY/blob/main/docs/v3.4/DOMAIN_PACKAGES.md)
 
-- Core source: `blackmore-technology-group/ENTITY` PR #41
-- Source head: `2d7529fbadb4dd04840d62b751294bf9a7f70ed5`
-- Release snapshot: `3ff0e51ca2daabf50bc517e9c6e3438e8c150f1560cca6c99621621e3c855a90`
-- Package SHA-256: `3a0e68fa6c63b2ef9cf79ccf463335af72d49ffb3cd028c88b6a998d8678f38f`
+## What this package is for
+
+Use ENTITY-ROBOTICS as the starting point when you need persistent provenance, scoped authority, rights and evidence around robots, autonomous systems, tasks, operating context or derived outputs while keeping device possession, hosting and infrastructure control separate from sovereign authority.
 
-## Required deployment facts
+The v3.4 package includes mappings for **ROS 2** and **Open-RMF**. Those mappings describe correspondence; ENTITY does not redefine the external standards.
+
+Typical evaluation paths include:
+
+- preserving provenance across robot, fleet, task or software-state changes;
+- binding scoped authority and evidence to machine actions or generated outputs;
+- carrying rights and governance context across providers or orchestration systems;
+- composing jurisdiction, safety, trust and technical profiles inside one Global Passport.
+
+## Deploy the package
+
+Required deployment facts:
 
 - `organization`
 - `jurisdiction`
@@ -20,10 +30,34 @@ This repository configures the **one ENTITY Global Passport** for the Robotics d
 
 `deployment.example.json` is intentionally non-production until every `CONFIGURE-ME` value is replaced with organization-specific facts.
 
-## Verify
+```text
+Select package → configure organization facts → connect systems/data → ingest → verify passport → run conformance → deploy
+```
+
+## Verify locally
+
+```bash
+python tools/verify_package.py
+```
+
+The verifier checks the repository inventory and the package/source-release binding.
+
+## Release binding
+
+- Core source: `blackmore-technology-group/ENTITY` PR #41
+- Source head: `2d7529fbadb4dd04840d62b751294bf9a7f70ed5`
+- Release snapshot: `3ff0e51ca2daabf50bc517e9c6e3438e8c150f1560cca6c99621621e3c855a90`
+- Package SHA-256: `3a0e68fa6c63b2ef9cf79ccf463335af72d49ffb3cd028c88b6a998d8678f38f`
+
+## Go deeper
+
+- [ENTITY v3.4.0](https://github.com/blackmore-technology-group/ENTITY/releases/tag/v3.4.0)
+- [Developer portal](https://github.com/blackmore-technology-group/ENTITY/blob/main/DEVELOPERS.md)
+- [Engineering evidence](https://github.com/blackmore-technology-group/ENTITY/blob/main/docs/ENGINEERING_EVIDENCE.md)
+- [Open contributor tasks](https://github.com/blackmore-technology-group/ENTITY/issues?q=is%3Aissue+is%3Aopen)
 
-Run `python tools/verify_package.py`. The verifier checks the repository inventory and the package/source-release binding.
+## Truth and compliance boundary
 
-## Truth boundary
+External standards remain externally authoritative and are mapped, not redefined. Package verification does **not** establish regulatory compliance, objective external truth, system safety, legal title or accounting fair value. Provider custody does not create ENTITY authority.
 
-External standards are mapped, not redefined. Package verification does not establish regulatory compliance, objective external truth, legal title or accounting fair value. Provider custody does not create ENTITY authority.
+Deployment-specific safety, legal, security, certification and operational determinations remain the responsibility of the deploying organization.

REPOSITORY_MANIFEST.json

@@ -1,90 +1,27 @@
 {
   "domain": "robotics",
   "files": [
-    {
-      "path": ".gitattributes",
-      "sha256": "d60f352d0db1404c70afb4bb8b2ca3fd1c610572aa40720e8a0b7baa7885418c"
-    },
-    {
-      "path": ".github/workflows/verify.yml",
-      "sha256": "261f8eba4865fd6b237fd43d8008b9a5f7934d50615454bbc093e4ab5f4d05a8"
-    },
-    {
-      "path": ".gitignore",
-      "sha256": "4cad133d4f0a6cf4bba15f1b8bbae48d6a55f20b94f75487c51a93cc6a5af59f"
-    },
-    {
-      "path": "CODE_OF_CONDUCT.md",
-      "sha256": "075f9820f43599dceb334f3accba68d62c32589e38ef68c750c771e48695eafc"
-    },
-    {
-      "path": "conformance.json",
-      "sha256": "0f875a645c2b9a94ba1e65553b06607d6a0de1d8cd9cf18d6ec362c36dd8da98"
-    },
-    {
-      "path": "deployment.example.json",
-      "sha256": "9a1467794aecd064d1791824c8ba3865fecfab0d633d842c894cd133e71f8b52"
-    },
-    {
-      "path": "deployment.schema.json",
-      "sha256": "3f3e84af5a154ed58e13781386c79f915e0395813c0f9c8db1bba8e929cc1a91"
-    },
-    {
-      "path": "LICENSE",
-      "sha256": "c71d239df91726fc519c6eb72d318ec65820627232b2f796219e87dcf35d0ab4"
-    },
-    {
-      "path": "mappings.json",
-      "sha256": "10aa7c8469f4becfd507944a19b2b173d2736cb03a3566c5742b4374f5021e7b"
-    },
-    {
-      "path": "NOTICE",
-      "sha256": "0d5dbc5d8a225ba5eb152719ae4b0066ca64d3338c7dc857a68f502961a92dda"
-    },
-    {
-      "path": "package.json",
-      "sha256": "2c100461a73f49504437c91248928a9839c932801b8208ada21795758e6056c9"
-    },
-    {
-      "path": "protocol/ENTITY_GLOBAL_PASSPORT.schema.json",
-      "sha256": "4fbfed9be1b1484bc5d28b8101d1c908b2ccced13e4e99ec896c5b054892ebdd"
-    },
-    {
-      "path": "protocol/ENTITY_V3_4_GLOBAL_PASSPORT_CLEANROOM_KIT.min.json",
-      "sha256": "5869a3fd0ed6cb9f65bf4b20c3bd64933cad82f4aef05c5809e2e05af921f230"
-    },
-    {
-      "path": "QUICKSTART.md",
-      "sha256": "268292c11c710fc159b8959d5e3aceeaae65cf037e75a7a04842e09e84c3dfce"
-    },
-    {
-      "path": "README.md",
-      "sha256": "ca836d322cecce7a74acf16e7f8dee7e95a2ae61b011d49677dff240c3b2e5c5"
-    },
-    {
-      "path": "sdk/canonical_global_passport_sdk.py",
-      "sha256": "50d40713fe7f8462f54388bd7650705fd3f17027f7692a7cf87bf3ad59230e64"
-    },
-    {
-      "path": "sdk/README.md",
-      "sha256": "9981c36e7b44de00a2a2627376620da3716eebe7f64ff260f1fd0a1290838be4"
-    },
-    {
-      "path": "SECURITY.md",
-      "sha256": "36da06976abc3b01e0963fd84acfc02d995f57a10699c7cf86c23628bea7a5a4"
-    },
-    {
-      "path": "SOURCE_RELEASE.json",
-      "sha256": "92d11a041774980aa4b9298a2d5c85f6300a179412156505ae64ff38ce116a21"
-    },
-    {
-      "path": "templates.json",
-      "sha256": "be8baefbe5b3801a786319d73ba560b052927931ce15421a2117fbf41441f3bc"
-    },
-    {
-      "path": "tools/verify_package.py",
-      "sha256": "1ad2cd598780182c10e69463ccc97f2417bfc49f18fcc64ac30fca8b687332a1"
-    }
+    {"path": ".gitattributes", "sha256": "d60f352d0db1404c70afb4bb8b2ca3fd1c610572aa40720e8a0b7baa7885418c"},
+    {"path": ".github/workflows/verify.yml", "sha256": "261f8eba4865fd6b237fd43d8008b9a5f7934d50615454bbc093e4ab5f4d05a8"},
+    {"path": ".gitignore", "sha256": "4cad133d4f0a6cf4bba15f1b8bbae48d6a55f20b94f75487c51a93cc6a5af59f"},
+    {"path": "CODE_OF_CONDUCT.md", "sha256": "075f9820f43599dceb334f3accba68d62c32589e38ef68c750c771e48695eafc"},
+    {"path": "conformance.json", "sha256": "0f875a645c2b9a94ba1e65553b06607d6a0de1d8cd9cf18d6ec362c36dd8da98"},
+    {"path": "deployment.example.json", "sha256": "9a1467794aecd064d1791824c8ba3865fecfab0d633d842c894cd133e71f8b52"},
+    {"path": "deployment.schema.json", "sha256": "3f3e84af5a154ed58e13781386c79f915e0395813c0f9c8db1bba8e929cc1a91"},
+    {"path": "LICENSE", "sha256": "c71d239df91726fc519c6eb72d318ec65820627232b2f796219e87dcf35d0ab4"},
+    {"path": "mappings.json", "sha256": "10aa7c8469f4becfd507944a19b2b173d2736cb03a3566c5742b4374f5021e7b"},
+    {"path": "NOTICE", "sha256": "0d5dbc5d8a225ba5eb152719ae4b0066ca64d3338c7dc857a68f502961a92dda"},
+    {"path": "package.json", "sha256": "2c100461a73f49504437c91248928a9839c932801b8208ada21795758e6056c9"},
+    {"path": "protocol/ENTITY_GLOBAL_PASSPORT.schema.json", "sha256": "4fbfed9be1b1484bc5d28b8101d1c908b2ccced13e4e99ec896c5b054892ebdd"},
+    {"path": "protocol/ENTITY_V3_4_GLOBAL_PASSPORT_CLEANROOM_KIT.min.json", "sha256": "5869a3fd0ed6cb9f65bf4b20c3bd64933cad82f4aef05c5809e2e05af921f230"},
+    {"path": "QUICKSTART.md", "sha256": "268292c11c710fc159b8959d5e3aceeaae65cf037e75a7a04842e09e84c3dfce"},
+    {"path": "README.md", "sha256": "d7201e1dd0ce301d3f7d24a57668aae7cdb2811d9fc8a1455d4248e9c3775d6a"},
+    {"path": "sdk/canonical_global_passport_sdk.py", "sha256": "50d40713fe7f8462f54388bd7650705fd3f17027f7692a7cf87bf3ad59230e64"},
+    {"path": "sdk/README.md", "sha256": "9981c36e7b44de00a2a2627376620da3716eebe7f64ff260f1fd0a1290838be4"},
+    {"path": "SECURITY.md", "sha256": "36da06976abc3b01e0963fd84acfc02d995f57a10699c7cf86c23628bea7a5a4"},
+    {"path": "SOURCE_RELEASE.json", "sha256": "92d11a041774980aa4b9298a2d5c85f6300a179412156505ae64ff38ce116a21"},
+    {"path": "templates.json", "sha256": "be8baefbe5b3801a786319d73ba560b052927931ce15421a2117fbf41441f3bc"},
+    {"path": "tools/verify_package.py", "sha256": "1ad2cd598780182c10e69463ccc97f2417bfc49f18fcc64ac30fca8b687332a1"}
   ],
   "package_sha256": "3a0e68fa6c63b2ef9cf79ccf463335af72d49ffb3cd028c88b6a998d8678f38f",
   "release_snapshot_sha256": "3ff0e51ca2daabf50bc517e9c6e3438e8c150f1560cca6c99621621e3c855a90",