mnueron 0.4.0 → 0.6.0

package/dist/lib/context-engine/intent.js

@@ -0,0 +1,139 @@
+/**
+ * Context-intent classifier.
+ *
+ * Given the user's active context (current text in editor, chat input,
+ * doc, etc.), classify WHAT KIND of task they're doing:
+ *
+ *   coding       — writing/editing source code
+ *   deploying    — release / rollout / production push
+ *   debugging    — investigating an error, reading logs, fixing a bug
+ *   testing      — writing test cases, QA, validation
+ *   documenting  — readme, comments, API docs, runbooks
+ *   planning     — design doc, roadmap, sprint planning, architecture
+ *   temporal     — questions about when things happened (reuses temporal-intent)
+ *   none         — fallback when no strong signal
+ *
+ * This is the gate for everything downstream: which namespace to search,
+ * which kind of recall to prefer (memories vs runbooks), what confidence
+ * threshold to apply.
+ *
+ * Pure module — no I/O, no DB, no LLM. Trivially unit-testable. The
+ * patterns are tuned to be HIGH PRECISION (false positives are worse
+ * than misses for the "should I surface a suggestion?" use case).
+ */
+import { isTemporalQuery } from '../temporal-intent.js';
+/**
+ * Patterns per intent kind. Order matters within an array — the first
+ * match wins for tie-breaking when two kinds score equal.
+ *
+ * Each entry has a regex + a weight 0-1. Multiple matches in the same
+ * kind compound (capped at 1.0). The kind with the highest total weight
+ * wins.
+ */
+const SIGNALS = {
+    coding: [
+        // Source-code markers
+        { re: /```(?:typescript|javascript|tsx?|jsx?|python|py|go|rust|java|c\+\+|cpp|csharp|cs|ruby|rb|php|swift|kotlin|scala|sql)\b/i, w: 0.6, label: 'fenced-code-lang' },
+        { re: /\b(?:function|const|let|var|import|export|class|interface|def|async|await)\s+[a-z_]/i, w: 0.45, label: 'language-keyword' },
+        { re: /\b(?:return|throw|try|catch|if|else|for|while|switch)\b.*[{(]/i, w: 0.25, label: 'control-flow' },
+        { re: /\.(?:then|catch|map|filter|reduce|forEach)\b/, w: 0.35, label: 'method-chain' },
+        { re: /\b(?:writing|coding|implementing|refactoring|fixing|adding)\s+(?:a\s+)?(?:function|method|class|component|endpoint|api|route|handler)\b/i, w: 0.55, label: 'verb-noun' },
+        // File paths in src/, components/, lib/, etc.
+        { re: /\b(?:src|components|lib|hooks|utils|services|controllers|routes|pages|app)\/[a-z0-9-_/]+\.(?:ts|tsx|js|jsx|py|go|rs|java|cs|rb|php|swift|kt)\b/i, w: 0.5, label: 'src-file-path' },
+    ],
+    deploying: [
+        { re: /\b(?:deploy(?:ing|ment)?|rollout|roll\s+out|release|push\s+to\s+(?:prod|production|staging|live))\b/i, w: 0.7, label: 'deploy-verb' },
+        { re: /\b(?:vercel|netlify|fly\.io|railway|render|heroku|aws|gcp|azure|kubernetes|k8s|docker)\s+(?:deploy|push|build)/i, w: 0.6, label: 'platform-deploy' },
+        { re: /\b(?:git\s+push|npm\s+publish|cargo\s+publish|pip\s+upload|docker\s+push)\b/i, w: 0.55, label: 'publish-cmd' },
+        { re: /\b(?:rolling\s+back|hotfix|cab(?:\s+release)?|prod\s+(?:incident|release))\b/i, w: 0.65, label: 'release-event' },
+        { re: /\b(?:staging|production)\s+(?:server|env|environment)\b/i, w: 0.45, label: 'env-mention' },
+        { re: /\bblue-green\b|\bcanary\b/i, w: 0.5, label: 'deploy-strategy' },
+    ],
+    debugging: [
+        { re: /\b(?:error|exception|failure|failed|fatal|panic|stack\s+trace|traceback)\b/i, w: 0.55, label: 'error-noun' },
+        { re: /\bfix(?:ing|ed)?\s+(?:a\s+)?(?:bug|issue|error|problem|crash)\b/i, w: 0.65, label: 'fix-verb' },
+        { re: /\b(?:debug(?:ging)?|investigate|investigating|root\s+cause|why\s+is|what's\s+wrong)\b/i, w: 0.6, label: 'debug-verb' },
+        { re: /\b(?:sqlstate|err_|errno|err\s+\d|http\s+(?:4|5)\d{2})\b/i, w: 0.55, label: 'error-code' },
+        { re: /\b(?:not\s+working|broken|crashing|hangs|times?\s+out)\b/i, w: 0.45, label: 'broken-phrase' },
+        { re: /\b(?:console\.log|print\(|debugger|breakpoint|pdb|gdb)\b/i, w: 0.4, label: 'debug-tool' },
+    ],
+    testing: [
+        { re: /\b(?:test(?:s|ing|ed)?|spec(?:s)?|describe|it\(|expect\(|assert(?:Equals?|True|False)?)\b/i, w: 0.5, label: 'test-verb' },
+        { re: /\b(?:vitest|jest|mocha|chai|pytest|unittest|rspec|junit|xunit)\b/i, w: 0.65, label: 'test-framework' },
+        { re: /\b(?:qa|q\.a\.|quality\s+assurance|test\s+plan|test\s+case|cr\s+coverage|cab\s+coverage|regression\s+test)\b/i, w: 0.6, label: 'qa-noun' },
+        { re: /\b(?:writing|adding|fixing)\s+(?:a\s+)?test/i, w: 0.55, label: 'verb-test' },
+        { re: /\b(?:should|must|expects?\s+to)\s+(?:return|throw|equal|contain|match)\b/i, w: 0.4, label: 'assertion-language' },
+    ],
+    documenting: [
+        { re: /\b(?:docu?mentation|readme|docstring|api\s+docs|user\s+guide|how-?to)\b/i, w: 0.6, label: 'doc-noun' },
+        { re: /\bwriting\s+(?:a\s+)?(?:doc|guide|readme|tutorial|spec|specification)\b/i, w: 0.6, label: 'writing-doc' },
+        { re: /\b(?:markdown|\.md\b|<!--|jsdoc|tsdoc|sphinx|docusaurus)\b/i, w: 0.45, label: 'doc-format' },
+        { re: /\b(?:install(?:ation)?|setup|getting\s+started|quickstart|configure)\b/i, w: 0.4, label: 'setup-doc-topic' },
+        { re: /^#+\s+/m, w: 0.3, label: 'md-header' },
+    ],
+    planning: [
+        { re: /\b(?:roadmap|sprint|planning|design\s+doc|rfc|architecture|adr)\b/i, w: 0.65, label: 'planning-noun' },
+        { re: /\b(?:should\s+we|let'?s|we\s+need\s+to|next\s+up|todo|tbd|wip)\b/i, w: 0.3, label: 'planning-phrase' },
+        { re: /\b(?:decision|decided|trade-?off|alternative(?:s)?|considered)\b/i, w: 0.45, label: 'decision-language' },
+        { re: /\b(?:phase\s+\d|milestone|deadline|deliverable)\b/i, w: 0.5, label: 'milestone' },
+        { re: /\b(?:goal|objective|requirement|user\s+story|acceptance\s+criteria)\b/i, w: 0.5, label: 'goal-language' },
+    ],
+};
+/**
+ * Classify the active context. Returns the highest-scoring intent above
+ * a minimum signal floor of 0.25 (below that, it's "none").
+ *
+ * Why not multi-label: in practice the user is doing one thing at a
+ * time. A single intent keeps the downstream namespace/threshold logic
+ * deterministic. If multi-label is needed later, we can return a sorted
+ * list and let callers consume top-N.
+ */
+export function classifyIntent(text) {
+    if (!text || text.trim().length < 5) {
+        return { kind: 'none', confidence: 0, signals: [] };
+    }
+    // Special case: temporal queries are detected by a separate, more
+    // specific classifier we already shipped. If it fires AND no other
+    // intent scores higher, return 'temporal'.
+    const isTemporal = isTemporalQuery(text);
+    // Score each non-temporal kind.
+    const scores = {};
+    for (const [kind, patterns] of Object.entries(SIGNALS)) {
+        let total = 0;
+        const hits = [];
+        for (const p of patterns) {
+            if (p.re.test(text)) {
+                total += p.w;
+                hits.push(p.label);
+            }
+        }
+        // Cap at 1.0 — diminishing returns past full signal.
+        scores[kind] = { score: Math.min(total, 1.0), signals: hits };
+    }
+    // Pick the top-scoring kind.
+    let topKind = 'none';
+    let topScore = 0;
+    let topSignals = [];
+    for (const [kind, { score, signals }] of Object.entries(scores)) {
+        if (score > topScore) {
+            topKind = kind;
+            topScore = score;
+            topSignals = signals;
+        }
+    }
+    // Minimum floor: if nothing fired above 0.25, treat as 'none' unless
+    // it's a clear temporal query (which can have its own classifier hit).
+    if (topScore < 0.25) {
+        if (isTemporal) {
+            return { kind: 'temporal', confidence: 0.6, signals: ['temporal-classifier'] };
+        }
+        return { kind: 'none', confidence: 0, signals: [] };
+    }
+    // Temporal-vs-other tiebreak: if temporal fires AND another intent
+    // scores below 0.45, prefer temporal (it's a more specific signal).
+    if (isTemporal && topScore < 0.45) {
+        return { kind: 'temporal', confidence: 0.6, signals: ['temporal-classifier'] };
+    }
+    return { kind: topKind, confidence: topScore, signals: topSignals };
+}
+//# sourceMappingURL=intent.js.map

package/dist/lib/context-engine/intent.js.map

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

package/dist/lib/context-engine/runbook-detector.js

@@ -0,0 +1,206 @@
+/**
+ * Runbook-pattern detector.
+ *
+ * Given a chunk of active context, decide whether it looks like a
+ * sequence of repeatable operational steps that the user might want to
+ * save as a runbook. Triggers the "Do you want to create a runbook
+ * from this?" suggestion.
+ *
+ * Different from `src/runbook/fingerprint.ts` (which fingerprints
+ * INDIVIDUAL errors) and from `src/runbook/auto-extract.ts` (which
+ * LLM-extracts from past Cowork chats). This detector is REAL-TIME and
+ * regex-only — runs on every typing pause, decides "is this currently
+ * being written like a runbook?"
+ *
+ * Signals it looks for:
+ *
+ *   1. Numbered or bulleted list of 3+ items
+ *   2. Multiple fenced code blocks (commands) in sequence
+ *   3. Imperative verbs at line starts ("Run", "Click", "Open", "Copy")
+ *   4. Sequential step language ("first", "then", "next", "finally")
+ *   5. Test pattern: each step is a single-line action + optional code
+ *
+ * NEGATIVE signals that demote runbook-confidence:
+ *   - Continuous prose paragraphs without lists
+ *   - Code that's clearly NOT a command (function definitions, classes)
+ *   - Q&A or back-and-forth dialog
+ *
+ * Pure module — no I/O. Sibling to intent.ts and entities.ts.
+ */
+export function detectRunbook(text) {
+    if (!text || text.trim().length < 30) {
+        return { isRunbook: false, confidence: 0, steps: [], suggestedTitle: null, signals: [] };
+    }
+    const lines = text.split(/\r?\n/);
+    const signals = [];
+    let score = 0;
+    // ─── Signal 1: numbered list of 3+ items ─────────────────────────────
+    const numberedItems = [];
+    for (let i = 0; i < lines.length; i++) {
+        const m = lines[i].match(/^\s*(\d+)[.)\]]\s+(.+)/);
+        if (m)
+            numberedItems.push({ idx: i, text: m[2].trim() });
+    }
+    if (numberedItems.length >= 3) {
+        score += 0.5;
+        signals.push(`numbered-list-${numberedItems.length}`);
+    }
+    else if (numberedItems.length === 2) {
+        score += 0.2;
+        signals.push('numbered-list-short');
+    }
+    // ─── Signal 2: bulleted list of 3+ items ─────────────────────────────
+    const bulletItems = [];
+    for (let i = 0; i < lines.length; i++) {
+        const m = lines[i].match(/^\s*[-*•]\s+(.+)/);
+        if (m)
+            bulletItems.push({ idx: i, text: m[1].trim() });
+    }
+    if (bulletItems.length >= 4) {
+        score += 0.35;
+        signals.push(`bullet-list-${bulletItems.length}`);
+    }
+    // ─── Signal 3: fenced code blocks (multiple = command sequence) ──────
+    const fencedBlocks = Array.from(text.matchAll(/```(?:bash|sh|powershell|ps1|zsh|fish|cmd|console)?\n([\s\S]*?)```/gi));
+    if (fencedBlocks.length >= 2) {
+        score += 0.4;
+        signals.push(`fenced-code-${fencedBlocks.length}`);
+    }
+    else if (fencedBlocks.length === 1 && fencedBlocks[0][1].split('\n').filter(l => l.trim()).length >= 3) {
+        score += 0.25;
+        signals.push('fenced-code-multiline');
+    }
+    // ─── Signal 4: imperative verbs at line starts ───────────────────────
+    // "Run X", "Open Y", "Click Z", "Copy ...", "Navigate to ..."
+    // The `(?:\d+[.)\]]?\s+|[-*•]\s+)?` prefix allows list-marker text
+    // BEFORE the imperative — so "1. Open Chrome" and "- Click button"
+    // both count. Without this, numbered/bulleted runbooks hide their
+    // imperatives behind list markers and score 0 on this signal.
+    const imperativeRe = /^\s*(?:\d+[.)\]]\s+|[-*•]\s+)?(?:Run|Open|Click|Copy|Paste|Navigate|Type|Press|Enter|Select|Go\s+to|Visit|Download|Upload|Install|Verify|Check|Confirm|Wait|Save|Submit|Apply|Apply|Deploy|Push|Pull|Build|Test|Edit|Add|Remove|Delete|Update|Set|Configure|Start|Stop|Restart|Login|Sign\s+in|Sign\s+up|Connect|Disconnect|Toggle|Trigger|Verify)\s+/i;
+    let imperativeCount = 0;
+    for (const line of lines) {
+        if (imperativeRe.test(line))
+            imperativeCount++;
+    }
+    if (imperativeCount >= 3) {
+        score += 0.4;
+        signals.push(`imperative-${imperativeCount}`);
+    }
+    else if (imperativeCount === 2) {
+        score += 0.15;
+        signals.push('imperative-pair');
+    }
+    // ─── Signal 5: sequential step language ──────────────────────────────
+    const sequentialPhrases = [
+        /\bfirst,?\s+\w+/i,
+        /\bthen,?\s+\w+/i,
+        /\bnext,?\s+\w+/i,
+        /\bafter\s+(?:that|this),?\s+\w+/i,
+        /\bfinally,?\s+\w+/i,
+        /\blastly,?\s+\w+/i,
+        /\bstep\s+\d+\b/i,
+    ];
+    const seqHits = sequentialPhrases.filter(re => re.test(text)).length;
+    if (seqHits >= 2) {
+        score += 0.25;
+        signals.push(`sequential-${seqHits}`);
+    }
+    // ─── NEGATIVE: continuous prose ──────────────────────────────────────
+    // If the text is mostly paragraphs with NO lists, NO commands, it's
+    // probably explaining something rather than describing steps.
+    const paragraphLines = lines.filter(l => l.trim().length > 80 && !l.match(/^\s*[\d-*•]/)).length;
+    const totalNonEmpty = lines.filter(l => l.trim().length > 0).length;
+    if (totalNonEmpty > 0 && paragraphLines / totalNonEmpty > 0.7 && score < 0.5) {
+        score *= 0.5;
+        signals.push('mostly-prose-demote');
+    }
+    // ─── NEGATIVE: dialog / Q&A pattern ──────────────────────────────────
+    // "You: ... Claude: ..." or "Q: ... A: ..."
+    const dialogRe = /^(?:you|claude|gpt|user|assistant|q|a)[:>]\s+/im;
+    if (dialogRe.test(text)) {
+        score *= 0.6;
+        signals.push('dialog-demote');
+    }
+    const isRunbook = score >= 0.55;
+    // ─── Extract steps if confident enough ───────────────────────────────
+    let steps = [];
+    let suggestedTitle = null;
+    if (score >= 0.4) {
+        steps = extractSteps(lines, numberedItems, bulletItems, fencedBlocks);
+        suggestedTitle = extractTitle(text, lines, steps);
+    }
+    return {
+        isRunbook,
+        confidence: Math.min(score, 1.0),
+        steps,
+        suggestedTitle,
+        signals,
+    };
+}
+// ─── Step extraction ──────────────────────────────────────────────────────
+function extractSteps(lines, numbered, bullets, fenced) {
+    const out = [];
+    // Prefer numbered list as the canonical step structure.
+    const source = numbered.length >= 2 ? numbered : bullets.length >= 3 ? bullets : [];
+    for (const item of source) {
+        // Look ahead for an attached code block (line after this list item).
+        let code;
+        const nextLine = lines[item.idx + 1];
+        if (nextLine?.match(/^\s*```/)) {
+            // Walk until closing fence
+            const fenceLines = [];
+            for (let j = item.idx + 2; j < lines.length; j++) {
+                if (lines[j].match(/^\s*```/))
+                    break;
+                fenceLines.push(lines[j]);
+            }
+            if (fenceLines.length > 0) {
+                code = fenceLines.join('\n').slice(0, 1000);
+            }
+        }
+        else {
+            // Inline code in the step text itself
+            const inlineCode = item.text.match(/`([^`]+)`/);
+            if (inlineCode)
+                code = inlineCode[1];
+        }
+        out.push({
+            text: item.text.replace(/`([^`]+)`/g, '$1').slice(0, 500),
+            ...(code ? { code } : {}),
+            sourceLine: item.idx,
+        });
+        if (out.length >= 20)
+            break;
+    }
+    // If we don't have list-based steps but DO have fenced code blocks,
+    // synthesize each block as a step.
+    if (out.length === 0 && fenced.length >= 2) {
+        for (const f of fenced) {
+            out.push({
+                text: 'Run',
+                code: f[1].trim().slice(0, 500),
+            });
+            if (out.length >= 10)
+                break;
+        }
+    }
+    return out;
+}
+/** Extract a title from the text — first markdown heading, or imperative line. */
+function extractTitle(text, lines, steps) {
+    // Markdown heading first
+    const headingMatch = text.match(/^#+\s+(.{5,120}?)$/m);
+    if (headingMatch)
+        return headingMatch[1].trim();
+    // First line if it's short + descriptive
+    const firstLine = lines.find(l => l.trim().length > 0);
+    if (firstLine && firstLine.length < 100 && !firstLine.match(/^[\d-*•]/)) {
+        return firstLine.trim();
+    }
+    // Synthesize from first step
+    if (steps.length > 0) {
+        return `${steps[0].text.slice(0, 80)}...`;
+    }
+    return null;
+}
+//# sourceMappingURL=runbook-detector.js.map

package/dist/lib/context-engine/runbook-detector.js.map

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