memorix 1.2.2 → 1.2.4

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 (163) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/README.md +3 -3
  3. package/README.zh-CN.md +3 -3
  4. package/TEAM.md +86 -86
  5. package/dist/cli/index.js +5199 -4726
  6. package/dist/cli/index.js.map +1 -1
  7. package/dist/index.js +428 -49
  8. package/dist/index.js.map +1 -1
  9. package/dist/maintenance-runner.js +97 -18
  10. package/dist/maintenance-runner.js.map +1 -1
  11. package/dist/memcode-runtime/CHANGELOG.md +27 -0
  12. package/dist/sdk.js +428 -49
  13. package/dist/sdk.js.map +1 -1
  14. package/docs/1.2.4-PERSISTENT-MEMORY-DELIVERY.md +86 -0
  15. package/docs/AGENT_OPERATOR_PLAYBOOK.md +13 -1
  16. package/docs/API_REFERENCE.md +13 -3
  17. package/docs/DESIGN_DECISIONS.md +357 -357
  18. package/docs/dev-log/progress.txt +60 -9
  19. package/package.json +1 -1
  20. package/plugins/codex/memorix/.codex-plugin/plugin.json +1 -1
  21. package/src/audit/index.ts +156 -156
  22. package/src/cli/capability-map.ts +1 -1
  23. package/src/cli/command-guide.ts +4 -1
  24. package/src/cli/commands/agent-integrations.ts +5 -1
  25. package/src/cli/commands/audit-list.ts +89 -89
  26. package/src/cli/commands/background.ts +659 -659
  27. package/src/cli/commands/codegraph.ts +1 -1
  28. package/src/cli/commands/context.ts +9 -1
  29. package/src/cli/commands/formation.ts +48 -48
  30. package/src/cli/commands/git-hook-install.ts +111 -111
  31. package/src/cli/commands/handoff.ts +54 -54
  32. package/src/cli/commands/hooks-status.ts +63 -63
  33. package/src/cli/commands/ingest-commit.ts +153 -153
  34. package/src/cli/commands/ingest-image.ts +66 -66
  35. package/src/cli/commands/ingest-log.ts +180 -180
  36. package/src/cli/commands/ingest.ts +44 -44
  37. package/src/cli/commands/integrate-shared.ts +15 -15
  38. package/src/cli/commands/lock.ts +82 -82
  39. package/src/cli/commands/message.ts +104 -104
  40. package/src/cli/commands/poll.ts +58 -58
  41. package/src/cli/commands/purge-all-memory.ts +85 -85
  42. package/src/cli/commands/purge-project-memory.ts +83 -83
  43. package/src/cli/commands/reasoning.ts +118 -118
  44. package/src/cli/commands/resume.ts +31 -0
  45. package/src/cli/commands/serve-shared.ts +118 -118
  46. package/src/cli/commands/session.ts +15 -7
  47. package/src/cli/commands/skills.ts +114 -114
  48. package/src/cli/commands/task.ts +167 -167
  49. package/src/cli/commands/transfer.ts +47 -47
  50. package/src/cli/commands/uninstall-project-artifacts.ts +85 -85
  51. package/src/cli/index.ts +3 -1
  52. package/src/cli/tui/ChatView.tsx +234 -234
  53. package/src/cli/tui/CommandBar.tsx +312 -312
  54. package/src/cli/tui/ContextRail.tsx +118 -118
  55. package/src/cli/tui/HeaderBar.tsx +72 -72
  56. package/src/cli/tui/LogoBanner.tsx +51 -51
  57. package/src/cli/tui/Sidebar.tsx +179 -179
  58. package/src/cli/tui/index.ts +41 -41
  59. package/src/cli/tui/markdown-render.tsx +371 -371
  60. package/src/cli/tui/session-service.ts +3 -2
  61. package/src/cli/tui/use-mouse.ts +157 -157
  62. package/src/cli/tui/useNavigation.ts +56 -56
  63. package/src/cli/update-checker.ts +211 -211
  64. package/src/cli/version.ts +7 -7
  65. package/src/cli/workbench.ts +1 -1
  66. package/src/codegraph/auto-context.ts +54 -1
  67. package/src/codegraph/task-lens.ts +29 -0
  68. package/src/compact/token-budget.ts +89 -74
  69. package/src/config/toml-loader.ts +9 -5
  70. package/src/dashboard/project-classification.ts +64 -64
  71. package/src/embedding/fastembed-provider.ts +142 -142
  72. package/src/embedding/transformers-provider.ts +111 -111
  73. package/src/git/extractor.ts +209 -209
  74. package/src/git/hooks-path.ts +85 -85
  75. package/src/hooks/handler.ts +127 -66
  76. package/src/hooks/installers/index.ts +5 -4
  77. package/src/hooks/official-skills.ts +6 -4
  78. package/src/hooks/pattern-detector.ts +173 -173
  79. package/src/hooks/rules/memorix-agent-rules.md +9 -7
  80. package/src/hooks/significance-filter.ts +250 -250
  81. package/src/knowledge/context-assembly.ts +4 -1
  82. package/src/knowledge/workset.ts +89 -1
  83. package/src/llm/memory-manager.ts +328 -328
  84. package/src/llm/provider.ts +885 -885
  85. package/src/llm/quality.ts +248 -248
  86. package/src/memory/attribution-guard.ts +249 -249
  87. package/src/memory/disclosure-policy.ts +135 -135
  88. package/src/memory/entity-extractor.ts +197 -197
  89. package/src/memory/formation/evaluate.ts +217 -217
  90. package/src/memory/formation/extract.ts +361 -361
  91. package/src/memory/formation/index.ts +417 -417
  92. package/src/memory/formation/resolve.ts +344 -344
  93. package/src/memory/formation/types.ts +315 -315
  94. package/src/memory/freshness.ts +122 -122
  95. package/src/memory/graph.ts +197 -197
  96. package/src/memory/refs.ts +94 -94
  97. package/src/memory/secret-filter.ts +79 -79
  98. package/src/memory/session.ts +158 -9
  99. package/src/multimodal/image-loader.ts +143 -143
  100. package/src/orchestrate/adapters/claude-stream.ts +192 -192
  101. package/src/orchestrate/adapters/claude.ts +111 -111
  102. package/src/orchestrate/adapters/codex-stream.ts +134 -134
  103. package/src/orchestrate/adapters/codex.ts +41 -41
  104. package/src/orchestrate/adapters/gemini-stream.ts +166 -166
  105. package/src/orchestrate/adapters/gemini.ts +42 -42
  106. package/src/orchestrate/adapters/index.ts +73 -73
  107. package/src/orchestrate/adapters/opencode-stream.ts +143 -143
  108. package/src/orchestrate/adapters/opencode.ts +47 -47
  109. package/src/orchestrate/adapters/spawn-helper.ts +286 -286
  110. package/src/orchestrate/adapters/types.ts +77 -77
  111. package/src/orchestrate/capability-router.ts +284 -284
  112. package/src/orchestrate/context-compact.ts +188 -188
  113. package/src/orchestrate/cost-tracker.ts +219 -219
  114. package/src/orchestrate/error-recovery.ts +191 -191
  115. package/src/orchestrate/evidence.ts +140 -140
  116. package/src/orchestrate/ledger.ts +110 -110
  117. package/src/orchestrate/memorix-bridge.ts +343 -343
  118. package/src/orchestrate/output-budget.ts +80 -80
  119. package/src/orchestrate/permission.ts +152 -152
  120. package/src/orchestrate/pipeline-trace.ts +131 -131
  121. package/src/orchestrate/prompt-builder.ts +155 -155
  122. package/src/orchestrate/ring-buffer.ts +37 -37
  123. package/src/orchestrate/task-graph.ts +389 -389
  124. package/src/orchestrate/worktree.ts +232 -232
  125. package/src/project/aliases.ts +374 -374
  126. package/src/project/detector.ts +268 -268
  127. package/src/rules/adapters/claude-code.ts +99 -99
  128. package/src/rules/adapters/codex.ts +97 -97
  129. package/src/rules/adapters/copilot.ts +124 -124
  130. package/src/rules/adapters/cursor.ts +114 -114
  131. package/src/rules/adapters/kiro.ts +126 -126
  132. package/src/rules/adapters/trae.ts +56 -56
  133. package/src/rules/adapters/windsurf.ts +83 -83
  134. package/src/rules/syncer.ts +235 -235
  135. package/src/sdk.ts +299 -299
  136. package/src/search/intent-detector.ts +289 -289
  137. package/src/search/query-expansion.ts +52 -52
  138. package/src/server/formation-timeout.ts +27 -27
  139. package/src/server.ts +144 -10
  140. package/src/skills/mini-skills.ts +386 -386
  141. package/src/store/bun-sqlite-compat.ts +118 -15
  142. package/src/store/chat-store.ts +119 -119
  143. package/src/store/graph-store.ts +249 -249
  144. package/src/store/mini-skill-store.ts +349 -349
  145. package/src/store/persistence-json.ts +212 -212
  146. package/src/store/persistence.ts +291 -291
  147. package/src/store/project-affinity.ts +195 -195
  148. package/src/store/sqlite-db.ts +3 -3
  149. package/src/team/event-bus.ts +76 -76
  150. package/src/team/file-locks.ts +173 -173
  151. package/src/team/handoff.ts +161 -161
  152. package/src/team/messages.ts +203 -203
  153. package/src/team/poll.ts +132 -132
  154. package/src/team/tasks.ts +211 -211
  155. package/src/workspace/mcp-adapters/codex.ts +191 -191
  156. package/src/workspace/mcp-adapters/copilot.ts +105 -105
  157. package/src/workspace/mcp-adapters/cursor.ts +53 -53
  158. package/src/workspace/mcp-adapters/kiro.ts +64 -64
  159. package/src/workspace/mcp-adapters/opencode.ts +123 -123
  160. package/src/workspace/mcp-adapters/trae.ts +134 -134
  161. package/src/workspace/mcp-adapters/windsurf.ts +91 -91
  162. package/src/workspace/sanitizer.ts +60 -60
  163. package/src/workspace/workflow-sync.ts +131 -131
@@ -1,183 +1,183 @@
1
- /**
2
- * CLI Command: memorix ingest log
3
- *
4
- * Batch ingest recent git commits as memories.
5
- * This is the Git→Memory direction — unique to Memorix.
6
- */
7
-
8
- import { defineCommand } from 'citty';
9
- import * as p from '@clack/prompts';
10
-
11
- type IngestableCommit = {
12
- hash: string;
13
- shortHash: string;
14
- subject: string;
15
- };
16
-
17
- type IngestLogResult = {
18
- stored: number;
19
- dupSkipped: number;
20
- errSkipped: number;
21
- };
22
-
23
- /**
24
- * Shared dedup logic for batch git ingest.
25
- * Exported so tests can exercise the production path rather than reimplementing it.
26
- */
27
- export async function ingestCommitsWithDedup<T extends IngestableCommit>(
28
- commits: T[],
29
- existingHashes: Set<string>,
30
- ingestOne: (commit: T) => Promise<void>,
31
- log: (line: string) => void = console.log,
32
- ): Promise<IngestLogResult> {
33
- let stored = 0;
34
- let dupSkipped = 0;
35
- let errSkipped = 0;
36
-
37
- for (const commit of commits) {
38
- if (existingHashes.has(commit.hash)) {
39
- dupSkipped++;
1
+ /**
2
+ * CLI Command: memorix ingest log
3
+ *
4
+ * Batch ingest recent git commits as memories.
5
+ * This is the Git→Memory direction — unique to Memorix.
6
+ */
7
+
8
+ import { defineCommand } from 'citty';
9
+ import * as p from '@clack/prompts';
10
+
11
+ type IngestableCommit = {
12
+ hash: string;
13
+ shortHash: string;
14
+ subject: string;
15
+ };
16
+
17
+ type IngestLogResult = {
18
+ stored: number;
19
+ dupSkipped: number;
20
+ errSkipped: number;
21
+ };
22
+
23
+ /**
24
+ * Shared dedup logic for batch git ingest.
25
+ * Exported so tests can exercise the production path rather than reimplementing it.
26
+ */
27
+ export async function ingestCommitsWithDedup<T extends IngestableCommit>(
28
+ commits: T[],
29
+ existingHashes: Set<string>,
30
+ ingestOne: (commit: T) => Promise<void>,
31
+ log: (line: string) => void = console.log,
32
+ ): Promise<IngestLogResult> {
33
+ let stored = 0;
34
+ let dupSkipped = 0;
35
+ let errSkipped = 0;
36
+
37
+ for (const commit of commits) {
38
+ if (existingHashes.has(commit.hash)) {
39
+ dupSkipped++;
40
40
  log(` [SKIP] ${commit.shortHash} ${commit.subject} — already ingested`);
41
- continue;
42
- }
43
- try {
44
- await ingestOne(commit);
45
- stored++;
46
- existingHashes.add(commit.hash);
47
- log(` [OK] ${commit.shortHash} ${commit.subject}`);
48
- } catch (err) {
49
- errSkipped++;
50
- const message = err instanceof Error ? err.message : String(err);
41
+ continue;
42
+ }
43
+ try {
44
+ await ingestOne(commit);
45
+ stored++;
46
+ existingHashes.add(commit.hash);
47
+ log(` [OK] ${commit.shortHash} ${commit.subject}`);
48
+ } catch (err) {
49
+ errSkipped++;
50
+ const message = err instanceof Error ? err.message : String(err);
51
51
  log(` [SKIP] ${commit.shortHash} ${commit.subject} — error: ${message}`);
52
- }
53
- }
54
-
55
- return { stored, dupSkipped, errSkipped };
56
- }
57
-
58
- export default defineCommand({
59
- meta: {
60
- name: 'log',
61
- description: 'Batch ingest recent git commits as memories',
62
- },
63
- args: {
64
- count: {
65
- type: 'string',
66
- description: 'Number of recent commits to ingest (default: 10)',
67
- required: false,
68
- },
69
- },
70
- run: async ({ args }) => {
71
- const os = await import('node:os');
72
- let cwd: string;
73
- try { cwd = process.cwd(); } catch { cwd = os.homedir(); }
74
-
75
- const count = parseInt(args.count || '10', 10);
76
-
77
- p.intro(`Ingest recent ${count} commits`);
78
-
79
- try {
80
- const { getRecentCommits, ingestCommit } = await import('../../git/extractor.js');
81
- const rawCommits = getRecentCommits(cwd, count);
82
-
83
- if (rawCommits.length === 0) {
84
- console.log('No commits found.');
85
- p.outro('Nothing to ingest.');
86
- return;
87
- }
88
-
89
- // Apply noise filter
90
- const { filterCommits } = await import('../../git/noise-filter.js');
91
- const { getGitConfig } = await import('../../config.js');
92
- const gitCfg = getGitConfig();
93
- const { kept: commits, skipped: noiseCommits } = filterCommits(rawCommits, {
94
- skipMergeCommits: gitCfg.skipMergeCommits,
95
- excludePatterns: gitCfg.excludePatterns,
96
- noiseKeywords: gitCfg.noiseKeywords,
97
- });
98
-
99
- if (commits.length === 0) {
100
- console.log(`All ${rawCommits.length} commits filtered as noise.`);
101
- p.outro('Nothing to ingest.');
102
- return;
103
- }
104
-
105
- // Show commits
106
- console.log('');
107
- console.log(`Found ${rawCommits.length} commits (${noiseCommits.length} filtered as noise):`);
108
- console.log('');
109
- for (const commit of commits) {
110
- console.log(` ${commit.shortHash} ${commit.subject}`);
111
- }
112
- if (noiseCommits.length > 0) {
113
- console.log('');
114
- console.log(` Filtered (noise):`);
115
- for (const { commit, reason } of noiseCommits) {
52
+ }
53
+ }
54
+
55
+ return { stored, dupSkipped, errSkipped };
56
+ }
57
+
58
+ export default defineCommand({
59
+ meta: {
60
+ name: 'log',
61
+ description: 'Batch ingest recent git commits as memories',
62
+ },
63
+ args: {
64
+ count: {
65
+ type: 'string',
66
+ description: 'Number of recent commits to ingest (default: 10)',
67
+ required: false,
68
+ },
69
+ },
70
+ run: async ({ args }) => {
71
+ const os = await import('node:os');
72
+ let cwd: string;
73
+ try { cwd = process.cwd(); } catch { cwd = os.homedir(); }
74
+
75
+ const count = parseInt(args.count || '10', 10);
76
+
77
+ p.intro(`Ingest recent ${count} commits`);
78
+
79
+ try {
80
+ const { getRecentCommits, ingestCommit } = await import('../../git/extractor.js');
81
+ const rawCommits = getRecentCommits(cwd, count);
82
+
83
+ if (rawCommits.length === 0) {
84
+ console.log('No commits found.');
85
+ p.outro('Nothing to ingest.');
86
+ return;
87
+ }
88
+
89
+ // Apply noise filter
90
+ const { filterCommits } = await import('../../git/noise-filter.js');
91
+ const { getGitConfig } = await import('../../config.js');
92
+ const gitCfg = getGitConfig();
93
+ const { kept: commits, skipped: noiseCommits } = filterCommits(rawCommits, {
94
+ skipMergeCommits: gitCfg.skipMergeCommits,
95
+ excludePatterns: gitCfg.excludePatterns,
96
+ noiseKeywords: gitCfg.noiseKeywords,
97
+ });
98
+
99
+ if (commits.length === 0) {
100
+ console.log(`All ${rawCommits.length} commits filtered as noise.`);
101
+ p.outro('Nothing to ingest.');
102
+ return;
103
+ }
104
+
105
+ // Show commits
106
+ console.log('');
107
+ console.log(`Found ${rawCommits.length} commits (${noiseCommits.length} filtered as noise):`);
108
+ console.log('');
109
+ for (const commit of commits) {
110
+ console.log(` ${commit.shortHash} ${commit.subject}`);
111
+ }
112
+ if (noiseCommits.length > 0) {
113
+ console.log('');
114
+ console.log(` Filtered (noise):`);
115
+ for (const { commit, reason } of noiseCommits) {
116
116
  console.log(` [SKIP] ${commit.shortHash} ${commit.subject} — ${reason}`);
117
- }
118
- }
119
- console.log('');
120
-
121
- // Confirm
122
- const confirmed = await p.confirm({
123
- message: `Ingest ${commits.length} commits as memories?`,
124
- });
125
-
126
- if (p.isCancel(confirmed) || !confirmed) {
127
- p.outro('Ingest cancelled.');
128
- return;
129
- }
130
-
131
- // Store each commit
132
- const { initObservations, storeObservation } = await import('../../memory/observations.js');
133
- const { getProjectDataDir } = await import('../../store/persistence.js');
134
- const { detectProject } = await import('../../project/detector.js');
135
- const { initObservationStore, getObservationStore: getStore } = await import('../../store/obs-store.js');
136
-
137
- const project = detectProject(cwd);
138
- if (!project) {
139
- p.log.error('No .git found — not a project directory.');
140
- return;
141
- }
142
- const dataDir = await getProjectDataDir(project.id);
143
- await initObservationStore(dataDir);
144
- await initObservations(dataDir);
145
-
146
- // Dedup: load existing commit hashes to skip already-ingested commits (#48)
147
- const existingObs = await getStore().loadAll() as Array<{ commitHash?: string }>;
148
- const existingHashes = new Set(
149
- existingObs.map(o => o.commitHash).filter((hash): hash is string => typeof hash === 'string' && hash.length > 0),
150
- );
151
-
152
- const { stored, dupSkipped, errSkipped } = await ingestCommitsWithDedup(
153
- commits,
154
- existingHashes,
155
- async (commit) => {
156
- const result = ingestCommit(commit);
157
- await storeObservation({
158
- entityName: result.entityName,
159
- type: result.type as any,
160
- title: result.title,
161
- sourceDetail: 'git-ingest',
162
- narrative: result.narrative,
163
- facts: result.facts,
164
- concepts: result.concepts,
165
- filesModified: result.filesModified,
166
- projectId: project.id,
167
- source: 'git',
168
- commitHash: commit.hash,
169
- });
170
- },
171
- console.log,
172
- );
173
-
174
- const parts = [`Ingested ${stored}/${commits.length} commits`];
175
- if (dupSkipped) parts.push(`${dupSkipped} already stored`);
176
- if (errSkipped) parts.push(`${errSkipped} errors`);
177
- p.outro(parts.join(', ') + '.');
178
- } catch (err) {
179
- console.error(`Failed to ingest log: ${err}`);
180
- p.outro('Ingest failed. Make sure you are in a git repository.');
181
- }
182
- },
183
- });
117
+ }
118
+ }
119
+ console.log('');
120
+
121
+ // Confirm
122
+ const confirmed = await p.confirm({
123
+ message: `Ingest ${commits.length} commits as memories?`,
124
+ });
125
+
126
+ if (p.isCancel(confirmed) || !confirmed) {
127
+ p.outro('Ingest cancelled.');
128
+ return;
129
+ }
130
+
131
+ // Store each commit
132
+ const { initObservations, storeObservation } = await import('../../memory/observations.js');
133
+ const { getProjectDataDir } = await import('../../store/persistence.js');
134
+ const { detectProject } = await import('../../project/detector.js');
135
+ const { initObservationStore, getObservationStore: getStore } = await import('../../store/obs-store.js');
136
+
137
+ const project = detectProject(cwd);
138
+ if (!project) {
139
+ p.log.error('No .git found — not a project directory.');
140
+ return;
141
+ }
142
+ const dataDir = await getProjectDataDir(project.id);
143
+ await initObservationStore(dataDir);
144
+ await initObservations(dataDir);
145
+
146
+ // Dedup: load existing commit hashes to skip already-ingested commits (#48)
147
+ const existingObs = await getStore().loadAll() as Array<{ commitHash?: string }>;
148
+ const existingHashes = new Set(
149
+ existingObs.map(o => o.commitHash).filter((hash): hash is string => typeof hash === 'string' && hash.length > 0),
150
+ );
151
+
152
+ const { stored, dupSkipped, errSkipped } = await ingestCommitsWithDedup(
153
+ commits,
154
+ existingHashes,
155
+ async (commit) => {
156
+ const result = ingestCommit(commit);
157
+ await storeObservation({
158
+ entityName: result.entityName,
159
+ type: result.type as any,
160
+ title: result.title,
161
+ sourceDetail: 'git-ingest',
162
+ narrative: result.narrative,
163
+ facts: result.facts,
164
+ concepts: result.concepts,
165
+ filesModified: result.filesModified,
166
+ projectId: project.id,
167
+ source: 'git',
168
+ commitHash: commit.hash,
169
+ });
170
+ },
171
+ console.log,
172
+ );
173
+
174
+ const parts = [`Ingested ${stored}/${commits.length} commits`];
175
+ if (dupSkipped) parts.push(`${dupSkipped} already stored`);
176
+ if (errSkipped) parts.push(`${errSkipped} errors`);
177
+ p.outro(parts.join(', ') + '.');
178
+ } catch (err) {
179
+ console.error(`Failed to ingest log: ${err}`);
180
+ p.outro('Ingest failed. Make sure you are in a git repository.');
181
+ }
182
+ },
183
+ });
@@ -1,44 +1,44 @@
1
- /**
2
- * CLI Command: memorix ingest
3
- *
4
- * Parent command for Git→Memory and image ingestion.
5
- */
6
-
7
- import { defineCommand } from 'citty';
8
-
9
- export default defineCommand({
10
- meta: {
11
- name: 'ingest',
12
- description: 'Ingest engineering knowledge from Git and images',
13
- },
14
- subCommands: {
15
- commit: () => import('./ingest-commit.js').then((module) => module.default),
16
- log: () => import('./ingest-log.js').then((module) => module.default),
17
- image: () => import('./ingest-image.js').then((module) => module.default),
18
- },
19
- run: async ({ args }) => {
20
- const action = (args._ as string[])?.[0] || '';
21
- if (action === 'commit') {
22
- const module = await import('./ingest-commit.js');
23
- await module.default.run?.({ args: { ...args, _: [] }, rawArgs: [], cmd: module.default } as any);
24
- return;
25
- }
26
- if (action === 'log') {
27
- const module = await import('./ingest-log.js');
28
- await module.default.run?.({ args: { ...args, _: [] }, rawArgs: [], cmd: module.default } as any);
29
- return;
30
- }
31
- if (action === 'image') {
32
- const module = await import('./ingest-image.js');
33
- await module.default.run?.({ args: { ...args, _: [] }, rawArgs: [], cmd: module.default } as any);
34
- return;
35
- }
36
-
37
- console.log('Memorix Ingest Commands');
38
- console.log('');
39
- console.log('Usage:');
40
- console.log(' memorix ingest commit [--ref HEAD]');
41
- console.log(' memorix ingest log [--count 10]');
42
- console.log(' memorix ingest image --path ./diagram.png');
43
- },
44
- });
1
+ /**
2
+ * CLI Command: memorix ingest
3
+ *
4
+ * Parent command for Git→Memory and image ingestion.
5
+ */
6
+
7
+ import { defineCommand } from 'citty';
8
+
9
+ export default defineCommand({
10
+ meta: {
11
+ name: 'ingest',
12
+ description: 'Ingest engineering knowledge from Git and images',
13
+ },
14
+ subCommands: {
15
+ commit: () => import('./ingest-commit.js').then((module) => module.default),
16
+ log: () => import('./ingest-log.js').then((module) => module.default),
17
+ image: () => import('./ingest-image.js').then((module) => module.default),
18
+ },
19
+ run: async ({ args }) => {
20
+ const action = (args._ as string[])?.[0] || '';
21
+ if (action === 'commit') {
22
+ const module = await import('./ingest-commit.js');
23
+ await module.default.run?.({ args: { ...args, _: [] }, rawArgs: [], cmd: module.default } as any);
24
+ return;
25
+ }
26
+ if (action === 'log') {
27
+ const module = await import('./ingest-log.js');
28
+ await module.default.run?.({ args: { ...args, _: [] }, rawArgs: [], cmd: module.default } as any);
29
+ return;
30
+ }
31
+ if (action === 'image') {
32
+ const module = await import('./ingest-image.js');
33
+ await module.default.run?.({ args: { ...args, _: [] }, rawArgs: [], cmd: module.default } as any);
34
+ return;
35
+ }
36
+
37
+ console.log('Memorix Ingest Commands');
38
+ console.log('');
39
+ console.log('Usage:');
40
+ console.log(' memorix ingest commit [--ref HEAD]');
41
+ console.log(' memorix ingest log [--count 10]');
42
+ console.log(' memorix ingest image --path ./diagram.png');
43
+ },
44
+ });
@@ -1,15 +1,15 @@
1
- import { homedir } from 'node:os';
2
-
3
- export function getIntegrationTargetRoot(
4
- useGlobalDefaults: boolean,
5
- cwd: string,
6
- homeDir = homedir(),
7
- ): string {
8
- return useGlobalDefaults ? homeDir : cwd;
9
- }
10
-
11
- export function getIntegrationScopeLabel(useGlobalDefaults: boolean): string {
12
- return useGlobalDefaults
13
- ? 'global defaults'
14
- : 'current project';
15
- }
1
+ import { homedir } from 'node:os';
2
+
3
+ export function getIntegrationTargetRoot(
4
+ useGlobalDefaults: boolean,
5
+ cwd: string,
6
+ homeDir = homedir(),
7
+ ): string {
8
+ return useGlobalDefaults ? homeDir : cwd;
9
+ }
10
+
11
+ export function getIntegrationScopeLabel(useGlobalDefaults: boolean): string {
12
+ return useGlobalDefaults
13
+ ? 'global defaults'
14
+ : 'current project';
15
+ }
@@ -1,97 +1,97 @@
1
- import { defineCommand } from 'citty';
1
+ import { defineCommand } from 'citty';
2
2
  import { emitError, emitResult, getCliProjectContext, resolveCliActorId, shortId } from './operator-shared.js';
3
-
4
- export default defineCommand({
5
- meta: {
6
- name: 'lock',
7
- description: 'Acquire, release, and inspect advisory team file locks',
8
- },
9
- args: {
10
- file: { type: 'string', description: 'File path to lock or inspect' },
11
- agentId: { type: 'string', description: 'Agent ID acquiring or releasing the lock' },
12
- json: { type: 'boolean', description: 'Emit machine-readable JSON output' },
13
- },
14
- run: async ({ args }) => {
15
- const action = (args._ as string[])?.[0] || '';
16
- const asJson = !!args.json;
17
-
18
- try {
3
+
4
+ export default defineCommand({
5
+ meta: {
6
+ name: 'lock',
7
+ description: 'Acquire, release, and inspect advisory team file locks',
8
+ },
9
+ args: {
10
+ file: { type: 'string', description: 'File path to lock or inspect' },
11
+ agentId: { type: 'string', description: 'Agent ID acquiring or releasing the lock' },
12
+ json: { type: 'boolean', description: 'Emit machine-readable JSON output' },
13
+ },
14
+ run: async ({ args }) => {
15
+ const action = (args._ as string[])?.[0] || '';
16
+ const asJson = !!args.json;
17
+
18
+ try {
19
19
  const { project, teamStore, identity } = await getCliProjectContext();
20
20
  const agentId = resolveCliActorId(args.agentId, identity);
21
-
22
- switch (action) {
23
- case 'lock': {
21
+
22
+ switch (action) {
23
+ case 'lock': {
24
24
  if (!args.file || !agentId) {
25
25
  emitError('file and an active CLI identity or agentId are required for "memorix lock lock"', asJson);
26
26
  return;
27
27
  }
28
28
  const result = teamStore.acquireLock(project.id, args.file as string, agentId);
29
- if (!result.success) {
30
- emitError(`File is already locked by ${shortId(result.lockedBy)}`, asJson);
31
- return;
32
- }
33
- emitResult(
29
+ if (!result.success) {
30
+ emitError(`File is already locked by ${shortId(result.lockedBy)}`, asJson);
31
+ return;
32
+ }
33
+ emitResult(
34
34
  { project, file: args.file, lockedBy: agentId },
35
- `Locked: ${args.file as string}`,
36
- asJson,
37
- );
38
- return;
39
- }
40
-
41
- case 'unlock': {
35
+ `Locked: ${args.file as string}`,
36
+ asJson,
37
+ );
38
+ return;
39
+ }
40
+
41
+ case 'unlock': {
42
42
  if (!args.file || !agentId) {
43
43
  emitError('file and an active CLI identity or agentId are required for "memorix lock unlock"', asJson);
44
44
  return;
45
45
  }
46
46
  const released = teamStore.releaseLock(project.id, args.file as string, agentId);
47
- if (!released) {
48
- emitError('Cannot unlock: not the owner or the file is not locked', asJson);
49
- return;
50
- }
51
- emitResult(
52
- { project, file: args.file, released: true },
53
- `Unlocked: ${args.file as string}`,
54
- asJson,
55
- );
56
- return;
57
- }
58
-
59
- case 'status': {
60
- if (args.file) {
61
- const lock = teamStore.getLockStatus(project.id, args.file as string);
62
- emitResult(
63
- { project, lock },
64
- lock
65
- ? `Locked by ${teamStore.getAgent(lock.locked_by)?.name ?? shortId(lock.locked_by)}: ${args.file as string}`
66
- : `Unlocked: ${args.file as string}`,
67
- asJson,
68
- );
69
- return;
70
- }
71
-
47
+ if (!released) {
48
+ emitError('Cannot unlock: not the owner or the file is not locked', asJson);
49
+ return;
50
+ }
51
+ emitResult(
52
+ { project, file: args.file, released: true },
53
+ `Unlocked: ${args.file as string}`,
54
+ asJson,
55
+ );
56
+ return;
57
+ }
58
+
59
+ case 'status': {
60
+ if (args.file) {
61
+ const lock = teamStore.getLockStatus(project.id, args.file as string);
62
+ emitResult(
63
+ { project, lock },
64
+ lock
65
+ ? `Locked by ${teamStore.getAgent(lock.locked_by)?.name ?? shortId(lock.locked_by)}: ${args.file as string}`
66
+ : `Unlocked: ${args.file as string}`,
67
+ asJson,
68
+ );
69
+ return;
70
+ }
71
+
72
72
  const locks = teamStore.listLocks(project.id, agentId);
73
- emitResult(
74
- { project, locks },
75
- locks.length === 0
76
- ? 'No active file locks.'
77
- : locks
78
- .map((lock) => `- ${lock.file} -> ${teamStore.getAgent(lock.locked_by)?.name ?? shortId(lock.locked_by)}`)
79
- .join('\n'),
80
- asJson,
81
- );
82
- return;
83
- }
84
-
85
- default:
86
- console.log('Memorix Lock Commands');
87
- console.log('');
88
- console.log('Usage:');
89
- console.log(' memorix lock lock --file src/app.ts --agentId <id>');
90
- console.log(' memorix lock unlock --file src/app.ts --agentId <id>');
91
- console.log(' memorix lock status [--file src/app.ts] [--agentId <id>]');
92
- }
93
- } catch (error) {
94
- emitError(error instanceof Error ? error.message : String(error), asJson);
95
- }
96
- },
97
- });
73
+ emitResult(
74
+ { project, locks },
75
+ locks.length === 0
76
+ ? 'No active file locks.'
77
+ : locks
78
+ .map((lock) => `- ${lock.file} -> ${teamStore.getAgent(lock.locked_by)?.name ?? shortId(lock.locked_by)}`)
79
+ .join('\n'),
80
+ asJson,
81
+ );
82
+ return;
83
+ }
84
+
85
+ default:
86
+ console.log('Memorix Lock Commands');
87
+ console.log('');
88
+ console.log('Usage:');
89
+ console.log(' memorix lock lock --file src/app.ts --agentId <id>');
90
+ console.log(' memorix lock unlock --file src/app.ts --agentId <id>');
91
+ console.log(' memorix lock status [--file src/app.ts] [--agentId <id>]');
92
+ }
93
+ } catch (error) {
94
+ emitError(error instanceof Error ? error.message : String(error), asJson);
95
+ }
96
+ },
97
+ });