@cat-factory/app 0.184.0 → 0.185.0

package/app/components/panels/inspector/ServiceValidationConfig.vue

@@ -27,9 +27,15 @@ const busy = ref(false)
 const detecting = ref(false)
 const rows = ref<ValidationCheck[]>([])
 const maxAttempts = ref(VALIDATION_DEFAULT_MAX_ATTEMPTS)
+// DEPENDENCY PREPOPULATION: the install run BEFORE the agent's first turn, so it reads a tree
+// whose dependencies are present. Edited beside the checks because it comes from the same
+// per-service row, but it is independent of them — a service may declare only this.
+const dependencyInstall = ref('')
 
 const saved = computed(() => store.forBlock(props.block.id))
-const configured = computed(() => saved.value.checks.length > 0)
+const configured = computed(
+  () => saved.value.checks.length > 0 || Boolean(saved.value.dependencyInstall),
+)
 const canAdd = computed(() => rows.value.length < VALIDATION_MAX_CHECKS)
 /** A row is only submittable once it has a command; the label falls back to the command. */
 const submittable = computed(() =>
@@ -46,6 +52,7 @@ watch(
   (config) => {
     rows.value = config.checks.map((c) => ({ ...c }))
     maxAttempts.value = config.maxAttempts
+    dependencyInstall.value = config.dependencyInstall ?? ''
   },
   { immediate: true },
 )
@@ -114,7 +121,13 @@ async function detect() {
     }
     const merged = mergeDetectedChecks(rows.value, result.checks, VALIDATION_MAX_CHECKS)
     rows.value = merged.rows
-    if (merged.added === 0) {
+    // Fill the install only when the operator has not written one. Detection is assistive, and
+    // overwriting a hand-tuned install (a workspace filter, an offline flag) with the generic
+    // guess is the same failure `mergeDetectedChecks` refuses to make on the check rows.
+    const suggestedInstall = result.dependencyInstall?.trim() ?? ''
+    const filledInstall = suggestedInstall !== '' && dependencyInstall.value.trim() === ''
+    if (filledInstall) dependencyInstall.value = suggestedInstall
+    if (merged.added === 0 && !filledInstall) {
       toast.add({
         title: t('inspector.validationChecks.detect.nothingNew'),
         description:
@@ -128,7 +141,13 @@ async function detect() {
     }
     const names = result.ecosystems.map(ecosystemLabel).join(', ')
     toast.add({
-      title: t('inspector.validationChecks.detect.added', { count: merged.added }, merged.added),
+      // An install-only detection fills nothing but the install field, and reporting it as
+      // "0 checks added" would read as a failed press on the one repo shape prepopulation is
+      // most for (dependencies to install, nothing declared to verify).
+      title:
+        merged.added === 0
+          ? t('inspector.validationChecks.detect.installOnly')
+          : t('inspector.validationChecks.detect.added', { count: merged.added }, merged.added),
       // Name what was recognised AND what was left out: a cap that silently swallowed a
       // suggestion reads as "that is everything your repo has".
       description: [
@@ -152,7 +171,12 @@ async function detect() {
 async function save() {
   busy.value = true
   try {
-    await store.save(props.block.id, submittable.value, maxAttempts.value)
+    await store.save(
+      props.block.id,
+      submittable.value,
+      maxAttempts.value,
+      dependencyInstall.value.trim() || undefined,
+    )
     toast.add({
       title: t('inspector.validationChecks.savedToast'),
       icon: 'i-lucide-check',
@@ -172,6 +196,7 @@ async function clear() {
   try {
     await store.remove(props.block.id)
     rows.value = []
+    dependencyInstall.value = ''
     toastDone('clear', noun)
   } catch (e) {
     notifyError(t('inspector.validationChecks.clearFailed'), e)
@@ -204,6 +229,19 @@ async function clear() {
     </template>
 
     <div class="space-y-2">
+      <UFormField
+        :label="t('inspector.validationChecks.dependencyInstall')"
+        :hint="t('inspector.validationChecks.dependencyInstallHint')"
+      >
+        <UInput
+          v-model="dependencyInstall"
+          placeholder="pnpm install --frozen-lockfile"
+          size="sm"
+          class="w-full"
+          data-testid="validation-dependency-install"
+        />
+      </UFormField>
+
       <p class="text-[11px] text-slate-500">
         {{ t('inspector.validationChecks.hint') }}
       </p>

package/app/stores/validationChecks.ts

@@ -86,21 +86,25 @@ export const useValidationChecksStore = defineStore('validationChecks', () => {
   }
 
   /**
-   * Save a service frame's checks. An EMPTY list clears the config on the backend (the service
-   * deletes the row), which restores the exact pre-feature behaviour — so the local list drops
-   * the entry rather than keeping an empty one that reads as "configured".
+   * Save a service frame's checks and its dependency-prepopulation install. The backend deletes
+   * the row only when BOTH are empty (restoring the exact pre-feature behaviour), so the local
+   * list mirrors that rule — dropping the entry on an empty save of both, and keeping it for a
+   * service that declares only an install. Testing `checks` alone here would evict a live
+   * install-only config from the store and report the service as unconfigured until a reload.
    */
   async function save(
     blockId: string,
     checks: ValidationCheck[],
     maxAttempts: number,
+    dependencyInstall?: string,
   ): Promise<void> {
     const ws = useWorkspaceStore()
     const saved = await api.setServiceValidationConfig(ws.requireId(), blockId, {
       checks,
       maxAttempts,
+      ...(dependencyInstall ? { dependencyInstall } : {}),
     })
-    if (saved.checks.length === 0) dropLocal(blockId)
+    if (saved.checks.length === 0 && !saved.dependencyInstall) dropLocal(blockId)
     else upsertLocal(saved)
   }
 

package/i18n/locales/de.json

@@ -1433,6 +1433,8 @@
     "validationChecks": {
       "title": "Prüfungen vor dem PR",
       "sectionHint": "Befehle, die nach dem Coder und vor dem Öffnen eines Pull Requests im Checkout laufen. Ein Fehlschlag geht zur Behebung an den Agenten zurück; nur ein fehlerfreier Checkout öffnet einen PR.",
+      "dependencyInstall": "Abhängigkeiten installieren",
+      "dependencyInstallHint": "Läuft, bevor der Agent startet",
       "hint": "Jeder Befehl läuft der Reihe nach mit `sh -c` im Checkout dieses Dienstes. Der Agent soll den Code reparieren, nicht die Prüfung abschwächen.",
       "clear": "Leeren",
       "configNoun": "Prüfungen",
@@ -1452,6 +1454,7 @@
         "action": "Erkennen",
         "hint": "Prüfungen aus dem Repository dieses Dienstes vorschlagen",
         "added": "{count} Prüfung hinzugefügt | {count} Prüfungen hinzugefügt",
+        "installOnly": "Abhängigkeitsinstallation eingetragen",
         "found": "Erkannt: {ecosystems}.",
         "capped": "Einige Vorschläge wurden ausgelassen — ein Dienst nimmt höchstens {max} Prüfungen auf.",
         "nothingNew": "Nichts hinzuzufügen",

package/i18n/locales/en.json

@@ -1155,6 +1155,9 @@
     "validationChecks": {
       "title": "Pre-PR validation",
       "sectionHint": "Commands run against the checkout after the coder finishes and before a pull request is opened. A failure is handed back to the agent to fix; only a passing checkout opens a PR.",
+      "dependencyInstall": "Dependency install",
+      "@dependencyInstall": "Field label for a shell command. \"install\" is a NOUN here (the installation step), not the imperative verb — it labels the input holding a command such as `pnpm install`, it does not ask the user to install anything.",
+      "dependencyInstallHint": "Runs before the agent starts",
       "hint": "Each command runs with `sh -c` in this service's checkout, in order. Fix the code, not the check — the agent is told not to weaken them.",
       "clear": "Clear",
       "configNoun": "validation checks",
@@ -1174,6 +1177,7 @@
         "action": "Detect",
         "hint": "Suggest checks from this service's repository",
         "added": "Added {count} check | Added {count} checks",
+        "installOnly": "Filled in the dependency install",
         "found": "Recognised {ecosystems}.",
         "capped": "Some suggestions were left out — a service takes at most {max} checks.",
         "nothingNew": "Nothing to add",

package/i18n/locales/es.json

@@ -1092,6 +1092,8 @@
     "validationChecks": {
       "title": "Validación previa al PR",
       "sectionHint": "Comandos que se ejecutan sobre la copia de trabajo cuando el programador termina y antes de abrir una solicitud de incorporación. Un fallo vuelve al agente para que lo corrija; solo una copia sin errores abre un PR.",
+      "dependencyInstall": "Instalación de dependencias",
+      "dependencyInstallHint": "Se ejecuta antes de que empiece el agente",
       "hint": "Cada comando se ejecuta con `sh -c` en la copia de trabajo de este servicio, en orden. Hay que arreglar el código, no la comprobación: al agente se le indica que no las debilite.",
       "clear": "Vaciar",
       "configNoun": "comprobaciones de validación",
@@ -1111,6 +1113,7 @@
         "action": "Detectar",
         "hint": "Sugerir comprobaciones a partir del repositorio de este servicio",
         "added": "Se añadió {count} comprobación | Se añadieron {count} comprobaciones",
+        "installOnly": "Se rellenó la instalación de dependencias",
         "found": "Se reconoció {ecosystems}.",
         "capped": "Se omitieron algunas sugerencias: un servicio admite como máximo {max} comprobaciones.",
         "nothingNew": "No hay nada que añadir",

package/i18n/locales/fr.json

@@ -1092,6 +1092,8 @@
     "validationChecks": {
       "title": "Validation avant la PR",
       "sectionHint": "Commandes exécutées sur la copie de travail une fois le développeur terminé et avant l'ouverture d'une demande de tirage. Un échec est renvoyé à l'agent pour correction ; seule une copie sans erreur ouvre une PR.",
+      "dependencyInstall": "Installation des dépendances",
+      "dependencyInstallHint": "S'exécute avant le démarrage de l'agent",
       "hint": "Chaque commande s'exécute avec `sh -c` dans la copie de travail de ce service, dans l'ordre. Il faut corriger le code, pas la vérification : il est demandé à l'agent de ne pas les affaiblir.",
       "clear": "Vider",
       "configNoun": "vérifications de validation",
@@ -1111,6 +1113,7 @@
         "action": "Détecter",
         "hint": "Proposer des vérifications à partir du dépôt de ce service",
         "added": "{count} vérification ajoutée | {count} vérifications ajoutées",
+        "installOnly": "L'installation des dépendances a été renseignée",
         "found": "Reconnu : {ecosystems}.",
         "capped": "Certaines suggestions ont été écartées : un service accepte au plus {max} vérifications.",
         "nothingNew": "Rien à ajouter",

package/i18n/locales/he.json

@@ -1092,6 +1092,8 @@
     "validationChecks": {
       "title": "בדיקות לפני בקשת משיכה",
       "sectionHint": "פקודות שרצות על העותק המקומי אחרי שהמפתח מסיים ולפני פתיחת בקשת משיכה. כישלון מוחזר לסוכן לתיקון; רק עותק תקין פותח בקשת משיכה.",
+      "dependencyInstall": "התקנת תלויות",
+      "dependencyInstallHint": "רץ לפני שהסוכן מתחיל",
       "hint": "כל פקודה רצה עם ‎`sh -c`‎ בעותק המקומי של שירות זה, לפי הסדר. יש לתקן את הקוד ולא את הבדיקה — הסוכן מונחה לא להחליש אותן.",
       "clear": "ניקוי",
       "configNoun": "בדיקות אימות",
@@ -1111,6 +1113,7 @@
         "action": "זהה",
         "hint": "הצע בדיקות מתוך המאגר של שירות זה",
         "added": "נוספה בדיקה {count} | נוספו {count} בדיקות",
+        "installOnly": "התקנת התלויות מולאה",
         "found": "זוהה: {ecosystems}.",
         "capped": "חלק מההצעות הושמטו — שירות מקבל לכל היותר {max} בדיקות.",
         "nothingNew": "אין מה להוסיף",

package/i18n/locales/it.json

@@ -1433,6 +1433,8 @@
     "validationChecks": {
       "title": "Validazione prima della PR",
       "sectionHint": "Comandi eseguiti sulla copia di lavoro quando lo sviluppatore ha finito e prima di aprire una richiesta di modifica. Un errore torna all'agente perché lo corregga; solo una copia senza errori apre una PR.",
+      "dependencyInstall": "Installazione delle dipendenze",
+      "dependencyInstallHint": "Viene eseguita prima dell'avvio dell'agente",
       "hint": "Ogni comando viene eseguito con `sh -c` nella copia di lavoro di questo servizio, in ordine. Va corretto il codice, non il controllo: all'agente viene chiesto di non indebolirli.",
       "clear": "Svuota",
       "configNoun": "controlli di validazione",
@@ -1452,6 +1454,7 @@
         "action": "Rileva",
         "hint": "Suggerisci controlli a partire dal repository di questo servizio",
         "added": "Aggiunto {count} controllo | Aggiunti {count} controlli",
+        "installOnly": "Installazione delle dipendenze compilata",
         "found": "Riconosciuto: {ecosystems}.",
         "capped": "Alcuni suggerimenti sono stati esclusi: un servizio accetta al massimo {max} controlli.",
         "nothingNew": "Niente da aggiungere",

package/i18n/locales/ja.json

@@ -1092,6 +1092,8 @@
     "validationChecks": {
       "title": "PR 前の検証",
       "sectionHint": "コーダーの作業完了後、プルリクエストを開く前にチェックアウトに対して実行されるコマンドです。失敗した場合はエージェントに差し戻して修正させ、問題のないチェックアウトだけが PR を開きます。",
+      "dependencyInstall": "依存関係のインストール",
+      "dependencyInstallHint": "エージェントの開始前に実行されます",
       "hint": "各コマンドはこのサービスのチェックアウト内で `sh -c` により順番に実行されます。修正すべきはコードであり検査ではありません。エージェントには検査を弱めないよう指示しています。",
       "clear": "消去",
       "configNoun": "検証コマンド",
@@ -1111,6 +1113,7 @@
         "action": "自動検出",
         "hint": "このサービスのリポジトリからチェックを提案します",
         "added": "{count} 件のチェックを追加しました | {count} 件のチェックを追加しました",
+        "installOnly": "依存関係のインストールを入力しました",
         "found": "{ecosystems} を検出しました。",
         "capped": "一部の候補は省略されました。1 つのサービスに設定できるチェックは最大 {max} 件です。",
         "nothingNew": "追加する項目はありません",

package/i18n/locales/pl.json

@@ -1092,6 +1092,8 @@
     "validationChecks": {
       "title": "Walidacja przed PR",
       "sectionHint": "Polecenia uruchamiane na kopii roboczej po zakończeniu pracy programisty, a przed otwarciem żądania scalenia. Niepowodzenie wraca do agenta do naprawy; tylko czysta kopia otwiera żądanie scalenia.",
+      "dependencyInstall": "Instalacja zależności",
+      "dependencyInstallHint": "Uruchamia się przed startem agenta",
       "hint": "Każde polecenie jest uruchamiane przez `sh -c` w kopii roboczej tej usługi, po kolei. Poprawiaj kod, a nie sprawdzenie — agent ma polecenie ich nie osłabiać.",
       "clear": "Wyczyść",
       "configNoun": "sprawdzenia walidacyjne",
@@ -1111,6 +1113,7 @@
         "action": "Wykryj",
         "hint": "Zaproponuj testy na podstawie repozytorium tej usługi",
         "added": "Dodano {count} test | Dodano {count} testy | Dodano {count} testów",
+        "installOnly": "Uzupełniono instalację zależności",
         "found": "Rozpoznano: {ecosystems}.",
         "capped": "Część propozycji pominięto — usługa przyjmuje najwyżej {max} testów.",
         "nothingNew": "Nie ma czego dodać",

package/i18n/locales/tr.json

@@ -1092,6 +1092,8 @@
     "validationChecks": {
       "title": "PR öncesi doğrulama",
       "sectionHint": "Kodlayıcı işini bitirdikten sonra ve bir çekme isteği açılmadan önce çalışma kopyası üzerinde çalıştırılan komutlar. Bir hata düzeltilmesi için aracıya geri verilir; yalnızca sorunsuz bir çalışma kopyası çekme isteği açar.",
+      "dependencyInstall": "Bağımlılık kurulumu",
+      "dependencyInstallHint": "Aracı başlamadan önce çalışır",
       "hint": "Her komut bu hizmetin çalışma kopyasında sırayla `sh -c` ile çalıştırılır. Denetimi değil kodu düzeltin — aracıya denetimleri zayıflatmaması söylenir.",
       "clear": "Temizle",
       "configNoun": "doğrulama denetimleri",
@@ -1111,6 +1113,7 @@
         "action": "Algıla",
         "hint": "Bu hizmetin deposundan denetimler öner",
         "added": "{count} denetim eklendi | {count} denetim eklendi",
+        "installOnly": "Bağımlılık kurulumu dolduruldu",
         "found": "{ecosystems} algılandı.",
         "capped": "Bazı öneriler dışarıda bırakıldı — bir hizmet en fazla {max} denetim alır.",
         "nothingNew": "Eklenecek bir şey yok",

package/i18n/locales/uk.json

@@ -1092,6 +1092,8 @@
     "validationChecks": {
       "title": "Перевірки перед PR",
       "sectionHint": "Команди, які виконуються на робочій копії після завершення роботи розробника та перед відкриттям запиту на злиття. Невдача повертається до агента на виправлення; лише чиста копія відкриває запит на злиття.",
+      "dependencyInstall": "Встановлення залежностей",
+      "dependencyInstallHint": "Виконується перед запуском агента",
       "hint": "Кожна команда виконується через `sh -c` у робочій копії цієї служби, по черзі. Виправляйте код, а не перевірку — агенту наказано не послаблювати їх.",
       "clear": "Очистити",
       "configNoun": "перевірки",
@@ -1111,6 +1113,7 @@
         "action": "Визначити",
         "hint": "Запропонувати перевірки з репозиторію цієї служби",
         "added": "Додано {count} перевірку | Додано {count} перевірки | Додано {count} перевірок",
+        "installOnly": "Встановлення залежностей заповнено",
         "found": "Розпізнано: {ecosystems}.",
         "capped": "Деякі пропозиції пропущено — служба приймає щонайбільше {max} перевірок.",
         "nothingNew": "Немає чого додавати",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.184.0",
+  "version": "0.185.0",
   "description": "Reusable Nuxt layer for the Agent Architecture Board SPA (components, stores, composables, pages). Consume it from a thin deployment app via `extends: ['@cat-factory/app']` and point it at your backend with NUXT_PUBLIC_API_BASE. See deploy/frontend for an example.",
   "repository": {
     "type": "git",
@@ -40,7 +40,7 @@
     "valibot": "^1.4.2",
     "vue": "3.5.40",
     "wretch": "^3.0.9",
-    "@cat-factory/contracts": "0.191.0"
+    "@cat-factory/contracts": "0.192.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",