sxng-cli 1.2.0 → 1.2.2

package/dist/deep/local-doc/indexer.js

@@ -0,0 +1,85 @@
+/**
+ * Indexer — Orama index creation, persistence, and loading.
+ *
+ * Builds BM25 full-text indexes for document chunks, persists them
+ * as JSON files under .sxng/docs/<path-hash>/, and restores them
+ * on subsequent searches.
+ */
+import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'fs';
+import { resolve, join } from 'path';
+import { createHash } from 'crypto';
+import { create, insertMultiple } from '@orama/orama';
+import { persist, restore } from '@orama/plugin-data-persistence';
+import { ORAMA_SCHEMA } from './types.js';
+const BATCH_SIZE = 500;
+// ── Path utilities ────────────────────────────────────────────────────
+/** Get .sxng root directory (cwd-based) */
+function getSxngRoot() {
+    return join(process.cwd(), '.sxng');
+}
+/** Get docs index directory */
+function getDocsDir() {
+    return join(getSxngRoot(), 'docs');
+}
+/** Generate deterministic short hash from a path */
+export function getIndexPath(rootPath) {
+    const abs = resolve(rootPath);
+    const hash = createHash('sha256').update(abs).digest('hex').slice(0, 16);
+    return join(getDocsDir(), hash);
+}
+// ── Index building ────────────────────────────────────────────────────
+export async function buildIndex(rootPath, chunks) {
+    const absRoot = resolve(rootPath);
+    const indexPath = getIndexPath(rootPath);
+    // Ensure directory exists
+    mkdirSync(indexPath, { recursive: true });
+    // Create index with default tokenizer (handles Latin text)
+    // CJK support: use @orama/tokenizers/mandarin via components.tokenizer if needed
+    const db = await create({
+        schema: ORAMA_SCHEMA,
+    });
+    if (chunks.length > 0) {
+        // Batch insert to avoid issues with very large arrays
+        for (let i = 0; i < chunks.length; i += BATCH_SIZE) {
+            const batch = chunks.slice(i, i + BATCH_SIZE);
+            await insertMultiple(db, batch);
+        }
+    }
+    // Persist to JSON
+    const json = await persist(db, 'json');
+    writeFileSync(join(indexPath, 'index.json'), json, 'utf-8');
+    // Write meta
+    const meta = {
+        rootPath: absRoot,
+        files: new Set(chunks.map(c => c.filePath)).size,
+        chunks: chunks.length,
+        indexedAt: Date.now(),
+    };
+    writeFileSync(join(indexPath, 'meta.json'), JSON.stringify(meta, null, 2), 'utf-8');
+    return { indexPath, meta };
+}
+// ── Index loading ─────────────────────────────────────────────────────
+export async function loadIndex(rootPath) {
+    const indexPath = getIndexPath(rootPath);
+    const data = readFileSync(join(indexPath, 'index.json'), 'utf-8');
+    return restore('json', data);
+}
+// ── Index detection ───────────────────────────────────────────────────
+export function hasIndex(rootPath) {
+    const indexPath = getIndexPath(rootPath);
+    return existsSync(join(indexPath, 'index.json'));
+}
+// ── Index metadata ────────────────────────────────────────────────────
+export function getIndexMeta(rootPath) {
+    const indexPath = getIndexPath(rootPath);
+    const metaFile = join(indexPath, 'meta.json');
+    if (!existsSync(metaFile))
+        return null;
+    try {
+        return JSON.parse(readFileSync(metaFile, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=indexer.js.map

package/dist/deep/local-doc/indexer.js.map

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

package/dist/deep/local-doc/scanner.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Scanner — file scanning + structure-aware chunking
+ *
+ * Scans a directory for documents, parses YAML frontmatter,
+ * and splits content into chunks using chunk-smart (markdown)
+ * or paragraph splitting (plain text).
+ */
+import { ScannedChunk, ScannerOptions } from './types.js';
+export declare function scan(rootPath: string, options?: ScannerOptions): ScannedChunk[];
+//# sourceMappingURL=scanner.d.ts.map

package/dist/deep/local-doc/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../../src/deep/local-doc/scanner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAwD1D,wBAAgB,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,YAAY,EAAE,CA4I/E"}

package/dist/deep/local-doc/scanner.js

@@ -0,0 +1,170 @@
+/**
+ * Scanner — file scanning + structure-aware chunking
+ *
+ * Scans a directory for documents, parses YAML frontmatter,
+ * and splits content into chunks using chunk-smart (markdown)
+ * or paragraph splitting (plain text).
+ */
+import { readFileSync, statSync, readdirSync } from 'fs';
+import { resolve, extname, join } from 'path';
+import { createHash } from 'crypto';
+import { chunk } from 'chunk-smart';
+const DEFAULT_OPTIONS = {
+    extensions: ['md', 'txt'],
+    maxFileSize: 10 * 1024 * 1024, // 10MB
+};
+function parseFrontmatter(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---\n/);
+    if (!match) {
+        return { title: '', body: content };
+    }
+    const fmText = match[1];
+    const body = content.slice(match[0].length);
+    // Extract title line from YAML frontmatter (simple, no full YAML parser)
+    const titleMatch = fmText.match(/^title:\s*(.+)$/m);
+    const title = titleMatch ? titleMatch[1].trim().replace(/^['"](.*)['"]$/, '$1') : '';
+    return { title, body };
+}
+/**
+ * Split plain text by paragraph boundaries (double newlines).
+ * chunk-smart's 'paragraph' mode may return one single chunk;
+ * this provides a reliable fallback.
+ */
+function splitParagraphs(text) {
+    const parts = text.split(/\n\n+/).map(p => p.trim()).filter(p => p.length > 0);
+    if (parts.length === 0)
+        return [{ content: text, headings: [] }];
+    return parts.map(p => ({ content: p, headings: [] }));
+}
+// ── ID generation ─────────────────────────────────────────────────────
+function makeId(filePath, chunkIndex) {
+    return createHash('sha256').update(`${filePath}\0${chunkIndex}`).digest('hex').slice(0, 16);
+}
+// ── Main scan function ────────────────────────────────────────────────
+export function scan(rootPath, options) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    const absRoot = resolve(rootPath);
+    // Verify path exists
+    try {
+        statSync(absRoot);
+    }
+    catch {
+        throw new Error(`Path not found: ${absRoot}`);
+    }
+    // Build glob patterns
+    const patterns = opts.extensions.map(ext => `**/*.${ext.startsWith('.') ? ext.slice(1) : ext}`);
+    // Build extension set for matching
+    const extSet = new Set(opts.extensions.map(ext => ext.startsWith('.') ? ext.toLowerCase() : `.${ext.toLowerCase()}`));
+    // Recursively collect matching files
+    const files = [];
+    function walk(dir) {
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const abs = join(dir, entry);
+            try {
+                const st = statSync(abs);
+                if (st.isDirectory()) {
+                    walk(abs);
+                }
+                else if (st.isFile() && extSet.has(extname(abs).toLowerCase())) {
+                    files.push(abs);
+                }
+            }
+            catch {
+                // Skip unreadable entries
+            }
+        }
+    }
+    walk(absRoot);
+    if (files.length === 0) {
+        return [];
+    }
+    const chunks = [];
+    let scannedFiles = 0;
+    for (const absFile of files) {
+        const relFile = absFile.startsWith(absRoot) ? absFile.slice(absRoot.length + 1) : absFile;
+        // File size check
+        try {
+            const st = statSync(absFile);
+            if (st.size > opts.maxFileSize) {
+                console.warn(`[doc-index] Skipping large file (>10MB): ${relFile}`);
+                continue;
+            }
+        }
+        catch {
+            continue;
+        }
+        // Read content
+        let content;
+        try {
+            content = readFileSync(absFile, 'utf-8');
+        }
+        catch {
+            console.warn(`[doc-index] Skipping unreadable file: ${relFile}`);
+            continue;
+        }
+        if (!content.trim()) {
+            continue;
+        }
+        // Parse frontmatter
+        const { title: fmTitle, body } = parseFrontmatter(content);
+        const docTitle = fmTitle || relFile;
+        // Chunk based on file type
+        const ext = extname(absFile).toLowerCase();
+        const isMarkdown = ext === '.md';
+        let rawChunks;
+        if (isMarkdown) {
+            try {
+                // (chunk-smart types may not include 'mode' — cast as needed)
+                const mdChunks = chunk(body, { mode: 'markdown' });
+                rawChunks = mdChunks.map((c) => ({
+                    content: c.content,
+                    headings: (c.metadata?.headings || []).map((h) => h),
+                }));
+            }
+            catch {
+                // Fallback: treat as plain text
+                rawChunks = splitParagraphs(body);
+            }
+        }
+        else {
+            rawChunks = splitParagraphs(body);
+        }
+        if (rawChunks.length === 0) {
+            continue;
+        }
+        scannedFiles++;
+        for (let i = 0; i < rawChunks.length; i++) {
+            const rc = rawChunks[i];
+            const chunkContent = rc.content.trim();
+            if (!chunkContent)
+                continue;
+            // Build headings hierarchy: doc title + chunk headings
+            const allHeadings = [];
+            if (docTitle && fmTitle)
+                allHeadings.push(docTitle);
+            allHeadings.push(...rc.headings);
+            const id = makeId(relFile, i);
+            chunks.push({
+                id,
+                filePath: relFile,
+                title: docTitle,
+                content: chunkContent,
+                headings: allHeadings,
+                chunkIndex: i,
+                totalChunks: rawChunks.length,
+            });
+        }
+    }
+    if (chunks.length === 0 && scannedFiles === 0) {
+        return [];
+    }
+    return chunks;
+}
+//# sourceMappingURL=scanner.js.map

package/dist/deep/local-doc/scanner.js.map

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

package/dist/deep/local-doc/searcher.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Searcher — BM25 search + SessionResult formatting.
+ *
+ * Searches an Orama index, formats results as SessionResult[]
+ * with source: 'local', and injects them into the session pipeline
+ * without incrementing the round counter.
+ */
+import { SessionResult } from '../session.js';
+export interface DocSearchOptions {
+    session: string;
+    query: string;
+    path: string;
+    topK: number;
+    boost?: Record<string, number>;
+}
+export interface DocSearchResult {
+    session: string;
+    query: string;
+    path: string;
+    added: number;
+    totalPending: number;
+    results: SessionResult[];
+}
+/**
+ * Parse boost string like "title:3,headings:2,content:1"
+ * into an object { title: 3, headings: 2, content: 1 }
+ */
+declare function parseBoost(raw: string): Record<string, number>;
+/**
+ * Search local documents and inject results into session.
+ * Auto-indexes the path if not already indexed.
+ */
+export declare function docSearch(opts: DocSearchOptions): Promise<DocSearchResult>;
+export { parseBoost };
+//# sourceMappingURL=searcher.d.ts.map

package/dist/deep/local-doc/searcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searcher.d.ts","sourceRoot":"","sources":["../../../src/deep/local-doc/searcher.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,EAKL,aAAa,EACd,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,iBAAS,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASvD;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAiHhF;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/deep/local-doc/searcher.js

@@ -0,0 +1,128 @@
+/**
+ * Searcher — BM25 search + SessionResult formatting.
+ *
+ * Searches an Orama index, formats results as SessionResult[]
+ * with source: 'local', and injects them into the session pipeline
+ * without incrementing the round counter.
+ */
+import { resolve } from 'path';
+import { search as oramaSearch } from '@orama/orama';
+import { scan } from './scanner.js';
+import { buildIndex, hasIndex, loadIndex } from './indexer.js';
+import { DEFAULT_BOOST } from './types.js';
+import { appendSessionResults, getPendingResults, initSessionDir, resolveSessionPath, } from '../session.js';
+/**
+ * Parse boost string like "title:3,headings:2,content:1"
+ * into an object { title: 3, headings: 2, content: 1 }
+ */
+function parseBoost(raw) {
+    const boost = {};
+    for (const pair of raw.split(',')) {
+        const [k, v] = pair.split(':');
+        if (k && v !== undefined) {
+            boost[k.trim()] = parseFloat(v.trim());
+        }
+    }
+    return boost;
+}
+/**
+ * Search local documents and inject results into session.
+ * Auto-indexes the path if not already indexed.
+ */
+export async function docSearch(opts) {
+    const { query, topK } = opts;
+    const absPath = resolve(opts.path);
+    // Validate query
+    if (!query || query.trim().length === 0) {
+        throw Object.assign(new Error('Query is empty'), { code: 'EMPTY_QUERY' });
+    }
+    // Auto-index if needed
+    if (!hasIndex(absPath)) {
+        const chunks = scan(absPath);
+        if (chunks.length === 0) {
+            throw Object.assign(new Error(`No indexable files found in ${absPath} (supported: .md, .txt)`), { code: 'NO_INDEXABLE_FILES' });
+        }
+        await buildIndex(absPath, chunks);
+    }
+    // Load index
+    let db;
+    try {
+        db = await loadIndex(absPath);
+    }
+    catch {
+        throw Object.assign(new Error('Failed to load search index. Try re-indexing with doc-index.'), { code: 'INDEX_LOAD_ERROR' });
+    }
+    // Determine boost
+    const boost = opts.boost || DEFAULT_BOOST;
+    // Search
+    let searchResult;
+    try {
+        searchResult = await oramaSearch(db, {
+            term: query,
+            mode: 'fulltext',
+            limit: topK,
+            boost,
+        });
+    }
+    catch {
+        throw Object.assign(new Error('Search failed'), { code: 'SEARCH_ERROR' });
+    }
+    if (!searchResult.hits || searchResult.hits.length === 0) {
+        return {
+            session: opts.session,
+            query,
+            path: absPath,
+            added: 0,
+            totalPending: 0,
+            results: [],
+        };
+    }
+    // Format as SessionResult[]
+    const results = [];
+    for (const hit of searchResult.hits) {
+        const doc = hit.document;
+        // Build title: "DocumentName — Section / Subsection"
+        const sectionParts = [];
+        if (doc.headings && doc.headings.length > 0) {
+            sectionParts.push(...doc.headings);
+        }
+        let title;
+        if (sectionParts.length > 0) {
+            title = `${doc.title || doc.filePath} — ${sectionParts.join(' / ')}`;
+        }
+        else {
+            title = doc.title || doc.filePath || 'Untitled';
+        }
+        // Build file:/// URL with absolute path
+        const absFile = resolve(absPath, doc.filePath);
+        const url = `file://${absFile}#chunk-${doc.chunkIndex}`;
+        results.push({
+            url,
+            title,
+            content: doc.content || '',
+            source: 'local',
+            score: hit.score,
+            filePath: doc.filePath,
+            headings: doc.headings || [],
+            chunkIndex: doc.chunkIndex,
+            status: undefined, // set to 'pending' by appendSessionResults
+        });
+    }
+    // Inject into session (skip round increment — merged with current web round)
+    const sessionDir = resolveSessionPath(opts.session);
+    initSessionDir(sessionDir); // ensure meta.json exists
+    const { added, total } = appendSessionResults(sessionDir, results, {
+        skipRoundIncrement: true,
+    });
+    const pendingCount = getPendingResults(sessionDir).length;
+    return {
+        session: sessionDir,
+        query,
+        path: absPath,
+        added,
+        totalPending: pendingCount,
+        results,
+    };
+}
+export { parseBoost };
+//# sourceMappingURL=searcher.js.map

package/dist/deep/local-doc/searcher.js.map

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

package/dist/deep/local-doc/types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Types for local document RAG (doc-index / doc-search)
+ */
+export interface ScannedChunk {
+    id: string;
+    filePath: string;
+    title: string;
+    content: string;
+    headings: string[];
+    chunkIndex: number;
+    totalChunks: number;
+}
+export interface ScannerOptions {
+    extensions?: string[];
+    maxFileSize?: number;
+}
+export interface IndexLocation {
+    indexPath: string;
+    meta: {
+        rootPath: string;
+        files: number;
+        chunks: number;
+        indexedAt: number;
+    };
+}
+export declare const ORAMA_SCHEMA: {
+    readonly id: "string";
+    readonly filePath: "string";
+    readonly title: "string";
+    readonly content: "string";
+    readonly headings: "string[]";
+    readonly chunkIndex: "number";
+    readonly totalChunks: "number";
+};
+export declare const DEFAULT_BOOST: {
+    readonly title: 3;
+    readonly headings: 2;
+    readonly content: 1;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/deep/local-doc/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/deep/local-doc/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,eAAO,MAAM,YAAY;;;;;;;;CAQf,CAAC;AAEX,eAAO,MAAM,aAAa;;;;CAIhB,CAAC"}

package/dist/deep/local-doc/types.js

@@ -0,0 +1,18 @@
+/**
+ * Types for local document RAG (doc-index / doc-search)
+ */
+export const ORAMA_SCHEMA = {
+    id: 'string',
+    filePath: 'string',
+    title: 'string',
+    content: 'string',
+    headings: 'string[]',
+    chunkIndex: 'number',
+    totalChunks: 'number',
+};
+export const DEFAULT_BOOST = {
+    title: 3,
+    headings: 2,
+    content: 1,
+};
+//# sourceMappingURL=types.js.map

package/dist/deep/local-doc/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/deep/local-doc/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AA2BH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,EAAE,EAAE,QAAQ;IACZ,QAAQ,EAAE,QAAQ;IAClB,KAAK,EAAE,QAAQ;IACf,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,QAAQ;IACpB,WAAW,EAAE,QAAQ;CACb,CAAC;AAEX,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,KAAK,EAAE,CAAC;IACR,QAAQ,EAAE,CAAC;IACX,OAAO,EAAE,CAAC;CACF,CAAC"}

package/dist/deep/quality-assess.d.ts

@@ -1,20 +1,21 @@
 /**
  * Result quality assessment for deep search sessions.
  *
- * After each search round, compute quality indicators independently.
- * Each indicator has its own threshold — no weighted sum.
+ * Programmatic pre-filter: removes obviously poor results before
+ * Agent review. Agent makes the final quality decision based on
+ * title, content, and source.
  *
- * Verdict logic:
- * - good:    all indicators pass
- * - acceptable: ≤2 indicators fail
- * - poor:    ≥3 indicators fail
+ * Three indicators (independent thresholds, no weighted sum):
+ * - contentDepth: average extracted content length
+ * - sourceDiversity: number of distinct domains
+ * - novelty: fraction not similar to existing results (SimHash)
  *
- * Novelty uses SimHash similarity < 0.75 as "not similar" threshold
- * (paired with dedup threshold of 0.85).
+ * Verdict logic:
+ * - good:    all pass
+ * - acceptable: 1 fails
+ * - poor:    ≥2 fail
  */
-import { DirectedGraph } from 'graphology';
 import { SessionResult } from './session.js';
-import { GraphNodeAttrs, GraphEdgeAttrs } from './graph.js';
 export interface IndicatorResult {
     value: number;
     threshold: number;
@@ -22,7 +23,6 @@ export interface IndicatorResult {
 }
 export interface QualityBreakdown {
     contentDepth: IndicatorResult;
-    entityRichness: IndicatorResult;
     sourceDiversity: IndicatorResult;
     novelty: IndicatorResult;
 }
@@ -33,13 +33,12 @@ export interface QualityScore {
 }
 export interface QualityThresholds {
     contentDepth: number;
-    entityRichness: number;
     sourceDiversity: number;
     novelty: number;
 }
 /** Assess the quality of results against session context.
+ *  Programmatic pre-filter only — Agent makes final quality decision.
  *  All indicators use independent thresholds — no weighted sum.
- *  Note: resultCount is intentionally excluded — Agent decides how many results to keep.
  */
-export declare function assessResultQuality(results: SessionResult[], sessionResults: SessionResult[], graph: DirectedGraph<GraphNodeAttrs, GraphEdgeAttrs>, thresholds?: Partial<QualityThresholds>): QualityScore;
+export declare function assessResultQuality(results: SessionResult[], sessionResults: SessionResult[], thresholds?: Partial<QualityThresholds>): QualityScore;
 //# sourceMappingURL=quality-assess.d.ts.map

package/dist/deep/quality-assess.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quality-assess.d.ts","sourceRoot":"","sources":["../../src/deep/quality-assess.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAI5D,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC7B,YAAY,EAAE,eAAe,CAAC;IAC9B,cAAc,EAAE,eAAe,CAAC;IAChC,eAAe,EAAE,eAAe,CAAC;IACjC,OAAO,EAAE,eAAe,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,MAAM,CAAC;IACxC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACnB;AAiGD;;;GAGG;AACH,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,aAAa,EAAE,EACxB,cAAc,EAAE,aAAa,EAAE,EAC/B,KAAK,EAAE,aAAa,CAAC,cAAc,EAAE,cAAc,CAAC,EACpD,UAAU,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACxC,YAAY,CAwBd"}
+{"version":3,"file":"quality-assess.d.ts","sourceRoot":"","sources":["../../src/deep/quality-assess.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAI7C,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC7B,YAAY,EAAE,eAAe,CAAC;IAC9B,eAAe,EAAE,eAAe,CAAC;IACjC,OAAO,EAAE,eAAe,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,MAAM,CAAC;IACxC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACnB;AAqFD;;;GAGG;AACH,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,aAAa,EAAE,EACxB,cAAc,EAAE,aAAa,EAAE,EAC/B,UAAU,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACxC,YAAY,CAuBd"}