fix(cli): estimate and hint about Code context at Plan exit (diagnostic)

.changeset/estimate-code-context-at-plan-exit.md

@@ -0,0 +1,5 @@
+---
+"@kilocode/cli": patch
+---
+
+Show the estimated Code-mode context usage and recommend a fresh session when continuing a plan is near automatic compaction.

packages/kilo-i18n/src/de.ts

@@ -113,8 +113,10 @@ export const dict = {
   "plan.followup.question": "Bereit zur Umsetzung?",
   "plan.followup.answer.newSession": "Neue Sitzung starten",
   "plan.followup.answer.newSession.description": "In einer neuen Sitzung mit leerem Kontext umsetzen",
+  "plan.followup.answer.newSession.recommended.description": "In einer neuen Sitzung mit leerem Kontext umsetzen (Empfohlen)",
   "plan.followup.answer.continue": "Hier fortfahren",
   "plan.followup.answer.continue.description": "Den Plan in dieser Sitzung umsetzen",
+  "plan.followup.answer.continue.estimated.description": "Den Plan in dieser Sitzung umsetzen ({{0}}% des Code-Kontextes verwendet)",
   "plan.followup.answer.keepRefining": "Weiter verfeinern",
   "plan.followup.answer.keepRefining.description": "Weiter planen, ohne jetzt zu implementieren",
 

packages/kilo-i18n/src/en.ts

@@ -113,8 +113,10 @@ export const dict = {
   "plan.followup.question": "Ready to implement?",
   "plan.followup.answer.newSession": "Start new session",
   "plan.followup.answer.newSession.description": "Implement in a fresh session with a clean context",
+  "plan.followup.answer.newSession.recommended.description": "Implement in a fresh session with a clean context (Recommended)",
   "plan.followup.answer.continue": "Continue here",
   "plan.followup.answer.continue.description": "Implement the plan in this session",
+  "plan.followup.answer.continue.estimated.description": "Implement the plan in this session (using {{0}}% of Code mode context)",
   "plan.followup.answer.keepRefining": "Keep refining",
   "plan.followup.answer.keepRefining.description": "Keep planning without implementing yet",
 

packages/kilo-jetbrains/backend/src/main/kotlin/ai/kilocode/backend/cli/KiloCliDataParser.kt

@@ -1193,6 +1193,7 @@ object KiloCliDataParser {
                     description = oo.str("description") ?: "",
                     labelKey = oo.str("labelKey"),
                     descriptionKey = oo.str("descriptionKey"),
+                    descriptionArgs = oo["descriptionArgs"]?.arr()?.mapNotNull { it.jsonPrimitive.contentOrNull } ?: emptyList(),
                     mode = oo.str("mode"),
                 )
             } ?: emptyList()

packages/kilo-jetbrains/backend/src/test/kotlin/ai/kilocode/backend/cli/KiloCliDataParserTest.kt

@@ -911,6 +911,7 @@ class KiloCliDataParserTest {
                             "labelKey": "plan.followup.answer.continue",
                             "description": "Implement the plan in this session",
                             "descriptionKey": "plan.followup.answer.continue.description",
+                            "descriptionArgs": ["75"],
                             "mode": "code"
                         }]
                     }],
@@ -930,6 +931,7 @@ class KiloCliDataParserTest {
             val opt = item.options.single()
             assertEquals("plan.followup.answer.continue", opt.labelKey)
             assertEquals("plan.followup.answer.continue.description", opt.descriptionKey)
+            assertEquals(listOf("75"), opt.descriptionArgs)
             assertEquals("code", opt.mode)
         }
 

packages/kilo-jetbrains/frontend/src/main/kotlin/ai/kilocode/client/plugin/KiloBundle.kt

@@ -10,8 +10,8 @@ object KiloBundle : DynamicBundle(BUNDLE) {
         return getMessage(key, *params)
     }
 
-    fun optional(key: String): String? {
+    fun optional(key: String, vararg params: Any): String? {
         if (!containsKey(key)) return null
-        return getMessage(key)
+        return getMessage(key, *params)
     }
 }

packages/kilo-jetbrains/frontend/src/main/kotlin/ai/kilocode/client/session/controller/SessionController.kt

@@ -2469,6 +2469,7 @@ private fun toQuestion(dto: QuestionRequestDto): Question {
                     description = opt.description,
                     labelKey = opt.labelKey,
                     descriptionKey = opt.descriptionKey,
+                    descriptionArgs = opt.descriptionArgs,
                     mode = opt.mode,
                 )
             },

packages/kilo-jetbrains/frontend/src/main/kotlin/ai/kilocode/client/session/model/Question.kt

@@ -25,5 +25,6 @@ data class QuestionOption(
     val description: String,
     val labelKey: String? = null,
     val descriptionKey: String? = null,
+    val descriptionArgs: List<String> = emptyList(),
     val mode: String? = null,
 )