Function parseSpec

src/cli/custom-commands.ts:107–195

(
  raw: string,
  name: string,
  filePath: string,
  origin: 'project' | 'user' | 'plugin',
)

/** Parse a Markdown file into a CustomCommandSpec. */
export function parseSpec(
  raw: string,
  name: string,
  filePath: string,
  origin: 'project' | 'user' | 'plugin',
): CustomCommandSpec {
  let description: string | undefined;
  let argumentHint: string | undefined;
  let allowedTools: string[] | undefined;
  let model: string | undefined;
  let mode: 'plan' | 'normal' | undefined;
  let body = raw;

  // Frontmatter must be at the very top, delimited by --- on its own line.
  const fmMatch = raw.match(/^---\s*\n([\s\S]*?)\n---\s*\r?\n?([\s\S]*)$/);
  if (fmMatch) {
    const fm = fmMatch[1] ?? '';
    body = fmMatch[2] ?? '';
    const fmLines = fm.split('\n');
    let i = 0;
    while (i < fmLines.length) {
      const line = fmLines[i]!;
      // Skip empty/comment lines
      if (/^\s*(#.*)?$/.test(line)) { i++; continue; }
      const m = line.match(/^([a-zA-Z][\w-]*)\s*:\s*(.*)$/);
      if (!m) { i++; continue; }
      const key = m[1]!.toLowerCase();
      const rawValue = m[2]!.trim();

      let value: string | string[];
      if (rawValue === '') {
        // Look ahead for `  - item` lines (YAML multiline list form)
        const items: string[] = [];
        i++;
        while (i < fmLines.length && /^\s+-\s+/.test(fmLines[i]!)) {
          items.push(stripQuotes(fmLines[i]!.replace(/^\s+-\s+/, '').trim()));
          i++;
        }
        value = items;
      } else if (rawValue.startsWith('[') && rawValue.endsWith(']')) {
        // Inline array
        value = rawValue
          .slice(1, -1)
          .split(',')
          .map(s => stripQuotes(s.trim()))
          .filter(Boolean);
        i++;
      } else {
        value = stripQuotes(rawValue);
        i++;
      }

      // Apply the key. Validate types loosely.
      switch (key) {
        case 'description':
          if (typeof value === 'string') description = value;
          break;
        case 'argument-hint':