sxng-cli 1.2.2 → 1.2.3

package/README.md

@@ -30,10 +30,12 @@
 - 🧠 **Deep Search** — Multi-round iterative research with session accumulation, quality assessment, and recovery strategies
 - 🔍 **Content Extraction** — Extract full article content from URLs or session results, with Obscura (JS rendering) and Jina Reader fallbacks
 - 🗂️ **Session Management** — Accumulate search results across rounds with deduplication; pending → approve → graph injection workflow
+- 🔗 **External Result Fusion** — Inject results from Tavily, Exa, or any search tool into the same session pipeline via `results-add`; shared pending pool, unified quality assessment
 - ⭐ **Quality Assessment** — 4 independent indicators: content depth, entity richness, source diversity, novelty
 - 🕸️ **Knowledge Graph** — Structural (query→result→domain) + semantic (entity relations) graph layers
 - 🔄 **Query Redundancy Check** — Jaccard similarity + SimHash to avoid repeated queries
 - 💡 **Agent-First Design** — Outputs structured analysis data (quality, suggestions, recovery) for LLM Agent decision-making
+- 📁 **Local Document Search** — Index and BM25-search local Markdown/text files; results auto-injected into the session pipeline as `source: "local"`
 
 ## 📦 Installation
 
@@ -124,6 +126,9 @@ obscura --version
 | `sxng graph-drill <session>` | Follow specific relations |
 | `sxng graph-traverse <session>` | Traverse reasoning paths |
 | `sxng graph-obfuscate <session>` | List obfuscation candidates |
+| `sxng results-add <session> --data <json>` | Inject external search results into session as pending |
+| `sxng doc-index <path>` | Index local documents for BM25 search |
+| `sxng doc-search <session> <query> --path <path>` | Search indexed docs and inject results into session |
 | `sxng --health` | Check SearXNG server health |
 | `sxng --engines-list` | List available search engines |
 | `sxng --categories-list` | List available categories |
@@ -290,6 +295,34 @@ Two layers:
 
 Graph navigation commands: `graph-search` (discover entities), `graph-explore` (view relations), `graph-drill` (follow specific relations), `graph-traverse` (traverse reasoning paths).
 
+### External Search Results
+
+Results from other search tools (Tavily, Exa, etc.) can be injected into any active session via `results-add`, following the same pipeline as native sxng results:
+
+```bash
+sxng results-add <session-name> --data '[
+  {"url": "https://...", "title": "...", "source": "tavily"}
+]'
+```
+
+After injection, results are `pending` and follow `--quality` → `--approve` → `graph-add`.
+
+### Local Document Search
+
+`doc-index` and `doc-search` enable BM25 full-text search over local documents, with results flowing directly into the session pipeline:
+
+```bash
+# Index (auto-triggered by doc-search)
+sxng doc-index ./docs
+
+# Search and inject into session
+sxng doc-search <session-name> "query" --path ./docs
+```
+
+**How it works:** auto-indexing on first use (Orama BM25, title×3 / headings×2 / content×1), results injected as `source: "local"` pending, same `--quality` → `--approve` → `graph-add` flow. Local searches do **not** increment the round counter.
+
+**Quality note:** Pure local search yields `sourceDiversity: 1`. Combine with web results for adequate diversity.
+
 ## 🔗 Links
 
 - **GitHub:** https://github.com/hkwuks/sxng-cli

package/dist/claims/deterministic-checks.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Deterministic checks — no LLM dependency.
+ *
+ * - checkAnchor: URL in approved results, offset in range, hash matches
+ * - computeSourceClusterId: domain + author/name + SimHash → SHA256 fingerprint
+ * - searchCandidates: keyword + Jaccard sentence matching
+ */
+import { EvidenceSpan } from './types.js';
+export interface AnchorCheck {
+    url: boolean;
+    offsetInRange: boolean;
+    hashMatches: boolean;
+}
+/**
+ * Verify that an EvidenceSpan is properly anchored to approved content.
+ */
+export declare function checkAnchor(evidence: EvidenceSpan, content: string): AnchorCheck;
+/**
+ * Verify that evidence.resultUrl exists in the session's approved results.
+ * Returns the matching Result's content, or null if not found.
+ */
+export declare function resolveApprovedContent(sessionDir: string, resultUrl: string): {
+    content: string;
+} | null;
+/**
+ * Compute a source cluster ID for an EvidenceSpan.
+ * Concatenates: domain + author|siteName + SimHash(quote) → SHA256 → 16 hex chars.
+ */
+export declare function computeSourceClusterId(evidence: EvidenceSpan): string;
+/** A candidate evidence match, not persisted until verified by Agent. */
+export interface EvidenceCandidate {
+    resultUrl: string;
+    quote: string;
+    charStart: number;
+    charEnd: number;
+    contentHash: string;
+    domain: string;
+    author?: string;
+    siteName?: string;
+}
+/**
+ * Search approved session results for candidate evidence supporting the claim.
+ * Uses keyword + Jaccard sentence matching. Read-only — results not persisted.
+ */
+export declare function searchCandidates(sessionDir: string, claimText: string): EvidenceCandidate[];
+//# sourceMappingURL=deterministic-checks.d.ts.map

package/dist/claims/deterministic-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deterministic-checks.d.ts","sourceRoot":"","sources":["../../src/claims/deterministic-checks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM1C,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,OAAO,CAAC;IACb,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,MAAM,GACd,WAAW,CAQb;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQ5B;AAMD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,YAAY,GACrB,MAAM,CAWR;AAID,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAsCD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,iBAAiB,EAAE,CAwDrB"}

package/dist/claims/deterministic-checks.js

@@ -0,0 +1,146 @@
+/**
+ * Deterministic checks — no LLM dependency.
+ *
+ * - checkAnchor: URL in approved results, offset in range, hash matches
+ * - computeSourceClusterId: domain + author/name + SimHash → SHA256 fingerprint
+ * - searchCandidates: keyword + Jaccard sentence matching
+ */
+import { createHash } from 'crypto';
+import { SimHash } from '../deep/simhash.js';
+import { getApprovedResults } from '../deep/session.js';
+import { loadSessionResults } from '../deep/session.js';
+/**
+ * Verify that an EvidenceSpan is properly anchored to approved content.
+ */
+export function checkAnchor(evidence, content) {
+    const slice = content.slice(evidence.charStart, evidence.charEnd);
+    const computedHash = createHash('sha256').update(slice).digest('hex');
+    return {
+        url: true, // caller must have resolved url → content already
+        offsetInRange: evidence.charEnd <= content.length && evidence.charStart >= 0,
+        hashMatches: computedHash === evidence.contentHash,
+    };
+}
+/**
+ * Verify that evidence.resultUrl exists in the session's approved results.
+ * Returns the matching Result's content, or null if not found.
+ */
+export function resolveApprovedContent(sessionDir, resultUrl) {
+    const approved = getApprovedResults(sessionDir);
+    for (const r of approved) {
+        if (r.url === resultUrl && r.content) {
+            return { content: r.content };
+        }
+    }
+    return null;
+}
+// ── Source clustering ───────────────────────────────────────────────
+const _simhash = new SimHash();
+/**
+ * Compute a source cluster ID for an EvidenceSpan.
+ * Concatenates: domain + author|siteName + SimHash(quote) → SHA256 → 16 hex chars.
+ */
+export function computeSourceClusterId(evidence) {
+    let domain = '';
+    try {
+        domain = new URL(evidence.resultUrl).hostname;
+    }
+    catch { /* empty */ }
+    const authorSig = (evidence.author || evidence.siteName || '').toLowerCase().trim();
+    const quoteSim = _simhash.hash(evidence.quote);
+    const input = `${domain}|${authorSig}|${quoteSim.toString(16)}`;
+    return createHash('sha256').update(input).digest('hex').slice(0, 16);
+}
+/** Simple stopwords for tokenization */
+const STOPWORDS = new Set([
+    'a', 'an', 'the', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
+    'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could',
+    'should', 'may', 'might', 'shall', 'can', 'need', 'dare', 'ought',
+    'to', 'of', 'in', 'for', 'on', 'with', 'at', 'by', 'from', 'as',
+    'into', 'through', 'during', 'before', 'after', 'above', 'below',
+    'between', 'out', 'off', 'over', 'under', 'again', 'further',
+    'then', 'once', 'here', 'there', 'when', 'where', 'why', 'how',
+    'all', 'each', 'every', 'both', 'few', 'more', 'most', 'other',
+    'some', 'such', 'no', 'not', 'only', 'own', 'same', 'so', 'than',
+    'too', 'very', 'just', 'because', 'but', 'and', 'or', 'if', 'while',
+    'although', 'this', 'that', 'these', 'those', 'it', 'its',
+    'the', 'which', 'who', 'whom', 'what',
+]);
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter(t => t.length > 1 && !STOPWORDS.has(t));
+}
+function jaccardSimilarity(a, b) {
+    if (a.size === 0 && b.size === 0)
+        return 0;
+    let intersection = 0;
+    for (const word of a) {
+        if (b.has(word))
+            intersection++;
+    }
+    const union = a.size + b.size - intersection;
+    return union === 0 ? 0 : intersection / union;
+}
+const JACCARD_THRESHOLD = 0.3;
+const MAX_CANDIDATES = 5;
+/**
+ * Search approved session results for candidate evidence supporting the claim.
+ * Uses keyword + Jaccard sentence matching. Read-only — results not persisted.
+ */
+export function searchCandidates(sessionDir, claimText) {
+    const keywords = tokenize(claimText);
+    if (keywords.length === 0)
+        return [];
+    const keywordSet = new Set(keywords);
+    const allResults = loadSessionResults(sessionDir);
+    const approved = allResults.filter(r => r.status === 'approved' && r.content);
+    const candidates = [];
+    for (const result of approved) {
+        const content = result.content;
+        // Split into sentences
+        const sentences = content.split(/(?<=[.!?])\s+|(?<=\n)\s*/);
+        for (const sentence of sentences) {
+            const trimmed = sentence.trim();
+            if (trimmed.length < 10)
+                continue;
+            const words = tokenize(trimmed);
+            if (words.length === 0)
+                continue;
+            const wordSet = new Set(words);
+            const score = jaccardSimilarity(keywordSet, wordSet);
+            if (score < JACCARD_THRESHOLD)
+                continue;
+            const charStart = content.indexOf(trimmed);
+            if (charStart === -1)
+                continue;
+            const charEnd = charStart + trimmed.length;
+            const contentHash = createHash('sha256')
+                .update(trimmed)
+                .digest('hex');
+            let domain = '';
+            try {
+                domain = new URL(result.url).hostname;
+            }
+            catch { /* empty */ }
+            candidates.push({
+                score,
+                candidate: {
+                    resultUrl: result.url,
+                    quote: trimmed,
+                    charStart,
+                    charEnd,
+                    contentHash,
+                    domain,
+                    author: result.byline || undefined,
+                    siteName: result.siteName || undefined,
+                },
+            });
+        }
+    }
+    // Sort by Jaccard score descending, take top N
+    candidates.sort((a, b) => b.score - a.score);
+    return candidates.slice(0, MAX_CANDIDATES).map(c => c.candidate);
+}
+//# sourceMappingURL=deterministic-checks.js.map

package/dist/claims/deterministic-checks.js.map

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

package/dist/claims/policy.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Policy aggregation engine — pure rule engine, no LLM.
+ *
+ * Input: all Verdicts + associated EvidenceSpans for one Claim
+ * Output: a Review with decision and matched rule
+ *
+ * Rules are evaluated in order, first match wins.
+ */
+import { Verdict, EvidenceSpan, Review } from './types.js';
+export interface PolicyInput {
+    claimId: string;
+    riskLevel: 'low' | 'medium' | 'high';
+    verdicts: Verdict[];
+    evidences: EvidenceSpan[];
+}
+/**
+ * Run all rules against a single claim's data and produce a Review.
+ */
+export declare function aggregateClaim(input: PolicyInput): Review;
+/**
+ * Aggregate all claims that have verdicts but no review yet.
+ * Returns the new reviews.
+ */
+export declare function aggregateAll(claimVerdicts: Array<PolicyInput>): Review[];
+//# sourceMappingURL=policy.d.ts.map

package/dist/claims/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/claims/policy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,OAAO,EACP,YAAY,EACZ,MAAM,EAIP,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,SAAS,EAAE,YAAY,EAAE,CAAC;CAC3B;AAqJD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CA+BzD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,aAAa,EAAE,KAAK,CAAC,WAAW,CAAC,GAChC,MAAM,EAAE,CAEV"}

package/dist/claims/policy.js

@@ -0,0 +1,168 @@
+/**
+ * Policy aggregation engine — pure rule engine, no LLM.
+ *
+ * Input: all Verdicts + associated EvidenceSpans for one Claim
+ * Output: a Review with decision and matched rule
+ *
+ * Rules are evaluated in order, first match wins.
+ */
+/**
+ * Evaluate deterministic checks for a set of verdicts + evidences.
+ */
+function computeChecks(verdicts, evidences) {
+    const stanceCounts = { support: 0, refute: 0, insufficient: 0 };
+    for (const v of verdicts) {
+        stanceCounts[v.stance]++;
+    }
+    // Source independence: count distinct source cluster IDs
+    const uniqueSources = new Set(evidences
+        .filter(e => e.sourceClusterId)
+        .map(e => e.sourceClusterId));
+    const sourceIndependent = uniqueSources.size >= 2;
+    return {
+        sourceIndependent,
+        hasRefute: stanceCounts.refute > 0,
+        allSupport: stanceCounts.support > 0 && stanceCounts.refute === 0 && stanceCounts.insufficient === 0,
+    };
+}
+/**
+ * Build conflict info from verdicts+evidences for refute scenarios.
+ */
+function buildConflict(verdicts, evidences) {
+    const refutingVerdicts = verdicts.filter(v => v.stance === 'refute');
+    const supportingVerdicts = verdicts.filter(v => v.stance === 'support');
+    if (refutingVerdicts.length === 0)
+        return undefined;
+    const supportingQuotes = supportingVerdicts
+        .slice(0, 5)
+        .map(v => {
+        const ev = evidences.find(e => v.evidenceIds.includes(e.id));
+        return `${v.id}: ${ev?.quote.slice(0, 100) || 'no quote'}`;
+    });
+    const refutingQuotes = refutingVerdicts
+        .slice(0, 5)
+        .map(v => {
+        const ev = evidences.find(e => v.evidenceIds.includes(e.id));
+        return `${v.id}: ${ev?.quote.slice(0, 100) || 'no quote'}`;
+    });
+    return {
+        summary: `Claim is supported by ${supportingVerdicts.length} evidence(s) and refuted by ${refutingVerdicts.length} evidence(s)`,
+        supporting: supportingQuotes,
+        refuting: refutingQuotes,
+    };
+}
+// ── Rules (evaluated in order) ──────────────────────────────────────
+const RULES = [
+    // #1 singleRefute: any refute → needsReview
+    {
+        name: 'singleRefute',
+        evaluate(input) {
+            const hasRefute = input.verdicts.some(v => v.stance === 'refute');
+            return hasRefute ? 'needsReview' : null;
+        },
+    },
+    // #2 highRiskInsufficient: high risk + <2 independent sources → needsReview
+    {
+        name: 'highRiskInsufficient',
+        evaluate(input) {
+            if (input.riskLevel !== 'high')
+                return null;
+            const uniqueSources = new Set(input.evidences.filter(e => e.sourceClusterId).map(e => e.sourceClusterId));
+            if (uniqueSources.size < 2)
+                return 'needsReview';
+            return null;
+        },
+    },
+    // #3 dualSourceSupport: ≥2 independent sources + all support → approved
+    {
+        name: 'dualSourceSupport',
+        evaluate(input) {
+            const uniqueSources = new Set(input.evidences.filter(e => e.sourceClusterId).map(e => e.sourceClusterId));
+            if (uniqueSources.size < 2)
+                return null;
+            const allSupport = input.verdicts.every(v => v.stance === 'support');
+            if (allSupport)
+                return 'approved';
+            return null;
+        },
+    },
+    // #4 dualSourceMixed: ≥2 sources but some insufficient → needsReview
+    {
+        name: 'dualSourceMixed',
+        evaluate(input) {
+            const uniqueSources = new Set(input.evidences.filter(e => e.sourceClusterId).map(e => e.sourceClusterId));
+            if (uniqueSources.size < 2)
+                return null;
+            const hasInsufficient = input.verdicts.some(v => v.stance === 'insufficient');
+            if (hasInsufficient)
+                return 'needsReview';
+            return null;
+        },
+    },
+    // #5 singleSource: only 1 independent source → needsReview
+    {
+        name: 'singleSource',
+        evaluate(input) {
+            const uniqueSources = new Set(input.evidences.filter(e => e.sourceClusterId).map(e => e.sourceClusterId));
+            if (uniqueSources.size === 1)
+                return 'needsReview';
+            return null;
+        },
+    },
+    // #6 allInsufficient: all verdicts are insufficient → needsReview
+    {
+        name: 'allInsufficient',
+        evaluate(input) {
+            if (input.verdicts.length === 0)
+                return null;
+            const allInsufficient = input.verdicts.every(v => v.stance === 'insufficient');
+            return allInsufficient ? 'needsReview' : null;
+        },
+    },
+    // #7 fallback: catch-all
+    {
+        name: 'fallback',
+        evaluate() {
+            return 'needsReview';
+        },
+    },
+];
+// ── Aggregation ─────────────────────────────────────────────────────
+/**
+ * Run all rules against a single claim's data and produce a Review.
+ */
+export function aggregateClaim(input) {
+    const checks = computeChecks(input.verdicts, input.evidences);
+    let decision = 'needsReview';
+    let matchedRule = 'fallback';
+    for (const rule of RULES) {
+        const result = rule.evaluate(input);
+        if (result !== null) {
+            decision = result;
+            matchedRule = rule.name;
+            break;
+        }
+    }
+    const review = {
+        claimId: input.claimId,
+        decision,
+        autoPass: decision === 'approved',
+        checks,
+        matchedRule,
+        reviewer: 'agent',
+        reviewedAt: Date.now(),
+    };
+    // Populate conflict only when refute exists
+    if (checks.hasRefute) {
+        review.conflict = buildConflict(input.verdicts, input.evidences);
+    }
+    return review;
+}
+/**
+ * Aggregate all claims that have verdicts but no review yet.
+ * Returns the new reviews.
+ */
+export function aggregateAll(claimVerdicts) {
+    return claimVerdicts.map(aggregateClaim);
+}
+//# sourceMappingURL=policy.js.map

package/dist/claims/policy.js.map

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

package/dist/claims/store.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Claims store — CRUD operations for claims/*.json files.
+ *
+ * Each session directory has a claims/ subdirectory with four files
+ * using the same envelope format as results.json/graph.json:
+ *   { "status": "ok", "data": { "claims": [...] } }
+ */
+import { Claim, EvidenceSpan, Verdict, Review, ReviewStatus } from './types.js';
+export declare function loadClaims(sessionDir: string): Claim[];
+export declare function saveClaims(sessionDir: string, claims: Claim[]): void;
+/** Allocate next claim ID: cl_<seq>. Reads current count from file. */
+export declare function nextClaimId(sessionDir: string): string;
+export declare function loadEvidences(sessionDir: string): EvidenceSpan[];
+export declare function saveEvidences(sessionDir: string, evidences: EvidenceSpan[]): void;
+/** Allocate next evidence ID: ev_<seq>. */
+export declare function nextEvidenceId(sessionDir: string): string;
+export declare function loadVerdicts(sessionDir: string): Verdict[];
+export declare function saveVerdicts(sessionDir: string, verdicts: Verdict[]): void;
+/** Allocate next verdict ID: vd_<seq>. */
+export declare function nextVerdictId(sessionDir: string): string;
+export declare function loadReviews(sessionDir: string): Review[];
+export declare function saveReviews(sessionDir: string, reviews: Review[]): void;
+/** Get claims filtered by status */
+export declare function getClaimsByStatus(sessionDir: string, status?: Claim['status']): Claim[];
+/** Get reviews filtered by decision */
+export declare function getReviewsByDecision(sessionDir: string, decision?: ReviewStatus): Review[];
+/** Get evidence for a specific claim */
+export declare function getEvidenceForClaim(sessionDir: string, claimId: string): EvidenceSpan[];
+/** Get verdicts for a specific claim */
+export declare function getVerdictsForClaim(sessionDir: string, claimId: string): Verdict[];
+//# sourceMappingURL=store.d.ts.map

package/dist/claims/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/claims/store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EACL,KAAK,EACL,YAAY,EACZ,OAAO,EACP,MAAM,EACN,YAAY,EACb,MAAM,YAAY,CAAC;AAkEpB,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK,EAAE,CAEtD;AAED,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAGpE;AAED,uEAAuE;AACvE,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAItD;AAID,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE,CAEhE;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,IAAI,CAGjF;AAED,2CAA2C;AAC3C,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAIzD;AAID,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,EAAE,CAE1D;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAG1E;AAED,0CAA0C;AAC1C,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAIxD;AAID,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAExD;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAGvE;AAID,oCAAoC;AACpC,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,GACvB,KAAK,EAAE,CAIT;AAED,uCAAuC;AACvC,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,YAAY,GACtB,MAAM,EAAE,CAIV;AAED,wCAAwC;AACxC,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,YAAY,EAAE,CAEhB;AAED,wCAAwC;AACxC,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,EAAE,CAEX"}

package/dist/claims/store.js

@@ -0,0 +1,127 @@
+/**
+ * Claims store — CRUD operations for claims/*.json files.
+ *
+ * Each session directory has a claims/ subdirectory with four files
+ * using the same envelope format as results.json/graph.json:
+ *   { "status": "ok", "data": { "claims": [...] } }
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+// ── Path helpers ────────────────────────────────────────────────────
+function claimsDir(sessionDir) {
+    return join(sessionDir, 'claims');
+}
+function claimsFile(sessionDir) {
+    return join(claimsDir(sessionDir), 'claims.json');
+}
+function evidencesFile(sessionDir) {
+    return join(claimsDir(sessionDir), 'evidences.json');
+}
+function verdictsFile(sessionDir) {
+    return join(claimsDir(sessionDir), 'verdicts.json');
+}
+function reviewsFile(sessionDir) {
+    return join(claimsDir(sessionDir), 'reviews.json');
+}
+function ensureClaimsDir(sessionDir) {
+    const dir = claimsDir(sessionDir);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+function loadArray(file) {
+    if (!existsSync(file))
+        return [];
+    try {
+        const raw = readFileSync(file, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (parsed.status === 'ok' && Array.isArray(parsed.data?.items)) {
+            return parsed.data.items;
+        }
+        return [];
+    }
+    catch {
+        return [];
+    }
+}
+function writeArray(file, items) {
+    const dir = file.substring(0, file.lastIndexOf(/[\\/]/.test(file) ? file.match(/[\\/]/)[0] : '/'));
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(file, JSON.stringify({ status: 'ok', data: { items } }, null, 2), 'utf-8');
+}
+// ── Claims ──────────────────────────────────────────────────────────
+export function loadClaims(sessionDir) {
+    return loadArray(claimsFile(sessionDir));
+}
+export function saveClaims(sessionDir, claims) {
+    ensureClaimsDir(sessionDir);
+    writeArray(claimsFile(sessionDir), claims);
+}
+/** Allocate next claim ID: cl_<seq>. Reads current count from file. */
+export function nextClaimId(sessionDir) {
+    const claims = loadClaims(sessionDir);
+    const seq = claims.length + 1;
+    return `cl_${String(seq).padStart(3, '0')}`;
+}
+// ── EvidenceSpans ────────────────────────────────────────────────────
+export function loadEvidences(sessionDir) {
+    return loadArray(evidencesFile(sessionDir));
+}
+export function saveEvidences(sessionDir, evidences) {
+    ensureClaimsDir(sessionDir);
+    writeArray(evidencesFile(sessionDir), evidences);
+}
+/** Allocate next evidence ID: ev_<seq>. */
+export function nextEvidenceId(sessionDir) {
+    const evs = loadEvidences(sessionDir);
+    const seq = evs.length + 1;
+    return `ev_${String(seq).padStart(3, '0')}`;
+}
+// ── Verdicts ────────────────────────────────────────────────────────
+export function loadVerdicts(sessionDir) {
+    return loadArray(verdictsFile(sessionDir));
+}
+export function saveVerdicts(sessionDir, verdicts) {
+    ensureClaimsDir(sessionDir);
+    writeArray(verdictsFile(sessionDir), verdicts);
+}
+/** Allocate next verdict ID: vd_<seq>. */
+export function nextVerdictId(sessionDir) {
+    const vds = loadVerdicts(sessionDir);
+    const seq = vds.length + 1;
+    return `vd_${String(seq).padStart(3, '0')}`;
+}
+// ── Reviews ─────────────────────────────────────────────────────────
+export function loadReviews(sessionDir) {
+    return loadArray(reviewsFile(sessionDir));
+}
+export function saveReviews(sessionDir, reviews) {
+    ensureClaimsDir(sessionDir);
+    writeArray(reviewsFile(sessionDir), reviews);
+}
+// ── Helpers ─────────────────────────────────────────────────────────
+/** Get claims filtered by status */
+export function getClaimsByStatus(sessionDir, status) {
+    const all = loadClaims(sessionDir);
+    if (!status)
+        return all;
+    return all.filter(c => c.status === status);
+}
+/** Get reviews filtered by decision */
+export function getReviewsByDecision(sessionDir, decision) {
+    const all = loadReviews(sessionDir);
+    if (!decision)
+        return all;
+    return all.filter(r => r.decision === decision);
+}
+/** Get evidence for a specific claim */
+export function getEvidenceForClaim(sessionDir, claimId) {
+    return loadEvidences(sessionDir).filter(e => e.claimId === claimId);
+}
+/** Get verdicts for a specific claim */
+export function getVerdictsForClaim(sessionDir, claimId) {
+    return loadVerdicts(sessionDir).filter(v => v.claimId === claimId);
+}
+//# sourceMappingURL=store.js.map

package/dist/claims/store.js.map

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