Aarondb

Distributed Datalog engine for sovereign agents enabling persistent, immutable fact storage, querying, and reasoning with built-in synchronization and time-t...

Security Scan

The skill's instructions, purpose, and required surface area are internally consistent: it's an instruction-only wrapper describing a local/distributed Datalog library and asks the agent/user to install and use the @criticalinsight/aarondb-edge npm package.

Purpose & Capability

Name and description (distributed Datalog engine for sovereign agents) match the SKILL.md content which documents initialization, transacting facts, querying, and optional sync modes.

Instruction Scope

SKILL.md stays on-topic: it describes installing the library and example usage (db initialization, transact, query). It does not instruct reading unrelated files, accessing arbitrary env vars, or exfiltrating data.

Install Mechanism

The registry provides no formal install spec, but SKILL.md instructs users to run `npm install @criticalinsight/aarondb-edge`. This is expected for a JS library but you should review the npm package/repository before installing.

Credentials

The skill declares no required env vars or credentials. However SKILL.md mentions optional synchronization via a shared D1/KV back-end (Cloudflare Worker mode), which in practice may require credentials or network access at runtime — these are not declared here.

Persistence & Privilege

always is false and the skill is instruction-only with no install actions recorded by the registry; it does not request persistent platform privileges.

Assessment

This is an instruction-only skill that documents using the @criticalinsight/aarondb-edge npm library — the skill itself requests no credentials or system access. Before installing the npm package, review the package source (GitHub repo and npm page), check the package version and maintainers, and scan the package for network calls or unexpected permissions. Also be aware that enabling cloud synchronization (Cloudflare D1/KV) may require runtime credentials or expose data to a backend, so verify how synchronization is configured and authorized before enabling it.

AaronDB Edge Skill

A high-performance, distributed Datalog engine designed for sovereign agents.

Frontmatter

name: aarondb-edge
description: Distributed Datalog engine for sovereign agents. Enables persistent fact management and reasoning.
version: 1.1.0
author: criticalinsight
repository: https://github.com/criticalinsight/aarondb-edge
npm: https://www.npmjs.com/package/@criticalinsight/aarondb-edge
requirements:
  - "@criticalinsight/aarondb-edge"

Description

This skill enables AI agents to utilize a local or distributed Datalog engine for fact storage, retrieval, and reasoning. It follows the "Database as a Value" philosophy, allowing for immutable state management and time-travel debugging.

Installation

To use this skill, ensure the core package is installed in your agent's runtime:

npm install @criticalinsight/aarondb-edge

Usage

1. Initialization

import { AaronDB } from '@criticalinsight/aarondb-edge';

// Initialize a new database instance
const db = new AaronDB();

2. Transacting Facts

Facts are stored as "datoms" (Entity, Attribute, Value).

await db.transact([
  { e: "agent/philosophy", a: "type", v: "RichHickey" },
  { e: "agent/philosophy", a: "principle", v: "Simplicity" }
]);

3. Querying

Use Datalog syntax with variable bindings.

const results = db.query({
  where: [
    ["?e", "type", "RichHickey"],
    ["?e", "principle", "?p"]
  ]
});

Architectural Patterns

• Database as a Value: Always treat the database state as an immutable value. Avoid manual state mutations outside of the transact flow.
• Shared Discovery Layer: Facts can be synchronized across agents using a shared D1/KV back-end when running in Cloudflare Worker mode. In library mode, the state is local-first but can be exported/imported as a unified fact log for cross-agent collaboration.