auto-inherit recommendedActAgent from context in ACT mode (#561)

[JeremyDev87]

Summary

Fixes #561

When the user types ACT, mode.handler.ts was calling keywordService.parseMode() before reading the context document. This meant the recommendedActAgent stored by the previous PLAN session was never passed to the agent resolver — it arrived too late.

Before (broken flow):

1. parseMode(prompt, options)   ← agent resolved here (no context)
2. handleContextDocument()      ← context read here (too late)

After (correct flow):

1. readContext()                ← extract recommendedActAgent
2. parseMode(prompt, options)   ← pass recommendedActAgent from context
3. handleContextDocument()

Changes

mode.handler.ts

• Import LOCALIZED_KEYWORD_MAP to detect ACT keywords in all supported languages (EN/KO/JA/ZH/ES)
• Pre-read context document before parseMode() when mode is ACT and no explicit recommended_agent param is provided
• Extract recommendedActAgent from the last PLAN or AUTO section
• Skip context read entirely when mode is not ACT (performance guard)

mode.handler.spec.ts

• Add test: ACT mode auto-inherits recommendedActAgent from context when param not provided
• Add test: Explicit recommended_agent param takes precedence over context value
• Add test: readContext not called before parseMode when explicit param is provided (performance)
• Add test: Korean ACT keyword (실행) triggers context inheritance
• Add test: Spanish ACT keyword (ACTUAR) triggers context inheritance
• Relocate "should not read context" test to PLAN mode describe block

Acceptance Criteria

• ACT mode automatically uses recommendedActAgent from context document without explicit param
• Explicit recommended_agent parameter still takes precedence over context value
• No context read performed when mode is not ACT (performance)
• Unit test: ACT after PLAN auto-inherits recommendation
• Unit test: Explicit param overrides context recommendation
• Localized ACT keywords (KO/ES) also trigger context inheritance

Test Results

✓ 3887 tests passed (2 skipped)
✓ tsc --noEmit — no type errors

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
codingbuddy-landing	Ready	Preview, Comment	Feb 19, 2026 1:27am