truthguard-ai 0.2.0 → 0.4.0

package/dist-npm/i18n/index.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * Centralized multilingual constants for TruthGuard.
+ *
+ * Single source of truth for month names, stop words, and query stop words.
+ * Imported by Claims, Rules, and other modules to avoid duplication.
+ *
+ * Covers 11 languages: English, Spanish, French, Portuguese, Serbian,
+ * Russian, Hindi, Arabic, Bengali, Mandarin Chinese, Japanese.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QUERY_STOP_WORDS = exports.HEADING_STOP_WORDS = exports.MONTH_MAP = exports.ALL_MONTHS = exports.ZH_JA_MONTHS = exports.BN_MONTHS = exports.AR_MONTHS = exports.HI_MONTHS = exports.RU_MONTHS = exports.PT_MONTHS = exports.FR_MONTHS = exports.ES_MONTHS = exports.SR_MONTHS = exports.EN_MONTHS = void 0;
+// ---------------------------------------------------------------------------
+// Month names — regex patterns (pipe-separated alternatives)
+// ---------------------------------------------------------------------------
+/** English month names (full + abbreviated). */
+exports.EN_MONTHS = 'january|jan|february|feb|march|mar|april|apr|may|june|jun|july|jul|august|aug|september|sep|sept|october|oct|november|nov|december|dec';
+/** Serbian month names (nominative + genitive). */
+exports.SR_MONTHS = 'januar|januara|februar|februara|mart|marta|maj|maja|avgust|avgusta|septembar|septembra|oktobar|oktobra|novembar|novembra|decembar|decembra';
+/** Spanish month names. */
+exports.ES_MONTHS = 'enero|febrero|marzo|abril|mayo|junio|julio|agosto|septiembre|octubre|noviembre|diciembre';
+/** French month names (with and without accents). */
+exports.FR_MONTHS = 'janvier|février|fevrier|mars|avril|mai|juin|juillet|août|aout|septembre|octobre|novembre|décembre|decembre';
+/** Portuguese month names (with and without accents). */
+exports.PT_MONTHS = 'janeiro|fevereiro|março|marco|maio|junho|julho|setembro|outubro|novembro|dezembro';
+/** Russian month names (nominative + genitive). */
+exports.RU_MONTHS = 'январь|февраль|март|апрель|май|июнь|июль|август|сентябрь|октябрь|ноябрь|декабрь|января|февраля|марта|апреля|мая|июня|июля|августа|сентября|октября|ноября|декабря';
+/** Hindi month names. */
+exports.HI_MONTHS = 'जनवरी|फरवरी|मार्च|अप्रैल|मई|जून|जुलाई|अगस्त|सितंबर|अक्तूबर|नवंबर|दिसंबर';
+/** Arabic month names. */
+exports.AR_MONTHS = 'يناير|فبراير|مارس|أبريل|مايو|يونيو|يوليو|أغسطس|سبتمبر|أكتوبر|نوفمبر|ديسمبر';
+/** Bengali month names. */
+exports.BN_MONTHS = 'জানুয়ারি|ফেব্রুয়ারি|মার্চ|এপ্রিল|মে|জুন|জুলাই|আগস্ট|সেপ্টেম্বর|অক্টোবর|নভেম্বর|ডিসেম্বর';
+/** Chinese/Japanese month names (十二月 and 十一月 first to avoid prefix match). */
+exports.ZH_JA_MONTHS = '十二月|十一月|一月|二月|三月|四月|五月|六月|七月|八月|九月|十月';
+/** All month names across all 11 languages (pipe-separated for regex). */
+exports.ALL_MONTHS = [exports.EN_MONTHS, exports.SR_MONTHS, exports.ES_MONTHS, exports.FR_MONTHS, exports.PT_MONTHS, exports.RU_MONTHS, exports.HI_MONTHS, exports.AR_MONTHS, exports.BN_MONTHS, exports.ZH_JA_MONTHS].join('|');
+// ---------------------------------------------------------------------------
+// Month name → number mapping (for normalization)
+// ---------------------------------------------------------------------------
+exports.MONTH_MAP = {
+    // ── English ──
+    january: '01', february: '02', march: '03', april: '04', may: '05', june: '06',
+    july: '07', august: '08', september: '09', october: '10', november: '11', december: '12',
+    jan: '01', feb: '02', mar: '03', apr: '04', jun: '06', jul: '07', aug: '08',
+    sep: '09', sept: '09', oct: '10', nov: '11', dec: '12',
+    // ── Serbian (sr) ──
+    januar: '01', februar: '02', mart: '03', maj: '05',
+    juni: '06', juli: '07', avgust: '08', septembar: '09', oktobar: '10', novembar: '11', decembar: '12',
+    // ── Spanish (es) ──
+    enero: '01', febrero: '02', marzo: '03', abril: '04', mayo: '05', junio: '06',
+    julio: '07', agosto: '08', septiembre: '09', octubre: '10', noviembre: '11', diciembre: '12',
+    // ── French (fr) ──
+    janvier: '01', 'février': '02', fevrier: '02', mars: '03', avril: '04', mai: '05', juin: '06',
+    juillet: '07', 'août': '08', aout: '08', septembre: '09', octobre: '10', novembre: '11', 'décembre': '12', decembre: '12',
+    // ── Portuguese (pt) ──
+    janeiro: '01', fevereiro: '02', 'março': '03', marco: '03',
+    maio: '05', junho: '06', julho: '07',
+    // agosto already from Spanish
+    setembro: '09', outubro: '10', novembro: '11', dezembro: '12',
+    // ── Russian (ru) ──
+    'январь': '01', 'февраль': '02', 'март': '03', 'апрель': '04',
+    'май': '05', 'июнь': '06', 'июль': '07', 'август': '08',
+    'сентябрь': '09', 'октябрь': '10', 'ноябрь': '11', 'декабрь': '12',
+    // Russian genitive (common in dates: "5 марта")
+    'января': '01', 'февраля': '02', 'марта': '03', 'апреля': '04',
+    'мая': '05', 'июня': '06', 'июля': '07', 'августа': '08',
+    'сентября': '09', 'октября': '10', 'ноября': '11', 'декабря': '12',
+    // ── Hindi (hi) ──
+    'जनवरी': '01', 'फरवरी': '02', 'मार्च': '03', 'अप्रैल': '04',
+    'मई': '05', 'जून': '06', 'जुलाई': '07', 'अगस्त': '08',
+    'सितंबर': '09', 'अक्तूबर': '10', 'नवंबर': '11', 'दिसंबर': '12',
+    // ── Arabic (ar) ──
+    'يناير': '01', 'فبراير': '02', 'مارس': '03', 'أبريل': '04',
+    'مايو': '05', 'يونيو': '06', 'يوليو': '07', 'أغسطس': '08',
+    'سبتمبر': '09', 'أكتوبر': '10', 'نوفمبر': '11', 'ديسمبر': '12',
+    // ── Bengali (bn) ──
+    'জানুয়ারি': '01', 'ফেব্রুয়ারি': '02',
+    'মার্চ': '03', 'এপ্রিল': '04',
+    'মে': '05', 'জুন': '06', 'জুলাই': '07', 'আগস্ট': '08',
+    'সেপ্টেম্বর': '09', 'অক্টোবর': '10',
+    'নভেম্বর': '11', 'ডিসেম্বর': '12',
+    // ── Chinese / Japanese (zh/ja) ──
+    '一月': '01', '二月': '02', '三月': '03', '四月': '04',
+    '五月': '05', '六月': '06', '七月': '07', '八月': '08',
+    '九月': '09', '十月': '10', '十一月': '11', '十二月': '12',
+};
+// ---------------------------------------------------------------------------
+// Heading / stop words (used to filter false-positive name extraction)
+// ---------------------------------------------------------------------------
+/**
+ * Common English words that frequently appear in section headers, labels,
+ * and bullet points when title-cased. Names composed entirely of these
+ * are almost certainly headings, not real entity names.
+ */
+exports.HEADING_STOP_WORDS = new Set([
+    'additional', 'analysis', 'analytics', 'average', 'best', 'bottom',
+    'breakdown', 'cases', 'changes', 'comparison', 'current', 'daily',
+    'dashboard', 'data', 'day', 'days', 'details', 'differences',
+    'employee', 'employees', 'general', 'hours', 'inbox', 'information',
+    'key', 'last', 'late', 'line', 'main', 'month', 'monthly', 'next',
+    'notes', 'number', 'other', 'output', 'overall', 'overview',
+    'performance', 'planned', 'previous', 'records', 'reports', 'response',
+    'results', 'status', 'summary', 'tardiness', 'test', 'this', 'time', 'today',
+    'top', 'total', 'trends', 'week', 'weekly', 'worked', 'worst', 'year',
+    'yearly',
+    // Serbian heading / discourse words
+    'analiza', 'dakle', 'detalji', 'izveštaj', 'naime', 'objašnjenje',
+    'poređenje', 'pregled', 'razlog', 'stoga', 'ukupno', 'znači',
+]);
+// ---------------------------------------------------------------------------
+// Query stop words (used to filter meaningful words from user queries)
+// ---------------------------------------------------------------------------
+/**
+ * Common function words to skip when extracting meaningful terms from text.
+ * Used by partial_answer detection and irrelevant_context detection.
+ */
+exports.QUERY_STOP_WORDS = new Set([
+    'what', 'when', 'where', 'which', 'that', 'this', 'from', 'with',
+    'have', 'been', 'were', 'does', 'about', 'many', 'much', 'your',
+    'their', 'there', 'them', 'they', 'will', 'would', 'could', 'should',
+    'please', 'give', 'tell', 'show', 'find', 'list', 'how',
+]);
+//# sourceMappingURL=index.js.map

package/dist-npm/i18n/index.js.map

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

package/package.json

@@ -1,26 +1,14 @@
 {
   "name": "truthguard-ai",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "TruthGuard — Standardized grounding validation for tool-calling AI agents. Detect, diagnose, and prevent grounding failures.",
   "main": "dist-npm/thin.js",
   "types": "dist-npm/thin.d.ts",
   "bin": {
-    "truthguard": "dist/cli/index.js"
+    "truthguard-ai": "dist-npm/cli-entry.js"
   },
   "files": [
-    "dist/cli/",
-    "dist-npm/thin.*",
-    "dist-npm/types",
-    "dist-npm/Client",
-    "dist-npm/Trace",
-    "dist-npm/SDK",
-    "dist-npm/Middleware",
-    "dist-npm/Proxy",
-    "dist-npm/Auth",
-    "dist-npm/Telemetry",
-    "dist-npm/Alerting",
-    "dist-npm/Store",
-    "dist-npm/Demo",
+    "dist-npm/",
     "README.md",
     "LICENSE"
   ],
@@ -108,5 +96,8 @@
     "express": {
       "optional": true
     }
+  },
+  "dependencies": {
+    "truthguard-ai": "^0.2.0"
   }
 }

package/dist/cli/index.d.ts

@@ -1,15 +0,0 @@
-#!/usr/bin/env node
-/**
- * TruthGuard CLI
- *
- * Usage:
- *   npx truthguard debug <trace.json>                     Pretty-print grounding verdicts
- *   npx truthguard run <dataset.jsonl>                     Run grounding on a dataset
- *   npx truthguard run <dataset.jsonl> --gate gate.yml     Run + evaluate gate
- *   npx truthguard observe <trace.json> --store traces.jsonl   Evaluate + persist
- *   npx truthguard baseline save <dataset.jsonl> -o base.json -l main
- *   npx truthguard baseline compare <dataset.jsonl> --baseline base.json
- *   npx truthguard evaluate <trace.json>                   Evaluate a single trace (alias for debug)
- */
-export declare function main(argv?: string[]): void;
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;GAWG;AAoxBH,wBAAgB,IAAI,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,IAAI,CA2ExD"}