# amardamoney/lisa-extension architecture

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

- Interactive diagram: https://gitdiagram.com/amardamoney/lisa-extension
- Repository: https://github.com/amardamoney/lisa-extension

## Overview

LISA Core is a Chrome extension that captures AI conversations and exports them as portable, compressed LISA JSON or verbatim LISA-V. The main workflow runs from an AI chat page through platform-specific capture and the extension’s background processing to an export initiated in the popup or floating button. Other documented capabilities include checkpoint and snapshot history, selection export, and premium subscription management. The service worker and several major modules are only partially excerpted; edges relying on documented behavior cite the README, and uncertain internal wiring is omitted.

Main entry points: [`src/background/service-worker.js`](https://github.com/amardamoney/lisa-extension/blob/main/src/background/service-worker.js) (Background Engine), [`eval/run.js`](https://github.com/amardamoney/lisa-extension/blob/main/eval/run.js) (Eval Harness), [`src/content`](https://github.com/amardamoney/lisa-extension/tree/main/src/content) (Platform Parsers), [`src/content/lisa-v-parser.js`](https://github.com/amardamoney/lisa-extension/blob/main/src/content/lisa-v-parser.js) (LISA-V Export)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Conversation Capture"]
  node_platform_capture["Platform Parsers"]
  node_api_capture["API Capture"]
  node_progressive_capture["Progressive Capture"]
end

subgraph group_processing["Memory Processing"]
  node_lisa_v["LISA-V Export<br/>[lisa-v-parser.js]"]
  node_background["Background Engine<br/>[service-worker.js]"]
  node_semantic_analysis["Semantic Analysis"]
  node_checkpoint_detection["Checkpoint Detection"]
  node_export_builders["Export Builders<br/>[export-builders.js]"]
  node_snapshot_history[("Snapshot History<br/>[snapshot-shim.js]")]
end

subgraph group_extension["Extension Experience"]
  node_floating_save["Floating Save"]
  node_popup["Extension Popup<br/>[popup.js]"]
end

subgraph group_billing["Premium Billing"]
  node_stripe_manager["Subscription Manager"]
  node_stripe_client["Stripe Client<br/>[stripe-client.js]"]
  node_billing_server["Billing Server<br/>[index.js]"]
end

subgraph group_evaluation["Compression Evaluation"]
  node_eval_runner["Eval Harness<br/>[run.js]"]
  node_eval_loader["Extension Loader<br/>[load-lisa.js]"]
  node_token_count["Token Counter<br/>[count.js]"]
  node_quality_judge["Quality Judge<br/>[judge.js]"]
end

node_user(("Extension User"))
node_ai_platform["AI Chat Pages"]
node_stripe["Stripe"]

node_ai_platform -->|"provides chat"| node_platform_capture
node_platform_capture -.->|"captures conversation"| node_background
node_api_capture -.->|"captures conversation"| node_background
node_user -->|"starts export"| node_popup
node_popup -.->|"requests export"| node_background
node_background -.->|"enriches data"| node_semantic_analysis
node_background -->|"detects checkpoints"| node_checkpoint_detection
node_background -->|"builds export"| node_export_builders
node_background -->|"uses snapshot schema"| node_snapshot_history
node_user -->|"chooses save"| node_floating_save
node_floating_save -->|"requests LISA-V"| node_lisa_v
node_lisa_v -->|"captures verbatim"| node_ai_platform
node_user -->|"selects text"| node_platform_capture
node_stripe_manager -->|"manages payments"| node_stripe_client
node_stripe_client -->|"calls billing API"| node_billing_server
node_billing_server -->|"creates sessions"| node_stripe
node_eval_runner -->|"loads extension"| node_eval_loader
node_eval_runner -->|"counts tokens"| node_token_count
node_eval_runner -->|"evaluates quality"| node_quality_judge
node_eval_loader -->|"uses builders"| node_export_builders

click node_platform_capture "https://github.com/amardamoney/lisa-extension/tree/main/src/content"
click node_api_capture "https://github.com/amardamoney/lisa-extension/tree/main/src/content"
click node_progressive_capture "https://github.com/amardamoney/lisa-extension/blob/main/src/content/lisa-progressive.js"
click node_floating_save "https://github.com/amardamoney/lisa-extension/blob/main/src/content/lisa-floating-button.js"
click node_lisa_v "https://github.com/amardamoney/lisa-extension/blob/main/src/content/lisa-v-parser.js"
click node_background "https://github.com/amardamoney/lisa-extension/blob/main/src/background/service-worker.js"
click node_semantic_analysis "https://github.com/amardamoney/lisa-extension/blob/main/src/utils/semantic-analyzer.js"
click node_checkpoint_detection "https://github.com/amardamoney/lisa-extension/blob/main/src/shared/checkpoint-detect.js"
click node_export_builders "https://github.com/amardamoney/lisa-extension/blob/main/src/shared/export-builders.js"
click node_snapshot_history "https://github.com/amardamoney/lisa-extension/blob/main/src/shared/snapshot-shim.js"
click node_popup "https://github.com/amardamoney/lisa-extension/blob/main/src/popup/popup.js"
click node_stripe_manager "https://github.com/amardamoney/lisa-extension/blob/main/src/stripe/stripe-payment-manager.js"
click node_stripe_client "https://github.com/amardamoney/lisa-extension/blob/main/src/stripe/stripe-client.js"
click node_billing_server "https://github.com/amardamoney/lisa-extension/blob/main/server/index.js"
click node_eval_runner "https://github.com/amardamoney/lisa-extension/blob/main/eval/run.js"
click node_eval_loader "https://github.com/amardamoney/lisa-extension/blob/main/eval/load-lisa.js"
click node_token_count "https://github.com/amardamoney/lisa-extension/blob/main/eval/count.js"
click node_quality_judge "https://github.com/amardamoney/lisa-extension/blob/main/eval/judge.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_platform_capture,node_api_capture,node_progressive_capture,node_user toneBlue
class node_lisa_v,node_background,node_semantic_analysis,node_checkpoint_detection,node_export_builders,node_snapshot_history toneAmber
class node_floating_save,node_popup toneMint
class node_stripe_manager,node_stripe_client,node_billing_server toneRose
class node_eval_runner,node_eval_loader,node_token_count,node_quality_judge,node_ai_platform,node_stripe toneIndigo
```

## Components

### Conversation Capture

- [Platform Parsers](https://github.com/amardamoney/lisa-extension/tree/main/src/content): `src/content`
- [API Capture](https://github.com/amardamoney/lisa-extension/tree/main/src/content): `src/content`
- [Progressive Capture](https://github.com/amardamoney/lisa-extension/blob/main/src/content/lisa-progressive.js): `src/content/lisa-progressive.js`

### Memory Processing

- [LISA-V Export](https://github.com/amardamoney/lisa-extension/blob/main/src/content/lisa-v-parser.js): `src/content/lisa-v-parser.js`
- [Background Engine](https://github.com/amardamoney/lisa-extension/blob/main/src/background/service-worker.js): `src/background/service-worker.js`
- [Semantic Analysis](https://github.com/amardamoney/lisa-extension/blob/main/src/utils/semantic-analyzer.js): `src/utils/semantic-analyzer.js`
- [Checkpoint Detection](https://github.com/amardamoney/lisa-extension/blob/main/src/shared/checkpoint-detect.js): `src/shared/checkpoint-detect.js`
- [Export Builders](https://github.com/amardamoney/lisa-extension/blob/main/src/shared/export-builders.js): `src/shared/export-builders.js`
- [Snapshot History](https://github.com/amardamoney/lisa-extension/blob/main/src/shared/snapshot-shim.js): `src/shared/snapshot-shim.js`

### Extension Experience

- [Floating Save](https://github.com/amardamoney/lisa-extension/blob/main/src/content/lisa-floating-button.js): `src/content/lisa-floating-button.js`
- [Extension Popup](https://github.com/amardamoney/lisa-extension/blob/main/src/popup/popup.js): `src/popup/popup.js`

### Premium Billing

- [Subscription Manager](https://github.com/amardamoney/lisa-extension/blob/main/src/stripe/stripe-payment-manager.js): `src/stripe/stripe-payment-manager.js`
- [Stripe Client](https://github.com/amardamoney/lisa-extension/blob/main/src/stripe/stripe-client.js): `src/stripe/stripe-client.js`
- [Billing Server](https://github.com/amardamoney/lisa-extension/blob/main/server/index.js): `server/index.js`

### Compression Evaluation

- [Eval Harness](https://github.com/amardamoney/lisa-extension/blob/main/eval/run.js): `eval/run.js`
- [Extension Loader](https://github.com/amardamoney/lisa-extension/blob/main/eval/load-lisa.js): `eval/load-lisa.js`
- [Token Counter](https://github.com/amardamoney/lisa-extension/blob/main/eval/count.js): `eval/count.js`
- [Quality Judge](https://github.com/amardamoney/lisa-extension/blob/main/eval/judge.js): `eval/judge.js`

### Other components

- **Extension User**
- **AI Chat Pages**
- **Stripe**

## Connections

- AI Chat Pages → Platform Parsers: provides chat (evidence: `README.md`)
- Platform Parsers → Background Engine: captures conversation
- API Capture → Background Engine: captures conversation
- Extension User → Extension Popup: starts export (evidence: `README.md`)
- Extension Popup → Background Engine: requests export
- Background Engine → Semantic Analysis: enriches data
- Background Engine → Checkpoint Detection: detects checkpoints (evidence: `src/shared/checkpoint-detect.js`)
- Background Engine → Export Builders: builds export (evidence: `src/shared/export-builders.js`)
- Background Engine → Snapshot History: uses snapshot schema (evidence: `src/background/service-worker.js`)
- Extension User → Floating Save: chooses save (evidence: `README.md`)
- Floating Save → LISA-V Export: requests LISA-V (evidence: `README.md`)
- LISA-V Export → AI Chat Pages: captures verbatim (evidence: `src/content/lisa-v-parser.js`)
- Extension User → Platform Parsers: selects text (evidence: `README.md`)
- Subscription Manager → Stripe Client: manages payments (evidence: `src/stripe/stripe-payment-manager.js`)
- Stripe Client → Billing Server: calls billing API (evidence: `src/stripe/stripe-client.js`)
- Billing Server → Stripe: creates sessions (evidence: `server/index.js`)
- Eval Harness → Extension Loader: loads extension (evidence: `eval/run.js`)
- Eval Harness → Token Counter: counts tokens (evidence: `eval/run.js`)
- Eval Harness → Quality Judge: evaluates quality (evidence: `eval/run.js`)
- Extension Loader → Export Builders: uses builders (evidence: `eval/load-lisa.js`)
