david.delagneau
dbc1894e27
- Introduced new maps for navigating project knowledge, including "Current Work," "Fidelity Domain," "Fidelity Apps," "Work Items," and "People." - Created base files for daily notes, decisions, people, systems, work items, and workstreams with defined properties and views. - Developed templates for daily notes, decisions, meeting notes, persons, systems, work items, and workstreams to standardize documentation. - Updated scripts and prompts to reflect the new project-knowledge directory structure. - Removed outdated onboarding and start-here documents, consolidating relevant information into the new maps. - Ensured all references in workflows and scripts point to the new project-knowledge paths.
52 lines
1.8 KiB
Markdown
52 lines
1.8 KiB
Markdown
---
|
|
type: workstream
|
|
project: fidelity
|
|
status: active
|
|
systems: [xflowsdk, fid4, cogstore, xflowviewmaker, ftframeworks]
|
|
work-items: [pdiap-15765, pdiap-14859, pdiap-15836]
|
|
related: [ao-discourse, consumer-integration, flow-page-references]
|
|
updated: 2026-04-16
|
|
tags:
|
|
- workstream
|
|
- fidelity
|
|
---
|
|
# XFlow Debugging
|
|
|
|
## Goal
|
|
|
|
Debug backend-driven flows without losing track of dynamic dependencies or misclassifying integration behavior.
|
|
|
|
---
|
|
|
|
## Stable Patterns
|
|
|
|
- XFlow screens are backend-driven, so UI can change without local code changes.
|
|
- Reproduction depends on:
|
|
- entry point
|
|
- authentication state
|
|
- backend configuration
|
|
- consumer integration path
|
|
- Not all entry points are reachable from visible UI; some require exploratory validation.
|
|
|
|
---
|
|
|
|
## Investigation Rules
|
|
|
|
- Confirm the entry point before comparing behavior.
|
|
- Separate service-driven behavior from client regressions.
|
|
- Confirm whether the issue reproduces in:
|
|
- sample app
|
|
- XFlow-only environment
|
|
- Fid4 / flagship
|
|
- authenticated vs non-authenticated state
|
|
- If a fix appears correct in the SDK but not in consumer validation, inspect the release chain before reopening root cause assumptions.
|
|
- When validating service/configuration changes, check the active flow-definition version in Cogstore before assuming a change is live in QA or Production.
|
|
- Do not assume a flow ID will exist in both Cogstore and Slate; verify which config system actually owns the flow you are inspecting.
|
|
|
|
---
|
|
|
|
## Historical Signals From Slack
|
|
|
|
- Historical debugging covered Next-button visibility, markdown modal analytics, modal presentation, slot updates, and SwiftUI lifecycle behavior.
|
|
- Multiple pipeline or dependency problems looked like XFlow issues until the build chain or consumer integration path was inspected more carefully.
|