forge-openclaw-plugin 0.2.70 → 0.2.71

package/dist/server/server/src/repositories/psyche.js

@@ -6,7 +6,7 @@ import { clearEntityOwner, decorateOwnedEntity, setEntityOwner } from "./entity-
 import { recordEventLog } from "./event-log.js";
 import { unlinkNotesForEntity } from "./notes.js";
 import { recordPsycheClarityReward, recordPsycheReflectionReward } from "./rewards.js";
-import { behaviorPatternSchema, behaviorSchema, beliefEntrySchema, createBehaviorPatternSchema, createBehaviorSchema, createBeliefEntrySchema, createEmotionDefinitionSchema, createEventTypeSchema, createModeGuideSessionSchema, createModeProfileSchema, createPsycheValueSchema, createTriggerReportSchema, domainSchema, emotionDefinitionSchema, eventTypeSchema, modeFamilySchema, modeGuideResultSchema, modeGuideSessionSchema, modeProfileSchema, modeTimelineEntrySchema, psycheValueSchema, schemaCatalogEntrySchema, triggerReportSchema, updateBehaviorPatternSchema, updateBehaviorSchema, updateBeliefEntrySchema, updateEmotionDefinitionSchema, updateEventTypeSchema, updateModeGuideSessionSchema, updateModeProfileSchema, updatePsycheValueSchema, updateTriggerReportSchema } from "../psyche-types.js";
+import { behaviorPatternSchema, behaviorSchema, beliefEntrySchema, createBehaviorPatternSchema, createBehaviorSchema, createBeliefEntrySchema, createEmotionDefinitionSchema, createEventTypeSchema, createFlashcardSchema, createModeGuideSessionSchema, createModeProfileSchema, createPsycheValueSchema, createTriggerReportSchema, domainSchema, emotionDefinitionSchema, eventTypeSchema, flashcardSchema, modeFamilySchema, modeGuideResultSchema, modeGuideSessionSchema, modeProfileSchema, modeTimelineEntrySchema, psycheValueSchema, schemaCatalogEntrySchema, triggerReportSchema, updateBehaviorPatternSchema, updateBehaviorSchema, updateBeliefEntrySchema, updateEmotionDefinitionSchema, updateEventTypeSchema, updateFlashcardSchema, updateModeGuideSessionSchema, updateModeProfileSchema, updatePsycheValueSchema, updateTriggerReportSchema } from "../psyche-types.js";
 const PSYCHE_DOMAIN_ID = "domain_psyche";
 function parseJson(value) {
     return JSON.parse(value);
@@ -180,6 +180,33 @@ function mapModeGuideSession(row) {
         updatedAt: row.updated_at
     });
 }
+function mapFlashcard(row) {
+    return flashcardSchema.parse({
+        id: row.id,
+        domainId: row.domain_id,
+        title: row.title,
+        message: row.message,
+        triggerSentence: row.trigger_sentence,
+        triggerSituation: row.trigger_situation,
+        tags: parseJson(row.tags_json),
+        backgroundColor: row.background_color,
+        textColor: row.text_color,
+        accentColor: row.accent_color,
+        typography: row.typography,
+        imageUrl: row.image_url,
+        imageAlt: row.image_alt,
+        layout: row.layout,
+        visualStyle: row.visual_style,
+        linkedValueIds: filterDeletedIds("psyche_value", parseJson(row.linked_value_ids_json)),
+        linkedBehaviorIds: filterDeletedIds("behavior", parseJson(row.linked_behavior_ids_json)),
+        linkedPatternIds: filterDeletedIds("behavior_pattern", parseJson(row.linked_pattern_ids_json)),
+        linkedBeliefIds: filterDeletedIds("belief_entry", parseJson(row.linked_belief_ids_json)),
+        linkedModeIds: filterDeletedIds("mode_profile", parseJson(row.linked_mode_ids_json)),
+        linkedReportIds: filterDeletedIds("trigger_report", parseJson(row.linked_report_ids_json)),
+        createdAt: row.created_at,
+        updatedAt: row.updated_at
+    });
+}
 function mapTriggerReport(row) {
     const emotions = parseJson(row.emotions_json).map((emotion) => emotion.emotionDefinitionId && isEntityDeleted("emotion_definition", emotion.emotionDefinitionId)
         ? { ...emotion, emotionDefinitionId: null }
@@ -679,6 +706,7 @@ export function deletePsycheValue(valueId, context) {
         removeIdFromStringArrayColumn("belief_entries", "linked_value_ids_json", valueId);
         removeIdFromStringArrayColumn("mode_profiles", "linked_value_ids_json", valueId);
         removeIdFromStringArrayColumn("trigger_reports", "linked_value_ids_json", valueId);
+        removeIdFromStringArrayColumn("psyche_flashcards", "linked_value_ids_json", valueId);
         unlinkEntityNotes("psyche_value", valueId);
         clearEntityOwner("psyche_value", valueId);
         getDatabase()
@@ -804,6 +832,7 @@ export function deleteBehaviorPattern(patternId, context) {
         removeIdFromStringArrayColumn("psyche_behaviors", "linked_pattern_ids_json", patternId);
         removeIdFromStringArrayColumn("mode_profiles", "linked_pattern_ids_json", patternId);
         removeIdFromStringArrayColumn("trigger_reports", "linked_pattern_ids_json", patternId);
+        removeIdFromStringArrayColumn("psyche_flashcards", "linked_pattern_ids_json", patternId);
         unlinkEntityNotes("behavior_pattern", patternId);
         clearEntityOwner("behavior_pattern", patternId);
         getDatabase()
@@ -916,6 +945,7 @@ export function deleteBehavior(behaviorId, context) {
         removeIdFromStringArrayColumn("belief_entries", "linked_behavior_ids_json", behaviorId);
         removeIdFromStringArrayColumn("mode_profiles", "linked_behavior_ids_json", behaviorId);
         removeIdFromStringArrayColumn("trigger_reports", "linked_behavior_ids_json", behaviorId);
+        removeIdFromStringArrayColumn("psyche_flashcards", "linked_behavior_ids_json", behaviorId);
         nullifyTriggerBehaviorReferences(behaviorId);
         unlinkEntityNotes("behavior", behaviorId);
         clearEntityOwner("behavior", behaviorId);
@@ -1028,6 +1058,7 @@ export function deleteBeliefEntry(beliefId, context) {
     return runInTransaction(() => {
         removeIdFromStringArrayColumn("behavior_patterns", "linked_belief_ids_json", beliefId);
         removeIdFromStringArrayColumn("trigger_reports", "linked_belief_ids_json", beliefId);
+        removeIdFromStringArrayColumn("psyche_flashcards", "linked_belief_ids_json", beliefId);
         nullifyTriggerThoughtBeliefReferences(beliefId);
         unlinkEntityNotes("belief_entry", beliefId);
         clearEntityOwner("belief_entry", beliefId);
@@ -1142,6 +1173,7 @@ export function deleteModeProfile(modeId, context) {
         removeIdFromStringArrayColumn("psyche_behaviors", "linked_mode_ids_json", modeId);
         removeIdFromStringArrayColumn("belief_entries", "linked_mode_ids_json", modeId);
         removeIdFromStringArrayColumn("trigger_reports", "linked_mode_ids_json", modeId);
+        removeIdFromStringArrayColumn("psyche_flashcards", "linked_mode_ids_json", modeId);
         nullifyTriggerTimelineModeReferences(modeId);
         unlinkEntityNotes("mode_profile", modeId);
         clearEntityOwner("mode_profile", modeId);
@@ -1260,6 +1292,118 @@ export function deleteModeGuideSession(sessionId, context) {
         return existing;
     });
 }
+const FLASHCARD_SELECT = `SELECT
+  id, domain_id, title, message, trigger_sentence, trigger_situation, tags_json,
+  background_color, text_color, accent_color, typography, image_url, image_alt,
+  layout, visual_style, linked_value_ids_json, linked_behavior_ids_json,
+  linked_pattern_ids_json, linked_belief_ids_json, linked_mode_ids_json,
+  linked_report_ids_json, created_at, updated_at
+ FROM psyche_flashcards`;
+export function listFlashcards() {
+    const rows = getDatabase()
+        .prepare(`${FLASHCARD_SELECT}
+       WHERE domain_id = ?
+       ORDER BY updated_at DESC`)
+        .all(PSYCHE_DOMAIN_ID);
+    return filterDeletedEntities("flashcard", rows.map(mapFlashcard));
+}
+export function getFlashcardById(flashcardId) {
+    if (isEntityDeleted("flashcard", flashcardId)) {
+        return undefined;
+    }
+    const row = getRow(`${FLASHCARD_SELECT}
+     WHERE id = ?`, flashcardId);
+    return row ? decorateOwnedEntity("flashcard", mapFlashcard(row)) : undefined;
+}
+export function createFlashcard(input, context) {
+    const parsed = createFlashcardSchema.parse(input);
+    const now = new Date().toISOString();
+    const flashcard = flashcardSchema.parse({
+        id: buildId("flc"),
+        domainId: PSYCHE_DOMAIN_ID,
+        ...parsed,
+        createdAt: now,
+        updatedAt: now
+    });
+    getDatabase()
+        .prepare(`INSERT INTO psyche_flashcards (
+        id, domain_id, title, message, trigger_sentence, trigger_situation, tags_json,
+        background_color, text_color, accent_color, typography, image_url, image_alt,
+        layout, visual_style, linked_value_ids_json, linked_behavior_ids_json,
+        linked_pattern_ids_json, linked_belief_ids_json, linked_mode_ids_json,
+        linked_report_ids_json, created_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+        .run(flashcard.id, flashcard.domainId, flashcard.title, flashcard.message, flashcard.triggerSentence, flashcard.triggerSituation, JSON.stringify(flashcard.tags), flashcard.backgroundColor, flashcard.textColor, flashcard.accentColor, flashcard.typography, flashcard.imageUrl, flashcard.imageAlt, flashcard.layout, flashcard.visualStyle, JSON.stringify(flashcard.linkedValueIds), JSON.stringify(flashcard.linkedBehaviorIds), JSON.stringify(flashcard.linkedPatternIds), JSON.stringify(flashcard.linkedBeliefIds), JSON.stringify(flashcard.linkedModeIds), JSON.stringify(flashcard.linkedReportIds), flashcard.createdAt, flashcard.updatedAt);
+    assignOwnedEntity("flashcard", flashcard.id, parsed.userId, context.actor);
+    mapCreateUpdateContext({
+        entityType: "flashcard",
+        entityId: flashcard.id,
+        title: "Flashcard added",
+        eventKind: "flashcard.created",
+        source: context.source,
+        actor: context.actor ?? null,
+        metadata: { domainId: flashcard.domainId }
+    });
+    return decorateOwnedEntity("flashcard", flashcard);
+}
+export function updateFlashcard(flashcardId, patch, context) {
+    const existing = getFlashcardById(flashcardId);
+    if (!existing) {
+        return undefined;
+    }
+    const parsed = updateFlashcardSchema.parse(patch);
+    const updated = flashcardSchema.parse({
+        ...existing,
+        ...parsed,
+        updatedAt: new Date().toISOString()
+    });
+    getDatabase()
+        .prepare(`UPDATE psyche_flashcards
+       SET title = ?, message = ?, trigger_sentence = ?, trigger_situation = ?,
+           tags_json = ?, background_color = ?, text_color = ?, accent_color = ?,
+           typography = ?, image_url = ?, image_alt = ?, layout = ?, visual_style = ?,
+           linked_value_ids_json = ?, linked_behavior_ids_json = ?, linked_pattern_ids_json = ?,
+           linked_belief_ids_json = ?, linked_mode_ids_json = ?, linked_report_ids_json = ?,
+           updated_at = ?
+       WHERE id = ?`)
+        .run(updated.title, updated.message, updated.triggerSentence, updated.triggerSituation, JSON.stringify(updated.tags), updated.backgroundColor, updated.textColor, updated.accentColor, updated.typography, updated.imageUrl, updated.imageAlt, updated.layout, updated.visualStyle, JSON.stringify(updated.linkedValueIds), JSON.stringify(updated.linkedBehaviorIds), JSON.stringify(updated.linkedPatternIds), JSON.stringify(updated.linkedBeliefIds), JSON.stringify(updated.linkedModeIds), JSON.stringify(updated.linkedReportIds), updated.updatedAt, flashcardId);
+    if (parsed.userId !== undefined) {
+        assignOwnedEntity("flashcard", flashcardId, parsed.userId, context.actor);
+    }
+    mapCreateUpdateContext({
+        entityType: "flashcard",
+        entityId: flashcardId,
+        title: "Flashcard updated",
+        eventKind: "flashcard.updated",
+        source: context.source,
+        actor: context.actor ?? null,
+        metadata: { domainId: updated.domainId }
+    });
+    return decorateOwnedEntity("flashcard", updated);
+}
+export function deleteFlashcard(flashcardId, context) {
+    const existing = getFlashcardById(flashcardId);
+    if (!existing) {
+        return undefined;
+    }
+    return runInTransaction(() => {
+        unlinkEntityNotes("flashcard", flashcardId);
+        clearEntityOwner("flashcard", flashcardId);
+        getDatabase()
+            .prepare(`DELETE FROM psyche_flashcards WHERE id = ?`)
+            .run(flashcardId);
+        mapCreateUpdateContext({
+            entityType: "flashcard",
+            entityId: flashcardId,
+            title: "Flashcard deleted",
+            eventKind: "flashcard.deleted",
+            source: context.source,
+            actor: context.actor ?? null,
+            metadata: { domainId: existing.domainId }
+        });
+        return existing;
+    });
+}
 export function listTriggerReports(limit) {
     const limitSql = limit ? "LIMIT ?" : "";
     const rows = getDatabase()
@@ -1391,6 +1535,7 @@ export function deleteTriggerReport(reportId, context) {
     }
     return runInTransaction(() => {
         removeIdFromStringArrayColumn("belief_entries", "linked_report_ids_json", reportId);
+        removeIdFromStringArrayColumn("psyche_flashcards", "linked_report_ids_json", reportId);
         unlinkEntityNotes("trigger_report", reportId);
         clearEntityOwner("trigger_report", reportId);
         getDatabase()

package/dist/server/server/src/services/entity-crud.js

@@ -6,12 +6,12 @@ import { createCalendarEvent, createTaskTimebox, createWorkBlockTemplate, delete
 import { createNote, deleteNote, getNoteById, listNotes, unlinkNotesForEntity, updateNote } from "../repositories/notes.js";
 import { clearEntityOwner, filterOwnedEntities } from "../repositories/entity-ownership.js";
 import { createPreferenceCatalog, createPreferenceCatalogItem, createPreferenceContext, createPreferenceItem, deletePreferenceCatalog, deletePreferenceCatalogItem, deletePreferenceContext, deletePreferenceItem, getPreferenceCatalogById, getPreferenceCatalogItemById, getPreferenceContextById, getPreferenceItemById, listPreferenceCatalogItems, listPreferenceCatalogs, listPreferenceContexts, listPreferenceItems, updatePreferenceCatalog, updatePreferenceCatalogItem, updatePreferenceContext, updatePreferenceItem } from "../repositories/preferences.js";
-import { createBehaviorPatternSchema, createBehaviorSchema, createBeliefEntrySchema, createEmotionDefinitionSchema, createEventTypeSchema, createModeGuideSessionSchema, createModeProfileSchema, createPsycheValueSchema, createTriggerReportSchema, updateBehaviorPatternSchema, updateBehaviorSchema, updateBeliefEntrySchema, updateEmotionDefinitionSchema, updateEventTypeSchema, updateModeGuideSessionSchema, updateModeProfileSchema, updatePsycheValueSchema, updateTriggerReportSchema } from "../psyche-types.js";
+import { createBehaviorPatternSchema, createBehaviorSchema, createBeliefEntrySchema, createEmotionDefinitionSchema, createEventTypeSchema, createFlashcardSchema, createModeGuideSessionSchema, createModeProfileSchema, createPsycheValueSchema, createTriggerReportSchema, updateBehaviorPatternSchema, updateBehaviorSchema, updateBeliefEntrySchema, updateEmotionDefinitionSchema, updateEventTypeSchema, updateFlashcardSchema, updateModeGuideSessionSchema, updateModeProfileSchema, updatePsycheValueSchema, updateTriggerReportSchema } from "../psyche-types.js";
 import { buildSettingsBinPayload, cascadeSoftDeleteAnchoredCollaboration, clearDeletedEntityRecord, getDeletedEntityRecord, listDeletedEntities, restoreAnchoredCollaboration, restoreDeletedEntityRecord, upsertDeletedEntityRecord } from "../repositories/deleted-entities.js";
 import { createGoal, deleteGoal, getGoalById, listGoals, updateGoal } from "../repositories/goals.js";
 import { createHabit, deleteHabit, getHabitById, listHabits, updateHabit } from "../repositories/habits.js";
 import { createQuestionnaireInstrument, deleteQuestionnaireInstrument, getQuestionnaireInstrumentEntityById, listQuestionnaireInstrumentEntities, updateQuestionnaireInstrument, updateQuestionnaireInstrumentSchema } from "../repositories/questionnaires.js";
-import { createBehavior, createBehaviorPattern, createBeliefEntry, createEmotionDefinition, createEventType, createModeGuideSession, createModeProfile, createPsycheValue, createTriggerReport, deleteBehavior, deleteBehaviorPattern, deleteBeliefEntry, deleteEmotionDefinition, deleteEventType, deleteModeGuideSession, deleteModeProfile, deletePsycheValue, deleteTriggerReport, getBehaviorById, getBehaviorPatternById, getBeliefEntryById, getEmotionDefinitionById, getEventTypeById, getModeGuideSessionById, getModeProfileById, getPsycheValueById, getTriggerReportById, listBehaviors, listBehaviorPatterns, listBeliefEntries, listEmotionDefinitions, listEventTypes, listModeGuideSessions, listModeProfiles, listPsycheValues, listTriggerReports, updateBehavior, updateBehaviorPattern, updateBeliefEntry, updateEmotionDefinition, updateEventType, updateModeGuideSession, updateModeProfile, updatePsycheValue, updateTriggerReport } from "../repositories/psyche.js";
+import { createBehavior, createBehaviorPattern, createBeliefEntry, createEmotionDefinition, createEventType, createFlashcard, createModeGuideSession, createModeProfile, createPsycheValue, createTriggerReport, deleteBehavior, deleteBehaviorPattern, deleteBeliefEntry, deleteEmotionDefinition, deleteEventType, deleteFlashcard, deleteModeGuideSession, deleteModeProfile, deletePsycheValue, deleteTriggerReport, getBehaviorById, getBehaviorPatternById, getBeliefEntryById, getEmotionDefinitionById, getEventTypeById, getFlashcardById, getModeGuideSessionById, getModeProfileById, getPsycheValueById, getTriggerReportById, listBehaviors, listBehaviorPatterns, listBeliefEntries, listEmotionDefinitions, listEventTypes, listFlashcards, listModeGuideSessions, listModeProfiles, listPsycheValues, listTriggerReports, updateBehavior, updateBehaviorPattern, updateBeliefEntry, updateEmotionDefinition, updateEventType, updateFlashcard, updateModeGuideSession, updateModeProfile, updatePsycheValue, updateTriggerReport } from "../repositories/psyche.js";
 import { createProject, deleteProject, getProjectById, listProjects, updateProject } from "../repositories/projects.js";
 import { createStrategy, deleteStrategy, getStrategyById, listStrategies, updateStrategy } from "../repositories/strategies.js";
 import { createTag, deleteTag, getTagById, listTags, updateTag } from "../repositories/tags.js";
@@ -245,6 +245,17 @@ const CRUD_ENTITY_CAPABILITIES = {
         update: (id, patch, context) => updateModeGuideSession(id, patch, context),
         hardDelete: (id, context) => deleteModeGuideSession(id, context)
     },
+    flashcard: {
+        entityType: "flashcard",
+        routeBase: "/api/v1/entities",
+        deleteMode: "soft_default",
+        inBin: true,
+        list: () => listFlashcards(),
+        get: (id) => getFlashcardById(id),
+        create: (data, context) => createFlashcard(data, context),
+        update: (id, patch, context) => updateFlashcard(id, patch, context),
+        hardDelete: (id, context) => deleteFlashcard(id, context)
+    },
     event_type: {
         entityType: "event_type",
         routeBase: "/api/v1/psyche/event-types",
@@ -367,6 +378,7 @@ const CREATE_ENTITY_SCHEMAS = {
     belief_entry: createBeliefEntrySchema,
     mode_profile: createModeProfileSchema,
     mode_guide_session: createModeGuideSessionSchema,
+    flashcard: createFlashcardSchema,
     event_type: createEventTypeSchema,
     emotion_definition: createEmotionDefinitionSchema,
     trigger_report: createTriggerReportSchema,
@@ -396,6 +408,7 @@ const UPDATE_ENTITY_SCHEMAS = {
     belief_entry: updateBeliefEntrySchema,
     mode_profile: updateModeProfileSchema,
     mode_guide_session: updateModeGuideSessionSchema,
+    flashcard: updateFlashcardSchema,
     event_type: updateEventTypeSchema,
     emotion_definition: updateEmotionDefinitionSchema,
     trigger_report: updateTriggerReportSchema,
@@ -636,9 +649,11 @@ function describeEntity(entityType, entity) {
                 ? entity.label
                 : typeof entity.summary === "string" && entity.summary.trim().length > 0
                     ? entity.summary
-                    : typeof entity.body === "string" && entity.body.trim().length > 0
-                        ? entity.body.slice(0, 72)
-                        : entityType.replaceAll("_", " ");
+                    : typeof entity.message === "string" && entity.message.trim().length > 0
+                        ? entity.message.slice(0, 72)
+                        : typeof entity.body === "string" && entity.body.trim().length > 0
+                            ? entity.body.slice(0, 72)
+                            : entityType.replaceAll("_", " ");
     const subtitle = typeof entity.description === "string" && entity.description.trim().length > 0
         ? entity.description
         : typeof entity.summary === "string" && entity.summary.trim().length > 0
@@ -708,6 +723,13 @@ function matchesLinkedTo(entityType, entity, linkedTo) {
             return ((linkedTo.entityType === "behavior_pattern" && Array.isArray(entity.linkedPatternIds) && entity.linkedPatternIds.includes(linkedTo.id)) ||
                 (linkedTo.entityType === "behavior" && Array.isArray(entity.linkedBehaviorIds) && entity.linkedBehaviorIds.includes(linkedTo.id)) ||
                 (linkedTo.entityType === "psyche_value" && Array.isArray(entity.linkedValueIds) && entity.linkedValueIds.includes(linkedTo.id)));
+        case "flashcard":
+            return ((linkedTo.entityType === "psyche_value" && Array.isArray(entity.linkedValueIds) && entity.linkedValueIds.includes(linkedTo.id)) ||
+                (linkedTo.entityType === "behavior" && Array.isArray(entity.linkedBehaviorIds) && entity.linkedBehaviorIds.includes(linkedTo.id)) ||
+                (linkedTo.entityType === "behavior_pattern" && Array.isArray(entity.linkedPatternIds) && entity.linkedPatternIds.includes(linkedTo.id)) ||
+                (linkedTo.entityType === "belief_entry" && Array.isArray(entity.linkedBeliefIds) && entity.linkedBeliefIds.includes(linkedTo.id)) ||
+                (linkedTo.entityType === "mode_profile" && Array.isArray(entity.linkedModeIds) && entity.linkedModeIds.includes(linkedTo.id)) ||
+                (linkedTo.entityType === "trigger_report" && Array.isArray(entity.linkedReportIds) && entity.linkedReportIds.includes(linkedTo.id)));
         case "trigger_report":
             return ((linkedTo.entityType === "behavior_pattern" && Array.isArray(entity.linkedPatternIds) && entity.linkedPatternIds.includes(linkedTo.id)) ||
                 (linkedTo.entityType === "psyche_value" && Array.isArray(entity.linkedValueIds) && entity.linkedValueIds.includes(linkedTo.id)) ||

package/dist/server/server/src/services/gamification.js

@@ -34,6 +34,7 @@ const ENTITY_CREATION_REWARD_SOURCES = [
     { entityType: "behavior", tableName: "psyche_behaviors", titleColumn: "title" },
     { entityType: "belief_entry", tableName: "belief_entries", titleColumn: "statement" },
     { entityType: "mode_profile", tableName: "mode_profiles", titleColumn: "title" },
+    { entityType: "flashcard", tableName: "psyche_flashcards", titleColumn: "title" },
     { entityType: "trigger_report", tableName: "trigger_reports", titleColumn: "title" }
 ];
 function startOfWeek(date) {
@@ -452,6 +453,7 @@ function buildMetricValues(input) {
         "belief_entry",
         "mode_profile",
         "mode_guide_session",
+        "flashcard",
         "trigger_report"
     ]);
     const nonManualXp = positiveRewards.reduce((sum, reward) => sum + reward.deltaXp, 0);

package/dist/server/server/src/services/knowledge-graph.js

@@ -5,7 +5,7 @@ import { filterOwnedEntities } from "../repositories/entity-ownership.js";
 import { listGoals } from "../repositories/goals.js";
 import { listHabits } from "../repositories/habits.js";
 import { listNotes } from "../repositories/notes.js";
-import { listBehaviors, listBehaviorPatterns, listBeliefEntries, listEmotionDefinitions, listEventTypes, listModeGuideSessions, listModeProfiles, listPsycheValues, listTriggerReports } from "../repositories/psyche.js";
+import { listBehaviors, listBehaviorPatterns, listBeliefEntries, listEmotionDefinitions, listEventTypes, listFlashcards, listModeGuideSessions, listModeProfiles, listPsycheValues, listTriggerReports } from "../repositories/psyche.js";
 import { listStrategies } from "../repositories/strategies.js";
 import { listTags } from "../repositories/tags.js";
 import { listTasks } from "../repositories/tasks.js";
@@ -40,6 +40,7 @@ const BASE_NODE_SIZE = {
     belief: 38,
     mode: 38,
     mode_session: 34,
+    flashcard: 36,
     report: 40,
     event_type: 32,
     emotion: 30,
@@ -250,6 +251,7 @@ export function buildKnowledgeGraph(userIds, query = {}) {
     const beliefs = filterOwnedEntities("belief_entry", listBeliefEntries(), userIds);
     const modes = filterOwnedEntities("mode_profile", listModeProfiles(), userIds);
     const modeSessions = filterOwnedEntities("mode_guide_session", listModeGuideSessions(), userIds);
+    const flashcards = filterOwnedEntities("flashcard", listFlashcards(), userIds);
     const reports = filterOwnedEntities("trigger_report", listTriggerReports(), userIds);
     const wikiSpaces = listWikiSpaces();
     const flows = listAiConnectors();
@@ -1155,6 +1157,90 @@ export function buildKnowledgeGraph(userIds, query = {}) {
             });
         }
     }
+    for (const flashcard of flashcards) {
+        nodes.set(buildKnowledgeGraphNodeId("flashcard", flashcard.id), makeNode({
+            entityType: "flashcard",
+            entityId: flashcard.id,
+            entityKind: "flashcard",
+            title: flashcard.title || truncate(flashcard.message, 72),
+            subtitle: flashcard.triggerSentence || flashcard.triggerSituation,
+            description: flashcard.message,
+            previewStats: [
+                { label: "Tags", value: flashcard.tags.length },
+                { label: "Values", value: flashcard.linkedValueIds.length },
+                { label: "Reports", value: flashcard.linkedReportIds.length }
+            ],
+            owner: flashcard,
+            href: getKnowledgeGraphEntityHref("flashcard", flashcard.id),
+            updatedAt: flashcard.updatedAt
+        }));
+        for (const linkedId of flashcard.linkedValueIds) {
+            addEdge(edges, {
+                source: buildKnowledgeGraphNodeId("flashcard", flashcard.id),
+                target: buildKnowledgeGraphNodeId("psyche_value", linkedId),
+                relationKind: "flashcard_value",
+                label: "Flashcard to value",
+                strength: 0.78,
+                directional: true,
+                structural: false
+            });
+        }
+        for (const linkedId of flashcard.linkedBehaviorIds) {
+            addEdge(edges, {
+                source: buildKnowledgeGraphNodeId("flashcard", flashcard.id),
+                target: buildKnowledgeGraphNodeId("behavior", linkedId),
+                relationKind: "flashcard_behavior",
+                label: "Flashcard to behavior",
+                strength: 0.76,
+                directional: true,
+                structural: false
+            });
+        }
+        for (const linkedId of flashcard.linkedPatternIds) {
+            addEdge(edges, {
+                source: buildKnowledgeGraphNodeId("flashcard", flashcard.id),
+                target: buildKnowledgeGraphNodeId("behavior_pattern", linkedId),
+                relationKind: "flashcard_pattern",
+                label: "Flashcard to pattern",
+                strength: 0.76,
+                directional: true,
+                structural: false
+            });
+        }
+        for (const linkedId of flashcard.linkedBeliefIds) {
+            addEdge(edges, {
+                source: buildKnowledgeGraphNodeId("flashcard", flashcard.id),
+                target: buildKnowledgeGraphNodeId("belief_entry", linkedId),
+                relationKind: "flashcard_belief",
+                label: "Flashcard to belief",
+                strength: 0.74,
+                directional: true,
+                structural: false
+            });
+        }
+        for (const linkedId of flashcard.linkedModeIds) {
+            addEdge(edges, {
+                source: buildKnowledgeGraphNodeId("flashcard", flashcard.id),
+                target: buildKnowledgeGraphNodeId("mode_profile", linkedId),
+                relationKind: "flashcard_mode",
+                label: "Flashcard to mode",
+                strength: 0.74,
+                directional: true,
+                structural: false
+            });
+        }
+        for (const linkedId of flashcard.linkedReportIds) {
+            addEdge(edges, {
+                source: buildKnowledgeGraphNodeId("flashcard", flashcard.id),
+                target: buildKnowledgeGraphNodeId("trigger_report", linkedId),
+                relationKind: "flashcard_report",
+                label: "Flashcard to report",
+                strength: 0.74,
+                directional: true,
+                structural: false
+            });
+        }
+    }
     for (const report of reports) {
         nodes.set(buildKnowledgeGraphNodeId("trigger_report", report.id), makeNode({
             entityType: "trigger_report",

package/dist/server/server/src/services/psyche-observation-calendar.js

@@ -25,6 +25,7 @@ const ACTIVITY_ENTITY_LABELS = {
     belief_entry: "Belief",
     mode_profile: "Mode",
     mode_guide_session: "Mode guide session",
+    flashcard: "Flashcard",
     trigger_report: "Trigger report",
     questionnaire_run: "Questionnaire run",
     event_type: "Event type",

package/dist/server/server/src/services/psyche.js

@@ -2,7 +2,7 @@ import { getDomainBySlug } from "../repositories/domains.js";
 import { listInsights } from "../repositories/collaboration.js";
 import { listNotes } from "../repositories/notes.js";
 import { filterOwnedEntities } from "../repositories/entity-ownership.js";
-import { listBehaviorPatterns, listBehaviors, listBeliefEntries, listModeProfiles, listPsycheValues, listSchemaCatalog, listTriggerReports } from "../repositories/psyche.js";
+import { listBehaviorPatterns, listBehaviors, listBeliefEntries, listFlashcards, listModeProfiles, listPsycheValues, listSchemaCatalog, listTriggerReports } from "../repositories/psyche.js";
 import { getDevrageMetricPayload } from "./devrage.js";
 import { psycheOverviewPayloadSchema } from "../psyche-types.js";
 const PSYCHE_ENTITY_TYPE_SET = new Set([
@@ -11,6 +11,7 @@ const PSYCHE_ENTITY_TYPE_SET = new Set([
     "behavior",
     "belief_entry",
     "mode_profile",
+    "flashcard",
     "trigger_report"
 ]);
 export function getPsycheOverview(userIds) {
@@ -23,6 +24,7 @@ export function getPsycheOverview(userIds) {
     const behaviors = filterOwnedEntities("behavior", listBehaviors(), userIds);
     const beliefs = filterOwnedEntities("belief_entry", listBeliefEntries(), userIds);
     const modes = filterOwnedEntities("mode_profile", listModeProfiles(), userIds);
+    const flashcards = filterOwnedEntities("flashcard", listFlashcards(), userIds);
     const reports = filterOwnedEntities("trigger_report", listTriggerReports(5), userIds);
     const schemaCatalog = listSchemaCatalog();
     const notes = filterOwnedEntities("note", listNotes({ limit: 200 }), userIds);
@@ -57,6 +59,7 @@ export function getPsycheOverview(userIds) {
         behaviors,
         beliefs,
         modes,
+        flashcards,
         reports,
         schemaPressure,
         devrageMetric,

package/dist/server/server/src/types.js

@@ -147,6 +147,7 @@ export const activityEntityTypeSchema = z.enum([
     "belief_entry",
     "mode_profile",
     "mode_guide_session",
+    "flashcard",
     "trigger_report",
     "preference_catalog",
     "preference_catalog_item",
@@ -362,6 +363,7 @@ export const crudEntityTypeSchema = z.enum([
     "belief_entry",
     "mode_profile",
     "mode_guide_session",
+    "flashcard",
     "event_type",
     "emotion_definition",
     "trigger_report",
@@ -387,6 +389,7 @@ export const rewardableEntityTypeSchema = z.enum([
     "behavior",
     "belief_entry",
     "mode_profile",
+    "flashcard",
     "trigger_report"
 ]);
 export const deleteModeSchema = z.enum(["soft", "hard"]);

package/dist/server/src/lib/api.js

@@ -725,6 +725,49 @@ export function deleteModeGuideSession(sessionId) {
         method: "DELETE"
     });
 }
+function readBatchEntity(result) {
+    if (result.ok !== true || !result.entity) {
+        const error = typeof result.error === "object" && result.error !== null
+            ? JSON.stringify(result.error)
+            : "Batch entity operation failed.";
+        throw new Error(error);
+    }
+    return result.entity;
+}
+export async function listFlashcards(userIds) {
+    const response = await searchEntities({
+        searches: [
+            {
+                entityTypes: ["flashcard"],
+                userIds: coerceUserIds(userIds),
+                limit: 500
+            }
+        ]
+    });
+    const matches = (response.results[0]?.matches ?? []);
+    return { flashcards: matches };
+}
+export async function createFlashcard(input) {
+    const response = await createEntities({
+        operations: [{ entityType: "flashcard", data: input }],
+        atomic: true
+    });
+    return { flashcard: readBatchEntity(response.results[0] ?? {}) };
+}
+export async function patchFlashcard(flashcardId, patch) {
+    const response = await updateEntities({
+        operations: [{ entityType: "flashcard", id: flashcardId, patch }],
+        atomic: true
+    });
+    return { flashcard: readBatchEntity(response.results[0] ?? {}) };
+}
+export async function deleteFlashcard(flashcardId) {
+    const response = await deleteEntities({
+        operations: [{ entityType: "flashcard", id: flashcardId }],
+        atomic: true
+    });
+    return { flashcard: readBatchEntity(response.results[0] ?? {}) };
+}
 export function listEventTypes() {
     return request("/api/v1/psyche/event-types");
 }

package/dist/server/src/lib/entity-visuals.js

@@ -20,6 +20,7 @@ export const ENTITY_KINDS = [
     "belief",
     "mode",
     "mode_session",
+    "flashcard",
     "report",
     "event_type",
     "emotion",
@@ -168,6 +169,13 @@ const ENTITY_VISUAL_SEEDS = [
         iconName: "Compass",
         accentRgb: [192, 132, 252]
     },
+    {
+        kind: "flashcard",
+        label: "Flashcard",
+        icon: PanelTop,
+        iconName: "PanelTop",
+        accentRgb: [20, 184, 166]
+    },
     {
         kind: "report",
         label: "Report",
@@ -257,6 +265,7 @@ const CRUD_ENTITY_KIND_MAP = {
     belief_entry: "belief",
     mode_profile: "mode",
     mode_guide_session: "mode_session",
+    flashcard: "flashcard",
     event_type: "event_type",
     emotion_definition: "emotion",
     trigger_report: "report"

package/dist/server/src/lib/knowledge-graph-types.js

@@ -64,6 +64,11 @@ export const KNOWLEDGE_GRAPH_HIERARCHY_LANES = [
         label: "Modes / Mode Sessions",
         kinds: ["mode", "mode_session"]
     },
+    {
+        id: "flashcards",
+        label: "Flashcards",
+        kinds: ["flashcard"]
+    },
     {
         id: "reports",
         label: "Reports / Event Types / Emotions",
@@ -110,6 +115,12 @@ export const KNOWLEDGE_GRAPH_RELATION_LABELS = {
     mode_pattern: "Mode to pattern",
     mode_behavior: "Mode to behavior",
     mode_value: "Mode to value",
+    flashcard_value: "Flashcard to value",
+    flashcard_behavior: "Flashcard to behavior",
+    flashcard_pattern: "Flashcard to pattern",
+    flashcard_belief: "Flashcard to belief",
+    flashcard_mode: "Flashcard to mode",
+    flashcard_report: "Flashcard to report",
     report_value: "Report to value",
     report_pattern: "Report to pattern",
     report_goal: "Report to goal",
@@ -165,6 +176,12 @@ export const KNOWLEDGE_GRAPH_RELATION_FAMILY_MAP = {
     mode_pattern: "contextual",
     mode_behavior: "contextual",
     mode_value: "contextual",
+    flashcard_value: "contextual",
+    flashcard_behavior: "contextual",
+    flashcard_pattern: "contextual",
+    flashcard_belief: "contextual",
+    flashcard_mode: "contextual",
+    flashcard_report: "contextual",
     report_value: "contextual",
     report_pattern: "contextual",
     report_goal: "contextual",
@@ -234,6 +251,8 @@ export function getKnowledgeGraphEntityHref(entityType, entityId, options) {
             return `/psyche/modes?focus=${encodeURIComponent(entityId)}`;
         case "mode_guide_session":
             return `/psyche/modes`;
+        case "flashcard":
+            return `/psyche/flashcards?focus=${encodeURIComponent(entityId)}`;
         case "trigger_report":
             return `/psyche/reports/${encodeURIComponent(entityId)}`;
         case "note":