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 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", "./mixgram"]
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": "./home/memory",
117
+ "homeMemoryRoot": "~/.mixgram/docs",
118
118
  "projectMemoryRoot": "./mixgram",
119
- "sqlitePath": "./.mixgram/index.db",
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` | `./home/memory` | Cross-project memory (Markdown files). |
132
- | `projectMemoryRoot` | `./mixgram` | Project memory in the current repo (e.g. `mixgram/architecture/`, `mixgram/decisions/`). |
133
- | `sqlitePath` | `./.mixgram/index.db` | SQLite index (FTS5 + optional vectors). |
134
- | `watch` | `false` | Watch files and reindex on change. |
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, --projects, --sqlite-path */
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.4",
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": "^10.4.5",
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": "./home/memory",
932
- "projectsRoot": "./projects",
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: './home/memory',
13
+ homeMemoryRoot: '~/.mixgram/shared',
5
14
  projectMemoryRoot: './mixgram',
6
- projectsRoot: './projects',
7
- sqlitePath: './.mixgram/index.db',
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, config.homeMemoryRoot),
57
+ homeMemoryRoot: path.isAbsolute(homeRoot) ? homeRoot : path.resolve(base, homeRoot),
48
58
  projectMemoryRoot: path.resolve(projectBase, config.projectMemoryRoot ?? './mixgram'),
49
- projectsRoot: path.resolve(base, config.projectsRoot),
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
Binary file
Binary file
Binary file
@@ -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.