@mneme-ai/core 0.8.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (142) hide show
  1. package/README.md +31 -0
  2. package/dist/correlate/index.d.ts +44 -0
  3. package/dist/correlate/index.d.ts.map +1 -0
  4. package/dist/correlate/index.js +21 -0
  5. package/dist/correlate/index.js.map +1 -0
  6. package/dist/enrich/index.d.ts +35 -0
  7. package/dist/enrich/index.d.ts.map +1 -0
  8. package/dist/enrich/index.js +69 -0
  9. package/dist/enrich/index.js.map +1 -0
  10. package/dist/entities/cosine-clones.d.ts +6 -0
  11. package/dist/entities/cosine-clones.d.ts.map +1 -0
  12. package/dist/entities/cosine-clones.js +142 -0
  13. package/dist/entities/cosine-clones.js.map +1 -0
  14. package/dist/entities/cosine-clones.test.d.ts +2 -0
  15. package/dist/entities/cosine-clones.test.d.ts.map +1 -0
  16. package/dist/entities/cosine-clones.test.js +109 -0
  17. package/dist/entities/cosine-clones.test.js.map +1 -0
  18. package/dist/entities/index.d.ts +74 -0
  19. package/dist/entities/index.d.ts.map +1 -0
  20. package/dist/entities/index.js +24 -0
  21. package/dist/entities/index.js.map +1 -0
  22. package/dist/entities/python-parser.d.ts +16 -0
  23. package/dist/entities/python-parser.d.ts.map +1 -0
  24. package/dist/entities/python-parser.js +248 -0
  25. package/dist/entities/python-parser.js.map +1 -0
  26. package/dist/entities/typescript-parser.d.ts +18 -0
  27. package/dist/entities/typescript-parser.d.ts.map +1 -0
  28. package/dist/entities/typescript-parser.js +220 -0
  29. package/dist/entities/typescript-parser.js.map +1 -0
  30. package/dist/entities/typescript-parser.test.d.ts +2 -0
  31. package/dist/entities/typescript-parser.test.d.ts.map +1 -0
  32. package/dist/entities/typescript-parser.test.js +103 -0
  33. package/dist/entities/typescript-parser.test.js.map +1 -0
  34. package/dist/git/blame.d.ts +9 -0
  35. package/dist/git/blame.d.ts.map +1 -0
  36. package/dist/git/blame.js +56 -0
  37. package/dist/git/blame.js.map +1 -0
  38. package/dist/git/exec.d.ts +13 -0
  39. package/dist/git/exec.d.ts.map +1 -0
  40. package/dist/git/exec.js +40 -0
  41. package/dist/git/exec.js.map +1 -0
  42. package/dist/git/github.d.ts +62 -0
  43. package/dist/git/github.d.ts.map +1 -0
  44. package/dist/git/github.js +115 -0
  45. package/dist/git/github.js.map +1 -0
  46. package/dist/git/github.test.d.ts +2 -0
  47. package/dist/git/github.test.d.ts.map +1 -0
  48. package/dist/git/github.test.js +86 -0
  49. package/dist/git/github.test.js.map +1 -0
  50. package/dist/git/gitlab.d.ts +66 -0
  51. package/dist/git/gitlab.d.ts.map +1 -0
  52. package/dist/git/gitlab.js +121 -0
  53. package/dist/git/gitlab.js.map +1 -0
  54. package/dist/git/gitlab.test.d.ts +2 -0
  55. package/dist/git/gitlab.test.d.ts.map +1 -0
  56. package/dist/git/gitlab.test.js +122 -0
  57. package/dist/git/gitlab.test.js.map +1 -0
  58. package/dist/git/index.d.ts +7 -0
  59. package/dist/git/index.d.ts.map +1 -0
  60. package/dist/git/index.js +7 -0
  61. package/dist/git/index.js.map +1 -0
  62. package/dist/git/log.d.ts +11 -0
  63. package/dist/git/log.d.ts.map +1 -0
  64. package/dist/git/log.js +107 -0
  65. package/dist/git/log.js.map +1 -0
  66. package/dist/git/log.test.d.ts +2 -0
  67. package/dist/git/log.test.d.ts.map +1 -0
  68. package/dist/git/log.test.js +88 -0
  69. package/dist/git/log.test.js.map +1 -0
  70. package/dist/git/repo.d.ts +12 -0
  71. package/dist/git/repo.d.ts.map +1 -0
  72. package/dist/git/repo.js +50 -0
  73. package/dist/git/repo.js.map +1 -0
  74. package/dist/git/repo.test.d.ts +2 -0
  75. package/dist/git/repo.test.d.ts.map +1 -0
  76. package/dist/git/repo.test.js +35 -0
  77. package/dist/git/repo.test.js.map +1 -0
  78. package/dist/index.d.ts +10 -0
  79. package/dist/index.d.ts.map +1 -0
  80. package/dist/index.js +10 -0
  81. package/dist/index.js.map +1 -0
  82. package/dist/indexer/index.d.ts +2 -0
  83. package/dist/indexer/index.d.ts.map +1 -0
  84. package/dist/indexer/index.js +2 -0
  85. package/dist/indexer/index.js.map +1 -0
  86. package/dist/indexer/indexer.d.ts +22 -0
  87. package/dist/indexer/indexer.d.ts.map +1 -0
  88. package/dist/indexer/indexer.js +107 -0
  89. package/dist/indexer/indexer.js.map +1 -0
  90. package/dist/indexer/indexer.test.d.ts +2 -0
  91. package/dist/indexer/indexer.test.d.ts.map +1 -0
  92. package/dist/indexer/indexer.test.js +80 -0
  93. package/dist/indexer/indexer.test.js.map +1 -0
  94. package/dist/retrieve/index.d.ts +3 -0
  95. package/dist/retrieve/index.d.ts.map +1 -0
  96. package/dist/retrieve/index.js +3 -0
  97. package/dist/retrieve/index.js.map +1 -0
  98. package/dist/retrieve/rerank.d.ts +44 -0
  99. package/dist/retrieve/rerank.d.ts.map +1 -0
  100. package/dist/retrieve/rerank.js +68 -0
  101. package/dist/retrieve/rerank.js.map +1 -0
  102. package/dist/retrieve/rerank.test.d.ts +2 -0
  103. package/dist/retrieve/rerank.test.d.ts.map +1 -0
  104. package/dist/retrieve/rerank.test.js +52 -0
  105. package/dist/retrieve/rerank.test.js.map +1 -0
  106. package/dist/retrieve/search.d.ts +31 -0
  107. package/dist/retrieve/search.d.ts.map +1 -0
  108. package/dist/retrieve/search.js +170 -0
  109. package/dist/retrieve/search.js.map +1 -0
  110. package/dist/retrieve/search.test.d.ts +2 -0
  111. package/dist/retrieve/search.test.d.ts.map +1 -0
  112. package/dist/retrieve/search.test.js +105 -0
  113. package/dist/retrieve/search.test.js.map +1 -0
  114. package/dist/store/index.d.ts +3 -0
  115. package/dist/store/index.d.ts.map +1 -0
  116. package/dist/store/index.js +3 -0
  117. package/dist/store/index.js.map +1 -0
  118. package/dist/store/schema.d.ts +11 -0
  119. package/dist/store/schema.d.ts.map +1 -0
  120. package/dist/store/schema.js +129 -0
  121. package/dist/store/schema.js.map +1 -0
  122. package/dist/store/sqlite.d.ts +51 -0
  123. package/dist/store/sqlite.d.ts.map +1 -0
  124. package/dist/store/sqlite.js +262 -0
  125. package/dist/store/sqlite.js.map +1 -0
  126. package/dist/store/sqlite.test.d.ts +2 -0
  127. package/dist/store/sqlite.test.d.ts.map +1 -0
  128. package/dist/store/sqlite.test.js +128 -0
  129. package/dist/store/sqlite.test.js.map +1 -0
  130. package/dist/types.d.ts +115 -0
  131. package/dist/types.d.ts.map +1 -0
  132. package/dist/types.js +6 -0
  133. package/dist/types.js.map +1 -0
  134. package/dist/util/index.d.ts +15 -0
  135. package/dist/util/index.d.ts.map +1 -0
  136. package/dist/util/index.js +65 -0
  137. package/dist/util/index.js.map +1 -0
  138. package/dist/util/index.test.d.ts +2 -0
  139. package/dist/util/index.test.d.ts.map +1 -0
  140. package/dist/util/index.test.js +37 -0
  141. package/dist/util/index.test.js.map +1 -0
  142. package/package.json +62 -0
@@ -0,0 +1,128 @@
1
+ import { describe, it, expect, beforeEach, afterEach } from "vitest";
2
+ import { mkdtempSync, rmSync } from "node:fs";
3
+ import { join } from "node:path";
4
+ import { tmpdir } from "node:os";
5
+ import { MnemeStore } from "./sqlite.js";
6
+ let tmpDir;
7
+ let store;
8
+ beforeEach(() => {
9
+ tmpDir = mkdtempSync(join(tmpdir(), "mneme-test-"));
10
+ store = new MnemeStore(join(tmpDir, "mneme.db"));
11
+ });
12
+ afterEach(() => {
13
+ store.close();
14
+ rmSync(tmpDir, { recursive: true, force: true });
15
+ });
16
+ const sampleCommit = (over = {}) => ({
17
+ hash: "a".repeat(40),
18
+ shortHash: "aaaaaaa",
19
+ authorName: "Alice",
20
+ authorEmail: "a@x.io",
21
+ authorDate: "2025-01-01T00:00:00Z",
22
+ committerDate: "2025-01-01T00:00:00Z",
23
+ subject: "first commit",
24
+ body: "the body",
25
+ parents: [],
26
+ files: ["src/foo.ts"],
27
+ prNumber: 42,
28
+ prTitle: "Add foo",
29
+ prBody: "fixes the foo bug",
30
+ issueRefs: ["GH-1"],
31
+ ...over,
32
+ });
33
+ describe("MnemeStore — schema + roundtrip", () => {
34
+ it("initializes with schema_version meta key", () => {
35
+ expect(store.getMeta("schema_version")).toBe("1");
36
+ });
37
+ it("upserts and retrieves a commit losslessly", () => {
38
+ const c = sampleCommit();
39
+ store.upsertCommits([c]);
40
+ store.upsertFileChanges([
41
+ { commitHash: c.hash, path: "src/foo.ts", changeKind: "M", insertions: 5, deletions: 2 },
42
+ ]);
43
+ const got = store.getCommit(c.hash);
44
+ expect(got).toBeDefined();
45
+ expect(got.subject).toBe(c.subject);
46
+ expect(got.prNumber).toBe(42);
47
+ expect(got.issueRefs).toEqual(["GH-1"]);
48
+ expect(got.files).toEqual(["src/foo.ts"]);
49
+ });
50
+ it("upsert is idempotent", () => {
51
+ const c = sampleCommit();
52
+ store.upsertCommits([c, c, c]);
53
+ expect(store.countCommits()).toBe(1);
54
+ });
55
+ it("counts chunks correctly", () => {
56
+ const c = sampleCommit();
57
+ store.upsertCommits([c]);
58
+ const chunks = [
59
+ { id: "1", commitHash: c.hash, kind: "subject", text: "alpha bravo" },
60
+ { id: "2", commitHash: c.hash, kind: "body", text: "charlie delta" },
61
+ ];
62
+ store.upsertChunks(chunks);
63
+ expect(store.countChunks()).toBe(2);
64
+ expect(store.countChunksWithEmbedding()).toBe(0);
65
+ });
66
+ it("roundtrips Float32 embeddings", () => {
67
+ const c = sampleCommit();
68
+ store.upsertCommits([c]);
69
+ const vec = Float32Array.from([0.1, -0.2, 0.3, 0.4]);
70
+ store.upsertChunks([{ id: "1", commitHash: c.hash, kind: "subject", text: "hi", embedding: vec }], "test-model");
71
+ expect(store.countChunksWithEmbedding()).toBe(1);
72
+ const all = Array.from(store.iterEmbeddedChunks());
73
+ expect(all).toHaveLength(1);
74
+ expect(Array.from(all[0].vec)).toEqual(Array.from(vec));
75
+ });
76
+ it("FTS search returns chunks containing query terms", () => {
77
+ const c = sampleCommit();
78
+ store.upsertCommits([c]);
79
+ store.upsertChunks([
80
+ { id: "1", commitHash: c.hash, kind: "subject", text: "fix stripe webhook crash" },
81
+ { id: "2", commitHash: c.hash, kind: "body", text: "totally unrelated topic" },
82
+ ]);
83
+ const hits = store.ftsSearch("stripe webhook", 10);
84
+ expect(hits.length).toBeGreaterThan(0);
85
+ expect(hits[0].id).toBe("1");
86
+ });
87
+ it("FTS sanitizes user input (no SQL syntax injection)", () => {
88
+ const c = sampleCommit();
89
+ store.upsertCommits([c]);
90
+ store.upsertChunks([
91
+ { id: "1", commitHash: c.hash, kind: "subject", text: "alpha" },
92
+ ]);
93
+ expect(() => store.ftsSearch('"; DROP TABLE chunks; --', 10)).not.toThrow();
94
+ });
95
+ it("stores and retrieves incidents", () => {
96
+ const inc = {
97
+ id: "INC-1",
98
+ source: "manual",
99
+ title: "Stripe webhook 500",
100
+ occurredAt: "2025-01-15T10:00:00Z",
101
+ severity: "error",
102
+ affectedFiles: ["src/foo.ts"],
103
+ };
104
+ store.upsertIncidents([inc]);
105
+ const row = store.db.prepare("SELECT * FROM incidents WHERE id = ?").get("INC-1");
106
+ expect(row).toBeDefined();
107
+ expect(row.title).toBe("Stripe webhook 500");
108
+ expect(JSON.parse(row.affected_files)).toEqual(["src/foo.ts"]);
109
+ });
110
+ it("stores correlations with weight + reason", () => {
111
+ store.upsertCorrelations([
112
+ {
113
+ id: "C1",
114
+ fromKind: "commit",
115
+ fromId: "abc",
116
+ toKind: "incident",
117
+ toId: "INC-1",
118
+ weight: 0.82,
119
+ reason: "file overlap + temporal",
120
+ evidence: ["abc", "INC-1"],
121
+ },
122
+ ]);
123
+ const row = store.db.prepare("SELECT * FROM correlations WHERE id = ?").get("C1");
124
+ expect(row.weight).toBeCloseTo(0.82, 6);
125
+ expect(JSON.parse(row.evidence)).toEqual(["abc", "INC-1"]);
126
+ });
127
+ });
128
+ //# sourceMappingURL=sqlite.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sqlite.test.js","sourceRoot":"","sources":["../../src/store/sqlite.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,115 @@
1
+ /**
2
+ * Core types for GitWisdom.
3
+ * Designed so phase 1 (archaeology) and phase 3 (error correlation) share one schema.
4
+ */
5
+ export interface Commit {
6
+ hash: string;
7
+ shortHash: string;
8
+ authorName: string;
9
+ authorEmail: string;
10
+ authorDate: string;
11
+ committerDate: string;
12
+ subject: string;
13
+ body: string;
14
+ files: string[];
15
+ parents: string[];
16
+ prNumber?: number;
17
+ prTitle?: string;
18
+ prBody?: string;
19
+ issueRefs?: string[];
20
+ }
21
+ export interface FileChange {
22
+ commitHash: string;
23
+ path: string;
24
+ changeKind: "A" | "M" | "D" | "R" | "C";
25
+ insertions: number;
26
+ deletions: number;
27
+ renamedFrom?: string;
28
+ }
29
+ export interface Entity {
30
+ id: string;
31
+ kind: "function" | "class" | "variable" | "module" | "type";
32
+ name: string;
33
+ filePath: string;
34
+ startLine: number;
35
+ endLine: number;
36
+ signature?: string;
37
+ language: string;
38
+ /** Optional vector embedding (Phase 2). */
39
+ embedding?: Float32Array;
40
+ }
41
+ export interface CommitChunk {
42
+ id: string;
43
+ commitHash: string;
44
+ text: string;
45
+ kind: "subject" | "body" | "pr_title" | "pr_body" | "diff_hunk" | "synthesized";
46
+ embedding?: Float32Array;
47
+ }
48
+ export type IncidentSource = "sentry" | "datadog" | "manual" | "github" | "log";
49
+ export interface Incident {
50
+ id: string;
51
+ source: IncidentSource;
52
+ externalId?: string;
53
+ title: string;
54
+ occurredAt: string;
55
+ resolvedAt?: string;
56
+ severity: "info" | "warning" | "error" | "critical";
57
+ affectedFiles?: string[];
58
+ stackFrames?: StackFrame[];
59
+ url?: string;
60
+ metadata?: Record<string, unknown>;
61
+ }
62
+ export interface StackFrame {
63
+ file: string;
64
+ line: number;
65
+ function?: string;
66
+ module?: string;
67
+ }
68
+ export interface Correlation {
69
+ id: string;
70
+ fromKind: "commit" | "incident" | "entity";
71
+ fromId: string;
72
+ toKind: "commit" | "incident" | "entity";
73
+ toId: string;
74
+ weight: number;
75
+ reason: string;
76
+ evidence: string[];
77
+ }
78
+ export interface SearchResult {
79
+ commit: Commit;
80
+ score: number;
81
+ matchedChunks: CommitChunk[];
82
+ }
83
+ export interface AskResult {
84
+ question: string;
85
+ summary: string;
86
+ citations: Citation[];
87
+ searchResults: SearchResult[];
88
+ }
89
+ export interface Citation {
90
+ kind: "commit" | "pr" | "issue";
91
+ id: string;
92
+ title: string;
93
+ url?: string;
94
+ excerpt: string;
95
+ }
96
+ export interface IndexerProgress {
97
+ phase: "git_log" | "pr_fetch" | "embedding" | "writing" | "done";
98
+ current: number;
99
+ total: number;
100
+ message?: string;
101
+ }
102
+ export interface EmbeddingProvider {
103
+ readonly name: string;
104
+ readonly dimensions: number;
105
+ embed(texts: string[]): Promise<Float32Array[]>;
106
+ }
107
+ export interface RepoMeta {
108
+ rootPath: string;
109
+ defaultBranch: string;
110
+ remoteUrl?: string;
111
+ host?: "github" | "gitlab" | "bitbucket" | "other";
112
+ owner?: string;
113
+ repo?: string;
114
+ }
115
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
package/dist/types.js ADDED
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Core types for GitWisdom.
3
+ * Designed so phase 1 (archaeology) and phase 3 (error correlation) share one schema.
4
+ */
5
+ export {};
6
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Small shared helpers used across CLI command implementations.
3
+ * Keeping them here avoids duplication between heal/correlate/echo/etc.
4
+ */
5
+ import type { Commit } from "../types.js";
6
+ import type { MnemeStore } from "../store/sqlite.js";
7
+ /** Load every commit from the store, oldest first, with its file list. */
8
+ export declare function loadAllCommits(s: MnemeStore): Commit[];
9
+ /** Load commits within a date range. */
10
+ export declare function loadCommitsBetween(s: MnemeStore, sinceIso?: string, untilIso?: string): Commit[];
11
+ /** Stable hash of a string list — used for hash-chain ledger entries + cluster ids. */
12
+ export declare function sha256Hex(...parts: string[]): Promise<string>;
13
+ /** Cosine similarity for Float32Arrays. */
14
+ export declare function cosineSim(a: Float32Array, b: Float32Array): number;
15
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,EAAE,CAKtD;AAED,wCAAwC;AACxC,wBAAgB,kBAAkB,CAChC,CAAC,EAAE,UAAU,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,EAAE,CAcV;AAsBD,uFAAuF;AACvF,wBAAsB,SAAS,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAGnE;AAED,2CAA2C;AAC3C,wBAAgB,SAAS,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM,CAclE"}
@@ -0,0 +1,65 @@
1
+ /** Load every commit from the store, oldest first, with its file list. */
2
+ export function loadAllCommits(s) {
3
+ const rows = s.db
4
+ .prepare("SELECT * FROM commits ORDER BY author_date ASC")
5
+ .all();
6
+ return rows.map((r) => rowToCommit(r, s));
7
+ }
8
+ /** Load commits within a date range. */
9
+ export function loadCommitsBetween(s, sinceIso, untilIso) {
10
+ const where = [];
11
+ const params = [];
12
+ if (sinceIso) {
13
+ where.push("author_date >= ?");
14
+ params.push(sinceIso);
15
+ }
16
+ if (untilIso) {
17
+ where.push("author_date <= ?");
18
+ params.push(untilIso);
19
+ }
20
+ const sql = `SELECT * FROM commits${where.length ? " WHERE " + where.join(" AND ") : ""} ORDER BY author_date ASC`;
21
+ const rows = s.db.prepare(sql).all(...params);
22
+ return rows.map((r) => rowToCommit(r, s));
23
+ }
24
+ function rowToCommit(r, s) {
25
+ const hash = String(r.hash);
26
+ return {
27
+ hash,
28
+ shortHash: String(r.short_hash),
29
+ authorName: String(r.author_name),
30
+ authorEmail: String(r.author_email),
31
+ authorDate: String(r.author_date),
32
+ committerDate: String(r.committer_date),
33
+ subject: String(r.subject),
34
+ body: String(r.body),
35
+ parents: String(r.parents).split(/\s+/).filter(Boolean),
36
+ files: s.filesForCommit(hash),
37
+ prNumber: typeof r.pr_number === "number" ? r.pr_number : undefined,
38
+ prTitle: r.pr_title ? String(r.pr_title) : undefined,
39
+ prBody: r.pr_body ? String(r.pr_body) : undefined,
40
+ issueRefs: r.issue_refs ? JSON.parse(String(r.issue_refs)) : undefined,
41
+ };
42
+ }
43
+ /** Stable hash of a string list — used for hash-chain ledger entries + cluster ids. */
44
+ export async function sha256Hex(...parts) {
45
+ const { createHash } = await import("node:crypto");
46
+ return createHash("sha256").update(parts.join("|")).digest("hex");
47
+ }
48
+ /** Cosine similarity for Float32Arrays. */
49
+ export function cosineSim(a, b) {
50
+ if (a.length !== b.length)
51
+ return 0;
52
+ let dot = 0;
53
+ let na = 0;
54
+ let nb = 0;
55
+ for (let i = 0; i < a.length; i++) {
56
+ const av = a[i];
57
+ const bv = b[i];
58
+ dot += av * bv;
59
+ na += av * av;
60
+ nb += bv * bv;
61
+ }
62
+ const denom = Math.sqrt(na) * Math.sqrt(nb);
63
+ return denom === 0 ? 0 : dot / denom;
64
+ }
65
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=index.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/util/index.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,37 @@
1
+ import { describe, it, expect } from "vitest";
2
+ import { cosineSim, sha256Hex } from "./index.js";
3
+ describe("cosineSim", () => {
4
+ it("matches the standalone cosine in retrieve/search", () => {
5
+ expect(cosineSim(Float32Array.from([1, 0]), Float32Array.from([1, 0]))).toBeCloseTo(1, 6);
6
+ expect(cosineSim(Float32Array.from([1, 0]), Float32Array.from([0, 1]))).toBeCloseTo(0, 6);
7
+ expect(cosineSim(Float32Array.from([1, 0]), Float32Array.from([-1, 0]))).toBeCloseTo(-1, 6);
8
+ });
9
+ it("returns 0 for mismatched length", () => {
10
+ expect(cosineSim(Float32Array.from([1, 2, 3]), Float32Array.from([1, 2]))).toBe(0);
11
+ });
12
+ it("returns 0 for zero vector (no NaN)", () => {
13
+ expect(cosineSim(Float32Array.from([0, 0]), Float32Array.from([1, 1]))).toBe(0);
14
+ });
15
+ });
16
+ describe("sha256Hex", () => {
17
+ it("is deterministic for same inputs", async () => {
18
+ const a = await sha256Hex("a", "b", "c");
19
+ const b = await sha256Hex("a", "b", "c");
20
+ expect(a).toBe(b);
21
+ });
22
+ it("differs for different inputs", async () => {
23
+ const a = await sha256Hex("x");
24
+ const b = await sha256Hex("y");
25
+ expect(a).not.toBe(b);
26
+ });
27
+ it("is order-sensitive (hash of joined parts)", async () => {
28
+ const a = await sha256Hex("a", "b");
29
+ const b = await sha256Hex("b", "a");
30
+ expect(a).not.toBe(b);
31
+ });
32
+ it("produces 64-char hex output", async () => {
33
+ const h = await sha256Hex("anything");
34
+ expect(h).toMatch(/^[0-9a-f]{64}$/);
35
+ });
36
+ });
37
+ //# sourceMappingURL=index.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../src/util/index.test.ts"],"names":[],"mappings":"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"}
package/package.json ADDED
@@ -0,0 +1,62 @@
1
+ {
2
+ "name": "@mneme-ai/core",
3
+ "version": "0.8.3",
4
+ "description": "Core indexing, retrieval, and graph engine for Mneme",
5
+ "type": "module",
6
+ "main": "./dist/index.js",
7
+ "types": "./dist/index.d.ts",
8
+ "exports": {
9
+ ".": {
10
+ "import": "./dist/index.js",
11
+ "types": "./dist/index.d.ts"
12
+ },
13
+ "./git": {
14
+ "import": "./dist/git/index.js",
15
+ "types": "./dist/git/index.d.ts"
16
+ },
17
+ "./store": {
18
+ "import": "./dist/store/index.js",
19
+ "types": "./dist/store/index.d.ts"
20
+ },
21
+ "./indexer": {
22
+ "import": "./dist/indexer/index.js",
23
+ "types": "./dist/indexer/index.d.ts"
24
+ },
25
+ "./retrieve": {
26
+ "import": "./dist/retrieve/index.js",
27
+ "types": "./dist/retrieve/index.d.ts"
28
+ },
29
+ "./correlate": {
30
+ "import": "./dist/correlate/index.js",
31
+ "types": "./dist/correlate/index.d.ts"
32
+ }
33
+ },
34
+ "repository": {
35
+ "type": "git",
36
+ "url": "git+https://github.com/patsa2561-art/mneme-ai.git",
37
+ "directory": "packages/core"
38
+ },
39
+ "homepage": "https://github.com/patsa2561-art/mneme-ai#readme",
40
+ "bugs": {
41
+ "url": "https://github.com/patsa2561-art/mneme-ai/issues"
42
+ },
43
+ "license": "MIT",
44
+ "files": ["dist", "README.md"],
45
+ "scripts": {
46
+ "build": "tsc -b",
47
+ "clean": "tsc -b --clean"
48
+ },
49
+ "dependencies": {
50
+ "better-sqlite3": "^11.5.0"
51
+ },
52
+ "peerDependencies": {
53
+ "typescript": ">=5.0"
54
+ },
55
+ "peerDependenciesMeta": {
56
+ "typescript": { "optional": true }
57
+ },
58
+ "devDependencies": {
59
+ "@types/better-sqlite3": "^7.6.11",
60
+ "typescript": "^5.6.3"
61
+ }
62
+ }