@thanh01.pmt/domain-kit 0.1.0

package/dist/schemas/index.cjs

@@ -0,0 +1,675 @@
+'use strict';
+
+var zod = require('zod');
+
+// src/schemas/projectGraphSchema.ts
+var StepEffortSchema = zod.z.object({
+  estimated_minutes: zod.z.number().optional(),
+  complexity: zod.z.enum(["low", "medium", "high"]).optional(),
+  concepts_count: zod.z.number().optional(),
+  files_touched: zod.z.number().optional()
+});
+var StepOutcomeSchema = zod.z.object({
+  user_visible: zod.z.string().optional(),
+  technical: zod.z.union([zod.z.string(), zod.z.array(zod.z.string())]).optional()
+});
+var StepSchema = zod.z.object({
+  id: zod.z.string(),
+  sequence: zod.z.number(),
+  name: zod.z.string(),
+  description: zod.z.string().optional().default(""),
+  files: zod.z.array(zod.z.string()).optional().default([]),
+  api_usage: zod.z.array(zod.z.string()).optional().default([]),
+  keywords: zod.z.array(zod.z.string()).optional().default([]),
+  completion_level: zod.z.enum(["base", "mvp", "extend", "polish"]).optional().default("mvp"),
+  platform: zod.z.string().optional().default("app"),
+  intent: zod.z.string().optional().default(""),
+  outcome: StepOutcomeSchema.optional(),
+  acceptance: zod.z.array(zod.z.string()).optional().default([]),
+  effort: StepEffortSchema.optional(),
+  requirement_ids: zod.z.array(zod.z.string()).optional().default([]),
+  concept_codes: zod.z.array(zod.z.string()).optional().default([])
+});
+var FeatureSchema = zod.z.object({
+  id: zod.z.string(),
+  name: zod.z.string(),
+  description: zod.z.string().optional().default(""),
+  purpose: zod.z.string().optional().default(""),
+  priority: zod.z.enum(["core", "supporting", "polish"]).optional().default("core"),
+  status: zod.z.enum(["PLANNED", "IMPLEMENTED", "IN_PROGRESS"]).optional().default("PLANNED"),
+  platform: zod.z.string().optional().default("app"),
+  requirement_ids: zod.z.array(zod.z.string()).optional().default([]),
+  journey_ids: zod.z.array(zod.z.string()).optional().default([]),
+  depends_on: zod.z.array(zod.z.string()).optional().default([]),
+  api_usage: zod.z.array(zod.z.string()).optional().default([]),
+  steps: zod.z.array(StepSchema).optional().default([])
+});
+var JourneyStepSchema = zod.z.object({
+  id: zod.z.string(),
+  name: zod.z.string(),
+  steps: zod.z.array(zod.z.string()).optional().default([]),
+  requirement_ids: zod.z.array(zod.z.string()).optional().default([])
+});
+var JourneySchema = zod.z.object({
+  id: zod.z.string(),
+  name: zod.z.string(),
+  steps: zod.z.array(zod.z.string()).optional().default([]),
+  feature_ids: zod.z.array(zod.z.string()).optional().default([]),
+  requirement_ids: zod.z.array(zod.z.string()).optional().default([])
+});
+var RequirementSchema = zod.z.object({
+  id: zod.z.string(),
+  statement: zod.z.string(),
+  priority: zod.z.enum(["core", "supporting", "polish"]).optional().default("core"),
+  acceptance: zod.z.array(zod.z.string()).optional().default([]),
+  completion_level: zod.z.string().optional().default("base")
+});
+var DevelopmentStageSchema = zod.z.object({
+  stage: zod.z.string(),
+  product_state: zod.z.string().optional().default(""),
+  need: zod.z.array(zod.z.string()).optional().default([]),
+  learn: zod.z.array(zod.z.string()).optional().default([]),
+  validation: zod.z.string().optional().default(""),
+  cross_feature_value: zod.z.string().optional().default(""),
+  temporary_approach: zod.z.string().optional().default("")
+});
+var ProductGoalSchema = zod.z.object({
+  id: zod.z.string(),
+  description: zod.z.string()
+});
+var ProductUserSchema = zod.z.object({
+  id: zod.z.string(),
+  goals: zod.z.array(zod.z.string())
+});
+var ProductSchema = zod.z.object({
+  goals: zod.z.array(ProductGoalSchema).optional().default([]),
+  users: zod.z.array(ProductUserSchema).optional().default([]),
+  journeys: zod.z.array(JourneySchema).optional().default([]),
+  requirements: zod.z.array(RequirementSchema).optional().default([]),
+  development_stages: zod.z.array(DevelopmentStageSchema).optional().default([]),
+  purpose: zod.z.string().optional().default(""),
+  problem_statement: zod.z.string().optional().default(""),
+  primary_users: zod.z.array(zod.z.string()).optional().default([])
+});
+var TechStackSchema = zod.z.record(zod.z.string(), zod.z.array(zod.z.string()));
+var ProjectInfoSchema = zod.z.object({
+  id: zod.z.string(),
+  name: zod.z.string(),
+  version: zod.z.string().optional().default("0.1.0"),
+  purpose: zod.z.string().optional().default(""),
+  project_type: zod.z.string().optional().default("app"),
+  platform: zod.z.array(zod.z.string()).optional().default([]),
+  tech_stack: TechStackSchema.optional(),
+  architecture: zod.z.array(zod.z.string()).optional().default([]),
+  source: zod.z.object({
+    repository: zod.z.string().optional().default(""),
+    commit: zod.z.string().optional().default(""),
+    scan_dir: zod.z.string().optional().default("")
+  }).optional()
+});
+var CapabilitySchema = zod.z.object({
+  id: zod.z.string(),
+  feature_id: zod.z.string(),
+  purpose: zod.z.string().optional().default(""),
+  depends_on: zod.z.array(zod.z.string()).optional().default([]),
+  produces: zod.z.array(zod.z.string()).optional().default([])
+});
+var ArchNodeSchema = zod.z.object({
+  id: zod.z.string(),
+  type: zod.z.string().optional().default("component"),
+  custom_type: zod.z.string().optional(),
+  layer: zod.z.string().optional().default("presentation"),
+  responsibility: zod.z.string().optional().default(""),
+  depends_on: zod.z.array(zod.z.string()).optional().default([]),
+  used_by: zod.z.array(zod.z.string()).optional().default([]),
+  evidence_type: zod.z.string().optional().default("INFERRED"),
+  confidence: zod.z.number().optional().default(0.5)
+});
+var ArchEdgeSchema = zod.z.object({
+  from: zod.z.string(),
+  to: zod.z.string(),
+  type: zod.z.string().optional().default("USES")
+});
+var ArchitectureDetailSchema = zod.z.object({
+  pattern: zod.z.array(zod.z.string()).optional().default([]),
+  confidence: zod.z.number().optional().default(0.5),
+  evidence: zod.z.array(zod.z.string()).optional().default([]),
+  nodes: zod.z.array(ArchNodeSchema).optional().default([]),
+  edges: zod.z.array(ArchEdgeSchema).optional().default([])
+});
+var ScreenSchema = zod.z.object({
+  id: zod.z.string(),
+  name: zod.z.string().optional().default(""),
+  purpose: zod.z.string().optional().default(""),
+  entry_point: zod.z.boolean().optional().default(false),
+  components: zod.z.array(zod.z.string()).optional().default([]),
+  states: zod.z.array(zod.z.string()).optional().default([]),
+  navigates_to: zod.z.array(zod.z.string()).optional().default([]),
+  keywords: zod.z.array(zod.z.string()).optional().default([])
+});
+var ExperienceComponentSchema = zod.z.object({
+  id: zod.z.string(),
+  type: zod.z.string().optional().default("component"),
+  purpose: zod.z.string().optional().default(""),
+  inputs: zod.z.array(zod.z.string()).optional().default([]),
+  outputs: zod.z.array(zod.z.string()).optional().default([]),
+  state: zod.z.array(zod.z.string()).optional().default([])
+});
+var UiStateSchema = zod.z.object({
+  id: zod.z.string(),
+  owner: zod.z.string().optional().default(""),
+  triggered_by: zod.z.array(zod.z.string()).optional().default([]),
+  transitions_to: zod.z.array(zod.z.string()).optional().default([])
+});
+var NavigationSchema = zod.z.object({
+  from: zod.z.string(),
+  to: zod.z.string(),
+  trigger: zod.z.string().optional().default(""),
+  presentation: zod.z.string().optional().default("push")
+});
+var ExperienceSchema = zod.z.object({
+  screens: zod.z.array(ScreenSchema).optional().default([]),
+  components: zod.z.array(ExperienceComponentSchema).optional().default([]),
+  ui_states: zod.z.array(UiStateSchema).optional().default([]),
+  navigation: zod.z.array(NavigationSchema).optional().default([])
+});
+var DataIntegrationSchema = zod.z.object({
+  data_flows: zod.z.array(zod.z.any()).optional().default([]),
+  models: zod.z.array(zod.z.any()).optional().default([]),
+  integrations: zod.z.array(zod.z.any()).optional().default([]),
+  persistence: zod.z.array(zod.z.any()).optional().default([])
+});
+var TaskEffortSchema = zod.z.object({
+  concepts_count: zod.z.number().optional().default(0),
+  files_touched: zod.z.number().optional().default(0),
+  estimated_minutes: zod.z.number().optional().default(0)
+});
+var TaskOutcomeSchema = zod.z.object({
+  user_visible: zod.z.string().optional().default(""),
+  technical: zod.z.array(zod.z.string()).optional().default([])
+});
+var TaskSchema = zod.z.object({
+  id: zod.z.string(),
+  capability_id: zod.z.string().optional().default(""),
+  action: zod.z.string(),
+  modifies: zod.z.array(zod.z.string()).optional().default([]),
+  creates: zod.z.array(zod.z.string()).optional().default([]),
+  depends_on: zod.z.array(zod.z.string()).optional().default([]),
+  acceptance: zod.z.array(zod.z.string()).optional().default([]),
+  intent: zod.z.string().optional().default(""),
+  outcome: TaskOutcomeSchema.optional(),
+  source_evidence: zod.z.array(zod.z.string()).optional().default([]),
+  keywords: zod.z.array(zod.z.string()).optional().default([]),
+  concurrency: zod.z.array(zod.z.string()).optional().default([]),
+  effort: TaskEffortSchema.optional(),
+  requirement_ids: zod.z.array(zod.z.string()).optional().default([])
+});
+var ImplementationSchema = zod.z.object({
+  tasks: zod.z.array(TaskSchema).optional().default([])
+});
+var MissingGapSchema = zod.z.object({
+  gap: zod.z.string(),
+  location: zod.z.string().optional().default(""),
+  suggested_lo: zod.z.string().optional().default("")
+});
+var TechDebtSchema = zod.z.object({
+  issue: zod.z.string(),
+  location: zod.z.string().optional().default(""),
+  severity: zod.z.enum(["low", "medium", "high"]).optional().default("medium")
+});
+var MilestoneDecompositionSchema = zod.z.object({
+  id: zod.z.string(),
+  phase: zod.z.string().optional().default(""),
+  name: zod.z.string().optional().default(""),
+  goal: zod.z.string().optional().default(""),
+  feature_ids: zod.z.array(zod.z.string()).optional().default([])
+});
+var DecompositionSchema = zod.z.object({
+  milestones: zod.z.array(MilestoneDecompositionSchema).optional().default([])
+});
+var ProjectGraphSchema = zod.z.object({
+  schema_version: zod.z.literal(3).optional().default(3),
+  project: ProjectInfoSchema,
+  product: ProductSchema,
+  features: zod.z.array(FeatureSchema).optional().default([]),
+  capabilities: zod.z.array(CapabilitySchema).optional().default([]),
+  architecture_detail: ArchitectureDetailSchema.optional(),
+  experience: ExperienceSchema.optional(),
+  data_integration: DataIntegrationSchema.optional(),
+  implementation: ImplementationSchema,
+  decomposition: DecompositionSchema.optional(),
+  missing_gaps: zod.z.array(MissingGapSchema).optional().default([]),
+  tech_debt: zod.z.array(TechDebtSchema).optional().default([])
+});
+var ProblemTypeSchema = zod.z.object({
+  id: zod.z.string(),
+  name: zod.z.string(),
+  description: zod.z.string().optional().default(""),
+  bloom_level: zod.z.enum(["Remember", "Understand", "Apply", "Analyze", "Evaluate", "Create"]).optional().default("Understand"),
+  difficulty: zod.z.enum(["easy", "medium", "hard"]).optional().default("medium"),
+  estimated_minutes: zod.z.number().optional().default(10),
+  examples: zod.z.array(zod.z.string()).optional().default([]),
+  common_mistakes: zod.z.array(zod.z.string()).optional().default([])
+});
+var ConceptSchema = zod.z.object({
+  id: zod.z.string(),
+  // Production-standard neutral code (UPPER_SNAKE_CASE, Naming Conventions v2.2).
+  // After STEP_2_5 standardization this is either a knowledge-tree code
+  // (standardized) or a provisional proposed code (tracked in the proposals
+  // artifact for later merge).
+  code: zod.z.string().regex(/^[A-Z][A-Z0-9_]*$/).optional(),
+  // Knowledge-tree provenance (STEP_2_5): standardized | proposed_new | unset
+  standardization: zod.z.enum(["standardized", "proposed_new"]).optional(),
+  tree_code: zod.z.string().optional().describe("Exact knowledge-tree CONCEPT code when standardization=standardized"),
+  tree_prerequisites: zod.z.array(zod.z.string()).optional().default([]).describe("Knowledge-tree prerequisite concept codes (seed for prereq edges)"),
+  name: zod.z.string(),
+  description: zod.z.string().optional().default(""),
+  category: zod.z.string().optional().default(""),
+  // ULO/CIO/SIO — technology-independent knowledge levels.
+  // Text fields use the production clause "The learner will be able to ...".
+  ulo: zod.z.string().optional().default("").describe("WHAT + WHY: What is this concept? Why does it exist? What problem does it solve?"),
+  ulo_code: zod.z.string().optional().describe("ULO-[CONCEPT]-NN per Naming Conventions v2.2"),
+  cio: zod.z.string().optional().default("").describe("HOW: How does it solve the problem? What is the mechanism?"),
+  cio_code: zod.z.string().optional().describe("CIO-[CONCEPT]-NN-ACTION per Naming Conventions v2.2"),
+  sio: zod.z.array(zod.z.string()).optional().default([]).describe("IMPLEMENTATION: Specific implementations in concrete technologies"),
+  sio_codes: zod.z.array(zod.z.string()).optional().describe("SIO-[TECH]-[CONCEPT]-NN, one per sio item"),
+  // Prerequisites and timing
+  prerequisites: zod.z.array(zod.z.string()).optional().default([]).describe("Concept IDs that must be learned first"),
+  estimated_minutes: zod.z.number().optional().default(30),
+  // Problem types associated with this concept
+  problem_types: zod.z.array(ProblemTypeSchema).optional().default([]),
+  // Supporting materials
+  techniques: zod.z.array(zod.z.string()).optional().default([]).describe("Methods, formulas, tools, procedures"),
+  materials: zod.z.array(zod.z.string()).optional().default([]).describe("Physical materials needed (lab equipment, instruments)"),
+  visual_aids: zod.z.array(zod.z.string()).optional().default([]).describe("Diagrams, images, animations needed"),
+  common_mistakes: zod.z.array(zod.z.string()).optional().default([]).describe("Frequently confused ideas or errors"),
+  // Metadata
+  keywords: zod.z.array(zod.z.string()).optional().default([]).describe("Technology-specific keywords (SIO level)"),
+  tech_stack: zod.z.array(zod.z.string()).optional().default([]).describe("Specific technologies if applicable")
+});
+var ConceptCategorySchema = zod.z.object({
+  id: zod.z.string(),
+  name: zod.z.string(),
+  description: zod.z.string().optional().default(""),
+  concept_ids: zod.z.array(zod.z.string()).optional().default([]),
+  order: zod.z.number().optional().default(0).describe("Teaching order within the subject")
+});
+var SubjectInfoSchema = zod.z.object({
+  id: zod.z.string(),
+  name: zod.z.string(),
+  description: zod.z.string().optional().default(""),
+  domain: zod.z.enum(["math", "science", "language", "arts", "research", "business", "other"]).optional().default("other"),
+  grade_band: zod.z.tuple([zod.z.number().int(), zod.z.number().int()]).optional(),
+  estimated_hours: zod.z.number().optional().default(0),
+  estimated_weeks: zod.z.number().optional().default(0),
+  syllabus_ref: zod.z.string().optional().default("").describe("Reference to original syllabus/curriculum")
+});
+var LearningPathStepSchema = zod.z.object({
+  concept_id: zod.z.string(),
+  order: zod.z.number(),
+  depends_on: zod.z.array(zod.z.string()).optional().default([]),
+  milestone_name: zod.z.string().optional().default("")
+});
+var KnowledgeGraphSchema = zod.z.object({
+  schema_version: zod.z.literal(1).optional().default(1),
+  type: zod.z.literal("knowledge_graph").optional().default("knowledge_graph"),
+  subject: SubjectInfoSchema,
+  concepts: zod.z.array(ConceptSchema).optional().default([]),
+  categories: zod.z.array(ConceptCategorySchema).optional().default([]),
+  learning_path: zod.z.array(LearningPathStepSchema).optional().default([]).describe("Recommended teaching order")
+});
+var WiringSchema = zod.z.object({
+  component: zod.z.string(),
+  pin: zod.z.string(),
+  connection: zod.z.string(),
+  wire_color: zod.z.string().optional(),
+  notes: zod.z.string().optional()
+});
+var HardwareStepSchema = zod.z.object({
+  action: zod.z.string(),
+  tool: zod.z.string().optional(),
+  safety_note: zod.z.string().optional(),
+  estimated_minutes: zod.z.number().optional()
+});
+var HardwareFeatureExtensionSchema = zod.z.object({
+  wiring: zod.z.array(WiringSchema).optional().default([]),
+  components_used: zod.z.array(zod.z.string()).optional().default([]),
+  circuit_diagram_ref: zod.z.string().optional()
+});
+var HardwareTaskExtensionSchema = zod.z.object({
+  techniques: zod.z.array(zod.z.string()).optional().default([]).describe("soldering, breadboarding, debugging"),
+  hardware_steps: zod.z.array(HardwareStepSchema).optional().default([]),
+  safety_notes: zod.z.array(zod.z.string()).optional().default([]),
+  multimeter_readings: zod.z.boolean().optional().default(false)
+});
+var HardwareTechStackExtensionSchema = zod.z.object({
+  materials: zod.z.array(zod.z.string()).optional().default([]).describe("Physical components: Arduino Uno, LED, Servo"),
+  tools: zod.z.array(zod.z.string()).optional().default([]).describe("Arduino IDE, USB cable, Multimeter"),
+  protocols: zod.z.array(zod.z.string()).optional().default([]).describe("I2C, PWM, SPI, UART"),
+  pin_config: zod.z.record(zod.z.string(), zod.z.string()).optional().default({}).describe("Pin assignments"),
+  power_requirements: zod.z.string().optional()
+});
+var ShapeSchema = zod.z.object({
+  id: zod.z.string(),
+  type: zod.z.string().describe("Box, Cylinder, Sphere, Roof, Torus, Hole, etc."),
+  dimensions: zod.z.string().describe('e.g. "200x150x5mm"'),
+  position: zod.z.string().describe('e.g. "0,0,0"'),
+  color: zod.z.string().optional(),
+  rotation: zod.z.string().optional()
+});
+var ThreeDesignFeatureExtensionSchema = zod.z.object({
+  shapes: zod.z.array(ShapeSchema).optional().default([]),
+  assembly_order: zod.z.array(zod.z.string()).optional().default([]).describe("Shape IDs in assembly order"),
+  group_operations: zod.z.array(zod.z.string()).optional().default([]).describe("Group/hole operations")
+});
+var ThreeDesignTaskExtensionSchema = zod.z.object({
+  operations: zod.z.array(zod.z.string()).optional().default([]).describe("create, resize, position, group, align, hole"),
+  dimensions: zod.z.record(zod.z.string(), zod.z.string()).optional().default({}),
+  shape_type: zod.z.string().optional(),
+  constraints: zod.z.array(zod.z.string()).optional().default([])
+});
+var ThreeDesignTechStackExtensionSchema = zod.z.object({
+  design_software: zod.z.string().optional().describe("Tinkercad, Fusion360, Blender"),
+  units: zod.z.string().optional().default("mm"),
+  canvas_size: zod.z.string().optional(),
+  export_formats: zod.z.array(zod.z.string()).optional().default([]).describe("STL, OBJ, STEP")
+});
+var ProjectConceptLinkSchema = zod.z.object({
+  feature_id: zod.z.string().describe("Feature ID from project_graph"),
+  concept_id: zod.z.string().describe("Concept ID from knowledge_graph"),
+  relationship: zod.z.enum([
+    "requires",
+    // Feature requires understanding this concept
+    "demonstrates",
+    // Feature demonstrates this concept in practice
+    "applies",
+    // Feature applies this concept
+    "extends"
+    // Feature extends this concept to new context
+  ]).optional().default("requires"),
+  depth: zod.z.enum([
+    "ulo",
+    // Feature only needs WHAT+WHY understanding
+    "cio",
+    // Feature needs HOW understanding
+    "sio"
+    // Feature needs specific implementation knowledge
+  ]).optional().default("cio"),
+  description: zod.z.string().optional().default(""),
+  estimated_prereq_minutes: zod.z.number().optional().default(0).describe("How many minutes of concept learning before this feature"),
+  phase_id: zod.z.string().optional().default("").describe("Development phase this link belongs to")
+});
+var ConceptIntroductionSchema = zod.z.object({
+  concept_id: zod.z.string().describe("Concept ID from knowledge_graph"),
+  aspect: zod.z.enum(["new", "advanced"]).default("new").describe(
+    "new = concept introduced for the first time; advanced = previously introduced concept revisited at higher depth"
+  ),
+  note: zod.z.string().optional().default("").describe("Which advanced aspect of the concept this phase develops")
+});
+var DevelopmentPhaseSchema = zod.z.object({
+  id: zod.z.string().describe("Phase id, e.g. PH1"),
+  order: zod.z.number().int().positive().describe("1-based phase execution order"),
+  name: zod.z.string().min(1).describe("Short phase name"),
+  product_completion: zod.z.string().min(1).describe(
+    "What the product can demonstrably DO once this phase is complete (completion level description)"
+  ),
+  feature_ids: zod.z.array(zod.z.string()).default([]).describe("Every feature built during this phase (each feature in EXACTLY one phase)"),
+  introduces: zod.z.array(ConceptIntroductionSchema).default([]).describe(
+    "Concepts introduced (new) or revisited at advanced depth (advanced) at the start of this phase"
+  )
+});
+var HybridGraphSchema = zod.z.object({
+  schema_version: zod.z.literal(1).optional().default(1),
+  type: zod.z.literal("hybrid_graph").optional().default("hybrid_graph"),
+  // Product decomposition (what to build)
+  project_graph: ProjectGraphSchema,
+  // Concept decomposition (what to understand)
+  knowledge_graph: KnowledgeGraphSchema,
+  // Links between features and concepts
+  links: zod.z.array(ProjectConceptLinkSchema).optional().default([]),
+  // Progressive completion phases (cross-feature decomposition). Empty for
+  // pre-phase legacy graphs — emitters fall back to feature ordering.
+  phases: zod.z.array(DevelopmentPhaseSchema).optional().default([]),
+  // Metadata
+  description: zod.z.string().optional().default(""),
+  total_project_minutes: zod.z.number().optional().default(0),
+  total_concept_minutes: zod.z.number().optional().default(0),
+  estimated_total_minutes: zod.z.number().optional().default(0)
+});
+var InputTypeSchema = zod.z.enum([
+  "repository",
+  // Source code repo (git URL or local dir)
+  "description",
+  // Text description of subject/project
+  "syllabus",
+  // Syllabus, curriculum framework, textbook outline
+  "files",
+  // Non-code files (3D models, images, documents)
+  "mixed"
+  // Combination of the above
+]);
+var DomainCategorySchema = zod.z.enum([
+  "software",
+  // App, web, API, CLI, library
+  "hardware_iot",
+  // Arduino, robotics, ESP32, Raspberry Pi
+  "3d_design",
+  // Tinkercad, Fusion360, Blender, CAD
+  "math",
+  // Hình học, đại số, giải tích, xác suất
+  "science",
+  // Lý, hóa, sinh, địa lý
+  "language",
+  // Tiếng Việt, English, writing, grammar
+  "arts",
+  // Âm nhạc, hội họa, thiết kế, nhiếp ảnh
+  "research",
+  // Nghiên cứu, thống kê, phân tích dữ liệu
+  "business",
+  // Kinh doanh, tài chính, quản lý
+  "other"
+]);
+var LearningModeSchema = zod.z.enum([
+  "product",
+  // Build a product (project-driven)
+  "concept",
+  // Understand concepts (knowledge-driven)
+  "hybrid"
+  // Both: build product while understanding concepts
+]);
+var GraphTypeSchema = zod.z.enum([
+  "project_graph",
+  // Product decomposition (software, hardware, 3d_design)
+  "knowledge_graph",
+  // Concept decomposition (math, science, language, etc.)
+  "hybrid_graph"
+  // Both linked together
+]);
+var DetectionConfidenceSchema = zod.z.object({
+  inputType: zod.z.number().min(0).max(1).optional().default(0.5),
+  domainCategory: zod.z.number().min(0).max(1).optional().default(0.5),
+  learningMode: zod.z.number().min(0).max(1).optional().default(0.5)
+});
+var DomainProfileSchema = zod.z.object({
+  // Detection results
+  inputType: InputTypeSchema,
+  domainCategory: DomainCategorySchema,
+  learningMode: LearningModeSchema,
+  graphType: GraphTypeSchema,
+  // Confidence scores
+  confidence: DetectionConfidenceSchema.optional(),
+  // Evidence for detection decisions
+  evidence: zod.z.array(zod.z.string()).optional().default([]),
+  // Detected metadata (optional, populated during detection)
+  detectedTechStack: zod.z.array(zod.z.string()).optional().default([]),
+  detectedSubject: zod.z.string().optional().default(""),
+  detectedGradeBand: zod.z.tuple([zod.z.number().int(), zod.z.number().int()]).optional(),
+  detectedDomain: zod.z.string().optional().default(""),
+  // User-provided context (pass-through)
+  goal: zod.z.string().optional().default(""),
+  description: zod.z.string().optional().default(""),
+  repoUrl: zod.z.string().optional().default(""),
+  repoDir: zod.z.string().optional().default(""),
+  syllabusText: zod.z.string().optional().default("")
+});
+var FeedKeywordsSchema = zod.z.object({
+  all: zod.z.array(zod.z.string()).default([]),
+  new: zod.z.array(zod.z.string()).default([]),
+  prerequisite: zod.z.array(zod.z.string()).default([])
+});
+var FeedScaffoldCandidateSchema = zod.z.object({
+  item: zod.z.string(),
+  reason: zod.z.string().default(""),
+  minutes_saved: zod.z.number().int().nonnegative().default(0),
+  suggest: zod.z.enum(["provide_full", "provide_partial", "provide_reference"]).default("provide_full")
+});
+var FeedNodeSchema = zod.z.object({
+  id: zod.z.string().min(1),
+  kind: zod.z.enum(["skill", "concept", "product_step"]),
+  name: zod.z.string().min(1),
+  concept_codes: zod.z.array(zod.z.string()).default([]),
+  keywords: FeedKeywordsSchema,
+  estimated_minutes: zod.z.number().int().nonnegative(),
+  bloom_hint: zod.z.enum(["Remember", "Understand", "Apply", "Analyze", "Evaluate", "Create"]).nullable().default(null),
+  depth_hint: zod.z.enum(["ulo", "cio", "sio"]).nullable().default(null),
+  completion_level: zod.z.enum(["mvp", "standard", "stretch"]).default("standard"),
+  scaffolding: zod.z.object({
+    scaffold_candidates: zod.z.array(FeedScaffoldCandidateSchema).default([]),
+    core_value_minutes: zod.z.number().int().nonnegative().default(0)
+  }).default({ scaffold_candidates: [], core_value_minutes: 0 }),
+  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),
+  // 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 vs advanced revisit).
+  phase_id: zod.z.string().default(""),
+  introduce_aspect: zod.z.enum(["new", "advanced"]).nullable().default(null)
+});
+var FeedEdgeSchema = zod.z.object({
+  from: zod.z.string().min(1),
+  to: zod.z.string().min(1),
+  kind: zod.z.enum(["knowledge", "task"]),
+  reason: zod.z.string().default("")
+});
+var FeedGroupingSchema = zod.z.object({
+  id: zod.z.string().min(1),
+  name: zod.z.string().min(1),
+  node_ids: zod.z.array(zod.z.string()).min(1),
+  rationale: zod.z.string().default("")
+});
+var FeedPhaseSchema = zod.z.object({
+  id: zod.z.string().min(1),
+  order: zod.z.number().int().positive(),
+  name: zod.z.string().min(1),
+  product_completion: zod.z.string().min(1),
+  node_ids: zod.z.array(zod.z.string()).min(1)
+});
+var CurriculumFeedSchema = zod.z.object({
+  schema_version: zod.z.literal(2),
+  source: zod.z.object({
+    graph_type: zod.z.enum(["project_graph", "knowledge_graph", "hybrid_graph"]),
+    warnings: zod.z.array(zod.z.string()).default([]),
+    hallucination_count: zod.z.number().int().nonnegative().default(0)
+  }),
+  learning_nodes: zod.z.array(FeedNodeSchema).min(1, "curriculum feed must contain at least one learning node"),
+  dependency_edges: zod.z.array(FeedEdgeSchema).default([]),
+  suggested_groupings: zod.z.array(FeedGroupingSchema).default([]),
+  // Progressive completion phases (cross-feature). When non-empty, these — not
+  // suggested_groupings — define the teaching sequence and unit structure.
+  phases: zod.z.array(FeedPhaseSchema).default([])
+});
+function validateCurriculumFeed(feed) {
+  const parsed = CurriculumFeedSchema.parse(feed);
+  const ids = new Set(parsed.learning_nodes.map((n) => n.id));
+  if (ids.size !== parsed.learning_nodes.length) {
+    throw new Error("curriculum feed contains duplicate node ids");
+  }
+  for (const e of parsed.dependency_edges) {
+    if (!ids.has(e.from) || !ids.has(e.to)) {
+      throw new Error("curriculum feed edge " + e.from + " -> " + e.to + " references unknown node");
+    }
+    if (e.from === e.to) throw new Error("curriculum feed self-loop edge on " + e.from);
+  }
+  for (const g of parsed.suggested_groupings) {
+    for (const id of g.node_ids) {
+      if (!ids.has(id)) throw new Error("grouping " + g.id + " references unknown node " + id);
+    }
+  }
+  for (const ph of parsed.phases) {
+    for (const id of ph.node_ids) {
+      if (!ids.has(id)) throw new Error("phase " + ph.id + " references unknown node " + id);
+    }
+  }
+  const phaseIds = parsed.phases.map((p) => p.id);
+  if (new Set(phaseIds).size !== phaseIds.length) throw new Error("curriculum feed contains duplicate phase ids");
+  return parsed;
+}
+
+exports.ArchEdgeSchema = ArchEdgeSchema;
+exports.ArchNodeSchema = ArchNodeSchema;
+exports.ArchitectureDetailSchema = ArchitectureDetailSchema;
+exports.CapabilitySchema = CapabilitySchema;
+exports.ConceptCategorySchema = ConceptCategorySchema;
+exports.ConceptIntroductionSchema = ConceptIntroductionSchema;
+exports.ConceptSchema = ConceptSchema;
+exports.CurriculumFeedSchema = CurriculumFeedSchema;
+exports.DataIntegrationSchema = DataIntegrationSchema;
+exports.DecompositionSchema = DecompositionSchema;
+exports.DetectionConfidenceSchema = DetectionConfidenceSchema;
+exports.DevelopmentPhaseSchema = DevelopmentPhaseSchema;
+exports.DevelopmentStageSchema = DevelopmentStageSchema;
+exports.DomainCategorySchema = DomainCategorySchema;
+exports.DomainProfileSchema = DomainProfileSchema;
+exports.ExperienceComponentSchema = ExperienceComponentSchema;
+exports.ExperienceSchema = ExperienceSchema;
+exports.FeatureSchema = FeatureSchema;
+exports.FeedEdgeSchema = FeedEdgeSchema;
+exports.FeedGroupingSchema = FeedGroupingSchema;
+exports.FeedKeywordsSchema = FeedKeywordsSchema;
+exports.FeedNodeSchema = FeedNodeSchema;
+exports.FeedPhaseSchema = FeedPhaseSchema;
+exports.FeedScaffoldCandidateSchema = FeedScaffoldCandidateSchema;
+exports.GraphTypeSchema = GraphTypeSchema;
+exports.HardwareFeatureExtensionSchema = HardwareFeatureExtensionSchema;
+exports.HardwareStepSchema = HardwareStepSchema;
+exports.HardwareTaskExtensionSchema = HardwareTaskExtensionSchema;
+exports.HardwareTechStackExtensionSchema = HardwareTechStackExtensionSchema;
+exports.HybridGraphSchema = HybridGraphSchema;
+exports.ImplementationSchema = ImplementationSchema;
+exports.InputTypeSchema = InputTypeSchema;
+exports.JourneySchema = JourneySchema;
+exports.JourneyStepSchema = JourneyStepSchema;
+exports.KnowledgeGraphSchema = KnowledgeGraphSchema;
+exports.LearningModeSchema = LearningModeSchema;
+exports.LearningPathStepSchema = LearningPathStepSchema;
+exports.MilestoneDecompositionSchema = MilestoneDecompositionSchema;
+exports.MissingGapSchema = MissingGapSchema;
+exports.NavigationSchema = NavigationSchema;
+exports.ProblemTypeSchema = ProblemTypeSchema;
+exports.ProductGoalSchema = ProductGoalSchema;
+exports.ProductSchema = ProductSchema;
+exports.ProductUserSchema = ProductUserSchema;
+exports.ProjectConceptLinkSchema = ProjectConceptLinkSchema;
+exports.ProjectGraphSchema = ProjectGraphSchema;
+exports.ProjectInfoSchema = ProjectInfoSchema;
+exports.RequirementSchema = RequirementSchema;
+exports.ScreenSchema = ScreenSchema;
+exports.ShapeSchema = ShapeSchema;
+exports.StepEffortSchema = StepEffortSchema;
+exports.StepOutcomeSchema = StepOutcomeSchema;
+exports.StepSchema = StepSchema;
+exports.SubjectInfoSchema = SubjectInfoSchema;
+exports.TaskEffortSchema = TaskEffortSchema;
+exports.TaskOutcomeSchema = TaskOutcomeSchema;
+exports.TaskSchema = TaskSchema;
+exports.TechDebtSchema = TechDebtSchema;
+exports.TechStackSchema = TechStackSchema;
+exports.ThreeDesignFeatureExtensionSchema = ThreeDesignFeatureExtensionSchema;
+exports.ThreeDesignTaskExtensionSchema = ThreeDesignTaskExtensionSchema;
+exports.ThreeDesignTechStackExtensionSchema = ThreeDesignTechStackExtensionSchema;
+exports.UiStateSchema = UiStateSchema;
+exports.WiringSchema = WiringSchema;
+exports.validateCurriculumFeed = validateCurriculumFeed;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map