@deimoscloud/coreai 0.1.13 → 0.1.15

package/dist/index.d.ts

@@ -166,7 +166,7 @@ declare function getConfigPath(startDir?: string): string | null;
  * TypeScript types corresponding to the JSON schema at schemas/agent.schema.json
  */
 type AgentType = 'ic-engineer' | 'manager' | 'specialist' | 'coordinator';
-type WorkflowType = 'ticket-implementation' | 'bug-investigation' | 'code-review' | 'planning-estimation';
+type WorkflowType = 'ticket-implementation' | 'bug-investigation' | 'code-review' | 'planning-estimation' | 'product-planning';
 interface AgentExpertise {
     primary?: string[];
     tech_stack?: string;
@@ -184,13 +184,51 @@ interface AgentBehaviors {
     quality_gates?: string;
     [key: string]: unknown;
 }
+/**
+ * @deprecated Use AgentKnowledgeLibrary instead
+ */
 interface AgentContextSources {
     shared?: string[];
     personal?: string[];
 }
+interface AgentKnowledgeLibraryControl {
+    objectives?: string;
+    decisions?: string;
+    dependencies?: string;
+    index?: string;
+}
+interface AgentKnowledgeLibraryShared {
+    context?: string;
+    architecture?: string;
+    prd?: string;
+    remote?: string[];
+}
+interface AgentKnowledgeLibraryPersonal {
+    context?: string;
+    history?: string;
+    inbox?: string;
+    outbox?: string;
+    tech?: string;
+    control?: AgentKnowledgeLibraryControl;
+}
+interface AgentKnowledgeLibrary {
+    shared?: AgentKnowledgeLibraryShared;
+    personal?: AgentKnowledgeLibraryPersonal;
+}
 interface AgentCommunication {
     inbox?: string;
     outbox?: string;
+    message_format?: string;
+    outbox_format?: string;
+    processed_dir?: string;
+}
+interface AgentStartupProtocol {
+    first_session?: string[];
+    subsequent?: string[];
+}
+interface AgentProtocols {
+    startup?: AgentStartupProtocol;
+    completion?: string[];
 }
 /**
  * Raw agent definition as loaded from YAML (before variable resolution)
@@ -205,8 +243,11 @@ interface AgentDefinition {
     skills?: string[];
     principles?: AgentPrinciples;
     behaviors?: AgentBehaviors;
+    /** @deprecated Use knowledge_library instead */
     context_sources?: AgentContextSources;
+    knowledge_library?: AgentKnowledgeLibrary;
     communication?: AgentCommunication;
+    protocols?: AgentProtocols;
     /**
      * Claude Code tools available to this agent.
      * If not specified, defaults to: Read, Write, Edit, Bash, Glob, Grep

package/dist/index.js

@@ -383,6 +383,183 @@ function buildAgentTools(agent, mcpServers) {
   }
   return tools.join(", ");
 }
+function generateKnowledgeLibrarySection(agent, lines) {
+  const kl = agent.knowledge_library;
+  if (!kl) return;
+  lines.push("## Knowledge Library Structure");
+  lines.push("");
+  if (kl.shared) {
+    lines.push("### Shared Context (Root - All Agents)");
+    lines.push("```");
+    lines.push("/KnowledgeLibrary/");
+    if (kl.shared.context) {
+      const filename = kl.shared.context.split("/").pop() ?? "context.txt";
+      lines.push(`\u251C\u2500\u2500 ${filename}`);
+    }
+    if (kl.shared.architecture) {
+      const filename = kl.shared.architecture.split("/").pop() ?? "architecture.txt";
+      lines.push(`\u251C\u2500\u2500 ${filename}`);
+    }
+    if (kl.shared.prd) {
+      const filename = kl.shared.prd.split("/").pop() ?? "prd.txt";
+      lines.push(`\u2514\u2500\u2500 ${filename}`);
+    }
+    lines.push("```");
+    if (kl.shared.remote && kl.shared.remote.length > 0) {
+      lines.push("");
+      lines.push("**Remote Documentation:**");
+      for (const remote of kl.shared.remote) {
+        lines.push(`- ${remote}`);
+      }
+    }
+    lines.push("");
+  }
+  if (kl.personal) {
+    lines.push(`### Personal Context (${agent.role})`);
+    lines.push("```");
+    lines.push(`/KnowledgeLibrary/${agent.role}/`);
+    if (kl.personal.context) {
+      lines.push("\u251C\u2500\u2500 context/");
+      lines.push("\u2502   \u2514\u2500\u2500 current.txt    # Your current state, priorities, decisions, issues");
+    }
+    if (kl.personal.history) {
+      lines.push("\u251C\u2500\u2500 history/");
+      lines.push("\u2502   \u2514\u2500\u2500 [archived context files, timestamped]");
+    }
+    if (kl.personal.inbox) {
+      lines.push("\u251C\u2500\u2500 inbox/");
+      lines.push("\u2502   \u2514\u2500\u2500 YYYYMMDD_HHMM-[agent-name]-[topic].txt  # Messages from other agents");
+    }
+    if (kl.personal.outbox) {
+      lines.push("\u251C\u2500\u2500 outbox/");
+      lines.push("\u2502   \u2514\u2500\u2500 YYYYMMDD_HHMM-to-[agent-name]-[topic].txt  # Copies of sent messages");
+    }
+    if (kl.personal.tech) {
+      lines.push("\u251C\u2500\u2500 tech/");
+      lines.push("\u2502   \u2514\u2500\u2500 [Technical docs, implementation details, working drafts]");
+    }
+    if (kl.personal.control) {
+      lines.push("\u2514\u2500\u2500 control/");
+      if (kl.personal.control.objectives) {
+        lines.push("    \u251C\u2500\u2500 objectives.txt    # Current job objectives and goals");
+      }
+      if (kl.personal.control.decisions) {
+        lines.push("    \u251C\u2500\u2500 decisions.txt     # Log of key decisions with rationale");
+      }
+      if (kl.personal.control.dependencies) {
+        lines.push("    \u251C\u2500\u2500 dependencies.txt  # Dependencies on other jobs");
+      }
+      if (kl.personal.control.index) {
+        lines.push("    \u2514\u2500\u2500 index.txt         # Optional index of files/folders");
+      }
+    }
+    lines.push("```");
+    lines.push("");
+  }
+  lines.push("---");
+  lines.push("");
+}
+function generateCommunicationSection(agent, lines) {
+  const comm = agent.communication;
+  if (!comm) return;
+  lines.push("## Communication");
+  lines.push("");
+  if (comm.inbox) {
+    lines.push(`**Inbox:** \`${comm.inbox}\``);
+  }
+  if (comm.outbox) {
+    lines.push(`**Outbox:** \`${comm.outbox}\``);
+  }
+  lines.push("");
+  if (comm.message_format || comm.outbox_format || comm.processed_dir) {
+    lines.push("### Message Conventions");
+    lines.push("");
+    if (comm.message_format) {
+      lines.push(`- **Inbox message naming:** \`${comm.message_format}\``);
+    }
+    if (comm.outbox_format) {
+      lines.push(`- **Outbox message naming:** \`${comm.outbox_format}\``);
+    }
+    if (comm.processed_dir) {
+      lines.push(`- **Processed messages:** Move handled inbox messages to \`${comm.processed_dir}\``);
+    }
+    lines.push("");
+  }
+}
+function generateStartupProtocolSection(agent, lines) {
+  const protocols = agent.protocols;
+  if (!protocols?.startup) return;
+  lines.push("## When Invoked");
+  lines.push("");
+  lines.push("> **MANDATORY STARTUP PROTOCOL** - Execute before proceeding with any task.");
+  lines.push("");
+  lines.push("### Session Context Check");
+  lines.push("");
+  lines.push("First, determine if you have already loaded context in this session:");
+  lines.push("");
+  if (protocols.startup.first_session && protocols.startup.first_session.length > 0) {
+    lines.push("**If this is your FIRST invocation in this session** (no prior context loaded):");
+    lines.push("");
+    for (const step of protocols.startup.first_session) {
+      lines.push(`- [ ] ${step}`);
+    }
+    lines.push("");
+    lines.push('Acknowledge: "Startup protocol complete. Full context loaded."');
+    lines.push("");
+  }
+  if (protocols.startup.subsequent && protocols.startup.subsequent.length > 0) {
+    lines.push("**If you have ALREADY loaded context in this session** (subsequent invocation):");
+    lines.push("");
+    for (const step of protocols.startup.subsequent) {
+      lines.push(`- [ ] ${step}`);
+    }
+    lines.push("");
+    lines.push('Acknowledge: "Context already loaded. Checked inbox for new messages."');
+    lines.push("");
+  }
+  lines.push("Then proceed with the task.");
+  lines.push("");
+  lines.push("---");
+  lines.push("");
+}
+function generateCompletionProtocolSection(agent, lines) {
+  const protocols = agent.protocols;
+  if (!protocols?.completion || protocols.completion.length === 0) return;
+  lines.push("## Before Finishing");
+  lines.push("");
+  lines.push("> **MANDATORY COMPLETION PROTOCOL** - Execute ALL steps before ending any task.");
+  lines.push("");
+  for (let i = 0; i < protocols.completion.length; i++) {
+    lines.push(`### ${i + 1}. ${protocols.completion[i]}`);
+    lines.push("");
+  }
+  lines.push('Acknowledge: "Completion protocol finished. Context updated."');
+  lines.push("");
+  lines.push("---");
+  lines.push("");
+}
+function generateLegacyContextSourcesSection(agent, lines) {
+  if (!agent.context_sources) return;
+  if (agent.knowledge_library) return;
+  lines.push("## Context Sources");
+  lines.push("");
+  if (agent.context_sources.shared && agent.context_sources.shared.length > 0) {
+    lines.push("### Shared");
+    lines.push("");
+    for (const source of agent.context_sources.shared) {
+      lines.push(`- ${source}`);
+    }
+    lines.push("");
+  }
+  if (agent.context_sources.personal && agent.context_sources.personal.length > 0) {
+    lines.push("### Personal");
+    lines.push("");
+    for (const source of agent.context_sources.personal) {
+      lines.push(`- ${source}`);
+    }
+    lines.push("");
+  }
+}
 function generateAgentMarkdown(agent, mcpServers) {
   const lines = [];
   const tools = buildAgentTools(agent, mcpServers);
@@ -478,37 +655,11 @@ function generateAgentMarkdown(agent, mcpServers) {
       lines.push("");
     }
   }
-  if (agent.context_sources) {
-    lines.push("## Context Sources");
-    lines.push("");
-    if (agent.context_sources.shared && agent.context_sources.shared.length > 0) {
-      lines.push("### Shared");
-      lines.push("");
-      for (const source of agent.context_sources.shared) {
-        lines.push(`- ${source}`);
-      }
-      lines.push("");
-    }
-    if (agent.context_sources.personal && agent.context_sources.personal.length > 0) {
-      lines.push("### Personal");
-      lines.push("");
-      for (const source of agent.context_sources.personal) {
-        lines.push(`- ${source}`);
-      }
-      lines.push("");
-    }
-  }
-  if (agent.communication) {
-    lines.push("## Communication");
-    lines.push("");
-    if (agent.communication.inbox) {
-      lines.push(`**Inbox:** ${agent.communication.inbox}`);
-    }
-    if (agent.communication.outbox) {
-      lines.push(`**Outbox:** ${agent.communication.outbox}`);
-    }
-    lines.push("");
-  }
+  generateKnowledgeLibrarySection(agent, lines);
+  generateCommunicationSection(agent, lines);
+  generateStartupProtocolSection(agent, lines);
+  generateCompletionProtocolSection(agent, lines);
+  generateLegacyContextSourcesSection(agent, lines);
   lines.push("---");
   lines.push("");
   lines.push("*Generated by CoreAI*");