ofiere-openclaw-plugin 4.3.1 → 4.4.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ofiere-openclaw-plugin",
-  "version": "4.3.1",
+  "version": "4.4.1",
   "type": "module",
   "description": "OpenClaw plugin for Ofiere PM - 10 meta-tools with 13-action workflow mastery covering tasks, agents, projects, scheduling, knowledge, workflows, notifications, memory, prompts, and constellation agent architecture",
   "keywords": ["openclaw", "ofiere", "project-management", "agents", "plugin"],

package/src/tools.ts

@@ -2098,8 +2098,11 @@ function registerConstellationOps(
     return path.join(OPENCLAW_ROOT, `workspace-${agentName.toLowerCase()}`);
   }
 
-  function listWorkspaceAgents(): Array<{ name: string; codename: string; role: string; files: string[]; hasSkills: boolean }> {
-    const result: Array<{ name: string; codename: string; role: string; files: string[]; hasSkills: boolean }> = [];
+  // System-generated .md files that OpenClaw creates automatically — not user-authored
+  const SYSTEM_MD_FILES = new Set(["HEARTBEAT.md", "USER.md", "MEMORY.md"]);
+
+  function listWorkspaceAgents(): Array<{ name: string; codename: string; role: string; files: string[]; system_files: string[]; hasSkills: boolean }> {
+    const result: Array<{ name: string; codename: string; role: string; files: string[]; system_files: string[]; hasSkills: boolean }> = [];
     try {
       const entries = fs.readdirSync(OPENCLAW_ROOT, { withFileTypes: true });
       for (const entry of entries) {
@@ -2107,7 +2110,9 @@ function registerConstellationOps(
         const agentName = entry.name.replace("workspace-", "");
         if (agentName === "main" || agentName === "zero" || agentName === "echo") continue; // skip system agents
         const wsPath = path.join(OPENCLAW_ROOT, entry.name);
-        const files = fs.readdirSync(wsPath).filter((f: string) => f.endsWith(".md"));
+        const allMd = fs.readdirSync(wsPath).filter((f: string) => f.endsWith(".md"));
+        const files = allMd.filter((f: string) => !SYSTEM_MD_FILES.has(f));
+        const system_files = allMd.filter((f: string) => SYSTEM_MD_FILES.has(f));
         // Try to extract codename and role from IDENTITY.md
         let codename = agentName.toUpperCase();
         let role = "Agent";
@@ -2119,7 +2124,7 @@ function registerConstellationOps(
           if (roleMatch) role = roleMatch[1].trim();
         } catch {}
         const hasSkills = fs.existsSync(path.join(wsPath, "skills"));
-        result.push({ name: agentName, codename, role, files, hasSkills });
+        result.push({ name: agentName, codename, role, files, system_files, hasSkills });
       }
     } catch (e) {
       api.logger?.warn?.(`[ofiere] Failed to list workspaces: ${e}`);
@@ -2158,6 +2163,7 @@ function registerConstellationOps(
     if (p.emoji) lines.push(`**Emoji:** ${p.emoji}`);
     lines.push(`**Role:** ${p.role || "Agent"}`);
     lines.push(`**Codename:** ${p.codename}`);
+    if (p.color_hex) lines.push(`**Color:** ${p.color_hex}`);
     if (p.voice_sample) lines.push(`**Sample:** ${p.voice_sample}`);
     lines.push("");
     if (p.one_liner) {
@@ -2170,10 +2176,34 @@ function registerConstellationOps(
     lines.push("");
     lines.push(p.core_identity || `${p.agent_name} is an AI agent specializing in ${p.role || "general tasks"}.`);
     lines.push("");
+    if (p.personality) {
+      lines.push("## Personality");
+      lines.push("");
+      lines.push(p.personality);
+      lines.push("");
+    }
     lines.push("## Operating Style");
     lines.push("");
     lines.push(p.operating_style || "Focused, professional, detail-oriented.");
     lines.push("");
+    if (p.tone) {
+      lines.push("## Tone");
+      lines.push("");
+      lines.push(p.tone);
+      lines.push("");
+    }
+    if (p.worldview) {
+      lines.push("## Worldview");
+      lines.push("");
+      lines.push(p.worldview);
+      lines.push("");
+    }
+    if (p.pacing) {
+      lines.push("## Pacing");
+      lines.push("");
+      lines.push(p.pacing);
+      lines.push("");
+    }
     lines.push("## Relationship to Team");
     lines.push("");
     lines.push(p.team_relationship || "Collaborative team member within the agent constellation.");
@@ -2440,6 +2470,7 @@ function registerConstellationOps(
               role: a.role,
               file_count: a.files.length,
               files: a.files,
+              system_files: a.system_files,
               has_skills: a.hasSkills,
             })),
             count: agents.length,
@@ -2452,8 +2483,10 @@ function registerConstellationOps(
           const name = (params.agent_name as string).toLowerCase();
           const wsPath = getWorkspacePath(name);
           if (!fs.existsSync(wsPath)) return err(`Agent workspace not found: workspace-${name}`);
-          const files = fs.readdirSync(wsPath).filter((f: string) => f.endsWith(".md"));
-          const fileDetails = files.map((f: string) => {
+          const allMd = fs.readdirSync(wsPath).filter((f: string) => f.endsWith(".md"));
+          const userMd = allMd.filter((f: string) => !SYSTEM_MD_FILES.has(f));
+          const systemMd = allMd.filter((f: string) => SYSTEM_MD_FILES.has(f));
+          const fileDetails = userMd.map((f: string) => {
             const stat = fs.statSync(path.join(wsPath, f));
             return { name: f, size_bytes: stat.size, modified: stat.mtime.toISOString() };
           });
@@ -2471,7 +2504,7 @@ function registerConstellationOps(
             if (emojiMatch) identity.emoji = emojiMatch[1].trim();
           } catch {}
           const hasSkills = fs.existsSync(path.join(wsPath, "skills"));
-          return ok({ agent_name: name, identity, files: fileDetails, has_skills: hasSkills, workspace_path: wsPath });
+          return ok({ agent_name: name, identity, files: fileDetails, system_files: systemMd, has_skills: hasSkills, workspace_path: wsPath });
         }
 
         // ── Read a file ──
@@ -2540,7 +2573,46 @@ function registerConstellationOps(
 
           // Create doctrine file (codename.md) — empty scaffold
           const doctrineName = `${(params.codename as string).toUpperCase()}.md`;
-          const doctrineMd = `# ${params.codename} Doctrine\n\n## Mission\n\n${p.mission || "To be defined."}\n\n## Decision Frameworks\n\n- (Define frameworks here)\n\n## Non-Goals\n\n- (Define non-goals here)\n\n## Evaluation Criteria\n\n- (Define criteria here)\n\n## Metrics\n\n- (Define metrics here)\n\n## Standard Deliverables\n\n- (Define deliverables here)\n\n## Anti-Patterns\n\n- (Define anti-patterns here)\n\n## Handoff Rules\n\n- (Define handoff rules here)\n`;
+          const doctrineMd = [
+            `# ${params.codename} Doctrine`,
+            "",
+            "## Mission",
+            "",
+            p.mission || "To be defined.",
+            "",
+            "## Scope of Responsibility",
+            "",
+            p.scope || `All tasks related to ${p.role || "the assigned domain"}.`,
+            "",
+            "## Decision Frameworks",
+            "",
+            "*To be defined by the operator.*",
+            "",
+            "## Non-Goals",
+            "",
+            "*To be defined by the operator.*",
+            "",
+            "## Evaluation Criteria",
+            "",
+            "*To be defined by the operator.*",
+            "",
+            "## Metrics",
+            "",
+            "*To be defined by the operator.*",
+            "",
+            "## Standard Deliverables",
+            "",
+            "*To be defined by the operator.*",
+            "",
+            "## Anti-Patterns",
+            "",
+            "*To be defined by the operator.*",
+            "",
+            "## Handoff Rules",
+            "",
+            "*To be defined by the operator.*",
+            "",
+          ].join("\n");
           writeAgentFile(agentName, doctrineName, doctrineMd);
           filesWritten.push(doctrineName);
 
@@ -2618,12 +2690,13 @@ function registerConstellationOps(
             const agentsContent = readAgentFile(agent.name, "AGENTS.md");
             const owns: string[] = [];
             if (agentsContent) {
-              // Extract ### Owns section
-              const ownsMatch = agentsContent.match(/###\s+Owns\s*\n([\s\S]*?)(?=\n###|\n##|$)/i);
+              // Extract Owns section — flexible heading match (##, ###, or ####)
+              // Also try matching under a Boundaries parent section
+              const ownsMatch = agentsContent.match(/#{2,4}\s+Owns\s*\n+([\s\S]*?)(?=\n#{2,4}\s|$)/i);
               if (ownsMatch) {
                 const items = ownsMatch[1].split("\n")
                   .map((l: string) => l.replace(/^[\s-*]+/, "").trim())
-                  .filter((l: string) => l.length > 0);
+                  .filter((l: string) => l.length > 0 && !l.startsWith("#"));
                 owns.push(...items);
               }
             }
@@ -2640,17 +2713,18 @@ function registerConstellationOps(
 
           // Safety gate: confirm must be explicitly true
           if (params.confirm !== true) {
-            // List what would be deleted so the agent can show the user
-            let fileList: string[] = [];
+            // List only user-visible files (exclude system md + internal dirs)
+            let userFiles: string[] = [];
             try {
               if (fs.existsSync(wsPath)) {
-                fileList = fs.readdirSync(wsPath, { recursive: true }) as string[];
+                userFiles = fs.readdirSync(wsPath)
+                  .filter((f: string) => (f.endsWith(".md") && !SYSTEM_MD_FILES.has(f)) || f === "skills");
               }
             } catch {}
             return err(
-              `⚠️ DESTRUCTIVE ACTION: This will permanently delete agent "${agentName}" and ALL files in workspace-${agentName}/ (${fileList.length} items). ` +
+              `⚠️ DESTRUCTIVE ACTION: This will permanently delete agent "${agentName}" and ALL files in workspace-${agentName}/ (${userFiles.length} user files). ` +
               `This CANNOT be undone.\n\n` +
-              `Files that will be deleted:\n${fileList.map((f: string) => `  - ${f}`).join("\n") || "  (directory not found)"}\n\n` +
+              `Files that will be deleted:\n${userFiles.map((f: string) => `  - ${f}`).join("\n") || "  (directory not found)"}\n\n` +
               `To proceed, ask the user for explicit confirmation and then call this action again with confirm: true.`
             );
           }
@@ -2660,10 +2734,11 @@ function registerConstellationOps(
             return err(`Agent workspace-${agentName} does not exist at ${wsPath}`);
           }
 
-          // Count files before deletion for the report
-          let deletedFiles: string[] = [];
+          // Count user-visible files before deletion for the report
+          let deletedUserFiles: string[] = [];
           try {
-            deletedFiles = fs.readdirSync(wsPath, { recursive: true }) as string[];
+            deletedUserFiles = fs.readdirSync(wsPath)
+              .filter((f: string) => (f.endsWith(".md") && !SYSTEM_MD_FILES.has(f)) || f === "skills");
           } catch {}
 
           // Remove the entire workspace directory
@@ -2690,13 +2765,13 @@ function registerConstellationOps(
             unregResult = { success: false, message: `Unregistration may have failed: ${unregCombined.slice(0, 200)}` };
           }
 
-          api.logger?.info?.(`[ofiere] Deleted agent "${agentName}" — ${deletedFiles.length} files removed`);
+          api.logger?.info?.(`[ofiere] Deleted agent "${agentName}" — ${deletedUserFiles.length} files removed`);
 
           return ok({
             message: `Agent "${agentName}" has been permanently deleted`,
             agent_name: agentName,
             workspace_deleted: wsPath,
-            files_removed: deletedFiles.length,
+            files_removed: deletedUserFiles.length,
             unregistration: unregResult,
           });
         }