agentvault 1.0.0

package/site/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "agentvault-site",
+  "version": "1.0.0",
+  "private": true,
+  "scripts": {
+    "docusaurus": "docusaurus",
+    "start": "docusaurus start",
+    "build": "docusaurus build",
+    "swizzle": "docusaurus swizzle",
+    "deploy": "docusaurus deploy",
+    "clear": "docusaurus clear",
+    "serve": "docusaurus serve",
+    "write-translations": "docusaurus write-translations",
+    "write-heading-ids": "docusaurus write-heading-ids",
+    "typecheck": "tsc"
+  },
+  "dependencies": {
+    "@docusaurus/core": "^3.9.2",
+    "@docusaurus/preset-classic": "^3.9.2",
+    "@mdx-js/react": "^3.0.0",
+    "clsx": "^2.0.0",
+    "prism-react-renderer": "^2.3.0",
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0"
+  },
+  "devDependencies": {
+    "@docusaurus/module-type-aliases": "^3.9.2",
+    "@docusaurus/tsconfig": "^3.9.2",
+    "@docusaurus/types": "^3.9.2",
+    "typescript": "~5.6.2"
+  },
+  "browserslist": {
+    "production": [
+      ">0.5%",
+      "not dead",
+      "not op_mini all"
+    ],
+    "development": [
+      "last 3 chrome version",
+      "last 3 firefox version",
+      "last 5 safari version"
+    ]
+  },
+  "engines": {
+    "node": ">=18.0"
+  }
+}

package/site/sidebars.ts

@@ -0,0 +1,86 @@
+import type {SidebarsConfig} from '@docusaurus/plugin-content-docs';
+
+const sidebars: SidebarsConfig = {
+  docsSidebar: [
+    {
+      type: 'doc',
+      id: 'index',
+      label: 'Introduction',
+    },
+    {
+      type: 'category',
+      label: 'Core Hierarchy',
+      items: [
+        'getting-started/installation',
+        'getting-started/quick-start',
+        'getting-started/configuration',
+      ],
+    },
+    {
+      type: 'category',
+      label: 'Sovereign Operations',
+      items: [
+        'user/tutorial-v1.0',
+        'user/deployment',
+        'user/wallets',
+        'user/backups',
+        'user/webapp',
+        'user/troubleshooting',
+        'user/clawdbot-claude-skill',
+      ],
+    },
+    {
+      type: 'category',
+      label: 'Command Protocols',
+      items: [
+        'cli/reference',
+        'cli/options',
+      ],
+    },
+    {
+      type: 'category',
+      label: 'Guardian Layer',
+      items: [
+        'security/overview',
+        'security/best-practices',
+      ],
+    },
+    {
+      type: 'category',
+      label: 'System Cartography',
+      items: [
+        'architecture/overview',
+        'architecture/modules',
+        'architecture/canister',
+      ],
+    },
+    {
+      type: 'category',
+      label: 'Builder Notes',
+      items: [
+        'development/contributing',
+        'development/testing',
+      ],
+    },
+    {
+      type: 'category',
+      label: 'Advanced Rituals',
+      items: [
+        'guides/monitoring',
+        'guides/advanced/promotion',
+        'guides/advanced/rollback',
+      ],
+    },
+    {
+      type: 'category',
+      label: 'Archive',
+      items: [
+        'dev/SECURITY_AUDIT',
+        'marketing/release-notes',
+        'PRD',
+      ],
+    },
+  ],
+};
+
+export default sidebars;

package/site/static/img/logo.svg

@@ -0,0 +1,28 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" role="img" aria-labelledby="title desc">
+  <title id="title">Agent Vault Logo</title>
+  <desc id="desc">Neon framed AV monogram</desc>
+  <defs>
+    <linearGradient id="ring" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#22d3ee" />
+      <stop offset="52%" stop-color="#8b5cf6" />
+      <stop offset="100%" stop-color="#ec4899" />
+    </linearGradient>
+    <filter id="glow" x="-50%" y="-50%" width="200%" height="200%">
+      <feGaussianBlur stdDeviation="2.6" result="blur" />
+      <feMerge>
+        <feMergeNode in="blur" />
+        <feMergeNode in="SourceGraphic" />
+      </feMerge>
+    </filter>
+  </defs>
+
+  <rect width="128" height="128" rx="18" fill="#060811" />
+  <rect x="10" y="10" width="108" height="108" rx="14" fill="none" stroke="url(#ring)" stroke-width="4" filter="url(#glow)" />
+
+  <path d="M33 90L50 38H60L77 90H66L62 78H48L44 90Z" fill="#eff7ff" />
+  <path d="M51 68H59L55 53Z" fill="#0a1222" />
+  <path d="M79 38H96L87 90H72L66 62H77L82 80L86 56H79Z" fill="#eff7ff" />
+
+  <circle cx="21" cy="21" r="2" fill="#22d3ee" opacity="0.7" />
+  <circle cx="107" cy="104" r="2" fill="#ec4899" opacity="0.7" />
+</svg>

package/site/static/img/og-image.svg

@@ -0,0 +1,35 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 630" role="img" aria-labelledby="title desc">
+  <title id="title">Agent Vault Open Graph Image</title>
+  <desc id="desc">Agent Vault branding for social previews</desc>
+  <defs>
+    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#05070f" />
+      <stop offset="55%" stop-color="#0b1020" />
+      <stop offset="100%" stop-color="#07111e" />
+    </linearGradient>
+    <linearGradient id="line" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#22d3ee" />
+      <stop offset="50%" stop-color="#8b5cf6" />
+      <stop offset="100%" stop-color="#ec4899" />
+    </linearGradient>
+    <pattern id="grid" width="48" height="48" patternUnits="userSpaceOnUse" patternTransform="rotate(40)">
+      <line x1="0" y1="0" x2="0" y2="48" stroke="#2a3550" stroke-opacity="0.26" stroke-width="1" />
+    </pattern>
+  </defs>
+
+  <rect width="1200" height="630" fill="url(#bg)" />
+  <rect width="1200" height="630" fill="url(#grid)" />
+
+  <rect x="82" y="72" width="104" height="104" rx="16" fill="#060811" stroke="url(#line)" stroke-width="4" />
+  <path d="M110 146L124 92H133L147 146H138L135 136H122L119 146Z" fill="#eff7ff" />
+  <path d="M124 128H132L128 113Z" fill="#0a1222" />
+  <path d="M150 92H164L157 146H145L140 124H149L153 136L156 108H150Z" fill="#eff7ff" />
+
+  <text x="210" y="136" fill="#d5e7ff" font-family="Inter, Arial, sans-serif" font-size="40" letter-spacing="8">AGENT_VAULT_V1</text>
+  <text x="82" y="302" fill="#ffffff" font-family="Inter, Arial, sans-serif" font-size="116" font-weight="800" letter-spacing="6">AGENT VAULT</text>
+  <text x="82" y="372" fill="#22d3ee" font-family="Inter, Arial, sans-serif" font-size="34" letter-spacing="6">NEURAL SOVEREIGNTY</text>
+  <text x="82" y="440" fill="#b8c9e6" font-family="Inter, Arial, sans-serif" font-size="34">Protecting your agent's neural sovereignty through cryptographic decentralization.</text>
+
+  <line x1="82" y1="492" x2="1118" y2="492" stroke="url(#line)" stroke-opacity="0.6" stroke-width="2" />
+  <text x="82" y="550" fill="#c4d3ee" font-family="Inter, Arial, sans-serif" font-size="28">github.com/johnnyclem/agentvault</text>
+</svg>

package/src/archival/archive-manager.ts

@@ -0,0 +1,372 @@
+/**
+ * Archive Manager
+ *
+ * Manages archiving of agent data to Arweave.
+ * Handles metadata tracking, batch uploads, and retrieval.
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import crypto from 'node:crypto';
+import { parse, stringify } from 'yaml';
+
+const AGENTVAULT_DIR = path.join(os.homedir(), '.agentvault');
+const ARCHIVES_DIR = path.join(AGENTVAULT_DIR, 'archives');
+const ARCHIVE_INDEX_PATH = path.join(ARCHIVES_DIR, 'index.yaml');
+
+export interface ArchiveMetadata {
+  id: string;
+  agentName: string;
+  agentVersion: string;
+  transactionId?: string;
+  timestamp: Date;
+  sizeBytes: number;
+  checksum: string;
+  tags: Record<string, string>;
+  status: 'pending' | 'uploading' | 'confirmed' | 'failed';
+  blockHeight?: number;
+}
+
+export interface ArchiveOptions {
+  includeConfig?: boolean;
+  includeLogs?: boolean;
+  includeMetrics?: boolean;
+  tags?: Record<string, string>;
+}
+
+export interface ArchiveResult {
+  success: boolean;
+  archiveId?: string;
+  transactionId?: string;
+  error?: string;
+}
+
+function ensureArchivesDir(): void {
+  if (!fs.existsSync(AGENTVAULT_DIR)) {
+    fs.mkdirSync(AGENTVAULT_DIR, { recursive: true });
+  }
+  if (!fs.existsSync(ARCHIVES_DIR)) {
+    fs.mkdirSync(ARCHIVES_DIR, { recursive: true });
+  }
+}
+
+function getIndex(): ArchiveMetadata[] {
+  if (!fs.existsSync(ARCHIVE_INDEX_PATH)) {
+    return [];
+  }
+
+  try {
+    const content = fs.readFileSync(ARCHIVE_INDEX_PATH, 'utf8');
+    const parsed = parse(content) as unknown;
+
+    if (Array.isArray(parsed)) {
+      return parsed.map((item) => ({
+        ...item,
+        timestamp: new Date(item.timestamp),
+      })) as ArchiveMetadata[];
+    }
+
+    return [];
+  } catch (error) {
+    console.error('Failed to load archive index:', error);
+    return [];
+  }
+}
+
+function saveIndex(index: ArchiveMetadata[]): void {
+  ensureArchivesDir();
+  fs.writeFileSync(ARCHIVE_INDEX_PATH, stringify(index), 'utf8');
+}
+
+function generateChecksum(data: string | Buffer): string {
+  return crypto.createHash('sha256').update(data).digest('hex');
+}
+
+function generateArchiveId(): string {
+  return `archive-${Date.now()}-${crypto.randomBytes(4).toString('hex')}`;
+}
+
+/**
+ * Archive agent data to local storage (for later upload)
+ */
+export function prepareArchive(
+  agentName: string,
+  agentVersion: string,
+  data: Record<string, any>,
+  options: ArchiveOptions = {},
+): ArchiveResult {
+  try {
+    ensureArchivesDir();
+
+    const archiveId = generateArchiveId();
+    const timestamp = new Date();
+    const dataStr = JSON.stringify(data);
+    const checksum = generateChecksum(dataStr);
+
+    const metadata: ArchiveMetadata = {
+      id: archiveId,
+      agentName,
+      agentVersion,
+      timestamp,
+      sizeBytes: Buffer.byteLength(dataStr),
+      checksum,
+      tags: {
+        'agent-name': agentName,
+        'agent-version': agentVersion,
+        'content-type': 'application/json',
+        ...options.tags,
+      },
+      status: 'pending',
+    };
+
+    const archivePath = path.join(ARCHIVES_DIR, `${archiveId}.json`);
+    fs.writeFileSync(archivePath, dataStr, 'utf8');
+
+    const index = getIndex();
+    index.push(metadata);
+    saveIndex(index);
+
+    return {
+      success: true,
+      archiveId,
+    };
+  } catch (error) {
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : 'Unknown error',
+    };
+  }
+}
+
+/**
+ * Mark archive as uploading
+ */
+export function markArchiveUploading(archiveId: string): boolean {
+  try {
+    const index = getIndex();
+    const archive = index.find((a) => a.id === archiveId);
+
+    if (!archive) {
+      return false;
+    }
+
+    archive.status = 'uploading';
+    saveIndex(index);
+
+    return true;
+  } catch (error) {
+    console.error('Failed to mark archive as uploading:', error);
+    return false;
+  }
+}
+
+/**
+ * Update archive with transaction ID
+ */
+export function updateArchiveTransaction(
+  archiveId: string,
+  transactionId: string,
+): boolean {
+  try {
+    const index = getIndex();
+    const archive = index.find((a) => a.id === archiveId);
+
+    if (!archive) {
+      return false;
+    }
+
+    archive.transactionId = transactionId;
+    archive.status = 'pending';
+    saveIndex(index);
+
+    return true;
+  } catch (error) {
+    console.error('Failed to update archive transaction:', error);
+    return false;
+  }
+}
+
+/**
+ * Mark archive as confirmed
+ */
+export function confirmArchive(
+  archiveId: string,
+  blockHeight?: number,
+): boolean {
+  try {
+    const index = getIndex();
+    const archive = index.find((a) => a.id === archiveId);
+
+    if (!archive) {
+      return false;
+    }
+
+    archive.status = 'confirmed';
+    if (blockHeight) {
+      archive.blockHeight = blockHeight;
+    }
+    saveIndex(index);
+
+    return true;
+  } catch (error) {
+    console.error('Failed to confirm archive:', error);
+    return false;
+  }
+}
+
+/**
+ * Mark archive as failed
+ */
+export function failArchive(archiveId: string, error?: string): boolean {
+  try {
+    const index = getIndex();
+    const archive = index.find((a) => a.id === archiveId);
+
+    if (!archive) {
+      return false;
+    }
+
+    archive.status = 'failed';
+    if (error) {
+      archive.tags['error'] = error;
+    }
+    saveIndex(index);
+
+    return true;
+  } catch (err) {
+    console.error('Failed to mark archive as failed:', err);
+    return false;
+  }
+}
+
+/**
+ * Get archive metadata by ID
+ */
+export function getArchive(archiveId: string): ArchiveMetadata | null {
+  try {
+    const index = getIndex();
+    return index.find((a) => a.id === archiveId) || null;
+  } catch (error) {
+    console.error('Failed to get archive:', error);
+    return null;
+  }
+}
+
+/**
+ * List all archives for an agent
+ */
+export function listArchives(agentName?: string): ArchiveMetadata[] {
+  try {
+    const index = getIndex();
+    if (agentName) {
+      return index.filter((a) => a.agentName === agentName);
+    }
+    return index;
+  } catch (error) {
+    console.error('Failed to list archives:', error);
+    return [];
+  }
+}
+
+/**
+ * List pending archives (ready for upload)
+ */
+export function listPendingArchives(): ArchiveMetadata[] {
+  try {
+    const index = getIndex();
+    return index.filter((a) => a.status === 'pending');
+  } catch (error) {
+    console.error('Failed to list pending archives:', error);
+    return [];
+  }
+}
+
+/**
+ * Get archive data by ID
+ */
+export function getArchiveData(archiveId: string): Record<string, any> | null {
+  try {
+    const archivePath = path.join(ARCHIVES_DIR, `${archiveId}.json`);
+    if (!fs.existsSync(archivePath)) {
+      return null;
+    }
+
+    const content = fs.readFileSync(archivePath, 'utf8');
+    return JSON.parse(content);
+  } catch (error) {
+    console.error('Failed to get archive data:', error);
+    return null;
+  }
+}
+
+/**
+ * Delete archive (local storage only, does not affect Arweave)
+ */
+export function deleteArchive(archiveId: string): boolean {
+  try {
+    const index = getIndex();
+    const archiveIndex = index.findIndex((a) => a.id === archiveId);
+
+    if (archiveIndex === -1) {
+      return false;
+    }
+
+    const archivePath = path.join(ARCHIVES_DIR, `${archiveId}.json`);
+    if (fs.existsSync(archivePath)) {
+      fs.unlinkSync(archivePath);
+    }
+
+    index.splice(archiveIndex, 1);
+    saveIndex(index);
+
+    return true;
+  } catch (error) {
+    console.error('Failed to delete archive:', error);
+    return false;
+  }
+}
+
+/**
+ * Get archive statistics
+ */
+export function getArchiveStats(agentName?: string): {
+  total: number;
+  confirmed: number;
+  pending: number;
+  failed: number;
+  totalBytes: number;
+} {
+  const archives = listArchives(agentName);
+
+  return {
+    total: archives.length,
+    confirmed: archives.filter((a) => a.status === 'confirmed').length,
+    pending: archives.filter((a) => a.status === 'pending').length,
+    failed: archives.filter((a) => a.status === 'failed').length,
+    totalBytes: archives.reduce((sum, a) => sum + a.sizeBytes, 0),
+  };
+}
+
+/**
+ * Verify archive checksum
+ */
+export function verifyArchive(archiveId: string): boolean {
+  try {
+    const metadata = getArchive(archiveId);
+    if (!metadata) {
+      return false;
+    }
+
+    const data = getArchiveData(archiveId);
+    if (!data) {
+      return false;
+    }
+
+    const actualChecksum = generateChecksum(JSON.stringify(data));
+    return actualChecksum === metadata.checksum;
+  } catch (error) {
+    console.error('Failed to verify archive:', error);
+    return false;
+  }
+}