memorix 1.5.1 → 1.6.0
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 +23 -0
- package/README.md +3 -3
- package/README.zh-CN.md +3 -3
- package/TEAM.md +86 -86
- package/dist/cli/index.js +243 -42
- package/dist/cli/memcode.js +0 -0
- package/dist/index.js +167 -20
- package/dist/maintenance-runner.js +5 -4
- package/dist/media-audio-runner.js +5 -4
- package/dist/media-video-runner.js +5 -4
- package/dist/memcode-runtime/CHANGELOG.md +23 -0
- package/dist/sdk.js +166 -19
- package/dist/vector-backfill-runner.js +5 -4
- package/docs/1.2.4-PERSISTENT-MEMORY-DELIVERY.md +1 -1
- package/docs/API_REFERENCE.md +1 -1
- package/docs/DESIGN_DECISIONS.md +357 -357
- package/docs/DEVELOPMENT.md +5 -3
- package/package.json +1 -1
- package/plugins/claude/memorix/.claude-plugin/plugin.json +1 -1
- package/plugins/codebuddy/memorix/.codebuddy-plugin/plugin.json +1 -1
- package/plugins/codex/memorix/.codex-plugin/plugin.json +1 -1
- package/plugins/copilot/memorix/plugin.json +1 -1
- package/plugins/gemini/memorix/gemini-extension.json +1 -1
- package/plugins/omp/memorix/package.json +1 -1
- package/plugins/openclaw/memorix/.codex-plugin/plugin.json +1 -1
- package/plugins/pi/memorix/package.json +1 -1
- package/server.json +2 -2
- package/src/audit/index.ts +156 -156
- package/src/cli/commands/codegraph.ts +48 -5
- package/src/cli/commands/context.ts +20 -4
- package/src/cli/commands/formation.ts +48 -48
- package/src/cli/commands/git-hook-install.ts +111 -111
- package/src/cli/commands/handoff.ts +54 -54
- package/src/cli/commands/hooks-status.ts +63 -63
- package/src/cli/commands/ingest.ts +44 -44
- package/src/cli/commands/integrate-shared.ts +15 -15
- package/src/cli/commands/lock.ts +82 -82
- package/src/cli/commands/message.ts +104 -104
- package/src/cli/commands/poll.ts +58 -58
- package/src/cli/commands/reasoning.ts +118 -118
- package/src/cli/commands/resume.ts +4 -0
- package/src/cli/commands/skills.ts +114 -114
- package/src/cli/commands/task.ts +167 -167
- package/src/cli/commands/transfer.ts +47 -47
- package/src/cli/index.ts +406 -406
- 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/index.ts +41 -41
- package/src/cli/version.ts +7 -7
- package/src/cli/workbench.ts +1 -1
- package/src/codegraph/auto-context.ts +4 -1
- package/src/codegraph/context-pack.ts +3 -1
- package/src/codegraph/external-provider.ts +93 -0
- package/src/dashboard/project-classification.ts +64 -64
- package/src/git/hooks-path.ts +85 -85
- package/src/hooks/installers/index.ts +1 -1
- package/src/hooks/official-skills.ts +3 -3
- package/src/hooks/pattern-detector.ts +173 -173
- package/src/hooks/rules/memorix-agent-rules.md +1 -1
- package/src/hooks/significance-filter.ts +250 -250
- package/src/knowledge/context-receipt.ts +41 -0
- package/src/knowledge/workflows.ts +6 -3
- package/src/knowledge/workset.ts +56 -2
- package/src/llm/memory-manager.ts +328 -328
- package/src/llm/quality.ts +248 -248
- package/src/memory/attribution-guard.ts +249 -249
- package/src/memory/disclosure-policy.ts +135 -135
- package/src/memory/entity-extractor.ts +197 -197
- package/src/memory/formation/evaluate.ts +217 -217
- package/src/memory/freshness.ts +122 -122
- package/src/memory/graph.ts +197 -197
- package/src/memory/refs.ts +94 -94
- package/src/memory/secret-filter.ts +79 -79
- 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/types.ts +77 -77
- package/src/orchestrate/capability-router.ts +284 -284
- 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 +343 -343
- 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/project/aliases.ts +374 -374
- package/src/rules/adapters/trae.ts +56 -56
- package/src/rules/syncer.ts +235 -235
- package/src/search/query-expansion.ts +52 -52
- package/src/server/formation-timeout.ts +27 -27
- package/src/server.ts +15 -3
- package/src/skills/mini-skills.ts +386 -386
- package/src/store/chat-store.ts +119 -119
- package/src/store/graph-store.ts +249 -249
- package/src/store/mini-skill-store.ts +349 -349
- 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/team/event-bus.ts +76 -76
- package/src/team/handoff.ts +161 -161
- package/src/team/poll.ts +132 -132
- 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/cli/commands/poll.ts
CHANGED
|
@@ -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,6 +1,6 @@
|
|
|
1
|
-
import { defineCommand } from 'citty';
|
|
2
|
-
import { compactSearch } from '../../compact/engine.js';
|
|
3
|
-
import { storeObservation } from '../../memory/observations.js';
|
|
1
|
+
import { defineCommand } from 'citty';
|
|
2
|
+
import { compactSearch } from '../../compact/engine.js';
|
|
3
|
+
import { storeObservation } from '../../memory/observations.js';
|
|
4
4
|
import {
|
|
5
5
|
emitError,
|
|
6
6
|
emitResult,
|
|
@@ -9,65 +9,65 @@ import {
|
|
|
9
9
|
parsePositiveInt,
|
|
10
10
|
resolveCliWriteScope,
|
|
11
11
|
} from './operator-shared.js';
|
|
12
|
-
|
|
13
|
-
export default defineCommand({
|
|
14
|
-
meta: {
|
|
15
|
-
name: 'reasoning',
|
|
16
|
-
description: 'Store and search decision rationale from the operator CLI',
|
|
17
|
-
},
|
|
18
|
-
args: {
|
|
19
|
-
entity: { type: 'string', description: 'Entity this reasoning applies to' },
|
|
20
|
-
decision: { type: 'string', description: 'Decision that was made' },
|
|
21
|
-
rationale: { type: 'string', description: 'Why this approach was chosen' },
|
|
22
|
-
alternatives: { type: 'string', description: 'Comma-separated alternatives that were considered' },
|
|
23
|
-
constraints: { type: 'string', description: 'Comma-separated constraints' },
|
|
24
|
-
expectedOutcome: { type: 'string', description: 'Expected outcome from this decision' },
|
|
25
|
-
risks: { type: 'string', description: 'Comma-separated risks or downsides' },
|
|
26
|
-
concepts: { type: 'string', description: 'Comma-separated related concepts' },
|
|
27
|
-
files: { type: 'string', description: 'Comma-separated file list' },
|
|
28
|
-
relatedCommits: { type: 'string', description: 'Comma-separated related commit hashes' },
|
|
12
|
+
|
|
13
|
+
export default defineCommand({
|
|
14
|
+
meta: {
|
|
15
|
+
name: 'reasoning',
|
|
16
|
+
description: 'Store and search decision rationale from the operator CLI',
|
|
17
|
+
},
|
|
18
|
+
args: {
|
|
19
|
+
entity: { type: 'string', description: 'Entity this reasoning applies to' },
|
|
20
|
+
decision: { type: 'string', description: 'Decision that was made' },
|
|
21
|
+
rationale: { type: 'string', description: 'Why this approach was chosen' },
|
|
22
|
+
alternatives: { type: 'string', description: 'Comma-separated alternatives that were considered' },
|
|
23
|
+
constraints: { type: 'string', description: 'Comma-separated constraints' },
|
|
24
|
+
expectedOutcome: { type: 'string', description: 'Expected outcome from this decision' },
|
|
25
|
+
risks: { type: 'string', description: 'Comma-separated risks or downsides' },
|
|
26
|
+
concepts: { type: 'string', description: 'Comma-separated related concepts' },
|
|
27
|
+
files: { type: 'string', description: 'Comma-separated file list' },
|
|
28
|
+
relatedCommits: { type: 'string', description: 'Comma-separated related commit hashes' },
|
|
29
29
|
relatedEntities: { type: 'string', description: 'Comma-separated related entity names' },
|
|
30
30
|
visibility: { type: 'string', description: 'Reasoning visibility: project (default), personal, or team' },
|
|
31
|
-
query: { type: 'string', description: 'Search query for reasoning traces' },
|
|
32
|
-
limit: { type: 'string', description: 'Search result limit' },
|
|
33
|
-
scope: { type: 'string', description: 'project or global scope for search' },
|
|
34
|
-
json: { type: 'boolean', description: 'Emit machine-readable JSON output' },
|
|
35
|
-
},
|
|
36
|
-
run: async ({ args }) => {
|
|
37
|
-
const action = (args._ as string[])?.[0] || '';
|
|
38
|
-
const asJson = !!args.json;
|
|
39
|
-
|
|
40
|
-
try {
|
|
31
|
+
query: { type: 'string', description: 'Search query for reasoning traces' },
|
|
32
|
+
limit: { type: 'string', description: 'Search result limit' },
|
|
33
|
+
scope: { type: 'string', description: 'project or global scope for search' },
|
|
34
|
+
json: { type: 'boolean', description: 'Emit machine-readable JSON output' },
|
|
35
|
+
},
|
|
36
|
+
run: async ({ args }) => {
|
|
37
|
+
const action = (args._ as string[])?.[0] || '';
|
|
38
|
+
const asJson = !!args.json;
|
|
39
|
+
|
|
40
|
+
try {
|
|
41
41
|
const { project, reader, identity } = await getCliProjectContext({ searchIndex: action === 'search' });
|
|
42
|
-
|
|
43
|
-
switch (action) {
|
|
44
|
-
case 'store': {
|
|
45
|
-
const entityName = (args.entity as string | undefined)?.trim();
|
|
46
|
-
const decision = (args.decision as string | undefined)?.trim();
|
|
47
|
-
const rationale = (args.rationale as string | undefined)?.trim();
|
|
48
|
-
if (!entityName || !decision || !rationale) {
|
|
49
|
-
emitError('entity, decision, and rationale are required for "memorix reasoning store"', asJson);
|
|
50
|
-
return;
|
|
51
|
-
}
|
|
52
|
-
|
|
53
|
-
const alternatives = parseCsvList(args.alternatives as string | undefined);
|
|
54
|
-
const constraints = parseCsvList(args.constraints as string | undefined);
|
|
55
|
-
const risks = parseCsvList(args.risks as string | undefined);
|
|
56
|
-
const concepts = parseCsvList(args.concepts as string | undefined);
|
|
57
|
-
const filesModified = parseCsvList(args.files as string | undefined);
|
|
58
|
-
const relatedCommits = parseCsvList(args.relatedCommits as string | undefined);
|
|
59
|
-
const relatedEntities = parseCsvList(args.relatedEntities as string | undefined);
|
|
60
|
-
|
|
61
|
-
const narrativeParts: string[] = [rationale];
|
|
62
|
-
if (alternatives.length > 0) {
|
|
63
|
-
narrativeParts.push(`Alternatives considered: ${alternatives.join('; ')}`);
|
|
64
|
-
}
|
|
65
|
-
if (constraints.length > 0) {
|
|
66
|
-
narrativeParts.push(`Constraints: ${constraints.join('; ')}`);
|
|
67
|
-
}
|
|
68
|
-
if (args.expectedOutcome) {
|
|
69
|
-
narrativeParts.push(`Expected outcome: ${String(args.expectedOutcome).trim()}`);
|
|
70
|
-
}
|
|
42
|
+
|
|
43
|
+
switch (action) {
|
|
44
|
+
case 'store': {
|
|
45
|
+
const entityName = (args.entity as string | undefined)?.trim();
|
|
46
|
+
const decision = (args.decision as string | undefined)?.trim();
|
|
47
|
+
const rationale = (args.rationale as string | undefined)?.trim();
|
|
48
|
+
if (!entityName || !decision || !rationale) {
|
|
49
|
+
emitError('entity, decision, and rationale are required for "memorix reasoning store"', asJson);
|
|
50
|
+
return;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
const alternatives = parseCsvList(args.alternatives as string | undefined);
|
|
54
|
+
const constraints = parseCsvList(args.constraints as string | undefined);
|
|
55
|
+
const risks = parseCsvList(args.risks as string | undefined);
|
|
56
|
+
const concepts = parseCsvList(args.concepts as string | undefined);
|
|
57
|
+
const filesModified = parseCsvList(args.files as string | undefined);
|
|
58
|
+
const relatedCommits = parseCsvList(args.relatedCommits as string | undefined);
|
|
59
|
+
const relatedEntities = parseCsvList(args.relatedEntities as string | undefined);
|
|
60
|
+
|
|
61
|
+
const narrativeParts: string[] = [rationale];
|
|
62
|
+
if (alternatives.length > 0) {
|
|
63
|
+
narrativeParts.push(`Alternatives considered: ${alternatives.join('; ')}`);
|
|
64
|
+
}
|
|
65
|
+
if (constraints.length > 0) {
|
|
66
|
+
narrativeParts.push(`Constraints: ${constraints.join('; ')}`);
|
|
67
|
+
}
|
|
68
|
+
if (args.expectedOutcome) {
|
|
69
|
+
narrativeParts.push(`Expected outcome: ${String(args.expectedOutcome).trim()}`);
|
|
70
|
+
}
|
|
71
71
|
if (risks.length > 0) {
|
|
72
72
|
narrativeParts.push(`Risks: ${risks.join('; ')}`);
|
|
73
73
|
}
|
|
@@ -77,70 +77,70 @@ export default defineCommand({
|
|
|
77
77
|
);
|
|
78
78
|
|
|
79
79
|
const result = await storeObservation({
|
|
80
|
-
entityName,
|
|
81
|
-
type: 'reasoning',
|
|
82
|
-
title: decision,
|
|
83
|
-
narrative: narrativeParts.join('. '),
|
|
84
|
-
facts: [
|
|
85
|
-
`Decision: ${decision}`,
|
|
86
|
-
...alternatives.map((item) => `Alternative: ${item}`),
|
|
87
|
-
...constraints.map((item) => `Constraint: ${item}`),
|
|
88
|
-
...(args.expectedOutcome ? [`Expected outcome: ${String(args.expectedOutcome).trim()}`] : []),
|
|
89
|
-
...risks.map((item) => `Risk: ${item}`),
|
|
90
|
-
...relatedCommits.map((item) => `Commit: ${item}`),
|
|
91
|
-
...relatedEntities.map((item) => `Related entity: ${item}`),
|
|
92
|
-
],
|
|
93
|
-
concepts,
|
|
94
|
-
filesModified,
|
|
95
|
-
relatedCommits,
|
|
96
|
-
relatedEntities,
|
|
80
|
+
entityName,
|
|
81
|
+
type: 'reasoning',
|
|
82
|
+
title: decision,
|
|
83
|
+
narrative: narrativeParts.join('. '),
|
|
84
|
+
facts: [
|
|
85
|
+
`Decision: ${decision}`,
|
|
86
|
+
...alternatives.map((item) => `Alternative: ${item}`),
|
|
87
|
+
...constraints.map((item) => `Constraint: ${item}`),
|
|
88
|
+
...(args.expectedOutcome ? [`Expected outcome: ${String(args.expectedOutcome).trim()}`] : []),
|
|
89
|
+
...risks.map((item) => `Risk: ${item}`),
|
|
90
|
+
...relatedCommits.map((item) => `Commit: ${item}`),
|
|
91
|
+
...relatedEntities.map((item) => `Related entity: ${item}`),
|
|
92
|
+
],
|
|
93
|
+
concepts,
|
|
94
|
+
filesModified,
|
|
95
|
+
relatedCommits,
|
|
96
|
+
relatedEntities,
|
|
97
97
|
projectId: project.id,
|
|
98
98
|
source: 'manual',
|
|
99
99
|
...writeScope,
|
|
100
|
-
});
|
|
101
|
-
|
|
102
|
-
emitResult(
|
|
103
|
-
{ project, observation: result.observation, upserted: result.upserted },
|
|
104
|
-
`${result.upserted ? 'Updated' : 'Stored'} reasoning trace #${result.observation.id}: ${decision}`,
|
|
105
|
-
asJson,
|
|
106
|
-
);
|
|
107
|
-
return;
|
|
108
|
-
}
|
|
109
|
-
|
|
110
|
-
case 'search': {
|
|
111
|
-
const query = (args.query as string | undefined)?.trim();
|
|
112
|
-
if (!query) {
|
|
113
|
-
emitError('query is required for "memorix reasoning search"', asJson);
|
|
114
|
-
return;
|
|
115
|
-
}
|
|
116
|
-
const scope = (args.scope as string | undefined) === 'global' ? 'global' : 'project';
|
|
117
|
-
const limit = parsePositiveInt(args.limit as string | undefined, 10);
|
|
118
|
-
const result = await compactSearch({
|
|
119
|
-
query,
|
|
120
|
-
limit,
|
|
100
|
+
});
|
|
101
|
+
|
|
102
|
+
emitResult(
|
|
103
|
+
{ project, observation: result.observation, upserted: result.upserted },
|
|
104
|
+
`${result.upserted ? 'Updated' : 'Stored'} reasoning trace #${result.observation.id}: ${decision}`,
|
|
105
|
+
asJson,
|
|
106
|
+
);
|
|
107
|
+
return;
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
case 'search': {
|
|
111
|
+
const query = (args.query as string | undefined)?.trim();
|
|
112
|
+
if (!query) {
|
|
113
|
+
emitError('query is required for "memorix reasoning search"', asJson);
|
|
114
|
+
return;
|
|
115
|
+
}
|
|
116
|
+
const scope = (args.scope as string | undefined) === 'global' ? 'global' : 'project';
|
|
117
|
+
const limit = parsePositiveInt(args.limit as string | undefined, 10);
|
|
118
|
+
const result = await compactSearch({
|
|
119
|
+
query,
|
|
120
|
+
limit,
|
|
121
121
|
type: 'reasoning',
|
|
122
122
|
projectId: scope === 'global' ? undefined : project.id,
|
|
123
123
|
status: 'active',
|
|
124
124
|
reader: scope === 'global' ? {} : reader,
|
|
125
|
-
});
|
|
126
|
-
emitResult(
|
|
127
|
-
{ project, scope, entries: result.entries },
|
|
128
|
-
result.entries.length === 0 ? 'No reasoning traces found.' : `[REASONING] Reasoning traces\n${result.formatted}`,
|
|
129
|
-
asJson,
|
|
130
|
-
);
|
|
131
|
-
return;
|
|
132
|
-
}
|
|
133
|
-
|
|
134
|
-
default:
|
|
135
|
-
console.log('Memorix Reasoning Commands');
|
|
136
|
-
console.log('');
|
|
137
|
-
console.log('Usage:');
|
|
125
|
+
});
|
|
126
|
+
emitResult(
|
|
127
|
+
{ project, scope, entries: result.entries },
|
|
128
|
+
result.entries.length === 0 ? 'No reasoning traces found.' : `[REASONING] Reasoning traces\n${result.formatted}`,
|
|
129
|
+
asJson,
|
|
130
|
+
);
|
|
131
|
+
return;
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
default:
|
|
135
|
+
console.log('Memorix Reasoning Commands');
|
|
136
|
+
console.log('');
|
|
137
|
+
console.log('Usage:');
|
|
138
138
|
console.log(' memorix reasoning store --entity auth --decision "Use SQLite" --rationale "..." [--visibility project|personal|team]');
|
|
139
|
-
console.log(' memorix reasoning search --query "why sqlite" [--scope project|global --limit 10]');
|
|
140
|
-
}
|
|
141
|
-
} catch (error) {
|
|
142
|
-
emitError(error instanceof Error ? error.message : String(error), asJson);
|
|
143
|
-
}
|
|
144
|
-
},
|
|
145
|
-
});
|
|
146
|
-
|
|
139
|
+
console.log(' memorix reasoning search --query "why sqlite" [--scope project|global --limit 10]');
|
|
140
|
+
}
|
|
141
|
+
} catch (error) {
|
|
142
|
+
emitError(error instanceof Error ? error.message : String(error), asJson);
|
|
143
|
+
}
|
|
144
|
+
},
|
|
145
|
+
});
|
|
146
|
+
|
|
@@ -13,7 +13,9 @@ export default defineCommand({
|
|
|
13
13
|
args: {
|
|
14
14
|
task: { type: 'positional', description: 'Current continuation task', required: false },
|
|
15
15
|
refresh: { type: 'string', description: 'Project scan policy: auto, always, or never' },
|
|
16
|
+
agent: { type: 'string', description: 'Optional target agent for compatible workflow selection' },
|
|
16
17
|
json: { type: 'boolean', description: 'Emit machine-readable JSON output' },
|
|
18
|
+
briefJson: { type: 'boolean', description: 'Emit only the bounded agent brief and receipt JSON' },
|
|
17
19
|
},
|
|
18
20
|
async run({ args }) {
|
|
19
21
|
await contextCommand.run?.({
|
|
@@ -21,7 +23,9 @@ export default defineCommand({
|
|
|
21
23
|
_: [],
|
|
22
24
|
input: args.task,
|
|
23
25
|
refresh: args.refresh,
|
|
26
|
+
agent: args.agent,
|
|
24
27
|
json: args.json,
|
|
28
|
+
briefJson: args.briefJson,
|
|
25
29
|
resume: true,
|
|
26
30
|
},
|
|
27
31
|
rawArgs: [],
|
|
@@ -1,128 +1,128 @@
|
|
|
1
|
-
import { defineCommand } from 'citty';
|
|
1
|
+
import { defineCommand } from 'citty';
|
|
2
2
|
import type { AgentTarget } from '../../types.js';
|
|
3
3
|
import { getObservationStore } from '../../store/obs-store.js';
|
|
4
4
|
import { filterReadableObservations, resolveObservationVisibility } from '../../memory/visibility.js';
|
|
5
|
-
import { emitError, emitResult, getCliProjectContext } from './operator-shared.js';
|
|
6
|
-
|
|
7
|
-
export default defineCommand({
|
|
8
|
-
meta: {
|
|
9
|
-
name: 'skills',
|
|
10
|
-
description: 'Discover, generate, and inspect project skills from the CLI',
|
|
11
|
-
},
|
|
12
|
-
args: {
|
|
13
|
-
name: { type: 'string', description: 'Skill name for "show"' },
|
|
14
|
-
target: { type: 'string', description: 'Target agent for generated skills' },
|
|
15
|
-
write: { type: 'boolean', description: 'Write generated skills to disk' },
|
|
16
|
-
json: { type: 'boolean', description: 'Emit machine-readable JSON output' },
|
|
17
|
-
},
|
|
18
|
-
run: async ({ args }) => {
|
|
19
|
-
const action = (args._ as string[])?.[0] || '';
|
|
20
|
-
const asJson = !!args.json;
|
|
21
|
-
|
|
22
|
-
try {
|
|
5
|
+
import { emitError, emitResult, getCliProjectContext } from './operator-shared.js';
|
|
6
|
+
|
|
7
|
+
export default defineCommand({
|
|
8
|
+
meta: {
|
|
9
|
+
name: 'skills',
|
|
10
|
+
description: 'Discover, generate, and inspect project skills from the CLI',
|
|
11
|
+
},
|
|
12
|
+
args: {
|
|
13
|
+
name: { type: 'string', description: 'Skill name for "show"' },
|
|
14
|
+
target: { type: 'string', description: 'Target agent for generated skills' },
|
|
15
|
+
write: { type: 'boolean', description: 'Write generated skills to disk' },
|
|
16
|
+
json: { type: 'boolean', description: 'Emit machine-readable JSON output' },
|
|
17
|
+
},
|
|
18
|
+
run: async ({ args }) => {
|
|
19
|
+
const action = (args._ as string[])?.[0] || '';
|
|
20
|
+
const asJson = !!args.json;
|
|
21
|
+
|
|
22
|
+
try {
|
|
23
23
|
const { project, reader } = await getCliProjectContext();
|
|
24
|
-
const { SkillsEngine } = await import('../../skills/engine.js');
|
|
25
|
-
const engine = new SkillsEngine(project.rootPath);
|
|
26
|
-
|
|
27
|
-
switch (action) {
|
|
28
|
-
case 'list': {
|
|
29
|
-
const skills = engine.listSkills();
|
|
30
|
-
emitResult(
|
|
31
|
-
{ project, skills },
|
|
32
|
-
skills.length === 0
|
|
33
|
-
? 'No skills found in project or global agent directories.'
|
|
34
|
-
: skills.map((skill) => `- ${skill.name} (${skill.sourceAgent})`).join('\n'),
|
|
35
|
-
asJson,
|
|
36
|
-
);
|
|
37
|
-
return;
|
|
38
|
-
}
|
|
39
|
-
|
|
40
|
-
case 'generate': {
|
|
24
|
+
const { SkillsEngine } = await import('../../skills/engine.js');
|
|
25
|
+
const engine = new SkillsEngine(project.rootPath);
|
|
26
|
+
|
|
27
|
+
switch (action) {
|
|
28
|
+
case 'list': {
|
|
29
|
+
const skills = engine.listSkills();
|
|
30
|
+
emitResult(
|
|
31
|
+
{ project, skills },
|
|
32
|
+
skills.length === 0
|
|
33
|
+
? 'No skills found in project or global agent directories.'
|
|
34
|
+
: skills.map((skill) => `- ${skill.name} (${skill.sourceAgent})`).join('\n'),
|
|
35
|
+
asJson,
|
|
36
|
+
);
|
|
37
|
+
return;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
case 'generate': {
|
|
41
41
|
const observations = filterReadableObservations(
|
|
42
42
|
await getObservationStore().loadAll(),
|
|
43
43
|
reader,
|
|
44
44
|
).filter((observation) => resolveObservationVisibility(observation) === 'project')
|
|
45
45
|
.map((obs) => ({
|
|
46
|
-
id: obs.id,
|
|
47
|
-
entityName: obs.entityName,
|
|
48
|
-
type: obs.type,
|
|
49
|
-
title: obs.title,
|
|
50
|
-
narrative: obs.narrative,
|
|
51
|
-
facts: obs.facts,
|
|
52
|
-
concepts: obs.concepts,
|
|
53
|
-
filesModified: obs.filesModified,
|
|
54
|
-
createdAt: obs.createdAt,
|
|
55
|
-
status: obs.status,
|
|
56
|
-
source: obs.source,
|
|
57
|
-
}));
|
|
58
|
-
const skills = engine.generateFromObservations(observations);
|
|
59
|
-
const written: string[] = [];
|
|
60
|
-
if (args.write && args.target) {
|
|
61
|
-
for (const skill of skills) {
|
|
62
|
-
const writtenPath = engine.writeSkill(skill, args.target as AgentTarget);
|
|
63
|
-
if (writtenPath) written.push(writtenPath);
|
|
64
|
-
}
|
|
65
|
-
}
|
|
66
|
-
emitResult(
|
|
67
|
-
{ project, skills, written },
|
|
68
|
-
skills.length === 0
|
|
69
|
-
? 'No skill-worthy patterns found yet.'
|
|
70
|
-
: skills.map((skill) => `- ${skill.name}: ${skill.description}`).join('\n'),
|
|
71
|
-
asJson,
|
|
72
|
-
);
|
|
73
|
-
return;
|
|
74
|
-
}
|
|
75
|
-
|
|
76
|
-
case 'show': {
|
|
77
|
-
const name = (args.name as string | undefined)?.trim();
|
|
78
|
-
if (!name) {
|
|
79
|
-
emitError('name is required for "memorix skills show"', asJson);
|
|
80
|
-
return;
|
|
81
|
-
}
|
|
82
|
-
const direct = engine.injectSkill(name);
|
|
83
|
-
if (direct) {
|
|
84
|
-
emitResult({ project, skill: direct }, direct.content, asJson);
|
|
85
|
-
return;
|
|
86
|
-
}
|
|
87
|
-
|
|
46
|
+
id: obs.id,
|
|
47
|
+
entityName: obs.entityName,
|
|
48
|
+
type: obs.type,
|
|
49
|
+
title: obs.title,
|
|
50
|
+
narrative: obs.narrative,
|
|
51
|
+
facts: obs.facts,
|
|
52
|
+
concepts: obs.concepts,
|
|
53
|
+
filesModified: obs.filesModified,
|
|
54
|
+
createdAt: obs.createdAt,
|
|
55
|
+
status: obs.status,
|
|
56
|
+
source: obs.source,
|
|
57
|
+
}));
|
|
58
|
+
const skills = engine.generateFromObservations(observations);
|
|
59
|
+
const written: string[] = [];
|
|
60
|
+
if (args.write && args.target) {
|
|
61
|
+
for (const skill of skills) {
|
|
62
|
+
const writtenPath = engine.writeSkill(skill, args.target as AgentTarget);
|
|
63
|
+
if (writtenPath) written.push(writtenPath);
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
emitResult(
|
|
67
|
+
{ project, skills, written },
|
|
68
|
+
skills.length === 0
|
|
69
|
+
? 'No skill-worthy patterns found yet.'
|
|
70
|
+
: skills.map((skill) => `- ${skill.name}: ${skill.description}`).join('\n'),
|
|
71
|
+
asJson,
|
|
72
|
+
);
|
|
73
|
+
return;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
case 'show': {
|
|
77
|
+
const name = (args.name as string | undefined)?.trim();
|
|
78
|
+
if (!name) {
|
|
79
|
+
emitError('name is required for "memorix skills show"', asJson);
|
|
80
|
+
return;
|
|
81
|
+
}
|
|
82
|
+
const direct = engine.injectSkill(name);
|
|
83
|
+
if (direct) {
|
|
84
|
+
emitResult({ project, skill: direct }, direct.content, asJson);
|
|
85
|
+
return;
|
|
86
|
+
}
|
|
87
|
+
|
|
88
88
|
const observations = filterReadableObservations(
|
|
89
89
|
await getObservationStore().loadAll(),
|
|
90
90
|
reader,
|
|
91
91
|
).filter((observation) => resolveObservationVisibility(observation) === 'project')
|
|
92
92
|
.map((obs) => ({
|
|
93
|
-
id: obs.id,
|
|
94
|
-
entityName: obs.entityName,
|
|
95
|
-
type: obs.type,
|
|
96
|
-
title: obs.title,
|
|
97
|
-
narrative: obs.narrative,
|
|
98
|
-
facts: obs.facts,
|
|
99
|
-
concepts: obs.concepts,
|
|
100
|
-
filesModified: obs.filesModified,
|
|
101
|
-
createdAt: obs.createdAt,
|
|
102
|
-
status: obs.status,
|
|
103
|
-
source: obs.source,
|
|
104
|
-
}));
|
|
105
|
-
const generated = engine.generateFromObservations(observations);
|
|
106
|
-
const skill = generated.find((entry) => entry.name.toLowerCase() === name.toLowerCase());
|
|
107
|
-
if (!skill) {
|
|
108
|
-
emitError(`Skill "${name}" not found`, asJson);
|
|
109
|
-
return;
|
|
110
|
-
}
|
|
111
|
-
emitResult({ project, skill }, skill.content, asJson);
|
|
112
|
-
return;
|
|
113
|
-
}
|
|
114
|
-
|
|
115
|
-
default:
|
|
116
|
-
console.log('Memorix Skills Commands');
|
|
117
|
-
console.log('');
|
|
118
|
-
console.log('Usage:');
|
|
119
|
-
console.log(' memorix skills list');
|
|
120
|
-
console.log(' memorix skills generate [--write --target codex]');
|
|
121
|
-
console.log(' memorix skills show --name <skill>');
|
|
122
|
-
}
|
|
123
|
-
} catch (error) {
|
|
124
|
-
emitError(error instanceof Error ? error.message : String(error), asJson);
|
|
125
|
-
}
|
|
126
|
-
},
|
|
127
|
-
});
|
|
128
|
-
|
|
93
|
+
id: obs.id,
|
|
94
|
+
entityName: obs.entityName,
|
|
95
|
+
type: obs.type,
|
|
96
|
+
title: obs.title,
|
|
97
|
+
narrative: obs.narrative,
|
|
98
|
+
facts: obs.facts,
|
|
99
|
+
concepts: obs.concepts,
|
|
100
|
+
filesModified: obs.filesModified,
|
|
101
|
+
createdAt: obs.createdAt,
|
|
102
|
+
status: obs.status,
|
|
103
|
+
source: obs.source,
|
|
104
|
+
}));
|
|
105
|
+
const generated = engine.generateFromObservations(observations);
|
|
106
|
+
const skill = generated.find((entry) => entry.name.toLowerCase() === name.toLowerCase());
|
|
107
|
+
if (!skill) {
|
|
108
|
+
emitError(`Skill "${name}" not found`, asJson);
|
|
109
|
+
return;
|
|
110
|
+
}
|
|
111
|
+
emitResult({ project, skill }, skill.content, asJson);
|
|
112
|
+
return;
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
default:
|
|
116
|
+
console.log('Memorix Skills Commands');
|
|
117
|
+
console.log('');
|
|
118
|
+
console.log('Usage:');
|
|
119
|
+
console.log(' memorix skills list');
|
|
120
|
+
console.log(' memorix skills generate [--write --target codex]');
|
|
121
|
+
console.log(' memorix skills show --name <skill>');
|
|
122
|
+
}
|
|
123
|
+
} catch (error) {
|
|
124
|
+
emitError(error instanceof Error ? error.message : String(error), asJson);
|
|
125
|
+
}
|
|
126
|
+
},
|
|
127
|
+
});
|
|
128
|
+
|