# mnemosyne-os/mnemolaw architecture

> Architecture diagram of the GitHub repository mnemosyne-os/mnemolaw, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mnemosyne-os/mnemolaw
- Repository: https://github.com/mnemosyne-os/mnemolaw

## Overview

MnemoLaw is a Mnemosyne OS cartridge for browsing official-law catalogues, importing a selected law or pack, and saving article-level memories with source context. The main workflow runs from country selection through catalogue loading and source-specific reading, then article preparation and library/vault persistence; users can also search their local library and invoke law-agent actions. README-described treaty and Malta corpora are included as shipped-data capabilities. Some subsystem wiring is documented but unsampled, so uncertain links are omitted.

Main entry points: [`src/App.tsx`](https://github.com/mnemosyne-os/mnemolaw/blob/main/src/App.tsx) (Workflow controller), [`src/locus/legalizeCatalogue.ts`](https://github.com/mnemosyne-os/mnemolaw/blob/main/src/locus/legalizeCatalogue.ts) (Country catalogues), [`src/locus/library.ts`](https://github.com/mnemosyne-os/mnemolaw/blob/main/src/locus/library.ts) (Library and vault), [`src/ui/Home.tsx`](https://github.com/mnemosyne-os/mnemolaw/blob/main/src/ui/Home.tsx) (Country home)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_home["Country home<br/>[Home.tsx]"]
  node_country_view["Country view<br/>[CountryView.tsx]"]
  node_app["Workflow controller<br/>[App.tsx]"]
  node_agent["Law agent actions<br/>[lawAgent.ts]"]
  node_i18n["Translations<br/>[strings.ts]"]
end

subgraph group_catalogues["Law discovery"]
  node_catalogue["Country catalogues"]
  node_source_catalogues["Country source lists<br/>[canadaCatalogue.ts]"]
  node_treaties["Treaty corpus"]
end

subgraph group_ingest["Text ingestion"]
  node_locus_reader["LOCUS reader<br/>[locusReader.ts]"]
  node_legalize_reader["Legalize reader<br/>[legalizeReader.ts]"]
  node_national_readers["National law readers<br/>[fedlexReader.ts]"]
  node_article_text["Article preparation<br/>[articleText.ts]"]
  node_pack_import["Pack importer<br/>[packImport.ts]"]
end

subgraph group_memory["Memory and access"]
  node_library["Library and vault<br/>[library.ts]"]
  node_local_search["Local law search<br/>[lawSearch.ts]"]
end

node_user(("Person"))
node_host{{"Mnemosyne OS"}}

node_user -->|"chooses country"| node_home
node_home -->|"opens country"| node_country_view
node_country_view -->|"starts import"| node_app
node_app -->|"loads laws"| node_catalogue
node_app -->|"loads lists"| node_source_catalogues
node_catalogue -->|"reads selected law"| node_legalize_reader
node_source_catalogues -->|"reads places"| node_locus_reader
node_app -->|"reads selected law"| node_national_readers
node_app -->|"reads selected place"| node_locus_reader
node_app -->|"imports pack"| node_pack_import
node_pack_import -->|"reads pack laws"| node_legalize_reader
node_library -->|"formats articles"| node_article_text
node_app -->|"saves import"| node_library
node_library -->|"writes memories"| node_host
node_host -->|"answers from vault"| node_user
node_user -->|"searches library"| node_local_search
node_user -->|"invokes actions"| node_agent
node_agent -->|"controls workflow"| node_app
node_app -->|"reads state"| node_host
node_catalogue -->|"offers shipped texts"| node_treaties
node_app -->|"translates interface"| node_i18n

click node_home "https://github.com/mnemosyne-os/mnemolaw/blob/main/src/ui/Home.tsx"
click node_country_view "https://github.com/mnemosyne-os/mnemolaw/blob/main/src/ui/CountryView.tsx"
click node_app "https://github.com/mnemosyne-os/mnemolaw/blob/main/src/App.tsx"
click node_agent "https://github.com/mnemosyne-os/mnemolaw/blob/main/src/ui/lawAgent.ts"
click node_catalogue "https://github.com/mnemosyne-os/mnemolaw/blob/main/src/locus/legalizeCatalogue.ts"
click node_source_catalogues "https://github.com/mnemosyne-os/mnemolaw/blob/main/src/locus/canadaCatalogue.ts"
click node_locus_reader "https://github.com/mnemosyne-os/mnemolaw/blob/main/src/locus/locusReader.ts"
click node_legalize_reader "https://github.com/mnemosyne-os/mnemolaw/blob/main/src/locus/legalizeReader.ts"
click node_national_readers "https://github.com/mnemosyne-os/mnemolaw/blob/main/src/locus/fedlexReader.ts"
click node_article_text "https://github.com/mnemosyne-os/mnemolaw/blob/main/src/locus/articleText.ts"
click node_pack_import "https://github.com/mnemosyne-os/mnemolaw/blob/main/src/locus/packImport.ts"
click node_library "https://github.com/mnemosyne-os/mnemolaw/blob/main/src/locus/library.ts"
click node_local_search "https://github.com/mnemosyne-os/mnemolaw/blob/main/src/locus/lawSearch.ts"
click node_treaties "https://github.com/mnemosyne-os/mnemolaw/blob/main/src/locus/legalizeCatalogue.ts"
click node_i18n "https://github.com/mnemosyne-os/mnemolaw/blob/main/src/i18n/strings.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_home,node_country_view,node_app,node_agent,node_i18n toneBlue
class node_catalogue,node_source_catalogues,node_treaties toneAmber
class node_locus_reader,node_legalize_reader,node_national_readers,node_article_text,node_pack_import toneMint
class node_library,node_local_search toneRose
class node_user,node_host toneIndigo
```

## Components

### User experience

- [Country home](https://github.com/mnemosyne-os/mnemolaw/blob/main/src/ui/Home.tsx): `src/ui/Home.tsx`
- [Country view](https://github.com/mnemosyne-os/mnemolaw/blob/main/src/ui/CountryView.tsx): `src/ui/CountryView.tsx`
- [Workflow controller](https://github.com/mnemosyne-os/mnemolaw/blob/main/src/App.tsx): `src/App.tsx`
- [Law agent actions](https://github.com/mnemosyne-os/mnemolaw/blob/main/src/ui/lawAgent.ts): `src/ui/lawAgent.ts`
- [Translations](https://github.com/mnemosyne-os/mnemolaw/blob/main/src/i18n/strings.ts): `src/i18n/strings.ts`

### Law discovery

- [Country catalogues](https://github.com/mnemosyne-os/mnemolaw/blob/main/src/locus/legalizeCatalogue.ts): `src/locus/legalizeCatalogue.ts`
- [Country source lists](https://github.com/mnemosyne-os/mnemolaw/blob/main/src/locus/canadaCatalogue.ts): `src/locus/canadaCatalogue.ts`
- [Treaty corpus](https://github.com/mnemosyne-os/mnemolaw/blob/main/src/locus/legalizeCatalogue.ts): `src/locus/legalizeCatalogue.ts`

### Text ingestion

- [LOCUS reader](https://github.com/mnemosyne-os/mnemolaw/blob/main/src/locus/locusReader.ts): `src/locus/locusReader.ts`
- [Legalize reader](https://github.com/mnemosyne-os/mnemolaw/blob/main/src/locus/legalizeReader.ts): `src/locus/legalizeReader.ts`
- [National law readers](https://github.com/mnemosyne-os/mnemolaw/blob/main/src/locus/fedlexReader.ts): `src/locus/fedlexReader.ts`
- [Article preparation](https://github.com/mnemosyne-os/mnemolaw/blob/main/src/locus/articleText.ts): `src/locus/articleText.ts`
- [Pack importer](https://github.com/mnemosyne-os/mnemolaw/blob/main/src/locus/packImport.ts): `src/locus/packImport.ts`

### Memory and access

- [Library and vault](https://github.com/mnemosyne-os/mnemolaw/blob/main/src/locus/library.ts): `src/locus/library.ts`
- [Local law search](https://github.com/mnemosyne-os/mnemolaw/blob/main/src/locus/lawSearch.ts): `src/locus/lawSearch.ts`

### Other components

- **Person**
- **Mnemosyne OS**

## Connections

- Person → Country home: chooses country
- Country home → Country view: opens country (evidence: `src/ui/Home.tsx`)
- Country view → Workflow controller: starts import (evidence: `src/ui/CountryView.tsx`)
- Workflow controller → Country catalogues: loads laws (evidence: `src/App.tsx`)
- Workflow controller → Country source lists: loads lists (evidence: `src/App.tsx`)
- Country catalogues → Legalize reader: reads selected law (evidence: `src/locus/legalizeCatalogue.ts`)
- Country source lists → LOCUS reader: reads places (evidence: `src/locus/canadaCatalogue.ts`)
- Workflow controller → National law readers: reads selected law (evidence: `src/App.tsx`)
- Workflow controller → LOCUS reader: reads selected place (evidence: `src/App.tsx`)
- Workflow controller → Pack importer: imports pack (evidence: `src/App.tsx`)
- Pack importer → Legalize reader: reads pack laws (evidence: `src/locus/packImport.ts`)
- Library and vault → Article preparation: formats articles (evidence: `src/locus/library.ts`)
- Workflow controller → Library and vault: saves import (evidence: `src/App.tsx`)
- Library and vault → Mnemosyne OS: writes memories
- Mnemosyne OS → Person: answers from vault
- Person → Local law search: searches library
- Person → Law agent actions: invokes actions (evidence: `src/ui/lawAgent.ts`)
- Law agent actions → Workflow controller: controls workflow (evidence: `src/ui/lawAgent.ts`)
- Workflow controller → Mnemosyne OS: reads state (evidence: `src/App.tsx`)
- Country catalogues → Treaty corpus: offers shipped texts (evidence: `src/locus/legalizeCatalogue.ts`)
- Workflow controller → Translations: translates interface (evidence: `src/App.tsx`)
