@mcptoolshop/style-dataset-lab 2.2.1 → 3.0.0

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/snapshot.js

@@ -32,39 +32,43 @@ export async function run(argv = process.argv.slice(2)) {
     const profileIdx = args.indexOf('--profile');
     const profileId = profileIdx >= 0 ? args[profileIdx + 1] : null;
     const profile = loadSelectionProfile(projectRoot, profileId);
+    const dryRun = argv.includes('--dry-run');
 
     console.log(`\x1b[1msdlab snapshot create\x1b[0m — ${projectName}`);
     console.log(`  Profile: ${profileId || 'training-default (built-in)'}`);
+    if (dryRun) console.log('  Mode: DRY RUN (no files written)');
     console.log('');
 
-    const result = await createSnapshot(projectRoot, profile);
+    const result = await createSnapshot(projectRoot, profile, { dryRun });
 
     console.log(`  \x1b[32m✓\x1b[0m Snapshot: ${result.snapshotId}`);
     console.log(`  Included: ${result.included}`);
     console.log(`  Excluded: ${result.excluded}`);
 
-    // Read and display summary
-    const summary = JSON.parse(
-      await readFile(join(projectRoot, 'snapshots', result.snapshotId, 'summary.json'), 'utf-8')
-    );
-    console.log('\n  Lane distribution:');
-    for (const [lane, count] of Object.entries(summary.lane_distribution).sort((a, b) => b[1] - a[1])) {
-      console.log(`    ${lane}: ${count}`);
-    }
-    console.log('\n  Faction distribution:');
-    for (const [f, c] of Object.entries(summary.faction_distribution).sort((a, b) => b[1] - a[1])) {
-      console.log(`    ${f}: ${c}`);
-    }
-
-    // Read and categorize exclusions
-    const excludedRaw = await readFile(
-      join(projectRoot, 'snapshots', result.snapshotId, 'excluded.jsonl'), 'utf-8'
-    );
-    const excluded = excludedRaw.trim().split('\n').filter(Boolean).map(l => JSON.parse(l));
-    const categories = categorizeExclusions(excluded);
-    console.log('\n  Exclusion reasons:');
-    for (const [cat, count] of Object.entries(categories)) {
-      if (count > 0) console.log(`    ${cat}: ${count}`);
+    if (!dryRun) {
+      // Read and display summary
+      const summary = JSON.parse(
+        await readFile(join(projectRoot, 'snapshots', result.snapshotId, 'summary.json'), 'utf-8')
+      );
+      console.log('\n  Lane distribution:');
+      for (const [lane, count] of Object.entries(summary.lane_distribution).sort((a, b) => b[1] - a[1])) {
+        console.log(`    ${lane}: ${count}`);
+      }
+      console.log('\n  Faction distribution:');
+      for (const [f, c] of Object.entries(summary.faction_distribution).sort((a, b) => b[1] - a[1])) {
+        console.log(`    ${f}: ${c}`);
+      }
+
+      // Read and categorize exclusions
+      const excludedRaw = await readFile(
+        join(projectRoot, 'snapshots', result.snapshotId, 'excluded.jsonl'), 'utf-8'
+      );
+      const excluded = excludedRaw.trim().split('\n').filter(Boolean).map(l => JSON.parse(l));
+      const categories = categorizeExclusions(excluded);
+      console.log('\n  Exclusion reasons:');
+      for (const [cat, count] of Object.entries(categories)) {
+        if (count > 0) console.log(`    ${cat}: ${count}`);
+      }
     }
 
   } else if (subcommand === 'list') {

package/scripts/split.js

@@ -42,6 +42,7 @@ export async function run(argv = process.argv.slice(2)) {
     const profileIdx = args.indexOf('--profile');
     const profileId = profileIdx >= 0 ? args[profileIdx + 1] : null;
     const profile = loadSplitProfile(projectRoot, profileId);
+    const dryRun = argv.includes('--dry-run');
 
     console.log(`\x1b[1msdlab split build\x1b[0m — ${projectName}`);
     console.log(`  Snapshot: ${snapshotId}`);
@@ -49,9 +50,10 @@ export async function run(argv = process.argv.slice(2)) {
     console.log(`  Strategy: ${profile.strategy}`);
     console.log(`  Ratios:   ${profile.train_ratio}/${profile.val_ratio}/${profile.test_ratio}`);
     console.log(`  Seed:     ${profile.seed}`);
+    if (dryRun) console.log('  Mode:     DRY RUN (no files written)');
     console.log('');
 
-    const result = await createSplit(projectRoot, snapshotId, profile);
+    const result = await createSplit(projectRoot, snapshotId, profile, { dryRun });
 
     console.log(`  \x1b[32m✓\x1b[0m Split: ${result.splitId}`);
     console.log(`  Train: ${result.train}`);

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); });
+}

package/scripts/workflow-show.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+
+/**
+ * workflow-show.js — Show details of a workflow profile.
+ *
+ * Usage:
+ *   sdlab workflow show character-portrait-set --project star-freight
+ *   sdlab workflow show character-portrait-set --json
+ */
+
+import { parseArgs } from '../lib/args.js';
+import { getProjectRoot } from '../lib/paths.js';
+import { getWorkflowProfile } from '../lib/workflow-profiles.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' },
+    },
+    positionals: ['workflowId'],
+    deprecated: { game: 'project' },
+  });
+
+  const workflowId = positionals[0];
+  if (!workflowId) {
+    console.log('Usage: sdlab workflow show <workflow-id> [--project <name>]');
+    return;
+  }
+
+  const projectRoot = getProjectRoot(flags.project);
+  const profile = await getWorkflowProfile(projectRoot, workflowId);
+
+  if (flags.json) {
+    console.log(JSON.stringify(profile, null, 2));
+    return;
+  }
+
+  console.log(`\x1b[1msdlab workflow show\x1b[0m — ${workflowId}\n`);
+  console.log(`  Label:        ${profile.label}`);
+  if (profile.description) {
+    console.log(`  Description:  ${profile.description}`);
+  }
+  console.log(`  Lane:         ${profile.lane_id}`);
+  console.log(`  Subject:      ${profile.subject_mode || 'optional'}`);
+  console.log(`  Output mode:  ${profile.output_mode}`);
+  console.log(`  Output count: ${profile.output_count}`);
+  console.log('');
+
+  console.log('  \x1b[1mPrompt strategy:\x1b[0m');
+  console.log(`    Style prefix:  ${profile.prompt_strategy.style_prefix.join(', ')}`);
+  console.log(`    Structure:     ${profile.prompt_strategy.structure}`);
+  console.log(`    Must include:  ${profile.prompt_strategy.must_include.join(', ')}`);
+  if (profile.prompt_strategy.optional_blocks?.length > 0) {
+    console.log(`    Optional:      ${profile.prompt_strategy.optional_blocks.join(', ')}`);
+  }
+  console.log('');
+
+  console.log('  \x1b[1mNegative strategy:\x1b[0m');
+  console.log(`    Must avoid:    ${profile.negative_strategy.must_avoid.join(', ')}`);
+  if (profile.negative_strategy.lane_specific_avoid?.length > 0) {
+    console.log(`    Lane avoid:    ${profile.negative_strategy.lane_specific_avoid.join(', ')}`);
+  }
+  console.log('');
+
+  console.log('  \x1b[1mCanon focus:\x1b[0m');
+  console.log(`    ${profile.canon_focus.join(', ')}`);
+  console.log('');
+
+  console.log('  \x1b[1mDrift guards:\x1b[0m');
+  for (const guard of profile.drift_guards) {
+    console.log(`    ⚠ ${guard}`);
+  }
+  console.log('');
+
+  console.log('  \x1b[1mRuntime defaults:\x1b[0m');
+  const rd = profile.runtime_defaults;
+  console.log(`    Adapter:   ${rd.adapter_target}`);
+  if (rd.width) console.log(`    Size:      ${rd.width}×${rd.height || rd.width}`);
+  if (rd.steps) console.log(`    Steps:     ${rd.steps}`);
+  if (rd.cfg) console.log(`    CFG:       ${rd.cfg}`);
+  if (rd.sampler) console.log(`    Sampler:   ${rd.sampler}`);
+  if (rd.seed_mode) console.log(`    Seed mode: ${rd.seed_mode}`);
+
+  if (profile.required_reference_roles?.length > 0) {
+    console.log('');
+    console.log(`  \x1b[1mRequired references:\x1b[0m ${profile.required_reference_roles.join(', ')}`);
+  }
+  if (profile.preferred_reference_tags?.length > 0) {
+    console.log(`  \x1b[1mPreferred tags:\x1b[0m ${profile.preferred_reference_tags.join(', ')}`);
+  }
+}
+
+if (process.argv[1] && (process.argv[1].endsWith('workflow-show.js') || process.argv[1].endsWith('workflow-show'))) {
+  run().catch((err) => { console.error(err.message || err); process.exit(1); });
+}

package/templates/domains/architecture/workflows/profiles/environment-moodboard.json

@@ -0,0 +1,62 @@
+{
+  "workflow_id": "environment-moodboard",
+  "label": "Environment Moodboard",
+  "description": "Explore architectural mood, palette, and spatial atmosphere.",
+  "lane_id": "exterior",
+  "subject_mode": "optional",
+  "output_mode": "moodboard",
+  "output_count": 6,
+  "required_reference_roles": [],
+  "preferred_reference_tags": ["exterior", "approved"],
+  "prompt_strategy": {
+    "style_prefix": [
+      "architectural concept art moodboard",
+      "strong spatial atmosphere",
+      "painterly rendering"
+    ],
+    "structure": "style_prefix, lane_goal, canon_focus, controlled_variation",
+    "must_include": [
+      "spatial composition",
+      "material palette",
+      "lighting atmosphere"
+    ],
+    "optional_blocks": [
+      "time of day note",
+      "weather note",
+      "era note"
+    ]
+  },
+  "negative_strategy": {
+    "must_avoid": [
+      "anachronistic elements",
+      "wrong architectural era",
+      "clean sterile surfaces",
+      "modern materials in historical context"
+    ],
+    "lane_specific_avoid": [
+      "character focus"
+    ],
+    "subject_specific_avoid": []
+  },
+  "canon_focus": [
+    "palette",
+    "material_language",
+    "lighting",
+    "scale_logic",
+    "era_logic"
+  ],
+  "drift_guards": [
+    "architectural era must remain consistent",
+    "material palette must match project canon",
+    "scale must read correctly"
+  ],
+  "runtime_defaults": {
+    "adapter_target": "comfyui",
+    "width": 1024,
+    "height": 1024,
+    "steps": 30,
+    "cfg": 6.5,
+    "sampler": "dpmpp_2m",
+    "seed_mode": "random"
+  }
+}

package/templates/domains/architecture/workflows/profiles/interior-variant-pack.json

@@ -0,0 +1,60 @@
+{
+  "workflow_id": "interior-variant-pack",
+  "label": "Interior Variant Pack",
+  "description": "Generate interior space variations exploring layout, mood, and materials.",
+  "lane_id": "interior",
+  "subject_mode": "optional",
+  "output_mode": "variant_pack",
+  "output_count": 4,
+  "required_reference_roles": [],
+  "preferred_reference_tags": ["interior", "approved"],
+  "prompt_strategy": {
+    "style_prefix": [
+      "interior space concept art",
+      "atmospheric spatial rendering",
+      "functional layout emphasis"
+    ],
+    "structure": "style_prefix, lane_goal, canon_focus, controlled_variation",
+    "must_include": [
+      "spatial function",
+      "material palette",
+      "lighting mood"
+    ],
+    "optional_blocks": [
+      "furniture note",
+      "activity note"
+    ]
+  },
+  "negative_strategy": {
+    "must_avoid": [
+      "empty featureless rooms",
+      "modern furniture in period setting",
+      "over-cluttered composition"
+    ],
+    "lane_specific_avoid": [
+      "exterior views dominating"
+    ],
+    "subject_specific_avoid": []
+  },
+  "canon_focus": [
+    "material_language",
+    "lighting",
+    "composition",
+    "era_logic",
+    "surface_wear"
+  ],
+  "drift_guards": [
+    "materials must match architectural era",
+    "lighting must serve spatial mood",
+    "wear must read authentically"
+  ],
+  "runtime_defaults": {
+    "adapter_target": "comfyui",
+    "width": 1024,
+    "height": 1024,
+    "steps": 30,
+    "cfg": 6.5,
+    "sampler": "dpmpp_2m",
+    "seed_mode": "random"
+  }
+}

package/templates/domains/character-design/workflows/profiles/character-portrait-set.json

@@ -0,0 +1,61 @@
+{
+  "workflow_id": "character-portrait-set",
+  "label": "Character Portrait Set",
+  "description": "Generate portrait candidates for a named character.",
+  "lane_id": "portrait",
+  "subject_mode": "required",
+  "output_mode": "portrait_set",
+  "output_count": 4,
+  "required_reference_roles": ["anchor"],
+  "preferred_reference_tags": ["portrait", "approved"],
+  "prompt_strategy": {
+    "style_prefix": [
+      "character portrait concept art",
+      "high fidelity facial detail",
+      "clean readable silhouette"
+    ],
+    "structure": "style_prefix, subject_identity, lane_goal, canon_focus, controlled_variation",
+    "must_include": [
+      "subject identity",
+      "costume logic",
+      "facial detail"
+    ],
+    "optional_blocks": [
+      "lighting note",
+      "expression note"
+    ]
+  },
+  "negative_strategy": {
+    "must_avoid": [
+      "off-model face",
+      "extra accessories",
+      "ornamental drift"
+    ],
+    "lane_specific_avoid": [
+      "full body composition",
+      "background complexity"
+    ],
+    "subject_specific_avoid": []
+  },
+  "canon_focus": [
+    "silhouette",
+    "costume_logic",
+    "palette",
+    "anatomy",
+    "gesture"
+  ],
+  "drift_guards": [
+    "preserve face structure",
+    "preserve age read",
+    "preserve canonical materials"
+  ],
+  "runtime_defaults": {
+    "adapter_target": "comfyui",
+    "width": 1024,
+    "height": 1024,
+    "steps": 30,
+    "cfg": 6.5,
+    "sampler": "dpmpp_2m",
+    "seed_mode": "increment"
+  }
+}