Skip to content

fix: restore the external names the hierarchy rename rewrote - #107

Merged
ExtraToast merged 1 commit into
mainfrom
fix/rename-external-identifiers
Sep 14, 2026
Merged

ExtraToast merged 1 commit into
mainfrom
fix/rename-external-identifiers

Conversation

@ExtraToast

Copy link
Copy Markdown
Contributor

Follows #100. Found while starting #82.

What this branch does

The hierarchy rename in #100 replaced Service, Workload and domain in their model sense. It also rewrote names that belong to other systems and happen to contain the word "service". Those names are not model vocabulary and must keep their spelling, because a reader copies them into a manifest, a policy or a search. This branch restores them, in 22 files, and changes nothing else.

restored owned by was rewritten to
serviceAccountName, .spec.serviceAccountName Kubernetes applicationAccountName
${identity:serviceAccount}, serviceAccount: the identity placeholder and resolved field naming the Kubernetes ServiceAccount applicationAccount
bound_service_account_names, bound_service_account_namespaces Vault's Kubernetes auth role bound_application_account_*
OTEL_SERVICE_NAME OpenTelemetry OTEL_APPLICATION_NAME
CAP_NET_BIND_SERVICE, NET_BIND_SERVICE Linux capabilities CAP_NET_BIND_APPLICATION
service-overview, service-template the estate's Grafana dashboards application-overview, application-template
kubernetes-workload-fragment, src/deployment/render/workloads.ts, src/schemas/service-intent.ts, ServicePermission.kt, service.yml evidence citing files in deploy-config-schema and another repository, as they were named the renamed words
review/PLACEMENT-DOMAIN-MANIFEST.md a file under review/, which the rename did not touch PLACEMENT-PROJECT-MANIFEST.md

Verification

  • git show 7855d44^ was the source for every restored spelling.
  • git grep -E 'applicationAccount|bound_application_account|OTEL_APPLICATION_NAME|NET_BIND_APPLICATION|ApplicationPermission|kubernetes-process-fragment|PLACEMENT-PROJECT-MANIFEST' finds nothing.
  • Uppercase words the rename produced were all checked: the remaining ones are either new error codes (E_DUPLICATE_APPLICATION_ID and its siblings) or emphasis in comments (one per PROCESS).
  • npm run verify exit 0, 313 tests; link lint: 175 files clean.

@ExtraToast ExtraToast added type: bug Something is broken or behaving incorrectly. area: deploy homelab-deploy, deploy-v2, manifests, and rollout flow. component: docs Runbook, README, API docs, or documentation tooling. labels Sep 14, 2026
@ExtraToast ExtraToast self-assigned this Sep 14, 2026
@ExtraToast
ExtraToast merged commit 99751d5 into main Sep 14, 2026
18 checks passed
@ExtraToast
ExtraToast deleted the fix/rename-external-identifiers branch September 14, 2026 17:10
ExtraToast added a commit that referenced this pull request Sep 15, 2026
…er 10 (#119)

* docs: fix the platform example README's leftover Traefik Application and missing hardening row

The tiers table cell still read "Application" where #100's rename should
have left the Kubernetes Service alone; #107 restored other external
spellings but missed this one. Also add the row for platform.intent.yml's
hardening block, which the table never carried: one posture for every
container, no per-control exception surface, decided by 0016.

* docs: stop the data example's rendered README from writing alertClass: none

Chapter 10 is explicit that Alert Class has no none member: an omitted
observability block already says "no monitoring", and a member that means
"I wrote the field to say I did not want the field" is ceremony. valkey's
row said the Application "declares alertClass: none", which is not a value
this schema accepts; it declares no observability block at all.

* docs: make the negative fixtures' missing .project.yml suffix a stated convention

spec/v1/examples/negative/*/intent*/ fixtures stand in for Intent Fragments
already handed to composition, not files in a repository's platform/ tree,
and renaming them to .project.yml would pull them into three tests that
discover project files by that suffix, at least one of them
(duplicate-process-name) failing where those tests expect every file to
parse clean. Renaming is left for its own change; this commit instead
states the convention in chapter 10 so the suffix difference reads as a
rule rather than an oversight, and none of the three tests' selections
move: 14 .project.yml files for the diagram test, 4 cases for the Project
Intent test, and (by inspection of its source, without running Maven) 4
files for the EMF worked-examples test, which walks the same suffix
excluding refusals/.

* docs: finish the hierarchy rename in chapter 10's selector sentence

The label-set section's hypothetical alternate labelling reads "would make
every Process of a multi-Process Service selector-ambiguous". Before #100
this said "multi-Workload Service"; the rename converted Workload to
Process but left this one "Service" unconverted, where it names what the
estate now calls an Application (compare "a two-Process Application" in
chapter 30) rather than a Kubernetes Service, which the surrounding
paragraph never mentions: it is about a Deployment's pod selector. It now
reads "multi-Process Application".

Re-grepped spec/v1/*.md for Service used as the retired hierarchy word: the
three remaining occurrences (10-project-intent.md's IngressRoute paragraph,
30-deliverables.md's adapter table, 16-dependencies.md's diagram node) are
all the Kubernetes object and are left alone.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: deploy homelab-deploy, deploy-v2, manifests, and rollout flow. component: docs Runbook, README, API docs, or documentation tooling. type: bug Something is broken or behaving incorrectly.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant