feat: backup bridge plugin to detect MokoSuiteBackup (#208) #209

Merged

jmiller merged 5 commits from feature/208-backup-bridge into dev 2026-06-18 19:54:35 +00:00

Conversation 0 Commits 5 Files Changed 8

+376 -14

jmiller commented 2026-06-18 15:46:29 +00:00

Owner

Copy Link

Copy Source

Summary

• New plugin plg_system_mokosuiteclient_backup — bridge between MokoSuiteBackup and MokoSuiteClient heartbeats
• Detects MokoSuiteBackup via #__extensions lookup
• Prefers BackupStatusHelper API when available, falls back to direct table query for older versions
• Subscribes to onMokoSuiteClientCollectHeartbeat event to inject backup data into heartbeat payloads
• Registered in pkg_mokosuiteclient.xml
• Configurable stale threshold (default 7 days)
• Graceful degradation when MokoSuiteBackup is not installed

Files

• plg_system_mokosuiteclient_backup/ — full plugin scaffold (manifest, provider, extension class, language files)
• pkg_mokosuiteclient.xml — package registration

Related

• MokoSuiteClient#208
• MokoSuiteBackup#47 — Status helper (dependency)
• MokoSuiteHQ#39 — Dashboard display

## Summary - New plugin `plg_system_mokosuiteclient_backup` — bridge between MokoSuiteBackup and MokoSuiteClient heartbeats - Detects MokoSuiteBackup via `#__extensions` lookup - Prefers `BackupStatusHelper` API when available, falls back to direct table query for older versions - Subscribes to `onMokoSuiteClientCollectHeartbeat` event to inject backup data into heartbeat payloads - Registered in `pkg_mokosuiteclient.xml` - Configurable stale threshold (default 7 days) - Graceful degradation when MokoSuiteBackup is not installed ## Files - `plg_system_mokosuiteclient_backup/` — full plugin scaffold (manifest, provider, extension class, language files) - `pkg_mokosuiteclient.xml` — package registration ## Related - [MokoSuiteClient#208](https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteClient/issues/208) - [MokoSuiteBackup#47](https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteBackup/issues/47) — Status helper (dependency) - [MokoSuiteHQ#39](https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteHQ/issues/39) — Dashboard display

jmiller added 3 commits 2026-06-18 15:46:29 +00:00

feat(backup): scaffold backup bridge plugin (#208) ... 559db324cb

Add plg_system_mokosuiteclient_backup — detects MokoSuiteBackup and
collects backup status for heartbeat payloads to MokoSuiteHQ.

Scaffolding includes manifest, service provider, extension class,
and language files. Table column names are placeholders pending
MokoSuiteBackup schema confirmation (MokoSuiteBackup#47).

fix: swap demo/sync plugin manifests — contents were in wrong files ... 0d731eafd0

The merge rename accidentally swapped the XML manifest contents between
plg_task_mokosuiteclientdemo and plg_task_mokosuiteclientsync. The demo
manifest contained the sync element/name/namespace and vice versa,
causing JInstaller to look for mokosuiteclientsync.xml inside the demo
plugin zip.

feat(backup): use real MokoSuiteBackup schema and prefer BackupStatusHelper (#208) ... bca879f0d3

Update bridge to use correct column names (backupstart/backupend,
status values: complete/fail/running/pending). Prefer the
BackupStatusHelper API when available, with direct table query
fallback for older MokoSuiteBackup versions.

jmiller added 1 commit 2026-06-18 16:15:31 +00:00

fix(backup): send error on failure, use staleDays for cutoff, consistent shape (#208) ... 9b347dd136

- Send explicit error status when backup data collection fails instead
  of omitting the key (so HQ can distinguish failure from not-installed)
- Add status='ok' to not-installed return for consistent array shape
- Use staleDays param instead of hardcoded 7-day cutoff in fallback query

jmiller added 1 commit 2026-06-18 17:57:29 +00:00

ci: retrigger after runner restart 446539844d

jmiller merged commit 6b1352d82c into dev 2026-06-18 19:54:35 +00:00

jmiller deleted branch feature/208-backup-bridge 2026-06-18 19:54:36 +00:00

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

architecture

automation

Automated processes or scripts

breaking-change

Breaking API or functionality change

bug

build

Build system changes

ci-cd

CI/CD pipeline changes

config

Configuration file changes

css

CSS/styling changes

dependencies

Dependency updates

deploy-failure

Automated deploy failure tracking

docker

Docker configuration changes

documentation

Documentation changes

dolibarr

Dolibarr module or extension

duplicate

enhancement

generic

Generic project or library

good first issue

Good for newcomers

health-check

Repository health check results

health: excellent

Health score 90-100

health: fair

Health score 50-69

health: good

Health score 70-89

health: poor

Health score below 50

help wanted

Extra attention needed

html

HTML template changes

invalid

javascript

JavaScript code changes

joomla

Joomla extension or component

major-release

Major version release (breaking changes)

minor-release

Minor version release (XX.YY.00)

mokostandards

MokoStandards compliance

needs-review

Awaiting code review

needs-testing

Requires manual or automated testing

patch-release

Patch version release (XX.YY.ZZ)

php

PHP code changes

priority: critical

priority: high

priority: low

priority: medium

push-failure

File push failure requiring attention

python

Python code changes

question

regression

Regression from a previous working state

release-candidate

Release candidate build

security

Security-related changes

size/l

Large change (101-300 lines)

size/m

Medium change (31-100 lines)

size/s

Small change (11-30 lines)

size/xl

Extra large change (301-1000 lines)

size/xs

Extra small change (1-10 lines)

size/xxl

Extremely large change (1000+ lines)

standards-drift

Repository drifted from MokoStandards

standards-update

MokoStandards sync update

standards-violation

Standards compliance failure

status: blocked

status: in-progress

status: needs-review

status: on-hold

Temporarily on hold

status: pending

Pending action or decision

status: wontfix

This will not be worked on

sync-failure

Bulk sync failure requiring attention

sync-report

Bulk sync run report

template-validation-failure

Template workflow validation failure

test-failure

Automated test failure

tests

Test suite changes

type: bug

Something isn't working

type: chore

Maintenance tasks

type: enhancement

Enhancement to existing feature

type: feature

New feature or request

type: refactor

Code refactoring

type: release

Release preparation or tracking

type: test

Test suite additions or changes

type: version

Version-related change

typescript

TypeScript code changes

version

Version bump or release

version-branch

Version branch related

version-drift

Version mismatch detected

work-in-progress

Work in progress, not ready for merge

No labels

Priority -

Type -

Milestone

No items

No Milestone

Assignees

Clear assignees

jmiller (Jonathan Miller)

No Assignees

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: MokoConsulting/MokoSuiteClient#209