forge-openclaw-plugin 0.3.15 → 0.3.17

package/dist/server/{server → apps/api}/src/services/companion-iroh.js

@@ -317,19 +317,22 @@ function candidateIrohBinaries() {
     const binaryName = process.platform === "win32" ? "forge-companion-iroh.exe" : "forge-companion-iroh";
     const platformKey = `${process.platform}-${process.arch}`;
     return candidateIrohAssetRoots().flatMap((root) => [
+        path.join(root, "packages", "companion-iroh", "target", "release", binaryName),
+        path.join(root, "packages", "companion-iroh", "target", "debug", binaryName),
         path.join(root, "companion-iroh", "target", "release", binaryName),
         path.join(root, "companion-iroh", "target", "debug", binaryName),
         path.join(root, "companion-iroh-src", "target", "release", binaryName),
         path.join(root, "companion-iroh-src", "target", "debug", binaryName),
         path.join(root, "dist", "companion-iroh-src", "target", "release", binaryName),
         path.join(root, "dist", "companion-iroh-src", "target", "debug", binaryName),
-        path.join(root, "openclaw-plugin", "dist", "companion-iroh", platformKey, binaryName),
+        path.join(root, "plugins/openclaw", "dist", "companion-iroh", platformKey, binaryName),
         path.join(root, "companion-iroh", platformKey, binaryName),
         path.join(root, "companion-iroh", binaryName)
     ]);
 }
 function resolveCompanionIrohManifestPath() {
     const candidates = candidateIrohAssetRoots().flatMap((root) => [
+        path.join(root, "packages", "companion-iroh", "Cargo.toml"),
         path.join(root, "companion-iroh", "Cargo.toml"),
         path.join(root, "companion-iroh-src", "Cargo.toml"),
         path.join(root, "dist", "companion-iroh-src", "Cargo.toml")

package/dist/server/{server → apps/api}/src/services/doctor.js

@@ -2,9 +2,9 @@ import { access, readdir } from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { getDatabase, runInTransaction } from "../db.js";
-import { GAMIFICATION_CATALOG } from "../../../src/lib/gamification-catalog.js";
-const projectRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..", "..");
-const migrationsDir = path.join(projectRoot, "server", "migrations");
+import { GAMIFICATION_CATALOG } from "../../../web/src/lib/gamification-catalog.js";
+const apiRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..");
+const migrationsDir = path.join(apiRoot, "migrations");
 const safeIntegrityRefreshFix = {
     id: "settings.integrity.refresh",
     kind: "safe_auto_fix",

package/dist/server/{server → apps/api}/src/services/entity-crud.js

@@ -1,6 +1,7 @@
 import { z, ZodError } from "zod";
 import { getDatabase, runInTransaction } from "../db.js";
 import { createSleepSession, createSleepSessionSchema, createWorkoutSession, createWorkoutSessionSchema, deleteSleepSession, deleteWorkoutSession, getSleepSessionById, getWorkoutSessionById, listSleepSessions, listWorkoutSessions, updateSleepSession, updateSleepSessionSchema, updateWorkoutSession, updateWorkoutSessionSchema } from "../health.js";
+import { artifactMetadataCreateSchema, artifactMetadataPatchSchema, createArtifactMetadata, deleteArtifactMetadata, getArtifactById, listArtifacts, updateArtifactMetadata } from "./artifacts.js";
 import { createInsight, deleteInsight, getInsightById, listInsights, updateInsight } from "../repositories/collaboration.js";
 import { createCalendarEvent, createTaskTimebox, createWorkBlockTemplate, deleteCalendarEvent, deleteTaskTimebox, deleteWorkBlockTemplate, getCalendarEventById, getTaskTimeboxById, getWorkBlockTemplateById, listCalendarEvents, listTaskTimeboxes, listWorkBlockTemplates, updateCalendarEvent, updateTaskTimebox, updateWorkBlockTemplate } from "../repositories/calendar.js";
 import { createNote, deleteNote, getNoteById, listNotes, unlinkNotesForEntity, updateNote } from "../repositories/notes.js";
@@ -157,6 +158,17 @@ const CRUD_ENTITY_CAPABILITIES = {
         update: (id, patch) => updateTaskTimebox(id, patch),
         hardDelete: (id) => deleteTaskTimebox(id)
     },
+    artifact: {
+        entityType: "artifact",
+        routeBase: "/api/v1/artifacts",
+        deleteMode: "soft_default",
+        inBin: true,
+        list: () => listArtifacts(),
+        get: (id) => getArtifactById(id),
+        create: () => createArtifactMetadata(),
+        update: (id, patch, context) => updateArtifactMetadata(id, patch, context),
+        hardDelete: (id, context) => deleteArtifactMetadata(id, context)
+    },
     sleep_session: {
         entityType: "sleep_session",
         routeBase: "/api/v1/health/sleep",
@@ -370,6 +382,7 @@ const CREATE_ENTITY_SCHEMAS = {
     calendar_event: createCalendarEventSchema,
     work_block_template: createWorkBlockTemplateSchema,
     task_timebox: createTaskTimeboxSchema,
+    artifact: artifactMetadataCreateSchema,
     sleep_session: createSleepSessionSchema,
     workout_session: createWorkoutSessionSchema,
     psyche_value: createPsycheValueSchema,
@@ -400,6 +413,7 @@ const UPDATE_ENTITY_SCHEMAS = {
     calendar_event: updateCalendarEventSchema,
     work_block_template: updateWorkBlockTemplateSchema,
     task_timebox: updateTaskTimeboxSchema,
+    artifact: artifactMetadataPatchSchema,
     sleep_session: updateSleepSessionSchema,
     workout_session: updateWorkoutSessionSchema,
     psyche_value: updatePsycheValueSchema,
@@ -702,6 +716,14 @@ function matchesLinkedTo(entityType, entity, linkedTo) {
         case "task_timebox":
             return ((linkedTo.entityType === "task" && entity.taskId === linkedTo.id) ||
                 (linkedTo.entityType === "project" && entity.projectId === linkedTo.id));
+        case "artifact":
+            return (Array.isArray(entity.links) &&
+                entity.links.some((link) => typeof link === "object" &&
+                    link !== null &&
+                    "entityType" in link &&
+                    "entityId" in link &&
+                    link.entityType === linkedTo.entityType &&
+                    link.entityId === linkedTo.id));
         case "psyche_value":
             return ((linkedTo.entityType === "goal" && Array.isArray(entity.linkedGoalIds) && entity.linkedGoalIds.includes(linkedTo.id)) ||
                 (linkedTo.entityType === "project" && Array.isArray(entity.linkedProjectIds) && entity.linkedProjectIds.includes(linkedTo.id)) ||

package/dist/server/{server → apps/api}/src/services/gamification-assets.js

@@ -5,7 +5,7 @@ import { access, mkdir, readFile, rm, writeFile } from "node:fs/promises";
 import path from "node:path";
 import AdmZip from "adm-zip";
 import { getEffectiveDataRoot } from "../db.js";
-import { GAMIFICATION_CATALOG, GAMIFICATION_MASCOT_KEYS } from "../../../src/lib/gamification-catalog.js";
+import { GAMIFICATION_CATALOG, GAMIFICATION_MASCOT_KEYS } from "../../../web/src/lib/gamification-catalog.js";
 const assetVersion = "0.2.59";
 const defaultReleaseBaseUrl = "https://github.com/albertbuchard/forge/releases/download/forge-gamification-assets-v0.2.59";
 const styleDefinitions = [

package/dist/server/{server → apps/api}/src/services/gamification.js

@@ -2,7 +2,7 @@ import { getDatabase } from "../db.js";
 import { enqueueGamificationCelebration, getGamificationEquipment, insertGamificationUnlock, listGamificationDailyActivity, listGamificationUnlocks, listUnseenGamificationCelebrations, replaceGamificationDailyActivity, upsertGamificationEquipment } from "../repositories/gamification.js";
 import { getDailyAmbientXp, listRewardRules, recordEntityCreationReward } from "../repositories/rewards.js";
 import { getDefaultUser, listUsers, listUsersByIds } from "../repositories/users.js";
-import { GAMIFICATION_CATALOG, GAMIFICATION_STREAK_AWAY_DAY_KEYS, GAMIFICATION_STREAK_POWER_DAY_KEYS } from "../../../src/lib/gamification-catalog.js";
+import { GAMIFICATION_CATALOG, GAMIFICATION_STREAK_AWAY_DAY_KEYS, GAMIFICATION_STREAK_POWER_DAY_KEYS } from "../../../web/src/lib/gamification-catalog.js";
 import { achievementSignalSchema, gamificationCatalogPayloadSchema, gamificationProfileSchema, milestoneRewardSchema } from "../types.js";
 const XP_CURVE_VERSION = "smith-forge";
 const ENTITY_CREATION_REWARD_SOURCES = [

package/dist/server/{server → apps/api}/src/services/knowledge-graph.js

@@ -12,9 +12,10 @@ import { listTasks } from "../repositories/tasks.js";
 import { listWikiSpaces } from "../repositories/wiki-memory.js";
 import { listProjectSummaries } from "./projects.js";
 import { listAiConnectors } from "../repositories/ai-connectors.js";
-import { buildKnowledgeGraphFacets, buildKnowledgeGraphFocusPayload, filterKnowledgeGraphData, selectKnowledgeGraphVisibleNodeIds } from "../../../src/lib/knowledge-graph.js";
-import { getEntityVisual } from "../../../src/lib/entity-visuals.js";
-import { KNOWLEDGE_GRAPH_RELATION_FAMILY_MAP, buildKnowledgeGraphFocusHref, buildKnowledgeGraphNodeId, getKnowledgeGraphEntityHref } from "../../../src/lib/knowledge-graph-types.js";
+import { buildKnowledgeGraphFacets, buildKnowledgeGraphFocusPayload, filterKnowledgeGraphData, selectKnowledgeGraphVisibleNodeIds } from "../../../web/src/lib/knowledge-graph.js";
+import { getEntityVisual } from "../../../web/src/lib/entity-visuals.js";
+import { listArtifacts } from "./artifacts.js";
+import { KNOWLEDGE_GRAPH_RELATION_FAMILY_MAP, buildKnowledgeGraphFocusHref, buildKnowledgeGraphNodeId, getKnowledgeGraphEntityHref } from "../../../web/src/lib/knowledge-graph-types.js";
 const GRAPH_RANGE = {
     from: "2000-01-01T00:00:00.000Z",
     to: "2100-01-01T00:00:00.000Z"
@@ -34,6 +35,7 @@ const BASE_NODE_SIZE = {
     calendar_event: 34,
     work_block: 32,
     timebox: 33,
+    artifact: 36,
     value: 38,
     pattern: 38,
     behavior: 38,
@@ -243,6 +245,13 @@ export function buildKnowledgeGraph(userIds, query = {}) {
     const calendarEvents = listCalendarEvents({ ...GRAPH_RANGE, userIds });
     const workBlocks = listWorkBlockTemplates({ userIds });
     const timeboxes = listTaskTimeboxes({ ...GRAPH_RANGE, userIds });
+    const artifacts = listArtifacts().filter((artifact) => {
+        if (selectedUserIds.size === 0) {
+            return true;
+        }
+        return Boolean((artifact.uploadedByUserId && selectedUserIds.has(artifact.uploadedByUserId)) ||
+            (artifact.actingForUserId && selectedUserIds.has(artifact.actingForUserId)));
+    });
     const eventTypes = filterOwnedEntities("event_type", listEventTypes(), userIds);
     const emotions = filterOwnedEntities("emotion_definition", listEmotionDefinitions(), userIds);
     const values = filterOwnedEntities("psyche_value", listPsycheValues(), userIds);
@@ -808,6 +817,42 @@ export function buildKnowledgeGraph(userIds, query = {}) {
             });
         }
     }
+    for (const artifact of artifacts) {
+        nodes.set(buildKnowledgeGraphNodeId("artifact", artifact.id), makeNode({
+            entityType: "artifact",
+            entityId: artifact.id,
+            entityKind: "artifact",
+            title: artifact.title,
+            subtitle: `${artifact.detectedExtension.toUpperCase()} · ${artifact.dangerLevel}`,
+            description: artifact.shortDescription || artifact.description,
+            searchText: JSON.stringify({
+                title: artifact.title,
+                shortDescription: artifact.shortDescription,
+                description: artifact.description,
+                originalFileName: artifact.originalFileName,
+                sourceLabel: artifact.sourceLabel,
+                metadata: artifact.metadata
+            }),
+            previewStats: [
+                { label: "Format", value: artifact.formatFamily },
+                { label: "Danger", value: `${artifact.dangerScore}/100` },
+                { label: "Links", value: artifact.links.length }
+            ],
+            href: getKnowledgeGraphEntityHref("artifact", artifact.id),
+            updatedAt: artifact.updatedAt
+        }));
+        for (const link of artifact.links) {
+            addEdge(edges, {
+                source: buildKnowledgeGraphNodeId("artifact", artifact.id),
+                target: buildKnowledgeGraphNodeId(link.targetEntityType, link.targetEntityId),
+                relationKind: "entity_link",
+                label: link.relationship || "Entity link",
+                strength: 0.7,
+                directional: true,
+                structural: false
+            });
+        }
+    }
     for (const eventType of eventTypes) {
         nodes.set(buildKnowledgeGraphNodeId("event_type", eventType.id), makeNode({
             entityType: "event_type",

package/dist/server/{server → apps/api}/src/services/psyche-observation-calendar.js

@@ -40,6 +40,7 @@ const ACTIVITY_ENTITY_LABELS = {
     work_block: "Work block",
     work_block_template: "Work block template",
     task_timebox: "Task timebox",
+    artifact: "Artifact",
     preference_catalog: "Preference catalog",
     preference_catalog_item: "Preference concept",
     preference_context: "Preference context",

package/dist/server/{server → apps/api}/src/types.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
-import { LEGACY_WORKBENCH_PORT_KINDS, WORKBENCH_PORT_KINDS, normalizeWorkbenchPortKind } from "../../src/lib/workbench/nodes.js";
-import { formatLocalDateKey } from "../../src/lib/date-keys.js";
+import { LEGACY_WORKBENCH_PORT_KINDS, WORKBENCH_PORT_KINDS, normalizeWorkbenchPortKind } from "../../web/src/lib/workbench/nodes.js";
+import { formatLocalDateKey } from "../../web/src/lib/date-keys.js";
 export const taskStatusSchema = z.enum([
     "backlog",
     "focus",
@@ -172,6 +172,7 @@ export const activityEntityTypeSchema = z.enum([
     "work_block",
     "work_block_template",
     "task_timebox",
+    "artifact",
     "sleep_session",
     "workout_session"
 ]);
@@ -358,6 +359,7 @@ export const crudEntityTypeSchema = z.enum([
     "calendar_event",
     "work_block_template",
     "task_timebox",
+    "artifact",
     "psyche_value",
     "behavior_pattern",
     "behavior",

package/dist/server/{server → apps/api}/src/watch-mobile.js

@@ -11,7 +11,7 @@ import { listProjectSummaries } from "./services/projects.js";
 import { listTasks, updateTask } from "./repositories/tasks.js";
 import { claimTaskRun, completeTaskRun, focusTaskRun, heartbeatTaskRun, listTaskRuns, releaseTaskRun } from "./repositories/task-runs.js";
 import { createTriggerReport, listBehaviorPatterns, listBehaviors, listEmotionDefinitions, listEventTypes, listModeProfiles, listPsycheValues, listTriggerReports } from "./repositories/psyche.js";
-import { formatLocalDateKey } from "../../src/lib/date-keys.js";
+import { formatLocalDateKey } from "../../web/src/lib/date-keys.js";
 const watchHistoryStateSchema = z.enum(["aligned", "unaligned", "unknown"]);
 const watchPromptKindSchema = z.enum([
     "new_place",

package/dist/server/{src → apps/web/src}/lib/api.js

@@ -890,6 +890,75 @@ export function createNote(input) {
         body: JSON.stringify(input)
     });
 }
+export async function listArtifacts(options = {}) {
+    const search = new URLSearchParams();
+    if (options.query?.trim()) {
+        search.set("query", options.query.trim());
+    }
+    if (options.artifactState) {
+        search.set("artifactState", options.artifactState);
+    }
+    if (options.dangerLevel) {
+        search.set("dangerLevel", options.dangerLevel);
+    }
+    if (options.formatFamily) {
+        search.set("formatFamily", options.formatFamily);
+    }
+    if (options.linkedEntityType?.trim() && options.linkedEntityId?.trim()) {
+        search.set("linkedEntityType", options.linkedEntityType.trim());
+        search.set("linkedEntityId", options.linkedEntityId.trim());
+    }
+    if (options.limit) {
+        search.set("limit", String(options.limit));
+    }
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/artifacts${suffix}`);
+}
+export function getArtifact(artifactId) {
+    return request(`/api/v1/artifacts/${encodeURIComponent(artifactId)}`);
+}
+export function uploadArtifact(input) {
+    return request("/api/v1/artifacts", {
+        method: "POST",
+        body: JSON.stringify(input)
+    });
+}
+export function patchArtifact(artifactId, patch) {
+    return request(`/api/v1/artifacts/${encodeURIComponent(artifactId)}`, {
+        method: "PATCH",
+        body: JSON.stringify(patch)
+    });
+}
+export function downloadArtifact(artifactId) {
+    return requestBlob(`/api/v1/artifacts/${encodeURIComponent(artifactId)}/download`);
+}
+export function rescanArtifact(artifactId) {
+    return request(`/api/v1/artifacts/${encodeURIComponent(artifactId)}/scan`, { method: "POST" });
+}
+export function enrichArtifact(artifactId, input = {}) {
+    return request(`/api/v1/artifacts/${encodeURIComponent(artifactId)}/enrich`, {
+        method: "POST",
+        body: JSON.stringify(input)
+    });
+}
+export function replaceArtifactEntityLinks(artifactId, links) {
+    return request(`/api/v1/artifacts/${encodeURIComponent(artifactId)}/links`, {
+        method: "POST",
+        body: JSON.stringify({ links })
+    });
+}
+export function patchArtifactTrust(artifactId, input) {
+    return request(`/api/v1/artifacts/${encodeURIComponent(artifactId)}/trust`, {
+        method: "POST",
+        body: JSON.stringify(input)
+    });
+}
+export function listArtifactVersions(artifactId) {
+    return request(`/api/v1/artifacts/${encodeURIComponent(artifactId)}/versions`);
+}
+export function listArtifactAuditEvents(artifactId) {
+    return request(`/api/v1/artifacts/${encodeURIComponent(artifactId)}/audit`);
+}
 export function getNote(noteId) {
     return request(`/api/v1/notes/${noteId}`);
 }

package/dist/server/{src → apps/web/src}/lib/entity-visuals.js

@@ -1,4 +1,4 @@
-import { Bot, CalendarDays, Compass, FileText, FolderOpen, GitBranch, Heart, ListTodo, Network, NotebookPen, PanelTop, Quote, RefreshCw, Repeat, Route, Shapes, Sparkles, StickyNote, Target, Timer, Workflow } from "lucide-react";
+import { Archive, Bot, CalendarDays, Compass, FileText, FolderOpen, GitBranch, Heart, ListTodo, Network, NotebookPen, PanelTop, Quote, RefreshCw, Repeat, Route, Shapes, Sparkles, StickyNote, Target, Timer, Workflow } from "lucide-react";
 export const ENTITY_KINDS = [
     "goal",
     "project",
@@ -14,6 +14,7 @@ export const ENTITY_KINDS = [
     "calendar_event",
     "work_block",
     "timebox",
+    "artifact",
     "value",
     "pattern",
     "behavior",
@@ -127,6 +128,13 @@ const ENTITY_VISUAL_SEEDS = [
         iconName: "Timer",
         accentRgb: [244, 114, 182]
     },
+    {
+        kind: "artifact",
+        label: "Artifact",
+        icon: Archive,
+        iconName: "Archive",
+        accentRgb: [45, 212, 191]
+    },
     {
         kind: "value",
         label: "Value",
@@ -259,6 +267,7 @@ const CRUD_ENTITY_KIND_MAP = {
     calendar_event: "calendar_event",
     work_block_template: "work_block",
     task_timebox: "timebox",
+    artifact: "artifact",
     psyche_value: "value",
     behavior_pattern: "pattern",
     behavior: "behavior",

package/dist/server/{src → apps/web/src}/lib/knowledge-graph-types.js

@@ -39,6 +39,11 @@ export const KNOWLEDGE_GRAPH_HIERARCHY_LANES = [
         label: "Calendar",
         kinds: ["calendar_event", "work_block", "timebox"]
     },
+    {
+        id: "artifacts",
+        label: "Artifacts",
+        kinds: ["artifact"]
+    },
     {
         id: "values",
         label: "Values",
@@ -95,6 +100,7 @@ export const KNOWLEDGE_GRAPH_RELATION_LABELS = {
     strategy_step: "Strategy step",
     strategy_link: "Strategy context",
     habit_link: "Habit link",
+    entity_link: "Entity link",
     note_link: "Note link",
     wiki_parent: "Wiki parent",
     wiki_link: "Wiki link",
@@ -156,6 +162,7 @@ export const KNOWLEDGE_GRAPH_RELATION_FAMILY_MAP = {
     strategy_step: "structural",
     strategy_link: "contextual",
     habit_link: "contextual",
+    entity_link: "contextual",
     note_link: "contextual",
     wiki_parent: "structural",
     wiki_link: "contextual",
@@ -236,6 +243,8 @@ export function getKnowledgeGraphEntityHref(entityType, entityId, options) {
         case "work_block_template":
         case "task_timebox":
             return `/calendar`;
+        case "artifact":
+            return `/artifacts/${encodeURIComponent(entityId)}`;
         case "event_type":
         case "emotion_definition":
             return "/psyche/reports";

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "forge-openclaw-plugin",
   "name": "Forge",
   "description": "Curated OpenClaw adapter for the Forge collaboration API, UI entrypoint, and localhost auto-start runtime.",
-  "version": "0.3.15",
+  "version": "0.3.17",
   "activation": {
     "onStartup": true,
     "onCapabilities": [
@@ -24,6 +24,7 @@
     "tools": [
       "forge_adjust_work_minutes",
       "forge_apply_doctor_fix",
+      "forge_call_artifact_route",
       "forge_call_life_force_route",
       "forge_call_movement_route",
       "forge_call_workbench_route",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forge-openclaw-plugin",
-  "version": "0.3.15",
+  "version": "0.3.17",
   "description": "Curated OpenClaw adapter for the Forge collaboration API, UI entrypoint, and localhost auto-start runtime.",
   "type": "module",
   "license": "Apache-2.0",
@@ -8,9 +8,9 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/albertbuchard/forge.git",
-    "directory": "openclaw-plugin"
+    "directory": "plugins/openclaw"
   },
-  "homepage": "https://github.com/albertbuchard/forge/tree/main/openclaw-plugin#readme",
+  "homepage": "https://github.com/albertbuchard/forge/tree/main/plugins/openclaw#readme",
   "bugs": {
     "url": "https://github.com/albertbuchard/forge/issues"
   },

package/server/index.js

@@ -4,9 +4,9 @@ import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 
 const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
-const repoRoot = path.resolve(packageRoot, "..");
-const builtRuntimeEntry = path.join(packageRoot, "dist", "server", "server", "src", "index.js");
-const devRuntimeEntry = path.join(repoRoot, "server", "src", "index.ts");
+const repoRoot = path.resolve(packageRoot, "..", "..");
+const builtRuntimeEntry = path.join(packageRoot, "dist", "server", "apps", "api", "src", "index.js");
+const devRuntimeEntry = path.join(repoRoot, "apps", "api", "src", "index.ts");
 const devDataRootWrapper = path.join(
   repoRoot,
   "scripts",

package/server/migrations/072_artifact_store.sql

@@ -0,0 +1,106 @@
+CREATE TABLE IF NOT EXISTS artifact_blobs (
+  content_sha256 TEXT PRIMARY KEY,
+  storage_key TEXT NOT NULL UNIQUE,
+  byte_size INTEGER NOT NULL,
+  detected_mime_type TEXT NOT NULL DEFAULT '',
+  created_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS artifacts (
+  id TEXT PRIMARY KEY,
+  title TEXT NOT NULL,
+  short_description TEXT NOT NULL DEFAULT '',
+  description TEXT NOT NULL DEFAULT '',
+  original_file_name TEXT NOT NULL,
+  storage_key TEXT NOT NULL,
+  storage_path TEXT NOT NULL,
+  content_sha256 TEXT NOT NULL,
+  byte_size INTEGER NOT NULL,
+  detected_extension TEXT NOT NULL,
+  declared_mime_type TEXT NOT NULL DEFAULT '',
+  detected_mime_type TEXT NOT NULL DEFAULT '',
+  format_family TEXT NOT NULL,
+  source_kind TEXT NOT NULL DEFAULT 'upload',
+  source_label TEXT NOT NULL DEFAULT '',
+  uploaded_by_user_id TEXT,
+  uploaded_by_agent_id TEXT,
+  acting_for_user_id TEXT,
+  artifact_state TEXT NOT NULL DEFAULT 'active',
+  danger_score INTEGER NOT NULL DEFAULT 0,
+  danger_level TEXT NOT NULL DEFAULT 'low',
+  download_policy TEXT NOT NULL DEFAULT 'human_only',
+  scan_results_json TEXT NOT NULL DEFAULT '{}',
+  enrichment_results_json TEXT NOT NULL DEFAULT '{}',
+  metadata_json TEXT NOT NULL DEFAULT '{}',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY (content_sha256) REFERENCES artifact_blobs(content_sha256)
+);
+
+CREATE INDEX IF NOT EXISTS idx_artifacts_updated
+  ON artifacts (updated_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_artifacts_state_danger
+  ON artifacts (artifact_state, danger_level, updated_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_artifacts_sha
+  ON artifacts (content_sha256, updated_at DESC);
+
+CREATE TABLE IF NOT EXISTS artifact_versions (
+  id TEXT PRIMARY KEY,
+  artifact_id TEXT NOT NULL,
+  version_number INTEGER NOT NULL,
+  content_sha256 TEXT NOT NULL,
+  storage_key TEXT NOT NULL,
+  byte_size INTEGER NOT NULL,
+  original_file_name TEXT NOT NULL,
+  scan_results_json TEXT NOT NULL DEFAULT '{}',
+  enrichment_results_json TEXT NOT NULL DEFAULT '{}',
+  created_by_actor TEXT,
+  created_at TEXT NOT NULL,
+  FOREIGN KEY (artifact_id) REFERENCES artifacts(id) ON DELETE CASCADE,
+  FOREIGN KEY (content_sha256) REFERENCES artifact_blobs(content_sha256),
+  UNIQUE (artifact_id, version_number)
+);
+
+CREATE INDEX IF NOT EXISTS idx_artifact_versions_artifact
+  ON artifact_versions (artifact_id, version_number DESC);
+
+CREATE TABLE IF NOT EXISTS entity_links (
+  source_entity_type TEXT NOT NULL,
+  source_entity_id TEXT NOT NULL,
+  target_entity_type TEXT NOT NULL,
+  target_entity_id TEXT NOT NULL,
+  anchor_key TEXT NOT NULL DEFAULT '',
+  relationship TEXT NOT NULL DEFAULT 'related',
+  created_by_actor TEXT,
+  created_at TEXT NOT NULL,
+  PRIMARY KEY (
+    source_entity_type,
+    source_entity_id,
+    target_entity_type,
+    target_entity_id,
+    anchor_key,
+    relationship
+  )
+);
+
+CREATE INDEX IF NOT EXISTS idx_entity_links_source
+  ON entity_links (source_entity_type, source_entity_id, created_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_entity_links_target
+  ON entity_links (target_entity_type, target_entity_id, created_at DESC);
+
+CREATE TABLE IF NOT EXISTS artifact_audit_events (
+  id TEXT PRIMARY KEY,
+  artifact_id TEXT NOT NULL,
+  event_type TEXT NOT NULL,
+  actor TEXT,
+  source TEXT NOT NULL,
+  metadata_json TEXT NOT NULL DEFAULT '{}',
+  created_at TEXT NOT NULL,
+  FOREIGN KEY (artifact_id) REFERENCES artifacts(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_artifact_audit_events_artifact
+  ON artifact_audit_events (artifact_id, created_at DESC);