instar 1.3.755 → 1.3.757

package/dist/core/TopicClassifier.js

@@ -1,144 +0,0 @@
-/**
- * TopicClassifier — Deterministic, rule-based topic classification.
- *
- * Part of the Consent & Discovery Framework (Round 2 hardening).
- *
- * Why not LLM-based:
- *   Adversarial reviewer flagged that LLM-based topic extraction reintroduces
- *   prompt injection risk into the discovery pipeline. A user could craft input
- *   that manipulates the topic classifier to trigger specific feature surfacing.
- *
- * This classifier uses keyword matching against a fixed taxonomy. It's less
- * nuanced than an LLM classifier but has zero injection surface. The evaluator
- * (which IS LLM-based) receives these labels as sanitized input.
- *
- * Design:
- *   - Fixed taxonomy of ~15 topic categories
- *   - Keyword sets per category, scored by match density
- *   - Returns top category + confidence score
- *   - Also classifies conversation intent (same approach)
- *   - Input sanitized: lowercased, truncated, non-alpha stripped
- */
-// ── Keyword Taxonomy ─────────────────────────────────────────────────
-const TOPIC_KEYWORDS = {
-    debugging: ['bug', 'error', 'fix', 'broken', 'crash', 'fail', 'exception', 'stack trace', 'debug', 'issue', 'wrong', 'not working', 'undefined', 'null', 'timeout', 'hang', 'stuck'],
-    configuration: ['config', 'setting', 'enable', 'disable', 'toggle', 'option', 'preference', 'setup', 'configure', 'turn on', 'turn off', 'activate', 'deactivate', 'parameter'],
-    deployment: ['deploy', 'ship', 'release', 'publish', 'build', 'ci', 'cd', 'pipeline', 'production', 'staging', 'rollback', 'version', 'upgrade'],
-    security: ['security', 'auth', 'token', 'secret', 'permission', 'access', 'encrypt', 'credential', 'password', 'vulnerability', 'trust', 'certificate'],
-    communication: ['message', 'telegram', 'email', 'notify', 'alert', 'send', 'reply', 'chat', 'notification', 'whatsapp', 'slack'],
-    monitoring: ['monitor', 'health', 'status', 'metric', 'log', 'dashboard', 'alert', 'uptime', 'latency', 'memory', 'disk', 'cpu', 'usage'],
-    development: ['code', 'implement', 'function', 'class', 'test', 'refactor', 'api', 'endpoint', 'module', 'type', 'interface', 'typescript', 'javascript'],
-    documentation: ['doc', 'readme', 'spec', 'document', 'explain', 'comment', 'description', 'guide', 'tutorial', 'wiki'],
-    collaboration: ['agent', 'threadline', 'network', 'machine', 'sync', 'share', 'collaborate', 'peer', 'relay', 'handshake', 'discover'],
-    'data-management': ['database', 'sqlite', 'backup', 'restore', 'snapshot', 'migrate', 'data', 'storage', 'file', 'persist', 'cache'],
-    automation: ['job', 'schedule', 'cron', 'automate', 'workflow', 'task', 'recurring', 'trigger', 'hook', 'event'],
-    performance: ['slow', 'fast', 'performance', 'optimize', 'speed', 'efficient', 'bottleneck', 'profil', 'memory leak', 'resource'],
-    architecture: ['architecture', 'design', 'pattern', 'structure', 'system', 'framework', 'component', 'layer', 'module', 'principle'],
-    onboarding: ['new', 'start', 'begin', 'init', 'first', 'getting started', 'install', 'setup', 'introduction', 'welcome'],
-    general: [],
-};
-const INTENT_KEYWORDS = {
-    debugging: ['bug', 'error', 'fix', 'broken', 'crash', 'fail', 'not working', 'wrong', 'issue', 'debug', 'trace'],
-    configuring: ['config', 'setting', 'enable', 'disable', 'setup', 'configure', 'option', 'toggle', 'turn on', 'turn off'],
-    exploring: ['what', 'how', 'why', 'show', 'list', 'tell me', 'capabilities', 'features', 'can you', 'do you'],
-    building: ['build', 'create', 'implement', 'add', 'make', 'write', 'develop', 'code', 'new feature', 'spec'],
-    asking: ['question', 'help', 'explain', 'clarify', 'understand', 'meaning', 'difference', 'purpose'],
-    monitoring: ['check', 'status', 'health', 'monitor', 'watch', 'track', 'log', 'dashboard', 'metric'],
-    unknown: [],
-};
-const PROBLEM_KEYWORDS = {
-    'connectivity': ['connect', 'network', 'timeout', 'offline', 'unreachable', 'dns', 'tunnel'],
-    'authentication': ['auth', 'login', '401', '403', 'forbidden', 'unauthorized', 'token expired'],
-    'data-loss': ['lost', 'missing', 'deleted', 'gone', 'disappeared', 'corrupted', 'empty'],
-    'resource-exhaustion': ['memory', 'disk full', 'out of space', 'quota', 'limit', 'exceeded', 'oom'],
-    'permission': ['permission', 'denied', 'access', 'readonly', 'write', 'forbidden'],
-};
-// ── Classifier ───────────────────────────────────────────────────────
-const MAX_INPUT_LENGTH = 500;
-/**
- * Sanitize input text for classification.
- * Strips control characters, lowercases, truncates.
- */
-export function sanitizeInput(text) {
-    return text
-        .slice(0, MAX_INPUT_LENGTH)
-        .toLowerCase()
-        .replace(/[^\w\s\-'.?!]/g, ' ')
-        .replace(/\s+/g, ' ')
-        .trim();
-}
-/**
- * Score a text against a keyword set.
- * Returns 0-1 based on match density.
- */
-function scoreKeywords(text, keywords) {
-    if (keywords.length === 0)
-        return 0;
-    let matches = 0;
-    for (const kw of keywords) {
-        if (text.includes(kw))
-            matches++;
-    }
-    return matches / keywords.length;
-}
-/**
- * Classify a text into topic category and conversation intent.
- * Purely deterministic — no LLM, no injection surface.
- */
-export function classify(rawText) {
-    const text = sanitizeInput(rawText);
-    // Score topics
-    let bestTopic = 'general';
-    let bestTopicScore = 0;
-    for (const [category, keywords] of Object.entries(TOPIC_KEYWORDS)) {
-        if (category === 'general')
-            continue;
-        const score = scoreKeywords(text, keywords);
-        if (score > bestTopicScore) {
-            bestTopicScore = score;
-            bestTopic = category;
-        }
-    }
-    // Score intents
-    let bestIntent = 'unknown';
-    let bestIntentScore = 0;
-    for (const [intent, keywords] of Object.entries(INTENT_KEYWORDS)) {
-        if (intent === 'unknown')
-            continue;
-        const score = scoreKeywords(text, keywords);
-        if (score > bestIntentScore) {
-            bestIntentScore = score;
-            bestIntent = intent;
-        }
-    }
-    // Detect problem categories
-    const problemCategories = [];
-    for (const [problem, keywords] of Object.entries(PROBLEM_KEYWORDS)) {
-        if (scoreKeywords(text, keywords) > 0) {
-            problemCategories.push(problem);
-        }
-    }
-    return {
-        topicCategory: bestTopic,
-        topicConfidence: Math.min(bestTopicScore * 5, 1), // Scale up for useful range
-        conversationIntent: bestIntent,
-        intentConfidence: Math.min(bestIntentScore * 5, 1),
-        problemCategories,
-    };
-}
-/**
- * Classify and return a sanitized DiscoveryContext-compatible object.
- * This is the main entry point for the discovery pipeline.
- */
-export function classifyForDiscovery(rawText, autonomyProfile, enabledFeatures, userId) {
-    const result = classify(rawText);
-    return {
-        topicCategory: result.topicCategory,
-        conversationIntent: result.conversationIntent,
-        problemCategories: result.problemCategories,
-        autonomyProfile,
-        enabledFeatures,
-        userId: userId || 'default',
-    };
-}
-//# sourceMappingURL=TopicClassifier.js.map

package/dist/core/TopicClassifier.js.map

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