@iflow-mcp/jkheadley-instar 0.26.2

package/dist/core/WorkLedger.js

@@ -0,0 +1,246 @@
+/**
+ * WorkLedger — Per-machine work tracking for inter-agent awareness.
+ *
+ * Each machine writes only its own ledger file. The aggregate view is
+ * computed by reading all files in the ledger directory. This eliminates
+ * write contention entirely — conflicts on ledger files are structurally
+ * impossible in single-user scenarios.
+ *
+ * From INTELLIGENT_SYNC_SPEC Section 6 (The Work Ledger) and Section 8
+ * (Conflict Prevention Through Awareness).
+ */
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+// ── Constants ────────────────────────────────────────────────────────
+const SCHEMA_VERSION = 1;
+const DEFAULT_COMPLETED_MAX_AGE = 24 * 60 * 60 * 1000; // 24 hours
+const DEFAULT_STALE_THRESHOLD = 2 * 60 * 60 * 1000; // 2 hours
+const DEFAULT_STALE_MAX_AGE = 6 * 60 * 60 * 1000; // 6 hours
+// ── WorkLedger ───────────────────────────────────────────────────────
+export class WorkLedger {
+    stateDir;
+    machineId;
+    userId;
+    ledgerDir;
+    completedMaxAgeMs;
+    staleThresholdMs;
+    staleMaxAgeMs;
+    constructor(config) {
+        this.stateDir = config.stateDir;
+        this.machineId = config.machineId;
+        this.userId = config.userId;
+        this.ledgerDir = path.join(config.stateDir, 'state', 'ledger');
+        this.completedMaxAgeMs = config.completedMaxAgeMs ?? DEFAULT_COMPLETED_MAX_AGE;
+        this.staleThresholdMs = config.staleThresholdMs ?? DEFAULT_STALE_THRESHOLD;
+        this.staleMaxAgeMs = config.staleMaxAgeMs ?? DEFAULT_STALE_MAX_AGE;
+        // Ensure ledger directory exists
+        if (!fs.existsSync(this.ledgerDir)) {
+            fs.mkdirSync(this.ledgerDir, { recursive: true });
+        }
+    }
+    // ── Session Lifecycle ────────────────────────────────────────────
+    /**
+     * Record the start of a work session. Returns the created entry.
+     */
+    startWork(opts) {
+        const entry = {
+            id: `work_${crypto.randomBytes(6).toString('hex')}`,
+            machineId: this.machineId,
+            userId: this.userId,
+            sessionId: opts.sessionId,
+            startedAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+            status: 'active',
+            task: opts.task,
+            filesPlanned: opts.filesPlanned ?? [],
+            filesModified: [],
+            branch: opts.branch,
+            estimatedCompletion: opts.estimatedCompletion,
+        };
+        const ledger = this.readOwnLedger();
+        ledger.entries.push(entry);
+        this.writeOwnLedger(ledger);
+        return entry;
+    }
+    /**
+     * Update an active work entry (called periodically during work).
+     */
+    updateWork(entryId, updates) {
+        const ledger = this.readOwnLedger();
+        const entry = ledger.entries.find(e => e.id === entryId);
+        if (!entry || entry.status !== 'active')
+            return false;
+        if (updates.task !== undefined)
+            entry.task = updates.task;
+        if (updates.filesPlanned !== undefined)
+            entry.filesPlanned = updates.filesPlanned;
+        if (updates.estimatedCompletion !== undefined)
+            entry.estimatedCompletion = updates.estimatedCompletion;
+        // Merge filesModified (union, not replace)
+        if (updates.filesModified) {
+            const combined = new Set([...entry.filesModified, ...updates.filesModified]);
+            entry.filesModified = [...combined];
+        }
+        entry.updatedAt = new Date().toISOString();
+        this.writeOwnLedger(ledger);
+        return true;
+    }
+    /**
+     * End a work session (mark as completed or paused).
+     */
+    endWork(entryId, status = 'completed') {
+        const ledger = this.readOwnLedger();
+        const entry = ledger.entries.find(e => e.id === entryId);
+        if (!entry)
+            return false;
+        entry.status = status;
+        entry.updatedAt = new Date().toISOString();
+        this.writeOwnLedger(ledger);
+        return true;
+    }
+    // ── Reading ──────────────────────────────────────────────────────
+    /**
+     * Read this machine's ledger file.
+     */
+    readOwnLedger() {
+        const filePath = this.ledgerFilePath(this.machineId);
+        return this.readLedgerFile(filePath);
+    }
+    /**
+     * Get aggregate view of all active/paused entries across all machines.
+     */
+    getActiveEntries() {
+        return this.readAllLedgers()
+            .flatMap(l => l.entries)
+            .filter(e => e.status === 'active' || e.status === 'paused');
+    }
+    /**
+     * Get all entries across all machines (including completed/stale).
+     */
+    getAllEntries() {
+        return this.readAllLedgers().flatMap(l => l.entries);
+    }
+    /**
+     * Read all machine ledger files.
+     */
+    readAllLedgers() {
+        if (!fs.existsSync(this.ledgerDir))
+            return [];
+        const files = fs.readdirSync(this.ledgerDir)
+            .filter(f => f.endsWith('.json'));
+        return files.map(f => {
+            const filePath = path.join(this.ledgerDir, f);
+            return this.readLedgerFile(filePath);
+        });
+    }
+    // ── Overlap Detection ────────────────────────────────────────────
+    /**
+     * Check for overlap between planned files and active ledger entries.
+     * Returns warnings sorted by severity (highest first).
+     */
+    detectOverlap(myPlannedFiles) {
+        if (myPlannedFiles.length === 0)
+            return [];
+        const activeEntries = this.getActiveEntries()
+            // Exclude own machine's entries
+            .filter(e => e.machineId !== this.machineId);
+        const warnings = [];
+        const plannedSet = new Set(myPlannedFiles);
+        for (const entry of activeEntries) {
+            // Check against both planned and modified files
+            const entryFiles = new Set([...entry.filesPlanned, ...entry.filesModified]);
+            const overlapping = myPlannedFiles.filter(f => entryFiles.has(f));
+            if (overlapping.length === 0)
+                continue;
+            // Determine tier based on whether overlap is with planned or modified files
+            const modifiedOverlap = overlapping.filter(f => entry.filesModified.includes(f));
+            let tier;
+            let message;
+            if (modifiedOverlap.length > 0) {
+                // Active overlap — files are already being modified
+                tier = 2;
+                message = `Warning: Machine "${entry.machineId}" is actively modifying ${modifiedOverlap.join(', ')} that you also plan to change. Consider branching or waiting.`;
+            }
+            else {
+                // Planned overlap — files are planned but not yet touched
+                tier = 1;
+                message = `Note: Machine "${entry.machineId}" is planning to modify ${overlapping.join(', ')}. Proceeding with awareness.`;
+            }
+            warnings.push({
+                tier,
+                entry,
+                overlappingFiles: overlapping,
+                message,
+            });
+        }
+        // Sort by tier descending (highest severity first)
+        return warnings.sort((a, b) => b.tier - a.tier);
+    }
+    // ── Cleanup ──────────────────────────────────────────────────────
+    /**
+     * Clean up this machine's ledger entries:
+     * - Remove completed entries older than 24h
+     * - Mark entries with stale updatedAt (>2h) as "stale"
+     * - Remove stale entries older than 6h
+     *
+     * Returns the number of entries removed/modified.
+     */
+    cleanup() {
+        const ledger = this.readOwnLedger();
+        const now = Date.now();
+        let removed = 0;
+        let markedStale = 0;
+        ledger.entries = ledger.entries.filter(entry => {
+            const updatedAge = now - new Date(entry.updatedAt).getTime();
+            // Remove completed entries older than threshold
+            if (entry.status === 'completed' && updatedAge > this.completedMaxAgeMs) {
+                removed++;
+                return false;
+            }
+            // Remove stale entries older than max age
+            if (entry.status === 'stale' && updatedAge > this.staleMaxAgeMs) {
+                removed++;
+                return false;
+            }
+            // Mark active entries as stale if updatedAt is too old
+            if (entry.status === 'active' && updatedAge > this.staleThresholdMs) {
+                entry.status = 'stale';
+                markedStale++;
+            }
+            return true;
+        });
+        ledger.lastCleanup = new Date().toISOString();
+        this.writeOwnLedger(ledger);
+        return { removed, markedStale };
+    }
+    // ── Private Helpers ──────────────────────────────────────────────
+    ledgerFilePath(machineId) {
+        return path.join(this.ledgerDir, `${machineId}.json`);
+    }
+    readLedgerFile(filePath) {
+        try {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            // File doesn't exist or is invalid — return empty ledger
+            const machineId = path.basename(filePath, '.json');
+            return {
+                schemaVersion: SCHEMA_VERSION,
+                machineId,
+                lastUpdated: new Date().toISOString(),
+                entries: [],
+                lastCleanup: new Date().toISOString(),
+            };
+        }
+    }
+    writeOwnLedger(ledger) {
+        ledger.lastUpdated = new Date().toISOString();
+        ledger.schemaVersion = SCHEMA_VERSION;
+        ledger.machineId = this.machineId;
+        const filePath = this.ledgerFilePath(this.machineId);
+        fs.writeFileSync(filePath, JSON.stringify(ledger, null, 2));
+    }
+}
+//# sourceMappingURL=WorkLedger.js.map

package/dist/core/WorkLedger.js.map

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

package/dist/core/models.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Canonical Anthropic Model Dictionary for Instar
+ *
+ * SINGLE SOURCE OF TRUTH for all Anthropic model IDs in the Instar codebase.
+ * All components that need model IDs should import from this module.
+ *
+ * WHEN TO UPDATE:
+ *   - Anthropic releases a new generation (e.g., Claude 5.x)
+ *   - A model alias stops working (detected by validation)
+ *   - You want to upgrade to a newer model
+ *
+ * VALIDATION:
+ *   From the portal project:
+ *     python3 .claude/scripts/validate-anthropic-models.py
+ *
+ * ARCHITECTURE:
+ *   - ANTHROPIC_MODELS: bare model IDs for direct API calls
+ *   - CLI_MODEL_FLAGS: CLI model flags for Claude CLI provider
+ *   - resolveModelId(): converts tier names to model IDs
+ *   - resolveCliFlag(): converts tier names to CLI flags
+ */
+/**
+ * Canonical mapping of abstract tiers to concrete Anthropic model IDs.
+ * These are used by AnthropicIntelligenceProvider and StallTriageNurse.
+ */
+export declare const ANTHROPIC_MODELS: Readonly<{
+    /** Most capable model — deep reasoning, complex tasks */
+    readonly opus: "claude-opus-4-6";
+    /** Best balance of capability and cost — default for most services */
+    readonly sonnet: "claude-sonnet-4-6";
+    /** Fastest and cheapest — quick classification, simple tasks */
+    readonly haiku: "claude-haiku-4-5";
+}>;
+/**
+ * Mapping of abstract tiers to Claude CLI model flags.
+ * These are used by ClaudeCliIntelligenceProvider.
+ */
+export declare const CLI_MODEL_FLAGS: Readonly<{
+    readonly opus: "opus";
+    readonly sonnet: "sonnet";
+    readonly haiku: "haiku";
+}>;
+/** Available model tier names */
+export type ModelTierName = keyof typeof ANTHROPIC_MODELS;
+/** Bare Anthropic model ID values */
+export type AnthropicModelId = (typeof ANTHROPIC_MODELS)[ModelTierName];
+/**
+ * Resolve a tier name ('opus', 'sonnet', 'haiku', 'fast', 'balanced', 'capable')
+ * or raw model ID to a bare Anthropic model ID.
+ *
+ * Supports both naming conventions:
+ *   - Tier names: 'opus', 'sonnet', 'haiku'
+ *   - Legacy aliases: 'fast' → haiku, 'balanced' → sonnet, 'capable' → opus
+ *   - Raw IDs: 'claude-sonnet-4-6' → passed through as-is
+ */
+export declare function resolveModelId(tierOrId: string): string;
+/**
+ * Resolve a tier name to a Claude CLI model flag.
+ * Supports both naming conventions (tier names and legacy aliases).
+ */
+export declare function resolveCliFlag(tierOrFlag: string): string;
+/**
+ * Get all valid tier names (for validation).
+ */
+export declare function getValidTiers(): string[];
+/**
+ * Check if a string is a valid tier name.
+ */
+export declare function isValidTier(tier: string): boolean;
+//# sourceMappingURL=models.d.ts.map

package/dist/core/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/core/models.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH;;;GAGG;AACH,eAAO,MAAM,gBAAgB;IAC3B,yDAAyD;;IAGzD,sEAAsE;;IAGtE,gEAAgE;;EAEvD,CAAC;AAMZ;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;EAIjB,CAAC;AAMZ,iCAAiC;AACjC,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,gBAAgB,CAAC;AAE1D,qCAAqC;AACrC,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,aAAa,CAAC,CAAC;AAMxE;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAqBvD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAkBzD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAExC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD"}

package/dist/core/models.js

@@ -0,0 +1,110 @@
+/**
+ * Canonical Anthropic Model Dictionary for Instar
+ *
+ * SINGLE SOURCE OF TRUTH for all Anthropic model IDs in the Instar codebase.
+ * All components that need model IDs should import from this module.
+ *
+ * WHEN TO UPDATE:
+ *   - Anthropic releases a new generation (e.g., Claude 5.x)
+ *   - A model alias stops working (detected by validation)
+ *   - You want to upgrade to a newer model
+ *
+ * VALIDATION:
+ *   From the portal project:
+ *     python3 .claude/scripts/validate-anthropic-models.py
+ *
+ * ARCHITECTURE:
+ *   - ANTHROPIC_MODELS: bare model IDs for direct API calls
+ *   - CLI_MODEL_FLAGS: CLI model flags for Claude CLI provider
+ *   - resolveModelId(): converts tier names to model IDs
+ *   - resolveCliFlag(): converts tier names to CLI flags
+ */
+// =============================================================================
+// Anthropic API Model IDs (for direct API calls)
+// =============================================================================
+/**
+ * Canonical mapping of abstract tiers to concrete Anthropic model IDs.
+ * These are used by AnthropicIntelligenceProvider and StallTriageNurse.
+ */
+export const ANTHROPIC_MODELS = Object.freeze({
+    /** Most capable model — deep reasoning, complex tasks */
+    opus: 'claude-opus-4-6',
+    /** Best balance of capability and cost — default for most services */
+    sonnet: 'claude-sonnet-4-6',
+    /** Fastest and cheapest — quick classification, simple tasks */
+    haiku: 'claude-haiku-4-5',
+});
+// =============================================================================
+// Claude CLI Model Flags (for CLI-based intelligence)
+// =============================================================================
+/**
+ * Mapping of abstract tiers to Claude CLI model flags.
+ * These are used by ClaudeCliIntelligenceProvider.
+ */
+export const CLI_MODEL_FLAGS = Object.freeze({
+    opus: 'opus',
+    sonnet: 'sonnet',
+    haiku: 'haiku',
+});
+// =============================================================================
+// Resolution helpers
+// =============================================================================
+/**
+ * Resolve a tier name ('opus', 'sonnet', 'haiku', 'fast', 'balanced', 'capable')
+ * or raw model ID to a bare Anthropic model ID.
+ *
+ * Supports both naming conventions:
+ *   - Tier names: 'opus', 'sonnet', 'haiku'
+ *   - Legacy aliases: 'fast' → haiku, 'balanced' → sonnet, 'capable' → opus
+ *   - Raw IDs: 'claude-sonnet-4-6' → passed through as-is
+ */
+export function resolveModelId(tierOrId) {
+    const key = tierOrId.toLowerCase();
+    // Direct tier name match
+    if (key in ANTHROPIC_MODELS) {
+        return ANTHROPIC_MODELS[key];
+    }
+    // Legacy alias support (fast/balanced/capable → haiku/sonnet/opus)
+    const LEGACY_ALIASES = {
+        fast: 'haiku',
+        balanced: 'sonnet',
+        capable: 'opus',
+    };
+    if (key in LEGACY_ALIASES) {
+        return ANTHROPIC_MODELS[LEGACY_ALIASES[key]];
+    }
+    // Not a tier name — return as-is (already a model ID)
+    return tierOrId;
+}
+/**
+ * Resolve a tier name to a Claude CLI model flag.
+ * Supports both naming conventions (tier names and legacy aliases).
+ */
+export function resolveCliFlag(tierOrFlag) {
+    const key = tierOrFlag.toLowerCase();
+    if (key in CLI_MODEL_FLAGS) {
+        return CLI_MODEL_FLAGS[key];
+    }
+    const LEGACY_ALIASES = {
+        fast: 'haiku',
+        balanced: 'sonnet',
+        capable: 'opus',
+    };
+    if (key in LEGACY_ALIASES) {
+        return CLI_MODEL_FLAGS[LEGACY_ALIASES[key]];
+    }
+    return tierOrFlag;
+}
+/**
+ * Get all valid tier names (for validation).
+ */
+export function getValidTiers() {
+    return [...Object.keys(ANTHROPIC_MODELS), 'fast', 'balanced', 'capable'];
+}
+/**
+ * Check if a string is a valid tier name.
+ */
+export function isValidTier(tier) {
+    return getValidTiers().includes(tier.toLowerCase());
+}
+//# sourceMappingURL=models.js.map

package/dist/core/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/core/models.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,gFAAgF;AAChF,iDAAiD;AACjD,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5C,yDAAyD;IACzD,IAAI,EAAE,iBAAiB;IAEvB,sEAAsE;IACtE,MAAM,EAAE,mBAAmB;IAE3B,gEAAgE;IAChE,KAAK,EAAE,kBAAkB;CACjB,CAAC,CAAC;AAEZ,gFAAgF;AAChF,sDAAsD;AACtD,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;CACN,CAAC,CAAC;AAYZ,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAEnC,yBAAyB;IACzB,IAAI,GAAG,IAAI,gBAAgB,EAAE,CAAC;QAC5B,OAAO,gBAAgB,CAAC,GAAoB,CAAC,CAAC;IAChD,CAAC;IAED,mEAAmE;IACnE,MAAM,cAAc,GAAkC;QACpD,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,MAAM;KAChB,CAAC;IAEF,IAAI,GAAG,IAAI,cAAc,EAAE,CAAC;QAC1B,OAAO,gBAAgB,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,sDAAsD;IACtD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,UAAkB;IAC/C,MAAM,GAAG,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;IAErC,IAAI,GAAG,IAAI,eAAe,EAAE,CAAC;QAC3B,OAAO,eAAe,CAAC,GAAoB,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,cAAc,GAAkC;QACpD,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,MAAM;KAChB,CAAC;IAEF,IAAI,GAAG,IAAI,cAAc,EAAE,CAAC;QAC1B,OAAO,eAAe,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,aAAa,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AACtD,CAAC"}

package/dist/core/reviewers/capability-accuracy.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Capability Accuracy Reviewer — Catches false "I can't" claims.
+ *
+ * Detects when the agent falsely claims inability or deflects tasks to the user
+ * that the agent should handle itself.
+ */
+import { CoherenceReviewer } from '../CoherenceReviewer.js';
+import type { ReviewContext, ReviewerOptions } from '../CoherenceReviewer.js';
+export declare class CapabilityAccuracyReviewer extends CoherenceReviewer {
+    constructor(apiKey: string, options?: ReviewerOptions);
+    protected buildPrompt(context: ReviewContext): string;
+}
+//# sourceMappingURL=capability-accuracy.d.ts.map

package/dist/core/reviewers/capability-accuracy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-accuracy.d.ts","sourceRoot":"","sources":["../../../src/core/reviewers/capability-accuracy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE9E,qBAAa,0BAA2B,SAAQ,iBAAiB;gBACnD,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe;IAIrD,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM;CA0BtD"}

package/dist/core/reviewers/capability-accuracy.js

@@ -0,0 +1,38 @@
+/**
+ * Capability Accuracy Reviewer — Catches false "I can't" claims.
+ *
+ * Detects when the agent falsely claims inability or deflects tasks to the user
+ * that the agent should handle itself.
+ */
+import { CoherenceReviewer } from '../CoherenceReviewer.js';
+export class CapabilityAccuracyReviewer extends CoherenceReviewer {
+    constructor(apiKey, options) {
+        super('capability-accuracy', apiKey, options);
+    }
+    buildPrompt(context) {
+        const boundary = this.generateBoundary();
+        const preamble = this.buildAntiInjectionPreamble();
+        return `${preamble}
+
+You are a capability accuracy reviewer. Your job: detect when an agent falsely claims it cannot do something, or deflects responsibility to the user for tasks the agent should handle.
+
+Flag when the message:
+- Says "I can't", "I'm unable to", "unfortunately I don't have" without evidence of verification
+- Tells the user to perform a task the agent could do itself (run a command, edit a config, check a website)
+- Presents instructions for the user to follow instead of executing the steps
+- Claims a limitation that contradicts typical agent capabilities (file access, API calls, browser automation)
+- Says "you'll need to" for something the agent has tools to accomplish
+
+DO NOT flag:
+- Genuine limitations (can't access user's physical device, can't log into user's accounts)
+- Security boundaries (deliberately not executing destructive operations without confirmation)
+- Cases where the agent correctly identifies it needs user input (passwords, preferences, decisions)
+
+Respond EXCLUSIVELY with valid JSON:
+{ "pass": boolean, "severity": "block"|"warn", "issue": "...", "suggestion": "..." }
+
+Message:
+${this.wrapMessage(context.message, boundary)}`;
+    }
+}
+//# sourceMappingURL=capability-accuracy.js.map

package/dist/core/reviewers/capability-accuracy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-accuracy.js","sourceRoot":"","sources":["../../../src/core/reviewers/capability-accuracy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,MAAM,OAAO,0BAA2B,SAAQ,iBAAiB;IAC/D,YAAY,MAAc,EAAE,OAAyB;QACnD,KAAK,CAAC,qBAAqB,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAES,WAAW,CAAC,OAAsB;QAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,0BAA0B,EAAE,CAAC;QAEnD,OAAO,GAAG,QAAQ;;;;;;;;;;;;;;;;;;;;EAoBpB,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;IAC9C,CAAC;CACF"}

package/dist/core/reviewers/claim-provenance.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Claim Provenance Reviewer — Catches fabricated claims not traceable to tool output.
+ *
+ * Detects fabricated URLs, status codes, data points, and other specific claims
+ * that aren't supported by actual tool output. Defaults to 'sonnet' model for
+ * higher accuracy on nuanced judgment.
+ */
+import { CoherenceReviewer } from '../CoherenceReviewer.js';
+import type { ReviewContext, ReviewerOptions } from '../CoherenceReviewer.js';
+export declare class ClaimProvenanceReviewer extends CoherenceReviewer {
+    constructor(apiKey: string, options?: ReviewerOptions);
+    protected buildPrompt(context: ReviewContext): string;
+}
+//# sourceMappingURL=claim-provenance.d.ts.map

package/dist/core/reviewers/claim-provenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-provenance.d.ts","sourceRoot":"","sources":["../../../src/core/reviewers/claim-provenance.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE9E,qBAAa,uBAAwB,SAAQ,iBAAiB;gBAChD,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe;IAOrD,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM;CAmCtD"}

package/dist/core/reviewers/claim-provenance.js

@@ -0,0 +1,50 @@
+/**
+ * Claim Provenance Reviewer — Catches fabricated claims not traceable to tool output.
+ *
+ * Detects fabricated URLs, status codes, data points, and other specific claims
+ * that aren't supported by actual tool output. Defaults to 'sonnet' model for
+ * higher accuracy on nuanced judgment.
+ */
+import { CoherenceReviewer } from '../CoherenceReviewer.js';
+export class ClaimProvenanceReviewer extends CoherenceReviewer {
+    constructor(apiKey, options) {
+        super('claim-provenance', apiKey, {
+            ...options,
+            model: options?.model ?? 'sonnet',
+        });
+    }
+    buildPrompt(context) {
+        const boundary = this.generateBoundary();
+        const preamble = this.buildAntiInjectionPreamble();
+        const toolContext = context.toolOutputContext
+            ? `Recent tool output (for cross-referencing claims):\n${context.toolOutputContext}`
+            : 'No tool output context available. Evaluate based on language patterns only and use "warn" rather than "block" severity.';
+        return `${preamble}
+
+You are a factual accuracy reviewer. Your job: identify claims in agent messages that appear to be fabricated rather than sourced from actual data.
+
+Flag when the message:
+- Contains URLs that look constructed from project names rather than retrieved from tools
+- Reports specific numbers, status codes, or metrics without attribution
+- States "the API returned..." or "the output shows..." without quoting actual output
+- Presents deployment URLs, dashboard links, or service endpoints that could be guessed
+- Claims specific file contents or states without evidence of having read them
+
+DO NOT flag:
+- General statements that don't require specific evidence
+- Descriptions of what the agent plans to do
+- Explanations of concepts or architecture
+- Claims that are directly supported by the recent tool output provided below
+
+If tool output context is provided, cross-reference specific claims against it. A claim with no matching tool output is suspicious. If no tool output context is available, evaluate based on language patterns only and use "warn" rather than "block" severity.
+
+${toolContext}
+
+Respond EXCLUSIVELY with valid JSON:
+{ "pass": boolean, "severity": "block"|"warn", "issue": "...", "suggestion": "..." }
+
+Message:
+${this.wrapMessage(context.message, boundary)}`;
+    }
+}
+//# sourceMappingURL=claim-provenance.js.map

package/dist/core/reviewers/claim-provenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-provenance.js","sourceRoot":"","sources":["../../../src/core/reviewers/claim-provenance.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,MAAM,OAAO,uBAAwB,SAAQ,iBAAiB;IAC5D,YAAY,MAAc,EAAE,OAAyB;QACnD,KAAK,CAAC,kBAAkB,EAAE,MAAM,EAAE;YAChC,GAAG,OAAO;YACV,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,QAAQ;SAClC,CAAC,CAAC;IACL,CAAC;IAES,WAAW,CAAC,OAAsB;QAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,0BAA0B,EAAE,CAAC;QAEnD,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB;YAC3C,CAAC,CAAC,uDAAuD,OAAO,CAAC,iBAAiB,EAAE;YACpF,CAAC,CAAC,yHAAyH,CAAC;QAE9H,OAAO,GAAG,QAAQ;;;;;;;;;;;;;;;;;;;EAmBpB,WAAW;;;;;;EAMX,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;IAC9C,CAAC;CACF"}

package/dist/core/reviewers/context-completeness.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Context Completeness Reviewer — Catches missing context for decisions.
+ *
+ * Detects when the agent presents decisions, recommendations, or status updates
+ * without providing the context the user would need.
+ */
+import { CoherenceReviewer } from '../CoherenceReviewer.js';
+import type { ReviewContext, ReviewerOptions } from '../CoherenceReviewer.js';
+export declare class ContextCompletenessReviewer extends CoherenceReviewer {
+    constructor(apiKey: string, options?: ReviewerOptions);
+    protected buildPrompt(context: ReviewContext): string;
+}
+//# sourceMappingURL=context-completeness.d.ts.map

package/dist/core/reviewers/context-completeness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-completeness.d.ts","sourceRoot":"","sources":["../../../src/core/reviewers/context-completeness.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE9E,qBAAa,2BAA4B,SAAQ,iBAAiB;gBACpD,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe;IAIrD,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM;CAgCtD"}

package/dist/core/reviewers/context-completeness.js

@@ -0,0 +1,43 @@
+/**
+ * Context Completeness Reviewer — Catches missing context for decisions.
+ *
+ * Detects when the agent presents decisions, recommendations, or status updates
+ * without providing the context the user would need.
+ */
+import { CoherenceReviewer } from '../CoherenceReviewer.js';
+export class ContextCompletenessReviewer extends CoherenceReviewer {
+    constructor(apiKey, options) {
+        super('context-completeness', apiKey, options);
+    }
+    buildPrompt(context) {
+        const boundary = this.generateBoundary();
+        const preamble = this.buildAntiInjectionPreamble();
+        let themesHint = '';
+        if (context.relationshipContext?.themes?.length) {
+            themesHint = `\nKnown relationship themes: ${context.relationshipContext.themes.join(', ')}`;
+        }
+        return `${preamble}
+
+You are a completeness reviewer. Your job: detect when an agent presents a decision, recommendation, or status update without providing context the user would want.
+
+Flag when the message:
+- Presents a choice without explaining trade-offs
+- Recommends an approach without mentioning alternatives considered
+- Reports a decision without explaining the reasoning
+- Asks for user input without providing the context needed to decide
+- Delivers results without mentioning caveats, risks, or side effects
+
+DO NOT flag:
+- Simple status updates that don't involve decisions
+- Cases where context was provided earlier in the conversation
+- Quick acknowledgments or confirmations
+${themesHint}
+
+Respond EXCLUSIVELY with valid JSON:
+{ "pass": boolean, "severity": "block"|"warn", "issue": "...", "suggestion": "..." }
+
+Message:
+${this.wrapMessage(context.message, boundary)}`;
+    }
+}
+//# sourceMappingURL=context-completeness.js.map

package/dist/core/reviewers/context-completeness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-completeness.js","sourceRoot":"","sources":["../../../src/core/reviewers/context-completeness.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,MAAM,OAAO,2BAA4B,SAAQ,iBAAiB;IAChE,YAAY,MAAc,EAAE,OAAyB;QACnD,KAAK,CAAC,sBAAsB,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAES,WAAW,CAAC,OAAsB;QAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,0BAA0B,EAAE,CAAC;QAEnD,IAAI,UAAU,GAAG,EAAE,CAAC;QACpB,IAAI,OAAO,CAAC,mBAAmB,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YAChD,UAAU,GAAG,gCAAgC,OAAO,CAAC,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/F,CAAC;QAED,OAAO,GAAG,QAAQ;;;;;;;;;;;;;;;EAepB,UAAU;;;;;;EAMV,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;IAC9C,CAAC;CACF"}