memorix 1.4.3 → 1.4.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 (144) hide show
  1. package/CHANGELOG.md +19 -0
  2. package/README.md +11 -4
  3. package/README.zh-CN.md +7 -1
  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 +194 -109
  9. package/dist/cli/memcode.js +0 -0
  10. package/dist/index.js +39 -12
  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 +19 -0
  16. package/dist/sdk.js +38 -11
  17. package/dist/vector-backfill-runner.js +9 -7
  18. package/docs/AGENT_OPERATOR_PLAYBOOK.md +3 -3
  19. package/docs/API_REFERENCE.md +9 -5
  20. package/docs/CONFIGURATION.md +15 -5
  21. package/docs/DESIGN_DECISIONS.md +357 -357
  22. package/docs/DEVELOPMENT.md +2 -2
  23. package/docs/KNOWN_ISSUES_AND_ROADMAP.md +3 -3
  24. package/docs/MODULES.md +1 -1
  25. package/docs/README.md +1 -1
  26. package/docs/SETUP.md +3 -3
  27. package/docs/hooks-architecture.md +2 -1
  28. package/llms-full.txt +4 -4
  29. package/llms.txt +2 -2
  30. package/package.json +1 -1
  31. package/plugins/claude/memorix/.claude-plugin/plugin.json +1 -1
  32. package/plugins/codebuddy/memorix/.codebuddy-plugin/plugin.json +1 -1
  33. package/plugins/codex/memorix/.codex-plugin/plugin.json +1 -1
  34. package/plugins/copilot/memorix/plugin.json +1 -1
  35. package/plugins/gemini/memorix/gemini-extension.json +1 -1
  36. package/plugins/omp/memorix/package.json +1 -1
  37. package/plugins/openclaw/memorix/.codex-plugin/plugin.json +1 -1
  38. package/plugins/pi/memorix/package.json +1 -1
  39. package/server.json +2 -2
  40. package/src/audit/index.ts +156 -156
  41. package/src/cli/commands/audit-list.ts +89 -89
  42. package/src/cli/commands/formation.ts +48 -48
  43. package/src/cli/commands/git-hook-install.ts +111 -111
  44. package/src/cli/commands/handoff.ts +54 -54
  45. package/src/cli/commands/hooks-status.ts +63 -63
  46. package/src/cli/commands/ingest.ts +44 -44
  47. package/src/cli/commands/integrate-shared.ts +15 -15
  48. package/src/cli/commands/lock.ts +82 -82
  49. package/src/cli/commands/media-image.ts +27 -0
  50. package/src/cli/commands/media.ts +8 -1
  51. package/src/cli/commands/memory.ts +44 -34
  52. package/src/cli/commands/message.ts +104 -104
  53. package/src/cli/commands/operator-shared.ts +62 -18
  54. package/src/cli/commands/poll.ts +58 -58
  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 +118 -118
  58. package/src/cli/commands/skills.ts +114 -114
  59. package/src/cli/commands/task.ts +167 -167
  60. package/src/cli/commands/transfer.ts +47 -47
  61. package/src/cli/commands/uninstall-project-artifacts.ts +85 -85
  62. package/src/cli/tui/ChatView.tsx +234 -234
  63. package/src/cli/tui/CommandBar.tsx +312 -312
  64. package/src/cli/tui/ContextRail.tsx +118 -118
  65. package/src/cli/tui/HeaderBar.tsx +72 -72
  66. package/src/cli/tui/LogoBanner.tsx +51 -51
  67. package/src/cli/tui/Sidebar.tsx +179 -179
  68. package/src/cli/tui/index.ts +41 -41
  69. package/src/cli/tui/markdown-render.tsx +371 -371
  70. package/src/cli/tui/use-mouse.ts +157 -157
  71. package/src/cli/tui/useNavigation.ts +56 -56
  72. package/src/cli/version.ts +7 -7
  73. package/src/cli/workbench.ts +1 -1
  74. package/src/dashboard/project-classification.ts +64 -64
  75. package/src/git/hooks-path.ts +85 -85
  76. package/src/hooks/pattern-detector.ts +173 -173
  77. package/src/hooks/significance-filter.ts +250 -250
  78. package/src/llm/memory-manager.ts +328 -328
  79. package/src/llm/provider.ts +885 -885
  80. package/src/llm/quality.ts +248 -248
  81. package/src/media/minimax.ts +9 -1
  82. package/src/memory/attribution-guard.ts +249 -249
  83. package/src/memory/disclosure-policy.ts +135 -135
  84. package/src/memory/entity-extractor.ts +197 -197
  85. package/src/memory/formation/evaluate.ts +217 -217
  86. package/src/memory/formation/extract.ts +361 -361
  87. package/src/memory/formation/index.ts +417 -417
  88. package/src/memory/formation/resolve.ts +344 -344
  89. package/src/memory/formation/types.ts +315 -315
  90. package/src/memory/freshness.ts +122 -122
  91. package/src/memory/graph.ts +197 -197
  92. package/src/memory/refs.ts +94 -94
  93. package/src/memory/secret-filter.ts +79 -79
  94. package/src/orchestrate/adapters/claude-stream.ts +192 -192
  95. package/src/orchestrate/adapters/claude.ts +111 -111
  96. package/src/orchestrate/adapters/codex-stream.ts +134 -134
  97. package/src/orchestrate/adapters/codex.ts +41 -41
  98. package/src/orchestrate/adapters/gemini-stream.ts +166 -166
  99. package/src/orchestrate/adapters/gemini.ts +42 -42
  100. package/src/orchestrate/adapters/index.ts +73 -73
  101. package/src/orchestrate/adapters/opencode-stream.ts +143 -143
  102. package/src/orchestrate/adapters/opencode.ts +47 -47
  103. package/src/orchestrate/adapters/types.ts +77 -77
  104. package/src/orchestrate/capability-router.ts +284 -284
  105. package/src/orchestrate/context-compact.ts +188 -188
  106. package/src/orchestrate/cost-tracker.ts +219 -219
  107. package/src/orchestrate/error-recovery.ts +191 -191
  108. package/src/orchestrate/evidence.ts +140 -140
  109. package/src/orchestrate/ledger.ts +110 -110
  110. package/src/orchestrate/memorix-bridge.ts +343 -343
  111. package/src/orchestrate/output-budget.ts +80 -80
  112. package/src/orchestrate/permission.ts +152 -152
  113. package/src/orchestrate/pipeline-trace.ts +131 -131
  114. package/src/orchestrate/prompt-builder.ts +155 -155
  115. package/src/orchestrate/ring-buffer.ts +37 -37
  116. package/src/orchestrate/task-graph.ts +389 -389
  117. package/src/project/aliases.ts +374 -374
  118. package/src/rules/adapters/trae.ts +56 -56
  119. package/src/rules/syncer.ts +235 -235
  120. package/src/search/query-expansion.ts +52 -52
  121. package/src/server/formation-timeout.ts +27 -27
  122. package/src/server.ts +23 -1
  123. package/src/skills/mini-skills.ts +386 -386
  124. package/src/store/chat-store.ts +119 -119
  125. package/src/store/graph-store.ts +249 -249
  126. package/src/store/mini-skill-store.ts +349 -349
  127. package/src/store/persistence-json.ts +212 -212
  128. package/src/store/persistence.ts +291 -291
  129. package/src/store/project-affinity.ts +195 -195
  130. package/src/team/event-bus.ts +76 -76
  131. package/src/team/file-locks.ts +173 -173
  132. package/src/team/handoff.ts +161 -161
  133. package/src/team/messages.ts +203 -203
  134. package/src/team/poll.ts +132 -132
  135. package/src/team/tasks.ts +211 -211
  136. package/src/workspace/mcp-adapters/codex.ts +191 -191
  137. package/src/workspace/mcp-adapters/copilot.ts +105 -105
  138. package/src/workspace/mcp-adapters/cursor.ts +53 -53
  139. package/src/workspace/mcp-adapters/kiro.ts +64 -64
  140. package/src/workspace/mcp-adapters/opencode.ts +123 -123
  141. package/src/workspace/mcp-adapters/trae.ts +134 -134
  142. package/src/workspace/mcp-adapters/windsurf.ts +91 -91
  143. package/src/workspace/sanitizer.ts +60 -60
  144. package/dist/memcode-runtime/docs/images/exy.png +0 -0
@@ -1,32 +1,32 @@
1
- import { defineCommand } from 'citty';
2
- import { computePoll, computeWatermark } from '../../team/poll.js';
3
- import { getObservationStore } from '../../store/obs-store.js';
1
+ import { defineCommand } from 'citty';
2
+ import { computePoll, computeWatermark } from '../../team/poll.js';
3
+ import { getObservationStore } from '../../store/obs-store.js';
4
4
  import { getAllObservations } from '../../memory/observations.js';
5
5
  import { withFreshIndex } from '../../memory/freshness.js';
6
6
  import { filterReadableObservations } from '../../memory/visibility.js';
7
7
  import { emitError, emitResult, getCliProjectContext, resolveCliActorId, shortId } from './operator-shared.js';
8
-
9
- export default defineCommand({
10
- meta: {
11
- name: 'poll',
12
- description: 'Get a full project coordination snapshot for an agent',
13
- },
14
- args: {
15
- agentId: { type: 'string', description: 'Agent ID for personalized situational awareness' },
16
- markInboxRead: { type: 'boolean', description: 'Mark all inbox messages as read after returning them' },
17
- json: { type: 'boolean', description: 'Emit machine-readable JSON output' },
18
- },
19
- run: async ({ args }) => {
20
- const asJson = !!args.json;
21
-
22
- try {
8
+
9
+ export default defineCommand({
10
+ meta: {
11
+ name: 'poll',
12
+ description: 'Get a full project coordination snapshot for an agent',
13
+ },
14
+ args: {
15
+ agentId: { type: 'string', description: 'Agent ID for personalized situational awareness' },
16
+ markInboxRead: { type: 'boolean', description: 'Mark all inbox messages as read after returning them' },
17
+ json: { type: 'boolean', description: 'Emit machine-readable JSON output' },
18
+ },
19
+ run: async ({ args }) => {
20
+ const asJson = !!args.json;
21
+
22
+ try {
23
23
  const { project, teamStore, identity, reader: activeReader } = await getCliProjectContext();
24
24
  const agentId = resolveCliActorId(args.agentId, identity);
25
25
  let reader = activeReader;
26
-
27
- let watermark = computeWatermark(0, 0, 0);
28
- if (agentId) {
29
- const agent = teamStore.getAgent(agentId);
26
+
27
+ let watermark = computeWatermark(0, 0, 0);
28
+ if (agentId) {
29
+ const agent = teamStore.getAgent(agentId);
30
30
  if (!agent || agent.project_id !== project.id) {
31
31
  emitError(`Unknown agent "${agentId}"`, asJson);
32
32
  return;
@@ -36,45 +36,45 @@ export default defineCommand({
36
36
  agentId,
37
37
  isTeamMember: agent.status === 'active',
38
38
  };
39
-
40
- const lastSeen = agent.last_seen_obs_generation;
41
- const currentGen = getObservationStore().getGeneration();
42
- const projectObs = await withFreshIndex(() =>
39
+
40
+ const lastSeen = agent.last_seen_obs_generation;
41
+ const currentGen = getObservationStore().getGeneration();
42
+ const projectObs = await withFreshIndex(() =>
43
43
  filterReadableObservations(
44
44
  getAllObservations().filter(
45
45
  (obs) => obs.projectId === project.id && (obs.writeGeneration ?? 0) > lastSeen,
46
46
  ),
47
47
  reader,
48
48
  ),
49
- );
50
- watermark = computeWatermark(lastSeen, currentGen, projectObs.length);
51
- teamStore.updateWatermark(agentId, currentGen);
52
- teamStore.heartbeat(agentId);
53
- }
54
-
55
- const poll = computePoll(teamStore, project.id, agentId ?? null, watermark);
56
- if (args.markInboxRead && agentId) {
57
- teamStore.markAllRead(project.id, agentId);
58
- }
59
-
60
- const text = [
61
- poll.agent ? `You: ${shortId(poll.agent.agentId)} (${poll.agent.status})` : 'Project-level overview',
62
- poll.watermark.newObservationCount > 0
63
- ? `${poll.watermark.newObservationCount} new observation(s)`
64
- : 'No unseen observations',
65
- poll.inbox.unreadCount > 0 ? `${poll.inbox.unreadCount} unread message(s)` : 'Inbox clear',
66
- poll.tasks.myInProgress.length > 0
67
- ? `${poll.tasks.myInProgress.length} in-progress task(s)`
68
- : 'No in-progress tasks',
69
- poll.tasks.availableToClaim.length > 0
70
- ? `${poll.tasks.availableToClaim.length} task(s) available to claim`
71
- : 'No claimable tasks',
72
- `Team: ${poll.team.activeAgents.length} active / ${poll.team.totalAgents} total`,
73
- ].join('\n');
74
-
75
- emitResult({ project, poll }, text, asJson);
76
- } catch (error) {
77
- emitError(error instanceof Error ? error.message : String(error), asJson);
78
- }
79
- },
80
- });
49
+ );
50
+ watermark = computeWatermark(lastSeen, currentGen, projectObs.length);
51
+ teamStore.updateWatermark(agentId, currentGen);
52
+ teamStore.heartbeat(agentId);
53
+ }
54
+
55
+ const poll = computePoll(teamStore, project.id, agentId ?? null, watermark);
56
+ if (args.markInboxRead && agentId) {
57
+ teamStore.markAllRead(project.id, agentId);
58
+ }
59
+
60
+ const text = [
61
+ poll.agent ? `You: ${shortId(poll.agent.agentId)} (${poll.agent.status})` : 'Project-level overview',
62
+ poll.watermark.newObservationCount > 0
63
+ ? `${poll.watermark.newObservationCount} new observation(s)`
64
+ : 'No unseen observations',
65
+ poll.inbox.unreadCount > 0 ? `${poll.inbox.unreadCount} unread message(s)` : 'Inbox clear',
66
+ poll.tasks.myInProgress.length > 0
67
+ ? `${poll.tasks.myInProgress.length} in-progress task(s)`
68
+ : 'No in-progress tasks',
69
+ poll.tasks.availableToClaim.length > 0
70
+ ? `${poll.tasks.availableToClaim.length} task(s) available to claim`
71
+ : 'No claimable tasks',
72
+ `Team: ${poll.team.activeAgents.length} active / ${poll.team.totalAgents} total`,
73
+ ].join('\n');
74
+
75
+ emitResult({ project, poll }, text, asJson);
76
+ } catch (error) {
77
+ emitError(error instanceof Error ? error.message : String(error), asJson);
78
+ }
79
+ },
80
+ });
@@ -1,85 +1,85 @@
1
- /**
2
- * CLI Command: memorix purge all-memory
3
- *
4
- * Delete ALL memories (dangerous operation).
5
- */
6
-
7
- import { defineCommand } from 'citty';
8
- import * as p from '@clack/prompts';
9
-
10
- export default defineCommand({
11
- meta: {
12
- name: 'all-memory',
13
- description: 'Delete ALL memories (dangerous)',
14
- },
15
- args: {},
16
- run: async ({}) => {
17
- p.intro('[WARN] Purge All Memory');
18
-
19
- // Show warning
20
- console.log('');
21
- console.log('[WARN] WARNING: This will delete ALL memories!');
22
- console.log('');
23
- console.log('This will remove:');
24
- console.log(' - All observations from all projects');
25
- console.log(' - All entities and relations');
26
- console.log(' - All embeddings');
27
- console.log('');
28
- console.log('This action CANNOT be undone.');
29
- console.log('');
30
- console.log('Project artifacts (hook files) will be preserved.');
31
- console.log('');
32
-
33
- // First confirmation
34
- const confirmed1 = await p.confirm({
35
- message: 'Are you sure you want to delete ALL memories?',
36
- });
37
-
38
- if (p.isCancel(confirmed1) || !confirmed1) {
39
- p.outro('Purge cancelled.');
40
- return;
41
- }
42
-
43
- // Second confirmation (type "DELETE" to confirm)
44
- const confirmed2 = await p.text({
45
- message: 'Type "DELETE" to confirm:',
46
- validate: (value) => {
47
- if (value !== 'DELETE') {
48
- return 'Please type "DELETE" to confirm';
49
- }
50
- return undefined;
51
- },
52
- });
53
-
54
- if (p.isCancel(confirmed2) || confirmed2 !== 'DELETE') {
55
- p.outro('Purge cancelled.');
56
- return;
57
- }
58
-
59
- // Delete all memories
60
- try {
61
- const {
62
- getAllObservations,
63
- resolveObservations,
64
- } = await import('../../memory/observations.js');
65
- const { withFreshIndex } = await import('../../memory/freshness.js');
66
- const observations = await withFreshIndex(() => getAllObservations());
67
- const ids = observations.map((o) => o.id);
68
-
69
- if (ids.length === 0) {
70
- console.log('No observations found.');
71
- p.outro('No memories to purge.');
72
- return;
73
- }
74
-
75
- const result = await resolveObservations(ids, 'archived');
76
-
77
- console.log(`[OK] Archived ${result.resolved.length} observations`);
78
-
79
- p.outro(`All memory purged. ${result.resolved.length} observations archived.`);
80
- } catch (err) {
81
- console.error(`[ERROR] Failed to purge all memory: ${err}`);
82
- p.outro('Purge failed.');
83
- }
84
- },
85
- });
1
+ /**
2
+ * CLI Command: memorix purge all-memory
3
+ *
4
+ * Delete ALL memories (dangerous operation).
5
+ */
6
+
7
+ import { defineCommand } from 'citty';
8
+ import * as p from '@clack/prompts';
9
+
10
+ export default defineCommand({
11
+ meta: {
12
+ name: 'all-memory',
13
+ description: 'Delete ALL memories (dangerous)',
14
+ },
15
+ args: {},
16
+ run: async ({}) => {
17
+ p.intro('[WARN] Purge All Memory');
18
+
19
+ // Show warning
20
+ console.log('');
21
+ console.log('[WARN] WARNING: This will delete ALL memories!');
22
+ console.log('');
23
+ console.log('This will remove:');
24
+ console.log(' - All observations from all projects');
25
+ console.log(' - All entities and relations');
26
+ console.log(' - All embeddings');
27
+ console.log('');
28
+ console.log('This action CANNOT be undone.');
29
+ console.log('');
30
+ console.log('Project artifacts (hook files) will be preserved.');
31
+ console.log('');
32
+
33
+ // First confirmation
34
+ const confirmed1 = await p.confirm({
35
+ message: 'Are you sure you want to delete ALL memories?',
36
+ });
37
+
38
+ if (p.isCancel(confirmed1) || !confirmed1) {
39
+ p.outro('Purge cancelled.');
40
+ return;
41
+ }
42
+
43
+ // Second confirmation (type "DELETE" to confirm)
44
+ const confirmed2 = await p.text({
45
+ message: 'Type "DELETE" to confirm:',
46
+ validate: (value) => {
47
+ if (value !== 'DELETE') {
48
+ return 'Please type "DELETE" to confirm';
49
+ }
50
+ return undefined;
51
+ },
52
+ });
53
+
54
+ if (p.isCancel(confirmed2) || confirmed2 !== 'DELETE') {
55
+ p.outro('Purge cancelled.');
56
+ return;
57
+ }
58
+
59
+ // Delete all memories
60
+ try {
61
+ const {
62
+ getAllObservations,
63
+ resolveObservations,
64
+ } = await import('../../memory/observations.js');
65
+ const { withFreshIndex } = await import('../../memory/freshness.js');
66
+ const observations = await withFreshIndex(() => getAllObservations());
67
+ const ids = observations.map((o) => o.id);
68
+
69
+ if (ids.length === 0) {
70
+ console.log('No observations found.');
71
+ p.outro('No memories to purge.');
72
+ return;
73
+ }
74
+
75
+ const result = await resolveObservations(ids, 'archived');
76
+
77
+ console.log(`[OK] Archived ${result.resolved.length} observations`);
78
+
79
+ p.outro(`All memory purged. ${result.resolved.length} observations archived.`);
80
+ } catch (err) {
81
+ console.error(`[ERROR] Failed to purge all memory: ${err}`);
82
+ p.outro('Purge failed.');
83
+ }
84
+ },
85
+ });
@@ -1,83 +1,83 @@
1
- /**
2
- * CLI Command: memorix purge project-memory
3
- *
4
- * Delete memories for the current project only.
5
- */
6
-
7
- import { defineCommand } from 'citty';
8
- import * as p from '@clack/prompts';
9
-
10
- export default defineCommand({
11
- meta: {
12
- name: 'project-memory',
13
- description: 'Delete memories for current project',
14
- },
15
- args: {},
16
- run: async ({}) => {
17
- const os = await import('node:os');
18
- let cwd: string;
19
- try { cwd = process.cwd(); } catch { cwd = os.homedir(); }
20
-
21
- p.intro('Purge Project Memory');
22
-
23
- // Show what will be deleted
24
- console.log('');
25
- console.log('Will delete memories for:');
26
- console.log(` Project: ${cwd}`);
27
- console.log('');
28
- console.log('This will remove all observations, entities, and relations');
29
- console.log('associated with this project from the memory database.');
30
- console.log('');
31
- console.log('Project artifacts (hook files) will be preserved.');
32
- console.log('');
33
-
34
- // Confirm
35
- const confirmed = await p.confirm({
36
- message: 'Continue purge?',
37
- });
38
-
39
- if (p.isCancel(confirmed) || !confirmed) {
40
- p.outro('Purge cancelled.');
41
- return;
42
- }
43
-
44
- // Get project ID
45
- const projectId = getProjectId(cwd);
46
-
47
- // Delete project memories
48
- try {
49
- const {
50
- getProjectObservations,
51
- resolveObservations,
52
- } = await import('../../memory/observations.js');
53
- const { withFreshIndex } = await import('../../memory/freshness.js');
54
- const observations = await withFreshIndex(() => getProjectObservations(projectId));
55
- const ids = observations.map((o) => o.id);
56
-
57
- if (ids.length === 0) {
58
- console.log('No observations found for this project.');
59
- p.outro('No memories to purge.');
60
- return;
61
- }
62
-
63
- const result = await resolveObservations(ids, 'archived');
64
-
65
- console.log(`[OK] Archived ${result.resolved.length} observations for project`);
66
-
67
- p.outro(`Project memory purged. ${result.resolved.length} observations archived.`);
68
- } catch (err) {
69
- console.error(`[ERROR] Failed to purge project memory: ${err}`);
70
- p.outro('Purge failed.');
71
- }
72
- },
73
- });
74
-
75
- function getProjectId(projectRoot: string): string {
76
- try {
77
- const { detectProject } = require('../project/detector.js');
78
- const project = detectProject(projectRoot);
79
- if (project) return project.id;
80
- } catch { /* fallback below */ }
81
- const normalized = projectRoot.replace(/\\/g, '/');
82
- return `untracked/${normalized}`;
83
- }
1
+ /**
2
+ * CLI Command: memorix purge project-memory
3
+ *
4
+ * Delete memories for the current project only.
5
+ */
6
+
7
+ import { defineCommand } from 'citty';
8
+ import * as p from '@clack/prompts';
9
+
10
+ export default defineCommand({
11
+ meta: {
12
+ name: 'project-memory',
13
+ description: 'Delete memories for current project',
14
+ },
15
+ args: {},
16
+ run: async ({}) => {
17
+ const os = await import('node:os');
18
+ let cwd: string;
19
+ try { cwd = process.cwd(); } catch { cwd = os.homedir(); }
20
+
21
+ p.intro('Purge Project Memory');
22
+
23
+ // Show what will be deleted
24
+ console.log('');
25
+ console.log('Will delete memories for:');
26
+ console.log(` Project: ${cwd}`);
27
+ console.log('');
28
+ console.log('This will remove all observations, entities, and relations');
29
+ console.log('associated with this project from the memory database.');
30
+ console.log('');
31
+ console.log('Project artifacts (hook files) will be preserved.');
32
+ console.log('');
33
+
34
+ // Confirm
35
+ const confirmed = await p.confirm({
36
+ message: 'Continue purge?',
37
+ });
38
+
39
+ if (p.isCancel(confirmed) || !confirmed) {
40
+ p.outro('Purge cancelled.');
41
+ return;
42
+ }
43
+
44
+ // Get project ID
45
+ const projectId = getProjectId(cwd);
46
+
47
+ // Delete project memories
48
+ try {
49
+ const {
50
+ getProjectObservations,
51
+ resolveObservations,
52
+ } = await import('../../memory/observations.js');
53
+ const { withFreshIndex } = await import('../../memory/freshness.js');
54
+ const observations = await withFreshIndex(() => getProjectObservations(projectId));
55
+ const ids = observations.map((o) => o.id);
56
+
57
+ if (ids.length === 0) {
58
+ console.log('No observations found for this project.');
59
+ p.outro('No memories to purge.');
60
+ return;
61
+ }
62
+
63
+ const result = await resolveObservations(ids, 'archived');
64
+
65
+ console.log(`[OK] Archived ${result.resolved.length} observations for project`);
66
+
67
+ p.outro(`Project memory purged. ${result.resolved.length} observations archived.`);
68
+ } catch (err) {
69
+ console.error(`[ERROR] Failed to purge project memory: ${err}`);
70
+ p.outro('Purge failed.');
71
+ }
72
+ },
73
+ });
74
+
75
+ function getProjectId(projectRoot: string): string {
76
+ try {
77
+ const { detectProject } = require('../project/detector.js');
78
+ const project = detectProject(projectRoot);
79
+ if (project) return project.id;
80
+ } catch { /* fallback below */ }
81
+ const normalized = projectRoot.replace(/\\/g, '/');
82
+ return `untracked/${normalized}`;
83
+ }