@soulcraft/kits 1.0.0

package/src/kits/concept-map.ts

@@ -0,0 +1,354 @@
+/**
+ * @module @soulcraft/kits/kits/concept-map
+ * @description Educational concept map showing topic relationships and prerequisites
+ *
+ * Generated from: kits/concept-map/kit.json
+ * Do not edit this file directly — edit the source kit.json and re-run `bun run build:kits`.
+ */
+
+import type { SoulcraftKitConfig } from '@soulcraft/kit-schema';
+
+/**
+ * Concept Map / Learning Path kit configuration.
+ *
+ * @description Educational concept map showing topic relationships and prerequisites
+ * @see {@link SoulcraftKitConfig}
+ */
+const conceptMap: SoulcraftKitConfig = {
+	"$schema": "https://soulcraft.com/schemas/kit/v2.json",
+	"id": "concept-map",
+	"name": "Concept Map / Learning Path",
+	"description": "Educational concept map showing topic relationships and prerequisites",
+	"version": "1.0.0",
+	"author": {
+		"name": "Soulcraft Labs",
+		"email": "kits@soulcraft.com",
+		"url": "https://soulcraft.com"
+	},
+	"status": "released",
+	"icon": "🎓",
+	"longDescription": "Create an interactive concept map for learning a new subject or organizing knowledge. Shows prerequisite relationships, related concepts, and learning progression. Perfect for students, teachers, or self-directed learning.",
+	"tags": [
+		"learning",
+		"education",
+		"concepts",
+		"study"
+	],
+	"role": "primary",
+	"type": "soulcraft",
+	"variables": [
+		{
+			"key": "subject",
+			"label": "Subject",
+			"description": "The topic or subject you are mapping",
+			"type": "string",
+			"required": true,
+			"example": "Machine Learning"
+		},
+		{
+			"key": "skillLevel",
+			"label": "Skill Level",
+			"description": "Your current level with this subject",
+			"type": "string",
+			"required": false,
+			"example": "Beginner"
+		}
+	],
+	"shared": {
+		"industry": "education",
+		"category": "knowledge",
+		"glossary": {},
+		"aiExpertise": [
+			"Concept mapping and knowledge organization",
+			"Learning path design",
+			"Prerequisite analysis",
+			"Educational content development",
+			"Curriculum design"
+		],
+		"dataModelHints": [
+			"topic",
+			"thing",
+			"document"
+		],
+		"suggestions": [
+			{
+				"label": "Add a concept",
+				"prompt": "Help me add a new concept to my concept map"
+			},
+			{
+				"label": "Connect concepts",
+				"prompt": "Help me identify and create connections between my concepts"
+			},
+			{
+				"label": "Explain a concept",
+				"prompt": "Help me write a clear explanation for one of my concepts"
+			},
+			{
+				"label": "Find patterns",
+				"prompt": "Analyze my concept map and identify patterns or clusters"
+			},
+			{
+				"label": "Expand a topic",
+				"prompt": "Help me break down a concept into sub-concepts"
+			},
+			{
+				"label": "View the mind map",
+				"prompt": "Show me my concepts in the mind map view"
+			}
+		],
+		"dataModel": {
+			"entities": [
+				{
+					"domain": "concept",
+					"type": "Concept",
+					"description": "A discrete idea or topic node in the knowledge map",
+					"products": {
+						"workshop": {
+							"view": "graph",
+							"icon": "💡"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "example",
+					"type": "Thing",
+					"description": "A concrete instance or illustration of a concept",
+					"products": {
+						"workshop": {
+							"view": "gallery",
+							"icon": "📦"
+						},
+						"academy": {
+							"mapsTo": "resource",
+							"assessable": false
+						}
+					}
+				},
+				{
+					"domain": "domain",
+					"type": "Concept",
+					"description": "A broad subject area grouping related concepts",
+					"products": {
+						"workshop": {
+							"view": "graph",
+							"icon": "🗂️"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": false
+						}
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "concept",
+					"to": "concept",
+					"verb": "RelatedTo",
+					"description": "General associative relationship between concepts"
+				},
+				{
+					"from": "concept",
+					"to": "concept",
+					"verb": "Contains",
+					"description": "Concept includes or subsumes another concept"
+				},
+				{
+					"from": "concept",
+					"to": "concept",
+					"verb": "Causes",
+					"description": "Causal relationship from one concept to another"
+				},
+				{
+					"from": "concept",
+					"to": "example",
+					"verb": "InstanceOf",
+					"description": "Concrete example of this concept"
+				}
+			]
+		}
+	},
+	"workshop": {
+		"workspaceConfig": {
+			"paradigm": "researcher",
+			"defaultTab": "explore",
+			"defaultView": "mindmap",
+			"defaultFile": "topics/overview.md"
+		},
+		"graphGuidance": {
+			"conceptCreation": {
+				"triggers": [
+					"When user identifies a new concept",
+					"When user describes a relationship",
+					"When user adds an example",
+					"When user creates a cross-link"
+				],
+				"typeMapping": {
+					"concept": "concept",
+					"example": "thing",
+					"domain": "concept"
+				}
+			},
+			"relationshipPatterns": [
+				{
+					"from": "concept",
+					"to": "concept",
+					"verb": "relatedTo",
+					"description": "General relationship"
+				},
+				{
+					"from": "concept",
+					"to": "concept",
+					"verb": "contains",
+					"description": "Concept includes another"
+				},
+				{
+					"from": "concept",
+					"to": "concept",
+					"verb": "causes",
+					"description": "Causal relationship"
+				},
+				{
+					"from": "concept",
+					"to": "thing",
+					"verb": "instanceOf",
+					"description": "Example of concept"
+				}
+			],
+			"rules": [
+				"Create concept entities with clear labels",
+				"Label all relationships with linking phrases",
+				"Track hierarchy levels",
+				"Note cross-links between domains"
+			]
+		},
+		"qualityGates": {
+			"fileChecks": [
+				{
+					"path": "README.md",
+					"required": [
+						"Learning Path"
+					],
+					"optional": [
+						"Focus Question",
+						"Prerequisites"
+					]
+				},
+				{
+					"path": "topics/*.md",
+					"required": [
+						"Prerequisites"
+					],
+					"optional": [
+						"Resources",
+						"Examples"
+					]
+				}
+			],
+			"projectChecks": [
+				"Focus question is defined",
+				"Concepts have prerequisite relationships",
+				"Linking words describe relationships",
+				"Hierarchy is clear (general to specific)",
+				"At least one cross-link exists between areas"
+			],
+			"exportReady": [
+				"All concepts have notes or resources",
+				"Prerequisite chains are complete",
+				"Cross-links are documented",
+				"Learning sequence is clear"
+			]
+		},
+		"aiPersona": {
+			"role": "You are an expert educator and learning designer helping learners map out complex subjects and build structured learning paths.",
+			"expertise": [
+				"Concept mapping methodology",
+				"Learning path design",
+				"Prerequisite chain analysis",
+				"Knowledge organization",
+				"Educational scaffolding"
+			],
+			"tone": "mentor"
+		},
+		"difficulty": "beginner",
+		"templateTier": 4,
+		"deploy": {
+			"provider": "cloud-run",
+			"buildCommand": "npm run build",
+			"outputDir": "build",
+			"config": {
+				"port": 3000,
+				"memory": "512Mi"
+			},
+			"oneClickCommand": "gcloud run deploy"
+		},
+		"sampleData": {
+			"description": "Sample concept map for learning Machine Learning fundamentals",
+			"entities": [
+				{
+					"type": "concept",
+					"name": "Machine Learning",
+					"properties": {
+						"description": "Field of AI that enables computers to learn from data without explicit programming.",
+						"status": "in_progress",
+						"difficulty": "beginner",
+						"createdAt": "2025-01-05"
+					}
+				},
+				{
+					"type": "concept",
+					"name": "Linear Algebra",
+					"properties": {
+						"description": "Mathematical foundation: vectors, matrices, transformations.",
+						"status": "done",
+						"difficulty": "prerequisite",
+						"createdAt": "2025-01-05"
+					}
+				},
+				{
+					"type": "concept",
+					"name": "Supervised Learning",
+					"properties": {
+						"description": "Learning from labeled training data.",
+						"status": "in_progress",
+						"difficulty": "intermediate",
+						"createdAt": "2025-01-08"
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "Linear Algebra",
+					"verb": "requires",
+					"to": "Machine Learning"
+				},
+				{
+					"from": "Supervised Learning",
+					"verb": "partOf",
+					"to": "Machine Learning"
+				}
+			]
+		}
+	},
+	"academy": {
+		"skillPath": "knowledge-mapping",
+		"level": "beginner",
+		"learningObjectives": [
+			"Decompose a complex subject into discrete, well-scoped concept nodes",
+			"Label relationships between concepts with precise linking phrases (causes, requires, extends)",
+			"Identify prerequisite chains and sequence learning from foundational to advanced topics",
+			"Spot gaps and cross-links in a knowledge map by reviewing graph structure"
+		],
+		"assessmentTypes": [
+			"portfolio",
+			"peer-review"
+		],
+		"certificationSlug": "knowledge-mapper"
+	}
+} satisfies SoulcraftKitConfig;
+
+export default conceptMap;