@thanh01.pmt/domain-kit 0.3.0 → 0.5.0

package/dist/curriculumFeedEmitter-T7NUBLAM.mjs

@@ -0,0 +1,4 @@
+export { emitCurriculumFeed } from './chunk-TWKIVUTQ.mjs';
+import './chunk-E4GCCWJO.mjs';
+//# sourceMappingURL=curriculumFeedEmitter-T7NUBLAM.mjs.map
+//# sourceMappingURL=curriculumFeedEmitter-T7NUBLAM.mjs.map

package/dist/{curriculumFeedEmitter-FYAWMPE6.mjs.map → curriculumFeedEmitter-T7NUBLAM.mjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"curriculumFeedEmitter-FYAWMPE6.mjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"curriculumFeedEmitter-T7NUBLAM.mjs"}

package/dist/{curriculumFeedSchema-C8ZP3XMi.d.ts → curriculumFeedSchema-DUFwFyr2.d.cts}

@@ -105,6 +105,50 @@ declare const FeedNodeSchema: z.ZodObject<{
     }>, "many">>;
     feature_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     concept_ref: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    user_visible_deliverable: z.ZodDefault<z.ZodString>;
+    depth_variants: z.ZodOptional<z.ZodObject<{
+        ulo: z.ZodNumber;
+        cio: z.ZodNumber;
+        sio: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        ulo: number;
+        cio: number;
+        sio: number;
+    }, {
+        ulo: number;
+        cio: number;
+        sio: number;
+    }>>;
+    depth_scaffold_candidates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        from_depth: z.ZodEnum<["ulo", "cio", "sio"]>;
+        to_depth: z.ZodEnum<["ulo", "cio", "sio"]>;
+        minutes_saved: z.ZodNumber;
+        reason: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        reason: string;
+        minutes_saved: number;
+        from_depth: "ulo" | "cio" | "sio";
+        to_depth: "ulo" | "cio" | "sio";
+    }, {
+        minutes_saved: number;
+        from_depth: "ulo" | "cio" | "sio";
+        to_depth: "ulo" | "cio" | "sio";
+        reason?: string | undefined;
+    }>, "many">>;
+    is_core: z.ZodDefault<z.ZodBoolean>;
+    depth_context: z.ZodOptional<z.ZodObject<{
+        ulo: z.ZodDefault<z.ZodString>;
+        cio: z.ZodDefault<z.ZodString>;
+        sio: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        ulo: string;
+        cio: string;
+        sio: string[];
+    }, {
+        ulo?: string | undefined;
+        cio?: string | undefined;
+        sio?: string[] | undefined;
+    }>>;
     phase_id: z.ZodDefault<z.ZodString>;
     introduce_aspect: z.ZodDefault<z.ZodNullable<z.ZodEnum<["new", "advanced", "preview"]>>>;
 }, "strip", z.ZodTypeAny, {
@@ -137,7 +181,25 @@ declare const FeedNodeSchema: z.ZodObject<{
         file: string;
     }[];
     concept_ref: string | null;
+    user_visible_deliverable: string;
+    is_core: boolean;
     introduce_aspect: "new" | "advanced" | "preview" | null;
+    depth_variants?: {
+        ulo: number;
+        cio: number;
+        sio: number;
+    } | undefined;
+    depth_scaffold_candidates?: {
+        reason: string;
+        minutes_saved: number;
+        from_depth: "ulo" | "cio" | "sio";
+        to_depth: "ulo" | "cio" | "sio";
+    }[] | undefined;
+    depth_context?: {
+        ulo: string;
+        cio: string;
+        sio: string[];
+    } | undefined;
 }, {
     estimated_minutes: number;
     id: string;
@@ -168,6 +230,24 @@ declare const FeedNodeSchema: z.ZodObject<{
         evidence?: string | undefined;
     }[] | undefined;
     concept_ref?: string | null | undefined;
+    user_visible_deliverable?: string | undefined;
+    depth_variants?: {
+        ulo: number;
+        cio: number;
+        sio: number;
+    } | undefined;
+    depth_scaffold_candidates?: {
+        minutes_saved: number;
+        from_depth: "ulo" | "cio" | "sio";
+        to_depth: "ulo" | "cio" | "sio";
+        reason?: string | undefined;
+    }[] | undefined;
+    is_core?: boolean | undefined;
+    depth_context?: {
+        ulo?: string | undefined;
+        cio?: string | undefined;
+        sio?: string[] | undefined;
+    } | undefined;
     introduce_aspect?: "new" | "advanced" | "preview" | null | undefined;
 }>;
 declare const FeedEdgeSchema: z.ZodObject<{
@@ -306,6 +386,50 @@ declare const CurriculumFeedSchema: z.ZodObject<{
         }>, "many">>;
         feature_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         concept_ref: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        user_visible_deliverable: z.ZodDefault<z.ZodString>;
+        depth_variants: z.ZodOptional<z.ZodObject<{
+            ulo: z.ZodNumber;
+            cio: z.ZodNumber;
+            sio: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            ulo: number;
+            cio: number;
+            sio: number;
+        }, {
+            ulo: number;
+            cio: number;
+            sio: number;
+        }>>;
+        depth_scaffold_candidates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            from_depth: z.ZodEnum<["ulo", "cio", "sio"]>;
+            to_depth: z.ZodEnum<["ulo", "cio", "sio"]>;
+            minutes_saved: z.ZodNumber;
+            reason: z.ZodDefault<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            reason: string;
+            minutes_saved: number;
+            from_depth: "ulo" | "cio" | "sio";
+            to_depth: "ulo" | "cio" | "sio";
+        }, {
+            minutes_saved: number;
+            from_depth: "ulo" | "cio" | "sio";
+            to_depth: "ulo" | "cio" | "sio";
+            reason?: string | undefined;
+        }>, "many">>;
+        is_core: z.ZodDefault<z.ZodBoolean>;
+        depth_context: z.ZodOptional<z.ZodObject<{
+            ulo: z.ZodDefault<z.ZodString>;
+            cio: z.ZodDefault<z.ZodString>;
+            sio: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            ulo: string;
+            cio: string;
+            sio: string[];
+        }, {
+            ulo?: string | undefined;
+            cio?: string | undefined;
+            sio?: string[] | undefined;
+        }>>;
         phase_id: z.ZodDefault<z.ZodString>;
         introduce_aspect: z.ZodDefault<z.ZodNullable<z.ZodEnum<["new", "advanced", "preview"]>>>;
     }, "strip", z.ZodTypeAny, {
@@ -338,7 +462,25 @@ declare const CurriculumFeedSchema: z.ZodObject<{
             file: string;
         }[];
         concept_ref: string | null;
+        user_visible_deliverable: string;
+        is_core: boolean;
         introduce_aspect: "new" | "advanced" | "preview" | null;
+        depth_variants?: {
+            ulo: number;
+            cio: number;
+            sio: number;
+        } | undefined;
+        depth_scaffold_candidates?: {
+            reason: string;
+            minutes_saved: number;
+            from_depth: "ulo" | "cio" | "sio";
+            to_depth: "ulo" | "cio" | "sio";
+        }[] | undefined;
+        depth_context?: {
+            ulo: string;
+            cio: string;
+            sio: string[];
+        } | undefined;
     }, {
         estimated_minutes: number;
         id: string;
@@ -369,6 +511,24 @@ declare const CurriculumFeedSchema: z.ZodObject<{
             evidence?: string | undefined;
         }[] | undefined;
         concept_ref?: string | null | undefined;
+        user_visible_deliverable?: string | undefined;
+        depth_variants?: {
+            ulo: number;
+            cio: number;
+            sio: number;
+        } | undefined;
+        depth_scaffold_candidates?: {
+            minutes_saved: number;
+            from_depth: "ulo" | "cio" | "sio";
+            to_depth: "ulo" | "cio" | "sio";
+            reason?: string | undefined;
+        }[] | undefined;
+        is_core?: boolean | undefined;
+        depth_context?: {
+            ulo?: string | undefined;
+            cio?: string | undefined;
+            sio?: string[] | undefined;
+        } | undefined;
         introduce_aspect?: "new" | "advanced" | "preview" | null | undefined;
     }>, "many">;
     dependency_edges: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -466,7 +626,25 @@ declare const CurriculumFeedSchema: z.ZodObject<{
             file: string;
         }[];
         concept_ref: string | null;
+        user_visible_deliverable: string;
+        is_core: boolean;
         introduce_aspect: "new" | "advanced" | "preview" | null;
+        depth_variants?: {
+            ulo: number;
+            cio: number;
+            sio: number;
+        } | undefined;
+        depth_scaffold_candidates?: {
+            reason: string;
+            minutes_saved: number;
+            from_depth: "ulo" | "cio" | "sio";
+            to_depth: "ulo" | "cio" | "sio";
+        }[] | undefined;
+        depth_context?: {
+            ulo: string;
+            cio: string;
+            sio: string[];
+        } | undefined;
     }[];
     dependency_edges: {
         from: string;
@@ -517,6 +695,24 @@ declare const CurriculumFeedSchema: z.ZodObject<{
             evidence?: string | undefined;
         }[] | undefined;
         concept_ref?: string | null | undefined;
+        user_visible_deliverable?: string | undefined;
+        depth_variants?: {
+            ulo: number;
+            cio: number;
+            sio: number;
+        } | undefined;
+        depth_scaffold_candidates?: {
+            minutes_saved: number;
+            from_depth: "ulo" | "cio" | "sio";
+            to_depth: "ulo" | "cio" | "sio";
+            reason?: string | undefined;
+        }[] | undefined;
+        is_core?: boolean | undefined;
+        depth_context?: {
+            ulo?: string | undefined;
+            cio?: string | undefined;
+            sio?: string[] | undefined;
+        } | undefined;
         introduce_aspect?: "new" | "advanced" | "preview" | null | undefined;
     }[];
     phases?: {

package/dist/{curriculumFeedSchema-C8ZP3XMi.d.cts → curriculumFeedSchema-DUFwFyr2.d.ts}

@@ -105,6 +105,50 @@ declare const FeedNodeSchema: z.ZodObject<{
     }>, "many">>;
     feature_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     concept_ref: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    user_visible_deliverable: z.ZodDefault<z.ZodString>;
+    depth_variants: z.ZodOptional<z.ZodObject<{
+        ulo: z.ZodNumber;
+        cio: z.ZodNumber;
+        sio: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        ulo: number;
+        cio: number;
+        sio: number;
+    }, {
+        ulo: number;
+        cio: number;
+        sio: number;
+    }>>;
+    depth_scaffold_candidates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        from_depth: z.ZodEnum<["ulo", "cio", "sio"]>;
+        to_depth: z.ZodEnum<["ulo", "cio", "sio"]>;
+        minutes_saved: z.ZodNumber;
+        reason: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        reason: string;
+        minutes_saved: number;
+        from_depth: "ulo" | "cio" | "sio";
+        to_depth: "ulo" | "cio" | "sio";
+    }, {
+        minutes_saved: number;
+        from_depth: "ulo" | "cio" | "sio";
+        to_depth: "ulo" | "cio" | "sio";
+        reason?: string | undefined;
+    }>, "many">>;
+    is_core: z.ZodDefault<z.ZodBoolean>;
+    depth_context: z.ZodOptional<z.ZodObject<{
+        ulo: z.ZodDefault<z.ZodString>;
+        cio: z.ZodDefault<z.ZodString>;
+        sio: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        ulo: string;
+        cio: string;
+        sio: string[];
+    }, {
+        ulo?: string | undefined;
+        cio?: string | undefined;
+        sio?: string[] | undefined;
+    }>>;
     phase_id: z.ZodDefault<z.ZodString>;
     introduce_aspect: z.ZodDefault<z.ZodNullable<z.ZodEnum<["new", "advanced", "preview"]>>>;
 }, "strip", z.ZodTypeAny, {
@@ -137,7 +181,25 @@ declare const FeedNodeSchema: z.ZodObject<{
         file: string;
     }[];
     concept_ref: string | null;
+    user_visible_deliverable: string;
+    is_core: boolean;
     introduce_aspect: "new" | "advanced" | "preview" | null;
+    depth_variants?: {
+        ulo: number;
+        cio: number;
+        sio: number;
+    } | undefined;
+    depth_scaffold_candidates?: {
+        reason: string;
+        minutes_saved: number;
+        from_depth: "ulo" | "cio" | "sio";
+        to_depth: "ulo" | "cio" | "sio";
+    }[] | undefined;
+    depth_context?: {
+        ulo: string;
+        cio: string;
+        sio: string[];
+    } | undefined;
 }, {
     estimated_minutes: number;
     id: string;
@@ -168,6 +230,24 @@ declare const FeedNodeSchema: z.ZodObject<{
         evidence?: string | undefined;
     }[] | undefined;
     concept_ref?: string | null | undefined;
+    user_visible_deliverable?: string | undefined;
+    depth_variants?: {
+        ulo: number;
+        cio: number;
+        sio: number;
+    } | undefined;
+    depth_scaffold_candidates?: {
+        minutes_saved: number;
+        from_depth: "ulo" | "cio" | "sio";
+        to_depth: "ulo" | "cio" | "sio";
+        reason?: string | undefined;
+    }[] | undefined;
+    is_core?: boolean | undefined;
+    depth_context?: {
+        ulo?: string | undefined;
+        cio?: string | undefined;
+        sio?: string[] | undefined;
+    } | undefined;
     introduce_aspect?: "new" | "advanced" | "preview" | null | undefined;
 }>;
 declare const FeedEdgeSchema: z.ZodObject<{
@@ -306,6 +386,50 @@ declare const CurriculumFeedSchema: z.ZodObject<{
         }>, "many">>;
         feature_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         concept_ref: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        user_visible_deliverable: z.ZodDefault<z.ZodString>;
+        depth_variants: z.ZodOptional<z.ZodObject<{
+            ulo: z.ZodNumber;
+            cio: z.ZodNumber;
+            sio: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            ulo: number;
+            cio: number;
+            sio: number;
+        }, {
+            ulo: number;
+            cio: number;
+            sio: number;
+        }>>;
+        depth_scaffold_candidates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            from_depth: z.ZodEnum<["ulo", "cio", "sio"]>;
+            to_depth: z.ZodEnum<["ulo", "cio", "sio"]>;
+            minutes_saved: z.ZodNumber;
+            reason: z.ZodDefault<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            reason: string;
+            minutes_saved: number;
+            from_depth: "ulo" | "cio" | "sio";
+            to_depth: "ulo" | "cio" | "sio";
+        }, {
+            minutes_saved: number;
+            from_depth: "ulo" | "cio" | "sio";
+            to_depth: "ulo" | "cio" | "sio";
+            reason?: string | undefined;
+        }>, "many">>;
+        is_core: z.ZodDefault<z.ZodBoolean>;
+        depth_context: z.ZodOptional<z.ZodObject<{
+            ulo: z.ZodDefault<z.ZodString>;
+            cio: z.ZodDefault<z.ZodString>;
+            sio: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            ulo: string;
+            cio: string;
+            sio: string[];
+        }, {
+            ulo?: string | undefined;
+            cio?: string | undefined;
+            sio?: string[] | undefined;
+        }>>;
         phase_id: z.ZodDefault<z.ZodString>;
         introduce_aspect: z.ZodDefault<z.ZodNullable<z.ZodEnum<["new", "advanced", "preview"]>>>;
     }, "strip", z.ZodTypeAny, {
@@ -338,7 +462,25 @@ declare const CurriculumFeedSchema: z.ZodObject<{
             file: string;
         }[];
         concept_ref: string | null;
+        user_visible_deliverable: string;
+        is_core: boolean;
         introduce_aspect: "new" | "advanced" | "preview" | null;
+        depth_variants?: {
+            ulo: number;
+            cio: number;
+            sio: number;
+        } | undefined;
+        depth_scaffold_candidates?: {
+            reason: string;
+            minutes_saved: number;
+            from_depth: "ulo" | "cio" | "sio";
+            to_depth: "ulo" | "cio" | "sio";
+        }[] | undefined;
+        depth_context?: {
+            ulo: string;
+            cio: string;
+            sio: string[];
+        } | undefined;
     }, {
         estimated_minutes: number;
         id: string;
@@ -369,6 +511,24 @@ declare const CurriculumFeedSchema: z.ZodObject<{
             evidence?: string | undefined;
         }[] | undefined;
         concept_ref?: string | null | undefined;
+        user_visible_deliverable?: string | undefined;
+        depth_variants?: {
+            ulo: number;
+            cio: number;
+            sio: number;
+        } | undefined;
+        depth_scaffold_candidates?: {
+            minutes_saved: number;
+            from_depth: "ulo" | "cio" | "sio";
+            to_depth: "ulo" | "cio" | "sio";
+            reason?: string | undefined;
+        }[] | undefined;
+        is_core?: boolean | undefined;
+        depth_context?: {
+            ulo?: string | undefined;
+            cio?: string | undefined;
+            sio?: string[] | undefined;
+        } | undefined;
         introduce_aspect?: "new" | "advanced" | "preview" | null | undefined;
     }>, "many">;
     dependency_edges: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -466,7 +626,25 @@ declare const CurriculumFeedSchema: z.ZodObject<{
             file: string;
         }[];
         concept_ref: string | null;
+        user_visible_deliverable: string;
+        is_core: boolean;
         introduce_aspect: "new" | "advanced" | "preview" | null;
+        depth_variants?: {
+            ulo: number;
+            cio: number;
+            sio: number;
+        } | undefined;
+        depth_scaffold_candidates?: {
+            reason: string;
+            minutes_saved: number;
+            from_depth: "ulo" | "cio" | "sio";
+            to_depth: "ulo" | "cio" | "sio";
+        }[] | undefined;
+        depth_context?: {
+            ulo: string;
+            cio: string;
+            sio: string[];
+        } | undefined;
     }[];
     dependency_edges: {
         from: string;
@@ -517,6 +695,24 @@ declare const CurriculumFeedSchema: z.ZodObject<{
             evidence?: string | undefined;
         }[] | undefined;
         concept_ref?: string | null | undefined;
+        user_visible_deliverable?: string | undefined;
+        depth_variants?: {
+            ulo: number;
+            cio: number;
+            sio: number;
+        } | undefined;
+        depth_scaffold_candidates?: {
+            minutes_saved: number;
+            from_depth: "ulo" | "cio" | "sio";
+            to_depth: "ulo" | "cio" | "sio";
+            reason?: string | undefined;
+        }[] | undefined;
+        is_core?: boolean | undefined;
+        depth_context?: {
+            ulo?: string | undefined;
+            cio?: string | undefined;
+            sio?: string[] | undefined;
+        } | undefined;
         introduce_aspect?: "new" | "advanced" | "preview" | null | undefined;
     }[];
     phases?: {

package/dist/feed/index.cjs

@@ -31,6 +31,36 @@ var FeedNodeSchema = zod.z.object({
   references: zod.z.array(zod.z.object({ file: zod.z.string().min(1), evidence: zod.z.string().default("") })).default([]),
   feature_id: zod.z.string().nullable().default(null),
   concept_ref: zod.z.string().nullable().default(null),
+  // P52/T2.1: outcome.user_visible projected from the ProjectGraph step — the
+  // tangible checkpoint the session-cutting planner aims for (empty when the
+  // step declares no user-visible result). Concepts carry '' by default.
+  user_visible_deliverable: zod.z.string().default(""),
+  // P52/T3.1 — depth-reconcile inputs (optional/defaulted so old feeds
+  // validate unchanged):
+  // • depth_variants: minutes to teach this node at each depth level.
+  //  ULO (know-it-exists) ≤ CIO (mechanism) ≤ SIO (implementation). All 3
+  //   required so a downgrade never turns an anchor teach into a zero.
+  // • depth_scaffold_candidates: parallel to scaffold_candidates but
+  //   acts on DEPTH (e.g. SIO→CIO) instead of lesson time.
+  // • is_core: concept is a Master-Tree core concept — reconciler must
+  //   never downgrade it; escalate instead.
+  depth_variants: zod.z.object({ ulo: zod.z.number().int().nonnegative(), cio: zod.z.number().int().nonnegative(), sio: zod.z.number().int().nonnegative() }).optional(),
+  depth_scaffold_candidates: zod.z.array(zod.z.object({
+    from_depth: zod.z.enum(["ulo", "cio", "sio"]),
+    to_depth: zod.z.enum(["ulo", "cio", "sio"]),
+    minutes_saved: zod.z.number().int().nonnegative(),
+    reason: zod.z.string().default("")
+  })).optional(),
+  is_core: zod.z.boolean().default(false),
+  // Depth layer text (optional, additive — old feeds validate unchanged).
+  // Carries the ULO/CIO/SIO authored text from the KnowledgeGraph concept
+  // so downstream consumers (KX generator) can inject depth-appropriate
+  // material into their prompts without a second LLM call.
+  depth_context: zod.z.object({
+    ulo: zod.z.string().default(""),
+    cio: zod.z.string().default(""),
+    sio: zod.z.array(zod.z.string()).default([])
+  }).optional(),
   // Progressive-completion bookkeeping (feed v2, additive):
   // phase_id = development phase that introduces/uses this node;
   // introduce_aspect = how the phase teaches a concept node (first intro, advanced
@@ -157,6 +187,10 @@ function feedNodeFromStep(step, featureId) {
     references: arr(step.files).map((f) => ({ file: str(f), evidence: "step file" })).filter((f) => f.file),
     feature_id: featureId,
     concept_ref: null,
+    // P52/T2.1: carry the step's tangible outcome so the planner can cut
+    // sessions at user-visible checkpoints instead of raw minute counts.
+    user_visible_deliverable: str(step.outcome?.user_visible),
+    is_core: false,
     phase_id: "",
     introduce_aspect: null
   };
@@ -175,6 +209,20 @@ function deriveConceptDepthHint(concept) {
   if (str(concept.cio) || prereqs.length >= 1) return "cio";
   return "ulo";
 }
+function deriveDepthInputs(minutes, depth) {
+  const ulo = Math.max(5, Math.round(minutes * 0.35));
+  const cio = Math.max(ulo + 5, Math.round(minutes * 0.65));
+  const sio = Math.max(cio + 5, minutes);
+  const variants = { ulo, cio, sio };
+  const candidates = [];
+  if (depth === "sio") {
+    candidates.push({ from_depth: "sio", to_depth: "cio", minutes_saved: sio - cio, reason: "SIO implementation practice deferred \u2014 CIO mechanism suffices for downstream consumers" });
+  }
+  if (depth === "cio" || depth === "sio") {
+    candidates.push({ from_depth: depth, to_depth: "ulo", minutes_saved: (depth === "sio" ? sio : cio) - ulo, reason: "Mechanism deferred \u2014 ULO awareness suffices (know-it-exists); never below the ULO floor" });
+  }
+  return { depth_variants: variants, depth_scaffold_candidates: candidates };
+}
 function feedNodeFromConcept(concept) {
   const id = str(concept.id);
   const pts = arr(concept.problem_types).map((p) => str(p.bloom_level, "Understand")).filter((b) => b in BLOOM_RANK).sort((a, b) => BLOOM_RANK[a] - BLOOM_RANK[b]);
@@ -204,6 +252,15 @@ function feedNodeFromConcept(concept) {
     references,
     feature_id: null,
     concept_ref: id,
+    user_visible_deliverable: "",
+    // concepts are taught, not shipped — checkpoints live on product steps
+    ...deriveDepthInputs(Math.max(0, Math.round(num(concept.estimated_minutes, 15))), deriveConceptDepthHint(concept)),
+    is_core: false,
+    depth_context: {
+      ulo: str(concept.ulo),
+      cio: str(concept.cio),
+      sio: strs(concept.sio)
+    },
     phase_id: "",
     introduce_aspect: null
   };
@@ -310,6 +367,8 @@ function emitFromHybrid(hybrid, opts) {
         prevNode.concept_codes = [str(c.code) || cid];
         prevNode.keywords = { all: strs(c.keywords), new: [], prerequisite: [] };
         prevNode.scaffolding = { scaffold_candidates: [], core_value_minutes: 0 };
+        prevNode.depth_variants = { ulo: prevNode.estimated_minutes, cio: prevNode.estimated_minutes, sio: prevNode.estimated_minutes };
+        prevNode.depth_scaffold_candidates = [];
         nodes.push(prevNode);
         conceptOrder.push(prevNode.id);
         continue;
@@ -334,6 +393,7 @@ function emitFromHybrid(hybrid, opts) {
         node.name = str(c.name, cid) + " (advanced)";
         node.phase_id = pid;
         node.introduce_aspect = "advanced";
+        node.depth_scaffold_candidates = [{ from_depth: "sio", to_depth: "cio", minutes_saved: Math.round(node.estimated_minutes * 0.3), reason: "advanced revisit may drop to CIO recap without breaking first-teach chain" }];
         node.estimated_minutes = Math.max(15, Math.round(node.estimated_minutes * 0.5));
         node.concept_codes = [str(c.code) || cid];
         edges.push({ from: cid, to: revisitId, kind: "knowledge", reason: "advanced revisit of " + cid + " at phase " + pid });