truthguard-ai 0.2.0 → 0.4.0

package/dist-npm/Claims/index.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Claim Extractor
+ *
+ * Extracts factual claims from free-form LLM text.
+ *
+ * V1 supports:
+ *   - numbers  (integer and decimal)
+ *   - dates    (common formats → ISO-8601)
+ *   - names    (capitalised multi-word proper nouns)
+ *   - counts   (explicit "N [items]" patterns)
+ *
+ * V1 explicitly skips vague qualitative claims ("most", "significant", "many").
+ */
+import type { Claim, TraceStepRole } from '../types';
+/**
+ * Attempt to parse a date-like string into an ISO-8601 date (YYYY-MM-DD).
+ * Returns null if parsing fails.
+ */
+export declare function tryParseDate(raw: string, _referenceDate?: Date): string | null;
+/**
+ * A date range representing a period (inclusive start, inclusive end).
+ */
+export interface PeriodBounds {
+    start: string;
+    end: string;
+    label: string;
+}
+/**
+ * Parse a period expression into start/end bounds.
+ * Supports: Q1-Q4, H1/H2, FY, YTD, MTD, "last quarter", "this quarter",
+ * "last month", "this month", "MonthName YYYY", "YYYY", rolling periods.
+ *
+ * Returns null if the expression is not a recognized period.
+ */
+export declare function parsePeriodBounds(raw: string, referenceDate?: Date): PeriodBounds | null;
+/**
+ * Strip diacritics (č→c, ć→c, š→s, ž→z, đ→d, etc.) and lowercase.
+ * Allows entity matching across diacritic and case variants.
+ */
+export declare function normalizeEntityName(name: string): string;
+/**
+ * Check if two entity names refer to the same person/thing.
+ * Handles: case, diacritics, partial name matching (first/last name subset).
+ */
+export declare function entitiesMatch(a: string, b: string): boolean;
+/**
+ * Strips combining diacritical marks for matching purposes.
+ * "Tasić" → "Tasic", "Čačak" → "Cacak", "Новосибирск" → "Новосибирск" (Cyrillic unchanged).
+ * Uses Unicode NFD decomposition + strip combining marks (U+0300–U+036F).
+ */
+export declare function normalizeDiacritics(str: string): string;
+/** Options for claim extraction. */
+export interface ExtractorOptions {
+    /** Step ID of the source (defaults to 'unknown'). */
+    sourceStepId?: string;
+    /** Role of the source step. */
+    sourceRole?: TraceStepRole;
+    /** Reference date for resolving relative dates ("yesterday", "pre 3 dana"). Defaults to now. */
+    referenceDate?: Date;
+}
+/**
+ * Extracts factual claims from a text string.
+ *
+ * Extraction order:
+ * 1. Dates  — before numbers so date digits are not re-extracted as numbers
+ * 2. Counts — before numbers so count numerals are not re-extracted as plain numbers
+ * 3. Numbers
+ * 4. Names
+ *
+ * Vague qualitative claims are skipped.
+ */
+export declare function extractClaims(text: string, options?: ExtractorOptions): Claim[];
+//# sourceMappingURL=index.d.ts.map

package/dist-npm/Claims/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Claims/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,KAAK,EAA0B,aAAa,EAAY,MAAM,UAAU,CAAC;AAyGvF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CA6J9E;AAcD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAYD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,IAAI,GAAG,YAAY,GAAG,IAAI,CAyLxF;AAkXD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQxD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAoB3D;AAqSD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD;AA4CD,oCAAoC;AACpC,MAAM,WAAW,gBAAgB;IAC/B,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,gGAAgG;IAChG,aAAa,CAAC,EAAE,IAAI,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,KAAK,EAAE,CA4jBnF"}