pi-ghost-autocomplete 0.3.1 → 0.3.2

package/dist/profile-store.js

@@ -0,0 +1,199 @@
+/**
+ * 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 { appendRecords, bestSlashMatch, buildIndex, compactIfNeeded, DEFAULT_DECAY_DAYS, emptyIndex, loadRecords, parseDecayDaysEnv, prefixHash, profileBias, profilePathBoost, recordsFromCommit, recordFromAccept, } from "./profile.js";
+// `loadRecords` referenced only inside the `create` static; `buildIndex`
+// likewise. Both retained in imports. Keep this import block fixed so
+// future additions don't bring in unused symbols silently.
+const COMPACT_CHECK_EVERY = 100;
+export class ProfileStore {
+    cwd;
+    disabled;
+    index = emptyIndex();
+    writeQueue = Promise.resolve();
+    writesSinceCompact = 0;
+    decayDays;
+    constructor(cwd, opts) {
+        this.cwd = cwd;
+        this.disabled = opts.disabled;
+        this.decayDays = opts.decayDays;
+    }
+    /**
+     * 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 async create(cwd, env = process.env) {
+        const disabled = env.PI_GHOST_PROFILE === "off";
+        const decayDays = parseDecayDaysEnv(env.PI_GHOST_PROFILE_DECAY_DAYS);
+        const store = new ProfileStore(cwd, { disabled, decayDays });
+        if (!disabled) {
+            try {
+                const records = await loadRecords(cwd);
+                store.index = buildIndex(records, { decayDays });
+            }
+            catch {
+                // best-effort
+            }
+        }
+        return store;
+    }
+    getIndex() {
+        return this.index;
+    }
+    get decayDaysSetting() {
+        return this.decayDays;
+    }
+    /**
+     * Capture user-committed text. Extracts paths + slash + trigrams, drops
+     * sensitive messages entirely. Returns the count of records emitted —
+     * useful for tests/diagnostics.
+     */
+    captureCommit(text, ts = Date.now()) {
+        if (this.disabled)
+            return 0;
+        const recs = recordsFromCommit(text, ts);
+        if (recs.length === 0)
+            return 0;
+        this.mergeAndPersist(recs);
+        return recs.length;
+    }
+    /**
+     * 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, completion, weight = 3, ts = Date.now()) {
+        if (this.disabled)
+            return false;
+        const rec = recordFromAccept(prefix, completion, weight, ts);
+        if (!rec)
+            return false;
+        this.mergeAndPersist([rec]);
+        return true;
+    }
+    /** Public lookup surfaces — thin wrappers around `profile.ts`. */
+    bestSlashMatch(prefix) {
+        if (this.disabled)
+            return null;
+        return bestSlashMatch(this.index, prefix);
+    }
+    profileBias(text) {
+        if (this.disabled)
+            return 0;
+        return profileBias(this.index, text);
+    }
+    profilePathBoost(path) {
+        if (this.disabled)
+            return 0;
+        return profilePathBoost(this.index, path);
+    }
+    /**
+     * 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) {
+        if (this.disabled || !prefix)
+            return null;
+        const hit = this.index.acceptByPrefix.get(prefixHash(prefix));
+        return hit ? { completionTokens: hit.completionTokens, weight: hit.weight } : null;
+    }
+    /** Flush any pending writes — call before process exit. */
+    async flush() {
+        await this.writeQueue;
+    }
+    /**
+     * 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.
+     */
+    mergeAndPersist(recs) {
+        // Merge into in-memory index. Rebuilding from scratch is wasteful
+        // for one record; instead apply the same buildIndex rules inline.
+        this.applyToIndex(recs);
+        this.writesSinceCompact += recs.length;
+        const shouldCompact = this.writesSinceCompact >= COMPACT_CHECK_EVERY;
+        if (shouldCompact)
+            this.writesSinceCompact = 0;
+        this.writeQueue = this.writeQueue
+            .then(() => appendRecords(this.cwd, recs))
+            .then(async () => {
+            if (!shouldCompact)
+                return;
+            // Background compaction rewrites the file. The in-memory
+            // index is NOT reloaded afterward: between the loadRecords
+            // step inside `compactIfNeeded` and our reload, additional
+            // `applyToIndex` calls would have mutated `this.index` —
+            // reloading would lose them. The in-memory index is the
+            // authoritative session view; compaction's purpose is
+            // disk-size reduction. Next session start re-reads the
+            // compacted file via `ProfileStore.create`.
+            await compactIfNeeded(this.cwd, { decayDays: this.decayDays });
+        })
+            .catch(() => {
+            /* logging must never break completions */
+        });
+    }
+    /**
+     * 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.
+     */
+    applyToIndex(recs) {
+        for (const r of recs) {
+            const w = r.weight;
+            switch (r.kind) {
+                case "ngram":
+                    if (r.tokens && r.tokens.length > 0) {
+                        const key = r.tokens.join(" ");
+                        this.index.ngram.set(key, (this.index.ngram.get(key) ?? 0) + w);
+                    }
+                    break;
+                case "path":
+                    if (r.value)
+                        this.index.path.set(r.value, (this.index.path.get(r.value) ?? 0) + w);
+                    break;
+                case "slash":
+                    if (r.value)
+                        this.index.slash.set(r.value, (this.index.slash.get(r.value) ?? 0) + w);
+                    break;
+                case "accept":
+                    if (r.prefixHash && r.completionTokens) {
+                        const existing = this.index.acceptByPrefix.get(r.prefixHash);
+                        if (existing) {
+                            existing.weight += w;
+                            existing.completionTokens = r.completionTokens;
+                        }
+                        else {
+                            this.index.acceptByPrefix.set(r.prefixHash, {
+                                completionTokens: r.completionTokens,
+                                weight: w,
+                            });
+                        }
+                        this.index.totalAcceptRecords += 1;
+                    }
+                    break;
+            }
+        }
+    }
+}
+/** Exported for tests — surface compactor knob without re-exporting `profile.ts`. */
+export { DEFAULT_DECAY_DAYS };
+//# sourceMappingURL=profile-store.js.map

package/dist/profile-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-store.js","sourceRoot":"","sources":["../src/profile-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACN,aAAa,EACb,cAAc,EACd,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GAGhB,MAAM,cAAc,CAAC;AAEtB,yEAAyE;AACzE,sEAAsE;AACtE,2DAA2D;AAE3D,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC,MAAM,OAAO,YAAY;IAQN;IAPT,QAAQ,CAAU;IACnB,KAAK,GAAiB,UAAU,EAAE,CAAC;IACnC,UAAU,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAC9C,kBAAkB,GAAG,CAAC,CAAC;IACvB,SAAS,CAAS;IAE1B,YACkB,GAAW,EAC5B,IAA8C;QAD7B,QAAG,GAAH,GAAG,CAAQ;QAG5B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAW,EAAE,MAAyB,OAAO,CAAC,GAAG;QACpE,MAAM,QAAQ,GAAG,GAAG,CAAC,gBAAgB,KAAK,KAAK,CAAC;QAChD,MAAM,SAAS,GAAG,iBAAiB,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QACrE,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,IAAI,CAAC;gBACJ,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;gBACvC,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;YAClD,CAAC;YAAC,MAAM,CAAC;gBACR,cAAc;YACf,CAAC;QACF,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC;IAED,QAAQ;QACP,OAAO,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;IAED,IAAI,gBAAgB;QACnB,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,aAAa,CAAC,IAAY,EAAE,KAAa,IAAI,CAAC,GAAG,EAAE;QAClD,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACzC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,MAAc,EAAE,UAAkB,EAAE,MAAM,GAAG,CAAC,EAAE,KAAa,IAAI,CAAC,GAAG,EAAE;QACpF,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAChC,MAAM,GAAG,GAAG,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,GAAG;YAAE,OAAO,KAAK,CAAC;QACvB,IAAI,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IACb,CAAC;IAED,kEAAkE;IAClE,cAAc,CAAC,MAAc;QAC5B,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC/B,OAAO,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,WAAW,CAAC,IAAY;QACvB,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,CAAC,CAAC;QAC5B,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,gBAAgB,CAAC,IAAY;QAC5B,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO,CAAC,CAAC;QAC5B,OAAO,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACH,oBAAoB,CAAC,MAAc;QAClC,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QAC9D,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,GAAG,CAAC,gBAAgB,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACpF,CAAC;IAED,2DAA2D;IAC3D,KAAK,CAAC,KAAK;QACV,MAAM,IAAI,CAAC,UAAU,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACK,eAAe,CAAC,IAAqB;QAC5C,kEAAkE;QAClE,kEAAkE;QAClE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC,MAAM,CAAC;QACvC,MAAM,aAAa,GAAG,IAAI,CAAC,kBAAkB,IAAI,mBAAmB,CAAC;QACrE,IAAI,aAAa;YAAE,IAAI,CAAC,kBAAkB,GAAG,CAAC,CAAC;QAC/C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU;aAC/B,IAAI,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;aACzC,IAAI,CAAC,KAAK,IAAI,EAAE;YAChB,IAAI,CAAC,aAAa;gBAAE,OAAO;YAC3B,yDAAyD;YACzD,2DAA2D;YAC3D,2DAA2D;YAC3D,yDAAyD;YACzD,wDAAwD;YACxD,sDAAsD;YACtD,uDAAuD;YACvD,4CAA4C;YAC5C,MAAM,eAAe,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAChE,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE;YACX,0CAA0C;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACK,YAAY,CAAC,IAAqB;QACzC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;YACnB,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;gBAChB,KAAK,OAAO;oBACX,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACrC,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;wBAC/B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;oBACjE,CAAC;oBACD,MAAM;gBACP,KAAK,MAAM;oBACV,IAAI,CAAC,CAAC,KAAK;wBAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;oBACnF,MAAM;gBACP,KAAK,OAAO;oBACX,IAAI,CAAC,CAAC,KAAK;wBACV,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;oBACzE,MAAM;gBACP,KAAK,QAAQ;oBACZ,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,gBAAgB,EAAE,CAAC;wBACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;wBAC7D,IAAI,QAAQ,EAAE,CAAC;4BACd,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC;4BACrB,QAAQ,CAAC,gBAAgB,GAAG,CAAC,CAAC,gBAAgB,CAAC;wBAChD,CAAC;6BAAM,CAAC;4BACP,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE;gCAC3C,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;gCACpC,MAAM,EAAE,CAAC;6BACT,CAAC,CAAC;wBACJ,CAAC;wBACD,IAAI,CAAC,KAAK,CAAC,kBAAkB,IAAI,CAAC,CAAC;oBACpC,CAAC;oBACD,MAAM;YACR,CAAC;QACF,CAAC;IACF,CAAC;CACD;AAED,qFAAqF;AACrF,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/profile.d.ts

@@ -0,0 +1,185 @@
+/**
+ * User profile — long-lived, cross-session frequency store. PRD §M4.
+ *
+ * Storage: `.pi/ghost-autocomplete/profile.jsonl` (append-only). One JSON
+ * record per line, written via the in-process writer.
+ *
+ * The profile feeds three local-only signals:
+ *  - ngram trigrams → reranker `profileBias` (PRD §M3c hook)
+ *  - path frequency → bounded boost to deterministic path/fuzzy ranking
+ *  - slash-command frequency → editor fast-path for `/cmd…` prefixes
+ *
+ * Privacy: raw full prefixes and full completions are NEVER persisted. We
+ * store sanitized n-grams (≤4), absolute paths, slash commands, and SHA-256
+ * hashes of prefix keys (`prefixHash`) for exact-prefix lookup without
+ * writing prompt text. The sanitizer is shared with `trie-sanitize.ts` so
+ * the entropy + key-prefix rules drop the same tokens.
+ *
+ * The on-disk format is intentionally append-only + line-delimited so a
+ * crash mid-write never corrupts the existing index; partial trailing lines
+ * are skipped on load. Rotation compacts when the file exceeds 2 MB.
+ */
+export declare const PROFILE_REL = ".pi/ghost-autocomplete/profile.jsonl";
+export declare const DEFAULT_MAX_BYTES: number;
+export declare const DEFAULT_DECAY_DAYS = 90;
+export declare const DROP_BELOW_WEIGHT = 0.1;
+export declare const MAX_NGRAM_N = 4;
+export declare const TRIGRAM_N = 3;
+export type ProfileKind = "ngram" | "path" | "slash" | "accept";
+/**
+ * One on-disk record. `weight` accumulates across captures and decays over
+ * time. `accept` records carry both `prefixHash` (for exact-prefix learning)
+ * and `prefixTailTokens` + `completionTokens` (already tokenized).
+ */
+export interface ProfileRecord {
+    ts: number;
+    kind: ProfileKind;
+    weight: number;
+    /** `kind=ngram`: ordered token tuple. */
+    tokens?: string[];
+    /** Trigram length when `kind=ngram`. */
+    n?: number;
+    /** `kind=path` / `kind=slash`: literal value. */
+    value?: string;
+    /** `kind=accept`: SHA-256 hex digest of the prefix at accept time. */
+    prefixHash?: string;
+    /** `kind=accept`: trailing tokens of the prefix (cap 4). */
+    prefixTailTokens?: string[];
+    /** `kind=accept`: tokens of the completion (cap 8). */
+    completionTokens?: string[];
+}
+/**
+ * In-memory aggregated view of the profile. The maps are weight-sums per
+ * key. `acceptByPrefix` is keyed by `prefixHash` so exact-prefix history is
+ * available without storing the raw prefix.
+ */
+export interface ProfileIndex {
+    ngram: Map<string, number>;
+    path: Map<string, number>;
+    slash: Map<string, number>;
+    acceptByPrefix: Map<string, {
+        completionTokens: string[];
+        weight: number;
+    }>;
+    totalAcceptRecords: number;
+}
+export declare function emptyIndex(): ProfileIndex;
+/**
+ * Tokenize a string into the same word-token form the profile stores. Drops
+ * the empty string, deduplicates whitespace, and lowercases nothing — code
+ * identifiers are case-sensitive.
+ */
+export declare function tokenize(text: string): string[];
+/**
+ * Generate n-grams of size `n` from `tokens`. Returns empty when there are
+ * fewer than `n` tokens.
+ */
+export declare function ngrams(tokens: string[], n: number): string[][];
+/**
+ * SHA-256 hex of a prefix string. The hash is the disk-storable surrogate
+ * for the prefix — same prefix always maps to the same key, but the raw
+ * prefix never leaves the process.
+ */
+export declare function prefixHash(prefix: string): string;
+/**
+ * Extract candidate paths from free text. Same shape used by `recent-paths.ts`
+ * but kept independent so changes to recent-paths semantics don't drift
+ * the profile schema. Matches `foo/bar.ts`, `src/a/b.tsx`, etc.
+ */
+export declare function extractPaths(text: string): string[];
+/**
+ * Extract `/slash-command` tokens from free text. Limited to a-z prefix
+ * plus alphanumerics/hyphen/underscore to avoid false matches on URLs
+ * (`https://…`) or expressions (`x/y`).
+ */
+export declare function extractSlash(text: string): string[];
+/**
+ * Build profile records from a committed user message. Capture path +
+ * slash + trigram ngrams. Sanitize check runs FIRST: messages with
+ * sensitive content are dropped entirely (consistent with session trie).
+ */
+export declare function recordsFromCommit(text: string, ts?: number): ProfileRecord[];
+/**
+ * Build an `accept` record for a full or partial acceptance. `prefix` is
+ * hashed; `completion` is tokenized. The raw prefix never appears in the
+ * returned record. Drops the whole record if either side fails sanitize.
+ */
+export declare function recordFromAccept(prefix: string, completion: string, weight?: number, ts?: number): ProfileRecord | null;
+/**
+ * Append one or more records to the JSONL file. Returns silently on write
+ * failure — profile logging must never break ghost completion.
+ */
+export declare function appendRecords(cwd: string, recs: ProfileRecord[]): Promise<void>;
+/**
+ * Parse the JSONL file into an array of records. Silently skips malformed
+ * lines (partial trailing write) and records missing required fields.
+ * Returns an empty array when the file does not exist.
+ */
+export declare function loadRecords(cwd: string): Promise<ProfileRecord[]>;
+export declare function parseRecords(body: string): ProfileRecord[];
+/**
+ * Build the in-memory aggregated index from a record list. Decays records
+ * older than `decayDays` by halving their weight; drops weights below
+ * `DROP_BELOW_WEIGHT` (0.1). `now` defaults to `Date.now()`; expose for
+ * deterministic tests.
+ */
+export declare function buildIndex(records: ProfileRecord[], opts?: {
+    decayDays?: number;
+    now?: number;
+}): ProfileIndex;
+/**
+ * Look up the weight of a trigram (already tokenized + joined). Returns 0
+ * when missing. Callers should also tokenize the candidate text the same
+ * way the writer did.
+ */
+export declare function ngramWeight(idx: ProfileIndex, tokens: string[]): number;
+/**
+ * Profile-bias score for a candidate completion. PRD §M4
+ * "Ranking-from-prior": `α·log(1 + ngramWeight) + β·pathWeight + γ·slashWeight`.
+ * Returns 0 when the index is empty or the candidate has no signal —
+ * neutral input to the reranker.
+ */
+export declare function profileBias(idx: ProfileIndex, text: string, weights?: {
+    alpha?: number;
+    beta?: number;
+    gamma?: number;
+}): number;
+/**
+ * Bounded boost for deterministic path matches. Capped so persistent
+ * frequency cannot beat a fresh exact-prefix path-prefix match (PRD §M4
+ * "Deterministic path/fuzzy ranking"). The cap is a constant 0.2 — tune
+ * once we have replay data.
+ */
+export declare const MAX_PATH_BOOST = 0.2;
+export declare function profilePathBoost(idx: ProfileIndex, path: string): number;
+/**
+ * Slash-command frequency score. Used by the editor's slash fast-path:
+ * given a `/cmd-prefix`, return the best-matching full command by weight.
+ * Returns null when nothing in the index extends `prefix`.
+ */
+export declare function bestSlashMatch(idx: ProfileIndex, prefix: string): {
+    cmd: string;
+    weight: number;
+} | null;
+/**
+ * Rotate + compact when the file exceeds `maxBytes`. Strategy: load all
+ * records, decay them, sum weights per (kind, key), drop sub-threshold
+ * entries, write the compacted file back. Returns true when a rotation
+ * happened. Best-effort — swallows errors.
+ */
+export declare function compactIfNeeded(cwd: string, opts?: {
+    maxBytes?: number;
+    decayDays?: number;
+    now?: number;
+}): Promise<boolean>;
+/**
+ * Compact a record list in memory: decay aged weights, sum per (kind,key),
+ * drop sub-threshold. Pure function — exposed for unit tests.
+ */
+export declare function compactRecords(records: ProfileRecord[], opts?: {
+    decayDays?: number;
+    now?: number;
+}): ProfileRecord[];
+/** Parse `PI_GHOST_PROFILE_DECAY_DAYS`. Falls back to default when invalid. */
+export declare function parseDecayDaysEnv(raw: string | undefined): number;
+//# sourceMappingURL=profile.d.ts.map

package/dist/profile.d.ts.map

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