@fozikio/reflex 0.1.1 → 0.2.0

package/README.md

@@ -185,11 +185,16 @@ const config: ReflexConfig = {
 };
 ```
 
+## Contributing
+
+See the [Contributing Guide](https://github.com/Fozikio/.github/blob/main/CONTRIBUTING.md). Report security issues via [SECURITY.md](https://github.com/Fozikio/.github/blob/main/SECURITY.md).
+
 ## Related Projects
 
 - [cortex-engine](https://github.com/Fozikio/cortex-engine) — Cognitive memory layer for AI agents (ships with Reflex rules)
 - [sigil](https://github.com/Fozikio/sigil) — Agent control surface
 - [fozikio.com](https://www.fozikio.com) — Documentation and guides
+- [r/fozikio](https://www.reddit.com/r/Fozikio/) — Community
 
 ## Background
 

package/dist/cli/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * reflex CLI — validate, test, and inspect safety rules.
+ *
+ * Usage:
+ *   reflex validate <rules-dir>           Validate all YAML rules for correctness
+ *   reflex list [rules-dir]               List loaded rules (includes core rules)
+ *   reflex test <rules-dir> <event-json>  Test an event against rules
+ *   reflex init [dir]                     Scaffold a rules directory with examples
+ *   reflex help                           Show this help message
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG"}

package/dist/cli/index.js

@@ -0,0 +1,383 @@
+#!/usr/bin/env node
+/**
+ * reflex CLI — validate, test, and inspect safety rules.
+ *
+ * Usage:
+ *   reflex validate <rules-dir>           Validate all YAML rules for correctness
+ *   reflex list [rules-dir]               List loaded rules (includes core rules)
+ *   reflex test <rules-dir> <event-json>  Test an event against rules
+ *   reflex init [dir]                     Scaffold a rules directory with examples
+ *   reflex help                           Show this help message
+ */
+import { readFile, mkdir, writeFile } from 'node:fs/promises';
+import { resolve, relative } from 'node:path';
+import { RuleEngine } from '../core/rule-engine.js';
+import { loadRuleFile, loadRuleDirectory } from '../core/rule-loader.js';
+import { CORE_RULES } from '../core/defaults.js';
+const HELP = `
+reflex — portable guardrails for any agent runtime
+
+Usage:
+  reflex validate <rules-dir>                  Validate YAML rules
+  reflex list [rules-dir]                      List all rules (core + custom)
+  reflex test <rules-dir> <event.json>         Test event against rules
+  reflex test <rules-dir> --event <type> [--field value ...]
+                                               Test inline event against rules
+  reflex init [dir]                            Scaffold example rules directory
+  reflex help                                  Show this help
+
+Options:
+  --var key=value       Set a template variable (repeatable)
+  --json                Output as JSON
+  --no-core             Exclude built-in core rules
+
+Examples:
+  reflex validate ./rules
+  reflex list ./rules --json
+  reflex test ./rules --event bash_command --command "rm -rf /"
+  reflex test ./rules event.json --var allowed_roots=D:/projects
+  reflex init ./my-rules
+`.trim();
+// --- Helpers ---
+function die(message) {
+    console.error(`Error: ${message}`);
+    process.exit(1);
+}
+function parseArgs(argv) {
+    const command = argv[0] ?? 'help';
+    const positionals = [];
+    const flags = {};
+    const vars = {};
+    let i = 1;
+    while (i < argv.length) {
+        const arg = argv[i];
+        if (arg === '--var' && argv[i + 1]) {
+            const [key, ...rest] = argv[i + 1].split('=');
+            if (key)
+                vars[key] = rest.join('=');
+            i += 2;
+        }
+        else if (arg.startsWith('--')) {
+            const name = arg.slice(2);
+            const next = argv[i + 1];
+            if (next && !next.startsWith('--')) {
+                flags[name] = next;
+                i += 2;
+            }
+            else {
+                flags[name] = true;
+                i += 1;
+            }
+        }
+        else {
+            positionals.push(arg);
+            i += 1;
+        }
+    }
+    return { command, positionals, flags, vars };
+}
+const SEVERITY_ORDER = {
+    critical: 0, high: 1, medium: 2, low: 3, info: 4,
+};
+const TIER_BADGE = {
+    core: '[core]', recommended: '[recommended]', custom: '[custom]',
+};
+const ACTION_SYMBOL = {
+    block: 'BLOCK', warn: 'WARN', log: 'LOG',
+};
+function formatRule(rule) {
+    const badge = TIER_BADGE[rule.tier] ?? rule.tier;
+    const action = ACTION_SYMBOL[rule.action] ?? rule.action;
+    const events = rule.events.join(', ');
+    const conditions = rule.conditions.map(c => `${c.field} ${c.op} "${c.pattern}"`).join(' AND ');
+    const disableable = rule.override.allow_disable ? 'yes' : 'no';
+    return [
+        `  ${rule.name} ${badge}`,
+        `    ${rule.description}`,
+        `    Action: ${action} | Severity: ${rule.severity} | Events: ${events}`,
+        `    Conditions: ${conditions}`,
+        `    Can disable: ${disableable}`,
+    ].join('\n');
+}
+function formatResult(result) {
+    const icon = result.action === 'block' ? 'BLOCKED' : result.action === 'warn' ? 'WARNING' : 'LOG';
+    return [
+        `  [${icon}] ${result.rule} (${result.severity})`,
+        `    ${result.message.trim()}`,
+        `    Matched: ${result.matched_conditions.join(', ')}`,
+    ].join('\n');
+}
+// --- Commands ---
+async function cmdValidate(dir, asJson) {
+    const absDir = resolve(dir);
+    const { readdir } = await import('node:fs/promises');
+    const { extname, join } = await import('node:path');
+    const errors = [];
+    const valid = [];
+    async function walk(d) {
+        const entries = await readdir(d, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = join(d, entry.name);
+            if (entry.isDirectory()) {
+                await walk(fullPath);
+            }
+            else if (entry.isFile() && (extname(entry.name) === '.yaml' || extname(entry.name) === '.yml')) {
+                try {
+                    const rule = await loadRuleFile(fullPath);
+                    // Validate required fields
+                    const missing = [];
+                    if (!rule.name)
+                        missing.push('name');
+                    if (!rule.events.length)
+                        missing.push('events');
+                    if (!rule.conditions.length)
+                        missing.push('conditions');
+                    if (!rule.message)
+                        missing.push('message');
+                    if (missing.length > 0) {
+                        errors.push({ file: relative(absDir, fullPath), error: `Missing fields: ${missing.join(', ')}` });
+                    }
+                    else {
+                        valid.push({ file: relative(absDir, fullPath), name: rule.name });
+                    }
+                }
+                catch (e) {
+                    errors.push({ file: relative(absDir, fullPath), error: String(e) });
+                }
+            }
+        }
+    }
+    await walk(absDir);
+    if (asJson) {
+        console.log(JSON.stringify({ valid: valid.length, errors: errors.length, details: { valid, errors } }, null, 2));
+    }
+    else {
+        console.log(`\nValidated ${valid.length + errors.length} rule files in ${dir}\n`);
+        if (valid.length > 0) {
+            console.log(`  ${valid.length} valid:`);
+            for (const v of valid)
+                console.log(`    OK  ${v.file} (${v.name})`);
+        }
+        if (errors.length > 0) {
+            console.log(`\n  ${errors.length} errors:`);
+            for (const e of errors)
+                console.log(`    ERR ${e.file}: ${e.error}`);
+        }
+        console.log('');
+    }
+    process.exit(errors.length > 0 ? 1 : 0);
+}
+async function cmdList(dir, includeCore, asJson) {
+    const rules = [];
+    if (includeCore) {
+        rules.push(...CORE_RULES);
+    }
+    if (dir) {
+        const customRules = await loadRuleDirectory(resolve(dir));
+        rules.push(...customRules);
+    }
+    if (rules.length === 0) {
+        console.log('No rules loaded.');
+        return;
+    }
+    // Sort by tier (core first), then severity
+    rules.sort((a, b) => {
+        const tierOrder = { core: 0, recommended: 1, custom: 2 };
+        const td = (tierOrder[a.tier] ?? 2) - (tierOrder[b.tier] ?? 2);
+        if (td !== 0)
+            return td;
+        return (SEVERITY_ORDER[a.severity] ?? 4) - (SEVERITY_ORDER[b.severity] ?? 4);
+    });
+    if (asJson) {
+        console.log(JSON.stringify(rules, null, 2));
+    }
+    else {
+        console.log(`\n${rules.length} rules loaded:\n`);
+        for (const rule of rules) {
+            console.log(formatRule(rule));
+            console.log('');
+        }
+    }
+}
+async function cmdTest(dir, eventSource, flags, vars, includeCore, asJson) {
+    // Build the event
+    let event;
+    if (eventSource && !eventSource.startsWith('--')) {
+        // It's a file path
+        const content = await readFile(resolve(eventSource), 'utf-8');
+        event = JSON.parse(content);
+    }
+    else {
+        // Build from flags
+        const eventType = flags['event'];
+        if (typeof eventType !== 'string') {
+            die('Provide an event JSON file or use --event <type> --field value');
+        }
+        event = { event: eventType };
+        for (const [key, value] of Object.entries(flags)) {
+            if (key === 'event' || key === 'json' || key === 'no-core')
+                continue;
+            event[key] = value;
+        }
+    }
+    // Load rules
+    const engine = new RuleEngine(vars);
+    if (includeCore)
+        engine.addRules(CORE_RULES);
+    const customRules = await loadRuleDirectory(resolve(dir));
+    engine.addRules(customRules);
+    // Evaluate
+    const results = engine.evaluate(event);
+    const blocks = results.filter(r => r.action === 'block');
+    const warnings = results.filter(r => r.action === 'warn');
+    const logs = results.filter(r => r.action === 'log');
+    if (asJson) {
+        console.log(JSON.stringify({
+            event,
+            allowed: blocks.length === 0,
+            blocks: blocks.length,
+            warnings: warnings.length,
+            logs: logs.length,
+            results,
+        }, null, 2));
+    }
+    else {
+        console.log(`\nTesting event: ${event.event}`);
+        for (const [key, value] of Object.entries(event)) {
+            if (key === 'event')
+                continue;
+            const display = typeof value === 'string' && value.length > 80 ? value.slice(0, 77) + '...' : value;
+            console.log(`  ${key}: ${display}`);
+        }
+        console.log('');
+        if (results.length === 0) {
+            console.log('  No rules triggered. Event is allowed.\n');
+        }
+        else {
+            if (blocks.length > 0) {
+                console.log(`  ${blocks.length} BLOCKED:`);
+                for (const r of blocks)
+                    console.log(formatResult(r));
+                console.log('');
+            }
+            if (warnings.length > 0) {
+                console.log(`  ${warnings.length} WARNINGS:`);
+                for (const r of warnings)
+                    console.log(formatResult(r));
+                console.log('');
+            }
+            if (logs.length > 0) {
+                console.log(`  ${logs.length} LOGGED:`);
+                for (const r of logs)
+                    console.log(formatResult(r));
+                console.log('');
+            }
+            const verdict = blocks.length > 0 ? 'BLOCKED' : 'ALLOWED';
+            console.log(`  Verdict: ${verdict}\n`);
+        }
+    }
+    process.exit(blocks.length > 0 ? 2 : 0);
+}
+async function cmdInit(dir) {
+    const absDir = resolve(dir);
+    await mkdir(absDir, { recursive: true });
+    const exampleRule = `name: warn-debug-code
+version: 1
+tier: recommended
+category: quality
+description: Warn when debug statements are left in code
+events: [file_write, file_edit]
+conditions:
+  - field: content
+    op: regex
+    pattern: "(console\\\\.log|debugger|TODO.*HACK)"
+action: warn
+severity: low
+message: "Debug code detected in {{file_path}}"
+override:
+  allow_disable: true
+  allow_downgrade: true
+`;
+    const blockExample = `name: block-env-commit
+version: 1
+tier: recommended
+category: safety
+description: Block writing secrets to .env files that might get committed
+events: [file_write]
+conditions:
+  - field: file_path
+    op: regex
+    pattern: "\\\\.env$"
+  - field: content
+    op: regex
+    pattern: "(API_KEY|SECRET|TOKEN|PASSWORD)\\\\s*=\\\\s*[^$]"
+action: block
+severity: high
+message: "Potential secret in {{file_path}} — use environment variables instead"
+override:
+  allow_disable: true
+  allow_downgrade: true
+`;
+    await writeFile(resolve(absDir, 'warn-debug-code.yaml'), exampleRule);
+    await writeFile(resolve(absDir, 'block-env-commit.yaml'), blockExample);
+    console.log(`\nInitialized reflex rules directory: ${dir}\n`);
+    console.log('  Created:');
+    console.log('    warn-debug-code.yaml   (recommended, quality)');
+    console.log('    block-env-commit.yaml  (recommended, safety)');
+    console.log('');
+    console.log('  Next steps:');
+    console.log('    reflex validate ' + dir);
+    console.log('    reflex list ' + dir);
+    console.log('    reflex test ' + dir + ' --event file_write --file_path app.ts --content "console.log(x)"');
+    console.log('');
+}
+// --- Main ---
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0) {
+        console.log(HELP);
+        process.exit(0);
+    }
+    const { command, positionals, flags, vars } = parseArgs(args);
+    const asJson = flags['json'] === true;
+    const includeCore = flags['no-core'] !== true;
+    switch (command) {
+        case 'validate': {
+            const dir = positionals[0];
+            if (!dir)
+                die('Usage: reflex validate <rules-dir>');
+            await cmdValidate(dir, asJson);
+            break;
+        }
+        case 'list': {
+            const dir = positionals[0];
+            await cmdList(dir, includeCore, asJson);
+            break;
+        }
+        case 'test': {
+            const dir = positionals[0];
+            if (!dir)
+                die('Usage: reflex test <rules-dir> [event.json] [--event <type> --field value]');
+            const eventSource = positionals[1];
+            await cmdTest(dir, eventSource, flags, vars, includeCore, asJson);
+            break;
+        }
+        case 'init': {
+            const dir = positionals[0] ?? './reflex-rules';
+            await cmdInit(dir);
+            break;
+        }
+        case 'help':
+        case '--help':
+        case '-h':
+            console.log(HELP);
+            break;
+        default:
+            die(`Unknown command: ${command}. Run "reflex help" for usage.`);
+    }
+}
+main().catch(e => {
+    console.error(e);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,58 +1,62 @@
-{
-  "name": "@fozikio/reflex",
-  "version": "0.1.1",
-  "description": "Portable guardrails for any agent runtime — safety rules as data, not code",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "bin": {
-    "reflex": "dist/cli/index.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "test": "vitest run"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "dependencies": {
-    "yaml": "^2.7.0"
-  },
-  "devDependencies": {
-    "@types/node": "^22.10.0",
-    "typescript": "^5.7.0",
-    "vitest": "^3.0.0"
-  },
-  "files": [
-    "dist",
-    "rules",
-    "LICENSE",
-    "README.md"
-  ],
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "keywords": [
-    "reflex",
-    "guardrails",
-    "safety",
-    "ai-agent",
-    "hooks",
-    "mcp"
-  ],
-  "license": "MIT",
-  "author": "Fozikio <hello@fozikio.com>",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Fozikio/reflex.git"
-  },
-  "homepage": "https://github.com/Fozikio/reflex#readme",
-  "funding": {
-    "type": "github",
-    "url": "https://github.com/sponsors/Fozikio"
-  }
-}
+{
+  "name": "@fozikio/reflex",
+  "version": "0.2.0",
+  "description": "Portable guardrails for any agent runtime — safety rules as data, not code",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "reflex": "dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "yaml": "^2.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "files": [
+    "dist",
+    "rules",
+    "LICENSE",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "keywords": [
+    "reflex",
+    "guardrails",
+    "safety",
+    "ai-agent",
+    "hooks",
+    "mcp",
+    "fozikio",
+    "rules-engine",
+    "agent-safety",
+    "yaml-rules"
+  ],
+  "license": "MIT",
+  "author": "Fozikio <hello@fozikio.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Fozikio/reflex.git"
+  },
+  "homepage": "https://github.com/Fozikio/reflex#readme",
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/idapixl"
+  }
+}