Bar: added support for AI agents [WIP]

Author: dg

src/Tracy/Bar/Bar.php

@@ -63,6 +63,18 @@ public function renderLoader(DeferredContent $defer): void
 	}
 
 
+	/**
+	 * Renders debug bar as plain text (markdown).
+	 */
+	public function renderAsText(): void
+	{
+		$time = microtime(true) - Debugger::$time;
+		$memory = memory_get_peak_usage() / 1_000_000;
+		$warningsPanel = $this->panels['Tracy:warnings'] ?? null;
+		require __DIR__ . '/dist/markdown.phtml';
+	}
+
+
 	/**
 	 * Renders debug bar.
 	 */

src/Tracy/Bar/assets/markdown.latte

@@ -0,0 +1,20 @@
+{*
+ * Tracy Bar rendered as HTML comment (for AI agents).
+ *
+ * @var float $time
+ * @var float $memory
+ * @var ?Tracy\DefaultBarPanel $warningsPanel
+ *}
+
+<!-- tracy
+Tracy Bar | {=number_format($time * 1000, 1)} ms | {=number_format($memory, 2)} MB
+{if $warningsPanel instanceof \Tracy\DefaultBarPanel && $warningsPanel->data}
+
+## Warnings
+
+{foreach $warningsPanel->data as $key => $count}
+{do [$file, $line, $message] = explode('|', $key, 3)}
+- {=$message . ' in ' . $file . ':' . $line . ($count > 1 ? " (×" . $count . ')' : '')}
+{/foreach}
+{/if}
+-->

src/Tracy/Bar/dist/markdown.phtml

@@ -0,0 +1,24 @@
+<?php
+declare(strict_types=1);
+?>
+<?php /**
+ * Tracy Bar rendered as HTML comment (for AI agents).
+ *
+ * @var float $time
+ * @var float $memory
+ * @var ?Tracy\DefaultBarPanel $warningsPanel
+ */ ?>
+
+<!-- tracy
+Tracy Bar | <?= number_format($time * 1000, 1) ?> ms | <?= number_format($memory, 2) ?> MB
+<?php if ($warningsPanel instanceof \Tracy\DefaultBarPanel && $warningsPanel->data): ?>
+
+## Warnings
+
+<?php foreach ($warningsPanel->data as $key => $count): ?>
+<?php [$file, $line, $message] = explode('|', $key, 3) ?>
+- <?= $message . ' in ' . $file . ':' . $line . ($count > 1 ? " (×" . $count . ')' : '') ?>
+
+<?php endforeach ?>
+<?php endif ?>
+-->

src/Tracy/Debugger/DevelopmentStrategy.php

@@ -135,6 +135,10 @@ public function renderBar(): void
 			ini_set('display_errors', '1');
 		}
 
-		$this->bar->render($this->defer);
+		if (Helpers::isAgent()) {
+			$this->bar->renderAsText();
+		} else {
+			$this->bar->render($this->defer);
+		}
 	}
 }

tests/Tracy/Bar.renderAsText().phpt

@@ -0,0 +1,72 @@
+<?php
+
+/**
+ * Test: Tracy\Bar::renderAsText()
+ */
+
+declare(strict_types=1);
+
+use Tester\Assert;
+use Tracy\Debugger;
+
+require __DIR__ . '/../bootstrap.php';
+
+
+test('info line with time and memory', function () {
+	Debugger::$productionMode = false;
+	Debugger::$time = microtime(true) - 0.05; // simulate 50 ms
+	$bar = Debugger::getBar();
+
+	ob_start();
+	$bar->renderAsText();
+	$output = ob_get_clean();
+
+	Assert::match('
+<!-- tracy
+Tracy Bar | %a% ms | %a% MB
+-->
+', $output);
+});
+
+
+test('warnings rendering', function () {
+	$bar = new Tracy\Bar;
+	$panel = new Tracy\DefaultBarPanel('warnings');
+	$panel->data = [
+		'/app/foo.php|10|Notice: Undefined variable $x' => 3,
+		'/app/bar.php|25|Deprecated: implode()' => 1,
+	];
+	$bar->addPanel($panel, 'Tracy:warnings');
+
+	ob_start();
+	$bar->renderAsText();
+	$output = ob_get_clean();
+
+	Assert::match('
+<!-- tracy
+Tracy Bar | %a% ms | %a% MB
+
+## Warnings
+
+- Notice: Undefined variable $x in /app/foo.php:10 (' . "\u{00d7}" . '3)
+- Deprecated: implode() in /app/bar.php:25
+-->
+', $output);
+});
+
+
+test('no warnings section when empty', function () {
+	$bar = new Tracy\Bar;
+	$panel = new Tracy\DefaultBarPanel('warnings');
+	$bar->addPanel($panel, 'Tracy:warnings');
+
+	ob_start();
+	$bar->renderAsText();
+	$output = ob_get_clean();
+
+	Assert::match('
+<!-- tracy
+Tracy Bar | %a% ms | %a% MB
+-->
+', $output);
+});