@mistralys/persona-builder 2.4.0 → 2.5.0

package/README.md

@@ -73,6 +73,7 @@ See the [CLI docs](docs/cli.md) for config file format and all flags.
 | [Getting Started](docs/getting-started.md) | Step-by-step tutorial — build your first persona from scratch |
 | [Directory Convention](docs/directory-convention.md) | Expected source layout (`meta/`, `content/`, `partials/`) |
 | [Template Syntax](docs/template-syntax.md) | Variables, partials, conditionals, and built-in context variables |
+| [Target Differences](docs/target-differences.md) | VS Code vs Claude Code — tool notation, frontmatter, filename conventions, and common mistakes |
 | [Custom Variables & Dynamic Partials](docs/dynamic-partials.md) | Inject build-time variables and partial content at global, suite, or per-persona level |
 | [Plugins](docs/plugins.md) | `PersonaBuildPlugin` interface and examples |
 

package/dist/cli.cjs

@@ -103,6 +103,10 @@ function serializeTools(tools) {
 function serializeToolsList(tools) {
   return tools.map((t) => `'${t}'`).join(", ");
 }
+function serializeToolsBlock(tools) {
+  if (tools.length === 0) return " []";
+  return "\n" + tools.map((t) => `  - ${t}`).join("\n");
+}
 async function loadPartials(dir) {
   const entries = await promises.readdir(dir, { withFileTypes: true });
   const mdFiles = entries.filter(
@@ -185,10 +189,10 @@ tools: [{{tools_list}}]
 ---`;
 var DEFAULT_FRONTMATTER_CLAUDE_CODE = `---
 name: {{cc_file_name_stem}}
-permissionMode: {{cc_permission_mode}}
+description: {{description}}
 model: {{cc_model}}
 memory: {{cc_memory}}
-allowedTools: [{{cc_tools_list}}]
+tools:{{cc_tools_block}}
 ---`;
 var DEFAULT_FRONTMATTER_DEEP_AGENTS = `---
 name: {{name}}
@@ -417,6 +421,12 @@ function buildContext(options) {
   if (!("cc_tools_json" in merged)) {
     merged["cc_tools_json"] = serializeTools(ccTools);
   }
+  if (!("tools_block" in merged)) {
+    merged["tools_block"] = serializeToolsBlock(tools);
+  }
+  if (!("cc_tools_block" in merged)) {
+    merged["cc_tools_block"] = serializeToolsBlock(ccTools);
+  }
   if (!("cc_file_name_stem" in merged) && typeof merged["cc_file_name"] === "string") {
     const ccFileName = merged["cc_file_name"];
     merged["cc_file_name_stem"] = ccFileName.replace(/\.md$/, "");
@@ -433,6 +443,9 @@ function buildContext(options) {
     if (!("da_tools_json" in merged)) {
       merged["da_tools_json"] = serializeTools(daTools);
     }
+    if (!("da_tools_block" in merged)) {
+      merged["da_tools_block"] = serializeToolsBlock(daTools);
+    }
   }
   for (const [key, value] of Object.entries(agentMap)) {
     if (!(key in merged)) {
@@ -451,6 +464,21 @@ function buildContext(options) {
   }
   return merged;
 }
+function validateSubagentRefs(persona, agentMap) {
+  const subagents = persona.subagents;
+  if (!Array.isArray(subagents) || subagents.length === 0) return [];
+  const results = [];
+  for (const slug of subagents) {
+    const key = `agent_slug_${slug.replace(/-/g, "_")}`;
+    if (!(key in agentMap)) {
+      results.push({
+        severity: "error",
+        message: `Persona '${persona.name}' declares subagent '${slug}' but no persona with that slug exists in any configured suite.`
+      });
+    }
+  }
+  return results;
+}
 async function buildPersona(personaYamlPath, suiteName, suiteConfig, sharedMeta, partialsMap, config, plugins, target, agentMap = {}, registry = defaultRegistry) {
   const personaMeta = await loadPersonaYaml(personaYamlPath);
   let context = buildContext({
@@ -489,7 +517,10 @@ async function buildPersona(personaYamlPath, suiteName, suiteConfig, sharedMeta,
 ${body}
 `);
   output = runPostRender(plugins, output, personaMetaTyped, target);
-  const validationResults = runValidate(plugins, personaMetaTyped, suiteConfig, target);
+  const validationResults = [
+    ...runValidate(plugins, personaMetaTyped, suiteConfig, target),
+    ...validateSubagentRefs(personaMetaTyped, agentMap)
+  ];
   const def = registry.has(target) ? registry.get(target) : void 0;
   const outputDir = resolveOutputDir(target, suiteConfig, def);
   const fnKey = def?.filenameContextKey;