chore: initial OpenWiki wiki snapshot (2026-07-16)

2026-07-16 17:10:55 +08:00
commit 55252e3c80
10 changed files with 551 additions and 0 deletions
@@ -0,0 +1,34 @@
+# Sources
+
+Per-connector evidence indexes. Each connector gets its own page (for example `gmail.md`, `slack.md`) that records ingestion coverage, freshness, and a compact evidence trail. Durable synthesis lives on the canonical pages (`/themes.md`, `/commitments.md`, `/personal-logistics.md`, `/open-questions.md`); these source pages are the evidence layer underneath.
+
+## Active connectors
+
+| Connector | Page | Status |
+| --- | --- | --- |
+| Hacker News (`hackernews-1`, LLM-agent topics) | [/sources/hackernews.md](/sources/hackernews.md) | active |
+| Git repo (`obsidian-robin`, Obsidian vault) | [/sources/git-repo.md](/sources/git-repo.md) | active |
+
+Additional connectors appear here automatically once they are authenticated and ingested at least once.
+
+## Connector roll
+
+| Connector | Status | Auth / env var | Notes |
+| --- | --- | --- | --- |
+| Gmail (`google`) | not configured | `OPENWIKI_GOOGLE_*` via `openwiki auth google` | Direct API; defaults to `newer_than:1d`. |
+| Slack | not configured | `openwiki auth slack` | Needs `search:read` for definitive self-message search; otherwise falls back to recent conversations. |
+| Notion | not configured | Notion MCP credentials | Discovery via `openwiki_list_mcp_tools`; do not guess tool names. |
+| X / Twitter | not configured | `OPENWIKI_X_ACCESS_TOKEN` via `openwiki auth x` | Streams: `home_timeline`, `user_posts`, `mentions`, `bookmarks`, `list_posts`. |
+| Web Search | not configured | `TAVILY_API_KEY` | Tavily via LangChain; reads configured queries. |
+| Hacker News | **active** (`hackernews-1`) | _(public, no auth)_ | Public feeds (`top`, `new`, `best`) + Algolia HN search queries. Evidence at [/sources/hackernews.md](/sources/hackernews.md). |
+| Git repo | **active** (`obsidian-robin`) | local repo path | Local Obsidian vault under `~/.openclaw/workspace`. Writes compact manifest; repo itself is source of truth. Evidence at [/sources/git-repo.md](/sources/git-repo.md). |
+
+## How new source pages get created
+
+When a connector ingests for the first time, an update run will:
+
+1. Write the raw dump to `~/.openwiki/connectors/<connector>/raw/`.
+2. Create `/sources/<connector>.md` with the ingestion manifest, freshness, and compact evidence notes.
+3. Route durable items into the canonical pages and add a row in `/themes.md` if a recurring signal emerges.
+
+Until then, the new connector only has a row in the active connectors table above and no evidence page of its own.