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

package/dist/{chunk-P5LFGJ6P.js → chunk-AYXHOOUX.js}

@@ -1,6 +1,6 @@
 // src/generated-version.ts
-var DSL_VERSION = "0.1-alpha";
-var COMPILER_VERSION = "0.5.0-alpha.2";
+var DSL_VERSION = "0.1";
+var COMPILER_VERSION = "0.10.0";
 
 // src/manifest.ts
 function parseAboutme(json) {
@@ -8,9 +8,7 @@ function parseAboutme(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");
-  if (!json.version) throw new Error("Missing version in aboutme.json");
   if (!json.domain) throw new Error("Missing domain in aboutme.json");
-  if (!json.persona) throw new Error("Missing persona in aboutme.json");
   if (!json.compiler) throw new Error("Missing compiler in aboutme.json");
   if (!Array.isArray(json.capabilities)) throw new Error("Missing capabilities array in aboutme.json");
   if (!Array.isArray(json.requires)) throw new Error("Missing requires array in aboutme.json");
@@ -20,7 +18,7 @@ function parseAboutme(json) {
     id: json.id,
     name: json.name,
     description: json.description,
-    version: json.version,
+    version: json.version ?? "",
     domain: json.domain,
     license: json.license ?? "",
     persona: json.persona,
@@ -132,7 +130,14 @@ function buildId(parts) {
     result += `:${version}`;
     if (digest) result += `~${digest}`;
   }
-  return result;
+  return result.toLowerCase();
+}
+function slugify(name) {
+  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+var VERSION_RE = /^v?\d+(\.\d+){0,2}(-[0-9A-Za-z.]+)?(\+[0-9A-Za-z.]+)?$/i;
+function isValidVersion(version) {
+  return VERSION_RE.test(version);
 }
 function extractDigest(id) {
   try {
@@ -196,6 +201,8 @@ export {
   aboutmeToJson,
   parseId,
   buildId,
+  slugify,
+  isValidVersion,
   extractDigest,
   extractName,
   validateMagicBytes,
@@ -203,4 +210,4 @@ export {
   createZip,
   extractFiles
 };
-//# sourceMappingURL=chunk-P5LFGJ6P.js.map
+//# sourceMappingURL=chunk-AYXHOOUX.js.map

package/dist/chunk-AYXHOOUX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/generated-version.ts","../src/manifest.ts","../src/id.ts","../src/zip-core.ts"],"sourcesContent":["// Generated by scripts/embed-version.mjs from dsl/VERSION and package.json — do not edit by hand.\nexport const DSL_VERSION = '0.1'\nexport const COMPILER_VERSION = '0.10.0'\n","// Copyright 2026 Danilo Borges\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n\nimport type { AboutMe, BuildAboutmeOptions } from './types.js'\nimport { DSL_VERSION } from './generated-version.js'\n\nexport function parseAboutme(json: any): AboutMe {\n  if (!json.dslVersion) throw new Error('Missing dslVersion in aboutme.json')\n  if (!json.id) throw new Error('Missing id in aboutme.json')\n  if (!json.name) throw new Error('Missing name in aboutme.json')\n  if (!json.description) throw new Error('Missing description in aboutme.json')\n  if (!json.domain) throw new Error('Missing domain in aboutme.json')\n  if (!json.compiler) throw new Error('Missing compiler in aboutme.json')\n  if (!Array.isArray(json.capabilities)) throw new Error('Missing capabilities array in aboutme.json')\n  if (!Array.isArray(json.requires)) throw new Error('Missing requires array in aboutme.json')\n  if (!json.integrity) throw new Error('Missing integrity in aboutme.json')\n\n  return {\n    dslVersion: json.dslVersion,\n    id: json.id,\n    name: json.name,\n    description: json.description,\n    version: json.version ?? '',\n    domain: json.domain,\n    license: json.license ?? '',\n    persona: json.persona,\n    purpose: json.purpose ?? 'unknown',\n    compiler: json.compiler,\n    commit: json.commit,\n    capabilities: json.capabilities,\n    requires: json.requires,\n    integrity: json.integrity,\n  }\n}\n\nexport function buildAboutme(opts: BuildAboutmeOptions): AboutMe {\n  return {\n    dslVersion: `dot-agent/${DSL_VERSION}`,\n    id: opts.id,\n    name: opts.name,\n    description: opts.description,\n    version: opts.version,\n    domain: opts.domain,\n    license: opts.license ?? '',\n    persona: opts.persona,\n    purpose: opts.purpose ?? 'unknown',\n    compiler: opts.compiler,\n    commit: opts.commit,\n    capabilities: opts.capabilities ?? [],\n    requires: opts.requires ?? [],\n    integrity: opts.integrity,\n  }\n}\n\nexport function aboutmeToJson(aboutme: AboutMe): string {\n  return JSON.stringify(aboutme, null, 2)\n}\n","// Copyright 2026 Danilo Borges\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nimport type { IdParts } from './types.js'\n\n// Code hosting platforms whose namespace format is platform/user rather than plain domain.\n// The list is maintained by the compiler and updated via CLI releases.\nexport const KNOWN_PLATFORMS = ['github.com', 'gitlab.com', 'codeberg.org', 'sr.ht'] as const\n\nfunction parseNamespaceName(identifier: string): { namespace: string; name: string } {\n  // Email namespace: @ appears before any /\n  const atIdx = identifier.indexOf('@')\n  if (atIdx !== -1 && (identifier.indexOf('/') === -1 || atIdx < identifier.indexOf('/'))) {\n    const slashIdx = identifier.indexOf('/')\n    if (slashIdx === -1) {\n      throw new Error(`Invalid agent ID: email namespace requires a name after '/' (got '${identifier}')`)\n    }\n    return {\n      namespace: identifier.slice(0, slashIdx),\n      name: identifier.slice(slashIdx + 1),\n    }\n  }\n\n  // Known code-hosting platforms: namespace is platform/user, name is the next segment.\n  for (const platform of KNOWN_PLATFORMS) {\n    if (identifier.startsWith(platform + '/')) {\n      const afterPlatform = identifier.slice(platform.length + 1)\n      const slashIdx = afterPlatform.indexOf('/')\n      if (slashIdx === -1) {\n        throw new Error(\n          `Invalid agent ID: '${platform}' namespace requires a user segment and a name (got '${identifier}')`,\n        )\n      }\n      return {\n        namespace: platform + '/' + afterPlatform.slice(0, slashIdx),\n        name: afterPlatform.slice(slashIdx + 1),\n      }\n    }\n  }\n\n  // Domain or reserved keyword (e.g. 'unknown'): last '/' separates namespace from name.\n  const lastSlash = identifier.lastIndexOf('/')\n  if (lastSlash === -1) {\n    throw new Error(`Invalid agent ID: missing '/' separator in '${identifier}'`)\n  }\n  return {\n    namespace: identifier.slice(0, lastSlash),\n    name: identifier.slice(lastSlash + 1),\n  }\n}\n\nexport function parseId(id: string): IdParts {\n  if (!id) throw new Error('Invalid agent ID: empty string')\n\n  // Phase 1: split on the first ':' to isolate the identifier from version~digest.\n  const colonIdx = id.indexOf(':')\n\n  let identifier: string\n  let version: string | undefined\n  let digest: string | undefined\n\n  if (colonIdx === -1) {\n    // Form A: namespace/name\n    identifier = id\n  } else {\n    identifier = id.slice(0, colonIdx)\n    const rest = id.slice(colonIdx + 1)\n    if (!rest) throw new Error(`Invalid agent ID: empty version after ':' in '${id}'`)\n\n    // Phase 2: split version~digest\n    const tildeIdx = rest.indexOf('~')\n    if (tildeIdx === -1) {\n      // Form B: namespace/name:version\n      version = rest\n    } else {\n      // Form D: namespace/name:version~digest\n      version = rest.slice(0, tildeIdx)\n      digest = rest.slice(tildeIdx + 1)\n      if (!version) throw new Error(`Invalid agent ID: empty version before '~' in '${id}'`)\n      if (!digest) throw new Error(`Invalid agent ID: empty digest after '~' in '${id}'`)\n    }\n  }\n\n  // Phase 3: extract namespace and name from the identifier\n  const { namespace, name } = parseNamespaceName(identifier)\n\n  if (!namespace) throw new Error(`Invalid agent ID: empty namespace in '${id}'`)\n  if (!name) throw new Error(`Invalid agent ID: empty name in '${id}'`)\n\n  return { namespace, name, version, digest }\n}\n\nexport function buildId(parts: IdParts): string {\n  const { namespace, name, version, digest } = parts\n  if (!namespace || !name) {\n    throw new Error('Missing required ID parts: namespace and name')\n  }\n  if (digest && !version) {\n    throw new Error('Invalid ID parts: digest requires version')\n  }\n  let result = `${namespace}/${name}`\n  if (version) {\n    result += `:${version}`\n    if (digest) result += `~${digest}`\n  }\n  // Ids are always lowercase — domains, platform usernames (GitHub/GitLab/\n  // Codeberg/Sourcehut) and email local-parts are all case-insensitive in\n  // practice, so normalizing here is safe and gives every id a single shape.\n  return result.toLowerCase()\n}\n\n// Turns a human display name (e.g. \"Fridge Assistant\", from `agent Fridge\n// Assistant` in the DSL — spaces/capitalization are deliberate there) into\n// the kebab-case slug used for an id's name segment.\nexport function slugify(name: string): string {\n  return name\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '')\n}\n\n// Accepts optional leading 'v' (id spec examples use it; monorepo tags after\n// their '@' split don't), 1-3 dot-separated numeric groups, and optional\n// -prerelease / +build suffixes — e.g. v1.0, 2.3.1, v1.0.0-alpha.1, 1.0+build.\nconst VERSION_RE = /^v?\\d+(\\.\\d+){0,2}(-[0-9A-Za-z.]+)?(\\+[0-9A-Za-z.]+)?$/i\n\nexport function isValidVersion(version: string): boolean {\n  return VERSION_RE.test(version)\n}\n\nexport function extractDigest(id: string): string {\n  try {\n    return parseId(id).digest ?? ''\n  } catch {\n    return ''\n  }\n}\n\nexport function extractName(id: string): string {\n  try {\n    return parseId(id).name\n  } catch {\n    return ''\n  }\n}\n","// Copyright 2026 Danilo Borges\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nimport JSZip from 'jszip'\n\nexport const MAX_ZIP_SIZE = 500 * 1024 * 1024\nexport const MAX_COMPRESSION_RATIO = 100\n\nexport function validateMagicBytes(bytes: Uint8Array): void {\n  if (!(bytes[0] === 0x50 && bytes[1] === 0x4b && bytes[2] === 0x03 && bytes[3] === 0x04)) {\n    throw new Error('Not a valid .agent file (invalid magic bytes)')\n  }\n}\n\nexport function validateZipBomb(zip: JSZip, compressedSize: number): void {\n  let totalUncompressed = 0\n  zip.forEach((_path, file) => {\n    if (!file.dir) totalUncompressed += (file as any)._data?.uncompressedSize || 0\n  })\n  if (totalUncompressed > MAX_ZIP_SIZE) {\n    throw new Error(`Bundle exceeds 500MB uncompressed: ${totalUncompressed}`)\n  }\n  if (totalUncompressed / compressedSize > MAX_COMPRESSION_RATIO) {\n    throw new Error(`Compression ratio exceeds 100x: ${(totalUncompressed / compressedSize).toFixed(1)}x`)\n  }\n}\n\nexport function createZip(): JSZip {\n  return new JSZip()\n}\n\nexport async function extractFiles(zip: JSZip, filter?: string[]): Promise<Map<string, string>> {\n  const files = new Map<string, string>()\n  const promises: Promise<void>[] = []\n\n  zip.forEach((relativePath, file) => {\n    if (file.dir) return\n    if (filter && !filter.some(f => relativePath.startsWith(f))) return\n    promises.push(\n      file.async('text').then(content => {\n        files.set(relativePath, content)\n      })\n    )\n  })\n\n  await Promise.all(promises)\n  return files\n}\n"],"mappings":"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","names":[]}

package/dist/{core-b-7c6X6q.d.cts → core-D2X2Eohl.d.cts}

@@ -45,7 +45,7 @@ interface AboutMe {
     version: string;
     domain: string;
     license: string;
-    persona: string;
+    persona?: string;
     purpose: string;
     compiler: string;
     commit?: string;
@@ -56,7 +56,7 @@ interface AboutMe {
 interface AgentFiles {
     description: string;
     behavior: string;
-    soul?: string;
+    persona?: string;
     guides: Array<{
         path: string;
         content: string;
@@ -94,7 +94,7 @@ interface BuildAboutmeOptions {
     version: string;
     domain: string;
     license?: string;
-    persona: string;
+    persona?: string;
     purpose?: string;
     compiler: string;
     commit?: string;

package/dist/{core-b-7c6X6q.d.ts → core-D2X2Eohl.d.ts}

@@ -45,7 +45,7 @@ interface AboutMe {
     version: string;
     domain: string;
     license: string;
-    persona: string;
+    persona?: string;
     purpose: string;
     compiler: string;
     commit?: string;
@@ -56,7 +56,7 @@ interface AboutMe {
 interface AgentFiles {
     description: string;
     behavior: string;
-    soul?: string;
+    persona?: string;
     guides: Array<{
         path: string;
         content: string;
@@ -94,7 +94,7 @@ interface BuildAboutmeOptions {
     version: string;
     domain: string;
     license?: string;
-    persona: string;
+    persona?: string;
     purpose?: string;
     compiler: string;
     commit?: string;

package/dist/core.cjs

@@ -45,7 +45,7 @@ __export(core_exports, {
 module.exports = __toCommonJS(core_exports);
 
 // src/generated-version.ts
-var DSL_VERSION = "0.1-alpha";
+var DSL_VERSION = "0.1";
 
 // src/manifest.ts
 function parseAboutme(json) {
@@ -53,9 +53,7 @@ function parseAboutme(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");
-  if (!json.version) throw new Error("Missing version in aboutme.json");
   if (!json.domain) throw new Error("Missing domain in aboutme.json");
-  if (!json.persona) throw new Error("Missing persona in aboutme.json");
   if (!json.compiler) throw new Error("Missing compiler in aboutme.json");
   if (!Array.isArray(json.capabilities)) throw new Error("Missing capabilities array in aboutme.json");
   if (!Array.isArray(json.requires)) throw new Error("Missing requires array in aboutme.json");
@@ -65,7 +63,7 @@ function parseAboutme(json) {
     id: json.id,
     name: json.name,
     description: json.description,
-    version: json.version,
+    version: json.version ?? "",
     domain: json.domain,
     license: json.license ?? "",
     persona: json.persona,
@@ -177,7 +175,7 @@ function buildId(parts) {
     result += `:${version}`;
     if (digest) result += `~${digest}`;
   }
-  return result;
+  return result.toLowerCase();
 }
 function extractDigest(id) {
   try {

package/dist/core.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/core.ts","../src/generated-version.ts","../src/manifest.ts","../src/id.ts","../src/zip-core.ts"],"sourcesContent":["// Copyright 2026 Danilo Borges\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\n// Browser-safe sub-path export — no Node.js dependencies.\n// Import via: import { ... } from '@dot-agent/compiler/core'\n\nexport { parseAboutme, buildAboutme, aboutmeToJson } from './manifest.js'\nexport { parseId, buildId, extractDigest, extractName } from './id.js'\nexport { createZip, extractFiles, validateMagicBytes, validateZipBomb } from './zip-core.js'\n\nexport type {\n  AboutMe,\n  AgentBundle,\n  AgentFiles,\n  Capability,\n  AnnotatedRef,\n  DescriptionFile,\n  Integrity,\n  BuildAboutmeOptions,\n  IdParts,\n  LintMessage,\n} from './types.js'\n","// Generated by scripts/embed-version.mjs from dsl/VERSION and package.json — do not edit by hand.\nexport const DSL_VERSION = '0.1-alpha'\nexport const COMPILER_VERSION = '0.5.0-alpha.2'\n","// Copyright 2026 Danilo Borges\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n\nimport type { AboutMe, BuildAboutmeOptions } from './types.js'\nimport { DSL_VERSION } from './generated-version.js'\n\nexport function parseAboutme(json: any): AboutMe {\n  if (!json.dslVersion) throw new Error('Missing dslVersion in aboutme.json')\n  if (!json.id) throw new Error('Missing id in aboutme.json')\n  if (!json.name) throw new Error('Missing name in aboutme.json')\n  if (!json.description) throw new Error('Missing description in aboutme.json')\n  if (!json.version) throw new Error('Missing version in aboutme.json')\n  if (!json.domain) throw new Error('Missing domain in aboutme.json')\n  if (!json.persona) throw new Error('Missing persona in aboutme.json')\n  if (!json.compiler) throw new Error('Missing compiler in aboutme.json')\n  if (!Array.isArray(json.capabilities)) throw new Error('Missing capabilities array in aboutme.json')\n  if (!Array.isArray(json.requires)) throw new Error('Missing requires array in aboutme.json')\n  if (!json.integrity) throw new Error('Missing integrity in aboutme.json')\n\n  return {\n    dslVersion: json.dslVersion,\n    id: json.id,\n    name: json.name,\n    description: json.description,\n    version: json.version,\n    domain: json.domain,\n    license: json.license ?? '',\n    persona: json.persona,\n    purpose: json.purpose ?? 'unknown',\n    compiler: json.compiler,\n    commit: json.commit,\n    capabilities: json.capabilities,\n    requires: json.requires,\n    integrity: json.integrity,\n  }\n}\n\nexport function buildAboutme(opts: BuildAboutmeOptions): AboutMe {\n  return {\n    dslVersion: `dot-agent/${DSL_VERSION}`,\n    id: opts.id,\n    name: opts.name,\n    description: opts.description,\n    version: opts.version,\n    domain: opts.domain,\n    license: opts.license ?? '',\n    persona: opts.persona,\n    purpose: opts.purpose ?? 'unknown',\n    compiler: opts.compiler,\n    commit: opts.commit,\n    capabilities: opts.capabilities ?? [],\n    requires: opts.requires ?? [],\n    integrity: opts.integrity,\n  }\n}\n\nexport function aboutmeToJson(aboutme: AboutMe): string {\n  return JSON.stringify(aboutme, null, 2)\n}\n","// Copyright 2026 Danilo Borges\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nimport type { IdParts } from './types.js'\n\n// Code hosting platforms whose namespace format is platform/user rather than plain domain.\n// The list is maintained by the compiler and updated via CLI releases.\nexport const KNOWN_PLATFORMS = ['github.com', 'gitlab.com', 'codeberg.org', 'sr.ht'] as const\n\nfunction parseNamespaceName(identifier: string): { namespace: string; name: string } {\n  // Email namespace: @ appears before any /\n  const atIdx = identifier.indexOf('@')\n  if (atIdx !== -1 && (identifier.indexOf('/') === -1 || atIdx < identifier.indexOf('/'))) {\n    const slashIdx = identifier.indexOf('/')\n    if (slashIdx === -1) {\n      throw new Error(`Invalid agent ID: email namespace requires a name after '/' (got '${identifier}')`)\n    }\n    return {\n      namespace: identifier.slice(0, slashIdx),\n      name: identifier.slice(slashIdx + 1),\n    }\n  }\n\n  // Known code-hosting platforms: namespace is platform/user, name is the next segment.\n  for (const platform of KNOWN_PLATFORMS) {\n    if (identifier.startsWith(platform + '/')) {\n      const afterPlatform = identifier.slice(platform.length + 1)\n      const slashIdx = afterPlatform.indexOf('/')\n      if (slashIdx === -1) {\n        throw new Error(\n          `Invalid agent ID: '${platform}' namespace requires a user segment and a name (got '${identifier}')`,\n        )\n      }\n      return {\n        namespace: platform + '/' + afterPlatform.slice(0, slashIdx),\n        name: afterPlatform.slice(slashIdx + 1),\n      }\n    }\n  }\n\n  // Domain or reserved keyword (e.g. 'unknown'): last '/' separates namespace from name.\n  const lastSlash = identifier.lastIndexOf('/')\n  if (lastSlash === -1) {\n    throw new Error(`Invalid agent ID: missing '/' separator in '${identifier}'`)\n  }\n  return {\n    namespace: identifier.slice(0, lastSlash),\n    name: identifier.slice(lastSlash + 1),\n  }\n}\n\nexport function parseId(id: string): IdParts {\n  if (!id) throw new Error('Invalid agent ID: empty string')\n\n  // Phase 1: split on the first ':' to isolate the identifier from version~digest.\n  const colonIdx = id.indexOf(':')\n\n  let identifier: string\n  let version: string | undefined\n  let digest: string | undefined\n\n  if (colonIdx === -1) {\n    // Form A: namespace/name\n    identifier = id\n  } else {\n    identifier = id.slice(0, colonIdx)\n    const rest = id.slice(colonIdx + 1)\n    if (!rest) throw new Error(`Invalid agent ID: empty version after ':' in '${id}'`)\n\n    // Phase 2: split version~digest\n    const tildeIdx = rest.indexOf('~')\n    if (tildeIdx === -1) {\n      // Form B: namespace/name:version\n      version = rest\n    } else {\n      // Form D: namespace/name:version~digest\n      version = rest.slice(0, tildeIdx)\n      digest = rest.slice(tildeIdx + 1)\n      if (!version) throw new Error(`Invalid agent ID: empty version before '~' in '${id}'`)\n      if (!digest) throw new Error(`Invalid agent ID: empty digest after '~' in '${id}'`)\n    }\n  }\n\n  // Phase 3: extract namespace and name from the identifier\n  const { namespace, name } = parseNamespaceName(identifier)\n\n  if (!namespace) throw new Error(`Invalid agent ID: empty namespace in '${id}'`)\n  if (!name) throw new Error(`Invalid agent ID: empty name in '${id}'`)\n\n  return { namespace, name, version, digest }\n}\n\nexport function buildId(parts: IdParts): string {\n  const { namespace, name, version, digest } = parts\n  if (!namespace || !name) {\n    throw new Error('Missing required ID parts: namespace and name')\n  }\n  if (digest && !version) {\n    throw new Error('Invalid ID parts: digest requires version')\n  }\n  let result = `${namespace}/${name}`\n  if (version) {\n    result += `:${version}`\n    if (digest) result += `~${digest}`\n  }\n  return result\n}\n\nexport function extractDigest(id: string): string {\n  try {\n    return parseId(id).digest ?? ''\n  } catch {\n    return ''\n  }\n}\n\nexport function extractName(id: string): string {\n  try {\n    return parseId(id).name\n  } catch {\n    return ''\n  }\n}\n","// Copyright 2026 Danilo Borges\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nimport JSZip from 'jszip'\n\nexport const MAX_ZIP_SIZE = 500 * 1024 * 1024\nexport const MAX_COMPRESSION_RATIO = 100\n\nexport function validateMagicBytes(bytes: Uint8Array): void {\n  if (!(bytes[0] === 0x50 && bytes[1] === 0x4b && bytes[2] === 0x03 && bytes[3] === 0x04)) {\n    throw new Error('Not a valid .agent file (invalid magic bytes)')\n  }\n}\n\nexport function validateZipBomb(zip: JSZip, compressedSize: number): void {\n  let totalUncompressed = 0\n  zip.forEach((_path, file) => {\n    if (!file.dir) totalUncompressed += (file as any)._data?.uncompressedSize || 0\n  })\n  if (totalUncompressed > MAX_ZIP_SIZE) {\n    throw new Error(`Bundle exceeds 500MB uncompressed: ${totalUncompressed}`)\n  }\n  if (totalUncompressed / compressedSize > MAX_COMPRESSION_RATIO) {\n    throw new Error(`Compression ratio exceeds 100x: ${(totalUncompressed / compressedSize).toFixed(1)}x`)\n  }\n}\n\nexport function createZip(): JSZip {\n  return new JSZip()\n}\n\nexport async function extractFiles(zip: JSZip, filter?: string[]): Promise<Map<string, string>> {\n  const files = new Map<string, string>()\n  const promises: Promise<void>[] = []\n\n  zip.forEach((relativePath, file) => {\n    if (file.dir) return\n    if (filter && !filter.some(f => relativePath.startsWith(f))) return\n    promises.push(\n      file.async('text').then(content => {\n        files.set(relativePath, content)\n      })\n    )\n  })\n\n  await Promise.all(promises)\n  return files\n}\n"],"mappings":"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","names":["JSZip"]}
+{"version":3,"sources":["../src/core.ts","../src/generated-version.ts","../src/manifest.ts","../src/id.ts","../src/zip-core.ts"],"sourcesContent":["// Copyright 2026 Danilo Borges\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\n// Browser-safe sub-path export — no Node.js dependencies.\n// Import via: import { ... } from '@dot-agent/compiler/core'\n\nexport { parseAboutme, buildAboutme, aboutmeToJson } from './manifest.js'\nexport { parseId, buildId, extractDigest, extractName } from './id.js'\nexport { createZip, extractFiles, validateMagicBytes, validateZipBomb } from './zip-core.js'\n\nexport type {\n  AboutMe,\n  AgentBundle,\n  AgentFiles,\n  Capability,\n  AnnotatedRef,\n  DescriptionFile,\n  Integrity,\n  BuildAboutmeOptions,\n  IdParts,\n  LintMessage,\n} from './types.js'\n","// Generated by scripts/embed-version.mjs from dsl/VERSION and package.json — do not edit by hand.\nexport const DSL_VERSION = '0.1'\nexport const COMPILER_VERSION = '0.10.0'\n","// Copyright 2026 Danilo Borges\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n\nimport type { AboutMe, BuildAboutmeOptions } from './types.js'\nimport { DSL_VERSION } from './generated-version.js'\n\nexport function parseAboutme(json: any): AboutMe {\n  if (!json.dslVersion) throw new Error('Missing dslVersion in aboutme.json')\n  if (!json.id) throw new Error('Missing id in aboutme.json')\n  if (!json.name) throw new Error('Missing name in aboutme.json')\n  if (!json.description) throw new Error('Missing description in aboutme.json')\n  if (!json.domain) throw new Error('Missing domain in aboutme.json')\n  if (!json.compiler) throw new Error('Missing compiler in aboutme.json')\n  if (!Array.isArray(json.capabilities)) throw new Error('Missing capabilities array in aboutme.json')\n  if (!Array.isArray(json.requires)) throw new Error('Missing requires array in aboutme.json')\n  if (!json.integrity) throw new Error('Missing integrity in aboutme.json')\n\n  return {\n    dslVersion: json.dslVersion,\n    id: json.id,\n    name: json.name,\n    description: json.description,\n    version: json.version ?? '',\n    domain: json.domain,\n    license: json.license ?? '',\n    persona: json.persona,\n    purpose: json.purpose ?? 'unknown',\n    compiler: json.compiler,\n    commit: json.commit,\n    capabilities: json.capabilities,\n    requires: json.requires,\n    integrity: json.integrity,\n  }\n}\n\nexport function buildAboutme(opts: BuildAboutmeOptions): AboutMe {\n  return {\n    dslVersion: `dot-agent/${DSL_VERSION}`,\n    id: opts.id,\n    name: opts.name,\n    description: opts.description,\n    version: opts.version,\n    domain: opts.domain,\n    license: opts.license ?? '',\n    persona: opts.persona,\n    purpose: opts.purpose ?? 'unknown',\n    compiler: opts.compiler,\n    commit: opts.commit,\n    capabilities: opts.capabilities ?? [],\n    requires: opts.requires ?? [],\n    integrity: opts.integrity,\n  }\n}\n\nexport function aboutmeToJson(aboutme: AboutMe): string {\n  return JSON.stringify(aboutme, null, 2)\n}\n","// Copyright 2026 Danilo Borges\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nimport type { IdParts } from './types.js'\n\n// Code hosting platforms whose namespace format is platform/user rather than plain domain.\n// The list is maintained by the compiler and updated via CLI releases.\nexport const KNOWN_PLATFORMS = ['github.com', 'gitlab.com', 'codeberg.org', 'sr.ht'] as const\n\nfunction parseNamespaceName(identifier: string): { namespace: string; name: string } {\n  // Email namespace: @ appears before any /\n  const atIdx = identifier.indexOf('@')\n  if (atIdx !== -1 && (identifier.indexOf('/') === -1 || atIdx < identifier.indexOf('/'))) {\n    const slashIdx = identifier.indexOf('/')\n    if (slashIdx === -1) {\n      throw new Error(`Invalid agent ID: email namespace requires a name after '/' (got '${identifier}')`)\n    }\n    return {\n      namespace: identifier.slice(0, slashIdx),\n      name: identifier.slice(slashIdx + 1),\n    }\n  }\n\n  // Known code-hosting platforms: namespace is platform/user, name is the next segment.\n  for (const platform of KNOWN_PLATFORMS) {\n    if (identifier.startsWith(platform + '/')) {\n      const afterPlatform = identifier.slice(platform.length + 1)\n      const slashIdx = afterPlatform.indexOf('/')\n      if (slashIdx === -1) {\n        throw new Error(\n          `Invalid agent ID: '${platform}' namespace requires a user segment and a name (got '${identifier}')`,\n        )\n      }\n      return {\n        namespace: platform + '/' + afterPlatform.slice(0, slashIdx),\n        name: afterPlatform.slice(slashIdx + 1),\n      }\n    }\n  }\n\n  // Domain or reserved keyword (e.g. 'unknown'): last '/' separates namespace from name.\n  const lastSlash = identifier.lastIndexOf('/')\n  if (lastSlash === -1) {\n    throw new Error(`Invalid agent ID: missing '/' separator in '${identifier}'`)\n  }\n  return {\n    namespace: identifier.slice(0, lastSlash),\n    name: identifier.slice(lastSlash + 1),\n  }\n}\n\nexport function parseId(id: string): IdParts {\n  if (!id) throw new Error('Invalid agent ID: empty string')\n\n  // Phase 1: split on the first ':' to isolate the identifier from version~digest.\n  const colonIdx = id.indexOf(':')\n\n  let identifier: string\n  let version: string | undefined\n  let digest: string | undefined\n\n  if (colonIdx === -1) {\n    // Form A: namespace/name\n    identifier = id\n  } else {\n    identifier = id.slice(0, colonIdx)\n    const rest = id.slice(colonIdx + 1)\n    if (!rest) throw new Error(`Invalid agent ID: empty version after ':' in '${id}'`)\n\n    // Phase 2: split version~digest\n    const tildeIdx = rest.indexOf('~')\n    if (tildeIdx === -1) {\n      // Form B: namespace/name:version\n      version = rest\n    } else {\n      // Form D: namespace/name:version~digest\n      version = rest.slice(0, tildeIdx)\n      digest = rest.slice(tildeIdx + 1)\n      if (!version) throw new Error(`Invalid agent ID: empty version before '~' in '${id}'`)\n      if (!digest) throw new Error(`Invalid agent ID: empty digest after '~' in '${id}'`)\n    }\n  }\n\n  // Phase 3: extract namespace and name from the identifier\n  const { namespace, name } = parseNamespaceName(identifier)\n\n  if (!namespace) throw new Error(`Invalid agent ID: empty namespace in '${id}'`)\n  if (!name) throw new Error(`Invalid agent ID: empty name in '${id}'`)\n\n  return { namespace, name, version, digest }\n}\n\nexport function buildId(parts: IdParts): string {\n  const { namespace, name, version, digest } = parts\n  if (!namespace || !name) {\n    throw new Error('Missing required ID parts: namespace and name')\n  }\n  if (digest && !version) {\n    throw new Error('Invalid ID parts: digest requires version')\n  }\n  let result = `${namespace}/${name}`\n  if (version) {\n    result += `:${version}`\n    if (digest) result += `~${digest}`\n  }\n  // Ids are always lowercase — domains, platform usernames (GitHub/GitLab/\n  // Codeberg/Sourcehut) and email local-parts are all case-insensitive in\n  // practice, so normalizing here is safe and gives every id a single shape.\n  return result.toLowerCase()\n}\n\n// Turns a human display name (e.g. \"Fridge Assistant\", from `agent Fridge\n// Assistant` in the DSL — spaces/capitalization are deliberate there) into\n// the kebab-case slug used for an id's name segment.\nexport function slugify(name: string): string {\n  return name\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '')\n}\n\n// Accepts optional leading 'v' (id spec examples use it; monorepo tags after\n// their '@' split don't), 1-3 dot-separated numeric groups, and optional\n// -prerelease / +build suffixes — e.g. v1.0, 2.3.1, v1.0.0-alpha.1, 1.0+build.\nconst VERSION_RE = /^v?\\d+(\\.\\d+){0,2}(-[0-9A-Za-z.]+)?(\\+[0-9A-Za-z.]+)?$/i\n\nexport function isValidVersion(version: string): boolean {\n  return VERSION_RE.test(version)\n}\n\nexport function extractDigest(id: string): string {\n  try {\n    return parseId(id).digest ?? ''\n  } catch {\n    return ''\n  }\n}\n\nexport function extractName(id: string): string {\n  try {\n    return parseId(id).name\n  } catch {\n    return ''\n  }\n}\n","// Copyright 2026 Danilo Borges\n//\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n//     http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nimport JSZip from 'jszip'\n\nexport const MAX_ZIP_SIZE = 500 * 1024 * 1024\nexport const MAX_COMPRESSION_RATIO = 100\n\nexport function validateMagicBytes(bytes: Uint8Array): void {\n  if (!(bytes[0] === 0x50 && bytes[1] === 0x4b && bytes[2] === 0x03 && bytes[3] === 0x04)) {\n    throw new Error('Not a valid .agent file (invalid magic bytes)')\n  }\n}\n\nexport function validateZipBomb(zip: JSZip, compressedSize: number): void {\n  let totalUncompressed = 0\n  zip.forEach((_path, file) => {\n    if (!file.dir) totalUncompressed += (file as any)._data?.uncompressedSize || 0\n  })\n  if (totalUncompressed > MAX_ZIP_SIZE) {\n    throw new Error(`Bundle exceeds 500MB uncompressed: ${totalUncompressed}`)\n  }\n  if (totalUncompressed / compressedSize > MAX_COMPRESSION_RATIO) {\n    throw new Error(`Compression ratio exceeds 100x: ${(totalUncompressed / compressedSize).toFixed(1)}x`)\n  }\n}\n\nexport function createZip(): JSZip {\n  return new JSZip()\n}\n\nexport async function extractFiles(zip: JSZip, filter?: string[]): Promise<Map<string, string>> {\n  const files = new Map<string, string>()\n  const promises: Promise<void>[] = []\n\n  zip.forEach((relativePath, file) => {\n    if (file.dir) return\n    if (filter && !filter.some(f => relativePath.startsWith(f))) return\n    promises.push(\n      file.async('text').then(content => {\n        files.set(relativePath, content)\n      })\n    )\n  })\n\n  await Promise.all(promises)\n  return files\n}\n"],"mappings":"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","names":["JSZip"]}

package/dist/core.d.cts

@@ -1,3 +1,3 @@
-export { d as AboutMe, A as AgentBundle, e as AgentFiles, B as BuildAboutmeOptions, C as Capability, I as IdParts, f as Integrity, a as LintMessage, g as aboutmeToJson, h as buildAboutme, i as buildId, j as createZip, k as extractDigest, l as extractFiles, m as extractName, p as parseAboutme, n as parseId, v as validateMagicBytes, o as validateZipBomb } from './core-b-7c6X6q.cjs';
+export { d as AboutMe, A as AgentBundle, e as AgentFiles, B as BuildAboutmeOptions, C as Capability, I as IdParts, f as Integrity, a as LintMessage, g as aboutmeToJson, h as buildAboutme, i as buildId, j as createZip, k as extractDigest, l as extractFiles, m as extractName, p as parseAboutme, n as parseId, v as validateMagicBytes, o as validateZipBomb } from './core-D2X2Eohl.cjs';
 export { AnnotatedRef, DescriptionFile } from '@dot-agent/parser-dsl';
 import 'jszip';

package/dist/core.d.ts

@@ -1,3 +1,3 @@
-export { d as AboutMe, A as AgentBundle, e as AgentFiles, B as BuildAboutmeOptions, C as Capability, I as IdParts, f as Integrity, a as LintMessage, g as aboutmeToJson, h as buildAboutme, i as buildId, j as createZip, k as extractDigest, l as extractFiles, m as extractName, p as parseAboutme, n as parseId, v as validateMagicBytes, o as validateZipBomb } from './core-b-7c6X6q.js';
+export { d as AboutMe, A as AgentBundle, e as AgentFiles, B as BuildAboutmeOptions, C as Capability, I as IdParts, f as Integrity, a as LintMessage, g as aboutmeToJson, h as buildAboutme, i as buildId, j as createZip, k as extractDigest, l as extractFiles, m as extractName, p as parseAboutme, n as parseId, v as validateMagicBytes, o as validateZipBomb } from './core-D2X2Eohl.js';
 export { AnnotatedRef, DescriptionFile } from '@dot-agent/parser-dsl';
 import 'jszip';

package/dist/core.js

@@ -10,7 +10,7 @@ import {
   parseId,
   validateMagicBytes,
   validateZipBomb
-} from "./chunk-P5LFGJ6P.js";
+} from "./chunk-AYXHOOUX.js";
 export {
   aboutmeToJson,
   buildAboutme,

package/dist/index.cjs

@@ -677,8 +677,8 @@ async function createLinter() {
 }
 
 // src/generated-version.ts
-var DSL_VERSION = "0.1-alpha";
-var COMPILER_VERSION = "0.5.0-alpha.2";
+var DSL_VERSION = "0.1";
+var COMPILER_VERSION = "0.10.0";
 
 // src/manifest.ts
 function parseAboutme(json) {
@@ -686,9 +686,7 @@ function parseAboutme(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");
-  if (!json.version) throw new Error("Missing version in aboutme.json");
   if (!json.domain) throw new Error("Missing domain in aboutme.json");
-  if (!json.persona) throw new Error("Missing persona in aboutme.json");
   if (!json.compiler) throw new Error("Missing compiler in aboutme.json");
   if (!Array.isArray(json.capabilities)) throw new Error("Missing capabilities array in aboutme.json");
   if (!Array.isArray(json.requires)) throw new Error("Missing requires array in aboutme.json");
@@ -698,7 +696,7 @@ function parseAboutme(json) {
     id: json.id,
     name: json.name,
     description: json.description,
-    version: json.version,
+    version: json.version ?? "",
     domain: json.domain,
     license: json.license ?? "",
     persona: json.persona,
@@ -810,7 +808,14 @@ function buildId(parts) {
     result += `:${version}`;
     if (digest) result += `~${digest}`;
   }
-  return result;
+  return result.toLowerCase();
+}
+function slugify(name) {
+  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+var VERSION_RE = /^v?\d+(\.\d+){0,2}(-[0-9A-Za-z.]+)?(\+[0-9A-Za-z.]+)?$/i;
+function isValidVersion(version) {
+  return VERSION_RE.test(version);
 }
 function extractDigest(id) {
   try {
@@ -954,13 +959,6 @@ function buildTypesJson(df) {
 }
 
 // src/pack.ts
-function gitDescribeTags() {
-  try {
-    return (0, import_child_process.execSync)("git describe --tags --abbrev=0", { stdio: "pipe", encoding: "utf-8" }).trim();
-  } catch {
-    return null;
-  }
-}
 function gitRevParseShort() {
   try {
     return (0, import_child_process.execSync)("git rev-parse --short HEAD", { stdio: "pipe", encoding: "utf-8" }).trim();
@@ -968,14 +966,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 = (0, import_child_process.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 ((0, import_path2.isAbsolute)(declaredPath)) return true;
   const normRoot = (0, import_path2.normalize)((0, import_path2.resolve)(agentRoot));
@@ -1050,7 +1099,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 {
@@ -1075,17 +1152,47 @@ async function collectFiles(dir, descriptionFile, mergedBehaviorText, mergeSourc
   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 {
+  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 (0, import_promises2.readFile)((0, import_path2.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((0, import_path2.join)(dir, "guides"), "guides");
   await walk((0, import_path2.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 (0, import_promises2.readFile)((0, import_path2.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 ?? (0, import_path2.join)(dir, `${(0, import_path2.basename)(dir)}.agent`);
+  const outPath = withAgentExtension(options.out ?? (0, import_path2.join)(dir, (0, import_path2.basename)(dir)));
   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);
@@ -1120,13 +1227,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 = (0, import_crypto.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,
@@ -1137,10 +1244,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,
@@ -1158,6 +1265,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))
@@ -1211,9 +1319,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 = (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 id = buildId({ namespace: df.agent.domain ?? "unknown", name: slugify(df.agent.name), version: "dev" });
   const aboutme = buildAboutme({
     id,
     name: df.agent.name,
@@ -1221,7 +1329,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 ?? "" })),
@@ -1234,7 +1342,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 }))