External System Connectors

[jayscambler]

Context & Importance

Organizations have knowledge in GitHub repos, Confluence wikis, Notion databases, etc. Manual export/import is painful. Native connectors enable ContextFrame to become the central context hub for AI agents across all company knowledge.

Why This Matters

• Existing Investment: Leverage knowledge already created
• Live Sync: Keep context fresh with source systems
• No Migration: Use ContextFrame without moving data
• Enterprise Ready: Integrate with corporate systems

Target Users

1. DevOps: "Import our entire GitHub org's documentation"
2. Product Teams: "Sync our Confluence space automatically"
3. Startups: "Pull our Notion wiki into ContextFrame"

Acceptance Criteria

• SourceConnector base class with auth abstraction
• GitHub connector:
  • Import repos with file → frame mapping
  • Preserve folder structure as collections
  • Extract README context automatically
  • Link commits to frame versions
  • Support public and private repos
• Linear connector:
  • Import teams preserving hierarchy
  • Import issues preserving relationships
  • Import projects preserving relationships and hierarchy
• Google Workspace / Drive Connector
• Context mapping engine:
  • Configurable field mappings
  • Custom context extraction rules
  • Incremental sync support
• Auth handling:
  • OAuth flow support
  • API key management
  • Token refresh logic

Success Metrics

• Import 10k GitHub files in <30 minutes
• Incremental sync completes in <1 minute
• Zero data loss in structure/metadata

[linear]

CFOS-26 External System Connectors