From dddf783b1155066db628764d05296545054e5624 Mon Sep 17 00:00:00 2001 From: QunYu Date: Wed, 11 Feb 2026 18:01:51 +0800 Subject: [PATCH 1/5] Update README.md --- README.md | 169 +++++++++++++++++++++++++++++------------------------- 1 file changed, 91 insertions(+), 78 deletions(-) diff --git a/README.md b/README.md index 7e4c472..939a341 100644 --- a/README.md +++ b/README.md @@ -1,146 +1,159 @@ -# SwarmPlug +# SwarmPlug ver0.3 -### Versioned Infrastructure for Semantic Normalization in ROS Systems +**Semantic Snapshot Infrastructure** --- +## Statement -## 1. Statement +SwarmPlug ver0.3 defines a deterministic semantic snapshot model +for heterogeneous ROS-based systems. -SwarmPlug is a **versioned infrastructure project**. +It does not coordinate. +It does not transmit. +It does not decide. -It defines deterministic layers for semantic normalization -in heterogeneous ROS-based environments. +It standardizes. -SwarmPlug does **not**: +--- + +## Problem -- Replace ROS +Robotic systems expose runtime state in inconsistent forms: + +- Different topic names -- Define control logic +- Different coordinate conventions -- Implement coordination strategies +- Different mode representations -- Provide intelligence systems +- Different task encodings -SwarmPlug defines infrastructure boundaries. +Without semantic normalization, higher-level coordination becomes system-specific. --- -## 2. Development Model - -SwarmPlug evolves through **explicit version layers**. +## Position -Each version: +SwarmPlug ver0.3 introduces a neutral semantic layer +between ROS runtime and distributed coordination. -- Has a narrowly defined responsibility - -- Is boundary-limited - -- Is version-scoped - -- Does not expand retroactively - +`Host Runtime → Semantic Abstraction → Snapshot` -New capabilities are introduced only through new versions. +ver0.3 completes the semantic abstraction layer. --- -## 3. Version Index +## Architecture (Conceptual) -|Version|Responsibility| -|---|---| -|**ver0.1**|Host attachment| -|**ver0.2**|Canonical identity| -|**ver0.3**|Semantic snapshot model| +```mermaid +flowchart TB -Future versions will be introduced as independent milestones. + subgraph L1["Host Runtime"] + A1["ROS Topics / Services / Params"] + end ---- + subgraph L2["Semantic Abstraction"] + B1["Canonical Identity"] + B2["Unified State Fields"] + B3["Deterministic Trigger Model"] + end -## 4. Layered Direction + subgraph L3["Snapshot (v0.3 Schema)"] + C1["meta + identity + state"] + end -SwarmPlug development follows a strict structural progression: + A1 --> B1 --> C1 + A1 --> B2 --> C1 + B3 --> C1 ``` -Attachment - ↓ -Identity - ↓ -Semantics - ↓ -Future Layers -``` +--- -Each layer must remain: +## Determinism -- Deterministic - -- Versioned - -- Infrastructure-oriented +Snapshot generation follows two defined triggers: + +- Event-based -- Boundary-defined +- Periodic +Given identical host state and trigger, +the snapshot structure remains deterministic. + --- -## 5. Scope Discipline +## Schema Boundary -SwarmPlug explicitly separates normalization infrastructure from: +ver0.3 formalizes: -- Runtime control systems +- `meta` + +- `identity` -- Transport mechanisms +- `state` + + +Canonical state fields include: + +- pose -- Distributed coordination logic +- twist -- Intelligence or learning layers +- mode -- External anchoring or persistence systems +- task_state (optional) -These domains are outside the core normalization layer. +The schema is versioned. --- -## 6. Stability Principle +## Scope Limitation -Once defined, a version: +SwarmPlug ver0.3 does not include: -- Remains version-scoped +- Network transport + +- Mesh communication -- Remains boundary-limited +- Blockchain anchoring -- Does not absorb new responsibilities +- Decision logic + +- Control loops -Evolution occurs by addition, not modification. +Those layers are out of scope. --- -## 7. Repository Structure -``` -/ver0.1 → Host attachment layer -/ver0.2 → Canonical identity layer -/ver0.3 → Semantic snapshot layer -``` - -Each directory documents a completed infrastructure layer. +## Version Context -Subsequent versions will be added as independent directories. +|Version|Responsibility| +|---|---| +|0.1|Host connection| +|0.2|Canonical naming| +|0.3|Semantic snapshot definition| --- -## 8. Foundational Principle +## Principle Infrastructure precedes coordination. Normalization precedes intelligence. -Versioning precedes expansion. +Determinism precedes distribution. + +ver0.3 establishes the normalization layer. + + -SwarmPlug develops by structure, not by feature accumulation. ## Contact -If you are evaluating SwarmPlug for research or engineering use,feel free to reach out at: swarmplug@gmail.com -**Note:SwarmPlug is developed under a boundary-first philosophy. Core implementation remains private by design.** + +If you are evaluating SwarmPlug for research or engineering use,feel free to reach out at: + +📧 **swarmplug@gmail.com** From 76605de696767c76e8cdee1d761422b8711ac3b5 Mon Sep 17 00:00:00 2001 From: QunYu Date: Thu, 12 Feb 2026 08:09:22 +0800 Subject: [PATCH 2/5] Revise terminology in README for precision Updated terminology for clarity and consistency throughout the README. --- README.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 939a341..24e494c 100644 --- a/README.md +++ b/README.md @@ -6,14 +6,14 @@ ## Statement -SwarmPlug ver0.3 defines a deterministic semantic snapshot model +SwarmPlug ver0.3 defines a deterministic semantic snapshot specification for heterogeneous ROS-based systems. It does not coordinate. It does not transmit. It does not decide. -It standardizes. +**It standardizes.** --- @@ -36,7 +36,7 @@ Without semantic normalization, higher-level coordination becomes system-specifi ## Position -SwarmPlug ver0.3 introduces a neutral semantic layer +SwarmPlug ver0.3 defines a neutral semantic abstraction boundary between ROS runtime and distributed coordination. `Host Runtime → Semantic Abstraction → Snapshot` @@ -81,8 +81,9 @@ Snapshot generation follows two defined triggers: - Periodic -Given identical host state and trigger, -the snapshot structure remains deterministic. +Given identical host state and identical trigger conditions, +the resulting snapshot structure is invariant. + --- From 8f0515c8cc2170b5d7bdb48e939b1f7542293b79 Mon Sep 17 00:00:00 2001 From: QunYu Date: Fri, 13 Feb 2026 09:50:07 +0800 Subject: [PATCH 3/5] Delete LICENSE --- LICENSE | 21 --------------------- 1 file changed, 21 deletions(-) delete mode 100644 LICENSE diff --git a/LICENSE b/LICENSE deleted file mode 100644 index 18f8dbd..0000000 --- a/LICENSE +++ /dev/null @@ -1,21 +0,0 @@ -MIT License - -Copyright (c) 2026 QunYu - -Permission is hereby granted, free of charge, to any person obtaining a copy -of this software and associated documentation files (the "Software"), to deal -in the Software without restriction, including without limitation the rights -to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -copies of the Software, and to permit persons to whom the Software is -furnished to do so, subject to the following conditions: - -The above copyright notice and this permission notice shall be included in all -copies or substantial portions of the Software. - -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE -SOFTWARE. From 3e3056450b2a5432c42b4e7b1630c07af4c81244 Mon Sep 17 00:00:00 2001 From: QunYu Date: Fri, 13 Feb 2026 09:53:49 +0800 Subject: [PATCH 4/5] Update README.md --- README.md | 52 ++++++++++++++++++++-------------------------------- 1 file changed, 20 insertions(+), 32 deletions(-) diff --git a/README.md b/README.md index 24e494c..22afcc8 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # SwarmPlug ver0.3 -**Semantic Snapshot Infrastructure** +**Semantic Snapshot Specification** --- @@ -13,7 +13,7 @@ It does not coordinate. It does not transmit. It does not decide. -**It standardizes.** +**It standardizes semantics.** --- @@ -22,11 +22,8 @@ It does not decide. Robotic systems expose runtime state in inconsistent forms: - Different topic names - - Different coordinate conventions - - Different mode representations - - Different task encodings @@ -82,7 +79,7 @@ Snapshot generation follows two defined triggers: Given identical host state and identical trigger conditions, -the resulting snapshot structure is invariant. +the resulting snapshot structure remains invariant. --- @@ -91,19 +88,15 @@ the resulting snapshot structure is invariant. ver0.3 formalizes: -- `meta` - -- `identity` - +- `meta` +- `identity` - `state` Canonical state fields include: -- pose - -- twist - +- pose +- twist - mode - task_state (optional) @@ -117,14 +110,10 @@ The schema is versioned. SwarmPlug ver0.3 does not include: -- Network transport - -- Mesh communication - -- Blockchain anchoring - -- Decision logic - +- Network transport +- Mesh communication +- Blockchain anchoring +- Decision logic - Control loops @@ -133,12 +122,11 @@ Those layers are out of scope. --- ## Version Context - -|Version|Responsibility| -|---|---| -|0.1|Host connection| -|0.2|Canonical naming| -|0.3|Semantic snapshot definition| +| Version | Responsibility | +|---------|----------------------| +| ver0.1 | Host attachment | +| ver0.2 | Canonical identity | +| ver0.3 | Semantic snapshot | --- @@ -150,11 +138,11 @@ Determinism precedes distribution. ver0.3 establishes the normalization layer. +## License +This version specification is part of the SwarmPlug documentation. -## Contact +Licensed under the **SwarmPlug Documentation License v1.0**. +See the root LICENSE file for details. -If you are evaluating SwarmPlug for research or engineering use,feel free to reach out at: - -📧 **swarmplug@gmail.com** From 1bb7f7984c83da0ffe1fa9a77a5cd73542dcb902 Mon Sep 17 00:00:00 2001 From: QunYu Date: Fri, 13 Feb 2026 10:39:30 +0800 Subject: [PATCH 5/5] Update README.md --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 22afcc8..47138bc 100644 --- a/README.md +++ b/README.md @@ -38,7 +38,7 @@ between ROS runtime and distributed coordination. `Host Runtime → Semantic Abstraction → Snapshot` -ver0.3 completes the semantic abstraction layer. +**ver0.3 completes the semantic abstraction layer.** --- @@ -136,7 +136,7 @@ Infrastructure precedes coordination. Normalization precedes intelligence. Determinism precedes distribution. -ver0.3 establishes the normalization layer. +**ver0.3 establishes the normalization layer.** ## License @@ -144,5 +144,5 @@ This version specification is part of the SwarmPlug documentation. Licensed under the **SwarmPlug Documentation License v1.0**. -See the root LICENSE file for details. +See the **main LICENSE** file for details.