Files
kandev/docs/decisions/INDEX.md
T
José Almeida 041a19f060 feat: service-managed UI self-update (#1210)
* feat: add service-managed self-update

* chore: add temporary self-update test scripts

* chore: simplify temporary script markdown fences

* chore: run frontend in temporary self-update scripts

* fix: show self-update job progress after apply

* chore: add real npm self-update test script

* fix: isolate npm self-update prefix

* fix: detect npm service installs from bin shim

* chore: reset service before real npm update test

* chore: expand real npm status diagnostics

* fix: preserve service home during self-update

* fix(cli): tee self-update helper output to a log file

* fix(cli): avoid launchd bootstrap race when reloading the macOS service

* fix(backend): run macOS self-update helper once via transient launchd plist

* fix(web): show self-update progress and lock the apply button until the update lands

* fix(cli): reinstall via the kandev wrapper on Homebrew self-update

* chore: remove temp self-update test scripts

* fix(web): drop unused apply path from useUpdates hook

* fix(backend): snapshot install state once in apply preflight

* docs: align self-update docs with transient LaunchAgent flow

* chore(release): run cli bundle from apps workspace root

* fix(backend): guard against concurrent self-update applies

* fix(backend): check scheme and helper paths in self-update apply

* fix(backend): drop duplicate binary name from npx manual command

* fix(cli): allow --help for service self-update without --intent

* fix(cli): harden self-update dir perms and darwin uid resolution

* fix(web): set required POST fields last in applyUpdate

* docs: use JSON body notation for the apply endpoint

* fix(backend): expire self-update guard so a stuck helper cannot wedge apply

* refactor(cli): collapse redundant writeSync branch in self-update log
2026-06-01 17:49:15 +01:00

2.1 KiB

Decision Log

Architecture Decision Records (ADRs) for the Kandev project. Each decision captures the context, choice, consequences, and alternatives for significant architectural or design decisions.

Read individual ADRs for full context. Create new ones via /record decision or manually following the template in 0001-file-based-knowledge-system.md.

# Title Status Area Date
0001 File-based knowledge system accepted infra 2026-03-28
0002 Host utility agentctl for sessionless ACP flows accepted backend 2026-04-08
0003 executors_running as the single source of truth for agent_execution_id accepted backend 2026-05-03
0004 Task model unification — shared base, per-strategy meta, shared kernel proposed backend, frontend 2026-05-05
0005 Agent model unification — one agents table proposed backend, frontend 2026-05-06
0006 Tier routing vs cheap_agent_profile_id coexistence superseded backend 2026-05-11
0007 profiles.yaml — runtime defaults for prod / dev / e2e accepted backend, frontend 2026-05-16
0008 DB upgrade safety - meta table, pre-migration backup, migration logging accepted backend 2026-05-16
0009 Fail-closed GC semantics for filesystem and container cleanup accepted backend 2026-05-16
0010 Worktree copy-files — per-repo, idempotent, host-local accepted backend, frontend 2026-05-19
0011 Transient provider errors (529 Overloaded) auto-retry with visible backoff accepted backend, frontend 2026-05-30
0012 Service-only UI self-update accepted backend, frontend, cli 2026-05-29