aimeat 1.19.1 → 1.20.0

package/README.md

@@ -13,6 +13,18 @@ AIMEAT is an open protocol for AI agent infrastructure. It gives agents (Claude,
 
 > Try it at [aimeat.io](https://aimeat.io/), or [run your own node](#getting-started) and join the federation.
 
+### Fastest start: let your AI assistant set this up
+
+Cloned the repo and want it running without reading docs? Open **[startup.prompt.md](startup.prompt.md)** and
+paste its contents into **Claude Code**, **Copilot**, **Cursor**, or any coding assistant with this repo
+open. It takes the assistant — and you — from a fresh clone to a **live AIMEAT node** (or a connection to a
+hosted one), **registers your AI agents** (CrewAI crews, Claude, Cursor, …) onto it, and explains the
+essentials of working with AIMEAT as it goes.
+
+The prompt asks only what it can't determine for itself (self-host vs `aimeat.io`, SQLite vs MongoDB, your
+owner handle), runs the setup commands for you, and surfaces each agent's approval code for you to confirm.
+It never invents secrets or pushes anything outward without asking.
+
 <p align="center">
   <img src="assets/screenshots/portal-landing.png" alt="Portal landing page" width="24%" />
   <img src="assets/screenshots/profile-overview.png" alt="User profile with the persistent grouped sidebar" width="24%" />
@@ -357,8 +369,10 @@ aimeat validate    # check for problems
 pnpm dev                     # development with auto-reload
 pnpm build && pnpm start     # production
 
-# Docker (includes MongoDB)
-docker compose up
+# Docker — one compose file per backend (run from the aimeat/ directory)
+docker compose up                                      # MongoDB (default)
+docker compose -f docker-compose.postgres.yml up --build   # PostgreSQL
+docker compose -f docker-compose.sqlite.yml up --build     # SQLite (no external DB)
 ```
 
 Server runs on port 40050. Quick test: paste this into any AI chat:
@@ -367,13 +381,34 @@ Server runs on port 40050. Quick test: paste this into any AI chat:
 
 If the AI reads the docs and explains the protocol, everything works. Admin dashboard URL is shown in the startup log.
 
+### Desktop app (Windows) — no terminal needed
+
+For a personal node without the command line, **AIMEAT Personal Node** is a one-click Windows installer that
+bundles everything — the node server, a Node.js runtime, and a persistent SQLite database — so there are **no
+prerequisites** to install. A small control panel starts/stops the node, shows status and live logs, configures
+it (port, federation role), connects a local AI (Ollama / LM Studio) to your account, and opens the web
+dashboard in your browser. Your data lives in your own app-data folder and survives restarts.
+
+<p align="center">
+  <img src="assets/screenshots/aimeat-desktop.png" alt="AIMEAT Personal Node desktop app — control panel with Getting Started steps, node status (running on port 40050), and node info" width="640" />
+</p>
+
+Build the installer from source (a Rust toolchain + Node 24 + pnpm are needed to *build* it, not to *run* it):
+
+```bash
+pnpm build-desktop   # installer lands in aimeat-desktop/src-tauri/target/release/bundle/
+```
+
+Built with [Tauri](https://tauri.app). Windows is the supported target today (macOS/Linux can follow via per-OS
+CI). Developer docs: [aimeat-desktop/README.md](aimeat-desktop/README.md).
+
 ---
 
 ## Reference Implementation
 
 The `aimeat/` directory contains a full reference implementation in TypeScript (Express 5.2, Node 24). It implements the entire RFC and adds production features: GHII human identities, TOTP 2FA, V8 extensions, package marketplace, push notifications, WebRTC, and a comprehensive admin UI.
 
-Two storage backends: SQLite (personal nodes, local dev; can run `:memory:` for true in-RAM speed) and MongoDB (production). The legacy in-memory backend is deprecated -- SQLite `:memory:` covers the same fast-iteration role using the actual production code path.
+Three storage backends: SQLite (personal nodes, local dev; can run `:memory:` for true in-RAM speed), MongoDB (production), and PostgreSQL (production). MongoDB and PostgreSQL share one Prisma-backed code path, so behaviour is identical across both. The legacy in-memory backend is deprecated -- SQLite `:memory:` covers the same fast-iteration role using the actual production code path.
 
 See the [Implementation Guide v3.0](docs/AIMEAT-IO-Implementation-Guide-v3.0.md) for full details.
 
@@ -382,6 +417,7 @@ See the [Implementation Guide v3.0](docs/AIMEAT-IO-Implementation-Guide-v3.0.md)
 ```bash
 pnpm test:e2e:sqlite        # fast iteration default
 pnpm test:e2e:mongodb       # most realistic; run before a PR
+pnpm test:e2e:postgresql    # PostgreSQL backend (needs a running Postgres)
 pnpm test:playwright:sqlite # browser tests, scoped
 pnpm test                   # unit tests
 pnpm typecheck && pnpm lint

package/dist/.env.example

@@ -9,7 +9,8 @@ AIMEAT_PORT=40050
 # AIMEAT_BASE_URL="https://your-domain.com"  # Public URL (default: http://localhost:$PORT)
 
 # ── Storage Backend ───────────────────────────────────────────
-# Choose storage: memory (default, data lost on restart), sqlite (file-based, zero-config), mongodb (production)
+# Choose storage: memory (default, data lost on restart), sqlite (file-based, zero-config),
+# mongodb (production), or postgresql (production). `postgres` is accepted as an alias.
 # AIMEAT_STORAGE="memory"
 
 # SQLite — file path for the database (auto-created on first run)
@@ -18,6 +19,9 @@ AIMEAT_PORT=40050
 # MongoDB — required when AIMEAT_STORAGE=mongodb
 # DATABASE_URL="mongodb://user:pass@localhost:27017/AIMEAT?replicaSet=rs0&authSource=admin"
 
+# PostgreSQL — required when AIMEAT_STORAGE=postgresql
+# DATABASE_URL="postgresql://user:pass@localhost:5432/aimeat?schema=public"
+
 # ── Operator / Admin ───────────────────────────────────────────
 # Auto-generated on startup if not set (printed to console)
 # AIMEAT_ADMIN_PASSWORD="TestAdminPw123!"

package/dist/locales/en.json

@@ -111,6 +111,10 @@
     "copied": "✓ Copied",
     "error": "Error"
   },
+  "notif": {
+    "title": "Notifications",
+    "empty": "No notifications yet"
+  },
   "nav": {
     "try": "Try it",
     "devView": "For Developers",
@@ -494,12 +498,27 @@
         "byTag": "Filter by tag:",
         "groupBy": "Group by:",
         "groupByNone": "No grouping",
+        "groupByCustom": "Custom groups",
         "groupByTag": "Tag",
         "groupByMode": "Mode",
         "clear": "Clear",
         "untagged": "Untagged",
         "noMatches": "No agents match the current filter."
       },
+      "groups": {
+        "addGroup": "Add group",
+        "hint": "Drag an agent by its grip handle onto a group to file it there.",
+        "ungrouped": "Ungrouped",
+        "unnamed": "Untitled group",
+        "namePlaceholder": "Group name",
+        "rename": "Click to rename",
+        "remove": "Remove group",
+        "toggle": "Collapse / expand",
+        "dragHint": "Drag onto a group to file it",
+        "emptyDrop": "Drag agents here to add them to this group.",
+        "confirmRemove": "Remove the group “{name}”? Its agents move to Ungrouped — they are not deleted.",
+        "saveError": "Failed to save groups."
+      },
       "reorderHint": "Drag to reorder",
       "solo": {
         "notFound": "Agent not found.",
@@ -747,6 +766,9 @@
         "online": "online",
         "offline": "offline",
         "threads": "Conversations",
+        "threadFallback": "Conversation",
+        "threadsShowMore": "Show {count} more",
+        "threadsShowLess": "Show less",
         "proposedTask": "Proposed task",
         "createTask": "Create this task",
         "adjustTask": "Let me adjust",
@@ -2879,7 +2901,7 @@
     "baseUrlInvalid": "Must start with http:// or https://",
     "dbUrl": "MongoDB URL",
     "dbUrlHint": "Leave empty for in-memory storage (data lost on restart)",
-    "dbUrlInvalid": "Must start with mongodb:// or mongodb+srv://",
+    "dbUrlInvalid": "Must be a valid mongodb:// (or mongodb+srv://) or postgresql:// connection URL",
     "adminPassword": "Admin password",
     "adminPasswordHint": "Password for the operator admin panel (min 8 characters)",
     "adminPasswordWeak": "Password must be at least 8 characters",
@@ -3022,6 +3044,7 @@
     "storage_memory": "In-memory (development only, data lost on restart)",
     "storage_sqlite": "SQLite (personal use, zero-config file-based storage)",
     "storage_mongodb": "MongoDB (production, requires external server)",
+    "storage_postgresql": "PostgreSQL (production, requires external server)",
     "sqlite_path_label": "SQLite database path",
     "sqlite_path_hint": "File path for the SQLite database (auto-created)",
     "pushEnabled": "Enable push notifications for personal nodes?",
@@ -5438,6 +5461,195 @@
   },
   "organisms": {
     "title": "Organisms",
+    "openWorkspace": "Open workspace",
+    "backToList": "All organisms",
+    "noWorkspace": "This organism has no workspace yet. Set one up to track goals, plans, deliverables and decisions — versioned on publish.",
+    "setupWorkspace": "Set up workspace",
+    "workspaceReady": "Workspace ready",
+    "setupError": "Failed to set up workspace",
+    "addDraft": "Add draft",
+    "saveDraft": "Save draft",
+    "draftSaved": "Draft saved",
+    "idOptional": "id (optional)",
+    "draft": "draft",
+    "publish": "Publish",
+    "published": "Published",
+    "draftVersion": "Draft",
+    "publishedVersion": "Published",
+    "workspacesDesc": "Workspaces in this organism — each is an independent space with its own documents, records and history.",
+    "newWorkspace": "New workspace",
+    "workspaceName": "Workspace name",
+    "noWorkspaces": "No workspaces yet — create one to get started.",
+    "deleteWorkspaceConfirm": "Delete the workspace “{name}” and all its content? This cannot be undone.",
+    "backToWorkspaces": "Workspaces",
+    "allOrganisms": "All organisms",
+    "currentWorkspaces": "Workspaces in this organism",
+    "import": "Import",
+    "importHint": "Restore a workspace from a .zip backup",
+    "export": "Export backup (.zip)",
+    "imported": "Workspace imported",
+    "exportOrg": "Export organism",
+    "exportOrgHint": "Download a ZIP backup of the whole organism (all workspaces)",
+    "importOrg": "Import organism",
+    "importOrgHint": "Restore an organism from a .zip backup",
+    "orgImported": "Organism imported",
+    "requestAccess": "Request access",
+    "accessRequested": "Access requested — {creator} will decide.",
+    "byCreator": "by {creator}",
+    "yours": "yours",
+    "requests": "Access requests",
+    "noRequests": "No access requests.",
+    "approve": "Approve",
+    "deny": "Deny",
+    "approved": "approved",
+    "revoke": "Revoke",
+    "editFlow": "How editing works here",
+    "activity": "Activity",
+    "draftEdit": "Draft edit",
+    "publishedWord": "Published",
+    "publishedVerb": "published",
+    "editedVerb": "edited",
+    "confirmDeleteItem": "Delete “{name}”? Its draft, published version and full history are removed. This cannot be undone.",
+    "deletedItem": "Deleted",
+    "popOut": "Open in its own window",
+    "docNotFound2": "Document not found.",
+    "loginToView": "Sign in to view this document.",
+    "docRejected": "Document rejected",
+    "participants": "Who works here",
+    "you": "you",
+    "creatorTag": "creator",
+    "guest": "guest",
+    "anAgent": "agent",
+    "hiddenAgent": "An agent whose details you cannot see",
+    "otherAgentHint": "Another owner’s agent — you see what it has done here, not its live status",
+    "viaAgent": "done via this agent",
+    "contributions": "contributions",
+    "events": "events",
+    "less": "Less",
+    "more": "More",
+    "mon": "Mon",
+    "wed": "Wed",
+    "fri": "Fri",
+    "docsDraft": "Docs draft",
+    "docsPublished": "Docs published",
+    "recordsDraft": "Records draft",
+    "recordsPublished": "Records published",
+    "overview": "Overview — who & what uses this organism",
+    "hide": "Hide",
+    "show": "Show",
+    "aiPrompt": "AI access prompt:",
+    "aiPromptHuman": "For chat",
+    "aiPromptAgent": "For coding agent",
+    "promptCopied": "Access prompt copied — paste it to your AI.",
+    "addSpaceBtn": "Space",
+    "addSpaceTitle": "Add a space",
+    "addSpaceDesc": "A document space is a free-form wiki (sections + markdown pages). A record space is a schema-locked list (forms). You can remove spaces in Settings.",
+    "modeDocument": "Document (wiki)",
+    "modeRecords": "Records (form)",
+    "noFields": "No fields",
+    "createdAt": "Created",
+    "lastSaved": "Last saved",
+    "publishedAt": "Published",
+    "fileVisibility": "File visibility",
+    "fileVisibilityNote": "Private files only load for you — make them public to share the document.",
+    "makeAllPublic": "Make all public",
+    "toggleVisibility": "Click to toggle public / private",
+    "public": "Public",
+    "private": "Private",
+    "sources": "Sources",
+    "addSource": "Add source",
+    "close": "Close",
+    "sourcesDesc": "References this workspace draws on — memory, files, and knowledge packages. Pointers only; the originals stay where they live.",
+    "src_memory": "Memory",
+    "src_storage": "Files",
+    "src_knowledge": "Knowledge",
+    "mine": "Mine",
+    "searchSources": "Search…",
+    "search": "Search",
+    "noResults": "No results",
+    "entries": "entries",
+    "attach": "Attach",
+    "noSources": "No sources yet",
+    "external": "external",
+    "sourceAdded": "Source added",
+    "sourceExists": "Already added",
+    "sourcesSaveError": "Failed to save sources",
+    "publishGated": "Sent for review (publish gate is on)",
+    "publishGate": "Require review before publishing",
+    "gateToggled": "Publish gate updated",
+    "needsDecision": "Needs your decision",
+    "approve": "Approve",
+    "reject": "Reject",
+    "approved": "Approved",
+    "rejected": "Rejected",
+    "decisions": "Recent decisions",
+    "noneYet": "none yet",
+    "onePerLine": "one per line",
+    "docs": "docs",
+    "newPage": "New document",
+    "edit": "Edit",
+    "pageTitle": "Document title",
+    "writeMarkdown": "Write markdown…",
+    "insertImage": "Upload image from file",
+    "orPaste": "…or paste / drag an image into the editor",
+    "saving": "Saving…",
+    "pageSaved": "Document saved",
+    "section": "Section",
+    "sectionName": "Section name",
+    "unsorted": "Unsorted",
+    "moveTo": "move…",
+    "newDocHere": "New document here",
+    "addSubsection": "Sub-section",
+    "selectDoc": "Select a document, or create one.",
+    "docNotFound": "No document titled “{title}”",
+    "rename": "Rename",
+    "dragHint": "Drag into a section",
+    "unnamed": "(unnamed)",
+    "removeSection": "Remove section",
+    "confirmRemoveSection": "Remove the section “{name}”? Its documents move to Unsorted — they are not deleted.",
+    "confirmDeleteWorkspace": "Are you sure you want to delete this workspace? All its documents, records and version history are permanently removed. This cannot be undone.",
+    "spaces": "Spaces",
+    "recordsMode": "records",
+    "remove": "Remove",
+    "spaceName": "New space name",
+    "docsSpace": "document space",
+    "recordsSpace": "records type",
+    "addSpace": "+ Add",
+    "spaceAdded": "Space added",
+    "spaceRemoved": "Space removed",
+    "removeSpace": "Remove space",
+    "confirmRemoveSpace": "Remove \"{name}\" from this workspace? Its data is kept in memory (orphaned) but the section disappears.",
+    "restructure": "✨ Restructure / add types with AI",
+    "restructureTitle": "Restructure / add types with AI",
+    "restructureDesc": "Describe what to add or change. Existing types and their data are kept — the AI extends the current structure. (To start completely fresh, delete the workspace below first.)",
+    "dangerZone": "Danger zone",
+    "deleteWarn": "Deleting the workspace removes the manifest and ALL its data — drafts, published records, version history — and its schemas. The organism stays. This cannot be undone.",
+    "deleteConfirmLabel": "Type the workspace name to confirm",
+    "deleteWorkspace": "Delete workspace",
+    "workspaceDeleted": "Workspace deleted",
+    "settings": "Settings",
+    "wsName": "Name",
+    "wsSummary": "Summary",
+    "autonomy": "AI autonomy (L1 cautious → L5 free)",
+    "template": "Template",
+    "settingsSaved": "Settings saved",
+    "generateTitle": "Or generate a custom workspace with AI",
+    "generateDesc": "Describe what this workspace is for — track, organise or refine information, or run a whole project lifecycle. The AI designs the object types. Use your OpenRouter key for one-click generation, or copy the prompt into any AI chat (free) and paste the result back.",
+    "generatePlaceholder": "e.g. a game project's full dev lifecycle · organising AI-governance research & EU regulations · refining product specs",
+    "generate": "Generate with AI",
+    "generating": "Generating…",
+    "generateError": "Generation failed",
+    "noAiKey": "Set up your OpenRouter key above, or copy the prompt to your own AI chat.",
+    "copyPrompt": "Copy prompt",
+    "promptCopied": "Prompt copied — paste it into any AI chat, then paste the JSON it returns below.",
+    "pasteHelp": "No key? Copy the prompt above into any AI chat, then paste the JSON it returns here:",
+    "pastePlaceholder": "Paste the AI JSON response here",
+    "applyPasted": "Validate & apply",
+    "applyError": "Could not apply — check the pasted JSON.",
+    "genFailed": "Generation failed — try again",
+    "fixNeeded": "This needs fixing before it can be saved:",
+    "copyFixPrompt": "Copy fix prompt for the AI",
+    "fixPromptCopied": "Fix prompt copied — paste it back to your AI, then paste the corrected JSON.",
     "desc": "Organisms are groups — communities, teams, clubs, or projects. Create one or join existing ones to share knowledge, coordinate work, and build together.",
     "loading": "Loading organisms...",
     "empty": "You are not part of any organisms yet.",
@@ -5877,6 +6089,20 @@
     }
   },
   "admin": {
+    "security": {
+      "title": "Security",
+      "desc": "Rejected / quarantined uploads and other security incidents.",
+      "open": "open",
+      "none": "No security incidents 🎉",
+      "actor": "On behalf of",
+      "source": "Source",
+      "resolve": "Resolve",
+      "resolved": "Incident resolved",
+      "delete": "Delete",
+      "deleted": "Deleted",
+      "deleteConfirm": "Delete this incident and its quarantined file?",
+      "evidence": "Payload"
+    },
     "tabs": {
       "agentIntegration": "Agent Integration"
     },