@intellectronica/ruler 0.3.40 → 0.3.42

package/dist/core/GitignoreUtils.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Updates an ignore file in the project root with paths in a managed Ruler block.
+ * Creates the file if it doesn't exist, and creates or updates the Ruler-managed block.
+ *
+ * @param projectRoot The project root directory
+ * @param paths Array of file paths to add to the ignore file (can be absolute or relative)
+ * @param ignoreFile Relative path to the ignore file from project root (defaults to .gitignore)
+ */
+export declare function updateGitignore(projectRoot: string, paths: string[], ignoreFile?: string): Promise<void>;
+/**
+ * Resolves ignore files Ruler manages. Linked worktrees store `.git` as a
+ * file containing a `gitdir:` pointer, so `.git/info/exclude` must be resolved
+ * through that pointer.
+ */
+export declare function resolveIgnoreFilePath(projectRoot: string, ignoreFile: string): Promise<string>;

package/dist/core/GitignoreUtils.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.updateGitignore = updateGitignore;
+exports.resolveIgnoreFilePath = resolveIgnoreFilePath;
 const fs_1 = require("fs");
 const path = __importStar(require("path"));
 const RULER_START_MARKER = '# START Ruler Generated Files';
@@ -47,7 +48,7 @@ const RULER_END_MARKER = '# END Ruler Generated Files';
  * @param ignoreFile Relative path to the ignore file from project root (defaults to .gitignore)
  */
 async function updateGitignore(projectRoot, paths, ignoreFile = '.gitignore') {
-    const gitignorePath = path.join(projectRoot, ignoreFile);
+    const gitignorePath = await resolveIgnoreFilePath(projectRoot, ignoreFile);
     // Read existing .gitignore or start with empty content
     let existingContent = '';
     try {
@@ -101,6 +102,36 @@ async function updateGitignore(projectRoot, paths, ignoreFile = '.gitignore') {
     await fs_1.promises.mkdir(path.dirname(gitignorePath), { recursive: true });
     await fs_1.promises.writeFile(gitignorePath, newContent);
 }
+/**
+ * Resolves ignore files Ruler manages. Linked worktrees store `.git` as a
+ * file containing a `gitdir:` pointer, so `.git/info/exclude` must be resolved
+ * through that pointer.
+ */
+async function resolveIgnoreFilePath(projectRoot, ignoreFile) {
+    if (ignoreFile !== '.git/info/exclude') {
+        return path.join(projectRoot, ignoreFile);
+    }
+    const dotGitPath = path.join(projectRoot, '.git');
+    try {
+        const dotGitStat = await fs_1.promises.lstat(dotGitPath);
+        if (dotGitStat.isFile()) {
+            const dotGitContent = await fs_1.promises.readFile(dotGitPath, 'utf8');
+            const gitDirMatch = dotGitContent.match(/^gitdir:\s*(.+)\s*$/m);
+            if (gitDirMatch) {
+                const gitDir = gitDirMatch[1];
+                const resolvedGitDir = path.isAbsolute(gitDir)
+                    ? gitDir
+                    : path.resolve(projectRoot, gitDir);
+                return path.join(resolvedGitDir, 'info', 'exclude');
+            }
+        }
+    }
+    catch {
+        // Fall back to the historical project-root path for non-git test fixtures
+        // and unusual repositories where `.git` cannot be inspected.
+    }
+    return path.join(projectRoot, ignoreFile);
+}
 /**
  * Gets all paths from .gitignore content excluding those in the Ruler block.
  */

package/dist/core/RuleProcessor.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Concatenates markdown rule files into a single string,
+ * marking each section with its source filename.
+ */
+export declare function concatenateRules(files: {
+    path: string;
+    content: string;
+}[], baseDir?: string): string;

package/dist/core/SkillsProcessor.d.ts

@@ -0,0 +1,127 @@
+import * as fs from 'fs/promises';
+import { SkillInfo } from '../types';
+import type { IAgent } from '../agents/IAgent';
+/**
+ * Discovers skills in the project's .ruler/skills directory.
+ * Returns discovered skills and any validation warnings.
+ */
+export declare function discoverSkills(projectRoot: string): Promise<{
+    skills: SkillInfo[];
+    warnings: string[];
+}>;
+/**
+ * Gets the paths that skills will generate, for gitignore purposes.
+ * Returns empty array if skills directory doesn't exist.
+ */
+export declare function getSkillsGitignorePaths(projectRoot: string, agents: IAgent[]): Promise<string[]>;
+type ReplaceSkillsFsOps = Pick<typeof fs, 'rename' | 'cp' | 'rm'>;
+export declare function replaceSkillsDirectory(tempDir: string, targetDir: string, fsOps?: ReplaceSkillsFsOps): Promise<void>;
+/**
+ * Propagates skills for agents that need them.
+ */
+export declare function propagateSkills(projectRoot: string, agents: IAgent[], skillsEnabled: boolean, verbose: boolean, dryRun: boolean): Promise<void>;
+/**
+ * Propagates skills for Claude Code by copying .ruler/skills to .claude/skills.
+ * Uses atomic replace to ensure safe overwriting of existing skills.
+ * Returns dry-run steps if dryRun is true, otherwise returns empty array.
+ */
+export declare function propagateSkillsForClaude(projectRoot: string, options: {
+    dryRun: boolean;
+}): Promise<string[]>;
+/**
+ * Propagates skills for OpenAI Codex CLI by copying .ruler/skills to .codex/skills.
+ * Uses atomic replace to ensure safe overwriting of existing skills.
+ * Returns dry-run steps if dryRun is true, otherwise returns empty array.
+ */
+export declare function propagateSkillsForCodex(projectRoot: string, options: {
+    dryRun: boolean;
+}): Promise<string[]>;
+/**
+ * Propagates skills for OpenCode by copying .ruler/skills to .opencode/skills.
+ * Uses atomic replace to ensure safe overwriting of existing skills.
+ * Returns dry-run steps if dryRun is true, otherwise returns empty array.
+ */
+export declare function propagateSkillsForOpenCode(projectRoot: string, options: {
+    dryRun: boolean;
+}): Promise<string[]>;
+/**
+ * Propagates skills for Pi Coding Agent by copying .ruler/skills to .pi/skills.
+ * Uses atomic replace to ensure safe overwriting of existing skills.
+ * Returns dry-run steps if dryRun is true, otherwise returns empty array.
+ */
+export declare function propagateSkillsForPi(projectRoot: string, options: {
+    dryRun: boolean;
+}): Promise<string[]>;
+/**
+ * Propagates skills for Goose by copying .ruler/skills to .agents/skills.
+ * Uses atomic replace to ensure safe overwriting of existing skills.
+ * Returns dry-run steps if dryRun is true, otherwise returns empty array.
+ */
+export declare function propagateSkillsForGoose(projectRoot: string, options: {
+    dryRun: boolean;
+}): Promise<string[]>;
+/**
+ * Propagates skills for Mistral Vibe by copying .ruler/skills to .vibe/skills.
+ * Uses atomic replace to ensure safe overwriting of existing skills.
+ * Returns dry-run steps if dryRun is true, otherwise returns empty array.
+ */
+export declare function propagateSkillsForVibe(projectRoot: string, options: {
+    dryRun: boolean;
+}): Promise<string[]>;
+/**
+ * Propagates skills for Roo Code by copying .ruler/skills to .roo/skills.
+ * Uses atomic replace to ensure safe overwriting of existing skills.
+ * Returns dry-run steps if dryRun is true, otherwise returns empty array.
+ */
+export declare function propagateSkillsForRoo(projectRoot: string, options: {
+    dryRun: boolean;
+}): Promise<string[]>;
+/**
+ * Propagates skills for Gemini CLI by copying .ruler/skills to .gemini/skills.
+ * Uses atomic replace to ensure safe overwriting of existing skills.
+ * Returns dry-run steps if dryRun is true, otherwise returns empty array.
+ */
+export declare function propagateSkillsForGemini(projectRoot: string, options: {
+    dryRun: boolean;
+}): Promise<string[]>;
+/**
+ * Propagates skills for Junie by copying .ruler/skills to .junie/skills.
+ * Uses atomic replace to ensure safe overwriting of existing skills.
+ * Returns dry-run steps if dryRun is true, otherwise returns empty array.
+ */
+export declare function propagateSkillsForJunie(projectRoot: string, options: {
+    dryRun: boolean;
+}): Promise<string[]>;
+/**
+ * Propagates skills for Cursor by copying .ruler/skills to .cursor/skills.
+ * Uses atomic replace to ensure safe overwriting of existing skills.
+ * Returns dry-run steps if dryRun is true, otherwise returns empty array.
+ */
+export declare function propagateSkillsForCursor(projectRoot: string, options: {
+    dryRun: boolean;
+}): Promise<string[]>;
+/**
+ * Propagates skills for Windsurf by copying .ruler/skills to .windsurf/skills.
+ * Uses atomic replace to ensure safe overwriting of existing skills.
+ * Returns dry-run steps if dryRun is true, otherwise returns empty array.
+ */
+export declare function propagateSkillsForWindsurf(projectRoot: string, options: {
+    dryRun: boolean;
+}): Promise<string[]>;
+/**
+ * Propagates skills for Factory Droid by copying .ruler/skills to .factory/skills.
+ * Uses atomic replace to ensure safe overwriting of existing skills.
+ * Returns dry-run steps if dryRun is true, otherwise returns empty array.
+ */
+export declare function propagateSkillsForFactory(projectRoot: string, options: {
+    dryRun: boolean;
+}): Promise<string[]>;
+/**
+ * Propagates skills for Antigravity by copying .ruler/skills to .agent/skills.
+ * Uses atomic replace to ensure safe overwriting of existing skills.
+ * Returns dry-run steps if dryRun is true, otherwise returns empty array.
+ */
+export declare function propagateSkillsForAntigravity(projectRoot: string, options: {
+    dryRun: boolean;
+}): Promise<string[]>;
+export {};