specrails-desktop 2.30.2 → 2.31.0

package/docs/guide/fr/pipeline/5-the-loop-builder.md

@@ -17,7 +17,7 @@ Un **loop** est la *recette* du travail ; un **rail** est la *voie* qui l'exécu
 
 - Les loops vivent dans la section **Loops** (barre latérale gauche, à côté de vos projets) — ils sont **globaux**, partagés entre tous les projets.
 - Un rail **choisit un loop** dans son en-tête (le sélecteur de Loop) et l'exécute quand vous appuyez sur Play.
-- Le **rail** décide du provider, du modèle et de l'effort de raisonnement — *pas* les étapes du loop. Le même loop tourne sur Claude, Codex ou Gemini selon le rail.
+- Le **rail** choisit provider, modèle et effort compatible. Un loop compatible tourne sur Claude, Codex, Gemini ou Kimi.
 
 Donc : construisez un loop une fois, puis choisissez-le sur n'importe quel rail dans n'importe quel projet.
 
@@ -41,6 +41,10 @@ Un loop est un graphe de **nœuds** reliés par des **arêtes** (les flèches).
 
 Les arêtes relient les étapes dans l'ordre. Le **Loop Decider** a deux sorties étiquetées — **continue** et **stop** — donc vous câblez « pas encore fini » de retour vers le travail et « fini » vers un End.
 
+> **Kimi exécute les loops avec étapes IA/shell, mais sans Loop Decider.** Le
+> verdict est pure-output et `kimi -p` ne peut pas imposer sa frontière sans
+> outils ; le run est refusé avant la première étape.
+
 ### Écrire le texte d'une étape
 
 À l'intérieur de n'importe quel AI Step ou Decider, vous pouvez référencer :
@@ -57,7 +61,7 @@ Un loop qui ne s'arrête jamais brûlerait de l'argent indéfiniment, donc chaqu
 |-------|--------------|
 | **Max iterations** | Plafond strict sur le nombre de fois où le Decider peut boucler en arrière, quel que soit son verdict. |
 | **Timeout (min)** | Limite en temps réel pour toute l'exécution. |
-| **Max cost ($)** | *Optionnel.* Arrête le loop une fois que le coût accumulé dépasse votre budget. Vérifié **entre les étapes** (le coût d'une étape n'est connu qu'une fois qu'elle est terminée), donc il peut dépasser d'une étape. Sur Claude le coût est exact ; sur Codex et Gemini c'est une estimation. Laissez-le vide pour ne pas avoir de plafond. |
+| **Max cost ($)** | *Optionnel.* Claude rapporte le coût ; Codex/Gemini utilisent une estimation. Kimi ne fournit aucun coût USD autoritatif. |
 
 ## Construire en confiance
 

package/docs/guide/fr/specs/2-add-spec-quick-mode.md

@@ -2,6 +2,10 @@
 
 Le mode Quick, c'est pour quand vous savez déjà ce que vous voulez. Vous tapez votre idée, l'IA écrit la spec complète, et elle atterrit sur votre tableau au statut **À faire**. Aucun aller-retour — vous décrivez et c'est parti.
 
+> **Kimi n'est pas disponible pour Quick Spec.** `kimi -p` ne peut pas
+> imposer la frontière pure-output de ce formulaire. La requête est refusée
+> avant le démarrage ; utilisez Explore, Raw ou Quick Launcher (`/opsx:ff`).
+
 ## Créer une spec en mode Quick
 
 Pour créer une spec rapidement :
@@ -19,7 +23,8 @@ C'est tout le déroulé. Tout ce qui suit n'est qu'un réglage fin optionnel.
 
 **Modèle** — par défaut, l'IA choisit un modèle adapté. Vous pouvez le surcharger spec par spec depuis le sélecteur de modèle, si vous en voulez un plus rapide ou plus performant.
 
-**Moteur** — si votre projet a plus d'un fournisseur IA installé (n'importe quelle combinaison de Claude, Codex et Gemini), un sélecteur de moteur figure en haut de la fenêtre pour choisir lequel génère cette spec. Votre choix est mémorisé par projet. Les projets à fournisseur unique ne l'affichent pas — il n'y a rien à choisir.
+**Moteur** — le sélecteur affiche les fournisseurs **compatibles** ; Kimi est
+exclu de Quick Spec.
 
 **Contexte** — le mode Quick s'exécute en général en un seul tour, car il n'a pas besoin de lire votre base de code pour rédiger une spec à partir de votre description. Mais un curseur de contexte lui permet de disposer de plus d'éléments :
 

package/docs/guide/it/agents/2-profiles-and-the-balanced-default.md

@@ -37,7 +37,11 @@ La scelta del profilo avviene proprio dove si lancia — nell'**intestazione del
 
 ## Quando la sezione Agenti tace
 
-I profili sono una funzionalità di Claude. Su un progetto che include un provider diverso da Claude (Codex o Gemini), la sezione Agenti è nascosta e i rail girano senza profili — è il comportamento atteso, non un bug. I profili richiedono inoltre una versione di `specrails-core` abbastanza recente nel progetto; se è più datata, vedrai un banner giallo. I profili che crei vengono comunque **salvati** — semplicemente non influiscono sulla pipeline finché core non viene aggiornato. Aggiorna con il comando indicato nel banner per sbloccarli.
+I profili sono separati per provider. Claude e Kimi supportano profili/ruoli;
+Codex e Gemini usano la modalità legacy. In progetti misti lo stesso nome non
+attraversa Claude/Kimi. Kimi consente ruoli manuali, ma generazione, smoke test
+e AI Refine di Agent Studio sono rifiutati prima dello spawn. Kimi richiede
+`specrails-core` 4.12.0 o più recente.
 
 ## Dove andare adesso
 

package/docs/guide/it/agents/4-custom-agents-catalog.md

@@ -11,21 +11,24 @@ Ogni voce del catalogo mostra a cosa serve l'agente e il suo modello predefinito
 
 ## Aggiungere un agente custom
 
-Gli agenti custom sono semplici file Markdown nel tuo repository, sotto `.claude/agents/`, con nome `custom-<qualcosa>.md`. Il file contiene le istruzioni dell'agente (il suo system prompt) e un piccolo header di frontmatter che include un `model:` predefinito.
+I ruoli sono asset nativi del provider: Claude usa
+`.claude/agents/custom-<nome>.md`; Kimi usa
+`.kimi-code/skills/custom-<nome>/SKILL.md`.
 
-Una volta che il file esiste nel progetto, compare nel catalogo come agente custom, e puoi aggiungere il suo id alla catena di agenti di qualsiasi profilo (e instradare i task verso di esso). L'id deve corrispondere al nome del file — una voce per `custom-docs` mappa su `.claude/agents/custom-docs.md`.
+Quando l'asset esiste, compare nel catalogo del provider e il suo id può essere aggiunto a un profilo dello stesso provider. `custom-docs` mappa su `.claude/agents/custom-docs.md` per Claude o `.kimi-code/skills/custom-docs/SKILL.md` per Kimi; i due restano separati.
 
 Poiché vivono nel tuo repo, gli agenti custom sono **asset di squadra committabili**: committi il file e tutta la tua squadra ottiene l'agente. Questo riflette l'idea centrale che attraversa l'intera sezione Agenti —
 
 > **Le definizioni degli agenti sono condivise (vivono nel repo e viaggiano con `git`). La configurazione dei modelli è per progetto (vive nei profili).**
 
-Il namespace `custom-*` è riservato e protetto: i comandi `init` e `update` di `specrails-core` non toccano mai `.claude/agents/custom-*.md`, così i tuoi agenti custom sopravvivono intatti agli aggiornamenti di core. (La stessa protezione copre i frammenti contribuiti dai plugin, come `custom-serena.md`.)
+Core protegge entrambi i formati. Kimi permette creazione/modifica manuale ed
+esecuzione; Generate, Test e AI Refine sono rifiutati prima dello spawn.
 
 ## Mettere al lavoro un agente custom
 
 Il flusso tipico:
 
-1. Scrivi `.claude/agents/custom-<nome>.md` con le istruzioni e un modello predefinito.
+1. Crea l'asset Claude o lo Skill Kimi nativo con istruzioni/modello validi.
 2. Verifica che compaia in **Agenti → Catalogo** sotto Custom.
 3. In **Agenti → Profili**, aggiungi l'agente alla catena di un profilo (facendo eventualmente l'override del suo modello per quel profilo).
 4. Aggiungi una regola di routing affinché i task con i tag giusti lo raggiungano — oppure affidati all'ordine della catena.

package/docs/guide/it/getting-started/1-what-is-specrails.md

@@ -36,6 +36,7 @@ Specrails funziona con le principali CLI di programmazione AI:
 - **Claude** (Claude Code)
 - **Codex** (Codex CLI)
 - **Gemini** (Gemini CLI)
+- **Kimi** (Kimi Code)
 
 Scegli quella che già usi — oppure installane più di una e scegline una a seconda dell'attività. Un progetto può funzionare con un singolo provider o con più provider contemporaneamente, così non resti mai vincolato a una scelta.
 

package/docs/guide/it/getting-started/2-installing-and-first-run.md

@@ -23,6 +23,7 @@ L'unica cosa che specrails non può includere è la **CLI del provider AI** vera
 - **Claude Code**
 - **Codex CLI**
 - **Gemini CLI**
+- **Kimi Code**
 
 Installa quella che intendi usare, accedi una volta dal terminale e sei a posto. Specrails rileva automaticamente quali provider sono presenti.
 

package/docs/guide/it/getting-started/4-the-dashboard-tour.md

@@ -26,13 +26,13 @@ La barra laterale destra è il tuo centralino per il progetto corrente. Passaci
 
 - **Dashboard** — la board delle spec e i rail (dove ti trovavi poco fa).
 - **Job** — ogni esecuzione della pipeline per questo progetto, passata e presente, con stato, durata e la possibilità di approfondire il dettaglio e i log di ciascuna esecuzione.
-- **Analytics** — quanto ti sta costando l'uso dell'AI. La spesa suddivisa per giorno, per attività, per modello e per ticket — così niente sorprese.
-- **Agenti** — i profili degli agenti del tuo progetto: quali agenti vengono eseguiti nella pipeline e quali modelli AI usano. *(Solo per i progetti basati su Claude.)*
-- **Codice** — un browser di file in sola lettura con riepiloghi AI in linguaggio semplice, e dei chip che indicano quali file l'AI ha toccato. Ottimo per chi non è sviluppatore ma vuole seguire ciò che accade.
+- **Analytics** — invocazioni per giorno, attività, modello e ticket. Claude riporta il costo fatturato, Codex/Gemini usano stime e Kimi lascia vuoti i campi token/costo USD non disponibili.
+- **Agenti** — profili e cataloghi di ruoli separati per provider per Claude e Kimi. Con Kimi i ruoli si creano/modificano manualmente; Generate, Test e AI Refine non sono disponibili.
+- **Codice** — un browser di file in sola lettura con chip per i file toccati dall'AI. I riepiloghi AI in linguaggio semplice compaiono solo con provider compatibili e non sono disponibili con Kimi.
 - **Integrazioni** — componenti aggiuntivi opzionali, come collegare le tue spec a una board **Jira** o abilitare strumenti extra per l'AI.
 - **Impostazioni** — opzioni per progetto (telemetria, budget, configurazione dei provider e altro ancora).
 
-> Alcune sezioni compaiono solo quando hanno senso per i provider che hai scelto — per esempio, **Agenti** è specifica di Claude. Se non vedi una sezione, semplicemente non si applica alla configurazione di questo progetto.
+> Sezioni e azioni seguono le capacità del provider effettivo. Per esempio, i profili funzionano con Claude e Kimi, mentre le azioni AI di Agent Studio falliscono in modo chiuso con Kimi.
 
 ## La barra di stato
 

package/docs/guide/it/integrations/1-ai-providers.md

@@ -1,16 +1,20 @@
-# Provider AI (Claude, Codex, Gemini)
+# Provider AI (Claude, Codex, Gemini, Kimi)
 
-Specrails non è legato a una sola AI. Ogni parte dell'app che dialoga con un'AI — Explore Spec, Quick spec, i rail, la chat, AI Edit, il pulsante "Open AI CLI" del terminale — può funzionare con uno qualsiasi dei tre provider di prima classe. Scegli tu quali usare in un progetto, e puoi addirittura cambiare provider task per task.
+Specrails non è legato a una sola AI. Claude, Codex, Gemini e Kimi sono
+provider di prima classe; ogni superficie propone solo i motori compatibili
+con il proprio contratto.
 
-## I tre provider
+## I quattro provider
 
 | Provider | CLI | Realizzato da | Note |
 |---|---|---|---|
-| **Claude** | `claude` | Anthropic | Il più completo. È l'unico provider per gli Agenti (profili), i rail Freestyle e il Contract Refine. |
+| **Claude** | `claude` | Anthropic | Costo nativo e trasporto interattivo persistente. |
 | **Codex** | `codex` | OpenAI | Richiede codex `0.128.0+`. Legge i suoi server MCP dal file globale `~/.codex/config.toml`. |
 | **Gemini** | `gemini` | Google | Richiede gemini `0.11.0+`. Usa la telemetria nativa e un file di istruzioni `GEMINI.md`. |
+| **Kimi Code** | `kimi` | Moonshot AI | Richiede Kimi `0.27.0+`. Desktop avvia la CLI esterna con `-p`; non installa né avvia un server. |
 
-Tutti e tre sono **abilitati di default**. Un provider compare in **Add Project** ogni volta che la sua CLI è installata e presente nel tuo `PATH`. Quindi il primo passo è sempre lo stesso: installa la CLI che vuoi usare e accedi con essa, esattamente come descritto nella documentazione di quello strumento. Una volta che `claude --version` (o `codex`, o `gemini`) funziona nel tuo terminale, Specrails può usarla.
+Tutti e quattro sono **abilitati di default**. Il provider compare quando la
+CLI è nel `PATH`; per Kimi verifica `kimi --version` ed esegui `kimi login`.
 
 ## Installare un provider per un progetto
 
@@ -25,40 +29,46 @@ Puoi installare **più di un** provider nello stesso progetto — per esempio Cl
 Qualche cosa utile da sapere sui progetti multi-provider:
 
 - **Con un solo provider tutto si comporta esattamente come prima.** Se un progetto ha un unico provider, non vedrai mai un selettore di provider da nessuna parte — l'app resta pulita e semplice.
-- **La barra laterale destra mostra solo le sezioni supportate da tutti i provider installati.** Poiché gli Agenti (profili) sono un concetto esclusivo di Claude, la sezione **Agenti** scompare nel momento in cui un progetto include un provider diverso da Claude. Tutto il resto (Spec, Code, Analisi, Integrazioni, Terminale, Chat) rimane.
+- **Le capability guidano la UI.** Claude e Kimi supportano profili separati
+  per provider; Codex e Gemini usano la modalità legacy.
 - **La scelta dei provider è bloccata dopo la creazione.** In questa versione scegli i tuoi provider quando aggiungi il progetto e non possono essere modificati in seguito dalle Impostazioni. Se ti serve un mix diverso, crea un nuovo progetto.
 
 ## Scegliere un provider per ogni invocazione
 
 Il vero vantaggio di un progetto multi-provider è poter scegliere l'AI giusta per ciascun task — senza toccare alcuna impostazione globale. Ovunque venga eseguita un'AI compare un piccolo selettore di provider (solo quando il progetto ne ha più di uno):
 
-- **Add Spec** — un selettore di motore ti permette di esplorare o generare in modalità Quick una spec con il provider che preferisci.
+- **Add Spec** — Explore supporta Kimi; Quick Spec mostra solo provider con un
+  confine pure-output sicuro e quindi esclude Kimi.
 - **Intestazione del rail** — scegli il motore per quello specifico rail prima di avviarlo.
 - **Terminale** — il pulsante "Open AI CLI" (Sparkles) apre un menu dei provider così puoi entrare in una qualsiasi CLI installata nella cartella di quel progetto.
 
 La tua scelta viene ricordata per progetto, con il provider primario come default, così non devi riselezionarla ogni volta.
 
-## Cosa può fare solo Claude
+## Differenze di capability
 
-Alcune funzioni sono per natura specifiche di Claude, quindi vengono nascoste o saltate quando è in uso un altro provider:
+Kimi supporta Project/Agent Chat, Explore/proposte, Quick Launcher
+(`/opsx:ff`), rail, Freestyle, loop senza Decider, profili/ruoli manuali, MCP,
+Serena, terminale e allegati.
 
-- **Agenti (profili)** — il catalogo degli agenti per progetto e il routing dei modelli. Nascosti in qualsiasi progetto che includa un provider diverso da Claude.
-- **Rail Freestyle** — vengono sempre eseguiti su Claude.
-- **Contract Refine** — il passaggio aggiuntivo "Contract Layer" su una spec confermata viene eseguito solo quando il provider della conversazione è Claude.
-- **Modalità avanzate di Add Spec** (SMASH / Contract Layer) — nascoste per i motori diversi da Claude.
-
-Tutto il resto — Explore, Quick spec, l'intera pipeline dei rail, AI Edit, chat, analisi dei costi — funziona con tutti e tre.
+`kimi -p` approva automaticamente gli strumenti e non può imporre un confine
+no-tools/read-only. Sono quindi rifiutati prima dello spawn: Quick Spec, AI
+Edit, Contract Refine, SMASH/Re-SMASH, generazione blueprint/milestone di
+Project Builder, Loop Decider, riassunti/construction story e automazione
+Agent Studio. Auto-title usa un fallback deterministico. Vedi la
+[guida Kimi](../../../kimi.md).
 
 ## Tracciamento dei costi tra i provider
 
-La pagina **Analisi** traccia ogni invocazione fatturabile, indipendentemente dal provider. Sui progetti multi-provider aggiunge dei chip di filtro per motore così puoi confrontare la spesa per provider. Claude riporta il proprio costo esatto; per Codex e Gemini, Specrails stima il costo da un listino integrato, quindi i numeri sono approssimazioni vicine al reale più che importi effettivamente addebitati.
+**Analisi** registra le invocazioni realmente avviate. Claude riporta il
+costo; Codex/Gemini usano una stima. Kimi non riporta token o costo USD
+autorevoli, quindi i campi restano vuoti.
 
 ## Risoluzione dei problemi
 
-- **Un provider che ho installato non viene proposto.** Verifica che la CLI sia presente nel tuo `PATH` (prova `claude --version` / `codex --version` / `gemini --version` in un terminale nuovo). L'app sonda le CLI dei provider tramite il `PATH` di sistema.
+- **Un provider che ho installato non viene proposto.** Prova `claude --version` / `codex --version` / `gemini --version` / `kimi --version`.
 - **I server MCP di Codex non si caricano in chat.** Codex legge i server MCP dal file globale `~/.codex/config.toml` — registrali lì con `codex mcp add`.
 - **Disabilitazione d'emergenza.** Un provider può essere disattivato a livello di app tramite una variabile d'ambiente (`SPECRAILS_CODEX_BETA=0` o `SPECRAILS_GEMINI_BETA=0`). Questo nasconde il provider solo dalla *selezione*; raramente è necessario.
 
 ## Vedi anche
 
-Le guide dedicate ai provider approfondiscono ciascuna CLI: la guida di Codex e la guida di Gemini coprono ognuna il setup, cosa funziona e le particolarità specifiche del provider.
+Consulta le guide dedicate a [Kimi](../../../kimi.md), Codex e Gemini.

package/docs/guide/it/integrations/2-plugins.md

@@ -21,7 +21,7 @@ Il plugin di punta è:
 3. Entra nel plugin per **vedere l'anteprima dell'installazione** — ti mostra esattamente quali file cambieranno prima che succeda qualsiasi cosa.
 4. Clicca **Installa**. Vedrai l'avanzamento in tempo reale durante la configurazione.
 
-Dietro le quinte l'installazione è *chirurgica e additiva*: aggiunge soltanto le proprie voci al `.mcp.json` del tuo progetto (e, per alcuni plugin, un file frammento nel namespace protetto `.claude/agents/`). Non riscrive mai integralmente la tua configurazione, e l'aggiunta di un secondo plugin non può mai disturbare il primo. Se l'installazione non riesce a verificarsi come integra, viene annullata in modo pulito.
+Dietro le quinte l'installazione è *chirurgica e additiva*: aggiunge voci solo alla configurazione MCP nativa del provider scelto (e, per alcune installazioni Claude, un frammento sotto `.claude/agents/`). Non riscrive mai tutta la configurazione e, se la verifica fallisce, esegue un rollback pulito.
 
 ## Gestire i plugin installati
 
@@ -37,8 +37,8 @@ Dietro le quinte l'installazione è *chirurgica e additiva*: aggiunge soltanto l
 
 ## Note sui provider
 
-I plugin sono consapevoli del provider. Serena e i plugin MCP analoghi si risolvono per i provider che registrano l'MCP tramite il `.mcp.json` del progetto (Claude e Gemini). Per i progetti Codex, i server MCP vengono gestiti invece tramite la configurazione globale di Codex, quindi le voci dei plugin in **Integrazioni** vengono filtrate di conseguenza. La scheda Jira nelle Integrazioni è indipendente dal provider e viene mostrata a tutti — consulta la guida di Jira.
+I plugin sono consapevoli del provider. Serena supporta Claude tramite `.mcp.json`, Codex tramite `codex mcp add` con `CODEX_HOME` isolato per progetto e Kimi tramite `.kimi-code/mcp.json`. Un plugin compare solo se il manifesto dichiara il provider; Serena quindi non è offerto per Gemini. La scheda Jira resta indipendente dal provider.
 
 ## File riservati
 
-I plugin gestiscono un insieme ristretto e ben definito di file nel tuo progetto: il tuo `.mcp.json` (unito in modo chirurgico), un po' di stato sotto `.specrails/plugins/` e i frammenti agente specifici per plugin in `.claude/agents/custom-<plugin>.md`. Questi sono asset di team committabili, se vuoi condividere un'integrazione con i tuoi colleghi — l'app non li sovrascrive mai ciecamente.
+I plugin gestiscono la configurazione MCP nativa del provider, lo stato sotto `.specrails/plugins/` e, solo quando serve a Claude, frammenti sotto `.claude/agents/custom-<plugin>.md`. Le voci Kimi vivono in `.kimi-code/mcp.json`; l'app non scrive frammenti esclusivi di Claude per Kimi e non sovrascrive mai le configurazioni alla cieca.

package/docs/guide/it/integrations/6-agent-chat.md

@@ -22,7 +22,14 @@ Scegliere un progetto qui **non** sposta la tua dashboard: l'obiettivo dell'agen
 
 ## Provider e modello
 
-Proprio sopra la casella del messaggio scegli il **provider** (Claude, Codex o Gemini) e il suo **modello**. Ogni provider ha la propria lista di modelli, e cambiare provider avvia una sessione nuova con il modello predefinito di quel provider — così puoi, ad esempio, pilotare l'app con Claude e passare a Codex per un'altra conversazione senza che nulla si incroci.
+Proprio sopra la casella del messaggio scegli il **provider** (Claude, Codex,
+Gemini o Kimi) e il suo **modello**. Cambiare provider avvia una sessione
+separata.
+
+Con Kimi i livelli limitano gli strumenti MCP Specrails, ma non trasformano
+`kimi -p` in una sandbox: gli strumenti nativi sono approvati
+automaticamente. Le azioni pure-output non sicure sono rifiutate prima dello
+spawn; vedi la [matrice Kimi](../../../kimi.md).
 
 ## Livelli di permesso — le redini le tieni tu
 

package/docs/guide/it/pipeline/1-rails-and-jobs.md

@@ -35,8 +35,8 @@ Tutto qui. Il rail avvia un processo CLI AI nel contesto di esecuzione corretto
 | **Pillola di stato** | `idle`, `running` o `failed`. Non esiste uno stato "completed" separato — un rail torna a `idle` quando il suo job termina senza errori. |
 | **Elenco spec** | Gli ID assegnati a questo rail. Trascinane altri dentro, oppure fuori per staccarli. |
 | **Selettore Loop** | Il Loop che questo rail esegue — uno integrato (`Implement` / `Batch` / `Freestyle`) o un loop personalizzato. Vedi la tabella più sotto. Viene salvato per ogni rail. |
-| **Selettore profilo** | Quale profilo agente viene eseguito (solo per i rail Claude). Compare solo quando il progetto ha almeno un profilo. |
-| **Selettore engine** | Quale provider installato esegue questo rail — Claude, Codex o Gemini. Viene mostrato solo quando il progetto ha più di un provider. Vedi [Scegliere un engine per ogni rail](picking-an-engine-per-rail). |
+| **Selettore profilo** | Quale profilo del provider viene eseguito (rail Claude e Kimi). |
+| **Selettore engine** | Quale provider esegue il rail — Claude, Codex, Gemini o Kimi. |
 | **▶ Play / ■ Stop** | Avvia o annulla. |
 
 ### Cosa esegue un rail: i Loop
@@ -47,9 +47,11 @@ Un rail esegue un **Loop** — la ricetta del lavoro. Tre loop sono **integrati*
 |------|---------|--------------|
 | **Implement** | `/specrails:implement` | Un unico job che copre tutte le spec sul rail. Esegue l'intera pipeline Architect → Developer → Reviewer → Ship. L'impostazione predefinita di tutti i giorni. |
 | **Batch** | `/specrails:batch-implement` | Un unico job che lavora le spec del rail in sequenza, in ondate consapevoli delle dipendenze. Ideale per più spec correlate. |
-| **Freestyle** | Freestyle | Claude implementa ogni spec in autonomia, **bypassando** la pipeline. Un job indipendente per ogni spec. Solo Claude. |
+| **Freestyle** | Freestyle | Claude o Kimi implementa ogni spec in autonomia, **bypassando** la pipeline. |
 
-Freestyle è il caso a sé stante: salta la catena di agenti e affida a Claude la spec grezza, lasciandolo lavorare con i suoi strumenti nativi. È a finalità aperta, quindi premendo Play si apre prima una conferma, e un selettore di modello per rail ti permette di scegliere tra Haiku / Sonnet / Opus. Compare solo quando l'engine del rail è Claude. Un'esecuzione Freestyle è anche l'unico job che **resta aperto ad aspettarti**: chatta con lui dal composer del Dettaglio job e clicca **Finalize** quando sei soddisfatto (tutti gli altri job si concludono da soli).
+Freestyle usa strumenti e modelli nativi del provider. Claude ha un transport
+interattivo persistente; Kimi usa un processo agentic `kimi -p` senza stdin
+persistente.
 
 Oltre agli integrati, puoi **costruire i tuoi loop** — ripetere un ciclo verify → fix → verify finché un obiettivo non è raggiunto, concatenare comandi shell tra gli AI Step e altro ancora. Quei loop personalizzati compaiono nello stesso selettore Loop. È la prossima grande idea: [Il Loop Builder](the-loop-builder).
 
@@ -81,7 +83,8 @@ Clicca su **■ Stop** nell'intestazione del rail. L'app invia `SIGTERM` al sott
 
 ## Se un rail non parte
 
-Se scegli un engine la cui CLI non è installata sulla tua macchina, l'avvio **fallisce subito** invece di avviare un job difettoso — non viene avviato nulla. Installa la CLI del provider mancante ([Usare Codex](../integrations/using-codex), [Usare Gemini](../integrations/using-gemini)) e riprova ad avviare. Se mancano Claude o Codex compare un messaggio preciso "*<provider> CLI not found*"; se manca Gemini oggi viene mostrato un errore di avvio generico, ma il risultato è lo stesso.
+Se manca la CLI scelta, l'avvio fallisce prima dello spawn. Per Kimi,
+installa/autentica `kimi` 0.27+; Desktop non avvia un server.
 
 ## Fermare tutto
 
@@ -96,4 +99,4 @@ Se qualcosa sembra non andare:
 - [Il Loop Builder](the-loop-builder) — cosa esegue un rail e come costruire i tuoi loop.
 - [La vista Dettaglio job](the-job-detail-view) — fasi, metriche live, schede ticket.
 - [Batch implement e multi-feature](batch-implement-and-multi-feature) — esegui più spec insieme.
-- [Scegliere un engine per ogni rail](picking-an-engine-per-rail) — Claude vs Codex vs Gemini.
+- [Scegliere un engine per ogni rail](picking-an-engine-per-rail) — Claude, Codex, Gemini o Kimi.

package/docs/guide/it/pipeline/2-the-job-detail-view.md

@@ -94,7 +94,9 @@ Alcune cose che vale la pena sapere:
 - **La riga dei totali è reale.** Il composer mostra un riepilogo live `N turni · $X`, sommato dall'uso reale di ogni turno completato — coerente con la promessa di questa pagina di non tirare mai a indovinare.
 - **Due modi in cui una sessione finisce.** La maggior parte dei job **si conclude da sola**: nel momento in cui un turno termina senza messaggi in coda, la sessione si assesta e il job si completa — i tuoi messaggi sono guida opzionale, mai un obbligo. Un'azione discreta **Concludi ora** la chiude prima, con tutto ciò che è stato prodotto fin lì. I job **Freestyle** sono l'eccezione: restano in attesa tra un turno e l'altro finché non clicchi **Finalize** — è il loro design, una sessione botta e risposta che chiudi quando hai finito.
 - **Nelle esecuzioni di loop i messaggi vanno al passo attivo.** Su un loop integrato o personalizzato, il tuo messaggio raggiunge il **passo AI in esecuzione in quel momento**. Tra un passo e l'altro (mentre il Loop Decider riflette, o gira un comando shell) il composer mostra un breve stato *«In attesa del prossimo passo…»* — il testo in bozza viene conservato, e l'invio si riattiva quando parte il prossimo passo AI. **Assesta questo passo** termina il passo corrente in anticipo e lascia che il loop avanzi con ciò che ha prodotto.
-- **Solo Claude, per ora.** I job Codex e Gemini girano one-shot esattamente come prima — non compare alcun composer. (Gli operatori del server possono spegnere l'intera funzionalità con `SPECRAILS_INTERACTIVE_JOBS=false`.)
+- **L'interazione persistente è solo Claude.** Codex, Gemini e Kimi sono
+  one-shot; Kimi riprende una chat con un nuovo `kimi --session=<id> -p` dopo un resume
+  hint riuscito.
 
 ## Esportazione diagnostica
 

package/docs/guide/it/pipeline/3-batch-implement-and-multi-feature.md

@@ -81,4 +81,4 @@ Non c'è alcun limite globale di concorrenza da regolare. Apri i progetti o i ra
 
 - [Rail e job](rails-and-jobs) — il modello della coda in dettaglio.
 - [La vista Dettaglio job](the-job-detail-view) — guarda un batch in esecuzione dal vivo.
-- [Scegliere un engine per ogni rail](picking-an-engine-per-rail) — nota che il Batch gira su qualsiasi provider; Freestyle è solo Claude.
+- [Scegliere un engine per ogni rail](picking-an-engine-per-rail) — Batch gira su qualsiasi provider; Freestyle è disponibile con Claude e Kimi.

package/docs/guide/it/pipeline/4-picking-an-engine-per-rail.md

@@ -1,6 +1,7 @@
 # Scegliere un engine per ogni rail
 
-Specrails desktop tratta **Claude Code**, **Codex CLI** e **Gemini CLI** come engine di prima classe. Un progetto può averne installato uno, due o tutti e tre — e quando ne è presente più di uno, scegli quale engine esegue ogni rail. Questa pagina spiega il selettore di engine per rail e quando ricorrere a ciascuno.
+Specrails desktop tratta **Claude Code**, **Codex CLI**, **Gemini CLI** e
+**Kimi Code** come engine di prima classe. È possibile ogni combinazione compatibile.
 
 ## Quando compare il selettore
 
@@ -13,30 +14,27 @@ Quando compare, la tua scelta è **per rail e per avvio** — rail diversi posso
 ## Come scegliere un engine
 
 1. Assicurati che il selettore di engine del rail sia visibile (il progetto ha 2+ provider).
-2. Cliccaci sopra e scegli **Claude**, **Codex** o **Gemini**.
+2. Cliccaci sopra e scegli **Claude**, **Codex**, **Gemini** o **Kimi**.
 3. Avvia il rail con **▶ Play**.
 
 L'engine selezionato esegue ogni fase della pipeline di quel rail. Se la CLI dell'engine scelto non è installata, l'avvio fallisce subito — non viene avviato nulla. Installa la CLI mancante e riprova.
 
 ## In cosa è bravo ciascun engine
 
-Tutti e tre eseguono le pipeline standard **Implement** e **Batch**. Ecco una guida pratica alla scelta:
+Tutti e quattro eseguono **Implement** e **Batch**:
 
 | Engine | Scegli questo quando… | Note |
 |--------|--------------------|-------|
-| **Claude** | Vuoi l'intero set di funzionalità: profili agente, Freestyle, reportistica nativa dei costi, il supporto agli strumenti più ricco. L'impostazione predefinita per la maggior parte del lavoro. | L'unico engine che supporta i **profili agente**, **Freestyle** e alcune funzionalità delle spec esclusive di Claude (Contract Layer, SMASH). |
+| **Claude** | Servono costi nativi, interazione persistente o tool policy rigorose. | Profili, Freestyle e transform strutturati. |
 | **Codex** | Preferisci la CLI Codex di OpenAI o vuoi confrontare le implementazioni tra provider diversi. | `codex` ≥ 0.128.0. Nessuna reportistica nativa dei costi — l'app ricava il costo dalla sua tabella prezzi. I profili non si applicano. |
 | **Gemini** | Vuoi la CLI Gemini di Google, telemetria nativa o un'esecuzione più economica per le spec di routine. | `gemini` ≥ 0.11.0 (imposta `GEMINI_API_KEY`). Telemetria OTLP nativa. I profili non si applicano. |
+| **Kimi** | Vuoi Kimi agentic per Implement, Batch, Freestyle o loop senza Decider. | `kimi` ≥ 0.27.0 esterno; profili/ruoli, effort solo K3; token/costo non disponibili. |
 
-### Le funzionalità esclusive di Claude
+### Differenze di capability
 
-Alcune cose funzionano solo sui rail Claude — scegli Claude se ne hai bisogno:
-
-- **Profili agente** — routing del modello per ogni agente. Sui rail Codex o Gemini l'esecuzione usa sempre la modalità legacy e qualsiasi profilo selezionato viene **ignorato**. Il selettore di profilo è nascosto per gli engine diversi da Claude.
-- **Freestyle** — la modalità autonoma che bypassa la pipeline. Il segmento `Freestyle` e il suo selettore di modello Haiku/Sonnet/Opus compaiono solo quando l'engine del rail è Claude.
-- **Contract Layer e SMASH** — funzionalità di affinamento delle spec esclusive di Claude (sono opzioni di Add Spec, non opzioni del rail, ma vale lo stesso vincolo).
-
-Se un progetto mescola engine, la barra laterale destra mostra solo le sezioni supportate da **ogni** provider installato — quindi la sezione **Agenti** sparisce del tutto su un progetto che include un provider diverso da Claude, perché i profili sono specifici di Claude.
+Claude e Kimi supportano profili/Freestyle; Codex/Gemini usano legacy. Kimi
+rifiuta Loop Decider e i transform pure-output nella
+[guida Kimi](../../../kimi.md). I profili Claude/Kimi restano separati.
 
 ## Un flusso di lavoro pratico
 
@@ -49,12 +47,14 @@ I progetti multi-provider danno il meglio quando vuoi **confrontare** o **ottimi
 ## Cose da tenere a mente
 
 - **La selezione del provider è immutabile dopo la creazione del progetto** (v1). Scegli i provider installati quando aggiungi il progetto; non c'è alcun interruttore nelle Impostazioni per aggiungerne o rimuoverne uno in seguito.
-- **Il costo viene sempre tracciato**, anche per gli engine privi di reportistica nativa dei costi — l'app ripiega su una tabella prezzi, così anche le esecuzioni Codex e Gemini compaiono in [analytics](../analytics/tracking-cost).
+- **Le metriche disponibili sono tracciate.** Kimi non fornisce token/costo USD
+  autorevoli; i campi restano vuoti.
 - **Il pulsante "Open AI CLI" del terminale** offre anch'esso un selettore di provider sui progetti multi-provider, se preferisci pilotare una CLI a mano.
 
 ## Dove andare ora
 
 - [Usare Codex](../integrations/using-codex) — installazione e accesso.
 - [Usare Gemini](../integrations/using-gemini) — installazione, `GEMINI_API_KEY`, telemetria.
+- [Usare Kimi](../../../kimi.md) — installazione e matrice completa.
 - [Rail e job](rails-and-jobs) — la coda e il flusso di avvio.
 - [Tracciare i costi](../analytics/tracking-cost) — ripartizione dei costi per engine.

package/docs/guide/it/pipeline/5-the-loop-builder.md

@@ -17,7 +17,7 @@ Un **loop** è la *ricetta* del lavoro; un **rail** è la *corsia* che lo esegue
 
 - I loop vivono nella sezione **Loops** (sidebar sinistra, accanto ai tuoi progetti) — sono **globali**, condivisi tra tutti i progetti.
 - Un rail **sceglie un loop** nel suo header (il selettore Loop) e lo esegue quando premi Play.
-- È il **rail** a decidere provider, modello e reasoning effort — *non* gli step del loop. Lo stesso loop gira su Claude, Codex o Gemini a seconda del rail.
+- Il **rail** sceglie provider, modello ed effort compatibile. Un loop compatibile gira su Claude, Codex, Gemini o Kimi.
 
 Quindi: costruisci un loop una volta, poi scegli quel loop su qualsiasi rail in qualsiasi progetto.
 
@@ -41,6 +41,10 @@ Un loop è un grafo di **nodi** collegati da **archi** (le frecce). Ogni nodo è
 
 Gli archi collegano gli step in ordine. Il **Loop Decider** ha due uscite etichettate — **continue** e **stop** — così colleghi "non ancora finito" di nuovo nel lavoro e "fatto" verso un End.
 
+> **Kimi esegue loop con step AI/shell, ma non con Loop Decider.** Il verdetto
+> è pure-output e `kimi -p` non può imporre il confine no-tools; il run è
+> rifiutato prima del primo step.
+
 ### Scrivere il testo di uno step
 
 Dentro qualsiasi AI Step o Decider puoi fare riferimento a:
@@ -57,7 +61,7 @@ Un loop che non si ferma mai brucerebbe soldi per sempre, quindi ogni esecuzione
 |-------|--------------|
 | **Max iterations** | Tetto massimo di quante volte il Decider può tornare indietro, indipendentemente dal suo verdetto. |
 | **Timeout (min)** | Limite di tempo reale per l'intera esecuzione. |
-| **Max cost ($)** | *Opzionale.* Ferma il loop quando il costo accumulato supera il tuo budget. Controllato **tra uno step e l'altro** (il costo di uno step si conosce solo quando finisce), quindi può sforare di uno step. Su Claude il costo è esatto; su Codex e Gemini è una stima. Lascialo vuoto per nessun tetto. |
+| **Max cost ($)** | *Opzionale.* Claude riporta il costo; Codex/Gemini usano stime. Kimi non riporta costo USD autorevole. |
 
 ## Costruire con sicurezza
 

package/docs/guide/it/specs/2-add-spec-quick-mode.md

@@ -2,6 +2,10 @@
 
 La modalità Quick è pensata per quando sai già cosa vuoi. Scrivi la tua idea, l'AI redige la spec completa e questa atterra sulla tua board come **Da fare**. Niente botta e risposta — basta descriverla e partire.
 
+> **Kimi non è disponibile per Quick Spec.** `kimi -p` non può imporre il
+> confine pure-output del form. La richiesta è rifiutata prima dello spawn;
+> usa Explore, Raw o Quick Launcher (`/opsx:ff`).
+
 ## Creare una spec in modalità Quick
 
 Per creare rapidamente una spec:
@@ -19,7 +23,8 @@ Questo è tutto il flusso. Tutto ciò che segue è una rifinitura facoltativa.
 
 **Modello** — per impostazione predefinita l'AI sceglie un modello sensato. Puoi sovrascriverlo per ogni spec dal selettore di modello, se ne vuoi uno più veloce o più capace.
 
-**Engine** — se il tuo progetto ha installato più di un provider AI (una qualsiasi combinazione di Claude, Codex e Gemini), un selettore di engine si trova in cima al dialog, così puoi scegliere quale generi questa spec. La tua scelta viene ricordata per ogni progetto. I progetti con un solo provider non lo mostrano — non c'è nulla tra cui scegliere.
+**Engine** — il selettore mostra solo provider **compatibili**; Kimi è escluso
+da Quick Spec.
 
 **Contesto** — la modalità Quick di solito viene eseguita come un singolo turno, perché non ha bisogno di leggere il tuo codebase per scrivere una spec a partire dalla tua descrizione. Ma uno slider di contesto ti permette di darle più materiale su cui lavorare:
 

package/docs/guide/ja/agents/2-profiles-and-the-balanced-default.md

@@ -37,7 +37,12 @@
 
 ## Agents セクションが静かなとき
 
-プロファイルは Claude の機能です。Claude 以外のプロバイダー（Codex または Gemini）を含むプロジェクトでは、Agents セクションは非表示になり、レールはプロファイルなしで実行されます —— これはバグではなく想定どおりの動作です。プロファイルにはまた、プロジェクトに十分新しい `specrails-core` も必要です。古い場合は黄色のバナーが表示されます。作成したプロファイルは引き続き **保存** されます —— ただし core が更新されるまではパイプラインに影響しません。バナーに表示されたコマンドで更新すると、それらが有効になります。
+Profile は provider ごとに分離されます。Claude と Kimi は profile/
+role に対応し、Codex と Gemini は legacy mode で実行します。混在する
+project でも同じ名前が Claude/Kimi 間で交差することはありません。
+Kimi は手動 role に対応しますが、Agent Studio の generation、smoke
+test、AI Refine は spawn 前に拒否されます。Kimi には
+`specrails-core` 4.12.0 以降が必要です。
 
 ## 次に読むなら
 

package/docs/guide/ja/agents/4-custom-agents-catalog.md

@@ -11,21 +11,24 @@
 
 ## カスタムエージェントを追加する
 
-カスタムエージェントは、リポジトリの `.claude/agents/` 配下にある、`custom-<something>.md` という名前のただの Markdown ファイルです。そのファイルには、エージェントの指示内容（そのシステムプロンプト）と、デフォルトの `model:` を含む小さなフロントマターヘッダーが入っています。
+Role は provider-native asset です。Claude は
+`.claude/agents/custom-<name>.md`、Kimi は
+`.kimi-code/skills/custom-<name>/SKILL.md` を使います。
 
-ファイルがプロジェクトに存在すると、カタログにカスタムエージェントとして現れ、その id を任意のプロファイルのエージェントチェーンに追加できる（そしてそこへタスクをルーティングできる）ようになります。id はファイル名と一致している必要があります —— `custom-docs` という項目は `.claude/agents/custom-docs.md` に対応します。
+Asset が存在すると、その provider の Catalog に現れ、同じ provider の Profile に id を追加できます。`custom-docs` は Claude では `.claude/agents/custom-docs.md`、Kimi では `.kimi-code/skills/custom-docs/SKILL.md` に対応し、両者は独立しています。
 
 カスタムエージェントはリポジトリの中に住んでいるので、**コミット可能なチームの資産** です: ファイルをコミットすれば、チーム全員がそのエージェントを手に入れます。これは Agents セクション全体を貫く中心的な考え方を映したものです ——
 
 > **エージェントの定義は共有されます（リポジトリの中に住み、`git` とともに移動します）。モデルの設定はプロジェクトごとです（プロファイルの中に住みます）。**
 
-`custom-*` の名前空間は予約され、保護されています: `specrails-core` の `init` コマンドと `update` コマンドは `.claude/agents/custom-*.md` に決して触れないので、あなたのカスタムエージェントは core のアップグレードを無傷で生き延びます。（同じ保護は、`custom-serena.md` のようなプラグイン提供のフラグメントにも及びます。）
+Core は両形式を保護します。Kimi は manual create/edit/run に対応しますが、
+Generate、Test、AI Refine は spawn 前に拒否されます。
 
 ## カスタムエージェントを実際に使う
 
 典型的な流れは次のとおりです。
 
-1. 指示内容とデフォルトモデルを記した `.claude/agents/custom-<name>.md` を書く。
+1. native Claude asset または Kimi Skill を valid な指示/model で作成する。
 2. それが **Agents → Catalog** の Custom に現れることを確認する。
 3. **Agents → Profiles** で、そのエージェントをプロファイルのチェーンに追加する（必要なら、そのプロファイル用にモデルを上書きする）。
 4. 適切なタグの付いたタスクがそのエージェントに届くようにルーティングルールを追加する —— あるいはチェーンの順序に任せる。

package/docs/guide/ja/getting-started/1-what-is-specrails.md

@@ -36,6 +36,7 @@ specrails は、主要な AI コーディング CLI に対応しています。
 - **Claude**（Claude Code）
 - **Codex**（Codex CLI）
 - **Gemini**（Gemini CLI）
+- **Kimi**（Kimi Code）
 
 すでに使っているものを選んでも、複数インストールしてタスクごとに使い分けてもかまいません。プロジェクトは単一のプロバイダーでも、複数同時でも動かせるので、特定のツールに縛られることはありません。
 

package/docs/guide/ja/getting-started/2-installing-and-first-run.md

@@ -23,6 +23,7 @@ specrails が同梱できない唯一のものが、**AI プロバイダーの C
 - **Claude Code**
 - **Codex CLI**
 - **Gemini CLI**
+- **Kimi Code**
 
 使う予定のものをインストールし、ターミナルから一度サインインしておけば準備完了です。どのプロバイダーが入っているかは specrails が自動で検出します。
 

package/docs/guide/ja/getting-started/4-the-dashboard-tour.md

@@ -26,13 +26,13 @@
 
 - **ダッシュボード** — スペックボードとレール（さきほどまでいた場所）です。
 - **ジョブ** — このプロジェクトのすべてのパイプライン実行を、過去・現在を問わず一覧表示します。ステータス・所要時間が分かり、任意の実行の詳細やログを掘り下げられます。
-- **分析** — AI の利用にかかっているコストです。日別・アクティビティ別・モデル別・チケット別に内訳が出るので、想定外の出費はありません。
-- **エージェント** — プロジェクトのエージェントプロファイルです。どのエージェントがパイプラインで動き、どの AI モデルを使うかを管理します。*（Claude で動くプロジェクトのみ。）*
-- **コード** — 平易な言葉による AI のサマリー付きの読み取り専用ファイルブラウザで、AI が触れたファイルを示すチップが表示されます。流れを追いたい非開発者の方にも最適です。
+- **分析** — 日別・アクティビティ別・モデル別・チケット別の呼び出しです。Claude は請求コスト、Codex/Gemini は推定値を表示し、Kimi は取得できない token/USD 欄を空のままにします。
+- **エージェント** — Claude と Kimi の provider ごとに独立した Profile と Role カタログです。Kimi Role は手動で作成・編集できますが、Generate、Test、AI Refine は利用できません。
+- **コード** — 読み取り専用ファイルブラウザと、AI が触れたファイルを示すチップです。平易な AI サマリーは対応 provider でのみ表示され、Kimi では利用できません。
 - **インテグレーション** — 任意のアドオンです。スペックを **Jira** ボードに接続したり、AI 向けの追加ツールを有効にしたりできます。
 - **設定** — プロジェクトごとのオプション（テレメトリ、予算、プロバイダー設定など）です。
 
-> 一部のセクションは、選んだプロバイダーにとって意味があるときだけ表示されます。たとえば **エージェント** は Claude 専用です。あるセクションが見当たらない場合は、単にこのプロジェクトの構成には当てはまらないだけです。
+> セクションとアクションは有効な provider の capability に従います。たとえば Profile は Claude/Kimi で使えますが、Kimi では Agent Studio の AI アクションが fail closed になります。
 
 ## ステータスバー