@mcptoolshop/style-dataset-lab 2.3.0 → 3.0.0

package/scripts/refine.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+
+/**
+ * refine.js — Generate a refined next-pass brief from critique.
+ *
+ * Usage:
+ *   sdlab refine --project star-freight --run run_2026-04-15_001 --pick 003.png
+ *   sdlab refine --run run_2026-04-15_001 --pick 003.png --push "stronger faction read" --suppress "extra ornament"
+ *   sdlab refine --run run_2026-04-15_001 --pick 003.png --json
+ */
+
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { parseArgs } from '../lib/args.js';
+import { getProjectRoot, getRunsDir } from '../lib/paths.js';
+import { loadCritique } from '../lib/critique-engine.js';
+import {
+  extractDelta,
+  buildRefinedBrief,
+  saveRefinedBrief,
+  renderRefinedBriefMarkdown,
+} from '../lib/refine-briefs.js';
+import { info } from '../lib/log.js';
+
+export async function run(argv = process.argv.slice(2)) {
+  const { flags } = parseArgs(argv, {
+    flags: {
+      project: { type: 'string', default: 'star-freight' },
+      run: { type: 'string' },
+      pick: { type: 'string' },
+      preserve: { type: 'string' },
+      push: { type: 'string' },
+      suppress: { type: 'string' },
+      json: { type: 'boolean' },
+    },
+    deprecated: { game: 'project' },
+  });
+
+  if (!flags.run || !flags.pick) {
+    console.log('Usage: sdlab refine --run <id> --pick <filename> [--project <name>]');
+    console.log('');
+    console.log('Options:');
+    console.log('  --run <id>             Run to refine from (required)');
+    console.log('  --pick <filename>      Candidate filename to refine from (required)');
+    console.log('  --preserve <notes>     Comma-separated preserve instructions');
+    console.log('  --push <notes>         Comma-separated push instructions');
+    console.log('  --suppress <notes>     Comma-separated suppress instructions');
+    console.log('  --json                 Output raw JSON');
+    return;
+  }
+
+  const projectName = flags.project;
+  const projectRoot = getProjectRoot(projectName);
+  const runId = flags.run;
+  const pickedFilename = flags.pick;
+
+  console.log(`\x1b[1mstyle-dataset-lab\x1b[0m refine`);
+  console.log(`  Project: ${projectName}`);
+  console.log(`  Run: ${runId}`);
+  console.log(`  Picked: ${pickedFilename}`);
+  console.log('');
+
+  // Load critique
+  const critique = loadCritique(projectRoot, runId);
+
+  // Load parent brief from the run
+  const runDir = join(getRunsDir(projectRoot), runId);
+  const parentBrief = JSON.parse(readFileSync(join(runDir, 'brief.json'), 'utf-8'));
+
+  // Parse CLI delta overrides
+  const cliOverrides = {
+    preserve: flags.preserve ? flags.preserve.split(',').map(s => s.trim()).filter(Boolean) : [],
+    push: flags.push ? flags.push.split(',').map(s => s.trim()).filter(Boolean) : [],
+    suppress: flags.suppress ? flags.suppress.split(',').map(s => s.trim()).filter(Boolean) : [],
+  };
+
+  // Extract delta from critique + overrides
+  const delta = extractDelta(critique, pickedFilename, cliOverrides);
+
+  // Build refined brief
+  const refineDir = join(runDir, 'refine');
+  const refinedBrief = buildRefinedBrief({
+    parentBrief,
+    critique,
+    pickedCandidate: pickedFilename,
+    delta,
+    runId,
+    refineDir,
+  });
+
+  // Save
+  const { jsonPath, mdPath } = await saveRefinedBrief(projectRoot, runId, refinedBrief);
+
+  if (flags.json) {
+    console.log(JSON.stringify(refinedBrief, null, 2));
+  } else {
+    console.log(`Refined brief: ${refinedBrief.brief_id}`);
+    console.log(`Parent: ${refinedBrief.parent_brief_id}`);
+    console.log(`Source: ${runId} → ${pickedFilename}`);
+    console.log('');
+
+    if (delta.preserve.length > 0) {
+      console.log('Preserve:');
+      for (const p of delta.preserve) console.log(`  ✓ ${p}`);
+    }
+    if (delta.push.length > 0) {
+      console.log('Push:');
+      for (const p of delta.push) console.log(`  → ${p}`);
+    }
+    if (delta.suppress.length > 0) {
+      console.log('Suppress:');
+      for (const s of delta.suppress) console.log(`  ✗ ${s}`);
+    }
+
+    console.log('');
+    info(`Saved: runs/${runId}/refine/${refinedBrief.brief_id}.json`);
+    info(`Next: sdlab run generate --brief ${refinedBrief.brief_id} (from refine dir)`);
+  }
+}

package/scripts/reingest-selected.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+
+/**
+ * reingest-selected.js — Re-ingest selected outputs as candidate records.
+ *
+ * Usage:
+ *   sdlab reingest selected --selection selection_2026-04-16_001 --project star-freight
+ *   sdlab reingest selected --selection selection_2026-04-16_001 --dry-run
+ */
+
+import { parseArgs } from '../lib/args.js';
+import { getProjectRoot } from '../lib/paths.js';
+import { reingestSelection } from '../lib/reingest-selected.js';
+import { info } from '../lib/log.js';
+
+export async function run(argv = process.argv.slice(2)) {
+  const { flags } = parseArgs(argv, {
+    flags: {
+      project: { type: 'string', default: 'star-freight' },
+      selection: { type: 'string' },
+      'dry-run': { type: 'boolean' },
+      json: { type: 'boolean' },
+    },
+    deprecated: { game: 'project' },
+  });
+
+  if (!flags.selection) {
+    console.log('Usage: sdlab reingest selected --selection <id> [--project <name>]');
+    console.log('');
+    console.log('Options:');
+    console.log('  --selection <id>   Selection to re-ingest (required)');
+    console.log('  --dry-run          Preview without writing records');
+    console.log('  --json             Output as JSON');
+    return;
+  }
+
+  const projectName = flags.project;
+  const projectRoot = getProjectRoot(projectName);
+  const dryRun = flags['dry-run'] || false;
+
+  console.log(`\x1b[1mstyle-dataset-lab\x1b[0m reingest selected`);
+  console.log(`  Selection: ${flags.selection}`);
+  console.log(`  Project: ${projectName}`);
+  if (dryRun) console.log('  ⚠ DRY RUN');
+  console.log('');
+
+  const { created, skipped } = await reingestSelection({
+    projectRoot,
+    projectId: projectName,
+    selectionId: flags.selection,
+    dryRun,
+  });
+
+  if (flags.json) {
+    console.log(JSON.stringify({ created, skipped }, null, 2));
+    return;
+  }
+
+  if (created.length > 0) {
+    console.log(`  Created ${created.length} candidate record(s):`);
+    for (const id of created) {
+      console.log(`    ✓ ${id}`);
+    }
+  }
+
+  if (skipped.length > 0) {
+    console.log(`  Skipped ${skipped.length} (already exist):`);
+    for (const id of skipped) {
+      console.log(`    ○ ${id}`);
+    }
+  }
+
+  console.log('');
+  if (!dryRun && created.length > 0) {
+    info('Records staged for review. Use sdlab curate to approve/reject.');
+    info(`Images copied to inbox/generated/`);
+  }
+}

package/scripts/reingest.js

@@ -50,6 +50,12 @@ export async function run(argv = process.argv.slice(2)) {
       console.log('    3. Then eligible for future snapshots');
     }
 
+  } else if (subcommand === 'selected') {
+    // Delegate to reingest-selected.js
+    const { run: runSelected } = await import('./reingest-selected.js');
+    await runSelected(args);
+    return;
+
   } else if (subcommand === 'audit') {
     console.log(`\x1b[1msdlab reingest audit\x1b[0m — ${projectName}\n`);
 
@@ -77,7 +83,7 @@ export async function run(argv = process.argv.slice(2)) {
     }
 
   } else {
-    throw new Error(`Unknown subcommand: ${subcommand}. Use: generated, audit`);
+    throw new Error(`Unknown subcommand: ${subcommand}. Use: generated, selected, audit`);
   }
 }
 

package/scripts/run-generate.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+
+/**
+ * run-generate.js — Execute a compiled brief through ComfyUI.
+ *
+ * Usage:
+ *   sdlab run generate --brief brief_2026-04-15_001 --project star-freight
+ *   sdlab run generate --brief brief_2026-04-15_001 --project star-freight --dry-run
+ *   sdlab run generate --brief brief_2026-04-15_001 --project star-freight --seed 42
+ */
+
+import { parseArgs } from '../lib/args.js';
+import { getProjectRoot, getRunsDir } from '../lib/paths.js';
+import { loadCompiledBrief } from '../lib/brief-compiler.js';
+import { executeRun } from '../lib/adapters/comfyui-runner.js';
+import { saveRunSummary, renderRunText } from '../lib/run-summary.js';
+import { info } from '../lib/log.js';
+import { join } from 'node:path';
+
+export async function run(argv = process.argv.slice(2)) {
+  const { flags } = parseArgs(argv, {
+    flags: {
+      project: { type: 'string', default: 'star-freight' },
+      brief: { type: 'string' },
+      seed: { type: 'string' },
+      'dry-run': { type: 'boolean' },
+      json: { type: 'boolean' },
+    },
+    deprecated: { game: 'project' },
+  });
+
+  if (!flags.brief) {
+    console.log('Usage: sdlab run generate --brief <id> [--project <name>]');
+    console.log('');
+    console.log('Options:');
+    console.log('  --brief <id>      Compiled brief ID (required)');
+    console.log('  --seed <n>        Override base seed');
+    console.log('  --dry-run         Prepare run dir without submitting to ComfyUI');
+    console.log('  --json            Output manifest as JSON');
+    return;
+  }
+
+  const projectName = flags.project;
+  const projectRoot = getProjectRoot(projectName);
+
+  console.log(`\x1b[1mstyle-dataset-lab\x1b[0m run generate`);
+  console.log(`  Project: ${projectName}`);
+  console.log(`  Brief: ${flags.brief}`);
+  if (flags['dry-run']) console.log('  ⚠ DRY RUN');
+  console.log('');
+
+  // Load brief
+  const brief = await loadCompiledBrief(projectRoot, flags.brief);
+
+  // Execute
+  const manifest = await executeRun({
+    projectRoot,
+    projectName,
+    brief,
+    baseSeed: flags.seed ? parseInt(flags.seed, 10) : undefined,
+    dryRun: flags['dry-run'] || false,
+  });
+
+  // Save summary
+  const runDir = join(getRunsDir(projectRoot), manifest.run_id);
+  await saveRunSummary(runDir, manifest);
+
+  console.log('');
+  if (flags.json) {
+    console.log(JSON.stringify(manifest, null, 2));
+  } else {
+    console.log(renderRunText(manifest));
+    console.log('');
+    info(`Run saved to: runs/${manifest.run_id}/`);
+  }
+}

package/scripts/run-list.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+
+/**
+ * run-list.js — List all runs for a project.
+ *
+ * Usage:
+ *   sdlab run list --project star-freight
+ *   sdlab run list --project star-freight --json
+ */
+
+import { parseArgs } from '../lib/args.js';
+import { getProjectRoot } from '../lib/paths.js';
+import { listRuns } from '../lib/runtime-runs.js';
+
+export async function run(argv = process.argv.slice(2)) {
+  const { flags } = parseArgs(argv, {
+    flags: {
+      project: { type: 'string', default: 'star-freight' },
+      json: { type: 'boolean' },
+    },
+    deprecated: { game: 'project' },
+  });
+
+  const projectName = flags.project;
+  const projectRoot = getProjectRoot(projectName);
+  const runs = listRuns(projectRoot);
+
+  if (flags.json) {
+    console.log(JSON.stringify(runs, null, 2));
+    return;
+  }
+
+  if (runs.length === 0) {
+    console.log('No runs found. Run: sdlab run generate --brief <id>');
+    return;
+  }
+
+  console.log(`\x1b[1mRuns for ${projectName}\x1b[0m (${runs.length})\n`);
+
+  const header = '  ' +
+    'Run ID'.padEnd(26) +
+    'Brief'.padEnd(26) +
+    'Mode'.padEnd(18) +
+    'Count'.padEnd(8) +
+    'Created';
+  console.log(header);
+  console.log('  ' + '─'.repeat(90));
+
+  for (const r of runs) {
+    const line = '  ' +
+      (r.run_id || '').padEnd(26) +
+      (r.brief_id || '').padEnd(26) +
+      (r.adapter_target || '?').padEnd(18) +
+      String(r.output_count ?? '?').padEnd(8) +
+      (r.created_at ? r.created_at.slice(0, 16) : '?');
+    console.log(line);
+  }
+}

package/scripts/run-show.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+
+/**
+ * run-show.js — Show details of a completed run.
+ *
+ * Usage:
+ *   sdlab run show run_2026-04-16_001 --project star-freight
+ *   sdlab run show run_2026-04-16_001 --project star-freight --json
+ *   sdlab run show run_2026-04-16_001 --project star-freight --md
+ */
+
+import { parseArgs } from '../lib/args.js';
+import { getProjectRoot } from '../lib/paths.js';
+import { loadRun, listRuns } from '../lib/runtime-runs.js';
+import { renderRunText, renderRunMarkdown } from '../lib/run-summary.js';
+
+export async function run(argv = process.argv.slice(2)) {
+  const { positionals, flags } = parseArgs(argv, {
+    flags: {
+      project: { type: 'string', default: 'star-freight' },
+      json: { type: 'boolean' },
+      md: { type: 'boolean' },
+    },
+    deprecated: { game: 'project' },
+  });
+
+  const runId = positionals[0];
+  const projectName = flags.project;
+  const projectRoot = getProjectRoot(projectName);
+
+  // No run ID → list runs
+  if (!runId) {
+    const runs = listRuns(projectRoot);
+    if (runs.length === 0) {
+      console.log('No runs found. Run: sdlab run generate --brief <id>');
+      return;
+    }
+
+    console.log(`\x1b[1mRuns for ${projectName}\x1b[0m (${runs.length})\n`);
+    console.log('  ID                       Brief                      Mode            Outputs  Adapter');
+    console.log('  ─'.padEnd(100, '─'));
+    for (const r of runs) {
+      const id = (r.run_id || '').padEnd(24);
+      const brief = (r.brief_id || '').padEnd(24);
+      const mode = (r.output_count != null ? `${r.output_count}` : '?').padStart(7);
+      const adapter = r.adapter_target || '?';
+      // output_mode if we have it
+      console.log(`  ${id}  ${brief}  ${mode}  ${adapter}`);
+    }
+    return;
+  }
+
+  // Show single run
+  const manifest = await loadRun(projectRoot, runId);
+
+  if (flags.json) {
+    console.log(JSON.stringify(manifest, null, 2));
+  } else if (flags.md) {
+    console.log(renderRunMarkdown(manifest));
+  } else {
+    console.log(renderRunText(manifest));
+  }
+}

package/scripts/select.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+
+/**
+ * select.js — Approve outputs from runs or batches.
+ *
+ * Usage:
+ *   sdlab select --run run_2026-04-15_001 --approve 001.png,003.png
+ *   sdlab select --batch batch_2026-04-16_001 --approve slot_neutral:001.png,slot_anger:001.png
+ *   sdlab select --run run_2026-04-15_001 --approve 001.png --reason "best continuity" --tags portrait,keeper
+ */
+
+import { parseArgs } from '../lib/args.js';
+import { getProjectRoot } from '../lib/paths.js';
+import {
+  createSelectionFromRun,
+  createSelectionFromBatch,
+  saveSelection,
+} from '../lib/selections.js';
+import { info } from '../lib/log.js';
+
+export async function run(argv = process.argv.slice(2)) {
+  const { flags } = parseArgs(argv, {
+    flags: {
+      project: { type: 'string', default: 'star-freight' },
+      run: { type: 'string' },
+      batch: { type: 'string' },
+      approve: { type: 'string' },
+      reason: { type: 'string' },
+      tags: { type: 'string' },
+      json: { type: 'boolean' },
+    },
+    deprecated: { game: 'project' },
+  });
+
+  if (!flags.approve || (!flags.run && !flags.batch)) {
+    console.log('Usage: sdlab select --run <id> --approve <files>');
+    console.log('       sdlab select --batch <id> --approve <slot:file,...>');
+    console.log('');
+    console.log('Options:');
+    console.log('  --run <id>          Source run');
+    console.log('  --batch <id>        Source batch');
+    console.log('  --approve <list>    Comma-separated files (run) or slot:file pairs (batch)');
+    console.log('  --reason <text>     Why these outputs were chosen');
+    console.log('  --tags <list>       Comma-separated tags');
+    console.log('  --json              Output manifest as JSON');
+    return;
+  }
+
+  const projectName = flags.project;
+  const projectRoot = getProjectRoot(projectName);
+  const reason = flags.reason || undefined;
+  const tags = flags.tags ? flags.tags.split(',').map(t => t.trim()) : undefined;
+
+  let result;
+
+  if (flags.run) {
+    // Run selection: --approve 001.png,003.png
+    const approvedFiles = flags.approve.split(',').map(f => f.trim());
+
+    result = await createSelectionFromRun({
+      projectRoot,
+      projectId: projectName,
+      runId: flags.run,
+      approvedFiles,
+      reason,
+      tags,
+    });
+  } else if (flags.batch) {
+    // Batch selection: --approve slot_neutral:001.png,slot_anger:001.png
+    const pairs = flags.approve.split(',').map(p => p.trim());
+    const approvedSlots = pairs.map(pair => {
+      const colonIdx = pair.indexOf(':');
+      if (colonIdx < 0) {
+        throw new Error(`Invalid batch approve format: "${pair}". Use slot_id:filename`);
+      }
+      return {
+        slotId: pair.slice(0, colonIdx),
+        filename: pair.slice(colonIdx + 1),
+      };
+    });
+
+    result = await createSelectionFromBatch({
+      projectRoot,
+      projectId: projectName,
+      batchId: flags.batch,
+      approvedSlots,
+      reason,
+      tags,
+    });
+  }
+
+  const { selectionId, selectionDir, manifest } = result;
+
+  // Save the selection
+  await saveSelection(selectionDir, manifest);
+
+  if (flags.json) {
+    console.log(JSON.stringify(manifest, null, 2));
+    return;
+  }
+
+  console.log(`\x1b[1mstyle-dataset-lab\x1b[0m select`);
+  console.log('');
+  console.log(`  Selection: ${selectionId}`);
+  console.log(`  Source: ${manifest.source_type} ${manifest.source_id}`);
+  if (manifest.workflow_id) console.log(`  Workflow: ${manifest.workflow_id}`);
+  if (manifest.subject_id) console.log(`  Subject: ${manifest.subject_id}`);
+  console.log(`  Items: ${manifest.items.length}`);
+  console.log('');
+
+  for (const item of manifest.items) {
+    console.log(`  ✓ ${item.slot_or_output.padEnd(28)} → ${item.filename}  ${item.reason}`);
+  }
+
+  console.log('');
+  info(`Selection: selections/${selectionId}/manifest.json`);
+  info(`Chosen files: selections/${selectionId}/chosen/`);
+}

package/scripts/selection-show.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+
+/**
+ * selection-show.js — Show selection details or list all selections.
+ *
+ * Usage:
+ *   sdlab selection show --project star-freight
+ *   sdlab selection show --selection selection_2026-04-16_001
+ *   sdlab selection show selection_2026-04-16_001 --json
+ */
+
+import { parseArgs } from '../lib/args.js';
+import { getProjectRoot } from '../lib/paths.js';
+import { loadSelection, listSelections, getSelectionsDir } from '../lib/selections.js';
+import { join } from 'node:path';
+import { existsSync, readFileSync } from 'node:fs';
+
+export async function run(argv = process.argv.slice(2)) {
+  const { flags, positionals } = parseArgs(argv, {
+    flags: {
+      project: { type: 'string', default: 'star-freight' },
+      selection: { type: 'string' },
+      json: { type: 'boolean' },
+    },
+    deprecated: { game: 'project' },
+  });
+
+  const projectName = flags.project;
+  const projectRoot = getProjectRoot(projectName);
+  const selectionId = positionals[0] || flags.selection;
+
+  // List mode
+  if (!selectionId) {
+    const selections = listSelections(projectRoot);
+    if (selections.length === 0) {
+      console.log('No selections found.');
+      return;
+    }
+    console.log(`\x1b[1mstyle-dataset-lab\x1b[0m selections (${projectName})`);
+    console.log('');
+    for (const id of selections) {
+      try {
+        const m = loadSelection(projectRoot, id);
+        const items = m.items?.length || 0;
+        const src = `${m.source_type}:${m.source_id}`;
+        const ready = m.reingest_ready ? '✓' : '○';
+        const subject = m.subject_id ? ` (${m.subject_id})` : '';
+        console.log(`  ${ready} ${id}  ${src.padEnd(32)} ${items} items${subject}`);
+      } catch {
+        console.log(`  ? ${id}  (manifest unreadable)`);
+      }
+    }
+    console.log('');
+    return;
+  }
+
+  // Detail mode
+  const manifest = loadSelection(projectRoot, selectionId);
+
+  if (flags.json) {
+    console.log(JSON.stringify(manifest, null, 2));
+    return;
+  }
+
+  console.log(`\x1b[1mstyle-dataset-lab\x1b[0m selection ${selectionId}`);
+  console.log('');
+  console.log(`  Source:          ${manifest.source_type} ${manifest.source_id}`);
+  if (manifest.workflow_id) console.log(`  Workflow:        ${manifest.workflow_id}`);
+  if (manifest.subject_id) console.log(`  Subject:         ${manifest.subject_id}`);
+  console.log(`  Created:         ${manifest.created_at}`);
+  console.log(`  Re-ingest ready: ${manifest.reingest_ready ? 'yes' : 'no'}`);
+  console.log('');
+  console.log('  Chosen outputs:');
+  for (const item of manifest.items || []) {
+    const seedStr = item.seed !== undefined ? `seed=${item.seed}` : '';
+    console.log(`    ✓ ${item.slot_or_output.padEnd(28)} → ${item.filename}  ${seedStr}`);
+    if (item.reason) console.log(`      ${item.reason}`);
+    if (item.tags?.length) console.log(`      tags: ${item.tags.join(', ')}`);
+  }
+
+  // Check provenance log
+  const provPath = join(getSelectionsDir(projectRoot), selectionId, 'provenance.jsonl');
+  if (existsSync(provPath)) {
+    console.log('');
+    console.log('  Provenance log: provenance.jsonl');
+  }
+  console.log('');
+}

package/scripts/workflow-list.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+
+/**
+ * workflow-list.js — List workflow profiles for a project.
+ *
+ * Usage:
+ *   sdlab workflow list --project star-freight
+ *   sdlab workflow list --project star-freight --json
+ */
+
+import { getProjectName, parseArgs } from '../lib/args.js';
+import { getProjectRoot } from '../lib/paths.js';
+import { listWorkflowProfiles } from '../lib/workflow-profiles.js';
+
+export async function run(argv = process.argv.slice(2)) {
+  const { flags } = parseArgs(argv, {
+    flags: {
+      project: { type: 'string', default: 'star-freight' },
+      json: { type: 'boolean' },
+    },
+    deprecated: { game: 'project' },
+  });
+
+  const projectName = flags.project;
+  const projectRoot = getProjectRoot(projectName);
+  const profiles = await listWorkflowProfiles(projectRoot);
+
+  if (flags.json) {
+    console.log(JSON.stringify(profiles, null, 2));
+    return;
+  }
+
+  console.log(`\x1b[1msdlab workflow list\x1b[0m — ${projectName}\n`);
+
+  if (profiles.length === 0) {
+    console.log('  No workflow profiles found.');
+    console.log(`  Add profiles to projects/${projectName}/workflows/profiles/`);
+    return;
+  }
+
+  // Table header
+  const idW = Math.max(12, ...profiles.map(p => p.workflow_id.length));
+  const laneW = Math.max(6, ...profiles.map(p => p.lane_id.length));
+  const modeW = Math.max(7, ...profiles.map(p => (p.subject_mode || 'optional').length));
+  const outW = Math.max(11, ...profiles.map(p => p.output_mode.length));
+
+  const header = `  ${'WORKFLOW'.padEnd(idW)}  ${'LANE'.padEnd(laneW)}  ${'SUBJECT'.padEnd(modeW)}  ${'OUTPUT MODE'.padEnd(outW)}  COUNT`;
+  console.log(header);
+  console.log('  ' + '─'.repeat(header.length - 2));
+
+  for (const p of profiles) {
+    const line = `  ${p.workflow_id.padEnd(idW)}  ${p.lane_id.padEnd(laneW)}  ${(p.subject_mode || 'optional').padEnd(modeW)}  ${p.output_mode.padEnd(outW)}  ${p.output_count}`;
+    console.log(line);
+  }
+
+  console.log(`\n  ${profiles.length} workflow(s)`);
+}
+
+if (process.argv[1] && (process.argv[1].endsWith('workflow-list.js') || process.argv[1].endsWith('workflow-list'))) {
+  run().catch((err) => { console.error(err.message || err); process.exit(1); });
+}