headquarter/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/proposal.md at fix/git-mount-refresh-feedback

Files

T

Developer caadd59441 chore: archive 15 completed OpenSpec changes

Move the following audited-and-implemented changes into
openspec/changes/archive/2026-06-12-completed-changes-archive/:

- backend-frontend-refactoring
- config-profile-git-mounts
- config-profile-includes-ui
- config-profile-multi-repo-mounts
- container-monitoring-notifications
- git-mount-url-validation
- home-path-expansion
- mobile-terminal-ux
- mount-specificity-ordering
- notification-center
- persistent-terminal-sessions
- session-list-overhaul
- ssh-key-mounting
- terminal-fullscreen-unified-header
- tool-session-progress-and-updates

Also regenerated .pi-map*.md files for openspec/changes so the
remaining active changes (multi-session-terminal-ux, reorganize-long-files,
working-copies, workspace-first-ui) reflect the new layout.

2026-06-12 14:26:55 +00:00

1.7 KiB

Raw Permalink Blame History

Why

The config profiles feature supports ordered profile composition via the includes system (A includes B then C, resolution applies B → C → A), but this capability is completely invisible to users. They can create and edit individual profiles, but cannot see, add, remove, or reorder the profiles their configuration depends on. Without a UI for profile composition, users cannot build reusable config layers (e.g., an "Auth" profile + "Database" profile → "Full Stack" profile), which was a core design goal of the config profiles feature.

What Changes

Add a drag-and-drop includes management section to the config profile editor
Display current includes with scope badges (Global, Project, Tool scoped)
Allow adding includes via dropdown filtered by compatibility
Allow removing includes
Reorder includes via drag-and-drop (order affects resolution priority)
Save includes together with the main profile form
Add frontend cycle detection to prevent adding profiles that would create an include cycle
Update profile list items to show include count badge

Capabilities

New Capabilities

config-profile-includes-management: Managing ordered profile includes through the UI, including adding, removing, reordering, and visualizing the composition graph with scope indicators

Modified Capabilities

(none — backend APIs already fully support includes)

Impact

Frontend: apps/web/src/pages/config-profiles.tsx — add includes management UI section
Frontend: apps/web/src/api/config_profiles.ts — already has updateProfileIncludes(), no changes needed
Backend: No changes required — PUT /config-profiles/{id}/includes and cycle detection already exist
No breaking changes

1.7 KiB Raw Permalink Blame History

Why