memorix 1.4.3 → 1.4.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (158) hide show
  1. package/CHANGELOG.md +34 -0
  2. package/README.md +20 -6
  3. package/README.zh-CN.md +16 -3
  4. package/TEAM.md +86 -86
  5. package/assets/star-history-dark.svg +8 -8
  6. package/assets/star-history-light.svg +8 -8
  7. package/assets/star-history.json +16 -2
  8. package/dist/cli/index.js +539 -233
  9. package/dist/cli/memcode.js +0 -0
  10. package/dist/index.js +72 -15
  11. package/dist/maintenance-runner.js +9 -7
  12. package/dist/media-audio-runner.js +9 -7
  13. package/dist/media-video-runner.js +9 -7
  14. package/dist/memcode/index.js +9 -7
  15. package/dist/memcode-runtime/CHANGELOG.md +34 -0
  16. package/dist/sdk.js +71 -14
  17. package/dist/types.d.ts +1 -1
  18. package/dist/vector-backfill-runner.js +9 -7
  19. package/docs/AGENT_OPERATOR_PLAYBOOK.md +6 -5
  20. package/docs/API_REFERENCE.md +9 -5
  21. package/docs/CONFIGURATION.md +15 -5
  22. package/docs/DESIGN_DECISIONS.md +357 -357
  23. package/docs/DEVELOPMENT.md +2 -2
  24. package/docs/INTEGRATIONS.md +9 -2
  25. package/docs/KNOWN_ISSUES_AND_ROADMAP.md +4 -3
  26. package/docs/MEMCODE.md +1 -1
  27. package/docs/MODULES.md +1 -1
  28. package/docs/README.md +1 -1
  29. package/docs/SETUP.md +12 -4
  30. package/docs/hooks-architecture.md +2 -1
  31. package/llms-full.txt +7 -6
  32. package/llms.txt +2 -2
  33. package/package.json +1 -1
  34. package/plugins/claude/memorix/.claude-plugin/plugin.json +1 -1
  35. package/plugins/codebuddy/memorix/.codebuddy-plugin/plugin.json +1 -1
  36. package/plugins/codex/memorix/.codex-plugin/plugin.json +1 -1
  37. package/plugins/copilot/memorix/plugin.json +1 -1
  38. package/plugins/gemini/memorix/gemini-extension.json +1 -1
  39. package/plugins/omp/memorix/package.json +1 -1
  40. package/plugins/openclaw/memorix/.codex-plugin/plugin.json +1 -1
  41. package/plugins/pi/memorix/package.json +1 -1
  42. package/server.json +2 -2
  43. package/src/audit/index.ts +156 -156
  44. package/src/cli/commands/agent-integrations.ts +7 -1
  45. package/src/cli/commands/audit-list.ts +89 -89
  46. package/src/cli/commands/formation.ts +48 -48
  47. package/src/cli/commands/git-hook-install.ts +111 -111
  48. package/src/cli/commands/handoff.ts +54 -54
  49. package/src/cli/commands/hooks-install.ts +2 -0
  50. package/src/cli/commands/hooks-preview.ts +5 -0
  51. package/src/cli/commands/hooks-status.ts +63 -63
  52. package/src/cli/commands/ingest.ts +44 -44
  53. package/src/cli/commands/integrate-shared.ts +15 -15
  54. package/src/cli/commands/integrate.ts +2 -0
  55. package/src/cli/commands/lock.ts +82 -82
  56. package/src/cli/commands/media-image.ts +27 -0
  57. package/src/cli/commands/media.ts +8 -1
  58. package/src/cli/commands/memory.ts +44 -34
  59. package/src/cli/commands/message.ts +104 -104
  60. package/src/cli/commands/operator-shared.ts +62 -18
  61. package/src/cli/commands/poll.ts +58 -58
  62. package/src/cli/commands/purge-all-memory.ts +85 -85
  63. package/src/cli/commands/purge-project-memory.ts +83 -83
  64. package/src/cli/commands/reasoning.ts +118 -118
  65. package/src/cli/commands/setup.ts +57 -2
  66. package/src/cli/commands/skills.ts +114 -114
  67. package/src/cli/commands/task.ts +167 -167
  68. package/src/cli/commands/transfer.ts +47 -47
  69. package/src/cli/commands/uninstall-project-artifacts.ts +85 -85
  70. package/src/cli/commands/uninstall.ts +20 -0
  71. package/src/cli/tui/ChatView.tsx +234 -234
  72. package/src/cli/tui/CommandBar.tsx +312 -312
  73. package/src/cli/tui/ContextRail.tsx +118 -118
  74. package/src/cli/tui/HeaderBar.tsx +72 -72
  75. package/src/cli/tui/LogoBanner.tsx +51 -51
  76. package/src/cli/tui/Sidebar.tsx +179 -179
  77. package/src/cli/tui/index.ts +41 -41
  78. package/src/cli/tui/markdown-render.tsx +371 -371
  79. package/src/cli/tui/use-mouse.ts +157 -157
  80. package/src/cli/tui/useNavigation.ts +56 -56
  81. package/src/cli/version.ts +7 -7
  82. package/src/cli/workbench.ts +1 -1
  83. package/src/dashboard/project-classification.ts +64 -64
  84. package/src/git/hooks-path.ts +85 -85
  85. package/src/hooks/installers/index.ts +43 -2
  86. package/src/hooks/pattern-detector.ts +173 -173
  87. package/src/hooks/significance-filter.ts +250 -250
  88. package/src/hooks/types.ts +2 -0
  89. package/src/integrations/registry.ts +9 -0
  90. package/src/llm/memory-manager.ts +328 -328
  91. package/src/llm/provider.ts +885 -885
  92. package/src/llm/quality.ts +248 -248
  93. package/src/media/minimax.ts +9 -1
  94. package/src/memory/attribution-guard.ts +249 -249
  95. package/src/memory/disclosure-policy.ts +135 -135
  96. package/src/memory/entity-extractor.ts +197 -197
  97. package/src/memory/formation/evaluate.ts +217 -217
  98. package/src/memory/formation/extract.ts +361 -361
  99. package/src/memory/formation/index.ts +417 -417
  100. package/src/memory/formation/resolve.ts +344 -344
  101. package/src/memory/formation/types.ts +315 -315
  102. package/src/memory/freshness.ts +122 -122
  103. package/src/memory/graph.ts +197 -197
  104. package/src/memory/refs.ts +94 -94
  105. package/src/memory/secret-filter.ts +79 -79
  106. package/src/orchestrate/adapters/claude-stream.ts +192 -192
  107. package/src/orchestrate/adapters/claude.ts +111 -111
  108. package/src/orchestrate/adapters/codex-stream.ts +134 -134
  109. package/src/orchestrate/adapters/codex.ts +41 -41
  110. package/src/orchestrate/adapters/gemini-stream.ts +166 -166
  111. package/src/orchestrate/adapters/gemini.ts +42 -42
  112. package/src/orchestrate/adapters/index.ts +73 -73
  113. package/src/orchestrate/adapters/opencode-stream.ts +143 -143
  114. package/src/orchestrate/adapters/opencode.ts +47 -47
  115. package/src/orchestrate/adapters/types.ts +77 -77
  116. package/src/orchestrate/capability-router.ts +284 -284
  117. package/src/orchestrate/context-compact.ts +188 -188
  118. package/src/orchestrate/cost-tracker.ts +219 -219
  119. package/src/orchestrate/error-recovery.ts +191 -191
  120. package/src/orchestrate/evidence.ts +140 -140
  121. package/src/orchestrate/ledger.ts +110 -110
  122. package/src/orchestrate/memorix-bridge.ts +343 -343
  123. package/src/orchestrate/output-budget.ts +80 -80
  124. package/src/orchestrate/permission.ts +152 -152
  125. package/src/orchestrate/pipeline-trace.ts +131 -131
  126. package/src/orchestrate/prompt-builder.ts +155 -155
  127. package/src/orchestrate/ring-buffer.ts +37 -37
  128. package/src/orchestrate/task-graph.ts +389 -389
  129. package/src/project/aliases.ts +374 -374
  130. package/src/rules/adapters/trae.ts +56 -56
  131. package/src/rules/syncer.ts +235 -235
  132. package/src/search/query-expansion.ts +52 -52
  133. package/src/server/formation-timeout.ts +27 -27
  134. package/src/server.ts +23 -1
  135. package/src/skills/mini-skills.ts +386 -386
  136. package/src/store/chat-store.ts +119 -119
  137. package/src/store/graph-store.ts +249 -249
  138. package/src/store/mini-skill-store.ts +349 -349
  139. package/src/store/persistence-json.ts +212 -212
  140. package/src/store/persistence.ts +291 -291
  141. package/src/store/project-affinity.ts +195 -195
  142. package/src/team/event-bus.ts +76 -76
  143. package/src/team/file-locks.ts +173 -173
  144. package/src/team/handoff.ts +161 -161
  145. package/src/team/messages.ts +203 -203
  146. package/src/team/poll.ts +132 -132
  147. package/src/team/tasks.ts +211 -211
  148. package/src/types.ts +1 -1
  149. package/src/workspace/mcp-adapters/codex.ts +191 -191
  150. package/src/workspace/mcp-adapters/copilot.ts +105 -105
  151. package/src/workspace/mcp-adapters/cursor.ts +53 -53
  152. package/src/workspace/mcp-adapters/dsh.ts +147 -0
  153. package/src/workspace/mcp-adapters/kiro.ts +64 -64
  154. package/src/workspace/mcp-adapters/opencode.ts +123 -123
  155. package/src/workspace/mcp-adapters/trae.ts +134 -134
  156. package/src/workspace/mcp-adapters/windsurf.ts +91 -91
  157. package/src/workspace/sanitizer.ts +60 -60
  158. package/dist/memcode-runtime/docs/images/exy.png +0 -0
@@ -1,111 +1,111 @@
1
- /**
2
- * CLI Command: memorix git-hook install
3
- *
4
- * Installs a git post-commit hook that automatically ingests commits as memories.
5
- * This is the Git→Memory automation — every commit becomes a searchable memory.
6
- *
7
- * Cross-platform: generates both bash (Unix) and PowerShell (Windows) hooks.
8
- */
9
-
10
- import { defineCommand } from 'citty';
11
- import * as p from '@clack/prompts';
12
- import { existsSync, readFileSync, writeFileSync, chmodSync } from 'node:fs';
13
- import { ensureHooksDir } from '../../git/hooks-path.js';
14
-
15
- const HOOK_MARKER = '# [memorix-git-hook]';
16
-
17
- export default defineCommand({
18
- meta: {
19
- name: 'git-hook-install',
20
- description: 'Install git post-commit hook for automatic memory capture',
21
- },
22
- args: {
23
- cwd: {
24
- type: 'string',
25
- description: 'Project directory (default: current directory)',
26
- required: false,
27
- },
28
- force: {
29
- type: 'boolean',
30
- description: 'Overwrite existing hook without asking',
31
- required: false,
32
- },
33
- },
34
- run: async ({ args }) => {
35
- const projectDir = args.cwd || process.cwd();
36
-
37
- p.intro('Install Git post-commit hook');
38
-
39
- // 1. Resolve git hooks directory (handles normal repos and worktrees)
40
- const resolved = ensureHooksDir(projectDir);
41
- if (!resolved) {
42
- p.log.error(`No .git found in ${projectDir} (checked both directory and worktree file)`);
43
- p.outro('Run this command from a git repository root.');
44
- return;
45
- }
46
-
47
- const { hookPath } = resolved;
48
-
49
- // 3. Check for existing hook
50
- if (existsSync(hookPath)) {
51
- const existing = readFileSync(hookPath, 'utf-8');
52
-
53
- if (existing.includes(HOOK_MARKER)) {
54
- p.log.warn('Memorix git hook is already installed.');
55
- p.outro('Use `memorix git-hook uninstall` to remove it first.');
56
- return;
57
- }
58
-
59
- // Existing non-memorix hook — ask to append
60
- if (!args.force) {
61
- const action = await p.select({
62
- message: 'A post-commit hook already exists. What would you like to do?',
63
- options: [
64
- { value: 'append', label: 'Append', hint: 'Add memorix hook after existing content' },
65
- { value: 'skip', label: 'Skip', hint: 'Do not modify the existing hook' },
66
- ],
67
- });
68
-
69
- if (p.isCancel(action) || action === 'skip') {
70
- p.outro('Installation cancelled.');
71
- return;
72
- }
73
- }
74
-
75
- // Append to existing hook
76
- const appended = existing.trimEnd() + '\n\n' + generateHookScript();
77
- writeFileSync(hookPath, appended, 'utf-8');
78
- try { chmodSync(hookPath, 0o755); } catch { /* Windows doesn't need chmod */ }
79
-
80
- p.log.success('Memorix hook appended to existing post-commit hook.');
81
- } else {
82
- // Create new hook
83
- const script = '#!/bin/sh\n' + generateHookScript();
84
- writeFileSync(hookPath, script, 'utf-8');
85
- try { chmodSync(hookPath, 0o755); } catch { /* Windows doesn't need chmod */ }
86
-
87
- p.log.success('Git post-commit hook installed.');
88
- }
89
-
90
- p.log.info(`Hook path: ${hookPath}`);
91
- p.log.info('Every commit will now be automatically captured as a memory.');
92
- p.log.info('Memories are tagged with source="git" and include the commit hash.');
93
- p.outro('Done! Try making a commit to see it in action.');
94
- },
95
- });
96
-
97
- /**
98
- * Generate the hook script content.
99
- * Uses `memorix ingest commit --auto` for non-interactive ingest.
100
- * Runs in background to not block the commit.
101
- */
102
- function generateHookScript(): string {
103
- return `${HOOK_MARKER}
104
- # Memorix: Auto-ingest git commits as memories
105
- # Runs in background — does not block your commit workflow.
106
- # To remove: memorix git-hook uninstall
107
- if command -v memorix >/dev/null 2>&1; then
108
- memorix ingest commit --auto >/dev/null 2>&1 &
109
- fi
110
- `;
111
- }
1
+ /**
2
+ * CLI Command: memorix git-hook install
3
+ *
4
+ * Installs a git post-commit hook that automatically ingests commits as memories.
5
+ * This is the Git→Memory automation — every commit becomes a searchable memory.
6
+ *
7
+ * Cross-platform: generates both bash (Unix) and PowerShell (Windows) hooks.
8
+ */
9
+
10
+ import { defineCommand } from 'citty';
11
+ import * as p from '@clack/prompts';
12
+ import { existsSync, readFileSync, writeFileSync, chmodSync } from 'node:fs';
13
+ import { ensureHooksDir } from '../../git/hooks-path.js';
14
+
15
+ const HOOK_MARKER = '# [memorix-git-hook]';
16
+
17
+ export default defineCommand({
18
+ meta: {
19
+ name: 'git-hook-install',
20
+ description: 'Install git post-commit hook for automatic memory capture',
21
+ },
22
+ args: {
23
+ cwd: {
24
+ type: 'string',
25
+ description: 'Project directory (default: current directory)',
26
+ required: false,
27
+ },
28
+ force: {
29
+ type: 'boolean',
30
+ description: 'Overwrite existing hook without asking',
31
+ required: false,
32
+ },
33
+ },
34
+ run: async ({ args }) => {
35
+ const projectDir = args.cwd || process.cwd();
36
+
37
+ p.intro('Install Git post-commit hook');
38
+
39
+ // 1. Resolve git hooks directory (handles normal repos and worktrees)
40
+ const resolved = ensureHooksDir(projectDir);
41
+ if (!resolved) {
42
+ p.log.error(`No .git found in ${projectDir} (checked both directory and worktree file)`);
43
+ p.outro('Run this command from a git repository root.');
44
+ return;
45
+ }
46
+
47
+ const { hookPath } = resolved;
48
+
49
+ // 3. Check for existing hook
50
+ if (existsSync(hookPath)) {
51
+ const existing = readFileSync(hookPath, 'utf-8');
52
+
53
+ if (existing.includes(HOOK_MARKER)) {
54
+ p.log.warn('Memorix git hook is already installed.');
55
+ p.outro('Use `memorix git-hook uninstall` to remove it first.');
56
+ return;
57
+ }
58
+
59
+ // Existing non-memorix hook — ask to append
60
+ if (!args.force) {
61
+ const action = await p.select({
62
+ message: 'A post-commit hook already exists. What would you like to do?',
63
+ options: [
64
+ { value: 'append', label: 'Append', hint: 'Add memorix hook after existing content' },
65
+ { value: 'skip', label: 'Skip', hint: 'Do not modify the existing hook' },
66
+ ],
67
+ });
68
+
69
+ if (p.isCancel(action) || action === 'skip') {
70
+ p.outro('Installation cancelled.');
71
+ return;
72
+ }
73
+ }
74
+
75
+ // Append to existing hook
76
+ const appended = existing.trimEnd() + '\n\n' + generateHookScript();
77
+ writeFileSync(hookPath, appended, 'utf-8');
78
+ try { chmodSync(hookPath, 0o755); } catch { /* Windows doesn't need chmod */ }
79
+
80
+ p.log.success('Memorix hook appended to existing post-commit hook.');
81
+ } else {
82
+ // Create new hook
83
+ const script = '#!/bin/sh\n' + generateHookScript();
84
+ writeFileSync(hookPath, script, 'utf-8');
85
+ try { chmodSync(hookPath, 0o755); } catch { /* Windows doesn't need chmod */ }
86
+
87
+ p.log.success('Git post-commit hook installed.');
88
+ }
89
+
90
+ p.log.info(`Hook path: ${hookPath}`);
91
+ p.log.info('Every commit will now be automatically captured as a memory.');
92
+ p.log.info('Memories are tagged with source="git" and include the commit hash.');
93
+ p.outro('Done! Try making a commit to see it in action.');
94
+ },
95
+ });
96
+
97
+ /**
98
+ * Generate the hook script content.
99
+ * Uses `memorix ingest commit --auto` for non-interactive ingest.
100
+ * Runs in background to not block the commit.
101
+ */
102
+ function generateHookScript(): string {
103
+ return `${HOOK_MARKER}
104
+ # Memorix: Auto-ingest git commits as memories
105
+ # Runs in background — does not block your commit workflow.
106
+ # To remove: memorix git-hook uninstall
107
+ if command -v memorix >/dev/null 2>&1; then
108
+ memorix ingest commit --auto >/dev/null 2>&1 &
109
+ fi
110
+ `;
111
+ }
@@ -1,33 +1,33 @@
1
- import { defineCommand } from 'citty';
2
- import { storeObservation } from '../../memory/observations.js';
3
- import { createHandoffArtifact } from '../../team/handoff.js';
1
+ import { defineCommand } from 'citty';
2
+ import { storeObservation } from '../../memory/observations.js';
3
+ import { createHandoffArtifact } from '../../team/handoff.js';
4
4
  import { emitError, emitResult, getCliProjectContext, parseCsvList, resolveCliActorId, shortId } from './operator-shared.js';
5
-
6
- export default defineCommand({
7
- meta: {
8
- name: 'handoff',
9
- description: 'Create structured handoff artifacts between agents',
10
- },
11
- args: {
12
- fromAgentId: { type: 'string', description: 'Sender agent ID' },
13
- toAgentId: { type: 'string', description: 'Optional recipient agent ID' },
14
- taskId: { type: 'string', description: 'Optional related task ID' },
15
- summary: { type: 'string', description: 'Human-readable summary of the handoff' },
16
- context: { type: 'string', description: 'Detailed machine-readable context for the next agent' },
17
- filesModified: { type: 'string', description: 'Comma-separated file list' },
18
- concepts: { type: 'string', description: 'Comma-separated discoverability concepts' },
19
- json: { type: 'boolean', description: 'Emit machine-readable JSON output' },
20
- },
21
- run: async ({ args }) => {
22
- const action = (args._ as string[])?.[0] || '';
23
- const asJson = !!args.json;
24
-
25
- try {
5
+
6
+ export default defineCommand({
7
+ meta: {
8
+ name: 'handoff',
9
+ description: 'Create structured handoff artifacts between agents',
10
+ },
11
+ args: {
12
+ fromAgentId: { type: 'string', description: 'Sender agent ID' },
13
+ toAgentId: { type: 'string', description: 'Optional recipient agent ID' },
14
+ taskId: { type: 'string', description: 'Optional related task ID' },
15
+ summary: { type: 'string', description: 'Human-readable summary of the handoff' },
16
+ context: { type: 'string', description: 'Detailed machine-readable context for the next agent' },
17
+ filesModified: { type: 'string', description: 'Comma-separated file list' },
18
+ concepts: { type: 'string', description: 'Comma-separated discoverability concepts' },
19
+ json: { type: 'boolean', description: 'Emit machine-readable JSON output' },
20
+ },
21
+ run: async ({ args }) => {
22
+ const action = (args._ as string[])?.[0] || '';
23
+ const asJson = !!args.json;
24
+
25
+ try {
26
26
  const { project, teamStore, identity } = await getCliProjectContext();
27
27
  const fromAgentId = resolveCliActorId(args.fromAgentId, identity, 'fromAgentId');
28
-
29
- switch (action) {
30
- case 'send': {
28
+
29
+ switch (action) {
30
+ case 'send': {
31
31
  if (!fromAgentId || !args.summary || !args.context) {
32
32
  emitError('summary, context, and an active CLI identity or fromAgentId are required for "memorix handoff send"', asJson);
33
33
  return;
@@ -50,31 +50,31 @@ export default defineCommand({
50
50
  projectId: project.id,
51
51
  fromAgentId,
52
52
  toAgentId,
53
- taskId: args.taskId as string | undefined,
54
- summary: args.summary as string,
55
- context: args.context as string,
56
- filesModified: parseCsvList(args.filesModified as string | undefined),
57
- concepts: parseCsvList(args.concepts as string | undefined),
58
- },
59
- storeObservation,
60
- teamStore,
61
- );
62
- emitResult(
63
- { project, handoff: result },
64
- `Handoff created: observation #${result.observationId} from ${shortId(result.fromAgentId)}${result.toAgentId ? ` to ${shortId(result.toAgentId)}` : ' (broadcast)'}`,
65
- asJson,
66
- );
67
- return;
68
- }
69
-
70
- default:
71
- console.log('Memorix Handoff Commands');
72
- console.log('');
73
- console.log('Usage:');
53
+ taskId: args.taskId as string | undefined,
54
+ summary: args.summary as string,
55
+ context: args.context as string,
56
+ filesModified: parseCsvList(args.filesModified as string | undefined),
57
+ concepts: parseCsvList(args.concepts as string | undefined),
58
+ },
59
+ storeObservation,
60
+ teamStore,
61
+ );
62
+ emitResult(
63
+ { project, handoff: result },
64
+ `Handoff created: observation #${result.observationId} from ${shortId(result.fromAgentId)}${result.toAgentId ? ` to ${shortId(result.toAgentId)}` : ' (broadcast)'}`,
65
+ asJson,
66
+ );
67
+ return;
68
+ }
69
+
70
+ default:
71
+ console.log('Memorix Handoff Commands');
72
+ console.log('');
73
+ console.log('Usage:');
74
74
  console.log(' memorix handoff send --summary "..." --context "..." [--fromAgentId <id>] [--toAgentId <id>] [--taskId <id>]');
75
- }
76
- } catch (error) {
77
- emitError(error instanceof Error ? error.message : String(error), asJson);
78
- }
79
- },
80
- });
75
+ }
76
+ } catch (error) {
77
+ emitError(error instanceof Error ? error.message : String(error), asJson);
78
+ }
79
+ },
80
+ });
@@ -159,6 +159,7 @@ function getAgentLabel(agent: string): string {
159
159
  hermes: 'Hermes Agent',
160
160
  omp: 'Oh-my-Pi',
161
161
  trae: 'Trae',
162
+ dsh: 'DeepSeek Harness',
162
163
  };
163
164
  return labels[agent] || agent;
164
165
  }
@@ -177,6 +178,7 @@ function getAgentHint(agent: string): string {
177
178
  hermes: 'Hermes plugin hooks; use `memorix setup --agent hermes`',
178
179
  omp: 'Oh-my-Pi package hooks; use `memorix setup --agent omp`',
179
180
  trae: '.trae/rules/project_rules.md (rules only, no hooks system)',
181
+ dsh: '~/.dsh/cordis.patch.yml MCP row via `memorix setup --agent dsh` (no hooks system)',
180
182
  codex: 'Codex plugin hooks; use `memorix setup --agent codex`',
181
183
  };
182
184
  return hints[agent] || '';
@@ -152,6 +152,7 @@ function estimateFileSize(agent: string, configPath: string): string {
152
152
  antigravity: '~2KB',
153
153
  opencode: '~3KB',
154
154
  trae: '~1KB',
155
+ dsh: '~1KB',
155
156
  };
156
157
  return sizes[agent] || '~2KB';
157
158
  }
@@ -171,6 +172,8 @@ function getRulesPath(agent: string, cwd: string, global: boolean): string {
171
172
  return path.join(home, '.gemini', 'GEMINI.md');
172
173
  case 'trae':
173
174
  return path.join(home, '.trae', 'rules', 'project_rules.md');
175
+ case 'dsh':
176
+ return path.join(process.env.DSH_HOME?.trim() || path.join(home, '.dsh'), 'AGENTS.md');
174
177
  default:
175
178
  return '';
176
179
  }
@@ -186,6 +189,8 @@ function getRulesPath(agent: string, cwd: string, global: boolean): string {
186
189
  return path.join(cwd, 'GEMINI.md');
187
190
  case 'trae':
188
191
  return path.join(cwd, '.trae', 'rules', 'project_rules.md');
192
+ case 'dsh':
193
+ return path.join(cwd, 'AGENTS.md');
189
194
  default:
190
195
  return '';
191
196
  }
@@ -1,71 +1,71 @@
1
- /**
2
- * CLI Command: memorix hooks status
3
- *
4
- * Show hook installation status for all agents.
1
+ /**
2
+ * CLI Command: memorix hooks status
3
+ *
4
+ * Show hook installation status for all agents.
5
5
  * Status marks:
6
6
  * [OK] - installed and verified (config-based agent, file read directly)
7
7
  * [??] - installed but unverified (plugin-based agent, runtime load not confirmed)
8
8
  * [!!] - installed but outdated
9
9
  * [ ] - not installed
10
- */
11
-
12
- import { defineCommand } from 'citty';
13
-
14
- export default defineCommand({
15
- meta: {
16
- name: 'status',
17
- description: 'Show hook installation status for all agents',
18
- },
19
- run: async () => {
20
- const { getHookStatus } = await import('../../hooks/installers/index.js');
21
- const { AGENT_SUPPORT_TIER } = await import('../../hooks/types.js');
22
- const os = await import('node:os');
23
- let cwd: string;
24
- try { cwd = process.cwd(); } catch { cwd = os.homedir(); }
25
-
26
- const statuses = await getHookStatus(cwd);
27
-
28
- console.log('\nMemorix Hooks Status');
10
+ */
11
+
12
+ import { defineCommand } from 'citty';
13
+
14
+ export default defineCommand({
15
+ meta: {
16
+ name: 'status',
17
+ description: 'Show hook installation status for all agents',
18
+ },
19
+ run: async () => {
20
+ const { getHookStatus } = await import('../../hooks/installers/index.js');
21
+ const { AGENT_SUPPORT_TIER } = await import('../../hooks/types.js');
22
+ const os = await import('node:os');
23
+ let cwd: string;
24
+ try { cwd = process.cwd(); } catch { cwd = os.homedir(); }
25
+
26
+ const statuses = await getHookStatus(cwd);
27
+
28
+ console.log('\nMemorix Hooks Status');
29
29
  console.log('-'.repeat(50));
30
-
31
- let hasOutdated = false;
32
- let hasUnverified = false;
33
- let hasRuntimeIssue = false;
34
- for (const { agent, installed, outdated, verified, runtimeReady, configPath } of statuses) {
35
- const icon = installed
36
- ? (!runtimeReady ? '[!!]' : (outdated ? '[!!]' : (verified ? '[OK]' : '[??]')))
37
- : '[ ]';
38
- const label = agent.charAt(0).toUpperCase() + agent.slice(1);
39
- const tier = AGENT_SUPPORT_TIER[agent];
30
+
31
+ let hasOutdated = false;
32
+ let hasUnverified = false;
33
+ let hasRuntimeIssue = false;
34
+ for (const { agent, installed, outdated, verified, runtimeReady, configPath } of statuses) {
35
+ const icon = installed
36
+ ? (!runtimeReady ? '[!!]' : (outdated ? '[!!]' : (verified ? '[OK]' : '[??]')))
37
+ : '[ ]';
38
+ const label = agent.charAt(0).toUpperCase() + agent.slice(1);
39
+ const tier = AGENT_SUPPORT_TIER[agent];
40
40
  const tierLabel = tier === 'core' ? '[core]' : tier === 'extended' ? '[extended]' : '[community]';
41
- const suffix = !runtimeReady && installed
42
- ? ' (installed but runtime NOT ready — missing pwsh on Windows)'
43
- : outdated
44
- ? ' (outdated - re-run `memorix hooks install`)'
45
- : (!verified && installed ? ' (plugin file installed, runtime load unverified)' : '');
46
- console.log(`${icon} ${tierLabel} ${label.padEnd(12)} ${installed ? configPath + suffix : '(not installed)'}`);
47
- if (outdated) hasOutdated = true;
48
- if (!verified && installed) hasUnverified = true;
49
- if (!runtimeReady && installed) hasRuntimeIssue = true;
50
- }
51
-
41
+ const suffix = !runtimeReady && installed
42
+ ? ' (installed but runtime NOT ready — missing pwsh on Windows)'
43
+ : outdated
44
+ ? ' (outdated - re-run `memorix hooks install`)'
45
+ : (!verified && installed ? ' (plugin file installed, runtime load unverified)' : '');
46
+ console.log(`${icon} ${tierLabel} ${label.padEnd(12)} ${installed ? configPath + suffix : '(not installed)'}`);
47
+ if (outdated) hasOutdated = true;
48
+ if (!verified && installed) hasUnverified = true;
49
+ if (!runtimeReady && installed) hasRuntimeIssue = true;
50
+ }
51
+
52
52
  console.log('\nSupport tiers: [core] core | [extended] extended | [community] community');
53
-
54
- if (hasOutdated) {
55
- console.log('\n[warn] Outdated hooks detected. Run `memorix hooks install` to update.');
56
- }
57
- if (hasUnverified) {
58
- console.log('\n[info] [??] = plugin file installed but runtime load unverified.');
59
- console.log(' For OpenCode: verify by running `opencode --log-level DEBUG` and checking');
60
- console.log(' for [memorix-plugin] messages in the log output.');
61
- }
62
- if (hasRuntimeIssue) {
63
- console.log('\n[warn] [!!] = installed but runtime will fail.');
64
- console.log(' Copilot on Windows requires PowerShell v6+ (pwsh.exe) for hook execution.');
65
- console.log(' Install pwsh: https://learn.microsoft.com/powershell/scripting/install/installing-powershell');
66
- console.log(' Without pwsh, Copilot hooks will fail at runtime with "spawn pwsh.exe ENOENT".');
67
- }
68
-
69
- console.log('\nRun `memorix hooks install` to set up hooks for detected agents.');
70
- },
71
- });
53
+
54
+ if (hasOutdated) {
55
+ console.log('\n[warn] Outdated hooks detected. Run `memorix hooks install` to update.');
56
+ }
57
+ if (hasUnverified) {
58
+ console.log('\n[info] [??] = plugin file installed but runtime load unverified.');
59
+ console.log(' For OpenCode: verify by running `opencode --log-level DEBUG` and checking');
60
+ console.log(' for [memorix-plugin] messages in the log output.');
61
+ }
62
+ if (hasRuntimeIssue) {
63
+ console.log('\n[warn] [!!] = installed but runtime will fail.');
64
+ console.log(' Copilot on Windows requires PowerShell v6+ (pwsh.exe) for hook execution.');
65
+ console.log(' Install pwsh: https://learn.microsoft.com/powershell/scripting/install/installing-powershell');
66
+ console.log(' Without pwsh, Copilot hooks will fail at runtime with "spawn pwsh.exe ENOENT".');
67
+ }
68
+
69
+ console.log('\nRun `memorix hooks install` to set up hooks for detected agents.');
70
+ },
71
+ });
@@ -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
+ }
@@ -114,6 +114,7 @@ function getAgentLabel(agent: string): string {
114
114
  antigravity: 'Antigravity',
115
115
  'gemini-cli': 'Gemini CLI',
116
116
  trae: 'Trae',
117
+ dsh: 'DeepSeek Harness',
117
118
  };
118
119
  return labels[agent] || agent;
119
120
  }
@@ -130,6 +131,7 @@ function getAgentHint(agent: string): string {
130
131
  antigravity: 'plugin + MCP + hooks + skills',
131
132
  'gemini-cli': 'settings + GEMINI.md',
132
133
  trae: 'rules',
134
+ dsh: 'MCP patch + AGENTS.md + skills',
133
135
  };
134
136
  return hints[agent] || 'integration files';
135
137
  }