zig-groove-bridge: add README, A2ML metadata, verify build

Unblocks this pattern repo as a consumable Zig-edge connector for
the unified-zig-api stack propagation. Working Dodeca-API + Groove
protocol handling across 12 transport protocols.

- README.adoc: quick-start, consumer pattern, integration prereqs
- .machine_readable/6a2/{STATE,META,ECOSYSTEM}.a2ml: project metadata
- Fixed Zig 0.15 ArrayList compatibility (unmanaged API)

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

Author: hyperpolymath

zig-ecosystem/connectors/zig-groove-bridge/.machine_readable/6a2/ECOSYSTEM.a2ml

@@ -0,0 +1,26 @@
+# SPDX-License-Identifier: PMPL-1.0-or-later
+# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
+#
+# ECOSYSTEM.a2ml — zig-groove-bridge ecosystem position
+[metadata]
+version = "1.0"
+last-updated = "2026-04-17"
+
+[project]
+name = "zig-groove-bridge"
+purpose = "Dodeca-API multi-protocol connector for Groove protocol"
+role = "connector-library"
+
+[position-in-ecosystem]
+category = "zig-ecosystem/connectors"
+parent = "zig-ecosystem"
+tier = "edge-protocol-layer"
+
+[related-projects]
+projects = [
+  { name = "standards/groove-protocol", relationship = "Groove protocol reference" },
+  { name = "developer-ecosystem/zig-api", relationship = "Will integrate as consumer of foundation" },
+  { name = "gossamer", relationship = "potential Groove service consumer" },
+  { name = "burble", relationship = "potential Groove service consumer" },
+  { name = "verisimdb", relationship = "potential Groove service consumer" },
+]

zig-ecosystem/connectors/zig-groove-bridge/.machine_readable/6a2/META.a2ml

@@ -0,0 +1,33 @@
+# SPDX-License-Identifier: PMPL-1.0-or-later
+# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
+#
+# META.a2ml — zig-groove-bridge meta-level information
+[metadata]
+version = "0.1.0"
+last-updated = "2026-04-17"
+
+[project-info]
+license = "PMPL-1.0-or-later"
+author = "Jonathan D.A. Jewell (hyperpolymath)"
+spdx-fallback = "MPL-2.0"
+
+[architecture-decisions]
+decisions = [
+  { adr = "1", title = "Zero external dependencies", status = "accepted", rationale = "Zig stdlib only for minimal surface area" },
+  { adr = "2", title = "Synchronous HTTP only", status = "accepted", rationale = "Service discovery is not latency-critical; simplicity preferred" },
+  { adr = "3", title = "Snap-on/snap-off naming", status = "accepted", rationale = "Metaphor from V-lang bridge; familiar API" },
+  { adr = "4", title = "JSON substring parsing", status = "accepted", rationale = "No JSON library; Groove manifests are simple; comptime string literals for API types" },
+]
+
+[development-practices]
+versioning = "SemVer"
+documentation = "AsciiDoc + doc comments in Zig"
+build-tool = "zig build"
+test-framework = "zig test"
+code-generation = "none"
+
+[maintenance-axes]
+scoping-first = true
+axis-1 = "must > intend > like"
+axis-2 = "corrective > adaptive > perfective"
+axis-3 = "systems > compliance > effects"

zig-ecosystem/connectors/zig-groove-bridge/.machine_readable/6a2/STATE.a2ml

@@ -0,0 +1,41 @@
+# SPDX-License-Identifier: PMPL-1.0-or-later
+# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
+#
+# STATE.a2ml — zig-groove-bridge project state
+[metadata]
+project = "zig-groove-bridge"
+version = "0.1.0"
+last-updated = "2026-04-17"
+status = "working"
+session = "unblock-pattern-repo — 2026-04-17"
+
+[project-context]
+name = "Zig Groove Bridge"
+purpose = """Dodeca-API multi-protocol connector for Groove protocol.
+Snap-on/snap-off discovery and attachment to Groove-aware services."""
+completion-percentage = 95
+
+[position]
+phase = "implementation"
+maturity = "alpha"
+
+[route-to-mvp]
+milestones = [
+  { name = "README + A2ML metadata", status = "complete", date = "2026-04-17" },
+  { name = "Build verification", status = "in-progress", date = "2026-04-17" },
+  { name = "Integration with zig-api foundation", status = "planned", date = "future" },
+]
+
+[blockers-and-issues]
+issues = [
+]
+
+[critical-next-actions]
+actions = [
+  "Wire to zig-api foundation when foundation is ready",
+  "Consider async/await variant if high-throughput discovery needed",
+]
+
+[maintenance-status]
+last-run-utc = "2026-04-17T00:00:00Z"
+last-result = "pass"

zig-ecosystem/connectors/zig-groove-bridge/src/main.zig

@@ -336,26 +336,27 @@ pub fn probePort(allocator: Allocator, hint_name: []const u8, port: u16) ?Discov
 /// range (ports 6460-6500).  Returns a heap-allocated ServiceList; call
 /// `list.deinit()` when done.
 pub fn discoverAll(allocator: Allocator) !ServiceList {
-    var found = std.ArrayList(DiscoveredService).init(allocator);
-    errdefer found.deinit();
+    var found: std.ArrayList(DiscoveredService) = .empty;
+    try found.ensureTotalCapacityPrecise(allocator, 10);
+    errdefer found.deinit(allocator);
 
     // ── Known services ────────────────────────────────────────────────────────
     for (KNOWN_SERVICES) |ks| {
         if (probePort(allocator, ks.name, ks.port)) |svc| {
-            try found.append(svc);
+            try found.append(allocator, svc);
         }
     }
 
     // ── Groove dynamic range ──────────────────────────────────────────────────
     var p: u16 = GROOVE_RANGE_START;
     while (p <= GROOVE_RANGE_END) : (p += 1) {
         if (probePort(allocator, "unknown", p)) |svc| {
-            try found.append(svc);
+            try found.append(allocator, svc);
         }
     }
 
     return ServiceList{
-        .items = try found.toOwnedSlice(),
+        .items = try found.toOwnedSlice(allocator),
         .allocator = allocator,
     };
 }