Files
Developer 1e0f95f8bd chore: archive completed OpenSpec changes
Move the following audited-and-implemented changes into
openspec/changes/archive/2026-06-12-completed-changes-archive/:

- tool-config-mount-cleanup
- config-profile-directory-mounts

Update archive README count and project map index/files accordingly.
openspec/changes/ now contains only the archive directory.

Quality gates: pytest 313 passed/34 skipped, npm run typecheck/lint clean,
npm test -- --run 87 passed
2026-06-13 14:24:30 +00:00

1.5 KiB

Tool config mount cleanup

Problem

The built-in tool definitions currently declare configuration and state mounts that belong in user-controlled config profiles:

  • The pi-agent manifest mounts pi_state (/tmp/.pi/agents) and pi_config (/home/user/.pi) via a git_mount reference.
  • The opencode built-in compose template mounts a named volume opencode_home:/tmp and sets HOME=/tmp.

These require manual configuration or implicit state persistence, which conflicts with the design that tool configs should only set up the actual tool, while config profiles handle user-specific configuration and state.

Decision

Remove all configuration/state mounts from built-in tool definitions. Tool configs will declare only:

  • Runtime environment (packages, user, command, ports).
  • The workspace/repository mount.
  • SSH key mounts supplied by the platform.

User-specific configuration and state will be handled exclusively by config profiles.

Scope

  • Remove pi_state and pi_config mounts from the pi-agent manifest.
  • Update the original migration that inserts the pi-agent manifest.
  • Add a data migration to remove those mounts from existing tool_definition_manifests rows.
  • Remove the opencode_home:/tmp volume and HOME=/tmp override from the opencode built-in compose template.

Non-goals

  • No changes to config profile behavior.
  • No changes to workspace or SSH key mounts.
  • No changes to tool image Dockerfiles beyond what is required by mount removal.