Add an IsolateRunnable event to the service protocol. Improve service docs.

runtime/observatory/tests/service/isolate_lifecycle_test.dart

 // Copyright (c) 2015, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 // VMOptions=--error_on_bad_type --error_on_bad_override
 
 import 'dart:async';
+import 'dart:developer';
 import 'dart:isolate' as I;
 
 import 'package:observatory/service_io.dart';
 import 'package:unittest/unittest.dart';
 
 import 'test_helper.dart';
 
 final spawnCount = 4;
 final resumeCount = spawnCount ~/ 2;
 final isolates = [];
 
 void spawnEntry(int i) {
 }
 
-Future before() async {
+Future during() async {
+  debugger();
   // Spawn spawnCount long lived isolates.
   for (var i = 0; i < spawnCount; i++) {
     var isolate = await I.Isolate.spawn(spawnEntry, i);
     isolates.add(isolate);
   }
   print('spawned all isolates');
 }
 
-Future during() async {
-}
-
 int numPaused(vm) {
   int paused = 0;
   for (var isolate in vm.isolates) {
     if (isolate.paused) {
       paused++;
     }
   }
   return paused;
 }
 
 var tests = [
   (VM vm) async {
+    expect(vm.isolates.length, 1);
+    await hasStoppedAtBreakpoint(vm.isolates[0]);
+  },
+
+  (VM vm) async {
     Completer completer = new Completer();
     var stream = await vm.getEventStream(VM.kIsolateStream);
-    if (vm.isolates.length < spawnCount + 1) {
-      var subscription;
-      subscription = stream.listen((ServiceEvent event) {
-        if (event.kind == ServiceEvent.kIsolateStart) {
-          if (vm.isolates.length == (spawnCount + 1)) {
-            subscription.cancel();
-            completer.complete(null);
-          }
-        }
-      });
-      await completer.future;
-    }
+    var subscription;
+    int startCount = 0;
+    int runnableCount = 0;
+    subscription = stream.listen((ServiceEvent event) {
+      if (event.kind == ServiceEvent.kIsolateStart) {
+        startCount++;
+      }
+      if (event.kind == ServiceEvent.kIsolateRunnable) {
+        runnableCount++;
+      }
+      if (runnableCount == spawnCount) {
+        subscription.cancel();
+        completer.complete(null);
+      }
+    });
+    expect(vm.isolates.length, 1);
+    vm.isolates[0].resume();
+    await completer.future;
+    expect(startCount, spawnCount);
+    expect(runnableCount, spawnCount);
     expect(vm.isolates.length, spawnCount + 1);
   },
 
   (VM vm) async {
     // Load each isolate.
     for (var isolate in vm.isolates) {
       await isolate.load();
     }
   },
 
@@ skipping 48 matching lines @@
     }
     await completer.future;
   },
 
   (VM vm) async {
     expect(numPaused(vm), spawnCount + 1 - resumeCount); 
   },
 ];
 
 main(args) async => runVMTests(args, tests,
-                               testeeBefore: before,
                                testeeConcurrent: during,
                                pause_on_exit: true);