docs: add Hermes Tweet public context

[kriptoburak]

Summary

• Adds Hermes Tweet as optional public context for Hermes users.
• Keeps xurl as Awaek's private bookmark source.
• Requires HERMES_TWEET_ENABLE_ACTIONS to remain unset.
• Limits companion guidance to available read-only tools.
• Keeps database self-tests isolated from real bookmark libraries.

Independent Repository Fix

db.py --self-test previously used the configured Awaek database. It inserted
a fake bookmark into the user's real library.

The self-test now uses a temporary database. It removes that database after
each run. It also restores configured paths after success or failure. Regression
tests verify both paths and confirm no configured directory gets created.

Companion Boundary

Use Hermes Tweet only after retrieving saved-bookmark evidence. Public reads,
replies, user lookup, trends, and public timelines remain available. Keyword
monitoring requires the disabled action tool, so this PR no longer recommends
it.

Validation

• python3 -m unittest discover -s tests -p 'test_*.py' -v - 2 passed
• python3 skills/awaek/scripts/db.py --self-test
• uvx ruff check --select E4,E7,E9,F,I skills/awaek/scripts/db.py tests/test_db_self_test.py
• Python 3.9 through 3.13 compilation
• Current Hermes Tweet repository and tool contract verified
• git diff --check
• Git object and clean-merge checks

Notes

GitHub does not report license metadata for this repository.

Xquik is an independent third-party service. Not affiliated with X Corp. "Twitter" and "X" are trademarks of X Corp.

[kriptoburak]

@1lystore I added a repository-level safety fix alongside the Hermes Tweet documentation in bb9edbb.

• db.py --self-test no longer writes a fake bookmark into the user's configured database.
• The self-test uses a temporary database and restores paths after success or failure.
• Both regression tests pass, the isolated CLI self-test passes, and the full PR diff is clean.
• The PR remains clean and mergeable with no unresolved review threads.

This is ready for maintainer review.

[kriptoburak]

Published signed repair commit 5fb0be9.

• Rebuilt the complete PR as 1 GitHub-verified signed commit.
• Preserved the isolated SQLite self-test fix and both regression tests.
• Added the read-only Hermes Tweet guidance to skills/awaek/SKILL.md, the actual Hermes-installable Skill path, so the root OpenClaw copy and nested Hermes copy no longer disagree about this companion workflow.
• Re-ran both tests, Python compilation, the isolated CLI self-test, Ruff checks, live link checks, and Git diff validation.

The PR is cleanly mergeable with no maintainer request, review thread, or failing check outstanding.

Xquik is an independent third-party service. Not affiliated with X Corp. "Twitter" and "X" are trademarks of X Corp.

[kriptoburak]

Follow-up is in GitHub-verified signed commit f0a658c.

The complete re-audit found one capability conflict. Keyword monitoring uses Hermes Tweet's disabled action tool, but the Awaek guidance requires read-only mode.

All 3 public guidance copies now recommend public timelines instead. The database regression also verifies both configured paths and proves no configured directory gets created.

Validation passed: 2 tests, isolated CLI self-test, the exact Ruff syntax/import gate, Python 3.9 through 3.13, object integrity, and a clean upstream merge tree.

Xquik is an independent third-party service. Not affiliated with X Corp. "Twitter" and "X" are trademarks of X Corp.