Enums are the API. Configure via CompanyType, PasswordStrength, etc. Everything else is internal.
Composable by region. Arrays aggregate with [.. UsNames, .. EuropeanNames]. New region = new array + one line change.
Deterministic. Seeded randomness means same org ID → same test data → reproducible debugging.
Filterable. Companies.Filter(type, region, category) for targeted data selection.

Generators

Seeded, deterministic data generation for cipher content. Orchestrated by GeneratorContext which lazy-initializes on first access.

Generator	Output	Method
`CipherUsernameGenerator`	Emails, handles	`GenerateByIndex(index, totalHint, domain)`
`CardDataGenerator`	Card numbers, names	`GenerateByIndex(index)`
`IdentityDataGenerator`	Full identity profiles	`GenerateByIndex(index)`
`FolderNameGenerator`	Folder names	`GetFolderName(index)`
`SecureNoteDataGenerator`	Note title + content	`GenerateByIndex(index)`
`SshKeyDataGenerator`	RSA key pairs	`GenerateByIndex(index)`

Adding a generator: See GeneratorContext.cs remarks for the 3-step pattern.

Distributions

Percentage-based deterministic selection via Distribution<T>.Select(index, total).

Distribution	Values	Usage
`PasswordDistributions.Realistic`	25% VeryWeak → 5% VeryStrong	Password strength mix
`UsernameDistributions.Realistic`	45% corporate, 30% personal, etc.	Username category mix
`CipherTypeDistributions.Realistic`	70% Login, 15% Card, etc.	Cipher type mix
`UserStatusDistributions.Realistic`	85% Confirmed, 5% each other	Org user status mix
`FolderCountDistributions.Realistic`	35% zero, 35% 1-3, etc.	Folders per user

Current Capabilities

50 real companies across 3 regions with metadata (category, type, domain)
200 first names + 200 last names (US, European)
6 username patterns (corporate email conventions)
3 password strength levels (95 total passwords)

Organizational Structures

Traditional (departments + sub-units)
Spotify Model (tribes, squads, chapters, guilds)
Modern/AI-First (feature teams, platform teams, pods)

Roadmap

Phase 1: Additional Cipher Types

Cipher Type	Data Needed	Status
Login	Companies, Names, Passwords, Patterns	✅ Complete
Card	Card networks, bank names, realistic numbers	✅ Complete
Identity	Full identity profiles (name, address, SSN patterns)	✅ Complete
SecureNote	Note templates, categories, content generators	✅ Complete
SSH Key	RSA key pairs, fingerprints	✅ Complete

Phase 2: Spec-Driven Generation

Import a specification file and generate a complete vault to match:

# Example: organization-spec.yaml
organization:
  name: "Acme Corp"
  users: 500

collections:
  structure: spotify # Use Spotify org model

ciphers:
  logins:
    count: 2000
    companies:
      type: enterprise
      region: north_america
    passwords: mixed # Realistic distribution
    username_pattern: first_dot_last

  cards:
    count: 100
    networks: [visa, mastercard, amex]

  identities:
    count: 200
    regions: [us, europe]

  secure_notes:
    count: 300
    categories: [api_keys, licenses, documentation]

Spec Engine Components (Future)

SpecParser - YAML/JSON spec file parsing
SpecValidator - Schema validation
SpecExecutor - Orchestrates generation from spec
ProgressReporter - Real-time generation progress

Phase 3: Data Enhancements

Enhancement	Description
Additional Regions	LatinAmerica, MiddleEast, Africa companies and names
Industry Verticals	Healthcare, Finance, Government-specific companies
Localized Passwords	Region-specific common passwords
Custom Fields	Field templates per cipher type
TOTP Seeds	Realistic 2FA seed generation
Attachments	File attachment simulation
Password History	Historical password entries

Phase 4: Advanced Features

Relationship Graphs - Ciphers that reference each other (SSO relationships)
Temporal Data - Realistic created/modified timestamps over time
Access Patterns - Simulate realistic collection/group membership distributions
Breach Simulation - Mark specific passwords as "exposed" for security testing

Adding New Data

New Region (e.g., Swedish Names)

// In Names.cs - add array
public static readonly string[] SwedishFirstNames = ["Erik", "Lars", "Anna", ...];
public static readonly string[] SwedishLastNames = ["Andersson", "Johansson", ...];

// Update aggregates
public static readonly string[] AllFirstNames = [.. UsFirstNames, .. EuropeanFirstNames, .. SwedishFirstNames];
public static readonly string[] AllLastNames = [.. UsLastNames, .. EuropeanLastNames, .. SwedishLastNames];

New Company Category

// In Enums/CompanyCategory.cs
public enum CompanyCategory
{
    // ... existing ...
    Healthcare,    // Add new category
    Government
}

// In Companies.cs - add companies with new category
new("epic.com", "Epic Systems", CompanyCategory.Healthcare, CompanyType.Enterprise, GeographicRegion.NorthAmerica),

New Password Pattern

// In Passwords.cs - add to appropriate strength array
// Strong array - add new passphrase style
"correct-horse-battery-staple",  // Diceware
"Brave.Tiger.Runs.Fast.42",      // Mixed case with numbers
"maple#stream#winter#glow",      // Symbol-separated (new)

README.md

Seeder Data System

Architecture