zlh-grind/OPEN_THREADS.md

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.

---