ofiere-openclaw-plugin 2.0.0 → 3.2.0

package/README.md

@@ -1,42 +1,27 @@
 # Ofiere PM Plugin for OpenClaw
 
-Manage your Ofiere PM dashboard directly from OpenClaw agents. Create tasks, update progress, assign agents — all synced to the dashboard in real time.
+Manage your Ofiere PM dashboard directly from OpenClaw agents. Create tasks, manage projects, build workflows, store knowledge — all synced to the dashboard in real time.
 
-## Install
+## Quick Install (One-Click)
 
 ```bash
-openclaw plugins install @ofiere-ai/openclaw-plugin
+curl -sSL https://raw.githubusercontent.com/gilanggemar/Ofiere/main/ofiere-openclaw-plugin/install.sh | bash -s -- \
+  --supabase-url "https://xxx.supabase.co" \
+  --service-key "eyJ..." \
+  --user-id "your-uuid"
 ```
 
-Or install from the local repo (for development):
+Only 3 parameters needed. All agents get the plugin automatically.
 
-```bash
-openclaw plugins install ./ofiere-openclaw-plugin
-```
-
-Restart OpenClaw after installing.
-
-## Setup
-
-```bash
-openclaw ofiere setup --supabase-url "https://xxx.supabase.co" --service-key "eyJ..." --user-id "your-uuid" --agent-id "sasha"
-```
-
-Or run interactively:
+## Uninstall
 
 ```bash
-openclaw ofiere setup
+curl -sSL https://raw.githubusercontent.com/gilanggemar/Ofiere/main/ofiere-openclaw-plugin/uninstall.sh | bash
 ```
 
-Then restart the gateway:
-
-```bash
-openclaw gateway restart
-```
+## How It Works
 
-## How it works
-
-Once configured, the plugin connects to your Supabase database at gateway startup and registers PM tools directly into the agent. There's no separate MCP server process — it runs inside the OpenClaw gateway for maximum reliability.
+Once configured, the plugin connects to your Supabase database at gateway startup and registers 9 PM meta-tools directly into the agent. There's no separate MCP server process — it runs inside the OpenClaw gateway for maximum reliability.
 
 Changes made by the agent are immediately visible on the Ofiere dashboard (Vercel) via Supabase real-time subscriptions.
 
@@ -46,20 +31,38 @@ The plugin uses a scalable meta-tool architecture. Each tool handles one domain
 
 | Tool | Actions | Description |
 |---|---|---|
-| `OFIERE_TASK_OPS` | `list`, `create`, `update`, `delete` | Manage PM tasks — list, create, update status/priority, delete |
+| `OFIERE_TASK_OPS` | `list`, `create`, `update`, `delete` | Rich task management with execution plans, goals, constraints |
 | `OFIERE_AGENT_OPS` | `list` | Query available agents for task assignment |
+| `OFIERE_PROJECT_OPS` | `list_spaces`, `create_space`, `create_folder`, `bulk_create_tasks`, etc. | Full project hierarchy: spaces → folders → tasks |
+| `OFIERE_SCHEDULE_OPS` | `list`, `create`, `update`, `delete` | Calendar events with recurrence |
+| `OFIERE_KNOWLEDGE_OPS` | `search`, `list`, `create`, `update`, `delete` | Knowledge library with full content retrieval |
+| `OFIERE_WORKFLOW_OPS` | `list`, `get`, `create`, `update`, `delete`, `list_runs`, `trigger` | Visual workflow builder with 16 node types |
+| `OFIERE_NOTIFY_OPS` | `list`, `mark_read`, `create` | In-app notifications |
+| `OFIERE_MEMORY_OPS` | `list_conversations`, `search_knowledge` | Conversation history & agent memory |
+| `OFIERE_PROMPT_OPS` | `list`, `get`, `create`, `update`, `delete` | System prompt chunk management |
 
 ### Example
 
 ```
-// Create a task
-OFIERE_TASK_OPS({ action: "create", title: "Deploy v2", agent_id: "ivy" })
-
-// List tasks
-OFIERE_TASK_OPS({ action: "list", status: "PENDING", limit: 10 })
-
-// Update a task
-OFIERE_TASK_OPS({ action: "update", task_id: "task-123", status: "DONE" })
+// Create a task with execution plan
+OFIERE_TASK_OPS({ action: "create", title: "Deploy v2", agent_id: "ivy",
+  execution_plan: [{ step: 1, action: "Build", detail: "Run production build" }] })
+
+// Create a workflow with nodes
+OFIERE_WORKFLOW_OPS({ action: "create", name: "Deploy Pipeline",
+  nodes: [
+    { type: "agent_step", data: { label: "Build", task: "Run npm build" } },
+    { type: "human_approval", data: { label: "Review", instructions: "Check build output" } },
+    { type: "output", data: { label: "Done" } }
+  ],
+  edges: [
+    { source: "agent_step-...", target: "human_approval-..." },
+    { source: "human_approval-...", target: "output-..." }
+  ]
+})
+
+// Search knowledge library
+OFIERE_KNOWLEDGE_OPS({ action: "search", query: "API rate limits" })
 ```
 
 ## CLI Commands
@@ -79,7 +82,7 @@ Set via `openclaw ofiere setup` or environment variables:
 | `supabaseUrl` | `OFIERE_SUPABASE_URL` | Supabase project URL |
 | `serviceRoleKey` | `OFIERE_SERVICE_ROLE_KEY` | Supabase service role key |
 | `userId` | `OFIERE_USER_ID` | Your user UUID |
-| `agentId` | `OFIERE_AGENT_ID` | This agent's ID (e.g. `sasha`) |
+| `agentId` | `OFIERE_AGENT_ID` | This agent's ID (optional — auto-detected) |
 | `enabled` | — | Enable/disable the plugin (default: `true`) |
 
 ## Architecture

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "ofiere-openclaw-plugin",
-  "version": "2.0.0",
+  "version": "3.2.0",
   "type": "module",
-  "description": "OpenClaw plugin for Ofiere PM — scalable meta-tool architecture for task, agent, and project management",
+  "description": "OpenClaw plugin for Ofiere PM — 9 meta-tools covering tasks, agents, projects, scheduling, knowledge, workflows, notifications, memory, and prompts",
   "keywords": ["openclaw", "ofiere", "project-management", "agents", "plugin"],
   "homepage": "https://github.com/gilanggemar/Ofiere",
   "repository": {

package/src/prompt.ts

@@ -10,30 +10,66 @@
 
 const TOOL_DOCS: Record<string, string> = {
   OFIERE_TASK_OPS: `- **OFIERE_TASK_OPS** — Manage tasks (action: "list", "create", "update", "delete")
-    - list: Filter by status, agent_id, space_id, folder_id, limit
-    - create: Requires title + agent_id. Pass your name to self-assign, 'none' for unassigned
-    - update: Requires task_id. Change title, status, priority, progress, etc.
+    - list: Filter by status, agent_id, space_id, folder_id, limit. Returns execution_plan, goals, constraints if present
+    - create: Requires title. IMPORTANT: Always pass agent_id with your own name to self-assign (e.g. agent_id: "celia")
+      - Optional: description, instructions, execution_plan, goals, constraints, system_prompt, priority, tags, dates
+      - For COMPLEX tasks: include execution_plan (step-by-step), goals, constraints, and system_prompt
+      - For SIMPLE tasks: just title and optionally description
+    - update: Requires task_id. All create fields + progress
     - delete: Requires task_id. Removes task and subtasks`,
 
   OFIERE_AGENT_OPS: `- **OFIERE_AGENT_OPS** — Query agents (action: "list")
     - list: See all agents with IDs, names, roles for task assignment`,
 
-  // ── Future meta-tools — uncomment when registered ──
-  // OFIERE_PROJECT_OPS: `- **OFIERE_PROJECT_OPS** — Manage projects (action: "list", "create", "update", "delete")
-  //   - list: List spaces, folders, and projects
-  //   - create: Create a new space or folder
-  //   - update: Rename, move, or archive
-  //   - delete: Remove space/folder and reassign tasks`,
-  //
-  // OFIERE_SCHEDULE_OPS: `- **OFIERE_SCHEDULE_OPS** — Calendar & timeline (action: "list", "schedule", "reschedule")
-  //   - list: View scheduled events for a date range
-  //   - schedule: Assign a task to a time slot
-  //   - reschedule: Move an event to a new time`,
-  //
-  // OFIERE_KNOWLEDGE_OPS: `- **OFIERE_KNOWLEDGE_OPS** — Knowledge base (action: "search", "create", "update")
-  //   - search: Find knowledge entries by query
-  //   - create: Add a new knowledge entry
-  //   - update: Edit an existing entry`,
+  OFIERE_PROJECT_OPS: `- **OFIERE_PROJECT_OPS** — Manage PM hierarchy (action: "list_spaces", "create_space", "update_space", "delete_space", "list_folders", "create_folder", "update_folder", "delete_folder", "list_dependencies", "add_dependency", "remove_dependency")
+    - Spaces: Top-level containers. CRUD with name, icon, icon_color
+    - Folders: Live inside spaces. Can nest via parent_folder_id. Types: folder, project
+    - Dependencies: Link tasks with predecessor/successor relationships
+      - Types: finish_to_start (default), start_to_start, finish_to_finish, start_to_finish
+      - lag_days: optional delay between linked tasks`,
+
+  OFIERE_SCHEDULE_OPS: `- **OFIERE_SCHEDULE_OPS** — Calendar events (action: "list", "create", "update", "delete")
+    - list: Filter by start_date, end_date, agent_id
+    - create: Requires title + scheduled_date (YYYY-MM-DD). Optional: scheduled_time, duration_minutes, task_id, agent_id, recurrence_type, color
+    - Recurrence: none, hourly, daily, weekly, monthly with interval`,
+
+  OFIERE_KNOWLEDGE_OPS: `- **OFIERE_KNOWLEDGE_OPS** — Ofiere Knowledge Library (action: "search", "list", "create", "update", "delete")
+    - ALWAYS use this tool when the user mentions "knowledge base", "knowledge library", "knowledge entries", or asks to recall/retrieve stored knowledge
+    - search: Keyword search across all stored documents. Requires: query
+    - list: Paginated listing of knowledge entries with full content. Optional: search filter
+    - create: Add knowledge to the library. Requires: file_name. Optional: content, source, author, credibility_tier
+    - update/delete: By document ID`,
+
+  OFIERE_WORKFLOW_OPS: `- **OFIERE_WORKFLOW_OPS** — Automated workflows (action: "list", "get", "create", "update", "delete", "list_runs", "trigger")
+    - list: All workflows, filter by status (draft, active, paused, archived)
+    - get: Full workflow details by ID
+    - create: New workflow with name + nodes and edges
+      - Node types: manual_trigger, agent_step, http_request, formatter_step, task_call, variable_set, condition, human_approval, delay, loop, convergence, output, checkpoint, note
+      - Each node: { type, data: { label, ...type-specific fields } }. IDs/positions auto-generated
+      - Edges: { source, target }. A manual_trigger is auto-prepended if no trigger exists
+    - update: Modify workflow (name, description, status, nodes, edges)
+    - delete: Remove workflow and all run history
+    - list_runs: Recent execution history for a workflow
+    - trigger: Start a workflow run (creates a run record)`,
+
+  OFIERE_NOTIFY_OPS: `- **OFIERE_NOTIFY_OPS** — Notifications (action: "list", "mark_read", "mark_all_read", "delete")
+    - list: Recent notifications. unread_only=true for unread only
+    - mark_read: Mark one notification read by ID
+    - mark_all_read: Mark all as read`,
+
+  OFIERE_MEMORY_OPS: `- **OFIERE_MEMORY_OPS** — Conversation history & knowledge memory (action: "list_conversations", "get_messages", "search_messages", "add_knowledge", "search_knowledge")
+    - list_conversations: Recent chats, filter by agent_id
+    - get_messages: Full message history for a conversation
+    - search_messages: Search across all messages by keyword
+    - add_knowledge: Store a knowledge fragment (requires agent_id, content, source)
+    - search_knowledge: Search stored knowledge for an agent`,
+
+  OFIERE_PROMPT_OPS: `- **OFIERE_PROMPT_OPS** — Manage prompt instruction chunks (action: "list", "get", "create", "update", "delete")
+    - list: All prompt chunks ordered by display order
+    - create: New chunk with name (max 30 chars) + content. Optional: color (hex), category
+    - update: Change name, content, color, category, or order
+    - delete: Remove a chunk by ID
+    - All modifications are logged for audit`,
 };
 
 export function getSystemPrompt(state: {
@@ -65,6 +101,7 @@ Each tool uses an "action" parameter to select the operation. Always include act
 ${toolDocs}
 
 ## Rules
+- ALWAYS pass agent_id with your own name when creating tasks (e.g. agent_id: "ivy"). Auto-detection is NOT reliable.
 - ${assignRule}
 - To create an unassigned task, pass agent_id as "none" or "unassigned".
 - When the user says "create a task for [agent name]", use OFIERE_AGENT_OPS action:"list" to find the agent ID, then use OFIERE_TASK_OPS action:"create" with that agent_id.
@@ -73,6 +110,10 @@ ${toolDocs}
 - Priority levels: 0=LOW, 1=MEDIUM, 2=HIGH, 3=CRITICAL.
 - Changes appear in the Ofiere dashboard immediately via real-time sync.
 - Do NOT fabricate task IDs — use OFIERE_TASK_OPS action:"list" to look up real IDs.
+- For complex tasks, ALWAYS include execution_plan, goals, and constraints. For simple tasks, just title is enough.
+- When creating dependencies, use OFIERE_PROJECT_OPS to link predecessor/successor tasks.
+- Prompt chunk modifications (OFIERE_PROMPT_OPS) are powerful — use thoughtfully as they change agent behavior.
+- When the user asks about "knowledge base", "knowledge library", "knowledge entries", or wants to recall stored knowledge, ALWAYS use OFIERE_KNOWLEDGE_OPS — do NOT rely on your own memory for this.
 </ofiere-pm>`;
   }