feat(rebrand): ChoreOps rebrand progress

What changed:

Migrated dashboard namespace from kcd- to cod- with legacy compatibility handling for existing URLs and discovery.
Rebranded user-facing copy across translations, notifications, and dashboard templates; updated functional template domain calls to choreops.
Finalized Phase 2 utility/reference updates and Phase 3 cleanup (agent docs + CI brand-regression guard).
Hardened workflows for Phase 5: added Crowdin secret preflight/skip logic and clearer HACS prerequisite guidance.
Updated in-process rebrand plan progress and blockers based on workflow validation findings.
Why it matters:

Completes the public/runtime rebrand path while protecting existing installs during transition.
Reduces false CI failures and makes external dependency blockers explicit.
Brings release readiness forward with validated lint/type/boundary checks and full pytest pass via python -m pytest.

Author: ccpk1

.github/agents/ChoreOps Builder.agent.md

@@ -230,7 +230,7 @@ Why it matters:
 - **Ask if unsure**: Don't waste time comparing - just ask user for scope confirmation
   | Logging | `LOGGER.debug("val: %s", var)` — no f-strings |
   | Types | 100% hints, `str \| None` not `Optional[str]` |
-  | Storage | `.storage/kidschores_data`, never `config_entry.data` |
+  | Storage | `.storage/choreops/choreops_data`, never `config_entry.data` |
 
 ## Validation Gates (Required)
 

.github/agents/ChoreOps Strategist.agent.md

@@ -166,7 +166,7 @@ Before delivering plan:
 
 ### Schema Changes
 
-If plan affects `.storage/kidschores_data`:
+If plan affects `.storage/choreops/choreops_data`:
 
 1. Note SCHEMA_VERSION increment in Phase 1
 2. Add migration step: `_migrate_to_v{VERSION}()`

.github/workflows/lint-validation.yaml

@@ -37,6 +37,15 @@ jobs:
           pip install ruff mypy pytest pytest-asyncio pytest-homeassistant-custom-component
           pip install types-python-dateutil types-PyYAML
 
+      - name: Brand regression guard
+        run: |
+          set -euo pipefail
+          if grep -RInE "ad-ha/kidschores-ha|kidschores-ha-dashboard" \
+            .github README.md pyproject.toml hacs.json custom_components/choreops/manifest.json; then
+            echo "❌ Deprecated KidsChores branding string found in active project files"
+            exit 1
+          fi
+
       - name: Run Quick Lint
         run: |
           chmod +x ./utils/quick_lint.sh

.github/workflows/translation-sync-manual.yaml

@@ -40,8 +40,24 @@ jobs:
         with:
           ref: ${{ inputs.branch || github.ref_name }}
 
+      - name: Validate Crowdin configuration
+        id: crowdin_preflight
+        env:
+          CROWDIN_PROJECT_ID: ${{ secrets.CROWDIN_PROJECT_ID }}
+          CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_PERSONAL_TOKEN }}
+        run: |
+          if [ -z "$CROWDIN_PROJECT_ID" ] || [ -z "$CROWDIN_PERSONAL_TOKEN" ]; then
+            echo "run_crowdin=false" >> "$GITHUB_OUTPUT"
+            echo "::warning::Crowdin secrets are not configured. Skipping translation sync."
+            echo "::notice::Set CROWDIN_PROJECT_ID and CROWDIN_PERSONAL_TOKEN repository secrets to enable this workflow."
+          else
+            echo "run_crowdin=true" >> "$GITHUB_OUTPUT"
+            echo "::notice::Crowdin secrets detected. Translation sync will run."
+          fi
+
       # STEP 1: Upload Sources
       - name: Upload Sources
+        if: steps.crowdin_preflight.outputs.run_crowdin == 'true'
         uses: crowdin/github-action@v2
         with:
           upload_sources: true
@@ -56,6 +72,7 @@ jobs:
       # STEP 2: Trigger Google Translate (MT) via Crowdin CLI
       # This auto translate service has a cost associated with it, so it may be stopped or disabled in the future.
       - name: Trigger Google Translate
+        if: steps.crowdin_preflight.outputs.run_crowdin == 'true'
         run: |
           npm install -g @crowdin/cli
           crowdin pre-translate \
@@ -68,6 +85,7 @@ jobs:
 
       # STEP 3: Download & Create PR
       - name: Download Translations
+        if: steps.crowdin_preflight.outputs.run_crowdin == 'true'
         uses: crowdin/github-action@v2
         with:
           upload_sources: false
@@ -81,3 +99,8 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           CROWDIN_PROJECT_ID: ${{ secrets.CROWDIN_PROJECT_ID }}
           CROWDIN_PERSONAL_TOKEN: ${{ secrets.CROWDIN_PERSONAL_TOKEN }}
+
+      - name: Crowdin sync skipped
+        if: steps.crowdin_preflight.outputs.run_crowdin != 'true'
+        run: |
+          echo "Crowdin sync skipped: repository secrets are not configured yet."

.github/workflows/validate.yaml

@@ -14,6 +14,11 @@ jobs:
     if: github.repository == 'ccpk1/choreops' && (github.ref == 'refs/heads/main' || github.event_name == 'pull_request')
     steps:
       - uses: "actions/checkout@v3"
+      - name: HACS prerequisite guidance
+        run: |
+          echo "::notice::HACS validation requires a valid integration manifest at custom_components/choreops/manifest.json and a valid hacs.json file."
+          echo "::notice::The brands check also requires this integration to be registered in the Home Assistant brands repository custom domain catalog."
+          echo "::notice::If brands registration is pending, HACS may fail even when local lint/tests pass."
       - name: HACS validation
         uses: "hacs/action@main"
         with:

README.md

@@ -39,18 +39,20 @@ Strip away the game layer entirely. Use the **Enterprise-Grade Scheduling** and
 
 **The best of both worlds.** Configure some profiles with full gamification to drive engagement, while keeping other profiles strictly utilitarian.
 
----
-
 <p align="center">
   <b>No subscription. No cloud lock-in. 100% local on your Home Assistant instance.</b>
 </p>
 
+---
+
 > **Attribution & Legacy**<br>
 > ChoreOps is the official evolution of the **KidsChores** integration. While the original project is now deprecated, its concepts and features grew into this new system to better serve the entire Home Assistant community—expanding the scope beyond just "kids" to the whole household.
 >
 > The original creator, **@ad-ha**, remains involved with this progression and continues to inspire the project's direction.<br>
 > 🔄 **Coming from KidsChores?** We have a direct migration path to move your data over. **[View the Migration Guide →](https://github.com/ccpk1/choreops/wiki/Migration)**
 
+---
+
 ## Key capabilities
 
 - 🧠 **Intelligent logic**: sophisticated recurring schedules, first-come-first-served pools, per-kid schedules, and complex rotation algorithms

custom_components/choreops/__init__.py

@@ -226,7 +226,7 @@ async def async_setup_entry(hass: HomeAssistant, entry: KidsChoresConfigEntry) -
         )
 
     # Dashboard storage dedupe (v0.5.0 migration safety)
-    # Remove stale duplicate kcd-* records to prevent Lovelace panel collisions
+    # Remove stale duplicate cod-/kcd- records to prevent Lovelace panel collisions
     # on subsequent Home Assistant startups.
     try:
         from .helpers import dashboard_builder as dbuilder

custom_components/choreops/config_flow.py

@@ -246,7 +246,9 @@ async def _handle_use_current(self):
         if not result.get("prepared"):
             error_key = result.get("error")
             if error_key == "file_not_found":
-                return self.async_abort(reason=const.TRANS_KEY_CFOP_ERROR_FILE_NOT_FOUND)
+                return self.async_abort(
+                    reason=const.TRANS_KEY_CFOP_ERROR_FILE_NOT_FOUND
+                )
             if error_key == "corrupt_file":
                 return self.async_abort(reason=const.TRANS_KEY_CFOP_ERROR_CORRUPT_FILE)
             if error_key == "invalid_structure":
@@ -465,10 +467,14 @@ async def async_step_paste_json_input(
                         }
 
                         # Write to storage file
-                        storage_path = Path(KidsChoresStore(self.hass).get_storage_path())
+                        storage_path = Path(
+                            KidsChoresStore(self.hass).get_storage_path()
+                        )
 
                         await self.hass.async_add_executor_job(
-                            lambda: storage_path.parent.mkdir(parents=True, exist_ok=True)
+                            lambda: storage_path.parent.mkdir(
+                                parents=True, exist_ok=True
+                            )
                         )
 
                         # Write wrapped data to storage (directory created by HA/test fixtures)

custom_components/choreops/const.py

@@ -114,8 +114,10 @@ def set_default_timezone(hass):
 # Schema version for template context structure (bump when context dict changes)
 DASHBOARD_TEMPLATE_SCHEMA_VERSION: Final = 1
 
-# URL path prefix for generated dashboards (e.g., kcd-alice, kcd-admin)
-DASHBOARD_URL_PATH_PREFIX: Final = "kcd-"
+# URL path prefix for generated dashboards (e.g., cod-alice, cod-admin)
+DASHBOARD_URL_PATH_PREFIX: Final = "cod-"
+# Legacy URL prefix retained during compatibility window
+DASHBOARD_LEGACY_URL_PATH_PREFIX: Final = "kcd-"
 
 # Available dashboard styles
 DASHBOARD_STYLE_FULL: Final = "full"
@@ -141,13 +143,15 @@ def set_default_timezone(hass):
 
 # Supported release-tag grammar (parser contract)
 # Accepted examples:
+#   - COD_v0.5.0_beta3
+#   - COD_v0.5.0-beta3
 #   - KCD_v0.5.0_beta3
 #   - KCD_v0.5.0-beta3
 #   - v0.5.0-beta3
 #   - v0.5.4
 #   - 0.5.4
 DASHBOARD_RELEASE_TAG_PATTERN: Final = (
-    r"^(?:(?:KCD_)?v)?(?P<major>\d+)\.(?P<minor>\d+)\.(?P<patch>\d+)"
+    r"^(?:(?:KCD_|COD_)?v)?(?P<major>\d+)\.(?P<minor>\d+)\.(?P<patch>\d+)"
     r"(?:(?:_|-)?(?P<pre_label>beta|b)(?P<pre_num>\d+))?$"
 )
 

custom_components/choreops/helpers/dashboard_builder.py

@@ -68,8 +68,8 @@ class DashboardReleaseTag:
     """Normalized representation of a supported dashboard release tag.
 
     Supported formats:
-            - `KCD_vX.Y.Z` / `vX.Y.Z` / `X.Y.Z`
-            - `KCD_vX.Y.Z_betaN` / `KCD_vX.Y.Z-betaN` / `vX.Y.Z-betaN`
+            - `COD_vX.Y.Z` / `KCD_vX.Y.Z` / `vX.Y.Z` / `X.Y.Z`
+            - `COD_vX.Y.Z_betaN` / `COD_vX.Y.Z-betaN` / `vX.Y.Z-betaN`
     """
 
     raw_tag: str
@@ -596,10 +596,20 @@ def get_multi_view_url_path(dashboard_name: str) -> str:
         dashboard_name: User-specified dashboard name (e.g., "Chores").
 
     Returns:
-        Slugified URL path with kcd- prefix (e.g., "kcd-chores").
+        Slugified URL path with cod- prefix (e.g., "cod-chores").
     """
     slug = slugify(dashboard_name.lower())
-    return f"kcd-{slug}"
+    return f"{const.DASHBOARD_URL_PATH_PREFIX}{slug}"
+
+
+def _is_choreops_dashboard_url_path(url_path: str) -> bool:
+    """Return True for current or legacy ChoreOps dashboard URL paths."""
+    return url_path.startswith(
+        (
+            const.DASHBOARD_URL_PATH_PREFIX,
+            const.DASHBOARD_LEGACY_URL_PATH_PREFIX,
+        )
+    )
 
 
 def _get_collection_items(collection: DashboardsCollection) -> list[dict[str, Any]]:
@@ -623,7 +633,7 @@ def check_dashboard_exists(hass: HomeAssistant, url_path: str) -> bool:
 
     Args:
         hass: Home Assistant instance.
-        url_path: Dashboard URL path to check (e.g., "kcd-alice").
+        url_path: Dashboard URL path to check (e.g., "cod-alice").
 
     Returns:
         True if dashboard exists, False otherwise.
@@ -648,7 +658,7 @@ async def async_check_dashboard_exists(hass: HomeAssistant, url_path: str) -> bo
 
     Args:
         hass: Home Assistant instance.
-        url_path: Dashboard URL path to check (e.g., "kcd-alice").
+        url_path: Dashboard URL path to check (e.g., "cod-alice").
 
     Returns:
         True if dashboard exists, False otherwise.
@@ -689,7 +699,7 @@ async def async_dedupe_kidschores_dashboards(
         item_url_path = item.get(CONF_URL_PATH)
         if not isinstance(item_url_path, str):
             continue
-        if not item_url_path.startswith(const.DASHBOARD_URL_PATH_PREFIX):
+        if not _is_choreops_dashboard_url_path(item_url_path):
             continue
         if url_path and item_url_path != url_path:
             continue
@@ -772,7 +782,7 @@ async def create_kidschores_dashboard(
         icon: Dashboard icon.
 
     Returns:
-        The URL path of the created dashboard (e.g., "kcd-chores").
+        The URL path of the created dashboard (e.g., "cod-chores").
 
     Raises:
         DashboardExistsError: If dashboard exists and force_rebuild is False.
@@ -1282,15 +1292,15 @@ async def delete_kidschores_dashboard(
 
     Args:
         hass: Home Assistant instance.
-        url_path: Dashboard URL path (e.g., "kcd-alice").
+        url_path: Dashboard URL path (e.g., "cod-alice").
 
     Raises:
         DashboardSaveError: If deletion fails.
     """
     if hass.config.recovery_mode:
         raise DashboardSaveError("Cannot delete dashboards in recovery mode")
 
-    if not url_path.startswith("kcd-"):
+    if not _is_choreops_dashboard_url_path(url_path):
         raise DashboardSaveError(f"Cannot delete non-KidsChores dashboard: {url_path}")
 
     await _delete_dashboard(hass, url_path)