Rename overlay+partition specific env vars

Metadata

Project: craft-parts
Number: #1051
Type: issue
State: open
Author: upils
Labels: —
Created: 2025-03-21 04:13 PM UTC
Updated: 2026-08-30 10:14 PM UTC
Closed: —

Current evaluation

Task to rename partition overlay env vars from $CRAFT_[<namespace>_]<partition>_OVERLAY to $CRAFT_[<namespace>_]<partition>_PART_OVERLAY for consistency with other part-specific vars. Unlabeled, no comments; code still uses the old format.

Suggested action: needs triage

Reason: The issue has no labels, no comments, and no assignee, showing no sign of being categorized or prioritized, despite being filed by a maintainer (upils) and having recent activity 1 day ago. The rename is a breaking API change (environment.py:265,270 still emit CRAFT_<partition>_OVERLAY, and no _PART_OVERLAY variant exists in the codebase), so it needs triage to decide on deprecation/backward-compatibility strategy before work begins.

Impact: 35 Quick Win: 19.25 Staleness: 10 Complexity: 45 Confidence: 75 Support Request: 5

Issue body

### What needs to get done Change the format to `$CRAFT_[<namespace>_]<partition>_PART_OVERLAY` to make it obvious these are part-specific env vars. ### Why it needs to get done Environment variables for partitions are available to overlay scripts, formatted as `$CRAFT_[<namespace>_]<partition>_OVERLAY`. However these variables points to a part-specific directory so their name is inconsistent with other part-specific env variables (ex. `$CRAFT_PART_INSTALL`, `$CRAFT_PART_SRC`), which may be misleading to users using these variables in different parts.

Evaluation history

Date	Model	Scores	Action	Summary
2026-09-01 06:04 AM UTC	qwen/qwen3.8-27b	Impact: 35 Quick Win: 19.25 Staleness: 10 Complexity: 45 Confidence: 75 Support Request: 5	needs triage	Task to rename partition overlay env vars from $CRAFT_[<namespace>_]<partition>_OVERLAY to $CRAFT_[<namespace>_]<partition>_PART_OVERLAY for consistency with other part-specific vars. Unlabeled, no comments; code still uses the old format.
2026-07-22 01:23 PM UTC	qwen/qwen3.6-35b-a3b	Staleness: 95 Complexity: 20 Confidence: 90 Support Request: 5	close stale	Proposes renaming partition-specific overlay environment variables to align naming conventions with other part-specific variables. Currently unlabelled and inactive for over a year.
2026-07-09 09:11 AM UTC	qwen3.6-35b-a3b-mtp-q6	Staleness: 85 Complexity: 20 Confidence: 75 Support Request: 0	needs triage	Rename partition-specific overlay environment variables for naming consistency. Currently untriaged and inactive for over a year.
2026-06-19 06:14 PM UTC	qwen3.6-35b-a3b-mtp-q6	Staleness: 85 Complexity: 15 Confidence: 75 Support Request: 0	close stale	Update partition overlay environment variable naming to $CRAFT_[<namespace>_]<partition>_PART_OVERLAY for consistency. Open, unassigned, awaiting triage.

Update history

Date	Change
2026-08-30 10:14 PM UTC	updated

Related issues

No related issues found above the similarity threshold.