@aramassa/ai-rules 0.4.3 → 0.5.1

package/artifact/chatmodes/Planning.md

@@ -5,6 +5,7 @@ chatmode: planning
 tools:
   - "changes"
   - "searchResults"
+  - "createFile"
   - "editFiles"
   - "search"
   - "add_sub_issue"

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AA+qBA;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,MAAY,GACpB,OAAO,CAAC,MAAM,EAAE,CAAC,CA4BnB"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAosBA;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,MAAY,GACpB,OAAO,CAAC,MAAM,EAAE,CAAC,CA4BnB"}

package/dist/cli.js

@@ -8,9 +8,11 @@ import require$$1 from 'node:child_process';
 import require$$2 from 'node:path';
 import require$$3$1 from 'node:fs';
 import require$$4 from 'node:process';
+import readline from 'readline';
 import { fileURLToPath } from 'url';
 import { createHash } from 'crypto';
 import { homedir } from 'os';
+import { execSync } from 'child_process';
 
 /******************************************************************************
 Copyright (c) Microsoft Corporation.
@@ -17810,6 +17812,15 @@ class RecipeValidator {
         return commonMistakeProps.includes(property);
     }
     checkCommonMistakes(recipeData, result) {
+        // Validate pre-action if present
+        if (recipeData['pre-action']) {
+            if (!Array.isArray(recipeData['pre-action'])) {
+                result.warnings.push('Warning: Pre-action should be an array');
+            }
+            else {
+                this.validatePreActions(recipeData['pre-action'], result);
+            }
+        }
         // Check for properties that should be under filters or frontmatter
         if (Array.isArray(recipeData.recipe)) {
             recipeData.recipe.forEach((item, index) => {
@@ -17847,6 +17858,33 @@ class RecipeValidator {
             }
         });
     }
+    validatePreActions(preActions, result) {
+        for (let i = 0; i < preActions.length; i++) {
+            const action = preActions[i];
+            if (!action || typeof action !== 'object') {
+                result.warnings.push(`Warning: Pre-action item ${i + 1} should be an object`);
+                continue;
+            }
+            if (!action.type) {
+                result.warnings.push(`Warning: Pre-action item ${i + 1} is missing required 'type' field`);
+                continue;
+            }
+            if (action.type === 'git-pull') {
+                if (!action.path) {
+                    result.warnings.push(`Warning: Git-pull action ${i + 1} is missing required 'path' field`);
+                }
+                if (action.depth !== undefined && typeof action.depth !== 'number') {
+                    result.warnings.push(`Warning: Git-pull action ${i + 1}: 'depth' should be a number`);
+                }
+                if (action.depth !== undefined && action.depth < 1) {
+                    result.warnings.push(`Warning: Git-pull action ${i + 1}: 'depth' should be at least 1`);
+                }
+            }
+            else {
+                result.warnings.push(`Warning: Pre-action item ${i + 1} has unknown type: ${action.type}`);
+            }
+        }
+    }
 }
 // Singleton instance
 let validatorInstance = null;
@@ -17858,6 +17896,92 @@ async function getRecipeValidator() {
     return validatorInstance;
 }
 
+/**
+ * Executes git pull in the specified repository
+ * @param options - Configuration for the git pull operation
+ * @param debugLogger - Optional debug logger
+ * @returns Result of the git pull operation
+ */
+async function executeGitPull(options, debugLogger) {
+    try {
+        // Verify it's a git repository
+        const isRepo = await verifyGitRepository(options.path);
+        if (!isRepo) {
+            return {
+                success: false,
+                message: "Path is not a git repository",
+                updated: false,
+            };
+        }
+        // Switch to target branch if specified
+        if (options.branch) {
+            try {
+                debugLogger?.log(`Switching to branch: ${options.branch}`);
+                execSync(`git checkout ${options.branch}`, {
+                    cwd: options.path,
+                    encoding: "utf-8",
+                    stdio: "pipe",
+                });
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    message: `Failed to checkout branch ${options.branch}: ${error.message}`,
+                    updated: false,
+                };
+            }
+        }
+        // Build git pull command
+        let command = "git pull";
+        if (options.depth) {
+            command += ` --depth=${options.depth}`;
+        }
+        debugLogger?.log(`Executing: ${command} in ${options.path}`);
+        // Execute git pull
+        const output = execSync(command, {
+            cwd: options.path,
+            encoding: "utf-8",
+            stdio: "pipe",
+        });
+        const updated = !output.includes("Already up to date");
+        return {
+            success: true,
+            message: output.trim(),
+            updated,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            message: error.message || "Unknown error",
+            updated: false,
+        };
+    }
+}
+/**
+ * Verifies that the given path is a git repository
+ * @param repoPath - Path to verify
+ * @returns True if the path is a git repository, false otherwise
+ */
+async function verifyGitRepository(repoPath) {
+    try {
+        const gitDir = path.join(repoPath, ".git");
+        if (!fsSync.existsSync(gitDir)) {
+            return false;
+        }
+        // Verify with git command
+        execSync("git rev-parse --git-dir", {
+            cwd: repoPath,
+            encoding: "utf-8",
+            stdio: "pipe",
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+
 const EXCLUDED_STATS_ATTRS = new Set(["human-instruction", "title"]);
 const MAX_IMPORT_DEPTH = 10;
 /**
@@ -18286,6 +18410,7 @@ function setupProgram() {
         .option("--debug", "Enable debug logging")
         .option("--verbose", "Enable verbose logging (alias for --debug)")
         .option("--dry-run", "Preview input/output files without writing")
+        .option("-y, --yes", "Skip confirmation prompts (for pre-actions)")
         .action(async (options) => {
         await handleExtractCommand(options);
     });
@@ -18896,11 +19021,11 @@ async function handleExtractCommand(options) {
         await validateRecipeFilesExist(options.recipe);
         if (options.recipe.length === 1) {
             // Single recipe - maintain backward compatibility
-            await processRecipe(options.recipe[0], extractOptions, new ContentTracker(), debugLogger, options.baseDir, options.out, options.src);
+            await processRecipe(options.recipe[0], extractOptions, new ContentTracker(), debugLogger, options.baseDir, options.out, options.src, options.yes);
         }
         else {
             // Multiple recipes - process in order with auto-append
-            await processMultipleRecipes(options.recipe, extractOptions, debugLogger, options.baseDir, options.out, options.src);
+            await processMultipleRecipes(options.recipe, extractOptions, debugLogger, options.baseDir, options.out, options.src, options.yes);
         }
     }
     else {
@@ -18926,13 +19051,13 @@ async function handleStatsCommand(options) {
 /**
  * Processes multiple recipe files in the specified order
  */
-async function processMultipleRecipes(recipePaths, baseOptions, debugLogger, cliBaseDir, cliOutFile, cliSrc) {
+async function processMultipleRecipes(recipePaths, baseOptions, debugLogger, cliBaseDir, cliOutFile, cliSrc, yesFlag) {
     const contentTracker = new ContentTracker();
     debugLogger.log(`Processing ${recipePaths.length} recipes in order`);
     for (const recipePath of recipePaths) {
         try {
             debugLogger.log(`Starting processing of recipe: ${recipePath}`);
-            await processRecipe(recipePath, baseOptions, contentTracker, debugLogger, cliBaseDir, cliOutFile, cliSrc);
+            await processRecipe(recipePath, baseOptions, contentTracker, debugLogger, cliBaseDir, cliOutFile, cliSrc, yesFlag);
             debugLogger.log(`Completed processing of recipe: ${recipePath}`);
         }
         catch (error) {
@@ -19041,10 +19166,106 @@ async function processFrontmatterInheritance(frontmatter, srcDir, types, languag
     debugLogger?.log("Frontmatter after inheritance processing:", Object.keys(result));
     return result;
 }
+/**
+ * Executes pre-actions defined in a recipe file
+ */
+async function executePreActions(preActions, yesFlag, debugLogger) {
+    const pulledRepos = new Set();
+    console.log("[Pre-Action] Executing pre-actions...");
+    for (let i = 0; i < preActions.length; i++) {
+        const action = preActions[i];
+        if (action.type === "git-pull") {
+            await handleGitPullAction(action, pulledRepos, yesFlag, debugLogger);
+        }
+        else {
+            throw new Error(`Unknown pre-action type: ${action.type}`);
+        }
+    }
+    console.log("[Pre-Action] All pre-actions completed successfully");
+}
+/**
+ * Handles a git-pull pre-action
+ */
+async function handleGitPullAction(action, pulledRepos, yesFlag, debugLogger) {
+    // Check if git-pull should be skipped via environment variable
+    if (process.env.SKIP_GIT_PULL === "true" || process.env.SKIP_GIT_PULL === "1") {
+        console.log(`[Pre-Action] Skipping git-pull (SKIP_GIT_PULL=${process.env.SKIP_GIT_PULL})`);
+        debugLogger?.log(`Git-pull skipped due to SKIP_GIT_PULL environment variable`);
+        return;
+    }
+    // Expand environment variables in path
+    const expandedPath = resolvePath(action.path);
+    const normalizedPath = path.normalize(path.resolve(expandedPath));
+    console.log(`[Pre-Action] Executing git-pull for: ${normalizedPath}`);
+    // Check for duplicate pull
+    if (pulledRepos.has(normalizedPath)) {
+        console.log(`[Pre-Action] Skipping git-pull for: ${normalizedPath} (already pulled)`);
+        debugLogger?.log(`Skipping duplicate git-pull: ${normalizedPath}`);
+        return;
+    }
+    // Confirmation prompt (unless -y flag is set)
+    if (!yesFlag) {
+        const confirmed = await promptConfirmation(normalizedPath, action.branch);
+        if (!confirmed) {
+            throw new Error("Pre-action cancelled by user");
+        }
+    }
+    else {
+        console.log(`[Pre-Action] Auto-confirmed (--yes flag)`);
+    }
+    // Execute git pull
+    console.log("[Pre-Action] Pulling latest changes...");
+    const result = await executeGitPull({
+        path: normalizedPath,
+        branch: action.branch,
+        depth: action.depth,
+        skipOnError: action["skip-on-error"] ?? false,
+    }, debugLogger);
+    if (result.success) {
+        const statusMsg = result.updated
+            ? "✓ Git pull successful (changes pulled)"
+            : "✓ Git pull successful (no changes)";
+        console.log(`[Pre-Action] ${statusMsg}`);
+        debugLogger?.log(`Git pull result: ${result.message}`);
+    }
+    else {
+        const errorMsg = `✗ Error: ${result.message}`;
+        console.error(`[Pre-Action] ${errorMsg}`);
+        if (!action["skip-on-error"]) {
+            throw new Error(`Pre-action failed: ${result.message}`);
+        }
+        else {
+            console.warn("[Pre-Action] Continuing despite error (skip-on-error: true)");
+        }
+    }
+    // Mark this repo as pulled
+    pulledRepos.add(normalizedPath);
+}
+/**
+ * Prompts the user for confirmation before executing git pull
+ */
+async function promptConfirmation(repoPath, branch) {
+    console.log("[Pre-Action] Git pull confirmation required:");
+    console.log(`  Repository: ${repoPath}`);
+    if (branch) {
+        console.log(`  Branch: ${branch}`);
+    }
+    console.log("");
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question("Continue? (y/N): ", (answer) => {
+            rl.close();
+            resolve(answer.toLowerCase() === "y");
+        });
+    });
+}
 /**
  * Processes a recipe file with multiple extract operations
  */
-async function processRecipe(recipePath, baseOptions, contentTracker, debugLogger, cliBaseDir, cliOutFile, cliSrc) {
+async function processRecipe(recipePath, baseOptions, contentTracker, debugLogger, cliBaseDir, cliOutFile, cliSrc, yesFlag) {
     const resolvedPath = resolveRecipePath(recipePath);
     debugLogger?.log(`Processing recipe at path: ${resolvedPath}`);
     try {
@@ -19055,6 +19276,10 @@ async function processRecipe(recipePath, baseOptions, contentTracker, debugLogge
         if (!Array.isArray(data?.recipe)) {
             throw new Error("Invalid recipe file: 'recipe' array not found");
         }
+        // Execute pre-actions if defined
+        if (data["pre-action"] && Array.isArray(data["pre-action"])) {
+            await executePreActions(data["pre-action"], yesFlag || false, debugLogger);
+        }
         // Validate recipe structure and show warnings
         debugLogger?.time("Recipe validation");
         try {

package/dist/recipeValidator.d.ts

@@ -17,6 +17,7 @@ export declare class RecipeValidator {
     private getHelpfulMessageForProperty;
     private isCommonMistake;
     private checkCommonMistakes;
+    private validatePreActions;
 }
 export declare function getRecipeValidator(): Promise<RecipeValidator>;
 //# sourceMappingURL=recipeValidator.d.ts.map

package/dist/recipeValidator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recipeValidator.d.ts","sourceRoot":"","sources":["../src/recipeValidator.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,MAAM,CAAM;;IAWd,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBjC;;OAEG;IACH,OAAO,CAAC,eAAe;IAsBvB,cAAc,CAAC,UAAU,EAAE,GAAG,GAAG,gBAAgB;IA0CjD,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,4BAA4B;IAYpC,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,mBAAmB;CAyC5B;AAKD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC,CAMnE"}
+{"version":3,"file":"recipeValidator.d.ts","sourceRoot":"","sources":["../src/recipeValidator.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,MAAM,CAAM;;IAWd,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBjC;;OAEG;IACH,OAAO,CAAC,eAAe;IAsBvB,cAAc,CAAC,UAAU,EAAE,GAAG,GAAG,gBAAgB;IA0CjD,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,4BAA4B;IAYpC,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,mBAAmB;IAmD3B,OAAO,CAAC,kBAAkB;CA+B3B;AAKD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC,CAMnE"}

package/dist/recipeValidator.js

@@ -131,6 +131,15 @@ export class RecipeValidator {
         return commonMistakeProps.includes(property);
     }
     checkCommonMistakes(recipeData, result) {
+        // Validate pre-action if present
+        if (recipeData['pre-action']) {
+            if (!Array.isArray(recipeData['pre-action'])) {
+                result.warnings.push('Warning: Pre-action should be an array');
+            }
+            else {
+                this.validatePreActions(recipeData['pre-action'], result);
+            }
+        }
         // Check for properties that should be under filters or frontmatter
         if (Array.isArray(recipeData.recipe)) {
             recipeData.recipe.forEach((item, index) => {
@@ -168,6 +177,33 @@ export class RecipeValidator {
             }
         });
     }
+    validatePreActions(preActions, result) {
+        for (let i = 0; i < preActions.length; i++) {
+            const action = preActions[i];
+            if (!action || typeof action !== 'object') {
+                result.warnings.push(`Warning: Pre-action item ${i + 1} should be an object`);
+                continue;
+            }
+            if (!action.type) {
+                result.warnings.push(`Warning: Pre-action item ${i + 1} is missing required 'type' field`);
+                continue;
+            }
+            if (action.type === 'git-pull') {
+                if (!action.path) {
+                    result.warnings.push(`Warning: Git-pull action ${i + 1} is missing required 'path' field`);
+                }
+                if (action.depth !== undefined && typeof action.depth !== 'number') {
+                    result.warnings.push(`Warning: Git-pull action ${i + 1}: 'depth' should be a number`);
+                }
+                if (action.depth !== undefined && action.depth < 1) {
+                    result.warnings.push(`Warning: Git-pull action ${i + 1}: 'depth' should be at least 1`);
+                }
+            }
+            else {
+                result.warnings.push(`Warning: Pre-action item ${i + 1} has unknown type: ${action.type}`);
+            }
+        }
+    }
 }
 // Singleton instance
 let validatorInstance = null;

package/dist/utils/gitActions.d.ts

@@ -0,0 +1,25 @@
+export interface GitPullOptions {
+    path: string;
+    branch?: string;
+    depth?: number;
+    skipOnError?: boolean;
+}
+export interface GitPullResult {
+    success: boolean;
+    message: string;
+    updated: boolean;
+}
+/**
+ * Executes git pull in the specified repository
+ * @param options - Configuration for the git pull operation
+ * @param debugLogger - Optional debug logger
+ * @returns Result of the git pull operation
+ */
+export declare function executeGitPull(options: GitPullOptions, debugLogger?: any): Promise<GitPullResult>;
+/**
+ * Verifies that the given path is a git repository
+ * @param repoPath - Path to verify
+ * @returns True if the path is a git repository, false otherwise
+ */
+export declare function verifyGitRepository(repoPath: string): Promise<boolean>;
+//# sourceMappingURL=gitActions.d.ts.map

package/dist/utils/gitActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitActions.d.ts","sourceRoot":"","sources":["../../src/utils/gitActions.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,WAAW,CAAC,EAAE,GAAG,GAChB,OAAO,CAAC,aAAa,CAAC,CA2DxB;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAkB5E"}

package/dist/utils/gitActions.js

@@ -0,0 +1,88 @@
+import { execSync } from "child_process";
+import fs from "fs";
+import path from "path";
+/**
+ * Executes git pull in the specified repository
+ * @param options - Configuration for the git pull operation
+ * @param debugLogger - Optional debug logger
+ * @returns Result of the git pull operation
+ */
+export async function executeGitPull(options, debugLogger) {
+    try {
+        // Verify it's a git repository
+        const isRepo = await verifyGitRepository(options.path);
+        if (!isRepo) {
+            return {
+                success: false,
+                message: "Path is not a git repository",
+                updated: false,
+            };
+        }
+        // Switch to target branch if specified
+        if (options.branch) {
+            try {
+                debugLogger?.log(`Switching to branch: ${options.branch}`);
+                execSync(`git checkout ${options.branch}`, {
+                    cwd: options.path,
+                    encoding: "utf-8",
+                    stdio: "pipe",
+                });
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    message: `Failed to checkout branch ${options.branch}: ${error.message}`,
+                    updated: false,
+                };
+            }
+        }
+        // Build git pull command
+        let command = "git pull";
+        if (options.depth) {
+            command += ` --depth=${options.depth}`;
+        }
+        debugLogger?.log(`Executing: ${command} in ${options.path}`);
+        // Execute git pull
+        const output = execSync(command, {
+            cwd: options.path,
+            encoding: "utf-8",
+            stdio: "pipe",
+        });
+        const updated = !output.includes("Already up to date");
+        return {
+            success: true,
+            message: output.trim(),
+            updated,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            message: error.message || "Unknown error",
+            updated: false,
+        };
+    }
+}
+/**
+ * Verifies that the given path is a git repository
+ * @param repoPath - Path to verify
+ * @returns True if the path is a git repository, false otherwise
+ */
+export async function verifyGitRepository(repoPath) {
+    try {
+        const gitDir = path.join(repoPath, ".git");
+        if (!fs.existsSync(gitDir)) {
+            return false;
+        }
+        // Verify with git command
+        execSync("git rev-parse --git-dir", {
+            cwd: repoPath,
+            encoding: "utf-8",
+            stdio: "pipe",
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aramassa/ai-rules",
-  "version": "0.4.3",
+  "version": "0.5.1",
   "description": "This repository collects guidelines and instructions for developing AI agents. It contains documents covering communication rules, coding standards, testing strategies, and general operational practices.",
   "workspaces": [
     "packages/extract",

package/schemas/recipe.schema.json

@@ -14,6 +14,53 @@
       },
       "additionalProperties": false
     },
+    "pre-action": {
+      "type": "array",
+      "description": "Actions to execute before processing recipe items",
+      "items": {
+        "type": "object",
+        "properties": {
+          "type": {
+            "type": "string",
+            "enum": ["git-pull"],
+            "description": "Type of pre-action to execute"
+          },
+          "path": {
+            "type": "string",
+            "description": "Path to the git repository (for git-pull action)"
+          },
+          "branch": {
+            "type": "string",
+            "description": "Specific branch to pull (optional)"
+          },
+          "depth": {
+            "type": "number",
+            "minimum": 1,
+            "description": "Shallow clone depth (optional)"
+          },
+          "skip-on-error": {
+            "type": "boolean",
+            "description": "Whether to continue on error (default: false)"
+          }
+        },
+        "required": ["type"],
+        "allOf": [
+          {
+            "if": {
+              "properties": {
+                "type": {
+                  "const": "git-pull"
+                }
+              }
+            },
+            "then": {
+              "required": ["path"]
+            }
+          }
+        ],
+        "additionalProperties": false
+      }
+    },
     "recipe": {
       "type": "array",
       "description": "Array of recipe items",