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

package/dist/index.js

@@ -7,11 +7,13 @@ import {
   extractDigest,
   extractFiles,
   extractName,
+  isValidVersion,
   parseAboutme,
   parseId,
+  slugify,
   validateMagicBytes,
   validateZipBomb
-} from "./chunk-P5LFGJ6P.js";
+} from "./chunk-AYXHOOUX.js";
 
 // src/parser.ts
 import { createRequire } from "module";
@@ -705,13 +707,6 @@ function buildTypesJson(df) {
 }
 
 // src/pack.ts
-function gitDescribeTags() {
-  try {
-    return execSync("git describe --tags --abbrev=0", { stdio: "pipe", encoding: "utf-8" }).trim();
-  } catch {
-    return null;
-  }
-}
 function gitRevParseShort() {
   try {
     return execSync("git rev-parse --short HEAD", { stdio: "pipe", encoding: "utf-8" }).trim();
@@ -719,14 +714,65 @@ function gitRevParseShort() {
     return null;
   }
 }
-async function resolveVersion(explicit) {
-  if (explicit) return explicit;
-  return gitDescribeTags() ?? "v1.0.0";
-}
 async function resolveCommit(explicit) {
   if (explicit) return explicit;
   return gitRevParseShort() ?? void 0;
 }
+function recentTagCandidates(limit = 5) {
+  let tags;
+  try {
+    tags = execSync("git tag --sort=-creatordate", { stdio: "pipe", encoding: "utf-8" }).trim().split("\n").filter(Boolean);
+  } catch {
+    return [];
+  }
+  return tags.slice(0, limit).map((tag) => {
+    const atIdx = tag.lastIndexOf("@");
+    const version = atIdx === -1 ? tag : tag.slice(atIdx + 1);
+    const label = atIdx === -1 ? tag : `${version}   (tag: ${tag})`;
+    return { version, label };
+  }).filter((c) => isValidVersion(c.version));
+}
+var CUSTOM_VERSION = "__dot-agent-custom-version__";
+var BARE_VERSION = "__dot-agent-bare-version__";
+async function resolveVersionInteractive(explicit) {
+  if (explicit) {
+    if (!isValidVersion(explicit)) {
+      throw new Error(`E019: Invalid version format '${explicit}' \u2014 expected vX.Y[.Z][-prerelease] or X.Y[.Z][-prerelease]`);
+    }
+    return explicit;
+  }
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    process.stderr.write("[dot-agent] no TTY and no --version \u2014 packing without a version\n");
+    return void 0;
+  }
+  const candidates = recentTagCandidates();
+  const clack = await import("@clack/prompts");
+  const choice = await clack.select({
+    message: "Choose a version for this package",
+    options: [
+      ...candidates.map((c) => ({ value: c.version, label: c.label })),
+      { value: CUSTOM_VERSION, label: "Type a custom version\u2026" },
+      { value: BARE_VERSION, label: "None (bare \u2014 no version)" }
+    ]
+  });
+  if (clack.isCancel(choice)) {
+    clack.cancel("Pack cancelled.");
+    process.exit(1);
+  }
+  if (choice === BARE_VERSION) return void 0;
+  if (choice === CUSTOM_VERSION) {
+    const typed = await clack.text({
+      message: "Version",
+      validate: (v) => v && isValidVersion(v) ? void 0 : "Invalid version format \u2014 expected vX.Y[.Z][-prerelease] or X.Y[.Z][-prerelease]"
+    });
+    if (clack.isCancel(typed)) {
+      clack.cancel("Pack cancelled.");
+      process.exit(1);
+    }
+    return typed;
+  }
+  return choice;
+}
 function isExternalPath(agentRoot, declaredPath) {
   if (isAbsolute(declaredPath)) return true;
   const normRoot = normalize(resolve2(agentRoot));
@@ -801,7 +847,35 @@ async function consolidate(agentRoot, entryFile) {
     mergeSources: order
   };
 }
-async function collectFiles(dir, descriptionFile, mergedBehaviorText, mergeSources) {
+var FILE_REF_RE = /\.(txt|md)$/i;
+function collectFileRefs(stmts, out) {
+  for (const s of stmts) {
+    switch (s.type) {
+      case "guide_stmt":
+        if (FILE_REF_RE.test(s.text)) out.set(`guide:${s.text}`, { kind: "guide", text: s.text });
+        break;
+      case "teach_stmt":
+        if (FILE_REF_RE.test(s.text)) out.set(`teach:${s.text}`, { kind: "teach", text: s.text });
+        break;
+      case "interact_stmt":
+        collectFileRefs(s.handlers, out);
+        break;
+      case "intent_handler":
+        if (Array.isArray(s.body)) collectFileRefs(s.body, out);
+        break;
+      case "offtopic_handler":
+      case "after_stmt":
+      case "parallel_stmt":
+        collectFileRefs(s.body, out);
+        break;
+      case "conditional_stmt":
+        collectFileRefs(s.then, out);
+        if (s.else) collectFileRefs(s.else, out);
+        break;
+    }
+  }
+}
+async function collectFiles(dir, descriptionFile, mergedBehaviorText, mergeSources, personaFile) {
   const files = /* @__PURE__ */ new Map();
   async function walk(subdir, prefix = "") {
     try {
@@ -826,17 +900,47 @@ async function collectFiles(dir, descriptionFile, mergedBehaviorText, mergeSourc
   for (const relPath of mergeSources) {
     files.set(`behaviors/${relPath}`, await readFile2(join(dir, relPath), "utf-8"));
   }
-  try {
-    files.set("SOUL.md", await readFile2(join(dir, "SOUL.md"), "utf-8"));
-  } catch {
+  if (personaFile) {
+    if (isExternalPath(dir, personaFile)) {
+      throw new Error(`E014: persona path '${personaFile}' in '${descriptionFile}' is absolute or escapes the agent root`);
+    }
+    let personaText;
+    try {
+      personaText = await readFile2(join(dir, personaFile), "utf-8");
+    } catch {
+      throw new Error(`E_DESC: persona file '${personaFile}' declared in '${descriptionFile}' not found`);
+    }
+    files.set(personaFile, personaText);
   }
   await walk(join(dir, "guides"), "guides");
   await walk(join(dir, "knowledge"), "knowledge");
+  await initBehaviorParser();
+  const behaviorAst = parseBehaviorFile(mergedBehaviorText).ok;
+  if (behaviorAst) {
+    const refs = /* @__PURE__ */ new Map();
+    for (const state of behaviorAst.states) collectFileRefs(state.body, refs);
+    for (const trigger of behaviorAst.global_triggers) collectFileRefs(trigger.body, refs);
+    for (const { kind, text } of refs.values()) {
+      if (isExternalPath(dir, text)) {
+        throw new Error(`E014: '${kind}' path '${text}' is absolute or escapes the agent root`);
+      }
+      let content;
+      try {
+        content = await readFile2(join(dir, text), "utf-8");
+      } catch {
+        throw new Error(`E018: '${kind}' file '${text}' referenced in agent.behavior not found in ${dir}`);
+      }
+      files.set(`${kind === "guide" ? "guides" : "knowledge"}/${text}`, content);
+    }
+  }
   return files;
 }
+function withAgentExtension(path) {
+  return path.endsWith(".agent") ? path : `${path}.agent`;
+}
 async function pack(options = {}) {
   const dir = options.dir ?? process.cwd();
-  const outPath = options.out ?? join(dir, `${basename(dir)}.agent`);
+  const outPath = withAgentExtension(options.out ?? join(dir, basename(dir)));
   const descriptionFileName = await discoverDescriptionFile(dir, options.description);
   const descriptionText = await readFile2(join(dir, descriptionFileName), "utf-8");
   const descriptionMessages = await lintDescription(descriptionText, descriptionFileName);
@@ -871,13 +975,13 @@ ${descErrors.map((e) => `  ${e.file}:${e.line}:${e.col} ${e.code} ${e.message}`)
 ${errors.map((e) => `  ${e.file}:${e.line}:${e.col} ${e.code} ${e.message}`).join("\n")}`
     );
   }
-  const version = await resolveVersion(options.version);
+  const version = await resolveVersionInteractive(options.version);
   const commit = await resolveCommit(options.commit);
-  const allFiles = await collectFiles(dir, descriptionFileName, mergedText, mergeSources);
+  const allFiles = await collectFiles(dir, descriptionFileName, mergedText, mergeSources, df.persona ?? void 0);
   const contentForHash = Array.from(allFiles.values()).join("");
   const sha256 = createHash("sha256").update(contentForHash).digest("hex");
   const namespace = df.agent.domain ?? "unknown";
-  const id = buildId({ namespace, name: df.agent.name, version, digest: commit });
+  const id = buildId({ namespace, name: slugify(df.agent.name), version, digest: version ? commit : void 0 });
   const typesJson = buildTypesJson(df);
   const integrity = {
     sha256,
@@ -888,10 +992,10 @@ ${errors.map((e) => `  ${e.file}:${e.line}:${e.col} ${e.code} ${e.message}`).joi
     id,
     name: df.agent.name,
     description: df.description ?? "",
-    version,
+    version: version ?? "",
     domain: df.agent.domain ?? "",
     license: df.agent.license ?? "",
-    persona: df.persona ?? "SOUL.md",
+    persona: df.persona ?? void 0,
     purpose: "unknown",
     compiler: `dot-agent/${COMPILER_VERSION}`,
     commit,
@@ -909,6 +1013,7 @@ ${errors.map((e) => `  ${e.file}:${e.line}:${e.col} ${e.code} ${e.message}`).joi
   const filesJson = {
     description: descriptionFileName,
     behavior: "agent.behavior",
+    ...df.persona ? { persona: df.persona } : {},
     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))
@@ -962,9 +1067,9 @@ ${errors.map((e) => `  ${e.file}:${e.line}:${e.col} ${e.code} ${e.message}`).joi
     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 allFiles = await collectFiles(dir, descriptionFileName, mergedText, mergeSources, df.persona ?? void 0);
   const sha256 = createHash2("sha256").update(Array.from(allFiles.values()).join("")).digest("hex");
-  const id = buildId({ namespace: df.agent.domain ?? "local", name: df.agent.name, version: "dev" });
+  const id = buildId({ namespace: df.agent.domain ?? "unknown", name: slugify(df.agent.name), version: "dev" });
   const aboutme = buildAboutme({
     id,
     name: df.agent.name,
@@ -972,7 +1077,7 @@ ${errors.map((e) => `  ${e.file}:${e.line}:${e.col} ${e.code} ${e.message}`).joi
     version: "dev",
     domain: df.agent.domain ?? "",
     license: df.agent.license ?? "",
-    persona: df.persona ?? "SOUL.md",
+    persona: df.persona ?? void 0,
     purpose: "development",
     compiler: `dot-agent/${COMPILER_VERSION}`,
     capabilities: df.capabilities.map((c) => ({ id: c.name, description: c.description ?? "" })),
@@ -985,7 +1090,7 @@ ${errors.map((e) => `  ${e.file}:${e.line}:${e.col} ${e.code} ${e.message}`).joi
     // 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"),
+    persona: df.persona ? allFiles.get(df.persona) : void 0,
     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 }))