Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
170 changes: 170 additions & 0 deletions WORKSPACE_README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,170 @@
# MagniteEngineering Multi-Repo Workspace

This workspace contains multiple repositories from the MagniteEngineering organization, organized by functional category.

## Workspace Structure

```
/workspace/
├── README.md # 3px - Realtime data integrations (root repo)
├── real_time_data_integration.proto # Protocol buffer definitions
├── WORKSPACE_README.md # This file
├── core/ # Core API and validation projects
│ ├── xapi-proto/ # ExchangeApi (xAPI) extensions for OpenRTB via protobuf
│ └── snowflake-validator/ # Snowflake data validation
├── mobile/ # Mobile SDK projects
│ ├── demand-manager-ios/ # DM-specific Demo Apps for iOS integration
│ └── demand-manager-android/ # Android SDK and demos
├── privacy-sandbox/ # Privacy Sandbox & Web API experiments
│ ├── fledge.polyfill/ # Fledge Trial Javascript Polyfill
│ ├── tdpp-trial/ # Turtledove++ Trial
│ ├── ProprietaryCohorts/ # Proprietary Cohorts implementation
│ ├── gatekeeper-sparrow-server/ # Gatekeeper SPARROW POC implementation
│ ├── Storage-Access-API/ # Storage Access API experiments
│ ├── FLoC-Server-FKA-Gatekeeper--POC/ # FLoC Server POC
│ └── FLoC-Server-FKA-Gatekeeper-/ # FLoC Server implementation
└── infrastructure/ # Infrastructure and operations tools
├── terraform-provider-pingdom/ # Terraform provider to manage Pingdom resources (fork)
├── exabgpctl/ # ExaBGP wrapper and control tool (fork)
└── go-pingdom/ # Pingdom API access from Go (fork)
```

## Repository Categories

### 🔧 Core Projects
These repositories contain core APIs, protocol definitions, and data validation tools.

- **xapi-proto**: ExchangeApi (xAPI) extensions for OpenRTB via protobuf
- Location: `core/xapi-proto/`
- URL: https://github.com/MagniteEngineering/xapi-proto

- **snowflake-validator**: Snowflake data validation tools
- Location: `core/snowflake-validator/`
- URL: https://github.com/MagniteEngineering/snowflake-validator

### 📱 Mobile SDKs
Mobile integration projects for iOS and Android platforms.

- **demand-manager-ios**: DM-specific Demo Applications for iOS integration
- Location: `mobile/demand-manager-ios/`
- URL: https://github.com/MagniteEngineering/demand-manager-ios

- **demand-manager-android**: Android SDK and integration demos
- Location: `mobile/demand-manager-android/`
- URL: https://github.com/MagniteEngineering/demand-manager-android

### 🔒 Privacy Sandbox Projects
Experimental implementations of privacy-preserving web APIs and proposals.

- **fledge.polyfill**: Fledge Trial Javascript Polyfill
- Location: `privacy-sandbox/fledge.polyfill/`
- URL: https://github.com/MagniteEngineering/fledge.polyfill

- **tdpp-trial**: Turtledove++ Trial implementation
- Location: `privacy-sandbox/tdpp-trial/`
- URL: https://github.com/MagniteEngineering/tdpp-trial

- **ProprietaryCohorts**: Proprietary Cohorts implementation
- Location: `privacy-sandbox/ProprietaryCohorts/`
- URL: https://github.com/MagniteEngineering/ProprietaryCohorts

- **gatekeeper-sparrow-server**: Gatekeeper SPARROW POC implementation
- Location: `privacy-sandbox/gatekeeper-sparrow-server/`
- URL: https://github.com/MagniteEngineering/gatekeeper-sparrow-server

- **Storage-Access-API**: Storage Access API experiments
- Location: `privacy-sandbox/Storage-Access-API/`
- URL: https://github.com/MagniteEngineering/Storage-Access-API

- **FLoC-Server Projects**: Federated Learning of Cohorts server implementations
- Location: `privacy-sandbox/FLoC-Server-FKA-Gatekeeper--POC/`
- Location: `privacy-sandbox/FLoC-Server-FKA-Gatekeeper-/`
- URLs: https://github.com/MagniteEngineering/FLoC-Server-FKA-Gatekeeper--POC
- URLs: https://github.com/MagniteEngineering/FLoC-Server-FKA-Gatekeeper-

### 🏗️ Infrastructure & Operations
Infrastructure automation and monitoring tools (includes forked projects).

- **terraform-provider-pingdom**: Terraform provider to manage Pingdom resources
- Location: `infrastructure/terraform-provider-pingdom/`
- URL: https://github.com/MagniteEngineering/terraform-provider-pingdom
- Note: Fork of russellcardullo/terraform-provider-pingdom

- **exabgpctl**: ExaBGP wrapper and control tool
- Location: `infrastructure/exabgpctl/`
- URL: https://github.com/MagniteEngineering/exabgpctl
- Note: Fork of raddessi/exabgpctl
- Docs: https://exabgpctl.readthedocs.io/en/latest/

- **go-pingdom**: Pingdom API access from Go
- Location: `infrastructure/go-pingdom/`
- URL: https://github.com/MagniteEngineering/go-pingdom
- Note: Fork of russellcardullo/go-pingdom

## Root Repository: 3px

The workspace root contains the **3px** repository - Realtime data integrations.
- URL: https://github.com/MagniteEngineering/3px
- Branch: `cursor/connect-to-magniteinc-github-repos-ef39`

## Working with Multiple Repositories

### Updating All Repositories
```bash
# Update all repos at once
for dir in core/* mobile/* privacy-sandbox/* infrastructure/*; do
if [ -d "$dir/.git" ]; then
echo "Updating $dir..."
(cd "$dir" && git pull)
fi
done
```

### Checking Status Across Repos
```bash
# Check git status for all repos
for dir in . core/* mobile/* privacy-sandbox/* infrastructure/*; do
if [ -d "$dir/.git" ]; then
echo "=== $dir ==="
(cd "$dir" && git status -s)
fi
done
```

### Creating Feature Branches
```bash
# Create same-named branch across multiple repos
BRANCH_NAME="feature/your-feature"
for dir in core/* mobile/*; do
if [ -d "$dir/.git" ]; then
(cd "$dir" && git checkout -b "$BRANCH_NAME")
fi
done
```

## GitHub Authentication

Authenticated as: **cursor**
- GitHub CLI installed and configured
- Organization: MagniteEngineering
- All repositories cloned via HTTPS with token authentication

## Quick Links

- **Organization**: https://github.com/MagniteEngineering
- **Magnite Wiki**: https://magnite.atlassian.net/wiki/spaces/techops/pages/463178722/github.com+MagniteInc+OneLogin+SSO

## Notes

- All repositories are public under the MagniteEngineering organization
- Infrastructure repos (terraform-provider-pingdom, exabgpctl, go-pingdom) are forks with upstream remotes configured
- Privacy Sandbox projects are experimental/POC implementations from 2020-2021
- Mobile SDKs are actively maintained demo applications

---

Last updated: 2025-10-23
1 change: 1 addition & 0 deletions core/snowflake-validator
Submodule snowflake-validator added at 5494ac
1 change: 1 addition & 0 deletions core/xapi-proto
Submodule xapi-proto added at b43b0a
1 change: 1 addition & 0 deletions infrastructure/exabgpctl
Submodule exabgpctl added at bd7e27
1 change: 1 addition & 0 deletions infrastructure/go-pingdom
Submodule go-pingdom added at 4657d7
1 change: 1 addition & 0 deletions infrastructure/terraform-provider-pingdom
Submodule terraform-provider-pingdom added at d46e33
1 change: 1 addition & 0 deletions mobile/demand-manager-android
Submodule demand-manager-android added at 71a64e
1 change: 1 addition & 0 deletions mobile/demand-manager-ios
Submodule demand-manager-ios added at 6b2045
1 change: 1 addition & 0 deletions privacy-sandbox/FLoC-Server-FKA-Gatekeeper-
Submodule FLoC-Server-FKA-Gatekeeper- added at 94b16c
1 change: 1 addition & 0 deletions privacy-sandbox/FLoC-Server-FKA-Gatekeeper--POC
Submodule FLoC-Server-FKA-Gatekeeper--POC added at 4fbb91
1 change: 1 addition & 0 deletions privacy-sandbox/ProprietaryCohorts
Submodule ProprietaryCohorts added at 9f2fa7
1 change: 1 addition & 0 deletions privacy-sandbox/Storage-Access-API
Submodule Storage-Access-API added at 898ccc
1 change: 1 addition & 0 deletions privacy-sandbox/fledge.polyfill
Submodule fledge.polyfill added at 36ae8f
1 change: 1 addition & 0 deletions privacy-sandbox/gatekeeper-sparrow-server
Submodule gatekeeper-sparrow-server added at 2aad99
1 change: 1 addition & 0 deletions privacy-sandbox/tdpp-trial
Submodule tdpp-trial added at 33a454
80 changes: 80 additions & 0 deletions workspace-status.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
#!/bin/bash
# Workspace Status Script
# Shows the git status of all repositories in the workspace

echo "================================================"
echo "MagniteEngineering Multi-Repo Workspace Status"
echo "================================================"
echo ""

check_repo() {
local dir=$1
local name=$2

if [ -d "$dir/.git" ]; then
cd "$dir"

# Get current branch
branch=$(git branch --show-current)

# Get status
if [ -n "$(git status --porcelain)" ]; then
status="✗ MODIFIED"
else
status="✓ clean"
fi

# Check if ahead/behind remote
local_commit=$(git rev-parse HEAD 2>/dev/null)
remote_commit=$(git rev-parse @{u} 2>/dev/null)

if [ "$local_commit" = "$remote_commit" ]; then
sync_status="up-to-date"
elif [ -z "$remote_commit" ]; then
sync_status="no remote"
else
sync_status="diverged"
fi

printf "%-35s | %-30s | %-12s | %s\n" "$name" "$branch" "$status" "$sync_status"
fi
}

echo "ROOT REPOSITORY"
echo "----------------"
check_repo "/workspace" "3px (root)"
echo ""

echo "CORE PROJECTS"
echo "-------------"
check_repo "/workspace/core/xapi-proto" "xapi-proto"
check_repo "/workspace/core/snowflake-validator" "snowflake-validator"
echo ""

echo "MOBILE SDKS"
echo "-----------"
check_repo "/workspace/mobile/demand-manager-ios" "demand-manager-ios"
check_repo "/workspace/mobile/demand-manager-android" "demand-manager-android"
echo ""

echo "PRIVACY SANDBOX"
echo "---------------"
check_repo "/workspace/privacy-sandbox/fledge.polyfill" "fledge.polyfill"
check_repo "/workspace/privacy-sandbox/tdpp-trial" "tdpp-trial"
check_repo "/workspace/privacy-sandbox/ProprietaryCohorts" "ProprietaryCohorts"
check_repo "/workspace/privacy-sandbox/gatekeeper-sparrow-server" "gatekeeper-sparrow-server"
check_repo "/workspace/privacy-sandbox/Storage-Access-API" "Storage-Access-API"
check_repo "/workspace/privacy-sandbox/FLoC-Server-FKA-Gatekeeper--POC" "FLoC-Server-FKA-Gatekeeper--POC"
check_repo "/workspace/privacy-sandbox/FLoC-Server-FKA-Gatekeeper-" "FLoC-Server-FKA-Gatekeeper-"
echo ""

echo "INFRASTRUCTURE"
echo "--------------"
check_repo "/workspace/infrastructure/terraform-provider-pingdom" "terraform-provider-pingdom"
check_repo "/workspace/infrastructure/exabgpctl" "exabgpctl"
check_repo "/workspace/infrastructure/go-pingdom" "go-pingdom"
echo ""

echo "================================================"
echo "Total repositories: 15"
echo "================================================"