context-eng 0.1.0

package/dist/secrets.js

@@ -0,0 +1,135 @@
+export const TYPE_SAFE_KEY_PROMPT = "TypeSafe API key (hidden, Enter to skip): ";
+export const TYPE_SAFE_KEY_REPLACE_PROMPT = "New TypeSafe API key (hidden, Enter to keep the saved key): ";
+const KEYCHAIN_SERVICE = "context-eng";
+const KEYCHAIN_ACCOUNT = "typesafe-api-key";
+export function resolveTypeSafeApiKey(env, read) {
+    if (env.TYPESAFE_API_KEY !== undefined)
+        return { apiKey: env.TYPESAFE_API_KEY.trim() };
+    try {
+        return { apiKey: read()?.trim() ?? "" };
+    }
+    catch (error) {
+        return {
+            apiKey: "",
+            warning: `TypeSafe keychain unreadable. Search will stay local. ${errorText(error)}`,
+        };
+    }
+}
+export async function loadTypeSafeApiKey(env = process.env) {
+    if (env.TYPESAFE_API_KEY !== undefined)
+        return { apiKey: env.TYPESAFE_API_KEY.trim() };
+    const store = await openOsKeychain();
+    return resolveTypeSafeApiKey(env, () => store.get());
+}
+export async function openOsKeychain() {
+    try {
+        const { Entry } = await import("@napi-rs/keyring");
+        const entry = new Entry(KEYCHAIN_SERVICE, KEYCHAIN_ACCOUNT);
+        return {
+            get: () => entry.getPassword(),
+            set: (secret) => {
+                entry.setPassword(secret);
+            },
+        };
+    }
+    catch (error) {
+        const message = `OS keychain is unavailable. ${errorText(error)}`;
+        return {
+            get() {
+                throw new Error(message);
+            },
+            set() {
+                throw new Error(message);
+            },
+        };
+    }
+}
+export async function ensureTypeSafeKey(options) {
+    const log = options.log ?? ((line) => console.log(line));
+    let existing;
+    try {
+        existing = options.store.get();
+    }
+    catch (error) {
+        log(`TypeSafe keychain unavailable. Search will stay local. ${errorText(error)}`);
+        return "skipped";
+    }
+    const replacing = existing !== null && existing.trim() !== "";
+    if (!options.interactive) {
+        log(replacing
+            ? "TypeSafe key is already in the OS keychain."
+            : "No TypeSafe key saved. Run context-eng init in a terminal to store one in the OS keychain.");
+        return replacing ? "present" : "skipped";
+    }
+    log(replacing
+        ? "A TypeSafe key is already saved. Enter a new key to replace it, or press Enter to keep it."
+        : "The key is stored in the OS keychain for this login. It is not written to the project.");
+    const prompt = options.prompt ?? ((label) => promptHidden(label));
+    const key = (await prompt(replacing ? TYPE_SAFE_KEY_REPLACE_PROMPT : TYPE_SAFE_KEY_PROMPT)).trim();
+    if (key === "") {
+        log(replacing
+            ? "Kept the saved TypeSafe key."
+            : "Skipped. Search stays on local FTS5 until a key is saved.");
+        return replacing ? "present" : "skipped";
+    }
+    try {
+        options.store.set(key);
+    }
+    catch (error) {
+        log(replacing
+            ? `Could not replace the TypeSafe key. The saved key is unchanged. ${errorText(error)}`
+            : `Could not save the TypeSafe key. Search will stay local. ${errorText(error)}`);
+        return replacing ? "present" : "skipped";
+    }
+    log(replacing
+        ? "Replaced the TypeSafe key in the OS keychain."
+        : "Saved the TypeSafe key in the OS keychain.");
+    return "saved";
+}
+export function promptHidden(label, io = {}) {
+    const input = io.input ?? process.stdin;
+    const output = io.output ?? process.stdout;
+    if (!input.isTTY || typeof input.setRawMode !== "function")
+        return Promise.resolve("");
+    return new Promise((resolve, reject) => {
+        let value = "";
+        let settled = false;
+        const finish = (fn) => {
+            if (settled)
+                return;
+            settled = true;
+            input.setRawMode(false);
+            input.pause();
+            input.off("data", onData);
+            output.write("\n");
+            fn();
+        };
+        const onData = (chunk) => {
+            const text = typeof chunk === "string" ? chunk : chunk.toString("utf8");
+            for (const char of text) {
+                if (char === "\u0003") {
+                    finish(() => reject(new Error("TypeSafe key prompt aborted")));
+                    return;
+                }
+                if (char === "\r" || char === "\n") {
+                    finish(() => resolve(value.trim()));
+                    return;
+                }
+                if (char === "\u007f" || char === "\b") {
+                    value = value.slice(0, -1);
+                    continue;
+                }
+                if (char >= " ")
+                    value += char;
+            }
+        };
+        output.write(label);
+        input.setRawMode(true);
+        input.resume();
+        input.on("data", onData);
+    });
+}
+function errorText(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=secrets.js.map

package/dist/secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,4CAA4C,CAAC;AACjF,MAAM,CAAC,MAAM,4BAA4B,GAAG,8DAA8D,CAAC;AAS3G,MAAM,gBAAgB,GAAG,aAAa,CAAC;AACvC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AAE5C,MAAM,UAAU,qBAAqB,CACnC,GAAkC,EAClC,IAAyB;IAEzB,IAAI,GAAG,CAAC,gBAAgB,KAAK,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC;IACvF,IAAI,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,yDAAyD,SAAS,CAAC,KAAK,CAAC,EAAE;SACrF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAyB,OAAO,CAAC,GAAG;IAEpC,IAAI,GAAG,CAAC,gBAAgB,KAAK,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC;IACvF,MAAM,KAAK,GAAG,MAAM,cAAc,EAAE,CAAC;IACrC,OAAO,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,CAAC;QACH,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;QAC5D,OAAO;YACL,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE;YAC9B,GAAG,EAAE,CAAC,MAAc,EAAE,EAAE;gBACtB,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAC5B,CAAC;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,+BAA+B,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QAClE,OAAO;YACL,GAAG;gBACD,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;YAC3B,CAAC;YACD,GAAG;gBACD,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;YAC3B,CAAC;SACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAKvC;IACC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACjE,IAAI,QAAuB,CAAC;IAC5B,IAAI,CAAC;QACH,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,0DAA0D,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClF,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,SAAS,GAAG,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IAC9D,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACzB,GAAG,CAAC,SAAS;YACX,CAAC,CAAC,6CAA6C;YAC/C,CAAC,CAAC,4FAA4F,CAAC,CAAC;QAClG,OAAO,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3C,CAAC;IACD,GAAG,CAAC,SAAS;QACX,CAAC,CAAC,4FAA4F;QAC9F,CAAC,CAAC,wFAAwF,CAAC,CAAC;IAC9F,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,KAAa,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1E,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnG,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACf,GAAG,CAAC,SAAS;YACX,CAAC,CAAC,8BAA8B;YAChC,CAAC,CAAC,2DAA2D,CAAC,CAAC;QACjE,OAAO,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3C,CAAC;IACD,IAAI,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,SAAS;YACX,CAAC,CAAC,mEAAmE,SAAS,CAAC,KAAK,CAAC,EAAE;YACvF,CAAC,CAAC,4DAA4D,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACpF,OAAO,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3C,CAAC;IACD,GAAG,CAAC,SAAS;QACX,CAAC,CAAC,+CAA+C;QACjD,CAAC,CAAC,4CAA4C,CAAC,CAAC;IAClD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,KAAa,EACb,KAAiE,EAAE;IAEnE,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;IACxC,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAC3C,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,UAAU;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACvF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,KAAK,GAAG,EAAE,CAAC;QACf,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,MAAM,GAAG,CAAC,EAAc,EAAE,EAAE;YAChC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YACxB,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC1B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACnB,EAAE,EAAE,CAAC;QACP,CAAC,CAAC;QACF,MAAM,MAAM,GAAG,CAAC,KAAsB,EAAE,EAAE;YACxC,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACxE,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;gBACxB,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACtB,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC,CAAC,CAAC;oBAC/D,OAAO;gBACT,CAAC;gBACD,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;oBACnC,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;oBACpC,OAAO;gBACT,CAAC;gBACD,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;oBACvC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;oBAC3B,SAAS;gBACX,CAAC;gBACD,IAAI,IAAI,IAAI,GAAG;oBAAE,KAAK,IAAI,IAAI,CAAC;YACjC,CAAC;QACH,CAAC,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACpB,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACvB,KAAK,CAAC,MAAM,EAAE,CAAC;QACf,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/text.d.ts

@@ -0,0 +1,22 @@
+/** Unicode-aware, lowercased word tokens with English stopwords removed, deduplicated in order. */
+export declare function keywords(text: string): string[];
+/** True when a second sentence starts after `.` `!` or `?`. */
+export declare function hasMultipleSentences(content: string): boolean;
+/** Structured labels are stored as normalized comma-separated values for FTS display. */
+export declare function parseLabels(labels: string | null | undefined): string[];
+export declare const parseTags: typeof parseLabels;
+export declare function normalizeLabel(value: string): string;
+export declare function normalizeLabels(values: readonly string[] | undefined): string[];
+export declare function serializeLabels(values: readonly string[] | undefined): string | null;
+export declare const serializeTags: typeof serializeLabels;
+/**
+ * Build an FTS5 MATCH expression from free text. Each token is quoted so
+ * FTS5 syntax characters in the query cannot break the statement.
+ * Returns null when nothing is searchable.
+ */
+export declare function buildFtsQuery(query: string): string | null;
+export declare function lexicalQueryTerms(query: string): string[];
+/** Return one conservatively corrected lexical query, or null when no unambiguous correction exists. */
+export declare function correctTypoQuery(query: string, vocabularyText: readonly string[]): string | null;
+/** Unicode-aware Damerau-Levenshtein. Caps at maxDistance+1 when the bound is finite. */
+export declare function editDistance(left: string, right: string, maxDistance?: number): number;

package/dist/text.js

@@ -0,0 +1,153 @@
+const STOPWORDS = new Set([
+    "a", "an", "the", "and", "or", "but", "if", "then", "else", "when", "while",
+    "of", "to", "in", "on", "at", "by", "for", "with", "from", "into", "about",
+    "as", "is", "are", "was", "were", "be", "been", "being", "am",
+    "it", "its", "this", "that", "these", "those", "there", "here",
+    "i", "we", "you", "he", "she", "they", "me", "us", "them", "my", "our", "your",
+    "do", "does", "did", "done", "doing", "have", "has", "had",
+    "yes", "so", "too", "very", "just", "only", "also",
+    "can", "could", "should", "would", "will", "may", "might",
+    "use", "used", "using", "prefer", "please",
+    "after", "before", "over", "under", "again", "all", "any", "each", "some",
+    "how", "what", "which", "who", "why", "where",
+]);
+const NEGATIVE_TERMS = ["not", "no", "never"];
+const POSITIVE_TERMS = ["always", "must", "required"];
+const POLARITY_TERMS = new Set([...NEGATIVE_TERMS, ...POSITIVE_TERMS]);
+/** Unicode-aware, lowercased word tokens with English stopwords removed, deduplicated in order. */
+export function keywords(text) {
+    const seen = new Set();
+    const out = [];
+    const rawTokens = text.toLowerCase().match(/[\p{L}\p{M}\p{N}_-]+/gu) ?? [];
+    for (const raw of rawTokens) {
+        const tok = raw.replace(/^[-_]+|[-_]+$/g, "");
+        const singleAsciiCharacter = tok.length === 1 && /^[a-z0-9]$/.test(tok);
+        if (tok.length === 0 || singleAsciiCharacter || STOPWORDS.has(tok) || seen.has(tok))
+            continue;
+        seen.add(tok);
+        out.push(tok);
+    }
+    return out;
+}
+/** True when a second sentence starts after `.` `!` or `?`. */
+export function hasMultipleSentences(content) {
+    return /[.!?]["')\]]*\s+[A-Za-z]/.test(content.trim());
+}
+/** Structured labels are stored as normalized comma-separated values for FTS display. */
+export function parseLabels(labels) {
+    if (!labels)
+        return [];
+    return labels
+        .split(",")
+        .map((t) => normalizeLabel(t))
+        .filter((t) => t.length > 0);
+}
+export const parseTags = parseLabels;
+export function normalizeLabel(value) {
+    return value.normalize("NFKC").trim().toLocaleLowerCase("en-US");
+}
+export function normalizeLabels(values) {
+    if (!values)
+        return [];
+    return [...new Set(values.map(normalizeLabel).filter(Boolean))];
+}
+export function serializeLabels(values) {
+    const clean = normalizeLabels(values);
+    return clean.length ? clean.join(",") : null;
+}
+export const serializeTags = serializeLabels;
+/**
+ * Build an FTS5 MATCH expression from free text. Each token is quoted so
+ * FTS5 syntax characters in the query cannot break the statement.
+ * Returns null when nothing is searchable.
+ */
+export function buildFtsQuery(query) {
+    const toks = keywords(query);
+    if (toks.length === 0)
+        return null;
+    const groups = [];
+    if (toks.some((token) => NEGATIVE_TERMS.includes(token))) {
+        groups.push(orGroup(NEGATIVE_TERMS, true));
+    }
+    else if (toks.some((token) => POSITIVE_TERMS.includes(token))) {
+        groups.push(orGroup(POSITIVE_TERMS, true));
+    }
+    const subjectTerms = toks.filter((token) => !POLARITY_TERMS.has(token));
+    if (subjectTerms.length > 0)
+        groups.push(orGroup(subjectTerms, groups.length > 0));
+    return groups.length > 0 ? groups.join(" AND ") : null;
+}
+export function lexicalQueryTerms(query) {
+    return keywords(query).filter((token) => !POLARITY_TERMS.has(token));
+}
+/** Return one conservatively corrected lexical query, or null when no unambiguous correction exists. */
+export function correctTypoQuery(query, vocabularyText) {
+    const queryTokens = keywords(query);
+    const vocabulary = new Set(vocabularyText.flatMap((text) => keywords(text)));
+    const replacements = new Map();
+    for (const token of queryTokens) {
+        if (replacements.size >= 3 || vocabulary.has(token) || POLARITY_TERMS.has(token))
+            continue;
+        const characters = [...token];
+        if (characters.length < 4 || !/^\p{L}[\p{L}\p{M}]*$/u.test(token))
+            continue;
+        const maxDistance = characters.length >= 8 ? 2 : 1;
+        let bestDistance = maxDistance + 1;
+        let best;
+        let tied = false;
+        for (const candidate of vocabulary) {
+            if (!/^\p{L}[\p{L}\p{M}]*$/u.test(candidate))
+                continue;
+            if (Math.abs([...candidate].length - characters.length) > maxDistance)
+                continue;
+            const distance = editDistance(token, candidate, maxDistance);
+            if (distance < bestDistance) {
+                bestDistance = distance;
+                best = candidate;
+                tied = false;
+            }
+            else if (distance === bestDistance) {
+                tied = true;
+            }
+        }
+        if (best !== undefined && bestDistance <= maxDistance && !tied)
+            replacements.set(token, best);
+    }
+    if (replacements.size === 0)
+        return null;
+    return queryTokens.map((token) => replacements.get(token) ?? token).join(" ");
+}
+function orGroup(tokens, parenthesize) {
+    const quoted = tokens.map((token) => `"${token.replace(/"/g, "")}"`);
+    const expression = quoted.join(" OR ");
+    return parenthesize && quoted.length > 1 ? `(${expression})` : expression;
+}
+/** Unicode-aware Damerau-Levenshtein. Caps at maxDistance+1 when the bound is finite. */
+export function editDistance(left, right, maxDistance = Number.POSITIVE_INFINITY) {
+    const a = [...left];
+    const b = [...right];
+    if (Math.abs(a.length - b.length) > maxDistance)
+        return maxDistance + 1;
+    const matrix = Array.from({ length: a.length + 1 }, () => new Array(b.length + 1).fill(0));
+    for (let row = 0; row <= a.length; row += 1)
+        matrix[row][0] = row;
+    for (let column = 0; column <= b.length; column += 1)
+        matrix[0][column] = column;
+    for (let row = 1; row <= a.length; row += 1) {
+        for (let column = 1; column <= b.length; column += 1) {
+            const substitution = matrix[row - 1][column - 1] + (a[row - 1] === b[column - 1] ? 0 : 1);
+            const deletion = matrix[row - 1][column] + 1;
+            const insertion = matrix[row][column - 1] + 1;
+            let distance = Math.min(substitution, deletion, insertion);
+            if (row > 1 &&
+                column > 1 &&
+                a[row - 1] === b[column - 2] &&
+                a[row - 2] === b[column - 1]) {
+                distance = Math.min(distance, matrix[row - 2][column - 2] + 1);
+            }
+            matrix[row][column] = distance;
+        }
+    }
+    return matrix[a.length][b.length];
+}
+//# sourceMappingURL=text.js.map

package/dist/text.js.map

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

package/dist/tokens.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Cheap token estimate. No tokenizer dependency in stage one.
+ * Uses the larger of a character-based and a word-based estimate so both
+ * dense code and prose land close to what a BPE tokenizer would report.
+ */
+export declare function approxTokens(text: string): number;

package/dist/tokens.js

@@ -0,0 +1,15 @@
+/**
+ * Cheap token estimate. No tokenizer dependency in stage one.
+ * Uses the larger of a character-based and a word-based estimate so both
+ * dense code and prose land close to what a BPE tokenizer would report.
+ */
+export function approxTokens(text) {
+    const trimmed = text.trim();
+    if (trimmed.length === 0)
+        return 0;
+    const byChars = Math.ceil(trimmed.length / 4);
+    const words = trimmed.split(/\s+/).length;
+    const byWords = Math.ceil(words * 1.3);
+    return Math.max(byChars, byWords);
+}
+//# sourceMappingURL=tokens.js.map

package/dist/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;IACvC,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACpC,CAAC"}

package/dist/typesafe.d.ts

@@ -0,0 +1,40 @@
+import { type SearchHit, type SearchResult } from "./engine.js";
+/** @context-eng-locked Jev request deadline. Do not change unless the user asks. */
+export declare const DEFAULT_JEV_TIMEOUT_MS = 20000;
+export declare const RELEVANCE_THRESHOLD = 0.5;
+export declare const NOT_RELEVANT_MESSAGE = "no matching memory. after work, memory_create if something happened like a decision , preferences , workflow , mistakes , instructions and you need to save it for later.";
+export declare const TOO_LARGE_TO_EVALUATE_MESSAGE = "Memory is too large to evaluate.";
+export declare const MAX_JEV_EVALUATE_COUNT: number;
+export interface RelevanceEvaluator {
+    available?(): boolean;
+    evaluate(query: string, candidates: SearchHit[]): Promise<number[]>;
+}
+export interface RelevantSearchHit extends SearchHit {
+    relevance: number;
+}
+export interface RelevantSearchResult extends Omit<SearchResult, "hits"> {
+    hits: RelevantSearchHit[];
+    rejected_count: number;
+    message?: string;
+}
+export declare class TypeSafeError extends Error {
+    constructor(message: string);
+}
+interface TypeSafeOptions {
+    apiKey?: string;
+    endpoint?: string;
+    fetcher?: typeof fetch;
+    timeoutMs?: number;
+}
+export declare class TypeSafeRelevanceEvaluator implements RelevanceEvaluator {
+    private readonly apiKey;
+    private readonly endpoint;
+    private readonly fetcher;
+    private readonly timeoutMs;
+    constructor(options?: TypeSafeOptions);
+    available(): boolean;
+    evaluate(query: string, candidates: SearchHit[]): Promise<number[]>;
+    private evaluateBatch;
+}
+export declare function applyRelevanceGate(result: SearchResult, evaluator: RelevanceEvaluator): Promise<RelevantSearchResult>;
+export {};

package/dist/typesafe.js

@@ -0,0 +1,170 @@
+import { budgetHits, sortHits, } from "./engine.js";
+import { MAX_JEV_BATCHES, MAX_JEV_CANDIDATES } from "./categories.js";
+const DEFAULT_ENDPOINT = "https://api.typesafe.ai/v1/systemone";
+/** @context-eng-locked Jev request deadline. Do not change unless the user asks. */
+export const DEFAULT_JEV_TIMEOUT_MS = 20_000;
+export const RELEVANCE_THRESHOLD = 0.5;
+export const NOT_RELEVANT_MESSAGE = "no matching memory. after work, memory_create if something happened like a decision , preferences , workflow , mistakes , instructions and you need to save it for later.";
+export const TOO_LARGE_TO_EVALUATE_MESSAGE = "Memory is too large to evaluate.";
+export const MAX_JEV_EVALUATE_COUNT = MAX_JEV_CANDIDATES * MAX_JEV_BATCHES;
+export class TypeSafeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "TypeSafeError";
+    }
+}
+export class TypeSafeRelevanceEvaluator {
+    apiKey;
+    endpoint;
+    fetcher;
+    timeoutMs;
+    constructor(options = {}) {
+        this.apiKey = options.apiKey?.trim() || process.env.TYPESAFE_API_KEY?.trim() || "";
+        this.endpoint = options.endpoint?.trim() || process.env.TYPESAFE_API_URL?.trim() || DEFAULT_ENDPOINT;
+        this.fetcher = options.fetcher ?? fetch;
+        this.timeoutMs = normalizeTimeout(options.timeoutMs);
+    }
+    available() {
+        return this.apiKey.length > 0;
+    }
+    async evaluate(query, candidates) {
+        if (candidates.length === 0)
+            return [];
+        if (!this.available())
+            throw new TypeSafeError("TYPESAFE_API_KEY is not configured.");
+        const limited = limitJevCandidates(candidates);
+        const batches = [];
+        for (let index = 0; index < limited.length; index += MAX_JEV_CANDIDATES) {
+            batches.push(limited.slice(index, index + MAX_JEV_CANDIDATES));
+        }
+        const scores = await Promise.all(batches.map((batch) => this.evaluateBatch(query, batch)));
+        return scores.flat();
+    }
+    async evaluateBatch(query, candidates) {
+        const questions = Object.fromEntries(candidates.map((_, index) => [
+            `context_${index}`,
+            {
+                type: "noul",
+                instructions: [
+                    `Decide whether contexts[${index}] is directly useful for answering or completing agent_prompt.`,
+                    "Judge semantic usefulness, not merely shared words.",
+                ],
+                criteria: {
+                    true: "The context meaningfully helps complete the agent prompt.",
+                    false: "The context is unrelated, incidental, or too weak to help.",
+                },
+            },
+        ]));
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        timer.unref?.();
+        try {
+            const response = await this.fetcher(this.endpoint, {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${this.apiKey}`,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify({
+                    state: {
+                        agent_prompt: query,
+                        contexts: candidates.map((candidate) => candidate.content),
+                    },
+                    model: "jev-latest",
+                    questions,
+                }),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                throw new TypeSafeError(`TypeSafe relevance evaluation failed with HTTP ${response.status}.`);
+            }
+            let body;
+            try {
+                body = await response.json();
+            }
+            catch (error) {
+                if (controller.signal.aborted)
+                    throw error;
+                throw new TypeSafeError("TypeSafe relevance evaluation returned invalid JSON.");
+            }
+            if (!isRecord(body) || !isRecord(body.answers)) {
+                throw new TypeSafeError("TypeSafe relevance evaluation returned an invalid response.");
+            }
+            const answers = body.answers;
+            return candidates.map((_, index) => {
+                const answer = answers[`context_${index}`];
+                if (!isRecord(answer) ||
+                    answer.type !== "noul" ||
+                    typeof answer.noul !== "number" ||
+                    !Number.isFinite(answer.noul) ||
+                    answer.noul < 0 ||
+                    answer.noul > 1) {
+                    throw new TypeSafeError(`TypeSafe relevance evaluation omitted context_${index}.`);
+                }
+                return answer.noul;
+            });
+        }
+        catch (error) {
+            if (controller.signal.aborted) {
+                throw new TypeSafeError(`TypeSafe relevance evaluation timed out after ${this.timeoutMs}ms.`);
+            }
+            if (error instanceof TypeSafeError)
+                throw error;
+            const detail = error instanceof Error ? error.message : String(error);
+            throw new TypeSafeError(`TypeSafe relevance evaluation failed: ${detail}`);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+function normalizeTimeout(value) {
+    if (value === undefined)
+        return DEFAULT_JEV_TIMEOUT_MS;
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new TypeError("timeoutMs must be a positive finite number");
+    }
+    return Math.floor(value);
+}
+export async function applyRelevanceGate(result, evaluator) {
+    if (result.hits.length === 0) {
+        return { ...result, hits: [], rejected_count: 0, message: NOT_RELEVANT_MESSAGE };
+    }
+    const truncated = result.hits.length > MAX_JEV_EVALUATE_COUNT;
+    const candidates = limitJevCandidates(result.hits);
+    const scores = await evaluator.evaluate(result.query, candidates);
+    if (scores.length !== candidates.length) {
+        throw new TypeSafeError("TypeSafe relevance evaluation returned the wrong number of scores.");
+    }
+    const approved = [];
+    for (const [index, hit] of candidates.entries()) {
+        const relevance = scores[index];
+        if (relevance !== undefined && relevance > RELEVANCE_THRESHOLD) {
+            const rounded = round(relevance);
+            approved.push({ ...hit, score: rounded, relevance: rounded });
+        }
+    }
+    const sorted = sortHits(approved, result.sort);
+    const hits = budgetHits(sorted, result.budget.max_hits, result.budget.max_tokens);
+    const filtered = {
+        ...result,
+        hits,
+        total_tokens: hits.reduce((sum, hit) => sum + hit.tokens, 0),
+        rejected_count: result.hits.length - approved.length,
+    };
+    if (truncated && hits.length > 0)
+        filtered.message = TOO_LARGE_TO_EVALUATE_MESSAGE;
+    else if (hits.length === 0)
+        filtered.message = NOT_RELEVANT_MESSAGE;
+    return filtered;
+}
+function limitJevCandidates(candidates) {
+    return candidates.slice(0, MAX_JEV_EVALUATE_COUNT);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function round(value) {
+    return Math.round(value * 1000) / 1000;
+}
+//# sourceMappingURL=typesafe.js.map

package/dist/typesafe.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "context-eng",
+  "version": "0.1.0",
+  "description": "Local Project Memory Router for Codex and Claude Code: SQLite + FTS5 behind MCP tools.",
+  "type": "module",
+  "license": "MIT",
+  "author": "mayank",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mayank-devac/context-eng.git"
+  },
+  "bin": {
+    "context-eng": "./dist/cli-entry.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "system_prompts"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "typecheck:test": "tsc -p tsconfig.test.json",
+    "mcp": "tsx src/cli-entry.ts mcp",
+    "init": "tsx src/cli-entry.ts init",
+    "inspect:search": "tsx src/inspect-cli.ts",
+    "start": "node dist/cli-entry.js mcp",
+    "test": "vitest run",
+    "lint": "eslint src test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "@napi-rs/keyring": "^1.3.0",
+    "better-sqlite3": "^13.0.3",
+    "zod": "^4.6.4"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/better-sqlite3": "^9.6.0",
+    "@types/node": "^26.5.1",
+    "eslint": "^10.10.0",
+    "tsx": "^4.23.13",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.70.0",
+    "vitest": "^5.0.0"
+  }
+}