memorix 1.1.7 → 1.1.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +13 -0
- package/CLAUDE.md +6 -1
- package/README.md +21 -0
- package/README.zh-CN.md +21 -0
- package/TEAM.md +86 -86
- package/dist/cli/index.js +730 -150
- package/dist/cli/index.js.map +1 -1
- package/dist/dashboard/static/index.html +201 -201
- package/dist/dashboard/static/style.css +3584 -3584
- package/dist/index.js +15 -8
- package/dist/index.js.map +1 -1
- package/dist/memcode-runtime/CHANGELOG.md +13 -0
- package/dist/memcode-runtime/package.json +4 -4
- package/dist/sdk.js +15 -8
- package/dist/sdk.js.map +1 -1
- package/docs/AGENT_OPERATOR_PLAYBOOK.md +18 -0
- package/docs/DESIGN_DECISIONS.md +357 -357
- package/docs/SETUP.md +10 -0
- package/docs/dev-log/progress.txt +35 -26
- package/package.json +1 -1
- package/src/audit/index.ts +156 -156
- package/src/cli/commands/agent-integrations.ts +623 -0
- package/src/cli/commands/audit-list.ts +89 -89
- package/src/cli/commands/background.ts +659 -659
- package/src/cli/commands/cleanup.ts +255 -255
- package/src/cli/commands/doctor.ts +23 -0
- package/src/cli/commands/formation.ts +48 -48
- package/src/cli/commands/git-hook-install.ts +111 -111
- package/src/cli/commands/handoff.ts +66 -66
- package/src/cli/commands/hooks-status.ts +63 -63
- package/src/cli/commands/ingest-commit.ts +153 -153
- package/src/cli/commands/ingest-image.ts +73 -73
- package/src/cli/commands/ingest-log.ts +180 -180
- package/src/cli/commands/ingest.ts +44 -44
- package/src/cli/commands/integrate-shared.ts +15 -15
- package/src/cli/commands/lock.ts +96 -96
- package/src/cli/commands/message.ts +121 -121
- package/src/cli/commands/poll.ts +70 -70
- package/src/cli/commands/purge-all-memory.ts +85 -85
- package/src/cli/commands/purge-project-memory.ts +83 -83
- package/src/cli/commands/reasoning.ts +132 -132
- package/src/cli/commands/repair.ts +60 -0
- package/src/cli/commands/retention.ts +108 -108
- package/src/cli/commands/serve-shared.ts +118 -118
- package/src/cli/commands/setup.ts +3 -3
- package/src/cli/commands/skills.ts +123 -123
- package/src/cli/commands/task.ts +192 -192
- package/src/cli/commands/transfer.ts +73 -73
- package/src/cli/commands/uninstall-project-artifacts.ts +85 -85
- package/src/cli/index.ts +3 -1
- package/src/cli/tui/ChatView.tsx +234 -234
- package/src/cli/tui/CommandBar.tsx +312 -312
- package/src/cli/tui/ContextRail.tsx +118 -118
- package/src/cli/tui/HeaderBar.tsx +72 -72
- package/src/cli/tui/LogoBanner.tsx +51 -51
- package/src/cli/tui/Panels.tsx +632 -632
- package/src/cli/tui/Sidebar.tsx +179 -179
- package/src/cli/tui/chat-service.ts +742 -742
- package/src/cli/tui/data.ts +547 -547
- package/src/cli/tui/index.ts +41 -41
- package/src/cli/tui/markdown-render.tsx +371 -371
- package/src/cli/tui/theme.ts +178 -178
- package/src/cli/tui/use-mouse.ts +157 -157
- package/src/cli/tui/useNavigation.ts +56 -56
- package/src/cli/update-checker.ts +211 -211
- package/src/cli/version.ts +7 -7
- package/src/cli/workbench.ts +1 -1
- package/src/codegraph/context-pack.ts +5 -1
- package/src/codegraph/lite-provider.ts +5 -1
- package/src/codegraph/project-context.ts +5 -1
- package/src/compact/token-budget.ts +74 -74
- package/src/config/behavior.ts +59 -59
- package/src/dashboard/project-classification.ts +64 -64
- package/src/dashboard/static/index.html +201 -201
- package/src/dashboard/static/style.css +3584 -3584
- package/src/embedding/fastembed-provider.ts +142 -142
- package/src/embedding/transformers-provider.ts +111 -111
- package/src/git/extractor.ts +209 -209
- package/src/git/hooks-path.ts +85 -85
- package/src/git/noise-filter.ts +210 -210
- package/src/hooks/installers/index.ts +4 -4
- package/src/hooks/official-skills.ts +1 -1
- package/src/hooks/pattern-detector.ts +173 -173
- package/src/hooks/rules/memorix-agent-rules.md +2 -2
- package/src/hooks/significance-filter.ts +250 -250
- package/src/llm/memory-manager.ts +328 -328
- package/src/llm/provider.ts +885 -885
- package/src/llm/quality.ts +248 -248
- package/src/memory/attribution-guard.ts +249 -249
- package/src/memory/auto-relations.ts +107 -107
- package/src/memory/consolidation.ts +302 -302
- package/src/memory/disclosure-policy.ts +141 -141
- package/src/memory/entity-extractor.ts +197 -197
- package/src/memory/formation/evaluate.ts +217 -217
- package/src/memory/formation/extract.ts +361 -361
- package/src/memory/formation/index.ts +417 -417
- package/src/memory/formation/resolve.ts +344 -344
- package/src/memory/formation/types.ts +315 -315
- package/src/memory/freshness.ts +122 -122
- package/src/memory/graph.ts +197 -197
- package/src/memory/refs.ts +94 -94
- package/src/memory/retention.ts +433 -433
- package/src/memory/secret-filter.ts +79 -79
- package/src/memory/session.ts +523 -523
- package/src/multimodal/image-loader.ts +143 -143
- package/src/orchestrate/adapters/claude-stream.ts +192 -192
- package/src/orchestrate/adapters/claude.ts +111 -111
- package/src/orchestrate/adapters/codex-stream.ts +134 -134
- package/src/orchestrate/adapters/codex.ts +41 -41
- package/src/orchestrate/adapters/gemini-stream.ts +166 -166
- package/src/orchestrate/adapters/gemini.ts +42 -42
- package/src/orchestrate/adapters/index.ts +73 -73
- package/src/orchestrate/adapters/opencode-stream.ts +143 -143
- package/src/orchestrate/adapters/opencode.ts +47 -47
- package/src/orchestrate/adapters/spawn-helper.ts +286 -286
- package/src/orchestrate/adapters/types.ts +77 -77
- package/src/orchestrate/capability-router.ts +284 -284
- package/src/orchestrate/context-compact.ts +188 -188
- package/src/orchestrate/cost-tracker.ts +219 -219
- package/src/orchestrate/error-recovery.ts +191 -191
- package/src/orchestrate/evidence.ts +140 -140
- package/src/orchestrate/ledger.ts +110 -110
- package/src/orchestrate/memorix-bridge.ts +380 -380
- package/src/orchestrate/output-budget.ts +80 -80
- package/src/orchestrate/permission.ts +152 -152
- package/src/orchestrate/pipeline-trace.ts +131 -131
- package/src/orchestrate/prompt-builder.ts +155 -155
- package/src/orchestrate/ring-buffer.ts +37 -37
- package/src/orchestrate/task-graph.ts +389 -389
- package/src/orchestrate/verify-gate.ts +219 -219
- package/src/orchestrate/worktree.ts +232 -232
- package/src/project/aliases.ts +374 -374
- package/src/project/detector.ts +268 -268
- package/src/rules/adapters/claude-code.ts +99 -99
- package/src/rules/adapters/codex.ts +97 -97
- package/src/rules/adapters/copilot.ts +124 -124
- package/src/rules/adapters/cursor.ts +114 -114
- package/src/rules/adapters/kiro.ts +126 -126
- package/src/rules/adapters/trae.ts +56 -56
- package/src/rules/adapters/windsurf.ts +83 -83
- package/src/rules/syncer.ts +235 -235
- package/src/sdk.ts +327 -327
- package/src/search/intent-detector.ts +289 -289
- package/src/search/query-expansion.ts +52 -52
- package/src/server/formation-timeout.ts +27 -27
- package/src/skills/mini-skills.ts +386 -386
- package/src/store/chat-store.ts +119 -119
- package/src/store/file-lock.ts +100 -100
- package/src/store/graph-store.ts +249 -249
- package/src/store/mini-skill-store.ts +349 -349
- package/src/store/obs-store.ts +255 -255
- package/src/store/persistence-json.ts +212 -212
- package/src/store/persistence.ts +291 -291
- package/src/store/project-affinity.ts +195 -195
- package/src/store/session-store.ts +259 -259
- package/src/store/sqlite-store.ts +339 -339
- package/src/team/event-bus.ts +76 -76
- package/src/team/file-locks.ts +173 -173
- package/src/team/handoff.ts +167 -167
- package/src/team/messages.ts +203 -203
- package/src/team/poll.ts +132 -132
- package/src/team/tasks.ts +211 -211
- package/src/wiki/generator.ts +237 -237
- package/src/wiki/knowledge-graph.ts +334 -334
- package/src/wiki/types.ts +85 -85
- package/src/workspace/mcp-adapters/codex.ts +191 -191
- package/src/workspace/mcp-adapters/copilot.ts +105 -105
- package/src/workspace/mcp-adapters/cursor.ts +53 -53
- package/src/workspace/mcp-adapters/kiro.ts +64 -64
- package/src/workspace/mcp-adapters/opencode.ts +123 -123
- package/src/workspace/mcp-adapters/trae.ts +134 -134
- package/src/workspace/mcp-adapters/windsurf.ts +91 -91
- package/src/workspace/sanitizer.ts +60 -60
- package/src/workspace/workflow-sync.ts +131 -131
|
@@ -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,66 +1,66 @@
|
|
|
1
|
-
import { defineCommand } from 'citty';
|
|
2
|
-
import { storeObservation } from '../../memory/observations.js';
|
|
3
|
-
import { createHandoffArtifact } from '../../team/handoff.js';
|
|
4
|
-
import { emitError, emitResult, getCliProjectContext, parseCsvList, 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 {
|
|
26
|
-
const { project, teamStore } = await getCliProjectContext();
|
|
27
|
-
|
|
28
|
-
switch (action) {
|
|
29
|
-
case 'send': {
|
|
30
|
-
if (!args.fromAgentId || !args.summary || !args.context) {
|
|
31
|
-
emitError('fromAgentId, summary, and context are required for "memorix handoff send"', asJson);
|
|
32
|
-
return;
|
|
33
|
-
}
|
|
34
|
-
const result = await createHandoffArtifact(
|
|
35
|
-
{
|
|
36
|
-
projectId: project.id,
|
|
37
|
-
fromAgentId: args.fromAgentId as string,
|
|
38
|
-
toAgentId: args.toAgentId as string | undefined,
|
|
39
|
-
taskId: args.taskId as string | undefined,
|
|
40
|
-
summary: args.summary as string,
|
|
41
|
-
context: args.context as string,
|
|
42
|
-
filesModified: parseCsvList(args.filesModified as string | undefined),
|
|
43
|
-
concepts: parseCsvList(args.concepts as string | undefined),
|
|
44
|
-
},
|
|
45
|
-
storeObservation,
|
|
46
|
-
teamStore,
|
|
47
|
-
);
|
|
48
|
-
emitResult(
|
|
49
|
-
{ project, handoff: result },
|
|
50
|
-
`Handoff created: observation #${result.observationId} from ${shortId(result.fromAgentId)}${result.toAgentId ? ` to ${shortId(result.toAgentId)}` : ' (broadcast)'}`,
|
|
51
|
-
asJson,
|
|
52
|
-
);
|
|
53
|
-
return;
|
|
54
|
-
}
|
|
55
|
-
|
|
56
|
-
default:
|
|
57
|
-
console.log('Memorix Handoff Commands');
|
|
58
|
-
console.log('');
|
|
59
|
-
console.log('Usage:');
|
|
60
|
-
console.log(' memorix handoff send --fromAgentId <id> --summary "..." --context "..." [--toAgentId <id>] [--taskId <id>]');
|
|
61
|
-
}
|
|
62
|
-
} catch (error) {
|
|
63
|
-
emitError(error instanceof Error ? error.message : String(error), asJson);
|
|
64
|
-
}
|
|
65
|
-
},
|
|
66
|
-
});
|
|
1
|
+
import { defineCommand } from 'citty';
|
|
2
|
+
import { storeObservation } from '../../memory/observations.js';
|
|
3
|
+
import { createHandoffArtifact } from '../../team/handoff.js';
|
|
4
|
+
import { emitError, emitResult, getCliProjectContext, parseCsvList, 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 {
|
|
26
|
+
const { project, teamStore } = await getCliProjectContext();
|
|
27
|
+
|
|
28
|
+
switch (action) {
|
|
29
|
+
case 'send': {
|
|
30
|
+
if (!args.fromAgentId || !args.summary || !args.context) {
|
|
31
|
+
emitError('fromAgentId, summary, and context are required for "memorix handoff send"', asJson);
|
|
32
|
+
return;
|
|
33
|
+
}
|
|
34
|
+
const result = await createHandoffArtifact(
|
|
35
|
+
{
|
|
36
|
+
projectId: project.id,
|
|
37
|
+
fromAgentId: args.fromAgentId as string,
|
|
38
|
+
toAgentId: args.toAgentId as string | undefined,
|
|
39
|
+
taskId: args.taskId as string | undefined,
|
|
40
|
+
summary: args.summary as string,
|
|
41
|
+
context: args.context as string,
|
|
42
|
+
filesModified: parseCsvList(args.filesModified as string | undefined),
|
|
43
|
+
concepts: parseCsvList(args.concepts as string | undefined),
|
|
44
|
+
},
|
|
45
|
+
storeObservation,
|
|
46
|
+
teamStore,
|
|
47
|
+
);
|
|
48
|
+
emitResult(
|
|
49
|
+
{ project, handoff: result },
|
|
50
|
+
`Handoff created: observation #${result.observationId} from ${shortId(result.fromAgentId)}${result.toAgentId ? ` to ${shortId(result.toAgentId)}` : ' (broadcast)'}`,
|
|
51
|
+
asJson,
|
|
52
|
+
);
|
|
53
|
+
return;
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
default:
|
|
57
|
+
console.log('Memorix Handoff Commands');
|
|
58
|
+
console.log('');
|
|
59
|
+
console.log('Usage:');
|
|
60
|
+
console.log(' memorix handoff send --fromAgentId <id> --summary "..." --context "..." [--toAgentId <id>] [--taskId <id>]');
|
|
61
|
+
}
|
|
62
|
+
} catch (error) {
|
|
63
|
+
emitError(error instanceof Error ? error.message : String(error), asJson);
|
|
64
|
+
}
|
|
65
|
+
},
|
|
66
|
+
});
|
|
@@ -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
|
+
});
|