@mmnto/totem 0.17.0 → 0.18.0

package/dist/compiler.d.ts

@@ -0,0 +1,144 @@
+import { z } from 'zod';
+export declare const CompiledRuleSchema: z.ZodObject<{
+    /** SHA-256 hash (first 16 hex chars) of heading + body — detects edits */
+    lessonHash: z.ZodString;
+    /** Human-readable heading from the lesson (for diagnostics) */
+    lessonHeading: z.ZodString;
+    /** Regex pattern to match against added diff lines */
+    pattern: z.ZodString;
+    /** Human-readable violation message shown when the pattern matches */
+    message: z.ZodString;
+    /** Engine type — only 'regex' for MVP */
+    engine: z.ZodLiteral<"regex">;
+    /** ISO timestamp of when this rule was compiled */
+    compiledAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    lessonHash: string;
+    lessonHeading: string;
+    pattern: string;
+    message: string;
+    engine: "regex";
+    compiledAt: string;
+}, {
+    lessonHash: string;
+    lessonHeading: string;
+    pattern: string;
+    message: string;
+    engine: "regex";
+    compiledAt: string;
+}>;
+export type CompiledRule = z.infer<typeof CompiledRuleSchema>;
+export declare const CompiledRulesFileSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    rules: z.ZodArray<z.ZodObject<{
+        /** SHA-256 hash (first 16 hex chars) of heading + body — detects edits */
+        lessonHash: z.ZodString;
+        /** Human-readable heading from the lesson (for diagnostics) */
+        lessonHeading: z.ZodString;
+        /** Regex pattern to match against added diff lines */
+        pattern: z.ZodString;
+        /** Human-readable violation message shown when the pattern matches */
+        message: z.ZodString;
+        /** Engine type — only 'regex' for MVP */
+        engine: z.ZodLiteral<"regex">;
+        /** ISO timestamp of when this rule was compiled */
+        compiledAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        lessonHash: string;
+        lessonHeading: string;
+        pattern: string;
+        message: string;
+        engine: "regex";
+        compiledAt: string;
+    }, {
+        lessonHash: string;
+        lessonHeading: string;
+        pattern: string;
+        message: string;
+        engine: "regex";
+        compiledAt: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    version: 1;
+    rules: {
+        lessonHash: string;
+        lessonHeading: string;
+        pattern: string;
+        message: string;
+        engine: "regex";
+        compiledAt: string;
+    }[];
+}, {
+    version: 1;
+    rules: {
+        lessonHash: string;
+        lessonHeading: string;
+        pattern: string;
+        message: string;
+        engine: "regex";
+        compiledAt: string;
+    }[];
+}>;
+export type CompiledRulesFile = z.infer<typeof CompiledRulesFileSchema>;
+export interface Violation {
+    /** The rule that was violated */
+    rule: CompiledRule;
+    /** The file path from the diff where the violation occurred */
+    file: string;
+    /** The matching line content */
+    line: string;
+    /** 1-based line number within the diff hunk (approximate) */
+    lineNumber: number;
+}
+/** Hash a lesson's heading + body to detect changes since compilation. */
+export declare function hashLesson(heading: string, body: string): string;
+export interface RegexValidation {
+    valid: boolean;
+    reason?: string;
+}
+/**
+ * Validate that a pattern string is a syntactically valid RegExp
+ * and is not vulnerable to ReDoS (catastrophic backtracking).
+ */
+export declare function validateRegex(pattern: string): RegexValidation;
+interface DiffAddition {
+    file: string;
+    line: string;
+    lineNumber: number;
+}
+/**
+ * Extract added lines from a unified diff.
+ * Returns only lines that start with `+` (excluding `+++` file headers).
+ */
+export declare function extractAddedLines(diff: string): DiffAddition[];
+/**
+ * Apply compiled rules against added lines from a diff.
+ * Returns all violations found.
+ */
+export declare function applyRules(rules: CompiledRule[], diff: string): Violation[];
+/** Load compiled rules from a JSON file. Returns empty array if file missing or invalid. */
+export declare function loadCompiledRules(rulesPath: string): CompiledRule[];
+/** Save compiled rules to a JSON file. */
+export declare function saveCompiledRules(rulesPath: string, rules: CompiledRule[]): void;
+/** Schema for the structured JSON the LLM returns when compiling a lesson. */
+export declare const CompilerOutputSchema: z.ZodObject<{
+    compilable: z.ZodBoolean;
+    pattern: z.ZodOptional<z.ZodString>;
+    message: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    compilable: boolean;
+    pattern?: string | undefined;
+    message?: string | undefined;
+}, {
+    compilable: boolean;
+    pattern?: string | undefined;
+    message?: string | undefined;
+}>;
+export type CompilerOutput = z.infer<typeof CompilerOutputSchema>;
+/**
+ * Parse the LLM's compilation response. Extracts JSON from the response text,
+ * validates it, and returns the structured output or null if unparseable.
+ */
+export declare function parseCompilerResponse(response: string): CompilerOutput | null;
+export {};
+//# sourceMappingURL=compiler.d.ts.map

package/dist/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,kBAAkB;IAC7B,0EAA0E;;IAE1E,+DAA+D;;IAE/D,sDAAsD;;IAEtD,sEAAsE;;IAEtE,yCAAyC;;IAEzC,mDAAmD;;;;;;;;;;;;;;;;EAEnD,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,uBAAuB;;;QAhBlC,0EAA0E;;QAE1E,+DAA+D;;QAE/D,sDAAsD;;QAEtD,sEAAsE;;QAEtE,yCAAyC;;QAEzC,mDAAmD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASnD,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAIxE,MAAM,WAAW,SAAS;IACxB,iCAAiC;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMhE;AAID,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAY9D;AAID,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CA8C9D;AAID;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CA4B3E;AAID,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE,CAUnE;AAED,0CAA0C;AAC1C,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,IAAI,CAMhF;AAID,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAI/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAa7E"}

package/dist/compiler.js

@@ -0,0 +1,177 @@
+import * as crypto from 'node:crypto';
+import * as fs from 'node:fs';
+import safeRegex from 'safe-regex2';
+import { z } from 'zod';
+// ─── Schemas ─────────────────────────────────────────
+export const CompiledRuleSchema = z.object({
+    /** SHA-256 hash (first 16 hex chars) of heading + body — detects edits */
+    lessonHash: z.string(),
+    /** Human-readable heading from the lesson (for diagnostics) */
+    lessonHeading: z.string(),
+    /** Regex pattern to match against added diff lines */
+    pattern: z.string(),
+    /** Human-readable violation message shown when the pattern matches */
+    message: z.string(),
+    /** Engine type — only 'regex' for MVP */
+    engine: z.literal('regex'),
+    /** ISO timestamp of when this rule was compiled */
+    compiledAt: z.string(),
+});
+export const CompiledRulesFileSchema = z.object({
+    version: z.literal(1),
+    rules: z.array(CompiledRuleSchema),
+});
+// ─── Hashing ─────────────────────────────────────────
+const HASH_SLICE_LEN = 16;
+/** Hash a lesson's heading + body to detect changes since compilation. */
+export function hashLesson(heading, body) {
+    return crypto
+        .createHash('sha256')
+        .update(`${heading}\n${body}`)
+        .digest('hex')
+        .slice(0, HASH_SLICE_LEN);
+}
+/**
+ * Validate that a pattern string is a syntactically valid RegExp
+ * and is not vulnerable to ReDoS (catastrophic backtracking).
+ */
+export function validateRegex(pattern) {
+    try {
+        new RegExp(pattern);
+    }
+    catch {
+        return { valid: false, reason: 'invalid syntax' };
+    }
+    if (!safeRegex(pattern)) {
+        return { valid: false, reason: 'ReDoS vulnerability detected' };
+    }
+    return { valid: true };
+}
+/**
+ * Extract added lines from a unified diff.
+ * Returns only lines that start with `+` (excluding `+++` file headers).
+ */
+export function extractAddedLines(diff) {
+    const additions = [];
+    let currentFile = '';
+    let lineNum = 0;
+    for (const rawLine of diff.split('\n')) {
+        // Track current file from diff headers
+        // git quotes paths containing spaces: +++ "b/path with spaces/file.ts"
+        if (rawLine.startsWith('+++')) {
+            let pathPart = rawLine.slice(4); // strip "+++ "
+            // Strip surrounding quotes (git adds them for paths with spaces)
+            if (pathPart.startsWith('"') && pathPart.endsWith('"')) {
+                pathPart = pathPart.slice(1, -1);
+            }
+            // Strip the "b/" prefix git uses for the destination file
+            currentFile = pathPart.startsWith('b/') ? pathPart.slice(2) : pathPart;
+            continue;
+        }
+        // Parse hunk header for line numbers: @@ -X,Y +Z,W @@
+        const hunkMatch = rawLine.match(/^@@ -\d+(?:,\d+)? \+(\d+)/);
+        if (hunkMatch) {
+            lineNum = parseInt(hunkMatch[1], 10) - 1; // will be incremented on first line
+            continue;
+        }
+        // Skip diff metadata lines
+        if (rawLine.startsWith('---') || rawLine.startsWith('diff ') || rawLine.startsWith('index ')) {
+            continue;
+        }
+        // Count lines for position tracking
+        if (rawLine.startsWith('+')) {
+            lineNum++;
+            additions.push({
+                file: currentFile,
+                line: rawLine.slice(1), // strip the leading +
+                lineNumber: lineNum,
+            });
+        }
+        else if (!rawLine.startsWith('-')) {
+            // Context line (no prefix or space prefix) — increment line counter
+            lineNum++;
+        }
+    }
+    return additions;
+}
+// ─── Rule execution ──────────────────────────────────
+/**
+ * Apply compiled rules against added lines from a diff.
+ * Returns all violations found.
+ */
+export function applyRules(rules, diff) {
+    const additions = extractAddedLines(diff);
+    if (additions.length === 0 || rules.length === 0)
+        return [];
+    const violations = [];
+    for (const rule of rules) {
+        let re;
+        try {
+            re = new RegExp(rule.pattern);
+        }
+        catch {
+            // Skip invalid patterns (shouldn't happen if validation gate works)
+            continue;
+        }
+        for (const addition of additions) {
+            if (re.test(addition.line)) {
+                violations.push({
+                    rule,
+                    file: addition.file,
+                    line: addition.line,
+                    lineNumber: addition.lineNumber,
+                });
+            }
+        }
+    }
+    return violations;
+}
+// ─── File I/O ────────────────────────────────────────
+/** Load compiled rules from a JSON file. Returns empty array if file missing or invalid. */
+export function loadCompiledRules(rulesPath) {
+    if (!fs.existsSync(rulesPath))
+        return [];
+    try {
+        const raw = fs.readFileSync(rulesPath, 'utf-8');
+        const parsed = CompiledRulesFileSchema.parse(JSON.parse(raw));
+        return parsed.rules;
+    }
+    catch {
+        return [];
+    }
+}
+/** Save compiled rules to a JSON file. */
+export function saveCompiledRules(rulesPath, rules) {
+    const data = { version: 1, rules };
+    fs.writeFileSync(rulesPath, JSON.stringify(data, null, 2) + '\n', {
+        encoding: 'utf-8',
+        mode: 0o644,
+    });
+}
+// ─── LLM response parsing ───────────────────────────
+/** Schema for the structured JSON the LLM returns when compiling a lesson. */
+export const CompilerOutputSchema = z.object({
+    compilable: z.boolean(),
+    pattern: z.string().optional(),
+    message: z.string().optional(),
+});
+/**
+ * Parse the LLM's compilation response. Extracts JSON from the response text,
+ * validates it, and returns the structured output or null if unparseable.
+ */
+export function parseCompilerResponse(response) {
+    // Try to extract JSON from the response (LLMs often wrap in ```json blocks)
+    const jsonMatch = response.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+    const jsonStr = jsonMatch ? jsonMatch[1] : response.trim();
+    try {
+        const parsed = JSON.parse(jsonStr);
+        const result = CompilerOutputSchema.safeParse(parsed);
+        if (!result.success)
+            return null;
+        return result.data;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=compiler.js.map

package/dist/compiler.js.map

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

package/dist/compiler.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=compiler.test.d.ts.map

package/dist/compiler.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.test.d.ts","sourceRoot":"","sources":["../src/compiler.test.ts"],"names":[],"mappings":""}

package/dist/compiler.test.js

@@ -0,0 +1,259 @@
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { applyRules, extractAddedLines, hashLesson, loadCompiledRules, parseCompilerResponse, saveCompiledRules, validateRegex, } from './compiler.js';
+// ─── hashLesson ──────────────────────────────────────
+describe('hashLesson', () => {
+    it('returns a 16-char hex string', () => {
+        const hash = hashLesson('heading', 'body');
+        expect(hash).toMatch(/^[0-9a-f]{16}$/);
+    });
+    it('returns different hashes for different inputs', () => {
+        const h1 = hashLesson('heading1', 'body');
+        const h2 = hashLesson('heading2', 'body');
+        expect(h1).not.toBe(h2);
+    });
+    it('returns stable hashes for the same input', () => {
+        const h1 = hashLesson('heading', 'body');
+        const h2 = hashLesson('heading', 'body');
+        expect(h1).toBe(h2);
+    });
+});
+// ─── validateRegex ───────────────────────────────────
+describe('validateRegex', () => {
+    it('accepts a valid regex', () => {
+        expect(validateRegex('\\bfoo\\b')).toEqual({ valid: true });
+    });
+    it('accepts a simple string pattern', () => {
+        expect(validateRegex('console.log')).toEqual({ valid: true });
+    });
+    it('accepts a complex but safe pattern', () => {
+        // Anchored API key format — complex but not vulnerable
+        expect(validateRegex('^[A-Za-z0-9]{32,}$')).toEqual({ valid: true });
+    });
+    it('rejects an invalid regex', () => {
+        const result = validateRegex('[invalid');
+        expect(result.valid).toBe(false);
+        expect(result.reason).toBe('invalid syntax');
+    });
+    it('rejects unbalanced parentheses', () => {
+        const result = validateRegex('(unclosed');
+        expect(result.valid).toBe(false);
+        expect(result.reason).toBe('invalid syntax');
+    });
+    it('rejects ReDoS pattern: nested quantifiers (a+)+', () => {
+        const result = validateRegex('(a+)+$');
+        expect(result.valid).toBe(false);
+        expect(result.reason).toBe('ReDoS vulnerability detected');
+    });
+    it('rejects ReDoS pattern: nested character class quantifiers ([a-zA-Z]+)*', () => {
+        const result = validateRegex('([a-zA-Z]+)*');
+        expect(result.valid).toBe(false);
+        expect(result.reason).toBe('ReDoS vulnerability detected');
+    });
+    it('rejects ReDoS pattern: nested repetition (.*a){10}', () => {
+        const result = validateRegex('(.*a){10}');
+        expect(result.valid).toBe(false);
+        expect(result.reason).toBe('ReDoS vulnerability detected');
+    });
+});
+// ─── extractAddedLines ──────────────────────────────
+describe('extractAddedLines', () => {
+    it('extracts added lines from a unified diff', () => {
+        const diff = `diff --git a/src/foo.ts b/src/foo.ts
+index abc1234..def5678 100644
+--- a/src/foo.ts
++++ b/src/foo.ts
+@@ -1,3 +1,4 @@
+ const a = 1;
+-const b = 2;
++const b = 3;
++const c = 4;
+ const d = 5;
+`;
+        const additions = extractAddedLines(diff);
+        expect(additions).toHaveLength(2);
+        expect(additions[0]).toEqual({ file: 'src/foo.ts', line: 'const b = 3;', lineNumber: 2 });
+        expect(additions[1]).toEqual({ file: 'src/foo.ts', line: 'const c = 4;', lineNumber: 3 });
+    });
+    it('handles multiple files', () => {
+        const diff = `diff --git a/a.ts b/a.ts
+--- a/a.ts
++++ b/a.ts
+@@ -1,2 +1,3 @@
+ line1
++added in a
+ line2
+diff --git a/b.ts b/b.ts
+--- a/b.ts
++++ b/b.ts
+@@ -1,2 +1,3 @@
+ line1
++added in b
+ line2
+`;
+        const additions = extractAddedLines(diff);
+        expect(additions).toHaveLength(2);
+        expect(additions[0].file).toBe('a.ts');
+        expect(additions[1].file).toBe('b.ts');
+    });
+    it('returns empty array for empty diff', () => {
+        expect(extractAddedLines('')).toEqual([]);
+    });
+    it('handles quoted filenames with spaces', () => {
+        const diff = `diff --git "a/path with spaces/file.ts" "b/path with spaces/file.ts"
+--- "a/path with spaces/file.ts"
++++ "b/path with spaces/file.ts"
+@@ -1,2 +1,3 @@
+ line1
++added line
+ line2
+`;
+        const additions = extractAddedLines(diff);
+        expect(additions).toHaveLength(1);
+        expect(additions[0].file).toBe('path with spaces/file.ts');
+    });
+    it('returns empty array for deletion-only diff', () => {
+        const diff = `diff --git a/foo.ts b/foo.ts
+--- a/foo.ts
++++ b/foo.ts
+@@ -1,3 +1,2 @@
+ line1
+-removed
+ line2
+`;
+        expect(extractAddedLines(diff)).toEqual([]);
+    });
+});
+// ─── applyRules ──────────────────────────────────────
+describe('applyRules', () => {
+    const makeRule = (pattern, message) => ({
+        lessonHash: 'abc123',
+        lessonHeading: 'Test rule',
+        pattern,
+        message,
+        engine: 'regex',
+        compiledAt: new Date().toISOString(),
+    });
+    const diff = `diff --git a/src/app.ts b/src/app.ts
+--- a/src/app.ts
++++ b/src/app.ts
+@@ -1,3 +1,5 @@
+ import { foo } from './foo';
++import { error } from './errors';
++const result = npm.install('package');
+ export default foo;
+`;
+    it('detects a simple pattern violation', () => {
+        const rules = [makeRule('\\bnpm\\.install\\b', 'Do not call npm.install directly')];
+        const violations = applyRules(rules, diff);
+        expect(violations).toHaveLength(1);
+        expect(violations[0].rule.message).toBe('Do not call npm.install directly');
+        expect(violations[0].file).toBe('src/app.ts');
+    });
+    it('returns no violations when patterns do not match', () => {
+        const rules = [makeRule('\\byarn\\b', 'Do not use yarn')];
+        const violations = applyRules(rules, diff);
+        expect(violations).toHaveLength(0);
+    });
+    it('applies multiple rules', () => {
+        const rules = [
+            makeRule('\\bnpm\\b', 'Do not use npm'),
+            makeRule('\\berror\\b', 'Use err, not error'),
+        ];
+        const violations = applyRules(rules, diff);
+        expect(violations).toHaveLength(2);
+    });
+    it('skips rules with invalid patterns', () => {
+        const rules = [makeRule('[invalid', 'Bad pattern')];
+        const violations = applyRules(rules, diff);
+        expect(violations).toHaveLength(0);
+    });
+    it('returns empty for empty diff', () => {
+        const rules = [makeRule('anything', 'test')];
+        expect(applyRules(rules, '')).toEqual([]);
+    });
+    it('returns empty for empty rules', () => {
+        expect(applyRules([], diff)).toEqual([]);
+    });
+});
+// ─── loadCompiledRules / saveCompiledRules ───────────
+describe('compiled rules file I/O', () => {
+    let tmpDir;
+    beforeEach(() => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'totem-compiler-'));
+    });
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it('round-trips rules through save and load', () => {
+        const rulesPath = path.join(tmpDir, 'compiled-rules.json');
+        const rules = [
+            {
+                lessonHash: 'abc123def456',
+                lessonHeading: 'Use err not error',
+                pattern: '\\berror\\b',
+                message: 'Use err instead of error in catch blocks',
+                engine: 'regex',
+                compiledAt: '2026-03-08T12:00:00Z',
+            },
+        ];
+        saveCompiledRules(rulesPath, rules);
+        const loaded = loadCompiledRules(rulesPath);
+        expect(loaded).toEqual(rules);
+    });
+    it('returns empty array for missing file', () => {
+        const loaded = loadCompiledRules(path.join(tmpDir, 'nonexistent.json'));
+        expect(loaded).toEqual([]);
+    });
+    it('returns empty array for invalid JSON', () => {
+        const rulesPath = path.join(tmpDir, 'bad.json');
+        fs.writeFileSync(rulesPath, 'not valid json');
+        expect(loadCompiledRules(rulesPath)).toEqual([]);
+    });
+    it('returns empty array for wrong schema', () => {
+        const rulesPath = path.join(tmpDir, 'wrong.json');
+        fs.writeFileSync(rulesPath, JSON.stringify({ version: 99, rules: [] }));
+        expect(loadCompiledRules(rulesPath)).toEqual([]);
+    });
+});
+// ─── parseCompilerResponse ──────────────────────────
+describe('parseCompilerResponse', () => {
+    it('parses a valid compilable response', () => {
+        const response = JSON.stringify({
+            compilable: true,
+            pattern: '\\bnpm\\b',
+            message: 'Use pnpm instead of npm',
+        });
+        const result = parseCompilerResponse(response);
+        expect(result).toEqual({
+            compilable: true,
+            pattern: '\\bnpm\\b',
+            message: 'Use pnpm instead of npm',
+        });
+    });
+    it('parses a non-compilable response', () => {
+        const response = JSON.stringify({ compilable: false });
+        const result = parseCompilerResponse(response);
+        expect(result).toEqual({ compilable: false });
+    });
+    it('extracts JSON from a code fence', () => {
+        const response = `Here is the compiled rule:
+\`\`\`json
+{"compilable": true, "pattern": "console\\\\.log", "message": "Remove debug logging"}
+\`\`\``;
+        const result = parseCompilerResponse(response);
+        expect(result).not.toBeNull();
+        expect(result.compilable).toBe(true);
+        expect(result.pattern).toBe('console\\.log');
+    });
+    it('returns null for completely invalid output', () => {
+        expect(parseCompilerResponse('I cannot compile this lesson.')).toBeNull();
+    });
+    it('returns null for JSON with wrong schema', () => {
+        const response = JSON.stringify({ foo: 'bar' });
+        expect(parseCompilerResponse(response)).toBeNull();
+    });
+});
+//# sourceMappingURL=compiler.test.js.map

package/dist/compiler.test.js.map

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

package/dist/config-schema.d.ts

@@ -9,12 +9,12 @@ export declare const IngestTargetSchema: z.ZodObject<{
     type: z.ZodEnum<["code", "session_log", "spec"]>;
     strategy: z.ZodEnum<["typescript-ast", "markdown-heading", "session-log", "schema-file", "test-file"]>;
 }, "strip", z.ZodTypeAny, {
-    glob: string;
     type: "code" | "session_log" | "spec";
+    glob: string;
     strategy: "typescript-ast" | "markdown-heading" | "session-log" | "schema-file" | "test-file";
 }, {
-    glob: string;
     type: "code" | "session_log" | "spec";
+    glob: string;
     strategy: "typescript-ast" | "markdown-heading" | "session-log" | "schema-file" | "test-file";
 }>;
 export declare const OpenAIProviderSchema: z.ZodObject<{
@@ -154,12 +154,12 @@ export declare const TotemConfigSchema: z.ZodObject<{
         type: z.ZodEnum<["code", "session_log", "spec"]>;
         strategy: z.ZodEnum<["typescript-ast", "markdown-heading", "session-log", "schema-file", "test-file"]>;
     }, "strip", z.ZodTypeAny, {
-        glob: string;
         type: "code" | "session_log" | "spec";
+        glob: string;
         strategy: "typescript-ast" | "markdown-heading" | "session-log" | "schema-file" | "test-file";
     }, {
-        glob: string;
         type: "code" | "session_log" | "spec";
+        glob: string;
         strategy: "typescript-ast" | "markdown-heading" | "session-log" | "schema-file" | "test-file";
     }>, "many">;
     /** Embedding provider configuration (optional for Lite tier) */
@@ -246,8 +246,8 @@ export declare const TotemConfigSchema: z.ZodObject<{
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     targets: {
-        glob: string;
         type: "code" | "session_log" | "spec";
+        glob: string;
         strategy: "typescript-ast" | "markdown-heading" | "session-log" | "schema-file" | "test-file";
     }[];
     totemDir: string;
@@ -279,8 +279,8 @@ export declare const TotemConfigSchema: z.ZodObject<{
     }[] | undefined;
 }, {
     targets: {
-        glob: string;
         type: "code" | "session_log" | "spec";
+        glob: string;
         strategy: "typescript-ast" | "markdown-heading" | "session-log" | "schema-file" | "test-file";
     }[];
     embedding?: {

package/dist/index.d.ts

@@ -11,6 +11,8 @@ export type { ResolvedFile } from './ingest/sync.js';
 export { getChangedFiles, getHeadSha, resolveFiles, runSync } from './ingest/sync.js';
 export type { DriftResult, ParsedLesson } from './drift-detector.js';
 export { detectDrift, extractFileReferences, parseLessonsFile, rewriteLessonsFile, } from './drift-detector.js';
+export type { CompiledRule, CompiledRulesFile, CompilerOutput, Violation } from './compiler.js';
+export { applyRules, CompiledRuleSchema, CompiledRulesFileSchema, CompilerOutputSchema, extractAddedLines, hashLesson, loadCompiledRules, parseCompilerResponse, type RegexValidation, saveCompiledRules, validateRegex, } from './compiler.js';
 export { generateLessonHeading } from './lesson-format.js';
 export { sanitize } from './sanitize.js';
 export { wrapXml } from './xml-format.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,aAAa,EACb,UAAU,EACV,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,KAAK,EACL,aAAa,EACb,YAAY,EACZ,WAAW,EACX,WAAW,EACX,SAAS,GACV,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGtD,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAGtF,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,aAAa,EACb,UAAU,EACV,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,KAAK,EACL,aAAa,EACb,YAAY,EACZ,WAAW,EACX,WAAW,EACX,SAAS,GACV,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGtD,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAGtF,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAChG,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,EACjB,UAAU,EACV,iBAAiB,EACjB,qBAAqB,EACrB,KAAK,eAAe,EACpB,iBAAiB,EACjB,aAAa,GACd,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -6,6 +6,7 @@ export { TOTEM_TABLE_NAME } from './store/lance-schema.js';
 export { LanceStore } from './store/lance-store.js';
 export { getChangedFiles, getHeadSha, resolveFiles, runSync } from './ingest/sync.js';
 export { detectDrift, extractFileReferences, parseLessonsFile, rewriteLessonsFile, } from './drift-detector.js';
+export { applyRules, CompiledRuleSchema, CompiledRulesFileSchema, CompilerOutputSchema, extractAddedLines, hashLesson, loadCompiledRules, parseCompilerResponse, saveCompiledRules, validateRegex, } from './compiler.js';
 // Utilities
 export { generateLessonHeading } from './lesson-format.js';
 export { sanitize } from './sanitize.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAc5B,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAItD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,QAAQ;AACR,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAIpD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAItF,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,YAAY;AACZ,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAc5B,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAItD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,QAAQ;AACR,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAIpD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAItF,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,EACjB,UAAU,EACV,iBAAiB,EACjB,qBAAqB,EAErB,iBAAiB,EACjB,aAAa,GACd,MAAM,eAAe,CAAC;AAEvB,YAAY;AACZ,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mmnto/totem",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "Persistent memory and context layer for AI agents",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,6 +18,7 @@
     "openai": "^4.77.0",
     "remark-frontmatter": "^5.0.0",
     "remark-parse": "^11.0.0",
+    "safe-regex2": "^5.0.0",
     "typescript": "^5.7.0",
     "unified": "^11.0.0",
     "yaml": "^2.4.0",