aspectcode 0.4.1 → 1.0.1

package/dist/autoResolve.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Autonomous assessment resolution — LLM judges warnings
+ * and auto-resolves high-confidence ones without user input.
+ *
+ * Batched: multiple assessments are sent in a single LLM call,
+ * deduplicated by rule+directory to minimize token usage.
+ */
+import type { LlmProvider } from '@aspectcode/optimizer';
+import type { ChangeAssessment } from './changeEvaluator';
+import type { PreferencesStore } from './preferences';
+export interface AutoResolveResult {
+    assessment: ChangeAssessment;
+    decision: 'allow' | 'deny';
+    confidence: number;
+    reasoning: string;
+    autoResolved: boolean;
+}
+export interface LlmRecommendation {
+    decision: 'allow' | 'deny';
+    confidence: number;
+    reasoning: string;
+}
+/**
+ * Check if an existing preference already covers this assessment.
+ * If so, skip the LLM entirely and return the cached decision.
+ */
+export declare function matchExistingPreference(assessment: ChangeAssessment, preferences: PreferencesStore): AutoResolveResult | null;
+/**
+ * Batch-resolve multiple assessments in a single LLM call.
+ * Deduplicates by rule+directory for token efficiency.
+ */
+export declare function autoResolveBatch(assessments: ChangeAssessment[], preferences: PreferencesStore, provider: LlmProvider, options?: {
+    threshold?: number;
+}): Promise<AutoResolveResult[]>;
+/**
+ * Single-assessment resolve (kept for backward compat / tests).
+ */
+export declare function autoResolveAssessment(assessment: ChangeAssessment, preferences: PreferencesStore, provider: LlmProvider, options?: {
+    threshold?: number;
+}): Promise<AutoResolveResult>;
+//# sourceMappingURL=autoResolve.d.ts.map

package/dist/autoResolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoResolve.d.ts","sourceRoot":"","sources":["../src/autoResolve.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,gBAAgB,CAAC;IAC7B,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AA8FD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,gBAAgB,EAC5B,WAAW,EAAE,gBAAgB,GAC5B,iBAAiB,GAAG,IAAI,CAsB1B;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,gBAAgB,EAAE,EAC/B,WAAW,EAAE,gBAAgB,EAC7B,QAAQ,EAAE,WAAW,EACrB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAyD9B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,gBAAgB,EAC5B,WAAW,EAAE,gBAAgB,EAC7B,QAAQ,EAAE,WAAW,EACrB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnC,OAAO,CAAC,iBAAiB,CAAC,CAM5B"}

package/dist/autoResolve.js

@@ -0,0 +1,196 @@
+"use strict";
+/**
+ * Autonomous assessment resolution — LLM judges warnings
+ * and auto-resolves high-confidence ones without user input.
+ *
+ * Batched: multiple assessments are sent in a single LLM call,
+ * deduplicated by rule+directory to minimize token usage.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchExistingPreference = matchExistingPreference;
+exports.autoResolveBatch = autoResolveBatch;
+exports.autoResolveAssessment = autoResolveAssessment;
+const BATCH_SYSTEM = `You evaluate code change assessments for a developer. Given a list of assessments and the previous preferences, decide for each: should this be ALLOWED (suppress future warnings) or DENIED (enforce this rule)?
+
+Output ONLY a JSON array. Each element: { "id": <number>, "decision": "allow" or "deny", "confidence": 0.0 to 1.0, "reasoning": "one sentence" }
+
+Confidence guide:
+- 0.9+: Obviously trivial or obviously important (hub with 20+ dependents)
+- 0.7-0.9: Likely correct based on pattern matching with preferences
+- 0.5-0.7: Ambiguous
+- <0.5: Novel, unclear — let the user decide
+
+If multiple assessments share the same rule and directory, they likely deserve the same decision. Lean toward "allow" for naming/convention. Lean toward "deny" for dependency/hub safety.`;
+function formatPreferenceSummary(prefs) {
+    const top = [...prefs.preferences]
+        .sort((a, b) => (b.hitCount ?? 0) - (a.hitCount ?? 0))
+        .slice(0, 10);
+    if (top.length === 0)
+        return 'No existing preferences.';
+    return top.map((p) => {
+        const scope = p.file ? p.file : p.directory ? `${p.directory}*` : 'project-wide';
+        return `- ${p.disposition} ${p.rule} in ${scope} (used ${p.hitCount ?? 0}x)`;
+    }).join('\n');
+}
+/** Build a compact batch prompt, deduplicating by rule+directory. */
+function buildBatchPrompt(assessments, prefs) {
+    let prompt = `Previous preferences:\n${formatPreferenceSummary(prefs)}\n\nAssessments:\n`;
+    // Group by rule + directory for deduplication hint
+    const groups = new Map();
+    for (let i = 0; i < assessments.length; i++) {
+        const a = assessments[i];
+        const dir = a.file ? a.file.substring(0, a.file.lastIndexOf('/') + 1) : '';
+        const key = `${a.rule}|${dir}`;
+        const g = groups.get(key);
+        if (g) {
+            g.indices.push(i);
+        }
+        else {
+            groups.set(key, { indices: [i], sample: a });
+        }
+    }
+    // If a group has multiple identical-rule assessments, compact them
+    for (const [, g] of groups) {
+        if (g.indices.length === 1) {
+            const i = g.indices[0];
+            const a = assessments[i];
+            prompt += `[${i}] Rule: ${a.rule} | File: ${a.file} | ${a.message}`;
+            if (a.details)
+                prompt += ` | ${a.details}`;
+            prompt += '\n';
+        }
+        else {
+            const a = g.sample;
+            const files = g.indices.map((i) => assessments[i].file).join(', ');
+            prompt += `[${g.indices.join(',')}] Rule: ${a.rule} | ${g.indices.length} files: ${files} | ${a.message}\n`;
+        }
+    }
+    return prompt;
+}
+function parseBatchResponse(raw, count) {
+    try {
+        const cleaned = raw.replace(/<think>[\s\S]*?<\/think>/g, '').trim();
+        const match = cleaned.match(/\[[\s\S]*\]/);
+        if (!match)
+            return null;
+        const arr = JSON.parse(match[0]);
+        if (!Array.isArray(arr))
+            return null;
+        const results = [];
+        for (const item of arr) {
+            if (item.decision !== 'allow' && item.decision !== 'deny')
+                continue;
+            const confidence = typeof item.confidence === 'number' ? Math.max(0, Math.min(1, item.confidence)) : 0.5;
+            const reasoning = typeof item.reasoning === 'string' ? item.reasoning.slice(0, 200) : '';
+            // id can be a single number or comma-separated group
+            const ids = typeof item.id === 'number' ? [item.id]
+                : typeof item.id === 'string' ? item.id.split(',').map((s) => parseInt(s.trim(), 10)).filter((n) => !isNaN(n))
+                    : [];
+            for (const id of ids) {
+                if (id >= 0 && id < count) {
+                    results.push({ id, decision: item.decision, confidence, reasoning });
+                }
+            }
+        }
+        return results.length > 0 ? results : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if an existing preference already covers this assessment.
+ * If so, skip the LLM entirely and return the cached decision.
+ */
+function matchExistingPreference(assessment, preferences) {
+    const dir = assessment.file
+        ? assessment.file.substring(0, assessment.file.lastIndexOf('/') + 1)
+        : null;
+    for (const p of preferences.preferences) {
+        if (p.rule !== assessment.rule)
+            continue;
+        const scopeMatch = (p.directory && dir && dir.startsWith(p.directory)) ||
+            (p.file && p.file === assessment.file) ||
+            (!p.directory && !p.file);
+        if (!scopeMatch)
+            continue;
+        return {
+            assessment,
+            decision: p.disposition === 'allow' ? 'allow' : 'deny',
+            confidence: 1.0,
+            reasoning: `Matched existing preference: ${p.disposition} ${p.rule}`,
+            autoResolved: true,
+        };
+    }
+    return null;
+}
+/**
+ * Batch-resolve multiple assessments in a single LLM call.
+ * Deduplicates by rule+directory for token efficiency.
+ */
+async function autoResolveBatch(assessments, preferences, provider, options = {}) {
+    if (assessments.length === 0)
+        return [];
+    const threshold = options.threshold ?? 0.8;
+    const messages = [
+        { role: 'system', content: BATCH_SYSTEM },
+        { role: 'user', content: buildBatchPrompt(assessments, preferences) },
+    ];
+    try {
+        const response = provider.chatWithOptions
+            ? await provider.chatWithOptions(messages, { temperature: 0 })
+            : await provider.chat(messages);
+        const parsed = parseBatchResponse(response, assessments.length);
+        if (!parsed) {
+            // Parsing failed — return all as unresolved
+            return assessments.map((a) => ({
+                assessment: a,
+                decision: 'allow',
+                confidence: 0,
+                reasoning: 'Could not parse batch response',
+                autoResolved: false,
+            }));
+        }
+        // Map results back to assessments
+        const resultMap = new Map();
+        for (const r of parsed) {
+            resultMap.set(r.id, r);
+        }
+        return assessments.map((a, i) => {
+            const r = resultMap.get(i);
+            if (!r) {
+                return { assessment: a, decision: 'allow', confidence: 0, reasoning: 'Not in batch response', autoResolved: false };
+            }
+            return {
+                assessment: a,
+                decision: r.decision,
+                confidence: r.confidence,
+                reasoning: r.reasoning,
+                autoResolved: r.confidence >= threshold,
+            };
+        });
+    }
+    catch (err) {
+        // Re-throw tier exhaustion
+        if (err?.tierExhausted)
+            throw err;
+        return assessments.map((a) => ({
+            assessment: a,
+            decision: 'allow',
+            confidence: 0,
+            reasoning: 'LLM unavailable',
+            autoResolved: false,
+        }));
+    }
+}
+/**
+ * Single-assessment resolve (kept for backward compat / tests).
+ */
+async function autoResolveAssessment(assessment, preferences, provider, options = {}) {
+    const cached = matchExistingPreference(assessment, preferences);
+    if (cached)
+        return cached;
+    const results = await autoResolveBatch([assessment], preferences, provider, options);
+    return results[0];
+}
+//# sourceMappingURL=autoResolve.js.map

package/dist/autoResolve.js.map

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

package/dist/changeEvaluator.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Change evaluator — real-time assessment of file changes against the
+ * current AnalysisModel and learned preferences.
+ *
+ * All checks are pure functions. No LLM calls, no file reads beyond
+ * what's already in RuntimeState, no tree-sitter. Fast enough to run
+ * on every file save.
+ */
+import type { AnalysisModel } from '@aspectcode/core';
+import type { PreferencesStore } from './preferences';
+export interface TimestampedChange {
+    type: 'add' | 'change' | 'unlink';
+    path: string;
+    timestamp: number;
+}
+export interface ChangeAssessment {
+    file: string;
+    type: 'ok' | 'warning' | 'violation';
+    rule: string;
+    message: string;
+    details?: string;
+    suggestion?: string;
+    dependencyContext?: string;
+    dismissable: boolean;
+    /** LLM auto-resolve recommendation (attached when auto-resolve is active). */
+    llmRecommendation?: {
+        decision: 'allow' | 'deny';
+        confidence: number;
+        reasoning: string;
+    };
+}
+export interface ChangeContext {
+    model: AnalysisModel;
+    agentsContent: string;
+    preferences: PreferencesStore;
+    recentChanges: TimestampedChange[];
+    fileContents?: ReadonlyMap<string, string>;
+    /** Hub inDegree counts from previous analysis (for new-hub detection). */
+    previousHubCounts?: ReadonlyMap<string, number>;
+}
+export declare function trackChange(event: {
+    type: string;
+    path: string;
+}): void;
+export declare function getRecentChanges(): TimestampedChange[];
+export declare function clearRecentChanges(): void;
+export declare function evaluateChange(event: {
+    type: string;
+    path: string;
+}, ctx: ChangeContext): ChangeAssessment[];
+export declare function extractExportNames(content: string, _language: string): string[];
+export declare function hasPathInGraph(from: string, to: string, edges: {
+    source: string;
+    target: string;
+}[], maxDepth?: number): string[] | null;
+//# sourceMappingURL=changeEvaluator.d.ts.map

package/dist/changeEvaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changeEvaluator.d.ts","sourceRoot":"","sources":["../src/changeEvaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAKtD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,GAAG,SAAS,GAAG,WAAW,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE;QAClB,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;QAC3B,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,aAAa,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,aAAa,EAAE,iBAAiB,EAAE,CAAC;IACnC,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjD;AAOD,wBAAgB,WAAW,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAUvE;AAED,wBAAgB,gBAAgB,IAAI,iBAAiB,EAAE,CAMtD;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAID,wBAAgB,cAAc,CAC5B,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACrC,GAAG,EAAE,aAAa,GACjB,gBAAgB,EAAE,CA2BpB;AAkRD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAsB/E;AAiDD,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,EAC3C,QAAQ,SAAK,GACZ,MAAM,EAAE,GAAG,IAAI,CAkBjB"}