@dot-agent/compiler 0.1.0 → 0.5.0-alpha.2

package/dist/index.cjs

@@ -33,7 +33,9 @@ __export(index_exports, {
   aboutmeToJson: () => aboutmeToJson,
   buildAboutme: () => buildAboutme,
   buildId: () => buildId,
+  bundleFromDir: () => bundleFromDir,
   collectFiles: () => collectFiles,
+  consolidate: () => consolidate,
   createLinter: () => createLinter,
   createZip: () => createZip,
   extractDigest: () => extractDigest,
@@ -57,8 +59,8 @@ __export(index_exports, {
   parseSync: () => parseSync,
   positionToOffset: () => positionToOffset,
   readZip: () => readZip,
-  validateMagicBytes: () => validateMagicBytes,
-  validateZipBomb: () => validateZipBomb,
+  validateMagicBytes: () => validateMagicBytes2,
+  validateZipBomb: () => validateZipBomb2,
   writeZip: () => writeZip
 });
 module.exports = __toCommonJS(index_exports);
@@ -70,7 +72,7 @@ var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
 // src/parser.ts
 var import_module = require("module");
 var import_web_tree_sitter = require("web-tree-sitter");
-var import_parser_dsl = __toESM(require("@dot-agent/parser-dsl"), 1);
+var import_parser_dsl = require("@dot-agent/parser-dsl");
 var require2 = (0, import_module.createRequire)(importMetaUrl);
 var { descriptionWasmPath, behaviorWasmPath } = require2("@dot-agent/tree-sitter");
 var _initialized = false;
@@ -79,7 +81,7 @@ var _behaviorParser;
 var _bpInitialized = false;
 async function initBehaviorParser() {
   if (_bpInitialized) return;
-  await (0, import_parser_dsl.default)();
+  await (0, import_parser_dsl.init)();
   _bpInitialized = true;
 }
 function parseBehaviorFile(text) {
@@ -234,6 +236,18 @@ async function lintDescription(text, file = "agent.description") {
       message: "No domain declared \u2014 agent will be packaged as unknown/name. Interoperability between runtimes is not guaranteed."
     });
   }
+  const behaviorBlocks = nodesOfType(tree, "behavior_block");
+  if (behaviorBlocks.length > 1) {
+    const { line, col } = nodePosition(behaviorBlocks[1]);
+    messages.push({
+      file,
+      line,
+      col,
+      severity: "error",
+      code: "E017",
+      message: "Multiple 'behavior' declarations \u2014 only one is allowed. To combine multiple files, use 'merge' in your .behavior file."
+    });
+  }
   const declaredTypes = new Set(
     nodesOfType(tree, "type_decl").map((n) => n.childForFieldName("name")?.text).filter(Boolean)
   );
@@ -332,7 +346,7 @@ function collectMergedStates(tree, docDir, states, visited = /* @__PURE__ */ new
     collectMergedStates(mergedTree, (0, import_path.dirname)(absPath), states, visited);
   }
 }
-async function lintBehavior(text, file = "agent.behavior", docPath) {
+async function lintBehavior(text, file = "agent.behavior", docPath, consolidated = false, externalStates, mergedText) {
   await initBehaviorParser();
   if (!text.endsWith("\n")) text = text + "\n";
   const tree = await parse("behavior", text);
@@ -353,7 +367,7 @@ async function lintBehavior(text, file = "agent.behavior", docPath) {
         col,
         severity: "warning",
         code: "W013",
-        message: `'interact' without 'goal' \u2014 the prettifier will insert one. To set it explicitly, add 'goal "..."' before 'interact'.`
+        message: `'interact' without 'goal'. Add 'goal "..."' before 'interact'.`
       });
     }
     if (hasGoal && !hasInteract) {
@@ -364,7 +378,7 @@ async function lintBehavior(text, file = "agent.behavior", docPath) {
         col,
         severity: "warning",
         code: "W012",
-        message: `'goal' is only valid in an oriented state. Add 'interact' or remove 'goal' \u2014 the prettifier can adjust this.`
+        message: `'goal' is only valid in an oriented state. Add 'interact' or remove 'goal'.`
       });
     }
     if (hasInteract && intentHandlers.length === 0) {
@@ -495,7 +509,7 @@ async function lintBehavior(text, file = "agent.behavior", docPath) {
         col,
         severity: "warning",
         code: "W002",
-        message: `Text block exceeds 280 characters (${content.length}). Consider using 'teach' to load long goal text from an external file.`
+        message: `Text block exceeds 280 characters (${content.length}). Consider using 'guide' to load long orientation text from an external text file.`
       });
     }
   }
@@ -514,7 +528,7 @@ async function lintBehavior(text, file = "agent.behavior", docPath) {
         col,
         severity: "warning",
         code: "W010",
-        message: `'guide' text in state '${stateName}' is ${content.length} characters (limit: 280). Consider using an external file.`
+        message: `'guide' text in state '${stateName}' is ${content.length} characters. Consider using an external file.`
       });
     }
   }
@@ -527,6 +541,9 @@ async function lintBehavior(text, file = "agent.behavior", docPath) {
     } catch {
     }
   }
+  if (externalStates) {
+    for (const name of externalStates) definedStates.add(name);
+  }
   const stateNameList = Array.from(definedStates);
   for (const transitionNode of nodesOfType(tree, "transition_stmt")) {
     const stateNode = transitionNode.childForFieldName("state");
@@ -578,7 +595,9 @@ async function lintBehavior(text, file = "agent.behavior", docPath) {
     return messages;
   }
   const fsm = fsmResult.ok;
-  const allTargets = new Set(collectTransitionTargets(fsm.states.flatMap((s) => s.body)));
+  const wholeFsm = mergedText !== void 0 ? parseBehaviorFile(mergedText).ok : null;
+  const reachabilityStates = wholeFsm?.states ?? fsm.states;
+  const allTargets = new Set(collectTransitionTargets(reachabilityStates.flatMap((s) => s.body)));
   for (const state of fsm.states) {
     const hasOutgoing = collectTransitionTargets(state.body).length > 0;
     const hasIncoming = allTargets.has(state.name);
@@ -608,15 +627,62 @@ async function lintBehavior(text, file = "agent.behavior", docPath) {
       });
     }
   }
+  if (consolidated) {
+    const wholeTreeFsm = wholeFsm ?? fsm;
+    const seenStates = /* @__PURE__ */ new Set();
+    for (const state of wholeTreeFsm.states) {
+      if (seenStates.has(state.name)) {
+        messages.push({
+          file,
+          line: 1,
+          col: 1,
+          severity: "error",
+          code: "E015",
+          message: `Duplicate state '${state.name}' across merged files \u2014 each state name must be unique in the consolidated FSM.`
+        });
+      } else {
+        seenStates.add(state.name);
+      }
+    }
+    if (!wholeTreeFsm.states.some((s) => s.name === "init")) {
+      messages.push({
+        file,
+        line: 1,
+        col: 1,
+        severity: "error",
+        code: "E016",
+        message: `Required 'init' state is missing. Add a state named 'init' as the entry point of your behavior.`
+      });
+    }
+    const seenTriggers = /* @__PURE__ */ new Set();
+    for (const trigger of wholeTreeFsm.global_triggers) {
+      if (seenTriggers.has(trigger.event)) {
+        messages.push({
+          file,
+          line: 1,
+          col: 1,
+          severity: "warning",
+          code: "W014",
+          message: `Duplicate global trigger '${trigger.event}' across merged files \u2014 only the last definition takes effect.`
+        });
+      } else {
+        seenTriggers.add(trigger.event);
+      }
+    }
+  }
   return messages;
 }
 async function createLinter() {
   return { lintDescription, lintBehavior };
 }
 
+// src/generated-version.ts
+var DSL_VERSION = "0.1-alpha";
+var COMPILER_VERSION = "0.5.0-alpha.2";
+
 // src/manifest.ts
 function parseAboutme(json) {
-  if (!json.schemaVersion) throw new Error("Missing schemaVersion in aboutme.json");
+  if (!json.dslVersion) throw new Error("Missing dslVersion in aboutme.json");
   if (!json.id) throw new Error("Missing id in aboutme.json");
   if (!json.name) throw new Error("Missing name in aboutme.json");
   if (!json.description) throw new Error("Missing description in aboutme.json");
@@ -628,7 +694,7 @@ function parseAboutme(json) {
   if (!Array.isArray(json.requires)) throw new Error("Missing requires array in aboutme.json");
   if (!json.integrity) throw new Error("Missing integrity in aboutme.json");
   return {
-    schemaVersion: json.schemaVersion,
+    dslVersion: json.dslVersion,
     id: json.id,
     name: json.name,
     description: json.description,
@@ -646,7 +712,7 @@ function parseAboutme(json) {
 }
 function buildAboutme(opts) {
   return {
-    schemaVersion: "dot-agent/1.0",
+    dslVersion: `dot-agent/${DSL_VERSION}`,
     id: opts.id,
     name: opts.name,
     description: opts.description,
@@ -767,6 +833,25 @@ var import_promises = require("fs/promises");
 
 // src/zip-core.ts
 var import_jszip = __toESM(require("jszip"), 1);
+var MAX_ZIP_SIZE = 500 * 1024 * 1024;
+var MAX_COMPRESSION_RATIO = 100;
+function validateMagicBytes(bytes) {
+  if (!(bytes[0] === 80 && bytes[1] === 75 && bytes[2] === 3 && bytes[3] === 4)) {
+    throw new Error("Not a valid .agent file (invalid magic bytes)");
+  }
+}
+function validateZipBomb(zip, compressedSize) {
+  let totalUncompressed = 0;
+  zip.forEach((_path, file) => {
+    if (!file.dir) totalUncompressed += file._data?.uncompressedSize || 0;
+  });
+  if (totalUncompressed > MAX_ZIP_SIZE) {
+    throw new Error(`Bundle exceeds 500MB uncompressed: ${totalUncompressed}`);
+  }
+  if (totalUncompressed / compressedSize > MAX_COMPRESSION_RATIO) {
+    throw new Error(`Compression ratio exceeds 100x: ${(totalUncompressed / compressedSize).toFixed(1)}x`);
+  }
+}
 function createZip() {
   return new import_jszip.default();
 }
@@ -787,37 +872,19 @@ async function extractFiles(zip, filter) {
 }
 
 // src/zip.ts
-var MAX_ZIP_SIZE = 500 * 1024 * 1024;
-var MAX_COMPRESSION_RATIO = 100;
 async function readZip(filePath) {
   const data = await (0, import_promises.readFile)(filePath);
   return import_jszip2.default.loadAsync(data);
 }
-async function validateZipBomb(filePath) {
+async function validateZipBomb2(filePath) {
   const data = await (0, import_promises.readFile)(filePath);
   const zip = await import_jszip2.default.loadAsync(data);
-  let totalUncompressed = 0;
-  zip.forEach((_relativePath, file) => {
-    if (!file.dir) {
-      totalUncompressed += file._data?.uncompressedSize || 0;
-    }
-  });
-  const compressedSize = data.length;
-  const ratio = totalUncompressed / compressedSize;
-  if (totalUncompressed > MAX_ZIP_SIZE) {
-    throw new Error(`ZIP uncompressed size exceeds 500MB limit: ${totalUncompressed}`);
-  }
-  if (ratio > MAX_COMPRESSION_RATIO) {
-    throw new Error(`ZIP compression ratio exceeds 100x limit: ${ratio.toFixed(1)}x`);
-  }
+  validateZipBomb(zip, data.length);
   return true;
 }
-async function validateMagicBytes(filePath) {
+async function validateMagicBytes2(filePath) {
   const data = await (0, import_promises.readFile)(filePath);
-  const magic = data.subarray(0, 4);
-  if (!(magic[0] === 80 && magic[1] === 75 && magic[2] === 3 && magic[3] === 4)) {
-    throw new Error("File is not a valid ZIP (invalid magic bytes)");
-  }
+  validateMagicBytes(data);
   return true;
 }
 async function writeZip(zip, outPath) {
@@ -909,7 +976,81 @@ async function resolveCommit(explicit) {
   if (explicit) return explicit;
   return gitRevParseShort() ?? void 0;
 }
-async function collectFiles(dir) {
+function isExternalPath(agentRoot, declaredPath) {
+  if ((0, import_path2.isAbsolute)(declaredPath)) return true;
+  const normRoot = (0, import_path2.normalize)((0, import_path2.resolve)(agentRoot));
+  const resolved = (0, import_path2.resolve)(normRoot, declaredPath);
+  return (0, import_path2.relative)(normRoot, resolved).startsWith("..");
+}
+async function discoverDescriptionFile(dir, explicit) {
+  if (explicit) {
+    try {
+      await (0, import_promises2.stat)((0, import_path2.join)(dir, explicit));
+      return explicit;
+    } catch {
+      throw new Error(`E003: Description file '${explicit}' not found in ${dir}`);
+    }
+  }
+  const entries = await (0, import_promises2.readdir)(dir);
+  const descFiles = entries.filter((f) => f.endsWith(".description"));
+  if (descFiles.length === 0) {
+    throw new Error(`E003: No .description file found in ${dir}`);
+  }
+  if (descFiles.length > 1) {
+    throw new Error(`E003: Multiple .description files found: ${descFiles.join(", ")} \u2014 use PackOptions.description to specify one`);
+  }
+  const name = descFiles[0];
+  if (name !== "agent.description") {
+    console.info(`[dot-agent] using description file: ${name}`);
+  }
+  return name;
+}
+async function consolidate(agentRoot, entryFile) {
+  await initBehaviorParser();
+  const normRoot = (0, import_path2.normalize)((0, import_path2.resolve)(agentRoot));
+  const visiting = /* @__PURE__ */ new Set();
+  const visited = /* @__PURE__ */ new Set();
+  const order = [];
+  const textCache = /* @__PURE__ */ new Map();
+  async function dfs(relPath) {
+    const absPath = (0, import_path2.resolve)(normRoot, relPath);
+    if (visiting.has(absPath)) {
+      throw new Error(`E013: Circular merge dependency involving '${relPath}'`);
+    }
+    if (visited.has(absPath)) return;
+    visiting.add(absPath);
+    let fileText;
+    try {
+      fileText = await (0, import_promises2.readFile)(absPath, "utf-8");
+    } catch {
+      throw new Error(`E012: Merge target not found: '${relPath}'`);
+    }
+    textCache.set(absPath, fileText);
+    const result = parseBehaviorFile(fileText);
+    const merges = result.ok?.merges ?? [];
+    for (const mergePath of merges) {
+      if ((0, import_path2.isAbsolute)(mergePath)) {
+        throw new Error(`E014: Merge path '${mergePath}' in '${relPath}' is absolute \u2014 only paths within the agent root are allowed`);
+      }
+      const mergeAbs = (0, import_path2.resolve)((0, import_path2.dirname)(absPath), mergePath);
+      const mergeRel = (0, import_path2.relative)(normRoot, mergeAbs);
+      if (mergeRel.startsWith("..")) {
+        throw new Error(`E014: Merge path '${mergePath}' in '${relPath}' escapes the agent root`);
+      }
+      await dfs(mergeRel);
+    }
+    visiting.delete(absPath);
+    visited.add(absPath);
+    order.push(relPath);
+  }
+  await dfs(entryFile);
+  const texts = order.map((relPath) => textCache.get((0, import_path2.resolve)(normRoot, relPath)));
+  return {
+    mergedText: texts.join("\n"),
+    mergeSources: order
+  };
+}
+async function collectFiles(dir, descriptionFile, mergedBehaviorText, mergeSources) {
   const files = /* @__PURE__ */ new Map();
   async function walk(subdir, prefix = "") {
     try {
@@ -928,13 +1069,16 @@ async function collectFiles(dir) {
     } catch {
     }
   }
-  files.set("agent.description", await (0, import_promises2.readFile)((0, import_path2.join)(dir, "agent.description"), "utf-8"));
-  files.set("agent.behavior", await (0, import_promises2.readFile)((0, import_path2.join)(dir, "agent.behavior"), "utf-8"));
+  files.set(descriptionFile, await (0, import_promises2.readFile)((0, import_path2.join)(dir, descriptionFile), "utf-8"));
+  const flatBehaviorText = mergedBehaviorText.replace(/^\s*merge\s+"[^"]*"\s*$/gm, "");
+  files.set("agent.behavior", flatBehaviorText);
+  for (const relPath of mergeSources) {
+    files.set(`behaviors/${relPath}`, await (0, import_promises2.readFile)((0, import_path2.join)(dir, relPath), "utf-8"));
+  }
   try {
     files.set("SOUL.md", await (0, import_promises2.readFile)((0, import_path2.join)(dir, "SOUL.md"), "utf-8"));
   } catch {
   }
-  await walk((0, import_path2.join)(dir, "behaviors"), "behaviors");
   await walk((0, import_path2.join)(dir, "guides"), "guides");
   await walk((0, import_path2.join)(dir, "knowledge"), "knowledge");
   return files;
@@ -942,29 +1086,14 @@ async function collectFiles(dir) {
 async function pack(options = {}) {
   const dir = options.dir ?? process.cwd();
   const outPath = options.out ?? (0, import_path2.join)(dir, `${(0, import_path2.basename)(dir)}.agent`);
-  let descriptionText;
-  let behaviorText;
-  try {
-    descriptionText = await (0, import_promises2.readFile)((0, import_path2.join)(dir, "agent.description"), "utf-8");
-  } catch {
-    throw new Error("E003: File agent.description not found");
-  }
-  try {
-    behaviorText = await (0, import_promises2.readFile)((0, import_path2.join)(dir, "agent.behavior"), "utf-8");
-  } catch {
-    throw new Error("E007: File agent.behavior not found");
-  }
-  const [descriptionMessages, behaviorMessages] = await Promise.all([
-    lintDescription(descriptionText),
-    lintBehavior(behaviorText)
-  ]);
-  const allMessages = [...descriptionMessages, ...behaviorMessages];
-  const errors = allMessages.filter((m) => m.severity === "error");
-  const warnings = allMessages.filter((m) => m.severity === "warning");
-  if (errors.length > 0) {
+  const descriptionFileName = await discoverDescriptionFile(dir, options.description);
+  const descriptionText = await (0, import_promises2.readFile)((0, import_path2.join)(dir, descriptionFileName), "utf-8");
+  const descriptionMessages = await lintDescription(descriptionText, descriptionFileName);
+  const descErrors = descriptionMessages.filter((m) => m.severity === "error");
+  if (descErrors.length > 0) {
     throw new Error(
       `Lint failed:
-${errors.map((e) => `  ${e.file}:${e.line}:${e.col} ${e.code} ${e.message}`).join("\n")}`
+${descErrors.map((e) => `  ${e.file}:${e.line}:${e.col} ${e.code} ${e.message}`).join("\n")}`
     );
   }
   await initBehaviorParser();
@@ -974,9 +1103,26 @@ ${errors.map((e) => `  ${e.file}:${e.line}:${e.col} ${e.code} ${e.message}`).joi
     throw new Error(`E_DESC: ${firstError?.message ?? "parse failed"}`);
   }
   const df = descResult.ok;
+  if (!df.behavior) {
+    throw new Error(`E_DESC: '${descriptionFileName}' must declare a behavior file \u2014 add 'behavior "agent.behavior"' (or the name of your entry .behavior file)`);
+  }
+  if (isExternalPath(dir, df.behavior)) {
+    throw new Error(`E014: behavior path '${df.behavior}' in '${descriptionFileName}' is absolute or escapes the agent root`);
+  }
+  const { mergedText, mergeSources } = await consolidate(dir, df.behavior);
+  const behaviorMessages = await lintBehavior(mergedText, "agent.behavior", void 0, true);
+  const allMessages = [...descriptionMessages, ...behaviorMessages];
+  const errors = allMessages.filter((m) => m.severity === "error");
+  const warnings = allMessages.filter((m) => m.severity === "warning");
+  if (errors.length > 0) {
+    throw new Error(
+      `Lint failed:
+${errors.map((e) => `  ${e.file}:${e.line}:${e.col} ${e.code} ${e.message}`).join("\n")}`
+    );
+  }
   const version = await resolveVersion(options.version);
   const commit = await resolveCommit(options.commit);
-  const allFiles = await collectFiles(dir);
+  const allFiles = await collectFiles(dir, descriptionFileName, mergedText, mergeSources);
   const contentForHash = Array.from(allFiles.values()).join("");
   const sha256 = (0, import_crypto.createHash)("sha256").update(contentForHash).digest("hex");
   const namespace = df.agent.domain ?? "unknown";
@@ -996,7 +1142,7 @@ ${errors.map((e) => `  ${e.file}:${e.line}:${e.col} ${e.code} ${e.message}`).joi
     license: df.agent.license ?? "",
     persona: df.persona ?? "SOUL.md",
     purpose: "unknown",
-    compiler: "dot-agent/1.0.0",
+    compiler: `dot-agent/${COMPILER_VERSION}`,
     commit,
     capabilities: df.capabilities.map((c) => ({ id: c.name, description: c.description ?? "" })),
     requires: df.requires,
@@ -1008,27 +1154,101 @@ ${errors.map((e) => `  ${e.file}:${e.line}:${e.col} ${e.code} ${e.message}`).joi
   if (typesJson) {
     agentFolder.file("types.json", typesJson);
   }
-  const gitkeepPaths = /* @__PURE__ */ new Set(["behaviors/.gitkeep", "guides/.gitkeep", "knowledge/.gitkeep"]);
+  const gitkeepPaths = /* @__PURE__ */ new Set(["guides/.gitkeep", "knowledge/.gitkeep"]);
   const filesJson = {
-    description: "agent.description",
+    description: descriptionFileName,
     behavior: "agent.behavior",
-    behaviors: Array.from(allFiles.keys()).filter((f) => f.startsWith("behaviors/") && !gitkeepPaths.has(f)),
+    behaviors: Array.from(allFiles.keys()).filter((f) => f.startsWith("behaviors/")),
     guides: Array.from(allFiles.keys()).filter((f) => f.startsWith("guides/") && !gitkeepPaths.has(f)),
     knowledge: Array.from(allFiles.keys()).filter((f) => f.startsWith("knowledge/") && !gitkeepPaths.has(f))
   };
   agentFolder.file("files.json", JSON.stringify(filesJson, null, 2));
   for (const [path, content] of allFiles) {
-    if (!gitkeepPaths.has(path)) zip.file(path, content);
+    zip.file(path, content);
   }
   await writeZip(zip, outPath);
   return { path: outPath, id, warnings };
 }
+
+// src/bundle.ts
+var import_promises3 = require("fs/promises");
+var import_path3 = require("path");
+var import_crypto2 = require("crypto");
+var GITKEEP = /* @__PURE__ */ new Set(["guides/.gitkeep", "knowledge/.gitkeep"]);
+async function bundleFromDir(dir) {
+  const descriptionFileName = await discoverDescriptionFile(dir);
+  const descriptionText = await (0, import_promises3.readFile)((0, import_path3.join)(dir, descriptionFileName), "utf-8");
+  const descMessages = await lintDescription(descriptionText, descriptionFileName);
+  const descErrors = descMessages.filter((m) => m.severity === "error");
+  if (descErrors.length > 0) {
+    throw new Error(
+      `Lint failed:
+${descErrors.map((e) => `  ${e.file}:${e.line}:${e.col} ${e.code} ${e.message}`).join("\n")}`
+    );
+  }
+  await initBehaviorParser();
+  const descResult = parseDescriptionFile(descriptionText);
+  if (descResult.ok === null) {
+    const firstError = descResult.diagnostics.find((d) => d.severity === "error");
+    throw new Error(`E_DESC: ${firstError?.message ?? "parse failed"}`);
+  }
+  const df = descResult.ok;
+  if (!df.behavior) {
+    throw new Error(`E_DESC: '${descriptionFileName}' must declare a behavior file`);
+  }
+  const { mergedText, mergeSources } = await consolidate(dir, df.behavior);
+  const behaviorMessages = await lintBehavior(mergedText, "agent.behavior", void 0, true);
+  const allMessages = [...descMessages, ...behaviorMessages];
+  const errors = allMessages.filter((m) => m.severity === "error");
+  const warnings = allMessages.filter((m) => m.severity === "warning");
+  if (errors.length > 0) {
+    throw new Error(
+      `Lint failed:
+${errors.map((e) => `  ${e.file}:${e.line}:${e.col} ${e.code} ${e.message}`).join("\n")}`
+    );
+  }
+  for (const w of warnings) {
+    process.stderr.write(`\x1B[33m\u26A0\x1B[0m ${w.file}:${w.line}:${w.col} ${w.code} ${w.message}
+`);
+  }
+  const allFiles = await collectFiles(dir, descriptionFileName, mergedText, mergeSources);
+  const sha256 = (0, import_crypto2.createHash)("sha256").update(Array.from(allFiles.values()).join("")).digest("hex");
+  const id = buildId({ namespace: df.agent.domain ?? "local", name: df.agent.name, version: "dev" });
+  const aboutme = buildAboutme({
+    id,
+    name: df.agent.name,
+    description: df.description ?? "",
+    version: "dev",
+    domain: df.agent.domain ?? "",
+    license: df.agent.license ?? "",
+    persona: df.persona ?? "SOUL.md",
+    purpose: "development",
+    compiler: `dot-agent/${COMPILER_VERSION}`,
+    capabilities: df.capabilities.map((c) => ({ id: c.name, description: c.description ?? "" })),
+    requires: df.requires,
+    integrity: { sha256, files: ".agent/files.json" }
+  });
+  const files = {
+    description: descriptionText,
+    // Reuse collectFiles()'s 'agent.behavior' entry rather than the raw
+    // mergedText — it has redundant `merge "..."` lines stripped (see
+    // collectFiles() for why they're dead weight once flattened).
+    behavior: allFiles.get("agent.behavior") ?? mergedText,
+    soul: allFiles.get("SOUL.md"),
+    guides: Array.from(allFiles.entries()).filter(([p]) => p.startsWith("guides/") && !GITKEEP.has(p)).map(([path, content]) => ({ path, content })),
+    knowledge: Array.from(allFiles.entries()).filter(([p]) => p.startsWith("knowledge/") && !GITKEEP.has(p)).map(([path, content]) => ({ path, content })),
+    behaviors: Array.from(allFiles.entries()).filter(([p]) => p.startsWith("behaviors/")).map(([path, content]) => ({ path, content }))
+  };
+  return { id, aboutme, files };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   aboutmeToJson,
   buildAboutme,
   buildId,
+  bundleFromDir,
   collectFiles,
+  consolidate,
   createLinter,
   createZip,
   extractDigest,