{
  "id": "page:library-common-utilities",
  "_kind": "Page",
  "_file": "wiki/library/common-utilities.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "title": "Common Utilities (Library)",
    "displayName": "Common Utilities (Library)",
    "slug": "library/common-utilities",
    "articlePath": "wiki/library/common-utilities.md",
    "article": "\n# Common Utilities\n\nReusable task definitions and utility functions for composing babysitter processes.\n\n## Modules\n\n### docx-conversion\n\nA shared HTML-to-DOCX conversion task using pandoc with graceful fallback.\n\n**Usage:**\n```javascript\nimport { convertToDocxTask } from '../common-utilities/index.js';\n\n// In your process:\nconst result = await ctx.task(convertToDocxTask, {\n  htmlPath: '/path/to/input.html',\n  docxPath: '/path/to/output.docx'\n});\n// result: { success: true, path: '...', converter: 'pandoc' }\n// or:     { success: false, path: '...', reason: 'pandoc not installed', converter: 'none' }\n```\n\n### parallel-combinator\n\nUtility functions for parallel task execution with fan-out/fan-in patterns.\n\n**fanOutFanIn** - Run multiple tasks in parallel with shared input:\n```javascript\nimport { fanOutFanIn } from '../common-utilities/index.js';\n\nconst [strengths, weaknesses] = await fanOutFanIn(ctx, { essay, analysis }, [\n  { task: evaluateStrengthsTask },\n  { task: evaluateWeaknessesTask }\n]);\n```\n\n**pipeline** - Sequential phases with optional parallel steps:\n```javascript\nimport { pipeline } from '../common-utilities/index.js';\n\nconst result = await pipeline(ctx, { essay }, [\n  { task: analyzeTask, key: 'analysis' },\n  [\n    { task: strengthsTask, key: 'strengths' },\n    { task: weaknessesTask, key: 'weaknesses' }\n  ],\n  { task: synthesizeTask, key: 'document' }\n]);\n```\n\n## Origin\n\nThese utilities were extracted from a retrospective analysis of essay-critique, extract-oral-prep, and essay-grading processes where identical patterns were duplicated across multiple files.\n",
    "documents": [
      "specialization:common-utilities"
    ]
  },
  "outgoingEdges": [
    {
      "from": "page:library-common-utilities",
      "to": "specialization:common-utilities",
      "kind": "documents"
    }
  ],
  "incomingEdges": [
    {
      "from": "page:index",
      "to": "page:library-common-utilities",
      "kind": "contains_page"
    }
  ]
}