memorix 1.4.3 → 1.4.5

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 (158) hide show
  1. package/CHANGELOG.md +34 -0
  2. package/README.md +20 -6
  3. package/README.zh-CN.md +16 -3
  4. package/TEAM.md +86 -86
  5. package/assets/star-history-dark.svg +8 -8
  6. package/assets/star-history-light.svg +8 -8
  7. package/assets/star-history.json +16 -2
  8. package/dist/cli/index.js +539 -233
  9. package/dist/cli/memcode.js +0 -0
  10. package/dist/index.js +72 -15
  11. package/dist/maintenance-runner.js +9 -7
  12. package/dist/media-audio-runner.js +9 -7
  13. package/dist/media-video-runner.js +9 -7
  14. package/dist/memcode/index.js +9 -7
  15. package/dist/memcode-runtime/CHANGELOG.md +34 -0
  16. package/dist/sdk.js +71 -14
  17. package/dist/types.d.ts +1 -1
  18. package/dist/vector-backfill-runner.js +9 -7
  19. package/docs/AGENT_OPERATOR_PLAYBOOK.md +6 -5
  20. package/docs/API_REFERENCE.md +9 -5
  21. package/docs/CONFIGURATION.md +15 -5
  22. package/docs/DESIGN_DECISIONS.md +357 -357
  23. package/docs/DEVELOPMENT.md +2 -2
  24. package/docs/INTEGRATIONS.md +9 -2
  25. package/docs/KNOWN_ISSUES_AND_ROADMAP.md +4 -3
  26. package/docs/MEMCODE.md +1 -1
  27. package/docs/MODULES.md +1 -1
  28. package/docs/README.md +1 -1
  29. package/docs/SETUP.md +12 -4
  30. package/docs/hooks-architecture.md +2 -1
  31. package/llms-full.txt +7 -6
  32. package/llms.txt +2 -2
  33. package/package.json +1 -1
  34. package/plugins/claude/memorix/.claude-plugin/plugin.json +1 -1
  35. package/plugins/codebuddy/memorix/.codebuddy-plugin/plugin.json +1 -1
  36. package/plugins/codex/memorix/.codex-plugin/plugin.json +1 -1
  37. package/plugins/copilot/memorix/plugin.json +1 -1
  38. package/plugins/gemini/memorix/gemini-extension.json +1 -1
  39. package/plugins/omp/memorix/package.json +1 -1
  40. package/plugins/openclaw/memorix/.codex-plugin/plugin.json +1 -1
  41. package/plugins/pi/memorix/package.json +1 -1
  42. package/server.json +2 -2
  43. package/src/audit/index.ts +156 -156
  44. package/src/cli/commands/agent-integrations.ts +7 -1
  45. package/src/cli/commands/audit-list.ts +89 -89
  46. package/src/cli/commands/formation.ts +48 -48
  47. package/src/cli/commands/git-hook-install.ts +111 -111
  48. package/src/cli/commands/handoff.ts +54 -54
  49. package/src/cli/commands/hooks-install.ts +2 -0
  50. package/src/cli/commands/hooks-preview.ts +5 -0
  51. package/src/cli/commands/hooks-status.ts +63 -63
  52. package/src/cli/commands/ingest.ts +44 -44
  53. package/src/cli/commands/integrate-shared.ts +15 -15
  54. package/src/cli/commands/integrate.ts +2 -0
  55. package/src/cli/commands/lock.ts +82 -82
  56. package/src/cli/commands/media-image.ts +27 -0
  57. package/src/cli/commands/media.ts +8 -1
  58. package/src/cli/commands/memory.ts +44 -34
  59. package/src/cli/commands/message.ts +104 -104
  60. package/src/cli/commands/operator-shared.ts +62 -18
  61. package/src/cli/commands/poll.ts +58 -58
  62. package/src/cli/commands/purge-all-memory.ts +85 -85
  63. package/src/cli/commands/purge-project-memory.ts +83 -83
  64. package/src/cli/commands/reasoning.ts +118 -118
  65. package/src/cli/commands/setup.ts +57 -2
  66. package/src/cli/commands/skills.ts +114 -114
  67. package/src/cli/commands/task.ts +167 -167
  68. package/src/cli/commands/transfer.ts +47 -47
  69. package/src/cli/commands/uninstall-project-artifacts.ts +85 -85
  70. package/src/cli/commands/uninstall.ts +20 -0
  71. package/src/cli/tui/ChatView.tsx +234 -234
  72. package/src/cli/tui/CommandBar.tsx +312 -312
  73. package/src/cli/tui/ContextRail.tsx +118 -118
  74. package/src/cli/tui/HeaderBar.tsx +72 -72
  75. package/src/cli/tui/LogoBanner.tsx +51 -51
  76. package/src/cli/tui/Sidebar.tsx +179 -179
  77. package/src/cli/tui/index.ts +41 -41
  78. package/src/cli/tui/markdown-render.tsx +371 -371
  79. package/src/cli/tui/use-mouse.ts +157 -157
  80. package/src/cli/tui/useNavigation.ts +56 -56
  81. package/src/cli/version.ts +7 -7
  82. package/src/cli/workbench.ts +1 -1
  83. package/src/dashboard/project-classification.ts +64 -64
  84. package/src/git/hooks-path.ts +85 -85
  85. package/src/hooks/installers/index.ts +43 -2
  86. package/src/hooks/pattern-detector.ts +173 -173
  87. package/src/hooks/significance-filter.ts +250 -250
  88. package/src/hooks/types.ts +2 -0
  89. package/src/integrations/registry.ts +9 -0
  90. package/src/llm/memory-manager.ts +328 -328
  91. package/src/llm/provider.ts +885 -885
  92. package/src/llm/quality.ts +248 -248
  93. package/src/media/minimax.ts +9 -1
  94. package/src/memory/attribution-guard.ts +249 -249
  95. package/src/memory/disclosure-policy.ts +135 -135
  96. package/src/memory/entity-extractor.ts +197 -197
  97. package/src/memory/formation/evaluate.ts +217 -217
  98. package/src/memory/formation/extract.ts +361 -361
  99. package/src/memory/formation/index.ts +417 -417
  100. package/src/memory/formation/resolve.ts +344 -344
  101. package/src/memory/formation/types.ts +315 -315
  102. package/src/memory/freshness.ts +122 -122
  103. package/src/memory/graph.ts +197 -197
  104. package/src/memory/refs.ts +94 -94
  105. package/src/memory/secret-filter.ts +79 -79
  106. package/src/orchestrate/adapters/claude-stream.ts +192 -192
  107. package/src/orchestrate/adapters/claude.ts +111 -111
  108. package/src/orchestrate/adapters/codex-stream.ts +134 -134
  109. package/src/orchestrate/adapters/codex.ts +41 -41
  110. package/src/orchestrate/adapters/gemini-stream.ts +166 -166
  111. package/src/orchestrate/adapters/gemini.ts +42 -42
  112. package/src/orchestrate/adapters/index.ts +73 -73
  113. package/src/orchestrate/adapters/opencode-stream.ts +143 -143
  114. package/src/orchestrate/adapters/opencode.ts +47 -47
  115. package/src/orchestrate/adapters/types.ts +77 -77
  116. package/src/orchestrate/capability-router.ts +284 -284
  117. package/src/orchestrate/context-compact.ts +188 -188
  118. package/src/orchestrate/cost-tracker.ts +219 -219
  119. package/src/orchestrate/error-recovery.ts +191 -191
  120. package/src/orchestrate/evidence.ts +140 -140
  121. package/src/orchestrate/ledger.ts +110 -110
  122. package/src/orchestrate/memorix-bridge.ts +343 -343
  123. package/src/orchestrate/output-budget.ts +80 -80
  124. package/src/orchestrate/permission.ts +152 -152
  125. package/src/orchestrate/pipeline-trace.ts +131 -131
  126. package/src/orchestrate/prompt-builder.ts +155 -155
  127. package/src/orchestrate/ring-buffer.ts +37 -37
  128. package/src/orchestrate/task-graph.ts +389 -389
  129. package/src/project/aliases.ts +374 -374
  130. package/src/rules/adapters/trae.ts +56 -56
  131. package/src/rules/syncer.ts +235 -235
  132. package/src/search/query-expansion.ts +52 -52
  133. package/src/server/formation-timeout.ts +27 -27
  134. package/src/server.ts +23 -1
  135. package/src/skills/mini-skills.ts +386 -386
  136. package/src/store/chat-store.ts +119 -119
  137. package/src/store/graph-store.ts +249 -249
  138. package/src/store/mini-skill-store.ts +349 -349
  139. package/src/store/persistence-json.ts +212 -212
  140. package/src/store/persistence.ts +291 -291
  141. package/src/store/project-affinity.ts +195 -195
  142. package/src/team/event-bus.ts +76 -76
  143. package/src/team/file-locks.ts +173 -173
  144. package/src/team/handoff.ts +161 -161
  145. package/src/team/messages.ts +203 -203
  146. package/src/team/poll.ts +132 -132
  147. package/src/team/tasks.ts +211 -211
  148. package/src/types.ts +1 -1
  149. package/src/workspace/mcp-adapters/codex.ts +191 -191
  150. package/src/workspace/mcp-adapters/copilot.ts +105 -105
  151. package/src/workspace/mcp-adapters/cursor.ts +53 -53
  152. package/src/workspace/mcp-adapters/dsh.ts +147 -0
  153. package/src/workspace/mcp-adapters/kiro.ts +64 -64
  154. package/src/workspace/mcp-adapters/opencode.ts +123 -123
  155. package/src/workspace/mcp-adapters/trae.ts +134 -134
  156. package/src/workspace/mcp-adapters/windsurf.ts +91 -91
  157. package/src/workspace/sanitizer.ts +60 -60
  158. package/dist/memcode-runtime/docs/images/exy.png +0 -0
@@ -35,28 +35,28 @@ async function writeExportPayload(projectRoot: string, output: string, payload:
35
35
  await fs.writeFile(outputPath, payload, 'utf8');
36
36
  return outputPath;
37
37
  }
38
-
39
- export default defineCommand({
40
- meta: {
41
- name: 'transfer',
42
- description: 'Export or import project memory snapshots',
43
- },
44
- args: {
38
+
39
+ export default defineCommand({
40
+ meta: {
41
+ name: 'transfer',
42
+ description: 'Export or import project memory snapshots',
43
+ },
44
+ args: {
45
45
  format: { type: 'string', description: 'Export format: json or markdown' },
46
46
  data: { type: 'string', description: 'JSON payload from a previous export' },
47
47
  file: { type: 'string', description: 'File containing a JSON payload to import' },
48
48
  stdin: { type: 'boolean', description: 'Read a JSON import payload from standard input' },
49
49
  out: { type: 'string', description: 'Write the export payload to this file instead of stdout' },
50
- json: { type: 'boolean', description: 'Emit machine-readable JSON output' },
51
- },
52
- run: async ({ args }) => {
53
- const action = (args._ as string[])?.[0] || '';
54
- const asJson = !!args.json;
55
-
56
- try {
50
+ json: { type: 'boolean', description: 'Emit machine-readable JSON output' },
51
+ },
52
+ run: async ({ args }) => {
53
+ const action = (args._ as string[])?.[0] || '';
54
+ const asJson = !!args.json;
55
+
56
+ try {
57
57
  const { project, dataDir, reader } = await getCliProjectContext();
58
-
59
- switch (action) {
58
+
59
+ switch (action) {
60
60
  case 'export': {
61
61
  const format = (args.format as string | undefined) === 'markdown' ? 'markdown' : 'json';
62
62
  if (format === 'markdown') {
@@ -87,40 +87,40 @@ export default defineCommand({
87
87
  serialized,
88
88
  asJson,
89
89
  );
90
- return;
91
- }
92
-
93
- case 'import': {
90
+ return;
91
+ }
92
+
93
+ case 'import': {
94
94
  const raw = (await readImportPayload(args as Record<string, unknown>, project.rootPath)).trim();
95
95
  if (!raw) throw new Error('Import payload is empty.');
96
- let parsed: Parameters<typeof importFromJson>[1];
97
- try {
98
- parsed = JSON.parse(raw);
99
- } catch (error) {
100
- emitError(`Invalid JSON import payload: ${error instanceof Error ? error.message : String(error)}`, asJson);
101
- return;
102
- }
103
- const result = await importFromJson(dataDir, parsed);
104
- emitResult(
105
- { project, result },
106
- `Import complete: ${result.observationsImported} observation(s), ${result.sessionsImported} session(s), ${result.skipped} skipped.`,
107
- asJson,
108
- );
109
- return;
110
- }
111
-
112
- default:
113
- console.log('Memorix Transfer Commands');
114
- console.log('');
115
- console.log('Usage:');
96
+ let parsed: Parameters<typeof importFromJson>[1];
97
+ try {
98
+ parsed = JSON.parse(raw);
99
+ } catch (error) {
100
+ emitError(`Invalid JSON import payload: ${error instanceof Error ? error.message : String(error)}`, asJson);
101
+ return;
102
+ }
103
+ const result = await importFromJson(dataDir, parsed);
104
+ emitResult(
105
+ { project, result },
106
+ `Import complete: ${result.observationsImported} observation(s), ${result.sessionsImported} session(s), ${result.skipped} skipped.`,
107
+ asJson,
108
+ );
109
+ return;
110
+ }
111
+
112
+ default:
113
+ console.log('Memorix Transfer Commands');
114
+ console.log('');
115
+ console.log('Usage:');
116
116
  console.log(' memorix transfer export [--format json|markdown] [--out ./.memorix-export.json]');
117
117
  console.log(' memorix transfer import --file ./.memorix-export.json');
118
118
  console.log(' memorix transfer import --stdin');
119
119
  console.log(' memorix transfer import --data "<json>"');
120
- }
121
- } catch (error) {
122
- emitError(error instanceof Error ? error.message : String(error), asJson);
123
- }
124
- },
125
- });
126
-
120
+ }
121
+ } catch (error) {
122
+ emitError(error instanceof Error ? error.message : String(error), asJson);
123
+ }
124
+ },
125
+ });
126
+
@@ -1,86 +1,86 @@
1
- /**
2
- * CLI Command: memorix uninstall project-artifacts
3
- *
4
- * Uninstall project-level hook files only (preserve memory data).
5
- */
6
-
7
- import { defineCommand } from 'citty';
8
- import * as p from '@clack/prompts';
9
-
10
- export default defineCommand({
11
- meta: {
12
- name: 'project-artifacts',
13
- description: 'Uninstall project hook files (preserve memory data)',
14
- },
15
- args: {
16
- agent: {
17
- type: 'string',
18
- description: 'Target agent (all if omitted)',
19
- required: false,
20
- },
21
- },
22
- run: async ({ args }) => {
23
- const { detectInstalledAgents, uninstallHooks } = await import('../../hooks/installers/index.js');
24
- const os = await import('node:os');
25
- let cwd: string;
26
- try { cwd = process.cwd(); } catch { cwd = os.homedir(); }
27
-
28
- p.intro('Uninstall Project Artifacts');
29
-
30
- let agents: string[];
31
- if (args.agent) {
32
- agents = [args.agent];
33
- } else {
34
- agents = await detectInstalledAgents();
35
- }
36
-
37
- if (agents.length === 0) {
38
- console.log('No supported agents detected.');
39
- return;
40
- }
41
-
42
- // Show what will be uninstalled
43
- console.log('');
44
- console.log('Will uninstall hooks for:');
45
- for (const agent of agents) {
46
- console.log(` - ${agent}`);
47
- }
48
- console.log('');
49
- console.log('This will remove hook files from the project:');
50
- console.log(' - .claude/settings.local.json');
51
- console.log(' - .windsurf/hooks.json');
52
- console.log(' - .cursor/hooks.json');
53
- console.log(' - .github/hooks/memorix.json');
54
- console.log(' - .cursor/rules/memorix.mdc');
55
- console.log(' - etc.');
56
- console.log('');
57
- console.log('Memory data will be preserved.');
58
- console.log('');
59
-
60
- // Confirm
61
- const confirmed = await p.confirm({
62
- message: 'Continue uninstall?',
63
- });
64
-
65
- if (p.isCancel(confirmed) || !confirmed) {
66
- p.outro('Uninstall cancelled.');
67
- return;
68
- }
69
-
70
- // Uninstall
71
- for (const agent of agents) {
72
- const ok = await uninstallHooks(
73
- agent as import('../../hooks/types.js').AgentName,
74
- cwd,
75
- false, // project-level
76
- );
77
- if (ok) {
78
- console.log(`[OK] ${agent}: hooks removed`);
79
- } else {
1
+ /**
2
+ * CLI Command: memorix uninstall project-artifacts
3
+ *
4
+ * Uninstall project-level hook files only (preserve memory data).
5
+ */
6
+
7
+ import { defineCommand } from 'citty';
8
+ import * as p from '@clack/prompts';
9
+
10
+ export default defineCommand({
11
+ meta: {
12
+ name: 'project-artifacts',
13
+ description: 'Uninstall project hook files (preserve memory data)',
14
+ },
15
+ args: {
16
+ agent: {
17
+ type: 'string',
18
+ description: 'Target agent (all if omitted)',
19
+ required: false,
20
+ },
21
+ },
22
+ run: async ({ args }) => {
23
+ const { detectInstalledAgents, uninstallHooks } = await import('../../hooks/installers/index.js');
24
+ const os = await import('node:os');
25
+ let cwd: string;
26
+ try { cwd = process.cwd(); } catch { cwd = os.homedir(); }
27
+
28
+ p.intro('Uninstall Project Artifacts');
29
+
30
+ let agents: string[];
31
+ if (args.agent) {
32
+ agents = [args.agent];
33
+ } else {
34
+ agents = await detectInstalledAgents();
35
+ }
36
+
37
+ if (agents.length === 0) {
38
+ console.log('No supported agents detected.');
39
+ return;
40
+ }
41
+
42
+ // Show what will be uninstalled
43
+ console.log('');
44
+ console.log('Will uninstall hooks for:');
45
+ for (const agent of agents) {
46
+ console.log(` - ${agent}`);
47
+ }
48
+ console.log('');
49
+ console.log('This will remove hook files from the project:');
50
+ console.log(' - .claude/settings.local.json');
51
+ console.log(' - .windsurf/hooks.json');
52
+ console.log(' - .cursor/hooks.json');
53
+ console.log(' - .github/hooks/memorix.json');
54
+ console.log(' - .cursor/rules/memorix.mdc');
55
+ console.log(' - etc.');
56
+ console.log('');
57
+ console.log('Memory data will be preserved.');
58
+ console.log('');
59
+
60
+ // Confirm
61
+ const confirmed = await p.confirm({
62
+ message: 'Continue uninstall?',
63
+ });
64
+
65
+ if (p.isCancel(confirmed) || !confirmed) {
66
+ p.outro('Uninstall cancelled.');
67
+ return;
68
+ }
69
+
70
+ // Uninstall
71
+ for (const agent of agents) {
72
+ const ok = await uninstallHooks(
73
+ agent as import('../../hooks/types.js').AgentName,
74
+ cwd,
75
+ false, // project-level
76
+ );
77
+ if (ok) {
78
+ console.log(`[OK] ${agent}: hooks removed`);
79
+ } else {
80
80
  console.log(`[SKIP] ${agent}: no hooks found`);
81
- }
82
- }
83
-
84
- p.outro('Project artifacts uninstalled. Memory data preserved.');
85
- },
86
- });
81
+ }
82
+ }
83
+
84
+ p.outro('Project artifacts uninstalled. Memory data preserved.');
85
+ },
86
+ });
@@ -56,6 +56,15 @@ function checkTOML(p: string): boolean {
56
56
  } catch { return false; }
57
57
  }
58
58
 
59
+ function checkDshPatch(p: string): boolean {
60
+ if (!exists(p)) return false;
61
+ try {
62
+ const content = fs.readFileSync(p, 'utf-8');
63
+ if (!content.includes('memory-memorix')) return false;
64
+ return /serverName:\s*['"]?memorix['"]?/.test(content);
65
+ } catch { return false; }
66
+ }
67
+
59
68
  /** Detects memorix MCP config entries in both global and project-level paths. */
60
69
  function getMCPConfigEntries(home: string, cwd: string): MCPConfigEntry[] {
61
70
  const entries: MCPConfigEntry[] = [];
@@ -216,6 +225,17 @@ function getMCPConfigEntries(home: string, cwd: string): MCPConfigEntry[] {
216
225
  note: 'Remove the "memorix" key from mcpServers in this file.',
217
226
  });
218
227
 
228
+ // DeepSeek Harness
229
+ const dshPatchPath = path.join(process.env.DSH_HOME?.trim() || path.join(home, '.dsh'), 'cordis.patch.yml');
230
+ entries.push({
231
+ agent: 'DeepSeek Harness',
232
+ path: dshPatchPath,
233
+ kind: 'global',
234
+ format: 'json',
235
+ detected: checkDshPatch(dshPatchPath),
236
+ note: 'Remove the memory-memorix insert row from this patch file.',
237
+ });
238
+
219
239
  return entries;
220
240
  }
221
241