@vaur94/agz-memory 0.5.0 → 0.5.1
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/ARCHITECTURE.md +3 -3
- package/CHANGELOG.md +17 -0
- package/README.md +15 -12
- package/README.tr.md +15 -12
- package/dist/admin.js +687 -124
- package/dist/core.js +852 -91
- package/dist/server.js +945 -163
- package/dist/types/admin/quarantine.d.ts +15 -0
- package/dist/types/admin/reindex.d.ts +41 -0
- package/dist/types/config.d.ts +1 -0
- package/dist/types/contracts/error.d.ts +16 -0
- package/dist/types/contracts/limits.d.ts +18 -0
- package/dist/types/contracts/mutation.d.ts +31 -0
- package/dist/types/contracts/pagination.d.ts +27 -0
- package/dist/types/core.d.ts +4 -0
- package/dist/types/db/health.d.ts +3 -1
- package/dist/types/db/legacy-health.d.ts +3 -1
- package/dist/types/db.d.ts +11 -1
- package/dist/types/security/quarantine-key.d.ts +47 -0
- package/dist/types/server.d.ts +1 -1
- package/dist/types/store/capture.d.ts +5 -1
- package/dist/types/store/outbox.d.ts +10 -1
- package/dist/types/store.d.ts +27 -9
- package/dist/types/version.d.ts +1 -1
- package/docs/backup-restore-runbook.md +16 -16
- package/docs/backup-restore-runbook.tr.md +16 -16
- package/docs/schema-v11.md +1 -1
- package/package.json +3 -3
- package/skills/index.json +1 -1
package/ARCHITECTURE.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# AGZ Memory Architecture
|
|
2
2
|
|
|
3
|
-
This document describes the `0.5.
|
|
3
|
+
This document describes the `0.5.1` runtime and SQLite schema v11.
|
|
4
4
|
|
|
5
5
|
## System Boundaries
|
|
6
6
|
|
|
@@ -20,7 +20,7 @@ OpenCode V2 beta-18743
|
|
|
20
20
|
|
|
21
21
|
SQLite outbox
|
|
22
22
|
-> optional derived retrieval backend
|
|
23
|
-
-> disabled in 0.5.
|
|
23
|
+
-> disabled in 0.5.1; backend = none
|
|
24
24
|
```
|
|
25
25
|
|
|
26
26
|
The MCP adapter owns tool schemas, annotations, and result envelopes. The core
|
|
@@ -133,7 +133,7 @@ original OpenCode context unchanged.
|
|
|
133
133
|
|
|
134
134
|
Semantic providers implement an optional backend contract: project-filtered
|
|
135
135
|
query, idempotent upsert, deterministic delete, full project purge, and health.
|
|
136
|
-
No provider is enabled in `0.5.
|
|
136
|
+
No provider is enabled in `0.5.1`. The SQLite lexical/graph path remains fully
|
|
137
137
|
functional without one.
|
|
138
138
|
|
|
139
139
|
## Derived Index Outbox
|
package/CHANGELOG.md
CHANGED
|
@@ -3,6 +3,23 @@
|
|
|
3
3
|
All notable changes to AGZ Memory are recorded here. The project follows
|
|
4
4
|
[Semantic Versioning](https://semver.org/).
|
|
5
5
|
|
|
6
|
+
## [0.5.1] - 2026-09-04
|
|
7
|
+
|
|
8
|
+
> Candidate metadata only; no npm publication, Git tag, or merge is claimed.
|
|
9
|
+
|
|
10
|
+
### Changed
|
|
11
|
+
|
|
12
|
+
- Hardened Phase 1 stabilization with the migration-root fix, shared limits and
|
|
13
|
+
typed errors, bounded pagination, strict default-off plugin configuration,
|
|
14
|
+
bounded late attachment/shutdown, and resumable administrative reindexing.
|
|
15
|
+
- Added the 10-sample p95 migration timing artifact, safe clean/evidence
|
|
16
|
+
tooling, and keyed quarantine HMAC rotation with Windows fail-closed behavior.
|
|
17
|
+
|
|
18
|
+
### Security
|
|
19
|
+
|
|
20
|
+
- Preserved exactly nine MCP tools, SQLite schema 11, semantic backend `none`,
|
|
21
|
+
and inert plugin defaults.
|
|
22
|
+
|
|
6
23
|
## [0.5.0] - 2026-09-02
|
|
7
24
|
|
|
8
25
|
### Added
|
package/README.md
CHANGED
|
@@ -10,6 +10,9 @@ as two independently usable packages that advance at the same version:
|
|
|
10
10
|
- `@vaur94/agz-memory-plugin`: an optional OpenCode V2 adapter for bounded
|
|
11
11
|
retrieval and deliberately staged automatic capture.
|
|
12
12
|
|
|
13
|
+
**0.5.1 status:** This repository documents a candidate only. It does not claim
|
|
14
|
+
npm publication, a Git tag, or a merge.
|
|
15
|
+
|
|
13
16
|
The MCP server is ready for normal use. The plugin starts inert: no project is
|
|
14
17
|
created, no session is captured, and no context is injected until an explicit
|
|
15
18
|
binding and rollout mode are configured.
|
|
@@ -32,8 +35,8 @@ binding and rollout mode are configured.
|
|
|
32
35
|
|
|
33
36
|
| Component | Supported version |
|
|
34
37
|
|---|---|
|
|
35
|
-
| Core and MCP | `0.5.
|
|
36
|
-
| OpenCode plugin | `0.5.
|
|
38
|
+
| Core and MCP | `0.5.1` |
|
|
39
|
+
| OpenCode plugin | `0.5.1` |
|
|
37
40
|
| OpenCode V2 | `0.0.0-beta-18743` |
|
|
38
41
|
| `@opencode-ai/plugin` | `0.0.0-beta-18743` |
|
|
39
42
|
| Bun | `>=1.3.14` |
|
|
@@ -47,7 +50,7 @@ itself unless the running OpenCode version exactly matches the supported beta.
|
|
|
47
50
|
Run the server directly:
|
|
48
51
|
|
|
49
52
|
```sh
|
|
50
|
-
bunx @vaur94/agz-memory@0.5.
|
|
53
|
+
bunx @vaur94/agz-memory@0.5.1
|
|
51
54
|
```
|
|
52
55
|
|
|
53
56
|
Or register it in OpenCode V2 under `mcp.servers`:
|
|
@@ -55,13 +58,13 @@ Or register it in OpenCode V2 under `mcp.servers`:
|
|
|
55
58
|
```jsonc
|
|
56
59
|
{
|
|
57
60
|
"skills": [
|
|
58
|
-
"https://raw.githubusercontent.com/ugur-murat-alt/agz-memory/v0.5.
|
|
61
|
+
"https://raw.githubusercontent.com/ugur-murat-alt/agz-memory/v0.5.1/skills/"
|
|
59
62
|
],
|
|
60
63
|
"mcp": {
|
|
61
64
|
"servers": {
|
|
62
65
|
"agz-memory": {
|
|
63
66
|
"type": "local",
|
|
64
|
-
"command": ["bunx", "@vaur94/agz-memory@0.5.
|
|
67
|
+
"command": ["bunx", "@vaur94/agz-memory@0.5.1"],
|
|
65
68
|
"environment": {
|
|
66
69
|
"OPENCODE_MEMORY_DATABASE_PATH": "{env:OPENCODE_MEMORY_DATABASE_PATH}"
|
|
67
70
|
},
|
|
@@ -130,7 +133,7 @@ options:
|
|
|
130
133
|
{
|
|
131
134
|
"plugins": [
|
|
132
135
|
{
|
|
133
|
-
"package": "@vaur94/agz-memory-plugin@0.5.
|
|
136
|
+
"package": "@vaur94/agz-memory-plugin@0.5.1",
|
|
134
137
|
"options": {
|
|
135
138
|
"mode": "off",
|
|
136
139
|
"autoCreateProjects": false,
|
|
@@ -203,11 +206,11 @@ quality, and latency gates.
|
|
|
203
206
|
The admin CLI reads the same `OPENCODE_MEMORY_DATABASE_PATH`:
|
|
204
207
|
|
|
205
208
|
```sh
|
|
206
|
-
bunx --package @vaur94/agz-memory@0.5.
|
|
207
|
-
bunx --package @vaur94/agz-memory@0.5.
|
|
208
|
-
bunx --package @vaur94/agz-memory@0.5.
|
|
209
|
-
bunx --package @vaur94/agz-memory@0.5.
|
|
210
|
-
bunx --package @vaur94/agz-memory@0.5.
|
|
209
|
+
bunx --package @vaur94/agz-memory@0.5.1 agz-memory-admin doctor
|
|
210
|
+
bunx --package @vaur94/agz-memory@0.5.1 agz-memory-admin backup
|
|
211
|
+
bunx --package @vaur94/agz-memory@0.5.1 agz-memory-admin upgrade --to 11
|
|
212
|
+
bunx --package @vaur94/agz-memory@0.5.1 agz-memory-admin capture status
|
|
213
|
+
bunx --package @vaur94/agz-memory@0.5.1 agz-memory-admin outbox status
|
|
211
214
|
```
|
|
212
215
|
|
|
213
216
|
Upgrades take an exclusive migration lock and create a verified backup before
|
|
@@ -216,7 +219,7 @@ restore. Restore and backup deletion use dry-run output plus explicit
|
|
|
216
219
|
confirmation values; never guess them.
|
|
217
220
|
|
|
218
221
|
Use [the backup and restore runbook](docs/backup-restore-runbook.md) for a full
|
|
219
|
-
rehearsal. Final `0.5.
|
|
222
|
+
rehearsal. Final `0.5.1` backup manifests use `agz-memory-backup/1`; prerelease
|
|
220
223
|
manifests must be handled by the prerelease that created them.
|
|
221
224
|
|
|
222
225
|
## Security Model
|
package/README.tr.md
CHANGED
|
@@ -10,6 +10,9 @@ Aynı sürümde ilerleyen, birbirinden bağımsız kullanılabilen iki paket sun
|
|
|
10
10
|
- `@vaur94/agz-memory-plugin`: sınırlı geri çağırma ve bilinçli olarak aşamalı
|
|
11
11
|
otomatik yakalama için isteğe bağlı OpenCode V2 bağdaştırıcısı.
|
|
12
12
|
|
|
13
|
+
**0.5.1 durumu:** Bu depo yalnızca aday sürüm metadata'sını belgeler; npm
|
|
14
|
+
yayımlama, Git etiketi veya birleştirme iddiası içermez.
|
|
15
|
+
|
|
13
16
|
MCP sunucusu normal kullanım için hazırdır. Eklenti hareketsiz başlar: açık bir
|
|
14
17
|
eşleme ve devreye alma modu verilene kadar proje oluşturmaz, oturum yakalamaz ve
|
|
15
18
|
bağlam eklemez.
|
|
@@ -32,8 +35,8 @@ bağlam eklemez.
|
|
|
32
35
|
|
|
33
36
|
| Bileşen | Desteklenen sürüm |
|
|
34
37
|
|---|---|
|
|
35
|
-
| Çekirdek ve MCP | `0.5.
|
|
36
|
-
| OpenCode eklentisi | `0.5.
|
|
38
|
+
| Çekirdek ve MCP | `0.5.1` |
|
|
39
|
+
| OpenCode eklentisi | `0.5.1` |
|
|
37
40
|
| OpenCode V2 | `0.0.0-beta-18743` |
|
|
38
41
|
| `@opencode-ai/plugin` | `0.0.0-beta-18743` |
|
|
39
42
|
| Bun | `>=1.3.14` |
|
|
@@ -47,7 +50,7 @@ MCP sunucusu bir OpenCode beta sürümüne bağlı değildir. İsteğe bağlı e
|
|
|
47
50
|
Sunucuyu doğrudan çalıştırın:
|
|
48
51
|
|
|
49
52
|
```sh
|
|
50
|
-
bunx @vaur94/agz-memory@0.5.
|
|
53
|
+
bunx @vaur94/agz-memory@0.5.1
|
|
51
54
|
```
|
|
52
55
|
|
|
53
56
|
Ya da OpenCode V2 içinde `mcp.servers` altına kaydedin:
|
|
@@ -55,13 +58,13 @@ Ya da OpenCode V2 içinde `mcp.servers` altına kaydedin:
|
|
|
55
58
|
```jsonc
|
|
56
59
|
{
|
|
57
60
|
"skills": [
|
|
58
|
-
"https://raw.githubusercontent.com/ugur-murat-alt/agz-memory/v0.5.
|
|
61
|
+
"https://raw.githubusercontent.com/ugur-murat-alt/agz-memory/v0.5.1/skills/"
|
|
59
62
|
],
|
|
60
63
|
"mcp": {
|
|
61
64
|
"servers": {
|
|
62
65
|
"agz-memory": {
|
|
63
66
|
"type": "local",
|
|
64
|
-
"command": ["bunx", "@vaur94/agz-memory@0.5.
|
|
67
|
+
"command": ["bunx", "@vaur94/agz-memory@0.5.1"],
|
|
65
68
|
"environment": {
|
|
66
69
|
"OPENCODE_MEMORY_DATABASE_PATH": "{env:OPENCODE_MEMORY_DATABASE_PATH}"
|
|
67
70
|
},
|
|
@@ -132,7 +135,7 @@ ayarlarla ekleyin:
|
|
|
132
135
|
{
|
|
133
136
|
"plugins": [
|
|
134
137
|
{
|
|
135
|
-
"package": "@vaur94/agz-memory-plugin@0.5.
|
|
138
|
+
"package": "@vaur94/agz-memory-plugin@0.5.1",
|
|
136
139
|
"options": {
|
|
137
140
|
"mode": "off",
|
|
138
141
|
"autoCreateProjects": false,
|
|
@@ -205,11 +208,11 @@ kapılarından geçene kadar `semanticBackend` değeri `none` olmalıdır.
|
|
|
205
208
|
Yönetim aracı aynı `OPENCODE_MEMORY_DATABASE_PATH` değerini okur:
|
|
206
209
|
|
|
207
210
|
```sh
|
|
208
|
-
bunx --package @vaur94/agz-memory@0.5.
|
|
209
|
-
bunx --package @vaur94/agz-memory@0.5.
|
|
210
|
-
bunx --package @vaur94/agz-memory@0.5.
|
|
211
|
-
bunx --package @vaur94/agz-memory@0.5.
|
|
212
|
-
bunx --package @vaur94/agz-memory@0.5.
|
|
211
|
+
bunx --package @vaur94/agz-memory@0.5.1 agz-memory-admin doctor
|
|
212
|
+
bunx --package @vaur94/agz-memory@0.5.1 agz-memory-admin backup
|
|
213
|
+
bunx --package @vaur94/agz-memory@0.5.1 agz-memory-admin upgrade --to 11
|
|
214
|
+
bunx --package @vaur94/agz-memory@0.5.1 agz-memory-admin capture status
|
|
215
|
+
bunx --package @vaur94/agz-memory@0.5.1 agz-memory-admin outbox status
|
|
213
216
|
```
|
|
214
217
|
|
|
215
218
|
Yükseltmeler özel bir geçiş kilidi alır ve veritabanını değiştirmeden önce
|
|
@@ -218,7 +221,7 @@ dener. Geri yükleme ve yedek silme işlemleri önce deneme çıktısı, sonra a
|
|
|
218
221
|
onay değerleri ister; bu değerleri tahmin etmeyin.
|
|
219
222
|
|
|
220
223
|
Tam prova için [yedekleme ve geri yükleme runbook'unu](docs/backup-restore-runbook.tr.md)
|
|
221
|
-
kullanın. Final `0.5.
|
|
224
|
+
kullanın. Final `0.5.1` yedek manifestleri `agz-memory-backup/1` kullanır;
|
|
222
225
|
ön sürüm manifestleri onları oluşturan ön sürümle işlenmelidir.
|
|
223
226
|
|
|
224
227
|
## Güvenlik Modeli
|