suemo 0.1.2 → 0.1.4

package/README.md

@@ -42,6 +42,8 @@ SURREAL_DATASTORE_VERSIONED=true SURREAL_DATASTORE_RETENTION=90d surreal start \
   -- surrealkv:///path/to/data
 ```
 
+Note: It is advised to create database-level admin specifically for suemo.
+
 For suemo, the critical capability is allowing custom functions:
 
 - `fn::*`
@@ -50,6 +52,7 @@ For suemo, the critical capability is allowing custom functions:
 - `search::*` (for `search::score`)
 - `math::*` (for `math::mean`, `math::min`)
 - `rand::*` (used in `wander` query)
+- `array::*` (used in `recall` query)
 
 If you run with strict capability mode, use an allowlist like:
 
@@ -110,7 +113,7 @@ If `suemo` is not on root PATH, use `sudo bunx suemo ...`.
 
 Drop `--dry-run` to apply changes.
 
-`suemo init surreal` also creates `/opt/suemo/surrealdb/local.env` with commented overrides and does not overwrite it if it already exists. If defined in `local.env`, these values override `common.env`:
+`suemo init surreal` also creates `/opt/suemo/surreal/local.env` with commented overrides and does not overwrite it if it already exists. If defined in `local.env`, these values override `common.env`:
 
 - `SURREAL_USER`
 - `SURREAL_PASS`
@@ -123,10 +126,10 @@ What these commands do:
 
 - `suemo init surreal <2gb|6gb>`
   - checks `surrealdb` package via `pacman -Q`
-  - creates `/opt/suemo/surrealdb/common.env` + profile env (`2gb.env` or `6gb.env`)
-  - creates `/opt/suemo/surrealdb/local.env` once (user override file; not overwritten)
-  - writes `/etc/systemd/system/suemo-surrealdb@.service`
-  - enables + starts `suemo-surrealdb@<profile>.service`
+  - creates `/opt/suemo/surreal/common.env` + profile env (`2gb.env` or `6gb.env`)
+  - creates `/opt/suemo/surreal/local.env` once (user override file; not overwritten)
+  - writes `/etc/systemd/system/suemo-surreal@.service`
+  - enables + starts `suemo-surreal@<profile>.service`
   - includes `VERSIONED` + retention config and strict capability allowlist:
     - `SURREAL_DATASTORE_VERSIONED=true`
     - `SURREAL_DATASTORE_RETENTION=90d`
@@ -136,7 +139,7 @@ What these commands do:
 - `suemo init fastembed`
   - checks `python-fastembed`, `python-fastapi`, `python-uvicorn` via `pacman -Q`
   - installs `data/fastembed-server.py` to `/opt/suemo/fastembed-server.py`
-  - creates `/opt/fastembed/local.env` once (user override file; not overwritten)
+  - creates `/opt/suemo/fastembed/local.env` once (user override file; not overwritten)
   - writes `/etc/systemd/system/suemo-fastembed.service`
   - enables + starts `suemo-fastembed.service`
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "suemo",
-	"version": "0.1.2",
+	"version": "0.1.4",
 	"description": "Persistent semantic memory for AI agents — backed by SurrealDB.",
 	"author": {
 		"name": "Umar Alfarouk",

package/skills/suemo/SKILL.md

@@ -1,7 +1,9 @@
 ---
 name: suemo
 description: OpenCode-focused persistent memory workflow for suemo with CLI/MCP parity and versioned references.
-version: 0.1.2
+license: GPL-3.0-only
+compatibility: opencode
+version: 0.1.4
 ---
 
 # suemo skill

package/skills/suemo/references/agents-snippet.md

@@ -1,7 +1,7 @@
 ---
 name: agents-snippet
 description: AGENTS.md snippet optimized for suemo skill discovery and usage.
-version: 0.1.2
+version: 0.1.4
 ---
 
 # AGENTS.md snippet

package/skills/suemo/references/cli-reference.md

@@ -1,7 +1,7 @@
 ---
 name: cli-reference
 description: CLI command reference for suemo v0.0.6 including skill access.
-version: 0.1.2
+version: 0.1.4
 ---
 
 # CLI reference

package/skills/suemo/references/core-workflow.md

@@ -1,7 +1,7 @@
 ---
 name: core-workflow
 description: Canonical suemo operating loop for OpenCode agents.
-version: 0.1.2
+version: 0.1.4
 ---
 
 # Core workflow

package/skills/suemo/references/manual-test-plan.md

@@ -1,7 +1,7 @@
 ---
 name: manual-test-plan
 description: Comprehensive manual test matrix for suemo features and commands.
-version: 0.1.2
+version: 0.1.4
 ---
 
 # Manual test plan

package/skills/suemo/references/mcp-reference.md

@@ -1,7 +1,7 @@
 ---
 name: mcp-reference
 description: MCP tool reference for suemo v0.0.6.
-version: 0.1.2
+version: 0.1.4
 ---
 
 # MCP tools

package/skills/suemo/references/schema-retention-longevity.md

@@ -1,7 +1,7 @@
 ---
 name: schema-retention-longevity
 description: Long-term schema and retention design expectations for suemo.
-version: 0.1.2
+version: 0.1.4
 ---
 
 # Schema + retention longevity

package/skills/suemo/references/sync-local-vps.md

@@ -1,7 +1,7 @@
 ---
 name: sync-local-vps
 description: Two-way sync manual scenario for local and VPS SurrealDB.
-version: 0.1.2
+version: 0.1.4
 ---
 
 # Local ↔ VPS sync scenario

package/src/cli/commands/init.ts

@@ -29,12 +29,12 @@ const log = getLogger(['suemo', 'cli', 'init'])
 const init = app.sub('init')
 	.meta({ description: 'Initialize suemo config and/or database schema' })
 
-const SURREAL_PROFILES_DIR = '/opt/suemo/surrealdb'
-const SURREAL_LOCAL_ENV_PATH = '/opt/suemo/surrealdb/local.env'
-const SURREAL_SYSTEMD_UNIT_PATH = '/etc/systemd/system/suemo-surrealdb@.service'
+const SURREAL_PROFILES_DIR = '/opt/suemo/surreal'
+const SURREAL_LOCAL_ENV_PATH = '/opt/suemo/surreal/local.env'
+const SURREAL_SYSTEMD_UNIT_PATH = '/etc/systemd/system/suemo-surreal@.service'
 const SURREAL_DATA_DIR = '/var/lib/surrealdb'
 const FASTEMBED_INSTALL_DIR = '/opt/suemo'
-const FASTEMBED_LOCAL_ENV_DIR = '/opt/fastembed'
+const FASTEMBED_LOCAL_ENV_DIR = '/opt/suemo/fastembed'
 const FASTEMBED_SCRIPT_TARGET = '/opt/suemo/fastembed-server.py'
 const FASTEMBED_CACHE_DIR = '/var/cache/fastembed'
 const FASTEMBED_SERVICE_PATH = '/etc/systemd/system/suemo-fastembed.service'
@@ -52,9 +52,9 @@ Type=simple
 AmbientCapabilities=CAP_NET_BIND_SERVICE
 User=surrealdb
 Group=surrealdb
-EnvironmentFile=/opt/suemo/surrealdb/common.env
-EnvironmentFile=/opt/suemo/surrealdb/%i.env
-EnvironmentFile=-/opt/suemo/surrealdb/local.env
+EnvironmentFile=/opt/suemo/surreal/common.env
+EnvironmentFile=/opt/suemo/surreal/%i.env
+EnvironmentFile=-/opt/suemo/surreal/local.env
 ExecStart=/usr/bin/surreal start
 ExecStop=/bin/kill -s SIGTERM $MAINPID
 Restart=on-failure
@@ -77,7 +77,7 @@ StateDirectoryMode=0750
 WorkingDirectory=/var/lib/surrealdb
 StandardOutput=journal
 StandardError=journal
-SyslogIdentifier=suemo-surrealdb-%i
+SyslogIdentifier=suemo-surreal-%i
 
 [Install]
 WantedBy=multi-user.target
@@ -118,7 +118,7 @@ SURREAL_TRANSACTION_TIMEOUT=15s
 
 # Capability allowlist (required for suemo workflows)
 SURREAL_CAPS_DENY_ALL=true
-SURREAL_CAPS_ALLOW_FUNC=fn,time,vector,search,math,rand,ml
+SURREAL_CAPS_ALLOW_FUNC=fn,time,vector,search,math,rand,ml,array
 
 # Logging
 SURREAL_LOG=warn
@@ -165,7 +165,7 @@ SURREAL_EXTERNAL_SORTING_BUFFER_LIMIT=25000
 SURREAL_MEMORY_THRESHOLD=512m
 `
 
-const FASTEMBED_LOCAL_ENV_PATH = '/opt/fastembed/local.env'
+const FASTEMBED_LOCAL_ENV_PATH = '/opt/suemo/fastembed/local.env'
 
 const FASTEMBED_LOCAL_ENV_TEMPLATE = `# User overrides - edit this file to customize settings
 # This file is NOT overwritten by suemo init fastembed
@@ -192,7 +192,7 @@ Environment=FASTEMBED_HOST=127.0.0.1
 Environment=FASTEMBED_PORT=8080
 Environment=FASTEMBED_MODEL=sentence-transformers/all-MiniLM-L6-v2
 Environment=FASTEMBED_CACHE_DIR=/var/cache/fastembed
-EnvironmentFile=-/opt/fastembed/local.env
+EnvironmentFile=-/opt/suemo/fastembed/local.env
 ExecStart=/usr/bin/python /opt/suemo/fastembed-server.py
 Restart=on-failure
 RestartSec=5s
@@ -200,7 +200,7 @@ NoNewPrivileges=true
 PrivateTmp=true
 ProtectSystem=strict
 ProtectHome=true
-ReadWritePaths=/var/cache/fastembed
+ReadWritePaths=/var/cache/fastembed /var/lib/fastembed
 StandardOutput=journal
 StandardError=journal
 SyslogIdentifier=suemo-fastembed
@@ -484,7 +484,7 @@ function buildSurrealActions(
 		{
 			kind: 'run',
 			command: 'systemctl',
-			args: ['enable', '--now', `suemo-surrealdb@${profile}.service`],
+			args: ['enable', '--now', `suemo-surreal@${profile}.service`],
 			requireRoot: true,
 		},
 	)
@@ -542,9 +542,9 @@ function printInitSystemSummary(kind: 'surreal' | 'fastembed', dryRun: boolean,
 			console.log('✓ SurrealDB setup complete.')
 		}
 		if (profile) {
-			console.log(`Service: suemo-surrealdb@${profile}.service`)
-			console.log(`Status: systemctl status suemo-surrealdb@${profile}.service`)
-			console.log(`Logs: journalctl -u suemo-surrealdb@${profile}.service -f`)
+			console.log(`Service: suemo-surreal@${profile}.service`)
+			console.log(`Status: systemctl status suemo-surreal@${profile}.service`)
+			console.log(`Logs: journalctl -u suemo-surreal@${profile}.service -f`)
 		}
 		return
 	}
@@ -849,7 +849,7 @@ const initSurrealCmd = init.sub('surreal')
 				ok: true,
 				dryRun: false,
 				profile,
-				service: `suemo-surrealdb@${profile}.service`,
+				service: `suemo-surreal@${profile}.service`,
 				credentialStatus: result.credentialStatus,
 			}, flags)
 			return

package/src/skill/catalog.ts

@@ -1,13 +1,9 @@
 import { readdirSync, readFileSync } from 'node:fs'
-import { basename, dirname } from 'node:path'
-import { fileURLToPath } from 'node:url'
+import { basename, join } from 'node:path'
 
-const PROJECT_ROOT = dirname(
-	fileURLToPath(import.meta.resolve('@/package.json')),
-)
-
-const SKILL_FILE_PATH = `${PROJECT_ROOT}/skills/suemo/SKILL.md`
-const SKILL_REFERENCES_DIR = `${PROJECT_ROOT}/skills/suemo/references/`
+const PROJECT_ROOT = new URL('.', import.meta.resolve('@/package.json')).pathname
+const SKILL_FILE_PATH = join(PROJECT_ROOT, 'skills/suemo/SKILL.md')
+const SKILL_REFERENCES_DIR = join(PROJECT_ROOT, 'skills/suemo/references/')
 
 export function skillFilePath(): string {
 	return SKILL_FILE_PATH
@@ -29,7 +25,7 @@ export function skillReferencePath(reference: string): string | null {
 	if (!cleaned) return null
 	const available = new Set(listSkillReferences())
 	if (!available.has(cleaned)) return null
-	return `${PROJECT_ROOT}/skills/suemo/references/${cleaned}.md`
+	return join(PROJECT_ROOT, `/skills/suemo/references/${cleaned}.md`)
 }
 
 export function readSkillReference(reference: string): { name: string; path: string; content: string } | null {