byterover-cli 1.8.0 → 2.0.0

package/dist/server/infra/connectors/mcp/json-mcp-config-writer.js

@@ -56,14 +56,15 @@ export class JsonMcpConfigWriter {
         return true;
     }
     async write(filePath, serverConfig) {
-        const fileExists = await this.fileService.exists(filePath);
-        let json;
-        if (fileExists) {
-            const content = await this.fileService.read(filePath);
-            json = parseJsonAsRecord(content);
-        }
-        else {
-            json = {};
+        let json = {};
+        if (await this.fileService.exists(filePath)) {
+            try {
+                const content = await this.fileService.read(filePath);
+                json = parseJsonAsRecord(content);
+            }
+            catch {
+                // File exists but contains invalid/empty JSON — start fresh
+            }
         }
         set(json, this.serverKeyPath, { ...serverConfig });
         await this.fileService.write(JSON.stringify(json, null, 2), filePath, 'overwrite');

package/dist/server/infra/connectors/mcp/mcp-connector-config.d.ts

@@ -1,8 +1,4 @@
-/**
- * MCP server configuration that gets injected into agent config files.
- * Uses Record to allow agent-specific fields (e.g., env, cwd, disabled).
- */
-export type McpServerConfig = Record<string, unknown>;
+import type { McpServerConfig } from '../../../core/interfaces/storage/i-mcp-config-writer.js';
 /**
  * Supported MCP config file formats.
  */
@@ -73,6 +69,22 @@ export declare const MCP_CONNECTOR_CONFIGS: {
         readonly serverConfig: McpServerConfig;
         readonly serverKeyPath: readonly ["amp.mcpServers", "brv"];
     };
+    readonly Antigravity: {
+        readonly configPath: ".gemini/antigravity/mcp_config.json";
+        readonly format: "json";
+        readonly mode: "auto";
+        readonly scope: "global";
+        readonly serverConfig: McpServerConfig;
+        readonly serverKeyPath: readonly ["mcpServers", "brv"];
+    };
+    readonly 'Auggie CLI': {
+        readonly format: "json";
+        readonly manualGuide: "https://docs.augmentcode.com/cli/integrations#configure-mcp-via-settings-json";
+        readonly mode: "manual";
+        readonly scope: "global";
+        readonly serverConfig: McpServerConfig;
+        readonly serverKeyPath: readonly ["mcpServers", "brv"];
+    };
     readonly 'Augment Code': {
         readonly format: "json";
         readonly manualGuide: "https://docs.augmentcode.com/setup-augment/mcp#import-from-json";
@@ -158,6 +170,17 @@ export declare const MCP_CONNECTOR_CONFIGS: {
         readonly serverConfig: McpServerConfig;
         readonly serverKeyPath: readonly ["mcpServers", "brv"];
     };
+    readonly OpenCode: {
+        readonly format: "json";
+        readonly manualGuide: "https://opencode.ai/docs/mcp-servers/#manage";
+        readonly mode: "manual";
+        readonly scope: "global";
+        readonly serverConfig: {
+            readonly type: "local";
+            readonly command: readonly ["brv", "mcp"];
+        };
+        readonly serverKeyPath: readonly ["mcp", "brv"];
+    };
     readonly Qoder: {
         readonly format: "json";
         readonly manualGuide: "https://docs.qoder.com/user-guide/chat/model-context-protocol#configure-mcp-servers";
@@ -167,7 +190,7 @@ export declare const MCP_CONNECTOR_CONFIGS: {
         readonly serverKeyPath: readonly ["mcpServers", "brv"];
     };
     readonly 'Qwen Code': {
-        readonly configPath: "https://qwenlm.github.io/qwen-code-docs/en/developers/tools/mcp-server/#configure-the-mcp-server-in-settingsjson";
+        readonly manualGuide: "https://qwenlm.github.io/qwen-code-docs/en/developers/tools/mcp-server/#configure-the-mcp-server-in-settingsjson";
         readonly format: "json";
         readonly mode: "manual";
         readonly scope: "global";

package/dist/server/infra/connectors/mcp/mcp-connector-config.js

@@ -23,6 +23,22 @@ export const MCP_CONNECTOR_CONFIGS = {
         serverConfig: DEFAULT_SERVER_CONFIG,
         serverKeyPath: ['amp.mcpServers', 'brv'],
     },
+    Antigravity: {
+        configPath: '.gemini/antigravity/mcp_config.json',
+        format: 'json',
+        mode: 'auto',
+        scope: 'global',
+        serverConfig: DEFAULT_SERVER_CONFIG,
+        serverKeyPath: STANDARD_KEY_PATH,
+    },
+    'Auggie CLI': {
+        format: 'json',
+        manualGuide: 'https://docs.augmentcode.com/cli/integrations#configure-mcp-via-settings-json',
+        mode: 'manual',
+        scope: 'global',
+        serverConfig: DEFAULT_SERVER_CONFIG,
+        serverKeyPath: STANDARD_KEY_PATH,
+    },
     'Augment Code': {
         format: 'json',
         manualGuide: 'https://docs.augmentcode.com/setup-augment/mcp#import-from-json',
@@ -108,6 +124,17 @@ export const MCP_CONNECTOR_CONFIGS = {
         serverConfig: DEFAULT_SERVER_CONFIG,
         serverKeyPath: STANDARD_KEY_PATH,
     },
+    OpenCode: {
+        format: 'json',
+        manualGuide: 'https://opencode.ai/docs/mcp-servers/#manage',
+        mode: 'manual',
+        scope: 'global',
+        serverConfig: {
+            type: 'local',
+            command: ['brv', 'mcp'],
+        },
+        serverKeyPath: ['mcp', 'brv'],
+    },
     Qoder: {
         format: 'json',
         manualGuide: 'https://docs.qoder.com/user-guide/chat/model-context-protocol#configure-mcp-servers',
@@ -117,7 +144,7 @@ export const MCP_CONNECTOR_CONFIGS = {
         serverKeyPath: STANDARD_KEY_PATH,
     },
     'Qwen Code': {
-        configPath: 'https://qwenlm.github.io/qwen-code-docs/en/developers/tools/mcp-server/#configure-the-mcp-server-in-settingsjson',
+        manualGuide: 'https://qwenlm.github.io/qwen-code-docs/en/developers/tools/mcp-server/#configure-the-mcp-server-in-settingsjson',
         format: 'json',
         mode: 'manual',
         scope: 'global',

package/dist/server/infra/connectors/mcp/mcp-connector.js

@@ -3,7 +3,7 @@ import os from 'node:os';
 import path from 'node:path';
 import { AGENT_CONNECTOR_CONFIG } from '../../../core/domain/entities/agent.js';
 import { RULES_CONNECTOR_CONFIGS } from '../rules/rules-connector-config.js';
-import { BRV_RULE_MARKERS } from '../shared/constants.js';
+import { BRV_RULE_MARKERS, hasMcpToolsInBrvSection } from '../shared/constants.js';
 import { RuleFileManager } from '../shared/rule-file-manager.js';
 import { JsonMcpConfigWriter } from './json-mcp-config-writer.js';
 import { MCP_CONNECTOR_CONFIGS } from './mcp-connector-config.js';
@@ -265,7 +265,7 @@ export class McpConnector {
      * Install the rule file with MCP-specific content.
      */
     async installRuleFile(agent) {
-        const rulesConfig = RULES_CONNECTOR_CONFIGS[agent];
+        const rulesConfig = agent in RULES_CONNECTOR_CONFIGS ? RULES_CONNECTOR_CONFIGS[agent] : undefined;
         if (!rulesConfig) {
             return;
         }
@@ -300,7 +300,7 @@ export class McpConnector {
      * Checks for markers AND MCP-specific tool references (brv-query, brv-curate).
      */
     async statusManual(agent) {
-        const rulesConfig = RULES_CONNECTOR_CONFIGS[agent];
+        const rulesConfig = agent in RULES_CONNECTOR_CONFIGS ? RULES_CONNECTOR_CONFIGS[agent] : undefined;
         if (!rulesConfig) {
             return {
                 configExists: false,
@@ -319,7 +319,7 @@ export class McpConnector {
         }
         const content = await this.fileService.read(fullPath);
         const hasMarkers = content.includes(BRV_RULE_MARKERS.START) && content.includes(BRV_RULE_MARKERS.END);
-        const hasMcpTools = content.includes('brv-query') || content.includes('brv-curate');
+        const hasMcpTools = hasMcpToolsInBrvSection(content);
         return {
             configExists: true,
             configPath: rulesConfig.filePath,
@@ -330,7 +330,7 @@ export class McpConnector {
      * Uninstall the rule file content.
      */
     async uninstallRuleFile(agent) {
-        const rulesConfig = RULES_CONNECTOR_CONFIGS[agent];
+        const rulesConfig = agent in RULES_CONNECTOR_CONFIGS ? RULES_CONNECTOR_CONFIGS[agent] : undefined;
         if (!rulesConfig) {
             return;
         }

package/dist/server/infra/connectors/mcp/toml-mcp-config-writer.d.ts

@@ -1,6 +1,5 @@
 import type { IFileService } from '../../../core/interfaces/services/i-file-service.js';
-import type { IMcpConfigWriter, McpConfigExistsResult } from '../../../core/interfaces/storage/i-mcp-config-writer.js';
-import type { McpServerConfig } from './mcp-connector-config.js';
+import type { IMcpConfigWriter, McpConfigExistsResult, McpServerConfig } from '../../../core/interfaces/storage/i-mcp-config-writer.js';
 /**
  * Boundary markers for managed ByteRover MCP sections in TOML files.
  */

package/dist/server/infra/connectors/rules/rules-connector-config.d.ts

@@ -24,6 +24,10 @@ export declare const RULES_CONNECTOR_CONFIGS: {
         readonly filePath: ".agent/rules/agent-context.md";
         readonly writeMode: "overwrite";
     };
+    readonly 'Auggie CLI': {
+        readonly filePath: ".augment/rules/agent-context.md";
+        readonly writeMode: "overwrite";
+    };
     readonly 'Augment Code': {
         readonly filePath: ".augment/rules/agent-context.md";
         readonly writeMode: "overwrite";
@@ -64,6 +68,10 @@ export declare const RULES_CONNECTOR_CONFIGS: {
         readonly filePath: ".kiro/steering/agent-context.md";
         readonly writeMode: "overwrite";
     };
+    readonly OpenCode: {
+        readonly filePath: "AGENTS.md";
+        readonly writeMode: "append";
+    };
     readonly Qoder: {
         readonly filePath: ".qoder/rules/agent-context.md";
         readonly writeMode: "overwrite";

package/dist/server/infra/connectors/rules/rules-connector-config.js

@@ -10,6 +10,10 @@ export const RULES_CONNECTOR_CONFIGS = {
         filePath: '.agent/rules/agent-context.md',
         writeMode: 'overwrite',
     },
+    'Auggie CLI': {
+        filePath: '.augment/rules/agent-context.md',
+        writeMode: 'overwrite',
+    },
     'Augment Code': {
         filePath: '.augment/rules/agent-context.md',
         writeMode: 'overwrite',
@@ -50,6 +54,10 @@ export const RULES_CONNECTOR_CONFIGS = {
         filePath: '.kiro/steering/agent-context.md',
         writeMode: 'overwrite',
     },
+    OpenCode: {
+        filePath: 'AGENTS.md',
+        writeMode: 'append',
+    },
     Qoder: {
         filePath: '.qoder/rules/agent-context.md',
         writeMode: 'overwrite',

package/dist/server/infra/connectors/rules/rules-connector.js

@@ -1,5 +1,6 @@
 import path from 'node:path';
 import { AGENT_CONNECTOR_CONFIG } from '../../../core/domain/entities/agent.js';
+import { hasMcpToolsInBrvSection } from '../shared/constants.js';
 import { RuleFileManager } from '../shared/rule-file-manager.js';
 import { RULES_CONNECTOR_CONFIGS } from './rules-connector-config.js';
 /**
@@ -26,13 +27,25 @@ export class RulesConnector {
             .map(([agent]) => agent);
     }
     getConfigPath(agent) {
-        return RULES_CONNECTOR_CONFIGS[agent].filePath;
+        const config = agent in RULES_CONNECTOR_CONFIGS ? RULES_CONNECTOR_CONFIGS[agent] : undefined;
+        if (!config) {
+            throw new Error(`Rules connector does not support agent: ${agent}`);
+        }
+        return config.filePath;
     }
     getSupportedAgents() {
         return this.supportedAgents;
     }
     async install(agent) {
-        const config = RULES_CONNECTOR_CONFIGS[agent];
+        const config = agent in RULES_CONNECTOR_CONFIGS ? RULES_CONNECTOR_CONFIGS[agent] : undefined;
+        if (!config) {
+            return {
+                alreadyInstalled: false,
+                configPath: '',
+                message: `Rules connector does not support agent: ${agent}`,
+                success: false,
+            };
+        }
         try {
             const ruleContent = await this.templateService.generateRuleContent(agent, this.connectorType);
             // Write the rule content to the file
@@ -65,7 +78,15 @@ export class RulesConnector {
                 installed: false,
             };
         }
-        const config = RULES_CONNECTOR_CONFIGS[agent];
+        const config = agent in RULES_CONNECTOR_CONFIGS ? RULES_CONNECTOR_CONFIGS[agent] : undefined;
+        if (!config) {
+            return {
+                configExists: false,
+                configPath: '',
+                error: `Rules connector has no config for agent: ${agent}`,
+                installed: false,
+            };
+        }
         const fullPath = path.join(this.projectRoot, config.filePath);
         try {
             const { fileExists, hasMarkers } = await this.ruleFileManager.status(config.filePath);
@@ -77,9 +98,7 @@ export class RulesConnector {
                 };
             }
             const content = await this.fileService.read(fullPath);
-            const hasMcpTools = content.includes('brv-query') || content.includes('brv-curate');
-            // For overwrite files, any BRV content means installed
-            // For append files, need both markers and agent tag
+            const hasMcpTools = hasMcpToolsInBrvSection(content);
             const installed = hasMarkers && !hasMcpTools;
             return {
                 configExists: true,
@@ -105,7 +124,15 @@ export class RulesConnector {
                 wasInstalled: false,
             };
         }
-        const config = RULES_CONNECTOR_CONFIGS[agent];
+        const config = agent in RULES_CONNECTOR_CONFIGS ? RULES_CONNECTOR_CONFIGS[agent] : undefined;
+        if (!config) {
+            return {
+                configPath: '',
+                message: `Rules connector has no config for agent: ${agent}`,
+                success: false,
+                wasInstalled: false,
+            };
+        }
         try {
             const { fileExists, hasLegacyTag, hasMarkers } = await this.ruleFileManager.status(config.filePath);
             if (!fileExists) {

package/dist/server/infra/connectors/shared/constants.d.ts

@@ -10,3 +10,8 @@ export declare const BRV_RULE_MARKERS: {
     readonly END: "<!-- END BYTEROVER RULES -->";
     readonly START: "<!-- BEGIN BYTEROVER RULES -->";
 };
+/**
+ * Checks if the BRV markers section contains MCP tool references (brv-query/brv-curate).
+ * Only checks within the markers section to avoid false positives from user content.
+ */
+export declare const hasMcpToolsInBrvSection: (content: string) => boolean;

package/dist/server/infra/connectors/shared/constants.js

@@ -10,3 +10,15 @@ export const BRV_RULE_MARKERS = {
     END: '<!-- END BYTEROVER RULES -->',
     START: '<!-- BEGIN BYTEROVER RULES -->',
 };
+/**
+ * Checks if the BRV markers section contains MCP tool references (brv-query/brv-curate).
+ * Only checks within the markers section to avoid false positives from user content.
+ */
+export const hasMcpToolsInBrvSection = (content) => {
+    const startIdx = content.indexOf(BRV_RULE_MARKERS.START);
+    const endIdx = content.indexOf(BRV_RULE_MARKERS.END);
+    if (startIdx === -1 || endIdx === -1)
+        return false;
+    const brvSection = new Set(content.slice(startIdx, endIdx));
+    return brvSection.has('brv-query') || brvSection.has('brv-curate');
+};

package/dist/server/infra/connectors/shared/rule-segment-patcher.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Patches an existing rules file to add `brv curate view` inside the BRV markers section.
+ * Only modifies content within `<!-- BEGIN/END BYTEROVER RULES -->` — never touches user content outside.
+ *
+ * @returns true if a patch was applied, false if no patch was needed or possible.
+ */
+export declare function patchRulesFile(fullPath: string): Promise<boolean>;
+/**
+ * Patches an existing WORKFLOWS.md to add the "Verifying Curate Results" section.
+ * Inserts before "## What to Curate" — safe to run on any version of the file.
+ *
+ * @returns true if a patch was applied, false if no patch was needed or possible.
+ */
+export declare function patchWorkflowsFile(fullPath: string): Promise<boolean>;
+/**
+ * Patches an existing SKILL.md to add `brv curate view` in the Quick Reference table
+ * and the "View curate history" subsection under "When to Use".
+ * Each patch is applied independently — files that already have the table row but lack
+ * the subsection (or vice versa) are handled correctly.
+ *
+ * @returns true if any patch was applied, false if no patch was needed or possible.
+ */
+export declare function patchSkillFile(fullPath: string): Promise<boolean>;
+/**
+ * Ensures `brv curate view` is present in all connector files found on disk.
+ * Each patcher function checks its own sentinel string before writing — safe to call on every command.
+ * Silently no-ops on any error — never throws.
+ */
+export declare function ensureCurateViewPatched(projectRoot: string): Promise<void>;

package/dist/server/infra/connectors/shared/rule-segment-patcher.js

@@ -0,0 +1,208 @@
+import { readdir, readFile, writeFile } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { RULES_CONNECTOR_CONFIGS } from '../rules/rules-connector-config.js';
+import { MAIN_SKILL_FILE_NAME, SKILL_CONNECTOR_CONFIGS } from '../skill/skill-connector-config.js';
+import { BRV_RULE_MARKERS } from './constants.js';
+const WORKFLOWS_FILE_NAME = 'WORKFLOWS.md';
+/** Anchor that marks where to insert the verifying section in WORKFLOWS.md. */
+const CURATE_VIEW_WORKFLOWS_ANCHOR = '## What to Curate';
+/**
+ * Section to insert before "## What to Curate" in existing WORKFLOWS.md files.
+ * Matches the content added to the template for new installs.
+ */
+const CURATE_VIEW_WORKFLOWS_SECTION = '## Verifying Curate Results\n' +
+    '\n' +
+    'After `brv curate` completes, it outputs a logId (e.g., `✓ Context curated successfully. (Log: cur-1739700001000)`). Use it to inspect exactly what was stored:\n' +
+    '\n' +
+    '```bash\n' +
+    'brv curate view cur-1739700001000   # Full detail: input, operations, summary\n' +
+    'brv curate view                     # List recent curates with status\n' +
+    'brv curate view --detail            # List with per-entry file operations visible\n' +
+    '```\n' +
+    '\n' +
+    'Useful for large contexts or folder-pack curations to confirm the knowledge was captured as expected.\n' +
+    '\n';
+/** Sentinel for WORKFLOWS.md — checks whether any mention of the command exists. */
+const CURATE_VIEW_SENTINEL = 'brv curate view';
+/**
+ * Sentinel for rules files — more specific than CURATE_VIEW_SENTINEL.
+ * Matches the command bullet (`- \`brv curate view\``) but NOT the footer line
+ * (`brv curate view --help`) which may appear in newer templates without the command lines.
+ */
+const CURATE_VIEW_RULES_SENTINEL = '- `brv curate view`';
+/** Sentinel for the Quick Reference table row in SKILL.md files. */
+const CURATE_VIEW_SKILL_TABLE_SENTINEL = '| `brv curate view`';
+/** Sentinel for the "View curate history" subsection in SKILL.md "When to Use" sections. */
+const CURATE_VIEW_SKILL_SECTION_SENTINEL = '**View curate history**';
+/**
+ * Lines to insert after the `brv curate` bullet in existing rules files.
+ * Matches the content added to the template for new installs.
+ */
+const CURATE_VIEW_RULES_LINES = '- `brv curate view` - List curate history (last 10 entries by default)\n' +
+    '- `brv curate view <logId>` - Full detail for a specific entry: all files and operations performed (logId returned by `brv curate`)\n' +
+    '- `brv curate view --detail` - List entries with their file operations visible (no logId needed)';
+/** Anchor string that identifies the `brv curate` command line in a rules file. */
+const CURATE_RULES_ANCHOR = '- `brv curate` -';
+/**
+ * Row to insert into existing SKILL.md Quick Reference tables.
+ * Matches the single row added to the template for new installs.
+ */
+const CURATE_VIEW_SKILL_ROWS = '| `brv curate view` | Check curate history | `brv curate view` |';
+/** Anchor string that identifies the `brv curate` row in the SKILL.md Quick Reference table. */
+const CURATE_SKILL_ANCHOR = '| `brv curate "context" -f file`';
+/** Anchor string that identifies the end of the Curate subsection in existing SKILL.md "When to Use" sections. */
+const CURATE_SKILL_WHEN_ANCHOR = '- Made an architecture decision';
+/**
+ * Subsection to insert after the Curate bullets in existing SKILL.md "When to Use" sections.
+ * Matches the content added to the template for new installs.
+ */
+const CURATE_VIEW_SKILL_WHEN_SECTION = '\n**View curate history** to check past curations:\n' +
+    '- `brv curate view` — show recent entries (last 10)\n' +
+    '- `brv curate view <logId>` — full detail for a specific entry: all files and operations performed (logId is printed by `brv curate` on completion, e.g. `cur-1739700001000`)\n' +
+    '- `brv curate view --detail` — list entries with file operations visible (no logId needed)\n' +
+    '- `brv curate view --since 1h --status completed` — filter by time and status\n' +
+    '- Run `brv curate view --help` for all filter options';
+/**
+ * Inserts a new line immediately after the first occurrence of `anchor` in `text`.
+ * Returns the patched string, or null if the anchor was not found.
+ */
+function insertAfterLine(text, anchor, newLine) {
+    const anchorIdx = text.indexOf(anchor);
+    if (anchorIdx === -1)
+        return null;
+    const lineEnd = text.indexOf('\n', anchorIdx);
+    const insertAt = lineEnd === -1 ? text.length : lineEnd;
+    return text.slice(0, insertAt) + '\n' + newLine + text.slice(insertAt);
+}
+/**
+ * Patches an existing rules file to add `brv curate view` inside the BRV markers section.
+ * Only modifies content within `<!-- BEGIN/END BYTEROVER RULES -->` — never touches user content outside.
+ *
+ * @returns true if a patch was applied, false if no patch was needed or possible.
+ */
+export async function patchRulesFile(fullPath) {
+    let content;
+    try {
+        content = await readFile(fullPath, 'utf8');
+    }
+    catch {
+        return false; // file doesn't exist
+    }
+    const { END, START } = BRV_RULE_MARKERS;
+    const startIdx = content.indexOf(START);
+    const endIdx = content.indexOf(END);
+    if (startIdx === -1 || endIdx === -1)
+        return false; // no BRV markers
+    const brvSection = content.slice(startIdx, endIdx + END.length);
+    if (brvSection.includes(CURATE_VIEW_RULES_SENTINEL))
+        return false; // already patched
+    const patchedSection = insertAfterLine(brvSection, CURATE_RULES_ANCHOR, CURATE_VIEW_RULES_LINES);
+    if (!patchedSection)
+        return false; // anchor not found — different template format, skip safely
+    const patchedContent = content.slice(0, startIdx) + patchedSection + content.slice(endIdx + END.length);
+    await writeFile(fullPath, patchedContent, 'utf8');
+    return true;
+}
+/**
+ * Patches an existing WORKFLOWS.md to add the "Verifying Curate Results" section.
+ * Inserts before "## What to Curate" — safe to run on any version of the file.
+ *
+ * @returns true if a patch was applied, false if no patch was needed or possible.
+ */
+export async function patchWorkflowsFile(fullPath) {
+    let content;
+    try {
+        content = await readFile(fullPath, 'utf8');
+    }
+    catch {
+        return false; // file doesn't exist
+    }
+    if (content.includes(CURATE_VIEW_SENTINEL))
+        return false; // already patched
+    const anchorIdx = content.indexOf(CURATE_VIEW_WORKFLOWS_ANCHOR);
+    if (anchorIdx === -1)
+        return false; // anchor not found — different format, skip safely
+    const patchedContent = content.slice(0, anchorIdx) + CURATE_VIEW_WORKFLOWS_SECTION + content.slice(anchorIdx);
+    await writeFile(fullPath, patchedContent, 'utf8');
+    return true;
+}
+/**
+ * Patches an existing SKILL.md to add `brv curate view` in the Quick Reference table
+ * and the "View curate history" subsection under "When to Use".
+ * Each patch is applied independently — files that already have the table row but lack
+ * the subsection (or vice versa) are handled correctly.
+ *
+ * @returns true if any patch was applied, false if no patch was needed or possible.
+ */
+export async function patchSkillFile(fullPath) {
+    let content;
+    try {
+        content = await readFile(fullPath, 'utf8');
+    }
+    catch {
+        return false; // file doesn't exist
+    }
+    let current = content;
+    let didPatch = false;
+    // Patch 1: Insert row into Quick Reference table if missing.
+    // If the table anchor is absent (older template without Quick Reference section), skip this
+    // patch only — Patch 2 below runs independently.
+    if (!current.includes(CURATE_VIEW_SKILL_TABLE_SENTINEL)) {
+        const withTableRow = insertAfterLine(current, CURATE_SKILL_ANCHOR, CURATE_VIEW_SKILL_ROWS);
+        if (withTableRow) {
+            current = withTableRow;
+            didPatch = true;
+        }
+    }
+    // Patch 2: Insert "View curate history" subsection if missing
+    // Gracefully skipped if anchor not found (older template version)
+    if (!current.includes(CURATE_VIEW_SKILL_SECTION_SENTINEL)) {
+        const withSection = insertAfterLine(current, CURATE_SKILL_WHEN_ANCHOR, CURATE_VIEW_SKILL_WHEN_SECTION);
+        if (withSection) {
+            current = withSection;
+            didPatch = true;
+        }
+    }
+    if (!didPatch)
+        return false;
+    await writeFile(fullPath, current, 'utf8');
+    return true;
+}
+/**
+ * Ensures `brv curate view` is present in all connector files found on disk.
+ * Each patcher function checks its own sentinel string before writing — safe to call on every command.
+ * Silently no-ops on any error — never throws.
+ */
+export async function ensureCurateViewPatched(projectRoot) {
+    const patches = [];
+    for (const config of Object.values(RULES_CONNECTOR_CONFIGS)) {
+        patches.push(patchRulesFile(path.join(projectRoot, config.filePath)).catch(() => false));
+    }
+    const skillDirScans = await Promise.all(Object.values(SKILL_CONNECTOR_CONFIGS).flatMap((config) => [
+        config.projectPath ? scanSkillsDir(path.join(projectRoot, config.projectPath)) : null,
+        scanSkillsDir(path.join(os.homedir(), config.globalPath)),
+    ]));
+    for (const scan of skillDirScans) {
+        if (!scan)
+            continue;
+        for (const entry of scan.entries) {
+            if (!entry.isDirectory())
+                continue;
+            const skillDir = path.join(scan.skillsParentDir, entry.name);
+            patches.push(patchSkillFile(path.join(skillDir, MAIN_SKILL_FILE_NAME)).catch(() => false), patchWorkflowsFile(path.join(skillDir, WORKFLOWS_FILE_NAME)).catch(() => false));
+        }
+    }
+    await Promise.all(patches);
+}
+const scanSkillsDir = async (dir) => {
+    try {
+        if (!dir)
+            return null;
+        const entries = await readdir(dir, { withFileTypes: true });
+        return { entries, skillsParentDir: dir };
+    }
+    catch {
+        return null; // skills parent dir doesn't exist — no skills installed for this agent
+    }
+};