promptspeak-mcp-server 0.1.0

package/dist/drift/tripwire.js.map

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

package/dist/fidelity/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * =============================================================================
+ * PROMPTSPEAK FIDELITY MODULE
+ * =============================================================================
+ *
+ * Agent fidelity infrastructure for maintaining symbol consistency
+ * across multi-agent scenarios.
+ *
+ * =============================================================================
+ */
+export * from './refresh-hooks.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/fidelity/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fidelity/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,oBAAoB,CAAC"}

package/dist/fidelity/index.js

@@ -0,0 +1,12 @@
+/**
+ * =============================================================================
+ * PROMPTSPEAK FIDELITY MODULE
+ * =============================================================================
+ *
+ * Agent fidelity infrastructure for maintaining symbol consistency
+ * across multi-agent scenarios.
+ *
+ * =============================================================================
+ */
+export * from './refresh-hooks.js';
+//# sourceMappingURL=index.js.map

package/dist/fidelity/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fidelity/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,oBAAoB,CAAC"}

package/dist/fidelity/refresh-hooks.d.ts

@@ -0,0 +1,75 @@
+/**
+ * =============================================================================
+ * PROMPTSPEAK REFRESH HOOKS
+ * =============================================================================
+ *
+ * Manages symbol refresh mechanisms for multi-agent scenarios.
+ * Ensures agents have up-to-date symbol data through configurable refresh modes.
+ *
+ * Refresh Modes:
+ * - none: No automatic refresh (manual only)
+ * - turn-based: Refresh every N agent turns
+ * - time-based: Refresh every N milliseconds
+ * - subscription: Refresh on external symbol update notifications
+ *
+ * =============================================================================
+ */
+import { EventEmitter } from 'events';
+import type { SymbolManager } from '../symbols/manager.js';
+export interface RefreshConfig {
+    mode: 'none' | 'turn-based' | 'time-based' | 'subscription';
+    turnInterval?: number;
+    timeIntervalMs?: number;
+    symbolIds?: string[];
+}
+export interface RefreshEvent {
+    timestamp: number;
+    trigger: 'turn' | 'time' | 'manual' | 'subscription';
+    symbolsRefreshed: number;
+    staleSymbolsDetected: number;
+    agentId: string;
+}
+export declare class RefreshHookManager extends EventEmitter {
+    private symbolManager;
+    private config;
+    private agentId;
+    private turnCount;
+    private lastRefreshTime;
+    private timeInterval;
+    private refreshLog;
+    constructor(symbolManager: SymbolManager, agentId: string, config?: RefreshConfig);
+    /**
+     * Called after each agent turn to check if refresh is needed
+     */
+    onTurnComplete(): RefreshEvent | null;
+    /**
+     * Manual refresh trigger (stop-hook style)
+     */
+    triggerManualRefresh(): RefreshEvent;
+    /**
+     * Handle push notification of symbol update
+     */
+    onSymbolUpdated(symbolId: string): RefreshEvent;
+    private startTimeBasedRefresh;
+    private executeRefresh;
+    /**
+     * Refresh a specific symbol by re-fetching from database
+     */
+    private refreshSymbol;
+    /**
+     * Refresh all symbols by clearing the cache
+     */
+    private refreshAllSymbols;
+    private countStaleSymbols;
+    getRefreshLog(): RefreshEvent[];
+    getTurnCount(): number;
+    getLastRefreshTime(): number;
+    getConfig(): RefreshConfig;
+    getAgentId(): string;
+    destroy(): void;
+}
+/**
+ * Factory function to create refresh hooks for an agent
+ */
+export declare function createRefreshHooks(symbolManager: SymbolManager, agentId: string, config: RefreshConfig): RefreshHookManager;
+//# sourceMappingURL=refresh-hooks.d.ts.map

package/dist/fidelity/refresh-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh-hooks.d.ts","sourceRoot":"","sources":["../../src/fidelity/refresh-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAM3D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,YAAY,GAAG,cAAc,CAAC;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,cAAc,CAAC;IACrD,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,UAAU,CAAsB;gBAGtC,aAAa,EAAE,aAAa,EAC5B,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,aAAgC;IAY1C;;OAEG;IACI,cAAc,IAAI,YAAY,GAAG,IAAI;IAY5C;;OAEG;IACI,oBAAoB,IAAI,YAAY;IAI3C;;OAEG;IACI,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IAStD,OAAO,CAAC,qBAAqB;IAM7B,OAAO,CAAC,cAAc;IA8BtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,iBAAiB;IAMlB,aAAa,IAAI,YAAY,EAAE;IAI/B,YAAY,IAAI,MAAM;IAItB,kBAAkB,IAAI,MAAM;IAI5B,SAAS,IAAI,aAAa;IAI1B,UAAU,IAAI,MAAM;IAIpB,OAAO,IAAI,IAAI;CAOvB;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,aAAa,EAC5B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,aAAa,GACpB,kBAAkB,CAEpB"}

package/dist/fidelity/refresh-hooks.js

@@ -0,0 +1,151 @@
+/**
+ * =============================================================================
+ * PROMPTSPEAK REFRESH HOOKS
+ * =============================================================================
+ *
+ * Manages symbol refresh mechanisms for multi-agent scenarios.
+ * Ensures agents have up-to-date symbol data through configurable refresh modes.
+ *
+ * Refresh Modes:
+ * - none: No automatic refresh (manual only)
+ * - turn-based: Refresh every N agent turns
+ * - time-based: Refresh every N milliseconds
+ * - subscription: Refresh on external symbol update notifications
+ *
+ * =============================================================================
+ */
+import { EventEmitter } from 'events';
+// =============================================================================
+// REFRESH HOOK MANAGER
+// =============================================================================
+export class RefreshHookManager extends EventEmitter {
+    symbolManager;
+    config;
+    agentId;
+    turnCount = 0;
+    lastRefreshTime = Date.now();
+    timeInterval = null;
+    refreshLog = [];
+    constructor(symbolManager, agentId, config = { mode: 'none' }) {
+        super();
+        this.symbolManager = symbolManager;
+        this.agentId = agentId;
+        this.config = config;
+        if (config.mode === 'time-based' && config.timeIntervalMs) {
+            this.startTimeBasedRefresh(config.timeIntervalMs);
+        }
+    }
+    /**
+     * Called after each agent turn to check if refresh is needed
+     */
+    onTurnComplete() {
+        this.turnCount++;
+        if (this.config.mode === 'turn-based' && this.config.turnInterval) {
+            if (this.turnCount % this.config.turnInterval === 0) {
+                return this.executeRefresh('turn');
+            }
+        }
+        return null;
+    }
+    /**
+     * Manual refresh trigger (stop-hook style)
+     */
+    triggerManualRefresh() {
+        return this.executeRefresh('manual');
+    }
+    /**
+     * Handle push notification of symbol update
+     */
+    onSymbolUpdated(symbolId) {
+        if (this.config.mode === 'subscription') {
+            return this.executeRefresh('subscription');
+        }
+        // Even if not in subscription mode, log the update
+        console.log(`[RefreshHook] Symbol ${symbolId} updated externally`);
+        return this.executeRefresh('subscription');
+    }
+    startTimeBasedRefresh(intervalMs) {
+        this.timeInterval = setInterval(() => {
+            this.executeRefresh('time');
+        }, intervalMs);
+    }
+    executeRefresh(trigger) {
+        // Count stale symbols before refresh
+        const staleCount = this.countStaleSymbols();
+        // Execute refresh by clearing and reloading cache
+        if (this.config.symbolIds && this.config.symbolIds.length > 0) {
+            // For specific symbols, we reload each one individually
+            for (const symbolId of this.config.symbolIds) {
+                this.refreshSymbol(symbolId);
+            }
+        }
+        else {
+            // Refresh all by clearing cache
+            this.refreshAllSymbols();
+        }
+        const event = {
+            timestamp: Date.now(),
+            trigger,
+            symbolsRefreshed: this.config.symbolIds?.length ?? -1, // -1 = all
+            staleSymbolsDetected: staleCount,
+            agentId: this.agentId,
+        };
+        this.refreshLog.push(event);
+        this.lastRefreshTime = event.timestamp;
+        this.emit('refresh', event);
+        return event;
+    }
+    /**
+     * Refresh a specific symbol by re-fetching from database
+     */
+    refreshSymbol(symbolId) {
+        // Clear from cache and re-fetch
+        // The SymbolManager.get() will re-populate the cache
+        this.symbolManager.clearCache();
+        this.symbolManager.get({ symbolId });
+    }
+    /**
+     * Refresh all symbols by clearing the cache
+     */
+    refreshAllSymbols() {
+        // SymbolManager uses reload() to clear cache
+        this.symbolManager.reload();
+    }
+    countStaleSymbols() {
+        // This would require tracking symbol versions
+        // For now, return 0 - in production, compare cached vs DB versions
+        return 0;
+    }
+    getRefreshLog() {
+        return [...this.refreshLog];
+    }
+    getTurnCount() {
+        return this.turnCount;
+    }
+    getLastRefreshTime() {
+        return this.lastRefreshTime;
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    getAgentId() {
+        return this.agentId;
+    }
+    destroy() {
+        if (this.timeInterval) {
+            clearInterval(this.timeInterval);
+            this.timeInterval = null;
+        }
+        this.removeAllListeners();
+    }
+}
+// =============================================================================
+// FACTORY FUNCTION
+// =============================================================================
+/**
+ * Factory function to create refresh hooks for an agent
+ */
+export function createRefreshHooks(symbolManager, agentId, config) {
+    return new RefreshHookManager(symbolManager, agentId, config);
+}
+//# sourceMappingURL=refresh-hooks.js.map

package/dist/fidelity/refresh-hooks.js.map

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

package/dist/gatekeeper/checklist-generator.d.ts

@@ -0,0 +1,45 @@
+import type { HoldRequest, TruthValidatorChecklist, ChecklistCompletionSummary, ExecuteRequest } from '../types/index.js';
+export declare class ChecklistGenerator {
+    /**
+     * Generate a checklist for a hold request.
+     * Only generates for legal domain (◇) operations.
+     *
+     * @param holdRequest - The hold request to generate checklist for
+     * @param request - The original execution request
+     * @param contentToReview - Optional content to analyze (if not provided, extracts from request)
+     * @returns TruthValidatorChecklist or null if not a legal domain hold
+     */
+    generateForHold(holdRequest: HoldRequest, request: ExecuteRequest, contentToReview?: string): TruthValidatorChecklist | null;
+    /**
+     * Extract content that should be reviewed from the execution request.
+     * Looks at tool arguments that might contain reviewable text.
+     */
+    private extractReviewableContent;
+    /**
+     * Recursively extract string values from an object.
+     */
+    private extractStringsFromObject;
+    /**
+     * Analyze content and generate checklist items.
+     * This is heuristic-based - it flags for review, not validates.
+     *
+     * NOTE: This analysis intentionally errs on the side of flagging.
+     * False positives are acceptable because the human reviewer makes
+     * the final determination about each item.
+     */
+    private analyzeContent;
+    /**
+     * Update the completion state of a checklist based on item states.
+     */
+    updateCompletionState(checklist: TruthValidatorChecklist): void;
+    /**
+     * Calculate completion summary for a checklist.
+     */
+    getCompletionSummary(checklist: TruthValidatorChecklist): ChecklistCompletionSummary;
+    /**
+     * Format a checklist for display (following truth-validator output format).
+     */
+    formatForDisplay(checklist: TruthValidatorChecklist): string;
+}
+export declare const checklistGenerator: ChecklistGenerator;
+//# sourceMappingURL=checklist-generator.d.ts.map

package/dist/gatekeeper/checklist-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checklist-generator.d.ts","sourceRoot":"","sources":["../../src/gatekeeper/checklist-generator.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EACV,WAAW,EACX,uBAAuB,EAIvB,0BAA0B,EAC1B,cAAc,EACf,MAAM,mBAAmB,CAAC;AAoK3B,qBAAa,kBAAkB;IAC7B;;;;;;;;OAQG;IACH,eAAe,CACb,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,cAAc,EACvB,eAAe,CAAC,EAAE,MAAM,GACvB,uBAAuB,GAAG,IAAI;IAoBjC;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAgBhC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAchC;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IA6CtB;;OAEG;IACH,qBAAqB,CAAC,SAAS,EAAE,uBAAuB,GAAG,IAAI;IAa/D;;OAEG;IACH,oBAAoB,CAAC,SAAS,EAAE,uBAAuB,GAAG,0BAA0B;IAUpF;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,uBAAuB,GAAG,MAAM;CAkC7D;AAMD,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}

package/dist/gatekeeper/checklist-generator.js

@@ -0,0 +1,336 @@
+// ═══════════════════════════════════════════════════════════════════════════
+// PROMPTSPEAK MCP SERVER - TRUTH-VALIDATOR CHECKLIST GENERATOR
+// ═══════════════════════════════════════════════════════════════════════════
+// Integrates the truth-validator skill philosophy into the hold workflow.
+// Generates human review checklists when legal domain (◇) operations are held.
+//
+// ═══════════════════════════════════════════════════════════════════════════
+// CRITICAL PHILOSOPHY - READ BEFORE MODIFYING:
+// ═══════════════════════════════════════════════════════════════════════════
+//
+// This generator FLAGS items for human review. It does NOT:
+// - Validate accuracy or truth
+// - Find evidence of anything
+// - Make compliance determinations
+// - Confirm or deny any claims
+//
+// The checklist ASSISTS human review. It does NOT REPLACE human judgment.
+//
+// Traditional AI approach: "I verified this is accurate"
+// THIS skill's approach: "Here's what you should verify yourself"
+//
+// ═══════════════════════════════════════════════════════════════════════════
+import { generateAuditId } from '../utils/hash.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// DISCLAIMER - ALWAYS INCLUDED IN CHECKLISTS
+// ─────────────────────────────────────────────────────────────────────────────
+// This text is from the truth-validator SKILL.md and MUST be shown to reviewers.
+const CHECKLIST_DISCLAIMER = `IMPORTANT LIMITATIONS:
+This checklist flags items for YOUR review.
+- It does not validate accuracy
+- It does not find evidence of anything
+- It does not make compliance determinations
+- It may miss items that should be reviewed
+- It may flag items that are actually fine
+
+Your professional judgment is required.
+Review each item against your source materials.`;
+const FLAG_DEFINITIONS = [
+    {
+        type: 'NEEDS_CITATION',
+        patterns: [
+            /according to/i,
+            /studies show/i,
+            /research indicates/i,
+            /it is established that/i,
+            /the court held/i,
+            /the statute provides/i,
+            /precedent establishes/i,
+            /as stated in/i,
+            /pursuant to/i,
+            /under the authority of/i,
+            /the record shows/i,
+            /evidence demonstrates/i,
+        ],
+        description: 'Factual claim without explicit source reference',
+        suggestedAction: 'Verify the source exists and supports the claim',
+    },
+    {
+        type: 'CALCULATION_VERIFY',
+        patterns: [
+            /\d+(\.\d+)?%/, // Percentages: 45%, 3.5%
+            /\$[\d,]+(\.\d{2})?/, // Dollar amounts: $1,000, $50.00
+            /totaling\s/i,
+            /calculated\s/i,
+            /amounts to\s/i,
+            /sum of\s/i,
+            /average of\s/i,
+            /increased by\s/i,
+            /decreased by\s/i,
+            /growth rate/i,
+            /rate of\s+\d/i,
+            /\d+\s*(times|x)\s*(more|less|greater|fewer)/i,
+        ],
+        description: 'Arithmetic, percentage, or derived value',
+        suggestedAction: 'Verify the math independently',
+    },
+    {
+        type: 'INFERENCE_FLAG',
+        patterns: [
+            /therefore/i,
+            /thus\s/i,
+            /hence\s/i,
+            /consequently/i,
+            /it follows that/i,
+            /we can conclude/i,
+            /this demonstrates/i,
+            /this establishes/i,
+            /clearly shows/i,
+            /evidently/i,
+            /obviously/i,
+            /manifestly/i,
+            /it is clear that/i,
+            /this proves/i,
+        ],
+        description: 'Conclusion or characterization beyond explicit statement',
+        suggestedAction: 'Decide if inference is warranted or should be removed',
+    },
+    {
+        type: 'ASSUMPTION_FLAG',
+        patterns: [
+            /assuming\s/i,
+            /given that/i,
+            /if we accept/i,
+            /under the premise/i,
+            /taking as true/i,
+            /presupposing/i,
+            /on the assumption/i,
+            /predicated on/i,
+            /contingent upon/i,
+        ],
+        description: 'Unstated or stated assumption that affects interpretation',
+        suggestedAction: 'Confirm assumption is valid or make it explicit',
+    },
+    {
+        type: 'SCOPE_QUESTION',
+        patterns: [
+            /\ball\s+\w+/i, // "all customers", "all transactions"
+            /\bevery\s+\w+/i,
+            /\balways\b/i,
+            /\bnever\b/i,
+            /in all cases/i,
+            /without exception/i,
+            /comprehensive\b/i,
+            /exhaustive\b/i,
+            /complete\s+(list|set|record)/i,
+            /\bno\s+\w+\s+(has|have|had|will)/i, // "no customer has"
+            /\bnone of/i,
+        ],
+        description: 'Claim about completeness, frequency, or pattern',
+        suggestedAction: 'Verify scope claim is supported by evidence',
+    },
+    {
+        type: 'PARAPHRASE_CHECK',
+        patterns: [
+            /in other words/i,
+            /essentially\s/i,
+            /to paraphrase/i,
+            /what this means is/i,
+            /the gist is/i,
+            /in effect\s/i,
+            /to summarize/i,
+            /put differently/i,
+            /stated another way/i,
+        ],
+        description: 'Wording that may differ from source in meaning-changing ways',
+        suggestedAction: 'Compare to original source, confirm meaning preserved',
+    },
+];
+// ─────────────────────────────────────────────────────────────────────────────
+// LEGAL DOMAIN DETECTION
+// ─────────────────────────────────────────────────────────────────────────────
+// The legal domain symbol from PromptSpeak ontology (canonical: symbol-ontology.json)
+// CRITICAL: ◇ = legal, ◈ = technical (do not confuse!)
+const LEGAL_DOMAIN_SYMBOL = '◇';
+/**
+ * Check if a frame indicates legal domain.
+ */
+function isLegalDomainFrame(frame) {
+    return frame.includes(LEGAL_DOMAIN_SYMBOL);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// CHECKLIST GENERATOR CLASS
+// ─────────────────────────────────────────────────────────────────────────────
+export class ChecklistGenerator {
+    /**
+     * Generate a checklist for a hold request.
+     * Only generates for legal domain (◇) operations.
+     *
+     * @param holdRequest - The hold request to generate checklist for
+     * @param request - The original execution request
+     * @param contentToReview - Optional content to analyze (if not provided, extracts from request)
+     * @returns TruthValidatorChecklist or null if not a legal domain hold
+     */
+    generateForHold(holdRequest, request, contentToReview) {
+        // Only generate checklists for legal domain operations
+        if (!isLegalDomainFrame(holdRequest.frame)) {
+            return null;
+        }
+        const checklistId = `chk_${generateAuditId()}`;
+        const content = contentToReview || this.extractReviewableContent(request);
+        const items = this.analyzeContent(content, checklistId);
+        return {
+            checklistId,
+            holdId: holdRequest.holdId,
+            generatedAt: Date.now(),
+            items,
+            completionState: items.length > 0 ? 'incomplete' : 'complete',
+            disclaimer: CHECKLIST_DISCLAIMER,
+        };
+    }
+    /**
+     * Extract content that should be reviewed from the execution request.
+     * Looks at tool arguments that might contain reviewable text.
+     */
+    extractReviewableContent(request) {
+        const parts = [];
+        // Extract string content from arguments
+        for (const [key, value] of Object.entries(request.arguments)) {
+            if (typeof value === 'string') {
+                parts.push(value);
+            }
+            else if (typeof value === 'object' && value !== null) {
+                // Recursively extract strings from nested objects
+                this.extractStringsFromObject(value, parts);
+            }
+        }
+        return parts.join('\n');
+    }
+    /**
+     * Recursively extract string values from an object.
+     */
+    extractStringsFromObject(obj, collector) {
+        if (typeof obj === 'string') {
+            collector.push(obj);
+        }
+        else if (Array.isArray(obj)) {
+            for (const item of obj) {
+                this.extractStringsFromObject(item, collector);
+            }
+        }
+        else if (typeof obj === 'object' && obj !== null) {
+            for (const value of Object.values(obj)) {
+                this.extractStringsFromObject(value, collector);
+            }
+        }
+    }
+    /**
+     * Analyze content and generate checklist items.
+     * This is heuristic-based - it flags for review, not validates.
+     *
+     * NOTE: This analysis intentionally errs on the side of flagging.
+     * False positives are acceptable because the human reviewer makes
+     * the final determination about each item.
+     */
+    analyzeContent(content, checklistId) {
+        const items = [];
+        const lines = content.split('\n');
+        const seenPatterns = new Set(); // Avoid duplicate flags
+        for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
+            const line = lines[lineIndex].trim();
+            if (!line)
+                continue; // Skip empty lines
+            for (const flagDef of FLAG_DEFINITIONS) {
+                for (const pattern of flagDef.patterns) {
+                    const match = line.match(pattern);
+                    if (match) {
+                        // Create a key to avoid duplicate flags for same issue
+                        const flagKey = `${flagDef.type}:${lineIndex}`;
+                        if (seenPatterns.has(flagKey))
+                            continue;
+                        seenPatterns.add(flagKey);
+                        // Truncate long lines for display
+                        const displayLine = line.length > 60
+                            ? line.substring(0, 57) + '...'
+                            : line;
+                        items.push({
+                            itemId: `${checklistId}_item_${items.length + 1}`,
+                            flagType: flagDef.type,
+                            description: flagDef.description,
+                            location: `Line ${lineIndex + 1}: "${displayLine}"`,
+                            issue: `Pattern matched: "${match[0]}"`,
+                            suggestedAction: flagDef.suggestedAction,
+                            state: 'pending',
+                        });
+                        break; // Only one flag per pattern type per line
+                    }
+                }
+            }
+        }
+        return items;
+    }
+    /**
+     * Update the completion state of a checklist based on item states.
+     */
+    updateCompletionState(checklist) {
+        const pending = checklist.items.filter(i => i.state === 'pending').length;
+        const total = checklist.items.length;
+        if (total === 0 || pending === 0) {
+            checklist.completionState = 'complete';
+        }
+        else if (pending === total) {
+            checklist.completionState = 'incomplete';
+        }
+        else {
+            checklist.completionState = 'partially_complete';
+        }
+    }
+    /**
+     * Calculate completion summary for a checklist.
+     */
+    getCompletionSummary(checklist) {
+        return {
+            totalItems: checklist.items.length,
+            verifiedItems: checklist.items.filter(i => i.state === 'verified').length,
+            disputedItems: checklist.items.filter(i => i.state === 'disputed').length,
+            waivedItems: checklist.items.filter(i => i.state === 'waived').length,
+            pendingItems: checklist.items.filter(i => i.state === 'pending').length,
+        };
+    }
+    /**
+     * Format a checklist for display (following truth-validator output format).
+     */
+    formatForDisplay(checklist) {
+        const lines = [];
+        lines.push('━━━ HUMAN REVIEW CHECKLIST ━━━');
+        lines.push('');
+        lines.push(`ITEMS FOR YOUR REVIEW: ${checklist.items.length}`);
+        lines.push('');
+        for (let i = 0; i < checklist.items.length; i++) {
+            const item = checklist.items[i];
+            const checkbox = item.state === 'pending' ? '□' :
+                item.state === 'verified' ? '✓' :
+                    item.state === 'disputed' ? '✗' : '~';
+            lines.push(`${checkbox} ${i + 1}. [${item.flagType}]: ${item.description}`);
+            lines.push(`   Location: ${item.location}`);
+            lines.push(`   Issue: ${item.issue}`);
+            lines.push(`   Your action: ${item.suggestedAction}`);
+            if (item.state !== 'pending') {
+                lines.push(`   Status: ${item.state.toUpperCase()} by ${item.verifiedBy || 'unknown'}`);
+                if (item.notes) {
+                    lines.push(`   Notes: ${item.notes}`);
+                }
+            }
+            lines.push('');
+        }
+        lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+        lines.push('');
+        lines.push(checklist.disclaimer);
+        return lines.join('\n');
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// SINGLETON INSTANCE
+// ─────────────────────────────────────────────────────────────────────────────
+export const checklistGenerator = new ChecklistGenerator();
+//# sourceMappingURL=checklist-generator.js.map