@hyperlynq/synaptic 0.7.0

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 (98) hide show
  1. package/LICENSE +19 -0
  2. package/README.md +427 -0
  3. package/build/scripts/rebuild-index.d.ts +5 -0
  4. package/build/scripts/rebuild-index.js +33 -0
  5. package/build/src/cli/init.d.ts +13 -0
  6. package/build/src/cli/init.js +222 -0
  7. package/build/src/cli/init.js.map +1 -0
  8. package/build/src/cli/pre-commit.d.ts +6 -0
  9. package/build/src/cli/pre-commit.js +159 -0
  10. package/build/src/cli/pre-commit.js.map +1 -0
  11. package/build/src/cli.d.ts +2 -0
  12. package/build/src/cli.js +36 -0
  13. package/build/src/cli.js.map +1 -0
  14. package/build/src/hooks/pre-compact.d.ts +6 -0
  15. package/build/src/hooks/pre-compact.js +64 -0
  16. package/build/src/hooks/pre-compact.js.map +1 -0
  17. package/build/src/hooks/session-start.d.ts +13 -0
  18. package/build/src/hooks/session-start.js +277 -0
  19. package/build/src/hooks/session-start.js.map +1 -0
  20. package/build/src/hooks/stop.d.ts +7 -0
  21. package/build/src/hooks/stop.js +248 -0
  22. package/build/src/hooks/stop.js.map +1 -0
  23. package/build/src/index.d.ts +1 -0
  24. package/build/src/index.js +8 -0
  25. package/build/src/index.js.map +1 -0
  26. package/build/src/server.d.ts +6 -0
  27. package/build/src/server.js +133 -0
  28. package/build/src/server.js.map +1 -0
  29. package/build/src/storage/embedder.d.ts +27 -0
  30. package/build/src/storage/embedder.js +126 -0
  31. package/build/src/storage/embedder.js.map +1 -0
  32. package/build/src/storage/git.d.ts +20 -0
  33. package/build/src/storage/git.js +98 -0
  34. package/build/src/storage/git.js.map +1 -0
  35. package/build/src/storage/maintenance.d.ts +9 -0
  36. package/build/src/storage/maintenance.js +46 -0
  37. package/build/src/storage/maintenance.js.map +1 -0
  38. package/build/src/storage/markdown.d.ts +21 -0
  39. package/build/src/storage/markdown.js +79 -0
  40. package/build/src/storage/markdown.js.map +1 -0
  41. package/build/src/storage/paths.d.ts +6 -0
  42. package/build/src/storage/paths.js +17 -0
  43. package/build/src/storage/paths.js.map +1 -0
  44. package/build/src/storage/project.d.ts +2 -0
  45. package/build/src/storage/project.js +35 -0
  46. package/build/src/storage/project.js.map +1 -0
  47. package/build/src/storage/session.d.ts +1 -0
  48. package/build/src/storage/session.js +17 -0
  49. package/build/src/storage/session.js.map +1 -0
  50. package/build/src/storage/sqlite.d.ts +102 -0
  51. package/build/src/storage/sqlite.js +830 -0
  52. package/build/src/storage/sqlite.js.map +1 -0
  53. package/build/src/storage/watcher.d.ts +22 -0
  54. package/build/src/storage/watcher.js +126 -0
  55. package/build/src/storage/watcher.js.map +1 -0
  56. package/build/src/tools/context-archive.d.ts +11 -0
  57. package/build/src/tools/context-archive.js +13 -0
  58. package/build/src/tools/context-archive.js.map +1 -0
  59. package/build/src/tools/context-chain.d.ts +12 -0
  60. package/build/src/tools/context-chain.js +26 -0
  61. package/build/src/tools/context-chain.js.map +1 -0
  62. package/build/src/tools/context-cochanges.d.ts +20 -0
  63. package/build/src/tools/context-cochanges.js +25 -0
  64. package/build/src/tools/context-cochanges.js.map +1 -0
  65. package/build/src/tools/context-delete-rule.d.ts +11 -0
  66. package/build/src/tools/context-delete-rule.js +12 -0
  67. package/build/src/tools/context-delete-rule.js.map +1 -0
  68. package/build/src/tools/context-dna.d.ts +18 -0
  69. package/build/src/tools/context-dna.js +197 -0
  70. package/build/src/tools/context-dna.js.map +1 -0
  71. package/build/src/tools/context-git-index.d.ts +17 -0
  72. package/build/src/tools/context-git-index.js +59 -0
  73. package/build/src/tools/context-git-index.js.map +1 -0
  74. package/build/src/tools/context-list-rules.d.ts +8 -0
  75. package/build/src/tools/context-list-rules.js +11 -0
  76. package/build/src/tools/context-list-rules.js.map +1 -0
  77. package/build/src/tools/context-list.d.ts +26 -0
  78. package/build/src/tools/context-list.js +42 -0
  79. package/build/src/tools/context-list.js.map +1 -0
  80. package/build/src/tools/context-resolve-pattern.d.ts +11 -0
  81. package/build/src/tools/context-resolve-pattern.js +9 -0
  82. package/build/src/tools/context-resolve-pattern.js.map +1 -0
  83. package/build/src/tools/context-save-rule.d.ts +14 -0
  84. package/build/src/tools/context-save-rule.js +15 -0
  85. package/build/src/tools/context-save-rule.js.map +1 -0
  86. package/build/src/tools/context-save.d.ts +26 -0
  87. package/build/src/tools/context-save.js +68 -0
  88. package/build/src/tools/context-save.js.map +1 -0
  89. package/build/src/tools/context-search.d.ts +31 -0
  90. package/build/src/tools/context-search.js +99 -0
  91. package/build/src/tools/context-search.js.map +1 -0
  92. package/build/src/tools/context-session.d.ts +13 -0
  93. package/build/src/tools/context-session.js +29 -0
  94. package/build/src/tools/context-session.js.map +1 -0
  95. package/build/src/tools/context-status.d.ts +13 -0
  96. package/build/src/tools/context-status.js +15 -0
  97. package/build/src/tools/context-status.js.map +1 -0
  98. package/package.json +57 -0
@@ -0,0 +1,59 @@
1
+ import { z } from "zod";
2
+ import { appendEntry } from "../storage/markdown.js";
3
+ import { getGitLog, formatCommitAsContent, isGitRepo } from "../storage/git.js";
4
+ import { getCurrentProject } from "../server.js";
5
+ export const contextGitIndexSchema = {
6
+ repo_path: z
7
+ .string()
8
+ .optional()
9
+ .describe("Path to git repository (defaults to cwd)"),
10
+ days: z
11
+ .number()
12
+ .int()
13
+ .positive()
14
+ .default(7)
15
+ .describe("Index commits from last N days"),
16
+ branch: z
17
+ .string()
18
+ .optional()
19
+ .describe("Branch to index (defaults to current branch)"),
20
+ };
21
+ export async function contextGitIndex(args, index, embedder) {
22
+ const repoPath = args.repo_path ?? process.cwd();
23
+ if (!isGitRepo(repoPath)) {
24
+ return { indexed: 0, skipped: 0, repo: repoPath };
25
+ }
26
+ const commits = getGitLog(repoPath, { days: args.days, branch: args.branch });
27
+ let indexed = 0;
28
+ let skipped = 0;
29
+ for (const commit of commits) {
30
+ const shaTag = `sha:${commit.sha.slice(0, 12)}`;
31
+ // Dedup: skip if already indexed
32
+ if (index.hasEntryWithTag(shaTag)) {
33
+ skipped++;
34
+ continue;
35
+ }
36
+ const content = formatCommitAsContent(commit);
37
+ const entry = appendEntry(content, "git_commit", [shaTag, commit.branch]);
38
+ // Auto-tier: recent = working, older = ephemeral
39
+ const commitDate = new Date(commit.date);
40
+ const ageDays = (Date.now() - commitDate.getTime()) / (1000 * 60 * 60 * 24);
41
+ entry.tier = ageDays < 7 ? "working" : "ephemeral";
42
+ const rowid = index.insert(entry);
43
+ const embedding = await embedder.embed(content);
44
+ index.insertVec(rowid, embedding);
45
+ indexed++;
46
+ // Generate co-change pairs (skip commits with 20+ files — too noisy)
47
+ const project = getCurrentProject();
48
+ if (project && commit.files.length >= 2 && commit.files.length < 20) {
49
+ const filePaths = commit.files.map(f => f.path);
50
+ for (let i = 0; i < filePaths.length; i++) {
51
+ for (let j = i + 1; j < filePaths.length; j++) {
52
+ index.upsertFilePair(project, filePaths[i], filePaths[j], commit.date);
53
+ }
54
+ }
55
+ }
56
+ }
57
+ return { indexed, skipped, repo: repoPath };
58
+ }
59
+ //# sourceMappingURL=context-git-index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context-git-index.js","sourceRoot":"","sources":["../../../src/tools/context-git-index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ import { ContextIndex } from "../storage/sqlite.js";
2
+ export declare function contextListRules(index: ContextIndex): {
3
+ rules: Array<{
4
+ label: string;
5
+ content: string;
6
+ date: string;
7
+ }>;
8
+ };
@@ -0,0 +1,11 @@
1
+ export function contextListRules(index) {
2
+ const rules = index.listRules();
3
+ return {
4
+ rules: rules.map((r) => ({
5
+ label: r.label,
6
+ content: r.content,
7
+ date: r.date,
8
+ })),
9
+ };
10
+ }
11
+ //# sourceMappingURL=context-list-rules.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context-list-rules.js","sourceRoot":"","sources":["../../../src/tools/context-list-rules.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAC9B,KAAmB;IAEnB,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;IAChC,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,IAAI,EAAE,CAAC,CAAC,IAAI;SACb,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}
@@ -0,0 +1,26 @@
1
+ import { z } from "zod";
2
+ import { ContextIndex } from "../storage/sqlite.js";
3
+ export declare const contextListSchema: {
4
+ days: z.ZodDefault<z.ZodNumber>;
5
+ type: z.ZodOptional<z.ZodEnum<["decision", "progress", "issue", "handoff", "insight", "reference", "git_commit", "rule"]>>;
6
+ include_archived: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
7
+ };
8
+ interface GroupedEntries {
9
+ date: string;
10
+ entries: Array<{
11
+ id: string;
12
+ time: string;
13
+ type: string;
14
+ tags: string[];
15
+ content: string;
16
+ }>;
17
+ }
18
+ export declare function contextList(args: {
19
+ days?: number;
20
+ type?: string;
21
+ include_archived?: boolean;
22
+ }, index: ContextIndex): {
23
+ groups: GroupedEntries[];
24
+ total: number;
25
+ };
26
+ export {};
@@ -0,0 +1,42 @@
1
+ import { z } from "zod";
2
+ export const contextListSchema = {
3
+ days: z
4
+ .number()
5
+ .int()
6
+ .positive()
7
+ .default(7)
8
+ .describe("List entries from last N days"),
9
+ type: z
10
+ .enum(["decision", "progress", "issue", "handoff", "insight", "reference", "git_commit", "rule"])
11
+ .optional()
12
+ .describe("Filter by entry type"),
13
+ include_archived: z
14
+ .boolean()
15
+ .optional()
16
+ .default(false)
17
+ .describe("Include archived entries in results"),
18
+ };
19
+ export function contextList(args, index) {
20
+ const entries = index.list({ days: args.days, type: args.type, includeArchived: args.include_archived });
21
+ // Group by date
22
+ const grouped = new Map();
23
+ for (const entry of entries) {
24
+ let group = grouped.get(entry.date);
25
+ if (!group) {
26
+ group = { date: entry.date, entries: [] };
27
+ grouped.set(entry.date, group);
28
+ }
29
+ group.entries.push({
30
+ id: entry.id,
31
+ time: entry.time,
32
+ type: entry.type,
33
+ tags: entry.tags,
34
+ content: entry.content,
35
+ });
36
+ }
37
+ return {
38
+ groups: Array.from(grouped.values()),
39
+ total: entries.length,
40
+ };
41
+ }
42
+ //# sourceMappingURL=context-list.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context-list.js","sourceRoot":"","sources":["../../../src/tools/context-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CAAC,+BAA+B,CAAC;IAC5C,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;SAChG,QAAQ,EAAE;SACV,QAAQ,CAAC,sBAAsB,CAAC;IACnC,gBAAgB,EAAE,CAAC;SAChB,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,qCAAqC,CAAC;CACnD,CAAC;AAaF,MAAM,UAAU,WAAW,CACzB,IAAkE,EAClE,KAAmB;IAEnB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAEzG,gBAAgB;IAChB,MAAM,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAClD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACjC,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YACjB,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpC,KAAK,EAAE,OAAO,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC"}
@@ -0,0 +1,11 @@
1
+ import { z } from "zod";
2
+ import { ContextIndex } from "../storage/sqlite.js";
3
+ export declare const contextResolvePatternSchema: {
4
+ pattern_id: z.ZodString;
5
+ };
6
+ export declare function contextResolvePattern(args: {
7
+ pattern_id: string;
8
+ }, index: ContextIndex): {
9
+ resolved: boolean;
10
+ pattern_id: string;
11
+ };
@@ -0,0 +1,9 @@
1
+ import { z } from "zod";
2
+ export const contextResolvePatternSchema = {
3
+ pattern_id: z.string().describe("Pattern ID to mark as resolved"),
4
+ };
5
+ export function contextResolvePattern(args, index) {
6
+ const resolved = index.resolvePattern(args.pattern_id);
7
+ return { resolved, pattern_id: args.pattern_id };
8
+ }
9
+ //# sourceMappingURL=context-resolve-pattern.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context-resolve-pattern.js","sourceRoot":"","sources":["../../../src/tools/context-resolve-pattern.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;CAClE,CAAC;AAEF,MAAM,UAAU,qBAAqB,CACnC,IAA4B,EAC5B,KAAmB;IAEnB,MAAM,QAAQ,GAAG,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;AACnD,CAAC"}
@@ -0,0 +1,14 @@
1
+ import { z } from "zod";
2
+ import { ContextIndex } from "../storage/sqlite.js";
3
+ export declare const contextSaveRuleSchema: {
4
+ label: z.ZodString;
5
+ content: z.ZodString;
6
+ };
7
+ export declare function contextSaveRule(args: {
8
+ label: string;
9
+ content: string;
10
+ }, index: ContextIndex): {
11
+ success: boolean;
12
+ label: string;
13
+ action: string;
14
+ };
@@ -0,0 +1,15 @@
1
+ import { z } from "zod";
2
+ export const contextSaveRuleSchema = {
3
+ label: z.string().describe("Unique short key for the rule (e.g. 'no-emoji', 'commit-style')"),
4
+ content: z.string().describe("The rule text — what Claude must always follow"),
5
+ };
6
+ export function contextSaveRule(args, index) {
7
+ const existing = index.listRules().find((r) => r.label === args.label);
8
+ index.saveRule(args.label, args.content);
9
+ return {
10
+ success: true,
11
+ label: args.label,
12
+ action: existing ? "updated" : "created",
13
+ };
14
+ }
15
+ //# sourceMappingURL=context-save-rule.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context-save-rule.js","sourceRoot":"","sources":["../../../src/tools/context-save-rule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iEAAiE,CAAC;IAC7F,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;CAC/E,CAAC;AAEF,MAAM,UAAU,eAAe,CAC7B,IAAwC,EACxC,KAAmB;IAEnB,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC;IACvE,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,OAAO;QACL,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;KACzC,CAAC;AACJ,CAAC"}
@@ -0,0 +1,26 @@
1
+ import { z } from "zod";
2
+ import { ContextIndex } from "../storage/sqlite.js";
3
+ import { Embedder } from "../storage/embedder.js";
4
+ export declare const contextSaveSchema: {
5
+ content: z.ZodString;
6
+ type: z.ZodEnum<["decision", "progress", "issue", "handoff", "insight", "reference", "git_commit", "rule"]>;
7
+ tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
8
+ tier: z.ZodOptional<z.ZodEnum<["ephemeral", "working", "longterm"]>>;
9
+ pinned: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
10
+ agent_id: z.ZodOptional<z.ZodString>;
11
+ };
12
+ export declare function contextSave(args: {
13
+ content: string;
14
+ type: string;
15
+ tags: string[];
16
+ tier?: string;
17
+ pinned?: boolean;
18
+ agent_id?: string;
19
+ }, index: ContextIndex, embedder: Embedder): Promise<{
20
+ success: boolean;
21
+ id: string;
22
+ date: string;
23
+ time: string;
24
+ tier: string;
25
+ pattern_detected?: string;
26
+ }>;
@@ -0,0 +1,68 @@
1
+ import { z } from "zod";
2
+ import { appendEntry } from "../storage/markdown.js";
3
+ import { ContextIndex } from "../storage/sqlite.js";
4
+ import { getCurrentProject } from "../server.js";
5
+ import { getSessionId } from "../storage/session.js";
6
+ export const contextSaveSchema = {
7
+ content: z.string().describe("The context content to save"),
8
+ type: z
9
+ .enum(["decision", "progress", "issue", "handoff", "insight", "reference", "git_commit", "rule"])
10
+ .describe("Type of context entry"),
11
+ tags: z
12
+ .array(z.string())
13
+ .default([])
14
+ .describe("Tags for categorization (e.g. project names, topics)"),
15
+ tier: z
16
+ .enum(["ephemeral", "working", "longterm"])
17
+ .optional()
18
+ .describe("Memory tier override. Auto-assigned by type if omitted."),
19
+ pinned: z
20
+ .boolean()
21
+ .optional()
22
+ .default(false)
23
+ .describe("Pin entry to prevent auto-decay"),
24
+ agent_id: z
25
+ .string()
26
+ .optional()
27
+ .describe("Optional agent identifier (defaults to 'main')"),
28
+ };
29
+ export async function contextSave(args, index, embedder) {
30
+ const tier = ContextIndex.assignTier(args.type, args.tier);
31
+ const entry = appendEntry(args.content, args.type, args.tags);
32
+ entry.tier = tier;
33
+ entry.pinned = args.pinned ?? false;
34
+ // Enrich with project, session, and agent metadata
35
+ const enrichedEntry = {
36
+ ...entry,
37
+ project: getCurrentProject() ?? undefined,
38
+ sessionId: getSessionId(),
39
+ agentId: args.agent_id ?? "main",
40
+ };
41
+ const rowid = index.insert(enrichedEntry);
42
+ const embedding = await embedder.embed(args.content);
43
+ index.insertVec(rowid, embedding);
44
+ // Pattern detection for issues
45
+ let patternId;
46
+ if (args.type === "issue") {
47
+ try {
48
+ const similar = index.findSimilarIssues(embedding)
49
+ .filter(e => e.id !== entry.id);
50
+ if (similar.length >= 2) {
51
+ const allIds = [entry.id, ...similar.map(e => e.id)];
52
+ patternId = index.createOrUpdatePattern(args.content, allIds);
53
+ }
54
+ }
55
+ catch {
56
+ // Don't fail the save if pattern detection errors
57
+ }
58
+ }
59
+ return {
60
+ success: true,
61
+ id: entry.id,
62
+ date: entry.date,
63
+ time: entry.time,
64
+ tier,
65
+ ...(patternId ? { pattern_detected: patternId } : {}),
66
+ };
67
+ }
68
+ //# sourceMappingURL=context-save.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context-save.js","sourceRoot":"","sources":["../../../src/tools/context-save.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAC3D,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;SAChG,QAAQ,CAAC,uBAAuB,CAAC;IACpC,IAAI,EAAE,CAAC;SACJ,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,sDAAsD,CAAC;IACnE,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;SAC1C,QAAQ,EAAE;SACV,QAAQ,CAAC,yDAAyD,CAAC;IACtE,MAAM,EAAE,CAAC;SACN,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,iCAAiC,CAAC;IAC9C,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,gDAAgD,CAAC;CAC9D,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAA2G,EAC3G,KAAmB,EACnB,QAAkB;IAElB,MAAM,IAAI,GAAG,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9D,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;IAClB,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC;IAEpC,mDAAmD;IACnD,MAAM,aAAa,GAAG;QACpB,GAAG,KAAK;QACR,OAAO,EAAE,iBAAiB,EAAE,IAAI,SAAS;QACzC,SAAS,EAAE,YAAY,EAAE;QACzB,OAAO,EAAE,IAAI,CAAC,QAAQ,IAAI,MAAM;KACjC,CAAC;IACF,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAE1C,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAElC,+BAA+B;IAC/B,IAAI,SAA6B,CAAC;IAClC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,KAAK,CAAC,iBAAiB,CAAC,SAAS,CAAC;iBAC/C,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC,CAAC;YAClC,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACxB,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACrD,SAAS,GAAG,KAAK,CAAC,qBAAqB,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,kDAAkD;QACpD,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI;QACJ,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAC;AACJ,CAAC"}
@@ -0,0 +1,31 @@
1
+ import { z } from "zod";
2
+ import { ContextIndex } from "../storage/sqlite.js";
3
+ import { Embedder } from "../storage/embedder.js";
4
+ export declare const contextSearchSchema: {
5
+ query: z.ZodString;
6
+ type: z.ZodOptional<z.ZodEnum<["decision", "progress", "issue", "handoff", "insight", "reference", "git_commit", "rule"]>>;
7
+ days: z.ZodOptional<z.ZodNumber>;
8
+ limit: z.ZodDefault<z.ZodNumber>;
9
+ tier: z.ZodOptional<z.ZodEnum<["ephemeral", "working", "longterm"]>>;
10
+ include_archived: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
11
+ mode: z.ZodOptional<z.ZodEnum<["fast", "semantic", "hybrid"]>>;
12
+ };
13
+ export declare function contextSearch(args: {
14
+ query: string;
15
+ type?: string;
16
+ days?: number;
17
+ limit?: number;
18
+ tier?: string;
19
+ include_archived?: boolean;
20
+ mode?: string;
21
+ }, index: ContextIndex, embedder: Embedder): Promise<{
22
+ results: Array<{
23
+ id: string;
24
+ date: string;
25
+ time: string;
26
+ type: string;
27
+ tags: string[];
28
+ content: string;
29
+ }>;
30
+ total: number;
31
+ }>;
@@ -0,0 +1,99 @@
1
+ import { z } from "zod";
2
+ import { getCurrentProject } from "../server.js";
3
+ export const contextSearchSchema = {
4
+ query: z.string().describe("Search query (hybrid semantic + keyword search)"),
5
+ type: z
6
+ .enum(["decision", "progress", "issue", "handoff", "insight", "reference", "git_commit", "rule"])
7
+ .optional()
8
+ .describe("Filter by entry type"),
9
+ days: z
10
+ .number()
11
+ .int()
12
+ .positive()
13
+ .optional()
14
+ .describe("Only search entries from last N days"),
15
+ limit: z
16
+ .number()
17
+ .int()
18
+ .positive()
19
+ .max(100)
20
+ .default(20)
21
+ .describe("Maximum results to return"),
22
+ tier: z
23
+ .enum(["ephemeral", "working", "longterm"])
24
+ .optional()
25
+ .describe("Filter results to specific memory tier"),
26
+ include_archived: z
27
+ .boolean()
28
+ .optional()
29
+ .default(false)
30
+ .describe("Include archived entries in results"),
31
+ mode: z
32
+ .enum(["fast", "semantic", "hybrid"])
33
+ .optional()
34
+ .describe("Search mode: fast (BM25 keyword only), semantic (vector only), hybrid (both). Auto-detects if omitted."),
35
+ };
36
+ function autoDetectMode(query) {
37
+ const words = query.trim().split(/\s+/);
38
+ if (words.length <= 3 && !query.includes("?"))
39
+ return "fast";
40
+ return "hybrid";
41
+ }
42
+ export async function contextSearch(args, index, embedder) {
43
+ const mode = args.mode ?? autoDetectMode(args.query);
44
+ let results;
45
+ if (mode === "fast") {
46
+ results = index.search(args.query, {
47
+ type: args.type,
48
+ days: args.days,
49
+ limit: args.limit,
50
+ includeArchived: args.include_archived,
51
+ });
52
+ index.bumpAccess(results.map((e) => e.id));
53
+ }
54
+ else if (mode === "semantic") {
55
+ const embedding = await embedder.embed(args.query);
56
+ const limit = args.limit ?? 20;
57
+ const vecResults = index.searchVec(embedding, limit * 3);
58
+ const entries = index.getByRowids(vecResults.map((r) => r.rowid));
59
+ results = entries.filter((e) => {
60
+ if (!args.include_archived && e.archived)
61
+ return false;
62
+ if (args.tier && e.tier !== args.tier)
63
+ return false;
64
+ if (args.type && e.type !== args.type)
65
+ return false;
66
+ return true;
67
+ }).slice(0, limit);
68
+ index.bumpAccess(results.map((e) => e.id));
69
+ }
70
+ else {
71
+ const embedding = await embedder.embed(args.query);
72
+ results = index.hybridSearch(args.query, embedding, {
73
+ type: args.type,
74
+ days: args.days,
75
+ limit: args.limit,
76
+ tier: args.tier,
77
+ includeArchived: args.include_archived,
78
+ project: getCurrentProject(),
79
+ });
80
+ }
81
+ const enriched = results.map((r) => {
82
+ const pattern = index.getPatternForEntry(r.id);
83
+ return {
84
+ id: r.id,
85
+ date: r.date,
86
+ time: r.time,
87
+ type: r.type,
88
+ tags: r.tags,
89
+ content: r.content,
90
+ ...(r.tier ? { tier: r.tier } : {}),
91
+ ...(pattern ? { pattern: `Recurring pattern: seen ${pattern.occurrenceCount} times (pattern: ${pattern.id})` } : {}),
92
+ };
93
+ });
94
+ return {
95
+ results: enriched,
96
+ total: enriched.length,
97
+ };
98
+ }
99
+ //# sourceMappingURL=context-search.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context-search.js","sourceRoot":"","sources":["../../../src/tools/context-search.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ import { z } from "zod";
2
+ import { ContextIndex } from "../storage/sqlite.js";
3
+ export declare const contextSessionSchema: {
4
+ session_id: z.ZodOptional<z.ZodString>;
5
+ type: z.ZodOptional<z.ZodEnum<["decision", "progress", "issue", "handoff", "insight", "reference", "git_commit", "rule"]>>;
6
+ };
7
+ export declare function contextSession(args: {
8
+ session_id?: string;
9
+ type?: string;
10
+ }, index: ContextIndex): {
11
+ entries: Array<Record<string, unknown>>;
12
+ total: number;
13
+ };
@@ -0,0 +1,29 @@
1
+ import { z } from "zod";
2
+ import { getSessionId } from "../storage/session.js";
3
+ export const contextSessionSchema = {
4
+ session_id: z
5
+ .string()
6
+ .optional()
7
+ .describe("Session ID to query. Defaults to current session."),
8
+ type: z
9
+ .enum(["decision", "progress", "issue", "handoff", "insight", "reference", "git_commit", "rule"])
10
+ .optional()
11
+ .describe("Filter by entry type"),
12
+ };
13
+ export function contextSession(args, index) {
14
+ const sessionId = args.session_id ?? getSessionId();
15
+ const results = index.listBySession(sessionId, { type: args.type });
16
+ return {
17
+ entries: results.map(r => ({
18
+ id: r.id,
19
+ date: r.date,
20
+ time: r.time,
21
+ type: r.type,
22
+ tags: r.tags,
23
+ content: r.content,
24
+ agent_id: r.agentId ?? null,
25
+ })),
26
+ total: results.length,
27
+ };
28
+ }
29
+ //# sourceMappingURL=context-session.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context-session.js","sourceRoot":"","sources":["../../../src/tools/context-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,mDAAmD,CAAC;IAChE,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;SAChG,QAAQ,EAAE;SACV,QAAQ,CAAC,sBAAsB,CAAC;CACpC,CAAC;AAEF,MAAM,UAAU,cAAc,CAC5B,IAA4C,EAC5C,KAAmB;IAEnB,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,IAAI,YAAY,EAAE,CAAC;IACpD,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAEpE,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACzB,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,QAAQ,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI;SAC5B,CAAC,CAAC;QACH,KAAK,EAAE,OAAO,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC"}
@@ -0,0 +1,13 @@
1
+ import { ContextIndex } from "../storage/sqlite.js";
2
+ export declare function contextStatus(index: ContextIndex): {
3
+ totalEntries: number;
4
+ dateRange: {
5
+ earliest: string;
6
+ latest: string;
7
+ } | null;
8
+ dbSizeBytes: number;
9
+ dbSizeHuman: string;
10
+ tierDistribution: Record<string, number>;
11
+ archivedCount: number;
12
+ activePatterns: number;
13
+ };
@@ -0,0 +1,15 @@
1
+ export function contextStatus(index) {
2
+ const stats = index.status();
3
+ let dbSizeHuman;
4
+ if (stats.dbSizeBytes < 1024) {
5
+ dbSizeHuman = `${stats.dbSizeBytes} B`;
6
+ }
7
+ else if (stats.dbSizeBytes < 1024 * 1024) {
8
+ dbSizeHuman = `${(stats.dbSizeBytes / 1024).toFixed(1)} KB`;
9
+ }
10
+ else {
11
+ dbSizeHuman = `${(stats.dbSizeBytes / (1024 * 1024)).toFixed(1)} MB`;
12
+ }
13
+ return { ...stats, dbSizeHuman };
14
+ }
15
+ //# sourceMappingURL=context-status.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context-status.js","sourceRoot":"","sources":["../../../src/tools/context-status.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,aAAa,CAAC,KAAmB;IAS/C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;IAE7B,IAAI,WAAmB,CAAC;IACxB,IAAI,KAAK,CAAC,WAAW,GAAG,IAAI,EAAE,CAAC;QAC7B,WAAW,GAAG,GAAG,KAAK,CAAC,WAAW,IAAI,CAAC;IACzC,CAAC;SAAM,IAAI,KAAK,CAAC,WAAW,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;QAC3C,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAC9D,CAAC;SAAM,CAAC;QACN,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IACvE,CAAC;IAED,OAAO,EAAE,GAAG,KAAK,EAAE,WAAW,EAAE,CAAC;AACnC,CAAC"}
package/package.json ADDED
@@ -0,0 +1,57 @@
1
+ {
2
+ "name": "@hyperlynq/synaptic",
3
+ "version": "0.7.0",
4
+ "description": "Persistent local memory for Claude Code — cross-session context recall, semantic search, zero cloud",
5
+ "type": "module",
6
+ "main": "build/src/index.js",
7
+ "bin": {
8
+ "synaptic": "build/src/cli.js"
9
+ },
10
+ "files": [
11
+ "build/src/",
12
+ "build/scripts/rebuild-index.js",
13
+ "build/scripts/rebuild-index.d.ts",
14
+ "LICENSE",
15
+ "README.md"
16
+ ],
17
+ "scripts": {
18
+ "build": "tsc",
19
+ "rebuild-index": "node build/scripts/rebuild-index.js",
20
+ "smoke-test": "npm run build && node build/scripts/smoke-test.js",
21
+ "prepublishOnly": "npm run build"
22
+ },
23
+ "keywords": [
24
+ "claude",
25
+ "claude-code",
26
+ "mcp",
27
+ "memory",
28
+ "context",
29
+ "persistent-memory",
30
+ "model-context-protocol",
31
+ "ai-tools",
32
+ "developer-tools"
33
+ ],
34
+ "author": "HYPERLYNQ <hyperlynq@outlook.com>",
35
+ "license": "SEE LICENSE IN LICENSE",
36
+ "repository": {
37
+ "type": "git",
38
+ "url": "git+https://github.com/HYPERLYNQ/synaptic.git"
39
+ },
40
+ "homepage": "https://github.com/HYPERLYNQ/synaptic",
41
+ "bugs": {
42
+ "url": "https://github.com/HYPERLYNQ/synaptic/issues"
43
+ },
44
+ "engines": {
45
+ "node": ">=22.0.0"
46
+ },
47
+ "dependencies": {
48
+ "@huggingface/transformers": "^3.8.1",
49
+ "@modelcontextprotocol/sdk": "^1.12.1",
50
+ "sqlite-vec": "^0.1.7-alpha.2",
51
+ "zod": "^3.24.2"
52
+ },
53
+ "devDependencies": {
54
+ "@types/node": "^22.13.4",
55
+ "typescript": "^5.7.3"
56
+ }
57
+ }