@soulcraft/kits 1.0.0

package/src/kits/family-tree.ts

@@ -0,0 +1,381 @@
+/**
+ * @module @soulcraft/kits/kits/family-tree
+ * @description Visual family tree with person profiles and relationship mapping
+ *
+ * Generated from: kits/family-tree/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';
+
+/**
+ * Family Tree kit configuration.
+ *
+ * @description Visual family tree with person profiles and relationship mapping
+ * @see {@link SoulcraftKitConfig}
+ */
+const familyTree: SoulcraftKitConfig = {
+	"$schema": "https://soulcraft.com/schemas/kit/v2.json",
+	"id": "family-tree",
+	"name": "Family Tree",
+	"description": "Visual family tree with person profiles and relationship mapping",
+	"version": "1.0.0",
+	"author": {
+		"name": "Soulcraft Labs",
+		"email": "kits@soulcraft.com",
+		"url": "https://soulcraft.com"
+	},
+	"status": "released",
+	"icon": "👪",
+	"longDescription": "Create a beautiful, interactive family tree that automatically visualizes in the graph view. Each person gets their own profile document, and all relationships (parent-child, spouses, siblings) are connected in the knowledge graph. Perfect for genealogy research, family history projects, or understanding complex family dynamics.",
+	"tags": [
+		"family",
+		"genealogy",
+		"relationships",
+		"visualization"
+	],
+	"role": "primary",
+	"type": "soulcraft",
+	"variables": [
+		{
+			"key": "familyName",
+			"label": "Family Name",
+			"description": "The name of your family",
+			"type": "string",
+			"required": true,
+			"example": "The Smith Family"
+		},
+		{
+			"key": "location",
+			"label": "Primary Location",
+			"description": "Where the family is primarily based",
+			"type": "string",
+			"required": false,
+			"example": "California, USA"
+		}
+	],
+	"shared": {
+		"industry": "personal-productivity",
+		"category": "knowledge",
+		"glossary": {
+			"generation": "A group of people born and living at around the same time",
+			"lineage": "The direct line of descent from an ancestor"
+		},
+		"aiExpertise": [
+			"Genealogy research methods",
+			"Family history documentation",
+			"Relationship mapping",
+			"Oral history preservation",
+			"Ancestral record analysis"
+		],
+		"dataModelHints": [
+			"person",
+			"event",
+			"thing",
+			"topic"
+		],
+		"suggestions": [
+			{
+				"label": "Add a family member",
+				"prompt": "Help me add a new family member to the tree"
+			},
+			{
+				"label": "Record a story",
+				"prompt": "Help me record a family story or memory"
+			},
+			{
+				"label": "Define relationships",
+				"prompt": "Help me map out the relationships between family members"
+			},
+			{
+				"label": "Create a timeline",
+				"prompt": "Help me create a timeline of important family events"
+			},
+			{
+				"label": "Find connections",
+				"prompt": "Show me how family members are connected across generations"
+			},
+			{
+				"label": "Explore the tree",
+				"prompt": "Show me my family tree in the tree view"
+			}
+		],
+		"dataModel": {
+			"entities": [
+				{
+					"domain": "person",
+					"type": "Person",
+					"description": "A family member with biographical details and dates",
+					"products": {
+						"workshop": {
+							"view": "gallery",
+							"icon": "🧑"
+						},
+						"academy": {
+							"mapsTo": "learning-subject",
+							"assessable": false
+						}
+					}
+				},
+				{
+					"domain": "family",
+					"type": "Concept",
+					"description": "A nuclear family unit grouping related members",
+					"products": {
+						"workshop": {
+							"view": "graph",
+							"icon": "🏡"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": false
+						}
+					}
+				},
+				{
+					"domain": "event",
+					"type": "Event",
+					"description": "A significant life event such as birth, marriage, or death",
+					"products": {
+						"workshop": {
+							"view": "timeline",
+							"icon": "📅"
+						},
+						"academy": {
+							"mapsTo": "practice-session",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "location",
+					"type": "Location",
+					"description": "A place associated with family history such as birthplace or residence",
+					"products": {
+						"workshop": {
+							"view": "graph",
+							"icon": "📍"
+						}
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "person",
+					"to": "person",
+					"verb": "ChildOf",
+					"description": "Parent-child relationship"
+				},
+				{
+					"from": "person",
+					"to": "person",
+					"verb": "SpouseOf",
+					"description": "Marriage or partnership"
+				},
+				{
+					"from": "person",
+					"to": "person",
+					"verb": "SiblingOf",
+					"description": "Brother or sister relationship"
+				},
+				{
+					"from": "person",
+					"to": "family",
+					"verb": "MemberOf",
+					"description": "Person belongs to this family unit"
+				},
+				{
+					"from": "person",
+					"to": "location",
+					"verb": "BornIn",
+					"description": "Person's birthplace"
+				},
+				{
+					"from": "person",
+					"to": "event",
+					"verb": "ParticipatedIn",
+					"description": "Person took part in this life event"
+				}
+			]
+		}
+	},
+	"workshop": {
+		"workspaceConfig": {
+			"paradigm": "creative",
+			"defaultTab": "explore",
+			"defaultView": "tree",
+			"defaultFile": "people/self.md"
+		},
+		"graphGuidance": {
+			"conceptCreation": {
+				"triggers": [
+					"When adding a new family member",
+					"When documenting a marriage or partnership",
+					"When identifying a new family branch",
+					"When recording important events (births, deaths, marriages)"
+				],
+				"typeMapping": {
+					"person": "person",
+					"family member": "person",
+					"relative": "person",
+					"family": "organization",
+					"event": "event",
+					"location": "location",
+					"generation": "category"
+				}
+			},
+			"relationshipPatterns": [
+				{
+					"from": "Person",
+					"to": "Person",
+					"verb": "childOf",
+					"description": "Parent-child relationship"
+				},
+				{
+					"from": "Person",
+					"to": "Person",
+					"verb": "spouseOf",
+					"description": "Marriage or partnership"
+				},
+				{
+					"from": "Person",
+					"to": "Person",
+					"verb": "siblingOf",
+					"description": "Brother or sister"
+				},
+				{
+					"from": "Person",
+					"to": "Family",
+					"verb": "memberOf",
+					"description": "Belongs to family unit"
+				},
+				{
+					"from": "Person",
+					"to": "Location",
+					"verb": "bornIn",
+					"description": "Birthplace"
+				},
+				{
+					"from": "Person",
+					"to": "Location",
+					"verb": "livedIn",
+					"description": "Residence"
+				},
+				{
+					"from": "Person",
+					"to": "Event",
+					"verb": "participatedIn",
+					"description": "Life event"
+				}
+			],
+			"rules": [
+				"Every person should have parents documented (even if unknown)",
+				"Spouses link bidirectionally",
+				"Children link to both parents when known",
+				"Family units group nuclear families",
+				"Locations should be reused when they refer to the same place"
+			]
+		},
+		"qualityGates": {
+			"fileChecks": [
+				{
+					"path": "members/*.md",
+					"required": [
+						"Birth Date"
+					],
+					"optional": [
+						"Biography",
+						"Photos",
+						"Notes"
+					]
+				}
+			],
+			"projectChecks": [
+				"At least one generation is documented",
+				"Person profiles have relationship information",
+				"No orphan people (everyone connects to someone)",
+				"Key dates are recorded"
+			],
+			"exportReady": [
+				"All people have at least birth year",
+				"Relationships are documented for all members",
+				"Names are complete (not placeholders)",
+				"Sources are noted for key facts"
+			]
+		},
+		"aiPersona": {
+			"role": "You are an expert genealogist and family historian helping people document, research, and visualize their family trees and heritage.",
+			"expertise": [
+				"Genealogy research and documentation",
+				"Family history preservation",
+				"Relationship and kinship mapping",
+				"Historical records and archives",
+				"Oral history collection"
+			],
+			"tone": "collaborator"
+		},
+		"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 family tree spanning four generations",
+			"entities": [
+				{
+					"type": "person",
+					"name": "Robert Mitchell Sr.",
+					"properties": {
+						"birthDate": "1920-05-12",
+						"deathDate": "1998-11-03",
+						"birthPlace": "Boston, MA",
+						"description": "Family patriarch. Immigrated from Ireland as a child. Worked as a carpenter.",
+						"generation": 1
+					}
+				},
+				{
+					"type": "person",
+					"name": "Eleanor Mitchell",
+					"properties": {
+						"birthDate": "1924-08-20",
+						"deathDate": "2010-03-15",
+						"birthPlace": "Boston, MA",
+						"maidenName": "O'Brien",
+						"description": "Homemaker and community volunteer. Met Robert at a church social.",
+						"generation": 1
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "Robert Mitchell Sr.",
+					"verb": "worksWith",
+					"to": "Eleanor Mitchell"
+				}
+			]
+		}
+	},
+	"academy": {
+		"skillPath": "genealogy",
+		"level": "beginner",
+		"learningObjectives": [
+			"Record biographical profiles for family members with birth, marriage, and death data",
+			"Map kinship relationships (parent-child, spouse, sibling) across multiple generations",
+			"Identify and document primary sources for key genealogical facts",
+			"Construct a multi-generation family tree and interpret lines of descent"
+		],
+		"assessmentTypes": [
+			"portfolio"
+		],
+		"certificationSlug": "genealogist"
+	}
+} satisfies SoulcraftKitConfig;
+
+export default familyTree;

package/src/kits/farkle-dice-game.ts

@@ -0,0 +1,318 @@
+/**
+ * @module @soulcraft/kits/kits/farkle-dice-game
+ * @description Classic dice game with 3D animations - play solo against Briggy AI
+ *
+ * Generated from: kits/farkle-dice-game/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';
+
+/**
+ * Farkle Dice Game kit configuration.
+ *
+ * @description Classic dice game with 3D animations - play solo against Briggy AI
+ * @see {@link SoulcraftKitConfig}
+ */
+const farkleDiceGame: SoulcraftKitConfig = {
+	"$schema": "https://soulcraft.com/schemas/kit/v2.json",
+	"id": "farkle-dice-game",
+	"name": "Farkle Dice Game",
+	"description": "Classic dice game with 3D animations - play solo against Briggy AI",
+	"version": "1.0.0",
+	"author": {
+		"name": "Soulcraft Labs",
+		"email": "kits@soulcraft.com",
+		"url": "https://soulcraft.com"
+	},
+	"status": "released",
+	"icon": "🎲",
+	"longDescription": "Farkle is a classic push-your-luck dice game. Roll six dice, score combinations, and decide whether to bank your points or risk it all for more!\n\n**Features:**\n- Beautiful 3D CSS dice with smooth animations\n- Play against Briggy AI opponent\n- Multiplayer support in Collaborative mode\n- Complete Farkle scoring rules\n- Game history and statistics\n- Persistent high scores\n\n**Rules:**\n- Roll 6 dice, score combinations (1s, 5s, triples, straights)\n- After scoring, choose to bank points or roll remaining dice\n- Roll with no scoring dice = bust (lose all unbanked points)\n- First to 10,000 points wins!\n\n**Scoring:**\n- Single 1 = 100 points\n- Single 5 = 50 points\n- Three of a kind = face value × 100 (e.g., three 3s = 300)\n- Three 1s = 1,000 points\n- Four of a kind = triple score × 2\n- Five of a kind = triple score × 4\n- Six of a kind = triple score × 8\n- 1-2-3-4-5-6 straight = 1,500 points\n- Three pairs = 1,500 points",
+	"tags": [
+		"game",
+		"dice",
+		"farkle",
+		"multiplayer",
+		"ai-opponent",
+		"brainy",
+		"sveltekit"
+	],
+	"role": "primary",
+	"type": "soulcraft",
+	"variables": [
+		{
+			"key": "appName",
+			"label": "App Name",
+			"description": "The slug name for the application",
+			"type": "string",
+			"required": true,
+			"example": "farkle"
+		},
+		{
+			"key": "description",
+			"label": "Description",
+			"description": "A short description of the game",
+			"type": "string",
+			"required": false,
+			"example": "A classic dice game of risk and reward"
+		}
+	],
+	"shared": {
+		"industry": "games-entertainment",
+		"category": "games",
+		"glossary": {
+			"farkle": "Rolling dice with no scoring combinations, causing a bust",
+			"bank": "Lock in your current score and end your turn safely"
+		},
+		"aiExpertise": [
+			"Farkle game rules and scoring",
+			"Probability and dice game strategy",
+			"Game history and statistics",
+			"Optimal play analysis"
+		],
+		"dataModelHints": [
+			"event",
+			"person",
+			"thing"
+		],
+		"suggestions": [
+			{
+				"label": "Play against Briggy",
+				"prompt": "Start a new game of Farkle against the AI opponent"
+			},
+			{
+				"label": "Explain the rules",
+				"prompt": "Explain the rules and scoring for Farkle"
+			},
+			{
+				"label": "Best strategy",
+				"prompt": "What's the optimal strategy for playing Farkle? When should I bank vs roll again?"
+			},
+			{
+				"label": "My statistics",
+				"prompt": "Show me my game statistics - wins, losses, and high scores"
+			},
+			{
+				"label": "Game history",
+				"prompt": "Show my recent Farkle games and how they went"
+			},
+			{
+				"label": "Run the app",
+				"prompt": "Run the Farkle game so I can play"
+			}
+		],
+		"dataModel": {
+			"entities": [
+				{
+					"domain": "game",
+					"type": "Event",
+					"description": "A complete game session from start to finish",
+					"products": {
+						"workshop": {
+							"view": "timeline",
+							"icon": "🎲"
+						},
+						"academy": {
+							"mapsTo": "practice-session",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "player",
+					"type": "Person",
+					"description": "A human or AI player with score history",
+					"products": {
+						"workshop": {
+							"view": "gallery",
+							"icon": "👤"
+						},
+						"academy": {
+							"mapsTo": "learning-subject",
+							"assessable": false
+						}
+					}
+				},
+				{
+					"domain": "turn",
+					"type": "Event",
+					"description": "A single turn within a game with dice rolls and banking decisions",
+					"products": {
+						"workshop": {
+							"view": "board",
+							"icon": "🎯"
+						},
+						"academy": {
+							"mapsTo": "practice-session",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "score",
+					"type": "Measurement",
+					"description": "A numeric score recorded for a player in a game",
+					"products": {
+						"workshop": {
+							"view": "stats",
+							"icon": "📊"
+						},
+						"academy": {
+							"mapsTo": "assessment-criterion",
+							"assessable": false
+						}
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "game",
+					"to": "player",
+					"verb": "Contains",
+					"description": "Game includes this player"
+				},
+				{
+					"from": "game",
+					"to": "turn",
+					"verb": "Contains",
+					"description": "Game is composed of turns"
+				},
+				{
+					"from": "score",
+					"to": "game",
+					"verb": "PartOf",
+					"description": "Score belongs to this game session"
+				}
+			]
+		}
+	},
+	"workshop": {
+		"workspaceConfig": {
+			"paradigm": "creative",
+			"defaultTab": "app",
+			"defaultView": "app"
+		},
+		"graphGuidance": {
+			"conceptCreation": {
+				"typeMapping": {
+					"game": "event",
+					"player": "person",
+					"turn": "event",
+					"score": "measurement"
+				}
+			},
+			"relationshipPatterns": [
+				{
+					"from": "event",
+					"to": "person",
+					"verb": "contains",
+					"description": "Game includes player"
+				},
+				{
+					"from": "event",
+					"to": "event",
+					"verb": "contains",
+					"description": "Game contains turns"
+				},
+				{
+					"from": "measurement",
+					"to": "event",
+					"verb": "partOf",
+					"description": "Score belongs to game"
+				}
+			],
+			"rules": [
+				"Each game tracks all players",
+				"Turns record dice rolls and decisions",
+				"High scores are persisted"
+			]
+		},
+		"qualityGates": {
+			"fileChecks": [
+				{
+					"path": "package.json",
+					"required": [
+						"svelte",
+						"@sveltejs/kit"
+					]
+				},
+				{
+					"path": "src/lib/game/scoring.ts",
+					"required": [
+						"scoreDice",
+						"isFarkle"
+					]
+				},
+				{
+					"path": "src/lib/components/Die.svelte",
+					"required": [
+						"face",
+						"rolling"
+					]
+				}
+			],
+			"projectChecks": [
+				"App starts with npm run dev",
+				"Dice roll with smooth 3D animation",
+				"Scoring calculates correctly",
+				"AI opponent makes strategic decisions",
+				"Games persist to Brainy"
+			],
+			"exportReady": [
+				"No TypeScript errors",
+				"All animations perform at 60fps"
+			]
+		},
+		"aiPersona": {
+			"role": "You are a game companion helping players learn Farkle strategy, track scores, and enjoy the game.",
+			"expertise": [
+				"Farkle rules and scoring combinations",
+				"Probability and risk assessment",
+				"Game strategy optimization",
+				"SvelteKit and TypeScript game development"
+			],
+			"tone": "collaborator"
+		},
+		"difficulty": "intermediate",
+		"templateTier": 4,
+		"templateMetadata": {
+			"runnable": true,
+			"runnableCommand": "npm run dev"
+		},
+		"deploy": {
+			"provider": "cloud-run",
+			"buildCommand": "npm run build",
+			"outputDir": "build",
+			"config": {
+				"port": 3000,
+				"memory": "512Mi"
+			}
+		},
+		"sampleData": {
+			"entities": [
+				{
+					"type": "person",
+					"name": "Player 1",
+					"properties": {
+						"role": "player",
+						"gamesPlayed": 0,
+						"gamesWon": 0,
+						"highScore": 0
+					}
+				},
+				{
+					"type": "person",
+					"name": "Briggy",
+					"properties": {
+						"role": "ai",
+						"difficulty": "medium",
+						"description": "Your AI opponent"
+					}
+				}
+			],
+			"relationships": []
+		}
+	}
+} satisfies SoulcraftKitConfig;
+
+export default farkleDiceGame;