update

Author: adinhodovic

.beads/.gitignore

@@ -0,0 +1,51 @@
+# SQLite databases
+*.db
+*.db?*
+*.db-journal
+*.db-wal
+*.db-shm
+
+# Daemon runtime files
+daemon.lock
+daemon.log
+daemon-*.log.gz
+daemon.pid
+bd.sock
+sync-state.json
+last-touched
+
+# Local version tracking (prevents upgrade notification spam after git ops)
+.local_version
+
+# Legacy database files
+db.sqlite
+bd.db
+
+# Worktree redirect file (contains relative path to main repo's .beads/)
+# Must not be committed as paths would be wrong in other clones
+redirect
+
+# Merge artifacts (temporary files from 3-way merge)
+beads.base.jsonl
+beads.base.meta.json
+beads.left.jsonl
+beads.left.meta.json
+beads.right.jsonl
+beads.right.meta.json
+
+# Sync state (local-only, per-machine)
+# These files are machine-specific and should not be shared across clones
+.sync.lock
+.jsonl.lock
+sync_base.jsonl
+export-state/
+
+# Dolt database (managed by Dolt remotes, not git)
+dolt/
+dolt-access.lock
+
+# NOTE: Do NOT add negation patterns (e.g., !issues.jsonl) here.
+# They would override fork protection in .git/info/exclude, allowing
+# contributors to accidentally commit upstream issue databases.
+# The JSONL files (issues.jsonl, interactions.jsonl) and config files
+# are tracked by git by default since no pattern above ignores them.

…_project/demo/api/migrations/__init__.py .beads/interactions.jsonlexamples/demo_project/demo/api/migrations/__init__.py renamed to .beads/interactions.jsonl examples/demo_project/demo/api/migrations/__init__.py renamed to .beads/interactions.jsonl

@@ -0,0 +1,113 @@
+# Django Observability Environment Variables
+# Copy this file to .env and customize for your environment
+
+# ==============================================================================
+# SERVICE IDENTIFICATION
+# ==============================================================================
+
+# Service name (appears in traces, logs, metrics)
+OTEL_SERVICE_NAME=my-django-app
+
+# ==============================================================================
+# OPENTELEMETRY CONFIGURATION
+# ==============================================================================
+
+# OTLP Exporter Endpoint (traces, logs, metrics)
+# Development: http://localhost:4317 (local Grafana Alloy/Collector)
+# Production: Your OTLP endpoint URL
+OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317
+
+# Trace Sampling Rate (0.0 to 1.0)
+# 1.0 = 100% sampling (development)
+# 0.1 = 10% sampling (production low traffic)
+# 0.01 = 1% sampling (production high traffic)
+OTEL_TRACES_SAMPLER_ARG=1.0
+
+# Enable OTLP log export (optional, useful for log aggregation)
+OTEL_LOGS_ENABLED=true
+
+# ==============================================================================
+# LOGGING CONFIGURATION
+# ==============================================================================
+
+# Log Level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
+DJANGO_LOG_LEVEL=INFO
+
+# Request logging level (can be more verbose than general logs)
+DJANGO_REQUEST_LOG_LEVEL=INFO
+
+# Database query logging level (set to CRITICAL to disable in production)
+DJANGO_DATABASE_LOG_LEVEL=WARNING
+
+# Celery task logging level
+DJANGO_CELERY_LOG_LEVEL=INFO
+
+# Log Format: 'console' for development, 'json' for production
+# console = colorized, human-readable
+# json = structured, machine-parseable
+DJANGO_LOG_FORMAT=console
+
+# Colorize logs (true for development, false for production)
+DJANGO_LOG_COLORIZED=true
+
+# Rich exception formatting (true for development, false for production)
+DJANGO_LOG_RICH_EXCEPTIONS=true
+
+# ==============================================================================
+# PROFILING (OPTIONAL)
+# ==============================================================================
+
+# Enable continuous profiling with Pyroscope
+# Recommended: true in development, false in production (or selective in prod)
+PYROSCOPE_ENABLED=false
+
+# Pyroscope server address
+PYROSCOPE_SERVER_ADDRESS=http://localhost:4040
+
+# ==============================================================================
+# CELERY CONFIGURATION (IF USING CELERY)
+# ==============================================================================
+
+# Celery broker URL (Redis recommended)
+CELERY_BROKER_URL=redis://localhost:6379/0
+
+# Celery result backend
+CELERY_RESULT_BACKEND=redis://localhost:6379/0
+
+# ==============================================================================
+# DEVELOPMENT VS PRODUCTION EXAMPLES
+# ==============================================================================
+
+# DEVELOPMENT SETTINGS (copy these for local .env):
+# OTEL_SERVICE_NAME=myapp-dev
+# OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317
+# OTEL_TRACES_SAMPLER_ARG=1.0
+# OTEL_LOGS_ENABLED=true
+# DJANGO_LOG_LEVEL=INFO
+# DJANGO_LOG_FORMAT=console
+# DJANGO_LOG_COLORIZED=true
+# DJANGO_LOG_RICH_EXCEPTIONS=true
+# DJANGO_DATABASE_LOG_LEVEL=INFO
+# PYROSCOPE_ENABLED=true
+
+# PRODUCTION SETTINGS (example):
+# OTEL_SERVICE_NAME=myapp-prod
+# OTEL_EXPORTER_OTLP_ENDPOINT=https://otel-collector.mycompany.com:4317
+# OTEL_TRACES_SAMPLER_ARG=0.01
+# OTEL_LOGS_ENABLED=true
+# DJANGO_LOG_LEVEL=WARNING
+# DJANGO_LOG_FORMAT=json
+# DJANGO_LOG_COLORIZED=false
+# DJANGO_LOG_RICH_EXCEPTIONS=false
+# DJANGO_DATABASE_LOG_LEVEL=CRITICAL
+# PYROSCOPE_ENABLED=false
+
+# ==============================================================================
+# NOTES
+# ==============================================================================
+
+# 1. All these variables are OPTIONAL - django-observability has sensible defaults
+# 2. You can also configure these via DJANGO_OBSERVABILITY dict in settings.py
+# 3. Environment variables take precedence over settings.py configuration
+# 4. See README.md for full configuration options
+# 5. Run `python manage.py observability_check` to verify your setup

.env.example

@@ -135,3 +135,5 @@ uv.lock
 *.swo
 *~
 .ruff_cache/
+
+examples/demo_project/celerybeat-schedule.*