eslint-plugin-ai-guard 1.1.11 → 1.1.12

package/README.md

@@ -57,6 +57,29 @@ This writes:
 Your AI tools will now avoid these patterns before you even run the linter.
 Use `--force` to regenerate after upgrading to a new version with new rules.
 
+## 🤖 Set Up AI Agent Rules
+
+Generate instruction files so Claude Code, Cursor, and GitHub Copilot
+automatically avoid the 17 most common AI-generated anti-patterns:
+
+```bash
+npx ai-guard init-context
+```
+
+Follow the prompts to select your agent(s). Or generate all at once:
+
+```bash
+npx ai-guard init-context --all
+```
+
+This writes:
+- `CLAUDE.md` — read automatically by Claude Code
+- `.cursorrules` — read automatically by Cursor
+- `.github/copilot-instructions.md` — read automatically by GitHub Copilot
+
+Your AI tools will now avoid these patterns before you even run the linter.
+Use `--force` to regenerate after upgrading to a new version with new rules.
+
 ## 🧪 Real-World Usage Philosophy
 
 `ai-guard` is designed for production adoption in existing codebases:

package/dist/cli/index.js

@@ -1772,6 +1772,30 @@ var SECTION_MAP = {
 function getSections(categories) {
   return categories.map((cat) => SECTION_MAP[cat]()).join("\n\n");
 }
+function workflowGuidanceMarkdown() {
+  return `## Workflow Guardrails
+- Follow user and repository instructions first; apply these rules on top.
+- Reuse existing project patterns and libraries before introducing new abstractions.
+- If a rule must be bypassed intentionally, add a suppression comment with reason:
+  \`ai-guard-disable <rule-name> -- reason: <why>\`.
+- Before finalizing changes, run tests/lint and \`ai-guard run\` when available.`;
+}
+function workflowGuidanceCursor() {
+  return `## Workflow Guardrails
+
+- Follow user and repository instructions first.
+- Prefer existing project patterns and dependencies.
+- If bypassing a rule intentionally, add: ai-guard-disable <rule-name> -- reason: <why>.
+- Validate generated code with tests/lint and ai-guard run when available.`;
+}
+function workflowGuidanceCopilot() {
+  return `## Required Workflow
+
+- Follow user and repository instructions first.
+- Prefer edits that match existing architecture and dependencies.
+- If intentionally violating an ai-guard rule, add an inline suppression with a reason.
+- Run tests/lint and \`ai-guard run\` before finalizing changes when possible.`;
+}
 function generateClaudeFile(version, categories) {
   return `<!-- DO NOT EDIT MANUALLY \u2014 generated by eslint-plugin-ai-guard -->
 <!-- Regenerate: npx ai-guard init-context --force -->
@@ -1781,6 +1805,8 @@ function generateClaudeFile(version, categories) {
 You are coding in a project that uses eslint-plugin-ai-guard.
 Avoid generating the following patterns. They will be flagged as lint errors.
 
+${workflowGuidanceMarkdown()}
+
 ${getSections(categories)}
 
 ---
@@ -1877,6 +1903,8 @@ anti-patterns generated by AI coding tools. Follow these rules when
 generating or editing code in this project. Violations will be flagged
 as lint errors.
 
+${workflowGuidanceCursor()}
+
 ${sections}
 
 ---
@@ -1978,6 +2006,8 @@ function generateCopilotFile(version, categories) {
 This project uses \`eslint-plugin-ai-guard\`. Follow these rules to avoid
 generating patterns that will be flagged as lint errors.
 
+${workflowGuidanceCopilot()}
+
 ## Quick Reference
 
 ${copilotQuickRef(categories)}
@@ -2041,10 +2071,19 @@ function parseCategories(raw) {
   }
   return valid.length > 0 ? valid : ALL_CATEGORIES;
 }
+function normalizeSelectedAgents(raw) {
+  if (Array.isArray(raw)) {
+    return raw.filter((value) => typeof value === "string");
+  }
+  if (typeof raw === "string") {
+    return [raw];
+  }
+  return [];
+}
 function registerInitContextCommand(program2) {
   program2.command("init-context").description(
     "Generate AI agent instruction files (CLAUDE.md, .cursorrules, copilot-instructions.md)\nso Claude Code, Cursor, and GitHub Copilot avoid the 17 most common AI anti-patterns."
-  ).option("--all", "Generate files for all agents (skip prompt)").option("--force", "Overwrite existing files without asking").option("--dry-run", "Print what would be generated without writing files").option("--rules <categories>", "Comma-separated categories: async,security,error-handling,quality").action(async (opts) => {
+  ).option("-a, --all", "Generate files for all agents (skip prompt)").option("--force", "Overwrite existing files without asking").option("--dry-run", "Print what would be generated without writing files").option("--rules <categories>", "Comma-separated categories: async,security,error-handling,quality").action(async (opts) => {
     const cwd = process.cwd();
     const version = getPackageVersion2(cwd);
     const categories = parseCategories(opts.rules);
@@ -2059,23 +2098,39 @@ function registerInitContextCommand(program2) {
     if (opts.all) {
       selectedAgents = [...AGENTS];
     } else {
-      const response = await (0, import_prompts2.default)({
-        type: "multiselect",
-        name: "agents",
-        message: "Which AI agents do you use?",
-        choices: [
-          { title: "Claude Code", value: "claude", description: "\u2192 writes CLAUDE.md" },
-          { title: "Cursor", value: "cursor", description: "\u2192 writes .cursorrules" },
-          { title: "GitHub Copilot", value: "copilot", description: "\u2192 writes .github/copilot-instructions.md" },
-          { title: "All three (recommended)", value: "all", description: "\u2192 writes all files" }
-        ],
-        hint: "- space to select, enter to confirm"
-      });
-      if (!response.agents || response.agents.length === 0) {
-        log.info("No agents selected. Nothing to do.");
+      let wasCancelled = false;
+      const response = await (0, import_prompts2.default)(
+        {
+          type: "multiselect",
+          name: "agents",
+          message: "Which AI agents do you use?",
+          choices: [
+            { title: "Claude Code", value: "claude", description: "\u2192 writes CLAUDE.md" },
+            { title: "Cursor", value: "cursor", description: "\u2192 writes .cursorrules" },
+            { title: "GitHub Copilot", value: "copilot", description: "\u2192 writes .github/copilot-instructions.md" },
+            { title: "All three (recommended)", value: "all", description: "\u2192 writes all files" }
+          ],
+          hint: "Space: select | Enter: confirm",
+          instructions: true,
+          min: 1,
+          warn: "Select at least one agent."
+        },
+        {
+          onCancel: () => {
+            wasCancelled = true;
+            return false;
+          }
+        }
+      );
+      if (wasCancelled) {
+        log.info("Selection cancelled. Nothing to do.");
+        return;
+      }
+      const selected = normalizeSelectedAgents(response.agents);
+      if (selected.length === 0) {
+        log.info("No valid agents selected. Use --all to generate all files.");
         return;
       }
-      const selected = response.agents;
       if (selected.includes("all")) {
         selectedAgents = [...AGENTS];
       } else {