engineering-memory 1.11.20 → 1.11.21

package/runtime/dist/src/mcp/workflow-tools.js

@@ -1,5 +1,6 @@
 import * as z from 'zod/v4';
 import { languageTag } from '../runtime/questionnaire-store.js';
+import { texts } from '../runtime/texts.js';
 import { sha256, stableStringify } from '../utilities/hash.js';
 import { answerChoice, askQuestionnaire } from './questionnaire-tools.js';
 import { assertSafeToPersist } from '../runtime/offline-outbox.js';
@@ -11,7 +12,10 @@ const role = z.enum([
     'blocked_declared',
 ]);
 const mode = z.enum(['automatic', 'confirm', 'ignore']);
-const navigation = z.tuple([z.string().trim().min(1).max(120), z.string().trim().min(1).max(400)]);
+const navigation = z.strictObject({
+    label: z.string().trim().min(1).max(120),
+    description: z.string().trim().min(1).max(400),
+});
 const wording = z
     .object({
     roles: z.record(role, z
@@ -75,104 +79,6 @@ const workflowPage = z.object({
     offset: z.number().int().min(0),
     limit: z.number().int().min(1).max(100),
 });
-const copy = {
-    tr: {
-        roles: {
-            work_started: {
-                title: 'Geliştirme',
-                message: 'Geliştirmeye başlayınca hangi kolon kullanılsın?',
-                context: 'Yeni işin açıldığı kolondan ayrı olarak, geliştirmeye başlama adımını ayarlıyoruz.',
-                example: 'Ödeme hatasını düzeltmeye başladığında kullanılacak kolonu seçiyorsun.',
-            },
-            pr_opened: {
-                title: 'İncelemeye hazır PR',
-                message: 'PR incelemeye hazır olunca hangi kolon kullanılsın?',
-                context: 'Taslak PR davranışı aynı kalır; burada incelemeye hazır PR adımını ayarlıyoruz.',
-                example: 'Değişikliğini bitirip ekip arkadaşının incelemesine açtığında kullanılacak kolon.',
-            },
-            all_prs_merged: {
-                title: 'Bütün PR’lar birleşti',
-                message: 'İşin bütün PR’ları birleşince hangi kolon kullanılsın?',
-                context: 'Bu işe bağlı bütün PR’ların birleştiği adımı ayarlıyoruz.',
-                example: 'Hem web hem sunucu değişiklikleri birleştirildiğinde kullanılacak kolon.',
-            },
-            test_failed: {
-                title: 'Başarısız test',
-                message: 'Test başarısız olunca hangi kolon kullanılsın?',
-                context: 'Başarısız testin ardından yapılacak düzeltmeler için kolon seçiyoruz.',
-                example: 'Ödeme testinde hata bulundu; düzeltme bekleyen iş için kullanılacak kolon.',
-            },
-            blocked_declared: {
-                title: 'Park edilen işler',
-                message: 'Beklemeye alınan işler hangi kolonda park edilsin?',
-                context: 'Projenin aktif park kolonunu seçiyoruz; mevcut işler yerinde kalacak.',
-                example: 'Dış servisten yanıt beklediğin için işi beklemeye aldığında kullanılacak kolon.',
-            },
-        },
-        modes: { automatic: 'Otomatik', confirm: 'Onay sor', ignore: 'Olayı dikkate alma' },
-        page: 'Sayfa',
-        next: ['Sonraki kolonlar', 'Aynı kararın sonraki kolonlarını göster.'],
-        previous: ['Önceki kolonlar', 'Aynı kararın önceki kolonlarına dön.'],
-        defer: ['Şimdi kaydetme', 'Seçimleri uygulama; bu deneme ertelenmiş olarak kalır.'],
-        approve: [
-            'Bu ayarları kaydet',
-            'Gösterilen beş tercihi birlikte kaydet; mevcut işleri taşıma.',
-        ],
-        review: {
-            message: 'Bu akış ayarlarını birlikte kaydedelim mi?',
-            context: 'Beş kolon ve davranış aşağıda. Taslak PR ve yeni işin başlangıç kolonu değişmez. Bu işlem yalnızca ayarları kaydeder; olay çalıştırmaz.',
-            example: 'Beklemeye alınan işler için Beklemede kolonunu seçtiysen proje bundan sonra bu tercihi saklar; önceki işler yerinde kalır.',
-        },
-    },
-    en: {
-        roles: {
-            work_started: {
-                title: 'Development',
-                message: 'Which stage should represent starting development?',
-                context: 'This is separate from the stage where new work is created.',
-                example: 'Choose the stage used when you begin fixing a payment bug.',
-            },
-            pr_opened: {
-                title: 'PR ready for review',
-                message: 'Which stage should represent a PR ready for review?',
-                context: 'Draft PR behavior stays unchanged; this configures the ready-for-review step.',
-                example: 'Use this stage when your completed change is ready for a teammate to review.',
-            },
-            all_prs_merged: {
-                title: 'All PRs merged',
-                message: 'Which stage should represent all PRs being merged?',
-                context: 'This configures the step after every PR belonging to the work has merged.',
-                example: 'Both the web change and its backend change have been merged.',
-            },
-            test_failed: {
-                title: 'Failed test',
-                message: 'Which stage should represent a failed test?',
-                context: 'Choose the stage for work that needs changes after a failed test.',
-                example: 'A payment test found a problem and the work needs a correction.',
-            },
-            blocked_declared: {
-                title: 'Parked work',
-                message: 'Which stage should hold parked work?',
-                context: 'Choose the active parked stage; existing work stays where it is.',
-                example: 'You put a task on hold while waiting for an external service.',
-            },
-        },
-        modes: { automatic: 'Automatic', confirm: 'Ask for approval', ignore: 'Ignore this event' },
-        page: 'Page',
-        next: ['Next stages', 'Show the next stages for this same decision.'],
-        previous: ['Previous stages', 'Return to the previous stages for this same decision.'],
-        defer: ['Do not save now', 'Apply nothing; this attempt remains deferred.'],
-        approve: [
-            'Save these settings',
-            'Save the five displayed choices together without moving existing work.',
-        ],
-        review: {
-            message: 'Save these workflow settings together?',
-            context: 'The five stages and behaviors appear below. Draft PR and new-work initial settings stay unchanged. This saves configuration only; no event is executed.',
-            example: 'Choosing On Hold for parked work stores that preference for the project; earlier tasks remain in place.',
-        },
-    },
-};
 function stageQuestion(input, text, language, stages, recommendation, setupId, selected, page, visit) {
     const recommended = stages.find((item) => item.id === recommendation.statusId);
     const others = stages.filter((item) => item.id !== recommendation.statusId);
@@ -192,10 +98,14 @@ function stageQuestion(input, text, language, stages, recommendation, setupId, s
             .slice(0, 400),
     }));
     if (page > 0)
-        options.push({ id: 'previous', label: text.previous[0], description: text.previous[1] });
+        options.push({
+            id: 'previous',
+            label: text.previous.label,
+            description: text.previous.description,
+        });
     if (page + 1 < count)
-        options.push({ id: 'next', label: text.next[0], description: text.next[1] });
-    options.push({ id: 'defer', label: text.defer[0], description: text.defer[1] });
+        options.push({ id: 'next', label: text.next.label, description: text.next.description });
+    options.push({ id: 'defer', label: text.defer.label, description: text.defer.description });
     return {
         questionnaireId: 'workflow-role-' +
             sha256(stableStringify({ setupId, selected, event: recommendation.event, page, visit })),
@@ -218,7 +128,7 @@ function stageQuestion(input, text, language, stages, recommendation, setupId, s
 }
 export function registerWorkflowTools(server, service) {
     server.registerTool('work_item.setup_workflow', {
-        description: 'Review five project workflow roles in durable native forms and save them together. First read work_item.workflow and supply its exact snapshot plus five deliberate recommendations, explicit modes and reasons in the user language. The current task must be resumed in this repository. All active stages are reachable through pages; existing work and draft PR settings stay unchanged. Questions are critical and follow the task mode; feedback is not consent. Retry identical input to resume. After deferral or a mode-invalidated agent answer, use a new decisionAttempt only when reconsideration is authorized. Use copy for languages other than Turkish/English; translate every field. Never silently replace a stale snapshot. This does not fire events.',
+        description: 'Review five project workflow roles in durable native forms and save them together. First read work_item.workflow and supply its exact snapshot plus five deliberate recommendations, explicit modes and reasons in the user language. The current task must be resumed in this repository. All active stages are reachable through pages; existing work and draft PR settings stay unchanged. Questions are critical and follow the task mode; feedback is not consent. Retry identical input to resume. After deferral or a mode-invalidated agent answer, use a new decisionAttempt only when reconsideration is authorized. Supply copy, translating every field, when the product text catalogue lacks the conversation language. Never silently replace a stale snapshot. This does not fire events.',
         inputSchema: setupInput,
     }, async (input, context) => setupWorkflow(server, service, input, context));
 }
@@ -233,11 +143,10 @@ async function setupWorkflow(server, service, input, context) {
     catch {
         return refusal('Remove sensitive content from the workflow question and its retry arguments before continuing.', 'work_item.setup_workflow');
     }
-    const language = input.language ?? (await service.language());
+    const language = await service.language(input.language);
     if (!language)
         return refusal('Read session.entry with the conversation language first.', 'session.entry');
-    const baseLanguage = language.split('-')[0];
-    const text = input.copy ?? (baseLanguage === 'tr' || baseLanguage === 'en' ? copy[baseLanguage] : undefined);
+    const text = input.copy ?? wording.safeParse(texts('workflow', language)).data;
     if (!text)
         return refusal('Supply every copy field in the conversation language, preserving this snapshot and requestKey.', 'work_item.setup_workflow');
     const stages = [];
@@ -343,8 +252,8 @@ async function setupWorkflow(server, service, input, context) {
                 .join('\n'),
         example: text.review.example,
         options: [
-            { id: 'approve', label: text.approve[0], description: text.approve[1] },
-            { id: 'defer', label: text.defer[0], description: text.defer[1] },
+            { id: 'approve', label: text.approve.label, description: text.approve.description },
+            { id: 'defer', label: text.defer.label, description: text.defer.description },
         ],
         binding: {
             setupId,