agentpacks 0.3.0 → 0.4.0

package/dist/cli/models-explain.js

@@ -0,0 +1,1205 @@
+// @bun
+var __require = import.meta.require;
+
+// src/core/config.ts
+import { z } from "zod";
+import { readFileSync, existsSync } from "fs";
+import { resolve } from "path";
+import { parse as parseJsonc } from "jsonc-parser";
+var TARGET_IDS = [
+  "opencode",
+  "cursor",
+  "claudecode",
+  "codexcli",
+  "geminicli",
+  "copilot",
+  "agentsmd",
+  "cline",
+  "kilo",
+  "roo",
+  "qwencode",
+  "kiro",
+  "factorydroid",
+  "antigravity",
+  "junie",
+  "augmentcode",
+  "windsurf",
+  "warp",
+  "replit",
+  "zed"
+];
+var FEATURE_IDS = [
+  "rules",
+  "commands",
+  "agents",
+  "skills",
+  "hooks",
+  "plugins",
+  "mcp",
+  "ignore",
+  "models"
+];
+var REPO_MODES = ["repo", "monorepo", "metarepo"];
+var PackManifestSchema = z.object({
+  name: z.string().min(1),
+  version: z.string().default("1.0.0"),
+  description: z.string().default(""),
+  author: z.union([
+    z.string(),
+    z.object({ name: z.string(), email: z.string().optional() })
+  ]).optional(),
+  tags: z.array(z.string()).default([]),
+  dependencies: z.array(z.string()).default([]),
+  conflicts: z.array(z.string()).default([]),
+  targets: z.union([z.literal("*"), z.array(z.string())]).default("*"),
+  features: z.union([z.literal("*"), z.array(z.string())]).default("*")
+});
+var FeaturesSchema = z.union([
+  z.literal("*"),
+  z.array(z.string()),
+  z.record(z.string(), z.union([z.literal("*"), z.array(z.string())]))
+]);
+var WorkspaceConfigSchema = z.object({
+  $schema: z.string().optional(),
+  packs: z.array(z.string()).default(["./packs/default"]),
+  disabled: z.array(z.string()).default([]),
+  targets: z.union([z.literal("*"), z.array(z.string())]).default("*"),
+  features: FeaturesSchema.default("*"),
+  mode: z.enum(REPO_MODES).default("repo"),
+  baseDirs: z.array(z.string()).default(["."]),
+  global: z.boolean().default(false),
+  delete: z.boolean().default(true),
+  verbose: z.boolean().default(false),
+  silent: z.boolean().default(false),
+  overrides: z.record(z.string(), z.record(z.string(), z.string())).default({}),
+  sources: z.array(z.object({
+    source: z.string(),
+    packs: z.array(z.string()).optional(),
+    skills: z.array(z.string()).optional()
+  })).default([]),
+  modelProfile: z.string().optional()
+});
+var CONFIG_FILES = ["agentpacks.local.jsonc", "agentpacks.jsonc"];
+function loadWorkspaceConfig(projectRoot) {
+  for (const filename of CONFIG_FILES) {
+    const filepath = resolve(projectRoot, filename);
+    if (existsSync(filepath)) {
+      const raw = readFileSync(filepath, "utf-8");
+      const parsed = parseJsonc(raw);
+      return WorkspaceConfigSchema.parse(parsed);
+    }
+  }
+  return WorkspaceConfigSchema.parse({});
+}
+function loadPackManifest(packDir) {
+  const filepath = resolve(packDir, "pack.json");
+  if (!existsSync(filepath)) {
+    const dirName = packDir.split("/").pop() ?? "unknown";
+    return PackManifestSchema.parse({ name: dirName });
+  }
+  const raw = readFileSync(filepath, "utf-8");
+  const parsed = JSON.parse(raw);
+  return PackManifestSchema.parse(parsed);
+}
+function resolveFeatures(config, targetId) {
+  const { features } = config;
+  if (features === "*") {
+    return [...FEATURE_IDS];
+  }
+  if (Array.isArray(features)) {
+    if (features.includes("*"))
+      return [...FEATURE_IDS];
+    return features.filter((f) => FEATURE_IDS.includes(f));
+  }
+  const targetFeatures = features[targetId];
+  if (!targetFeatures)
+    return [];
+  if (targetFeatures === "*")
+    return [...FEATURE_IDS];
+  if (Array.isArray(targetFeatures) && targetFeatures.includes("*"))
+    return [...FEATURE_IDS];
+  return targetFeatures.filter((f) => FEATURE_IDS.includes(f));
+}
+function resolveTargets(config) {
+  if (config.targets === "*")
+    return [...TARGET_IDS];
+  return config.targets;
+}
+
+// src/utils/filesystem.ts
+import {
+  existsSync as existsSync2,
+  mkdirSync,
+  readFileSync as readFileSync2,
+  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 (!existsSync2(filepath))
+    return null;
+  return readFileSync2(filepath, "utf-8");
+}
+function readJsonOrNull(filepath) {
+  const content = readFileOrNull(filepath);
+  if (content === null)
+    return null;
+  return JSON.parse(content);
+}
+function ensureDir(dirPath) {
+  if (!existsSync2(dirPath)) {
+    mkdirSync(dirPath, { recursive: true });
+  }
+}
+function removeIfExists(targetPath) {
+  if (existsSync2(targetPath)) {
+    rmSync(targetPath, { recursive: true, force: true });
+  }
+}
+function listFiles(dirPath, options = {}) {
+  const { extension, recursive = false } = options;
+  if (!existsSync2(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 (!existsSync2(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 readFileSync3 } 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 = readFileSync3(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 readFileSync4 } 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 = readFileSync4(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 readFileSync5 } 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 = readFileSync5(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 readFileSync6, existsSync as existsSync3 } from "fs";
+import { basename as basename4, join as join2 } from "path";
+function parseSkills(skillsDir, packName) {
+  const dirs = listDirs(skillsDir);
+  const skills = [];
+  for (const dir of dirs) {
+    const skillMd = join2(dir, "SKILL.md");
+    if (existsSync3(skillMd)) {
+      skills.push(parseSkillFile(skillMd, dir, packName));
+    }
+  }
+  return skills;
+}
+function parseSkillFile(filepath, skillDir, packName) {
+  const raw = readFileSync6(filepath, "utf-8");
+  const { data, content } = parseFrontmatter(raw);
+  return {
+    name: data.name ?? basename4(skillDir),
+    sourcePath: filepath,
+    sourceDir: skillDir,
+    packName,
+    meta: data,
+    content
+  };
+}
+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/features/hooks.ts
+import { join as join3 } from "path";
+var TARGET_OVERRIDE_KEYS = ["cursor", "claudecode", "opencode"];
+function parseHooks(packDir, packName) {
+  const hooksPath = join3(packDir, "hooks", "hooks.json");
+  const raw = readJsonOrNull(hooksPath);
+  if (!raw)
+    return null;
+  const shared = raw.hooks ?? {};
+  const targetOverrides = {};
+  for (const key of TARGET_OVERRIDE_KEYS) {
+    const override = raw[key];
+    if (override && typeof override === "object" && "hooks" in override && override.hooks) {
+      targetOverrides[key] = override.hooks;
+    }
+  }
+  return {
+    packName,
+    sourcePath: hooksPath,
+    version: raw.version,
+    shared,
+    targetOverrides
+  };
+}
+function resolveHooksForTarget(hooks, targetId) {
+  const merged = {};
+  for (const [event, entries] of Object.entries(hooks.shared)) {
+    merged[event] = [...entries];
+  }
+  const overrides = hooks.targetOverrides[targetId];
+  if (overrides) {
+    for (const [event, entries] of Object.entries(overrides)) {
+      merged[event] = [...merged[event] ?? [], ...entries];
+    }
+  }
+  return merged;
+}
+
+// src/features/plugins.ts
+import { readFileSync as readFileSync7, existsSync as existsSync4 } from "fs";
+import { basename as basename5, join as join4 } from "path";
+function parsePlugins(packDir, packName) {
+  const pluginsDir = join4(packDir, "plugins");
+  if (!existsSync4(pluginsDir))
+    return [];
+  const tsFiles = listFiles(pluginsDir, { extension: ".ts" });
+  const jsFiles = listFiles(pluginsDir, { extension: ".js" });
+  const allFiles = [...tsFiles, ...jsFiles];
+  return allFiles.map((filepath) => parsePluginFile(filepath, packName));
+}
+function parsePluginFile(filepath, packName) {
+  const content = readFileSync7(filepath, "utf-8");
+  const ext = filepath.endsWith(".ts") ? "ts" : "js";
+  return {
+    name: basename5(filepath, `.${ext}`),
+    sourcePath: filepath,
+    packName,
+    content,
+    extension: ext
+  };
+}
+
+// src/features/mcp.ts
+import { join as join5 } from "path";
+function parseMcp(packDir, packName) {
+  const mcpPath = join5(packDir, "mcp.json");
+  const raw = readJsonOrNull(mcpPath);
+  if (!raw?.mcpServers)
+    return null;
+  return {
+    packName,
+    sourcePath: mcpPath,
+    servers: raw.mcpServers
+  };
+}
+function mergeMcpConfigs(configs) {
+  const servers = {};
+  const warnings = [];
+  for (const config of configs) {
+    for (const [name, entry] of Object.entries(config.servers)) {
+      if (name in servers) {
+        warnings.push(`MCP server "${name}" from pack "${config.packName}" skipped (already defined).`);
+        continue;
+      }
+      servers[name] = entry;
+    }
+  }
+  return { servers, warnings };
+}
+
+// src/features/ignore.ts
+import { existsSync as existsSync5, readFileSync as readFileSync8 } from "fs";
+import { join as join6 } from "path";
+var IGNORE_FILES = ["ignore", ".aiignore"];
+function parseIgnore(packDir, packName) {
+  for (const filename of IGNORE_FILES) {
+    const filepath = join6(packDir, filename);
+    if (existsSync5(filepath)) {
+      const raw = readFileSync8(filepath, "utf-8");
+      const patterns = parseIgnoreContent(raw);
+      return {
+        packName,
+        sourcePath: filepath,
+        patterns
+      };
+    }
+  }
+  return null;
+}
+function parseIgnoreContent(content) {
+  return content.split(`
+`).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
+}
+function mergeIgnorePatterns(configs) {
+  const seen = new Set;
+  const result = [];
+  for (const config of configs) {
+    for (const pattern of config.patterns) {
+      if (!seen.has(pattern)) {
+        seen.add(pattern);
+        result.push(pattern);
+      }
+    }
+  }
+  return result;
+}
+
+// src/features/models.ts
+import { join as join7 } from "path";
+import { z as z2 } from "zod";
+var SECRET_PATTERNS = [
+  /["']api[_-]?key["']\s*:/i,
+  /["']apiKey["']\s*:/i,
+  /["']secret["']\s*:/i,
+  /["']password["']\s*:/i,
+  /["'](?:auth_token|access_token|bearer_token)["']\s*:/i,
+  /["']private[_-]?key["']\s*:/i,
+  /-----BEGIN\s+(RSA|EC|DSA|OPENSSH|PGP)\s+PRIVATE\s+KEY-----/,
+  /sk-[a-zA-Z0-9]{20,}/,
+  /Bearer\s+[a-zA-Z0-9._-]{20,}/
+];
+var AgentModelSchema = z2.object({
+  model: z2.string(),
+  temperature: z2.number().min(0).max(2).optional(),
+  top_p: z2.number().min(0).max(1).optional()
+});
+var ModelProfileSchema = z2.object({
+  extends: z2.string().optional(),
+  description: z2.string().optional(),
+  default: z2.string().optional(),
+  small: z2.string().optional(),
+  agents: z2.record(z2.string(), AgentModelSchema).optional()
+});
+var RoutingConditionSchema = z2.object({
+  complexity: z2.enum(["low", "medium", "high", "critical"]).optional().describe("Task complexity level"),
+  urgency: z2.enum(["low", "normal", "high"]).optional().describe("Time sensitivity"),
+  budget: z2.enum(["minimal", "standard", "premium"]).optional().describe("Cost/token budget tier"),
+  contextWindowNeed: z2.enum(["small", "medium", "large", "max"]).optional().describe("Required context window size"),
+  toolUseIntensity: z2.enum(["none", "light", "heavy"]).optional().describe("Expected tool/function calling intensity")
+});
+var RoutingRuleSchema = z2.object({
+  when: z2.record(z2.string(), z2.string()),
+  use: z2.string(),
+  description: z2.string().optional(),
+  priority: z2.number().optional()
+});
+var ProviderModelSchema = z2.object({
+  options: z2.record(z2.string(), z2.unknown()).optional(),
+  variants: z2.record(z2.string(), z2.record(z2.string(), z2.unknown())).optional()
+});
+var ProviderConfigSchema = z2.object({
+  options: z2.record(z2.string(), z2.unknown()).optional(),
+  models: z2.record(z2.string(), ProviderModelSchema).optional()
+});
+var ModelsSchema = z2.object({
+  default: z2.string().optional(),
+  small: z2.string().optional(),
+  agents: z2.record(z2.string(), AgentModelSchema).optional(),
+  profiles: z2.record(z2.string(), ModelProfileSchema).optional(),
+  providers: z2.record(z2.string(), ProviderConfigSchema).optional(),
+  routing: z2.array(RoutingRuleSchema).optional(),
+  overrides: z2.record(z2.string(), z2.object({
+    default: z2.string().optional(),
+    small: z2.string().optional(),
+    agents: z2.record(z2.string(), AgentModelSchema).optional()
+  })).optional()
+});
+function parseModels(packDir, packName) {
+  const modelsPath = join7(packDir, "models.json");
+  const raw = readJsonOrNull(modelsPath);
+  if (!raw)
+    return null;
+  const parsed = ModelsSchema.parse(raw);
+  return {
+    packName,
+    sourcePath: modelsPath,
+    config: parsed
+  };
+}
+function mergeModelsConfigs(configs) {
+  const warnings = [];
+  const result = {};
+  for (const entry of configs) {
+    const { config, packName } = entry;
+    if (config.default !== undefined && result.default === undefined) {
+      result.default = config.default;
+    } else if (config.default !== undefined && result.default !== undefined) {
+      warnings.push(`Models "default" from pack "${packName}" skipped (already defined).`);
+    }
+    if (config.small !== undefined && result.small === undefined) {
+      result.small = config.small;
+    } else if (config.small !== undefined && result.small !== undefined) {
+      warnings.push(`Models "small" from pack "${packName}" skipped (already defined).`);
+    }
+    if (config.agents) {
+      if (!result.agents)
+        result.agents = {};
+      for (const [name, assignment] of Object.entries(config.agents)) {
+        if (name in result.agents) {
+          warnings.push(`Models agent "${name}" from pack "${packName}" skipped (already defined).`);
+          continue;
+        }
+        result.agents[name] = assignment;
+      }
+    }
+    if (config.profiles) {
+      if (!result.profiles)
+        result.profiles = {};
+      for (const [name, profile] of Object.entries(config.profiles)) {
+        if (name in result.profiles) {
+          warnings.push(`Models profile "${name}" from pack "${packName}" skipped (already defined).`);
+          continue;
+        }
+        result.profiles[name] = profile;
+      }
+    }
+    if (config.providers) {
+      if (!result.providers)
+        result.providers = {};
+      for (const [providerName, providerConfig] of Object.entries(config.providers)) {
+        if (!(providerName in result.providers)) {
+          result.providers[providerName] = providerConfig;
+        } else {
+          const existing = result.providers[providerName];
+          if (!existing) {
+            result.providers[providerName] = providerConfig;
+            continue;
+          }
+          if (providerConfig.options) {
+            existing.options = {
+              ...providerConfig.options,
+              ...existing.options
+            };
+          }
+          if (providerConfig.models) {
+            if (!existing.models)
+              existing.models = {};
+            for (const [modelName, modelConfig] of Object.entries(providerConfig.models)) {
+              if (!(modelName in existing.models)) {
+                existing.models[modelName] = modelConfig;
+              }
+            }
+          }
+        }
+      }
+    }
+    if (config.routing) {
+      if (!result.routing)
+        result.routing = [];
+      result.routing.push(...config.routing);
+    }
+    if (config.overrides) {
+      if (!result.overrides)
+        result.overrides = {};
+      for (const [targetId, override] of Object.entries(config.overrides)) {
+        if (targetId in result.overrides) {
+          warnings.push(`Models override for target "${targetId}" from pack "${packName}" skipped (already defined).`);
+          continue;
+        }
+        result.overrides[targetId] = override;
+      }
+    }
+  }
+  return { config: result, warnings };
+}
+function scanModelsForSecrets(config) {
+  const warnings = [];
+  const json = JSON.stringify(config);
+  for (const pattern of SECRET_PATTERNS) {
+    if (pattern.test(json)) {
+      warnings.push(`Potential secret detected in models.json matching pattern: ${pattern.source}`);
+    }
+  }
+  return warnings;
+}
+
+// src/core/pack-loader.ts
+import { existsSync as existsSync6 } from "fs";
+import { resolve as resolve2, isAbsolute } from "path";
+class PackLoader {
+  projectRoot;
+  config;
+  constructor(projectRoot, config) {
+    this.projectRoot = projectRoot;
+    this.config = config;
+  }
+  loadAll() {
+    const warnings = [];
+    const packs = [];
+    const disabledSet = new Set(this.config.disabled);
+    for (const packRef of this.config.packs) {
+      const packDir = this.resolvePackPath(packRef);
+      if (!packDir) {
+        warnings.push(`Pack "${packRef}" could not be resolved. Skipping.`);
+        continue;
+      }
+      if (!existsSync6(packDir)) {
+        warnings.push(`Pack directory "${packDir}" does not exist. Skipping.`);
+        continue;
+      }
+      const manifest = loadPackManifest(packDir);
+      if (disabledSet.has(manifest.name) || disabledSet.has(packRef)) {
+        continue;
+      }
+      const loaded = this.loadPack(packDir, manifest);
+      packs.push(loaded);
+    }
+    return { packs, warnings };
+  }
+  loadPack(packDir, manifest) {
+    const name = manifest.name;
+    const rulesDir = resolve2(packDir, "rules");
+    const commandsDir = resolve2(packDir, "commands");
+    const agentsDir = resolve2(packDir, "agents");
+    const skillsDir = resolve2(packDir, "skills");
+    return {
+      manifest,
+      directory: packDir,
+      rules: existsSync6(rulesDir) ? parseRules(rulesDir, name) : [],
+      commands: existsSync6(commandsDir) ? parseCommands(commandsDir, name) : [],
+      agents: existsSync6(agentsDir) ? parseAgents(agentsDir, name) : [],
+      skills: existsSync6(skillsDir) ? parseSkills(skillsDir, name) : [],
+      hooks: parseHooks(packDir, name),
+      plugins: parsePlugins(packDir, name),
+      mcp: parseMcp(packDir, name),
+      ignore: parseIgnore(packDir, name),
+      models: parseModels(packDir, name)
+    };
+  }
+  loadForBaseDir(baseDir) {
+    const baseDirRoot = resolve2(this.projectRoot, baseDir);
+    const localConfigPath = resolve2(baseDirRoot, "agentpacks.jsonc");
+    if (!existsSync6(localConfigPath)) {
+      return { packs: [], warnings: [] };
+    }
+    const localConfig = loadWorkspaceConfig(baseDirRoot);
+    const loader = new PackLoader(baseDirRoot, localConfig);
+    return loader.loadAll();
+  }
+  resolveCuratedPack(packRef) {
+    const curatedDir = resolve2(this.projectRoot, ".agentpacks", ".curated");
+    let packName = packRef;
+    if (packName.startsWith("registry:"))
+      packName = packName.slice(9);
+    if (packName.startsWith("npm:"))
+      packName = packName.slice(4);
+    if (packName.startsWith("github:"))
+      packName = packName.slice(7);
+    if (packName.startsWith("@"))
+      packName = packName.slice(1);
+    if (packName.includes("/")) {
+      const parts = packName.split("/");
+      packName = packName.includes("@") ? parts.join("-") : parts[parts.length - 1] ?? packName;
+    }
+    const withoutVersion = packName.split("@")[0] ?? packName;
+    packName = withoutVersion.split(":")[0] ?? withoutVersion;
+    const resolved = resolve2(curatedDir, packName);
+    return existsSync6(resolved) ? resolved : null;
+  }
+  resolvePackPath(packRef) {
+    if (packRef.startsWith("./") || packRef.startsWith("../")) {
+      return resolve2(this.projectRoot, packRef);
+    }
+    if (isAbsolute(packRef)) {
+      return packRef;
+    }
+    if (packRef.startsWith("registry:")) {
+      return this.resolveCuratedPack(packRef);
+    }
+    if (packRef.startsWith("@") || packRef.startsWith("npm:") || !packRef.includes("/")) {
+      return this.resolveCuratedPack(packRef);
+    }
+    if (packRef.startsWith("github:") || packRef.includes("/")) {
+      return this.resolveCuratedPack(packRef);
+    }
+    return resolve2(this.projectRoot, packRef);
+  }
+}
+
+// src/core/feature-merger.ts
+class FeatureMerger {
+  packs;
+  warnings = [];
+  constructor(packs) {
+    this.packs = packs;
+  }
+  merge() {
+    this.warnings = [];
+    const features = {
+      rules: this.mergeRules(),
+      commands: this.mergeByName("commands"),
+      agents: this.mergeByName("agents"),
+      skills: this.mergeByName("skills"),
+      hooks: this.mergeHooks(),
+      plugins: this.mergePlugins(),
+      mcpServers: this.mergeMcp(),
+      ignorePatterns: this.mergeIgnore(),
+      models: this.mergeModels()
+    };
+    return { features, warnings: this.warnings };
+  }
+  mergeRules() {
+    const seen = new Map;
+    const result = [];
+    for (const pack of this.packs) {
+      for (const rule of pack.rules) {
+        const existing = seen.get(rule.name);
+        if (existing) {
+          this.warnings.push(`Rule "${rule.name}" from pack "${rule.packName}" skipped (already defined by "${existing}").`);
+          continue;
+        }
+        seen.set(rule.name, rule.packName);
+        result.push(rule);
+      }
+    }
+    return result;
+  }
+  mergeByName(featureKey) {
+    const seen = new Map;
+    const result = [];
+    for (const pack of this.packs) {
+      const items = pack[featureKey];
+      for (const item of items) {
+        const existing = seen.get(item.name);
+        if (existing) {
+          this.warnings.push(`${featureKey.slice(0, -1)} "${item.name}" from pack "${item.packName}" skipped (already defined by "${existing}").`);
+          continue;
+        }
+        seen.set(item.name, item.packName);
+        result.push(item);
+      }
+    }
+    return result;
+  }
+  mergeHooks() {
+    return this.packs.map((p) => p.hooks).filter((h) => h !== null);
+  }
+  mergePlugins() {
+    const seen = new Map;
+    const result = [];
+    for (const pack of this.packs) {
+      for (const plugin of pack.plugins) {
+        const key = `${plugin.name}.${plugin.extension}`;
+        const existing = seen.get(key);
+        if (existing) {
+          this.warnings.push(`Plugin "${key}" from pack "${plugin.packName}" skipped (already defined by "${existing}").`);
+          continue;
+        }
+        seen.set(key, plugin.packName);
+        result.push(plugin);
+      }
+    }
+    return result;
+  }
+  mergeMcp() {
+    const servers = {};
+    for (const pack of this.packs) {
+      if (!pack.mcp)
+        continue;
+      for (const [name, entry] of Object.entries(pack.mcp.servers)) {
+        if (name in servers) {
+          this.warnings.push(`MCP server "${name}" from pack "${pack.manifest.name}" skipped (already defined).`);
+          continue;
+        }
+        servers[name] = entry;
+      }
+    }
+    return servers;
+  }
+  mergeIgnore() {
+    const seen = new Set;
+    const result = [];
+    for (const pack of this.packs) {
+      if (!pack.ignore)
+        continue;
+      for (const pattern of pack.ignore.patterns) {
+        if (!seen.has(pattern)) {
+          seen.add(pattern);
+          result.push(pattern);
+        }
+      }
+    }
+    return result;
+  }
+  mergeModels() {
+    const configs = this.packs.map((p) => p.models).filter((m) => m != null);
+    if (configs.length === 0)
+      return null;
+    const { config, warnings } = mergeModelsConfigs(configs);
+    this.warnings.push(...warnings);
+    return config;
+  }
+}
+
+// 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/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/cli/models-explain.ts
+import chalk from "chalk";
+import { resolve as resolve3 } from "path";
+function runModelsExplain(options) {
+  const projectRoot = resolve3(options.config ?? ".");
+  const config = loadWorkspaceConfig(projectRoot);
+  const loader = new PackLoader(projectRoot, config);
+  const { packs } = loader.loadAll();
+  if (packs.length === 0) {
+    console.log(chalk.red("No packs loaded. Run `agentpacks init` first."));
+    process.exit(1);
+  }
+  const merger = new FeatureMerger(packs);
+  const { features: merged } = merger.merge();
+  if (!merged.models) {
+    console.log(chalk.dim("No model configuration found in your packs."));
+    return;
+  }
+  const profile = options.profile;
+  const target = options.target;
+  const resolved = resolveModels(merged.models, profile, target);
+  console.log(chalk.bold(`
+\uD83D\uDCCB Model Configuration Summary
+`));
+  if (resolved.default) {
+    console.log(`  ${chalk.dim("Default model:")}  ${chalk.cyan(resolved.default)}`);
+  }
+  if (resolved.small) {
+    console.log(`  ${chalk.dim("Small model:")}    ${chalk.cyan(resolved.small)}`);
+  }
+  if (resolved.activeProfile) {
+    console.log(`  ${chalk.dim("Active profile:")} ${chalk.green(resolved.activeProfile)}`);
+  }
+  if (target) {
+    console.log(`  ${chalk.dim("Target:")}         ${chalk.yellow(target)}`);
+  }
+  const agentEntries = Object.entries(resolved.agents);
+  if (agentEntries.length > 0) {
+    console.log(chalk.bold(`
+  Agent Assignments:`));
+    for (const [name, config2] of agentEntries) {
+      const temp = config2.temperature !== undefined ? ` (temp: ${config2.temperature})` : "";
+      console.log(`    ${chalk.dim("\u2022")} ${name}: ${chalk.cyan(config2.model)}${chalk.dim(temp)}`);
+    }
+  }
+  if (resolved.profileNames.length > 0) {
+    console.log(chalk.bold(`
+  Available Profiles:`));
+    for (const name of resolved.profileNames) {
+      const profileData = resolved.profiles[name];
+      const desc = profileData?.description ?? "";
+      const active = name === resolved.activeProfile ? chalk.green(" \u2190 active") : "";
+      console.log(`    ${chalk.dim("\u2022")} ${name}${active}${desc ? chalk.dim(` \u2014 ${desc}`) : ""}`);
+    }
+  }
+  if (resolved.routing.length > 0) {
+    console.log(chalk.bold(`
+  Routing Rules:`));
+    for (const rule of resolved.routing) {
+      const conditions = Object.entries(rule.when).map(([k, v]) => `${chalk.yellow(k)}=${chalk.cyan(v)}`).join(", ");
+      const desc = rule.description;
+      console.log(`    ${chalk.dim("\u2022")} When ${conditions} \u2192 use ${chalk.green(rule.use)}${desc ? chalk.dim(` (${desc})`) : ""}`);
+    }
+    if (options.task) {
+      console.log(chalk.bold(`
+  Task Analysis:`));
+      console.log(`    ${chalk.dim("Task:")} "${options.task}"`);
+      const matched = matchTaskToRouting(options.task, resolved.routing);
+      if (matched) {
+        console.log(`    ${chalk.green("\u2713")} Matched rule: ${chalk.green(matched.use)}`);
+        const conditions = Object.entries(matched.when).map(([k, v]) => `${k}=${v}`).join(", ");
+        console.log(`    ${chalk.dim("  Conditions:")} ${conditions}`);
+      } else {
+        console.log(`    ${chalk.yellow("\u25CB")} No routing rule matched \u2014 using default profile`);
+      }
+    }
+  }
+  const guidance = generateModelGuidanceMarkdown(resolved);
+  if (guidance) {
+    console.log(chalk.bold(`
+  Generated Guidance Preview:`));
+    console.log(chalk.dim("  " + "\u2500".repeat(50)));
+    for (const line of guidance.split(`
+`).slice(0, 20)) {
+      console.log(`  ${chalk.dim(line)}`);
+    }
+    if (guidance.split(`
+`).length > 20) {
+      console.log(chalk.dim(`  ... (${guidance.split(`
+`).length - 20} more lines)`));
+    }
+  }
+  console.log("");
+}
+function matchTaskToRouting(task, routing) {
+  const lowerTask = task.toLowerCase();
+  const complexityKeywords = {
+    critical: ["critical", "security", "production", "hotfix"],
+    high: ["refactor", "architecture", "complex", "rewrite", "migrate"],
+    medium: ["feature", "implement", "update", "modify"],
+    low: ["fix", "typo", "comment", "rename", "format"]
+  };
+  const urgencyKeywords = {
+    high: ["urgent", "asap", "emergency", "hotfix", "critical"],
+    normal: ["feature", "implement", "add"],
+    low: ["cleanup", "refactor", "docs", "todo"]
+  };
+  const inferred = {};
+  for (const [level, keywords] of Object.entries(complexityKeywords)) {
+    if (keywords.some((kw) => lowerTask.includes(kw))) {
+      inferred["complexity"] = level;
+      break;
+    }
+  }
+  for (const [level, keywords] of Object.entries(urgencyKeywords)) {
+    if (keywords.some((kw) => lowerTask.includes(kw))) {
+      inferred["urgency"] = level;
+      break;
+    }
+  }
+  for (const rule of routing) {
+    const matches = Object.entries(rule.when).every(([key, value]) => {
+      if (inferred[key] === value)
+        return true;
+      if (lowerTask.includes(value.toLowerCase()))
+        return true;
+      return false;
+    });
+    if (matches)
+      return rule;
+  }
+  return null;
+}
+export {
+  runModelsExplain
+};