Skip to content

Latest commit

 

History

356 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Binary-Origami Figurator (BOFIG)

Infrastructure for pragmatic epistemology. Combining i-docs navigation, PROMPT epistemological scoring, and boundary objects theory. An evidence graph for investigative journalism and related disciplines.

Status: Phase 1 (PoC) Version: v1.0.0

Tip

New here? Start with the Wiki. The Binary-Origami Wiki explains everything in metaphors, diagrams, and plain language.

This isn’t just a database. It’s infrastructure for folding and unfolding evidence—so everyone can see the shape that fits their needs.

1. Why “Binary-Origami”?

Binary: Evidence is stored as clear, connected data (supports/contradicts, 0–100 scores). Origami: Evidence can be “folded” into different forms for different audiences. Figuration: The rules for folding/unfolding are transparent and reversible.

2. Core Concepts

Concept Description Learn More

i-docs Navigation

“Choose Your Own Adventure” for evidence

Wiki

PROMPT Scoring

“Nutrition labels” for trustworthiness

Wiki

Boundary Objects

“Shared maps” with multiple routes

Wiki

Evidence Graphs

The “skeleton” beneath the origami

Wiki

3. Vision

We didn’t fall from Truth to Post-Truth; we evolved to complex epistemology without building infrastructure. BOFIG is that infrastructure.

4. Quick Start

4.1. Prerequisites

  • Elixir 1.18+

  • Erlang/OTP 27+

  • Phoenix 1.8+

  • Podman & podman-compose

  • just task runner

4.2. 1. Clone Repository

git clone https://github.com/Hyperpolymath/bofig.git
cd bofig

4.3. 2. Start Databases

podman-compose up -d

Verify LithoglyphDB: http://localhost:8529 (root/dev)

4.4. 3. Full Setup

just setup

Or manually:

mix deps.get
mix ecto.create
mix run -e "EvidenceGraph.Lithoglyph.setup_database()"
mix run priv/repo/seeds.exs

4.5. 4. Start Phoenix Server

just dev

Visit:

5. GraphQL API Examples

5.1. Query: Get All Claims

query {
  claims(investigationId: "uk_inflation_2023") {
    id
    text
    claimType
    confidenceLevel
    promptScores {
      provenance
      replicability
      objective
      methodology
      publication
      transparency
      overall
    }
    supportingEvidence {
      evidence { title evidenceType }
      weight
      confidence
    }
  }
}

5.2. Query: Evidence Chain

query {
  evidenceChain(claimId: "claim_1", maxDepth: 3) {
    rootClaim { text }
    nodes {
      ... on Claim { id text }
      ... on Evidence { id title }
    }
    edges { relationshipType weight confidence }
    maxDepth
  }
}

5.3. Mutation: Create Claim

mutation {
  createClaim(input: {
    investigationId: "uk_inflation_2023"
    text: "Inflation disproportionately affected renters"
    claimType: SUPPORTING
    confidenceLevel: 0.85
    promptScores: {
      provenance: 70
      replicability: 65
      objective: 75
      methodology: 70
      publication: 65
      transparency: 70
    }
  }) {
    id
    text
    promptScores { overall }
  }
}

5.4. Mutation: Import from Zotero

mutation {
  importFromZotero(
    investigationId: "uk_inflation_2023"
    zoteroJson: {
      key: "ABC123"
      itemType: "journalArticle"
      title: "New Economic Study"
      url: "https://doi.org/10.1111/example"
      creators: [{name: "Smith, J."}]
      tags: [{tag: "economics"}]
    }
  ) {
    id
    title
    zoteroKey
  }
}

6. UK Inflation 2023 Test Dataset

Seed data includes:

  • 7 Claims

  • 10 Evidence items

  • 10 Relationships

  • 3 Navigation Paths (Researcher, Policymaker, Affected Person)

6.1. PROMPT Score Examples

Evidence Prov Repl Obj Meth Pub Trans Overall

ONS CPI Data

100

100

95

95

100

95

97.5

Academic Study

85

80

75

85

90

75

81.8

Think Tank Report

75

70

65

75

80

70

72.3

Expert Interview

85

45

60

50

40

75

59.0

7. Development

7.1. Run Tests

mix test

7.2. Interactive Shell

iex -S mix phx.server

8. Deployment (Phase 2)

  • Hetzner Cloud

  • LithoglyphDB

  • Nginx reverse proxy

  • GitHub Actions CI/CD

9. Philosophy

This isn’t just a database. It’s infrastructure for coordinating without consensus.

Every design choice asks:

  1. Does this support multiple audience perspectives?

  2. Does this make epistemology measurable?

  3. Does this enable navigation over narration?

10. License

MPL-2.0 (code) & CC-SA-BY-4.0 (documents)

Releases

Sponsor this project

Packages

Used by

Contributors

Languages