memorix 1.2.0 → 1.2.2

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 (212) hide show
  1. package/CHANGELOG.md +30 -1
  2. package/README.md +18 -4
  3. package/README.zh-CN.md +18 -4
  4. package/TEAM.md +86 -86
  5. package/dist/cli/index.js +15919 -14055
  6. package/dist/cli/index.js.map +1 -1
  7. package/dist/index.js +1997 -1021
  8. package/dist/index.js.map +1 -1
  9. package/dist/maintenance-runner.d.ts +1 -1
  10. package/dist/maintenance-runner.js +8481 -8005
  11. package/dist/maintenance-runner.js.map +1 -1
  12. package/dist/memcode-runtime/CHANGELOG.md +30 -1
  13. package/dist/sdk.d.ts +7 -2
  14. package/dist/sdk.js +2022 -1024
  15. package/dist/sdk.js.map +1 -1
  16. package/dist/types.d.ts +49 -1
  17. package/dist/types.js.map +1 -1
  18. package/docs/1.2.2-MEMORY-CONTROL-PLANE.md +434 -0
  19. package/docs/AGENT_OPERATOR_PLAYBOOK.md +4 -0
  20. package/docs/API_REFERENCE.md +27 -5
  21. package/docs/DESIGN_DECISIONS.md +357 -357
  22. package/docs/DEVELOPMENT.md +4 -0
  23. package/docs/README.md +1 -1
  24. package/docs/SETUP.md +7 -1
  25. package/docs/dev-log/progress.txt +91 -11
  26. package/docs/knowledge/workflows/memorix-release.md +57 -0
  27. package/package.json +1 -1
  28. package/plugins/codex/memorix/.codex-plugin/plugin.json +1 -1
  29. package/src/audit/index.ts +156 -156
  30. package/src/cli/command-guide.ts +192 -0
  31. package/src/cli/commands/audit-list.ts +89 -89
  32. package/src/cli/commands/audit.ts +9 -4
  33. package/src/cli/commands/background.ts +659 -659
  34. package/src/cli/commands/cleanup.ts +5 -1
  35. package/src/cli/commands/codegraph.ts +17 -8
  36. package/src/cli/commands/context.ts +3 -2
  37. package/src/cli/commands/doctor.ts +4 -2
  38. package/src/cli/commands/explain.ts +9 -3
  39. package/src/cli/commands/formation.ts +48 -48
  40. package/src/cli/commands/git-hook-install.ts +111 -111
  41. package/src/cli/commands/handoff.ts +75 -61
  42. package/src/cli/commands/hooks-status.ts +63 -63
  43. package/src/cli/commands/identity.ts +116 -0
  44. package/src/cli/commands/ingest-commit.ts +153 -153
  45. package/src/cli/commands/ingest-image.ts +71 -69
  46. package/src/cli/commands/ingest-log.ts +180 -180
  47. package/src/cli/commands/ingest.ts +44 -44
  48. package/src/cli/commands/integrate-shared.ts +15 -15
  49. package/src/cli/commands/knowledge.ts +40 -0
  50. package/src/cli/commands/lock.ts +93 -92
  51. package/src/cli/commands/memory.ts +58 -21
  52. package/src/cli/commands/message.ts +123 -118
  53. package/src/cli/commands/operator-shared.ts +98 -3
  54. package/src/cli/commands/poll.ts +74 -64
  55. package/src/cli/commands/purge-all-memory.ts +85 -85
  56. package/src/cli/commands/purge-project-memory.ts +83 -83
  57. package/src/cli/commands/reasoning.ts +135 -121
  58. package/src/cli/commands/retention.ts +9 -4
  59. package/src/cli/commands/serve-http.ts +22 -43
  60. package/src/cli/commands/serve-shared.ts +118 -118
  61. package/src/cli/commands/session.ts +29 -3
  62. package/src/cli/commands/setup.ts +9 -3
  63. package/src/cli/commands/skills.ts +124 -119
  64. package/src/cli/commands/status.ts +4 -3
  65. package/src/cli/commands/task.ts +193 -184
  66. package/src/cli/commands/team.ts +14 -10
  67. package/src/cli/commands/transfer.ts +108 -55
  68. package/src/cli/commands/uninstall-project-artifacts.ts +85 -85
  69. package/src/cli/identity.ts +89 -0
  70. package/src/cli/index.ts +96 -19
  71. package/src/cli/invocation.ts +115 -0
  72. package/src/cli/tui/ChatView.tsx +234 -234
  73. package/src/cli/tui/CommandBar.tsx +312 -312
  74. package/src/cli/tui/ContextRail.tsx +118 -118
  75. package/src/cli/tui/HeaderBar.tsx +72 -72
  76. package/src/cli/tui/LogoBanner.tsx +51 -51
  77. package/src/cli/tui/Sidebar.tsx +179 -179
  78. package/src/cli/tui/chat-service.ts +41 -18
  79. package/src/cli/tui/data.ts +23 -44
  80. package/src/cli/tui/index.ts +41 -41
  81. package/src/cli/tui/markdown-render.tsx +371 -371
  82. package/src/cli/tui/operator-context.ts +60 -0
  83. package/src/cli/tui/use-mouse.ts +157 -157
  84. package/src/cli/tui/useNavigation.ts +56 -56
  85. package/src/cli/tui/views/MemoryView.tsx +10 -8
  86. package/src/cli/update-checker.ts +211 -211
  87. package/src/cli/version.ts +7 -7
  88. package/src/cli/workbench.ts +1 -1
  89. package/src/codegraph/auto-context.ts +34 -17
  90. package/src/codegraph/context-pack.ts +1 -0
  91. package/src/codegraph/current-facts.ts +19 -1
  92. package/src/codegraph/project-context.ts +2 -0
  93. package/src/codegraph/task-lens.ts +49 -5
  94. package/src/compact/engine.ts +26 -10
  95. package/src/compact/index-format.ts +25 -2
  96. package/src/compact/token-budget.ts +74 -74
  97. package/src/dashboard/project-classification.ts +64 -64
  98. package/src/dashboard/server.ts +58 -52
  99. package/src/embedding/fastembed-provider.ts +142 -142
  100. package/src/embedding/transformers-provider.ts +111 -111
  101. package/src/git/extractor.ts +209 -209
  102. package/src/git/hooks-path.ts +85 -85
  103. package/src/hooks/admission.ts +117 -0
  104. package/src/hooks/handler.ts +98 -91
  105. package/src/hooks/pattern-detector.ts +173 -173
  106. package/src/hooks/significance-filter.ts +250 -250
  107. package/src/knowledge/claims.ts +51 -1
  108. package/src/knowledge/context-assembly.ts +97 -0
  109. package/src/knowledge/types.ts +1 -0
  110. package/src/knowledge/workflows.ts +34 -3
  111. package/src/knowledge/workset.ts +179 -10
  112. package/src/llm/memory-manager.ts +328 -328
  113. package/src/llm/provider.ts +885 -885
  114. package/src/llm/quality.ts +248 -248
  115. package/src/memory/admission.ts +57 -0
  116. package/src/memory/attribution-guard.ts +249 -249
  117. package/src/memory/auto-relations.ts +21 -0
  118. package/src/memory/consolidation.ts +13 -2
  119. package/src/memory/disclosure-policy.ts +140 -135
  120. package/src/memory/entity-extractor.ts +197 -197
  121. package/src/memory/export-import.ts +11 -3
  122. package/src/memory/formation/evaluate.ts +217 -217
  123. package/src/memory/formation/extract.ts +361 -361
  124. package/src/memory/formation/index.ts +417 -417
  125. package/src/memory/formation/resolve.ts +344 -344
  126. package/src/memory/formation/types.ts +315 -315
  127. package/src/memory/freshness.ts +122 -122
  128. package/src/memory/graph-context.ts +8 -2
  129. package/src/memory/graph-scope.ts +46 -0
  130. package/src/memory/graph.ts +197 -197
  131. package/src/memory/observations.ts +162 -4
  132. package/src/memory/quality-audit.ts +2 -0
  133. package/src/memory/refs.ts +94 -94
  134. package/src/memory/retention.ts +22 -2
  135. package/src/memory/secret-filter.ts +79 -79
  136. package/src/memory/session.ts +5 -2
  137. package/src/memory/visibility.ts +80 -0
  138. package/src/multimodal/image-loader.ts +143 -143
  139. package/src/orchestrate/adapters/claude-stream.ts +192 -192
  140. package/src/orchestrate/adapters/claude.ts +111 -111
  141. package/src/orchestrate/adapters/codex-stream.ts +134 -134
  142. package/src/orchestrate/adapters/codex.ts +41 -41
  143. package/src/orchestrate/adapters/gemini-stream.ts +166 -166
  144. package/src/orchestrate/adapters/gemini.ts +42 -42
  145. package/src/orchestrate/adapters/index.ts +73 -73
  146. package/src/orchestrate/adapters/opencode-stream.ts +143 -143
  147. package/src/orchestrate/adapters/opencode.ts +47 -47
  148. package/src/orchestrate/adapters/spawn-helper.ts +286 -286
  149. package/src/orchestrate/adapters/types.ts +77 -77
  150. package/src/orchestrate/capability-router.ts +284 -284
  151. package/src/orchestrate/context-compact.ts +188 -188
  152. package/src/orchestrate/cost-tracker.ts +219 -219
  153. package/src/orchestrate/error-recovery.ts +191 -191
  154. package/src/orchestrate/evidence.ts +140 -140
  155. package/src/orchestrate/ledger.ts +110 -110
  156. package/src/orchestrate/memorix-bridge.ts +378 -340
  157. package/src/orchestrate/output-budget.ts +80 -80
  158. package/src/orchestrate/permission.ts +152 -152
  159. package/src/orchestrate/pipeline-trace.ts +131 -131
  160. package/src/orchestrate/prompt-builder.ts +155 -155
  161. package/src/orchestrate/ring-buffer.ts +37 -37
  162. package/src/orchestrate/task-graph.ts +389 -389
  163. package/src/orchestrate/verify-gate.ts +33 -10
  164. package/src/orchestrate/worktree.ts +232 -232
  165. package/src/project/aliases.ts +374 -374
  166. package/src/project/detector.ts +268 -268
  167. package/src/rules/adapters/claude-code.ts +99 -99
  168. package/src/rules/adapters/codex.ts +97 -97
  169. package/src/rules/adapters/copilot.ts +124 -124
  170. package/src/rules/adapters/cursor.ts +114 -114
  171. package/src/rules/adapters/kiro.ts +126 -126
  172. package/src/rules/adapters/trae.ts +56 -56
  173. package/src/rules/adapters/windsurf.ts +83 -83
  174. package/src/rules/syncer.ts +235 -235
  175. package/src/runtime/control-plane-maintenance.ts +1 -0
  176. package/src/runtime/isolated-maintenance.ts +1 -0
  177. package/src/runtime/lifecycle.ts +18 -0
  178. package/src/runtime/maintenance-jobs.ts +1 -0
  179. package/src/runtime/maintenance-runner.ts +2 -0
  180. package/src/runtime/project-maintenance.ts +89 -0
  181. package/src/sdk.ts +334 -304
  182. package/src/search/intent-detector.ts +289 -289
  183. package/src/search/query-expansion.ts +52 -52
  184. package/src/server/formation-timeout.ts +27 -27
  185. package/src/server.ts +334 -93
  186. package/src/skills/mini-skills.ts +386 -386
  187. package/src/store/chat-store.ts +119 -119
  188. package/src/store/graph-store.ts +249 -249
  189. package/src/store/mini-skill-store.ts +349 -349
  190. package/src/store/orama-store.ts +61 -6
  191. package/src/store/persistence-json.ts +212 -212
  192. package/src/store/persistence.ts +291 -291
  193. package/src/store/project-affinity.ts +195 -195
  194. package/src/store/sqlite-db.ts +23 -1
  195. package/src/store/sqlite-store.ts +12 -2
  196. package/src/team/event-bus.ts +76 -76
  197. package/src/team/file-locks.ts +173 -173
  198. package/src/team/handoff.ts +168 -161
  199. package/src/team/messages.ts +203 -203
  200. package/src/team/poll.ts +132 -132
  201. package/src/team/tasks.ts +211 -211
  202. package/src/types.ts +51 -0
  203. package/src/wiki/generator.ts +2 -0
  204. package/src/workspace/mcp-adapters/codex.ts +191 -191
  205. package/src/workspace/mcp-adapters/copilot.ts +105 -105
  206. package/src/workspace/mcp-adapters/cursor.ts +53 -53
  207. package/src/workspace/mcp-adapters/kiro.ts +64 -64
  208. package/src/workspace/mcp-adapters/opencode.ts +123 -123
  209. package/src/workspace/mcp-adapters/trae.ts +134 -134
  210. package/src/workspace/mcp-adapters/windsurf.ts +91 -91
  211. package/src/workspace/sanitizer.ts +60 -60
  212. package/src/workspace/workflow-sync.ts +131 -131
@@ -0,0 +1,60 @@
1
+ import { initTeamStore } from '../../team/team-store.js';
2
+ import { loadCliIdentity, resolveCliIdentity } from '../identity.js';
3
+ import { getCliInvocation } from '../invocation.js';
4
+ import type { CliProjectContext } from '../commands/operator-shared.js';
5
+
6
+ export type TuiOperatorContext = Omit<CliProjectContext, 'teamStore'>;
7
+
8
+ /**
9
+ * The Ink workbench is another CLI entry point, not an alternate security
10
+ * model. It uses the same identity resolver, but avoids opening coordination
11
+ * state until an actor was explicitly selected.
12
+ */
13
+ export async function getTuiOperatorContext(): Promise<TuiOperatorContext> {
14
+ const invocation = getCliInvocation();
15
+ const { detectProject } = await import('../../project/detector.js');
16
+ const project = detectProject(
17
+ invocation.projectRoot
18
+ ?? process.env.MEMORIX_PROJECT_ROOT
19
+ ?? process.cwd(),
20
+ );
21
+ if (!project) throw new Error('No git repository found in the current directory.');
22
+
23
+ const { getProjectDataDir } = await import('../../store/persistence.js');
24
+ const dataDir = await getProjectDataDir(project.id);
25
+ try {
26
+ const { MaintenanceTargetStore } = await import('../../runtime/maintenance-targets.js');
27
+ new MaintenanceTargetStore(dataDir).register({
28
+ projectId: project.id,
29
+ projectRoot: project.rootPath,
30
+ dataDir,
31
+ });
32
+ } catch {
33
+ // Workbench reads remain available when optional maintenance metadata fails.
34
+ }
35
+
36
+ const savedIdentity = await loadCliIdentity(dataDir, project.id);
37
+ if (!invocation.actorId && !savedIdentity) {
38
+ return {
39
+ project,
40
+ dataDir,
41
+ reader: { projectId: project.id },
42
+ identity: null,
43
+ };
44
+ }
45
+
46
+ const teamStore = await initTeamStore(dataDir);
47
+ const resolved = await resolveCliIdentity({
48
+ project,
49
+ dataDir,
50
+ teamStore,
51
+ explicitActorId: invocation.actorId,
52
+ });
53
+ return {
54
+ project,
55
+ dataDir,
56
+ reader: resolved.reader,
57
+ identity: resolved.identity,
58
+ ...(resolved.warning ? { identityWarning: resolved.warning } : {}),
59
+ };
60
+ }
@@ -1,157 +1,157 @@
1
- /**
2
- * useMouse — Ink hook for terminal mouse events via SGR protocol (1006).
3
- *
4
- * Enables mouse tracking on mount and parses SGR escape sequences from stdin.
5
- * Supports left/middle/right click, wheel scroll, and drag.
6
- * Automatically disables mouse tracking on unmount.
7
- *
8
- * Compatible terminals: Windows Terminal, iTerm2, WezTerm, GNOME Terminal,
9
- * Konsole, MinTTY. NOT compatible with CMD.exe.
10
- */
11
-
12
- import { useEffect, useCallback, useRef } from 'react';
13
- import { useStdin } from 'ink';
14
-
15
- export interface MouseEvent {
16
- /** 0-based column position */
17
- x: number;
18
- /** 0-based row position */
19
- y: number;
20
- button: 'left' | 'middle' | 'right' | 'wheelUp' | 'wheelDown';
21
- action: 'press' | 'release' | 'drag';
22
- shift: boolean;
23
- alt: boolean;
24
- ctrl: boolean;
25
- }
26
-
27
- // SGR mouse protocol regex: ESC[<code;col;rowM or ESC[<code;col;rowm
28
- const SGR_RE = /\x1b\[<(\d+);(\d+);(\d+)([Mm])/g;
29
-
30
- function toMouseEvent(m: RegExpExecArray): MouseEvent {
31
- const code = parseInt(m[1], 10);
32
- const col = parseInt(m[2], 10);
33
- const row = parseInt(m[3], 10);
34
- const suffix = m[4];
35
-
36
- const wheel = code & 0b11000000;
37
- const btnId = code & 0b11;
38
-
39
- const button =
40
- wheel === 64 ? 'wheelUp' :
41
- wheel === 65 ? 'wheelDown' :
42
- btnId === 0 ? 'left' :
43
- btnId === 1 ? 'middle' :
44
- 'right';
45
-
46
- const action: MouseEvent['action'] =
47
- wheel !== 0 ? 'press' :
48
- suffix === 'M' ? 'press' :
49
- 'release';
50
-
51
- const isMotion = !!(code & 0x20);
52
- const finalAction = isMotion && suffix === 'M' ? 'drag' : action;
53
-
54
- return {
55
- x: col - 1,
56
- y: row - 1,
57
- button,
58
- action: finalAction,
59
- shift: !!(code & 4),
60
- alt: !!(code & 8),
61
- ctrl: !!(code & 16),
62
- };
63
- }
64
-
65
- export function parseSGRSequence(buf: string): MouseEvent[] {
66
- const events: MouseEvent[] = [];
67
- SGR_RE.lastIndex = 0;
68
- let match: RegExpExecArray | null;
69
- while ((match = SGR_RE.exec(buf)) !== null) {
70
- events.push(toMouseEvent(match));
71
- }
72
- return events;
73
- }
74
-
75
- export function parseSGRBuffer(buf: string): { events: MouseEvent[]; remainder: string } {
76
- const events: MouseEvent[] = [];
77
- SGR_RE.lastIndex = 0;
78
- let match: RegExpExecArray | null;
79
- let lastConsumed = 0;
80
- while ((match = SGR_RE.exec(buf)) !== null) {
81
- events.push(toMouseEvent(match));
82
- lastConsumed = SGR_RE.lastIndex;
83
- }
84
-
85
- const tail = lastConsumed > 0 ? buf.slice(lastConsumed) : buf;
86
- const remainderStart = tail.lastIndexOf('\x1b[<');
87
- return {
88
- events,
89
- remainder: remainderStart >= 0 ? tail.slice(remainderStart) : '',
90
- };
91
- }
92
-
93
- // ANSI sequences to enable/disable SGR mouse mode
94
- const ENABLE_SGR = '\x1b[?1006h\x1b[?1000h';
95
- const DISABLE_SGR = '\x1b[?1000l\x1b[?1006l';
96
-
97
- export type MouseHandler = (event: MouseEvent) => void;
98
-
99
- export interface UseMouseOptions {
100
- /** Whether mouse tracking is active (default: true) */
101
- isActive?: boolean;
102
- /** Whether to manage SGR terminal mode (enable/disable). Set to false when
103
- * a parent component centrally manages SGR mode. (default: true) */
104
- manageMode?: boolean;
105
- }
106
-
107
- /**
108
- * Hook that listens for terminal mouse events using the SGR protocol.
109
- *
110
- * Usage:
111
- * ```tsx
112
- * useMouse((e) => {
113
- * if (e.button === 'left' && e.action === 'press') {
114
- * console.log(`Clicked at (${e.x}, ${e.y})`);
115
- * }
116
- * });
117
- * ```
118
- */
119
- export function useMouse(handler: MouseHandler, options: UseMouseOptions = {}): void {
120
- const { isActive = true, manageMode = true } = options;
121
- const handlerRef = useRef(handler);
122
- handlerRef.current = handler;
123
- const bufferRef = useRef('');
124
-
125
- const { stdin } = useStdin();
126
-
127
- const onData = useCallback((data: Buffer | string) => {
128
- const str = typeof data === 'string' ? data : data.toString('utf8');
129
- const { events, remainder } = parseSGRBuffer(bufferRef.current + str);
130
- bufferRef.current = remainder;
131
- for (const event of events) {
132
- handlerRef.current(event);
133
- }
134
- }, []);
135
-
136
- useEffect(() => {
137
- if (!isActive || !stdin) return;
138
- bufferRef.current = '';
139
-
140
- // Enable SGR mouse mode (unless parent manages it centrally)
141
- if (manageMode && process.stdout && typeof process.stdout.write === 'function') {
142
- process.stdout.write(ENABLE_SGR);
143
- }
144
-
145
- // Attach listener
146
- stdin.on('data', onData);
147
-
148
- return () => {
149
- bufferRef.current = '';
150
- // Disable mouse mode (unless parent manages it centrally)
151
- if (manageMode && process.stdout && typeof process.stdout.write === 'function') {
152
- process.stdout.write(DISABLE_SGR);
153
- }
154
- stdin.off('data', onData);
155
- };
156
- }, [isActive, stdin, onData, manageMode]);
157
- }
1
+ /**
2
+ * useMouse — Ink hook for terminal mouse events via SGR protocol (1006).
3
+ *
4
+ * Enables mouse tracking on mount and parses SGR escape sequences from stdin.
5
+ * Supports left/middle/right click, wheel scroll, and drag.
6
+ * Automatically disables mouse tracking on unmount.
7
+ *
8
+ * Compatible terminals: Windows Terminal, iTerm2, WezTerm, GNOME Terminal,
9
+ * Konsole, MinTTY. NOT compatible with CMD.exe.
10
+ */
11
+
12
+ import { useEffect, useCallback, useRef } from 'react';
13
+ import { useStdin } from 'ink';
14
+
15
+ export interface MouseEvent {
16
+ /** 0-based column position */
17
+ x: number;
18
+ /** 0-based row position */
19
+ y: number;
20
+ button: 'left' | 'middle' | 'right' | 'wheelUp' | 'wheelDown';
21
+ action: 'press' | 'release' | 'drag';
22
+ shift: boolean;
23
+ alt: boolean;
24
+ ctrl: boolean;
25
+ }
26
+
27
+ // SGR mouse protocol regex: ESC[<code;col;rowM or ESC[<code;col;rowm
28
+ const SGR_RE = /\x1b\[<(\d+);(\d+);(\d+)([Mm])/g;
29
+
30
+ function toMouseEvent(m: RegExpExecArray): MouseEvent {
31
+ const code = parseInt(m[1], 10);
32
+ const col = parseInt(m[2], 10);
33
+ const row = parseInt(m[3], 10);
34
+ const suffix = m[4];
35
+
36
+ const wheel = code & 0b11000000;
37
+ const btnId = code & 0b11;
38
+
39
+ const button =
40
+ wheel === 64 ? 'wheelUp' :
41
+ wheel === 65 ? 'wheelDown' :
42
+ btnId === 0 ? 'left' :
43
+ btnId === 1 ? 'middle' :
44
+ 'right';
45
+
46
+ const action: MouseEvent['action'] =
47
+ wheel !== 0 ? 'press' :
48
+ suffix === 'M' ? 'press' :
49
+ 'release';
50
+
51
+ const isMotion = !!(code & 0x20);
52
+ const finalAction = isMotion && suffix === 'M' ? 'drag' : action;
53
+
54
+ return {
55
+ x: col - 1,
56
+ y: row - 1,
57
+ button,
58
+ action: finalAction,
59
+ shift: !!(code & 4),
60
+ alt: !!(code & 8),
61
+ ctrl: !!(code & 16),
62
+ };
63
+ }
64
+
65
+ export function parseSGRSequence(buf: string): MouseEvent[] {
66
+ const events: MouseEvent[] = [];
67
+ SGR_RE.lastIndex = 0;
68
+ let match: RegExpExecArray | null;
69
+ while ((match = SGR_RE.exec(buf)) !== null) {
70
+ events.push(toMouseEvent(match));
71
+ }
72
+ return events;
73
+ }
74
+
75
+ export function parseSGRBuffer(buf: string): { events: MouseEvent[]; remainder: string } {
76
+ const events: MouseEvent[] = [];
77
+ SGR_RE.lastIndex = 0;
78
+ let match: RegExpExecArray | null;
79
+ let lastConsumed = 0;
80
+ while ((match = SGR_RE.exec(buf)) !== null) {
81
+ events.push(toMouseEvent(match));
82
+ lastConsumed = SGR_RE.lastIndex;
83
+ }
84
+
85
+ const tail = lastConsumed > 0 ? buf.slice(lastConsumed) : buf;
86
+ const remainderStart = tail.lastIndexOf('\x1b[<');
87
+ return {
88
+ events,
89
+ remainder: remainderStart >= 0 ? tail.slice(remainderStart) : '',
90
+ };
91
+ }
92
+
93
+ // ANSI sequences to enable/disable SGR mouse mode
94
+ const ENABLE_SGR = '\x1b[?1006h\x1b[?1000h';
95
+ const DISABLE_SGR = '\x1b[?1000l\x1b[?1006l';
96
+
97
+ export type MouseHandler = (event: MouseEvent) => void;
98
+
99
+ export interface UseMouseOptions {
100
+ /** Whether mouse tracking is active (default: true) */
101
+ isActive?: boolean;
102
+ /** Whether to manage SGR terminal mode (enable/disable). Set to false when
103
+ * a parent component centrally manages SGR mode. (default: true) */
104
+ manageMode?: boolean;
105
+ }
106
+
107
+ /**
108
+ * Hook that listens for terminal mouse events using the SGR protocol.
109
+ *
110
+ * Usage:
111
+ * ```tsx
112
+ * useMouse((e) => {
113
+ * if (e.button === 'left' && e.action === 'press') {
114
+ * console.log(`Clicked at (${e.x}, ${e.y})`);
115
+ * }
116
+ * });
117
+ * ```
118
+ */
119
+ export function useMouse(handler: MouseHandler, options: UseMouseOptions = {}): void {
120
+ const { isActive = true, manageMode = true } = options;
121
+ const handlerRef = useRef(handler);
122
+ handlerRef.current = handler;
123
+ const bufferRef = useRef('');
124
+
125
+ const { stdin } = useStdin();
126
+
127
+ const onData = useCallback((data: Buffer | string) => {
128
+ const str = typeof data === 'string' ? data : data.toString('utf8');
129
+ const { events, remainder } = parseSGRBuffer(bufferRef.current + str);
130
+ bufferRef.current = remainder;
131
+ for (const event of events) {
132
+ handlerRef.current(event);
133
+ }
134
+ }, []);
135
+
136
+ useEffect(() => {
137
+ if (!isActive || !stdin) return;
138
+ bufferRef.current = '';
139
+
140
+ // Enable SGR mouse mode (unless parent manages it centrally)
141
+ if (manageMode && process.stdout && typeof process.stdout.write === 'function') {
142
+ process.stdout.write(ENABLE_SGR);
143
+ }
144
+
145
+ // Attach listener
146
+ stdin.on('data', onData);
147
+
148
+ return () => {
149
+ bufferRef.current = '';
150
+ // Disable mouse mode (unless parent manages it centrally)
151
+ if (manageMode && process.stdout && typeof process.stdout.write === 'function') {
152
+ process.stdout.write(DISABLE_SGR);
153
+ }
154
+ stdin.off('data', onData);
155
+ };
156
+ }, [isActive, stdin, onData, manageMode]);
157
+ }
@@ -1,56 +1,56 @@
1
- /**
2
- * Centralized keyboard navigation for the Memorix TUI.
3
- *
4
- * Three-layer priority model:
5
- * 1. Action view local keys (1-9, h, w, Esc) — highest
6
- * 2. CommandBar input mode — captures all printable chars when focused
7
- * 3. Global nav keys (s, r, v, d, b, w, p, c, i, h) — lowest, only when idle
8
- */
9
-
10
- import type { ViewType } from './theme.js';
11
-
12
- /** Maps single-char shortcut keys to view navigation commands */
13
- export const NAV_KEY_MAP: Record<string, string> = {
14
- s: '/search',
15
- r: '/remember',
16
- v: '/recent',
17
- d: '/doctor',
18
- b: '/background',
19
- w: '/dashboard',
20
- p: '/project',
21
- c: '/configure',
22
- i: '/integrate',
23
- h: '/home',
24
- };
25
-
26
- /** Views that handle their own number/letter keys (action views) */
27
- export const ACTION_VIEWS: Set<ViewType> = new Set([
28
- 'cleanup', 'ingest', 'background', 'dashboard', 'integrate', 'configure',
29
- ]);
30
-
31
- /** Views where Esc returns to home */
32
- export const ESC_RETURNABLE_VIEWS: Set<ViewType> = new Set([
33
- 'chat', 'recent', 'doctor', 'project', 'cleanup', 'ingest',
34
- 'background', 'dashboard', 'integrate', 'configure', 'search', 'wiki',
35
- ]);
36
-
37
- /**
38
- * Determine if a key press should be handled as global navigation.
39
- *
40
- * Returns the command string (e.g. '/recent') if the key is a nav key
41
- * and the current context allows it, or null otherwise.
42
- */
43
- export function resolveGlobalNav(
44
- ch: string,
45
- currentView: ViewType,
46
- isInputFocused: boolean,
47
- ): string | null {
48
- // Never intercept during input
49
- if (isInputFocused) return null;
50
-
51
- // Action views handle their own keys — only allow 'h' for home
52
- if (ACTION_VIEWS.has(currentView)) return null;
53
-
54
- const cmd = NAV_KEY_MAP[ch];
55
- return cmd ?? null;
56
- }
1
+ /**
2
+ * Centralized keyboard navigation for the Memorix TUI.
3
+ *
4
+ * Three-layer priority model:
5
+ * 1. Action view local keys (1-9, h, w, Esc) — highest
6
+ * 2. CommandBar input mode — captures all printable chars when focused
7
+ * 3. Global nav keys (s, r, v, d, b, w, p, c, i, h) — lowest, only when idle
8
+ */
9
+
10
+ import type { ViewType } from './theme.js';
11
+
12
+ /** Maps single-char shortcut keys to view navigation commands */
13
+ export const NAV_KEY_MAP: Record<string, string> = {
14
+ s: '/search',
15
+ r: '/remember',
16
+ v: '/recent',
17
+ d: '/doctor',
18
+ b: '/background',
19
+ w: '/dashboard',
20
+ p: '/project',
21
+ c: '/configure',
22
+ i: '/integrate',
23
+ h: '/home',
24
+ };
25
+
26
+ /** Views that handle their own number/letter keys (action views) */
27
+ export const ACTION_VIEWS: Set<ViewType> = new Set([
28
+ 'cleanup', 'ingest', 'background', 'dashboard', 'integrate', 'configure',
29
+ ]);
30
+
31
+ /** Views where Esc returns to home */
32
+ export const ESC_RETURNABLE_VIEWS: Set<ViewType> = new Set([
33
+ 'chat', 'recent', 'doctor', 'project', 'cleanup', 'ingest',
34
+ 'background', 'dashboard', 'integrate', 'configure', 'search', 'wiki',
35
+ ]);
36
+
37
+ /**
38
+ * Determine if a key press should be handled as global navigation.
39
+ *
40
+ * Returns the command string (e.g. '/recent') if the key is a nav key
41
+ * and the current context allows it, or null otherwise.
42
+ */
43
+ export function resolveGlobalNav(
44
+ ch: string,
45
+ currentView: ViewType,
46
+ isInputFocused: boolean,
47
+ ): string | null {
48
+ // Never intercept during input
49
+ if (isInputFocused) return null;
50
+
51
+ // Action views handle their own keys — only allow 'h' for home
52
+ if (ACTION_VIEWS.has(currentView)) return null;
53
+
54
+ const cmd = NAV_KEY_MAP[ch];
55
+ return cmd ?? null;
56
+ }
@@ -65,21 +65,23 @@ export function MemoryView({ projectId, focusRefId, selectedIdx, onNavigateKnowl
65
65
  (async () => {
66
66
  try {
67
67
  setLoading(true);
68
- const { getObservation, initObservations, getAllObservations } = await import('../../../memory/observations.js');
69
- const { getProjectDataDir } = await import('../../../store/persistence.js');
68
+ const { initObservations, getAllObservations } = await import('../../../memory/observations.js');
69
+ const { filterReadableObservations } = await import('../../../memory/visibility.js');
70
70
  const { initObservationStore } = await import('../../../store/obs-store.js');
71
- const { detectProject } = await import('../../../project/detector.js');
71
+ const { getTuiOperatorContext } = await import('../operator-context.js');
72
72
 
73
- const proj = detectProject(process.cwd());
74
- if (!proj) return;
73
+ const { project: proj, dataDir, reader } = await getTuiOperatorContext();
75
74
 
76
- const dataDir = await getProjectDataDir(projectId || proj.id);
75
+ const effectiveProjectId = projectId || proj.id;
76
+ if (effectiveProjectId !== proj.id) return;
77
77
  await initObservationStore(dataDir);
78
78
  await initObservations(dataDir);
79
79
 
80
80
  const obsId = parseInt(idMatch[1], 10);
81
- const allObs = getAllObservations();
82
- const obs = allObs.find((o: any) => o.id === obsId);
81
+ const obs = filterReadableObservations(
82
+ getAllObservations().filter((observation) => observation.projectId === effectiveProjectId),
83
+ reader,
84
+ ).find((observation) => observation.id === obsId);
83
85
  if (obs) {
84
86
  setDetailItem({
85
87
  id: obs.id,