@githolon/dsl 0.90.1 → 0.91.0

package/dart/lib/src/webview_bridge.dart

@@ -400,6 +400,46 @@ class EncryptionRosterMismatch implements Exception {
       'EncryptionRosterMismatch: roster for "$scope" != expected (the fan-out gate would refuse): missing $missing, unexpected $extra';
 }
 
+/// Thrown when a `.births()` offer ADMITTED on the parent (a head, a 200) but a child workspace did NOT come
+/// up — its `birthOutcomes` entry carried a `status` other than "born" (e.g. `"failed"`/`"refused"` with code
+/// `BirthLawPackageUnavailable`, when the child's law package is not resolvable from the parent's custody).
+/// Without this, the app would open the child and poll `head:null` until timeout with no reason. Callers catch
+/// it to see the child name(s), the kernel [code], and the [reason]. [head] is the parent write that landed.
+class BirthIncomplete implements Exception {
+  /// The raw failed birth outcomes (`{ workspace, status, reason, code }`), status != "born".
+  final List<Map<String, Object?>> failedBirths;
+
+  /// The parent write's local head — the parent offer itself sealed; only the child did not come up.
+  final String head;
+
+  BirthIncomplete(this.failedBirths, {this.head = ''});
+
+  /// The first failed child's kernel code (e.g. `BirthLawPackageUnavailable`), or `BirthFailed`.
+  String get code =>
+      (failedBirths.isNotEmpty ? failedBirths.first['code']?.toString() : null) ?? 'BirthFailed';
+
+  /// The child workspace name(s) that did not come up.
+  List<String> get workspaces => failedBirths
+      .map((o) => (o['workspace'] ?? '').toString())
+      .where((s) => s.isNotEmpty)
+      .toList();
+
+  @override
+  String toString() {
+    final list = failedBirths
+        .map((o) =>
+            '${o['workspace'] ?? '?'} [${o['status']}${o['code'] != null ? ': ${o['code']}' : ''}]'
+            '${o['reason'] != null ? ' — ${o['reason']}' : ''}')
+        .join('; ');
+    final lawUnavailable =
+        failedBirths.any((o) => o['code'] == 'BirthLawPackageUnavailable');
+    return 'BirthIncomplete: ${failedBirths.length} child workspace(s) did NOT come up — $list. '
+        'The parent offer admitted, but the child was not fully born, so opening it would poll head:null '
+        'until timeout. ${lawUnavailable ? "The child's law package is not resolvable from the parent's "
+            "custody — deploy it to the parent (POST /v2/workspaces/<parent>/domains) BEFORE birthing." : "See the outcome's reason/code."}';
+  }
+}
+
 /// The outcome of an epoch-advancing ceremony verb: the new local [head], the [epoch] opened, and the
 /// [roster] the key was wrapped to.
 class NomosEpochResult {
@@ -1348,6 +1388,16 @@ class NomosBridge {
         .whereType<Map>()
         .map((m) => m.cast<String, Object?>())
         .toList();
+    // FAIL FAST on a birth that did NOT come up. The JS holon (index.mjs) already throws on this, so we
+    // normally never see it here — but a runner/bundle skew (an older runner that passes birthOutcomes
+    // through without throwing) must NOT let a silent partial birth reach the app to strand on head:null.
+    // A `status` other than "born" is a failure; throw the typed [BirthIncomplete].
+    final failedBirths = births
+        .where((m) => m['status'] != null && m['status'] != 'born')
+        .toList();
+    if (failedBirths.isNotEmpty) {
+      throw BirthIncomplete(failedBirths, head: (r['head'] ?? '').toString());
+    }
     // `born` elements may be plain workspace-name strings OR `{workspace,…}` objects (both shapes ship);
     // fall back to the birth outcomes' workspace names when no bare `born` list was sent.
     final bornRaw = (r['born'] as List?);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@githolon/dsl",
-  "version": "0.90.1",
+  "version": "0.91.0",
   "type": "module",
   "description": "Nomos 2 domain-authoring DSL: aggregates + directives in TS, executed and encoded to the Rust kernel's wire shapes.",
   "license": "SEE LICENSE IN LICENSE.md",