{"id":"meta-wiki-art-bridge","relativePath":"meta-wiki-art-bridge.md","title":"Meta Wiki Art Bridge (MediaWiki + Wikibase)","markdown":"# Meta Wiki Art Bridge (MediaWiki + Wikibase)\n\nStatus: Era C5 implementation is active, with the source-of-truth contract finalized.\n\n## Decision\n\nMeta Museum will use a **MediaWiki instance extended with a custom Wikibase** as the publication surface for the Meta Wiki Art bridge.\n\nThis extends the existing C5 plan from \"publish to MediaWiki\" to a structured semantic publication model that supports statement-level references and authority reconciliation.\n\n## Source-Of-Truth Contract (Finalized)\n\nChosen model: **publication-target-only**.\n\n- Canonical source of truth: Meta Museum internal Linked Art records in Postgres/storage (`/api/records` domain model).\n- Wiki role: governed publication projection layer (MediaWiki narrative + Wikibase statements/references).\n- Edit ownership: publication content may evolve on wiki, but canonical data corrections must flow through Meta Museum ingest/reconciliation pipelines first.\n- Publish gate: `/api/wiki-drafts/[id]/publish` preflight now requires the draft `sourceRecordId` to resolve to an existing internal record.\n- Runtime policy key: `METAMUSEUM_WIKI_SOURCE_OF_TRUTH_MODE` (default and current enforced mode is `publication-target-only`).\n\nCommunity-editable mode now requires explicit opt-in and reverse-ETL enablement:\n\n- `METAMUSEUM_WIKI_SOURCE_OF_TRUTH_MODE=community-editable`\n- `METAMUSEUM_WIKI_REVERSE_ETL_ENABLED=1`\n\nReverse-ETL endpoint:\n\n- `POST /api/wiki-sync/reverse-etl`\n\nDeterministic merge policy (implemented):\n\n1. Resolve internal target record via explicit `internalEntityId` or bidirectional sync map (`wikiItemId` -> internal ID).\n2. Normalize + sort incoming claims deterministically (`property`, `modifiedAt`, `changeId`, `value`).\n3. Apply per-property precedence:\n - newer `modifiedAt` wins;\n - tie-break by lexicographic `changeId`;\n - older/equal precedence claims are skipped.\n4. Idempotency:\n - replayed `changeId` is skipped safely.\n5. Mapped claim updates:\n - `P_label` -> record `_label`\n - `P_primary_name` -> first `identified_by` Name\n - `P_description` -> `referred_to_by` statement (`Wikibase Description`)\n - `P_publish_rights_status` -> `referred_to_by` statement (`Wikibase Publish Rights Status`)\n6. Unmapped claim properties remain no-op for record fields but are tracked in merge state for deterministic conflict handling.\n\n## Why this fits\n\n1. Linked Art alignment:\n Linked Art JSON-LD, RDF modeling, and planned SPARQL workflows map directly to Wikibase's item/property statement model.\n2. AI grounding:\n C4 Graph-RAG and NL→SPARQL require verifiable, structured entities; Wikibase supplies a strong query/citation substrate.\n3. Provenance requirements:\n Meta Museum's \"cite or refuse\" rule is reinforced by Wikibase statement references and qualifiers.\n4. Authority reconciliation:\n B6/C2 authority-cache work (AAT/ULAN/TGN/Wikidata/GeoNames/LoC) maps naturally to external IDs and exact-match links in Wikibase.\n\n## Sequencing constraints\n\nThis bridge is intentionally deferred until Era C5. It must not ship before Era B hardening is complete.\n\nRequired gates before write-path activation:\n\n1. SHACL validation stable (B2).\n2. Postgres as storage of record (B3 cutover complete).\n3. Auth + role-gated write paths and auditability (B4).\n4. Authority cache and reconciliation baselines established (B6/C2).\n\n## Planned C5 flow\n\n1. Curator/agent creates `WikiDraft`.\n2. Draft enters human review queue with rights + citation checks.\n3. Approved draft publishes to MediaWiki/Wikibase:\n - narrative article content (MediaWiki),\n - structured claims + references (Wikibase),\n - source attribution + rights templates.\n4. Publish action writes an audit trail and stores return identifiers for round-trip sync.\n\n## Boundaries (Out Of Scope For Era A/B)\n\n1. Live MediaWiki/Wikibase provisioning in current app runtime.\n2. Public write automation from agents without explicit human approval.\n3. Direct external-authority query on request path.\n\n## Migration operations playbook\n\nFor cost-first rollout (Wikibase Cloud now) with a controlled path to self-hosted Wikibase later, use:\n\n- [wikibase-cloud-migration-checklist.md](wikibase-cloud-migration-checklist.md)\n","sections":[{"level":2,"heading":"Decision","anchor":"decision"},{"level":2,"heading":"Source-Of-Truth Contract (Finalized)","anchor":"source-of-truth-contract-finalized"},{"level":2,"heading":"Why this fits","anchor":"why-this-fits"},{"level":2,"heading":"Sequencing constraints","anchor":"sequencing-constraints"},{"level":2,"heading":"Planned C5 flow","anchor":"planned-c5-flow"},{"level":2,"heading":"Boundaries (Out Of Scope For Era A/B)","anchor":"boundaries-out-of-scope-for-era-a-b"},{"level":2,"heading":"Migration operations playbook","anchor":"migration-operations-playbook"}],"html":"

Meta Wiki Art Bridge (MediaWiki + Wikibase)

\n

Status: Era C5 implementation is active, with the source-of-truth contract finalized.

\n

Decision

\n

Meta Museum will use a MediaWiki instance extended with a custom Wikibase as the publication surface for the Meta Wiki Art bridge.

\n

This extends the existing C5 plan from "publish to MediaWiki" to a structured semantic publication model that supports statement-level references and authority reconciliation.

\n

Source-Of-Truth Contract (Finalized)

\n

Chosen model: publication-target-only.

\n\n

Community-editable mode now requires explicit opt-in and reverse-ETL enablement:

\n\n

Reverse-ETL endpoint:

\n\n

Deterministic merge policy (implemented):

\n
  1. Resolve internal target record via explicit `internalEntityId` or bidirectional sync map (`wikiItemId` -> internal ID).
\n
  1. Normalize + sort incoming claims deterministically (`property`, `modifiedAt`, `changeId`, `value`).
\n
  1. Apply per-property precedence:
\n
  1. Idempotency:
\n
  1. Mapped claim updates:
\n
  1. Unmapped claim properties remain no-op for record fields but are tracked in merge state for deterministic conflict handling.
\n\n

Why this fits

\n
  1. Linked Art alignment:
\n

Linked Art JSON-LD, RDF modeling, and planned SPARQL workflows map directly to Wikibase's item/property statement model.

\n
  1. AI grounding:
\n

C4 Graph-RAG and NL→SPARQL require verifiable, structured entities; Wikibase supplies a strong query/citation substrate.

\n
  1. Provenance requirements:
\n

Meta Museum's "cite or refuse" rule is reinforced by Wikibase statement references and qualifiers.

\n
  1. Authority reconciliation:
\n

B6/C2 authority-cache work (AAT/ULAN/TGN/Wikidata/GeoNames/LoC) maps naturally to external IDs and exact-match links in Wikibase.

\n

Sequencing constraints

\n

This bridge is intentionally deferred until Era C5. It must not ship before Era B hardening is complete.

\n

Required gates before write-path activation:

\n
  1. SHACL validation stable (B2).
\n
  1. Postgres as storage of record (B3 cutover complete).
\n
  1. Auth + role-gated write paths and auditability (B4).
\n
  1. Authority cache and reconciliation baselines established (B6/C2).
\n

Planned C5 flow

\n
  1. Curator/agent creates `WikiDraft`.
\n
  1. Draft enters human review queue with rights + citation checks.
\n
  1. Approved draft publishes to MediaWiki/Wikibase:
\n
  1. Publish action writes an audit trail and stores return identifiers for round-trip sync.
\n\n

Boundaries (Out Of Scope For Era A/B)

\n
  1. Live MediaWiki/Wikibase provisioning in current app runtime.
\n
  1. Public write automation from agents without explicit human approval.
\n
  1. Direct external-authority query on request path.
\n

Migration operations playbook

\n

For cost-first rollout (Wikibase Cloud now) with a controlled path to self-hosted Wikibase later, use:

\n","updatedAt":"2018-10-20T01:46:40.000Z","checksum":"7a43fb0c48b81dc661e5bddd784c40be859371198013308113d7ea3aa7b5e7f5","checksumPrefix":"7a43fb0c48b8","anchorCount":7,"lineCount":90,"rawUrl":"/api/docs/content?path=meta-wiki-art-bridge.md","htmlUrl":"/docs?doc=meta-wiki-art-bridge.md","apiUrl":"/api/docs/content?path=meta-wiki-art-bridge.md"}