Repository navigation
🐛 fix: the wiki's guards read every language a page is written in - #886
Merged
Merged
Conversation
The wiki reads in English, Portuguese, Spanish, French and German, and its guards knew two. An allowance named one page file, so the German, Spanish and French copies of PackageArchitecture, which tell the history their English page is allowed to tell, failed every pull request reading the wiki's master. An allowance now covers every copy of its page, and is stale only when no copy carries the word. The Diagnostics and Capabilities guards read every copy of their page, English and Portuguese still named as the contract, and the Capabilities one fails on a language it has no word for.
The working agreement, the pull request template and the working-agreement spec name the wiki's five languages, and a new page is written in all five.
There was a problem hiding this comment.
🟢 Approval recommended
The implementation consistently satisfies issue #885 and no unresolved defects were found.
0 open findings
What changed in this PR
Corrige os guardas da wiki para validar todas as traduções disponíveis, conforme o issue #885.
Changes:
- Adiciona descoberta e normalização das traduções.
- Valida Diagnostics, Capabilities e vocabulário em todos os idiomas.
- Atualiza o acordo de trabalho e a especificação OpenSpec.
| File | Description |
|---|---|
tests/eQuantic.UI.Web.Tests/WikiClone.cs |
Adiciona helpers para cópias traduzidas. |
tests/eQuantic.UI.Web.Tests/WikiVocabularyTests.cs |
Compartilha allowances entre traduções. |
tests/eQuantic.UI.Web.Tests/WikiDiagnosticsTests.cs |
Valida todas as páginas Diagnostics. |
tests/eQuantic.UI.Web.Tests/WikiShellRealizationsTests.cs |
Valida Capabilities por idioma. |
openspec/specs/working-agreement/spec.md |
Registra os novos requisitos. |
openspec/changes/archive/2026-10-13-the-wiki-reads-in-five-languages/tasks.md |
Registra as tarefas concluídas. |
openspec/changes/archive/2026-10-13-the-wiki-reads-in-five-languages/specs/working-agreement/spec.md |
Arquiva o delta da especificação. |
openspec/changes/archive/2026-10-13-the-wiki-reads-in-five-languages/proposal.md |
Documenta motivação e escopo. |
openspec/changes/archive/2026-10-13-the-wiki-reads-in-five-languages/.openspec.yaml |
Define metadados da mudança. |
docs/LEDGER.md |
Registra o evento e o issue. |
CLAUDE.md |
Atualiza o acordo para cinco idiomas. |
AGENTS.md |
Mantém o acordo sincronizado. |
.github/pull_request_template.md |
Atualiza o checklist de traduções. |
🧠 Review effort: Balanced
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
…ract in all five languages Spanish, French and German copies of the Capabilities page are on their way with #879, and the guard failed on a language whose word it did not know. It knows each one now, as the translated tables write it: nicht verfügbar, no disponible, indisponible.
8 of 9 tasks
9 tasks done
edgarmesquita
pushed a commit
that referenced
this pull request
Oct 13, 2026
Main gained #886. Both wrote the same two places: the pull request template, where each changed one of two lines side by side, and the end of the working agreement's spec, where each added a requirement. Both sides are kept, main's requirement first. The entry of #886 was written into the chronology before this rule, so the comparison failed on it as it should (187 entries where the record had 186), and the chronology is recorded as it is now.
7 of 8 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #885
What
Before: the wiki's guards read two languages.
WikiVocabularyTestsallowed a retired spelling by page file, one entry per language, so the Spanish, French and German copies ofPackageArchitecture, which the wiki's master gained in 7eb1524, failed thetestjob of every pull request whose wiki branch is master.WikiDiagnosticsTestsandWikiShellRealizationsTestsread the English and the Portuguese page by name, so a translation could drift with nothing to see. The working agreement said a wiki page changes in English and Portuguese.After: an allowance names the English page and covers every copy of it, and is stale only when no copy carries the word. The Diagnostics and Capabilities guards read every language the page is written in, the English and the Portuguese page still required, and the Capabilities guard knows the word for an unavailable contract in all five languages and fails on a language whose word it does not know rather than leave it unread.
CLAUDE.md,AGENTS.mdand the pull request template say a wiki page changes in every language it is written in, and a new page is written in all five.For a developer who uses the SDK, nothing changes.
How:
WikiClone.Copies(page)answers every copy of a page with its language, andWikiClone.PageOf(path)answers the English page a copy translates. The three guards read through them.Why
Every open pull request without a wiki branch of its own reads the wiki's master, and since 7eb1524 its
testjob fails onPackageArchitecture-de.md,-es.mdand-fr.md, which tell the same history ofeQuantic.UI.Corethe English page is allowed to tell.OpenSpec
openspec/changes/archive/2026-10-13-the-wiki-reads-in-five-languages/, archived. It modifies theworking-agreementrequirement "The wiki's master moves with main" (every language a page is written in, a new page in all five) and adds "A docs guard reads every language a page is written in".Proof
TheWikiSpeaksTheTreesCurrentNamesfails on main and passes on this branch.eQuantic.UI.Coreadded to a German page, the word removed from every copy ofIcons(its allowance then stale), a GermanDiagnosticspage without theEQ2004row, and a FrenchCapabilitiespage in words the guard does not know for French. The probe was discarded afterwards.eQuantic.UI.Web.Testspasses against the wiki's master (1,047), andWorkflowSectionTestsholds the two copies of the Workflow section equal../scripts/check-openspec.shpasses (57 items), and./scripts/check-commit-messages.shreads the three commits clean.Checklist
dotnet teston the affected test projects, anddotnet build src/eQuantic.UI.Runtime -t:TestRuntimeif TypeScript changed (the embedded Bun runstsc, thenvitest run)build-packages,test (ubuntu-latest),test (windows-latest),openspec,session-start,wiki-checkout)./scripts/check-openspec.shpasses: the OpenSpec change validates strictly, and it is archived before the mergedotnet build samples/DefaultUIDashboard: not affected, the change is to tests and documentsCLAUDE.md,AGENTS.mdand the pull request template here; the wiki does not changedocs/LEDGER.mdline for this event, citing the issue