@traits-dev/cli 0.5.0 → 0.6.0

package/README.md

@@ -15,7 +15,7 @@ traits init --template resolve profiles/resolve.yaml
 traits validate profiles/resolve.yaml
 traits validate profiles/resolve.yaml --format sarif
 traits compile profiles/resolve.yaml --model gpt-4o
-traits migrate profiles/legacy-v1-4.yaml
+traits migrate profiles/legacy-v1-5.yaml --to v1.6 --normalize-extends
 traits eval profiles/resolve.yaml --tier 1
 ```
 

package/dist/traits.js

@@ -267,7 +267,7 @@ function printEvalUsage(out = process.stderr) {
       "Options:",
       "  --model <model>           Model target (required)",
       "  --tier <1|2|3>            Highest tier to run (default: highest available)",
-      "  --suite <name>            Built-in baseline suite: support|healthcare|developer",
+      "  --suite <name>            Built-in baseline suite: support|healthcare|developer|educator|advisor",
       "  --provider <name>         Judge provider for Tier 3: auto|openai|anthropic",
       "  --embedding-model <name>  Embedding model for Tier 2 (OpenAI)",
       "  --judge-model <name>      Judge model for Tier 3 provider",
@@ -402,10 +402,12 @@ function parseEvalArgs(args) {
   if (!["auto", "openai", "anthropic"].includes(result.provider)) {
     return { error: 'Invalid "--provider" value. Expected auto, openai, or anthropic.' };
   }
-  if (result.suite != null && !["support", "healthcare", "developer"].includes(
+  if (result.suite != null && !["support", "healthcare", "developer", "educator", "advisor"].includes(
     result.suite
   )) {
-    return { error: 'Invalid "--suite" value. Expected support, healthcare, or developer.' };
+    return {
+      error: 'Invalid "--suite" value. Expected support, healthcare, developer, educator, or advisor.'
+    };
   }
   if (result.suite != null && result.samplesPath != null) {
     return { error: 'Use either "--suite" or "--samples/--scenarios", not both.' };
@@ -443,7 +445,7 @@ function loadSamples(options, cwd) {
     const suite = loadBuiltInEvalSuite(options.suite);
     if (!suite) {
       throw new Error(
-        `Unknown suite "${options.suite}". Expected support, healthcare, or developer.`
+        `Unknown suite "${options.suite}". Expected support, healthcare, developer, educator, or advisor.`
       );
     }
     return suite.scenarios.map((scenario) => ({
@@ -1451,6 +1453,11 @@ import fs4 from "fs";
 import path5 from "path";
 import { loadProfileFile, validateResolvedProfile as validateResolvedProfile2 } from "@traits-dev/core";
 import { renderImportedProfileYAML, toValidationResultObject as toValidationResultObject4 } from "@traits-dev/core/internal";
+var SCHEMA_ORDER = {
+  "v1.4": 0,
+  "v1.5": 1,
+  "v1.6": 2
+};
 function printMigrateUsage(out = process.stderr) {
   out.write(
     [
@@ -1458,10 +1465,11 @@ function printMigrateUsage(out = process.stderr) {
       "  traits migrate <profile-path> [options]",
       "",
       "Options:",
-      "  --to <version>            Target schema version (default: v1.5)",
-      "  --output <path>           Output file path (default: <name>.v1.5.yaml)",
+      "  --to <version>            Target schema version (default: v1.6; supported: v1.5, v1.6)",
+      "  --output <path>           Output file path (default: <name>.<target>.yaml)",
       "  --in-place                Overwrite the source file (requires --force if file exists)",
       "  --force                   Overwrite existing destination file",
+      "  --normalize-extends       Convert single-string extends to array form (v1.6 target only)",
       "  --json                    Output structured JSON summary",
       "  --verbose                 Include additional command metadata",
       "  --no-color                Disable colorized output",
@@ -1472,10 +1480,11 @@ function printMigrateUsage(out = process.stderr) {
 function parseMigrateArgs(args) {
   const result = {
     profilePath: null,
-    to: "v1.5",
+    to: "v1.6",
     outputPath: null,
     inPlace: false,
     force: false,
+    normalizeExtends: false,
     json: false,
     verbose: false,
     noColor: false
@@ -1491,6 +1500,10 @@ function parseMigrateArgs(args) {
       result.force = true;
       continue;
     }
+    if (arg === "--normalize-extends") {
+      result.normalizeExtends = true;
+      continue;
+    }
     if (arg === "--json") {
       result.json = true;
       continue;
@@ -1507,12 +1520,12 @@ function parseMigrateArgs(args) {
       const value = args[index + 1];
       if (!value) return { error: `Missing value for "${arg}"` };
       if (arg === "--to") {
-        if (value !== "v1.5") {
+        if (value !== "v1.5" && value !== "v1.6") {
           return {
-            error: `Unsupported "--to" value "${value}". Currently supported: v1.5`
+            error: `Unsupported "--to" value "${value}". Currently supported: v1.5, v1.6`
           };
         }
-        result.to = "v1.5";
+        result.to = value;
       } else {
         result.outputPath = value;
       }
@@ -1531,6 +1544,9 @@ function parseMigrateArgs(args) {
   if (result.inPlace && result.outputPath) {
     return { error: 'Use either "--in-place" or "--output", not both.' };
   }
+  if (result.normalizeExtends && result.to !== "v1.6") {
+    return { error: '"--normalize-extends" requires "--to v1.6".' };
+  }
   return { value: result };
 }
 function resolveDefaultOutputPath(sourcePath, toVersion) {
@@ -1563,6 +1579,22 @@ function migrateV14ToV15(profile) {
   }
   return { migrated, capabilitiesAdded: false };
 }
+function migrateV15ToV16(profile, options) {
+  const migrated = JSON.parse(JSON.stringify(profile));
+  migrated.schema = "v1.6";
+  if (options.normalizeExtends && typeof migrated.extends === "string") {
+    const normalized = migrated.extends.trim();
+    if (normalized.length > 0) {
+      migrated.extends = [normalized];
+      return { migrated, extendsNormalized: true };
+    }
+  }
+  return { migrated, extendsNormalized: false };
+}
+function asSupportedSourceSchema(value) {
+  if (value === "v1.4" || value === "v1.5") return value;
+  return null;
+}
 function runMigrate(args, io = process) {
   const parsed = parseMigrateArgs(args);
   if ("error" in parsed) {
@@ -1602,15 +1634,58 @@ function runMigrate(args, io = process) {
     );
     return 1;
   }
-  if (loaded.schema !== "v1.4") {
+  if (loaded.schema === "v1.6") {
+    io.stderr.write(
+      'Error: Source profile is already at "v1.6". Nothing to migrate.\n'
+    );
+    return 1;
+  }
+  const sourceSchema = asSupportedSourceSchema(loaded.schema);
+  if (!sourceSchema) {
+    io.stderr.write(
+      `Error: Migration source schema must be "v1.4" or "v1.5". Found "${loaded.schema ?? "unknown"}".
+`
+    );
+    return 1;
+  }
+  if (SCHEMA_ORDER[options.to] < SCHEMA_ORDER[sourceSchema]) {
     io.stderr.write(
-      `Error: Migration source schema must be "v1.4". Found "${loaded.schema ?? "unknown"}".
+      `Error: Downgrade is not supported (source "${sourceSchema}" -> target "${options.to}").
 `
     );
     return 1;
   }
-  const migration = migrateV14ToV15(loaded);
-  const validation = validateResolvedProfile2(migration.migrated, {
+  if (SCHEMA_ORDER[options.to] === SCHEMA_ORDER[sourceSchema]) {
+    io.stderr.write(`Error: Source profile already uses target schema "${options.to}".
+`);
+    return 1;
+  }
+  let migrated = loaded;
+  let capabilitiesAdded = false;
+  let extendsNormalized = false;
+  let currentSchema = sourceSchema;
+  if (currentSchema === "v1.4") {
+    const step = migrateV14ToV15(migrated);
+    migrated = step.migrated;
+    capabilitiesAdded = step.capabilitiesAdded;
+    currentSchema = "v1.5";
+  }
+  if (options.to === "v1.6" && currentSchema === "v1.5") {
+    const step = migrateV15ToV16(migrated, {
+      normalizeExtends: options.normalizeExtends
+    });
+    migrated = step.migrated;
+    extendsNormalized = step.extendsNormalized;
+    currentSchema = "v1.6";
+  }
+  if (currentSchema !== options.to) {
+    io.stderr.write(
+      `Error: Failed to migrate profile to target schema "${options.to}". Final schema: "${currentSchema}".
+`
+    );
+    return 2;
+  }
+  const validation = validateResolvedProfile2(migrated, {
     strict: false
   });
   if (validation.errors.length > 0) {
@@ -1620,7 +1695,7 @@ function runMigrate(args, io = process) {
     );
     return 2;
   }
-  const yaml = renderImportedProfileYAML(migration.migrated);
+  const yaml = renderImportedProfileYAML(migrated);
   writeFileAtomic2(destinationPath, yaml);
   if (options.json) {
     io.stdout.write(
@@ -1629,9 +1704,10 @@ function runMigrate(args, io = process) {
           migrated: true,
           sourcePath,
           outputPath: destinationPath,
-          fromSchema: "v1.4",
-          toSchema: "v1.5",
-          capabilitiesAdded: migration.capabilitiesAdded,
+          fromSchema: sourceSchema,
+          toSchema: options.to,
+          capabilitiesAdded,
+          extendsNormalized,
           validation: toValidationResultObject4(validation)
         },
         null,
@@ -1646,13 +1722,15 @@ function runMigrate(args, io = process) {
 `);
     io.stdout.write(`Output: ${destinationPath}
 `);
-    io.stdout.write(`Capabilities added: ${migration.capabilitiesAdded ? "yes" : "no"}
+    io.stdout.write(`Capabilities added: ${capabilitiesAdded ? "yes" : "no"}
+`);
+    io.stdout.write(`Extends normalized: ${extendsNormalized ? "yes" : "no"}
 `);
     io.stdout.write(`Validation warnings: ${validation.warnings.length}
 
 `);
   }
-  io.stdout.write(`Migrated profile schema v1.4 -> v1.5
+  io.stdout.write(`Migrated profile schema ${sourceSchema} -> ${options.to}
 `);
   io.stdout.write(`Wrote: ${destinationPath}
 `);
@@ -1871,7 +1949,7 @@ function printRootUsage(out = process.stdout) {
       "  compile <profile-path>    Compile a profile for a target model",
       "  eval <profile-path>       Evaluate profile responses (Tier 1 scaffold)",
       "  import [prompt-path]      Import a profile from an existing system prompt",
-      "  migrate <profile-path>    Migrate profile schema (v1.4 -> v1.5)",
+      "  migrate <profile-path>    Migrate profile schema (up to v1.6)",
       "  validate <profile-path>   Validate a voice profile",
       "",
       "Global flags:",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@traits-dev/cli",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "traits.dev command-line interface for voice profile init, validate, compile, eval, and import workflows.",
   "keywords": [
     "traits-dev",
@@ -41,7 +41,7 @@
     "provenance": true
   },
   "dependencies": {
-    "@traits-dev/core": "^0.5.0"
+    "@traits-dev/core": "^0.6.0"
   },
   "devDependencies": {
     "@types/node": "^25.2.3",