@soulcraft/kits 1.0.0

package/src/kits/character-relationship-map.ts

@@ -0,0 +1,368 @@
+/**
+ * @module @soulcraft/kits/kits/character-relationship-map
+ * @description Visual map of character relationships for fiction writing
+ *
+ * Generated from: kits/character-relationship-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';
+
+/**
+ * Character Relationship Map kit configuration.
+ *
+ * @description Visual map of character relationships for fiction writing
+ * @see {@link SoulcraftKitConfig}
+ */
+const characterRelationshipMap: SoulcraftKitConfig = {
+	"$schema": "https://soulcraft.com/schemas/kit/v2.json",
+	"id": "character-relationship-map",
+	"name": "Character Relationship Map",
+	"description": "Visual map of character relationships for fiction writing",
+	"version": "1.0.0",
+	"author": {
+		"name": "Soulcraft Labs",
+		"email": "kits@soulcraft.com",
+		"url": "https://soulcraft.com"
+	},
+	"status": "released",
+	"icon": "🎭",
+	"longDescription": "Create an interactive character relationship map for your story. Shows connections, conflicts, alliances, and dynamics between characters. Perfect for novelists, screenwriters, or tabletop RPG worldbuilding.",
+	"tags": [
+		"characters",
+		"fiction",
+		"relationships",
+		"storytelling"
+	],
+	"role": "primary",
+	"type": "soulcraft",
+	"variables": [
+		{
+			"key": "storyTitle",
+			"label": "Story Title",
+			"description": "The title of your story or world",
+			"type": "string",
+			"required": true,
+			"example": "My Novel"
+		},
+		{
+			"key": "genre",
+			"label": "Genre",
+			"description": "The genre of your story",
+			"type": "string",
+			"required": false,
+			"example": "Fantasy"
+		}
+	],
+	"shared": {
+		"industry": "creative-writing",
+		"category": "creative",
+		"glossary": {
+			"protagonist": "The main character driving the story forward",
+			"antagonist": "The opposing force creating conflict for the protagonist",
+			"faction": "A group of characters with shared allegiances or goals"
+		},
+		"aiExpertise": [
+			"Character development and psychology",
+			"Relationship dynamics and conflict",
+			"Story structure and narrative arcs",
+			"Worldbuilding and faction design",
+			"Character voice and motivation"
+		],
+		"dataModelHints": [
+			"person",
+			"thing",
+			"event",
+			"topic"
+		],
+		"suggestions": [
+			{
+				"label": "Add a character",
+				"prompt": "Help me create a new character with their background and traits"
+			},
+			{
+				"label": "Define a relationship",
+				"prompt": "Help me define the relationship between two characters"
+			},
+			{
+				"label": "Develop backstory",
+				"prompt": "Help me develop a deeper backstory for one of my characters"
+			},
+			{
+				"label": "Find conflicts",
+				"prompt": "Analyze my character relationships and suggest potential conflicts or tensions"
+			},
+			{
+				"label": "Character arc planning",
+				"prompt": "Help me plan a character arc for one of my characters"
+			},
+			{
+				"label": "Explore relationships",
+				"prompt": "Show me all character relationships in the graph view"
+			}
+		],
+		"dataModel": {
+			"entities": [
+				{
+					"domain": "character",
+					"type": "Person",
+					"description": "A named character with role, backstory, and motivation",
+					"products": {
+						"workshop": {
+							"view": "gallery",
+							"icon": "🧑"
+						},
+						"academy": {
+							"mapsTo": "learning-subject",
+							"assessable": false
+						}
+					}
+				},
+				{
+					"domain": "faction",
+					"type": "Concept",
+					"description": "A group or organization with shared allegiances and goals",
+					"products": {
+						"workshop": {
+							"view": "graph",
+							"icon": "⚔️"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "group",
+					"type": "Concept",
+					"description": "A social group characters belong to",
+					"products": {
+						"workshop": {
+							"view": "graph",
+							"icon": "👥"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": false
+						}
+					}
+				},
+				{
+					"domain": "place",
+					"type": "Location",
+					"description": "A significant location associated with characters",
+					"products": {
+						"workshop": {
+							"view": "graph",
+							"icon": "📍"
+						}
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "character",
+					"to": "character",
+					"verb": "Conflicts",
+					"description": "Characters are in opposition or rivalry"
+				},
+				{
+					"from": "character",
+					"to": "character",
+					"verb": "FriendOf",
+					"description": "Allied or friendly relationship"
+				},
+				{
+					"from": "character",
+					"to": "character",
+					"verb": "Mentors",
+					"description": "Teacher or guide relationship"
+				},
+				{
+					"from": "character",
+					"to": "character",
+					"verb": "RelatedTo",
+					"description": "Family or romantic connection"
+				},
+				{
+					"from": "character",
+					"to": "faction",
+					"verb": "MemberOf",
+					"description": "Character belongs to this group or faction"
+				},
+				{
+					"from": "character",
+					"to": "place",
+					"verb": "LocatedAt",
+					"description": "Character's home or base location"
+				}
+			]
+		}
+	},
+	"workshop": {
+		"workspaceConfig": {
+			"paradigm": "creative",
+			"defaultTab": "explore",
+			"defaultView": "graph",
+			"defaultFile": "characters/protagonist.md"
+		},
+		"graphGuidance": {
+			"conceptCreation": {
+				"triggers": [
+					"When user introduces a new character by name",
+					"When user describes a group or faction",
+					"When user mentions a significant location",
+					"When user describes an organization"
+				],
+				"typeMapping": {
+					"character": "person",
+					"faction": "organization",
+					"group": "socialGroup",
+					"place": "location",
+					"family": "socialGroup"
+				}
+			},
+			"relationshipPatterns": [
+				{
+					"from": "person",
+					"to": "person",
+					"verb": "conflicts",
+					"description": "Characters in opposition or rivalry"
+				},
+				{
+					"from": "person",
+					"to": "person",
+					"verb": "friendOf",
+					"description": "Allied or friendly characters"
+				},
+				{
+					"from": "person",
+					"to": "person",
+					"verb": "mentors",
+					"description": "Teacher/student or guide relationship"
+				},
+				{
+					"from": "person",
+					"to": "person",
+					"verb": "relatedTo",
+					"description": "Family or romantic connection"
+				},
+				{
+					"from": "person",
+					"to": "person",
+					"verb": "opposes",
+					"description": "Direct opposition or antagonism"
+				},
+				{
+					"from": "person",
+					"to": "organization",
+					"verb": "memberOf",
+					"description": "Character belongs to a group"
+				},
+				{
+					"from": "person",
+					"to": "location",
+					"verb": "locatedAt",
+					"description": "Character's home or base"
+				}
+			],
+			"rules": [
+				"Create person entities for named characters",
+				"Link characters when relationships are mentioned",
+				"Track faction allegiances with memberOf relationships",
+				"Use conflicts verb for antagonistic relationships",
+				"Use relatedTo for family and romantic bonds"
+			]
+		},
+		"aiPersona": {
+			"role": "You are an expert narrative designer and fiction writing coach helping writers create vivid, interconnected characters with compelling relationship dynamics.",
+			"expertise": [
+				"Character psychology and motivation",
+				"Relationship dynamics and conflict arcs",
+				"Faction and group dynamics",
+				"Backstory and world history",
+				"Character voice and consistency"
+			],
+			"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 character relationship map for a fantasy novel",
+			"entities": [
+				{
+					"type": "person",
+					"name": "Elena Stormbringer",
+					"properties": {
+						"role": "protagonist",
+						"age": 24,
+						"description": "A reluctant hero with hidden magical abilities. Grew up as an orphan in the coastal village of Saltmere.",
+						"status": "main",
+						"createdAt": "2025-01-05"
+					}
+				},
+				{
+					"type": "person",
+					"name": "Lord Varen Blackthorn",
+					"properties": {
+						"role": "antagonist",
+						"age": 45,
+						"description": "The power-hungry sorcerer seeking to control the realm's magic. Once a respected mage.",
+						"status": "main",
+						"createdAt": "2025-01-05"
+					}
+				},
+				{
+					"type": "person",
+					"name": "Kira Sunweaver",
+					"properties": {
+						"role": "mentor",
+						"age": 68,
+						"description": "Wise elder mage who recognizes Elena's potential. Carries secrets about her past.",
+						"status": "main",
+						"createdAt": "2025-01-06"
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "Elena Stormbringer",
+					"verb": "conflicts",
+					"to": "Lord Varen Blackthorn"
+				},
+				{
+					"from": "Kira Sunweaver",
+					"verb": "mentors",
+					"to": "Elena Stormbringer"
+				}
+			]
+		}
+	},
+	"academy": {
+		"skillPath": "creative-writing",
+		"level": "beginner",
+		"learningObjectives": [
+			"Build character profiles with distinct motivation, want vs. need, and internal contradiction",
+			"Map relationship dynamics using named relationship types (mentor, rival, ally, foil)",
+			"Identify how character relationships create or resolve narrative conflict",
+			"Trace a character arc from start state to end state through key story events"
+		],
+		"assessmentTypes": [
+			"portfolio"
+		],
+		"certificationSlug": "character-designer"
+	}
+} satisfies SoulcraftKitConfig;
+
+export default characterRelationshipMap;