@mmnto/cli 1.6.1 → 1.6.2

package/dist/commands/review-alias.test.js

@@ -0,0 +1,49 @@
+import { execSync } from 'node:child_process';
+import * as path from 'node:path';
+import { describe, expect, it } from 'vitest';
+/**
+ * Integration tests for the `review` command registration and
+ * the deprecated `shield` alias. Uses the built CLI dist output.
+ */
+describe('review command alias', () => {
+    const distEntry = path.resolve(process.cwd(), 'dist/index.js');
+    const cli = (args) => {
+        try {
+            // totem-context: test helper — args are hardcoded test strings, not user input
+            const stdout = execSync(`node "${distEntry}" ${args}`, {
+                cwd: process.cwd(),
+                encoding: 'utf-8',
+                timeout: 10_000,
+                env: { ...process.env, NODE_NO_WARNINGS: '1' },
+            });
+            return { stdout, stderr: '' };
+        }
+        catch (err) {
+            const e = err;
+            return { stdout: e.stdout ?? '', stderr: e.stderr ?? '' };
+        }
+    };
+    it('registers review as a visible command in --help', () => {
+        const { stdout } = cli('--help');
+        expect(stdout).toContain('review');
+    });
+    it('does NOT show shield as a visible command in --help', () => {
+        const { stdout } = cli('--help');
+        // shield should be hidden — it must not appear as a top-level command line
+        const lines = stdout.split('\n').filter((l) => /^\s+shield\s/.test(l));
+        expect(lines).toHaveLength(0);
+    });
+    it('shield subcommand help describes it as deprecated alias', () => {
+        const { stdout } = cli('shield --help');
+        expect(stdout).toContain('Deprecated alias');
+        expect(stdout).toContain('totem review');
+    });
+    it('shield alias emits deprecation warning to stderr when invoked', () => {
+        // Running `shield` without proper git context will fail, but the
+        // deprecation warning is emitted before the action logic runs.
+        const { stderr } = cli('shield');
+        expect(stderr).toContain("'totem shield' is deprecated");
+        expect(stderr).toContain('totem review');
+    });
+});
+//# sourceMappingURL=review-alias.test.js.map

package/dist/commands/review-alias.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-alias.test.js","sourceRoot":"","sources":["../../src/commands/review-alias.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C;;;GAGG;AACH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC,CAAC;IAE/D,MAAM,GAAG,GAAG,CAAC,IAAY,EAAsC,EAAE;QAC/D,IAAI,CAAC;YACH,+EAA+E;YAC/E,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,SAAS,KAAK,IAAI,EAAE,EAAE;gBACrD,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;gBAClB,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,MAAM;gBACf,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE;aAC/C,CAAC,CAAC;YACH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAChC,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,GAA2C,CAAC;YACtD,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QAC5D,CAAC;IACH,CAAC,CAAC;IAEF,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjC,2EAA2E;QAC3E,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACvE,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,eAAe,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,iEAAiE;QACjE,+DAA+D;QAC/D,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,8BAA8B,CAAC,CAAC;QACzD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/commands/rule.d.ts

@@ -0,0 +1,4 @@
+export declare function ruleListCommand(): Promise<void>;
+export declare function ruleInspectCommand(id: string): Promise<void>;
+export declare function ruleTestCommand(id: string): Promise<void>;
+//# sourceMappingURL=rule.d.ts.map

package/dist/commands/rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule.d.ts","sourceRoot":"","sources":["../../src/commands/rule.ts"],"names":[],"mappings":"AAkEA,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAmCrD;AAED,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0ClE;AAED,wBAAsB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyD/D"}

package/dist/commands/rule.js

@@ -0,0 +1,154 @@
+const TAG = 'Rule';
+// ─── Helpers ───────────────────────────────────────────
+function truncate(text, max) {
+    return text.length > max ? text.slice(0, max - 1) + '\u2026' : text;
+}
+/**
+ * Resolve the rules path and load rules, with a user-friendly error
+ * when no compiled-rules.json exists.
+ */
+async function loadRulesOrExit() {
+    const path = await import('node:path');
+    const { loadCompiledRules } = await import('@mmnto/totem');
+    const { loadConfig, resolveConfigPath } = await import('../utils.js');
+    const cwd = process.cwd();
+    const configPath = resolveConfigPath(cwd);
+    const config = await loadConfig(configPath);
+    const totemDir = path.join(cwd, config.totemDir);
+    const rulesPath = path.join(totemDir, 'compiled-rules.json');
+    const rules = loadCompiledRules(rulesPath);
+    return { rules, totemDir, cwd };
+}
+/**
+ * Find rules matching a hash prefix. Returns the match(es) and handles
+ * ambiguous / not-found cases with user output.
+ */
+function resolveRuleByPrefix(rules, id, log, bold) {
+    const lower = id.toLowerCase();
+    const matches = rules.filter((r) => r.lessonHash.toLowerCase().startsWith(lower));
+    if (matches.length === 0) {
+        log.error('Totem Error', `No rule found matching '${id}'`);
+        return null;
+    }
+    if (matches.length > 1) {
+        log.warn(TAG, `Ambiguous prefix '${id}' matches ${matches.length} rules:`);
+        for (const m of matches) {
+            log.info(TAG, `  ${bold(m.lessonHash)} \u2014 ${m.lessonHeading}`);
+        }
+        log.dim(TAG, 'Provide more characters to disambiguate.');
+        return null;
+    }
+    return matches[0];
+}
+// ─── Subcommands ───────────────────────────────────────
+export async function ruleListCommand() {
+    const { log, dim, bold } = await import('../ui.js');
+    const { rules } = await loadRulesOrExit();
+    if (rules.length === 0) {
+        log.error('Totem Error', 'No compiled rules found. Run `totem compile` first.');
+        return;
+    }
+    // Table header
+    const hashW = 10;
+    const engineW = 10;
+    const sevW = 9;
+    const globW = 7;
+    const headingW = 50;
+    console.error(dim(`  ${'HASH'.padEnd(hashW)}${'ENGINE'.padEnd(engineW)}${'SEVERITY'.padEnd(sevW)}${'GLOBS'.padEnd(globW)}HEADING`));
+    console.error(dim('  ' + '\u2500'.repeat(hashW + engineW + sevW + globW + headingW)));
+    for (const rule of rules) {
+        const hash = rule.lessonHash.slice(0, 8).padEnd(hashW);
+        const engine = (rule.engine ?? 'regex').padEnd(engineW);
+        const severity = (rule.severity ?? 'warning').padEnd(sevW);
+        const globs = String(rule.fileGlobs?.length ?? 0).padEnd(globW);
+        const heading = truncate(rule.lessonHeading, headingW);
+        console.error(`  ${hash}${engine}${severity}${globs}${heading}`);
+    }
+    console.error('');
+    log.info(TAG, `${bold(String(rules.length))} rule(s) total`);
+}
+export async function ruleInspectCommand(id) {
+    const { log, bold, dim } = await import('../ui.js');
+    const { rules } = await loadRulesOrExit();
+    if (rules.length === 0) {
+        log.error('Totem Error', 'No compiled rules found. Run `totem compile` first.');
+        return;
+    }
+    const rule = resolveRuleByPrefix(rules, id, log, bold);
+    if (!rule)
+        return;
+    console.error('');
+    log.info(TAG, `${bold('Hash:')}       ${rule.lessonHash}`);
+    log.info(TAG, `${bold('Heading:')}    ${rule.lessonHeading}`);
+    log.info(TAG, `${bold('Engine:')}     ${rule.engine}`);
+    log.info(TAG, `${bold('Severity:')}   ${rule.severity ?? 'warning'}`);
+    log.info(TAG, `${bold('Message:')}    ${rule.message}`);
+    if (rule.pattern) {
+        log.info(TAG, `${bold('Pattern:')}    ${dim(rule.pattern)}`);
+    }
+    if (rule.astQuery) {
+        log.info(TAG, `${bold('AST Query:')}  ${dim(rule.astQuery)}`);
+    }
+    if (rule.astGrepPattern) {
+        const display = typeof rule.astGrepPattern === 'string'
+            ? rule.astGrepPattern
+            : JSON.stringify(rule.astGrepPattern);
+        log.info(TAG, `${bold('AST Grep:')}   ${dim(display)}`);
+    }
+    if (rule.fileGlobs && rule.fileGlobs.length > 0) {
+        log.info(TAG, `${bold('File Globs:')} ${rule.fileGlobs.join(', ')}`);
+    }
+    if (rule.compiledAt) {
+        log.info(TAG, `${bold('Compiled:')}   ${rule.compiledAt}`);
+    }
+    if (rule.createdAt) {
+        log.info(TAG, `${bold('Created:')}    ${rule.createdAt}`);
+    }
+    console.error('');
+}
+export async function ruleTestCommand(id) {
+    const { log, bold, errorColor, success: successColor } = await import('../ui.js');
+    const { hashLesson, readAllLessons, extractRuleExamples, verifyRuleExamples, formatExampleFailure, } = await import('@mmnto/totem');
+    const { rules, totemDir } = await loadRulesOrExit();
+    if (rules.length === 0) {
+        log.error('Totem Error', 'No compiled rules found. Run `totem compile` first.');
+        return;
+    }
+    const rule = resolveRuleByPrefix(rules, id, log, bold);
+    if (!rule)
+        return;
+    // Find source lesson — search all lessons for one whose hash matches the rule's lessonHash
+    const lessons = readAllLessons(totemDir);
+    const lesson = lessons.find((l) => hashLesson(l.heading, l.body) === rule.lessonHash);
+    if (!lesson) {
+        log.warn(TAG, `Source lesson for rule ${bold(rule.lessonHash)} not found in .totem/lessons/`);
+        log.dim(TAG, 'The lesson may have been removed or the hash may have changed.');
+        return;
+    }
+    // Check for Example Hit/Miss
+    const examples = extractRuleExamples(lesson.body);
+    if (!examples) {
+        log.warn(TAG, 'No Example Hit/Miss found in lesson for this rule. Add examples to test.');
+        return;
+    }
+    // Run verification using the same logic as compile
+    const result = verifyRuleExamples(rule, lesson.body);
+    if (!result) {
+        // verifyRuleExamples returns null for non-regex engines with no examples
+        log.warn(TAG, `Engine '${rule.engine}' does not support inline example testing.`);
+        return;
+    }
+    console.error('');
+    if (result.passed) {
+        const label = successColor(bold('PASS'));
+        log.info(TAG, `${label} \u2014 ${rule.lessonHeading}`);
+        log.dim(TAG, `${examples.hits.length} hit(s), ${examples.misses.length} miss(es) verified`);
+    }
+    else {
+        const label = errorColor(bold('FAIL'));
+        log.info(TAG, `${label} \u2014 ${rule.lessonHeading}`);
+        log.warn(TAG, formatExampleFailure(result));
+    }
+    console.error('');
+}
+//# sourceMappingURL=rule.js.map

package/dist/commands/rule.js.map

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

package/dist/commands/rule.test.d.ts

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

package/dist/commands/rule.test.d.ts.map

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

package/dist/commands/rule.test.js

@@ -0,0 +1,315 @@
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { cleanTmpDir } from '../test-utils.js';
+// ─── Mock utils to bypass real config loading ───────────
+vi.mock('../utils.js', async () => {
+    const actual = await vi.importActual('../utils.js');
+    return {
+        ...actual,
+        resolveConfigPath: (cwd) => path.join(cwd, 'totem.config.ts'),
+        loadConfig: async () => ({
+            targets: [],
+            totemDir: '.totem',
+            ignorePatterns: [],
+        }),
+    };
+});
+// ─── Helpers ────────────────────────────────────────────
+/** Strip ANSI escape codes for assertion matching. */
+function stripAnsi(str) {
+    return str.replace(/\x1b\[[0-9;]*m/g, ''); // totem-context: ANSI regex — not user input
+}
+function makeTmpDir() {
+    return fs.mkdtempSync(path.join(os.tmpdir(), 'totem-rule-'));
+}
+/** Write a minimal compiled-rules.json with the given rules. */
+function writeRules(totemDir, rules) {
+    const rulesPath = path.join(totemDir, 'compiled-rules.json');
+    fs.writeFileSync(rulesPath, JSON.stringify({ version: 1, rules }), 'utf-8');
+}
+/** Scaffold a .totem directory with config, lessons dir, and optional rules. */
+function scaffold(cwd, rules) {
+    const totemDir = path.join(cwd, '.totem');
+    const lessonsDir = path.join(totemDir, 'lessons');
+    fs.mkdirSync(lessonsDir, { recursive: true });
+    fs.writeFileSync(path.join(cwd, 'totem.config.ts'), 'export default {};', 'utf-8');
+    if (rules) {
+        writeRules(totemDir, rules);
+    }
+    return { totemDir, lessonsDir };
+}
+/**
+ * Compute the hash a rule would get after parseLessonsFile processes it.
+ * parseLessonsFile strips the **Tags:** line from the body before hashing,
+ * so we replicate that here to get a matching hash.
+ */
+async function computeLessonHash(heading, bodyAfterTags) {
+    const { hashLesson } = await import('@mmnto/totem');
+    return hashLesson(heading, bodyAfterTags);
+}
+const SAMPLE_RULES = [
+    {
+        lessonHash: 'abcd1234abcd1234',
+        lessonHeading: 'Always use strict equality',
+        pattern: '===?\\s',
+        message: 'Use === instead of ==',
+        engine: 'regex',
+        severity: 'error',
+        compiledAt: '2026-01-01T00:00:00.000Z',
+        createdAt: '2025-12-01T00:00:00.000Z',
+        fileGlobs: ['**/*.ts', '**/*.js'],
+    },
+    {
+        lessonHash: 'efgh5678efgh5678',
+        lessonHeading: 'Avoid console.log in production code that ships to users',
+        pattern: 'console\\.log',
+        message: 'Remove console.log statements',
+        engine: 'regex',
+        severity: 'warning',
+        compiledAt: '2026-01-02T00:00:00.000Z',
+        fileGlobs: ['**/*.ts'],
+    },
+    {
+        lessonHash: 'abcd9999abcd9999',
+        lessonHeading: 'No var declarations',
+        pattern: '\\bvar\\b',
+        message: 'Use const or let instead of var',
+        engine: 'regex',
+        severity: 'warning',
+        compiledAt: '2026-01-03T00:00:00.000Z',
+    },
+];
+// ─── Tests ──────────────────────────────────────────────
+describe('rule list', () => {
+    let tmpDir;
+    let originalCwd;
+    beforeEach(() => {
+        tmpDir = makeTmpDir();
+        originalCwd = process.cwd();
+        process.chdir(tmpDir);
+    });
+    afterEach(() => {
+        process.chdir(originalCwd);
+        cleanTmpDir(tmpDir);
+        vi.restoreAllMocks();
+    });
+    it('outputs correct count and table format', async () => {
+        scaffold(tmpDir, SAMPLE_RULES);
+        const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        const { ruleListCommand } = await import('./rule.js');
+        await ruleListCommand();
+        const output = stripAnsi(consoleSpy.mock.calls.map((c) => String(c[0])).join('\n'));
+        expect(output).toContain('3 rule(s) total');
+        expect(output).toContain('abcd1234');
+        expect(output).toContain('efgh5678');
+        expect(output).toContain('regex');
+        expect(output).toContain('error');
+        expect(output).toContain('warning');
+    });
+    it('truncates long headings', async () => {
+        scaffold(tmpDir, [
+            {
+                ...SAMPLE_RULES[0],
+                lessonHeading: 'This is a very long heading that exceeds fifty characters and should be truncated properly',
+            },
+        ]);
+        const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        const { ruleListCommand } = await import('./rule.js');
+        await ruleListCommand();
+        const output = consoleSpy.mock.calls.map((c) => String(c[0])).join('\n');
+        // Should be truncated with ellipsis
+        expect(output).toContain('\u2026');
+        // Should NOT contain the full heading
+        expect(output).not.toContain('truncated properly');
+    });
+    it('shows error when no compiled-rules.json exists', async () => {
+        scaffold(tmpDir); // no rules
+        const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        const { ruleListCommand } = await import('./rule.js');
+        await ruleListCommand();
+        const output = stripAnsi(consoleSpy.mock.calls.map((c) => String(c[0])).join('\n'));
+        expect(output).toContain('No compiled rules found');
+        expect(output).toContain('totem compile');
+    });
+});
+describe('rule inspect', () => {
+    let tmpDir;
+    let originalCwd;
+    beforeEach(() => {
+        tmpDir = makeTmpDir();
+        originalCwd = process.cwd();
+        process.chdir(tmpDir);
+    });
+    afterEach(() => {
+        process.chdir(originalCwd);
+        cleanTmpDir(tmpDir);
+        vi.restoreAllMocks();
+    });
+    it('finds rule by full hash', async () => {
+        scaffold(tmpDir, SAMPLE_RULES);
+        const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        const { ruleInspectCommand } = await import('./rule.js');
+        await ruleInspectCommand('abcd1234abcd1234');
+        const output = stripAnsi(consoleSpy.mock.calls.map((c) => String(c[0])).join('\n'));
+        expect(output).toContain('abcd1234abcd1234');
+        expect(output).toContain('Always use strict equality');
+        expect(output).toContain('regex');
+        expect(output).toContain('error');
+        expect(output).toContain('**/*.ts');
+    });
+    it('finds rule by prefix', async () => {
+        scaffold(tmpDir, SAMPLE_RULES);
+        const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        const { ruleInspectCommand } = await import('./rule.js');
+        await ruleInspectCommand('efgh');
+        const output = stripAnsi(consoleSpy.mock.calls.map((c) => String(c[0])).join('\n'));
+        expect(output).toContain('efgh5678efgh5678');
+        expect(output).toContain('console.log');
+    });
+    it('errors on no match', async () => {
+        scaffold(tmpDir, SAMPLE_RULES);
+        const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        const { ruleInspectCommand } = await import('./rule.js');
+        await ruleInspectCommand('zzzz');
+        const output = stripAnsi(consoleSpy.mock.calls.map((c) => String(c[0])).join('\n'));
+        expect(output).toContain("No rule found matching 'zzzz'");
+    });
+    it('reports ambiguous prefix', async () => {
+        scaffold(tmpDir, SAMPLE_RULES);
+        const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        // 'abcd' matches both abcd1234... and abcd9999...
+        const { ruleInspectCommand } = await import('./rule.js');
+        await ruleInspectCommand('abcd');
+        const output = stripAnsi(consoleSpy.mock.calls.map((c) => String(c[0])).join('\n'));
+        expect(output).toContain('Ambiguous prefix');
+        expect(output).toContain('abcd1234abcd1234');
+        expect(output).toContain('abcd9999abcd9999');
+    });
+});
+describe('rule test', () => {
+    let tmpDir;
+    let originalCwd;
+    beforeEach(() => {
+        tmpDir = makeTmpDir();
+        originalCwd = process.cwd();
+        process.chdir(tmpDir);
+    });
+    afterEach(() => {
+        process.chdir(originalCwd);
+        cleanTmpDir(tmpDir);
+        vi.restoreAllMocks();
+    });
+    it('passes when examples match correctly', async () => {
+        const heading = 'Catch console log usage';
+        // Body as parseLessonsFile would produce it (tags stripped)
+        const bodyAfterTags = [
+            'Do not use console.log in production.',
+            '',
+            '**Pattern:** `console\\.log`',
+            '**Example Hit:** `console.log("debug")`',
+            '**Example Miss:** `logger.info("debug")`',
+        ].join('\n');
+        const realHash = await computeLessonHash(heading, bodyAfterTags);
+        const rule = {
+            lessonHash: realHash,
+            lessonHeading: heading,
+            pattern: 'console\\.log',
+            message: 'Remove console.log statements',
+            engine: 'regex',
+            severity: 'error',
+            compiledAt: '2026-01-01T00:00:00.000Z',
+        };
+        const { lessonsDir } = scaffold(tmpDir, [rule]);
+        // Write the lesson file — parseLessonsFile will extract heading and body
+        const lessonContent = [
+            `## Lesson \u2014 ${heading}`,
+            '',
+            '**Tags:** best-practice',
+            '',
+            bodyAfterTags,
+            '',
+        ].join('\n');
+        fs.writeFileSync(path.join(lessonsDir, 'lesson-test.md'), lessonContent, 'utf-8');
+        const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        const { ruleTestCommand } = await import('./rule.js');
+        await ruleTestCommand(realHash);
+        const output = stripAnsi(consoleSpy.mock.calls.map((c) => String(c[0])).join('\n'));
+        expect(output).toContain('PASS');
+    });
+    it('reports failure when examples do not match', async () => {
+        const heading = 'Catch console log';
+        const bodyAfterTags = [
+            'Remove console.log statements.',
+            '',
+            '**Pattern:** `console\\.log`',
+            '**Example Hit:** `console.log("test")`',
+            '**Example Miss:** `logger.info("test")`',
+        ].join('\n');
+        const realHash = await computeLessonHash(heading, bodyAfterTags);
+        // Deliberately wrong pattern so the example hit will NOT match
+        const rule = {
+            lessonHash: realHash,
+            lessonHeading: heading,
+            pattern: 'NOMATCH_PATTERN_XYZZY',
+            message: 'Remove console.log',
+            engine: 'regex',
+            severity: 'warning',
+            compiledAt: '2026-01-01T00:00:00.000Z',
+        };
+        const { lessonsDir } = scaffold(tmpDir, [rule]);
+        const lessonContent = [
+            `## Lesson \u2014 ${heading}`,
+            '',
+            '**Tags:** lint',
+            '',
+            bodyAfterTags,
+            '',
+        ].join('\n');
+        fs.writeFileSync(path.join(lessonsDir, 'lesson-test.md'), lessonContent, 'utf-8');
+        const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        const { ruleTestCommand } = await import('./rule.js');
+        await ruleTestCommand(realHash);
+        const output = stripAnsi(consoleSpy.mock.calls.map((c) => String(c[0])).join('\n'));
+        expect(output).toContain('FAIL');
+    });
+    it('reports when no examples exist in lesson', async () => {
+        const heading = 'No examples lesson';
+        const bodyAfterTags = 'This lesson has no Example Hit/Miss lines.';
+        const realHash = await computeLessonHash(heading, bodyAfterTags);
+        const rule = {
+            lessonHash: realHash,
+            lessonHeading: heading,
+            pattern: 'something',
+            message: 'Some rule',
+            engine: 'regex',
+            severity: 'warning',
+            compiledAt: '2026-01-01T00:00:00.000Z',
+        };
+        const { lessonsDir } = scaffold(tmpDir, [rule]);
+        const lessonContent = [
+            `## Lesson \u2014 ${heading}`,
+            '',
+            '**Tags:** misc',
+            '',
+            bodyAfterTags,
+            '',
+        ].join('\n');
+        fs.writeFileSync(path.join(lessonsDir, 'lesson-test.md'), lessonContent, 'utf-8');
+        const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        const { ruleTestCommand } = await import('./rule.js');
+        await ruleTestCommand(realHash);
+        const output = stripAnsi(consoleSpy.mock.calls.map((c) => String(c[0])).join('\n'));
+        expect(output).toContain('No Example Hit/Miss');
+    });
+    it('shows error when no compiled-rules.json exists', async () => {
+        scaffold(tmpDir); // no rules
+        const consoleSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        const { ruleTestCommand } = await import('./rule.js');
+        await ruleTestCommand('abcd');
+        const output = stripAnsi(consoleSpy.mock.calls.map((c) => String(c[0])).join('\n'));
+        expect(output).toContain('No compiled rules found');
+    });
+});
+//# sourceMappingURL=rule.test.js.map

package/dist/commands/rule.test.js.map

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

package/dist/commands/shield.js

@@ -475,7 +475,7 @@ async function handleVerdictResult(content, diff, options, config, cwd, configRo
             if (options.learn) {
                 await learnFromVerdict(JSON.stringify(structured, null, 2), diff, options, config, cwd, configRoot);
             }
-            throw new TotemError('SHIELD_FAILED', `Shield ${modeLabel} review failed: ${verdict.reason}`, 'Fix the issues identified in the review above, then re-run `totem shield`.');
+            throw new TotemError('SHIELD_FAILED', `Shield ${modeLabel} review failed: ${verdict.reason}`, 'Fix the issues identified in the review above, then re-run `totem review`.');
         }
         return;
     }
@@ -506,7 +506,7 @@ async function handleVerdictResult(content, diff, options, config, cwd, configRo
         else {
             if (options.learn)
                 await learnFromVerdict(content, diff, options, config, cwd, configRoot);
-            throw new TotemError('SHIELD_FAILED', `Shield ${modeLabel} review failed: ${verdict.reason || 'no reason given'}`, 'Fix the issues identified in the review above, then re-run `totem shield`.');
+            throw new TotemError('SHIELD_FAILED', `Shield ${modeLabel} review failed: ${verdict.reason || 'no reason given'}`, 'Fix the issues identified in the review above, then re-run `totem review`.');
         }
     }
     else {
@@ -581,16 +581,16 @@ export async function shieldCommand(options) {
     const { classifyChangedFiles } = await import('./shield-classify.js');
     const { extractShieldContextAnnotations, extractShieldHints } = await import('./shield-hints.js');
     if (options.mode && options.mode !== 'standard' && options.mode !== 'structural') {
-        throw new TotemConfigError(`Invalid --mode "${options.mode}". Use "standard" or "structural".`, 'Check `totem shield --help` for valid options.', 'CONFIG_INVALID');
+        throw new TotemConfigError(`Invalid --mode "${options.mode}". Use "standard" or "structural".`, 'Check `totem review --help` for valid options.', 'CONFIG_INVALID');
     }
     if (options.override !== undefined && options.override.length < 10) {
         throw new TotemConfigError(`--override reason must be at least 10 characters (got ${options.override.length}).`, 'Provide a meaningful justification, e.g., --override "False positive: onWarn param visible at line 273"', 'CONFIG_INVALID');
     }
     const cwd = process.cwd();
-    // Silently upgrade the pre-push hook if it lacks shield auto-refresh (#1045)
+    // Silently upgrade the pre-push hook if it lacks review auto-refresh (#1045)
     const { upgradePrePushHookIfNeeded } = await import('./install-hooks.js');
     if (upgradePrePushHookIfNeeded(cwd)) {
-        log.dim(TAG, 'Upgraded pre-push hook with shield auto-refresh');
+        log.dim(TAG, 'Upgraded pre-push hook with review auto-refresh');
     }
     const configPath = resolveConfigPath(cwd);
     const configRoot = path.dirname(configPath);

package/dist/commands/spec-templates.d.ts

@@ -1,3 +1,3 @@
-export declare const SYSTEM_PROMPT = "# Spec System Prompt \u2014 Pre-Work Briefing\n\n## Identity & Role\nYou are a Staff-Level Software Architect. You do not write the implementation code yourself; your job is to guide developers. You design system interactions, define data contracts, identify architectural traps, and ensure the proposed plan aligns with existing project patterns.\n\n## Core Mission\nProduce a structured, highly technical pre-work briefing for a task before implementation begins, drawing heavily on provided Totem knowledge to ensure architectural consistency.\n\n## Critical Rules\n- **No Implementation Generation:** Do not write the final code. Provide architectural guidance, sequence logic, and structural plans.\n- **Define Contracts:** Explicitly define data contracts (e.g., Zod schemas, DB migrations, API interfaces) needed for the feature.\n- **Pessimistic Edge Cases:** Actively search for edge cases the issue description failed to mention (e.g., race conditions, missing indexes).\n- **Grounded Reality:** File paths must reference actual files from the context provided. When multiple approaches exist, list trade-offs with a firm recommendation.\n- **Lessons Are Law:** If RELEVANT LESSONS are provided, treat each lesson as a hard architectural constraint. Your plan MUST account for every relevant lesson. Call out which lessons influenced your approach in the Architectural Context section.\n\n## Output Format\nRespond with ONLY the sections below. No preamble, no closing remarks.\n\n### Problem Statement\n[1-2 sentences restating the issue in concrete implementation terms. What exactly needs to change?]\n\n### Architectural Context\n[Relevant sessions, PRs, decisions, or past traps from the provided Totem knowledge. If nothing relevant, say \"None found in provided context.\"]\n\n### Files to Examine\n[Ordered list of files the developer should read before starting. Most critical first. Format: `path/to/file.ts` \u2014 reason to examine]\n\n### Technical Approach & Contracts\n[Recommended implementation approach. Include concrete steps, sequence logic, and required data contract changes (e.g., schemas, types). If multiple valid approaches exist, list trade-offs with a clear recommendation.]\n\n### Edge Cases & Traps\n[Things the issue description missed. Include race conditions, existing patterns that MUST be followed, and potential architectural regressions.]\n\n### Implementation Tasks\n[Break the work into discrete, ordered checkbox tasks. Each task should be completable in 5-15 minutes. Format each as `- [ ] **Task N: Title**` followed by indented steps.\n\nFor each task:\n- Name the files to modify and the test files to update\n- If a retrieved Totem lesson applies to THIS SPECIFIC TASK, inject it inline as:\n  > TOTEM INVARIANT ([lesson heading]): [one-line constraint summary]\n  Place the invariant directly above the step it constrains, not in a separate section.\n- If the task introduces behavior that could regress, add a TDD directive:\n  > TEST DIRECTIVE: Before implementing, write a failing test named `[descriptive test name]` that proves the regression is caught.\n  The test name must be specific (e.g., `rejects empty catch blocks`), not generic (e.g., `works correctly`).\n- Each task ends with: write test (or update existing) \u2192 verify fails \u2192 implement \u2192 verify passes \u2192 lint\n\nRED FLAGS \u2014 if any of these occur, STOP and fix before proceeding:\n- Never move to the next task until the current task's tests pass AND lint is clean.\n- Never accept \"close enough\" on a failing test. Fix it or rewrite the approach.\n- Never skip the test step. No untested code advances to the next task.\n- Never write code before writing the failing test (TDD is mandatory, not advisory).]\n\n### Execution Flow (structural constraint)\n```dot\ndigraph workflow {\n  spec -> write_test -> verify_fails -> implement -> verify_passes -> lint -> next_task\n  verify_fails -> implement [label=\"RED only\"]\n  verify_passes -> lint [label=\"GREEN required\"]\n  lint -> next_task [label=\"0 violations\"]\n  lint -> implement [label=\"violations found \u2014 fix first\"]\n}\n```\n\n### Verification (MANDATORY \u2014 do not skip)\nEvery implementation MUST end with these steps:\n1. `totem lint` \u2014 deterministic rule check (zero LLM, ~2s). Fixes any violations.\n2. `totem shield` \u2014 AI-powered architectural review (~18s). Addresses any critical findings.\n3. If using MCP, call `verify_execution` to confirm compliance before declaring the task done.\n\n### Test Plan\n[Specific test scenarios needed to prove the feature works and edge cases are handled. Reference existing test file patterns when applicable.]\n";
+export declare const SYSTEM_PROMPT = "# Spec System Prompt \u2014 Pre-Work Briefing\n\n## Identity & Role\nYou are a Staff-Level Software Architect. You do not write the implementation code yourself; your job is to guide developers. You design system interactions, define data contracts, identify architectural traps, and ensure the proposed plan aligns with existing project patterns.\n\n## Core Mission\nProduce a structured, highly technical pre-work briefing for a task before implementation begins, drawing heavily on provided Totem knowledge to ensure architectural consistency.\n\n## Critical Rules\n- **No Implementation Generation:** Do not write the final code. Provide architectural guidance, sequence logic, and structural plans.\n- **Define Contracts:** Explicitly define data contracts (e.g., Zod schemas, DB migrations, API interfaces) needed for the feature.\n- **Pessimistic Edge Cases:** Actively search for edge cases the issue description failed to mention (e.g., race conditions, missing indexes).\n- **Grounded Reality:** File paths must reference actual files from the context provided. When multiple approaches exist, list trade-offs with a firm recommendation.\n- **Lessons Are Law:** If RELEVANT LESSONS are provided, treat each lesson as a hard architectural constraint. Your plan MUST account for every relevant lesson. Call out which lessons influenced your approach in the Architectural Context section.\n\n## Output Format\nRespond with ONLY the sections below. No preamble, no closing remarks.\n\n### Problem Statement\n[1-2 sentences restating the issue in concrete implementation terms. What exactly needs to change?]\n\n### Architectural Context\n[Relevant sessions, PRs, decisions, or past traps from the provided Totem knowledge. If nothing relevant, say \"None found in provided context.\"]\n\n### Files to Examine\n[Ordered list of files the developer should read before starting. Most critical first. Format: `path/to/file.ts` \u2014 reason to examine]\n\n### Technical Approach & Contracts\n[Recommended implementation approach. Include concrete steps, sequence logic, and required data contract changes (e.g., schemas, types). If multiple valid approaches exist, list trade-offs with a clear recommendation.]\n\n### Edge Cases & Traps\n[Things the issue description missed. Include race conditions, existing patterns that MUST be followed, and potential architectural regressions.]\n\n### Implementation Tasks\n[Break the work into discrete, ordered checkbox tasks. Each task should be completable in 5-15 minutes. Format each as `- [ ] **Task N: Title**` followed by indented steps.\n\nFor each task:\n- Name the files to modify and the test files to update\n- If a retrieved Totem lesson applies to THIS SPECIFIC TASK, inject it inline as:\n  > TOTEM INVARIANT ([lesson heading]): [one-line constraint summary]\n  Place the invariant directly above the step it constrains, not in a separate section.\n- If the task introduces behavior that could regress, add a TDD directive:\n  > TEST DIRECTIVE: Before implementing, write a failing test named `[descriptive test name]` that proves the regression is caught.\n  The test name must be specific (e.g., `rejects empty catch blocks`), not generic (e.g., `works correctly`).\n- Each task ends with: write test (or update existing) \u2192 verify fails \u2192 implement \u2192 verify passes \u2192 lint\n\nRED FLAGS \u2014 if any of these occur, STOP and fix before proceeding:\n- Never move to the next task until the current task's tests pass AND lint is clean.\n- Never accept \"close enough\" on a failing test. Fix it or rewrite the approach.\n- Never skip the test step. No untested code advances to the next task.\n- Never write code before writing the failing test (TDD is mandatory, not advisory).]\n\n### Execution Flow (structural constraint)\n```dot\ndigraph workflow {\n  spec -> write_test -> verify_fails -> implement -> verify_passes -> lint -> next_task\n  verify_fails -> implement [label=\"RED only\"]\n  verify_passes -> lint [label=\"GREEN required\"]\n  lint -> next_task [label=\"0 violations\"]\n  lint -> implement [label=\"violations found \u2014 fix first\"]\n}\n```\n\n### Verification (MANDATORY \u2014 do not skip)\nEvery implementation MUST end with these steps:\n1. `totem lint` \u2014 deterministic rule check (zero LLM, ~2s). Fixes any violations.\n2. `totem review` \u2014 AI-powered architectural review (~18s). Addresses any critical findings.\n3. If using MCP, call `verify_execution` to confirm compliance before declaring the task done.\n\n### Test Plan\n[Specific test scenarios needed to prove the feature works and edge cases are handled. Reference existing test file patterns when applicable.]\n";
 export { SYSTEM_PROMPT as SPEC_SYSTEM_PROMPT };
 //# sourceMappingURL=spec-templates.d.ts.map