chore: remove all development phase markers from code and tests

Author: MADEVAL

packages/hydraline/CHANGELOG.md

@@ -1,4 +1,4 @@
 ## 0.0.1
 
-- Initial package skeleton (Phase 0): pure-Dart core scaffolding, strict
-  analysis, dependency-boundary enforcement (I1) and CI.
+- Initial package skeleton: pure-Dart core scaffolding, strict
+  analysis, dependency-boundary enforcement and CI.

packages/hydraline/README.md

@@ -4,7 +4,4 @@ Pure-Dart core of [Hydraline](../../README.md): the `DocumentNode` model, a
 single-pass deterministic HTML serializer, contextual escaping/`SafeUrl`, SEO
 metadata, JSON-LD, sitemap/robots and island/route manifests.
 
-No `package:flutter`, `dart:ui` or `dart:html` (invariant I1).
-
-> Status: pre-MVP skeleton (Phase 0). Public API lands in Phase 1 — see
-> `specs/PHASE_1_PLAN.md`.
+No `package:flutter`, `dart:ui` or `dart:html`.

packages/hydraline/example/README.md

@@ -1,4 +1,4 @@
 # hydraline example
 
-Runnable examples arrive with the public API in Phase 1
-(`specs/PHASE_1_PLAN.md`). This package currently exposes only skeleton scaffolding.
+Runnable examples arrive with the public API.
+This package currently exposes only skeleton scaffolding.

packages/hydraline/lib/hydraline.dart

@@ -1,8 +1,7 @@
 /// Hydraline core — pure-Dart document model, HTML serializer, escaping and SEO
 /// artifacts.
 ///
-/// This package must not import `package:flutter/*`, `dart:ui` or `dart:html`
-/// (invariant I1); enforced by `melos run boundaries`.
+/// This package must not import `package:flutter/*`, `dart:ui` or `dart:html`.
 library;
 
 export 'src/assets/htmx_glue.dart' show htmxGlueJs;

packages/hydraline/lib/src/assets/vanilla_islands.dart

@@ -1,5 +1,4 @@
-/// Standalone vanilla-islands JavaScript bundle for level-1 interactivity
-/// (ARCHITECTURE.md §13; C-12).
+/// Standalone vanilla-islands JavaScript bundle for level-1 interactivity.
 ///
 /// Enhances static HTML elements tagged with `data-island` attributes. Runs on
 /// `DOMContentLoaded` and does not depend on Flutter or any other runtime.

packages/hydraline/lib/src/audit.dart

@@ -1,5 +1,5 @@
 /// CLI audit: "what the crawler sees" (standalone) and the buffered↔chunked
-/// body-identity comparator (server-integration) (ARCHITECTURE.md §7; C-11).
+/// body-identity comparator (server-integration).
 library;
 
 import 'package:html/parser.dart' as html;
@@ -19,8 +19,8 @@ abstract final class Audit {
   static const int _titleMaxLength = 70;
   static const int _descriptionMaxLength = 160;
 
-  /// C-11(a) standalone: audits the raw HTML a crawler would see — title,
-  /// meta description, Open Graph, canonical, headings and image alt (A1/A2).
+/// Standalone: audits the raw HTML a crawler would see — title,
+/// meta description, Open Graph, canonical, headings and image alt.
   static AuditReport auditHtml(String source) {
     final document = html.parse(source);
     final issues = <ValidationIssue>[];
@@ -31,7 +31,7 @@ abstract final class Audit {
         const ValidationIssue(
           severity: ValidationSeverity.error,
           code: 'title_missing',
-          message: '<title> is missing or empty (SEO-1).',
+          message: '<title> is missing or empty.',
         ),
       );
     } else if (title.length > _titleMaxLength) {
@@ -52,7 +52,7 @@ abstract final class Audit {
         const ValidationIssue(
           severity: ValidationSeverity.warning,
           code: 'description_missing',
-          message: 'meta description is missing (SEO-1).',
+          message: 'meta description is missing.',
         ),
       );
     } else if (description.length > _descriptionMaxLength) {
@@ -75,7 +75,7 @@ abstract final class Audit {
         const ValidationIssue(
           severity: ValidationSeverity.warning,
           code: 'og_missing',
-          message: 'Open Graph og:title/og:image are recommended (SEO-2, A2).',
+          message: 'Open Graph og:title/og:image are recommended.',
         ),
       );
     }
@@ -85,7 +85,7 @@ abstract final class Audit {
         const ValidationIssue(
           severity: ValidationSeverity.warning,
           code: 'h1_missing',
-          message: 'no <h1> found (SEO-11).',
+          message: 'no <h1> found.',
         ),
       );
     }
@@ -97,7 +97,7 @@ abstract final class Audit {
           const ValidationIssue(
             severity: ValidationSeverity.error,
             code: 'image_missing_alt',
-            message: 'an <img> is missing alt text (SEO-11).',
+            message: 'an <img> is missing alt text.',
           ),
         );
       }
@@ -118,9 +118,9 @@ abstract final class Audit {
     return AuditReport(issues: issues, exitCode: _exitCode(issues));
   }
 
-  /// C-11(b) server-integration comparator (A8/I3): the document body served
-  /// buffered (to bots) must be byte-identical to the concatenation of the
-  /// streamed chunks (to users).
+/// Server-integration comparator: the document body served buffered (to bots)
+/// must be byte-identical to the concatenation of the streamed chunks (to
+/// users).
   static AuditReport compareBodies(String buffered, List<String> chunks) {
     final concatenated = chunks.join();
     if (buffered == concatenated) {
@@ -131,8 +131,7 @@ abstract final class Audit {
         severity: ValidationSeverity.error,
         code: 'body_mismatch',
         message:
-            'buffered body differs from concatenated chunks — cloaking risk '
-            '(I3/A8).',
+            'buffered body differs from concatenated chunks — cloaking risk.',
       ),
     ];
     return AuditReport(issues: issues, exitCode: _exitCode(issues));

packages/hydraline/lib/src/collector.dart

@@ -1,13 +1,13 @@
 /// `SsgCollector`: pure-Dart collector for self-registering widgets (surface A)
-/// that seals into a [DocumentNode] tree (ARCHITECTURE.md §9; C-9, CO1-CO4).
+/// that seals into a [DocumentNode] tree.
 library;
 
 import 'document_node.dart';
 import 'escaping.dart' show SafeUrl;
 import 'island_manifest.dart' show IslandSpec;
 import 'metadata.dart';
 
-/// Instance-scoped collector (CO1). Immutable after [seal] (CO4).
+/// Instance-scoped collector. Immutable after [seal].
 abstract interface class SsgCollector {
   factory SsgCollector(String route) = _SsgCollector;
 
@@ -24,7 +24,7 @@ abstract interface class SsgCollector {
   void addNode(DocumentNode node, {String? key});
   void addMeta(SeoMeta meta);
 
-  /// Finalises: dedup by key, N5 (no cycles), immutable result.
+  /// Finalises: dedup by key, no cycles, immutable result.
   DocumentNode seal();
 }
 
@@ -39,7 +39,7 @@ class _SsgCollector implements SsgCollector {
 
   void _add(DocumentNode node, String? key) {
     if (_sealed != null) {
-      return; // CO4
+      return;
     }
     if (key != null) {
       if (_keys.contains(key)) {
@@ -81,7 +81,7 @@ class _SsgCollector implements SsgCollector {
   @override
   void addMeta(SeoMeta meta) {
     if (_sealed != null) {
-      return; // CO4
+      return;
     }
     _meta = meta;
   }

packages/hydraline/lib/src/document_node.dart

@@ -1,9 +1,8 @@
-/// The `DocumentNode` tree (ARCHITECTURE.md §4).
+/// The `DocumentNode` tree.
 ///
 /// The hierarchy is `sealed`, so the serializer walks it with an exhaustive
-/// `switch` (no external visitor). Invariants: N1 (immutable), N2 (text stored
-/// raw, escaped only on serialization), N3 (URL fields are always [SafeUrl]),
-/// N4 (deterministic), N5 (tree without cycles).
+/// `switch` (no external visitor). Invariants: immutable, text stored raw (escaped only on serialization),
+/// URL fields are always [SafeUrl], deterministic, tree without cycles.
 library;
 
 import 'escaping.dart' show SafeUrl;
@@ -12,7 +11,7 @@ import 'escaping.dart' show SafeUrl;
 sealed class DocumentNode {
   const DocumentNode();
 
-  /// Child nodes (empty for leaves). N5: no cycles.
+  /// Child nodes (empty for leaves). No cycles.
   List<DocumentNode> get children;
 }
 
@@ -25,7 +24,7 @@ final class DocumentRootNode extends DocumentNode {
   final HeadNode? head;
   final List<DocumentNode> body;
 
-  /// Optional `lang` for the `<html>` element (SEO-8).
+  /// Optional `lang` for the `<html>` element.
   final String? lang;
 
   @override
@@ -44,7 +43,7 @@ final class HeadNode extends DocumentNode {
 final class TitleNode extends DocumentNode {
   const TitleNode(this.text);
 
-  /// Raw title text; escaped only on serialization (N2/S2).
+  /// Raw title text; escaped only on serialization.
   final String text;
 
   @override
@@ -158,7 +157,7 @@ final class CodeNode extends DocumentNode {
   List<DocumentNode> get children => const [];
 }
 
-/// A `<time>` element carrying an ISO-8601 `dateTime` (determinism, DS3).
+/// A `<time>` element carrying an ISO-8601 `dateTime`.
 final class TimeNode extends DocumentNode {
   const TimeNode({required this.dateTime, required this.children});
 
@@ -246,7 +245,7 @@ enum IslandRenderMode { ssr, skeletonOnly }
 /// How island styles are scoped.
 enum IslandStyleMode { shadow, scoped }
 
-/// Reserved placeholder size in px (anti-CLS, I8).
+/// Reserved placeholder size in px to prevent layout shift.
 final class IslandSize {
   const IslandSize({required this.width, required this.height});
 
@@ -321,7 +320,7 @@ final class VanillaIslandNode extends DocumentNode {
 
 // ── Unsafe HTML (opt-in, the only raw-HTML escape hatch) ─────────────────────
 
-/// The only path for raw HTML (S3). The name intentionally contains "Unsafe".
+/// The only path for raw HTML. The name intentionally contains "Unsafe".
 /// Without a [sanitizer] the `SeoValidator` emits a warning.
 final class UnsafeHtmlNode extends DocumentNode {
   const UnsafeHtmlNode(this.rawHtml, {this.sanitizer});
@@ -337,7 +336,7 @@ final class UnsafeHtmlNode extends DocumentNode {
   List<DocumentNode> get children => const [];
 }
 
-/// A `<script type="application/ld+json">` structured-data block (SEO-4).
+/// A `<script type="application/ld+json">` structured-data block.
 ///
 /// This is the only `<script>` the serializer emits; its content is JSON data
 /// (not executable code) and is escaped to prevent `</script>` breakout.
@@ -352,7 +351,7 @@ final class JsonLdNode extends DocumentNode {
 
 // ── Inline ───────────────────────────────────────────────────────────────────
 
-/// Text content. Stored raw (N2); always escaped on serialization (S2).
+/// Text content. Stored raw; always escaped on serialization.
 final class TextNode extends DocumentNode {
   const TextNode(this.text);
 
@@ -362,7 +361,7 @@ final class TextNode extends DocumentNode {
   List<DocumentNode> get children => const [];
 }
 
-/// An anchor `<a href>`; `href` is always a [SafeUrl] (N3).
+/// An anchor `<a href>`; `href` is always a [SafeUrl].
 final class AnchorNode extends DocumentNode {
   const AnchorNode({required this.href, required this.children, this.rel});
 
@@ -373,7 +372,7 @@ final class AnchorNode extends DocumentNode {
   final List<DocumentNode> children;
 }
 
-/// An image `<img src alt>`; `src` is always a [SafeUrl] (N3).
+/// An image `<img src alt>`; `src` is always a [SafeUrl].
 final class ImageNode extends DocumentNode {
   const ImageNode({
     required this.src,

packages/hydraline/lib/src/escaping.dart

@@ -1,10 +1,10 @@
-/// Contextual HTML escaping and URL sanitisation (ARCHITECTURE.md §5).
+/// Contextual HTML escaping and URL sanitisation.
 ///
-/// Invariants: S1 (scheme allowlist), S2 (mandatory escaping),
-/// S4 (0 XSS on fuzzing), S5 (CSP helper).
+/// Invariants: scheme allowlist, mandatory escaping,
+/// zero XSS on fuzzing, CSP helper.
 library;
 
-/// Escapes text content: `&`, `<`, `>` become entities (S2).
+/// Escapes text content: `&`, `<`, `>` become entities.
 ///
 /// Quotes are intentionally left untouched — text and attribute contexts use
 /// different escapers so they can never be confused (see [escapeHtmlAttribute]).
@@ -28,7 +28,7 @@ String escapeHtmlText(String input) {
   return buffer.toString();
 }
 
-/// Escapes an attribute value: `&`, `<`, `>`, `"`, `'` become entities (S2).
+/// Escapes an attribute value: `&`, `<`, `>`, `"`, `'` become entities.
 String escapeHtmlAttribute(String input) {
   if (!input.contains(RegExp('[&<>"\']'))) {
     return input;
@@ -55,7 +55,7 @@ String escapeHtmlAttribute(String input) {
 
 /// A URL that has passed scheme sanitisation. There is **no** public
 /// constructor: instances come only from [SafeUrl.parse]/[SafeUrl.tryParse],
-/// so a node can never be built with an unchecked URL (N3/S1).
+/// so a node can never be built with an unchecked URL.
 abstract interface class SafeUrl {
   /// The sanitised string value.
   String get value;
@@ -64,7 +64,7 @@ abstract interface class SafeUrl {
   ///
   /// Allowlist: `http`, `https`, `mailto`, `tel` and relative URLs
   /// (`/`, `./`, `#`, `?`, bare paths). Blocked: everything else, including
-  /// `javascript:`, `data:`, `vbscript:` (S1).
+  /// `javascript:`, `data:`, `vbscript:`.
   static SafeUrl? tryParse(String raw) {
     final cleaned = raw.replaceAll(RegExp('[\u0000-\u001F\u007F]'), '').trim();
     final scheme = RegExp(r'^([a-zA-Z][a-zA-Z0-9+.\-]*):').firstMatch(cleaned);
@@ -103,7 +103,7 @@ final class _SafeUrl implements SafeUrl {
   String toString() => 'SafeUrl($value)';
 }
 
-/// Thrown by [SafeUrl.parse] when a URL's scheme is not allowed (S1).
+/// Thrown by [SafeUrl.parse] when a URL's scheme is not allowed.
 class UnsafeUrlException implements Exception {
   const UnsafeUrlException(this.raw, this.reason);
 
@@ -114,7 +114,7 @@ class UnsafeUrlException implements Exception {
   String toString() => 'UnsafeUrlException: $reason ($raw)';
 }
 
-/// Helper for the recommended Content-Security-Policy (S5):
+/// Helper for the recommended Content-Security-Policy:
 /// `script-src 'self' 'wasm-unsafe-eval'` (no `unsafe-inline`; CanvasKit needs
 /// `wasm-unsafe-eval`).
 abstract final class Csp {

packages/hydraline/lib/src/html_serializer.dart

@@ -1,9 +1,9 @@
-/// Single-pass HTML serializer (ARCHITECTURE.md §6).
+/// Single-pass HTML serializer.
 ///
-/// Invariants: SER1 (single pass into a [StringSink], no intermediate tree),
-/// SER2 (deterministic, stable attribute order), SER3 (O(nodes + text), no
-/// quadratic concatenation), SER4 (`serialize == concat(serializeToStream)`),
-/// SER5 (line endings are always `\n`).
+/// Invariants: single pass into a [StringSink] with no intermediate tree,
+/// deterministic with stable attribute order, O(nodes + text) with no quadratic
+/// concatenation, `serialize == concat(serializeToStream)`, line endings are
+/// always `\n`.
 library;
 
 import 'dart:convert';
@@ -24,10 +24,10 @@ abstract interface class HtmlSerializer {
   /// Default implementation.
   const factory HtmlSerializer([SerializerOptions options]) = _HtmlSerializer;
 
-  /// Buffered HTML (bots / SSG file). SER1/SER2.
+  /// Buffered HTML (bots / SSG file).
   String serialize(DocumentNode root);
 
-  /// Progressive in-order stream (SSR). SER4: equals [serialize] concatenated.
+  /// Progressive in-order stream (SSR). Equals [serialize] concatenated.
   Stream<String> serializeToStream(DocumentNode root);
 
   /// A fragment without `<html>/<head>` (HTMX responses).
@@ -259,7 +259,7 @@ class _HtmlSerializer implements HtmlSerializer {
   }
 
   /// Encodes JSON-LD, escaping `<`, `>` and `&` as `\uXXXX` so the payload can
-  /// never break out of the surrounding `<script>` element (S2/S4).
+  /// never break out of the surrounding `<script>` element.
   String _encodeJsonLd(Map<String, Object?> json) => jsonEncode(json)
       .replaceAll('<', r'\u003c')
       .replaceAll('>', r'\u003e')