@thanh01.pmt/domain-kit 0.1.0

package/dist/curriculumFeedSchema-TEeQg2bY.d.ts

@@ -0,0 +1,549 @@
+import { z } from 'zod';
+
+/**
+ * CurriculumFeed v2 — normalized, planner-ready projection of a domain graph.
+ * Consumers: curriculum-kit Curriculum Planner (see docs/ideas/2026-08-30-curriculum-feed-v2-output.md).
+ * Guarantees enforced here: cycle-free is the CALLER's verifier job; the feed
+ * itself guarantees resolution (edges/keywords reference emitted nodes) and
+ * non-emptiness.
+ */
+declare const FeedKeywordsSchema: z.ZodObject<{
+    all: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    new: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    prerequisite: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    new: string[];
+    all: string[];
+    prerequisite: string[];
+}, {
+    new?: string[] | undefined;
+    all?: string[] | undefined;
+    prerequisite?: string[] | undefined;
+}>;
+declare const FeedScaffoldCandidateSchema: z.ZodObject<{
+    item: z.ZodString;
+    reason: z.ZodDefault<z.ZodString>;
+    minutes_saved: z.ZodDefault<z.ZodNumber>;
+    suggest: z.ZodDefault<z.ZodEnum<["provide_full", "provide_partial", "provide_reference"]>>;
+}, "strip", z.ZodTypeAny, {
+    item: string;
+    reason: string;
+    minutes_saved: number;
+    suggest: "provide_full" | "provide_partial" | "provide_reference";
+}, {
+    item: string;
+    reason?: string | undefined;
+    minutes_saved?: number | undefined;
+    suggest?: "provide_full" | "provide_partial" | "provide_reference" | undefined;
+}>;
+declare const FeedNodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<["skill", "concept", "product_step"]>;
+    name: z.ZodString;
+    concept_codes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    keywords: z.ZodObject<{
+        all: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        new: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        prerequisite: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        new: string[];
+        all: string[];
+        prerequisite: string[];
+    }, {
+        new?: string[] | undefined;
+        all?: string[] | undefined;
+        prerequisite?: string[] | undefined;
+    }>;
+    estimated_minutes: z.ZodNumber;
+    bloom_hint: z.ZodDefault<z.ZodNullable<z.ZodEnum<["Remember", "Understand", "Apply", "Analyze", "Evaluate", "Create"]>>>;
+    depth_hint: z.ZodDefault<z.ZodNullable<z.ZodEnum<["ulo", "cio", "sio"]>>>;
+    completion_level: z.ZodDefault<z.ZodEnum<["mvp", "standard", "stretch"]>>;
+    scaffolding: z.ZodDefault<z.ZodObject<{
+        scaffold_candidates: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            item: z.ZodString;
+            reason: z.ZodDefault<z.ZodString>;
+            minutes_saved: z.ZodDefault<z.ZodNumber>;
+            suggest: z.ZodDefault<z.ZodEnum<["provide_full", "provide_partial", "provide_reference"]>>;
+        }, "strip", z.ZodTypeAny, {
+            item: string;
+            reason: string;
+            minutes_saved: number;
+            suggest: "provide_full" | "provide_partial" | "provide_reference";
+        }, {
+            item: string;
+            reason?: string | undefined;
+            minutes_saved?: number | undefined;
+            suggest?: "provide_full" | "provide_partial" | "provide_reference" | undefined;
+        }>, "many">>;
+        core_value_minutes: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        scaffold_candidates: {
+            item: string;
+            reason: string;
+            minutes_saved: number;
+            suggest: "provide_full" | "provide_partial" | "provide_reference";
+        }[];
+        core_value_minutes: number;
+    }, {
+        scaffold_candidates?: {
+            item: string;
+            reason?: string | undefined;
+            minutes_saved?: number | undefined;
+            suggest?: "provide_full" | "provide_partial" | "provide_reference" | undefined;
+        }[] | undefined;
+        core_value_minutes?: number | undefined;
+    }>>;
+    references: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        evidence: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        evidence: string;
+        file: string;
+    }, {
+        file: string;
+        evidence?: string | undefined;
+    }>, "many">>;
+    feature_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    concept_ref: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    phase_id: z.ZodDefault<z.ZodString>;
+    introduce_aspect: z.ZodDefault<z.ZodNullable<z.ZodEnum<["new", "advanced"]>>>;
+}, "strip", z.ZodTypeAny, {
+    estimated_minutes: number;
+    id: string;
+    name: string;
+    keywords: {
+        new: string[];
+        all: string[];
+        prerequisite: string[];
+    };
+    completion_level: "mvp" | "standard" | "stretch";
+    concept_codes: string[];
+    feature_id: string | null;
+    phase_id: string;
+    kind: "concept" | "skill" | "product_step";
+    bloom_hint: "Remember" | "Understand" | "Apply" | "Analyze" | "Evaluate" | "Create" | null;
+    depth_hint: "ulo" | "cio" | "sio" | null;
+    scaffolding: {
+        scaffold_candidates: {
+            item: string;
+            reason: string;
+            minutes_saved: number;
+            suggest: "provide_full" | "provide_partial" | "provide_reference";
+        }[];
+        core_value_minutes: number;
+    };
+    references: {
+        evidence: string;
+        file: string;
+    }[];
+    concept_ref: string | null;
+    introduce_aspect: "new" | "advanced" | null;
+}, {
+    estimated_minutes: number;
+    id: string;
+    name: string;
+    keywords: {
+        new?: string[] | undefined;
+        all?: string[] | undefined;
+        prerequisite?: string[] | undefined;
+    };
+    kind: "concept" | "skill" | "product_step";
+    completion_level?: "mvp" | "standard" | "stretch" | undefined;
+    concept_codes?: string[] | undefined;
+    feature_id?: string | null | undefined;
+    phase_id?: string | undefined;
+    bloom_hint?: "Remember" | "Understand" | "Apply" | "Analyze" | "Evaluate" | "Create" | null | undefined;
+    depth_hint?: "ulo" | "cio" | "sio" | null | undefined;
+    scaffolding?: {
+        scaffold_candidates?: {
+            item: string;
+            reason?: string | undefined;
+            minutes_saved?: number | undefined;
+            suggest?: "provide_full" | "provide_partial" | "provide_reference" | undefined;
+        }[] | undefined;
+        core_value_minutes?: number | undefined;
+    } | undefined;
+    references?: {
+        file: string;
+        evidence?: string | undefined;
+    }[] | undefined;
+    concept_ref?: string | null | undefined;
+    introduce_aspect?: "new" | "advanced" | null | undefined;
+}>;
+declare const FeedEdgeSchema: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+    kind: z.ZodEnum<["knowledge", "task"]>;
+    reason: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    from: string;
+    to: string;
+    reason: string;
+    kind: "knowledge" | "task";
+}, {
+    from: string;
+    to: string;
+    kind: "knowledge" | "task";
+    reason?: string | undefined;
+}>;
+declare const FeedGroupingSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    node_ids: z.ZodArray<z.ZodString, "many">;
+    rationale: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    node_ids: string[];
+    rationale: string;
+}, {
+    id: string;
+    name: string;
+    node_ids: string[];
+    rationale?: string | undefined;
+}>;
+declare const FeedPhaseSchema: z.ZodObject<{
+    id: z.ZodString;
+    order: z.ZodNumber;
+    name: z.ZodString;
+    product_completion: z.ZodString;
+    node_ids: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    order: number;
+    product_completion: string;
+    node_ids: string[];
+}, {
+    id: string;
+    name: string;
+    order: number;
+    product_completion: string;
+    node_ids: string[];
+}>;
+type FeedPhase = z.infer<typeof FeedPhaseSchema>;
+declare const CurriculumFeedSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<2>;
+    source: z.ZodObject<{
+        graph_type: z.ZodEnum<["project_graph", "knowledge_graph", "hybrid_graph"]>;
+        warnings: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        hallucination_count: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        graph_type: "knowledge_graph" | "hybrid_graph" | "project_graph";
+        warnings: string[];
+        hallucination_count: number;
+    }, {
+        graph_type: "knowledge_graph" | "hybrid_graph" | "project_graph";
+        warnings?: string[] | undefined;
+        hallucination_count?: number | undefined;
+    }>;
+    learning_nodes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<["skill", "concept", "product_step"]>;
+        name: z.ZodString;
+        concept_codes: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        keywords: z.ZodObject<{
+            all: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            new: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            prerequisite: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            new: string[];
+            all: string[];
+            prerequisite: string[];
+        }, {
+            new?: string[] | undefined;
+            all?: string[] | undefined;
+            prerequisite?: string[] | undefined;
+        }>;
+        estimated_minutes: z.ZodNumber;
+        bloom_hint: z.ZodDefault<z.ZodNullable<z.ZodEnum<["Remember", "Understand", "Apply", "Analyze", "Evaluate", "Create"]>>>;
+        depth_hint: z.ZodDefault<z.ZodNullable<z.ZodEnum<["ulo", "cio", "sio"]>>>;
+        completion_level: z.ZodDefault<z.ZodEnum<["mvp", "standard", "stretch"]>>;
+        scaffolding: z.ZodDefault<z.ZodObject<{
+            scaffold_candidates: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                item: z.ZodString;
+                reason: z.ZodDefault<z.ZodString>;
+                minutes_saved: z.ZodDefault<z.ZodNumber>;
+                suggest: z.ZodDefault<z.ZodEnum<["provide_full", "provide_partial", "provide_reference"]>>;
+            }, "strip", z.ZodTypeAny, {
+                item: string;
+                reason: string;
+                minutes_saved: number;
+                suggest: "provide_full" | "provide_partial" | "provide_reference";
+            }, {
+                item: string;
+                reason?: string | undefined;
+                minutes_saved?: number | undefined;
+                suggest?: "provide_full" | "provide_partial" | "provide_reference" | undefined;
+            }>, "many">>;
+            core_value_minutes: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            scaffold_candidates: {
+                item: string;
+                reason: string;
+                minutes_saved: number;
+                suggest: "provide_full" | "provide_partial" | "provide_reference";
+            }[];
+            core_value_minutes: number;
+        }, {
+            scaffold_candidates?: {
+                item: string;
+                reason?: string | undefined;
+                minutes_saved?: number | undefined;
+                suggest?: "provide_full" | "provide_partial" | "provide_reference" | undefined;
+            }[] | undefined;
+            core_value_minutes?: number | undefined;
+        }>>;
+        references: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            file: z.ZodString;
+            evidence: z.ZodDefault<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            evidence: string;
+            file: string;
+        }, {
+            file: string;
+            evidence?: string | undefined;
+        }>, "many">>;
+        feature_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        concept_ref: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        phase_id: z.ZodDefault<z.ZodString>;
+        introduce_aspect: z.ZodDefault<z.ZodNullable<z.ZodEnum<["new", "advanced"]>>>;
+    }, "strip", z.ZodTypeAny, {
+        estimated_minutes: number;
+        id: string;
+        name: string;
+        keywords: {
+            new: string[];
+            all: string[];
+            prerequisite: string[];
+        };
+        completion_level: "mvp" | "standard" | "stretch";
+        concept_codes: string[];
+        feature_id: string | null;
+        phase_id: string;
+        kind: "concept" | "skill" | "product_step";
+        bloom_hint: "Remember" | "Understand" | "Apply" | "Analyze" | "Evaluate" | "Create" | null;
+        depth_hint: "ulo" | "cio" | "sio" | null;
+        scaffolding: {
+            scaffold_candidates: {
+                item: string;
+                reason: string;
+                minutes_saved: number;
+                suggest: "provide_full" | "provide_partial" | "provide_reference";
+            }[];
+            core_value_minutes: number;
+        };
+        references: {
+            evidence: string;
+            file: string;
+        }[];
+        concept_ref: string | null;
+        introduce_aspect: "new" | "advanced" | null;
+    }, {
+        estimated_minutes: number;
+        id: string;
+        name: string;
+        keywords: {
+            new?: string[] | undefined;
+            all?: string[] | undefined;
+            prerequisite?: string[] | undefined;
+        };
+        kind: "concept" | "skill" | "product_step";
+        completion_level?: "mvp" | "standard" | "stretch" | undefined;
+        concept_codes?: string[] | undefined;
+        feature_id?: string | null | undefined;
+        phase_id?: string | undefined;
+        bloom_hint?: "Remember" | "Understand" | "Apply" | "Analyze" | "Evaluate" | "Create" | null | undefined;
+        depth_hint?: "ulo" | "cio" | "sio" | null | undefined;
+        scaffolding?: {
+            scaffold_candidates?: {
+                item: string;
+                reason?: string | undefined;
+                minutes_saved?: number | undefined;
+                suggest?: "provide_full" | "provide_partial" | "provide_reference" | undefined;
+            }[] | undefined;
+            core_value_minutes?: number | undefined;
+        } | undefined;
+        references?: {
+            file: string;
+            evidence?: string | undefined;
+        }[] | undefined;
+        concept_ref?: string | null | undefined;
+        introduce_aspect?: "new" | "advanced" | null | undefined;
+    }>, "many">;
+    dependency_edges: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        kind: z.ZodEnum<["knowledge", "task"]>;
+        reason: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        from: string;
+        to: string;
+        reason: string;
+        kind: "knowledge" | "task";
+    }, {
+        from: string;
+        to: string;
+        kind: "knowledge" | "task";
+        reason?: string | undefined;
+    }>, "many">>;
+    suggested_groupings: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        node_ids: z.ZodArray<z.ZodString, "many">;
+        rationale: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        node_ids: string[];
+        rationale: string;
+    }, {
+        id: string;
+        name: string;
+        node_ids: string[];
+        rationale?: string | undefined;
+    }>, "many">>;
+    phases: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        order: z.ZodNumber;
+        name: z.ZodString;
+        product_completion: z.ZodString;
+        node_ids: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        order: number;
+        product_completion: string;
+        node_ids: string[];
+    }, {
+        id: string;
+        name: string;
+        order: number;
+        product_completion: string;
+        node_ids: string[];
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    source: {
+        graph_type: "knowledge_graph" | "hybrid_graph" | "project_graph";
+        warnings: string[];
+        hallucination_count: number;
+    };
+    schema_version: 2;
+    phases: {
+        id: string;
+        name: string;
+        order: number;
+        product_completion: string;
+        node_ids: string[];
+    }[];
+    learning_nodes: {
+        estimated_minutes: number;
+        id: string;
+        name: string;
+        keywords: {
+            new: string[];
+            all: string[];
+            prerequisite: string[];
+        };
+        completion_level: "mvp" | "standard" | "stretch";
+        concept_codes: string[];
+        feature_id: string | null;
+        phase_id: string;
+        kind: "concept" | "skill" | "product_step";
+        bloom_hint: "Remember" | "Understand" | "Apply" | "Analyze" | "Evaluate" | "Create" | null;
+        depth_hint: "ulo" | "cio" | "sio" | null;
+        scaffolding: {
+            scaffold_candidates: {
+                item: string;
+                reason: string;
+                minutes_saved: number;
+                suggest: "provide_full" | "provide_partial" | "provide_reference";
+            }[];
+            core_value_minutes: number;
+        };
+        references: {
+            evidence: string;
+            file: string;
+        }[];
+        concept_ref: string | null;
+        introduce_aspect: "new" | "advanced" | null;
+    }[];
+    dependency_edges: {
+        from: string;
+        to: string;
+        reason: string;
+        kind: "knowledge" | "task";
+    }[];
+    suggested_groupings: {
+        id: string;
+        name: string;
+        node_ids: string[];
+        rationale: string;
+    }[];
+}, {
+    source: {
+        graph_type: "knowledge_graph" | "hybrid_graph" | "project_graph";
+        warnings?: string[] | undefined;
+        hallucination_count?: number | undefined;
+    };
+    schema_version: 2;
+    learning_nodes: {
+        estimated_minutes: number;
+        id: string;
+        name: string;
+        keywords: {
+            new?: string[] | undefined;
+            all?: string[] | undefined;
+            prerequisite?: string[] | undefined;
+        };
+        kind: "concept" | "skill" | "product_step";
+        completion_level?: "mvp" | "standard" | "stretch" | undefined;
+        concept_codes?: string[] | undefined;
+        feature_id?: string | null | undefined;
+        phase_id?: string | undefined;
+        bloom_hint?: "Remember" | "Understand" | "Apply" | "Analyze" | "Evaluate" | "Create" | null | undefined;
+        depth_hint?: "ulo" | "cio" | "sio" | null | undefined;
+        scaffolding?: {
+            scaffold_candidates?: {
+                item: string;
+                reason?: string | undefined;
+                minutes_saved?: number | undefined;
+                suggest?: "provide_full" | "provide_partial" | "provide_reference" | undefined;
+            }[] | undefined;
+            core_value_minutes?: number | undefined;
+        } | undefined;
+        references?: {
+            file: string;
+            evidence?: string | undefined;
+        }[] | undefined;
+        concept_ref?: string | null | undefined;
+        introduce_aspect?: "new" | "advanced" | null | undefined;
+    }[];
+    phases?: {
+        id: string;
+        name: string;
+        order: number;
+        product_completion: string;
+        node_ids: string[];
+    }[] | undefined;
+    dependency_edges?: {
+        from: string;
+        to: string;
+        kind: "knowledge" | "task";
+        reason?: string | undefined;
+    }[] | undefined;
+    suggested_groupings?: {
+        id: string;
+        name: string;
+        node_ids: string[];
+        rationale?: string | undefined;
+    }[] | undefined;
+}>;
+type CurriculumFeed = z.infer<typeof CurriculumFeedSchema>;
+type FeedNode = z.infer<typeof FeedNodeSchema>;
+type FeedEdge = z.infer<typeof FeedEdgeSchema>;
+type FeedGrouping = z.infer<typeof FeedGroupingSchema>;
+/** Strict pre-save resolution validation — fail-closed, no defaulted-empty graphs. */
+declare function validateCurriculumFeed(feed: unknown): CurriculumFeed;
+
+export { CurriculumFeedSchema as C, FeedKeywordsSchema as F, FeedScaffoldCandidateSchema as a, FeedNodeSchema as b, FeedEdgeSchema as c, FeedGroupingSchema as d, FeedPhaseSchema as e, type FeedPhase as f, type CurriculumFeed as g, type FeedNode as h, type FeedEdge as i, type FeedGrouping as j, validateCurriculumFeed as v };