3.4 KiB
3.4 KiB
id, title, status, wave, depends_on, plan, spec
| id | title | status | wave | depends_on | plan | spec | |
|---|---|---|---|---|---|---|---|
| 03-executor-config-controls | Add executor configuration controls | done | 2 |
|
plan.md | ../../specs/agents/requirements/portable-agent-configuration.md |
Task 03: Add executor configuration controls
Acceptance
- Local Docker, SSH, and Sprites profile forms show each agent's independent bundle checkboxes inside that agent's expanded row and persist
agent_config_bundlesthrough the shared save action. - Visible copy and a warning icon explain secrets, hooks, commands, paths, target replacement, and the SSH shared-home risk.
- Fine pointers use a tooltip, coarse pointers use a drawer, and every touch control meets the 44 CSS pixel target.
TDD scenarios
- RED: Add API-client and parser tests for the bundle response and saved JSON list.
- RED: Add component tests for independence, dirty state, unavailable files, saved missing files, and serialization.
- RED: Add pointer-mode tests for tooltip focus and coarse-pointer drawer behavior.
- GREEN: Add the API types, profile state, save integration, controls, and translated copy.
- REFACTOR: Extract the warning control and bundle list from the existing authentication card.
Verification
cd apps && pnpm --filter @kandev/web test -- --run components/settings/profile-edit lib/api/domainscd apps/web && pnpm run typecheckcd apps/web && pnpm run i18n:checkcd apps/web && pnpm run i18n:ratchetcd apps && pnpm --filter @kandev/web lintgit diff --check
Files likely touched
apps/web/lib/api/domains/settings-api.tsapps/web/components/settings/profile-edit/executor-profile-baselines.tsapps/web/components/settings/profile-edit/remote-credentials-card.tsxapps/web/components/settings/profile-edit/remote-credentials-card.test.tsxapps/web/components/settings/profile-edit/profile-runtime-sections.tsxapps/web/app/settings/executors/[profileId]/page.tsxapps/web/app/settings/executors/new/[type]/page.tsxapps/web/src/locales/en/executors.jsonapps/web/src/locales/pseudo/executors.jsonapps/web/src/locales/pt-pt/executors.jsonapps/web/src/locales/zh-cn/executors.jsonapps/web/src/locales/zh-hk/executors.jsonapps/web/src/locales/zh-tw/executors.json
Dependencies
- Task 01 supplies the HTTP response contract and stable bundle IDs.
Parallelism
Parallel-safe with Task 02 after Task 01. This task owns frontend settings files and locale catalogs.
Inputs
- The catalog response from Task 01.
- The existing remote-credentials card.
- The settings save coordinator.
SleepInhibitionInfoTooltipanduseTouchDraweras interaction examples.
Output contract
Report desktop behavior, mobile behavior, accessibility, translations, RED evidence, GREEN evidence, and test results.
Risks
- The existing remote-credentials card is close to the frontend file-size limit.
- A tooltip-only warning does not meet the visible settings guidance.
- A saved missing source must remain removable.
Results
Implemented independent authentication and configuration controls, persistent bundle IDs, unavailable-source hints, fine-pointer tooltip/coarse-pointer drawer behavior, and translated copy. Configuration choices are now rendered inside the matching expanded agent row instead of a separate global section. Focused frontend tests passed with 25 tests. Web typecheck, lint, i18n check, and i18n ratchet passed.