# Open Threads – zlh-grind

This file tracks items that are unresolved, under investigation, or explicitly deferred.

---

## Devcontainer provisioning failures
- **Status:** RESOLVED (design-level), implementation pending
- Root cause identified as agent execution model:
  - installers require `RUNTIME_VERSION`
  - shared installer logic (`common.sh`) must execute in same shell as runtime installer
- Action:
  - update agent to concatenate embedded scripts into single bash invocation
  - ensure env injection before execution

---

## Artifact naming / layout drift
- **Status:** RESOLVED
- Artifact store standardized to simplified naming (`<runtime>-<version>`).
- Installer logic updated to support `ARCHIVE_PREFIX` to handle cases like Java (`jdk-*`).

---

## Version-aware markers for devcontainer runtimes
- **Status:** OPEN
- Current marker logic does not distinguish between installed runtime versions.
- Follow-up:
  - consider writing installed version metadata to marker file
  - enable clean upgrades (e.g., node 24 → 25)

---

## Agent execution abstraction cleanup
- **Status:** OPEN
- Embedded script execution lacks explicit contract for:
  - env overlay
  - timeout
  - structured error classification
- Deferred to next sprint after installer stabilization.

---

## API → agent contract enforcement
- **Status:** OPEN
- API must continue enforcing runtime + version explicitly.
- Agent must remain sole translator of intent → execution environment.

---