# futureisinpast/antigravity-conversation-fix architecture

> Architecture diagram of the GitHub repository futureisinpast/antigravity-conversation-fix, 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/futureisinpast/antigravity-conversation-fix
- Repository: https://github.com/futureisinpast/antigravity-conversation-fix

## Overview

Antigravity Conversation Fix is a single-script repair tool that rebuilds Antigravity’s conversation sidebar index. The user closes Antigravity and runs the tool; it discovers conversation and brain-artifact folders, resolves titles and workspace metadata, preserves existing database metadata, then writes a rebuilt index to detected databases. The README documents multi-folder merging, `.pb`/`.db` support, cross-folder brain searches, and writes to multiple databases. The source excerpt is partial, so detailed internal call links are limited to documented relationships.

Main entry points: [`rebuild_conversations.py`](https://github.com/futureisinpast/antigravity-conversation-fix/blob/main/rebuild_conversations.py) (Repair tool)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Discovery and safety"]
  node_tool["Repair tool"]
  node_process_check["Running-app check"]
  node_path_discovery["Path discovery"]
end

subgraph group_resolution["Conversation resolution"]
  node_conversation_catalog["Conversation catalog"]
  node_title_resolution["Title resolution"]
  node_workspace_matching["Workspace matching"]
end

subgraph group_indexing["Index repair"]
  node_metadata_preservation["Metadata preservation"]
  node_index_builder["Index rebuild"]
  node_sidebar_index["Sidebar index"]
end

node_user(("User"))
node_antigravity["Antigravity process"]
node_conversation_files[("Conversation files")]
node_brain_artifacts[("Brain artifacts")]
node_workspace_storage[("Workspace storage")]
node_antigravity_databases[("Antigravity databases")]

node_user -->|"runs"| node_tool
node_tool -->|"checks first"| node_process_check
node_process_check -->|"checks status"| node_antigravity
node_tool -->|"discovers locations"| node_path_discovery
node_path_discovery -->|"locates"| node_conversation_files
node_conversation_files -->|"provides files"| node_conversation_catalog
node_path_discovery -->|"locates"| node_brain_artifacts
node_conversation_catalog -->|"provides conversations"| node_title_resolution
node_title_resolution -->|"reads titles"| node_brain_artifacts
node_conversation_catalog -.->|"provides conversations"| node_workspace_matching
node_path_discovery -->|"locates"| node_workspace_storage
node_workspace_matching -->|"reads mappings"| node_workspace_storage
node_tool -->|"reads existing metadata"| node_metadata_preservation
node_metadata_preservation -->|"reads metadata"| node_antigravity_databases
node_tool -->|"builds index"| node_index_builder
node_title_resolution -.->|"supplies titles"| node_index_builder
node_workspace_matching -.->|"supplies assignments"| node_index_builder
node_metadata_preservation -.->|"preserves metadata"| node_index_builder
node_index_builder -->|"writes index"| node_sidebar_index
node_sidebar_index -->|"updates databases"| node_antigravity_databases
node_user -->|"chooses assignment"| node_workspace_matching

click node_tool "https://github.com/futureisinpast/antigravity-conversation-fix/blob/main/rebuild_conversations.py"
click node_process_check "https://github.com/futureisinpast/antigravity-conversation-fix/blob/main/rebuild_conversations.py"
click node_path_discovery "https://github.com/futureisinpast/antigravity-conversation-fix/blob/main/rebuild_conversations.py"
click node_conversation_catalog "https://github.com/futureisinpast/antigravity-conversation-fix/blob/main/rebuild_conversations.py"
click node_title_resolution "https://github.com/futureisinpast/antigravity-conversation-fix/blob/main/rebuild_conversations.py"
click node_workspace_matching "https://github.com/futureisinpast/antigravity-conversation-fix/blob/main/rebuild_conversations.py"
click node_metadata_preservation "https://github.com/futureisinpast/antigravity-conversation-fix/blob/main/rebuild_conversations.py"
click node_index_builder "https://github.com/futureisinpast/antigravity-conversation-fix/blob/main/rebuild_conversations.py"
click node_sidebar_index "https://github.com/futureisinpast/antigravity-conversation-fix/blob/main/rebuild_conversations.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_tool,node_process_check,node_path_discovery,node_user toneBlue
class node_conversation_catalog,node_title_resolution,node_workspace_matching,node_conversation_files,node_brain_artifacts,node_workspace_storage,node_antigravity_databases toneAmber
class node_metadata_preservation,node_index_builder,node_sidebar_index toneMint
class node_antigravity toneIndigo
```

## Components

### Discovery and safety

- [Repair tool](https://github.com/futureisinpast/antigravity-conversation-fix/blob/main/rebuild_conversations.py): `rebuild_conversations.py`
- [Running-app check](https://github.com/futureisinpast/antigravity-conversation-fix/blob/main/rebuild_conversations.py): `rebuild_conversations.py`
- [Path discovery](https://github.com/futureisinpast/antigravity-conversation-fix/blob/main/rebuild_conversations.py): `rebuild_conversations.py`

### Conversation resolution

- [Conversation catalog](https://github.com/futureisinpast/antigravity-conversation-fix/blob/main/rebuild_conversations.py): `rebuild_conversations.py`
- [Title resolution](https://github.com/futureisinpast/antigravity-conversation-fix/blob/main/rebuild_conversations.py): `rebuild_conversations.py`
- [Workspace matching](https://github.com/futureisinpast/antigravity-conversation-fix/blob/main/rebuild_conversations.py): `rebuild_conversations.py`

### Index repair

- [Metadata preservation](https://github.com/futureisinpast/antigravity-conversation-fix/blob/main/rebuild_conversations.py): `rebuild_conversations.py`
- [Index rebuild](https://github.com/futureisinpast/antigravity-conversation-fix/blob/main/rebuild_conversations.py): `rebuild_conversations.py`
- [Sidebar index](https://github.com/futureisinpast/antigravity-conversation-fix/blob/main/rebuild_conversations.py): `rebuild_conversations.py`

### Other components

- **User**
- **Antigravity process**
- **Conversation files**
- **Brain artifacts**
- **Workspace storage**
- **Antigravity databases**

## Connections

- User → Repair tool: runs (evidence: `README.md`)
- Repair tool → Running-app check: checks first (evidence: `README.md`)
- Running-app check → Antigravity process: checks status (evidence: `README.md`)
- Repair tool → Path discovery: discovers locations (evidence: `README.md`)
- Path discovery → Conversation files: locates (evidence: `README.md`)
- Conversation files → Conversation catalog: provides files (evidence: `README.md`)
- Path discovery → Brain artifacts: locates (evidence: `README.md`)
- Conversation catalog → Title resolution: provides conversations (evidence: `README.md`)
- Title resolution → Brain artifacts: reads titles (evidence: `README.md`)
- Conversation catalog → Workspace matching: provides conversations (evidence: `rebuild_conversations.py`)
- Path discovery → Workspace storage: locates (evidence: `README.md`)
- Workspace matching → Workspace storage: reads mappings (evidence: `README.md`)
- Repair tool → Metadata preservation: reads existing metadata (evidence: `README.md`)
- Metadata preservation → Antigravity databases: reads metadata (evidence: `README.md`)
- Repair tool → Index rebuild: builds index (evidence: `README.md`)
- Title resolution → Index rebuild: supplies titles (evidence: `rebuild_conversations.py`)
- Workspace matching → Index rebuild: supplies assignments (evidence: `rebuild_conversations.py`)
- Metadata preservation → Index rebuild: preserves metadata (evidence: `rebuild_conversations.py`)
- Index rebuild → Sidebar index: writes index (evidence: `README.md`)
- Sidebar index → Antigravity databases: updates databases (evidence: `README.md`)
- User → Workspace matching: chooses assignment (evidence: `README.md`)