@refract-org/evidence-graph 0.2.1

package/src/schemas/evidence.ts

@@ -0,0 +1,83 @@
+// Evidence event — what happened at a revision boundary
+
+export type EvidenceLayer = "observed" | "policy_coded" | "model_interpretation" | "speculative" | "unknown";
+
+export type EventType =
+  | "sentence_first_seen"
+  | "sentence_removed"
+  | "sentence_reintroduced"
+  | "citation_added"
+  | "citation_removed"
+  | "citation_replaced"
+  | "template_added"
+  | "template_removed"
+  | "revert_detected"
+  | "section_reorganized"
+  | "lead_promotion"
+  | "lead_demotion"
+  | "page_moved"
+  | "wikilink_added"
+  | "wikilink_removed"
+  | "category_added"
+  | "category_removed"
+  | "protection_changed"
+  | "talk_page_correlated"
+  | "talk_thread_opened"
+  | "talk_thread_archived"
+  | "talk_reply_added"
+  | "template_parameter_changed"
+  | "edit_cluster_detected"
+  | "talk_activity_spike";
+
+export interface FactProvenance {
+  analyzer: string;
+  version: string;
+  inputHashes: string[];
+}
+
+export type PolicyDimension =
+  | "verifiability"
+  | "npov"
+  | "blp"
+  | "due_weight"
+  | "protection"
+  | "edit_warring"
+  | "notability"
+  | "copyright"
+  | "civility";
+
+export interface DeterministicFact {
+  fact: string;
+  detail?: string;
+  provenance?: FactProvenance;
+}
+
+export interface ModelInterpretation {
+  semanticChange: string;
+  confidence: number;
+  policyDimension?: PolicyDimension;
+  discussionType?:
+    | "notability_challenge"
+    | "sourcing_dispute"
+    | "neutrality_concern"
+    | "content_deletion"
+    | "content_addition"
+    | "naming_dispute"
+    | "procedural"
+    | "other";
+}
+
+export interface EvidenceEvent {
+  eventId?: string;
+  eventType: EventType;
+  claimId?: string;
+  fromRevisionId: number;
+  toRevisionId: number;
+  section: string;
+  before: string;
+  after: string;
+  deterministicFacts: DeterministicFact[];
+  modelInterpretation?: ModelInterpretation;
+  layer: EvidenceLayer;
+  timestamp: string; // ISO 8601
+}

package/src/schemas/report.ts

@@ -0,0 +1,54 @@
+// Report — the assembled output of the provenance engine
+
+import type { EvidenceLayer } from "./evidence.js";
+
+export type ReportLayerLabel = EvidenceLayer;
+
+export type ExportFormat = "json" | "pdf" | "csv" | "html";
+
+export type Depth = "brief" | "detailed" | "forensic";
+
+export interface ReportLayer {
+  label: ReportLayerLabel;
+  description: string;
+  events: number;
+  reproducible: boolean;
+}
+
+export interface Report {
+  pageTitle: string;
+  pageId: number;
+  analyzedRevisionRange: { from: number; to: number };
+  generatedAt: string; // ISO 8601
+  depth: Depth;
+  layers: ReportLayer[];
+  timeline: PageTimeline;
+  claims: string[]; // Claim IDs
+  sources: string[]; // Source IDs
+  policySignals: PolicySignal[];
+  caveats: string[];
+  phase: string;
+}
+
+export interface PageTimeline {
+  totalRevisions: number;
+  analyzedRevisions: number;
+  dateRange: { start: string; end: string };
+  events: TimelineEvent[];
+}
+
+export interface TimelineEvent {
+  revisionId: number;
+  timestamp: string;
+  eventType: string;
+  summary: string;
+  layer: ReportLayerLabel;
+}
+
+export interface PolicySignal {
+  dimension: string; // e.g., "verifiability", "npov", "blp", "due_weight"
+  signal: string; // e.g., "citation_needed_template_added", "blp_template_active"
+  firstSeenRevisionId: number;
+  lastSeenRevisionId?: number;
+  active: boolean;
+}

package/src/schemas/revision.ts

@@ -0,0 +1,41 @@
+// Revision and diff — raw Wikipedia data types
+
+export interface Revision {
+  revId: number;
+  pageId: number;
+  pageTitle: string;
+  timestamp: string; // ISO 8601
+  user?: string; // Editor username (may be hidden via oversight)
+  comment: string; // Edit summary
+  content: string; // Full wikitext
+  size: number; // Bytes
+  minor: boolean;
+}
+
+export interface DiffResult {
+  fromRevId: number;
+  toRevId: number;
+  lines: DiffLine[];
+  sections: SectionChange[];
+  sizeDelta: number;
+}
+
+export interface DiffLine {
+  type: "added" | "removed" | "unchanged";
+  content: string;
+  lineNumber: number;
+}
+
+export interface Section {
+  title: string;
+  level: number; // 1 = lead, 2 = == Section ==, 3 = === Subsection ===
+  content: string;
+  byteOffset: number;
+}
+
+export interface SectionChange {
+  section: string;
+  changeType: "added" | "removed" | "modified" | "moved" | "unchanged";
+  fromContent?: string;
+  toContent?: string;
+}

package/src/schemas/source.ts

@@ -0,0 +1,37 @@
+// Source record — citation lineage in Wikipedia
+
+export type SourceType =
+  | "primary"
+  | "secondary"
+  | "tertiary"
+  | "self_published"
+  | "news"
+  | "academic"
+  | "government"
+  | "unknown";
+
+export type SourceAuthority = "high" | "medium" | "low" | "disputed" | "unrated";
+
+export interface SourceRecord {
+  sourceId: string; // Deterministic hash from URL or identifier
+  url?: string;
+  title?: string;
+  sourceType: SourceType;
+  authority: SourceAuthority;
+  firstSeenRevisionId: number;
+  firstSeenAt: string; // ISO 8601
+  lastSeenRevisionId?: number;
+  lastSeenAt?: string;
+  claimsReferencing: string[]; // Claim IDs that cite this source
+}
+
+export interface SourceLineage {
+  sourceId: string;
+  replacements: SourceReplacement[];
+}
+
+export interface SourceReplacement {
+  replacedById: string;
+  atRevisionId: number;
+  atTimestamp: string; // ISO 8601
+}