@dynamicworks/br-openspec 2.0.0 → 2.1.0

package/README.md

@@ -97,7 +97,7 @@ openspec init
 
 Now tell your AI: `/opsx:propose <what-you-want-to-build>`
 
-If you want the expanded workflow (`/opsx:new`, `/opsx:continue`, `/opsx:ff`, `/opsx:verify`, `/opsx:sync`, `/opsx:bulk-archive`, `/opsx:onboard`), select it with `openspec config profile` and apply with `openspec update`.
+If you want the expanded workflow (`/opsx:new`, `/opsx:continue`, `/opsx:ff`, `/opsx:verify`, `/opsx:bulk-archive`, `/opsx:onboard`), select it with `openspec config profile` and apply with `openspec update`.
 
 > [!NOTE]
 > Not sure if your tool is supported? [View the full list](docs/supported-tools.md) – we support 25+ tools and growing.
@@ -116,6 +116,13 @@ If you want the expanded workflow (`/opsx:new`, `/opsx:continue`, `/opsx:ff`, `/
 → **[Customization](docs/customization.md)**: make it yours
 
 
+## Community schemas
+
+Third-party schema bundles distributed via standalone repositories — these provide opinionated workflows that integrate BR-OpenSpec with other tools, similar to how [github/spec-kit's community extension catalog](https://github.com/github/spec-kit/tree/main/extensions) handles tool integrations.
+
+→ **[Browse the catalog](docs/customization.md#community-schemas)** in the customization docs.
+
+
 ## Why BR-OpenSpec?
 
 AI coding assistants are powerful but unpredictable when requirements live only in chat history. BR-OpenSpec adds a lightweight spec layer so you agree on what to build before any code is written.
@@ -161,10 +168,12 @@ openspec tools --remove windsurf
 
 ## Usage Notes
 
-**Model selection**: BR-OpenSpec works best with high-reasoning models. We recommend Opus 4.5 and GPT 5.2 for both planning and implementation.
+**Model selection**: BR-OpenSpec works best with high-reasoning models. We recommend Codex 5.5 and Opus 4.8 for both planning and implementation.
 
 **Context hygiene**: BR-OpenSpec benefits from a clean context window. Clear your context before starting implementation and maintain good context hygiene throughout your session.
 
+**Spec keywords stay in English**: BR-OpenSpec is PT-BR first, but the spec format is a protocol read by the tooling. Structural markers (`## ADDED Requirements`, `### Requirement:`, `#### Scenario:`) and normative/scenario keywords (RFC 2119 — `MUST`, `SHALL`, `SHOULD`, `MAY`, … — plus `WHEN`, `THEN`, `AND`, `GIVEN`, `ELSE`) are always written in English and UPPERCASE; only the descriptive text is in Portuguese. Translating these keywords breaks `openspec validate`. See the full list in [AGENTS.md](AGENTS.md#reserved-english-terms-never-translate).
+
 ## Contributing
 
 **Small fixes** — Bug fixes, typo corrections, and minor improvements can be submitted directly as PRs.

package/README.pt-BR.md

@@ -97,7 +97,7 @@ openspec init
 
 Agora diga à sua IA: `/opsx:propose <o-que-você-quer-construir>`
 
-Se você quiser o fluxo de trabalho expandido (`/opsx:new`, `/opsx:continue`, `/opsx:ff`, `/opsx:verify`, `/opsx:sync`, `/opsx:bulk-archive`, `/opsx:onboard`), selecione-o com `openspec config profile` e aplique com `openspec update`.
+Se você quiser o fluxo de trabalho expandido (`/opsx:new`, `/opsx:continue`, `/opsx:ff`, `/opsx:verify`, `/opsx:bulk-archive`, `/opsx:onboard`), selecione-o com `openspec config profile` e aplique com `openspec update`.
 
 > [!NOTE]
 > Não tem certeza se sua ferramenta é suportada? [Veja a lista completa](docs/pt-BR/supported-tools.md) – suportamos mais de 25 ferramentas e crescendo.
@@ -116,6 +116,13 @@ Se você quiser o fluxo de trabalho expandido (`/opsx:new`, `/opsx:continue`, `/
 → **[Personalização](docs/pt-BR/customization.md)**: faça do seu jeito
 
 
+## Schemas da comunidade
+
+Bundles de schema de terceiros distribuídos em repositórios independentes — oferecem fluxos de trabalho opinativos que integram o BR-OpenSpec a outras ferramentas, de forma semelhante a como o [catálogo de extensões da comunidade do github/spec-kit](https://github.com/github/spec-kit/tree/main/extensions) trata integrações de ferramentas.
+
+→ **[Veja o catálogo](docs/pt-BR/customization.md#schemas-da-comunidade)** na documentação de personalização.
+
+
 ## Por que o BR-OpenSpec?
 
 Assistentes de codificação com IA são poderosos, mas imprevisíveis quando os requisitos vivem apenas no histórico do chat. O BR-OpenSpec adiciona uma camada leve de especificação para que você concorde sobre o que construir antes de qualquer código ser escrito.
@@ -163,10 +170,12 @@ openspec tools --remove windsurf
 
 ## Notas de Uso
 
-**Seleção de modelo**: O BR-OpenSpec funciona melhor com modelos de alto raciocínio. Recomendamos Opus 4.5 e GPT 5.2 tanto para planejamento quanto para implementação.
+**Seleção de modelo**: O BR-OpenSpec funciona melhor com modelos de alto raciocínio. Recomendamos Codex 5.5 e Opus 4.8 tanto para planejamento quanto para implementação.
 
 **Higiene de contexto**: O BR-OpenSpec se beneficia de uma janela de contexto limpa. Limpe seu contexto antes de iniciar a implementação e mantenha uma boa higiene de contexto ao longo da sua sessão.
 
+**Palavras-chave do formato de spec ficam em inglês**: O BR-OpenSpec é PT-BR first, mas o formato de spec é um protocolo lido pelas ferramentas. Os marcadores estruturais (`## ADDED Requirements`, `### Requirement:`, `#### Scenario:`) e as palavras-chave normativas/de cenário (RFC 2119 — `MUST`, `SHALL`, `SHOULD`, `MAY`, … — além de `WHEN`, `THEN`, `AND`, `GIVEN`, `ELSE`) são sempre escritas em inglês e em CAIXA ALTA; apenas o texto descritivo fica em português. Traduzir essas palavras-chave quebra o `openspec validate`. Veja a lista completa em [AGENTS.md](AGENTS.md#reserved-english-terms-never-translate).
+
 ## Contribuindo
 
 **Pequenas correções** — Correções de bugs, erros de digitação e melhorias menores podem ser enviadas diretamente como PRs.

package/dist/commands/config.js

@@ -48,6 +48,10 @@ const WORKFLOW_PROMPT_META = {
         name: CONFIG_MESSAGES.workflowVerifyName,
         description: CONFIG_MESSAGES.workflowVerifyDesc,
     },
+    'code-review': {
+        name: CONFIG_MESSAGES.workflowCodeReviewName,
+        description: CONFIG_MESSAGES.workflowCodeReviewDesc,
+    },
     onboard: {
         name: CONFIG_MESSAGES.workflowOnboardName,
         description: CONFIG_MESSAGES.workflowOnboardDesc,

package/dist/commands/schema.js

@@ -797,72 +797,72 @@ function createDefaultTemplate(artifactId) {
         case 'proposal':
             return `## Why
 
-<!-- Describe the motivation for this change -->
+<!-- Descreva a motivação para esta mudança -->
 
 ## What Changes
 
-<!-- Describe what will change -->
+<!-- Descreva o que vai mudar -->
 
 ## Capabilities
 
 ### New Capabilities
-<!-- List new capabilities -->
+<!-- Liste as novas capabilities -->
 
 ### Modified Capabilities
-<!-- List modified capabilities -->
+<!-- Liste as capabilities modificadas -->
 
 ## Impact
 
-<!-- Describe the impact on existing functionality -->
+<!-- Descreva o impacto sobre a funcionalidade existente -->
 `;
         case 'specs':
             return `## ADDED Requirements
 
-### Requirement: Example requirement
+### Requirement: Requisito de exemplo
 
-Description of the requirement.
+Descrição do requisito.
 
-#### Scenario: Example scenario
-- **WHEN** some condition
-- **THEN** some outcome
+#### Scenario: Cenário de exemplo
+- **WHEN** alguma condição
+- **THEN** algum resultado
 `;
         case 'design':
             return `## Context
 
-<!-- Background and context -->
+<!-- Contexto e antecedentes -->
 
 ## Goals / Non-Goals
 
 **Goals:**
-<!-- List goals -->
+<!-- Liste os objetivos -->
 
 **Non-Goals:**
-<!-- List non-goals -->
+<!-- Liste os não-objetivos -->
 
 ## Decisions
 
-### 1. Decision Name
+### 1. Nome da Decisão
 
-Description and rationale.
+Descrição e justificativa.
 
 **Alternatives considered:**
-- Alternative 1: Rejected because...
+- Alternativa 1: Rejeitada porque...
 
 ## Risks / Trade-offs
 
-<!-- List risks and trade-offs -->
+<!-- Liste os riscos e trade-offs -->
 `;
         case 'tasks':
             return `## Implementation Tasks
 
-- [ ] Task 1
-- [ ] Task 2
-- [ ] Task 3
+- [ ] Tarefa 1
+- [ ] Tarefa 2
+- [ ] Tarefa 3
 `;
         default:
             return `## ${artifactId}
 
-<!-- Add content here -->
+<!-- Adicione o conteúdo aqui -->
 `;
     }
 }

package/dist/core/artifact-graph/instruction-loader.js

@@ -4,7 +4,7 @@ import { getSchemaDir, resolveSchema } from './resolver.js';
 import { ArtifactGraph } from './graph.js';
 import { detectCompleted } from './state.js';
 import { resolveSchemaForChange } from '../../utils/change-metadata.js';
-import { WORKFLOW_MESSAGES } from '../../messages/index.js';
+import { WORKFLOW_MESSAGES, ARTIFACT_GRAPH_MESSAGES } from '../../messages/index.js';
 import { FileSystemUtils } from '../../utils/file-system.js';
 import { readProjectConfig, validateConfigRules } from '../project-config.js';
 // Session-level cache for validation warnings (avoid repeating same warnings)
@@ -36,7 +36,7 @@ export function loadTemplate(schemaName, templatePath, projectRoot) {
     }
     const templatePathOnDisk = path.join(schemaDir, 'templates', templatePath);
     if (!fs.existsSync(templatePathOnDisk)) {
-        throw new TemplateLoadError(`Template not found: ${templatePathOnDisk}`, templatePathOnDisk);
+        throw new TemplateLoadError(ARTIFACT_GRAPH_MESSAGES.templateNotFound(templatePathOnDisk), templatePathOnDisk);
     }
     const fullPath = FileSystemUtils.canonicalizeExistingPath(templatePathOnDisk);
     try {
@@ -44,7 +44,7 @@ export function loadTemplate(schemaName, templatePath, projectRoot) {
     }
     catch (err) {
         const ioError = err instanceof Error ? err : new Error(String(err));
-        throw new TemplateLoadError(`Failed to read template: ${ioError.message}`, fullPath);
+        throw new TemplateLoadError(ARTIFACT_GRAPH_MESSAGES.failedToReadTemplate(ioError.message), fullPath);
     }
 }
 /**
@@ -93,7 +93,7 @@ export function loadChangeContext(projectRoot, changeName, schemaName) {
 export function generateInstructions(context, artifactId, projectRoot) {
     const artifact = context.graph.getArtifact(artifactId);
     if (!artifact) {
-        throw new Error(`Artifact '${artifactId}' not found in schema '${context.schemaName}'`);
+        throw new Error(ARTIFACT_GRAPH_MESSAGES.artifactNotFound(artifactId, context.schemaName));
     }
     const templateContent = loadTemplate(context.schemaName, artifact.template, context.projectRoot);
     const dependencies = getDependencyInfo(artifact, context.graph, context.completed);

package/dist/core/artifact-graph/schema.js

@@ -1,6 +1,7 @@
 import * as fs from 'node:fs';
 import { parse as parseYaml } from 'yaml';
 import { SchemaYamlSchema } from './types.js';
+import { ARTIFACT_GRAPH_MESSAGES } from '../../messages/index.js';
 export class SchemaValidationError extends Error {
     constructor(message) {
         super(message);
@@ -23,7 +24,7 @@ export function parseSchema(yamlContent) {
     const result = SchemaYamlSchema.safeParse(parsed);
     if (!result.success) {
         const errors = result.error.issues.map(e => `${e.path.join('.')}: ${e.message}`).join(', ');
-        throw new SchemaValidationError(`Invalid schema: ${errors}`);
+        throw new SchemaValidationError(ARTIFACT_GRAPH_MESSAGES.invalidSchema(errors));
     }
     const schema = result.data;
     // Check for duplicate artifact IDs
@@ -41,7 +42,7 @@ function validateNoDuplicateIds(artifacts) {
     const seen = new Set();
     for (const artifact of artifacts) {
         if (seen.has(artifact.id)) {
-            throw new SchemaValidationError(`Duplicate artifact ID: ${artifact.id}`);
+            throw new SchemaValidationError(ARTIFACT_GRAPH_MESSAGES.duplicateArtifactId(artifact.id));
         }
         seen.add(artifact.id);
     }
@@ -54,7 +55,7 @@ function validateRequiresReferences(artifacts) {
     for (const artifact of artifacts) {
         for (const req of artifact.requires) {
             if (!validIds.has(req)) {
-                throw new SchemaValidationError(`Invalid dependency reference in artifact '${artifact.id}': '${req}' does not exist`);
+                throw new SchemaValidationError(ARTIFACT_GRAPH_MESSAGES.invalidDependencyReference(artifact.id, req));
             }
         }
     }
@@ -100,7 +101,7 @@ function validateNoCycles(artifacts) {
         if (!visited.has(artifact.id)) {
             const cycle = dfs(artifact.id);
             if (cycle) {
-                throw new SchemaValidationError(`Cyclic dependency detected: ${cycle}`);
+                throw new SchemaValidationError(ARTIFACT_GRAPH_MESSAGES.cyclicDependency(cycle));
             }
         }
     }

package/dist/core/completions/factory.js

@@ -6,6 +6,7 @@ import { ZshInstaller } from './installers/zsh-installer.js';
 import { BashInstaller } from './installers/bash-installer.js';
 import { FishInstaller } from './installers/fish-installer.js';
 import { PowerShellInstaller } from './installers/powershell-installer.js';
+import { COMPLETIONS_FACTORY_MESSAGES } from '../../messages/index.js';
 /**
  * Factory for creating completion generators and installers
  * This design makes it easy to add support for additional shells
@@ -30,7 +31,7 @@ export class CompletionFactory {
             case 'powershell':
                 return new PowerShellGenerator();
             default:
-                throw new Error(`Unsupported shell: ${shell}`);
+                throw new Error(COMPLETIONS_FACTORY_MESSAGES.unsupportedShell(shell));
         }
     }
     /**
@@ -51,7 +52,7 @@ export class CompletionFactory {
             case 'powershell':
                 return new PowerShellInstaller();
             default:
-                throw new Error(`Unsupported shell: ${shell}`);
+                throw new Error(COMPLETIONS_FACTORY_MESSAGES.unsupportedShell(shell));
         }
     }
     /**

package/dist/core/completions/installers/fish-installer.js

@@ -1,6 +1,7 @@
 import { promises as fs } from 'fs';
 import path from 'path';
 import os from 'os';
+import { COMPLETION_MESSAGES } from '../../../messages/index.js';
 /**
  * Installer for Fish completion scripts.
  * Fish automatically loads completions from ~/.config/fish/completions/
@@ -56,10 +57,10 @@ export class FishInstaller {
                     return {
                         success: true,
                         installedPath: targetPath,
-                        message: 'Completion script is already installed (up to date)',
+                        message: COMPLETION_MESSAGES.fishAlreadyInstalled,
                         instructions: [
-                            'The completion script is already installed and up to date.',
-                            'Fish automatically loads completions - they should be available immediately.',
+                            COMPLETION_MESSAGES.fishAlreadyInstalledDetail,
+                            COMPLETION_MESSAGES.fishAutoLoadsHint,
                         ],
                     };
                 }
@@ -81,11 +82,11 @@ export class FishInstaller {
             let message;
             if (isUpdate) {
                 message = backupPath
-                    ? 'Completion script updated successfully (previous version backed up)'
-                    : 'Completion script updated successfully';
+                    ? COMPLETION_MESSAGES.fishUpdatedWithBackup
+                    : COMPLETION_MESSAGES.fishUpdated;
             }
             else {
-                message = 'Completion script installed successfully for Fish';
+                message = COMPLETION_MESSAGES.fishInstalled;
             }
             return {
                 success: true,
@@ -93,15 +94,15 @@ export class FishInstaller {
                 backupPath,
                 message,
                 instructions: [
-                    'Fish automatically loads completions from ~/.config/fish/completions/',
-                    'Completions are available immediately - no shell restart needed.',
+                    COMPLETION_MESSAGES.fishAutoLoadsDir,
+                    COMPLETION_MESSAGES.fishAvailableImmediately,
                 ],
             };
         }
         catch (error) {
             return {
                 success: false,
-                message: `Failed to install completion script: ${error instanceof Error ? error.message : String(error)}`,
+                message: COMPLETION_MESSAGES.fishFailedToInstall(error instanceof Error ? error.message : String(error)),
             };
         }
     }
@@ -122,20 +123,20 @@ export class FishInstaller {
             catch {
                 return {
                     success: false,
-                    message: 'Completion script is not installed',
+                    message: COMPLETION_MESSAGES.fishNotInstalled,
                 };
             }
             // Remove the completion script
             await fs.unlink(targetPath);
             return {
                 success: true,
-                message: 'Completion script uninstalled successfully',
+                message: COMPLETION_MESSAGES.fishUninstalled,
             };
         }
         catch (error) {
             return {
                 success: false,
-                message: `Failed to uninstall completion script: ${error instanceof Error ? error.message : String(error)}`,
+                message: COMPLETION_MESSAGES.fishFailedToUninstall(error instanceof Error ? error.message : String(error)),
             };
         }
     }

package/dist/core/completions/installers/powershell-installer.js

@@ -29,8 +29,7 @@ export class PowerShellInstaller {
         }
         // UTF-16 BE BOM: FE FF — not natively supported by Node
         if (buffer.length >= 2 && buffer[0] === 0xfe && buffer[1] === 0xff) {
-            throw new Error('File is encoded as UTF-16 BE which is not supported. ' +
-                'Please re-save as UTF-8 or UTF-16 LE, then retry.');
+            throw new Error(COMPLETION_MESSAGES.powershellUtf16BEUnsupported);
         }
         // UTF-8 BOM: EF BB BF
         if (buffer.length >= 3 && buffer[0] === 0xef && buffer[1] === 0xbb && buffer[2] === 0xbf) {
@@ -274,10 +273,10 @@ export class PowerShellInstaller {
                     return {
                         success: true,
                         installedPath: targetPath,
-                        message: 'Completion script is already installed (up to date)',
+                        message: COMPLETION_MESSAGES.powershellAlreadyInstalled,
                         instructions: [
-                            'The completion script is already installed and up to date.',
-                            'If completions are not working, try restarting PowerShell or run: . $PROFILE',
+                            COMPLETION_MESSAGES.powershellAlreadyInstalledDetail,
+                            COMPLETION_MESSAGES.powershellAlreadyInstalledHint,
                         ],
                     };
                 }
@@ -315,13 +314,13 @@ export class PowerShellInstaller {
             let message;
             if (isUpdate) {
                 message = backupPath
-                    ? 'Completion script updated successfully (previous version backed up)'
-                    : 'Completion script updated successfully';
+                    ? COMPLETION_MESSAGES.powershellUpdatedWithBackup
+                    : COMPLETION_MESSAGES.powershellUpdated;
             }
             else {
                 message = profileConfigured
-                    ? 'Completion script installed and PowerShell profile configured successfully'
-                    : 'Completion script installed successfully for PowerShell';
+                    ? COMPLETION_MESSAGES.powershellInstalledWithProfile
+                    : COMPLETION_MESSAGES.powershellInstalled;
             }
             return {
                 success: true,
@@ -335,7 +334,7 @@ export class PowerShellInstaller {
         catch (error) {
             return {
                 success: false,
-                message: `Failed to install completion script: ${error instanceof Error ? error.message : String(error)}`,
+                message: COMPLETION_MESSAGES.powershellFailedToInstall(error instanceof Error ? error.message : String(error)),
             };
         }
     }
@@ -348,16 +347,16 @@ export class PowerShellInstaller {
     generateInstructions(installedPath) {
         const profilePath = this.getProfilePath();
         return [
-            'Completion script installed successfully.',
+            COMPLETION_MESSAGES.powershellScriptInstalled,
             '',
-            `To enable completions, add the following to your PowerShell profile (${profilePath}):`,
+            COMPLETION_MESSAGES.powershellEnableCompletions(profilePath),
             '',
-            '  # Source BR-OpenSpec completions',
+            `  ${COMPLETION_MESSAGES.powershellSourceComment}`,
             `  if (Test-Path "${installedPath}") {`,
             `      . "${installedPath}"`,
             '  }',
             '',
-            'Then restart PowerShell or run: . $PROFILE',
+            COMPLETION_MESSAGES.powershellThenRestart,
         ];
     }
     /**
@@ -377,7 +376,7 @@ export class PowerShellInstaller {
             catch {
                 return {
                     success: false,
-                    message: 'Completion script is not installed',
+                    message: COMPLETION_MESSAGES.powershellNotInstalled,
                 };
             }
             // Remove the completion script
@@ -386,13 +385,13 @@ export class PowerShellInstaller {
             await this.removeProfileConfig();
             return {
                 success: true,
-                message: 'Completion script uninstalled successfully',
+                message: COMPLETION_MESSAGES.powershellUninstalled,
             };
         }
         catch (error) {
             return {
                 success: false,
-                message: `Failed to uninstall completion script: ${error instanceof Error ? error.message : String(error)}`,
+                message: COMPLETION_MESSAGES.powershellFailedToUninstall(error instanceof Error ? error.message : String(error)),
             };
         }
     }

package/dist/core/completions/installers/zsh-installer.d.ts

@@ -59,14 +59,6 @@ export declare class ZshInstaller {
      * @returns true if .zshrc exists and has markers
      */
     private hasZshrcConfig;
-    /**
-     * Check if fpath configuration is needed for a given directory
-     * Used to verify if Oh My Zsh (or other) completions directory is already in fpath
-     *
-     * @param completionsDir - Directory to check for in fpath
-     * @returns true if configuration is needed, false if directory is already referenced
-     */
-    private needsFpathConfig;
     /**
      * Remove .zshrc configuration
      * Used during uninstallation

package/dist/core/completions/installers/zsh-installer.js

@@ -148,26 +148,6 @@ export class ZshInstaller {
             return false;
         }
     }
-    /**
-     * Check if fpath configuration is needed for a given directory
-     * Used to verify if Oh My Zsh (or other) completions directory is already in fpath
-     *
-     * @param completionsDir - Directory to check for in fpath
-     * @returns true if configuration is needed, false if directory is already referenced
-     */
-    async needsFpathConfig(completionsDir) {
-        try {
-            const zshrcPath = this.getZshrcPath();
-            const content = await fs.readFile(zshrcPath, 'utf-8');
-            // Check if fpath already includes this directory
-            return !content.includes(completionsDir);
-        }
-        catch (error) {
-            // If we can't read .zshrc, assume config is needed
-            console.debug(`Unable to read .zshrc to check fpath config: ${error instanceof Error ? error.message : String(error)}`);
-            return true;
-        }
-    }
     /**
      * Remove .zshrc configuration
      * Used during uninstallation
@@ -256,18 +236,10 @@ export class ZshInstaller {
             const backupPath = isUpdate ? await this.backupExistingFile(targetPath) : undefined;
             // Write the completion script
             await fs.writeFile(targetPath, completionScript, 'utf-8');
-            // Auto-configure .zshrc
+            // Auto-configure .zshrc for standard Zsh only.
+            // Oh My Zsh loads custom/completions and runs compinit itself.
             let zshrcConfigured = false;
-            if (isOhMyZsh) {
-                // For Oh My Zsh, verify that custom/completions is in fpath
-                // If not, add it to .zshrc
-                const needsConfig = await this.needsFpathConfig(targetDir);
-                if (needsConfig) {
-                    zshrcConfigured = await this.configureZshrc(targetDir);
-                }
-            }
-            else {
-                // Standard Zsh always needs .zshrc configuration
+            if (!isOhMyZsh) {
                 zshrcConfigured = await this.configureZshrc(targetDir);
             }
             // Generate instructions (only if .zshrc wasn't auto-configured)
@@ -392,7 +364,7 @@ export class ZshInstaller {
             if (!scriptRemoved && !zshrcWasPresent) {
                 return {
                     success: false,
-                    message: 'Completion script is not installed',
+                    message: COMPLETION_MESSAGES.zshNotInstalled,
                 };
             }
             const messages = [];

package/dist/core/config.js

@@ -23,12 +23,13 @@ export const AI_TOOLS = [
     { name: 'iFlow', value: 'iflow', available: true, successLabel: 'iFlow', skillsDir: '.iflow' },
     { name: 'Junie', value: 'junie', available: true, successLabel: 'Junie', skillsDir: '.junie' },
     { name: 'Kilo Code', value: 'kilocode', available: true, successLabel: 'Kilo Code', skillsDir: '.kilocode' },
-    { name: 'Kimi Code CLI', value: 'kimi', available: true, successLabel: 'Kimi Code CLI', skillsDir: '.kimi' },
+    { name: 'Kimi CLI', value: 'kimi', available: true, successLabel: 'Kimi CLI', skillsDir: '.kimi' },
     { name: 'Kiro', value: 'kiro', available: true, successLabel: 'Kiro', skillsDir: '.kiro' },
+    { name: 'Lingma', value: 'lingma', available: true, successLabel: 'Lingma', skillsDir: '.lingma' },
+    { name: 'Mistral Vibe', value: 'vibe', available: true, successLabel: 'Mistral Vibe', skillsDir: '.vibe' },
     { name: 'OpenCode', value: 'opencode', available: true, successLabel: 'OpenCode', skillsDir: '.opencode' },
     { name: 'Pi', value: 'pi', available: true, successLabel: 'Pi', skillsDir: '.pi' },
     { name: 'Qoder', value: 'qoder', available: true, successLabel: 'Qoder', skillsDir: '.qoder' },
-    { name: 'Lingma', value: 'lingma', available: true, successLabel: 'Lingma', skillsDir: '.lingma' },
     { name: 'Qwen Code', value: 'qwen', available: true, successLabel: 'Qwen Code', skillsDir: '.qwen' },
     { name: 'RooCode', value: 'roocode', available: true, successLabel: 'RooCode', skillsDir: '.roo' },
     { name: 'Trae', value: 'trae', available: true, successLabel: 'Trae', skillsDir: '.trae' },

package/dist/core/global-config.d.ts

@@ -25,7 +25,12 @@ export declare function getGlobalConfigDir(): string;
  * - Unix/macOS fallback: ~/.local/share/openspec/
  * - Windows fallback: %LOCALAPPDATA%/openspec/
  */
-export declare function getGlobalDataDir(): string;
+export interface GlobalDataDirOptions {
+    env?: NodeJS.ProcessEnv;
+    platform?: NodeJS.Platform;
+    homedir?: string;
+}
+export declare function getGlobalDataDir(options?: GlobalDataDirOptions): string;
 /**
  * Gets the path to the global config file.
  */

package/dist/core/global-config.js

@@ -36,32 +36,31 @@ export function getGlobalConfigDir() {
     // Unix/macOS fallback: ~/.config
     return path.join(os.homedir(), '.config', GLOBAL_CONFIG_DIR_NAME);
 }
-/**
- * Gets the global data directory path following XDG Base Directory Specification.
- * Used for user data like schema overrides.
- *
- * - All platforms: $XDG_DATA_HOME/openspec/ if XDG_DATA_HOME is set
- * - Unix/macOS fallback: ~/.local/share/openspec/
- * - Windows fallback: %LOCALAPPDATA%/openspec/
- */
-export function getGlobalDataDir() {
+function joinGlobalDataPath(platform, ...segments) {
+    return platform === 'win32'
+        ? path.win32.join(...segments)
+        : path.posix.join(...segments);
+}
+export function getGlobalDataDir(options = {}) {
+    const env = options.env ?? process.env;
+    const platform = options.platform ?? os.platform();
     // XDG_DATA_HOME takes precedence on all platforms when explicitly set
-    const xdgDataHome = process.env.XDG_DATA_HOME;
+    const xdgDataHome = env.XDG_DATA_HOME;
     if (xdgDataHome) {
-        return path.join(xdgDataHome, GLOBAL_DATA_DIR_NAME);
+        return joinGlobalDataPath(platform, xdgDataHome, GLOBAL_DATA_DIR_NAME);
     }
-    const platform = os.platform();
+    const homedir = options.homedir ?? os.homedir();
     if (platform === 'win32') {
         // Windows: use %LOCALAPPDATA%
-        const localAppData = process.env.LOCALAPPDATA;
+        const localAppData = env.LOCALAPPDATA;
         if (localAppData) {
-            return path.join(localAppData, GLOBAL_DATA_DIR_NAME);
+            return joinGlobalDataPath(platform, localAppData, GLOBAL_DATA_DIR_NAME);
         }
         // Fallback for Windows if LOCALAPPDATA is not set
-        return path.join(os.homedir(), 'AppData', 'Local', GLOBAL_DATA_DIR_NAME);
+        return joinGlobalDataPath(platform, homedir, 'AppData', 'Local', GLOBAL_DATA_DIR_NAME);
     }
     // Unix/macOS fallback: ~/.local/share
-    return path.join(os.homedir(), '.local', 'share', GLOBAL_DATA_DIR_NAME);
+    return joinGlobalDataPath(platform, homedir, '.local', 'share', GLOBAL_DATA_DIR_NAME);
 }
 /**
  * Gets the path to the global config file.