Add Translation Management guidance, enforce mandatory version bumps, and add version change validation

[Copilot]

ioBroker adapters maintain 11 translation files that desynchronize when npm run translate leaves orphaned keys. Observed in bambulab PR #248.

Translation Management Section

Added template.md:605-757 (153 lines) covering:

• Validation script - Detects orphaned/missing keys by diffing jsonConfig.json labels against all 11 language files
• Workflow - jsonConfig changes → npm run translate → validation → manual cleanup → commit
• Critical rules - No orphaned keys, native language only, alphabetical sort
• 7-point checklist - Pre-commit validation including npm run lint && npm run test
• Pretest chaining guidance - Documents how to merge with existing pretest hooks to avoid overwriting

// Example validation script
const requiredTexts = extractTexts(jsonConfig);
languages.forEach(lang => {
    const translations = JSON.parse(fs.readFileSync(`admin/i18n/${lang}/translations.json`));
    const orphaned = Object.keys(translations).filter(key => !requiredTexts.has(key));
    if (orphaned.length > 0) console.error(`❌ Orphaned keys in ${lang}:`, orphaned);
});

Mandatory Version Bump Process

Updated .github/copilot-instructions.md with strict 3-step workflow:

1. Default action - Auto-bump PATCH +1 (0.5.1 → 0.5.2) via ./scripts/manage-versions.sh update X.Y.Z
2. User validation - Review if MINOR/MAJOR needed instead
3. Verification - Run ./scripts/manage-versions.sh check

No exceptions. Every PR must bump version. PATCH is default for bug fixes, docs, minor improvements. MINOR for new features. MAJOR for breaking changes.

Version Change Enforcement

Created tests/test-version-changed.sh that:

• Compares current version with base branch (main)
• Fails immediately if version not bumped
• Runs FIRST before all other tests (fail-fast approach)
• Provides exact command to fix: ./scripts/manage-versions.sh update X.Y.Z

Modified tests/test-runner.sh to execute version change test before all other tests, preventing unnecessary CI runs when version not bumped.

Documentation Clarifications

• README.md - Clarified that automation system eliminates template update/version-check scripts, while adapter-level quality checks (translation validation, linting, testing) should still be added to package.json
• template.md - Added pretest chaining example to prevent overwriting existing hooks: "pretest": "npm run lint && npm run validate:translations"

Version

Bumped 0.5.1 → 0.5.2 (PATCH) per new guidelines.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Translation files must stay synchronized</issue_title>
<issue_description>adopt https://github.com/DrozmotiX/ioBroker.bambulab/pull/248/changes#diff-227c2c26cb2ee0ce0f46a320fc48fbcbdf21801a57f59161b1d0861e8aad55f5</issue_description>

<agent_instructions>take lessons learned from #81 into new pr</agent_instructions>

Comments on the Issue (you are @copilot in this section)

• Fixes Translation files must stay synchronized #80

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[Copilot]

Pull request overview

Adds new template guidance to help ioBroker adapter maintainers keep admin/i18n/*/translations.json synchronized with admin/jsonConfig.json, addressing the common “orphaned vs missing translation keys” problem when using npm run translate.

Changes:

• Added a “Translation Management” section to template.md with a validation workflow, script example, and checklist.
• Updated README.md to list Translation Management as a template feature.
• Added WORK IN PROGRESS changelog entries documenting the new guidance.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 2 comments.

File	Description
template.md	Adds Translation Management guidance, including a validation script example and suggested package.json wiring.
README.md	Highlights Translation Management as a key template feature.
CHANGELOG.md	Documents the addition in WORK IN PROGRESS entries.