mixgram 1.0.4 → 1.0.8
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.
- package/README.md +9 -10
- package/bin/mixgram.js +1 -4
- package/package.json +2 -2
- package/spec/run-tests.js +0 -3
- package/spec/sdd.md +2 -3
- package/src/config.js +16 -7
- package/.mixgram/index.db +0 -0
- package/.mixgram/test-esm.db +0 -0
- package/.mixgram/test-index.db +0 -0
- package/.mixgram/test-stage1.db +0 -0
- package/projects/castlebravo/memory/decisions/decision--architecture/sqlite-derived-index.md +0 -17
- package/projects/test/memory/decisions/decision--architecture/sqlite-derived-index.md +0 -17
package/README.md
CHANGED
|
@@ -81,11 +81,11 @@ With embeddings and custom paths via args:
|
|
|
81
81
|
```json
|
|
82
82
|
"mixgram": {
|
|
83
83
|
"command": "mixgram",
|
|
84
|
-
"args": ["mcp", "--embeddings", "--home", "/data/memory", "--project-memory", "./
|
|
84
|
+
"args": ["mcp", "--embeddings", "--home", "/data/memory", "--project-memory", "./specs"]
|
|
85
85
|
}
|
|
86
86
|
```
|
|
87
87
|
|
|
88
|
-
Or use a config file (see below) and just `"args": ["mcp"]`. Restart Cursor after changing config.
|
|
88
|
+
Or use `./mixgram` (default), `./docs`, or any path. Or use a config file (see below) and just `"args": ["mcp"]`. Restart Cursor after changing config.
|
|
89
89
|
|
|
90
90
|
---
|
|
91
91
|
|
|
@@ -114,24 +114,23 @@ Example **`.mixgram/config.json`** (project or home):
|
|
|
114
114
|
|
|
115
115
|
```json
|
|
116
116
|
{
|
|
117
|
-
"homeMemoryRoot": "
|
|
117
|
+
"homeMemoryRoot": "~/.mixgram/docs",
|
|
118
118
|
"projectMemoryRoot": "./mixgram",
|
|
119
|
-
"sqlitePath": "
|
|
120
|
-
"watch": false,
|
|
119
|
+
"sqlitePath": "~/.mixgram/index.db",
|
|
121
120
|
"embeddings": {
|
|
122
121
|
"enabled": true
|
|
123
122
|
}
|
|
124
123
|
}
|
|
125
124
|
```
|
|
126
125
|
|
|
127
|
-
Paths in the config file are relative to the config file’s directory (project) or to the current directory when using `~/.mixgram/config.json`. **Project memory** is resolved relative to the current working directory (repo) when you use a global config, so docs stay in the repo. Defaults:
|
|
126
|
+
Paths in the config file are relative to the config file’s directory (project) or to the current directory when using `~/.mixgram/config.json`. **Project memory** is resolved relative to the current working directory (repo) when you use a global config, so docs stay in the repo. The project memory folder name is configurable: set `projectMemoryRoot` to e.g. `./specs` to get `specs/architecture/`, `specs/decisions/`, etc. Defaults:
|
|
128
127
|
|
|
129
128
|
| Option | Default | Description |
|
|
130
129
|
|--------|---------|-------------|
|
|
131
|
-
| `homeMemoryRoot` |
|
|
132
|
-
| `projectMemoryRoot` | `./mixgram` | Project memory in the current repo (e.g. `mixgram/architecture/`, `mixgram/decisions/`). |
|
|
133
|
-
| `sqlitePath` |
|
|
134
|
-
| `watch` | `
|
|
130
|
+
| `homeMemoryRoot` | `~/.mixgram/docs` | Cross-project memory (Markdown files). |
|
|
131
|
+
| `projectMemoryRoot` | `./mixgram` | Project memory in the current repo (e.g. `mixgram/architecture/`, `mixgram/decisions/`). You can use another folder name, e.g. `./specs` for `specs/architecture/`. |
|
|
132
|
+
| `sqlitePath` | `~/.mixgram/index.db` | SQLite index (FTS5 + optional vectors). |
|
|
133
|
+
| `watch` | `true` | Watch files and reindex on change. |
|
|
135
134
|
| `indexing.reindexOnStartup` | `true` | Full reindex when server starts. |
|
|
136
135
|
| `embeddings.enabled` | `false` | Enable async local embeddings and hybrid search. |
|
|
137
136
|
| `search.defaultScopeMode` | `'merged'` | `'project-only'` \| `'home-only'` \| `'merged'`. |
|
package/bin/mixgram.js
CHANGED
|
@@ -16,7 +16,7 @@ import os from 'os';
|
|
|
16
16
|
const SUBCOMMAND = process.argv[2];
|
|
17
17
|
const ARG = process.argv[3];
|
|
18
18
|
|
|
19
|
-
/** Parse options after "mcp": --config, --embeddings, --watch, --home, --
|
|
19
|
+
/** Parse options after "mcp": --config, --embeddings, --watch, --home, --sqlite-path */
|
|
20
20
|
function parseMcpArgs() {
|
|
21
21
|
const args = process.argv.slice(3);
|
|
22
22
|
const out = {};
|
|
@@ -33,8 +33,6 @@ function parseMcpArgs() {
|
|
|
33
33
|
out.homeMemoryRoot = args[++i];
|
|
34
34
|
} else if (a === '--project-memory' && args[i + 1]) {
|
|
35
35
|
out.projectMemoryRoot = args[++i];
|
|
36
|
-
} else if (a === '--projects' && args[i + 1]) {
|
|
37
|
-
out.projectsRoot = args[++i];
|
|
38
36
|
} else if (a === '--sqlite-path' && args[i + 1]) {
|
|
39
37
|
out.sqlitePath = args[++i];
|
|
40
38
|
}
|
|
@@ -84,7 +82,6 @@ function loadCliConfig() {
|
|
|
84
82
|
}
|
|
85
83
|
if (process.env.MIXGRAM_HOME) envOverrides.homeMemoryRoot = process.env.MIXGRAM_HOME;
|
|
86
84
|
if (process.env.MIXGRAM_PROJECT_MEMORY) envOverrides.projectMemoryRoot = process.env.MIXGRAM_PROJECT_MEMORY;
|
|
87
|
-
if (process.env.MIXGRAM_PROJECTS) envOverrides.projectsRoot = process.env.MIXGRAM_PROJECTS;
|
|
88
85
|
if (process.env.MIXGRAM_SQLITE_PATH) envOverrides.sqlitePath = process.env.MIXGRAM_SQLITE_PATH;
|
|
89
86
|
if (process.env.MIXGRAM_WATCH === '1' || process.env.MIXGRAM_WATCH === 'true') envOverrides.watch = true;
|
|
90
87
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "mixgram",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.8",
|
|
4
4
|
"description": "MCP memory server with Markdown source of truth and SQLite FTS5.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"mcp",
|
|
@@ -41,7 +41,7 @@
|
|
|
41
41
|
"better-sqlite3": "^12.6.2",
|
|
42
42
|
"chokidar": "^4.0.1",
|
|
43
43
|
"gray-matter": "^4.0.3",
|
|
44
|
-
"glob": "^
|
|
44
|
+
"glob": "^13.0.0",
|
|
45
45
|
"remark-parse": "^11.0.0",
|
|
46
46
|
"sqlite-vec": "^0.1.6",
|
|
47
47
|
"unified": "^11.0.5",
|
package/spec/run-tests.js
CHANGED
|
@@ -18,7 +18,6 @@ const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'mixgram-test-'));
|
|
|
18
18
|
const config = loadConfig({
|
|
19
19
|
homeMemoryRoot: path.join(tmpDir, 'home', 'memory'),
|
|
20
20
|
projectMemoryRoot: path.join(tmpDir, 'mixgram'),
|
|
21
|
-
projectsRoot: path.join(tmpDir, 'projects'),
|
|
22
21
|
sqlitePath: path.join(tmpDir, '.mixgram', 'index.db')
|
|
23
22
|
});
|
|
24
23
|
fs.mkdirSync(path.dirname(config.sqlitePath), { recursive: true });
|
|
@@ -54,7 +53,6 @@ async function runScenarios() {
|
|
|
54
53
|
const configSemantic = loadConfig({
|
|
55
54
|
homeMemoryRoot: config.homeMemoryRoot,
|
|
56
55
|
projectMemoryRoot: config.projectMemoryRoot,
|
|
57
|
-
projectsRoot: config.projectsRoot,
|
|
58
56
|
sqlitePath: config.sqlitePath,
|
|
59
57
|
embeddings: { enabled: true }
|
|
60
58
|
});
|
|
@@ -80,7 +78,6 @@ async function runLegacySemanticKnn() {
|
|
|
80
78
|
? loadConfig({
|
|
81
79
|
homeMemoryRoot: config.homeMemoryRoot,
|
|
82
80
|
projectMemoryRoot: config.projectMemoryRoot,
|
|
83
|
-
projectsRoot: config.projectsRoot,
|
|
84
81
|
sqlitePath: config.sqlitePath,
|
|
85
82
|
embeddings: { enabled: true }
|
|
86
83
|
})
|
package/spec/sdd.md
CHANGED
|
@@ -928,9 +928,8 @@ src/
|
|
|
928
928
|
|
|
929
929
|
```json
|
|
930
930
|
{
|
|
931
|
-
"homeMemoryRoot": "
|
|
932
|
-
"
|
|
933
|
-
"sqlitePath": "./.Mixgram/index.db",
|
|
931
|
+
"homeMemoryRoot": "~/.mixgram/docs",
|
|
932
|
+
"sqlitePath": "~/.mixgram/index.db",
|
|
934
933
|
"watch": true,
|
|
935
934
|
"indexing": {
|
|
936
935
|
"chunkSize": 1200,
|
package/src/config.js
CHANGED
|
@@ -1,11 +1,19 @@
|
|
|
1
1
|
import path from 'path';
|
|
2
|
+
import os from 'os';
|
|
3
|
+
|
|
4
|
+
function expandHome(p) {
|
|
5
|
+
if (typeof p !== 'string') return p;
|
|
6
|
+
if (p === '~' || p.startsWith('~/') || p.startsWith('~\\')) {
|
|
7
|
+
return path.join(os.homedir(), p.slice(2) || '');
|
|
8
|
+
}
|
|
9
|
+
return p;
|
|
10
|
+
}
|
|
2
11
|
|
|
3
12
|
const DEFAULT_CONFIG = {
|
|
4
|
-
homeMemoryRoot: '
|
|
13
|
+
homeMemoryRoot: '~/.mixgram/shared',
|
|
5
14
|
projectMemoryRoot: './mixgram',
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
watch: false,
|
|
15
|
+
sqlitePath: '~/.mixgram/index.db',
|
|
16
|
+
watch: true,
|
|
9
17
|
indexing: {
|
|
10
18
|
chunkSize: 1200,
|
|
11
19
|
chunkOverlap: 120,
|
|
@@ -42,12 +50,13 @@ const DEFAULT_CONFIG = {
|
|
|
42
50
|
function resolvePaths(config, baseDir, projectBaseDir = null) {
|
|
43
51
|
const base = baseDir || process.cwd();
|
|
44
52
|
const projectBase = projectBaseDir ?? base;
|
|
53
|
+
const homeRoot = expandHome(config.homeMemoryRoot);
|
|
54
|
+
const sqlite = expandHome(config.sqlitePath);
|
|
45
55
|
return {
|
|
46
56
|
...config,
|
|
47
|
-
homeMemoryRoot: path.resolve(base,
|
|
57
|
+
homeMemoryRoot: path.isAbsolute(homeRoot) ? homeRoot : path.resolve(base, homeRoot),
|
|
48
58
|
projectMemoryRoot: path.resolve(projectBase, config.projectMemoryRoot ?? './mixgram'),
|
|
49
|
-
|
|
50
|
-
sqlitePath: path.resolve(base, config.sqlitePath)
|
|
59
|
+
sqlitePath: path.isAbsolute(sqlite) ? sqlite : path.resolve(base, sqlite)
|
|
51
60
|
};
|
|
52
61
|
}
|
|
53
62
|
|
package/.mixgram/index.db
DELETED
|
Binary file
|
package/.mixgram/test-esm.db
DELETED
|
Binary file
|
package/.mixgram/test-index.db
DELETED
|
Binary file
|
package/.mixgram/test-stage1.db
DELETED
|
Binary file
|
package/projects/castlebravo/memory/decisions/decision--architecture/sqlite-derived-index.md
DELETED
|
@@ -1,17 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: obs_6ebf7e3f75daa71933d79c52
|
|
3
|
-
title: Use SQLite as derived index
|
|
4
|
-
type: decision
|
|
5
|
-
scope: project
|
|
6
|
-
project: castlebravo
|
|
7
|
-
topic_key: architecture/sqlite-derived-index
|
|
8
|
-
tool_name: mem_save
|
|
9
|
-
created_at: '2026-03-09T02:51:10.990Z'
|
|
10
|
-
updated_at: '2026-03-09T02:51:10.990Z'
|
|
11
|
-
revision_count: 1
|
|
12
|
-
duplicate_count: 0
|
|
13
|
-
deleted: false
|
|
14
|
-
tags: []
|
|
15
|
-
embedding_status: disabled
|
|
16
|
-
---
|
|
17
|
-
SQLite will be used as a derived index over Markdown documents.
|
|
@@ -1,17 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
id: obs_8a9cd5a608500ed1a05a6326
|
|
3
|
-
title: Use SQLite as derived index
|
|
4
|
-
type: decision
|
|
5
|
-
scope: project
|
|
6
|
-
project: test
|
|
7
|
-
topic_key: architecture/sqlite-derived-index
|
|
8
|
-
tool_name: mem_save
|
|
9
|
-
created_at: '2026-03-09T02:40:42.952Z'
|
|
10
|
-
updated_at: '2026-03-09T02:40:59.029Z'
|
|
11
|
-
revision_count: 2
|
|
12
|
-
duplicate_count: 0
|
|
13
|
-
deleted: false
|
|
14
|
-
tags: []
|
|
15
|
-
embedding_status: pending
|
|
16
|
-
---
|
|
17
|
-
We use a derived SQLite index over Markdown.
|