pi-ghost-autocomplete 0.3.1 → 0.3.2

package/dist/metrics-builder.js

@@ -0,0 +1,71 @@
+import { estimateTimeSavedMs } from "./keystroke-timer.js";
+import { SWAP_FLICKER_WINDOW_MS } from "./provisional.js";
+/**
+ * Build the metrics record for a ghost that was shown and is now being
+ * finalized. Pure — no I/O, no `Date.now()`, no env reads (caller resolves
+ * `now` and `shortHoverThresholdMs`).
+ */
+export function buildShownMetricsRecord(input) {
+    const { pending: m, outcome, now } = input;
+    const isAccept = outcome === "accepted" || outcome === "accepted-partial";
+    const shouldEvictCache = !!(m.cacheKey && !isAccept);
+    const providers = m.trace
+        ? m.trace.providers
+        : [
+            {
+                provider: m.providerName,
+                latencyMs: m.latencyMs ?? 0,
+                result: "produced",
+            },
+        ];
+    const multi = input.candidateCount > 1;
+    const isNonAcceptOutcome = outcome === "dismissed" || outcome === "stale" || outcome === "expired";
+    const flicker = m.swapRenderedAt !== undefined &&
+        isNonAcceptOutcome &&
+        now - m.swapRenderedAt < SWAP_FLICKER_WINDOW_MS;
+    const hoverMs = m.shownAt !== undefined ? Math.max(0, now - m.shownAt) : undefined;
+    const shortHoverDismiss = outcome === "dismissed" &&
+        hoverMs !== undefined &&
+        hoverMs < input.shortHoverThresholdMs;
+    let shortHoverPenalty = null;
+    if (shortHoverDismiss && m.prefixAtShown && m.completion && m.completion.length > 0) {
+        const lastLine = m.prefixAtShown.split("\n").pop() ?? "";
+        if (lastLine)
+            shortHoverPenalty = { lastLine, completion: m.completion };
+    }
+    const acceptedChars = isAccept && m.completion ? m.completion.length : undefined;
+    const perceivedLatencyMs = m.ttftMs ?? m.latencyMs ?? 0;
+    const estimatedTimeSavedMs = acceptedChars !== undefined
+        ? estimateTimeSavedMs(acceptedChars, input.msPerChar, perceivedLatencyMs)
+        : undefined;
+    const record = {
+        ts: now,
+        requestId: m.requestId,
+        mode: m.mode,
+        providers,
+        winner: m.trace?.winner ?? m.providerName,
+        result: "produced",
+        completionLength: m.completion?.length,
+        shown: true,
+        acceptance: outcome,
+        matchedPath: m.matchedPath,
+        ...(acceptedChars !== undefined ? { acceptedChars } : {}),
+        ...(estimatedTimeSavedMs !== undefined ? { estimatedTimeSavedMs } : {}),
+        ...(multi
+            ? { candidateCount: input.candidateCount, candidateRank: input.candidateIdx + 1 }
+            : {}),
+        ...(input.cycledCount > 0 ? { cycledCount: input.cycledCount } : {}),
+        ...(input.partialAccepts > 0 ? { partialAccepts: input.partialAccepts } : {}),
+        ...(m.provisionalSwapMs !== undefined ? { provisionalSwapMs: m.provisionalSwapMs } : {}),
+        ...(m.provisionalWasCorrect !== undefined ? { provisionalWasCorrect: m.provisionalWasCorrect } : {}),
+        ...(flicker ? { provisionalSwapFlicker: true } : {}),
+        ...(shortHoverDismiss ? { shortHoverDismiss: true } : {}),
+        ...(m.typedPastDivergent ? { typedPastDivergent: true } : {}),
+        ...(hoverMs !== undefined ? { displayDurationMs: hoverMs } : {}),
+        ...(m.ttftMs !== undefined ? { ttftMs: m.ttftMs } : {}),
+        ...(m.editProximityScore !== undefined ? { editProximityScore: m.editProximityScore } : {}),
+        ...(m.editHistorySize !== undefined ? { editHistorySize: m.editHistorySize } : {}),
+    };
+    return { record, isAccept, shouldEvictCache, shortHoverPenalty };
+}
+//# sourceMappingURL=metrics-builder.js.map

package/dist/metrics-builder.js.map

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

package/dist/metrics.d.ts

@@ -1,6 +1,13 @@
-export type CompletionMode = "deterministic" | "llm";
+/**
+ * Source of truth for all completion modes. Both the type union (compile-time)
+ * and the parser whitelist (runtime, in `bench.ts`) derive from this array so
+ * adding a mode means updating one place.
+ */
+export declare const COMPLETION_MODES: readonly ["deterministic", "llm", "cache", "trie", "speculative-warm", "provisional", "profile-slash"];
+export type CompletionMode = (typeof COMPLETION_MODES)[number];
 export type RequestResult = "produced" | "empty" | "rejected" | "aborted" | "error";
-export type AcceptanceOutcome = "accepted" | "dismissed" | "stale" | "expired";
+export type AcceptanceOutcome = "accepted" | "accepted-partial" | "dismissed" | "stale" | "expired";
+export type QualityAttribution = "accepted" | "dismissed-attributed" | "unknown";
 export type RejectionReason = "stale-text" | "newline" | "too-long" | "assistant-phrasing" | "duplicate-suffix" | "markdown" | "empty" | "echo-token";
 export interface ProviderLatency {
     provider: string;
@@ -25,7 +32,91 @@ export interface MetricsRecord {
      * Never set for LLM mode (would risk leaking output text).
      */
     matchedPath?: string;
+    /** Characters of the ghost the user accepted (full or partial). */
+    acceptedChars?: number;
+    /** Chars from suggestion that matched the user's eventual committed text. */
+    prefixMatchLen?: number;
+    /** Levenshtein distance between top-1 candidate and committed line. */
+    editDistance?: number;
+    /** Count of Ctrl+Right partial accepts on this candidate. */
+    partialAccepts?: number;
+    /** 1-based rank accepted at time of accept (M3 candidate sets). */
+    candidateRank?: number;
+    /** Number of candidates considered. */
+    candidateCount?: number;
+    /** Number of Alt+]/Alt+[ cycles before acceptance. */
+    cycledCount?: number;
+    /** Prefix-match length per rank — numeric only. */
+    prefixMatchLenByRank?: number[];
+    /** saved@k by k. */
+    savedAt?: {
+        "1"?: number;
+        "3"?: number;
+        "5"?: number;
+    };
+    /** Time the ghost was visible to the user, in ms. */
+    displayDurationMs?: number;
+    /** Whether quality fields above are reliable for this record. */
+    qualityAttribution?: QualityAttribution;
+    /** Provider time-to-first-token in ms (streaming providers only). */
+    ttftMs?: number;
+    /** Time from provisional ghost render to LLM swap, in ms. */
+    provisionalSwapMs?: number;
+    /** True iff provisional matched LLM within prefix-match >= 0.8. */
+    provisionalWasCorrect?: boolean;
+    /**
+     * True iff a provisional→LLM swap was rendered and the user dismissed or
+     * aborted within `SWAP_FLICKER_WINDOW_MS`. Tracks the perceived flicker
+     * cost of swaps — the `PI_GHOST_PROVISIONAL_PREFER=1` knob trades raw
+     * recall for a lower value of this rate.
+     */
+    provisionalSwapFlicker?: boolean;
+    /**
+     * True iff the ghost was visible for less than `SHORT_HOVER_DISMISS_MS`
+     * before the user dismissed it. Mild negative signal — emitted on the
+     * non-accept record so M8 / future weighting can read it without joining
+     * separate streams. The actual hover duration is in `displayDurationMs`.
+     */
+    shortHoverDismiss?: boolean;
+    /**
+     * True iff the user typed at least `TYPED_PAST_DIVERGENT_THRESHOLD`
+     * consecutive characters that diverged from the served ghost without
+     * accepting it (#5). The detection runs across consecutive stale
+     * finalizations on the same line, so a single keystroke doesn't trip
+     * it — the run resets on any accept. When set, the editor also applies
+     * a session-trie penalty against the (prefix, ghost) pair so future
+     * suggestions on the same prefix are de-prioritised.
+     */
+    typedPastDivergent?: boolean;
+    /** Heuristic: acceptedChars * userAvgMsPerChar - perceivedLatencyMs. */
+    estimatedTimeSavedMs?: number;
+    /**
+     * True when the user deleted >50% of inserted text within the regret
+     * window after acceptance. See PRD §6 M5a.
+     */
+    acceptRegret?: boolean;
+    /** Inserted characters subsequently deleted within the regret window. */
+    regretDeletedChars?: number;
+    /** Combined behavior fingerprint at the time this record was logged. */
+    versionFingerprint?: string;
+    /**
+     * Top candidate's raw `editProximityScore` (un-normalized output of the
+     * scorer the reranker received). Pure observability — bench/replay
+     * correlate it with `acceptance` to validate the feature weight. Set
+     * only when reranker actually ran and edit-history was enabled.
+     */
+    editProximityScore?: number;
+    /**
+     * Size of the `EditHistoryRing` snapshot at predict time. Useful for
+     * filtering out records where the ring was still warming up.
+     */
+    editHistorySize?: number;
 }
+/**
+ * Debug records have a loose payload by necessity (different kinds carry
+ * different shapes). The redactor below scrubs any field that looks like
+ * raw prompt/completion content before serialization — see `redactDebug`.
+ */
 export interface DebugRecord {
     ts: number;
     requestId: string;
@@ -53,4 +144,10 @@ export declare class MetricsLogger {
     flush(): Promise<void>;
     private enqueue;
 }
+/**
+ * Strip any debug-record field not on the pass-through whitelist. Replaces
+ * the value with a `[redacted: type=T len=N]` placeholder so debugging still
+ * sees that *something* was there, without leaking content. SEC-27.
+ */
+export declare function redactDebug(rec: DebugRecord): DebugRecord;
 //# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,KAAK,CAAC;AAErD,MAAM,MAAM,aAAa,GACtB,UAAU,GACV,OAAO,GACP,UAAU,GACV,SAAS,GACT,OAAO,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;AAE/E,MAAM,MAAM,eAAe,GACxB,YAAY,GACZ,SAAS,GACT,UAAU,GACV,oBAAoB,GACpB,kBAAkB,GAClB,UAAU,GACV,OAAO,GACP,YAAY,CAAC;AAEhB,MAAM,WAAW,eAAe;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,eAAe,CAAC,EAAE,eAAe,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC7B,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,wBAAwB,IAAI,aAAa,CAKxD;AAED,qBAAa,aAAa;IAOxB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAPrB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,MAAM,CAAK;gBAGD,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,aAAa;IAMpC,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,YAAY,IAAI,MAAM;IAItB,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAKtC,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAK7B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,OAAO,CAAC,OAAO;CAGf"}
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"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"}

package/dist/metrics.js

@@ -3,6 +3,46 @@ import { dirname, join } from "node:path";
 const MAX_BYTES = 10 * 1024 * 1024;
 const METRICS_REL = ".pi/ghost-autocomplete/metrics.jsonl";
 const DEBUG_REL = ".pi/ghost-autocomplete/debug.jsonl";
+/**
+ * Source of truth for all completion modes. Both the type union (compile-time)
+ * and the parser whitelist (runtime, in `bench.ts`) derive from this array so
+ * adding a mode means updating one place.
+ */
+export const COMPLETION_MODES = [
+    "deterministic",
+    "llm",
+    "cache",
+    "trie",
+    "speculative-warm",
+    "provisional",
+    "profile-slash",
+];
+/**
+ * Fields callers may safely pass through to debug records. Anything outside
+ * this set is JSON-quoted but with its value replaced by a `[redacted-N]`
+ * placeholder showing only its length and type. SEC-27.
+ *
+ * To allow a new field type-safely, add it here and add a test in
+ * `metrics.test.ts`.
+ */
+const DEBUG_PASS_THROUGH_KEYS = new Set([
+    "ts",
+    "requestId",
+    "kind",
+    "provider",
+    "providerName",
+    "mode",
+    "latencyMs",
+    "durationMs",
+    "length",
+    "count",
+    "status",
+    "errorName",
+    "reason",
+    "phase",
+    "branch",
+    "matchedPath",
+]);
 export function readMetricsConfigFromEnv() {
     return {
         metricsEnabled: process.env.PI_GHOST_METRICS === "1",
@@ -39,7 +79,7 @@ export class MetricsLogger {
     logDebug(record) {
         if (!this.cfg.debugEnabled)
             return;
-        this.enqueue(() => writeLine(this.debugPath, record));
+        this.enqueue(() => writeLine(this.debugPath, redactDebug(record)));
     }
     async flush() {
         await this.writeQueue;
@@ -49,22 +89,96 @@ export class MetricsLogger {
     }
 }
 function redactMetric(rec) {
-    const { ts, requestId, mode, providers, winner, result, rejectionReason, completionLength, shown, acceptance, matchedPath } = rec;
-    const out = { ts, requestId, mode, result };
-    if (providers && providers.length > 0)
-        out.providers = providers;
-    if (winner !== undefined)
-        out.winner = winner;
-    if (rejectionReason !== undefined)
-        out.rejectionReason = rejectionReason;
-    if (completionLength !== undefined)
-        out.completionLength = completionLength;
-    if (shown !== undefined)
-        out.shown = shown;
-    if (acceptance !== undefined)
-        out.acceptance = acceptance;
-    if (mode === "deterministic" && matchedPath !== undefined)
-        out.matchedPath = matchedPath;
+    const out = { ts: rec.ts, requestId: rec.requestId, mode: rec.mode, result: rec.result };
+    if (rec.providers && rec.providers.length > 0)
+        out.providers = rec.providers;
+    if (rec.winner !== undefined)
+        out.winner = rec.winner;
+    if (rec.rejectionReason !== undefined)
+        out.rejectionReason = rec.rejectionReason;
+    if (rec.completionLength !== undefined)
+        out.completionLength = rec.completionLength;
+    if (rec.shown !== undefined)
+        out.shown = rec.shown;
+    if (rec.acceptance !== undefined)
+        out.acceptance = rec.acceptance;
+    if (rec.mode === "deterministic" && rec.matchedPath !== undefined)
+        out.matchedPath = rec.matchedPath;
+    // M5a — numeric/boolean fields only; no raw completion text.
+    if (rec.acceptedChars !== undefined)
+        out.acceptedChars = rec.acceptedChars;
+    if (rec.prefixMatchLen !== undefined)
+        out.prefixMatchLen = rec.prefixMatchLen;
+    if (rec.editDistance !== undefined)
+        out.editDistance = rec.editDistance;
+    if (rec.partialAccepts !== undefined)
+        out.partialAccepts = rec.partialAccepts;
+    if (rec.candidateRank !== undefined)
+        out.candidateRank = rec.candidateRank;
+    if (rec.candidateCount !== undefined)
+        out.candidateCount = rec.candidateCount;
+    if (rec.cycledCount !== undefined)
+        out.cycledCount = rec.cycledCount;
+    if (rec.prefixMatchLenByRank !== undefined)
+        out.prefixMatchLenByRank = rec.prefixMatchLenByRank;
+    if (rec.savedAt !== undefined)
+        out.savedAt = rec.savedAt;
+    if (rec.displayDurationMs !== undefined)
+        out.displayDurationMs = rec.displayDurationMs;
+    if (rec.qualityAttribution !== undefined)
+        out.qualityAttribution = rec.qualityAttribution;
+    if (rec.ttftMs !== undefined)
+        out.ttftMs = rec.ttftMs;
+    if (rec.provisionalSwapMs !== undefined)
+        out.provisionalSwapMs = rec.provisionalSwapMs;
+    if (rec.provisionalWasCorrect !== undefined)
+        out.provisionalWasCorrect = rec.provisionalWasCorrect;
+    if (rec.provisionalSwapFlicker !== undefined)
+        out.provisionalSwapFlicker = rec.provisionalSwapFlicker;
+    if (rec.shortHoverDismiss !== undefined)
+        out.shortHoverDismiss = rec.shortHoverDismiss;
+    if (rec.typedPastDivergent !== undefined)
+        out.typedPastDivergent = rec.typedPastDivergent;
+    if (rec.estimatedTimeSavedMs !== undefined)
+        out.estimatedTimeSavedMs = rec.estimatedTimeSavedMs;
+    if (rec.acceptRegret !== undefined)
+        out.acceptRegret = rec.acceptRegret;
+    if (rec.regretDeletedChars !== undefined)
+        out.regretDeletedChars = rec.regretDeletedChars;
+    if (rec.versionFingerprint !== undefined)
+        out.versionFingerprint = rec.versionFingerprint;
+    return out;
+}
+/**
+ * Strip any debug-record field not on the pass-through whitelist. Replaces
+ * the value with a `[redacted: type=T len=N]` placeholder so debugging still
+ * sees that *something* was there, without leaking content. SEC-27.
+ */
+export function redactDebug(rec) {
+    const out = { ts: rec.ts, requestId: rec.requestId, kind: rec.kind };
+    for (const [k, v] of Object.entries(rec)) {
+        if (k === "ts" || k === "requestId" || k === "kind")
+            continue;
+        if (DEBUG_PASS_THROUGH_KEYS.has(k)) {
+            // Permit primitives and shallow arrays of primitives only.
+            if (v === null ||
+                typeof v === "boolean" ||
+                typeof v === "number" ||
+                typeof v === "string") {
+                out[k] = v;
+            }
+            else if (Array.isArray(v) && v.every((e) => typeof e === "number" || typeof e === "string")) {
+                out[k] = v;
+            }
+            else {
+                out[k] = `[redacted: type=${typeof v}]`;
+            }
+            continue;
+        }
+        const type = typeof v;
+        const len = typeof v === "string" ? v.length : Array.isArray(v) ? v.length : undefined;
+        out[k] = len !== undefined ? `[redacted: type=${type} len=${len}]` : `[redacted: type=${type}]`;
+    }
     return out;
 }
 async function writeLine(path, payload) {

package/dist/metrics.js.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,SAAS,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AACnC,MAAM,WAAW,GAAG,sCAAsC,CAAC;AAC3D,MAAM,SAAS,GAAG,oCAAoC,CAAC;AAEvD;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC/B,eAAe;IACf,KAAK;IACL,OAAO;IACP,MAAM;IACN,kBAAkB;IAClB,aAAa;IACb,eAAe;CACN,CAAC;AAqJX;;;;;;;GAOG;AACH,MAAM,uBAAuB,GAAwB,IAAI,GAAG,CAAC;IAC5D,IAAI;IACJ,WAAW;IACX,MAAM;IACN,UAAU;IACV,cAAc;IACd,MAAM;IACN,WAAW;IACX,YAAY;IACZ,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,WAAW;IACX,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,aAAa;CACb,CAAC,CAAC;AAOH,MAAM,UAAU,wBAAwB;IACvC,OAAO;QACN,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,GAAG;QACpD,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,GAAG;KACpD,CAAC;AACH,CAAC;AAED,MAAM,OAAO,aAAa;IAOP;IACA;IAPD,WAAW,CAAS;IACpB,SAAS,CAAS;IAC3B,UAAU,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAC9C,MAAM,GAAG,CAAC,CAAC;IAEnB,YACkB,GAAW,EACX,GAAkB;QADlB,QAAG,GAAH,GAAG,CAAQ;QACX,QAAG,GAAH,GAAG,CAAe;QAEnC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAC1C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,cAAc;QACjB,OAAO,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC;IAChC,CAAC;IAED,IAAI,YAAY;QACf,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC;IAC9B,CAAC;IAED,YAAY;QACX,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;IACvD,CAAC;IAED,SAAS,CAAC,MAAqB;QAC9B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc;YAAE,OAAO;QACrC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,QAAQ,CAAC,MAAmB;QAC3B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY;YAAE,OAAO;QACnC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,KAAK;QACV,MAAM,IAAI,CAAC,UAAU,CAAC;IACvB,CAAC;IAEO,OAAO,CAAC,EAAuB;QACtC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAChE,CAAC;CACD;AAED,SAAS,YAAY,CAAC,GAAkB;IACvC,MAAM,GAAG,GAAkB,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;IACxG,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;QAAE,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;IAC7E,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS;QAAE,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IACtD,IAAI,GAAG,CAAC,eAAe,KAAK,SAAS;QAAE,GAAG,CAAC,eAAe,GAAG,GAAG,CAAC,eAAe,CAAC;IACjF,IAAI,GAAG,CAAC,gBAAgB,KAAK,SAAS;QAAE,GAAG,CAAC,gBAAgB,GAAG,GAAG,CAAC,gBAAgB,CAAC;IACpF,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;QAAE,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;IACnD,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS;QAAE,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;IAClE,IAAI,GAAG,CAAC,IAAI,KAAK,eAAe,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS;QAAE,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;IACrG,6DAA6D;IAC7D,IAAI,GAAG,CAAC,aAAa,KAAK,SAAS;QAAE,GAAG,CAAC,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC;IAC3E,IAAI,GAAG,CAAC,cAAc,KAAK,SAAS;QAAE,GAAG,CAAC,cAAc,GAAG,GAAG,CAAC,cAAc,CAAC;IAC9E,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS;QAAE,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC;IACxE,IAAI,GAAG,CAAC,cAAc,KAAK,SAAS;QAAE,GAAG,CAAC,cAAc,GAAG,GAAG,CAAC,cAAc,CAAC;IAC9E,IAAI,GAAG,CAAC,aAAa,KAAK,SAAS;QAAE,GAAG,CAAC,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC;IAC3E,IAAI,GAAG,CAAC,cAAc,KAAK,SAAS;QAAE,GAAG,CAAC,cAAc,GAAG,GAAG,CAAC,cAAc,CAAC;IAC9E,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS;QAAE,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;IACrE,IAAI,GAAG,CAAC,oBAAoB,KAAK,SAAS;QAAE,GAAG,CAAC,oBAAoB,GAAG,GAAG,CAAC,oBAAoB,CAAC;IAChG,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS;QAAE,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IACzD,IAAI,GAAG,CAAC,iBAAiB,KAAK,SAAS;QAAE,GAAG,CAAC,iBAAiB,GAAG,GAAG,CAAC,iBAAiB,CAAC;IACvF,IAAI,GAAG,CAAC,kBAAkB,KAAK,SAAS;QAAE,GAAG,CAAC,kBAAkB,GAAG,GAAG,CAAC,kBAAkB,CAAC;IAC1F,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS;QAAE,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IACtD,IAAI,GAAG,CAAC,iBAAiB,KAAK,SAAS;QAAE,GAAG,CAAC,iBAAiB,GAAG,GAAG,CAAC,iBAAiB,CAAC;IACvF,IAAI,GAAG,CAAC,qBAAqB,KAAK,SAAS;QAAE,GAAG,CAAC,qBAAqB,GAAG,GAAG,CAAC,qBAAqB,CAAC;IACnG,IAAI,GAAG,CAAC,sBAAsB,KAAK,SAAS;QAAE,GAAG,CAAC,sBAAsB,GAAG,GAAG,CAAC,sBAAsB,CAAC;IACtG,IAAI,GAAG,CAAC,iBAAiB,KAAK,SAAS;QAAE,GAAG,CAAC,iBAAiB,GAAG,GAAG,CAAC,iBAAiB,CAAC;IACvF,IAAI,GAAG,CAAC,kBAAkB,KAAK,SAAS;QAAE,GAAG,CAAC,kBAAkB,GAAG,GAAG,CAAC,kBAAkB,CAAC;IAC1F,IAAI,GAAG,CAAC,oBAAoB,KAAK,SAAS;QAAE,GAAG,CAAC,oBAAoB,GAAG,GAAG,CAAC,oBAAoB,CAAC;IAChG,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS;QAAE,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC;IACxE,IAAI,GAAG,CAAC,kBAAkB,KAAK,SAAS;QAAE,GAAG,CAAC,kBAAkB,GAAG,GAAG,CAAC,kBAAkB,CAAC;IAC1F,IAAI,GAAG,CAAC,kBAAkB,KAAK,SAAS;QAAE,GAAG,CAAC,kBAAkB,GAAG,GAAG,CAAC,kBAAkB,CAAC;IAC1F,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,GAAgB;IAC3C,MAAM,GAAG,GAAgB,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;IAClF,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,WAAW,IAAI,CAAC,KAAK,MAAM;YAAE,SAAS;QAC9D,IAAI,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACpC,2DAA2D;YAC3D,IACC,CAAC,KAAK,IAAI;gBACV,OAAO,CAAC,KAAK,SAAS;gBACtB,OAAO,CAAC,KAAK,QAAQ;gBACrB,OAAO,CAAC,KAAK,QAAQ,EACpB,CAAC;gBACF,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACZ,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC;gBAC/F,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACZ,CAAC;iBAAM,CAAC;gBACP,GAAG,CAAC,CAAC,CAAC,GAAG,mBAAmB,OAAO,CAAC,GAAG,CAAC;YACzC,CAAC;YACD,SAAS;QACV,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC;QACtB,MAAM,GAAG,GACR,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5E,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,IAAI,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,mBAAmB,IAAI,GAAG,CAAC;IACjG,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,OAAe;IACrD,IAAI,CAAC;QACJ,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,UAAU,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACR,sDAAsD;IACvD,CAAC;AACF,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACJ,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACR,OAAO;IACR,CAAC;IACD,IAAI,IAAI,GAAG,SAAS;QAAE,OAAO;IAC7B,IAAI,CAAC;QACJ,MAAM,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACR,qEAAqE;IACtE,CAAC;AACF,CAAC"}

package/dist/path-matcher.d.ts

@@ -11,6 +11,15 @@ export interface PathPrefixMatch {
 export interface FindPathPrefixOptions {
     limit?: number;
     recentPaths?: Set<string> | null;
+    /**
+     * PRD §M4 — bounded boost from persistent path frequency. Caller passes
+     * `(path) => profileStore.profilePathBoost(path)` which returns a value
+     * in `[0, MAX_PATH_BOOST]` (0.2). Multiplied by 1e3 in the score formula
+     * so it ranks below recent-mention (1e6) but above path length, breaking
+     * ties between equally-fresh matches in favor of historically-frequent
+     * paths. Cannot beat subtree (1e9) — exact session matches still win.
+     */
+    profileBoost?: ((path: string) => number) | null;
 }
 /**
  * Extract a path-like token from the end of `before` (text before the cursor).

package/dist/path-matcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path-matcher.d.ts","sourceRoot":"","sources":["../src/path-matcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,WAAW,SAAS;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CACjC;AAKD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAevE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC7B,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,qBAAqB,GAAG,MAAW,GACvC,eAAe,GAAG,IAAI,CA+BxB"}
+{"version":3,"file":"path-matcher.d.ts","sourceRoot":"","sources":["../src/path-matcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,WAAW,SAAS;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACjC;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,IAAI,CAAC;CACjD;AAKD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAevE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC7B,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,qBAAqB,GAAG,MAAW,GACvC,eAAe,GAAG,IAAI,CAmCxB"}

package/dist/path-matcher.js

@@ -41,6 +41,7 @@ export function findPathPrefix(index, token, opts = {}) {
     const o = typeof opts === "number" ? { limit: opts } : opts;
     const limit = o.limit ?? 64;
     const recent = o.recentPaths ?? null;
+    const profileBoost = o.profileBoost ?? null;
     // Normalize a leading `./` — extractPathPrefixToken preserves it from the
     // user's text (e.g. "./src/con") but git ls-files entries never start with
     // `./`, so the prefix lookup would otherwise miss every cwd-relative entry.
@@ -57,8 +58,10 @@ export function findPathPrefix(index, token, opts = {}) {
     for (const m of matches) {
         const inSub = cwdRel === "" || m.startsWith(cwdRel);
         const rb = recentBoost(m, recent);
-        // Lex-rank: subtree dominates, then recent-mention boost, then short.
-        const score = (inSub ? 1_000_000_000 : 0) + rb * 1_000_000 - m.length;
+        const pb = profileBoost ? profileBoost(m) : 0;
+        // Lex-rank: subtree dominates, then recent-mention, then profile
+        // frequency (tie-breaker), then short.
+        const score = (inSub ? 1_000_000_000 : 0) + rb * 1_000_000 + pb * 1_000 - m.length;
         if (score > bestScore) {
             bestScore = score;
             best = m;

package/dist/path-matcher.js.map

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

package/dist/profile-store.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Stateful wrapper around `profile.ts` for the editor. Holds the in-memory
+ * `ProfileIndex`, serializes writes, triggers periodic compaction, and
+ * exposes a synchronous lookup surface for the editor's hot path.
+ *
+ * Lifecycle:
+ *  1. `create(cwd)` — loads + indexes the JSONL once. Returns a disabled
+ *     store if `PI_GHOST_PROFILE=off`. Errors during load yield an empty
+ *     index (best-effort).
+ *  2. `captureCommit(text)` / `captureAccept(prefix, completion, weight)`
+ *     — append to disk (async, fire-and-forget) and merge into the
+ *     in-memory index so the next lookup sees them immediately.
+ *  3. Every `COMPACT_CHECK_EVERY` writes the store runs `compactIfNeeded`
+ *     in the background. Compaction reloads the index after rewrite.
+ *
+ * `disabled` is a public boolean so callers can short-circuit lookups
+ * without an extra function call on the keystroke path.
+ */
+import { DEFAULT_DECAY_DAYS, type ProfileIndex } from "./profile.js";
+export declare class ProfileStore {
+    private readonly cwd;
+    readonly disabled: boolean;
+    private index;
+    private writeQueue;
+    private writesSinceCompact;
+    private decayDays;
+    private constructor();
+    /**
+     * Build a store and load the JSONL into memory. Caller awaits before
+     * exposing the store to the editor so the index is hot on first
+     * keystroke. Disabled stores short-circuit load entirely.
+     */
+    static create(cwd: string, env?: NodeJS.ProcessEnv): Promise<ProfileStore>;
+    getIndex(): ProfileIndex;
+    get decayDaysSetting(): number;
+    /**
+     * Capture user-committed text. Extracts paths + slash + trigrams, drops
+     * sensitive messages entirely. Returns the count of records emitted —
+     * useful for tests/diagnostics.
+     */
+    captureCommit(text: string, ts?: number): number;
+    /**
+     * Capture an accept (full or partial). `weight` defaults to 3 to match
+     * PRD §M2 trie weights. Returns true when a record was emitted.
+     */
+    captureAccept(prefix: string, completion: string, weight?: number, ts?: number): boolean;
+    /** Public lookup surfaces — thin wrappers around `profile.ts`. */
+    bestSlashMatch(prefix: string): {
+        cmd: string;
+        weight: number;
+    } | null;
+    profileBias(text: string): number;
+    profilePathBoost(path: string): number;
+    /**
+     * Provisional fallback (PRD §M3.5b) — look up an exact-prefix accept
+     * record. Returns the completion tokens + summed weight, or null when
+     * the prefix has never been the exact key of a captured accept.
+     * `prefix` is hashed in-process; the raw string never leaves memory.
+     */
+    lookupAcceptByPrefix(prefix: string): {
+        completionTokens: string[];
+        weight: number;
+    } | null;
+    /** Flush any pending writes — call before process exit. */
+    flush(): Promise<void>;
+    /**
+     * Append records both in-memory and to disk. In-memory merge happens
+     * synchronously so the very next lookup sees the new weight; the disk
+     * write is queued through `writeQueue` to serialize concurrent commits.
+     */
+    private mergeAndPersist;
+    /**
+     * Inline equivalent of `buildIndex` for a small record batch. The
+     * fresh-record path skips decay since we just wrote `ts`. Keeping this
+     * separate from `profile.buildIndex` avoids reindexing the whole store
+     * on every keystroke.
+     */
+    private applyToIndex;
+}
+/** Exported for tests — surface compactor knob without re-exporting `profile.ts`. */
+export { DEFAULT_DECAY_DAYS };
+//# sourceMappingURL=profile-store.d.ts.map

package/dist/profile-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-store.d.ts","sourceRoot":"","sources":["../src/profile-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAKN,kBAAkB,EASlB,KAAK,YAAY,EAEjB,MAAM,cAAc,CAAC;AAQtB,qBAAa,YAAY;IAQvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAPrB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO;IAQP;;;;OAIG;WACU,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,YAAY,CAAC;IAe7F,QAAQ,IAAI,YAAY;IAIxB,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED;;;;OAIG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAE,MAAmB,GAAG,MAAM;IAQ5D;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,SAAI,EAAE,EAAE,GAAE,MAAmB,GAAG,OAAO;IAQ/F,kEAAkE;IAClE,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAKtE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAKjC,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAKtC;;;;;OAKG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAM3F,2DAA2D;IACrD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;;OAIG;IACH,OAAO,CAAC,eAAe;IA0BvB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;CAmCpB;AAED,qFAAqF;AACrF,OAAO,EAAE,kBAAkB,EAAE,CAAC"}