docs(07): create phase 7 multilanguage plan

.planning/phases/07-multilanguage/07-04-PLAN.md

@@ -0,0 +1,138 @@
+---
+phase: 07-multilanguage
+plan: 04
+type: execute
+wave: 3
+depends_on:
+  - "07-03"
+files_modified: []
+autonomous: false
+requirements:
+  - I18N-01
+  - I18N-02
+  - I18N-03
+  - I18N-04
+  - I18N-05
+  - I18N-06
+
+must_haves:
+  truths:
+    - "Portal renders correctly in English, Spanish, and Portuguese"
+    - "Language switcher works in sidebar and on login page"
+    - "Language preference persists across sessions"
+    - "AI Employee responds in the user's language"
+    - "Agent templates display in the selected language"
+    - "Error messages and validation text are localized"
+  artifacts: []
+  key_links: []
+---
+
+<objective>
+Human verification of the complete multilanguage implementation across all portal pages and AI Employee behavior.
+
+Purpose: Verify that translations look correct, the language switcher works end-to-end, and AI Employees respond in the correct language. Automated builds confirm code compiles but cannot verify translation quality or visual correctness.
+Output: Confirmation that all I18N requirements are met.
+</objective>
+
+<execution_context>
+@/home/adelorenzo/.claude/get-shit-done/workflows/execute-plan.md
+@/home/adelorenzo/.claude/get-shit-done/templates/summary.md
+</execution_context>
+
+<context>
+@.planning/PROJECT.md
+@.planning/ROADMAP.md
+@.planning/phases/07-multilanguage/07-CONTEXT.md
+@.planning/phases/07-multilanguage/07-01-SUMMARY.md
+@.planning/phases/07-multilanguage/07-02-SUMMARY.md
+@.planning/phases/07-multilanguage/07-03-SUMMARY.md
+</context>
+
+<tasks>
+
+<task type="checkpoint:human-verify" gate="blocking">
+  <name>Task 1: Verify complete multilanguage implementation</name>
+  <files></files>
+  <action>
+    Present the user with the verification checklist below. No code changes needed — this is a human review checkpoint.
+  </action>
+  <verify>
+    <automated>cd /home/adelorenzo/repos/konstruct/packages/portal && npx next build 2>&1 | tail -5</automated>
+  </verify>
+  <done>User confirms all I18N requirements are met by typing "approved"</done>
+  <what-built>
+    Complete multilanguage support across the portal and AI Employee behavior:
+    - All portal pages and components localized in English, Spanish, and Portuguese
+    - Language switcher in sidebar (post-auth) and login page (pre-auth)
+    - Language preference persisted to DB and JWT
+    - Browser locale auto-detection on first visit
+    - AI Employees respond in the user's language via system prompt instruction
+    - Agent templates display translated names/descriptions in the selected language
+    - Invitation emails sent in the inviting admin's language
+  </what-built>
+  <how-to-verify>
+    Start the dev environment and open the portal:
+
+    **1. Login page language detection (I18N-02)**
+    - Open the login page in a fresh browser/incognito
+    - If your browser is set to Spanish, the form should show Spanish labels
+    - Click the ES / PT language buttons to verify the form changes language
+    - Log in
+
+    **2. Language switcher persistence (I18N-02)**
+    - In the sidebar, find the EN / ES / PT switcher near your avatar
+    - Click "ES" — all navigation labels and page content should switch to Spanish
+    - Navigate to different pages (Dashboard, Employees, Chat, Billing) — all should be in Spanish
+    - Click "PT" — verify Portuguese translations appear
+    - Log out and log back in — verify the language preference persists (should still be Portuguese)
+
+    **3. Portal pages in Spanish (I18N-01, I18N-04, I18N-05)**
+    - Switch to Spanish and visit each major page:
+      - Dashboard: verify title, stats labels, welcome message
+      - Employees: verify page title, "New Employee" button, empty state text
+      - New Employee options: verify template/wizard/advanced descriptions
+      - Template gallery: verify template names and descriptions are in Spanish
+      - Employee wizard: verify all 5 step labels and form fields
+      - Chat: verify sidebar, message input placeholder, conversation labels
+      - Billing: verify plan names, button labels, status badges
+      - Usage: verify chart labels, time range options, budget text
+      - API Keys: verify page title, add/delete labels
+      - Users: verify invite form labels, role names, status badges
+      - Onboarding: verify all 3 step titles and descriptions
+    - Trigger a validation error (e.g., submit an empty form) — verify error message is in Spanish
+
+    **4. Portal pages in Portuguese (I18N-01)**
+    - Switch to Portuguese and spot-check 3-4 pages for correct translations
+
+    **5. AI Employee language response (I18N-03)**
+    - Open the Chat page
+    - Start a conversation with any agent
+    - Send a message in Spanish (e.g., "Hola, como puedo ayudarte?")
+    - Verify the agent responds in Spanish
+    - Send a message in Portuguese (e.g., "Ola, como posso ajudar?")
+    - Verify the agent responds in Portuguese
+    - Send a message in English — verify English response
+
+    **6. Extensibility check (I18N-06)**
+    - Verify that messages/en.json, messages/es.json, and messages/pt.json exist
+    - Confirm the file structure means adding a 4th language is just a new JSON file
+  </how-to-verify>
+  <resume-signal>Type "approved" if all checks pass, or describe any issues found</resume-signal>
+</task>
+
+</tasks>
+
+<verification>
+Human verification covers all 6 I18N requirements through manual testing in the browser.
+</verification>
+
+<success_criteria>
+- All 6 verification steps pass
+- No untranslated strings visible when using Spanish or Portuguese
+- Language preference persists across sessions
+- AI Employee responds in the correct language
+</success_criteria>
+
+<output>
+After completion, create `.planning/phases/07-multilanguage/07-04-SUMMARY.md`
+</output>