[AISOS-2389] Forge Grafana dashboards classify tasks as bugs

[forgeSmith-bot]

Summary

This pull request resolves issues where "Task" issue types were omitted or misclassified as bugs on Forge Grafana dashboards by converting hardcoded filters to dynamic queries. It introduces dedicated KPI panels on the business dashboard to track the average cost and completion times specifically for tasks, providing complete and accurate visibility into SDLC performance metrics. Additionally, the developer guide has been updated to officially list "Task" alongside features and bugs as a core ticket type.

Changes

Dashboards

• Dynamic Variable Definition: Converted the hardcoded ticket_type CustomVariable to a dynamic ClickHouse QueryVariable in devtools/grafana/dashboards/forge-business.json to automatically retrieve active ticket types, preventing tasks from being filtered out.
• Avg Cost / Task Panel (panel-26): Created a new KPI panel as a duplicate of the bug fix cost panel, filtered on t.metadata['ticket_type'] = 'Task'.
• Avg Completion Time (Tasks) Panel (panel-27): Added a new efficiency panel as a duplicate of the bug completion time panel, filtered on t.metadata['ticket_type'] = 'Task'.
• Layout Adjustments: Re-calculated grid positions (x-offset, width) under the "💵 Executive KPIs" and "🔄 Efficiency & Waste" rows to cleanly integrate the new panels within the standard 24-column grid limit.

Documentation

• Developer Guide (docs/developer-guide.md): Updated trace metadata field descriptions to explicitly include Task as a first-class ticket type option, aligning developer documentation with system behavior.

Implementation Notes

• Extensibility: Replacing hardcoded list selections with a dynamic trace query ensures that any future ticket types will automatically propagate to the dashboard filters without needing schema changes.
• Grid Integrity: Panel widths in the modified rows were resized proportionally (width 4 for the executive row, and width 8 for the efficiency row) to ensure a clean, symmetric presentation that utilizes exactly 24 units per row.

Testing

• Dashboard Validation: Verified dashboard JSON well-formedness, schema compliance, and variable definitions by running unit tests (pytest tests/unit/devtools/test_grafana_assets.py).
• Code Quality: Checked compliance and formatting using ruff check src/.

Related Tickets

• AISOS-2389
• AISOS-2391

---

Generated by Forge SDLC Orchestrator

[forgeSmith-bot]

🛠️ Forge PR Commands

This pull request was created by Forge! You can use the following commands by commenting on this PR:

• /forge rebase - Merge the base branch (e.g. main) into this PR branch, with conflicts resolved by AI.
• /forge skip-gate <name> - Skip a named CI check (substring match) for this PR. This setting persists across subsequent pushes.
• /forge unskip-gate <name> - Remove a previously set CI check skip.

Feel free to use these commands to manage your workflow!