@soulcraft/kits 1.0.0

package/src/kits/wanderlands.ts

@@ -0,0 +1,401 @@
+/**
+ * @module @soulcraft/kits/kits/wanderlands
+ * @description Explore vast outdoor biomes, discover hidden caves, conquer the mountain peak
+ *
+ * Generated from: kits/wanderlands/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';
+
+/**
+ * Wanderlands kit configuration.
+ *
+ * @description Explore vast outdoor biomes, discover hidden caves, conquer the mountain peak
+ * @see {@link SoulcraftKitConfig}
+ */
+const wanderlands: SoulcraftKitConfig = {
+	"$schema": "https://soulcraft.com/schemas/kit/v2.json",
+	"id": "wanderlands",
+	"name": "Wanderlands",
+	"description": "Explore vast outdoor biomes, discover hidden caves, conquer the mountain peak",
+	"version": "1.0.0",
+	"author": {
+		"name": "Soulcraft Labs",
+		"email": "kits@soulcraft.com",
+		"url": "https://soulcraft.com"
+	},
+	"status": "beta",
+	"icon": "🗡️",
+	"longDescription": "A turn-based roguelike wilderness adventure that showcases rich Brainy storage for RPG game state. Explore 5 outdoor biomes from lush Woodlands to the frozen Mountain Peak, discover cave mini-dungeons, fight 100+ monster types, and unlock 10 character classes. Briggy AI provides narration, shop dialogue, and combat companion.",
+	"allowedUsers": [
+		"david@soulcraft.com"
+	],
+	"tags": [
+		"game",
+		"roguelike",
+		"exploration",
+		"rpg",
+		"adventure",
+		"inventory",
+		"brainy",
+		"sveltekit"
+	],
+	"role": "primary",
+	"type": "soulcraft",
+	"variables": [
+		{
+			"key": "appName",
+			"label": "App Name",
+			"description": "The name of your Wanderlands installation",
+			"type": "string",
+			"required": true,
+			"example": "wanderlands"
+		},
+		{
+			"key": "description",
+			"label": "Description",
+			"description": "A short description of your adventure",
+			"type": "string",
+			"required": false,
+			"example": "Explore vast wilderness biomes and discover hidden caves",
+			"default": "Explore vast wilderness biomes and discover hidden caves"
+		}
+	],
+	"shared": {
+		"industry": "games-entertainment",
+		"category": "games",
+		"aiExpertise": [
+			"RPG game mechanics and balancing",
+			"Roguelike design patterns",
+			"Procedural generation",
+			"Turn-based combat systems",
+			"Character progression design"
+		],
+		"dataModelHints": [
+			"person",
+			"thing",
+			"agent",
+			"location",
+			"event",
+			"concept",
+			"function"
+		],
+		"suggestions": [
+			{
+				"label": "Start adventure",
+				"prompt": "Start a new adventure run and help me explore"
+			},
+			{
+				"label": "Check inventory",
+				"prompt": "Show me my current inventory and equipped items"
+			},
+			{
+				"label": "View stats",
+				"prompt": "Show my character stats, level, and progression"
+			},
+			{
+				"label": "Combat tips",
+				"prompt": "Give me combat strategy tips for my current situation"
+			},
+			{
+				"label": "Run history",
+				"prompt": "Show my previous adventure runs and best achievements"
+			},
+			{
+				"label": "Customize Briggy",
+				"prompt": "Show me the Briggy AI personas and help me customize the narrator, merchant, or companion personality"
+			}
+		],
+		"dataModel": {
+			"entities": [
+				{
+					"domain": "character",
+					"type": "Person",
+					"description": "The player character with class, stats, and progression",
+					"products": {
+						"workshop": {
+							"view": "gallery",
+							"icon": "🧑"
+						},
+						"academy": {
+							"mapsTo": "learning-subject",
+							"assessable": false
+						}
+					}
+				},
+				{
+					"domain": "equipment",
+					"type": "Thing",
+					"description": "A weapon, armour, or accessory the character can equip",
+					"products": {
+						"workshop": {
+							"view": "gallery",
+							"icon": "⚔️"
+						},
+						"academy": {
+							"mapsTo": "resource",
+							"assessable": false
+						}
+					}
+				},
+				{
+					"domain": "consumable",
+					"type": "Thing",
+					"description": "A single-use item such as a potion or scroll",
+					"products": {
+						"workshop": {
+							"view": "gallery",
+							"icon": "🧪"
+						},
+						"academy": {
+							"mapsTo": "resource",
+							"assessable": false
+						}
+					}
+				},
+				{
+					"domain": "monster",
+					"type": "Person",
+					"description": "An enemy creature with combat stats and loot table",
+					"products": {
+						"workshop": {
+							"view": "gallery",
+							"icon": "👾"
+						},
+						"academy": {
+							"mapsTo": "learning-subject",
+							"assessable": false
+						}
+					}
+				},
+				{
+					"domain": "dungeon",
+					"type": "Location",
+					"description": "A cave or dungeon zone with floors, enemies, and rewards",
+					"products": {
+						"workshop": {
+							"view": "graph",
+							"icon": "🗺️"
+						}
+					}
+				},
+				{
+					"domain": "run",
+					"type": "Event",
+					"description": "A complete adventure run with depth, kills, and outcome",
+					"products": {
+						"workshop": {
+							"view": "timeline",
+							"icon": "🎲"
+						},
+						"academy": {
+							"mapsTo": "practice-session",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "achievement",
+					"type": "Concept",
+					"description": "A permanently unlocked achievement earned through gameplay",
+					"products": {
+						"workshop": {
+							"view": "gallery",
+							"icon": "🏆"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "skill",
+					"type": "Concept",
+					"description": "An active or passive skill in a character's ability kit",
+					"products": {
+						"workshop": {
+							"view": "graph",
+							"icon": "✨"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": true
+						}
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "character",
+					"to": "equipment",
+					"verb": "Owns",
+					"description": "Character has this item in inventory"
+				},
+				{
+					"from": "character",
+					"to": "equipment",
+					"verb": "Equips",
+					"description": "Character has this item currently equipped"
+				},
+				{
+					"from": "run",
+					"to": "character",
+					"verb": "Contains",
+					"description": "Adventure run is played by this character"
+				},
+				{
+					"from": "character",
+					"to": "achievement",
+					"verb": "Achieves",
+					"description": "Character has earned this achievement"
+				}
+			]
+		}
+	},
+	"workshop": {
+		"workspaceConfig": {
+			"paradigm": "creative",
+			"defaultTab": "app",
+			"defaultView": "app"
+		},
+		"graphGuidance": {
+			"conceptCreation": {
+				"typeMapping": {
+					"character": "person",
+					"equipment": "thing",
+					"consumable": "thing",
+					"monster": "agent",
+					"dungeon": "location",
+					"run": "event",
+					"achievement": "concept",
+					"skill": "function"
+				}
+			},
+			"relationshipPatterns": [
+				{
+					"from": "person",
+					"to": "thing",
+					"verb": "owns",
+					"description": "Character owns item"
+				},
+				{
+					"from": "person",
+					"to": "thing",
+					"verb": "equips",
+					"description": "Character has item equipped"
+				},
+				{
+					"from": "event",
+					"to": "person",
+					"verb": "contains",
+					"description": "Run uses character"
+				},
+				{
+					"from": "person",
+					"to": "concept",
+					"verb": "achieves",
+					"description": "Character earned achievement"
+				}
+			],
+			"rules": [
+				"Characters persist across runs",
+				"Equipment is stored with stats metadata",
+				"Runs track depth, kills, and loot",
+				"Achievements unlock permanently"
+			]
+		},
+		"qualityGates": {
+			"fileChecks": [
+				{
+					"path": "package.json",
+					"required": [
+						"svelte",
+						"@sveltejs/kit"
+					]
+				},
+				{
+					"path": "src/lib/game/Dungeon.ts",
+					"required": [
+						"generateFloor"
+					]
+				},
+				{
+					"path": "src/lib/game/Combat.ts",
+					"required": [
+						"Combat",
+						"attack"
+					]
+				}
+			],
+			"projectChecks": [
+				"App starts with npm run dev",
+				"Zones generate correctly",
+				"Combat system works",
+				"Inventory persists to Brainy",
+				"Character progression saves"
+			]
+		},
+		"publishConfig": {
+			"contentType": "app",
+			"publishable": false
+		},
+		"aiPersona": {
+			"role": "You are Briggy, a multi-role AI companion for Wanderlands: an encouraging adventure narrator, a friendly merchant who reveals secrets, and a loyal combat ally with enthusiastic battle commentary.",
+			"expertise": [
+				"RPG game mechanics",
+				"Adventure narration",
+				"Combat strategy",
+				"Item and inventory management",
+				"Character class optimization"
+			],
+			"tone": "collaborator"
+		},
+		"difficulty": "advanced",
+		"templateTier": 4,
+		"templateMetadata": {
+			"runnable": true,
+			"runnableCommand": "npm run dev"
+		},
+		"sampleData": {
+			"entities": [
+				{
+					"type": "person",
+					"name": "Hero",
+					"properties": {
+						"class": "warrior",
+						"level": 1,
+						"xp": 0,
+						"gold": 0,
+						"stats": {
+							"hp": 100,
+							"maxHp": 100,
+							"attack": 10,
+							"defense": 5
+						}
+					}
+				}
+			]
+		}
+	},
+	"academy": {
+		"skillPath": "game-development",
+		"level": "advanced",
+		"learningObjectives": [
+			"Implement turn-based combat with damage formulas, status effects, and AI decision logic",
+			"Design a procedural dungeon generator that produces varied but solvable floor layouts",
+			"Build a persistent game state layer that saves and restores character progression across sessions",
+			"Create a balanced character class system with distinct playstyles and late-game viability",
+			"Integrate an AI companion with context-aware dialogue that responds to game events"
+		],
+		"assessmentTypes": [
+			"demo",
+			"code-review",
+			"playtest"
+		],
+		"certificationSlug": "game-developer"
+	}
+} satisfies SoulcraftKitConfig;
+
+export default wanderlands;

package/src/kits/web-application.ts

@@ -0,0 +1,275 @@
+/**
+ * @module @soulcraft/kits/kits/web-application
+ * @description Clean SvelteKit + Brainy starting point for any web app
+ *
+ * Generated from: kits/web-application/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';
+
+/**
+ * Web Application kit configuration.
+ *
+ * @description Clean SvelteKit + Brainy starting point for any web app
+ * @see {@link SoulcraftKitConfig}
+ */
+const webApplication: SoulcraftKitConfig = {
+	"$schema": "https://soulcraft.com/schemas/kit/v2.json",
+	"id": "web-application",
+	"name": "Web Application",
+	"description": "Clean SvelteKit + Brainy starting point for any web app",
+	"version": "1.0.0",
+	"author": {
+		"name": "Soulcraft Labs",
+		"email": "kits@soulcraft.com",
+		"url": "https://soulcraft.com"
+	},
+	"status": "released",
+	"icon": "🌐",
+	"longDescription": "A minimal, clean SvelteKit + Brainy application template that serves as the reference implementation for all app templates. Includes modern SvelteKit 2 with Svelte 5 runes, TypeScript, a pre-configured Brainy client, and Workshop-integrated theming.",
+	"tags": [
+		"sveltekit",
+		"brainy",
+		"typescript",
+		"web-app",
+		"starter",
+		"reference"
+	],
+	"role": "primary",
+	"type": "soulcraft",
+	"variables": [
+		{
+			"key": "appName",
+			"label": "App Name",
+			"description": "The name of your web application",
+			"type": "string",
+			"required": true,
+			"example": "my-app"
+		},
+		{
+			"key": "description",
+			"label": "Description",
+			"description": "A short description of your application",
+			"type": "string",
+			"required": false,
+			"example": "A knowledge-powered web application",
+			"default": "A web application built with SvelteKit and Brainy"
+		}
+	],
+	"shared": {
+		"industry": "software-development",
+		"category": "development",
+		"aiExpertise": [
+			"SvelteKit application architecture",
+			"Brainy data modeling and querying",
+			"TypeScript and Svelte 5 runes",
+			"Server-side rendering patterns",
+			"Workshop app integration"
+		],
+		"dataModelHints": [
+			"system",
+			"concept"
+		],
+		"suggestions": [
+			{
+				"label": "Add a route",
+				"prompt": "Help me create a new SvelteKit route with a page component"
+			},
+			{
+				"label": "Create a component",
+				"prompt": "Help me create a reusable Svelte component"
+			},
+			{
+				"label": "Add Brainy query",
+				"prompt": "Help me add a Brainy query to fetch and display data"
+			},
+			{
+				"label": "Add a form",
+				"prompt": "Help me create a form that saves data to Brainy"
+			},
+			{
+				"label": "Run the app",
+				"prompt": "Run my app and show me the preview"
+			},
+			{
+				"label": "Debug an issue",
+				"prompt": "Help me debug an issue with my app"
+			}
+		],
+		"dataModel": {
+			"entities": [
+				{
+					"domain": "component",
+					"type": "Concept",
+					"description": "A reusable Svelte component in the application",
+					"products": {
+						"workshop": {
+							"view": "tree",
+							"icon": "🧩"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "route",
+					"type": "Concept",
+					"description": "A SvelteKit page or API route",
+					"products": {
+						"workshop": {
+							"view": "tree",
+							"icon": "🔗"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "type",
+					"type": "Concept",
+					"description": "A TypeScript type or interface defining data shape",
+					"products": {
+						"workshop": {
+							"view": "graph",
+							"icon": "📐"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": true
+						}
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "component",
+					"to": "component",
+					"verb": "Imports",
+					"description": "Component imports and uses another component"
+				},
+				{
+					"from": "route",
+					"to": "component",
+					"verb": "Renders",
+					"description": "Route renders this component"
+				}
+			]
+		}
+	},
+	"workshop": {
+		"workspaceConfig": {
+			"paradigm": "builder",
+			"defaultView": "app"
+		},
+		"graphGuidance": {
+			"conceptCreation": {
+				"triggers": [
+					"User creates a new component",
+					"User adds a new route",
+					"User defines a new data type"
+				],
+				"typeMapping": {
+					"component": "system",
+					"route": "system",
+					"type": "concept"
+				}
+			},
+			"relationshipPatterns": [
+				{
+					"from": "system",
+					"to": "system",
+					"verb": "imports",
+					"description": "Component imports another"
+				},
+				{
+					"from": "system",
+					"to": "system",
+					"verb": "renders",
+					"description": "Route renders component"
+				}
+			],
+			"rules": [
+				"Track component dependencies",
+				"Map routes to their components"
+			]
+		},
+		"qualityGates": {
+			"fileChecks": [
+				{
+					"path": "package.json",
+					"required": [
+						"svelte",
+						"@sveltejs/kit"
+					]
+				},
+				{
+					"path": "src/lib/brainy.ts",
+					"required": [
+						"BrainyClient",
+						"export"
+					]
+				}
+			],
+			"projectChecks": [
+				"App starts with npm run dev",
+				"Dashboard loads without errors",
+				"Brainy client initializes correctly"
+			],
+			"exportReady": [
+				"No TypeScript errors",
+				"All routes load correctly"
+			]
+		},
+		"aiPersona": {
+			"role": "You are a senior SvelteKit and Brainy developer helping users build clean, well-structured web applications using modern patterns and best practices.",
+			"expertise": [
+				"SvelteKit routing and layouts",
+				"Svelte 5 runes and reactivity",
+				"Brainy data modeling",
+				"TypeScript strict mode",
+				"Workshop app architecture"
+			],
+			"tone": "collaborator"
+		},
+		"difficulty": "intermediate",
+		"templateTier": 4,
+		"templateMetadata": {
+			"identifyByStructure": true,
+			"runnable": true,
+			"runnableCommand": "npm run dev"
+		},
+		"deploy": {
+			"provider": "cloud-run",
+			"buildCommand": "npm run build",
+			"outputDir": "build",
+			"config": {
+				"port": 3000,
+				"memory": "512Mi"
+			},
+			"oneClickCommand": "gcloud run deploy"
+		}
+	},
+	"academy": {
+		"skillPath": "web-development",
+		"level": "intermediate",
+		"learningObjectives": [
+			"Set up a SvelteKit application with server-side rendering, TypeScript strict mode, and Brainy data access",
+			"Model application data as typed Brainy entities and write queries with filtering and relationship traversal",
+			"Build form actions with server-side validation and optimistic UI feedback",
+			"Implement authentication and protect server routes against unauthenticated access",
+			"Deploy the application to a cloud provider and verify production behaviour"
+		],
+		"assessmentTypes": [
+			"demo",
+			"code-review"
+		],
+		"certificationSlug": "web-developer"
+	}
+} satisfies SoulcraftKitConfig;
+
+export default webApplication;