refactor(src): split oversized modules

src/agents/skills/frontmatter.ts

@@ -0,0 +1,148 @@
+import type { Skill } from "@mariozechner/pi-coding-agent";
+
+import type {
+  ClawdbotSkillMetadata,
+  ParsedSkillFrontmatter,
+  SkillEntry,
+  SkillInstallSpec,
+} from "./types.js";
+
+function stripQuotes(value: string): string {
+  if (
+    (value.startsWith('"') && value.endsWith('"')) ||
+    (value.startsWith("'") && value.endsWith("'"))
+  ) {
+    return value.slice(1, -1);
+  }
+  return value;
+}
+
+export function parseFrontmatter(content: string): ParsedSkillFrontmatter {
+  const frontmatter: ParsedSkillFrontmatter = {};
+  const normalized = content.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+  if (!normalized.startsWith("---")) return frontmatter;
+  const endIndex = normalized.indexOf("\n---", 3);
+  if (endIndex === -1) return frontmatter;
+  const block = normalized.slice(4, endIndex);
+  for (const line of block.split("\n")) {
+    const match = line.match(/^([\w-]+):\s*(.*)$/);
+    if (!match) continue;
+    const key = match[1];
+    const value = stripQuotes(match[2].trim());
+    if (!key || !value) continue;
+    frontmatter[key] = value;
+  }
+  return frontmatter;
+}
+
+function normalizeStringList(input: unknown): string[] {
+  if (!input) return [];
+  if (Array.isArray(input)) {
+    return input.map((value) => String(value).trim()).filter(Boolean);
+  }
+  if (typeof input === "string") {
+    return input
+      .split(",")
+      .map((value) => value.trim())
+      .filter(Boolean);
+  }
+  return [];
+}
+
+function parseInstallSpec(input: unknown): SkillInstallSpec | undefined {
+  if (!input || typeof input !== "object") return undefined;
+  const raw = input as Record<string, unknown>;
+  const kindRaw =
+    typeof raw.kind === "string"
+      ? raw.kind
+      : typeof raw.type === "string"
+        ? raw.type
+        : "";
+  const kind = kindRaw.trim().toLowerCase();
+  if (kind !== "brew" && kind !== "node" && kind !== "go" && kind !== "uv") {
+    return undefined;
+  }
+
+  const spec: SkillInstallSpec = {
+    kind: kind as SkillInstallSpec["kind"],
+  };
+
+  if (typeof raw.id === "string") spec.id = raw.id;
+  if (typeof raw.label === "string") spec.label = raw.label;
+  const bins = normalizeStringList(raw.bins);
+  if (bins.length > 0) spec.bins = bins;
+  if (typeof raw.formula === "string") spec.formula = raw.formula;
+  if (typeof raw.package === "string") spec.package = raw.package;
+  if (typeof raw.module === "string") spec.module = raw.module;
+
+  return spec;
+}
+
+function getFrontmatterValue(
+  frontmatter: ParsedSkillFrontmatter,
+  key: string,
+): string | undefined {
+  const raw = frontmatter[key];
+  return typeof raw === "string" ? raw : undefined;
+}
+
+export function resolveClawdbotMetadata(
+  frontmatter: ParsedSkillFrontmatter,
+): ClawdbotSkillMetadata | undefined {
+  const raw = getFrontmatterValue(frontmatter, "metadata");
+  if (!raw) return undefined;
+  try {
+    const parsed = JSON.parse(raw) as { clawdbot?: unknown };
+    if (!parsed || typeof parsed !== "object") return undefined;
+    const clawdbot = (parsed as { clawdbot?: unknown }).clawdbot;
+    if (!clawdbot || typeof clawdbot !== "object") return undefined;
+    const clawdbotObj = clawdbot as Record<string, unknown>;
+    const requiresRaw =
+      typeof clawdbotObj.requires === "object" && clawdbotObj.requires !== null
+        ? (clawdbotObj.requires as Record<string, unknown>)
+        : undefined;
+    const installRaw = Array.isArray(clawdbotObj.install)
+      ? (clawdbotObj.install as unknown[])
+      : [];
+    const install = installRaw
+      .map((entry) => parseInstallSpec(entry))
+      .filter((entry): entry is SkillInstallSpec => Boolean(entry));
+    const osRaw = normalizeStringList(clawdbotObj.os);
+    return {
+      always:
+        typeof clawdbotObj.always === "boolean"
+          ? clawdbotObj.always
+          : undefined,
+      emoji:
+        typeof clawdbotObj.emoji === "string" ? clawdbotObj.emoji : undefined,
+      homepage:
+        typeof clawdbotObj.homepage === "string"
+          ? clawdbotObj.homepage
+          : undefined,
+      skillKey:
+        typeof clawdbotObj.skillKey === "string"
+          ? clawdbotObj.skillKey
+          : undefined,
+      primaryEnv:
+        typeof clawdbotObj.primaryEnv === "string"
+          ? clawdbotObj.primaryEnv
+          : undefined,
+      os: osRaw.length > 0 ? osRaw : undefined,
+      requires: requiresRaw
+        ? {
+            bins: normalizeStringList(requiresRaw.bins),
+            anyBins: normalizeStringList(requiresRaw.anyBins),
+            env: normalizeStringList(requiresRaw.env),
+            config: normalizeStringList(requiresRaw.config),
+          }
+        : undefined,
+      install: install.length > 0 ? install : undefined,
+    };
+  } catch {
+    return undefined;
+  }
+}
+
+export function resolveSkillKey(skill: Skill, entry?: SkillEntry): string {
+  return entry?.clawdbot?.skillKey ?? skill.name;
+}