docs: concept annexation, provider/reference docs, ACT-1 groundwork

Mosaic concepts pages now own the adapted content; source/license metadata under docs/reference/concepts. Adds ACT-1 agent-context planning capture, pinned concept test package + preparation utility, foundation observation notes (durability, evidence, federation, onboarding, workflow), and the #1495 consolidation assessment. TOOLS.md updated for the host-dev launcher.
2026-09-07 14:07:05 -05:00
parent 7c580a5625
commit 193479b52d
119 changed files with 21185 additions and 0 deletions
@@ -0,0 +1,24 @@
+MIT License
+
+Copyright (c) 2026 OpenClaw Foundation
+
+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.
+
+Third-party notices for incorporated or adapted code are recorded in
+THIRD_PARTY_NOTICES.md.
@@ -0,0 +1,21 @@
+# Concept documentation provenance
+
+The maintained Mosaic explanations live in [docs/concepts](../../concepts/README.md).
+This directory contains supporting attribution and content-identity metadata only.
+
+The first twelve references were obtained from the OpenClaw documentation at
+commit `5c59952cd0a451c4aadd277c329e4ad0a3fca36f`, then substantively adapted for
+Mosaic on 2026-09-07. The previously stored SOUL guide was also adapted. Preserve
+the [MIT license and copyright notice](LICENSE) when distributing derived material.
+Attribution is a legal/provenance record, not runtime nomenclature or authority.
+
+[SOURCE.json](SOURCE.json) schema 2 records current Mosaic paths, sizes and hashes
+separately from each original reference's path and hash. The original source
+revision does not identify the rewritten Mosaic content. Future concept changes
+must update the current content identity without rewriting their original lineage.
+
+The upstream copies were replaced by the Mosaic pages. Their recorded source
+paths/revision/hashes allow reconciliation against the original checkout; the
+initial temporary ACT-1 review workspace also retains its imported snapshot.
+Historical plan/log entries remain descriptions of what happened at the time.
+They are not instructions to use the retired reference directory.
@@ -0,0 +1,159 @@
+{
+  "schemaVersion": 2,
+  "adaptedAt": "2026-09-07",
+  "purpose": "Mosaic-owned concept documentation; source attribution retained separately from current content identity",
+  "sourceRoot": "/mnt/storage/src/openclaw",
+  "sourceRevision": "5c59952cd0a451c4aadd277c329e4ad0a3fca36f",
+  "license": {
+    "path": "docs/reference/concepts/LICENSE",
+    "sourcePath": "LICENSE",
+    "bytes": 1170,
+    "sha256": "73571b25326281d369087f469842c02444fe39faaecebda4d82ed21ff3a1c29d"
+  },
+  "files": [
+    {
+      "file": "agent-behavior-tests.md",
+      "path": "docs/concepts/agent-behavior-tests.md",
+      "bytes": 2027,
+      "sha256": "b60e14e50c3af9316dbd52c20e48e50c6682b3717145a76ffcc703bc740996b9",
+      "origin": {
+        "sourcePath": "docs/concepts/personal-agent-benchmark-pack.md",
+        "bytes": 4223,
+        "sha256": "832e5ab0ba9052f161bcef35a5445dc32efc46e796574397e154be70ea608341"
+      }
+    },
+    {
+      "file": "agent-runtimes.md",
+      "path": "docs/concepts/agent-runtimes.md",
+      "bytes": 2197,
+      "sha256": "e92136eb0525aec4733aa4dd8d03b71ec257973a29a29d2157c9fc1ba124cadd",
+      "origin": {
+        "sourcePath": "docs/concepts/agent-runtimes.md",
+        "bytes": 19155,
+        "sha256": "d261b2388b57115f95032374e41602311d1106f85c3307e0b51335a9da01c762"
+      }
+    },
+    {
+      "file": "context.md",
+      "path": "docs/concepts/context.md",
+      "bytes": 2143,
+      "sha256": "b32f3fedbae1a867023ef6ce35ba00b5654ff8834c125df30e636eb3d0e6b8ce",
+      "origin": {
+        "sourcePath": "docs/concepts/context.md",
+        "bytes": 10239,
+        "sha256": "0d57c0c09fcb5033f799b2ba9c7646a5ce91aaab7e38261be0ab6b5ae569d489"
+      }
+    },
+    {
+      "file": "managed-worktrees.md",
+      "path": "docs/concepts/managed-worktrees.md",
+      "bytes": 2226,
+      "sha256": "bdeec9779260f484978038323c559d1c1eb902b394774e623340539095da31de",
+      "origin": {
+        "sourcePath": "docs/concepts/managed-worktrees.md",
+        "bytes": 22219,
+        "sha256": "212f196d38c686d392e97daa5e3d355d795a99c42db71b8d8ee080f11b605b87"
+      }
+    },
+    {
+      "file": "memory-architecture.md",
+      "path": "docs/concepts/memory-architecture.md",
+      "bytes": 2233,
+      "sha256": "2a98e239a2f0e8ae37fffa389ddf8058a8795cd9aaabcff4c6034a641e0cd32a",
+      "origin": {
+        "sourcePath": "docs/concepts/memory-architecture.md",
+        "bytes": 25418,
+        "sha256": "6ef989807ee10b9429796d1c9a7ad8cce9b1e8984f5f1f71b003f1849498848f"
+      }
+    },
+    {
+      "file": "memory-provenance.md",
+      "path": "docs/concepts/memory-provenance.md",
+      "bytes": 2051,
+      "sha256": "b9f73610c20d800349770ffa3395fad42b8a90f98bdcc6b327f619727490ce5a",
+      "origin": {
+        "sourcePath": "docs/concepts/memory-provenance.md",
+        "bytes": 14584,
+        "sha256": "c6616ce5d43b5fa59448931c61d6649ba3c2175421f8f691a97165e1cf7dbaa9"
+      }
+    },
+    {
+      "file": "multi-user.md",
+      "path": "docs/concepts/multi-user.md",
+      "bytes": 1986,
+      "sha256": "0a55541c1d9b79c305d17c4cd328380f49b4a889e2bad61279fe831a97ee284a",
+      "origin": {
+        "sourcePath": "docs/concepts/multi-user.md",
+        "bytes": 28853,
+        "sha256": "d3a7a2069f1f7347edf8f5b9f21202acee049f4e536bfd06923de435d4ac1e30"
+      }
+    },
+    {
+      "file": "queue-steering.md",
+      "path": "docs/concepts/queue-steering.md",
+      "bytes": 2123,
+      "sha256": "4bb2ef933f979d6d819d2e9dd5b03fa8c81d99d00adb0e5721f6bf660cde34b7",
+      "origin": {
+        "sourcePath": "docs/concepts/queue-steering.md",
+        "bytes": 6177,
+        "sha256": "3ce3cadc8796f4f95ea7107600d57062479c7a967e25beea87bcd5ab96e58263"
+      }
+    },
+    {
+      "file": "session-attachment.md",
+      "path": "docs/concepts/session-attachment.md",
+      "bytes": 2155,
+      "sha256": "d4d8fca006925810b9fd27f61ca43caed5318f0e7116d3406bbfa4f02a49f0eb",
+      "origin": {
+        "sourcePath": "docs/concepts/session-attachment.md",
+        "bytes": 13825,
+        "sha256": "4fadc537ec72c828920ba0c702cd653df3a30bcf2db98f1127aee66c9d3dbb63"
+      }
+    },
+    {
+      "file": "session-state.md",
+      "path": "docs/concepts/session-state.md",
+      "bytes": 2255,
+      "sha256": "0cecd0268eef99d0136411d8deae7379622f364a0fb7c2337a0ebfdd5db03f84",
+      "origin": {
+        "sourcePath": "docs/concepts/session-state.md",
+        "bytes": 10849,
+        "sha256": "33373a2ff488ec8e6e66b776294d111b0ef8f9150ace331bc8016941f076a659"
+      }
+    },
+    {
+      "file": "soul.md",
+      "path": "docs/concepts/soul.md",
+      "bytes": 2177,
+      "sha256": "adacdc23b23fe60d0d464d84537876f162846824851f44f88d86b3b9157cd6d0",
+      "origin": {
+        "sourcePath": "docs/concepts/soul.md",
+        "description": "Previously stored reference before Mosaic adaptation",
+        "bytes": 3841,
+        "sha256": "c53531d687ba7a2340b779a419c282c8ba22193ff52f6e21005f3fd3bde88cb2"
+      }
+    },
+    {
+      "file": "standing-intents.md",
+      "path": "docs/concepts/standing-intents.md",
+      "bytes": 2136,
+      "sha256": "fef32ec7b27dd876f52e9a614319445b4bbfec41f6a68553f7e9c1109a031f06",
+      "origin": {
+        "sourcePath": "docs/concepts/standing-intents.md",
+        "bytes": 5471,
+        "sha256": "81bef6fd6a4fcf4e49ed496cdcb7f9f750a17ef1a3702e579d2911c2e62b4ed1"
+      }
+    },
+    {
+      "file": "system-prompt.md",
+      "path": "docs/concepts/system-prompt.md",
+      "bytes": 2644,
+      "sha256": "290108b62ec49b0da829490c8d20186e38a7bf90800db615c977262d9dda0e9f",
+      "origin": {
+        "sourcePath": "docs/concepts/system-prompt.md",
+        "bytes": 23788,
+        "sha256": "b8c381f1441a47931e3f4fba0faf8ee51a614c70be8e87522e0a15bfc44eec34"
+      }
+    }
+  ]
+}