test(aurora): add drift-detection test for aurora-page skill constructor signature

Adds AuroraSkillSignatureTest which uses reflection to assert the documented
Aurora constructor signature in the aurora-page skill matches actual source.
Fixes the documented signature to use correct parameter name ($cdn, not $cdnPath)
and reflect nullable types with default values. This catches the §1.2 failure
class — hand-written skill documentation drifting from source — at the /check
gate on every run.

Plan-by: glm-5.2
Acked-by: deepseek-v4-pro
Signed-off-by: kyau <git@kyaulabs.com>

Author: kyau

.opencode/skills/aurora-page/SKILL.md

@@ -57,11 +57,11 @@ echo $site->comment($rus, basename(__FILE__));
 ## Aurora Constructor Parameters
 
 ```php
-new KYAULabs\Aurora(string $template, string $cdnPath, bool $status, bool $html, ?string $templateDir = null)
+new KYAULabs\Aurora(?string $template = null, ?string $cdn = '/cdn', bool $status = false, bool $html = false, ?string $templateDir = null)
 ```
 
 - `$template` — base HTML template name (e.g. `"index.html"`)
-- `$cdnPath` — path prefix for CDN assets (e.g. `"/cdn"`)
+- `$cdn` — CDN directory path (e.g. `"/cdn"`)
 - `$status` — **debug mode**: enables `display_errors`, `display_startup_errors`, `E_ALL` reporting, and `html_errors`. Must be `false` in production. Wire to `(bool)($_ENV['APP_DEBUG'] ?? false)`.
 - `$html` — **HTML output mode**: sets `mb_http_output('UTF-8')` and sends `Content-Type: text/html; charset=UTF-8` header
 - `$templateDir` — optional custom template overlay directory (checked first; falls back to Aurora's default `html/` directory)

tests/Integration/AuroraSkillSignatureTest.php

@@ -0,0 +1,95 @@
+<?php
+
+declare(strict_types=1);
+
+# $KYAULabs: AuroraSkillSignatureTest.php kyau@nova 2026/07/05 -0700 Exp $
+
+require_once __DIR__ . '/../../aurora/aurora.inc.php';
+
+use KYAULabs\Aurora;
+
+/**
+ * Asserts that the Aurora constructor signature documented in the
+ * aurora-page skill matches the actual source code. Catches the §1.2
+ * failure class — hand-written skill documentation drifting from
+ * source — at the /check gate on every run. Pairs with the
+ * AuroraConstructorStatusTest for the $status sharp edge.
+ */
+
+test('aurora-page skill constructor signature matches actual source', function () {
+    // 1. Get the real signature via reflection
+    $reflected = new ReflectionMethod(Aurora::class, '__construct');
+    $params = $reflected->getParameters();
+
+    $realSignature = '';
+    foreach ($params as $param) {
+        $type = $param->getType();
+        $typeStr = '';
+        if ($type instanceof ReflectionNamedType) {
+            if ($type->allowsNull() && !$param->isDefaultValueAvailable()) {
+                $typeStr = '?' . $type->getName();
+            } elseif ($type->allowsNull() && $param->isDefaultValueAvailable() && $param->getDefaultValue() === null) {
+                $typeStr = '?' . $type->getName();
+            } elseif ($type->allowsNull()) {
+                $typeStr = '?' . $type->getName();
+            } else {
+                $typeStr = $type->getName();
+            }
+        }
+
+        $sig = '$' . $param->getName();
+        if ($param->isDefaultValueAvailable()) {
+            $default = $param->getDefaultValue();
+            $sig .= ' = ';
+            if ($default === null) {
+                $sig .= 'null';
+            } elseif ($default === false) {
+                $sig .= 'false';
+            } elseif ($default === true) {
+                $sig .= 'true';
+            } elseif (is_string($default)) {
+                $sig .= var_export($default, true);
+            } else {
+                $sig .= var_export($default, true);
+            }
+        }
+
+        $realSignature .= ($realSignature === '' ? '' : ' ') . ltrim($typeStr . ' ' . $sig);
+    }
+
+    // 2. Parse the documented signature from the skill file
+    $skillPath = __DIR__ . '/../../.opencode/skills/aurora-page/SKILL.md';
+    $skillContent = file_get_contents($skillPath);
+
+    // Extract the constructor signature from the fenced PHP block.
+    // Must match the documented signature (with type-hinted params like
+    // "?string $template = null"), NOT the named-argument usage call
+    // ("template: ...") that appears earlier in the skill file.
+    preg_match('/new\s+KYAULabs\\\\Aurora\(\s*(\??\w+\s+\$\w+(?:\s*=\s*(?:null|true|false|\'[^\']*\'|"[^"]*"|\d+))?\s*,?\s*)+\)/', $skillContent, $matches);
+    $matchText = $matches[0] ?? '';
+    preg_match('/new\s+KYAULabs\\\\Aurora\(([^)]+)\)/', $matchText, $matches);
+
+    expect($matches)->toHaveCount(2, 'Could not find Aurora constructor call in aurora-page SKILL.md');
+
+    $docArgs = $matches[1];
+    // Remove whitespace
+    $docArgs = preg_replace('/\s+/', ' ', trim($docArgs));
+
+    // 3. Build the expected signature from the doc
+    $docParams = array_map('trim', explode(',', $docArgs));
+    $docSignature = implode(' ', $docParams);
+
+    // 4. Compare
+    $realSignature = str_replace('  ', ' ', trim(preg_replace('/\s+/', ' ', $realSignature)));
+    $docSignature = trim($docSignature);
+
+    expect($docSignature)->toBe(
+        $realSignature,
+        "aurora-page SKILL.md constructor signature does not match actual Aurora source.\n" .
+        "  Documented: {$docSignature}\n" .
+        "  Actual:     {$realSignature}\n" .
+        'Fix: update the signature in .opencode/skills/aurora-page/SKILL.md',
+    );
+});
+
+// vim: ft=php sts=4 sw=4 ts=4 et :