agentpacks 0.9.0 → 1.0.0

package/dist/targets/mistral-vibe.js

@@ -0,0 +1,661 @@
+// @bun
+var __require = import.meta.require;
+
+// src/utils/filesystem.ts
+import {
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  writeFileSync,
+  readdirSync,
+  rmSync,
+  statSync
+} from "fs";
+import { dirname, relative, join } from "path";
+var GENERATED_HEADER_MD = "<!-- Generated by agentpacks. DO NOT EDIT. -->";
+var GENERATED_HEADER_JSON = "// Generated by agentpacks. DO NOT EDIT.";
+var GENERATED_HEADER_JS = "// Generated by agentpacks. DO NOT EDIT.";
+function writeGeneratedFile(filepath, content, options = {}) {
+  const { header = true, type } = options;
+  const ext = type ?? inferFileType(filepath);
+  ensureDir(dirname(filepath));
+  let output = content;
+  if (header) {
+    const headerComment = getHeader(ext);
+    if (headerComment) {
+      output = `${headerComment}
+${content}`;
+    }
+  }
+  writeFileSync(filepath, output, "utf-8");
+}
+function writeGeneratedJson(filepath, data, options = {}) {
+  const json = JSON.stringify(data, null, 2);
+  writeGeneratedFile(filepath, json + `
+`, { ...options, type: "json" });
+}
+function readFileOrNull(filepath) {
+  if (!existsSync(filepath))
+    return null;
+  return readFileSync(filepath, "utf-8");
+}
+function readJsonOrNull(filepath) {
+  const content = readFileOrNull(filepath);
+  if (content === null)
+    return null;
+  return JSON.parse(content);
+}
+function ensureDir(dirPath) {
+  if (!existsSync(dirPath)) {
+    mkdirSync(dirPath, { recursive: true });
+  }
+}
+function removeIfExists(targetPath) {
+  if (existsSync(targetPath)) {
+    rmSync(targetPath, { recursive: true, force: true });
+  }
+}
+function listFiles(dirPath, options = {}) {
+  const { extension, recursive = false } = options;
+  if (!existsSync(dirPath))
+    return [];
+  const results = [];
+  const entries = readdirSync(dirPath);
+  for (const entry of entries) {
+    const fullPath = join(dirPath, entry);
+    const stat = statSync(fullPath);
+    if (stat.isDirectory() && recursive) {
+      results.push(...listFiles(fullPath, options));
+    } else if (stat.isFile()) {
+      if (!extension || entry.endsWith(extension)) {
+        results.push(fullPath);
+      }
+    }
+  }
+  return results;
+}
+function listDirs(dirPath) {
+  if (!existsSync(dirPath))
+    return [];
+  return readdirSync(dirPath).map((entry) => join(dirPath, entry)).filter((fullPath) => statSync(fullPath).isDirectory());
+}
+function relPath(projectRoot, filepath) {
+  return relative(projectRoot, filepath);
+}
+function isGeneratedFile(filepath) {
+  const content = readFileOrNull(filepath);
+  if (!content)
+    return false;
+  return content.startsWith(GENERATED_HEADER_MD) || content.startsWith(GENERATED_HEADER_JSON) || content.startsWith(GENERATED_HEADER_JS);
+}
+function inferFileType(filepath) {
+  if (filepath.endsWith(".json") || filepath.endsWith(".jsonc"))
+    return "json";
+  if (filepath.endsWith(".ts") || filepath.endsWith(".mts"))
+    return "ts";
+  if (filepath.endsWith(".js") || filepath.endsWith(".mjs"))
+    return "js";
+  return "md";
+}
+function getHeader(type) {
+  switch (type) {
+    case "md":
+      return GENERATED_HEADER_MD;
+    case "json":
+      return GENERATED_HEADER_JSON;
+    case "js":
+    case "ts":
+      return GENERATED_HEADER_JS;
+    default:
+      return null;
+  }
+}
+
+// src/utils/frontmatter.ts
+import matter from "gray-matter";
+function parseFrontmatter(source) {
+  const { data, content } = matter(source);
+  return {
+    data,
+    content: content.trim(),
+    raw: source
+  };
+}
+function serializeFrontmatter(data, content) {
+  const filtered = Object.fromEntries(Object.entries(data).filter(([, v]) => v !== undefined));
+  if (Object.keys(filtered).length === 0) {
+    return content;
+  }
+  return matter.stringify(content, filtered);
+}
+
+// src/features/rules.ts
+import { readFileSync as readFileSync2 } from "fs";
+import { basename } from "path";
+function parseRules(rulesDir, packName) {
+  const files = listFiles(rulesDir, { extension: ".md" });
+  return files.map((filepath) => parseRuleFile(filepath, packName));
+}
+function parseRuleFile(filepath, packName) {
+  const raw = readFileSync2(filepath, "utf-8");
+  const { data, content } = parseFrontmatter(raw);
+  return {
+    name: basename(filepath, ".md"),
+    sourcePath: filepath,
+    packName,
+    meta: data,
+    content
+  };
+}
+function ruleMatchesTarget(rule, targetId) {
+  const { targets } = rule.meta;
+  if (!targets || targets === "*")
+    return true;
+  if (Array.isArray(targets) && targets.includes("*"))
+    return true;
+  return Array.isArray(targets) && targets.includes(targetId);
+}
+function getRootRules(rules) {
+  return rules.filter((r) => r.meta.root === true);
+}
+function getDetailRules(rules) {
+  return rules.filter((r) => r.meta.root !== true);
+}
+
+// src/features/commands.ts
+import { readFileSync as readFileSync3 } from "fs";
+import { basename as basename2 } from "path";
+function parseCommands(commandsDir, packName) {
+  const files = listFiles(commandsDir, { extension: ".md" });
+  return files.map((filepath) => parseCommandFile(filepath, packName));
+}
+function parseCommandFile(filepath, packName) {
+  const raw = readFileSync3(filepath, "utf-8");
+  const { data, content } = parseFrontmatter(raw);
+  return {
+    name: basename2(filepath, ".md"),
+    sourcePath: filepath,
+    packName,
+    meta: data,
+    content
+  };
+}
+function commandMatchesTarget(cmd, targetId) {
+  const { targets } = cmd.meta;
+  if (!targets || targets === "*")
+    return true;
+  if (Array.isArray(targets) && targets.includes("*"))
+    return true;
+  return Array.isArray(targets) && targets.includes(targetId);
+}
+
+// src/features/agents.ts
+import { readFileSync as readFileSync4 } from "fs";
+import { basename as basename3 } from "path";
+function parseAgents(agentsDir, packName) {
+  const files = listFiles(agentsDir, { extension: ".md" });
+  return files.map((filepath) => parseAgentFile(filepath, packName));
+}
+function parseAgentFile(filepath, packName) {
+  const raw = readFileSync4(filepath, "utf-8");
+  const { data, content } = parseFrontmatter(raw);
+  return {
+    name: data.name ?? basename3(filepath, ".md"),
+    sourcePath: filepath,
+    packName,
+    meta: data,
+    content
+  };
+}
+function agentMatchesTarget(agent, targetId) {
+  const { targets } = agent.meta;
+  if (!targets || targets === "*")
+    return true;
+  if (Array.isArray(targets) && targets.includes("*"))
+    return true;
+  return Array.isArray(targets) && targets.includes(targetId);
+}
+
+// src/features/skills.ts
+import { readFileSync as readFileSync5, existsSync as existsSync2 } from "fs";
+import { basename as basename4, join as join2 } from "path";
+var SKILL_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+var SKILL_NAME_MAX_LENGTH = 64;
+function parseSkills(skillsDir, packName) {
+  const dirs = listDirs(skillsDir);
+  const skills = [];
+  for (const dir of dirs) {
+    const skillMd = join2(dir, "SKILL.md");
+    if (existsSync2(skillMd)) {
+      skills.push(parseSkillFile(skillMd, dir, packName));
+    }
+  }
+  return skills;
+}
+function parseSkillFile(filepath, skillDir, packName) {
+  const raw = readFileSync5(filepath, "utf-8");
+  const { data, content } = parseFrontmatter(raw);
+  return {
+    name: data.name ?? basename4(skillDir),
+    sourcePath: filepath,
+    sourceDir: skillDir,
+    packName,
+    meta: data,
+    content
+  };
+}
+function buildSkillFrontmatter(skill) {
+  return {
+    ...skill.meta,
+    name: skill.name
+  };
+}
+function serializeSkill(skill) {
+  return serializeFrontmatter(buildSkillFrontmatter(skill), skill.content);
+}
+function normalizeImportedSkillMarkdown(source, skillName) {
+  const { data, content } = parseFrontmatter(source);
+  const normalized = {
+    ...data,
+    name: skillName
+  };
+  let addedDescription = false;
+  const description = normalized.description;
+  if (typeof description !== "string" || description.trim().length === 0) {
+    normalized.description = `Imported skill: ${skillName}`;
+    addedDescription = true;
+  }
+  return {
+    content: serializeFrontmatter(normalized, content),
+    addedDescription
+  };
+}
+function validateAgentSkillsFrontmatter(skill) {
+  const errors = [];
+  const dirName = basename4(skill.sourceDir);
+  const declaredName = skill.meta.name;
+  if (typeof declaredName !== "string" || declaredName.trim().length === 0) {
+    errors.push('Missing required frontmatter field "name".');
+  } else {
+    if (declaredName.length > SKILL_NAME_MAX_LENGTH) {
+      errors.push(`Invalid "name": must be at most ${SKILL_NAME_MAX_LENGTH} characters.`);
+    }
+    if (!SKILL_NAME_PATTERN.test(declaredName)) {
+      errors.push('Invalid "name": use lowercase letters, numbers, and single hyphens only.');
+    }
+    if (declaredName !== dirName) {
+      errors.push(`Invalid "name": must match containing directory "${dirName}".`);
+    }
+  }
+  const description = skill.meta.description;
+  if (typeof description !== "string" || description.trim().length === 0) {
+    errors.push('Missing required frontmatter field "description".');
+  }
+  const allowedTools = skill.meta["allowed-tools"];
+  if (allowedTools !== undefined && (!Array.isArray(allowedTools) || allowedTools.some((tool) => typeof tool !== "string" || tool.length === 0))) {
+    errors.push('Invalid "allowed-tools": expected an array of non-empty strings.');
+  }
+  return errors;
+}
+function skillMatchesTarget(skill, targetId) {
+  const { targets } = skill.meta;
+  if (!targets || targets === "*")
+    return true;
+  if (Array.isArray(targets) && targets.includes("*"))
+    return true;
+  return Array.isArray(targets) && targets.includes(targetId);
+}
+
+// src/core/profile-resolver.ts
+function resolveModels(merged, modelProfile, targetId) {
+  let defaultModel = merged.default;
+  let smallModel = merged.small;
+  let agents = { ...merged.agents };
+  if (modelProfile && merged.profiles?.[modelProfile]) {
+    const resolvedProfile = resolveProfileInheritance(modelProfile, merged.profiles);
+    if (resolvedProfile.default)
+      defaultModel = resolvedProfile.default;
+    if (resolvedProfile.small)
+      smallModel = resolvedProfile.small;
+    if (resolvedProfile.agents) {
+      agents = { ...agents, ...resolvedProfile.agents };
+    }
+  }
+  if (targetId) {
+    const targetOverride = merged.overrides?.[targetId];
+    if (targetOverride) {
+      if (targetOverride.default)
+        defaultModel = targetOverride.default;
+      if (targetOverride.small)
+        smallModel = targetOverride.small;
+      if (targetOverride.agents) {
+        agents = { ...agents, ...targetOverride.agents };
+      }
+    }
+  }
+  const providers = {};
+  if (merged.providers) {
+    for (const [name, config] of Object.entries(merged.providers)) {
+      providers[name] = {
+        ...config.options ? { options: config.options } : {},
+        ...config.models ? { models: config.models } : {}
+      };
+    }
+  }
+  const profileNames = Object.keys(merged.profiles ?? {});
+  const profiles = {};
+  if (merged.profiles) {
+    for (const [name, profile] of Object.entries(merged.profiles)) {
+      profiles[name] = {
+        description: profile.description,
+        default: profile.default,
+        small: profile.small
+      };
+    }
+  }
+  return {
+    default: defaultModel,
+    small: smallModel,
+    agents,
+    providers,
+    routing: merged.routing ?? [],
+    profileNames,
+    activeProfile: modelProfile,
+    profiles
+  };
+}
+function resolveAgentModel(resolved, agentName, frontmatterModel) {
+  const fromModels = resolved.agents[agentName];
+  if (fromModels) {
+    return {
+      model: fromModels.model,
+      temperature: fromModels.temperature,
+      top_p: fromModels.top_p
+    };
+  }
+  if (frontmatterModel) {
+    return { model: frontmatterModel };
+  }
+  return {};
+}
+function resolveProfileInheritance(profileName, profiles) {
+  const visited = new Set;
+  return resolveProfileChain(profileName, profiles, visited, 0);
+}
+var MAX_INHERITANCE_DEPTH = 10;
+function resolveProfileChain(name, profiles, visited, depth) {
+  if (depth > MAX_INHERITANCE_DEPTH) {
+    throw new Error(`Profile inheritance too deep (max ${MAX_INHERITANCE_DEPTH}): ${name}`);
+  }
+  if (visited.has(name)) {
+    throw new Error(`Circular profile inheritance detected: ${[...visited, name].join(" \u2192 ")}`);
+  }
+  const profile = profiles[name];
+  if (!profile) {
+    throw new Error(`Profile "${name}" not found`);
+  }
+  visited.add(name);
+  if (!profile.extends) {
+    return { ...profile };
+  }
+  const parent = resolveProfileChain(profile.extends, profiles, visited, depth + 1);
+  return {
+    description: profile.description ?? parent.description,
+    default: profile.default ?? parent.default,
+    small: profile.small ?? parent.small,
+    agents: {
+      ...parent.agents,
+      ...profile.agents
+    }
+  };
+}
+
+// src/targets/base-target.ts
+class BaseTarget {
+  supportsFeature(feature) {
+    return this.supportedFeatures.includes(feature);
+  }
+  getEffectiveFeatures(enabledFeatures) {
+    return enabledFeatures.filter((f) => this.supportsFeature(f));
+  }
+  createResult(filesWritten = [], filesDeleted = [], warnings = []) {
+    return {
+      targetId: this.id,
+      filesWritten,
+      filesDeleted,
+      warnings
+    };
+  }
+}
+
+// src/utils/model-guidance.ts
+function generateModelGuidanceMarkdown(resolved) {
+  if (!resolved.default && !resolved.small && Object.keys(resolved.agents).length === 0 && Object.keys(resolved.profiles).length === 0) {
+    return null;
+  }
+  const lines = [];
+  lines.push("# Model Configuration");
+  lines.push("");
+  lines.push("Use the following model preferences when working in this project.");
+  lines.push("");
+  if (resolved.default || resolved.small) {
+    lines.push("## Default Models");
+    lines.push("");
+    if (resolved.default) {
+      lines.push(`- **Primary model**: ${resolved.default}`);
+    }
+    if (resolved.small) {
+      lines.push(`- **Lightweight tasks** (titles, summaries): ${resolved.small}`);
+    }
+    lines.push("");
+  }
+  const agentEntries = Object.entries(resolved.agents);
+  if (agentEntries.length > 0) {
+    lines.push("## Agent Model Assignments");
+    lines.push("");
+    lines.push("| Agent | Model | Temperature |");
+    lines.push("| --- | --- | --- |");
+    for (const [name, assignment] of agentEntries) {
+      const temp = assignment.temperature !== undefined ? String(assignment.temperature) : "\u2014";
+      lines.push(`| ${name} | ${assignment.model} | ${temp} |`);
+    }
+    lines.push("");
+  }
+  if (Object.keys(resolved.profiles).length > 0) {
+    lines.push("## Available Profiles");
+    lines.push("");
+    lines.push("| Profile | Description | Default Model |");
+    lines.push("| --- | --- | --- |");
+    for (const [name, profile] of Object.entries(resolved.profiles)) {
+      lines.push(`| ${name} | ${profile.description ?? "\u2014"} | ${profile.default ?? "\u2014"} |`);
+    }
+    lines.push("");
+  }
+  if (resolved.activeProfile) {
+    lines.push(`**Active profile**: \`${resolved.activeProfile}\``);
+    lines.push("");
+  }
+  if (resolved.routing.length > 0) {
+    lines.push("## Task-Aware Routing");
+    lines.push("");
+    lines.push("Select the appropriate profile based on the task context:");
+    lines.push("");
+    lines.push("| Condition | Profile | Description |");
+    lines.push("| --- | --- | --- |");
+    for (const rule of resolved.routing) {
+      const conditions = Object.entries(rule.when).map(([k, v]) => `${k}=${v}`).join(", ");
+      const desc = rule.description ?? "\u2014";
+      lines.push(`| ${conditions} | ${rule.use} | ${desc} |`);
+    }
+    lines.push("");
+    lines.push("### Condition Reference");
+    lines.push("");
+    lines.push("- **complexity**: low | medium | high | critical");
+    lines.push("- **urgency**: low | normal | high");
+    lines.push("- **budget**: minimal | standard | premium");
+    lines.push("- **contextWindowNeed**: small | medium | large | max");
+    lines.push("- **toolUseIntensity**: none | light | heavy");
+    lines.push("");
+  }
+  return lines.join(`
+`);
+}
+
+// src/targets/mistral-vibe.ts
+import { resolve, join as join3 } from "path";
+var TARGET_ID = "mistralvibe";
+
+class MistralVibeTarget extends BaseTarget {
+  id = TARGET_ID;
+  name = "Mistral Vibe";
+  supportedFeatures = [
+    "rules",
+    "commands",
+    "agents",
+    "skills",
+    "mcp",
+    "ignore",
+    "models"
+  ];
+  generate(options) {
+    const { projectRoot, baseDir, features, enabledFeatures, deleteExisting } = options;
+    const root = resolve(projectRoot, baseDir);
+    const effective = this.getEffectiveFeatures(enabledFeatures);
+    const filesWritten = [];
+    const filesDeleted = [];
+    const warnings = [];
+    const vibeDir = resolve(root, ".vibe");
+    ensureDir(vibeDir);
+    if (effective.includes("rules")) {
+      const rulesDir = resolve(vibeDir, "rules");
+      if (deleteExisting) {
+        removeIfExists(rulesDir);
+        filesDeleted.push(rulesDir);
+      }
+      ensureDir(rulesDir);
+      const rules = features.rules.filter((r) => ruleMatchesTarget(r, TARGET_ID));
+      for (const rule of rules) {
+        const filepath = join3(rulesDir, `${rule.name}.md`);
+        writeGeneratedFile(filepath, rule.content);
+        filesWritten.push(filepath);
+      }
+    }
+    if (effective.includes("agents")) {
+      const agentsDir = resolve(vibeDir, "agents");
+      if (deleteExisting) {
+        removeIfExists(agentsDir);
+        filesDeleted.push(agentsDir);
+      }
+      ensureDir(agentsDir);
+      const agents = features.agents.filter((a) => agentMatchesTarget(a, TARGET_ID));
+      for (const agent of agents) {
+        const filepath = join3(agentsDir, `${agent.name}.md`);
+        writeGeneratedFile(filepath, agent.content);
+        filesWritten.push(filepath);
+      }
+    }
+    if (effective.includes("skills")) {
+      const skillsDir = resolve(vibeDir, "skills");
+      if (deleteExisting) {
+        removeIfExists(skillsDir);
+        filesDeleted.push(skillsDir);
+      }
+      ensureDir(skillsDir);
+      const skills = features.skills.filter((s) => skillMatchesTarget(s, TARGET_ID));
+      for (const skill of skills) {
+        const skillSubDir = join3(skillsDir, skill.name);
+        ensureDir(skillSubDir);
+        const filepath = join3(skillSubDir, "SKILL.md");
+        writeGeneratedFile(filepath, serializeSkill(skill));
+        filesWritten.push(filepath);
+      }
+    }
+    if (effective.includes("commands")) {
+      const commandsDir = resolve(vibeDir, "commands");
+      if (deleteExisting) {
+        removeIfExists(commandsDir);
+        filesDeleted.push(commandsDir);
+      }
+      ensureDir(commandsDir);
+      const commands = features.commands.filter((c) => commandMatchesTarget(c, TARGET_ID));
+      for (const command of commands) {
+        const filepath = join3(commandsDir, `${command.name}.md`);
+        writeGeneratedFile(filepath, command.content);
+        filesWritten.push(filepath);
+      }
+    }
+    let hasMcpConfig = false;
+    if (effective.includes("mcp")) {
+      const mcpEntries = Object.entries(features.mcpServers);
+      if (mcpEntries.length > 0) {
+        const filepath = resolve(vibeDir, "mcp.json");
+        writeGeneratedJson(filepath, { mcpServers: features.mcpServers }, {
+          header: false
+        });
+        filesWritten.push(filepath);
+        hasMcpConfig = true;
+      }
+    }
+    if (effective.includes("ignore") && features.ignorePatterns.length > 0) {
+      const filepath = resolve(root, ".vibeignore");
+      writeGeneratedFile(filepath, features.ignorePatterns.join(`
+`) + `
+`);
+      filesWritten.push(filepath);
+    }
+    let defaultModel;
+    let smallModel;
+    if (effective.includes("models") && features.models) {
+      const resolved = resolveModels(features.models, options.modelProfile, TARGET_ID);
+      defaultModel = resolved.default;
+      smallModel = resolved.small;
+      const guidance = generateModelGuidanceMarkdown(resolved);
+      if (guidance) {
+        const filepath = join3(vibeDir, "model-config.md");
+        writeGeneratedFile(filepath, guidance);
+        filesWritten.push(filepath);
+      }
+    }
+    const vibeConfig = buildVibeConfigToml({
+      hasMcpConfig,
+      defaultModel,
+      smallModel,
+      profile: options.modelProfile
+    });
+    if (vibeConfig.length > 0) {
+      const filepath = resolve(vibeDir, "config.toml");
+      writeGeneratedFile(filepath, vibeConfig);
+      filesWritten.push(filepath);
+    }
+    return this.createResult(filesWritten, filesDeleted, warnings);
+  }
+}
+function buildVibeConfigToml(options) {
+  const lines = [];
+  if (options.defaultModel || options.smallModel || options.profile) {
+    lines.push("[models]");
+    if (options.defaultModel) {
+      lines.push(`default = "${escapeTomlString(options.defaultModel)}"`);
+    }
+    if (options.smallModel) {
+      lines.push(`small = "${escapeTomlString(options.smallModel)}"`);
+    }
+    if (options.profile) {
+      lines.push(`profile = "${escapeTomlString(options.profile)}"`);
+    }
+    lines.push("");
+  }
+  if (options.hasMcpConfig) {
+    lines.push("[mcp]");
+    lines.push('config_path = ".vibe/mcp.json"');
+    lines.push("");
+  }
+  return lines.join(`
+`).trim();
+}
+function escapeTomlString(value) {
+  return value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
+}
+export {
+  MistralVibeTarget
+};