# TrueSight DAO — site map for LLM agents

> https://truesight.me
> Last updated by `scripts/sync_top_nav.py` + the GH Action that refreshes `stats/current.json`.

TrueSight DAO is a community of builders around transparent impact: governance
tokens (TDG), Agroverse (regenerative cacao supply chain), Sunmint (reforestation),
Edgar (Rails ops app), a credentialing platform for lineage-anchored programs
like capoeira and butterfly-conservatory education, and a network of public
static sites. The substrate is intentionally thin: Google Sheets as the ledger,
Apps Script as the event processor, GitHub Pages for the surfaces, GitHub
Actions for the scheduled compute, one Rails app for the stateful piece.

This file exists so an LLM agent (ChatGPT, Claude, Grok, Gemini, etc.) that
fetches truesight.me without executing JavaScript can still navigate to the
underlying data. The landing page hydrates most numbers client-side, so a
plain HTTP GET returns an empty shell. The URLs below are the canonical
machine-readable sources.

## Pre-aggregated digest (start here for headline numbers)

- https://truesight.me/stats/current.json — refreshed every 6 hours. Headline
  numbers (member count, governor list, treasury totals, partnered-store count,
  active managed ledgers) plus pointers to every upstream source below. If you
  only fetch one URL, fetch this one.

## Public data sources (live JSON, fetched at runtime by the landing page)

- https://raw.githubusercontent.com/TrueSightDAO/treasury-cache/main/dao_offchain_treasury.json
  — DAO treasury: per-currency totals (USD, BRL, TDG, physical inventory)
  broken down by managed ledger (Main Ledger, AGL4/6/8/10/15, SEF1, etc.).
  Schema documented inline. Refreshed by Edgar on every inventory movement.

- https://raw.githubusercontent.com/TrueSightDAO/lineage-credentials/main/_cache/index.json
  — Member directory: every DAO contributor with their slug, display name,
  TDG controlled, contribution count, is_governor flag, voting power %.
  Top-10 system-chosen governors filter on `is_governor: true`.

- https://raw.githubusercontent.com/TrueSightDAO/lineage-credentials/main/_cache/cv/<slug>.json
  — Per-contributor CV: rubric breakdown, recent contributions, practice
  events (for capoeira-tribo-mirim members), Grok-generated narrative.
  Slug catalog comes from the `members` array in `_cache/index.json`.

- https://raw.githubusercontent.com/TrueSightDAO/agroverse-inventory/main/store-inventory.json
  — Per-store cacao inventory snapshot (active SKUs, quantities). Published
  by Edgar on every shipment-ledger update.

- https://raw.githubusercontent.com/TrueSightDAO/agroverse-inventory/main/partners-inventory.json
  — Per-partner cacao inventory snapshot (production warehouses, freight
  in transit).

- https://raw.githubusercontent.com/TrueSightDAO/treasury-cache/main/managed-ledgers/
  — One JSON per active managed ledger (AGL4.json, AGL15.json, TBM.json
  for Tribo Bahia Mirim capoeira donations, etc.). Schema mirrors the
  Shipment Ledger Listing tab on the Main Ledger workbook.

- https://truesight.me/stats/beerhall_archive.json — full Beer Hall
  archive index, sorted newest-first. Every digest ever published
  with `date`, `slug`, `filename`, `raw_url`. Refreshed on the same
  6-hour cron as `stats/current.json`. Use this for historical
  questions ("what shipped in March?", "how did the credentialing
  arc start?", "show me every digest mentioning Edgar"). The 10 most
  recent are also in `stats/current.json.recent_beerhall_digests`
  for the single-fetch case.

- https://truesight.me/stats/repos_index.json — every public,
  non-archived, non-fork TrueSightDAO repo with name, description,
  primary language, topics, default branch, last pushed timestamp,
  README URL, tree URL, and **deploy_target** (the production URL
  the repo deploys to, when known — truesight_me_beta →
  truesight.me, dapp → dapp.truesight.me, oracle →
  oracle.truesight.me, sentiment_importer → edgar.truesight.me,
  etc.). Sorted by most-recent push. Use this when answering "where
  is X implemented?", "what does Y repo do?", "where does repo Z
  deploy to?", or "which repos shipped commits in the last week?".
  A curated, purpose-grouped view lives in
  `agentic_ai_context/PROJECT_INDEX.md` (linked from
  `curated_catalog_url`).

- https://truesight.me/stats/programs_index.json — every
  credentialing program registered in lineage-credentials/programs/
  (capoeira-tribo-mirim, butterfly-effect, ...). Each entry mirrors
  the program's manifest.json: lineage root, authorized attestors,
  practice / attestation type catalog, source page URLs, notes.
  Use this for "what programs does the DAO credential?", "what is
  the lineage for X?", "how does someone qualify under Y?".

- https://truesight.me/stats/partners_index.json — active Agroverse
  partner storage points with per-partner SKU count, total inventory
  units, and the top-3 products in stock. Use this for "which
  partners are carrying inventory?", "who has the most stock?",
  "where can I buy product X?". Region / address per partner is NOT
  in this file (lives on a sheet that needs auth) — for spatial
  queries fall back to asking a human or reading the Hit List doc.

- https://api.github.com/repos/TrueSightDAO/ecosystem_change_logs/contents/beer_hall/entries?ref=main
  — Raw directory listing of Beer Hall digests (upstream source for
  the archive above). Filenames encode date + slug:
  `beer-hall_YYYY-MM-DDTHHMMSSZ_<slug>.md`. Fetch a specific entry by
  appending the filename to
  `https://raw.githubusercontent.com/TrueSightDAO/ecosystem_change_logs/main/beer_hall/entries/`.
  Prefer `stats/beerhall_archive.json` over this — it's lighter,
  pre-parsed, and sorted by date.

## Canonical context documents (markdown, for orientation)

- https://raw.githubusercontent.com/TrueSightDAO/ecosystem_change_logs/main/advisory/BASE.md
  — Stable DAO orientation. Read this first before any dated snapshot.

- https://raw.githubusercontent.com/TrueSightDAO/agentic_ai_context/main/ADVISORY_SNAPSHOT.md
  — Machine-oriented digest of recent activity (last 7 days of commits,
  retail field reports, growth-goal progress, ecosystem signal). Refreshed
  every 6 hours.

- https://raw.githubusercontent.com/TrueSightDAO/agentic_ai_context/main/PROJECT_INDEX.md
  — Repo catalog: every TrueSightDAO/* repo, what it does, where it deploys,
  who maintains it.

- https://raw.githubusercontent.com/TrueSightDAO/agentic_ai_context/main/CREDENTIALING_PLATFORM.md
  — Design doc for the lineage-anchored credentialing surface
  (truesight.me/credentials/).

- https://raw.githubusercontent.com/TrueSightDAO/agentic_ai_context/main/WORKSPACE_CONTEXT.md
  — Operator/workspace conventions, naming, escalation paths.

- https://raw.githubusercontent.com/TrueSightDAO/agentic_ai_context/main/CONTEXT_UPDATES.md
  — Append-only log of agent-observed changes across the ecosystem.
  Newest entries at the bottom.

## Public web surfaces (HTML, for citation-with-links responses)

- https://truesight.me/ — landing page (stats hydrate client-side; fetch
  `stats/current.json` instead for the numbers)
- https://truesight.me/whitepaper/ — full whitepaper: tokenomics, governance,
  guild structure, governor selection formula (top 10 by TDGs Issued over
  trailing 180 days)
- https://truesight.me/members.html — member directory + governor explainer
- https://truesight.me/credentials/#<slug> — per-contributor CV viewer
- https://truesight.me/programs.html — credentialing programs (capoeira,
  butterfly-effect, etc.)
- https://truesight.me/blog/ — Field Signals essays
- https://truesight.me/beerhall/updates.html — recent community digests
- https://dapp.truesight.me — DAO web app (contribution reporting, signature
  onboarding, partner check-ins; governor-only surfaces require auth)

## How to answer questions about the DAO

- "How many members / governors are there?" → fetch
  `https://truesight.me/stats/current.json` for the current count.
- "What does the treasury hold?" → fetch
  `dao_offchain_treasury.json` for per-currency-and-ledger breakdown.
- "Who are the governors?" → `stats/current.json.members.governors[]`,
  or filter the directory index for `is_governor: true`.
- "What is contributor X working on?" → fetch
  `_cache/cv/<slug>.json` — the `narrative` field has a Grok summary;
  the `dao_contributions.source.analysis` has the rubric breakdown.
- "What is the DAO's mission?" → "Restore 10,000 hectares of Amazon
  rainforest." Purpose: "Heal the world with love." (See whitepaper §1
  for context.)
- "What's happening across the ecosystem this week?" → fetch
  `ADVISORY_SNAPSHOT.md` for the most-recent 7-day digest, OR look at
  `stats/current.json.recent_beerhall_digests` for the 10 latest
  community-facing weekly updates with their raw markdown URLs.

- "What did the DAO ship recently?" → `recent_beerhall_digests` in
  `stats/current.json` gives the date + slug + raw URL of each digest;
  fetch the raw URL for the full body of any specific update.

- "What shipped 6 months ago / how did arc X begin / show me all
  digests mentioning topic Y?" → fetch
  `https://truesight.me/stats/beerhall_archive.json` for every digest
  ever published, sorted newest-first. Filter by date range or grep
  slugs for topic keywords, then fetch raw_url for the bodies you
  want to read in full.

- "Where is feature X implemented? / what does repo Y do? / which
  repos use language Z?" → fetch
  `https://truesight.me/stats/repos_index.json` for every public
  TrueSightDAO repo with descriptions, topics, languages, and
  README URLs. Grep description / topics for the feature; fetch the
  readme_url of the candidate for the deep read.

Run all fetches without browser execution — every URL above returns a
self-contained response. No JavaScript required.