Import X archives into Cued

docs/integration-policy.md

@@ -35,6 +35,12 @@ QR or device-linking flows are acceptable when they are the platform's normal lo
 
 Shared or managed app credentials must be injected at release time or supplied through local environment/config overrides for source builds. They must not be committed.
 
+## X
+
+X archive support ports only the useful normalization behavior from [Birdclaw](https://github.com/steipete/birdclaw) and the small Go-adapter pattern from [Clawdex](https://github.com/openclaw/clawdex). The bundled helper reads an X archive zip directly; Cued does not install, invoke, or read the database of either project.
+
+Put the exported `twitter*.zip` or `x*archive*.zip` in `~/Downloads`, or set `CUED_X_ARCHIVE_PATH`. Cued imports DM contacts, conversations, messages, and follower/following relationships into `~/.cued/local.db`; current mutual state and its archive generation live in `contact_sources.metadata_json`. Sync is manual because the archive is a point-in-time export: run `cued sync run x` after replacing it.
+
 ## Telegram
 
 Telegram is deferred for the public OSS launch.

native/helpers/birdclaw-go/.gitignore

@@ -0,0 +1 @@
+.build/

native/helpers/birdclaw-go/LICENSE.openclaw

@@ -0,0 +1,45 @@
+MIT License
+
+Copyright (c) 2026 openclaw
+
+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.
+
+---
+
+MIT License
+
+Copyright (c) 2026 Peter Steinberger
+
+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.

native/helpers/birdclaw-go/go.mod

@@ -0,0 +1,3 @@
+module cued-birdclaw-helper
+
+go 1.26.0