@rigstate/rules-engine 0.6.0

package/src/types.ts

@@ -0,0 +1,122 @@
+/**
+ * Supported IDE providers for rules file generation.
+ * - cursor: .cursorrules + .cursor/rules/*.mdc
+ * - antigravity: .cursorrules + .cursor/rules/*.mdc (Cursor-compatible)
+ * - windsurf: .windsurfrules
+ * - vscode: .cursorrules + .cursor/rules/*.mdc
+ * - copilot: .github/copilot-instructions.md
+ * - generic: CONVENTIONS.md (universal markdown format)
+ */
+export type IDEProvider = 'cursor' | 'antigravity' | 'windsurf' | 'vscode' | 'copilot' | 'generic';
+
+/**
+ * Mapping of IDE providers to their respective rules file names.
+ * Centralized here to ensure consistency across all consumers.
+ */
+export const IDE_FILE_NAMES: Record<IDEProvider, string> = {
+    cursor: '.cursorrules',
+    antigravity: '.cursorrules',
+    windsurf: '.windsurfrules',
+    vscode: '.cursorrules',
+    copilot: '.github/copilot-instructions.md',
+    generic: 'CONVENTIONS.md'
+};
+
+// Dynamic Project Settings for variable injection
+export interface ProjectSettings {
+    lmax: number;           // Default: 400
+    lmax_ui: number;        // Default: 250
+    security_level: string; // STANDARD, STRICT, MINIMAL
+}
+
+export interface RuleFile {
+    path: string;       // E.g. ".cursor/rules/guardian.mdc" or "AGENTS.md"
+    content: string;    // Raw content (with frontmatter if .mdc)
+    metadata?: {
+        description?: string;
+        globs?: string[];
+        alwaysApply?: boolean;
+    };
+}
+
+export interface MultiFileRuleResult {
+    files: RuleFile[];
+    suggestedIde: IDEProvider;
+    version: string;
+}
+
+export interface RuleGenerationContext {
+    project: {
+        id: string;
+        name: string;
+        description?: string;
+        functional_spec?: {
+            projectDescription?: string;
+            coreProblem?: string;
+            targetAudience?: string;
+            featureList?: Array<{ name: string; description: string; priority: string }>;
+            keyInsights?: string[];
+        };
+        ambition_level?: string;
+        tenancy?: 'SINGLE' | 'MULTI_ORG';
+        monetization?: 'FREE' | 'SAAS';
+        compliance?: 'NONE' | 'GDPR' | 'HIPAA';
+        vibe?: 'CORPORATE' | 'CREATIVE' | 'BRUTALIST';
+        settings?: ProjectSettings;
+    };
+    stack: string[];
+    roadmap: Array<{
+        step_number: number;
+        title: string;
+        status: string;
+        sprint_focus?: string;
+        prompt_content?: string;
+        is_legacy?: boolean;
+    }>;
+    ide: IDEProvider;
+    legacyStats?: {
+        total: number;
+        legacyCount: number;
+        activeCount: number;
+    };
+    activeAgents?: Array<{
+        id: string;
+        key: string;
+        name: string;
+        job_title?: string;
+        content: string;
+        authority_level: number;
+        primary_mission?: string;
+        trigger_keywords?: string;
+    }>;
+    databaseMetadata?: TableMetadata[];
+}
+
+export interface TableMetadata {
+    table_name: string;
+    rls_enabled: boolean;
+    policy_count: number;
+    column_count: number;
+    has_id: boolean;
+    has_created_at: boolean;
+    has_updated_at: boolean;
+    has_user_id: boolean;
+    indexed_columns: string[];
+    foreign_keys: { column: string, target_table: string }[];
+}
+
+export interface AgentSkill {
+    name: string;
+    description: string;
+    specialist: string;
+    version: string;
+    governance: 'OPEN' | 'SOFT_LOCK' | 'HARD_LOCK';
+    content: string; // Markdown body
+    activation?: {
+        imports?: string[];
+        content?: string[];
+        files?: string[];
+        violation_id?: string;
+        metric_threshold?: number;
+    };
+}

package/src/utils/mdc.ts

@@ -0,0 +1,33 @@
+
+/**
+ * Utility to wrap markdown content with MDC (Modern Cursor) frontmatter.
+ */
+export function wrapMdc(
+    content: string,
+    metadata: {
+        description?: string;
+        globs?: string[];
+        alwaysApply?: boolean;
+    }
+): string {
+    const yaml: string[] = ['---'];
+
+    if (metadata.description) {
+        yaml.push(`description: "${metadata.description.replace(/"/g, '\\"')}"`);
+    }
+
+    if (metadata.globs && metadata.globs.length > 0) {
+        yaml.push('globs:');
+        for (const glob of metadata.globs) {
+            yaml.push(`  - "${glob}"`);
+        }
+    }
+
+    if (metadata.alwaysApply !== undefined) {
+        yaml.push(`alwaysApply: ${metadata.alwaysApply}`);
+    }
+
+    yaml.push('---');
+
+    return `${yaml.join('\n')}\n${content}`;
+}

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+    "compilerOptions": {
+        "target": "ES2020",
+        "module": "commonjs",
+        "declaration": true,
+        "outDir": "./dist",
+        "rootDir": "./src",
+        "strict": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true
+    },
+    "include": [
+        "src/**/*"
+    ],
+    "exclude": [
+        "node_modules"
+    ]
+}