@stanco323/oh-my-claude-code 4.10.3

package/dist/hooks/empty-message-sanitizer/index.js

@@ -0,0 +1,171 @@
+/**
+ * Empty Message Sanitizer Hook
+ *
+ * Sanitizes empty messages to prevent API errors.
+ * According to the Anthropic API spec, all messages must have non-empty content
+ * except for the optional final assistant message.
+ *
+ * This hook:
+ * 1. Detects messages with no valid content (empty text or no parts)
+ * 2. Injects placeholder text to prevent API errors
+ * 3. Marks injected content as synthetic
+ *
+ * NOTE: This sanitizer would ideally run on a message transform hook that executes
+ * AFTER all other message processing. In the shell hooks system, this should be
+ * invoked at the last stage before messages are sent to the API.
+ *
+ * Adapted from oh-my-opencode's empty-message-sanitizer hook.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { tmpdir } from 'os';
+import { PLACEHOLDER_TEXT, TOOL_PART_TYPES, HOOK_NAME, DEBUG_PREFIX, } from './constants.js';
+const DEBUG = process.env.EMPTY_MESSAGE_SANITIZER_DEBUG === '1';
+const DEBUG_FILE = path.join(tmpdir(), 'empty-message-sanitizer-debug.log');
+function debugLog(...args) {
+    if (DEBUG) {
+        const msg = `[${new Date().toISOString()}] ${DEBUG_PREFIX} ${args
+            .map((a) => (typeof a === 'object' ? JSON.stringify(a, null, 2) : String(a)))
+            .join(' ')}\n`;
+        fs.appendFileSync(DEBUG_FILE, msg);
+    }
+}
+/**
+ * Check if a part has non-empty text content
+ */
+export function hasTextContent(part) {
+    if (part.type === 'text') {
+        const text = part.text;
+        return Boolean(text && text.trim().length > 0);
+    }
+    return false;
+}
+/**
+ * Check if a part is a tool-related part
+ */
+export function isToolPart(part) {
+    return TOOL_PART_TYPES.has(part.type);
+}
+/**
+ * Check if message parts contain valid content
+ * Valid content = non-empty text OR tool parts
+ */
+export function hasValidContent(parts) {
+    return parts.some((part) => hasTextContent(part) || isToolPart(part));
+}
+/**
+ * Sanitize a single message to ensure it has valid content
+ */
+export function sanitizeMessage(message, isLastMessage, placeholderText = PLACEHOLDER_TEXT) {
+    const isAssistant = message.info.role === 'assistant';
+    // Skip final assistant message (allowed to be empty per API spec)
+    if (isLastMessage && isAssistant) {
+        debugLog('skipping final assistant message');
+        return false;
+    }
+    const parts = message.parts;
+    // FIX: Removed `&& parts.length > 0` - empty arrays also need sanitization
+    // When parts is [], the message has no content and would cause API error:
+    // "all messages must have non-empty content except for the optional final assistant message"
+    if (!hasValidContent(parts)) {
+        debugLog(`sanitizing message ${message.info.id}: no valid content`);
+        let injected = false;
+        // Try to find an existing empty text part and replace its content
+        for (const part of parts) {
+            if (part.type === 'text') {
+                if (!part.text || !part.text.trim()) {
+                    part.text = placeholderText;
+                    part.synthetic = true;
+                    injected = true;
+                    debugLog(`replaced empty text in existing part`);
+                    break;
+                }
+            }
+        }
+        // If no text part was found, inject a new one
+        if (!injected) {
+            const insertIndex = parts.findIndex((p) => isToolPart(p));
+            const newPart = {
+                id: `synthetic_${Date.now()}`,
+                messageID: message.info.id,
+                sessionID: message.info.sessionID ?? '',
+                type: 'text',
+                text: placeholderText,
+                synthetic: true,
+            };
+            if (insertIndex === -1) {
+                // No tool parts, append to end
+                parts.push(newPart);
+                debugLog(`appended synthetic text part`);
+            }
+            else {
+                // Insert before first tool part
+                parts.splice(insertIndex, 0, newPart);
+                debugLog(`inserted synthetic text part before tool part`);
+            }
+        }
+        return true;
+    }
+    // Also sanitize any empty text parts that exist alongside valid content
+    let sanitized = false;
+    for (const part of parts) {
+        if (part.type === 'text') {
+            if (part.text !== undefined && part.text.trim() === '') {
+                part.text = placeholderText;
+                part.synthetic = true;
+                sanitized = true;
+                debugLog(`sanitized empty text part in message ${message.info.id}`);
+            }
+        }
+    }
+    return sanitized;
+}
+/**
+ * Sanitize all messages in the input
+ */
+export function sanitizeMessages(input, config) {
+    const { messages } = input;
+    const placeholderText = config?.placeholderText ?? PLACEHOLDER_TEXT;
+    debugLog('sanitizing messages', { count: messages.length });
+    let sanitizedCount = 0;
+    for (let i = 0; i < messages.length; i++) {
+        const message = messages[i];
+        const isLastMessage = i === messages.length - 1;
+        const wasSanitized = sanitizeMessage(message, isLastMessage, placeholderText);
+        if (wasSanitized) {
+            sanitizedCount++;
+        }
+    }
+    debugLog(`sanitized ${sanitizedCount} messages`);
+    return {
+        messages,
+        sanitizedCount,
+        modified: sanitizedCount > 0,
+    };
+}
+/**
+ * Create empty message sanitizer hook for Claude Code shell hooks
+ *
+ * This hook ensures all messages have valid content before being sent to the API.
+ * It should be called at the last stage of message processing.
+ */
+export function createEmptyMessageSanitizerHook(config) {
+    debugLog('createEmptyMessageSanitizerHook called', { config });
+    return {
+        /**
+         * Sanitize messages (called during message transform phase)
+         */
+        sanitize: (input) => {
+            return sanitizeMessages(input, config);
+        },
+        /**
+         * Get hook name
+         */
+        getName: () => {
+            return HOOK_NAME;
+        },
+    };
+}
+// Re-export constants
+export { PLACEHOLDER_TEXT, TOOL_PART_TYPES, HOOK_NAME, DEBUG_PREFIX, ERROR_PATTERNS, } from './constants.js';
+//# sourceMappingURL=index.js.map

package/dist/hooks/empty-message-sanitizer/index.js.map

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

package/dist/hooks/empty-message-sanitizer/types.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Empty Message Sanitizer Types
+ *
+ * Type definitions for the empty message sanitizer hook.
+ * This hook prevents API errors by ensuring all messages have valid content.
+ *
+ * Adapted from oh-my-opencode's empty-message-sanitizer hook.
+ */
+/**
+ * A message part in Claude Code's message format
+ */
+export interface MessagePart {
+    /** Unique identifier for this part */
+    id?: string;
+    /** Message ID this part belongs to */
+    messageID?: string;
+    /** Session ID this part belongs to */
+    sessionID?: string;
+    /** Part type (text, tool, tool_use, tool_result, etc.) */
+    type: string;
+    /** Text content (for text parts) */
+    text?: string;
+    /** Whether this is synthetically injected content */
+    synthetic?: boolean;
+    /** Additional properties */
+    [key: string]: unknown;
+}
+/**
+ * Message info metadata
+ */
+export interface MessageInfo {
+    /** Message identifier */
+    id: string;
+    /** Message role (user, assistant) */
+    role: 'user' | 'assistant';
+    /** Session ID */
+    sessionID?: string;
+    /** Additional properties */
+    [key: string]: unknown;
+}
+/**
+ * A message with its parts
+ */
+export interface MessageWithParts {
+    /** Message metadata */
+    info: MessageInfo;
+    /** Message content parts */
+    parts: MessagePart[];
+}
+/**
+ * Input for the empty message sanitizer hook
+ */
+export interface EmptyMessageSanitizerInput {
+    /** List of messages to sanitize */
+    messages: MessageWithParts[];
+    /** Session identifier */
+    sessionId?: string;
+}
+/**
+ * Output from the empty message sanitizer hook
+ */
+export interface EmptyMessageSanitizerOutput {
+    /** Sanitized messages */
+    messages: MessageWithParts[];
+    /** Number of messages sanitized */
+    sanitizedCount: number;
+    /** Whether any sanitization occurred */
+    modified: boolean;
+}
+/**
+ * Hook configuration
+ */
+export interface EmptyMessageSanitizerConfig {
+    /** Custom placeholder text (default: "[user interrupted]") */
+    placeholderText?: string;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/hooks/empty-message-sanitizer/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/hooks/empty-message-sanitizer/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4BAA4B;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,qCAAqC;IACrC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uBAAuB;IACvB,IAAI,EAAE,WAAW,CAAC;IAClB,4BAA4B;IAC5B,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,mCAAmC;IACnC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,yBAAyB;IACzB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,mCAAmC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}

package/dist/hooks/empty-message-sanitizer/types.js

@@ -0,0 +1,10 @@
+/**
+ * Empty Message Sanitizer Types
+ *
+ * Type definitions for the empty message sanitizer hook.
+ * This hook prevents API errors by ensuring all messages have valid content.
+ *
+ * Adapted from oh-my-opencode's empty-message-sanitizer hook.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/hooks/empty-message-sanitizer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/hooks/empty-message-sanitizer/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/hooks/factcheck/__tests__/factcheck.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Factcheck Guard Tests
+ *
+ * Ported from tests/test_factcheck.py (issue #1155).
+ */
+export {};
+//# sourceMappingURL=factcheck.test.d.ts.map

package/dist/hooks/factcheck/__tests__/factcheck.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factcheck.test.d.ts","sourceRoot":"","sources":["../../../../src/hooks/factcheck/__tests__/factcheck.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/hooks/factcheck/__tests__/factcheck.test.js

@@ -0,0 +1,153 @@
+/**
+ * Factcheck Guard Tests
+ *
+ * Ported from tests/test_factcheck.py (issue #1155).
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtempSync, rmSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { tmpdir, homedir } from 'os';
+import { runChecks } from '../index.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function defaultPolicy() {
+    return {
+        enabled: true,
+        mode: 'quick',
+        strict_project_patterns: [],
+        forbidden_path_prefixes: [join(homedir(), '.claude/plugins/cache/omc/')],
+        forbidden_path_substrings: ['/.omc/', '.omc-config.json'],
+        readonly_command_prefixes: [
+            'ls ', 'cat ', 'find ', 'grep ', 'head ', 'tail ', 'stat ', 'echo ', 'wc ',
+        ],
+        warn_on_cwd_mismatch: true,
+        enforce_cwd_parity_in_quick: false,
+        warn_on_unverified_gates: true,
+        warn_on_unverified_gates_when_no_source_files: false,
+    };
+}
+function baseClaims() {
+    return {
+        schema_version: '1.0',
+        run_id: 'abc123',
+        ts: '2026-02-28T20:00:00+00:00',
+        cwd: '/tmp/original',
+        mode: 'declared',
+        files_modified: [],
+        files_created: [],
+        artifacts_expected: [],
+        gates: {
+            selftest_ran: false,
+            goldens_ran: false,
+            sentinel_stop_smoke_ran: false,
+            shadow_leak_check_ran: false,
+        },
+        commands_executed: [],
+        models_used: [],
+    };
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('Factcheck Guard (issue #1155)', () => {
+    let tempDir;
+    beforeEach(() => {
+        tempDir = mkdtempSync(join(tmpdir(), 'factcheck-'));
+    });
+    afterEach(() => {
+        rmSync(tempDir, { recursive: true, force: true });
+    });
+    it('quick mode ignores cwd mismatch by default', () => {
+        const policy = defaultPolicy();
+        const claims = baseClaims();
+        const result = runChecks(claims, 'quick', policy, join(tempDir, 'other'));
+        // Quick mode skips cwd parity by default, and no source files
+        // means unverified gates are ignored → PASS
+        expect(result.verdict).toBe('PASS');
+        expect(result.mismatches.every(m => m.check !== 'argv_parity')).toBe(true);
+    });
+    it('strict mode fails on false gates and cwd mismatch', () => {
+        const policy = defaultPolicy();
+        const claims = baseClaims();
+        const result = runChecks(claims, 'strict', policy, tempDir);
+        expect(result.verdict).toBe('FAIL');
+        const checks = new Set(result.mismatches.map(m => m.check));
+        expect(checks.has('B')).toBe(true);
+        expect(checks.has('argv_parity')).toBe(true);
+    });
+    it('declared mode: no gate warn when no source files', () => {
+        const policy = defaultPolicy();
+        const claims = baseClaims();
+        const result = runChecks(claims, 'declared', policy, '/tmp/original');
+        expect(result.verdict).toBe('PASS');
+        expect(result.notes.join(' ')).toContain('No source files declared');
+    });
+    it('forbidden prefix is blocking', () => {
+        const policy = defaultPolicy();
+        const claims = baseClaims();
+        claims.files_created = [
+            join(homedir(), '.claude/plugins/cache/omc/touched.txt'),
+        ];
+        const result = runChecks(claims, 'declared', policy, '/tmp/original');
+        expect(result.verdict).toBe('FAIL');
+        expect(result.mismatches.some(m => m.check === 'H')).toBe(true);
+    });
+    it('missing required fields produce FAIL', () => {
+        const policy = defaultPolicy();
+        const claims = { schema_version: '1.0' }; // Missing almost everything
+        const result = runChecks(claims, 'quick', policy, tempDir);
+        expect(result.verdict).toBe('FAIL');
+        expect(result.mismatches.some(m => m.check === 'A')).toBe(true);
+    });
+    it('all gates true in strict mode with matching cwd passes', () => {
+        const policy = defaultPolicy();
+        const claims = baseClaims();
+        claims.gates = {
+            selftest_ran: true,
+            goldens_ran: true,
+            sentinel_stop_smoke_ran: true,
+            shadow_leak_check_ran: true,
+        };
+        claims.cwd = tempDir;
+        const result = runChecks(claims, 'strict', policy, tempDir);
+        expect(result.verdict).toBe('PASS');
+        expect(result.mismatches).toHaveLength(0);
+    });
+    it('forbidden command in mutating context is FAIL', () => {
+        const policy = defaultPolicy();
+        const claims = baseClaims();
+        const forbiddenPath = join(homedir(), '.claude/plugins/cache/omc/');
+        claims.commands_executed = [
+            `rm -rf ${forbiddenPath}data`,
+        ];
+        const result = runChecks(claims, 'quick', policy, tempDir);
+        expect(result.verdict).toBe('FAIL');
+        expect(result.mismatches.some(m => m.check === 'H' && m.detail.includes('Forbidden mutating command'))).toBe(true);
+    });
+    it('readonly command in forbidden path is allowed', () => {
+        const policy = defaultPolicy();
+        const claims = baseClaims();
+        const forbiddenPath = join(homedir(), '.claude/plugins/cache/omc/');
+        claims.commands_executed = [
+            `ls ${forbiddenPath}`,
+            `cat ${forbiddenPath}file.txt`,
+        ];
+        const result = runChecks(claims, 'quick', policy, tempDir);
+        // Should not have any command-related failures
+        expect(result.mismatches.every(m => !m.detail.includes('Forbidden mutating command'))).toBe(true);
+    });
+    it('declared mode warns on false gates when source files exist', () => {
+        const policy = defaultPolicy();
+        const claims = baseClaims();
+        // Create a real file so "file not found" doesn't fire
+        const srcFile = join(tempDir, 'src.ts');
+        writeFileSync(srcFile, 'export const x = 1;');
+        claims.files_modified = [srcFile];
+        claims.cwd = '/tmp/original';
+        const result = runChecks(claims, 'declared', policy, '/tmp/original');
+        expect(result.verdict).toBe('WARN');
+        expect(result.mismatches.some(m => m.check === 'B' && m.severity === 'WARN')).toBe(true);
+    });
+});
+//# sourceMappingURL=factcheck.test.js.map

package/dist/hooks/factcheck/__tests__/factcheck.test.js.map

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

package/dist/hooks/factcheck/__tests__/sentinel-gate.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Sentinel Readiness Gate Tests
+ */
+export {};
+//# sourceMappingURL=sentinel-gate.test.d.ts.map

package/dist/hooks/factcheck/__tests__/sentinel-gate.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentinel-gate.test.d.ts","sourceRoot":"","sources":["../../../../src/hooks/factcheck/__tests__/sentinel-gate.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/hooks/factcheck/__tests__/sentinel-gate.test.js

@@ -0,0 +1,159 @@
+/**
+ * Sentinel Readiness Gate Tests
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtempSync, rmSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { checkSentinelReadiness, waitForSentinelReadiness, } from '../../../team/sentinel-gate.js';
+function writeJsonl(path, rows) {
+    const content = rows.map(row => JSON.stringify(row)).join('\n') + '\n';
+    writeFileSync(path, content, 'utf-8');
+}
+describe('Sentinel readiness gate', () => {
+    const originalCwd = process.cwd();
+    let tempDir;
+    beforeEach(() => {
+        tempDir = mkdtempSync(join(tmpdir(), 'sentinel-gate-'));
+        // Pin guard thresholds in test-local project config for deterministic behavior.
+        mkdirSync(join(tempDir, '.claude'), { recursive: true });
+        writeFileSync(join(tempDir, '.claude', 'omc.jsonc'), JSON.stringify({
+            guards: {
+                factcheck: {
+                    enabled: true,
+                    mode: 'strict',
+                },
+                sentinel: {
+                    enabled: true,
+                    readiness: {
+                        min_pass_rate: 0.60,
+                        max_timeout_rate: 0.10,
+                        max_warn_plus_fail_rate: 0.40,
+                        min_reason_coverage_rate: 0.95,
+                    },
+                },
+            },
+        }), 'utf-8');
+        process.chdir(tempDir);
+    });
+    afterEach(() => {
+        process.chdir(originalCwd);
+        rmSync(tempDir, { recursive: true, force: true });
+    });
+    it('returns ready:true when disabled', () => {
+        const result = checkSentinelReadiness({ enabled: false });
+        expect(result).toEqual({
+            ready: true,
+            blockers: [],
+            skipped: true,
+        });
+    });
+    it('checks sentinel health when logPath is provided', () => {
+        const logPath = join(tempDir, 'sentinel_stop.jsonl');
+        writeJsonl(logPath, [
+            { verdict: 'PASS', reason: 'ok-1', runtime: { timed_out: false } },
+            { verdict: 'PASS', reason: 'ok-2', runtime: { timed_out: false } },
+            { verdict: 'PASS', reason: 'ok-3', runtime: { timed_out: false } },
+            { verdict: 'PASS', reason: 'ok-4', runtime: { timed_out: false } },
+            { verdict: 'PASS', reason: 'ok-5', runtime: { timed_out: false } },
+        ]);
+        const result = checkSentinelReadiness({ logPath });
+        expect(result.ready).toBe(true);
+        expect(result.blockers).toEqual([]);
+        expect(result.skipped).toBe(false);
+    });
+    it('checks factcheck when claims are provided', () => {
+        const result = checkSentinelReadiness({
+            claims: { schema_version: '1.0' },
+        });
+        expect(result.ready).toBe(false);
+        expect(result.skipped).toBe(false);
+        expect(result.blockers.some(blocker => blocker.startsWith('[factcheck]'))).toBe(true);
+    });
+    it('blocks when sentinel stats fail thresholds', () => {
+        const logPath = join(tempDir, 'sentinel_stop.jsonl');
+        writeJsonl(logPath, [
+            { verdict: 'FAIL', runtime: { timed_out: true }, reason: 'timeout' },
+            { verdict: 'WARN', runtime: { global_timeout: true }, reason: '' },
+            { verdict: 'WARN', reason: 'no_parseable_verdicts' },
+            { verdict: 'FAIL', reason: 'required_models_unavailable' },
+            { verdict: 'PASS', reason: 'ok' },
+        ]);
+        const result = checkSentinelReadiness({ logPath });
+        expect(result.ready).toBe(false);
+        expect(result.skipped).toBe(false);
+        expect(result.blockers.length).toBeGreaterThan(0);
+        expect(result.blockers.some(blocker => blocker.includes('pass_rate'))).toBe(true);
+    });
+    it('does not throw on malformed claims and returns blockers instead', () => {
+        // files_modified as object instead of array — previously would throw
+        const result = checkSentinelReadiness({
+            claims: { files_modified: {}, files_created: 'not-an-array' },
+        });
+        expect(result.ready).toBe(false);
+        expect(result.skipped).toBe(false);
+        // Should have blockers (from factcheck) but should NOT have thrown
+        expect(result.blockers.length).toBeGreaterThan(0);
+    });
+    it('returns ready:false when enabled but no logPath or claims provided', () => {
+        // enabled defaults to true; no logPath, no claims
+        const result = checkSentinelReadiness({});
+        expect(result.ready).toBe(false);
+        expect(result.skipped).toBe(true);
+        expect(result.blockers.length).toBeGreaterThan(0);
+        expect(result.blockers[0]).toContain('no logPath or claims provided');
+    });
+    it('returns ready:false with explicit enabled:true and no inputs', () => {
+        const result = checkSentinelReadiness({ enabled: true });
+        expect(result.ready).toBe(false);
+        expect(result.skipped).toBe(true);
+        expect(result.blockers.some(b => b.includes('cannot verify readiness'))).toBe(true);
+    });
+    it('respects sentinel.enabled from config when enabled is omitted', () => {
+        writeFileSync(join(tempDir, '.claude', 'omc.jsonc'), JSON.stringify({
+            guards: {
+                sentinel: {
+                    enabled: false,
+                },
+            },
+        }), 'utf-8');
+        const result = checkSentinelReadiness({});
+        expect(result).toEqual({
+            ready: true,
+            blockers: [],
+            skipped: true,
+        });
+    });
+    it('times out and fails closed when readiness never arrives', async () => {
+        const logPath = join(tempDir, 'sentinel_stop.jsonl');
+        const result = await waitForSentinelReadiness({
+            logPath,
+            timeoutMs: 120,
+            pollIntervalMs: 50,
+        });
+        expect(result.ready).toBe(false);
+        expect(result.timedOut).toBe(true);
+        expect(result.blockers.some(b => b.includes('timed out'))).toBe(true);
+    });
+    it('waits until readiness signal appears before succeeding', async () => {
+        const logPath = join(tempDir, 'sentinel_stop.jsonl');
+        setTimeout(() => {
+            writeJsonl(logPath, [
+                { verdict: 'PASS', reason: 'ok-1', runtime: { timed_out: false } },
+                { verdict: 'PASS', reason: 'ok-2', runtime: { timed_out: false } },
+                { verdict: 'PASS', reason: 'ok-3', runtime: { timed_out: false } },
+                { verdict: 'PASS', reason: 'ok-4', runtime: { timed_out: false } },
+                { verdict: 'PASS', reason: 'ok-5', runtime: { timed_out: false } },
+            ]);
+        }, 60);
+        const result = await waitForSentinelReadiness({
+            logPath,
+            timeoutMs: 800,
+            pollIntervalMs: 40,
+        });
+        expect(result.ready).toBe(true);
+        expect(result.timedOut).toBe(false);
+        expect(result.blockers).toEqual([]);
+    });
+});
+//# sourceMappingURL=sentinel-gate.test.js.map

package/dist/hooks/factcheck/__tests__/sentinel-gate.test.js.map

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

package/dist/hooks/factcheck/__tests__/sentinel.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Sentinel Health Analyzer Tests
+ *
+ * Ported from tests/test_sentinel_health.py (issue #1155).
+ */
+export {};
+//# sourceMappingURL=sentinel.test.d.ts.map

package/dist/hooks/factcheck/__tests__/sentinel.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentinel.test.d.ts","sourceRoot":"","sources":["../../../../src/hooks/factcheck/__tests__/sentinel.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}