Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions .Jules/palette.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,3 +39,7 @@
## 2026-04-15 - [Prefect Traceability & Terminal Scanability]
**Learning:** In orchestration-based scaffolds, providing human-readable names and dynamic run names (e.g., `process-{customer_id}`) for tasks significantly improves the observability and debugging experience in the dashboard. Highlighting key numeric metrics in the CLI using consistent secondary colors (like `bold cyan`) helps users quickly parse execution outcomes.
**Action:** Always provide descriptive `name` parameters for flows and tasks, use variable interpolation in `task_run_name` for mapped tasks, and use consistent highlighting for numeric values in terminal output.

## 2026-04-16 - [Cohesive Branding in CLI and Dashboards]
**Learning:** For tool-sets with both a CLI and a web-based dashboard (like Prefect), maintaining a consistent "brand" (e.g., specific color schemes like 'bold blue' and emoji usage) across both interfaces creates a more unified and professional user experience. Standardizing the "Result" panel and task naming conventions makes the entire system feel like a single, cohesive product.
**Action:** Apply consistent branding (colors, titles, emojis) to both terminal output and dashboard metadata to ensure a unified user experience across all interfaces.
13 changes: 7 additions & 6 deletions 01_getting_started.py
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
console = Console()


@task(name="Fetch Customer Data")
@task(name="Fetch Customer Data", task_run_name="fetch-customer-data")
def get_customer_ids() -> list[str]:
"""Fetch customer IDs from a database or API."""
# Use sorted and zero-padded IDs for better terminal alignment
Expand Down Expand Up @@ -74,6 +74,7 @@ def main():
# Display results in a clean table for better readability
table = Table(
title="Processing Summary",
title_style="bold blue",
show_header=True,
header_style="bold blue",
show_footer=True,
Expand All @@ -83,8 +84,8 @@ def main():
table.add_column(
"Status",
style="green",
footer=f"{len(results)} Processed",
footer_style="bold",
footer=f"{len(results)} Processed",
footer_style="bold blue",
)

# Use zip to map results back to their original IDs more reliably
Expand All @@ -96,9 +97,9 @@ def main():

console.print(
Panel.fit(
f"[bold green]Successfully processed [bold cyan]{len(results)}[/bold cyan] customers in [bold cyan]{duration:.2f}s[/bold cyan]![/bold green]",
title="Result",
border_style="green",
f"[bold green]Successfully processed [bold cyan]{len(results)}[/bold cyan] customers in [bold cyan]{duration:.2f}s[/bold cyan]![/bold green]",
title="Result",
border_style="bold blue",
)
)

Expand Down
13 changes: 7 additions & 6 deletions 02_logging.py
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
console = Console()


@task(name="Fetch Customer Data")
@task(name="Fetch Customer Data", task_run_name="fetch-customer-data")
def get_customer_ids() -> list[str]:
"""Fetch customer IDs from a database or API."""
# Use sorted and zero-padded IDs for better terminal alignment
Expand Down Expand Up @@ -83,6 +83,7 @@ def main():
# Display results in a clean table for better readability
table = Table(
title="Processing Summary",
title_style="bold blue",
show_header=True,
header_style="bold blue",
show_footer=True,
Expand All @@ -92,8 +93,8 @@ def main():
table.add_column(
"Status",
style="green",
footer=f"{len(results)} Processed",
footer_style="bold",
footer=f"{len(results)} Processed",
footer_style="bold blue",
)

# Use zip to map results back to their original IDs more reliably
Expand All @@ -105,9 +106,9 @@ def main():

console.print(
Panel.fit(
f"[bold green]Successfully processed [bold cyan]{len(results)}[/bold cyan] customers with detailed logging in [bold cyan]{duration:.2f}s[/bold cyan]![/bold green]",
title="Result",
border_style="green",
f"[bold green]Successfully processed [bold cyan]{len(results)}[/bold cyan] customers with detailed logging in [bold cyan]{duration:.2f}s[/bold cyan]![/bold green]",
title="📊 Result",
border_style="bold blue",
)
)

Expand Down
Loading