@mcptoolshop/style-dataset-lab 2.2.1 → 3.0.0

package/package.json

@@ -1,20 +1,19 @@
 {
   "name": "@mcptoolshop/style-dataset-lab",
-  "version": "2.2.1",
-  "description": "Visual canon and dataset production pipeline — snapshots, splits, versioned exports, eval packs, and canon-bound curation for any image production domain",
+  "version": "3.0.0",
+  "description": "Canon-aligned dataset production and generation workbench — define visual rules, build versioned training data, compile production briefs, run local workflows, batch-produce, select winners, and re-ingest into your corpus",
   "type": "module",
   "bin": {
     "sdlab": "./bin/sdlab.js"
   },
   "scripts": {
+    "verify": "node bin/sdlab.js --help && node bin/sdlab.js project doctor --project star-freight",
     "generate": "node scripts/generate.js",
     "curate": "node scripts/curate.js",
     "compare": "node scripts/compare.js",
     "canon-bind": "node scripts/canon-bind.js",
     "painterly": "node scripts/painterly.js",
-    "generate:identity": "node scripts/generate-identity.js",
-    "export": "echo 'Usage: repo-dataset visual generate ./projects/<project> --format trl'",
-    "inspect": "echo 'Usage: repo-dataset visual inspect ./projects/<project>'"
+    "generate:identity": "node scripts/generate-identity.js"
   },
   "files": [
     "bin/",
@@ -39,7 +38,10 @@
     "style-guide",
     "lora",
     "multimodal",
-    "comfyui"
+    "comfyui",
+    "generation-workflow",
+    "batch-production",
+    "reintegration"
   ],
   "homepage": "https://mcp-tool-shop-org.github.io/style-dataset-lab/",
   "repository": {

package/scripts/batch-generate.js

@@ -0,0 +1,167 @@
+#!/usr/bin/env node
+
+/**
+ * batch-generate.js — Execute a batch production mode.
+ *
+ * Usage:
+ *   sdlab batch generate --mode expression-sheet --subject captain-orryn --project star-freight
+ *   sdlab batch generate --mode environment-board --theme freeport-night --project star-freight
+ *   sdlab batch generate --mode silhouette-pack --project star-freight --dry-run
+ */
+
+import { parseArgs } from '../lib/args.js';
+import { getProjectRoot, getRunsDir } from '../lib/paths.js';
+import { compileBatch } from '../lib/batch-compiler.js';
+import { getBatchMode } from '../lib/batch-modes.js';
+import {
+  createBatchDir,
+  executeBatchRuns,
+  saveBatchManifest,
+} from '../lib/batch-runs.js';
+import { renderSheetHTML, saveSheet } from '../lib/batch-sheet-render.js';
+import { info } from '../lib/log.js';
+import { join } from 'node:path';
+import { writeFile } from 'node:fs/promises';
+
+export async function run(argv = process.argv.slice(2)) {
+  const { flags } = parseArgs(argv, {
+    flags: {
+      project: { type: 'string', default: 'star-freight' },
+      mode: { type: 'string' },
+      subject: { type: 'string' },
+      theme: { type: 'string' },
+      asset: { type: 'string' },
+      'dry-run': { type: 'boolean' },
+      json: { type: 'boolean' },
+    },
+    deprecated: { game: 'project' },
+  });
+
+  if (!flags.mode) {
+    console.log('Usage: sdlab batch generate --mode <id> [--subject <id>] [--theme <label>] [--project <name>]');
+    console.log('');
+    console.log('Options:');
+    console.log('  --mode <id>        Batch mode (required)');
+    console.log('  --subject <id>     Subject for subject-driven modes');
+    console.log('  --theme <label>    Theme label for environment modes');
+    console.log('  --asset <id>       Training asset reference');
+    console.log('  --dry-run          Prepare batch without submitting to ComfyUI');
+    console.log('  --json             Output manifest as JSON');
+    return;
+  }
+
+  const projectName = flags.project;
+  const projectRoot = getProjectRoot(projectName);
+  const dryRun = flags['dry-run'] || false;
+
+  // Load mode for display
+  const mode = getBatchMode(projectRoot, flags.mode);
+
+  console.log(`\x1b[1mstyle-dataset-lab\x1b[0m batch generate`);
+  console.log(`  Project: ${projectName}`);
+  console.log(`  Mode: ${mode.label} (${mode.mode_id})`);
+  console.log(`  Type: ${mode.batch_type}`);
+  console.log(`  Slots: ${mode.variant_plan.length}`);
+  if (flags.subject) console.log(`  Subject: ${flags.subject}`);
+  if (flags.theme) console.log(`  Theme: ${flags.theme}`);
+  if (dryRun) console.log('  ⚠ DRY RUN');
+  console.log('');
+
+  // 1. Compile batch briefs
+  const { baseBrief, slotBriefs } = await compileBatch({
+    projectRoot,
+    projectId: projectName,
+    modeId: flags.mode,
+    subjectId: flags.subject,
+    theme: flags.theme,
+    assetRef: flags.asset,
+  });
+
+  // 2. Create batch directory
+  const { batchId, batchDir } = await createBatchDir(projectRoot);
+  info(`Batch: ${batchId}`);
+
+  // 3. Execute runs
+  const results = await executeBatchRuns({
+    projectRoot,
+    projectName,
+    batchDir,
+    mode,
+    slotBriefs,
+    dryRun,
+  });
+
+  // 4. Build manifest
+  const manifest = {
+    batch_id: batchId,
+    project_id: projectName,
+    mode_id: mode.mode_id,
+    created_at: new Date().toISOString(),
+    brief_ids: results.map(r => r.brief_id),
+    run_ids: results.map(r => r.run_id),
+    slots: results.map(r => ({
+      slot_id: r.slot_id,
+      label: r.label,
+      brief_id: r.brief_id,
+      run_id: r.run_id,
+      selected_output: r.selected_output,
+    })),
+    sheet_paths: [],
+    summary: {
+      total_slots: results.length,
+      successful_slots: results.filter(r => r.selected_output).length,
+      dry_run: dryRun,
+    },
+  };
+
+  if (flags.subject) manifest.subject_id = flags.subject;
+  if (flags.theme) manifest.theme = flags.theme;
+
+  // 5. Render sheet
+  const sheetHtml = renderSheetHTML({ manifest, mode, projectRoot, batchDir });
+  const sheetPath = await saveSheet(batchDir, 'primary-sheet.html', sheetHtml);
+  manifest.sheet_paths.push('sheets/primary-sheet.html');
+
+  // 6. Save manifest + summary
+  await saveBatchManifest(batchDir, manifest);
+
+  // Write summary.md
+  const summaryLines = [
+    `# Batch: ${batchId}`,
+    '',
+    `**Mode:** ${mode.label} (${mode.mode_id})`,
+    `**Type:** ${mode.batch_type}`,
+    `**Project:** ${projectName}`,
+  ];
+  if (manifest.subject_id) summaryLines.push(`**Subject:** ${manifest.subject_id}`);
+  if (manifest.theme) summaryLines.push(`**Theme:** ${manifest.theme}`);
+  summaryLines.push(`**Created:** ${manifest.created_at}`);
+  if (dryRun) summaryLines.push('**⚠ DRY RUN**');
+  summaryLines.push('');
+  summaryLines.push('## Slots');
+  summaryLines.push('');
+  summaryLines.push('| Slot | Run | Output |');
+  summaryLines.push('|------|-----|--------|');
+  for (const r of results) {
+    summaryLines.push(`| ${r.label} | ${r.run_id} | ${r.selected_output || '—'} |`);
+  }
+  summaryLines.push('');
+  await writeFile(join(batchDir, 'summary.md'), summaryLines.join('\n'));
+
+  // 7. Output
+  console.log('');
+  if (flags.json) {
+    console.log(JSON.stringify(manifest, null, 2));
+  } else {
+    console.log(`Batch: ${batchId}`);
+    console.log(`Slots: ${results.length}`);
+    console.log('');
+    for (const r of results) {
+      const status = r.selected_output ? '✓' : '○';
+      console.log(`  ${status} ${r.label.padEnd(24)} → ${r.run_id}  ${r.selected_output || '(dry run)'}`);
+    }
+    console.log('');
+    info(`Sheet: batches/${batchId}/sheets/primary-sheet.html`);
+    info(`Manifest: batches/${batchId}/manifest.json`);
+  }
+}

package/scripts/batch-sheet.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+
+/**
+ * batch-sheet.js — Re-render a batch sheet from saved manifest.
+ *
+ * Usage:
+ *   sdlab batch sheet batch_2025-06-30_001 --project star-freight
+ */
+
+import { parseArgs } from '../lib/args.js';
+import { getProjectRoot } from '../lib/paths.js';
+import { loadBatchManifest } from '../lib/batch-runs.js';
+import { getBatchMode } from '../lib/batch-modes.js';
+import { renderSheetHTML, saveSheet } from '../lib/batch-sheet-render.js';
+import { getBatchesDir } from '../lib/batch-runs.js';
+import { join } from 'node:path';
+import { inputError } from '../lib/errors.js';
+import { info } from '../lib/log.js';
+
+export async function run(argv = process.argv.slice(2)) {
+  const { flags, positionals } = parseArgs(argv, {
+    flags: {
+      project: { type: 'string', default: 'star-freight' },
+      batch: { type: 'string' },
+    },
+    deprecated: { game: 'project' },
+  });
+
+  const projectName = flags.project;
+  const projectRoot = getProjectRoot(projectName);
+  const batchId = positionals[0] || flags.batch;
+
+  if (!batchId) {
+    console.log('Usage: sdlab batch sheet <batch-id> [--project <name>]');
+    return;
+  }
+
+  const manifest = loadBatchManifest(projectRoot, batchId);
+  const mode = getBatchMode(projectRoot, manifest.mode_id);
+  const batchDir = join(getBatchesDir(projectRoot), batchId);
+
+  const html = renderSheetHTML({ manifest, mode, projectRoot, batchDir });
+  const sheetPath = await saveSheet(batchDir, 'primary-sheet.html', html);
+
+  info(`Sheet written: ${sheetPath}`);
+}

package/scripts/batch-show.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+
+/**
+ * batch-show.js — List batches or show batch details.
+ *
+ * Usage:
+ *   sdlab batch show --project star-freight          # list all batches
+ *   sdlab batch show batch_2025-06-30_001            # show specific batch
+ *   sdlab batch show batch_2025-06-30_001 --json     # as JSON
+ */
+
+import { parseArgs } from '../lib/args.js';
+import { getProjectRoot } from '../lib/paths.js';
+import { listBatches, loadBatchManifest } from '../lib/batch-runs.js';
+
+export async function run(argv = process.argv.slice(2)) {
+  const { flags, positionals } = parseArgs(argv, {
+    flags: {
+      project: { type: 'string', default: 'star-freight' },
+      batch: { type: 'string' },
+      json: { type: 'boolean' },
+    },
+    deprecated: { game: 'project' },
+  });
+
+  const projectName = flags.project;
+  const projectRoot = getProjectRoot(projectName);
+  const batchId = positionals[0] || flags.batch;
+
+  // List mode
+  if (!batchId) {
+    const batches = listBatches(projectRoot);
+    if (batches.length === 0) {
+      console.log('No batches found.');
+      return;
+    }
+    console.log(`\x1b[1mstyle-dataset-lab\x1b[0m batches (${projectName})`);
+    console.log('');
+    for (const id of batches) {
+      try {
+        const manifest = loadBatchManifest(projectRoot, id);
+        const mode = manifest.mode_id || '?';
+        const slots = manifest.summary?.total_slots || manifest.slots?.length || 0;
+        const ok = manifest.summary?.successful_slots ?? '?';
+        const dry = manifest.summary?.dry_run ? ' [dry]' : '';
+        const subject = manifest.subject_id ? ` (${manifest.subject_id})` : '';
+        console.log(`  ${id}  ${mode.padEnd(24)} ${ok}/${slots} slots${dry}${subject}`);
+      } catch {
+        console.log(`  ${id}  (manifest unreadable)`);
+      }
+    }
+    console.log('');
+    return;
+  }
+
+  // Detail mode
+  const manifest = loadBatchManifest(projectRoot, batchId);
+
+  if (flags.json) {
+    console.log(JSON.stringify(manifest, null, 2));
+    return;
+  }
+
+  console.log(`\x1b[1mstyle-dataset-lab\x1b[0m batch ${batchId}`);
+  console.log('');
+  console.log(`  Mode:      ${manifest.mode_id}`);
+  console.log(`  Project:   ${manifest.project_id}`);
+  if (manifest.subject_id) console.log(`  Subject:   ${manifest.subject_id}`);
+  if (manifest.theme) console.log(`  Theme:     ${manifest.theme}`);
+  console.log(`  Created:   ${manifest.created_at}`);
+  if (manifest.summary?.dry_run) console.log('  ⚠ DRY RUN');
+  console.log('');
+  console.log('  Slots:');
+  for (const slot of manifest.slots || []) {
+    const status = slot.selected_output ? '✓' : '○';
+    console.log(`    ${status} ${(slot.label || slot.slot_id).padEnd(24)} run=${slot.run_id}  ${slot.selected_output || ''}`);
+  }
+  console.log('');
+  if (manifest.sheet_paths?.length) {
+    console.log('  Sheets:');
+    for (const p of manifest.sheet_paths) {
+      console.log(`    ${p}`);
+    }
+    console.log('');
+  }
+}

package/scripts/brief-compile.js

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+
+/**
+ * brief-compile.js — Compile a generation brief from project truth.
+ *
+ * Usage:
+ *   sdlab brief compile --project star-freight --workflow character-portrait-set --subject kael_maren
+ *   sdlab brief compile --project star-freight --workflow environment-moodboard
+ *   sdlab brief compile --project star-freight --workflow character-portrait-set --subject kael_maren --reference sf_001,sf_018
+ *   sdlab brief compile --project star-freight --workflow character-portrait-set --subject kael_maren --output-count 8 --json
+ */
+
+import { parseArgs } from '../lib/args.js';
+import { getProjectRoot } from '../lib/paths.js';
+import { compileBrief, saveCompiledBrief } from '../lib/brief-compiler.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' },
+      workflow: { type: 'string' },
+      subject: { type: 'string' },
+      asset: { type: 'string' },
+      'implementation-pack': { type: 'string' },
+      reference: { type: 'string' },
+      'output-count': { type: 'string' },
+      width: { type: 'string' },
+      height: { type: 'string' },
+      steps: { type: 'string' },
+      cfg: { type: 'string' },
+      sampler: { type: 'string' },
+      'seed-mode': { type: 'string' },
+      json: { type: 'boolean' },
+      'dry-run': { type: 'boolean' },
+    },
+    deprecated: { game: 'project' },
+  });
+
+  if (!flags.workflow) {
+    console.log('Usage: sdlab brief compile --workflow <id> [--subject <id>] [--project <name>]');
+    console.log('');
+    console.log('Options:');
+    console.log('  --workflow <id>         Workflow profile to use (required)');
+    console.log('  --subject <id>          Subject ID for subject-driven workflows');
+    console.log('  --asset <id>            Training asset reference');
+    console.log('  --implementation-pack <id>  Implementation pack reference');
+    console.log('  --reference <ids>       Comma-separated reference record IDs');
+    console.log('  --output-count <n>      Override output count');
+    console.log('  --width <px>            Override width');
+    console.log('  --height <px>           Override height');
+    console.log('  --steps <n>             Override steps');
+    console.log('  --cfg <n>               Override CFG scale');
+    console.log('  --sampler <name>        Override sampler');
+    console.log('  --seed-mode <mode>      Override seed mode (fixed|increment|random)');
+    console.log('  --json                  Output raw JSON');
+    console.log('  --dry-run               Preview without saving');
+    return;
+  }
+
+  const projectName = flags.project;
+  const projectRoot = getProjectRoot(projectName);
+
+  // Parse reference IDs
+  const referenceIds = flags.reference
+    ? flags.reference.split(',').map(s => s.trim()).filter(Boolean)
+    : undefined;
+
+  // Parse overrides
+  const overrides = {};
+  if (flags['output-count']) overrides.output_count = parseInt(flags['output-count'], 10);
+  if (flags.width) overrides.width = parseInt(flags.width, 10);
+  if (flags.height) overrides.height = parseInt(flags.height, 10);
+  if (flags.steps) overrides.steps = parseInt(flags.steps, 10);
+  if (flags.cfg) overrides.cfg = parseFloat(flags.cfg);
+  if (flags.sampler) overrides.sampler = flags.sampler;
+  if (flags['seed-mode']) overrides.seed_mode = flags['seed-mode'];
+
+  const brief = await compileBrief({
+    projectRoot,
+    projectId: projectName,
+    workflowId: flags.workflow,
+    subjectId: flags.subject,
+    assetRef: flags.asset,
+    implementationPackRef: flags['implementation-pack'],
+    referenceIds,
+    overrides,
+  });
+
+  if (flags.json) {
+    console.log(JSON.stringify(brief, null, 2));
+    if (!flags['dry-run']) {
+      await saveCompiledBrief(projectRoot, brief);
+    }
+    return;
+  }
+
+  if (!flags['dry-run']) {
+    const { jsonPath, mdPath } = await saveCompiledBrief(projectRoot, brief);
+    info(`\x1b[1msdlab brief compile\x1b[0m — ${projectName}\n`);
+    info(`  Brief ID:   ${brief.brief_id}`);
+    info(`  Workflow:   ${brief.workflow_id}`);
+    info(`  Lane:       ${brief.lane_id}`);
+    if (brief.subject_id) info(`  Subject:    ${brief.subject_id}`);
+    info(`  Outputs:    ${brief.expected_outputs.output_count}× ${brief.expected_outputs.output_mode}`);
+    info('');
+    info(`  Saved: ${jsonPath}`);
+    info(`         ${mdPath}`);
+  } else {
+    info(`\x1b[1msdlab brief compile\x1b[0m — dry run\n`);
+    info(`  Brief ID:   ${brief.brief_id}`);
+    info(`  Workflow:   ${brief.workflow_id}`);
+    info(`  Lane:       ${brief.lane_id}`);
+    if (brief.subject_id) info(`  Subject:    ${brief.subject_id}`);
+    info(`  Outputs:    ${brief.expected_outputs.output_count}× ${brief.expected_outputs.output_mode}`);
+    info('');
+    info('  Prompt:');
+    info(`    ${brief.prompt}`);
+    info('');
+    info('  Negative:');
+    info(`    ${brief.negative_prompt}`);
+    info('');
+    if (brief.drift_warnings?.length > 0) {
+      info('  Drift warnings:');
+      for (const w of brief.drift_warnings) {
+        info(`    \x1b[33m⚠\x1b[0m ${w}`);
+      }
+    }
+  }
+}
+
+if (process.argv[1] && (process.argv[1].endsWith('brief-compile.js') || process.argv[1].endsWith('brief-compile'))) {
+  run().catch((err) => { console.error(err.message || err); process.exit(1); });
+}

package/scripts/brief-show.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+
+/**
+ * brief-show.js — Show a compiled brief.
+ *
+ * Usage:
+ *   sdlab brief show brief_2026-04-15_001 --project star-freight
+ *   sdlab brief show brief_2026-04-15_001 --json
+ *   sdlab brief show brief_2026-04-15_001 --md
+ */
+
+import { parseArgs } from '../lib/args.js';
+import { getProjectRoot } from '../lib/paths.js';
+import { loadCompiledBrief } from '../lib/brief-compiler.js';
+import { renderBriefText, renderBriefMarkdown } from '../lib/brief-render.js';
+
+export async function run(argv = process.argv.slice(2)) {
+  const { flags, positionals } = parseArgs(argv, {
+    flags: {
+      project: { type: 'string', default: 'star-freight' },
+      json: { type: 'boolean' },
+      md: { type: 'boolean' },
+    },
+    positionals: ['briefId'],
+    deprecated: { game: 'project' },
+  });
+
+  const briefId = positionals[0];
+  if (!briefId) {
+    console.log('Usage: sdlab brief show <brief-id> [--project <name>] [--json] [--md]');
+    return;
+  }
+
+  const projectRoot = getProjectRoot(flags.project);
+  const brief = await loadCompiledBrief(projectRoot, briefId);
+
+  if (flags.json) {
+    console.log(JSON.stringify(brief, null, 2));
+    return;
+  }
+
+  if (flags.md) {
+    console.log(renderBriefMarkdown(brief));
+    return;
+  }
+
+  console.log(renderBriefText(brief));
+}
+
+if (process.argv[1] && (process.argv[1].endsWith('brief-show.js') || process.argv[1].endsWith('brief-show'))) {
+  run().catch((err) => { console.error(err.message || err); process.exit(1); });
+}

package/scripts/critique-show.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+
+/**
+ * critique-show.js — Display a saved critique report.
+ *
+ * Usage:
+ *   sdlab critique show --project star-freight --run run_2026-04-15_001
+ *   sdlab critique show --project star-freight --run run_2026-04-15_001 --json
+ *   sdlab critique show --project star-freight --run run_2026-04-15_001 --md
+ */
+
+import { parseArgs } from '../lib/args.js';
+import { getProjectRoot } from '../lib/paths.js';
+import { loadCritique } from '../lib/critique-engine.js';
+import { renderCritiqueMarkdown, renderCritiqueText } from '../lib/critique-render.js';
+
+export async function run(argv = process.argv.slice(2)) {
+  const { flags } = parseArgs(argv, {
+    flags: {
+      project: { type: 'string', default: 'star-freight' },
+      run: { type: 'string' },
+      json: { type: 'boolean' },
+      md: { type: 'boolean' },
+    },
+    deprecated: { game: 'project' },
+  });
+
+  if (!flags.run) {
+    console.log('Usage: sdlab critique show --run <id> [--project <name>]');
+    console.log('');
+    console.log('Options:');
+    console.log('  --run <id>        Run ID (required)');
+    console.log('  --json            Output raw JSON');
+    console.log('  --md              Output full Markdown');
+    return;
+  }
+
+  const projectName = flags.project;
+  const projectRoot = getProjectRoot(projectName);
+
+  const report = loadCritique(projectRoot, flags.run);
+
+  if (flags.json) {
+    console.log(JSON.stringify(report, null, 2));
+  } else if (flags.md) {
+    console.log(renderCritiqueMarkdown(report));
+  } else {
+    console.log(renderCritiqueText(report));
+  }
+}

package/scripts/critique.js

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+
+/**
+ * critique.js — Generate a critique report for a completed run.
+ *
+ * Usage:
+ *   sdlab critique --project star-freight --run run_2026-04-15_001
+ *   sdlab critique --project star-freight --run run_2026-04-15_001 --json
+ */
+
+import { parseArgs } from '../lib/args.js';
+import { getProjectRoot } from '../lib/paths.js';
+import { critiqueRun, saveCritique } from '../lib/critique-engine.js';
+import { renderCritiqueMarkdown, renderCritiqueText } from '../lib/critique-render.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' },
+      json: { type: 'boolean' },
+    },
+    deprecated: { game: 'project' },
+  });
+
+  if (!flags.run) {
+    console.log('Usage: sdlab critique --run <id> [--project <name>]');
+    console.log('');
+    console.log('Options:');
+    console.log('  --run <id>        Run to critique (required)');
+    console.log('  --json            Output raw JSON');
+    return;
+  }
+
+  const projectName = flags.project;
+  const projectRoot = getProjectRoot(projectName);
+
+  console.log(`\x1b[1mstyle-dataset-lab\x1b[0m critique`);
+  console.log(`  Project: ${projectName}`);
+  console.log(`  Run: ${flags.run}`);
+  console.log('');
+
+  // Generate critique
+  const report = await critiqueRun({
+    projectRoot,
+    projectId: projectName,
+    runId: flags.run,
+  });
+
+  // Save
+  const md = renderCritiqueMarkdown(report);
+  await saveCritique(projectRoot, flags.run, report, md);
+
+  if (flags.json) {
+    console.log(JSON.stringify(report, null, 2));
+  } else {
+    console.log(renderCritiqueText(report));
+    const action = report.recommended_action;
+    console.log(`Critique saved to: runs/${flags.run}/critique.json`);
+
+    if (action.mode === 'refine_from_one' && action.preferred_candidate) {
+      console.log('');
+      info(`Next: sdlab refine --run ${flags.run} --pick ${action.preferred_candidate}`);
+    } else if (action.mode === 'accept_one' && action.preferred_candidate) {
+      console.log('');
+      info(`Preferred candidate: ${action.preferred_candidate}`);
+    }
+  }
+}