Fix #360: org rename ruling (display-name-only) #367

Merged

crueber merged 1 commit from fix/issue-360 into main

2026-09-12 01:19:54 +00:00

crueber commented

2026-09-12 01:19:00 +00:00

Owner

Docs-only ruling per the #360 decision ticket (survey #349 candidate 1): org rename is display-name-only for v1.

Org id (slug) is immutable: keys are orgs// (org.json, members.json, teams/.json, invitations) with no rename service, and every repos// owner segment is pinned; a rename-with-redirect must move all of those under CAS plus rewrite team: subjects — expensive and CAS-heavy for a rare operation.
DisplayName on org.json is already editable via PUT /api/v1/orgs/{org} (PutOrg, verified in internal/identity/orgs.go), so display-name-only needs no new surface.
Verified no doc or web/src UI affordance promises an org rename (grep rename across docs/ + web/src: only filesystem tmp+rename, git rename detection, label delete+create, repo transfer+rename).
Revisit only on a concrete rename need.

Change: 11-line Decisions entry appended in docs/features/01_identity_permissions.md (AGENTS.md law 12). No code changes. Fixes #360.

Docs-only ruling per the #360 decision ticket (survey #349 candidate 1): org rename is display-name-only for v1. - Org id (slug) is immutable: keys are orgs/<org>/ (org.json, members.json, teams/*.json, invitations) with no rename service, and every repos/<org>/* owner segment is pinned; a rename-with-redirect must move all of those under CAS plus rewrite team: subjects — expensive and CAS-heavy for a rare operation. - DisplayName on org.json is already editable via PUT /api/v1/orgs/{org} (PutOrg, verified in internal/identity/orgs.go), so display-name-only needs no new surface. - Verified no doc or web/src UI affordance promises an org rename (grep rename across docs/ + web/src: only filesystem tmp+rename, git rename detection, label delete+create, repo transfer+rename). - Revisit only on a concrete rename need. Change: 11-line Decisions entry appended in docs/features/01_identity_permissions.md (AGENTS.md law 12). No code changes. Fixes #360.

crueber added 1 commit

2026-09-12 01:19:01 +00:00

Fix #360 : org rename ruling (display-name-only for v1) bbd475c7a1

docs/features/01_identity_permissions.md Decisions: the org id (slug)
is immutable (orgs/<org>/ keys + repos/<org>/* owner segments pinned;
a rename-with-redirect would move all of those under CAS). DisplayName
is already editable via PUT, so display-name-only needs no new surface;
no doc or web/src UI affordance promises a rename (verified). Revisit
only on a concrete rename need. Survey: #349 candidate 1. No code changes.

crueber referenced this pull request

2026-09-12 01:19:02 +00:00

Org rename: decide rename-with-redirect vs display-name-only #360

crueber referenced this pull request

2026-09-12 01:19:42 +00:00

Org rename: decide rename-with-redirect vs display-name-only #360

crueber merged commit 5fd2c74ad1 into main

2026-09-12 01:19:54 +00:00

crueber referenced this pull request

2026-09-12 01:19:55 +00:00

Org rename: decide rename-with-redirect vs display-name-only #360

crueber referenced this pull request from a commit