Skip to content

Conversation

@jumski
Copy link
Contributor

@jumski jumski commented Nov 4, 2025

DAG Visualization and Debug Panel for pgflow Demo

This PR adds a visual DAG (Directed Acyclic Graph) representation and a comprehensive debug panel to the pgflow demo application. The implementation provides real-time visualization of workflow execution and detailed debugging information.

Key features:

  • DAG Visualization Component: Displays a 4-node graph showing the article processing workflow with dynamic styling based on execution state (pending, running, completed, failed)
  • Debug Panel Component: Shows run information, step states, and a real-time event stream
  • Improved State Management: Utilizes the existing createFlowState() pattern for reactive state management
  • UI Framework: Implements shadcn/svelte components with a dark theme for a polished interface
  • Two-Column Layout: Organizes the UI with DAG visualization on the left and debug panel on the right

Technical improvements:

  • Added watchdog SQL migration to ensure the article flow worker stays running
  • Fixed broadcast order and timestamp handling in pgflow SQL functions
  • Updated Tailwind to v4 with proper configuration for the new styling system
  • Added animation support for visual feedback during workflow execution

This enhancement provides a much clearer visualization of the workflow execution process, making it easier to understand and debug pgflow applications.

@changeset-bot
Copy link

changeset-bot bot commented Nov 4, 2025

⚠️ No Changeset found

Latest commit: 67ad902

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Copy link
Contributor Author

jumski commented Nov 4, 2025

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more


How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

  • merge:queue - adds this PR to the back of the merge queue
  • hotfix:queue - for urgent hot fixes, skip the queue and merge this PR next

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.

@jumski jumski force-pushed the feat-demo-2-article-flow branch from a6b533c to 8acb90c Compare November 4, 2025 11:33
@jumski jumski force-pushed the feat-demo-3-dag-debug branch 2 times, most recently from 3f40fb5 to bf3ad7f Compare November 6, 2025 08:36
@jumski jumski force-pushed the feat-demo-2-article-flow branch from 8acb90c to 65e42c7 Compare November 6, 2025 08:36
@jumski jumski force-pushed the feat-demo-2-article-flow branch from 65e42c7 to 4aa3dfb Compare November 9, 2025 15:16
@jumski jumski force-pushed the feat-demo-3-dag-debug branch from bf3ad7f to 26ba852 Compare November 9, 2025 15:16
@jumski jumski force-pushed the feat-demo-3-dag-debug branch from 26ba852 to e9332db Compare November 10, 2025 16:42
@jumski jumski force-pushed the feat-demo-2-article-flow branch from 1e2b5bb to a4b4af9 Compare November 10, 2025 20:45
@jumski jumski force-pushed the feat-demo-3-dag-debug branch 2 times, most recently from 1a0aab0 to 946dd0f Compare November 10, 2025 23:37
@jumski jumski force-pushed the feat-demo-2-article-flow branch from a4b4af9 to 0fdf559 Compare November 10, 2025 23:37
…tion

- Added detailed documentation and philosophy on state management using createFlowState()
- Updated DAGVisualization component to receive flowState via props for dynamic styling
- Created DebugPanel component to display step statuses, outputs, errors, and event stream
- Modified page layout to include both DAG visualization and debug panel with shared flowState
- Improved event handling and reactivity by leveraging createFlowState's automatic subscriptions
- Updated troubleshooting tips for rendering, reactivity, and animation issues
- Overall improvements facilitate observability, debugging, and real-time monitoring of data flow
@jumski jumski force-pushed the feat-demo-2-article-flow branch from 0fdf559 to baea171 Compare November 11, 2025 14:38
@jumski jumski force-pushed the feat-demo-3-dag-debug branch from 946dd0f to 67ad902 Compare November 11, 2025 14:38
@nx-cloud
Copy link

nx-cloud bot commented Nov 11, 2025

View your CI Pipeline Execution ↗ for commit 67ad902

Command Status Duration Result
nx test:types:health dsl ✅ Succeeded 15s View ↗

☁️ Nx Cloud last updated this comment at 2025-11-11 14:52:20 UTC

@graphite-app
Copy link
Contributor

graphite-app bot commented Nov 11, 2025

Merge activity

  • Nov 11, 8:50 PM UTC: jumski added this pull request to the Graphite merge queue.
  • Nov 11, 8:53 PM UTC: The Graphite merge queue removed this pull request due to downstack failures on PR #289.
  • Nov 11, 8:54 PM UTC: The Graphite merge queue removed this pull request due to downstack failures on PR #289.
  • Nov 11, 9:05 PM UTC: jumski added this pull request to the Graphite merge queue.
  • Nov 11, 9:06 PM UTC: CI is running for this pull request on a draft pull request (#362) due to your merge queue CI optimization settings.
  • Nov 11, 9:07 PM UTC: Merged by the Graphite merge queue via draft PR: #362.

graphite-app bot pushed a commit that referenced this pull request Nov 11, 2025
#311)

# DAG Visualization and Debug Panel for pgflow Demo

This PR adds a visual DAG (Directed Acyclic Graph) representation and a comprehensive debug panel to the pgflow demo application. The implementation provides real-time visualization of workflow execution and detailed debugging information.

Key features:

- **DAG Visualization Component**: Displays a 4-node graph showing the article processing workflow with dynamic styling based on execution state (pending, running, completed, failed)
- **Debug Panel Component**: Shows run information, step states, and a real-time event stream
- **Improved State Management**: Utilizes the existing `createFlowState()` pattern for reactive state management
- **UI Framework**: Implements shadcn/svelte components with a dark theme for a polished interface
- **Two-Column Layout**: Organizes the UI with DAG visualization on the left and debug panel on the right

Technical improvements:
- Added watchdog SQL migration to ensure the article flow worker stays running
- Fixed broadcast order and timestamp handling in pgflow SQL functions
- Updated Tailwind to v4 with proper configuration for the new styling system
- Added animation support for visual feedback during workflow execution

This enhancement provides a much clearer visualization of the workflow execution process, making it easier to understand and debug pgflow applications.
@graphite-app graphite-app bot closed this Nov 11, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants