timeback-studio 0.1.3 → 0.1.4

package/dist/bin.js

@@ -16926,10 +16926,9 @@ var playcademyParser = {
 };
 
 // ../internal/cli-infra/src/config/timeback.ts
-import { existsSync } from "node:fs";
 import { readFile as readFile2 } from "node:fs/promises";
-import { basename, relative, resolve } from "node:path";
-import { pathToFileURL } from "node:url";
+import { basename, extname, relative, resolve } from "node:path";
+import { loadConfig as c12LoadConfig } from "c12";
 // ../types/src/zod/primitives.ts
 var IsoDateTimeRegex = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/;
 var IsoDateTimeString = exports_external.string().min(1).regex(IsoDateTimeRegex, "must be a valid ISO 8601 datetime");
@@ -16945,7 +16944,7 @@ var TimebackSubject = exports_external.enum([
   "Math",
   "None",
   "Other"
-]);
+]).meta({ id: "TimebackSubject", description: "Subject area" });
 var TimebackGrade = exports_external.union([
   exports_external.literal(-1),
   exports_external.literal(0),
@@ -16962,7 +16961,10 @@ var TimebackGrade = exports_external.union([
   exports_external.literal(11),
   exports_external.literal(12),
   exports_external.literal(13)
-]);
+]).meta({
+  id: "TimebackGrade",
+  description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+});
 var ScoreStatus = exports_external.enum([
   "exempt",
   "fully graded",
@@ -17194,62 +17196,84 @@ var CaliperListEventsParams = exports_external.object({
 }).strict();
 // ../types/src/zod/config.ts
 var CourseIds = exports_external.object({
-  staging: exports_external.string().optional(),
-  production: exports_external.string().optional()
-});
-var CourseType = exports_external.enum(["base", "hole-filling", "optional"]);
-var PublishStatus = exports_external.enum(["draft", "testing", "published", "deactivated"]);
+  staging: exports_external.string().meta({ description: "Course ID in staging environment" }).optional(),
+  production: exports_external.string().meta({ description: "Course ID in production environment" }).optional()
+}).meta({ id: "CourseIds", description: "Environment-specific course IDs (populated by sync)" });
+var CourseType = exports_external.enum(["base", "hole-filling", "optional"]).meta({ id: "CourseType", description: "Course classification type" });
+var PublishStatus = exports_external.enum(["draft", "testing", "published", "deactivated"]).meta({ id: "PublishStatus", description: "Course publication status" });
 var CourseGoals = exports_external.object({
-  dailyXp: exports_external.number().int().positive().optional(),
-  dailyLessons: exports_external.number().int().positive().optional(),
-  dailyActiveMinutes: exports_external.number().int().positive().optional(),
-  dailyAccuracy: exports_external.number().int().min(0).max(100).optional(),
-  dailyMasteredUnits: exports_external.number().int().positive().optional()
-});
+  dailyXp: exports_external.number().int().positive().meta({ description: "Target XP to earn per day" }).optional(),
+  dailyLessons: exports_external.number().int().positive().meta({ description: "Target lessons to complete per day" }).optional(),
+  dailyActiveMinutes: exports_external.number().int().positive().meta({ description: "Target active learning minutes per day" }).optional(),
+  dailyAccuracy: exports_external.number().int().min(0).max(100).meta({ description: "Target accuracy percentage (0-100)" }).optional(),
+  dailyMasteredUnits: exports_external.number().int().positive().meta({ description: "Target units to master per day" }).optional()
+}).meta({ id: "CourseGoals", description: "Daily learning goals for a course" });
 var CourseMetrics = exports_external.object({
-  totalXp: exports_external.number().int().positive().optional(),
-  totalLessons: exports_external.number().int().positive().optional(),
-  totalGrades: exports_external.number().int().positive().optional()
-});
+  totalXp: exports_external.number().int().positive().meta({ description: "Total XP available in the course" }).optional(),
+  totalLessons: exports_external.number().int().positive().meta({ description: "Total number of lessons/activities" }).optional(),
+  totalGrades: exports_external.number().int().positive().meta({ description: "Total grade levels covered" }).optional()
+}).meta({ id: "CourseMetrics", description: "Aggregate metrics for a course" });
 var CourseMetadata = exports_external.object({
   courseType: CourseType.optional(),
-  isSupplemental: exports_external.boolean().optional(),
-  isCustom: exports_external.boolean().optional(),
+  isSupplemental: exports_external.boolean().meta({ description: "Whether this is supplemental to a base course" }).optional(),
+  isCustom: exports_external.boolean().meta({ description: "Whether this is a custom course for an individual student" }).optional(),
   publishStatus: PublishStatus.optional(),
-  contactEmail: exports_external.email().optional(),
-  primaryApp: exports_external.string().optional(),
+  contactEmail: exports_external.email().meta({ description: "Contact email for course issues" }).optional(),
+  primaryApp: exports_external.string().meta({ description: "Primary application identifier" }).optional(),
   goals: CourseGoals.optional(),
   metrics: CourseMetrics.optional()
-});
+}).meta({ id: "CourseMetadata", description: "Course metadata (matches API metadata object)" });
 var CourseDefaults = exports_external.object({
-  courseCode: exports_external.string().optional(),
-  level: exports_external.string().optional(),
+  courseCode: exports_external.string().meta({ description: "Course code (e.g., 'MATH101')" }).optional(),
+  level: exports_external.string().meta({ description: "Course level (e.g., 'AP', 'Honors')" }).optional(),
   metadata: CourseMetadata.optional()
+}).meta({
+  id: "CourseDefaults",
+  description: "Default properties that apply to all courses unless overridden"
 });
 var CourseEnvOverrides = exports_external.object({
-  level: exports_external.string().optional(),
-  sensor: exports_external.string().url().optional(),
-  launchUrl: exports_external.string().url().optional(),
+  level: exports_external.string().meta({ description: "Course level for this environment" }).optional(),
+  sensor: exports_external.url().meta({ description: "Caliper sensor endpoint URL for this environment" }).optional(),
+  launchUrl: exports_external.url().meta({ description: "LTI launch URL for this environment" }).optional(),
   metadata: CourseMetadata.optional()
+}).meta({
+  id: "CourseEnvOverrides",
+  description: "Environment-specific course overrides (non-identity fields)"
 });
 var CourseOverrides = exports_external.object({
-  staging: CourseEnvOverrides.optional(),
-  production: CourseEnvOverrides.optional()
-});
+  staging: CourseEnvOverrides.meta({
+    description: "Overrides for staging environment"
+  }).optional(),
+  production: CourseEnvOverrides.meta({
+    description: "Overrides for production environment"
+  }).optional()
+}).meta({ id: "CourseOverrides", description: "Per-environment course overrides" });
 var CourseConfig = CourseDefaults.extend({
-  subject: TimebackSubject,
-  grade: TimebackGrade.optional(),
+  subject: TimebackSubject.meta({ description: "Subject area for this course" }),
+  grade: TimebackGrade.meta({
+    description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+  }).optional(),
   ids: CourseIds.nullable().optional(),
-  sensor: exports_external.string().url().optional(),
-  launchUrl: exports_external.string().url().optional(),
+  sensor: exports_external.url().meta({ description: "Caliper sensor endpoint URL for this course" }).optional(),
+  launchUrl: exports_external.url().meta({ description: "LTI launch URL for this course" }).optional(),
   overrides: CourseOverrides.optional()
+}).meta({
+  id: "CourseConfig",
+  description: "Configuration for a single course. Must have either grade or courseCode (or both)."
 });
 var TimebackConfig = exports_external.object({
-  name: exports_external.string().min(1, "App name is required"),
-  defaults: CourseDefaults.optional(),
-  courses: exports_external.array(CourseConfig).min(1, "At least one course is required"),
-  sensor: exports_external.string().url().optional(),
-  launchUrl: exports_external.string().url().optional()
+  $schema: exports_external.string().meta({ description: "JSON Schema reference for editor support" }).optional(),
+  name: exports_external.string().min(1, "App name is required").meta({ description: "Display name for your app" }),
+  defaults: CourseDefaults.meta({
+    description: "Default properties applied to all courses"
+  }).optional(),
+  courses: exports_external.array(CourseConfig).min(1, "At least one course is required").meta({ description: "Courses available in this app" }),
+  sensor: exports_external.url().meta({ description: "Default Caliper sensor endpoint URL for all courses" }).optional(),
+  launchUrl: exports_external.url().meta({ description: "Default LTI launch URL for all courses" }).optional()
+}).meta({
+  id: "TimebackConfig",
+  title: "Timeback Config",
+  description: "Configuration schema for timeback.config.json files"
 }).refine((config2) => {
   return config2.courses.every((c) => c.grade !== undefined || c.courseCode !== undefined);
 }, {
@@ -18264,26 +18288,10 @@ var QtiLessonFeedbackInput = exports_external.object({
   humanApproved: exports_external.boolean().optional()
 }).strict();
 // ../internal/cli-infra/src/config/timeback.ts
-var FILE_PATTERNS2 = ["timeback.config.ts", "timeback.config.js", "timeback.config.mjs"];
-var isBun = typeof globalThis.Bun !== "undefined";
-var jitiInstance = null;
-async function getJiti() {
-  if (jitiInstance)
-    return jitiInstance;
-  const { createJiti } = await import("jiti");
-  jitiInstance = createJiti(import.meta.url, { fsCache: false });
-  return jitiInstance;
-}
-async function importModule(fullPath) {
-  let module;
-  if (isBun) {
-    const fileUrl = pathToFileURL(fullPath).href;
-    module = await import(fileUrl);
-  } else {
-    const jiti = await getJiti();
-    module = await jiti.import(fullPath);
-  }
-  return module.default ?? module;
+var CONFIG_FILENAME = "timeback.config.json";
+var FILE_PATTERNS2 = [CONFIG_FILENAME];
+function isJsonConfigPath(configPath) {
+  return extname(configPath).toLowerCase() === ".json";
 }
 function deriveCourseIds(config3) {
   const result = { staging: [], production: [] };
@@ -18301,58 +18309,73 @@ async function readPackageVersion(cwd) {
     return "0.0.0";
   }
 }
+async function loadWithC12(cwd, configPath) {
+  if (configPath && !isJsonConfigPath(configPath)) {
+    throw new Error(`Config file must be JSON (.json): ${configPath}`);
+  }
+  const result = await c12LoadConfig({
+    cwd,
+    name: "timeback",
+    configFile: configPath ?? CONFIG_FILENAME,
+    rcFile: false,
+    packageJson: false,
+    dotenv: false,
+    envName: false,
+    extend: false,
+    omit$Keys: true,
+    defaults: {},
+    overrides: {}
+  });
+  if (!result.config || Object.keys(result.config).length === 0) {
+    return null;
+  }
+  const rawConfig = result.config;
+  if ("extends" in rawConfig) {
+    throw new Error("The 'extends' feature is not supported in timeback.config.json. " + "Please inline all configuration.");
+  }
+  const { $schema: _schema, ...configWithoutSchema } = rawConfig;
+  return {
+    config: configWithoutSchema,
+    configFile: result.configFile ?? resolve(cwd, configPath ?? CONFIG_FILENAME)
+  };
+}
 async function parse6() {
   const cwd = process.cwd();
-  let rawConfig = null;
-  let foundPath = null;
-  let loadError = null;
-  for (const configPath of FILE_PATTERNS2) {
-    const fullPath = resolve(cwd, configPath);
-    if (!existsSync(fullPath))
-      continue;
-    try {
-      rawConfig = await importModule(fullPath);
-      foundPath = configPath;
-      break;
-    } catch (err) {
-      loadError = err instanceof Error ? err : new Error(String(err));
-      foundPath = configPath;
-      break;
+  try {
+    const loaded = await loadWithC12(cwd);
+    if (!loaded) {
+      return {
+        success: false,
+        error: `No timeback config found. Create ${CONFIG_FILENAME}`
+      };
     }
-  }
-  if (loadError && foundPath) {
-    return {
-      success: false,
-      error: `Failed to load ${foundPath}:
-${loadError.message}`
-    };
-  }
-  if (!rawConfig || !foundPath) {
+    const result = TimebackConfig.safeParse(loaded.config);
+    if (!result.success) {
+      const issues = result.error.issues.map((issue2) => `  - ${issue2.path.join(".")}: ${issue2.message}`).join(`
+`);
+      return {
+        success: false,
+        error: `Invalid config in ${CONFIG_FILENAME}:
+${issues}`
+      };
+    }
+    const version2 = await readPackageVersion(cwd);
+    const baseConfig = { ...result.data, version: version2 };
     return {
-      success: false,
-      error: `No timeback config found. Create one of: ${FILE_PATTERNS2.join(", ")}`
+      success: true,
+      config: {
+        ...baseConfig,
+        path: loaded.configFile,
+        courseIds: deriveCourseIds(baseConfig)
+      }
     };
-  }
-  const result = TimebackConfig.safeParse(rawConfig);
-  if (!result.success) {
-    const issues = result.error.issues.map((issue2) => `  - ${issue2.path.join(".")}: ${issue2.message}`).join(`
-`);
+  } catch (err) {
     return {
       success: false,
-      error: `Invalid config in ${foundPath}:
-${issues}`
+      error: `Failed to load ${CONFIG_FILENAME}:
+${err instanceof Error ? err.message : String(err)}`
     };
   }
-  const version2 = await readPackageVersion(cwd);
-  const baseConfig = { ...result.data, version: version2 };
-  return {
-    success: true,
-    config: {
-      ...baseConfig,
-      path: `${cwd}/${foundPath}`,
-      courseIds: deriveCourseIds(baseConfig)
-    }
-  };
 }
 function printError2(error48) {
   console.log();
@@ -18360,13 +18383,16 @@ function printError2(error48) {
   console.log();
   console.log(`  ${error48}`);
   console.log();
-  console.log(`  ${dim("Example timeback.config.ts:")}`);
+  console.log(`  ${dim("Example timeback.config.json:")}`);
   console.log();
-  console.log(`  ${yellow("export default {")}`);
-  console.log(`  ${yellow("  name: 'My Timeback App',")}`);
-  console.log(`  ${yellow("  courses: [")}`);
-  console.log(`  ${yellow("    { subject: 'Math', grade: 3 },")}`);
-  console.log(`  ${yellow("  ],")}`);
+  console.log(`  ${yellow("{")}`);
+  console.log(`  ${yellow('  "$schema": "https://timeback.dev/schema.json",')}`);
+  console.log(`  ${yellow('  "name": "My Timeback App",')}`);
+  console.log(`  ${yellow('  "launchUrl": "https://example.com/play",')}`);
+  console.log(`  ${yellow('  "sensor": "https://example.com/sensor",')}`);
+  console.log(`  ${yellow('  "courses": [')}`);
+  console.log(`  ${yellow('    { "subject": "Math", "grade": 3 }')}`);
+  console.log(`  ${yellow("  ]")}`);
   console.log(`  ${yellow("}")}`);
   console.log();
 }

package/dist/cli/commands/serve/config.d.ts

@@ -49,7 +49,7 @@ export declare function getEffectiveSensors(config: LoadedUserConfig, opts: Serv
  *
  * Resolution priority:
  * 1. CLI course IDs (if provided)
- * 2. Config file (timeback.config.ts / playcademy.config.ts)
+ * 2. Config file (timeback.config.json / playcademy.config.ts)
  * 3. Interactive import flow
  *
  * @param courseIds - Course IDs from CLI positional args

package/dist/cli/commands/serve/types.d.ts

@@ -10,7 +10,7 @@ export interface ServeOptions extends ParserOptions {
 export interface ResolvedConfig {
     userConfig: LoadedUserConfig;
     environment: Environment;
-    /** Config filename for logging (e.g., 'timeback.config.ts') */
+    /** Config filename for logging (e.g., 'timeback.config.json') */
     configFile?: string;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/cli/commands/serve/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/serve/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEnF,MAAM,WAAW,YAAa,SAAQ,aAAa;IAClD,GAAG,CAAC,EAAE,WAAW,CAAA;IACjB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,cAAc;IAC9B,UAAU,EAAE,gBAAgB,CAAA;IAC5B,WAAW,EAAE,WAAW,CAAA;IACxB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/serve/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEnF,MAAM,WAAW,YAAa,SAAQ,aAAa;IAClD,GAAG,CAAC,EAAE,WAAW,CAAA;IACjB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,cAAc;IAC9B,UAAU,EAAE,gBAAgB,CAAA;IAC5B,WAAW,EAAE,WAAW,CAAA;IACxB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB"}

package/dist/cli/lib/onboarding/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * Onboarding Utilities
  *
- * Handles first-time setup when timeback.config.ts is missing.
+ * Handles first-time setup when timeback.config.json is missing.
  * Runs import flow and returns data in-memory (no file writes).
  */
 import type { Environment, EnvironmentCredentials } from '../../../config';

package/dist/config/timeback.d.ts

@@ -1,7 +1,7 @@
 /**
  * Timeback Config Loading
  *
- * Utilities for loading and validating the user's timeback.config.ts file.
+ * Utilities for loading and validating the user's timeback.config.json file.
  */
 import type { ConfigParseResult, ParserOptions } from '@timeback/internal-cli-infra';
 /**

package/dist/index.js

@@ -14816,10 +14816,9 @@ var playcademyParser = {
 };
 
 // ../internal/cli-infra/src/config/timeback.ts
-import { existsSync } from "node:fs";
 import { readFile as readFile2 } from "node:fs/promises";
-import { basename, relative, resolve } from "node:path";
-import { pathToFileURL } from "node:url";
+import { basename, extname, relative, resolve } from "node:path";
+import { loadConfig as c12LoadConfig } from "c12";
 // ../types/src/zod/primitives.ts
 var IsoDateTimeRegex = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/;
 var IsoDateTimeString = exports_external.string().min(1).regex(IsoDateTimeRegex, "must be a valid ISO 8601 datetime");
@@ -14835,7 +14834,7 @@ var TimebackSubject = exports_external.enum([
   "Math",
   "None",
   "Other"
-]);
+]).meta({ id: "TimebackSubject", description: "Subject area" });
 var TimebackGrade = exports_external.union([
   exports_external.literal(-1),
   exports_external.literal(0),
@@ -14852,7 +14851,10 @@ var TimebackGrade = exports_external.union([
   exports_external.literal(11),
   exports_external.literal(12),
   exports_external.literal(13)
-]);
+]).meta({
+  id: "TimebackGrade",
+  description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+});
 var ScoreStatus = exports_external.enum([
   "exempt",
   "fully graded",
@@ -15084,62 +15086,84 @@ var CaliperListEventsParams = exports_external.object({
 }).strict();
 // ../types/src/zod/config.ts
 var CourseIds = exports_external.object({
-  staging: exports_external.string().optional(),
-  production: exports_external.string().optional()
-});
-var CourseType = exports_external.enum(["base", "hole-filling", "optional"]);
-var PublishStatus = exports_external.enum(["draft", "testing", "published", "deactivated"]);
+  staging: exports_external.string().meta({ description: "Course ID in staging environment" }).optional(),
+  production: exports_external.string().meta({ description: "Course ID in production environment" }).optional()
+}).meta({ id: "CourseIds", description: "Environment-specific course IDs (populated by sync)" });
+var CourseType = exports_external.enum(["base", "hole-filling", "optional"]).meta({ id: "CourseType", description: "Course classification type" });
+var PublishStatus = exports_external.enum(["draft", "testing", "published", "deactivated"]).meta({ id: "PublishStatus", description: "Course publication status" });
 var CourseGoals = exports_external.object({
-  dailyXp: exports_external.number().int().positive().optional(),
-  dailyLessons: exports_external.number().int().positive().optional(),
-  dailyActiveMinutes: exports_external.number().int().positive().optional(),
-  dailyAccuracy: exports_external.number().int().min(0).max(100).optional(),
-  dailyMasteredUnits: exports_external.number().int().positive().optional()
-});
+  dailyXp: exports_external.number().int().positive().meta({ description: "Target XP to earn per day" }).optional(),
+  dailyLessons: exports_external.number().int().positive().meta({ description: "Target lessons to complete per day" }).optional(),
+  dailyActiveMinutes: exports_external.number().int().positive().meta({ description: "Target active learning minutes per day" }).optional(),
+  dailyAccuracy: exports_external.number().int().min(0).max(100).meta({ description: "Target accuracy percentage (0-100)" }).optional(),
+  dailyMasteredUnits: exports_external.number().int().positive().meta({ description: "Target units to master per day" }).optional()
+}).meta({ id: "CourseGoals", description: "Daily learning goals for a course" });
 var CourseMetrics = exports_external.object({
-  totalXp: exports_external.number().int().positive().optional(),
-  totalLessons: exports_external.number().int().positive().optional(),
-  totalGrades: exports_external.number().int().positive().optional()
-});
+  totalXp: exports_external.number().int().positive().meta({ description: "Total XP available in the course" }).optional(),
+  totalLessons: exports_external.number().int().positive().meta({ description: "Total number of lessons/activities" }).optional(),
+  totalGrades: exports_external.number().int().positive().meta({ description: "Total grade levels covered" }).optional()
+}).meta({ id: "CourseMetrics", description: "Aggregate metrics for a course" });
 var CourseMetadata = exports_external.object({
   courseType: CourseType.optional(),
-  isSupplemental: exports_external.boolean().optional(),
-  isCustom: exports_external.boolean().optional(),
+  isSupplemental: exports_external.boolean().meta({ description: "Whether this is supplemental to a base course" }).optional(),
+  isCustom: exports_external.boolean().meta({ description: "Whether this is a custom course for an individual student" }).optional(),
   publishStatus: PublishStatus.optional(),
-  contactEmail: exports_external.email().optional(),
-  primaryApp: exports_external.string().optional(),
+  contactEmail: exports_external.email().meta({ description: "Contact email for course issues" }).optional(),
+  primaryApp: exports_external.string().meta({ description: "Primary application identifier" }).optional(),
   goals: CourseGoals.optional(),
   metrics: CourseMetrics.optional()
-});
+}).meta({ id: "CourseMetadata", description: "Course metadata (matches API metadata object)" });
 var CourseDefaults = exports_external.object({
-  courseCode: exports_external.string().optional(),
-  level: exports_external.string().optional(),
+  courseCode: exports_external.string().meta({ description: "Course code (e.g., 'MATH101')" }).optional(),
+  level: exports_external.string().meta({ description: "Course level (e.g., 'AP', 'Honors')" }).optional(),
   metadata: CourseMetadata.optional()
+}).meta({
+  id: "CourseDefaults",
+  description: "Default properties that apply to all courses unless overridden"
 });
 var CourseEnvOverrides = exports_external.object({
-  level: exports_external.string().optional(),
-  sensor: exports_external.string().url().optional(),
-  launchUrl: exports_external.string().url().optional(),
+  level: exports_external.string().meta({ description: "Course level for this environment" }).optional(),
+  sensor: exports_external.url().meta({ description: "Caliper sensor endpoint URL for this environment" }).optional(),
+  launchUrl: exports_external.url().meta({ description: "LTI launch URL for this environment" }).optional(),
   metadata: CourseMetadata.optional()
+}).meta({
+  id: "CourseEnvOverrides",
+  description: "Environment-specific course overrides (non-identity fields)"
 });
 var CourseOverrides = exports_external.object({
-  staging: CourseEnvOverrides.optional(),
-  production: CourseEnvOverrides.optional()
-});
+  staging: CourseEnvOverrides.meta({
+    description: "Overrides for staging environment"
+  }).optional(),
+  production: CourseEnvOverrides.meta({
+    description: "Overrides for production environment"
+  }).optional()
+}).meta({ id: "CourseOverrides", description: "Per-environment course overrides" });
 var CourseConfig = CourseDefaults.extend({
-  subject: TimebackSubject,
-  grade: TimebackGrade.optional(),
+  subject: TimebackSubject.meta({ description: "Subject area for this course" }),
+  grade: TimebackGrade.meta({
+    description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+  }).optional(),
   ids: CourseIds.nullable().optional(),
-  sensor: exports_external.string().url().optional(),
-  launchUrl: exports_external.string().url().optional(),
+  sensor: exports_external.url().meta({ description: "Caliper sensor endpoint URL for this course" }).optional(),
+  launchUrl: exports_external.url().meta({ description: "LTI launch URL for this course" }).optional(),
   overrides: CourseOverrides.optional()
+}).meta({
+  id: "CourseConfig",
+  description: "Configuration for a single course. Must have either grade or courseCode (or both)."
 });
 var TimebackConfig = exports_external.object({
-  name: exports_external.string().min(1, "App name is required"),
-  defaults: CourseDefaults.optional(),
-  courses: exports_external.array(CourseConfig).min(1, "At least one course is required"),
-  sensor: exports_external.string().url().optional(),
-  launchUrl: exports_external.string().url().optional()
+  $schema: exports_external.string().meta({ description: "JSON Schema reference for editor support" }).optional(),
+  name: exports_external.string().min(1, "App name is required").meta({ description: "Display name for your app" }),
+  defaults: CourseDefaults.meta({
+    description: "Default properties applied to all courses"
+  }).optional(),
+  courses: exports_external.array(CourseConfig).min(1, "At least one course is required").meta({ description: "Courses available in this app" }),
+  sensor: exports_external.url().meta({ description: "Default Caliper sensor endpoint URL for all courses" }).optional(),
+  launchUrl: exports_external.url().meta({ description: "Default LTI launch URL for all courses" }).optional()
+}).meta({
+  id: "TimebackConfig",
+  title: "Timeback Config",
+  description: "Configuration schema for timeback.config.json files"
 }).refine((config2) => {
   return config2.courses.every((c) => c.grade !== undefined || c.courseCode !== undefined);
 }, {
@@ -16154,26 +16178,10 @@ var QtiLessonFeedbackInput = exports_external.object({
   humanApproved: exports_external.boolean().optional()
 }).strict();
 // ../internal/cli-infra/src/config/timeback.ts
-var FILE_PATTERNS2 = ["timeback.config.ts", "timeback.config.js", "timeback.config.mjs"];
-var isBun = typeof globalThis.Bun !== "undefined";
-var jitiInstance = null;
-async function getJiti() {
-  if (jitiInstance)
-    return jitiInstance;
-  const { createJiti } = await import("jiti");
-  jitiInstance = createJiti(import.meta.url, { fsCache: false });
-  return jitiInstance;
-}
-async function importModule(fullPath) {
-  let module;
-  if (isBun) {
-    const fileUrl = pathToFileURL(fullPath).href;
-    module = await import(fileUrl);
-  } else {
-    const jiti = await getJiti();
-    module = await jiti.import(fullPath);
-  }
-  return module.default ?? module;
+var CONFIG_FILENAME = "timeback.config.json";
+var FILE_PATTERNS2 = [CONFIG_FILENAME];
+function isJsonConfigPath(configPath) {
+  return extname(configPath).toLowerCase() === ".json";
 }
 function deriveCourseIds(config3) {
   const result = { staging: [], production: [] };
@@ -16191,58 +16199,73 @@ async function readPackageVersion(cwd) {
     return "0.0.0";
   }
 }
+async function loadWithC12(cwd, configPath) {
+  if (configPath && !isJsonConfigPath(configPath)) {
+    throw new Error(`Config file must be JSON (.json): ${configPath}`);
+  }
+  const result = await c12LoadConfig({
+    cwd,
+    name: "timeback",
+    configFile: configPath ?? CONFIG_FILENAME,
+    rcFile: false,
+    packageJson: false,
+    dotenv: false,
+    envName: false,
+    extend: false,
+    omit$Keys: true,
+    defaults: {},
+    overrides: {}
+  });
+  if (!result.config || Object.keys(result.config).length === 0) {
+    return null;
+  }
+  const rawConfig = result.config;
+  if ("extends" in rawConfig) {
+    throw new Error("The 'extends' feature is not supported in timeback.config.json. " + "Please inline all configuration.");
+  }
+  const { $schema: _schema, ...configWithoutSchema } = rawConfig;
+  return {
+    config: configWithoutSchema,
+    configFile: result.configFile ?? resolve(cwd, configPath ?? CONFIG_FILENAME)
+  };
+}
 async function parse6() {
   const cwd = process.cwd();
-  let rawConfig = null;
-  let foundPath = null;
-  let loadError = null;
-  for (const configPath of FILE_PATTERNS2) {
-    const fullPath = resolve(cwd, configPath);
-    if (!existsSync(fullPath))
-      continue;
-    try {
-      rawConfig = await importModule(fullPath);
-      foundPath = configPath;
-      break;
-    } catch (err) {
-      loadError = err instanceof Error ? err : new Error(String(err));
-      foundPath = configPath;
-      break;
+  try {
+    const loaded = await loadWithC12(cwd);
+    if (!loaded) {
+      return {
+        success: false,
+        error: `No timeback config found. Create ${CONFIG_FILENAME}`
+      };
     }
-  }
-  if (loadError && foundPath) {
-    return {
-      success: false,
-      error: `Failed to load ${foundPath}:
-${loadError.message}`
-    };
-  }
-  if (!rawConfig || !foundPath) {
+    const result = TimebackConfig.safeParse(loaded.config);
+    if (!result.success) {
+      const issues = result.error.issues.map((issue2) => `  - ${issue2.path.join(".")}: ${issue2.message}`).join(`
+`);
+      return {
+        success: false,
+        error: `Invalid config in ${CONFIG_FILENAME}:
+${issues}`
+      };
+    }
+    const version2 = await readPackageVersion(cwd);
+    const baseConfig = { ...result.data, version: version2 };
     return {
-      success: false,
-      error: `No timeback config found. Create one of: ${FILE_PATTERNS2.join(", ")}`
+      success: true,
+      config: {
+        ...baseConfig,
+        path: loaded.configFile,
+        courseIds: deriveCourseIds(baseConfig)
+      }
     };
-  }
-  const result = TimebackConfig.safeParse(rawConfig);
-  if (!result.success) {
-    const issues = result.error.issues.map((issue2) => `  - ${issue2.path.join(".")}: ${issue2.message}`).join(`
-`);
+  } catch (err) {
     return {
       success: false,
-      error: `Invalid config in ${foundPath}:
-${issues}`
+      error: `Failed to load ${CONFIG_FILENAME}:
+${err instanceof Error ? err.message : String(err)}`
     };
   }
-  const version2 = await readPackageVersion(cwd);
-  const baseConfig = { ...result.data, version: version2 };
-  return {
-    success: true,
-    config: {
-      ...baseConfig,
-      path: `${cwd}/${foundPath}`,
-      courseIds: deriveCourseIds(baseConfig)
-    }
-  };
 }
 function printError2(error48) {
   console.log();
@@ -16250,13 +16273,16 @@ function printError2(error48) {
   console.log();
   console.log(`  ${error48}`);
   console.log();
-  console.log(`  ${dim("Example timeback.config.ts:")}`);
+  console.log(`  ${dim("Example timeback.config.json:")}`);
   console.log();
-  console.log(`  ${yellow("export default {")}`);
-  console.log(`  ${yellow("  name: 'My Timeback App',")}`);
-  console.log(`  ${yellow("  courses: [")}`);
-  console.log(`  ${yellow("    { subject: 'Math', grade: 3 },")}`);
-  console.log(`  ${yellow("  ],")}`);
+  console.log(`  ${yellow("{")}`);
+  console.log(`  ${yellow('  "$schema": "https://timeback.dev/schema.json",')}`);
+  console.log(`  ${yellow('  "name": "My Timeback App",')}`);
+  console.log(`  ${yellow('  "launchUrl": "https://example.com/play",')}`);
+  console.log(`  ${yellow('  "sensor": "https://example.com/sensor",')}`);
+  console.log(`  ${yellow('  "courses": [')}`);
+  console.log(`  ${yellow('    { "subject": "Math", "grade": 3 }')}`);
+  console.log(`  ${yellow("  ]")}`);
   console.log(`  ${yellow("}")}`);
   console.log();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "timeback-studio",
-	"version": "0.1.3",
+	"version": "0.1.4",
 	"type": "module",
 	"exports": {
 		".": {
@@ -28,10 +28,10 @@
 		"@clack/prompts": "^0.11.0",
 		"@hono/node-server": "^1.19.7",
 		"@timeback/core": "0.1.3",
+		"c12": "^3.3.3",
 		"colorette": "^2.0.20",
 		"commander": "^14.0.2",
 		"hono": "^4.11.1",
-		"jiti": "^2.6.1",
 		"zod": "^4.2.1"
 	},
 	"devDependencies": {