opencode-rules-md 0.6.5

package/dist/src/project-fingerprint.js

@@ -0,0 +1,61 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+const SIMPLE_MARKERS = [
+    ['package.json', 'node'],
+    ['pyproject.toml', 'python'],
+    ['go.mod', 'go'],
+    ['Cargo.toml', 'rust'],
+    ['pnpm-workspace.yaml', 'monorepo'],
+    ['turbo.json', 'monorepo'],
+];
+const BROWSER_EXTENSION_SIGNAL_KEYS = [
+    'background',
+    'content_scripts',
+    'browser_action',
+    'page_action',
+    'action',
+    'permissions',
+];
+async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function isBrowserExtensionManifest(manifestPath) {
+    try {
+        const content = await fs.readFile(manifestPath, 'utf-8');
+        const parsed = JSON.parse(content);
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+            return false;
+        const version = parsed.manifest_version;
+        if (version !== 2 && version !== 3)
+            return false;
+        return BROWSER_EXTENSION_SIGNAL_KEYS.some(key => key in parsed);
+    }
+    catch {
+        return false;
+    }
+}
+export async function detectProjectTags(projectDir) {
+    const tags = new Set();
+    const checks = SIMPLE_MARKERS.map(async ([marker, tag]) => {
+        const markerPath = path.join(projectDir, marker);
+        if (await fileExists(markerPath)) {
+            tags.add(tag);
+        }
+    });
+    const manifestPath = path.join(projectDir, 'manifest.json');
+    checks.push((async () => {
+        if ((await fileExists(manifestPath)) &&
+            (await isBrowserExtensionManifest(manifestPath))) {
+            tags.add('browser-extension');
+        }
+    })());
+    await Promise.all(checks);
+    return [...tags].sort((a, b) => a.localeCompare(b));
+}
+//# sourceMappingURL=project-fingerprint.js.map

package/dist/src/project-fingerprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-fingerprint.js","sourceRoot":"","sources":["../../src/project-fingerprint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,cAAc,GAA4B;IAC9C,CAAC,cAAc,EAAE,MAAM,CAAC;IACxB,CAAC,gBAAgB,EAAE,QAAQ,CAAC;IAC5B,CAAC,QAAQ,EAAE,IAAI,CAAC;IAChB,CAAC,YAAY,EAAE,MAAM,CAAC;IACtB,CAAC,qBAAqB,EAAE,UAAU,CAAC;IACnC,CAAC,YAAY,EAAE,UAAU,CAAC;CAC3B,CAAC;AAEF,MAAM,6BAA6B,GAAG;IACpC,YAAY;IACZ,iBAAiB;IACjB,gBAAgB;IAChB,aAAa;IACb,QAAQ;IACR,aAAa;CACd,CAAC;AAEF,KAAK,UAAU,UAAU,CAAC,QAAgB;IACxC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,KAAK,UAAU,0BAA0B,CACvC,YAAoB;IAEpB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YACxE,OAAO,KAAK,CAAC;QACf,MAAM,OAAO,GAAG,MAAM,CAAC,gBAAgB,CAAC;QACxC,IAAI,OAAO,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACjD,OAAO,6BAA6B,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,UAAkB;IACxD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EAAE;QACxD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACjD,IAAI,MAAM,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IAC5D,MAAM,CAAC,IAAI,CACT,CAAC,KAAK,IAAI,EAAE;QACV,IACE,CAAC,MAAM,UAAU,CAAC,YAAY,CAAC,CAAC;YAChC,CAAC,MAAM,0BAA0B,CAAC,YAAY,CAAC,CAAC,EAChD,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CAAC,EAAE,CACL,CAAC;IAEF,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAE1B,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC"}

package/dist/src/rule-discovery.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Rule file discovery utilities
+ */
+import { type RuleMetadata } from './rule-metadata';
+/**
+ * Cached rule data for performance optimization
+ */
+interface CachedRule {
+    /** Raw file content */
+    content: string;
+    /** Parsed metadata from frontmatter */
+    metadata: RuleMetadata | undefined;
+    /** Content with frontmatter stripped */
+    strippedContent: string;
+    /** File modification time for cache invalidation */
+    mtime: number;
+}
+/**
+ * Clear the rule cache (useful for testing or manual invalidation)
+ */
+export declare function clearRuleCache(): void;
+/**
+ * Get cached rule data, refreshing from disk if file has changed.
+ * Uses mtime-based invalidation to detect file changes.
+ *
+ * @param filePath - Absolute path to the rule file
+ * @returns Cached rule data or undefined if file cannot be read
+ */
+export declare function getCachedRule(filePath: string): Promise<CachedRule | undefined>;
+/**
+ * Discovered rule file with both absolute and relative paths
+ */
+export interface DiscoveredRule {
+    /** Absolute path to the rule file */
+    filePath: string;
+    /** Relative path from the rules directory root (for unique headings) */
+    relativePath: string;
+}
+/**
+ * Discover markdown rule files from standard directories
+ * Searches recursively in:
+ * - $OPENCODE_CONFIG_DIR/rules/ (highest priority)
+ * - $XDG_CONFIG_HOME/opencode/rules/ (or ~/.config/opencode/rules as fallback)
+ * - .opencode/rules/ (in project directory if provided)
+ * Finds all .md and .mdc files including nested subdirectories.
+ */
+export declare function discoverRuleFiles(projectDir?: string): Promise<DiscoveredRule[]>;
+export {};
+//# sourceMappingURL=rule-discovery.d.ts.map

package/dist/src/rule-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-discovery.d.ts","sourceRoot":"","sources":["../../src/rule-discovery.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,iBAAiB,CAAC;AAIzB;;GAEG;AACH,UAAU,UAAU;IAClB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,QAAQ,EAAE,YAAY,GAAG,SAAS,CAAC;IACnC,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;CACf;AAOD;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAoCjC;AAmED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,EAAE,CAAC,CA8B3B"}

package/dist/src/rule-discovery.js

@@ -0,0 +1,143 @@
+/**
+ * Rule file discovery utilities
+ */
+import { stat, readFile, readdir } from 'fs/promises';
+import path from 'path';
+import os from 'os';
+import { createDebugLog } from './debug';
+import { parseRuleMetadata, stripFrontmatter, } from './rule-metadata';
+const debugLog = createDebugLog();
+/**
+ * Rule cache keyed by absolute file path
+ */
+const ruleCache = new Map();
+/**
+ * Clear the rule cache (useful for testing or manual invalidation)
+ */
+export function clearRuleCache() {
+    ruleCache.clear();
+}
+/**
+ * Get cached rule data, refreshing from disk if file has changed.
+ * Uses mtime-based invalidation to detect file changes.
+ *
+ * @param filePath - Absolute path to the rule file
+ * @returns Cached rule data or undefined if file cannot be read
+ */
+export async function getCachedRule(filePath) {
+    try {
+        const stats = await stat(filePath);
+        const mtime = stats.mtimeMs;
+        // Check if we have a valid cached entry
+        const cached = ruleCache.get(filePath);
+        if (cached && cached.mtime === mtime) {
+            debugLog(`Cache hit: ${filePath}`);
+            return cached;
+        }
+        // Read and cache the file
+        debugLog(`Cache miss: ${filePath}`);
+        const content = await readFile(filePath, 'utf-8');
+        const metadata = parseRuleMetadata(content);
+        const strippedContent = stripFrontmatter(content);
+        const entry = {
+            content,
+            metadata,
+            strippedContent,
+            mtime,
+        };
+        ruleCache.set(filePath, entry);
+        return entry;
+    }
+    catch (error) {
+        // Remove stale cache entry if file no longer exists
+        ruleCache.delete(filePath);
+        const message = error instanceof Error ? error.message : String(error);
+        console.warn(`[opencode-rules-md] Warning: Failed to read rule file ${filePath}: ${message}`);
+        return undefined;
+    }
+}
+/**
+ * Get the global rules directory path
+ */
+function getGlobalRulesDir() {
+    const opencodeConfigDir = process.env.OPENCODE_CONFIG_DIR;
+    if (opencodeConfigDir) {
+        return path.join(opencodeConfigDir, 'rules');
+    }
+    const xdgConfigHome = process.env.XDG_CONFIG_HOME;
+    if (xdgConfigHome) {
+        return path.join(xdgConfigHome, 'opencode', 'rules');
+    }
+    const homeDir = process.env.HOME || os.homedir();
+    return path.join(homeDir, '.config', 'opencode', 'rules');
+}
+/**
+ * Recursively scan a directory for markdown rule files
+ * Skips hidden files and directories (starting with .)
+ * @param dir - Directory to scan
+ * @param baseDir - Base directory for relative path calculation
+ * @returns Array of discovered file paths with their relative paths from baseDir
+ */
+async function scanDirectoryRecursively(dir, baseDir) {
+    const results = [];
+    try {
+        const entries = await readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            // Skip hidden files and directories
+            if (entry.name.startsWith('.')) {
+                continue;
+            }
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                // Recurse into subdirectory
+                results.push(...(await scanDirectoryRecursively(fullPath, baseDir)));
+            }
+            else if (entry.name.endsWith('.md') || entry.name.endsWith('.mdc')) {
+                // Add markdown file
+                const relativePath = path.relative(baseDir, fullPath);
+                results.push({ filePath: fullPath, relativePath });
+            }
+        }
+    }
+    catch (error) {
+        // Treat ENOENT as benign (directory doesn't exist or was deleted)
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+            return results;
+        }
+        // Log non-ENOENT directory read errors
+        const message = error instanceof Error ? error.message : String(error);
+        console.warn(`[opencode-rules-md] Warning: Failed to read directory ${dir}: ${message}`);
+    }
+    return results;
+}
+/**
+ * Discover markdown rule files from standard directories
+ * Searches recursively in:
+ * - $OPENCODE_CONFIG_DIR/rules/ (highest priority)
+ * - $XDG_CONFIG_HOME/opencode/rules/ (or ~/.config/opencode/rules as fallback)
+ * - .opencode/rules/ (in project directory if provided)
+ * Finds all .md and .mdc files including nested subdirectories.
+ */
+export async function discoverRuleFiles(projectDir) {
+    const files = [];
+    // Discover global rules (recursively)
+    const globalRulesDir = getGlobalRulesDir();
+    if (globalRulesDir) {
+        const globalRules = await scanDirectoryRecursively(globalRulesDir, globalRulesDir);
+        for (const { filePath, relativePath } of globalRules) {
+            debugLog(`Discovered global rule: ${relativePath} (${filePath})`);
+            files.push({ filePath, relativePath });
+        }
+    }
+    // Discover project-local rules (recursively) if project directory is provided
+    if (projectDir) {
+        const projectRulesDir = path.join(projectDir, '.opencode', 'rules');
+        const projectRules = await scanDirectoryRecursively(projectRulesDir, projectRulesDir);
+        for (const { filePath, relativePath } of projectRules) {
+            debugLog(`Discovered project rule: ${relativePath} (${filePath})`);
+            files.push({ filePath, relativePath });
+        }
+    }
+    return files;
+}
+//# sourceMappingURL=rule-discovery.js.map

package/dist/src/rule-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-discovery.js","sourceRoot":"","sources":["../../src/rule-discovery.ts"],"names":[],"mappings":"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"}

package/dist/src/rule-filter.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Rule filtering and matching utilities
+ */
+import { type DiscoveredRule } from './rule-discovery.js';
+/**
+ * Check if a user prompt matches any of the given keywords.
+ * Uses case-insensitive word-boundary matching.
+ *
+ * @param prompt - The user's prompt text
+ * @param keywords - Array of keywords to match
+ * @returns true if any keyword matches the prompt
+ */
+export declare function promptMatchesKeywords(prompt: string, keywords: string[]): boolean;
+/**
+ * Check if any of the required tools are available.
+ * Uses exact string matching (OR logic: any match returns true).
+ *
+ * @param availableToolIDs - Array of tool IDs currently available
+ * @param requiredTools - Array of tool IDs from rule metadata
+ * @returns true if any required tool is available
+ */
+export declare function toolsMatchAvailable(availableToolIDs: string[], requiredTools: string[]): boolean;
+/**
+ * Result of reading and formatting rules
+ */
+export interface FilterResult {
+    formattedRules: string;
+    matchedPaths: string[];
+}
+/**
+ * Runtime filter context for conditional rule matching
+ */
+export interface RuleFilterContext {
+    /** File paths from conversation context (for glob matching) */
+    contextFilePaths?: string[];
+    /** User's prompt text (for keyword matching) */
+    userPrompt?: string;
+    /** Available tool IDs (for tool-based filtering) */
+    availableToolIDs?: string[];
+    /** Current model ID */
+    modelID?: string;
+    /** Current agent type */
+    agentType?: string;
+    /** Current slash command (e.g., /plan, /review) */
+    command?: string;
+    /** Detected project tags (e.g., node, python, monorepo) */
+    projectTags?: string[];
+    /** Current git branch name */
+    gitBranch?: string;
+    /** Current operating system (e.g., linux, darwin, win32) */
+    os?: string;
+    /** Whether running in CI environment */
+    ci?: boolean;
+}
+/**
+ * Read and format rule files for system prompt injection
+ * @param files - Array of discovered rule files with paths
+ * @param context - Optional RuleFilterContext for conditional rule matching
+ */
+export declare function readAndFormatRules(files: DiscoveredRule[], context?: RuleFilterContext): Promise<FilterResult>;
+//# sourceMappingURL=rule-filter.d.ts.map

package/dist/src/rule-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-filter.d.ts","sourceRoot":"","sources":["../../src/rule-filter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAWzE;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAWT;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,gBAAgB,EAAE,MAAM,EAAE,EAC1B,aAAa,EAAE,MAAM,EAAE,GACtB,OAAO,CAOT;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,wCAAwC;IACxC,EAAE,CAAC,EAAE,OAAO,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,YAAY,CAAC,CAqKvB"}

package/dist/src/rule-filter.js

@@ -0,0 +1,180 @@
+/**
+ * Rule filtering and matching utilities
+ */
+import { minimatch } from 'minimatch';
+import { createDebugLog } from './debug.js';
+import { getCachedRule } from './rule-discovery.js';
+const debugLog = createDebugLog();
+/**
+ * Check if a file path matches any of the given glob patterns
+ */
+function fileMatchesGlobs(filePath, globs) {
+    return globs.some(glob => minimatch(filePath, glob, { matchBase: true }));
+}
+/**
+ * Check if a user prompt matches any of the given keywords.
+ * Uses case-insensitive word-boundary matching.
+ *
+ * @param prompt - The user's prompt text
+ * @param keywords - Array of keywords to match
+ * @returns true if any keyword matches the prompt
+ */
+export function promptMatchesKeywords(prompt, keywords) {
+    const lowerPrompt = prompt.toLowerCase();
+    return keywords.some(keyword => {
+        const lowerKeyword = keyword.toLowerCase();
+        // Escape special regex characters in the keyword
+        const escaped = lowerKeyword.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        // Word boundary at start, but allow continuation at end (e.g., "test" matches "testing")
+        const regex = new RegExp(`\\b${escaped}`, 'i');
+        return regex.test(lowerPrompt);
+    });
+}
+/**
+ * Check if any of the required tools are available.
+ * Uses exact string matching (OR logic: any match returns true).
+ *
+ * @param availableToolIDs - Array of tool IDs currently available
+ * @param requiredTools - Array of tool IDs from rule metadata
+ * @returns true if any required tool is available
+ */
+export function toolsMatchAvailable(availableToolIDs, requiredTools) {
+    if (requiredTools.length === 0) {
+        return false;
+    }
+    // Create a Set for O(1) lookups
+    const availableSet = new Set(availableToolIDs);
+    return requiredTools.some(tool => availableSet.has(tool));
+}
+/**
+ * Read and format rule files for system prompt injection
+ * @param files - Array of discovered rule files with paths
+ * @param context - Optional RuleFilterContext for conditional rule matching
+ */
+export async function readAndFormatRules(files, context = {}) {
+    if (files.length === 0) {
+        return { formattedRules: '', matchedPaths: [] };
+    }
+    const ruleContents = [];
+    const matchedPaths = [];
+    const availableToolSet = context.availableToolIDs && context.availableToolIDs.length > 0
+        ? new Set(context.availableToolIDs)
+        : undefined;
+    for (const { filePath, relativePath } of files) {
+        // Use cached rule data with mtime-based invalidation
+        const cachedRule = await getCachedRule(filePath);
+        if (!cachedRule) {
+            continue; // Error already logged by getCachedRule
+        }
+        const { metadata, strippedContent } = cachedRule;
+        // Check if rule has any conditional filters
+        const hasConditions = Boolean(metadata?.globs ||
+            metadata?.keywords ||
+            metadata?.tools ||
+            metadata?.model ||
+            metadata?.agent ||
+            metadata?.command ||
+            metadata?.project ||
+            metadata?.branch ||
+            metadata?.os ||
+            metadata?.ci !== undefined);
+        if (hasConditions && metadata) {
+            // Compute per-dimension match booleans (only for declared conditions)
+            const declaredChecks = [];
+            // Legacy: globs
+            if (metadata.globs) {
+                const globs = metadata.globs;
+                const globsMatch = context.contextFilePaths &&
+                    context.contextFilePaths.length > 0 &&
+                    context.contextFilePaths.some(contextPath => fileMatchesGlobs(contextPath, globs));
+                declaredChecks.push(Boolean(globsMatch));
+            }
+            // Legacy: keywords
+            if (metadata.keywords) {
+                const keywordsMatch = context.userPrompt &&
+                    promptMatchesKeywords(context.userPrompt, metadata.keywords);
+                declaredChecks.push(Boolean(keywordsMatch));
+            }
+            // Legacy: tools
+            if (metadata.tools) {
+                const toolsMatch = availableToolSet &&
+                    metadata.tools.some(tool => availableToolSet.has(tool));
+                declaredChecks.push(Boolean(toolsMatch));
+            }
+            // New: model
+            if (metadata.model) {
+                const modelMatch = context.modelID && metadata.model.includes(context.modelID);
+                declaredChecks.push(Boolean(modelMatch));
+            }
+            // New: agent
+            if (metadata.agent) {
+                const agentMatch = context.agentType && metadata.agent.includes(context.agentType);
+                declaredChecks.push(Boolean(agentMatch));
+            }
+            // New: command
+            if (metadata.command) {
+                const commandMatch = context.command && metadata.command.includes(context.command);
+                declaredChecks.push(Boolean(commandMatch));
+            }
+            // New: project
+            if (metadata.project) {
+                const projectTags = context.projectTags;
+                const projectMatch = projectTags &&
+                    projectTags.length > 0 &&
+                    metadata.project.some(tag => projectTags.includes(tag));
+                declaredChecks.push(Boolean(projectMatch));
+            }
+            // New: branch (supports glob patterns)
+            if (metadata.branch) {
+                const gitBranch = context.gitBranch;
+                const branchMatch = gitBranch &&
+                    metadata.branch.some(pattern => {
+                        // Exact match for non-glob patterns
+                        if (pattern === gitBranch) {
+                            return true;
+                        }
+                        // Only use glob matching if pattern contains glob characters
+                        const hasGlobChars = /[*?\[{]/.test(pattern);
+                        if (hasGlobChars) {
+                            return minimatch(gitBranch, pattern);
+                        }
+                        return false;
+                    });
+                declaredChecks.push(Boolean(branchMatch));
+            }
+            // New: os
+            if (metadata.os) {
+                const osMatch = context.os && metadata.os.includes(context.os);
+                declaredChecks.push(Boolean(osMatch));
+            }
+            // New: ci (strict boolean equality)
+            if (metadata.ci !== undefined) {
+                const ciMatch = context.ci === metadata.ci;
+                declaredChecks.push(ciMatch);
+            }
+            // Apply combinator: default 'any', or 'all' if specified
+            const mode = metadata.match ?? 'any';
+            const shouldInclude = mode === 'all'
+                ? declaredChecks.every(Boolean)
+                : declaredChecks.some(Boolean);
+            if (!shouldInclude) {
+                debugLog(`Skipping conditional rule: ${relativePath} (match: ${mode}, checks: ${declaredChecks.join(', ')})`);
+                continue;
+            }
+            debugLog(`Including conditional rule: ${relativePath} (match: ${mode}, checks: ${declaredChecks.join(', ')})`);
+        }
+        // Use cached stripped content for output
+        // Use relativePath for unique headings instead of just filename
+        ruleContents.push(`## ${relativePath}\n\n${strippedContent}`);
+        matchedPaths.push(filePath);
+    }
+    if (ruleContents.length === 0) {
+        return { formattedRules: '', matchedPaths: [] };
+    }
+    return {
+        formattedRules: `# OpenCode Rules\n\nPlease follow the following rules:\n\n` +
+            ruleContents.join('\n\n---\n\n'),
+        matchedPaths,
+    };
+}
+//# sourceMappingURL=rule-filter.js.map

package/dist/src/rule-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-filter.js","sourceRoot":"","sources":["../../src/rule-filter.ts"],"names":[],"mappings":"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"}

package/dist/src/rule-metadata.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Rule metadata parsing and frontmatter extraction
+ */
+/**
+ * Metadata extracted from .mdc file frontmatter
+ */
+export interface RuleMetadata {
+    globs?: string[];
+    keywords?: string[];
+    tools?: string[];
+    model?: string[];
+    agent?: string[];
+    command?: string[];
+    project?: string[];
+    branch?: string[];
+    os?: string[];
+    ci?: boolean;
+    match?: 'any' | 'all';
+}
+/**
+ * Parse YAML metadata from rule file content using the yaml package.
+ * Extracts frontmatter (---) and returns metadata object.
+ */
+export declare function parseRuleMetadata(content: string): RuleMetadata | undefined;
+/**
+ * Strip YAML frontmatter from rule content
+ */
+export declare function stripFrontmatter(content: string): string;
+//# sourceMappingURL=rule-metadata.d.ts.map

package/dist/src/rule-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-metadata.d.ts","sourceRoot":"","sources":["../../src/rule-metadata.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;CACvB;AAiDD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAmE3E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAcxD"}

package/dist/src/rule-metadata.js

@@ -0,0 +1,100 @@
+/**
+ * Rule metadata parsing and frontmatter extraction
+ */
+const { parse: parseYaml } = await import('yaml');
+/**
+ * Extract and normalize a string array from parsed frontmatter.
+ * Filters non-strings, trims whitespace, and removes empty values.
+ *
+ * @param value - Raw value from parsed YAML (may be array or undefined)
+ * @returns Normalized string array, or undefined if empty after filtering
+ */
+function extractStringArray(value) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const result = value
+        .filter((v) => typeof v === 'string')
+        .map(v => v.trim())
+        .filter(v => v.length > 0);
+    return result.length > 0 ? result : undefined;
+}
+/**
+ * Parse YAML metadata from rule file content using the yaml package.
+ * Extracts frontmatter (---) and returns metadata object.
+ */
+export function parseRuleMetadata(content) {
+    // Check if content starts with frontmatter
+    if (!content.startsWith('---')) {
+        return undefined;
+    }
+    // Find the closing --- marker
+    const endIndex = content.indexOf('---', 3);
+    if (endIndex === -1) {
+        return undefined;
+    }
+    // Extract the YAML frontmatter
+    const frontmatter = content.substring(3, endIndex).trim();
+    if (!frontmatter) {
+        return undefined;
+    }
+    try {
+        // Parse YAML using the yaml package
+        const parsed = parseYaml(frontmatter);
+        if (!parsed || typeof parsed !== 'object') {
+            return undefined;
+        }
+        const metadata = {};
+        // Array fields to extract using shared helper
+        const arrayFields = [
+            'globs',
+            'keywords',
+            'tools',
+            'model',
+            'agent',
+            'command',
+            'project',
+            'branch',
+            'os',
+        ];
+        for (const field of arrayFields) {
+            const extracted = extractStringArray(parsed[field]);
+            if (extracted) {
+                metadata[field] = extracted;
+            }
+        }
+        // Extract ci boolean (only if strictly boolean)
+        if (typeof parsed.ci === 'boolean') {
+            metadata.ci = parsed.ci;
+        }
+        // Extract match (normalize to 'any' | 'all' only)
+        if (parsed.match === 'any' || parsed.match === 'all') {
+            metadata.match = parsed.match;
+        }
+        // Return metadata only if it has content
+        return Object.keys(metadata).length > 0 ? metadata : undefined;
+    }
+    catch (error) {
+        // Log warning for YAML parsing errors
+        const message = error instanceof Error ? error.message : String(error);
+        console.warn(`[opencode-rules-md] Warning: Failed to parse YAML frontmatter: ${message}`);
+        return undefined;
+    }
+}
+/**
+ * Strip YAML frontmatter from rule content
+ */
+export function stripFrontmatter(content) {
+    // Check if content starts with frontmatter
+    if (!content.startsWith('---')) {
+        return content;
+    }
+    // Find the closing --- marker
+    const endIndex = content.indexOf('---', 3);
+    if (endIndex === -1) {
+        return content;
+    }
+    // Return content after the closing marker, trimming leading newline
+    return content.substring(endIndex + 3).trimStart();
+}
+//# sourceMappingURL=rule-metadata.js.map