merge: branch 'dev' into chore/toolchain

Pantograph/Goal.lean

@@ -260,6 +260,7 @@ protected def GoalState.tryTacticM
     (state: GoalState) (goal: MVarId) (tacticM: Elab.Tactic.TacticM Unit)
     (guardMVarErrors : Bool := false)
     : Elab.TermElabM TacticResult := do
+  assert! ¬ (← goal.isAssigned)
   let prevMessageLength := state.coreState.messages.toList.length
   try
     let nextState ← state.step goal tacticM guardMVarErrors
@@ -289,7 +290,6 @@ protected def GoalState.tryTactic (state: GoalState) (goal: MVarId) (tactic: Str
     (fileName := ← getFileName) with
     | .ok stx => pure $ stx
     | .error error => return .parseError error
-  assert! ¬ (← goal.isAssigned)
   state.tryTacticM goal (Elab.Tactic.evalTactic tactic) true
 
 protected def GoalState.tryAssign (state: GoalState) (goal: MVarId) (expr: String):

Pantograph/Protocol.lean

@@ -361,8 +361,8 @@ structure FrontendProcess where
   readHeader : Bool := false
   -- Alter the REPL environment after the compilation units.
   inheritEnv : Bool := false
-  -- collect tactic invocations
-  invocations: Bool := false
+  -- collect tactic invocations and output to a given file
+  invocations?: Option String := .none
   -- collect `sorry`s
   sorrys: Bool := false
   -- collect type errors
@@ -383,8 +383,8 @@ structure CompilationUnit where
   -- String boundaries of compilation units
   boundary: (Nat × Nat)
   messages: Array String := #[]
-  -- Tactic invocations
-  invocations?: Option (List InvokedTactic) := .none
+  -- Number of tactic invocations
+  nInvocations?: Option Nat := .none
   goalStateId?: Option Nat := .none
   goals?: Option (Array Goal) := .none
   -- Code segments which generated the goals
@@ -396,6 +396,12 @@ structure CompilationUnit where
 structure FrontendProcessResult where
   units: List CompilationUnit
   deriving Lean.ToJson
+structure FrontendDataUnit where
+  invocations? : Option (List Protocol.InvokedTactic) := .none
+  deriving Lean.ToJson
+structure FrontendData where
+  units : List FrontendDataUnit
+  deriving Lean.ToJson
 
 abbrev FallibleT := ExceptT InteractionError
 

Repl.lean

@@ -125,7 +125,7 @@ def frontend_process (args: Protocol.FrontendProcess): EMainM Protocol.FrontendP
   let frontendM: Elab.Frontend.FrontendM (List CompilationUnit) :=
     Frontend.mapCompilationSteps λ step => do
     let boundary := (step.src.startPos.byteIdx, step.src.stopPos.byteIdx)
-    let invocations: Option (List Protocol.InvokedTactic) ← if args.invocations then
+    let invocations: Option (List Protocol.InvokedTactic) ← if args.invocations?.isSome then
         Frontend.collectTacticsFromCompilationStep step
       else
         pure []
@@ -152,6 +152,10 @@ def frontend_process (args: Protocol.FrontendProcess): EMainM Protocol.FrontendP
     if let .some scope := state'.commandState.scopes.head? then
       -- modify the scope
       set { ← getMainState with scope }
+  if let .some fileName := args.invocations? then
+    let units := li.map λ unit => { invocations? := .some unit.invocations }
+    let data : Protocol.FrontendData := { units }
+    IO.FS.writeFile fileName (toJson data |>.compress)
   let units ← li.mapM λ step => withEnv step.env do
     let newConstants? := if args.newConstants then
         .some $ step.newConstants.toArray.map λ name => name.toString
@@ -167,11 +171,11 @@ def frontend_process (args: Protocol.FrontendProcess): EMainM Protocol.FrontendP
         let stateId ← newGoalState state
         let srcBoundaries := srcBoundaries.toArray.map (λ (b, e) => (b.byteIdx, e.byteIdx))
         pure (.some stateId, .some goals, .some srcBoundaries)
-    let invocations? := if args.invocations then .some step.invocations else .none
+    let nInvocations? := if args.invocations?.isSome then .some step.invocations.length else .none
     return {
       boundary := step.boundary,
       messages := step.messages,
-      invocations?,
+      nInvocations?,
       goalStateId?,
       goals?,
       goalSrcBoundaries?,

Test/Common.lean

@@ -69,6 +69,8 @@ end Condensed
 
 def GoalState.get! (state: GoalState) (i: Nat): MVarId := state.goals[i]!
 def GoalState.tacticOn (state: GoalState) (goalId: Nat) (tactic: String) := state.tryTactic (state.get! goalId) tactic
+def GoalState.tacticOn' (state: GoalState) (goalId: Nat) (tactic: TSyntax `tactic) :=
+  state.tryTacticM (state.get! goalId) (Elab.Tactic.evalTactic tactic) true
 
 def TacticResult.toString : TacticResult → String
   | .success state _messages => s!".success ({state.goals.length} goals)"

Test/Integration.lean

@@ -17,53 +17,59 @@ deriving instance Lean.ToJson for Protocol.GoalStart
 deriving instance Lean.ToJson for Protocol.GoalPrint
 deriving instance Lean.ToJson for Protocol.GoalTactic
 deriving instance Lean.ToJson for Protocol.FrontendProcess
+deriving instance Lean.ToJson for Protocol.FrontendDataUnit
+deriving instance Lean.ToJson for Protocol.FrontendData
+
+abbrev TestM α := TestT MainM α
+abbrev Test := TestM Unit
 
 def step { α β } [Lean.ToJson α] [Lean.ToJson β] (cmd: String) (payload: α)
-    (expected: β) (name? : Option String := .none): MainM LSpec.TestSeq := do
+    (expected: β) (name? : Option String := .none) : TestM Unit := do
   let payload := Lean.toJson payload
   let name := name?.getD s!"{cmd} {payload.compress}"
   let result ← Repl.execute { cmd, payload }
-  return LSpec.test name (result.pretty = (Lean.toJson expected).pretty)
-
-abbrev Test := List (MainM LSpec.TestSeq)
+  checkEq name result.compress (Lean.toJson expected).compress
+def stepFile { α } [Lean.ToJson α] (name : String) (path : String)
+    (expected : α) : TestM Unit := do
+  let content ← IO.FS.readFile path
+  let payload? : Except String Lean.Json := Lean.Json.parse content
+  match payload? with
+  | .ok payload =>
+    let expected := Lean.toJson expected
+    checkEq name payload.compress expected.compress
+  | .error e => fail s!"{name} {e}"
 
 def test_expr_echo : Test :=
-  [
   step "expr.echo"
    ({ expr := "λ {α : Sort (u + 1)} => List α", levels? := .some #["u"]}: Protocol.ExprEcho)
    ({
      type := { pp? := .some "{α : Type u} → Type u" },
      expr := { pp? := .some "fun {α} => List α" }
-     }: Protocol.ExprEchoResult),
-  ]
+   }: Protocol.ExprEchoResult)
 
-def test_option_modify : Test :=
+def test_option_modify : Test := do
   let pp? := Option.some "∀ (n : Nat), n + 1 = n.succ"
   let sexp? := Option.some "(:forall n (:c Nat) ((:c Eq) (:c Nat) ((:c HAdd.hAdd) (:c Nat) (:c Nat) (:c Nat) ((:c instHAdd) (:c Nat) (:c instAddNat)) 0 ((:c OfNat.ofNat) (:c Nat) (:lit 1) ((:c instOfNatNat) (:lit 1)))) ((:c Nat.succ) 0)))"
   let module? := Option.some "Init.Data.Nat.Basic"
   let options: Protocol.Options := {}
-  [
   step "env.inspect" ({ name := "Nat.add_one" } : Protocol.EnvInspect)
-     ({ type := { pp? }, module? }: Protocol.EnvInspectResult),
+   ({ type := { pp? }, module? }: Protocol.EnvInspectResult)
   step "options.set" ({ printExprAST? := .some true } : Protocol.OptionsSet)
-     ({ }: Protocol.OptionsSetResult),
+   ({ }: Protocol.OptionsSetResult)
   step "env.inspect" ({ name := "Nat.add_one" } : Protocol.EnvInspect)
-     ({ type := { pp?, sexp? }, module? }: Protocol.EnvInspectResult),
+   ({ type := { pp?, sexp? }, module? }: Protocol.EnvInspectResult)
   step "options.print" ({} : Protocol.OptionsPrint)
-     ({ options with printExprAST := true }: Protocol.Options),
-  ]
-def test_malformed_command : Test :=
+   ({ options with printExprAST := true }: Protocol.Options)
+
+def test_malformed_command : Test := do
   let invalid := "invalid"
-  [
   step invalid ({ name := "Nat.add_one" }: Protocol.EnvInspect)
    ({ error := "command", desc := s!"Unknown command {invalid}" }: Protocol.InteractionError)
-     (name? := .some "Invalid Command"),
+   (name? := .some "Invalid Command")
   step "expr.echo" (Lean.Json.mkObj [(invalid, .str "Random garbage data")])
    ({ error := "command", desc := s!"Unable to parse json: Pantograph.Protocol.ExprEcho.expr: String expected" }:
-      Protocol.InteractionError)
-    (name? := .some "JSON Deserialization")
-  ]
-def test_tactic : Test :=
+    Protocol.InteractionError) (name? := .some "JSON Deserialization")
+def test_tactic : Test := do
   let varX := { name := "_uniq.10", userName := "x", type? := .some { pp? := .some "Prop" }}
   let goal1: Protocol.Goal := {
     name := "_uniq.11",
@@ -78,43 +84,39 @@ def test_tactic : Test :=
       { name := "_uniq.13", userName := "y", type? := .some { pp? := .some "Prop" }}
     ],
   }
-  [
   step "goal.start" ({ expr := "∀ (p q: Prop), p ∨ q → q ∨ p" }: Protocol.GoalStart)
-     ({ stateId := 0, root := "_uniq.9" }: Protocol.GoalStartResult),
+   ({ stateId := 0, root := "_uniq.9" }: Protocol.GoalStartResult)
   step "goal.tactic" ({ stateId := 0, tactic? := .some "intro x" }: Protocol.GoalTactic)
-     ({ nextStateId? := .some 1, goals? := #[goal1], }: Protocol.GoalTacticResult),
+   ({ nextStateId? := .some 1, goals? := #[goal1], }: Protocol.GoalTacticResult)
   step "goal.print" ({ stateId := 1, parentExpr? := .some true, rootExpr? := .some true }: Protocol.GoalPrint)
    ({
      root? := .some { pp? := "fun x => ?m.11"},
      parent? := .some { pp? := .some "fun x => ?m.11" },
-     }: Protocol.GoalPrintResult),
+   }: Protocol.GoalPrintResult)
   step "goal.tactic" ({ stateId := 1, tactic? := .some "intro y" }: Protocol.GoalTactic)
-     ({ nextStateId? := .some 2, goals? := #[goal2], }: Protocol.GoalTacticResult),
+   ({ nextStateId? := .some 2, goals? := #[goal2], }: Protocol.GoalTacticResult)
   step "goal.tactic" ({ stateId := 1, tactic? := .some "apply Nat.le_of_succ_le" }: Protocol.GoalTactic)
    ({ messages? := .some #["tactic 'apply' failed, failed to unify\n  ∀ {m : Nat}, Nat.succ ?n ≤ m → ?n ≤ m\nwith\n  ∀ (q : Prop), x ∨ q → q ∨ x\nx : Prop\n⊢ ∀ (q : Prop), x ∨ q → q ∨ x"] }:
-      Protocol.GoalTacticResult),
+    Protocol.GoalTacticResult)
   step "goal.tactic" ({ stateId := 0, tactic? := .some "sorry" }: Protocol.GoalTactic)
-     ({ nextStateId? := .some 3, goals? := .some #[], hasSorry := true }: Protocol.GoalTacticResult),
-  ]
+   ({ nextStateId? := .some 3, goals? := .some #[], hasSorry := true }: Protocol.GoalTacticResult)
 example : (1 : Nat) + (2 * 3) = 1 + (4 - 3) + (6 - 4) + 3 := by
   simp
-def test_tactic_timeout : Test :=
-  [
+def test_tactic_timeout : Test := do
   step "goal.start" ({ expr := "(1 : Nat) + (2 * 3) = 1 + (4 - 3) + (6 - 4) + 3" }: Protocol.GoalStart)
-     ({ stateId := 0, root := "_uniq.355" }: Protocol.GoalStartResult),
+   ({ stateId := 0, root := "_uniq.355" }: Protocol.GoalStartResult)
   -- timeout of 10 milliseconds
   step "options.set" ({ timeout? := .some 10 } : Protocol.OptionsSet)
-     ({ }: Protocol.OptionsSetResult),
+   ({ }: Protocol.OptionsSetResult)
   step "goal.tactic" ({ stateId := 0, expr? := .some "by\nsleep 1000; simp" }: Protocol.GoalTactic)
-     ({ error := "internal", desc := "interrupt" }: Protocol.InteractionError),
+   ({ error := "internal", desc := "interrupt" }: Protocol.InteractionError)
   -- ensure graceful recovery
   step "options.set" ({ timeout? := .some 0 } : Protocol.OptionsSet)
-     ({ }: Protocol.OptionsSetResult),
+   ({ }: Protocol.OptionsSetResult)
   step "goal.tactic" ({ stateId := 0, tactic? := .some "simp" }: Protocol.GoalTactic)
-     ({ nextStateId? := .some 1, goals? := .some #[], }: Protocol.GoalTacticResult),
-  ]
+   ({ nextStateId? := .some 1, goals? := .some #[], }: Protocol.GoalTacticResult)
 
-def test_automatic_mode (automatic: Bool): Test :=
+def test_automatic_mode (automatic: Bool): Test := do
   let varsPQ := #[
     { name := "_uniq.10", userName := "p", type? := .some { pp? := .some "Prop" }},
     { name := "_uniq.13", userName := "q", type? := .some { pp? := .some "Prop" }}
@@ -150,38 +152,34 @@ def test_automatic_mode (automatic: Bool): Test :=
       { name := "_uniq.49", userName := "h✝", type? := .some { pp? := .some "p" }, isInaccessible := true}
     ],
   }
-  [
   step "options.set" ({automaticMode? := .some automatic}: Protocol.OptionsSet)
-     ({}: Protocol.OptionsSetResult),
+   ({}: Protocol.OptionsSetResult)
   step "goal.start" ({ expr := "∀ (p q: Prop), p ∨ q → q ∨ p"} : Protocol.GoalStart)
-     ({ stateId := 0, root := "_uniq.9" }: Protocol.GoalStartResult),
+   ({ stateId := 0, root := "_uniq.9" }: Protocol.GoalStartResult)
   step "goal.tactic" ({ stateId := 0, tactic? := .some "intro p q h" }: Protocol.GoalTactic)
-     ({ nextStateId? := .some 1, goals? := #[goal1], }: Protocol.GoalTacticResult),
+   ({ nextStateId? := .some 1, goals? := #[goal1], }: Protocol.GoalTacticResult)
   step "goal.tactic" ({ stateId := 1, tactic? := .some "cases h" }: Protocol.GoalTactic)
-     ({ nextStateId? := .some 2, goals? := #[goal2l, goal2r], }: Protocol.GoalTacticResult),
+   ({ nextStateId? := .some 2, goals? := #[goal2l, goal2r], }: Protocol.GoalTacticResult)
   let goals? := if automatic then #[goal3l, goal2r] else #[goal3l]
   step "goal.tactic" ({ stateId := 2, tactic? := .some "apply Or.inr" }: Protocol.GoalTactic)
-     ({ nextStateId? := .some 3, goals?, }: Protocol.GoalTacticResult),
-  ]
+   ({ nextStateId? := .some 3, goals?, }: Protocol.GoalTacticResult)
 
-def test_env_add_inspect : Test :=
+def test_env_add_inspect : Test := do
   let name1 := "Pantograph.mystery"
   let name2 := "Pantograph.mystery2"
   let name3 := "Pantograph.mystery3"
-  [
   step "env.add"
     ({
       name := name1,
       value := "λ (a b: Prop) => Or a b",
       isTheorem := false
     }: Protocol.EnvAdd)
-     ({}: Protocol.EnvAddResult),
+   ({}: Protocol.EnvAddResult)
   step "env.inspect" ({name := name1, value? := .some true} : Protocol.EnvInspect)
    ({
      value? := .some { pp? := .some "fun a b => a ∨ b" },
      type := { pp? := .some "Prop → Prop → Prop" },
-     }:
-      Protocol.EnvInspectResult),
+   }: Protocol.EnvInspectResult)
   step "env.add"
     ({
       name := name2,
@@ -189,13 +187,12 @@ def test_env_add_inspect : Test :=
       value := "λ (a: Nat) => a + 1",
       isTheorem := false
     }: Protocol.EnvAdd)
-     ({}: Protocol.EnvAddResult),
+   ({}: Protocol.EnvAddResult)
   step "env.inspect" ({name := name2, value? := .some true} : Protocol.EnvInspect)
    ({
      value? := .some { pp? := .some "fun a => ↑a + 1" },
      type := { pp? := .some "Nat → Int" },
-     }:
-      Protocol.EnvInspectResult),
+   }: Protocol.EnvInspectResult)
   step "env.add"
     ({
       name := name3,
@@ -204,30 +201,34 @@ def test_env_add_inspect : Test :=
       value := "λ (α : Type u) (x : α) => (x, x)",
       isTheorem := false
     }: Protocol.EnvAdd)
-     ({}: Protocol.EnvAddResult),
+   ({}: Protocol.EnvAddResult)
   step "env.inspect" ({name := name3} : Protocol.EnvInspect)
    ({
      type := { pp? := .some "(α : Type u) → α → α × α" },
-     }:
-      Protocol.EnvInspectResult),
-  ]
+   }: Protocol.EnvInspectResult)
 
 example : ∀ (p: Prop), p → p := by
   intro p h
   exact h
 
-def test_frontend_process : Test :=
+def test_frontend_process : Test := do
   let file := "example : ∀ (p q: Prop), p → p ∨ q := by\n  intro p q h\n  exact Or.inl h"
   let goal1 := "p q : Prop\nh : p\n⊢ p ∨ q"
-  [
+  IO.FS.withTempDir λ tempdir => do
+  let filename := s!"{tempdir}/invocations.jsonl"
   step "frontend.process"
     ({
       file? := .some file,
-        invocations := true,
+      invocations? := .some filename,
     }: Protocol.FrontendProcess)
    ({
      units := [{
        boundary := (0, file.utf8ByteSize),
+       nInvocations? := .some 2,
+     }],
+   }: Protocol.FrontendProcessResult)
+  stepFile (α := Protocol.FrontendData) "invocations" filename
+    { units := [{
         invocations? := .some [
           {
             goalBefore := "⊢ ∀ (p q : Prop), p → p ∨ q",
@@ -242,17 +243,14 @@ def test_frontend_process : Test :=
             usedConstants := #["Or.inl"],
           },
         ]
-       }],
-    }: Protocol.FrontendProcessResult),
-  ]
+    } ] }
 
 example : 1 + 2 = 3 := rfl
 example (p: Prop): p → p := by simp
 
-def test_frontend_process_sorry : Test :=
+def test_frontend_process_sorry : Test := do
   let solved := "example : 1 + 2 = 3 := rfl\n"
   let withSorry := "example (p: Prop): p → p := sorry"
-  [
   let file := s!"{solved}{withSorry}"
   let goal1: Protocol.Goal := {
     name := "_uniq.6",
@@ -274,17 +272,15 @@ def test_frontend_process_sorry : Test :=
        goalSrcBoundaries? := .some #[(57, 62)],
        messages := #["<anonymous>:2:0: warning: declaration uses 'sorry'\n"],
      }],
-     }: Protocol.FrontendProcessResult),
-  ]
+   }: Protocol.FrontendProcessResult)
 
-def test_import_open : Test :=
+def test_import_open : Test := do
   let header := "import Init\nopen Nat\nuniverse u"
   let goal1: Protocol.Goal := {
     name := "_uniq.77",
     target := { pp? := .some "n + 1 = n.succ" },
     vars := #[{ name := "_uniq.76", userName := "n", type? := .some { pp? := .some "Nat" }}],
   }
-  [
   step "frontend.process"
     ({
       file? := .some header,
@@ -296,21 +292,19 @@ def test_import_open : Test :=
        { boundary := (12, 21) },
        { boundary := (21, header.utf8ByteSize) },
      ],
-     }: Protocol.FrontendProcessResult),
+   }: Protocol.FrontendProcessResult)
   step "goal.start" ({ expr := "∀ (n : Nat), n + 1 = Nat.succ n"} : Protocol.GoalStart)
-     ({ stateId := 0, root := "_uniq.75" }: Protocol.GoalStartResult),
+   ({ stateId := 0, root := "_uniq.75" }: Protocol.GoalStartResult)
   step "goal.tactic" ({ stateId := 0, tactic? := .some "intro n" }: Protocol.GoalTactic)
-     ({ nextStateId? := .some 1, goals? := #[goal1], }: Protocol.GoalTacticResult),
+   ({ nextStateId? := .some 1, goals? := #[goal1], }: Protocol.GoalTacticResult)
   step "goal.tactic" ({ stateId := 1, tactic? := .some "apply add_one" }: Protocol.GoalTactic)
-     ({ nextStateId? := .some 2, goals? := .some #[], }: Protocol.GoalTacticResult),
+   ({ nextStateId? := .some 2, goals? := .some #[], }: Protocol.GoalTacticResult)
   step "goal.start" ({ expr := "∀ (x : Sort u), Sort (u + 1)"} : Protocol.GoalStart)
-     ({ stateId := 3, root := "_uniq.5" }: Protocol.GoalStartResult),
-  ]
+   ({ stateId := 3, root := "_uniq.5" }: Protocol.GoalStartResult)
 
 /-- Ensure there cannot be circular references -/
-def test_frontend_process_circular : Test :=
+def test_frontend_process_circular : Test := do
   let withSorry := "theorem mystery : 1 + 2 = 2 + 3 := sorry"
-  [
   let goal1: Protocol.Goal := {
     name := "_uniq.2",
     target := { pp? := .some "1 + 2 = 2 + 3" },
@@ -329,17 +323,15 @@ def test_frontend_process_circular : Test :=
        goalSrcBoundaries? := .some #[(35, 40)],
        messages := #["<anonymous>:1:8: warning: declaration uses 'sorry'\n"],
      }],
-     }: Protocol.FrontendProcessResult),
+   }: Protocol.FrontendProcessResult)
   step "goal.tactic" ({ stateId := 0, tactic? := .some "exact?" }: Protocol.GoalTactic)
    ({ messages? := .some #["`exact?` could not close the goal. Try `apply?` to see partial suggestions."] }
-     : Protocol.GoalTacticResult),
-  ]
+   : Protocol.GoalTacticResult)
 
-def runTest (env: Lean.Environment) (steps: Test): IO LSpec.TestSeq := do
+def runTestSuite (env : Lean.Environment) (steps : Test): IO LSpec.TestSeq := do
   -- Setup the environment for execution
   let coreContext ← createCoreContext #[]
-  let mainM : MainM LSpec.TestSeq :=
-    steps.foldlM (λ suite step => do return suite ++ (← step)) LSpec.TestSeq.done
+  let mainM : MainM LSpec.TestSeq := runTest steps
   mainM.run { coreContext } |>.run' { env }
 
 def suite (env : Lean.Environment): List (String × IO LSpec.TestSeq) :=
@@ -357,7 +349,7 @@ def suite (env : Lean.Environment): List (String × IO LSpec.TestSeq) :=
     ("frontend.process import", test_import_open),
     ("frontend.process circular", test_frontend_process_circular),
   ]
-  tests.map (fun (name, test) => (name, runTest env test))
+  tests.map (fun (name, test) => (name, runTestSuite env test))
 
 
 end Pantograph.Test.Integration

Test/Proofs.lean

@@ -66,15 +66,15 @@ def proofRunner (env: Lean.Environment) (tests: TestM Unit): IO LSpec.TestSeq :=
     return a
 
 def test_identity: TestM Unit := do
-  let state0 ← GoalState.create (expr := ← parseSentence "∀ (p: Prop), p → p")
-  let tactic := "intro p h"
-  let state1 ← match ← state0.tacticOn 0 tactic with
+  let rootTarget ← Elab.Term.elabTerm (← `(term|∀ (p: Prop), p → p)) .none
+  let state0 ← GoalState.create (expr := rootTarget)
+  let state1 ← match ← state0.tacticOn' 0 (← `(tactic|intro p h)) with
     | .success state _ => pure state
     | other => do
       fail other.toString
       return ()
   let inner := "_uniq.11"
-  addTest $ LSpec.check tactic ((← state1.serializeGoals (options := ← read)).map (·.name) =
+  addTest $ LSpec.check "intro" ((← state1.serializeGoals (options := ← read)).map (·.name) =
     #[inner])
   let state1parent ← state1.withParentContext do
     serializeExpressionSexp (← instantiateAll state1.parentExpr?.get!)

doc/repl.md

@@ -52,9 +52,9 @@ See `Pantograph/Protocol.lean` for a description of the parameters and return va
   state. The user is responsible to ensure the sender/receiver instances share
   the same environment.
 * `frontend.process { ["fileName": <fileName>,] ["file": <str>], readHeader: <bool>, inheritEnv: <bool>, invocations:
-  <bool>, sorrys: <bool>, typeErrorsAsGoals: <bool>, newConstants: <bool> }`:
+  <string>, sorrys: <bool>, typeErrorsAsGoals: <bool>, newConstants: <bool> }`:
   Executes the Lean frontend on a file, collecting the tactic invocations
-  (`"invocations": true`), the sorrys and type errors into goal states
+  (`"invocations": output-path`), the sorrys and type errors into goal states
   (`"sorrys": true`), and new constants (`"newConstants": true`). In the case of
   `sorrys`, this command additionally outputs the position of each captured
   `sorry`. Conditionally inherit the environment from executing the file.