sxng-cli 1.0.5 → 1.0.7

package/dist/deep/keywords.js

@@ -0,0 +1,293 @@
+/**
+ * Entity extraction using compromise NLP (English) + BM25 bigrams (CJK)
+ *
+ * English: compromise extracts named entities + noun phrases (POS-aware)
+ * CJK: character bigrams with BM25 scoring (compromise doesn't support CJK)
+ * Both phases use BM25 cross-document scoring for relevance ranking.
+ */
+import nlp from 'compromise';
+// Generic nouns that are not meaningful as entities
+const GENERIC_NOUNS = new Set([
+    'language', 'version', 'time', 'way', 'thing', 'part', 'case', 'point',
+    'fact', 'area', 'end', 'result', 'side', 'kind', 'head', 'house',
+    'hand', 'place', 'week', 'system', 'example', 'article', 'page',
+    'site', 'section', 'number', 'step', 'process', 'method', 'approach',
+    'problem', 'question', 'answer', 'issue', 'error', 'change', 'update',
+    'user', 'data', 'file', 'code', 'program', 'function', 'class',
+    'value', 'name', 'key', 'list', 'set', 'type', 'field', 'table',
+    'model', 'project', 'team', 'group', 'world', 'country', 'city',
+    'year', 'month', 'day', 'today', 'people', 'person', 'work', 'job',
+    'home', 'life', 'right', 'left', 'start', 'stop', 'run', 'test',
+    'line', 'row', 'column', 'cell', 'level', 'stage', 'phase', 'state',
+    'form', 'view', 'link', 'source', 'target', 'content',
+    'support', 'feature', 'option', 'status', 'info', 'detail', 'note',
+    'idea', 'topic', 'subject', 'term', 'word', 'text', 'body', 'title',
+    'header', 'footer', 'input', 'output', 'format', 'style', 'color',
+    'size', 'length', 'width', 'height', 'depth', 'speed', 'rate',
+    'price', 'cost', 'amount', 'total', 'sum', 'diff', 'range', 'limit',
+    'access', 'control', 'rule', 'policy', 'plan', 'goal', 'task', 'action',
+    'event', 'message', 'request', 'response', 'record', 'history', 'log',
+    'report', 'search', 'filter', 'sort', 'order',
+    'performance', 'quality', 'security', 'privacy', 'release',
+    'build', 'deploy', 'config', 'setting', 'flag', 'param', 'arg',
+    'return', 'cause', 'high', 'low', 'also', 'use', 'using', 'used',
+    'need', 'needed', 'give', 'given', 'make', 'made', 'take', 'taken',
+    'include', 'included', 'provide', 'provided', 'allow', 'create', 'created',
+    'crate', 'this', 'software', 'library', 'framework', 'tool', 'guide',
+    'blog', 'post', 'stack', 'overflow', 'github', 'documentation',
+    'download', 'install', 'learn', 'tutorial', 'introduction', 'overview',
+    'summary', 'description', 'index', 'readme', 'repository', 'package',
+]);
+// Max length for an entity term — longer ones are likely title noise
+const MAX_TERM_LENGTH = 40;
+// CJK stop words for bigram extraction
+const STOP_WORDS_ZH = new Set([
+    '的', '了', '在', '是', '我', '有', '和', '就', '不', '人', '都', '一',
+    '一个', '上', '也', '很', '到', '说', '要', '去', '你', '会', '着',
+    '没有', '看', '好', '自己', '这', '他', '她', '它', '们', '那', '些',
+    '什么', '怎么', '如何', '可以', '因为', '所以', '但是', '如果', '虽然',
+    '已经', '还是', '或者', '而且', '以及', '对于', '通过', '进行', '使用',
+    '并', '及', '等', '于', '中', '为', '与', '从', '把', '被', '让',
+    '向', '对', '其', '此', '该', '每', '各', '种', '些', '某',
+]);
+// English stop words for fallback BM25
+const STOP_WORDS_EN = new Set([
+    'the', 'a', 'an', 'and', 'or', 'but', 'in', 'on', 'at', 'to', 'for',
+    'of', 'with', 'by', 'from', 'as', 'is', 'was', 'are', 'were', 'been',
+    'be', 'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could',
+    'should', 'may', 'might', 'shall', 'can', 'need', 'dare', 'ought', 'used',
+    'it', 'its', 'this', 'that', 'these', 'those', 'i', 'me', 'my', 'we',
+    'our', 'you', 'your', 'he', 'him', 'his', 'she', 'her', 'they', 'them',
+    'their', 'what', 'which', 'who', 'whom', 'when', 'where', 'why', 'how',
+    'not', 'no', 'nor', 'if', 'then', 'else', 'so', 'than', 'too', 'very',
+    'just', 'about', 'above', 'after', 'again', 'all', 'also', 'any', 'because',
+    'before', 'below', 'between', 'both', 'each', 'few', 'more', 'most',
+    'other', 'out', 'over', 'own', 'same', 'some', 'such', 'only', 'into',
+    'up', 'down', 'here', 'there', 'once', 'during', 'while', 'through',
+    'being', 'having', 'doing', 'said', 'get', 'got', 'make', 'made',
+    'like', 'well', 'back', 'even', 'still', 'way', 'take', 'come',
+    'many', 'much', 'new', 'old', 'first', 'last', 'long', 'great',
+    'little', 'right', 'good', 'bad', 'big', 'small', 'large', 'next',
+    'early', 'young', 'important', 'different', 'able', 'using', 'based',
+    'via', 'etc', 'e.g', 'i.e', 'one', 'two', 'three', 'per', 'another',
+]);
+function isPronoun(term) {
+    return term.tags != null && term.tags.includes('Pronoun');
+}
+/**
+ * Count the ratio of CJK characters in a string.
+ * Returns 0-1 where 1 = entirely CJK.
+ */
+function cjkRatio(text) {
+    let cjk = 0;
+    for (const ch of text) {
+        const code = ch.codePointAt(0);
+        if ((code >= 0x4E00 && code <= 0x9FFF) || // CJK Unified
+            (code >= 0x3040 && code <= 0x309F) || // Hiragana
+            (code >= 0x30A0 && code <= 0x30FF) || // Katakana
+            (code >= 0xAC00 && code <= 0xD7AF)) { // Hangul
+            cjk++;
+        }
+    }
+    return text.length > 0 ? cjk / text.length : 0;
+}
+/**
+ * Normalize a term: strip punctuation, trim whitespace.
+ */
+function normalizeTerm(text) {
+    return text.replace(/[.,;:!?'"»«(){}\[\]\/\\|]+$/, '').replace(/^[.,;:!?'"»«(){}\[\]\/\\|]+/, '').trim();
+}
+/**
+ * Check if a candidate term is valid as an entity.
+ */
+function isValidEntity(term) {
+    if (!term || term.length <= 2)
+        return false;
+    if (term.length > MAX_TERM_LENGTH)
+        return false;
+    if (GENERIC_NOUNS.has(term.toLowerCase()))
+        return false;
+    // Reject if mostly CJK — compromise can't parse CJK properly
+    if (cjkRatio(term) > 0.3)
+        return false;
+    // Reject if looks like a URL or path
+    if (/^https?:\/\//.test(term))
+        return false;
+    if (term.split(/[\/\\]/).length > 3)
+        return false;
+    return true;
+}
+/**
+ * Extract English entity candidates from text using compromise NLP.
+ */
+function extractEnglishCandidates(text) {
+    const doc = nlp(text);
+    const seen = new Set();
+    const candidates = [];
+    // 1. Named entities: people, places, organizations
+    const topics = doc.topics().json();
+    for (const topic of topics) {
+        const term = normalizeTerm(topic.text);
+        if (isValidEntity(term) && !seen.has(term)) {
+            seen.add(term);
+            candidates.push({ term, type: 'named' });
+        }
+    }
+    // 2. Proper nouns not already captured by topics
+    const properNouns = doc.match('#ProperNoun+').json();
+    for (const pn of properNouns) {
+        const term = normalizeTerm(pn.text);
+        if (isValidEntity(term) && !seen.has(term)) {
+            seen.add(term);
+            candidates.push({ term, type: 'proper' });
+        }
+    }
+    // 3. Noun phrases (filtered)
+    const nouns = doc.nouns().json();
+    for (const noun of nouns) {
+        if (noun.terms && noun.terms.length > 0 && isPronoun(noun.terms[0]))
+            continue;
+        const root = (noun.noun?.root || noun.text || '').replace(/[.,;:!?'"»«]+$/, '').trim();
+        if (!isValidEntity(root))
+            continue;
+        if (!seen.has(root)) {
+            seen.add(root);
+            candidates.push({ term: root, type: 'phrase' });
+        }
+    }
+    return candidates;
+}
+/**
+ * Extract CJK entity candidates using character bigrams with BM25 scoring.
+ * Only used for Chinese/Japanese/Korean text segments.
+ */
+function extractCjkCandidates(text) {
+    const cjkSegments = text.match(/[一-鿿぀-ゟ゠-ヿ가-힯]+/g) || [];
+    const tokens = [];
+    for (const segment of cjkSegments) {
+        if (segment.length <= 2) {
+            if (!STOP_WORDS_ZH.has(segment))
+                tokens.push(segment);
+            continue;
+        }
+        for (let i = 0; i < segment.length - 1; i++) {
+            const bigram = segment.substring(i, i + 2);
+            if (!STOP_WORDS_ZH.has(bigram))
+                tokens.push(bigram);
+        }
+    }
+    return tokens;
+}
+/**
+ * Score candidate terms using BM25-style cross-document frequency.
+ */
+function scoreWithBM25(perDocCandidates, topN) {
+    const N = perDocCandidates.length;
+    if (N === 0)
+        return [];
+    const docFreq = new Map();
+    const termFreqPerDoc = [];
+    for (const candidates of perDocCandidates) {
+        const tf = new Map();
+        for (const c of candidates) {
+            tf.set(c.term, (tf.get(c.term) || 0) + 1);
+        }
+        termFreqPerDoc.push(tf);
+        for (const term of tf.keys()) {
+            docFreq.set(term, (docFreq.get(term) || 0) + 1);
+        }
+    }
+    const avgDocLen = termFreqPerDoc.reduce((sum, tf) => sum + tf.size, 0) / N;
+    const k1 = 1.2;
+    const b = 0.75;
+    const results = [];
+    for (let i = 0; i < N; i++) {
+        const tf = termFreqPerDoc[i];
+        if (tf.size === 0) {
+            results.push([]);
+            continue;
+        }
+        const typeMap = new Map();
+        for (const c of perDocCandidates[i]) {
+            if (!typeMap.has(c.term))
+                typeMap.set(c.term, c.type);
+        }
+        const scored = [];
+        for (const [term, freq] of tf) {
+            const df = docFreq.get(term) || 1;
+            if (df > N * 0.9)
+                continue;
+            const idf = Math.log((N - df + 0.5) / (df + 0.5) + 1);
+            const docLen = tf.size;
+            const tfNorm = (freq * (k1 + 1)) / (freq + k1 * (1 - b + b * docLen / avgDocLen));
+            let score = tfNorm * idf;
+            const type = typeMap.get(term) || 'phrase';
+            if (type === 'named')
+                score *= 2.0;
+            else if (type === 'proper')
+                score *= 1.5;
+            if (score > 0) {
+                scored.push({ term, score, type });
+            }
+        }
+        scored.sort((a, b) => b.score - a.score);
+        results.push(scored.slice(0, topN));
+    }
+    return results;
+}
+/**
+ * Extract keywords from a collection of documents.
+ *
+ * English: compromise for POS-aware candidate extraction (named entities,
+ * proper nouns, noun phrases), filtered for validity.
+ * CJK: character bigrams with stop word filtering.
+ * Both: BM25 cross-document scoring for relevance ranking.
+ */
+export function extractKeywords(documents, topN = 5) {
+    const N = documents.length;
+    if (N === 0)
+        return [];
+    const perDocCandidates = documents.map(doc => {
+        const candidates = [];
+        // English candidates via compromise
+        candidates.push(...extractEnglishCandidates(doc));
+        // CJK candidates via bigrams (as 'phrase' type)
+        const cjkTerms = extractCjkCandidates(doc);
+        const seen = new Set(candidates.map(c => c.term));
+        for (const term of cjkTerms) {
+            if (!seen.has(term)) {
+                seen.add(term);
+                candidates.push({ term, type: 'phrase' });
+            }
+        }
+        return candidates;
+    });
+    return scoreWithBM25(perDocCandidates, topN);
+}
+/**
+ * Extract global keywords across all documents.
+ * Aggregates scores and boosts terms appearing in multiple documents.
+ */
+export function extractGlobalKeywords(documents, topN = 20) {
+    const perDoc = extractKeywords(documents, 100);
+    const aggregated = new Map();
+    const docCount = new Map();
+    const typeMap = new Map();
+    for (const keywords of perDoc) {
+        for (const kw of keywords) {
+            aggregated.set(kw.term, (aggregated.get(kw.term) || 0) + kw.score);
+            docCount.set(kw.term, (docCount.get(kw.term) || 0) + 1);
+            if (!typeMap.has(kw.term))
+                typeMap.set(kw.term, kw.type);
+        }
+    }
+    const results = [];
+    for (const [term, score] of aggregated) {
+        const docs = docCount.get(term) || 1;
+        const boosted = score * (1 + Math.log(docs));
+        results.push({ term, score: boosted, type: typeMap.get(term) || 'phrase' });
+    }
+    results.sort((a, b) => b.score - a.score);
+    return results.slice(0, topN);
+}
+//# sourceMappingURL=keywords.js.map

package/dist/deep/keywords.js.map

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

package/dist/deep/rrf.d.ts

@@ -0,0 +1,13 @@
+/**
+ * RRF (Reciprocal Rank Fusion) - Merge multiple ranked lists
+ */
+export interface RrfInputItem {
+    id: string;
+    [key: string]: unknown;
+}
+export interface RrfOutputItem {
+    id: string;
+    score: number;
+}
+export declare function rrf(rankings: Array<Array<RrfInputItem>>, k?: number): Array<RrfOutputItem>;
+//# sourceMappingURL=rrf.d.ts.map

package/dist/deep/rrf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rrf.d.ts","sourceRoot":"","sources":["../../src/deep/rrf.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,GAAG,CACf,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EACpC,CAAC,GAAE,MAAW,GACf,KAAK,CAAC,aAAa,CAAC,CAkBtB"}

package/dist/deep/rrf.js

@@ -0,0 +1,23 @@
+/**
+ * RRF (Reciprocal Rank Fusion) - Merge multiple ranked lists
+ */
+export function rrf(rankings, k = 60) {
+    if (k <= 0)
+        throw new Error(`RRF parameter k must be positive, got: ${k}`);
+    if (rankings.length === 0)
+        return [];
+    const scores = new Map();
+    for (const ranking of rankings) {
+        for (let i = 0; i < ranking.length; i++) {
+            const doc = ranking[i];
+            if (!doc.id)
+                continue;
+            const score = 1 / (k + i + 1);
+            scores.set(doc.id, (scores.get(doc.id) || 0) + score);
+        }
+    }
+    return Array.from(scores.entries())
+        .map(([id, score]) => ({ id, score }))
+        .sort((a, b) => b.score - a.score);
+}
+//# sourceMappingURL=rrf.js.map

package/dist/deep/rrf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rrf.js","sourceRoot":"","sources":["../../src/deep/rrf.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,MAAM,UAAU,GAAG,CACf,QAAoC,EACpC,IAAY,EAAE;IAEd,IAAI,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,EAAE,CAAC,CAAC;IAC3E,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAErC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEzC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACvB,IAAI,CAAC,GAAG,CAAC,EAAE;gBAAE,SAAS;YACtB,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;QAC1D,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;SAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;SACrC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;AAC3C,CAAC"}

package/dist/deep/session.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Session management for multi-round search accumulation
+ *
+ * A session directory contains:
+ * - results.json: Accumulated search result pool (deduped by URL)
+ * - graph.json: graphology knowledge graph (structural + semantic layers)
+ */
+import { DirectedGraph } from 'graphology';
+import { GraphNodeAttrs, GraphEdgeAttrs } from './graph.js';
+export interface SessionResult {
+    url: string;
+    title: string;
+    content?: string;
+    engine?: string;
+    category?: string;
+    score?: number;
+    publishedDate?: string;
+    [key: string]: unknown;
+}
+export interface SessionResultsFile {
+    status: 'ok';
+    data: {
+        results: SessionResult[];
+        rounds: number;
+    };
+}
+/** Resolve session path. Supports:
+ *  - "new": auto-create under default root with unique name
+ *  - pure name (no separators): resolve to ~/.sxng/sessions/<name>
+ *  - full path: return as-is
+ */
+export declare function resolveSessionPath(sessionValue: string): string;
+/** Ensure session directory exists and write initial meta */
+export declare function initSessionDir(sessionDir: string, owner?: string, description?: string, query?: string): void;
+/** Load accumulated results from session, or return empty */
+export declare function loadSessionResults(sessionDir: string): SessionResult[];
+/** Append new results to session results (dedup by URL) */
+export declare function appendSessionResults(sessionDir: string, newResults: SessionResult[]): {
+    added: number;
+    total: number;
+};
+/** Load graph from session, or create empty */
+export declare function loadSessionGraph(sessionDir: string): DirectedGraph<GraphNodeAttrs, GraphEdgeAttrs>;
+/** Save graph to session */
+export declare function saveSessionGraph(sessionDir: string, graph: DirectedGraph<GraphNodeAttrs, GraphEdgeAttrs>): void;
+/** Update session graph with new search results (structural layer) */
+export declare function updateSessionGraph(sessionDir: string, query: string, results: Array<{
+    url: string;
+    title: string;
+    rank?: number;
+}>, round?: number): {
+    nodesAdded: number;
+    edgesAdded: number;
+};
+/** Merge extracted content into session results (update content field by URL match) */
+export declare function mergeExtractedContent(sessionDir: string, extracted: Array<{
+    url: string;
+    content: string;
+    title?: string;
+    excerpt?: string;
+    byline?: string;
+    siteName?: string;
+    length?: number;
+    error?: string;
+}>): {
+    updated: number;
+    total: number;
+};
+//# sourceMappingURL=session.d.ts.map

package/dist/deep/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/deep/session.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAsE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIhI,MAAM,WAAW,aAAa;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IAC/B,MAAM,EAAE,IAAI,CAAC;IACb,IAAI,EAAE;QACF,OAAO,EAAE,aAAa,EAAE,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC;CACL;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAe/D;AAED,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAqB7G;AAED,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,EAAE,CActE;AAED,2DAA2D;AAC3D,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAiCtH;AAED,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAAC,cAAc,EAAE,cAAc,CAAC,CAiBlG;AAED,4BAA4B;AAC5B,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,cAAc,EAAE,cAAc,CAAC,GAAG,IAAI,CAY/G;AAED,sEAAsE;AACtE,wBAAgB,kBAAkB,CAC9B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAC7D,KAAK,CAAC,EAAE,MAAM,GACf;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAY5C;AAED,uFAAuF;AACvF,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAmCvP"}

package/dist/deep/session.js

@@ -0,0 +1,206 @@
+/**
+ * Session management for multi-round search accumulation
+ *
+ * A session directory contains:
+ * - results.json: Accumulated search result pool (deduped by URL)
+ * - graph.json: graphology knowledge graph (structural + semantic layers)
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { DirectedGraph } from 'graphology';
+import { deserializeGraph, serializeGraph, graphStats, buildStructuralEdges } from './graph.js';
+import { normalizeUrl } from './dedupe.js';
+import { loadSessionMeta } from '../commands/session.js';
+/** Resolve session path. Supports:
+ *  - "new": auto-create under default root with unique name
+ *  - pure name (no separators): resolve to ~/.sxng/sessions/<name>
+ *  - full path: return as-is
+ */
+export function resolveSessionPath(sessionValue) {
+    if (sessionValue === 'new') {
+        const root = join(homedir(), '.sxng', 'sessions');
+        if (!existsSync(root)) {
+            mkdirSync(root, { recursive: true });
+        }
+        const name = `ds_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+        return join(root, name);
+    }
+    // Pure name without path separators: resolve to default sessions dir
+    if (!sessionValue.includes('/') && !sessionValue.includes('\\')) {
+        const root = join(homedir(), '.sxng', 'sessions');
+        return join(root, sessionValue);
+    }
+    return sessionValue;
+}
+/** Ensure session directory exists and write initial meta */
+export function initSessionDir(sessionDir, owner, description, query) {
+    if (!existsSync(sessionDir)) {
+        mkdirSync(sessionDir, { recursive: true });
+    }
+    // Write or update meta.json
+    const metaFile = join(sessionDir, 'meta.json');
+    const existing = loadSessionMeta(sessionDir);
+    const now = Date.now();
+    const meta = {
+        owner: owner || existing?.owner || '',
+        description: description || existing?.description || '',
+        createdAt: existing?.createdAt || now,
+        updatedAt: now,
+        query: query || existing?.query || '',
+    };
+    try {
+        writeFileSync(metaFile, JSON.stringify(meta, null, 2), 'utf-8');
+    }
+    catch { /* meta write failure is non-critical */ }
+}
+/** Load accumulated results from session, or return empty */
+export function loadSessionResults(sessionDir) {
+    const file = join(sessionDir, 'results.json');
+    if (!existsSync(file))
+        return [];
+    try {
+        const raw = readFileSync(file, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (parsed.status === 'ok' && parsed.data?.results) {
+            return parsed.data.results;
+        }
+        return [];
+    }
+    catch {
+        return [];
+    }
+}
+/** Append new results to session results (dedup by URL) */
+export function appendSessionResults(sessionDir, newResults) {
+    const existing = loadSessionResults(sessionDir);
+    const urlMap = new Map();
+    // Index existing results by normalized URL
+    for (const r of existing) {
+        urlMap.set(normalizeUrl(r.url), r);
+    }
+    // Add new results (dedup: keep first occurrence)
+    let added = 0;
+    for (const r of newResults) {
+        const norm = normalizeUrl(r.url);
+        if (!urlMap.has(norm)) {
+            urlMap.set(norm, r);
+            added++;
+        }
+    }
+    const all = Array.from(urlMap.values());
+    const rounds = Math.max(1, (loadSessionRounds(sessionDir) || 0) + 1);
+    const file = join(sessionDir, 'results.json');
+    try {
+        writeFileSync(file, JSON.stringify({
+            status: 'ok',
+            data: { results: all, rounds },
+        }, null, 2), 'utf-8');
+    }
+    catch (e) {
+        throw new Error(`Failed to write session results to ${file}: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    return { added, total: all.length };
+}
+/** Load graph from session, or create empty */
+export function loadSessionGraph(sessionDir) {
+    const file = join(sessionDir, 'graph.json');
+    if (!existsSync(file))
+        return new DirectedGraph();
+    try {
+        const raw = readFileSync(file, 'utf-8');
+        const parsed = JSON.parse(raw);
+        const graphData = parsed.status === 'ok' && parsed.data?.graph
+            ? parsed.data.graph
+            : (parsed.nodes && parsed.edges ? parsed : null);
+        if (graphData) {
+            return deserializeGraph(graphData);
+        }
+        return new DirectedGraph();
+    }
+    catch {
+        return new DirectedGraph();
+    }
+}
+/** Save graph to session */
+export function saveSessionGraph(sessionDir, graph) {
+    const serialized = serializeGraph(graph);
+    const stats = graphStats(graph);
+    const file = join(sessionDir, 'graph.json');
+    try {
+        writeFileSync(file, JSON.stringify({
+            status: 'ok',
+            data: { graph: serialized, stats },
+        }, null, 2), 'utf-8');
+    }
+    catch (e) {
+        throw new Error(`Failed to write session graph to ${file}: ${e instanceof Error ? e.message : String(e)}`);
+    }
+}
+/** Update session graph with new search results (structural layer) */
+export function updateSessionGraph(sessionDir, query, results, round) {
+    const graph = loadSessionGraph(sessionDir);
+    const beforeNodes = graph.order;
+    const beforeEdges = graph.size;
+    buildStructuralEdges(graph, query, results, round);
+    saveSessionGraph(sessionDir, graph);
+    return {
+        nodesAdded: graph.order - beforeNodes,
+        edgesAdded: graph.size - beforeEdges,
+    };
+}
+/** Merge extracted content into session results (update content field by URL match) */
+export function mergeExtractedContent(sessionDir, extracted) {
+    const results = loadSessionResults(sessionDir);
+    const urlMap = new Map();
+    for (const r of results) {
+        urlMap.set(normalizeUrl(r.url), r);
+    }
+    let updated = 0;
+    for (const ex of extracted) {
+        if (ex.error)
+            continue;
+        const norm = normalizeUrl(ex.url);
+        const existing = urlMap.get(norm);
+        if (existing) {
+            existing.content = ex.content;
+            if (ex.excerpt)
+                existing.excerpt = ex.excerpt;
+            if (ex.byline)
+                existing.byline = ex.byline;
+            if (ex.siteName)
+                existing.siteName = ex.siteName;
+            if (ex.length)
+                existing.contentLength = ex.length;
+            updated++;
+        }
+    }
+    const all = Array.from(urlMap.values());
+    const file = join(sessionDir, 'results.json');
+    const rounds = loadSessionRounds(sessionDir) || results.length;
+    try {
+        writeFileSync(file, JSON.stringify({
+            status: 'ok',
+            data: { results: all, rounds },
+        }, null, 2), 'utf-8');
+    }
+    catch (e) {
+        throw new Error(`Failed to write session results to ${file}: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    return { updated, total: all.length };
+}
+/** Get current round number from results file */
+function loadSessionRounds(sessionDir) {
+    const file = join(sessionDir, 'results.json');
+    if (!existsSync(file))
+        return 0;
+    try {
+        const raw = readFileSync(file, 'utf-8');
+        const parsed = JSON.parse(raw);
+        return parsed.data?.rounds || 0;
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=session.js.map