PyPI - htmlgraph - Versions diffs - 0.20.1__py3-none-any.whl → 0.27.5__py3-none-any.whl - Mend

htmlgraph 0.20.1py3-none-any.whl → 0.27.5py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (304) hide show

htmlgraph/.htmlgraph/.session-warning-state.json +6 -0
htmlgraph/.htmlgraph/agents.json +72 -0
htmlgraph/.htmlgraph/htmlgraph.db +0 -0
htmlgraph/__init__.py +51 -1
htmlgraph/__init__.pyi +123 -0
htmlgraph/agent_detection.py +26 -10
htmlgraph/agent_registry.py +2 -1
htmlgraph/analytics/__init__.py +8 -1
htmlgraph/analytics/cli.py +86 -20
htmlgraph/analytics/cost_analyzer.py +391 -0
htmlgraph/analytics/cost_monitor.py +664 -0
htmlgraph/analytics/cost_reporter.py +675 -0
htmlgraph/analytics/cross_session.py +617 -0
htmlgraph/analytics/dependency.py +10 -6
htmlgraph/analytics/pattern_learning.py +771 -0
htmlgraph/analytics/session_graph.py +707 -0
htmlgraph/analytics/strategic/__init__.py +80 -0
htmlgraph/analytics/strategic/cost_optimizer.py +611 -0
htmlgraph/analytics/strategic/pattern_detector.py +876 -0
htmlgraph/analytics/strategic/preference_manager.py +709 -0
htmlgraph/analytics/strategic/suggestion_engine.py +747 -0
htmlgraph/analytics/work_type.py +67 -27
htmlgraph/analytics_index.py +53 -20
htmlgraph/api/__init__.py +3 -0
htmlgraph/api/cost_alerts_websocket.py +416 -0
htmlgraph/api/main.py +2498 -0
htmlgraph/api/static/htmx.min.js +1 -0
htmlgraph/api/static/style-redesign.css +1344 -0
htmlgraph/api/static/style.css +1079 -0
htmlgraph/api/templates/dashboard-redesign.html +1366 -0
htmlgraph/api/templates/dashboard.html +794 -0
htmlgraph/api/templates/partials/activity-feed-hierarchical.html +326 -0
htmlgraph/api/templates/partials/activity-feed.html +1100 -0
htmlgraph/api/templates/partials/agents-redesign.html +317 -0
htmlgraph/api/templates/partials/agents.html +317 -0
htmlgraph/api/templates/partials/event-traces.html +373 -0
htmlgraph/api/templates/partials/features-kanban-redesign.html +509 -0
htmlgraph/api/templates/partials/features.html +578 -0
htmlgraph/api/templates/partials/metrics-redesign.html +346 -0
htmlgraph/api/templates/partials/metrics.html +346 -0
htmlgraph/api/templates/partials/orchestration-redesign.html +443 -0
htmlgraph/api/templates/partials/orchestration.html +198 -0
htmlgraph/api/templates/partials/spawners.html +375 -0
htmlgraph/api/templates/partials/work-items.html +613 -0
htmlgraph/api/websocket.py +538 -0
htmlgraph/archive/__init__.py +24 -0
htmlgraph/archive/bloom.py +234 -0
htmlgraph/archive/fts.py +297 -0
htmlgraph/archive/manager.py +583 -0
htmlgraph/archive/search.py +244 -0
htmlgraph/atomic_ops.py +560 -0
htmlgraph/attribute_index.py +2 -1
htmlgraph/bounded_paths.py +539 -0
htmlgraph/builders/base.py +57 -2
htmlgraph/builders/bug.py +19 -3
htmlgraph/builders/chore.py +19 -3
htmlgraph/builders/epic.py +19 -3
htmlgraph/builders/feature.py +27 -3
htmlgraph/builders/insight.py +2 -1
htmlgraph/builders/metric.py +2 -1
htmlgraph/builders/pattern.py +2 -1
htmlgraph/builders/phase.py +19 -3
htmlgraph/builders/spike.py +29 -3
htmlgraph/builders/track.py +42 -1
htmlgraph/cigs/__init__.py +81 -0
htmlgraph/cigs/autonomy.py +385 -0
htmlgraph/cigs/cost.py +475 -0
htmlgraph/cigs/messages_basic.py +472 -0
htmlgraph/cigs/messaging.py +365 -0
htmlgraph/cigs/models.py +771 -0
htmlgraph/cigs/pattern_storage.py +427 -0
htmlgraph/cigs/patterns.py +503 -0
htmlgraph/cigs/posttool_analyzer.py +234 -0
htmlgraph/cigs/reporter.py +818 -0
htmlgraph/cigs/tracker.py +317 -0
htmlgraph/cli/.htmlgraph/.session-warning-state.json +6 -0
htmlgraph/cli/.htmlgraph/agents.json +72 -0
htmlgraph/cli/.htmlgraph/htmlgraph.db +0 -0
htmlgraph/cli/__init__.py +42 -0
htmlgraph/cli/__main__.py +6 -0
htmlgraph/cli/analytics.py +1424 -0
htmlgraph/cli/base.py +685 -0
htmlgraph/cli/constants.py +206 -0
htmlgraph/cli/core.py +954 -0
htmlgraph/cli/main.py +147 -0
htmlgraph/cli/models.py +475 -0
htmlgraph/cli/templates/__init__.py +1 -0
htmlgraph/cli/templates/cost_dashboard.py +399 -0
htmlgraph/cli/work/__init__.py +239 -0
htmlgraph/cli/work/browse.py +115 -0
htmlgraph/cli/work/features.py +568 -0
htmlgraph/cli/work/orchestration.py +676 -0
htmlgraph/cli/work/report.py +728 -0
htmlgraph/cli/work/sessions.py +466 -0
htmlgraph/cli/work/snapshot.py +559 -0
htmlgraph/cli/work/tracks.py +486 -0
htmlgraph/cli_commands/__init__.py +1 -0
htmlgraph/cli_commands/feature.py +195 -0
htmlgraph/cli_framework.py +115 -0
htmlgraph/collections/__init__.py +2 -0
htmlgraph/collections/base.py +197 -14
htmlgraph/collections/bug.py +2 -1
htmlgraph/collections/chore.py +2 -1
htmlgraph/collections/epic.py +2 -1
htmlgraph/collections/feature.py +2 -1
htmlgraph/collections/insight.py +2 -1
htmlgraph/collections/metric.py +2 -1
htmlgraph/collections/pattern.py +2 -1
htmlgraph/collections/phase.py +2 -1
htmlgraph/collections/session.py +194 -0
htmlgraph/collections/spike.py +13 -2
htmlgraph/collections/task_delegation.py +241 -0
htmlgraph/collections/todo.py +14 -1
htmlgraph/collections/traces.py +487 -0
htmlgraph/config/cost_models.json +56 -0
htmlgraph/config.py +190 -0
htmlgraph/context_analytics.py +2 -1
htmlgraph/converter.py +116 -7
htmlgraph/cost_analysis/__init__.py +5 -0
htmlgraph/cost_analysis/analyzer.py +438 -0
htmlgraph/dashboard.html +2246 -248
htmlgraph/dashboard.html.backup +6592 -0
htmlgraph/dashboard.html.bak +7181 -0
htmlgraph/dashboard.html.bak2 +7231 -0
htmlgraph/dashboard.html.bak3 +7232 -0
htmlgraph/db/__init__.py +38 -0
htmlgraph/db/queries.py +790 -0
htmlgraph/db/schema.py +1788 -0
htmlgraph/decorators.py +317 -0
htmlgraph/dependency_models.py +2 -1
htmlgraph/deploy.py +26 -27
htmlgraph/docs/API_REFERENCE.md +841 -0
htmlgraph/docs/HTTP_API.md +750 -0
htmlgraph/docs/INTEGRATION_GUIDE.md +752 -0
htmlgraph/docs/ORCHESTRATION_PATTERNS.md +717 -0
htmlgraph/docs/README.md +532 -0
htmlgraph/docs/__init__.py +77 -0
htmlgraph/docs/docs_version.py +55 -0
htmlgraph/docs/metadata.py +93 -0
htmlgraph/docs/migrations.py +232 -0
htmlgraph/docs/template_engine.py +143 -0
htmlgraph/docs/templates/_sections/cli_reference.md.j2 +52 -0
htmlgraph/docs/templates/_sections/core_concepts.md.j2 +29 -0
htmlgraph/docs/templates/_sections/sdk_basics.md.j2 +69 -0
htmlgraph/docs/templates/base_agents.md.j2 +78 -0
htmlgraph/docs/templates/example_user_override.md.j2 +47 -0
htmlgraph/docs/version_check.py +163 -0
htmlgraph/edge_index.py +2 -1
htmlgraph/error_handler.py +544 -0
htmlgraph/event_log.py +86 -37
htmlgraph/event_migration.py +2 -1
htmlgraph/file_watcher.py +12 -8
htmlgraph/find_api.py +2 -1
htmlgraph/git_events.py +67 -9
htmlgraph/hooks/.htmlgraph/.session-warning-state.json +6 -0
htmlgraph/hooks/.htmlgraph/agents.json +72 -0
htmlgraph/hooks/.htmlgraph/index.sqlite +0 -0
htmlgraph/hooks/__init__.py +8 -0
htmlgraph/hooks/bootstrap.py +169 -0
htmlgraph/hooks/cigs_pretool_enforcer.py +354 -0
htmlgraph/hooks/concurrent_sessions.py +208 -0
htmlgraph/hooks/context.py +350 -0
htmlgraph/hooks/drift_handler.py +525 -0
htmlgraph/hooks/event_tracker.py +790 -99
htmlgraph/hooks/git_commands.py +175 -0
htmlgraph/hooks/installer.py +5 -1
htmlgraph/hooks/orchestrator.py +327 -76
htmlgraph/hooks/orchestrator_reflector.py +31 -4
htmlgraph/hooks/post_tool_use_failure.py +32 -7
htmlgraph/hooks/post_tool_use_handler.py +257 -0
htmlgraph/hooks/posttooluse.py +92 -19
htmlgraph/hooks/pretooluse.py +527 -7
htmlgraph/hooks/prompt_analyzer.py +637 -0
htmlgraph/hooks/session_handler.py +668 -0
htmlgraph/hooks/session_summary.py +395 -0
htmlgraph/hooks/state_manager.py +504 -0
htmlgraph/hooks/subagent_detection.py +202 -0
htmlgraph/hooks/subagent_stop.py +369 -0
htmlgraph/hooks/task_enforcer.py +99 -4
htmlgraph/hooks/validator.py +212 -91
htmlgraph/ids.py +2 -1
htmlgraph/learning.py +125 -100
htmlgraph/mcp_server.py +2 -1
htmlgraph/models.py +217 -18
htmlgraph/operations/README.md +62 -0
htmlgraph/operations/__init__.py +79 -0
htmlgraph/operations/analytics.py +339 -0
htmlgraph/operations/bootstrap.py +289 -0
htmlgraph/operations/events.py +244 -0
htmlgraph/operations/fastapi_server.py +231 -0
htmlgraph/operations/hooks.py +350 -0
htmlgraph/operations/initialization.py +597 -0
htmlgraph/operations/initialization.py.backup +228 -0
htmlgraph/operations/server.py +303 -0
htmlgraph/orchestration/__init__.py +58 -0
htmlgraph/orchestration/claude_launcher.py +179 -0
htmlgraph/orchestration/command_builder.py +72 -0
htmlgraph/orchestration/headless_spawner.py +281 -0
htmlgraph/orchestration/live_events.py +377 -0
htmlgraph/orchestration/model_selection.py +327 -0
htmlgraph/orchestration/plugin_manager.py +140 -0
htmlgraph/orchestration/prompts.py +137 -0
htmlgraph/orchestration/spawner_event_tracker.py +383 -0
htmlgraph/orchestration/spawners/__init__.py +16 -0
htmlgraph/orchestration/spawners/base.py +194 -0
htmlgraph/orchestration/spawners/claude.py +173 -0
htmlgraph/orchestration/spawners/codex.py +435 -0
htmlgraph/orchestration/spawners/copilot.py +294 -0
htmlgraph/orchestration/spawners/gemini.py +471 -0
htmlgraph/orchestration/subprocess_runner.py +36 -0
htmlgraph/{orchestration.py → orchestration/task_coordination.py} +16 -8
htmlgraph/orchestration.md +563 -0
htmlgraph/orchestrator-system-prompt-optimized.txt +863 -0
htmlgraph/orchestrator.py +2 -1
htmlgraph/orchestrator_config.py +357 -0
htmlgraph/orchestrator_mode.py +115 -4
htmlgraph/parallel.py +2 -1
htmlgraph/parser.py +86 -6
htmlgraph/path_query.py +608 -0
htmlgraph/pattern_matcher.py +636 -0
htmlgraph/pydantic_models.py +476 -0
htmlgraph/quality_gates.py +350 -0
htmlgraph/query_builder.py +2 -1
htmlgraph/query_composer.py +509 -0
htmlgraph/reflection.py +443 -0
htmlgraph/refs.py +344 -0
htmlgraph/repo_hash.py +512 -0
htmlgraph/repositories/__init__.py +292 -0
htmlgraph/repositories/analytics_repository.py +455 -0
htmlgraph/repositories/analytics_repository_standard.py +628 -0
htmlgraph/repositories/feature_repository.py +581 -0
htmlgraph/repositories/feature_repository_htmlfile.py +668 -0
htmlgraph/repositories/feature_repository_memory.py +607 -0
htmlgraph/repositories/feature_repository_sqlite.py +858 -0
htmlgraph/repositories/filter_service.py +620 -0
htmlgraph/repositories/filter_service_standard.py +445 -0
htmlgraph/repositories/shared_cache.py +621 -0
htmlgraph/repositories/shared_cache_memory.py +395 -0
htmlgraph/repositories/track_repository.py +552 -0
htmlgraph/repositories/track_repository_htmlfile.py +619 -0
htmlgraph/repositories/track_repository_memory.py +508 -0
htmlgraph/repositories/track_repository_sqlite.py +711 -0
htmlgraph/sdk/__init__.py +398 -0
htmlgraph/sdk/__init__.pyi +14 -0
htmlgraph/sdk/analytics/__init__.py +19 -0
htmlgraph/sdk/analytics/engine.py +155 -0
htmlgraph/sdk/analytics/helpers.py +178 -0
htmlgraph/sdk/analytics/registry.py +109 -0
htmlgraph/sdk/base.py +484 -0
htmlgraph/sdk/constants.py +216 -0
htmlgraph/sdk/core.pyi +308 -0
htmlgraph/sdk/discovery.py +120 -0
htmlgraph/sdk/help/__init__.py +12 -0
htmlgraph/sdk/help/mixin.py +699 -0
htmlgraph/sdk/mixins/__init__.py +15 -0
htmlgraph/sdk/mixins/attribution.py +113 -0
htmlgraph/sdk/mixins/mixin.py +410 -0
htmlgraph/sdk/operations/__init__.py +12 -0
htmlgraph/sdk/operations/mixin.py +427 -0
htmlgraph/sdk/orchestration/__init__.py +17 -0
htmlgraph/sdk/orchestration/coordinator.py +203 -0
htmlgraph/sdk/orchestration/spawner.py +204 -0
htmlgraph/sdk/planning/__init__.py +19 -0
htmlgraph/sdk/planning/bottlenecks.py +93 -0
htmlgraph/sdk/planning/mixin.py +211 -0
htmlgraph/sdk/planning/parallel.py +186 -0
htmlgraph/sdk/planning/queue.py +210 -0
htmlgraph/sdk/planning/recommendations.py +87 -0
htmlgraph/sdk/planning/smart_planning.py +319 -0
htmlgraph/sdk/session/__init__.py +19 -0
htmlgraph/sdk/session/continuity.py +57 -0
htmlgraph/sdk/session/handoff.py +110 -0
htmlgraph/sdk/session/info.py +309 -0
htmlgraph/sdk/session/manager.py +103 -0
htmlgraph/sdk/strategic/__init__.py +26 -0
htmlgraph/sdk/strategic/mixin.py +563 -0
htmlgraph/server.py +295 -107
htmlgraph/session_hooks.py +300 -0
htmlgraph/session_manager.py +285 -3
htmlgraph/session_registry.py +587 -0
htmlgraph/session_state.py +436 -0
htmlgraph/session_warning.py +2 -1
htmlgraph/sessions/__init__.py +23 -0
htmlgraph/sessions/handoff.py +756 -0
htmlgraph/system_prompts.py +450 -0
htmlgraph/templates/orchestration-view.html +350 -0
htmlgraph/track_builder.py +33 -1
htmlgraph/track_manager.py +38 -0
htmlgraph/transcript.py +18 -5
htmlgraph/validation.py +115 -0
htmlgraph/watch.py +2 -1
htmlgraph/work_type_utils.py +2 -1
{htmlgraph-0.20.1.data → htmlgraph-0.27.5.data}/data/htmlgraph/dashboard.html +2246 -248
{htmlgraph-0.20.1.dist-info → htmlgraph-0.27.5.dist-info}/METADATA +95 -64
htmlgraph-0.27.5.dist-info/RECORD +337 -0
{htmlgraph-0.20.1.dist-info → htmlgraph-0.27.5.dist-info}/entry_points.txt +1 -1
htmlgraph/cli.py +0 -4839
htmlgraph/sdk.py +0 -2359
htmlgraph-0.20.1.dist-info/RECORD +0 -118
{htmlgraph-0.20.1.data → htmlgraph-0.27.5.data}/data/htmlgraph/styles.css +0 -0
{htmlgraph-0.20.1.data → htmlgraph-0.27.5.data}/data/htmlgraph/templates/AGENTS.md.template +0 -0
{htmlgraph-0.20.1.data → htmlgraph-0.27.5.data}/data/htmlgraph/templates/CLAUDE.md.template +0 -0
{htmlgraph-0.20.1.data → htmlgraph-0.27.5.data}/data/htmlgraph/templates/GEMINI.md.template +0 -0
{htmlgraph-0.20.1.dist-info → htmlgraph-0.27.5.dist-info}/WHEEL +0 -0

htmlgraph/analytics/cost_reporter.py ADDED Viewed

@@ -0,0 +1,675 @@
+"""
+CostReporter for OTEL ROI Analysis - Phase 1.
+Generates interactive HTML dashboards showing cost analysis of Task delegations.
+Creates visualizations of delegation costs, ROI, and optimization recommendations.
+Features:
+- Top 10 most expensive Task delegations
+- Cost breakdown by subagent type and tool type
+- ROI analysis comparing delegation vs direct execution
+- Interactive charts using Chart.js
+- Dark theme matching HtmlGraph visual style
+Usage:
+    from htmlgraph.analytics.cost_analyzer import CostAnalyzer
+    from htmlgraph.analytics.cost_reporter import CostReporter
+    analyzer = CostAnalyzer()
+    reporter = CostReporter()
+    html = reporter.generate_dashboard(analyzer)
+    reporter.save_dashboard(html, "cost-analysis.html")
+"""
+import json
+from datetime import datetime
+from pathlib import Path
+from typing import Any
+from htmlgraph.analytics.cost_analyzer import CostAnalyzer
+class CostReporter:
+    """Generate interactive HTML dashboards from cost analysis data."""
+    THEME = {
+        "bg_primary": "#1a1a2e",
+        "bg_secondary": "#16213e",
+        "text_primary": "#e0e0e0",
+        "text_secondary": "#b0b0b0",
+        "accent_primary": "#0f3460",
+        "accent_secondary": "#e94560",
+        "success": "#4caf50",
+        "warning": "#ff9800",
+        "error": "#f44336",
+    }
+    def __init__(self) -> None:
+        """Initialize CostReporter."""
+        self.generated_at = datetime.now()
+    def generate_dashboard(self, analyzer: CostAnalyzer) -> str:
+        """
+        Generate complete interactive HTML dashboard.
+        Args:
+            analyzer: CostAnalyzer instance with cost data
+        Returns:
+            Complete HTML document as string
+        """
+        # Gather data
+        cost_breakdown = analyzer.get_cost_breakdown()
+        roi_stats = analyzer.get_roi_stats()
+        top_delegations = analyzer.get_top_delegations(10)
+        all_delegations = analyzer.get_task_delegations_with_costs()
+        # Build dashboard components
+        html_parts = [
+            self._html_header(),
+            self._html_styles(),
+            self._html_body_open(),
+            self._html_header_section(roi_stats),
+            self._html_summary_cards(roi_stats, cost_breakdown),
+            self._html_charts_section(cost_breakdown, all_delegations),
+            self._html_top_delegations_table(top_delegations),
+            self._html_insights_section(roi_stats, cost_breakdown),
+            self._html_footer_section(),
+            self._html_body_close(),
+            self._html_scripts(cost_breakdown, all_delegations),
+        ]
+        return "\n".join(html_parts)
+    def save_dashboard(self, html: str, path: str | Path) -> None:
+        """
+        Save HTML dashboard to file.
+        Args:
+            html: HTML content to save
+            path: File path to save to
+        """
+        path = Path(path)
+        path.parent.mkdir(parents=True, exist_ok=True)
+        path.write_text(html, encoding="utf-8")
+    # ===== HTML Generation Methods =====
+    def _html_header(self) -> str:
+        """Generate HTML document header."""
+        return """<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Cost Attribution Dashboard - HtmlGraph OTEL ROI Analysis</title>
+    <script src="https://cdn.jsdelivr.net/npm/chart.js@4.4.0/dist/chart.umd.js"></script>
+</head>"""
+    def _html_styles(self) -> str:
+        """Generate CSS styles."""
+        return f"""<style>
+* {{
+    margin: 0;
+    padding: 0;
+    box-sizing: border-box;
+}}
+body {{
+    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+    background-color: {self.THEME["bg_primary"]};
+    color: {self.THEME["text_primary"]};
+    line-height: 1.6;
+}}
+a {{
+    color: {self.THEME["accent_secondary"]};
+    text-decoration: none;
+}}
+a:hover {{
+    text-decoration: underline;
+}}
+.container {{
+    max-width: 1400px;
+    margin: 0 auto;
+    padding: 20px;
+}}
+.header {{
+    border-bottom: 2px solid {self.THEME["accent_primary"]};
+    padding-bottom: 20px;
+    margin-bottom: 30px;
+}}
+.header h1 {{
+    font-size: 2.5em;
+    margin-bottom: 10px;
+    color: {self.THEME["text_primary"]};
+}}
+.header .subtitle {{
+    color: {self.THEME["text_secondary"]};
+    font-size: 0.95em;
+}}
+.header-meta {{
+    margin-top: 15px;
+    display: flex;
+    gap: 20px;
+    flex-wrap: wrap;
+    font-size: 0.9em;
+    color: {self.THEME["text_secondary"]};
+}}
+.cards {{
+    display: grid;
+    grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
+    gap: 20px;
+    margin-bottom: 40px;
+}}
+.card {{
+    background-color: {self.THEME["bg_secondary"]};
+    border: 1px solid {self.THEME["accent_primary"]};
+    border-radius: 8px;
+    padding: 25px;
+    transition: all 0.3s ease;
+}}
+.card:hover {{
+    border-color: {self.THEME["accent_secondary"]};
+    transform: translateY(-5px);
+    box-shadow: 0 10px 30px rgba(233, 69, 96, 0.2);
+}}
+.card-label {{
+    color: {self.THEME["text_secondary"]};
+    font-size: 0.85em;
+    text-transform: uppercase;
+    letter-spacing: 0.5px;
+    margin-bottom: 10px;
+}}
+.card-value {{
+    font-size: 2.5em;
+    font-weight: bold;
+    margin-bottom: 8px;
+    color: {self.THEME["text_primary"]};
+}}
+.card-unit {{
+    color: {self.THEME["text_secondary"]};
+    font-size: 0.9em;
+    font-weight: normal;
+}}
+.card-meta {{
+    color: {self.THEME["text_secondary"]};
+    font-size: 0.85em;
+    margin-top: 12px;
+    padding-top: 12px;
+    border-top: 1px solid {self.THEME["accent_primary"]};
+}}
+.status-good {{
+    color: {self.THEME["success"]};
+}}
+.status-warning {{
+    color: {self.THEME["warning"]};
+}}
+.status-error {{
+    color: {self.THEME["error"]};
+}}
+.charts {{
+    display: grid;
+    grid-template-columns: repeat(auto-fit, minmax(400px, 1fr));
+    gap: 30px;
+    margin-bottom: 40px;
+}}
+.chart-container {{
+    background-color: {self.THEME["bg_secondary"]};
+    border: 1px solid {self.THEME["accent_primary"]};
+    border-radius: 8px;
+    padding: 20px;
+}}
+.chart-title {{
+    font-size: 1.3em;
+    font-weight: 600;
+    margin-bottom: 20px;
+    color: {self.THEME["text_primary"]};
+}}
+.chart-canvas {{
+    max-height: 400px;
+}}
+.table-section {{
+    margin-bottom: 40px;
+}}
+.table-section h2 {{
+    font-size: 1.5em;
+    margin-bottom: 20px;
+    color: {self.THEME["text_primary"]};
+}}
+.table-wrapper {{
+    overflow-x: auto;
+    background-color: {self.THEME["bg_secondary"]};
+    border: 1px solid {self.THEME["accent_primary"]};
+    border-radius: 8px;
+}}
+table {{
+    width: 100%;
+    border-collapse: collapse;
+}}
+th {{
+    background-color: {self.THEME["accent_primary"]};
+    padding: 15px;
+    text-align: left;
+    font-weight: 600;
+    color: {self.THEME["text_primary"]};
+    border-bottom: 2px solid {self.THEME["accent_secondary"]};
+}}
+td {{
+    padding: 12px 15px;
+    border-bottom: 1px solid {self.THEME["accent_primary"]};
+    color: {self.THEME["text_primary"]};
+}}
+tr:hover {{
+    background-color: {self.THEME["accent_primary"]};
+}}
+.insights {{
+    background-color: {self.THEME["bg_secondary"]};
+    border: 1px solid {self.THEME["accent_primary"]};
+    border-radius: 8px;
+    padding: 25px;
+    margin-bottom: 40px;
+}}
+.insights h2 {{
+    font-size: 1.5em;
+    margin-bottom: 20px;
+    color: {self.THEME["text_primary"]};
+}}
+.insight {{
+    margin-bottom: 20px;
+    padding: 15px;
+    background-color: {self.THEME["bg_primary"]};
+    border-left: 4px solid {self.THEME["accent_secondary"]};
+    border-radius: 4px;
+}}
+.insight-title {{
+    font-weight: 600;
+    color: {self.THEME["accent_secondary"]};
+    margin-bottom: 8px;
+}}
+.insight-text {{
+    color: {self.THEME["text_secondary"]};
+    line-height: 1.6;
+}}
+.footer {{
+    text-align: center;
+    padding-top: 20px;
+    border-top: 1px solid {self.THEME["accent_primary"]};
+    color: {self.THEME["text_secondary"]};
+    font-size: 0.85em;
+}}
+@media (max-width: 768px) {{
+    .charts {{
+        grid-template-columns: 1fr;
+    }}
+    .header h1 {{
+        font-size: 1.8em;
+    }}
+    .card-value {{
+        font-size: 2em;
+    }}
+    table {{
+        font-size: 0.9em;
+    }}
+    th, td {{
+        padding: 10px;
+    }}
+}}
+</style>"""
+    def _html_body_open(self) -> str:
+        """Generate opening body tag."""
+        return "<body>"
+    def _html_body_close(self) -> str:
+        """Generate closing body tag."""
+        return "</body></html>"
+    def _html_header_section(self, roi_stats: Any) -> str:
+        """Generate dashboard header section."""
+        generated_at = self.generated_at.strftime("%Y-%m-%d %H:%M:%S")
+        return f"""<div class="container">
+    <div class="header">
+        <h1>Cost Attribution Dashboard</h1>
+        <p class="subtitle">OTEL ROI Analysis - Phase 1 MVP</p>
+        <div class="header-meta">
+            <span>Generated: <strong>{generated_at}</strong></span>
+            <span>Total Delegations: <strong>{roi_stats.total_delegations}</strong></span>
+            <span>Status: <strong class="status-good">✓ Active</strong></span>
+        </div>
+    </div>
+"""
+    def _html_summary_cards(self, roi_stats: Any, cost_breakdown: Any) -> str:
+        """Generate summary metric cards."""
+        total_cost_usd = roi_stats.total_delegation_cost * 0.0000045
+        return f"""<div class="cards">
+        <div class="card">
+            <div class="card-label">Total Delegation Cost</div>
+            <div class="card-value">${total_cost_usd:.2f}<span class="card-unit"> USD</span></div>
+            <div class="card-meta">{roi_stats.total_delegation_cost:,} tokens</div>
+        </div>
+        <div class="card">
+            <div class="card-label">Estimated Direct Cost</div>
+            <div class="card-value">${roi_stats.estimated_direct_cost * 0.0000045:.2f}<span class="card-unit"> USD</span></div>
+            <div class="card-meta">{roi_stats.estimated_direct_cost:,} tokens (2.5x overhead)</div>
+        </div>
+        <div class="card">
+            <div class="card-label">Estimated Savings</div>
+            <div class="card-value"><span class="status-good">${roi_stats.estimated_savings * 0.0000045:.2f}</span></div>
+            <div class="card-meta"><span class="status-good">{roi_stats.savings_percentage:.0f}% reduction</span></div>
+        </div>
+        <div class="card">
+            <div class="card-label">Avg Cost per Delegation</div>
+            <div class="card-value">{roi_stats.avg_cost_per_delegation:,.0f}<span class="card-unit"> tokens</span></div>
+            <div class="card-meta">Across {roi_stats.total_delegations} delegations</div>
+        </div>
+    </div>
+"""
+    def _html_charts_section(self, cost_breakdown: Any, all_delegations: Any) -> str:
+        """Generate charts section with visualizations."""
+        # Prepare data for charts
+        subagent_labels = list(cost_breakdown.by_subagent.keys())
+        subagent_data = list(cost_breakdown.by_subagent.values())
+        tool_labels = list(cost_breakdown.by_tool.keys())
+        tool_data = list(cost_breakdown.by_tool.values())
+        # Embed data as JSON for JavaScript
+        subagent_labels_json = json.dumps(subagent_labels)
+        subagent_data_json = json.dumps(subagent_data)
+        tool_labels_json = json.dumps(tool_labels)
+        tool_data_json = json.dumps(tool_data)
+        return f"""<div class="charts">
+        <div class="chart-container">
+            <div class="chart-title">Cost by Subagent Type</div>
+            <canvas id="chartBySubagent" class="chart-canvas"></canvas>
+        </div>
+        <div class="chart-container">
+            <div class="chart-title">Cost by Tool Type</div>
+            <canvas id="chartByTool" class="chart-canvas"></canvas>
+        </div>
+    </div>
+    <script>
+        window.chartData = {{
+            subagent_labels: {subagent_labels_json},
+            subagent_data: {subagent_data_json},
+            tool_labels: {tool_labels_json},
+            tool_data: {tool_data_json}
+        }};
+    </script>
+"""
+    def _html_top_delegations_table(self, top_delegations: list[Any]) -> str:
+        """Generate top delegations table."""
+        table_rows = ""
+        for i, delegation in enumerate(top_delegations, 1):
+            cost_usd = delegation.total_cost_tokens * 0.0000045
+            timestamp = delegation.timestamp.strftime("%Y-%m-%d %H:%M:%S")
+            table_rows += f"""        <tr>
+            <td>{i}</td>
+            <td>{timestamp}</td>
+            <td><strong>{delegation.subagent_type}</strong></td>
+            <td>{delegation.tool_count}</td>
+            <td>{delegation.total_cost_tokens:,}</td>
+            <td>${cost_usd:.2f}</td>
+            <td><code style="font-size: 0.85em; color: #b0b0b0;">{delegation.event_id[:16]}...</code></td>
+        </tr>
+"""
+        return f"""<div class="table-section">
+        <h2>Top 10 Most Expensive Delegations</h2>
+        <div class="table-wrapper">
+            <table>
+                <thead>
+                    <tr>
+                        <th>#</th>
+                        <th>Timestamp</th>
+                        <th>Subagent Type</th>
+                        <th>Tool Count</th>
+                        <th>Cost (tokens)</th>
+                        <th>Cost (USD)</th>
+                        <th>Event ID</th>
+                    </tr>
+                </thead>
+                <tbody>
+{table_rows}                </tbody>
+            </table>
+        </div>
+    </div>
+"""
+    def _html_insights_section(self, roi_stats: Any, cost_breakdown: Any) -> str:
+        """Generate insights and recommendations."""
+        insights = []
+        # Insight 1: ROI summary
+        if roi_stats.savings_percentage > 40:
+            insights.append(
+                (
+                    "Strong Delegation ROI",
+                    f"Your delegation strategy is effective. By properly delegating work, "
+                    f"you're achieving approximately {roi_stats.savings_percentage:.0f}% cost savings "
+                    f"compared to direct execution.",
+                )
+            )
+        else:
+            insights.append(
+                (
+                    "Delegation Opportunity",
+                    f"Current delegation strategy shows {roi_stats.savings_percentage:.0f}% potential savings. "
+                    f"Consider delegating more complex work to specialized subagents.",
+                )
+            )
+        # Insight 2: Most expensive subagent
+        if cost_breakdown.by_subagent:
+            top_subagent = max(cost_breakdown.by_subagent.items(), key=lambda x: x[1])
+            insights.append(
+                (
+                    f"Highest Cost Subagent: {top_subagent[0]}",
+                    f"This subagent type accounts for {top_subagent[1]:,} tokens. "
+                    f"Review the work being delegated here for optimization opportunities.",
+                )
+            )
+        # Insight 3: Most expensive tool
+        if cost_breakdown.by_tool:
+            top_tool = max(cost_breakdown.by_tool.items(), key=lambda x: x[1])
+            insights.append(
+                (
+                    f"Highest Cost Tool: {top_tool[0]}",
+                    f"This tool is consuming {top_tool[1]:,} tokens. "
+                    f"Consider batching operations or using more efficient approaches.",
+                )
+            )
+        # Insight 4: Parallelization benefit
+        insights.append(
+            (
+                "Parallelization Benefit",
+                f"Subagent delegation enables {roi_stats.avg_parallelization_factor:.1f}x efficiency gain "
+                f"through parallel execution and focused context.",
+            )
+        )
+        insights_html = ""
+        for title, text in insights:
+            insights_html += f"""        <div class="insight">
+            <div class="insight-title">{title}</div>
+            <div class="insight-text">{text}</div>
+        </div>
+"""
+        return f"""<div class="insights">
+        <h2>Insights & Recommendations</h2>
+{insights_html}    </div>
+"""
+    def _html_footer_section(self) -> str:
+        """Generate footer section."""
+        return """    <div class="footer">
+        <p>HtmlGraph Cost Attribution Dashboard | OTEL ROI Analysis Phase 1 | <a href="https://code.claude.com">Claude Code</a></p>
+    </div>
+</div>"""
+    def _html_scripts(self, cost_breakdown: Any, all_delegations: Any) -> str:
+        """Generate JavaScript for interactive charts."""
+        return """<script>
+document.addEventListener('DOMContentLoaded', function() {
+    const data = window.chartData || {
+        subagent_labels: [],
+        subagent_data: [],
+        tool_labels: [],
+        tool_data: []
+    };
+    const chartOptions = {
+        responsive: true,
+        maintainAspectRatio: true,
+        plugins: {
+            legend: {
+                labels: {
+                    color: '#e0e0e0',
+                    font: { size: 12 }
+                }
+            },
+            tooltip: {
+                backgroundColor: 'rgba(26, 26, 46, 0.8)',
+                titleColor: '#e0e0e0',
+                bodyColor: '#b0b0b0',
+                borderColor: '#0f3460',
+                borderWidth: 1
+            }
+        },
+        scales: {
+            y: {
+                ticks: { color: '#b0b0b0' },
+                grid: { color: '#16213e' }
+            },
+            x: {
+                ticks: { color: '#b0b0b0' },
+                grid: { color: '#16213e' }
+            }
+        }
+    };
+    // Doughnut chart - Cost by Subagent Type
+    if (data.subagent_labels.length > 0) {
+        const ctxSubagent = document.getElementById('chartBySubagent');
+        if (ctxSubagent) {
+            new Chart(ctxSubagent, {
+                type: 'doughnut',
+                data: {
+                    labels: data.subagent_labels,
+                    datasets: [{
+                        label: 'Cost (tokens)',
+                        data: data.subagent_data,
+                        backgroundColor: [
+                            '#e94560',
+                            '#ff9800',
+                            '#ff6f00',
+                            '#d84315',
+                            '#c62828',
+                            '#0f3460'
+                        ],
+                        borderColor: '#1a1a2e',
+                        borderWidth: 2
+                    }]
+                },
+                options: {
+                    ...chartOptions,
+                    plugins: {
+                        ...chartOptions.plugins,
+                        legend: {
+                            ...chartOptions.plugins.legend,
+                            position: 'bottom'
+                        }
+                    }
+                }
+            });
+        }
+    }
+    // Bar chart - Cost by Tool
+    if (data.tool_labels.length > 0) {
+        const ctxTool = document.getElementById('chartByTool');
+        if (ctxTool) {
+            new Chart(ctxTool, {
+                type: 'bar',
+                data: {
+                    labels: data.tool_labels,
+                    datasets: [{
+                        label: 'Cost (tokens)',
+                        data: data.tool_data,
+                        backgroundColor: '#0f3460',
+                        borderColor: '#e94560',
+                        borderWidth: 2,
+                        borderRadius: 4
+                    }]
+                },
+                options: {
+                    ...chartOptions,
+                    indexAxis: 'y',
+                    plugins: {
+                        ...chartOptions.plugins,
+                        legend: {
+                            ...chartOptions.plugins.legend,
+                            display: true
+                        }
+                    }
+                }
+            });
+        }
+    }
+});
+</script>"""

htmlgraph 0.20.1__py3-none-any.whl → 0.27.5__py3-none-any.whl

htmlgraph 0.20.1py3-none-any.whl → 0.27.5py3-none-any.whl