OpenVibe.Sources

OpenVibe.Sources is "the source registry and the ingestion workers the publication products depend on". Every item records where it came from, when it was retrieved and on what terms, and a failed fetch is recorded as a failure, never replaced by invented content. The README gives the status as alpha (roadmap Wave 14): it "runs and is tested against stub sites; not deployed; the six seeded sources are disabled". It names sources.openvibe.network as the domain, with health only on the public vhost and the API host-local; Sources has no public pages by design.

Purpose

The README states that News, Reviews, Deals, Coupons, Trade and AI summarisation all need outside material, and that Sources is the one place it enters the network. Products read items with provenance and decide, under their own review and indexability rules, what to publish.

What it owns

• the source registry, in which each source carries terms, robots and license notes and a rate limit; a source cannot be enabled without a terms note;
• ingestion: fetch runs, items and item revisions, the scheduler, and robots.txt and rate-limit state;
• sources.* events.

Each fetch attempt is recorded with an explicit state such as ok, http_error, timeout or robots_denied, and "a failed run never creates or modifies an item". Adapters read RSS, Atom, sitemaps, JSON-LD, mapped APIs and manually entered items.

What it does not own

Publication decisions, AI summarisation, and legal clearance: a terms note records what a person verified and does not replace verifying.

Relationships

Callers use OpenVibe.Network client-credentials tokens. Sources publishes its events through a transactional outbox to OpenVibe.Events. For sources marked search_visibility: "members", raw items are indexed in OpenVibe.Search for staff only and always as noindex. The consuming products (News, Reviews, Deals, Coupons, Trade) do not exist yet. STATUS.json gives the runtime as Node 22, Express, better-sqlite3 and fast-xml-parser on port 4720. The license is AGPL-3.0.