Files
openwiki-wiki/sources/README.md
T
2026-08-18 02:23:43 +08:00

42 lines
4.4 KiB
Markdown

---
type: "Reference"
title: "Sources"
description: "Per-connector evidence indexes and ingestion coverage for the local knowledge wiki; durable synthesis lives on canonical pages."
tags: [sources, connectors, evidence, ingestion]
---
# 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 (`git-repo-1`, Obsidian vault + OpenWiki wiki) | [/sources/git-repo.md](/sources/git-repo.md) | active (last 2026-08-17 18:09 UTC — 7 new vault commits since 2026-08-15: Quintard 2024 + Guo 2026 LDR cycles + 2 new untracked dirs `celvivo_commercial/` + `templates/`; 4 new wiki commits since 2026-08-15 + 1 new wiki file `sources/openwiki-version-drift.md`) |
| Web Search (`web-search-1`, Tavily) | [/sources/web-search.md](/sources/web-search.md) | active (latest pull 2026-08-03; 2026-08-08, 2026-08-10, 2026-08-12, and 2026-08-15 update attempts skipped — connector not enabled, `TAVILY_API_KEY` missing) |
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 | **active** (`web-search-1`) | `TAVILY_API_KEY` (currently empty) | Tavily via LangChain; reads configured queries. Latest successful pull 2026-08-03 18:08 UTC; the 2026-08-08, 2026-08-10, 2026-08-12, 2026-08-15, and 2026-08-17 update attempts were skipped because the connector was not enabled in the runtime registry. Evidence at [/sources/web-search.md](/sources/web-search.md). |
| Hacker News | **active** (`hackernews-1`) | _(public, no auth)_ | Public feeds (`top`, `new`, `best`) + Algolia HN search queries. Source-specific query set: `organoid`, `CelVivo`, `3Brain`, `Cellink`, `openwiki`, `deepagents` (LLM-agent topics per the source-specific instruction "Track organoid / CelVivo / 3Brain / Cellink / openwiki / AI agent stories"). Last successful pull 2026-08-17 18:00 UTC — sixth pull since 2026-08-07 to have an empty / noise-only Algolia lane on vendor queries (after the 2026-08-08 03:15 + 2026-08-08 18:00 + 2026-08-13 + 2026-08-15 + 2026-08-16 fully-zero pulls and the 2026-08-10 + 2026-08-12 noise-only pulls; empty-pulls-on-vendor-queries is normal cadence, not an outage). Evidence at [/sources/hackernews.md](/sources/hackernews.md). |
| Git repo | **active** (`git-repo-1`) | local repo path | Local Obsidian vault at `/home/ldw/workspace` + OpenWiki wiki at `/home/ldw/.openwiki/wiki` (two configured repos per `~/.openwiki/connectors/git-repo/config.json`). Writes compact manifest; repo itself is source of truth. Evidence at [/sources/git-repo.md](/sources/git-repo.md). Last updated 2026-08-17 18:09 UTC — 7 new vault commits since 2026-08-15 (Quintard 2024 + Guo 2026 LDR cycles; 2 new untracked dirs `celvivo_commercial/` + `templates/`); 4 new wiki commits since 2026-08-15 + 1 new wiki file `sources/openwiki-version-drift.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..