@aramassa/ai-rules 0.1.2 → 0.1.5

package/dist/cli.js

@@ -10424,7 +10424,7 @@ function setupProgram() {
         .command('extract')
         .description('Extract and merge markdown files')
         .option('--src <path>', 'Source directory')
-        .option('--out <path>', 'Output file', './out/instruction.md')
+        .option('--out <path>', 'Output file')
         .option('--type <types>', 'Filter by type (comma-separated)')
         .option('--language <languages>', 'Filter by language (comma-separated)')
         .option('--attr <attributes>', 'Filter by attributes (comma-separated)')
@@ -10457,6 +10457,33 @@ function setupProgram() {
     });
     return program;
 }
+/**
+ * Recursively scans a directory for YAML files and returns their relative paths
+ */
+async function findYamlFilesRecursively(dir, baseDir = dir) {
+    const yamlFiles = [];
+    try {
+        const items = await fs.readdir(dir, { withFileTypes: true });
+        for (const item of items) {
+            const fullPath = path.join(dir, item.name);
+            if (item.isDirectory()) {
+                // Recursively scan subdirectories
+                const subFiles = await findYamlFilesRecursively(fullPath, baseDir);
+                yamlFiles.push(...subFiles);
+            }
+            else if (item.isFile() && (item.name.endsWith('.yaml') || item.name.endsWith('.yml'))) {
+                // Get relative path from base directory
+                const relativePath = path.relative(baseDir, fullPath);
+                yamlFiles.push(relativePath);
+            }
+        }
+    }
+    catch (error) {
+        // Log errors for individual directories/files that can't be read
+        console.warn(`Warning: Could not read directory "${dir}":`, error);
+    }
+    return yamlFiles;
+}
 /**
  * Lists available package presets
  */
@@ -10464,8 +10491,7 @@ async function listPresets() {
     const packageRoot = findPackageRoot();
     const presetsDir = path.join(packageRoot, 'presets');
     try {
-        const files = await fs.readdir(presetsDir);
-        const yamlFiles = files.filter(file => file.endsWith('.yaml') || file.endsWith('.yml'));
+        const yamlFiles = await findYamlFilesRecursively(presetsDir);
         if (yamlFiles.length === 0) {
             // eslint-disable-next-line no-console
             console.log('No presets found in package.');
@@ -10835,7 +10861,7 @@ async function handleExtractCommand(options) {
     });
     const extractOptions = {
         srcDir: resolveDefaultSrcDir(options.src),
-        outFile: options.out,
+        outFile: options.out || './out/instruction.md',
         types: parseCommaSeparated(options.type),
         languages: parseCommaSeparated(options.language),
         attrFilters: parseCommaSeparated(options.attr) || [],
@@ -10852,11 +10878,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);
+            await processRecipe(options.recipe[0], extractOptions, new ContentTracker(), debugLogger, options.baseDir, options.out);
         }
         else {
             // Multiple recipes - process in order with auto-append
-            await processMultipleRecipes(options.recipe, extractOptions, debugLogger, options.baseDir);
+            await processMultipleRecipes(options.recipe, extractOptions, debugLogger, options.baseDir, options.out);
         }
     }
     else {
@@ -10882,13 +10908,13 @@ async function handleStatsCommand(options) {
 /**
  * Processes multiple recipe files in the specified order
  */
-async function processMultipleRecipes(recipePaths, baseOptions, debugLogger, cliBaseDir) {
+async function processMultipleRecipes(recipePaths, baseOptions, debugLogger, cliBaseDir, cliOutFile) {
     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);
+            await processRecipe(recipePath, baseOptions, contentTracker, debugLogger, cliBaseDir, cliOutFile);
             debugLogger.log(`Completed processing of recipe: ${recipePath}`);
         }
         catch (error) {
@@ -10912,7 +10938,7 @@ async function loadTemplateFrontmatter(srcDir, types, languages, attrFilters, de
 }
 /**
  * Merges frontmatter values from multiple templates according to merge rules:
- * - Strings: concatenate with newlines
+ * - Strings: concatenate with newlines, removing duplicates while preserving order
  * - Arrays: combine all elements
  * - Objects: later values overwrite
  */
@@ -10928,7 +10954,19 @@ function mergeTemplateFrontmatterValues(templateFrontmatters, fieldName) {
     }
     // Check if all values are strings
     if (values.every(val => typeof val === 'string')) {
-        return values.join('\n');
+        // Split each string by newlines, flatten, remove duplicates while preserving order
+        const allLines = [];
+        const seen = new Set();
+        for (const value of values) {
+            const lines = value.split('\n').map(line => line.trim()).filter(line => line.length > 0);
+            for (const line of lines) {
+                if (!seen.has(line)) {
+                    seen.add(line);
+                    allLines.push(line);
+                }
+            }
+        }
+        return allLines.join('\n');
     }
     // Check if all values are arrays
     if (values.every(val => Array.isArray(val))) {
@@ -10985,7 +11023,7 @@ async function processFrontmatterInheritance(frontmatter, srcDir, types, languag
 /**
  * Processes a recipe file with multiple extract operations
  */
-async function processRecipe(recipePath, baseOptions, contentTracker, debugLogger, cliBaseDir) {
+async function processRecipe(recipePath, baseOptions, contentTracker, debugLogger, cliBaseDir, cliOutFile) {
     const resolvedPath = resolveRecipePath(recipePath);
     debugLogger?.log(`Processing recipe at path: ${resolvedPath}`);
     try {
@@ -11015,9 +11053,13 @@ async function processRecipe(recipePath, baseOptions, contentTracker, debugLogge
                 language: item.language,
                 mode: item.mode
             });
-            const itemOut = item.out || baseOptions.outFile;
+            // Priority: CLI --out option > recipe item.out > baseOptions.outFile default
+            const itemOut = cliOutFile || item.out || baseOptions.outFile;
             const outputFile = resolveOutputPath(itemOut, cliBaseDir, item._importBaseDir, recipeBaseDir, resolvedPath);
             debugLogger?.log(`Resolved output path: ${itemOut} -> ${outputFile}`, {
+                cliOutFile,
+                itemOut: item.out,
+                fallback: baseOptions.outFile,
                 cliBaseDir,
                 importBaseDir: item._importBaseDir,
                 recipeBaseDir
@@ -11142,3 +11184,5 @@ run().catch((error) => {
     console.error("Unhandled error:", error);
     process.exit(1);
 });
+
+export { findYamlFilesRecursively };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aramassa/ai-rules",
-  "version": "0.1.2",
+  "version": "0.1.5",
   "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",
@@ -24,8 +24,10 @@
     "start:cli": "node dist/cli.js",
     "start:dev:cli": "tsx src/cli.ts",
     "test": "vitest run --environment node test",
+    "test:ci": "vitest run --environment node",
     "test:all": "npm run test --workspaces",
-    "build": "npm run --ws build && tsc -p tsconfig.build.json",
+    "build": "npm run --ws build && tsc -p tsconfig.build.json && chmod +x dist/cli.js",
+    "build:ci": "npm run --ws build && tsc -p tsconfig.build.json && chmod +x dist/cli.js",
     "build:pkg:clean": "npm run --ws clean",
     "clean": "npm run build:pkg:clean && rm -rf dist",
     "root:build": "npm run build && if [ \"$NODE_ENV\" != \"test\" ]; then rollup -c && chmod +x dist/cli.js; fi"
@@ -51,7 +53,7 @@
     "@rollup/plugin-node-resolve": "^16.0.1",
     "@rollup/plugin-typescript": "^12.1.4",
     "@types/commander": "^2.12.0",
-    "@types/node": "^24.3.0",
+    "@types/node": "^24.5.2",
     "fast-glob": "^3.3.3",
     "gray-matter": "^4.0.3",
     "rollup": "^4.45.0",

package/presets/README.md

@@ -62,6 +62,31 @@ npx @aramassa/ai-rules extract --recipe presets/infrastructure-ansible.yaml --sr
 - DevOps・SRE関連プロジェクト
 - 設定管理・自動化プロジェクト
 
+### `chrome-extension.yaml`
+
+Chrome Extension（Manifest V3）開発プロジェクト向けの包括的なinstruction構成です。
+
+**含まれる内容:**
+
+- Chrome Extension Manifest V3 Development Rules - 現代的なChrome Extension開発のベストプラクティス
+- Code Quality Tools - JavaScript/Chrome Extension向けのコード品質管理
+- Package Management Rules - パッケージ管理とビルドプロセス
+- Git Rules - バージョン管理とワークフロー
+- Basic Communication Rules - 基本的なコミュニケーションルール
+
+**使用方法:**
+
+```bash
+npx @aramassa/ai-rules extract --recipe presets/chrome-extension.yaml --src artifact/instructions
+```
+
+**対象プロジェクト:**
+
+- Chrome Extension開発プロジェクト（Manifest V3）
+- JavaScript/TypeScriptベースのブラウザ拡張機能
+- Webブラウザの機能拡張・自動化プロジェクト
+- Service Worker、Content Scripts、Popup UIを含む複合アプリケーション
+
 ### `chatmodes.yaml`
 
 AI対話支援機能（chatmodes）をプロジェクトに統合するための設定です。
@@ -70,6 +95,7 @@ AI対話支援機能（chatmodes）をプロジェクトに統合するための
 
 - Instruction Improve Chatmode - プロジェクト指示の改善支援
 - Planning Chatmode - todo_plans作成支援
+- Bug Reproduce Chatmode - GitHub Issue バグ再現・調査・修正提案支援
 
 **使用方法:**
 

package/presets/chatmodes.yaml

@@ -19,3 +19,11 @@ recipe:
     type: chatmode
     filters:
       chatmode: planning
+  - title: Bug Reproduce Chatmode
+    frontmatter:
+      "@description": true
+      "@tools": true
+    out: Bug Reproduce.chatmode.md
+    type: chatmode
+    filters:
+      chatmode: bug-reproduce

package/presets/chrome-extension.yaml

@@ -0,0 +1,50 @@
+recipe:
+  - import: :basic
+  - title: Chrome Extension Manifest V3 - General Architecture & Security
+    frontmatter:
+      "@type": true
+      "@category": true
+      description: |
+        General architecture principles and security guidelines for Chrome Extension development.
+        Covers event-driven architecture, component separation, security best practices, 
+        development workflow, and debugging for modern Chrome extension development.
+      applyTo: "**/*"
+    out: ./.github/instructions/chrome-extension-general.instructions.md
+    type: development-rules
+    category: chrome-extension
+  - title: Chrome Extension Manifest V3 - Manifest Configuration
+    frontmatter:
+      "@type": true
+      "@category": true
+      description: |
+        Manifest V3 configuration rules and best practices for manifest.json files.
+        Covers required structure, permissions design, declarativeNetRequest API setup,
+        and security configurations specific to manifest files.
+      applyTo: "**/manifest.json"
+    out: ./.github/instructions/chrome-extension-manifest.instructions.md
+    type: development-rules
+    category: chrome-extension
+  - title: Chrome Extension Manifest V3 - JavaScript/Service Worker Patterns
+    frontmatter:
+      "@type": true
+      "@category": true
+      description: |
+        JavaScript and Service Worker implementation patterns for Chrome extensions.
+        Covers event-driven design, state management, message passing, content scripts,
+        Offscreen API, testing strategies, and performance optimization.
+      applyTo: "**/*.js"
+    out: ./.github/instructions/chrome-extension-javascript.instructions.md
+    type: development-rules
+    category: chrome-extension
+  - title: Chrome Extension Manifest V3 - HTML Structure Guidelines
+    frontmatter:
+      "@type": true
+      "@category": true
+      description: |
+        HTML structure and UI guidelines for Chrome extension development.
+        Covers popup HTML, options page, offscreen documents, security best practices,
+        and performance optimization for HTML components.
+      applyTo: "**/*.html"
+    out: ./.github/instructions/chrome-extension-html.instructions.md
+    type: development-rules
+    category: chrome-extension

package/presets/electron.yaml

@@ -0,0 +1,11 @@
+recipe:
+  - title: Electron Development Best Practices
+    frontmatter:
+      description: |
+        Comprehensive Electron development best practices emphasizing security-first and performance-by-design approaches for building secure, high-performance desktop applications.
+      applyTo: "**/*.{js,ts}"
+      framework: electron
+    out: ./.github/instructions/electron.instructions.md
+    src: artifact/instructions/rules/development/
+    type: development-rules
+    attr: "category=desktop-app,focus=electron"

package/presets/prompts/todo-planning.yaml

@@ -0,0 +1,8 @@
+recipe:
+  - title: "TODO Plans 作成ルール"
+    out: "./.github/prompts/todo_plans.prompt.md"
+    type: "prompt"
+    category: "todo-planning"
+    focus: "workflow-management"
+    frontmatter:
+      description: "プロジェクトのTODO計画を管理するためのワークフローとガイドライン"