@soulcraft/kits 1.0.0

package/src/kits/novel-writing-system.ts

@@ -0,0 +1,461 @@
+/**
+ * @module @soulcraft/kits/kits/novel-writing-system
+ * @description Complete novel writing workspace with character development, worldbuilding, and manuscript organization
+ *
+ * Generated from: kits/novel-writing-system/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';
+
+/**
+ * Novel Writing System kit configuration.
+ *
+ * @description Complete novel writing workspace with character development, worldbuilding, and manuscript organization
+ * @see {@link SoulcraftKitConfig}
+ */
+const novelWritingSystem: SoulcraftKitConfig = {
+	"$schema": "https://soulcraft.com/schemas/kit/v2.json",
+	"id": "novel-writing-system",
+	"name": "Novel Writing System",
+	"description": "Complete novel writing workspace with character development, worldbuilding, and manuscript organization",
+	"version": "1.0.0",
+	"author": {
+		"name": "Soulcraft Labs",
+		"email": "kits@soulcraft.com",
+		"url": "https://soulcraft.com"
+	},
+	"status": "released",
+	"icon": "📖",
+	"longDescription": "A comprehensive system for novelists that includes character profiles with relationship mapping, worldbuilding documentation, three-act structure outline, chapter organization, and integrated timeline. Perfect for fiction writers who want their story elements connected through Workshop's knowledge graph.",
+	"tags": [
+		"fiction",
+		"creative-writing",
+		"novels",
+		"storytelling"
+	],
+	"role": "primary",
+	"type": "soulcraft",
+	"variables": [
+		{
+			"key": "projectName",
+			"label": "Novel Title",
+			"description": "The title of your novel",
+			"type": "string",
+			"required": true,
+			"example": "The Hidden Kingdom"
+		},
+		{
+			"key": "author",
+			"label": "Author Name",
+			"description": "The author's name",
+			"type": "string",
+			"required": false,
+			"example": "Your Name"
+		},
+		{
+			"key": "genre",
+			"label": "Genre",
+			"description": "Primary genre (Fantasy, Sci-Fi, Mystery, etc.)",
+			"type": "string",
+			"required": false,
+			"example": "Fantasy"
+		},
+		{
+			"key": "targetWordCount",
+			"label": "Target Word Count",
+			"description": "Your target final word count",
+			"type": "string",
+			"required": false,
+			"example": "80000"
+		}
+	],
+	"shared": {
+		"industry": "creative-writing",
+		"category": "creative",
+		"glossary": {
+			"inciting incident": "The event that disrupts the protagonist's ordinary world and sets the story in motion",
+			"midpoint": "The story's central turning point, often a false victory or defeat",
+			"character arc": "The internal transformation a character undergoes through the story"
+		},
+		"aiExpertise": [
+			"Fiction writing and story structure",
+			"Character development and psychology",
+			"Worldbuilding and setting design",
+			"Plot architecture and pacing",
+			"Dialogue and scene writing"
+		],
+		"dataModelHints": [
+			"person",
+			"event",
+			"document",
+			"topic",
+			"thing"
+		],
+		"suggestions": [
+			{
+				"label": "Develop a character",
+				"prompt": "Help me create a new character with personality, backstory, and motivations"
+			},
+			{
+				"label": "Outline a chapter",
+				"prompt": "Help me outline the next chapter of my novel"
+			},
+			{
+				"label": "Write a scene",
+				"prompt": "Help me write a scene with vivid description and dialogue"
+			},
+			{
+				"label": "Track plot threads",
+				"prompt": "Review my plot threads and identify any loose ends"
+			},
+			{
+				"label": "Build the world",
+				"prompt": "Help me develop a world-building detail for my story"
+			},
+			{
+				"label": "View story structure",
+				"prompt": "Show me my novel's structure in the tree view"
+			}
+		],
+		"dataModel": {
+			"entities": [
+				{
+					"domain": "character",
+					"type": "Person",
+					"description": "A fictional character with arc, motivation, and relationships",
+					"products": {
+						"workshop": {
+							"view": "gallery",
+							"icon": "🧑"
+						},
+						"academy": {
+							"mapsTo": "learning-subject",
+							"assessable": false
+						}
+					}
+				},
+				{
+					"domain": "location",
+					"type": "Location",
+					"description": "A place in the story world where scenes unfold",
+					"products": {
+						"workshop": {
+							"view": "graph",
+							"icon": "📍"
+						}
+					}
+				},
+				{
+					"domain": "chapter",
+					"type": "Document",
+					"description": "A numbered chapter in the manuscript",
+					"products": {
+						"workshop": {
+							"view": "tree",
+							"icon": "📄"
+						},
+						"academy": {
+							"mapsTo": "learning-artifact",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "scene",
+					"type": "Document",
+					"description": "A discrete scene within a chapter, tied to characters and locations",
+					"products": {
+						"workshop": {
+							"view": "board",
+							"icon": "🎬"
+						},
+						"academy": {
+							"mapsTo": "learning-artifact",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "theme",
+					"type": "Concept",
+					"description": "A recurring thematic idea embodied by characters or events",
+					"products": {
+						"workshop": {
+							"view": "graph",
+							"icon": "💡"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "subplot",
+					"type": "Concept",
+					"description": "A secondary narrative thread running alongside the main plot",
+					"products": {
+						"workshop": {
+							"view": "graph",
+							"icon": "🧵"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": true
+						}
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "character",
+					"to": "character",
+					"verb": "Conflicts",
+					"description": "Character is in opposition or rivalry with another character"
+				},
+				{
+					"from": "character",
+					"to": "character",
+					"verb": "RelatedTo",
+					"description": "Family or romantic relationship between characters"
+				},
+				{
+					"from": "character",
+					"to": "theme",
+					"verb": "Embodies",
+					"description": "Character represents or illustrates a theme"
+				},
+				{
+					"from": "scene",
+					"to": "character",
+					"verb": "Contains",
+					"description": "Scene features this character"
+				},
+				{
+					"from": "scene",
+					"to": "location",
+					"verb": "LocatedAt",
+					"description": "Scene takes place in this location"
+				},
+				{
+					"from": "chapter",
+					"to": "chapter",
+					"verb": "Precedes",
+					"description": "Chapter ordering in the manuscript"
+				}
+			]
+		}
+	},
+	"workshop": {
+		"workspaceConfig": {
+			"paradigm": "writer",
+			"defaultTab": "edit",
+			"defaultView": "mindmap",
+			"defaultFile": "manuscript/chapters/01-opening.md",
+			"fallbackFiles": [
+				"planning/outline.md",
+				"README.md"
+			]
+		},
+		"graphGuidance": {
+			"conceptCreation": {
+				"triggers": [
+					"When user creates a new character",
+					"When user describes a location or setting",
+					"When user outlines a chapter or scene",
+					"When user mentions a plot thread or subplot"
+				],
+				"typeMapping": {
+					"character": "person",
+					"location": "location",
+					"chapter": "document",
+					"scene": "document",
+					"theme": "concept",
+					"subplot": "concept"
+				}
+			},
+			"relationshipPatterns": [
+				{
+					"from": "person",
+					"to": "person",
+					"verb": "conflicts",
+					"description": "Character conflict"
+				},
+				{
+					"from": "person",
+					"to": "person",
+					"verb": "relatedTo",
+					"description": "Family or romantic relationship"
+				},
+				{
+					"from": "person",
+					"to": "concept",
+					"verb": "embodies",
+					"description": "Character represents theme"
+				},
+				{
+					"from": "document",
+					"to": "person",
+					"verb": "contains",
+					"description": "Scene features character"
+				},
+				{
+					"from": "document",
+					"to": "location",
+					"verb": "locatedAt",
+					"description": "Scene takes place in location"
+				},
+				{
+					"from": "document",
+					"to": "document",
+					"verb": "precedes",
+					"description": "Chapter order"
+				}
+			],
+			"rules": [
+				"Create person entities for major characters",
+				"Link scenes to their featured characters",
+				"Track chapter sequence with precedes relationships",
+				"Connect themes to the characters who embody them"
+			]
+		},
+		"qualityGates": {
+			"fileChecks": [
+				{
+					"path": "planning/outline.md",
+					"required": [
+						"Act 1",
+						"Act 2",
+						"Act 3",
+						"Inciting Incident",
+						"Midpoint",
+						"Climax"
+					],
+					"optional": [
+						"Logline",
+						"Premise"
+					]
+				},
+				{
+					"path": "characters/protagonist.md",
+					"required": [
+						"Name",
+						"Character Arc"
+					],
+					"optional": [
+						"Backstory",
+						"Relationships",
+						"Voice Notes"
+					]
+				},
+				{
+					"path": "characters/antagonist.md",
+					"required": [
+						"Name",
+						"Motivation"
+					],
+					"optional": [
+						"Justification",
+						"Backstory"
+					]
+				}
+			],
+			"projectChecks": [
+				"Outline has all three acts defined",
+				"Protagonist has clear internal and external goals",
+				"Antagonist has understandable motivation",
+				"At least one chapter file exists",
+				"Timeline is consistent"
+			],
+			"exportReady": [
+				"All outline beats are filled in",
+				"Character arcs are defined",
+				"First draft of chapters complete"
+			]
+		},
+		"aiPersona": {
+			"role": "You are an expert fiction writing coach helping novelists develop compelling characters, build rich worlds, and structure satisfying stories from first draft to polished manuscript.",
+			"expertise": [
+				"Story structure (three-act, save the cat, hero's journey)",
+				"Character development and arc design",
+				"Worldbuilding and setting",
+				"Scene and chapter writing",
+				"Plot architecture and pacing"
+			],
+			"tone": "mentor"
+		},
+		"exporters": [
+			{
+				"id": "manuscript-bundle",
+				"name": "Manuscript Bundle",
+				"description": "ZIP archive of manuscript chapters in order",
+				"icon": "📦",
+				"format": "zip",
+				"category": "archive",
+				"handler": "markdown-bundle"
+			},
+			{
+				"id": "complete-novel-bundle",
+				"name": "Complete Novel Bundle",
+				"description": "ZIP of all project files with folder structure",
+				"icon": "📚",
+				"format": "zip",
+				"category": "archive",
+				"handler": "markdown-bundle"
+			}
+		],
+		"difficulty": "intermediate",
+		"templateTier": 4,
+		"templateMetadata": {
+			"identifyByStructure": true
+		},
+		"deploy": {
+			"provider": "cloud-run",
+			"buildCommand": "npm run build",
+			"outputDir": "build",
+			"config": {
+				"port": 3000,
+				"memory": "512Mi"
+			},
+			"oneClickCommand": "gcloud run deploy"
+		},
+		"sampleData": {
+			"description": "Sample novel structure for a fantasy epic",
+			"entities": [
+				{
+					"type": "person",
+					"name": "Kira Ashwood",
+					"properties": {
+						"role": "protagonist",
+						"age": 19,
+						"want": "Find her missing brother",
+						"need": "Accept her magical heritage",
+						"description": "Orphaned healer's apprentice who discovers she's descended from the ancient Storm Weavers.",
+						"status": "main",
+						"createdAt": "2025-01-05"
+					}
+				},
+				{
+					"type": "person",
+					"name": "The Hollow King",
+					"properties": {
+						"role": "antagonist",
+						"description": "Immortal sorcerer who feeds on stolen magic. Seeks the last Storm Weaver bloodline.",
+						"status": "main",
+						"createdAt": "2025-01-05"
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "Kira Ashwood",
+					"verb": "conflicts",
+					"to": "The Hollow King"
+				}
+			]
+		}
+	}
+} satisfies SoulcraftKitConfig;
+
+export default novelWritingSystem;