Merge pull request #62 from RonaldHensbergen/release/weekly-2026-06-21

chore(release): prepare weekly release v0.1.1

Author: RonaldHensbergen

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -1,31 +1,45 @@
-name: Bug report
-description: Report a reproducible problem
-labels:
-  - bug
+name: Bug Report
+description: Report a bug to help us improve the composable data stack.
+title: "[Bug]: "
+labels: ["bug", "triage"]
 body:
   - type: markdown
     attributes:
       value: |
-        Thanks for reporting a bug. Please provide enough detail to reproduce.
+        Thanks for reporting a bug! Please fill in as much detail as possible.
 
   - type: input
     id: summary
     attributes:
       label: Summary
-      description: One-line description of the problem
-      placeholder: cds render fails with unresolved contract ref
+      description: One-line description of the problem.
+      placeholder: e.g. cds render fails with unresolved contract ref
+    validations:
+      required: true
+
+  - type: dropdown
+    id: severity
+    attributes:
+      label: Severity
+      description: How severely does this bug affect you?
+      options:
+        - Critical (system unusable / data loss)
+        - High (major feature broken)
+        - Medium (feature partially broken)
+        - Low (minor inconvenience)
     validations:
       required: true
 
   - type: textarea
-    id: steps
+    id: repro
     attributes:
-      label: Steps to reproduce
-      description: Exact steps and commands
+      label: Minimal Reproducible Example
+      description: |
+        Smallest possible steps or code snippet to reproduce the bug.
       placeholder: |
-        1. Run ...
-        2. Edit ...
-        3. Observe ...
+        1. Configure X with...
+        2. Run command Y...
+        3. See error Z
     validations:
       required: true
 
@@ -40,15 +54,15 @@ body:
     id: actual
     attributes:
       label: Actual behavior and logs
-      description: Include full error output and stack trace
+      description: Include full error output and stack trace.
     validations:
       required: true
 
   - type: input
     id: environment
     attributes:
       label: Environment
-      description: OS, Python version, and how CDS was installed
+      description: OS, Python version, and how CDS was installed.
       placeholder: Linux, Python 3.11, pip install -e .
     validations:
       required: true
@@ -62,3 +76,4 @@ body:
           required: true
         - label: I removed sensitive information from logs
           required: true
+          

CHANGELOG.md

@@ -8,14 +8,23 @@ The format is based on Keep a Changelog.
 
 ### Added
 
+- No entries yet.
+
+## [0.1.1] - 2026-06-21
+
+### Added
+
 - Default render output path to project-root docker-compose.yml when no output is provided.
 - Open-source project governance and support docs.
 - Troubleshooting guidance in the README for common CLI validation, secret, and contract-binding errors.
+- Added `docs/os-compatibility.md` with OS compatibility analysis and recommendations.
+- Improved the bug report template with severity and minimal repro fields.
 
 ### Changed
 
 - Compose rendering now preserves secrets as runtime environment placeholders instead of embedding resolved values.
 - Plan secret mapping now stores env variable names rather than secret values.
+- Renderer build-context path rewriting now preserves portable relative paths for nested compose output directories.
 
 ### Tests
 

cli/renderer.py

@@ -5,8 +5,8 @@
 """
 from __future__ import annotations
 
-import os
 import re
+import os
 import yaml
 from copy import deepcopy
 from pathlib import Path
@@ -376,7 +376,11 @@ def _resolve_context_path(
         return context
 
     chosen = _choose_best_context_candidate(candidates, dockerfile)
-    rel = os.path.relpath(chosen, compose_dir)
+    try:
+        rel = Path(chosen).relative_to(compose_dir)
+    except ValueError:
+        # relative_to() only works for descendants; relpath preserves ../ segments.
+        rel = Path(os.path.relpath(chosen, compose_dir))
     return Path(rel).as_posix()