Document Lineage & Audit Trail

TyneBase maintains complete lineage for every document, essential for compliance and accountability.

What is Document Lineage?

Lineage tracks the complete history of a document:

• Who created, edited, or viewed it
• What changes were made
• When each action occurred
• How it was created (manual, AI, template)
• Why changes were made (via comments)

Lineage Events

Creation Events

Event	Description
document_created	Manual creation
document_uploaded	File upload
document_ai_generated	AI generation
document_cloned_from_template	Template use

Modification Events

Event	Description
content_edited	Content changes
metadata_updated	Title, tags, category
version_created	New version saved
version_restored	Previous version restored

State Changes

Event	Description
state_draft	Moved to draft
state_in_review	Submitted for review
state_published	Published
state_archived	Archived

AI Operations

Event	Description
ai_generation_completed	AI created content
rag_context_retrieved	Used in RAG query
document_indexed	Added to AI index
embedding_created	Vectors generated

AI Generation Metadata

When AI generates a document, we capture:

{
  "event_type": "ai_generation_completed",
  "ai_metadata": {
    "model": "deepseek-v3",
    "provider": "bedrock",
    "prompt_hash": "sha256:abc123...",
    "tokens_input": 450,
    "tokens_output": 2100,
    "credits_charged": 0.2,
    "rag_sources": ["doc_123", "doc_456"],
    "temperature": 0.7,
    "generation_time_ms": 4500
  }
}

Viewing Lineage

Access document lineage:

1. Open any document
2. Click menu → View History
3. See complete timeline of document versions with:
   • Version number and timestamp
   • Author information
   • Content preview
   • Ability to restore previous versions

Compliance Benefits

• SOC 2: Complete audit trail
• GDPR: Data processing records
• HIPAA: Access logging
• ISO 27001: Change management

Lineage API

Retrieve lineage programmatically:

GET /v1/documents/{id}/lineage

Response includes full event history with actor details.