@alexandrgreen/anchorclaw 0.0.3

package/migrations/0001_init.sql

@@ -0,0 +1,228 @@
+-- AnchorClaw: initial schema (MVP)
+
+CREATE EXTENSION IF NOT EXISTS pgcrypto;
+CREATE EXTENSION IF NOT EXISTS pg_trgm;
+
+CREATE TYPE memory_item_type AS ENUM (
+  'fact',
+  'note',
+  'profile',
+  'config',
+  'skill',
+  'automation',
+  'summary'
+);
+
+CREATE TYPE memory_item_status AS ENUM (
+  'active',
+  'superseded',
+  'archived',
+  'deleted',
+  'pending_review'
+);
+
+CREATE TYPE memory_item_source AS ENUM (
+  'user',
+  'agent',
+  'migration',
+  'system',
+  'integration'
+);
+
+CREATE TYPE memory_event_type AS ENUM (
+  'message',
+  'decision',
+  'action',
+  'observation',
+  'correction',
+  'import',
+  'export'
+);
+
+CREATE TABLE users (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  display_name TEXT,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+
+CREATE TABLE user_identities (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  user_id UUID NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+
+  channel TEXT NOT NULL,
+  external_id TEXT NOT NULL,
+  display_label TEXT,
+
+  created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+
+  UNIQUE (channel, external_id)
+);
+
+CREATE INDEX user_identities_user_idx
+  ON user_identities (user_id);
+
+CREATE TABLE workspaces (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  user_id UUID NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+
+  name TEXT NOT NULL,
+  is_default BOOLEAN NOT NULL DEFAULT false,
+  metadata JSONB NOT NULL DEFAULT '{}'::jsonb,
+
+  created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+
+  UNIQUE (user_id, name)
+);
+
+CREATE UNIQUE INDEX workspaces_one_default_per_user_idx
+  ON workspaces (user_id)
+  WHERE is_default = true;
+
+CREATE TABLE memory_items (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+
+  user_id UUID NOT NULL REFERENCES users(id),
+  workspace_id UUID NOT NULL REFERENCES workspaces(id),
+  session_id TEXT,
+
+  type memory_item_type NOT NULL,
+  namespace TEXT NOT NULL DEFAULT 'default',
+  status memory_item_status NOT NULL DEFAULT 'active',
+  source memory_item_source NOT NULL DEFAULT 'agent',
+
+  title TEXT,
+  content TEXT NOT NULL,
+  content_format TEXT NOT NULL DEFAULT 'markdown',
+  metadata JSONB NOT NULL DEFAULT '{}'::jsonb,
+  tags TEXT[] NOT NULL DEFAULT '{}',
+
+  importance SMALLINT NOT NULL DEFAULT 50 CHECK (importance >= 0 AND importance <= 100),
+  confidence SMALLINT NOT NULL DEFAULT 80 CHECK (confidence >= 0 AND confidence <= 100),
+
+  valid_from TIMESTAMPTZ,
+  valid_until TIMESTAMPTZ,
+  expires_at TIMESTAMPTZ,
+  deleted_at TIMESTAMPTZ,
+
+  created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+  last_accessed_at TIMESTAMPTZ,
+
+  created_by TEXT,
+  updated_by TEXT,
+
+  version INTEGER NOT NULL DEFAULT 1,
+  supersedes_id UUID REFERENCES memory_items(id),
+  canonical_key TEXT,
+
+  search_vector TSVECTOR GENERATED ALWAYS AS (
+    setweight(to_tsvector('simple', coalesce(title, '')), 'A') ||
+    setweight(to_tsvector('simple', content), 'B')
+  ) STORED,
+
+  CHECK (content_format IN ('markdown', 'json', 'plain'))
+);
+
+CREATE INDEX memory_items_user_status_type_idx
+  ON memory_items (user_id, workspace_id, status, type, namespace);
+
+CREATE INDEX memory_items_user_importance_recency_idx
+  ON memory_items (user_id, workspace_id, status, importance DESC, updated_at DESC);
+
+CREATE INDEX memory_items_workspace_idx
+  ON memory_items (workspace_id);
+
+CREATE INDEX memory_items_tags_idx
+  ON memory_items USING GIN (tags);
+
+CREATE INDEX memory_items_metadata_idx
+  ON memory_items USING GIN (metadata);
+
+CREATE INDEX memory_items_search_idx
+  ON memory_items USING GIN (search_vector);
+
+CREATE UNIQUE INDEX memory_items_canonical_active_idx
+  ON memory_items (user_id, workspace_id, namespace, type, canonical_key)
+  WHERE status = 'active' AND canonical_key IS NOT NULL;
+
+CREATE TABLE memory_events (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+
+  user_id UUID NOT NULL REFERENCES users(id),
+  workspace_id UUID NOT NULL REFERENCES workspaces(id),
+  session_id TEXT,
+
+  event_type memory_event_type NOT NULL,
+  content TEXT NOT NULL,
+  metadata JSONB NOT NULL DEFAULT '{}'::jsonb,
+  tags TEXT[] NOT NULL DEFAULT '{}',
+
+  created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+  created_by TEXT,
+
+  related_item_ids UUID[] NOT NULL DEFAULT '{}'
+);
+
+CREATE INDEX memory_events_user_time_idx
+  ON memory_events (user_id, created_at DESC);
+
+CREATE INDEX memory_events_workspace_time_idx
+  ON memory_events (workspace_id, created_at DESC);
+
+CREATE INDEX memory_events_tags_idx
+  ON memory_events USING GIN (tags);
+
+CREATE TABLE memory_item_links (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  user_id UUID NOT NULL REFERENCES users(id),
+
+  from_item_id UUID NOT NULL REFERENCES memory_items(id) ON DELETE CASCADE,
+  to_item_id UUID NOT NULL REFERENCES memory_items(id) ON DELETE CASCADE,
+  relation TEXT NOT NULL,
+
+  metadata JSONB NOT NULL DEFAULT '{}'::jsonb,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+
+  UNIQUE (from_item_id, to_item_id, relation)
+);
+
+CREATE TABLE memory_audit_log (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+
+  user_id UUID NOT NULL REFERENCES users(id),
+  item_id UUID REFERENCES memory_items(id) ON DELETE SET NULL,
+  event_id UUID REFERENCES memory_events(id) ON DELETE SET NULL,
+
+  operation TEXT NOT NULL,
+  before JSONB,
+  after JSONB,
+
+  actor TEXT,
+  reason TEXT,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+
+CREATE INDEX memory_audit_log_user_time_idx
+  ON memory_audit_log (user_id, created_at DESC);
+
+-- Track one-time imports from workspace files (e.g. MEMORY.md, memory/*.md) so imports are idempotent.
+CREATE TABLE memory_import_files (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+
+  user_id UUID NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  workspace_id UUID NOT NULL REFERENCES workspaces(id) ON DELETE CASCADE,
+
+  rel_path TEXT NOT NULL,
+  sha256 TEXT NOT NULL,
+  imported_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+
+  source_type TEXT NOT NULL, -- e.g. 'root-memory' | 'daily-memory'
+  metadata JSONB NOT NULL DEFAULT '{}'::jsonb,
+
+  UNIQUE (user_id, workspace_id, rel_path, sha256)
+);
+
+CREATE INDEX memory_import_files_scope_time_idx
+  ON memory_import_files (user_id, workspace_id, imported_at DESC);

package/migrations/0002_session_index.sql

@@ -0,0 +1,71 @@
+-- AnchorClaw: sessions index (phase 1 lexical)
+
+CREATE TABLE session_index_files (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+
+  user_id UUID NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  workspace_id UUID NOT NULL REFERENCES workspaces(id) ON DELETE CASCADE,
+
+  -- Stored for filtering/debug; identity key is path+scope.
+  agent_id TEXT NOT NULL,
+  path TEXT NOT NULL,
+  abs_path TEXT NOT NULL,
+
+  hash TEXT NOT NULL,
+  mtime_ms DOUBLE PRECISION NOT NULL,
+  size_bytes BIGINT NOT NULL,
+
+  line_count INTEGER NOT NULL DEFAULT 0,
+  indexed_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+
+  metadata JSONB NOT NULL DEFAULT '{}'::jsonb,
+
+  UNIQUE (user_id, workspace_id, path)
+);
+
+CREATE INDEX session_index_files_scope_idx
+  ON session_index_files (user_id, workspace_id, updated_at DESC);
+
+CREATE INDEX session_index_files_agent_idx
+  ON session_index_files (user_id, workspace_id, agent_id, updated_at DESC);
+
+CREATE INDEX session_index_files_path_idx
+  ON session_index_files (user_id, workspace_id, path);
+
+CREATE TABLE session_index_chunks (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+
+  user_id UUID NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  workspace_id UUID NOT NULL REFERENCES workspaces(id) ON DELETE CASCADE,
+  file_id UUID NOT NULL REFERENCES session_index_files(id) ON DELETE CASCADE,
+
+  agent_id TEXT NOT NULL,
+  path TEXT NOT NULL,
+
+  chunk_index INTEGER NOT NULL,
+  start_line INTEGER NOT NULL,
+  end_line INTEGER NOT NULL,
+  text TEXT NOT NULL,
+
+  message_timestamps_ms BIGINT[] NOT NULL DEFAULT '{}',
+  metadata JSONB NOT NULL DEFAULT '{}'::jsonb,
+
+  search_vector TSVECTOR GENERATED ALWAYS AS (
+    setweight(to_tsvector('simple', coalesce(path, '')), 'A') ||
+    setweight(to_tsvector('simple', text), 'B')
+  ) STORED,
+
+  created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+
+  UNIQUE (file_id, chunk_index)
+);
+
+CREATE INDEX session_index_chunks_scope_idx
+  ON session_index_chunks (user_id, workspace_id, path);
+
+CREATE INDEX session_index_chunks_agent_idx
+  ON session_index_chunks (user_id, workspace_id, agent_id, path);
+
+CREATE INDEX session_index_chunks_search_idx
+  ON session_index_chunks USING GIN (search_vector);

package/openclaw.plugin.json

@@ -0,0 +1,314 @@
+{
+  "id": "anchorclaw",
+  "activation": {
+    "onStartup": false
+  },
+  "kind": "memory",
+  "contracts": {
+    "tools": ["memory_forget", "memory_recall", "memory_store", "memory_search", "memory_get", "memory_status"]
+  },
+  "uiHints": {
+    "sessions": {
+      "label": "Sessions",
+      "help": "Sessions corpus indexing and visibility settings",
+      "advanced": true
+    },
+    "sessions.visibility": {
+      "label": "Sessions Visibility",
+      "placeholder": "current",
+      "help": "Visibility scope for sessions corpus: current (default), off, or visible (requires visibility guard support).",
+      "advanced": true
+    },
+    "sessions.sync": {
+      "label": "Sessions Delta Sync",
+      "help": "Thresholds controlling when transcript updates trigger sessions index sync.",
+      "advanced": true
+    },
+    "sessions.sync.deltaBytes": {
+      "label": "Delta Bytes",
+      "placeholder": "100000",
+      "help": "Minimum appended bytes before reindexing sessions transcripts.",
+      "advanced": true
+    },
+    "sessions.sync.deltaMessages": {
+      "label": "Delta Messages",
+      "placeholder": "50",
+      "help": "Minimum appended message records before reindexing sessions transcripts.",
+      "advanced": true
+    },
+    "import": {
+      "label": "Import",
+      "help": "Migration behavior when legacy memory files exist",
+      "advanced": true
+    },
+    "import.cleanupMemoryMdAfterImport": {
+      "label": "Cleanup MEMORY.md After Import",
+      "help": "When true (default), after importing legacy MEMORY.md into Postgres AnchorClaw writes a backup into .openclaw-repair/anchorclaw/ and stubs MEMORY.md to avoid duplicate prompt injection.",
+      "advanced": true
+    },
+    "identity": {
+      "label": "Identity",
+      "help": "Stable owner identity for memory scoping",
+      "advanced": true
+    },
+    "identity.externalId": {
+      "label": "External Identity",
+      "placeholder": "family-main-01",
+      "help": "Stable identity key (max 20 chars). Recommended for Docker/production to avoid memory scope drift.",
+      "advanced": true
+    },
+    "postgres": {
+      "label": "Postgres",
+      "help": "Postgres connection settings for AnchorClaw memory storage"
+    },
+    "postgres.host": {
+      "label": "Host",
+      "placeholder": "localhost",
+      "help": "Postgres host"
+    },
+    "postgres.port": {
+      "label": "Port",
+      "placeholder": "5432",
+      "help": "Postgres port"
+    },
+    "postgres.database": {
+      "label": "Database",
+      "placeholder": "anchorclaw",
+      "help": "Postgres database name"
+    },
+    "postgres.schema": {
+      "label": "Schema",
+      "placeholder": "memory",
+      "help": "Optional Postgres schema for AnchorClaw tables (recommended to avoid polluting public)",
+      "advanced": true
+    },
+    "postgres.user": {
+      "label": "User",
+      "placeholder": "postgres",
+      "help": "Postgres user"
+    },
+    "postgres.password": {
+      "label": "Password",
+      "sensitive": true,
+      "placeholder": "${ANCHORCLAW_DB_PASSWORD}",
+      "help": "Postgres password; supports ${ENV_VAR} values"
+    },
+    "postgres.ssl": {
+      "label": "SSL",
+      "help": "Enable SSL for Postgres connection",
+      "advanced": true
+    },
+    "postgres.sslMode": {
+      "label": "SSL Mode",
+      "placeholder": "verify-full",
+      "help": "SSL mode: disable, require (no cert verification), or verify-full (verify server certificate)",
+      "advanced": true
+    },
+    "postgres.sslCa": {
+      "label": "SSL CA",
+      "placeholder": "${ANCHORCLAW_DB_SSL_CA_PEM}",
+      "help": "Optional CA PEM bundle for verify-full; supports ${ENV_VAR} values",
+      "advanced": true
+    },
+    "postgres.pool": {
+      "label": "Pool",
+      "help": "Connection pool settings",
+      "advanced": true
+    },
+    "postgres.pool.max": {
+      "label": "Max Connections",
+      "placeholder": "10",
+      "help": "Maximum number of connections in the pool",
+      "advanced": true
+    },
+    "postgres.pool.connectionTimeoutMs": {
+      "label": "Connect Timeout (ms)",
+      "placeholder": "5000",
+      "help": "Time to wait for a connection before failing",
+      "advanced": true
+    },
+    "postgres.pool.idleTimeoutMs": {
+      "label": "Idle Timeout (ms)",
+      "placeholder": "30000",
+      "help": "Time before an idle connection is closed",
+      "advanced": true
+    },
+    "limits": {
+      "label": "Limits",
+      "help": "Safety limits for memory tools",
+      "advanced": true
+    },
+    "limits.maxResults": {
+      "label": "Max Results",
+      "placeholder": "10",
+      "help": "Maximum search results to return (cap: 10)",
+      "advanced": true
+    },
+    "limits.getMaxChars": {
+      "label": "Get Max Chars",
+      "placeholder": "12000",
+      "help": "Maximum characters returned by memory_get (cap: 12000)",
+      "advanced": true
+    },
+    "limits.getDefaultLines": {
+      "label": "Get Default Lines",
+      "placeholder": "120",
+      "help": "Default lineCount for memory_get when omitted (cap: 120)",
+      "advanced": true
+    }
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "sessions": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "visibility": {
+            "type": "string",
+            "enum": ["current", "off", "visible"],
+            "default": "current"
+          },
+          "sync": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "deltaBytes": {
+                "type": "number",
+                "default": 100000,
+                "minimum": 0
+              },
+              "deltaMessages": {
+                "type": "number",
+                "default": 50,
+                "minimum": 0
+              }
+            }
+          }
+        }
+      },
+      "import": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "cleanupMemoryMdAfterImport": {
+            "type": "boolean",
+            "default": true
+          }
+        }
+      },
+      "identity": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "externalId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 20
+          }
+        }
+      },
+      "postgres": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "host": {
+            "type": "string",
+            "minLength": 1
+          },
+          "port": {
+            "oneOf": [
+              {
+                "type": "number",
+                "default": 5432,
+                "minimum": 1,
+                "maximum": 65535
+              },
+              {
+                "type": "string",
+                "default": "5432",
+                "minLength": 1
+              }
+            ]
+          },
+          "database": {
+            "type": "string",
+            "minLength": 1
+          },
+          "schema": {
+            "type": "string",
+            "minLength": 1
+          },
+          "user": {
+            "type": "string",
+            "minLength": 1
+          },
+          "password": {
+            "type": "string"
+          },
+          "ssl": {
+            "type": "boolean"
+          },
+          "sslMode": {
+            "type": "string",
+            "enum": ["disable", "require", "verify-full"]
+          },
+          "sslCa": {
+            "type": "string"
+          },
+          "pool": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "max": {
+                "type": "number",
+                "default": 10,
+                "minimum": 1,
+                "maximum": 100
+              },
+              "connectionTimeoutMs": {
+                "type": "number",
+                "default": 5000,
+                "minimum": 100,
+                "maximum": 600000
+              },
+              "idleTimeoutMs": {
+                "type": "number",
+                "default": 30000,
+                "minimum": 100,
+                "maximum": 3600000
+              }
+            }
+          }
+        },
+        "required": ["host", "database", "user"]
+      },
+      "limits": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "maxResults": {
+            "type": "number",
+            "default": 10,
+            "minimum": 1,
+            "maximum": 10
+          },
+          "getMaxChars": {
+            "type": "number",
+            "default": 12000,
+            "minimum": 1000,
+            "maximum": 12000
+          },
+          "getDefaultLines": {
+            "type": "number",
+            "default": 120,
+            "minimum": 10,
+            "maximum": 120
+          }
+        }
+      }
+    },
+    "required": []
+  }
+}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@alexandrgreen/anchorclaw",
+  "version": "0.0.3",
+  "description": "OpenClaw Postgres-backed long-term memory plugin",
+  "author": "Alexander Green",
+  "license": "MIT",
+  "homepage": "https://github.com/Alexander-Green/anchorClaw#readme",
+  "bugs": {
+    "url": "https://github.com/Alexander-Green/anchorClaw/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Alexander-Green/anchorClaw"
+  },
+  "type": "module",
+  "files": [
+    "dist/",
+    "migrations/",
+    "openclaw.plugin.json",
+    "NOTICE",
+    "README.md",
+    "package.json"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "pg": "^8.16.0"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.5.7"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.3",
+    "@types/pg": "^8.15.4",
+    "openclaw": "2026.5.7",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4"
+  },
+  "openclaw": {
+    "extensions": ["./src/index.ts"],
+    "runtimeExtensions": ["./dist/index.js"],
+    "install": {
+      "npmSpec": "@alexandrgreen/anchorclaw",
+      "defaultChoice": "npm",
+      "minHostVersion": ">=2026.5.7"
+    },
+    "compat": {
+      "pluginApi": ">=2026.5.7"
+    },
+    "release": {
+      "publishToClawHub": true,
+      "publishToNpm": true
+    }
+  }
+}