@vaur94/agz-memory 0.4.0-beta.1

package/dist/types/types.d.ts

@@ -0,0 +1,54 @@
+export declare const SCHEMA_VERSION = 9;
+export declare const INLINE_LIMIT = 1200;
+export declare const KINDS: readonly ["decision", "fact", "procedure", "context", "research", "preference", "task"];
+export type Kind = (typeof KINDS)[number];
+export declare const PREDICATES: readonly ["SUPPORTS", "DERIVED_FROM", "PART_OF", "ABOUT", "PRECEDES", "SUPERSEDES"];
+export type Predicate = (typeof PREDICATES)[number];
+export type SizeClass = "inline" | "indexed";
+export interface Project {
+    projectID: string;
+    projectName: string;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface ProjectSummary extends Project {
+    noteCount: number;
+    pinnedCount: number;
+}
+export interface Note {
+    id: string;
+    projectID: string;
+    projectName: string;
+    kind: Kind;
+    title: string;
+    summary: string;
+    content: string;
+    sizeClass: SizeClass;
+    pinned: boolean;
+    status: "active" | "superseded" | "archived";
+    supersedesID: string | null;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface Edge {
+    id: string;
+    projectID: string;
+    projectName: string;
+    sourceID: string;
+    targetID: string;
+    predicate: Predicate;
+    createdAt: number;
+}
+export interface RecallCard {
+    id: string;
+    projectID: string;
+    projectName: string;
+    kind: Kind;
+    title: string;
+    summary: string;
+    content?: string;
+    sizeClass: SizeClass;
+    pinned: boolean;
+    via: "match" | "neighbor";
+    predicates?: string[];
+}

package/docs/backup-restore-runbook.md

@@ -0,0 +1,73 @@
+# Backup And Restore Runbook
+
+## Preconditions
+
+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.
+
+## Upgrade To Schema V9
+
+```sh
+export OPENCODE_MEMORY_DATABASE_PATH="$HOME/.local/share/opencode-memory/memory.sqlite"
+
+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
+```
+
+Do not start a writer if the final doctor report has `ok: false`. Preserve the
+manifest path and SHA-256 printed by `backup`.
+
+## Restore Rehearsal
+
+The first invocation is a dry run:
+
+```sh
+bunx --package @vaur94/agz-memory@0.4.0-beta.1 agz-memory-admin restore \
+  "$OPENCODE_MEMORY_DATABASE_PATH.backup/<backup>.manifest.json"
+```
+
+Verify `targetPath`, `sourceSchema`, row counts, and `sha256`. Then run:
+
+```sh
+bunx --package @vaur94/agz-memory@0.4.0-beta.1 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.
+
+## Stale Migration Lock
+
+Inspect `<database>.migration.lock/owner.json`. Never break a live owner.
+
+```sh
+bunx --package @vaur94/agz-memory@0.4.0-beta.1 agz-memory-admin unlock \
+  --owner <exact-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.
+
+## Backup Pruning
+
+Pruning is dry-run by default and returns a digest:
+
+```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 \
+  --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.

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@vaur94/agz-memory",
+  "version": "0.4.0-beta.1",
+  "description": "Project-scoped persistent linked memory MCP server for OpenCode V2",
+  "type": "module",
+  "main": "./dist/server.js",
+  "exports": {
+    ".": "./dist/server.js",
+    "./core": {
+      "types": "./dist/types/core.d.ts",
+      "default": "./dist/core.js"
+    }
+  },
+  "bin": {
+    "agz-memory": "dist/server.js",
+    "agz-memory-admin": "dist/admin.js"
+  },
+  "files": [
+    "README.md",
+    "README.tr.md",
+    "dist/server.js",
+    "dist/core.js",
+    "dist/admin.js",
+    "dist/types/**/*.d.ts",
+    "ARCHITECTURE.md",
+    "CHANGELOG.md",
+    "docs/backup-restore-runbook.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "types": "rm -rf dist/types && bunx tsc -p tsconfig.build.json",
+    "build": "rm -rf dist && bun build src/index.ts --target bun --format esm --packages external --outfile dist/server.js && bun build src/core.ts --target bun --format esm --packages external --outfile dist/core.js && bun build src/admin/index.ts --target bun --format esm --packages external --outfile dist/admin.js && bunx tsc -p tsconfig.build.json && bun run --cwd packages/opencode-plugin build",
+    "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"
+  },
+  "engines": {
+    "bun": ">=1.3.14"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ugur-murat-alt/agz-memory.git"
+  },
+  "homepage": "https://github.com/ugur-murat-alt/agz-memory#readme",
+  "bugs": {
+    "url": "https://github.com/ugur-murat-alt/agz-memory/issues"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@modelcontextprotocol/client": "^2.0.0",
+    "@opencode-ai/plugin": "0.0.0-beta-18743",
+    "@types/bun": "^1.3.14",
+    "typescript": "^7.0.2"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/server": "^2.0.0",
+    "zod": "^4.2.0"
+  }
+}