mneme-ai 0.8.3

package/README.md

@@ -0,0 +1,45 @@
+# mneme-ai
+
+The Mneme CLI. **The memory layer of your codebase.**
+
+```bash
+npm install -g mneme-ai
+# or
+npx -y mneme-ai init
+```
+
+## Commands
+
+```bash
+mneme init              # initialize Mneme in the current git repo
+mneme index             # index commits, PRs, embeddings
+mneme ask "question"    # natural-language search over git history
+mneme why <file>:<line> # blame + RAG explanation
+mneme status            # what's indexed
+mneme correlate         # phase 3 — incident correlation
+mneme mcp               # run as an MCP server
+mneme wisdom            # daily meditation from the manifesto
+mneme manifesto         # full canon of meditations
+```
+
+## Connect to Claude Code / Cursor / Continue
+
+```json
+{
+  "mcpServers": {
+    "mneme": {
+      "command": "npx",
+      "args": ["-y", "mneme-ai", "mcp"],
+      "cwd": "/abs/path/to/your/repo"
+    }
+  }
+}
+```
+
+## Full documentation
+
+→ https://github.com/patsa2561-art/mneme-ai
+
+## License
+
+MIT.

package/bin/mneme.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import("../dist/index.js").then((m) => m.run(process.argv));

package/dist/commands/adapt.d.ts

@@ -0,0 +1,6 @@
+export interface AdaptCommandOptions {
+    cwd: string;
+    json?: boolean;
+}
+export declare function adaptCommand(opts: AdaptCommandOptions): Promise<number>;
+//# sourceMappingURL=adapt.d.ts.map

package/dist/commands/adapt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapt.d.ts","sourceRoot":"","sources":["../../src/commands/adapt.ts"],"names":[],"mappings":"AA2BA,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AASD,wBAAsB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoD7E"}

package/dist/commands/adapt.js

@@ -0,0 +1,219 @@
+/**
+ * `mneme adapt` — the *mutant* feature.
+ *
+ * Mneme is honest that it works best with certain repo profiles. `adapt`
+ * inspects the current repo, classifies it, and prints the path of least
+ * resistance for getting value out of Mneme on THIS repo, today.
+ *
+ * Repo profile dimensions:
+ *   • size              (commits)
+ *   • commit-message quality (mean subject length, generic-ratio)
+ *   • PR / issue density
+ *   • language breadth
+ *   • incident corpus
+ *   • entity index status
+ *
+ * Output: an ordered checklist of recommended commands plus a one-line
+ * positioning verdict ("research codebase", "early-stage product",
+ * "mature service", "dormant repo", etc.).
+ *
+ * Mneme is not one tool — it is a kit. `adapt` is how it figures out which
+ * piece to hand you first.
+ */
+import kleur from "kleur";
+import { git, store, util } from "@mneme-ai/core";
+import { dbPath } from "../paths.js";
+import { ui } from "../ui.js";
+export async function adaptCommand(opts) {
+    if (!(await git.isGitRepo(opts.cwd))) {
+        ui.error("Not in a git repo.");
+        ui.dim("Mneme works on any git repo. To start one: `git init && git add . && git commit -m 'initial'`");
+        return 1;
+    }
+    const meta = await git.getRepoMeta(opts.cwd);
+    const s = new store.MnemeStore(dbPath(meta.rootPath));
+    const profile = await buildProfile(opts.cwd, s);
+    s.close();
+    if (opts.json) {
+        process.stdout.write(JSON.stringify(profile, null, 2) + "\n");
+        return 0;
+    }
+    ui.banner();
+    process.stdout.write(`${kleur.bold().cyan("Adapt")}  ${kleur.gray(meta.rootPath)}\n\n`);
+    process.stdout.write(`${kleur.bold().magenta("Archetype")}\n`);
+    process.stdout.write(`  ${kleur.bold(profile.archetype)}\n\n`);
+    process.stdout.write(`${kleur.bold().magenta("Signals")}\n`);
+    for (const [k, v] of Object.entries(profile.signals)) {
+        process.stdout.write(`  ${kleur.gray(k.padEnd(22))} ${v}\n`);
+    }
+    process.stdout.write("\n");
+    if (profile.warnings.length) {
+        process.stdout.write(`${kleur.bold().yellow("Honest caveats")}\n`);
+        for (const w of profile.warnings) {
+            process.stdout.write(`  ${kleur.yellow("!")} ${w}\n`);
+        }
+        process.stdout.write("\n");
+    }
+    process.stdout.write(`${kleur.bold().magenta("Recommended next commands")}\n`);
+    if (profile.recommendations.length === 0) {
+        process.stdout.write(`  ${kleur.green("●")} you're set. Mneme has nothing to add right now.\n`);
+    }
+    else {
+        for (let i = 0; i < profile.recommendations.length; i++) {
+            const r = profile.recommendations[i];
+            process.stdout.write(`  ${kleur.green(`${i + 1}.`)} ${kleur.bold(r.command)}\n` +
+                `      ${kleur.gray(r.reason)}\n`);
+        }
+    }
+    process.stdout.write("\n" + kleur.gray("  Adapt is deterministic — same repo state → same output. Re-run anytime.") + "\n");
+    return 0;
+}
+async function buildProfile(cwd, s) {
+    const recommendations = [];
+    const warnings = [];
+    const signals = {};
+    // 1. Are there commits in the working repo (not in store)?
+    const totalCommitsRaw = await git.execGit(["rev-list", "--all", "--count"], { cwd });
+    const totalCommits = totalCommitsRaw.code === 0 ? Number(totalCommitsRaw.stdout.trim()) : 0;
+    signals["commits in repo"] = totalCommits;
+    // 2. Index status
+    const indexedCommits = s.countCommits();
+    const indexedChunks = s.countChunks();
+    const indexedEntities = s.countEntities();
+    const indexedIncidents = s.db.prepare("SELECT COUNT(*) AS n FROM incidents").get();
+    const correlationCount = s.db.prepare("SELECT COUNT(*) AS n FROM correlations").get();
+    const synthesizedCount = s.countSynthesizedNotes();
+    signals["commits indexed"] = indexedCommits;
+    signals["entities indexed"] = indexedEntities;
+    signals["incidents indexed"] = indexedIncidents.n;
+    signals["correlations stored"] = correlationCount.n;
+    signals["synthesized notes"] = synthesizedCount;
+    // 3. Commit-message quality (sample first 200 indexed)
+    let avgSubjectLen = 0;
+    let genericRatio = 0;
+    let prRatio = 0;
+    if (indexedCommits > 0) {
+        const sample = util.loadAllCommits(s).slice(-200);
+        const subs = sample.map((c) => c.subject.trim());
+        avgSubjectLen = Math.round(subs.reduce((a, b) => a + b.length, 0) / subs.length);
+        const genericRe = /^(?:wip|update[sd]?|fix|fixed|fixes|tweak|misc|stuff|adjust|chore|cleanup|refactor)\.?$/i;
+        genericRatio = subs.filter((x) => genericRe.test(x)).length / subs.length;
+        prRatio = sample.filter((c) => c.prNumber).length / sample.length;
+    }
+    if (indexedCommits > 0) {
+        signals["avg subject length"] = avgSubjectLen;
+        signals["generic-msg ratio"] = (genericRatio * 100).toFixed(0) + "%";
+        signals["PR-tagged ratio"] = (prRatio * 100).toFixed(0) + "%";
+    }
+    // 4. Decide archetype + recommendations.
+    // Path 0: not initialized at all.
+    if (indexedCommits === 0) {
+        if (totalCommits === 0) {
+            return {
+                archetype: "Empty repo (no commits yet)",
+                signals,
+                recommendations: [
+                    { command: "make a few commits with real messages", reason: "Mneme needs history to be useful." },
+                    { command: "mneme init && mneme index", reason: "Run after you have ≥10 commits." },
+                ],
+                warnings: [
+                    "Brand-new repos have no signal. Wait for ≥50 commits before judging Mneme's quality.",
+                ],
+            };
+        }
+        return {
+            archetype: "Indexed-not-yet repo",
+            signals,
+            recommendations: [
+                { command: "mneme init", reason: "Set up the local store." },
+                { command: "mneme index", reason: `Index the ${totalCommits} existing commits — this is the foundation.` },
+            ],
+            warnings: [],
+        };
+    }
+    // Path 1: tiny repo
+    if (indexedCommits < 30) {
+        warnings.push(`Only ${indexedCommits} commits indexed — Mneme's value compounds with history. Treat results as preview-quality.`);
+    }
+    // Path 2: poor commit messages.
+    if (genericRatio > 0.4 || avgSubjectLen < 25) {
+        recommendations.push({
+            command: "mneme heal",
+            reason: `${(genericRatio * 100).toFixed(0)}% of recent commit subjects are generic ("wip"/"fix"/"updated"). Heal synthesizes a WHY note from the diff so search can answer.`,
+        });
+    }
+    // Path 3: no Phase-2 entities yet.
+    if (indexedEntities === 0) {
+        recommendations.push({
+            command: "mneme entities",
+            reason: "No entity-level memory yet. Required before `mneme clones`, `mneme teach`, and richer answers about WHAT the code does.",
+        });
+    }
+    else {
+        recommendations.push({
+            command: "mneme clones --threshold 0.85",
+            reason: `${indexedEntities} entities indexed — surface near-duplicate functions ripe for refactor.`,
+        });
+    }
+    // Path 4: no incidents — recommend the manual path or pager.
+    if (indexedIncidents.n === 0) {
+        recommendations.push({
+            command: "mneme correlate --source manual --file ./incidents.json",
+            reason: "No incidents indexed. Even a small JSON list unlocks blast radius + conscience scoring.",
+        });
+    }
+    else if (correlationCount.n === 0) {
+        recommendations.push({
+            command: "mneme correlate --source pager --org X --project Y",
+            reason: `${indexedIncidents.n} incidents but 0 correlations — re-run correlate so the engine writes edges to the store.`,
+        });
+    }
+    // Path 5: lots of correlations — push viz + conscience + palimpsest.
+    if (correlationCount.n > 5) {
+        recommendations.push({
+            command: "mneme web",
+            reason: `${correlationCount.n} correlations — the temporal graph view becomes useful at this density.`,
+        });
+        recommendations.push({
+            command: "mneme conscience <changed-files>",
+            reason: "Use the historical graph as a pre-merge advisor for your next PR.",
+        });
+    }
+    // Path 6: solo project with no PR data — encourage GitHub PR fetcher.
+    if (prRatio < 0.05 && indexedCommits >= 50) {
+        recommendations.push({
+            command: "set GITHUB_TOKEN, then re-run `mneme index`",
+            reason: "No PR signal in commits. With a token, Mneme hydrates each commit with PR/issue body — the single biggest accuracy gain.",
+        });
+    }
+    // Path 7: mature repo — onboarding angle.
+    if (indexedCommits >= 200) {
+        recommendations.push({
+            command: "mneme mirror",
+            reason: "Mature codebase. Use the onboarding dossier when a new contributor joins.",
+        });
+    }
+    // Determine archetype.
+    let archetype = "Engineering codebase";
+    if (indexedCommits >= 1000)
+        archetype = "Mature, large codebase";
+    else if (indexedCommits >= 200)
+        archetype = "Active service / library";
+    else if (indexedCommits >= 50)
+        archetype = "Early-stage product";
+    else
+        archetype = "Young / personal repo";
+    if (genericRatio > 0.5)
+        archetype += " — sparse commit hygiene";
+    if (prRatio > 0.5)
+        archetype += " — PR-driven workflow";
+    if (correlationCount.n > 5)
+        archetype += " — incident-correlated";
+    return {
+        archetype,
+        signals,
+        recommendations,
+        warnings,
+    };
+}
+//# sourceMappingURL=adapt.js.map

package/dist/commands/adapt.js.map

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

package/dist/commands/ask.d.ts

@@ -0,0 +1,8 @@
+export interface AskCommandOptions {
+    cwd: string;
+    question: string;
+    topK?: number;
+    json?: boolean;
+}
+export declare function askCommand(opts: AskCommandOptions): Promise<number>;
+//# sourceMappingURL=ask.d.ts.map

package/dist/commands/ask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask.d.ts","sourceRoot":"","sources":["../../src/commands/ask.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqCzE"}

package/dist/commands/ask.js

@@ -0,0 +1,76 @@
+import { git, retrieve, store } from "@mneme-ai/core";
+import { resolveEmbedder } from "@mneme-ai/embeddings";
+import { dbPath } from "../paths.js";
+import { readConfig } from "../config.js";
+import { ui } from "../ui.js";
+import kleur from "kleur";
+export async function askCommand(opts) {
+    if (!(await git.isGitRepo(opts.cwd))) {
+        ui.error("Not in a git repo. Run `mneme init` first.");
+        return 1;
+    }
+    const meta = await git.getRepoMeta(opts.cwd);
+    const cfg = readConfig(meta.rootPath);
+    const s = new store.MnemeStore(dbPath(meta.rootPath));
+    if (s.countCommits() === 0) {
+        ui.error("Memory is empty. Run `mneme index` first.");
+        s.close();
+        return 1;
+    }
+    const embedder = await resolveEmbedder({
+        provider: cfg.embeddings.provider,
+        model: cfg.embeddings.model,
+        baseUrl: cfg.embeddings.baseUrl,
+    });
+    const result = await retrieve.ask(opts.question, {
+        store: s,
+        embedder,
+        repo: meta,
+        topK: opts.topK ?? 8,
+    });
+    s.close();
+    if (opts.json) {
+        process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+        return 0;
+    }
+    printAskResult(result);
+    return 0;
+}
+function printAskResult(r) {
+    ui.banner();
+    process.stdout.write(`${kleur.bold().cyan("Q")} ${r.question}\n\n`);
+    process.stdout.write(`${kleur.bold().magenta("Summary")}\n${r.summary}\n\n`);
+    if (!r.searchResults.length)
+        return;
+    process.stdout.write(`${kleur.bold().magenta("Evidence")}\n`);
+    for (const sr of r.searchResults.slice(0, 6)) {
+        const c = sr.commit;
+        const date = c.authorDate.slice(0, 10);
+        const ref = c.prNumber ? `PR #${c.prNumber}` : c.shortHash;
+        const score = sr.score.toFixed(3);
+        process.stdout.write(`  ${kleur.green("●")} ${kleur.bold(ref)}  ${kleur.gray(`[${date} · ${c.authorName} · ${score}]`)}\n`);
+        process.stdout.write(`    ${kleur.white(c.subject)}\n`);
+        if (c.body) {
+            const firstLine = c.body.split("\n")[0].trim();
+            if (firstLine)
+                process.stdout.write(`    ${kleur.gray(truncate(firstLine, 120))}\n`);
+        }
+        if (c.files.length) {
+            const files = c.files.slice(0, 3).join(", ");
+            const more = c.files.length > 3 ? ` (+${c.files.length - 3})` : "";
+            process.stdout.write(`    ${kleur.cyan("files:")} ${kleur.gray(files + more)}\n`);
+        }
+        process.stdout.write("\n");
+    }
+    if (r.citations.some((c) => c.url)) {
+        process.stdout.write(`${kleur.bold().magenta("Citations")}\n`);
+        for (const c of r.citations) {
+            if (c.url)
+                process.stdout.write(`  ${kleur.gray("→")} ${c.url}\n`);
+        }
+    }
+}
+function truncate(s, n) {
+    return s.length <= n ? s : s.slice(0, n - 1) + "…";
+}
+//# sourceMappingURL=ask.js.map

package/dist/commands/ask.js.map

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

package/dist/commands/blast.d.ts

@@ -0,0 +1,8 @@
+export interface BlastCommandOptions {
+    cwd: string;
+    commit: string;
+    windowHours?: number;
+    json?: boolean;
+}
+export declare function blastCommand(opts: BlastCommandOptions): Promise<number>;
+//# sourceMappingURL=blast.d.ts.map

package/dist/commands/blast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blast.d.ts","sourceRoot":"","sources":["../../src/commands/blast.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyG7E"}

package/dist/commands/blast.js

@@ -0,0 +1,132 @@
+/**
+ * `mneme blast <commit>` — predict what's at risk if this commit ships.
+ *
+ * Inverts the `correlate` engine direction: instead of "given an incident,
+ * which commits are likely the cause", we ask "given a commit, which past
+ * incidents share its file footprint, and what's the historical base-rate
+ * of incidents on the same files within the next 48 h?"
+ *
+ * Useful as a pre-merge gate (CI hook) or as a `git push` advisory.
+ */
+import kleur from "kleur";
+import { git, store } from "@mneme-ai/core";
+import { dbPath } from "../paths.js";
+import { ui } from "../ui.js";
+export async function blastCommand(opts) {
+    if (!(await git.isGitRepo(opts.cwd))) {
+        ui.error("Not in a git repo. Run `mneme init` first.");
+        return 1;
+    }
+    const meta = await git.getRepoMeta(opts.cwd);
+    const s = new store.MnemeStore(dbPath(meta.rootPath));
+    // Resolve commit (accept short or long hash, or HEAD).
+    const target = await resolveCommit(opts.cwd, opts.commit);
+    if (!target) {
+        ui.error(`Could not resolve commit "${opts.commit}".`);
+        s.close();
+        return 1;
+    }
+    const commit = s.getCommit(target);
+    if (!commit) {
+        ui.error(`Commit ${target.slice(0, 8)} is not indexed. Run \`mneme index\`.`);
+        s.close();
+        return 1;
+    }
+    // Look up every past incident whose affected_files overlaps with this commit's files.
+    const allIncidents = loadAllIncidents(s);
+    const commitFiles = new Set(commit.files.map(normalizePath));
+    const matches = [];
+    for (const inc of allIncidents) {
+        const incFiles = new Set([...(inc.affectedFiles ?? [])].map(normalizePath));
+        const overlap = [...commitFiles].filter((f) => incFiles.has(f));
+        if (overlap.length > 0)
+            matches.push({ incident: inc, overlapFiles: overlap });
+    }
+    // Compute base-rate: of all PAST commits touching ANY file this commit touches,
+    // what fraction had an incident-correlation within `windowHours`?
+    const windowHours = opts.windowHours ?? 48;
+    const filesArray = Array.from(commitFiles);
+    let totalPriors = 0;
+    let triggeringPriors = 0;
+    if (filesArray.length > 0) {
+        const placeholders = filesArray.map(() => "?").join(",");
+        const priorRows = s.db
+            .prepare(`SELECT DISTINCT commit_hash FROM file_changes WHERE LOWER(REPLACE(path, '\\', '/')) IN (${placeholders})`)
+            .all(...filesArray);
+        totalPriors = priorRows.length;
+        if (totalPriors > 0) {
+            const corrRows = s.db
+                .prepare(`SELECT DISTINCT from_id FROM correlations
+           WHERE from_kind = 'commit' AND to_kind = 'incident' AND from_id IN (${priorRows.map(() => "?").join(",")})`)
+                .all(...priorRows.map((r) => r.commit_hash));
+            triggeringPriors = corrRows.length;
+        }
+    }
+    const baseRate = totalPriors === 0 ? 0 : triggeringPriors / totalPriors;
+    const verdict = baseRate >= 0.3 ? "HIGH" : baseRate >= 0.1 ? "MED" : "LOW";
+    if (opts.json) {
+        process.stdout.write(JSON.stringify({
+            commit: commit.shortHash,
+            windowHours,
+            baseRate,
+            verdict,
+            totalPriors,
+            triggeringPriors,
+            fileMatches: matches,
+        }, null, 2) + "\n");
+        s.close();
+        return 0;
+    }
+    ui.banner();
+    process.stdout.write(`${kleur.bold().cyan("Blast radius")}  ${commit.shortHash}  ${kleur.gray(`${commit.subject.slice(0, 60)}`)}\n\n`);
+    process.stdout.write(`  ${kleur.bold("files changed")}: ${commit.files.length}\n`);
+    process.stdout.write(`  ${kleur.bold("historical base rate")}: ${(baseRate * 100).toFixed(1)}%  ` +
+        `${kleur.gray(`(${triggeringPriors} of ${totalPriors} prior commits on these files triggered an incident within ${windowHours}h)`)}\n`);
+    const color = verdict === "HIGH" ? kleur.red : verdict === "MED" ? kleur.yellow : kleur.green;
+    process.stdout.write(`  ${kleur.bold("verdict")}: ${color(verdict)}\n\n`);
+    if (matches.length === 0) {
+        ui.success("No past incidents share files with this commit.");
+    }
+    else {
+        process.stdout.write(`${kleur.bold().magenta("Past incidents on overlapping files")}\n`);
+        for (const m of matches.slice(0, 10)) {
+            const date = m.incident.occurredAt.slice(0, 10);
+            process.stdout.write(`  ${kleur.red("●")} ${kleur.bold(m.incident.id)}  ${kleur.gray(`[${date} · ${m.incident.severity}]`)}\n` +
+                `    ${kleur.white(m.incident.title)}\n` +
+                `    ${kleur.gray(`overlap: ${m.overlapFiles.slice(0, 3).join(", ")}${m.overlapFiles.length > 3 ? " (+more)" : ""}`)}\n`);
+        }
+        if (matches.length > 10) {
+            process.stdout.write(kleur.gray(`  …and ${matches.length - 10} more\n`));
+        }
+    }
+    s.close();
+    return 0;
+}
+async function resolveCommit(cwd, ref) {
+    const r = await git.execGit(["rev-parse", ref], { cwd });
+    if (r.code !== 0)
+        return null;
+    return r.stdout.trim();
+}
+function loadAllIncidents(s) {
+    const rows = s.db
+        .prepare("SELECT * FROM incidents ORDER BY occurred_at DESC")
+        .all();
+    return rows.map((r) => ({
+        id: String(r.id),
+        source: r.source,
+        externalId: r.external_id ? String(r.external_id) : undefined,
+        title: String(r.title),
+        occurredAt: String(r.occurred_at),
+        resolvedAt: r.resolved_at ? String(r.resolved_at) : undefined,
+        severity: r.severity,
+        affectedFiles: r.affected_files ? JSON.parse(String(r.affected_files)) : undefined,
+        stackFrames: r.stack_frames ? JSON.parse(String(r.stack_frames)) : undefined,
+        url: r.url ? String(r.url) : undefined,
+        metadata: r.metadata ? JSON.parse(String(r.metadata)) : undefined,
+    }));
+}
+function normalizePath(p) {
+    return p.replace(/\\/g, "/").replace(/^\.\//, "").toLowerCase();
+}
+//# sourceMappingURL=blast.js.map

package/dist/commands/blast.js.map

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

package/dist/commands/clones.d.ts

@@ -0,0 +1,19 @@
+export interface IndexEntitiesOptions {
+    cwd: string;
+    embedBatchSize?: number;
+}
+/**
+ * `mneme entities` — parse repo, embed, persist.
+ */
+export declare function entitiesCommand(opts: IndexEntitiesOptions): Promise<number>;
+export interface ClonesCommandOptions {
+    cwd: string;
+    threshold?: number;
+    topN?: number;
+    json?: boolean;
+}
+/**
+ * `mneme clones` — detect semantic clones from indexed entities.
+ */
+export declare function clonesCommand(opts: ClonesCommandOptions): Promise<number>;
+//# sourceMappingURL=clones.d.ts.map

package/dist/commands/clones.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clones.d.ts","sourceRoot":"","sources":["../../src/commands/clones.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuGjF;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2D/E"}