@vaur94/agz-memory 0.4.0-beta.1 → 0.4.0

package/dist/types/capture/contract.d.ts

@@ -1,5 +1,5 @@
 import * as z from "zod/v4";
-export declare const CAPTURE_SCHEMA: "opencode2-memory.capture/1";
+export declare const CAPTURE_SCHEMA: "agz-memory.capture/1";
 export declare const SUPPORTED_OPENCODE_VERSION: "0.0.0-beta-18743";
 export declare const CAPTURE_EVENT_MAX_BYTES: number;
 export declare const CAPTURE_CONTENT_MAX_CHARACTERS = 4800;
@@ -34,7 +34,7 @@ declare const candidateSchema: z.ZodObject<{
     }>;
 }, z.core.$strict>;
 export declare const captureEventSchema: z.ZodObject<{
-    schema: z.ZodLiteral<"opencode2-memory.capture/1">;
+    schema: z.ZodLiteral<"agz-memory.capture/1">;
     idempotencyKey: z.ZodString;
     projectID: z.ZodUUID;
     bindingKey: z.ZodString;

package/dist/types/core.d.ts

@@ -28,3 +28,4 @@ export * from "./retrieval/contract";
 export * from "./retrieval/formatter";
 export * from "./store/capture";
 export * from "./types";
+export * from "./version";

package/dist/types/db/backup.d.ts

@@ -1,5 +1,5 @@
 import { Database } from "bun:sqlite";
-export declare const BACKUP_FORMAT: "opencode2-memory-backup/1";
+export declare const BACKUP_FORMAT: "agz-memory-backup/1";
 export interface BackupManifest {
     format: typeof BACKUP_FORMAT;
     productVersion: string;

package/dist/types/db/migrations/v010.d.ts

@@ -0,0 +1,2 @@
+import type { Database } from "bun:sqlite";
+export declare function migrateV9ToV10(db: Database): void;

package/dist/types/db/schema.d.ts

@@ -1,5 +1,6 @@
 import type { Database } from "bun:sqlite";
-export declare const SCHEMA_V9_TABLES = "\nCREATE TABLE IF NOT EXISTS projects (\n  id TEXT PRIMARY KEY,\n  name TEXT NOT NULL,\n  normalized_name TEXT NOT NULL UNIQUE,\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL\n);\nCREATE TABLE IF NOT EXISTS notes (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  kind TEXT NOT NULL CHECK (kind IN ('decision','fact','procedure','context','research','preference','task')),\n  title TEXT NOT NULL,\n  summary TEXT NOT NULL,\n  content TEXT NOT NULL,\n  size_class TEXT NOT NULL CHECK (size_class IN ('inline','indexed')),\n  pinned INTEGER NOT NULL DEFAULT 0 CHECK (pinned IN (0,1)),\n  status TEXT NOT NULL DEFAULT 'active' CHECK (status IN ('active','superseded','archived')),\n  supersedes_id TEXT,\n  current_revision INTEGER NOT NULL DEFAULT 1 CHECK (current_revision >= 1),\n  subject_key TEXT,\n  content_hash TEXT NOT NULL CHECK (length(content_hash) = 64),\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL,\n  UNIQUE(project_id, id)\n);\nCREATE INDEX IF NOT EXISTS notes_project_idx ON notes(project_id, status);\nCREATE UNIQUE INDEX IF NOT EXISTS notes_active_subject_idx\n  ON notes(project_id, kind, subject_key)\n  WHERE status = 'active' AND subject_key IS NOT NULL;\nCREATE TABLE IF NOT EXISTS note_edges (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  source_id TEXT NOT NULL,\n  target_id TEXT NOT NULL,\n  predicate TEXT NOT NULL CHECK (predicate IN ('SUPPORTS','DERIVED_FROM','PART_OF','ABOUT','PRECEDES','SUPERSEDES')),\n  created_at INTEGER NOT NULL,\n  UNIQUE(project_id, source_id, target_id, predicate),\n  FOREIGN KEY (project_id, source_id) REFERENCES notes(project_id, id) ON DELETE CASCADE,\n  FOREIGN KEY (project_id, target_id) REFERENCES notes(project_id, id) ON DELETE CASCADE\n);\nCREATE INDEX IF NOT EXISTS note_edges_source_idx ON note_edges(project_id, source_id);\nCREATE INDEX IF NOT EXISTS note_edges_target_idx ON note_edges(project_id, target_id);\nCREATE TABLE IF NOT EXISTS project_bindings (\n  binding_key TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  source TEXT NOT NULL CHECK (source = 'opencode-v2'),\n  source_project_id TEXT NOT NULL,\n  workspace_id TEXT NOT NULL,\n  canonical_path_hash TEXT NOT NULL CHECK (length(canonical_path_hash) = 64),\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL,\n  UNIQUE(source, source_project_id, workspace_id)\n);\nCREATE TABLE IF NOT EXISTS capture_checkpoints (\n  session_id TEXT PRIMARY KEY,\n  binding_key TEXT NOT NULL REFERENCES project_bindings(binding_key) ON DELETE CASCADE,\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  state TEXT NOT NULL CHECK (state IN ('active','idle','unavailable','closed')),\n  last_message_id TEXT,\n  last_reconciled_at INTEGER,\n  next_reconcile_at INTEGER NOT NULL,\n  failure_count INTEGER NOT NULL DEFAULT 0 CHECK (failure_count >= 0),\n  lease_owner TEXT,\n  lease_expires_at INTEGER,\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL\n);\nCREATE INDEX IF NOT EXISTS capture_checkpoints_due_idx\n  ON capture_checkpoints(state, next_reconcile_at);\nCREATE TABLE IF NOT EXISTS capture_events (\n  idempotency_key TEXT PRIMARY KEY,\n  contract TEXT NOT NULL CHECK (contract = 'opencode2-memory.capture/1'),\n  project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  binding_key TEXT NOT NULL REFERENCES project_bindings(binding_key) ON DELETE CASCADE,\n  event_kind TEXT NOT NULL CHECK (event_kind IN ('user-candidate','assistant-candidate','session-summary','tool-signal')),\n  source_session_id TEXT NOT NULL,\n  source_message_id TEXT,\n  source_ordinal INTEGER CHECK (source_ordinal IS NULL OR source_ordinal >= 0),\n  source_tool_call_id TEXT,\n  payload_json TEXT CHECK (payload_json IS NULL OR json_valid(payload_json)),\n  payload_hash TEXT,\n  redaction_version TEXT NOT NULL,\n  state TEXT NOT NULL CHECK (state IN ('pending','shadowed','review','materialized','duplicate','ignored','rejected','quarantined','failed','dead')),\n  attempt_count INTEGER NOT NULL DEFAULT 0 CHECK (attempt_count >= 0),\n  note_id TEXT,\n  last_error_code TEXT,\n  generation INTEGER NOT NULL DEFAULT 0 CHECK (generation >= 0),\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL,\n  processed_at INTEGER\n);\nCREATE INDEX IF NOT EXISTS capture_events_state_idx ON capture_events(state, updated_at);\nCREATE INDEX IF NOT EXISTS capture_events_session_idx ON capture_events(project_id, source_session_id);\nCREATE INDEX IF NOT EXISTS capture_events_note_idx ON capture_events(project_id, note_id);\nCREATE TABLE IF NOT EXISTS note_provenance (\n  id TEXT PRIMARY KEY,\n  project_id TEXT NOT NULL,\n  note_id TEXT NOT NULL,\n  source_type TEXT NOT NULL CHECK (source_type IN ('mcp-manual','opencode-capture','migration','legacy-import','admin')),\n  capture_event_id TEXT,\n  source_session_id TEXT,\n  source_message_id TEXT,\n  source_ordinal INTEGER,\n  source_tool_call_id TEXT,\n  redaction_version TEXT,\n  extractor_version TEXT,\n  confidence REAL CHECK (confidence IS NULL OR (confidence >= 0 AND confidence <= 1)),\n  created_at INTEGER NOT NULL,\n  UNIQUE(project_id, id),\n  FOREIGN KEY (project_id, note_id) REFERENCES notes(project_id, id) ON DELETE CASCADE\n);\nCREATE TABLE IF NOT EXISTS note_revisions (\n  project_id TEXT NOT NULL,\n  note_id TEXT NOT NULL,\n  revision INTEGER NOT NULL CHECK (revision >= 1),\n  kind TEXT NOT NULL,\n  title TEXT NOT NULL,\n  summary TEXT NOT NULL,\n  content TEXT NOT NULL,\n  size_class TEXT NOT NULL,\n  pinned INTEGER NOT NULL CHECK (pinned IN (0,1)),\n  status TEXT NOT NULL CHECK (status IN ('active','superseded','archived')),\n  supersedes_id TEXT,\n  subject_key TEXT,\n  content_hash TEXT NOT NULL,\n  provenance_id TEXT NOT NULL,\n  created_at INTEGER NOT NULL,\n  PRIMARY KEY(project_id, note_id, revision),\n  FOREIGN KEY (project_id, note_id) REFERENCES notes(project_id, id) ON DELETE CASCADE,\n  FOREIGN KEY (project_id, provenance_id) REFERENCES note_provenance(project_id, id)\n);\nCREATE TABLE IF NOT EXISTS index_outbox (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  backend TEXT NOT NULL,\n  operation TEXT NOT NULL CHECK (operation IN ('upsert-note','delete-note','purge-project')),\n  project_id TEXT NOT NULL,\n  note_id TEXT,\n  revision INTEGER,\n  content_hash TEXT,\n  state TEXT NOT NULL DEFAULT 'pending' CHECK (state IN ('pending','leased','succeeded','dead')),\n  attempt_count INTEGER NOT NULL DEFAULT 0 CHECK (attempt_count >= 0),\n  available_at INTEGER NOT NULL,\n  lease_owner TEXT,\n  lease_expires_at INTEGER,\n  last_error_code TEXT,\n  created_at INTEGER NOT NULL,\n  completed_at INTEGER,\n  UNIQUE(backend, operation, project_id, note_id, revision)\n);\nCREATE INDEX IF NOT EXISTS index_outbox_due_idx\n  ON index_outbox(backend, project_id, state, available_at, id);\nCREATE TABLE IF NOT EXISTS schema_state (version INTEGER PRIMARY KEY);\n";
+export declare const SCHEMA_TABLES: string;
 export declare const FTS_V9 = "\nCREATE VIRTUAL TABLE IF NOT EXISTS notes_fts USING fts5(\n  title, summary, content,\n  content='notes', content_rowid='rowid',\n  tokenize='unicode61'\n);\nCREATE TRIGGER IF NOT EXISTS notes_fts_ai AFTER INSERT ON notes BEGIN\n  INSERT INTO notes_fts(rowid, title, summary, content)\n  VALUES (new.rowid, new.title, new.summary, new.content);\nEND;\nCREATE TRIGGER IF NOT EXISTS notes_fts_ad AFTER DELETE ON notes BEGIN\n  INSERT INTO notes_fts(notes_fts, rowid, title, summary, content)\n  VALUES ('delete', old.rowid, old.title, old.summary, old.content);\nEND;\nCREATE TRIGGER IF NOT EXISTS notes_fts_au AFTER UPDATE OF title, summary, content ON notes BEGIN\n  INSERT INTO notes_fts(notes_fts, rowid, title, summary, content)\n  VALUES ('delete', old.rowid, old.title, old.summary, old.content);\n  INSERT INTO notes_fts(rowid, title, summary, content)\n  VALUES (new.rowid, new.title, new.summary, new.content);\nEND;\n";
-export declare function createSchemaV9(db: Database): void;
+export declare function createSchema(db: Database): void;
 export declare function rebuildFts(db: Database): void;
+export declare function captureEventsTable(table?: "capture_events" | "capture_events_v10"): string;

package/dist/types/server.d.ts

@@ -1,5 +1,5 @@
 import { McpServer } from "@modelcontextprotocol/server";
 import type { MemoryStore } from "./store";
 export declare const SERVER_NAME = "agz-memory";
-export declare const SERVER_VERSION = "0.4.0-beta.1";
+export declare const SERVER_VERSION: "0.4.0";
 export declare function createMemoryServer(store: MemoryStore): McpServer;

package/dist/types/store/capture.d.ts

@@ -37,6 +37,11 @@ export declare class CaptureStore {
         deleted: number;
         checkpoints: number;
     };
+    runRetentionBacklog(now?: number, batchSize?: number, maxBatches?: number): {
+        summarized: number;
+        deleted: number;
+        checkpoints: number;
+    };
     private materialize;
     private insertCapturedNote;
     private recordRevision;

package/dist/types/types.d.ts

@@ -1,4 +1,4 @@
-export declare const SCHEMA_VERSION = 9;
+export declare const SCHEMA_VERSION = 10;
 export declare const INLINE_LIMIT = 1200;
 export declare const KINDS: readonly ["decision", "fact", "procedure", "context", "research", "preference", "task"];
 export type Kind = (typeof KINDS)[number];

package/dist/types/version.d.ts

@@ -0,0 +1 @@
+export declare const PRODUCT_VERSION: "0.4.0";

package/docs/backup-restore-runbook.md

@@ -1,73 +1,149 @@
-# Backup And Restore Runbook
+# AGZ Memory Backup And Restore Runbook
 
-## Preconditions
+English | [Türkçe](backup-restore-runbook.tr.md)
+
+This runbook applies to `@vaur94/agz-memory@0.4.0` and SQLite schema v10.
 
-1. Record `OPENCODE_MEMORY_DATABASE_PATH`.
-2. Disable the OpenCode memory plugin or keep it in `off` mode.
-3. Stop every MCP/plugin process that can write the database. Version `0.3.0`
-   does not understand the v9 migration lock.
-4. Confirm the database and backup directory are owned by the current user.
+## Preconditions
 
-## Upgrade To Schema V9
+1. Export the exact production database path.
+2. Set the plugin to `mode: "off"` and `capture.enabled: false`.
+3. Stop every MCP, plugin, or admin process that can write the database.
+4. Confirm that the database directory and backup directory are owned by the
+   current user and are not symlinks.
+5. Keep enough free space for the database, its WAL checkpoint, one verified
+   backup, and one preserved restore source.
 
 ```sh
 export OPENCODE_MEMORY_DATABASE_PATH="$HOME/.local/share/opencode-memory/memory.sqlite"
+```
+
+Do not proceed with a guessed or empty path.
+
+## Health Check And Upgrade
+
+Run a read-only health report first:
+
+```sh
+bunx --package @vaur94/agz-memory@0.4.0 agz-memory-admin doctor
+```
+
+`ok` must be `true`. Record `schemaVersion`, row counts, and invariant counts.
+Then create a standalone verified backup and upgrade:
+
+```sh
+bunx --package @vaur94/agz-memory@0.4.0 agz-memory-admin backup
+bunx --package @vaur94/agz-memory@0.4.0 agz-memory-admin upgrade --to 10
+bunx --package @vaur94/agz-memory@0.4.0 agz-memory-admin doctor
+```
+
+The upgrade itself creates another verified pre-migration backup when the
+database schema is older than v10. Preserve each printed manifest path and
+SHA-256. Do not start a writer if the final report has `ok: false`.
+
+## Verify A Backup
 
-bunx --package @vaur94/agz-memory@0.4.0-beta.1 agz-memory-admin doctor
-bunx --package @vaur94/agz-memory@0.4.0-beta.1 agz-memory-admin backup
-bunx --package @vaur94/agz-memory@0.4.0-beta.1 agz-memory-admin upgrade --to 9
-bunx --package @vaur94/agz-memory@0.4.0-beta.1 agz-memory-admin doctor
+A backup pair lives under `<database>.backup/`:
+
+```text
+schema-vN-<timestamp>-<uuid>.sqlite
+schema-vN-<timestamp>-<uuid>.manifest.json
 ```
 
-Do not start a writer if the final doctor report has `ok: false`. Preserve the
-manifest path and SHA-256 printed by `backup`.
+The manifest format is `agz-memory-backup/1`. `agz-memory-admin restore` verifies
+that the manifest and database are regular files in the same backup directory,
+then checks size, SHA-256, SQLite integrity, foreign keys, and row counts.
+
+Final `0.4.0` does not accept prerelease manifest formats. Use the originating
+prerelease to restore such a backup, run its doctor check, and only then upgrade
+that restored database with `0.4.0`.
 
 ## Restore Rehearsal
 
-The first invocation is a dry run:
+Keep all writers stopped. First request a dry run by omitting confirmation:
 
 ```sh
-bunx --package @vaur94/agz-memory@0.4.0-beta.1 agz-memory-admin restore \
+bunx --package @vaur94/agz-memory@0.4.0 agz-memory-admin restore \
   "$OPENCODE_MEMORY_DATABASE_PATH.backup/<backup>.manifest.json"
 ```
 
-Verify `targetPath`, `sourceSchema`, row counts, and `sha256`. Then run:
+Compare `targetPath`, `sourceSchema`, `targetSchema`, row counts, size, and
+SHA-256 with the recorded backup. Then use the exact manifest hash:
 
 ```sh
-bunx --package @vaur94/agz-memory@0.4.0-beta.1 agz-memory-admin restore \
+bunx --package @vaur94/agz-memory@0.4.0 agz-memory-admin restore \
   "$OPENCODE_MEMORY_DATABASE_PATH.backup/<backup>.manifest.json" \
   --sha256 <manifest-database-sha256> \
   --confirm RESTORE_DATABASE_FROM_VERIFIED_BACKUP
 ```
 
-The prior database is retained as `failed-restore-source-*`. Run `doctor` and a
-read-only MCP `project_list`/`memory_recall` smoke before enabling writers.
+Restore installs a copied and verified database atomically. The replaced source
+is retained as `failed-restore-source-*`; do not delete it until the restored
+database passes all checks.
+
+## Post-Restore Validation
+
+```sh
+bunx --package @vaur94/agz-memory@0.4.0 agz-memory-admin doctor
+bunx --package @vaur94/agz-memory@0.4.0 agz-memory-admin capture status
+bunx --package @vaur94/agz-memory@0.4.0 agz-memory-admin outbox status
+```
+
+Start only the MCP server and perform read-only `project_list`, `memory_recall`,
+and `memory_read` smoke calls. Compare project/note counts with the manifest.
+Only after those checks pass should OpenCode be restarted. Keep the plugin in
+`off` until a separate rollout decision is made.
 
 ## Stale Migration Lock
 
-Inspect `<database>.migration.lock/owner.json`. Never break a live owner.
+The lock is `<database>.migration.lock/owner.json`. Never remove it while the
+recorded process is alive or any writer may still hold the database.
+
+Inspect the owner file, verify the PID/host/start time, and request a dry-run
+style error first if uncertain. Break only a proven stale lock with the exact
+owner ID and confirmation:
 
 ```sh
-bunx --package @vaur94/agz-memory@0.4.0-beta.1 agz-memory-admin unlock \
-  --owner <exact-owner-id> \
+bunx --package @vaur94/agz-memory@0.4.0 agz-memory-admin unlock \
+  --owner <owner-id> \
   --confirm BREAK_STALE_MIGRATION_LOCK
 ```
 
-The command refuses a live process with the same process-start marker.
-If `owner.json` is missing or unreadable, inspect the lock directory first and
-use `--owner ORPHANED` with the same confirmation phrase. Never use this while
-another migration process may still be starting.
+Run `doctor` immediately afterward. A stale lock is evidence of an interrupted
+operation; it is not permission to skip database validation.
 
-## Backup Pruning
+## Prune Verified Backups
 
-Pruning is dry-run by default and returns a digest:
+The first command is non-destructive and returns a digest over the exact backup
+set:
 
 ```sh
-bunx --package @vaur94/agz-memory@0.4.0-beta.1 agz-memory-admin backup prune
-bunx --package @vaur94/agz-memory@0.4.0-beta.1 agz-memory-admin backup prune \
+bunx --package @vaur94/agz-memory@0.4.0 agz-memory-admin backup prune
+```
+
+Review every listed manifest/database pair. Delete only that unchanged set:
+
+```sh
+bunx --package @vaur94/agz-memory@0.4.0 agz-memory-admin backup prune \
   --digest <dry-run-digest> \
   --confirm DELETE_VERIFIED_BACKUPS
 ```
 
-Do not prune the last known-good pre-upgrade backup until migration and restore
-rehearsals are complete.
+The command refuses deletion when any manifest, database, hash, size, or set
+membership changed after the dry run. Keep at least one separately protected,
+recent, restore-tested backup according to your retention policy.
+
+## Abort Conditions
+
+Stop and investigate if any of these occur:
+
+- `doctor` returns `ok: false`.
+- SQLite integrity or foreign-key checks fail.
+- Backup row counts differ from the source.
+- A migration lock owner may still be live.
+- The manifest is outside the configured backup root or is a symlink.
+- The restore SHA-256 differs from the dry run.
+- The final project/note counts differ from the chosen backup.
+
+Do not repair the only copy in place. Preserve the database, WAL/SHM sidecars,
+lock directory, manifests, and command output before further diagnosis.

package/docs/backup-restore-runbook.tr.md

@@ -0,0 +1,148 @@
+# AGZ Memory Yedekleme Ve Geri Yükleme Runbook'u
+
+[English](backup-restore-runbook.md) | Türkçe
+
+Bu runbook `@vaur94/agz-memory@0.4.0` ve SQLite schema v10 için geçerlidir.
+
+## Ön Koşullar
+
+1. Üretim veritabanının tam yolunu dışa aktarın.
+2. Eklentiyi `mode: "off"` ve `capture.enabled: false` durumuna getirin.
+3. Veritabanına yazabilen tüm MCP, eklenti ve yönetim süreçlerini durdurun.
+4. Veritabanı ve yedek dizinlerinin güncel kullanıcıya ait olduğunu ve sembolik
+   bağ olmadığını doğrulayın.
+5. Veritabanı, WAL kontrol noktası, bir doğrulanmış yedek ve bir korunmuş geri
+   yükleme kaynağı için yeterli boş alan bırakın.
+
+```sh
+export OPENCODE_MEMORY_DATABASE_PATH="$HOME/.local/share/opencode-memory/memory.sqlite"
+```
+
+Tahmin edilmiş veya boş bir yolla devam etmeyin.
+
+## Sağlık Kontrolü Ve Yükseltme
+
+Önce salt-okunur sağlık raporu alın:
+
+```sh
+bunx --package @vaur94/agz-memory@0.4.0 agz-memory-admin doctor
+```
+
+`ok` değeri `true` olmalıdır. `schemaVersion`, satır sayıları ve değişmez kural
+sayılarını kaydedin. Sonra bağımsız doğrulanmış yedek oluşturup yükseltin:
+
+```sh
+bunx --package @vaur94/agz-memory@0.4.0 agz-memory-admin backup
+bunx --package @vaur94/agz-memory@0.4.0 agz-memory-admin upgrade --to 10
+bunx --package @vaur94/agz-memory@0.4.0 agz-memory-admin doctor
+```
+
+Veritabanı v10'dan eskiyse yükseltme ayrıca değişiklikten önce doğrulanmış yedek
+oluşturur. Yazdırılan her manifest yolunu ve SHA-256 değerini saklayın. Son rapor
+`ok: false` ise yazıcı başlatmayın.
+
+## Yedeği Doğrulama
+
+Yedek çifti `<database>.backup/` altında bulunur:
+
+```text
+schema-vN-<timestamp>-<uuid>.sqlite
+schema-vN-<timestamp>-<uuid>.manifest.json
+```
+
+Manifest formatı `agz-memory-backup/1` olur. `agz-memory-admin restore`, manifest
+ile veritabanının aynı yedek dizinindeki normal dosyalar olduğunu doğrular;
+ardından boyut, SHA-256, SQLite bütünlüğü, foreign key ve satır sayılarını denetler.
+
+Final `0.4.0` ön sürüm manifest formatlarını kabul etmez. Böyle bir yedeği onu
+oluşturan ön sürümle geri yükleyin, o sürümün doctor kontrolünü çalıştırın ve
+yalnız bundan sonra geri yüklenen veritabanını `0.4.0` ile yükseltin.
+
+## Geri Yükleme Provası
+
+Tüm yazıcıları kapalı tutun. Önce onay vermeden deneme yapın:
+
+```sh
+bunx --package @vaur94/agz-memory@0.4.0 agz-memory-admin restore \
+  "$OPENCODE_MEMORY_DATABASE_PATH.backup/<backup>.manifest.json"
+```
+
+`targetPath`, `sourceSchema`, `targetSchema`, satır sayıları, boyut ve SHA-256
+değerlerini kaydedilen yedekle karşılaştırın. Sonra tam manifest özetini kullanın:
+
+```sh
+bunx --package @vaur94/agz-memory@0.4.0 agz-memory-admin restore \
+  "$OPENCODE_MEMORY_DATABASE_PATH.backup/<backup>.manifest.json" \
+  --sha256 <manifest-database-sha256> \
+  --confirm RESTORE_DATABASE_FROM_VERIFIED_BACKUP
+```
+
+Geri yükleme kopyalanmış ve doğrulanmış veritabanını atomik olarak kurar.
+Değiştirilen kaynak `failed-restore-source-*` adıyla korunur; geri yüklenen
+veritabanı tüm kontrollerden geçmeden bunu silmeyin.
+
+## Geri Yükleme Sonrası Doğrulama
+
+```sh
+bunx --package @vaur94/agz-memory@0.4.0 agz-memory-admin doctor
+bunx --package @vaur94/agz-memory@0.4.0 agz-memory-admin capture status
+bunx --package @vaur94/agz-memory@0.4.0 agz-memory-admin outbox status
+```
+
+Yalnız MCP sunucusunu başlatın ve salt-okunur `project_list`, `memory_recall` ve
+`memory_read` denemeleri yapın. Proje/not sayılarını manifestle karşılaştırın.
+OpenCode'u ancak bu kontroller geçince yeniden başlatın. Ayrı devreye alma kararı
+verilene kadar eklentiyi `off` tutun.
+
+## Eski Geçiş Kilidi
+
+Kilit `<database>.migration.lock/owner.json` konumundadır. Kayıtlı süreç yaşıyor
+olabilirken veya bir yazıcı veritabanını tutarken kilidi kaldırmayın.
+
+Sahip dosyasındaki PID, makine ve başlangıç zamanını doğrulayın. Yalnız eskidiği
+kanıtlanan kilidi tam sahip ID'si ve onayla kırın:
+
+```sh
+bunx --package @vaur94/agz-memory@0.4.0 agz-memory-admin unlock \
+  --owner <owner-id> \
+  --confirm BREAK_STALE_MIGRATION_LOCK
+```
+
+Hemen ardından `doctor` çalıştırın. Eski kilit kesintiye uğramış işlemin
+kanıtıdır; veritabanı doğrulamasını atlama izni değildir.
+
+## Doğrulanmış Yedekleri Temizleme
+
+İlk komut silme yapmaz ve tam yedek kümesinin özetini döndürür:
+
+```sh
+bunx --package @vaur94/agz-memory@0.4.0 agz-memory-admin backup prune
+```
+
+Listelenen her manifest/veritabanı çiftini inceleyin. Yalnız değişmemiş kümeyi
+silin:
+
+```sh
+bunx --package @vaur94/agz-memory@0.4.0 agz-memory-admin backup prune \
+  --digest <dry-run-digest> \
+  --confirm DELETE_VERIFIED_BACKUPS
+```
+
+Manifest, veritabanı, özet, boyut veya küme üyeliği denemeden sonra değişirse
+komut silmeyi reddeder. Saklama politikanıza göre ayrıca korunan, yakın tarihli
+ve geri yüklemesi denenmiş en az bir yedek tutun.
+
+## İptal Koşulları
+
+Şunlardan biri olursa durun ve inceleyin:
+
+- `doctor` sonucu `ok: false` olur.
+- SQLite bütünlük veya foreign key kontrolü başarısız olur.
+- Yedek satır sayıları kaynakla uyuşmaz.
+- Geçiş kilidi sahibi hâlâ yaşıyor olabilir.
+- Manifest yapılandırılan yedek kökü dışındadır veya sembolik bağdır.
+- Geri yükleme SHA-256 değeri deneme çıktısından farklıdır.
+- Son proje/not sayıları seçilen yedekle uyuşmaz.
+
+Tek kopyayı yerinde onarmayın. İleri incelemeden önce veritabanını, WAL/SHM yan
+dosyalarını, kilit dizinini, manifestleri ve komut çıktısını koruyun.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaur94/agz-memory",
-  "version": "0.4.0-beta.1",
+  "version": "0.4.0",
   "description": "Project-scoped persistent linked memory MCP server for OpenCode V2",
   "type": "module",
   "main": "./dist/server.js",
@@ -25,6 +25,7 @@
     "ARCHITECTURE.md",
     "CHANGELOG.md",
     "docs/backup-restore-runbook.md",
+    "docs/backup-restore-runbook.tr.md",
     "LICENSE"
   ],
   "scripts": {
@@ -33,7 +34,8 @@
     "check": "bunx tsc --noEmit && bun run types && bun run --cwd packages/opencode-plugin check",
     "test": "bun test",
     "benchmark": "bun benchmark/run.ts",
-    "prepack": "bun run check && bun run test && bun run build"
+    "release:verify": "bun scripts/verify-release.ts",
+    "prepack": "bun run release:verify && bun run check && bun run test && bun run build"
   },
   "engines": {
     "bun": ">=1.3.14"