Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
Python agent-contextagent-memoryagent-pluginsagentic-ragcontext-databasedsh-pluginknowledge-basememorymemory-managementself-evolvingvector-database
import { execFileSync } from "node:child_process";
import { mkdtempSync, readFileSync, writeFileSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { describe, expect, it } from "vitest";
const rootDir = join(__dirname, "../..");
function readText(path: string): string {
return readFileSync(join(rootDir, path), "utf8");
}
function resolveReleaseVersion(args: string[]): { version: string; tag: string; channel: string } {
return JSON.parse(execFileSync("node", [join(rootDir, "scripts/resolve-release-version.mjs"), ...args], {
encoding: "utf8",
}));
}
describe("TOS release and single installer contract", () => {
it("generates a release manifest and checksums for artifacts", () => {
const tempDir = mkdtempSync(join(tmpdir(), "openviking-manifest-"));
const packagePath = join(tempDir, "openviking.tgz");
const installerPath = join(tempDir, "install.sh");
const notesPath = join(tempDir, "release-notes.md");
const manifestPath = join(tempDir, "manifest.json");
const checksumsPath = join(tempDir, "checksums.sha256");
writeFileSync(packagePath, "package-content");
writeFileSync(installerPath, "#!/bin/sh\n");
writeFileSync(notesPath, "Release notes");
execFileSync("node", [
join(rootDir, "scripts/generate-release-manifest.mjs"),
"--env",
"prod",
"--version",
"2026.5.8",
"--tag",
"v2026.5.8",
"--git-hash",
"0123456789abcdef0123456789abcdef01234567",
"--artifact",
packagePath,
"--artifact",
installerPath,
"--notes",
notesPath,
"--out",
manifestPath,
"--checksums-out",
checksumsPath,
]);
const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
const checksums = readFileSync(checksumsPath, "utf8");
expect(manifest.schemaVersion).toBe("1.0");
expect(manifest.environment).toBe("prod");
expect(manifest.plugin.id).toBe("openviking");
expect(manifest.release.version).toBe("2026.5.8");
expect(manifest.release.tag).toBe("v2026.5.8");
expect(manifest.release.gitShortHash).toBe("0123456");
expect(manifest.tos.bucket).toBe("arkclaw-openviking");
expect(manifest.artifacts.map((artifact: { name: string }) => artifact.name)).toEqual([
"openviking.tgz",
"install.sh",
]);
expect(manifest.artifacts.every((artifact: { sha256: string; size: number }) => artifact.sha256.length === 64 && artifact.size > 0)).toBe(true);
expect(checksums).toContain("openviking.tgz");
expect(checksums).toContain("install.sh");
// The release manifest must derive its compatibility floors/recommended
// versions from install-manifest.json so the two manifests never diverge.
const installManifest = JSON.parse(readText("install-manifest.json"));
expect(manifest.compatibility).toMatchObject({
minOpenclawVersion: installManifest.compatibility.minOpenclawVersion,
recommendedOpenclawVersion: installManifest.compatibility.recommendedOpenclawVersion,
minOpenvikingVersion: installManifest.compatibility.minOpenvikingVersion,
recommendedOpenvikingVersion: installManifest.compatibility.recommendedOpenvikingVersion,
});
expect(manifest.compatibility.minGatewayVersion).toBe(installManifest.compatibility.minOpenclawVersion);
expect(manifest.compatibility.minNodeVersion).toBe("22.0.0");
});
it("generates environment-specific manifest metadata for non-prod releases", () => {
const tempDir = mkdtempSync(join(tmpdir(), "openviking-manifest-stg-"));
const packagePath = join(tempDir, "openviking.tgz");
const installerPath = join(tempDir, "install.sh");
const manifestPath = join(tempDir, "manifest.json");
const checksumsPath = join(tempDir, "checksums.sha256");
writeFileSync(packagePath, "package-content");
writeFileSync(installerPath, "#!/bin/sh\n");
execFileSync("node", [
join(rootDir, "scripts/generate-release-manifest.mjs"),
"--env",
"stg",
"--version",
"2026.5.8",
"--tag",
"v2026.5.8-stg",
"--git-hash",
"0123456789abcdef0123456789abcdef01234567",
"--artifact",
packagePath,
"--artifact",
installerPath,
"--bucket",
"arkclaw-openviking-stg",
"--region",
"cn-shanghai",
"--endpoint",
"tos-cn-shanghai.volces.com",
"--out",
manifestPath,
"--checksums-out",
checksumsPath,
]);
const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
const installer = manifest.artifacts.find((artifact: { name: string }) => artifact.name === "install.sh");
expect(manifest.environment).toBe("stg");
expect(manifest.tos).toMatchObject({
bucket: "arkclaw-openviking-stg",
region: "cn-shanghai",
endpoint: "tos-cn-shanghai.volces.com",
});
expect(installer.defaultArgs.channel).toBe("stg");
});
it("defines release-to-tos dry-run and credential rules", () => {
const releaseScript = readText("scripts/release-to-tos.sh");
expect(releaseScript).toContain("set -euo pipefail");
expect(releaseScript).toContain("--release-dir <date>");
expect(releaseScript).toContain("Defaults to today's yyyy.m.d");
expect(releaseScript).toContain("today_release_dir");
expect(releaseScript).toContain("--publish-latest");
expect(releaseScript).toContain("BUILD_RELEASE_PATH=\"$RELEASE_DIR\" BUILD_VERSION=\"$VERSION\" bash \"$ROOT_DIR/build.sh\"");
expect(releaseScript).toContain("TEAM_TEST_AK");
expect(releaseScript).toContain("TEAM_TEST_SK");
expect(releaseScript).toContain("--dry-run");
expect(releaseScript).toContain("scripts/generate-release-manifest.mjs");
expect(releaseScript).toContain("bash \"$ROOT_DIR/build.sh\"");
expect(releaseScript).toContain("scripts/upload_tos.py");
expect(releaseScript).toContain("output/manifest.json");
expect(releaseScript).not.toContain("latest.json");
});
it("defaults release version to the next beta for the package base version", () => {
const tempDir = mkdtempSync(join(tmpdir(), "openviking-version-beta-"));
const packagePath = join(tempDir, "package.json");
writeFileSync(packagePath, JSON.stringify({ version: "2026.6.1" }));
const resolved = resolveReleaseVersion([
"--package",
packagePath,
"--existing-versions",
"2026.6.1-beta.1,2026.6.1-beta.2,2026.6.1",
]);
expect(resolved).toMatchObject({
version: "2026.6.1-beta.3",
tag: "v2026.6.1-beta.3",
channel: "beta",
});
});
it("resolves explicit stable releases to date-style versions without beta suffix", () => {
const tempDir = mkdtempSync(join(tmpdir(), "openviking-version-stable-"));
const packagePath = join(tempDir, "package.json");
writeFileSync(packagePath, JSON.stringify({ version: "2026.6.1-beta.7" }));
const resolved = resolveReleaseVersion(["--package", packagePath, "--stable"]);
expect(resolved).toMatchObject({
version: "2026.6.1",
tag: "v2026.6.1",
channel: "stable",
});
});
it("keeps explicitly requested release versions and derives their tag", () => {
const resolved = resolveReleaseVersion(["--version", "2026.6.1-beta.9"]);
expect(resolved).toMatchObject({
version: "2026.6.1-beta.9",
tag: "v2026.6.1-beta.9",
channel: "beta",
});
});
it("defines a TOS SDK release client for upload, verify, and latest update", () => {
const packageJson = JSON.parse(readText("package.json"));
const clientScript = readText("scripts/tos-release-client.mjs");
const uploader = readText("scripts/upload_tos.py");
expect(packageJson.dependencies["@volcengine/tos-sdk"]).toBeUndefined();
expect(packageJson.devDependencies["@volcengine/tos-sdk"]).toBeDefined();
expect(packageJson.overrides?.axios).toMatch(/^\^1\./);
expect(uploader).toContain("TosClientV2");
expect(uploader).toContain("put_object_from_file");
expect(uploader).toContain("put_object_acl");
expect(uploader).toContain("ensure_bucket");
expect(uploader).toContain("create_bucket");
expect(uploader).toContain("stamp_bucket_installer");
expect(uploader).toContain("stamp_bucket_manifest");
expect(uploader).toContain("hashlib.sha256");
expect(uploader).toContain("DEFAULT_TOS_BASE_URL=");
expect(uploader).toContain("upload_bucket_installer");
expect(uploader).toContain("default_release_dir");
expect(uploader).not.toContain('DEFAULT_RELEASE_DIR = "2026.6.3"');
expect(uploader).toContain("forbid_overwrite=False");
expect(uploader).toContain("--publish-latest");
expect(uploader).toContain("manifest.json");
expect(uploader).toContain("TEAM_TEST_AK");
expect(uploader).toContain("TEAM_TEST_SK");
expect(clientScript).toContain("Simplified TOS protocol");
expect(clientScript).toContain("scripts/release-to-tos.sh");
expect(clientScript).not.toContain("TOS_ACCESS_KEY");
expect(clientScript).not.toContain("TOS_SECRET_KEY");
});
it("keeps install.sh as the single global installer with default TOS latest", () => {
const installScript = readText("scripts/install.sh");
expect(installScript).toContain("requires bash");
expect(installScript).toContain("Usage: bash install.sh [options]");
expect(installScript).toContain("<tos-base-url>/latest/openviking.tgz");
expect(installScript).toContain("DEFAULT_TOS_BASE_URL=\"\"");
expect(installScript).toContain("INSTALL_TOS_BASE_URL=\"${INSTALL_TOS_BASE_URL:-$DEFAULT_TOS_BASE_URL}\"");
expect(installScript).toContain("RELEASE_PATH=\"${INSTALL_RELEASE_PATH:-latest}\"");
expect(installScript).toContain("--source tos|tarball|local|existing");
expect(installScript).toContain("--date <date>");
expect(installScript).toContain("--manifest-url <url>");
expect(installScript).toContain("--verify-only");
expect(installScript).toContain("openviking.env");
expect(installScript).toContain("openclaw openviking setup");
});
it("does not run OpenViking setup during verify-only mode", () => {
execFileSync("bash", [join(rootDir, "scripts/install.sh"), "--source", "existing", "--verify-only"], {
env: {
...process.env,
OPENVIKING_API_KEY: "test-secret-key",
OPENVIKING_BASE_URL: "",
},
});
});
it("keeps the Volcengine installer as a thin compatibility wrapper", () => {
const wrapper = readText("scripts/volcengine-openviking-install.sh");
expect(wrapper).toContain("Compatibility wrapper");
expect(wrapper).toContain("exec \"$SCRIPT_DIR/install.sh\"");
expect(wrapper).not.toContain("openclaw openviking setup");
expect(wrapper).not.toContain("openclaw plugins install clawhub:@openviking/openclaw-plugin");
});
});