@mcptoolshop/style-dataset-lab 2.3.0 → 3.0.0

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"
+  }
+}

package/templates/domains/character-design/workflows/profiles/expression-sheet.json

@@ -0,0 +1,59 @@
+{
+  "workflow_id": "expression-sheet",
+  "label": "Expression Sheet",
+  "description": "Produce multiple expressions while preserving subject identity.",
+  "lane_id": "expression_sheet",
+  "subject_mode": "required",
+  "output_mode": "expression_sheet",
+  "output_count": 6,
+  "required_reference_roles": ["anchor"],
+  "preferred_reference_tags": ["expression", "approved"],
+  "prompt_strategy": {
+    "style_prefix": [
+      "character expression sheet",
+      "consistent identity across expressions",
+      "head and shoulders framing"
+    ],
+    "structure": "style_prefix, subject_identity, canon_focus, controlled_variation",
+    "must_include": [
+      "subject identity",
+      "facial expression variety",
+      "consistent costume"
+    ],
+    "optional_blocks": [
+      "emotion label"
+    ]
+  },
+  "negative_strategy": {
+    "must_avoid": [
+      "face structure drift",
+      "hairstyle drift",
+      "costume mutation",
+      "age drift"
+    ],
+    "lane_specific_avoid": [
+      "full body composition"
+    ],
+    "subject_specific_avoid": []
+  },
+  "canon_focus": [
+    "anatomy",
+    "gesture",
+    "costume_logic",
+    "palette"
+  ],
+  "drift_guards": [
+    "face structure must remain identical",
+    "hairstyle must not change",
+    "costume must not mutate"
+  ],
+  "runtime_defaults": {
+    "adapter_target": "comfyui",
+    "width": 1024,
+    "height": 1024,
+    "steps": 30,
+    "cfg": 6.5,
+    "sampler": "dpmpp_2m",
+    "seed_mode": "increment"
+  }
+}

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

@@ -0,0 +1,61 @@
+{
+  "workflow_id": "creature-portrait-set",
+  "label": "Creature Portrait Set",
+  "description": "Generate creature concept candidates exploring anatomy and silhouette.",
+  "lane_id": "concept",
+  "subject_mode": "required",
+  "output_mode": "portrait_set",
+  "output_count": 4,
+  "required_reference_roles": ["anchor"],
+  "preferred_reference_tags": ["concept", "approved"],
+  "prompt_strategy": {
+    "style_prefix": [
+      "creature concept art",
+      "strong anatomical read",
+      "distinctive silhouette"
+    ],
+    "structure": "style_prefix, subject_identity, lane_goal, canon_focus, controlled_variation",
+    "must_include": [
+      "species identity",
+      "anatomy logic",
+      "silhouette clarity"
+    ],
+    "optional_blocks": [
+      "scale reference note",
+      "locomotion note"
+    ]
+  },
+  "negative_strategy": {
+    "must_avoid": [
+      "human anatomy default",
+      "generic dragon",
+      "over-ornamentation",
+      "anatomical impossibility"
+    ],
+    "lane_specific_avoid": [
+      "environment focus",
+      "multiple creatures"
+    ],
+    "subject_specific_avoid": []
+  },
+  "canon_focus": [
+    "anatomy",
+    "silhouette",
+    "material_language",
+    "palette"
+  ],
+  "drift_guards": [
+    "preserve species anatomy",
+    "preserve silhouette proportions",
+    "preserve surface material language"
+  ],
+  "runtime_defaults": {
+    "adapter_target": "comfyui",
+    "width": 1024,
+    "height": 1024,
+    "steps": 30,
+    "cfg": 6.5,
+    "sampler": "dpmpp_2m",
+    "seed_mode": "increment"
+  }
+}

package/templates/domains/creature-design/workflows/profiles/silhouette-exploration.json

@@ -0,0 +1,58 @@
+{
+  "workflow_id": "silhouette-exploration",
+  "label": "Silhouette Exploration",
+  "description": "Explore silhouette variations for a creature design.",
+  "lane_id": "concept",
+  "subject_mode": "optional",
+  "output_mode": "silhouette_sheet",
+  "output_count": 8,
+  "required_reference_roles": [],
+  "preferred_reference_tags": ["silhouette", "concept"],
+  "prompt_strategy": {
+    "style_prefix": [
+      "creature silhouette exploration",
+      "high contrast shape language",
+      "varied proportions and mass distribution"
+    ],
+    "structure": "style_prefix, lane_goal, canon_focus, controlled_variation",
+    "must_include": [
+      "silhouette variety",
+      "readable shape at small scale",
+      "consistent design family"
+    ],
+    "optional_blocks": [
+      "size class note",
+      "locomotion type note"
+    ]
+  },
+  "negative_strategy": {
+    "must_avoid": [
+      "uniform silhouettes",
+      "human proportions",
+      "over-detailed rendering"
+    ],
+    "lane_specific_avoid": [
+      "color distraction",
+      "background complexity"
+    ],
+    "subject_specific_avoid": []
+  },
+  "canon_focus": [
+    "silhouette",
+    "anatomy",
+    "scale_logic"
+  ],
+  "drift_guards": [
+    "shapes must remain readable at thumbnail scale",
+    "design family cohesion across variants"
+  ],
+  "runtime_defaults": {
+    "adapter_target": "comfyui",
+    "width": 1024,
+    "height": 1024,
+    "steps": 30,
+    "cfg": 6.5,
+    "sampler": "dpmpp_2m",
+    "seed_mode": "random"
+  }
+}

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

@@ -0,0 +1,62 @@
+{
+  "workflow_id": "character-portrait-set",
+  "label": "Character Portrait Set",
+  "description": "Generate a focused portrait candidate pack for a named character.",
+  "lane_id": "character",
+  "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",
+      "clean readable silhouette",
+      "consistent identity"
+    ],
+    "structure": "style_prefix, subject_identity, lane_goal, canon_focus, controlled_variation",
+    "must_include": [
+      "subject identity",
+      "costume logic",
+      "palette fidelity"
+    ],
+    "optional_blocks": [
+      "lighting note",
+      "gesture note"
+    ]
+  },
+  "negative_strategy": {
+    "must_avoid": [
+      "off-model face",
+      "extra accessories",
+      "ornamental drift",
+      "generic fantasy styling"
+    ],
+    "lane_specific_avoid": [
+      "cropped silhouette",
+      "muddy facial read"
+    ],
+    "subject_specific_avoid": []
+  },
+  "canon_focus": [
+    "silhouette",
+    "costume_logic",
+    "palette",
+    "faction_read",
+    "gesture"
+  ],
+  "drift_guards": [
+    "preserve face structure",
+    "preserve canonical materials",
+    "do not add non-canon ornament"
+  ],
+  "runtime_defaults": {
+    "adapter_target": "comfyui",
+    "width": 1024,
+    "height": 1024,
+    "steps": 30,
+    "cfg": 6.5,
+    "sampler": "dpmpp_2m",
+    "seed_mode": "increment"
+  }
+}

package/templates/domains/game-art/workflows/profiles/environment-moodboard.json

@@ -0,0 +1,61 @@
+{
+  "workflow_id": "environment-moodboard",
+  "label": "Environment Moodboard",
+  "description": "Explore environment palette, lighting, and spatial mood.",
+  "lane_id": "environment",
+  "subject_mode": "optional",
+  "output_mode": "moodboard",
+  "output_count": 6,
+  "required_reference_roles": [],
+  "preferred_reference_tags": ["environment", "approved"],
+  "prompt_strategy": {
+    "style_prefix": [
+      "environment concept art moodboard",
+      "painterly atmospheric rendering",
+      "strong spatial depth"
+    ],
+    "structure": "style_prefix, lane_goal, canon_focus, controlled_variation",
+    "must_include": [
+      "spatial composition",
+      "palette adherence",
+      "lighting mood"
+    ],
+    "optional_blocks": [
+      "time of day note",
+      "weather note"
+    ]
+  },
+  "negative_strategy": {
+    "must_avoid": [
+      "random architecture style shifts",
+      "off-era props",
+      "wrong lighting mood",
+      "clean sterile surfaces"
+    ],
+    "lane_specific_avoid": [
+      "character focus competing with environment"
+    ],
+    "subject_specific_avoid": []
+  },
+  "canon_focus": [
+    "palette",
+    "material_language",
+    "lighting",
+    "scale_logic",
+    "era_logic"
+  ],
+  "drift_guards": [
+    "palette must stay within project range",
+    "architecture style must match era logic",
+    "no modern or off-era props"
+  ],
+  "runtime_defaults": {
+    "adapter_target": "comfyui",
+    "width": 1024,
+    "height": 1024,
+    "steps": 30,
+    "cfg": 6.5,
+    "sampler": "dpmpp_2m",
+    "seed_mode": "random"
+  }
+}

package/templates/domains/vehicle-mech/workflows/profiles/variant-pack.json

@@ -0,0 +1,60 @@
+{
+  "workflow_id": "variant-pack",
+  "label": "Vehicle Variant Pack",
+  "description": "Generate controlled design variants for a named vehicle subject.",
+  "lane_id": "exterior",
+  "subject_mode": "required",
+  "output_mode": "variant_pack",
+  "output_count": 4,
+  "required_reference_roles": ["anchor"],
+  "preferred_reference_tags": ["exterior", "approved"],
+  "prompt_strategy": {
+    "style_prefix": [
+      "vehicle design variant concept art",
+      "consistent form language",
+      "controlled variation"
+    ],
+    "structure": "style_prefix, subject_identity, lane_goal, canon_focus, controlled_variation",
+    "must_include": [
+      "vehicle identity",
+      "form language continuity",
+      "material palette"
+    ],
+    "optional_blocks": [
+      "color scheme note",
+      "loadout variant note"
+    ]
+  },
+  "negative_strategy": {
+    "must_avoid": [
+      "silhouette drift from reference",
+      "wrong faction materials",
+      "scale inconsistency"
+    ],
+    "lane_specific_avoid": [
+      "interior focus"
+    ],
+    "subject_specific_avoid": []
+  },
+  "canon_focus": [
+    "silhouette",
+    "material_language",
+    "palette",
+    "faction_read",
+    "scale_logic"
+  ],
+  "drift_guards": [
+    "preserve core silhouette from reference",
+    "preserve faction material language",
+    "preserve scale relationship"
+  ],
+  "runtime_defaults": {
+    "adapter_target": "comfyui",
+    "width": 1024,
+    "height": 1024,
+    "steps": 30,
+    "cfg": 6.5,
+    "sampler": "dpmpp_2m",
+    "seed_mode": "increment"
+  }
+}