Managing History - Argument Analysis Tool

Every analysis you perform is automatically saved to your personal history, allowing you to revisit and reference past argument maps.

Accessing Your History

Navigate to History

Click on the “History” link in the main navigation menu.

View your analyses

You’ll see a grid of cards showing all your saved argument analyses.

Browse chronologically

Analyses are sorted by creation date, with the most recent appearing first.

You must be logged in to access your analysis history. If you’re not authenticated, you’ll be redirected to the login page.

History Page Features

The history page displays your analyses in an organized grid layout:

Analysis Cards

Each card shows the analysis name and creation timestamp

Chronological Sorting

Most recent analyses appear first

Responsive Grid

Layout adapts: 1 column (mobile), 2 columns (tablet), 3 columns (desktop)

Quick Metadata

See when each analysis was created (e.g., “2 hours ago”, “3 days ago”)

Analysis Card Information

Each history card displays:

Analysis Name: The topic, URL, or first 150 characters of your input
Creation Date: Relative timestamp (e.g., “2 hours ago”, “3 days ago”)
Visual Feedback: Cards show hover effects for better interactivity

The analysis name is automatically generated:

For Topic inputs: First 150 characters of your query
For URL inputs: The complete URL
For Document inputs: First 150 characters of the text

How History is Stored

Firestore Data Structure

Your analyses are stored in a Cloud Firestore database with the following structure:

users/
  └── {userId}/
      └── argumentMaps/
          ├── {documentId1}/
          │   ├── id: string
          │   ├── userId: string
          │   ├── name: string
          │   ├── creationDate: timestamp
          │   └── jsonData: string
          ├── {documentId2}/
          └── {documentId3}/

Document Fields

Each saved analysis contains:

id
userId
name
creationDate
jsonData

Document ID

Type: stringAuto-generated unique identifier for the analysis.

id: "abc123def456"

This ID is used to retrieve specific analyses and matches the Firestore document ID.

User ID

Type: stringYour Firebase authentication user ID.

userId: "firebase-user-uid-12345"

This ensures your analyses are private and only accessible to you.

Analysis Name

Type: stringDisplay name for the analysis, used in the history list.

// For topics/documents:
name: "Should universal basic income be implemented nationwide?"

// For URLs:
name: "https://example.com/article-about-climate"

Limited to 150 characters for topics and documents.

Creation Date

Type: TimestampServer-side timestamp of when the analysis was performed.

creationDate: Timestamp { seconds: 1234567890, nanoseconds: 123456789 }

Used for sorting and displaying relative time (“2 hours ago”).

Analysis Data

Type: string (JSON-serialized AnalysisResult)The complete analysis results stored as a JSON string.

jsonData: JSON.stringify({
  blueprint: ArgumentNode[],
  summary: string,
  analysis: string,
  socialPulse: string,
  tweets: Tweet[]
})

This contains the full argument blueprint, summary, analysis, and social pulse data.

Automatic Saving

Every successful analysis is automatically saved:

Analysis completes

After the AI generates your argument blueprint successfully.

Document created

A new document is created in your Firestore collection.

Data stored

All analysis results are serialized and saved.

Timestamp recorded

Server timestamp is automatically added.

Saving happens in the background. Even if saving fails, you’ll still see your analysis results—you just won’t be able to access them later from history.

Data Persistence

How Long is Data Stored?

Your analysis history is stored indefinitely unless you manually delete items or close your account.

Key points about data persistence:

No automatic deletion: Analyses remain until you remove them
User-scoped: Only you can access your analyses
Server-side timestamps: Creation dates are reliable and timezone-independent
Full fidelity: Complete analysis data is preserved, including all nodes and metadata

Privacy & Security

Private by Default

Analyses are stored under your user ID—no one else can access them

Authenticated Access

Firebase security rules ensure only authenticated owners can read their data

Server-side Validation

Authentication tokens are verified before saving or retrieving analyses

Encrypted Transport

All data transmission uses HTTPS encryption

Loading States

The history page handles various states gracefully:

Loading
Empty
Error
Loaded

Loading State

While fetching your history from Firestore:

A loading spinner is displayed
The page shows “Loading…” feedback
Navigation remains accessible

This typically takes 1-2 seconds on first load.

Empty History

If you haven’t performed any analyses yet:

You have no saved analyses yet. 
Start a new analysis to see your history here.

This encourages you to create your first analysis.

Querying Your History

Behind the scenes, the history page uses an optimized Firestore query:

query(
  collection(firestore, 'users', userId, 'argumentMaps'),
  orderBy('creationDate', 'desc')
)

This query:

Fetches all documents in your argumentMaps subcollection
Sorts by creationDate in descending order (newest first)
Uses Firestore indexes for fast retrieval
Automatically syncs with real-time updates

Limitations & Notes

View Analysis (Soon)

Currently, the history page displays analysis metadata but doesn’t yet allow you to view the full analysis results.The “View Analysis” button is disabled with a “(Soon)” label. This feature is planned for a future update.Workaround: Re-run the same analysis to generate fresh results.

No Search or Filtering

The current version doesn’t include search or filtering capabilities.All analyses are displayed chronologically. To find a specific analysis, scroll through the list.Tip: Use descriptive topics when creating analyses to make them easier to identify later.

No Deletion

There’s currently no way to delete individual analyses from the history page.This feature may be added in future updates.

No Export from History

While you can export analysis results immediately after generation, you cannot currently export from the history page.See the Exporting Data guide for current export options.

Best Practices

Descriptive Queries

Use clear, descriptive topics so you can identify analyses later

Regular Reviews

Periodically review your history to revisit insights

Stay Logged In

Keep your authentication session active to access history

Note-Taking

Consider taking external notes for important findings

Troubleshooting

Redirected to Login

History Not Loading

If the loading spinner persists:

Check your internet connection
Verify Firebase services are operational
Try refreshing the page
Clear browser cache and try again

Solution: Wait a moment and refresh, or check the browser console for error details.

Missing Recent Analysis

If a recent analysis doesn’t appear:

The save operation may have failed silently
Check the browser console for Firestore errors
Verify your authentication was valid during analysis

Solution: Re-run the analysis. If the problem persists, check Firebase configuration.

Error Loading History

If you see an error message:

Firestore security rules may be misconfigured
Your user account may have permission issues
The database may be temporarily unavailable

Solution: Contact support or check Firebase console for issues.

Future Enhancements

Planned features for history management:

View full analysis from history
Search and filter capabilities
Delete individual analyses
Rename analyses
Export multiple analyses at once
Share analyses with others
Tag and categorize analyses
Comparison view for multiple analyses

Getting Started

Core Features

User Guide

​Accessing Your History

​History Page Features

Analysis Cards

Chronological Sorting

Responsive Grid

Quick Metadata

​Analysis Card Information

​How History is Stored

​Firestore Data Structure

​Document Fields

​Document ID

​User ID

​Analysis Name

​Creation Date

​Analysis Data

​Automatic Saving

​Data Persistence

​How Long is Data Stored?

​Privacy & Security

Private by Default

Authenticated Access

Server-side Validation

Encrypted Transport

​Loading States

​Loading State

​Empty History

​Error State

​Successfully Loaded

​Querying Your History

​Limitations & Notes

​Best Practices

Descriptive Queries

Regular Reviews

Stay Logged In

Note-Taking

​Troubleshooting

​Future Enhancements

Build docs developers (and LLMs) love

Accessing Your History

History Page Features

Analysis Card Information

How History is Stored

Firestore Data Structure

Document Fields

Document ID

User ID

Analysis Name

Creation Date

Analysis Data

Automatic Saving

Data Persistence

How Long is Data Stored?

Privacy & Security

Loading States

Loading State

Empty History

Error State

Successfully Loaded

Querying Your History

Limitations & Notes

Best Practices

Troubleshooting

Future Enhancements