memorix 1.2.3 → 1.2.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.
- package/CHANGELOG.md +33 -0
- package/README.md +3 -3
- package/README.zh-CN.md +3 -3
- package/dist/cli/index.js +5273 -4730
- package/dist/cli/index.js.map +1 -1
- package/dist/index.js +506 -99
- package/dist/index.js.map +1 -1
- package/dist/maintenance-runner.js +176 -53
- package/dist/maintenance-runner.js.map +1 -1
- package/dist/memcode-runtime/CHANGELOG.md +33 -0
- package/dist/sdk.d.ts +4 -2
- package/dist/sdk.js +507 -99
- package/dist/sdk.js.map +1 -1
- package/dist/types.d.ts +8 -1
- package/dist/types.js.map +1 -1
- package/docs/1.2.4-PERSISTENT-MEMORY-DELIVERY.md +86 -0
- package/docs/1.2.5-RETRIEVAL-PERFORMANCE.md +85 -0
- package/docs/AGENT_OPERATOR_PLAYBOOK.md +13 -1
- package/docs/API_REFERENCE.md +13 -3
- package/docs/PERFORMANCE.md +22 -1
- package/docs/dev-log/progress.txt +73 -7
- package/package.json +2 -1
- package/plugins/codex/memorix/.codex-plugin/plugin.json +1 -1
- package/src/cli/capability-map.ts +1 -1
- package/src/cli/command-guide.ts +4 -1
- package/src/cli/commands/agent-integrations.ts +5 -1
- package/src/cli/commands/codegraph.ts +1 -1
- package/src/cli/commands/context.ts +9 -1
- package/src/cli/commands/memory.ts +12 -3
- package/src/cli/commands/operator-shared.ts +74 -2
- package/src/cli/commands/resume.ts +31 -0
- package/src/cli/index.ts +5 -1
- package/src/codegraph/auto-context.ts +54 -1
- package/src/codegraph/task-lens.ts +29 -0
- package/src/compact/token-budget.ts +16 -1
- package/src/config/resolved-config.ts +29 -4
- package/src/config/toml-loader.ts +9 -5
- package/src/hooks/handler.ts +127 -66
- package/src/hooks/installers/index.ts +5 -4
- package/src/hooks/official-skills.ts +6 -4
- package/src/hooks/rules/memorix-agent-rules.md +9 -7
- package/src/knowledge/context-assembly.ts +4 -1
- package/src/knowledge/workset.ts +89 -1
- package/src/memory/session.ts +144 -10
- package/src/runtime/project-maintenance.ts +1 -14
- package/src/sdk.ts +4 -0
- package/src/server.ts +144 -25
- package/src/store/bun-sqlite-compat.ts +118 -15
- package/src/store/orama-store.ts +39 -18
- package/src/store/sqlite-db.ts +3 -3
- package/src/timeout.ts +23 -0
- package/src/types.ts +8 -0
|
@@ -2,6 +2,39 @@
|
|
|
2
2
|
|
|
3
3
|
All notable changes to this project will be documented in this file.
|
|
4
4
|
|
|
5
|
+
## [1.2.5] - 2026-07-27
|
|
6
|
+
|
|
7
|
+
### Added
|
|
8
|
+
- **Explicit retrieval profiles** -- Search now accepts `fast`, `balanced` (default), or `thorough` through the CLI, MCP, and SDK. Fast is fully local, balanced keeps optional LLM work out of everyday retrieval, and thorough explicitly opts into configured LLM query refinement.
|
|
9
|
+
- **Reproducible retrieval evidence** -- Added `npm run benchmark:retrieval` for a clearly-labelled hot in-process SDK lexical benchmark with p50/p95/p99 output. It does not present CLI startup, MCP transport, remote embedding, or LLM latency as the same metric.
|
|
10
|
+
|
|
11
|
+
### Changed
|
|
12
|
+
- **Lighter read-only CLI path** -- Memory search, detail, timeline, recent, graph context, and help no longer create session bookkeeping or maintenance-target metadata. Identity and visibility checks remain unchanged.
|
|
13
|
+
|
|
14
|
+
### Fixed
|
|
15
|
+
- **Completed searches no longer retain timeout watchdogs** -- Embedding, rerank, MCP search, and maintenance timeout paths share a helper that clears the timer when work settles. This removes the avoidable CLI exit delay caused by an already-completed optional rerank.
|
|
16
|
+
- **OpenRouter lane isolation** -- An embedding-only `OPENROUTER_API_KEY` no longer silently enables the memory LLM lane. It remains valid for a memory LLM only when that lane explicitly selects an OpenRouter provider or base URL.
|
|
17
|
+
|
|
18
|
+
## [1.2.4] - 2026-07-26
|
|
19
|
+
|
|
20
|
+
### Added
|
|
21
|
+
- **One-call continuation for CLI-only agents** -- Added `memorix resume "<task>"`, a direct terminal entry that returns the same bounded Memory Autopilot Workset as Project Context without requiring MCP discovery or command probing.
|
|
22
|
+
|
|
23
|
+
### Changed
|
|
24
|
+
- **Continuation is a delivery choice, not a separate memory silo** -- Project Context now recognizes continuation language independently of its task lens. It adds only the latest meaningful session summary and up to three readable durable anchors, with source records in the existing context receipt. Ordinary new tasks remain free of old-session dumps.
|
|
25
|
+
- **Stable agent fallback guidance** -- Generated skills and rules now direct an agent with unavailable MCP to make exactly one task-aware CLI call: `memorix resume` for prior work or `memorix context` for a new task. Continuation requests must take that brief before local file/Git archaeology, and an absent `.memorix` directory is not treated as proof that no durable memory exists. This prevents broad command enumeration, repeated search loops, and false cold-start conclusions.
|
|
26
|
+
|
|
27
|
+
### Fixed
|
|
28
|
+
- **Claude continuation delivery** -- Claude Code now receives an explicit continuation's bounded prior-work Workset through its official `UserPromptSubmit.additionalContext` response, rather than relying on an advisory rule or a SessionStart message the host does not place in model context. `memory.inject = "silent"` still disables automatic injection.
|
|
29
|
+
- **Fresh-install SQLite resilience** -- When the optional `better-sqlite3` native binary is missing on a supported Node 22 runtime, Memorix now opens the same local `memorix.db` through Node's built-in SQLite instead of losing session and durable-memory reads across CLI or hook processes. No data migration or configuration change is required.
|
|
30
|
+
- **Standard TOML literal strings** -- Project and global configuration now accepts single-quoted TOML strings, including `#` characters inside the literal value.
|
|
31
|
+
- **MCP continuation summary parity** -- `memorix_project_context` now includes the same bounded prior-session and durable-memory evidence in `format: "summary"` as it does in the default prompt format, so agents that request a compact summary do not lose a valid handoff.
|
|
32
|
+
- **Actionable continuation anchors** -- Bounded continuation text no longer cuts a technical flag or symbol halfway through. The shared guidance also avoids redundant Context Pack/search/detail calls after a complete Autopilot brief, keeping the default agent path compact.
|
|
33
|
+
- **Autopilot duplicate retrieval** -- A completed MCP Project Context now holds a short-lived delivery boundary. Follow-up search/detail calls do not re-send memories already represented in that brief unless the user explicitly asks to inspect the underlying record.
|
|
34
|
+
- **Read-only memory mutation** -- A task that asks for read-only work or says not to modify files now rejects automatic `memorix_store` writes. An agent must have an explicit user request before it can override that boundary.
|
|
35
|
+
- **Prior-work privacy parity** -- Continuation retrieval applies the same project, team, and personal-memory visibility reader as session context, including canonical project aliases. A different identity cannot receive another agent's personal durable memory through the new delivery path.
|
|
36
|
+
- **Rule-surface drift** -- The shared automatic-memory rule file now carries the same one-call CLI fallback contract as setup-generated agent guidance.
|
|
37
|
+
|
|
5
38
|
## [1.2.3] - 2026-07-25
|
|
6
39
|
|
|
7
40
|
### Fixed
|
package/dist/sdk.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { Entity, Relation, KnowledgeGraph, ProjectInfo, DetectionResult, ObservationType, ObservationStatus, ProgressInfo, Observation, IndexEntry } from './types.js';
|
|
1
|
+
import { Entity, Relation, KnowledgeGraph, ProjectInfo, DetectionResult, ObservationType, ObservationStatus, RetrievalQuality, ProgressInfo, Observation, IndexEntry } from './types.js';
|
|
2
2
|
export { AgentTarget, DEFAULT_CONFIG, DetectionFailure, DetectionFailureReason, DocumentType, KnowledgeLayer, MCPConfigAdapter, MCPServerEntry, MemorixConfig, MemorixDocument, MemoryRef, MiniSkill, OBSERVATION_ICONS, ObservationAdmissionState, ObservationReader, ObservationRef, ObservationVisibility, RuleFormatAdapter, RuleSource, SearchOptions, Session, SkillConflict, SkillEntry, SnapshotObservation, SourceSnapshot, TOPIC_KEY_FAMILIES, TimelineContext, UnifiedRule, WorkflowEntry, WorkspaceSyncResult } from './types.js';
|
|
3
3
|
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
4
4
|
|
|
@@ -559,6 +559,8 @@ interface ClientSearchOptions {
|
|
|
559
559
|
status?: ObservationStatus | 'all';
|
|
560
560
|
/** Maximum results. Default: 20 */
|
|
561
561
|
limit?: number;
|
|
562
|
+
/** Retrieval profile. Default: balanced. */
|
|
563
|
+
quality?: RetrievalQuality;
|
|
562
564
|
}
|
|
563
565
|
/** Result from resolving observations */
|
|
564
566
|
interface ResolveResult {
|
|
@@ -687,4 +689,4 @@ declare class MemoryClient {
|
|
|
687
689
|
*/
|
|
688
690
|
declare function createMemoryClient(options: MemoryClientOptions): Promise<MemoryClient>;
|
|
689
691
|
|
|
690
|
-
export { type ClientSearchOptions, type CreateMemorixServerOptions, DetectionResult, Entity, IndexEntry, KnowledgeGraph, MemoryClient, type MemoryClientOptions, Observation, ObservationStatus, ObservationType, ProgressInfo, ProjectInfo, Relation, type ResolveResult, type StoreInput, type StoreResult, createMemorixServer, createMemoryClient, detectProject, detectProjectWithDiagnostics };
|
|
692
|
+
export { type ClientSearchOptions, type CreateMemorixServerOptions, DetectionResult, Entity, IndexEntry, KnowledgeGraph, MemoryClient, type MemoryClientOptions, Observation, ObservationStatus, ObservationType, ProgressInfo, ProjectInfo, Relation, type ResolveResult, RetrievalQuality, type StoreInput, type StoreResult, createMemorixServer, createMemoryClient, detectProject, detectProjectWithDiagnostics };
|