@yadsh/dsh-user-correction-miner 0.1.0

package/lib/mining/engine.js

@@ -0,0 +1,241 @@
+import { correctionRecordId, sha256 } from "../utils/hashing.js";
+import { workspaceKey } from "../utils/workspace.js";
+import { isDirectUserMessage, messageText } from "./message-text.js";
+import { prefilterCorrection } from "./prefilter.js";
+import { boundText, redactSecrets } from "./sanitize.js";
+import { scanSession } from "./scanner.js";
+function emptyCursor(key) {
+    return { workspaceKey: key, sessionWatermarks: {}, updatedAt: 0 };
+}
+function abortReason(signal) {
+    return signal.reason instanceof Error ? signal.reason : new Error("The operation was aborted");
+}
+export class CorrectionMinerEngine {
+    source;
+    store;
+    config;
+    logger;
+    now;
+    pending = new Map();
+    workspaceQueues = new Map();
+    constructor(source, store, config, logger, now = Date.now) {
+        this.source = source;
+        this.store = store;
+        this.config = config;
+        this.logger = logger;
+        this.now = now;
+    }
+    scan(request, signal) {
+        const key = workspaceKey(request.cwd);
+        return this.enqueue(key, () => this.runHistoricalScan(request, signal));
+    }
+    observeEvent(session, event) {
+        if (!this.config.enabled)
+            return;
+        const observedAt = this.now();
+        this.evictExpired(observedAt);
+        const sessionId = String(session.id);
+        const current = this.pending.get(sessionId);
+        if (current !== undefined)
+            current.lastEventAt = observedAt;
+        if (event.type === "user/message" && isDirectUserMessage(event.data)) {
+            const result = prefilterCorrection(messageText(event.data));
+            if (result.matched) {
+                const pending = current ?? this.createPendingSession(sessionId, observedAt);
+                pending.eventSeqs.add(event.seq);
+                while (pending.eventSeqs.size > this.config.live.maxPendingEventsPerSession) {
+                    const oldestEventSeq = pending.eventSeqs.values().next().value;
+                    pending.eventSeqs.delete(oldestEventSeq);
+                    this.warnPendingEviction("event-cap", sessionId, 1);
+                }
+            }
+            return;
+        }
+        if (event.type === "turn/end")
+            this.scheduleLiveSession(session);
+    }
+    observeDisposed(session) {
+        if (!this.config.enabled)
+            return;
+        this.evictExpired(this.now());
+        this.scheduleLiveSession(session);
+    }
+    dispose() {
+        this.pending.clear();
+    }
+    count(cwd) {
+        return this.store.countCorrections(workspaceKey(cwd));
+    }
+    list(cwd, limit = 50) {
+        return this.store.listCorrections(workspaceKey(cwd), limit);
+    }
+    scheduleLiveSession(session) {
+        const sessionId = String(session.id);
+        const pending = this.pending.get(sessionId);
+        if ((pending?.eventSeqs.size ?? 0) === 0)
+            return;
+        this.pending.delete(sessionId);
+        const cwd = session.header.cwd;
+        if (cwd === undefined) {
+            this.warnPendingEviction("no-cwd", sessionId, pending?.eventSeqs.size ?? 0);
+            return;
+        }
+        const snapshot = {
+            session: session.header,
+            events: session.events,
+        };
+        const key = workspaceKey(cwd);
+        void this.enqueue(key, () => this.runSnapshot(snapshot, key, true)).catch((error) => {
+            this.logger.warn("incremental_scan.failed", {
+                sessionId,
+                reason: error instanceof Error ? error.message : String(error),
+            });
+        });
+    }
+    async runHistoricalScan(request, signal) {
+        const key = workspaceKey(request.cwd);
+        const sessions = await this.source.list(request, signal);
+        let sessionsScanned = 0;
+        let sessionsFailed = 0;
+        let eventsScanned = 0;
+        let correctionsFound = 0;
+        let correctionsAdded = 0;
+        for (const record of sessions) {
+            if (signal?.aborted === true)
+                throw abortReason(signal);
+            try {
+                const snapshot = await this.source.read(String(record.header.id));
+                const report = await this.runSnapshot(snapshot, key, request.incremental !== false);
+                sessionsScanned += 1;
+                eventsScanned += report.eventsScanned;
+                correctionsFound += report.correctionsFound;
+                correctionsAdded += report.correctionsAdded;
+            }
+            catch (error) {
+                sessionsFailed += 1;
+                this.logger.warn("historical_scan.session_failed", {
+                    sessionId: String(record.header.id),
+                    reason: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        const report = {
+            workspaceKey: key,
+            sessionsConsidered: sessions.length,
+            sessionsScanned,
+            sessionsFailed,
+            eventsScanned,
+            correctionsFound,
+            correctionsAdded,
+        };
+        this.logger.info("historical_scan.completed", report);
+        return report;
+    }
+    async runSnapshot(snapshot, key, incremental) {
+        const cursor = this.store.getCursor(key) ?? emptyCursor(key);
+        const sessionId = String(snapshot.session.id);
+        const afterSeq = incremental ? (cursor.sessionWatermarks[sessionId] ?? -1) : -1;
+        const result = scanSession(snapshot, afterSeq, this.config.analysis);
+        let correctionsAdded = 0;
+        for (const evidence of result.evidence) {
+            const record = this.toRecord(evidence, key);
+            const existed = this.store.hasCorrection(record.id);
+            await this.store.putCorrection(record, this.config.retention.maxRecordsPerWorkspace);
+            if (!existed)
+                correctionsAdded += 1;
+        }
+        const capturedThroughSeq = result.capturedThroughSeq;
+        const nextCursor = {
+            workspaceKey: key,
+            lastAnalyzedSession: sessionId,
+            ...(capturedThroughSeq === null ? {} : { lastAnalyzedEventSeq: capturedThroughSeq }),
+            sessionWatermarks: {
+                ...cursor.sessionWatermarks,
+                ...(capturedThroughSeq === null
+                    ? {}
+                    : { [sessionId]: Math.max(afterSeq, capturedThroughSeq) }),
+            },
+            updatedAt: this.now(),
+        };
+        await this.store.putCursor(nextCursor);
+        return {
+            eventsScanned: result.eventsScanned,
+            correctionsFound: result.evidence.length,
+            correctionsAdded,
+        };
+    }
+    toRecord(evidence, key) {
+        const sanitize = (text) => {
+            const redacted = this.config.privacy.redactSecrets ? redactSecrets(text) : text;
+            return this.config.privacy.persistRawMessages
+                ? redacted
+                : boundText(redacted, this.config.privacy.maxStoredTextChars);
+        };
+        return {
+            id: correctionRecordId(evidence.sessionId, evidence.userEventSeq),
+            sessionId: evidence.sessionId,
+            eventSeq: evidence.userEventSeq,
+            workspaceKey: key,
+            cwd: evidence.cwd,
+            text: sanitize(evidence.userText),
+            textDigest: sha256(evidence.userText),
+            contextDigest: evidence.contextDigest,
+            contextEvents: evidence.contextEvents.map((event) => ({ ...event, text: sanitize(event.text) })),
+            ...(evidence.previousUserEvent === undefined
+                ? {}
+                : { previousUserEvent: evidence.previousUserEvent }),
+            previousAssistantEvents: [...evidence.previousAssistantEvents],
+            previousToolEvents: [...evidence.previousToolEvents],
+            matchedSignals: [...evidence.matchedSignals],
+            likelyOneOff: evidence.likelyOneOff,
+            createdAt: evidence.timestamp,
+        };
+    }
+    enqueue(key, work) {
+        const previous = this.workspaceQueues.get(key) ?? Promise.resolve();
+        const next = previous.catch(() => undefined).then(work);
+        this.workspaceQueues.set(key, next);
+        void next.finally(() => {
+            if (this.workspaceQueues.get(key) === next)
+                this.workspaceQueues.delete(key);
+        }).catch(() => undefined);
+        return next;
+    }
+    createPendingSession(sessionId, observedAt) {
+        while (this.pending.size >= this.config.live.maxPendingSessions) {
+            let oldestSessionId;
+            let oldestObservedAt = Number.POSITIVE_INFINITY;
+            for (const [candidateId, candidate] of this.pending) {
+                if (candidate.lastEventAt < oldestObservedAt) {
+                    oldestSessionId = candidateId;
+                    oldestObservedAt = candidate.lastEventAt;
+                }
+            }
+            if (oldestSessionId === undefined)
+                break;
+            const evicted = this.pending.get(oldestSessionId);
+            this.pending.delete(oldestSessionId);
+            this.warnPendingEviction("session-cap", oldestSessionId, evicted?.eventSeqs.size ?? 0);
+        }
+        const pending = { eventSeqs: new Set(), lastEventAt: observedAt };
+        this.pending.set(sessionId, pending);
+        return pending;
+    }
+    evictExpired(observedAt) {
+        for (const [sessionId, pending] of this.pending) {
+            if (observedAt - pending.lastEventAt < this.config.live.pendingTtlMs)
+                continue;
+            this.pending.delete(sessionId);
+            this.warnPendingEviction("ttl", sessionId, pending.eventSeqs.size);
+        }
+    }
+    warnPendingEviction(reason, sessionId, evictedEvents) {
+        this.logger.warn("pending.evicted", {
+            reason,
+            sessionId,
+            evictedEvents,
+            pendingSessions: this.pending.size,
+        });
+    }
+}
+//# sourceMappingURL=engine.js.map

package/lib/mining/engine.js.map

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

package/lib/mining/message-text.d.ts

@@ -0,0 +1,4 @@
+import type { Message, UserMessage } from "@deepseek-ai/dsh-llm";
+export declare function messageText(message: Pick<Message, "content">): string;
+export declare function isDirectUserMessage(message: UserMessage): boolean;
+//# sourceMappingURL=message-text.d.ts.map

package/lib/mining/message-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-text.d.ts","sourceRoot":"","sources":["../../src/mining/message-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAQ/E,wBAAgB,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,MAAM,CAErE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAEjE"}

package/lib/mining/message-text.js

@@ -0,0 +1,14 @@
+function blockText(block) {
+    if (block.type === "text")
+        return [block.text];
+    if (block.type === "tool-result")
+        return block.content.flatMap(blockText);
+    return [];
+}
+export function messageText(message) {
+    return message.content.flatMap(blockText).join("\n").trim();
+}
+export function isDirectUserMessage(message) {
+    return message.source.kind === "user";
+}
+//# sourceMappingURL=message-text.js.map

package/lib/mining/message-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-text.js","sourceRoot":"","sources":["../../src/mining/message-text.ts"],"names":[],"mappings":"AAEA,SAAS,SAAS,CAAC,KAAmB;IACpC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1E,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAiC;IAC3D,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAoB;IACtD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC;AACxC,CAAC"}

package/lib/mining/prefilter.d.ts

@@ -0,0 +1,7 @@
+export interface CorrectionPrefilterResult {
+    readonly matched: boolean;
+    readonly signals: readonly string[];
+    readonly likelyOneOff: boolean;
+}
+export declare function prefilterCorrection(text: string): CorrectionPrefilterResult;
+//# sourceMappingURL=prefilter.d.ts.map

package/lib/mining/prefilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefilter.d.ts","sourceRoot":"","sources":["../../src/mining/prefilter.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC;AA+BD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,yBAAyB,CAS3E"}

package/lib/mining/prefilter.js

@@ -0,0 +1,39 @@
+const SIGNALS = [
+    [
+        "negative-imperative",
+        /(?:^|[^\p{L}\p{N}_])(?:не\s+(?:надо|нужно|запускай|меняй|трогай|делай|используй)|do\s+not|don't)(?=$|[^\p{L}\p{N}_])/iu,
+    ],
+    [
+        "wrong-target",
+        /(?:^|[^\p{L}\p{N}_])(?:не\s+(?:тот|та|то|те)|wrong\s+(?:file|directory|command|tool)|not\s+the\s+right)(?=$|[^\p{L}\p{N}_])/iu,
+    ],
+    [
+        "reminder",
+        /(?:^|[^\p{L}\p{N}_])(?:я\s+же\s+просил(?:а)?|зачем\s+ты|i\s+(?:already\s+)?asked\s+you|why\s+did\s+you)(?=$|[^\p{L}\p{N}_])/iu,
+    ],
+    [
+        "replacement",
+        /(?:^|[^\p{L}\p{N}_])(?:вместо(?=$|[^\p{L}\p{N}_]).{0,80}используй|используй|используйте|use(?=$|[^\p{L}\p{N}_]).{0,80}instead|prefer)(?=$|[^\p{L}\p{N}_])/iu,
+    ],
+    [
+        "durable-language",
+        /(?:^|[^\p{L}\p{N}_])(?:всегда|никогда|always|never)(?=$|[^\p{L}\p{N}_])/iu,
+    ],
+    [
+        "workflow-order",
+        /(?:^|[^\p{L}\p{N}_])(?:сначала|сперва|first)(?=$|[^\p{L}\p{N}_])/iu,
+    ],
+];
+const ONE_OFF = /(?:^|[^\p{L}\p{N}_])(?:сейчас|пока|в\s+этот\s+раз|только\s+сегодня|for\s+now|right\s+now|this\s+time|today)(?=$|[^\p{L}\p{N}_])/iu;
+export function prefilterCorrection(text) {
+    const normalized = text.replace(/\s+/gu, " ").trim();
+    if (normalized.length === 0)
+        return { matched: false, signals: [], likelyOneOff: false };
+    const signals = SIGNALS.filter(([, pattern]) => pattern.test(normalized)).map(([name]) => name);
+    return {
+        matched: signals.length > 0,
+        signals,
+        likelyOneOff: ONE_OFF.test(normalized),
+    };
+}
+//# sourceMappingURL=prefilter.js.map

package/lib/mining/prefilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefilter.js","sourceRoot":"","sources":["../../src/mining/prefilter.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,GAA4D;IACvE;QACE,qBAAqB;QACrB,wHAAwH;KACzH;IACD;QACE,cAAc;QACd,+HAA+H;KAChI;IACD;QACE,UAAU;QACV,+HAA+H;KAChI;IACD;QACE,aAAa;QACb,6JAA6J;KAC9J;IACD;QACE,kBAAkB;QAClB,2EAA2E;KAC5E;IACD;QACE,gBAAgB;QAChB,oEAAoE;KACrE;CACF,CAAC;AAEF,MAAM,OAAO,GAAG,mIAAmI,CAAC;AAEpJ,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACrD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;IACzF,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IAChG,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC;QAC3B,OAAO;QACP,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;KACvC,CAAC;AACJ,CAAC"}

package/lib/mining/sanitize.d.ts

@@ -0,0 +1,3 @@
+export declare function redactSecrets(text: string): string;
+export declare function boundText(text: string, maxChars: number): string;
+//# sourceMappingURL=sanitize.d.ts.map

package/lib/mining/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/mining/sanitize.ts"],"names":[],"mappings":"AAQA,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEhE"}

package/lib/mining/sanitize.js

@@ -0,0 +1,13 @@
+import { truncateText } from "./text-budget.js";
+const SECRET_PATTERNS = [
+    /\b(?:sk|pk|ghp|github_pat)_[A-Za-z0-9_-]{12,}\b/gu,
+    /\b(?:api[_-]?key|token|password|secret)\s*[:=]\s*[^\s,;]+/giu,
+    /\bBearer\s+[A-Za-z0-9._~+/=-]{10,}\b/giu,
+];
+export function redactSecrets(text) {
+    return SECRET_PATTERNS.reduce((current, pattern) => current.replace(pattern, "[REDACTED]"), text);
+}
+export function boundText(text, maxChars) {
+    return truncateText(text, maxChars, "code-points");
+}
+//# sourceMappingURL=sanitize.js.map

package/lib/mining/sanitize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../../src/mining/sanitize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,eAAe,GAAsB;IACzC,mDAAmD;IACnD,8DAA8D;IAC9D,yCAAyC;CAC1C,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,IAAI,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,QAAgB;IACtD,OAAO,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AACrD,CAAC"}

package/lib/mining/scanner.d.ts

@@ -0,0 +1,14 @@
+import type { SessionEvent, SessionHeader } from "@deepseek-ai/dsh-session";
+import type { CorrectionEvidence } from "../types.js";
+import { type ContextLimits } from "./context-extractor.js";
+export interface SessionSnapshot {
+    readonly session: SessionHeader;
+    readonly events: readonly SessionEvent[];
+}
+export interface SessionScanResult {
+    readonly evidence: readonly CorrectionEvidence[];
+    readonly eventsScanned: number;
+    readonly capturedThroughSeq: number | null;
+}
+export declare function scanSession(snapshot: SessionSnapshot, afterSeq: number, limits: ContextLimits): SessionScanResult;
+//# sourceMappingURL=scanner.d.ts.map

package/lib/mining/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/mining/scanner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAA6B,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAIvF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACjD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5C;AAED,wBAAgB,WAAW,CACzB,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,aAAa,GACpB,iBAAiB,CAiBnB"}

package/lib/mining/scanner.js

@@ -0,0 +1,25 @@
+import { extractCorrectionEvidence } from "./context-extractor.js";
+import { isDirectUserMessage, messageText } from "./message-text.js";
+import { prefilterCorrection } from "./prefilter.js";
+export function scanSession(snapshot, afterSeq, limits) {
+    const evidence = [];
+    let eventsScanned = 0;
+    for (let index = 0; index < snapshot.events.length; index += 1) {
+        const event = snapshot.events[index];
+        if (event === undefined || event.seq <= afterSeq)
+            continue;
+        eventsScanned += 1;
+        if (event.type !== "user/message" || !isDirectUserMessage(event.data))
+            continue;
+        const prefilter = prefilterCorrection(messageText(event.data));
+        if (!prefilter.matched)
+            continue;
+        evidence.push(extractCorrectionEvidence(snapshot.session, snapshot.events, index, prefilter, limits));
+    }
+    return {
+        evidence,
+        eventsScanned,
+        capturedThroughSeq: snapshot.events.at(-1)?.seq ?? null,
+    };
+}
+//# sourceMappingURL=scanner.js.map

package/lib/mining/scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../../src/mining/scanner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAsB,MAAM,wBAAwB,CAAC;AACvF,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAarD,MAAM,UAAU,WAAW,CACzB,QAAyB,EACzB,QAAgB,EAChB,MAAqB;IAErB,MAAM,QAAQ,GAAyB,EAAE,CAAC;IAC1C,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC/D,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,IAAI,QAAQ;YAAE,SAAS;QAC3D,aAAa,IAAI,CAAC,CAAC;QACnB,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,SAAS;QAChF,MAAM,SAAS,GAAG,mBAAmB,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/D,IAAI,CAAC,SAAS,CAAC,OAAO;YAAE,SAAS;QACjC,QAAQ,CAAC,IAAI,CAAC,yBAAyB,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IACxG,CAAC;IACD,OAAO;QACL,QAAQ;QACR,aAAa;QACb,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,IAAI;KACxD,CAAC;AACJ,CAAC"}

package/lib/mining/text-budget.d.ts

@@ -0,0 +1,7 @@
+export type TextBudgetUnit = "code-points" | "utf8-bytes";
+/**
+ * Truncates text only between Unicode code points and includes the ellipsis in
+ * the requested budget.
+ */
+export declare function truncateText(text: string, maxSize: number, unit: TextBudgetUnit): string;
+//# sourceMappingURL=text-budget.d.ts.map

package/lib/mining/text-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-budget.d.ts","sourceRoot":"","sources":["../../src/mining/text-budget.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,YAAY,CAAC;AAM1D;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,CAuBxF"}

package/lib/mining/text-budget.js

@@ -0,0 +1,34 @@
+import { Buffer } from "node:buffer";
+const ELLIPSIS = "…";
+function segmentSize(segment, unit) {
+    return unit === "code-points" ? 1 : Buffer.byteLength(segment, "utf8");
+}
+/**
+ * Truncates text only between Unicode code points and includes the ellipsis in
+ * the requested budget.
+ */
+export function truncateText(text, maxSize, unit) {
+    const ellipsisSize = segmentSize(ELLIPSIS, unit);
+    if (maxSize < ellipsisSize)
+        return "";
+    const payloadLimit = maxSize - ellipsisSize;
+    const prefix = [];
+    let prefixSize = 0;
+    let totalSize = 0;
+    let prefixComplete = false;
+    for (const codePoint of text) {
+        const size = segmentSize(codePoint, unit);
+        totalSize += size;
+        if (!prefixComplete && prefixSize + size <= payloadLimit) {
+            prefix.push(codePoint);
+            prefixSize += size;
+        }
+        else {
+            prefixComplete = true;
+            if (totalSize > maxSize)
+                break;
+        }
+    }
+    return totalSize <= maxSize ? text : `${prefix.join("")}${ELLIPSIS}`;
+}
+//# sourceMappingURL=text-budget.js.map

package/lib/mining/text-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-budget.js","sourceRoot":"","sources":["../../src/mining/text-budget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,QAAQ,GAAG,GAAG,CAAC;AAIrB,SAAS,WAAW,CAAC,OAAe,EAAE,IAAoB;IACxD,OAAO,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACzE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,OAAe,EAAE,IAAoB;IAC9E,MAAM,YAAY,GAAG,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACjD,IAAI,OAAO,GAAG,YAAY;QAAE,OAAO,EAAE,CAAC;IAEtC,MAAM,YAAY,GAAG,OAAO,GAAG,YAAY,CAAC;IAC5C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,cAAc,GAAG,KAAK,CAAC;IAE3B,KAAK,MAAM,SAAS,IAAI,IAAI,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC1C,SAAS,IAAI,IAAI,CAAC;QAClB,IAAI,CAAC,cAAc,IAAI,UAAU,GAAG,IAAI,IAAI,YAAY,EAAE,CAAC;YACzD,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACvB,UAAU,IAAI,IAAI,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,cAAc,GAAG,IAAI,CAAC;YACtB,IAAI,SAAS,GAAG,OAAO;gBAAE,MAAM;QACjC,CAAC;IACH,CAAC;IAED,OAAO,SAAS,IAAI,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC;AACvE,CAAC"}

package/lib/types.d.ts

@@ -0,0 +1,81 @@
+export type CorrectionTarget = "file-selection" | "filesystem-scope" | "tool-choice" | "command" | "workflow" | "package-manager" | "git" | "deploy" | "style" | "testing" | "environment" | "agent-behavior" | "other";
+export type CorrectionDurability = "one-off" | "likely-project-rule" | "likely-user-rule" | "likely-skill" | "uncertain";
+export interface CorrectionClassification {
+    readonly isCorrection: boolean;
+    readonly confidence: number;
+    readonly target: CorrectionTarget;
+    readonly durability: CorrectionDurability;
+    readonly severity: "preference" | "workflow" | "destructive-risk" | "security";
+    readonly correctedBehavior?: string;
+}
+export type ContextEventKind = "user" | "assistant" | "tool-call" | "tool-result";
+export interface CorrectionContextEvent {
+    readonly seq: number;
+    readonly kind: ContextEventKind;
+    readonly text: string;
+}
+export interface CorrectionEvidence {
+    readonly sessionId: string;
+    readonly userEventSeq: number;
+    readonly userText: string;
+    readonly previousUserEvent?: number;
+    readonly previousAssistantEvents: readonly number[];
+    readonly previousToolEvents: readonly number[];
+    readonly contextEvents: readonly CorrectionContextEvent[];
+    readonly contextDigest: string;
+    readonly cwd: string;
+    readonly timestamp: number;
+    readonly matchedSignals: readonly string[];
+    readonly likelyOneOff: boolean;
+}
+export interface CorrectionRecord {
+    readonly id: string;
+    readonly sessionId: string;
+    readonly eventSeq: number;
+    readonly workspaceKey: string;
+    readonly cwd: string;
+    /** Bounded, redacted text by default; full raw text only when explicitly configured. */
+    readonly text: string;
+    readonly textDigest: string;
+    readonly contextDigest: string;
+    readonly contextEvents: readonly CorrectionContextEvent[];
+    readonly previousUserEvent?: number;
+    readonly previousAssistantEvents: readonly number[];
+    readonly previousToolEvents: readonly number[];
+    readonly matchedSignals: readonly string[];
+    readonly likelyOneOff: boolean;
+    readonly classification?: CorrectionClassification;
+    readonly createdAt: number;
+}
+export interface ScanCursor {
+    readonly workspaceKey: string;
+    readonly lastAnalyzedSession?: string;
+    readonly lastAnalyzedEventSeq?: number;
+    readonly sessionWatermarks: Readonly<Record<string, number>>;
+    readonly updatedAt: number;
+}
+export interface ScanRequest {
+    readonly cwd: string;
+    readonly lastSessions?: number;
+    readonly from?: number;
+    readonly to?: number;
+    readonly incremental?: boolean;
+}
+export interface ScanReport {
+    readonly workspaceKey: string;
+    readonly sessionsConsidered: number;
+    readonly sessionsScanned: number;
+    readonly sessionsFailed: number;
+    readonly eventsScanned: number;
+    readonly correctionsFound: number;
+    readonly correctionsAdded: number;
+}
+export interface CorrectionStore {
+    getCursor(workspaceKey: string): ScanCursor | undefined;
+    putCursor(cursor: ScanCursor): Promise<void>;
+    hasCorrection(id: string): boolean;
+    putCorrection(record: CorrectionRecord, maxRecordsPerWorkspace: number): Promise<void>;
+    countCorrections(workspaceKey: string): number;
+    listCorrections(workspaceKey: string, limit?: number): readonly CorrectionRecord[];
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

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

package/lib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/lib/utils/hashing.d.ts

@@ -0,0 +1,3 @@
+export declare function sha256(value: string): string;
+export declare function correctionRecordId(sessionId: string, eventSeq: number): string;
+//# sourceMappingURL=hashing.d.ts.map

package/lib/utils/hashing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashing.d.ts","sourceRoot":"","sources":["../../src/utils/hashing.ts"],"names":[],"mappings":"AAEA,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE9E"}

package/lib/utils/hashing.js

@@ -0,0 +1,8 @@
+import { createHash } from "node:crypto";
+export function sha256(value) {
+    return createHash("sha256").update(value, "utf8").digest("hex");
+}
+export function correctionRecordId(sessionId, eventSeq) {
+    return sha256(`${sessionId}\0${eventSeq}`);
+}
+//# sourceMappingURL=hashing.js.map

package/lib/utils/hashing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashing.js","sourceRoot":"","sources":["../../src/utils/hashing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,SAAiB,EAAE,QAAgB;IACpE,OAAO,MAAM,CAAC,GAAG,SAAS,KAAK,QAAQ,EAAE,CAAC,CAAC;AAC7C,CAAC"}

package/lib/utils/workspace.d.ts

@@ -0,0 +1,4 @@
+export declare function normalizeWorkspacePath(cwd: string): string;
+export declare function workspaceKey(cwd: string): string;
+export declare function sameWorkspace(left: string | undefined, right: string): boolean;
+//# sourceMappingURL=workspace.d.ts.map

package/lib/utils/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/utils/workspace.ts"],"names":[],"mappings":"AAIA,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAE9E"}

package/lib/utils/workspace.js

@@ -0,0 +1,14 @@
+import { resolve } from "node:path";
+import { platform } from "node:os";
+import { sha256 } from "./hashing.js";
+export function normalizeWorkspacePath(cwd) {
+    const normalized = resolve(cwd).replaceAll("\\", "/").replace(/\/$/u, "");
+    return platform() === "win32" ? normalized.toLocaleLowerCase("en-US") : normalized;
+}
+export function workspaceKey(cwd) {
+    return sha256(normalizeWorkspacePath(cwd));
+}
+export function sameWorkspace(left, right) {
+    return left !== undefined && normalizeWorkspacePath(left) === normalizeWorkspacePath(right);
+}
+//# sourceMappingURL=workspace.js.map

package/lib/utils/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../src/utils/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC1E,OAAO,QAAQ,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,MAAM,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAwB,EAAE,KAAa;IACnE,OAAO,IAAI,KAAK,SAAS,IAAI,sBAAsB,CAAC,IAAI,CAAC,KAAK,sBAAsB,CAAC,KAAK,CAAC,CAAC;AAC9F,CAAC"}