skilld 1.0.1 → 1.1.0

package/dist/_chunks/assemble.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"assemble.mjs","names":[],"sources":["../../src/commands/assemble.ts"],"sourcesContent":["/**\n * `skilld assemble` — merge pasted LLM output back into SKILL.md\n *\n * Auto-discovers skill directories with pending output files when run without arguments.\n */\n\nimport type { SkillSection } from '../agent/index.ts'\nimport { existsSync, readdirSync, readFileSync, writeFileSync } from 'node:fs'\nimport * as p from '@clack/prompts'\nimport { defineCommand } from 'citty'\nimport { join, relative, resolve } from 'pathe'\nimport { cleanSectionOutput } from '../agent/clis/index.ts'\nimport {\n  extractMarkedSections,\n  getSectionValidator,\n  SECTION_MERGE_ORDER,\n  SECTION_OUTPUT_FILES,\n  wrapSection,\n} from '../agent/index.ts'\nimport { iterateSkills } from '../core/skills.ts'\n\nconst OUTPUT_FILE_SET = new Set(Object.values(SECTION_OUTPUT_FILES))\n\n/**\n * Find installed skill dirs that have pending section output files.\n */\nfunction discoverSkillDirsWithOutputs(): string[] {\n  const dirs: string[] = []\n  for (const skill of iterateSkills({})) {\n    if (readdirSync(skill.dir).some(f => OUTPUT_FILE_SET.has(f)))\n      dirs.push(skill.dir)\n  }\n  return dirs\n}\n\nexport async function assembleCommand(dir: string | undefined): Promise<void> {\n  const cwd = process.cwd()\n\n  let dirs: string[]\n  if (dir) {\n    dirs = [resolve(cwd, dir)]\n  }\n  else {\n    // Check cwd first — if it has SKILL.md + output files, use it\n    if (existsSync(join(cwd, 'SKILL.md'))\n      && readdirSync(cwd).some(f => OUTPUT_FILE_SET.has(f))) {\n      dirs = [cwd]\n    }\n    else {\n      dirs = discoverSkillDirsWithOutputs()\n      if (dirs.length === 0) {\n        p.log.error('No skill directories with output files found. Run `skilld add` first.')\n        return\n      }\n    }\n  }\n\n  for (const targetDir of dirs)\n    assembleDir(targetDir, cwd)\n}\n\nfunction assembleDir(targetDir: string, cwd: string): void {\n  if (!existsSync(targetDir)) {\n    p.log.error(`Directory not found: ${targetDir}`)\n    return\n  }\n\n  const skillMdPath = join(targetDir, 'SKILL.md')\n  if (!existsSync(skillMdPath)) {\n    p.log.error(`No SKILL.md found in ${targetDir}`)\n    return\n  }\n\n  const existingSkillMd = readFileSync(skillMdPath, 'utf-8')\n\n  // Find and read section output files\n  const sections: Array<{ section: SkillSection, content: string }> = []\n  const warnings: string[] = []\n\n  for (const [section, outputFile] of Object.entries(SECTION_OUTPUT_FILES) as Array<[SkillSection, string]>) {\n    const filePath = join(targetDir, outputFile)\n    if (!existsSync(filePath))\n      continue\n\n    const raw = readFileSync(filePath, 'utf-8').trim()\n    if (!raw) {\n      p.log.warn(`Empty file: ${outputFile}`)\n      continue\n    }\n\n    const cleaned = cleanSectionOutput(raw)\n    if (!cleaned) {\n      const missing: string[] = []\n      if (!/^##\\s/m.test(raw))\n        missing.push('h2 heading (## ...)')\n      if (!/^- (?:BREAKING|DEPRECATED|NEW): /m.test(raw))\n        missing.push('change label (- BREAKING/DEPRECATED/NEW: ...)')\n      if (!/\\[source\\]/.test(raw))\n        missing.push('[source] link')\n      p.log.warn(`${outputFile}: content rejected — missing ${missing.join(', ')}`)\n      continue\n    }\n\n    const validator = getSectionValidator(section)\n    if (validator) {\n      for (const w of validator(cleaned))\n        warnings.push(`${section}: ${w.warning}`)\n    }\n\n    sections.push({ section, content: cleaned })\n    p.log.success(`Loaded ${outputFile}`)\n  }\n\n  if (sections.length === 0) {\n    p.log.warn(`No section output files in ${relative(cwd, targetDir)}. Expected: ${Object.values(SECTION_OUTPUT_FILES).join(', ')}`)\n    return\n  }\n\n  for (const w of warnings)\n    p.log.warn(`\\x1B[33m${w}\\x1B[0m`)\n\n  // Wrap each section with comment markers\n  const wrappedSections: Array<{ section: SkillSection, wrapped: string }> = []\n  for (const section of SECTION_MERGE_ORDER) {\n    const result = sections.find(s => s.section === section)\n    if (result)\n      wrappedSections.push({ section, wrapped: wrapSection(section, result.content) })\n  }\n\n  // Try marker-based replacement first (re-assembly of previously assembled SKILL.md)\n  const existingMarkers = extractMarkedSections(existingSkillMd)\n  let newSkillMd: string\n\n  if (existingMarkers.size > 0) {\n    // Replace existing marked sections in-place, append new ones at the end\n    newSkillMd = existingSkillMd\n    // Process in reverse offset order to preserve indices\n    const replacements = wrappedSections\n      .filter(s => existingMarkers.has(s.section))\n      .sort((a, b) => existingMarkers.get(b.section)!.start - existingMarkers.get(a.section)!.start)\n    for (const { section, wrapped } of replacements) {\n      const { start, end } = existingMarkers.get(section)!\n      newSkillMd = newSkillMd.slice(0, start) + wrapped + newSkillMd.slice(end)\n    }\n    // Append sections that don't have existing markers\n    const newSections = wrappedSections.filter(s => !existingMarkers.has(s.section))\n    if (newSections.length > 0)\n      newSkillMd = `${newSkillMd.trimEnd()}\\n\\n${newSections.map(s => s.wrapped).join('\\n\\n')}\\n`\n  }\n  else {\n    // First assembly — find header boundary and append all sections\n    const body = wrappedSections.map(s => s.wrapped).join('\\n\\n')\n    const fmEnd = existingSkillMd.indexOf('\\n---\\n', 4)\n    const afterFm = fmEnd !== -1 ? existingSkillMd.slice(fmEnd + 5) : existingSkillMd\n\n    const firstLlmHeading = body.match(/^## .+$/m)?.[0]\n    let headerPart = afterFm\n    if (firstLlmHeading) {\n      const idx = afterFm.indexOf(firstLlmHeading)\n      if (idx !== -1)\n        headerPart = afterFm.slice(0, idx)\n    }\n\n    const fmPart = fmEnd !== -1 ? existingSkillMd.slice(0, fmEnd + 5) : ''\n    const cleanHeader = headerPart.trimEnd()\n    newSkillMd = fmPart\n      ? `${fmPart}${cleanHeader}\\n\\n${body}\\n`\n      : `${cleanHeader}\\n\\n${body}\\n`\n  }\n\n  writeFileSync(skillMdPath, newSkillMd)\n  p.log.success(`Updated ${relative(cwd, skillMdPath)} with ${sections.length} section(s)`)\n}\n\nexport const assembleCommandDef = defineCommand({\n  meta: { name: 'assemble', description: 'Merge LLM output files into SKILL.md' },\n  args: {\n    dir: {\n      type: 'positional',\n      description: 'Skill directory with output files (auto-discovers installed skills)',\n      required: false,\n    },\n  },\n  async run({ args }) {\n    await assembleCommand(args.dir)\n  },\n})\n"],"mappings":"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"}