@mcptoolshop/style-dataset-lab 1.2.1 → 2.0.0

package/lib/config.js

@@ -0,0 +1,104 @@
+/**
+ * Per-project config loader.
+ *
+ * Loads JSON config files from a project root directory.
+ * Falls back to sensible defaults when files don't exist,
+ * so unmigrated projects (pre-v2.0) still work.
+ */
+
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+
+function loadJsonFile(filePath) {
+  if (!existsSync(filePath)) return null;
+  try {
+    return JSON.parse(readFileSync(filePath, 'utf-8'));
+  } catch (err) {
+    throw new Error(`Failed to parse ${filePath}: ${err.message}`);
+  }
+}
+
+/**
+ * Load project.json — project identity and generation defaults.
+ */
+export function loadProjectMeta(projectRoot) {
+  const data = loadJsonFile(join(projectRoot, 'project.json'));
+  if (!data) {
+    return {
+      name: 'unknown',
+      display_name: 'Unknown Project',
+      domain: 'generic',
+      version: '0.0.0',
+      defaults: {},
+    };
+  }
+  return data;
+}
+
+/**
+ * Load constitution.json — array of rule objects.
+ */
+export function loadConstitution(projectRoot) {
+  const data = loadJsonFile(join(projectRoot, 'constitution.json'));
+  if (!data) return { rules: [] };
+  if (Array.isArray(data)) return { rules: data };
+  if (!data.rules) throw new Error(`constitution.json must have a "rules" array`);
+  return data;
+}
+
+/**
+ * Load lanes.json — lane definitions with detection patterns.
+ */
+export function loadLanes(projectRoot) {
+  const data = loadJsonFile(join(projectRoot, 'lanes.json'));
+  if (!data) {
+    return { default_lane: 'default', lanes: [] };
+  }
+  if (!data.lanes) throw new Error(`lanes.json must have a "lanes" array`);
+  return data;
+}
+
+/**
+ * Load rubric.json — scoring dimensions, thresholds, failure modes.
+ */
+export function loadRubric(projectRoot) {
+  const data = loadJsonFile(join(projectRoot, 'rubric.json'));
+  if (!data) {
+    return {
+      dimensions: [],
+      thresholds: { pass: 0.7, partial: 0.5, fail_ceiling: 0.4 },
+      failure_to_rules: {},
+    };
+  }
+  return data;
+}
+
+/**
+ * Load terminology.json — group vocabulary and detection patterns.
+ */
+export function loadTerminology(projectRoot) {
+  const data = loadJsonFile(join(projectRoot, 'terminology.json'));
+  if (!data) {
+    return {
+      group_label: 'group',
+      groups: {},
+      cross_group_patterns: {},
+      edge_defaults: {},
+      prompt_fallbacks: {},
+    };
+  }
+  return data;
+}
+
+/**
+ * Load all project config files at once.
+ */
+export function loadProjectConfig(projectRoot) {
+  return {
+    meta: loadProjectMeta(projectRoot),
+    constitution: loadConstitution(projectRoot),
+    lanes: loadLanes(projectRoot),
+    rubric: loadRubric(projectRoot),
+    terminology: loadTerminology(projectRoot),
+  };
+}

package/lib/deprecation.js

@@ -0,0 +1,14 @@
+/**
+ * Deprecation warning helper — fires once per flag per process.
+ */
+
+const warned = new Set();
+
+export function warnDeprecated(oldFlag, newFlag) {
+  const key = `${oldFlag}→${newFlag}`;
+  if (warned.has(key)) return;
+  warned.add(key);
+  process.stderr.write(
+    `\x1b[33m⚠ --${oldFlag} is deprecated and will be removed in v3.0. Use --${newFlag} instead.\x1b[0m\n`
+  );
+}

package/lib/paths.js

@@ -0,0 +1,38 @@
+/**
+ * Path resolution — single source of truth for repo root and project paths.
+ */
+
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { existsSync } from 'node:fs';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+/** Absolute path to the repository root. */
+export const REPO_ROOT = join(__dirname, '..');
+
+/**
+ * Resolve the root directory for a named project.
+ * @param {string} name — project name (e.g. 'star-freight')
+ * @returns {string} absolute path to projects/<name>/
+ */
+export function getProjectRoot(name) {
+  const root = join(REPO_ROOT, 'projects', name);
+  if (!existsSync(root)) {
+    throw new Error(
+      `Project "${name}" not found at ${root}.\n` +
+      `Run: sdlab init ${name} --domain <domain>`
+    );
+  }
+  return root;
+}
+
+/**
+ * Join segments onto a project root.
+ * @param {string} name — project name
+ * @param {...string} segments — path segments
+ */
+export function resolveProjectPath(name, ...segments) {
+  return join(getProjectRoot(name), ...segments);
+}

package/lib/records.js

@@ -0,0 +1,69 @@
+/**
+ * Record builder and I/O utilities.
+ *
+ * Standardizes the JSON record format used across all scripts.
+ */
+
+import { readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+
+/**
+ * Build a base provenance record (generated by txt2img scripts).
+ */
+export function buildBaseRecord(id, assetPath, imageData, provenance) {
+  return {
+    id,
+    schema_version: '2.0.0',
+    created_at: new Date().toISOString(),
+    asset_path: assetPath,
+    image: {
+      format: 'png',
+      width: imageData.width || 1024,
+      height: imageData.height || 1024,
+      bytes: imageData.bytes || 0,
+    },
+    provenance,
+    judgment: null,
+    canon: null,
+    iteration: null,
+  };
+}
+
+/**
+ * Build an identity record (extends base with identity + lineage blocks).
+ */
+export function buildIdentityRecord(baseRecord, identity, lineage) {
+  return {
+    ...baseRecord,
+    identity,
+    lineage,
+  };
+}
+
+/**
+ * Load a record by asset ID from a records directory.
+ * @param {string} recordsDir — absolute path to records/
+ * @param {string} assetId — record filename (without .json)
+ * @returns {Promise<Object|null>}
+ */
+export async function loadRecord(recordsDir, assetId) {
+  const path = join(recordsDir, `${assetId}.json`);
+  try {
+    const raw = await readFile(path, 'utf-8');
+    return JSON.parse(raw);
+  } catch (err) {
+    if (err.code === 'ENOENT') return null;
+    throw new Error(`Failed to load record ${assetId}: ${err.message}`);
+  }
+}
+
+/**
+ * Save a record to disk.
+ * @param {string} recordsDir — absolute path to records/
+ * @param {string} assetId — record filename (without .json)
+ * @param {Object} record — the record object
+ */
+export async function saveRecord(recordsDir, assetId, record) {
+  const path = join(recordsDir, `${assetId}.json`);
+  await writeFile(path, JSON.stringify(record, null, 2) + '\n');
+}

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "@mcptoolshop/style-dataset-lab",
-  "version": "1.2.1",
-  "description": "Visual dataset pipeline — canon to prompts to ComfyUI generation to curated, canon-bound training data",
+  "version": "2.0.0",
+  "description": "Canon-bound visual dataset pipeline — define project canon, generate and curate assets, bind to constitution rules, export trustworthy training data",
   "type": "module",
+  "bin": {
+    "sdlab": "./bin/sdlab.js"
+  },
   "scripts": {
     "generate": "node scripts/generate.js",
     "curate": "node scripts/curate.js",
@@ -10,10 +13,12 @@
     "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 ./games/<game> --format trl'",
-    "inspect": "echo 'Usage: repo-dataset visual inspect ./games/<game>'"
+    "export": "echo 'Usage: repo-dataset visual generate ./projects/<project> --format trl'",
+    "inspect": "echo 'Usage: repo-dataset visual inspect ./projects/<project>'"
   },
   "files": [
+    "bin/",
+    "lib/",
     "scripts/",
     "templates/",
     "README.md",
@@ -25,6 +30,10 @@
     "dataset",
     "visual",
     "training-data",
+    "concept-art",
+    "visual-canon",
+    "art-direction",
+    "dataset-pipeline",
     "comfyui",
     "vlm",
     "fine-tuning",

package/scripts/bulk-curate-wave2-5.js

@@ -11,7 +11,7 @@ import { join } from "node:path";
 
 const REPO_ROOT = new URL("..", import.meta.url).pathname.replace(/^\/([A-Z]:)/, "$1");
 const GAME = process.argv.find((a, i) => process.argv[i - 1] === '--game') || 'star-freight';
-const GAME_ROOT = join(REPO_ROOT, 'games', GAME);
+const GAME_ROOT = join(REPO_ROOT, 'projects', GAME);
 
 const DEFAULT_APPROVED_SCORES = {
   silhouette_clarity: 0.8, palette_adherence: 0.8, material_fidelity: 0.8,

package/scripts/bulk-curate-waves11-18.js

@@ -17,7 +17,7 @@ import { join, basename } from 'path';
 
 const REPO_ROOT = new URL("..", import.meta.url).pathname.replace(/^\/([A-Z]:)/, "$1");
 const GAME = process.argv.find((a, i) => process.argv[i - 1] === '--game') || 'star-freight';
-const GAME_ROOT = join(REPO_ROOT, 'games', GAME);
+const GAME_ROOT = join(REPO_ROOT, 'projects', GAME);
 
 const RECORDS_DIR = join(GAME_ROOT, 'records');
 const CANDIDATES_DIR = join(GAME_ROOT, 'outputs', 'candidates');