# MirrorArc > Explore MirrorArc, an open-source AI documentation and knowledge graph toolkit, through a public Ontario electricity workspace connecting sources, Markdown mirrors, and agent context. MirrorArc is a local-first, governed documentation layer for humans and AI agents. This hosted surface contains only the provenance-documented public Ontario electricity example. ## Start here - [Interactive portal](https://cz1993.github.io/MirrorArc/): relationship map, document view, metadata, and context packs - [Project overview](https://cz1993.github.io/MirrorArc/project/): purpose, differentiators, installation, and source repository - [Beginner tutorial](https://cz1993.github.io/MirrorArc/INDEX.md): raw Markdown entry point - [Crawlable documentation index](https://cz1993.github.io/MirrorArc/documents/): semantic HTML pages - [Agent-readable catalog](https://cz1993.github.io/MirrorArc/catalog.json): document metadata and canonical URLs - [Source repository](https://github.com/cz1993/MirrorArc): code, templates, tests, and provenance ## Public documents - [Start here — Ontario Electricity Evidence Workspace](https://cz1993.github.io/MirrorArc/documents/index/index.md): Start here — Ontario Electricity Evidence Workspace Welcome. You do not need to know MirrorArc, energy data, or knowledge graphs to use this example. This… - [Demo walkthrough](https://cz1993.github.io/MirrorArc/documents/10-context-demo-walkthrough/index.md): Demo walkthrough 1. Open CATALOG.html and select an authored DOCX or XLSX source. 2. Follow the explicit arrow to its generated mirror under mirrors/ . 3… - [Evidence layers and trust](https://cz1993.github.io/MirrorArc/documents/10-context-evidence-layers-and-trust/index.md): Evidence layers and trust 1. Original source files and authoritative URLs are the evidence boundary. 2. Generated mirrors make opaque artifacts searchable… - [Ontario Electricity Evidence Workspace overview](https://cz1993.github.io/MirrorArc/documents/10-context-ontario-electricity-evidence-workspace-overview/index.md): Ontario Electricity Evidence Workspace overview The workspace answers historical Ontario electricity questions from traceable evidence. Public OGL CSVs are… - [Ontario electricity glossary](https://cz1993.github.io/MirrorArc/documents/10-context-ontario-electricity-glossary/index.md): Ontario electricity glossary Term Working meaning in this example Demand Electricity consumed in Ontario at the measurement boundary described by the source… - [Questions this workspace answers](https://cz1993.github.io/MirrorArc/documents/10-context-questions-this-workspace-answers/index.md): Questions this workspace answers How did annual Ontario electricity demand change from 2022 to 2023? Which month recorded the widest peak to minimum demand… - [IESO Data Directory](https://cz1993.github.io/MirrorArc/documents/20-sources-ieso-data-directory/index.md): IESO Data Directory Metadata only pointer to the IESO data directory. This note records discoverability without copying source bodies. Before any downstream… - [IESO Year in Review](https://cz1993.github.io/MirrorArc/documents/20-sources-ieso-year-in-review/index.md): IESO Year in Review Metadata only pointer for independent annual context checks. The note deliberately contains no copied figures. Analysts should compare… - [IESO zonal map reference](https://cz1993.github.io/MirrorArc/documents/20-sources-ieso-zonal-map-reference/index.md): IESO zonal map reference Metadata only navigation node for transmission and zonal context. No map image or underlying data is copied. A future licensed… - [OEB open data directory](https://cz1993.github.io/MirrorArc/documents/20-sources-oeb-open-data-directory/index.md): OEB open data directory Metadata only reference to the Ontario Energy Board's open data landing page. It is a candidate source family for future rate… - [Ontario Energy Report 2023 supporting data](https://cz1993.github.io/MirrorArc/documents/20-sources-ontario-energy-report-2023-supporting-data/index.md): Ontario Energy Report 2023 supporting data The example commits a focused subset of the 2023 supporting data ZIP: annual demand, monthly demand ranges, peaks… - [Ontario Energy Report 2023 supporting-data subset](https://cz1993.github.io/MirrorArc/documents/20-sources-open-data-ontario-energy-report-2023-readme/index.md): Ontario Energy Report 2023 supporting data subset These selected files come from the Ontario Data Catalogue resource "Ontario Energy Report Supporting Data"… - [Public source register](https://cz1993.github.io/MirrorArc/documents/20-sources-public-source-register/index.md): Public source register Source family Local treatment Redistribution status Ontario Energy Report 2023 supporting data Selected CSV and English note files… - [ontario-electricity-evidence-pipeline](https://cz1993.github.io/MirrorArc/documents/20-sources-repos-ontario-electricity-evidence-pipeline/index.md): [!info] GitHub repo mirror — auto generated Source: local/ontario electricity evidence pipeline (local: fixtures/repos/ontario electricity evidence… - [Source freshness policy](https://cz1993.github.io/MirrorArc/documents/20-sources-source-freshness-policy/index.md): Source freshness policy Committed source fixtures are versioned snapshots, not live feeds. Each source note records a URL, license, version or coverage… - [Annual demand contract](https://cz1993.github.io/MirrorArc/documents/30-data-contracts-annual-demand-contract/index.md): Annual demand contract Field Type Required Meaning Year integer yes Calendar year. Total TWh decimal yes Annual Ontario energy demand in terawatt hours… - [Evidence API contract](https://cz1993.github.io/MirrorArc/documents/30-data-contracts-evidence-api-contract/index.md): Evidence API contract This synthetic interface models an agent facing response, not a live service. Every item includes id , title , type , status , source… - [Generation output contract](https://cz1993.github.io/MirrorArc/documents/30-data-contracts-generation-output-contract/index.md): Generation output contract Monthly grid connected output is grouped into nuclear, gas, hydro, wind, solar, and biofuel. The GWh table is additive; the… - [Intertie flow contract](https://cz1993.github.io/MirrorArc/documents/30-data-contracts-intertie-flow-contract/index.md): Intertie flow contract Import and export tables contain one quantity row and one percentage row per quarter across five neighbouring regions plus a total… - [Monthly demand range contract](https://cz1993.github.io/MirrorArc/documents/30-data-contracts-monthly-demand-range-contract/index.md): Monthly demand range contract Each record has Year , Month , Peak MW , and Minimum MW . Comma formatted values are parsed as integers. A valid row has a… - [Artifact mirroring pipeline](https://cz1993.github.io/MirrorArc/documents/40-pipelines-artifact-mirroring-pipeline/index.md): Artifact mirroring pipeline mirrorarc plan inventories supported Office/PDF sources and the configured local code fixture. mirrorarc sync writes derived… - [Evidence lineage map](https://cz1993.github.io/MirrorArc/documents/40-pipelines-evidence-lineage-map/index.md): Evidence lineage map Original Generated mirror Curated consumers 50 analysis/workbooks/historical demand profile.xlsx mirrors/50… - [Normalization pipeline](https://cz1993.github.io/MirrorArc/documents/40-pipelines-normalization-pipeline/index.md): Normalization pipeline The clean room code fixture removes thousands separators, distinguishes quantities from percentages, ignores blank terminal rows, and… - [Public data ingestion pipeline](https://cz1993.github.io/MirrorArc/documents/40-pipelines-public-data-ingestion-pipeline/index.md): Public data ingestion pipeline 1. Resolve the Ontario Data Catalogue resource metadata and license. 2. Download the versioned ZIP to a disposable staging… - [Quality gate pipeline](https://cz1993.github.io/MirrorArc/documents/40-pipelines-quality-gate-pipeline/index.md): Quality gate pipeline Historical data gates assert required fields, positive values, valid peak/minimum ordering, expected fuel categories, and agreement… - [2023 annual demand finding](https://cz1993.github.io/MirrorArc/documents/50-analysis-2023-annual-demand-finding/index.md): 2023 annual demand finding The included source reports 137.6 TWh in 2022 and 137.1 TWh in 2023, a decline of 0.5 TWh. This is a descriptive source backed… - [2023 generation mix finding](https://cz1993.github.io/MirrorArc/documents/50-analysis-2023-generation-mix-finding/index.md): 2023 generation mix finding The source's annual averages place nuclear first at 53.27%, hydro second at 25.13%, and gas third at 12.65% of grid connected… - [2023 intertie flow finding](https://cz1993.github.io/MirrorArc/documents/50-analysis-2023-intertie-flow-finding/index.md): 2023 intertie flow finding The included quarterly tables show exports above imports in every quarter. Quebec dominates the import mix, while Michigan and New… - [2023 peak demand finding](https://cz1993.github.io/MirrorArc/documents/50-analysis-2023-peak-demand-finding/index.md): 2023 peak demand finding The included monthly source reports September as the 2023 maximum peak at 23,713 MW and a monthly minimum of 11,402 MW, producing… - [Cross-source evidence synthesis](https://cz1993.github.io/MirrorArc/documents/50-analysis-cross-source-evidence-synthesis/index.md): Cross source evidence synthesis Demand was broadly stable year over year, while the system still experienced a pronounced September peak. Nuclear and hydro… - [Output relationship map](https://cz1993.github.io/MirrorArc/documents/70-outputs-output-relationship-map/index.md): Output relationship map Output Main evidence Decision boundary Historical demand workbook OGL annual and monthly demand CSVs Historical description only… - [Stakeholder brief index](https://cz1993.github.io/MirrorArc/documents/70-outputs-stakeholder-brief-index/index.md): Stakeholder brief index The output index connects the historical analysis workbooks, public source register, evidence controls, and operational review… - [Decision - use a clean-room public corpus](https://cz1993.github.io/MirrorArc/documents/80-governance-decision-use-a-clean-room-public-corpus/index.md): Decision use a clean room public corpus Decision: build the flagship demo from OGL sources, independently authored artifacts, and a small synthetic… - [Evidence controls](https://cz1993.github.io/MirrorArc/documents/80-governance-evidence-controls/index.md): Evidence controls Exact external binary/CSV paths appear in examples/DATA PROVENANCE.md . CI scans committed and generated mirror text for high risk… - [Evidence workspace risk register](https://cz1993.github.io/MirrorArc/documents/80-governance-evidence-workspace-risk-register/index.md): Evidence workspace risk register Risk Trigger Control Source license drift Terms or dataset metadata changes Recheck provenance before refresh Stale source… - [IESO reference-only boundary](https://cz1993.github.io/MirrorArc/documents/80-governance-ieso-reference-only-boundary/index.md): IESO reference only boundary The public example stores IESO page titles, URLs, source categories, and original MirrorArc descriptions. It does not commit… - [Open data license register](https://cz1993.github.io/MirrorArc/documents/80-governance-open-data-license-register/index.md): Open data license register Source Treatment License status Ontario Energy Report 2023 supporting data Selected source files committed with attribution Open… - [Retention and refresh policy](https://cz1993.github.io/MirrorArc/documents/80-governance-retention-and-refresh-policy/index.md): Retention and refresh policy Versioned public fixtures remain in Git while they support reproducible demonstrations. A refresh must add or replace a clearly… - [Data quality investigation runbook](https://cz1993.github.io/MirrorArc/documents/90-operations-data-quality-investigation-runbook/index.md): Data quality investigation runbook 1. Stop dependent publication while preserving the failing source and derived evidence. 2. Identify the contract and exact… - [Example release checklist](https://cz1993.github.io/MirrorArc/documents/90-operations-example-release-checklist/index.md): Example release checklist [ ] Provenance lists every committed CSV, DOCX, XLSX, PPTX, and PDF. [ ] IESO nodes remain metadata only. [ ] Code fixture tests… - [Freshness dashboard specification](https://cz1993.github.io/MirrorArc/documents/90-operations-freshness-dashboard-specification/index.md): Freshness dashboard specification The view groups sources by committed snapshot, reference only URL, generated mirror, and repo fixture. It shows last… - [Illustrative stale-source incident](https://cz1993.github.io/MirrorArc/documents/90-operations-illustrative-stale-source-incident/index.md): Illustrative stale source incident Synthetic scenario: a catalogue URL changed while a cached CSV remained readable. The workspace kept the prior snapshot… - [Refresh public sources runbook](https://cz1993.github.io/MirrorArc/documents/90-operations-refresh-public-sources-runbook/index.md): Refresh public sources runbook 1. Resolve current catalogue metadata, resource URL, license, and modification timestamp. 2. Download to a disposable… - [Source outage runbook](https://cz1993.github.io/MirrorArc/documents/90-operations-source-outage-runbook/index.md): Source outage runbook When a public URL is unavailable, retain the last verified version and mark its freshness state. Do not substitute an unofficial mirror… - [historical demand profile](https://cz1993.github.io/MirrorArc/documents/mirrors-50-analysis-workbooks-historical-demand-profile/index.md): [!info] Source mirrored document — auto generated Original: historical demand profile.xlsx · edit the original , never this mirror. This mirror is machine… - [data quality incident review](https://cz1993.github.io/MirrorArc/documents/mirrors-90-operations-briefs-data-quality-incident-review/index.md): [!info] Source mirrored document — auto generated Original: data quality incident review.docx · edit the original , never this mirror. This mirror is machine… - [AGENTS](https://cz1993.github.io/MirrorArc/documents/agents/index.md): AGENTS.md MirrorArc Vault Entrypoint Before changing this vault, read and follow the shared agent rules. The contract in meta/profile.yml is authoritative… - [CLAUDE](https://cz1993.github.io/MirrorArc/documents/claude/index.md): CLAUDE.md MirrorArc Vault Entrypoint This vault uses the data product profile ( 0.1.0 ). Before changing vault content, read and follow the shared agent… - [log](https://cz1993.github.io/MirrorArc/documents/log/index.md): Maintenance log Append only; newest at the bottom. One greppable line per change: grep "^## \[" log.md tail . Format ## [YYYY MM DD]