@neurcode-ai/cli 0.9.25 → 0.9.26

package/dist/commands/ask.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.askCommand = askCommand;
+const child_process_1 = require("child_process");
 const fs_1 = require("fs");
 const path_1 = require("path");
 const config_1 = require("../config");
@@ -487,7 +488,140 @@ function buildOutOfScopeAnswerPayload(question, normalizedQuestion, reasons) {
         },
     };
 }
-function tryBuildDeterministicAnswer(_cwd, question, normalizedQuestion) {
+function parseOwnershipLookbackDays(normalizedQuestion) {
+    if (/\bquarter\b/.test(normalizedQuestion))
+        return 120;
+    if (/\bhalf[-\s]?year\b/.test(normalizedQuestion))
+        return 180;
+    if (/\byear\b/.test(normalizedQuestion))
+        return 365;
+    if (/\bmonth\b/.test(normalizedQuestion))
+        return 30;
+    if (/\bweek\b/.test(normalizedQuestion))
+        return 14;
+    const explicitDays = normalizedQuestion.match(/\b(\d{1,4})\s*days?\b/);
+    if (explicitDays) {
+        const parsed = Number(explicitDays[1]);
+        if (Number.isFinite(parsed))
+            return Math.max(1, Math.min(parsed, 3650));
+    }
+    return 90;
+}
+function buildOwnershipDeterministicAnswer(cwd, question, normalizedQuestion) {
+    const asksOwnership = /\b(who|owner|owners|authored|touched|touch)\b/.test(normalizedQuestion);
+    if (!asksOwnership)
+        return null;
+    const ignoreTerms = new Set([
+        'who', 'owner', 'owners', 'authored', 'touched', 'touch', 'last', 'quarter', 'recent', 'recently',
+        'file', 'files', 'module', 'modules', 'repo', 'repository', 'codebase', 'this', 'that', 'these', 'those',
+        'for', 'from', 'with', 'about', 'during', 'before', 'after', 'show', 'list', 'what', 'which', 'where',
+    ]);
+    const focusTerms = (0, plan_cache_1.normalizeIntent)(question)
+        .split(/\s+/)
+        .map((term) => term.trim())
+        .filter((term) => term.length >= 4 && !ignoreTerms.has(term));
+    const sinceDays = parseOwnershipLookbackDays(normalizedQuestion);
+    const result = (0, child_process_1.spawnSync)('git', ['log', `--since=${sinceDays}.days`, '--name-only', '--pretty=format:__AUTHOR__%an'], {
+        cwd,
+        encoding: 'utf-8',
+        maxBuffer: 1024 * 1024 * 60,
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    if ((result.status ?? 1) !== 0 || !result.stdout) {
+        return null;
+    }
+    const authorTouches = new Map();
+    const fileTouches = new Map();
+    let currentAuthor = '';
+    for (const rawLine of result.stdout.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (!line)
+            continue;
+        if (line.startsWith('__AUTHOR__')) {
+            currentAuthor = line.replace('__AUTHOR__', '').trim() || 'Unknown';
+            continue;
+        }
+        if (!currentAuthor)
+            continue;
+        const normalizedPath = line.replace(/\\/g, '/').replace(/^\.\//, '');
+        if (!normalizedPath || normalizedPath.startsWith('.git/') || normalizedPath.startsWith('node_modules/')) {
+            continue;
+        }
+        if (focusTerms.length > 0 && !focusTerms.some((term) => (0, plan_cache_1.normalizeIntent)(normalizedPath).includes(term))) {
+            continue;
+        }
+        authorTouches.set(currentAuthor, (authorTouches.get(currentAuthor) || 0) + 1);
+        const perFile = fileTouches.get(normalizedPath) || new Map();
+        perFile.set(currentAuthor, (perFile.get(currentAuthor) || 0) + 1);
+        fileTouches.set(normalizedPath, perFile);
+    }
+    if (authorTouches.size === 0) {
+        return null;
+    }
+    const topContributors = [...authorTouches.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 5)
+        .map(([author, touches]) => ({ author, touches }));
+    const topFiles = [...fileTouches.entries()]
+        .sort((a, b) => {
+        const aCount = [...a[1].values()].reduce((sum, n) => sum + n, 0);
+        const bCount = [...b[1].values()].reduce((sum, n) => sum + n, 0);
+        return bCount - aCount;
+    })
+        .slice(0, 6);
+    const targetLabel = focusTerms.length > 0 ? `files matching "${focusTerms.slice(0, 4).join(', ')}"` : 'this repository';
+    const answer = [
+        `Top contributors for ${targetLabel} in the last ${sinceDays} day(s):`,
+        ...topContributors.map((entry) => `  • ${entry.author} (${entry.touches} touches)`),
+    ].join('\n');
+    const citations = topFiles.map(([path, owners]) => {
+        const summary = [...owners.entries()]
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 3)
+            .map(([author, touches]) => `${author}(${touches})`)
+            .join(', ');
+        return {
+            path,
+            line: 1,
+            term: focusTerms[0] || 'authorship',
+            snippet: `Recent git touches (last ${sinceDays}d): ${summary}`,
+        };
+    });
+    const sourceFiles = new Set(citations.map((citation) => citation.path)).size;
+    const score = Math.min(0.98, 0.65 + Math.min(sourceFiles, 6) * 0.05);
+    return {
+        reason: 'ownership_git_history',
+        payload: {
+            question,
+            questionNormalized: normalizedQuestion,
+            mode: 'search',
+            answer,
+            findings: [
+                `Derived from git history over the last ${sinceDays} day(s).`,
+                `Focus: ${targetLabel}.`,
+            ],
+            confidence: topContributors.length >= 2 ? 'high' : 'medium',
+            truth: {
+                status: 'grounded',
+                score,
+                reasons: ['Answer is grounded in local git history for this repository.'],
+                sourceCitations: citations.length,
+                sourceFiles,
+                minCitationsRequired: 1,
+                minFilesRequired: 1,
+            },
+            citations,
+            generatedAt: new Date().toISOString(),
+            stats: {
+                scannedFiles: 0,
+                matchedFiles: sourceFiles,
+                matchedLines: citations.length,
+                brainCandidates: 0,
+            },
+        },
+    };
+}
+function tryBuildDeterministicAnswer(cwd, question, normalizedQuestion) {
     const scope = assessQuestionScope(normalizedQuestion);
     if (scope.isOutOfScope) {
         return {
@@ -495,6 +629,10 @@ function tryBuildDeterministicAnswer(_cwd, question, normalizedQuestion) {
             reason: 'out_of_scope',
         };
     }
+    const ownership = buildOwnershipDeterministicAnswer(cwd, question, normalizedQuestion);
+    if (ownership) {
+        return ownership;
+    }
     return null;
 }
 function normalizeSnippet(line) {
@@ -585,21 +723,9 @@ function extractCommandsFromCliIndex(cwd) {
     }
     return [...commandSet].slice(0, 40);
 }
-function extractFeatureBulletsFromReadme(cwd, limit) {
-    const readmePath = (0, path_1.join)(cwd, 'README.md');
-    if (!(0, fs_1.existsSync)(readmePath))
-        return [];
-    let content = '';
-    try {
-        content = (0, fs_1.readFileSync)(readmePath, 'utf-8');
-    }
-    catch {
-        return [];
-    }
-    const lines = content.split(/\r?\n/);
-    let start = lines.findIndex((line) => /^##\s+.*features/i.test(line));
-    if (start < 0)
-        start = lines.findIndex((line) => /^###\s+.*features/i.test(line));
+function extractFeatureBulletsFromMarkdown(markdown, limit, headingPattern) {
+    const lines = markdown.split(/\r?\n/);
+    let start = lines.findIndex((line) => headingPattern.test(line));
     if (start < 0)
         return [];
     const out = [];
@@ -622,8 +748,10 @@ function extractFeatureBulletsFromReadme(cwd, limit) {
             if (!simple?.[1])
                 continue;
             const text = formatInsightSnippet(simple[1]);
+            if (!text)
+                continue;
             const key = text.toLowerCase();
-            if (text && !seen.has(key)) {
+            if (!seen.has(key)) {
                 seen.add(key);
                 out.push(text);
             }
@@ -633,6 +761,63 @@ function extractFeatureBulletsFromReadme(cwd, limit) {
     }
     return out;
 }
+function extractFeatureBulletsFromReadme(cwd, limit) {
+    const readmePath = (0, path_1.join)(cwd, 'README.md');
+    if (!(0, fs_1.existsSync)(readmePath))
+        return [];
+    try {
+        const content = (0, fs_1.readFileSync)(readmePath, 'utf-8');
+        return extractFeatureBulletsFromMarkdown(content, limit, /^#{2,3}\s+.*(features|capabilities|what it does|highlights|offerings|product surface|platform surface|overview)/i);
+    }
+    catch {
+        return [];
+    }
+}
+function extractFeatureBulletsFromDocs(cwd, limit) {
+    const docsDir = (0, path_1.join)(cwd, 'docs');
+    if (!(0, fs_1.existsSync)(docsDir))
+        return [];
+    const out = [];
+    const seen = new Set();
+    let files = [];
+    try {
+        files = (0, fs_1.readdirSync)(docsDir).filter((name) => name.toLowerCase().endsWith('.md')).slice(0, 40);
+    }
+    catch {
+        return [];
+    }
+    for (const fileName of files) {
+        if (out.length >= limit)
+            break;
+        const fullPath = (0, path_1.join)(docsDir, fileName);
+        let content = '';
+        try {
+            content = (0, fs_1.readFileSync)(fullPath, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        const extracted = extractFeatureBulletsFromMarkdown(content, limit, /^#{2,3}\s+.*(features|capabilities|what it does|highlights|offerings|product surface|platform surface|overview)/i);
+        for (const bullet of extracted) {
+            const key = bullet.toLowerCase();
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            out.push(bullet);
+            if (out.length >= limit)
+                break;
+        }
+    }
+    return out;
+}
+function extractFeatureBulletsForRepo(cwd, limit) {
+    const readmeBullets = extractFeatureBulletsFromReadme(cwd, limit);
+    if (readmeBullets.length >= limit) {
+        return readmeBullets.slice(0, limit);
+    }
+    const docsBullets = extractFeatureBulletsFromDocs(cwd, limit);
+    return [...new Set([...readmeBullets, ...docsBullets])].slice(0, limit);
+}
 function extractNeurcodeCommandsFromCitations(citations) {
     const commandSet = new Set();
     for (const citation of citations) {
@@ -1189,6 +1374,57 @@ function buildAnswer(mode, question, terms, citations, stats, termCounts, perFil
         const bullets = (context.featureBullets || []).slice(0, 6).map((line) => `  • ${line}`);
         answer = ['Here are the main platform features I could verify from the repo:', ...bullets].join('\n');
     }
+    else if (asksFeatures) {
+        const inferredFeatures = [];
+        const signalText = citations.map((citation) => `${citation.path} ${citation.snippet}`.toLowerCase());
+        const hasSignal = (patterns) => {
+            return signalText.some((line) => patterns.some((pattern) => pattern.test(line)));
+        };
+        const preferredCommands = [
+            'neurcode ask',
+            'neurcode plan',
+            'neurcode apply',
+            'neurcode verify',
+            'neurcode ship',
+            'neurcode watch',
+            'neurcode session',
+            'neurcode revert',
+            'neurcode check',
+            'neurcode login',
+            'neurcode config',
+            'neurcode init',
+        ];
+        const primaryCommands = [
+            ...preferredCommands.filter((command) => commandMatches.includes(command)),
+            ...commandMatches.filter((command) => !preferredCommands.includes(command)),
+        ]
+            .filter((command) => !command.startsWith('neurcode session ') && !command.startsWith('neurcode revert '))
+            .slice(0, 12);
+        if (primaryCommands.length > 0) {
+            inferredFeatures.push(`CLI workflows: ${primaryCommands.join(', ')}`);
+        }
+        if (hasSignal([/\bverify\b/, /\bpolicy\b/, /\bscope[_ -]?guard\b/, /\bgovernance\b/])) {
+            inferredFeatures.push('Governance and policy verification gates.');
+        }
+        if (hasSignal([/\bship\b/, /\bmerge confidence\b/, /\bauto-remediation\b/])) {
+            inferredFeatures.push('Ship workflow with automated remediation and merge confidence scoring.');
+        }
+        if (hasSignal([/\bask\b/, /\bcitation\b/, /\bgrounded\b/, /\bbrain\b/])) {
+            inferredFeatures.push('Repository-grounded Q&A with cached context retrieval.');
+        }
+        if (hasSignal([/\bsession\b/, /\brevert\b/, /\bhistory\b/, /\btime machine\b/])) {
+            inferredFeatures.push('Session/history tracking with revert support.');
+        }
+        if (hasSignal([/\bx-org-id\b/, /\bmulti[- ]tenant\b/, /\borganization[_ -]?id\b/])) {
+            inferredFeatures.push('Multi-tenant organization-scoped isolation and identity context.');
+        }
+        if (inferredFeatures.length > 0) {
+            answer = ['Based on repository evidence, these platform capabilities are available:', ...inferredFeatures.map((line) => `  • ${line}`)].join('\n');
+        }
+        else {
+            answer = 'I found code evidence, but not enough explicit feature documentation to give a precise feature list yet.';
+        }
+    }
     else if (asksSchema && citations.length > 0) {
         const lineCache = context.lineCache || new Map();
         const schemaFieldSummaries = buildSchemaFieldSummaries(citations, lineCache, terms);
@@ -1387,6 +1623,22 @@ function buildAnswer(mode, question, terms, citations, stats, termCounts, perFil
         answer,
         findings,
         confidence,
+        proof: {
+            topFiles: [...citations.reduce((acc, citation) => {
+                    acc.set(citation.path, (acc.get(citation.path) || 0) + 1);
+                    return acc;
+                }, new Map()).entries()]
+                .sort((a, b) => b[1] - a[1])
+                .slice(0, 5)
+                .map(([path]) => path),
+            evidenceCount: citations.length,
+            coverage: {
+                sourceCitations: truth.sourceCitations,
+                sourceFiles: truth.sourceFiles,
+                matchedFiles: stats.matchedFiles,
+                matchedLines: stats.matchedLines,
+            },
+        },
         truth: {
             status: truth.status,
             score: Number(truth.score.toFixed(2)),
@@ -1426,14 +1678,49 @@ function emitAskResult(result, options) {
     else {
         console.log(chalk.yellow(result.answer));
     }
-    if (!options.verbose) {
-        if (result.truth.status === 'insufficient' && result.truth.reasons.length > 0) {
+    const showProof = options.proof === true;
+    if (!options.verbose && !showProof) {
+        console.log(chalk.dim(`\nConfidence: ${result.confidence.toUpperCase()}`));
+        if (result.truth.status === 'insufficient' && result.citations.length === 0 && result.truth.reasons.length > 0) {
             console.log(chalk.yellow('\nWhy confidence is limited:'));
-            for (const reason of result.truth.reasons.slice(0, 3)) {
+            for (const reason of result.truth.reasons.slice(0, 2)) {
                 console.log(chalk.yellow(`  • ${reason}`));
             }
+            console.log(chalk.dim('\nTip: add `--proof` for quick evidence digest or `--verbose` for full detail.'));
         }
-        console.log(chalk.dim('\nTip: add `--verbose` to show citations and full grounding details.'));
+        return;
+    }
+    if (showProof && !options.verbose) {
+        const proof = result.proof;
+        if (proof) {
+            console.log(chalk.bold.white('\nProof:'));
+            const topFiles = proof.topFiles.slice(0, 4);
+            if (topFiles.length > 0) {
+                console.log(chalk.cyan(`  • Top files: ${topFiles.join(', ')}`));
+            }
+            console.log(chalk.cyan(`  • Evidence: citations=${proof.coverage.sourceCitations}, source_files=${proof.coverage.sourceFiles}, matched_lines=${proof.coverage.matchedLines}`));
+        }
+        const tenancyQuestion = /\b(tenant|tenancy|single|multi|organization|org)\b/.test(result.questionNormalized);
+        let citations = result.citations.slice(0, Math.min(options.maxCitations, 12));
+        if (tenancyQuestion) {
+            const focused = citations.filter((citation) => /\b(multi[- ]tenant|x-org-id|organization[_ -]?id|org[_ -]?id)\b/i.test(citation.snippet));
+            if (focused.length >= 3) {
+                citations = focused;
+            }
+            if (/multi-tenant/i.test(result.answer)) {
+                citations = citations.filter((citation) => !/\bsingle-user platform\b/i.test(citation.snippet));
+            }
+        }
+        citations = citations.slice(0, Math.min(options.maxCitations, 6));
+        if (citations.length > 0) {
+            console.log(chalk.bold.white('\nKey Evidence:'));
+            citations.forEach((citation, idx) => {
+                console.log(chalk.dim(`  ${idx + 1}. ${citation.path}:${citation.line} ${citation.snippet}`));
+            });
+        }
+        const truthLabel = result.truth.status === 'grounded' ? chalk.green('GROUNDED') : chalk.yellow('INSUFFICIENT');
+        console.log(chalk.dim(`\nTruth Mode: ${truthLabel} (score=${result.truth.score.toFixed(2)}, source_citations=${result.truth.sourceCitations}, source_files=${result.truth.sourceFiles})`));
+        console.log(chalk.dim(`Confidence: ${result.confidence.toUpperCase()} | scanned=${result.stats.scannedFiles} matched=${result.stats.matchedFiles}`));
         return;
     }
     if (result.findings.length > 0) {
@@ -1483,6 +1770,7 @@ async function askCommand(question, options = {}) {
                 maxCitations,
                 fromPlan: options.fromPlan,
                 verbose: options.verbose,
+                proof: options.proof,
             });
             if (orgId && projectId) {
                 (0, brain_context_1.recordBrainProgressEvent)(cwd, scope, {
@@ -1544,6 +1832,7 @@ async function askCommand(question, options = {}) {
                     cacheLabel: `Using cached answer (created: ${new Date(exact.createdAt).toLocaleString()})`,
                     fromPlan: options.fromPlan,
                     verbose: options.verbose,
+                    proof: options.proof,
                 });
                 (0, brain_context_1.recordBrainProgressEvent)(cwd, scope, {
                     type: 'ask',
@@ -1577,6 +1866,7 @@ async function askCommand(question, options = {}) {
                     cacheLabel: `${reasonText}, similarity ${near.similarity.toFixed(2)}, created: ${new Date(near.entry.createdAt).toLocaleString()}`,
                     fromPlan: options.fromPlan,
                     verbose: options.verbose,
+                    proof: options.proof,
                 });
                 (0, brain_context_1.recordBrainProgressEvent)(cwd, scope, {
                     type: 'ask',
@@ -1593,7 +1883,7 @@ async function askCommand(question, options = {}) {
             : { entries: [], totalIndexedFiles: 0 };
         const cliPackageName = readCliPackageName(cwd);
         const knownCliCommands = extractCommandsFromCliIndex(cwd);
-        const featureBullets = extractFeatureBulletsFromReadme(cwd, 10);
+        const featureBullets = extractFeatureBulletsForRepo(cwd, 10);
         if (!options.json && brainResults.entries.length > 0) {
             const top = brainResults.entries.filter((entry) => entry.score > 0).length;
             console.log(chalk.dim(`🧠 Brain retrieval: ${top} relevant file summaries from ${brainResults.totalIndexedFiles} indexed files`));
@@ -1644,6 +1934,14 @@ async function askCommand(question, options = {}) {
                 else if (pathHints.length > 0) {
                     score -= 0.08;
                 }
+                if (/\b(feature|features|capability|capabilities|offers?|platform)\b/.test(normalizedQuestion)) {
+                    if (filePath === 'README.md' || normalizedPath.startsWith('docs/')) {
+                        score += 0.55;
+                    }
+                    if (normalizedPath.startsWith('web/') || normalizedPath.startsWith('packages/dashboard/')) {
+                        score -= 0.25;
+                    }
+                }
                 if (score > 0) {
                     candidateSet.add(filePath);
                     pathPriority.set(filePath, score);
@@ -1987,6 +2285,7 @@ async function askCommand(question, options = {}) {
             maxCitations,
             fromPlan: options.fromPlan,
             verbose: options.verbose,
+            proof: options.proof,
         });
         if (orgId && projectId) {
             (0, brain_context_1.recordBrainProgressEvent)(cwd, scope, {