root/fusion
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(FN-4847): update sync-status denial reason docs and changeset

Browse Source 
Fusion-Task-Id: FN-4847
Fusion-Task-Lineage: af551b65-a484-496a-8bab-b46193e06104
This commit is contained in:
Fusion (runfusion.ai)
2026-05-17 08:30:06 -07:00
committed by gsxdsm
parent a49b8553fb
commit 49bc9dd0eb
3 changed files with 10 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
.changeset/fn-4847-sync-status-denial-reason.md Normal file
View File

@@ -0,0 +1,8 @@
---
"@runfusion/fusion": patch
---
GET /api/nodes/:id/settings/sync-status now includes an `actionableDenialReason` field
("missing-remote-api-key" | "auth-failed" | "unreachable" | "unknown" | null) so
dashboards can surface why a remote probe failed instead of silently reporting
`remoteReachable: false` with no diagnosis.

2
AGENTS.md
View File

@@ -291,7 +291,7 @@ Fusion has a Node Dashboard view for managing mesh network nodes. See [docs/arch
| GET | `/api/nodes/:id/settings` | Fetch settings from a remote node |
| POST | `/api/nodes/:id/settings/push` | Push local settings to a remote node |
| POST | `/api/nodes/:id/settings/pull` | Pull settings from a remote node |
| GET | `/api/nodes/:id/settings/sync-status` | Get sync status and diff summary |
| GET | `/api/nodes/:id/settings/sync-status` | Get sync status and diff summary (includes `actionableDenialReason` when remote probe fails) |
| POST | `/api/nodes/:id/auth/sync` | Sync model auth credentials |
| POST | `/api/nodes/:id/secrets/push` | Push local secrets snapshot to a remote node *(planned; follow-up FN-4867)* |
| POST | `/api/nodes/:id/secrets/pull` | Pull remote secrets snapshot into local node *(planned; follow-up FN-4867)* |

2
docs/architecture.md
View File

@@ -994,7 +994,7 @@ The client treats mapping persistence as part of onboarding success. If mapping
| GET | `/api/nodes/:id/settings` | Fetch settings from a remote node. |
| POST | `/api/nodes/:id/settings/push` | Push local settings to a remote node. |
| POST | `/api/nodes/:id/settings/pull` | Pull settings from a remote node. |
| GET | `/api/nodes/:id/settings/sync-status` | Get sync status and diff summary. |
| GET | `/api/nodes/:id/settings/sync-status` | Get sync status and diff summary (includes `actionableDenialReason` when remote probe fails). |
| POST | `/api/nodes/:id/auth/sync` | Sync model auth snapshots (push/pull, checksum/version validated). |
| POST | `/api/nodes/:id/secrets/push` | Push local secrets snapshot to a remote node *(planned; follow-up FN-4867)*. |
| POST | `/api/nodes/:id/secrets/pull` | Pull secrets snapshot from a remote node *(planned; follow-up FN-4867)*. |