add cursorless record one and cursorless record silent (#1688)

See each commit for more details as desired.

- add cursorless record one command
- add "cursorless record silent" spoken form


## Checklist

- [/] I have added
[tests](https://www.cursorless.org/docs/contributing/test-case-recorder/)
- [/] I have updated the
[docs](https://github.com/cursorless-dev/cursorless/tree/main/docs) and
[cheatsheet](https://github.com/cursorless-dev/cursorless/tree/main/cursorless-talon/src/cheatsheet)
- [/] I have not broken the cheatsheet

Author: josharian

cursorless-talon-dev/src/cursorless_dev.py

@@ -28,3 +28,7 @@ def cursorless_record_that_mark_test():
         actions.user.run_rpc_command(
             "cursorless.recordTestCase", {"captureFinalThatMark": True}
         )
+
+    def cursorless_record_silent_test():
+        """Start recording Cursorless tests, without confirmation popup windows"""
+        actions.user.run_rpc_command("cursorless.recordTestCase", {"isSilent": True})

cursorless-talon-dev/src/cursorless_dev.talon

@@ -3,6 +3,8 @@ tag: user.cursorless
 
 {user.cursorless_homophone} record:
     user.run_rpc_command("cursorless.recordTestCase")
+{user.cursorless_homophone} record one:
+    user.run_rpc_command("cursorless.recordOneTestCaseThenPause")
 {user.cursorless_homophone} pause:
     user.run_rpc_command("cursorless.pauseRecording")
 {user.cursorless_homophone} resume:
@@ -15,6 +17,7 @@ tag: user.cursorless
     user.cursorless_record_highlights_test()
 {user.cursorless_homophone} record that mark:
     user.cursorless_record_that_mark_test()
+{user.cursorless_homophone} record silent: user.cursorless_record_silent_test()
 
 {user.cursorless_homophone} update cheatsheet:
     user.cursorless_cheat_sheet_update_json()

packages/common/src/cursorlessCommandIds.ts

@@ -37,6 +37,7 @@ export const cursorlessCommandIds = [
   "cursorless.pauseRecording",
   "cursorless.recomputeDecorationStyles",
   "cursorless.recordTestCase",
+  "cursorless.recordOneTestCaseThenPause",
   "cursorless.resumeRecording",
   "cursorless.showCheatsheet",
   "cursorless.showDocumentation",
@@ -58,6 +59,9 @@ export const cursorlessCommandDescriptions: Record<
     "Recompute decoration styles",
   ),
   ["cursorless.recordTestCase"]: new VisibleCommand("Record test case"),
+  ["cursorless.recordOneTestCaseThenPause"]: new VisibleCommand(
+    "Record one test case, then pause",
+  ),
   ["cursorless.pauseRecording"]: new VisibleCommand(
     "Pause test case recording",
   ),

packages/cursorless-engine/src/testCaseRecorder/TestCaseRecorder.ts

@@ -89,6 +89,7 @@ const TIMING_CALIBRATION_HIGHLIGHT_ID = "timingCalibration";
  */
 export class TestCaseRecorder {
   private active: boolean = false;
+  private pauseAfterNextCommand: boolean = false;
   private fixtureRoot: string | null;
   private targetDirectory: string | null = null;
   private testCase: TestCase | null = null;
@@ -117,6 +118,7 @@ export class TestCaseRecorder {
         : null;
 
     this.toggle = this.toggle.bind(this);
+    this.recordOneThenPause = this.recordOneThenPause.bind(this);
     this.pause = this.pause.bind(this);
     this.resume = this.resume.bind(this);
     this.takeSnapshot = this.takeSnapshot.bind(this);
@@ -130,6 +132,15 @@ export class TestCaseRecorder {
       return await this.start(arg);
     }
   }
+
+  async recordOneThenPause(arg?: RecordTestCaseCommandArg) {
+    this.pauseAfterNextCommand = true;
+    this.paused = false;
+    if (!this.active) {
+      return await this.start(arg);
+    }
+  }
+
   async pause() {
     if (!this.active) {
       throw Error("Asked to pause recording, but no recording active");
@@ -290,6 +301,7 @@ export class TestCaseRecorder {
   stop() {
     this.active = false;
     this.paused = false;
+    this.pauseAfterNextCommand = false;
   }
 
   async preCommandHook(hatTokenMap: ReadOnlyHatMap, command: CommandLatest) {
@@ -400,6 +412,10 @@ export class TestCaseRecorder {
     }
 
     this.testCase = null;
+    if (this.pauseAfterNextCommand) {
+      this.paused = true;
+      this.pauseAfterNextCommand = false;
+    }
   }
 
   private async writeToFile(outPath: string, fixture: string) {

packages/cursorless-vscode/package.json

@@ -60,6 +60,7 @@
     "onCommand:cursorless.pauseRecording",
     "onCommand:cursorless.recomputeDecorationStyles",
     "onCommand:cursorless.recordTestCase",
+    "onCommand:cursorless.recordOneTestCaseThenPause",
     "onCommand:cursorless.resumeRecording",
     "onCommand:cursorless.showCheatsheet",
     "onCommand:cursorless.showDocumentation",
@@ -89,6 +90,10 @@
         "command": "cursorless.recordTestCase",
         "title": "Cursorless: Record test case"
       },
+      {
+        "command": "cursorless.recordOneTestCaseThenPause",
+        "title": "Cursorless: Record one test case, then pause"
+      },
       {
         "command": "cursorless.pauseRecording",
         "title": "Cursorless: Pause test case recording"

packages/cursorless-vscode/src/registerCommands.ts

@@ -46,6 +46,8 @@ export function registerCommands(
 
     // Testcase recorder commands
     ["cursorless.recordTestCase"]: testCaseRecorder.toggle,
+    ["cursorless.recordOneTestCaseThenPause"]:
+      testCaseRecorder.recordOneThenPause,
     ["cursorless.pauseRecording"]: testCaseRecorder.pause,
     ["cursorless.resumeRecording"]: testCaseRecorder.resume,
     ["cursorless.takeSnapshot"]: testCaseRecorder.takeSnapshot,