david.delagneau
374991a568
- Deleted obsolete files: obsidian-vault.md, onboarding.md, workspace-model.md - Updated opencode.json to remove references to deleted files. - Revised profile.md to clarify the status of legacy paths and communication evidence. - Adjusted prompts to reflect new file paths and improve clarity. - Enhanced daily logs with focus, work-items, and blockers properties. - Updated work-item notes to include systems, workstreams, people, and related properties. - Improved context maintenance guidelines to ensure accurate and durable project knowledge. - Refined base filters to exclude template files and ensure only relevant notes are displayed. - Updated daily templates to ensure proper formatting and consistency. - Modified workflows to align with the new vault structure and improve context synchronization.
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.
|