ci: add file hygiene workflow and canonical config templates

[yshyn-iohk]

Summary

Implements file hygiene linting for cloud-agent as part of the org-wide rollout (hyperledger-identus/hyperledger-identus#172).

1. CI workflow and lint configuration

• Add file-hygiene.yml caller workflow invoking the reusable lint-files.yml from hyperledger-identus/.github
• Add canonical .gitattributes, .editorconfig, .markdownlint.yml, .yamllint.yml, .shellcheckrc
• Add .markdownlint-cli2.yaml with ignore patterns for generated/vendored files (API clients, node_modules, Helm charts, OpenAPI spec)

2. Changelog cleanups

• Remove outdated CHANGELOG.md from 6 subdirectories (castor, cloud-agent/service, connect, mercury, pollux, prism-node/client/scala-client)
• Root CHANGELOG.md is the single source of truth

3. Lint fixes across the repo (65 files)

• Markdownlint auto-fix (~1000 issues): trailing spaces, blank lines around headings/lists/fences, multiple blank lines
• Manual markdown fixes: table alignment (MD060), broken anchor links (MD051), numbered list continuity (MD029), blockquote formatting (MD028)
• YAML fixes: missing final newlines, trailing spaces
• ShellCheck fixes: separate declare/assign (SC2155), cd without exit (SC2164), export unused var (SC2034)

4. .git-blame-ignore-revs

• Add the mass formatting commit to blame ignore list so git blame skips past formatting-only changes

5. Maintainers update

• Add Fabio Pinheiro and Allain Magyar to active maintainers
• Update Pat Losoponkul GitHub ID (patlo-iog → patextreme)
• Move Björn Sandmann, David Poltorak, and Shailesh Patil to emeritus
• Fix GitHub team name (open-enterprise-agent-maintainers → identus-maintainers)
• Update company affiliation from IOHK to IOG

Scalafmt compatibility

No conflict — scalafmt (2-space indent, maxColumn = 120) and editorconfig-checker operate at different levels. See analysis comment.

Test plan

• File Hygiene (editorconfig) — passing
• Markdown lint — passing (0 errors)
• YAML lint — passing
• ShellCheck — passing
• SonarCloud — passing

🤖 Generated with Claude Code

[yshyn-iohk]

Scalafmt vs EditorConfig Conflict Analysis

No conflict. Here's why:

Setting	.editorconfig	.scalafmt.conf	Conflict?
Indent size	2 spaces (from [*])	2 spaces (scalafmt default)	No
Indent style	spaces	spaces (scalafmt default)	No
Max line length	not set	maxColumn = 120	No — different tools, different scope
Charset	UTF-8 (no BOM)	n/a	No
Line endings	LF	n/a	No

Scalafmt and editorconfig-checker operate at different levels: scalafmt reformats Scala AST (imports, alignment, wrapping), while editorconfig-checker validates raw file bytes (BOM, line endings, trailing whitespace). They don't step on each other.

[github-actions]

Integration Test Results (prism-node)

1 tests  ±0   1 ✅ ±0   2s ⏱️ ±0s
1 suites ±0   0 💤 ±0 
1 files   ±0   0 ❌ ±0 

Results for commit fd6a3c3. ± Comparison against base commit d0f1b19.

♻️ This comment has been updated with latest results.

[github-actions]

Integration Test Results

 23 files  ±0   23 suites  ±0   4s ⏱️ ±0s
 58 tests ±0   58 ✅ ±0  0 💤 ±0  0 ❌ ±0 
106 runs  ±0  106 ✅ ±0  0 💤 ±0  0 ❌ ±0 

Results for commit fd6a3c3. ± Comparison against base commit d0f1b19.

♻️ This comment has been updated with latest results.

[github-actions]

Unit Test Results

113 files  ±0  113 suites  ±0   24m 6s ⏱️ +16s
927 tests ±0  919 ✅ ±0  8 💤 ±0  0 ❌ ±0 
934 runs  ±0  926 ✅ ±0  8 💤 ±0  0 ❌ ±0 

Results for commit fd6a3c3. ± Comparison against base commit d0f1b19.

♻️ This comment has been updated with latest results.

[yshyn-iohk]

Lint Triage Summary

Linter	Errors	Warnings	Files	Status
File Hygiene (editorconfig)	0	0	-	✅ Passed
Markdown	1209	0	77	❌ Failed
YAML	~100	~656	~30	❌ Failed
ShellCheck	18	0	~8	❌ Failed

Markdown — Top errors (auto-fixable marked with 🔧)

Rule	Count	Auto-fix?
MD012 — multiple blank lines	241	🔧
MD032 — blanks around lists	213	🔧
MD022 — blanks around headings	213	🔧
MD001 — heading increment (h1→h3)	187	Config: mostly CHANGELOG.md files
MD031 — blanks around fences	99	🔧
MD042 — empty links	34	Manual
MD036 — emphasis as heading	34	Manual
MD009 — trailing spaces	25	🔧
MD040 — code block language	24	Manual
MD041 — first line not heading	20	Config: MD041: false
MD060 — table alignment	19	Manual

~800 of 1209 errors are auto-fixable with markdownlint-cli2 --fix.

YAML — Top errors

Rule	Count	Action
document-start (missing ---)	~55	Config: document-start: disable
syntax errors (braces/indent)	~30	Mostly in OpenAPI spec and Helm templates — need exclusions
comments spacing	~30	Config: comments: {min-spaces-from-content: 1}

Most YAML warnings are config-fixable. Syntax errors come from Helm templates (Go templating in YAML) and large OpenAPI specs which need to be excluded from yamllint.

ShellCheck — 18 warnings across 8 files

Rule	Count	Description
SC2221/SC2222	10	Case pattern overrides (benign)
SC2155	3	Declare and assign separately
SC3045	2	POSIX ulimit (in gradlew — generated file)
SC2034	2	Unused variable
SC2164	1	cd without

Strategy: Config fixes + --fix auto-fix first, then manual fixes for the remaining ~400 issues. Generated files (gradlew, OpenAPI spec) should be excluded.

[FabioPinheiro]

Please split it in three commits:
1- Code/Files
2- Auto generated changes
3- Add the second commit to the .git-blame-ignore-revs
Don't squash the commits when merging

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[yshyn-iohk]

Thanks, @FabioPinheiro, for the nice recommendation about adding autoformatted changes to .git-blame-ignore-revs.

[FabioPinheiro]

but now you can't squash merge. And if you rebase you need to update the commit id on .git-blame-ignore-revs

[yshyn-iohk]

All commits from this PR were rebased on the main branch with the correction of the .git-blame-ignore-revs file.
The local main branch was pushed by the repository administration to the origin.