@mmnto/totem 0.16.1 → 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/drift-detector.d.ts

@@ -0,0 +1,39 @@
+export interface ParsedLesson {
+    /** Heading text after "## Lesson — " */
+    heading: string;
+    /** Extracted tags from the **Tags:** line */
+    tags: string[];
+    /** The lesson body text (after heading + tags line) */
+    body: string;
+    /** The full raw text of this lesson section (heading through end) */
+    raw: string;
+    /** 0-based index in the parsed lessons array */
+    index: number;
+}
+export interface DriftResult {
+    /** The parsed lesson that has orphaned references */
+    lesson: ParsedLesson;
+    /** File paths referenced in the lesson that no longer exist */
+    orphanedRefs: string[];
+}
+/**
+ * Parse a lessons.md file into individual lesson entries.
+ * Splits on `## Lesson —` headings and extracts tags + body.
+ */
+export declare function parseLessonsFile(content: string): ParsedLesson[];
+/**
+ * Extract file path references from a lesson body.
+ * Looks for backtick-wrapped content that looks like a real file path.
+ */
+export declare function extractFileReferences(body: string): string[];
+/**
+ * Check parsed lessons for file references that no longer exist on disk.
+ * Returns only lessons that have at least one orphaned reference.
+ */
+export declare function detectDrift(lessons: ParsedLesson[], projectRoot: string): DriftResult[];
+/**
+ * Rewrite lessons.md content, removing lessons at the specified indices.
+ * Returns the new file content.
+ */
+export declare function rewriteLessonsFile(content: string, indicesToRemove: Set<number>): string;
+//# sourceMappingURL=drift-detector.d.ts.map

package/dist/drift-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift-detector.d.ts","sourceRoot":"","sources":["../src/drift-detector.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,MAAM,EAAE,YAAY,CAAC;IACrB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AA8CD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE,CAyChE;AAID;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAuC5D;AAID;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CAkBvF;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAqBxF"}

package/dist/drift-detector.js

@@ -0,0 +1,168 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+// ─── Constants ─────────────────────────────────────────
+/** File extensions considered valid for drift detection */
+const FILE_EXTENSIONS = new Set([
+    '.ts',
+    '.tsx',
+    '.js',
+    '.jsx',
+    '.mjs',
+    '.cjs',
+    '.json',
+    '.md',
+    '.mdx',
+    '.yaml',
+    '.yml',
+    '.toml',
+    '.css',
+    '.scss',
+    '.less',
+    '.html',
+    '.vue',
+    '.svelte',
+    '.py',
+    '.rs',
+    '.go',
+    '.java',
+    '.kt',
+    '.rb',
+    '.php',
+    '.sql',
+    '.graphql',
+    '.gql',
+    '.sh',
+    '.bash',
+    '.zsh',
+    '.env',
+    '.lock',
+    '.config',
+]);
+// ─── Lesson parser ─────────────────────────────────────
+const LESSON_HEADING_RE = /^## Lesson — /m;
+/**
+ * Parse a lessons.md file into individual lesson entries.
+ * Splits on `## Lesson —` headings and extracts tags + body.
+ */
+export function parseLessonsFile(content) {
+    const lessons = [];
+    // Split on lesson headings, keeping the delimiter
+    const parts = content.split(LESSON_HEADING_RE);
+    // parts[0] is the file header (before the first lesson)
+    for (let i = 1; i < parts.length; i++) {
+        const part = parts[i];
+        const lines = part.split('\n');
+        // First line is the heading (rest of the ## Lesson — line)
+        const heading = (lines[0] ?? '').trim();
+        // Find tags line: **Tags:** ...
+        let tags = [];
+        let bodyStartIdx = 1;
+        for (let j = 1; j < lines.length; j++) {
+            const line = lines[j].trim();
+            if (!line)
+                continue; // skip blank lines between heading and tags
+            if (line.startsWith('**Tags:**')) {
+                tags = line
+                    .replace('**Tags:**', '')
+                    .split(',')
+                    .map((t) => t.trim())
+                    .filter(Boolean);
+                bodyStartIdx = j + 1;
+                break;
+            }
+            // If we hit non-empty, non-tags content, no tags line exists
+            bodyStartIdx = j;
+            break;
+        }
+        const body = lines.slice(bodyStartIdx).join('\n').trim();
+        const raw = `## Lesson — ${part}`;
+        lessons.push({ heading, tags, body, raw, index: i - 1 });
+    }
+    return lessons;
+}
+// ─── File reference extraction ─────────────────────────
+/**
+ * Extract file path references from a lesson body.
+ * Looks for backtick-wrapped content that looks like a real file path.
+ */
+export function extractFileReferences(body) {
+    const refs = new Set();
+    // Split by code fences and only process content outside them (even-indexed parts)
+    const segments = body.split('```');
+    for (let i = 0; i < segments.length; i += 2) {
+        const segment = segments[i];
+        const inlineCodeRe = /(?<!`)`([^`\n]+)`(?!`)/g;
+        let match;
+        while ((match = inlineCodeRe.exec(segment)) !== null) {
+            const candidate = match[1].trim();
+            // Must contain a forward slash (path separator)
+            if (!candidate.includes('/'))
+                continue;
+            // Exclude URLs
+            if (candidate.startsWith('http://') || candidate.startsWith('https://'))
+                continue;
+            // Exclude glob patterns
+            if (candidate.includes('*') || candidate.includes('?'))
+                continue;
+            // Exclude npm package names (@scope/name)
+            if (candidate.startsWith('@') && !candidate.startsWith('.'))
+                continue;
+            // Exclude shell commands with flags
+            if (candidate.includes(' -') || candidate.includes(' --'))
+                continue;
+            // Must have a recognized file extension
+            const ext = path.extname(candidate).toLowerCase();
+            if (!ext || !FILE_EXTENSIONS.has(ext))
+                continue;
+            // Normalize path separators
+            refs.add(candidate.replace(/\\/g, '/'));
+        }
+    }
+    return [...refs];
+}
+// ─── Drift detection ──────────────────────────────────
+/**
+ * Check parsed lessons for file references that no longer exist on disk.
+ * Returns only lessons that have at least one orphaned reference.
+ */
+export function detectDrift(lessons, projectRoot) {
+    const results = [];
+    for (const lesson of lessons) {
+        const refs = extractFileReferences(lesson.body);
+        if (refs.length === 0)
+            continue;
+        const orphaned = refs.filter((ref) => {
+            const absPath = path.join(projectRoot, ref);
+            return !fs.existsSync(absPath);
+        });
+        if (orphaned.length > 0) {
+            results.push({ lesson, orphanedRefs: orphaned });
+        }
+    }
+    return results;
+}
+// ─── Lesson file rewriting ────────────────────────────
+/**
+ * Rewrite lessons.md content, removing lessons at the specified indices.
+ * Returns the new file content.
+ */
+export function rewriteLessonsFile(content, indicesToRemove) {
+    if (indicesToRemove.size === 0)
+        return content;
+    // Split on lesson headings to preserve the file header
+    const parts = content.split(LESSON_HEADING_RE);
+    const header = parts[0]; // Everything before the first lesson
+    // Reconstruct: header + kept lessons
+    const kept = [header];
+    for (let i = 1; i < parts.length; i++) {
+        if (!indicesToRemove.has(i - 1)) {
+            kept.push(`## Lesson — ${parts[i]}`);
+        }
+    }
+    // Join, clean up excessive blank lines, and ensure single trailing newline
+    let result = kept.join('');
+    result = result.replace(/\n{3,}/g, '\n\n');
+    result = result.trimEnd() + '\n';
+    return result;
+}
+//# sourceMappingURL=drift-detector.js.map

package/dist/drift-detector.js.map

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

package/dist/drift-detector.test.d.ts

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

package/dist/drift-detector.test.d.ts.map

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

package/dist/drift-detector.test.js

@@ -0,0 +1,263 @@
+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 { detectDrift, extractFileReferences, parseLessonsFile, rewriteLessonsFile, } from './drift-detector.js';
+// ─── parseLessonsFile ─────────────────────────────────
+describe('parseLessonsFile', () => {
+    it('parses a standard lessons file with multiple entries', () => {
+        const content = `# Totem Lessons
+
+Lessons learned from PR reviews and Shield checks.
+
+---
+
+## Lesson — First heading
+
+**Tags:** tag1, tag2
+
+Body of the first lesson.
+
+## Lesson — Second heading
+
+**Tags:** tag3
+
+Body of the second lesson with multiple lines.
+And another line.
+`;
+        const lessons = parseLessonsFile(content);
+        expect(lessons).toHaveLength(2);
+        expect(lessons[0].heading).toBe('First heading');
+        expect(lessons[0].tags).toEqual(['tag1', 'tag2']);
+        expect(lessons[0].body).toBe('Body of the first lesson.');
+        expect(lessons[0].index).toBe(0);
+        expect(lessons[1].heading).toBe('Second heading');
+        expect(lessons[1].tags).toEqual(['tag3']);
+        expect(lessons[1].body).toContain('Body of the second lesson');
+        expect(lessons[1].body).toContain('And another line.');
+        expect(lessons[1].index).toBe(1);
+    });
+    it('handles lessons with timestamp headings', () => {
+        const content = `# Totem Lessons
+
+---
+
+## Lesson — 2026-03-06T03:27:22.818Z
+
+**Tags:** lancedb, trap
+
+Some lesson body.
+`;
+        const lessons = parseLessonsFile(content);
+        expect(lessons).toHaveLength(1);
+        expect(lessons[0].heading).toBe('2026-03-06T03:27:22.818Z');
+    });
+    it('returns empty array for file with no lessons', () => {
+        const content = `# Totem Lessons
+
+Lessons learned from PR reviews.
+
+---
+`;
+        const lessons = parseLessonsFile(content);
+        expect(lessons).toHaveLength(0);
+    });
+    it('preserves raw text for reconstruction', () => {
+        const content = `# Header
+
+---
+
+## Lesson — Test
+
+**Tags:** a
+
+Body text.
+`;
+        const lessons = parseLessonsFile(content);
+        expect(lessons[0].raw).toContain('## Lesson — Test');
+        expect(lessons[0].raw).toContain('Body text.');
+    });
+});
+// ─── extractFileReferences ────────────────────────────
+describe('extractFileReferences', () => {
+    it('extracts backtick-wrapped file paths', () => {
+        const body = 'The issue is in `packages/core/src/sync.ts` and also affects `src/utils.ts`.';
+        const refs = extractFileReferences(body);
+        expect(refs).toEqual(['packages/core/src/sync.ts', 'src/utils.ts']);
+    });
+    it('ignores non-path backtick content', () => {
+        const body = 'Use `totem sync` to re-index. The `filePath` column uses `ENOBUFS` error code.';
+        const refs = extractFileReferences(body);
+        expect(refs).toHaveLength(0);
+    });
+    it('ignores URLs', () => {
+        const body = 'See `https://example.com/path/file.ts` for details.';
+        const refs = extractFileReferences(body);
+        expect(refs).toHaveLength(0);
+    });
+    it('ignores glob patterns', () => {
+        const body = 'Add `src/**/*.ts` to your config.';
+        const refs = extractFileReferences(body);
+        expect(refs).toHaveLength(0);
+    });
+    it('ignores npm package names', () => {
+        const body = 'Import from `@mmnto/totem` package.';
+        const refs = extractFileReferences(body);
+        expect(refs).toHaveLength(0);
+    });
+    it('ignores shell commands with flags', () => {
+        const body = 'Run `git diff --name-only HEAD~1` to see changes.';
+        const refs = extractFileReferences(body);
+        expect(refs).toHaveLength(0);
+    });
+    it('handles dotfile paths', () => {
+        const body = 'Check `.totem/lessons.md` for existing entries.';
+        const refs = extractFileReferences(body);
+        expect(refs).toEqual(['.totem/lessons.md']);
+    });
+    it('deduplicates references', () => {
+        const body = 'The file `src/index.ts` is important. Also see `src/index.ts` again.';
+        const refs = extractFileReferences(body);
+        expect(refs).toEqual(['src/index.ts']);
+    });
+    it('ignores content inside code blocks', () => {
+        // Code fences use triple backticks — our regex excludes them
+        const body = 'The path `src/real.ts` is referenced but ```\n`src/fake.ts`\n``` is in a block.';
+        const refs = extractFileReferences(body);
+        expect(refs).toContain('src/real.ts');
+        expect(refs).not.toContain('src/fake.ts');
+    });
+    it('handles paths without leading directory', () => {
+        const body = 'Edit `config/database.json` to add the new table.';
+        const refs = extractFileReferences(body);
+        expect(refs).toEqual(['config/database.json']);
+    });
+});
+// ─── detectDrift ──────────────────────────────────────
+describe('detectDrift', () => {
+    let tmpDir;
+    beforeEach(() => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'totem-drift-'));
+        // Create some files
+        fs.mkdirSync(path.join(tmpDir, 'src'), { recursive: true });
+        fs.writeFileSync(path.join(tmpDir, 'src', 'index.ts'), '');
+        fs.writeFileSync(path.join(tmpDir, 'src', 'utils.ts'), '');
+    });
+    afterEach(() => {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it('returns empty array when all references exist', () => {
+        const lessons = parseLessonsFile(`# Header
+
+---
+
+## Lesson — Test
+
+**Tags:** test
+
+The file \`src/index.ts\` works fine.
+`);
+        const drift = detectDrift(lessons, tmpDir);
+        expect(drift).toHaveLength(0);
+    });
+    it('detects orphaned file references', () => {
+        const lessons = parseLessonsFile(`# Header
+
+---
+
+## Lesson — Test
+
+**Tags:** test
+
+The file \`src/deleted.ts\` was removed.
+`);
+        const drift = detectDrift(lessons, tmpDir);
+        expect(drift).toHaveLength(1);
+        expect(drift[0].orphanedRefs).toEqual(['src/deleted.ts']);
+        expect(drift[0].lesson.heading).toBe('Test');
+    });
+    it('skips lessons with no file references', () => {
+        const lessons = parseLessonsFile(`# Header
+
+---
+
+## Lesson — General advice
+
+**Tags:** general
+
+Always use \`const\` instead of \`let\` when possible.
+`);
+        const drift = detectDrift(lessons, tmpDir);
+        expect(drift).toHaveLength(0);
+    });
+    it('reports only orphaned refs, not valid ones', () => {
+        const lessons = parseLessonsFile(`# Header
+
+---
+
+## Lesson — Mixed
+
+**Tags:** test
+
+See \`src/index.ts\` (exists) and \`src/gone.ts\` (deleted).
+`);
+        const drift = detectDrift(lessons, tmpDir);
+        expect(drift).toHaveLength(1);
+        expect(drift[0].orphanedRefs).toEqual(['src/gone.ts']);
+    });
+});
+// ─── rewriteLessonsFile ───────────────────────────────
+describe('rewriteLessonsFile', () => {
+    const SAMPLE = `# Totem Lessons
+
+Lessons learned.
+
+---
+
+## Lesson — First
+
+**Tags:** a
+
+Body one.
+
+## Lesson — Second
+
+**Tags:** b
+
+Body two.
+
+## Lesson — Third
+
+**Tags:** c
+
+Body three.
+`;
+    it('removes specified lessons by index', () => {
+        const result = rewriteLessonsFile(SAMPLE, new Set([1]));
+        expect(result).toContain('## Lesson — First');
+        expect(result).not.toContain('## Lesson — Second');
+        expect(result).toContain('## Lesson — Third');
+    });
+    it('removes multiple lessons', () => {
+        const result = rewriteLessonsFile(SAMPLE, new Set([0, 2]));
+        expect(result).not.toContain('## Lesson — First');
+        expect(result).toContain('## Lesson — Second');
+        expect(result).not.toContain('## Lesson — Third');
+    });
+    it('preserves the file header', () => {
+        const result = rewriteLessonsFile(SAMPLE, new Set([0, 1, 2]));
+        expect(result).toContain('# Totem Lessons');
+        expect(result).toContain('Lessons learned.');
+        expect(result).not.toContain('## Lesson —');
+    });
+    it('returns unchanged content when no indices to remove', () => {
+        const result = rewriteLessonsFile(SAMPLE, new Set());
+        expect(result).toBe(SAMPLE);
+    });
+    it('ends with a single newline', () => {
+        const result = rewriteLessonsFile(SAMPLE, new Set([2]));
+        expect(result.endsWith('\n')).toBe(true);
+        expect(result.endsWith('\n\n')).toBe(false);
+    });
+});
+//# sourceMappingURL=drift-detector.test.js.map

package/dist/drift-detector.test.js.map

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

package/dist/index.d.ts

@@ -9,6 +9,10 @@ export { TOTEM_TABLE_NAME } from './store/lance-schema.js';
 export { LanceStore } from './store/lance-store.js';
 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,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

@@ -5,6 +5,8 @@ export { createEmbedder } from './embedders/embedder.js';
 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;AAEtF,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.16.1",
+  "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",