/**
 * @akson/cortex-doc-standards - Rules Engine for CLAUDE.md Integration
 *
 * Provides a declarative way to include doc-standards rules in project CLAUDE.md files
 * with conditional loading and auto-detection support
 */
import type { ConditionalProjectRulesConfig, RuleDetectionResult } from './types/conditional-rules';
export interface RuleConfig {
    /** Rule identifier */
    id: string;
    /** Whether this rule is enabled */
    enabled: boolean;
    /** Custom variables for rule templates */
    variables?: Record<string, string>;
    /** Custom overrides for rule content */
    overrides?: {
        title?: string;
        content?: string;
        append?: string;
    };
}
export interface ProjectRulesConfig {
    /** Project name for context */
    projectName: string;
    /** Project type for specialized rules */
    projectType: 'nextjs' | 'flutter' | 'backend' | 'shopify' | 'monorepo' | 'other';
    /** Rules to include in CLAUDE.md */
    rules: RuleConfig[];
    /** Global variables available to all rules */
    globalVariables?: Record<string, string>;
    /** Custom templates to include in CLAUDE.md */
    templates?: Record<string, {
        id: string;
        title: string;
        content: string;
    }>;
}
export type { ConditionalRuleConfig, ConditionalProjectRulesConfig, ConditionalRuleDefinition, RuleDetectionResult, EnablementMode } from './types/conditional-rules';
/**
 * Built-in rule templates that can be referenced by projects
 */
export declare const BUILT_IN_RULES: {
    readonly 'project-workflow': {
        readonly id: "project-workflow";
        readonly title: "📋 Project Workflow Integration";
        readonly template: "## 📋 Project Workflow Integration\n\n**IMPORTANT**: GitHub issue tracking and shared package management patterns.\n\n### GitHub Implementation Workflow\n1. **Read issue description** and understand implementation tasks\n2. **Update issue description** to mark checkboxes complete `[x]` as you implement\n3. **Use `gh issue edit`** to update body directly - NEVER use comments for progress\n4. **Reference issues in commits**: \"fix: authentication (closes #35)\"\n\n### Required Commands\n```bash\ngh issue view 1                  # Read current issue state\ngh issue edit 1 --body \"$(cat updated-issue.md)\"  # Update description\n```\n\n### Issue Structure Format\n```markdown\n## Implementation Checklist\n- [x] ~~Task 1: Setup auth~~ ✅ DONE\n- [ ] Task 2: Add validation **IN PROGRESS**\n- [ ] Tests: Unit tests for auth\n\n**Status**: In Progress (1/3 complete)\n**Last Updated**: 2025-09-12\n```\n\n### Shared Package Modification (Cortex Packages)\n**ALWAYS modify the package directly** when functionality missing/insufficient.\n\n```bash\n# 1. Navigate to package\ncd /Users/antoineschaller/GitHub/cortex-packages/packages/[name]\n\n# 2. Implement changes following existing patterns\n\n# 3. Publish\nnpm run build\ngit add . && git commit -m \"feat: description\"\nnpm version patch && npm publish\ngit push origin main --tags\n\n# 4. Update project\ncd /path/to/project\n{package.manager} add {packages.namespace}/[package-name]@latest\n```\n\n### Modification Guidelines\n- **Extend existing APIs** rather than breaking them\n- **Test thoroughly** before publishing\n- **Use semantic versioning**: patch (fixes), minor (features), major (breaking)\n- **Document new features** - Update README, JSDoc\n\n### When to Modify\n✅ **DO**: Props/features don't exist, bugs, performance improvements\n❌ **DON'T**: Create local workarounds - fix root issue in package\n\n**Remember**: Issue descriptions are single source of truth. Cortex packages are shared foundations.";
        readonly description: "GitHub Projects workflow and shared package management standards";
        readonly variables: {
            readonly 'packages.namespace': "Package namespace (e.g., @akson)";
            readonly 'package.manager': "Package manager command (pnpm, npm)";
        };
    };
    readonly 'security-standards': {
        readonly id: "security-standards";
        readonly title: "🔒 Security Standards";
        readonly template: "## 🔒 Security Standards\n\n**CRITICAL**: All security practices must be followed without exception.\n\n### Secrets Management\n- **NEVER commit secrets, passwords, or API keys to the repository**\n- **Use environment variables** for all sensitive configuration\n- **Use `{secrets.manager}`** for production secret storage\n- **Rotate secrets regularly** according to security policy\n\n### Authentication & Authorization\n- **Implement proper RBAC** using the centralized role system\n- **Use `{auth.method}`** for user authentication\n- **Validate all user inputs** against XSS, SQL injection, and other attacks\n- **Implement rate limiting** on all API endpoints\n\n### Data Protection\n- **Encrypt sensitive data** both at rest and in transit\n- **Use HTTPS** for all communications\n- **Implement proper CORS** policies\n- **Log security events** for monitoring and audit\n\n### Code Security\n- **Run security scans** before deployment: `{security.scanCommand}`\n- **Keep dependencies updated** to patch known vulnerabilities\n- **Use static analysis tools** to detect security issues\n- **Follow OWASP** security guidelines for web applications";
        readonly description: "Core security standards and practices";
        readonly variables: {
            readonly 'secrets.manager': "Secrets management system (e.g., 1Password, AWS Secrets)";
            readonly 'auth.method': "Authentication method (e.g., Supabase Auth, Auth0)";
            readonly 'security.scanCommand': "Security scan command (e.g., npm audit, snyk test)";
        };
    };
    readonly 'testing-standards': {
        readonly id: "testing-standards";
        readonly title: "🧪 Testing Standards";
        readonly template: "## 🧪 Testing Standards\n\n**MANDATORY**: All code changes must include appropriate tests.\n\n### Test Coverage Requirements\n- **Unit tests**: Minimum {coverage.unit}% coverage for utilities and business logic\n- **Integration tests**: All API endpoints and data flows\n- **E2E tests**: Critical user journeys and workflows\n\n### Testing Commands\n```bash\n{test.unit}                    # Run unit tests\n{test.integration}             # Run integration tests\n{test.e2e}                     # Run end-to-end tests\n{test.watch}                   # Run tests in watch mode\n{test.coverage}                # Generate coverage report\n```\n\n### Test Structure\n- **Location**: Tests adjacent to source files or in `{test.directory}`\n- **Naming**: `*.test.{test.extension}` or `*.spec.{test.extension}`\n- **Organization**: Group related tests in describe blocks\n\n### Quality Gates\n- **All tests must pass** before merging to main branch\n- **No reduction in coverage** without explicit approval\n- **Performance tests** for critical paths and APIs";
        readonly description: "Testing requirements and standards";
        readonly variables: {
            readonly 'coverage.unit': "Minimum unit test coverage percentage";
            readonly 'test.unit': "Unit test command";
            readonly 'test.integration': "Integration test command";
            readonly 'test.e2e': "E2E test command";
            readonly 'test.watch': "Watch mode test command";
            readonly 'test.coverage': "Coverage report command";
            readonly 'test.directory': "Test files directory";
            readonly 'test.extension': "Test file extension";
        };
    };
    readonly 'claude-essentials': {
        readonly id: "claude-essentials";
        readonly title: "🤖 Claude Essentials";
        readonly template: "## 🤖 Claude Essentials\n\n**CRITICAL**: Core behavior rules for effective AI-assisted development.\n\n### Communication & Response Style\n- **Be concise, direct, to the point** - 1-3 sentences when possible, avoid preambles\n- **Address only the specific task** - No tangential information unless critical\n- **Prioritize technical accuracy** over emotional validation\n- **Reference specific locations** using `file_path:line_number` format\n\n### Tool Usage Patterns\n- **Use TodoWrite VERY frequently** for multi-step tasks (3+ steps)\n- **Mark exactly ONE task in_progress** at a time, complete immediately after finishing\n- **Always use Read tool first** before editing any existing file\n- **ALWAYS prefer editing existing files** over creating new ones\n\n### Code Quality Workflow\n- **First understand file conventions** before making changes\n- **Check `{package.file}`** dependencies before assuming libraries available\n- **Use existing utilities/components** rather than creating duplicates\n- **Use ONLY `{translation.function}`** for user-facing text - never hardcode strings\n- **Never introduce code that exposes secrets/keys**\n\n### Development Process\n1. **Research existing codebase** using search tools (Grep, Glob, Read)\n2. **Mark current todo as in_progress** before starting work\n3. **Follow existing code style** and naming conventions\n4. **Run quality checks**: `{lint.command}`, `{typecheck.command}`, `{test.command}`\n5. **Update documentation** if APIs changed\n\n**Remember**: Quality, accuracy, and following established patterns over speed.";
        readonly description: "Core Claude AI behavior and workflow fundamentals";
        readonly variables: {
            readonly 'package.file': "Package configuration file (package.json, Cargo.toml, etc.)";
            readonly 'translation.function': "Internationalization function name (e.g., t, __, translate)";
            readonly 'lint.command': "Linting command (npm run lint, eslint, etc.)";
            readonly 'typecheck.command': "Type checking command (tsc, mypy, etc.)";
            readonly 'test.command': "Test command (npm test, pytest, etc.)";
        };
    };
    readonly 'code-standards': {
        readonly id: "code-standards";
        readonly title: "🔧 Code Standards";
        readonly template: "## 🔧 Code Standards\n\n**CRITICAL**: Quality and naming standards that must never be compromised.\n\n### Quality Gates (Never Bypass)\n- **NEVER use `--no-verify`** on git commits or pre-commit hooks\n- **NEVER disable/bypass tests** when failing - fix them immediately\n- **NEVER skip linting/type-checking** when errors present\n- **NEVER set `ignoreBuildErrors: true`** in build configurations\n- **NEVER use `@ts-ignore`** as permanent solution\n- **NEVER commit broken code** with intention to \"fix later\"\n\n### File Naming: kebab-case\n**MANDATORY**: `address-input.tsx`, `phone-input.tsx`, `team-account-layout-sidebar.tsx`\n**NEVER**: `AddressInput.tsx` (PascalCase), `phoneInput.tsx` (camelCase), `phone_input.tsx` (snake_case)\n\n### Component Exports: PascalCase\n```typescript\n// File: address-input.tsx\nexport function AddressInput() { ... }\n```\n\n### Directory Structure: Feature-Based\n✅ **Correct**: `features/auth/components/`, `features/dancers/components/`\n❌ **Wrong**: `src/components/`, `src/types/`, `src/utils/`\n\n### Component Structure Template\n```typescript\n'use client'; // If client component\n// 1. React imports, 2. Third-party imports, 3. Internal UI, 4. Feature imports\n// 5. Type definitions, 6. Component implementation\n```\n\n### Naming Rules Summary\n1. **Files**: kebab-case, 2. **Components**: PascalCase, 3. **Variables/Functions**: camelCase\n4. **Constants**: SCREAMING_SNAKE_CASE, 5. **Types/Interfaces**: PascalCase\n\n### Documentation Organization (AI Best Practice)\n\n**CRITICAL**: Core documentation MUST use numbered prefixes for clear reading order.\n\n#### Numbered Documentation Structure\n```\ndocs/\n├── 01-OVERVIEW.md          # Project fundamentals (read first)\n├── 02-ARCHITECTURE.md      # System design\n├── 03-SECURITY.md          # Security patterns\n├── 04-DATABASE.md          # Data layer\n├── 05-API_DESIGN.md        # API conventions\n├── 06-TESTING.md           # Quality assurance\n├── 07-DEPLOYMENT.md        # Production deployment\n├── 08-MONITORING.md        # Observability\n└── 09+                     # Additional specialized domains\n```\n\n**Why This Matters for AI**:\n- ✅ Creates predictable learning path for AI sessions\n- ✅ Reduces cognitive load in large codebases\n- ✅ Makes cross-references explicit (\"as discussed in 01-OVERVIEW\")\n- ✅ Enables efficient context building in new sessions\n- ✅ Establishes clear information hierarchy\n\n**Format Rules**:\n- **01-08**: Reserved for core documentation\n- **09+**: Available for specialized domains\n- **Format**: `NN-TOPIC.md` (two digits, ALL_CAPS topic)\n- **Archive docs**: No numbering required (docs/archive/)\n\n### Version Suffix Prohibition\n\n**CRITICAL**: NEVER create new files/functions/types with version suffixes. Always modify the original.\n\n#### Forbidden Suffixes (NEVER USE)\n**Strictly prohibited** in all names (files, functions, components, types, variables):\n- **Versions**: `v2`, `V2`, `new`, `old`, `legacy`, `2`, `II`\n- **Quality**: `enhanced`, `improved`, `better`, `optimized`, `simplified`, `modern`\n- **State**: `updated`, `modified`, `refactored`, `revised`, `extended`\n- **Temporary**: `temp`, `tmp`, `draft`, `test`, `backup`, `copy`\n- **Singles**: `single`, `singles`, `simple`\n\n#### Instead, Do This\n❌ **WRONG**: `validateUserEnhanced()`, `UserProfileV2`, `ButtonNew.tsx`, `modernDashboard.tsx`, `singleUserView.tsx`\n✅ **CORRECT**: Replace original or use descriptive names: `validateUser()`, `PublicUserProfile`, `IconButton.tsx`, `dashboard.tsx`, `userView.tsx`\n\n**Remember**: Fix problems properly the first time. Quality is built in, not added later.";
        readonly description: "Core code quality and naming standards including strict version suffix prohibition";
        readonly variables: {};
    };
    readonly 'version-suffix-prohibition': {
        readonly id: "version-suffix-prohibition";
        readonly title: "🚫 Version Suffix Prohibition";
        readonly template: "## 🚫 Version Suffix Prohibition\n\n**CRITICAL**: NEVER create new files/functions/types with version suffixes. Always modify the original.\n\n### Forbidden Suffixes (NEVER USE)\n**Strictly prohibited** in all names (files, functions, components, types, variables):\n- **Versions**: `v2`, `V2`, `new`, `old`, `legacy`, `2`, `II`\n- **Quality**: `enhanced`, `improved`, `better`, `optimized`, `simplified`, `modern`\n- **State**: `updated`, `modified`, `refactored`, `revised`, `extended`\n- **Temporary**: `temp`, `tmp`, `draft`, `test`, `backup`, `copy`\n- **Singles**: `single`, `singles`, `simple`\n\n### Instead, Do This\n❌ **WRONG**: `validateUserEnhanced()`, `UserProfileV2`, `ButtonNew.tsx`, `modernDashboard.tsx`, `singleUserView.tsx`\n✅ **CORRECT**: Replace original or use descriptive names: `validateUser()`, `PublicUserProfile`, `IconButton.tsx`, `dashboard.tsx`, `userView.tsx`\n\n**Remember**: Fix problems properly the first time. Quality is built in, not added later.";
        readonly description: "Comprehensive version suffix prohibition to prevent code duplication and maintain clean codebases";
        readonly variables: {};
    };
    readonly 'makerkit-complete': {
        readonly id: "makerkit-complete";
        readonly title: "🛠️ MakerKit Complete";
        readonly template: "## 🛠️ MakerKit Complete\n\n**CRITICAL**: Comprehensive MakerKit development guide. Use when project built on MakerKit framework.\n\n### 🚨 Discovery First - ASK BEFORE BUILDING\nBefore creating any component/hook/utility:\n1. **Search MakerKit first** using MCP server tools\n2. **Ask user**: \"MakerKit might have this. Should I check first?\"\n3. **Only proceed** after confirmation MakerKit doesn't have it\n\n### 🔍 MCP Discovery Commands\n```bash\nget_components                    # List all available components\ncomponents_search \"keyword\"       # Search by functionality (button, form, auth, upload)\nget_component_props \"component\"   # Analyze component props and variants\nget_schema_files                  # List database schemas\n```\n\n### 📦 Key Packages & Imports\n**Core**: @kit/ui (80+ components), @kit/supabase (DB/auth), @kit/shared (utilities)\n**Features**: @kit/auth, @kit/accounts, @kit/team-accounts, @kit/admin\n\n```typescript\n// Essential imports\nimport { useSupabase } from '@kit/supabase/hooks/use-supabase'\nimport { useUser } from '@kit/supabase/hooks/use-user'\nimport { getSupabaseServerClient } from '@kit/supabase/server-client'\nimport { Button } from '@kit/ui/button'\nimport { toast } from '@kit/ui/sonner'\nimport { useUserWorkspace } from '@kit/accounts/hooks/use-user-workspace'\nimport { useTeamAccountWorkspace } from '@kit/team-accounts/hooks/use-team-account-workspace'\n```\n\n### 🚀 Turborepo Development Commands\n```bash\n# Core Development\n`{dev.command}`                        # Start all applications\n`{dev.filter}`           # Start main SaaS app (port 3000)\n`{build.command}`                      # Build with caching\n`{lint.command}` && `{typecheck.command}`     # Quality checks\n\n# Database Operations\n`{db.start}`         # Start local Supabase\n`{db.reset}`         # Reset DB + apply migrations\n`{db.typegen}`       # Generate TypeScript types\n\n# Package Development\n`{package.build}`     # Build specific package\n`{package.add}`    # Add dependency to specific app\n```\n\n### 🏗️ Multi-Tenant Architecture\n**Account Types**: Personal (auth.users.id = accounts.id), Team (shared workspaces)\n\n```typescript\n// Workspace Context\nimport { useUserWorkspace } from '@kit/accounts/hooks/use-user-workspace'\nimport { useTeamAccountWorkspace } from '@kit/team-accounts/hooks/use-team-account-workspace'\nconst { data: workspace } = useUserWorkspace() // or useTeamAccountWorkspace()\n\n// Authentication Patterns\n// Server Components\nconst client = getSupabaseServerClient()\nconst user = await getCurrentUser(client)\nif (!user) redirect('/login')\n\n// Client Components\nconst user = useUser()\nif (!user) return <LoginPrompt />\n```\n\n### 🚧 Data Isolation (CRITICAL)\n```typescript\n// ✅ CORRECT - Always filter by account\nconst { data } = await supabase.from('notes').select('*').eq('account_id', workspace.account.id)\n\n// ❌ WRONG - Missing account filter\nconst { data } = await supabase.from('notes').select('*')\n```\n\n### 📝 Form & Data Patterns\n**Stack**: Zod schemas → React Hook Form → Server Actions → Account isolation\n\n```typescript\n// Schema Definition\nexport const CreateNoteSchema = z.object({\n  title: z.string().min(1, 'Required'),\n  content: z.string().min(1, 'Required'),\n})\n\n// Server Action (Account-Aware)\nexport async function createNoteAction(data: unknown) {\n  const client = getSupabaseServerClient()\n  const user = await getCurrentUser(client)\n  if (!user) throw new Error('Unauthorized')\n\n  const workspace = await loadAccountWorkspace()\n  const parsed = CreateNoteSchema.parse(data)\n\n  return client.from('notes').insert({\n    ...parsed,\n    account_id: workspace.account.id, // Account isolation\n    created_by: user.id,\n  }).select().single()\n}\n\n// Client Form\nconst form = useForm<CreateNoteInput>({\n  resolver: zodResolver(CreateNoteSchema),\n  defaultValues: { title: '', content: '' },\n})\n```\n\n### 🗄️ Database Types Integration\n```typescript\n// ✅ CORRECT - MakerKit pattern for custom schemas\nimport type { Database } from '@/types/database.types'\nconst supabase = useSupabase<Database>() // Pass custom types to MakerKit\nconst supabaseServer = getSupabaseServerClient<Database>()\n\n// ❌ WRONG - Don't create separate clients\n// const supabase = createBrowserClient<Database>(url, key)\n```\n\n### ❌ NEVER Build Custom\n- Custom Supabase client setup\n- UI components when @kit/ui equivalents exist\n- Workspace/account context providers\n- File upload when FileUploader exists\n- Admin guards when AdminGuard exists\n\n### 🔄 Extend, Don't Replace\n```typescript\nimport { Button } from '@kit/ui/button'\nimport { cn } from '@kit/ui/utils'\n\nexport function CustomButton({ specialFeature, ...props }) {\n  return <Button {...props} className={cn(props.className, specialFeature && 'special')} />\n}\n```\n\n### 🚨 Critical Rules\n**NEVER**: Use `npm` instead of ``{package.manager}``, query without account_id filter, bypass RLS policies\n**ALWAYS**: Use ``{package.filter}``, filter by account_id, use workspace context hooks\n\n**Goal**: Find 90%+ functionality in MakerKit before building custom. Every table needs account_id for isolation.";
        readonly description: "Comprehensive MakerKit framework development patterns and best practices";
        readonly variables: {
            readonly 'dev.command': "Development start command (pnpm dev, npm run dev)";
            readonly 'dev.filter': "Filtered dev command (pnpm --filter web dev)";
            readonly 'build.command': "Build command (pnpm build, npm run build)";
            readonly 'lint.command': "Linting command (pnpm lint, npm run lint)";
            readonly 'typecheck.command': "Type checking command (pnpm typecheck)";
            readonly 'db.start': "Database start command (pnpm supabase:start)";
            readonly 'db.reset': "Database reset command (pnpm supabase:reset)";
            readonly 'db.typegen': "Type generation command (pnpm supabase:typegen)";
            readonly 'package.build': "Package build command (pnpm --filter @kit/ui build)";
            readonly 'package.add': "Package add command (pnpm --filter web add lodash)";
            readonly 'package.manager': "Package manager (pnpm, npm)";
            readonly 'package.filter': "Package filter prefix (pnpm --filter)";
        };
    };
    readonly 'secrets-management': {
        readonly id: "secrets-management";
        readonly title: "🔐 Secrets Management";
        readonly template: "## 🔐 Secrets Management\n\n**CRITICAL**: Comprehensive guide for managing secrets and sensitive configuration using {secrets.manager}.\n\n### {secrets.manager} Setup\n\n#### Installation & Authentication\n```bash\n# Install {secrets.manager} CLI\n{install.command}\n\n# Authenticate\n{auth.command}\n```\n\n#### Local Development Setup\n```bash\n# Load secrets for development\n{load.command}\n\n# Verify secrets loaded\n{verify.command}\n```\n\n### Environment Variables Structure\n```bash\n# Required secrets\n{required.secrets}\n\n# Optional configuration\n{optional.config}\n```\n\n### CI/CD Integration\n```yaml\n# GitHub Actions example\n- name: Load secrets\n  run: {ci.load.command}\n  env:\n    {ci.env.variables}\n```\n\n### Security Best Practices\n- **NEVER** commit .env files to version control\n- **ALWAYS** use {secrets.manager} for production secrets\n- **ROTATE** secrets every {rotation.period}\n- **AUDIT** access logs regularly via {audit.command}\n- **USE** different secrets per environment\n\n### Emergency Procedures\n1. **Revoke compromised secret**: `{revoke.command}`\n2. **Rotate all secrets**: `{rotate.command}`\n3. **Audit access**: `{audit.command}`\n4. **Update dependencies**: `{update.command}`\n\n### Supported Secret Types\n- API Keys: {api.keys.path}\n- Database Credentials: {db.creds.path}\n- OAuth Tokens: {oauth.path}\n- Service Accounts: {service.accounts.path}";
        readonly description: "Secrets and sensitive configuration management";
        readonly variables: {
            readonly 'secrets.manager': "Secrets management tool (1Password, Vault, AWS Secrets Manager)";
            readonly 'install.command': "Installation command for secrets manager";
            readonly 'auth.command': "Authentication command";
            readonly 'load.command': "Command to load secrets";
            readonly 'verify.command': "Command to verify secrets";
            readonly 'required.secrets': "List of required secret variables";
            readonly 'optional.config': "Optional configuration variables";
            readonly 'ci.load.command': "CI/CD command to load secrets";
            readonly 'ci.env.variables': "CI/CD environment variables";
            readonly 'rotation.period': "Secret rotation period (e.g., 90 days)";
            readonly 'audit.command': "Audit command";
            readonly 'revoke.command': "Revoke secret command";
            readonly 'rotate.command': "Rotate secrets command";
            readonly 'update.command': "Update dependencies command";
            readonly 'api.keys.path': "Path for API keys";
            readonly 'db.creds.path': "Path for database credentials";
            readonly 'oauth.path': "Path for OAuth tokens";
            readonly 'service.accounts.path': "Path for service accounts";
        };
    };
    readonly 'api-documentation': {
        readonly id: "api-documentation";
        readonly title: "📡 API Documentation";
        readonly template: "## 📡 API Documentation\n\n**CRITICAL**: Comprehensive API documentation and integration guide.\n\n### API Overview\n- **Base URL**: {api.base.url}\n- **Version**: {api.version}\n- **Protocol**: {api.protocol}\n- **Format**: {api.format}\n\n### Authentication\n```{auth.language}\n{auth.example}\n```\n\n**Token Type**: {auth.type}\n**Token Location**: {auth.location}\n**Token Expiry**: {auth.expiry}\n\n### Rate Limiting\n- **Requests per {rate.window}**: {rate.limit}\n- **Rate Limit Header**: {rate.header}\n- **Retry After**: {rate.retry}\n\n### Common Endpoints\n\n#### {endpoint1.name}\n- **Method**: {endpoint1.method}\n- **Path**: `{endpoint1.path}`\n- **Description**: {endpoint1.description}\n\nRequest:\n```json\n{endpoint1.request}\n```\n\nResponse:\n```json\n{endpoint1.response}\n```\n\n#### {endpoint2.name}\n- **Method**: {endpoint2.method}\n- **Path**: `{endpoint2.path}`\n- **Description**: {endpoint2.description}\n\n### Error Handling\n```json\n{\n  \"error\": {\n    \"code\": \"{error.code}\",\n    \"message\": \"{error.message}\",\n    \"details\": \"{error.details}\"\n  }\n}\n```\n\n### SDK/Client Libraries\n- **JavaScript/TypeScript**: `{sdk.js}`\n- **Python**: `{sdk.python}`\n- **Go**: `{sdk.go}`\n- **Other**: {sdk.other}\n\n### Webhooks\n- **Endpoint**: {webhook.endpoint}\n- **Events**: {webhook.events}\n- **Verification**: {webhook.verification}\n\n### API Testing\n```bash\n# Test with curl\n{test.curl}\n\n# Test with httpie\n{test.httpie}\n```\n\n### OpenAPI/Swagger\n- **Specification**: {openapi.url}\n- **Interactive Docs**: {swagger.url}";
        readonly description: "API documentation and integration patterns";
        readonly variables: {
            readonly 'api.base.url': "API base URL";
            readonly 'api.version': "API version";
            readonly 'api.protocol': "API protocol (REST, GraphQL, gRPC)";
            readonly 'api.format': "Data format (JSON, XML, etc.)";
            readonly 'auth.language': "Authentication example language";
            readonly 'auth.example': "Authentication code example";
            readonly 'auth.type': "Authentication type (Bearer, API Key, OAuth)";
            readonly 'auth.location': "Token location (Header, Query, Cookie)";
            readonly 'auth.expiry': "Token expiry time";
            readonly 'rate.window': "Rate limit time window";
            readonly 'rate.limit': "Rate limit number";
            readonly 'rate.header': "Rate limit header name";
            readonly 'rate.retry': "Retry after time";
            readonly 'endpoint1.name': "First endpoint name";
            readonly 'endpoint1.method': "First endpoint HTTP method";
            readonly 'endpoint1.path': "First endpoint path";
            readonly 'endpoint1.description': "First endpoint description";
            readonly 'endpoint1.request': "First endpoint request example";
            readonly 'endpoint1.response': "First endpoint response example";
            readonly 'endpoint2.name': "Second endpoint name";
            readonly 'endpoint2.method': "Second endpoint HTTP method";
            readonly 'endpoint2.path': "Second endpoint path";
            readonly 'endpoint2.description': "Second endpoint description";
            readonly 'error.code': "Error code example";
            readonly 'error.message': "Error message example";
            readonly 'error.details': "Error details example";
            readonly 'sdk.js': "JavaScript/TypeScript SDK package";
            readonly 'sdk.python': "Python SDK package";
            readonly 'sdk.go': "Go SDK package";
            readonly 'sdk.other': "Other SDK packages";
            readonly 'webhook.endpoint': "Webhook endpoint";
            readonly 'webhook.events': "Webhook events list";
            readonly 'webhook.verification': "Webhook verification method";
            readonly 'test.curl': "Curl test command";
            readonly 'test.httpie': "HTTPie test command";
            readonly 'openapi.url': "OpenAPI specification URL";
            readonly 'swagger.url': "Swagger UI URL";
        };
    };
    readonly 'readme-template': {
        readonly id: "readme-template";
        readonly title: "📖 README Template";
        readonly template: "# {project.name}\n\n{project.tagline}\n\n## 🚀 Quick Start\n\n### Prerequisites\n{prerequisites.list}\n\n### Installation\n```bash\n{install.commands}\n```\n\n### Development\n```bash\n{dev.commands}\n```\n\n### Build\n```bash\n{build.commands}\n```\n\n## 📁 Project Structure\n```\n{project.structure}\n```\n\n## 🔧 Configuration\n\n### Environment Variables\n```bash\n{env.variables}\n```\n\n### Configuration Files\n{config.files}\n\n## 🧪 Testing\n```bash\n# Unit tests\n{test.unit}\n\n# Integration tests\n{test.integration}\n\n# E2E tests\n{test.e2e}\n\n# Coverage\n{test.coverage}\n```\n\n## 📦 Deployment\n\n### {deploy.platform}\n```bash\n{deploy.commands}\n```\n\n## 🤝 Contributing\n\n### Development Process\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n### Code Style\n- {style.linter}: `{style.lint.command}`\n- {style.formatter}: `{style.format.command}`\n\n## 📝 Documentation\n- [API Documentation]({docs.api})\n- [User Guide]({docs.guide})\n- [Architecture]({docs.architecture})\n\n## 🛡️ Security\n{security.policy}\n\n## 📄 License\n{license.type} - See [LICENSE]({license.file}) for details\n\n## 🙏 Acknowledgments\n{acknowledgments}\n\n## 📞 Support\n- **Issues**: [GitHub Issues]({support.issues})\n- **Discussions**: [GitHub Discussions]({support.discussions})\n- **Email**: {support.email}";
        readonly description: "README.md template for project documentation";
        readonly variables: {
            readonly 'project.name': "Project name";
            readonly 'project.tagline': "Project tagline/description";
            readonly 'prerequisites.list': "List of prerequisites";
            readonly 'install.commands': "Installation commands";
            readonly 'dev.commands': "Development commands";
            readonly 'build.commands': "Build commands";
            readonly 'project.structure': "Project directory structure";
            readonly 'env.variables': "Environment variables list";
            readonly 'config.files': "Configuration files description";
            readonly 'test.unit': "Unit test command";
            readonly 'test.integration': "Integration test command";
            readonly 'test.e2e': "E2E test command";
            readonly 'test.coverage': "Coverage test command";
            readonly 'deploy.platform': "Deployment platform name";
            readonly 'deploy.commands': "Deployment commands";
            readonly 'style.linter': "Linter tool name";
            readonly 'style.lint.command': "Lint command";
            readonly 'style.formatter': "Formatter tool name";
            readonly 'style.format.command': "Format command";
            readonly 'docs.api': "API documentation URL";
            readonly 'docs.guide': "User guide URL";
            readonly 'docs.architecture': "Architecture docs URL";
            readonly 'security.policy': "Security policy description";
            readonly 'license.type': "License type";
            readonly 'license.file': "License file path";
            readonly acknowledgments: "Acknowledgments text";
            readonly 'support.issues': "GitHub issues URL";
            readonly 'support.discussions': "GitHub discussions URL";
            readonly 'support.email': "Support email address";
        };
    };
};
/**
 * Enhanced Rules Engine with conditional loading and auto-detection support
 */
export declare class RulesEngine {
    private config;
    private detector?;
    private detectionResults?;
    constructor(config: ProjectRulesConfig | ConditionalProjectRulesConfig, projectPath?: string);
    /**
     * Generate CLAUDE.md content based on configured rules with auto-detection support
     */
    generateClaudeContent(): Promise<string>;
    /**
     * Process rules with auto-detection
     */
    private processRulesWithAutoDetection;
    /**
     * Resolve a rule by ID, handling legacy mappings
     */
    private resolveRule;
    /**
     * Get auto-detection results for debugging/reporting
     */
    getDetectionResults(): RuleDetectionResult[];
    /**
     * Process a rule template with variables and overrides
     */
    private processRuleTemplate;
    /**
     * Replace template variables in content
     */
    private replaceVariables;
    /**
     * Validate rule configuration with conditional rules support
     */
    static validateConfig(config: ProjectRulesConfig | ConditionalProjectRulesConfig): {
        isValid: boolean;
        errors: string[];
        warnings: string[];
    };
    /**
     * Migrate deprecated rule configurations to new format
     */
    static migrateDeprecatedRules(config: ProjectRulesConfig): ProjectRulesConfig;
    /**
     * Generate a sample rules configuration with conditional rules support
     */
    static generateSampleConfig(projectName: string, projectType: ProjectRulesConfig['projectType'], useConditionalRules?: boolean): ProjectRulesConfig | ConditionalProjectRulesConfig;
    /**
     * Generate a sample conditional rules configuration
     */
    static generateConditionalSampleConfig(projectName: string, projectType: ProjectRulesConfig['projectType']): ConditionalProjectRulesConfig;
    /**
     * Generate a legacy sample rules configuration for backward compatibility
     */
    static generateLegacySampleConfig(projectName: string, projectType: ProjectRulesConfig['projectType']): ProjectRulesConfig;
}
/**
 * CLI-friendly function to generate CLAUDE.md from a configuration file with auto-detection
 */
export declare function generateClaudeFromConfig(configPath: string, outputPath?: string, projectPath?: string): Promise<void>;
//# sourceMappingURL=rules-engine.d.ts.map