@timeback/sdk 0.1.5 → 0.1.6

package/dist/index.js

@@ -14949,7 +14949,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),
@@ -14966,7 +14966,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",
@@ -15196,62 +15199,84 @@ var CaliperListEventsParams = exports_external.object({
   actorEmail: exports_external.email().optional()
 }).strict();
 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);
 }, {
@@ -31327,7 +31352,7 @@ var TimebackSubject2 = exports_external2.enum([
   "Math",
   "None",
   "Other"
-]);
+]).meta({ id: "TimebackSubject", description: "Subject area" });
 var TimebackGrade2 = exports_external2.union([
   exports_external2.literal(-1),
   exports_external2.literal(0),
@@ -31344,7 +31369,10 @@ var TimebackGrade2 = exports_external2.union([
   exports_external2.literal(11),
   exports_external2.literal(12),
   exports_external2.literal(13)
-]);
+]).meta({
+  id: "TimebackGrade",
+  description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+});
 var ScoreStatus2 = exports_external2.enum([
   "exempt",
   "fully graded",
@@ -31574,62 +31602,84 @@ var CaliperListEventsParams2 = exports_external2.object({
   actorEmail: exports_external2.email().optional()
 }).strict();
 var CourseIds2 = exports_external2.object({
-  staging: exports_external2.string().optional(),
-  production: exports_external2.string().optional()
-});
-var CourseType2 = exports_external2.enum(["base", "hole-filling", "optional"]);
-var PublishStatus2 = exports_external2.enum(["draft", "testing", "published", "deactivated"]);
+  staging: exports_external2.string().meta({ description: "Course ID in staging environment" }).optional(),
+  production: exports_external2.string().meta({ description: "Course ID in production environment" }).optional()
+}).meta({ id: "CourseIds", description: "Environment-specific course IDs (populated by sync)" });
+var CourseType2 = exports_external2.enum(["base", "hole-filling", "optional"]).meta({ id: "CourseType", description: "Course classification type" });
+var PublishStatus2 = exports_external2.enum(["draft", "testing", "published", "deactivated"]).meta({ id: "PublishStatus", description: "Course publication status" });
 var CourseGoals2 = exports_external2.object({
-  dailyXp: exports_external2.number().int().positive().optional(),
-  dailyLessons: exports_external2.number().int().positive().optional(),
-  dailyActiveMinutes: exports_external2.number().int().positive().optional(),
-  dailyAccuracy: exports_external2.number().int().min(0).max(100).optional(),
-  dailyMasteredUnits: exports_external2.number().int().positive().optional()
-});
+  dailyXp: exports_external2.number().int().positive().meta({ description: "Target XP to earn per day" }).optional(),
+  dailyLessons: exports_external2.number().int().positive().meta({ description: "Target lessons to complete per day" }).optional(),
+  dailyActiveMinutes: exports_external2.number().int().positive().meta({ description: "Target active learning minutes per day" }).optional(),
+  dailyAccuracy: exports_external2.number().int().min(0).max(100).meta({ description: "Target accuracy percentage (0-100)" }).optional(),
+  dailyMasteredUnits: exports_external2.number().int().positive().meta({ description: "Target units to master per day" }).optional()
+}).meta({ id: "CourseGoals", description: "Daily learning goals for a course" });
 var CourseMetrics2 = exports_external2.object({
-  totalXp: exports_external2.number().int().positive().optional(),
-  totalLessons: exports_external2.number().int().positive().optional(),
-  totalGrades: exports_external2.number().int().positive().optional()
-});
+  totalXp: exports_external2.number().int().positive().meta({ description: "Total XP available in the course" }).optional(),
+  totalLessons: exports_external2.number().int().positive().meta({ description: "Total number of lessons/activities" }).optional(),
+  totalGrades: exports_external2.number().int().positive().meta({ description: "Total grade levels covered" }).optional()
+}).meta({ id: "CourseMetrics", description: "Aggregate metrics for a course" });
 var CourseMetadata2 = exports_external2.object({
   courseType: CourseType2.optional(),
-  isSupplemental: exports_external2.boolean().optional(),
-  isCustom: exports_external2.boolean().optional(),
+  isSupplemental: exports_external2.boolean().meta({ description: "Whether this is supplemental to a base course" }).optional(),
+  isCustom: exports_external2.boolean().meta({ description: "Whether this is a custom course for an individual student" }).optional(),
   publishStatus: PublishStatus2.optional(),
-  contactEmail: exports_external2.email().optional(),
-  primaryApp: exports_external2.string().optional(),
+  contactEmail: exports_external2.email().meta({ description: "Contact email for course issues" }).optional(),
+  primaryApp: exports_external2.string().meta({ description: "Primary application identifier" }).optional(),
   goals: CourseGoals2.optional(),
   metrics: CourseMetrics2.optional()
-});
+}).meta({ id: "CourseMetadata", description: "Course metadata (matches API metadata object)" });
 var CourseDefaults2 = exports_external2.object({
-  courseCode: exports_external2.string().optional(),
-  level: exports_external2.string().optional(),
+  courseCode: exports_external2.string().meta({ description: "Course code (e.g., 'MATH101')" }).optional(),
+  level: exports_external2.string().meta({ description: "Course level (e.g., 'AP', 'Honors')" }).optional(),
   metadata: CourseMetadata2.optional()
+}).meta({
+  id: "CourseDefaults",
+  description: "Default properties that apply to all courses unless overridden"
 });
 var CourseEnvOverrides2 = exports_external2.object({
-  level: exports_external2.string().optional(),
-  sensor: exports_external2.string().url().optional(),
-  launchUrl: exports_external2.string().url().optional(),
+  level: exports_external2.string().meta({ description: "Course level for this environment" }).optional(),
+  sensor: exports_external2.url().meta({ description: "Caliper sensor endpoint URL for this environment" }).optional(),
+  launchUrl: exports_external2.url().meta({ description: "LTI launch URL for this environment" }).optional(),
   metadata: CourseMetadata2.optional()
+}).meta({
+  id: "CourseEnvOverrides",
+  description: "Environment-specific course overrides (non-identity fields)"
 });
 var CourseOverrides2 = exports_external2.object({
-  staging: CourseEnvOverrides2.optional(),
-  production: CourseEnvOverrides2.optional()
-});
+  staging: CourseEnvOverrides2.meta({
+    description: "Overrides for staging environment"
+  }).optional(),
+  production: CourseEnvOverrides2.meta({
+    description: "Overrides for production environment"
+  }).optional()
+}).meta({ id: "CourseOverrides", description: "Per-environment course overrides" });
 var CourseConfig2 = CourseDefaults2.extend({
-  subject: TimebackSubject2,
-  grade: TimebackGrade2.optional(),
+  subject: TimebackSubject2.meta({ description: "Subject area for this course" }),
+  grade: TimebackGrade2.meta({
+    description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+  }).optional(),
   ids: CourseIds2.nullable().optional(),
-  sensor: exports_external2.string().url().optional(),
-  launchUrl: exports_external2.string().url().optional(),
+  sensor: exports_external2.url().meta({ description: "Caliper sensor endpoint URL for this course" }).optional(),
+  launchUrl: exports_external2.url().meta({ description: "LTI launch URL for this course" }).optional(),
   overrides: CourseOverrides2.optional()
+}).meta({
+  id: "CourseConfig",
+  description: "Configuration for a single course. Must have either grade or courseCode (or both)."
 });
 var TimebackConfig2 = exports_external2.object({
-  name: exports_external2.string().min(1, "App name is required"),
-  defaults: CourseDefaults2.optional(),
-  courses: exports_external2.array(CourseConfig2).min(1, "At least one course is required"),
-  sensor: exports_external2.string().url().optional(),
-  launchUrl: exports_external2.string().url().optional()
+  $schema: exports_external2.string().meta({ description: "JSON Schema reference for editor support" }).optional(),
+  name: exports_external2.string().min(1, "App name is required").meta({ description: "Display name for your app" }),
+  defaults: CourseDefaults2.meta({
+    description: "Default properties applied to all courses"
+  }).optional(),
+  courses: exports_external2.array(CourseConfig2).min(1, "At least one course is required").meta({ description: "Courses available in this app" }),
+  sensor: exports_external2.url().meta({ description: "Default Caliper sensor endpoint URL for all courses" }).optional(),
+  launchUrl: exports_external2.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((config22) => {
   return config22.courses.every((c) => c.grade !== undefined || c.courseCode !== undefined);
 }, {
@@ -48735,7 +48785,7 @@ var TimebackSubject3 = exports_external3.enum([
   "Math",
   "None",
   "Other"
-]);
+]).meta({ id: "TimebackSubject", description: "Subject area" });
 var TimebackGrade3 = exports_external3.union([
   exports_external3.literal(-1),
   exports_external3.literal(0),
@@ -48752,7 +48802,10 @@ var TimebackGrade3 = exports_external3.union([
   exports_external3.literal(11),
   exports_external3.literal(12),
   exports_external3.literal(13)
-]);
+]).meta({
+  id: "TimebackGrade",
+  description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+});
 var ScoreStatus3 = exports_external3.enum([
   "exempt",
   "fully graded",
@@ -48982,62 +49035,84 @@ var CaliperListEventsParams3 = exports_external3.object({
   actorEmail: exports_external3.email().optional()
 }).strict();
 var CourseIds3 = exports_external3.object({
-  staging: exports_external3.string().optional(),
-  production: exports_external3.string().optional()
-});
-var CourseType3 = exports_external3.enum(["base", "hole-filling", "optional"]);
-var PublishStatus3 = exports_external3.enum(["draft", "testing", "published", "deactivated"]);
+  staging: exports_external3.string().meta({ description: "Course ID in staging environment" }).optional(),
+  production: exports_external3.string().meta({ description: "Course ID in production environment" }).optional()
+}).meta({ id: "CourseIds", description: "Environment-specific course IDs (populated by sync)" });
+var CourseType3 = exports_external3.enum(["base", "hole-filling", "optional"]).meta({ id: "CourseType", description: "Course classification type" });
+var PublishStatus3 = exports_external3.enum(["draft", "testing", "published", "deactivated"]).meta({ id: "PublishStatus", description: "Course publication status" });
 var CourseGoals3 = exports_external3.object({
-  dailyXp: exports_external3.number().int().positive().optional(),
-  dailyLessons: exports_external3.number().int().positive().optional(),
-  dailyActiveMinutes: exports_external3.number().int().positive().optional(),
-  dailyAccuracy: exports_external3.number().int().min(0).max(100).optional(),
-  dailyMasteredUnits: exports_external3.number().int().positive().optional()
-});
+  dailyXp: exports_external3.number().int().positive().meta({ description: "Target XP to earn per day" }).optional(),
+  dailyLessons: exports_external3.number().int().positive().meta({ description: "Target lessons to complete per day" }).optional(),
+  dailyActiveMinutes: exports_external3.number().int().positive().meta({ description: "Target active learning minutes per day" }).optional(),
+  dailyAccuracy: exports_external3.number().int().min(0).max(100).meta({ description: "Target accuracy percentage (0-100)" }).optional(),
+  dailyMasteredUnits: exports_external3.number().int().positive().meta({ description: "Target units to master per day" }).optional()
+}).meta({ id: "CourseGoals", description: "Daily learning goals for a course" });
 var CourseMetrics3 = exports_external3.object({
-  totalXp: exports_external3.number().int().positive().optional(),
-  totalLessons: exports_external3.number().int().positive().optional(),
-  totalGrades: exports_external3.number().int().positive().optional()
-});
+  totalXp: exports_external3.number().int().positive().meta({ description: "Total XP available in the course" }).optional(),
+  totalLessons: exports_external3.number().int().positive().meta({ description: "Total number of lessons/activities" }).optional(),
+  totalGrades: exports_external3.number().int().positive().meta({ description: "Total grade levels covered" }).optional()
+}).meta({ id: "CourseMetrics", description: "Aggregate metrics for a course" });
 var CourseMetadata3 = exports_external3.object({
   courseType: CourseType3.optional(),
-  isSupplemental: exports_external3.boolean().optional(),
-  isCustom: exports_external3.boolean().optional(),
+  isSupplemental: exports_external3.boolean().meta({ description: "Whether this is supplemental to a base course" }).optional(),
+  isCustom: exports_external3.boolean().meta({ description: "Whether this is a custom course for an individual student" }).optional(),
   publishStatus: PublishStatus3.optional(),
-  contactEmail: exports_external3.email().optional(),
-  primaryApp: exports_external3.string().optional(),
+  contactEmail: exports_external3.email().meta({ description: "Contact email for course issues" }).optional(),
+  primaryApp: exports_external3.string().meta({ description: "Primary application identifier" }).optional(),
   goals: CourseGoals3.optional(),
   metrics: CourseMetrics3.optional()
-});
+}).meta({ id: "CourseMetadata", description: "Course metadata (matches API metadata object)" });
 var CourseDefaults3 = exports_external3.object({
-  courseCode: exports_external3.string().optional(),
-  level: exports_external3.string().optional(),
+  courseCode: exports_external3.string().meta({ description: "Course code (e.g., 'MATH101')" }).optional(),
+  level: exports_external3.string().meta({ description: "Course level (e.g., 'AP', 'Honors')" }).optional(),
   metadata: CourseMetadata3.optional()
+}).meta({
+  id: "CourseDefaults",
+  description: "Default properties that apply to all courses unless overridden"
 });
 var CourseEnvOverrides3 = exports_external3.object({
-  level: exports_external3.string().optional(),
-  sensor: exports_external3.string().url().optional(),
-  launchUrl: exports_external3.string().url().optional(),
+  level: exports_external3.string().meta({ description: "Course level for this environment" }).optional(),
+  sensor: exports_external3.url().meta({ description: "Caliper sensor endpoint URL for this environment" }).optional(),
+  launchUrl: exports_external3.url().meta({ description: "LTI launch URL for this environment" }).optional(),
   metadata: CourseMetadata3.optional()
+}).meta({
+  id: "CourseEnvOverrides",
+  description: "Environment-specific course overrides (non-identity fields)"
 });
 var CourseOverrides3 = exports_external3.object({
-  staging: CourseEnvOverrides3.optional(),
-  production: CourseEnvOverrides3.optional()
-});
+  staging: CourseEnvOverrides3.meta({
+    description: "Overrides for staging environment"
+  }).optional(),
+  production: CourseEnvOverrides3.meta({
+    description: "Overrides for production environment"
+  }).optional()
+}).meta({ id: "CourseOverrides", description: "Per-environment course overrides" });
 var CourseConfig3 = CourseDefaults3.extend({
-  subject: TimebackSubject3,
-  grade: TimebackGrade3.optional(),
+  subject: TimebackSubject3.meta({ description: "Subject area for this course" }),
+  grade: TimebackGrade3.meta({
+    description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+  }).optional(),
   ids: CourseIds3.nullable().optional(),
-  sensor: exports_external3.string().url().optional(),
-  launchUrl: exports_external3.string().url().optional(),
+  sensor: exports_external3.url().meta({ description: "Caliper sensor endpoint URL for this course" }).optional(),
+  launchUrl: exports_external3.url().meta({ description: "LTI launch URL for this course" }).optional(),
   overrides: CourseOverrides3.optional()
+}).meta({
+  id: "CourseConfig",
+  description: "Configuration for a single course. Must have either grade or courseCode (or both)."
 });
 var TimebackConfig3 = exports_external3.object({
-  name: exports_external3.string().min(1, "App name is required"),
-  defaults: CourseDefaults3.optional(),
-  courses: exports_external3.array(CourseConfig3).min(1, "At least one course is required"),
-  sensor: exports_external3.string().url().optional(),
-  launchUrl: exports_external3.string().url().optional()
+  $schema: exports_external3.string().meta({ description: "JSON Schema reference for editor support" }).optional(),
+  name: exports_external3.string().min(1, "App name is required").meta({ description: "Display name for your app" }),
+  defaults: CourseDefaults3.meta({
+    description: "Default properties applied to all courses"
+  }).optional(),
+  courses: exports_external3.array(CourseConfig3).min(1, "At least one course is required").meta({ description: "Courses available in this app" }),
+  sensor: exports_external3.url().meta({ description: "Default Caliper sensor endpoint URL for all courses" }).optional(),
+  launchUrl: exports_external3.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((config22) => {
   return config22.courses.every((c) => c.grade !== undefined || c.courseCode !== undefined);
 }, {
@@ -66342,7 +66417,7 @@ var TimebackSubject4 = exports_external4.enum([
   "Math",
   "None",
   "Other"
-]);
+]).meta({ id: "TimebackSubject", description: "Subject area" });
 var TimebackGrade4 = exports_external4.union([
   exports_external4.literal(-1),
   exports_external4.literal(0),
@@ -66359,7 +66434,10 @@ var TimebackGrade4 = exports_external4.union([
   exports_external4.literal(11),
   exports_external4.literal(12),
   exports_external4.literal(13)
-]);
+]).meta({
+  id: "TimebackGrade",
+  description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+});
 var ScoreStatus4 = exports_external4.enum([
   "exempt",
   "fully graded",
@@ -66589,62 +66667,84 @@ var CaliperListEventsParams4 = exports_external4.object({
   actorEmail: exports_external4.email().optional()
 }).strict();
 var CourseIds4 = exports_external4.object({
-  staging: exports_external4.string().optional(),
-  production: exports_external4.string().optional()
-});
-var CourseType4 = exports_external4.enum(["base", "hole-filling", "optional"]);
-var PublishStatus4 = exports_external4.enum(["draft", "testing", "published", "deactivated"]);
+  staging: exports_external4.string().meta({ description: "Course ID in staging environment" }).optional(),
+  production: exports_external4.string().meta({ description: "Course ID in production environment" }).optional()
+}).meta({ id: "CourseIds", description: "Environment-specific course IDs (populated by sync)" });
+var CourseType4 = exports_external4.enum(["base", "hole-filling", "optional"]).meta({ id: "CourseType", description: "Course classification type" });
+var PublishStatus4 = exports_external4.enum(["draft", "testing", "published", "deactivated"]).meta({ id: "PublishStatus", description: "Course publication status" });
 var CourseGoals4 = exports_external4.object({
-  dailyXp: exports_external4.number().int().positive().optional(),
-  dailyLessons: exports_external4.number().int().positive().optional(),
-  dailyActiveMinutes: exports_external4.number().int().positive().optional(),
-  dailyAccuracy: exports_external4.number().int().min(0).max(100).optional(),
-  dailyMasteredUnits: exports_external4.number().int().positive().optional()
-});
+  dailyXp: exports_external4.number().int().positive().meta({ description: "Target XP to earn per day" }).optional(),
+  dailyLessons: exports_external4.number().int().positive().meta({ description: "Target lessons to complete per day" }).optional(),
+  dailyActiveMinutes: exports_external4.number().int().positive().meta({ description: "Target active learning minutes per day" }).optional(),
+  dailyAccuracy: exports_external4.number().int().min(0).max(100).meta({ description: "Target accuracy percentage (0-100)" }).optional(),
+  dailyMasteredUnits: exports_external4.number().int().positive().meta({ description: "Target units to master per day" }).optional()
+}).meta({ id: "CourseGoals", description: "Daily learning goals for a course" });
 var CourseMetrics4 = exports_external4.object({
-  totalXp: exports_external4.number().int().positive().optional(),
-  totalLessons: exports_external4.number().int().positive().optional(),
-  totalGrades: exports_external4.number().int().positive().optional()
-});
+  totalXp: exports_external4.number().int().positive().meta({ description: "Total XP available in the course" }).optional(),
+  totalLessons: exports_external4.number().int().positive().meta({ description: "Total number of lessons/activities" }).optional(),
+  totalGrades: exports_external4.number().int().positive().meta({ description: "Total grade levels covered" }).optional()
+}).meta({ id: "CourseMetrics", description: "Aggregate metrics for a course" });
 var CourseMetadata4 = exports_external4.object({
   courseType: CourseType4.optional(),
-  isSupplemental: exports_external4.boolean().optional(),
-  isCustom: exports_external4.boolean().optional(),
+  isSupplemental: exports_external4.boolean().meta({ description: "Whether this is supplemental to a base course" }).optional(),
+  isCustom: exports_external4.boolean().meta({ description: "Whether this is a custom course for an individual student" }).optional(),
   publishStatus: PublishStatus4.optional(),
-  contactEmail: exports_external4.email().optional(),
-  primaryApp: exports_external4.string().optional(),
+  contactEmail: exports_external4.email().meta({ description: "Contact email for course issues" }).optional(),
+  primaryApp: exports_external4.string().meta({ description: "Primary application identifier" }).optional(),
   goals: CourseGoals4.optional(),
   metrics: CourseMetrics4.optional()
-});
+}).meta({ id: "CourseMetadata", description: "Course metadata (matches API metadata object)" });
 var CourseDefaults4 = exports_external4.object({
-  courseCode: exports_external4.string().optional(),
-  level: exports_external4.string().optional(),
+  courseCode: exports_external4.string().meta({ description: "Course code (e.g., 'MATH101')" }).optional(),
+  level: exports_external4.string().meta({ description: "Course level (e.g., 'AP', 'Honors')" }).optional(),
   metadata: CourseMetadata4.optional()
+}).meta({
+  id: "CourseDefaults",
+  description: "Default properties that apply to all courses unless overridden"
 });
 var CourseEnvOverrides4 = exports_external4.object({
-  level: exports_external4.string().optional(),
-  sensor: exports_external4.string().url().optional(),
-  launchUrl: exports_external4.string().url().optional(),
+  level: exports_external4.string().meta({ description: "Course level for this environment" }).optional(),
+  sensor: exports_external4.url().meta({ description: "Caliper sensor endpoint URL for this environment" }).optional(),
+  launchUrl: exports_external4.url().meta({ description: "LTI launch URL for this environment" }).optional(),
   metadata: CourseMetadata4.optional()
+}).meta({
+  id: "CourseEnvOverrides",
+  description: "Environment-specific course overrides (non-identity fields)"
 });
 var CourseOverrides4 = exports_external4.object({
-  staging: CourseEnvOverrides4.optional(),
-  production: CourseEnvOverrides4.optional()
-});
+  staging: CourseEnvOverrides4.meta({
+    description: "Overrides for staging environment"
+  }).optional(),
+  production: CourseEnvOverrides4.meta({
+    description: "Overrides for production environment"
+  }).optional()
+}).meta({ id: "CourseOverrides", description: "Per-environment course overrides" });
 var CourseConfig4 = CourseDefaults4.extend({
-  subject: TimebackSubject4,
-  grade: TimebackGrade4.optional(),
+  subject: TimebackSubject4.meta({ description: "Subject area for this course" }),
+  grade: TimebackGrade4.meta({
+    description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+  }).optional(),
   ids: CourseIds4.nullable().optional(),
-  sensor: exports_external4.string().url().optional(),
-  launchUrl: exports_external4.string().url().optional(),
+  sensor: exports_external4.url().meta({ description: "Caliper sensor endpoint URL for this course" }).optional(),
+  launchUrl: exports_external4.url().meta({ description: "LTI launch URL for this course" }).optional(),
   overrides: CourseOverrides4.optional()
+}).meta({
+  id: "CourseConfig",
+  description: "Configuration for a single course. Must have either grade or courseCode (or both)."
 });
 var TimebackConfig4 = exports_external4.object({
-  name: exports_external4.string().min(1, "App name is required"),
-  defaults: CourseDefaults4.optional(),
-  courses: exports_external4.array(CourseConfig4).min(1, "At least one course is required"),
-  sensor: exports_external4.string().url().optional(),
-  launchUrl: exports_external4.string().url().optional()
+  $schema: exports_external4.string().meta({ description: "JSON Schema reference for editor support" }).optional(),
+  name: exports_external4.string().min(1, "App name is required").meta({ description: "Display name for your app" }),
+  defaults: CourseDefaults4.meta({
+    description: "Default properties applied to all courses"
+  }).optional(),
+  courses: exports_external4.array(CourseConfig4).min(1, "At least one course is required").meta({ description: "Courses available in this app" }),
+  sensor: exports_external4.url().meta({ description: "Default Caliper sensor endpoint URL for all courses" }).optional(),
+  launchUrl: exports_external4.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((config22) => {
   return config22.courses.every((c) => c.grade !== undefined || c.courseCode !== undefined);
 }, {
@@ -82979,7 +83079,7 @@ var TimebackSubject5 = exports_external5.enum([
   "Math",
   "None",
   "Other"
-]);
+]).meta({ id: "TimebackSubject", description: "Subject area" });
 var TimebackGrade5 = exports_external5.union([
   exports_external5.literal(-1),
   exports_external5.literal(0),
@@ -82996,7 +83096,10 @@ var TimebackGrade5 = exports_external5.union([
   exports_external5.literal(11),
   exports_external5.literal(12),
   exports_external5.literal(13)
-]);
+]).meta({
+  id: "TimebackGrade",
+  description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+});
 var ScoreStatus5 = exports_external5.enum([
   "exempt",
   "fully graded",
@@ -83226,62 +83329,84 @@ var CaliperListEventsParams5 = exports_external5.object({
   actorEmail: exports_external5.email().optional()
 }).strict();
 var CourseIds5 = exports_external5.object({
-  staging: exports_external5.string().optional(),
-  production: exports_external5.string().optional()
-});
-var CourseType5 = exports_external5.enum(["base", "hole-filling", "optional"]);
-var PublishStatus5 = exports_external5.enum(["draft", "testing", "published", "deactivated"]);
+  staging: exports_external5.string().meta({ description: "Course ID in staging environment" }).optional(),
+  production: exports_external5.string().meta({ description: "Course ID in production environment" }).optional()
+}).meta({ id: "CourseIds", description: "Environment-specific course IDs (populated by sync)" });
+var CourseType5 = exports_external5.enum(["base", "hole-filling", "optional"]).meta({ id: "CourseType", description: "Course classification type" });
+var PublishStatus5 = exports_external5.enum(["draft", "testing", "published", "deactivated"]).meta({ id: "PublishStatus", description: "Course publication status" });
 var CourseGoals5 = exports_external5.object({
-  dailyXp: exports_external5.number().int().positive().optional(),
-  dailyLessons: exports_external5.number().int().positive().optional(),
-  dailyActiveMinutes: exports_external5.number().int().positive().optional(),
-  dailyAccuracy: exports_external5.number().int().min(0).max(100).optional(),
-  dailyMasteredUnits: exports_external5.number().int().positive().optional()
-});
+  dailyXp: exports_external5.number().int().positive().meta({ description: "Target XP to earn per day" }).optional(),
+  dailyLessons: exports_external5.number().int().positive().meta({ description: "Target lessons to complete per day" }).optional(),
+  dailyActiveMinutes: exports_external5.number().int().positive().meta({ description: "Target active learning minutes per day" }).optional(),
+  dailyAccuracy: exports_external5.number().int().min(0).max(100).meta({ description: "Target accuracy percentage (0-100)" }).optional(),
+  dailyMasteredUnits: exports_external5.number().int().positive().meta({ description: "Target units to master per day" }).optional()
+}).meta({ id: "CourseGoals", description: "Daily learning goals for a course" });
 var CourseMetrics5 = exports_external5.object({
-  totalXp: exports_external5.number().int().positive().optional(),
-  totalLessons: exports_external5.number().int().positive().optional(),
-  totalGrades: exports_external5.number().int().positive().optional()
-});
+  totalXp: exports_external5.number().int().positive().meta({ description: "Total XP available in the course" }).optional(),
+  totalLessons: exports_external5.number().int().positive().meta({ description: "Total number of lessons/activities" }).optional(),
+  totalGrades: exports_external5.number().int().positive().meta({ description: "Total grade levels covered" }).optional()
+}).meta({ id: "CourseMetrics", description: "Aggregate metrics for a course" });
 var CourseMetadata5 = exports_external5.object({
   courseType: CourseType5.optional(),
-  isSupplemental: exports_external5.boolean().optional(),
-  isCustom: exports_external5.boolean().optional(),
+  isSupplemental: exports_external5.boolean().meta({ description: "Whether this is supplemental to a base course" }).optional(),
+  isCustom: exports_external5.boolean().meta({ description: "Whether this is a custom course for an individual student" }).optional(),
   publishStatus: PublishStatus5.optional(),
-  contactEmail: exports_external5.email().optional(),
-  primaryApp: exports_external5.string().optional(),
+  contactEmail: exports_external5.email().meta({ description: "Contact email for course issues" }).optional(),
+  primaryApp: exports_external5.string().meta({ description: "Primary application identifier" }).optional(),
   goals: CourseGoals5.optional(),
   metrics: CourseMetrics5.optional()
-});
+}).meta({ id: "CourseMetadata", description: "Course metadata (matches API metadata object)" });
 var CourseDefaults5 = exports_external5.object({
-  courseCode: exports_external5.string().optional(),
-  level: exports_external5.string().optional(),
+  courseCode: exports_external5.string().meta({ description: "Course code (e.g., 'MATH101')" }).optional(),
+  level: exports_external5.string().meta({ description: "Course level (e.g., 'AP', 'Honors')" }).optional(),
   metadata: CourseMetadata5.optional()
+}).meta({
+  id: "CourseDefaults",
+  description: "Default properties that apply to all courses unless overridden"
 });
 var CourseEnvOverrides5 = exports_external5.object({
-  level: exports_external5.string().optional(),
-  sensor: exports_external5.string().url().optional(),
-  launchUrl: exports_external5.string().url().optional(),
+  level: exports_external5.string().meta({ description: "Course level for this environment" }).optional(),
+  sensor: exports_external5.url().meta({ description: "Caliper sensor endpoint URL for this environment" }).optional(),
+  launchUrl: exports_external5.url().meta({ description: "LTI launch URL for this environment" }).optional(),
   metadata: CourseMetadata5.optional()
+}).meta({
+  id: "CourseEnvOverrides",
+  description: "Environment-specific course overrides (non-identity fields)"
 });
 var CourseOverrides5 = exports_external5.object({
-  staging: CourseEnvOverrides5.optional(),
-  production: CourseEnvOverrides5.optional()
-});
+  staging: CourseEnvOverrides5.meta({
+    description: "Overrides for staging environment"
+  }).optional(),
+  production: CourseEnvOverrides5.meta({
+    description: "Overrides for production environment"
+  }).optional()
+}).meta({ id: "CourseOverrides", description: "Per-environment course overrides" });
 var CourseConfig5 = CourseDefaults5.extend({
-  subject: TimebackSubject5,
-  grade: TimebackGrade5.optional(),
+  subject: TimebackSubject5.meta({ description: "Subject area for this course" }),
+  grade: TimebackGrade5.meta({
+    description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+  }).optional(),
   ids: CourseIds5.nullable().optional(),
-  sensor: exports_external5.string().url().optional(),
-  launchUrl: exports_external5.string().url().optional(),
+  sensor: exports_external5.url().meta({ description: "Caliper sensor endpoint URL for this course" }).optional(),
+  launchUrl: exports_external5.url().meta({ description: "LTI launch URL for this course" }).optional(),
   overrides: CourseOverrides5.optional()
+}).meta({
+  id: "CourseConfig",
+  description: "Configuration for a single course. Must have either grade or courseCode (or both)."
 });
 var TimebackConfig5 = exports_external5.object({
-  name: exports_external5.string().min(1, "App name is required"),
-  defaults: CourseDefaults5.optional(),
-  courses: exports_external5.array(CourseConfig5).min(1, "At least one course is required"),
-  sensor: exports_external5.string().url().optional(),
-  launchUrl: exports_external5.string().url().optional()
+  $schema: exports_external5.string().meta({ description: "JSON Schema reference for editor support" }).optional(),
+  name: exports_external5.string().min(1, "App name is required").meta({ description: "Display name for your app" }),
+  defaults: CourseDefaults5.meta({
+    description: "Default properties applied to all courses"
+  }).optional(),
+  courses: exports_external5.array(CourseConfig5).min(1, "At least one course is required").meta({ description: "Courses available in this app" }),
+  sensor: exports_external5.url().meta({ description: "Default Caliper sensor endpoint URL for all courses" }).optional(),
+  launchUrl: exports_external5.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((config22) => {
   return config22.courses.every((c) => c.grade !== undefined || c.courseCode !== undefined);
 }, {
@@ -85060,8 +85185,8 @@ var {
 
 // ../internal/cli-infra/src/config/timeback.ts
 import { existsSync } from "node:fs";
-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
 import { z as z6 } from "zod/v4";
@@ -85079,7 +85204,7 @@ var TimebackSubject6 = z6.enum([
   "Math",
   "None",
   "Other"
-]);
+]).meta({ id: "TimebackSubject", description: "Subject area" });
 var TimebackGrade6 = z6.union([
   z6.literal(-1),
   z6.literal(0),
@@ -85096,7 +85221,10 @@ var TimebackGrade6 = z6.union([
   z6.literal(11),
   z6.literal(12),
   z6.literal(13)
-]);
+]).meta({
+  id: "TimebackGrade",
+  description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+});
 var ScoreStatus6 = z6.enum([
   "exempt",
   "fully graded",
@@ -85330,62 +85458,84 @@ var CaliperListEventsParams6 = z8.object({
 // ../types/src/zod/config.ts
 import { z as z9 } from "zod/v4";
 var CourseIds6 = z9.object({
-  staging: z9.string().optional(),
-  production: z9.string().optional()
-});
-var CourseType6 = z9.enum(["base", "hole-filling", "optional"]);
-var PublishStatus6 = z9.enum(["draft", "testing", "published", "deactivated"]);
+  staging: z9.string().meta({ description: "Course ID in staging environment" }).optional(),
+  production: z9.string().meta({ description: "Course ID in production environment" }).optional()
+}).meta({ id: "CourseIds", description: "Environment-specific course IDs (populated by sync)" });
+var CourseType6 = z9.enum(["base", "hole-filling", "optional"]).meta({ id: "CourseType", description: "Course classification type" });
+var PublishStatus6 = z9.enum(["draft", "testing", "published", "deactivated"]).meta({ id: "PublishStatus", description: "Course publication status" });
 var CourseGoals6 = z9.object({
-  dailyXp: z9.number().int().positive().optional(),
-  dailyLessons: z9.number().int().positive().optional(),
-  dailyActiveMinutes: z9.number().int().positive().optional(),
-  dailyAccuracy: z9.number().int().min(0).max(100).optional(),
-  dailyMasteredUnits: z9.number().int().positive().optional()
-});
+  dailyXp: z9.number().int().positive().meta({ description: "Target XP to earn per day" }).optional(),
+  dailyLessons: z9.number().int().positive().meta({ description: "Target lessons to complete per day" }).optional(),
+  dailyActiveMinutes: z9.number().int().positive().meta({ description: "Target active learning minutes per day" }).optional(),
+  dailyAccuracy: z9.number().int().min(0).max(100).meta({ description: "Target accuracy percentage (0-100)" }).optional(),
+  dailyMasteredUnits: z9.number().int().positive().meta({ description: "Target units to master per day" }).optional()
+}).meta({ id: "CourseGoals", description: "Daily learning goals for a course" });
 var CourseMetrics6 = z9.object({
-  totalXp: z9.number().int().positive().optional(),
-  totalLessons: z9.number().int().positive().optional(),
-  totalGrades: z9.number().int().positive().optional()
-});
+  totalXp: z9.number().int().positive().meta({ description: "Total XP available in the course" }).optional(),
+  totalLessons: z9.number().int().positive().meta({ description: "Total number of lessons/activities" }).optional(),
+  totalGrades: z9.number().int().positive().meta({ description: "Total grade levels covered" }).optional()
+}).meta({ id: "CourseMetrics", description: "Aggregate metrics for a course" });
 var CourseMetadata6 = z9.object({
   courseType: CourseType6.optional(),
-  isSupplemental: z9.boolean().optional(),
-  isCustom: z9.boolean().optional(),
+  isSupplemental: z9.boolean().meta({ description: "Whether this is supplemental to a base course" }).optional(),
+  isCustom: z9.boolean().meta({ description: "Whether this is a custom course for an individual student" }).optional(),
   publishStatus: PublishStatus6.optional(),
-  contactEmail: z9.email().optional(),
-  primaryApp: z9.string().optional(),
+  contactEmail: z9.email().meta({ description: "Contact email for course issues" }).optional(),
+  primaryApp: z9.string().meta({ description: "Primary application identifier" }).optional(),
   goals: CourseGoals6.optional(),
   metrics: CourseMetrics6.optional()
-});
+}).meta({ id: "CourseMetadata", description: "Course metadata (matches API metadata object)" });
 var CourseDefaults6 = z9.object({
-  courseCode: z9.string().optional(),
-  level: z9.string().optional(),
+  courseCode: z9.string().meta({ description: "Course code (e.g., 'MATH101')" }).optional(),
+  level: z9.string().meta({ description: "Course level (e.g., 'AP', 'Honors')" }).optional(),
   metadata: CourseMetadata6.optional()
+}).meta({
+  id: "CourseDefaults",
+  description: "Default properties that apply to all courses unless overridden"
 });
 var CourseEnvOverrides6 = z9.object({
-  level: z9.string().optional(),
-  sensor: z9.string().url().optional(),
-  launchUrl: z9.string().url().optional(),
+  level: z9.string().meta({ description: "Course level for this environment" }).optional(),
+  sensor: z9.url().meta({ description: "Caliper sensor endpoint URL for this environment" }).optional(),
+  launchUrl: z9.url().meta({ description: "LTI launch URL for this environment" }).optional(),
   metadata: CourseMetadata6.optional()
+}).meta({
+  id: "CourseEnvOverrides",
+  description: "Environment-specific course overrides (non-identity fields)"
 });
 var CourseOverrides6 = z9.object({
-  staging: CourseEnvOverrides6.optional(),
-  production: CourseEnvOverrides6.optional()
-});
+  staging: CourseEnvOverrides6.meta({
+    description: "Overrides for staging environment"
+  }).optional(),
+  production: CourseEnvOverrides6.meta({
+    description: "Overrides for production environment"
+  }).optional()
+}).meta({ id: "CourseOverrides", description: "Per-environment course overrides" });
 var CourseConfig6 = CourseDefaults6.extend({
-  subject: TimebackSubject6,
-  grade: TimebackGrade6.optional(),
+  subject: TimebackSubject6.meta({ description: "Subject area for this course" }),
+  grade: TimebackGrade6.meta({
+    description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+  }).optional(),
   ids: CourseIds6.nullable().optional(),
-  sensor: z9.string().url().optional(),
-  launchUrl: z9.string().url().optional(),
+  sensor: z9.url().meta({ description: "Caliper sensor endpoint URL for this course" }).optional(),
+  launchUrl: z9.url().meta({ description: "LTI launch URL for this course" }).optional(),
   overrides: CourseOverrides6.optional()
+}).meta({
+  id: "CourseConfig",
+  description: "Configuration for a single course. Must have either grade or courseCode (or both)."
 });
 var TimebackConfig6 = z9.object({
-  name: z9.string().min(1, "App name is required"),
-  defaults: CourseDefaults6.optional(),
-  courses: z9.array(CourseConfig6).min(1, "At least one course is required"),
-  sensor: z9.string().url().optional(),
-  launchUrl: z9.string().url().optional()
+  $schema: z9.string().meta({ description: "JSON Schema reference for editor support" }).optional(),
+  name: z9.string().min(1, "App name is required").meta({ description: "Display name for your app" }),
+  defaults: CourseDefaults6.meta({
+    description: "Default properties applied to all courses"
+  }).optional(),
+  courses: z9.array(CourseConfig6).min(1, "At least one course is required").meta({ description: "Courses available in this app" }),
+  sensor: z9.url().meta({ description: "Default Caliper sensor endpoint URL for all courses" }).optional(),
+  launchUrl: z9.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((config6) => {
   return config6.courses.every((c) => c.grade !== undefined || c.courseCode !== undefined);
 }, {
@@ -86433,94 +86583,88 @@ var CREDENTIALS_DIR = getConfigDir();
 var CREDENTIALS_FILE = join(CREDENTIALS_DIR, "credentials.json");
 
 // ../internal/cli-infra/src/config/timeback.ts
-var FILE_PATTERNS = ["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";
+function isJsonConfigPath(configPath) {
+  return extname(configPath).toLowerCase() === ".json";
+}
+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 loadConfig(opts = {}) {
   const cwd = process.cwd();
-  let rawConfig = null;
-  let foundPath = null;
-  let loadError = null;
-  if (opts.configPath) {
-    const fullPath = resolve(cwd, opts.configPath);
-    if (!existsSync(fullPath)) {
+  try {
+    if (opts.configPath && !isJsonConfigPath(opts.configPath)) {
       return {
         success: false,
-        error: `Config file not found: ${opts.configPath}`
+        error: `Config file must be JSON (.json): ${opts.configPath}`
       };
     }
-    try {
-      rawConfig = await importModule(fullPath);
-      foundPath = fullPath;
-    } catch (err) {
+    if (opts.configPath) {
+      const fullPath = resolve(cwd, opts.configPath);
+      if (!existsSync(fullPath)) {
+        return {
+          success: false,
+          error: `Config file not found: ${opts.configPath}`
+        };
+      }
+    }
+    const loaded = await loadWithC12(cwd, opts.configPath);
+    if (!loaded) {
       return {
         success: false,
-        error: `Failed to load ${opts.configPath}:
-${err instanceof Error ? err.message : String(err)}`
+        error: `No timeback config found. Run ${greenBright("timeback init")} to create one.`
       };
     }
-  } else {
-    for (const filename of FILE_PATTERNS) {
-      const fullPath = resolve(cwd, filename);
-      if (!existsSync(fullPath))
-        continue;
-      try {
-        rawConfig = await importModule(fullPath);
-        foundPath = fullPath;
-        break;
-      } catch (err) {
-        loadError = err instanceof Error ? err : new Error(String(err));
-        foundPath = fullPath;
-        break;
-      }
+    const result = TimebackConfig6.safeParse(loaded.config);
+    if (!result.success) {
+      const issues = result.error.issues.map((issue4) => `  - ${issue4.path.join(".")}: ${issue4.message}`).join(`
+`);
+      return {
+        success: false,
+        error: `Invalid config in ${basename(loaded.configFile)}:
+${issues}`
+      };
     }
-  }
-  if (loadError && foundPath) {
     return {
-      success: false,
-      error: `Failed to load ${basename(foundPath)}:
-${loadError.message}`
+      success: true,
+      config: result.data,
+      configPath: loaded.configFile
     };
-  }
-  if (!rawConfig || !foundPath) {
-    return {
-      success: false,
-      error: `No timeback config found. Run ${greenBright("timeback init")} to create one.`
-    };
-  }
-  const result = TimebackConfig6.safeParse(rawConfig);
-  if (!result.success) {
-    const issues = result.error.issues.map((issue4) => `  - ${issue4.path.join(".")}: ${issue4.message}`).join(`
-`);
+  } catch (err) {
+    const filename = opts.configPath ? basename(opts.configPath) : CONFIG_FILENAME;
     return {
       success: false,
-      error: `Invalid config in ${basename(foundPath)}:
-${issues}`
+      error: `Failed to load ${filename}:
+${err instanceof Error ? err.message : String(err)}`
     };
   }
-  return {
-    success: true,
-    config: result.data,
-    configPath: foundPath
-  };
 }
 // src/shared/constants.ts
 var ROUTES = {
@@ -102317,7 +102461,7 @@ var TimebackSubject8 = exports_external6.enum([
   "Math",
   "None",
   "Other"
-]);
+]).meta({ id: "TimebackSubject", description: "Subject area" });
 var TimebackGrade8 = exports_external6.union([
   exports_external6.literal(-1),
   exports_external6.literal(0),
@@ -102334,7 +102478,10 @@ var TimebackGrade8 = exports_external6.union([
   exports_external6.literal(11),
   exports_external6.literal(12),
   exports_external6.literal(13)
-]);
+]).meta({
+  id: "TimebackGrade",
+  description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+});
 var ScoreStatus8 = exports_external6.enum([
   "exempt",
   "fully graded",
@@ -102564,62 +102711,84 @@ var CaliperListEventsParams8 = exports_external6.object({
   actorEmail: exports_external6.email().optional()
 }).strict();
 var CourseIds8 = exports_external6.object({
-  staging: exports_external6.string().optional(),
-  production: exports_external6.string().optional()
-});
-var CourseType8 = exports_external6.enum(["base", "hole-filling", "optional"]);
-var PublishStatus8 = exports_external6.enum(["draft", "testing", "published", "deactivated"]);
+  staging: exports_external6.string().meta({ description: "Course ID in staging environment" }).optional(),
+  production: exports_external6.string().meta({ description: "Course ID in production environment" }).optional()
+}).meta({ id: "CourseIds", description: "Environment-specific course IDs (populated by sync)" });
+var CourseType8 = exports_external6.enum(["base", "hole-filling", "optional"]).meta({ id: "CourseType", description: "Course classification type" });
+var PublishStatus8 = exports_external6.enum(["draft", "testing", "published", "deactivated"]).meta({ id: "PublishStatus", description: "Course publication status" });
 var CourseGoals8 = exports_external6.object({
-  dailyXp: exports_external6.number().int().positive().optional(),
-  dailyLessons: exports_external6.number().int().positive().optional(),
-  dailyActiveMinutes: exports_external6.number().int().positive().optional(),
-  dailyAccuracy: exports_external6.number().int().min(0).max(100).optional(),
-  dailyMasteredUnits: exports_external6.number().int().positive().optional()
-});
+  dailyXp: exports_external6.number().int().positive().meta({ description: "Target XP to earn per day" }).optional(),
+  dailyLessons: exports_external6.number().int().positive().meta({ description: "Target lessons to complete per day" }).optional(),
+  dailyActiveMinutes: exports_external6.number().int().positive().meta({ description: "Target active learning minutes per day" }).optional(),
+  dailyAccuracy: exports_external6.number().int().min(0).max(100).meta({ description: "Target accuracy percentage (0-100)" }).optional(),
+  dailyMasteredUnits: exports_external6.number().int().positive().meta({ description: "Target units to master per day" }).optional()
+}).meta({ id: "CourseGoals", description: "Daily learning goals for a course" });
 var CourseMetrics8 = exports_external6.object({
-  totalXp: exports_external6.number().int().positive().optional(),
-  totalLessons: exports_external6.number().int().positive().optional(),
-  totalGrades: exports_external6.number().int().positive().optional()
-});
+  totalXp: exports_external6.number().int().positive().meta({ description: "Total XP available in the course" }).optional(),
+  totalLessons: exports_external6.number().int().positive().meta({ description: "Total number of lessons/activities" }).optional(),
+  totalGrades: exports_external6.number().int().positive().meta({ description: "Total grade levels covered" }).optional()
+}).meta({ id: "CourseMetrics", description: "Aggregate metrics for a course" });
 var CourseMetadata8 = exports_external6.object({
   courseType: CourseType8.optional(),
-  isSupplemental: exports_external6.boolean().optional(),
-  isCustom: exports_external6.boolean().optional(),
+  isSupplemental: exports_external6.boolean().meta({ description: "Whether this is supplemental to a base course" }).optional(),
+  isCustom: exports_external6.boolean().meta({ description: "Whether this is a custom course for an individual student" }).optional(),
   publishStatus: PublishStatus8.optional(),
-  contactEmail: exports_external6.email().optional(),
-  primaryApp: exports_external6.string().optional(),
+  contactEmail: exports_external6.email().meta({ description: "Contact email for course issues" }).optional(),
+  primaryApp: exports_external6.string().meta({ description: "Primary application identifier" }).optional(),
   goals: CourseGoals8.optional(),
   metrics: CourseMetrics8.optional()
-});
+}).meta({ id: "CourseMetadata", description: "Course metadata (matches API metadata object)" });
 var CourseDefaults8 = exports_external6.object({
-  courseCode: exports_external6.string().optional(),
-  level: exports_external6.string().optional(),
+  courseCode: exports_external6.string().meta({ description: "Course code (e.g., 'MATH101')" }).optional(),
+  level: exports_external6.string().meta({ description: "Course level (e.g., 'AP', 'Honors')" }).optional(),
   metadata: CourseMetadata8.optional()
+}).meta({
+  id: "CourseDefaults",
+  description: "Default properties that apply to all courses unless overridden"
 });
 var CourseEnvOverrides8 = exports_external6.object({
-  level: exports_external6.string().optional(),
-  sensor: exports_external6.string().url().optional(),
-  launchUrl: exports_external6.string().url().optional(),
+  level: exports_external6.string().meta({ description: "Course level for this environment" }).optional(),
+  sensor: exports_external6.url().meta({ description: "Caliper sensor endpoint URL for this environment" }).optional(),
+  launchUrl: exports_external6.url().meta({ description: "LTI launch URL for this environment" }).optional(),
   metadata: CourseMetadata8.optional()
+}).meta({
+  id: "CourseEnvOverrides",
+  description: "Environment-specific course overrides (non-identity fields)"
 });
 var CourseOverrides8 = exports_external6.object({
-  staging: CourseEnvOverrides8.optional(),
-  production: CourseEnvOverrides8.optional()
-});
+  staging: CourseEnvOverrides8.meta({
+    description: "Overrides for staging environment"
+  }).optional(),
+  production: CourseEnvOverrides8.meta({
+    description: "Overrides for production environment"
+  }).optional()
+}).meta({ id: "CourseOverrides", description: "Per-environment course overrides" });
 var CourseConfig8 = CourseDefaults8.extend({
-  subject: TimebackSubject8,
-  grade: TimebackGrade8.optional(),
+  subject: TimebackSubject8.meta({ description: "Subject area for this course" }),
+  grade: TimebackGrade8.meta({
+    description: "Grade level (-1 = Pre-K, 0 = K, 1-12 = grades, 13 = AP)"
+  }).optional(),
   ids: CourseIds8.nullable().optional(),
-  sensor: exports_external6.string().url().optional(),
-  launchUrl: exports_external6.string().url().optional(),
+  sensor: exports_external6.url().meta({ description: "Caliper sensor endpoint URL for this course" }).optional(),
+  launchUrl: exports_external6.url().meta({ description: "LTI launch URL for this course" }).optional(),
   overrides: CourseOverrides8.optional()
+}).meta({
+  id: "CourseConfig",
+  description: "Configuration for a single course. Must have either grade or courseCode (or both)."
 });
 var TimebackConfig8 = exports_external6.object({
-  name: exports_external6.string().min(1, "App name is required"),
-  defaults: CourseDefaults8.optional(),
-  courses: exports_external6.array(CourseConfig8).min(1, "At least one course is required"),
-  sensor: exports_external6.string().url().optional(),
-  launchUrl: exports_external6.string().url().optional()
+  $schema: exports_external6.string().meta({ description: "JSON Schema reference for editor support" }).optional(),
+  name: exports_external6.string().min(1, "App name is required").meta({ description: "Display name for your app" }),
+  defaults: CourseDefaults8.meta({
+    description: "Default properties applied to all courses"
+  }).optional(),
+  courses: exports_external6.array(CourseConfig8).min(1, "At least one course is required").meta({ description: "Courses available in this app" }),
+  sensor: exports_external6.url().meta({ description: "Default Caliper sensor endpoint URL for all courses" }).optional(),
+  launchUrl: exports_external6.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((config22) => {
   return config22.courses.every((c) => c.grade !== undefined || c.courseCode !== undefined);
 }, {
@@ -103992,7 +104161,7 @@ function validateActivityRequest(body, appConfig, env2) {
       log11.error("Ambiguous course selector", { selector: payload.course });
       return {
         ok: false,
-        response: jsonResponse({ success: false, error: "Ambiguous course selector in timeback.config.ts" }, 500)
+        response: jsonResponse({ success: false, error: "Ambiguous course selector in timeback.config.json" }, 500)
       };
     }
     throw err;
@@ -104006,7 +104175,7 @@ function validateActivityRequest(body, appConfig, env2) {
       ok: false,
       response: jsonResponse({
         success: false,
-        error: `Course "${selectorDesc}" has no sensor configured. Set 'courses[].overrides.${envForOverrides}.sensor', 'courses[].sensor', or top-level 'sensor' in timeback.config.ts.`
+        error: `Course "${selectorDesc}" has no sensor configured. Set 'courses[].overrides.${envForOverrides}.sensor', 'courses[].sensor', or top-level 'sensor' in timeback.config.json.`
       }, 500)
     };
   }