memorix 1.1.7 → 1.1.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.
Files changed (174) hide show
  1. package/CHANGELOG.md +13 -0
  2. package/CLAUDE.md +6 -1
  3. package/README.md +21 -0
  4. package/README.zh-CN.md +21 -0
  5. package/TEAM.md +86 -86
  6. package/dist/cli/index.js +730 -150
  7. package/dist/cli/index.js.map +1 -1
  8. package/dist/dashboard/static/index.html +201 -201
  9. package/dist/dashboard/static/style.css +3584 -3584
  10. package/dist/index.js +15 -8
  11. package/dist/index.js.map +1 -1
  12. package/dist/memcode-runtime/CHANGELOG.md +13 -0
  13. package/dist/memcode-runtime/package.json +4 -4
  14. package/dist/sdk.js +15 -8
  15. package/dist/sdk.js.map +1 -1
  16. package/docs/AGENT_OPERATOR_PLAYBOOK.md +18 -0
  17. package/docs/DESIGN_DECISIONS.md +357 -357
  18. package/docs/SETUP.md +10 -0
  19. package/docs/dev-log/progress.txt +35 -26
  20. package/package.json +1 -1
  21. package/src/audit/index.ts +156 -156
  22. package/src/cli/commands/agent-integrations.ts +623 -0
  23. package/src/cli/commands/audit-list.ts +89 -89
  24. package/src/cli/commands/background.ts +659 -659
  25. package/src/cli/commands/cleanup.ts +255 -255
  26. package/src/cli/commands/doctor.ts +23 -0
  27. package/src/cli/commands/formation.ts +48 -48
  28. package/src/cli/commands/git-hook-install.ts +111 -111
  29. package/src/cli/commands/handoff.ts +66 -66
  30. package/src/cli/commands/hooks-status.ts +63 -63
  31. package/src/cli/commands/ingest-commit.ts +153 -153
  32. package/src/cli/commands/ingest-image.ts +73 -73
  33. package/src/cli/commands/ingest-log.ts +180 -180
  34. package/src/cli/commands/ingest.ts +44 -44
  35. package/src/cli/commands/integrate-shared.ts +15 -15
  36. package/src/cli/commands/lock.ts +96 -96
  37. package/src/cli/commands/message.ts +121 -121
  38. package/src/cli/commands/poll.ts +70 -70
  39. package/src/cli/commands/purge-all-memory.ts +85 -85
  40. package/src/cli/commands/purge-project-memory.ts +83 -83
  41. package/src/cli/commands/reasoning.ts +132 -132
  42. package/src/cli/commands/repair.ts +60 -0
  43. package/src/cli/commands/retention.ts +108 -108
  44. package/src/cli/commands/serve-shared.ts +118 -118
  45. package/src/cli/commands/setup.ts +3 -3
  46. package/src/cli/commands/skills.ts +123 -123
  47. package/src/cli/commands/task.ts +192 -192
  48. package/src/cli/commands/transfer.ts +73 -73
  49. package/src/cli/commands/uninstall-project-artifacts.ts +85 -85
  50. package/src/cli/index.ts +3 -1
  51. package/src/cli/tui/ChatView.tsx +234 -234
  52. package/src/cli/tui/CommandBar.tsx +312 -312
  53. package/src/cli/tui/ContextRail.tsx +118 -118
  54. package/src/cli/tui/HeaderBar.tsx +72 -72
  55. package/src/cli/tui/LogoBanner.tsx +51 -51
  56. package/src/cli/tui/Panels.tsx +632 -632
  57. package/src/cli/tui/Sidebar.tsx +179 -179
  58. package/src/cli/tui/chat-service.ts +742 -742
  59. package/src/cli/tui/data.ts +547 -547
  60. package/src/cli/tui/index.ts +41 -41
  61. package/src/cli/tui/markdown-render.tsx +371 -371
  62. package/src/cli/tui/theme.ts +178 -178
  63. package/src/cli/tui/use-mouse.ts +157 -157
  64. package/src/cli/tui/useNavigation.ts +56 -56
  65. package/src/cli/update-checker.ts +211 -211
  66. package/src/cli/version.ts +7 -7
  67. package/src/cli/workbench.ts +1 -1
  68. package/src/codegraph/context-pack.ts +5 -1
  69. package/src/codegraph/lite-provider.ts +5 -1
  70. package/src/codegraph/project-context.ts +5 -1
  71. package/src/compact/token-budget.ts +74 -74
  72. package/src/config/behavior.ts +59 -59
  73. package/src/dashboard/project-classification.ts +64 -64
  74. package/src/dashboard/static/index.html +201 -201
  75. package/src/dashboard/static/style.css +3584 -3584
  76. package/src/embedding/fastembed-provider.ts +142 -142
  77. package/src/embedding/transformers-provider.ts +111 -111
  78. package/src/git/extractor.ts +209 -209
  79. package/src/git/hooks-path.ts +85 -85
  80. package/src/git/noise-filter.ts +210 -210
  81. package/src/hooks/installers/index.ts +4 -4
  82. package/src/hooks/official-skills.ts +1 -1
  83. package/src/hooks/pattern-detector.ts +173 -173
  84. package/src/hooks/rules/memorix-agent-rules.md +2 -2
  85. package/src/hooks/significance-filter.ts +250 -250
  86. package/src/llm/memory-manager.ts +328 -328
  87. package/src/llm/provider.ts +885 -885
  88. package/src/llm/quality.ts +248 -248
  89. package/src/memory/attribution-guard.ts +249 -249
  90. package/src/memory/auto-relations.ts +107 -107
  91. package/src/memory/consolidation.ts +302 -302
  92. package/src/memory/disclosure-policy.ts +141 -141
  93. package/src/memory/entity-extractor.ts +197 -197
  94. package/src/memory/formation/evaluate.ts +217 -217
  95. package/src/memory/formation/extract.ts +361 -361
  96. package/src/memory/formation/index.ts +417 -417
  97. package/src/memory/formation/resolve.ts +344 -344
  98. package/src/memory/formation/types.ts +315 -315
  99. package/src/memory/freshness.ts +122 -122
  100. package/src/memory/graph.ts +197 -197
  101. package/src/memory/refs.ts +94 -94
  102. package/src/memory/retention.ts +433 -433
  103. package/src/memory/secret-filter.ts +79 -79
  104. package/src/memory/session.ts +523 -523
  105. package/src/multimodal/image-loader.ts +143 -143
  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/spawn-helper.ts +286 -286
  116. package/src/orchestrate/adapters/types.ts +77 -77
  117. package/src/orchestrate/capability-router.ts +284 -284
  118. package/src/orchestrate/context-compact.ts +188 -188
  119. package/src/orchestrate/cost-tracker.ts +219 -219
  120. package/src/orchestrate/error-recovery.ts +191 -191
  121. package/src/orchestrate/evidence.ts +140 -140
  122. package/src/orchestrate/ledger.ts +110 -110
  123. package/src/orchestrate/memorix-bridge.ts +380 -380
  124. package/src/orchestrate/output-budget.ts +80 -80
  125. package/src/orchestrate/permission.ts +152 -152
  126. package/src/orchestrate/pipeline-trace.ts +131 -131
  127. package/src/orchestrate/prompt-builder.ts +155 -155
  128. package/src/orchestrate/ring-buffer.ts +37 -37
  129. package/src/orchestrate/task-graph.ts +389 -389
  130. package/src/orchestrate/verify-gate.ts +219 -219
  131. package/src/orchestrate/worktree.ts +232 -232
  132. package/src/project/aliases.ts +374 -374
  133. package/src/project/detector.ts +268 -268
  134. package/src/rules/adapters/claude-code.ts +99 -99
  135. package/src/rules/adapters/codex.ts +97 -97
  136. package/src/rules/adapters/copilot.ts +124 -124
  137. package/src/rules/adapters/cursor.ts +114 -114
  138. package/src/rules/adapters/kiro.ts +126 -126
  139. package/src/rules/adapters/trae.ts +56 -56
  140. package/src/rules/adapters/windsurf.ts +83 -83
  141. package/src/rules/syncer.ts +235 -235
  142. package/src/sdk.ts +327 -327
  143. package/src/search/intent-detector.ts +289 -289
  144. package/src/search/query-expansion.ts +52 -52
  145. package/src/server/formation-timeout.ts +27 -27
  146. package/src/skills/mini-skills.ts +386 -386
  147. package/src/store/chat-store.ts +119 -119
  148. package/src/store/file-lock.ts +100 -100
  149. package/src/store/graph-store.ts +249 -249
  150. package/src/store/mini-skill-store.ts +349 -349
  151. package/src/store/obs-store.ts +255 -255
  152. package/src/store/persistence-json.ts +212 -212
  153. package/src/store/persistence.ts +291 -291
  154. package/src/store/project-affinity.ts +195 -195
  155. package/src/store/session-store.ts +259 -259
  156. package/src/store/sqlite-store.ts +339 -339
  157. package/src/team/event-bus.ts +76 -76
  158. package/src/team/file-locks.ts +173 -173
  159. package/src/team/handoff.ts +167 -167
  160. package/src/team/messages.ts +203 -203
  161. package/src/team/poll.ts +132 -132
  162. package/src/team/tasks.ts +211 -211
  163. package/src/wiki/generator.ts +237 -237
  164. package/src/wiki/knowledge-graph.ts +334 -334
  165. package/src/wiki/types.ts +85 -85
  166. package/src/workspace/mcp-adapters/codex.ts +191 -191
  167. package/src/workspace/mcp-adapters/copilot.ts +105 -105
  168. package/src/workspace/mcp-adapters/cursor.ts +53 -53
  169. package/src/workspace/mcp-adapters/kiro.ts +64 -64
  170. package/src/workspace/mcp-adapters/opencode.ts +123 -123
  171. package/src/workspace/mcp-adapters/trae.ts +134 -134
  172. package/src/workspace/mcp-adapters/windsurf.ts +91 -91
  173. package/src/workspace/sanitizer.ts +60 -60
  174. package/src/workspace/workflow-sync.ts +131 -131
@@ -1,73 +1,73 @@
1
- import { defineCommand } from 'citty';
2
- import { exportAsJson, exportAsMarkdown, importFromJson } from '../../memory/export-import.js';
3
- import { emitError, emitResult, getCliProjectContext } from './operator-shared.js';
4
-
5
- export default defineCommand({
6
- meta: {
7
- name: 'transfer',
8
- description: 'Export or import project memory snapshots',
9
- },
10
- args: {
11
- format: { type: 'string', description: 'Export format: json or markdown' },
12
- data: { type: 'string', description: 'JSON payload from a previous export' },
13
- json: { type: 'boolean', description: 'Emit machine-readable JSON output' },
14
- },
15
- run: async ({ args }) => {
16
- const action = (args._ as string[])?.[0] || '';
17
- const asJson = !!args.json;
18
-
19
- try {
20
- const { project, dataDir } = await getCliProjectContext();
21
-
22
- switch (action) {
23
- case 'export': {
24
- const format = (args.format as string | undefined) === 'markdown' ? 'markdown' : 'json';
25
- if (format === 'markdown') {
26
- const markdown = await exportAsMarkdown(dataDir, project.id);
27
- emitResult({ project, format, markdown }, markdown, asJson);
28
- return;
29
- }
30
- const exported = await exportAsJson(dataDir, project.id);
31
- emitResult(
32
- { project, format, export: exported },
33
- JSON.stringify(exported, null, 2),
34
- asJson,
35
- );
36
- return;
37
- }
38
-
39
- case 'import': {
40
- const raw = (args.data as string | undefined)?.trim();
41
- if (!raw) {
42
- emitError('data is required for "memorix transfer import"', asJson);
43
- return;
44
- }
45
- let parsed: Parameters<typeof importFromJson>[1];
46
- try {
47
- parsed = JSON.parse(raw);
48
- } catch (error) {
49
- emitError(`Invalid JSON import payload: ${error instanceof Error ? error.message : String(error)}`, asJson);
50
- return;
51
- }
52
- const result = await importFromJson(dataDir, parsed);
53
- emitResult(
54
- { project, result },
55
- `Import complete: ${result.observationsImported} observation(s), ${result.sessionsImported} session(s), ${result.skipped} skipped.`,
56
- asJson,
57
- );
58
- return;
59
- }
60
-
61
- default:
62
- console.log('Memorix Transfer Commands');
63
- console.log('');
64
- console.log('Usage:');
65
- console.log(' memorix transfer export [--format json|markdown]');
66
- console.log(' memorix transfer import --data "<json>"');
67
- }
68
- } catch (error) {
69
- emitError(error instanceof Error ? error.message : String(error), asJson);
70
- }
71
- },
72
- });
73
-
1
+ import { defineCommand } from 'citty';
2
+ import { exportAsJson, exportAsMarkdown, importFromJson } from '../../memory/export-import.js';
3
+ import { emitError, emitResult, getCliProjectContext } from './operator-shared.js';
4
+
5
+ export default defineCommand({
6
+ meta: {
7
+ name: 'transfer',
8
+ description: 'Export or import project memory snapshots',
9
+ },
10
+ args: {
11
+ format: { type: 'string', description: 'Export format: json or markdown' },
12
+ data: { type: 'string', description: 'JSON payload from a previous export' },
13
+ json: { type: 'boolean', description: 'Emit machine-readable JSON output' },
14
+ },
15
+ run: async ({ args }) => {
16
+ const action = (args._ as string[])?.[0] || '';
17
+ const asJson = !!args.json;
18
+
19
+ try {
20
+ const { project, dataDir } = await getCliProjectContext();
21
+
22
+ switch (action) {
23
+ case 'export': {
24
+ const format = (args.format as string | undefined) === 'markdown' ? 'markdown' : 'json';
25
+ if (format === 'markdown') {
26
+ const markdown = await exportAsMarkdown(dataDir, project.id);
27
+ emitResult({ project, format, markdown }, markdown, asJson);
28
+ return;
29
+ }
30
+ const exported = await exportAsJson(dataDir, project.id);
31
+ emitResult(
32
+ { project, format, export: exported },
33
+ JSON.stringify(exported, null, 2),
34
+ asJson,
35
+ );
36
+ return;
37
+ }
38
+
39
+ case 'import': {
40
+ const raw = (args.data as string | undefined)?.trim();
41
+ if (!raw) {
42
+ emitError('data is required for "memorix transfer import"', asJson);
43
+ return;
44
+ }
45
+ let parsed: Parameters<typeof importFromJson>[1];
46
+ try {
47
+ parsed = JSON.parse(raw);
48
+ } catch (error) {
49
+ emitError(`Invalid JSON import payload: ${error instanceof Error ? error.message : String(error)}`, asJson);
50
+ return;
51
+ }
52
+ const result = await importFromJson(dataDir, parsed);
53
+ emitResult(
54
+ { project, result },
55
+ `Import complete: ${result.observationsImported} observation(s), ${result.sessionsImported} session(s), ${result.skipped} skipped.`,
56
+ asJson,
57
+ );
58
+ return;
59
+ }
60
+
61
+ default:
62
+ console.log('Memorix Transfer Commands');
63
+ console.log('');
64
+ console.log('Usage:');
65
+ console.log(' memorix transfer export [--format json|markdown]');
66
+ console.log(' memorix transfer import --data "<json>"');
67
+ }
68
+ } catch (error) {
69
+ emitError(error instanceof Error ? error.message : String(error), asJson);
70
+ }
71
+ },
72
+ });
73
+
@@ -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
+ });
package/src/cli/index.ts CHANGED
@@ -1025,6 +1025,7 @@ const main = defineCommand({
1025
1025
  },
1026
1026
  })),
1027
1027
  doctor: () => import('./commands/doctor.js').then(m => m.default),
1028
+ repair: () => import('./commands/repair.js').then(m => m.default),
1028
1029
  dashboard: () => import('./commands/dashboard.js').then(m => m.default),
1029
1030
  cleanup: () => import('./commands/cleanup.js').then(m => m.default),
1030
1031
  uninstall: () => import('./commands/uninstall.js').then(m => m.default),
@@ -1052,7 +1053,7 @@ const main = defineCommand({
1052
1053
  'receipt',
1053
1054
  'serve', 'serve-http', 'status', 'sync',
1054
1055
  'hook', 'hooks', 'ingest', 'git-hook', 'git-hook-uninstall',
1055
- 'background', 'bg', 'bs', 'doctor', 'dashboard', 'cleanup', 'uninstall', 'orchestrate'];
1056
+ 'background', 'bg', 'bs', 'doctor', 'repair', 'dashboard', 'cleanup', 'uninstall', 'orchestrate'];
1056
1057
  if (firstArg && knownSubs.includes(firstArg)) return;
1057
1058
 
1058
1059
  // No subcommand provided — enter memcode TUI (native coding agent)
@@ -1104,6 +1105,7 @@ const main = defineCommand({
1104
1105
  console.error(' serve Start MCP server on stdio');
1105
1106
  console.error(' init Create global defaults or project config');
1106
1107
  console.error(' setup Install Memorix plugin/MCP/rules/hooks for an agent');
1108
+ console.error(' repair Repair Memorix-owned agent integration files');
1107
1109
  console.error(' config Show TOML config paths and resolved values');
1108
1110
  console.error(' integrate Install one IDE integration into the current repo');
1109
1111
  console.error(' status Show project info + stats');