@synode/analyzer

Reverse-engineer Synode configs from existing event data. Analyzes CSV, JSONL, or JSON event logs and produces a complete Synode configuration with journeys, adventures, actions, datasets, and personas.

Install

npm install @synode/analyzer

For AI-powered enhancement (optional):

npm install ai @ai-sdk/anthropic  # or @ai-sdk/google

Usage

CLI (recommended)

# Place event data in your project's input/ directory
synode analyze

# Re-compile from existing analysis
synode analyze --compile-only

Programmatic

import {
  parseFile,
  detectSchema,
  normalizeEvents,
  detectSessions,
  discoverActions,
  mineSequences,
  assembleAdventures,
  assembleJourneys,
  extractDatasets,
  extractPersona,
  compileToTypeScript,
} from '@synode/analyzer';

const rows = await parseFile('events.csv');
const schema = detectSchema(rows);
const events = normalizeEvents(rows, schema.mapping);
const sessions = detectSessions(events, { mode: 'timeGap', gapMs: 30 * 60 * 1000 });

const actions = discoverActions(sessions);
const sequences = mineSequences(sessions, { minSupport: 0.1 });
const adventures = assembleAdventures(sequences, sessions, actions);
const journeys = assembleJourneys(adventures, sessions);
const datasets = extractDatasets(sessions);
const persona = extractPersona(sessions);

Supported Formats

| Format | Auto-detected schemas | | ------ | ------------------------------- | | CSV | Generic (manual column mapping) | | JSONL | Segment, Mixpanel, GA4, generic | | JSON | Segment, Mixpanel, GA4, generic |

Pipeline

1. Parse — read CSV/JSONL/JSON files
2. Detect schema — auto-detect Segment, Mixpanel, GA4, or map manually
3. Normalize — convert to unified event format
4. Session detection — split by session ID or time gap
5. Action discovery — find unique events with field distributions
6. Sequence mining — discover frequent action subsequences
7. Adventure assembly — group sequences into adventures
8. Journey assembly — group adventures into journeys
9. Dataset extraction — find entity tables from payloads
10. Persona extraction — detect user-level attribute distributions

Documentation

• Getting Started
• Analyzer Guide
• GitHub

License

Proprietary — see LICENSE for details.

Copyright © 2026 Digitl Cloud GmbH