# qu-miteiken-shelltech/shell_arc architecture

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

- Interactive diagram: https://gitdiagram.com/qu-miteiken-shelltech/shell_arc
- Repository: https://github.com/qu-miteiken-shelltech/shell_arc

## Overview

ShellArc is a desktop client for editing and working with MSK structured data and graph-like relationships. The main workflow is user launch → client UI → domain operations such as graph, table, and data editing → MSK reads or writes over persisted fields, containers, and entities. The internal model includes typed objects, metanodes, and a hypergraph. The README is empty, so capabilities are inferred from the source tree and available references; some UI modules and integrations were not sampled, so their internal links are omitted.

Main entry points: [`src/shellarc_client/ui/main_ui.py`](https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/ui/main_ui.py) (Main workspace), [`src/shellarc_client/engine/mskio/read_msk.py`](https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/engine/mskio/read_msk.py) (MSK reader), [`src/shellarc_client/ui/table_ops/table_view.py`](https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/ui/table_ops/table_view.py) (Table view), [`src/shellarc_msk/mskob`](https://github.com/qu-miteiken-shelltech/shell_arc/tree/main/src/shellarc_msk/mskob) (MSK objects)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client UI"]
  node_launcher["Client entry<br/>[main.py]"]
  node_mainui["Main workspace<br/>[main_ui.py]"]
  node_graphui["Graph editor<br/>[graph_ops_ui.py]"]
  node_blockeditor["Expression editor"]
  node_dataui["Data operations<br/>[data_ops_ui.py]"]
  node_tableui["Table operations<br/>[table_ops_ui.py]"]
  node_tableview["Table view<br/>[table_view.py]"]
  node_tablecells["Table cells<br/>[table_cells.py]"]
  node_supportui["Other operations"]
end

subgraph group_operations["Data Operations"]
  node_tablecapture["Table capture<br/>[table_capture.py]"]
  node_mount["Mount manager"]
  node_transfer["File transfer<br/>[file_transfer.py]"]
  node_mskio["MSK reader<br/>[read_msk.py]"]
  node_creator["MSK creation<br/>[create_msk.py]"]
end

subgraph group_model["MSK Model"]
  node_hypergraph["Hypergraph<br/>[hypergraph.py]"]
  node_metanode["Metanodes<br/>[metanode.py]"]
  node_domainobjects["MSK objects"]
end

subgraph group_storage["Persistence"]
  node_collection["Container collection"]
  node_container["Containers<br/>[container_obj.py]"]
  node_entity["Entities<br/>[entity_obj.py]"]
  node_runtimecache["Memory cache<br/>[on_ram_data.py]"]
  node_pathsolver["Storage paths<br/>[path_solver.py]"]
end

node_user(("User"))

node_user -->|"launches"| node_launcher
node_launcher -->|"opens"| node_mainui
node_mainui -->|"offers"| node_graphui
node_mainui -->|"offers"| node_dataui
node_mainui -->|"offers"| node_tableui
node_mainui -->|"offers"| node_supportui
node_graphui -->|"uses"| node_blockeditor
node_graphui -->|"queries"| node_mskio
node_dataui -->|"creates"| node_creator
node_tableui -.->|"displays"| node_tableview
node_tableview -->|"renders"| node_tablecells
node_tableview -->|"captures"| node_tablecapture
node_tableview -->|"reads"| node_mskio
node_mskio -->|"scans"| node_collection
node_mskio -->|"queries"| node_hypergraph
node_mskio -->|"uses"| node_metanode
node_collection -->|"iterates"| node_container
node_collection -->|"registers"| node_runtimecache
node_container -->|"builds"| node_entity
node_entity -->|"resolves"| node_domainobjects
node_metanode -->|"wraps"| node_entity
node_creator -->|"constructs"| node_domainobjects
node_domainobjects -->|"uses"| node_runtimecache
node_domainobjects -->|"locates files"| node_pathsolver
node_mount -->|"uses"| node_pathsolver

click node_launcher "https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/main.py"
click node_mainui "https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/ui/main_ui.py"
click node_graphui "https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/ui/graph_ops/graph_ops_ui.py"
click node_blockeditor "https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/ui/graph_ops/block_expression_editor.py"
click node_dataui "https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/ui/data_ops/data_ops_ui.py"
click node_tableui "https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/ui/table_ops/table_ops_ui.py"
click node_tableview "https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/ui/table_ops/table_view.py"
click node_tablecells "https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/ui/table_ops/table_cells.py"
click node_tablecapture "https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/engine/tables/table_capture.py"
click node_supportui "https://github.com/qu-miteiken-shelltech/shell_arc/tree/main/src/shellarc_client/ui"
click node_mount "https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/engine/mount/mount_file_manager.py"
click node_transfer "https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/engine/transfer/file_transfer.py"
click node_mskio "https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/engine/mskio/read_msk.py"
click node_creator "https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/engine/mskio/create_msk.py"
click node_hypergraph "https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_msk/mskdn/hypergraph.py"
click node_metanode "https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_msk/mskdn/metanode.py"
click node_domainobjects "https://github.com/qu-miteiken-shelltech/shell_arc/tree/main/src/shellarc_msk/mskob"
click node_collection "https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_msk/mskob/containercoll_obj.py"
click node_container "https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_msk/mskob/container_obj.py"
click node_entity "https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_msk/mskob/entity_obj.py"
click node_runtimecache "https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_msk/mskut/on_ram_data.py"
click node_pathsolver "https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_msk/mskut/path_solver.py"

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_launcher,node_mainui,node_graphui,node_blockeditor,node_dataui,node_tableui,node_tableview,node_tablecells,node_supportui,node_user toneBlue
class node_tablecapture,node_mount,node_transfer,node_mskio,node_creator toneAmber
class node_hypergraph,node_metanode,node_domainobjects toneMint
class node_collection,node_container,node_entity,node_runtimecache,node_pathsolver toneRose
```

## Components

### Client UI

- [Client entry](https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/main.py): `src/shellarc_client/main.py`
- [Main workspace](https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/ui/main_ui.py): `src/shellarc_client/ui/main_ui.py`
- [Graph editor](https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/ui/graph_ops/graph_ops_ui.py): `src/shellarc_client/ui/graph_ops/graph_ops_ui.py`
- [Expression editor](https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/ui/graph_ops/block_expression_editor.py): `src/shellarc_client/ui/graph_ops/block_expression_editor.py`
- [Data operations](https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/ui/data_ops/data_ops_ui.py): `src/shellarc_client/ui/data_ops/data_ops_ui.py`
- [Table operations](https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/ui/table_ops/table_ops_ui.py): `src/shellarc_client/ui/table_ops/table_ops_ui.py`
- [Table view](https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/ui/table_ops/table_view.py): `src/shellarc_client/ui/table_ops/table_view.py`
- [Table cells](https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/ui/table_ops/table_cells.py): `src/shellarc_client/ui/table_ops/table_cells.py`
- [Other operations](https://github.com/qu-miteiken-shelltech/shell_arc/tree/main/src/shellarc_client/ui): `src/shellarc_client/ui`

### Data Operations

- [Table capture](https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/engine/tables/table_capture.py): `src/shellarc_client/engine/tables/table_capture.py`
- [Mount manager](https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/engine/mount/mount_file_manager.py): `src/shellarc_client/engine/mount/mount_file_manager.py`
- [File transfer](https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/engine/transfer/file_transfer.py): `src/shellarc_client/engine/transfer/file_transfer.py`
- [MSK reader](https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/engine/mskio/read_msk.py): `src/shellarc_client/engine/mskio/read_msk.py`
- [MSK creation](https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_client/engine/mskio/create_msk.py): `src/shellarc_client/engine/mskio/create_msk.py`

### MSK Model

- [Hypergraph](https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_msk/mskdn/hypergraph.py): `src/shellarc_msk/mskdn/hypergraph.py`
- [Metanodes](https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_msk/mskdn/metanode.py): `src/shellarc_msk/mskdn/metanode.py`
- [MSK objects](https://github.com/qu-miteiken-shelltech/shell_arc/tree/main/src/shellarc_msk/mskob): `src/shellarc_msk/mskob`

### Persistence

- [Container collection](https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_msk/mskob/containercoll_obj.py): `src/shellarc_msk/mskob/containercoll_obj.py`
- [Containers](https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_msk/mskob/container_obj.py): `src/shellarc_msk/mskob/container_obj.py`
- [Entities](https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_msk/mskob/entity_obj.py): `src/shellarc_msk/mskob/entity_obj.py`
- [Memory cache](https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_msk/mskut/on_ram_data.py): `src/shellarc_msk/mskut/on_ram_data.py`
- [Storage paths](https://github.com/qu-miteiken-shelltech/shell_arc/blob/main/src/shellarc_msk/mskut/path_solver.py): `src/shellarc_msk/mskut/path_solver.py`

### Other components

- **User**

## Connections

- User → Client entry: launches
- Client entry → Main workspace: opens (evidence: `src/shellarc_client/main.py`)
- Main workspace → Graph editor: offers (evidence: `src/shellarc_client/ui/main_ui.py`)
- Main workspace → Data operations: offers (evidence: `src/shellarc_client/ui/main_ui.py`)
- Main workspace → Table operations: offers (evidence: `src/shellarc_client/ui/main_ui.py`)
- Main workspace → Other operations: offers (evidence: `src/shellarc_client/ui/main_ui.py`)
- Graph editor → Expression editor: uses (evidence: `src/shellarc_client/ui/graph_ops/graph_ops_ui.py`)
- Graph editor → MSK reader: queries (evidence: `src/shellarc_client/ui/graph_ops/graph_ops_ui.py`)
- Data operations → MSK creation: creates (evidence: `src/shellarc_client/ui/data_ops/data_ops_ui.py`)
- Table operations → Table view: displays (evidence: `src/shellarc_client/ui/table_ops/table_ops_ui.py`)
- Table view → Table cells: renders (evidence: `src/shellarc_client/ui/table_ops/table_view.py`)
- Table view → Table capture: captures (evidence: `src/shellarc_client/ui/table_ops/table_view.py`)
- Table view → MSK reader: reads (evidence: `src/shellarc_client/ui/table_ops/table_view.py`)
- MSK reader → Container collection: scans (evidence: `src/shellarc_client/engine/mskio/read_msk.py`)
- MSK reader → Hypergraph: queries (evidence: `src/shellarc_client/engine/mskio/read_msk.py`)
- MSK reader → Metanodes: uses (evidence: `src/shellarc_client/engine/mskio/read_msk.py`)
- Container collection → Containers: iterates (evidence: `src/shellarc_msk/mskob/containercoll_obj.py`)
- Container collection → Memory cache: registers (evidence: `src/shellarc_msk/mskob/containercoll_obj.py`)
- Containers → Entities: builds (evidence: `src/shellarc_msk/mskob/container_obj.py`)
- Entities → MSK objects: resolves (evidence: `src/shellarc_msk/mskob/entity_obj.py`)
- Metanodes → Entities: wraps (evidence: `src/shellarc_msk/mskdn/metanode.py`)
- MSK creation → MSK objects: constructs (evidence: `src/shellarc_client/engine/mskio/create_msk.py`)
- MSK objects → Memory cache: uses (evidence: `src/shellarc_msk/mskob/adress_obj.py`)
- MSK objects → Storage paths: locates files (evidence: `src/shellarc_msk/mskob/adress_obj.py`)
- Mount manager → Storage paths: uses
