Transformation Portal v2.0.0 - Golden Path Release

🎉 First Stable Release - v2.0.0

Transformation Portal v2.0.0 marks the transition from experimental (0.x) to stable, production-ready API contracts.

---

🌟 What's New

Versioned API Contracts

• Schema version 2.0.0 for ImageReport, RunCard, and ServiceError
• Backward-compatible versioning ensures reliable automation
• Contract surfaces follow semantic versioning

Preset Governance

• 17 presets with clear stability taxonomy:
  • ✅ 11 stable (production-ready + CI baseline)
  • 🚧 4 canary (emerging features)
  • ⚠️ 2 experimental (validation-only)
• Discoverable via --list-presets and --describe-preset

Service Hardening

• /ready endpoint for K8s/Docker readiness probes (returns 503 when not ready)
• Structured error payloads (ServiceError schema)
• Rate limiting and file size validation

Agent Safety Rails

• Forbidden path enforcement prevents accidental modifications
• Clear boundaries for autonomous agents
• Comprehensive repository map for safe operation

---

📦 Version Alignment

Component	Version	Status
Package (pyproject.toml)	2.0.0	✅
Runtime (transformation_portal.__version__)	2.0.0	✅
Schema contracts	2.0.0	✅
Pipeline version	2.0.0	✅

All versions synchronized - package follows contract major version.

---

⚠️ Breaking Changes from 0.x

No intentional breaking changes to existing workflows. Invalid invocations now fail fast with clearer errors.

---

🚀 Quick Start

Explore available presets:

lux-depth-v2 --list-stable
lux-depth-v2 --describe-preset interior_luxury

---

📥 Installation

Install from this release:

pip install "git+https://github.com/RC219805/Transformation_Portal.git@v2.0.0"

For editable/development install:

git clone https://github.com/RC219805/Transformation_Portal.git
cd Transformation_Portal
git checkout v2.0.0
pip install -e .

---

🔧 Deployment Updates

Update health checks for production deployments:

# Kubernetes example
livenessProbe:
  httpGet:
    path: /health
    port: 8088

readinessProbe:
  httpGet:
    path: /ready
    port: 8088
  initialDelaySeconds: 10

---

⚠️ Known Limitations

• Model warmup: First inference may take 5-10 seconds (subsequent requests are fast)
• Recommended hardware:
  • CPU: 4+ cores
  • RAM: 8GB minimum, 16GB recommended for batch processing
  • GPU: Optional but recommended for >100 images (3-5x throughput improvement)

---

🔗 References

• PR #640: Golden Path hardening - Core features and contract enforcement
• PR #641: Version alignment - Metadata synchronization

---

📚 Documentation

• Agent Repository Map: docs/AGENT_REPO_MAP.md
• Golden Path Hardening Report: docs/GOLDEN_PATH_HARDENING_REPORT.md
• Workflow Selector: docs/WORKFLOW_SELECTOR.md

---

Contract surfaces were versioned at 2.0.0 in PR #640; package version now follows contract major.