# shaswata09/jojo architecture

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

- Interactive diagram: https://gitdiagram.com/shaswata09/jojo
- Repository: https://github.com/shaswata09/jojo

## Overview

jojo is a local-first job-search tracker with optional agentic assistance. The main workflow is to record and organise opportunities, track applications and deadlines, then use the assistant or job-board pipelines to answer questions or propose work for approval. The graph covers the web and mobile clients, domain model, agent/tool layers, local persistence, and documented optional integrations. Relationships involving unsampled modules are included only where the README or source index supports them; several integrations are documented capabilities rather than inspected call paths.

Main entry points: [`service/kg/agent/loop.ts`](https://github.com/shaswata09/jojo/blob/main/service/kg/agent/loop.ts) (Assistant conversation), [`web/src/App.tsx`](https://github.com/shaswata09/jojo/blob/main/web/src/App.tsx) (Web app), [`mobile/App.tsx`](https://github.com/shaswata09/jojo/blob/main/mobile/App.tsx) (Mobile app), [`service/kg/react/use-pipelines.ts`](https://github.com/shaswata09/jojo/blob/main/service/kg/react/use-pipelines.ts) (Job pipelines)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User clients"]
  node_webapp["Web app<br/>[App.tsx]"]
  node_mobileapp["Mobile app<br/>[App.tsx]"]
end

subgraph group_domain["Job-search domain"]
  node_applications["Applications<br/>[board.ts]"]
  node_domainmodel["Domain records<br/>[model.ts]"]
  node_capture["Posting capture<br/>[capture.ts]"]
  node_dates["Dates and deadlines<br/>[dates.ts]"]
end

subgraph group_agents["Assistant and agents"]
  node_assistant["Assistant conversation<br/>[loop.ts]"]
  node_agentreads["Agent read queries<br/>[queries.ts]"]
  node_toolcatalog["Agent tool catalog<br/>[catalog.ts]"]
  node_agentexecute["Tool execution<br/>[execute.ts]"]
  node_toolregistry["Domain tools<br/>[index.ts]"]
  node_pipelines["Job pipelines<br/>[use-pipelines.ts]"]
  node_proposals["Human-approved proposals<br/>[pipeline.ts]"]
end

subgraph group_storage["Local records"]
  node_repository["Graph repository<br/>[repository.ts]"]
  node_graphsnapshot["Graph snapshot<br/>[snapshot.ts]"]
  node_storageengine[("Storage drivers")]
end

subgraph group_integrations["Optional capabilities"]
  node_browserextension["Browser extension<br/>[routing.js]"]
end

node_user(("Job seeker"))
node_modelprovider{{"Configured model"}}
node_documentreader{{"Document reader"}}
node_calendar{{"Device calendar"}}
node_otherdevice(("Other device"))

node_user -->|"uses"| node_webapp
node_user -->|"uses"| node_mobileapp
node_webapp -.->|"tracks applications"| node_applications
node_mobileapp -.->|"tracks applications"| node_applications
node_applications -->|"uses records"| node_domainmodel
node_capture -->|"creates records"| node_domainmodel
node_dates -->|"uses dates"| node_domainmodel
node_webapp -.->|"offers assistant"| node_assistant
node_mobileapp -.->|"offers assistant"| node_assistant
node_assistant -.->|"sends prompts"| node_modelprovider
node_assistant -->|"queries records"| node_agentreads
node_assistant -->|"requests tools"| node_toolcatalog
node_toolcatalog -->|"lists tools"| node_toolregistry
node_agentexecute -->|"dispatches tools"| node_toolregistry
node_webapp -.->|"offers pipelines"| node_pipelines
node_mobileapp -.->|"offers pipelines"| node_pipelines
node_pipelines -->|"runs agent loop"| node_assistant
node_pipelines -->|"raises suggestions"| node_proposals
node_proposals -->|"awaits approval"| node_user
node_repository -->|"maintains graph"| node_graphsnapshot
node_repository -->|"uses drivers"| node_storageengine
node_webapp -.->|"stores records locally"| node_repository
node_mobileapp -.->|"stores records locally"| node_repository
node_user -->|"captures postings"| node_browserextension
node_browserextension -.->|"saves postings"| node_capture
node_user -->|"configures reader"| node_documentreader
node_dates -->|"exports calendar"| node_calendar
node_user -->|"transfers records"| node_otherdevice

click node_webapp "https://github.com/shaswata09/jojo/blob/main/web/src/App.tsx"
click node_mobileapp "https://github.com/shaswata09/jojo/blob/main/mobile/App.tsx"
click node_applications "https://github.com/shaswata09/jojo/blob/main/service/kg/core/board.ts"
click node_domainmodel "https://github.com/shaswata09/jojo/blob/main/service/kg/core/model.ts"
click node_capture "https://github.com/shaswata09/jojo/blob/main/service/kg/core/capture.ts"
click node_dates "https://github.com/shaswata09/jojo/blob/main/service/kg/core/dates.ts"
click node_assistant "https://github.com/shaswata09/jojo/blob/main/service/kg/agent/loop.ts"
click node_agentreads "https://github.com/shaswata09/jojo/blob/main/service/kg/agent/queries.ts"
click node_toolcatalog "https://github.com/shaswata09/jojo/blob/main/service/kg/agent/catalog.ts"
click node_agentexecute "https://github.com/shaswata09/jojo/blob/main/service/kg/agent/execute.ts"
click node_toolregistry "https://github.com/shaswata09/jojo/blob/main/service/kg/tools/index.ts"
click node_pipelines "https://github.com/shaswata09/jojo/blob/main/service/kg/react/use-pipelines.ts"
click node_proposals "https://github.com/shaswata09/jojo/blob/main/service/kg/tools/pipeline.ts"
click node_repository "https://github.com/shaswata09/jojo/blob/main/service/kg/repo/repository.ts"
click node_graphsnapshot "https://github.com/shaswata09/jojo/blob/main/service/kg/core/snapshot.ts"
click node_storageengine "https://github.com/shaswata09/jojo/tree/main/service/kg/storage"
click node_browserextension "https://github.com/shaswata09/jojo/blob/main/web/extension/worker/routing.js"

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_webapp,node_mobileapp toneBlue
class node_applications,node_domainmodel,node_capture,node_dates toneAmber
class node_assistant,node_agentreads,node_toolcatalog,node_agentexecute,node_toolregistry,node_pipelines,node_proposals toneMint
class node_repository,node_graphsnapshot,node_storageengine toneRose
class node_browserextension,node_user,node_modelprovider,node_documentreader,node_calendar,node_otherdevice toneIndigo
```

## Components

### User clients

- [Web app](https://github.com/shaswata09/jojo/blob/main/web/src/App.tsx): `web/src/App.tsx`
- [Mobile app](https://github.com/shaswata09/jojo/blob/main/mobile/App.tsx): `mobile/App.tsx`

### Job-search domain

- [Applications](https://github.com/shaswata09/jojo/blob/main/service/kg/core/board.ts): `service/kg/core/board.ts`
- [Domain records](https://github.com/shaswata09/jojo/blob/main/service/kg/core/model.ts): `service/kg/core/model.ts`
- [Posting capture](https://github.com/shaswata09/jojo/blob/main/service/kg/core/capture.ts): `service/kg/core/capture.ts`
- [Dates and deadlines](https://github.com/shaswata09/jojo/blob/main/service/kg/core/dates.ts): `service/kg/core/dates.ts`

### Assistant and agents

- [Assistant conversation](https://github.com/shaswata09/jojo/blob/main/service/kg/agent/loop.ts): `service/kg/agent/loop.ts`
- [Agent read queries](https://github.com/shaswata09/jojo/blob/main/service/kg/agent/queries.ts): `service/kg/agent/queries.ts`
- [Agent tool catalog](https://github.com/shaswata09/jojo/blob/main/service/kg/agent/catalog.ts): `service/kg/agent/catalog.ts`
- [Tool execution](https://github.com/shaswata09/jojo/blob/main/service/kg/agent/execute.ts): `service/kg/agent/execute.ts`
- [Domain tools](https://github.com/shaswata09/jojo/blob/main/service/kg/tools/index.ts): `service/kg/tools/index.ts`
- [Job pipelines](https://github.com/shaswata09/jojo/blob/main/service/kg/react/use-pipelines.ts): `service/kg/react/use-pipelines.ts`
- [Human-approved proposals](https://github.com/shaswata09/jojo/blob/main/service/kg/tools/pipeline.ts): `service/kg/tools/pipeline.ts`

### Local records

- [Graph repository](https://github.com/shaswata09/jojo/blob/main/service/kg/repo/repository.ts): `service/kg/repo/repository.ts`
- [Graph snapshot](https://github.com/shaswata09/jojo/blob/main/service/kg/core/snapshot.ts): `service/kg/core/snapshot.ts`
- [Storage drivers](https://github.com/shaswata09/jojo/tree/main/service/kg/storage): `service/kg/storage`

### Optional capabilities

- [Browser extension](https://github.com/shaswata09/jojo/blob/main/web/extension/worker/routing.js): `web/extension/worker/routing.js`

### Other components

- **Job seeker**
- **Configured model**
- **Document reader**
- **Device calendar**
- **Other device**

## Connections

- Job seeker → Web app: uses
- Job seeker → Mobile app: uses
- Web app → Applications: tracks applications
- Mobile app → Applications: tracks applications
- Applications → Domain records: uses records (evidence: `service/kg/core/board.ts`)
- Posting capture → Domain records: creates records (evidence: `service/kg/core/capture.ts`)
- Dates and deadlines → Domain records: uses dates (evidence: `service/kg/core/dates.ts`)
- Web app → Assistant conversation: offers assistant
- Mobile app → Assistant conversation: offers assistant
- Assistant conversation → Configured model: sends prompts
- Assistant conversation → Agent read queries: queries records (evidence: `service/kg/agent/loop.ts`)
- Assistant conversation → Agent tool catalog: requests tools (evidence: `service/kg/agent/execute.ts`)
- Agent tool catalog → Domain tools: lists tools (evidence: `service/kg/agent/catalog.ts`)
- Tool execution → Domain tools: dispatches tools (evidence: `service/kg/agent/execute.ts`)
- Web app → Job pipelines: offers pipelines
- Mobile app → Job pipelines: offers pipelines
- Job pipelines → Assistant conversation: runs agent loop (evidence: `service/kg/react/use-pipelines.ts`)
- Job pipelines → Human-approved proposals: raises suggestions
- Human-approved proposals → Job seeker: awaits approval (evidence: `service/kg/tools/pipeline.ts`)
- Graph repository → Graph snapshot: maintains graph (evidence: `service/kg/repo/repository.ts`)
- Graph repository → Storage drivers: uses drivers (evidence: `service/kg/repo/repository.ts`)
- Web app → Graph repository: stores records locally
- Mobile app → Graph repository: stores records locally
- Job seeker → Browser extension: captures postings
- Browser extension → Posting capture: saves postings
- Job seeker → Document reader: configures reader
- Dates and deadlines → Device calendar: exports calendar
- Job seeker → Other device: transfers records
