memshare-mcp 0.2.6

package/dist/memory/redact.js

@@ -0,0 +1,275 @@
+/**
+ * Conservative PII detection, run before anything leaves the machine.
+ *
+ * The bias here is deliberate: a false positive costs the user one keystroke
+ * in the export preview, a false negative leaks their medical history to a
+ * colleague. When in doubt, flag it.
+ */
+const LABELS = {
+    email: "email address",
+    phone: "phone number",
+    "government-id": "government ID",
+    "credit-card": "payment card",
+    "bank-account": "bank account",
+    secret: "credential or API key",
+    health: "health information",
+    financial: "financial information",
+};
+/** Lower priority categories lose when two findings cover the same text. */
+const PRIORITY = [
+    "secret",
+    "credit-card",
+    "bank-account",
+    "government-id",
+    "email",
+    "phone",
+    "health",
+    "financial",
+];
+const EMAIL = /[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}/gi;
+// Any run of 7-15 digits held together by the usual separators, optionally
+// with a country code. Post-filtered below so "15min" and "2024-01-02" survive.
+const PHONE_CANDIDATE = /\+?\d[\d\s().-]{5,}\d/g;
+const SSN = /\b\d{3}-\d{2}-\d{4}\b/g;
+// A bare 9-digit national ID is indistinguishable from any other number, so
+// it only counts when the surrounding text says that is what it is.
+const GOV_ID_IN_CONTEXT = /\b(?:ssn|social security|passport(?:\s*(?:no|number|#))?|national\s*id|id\s*(?:no|number|#)|driver'?s?\s*licen[cs]e|tax\s*id|tin)\b\W{0,12}([A-Z0-9][A-Z0-9-]{5,})/gi;
+const CARD_CANDIDATE = /\b(?:\d[ -]?){13,19}\b/g;
+const IBAN = /\b[A-Z]{2}\d{2}(?:[ ]?[A-Z0-9]{4}){2,7}[ ]?[A-Z0-9]{1,4}\b/g;
+const BANK_IN_CONTEXT = /\b(?:iban|swift|bic|routing(?:\s*number)?|sort\s*code|account\s*(?:no|number|#))\b\W{0,12}([A-Z0-9][A-Z0-9-]{5,})/gi;
+const SECRET_PATTERNS = [
+    /\bsk-[A-Za-z0-9_-]{16,}\b/g, // OpenAI-style
+    /\bsk-ant-[A-Za-z0-9_-]{16,}\b/g, // Anthropic
+    /\bgh[pousr]_[A-Za-z0-9]{20,}\b/g, // GitHub
+    /\bxox[abposr]-[A-Za-z0-9-]{10,}\b/g, // Slack
+    /\bAKIA[0-9A-Z]{16}\b/g, // AWS access key id
+    /-----BEGIN (?:RSA |EC |OPENSSH |PGP )?PRIVATE KEY-----/g,
+    /\b(?:api[_-]?key|secret|token|password|passwd|bearer)\b\s*[:=]\s*["']?([A-Za-z0-9_\-./+]{12,})["']?/gi,
+];
+const HEALTH_KEYWORDS = [
+    "diagnosis",
+    "diagnosed",
+    "prescription",
+    "prescribed",
+    "medication",
+    "dosage",
+    "symptom",
+    "therapist",
+    "therapy session",
+    "psychiatric",
+    "psychiatrist",
+    "antidepressant",
+    "depression",
+    "anxiety disorder",
+    "bipolar",
+    "adhd",
+    "autism",
+    "cancer",
+    "chemotherapy",
+    "tumor",
+    "hiv",
+    "diabetes",
+    "insulin",
+    "pregnant",
+    "pregnancy",
+    "miscarriage",
+    "fertility",
+    "surgery",
+    "hospitalized",
+    "medical record",
+    "blood test",
+    "disability",
+    "chronic illness",
+];
+const FINANCIAL_KEYWORDS = [
+    "salary",
+    "my income",
+    "net worth",
+    "credit score",
+    "mortgage",
+    "in debt",
+    "bankruptcy",
+    "bank balance",
+    "take-home pay",
+    "annual compensation",
+    "stock options",
+    "equity grant",
+    "severance",
+];
+/** Finds every PII-looking span in `text`, highest-confidence first. */
+export function scanForPII(text) {
+    const found = [];
+    for (const pattern of SECRET_PATTERNS) {
+        collect(text, pattern, "secret", found);
+    }
+    for (const m of matches(text, CARD_CANDIDATE)) {
+        const digits = m.value.replace(/\D/g, "");
+        if (digits.length < 13 || digits.length > 19)
+            continue;
+        if (!luhn(digits))
+            continue;
+        found.push(finding("credit-card", m.value, m.index));
+    }
+    collect(text, IBAN, "bank-account", found, (v) => /\d/.test(v) && /[A-Z]/.test(v));
+    collectGroup(text, BANK_IN_CONTEXT, "bank-account", found);
+    collect(text, SSN, "government-id", found);
+    collectGroup(text, GOV_ID_IN_CONTEXT, "government-id", found);
+    collect(text, EMAIL, "email", found);
+    for (const m of matches(text, PHONE_CANDIDATE)) {
+        if (!looksLikePhone(m.value))
+            continue;
+        found.push(finding("phone", m.value, m.index));
+    }
+    collectKeywords(text, HEALTH_KEYWORDS, "health", found);
+    collectKeywords(text, FINANCIAL_KEYWORDS, "financial", found);
+    return dedupe(found);
+}
+/** True when `text` carries anything that should not be exported by default. */
+export function containsPII(text) {
+    return scanForPII(text).length > 0;
+}
+/**
+ * Replaces every finding with a `[redacted: ...]` marker. Keyword findings
+ * mark the keyword only -- the surrounding sentence is left intact so the
+ * user can see what they are deciding about.
+ */
+export function redact(text) {
+    const findings = scanForPII(text);
+    if (findings.length === 0)
+        return { text, findings };
+    // Right to left, so earlier offsets stay valid as we splice.
+    const ordered = [...findings].sort((a, b) => b.index - a.index);
+    let out = text;
+    for (const f of ordered) {
+        out =
+            out.slice(0, f.index) +
+                `[redacted: ${LABELS[f.category]}]` +
+                out.slice(f.index + f.match.length);
+    }
+    return { text: out, findings };
+}
+/** One line per finding, for the export preview. */
+export function summarisePII(findings) {
+    const byCategory = new Map();
+    for (const f of findings)
+        byCategory.set(f.category, (byCategory.get(f.category) ?? 0) + 1);
+    return [...byCategory.entries()]
+        .map(([category, count]) => (count > 1 ? `${LABELS[category]} x${count}` : LABELS[category]))
+        .join(", ");
+}
+export function labelFor(category) {
+    return LABELS[category];
+}
+function finding(category, match, index) {
+    return { category, label: LABELS[category], match, index };
+}
+function* matches(text, pattern) {
+    const re = new RegExp(pattern.source, pattern.flags.includes("g") ? pattern.flags : `${pattern.flags}g`);
+    let m;
+    while ((m = re.exec(text)) !== null) {
+        if (m[0] === "") {
+            re.lastIndex += 1;
+            continue;
+        }
+        yield { value: m[0], index: m.index };
+    }
+}
+function collect(text, pattern, category, out, accept = () => true) {
+    for (const m of matches(text, pattern)) {
+        if (accept(m.value))
+            out.push(finding(category, m.value, m.index));
+    }
+}
+/** Like `collect`, but flags only capture group 1 (the value after a label). */
+function collectGroup(text, pattern, category, out) {
+    const re = new RegExp(pattern.source, pattern.flags.includes("g") ? pattern.flags : `${pattern.flags}g`);
+    let m;
+    while ((m = re.exec(text)) !== null) {
+        const value = m[1];
+        if (!value)
+            continue;
+        const index = m.index + m[0].lastIndexOf(value);
+        out.push(finding(category, value, index));
+    }
+}
+function collectKeywords(text, keywords, category, out) {
+    const lower = text.toLowerCase();
+    for (const keyword of keywords) {
+        let from = 0;
+        for (;;) {
+            const at = lower.indexOf(keyword, from);
+            if (at === -1)
+                break;
+            if (isWordBoundary(lower, at, keyword.length)) {
+                out.push(finding(category, text.slice(at, at + keyword.length), at));
+            }
+            from = at + keyword.length;
+        }
+    }
+}
+function isWordBoundary(text, index, length) {
+    const before = index === 0 ? "" : text[index - 1];
+    const after = text[index + length] ?? "";
+    return !/[a-z0-9]/i.test(before) && !/[a-z0-9]/i.test(after);
+}
+/**
+ * Keeps the highest-priority finding when spans overlap, so a credit card
+ * number is not also reported as a phone number.
+ */
+function dedupe(findings) {
+    const ranked = [...findings].sort((a, b) => {
+        const byPriority = PRIORITY.indexOf(a.category) - PRIORITY.indexOf(b.category);
+        if (byPriority !== 0)
+            return byPriority;
+        return b.match.length - a.match.length;
+    });
+    const kept = [];
+    for (const candidate of ranked) {
+        const start = candidate.index;
+        const end = start + candidate.match.length;
+        const overlaps = kept.some((k) => start < k.index + k.match.length && k.index < end);
+        if (!overlaps)
+            kept.push(candidate);
+    }
+    return kept.sort((a, b) => a.index - b.index);
+}
+/**
+ * Rejects the things that look like phone numbers but aren't: version strings,
+ * dates, plain counts, and anything with too few or too many digits.
+ */
+function looksLikePhone(value) {
+    const digits = value.replace(/\D/g, "");
+    if (digits.length < 7 || digits.length > 15)
+        return false;
+    const trimmed = value.trim();
+    // ISO dates and dotted versions.
+    if (/^\d{4}-\d{2}-\d{2}/.test(trimmed))
+        return false;
+    if (/^\d+(?:\.\d+){2,}$/.test(trimmed))
+        return false;
+    const separators = (trimmed.match(/[\s().-]/g) ?? []).length;
+    const hasCountryCode = trimmed.startsWith("+");
+    // A long unbroken digit run is more likely an id or an amount than a number
+    // someone would dial.
+    if (!hasCountryCode && separators === 0 && digits.length < 9)
+        return false;
+    return true;
+}
+function luhn(digits) {
+    let sum = 0;
+    let double = false;
+    for (let i = digits.length - 1; i >= 0; i -= 1) {
+        let d = digits.charCodeAt(i) - 48;
+        if (d < 0 || d > 9)
+            return false;
+        if (double) {
+            d *= 2;
+            if (d > 9)
+                d -= 9;
+        }
+        sum += d;
+        double = !double;
+    }
+    return sum % 10 === 0;
+}
+//# sourceMappingURL=redact.js.map

package/dist/memory/redact.js.map

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

package/dist/memory/store.d.ts

@@ -0,0 +1,75 @@
+import { Config, MemoryItem, type Confidence, type ImportProvenance, type MemorySource, type Suggestion, type Visibility } from "./types.js";
+/**
+ * Where the store lives. MEMSHARE_DIR wins, so a second identity can run side
+ * by side on one machine -- which is also how the two-person sharing flow is
+ * tested without two laptops.
+ */
+export declare function resolveMemoryDir(): string;
+export declare function expandHome(p: string): string;
+/** Stable identity for a memory's text, used to dedup on import. */
+export declare function contentKey(content: string): string;
+export interface AddInput {
+    content: string;
+    tags?: string[];
+    visibility?: Visibility;
+    confidence?: Confidence;
+    source?: Partial<MemorySource>;
+    expiresAt?: string;
+    id?: string;
+    importedFrom?: ImportProvenance;
+}
+export interface ListFilter {
+    /** Case-insensitive substring match against content and tags. */
+    query?: string;
+    /** An item matches when it carries at least one of these tags. */
+    tags?: string[];
+    visibility?: Visibility;
+    confidence?: Confidence;
+    /** Filter by the adapter that wrote the item: claude, chatgpt, cli, ... */
+    tool?: string;
+    limit?: number;
+    /** Expired items are hidden unless this is set. */
+    includeExpired?: boolean;
+}
+export declare class MemoryStore {
+    readonly root: string;
+    constructor(root?: string);
+    get memoriesDir(): string;
+    get bundlesDir(): string;
+    get configPath(): string;
+    get suggestionsPath(): string;
+    exists(): boolean;
+    /** Creates the directory layout and a config file. Safe to re-run. */
+    init(overrides?: Partial<Config>): Promise<Config>;
+    readConfig(): Promise<Config>;
+    writeConfig(config: Config): Promise<void>;
+    private itemPath;
+    add(input: AddInput): Promise<MemoryItem>;
+    get(id: string): Promise<MemoryItem | undefined>;
+    /** Every item on disk, newest first. Malformed files are skipped, not fatal. */
+    all(): Promise<MemoryItem[]>;
+    list(filter?: ListFilter): Promise<MemoryItem[]>;
+    update(id: string, patch: Partial<Pick<MemoryItem, "content" | "tags" | "visibility" | "expiresAt">>): Promise<MemoryItem | undefined>;
+    remove(id: string): Promise<boolean>;
+    /** Deletes items whose expiresAt has passed. Returns how many went. */
+    pruneExpired(): Promise<number>;
+    listTags(): Promise<string[]>;
+    /** Content keys of every stored item, for import-time dedup. */
+    contentKeys(): Promise<Set<string>>;
+    readSuggestions(): Promise<Suggestion[]>;
+    writeSuggestions(suggestions: Suggestion[]): Promise<void>;
+    addSuggestions(entries: Array<{
+        content: string;
+        tags?: string[];
+    }>, source?: Partial<MemorySource>): Promise<Suggestion[]>;
+    removeSuggestions(ids: string[]): Promise<void>;
+}
+export declare function isExpired(item: MemoryItem, now?: number): boolean;
+export declare function normaliseTags(tags: string[]): string[];
+/** Parses --tags "a,b" (repeatable) into a flat tag list. */
+export declare function parseTagList(value: string | string[] | undefined): string[];
+/** Turns 7d / 12h / 30m, or an ISO date, into an absolute ISO timestamp. */
+export declare function parseDuration(value: string, from?: Date): string;
+/** Write via temp file + rename so a crash can't leave a half-written record. */
+export declare function writeJsonAtomic(file: string, data: unknown): Promise<void>;
+//# sourceMappingURL=store.d.ts.map

package/dist/memory/store.d.ts.map

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