forge-openclaw-plugin 0.2.26 → 0.2.27

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

@@ -0,0 +1,279 @@
+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";
+export const ENTITY_KINDS = [
+    "goal",
+    "project",
+    "task",
+    "strategy",
+    "habit",
+    "tag",
+    "note",
+    "wiki_page",
+    "wiki_space",
+    "insight",
+    "calendar_event",
+    "work_block",
+    "timebox",
+    "value",
+    "pattern",
+    "behavior",
+    "belief",
+    "mode",
+    "mode_session",
+    "report",
+    "event_type",
+    "emotion",
+    "workbench",
+    "functor",
+    "chat"
+];
+const ENTITY_VISUAL_SEEDS = [
+    {
+        kind: "goal",
+        label: "Goal",
+        icon: Target,
+        iconName: "Target",
+        accentRgb: [251, 191, 36]
+    },
+    {
+        kind: "project",
+        label: "Project",
+        icon: FolderOpen,
+        iconName: "FolderOpen",
+        accentRgb: [56, 189, 248]
+    },
+    {
+        kind: "task",
+        label: "Task",
+        icon: ListTodo,
+        iconName: "ListTodo",
+        accentRgb: [129, 140, 248]
+    },
+    {
+        kind: "strategy",
+        label: "Strategy",
+        icon: GitBranch,
+        iconName: "GitBranch",
+        accentRgb: [34, 211, 238]
+    },
+    {
+        kind: "habit",
+        label: "Habit",
+        icon: RefreshCw,
+        iconName: "RefreshCw",
+        accentRgb: [45, 212, 191]
+    },
+    {
+        kind: "tag",
+        label: "Tag",
+        icon: PanelTop,
+        iconName: "PanelTop",
+        accentRgb: [163, 230, 53]
+    },
+    {
+        kind: "note",
+        label: "Note",
+        icon: NotebookPen,
+        iconName: "NotebookPen",
+        accentRgb: [148, 163, 184]
+    },
+    {
+        kind: "wiki_page",
+        label: "Wiki Page",
+        icon: StickyNote,
+        iconName: "StickyNote",
+        accentRgb: [125, 211, 252]
+    },
+    {
+        kind: "wiki_space",
+        label: "Wiki Space",
+        icon: Network,
+        iconName: "Network",
+        accentRgb: [99, 102, 241]
+    },
+    {
+        kind: "insight",
+        label: "Insight",
+        icon: Sparkles,
+        iconName: "Sparkles",
+        accentRgb: [244, 63, 94]
+    },
+    {
+        kind: "calendar_event",
+        label: "Calendar Event",
+        icon: CalendarDays,
+        iconName: "CalendarDays",
+        accentRgb: [14, 165, 233]
+    },
+    {
+        kind: "work_block",
+        label: "Work Block",
+        icon: PanelTop,
+        iconName: "PanelTop",
+        accentRgb: [16, 185, 129]
+    },
+    {
+        kind: "timebox",
+        label: "Timebox",
+        icon: Timer,
+        iconName: "Timer",
+        accentRgb: [244, 114, 182]
+    },
+    {
+        kind: "value",
+        label: "Value",
+        icon: Heart,
+        iconName: "Heart",
+        accentRgb: [52, 211, 153]
+    },
+    {
+        kind: "pattern",
+        label: "Pattern",
+        icon: Repeat,
+        iconName: "Repeat",
+        accentRgb: [251, 113, 133]
+    },
+    {
+        kind: "behavior",
+        label: "Behavior",
+        icon: Route,
+        iconName: "Route",
+        accentRgb: [251, 146, 60]
+    },
+    {
+        kind: "belief",
+        label: "Belief",
+        icon: Quote,
+        iconName: "Quote",
+        accentRgb: [167, 139, 250]
+    },
+    {
+        kind: "mode",
+        label: "Mode",
+        icon: Shapes,
+        iconName: "Shapes",
+        accentRgb: [217, 70, 239]
+    },
+    {
+        kind: "mode_session",
+        label: "Mode Session",
+        icon: Compass,
+        iconName: "Compass",
+        accentRgb: [192, 132, 252]
+    },
+    {
+        kind: "report",
+        label: "Report",
+        icon: FileText,
+        iconName: "FileText",
+        accentRgb: [96, 165, 250]
+    },
+    {
+        kind: "event_type",
+        label: "Event Type",
+        icon: CalendarDays,
+        iconName: "CalendarDays",
+        accentRgb: [45, 212, 191]
+    },
+    {
+        kind: "emotion",
+        label: "Emotion",
+        icon: Heart,
+        iconName: "Heart",
+        accentRgb: [248, 113, 113]
+    },
+    {
+        kind: "workbench",
+        label: "Workbench",
+        icon: Workflow,
+        iconName: "Workflow",
+        accentRgb: [45, 212, 191]
+    },
+    {
+        kind: "functor",
+        label: "Functor",
+        icon: Sparkles,
+        iconName: "Sparkles",
+        accentRgb: [250, 204, 21]
+    },
+    {
+        kind: "chat",
+        label: "Chat",
+        icon: Bot,
+        iconName: "Bot",
+        accentRgb: [129, 140, 248]
+    }
+];
+function toHex(rgb) {
+    return `#${rgb.map((value) => value.toString(16).padStart(2, "0")).join("")}`;
+}
+function toRgbaVar(kind, rgb, alpha) {
+    return `rgba(var(--forge-entity-${kind}-rgb,${rgb.join(",")}),${alpha})`;
+}
+function createEntityVisual(seed) {
+    return {
+        kind: seed.kind,
+        label: seed.label,
+        icon: seed.icon,
+        iconName: seed.iconName,
+        colorToken: {
+            cssVariable: `--forge-entity-${seed.kind}-rgb`,
+            rgb: seed.accentRgb,
+            hex: toHex(seed.accentRgb)
+        },
+        iconClassName: `text-[${toRgbaVar(seed.kind, seed.accentRgb, 0.96)}]`,
+        nameClassName: `text-[${toRgbaVar(seed.kind, seed.accentRgb, 0.96)}]`,
+        badgeClassName: `border-[${toRgbaVar(seed.kind, seed.accentRgb, 0.24)}] ` +
+            `bg-[linear-gradient(135deg,${toRgbaVar(seed.kind, seed.accentRgb, 0.24)},${toRgbaVar(seed.kind, seed.accentRgb, 0.08)})] text-white`,
+        subtleBadgeClassName: `border-[${toRgbaVar(seed.kind, seed.accentRgb, 0.18)}] ` +
+            `bg-[${toRgbaVar(seed.kind, seed.accentRgb, 0.08)}] text-[${toRgbaVar(seed.kind, seed.accentRgb, 0.92)}]`,
+        buttonClassName: `border-[${toRgbaVar(seed.kind, seed.accentRgb, 0.2)}] ` +
+            `bg-[${toRgbaVar(seed.kind, seed.accentRgb, 0.12)}] text-white hover:bg-[${toRgbaVar(seed.kind, seed.accentRgb, 0.18)}]`
+    };
+}
+const ENTITY_VISUALS = Object.fromEntries(ENTITY_VISUAL_SEEDS.map((seed) => [seed.kind, createEntityVisual(seed)]));
+const CRUD_ENTITY_KIND_MAP = {
+    goal: "goal",
+    project: "project",
+    task: "task",
+    strategy: "strategy",
+    habit: "habit",
+    tag: "tag",
+    note: "note",
+    insight: "insight",
+    calendar_event: "calendar_event",
+    work_block_template: "work_block",
+    task_timebox: "timebox",
+    psyche_value: "value",
+    behavior_pattern: "pattern",
+    behavior: "behavior",
+    belief_entry: "belief",
+    mode_profile: "mode",
+    mode_guide_session: "mode_session",
+    event_type: "event_type",
+    emotion_definition: "emotion",
+    trigger_report: "report"
+};
+export function getEntityVisual(kind) {
+    return ENTITY_VISUALS[kind];
+}
+export function getEntityVisualCatalog() {
+    return ENTITY_KINDS.map((kind) => getEntityVisual(kind));
+}
+export function isEntityKind(value) {
+    return ENTITY_KINDS.includes(value);
+}
+export function getEntityKindForCrudEntityType(entityType, options) {
+    if (entityType === "note" && options?.noteKind === "wiki") {
+        return "wiki_page";
+    }
+    return CRUD_ENTITY_KIND_MAP[entityType] ?? null;
+}
+export function getEntityKindForWorkbenchFlowKind(kind) {
+    return kind === "chat" ? "chat" : "functor";
+}
+export function getEntityButtonClassName(kind, selected) {
+    const visual = getEntityVisual(kind);
+    return selected
+        ? `border ${visual.buttonClassName}`
+        : "border border-white/8 bg-white/[0.05] text-white/62 hover:bg-white/[0.08] hover:text-white";
+}

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

@@ -0,0 +1,276 @@
+export const KNOWLEDGE_GRAPH_HIERARCHY_LANES = [
+    {
+        id: "goals",
+        label: "Goals",
+        kinds: ["goal"]
+    },
+    {
+        id: "strategies",
+        label: "Strategies",
+        kinds: ["strategy"]
+    },
+    {
+        id: "projects",
+        label: "Projects",
+        kinds: ["project"]
+    },
+    {
+        id: "tasks",
+        label: "Tasks",
+        kinds: ["task"]
+    },
+    {
+        id: "wiki-spaces",
+        label: "Wiki Spaces",
+        kinds: ["wiki_space"]
+    },
+    {
+        id: "knowledge",
+        label: "Wiki Pages / Notes",
+        kinds: ["wiki_page", "note"]
+    },
+    {
+        id: "support",
+        label: "Habits / Insights / Tags",
+        kinds: ["habit", "insight", "tag"]
+    },
+    {
+        id: "calendar",
+        label: "Calendar",
+        kinds: ["calendar_event", "work_block", "timebox"]
+    },
+    {
+        id: "values",
+        label: "Values",
+        kinds: ["value"]
+    },
+    {
+        id: "patterns",
+        label: "Patterns",
+        kinds: ["pattern"]
+    },
+    {
+        id: "behaviors",
+        label: "Behaviors",
+        kinds: ["behavior"]
+    },
+    {
+        id: "beliefs",
+        label: "Beliefs",
+        kinds: ["belief"]
+    },
+    {
+        id: "modes",
+        label: "Modes / Mode Sessions",
+        kinds: ["mode", "mode_session"]
+    },
+    {
+        id: "reports",
+        label: "Reports / Event Types / Emotions",
+        kinds: ["report", "event_type", "emotion"]
+    },
+    {
+        id: "workbench",
+        label: "Workbench / Functors / Chats",
+        kinds: ["workbench", "functor", "chat"]
+    }
+];
+export const KNOWLEDGE_GRAPH_HIERARCHY_ORDER = KNOWLEDGE_GRAPH_HIERARCHY_LANES.flatMap((lane) => [...lane.kinds]);
+export const KNOWLEDGE_GRAPH_RELATION_LABELS = {
+    goal_project: "Goal to project",
+    goal_task: "Goal to task",
+    project_task: "Project to task",
+    tag_goal: "Tag to goal",
+    tag_task: "Tag to task",
+    tag_strategy: "Tag to strategy",
+    value_goal: "Value to goal",
+    value_project: "Value to project",
+    value_task: "Value to task",
+    strategy_target: "Strategy target",
+    strategy_step: "Strategy step",
+    strategy_link: "Strategy context",
+    habit_link: "Habit link",
+    note_link: "Note link",
+    wiki_parent: "Wiki parent",
+    wiki_link: "Wiki link",
+    calendar_link: "Calendar link",
+    timebox_task: "Timebox to task",
+    timebox_project: "Timebox to project",
+    pattern_value: "Pattern to value",
+    pattern_belief: "Pattern to belief",
+    pattern_mode: "Pattern to mode",
+    behavior_pattern: "Behavior to pattern",
+    behavior_value: "Behavior to value",
+    behavior_belief: "Behavior to belief",
+    behavior_mode: "Behavior to mode",
+    belief_value: "Belief to value",
+    belief_behavior: "Belief to behavior",
+    belief_mode: "Belief to mode",
+    belief_report: "Belief to report",
+    mode_pattern: "Mode to pattern",
+    mode_behavior: "Mode to behavior",
+    mode_value: "Mode to value",
+    report_value: "Report to value",
+    report_pattern: "Report to pattern",
+    report_goal: "Report to goal",
+    report_project: "Report to project",
+    report_task: "Report to task",
+    report_behavior: "Report to behavior",
+    report_belief: "Report to belief",
+    report_mode: "Report to mode",
+    report_event_type: "Report to event type",
+    report_emotion: "Report to emotion",
+    mode_session_mode: "Mode session to mode",
+    workbench_flow: "Workbench flow",
+    workbench_surface: "Workbench surface",
+    workbench_route: "Workbench route"
+};
+export const KNOWLEDGE_GRAPH_RELATION_FAMILY_LABELS = {
+    structural: "Structure",
+    contextual: "Context",
+    taxonomy: "Taxonomy",
+    workspace: "Workspace"
+};
+export const KNOWLEDGE_GRAPH_RELATION_FAMILY_MAP = {
+    goal_project: "structural",
+    goal_task: "structural",
+    project_task: "structural",
+    tag_goal: "taxonomy",
+    tag_task: "taxonomy",
+    tag_strategy: "taxonomy",
+    value_goal: "contextual",
+    value_project: "contextual",
+    value_task: "contextual",
+    strategy_target: "structural",
+    strategy_step: "structural",
+    strategy_link: "contextual",
+    habit_link: "contextual",
+    note_link: "contextual",
+    wiki_parent: "structural",
+    wiki_link: "contextual",
+    calendar_link: "contextual",
+    timebox_task: "structural",
+    timebox_project: "contextual",
+    pattern_value: "contextual",
+    pattern_belief: "contextual",
+    pattern_mode: "contextual",
+    behavior_pattern: "structural",
+    behavior_value: "contextual",
+    behavior_belief: "contextual",
+    behavior_mode: "contextual",
+    belief_value: "contextual",
+    belief_behavior: "contextual",
+    belief_mode: "contextual",
+    belief_report: "contextual",
+    mode_pattern: "contextual",
+    mode_behavior: "contextual",
+    mode_value: "contextual",
+    report_value: "contextual",
+    report_pattern: "contextual",
+    report_goal: "contextual",
+    report_project: "contextual",
+    report_task: "contextual",
+    report_behavior: "contextual",
+    report_belief: "contextual",
+    report_mode: "contextual",
+    report_event_type: "taxonomy",
+    report_emotion: "taxonomy",
+    mode_session_mode: "taxonomy",
+    workbench_flow: "workspace",
+    workbench_surface: "workspace",
+    workbench_route: "workspace"
+};
+export function buildKnowledgeGraphNodeId(entityType, entityId) {
+    return `${entityType}:${entityId}`;
+}
+export function parseKnowledgeGraphFocusValue(value) {
+    if (!value) {
+        return null;
+    }
+    const separatorIndex = value.indexOf(":");
+    if (separatorIndex <= 0 || separatorIndex >= value.length - 1) {
+        return null;
+    }
+    return {
+        entityType: value.slice(0, separatorIndex),
+        entityId: value.slice(separatorIndex + 1)
+    };
+}
+export function formatKnowledgeGraphFocusValue(entityType, entityId) {
+    return `${entityType}:${entityId}`;
+}
+export function getKnowledgeGraphEntityHref(entityType, entityId, options) {
+    switch (entityType) {
+        case "goal":
+            return `/goals/${entityId}`;
+        case "project":
+            return `/projects/${entityId}`;
+        case "task":
+            return `/tasks/${entityId}`;
+        case "strategy":
+            return `/strategies/${entityId}`;
+        case "habit":
+            return `/habits?focus=${encodeURIComponent(entityId)}`;
+        case "tag":
+            return `/tags?focus=${encodeURIComponent(entityId)}`;
+        case "insight":
+            return `/insights`;
+        case "calendar_event":
+        case "work_block_template":
+        case "task_timebox":
+            return `/calendar`;
+        case "event_type":
+        case "emotion_definition":
+            return "/psyche/reports";
+        case "psyche_value":
+            return `/psyche/values?focus=${encodeURIComponent(entityId)}#values-atlas`;
+        case "behavior_pattern":
+            return `/psyche/patterns?focus=${encodeURIComponent(entityId)}#pattern-lanes`;
+        case "behavior":
+            return `/psyche/behaviors?focus=${encodeURIComponent(entityId)}#behavior-columns`;
+        case "belief_entry":
+            return `/psyche/schemas-beliefs?focus=${encodeURIComponent(entityId)}`;
+        case "mode_profile":
+            return `/psyche/modes?focus=${encodeURIComponent(entityId)}`;
+        case "mode_guide_session":
+            return `/psyche/modes`;
+        case "trigger_report":
+            return `/psyche/reports/${encodeURIComponent(entityId)}`;
+        case "note":
+            if (options?.noteKind === "wiki" && options.noteSlug) {
+                const search = options.noteSpaceId && options.noteSpaceId.trim().length > 0
+                    ? `?spaceId=${encodeURIComponent(options.noteSpaceId)}`
+                    : "";
+                return `/wiki/page/${encodeURIComponent(options.noteSlug)}${search}`;
+            }
+            return `/notes?entityType=note&entityId=${encodeURIComponent(entityId)}`;
+        case "wiki_space":
+            return `/wiki?spaceId=${encodeURIComponent(entityId)}`;
+        case "workbench_flow":
+            return `/workbench/${encodeURIComponent(entityId)}`;
+        case "workbench_surface":
+            return entityId === "workbench"
+                ? "/workbench"
+                : `/workbench?surface=${encodeURIComponent(entityId)}`;
+        default:
+            return null;
+    }
+}
+export function buildKnowledgeGraphFocusHref(entityType, entityId, options) {
+    const search = new URLSearchParams();
+    search.set("focus", formatKnowledgeGraphFocusValue(entityType, entityId));
+    if (options?.view && options.view !== "graph") {
+        search.set("view", options.view);
+    }
+    if (options?.query?.trim()) {
+        search.set("q", options.query.trim());
+    }
+    for (const kind of options?.kinds ?? []) {
+        search.append("kind", kind);
+    }
+    for (const relation of options?.relations ?? []) {
+        search.append("relation", relation);
+    }
+    const query = search.toString();
+    return query.length > 0 ? `/knowledge-graph?${query}` : "/knowledge-graph";
+}