@soulcraft/kits 1.0.0

package/src/kits/personal-crm.ts

@@ -0,0 +1,391 @@
+/**
+ * @module @soulcraft/kits/kits/personal-crm
+ * @description Relationship manager with contact network visualization and interaction tracking
+ *
+ * Generated from: kits/personal-crm/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';
+
+/**
+ * Personal CRM kit configuration.
+ *
+ * @description Relationship manager with contact network visualization and interaction tracking
+ * @see {@link SoulcraftKitConfig}
+ */
+const personalCrm: SoulcraftKitConfig = {
+	"$schema": "https://soulcraft.com/schemas/kit/v2.json",
+	"id": "personal-crm",
+	"name": "Personal CRM",
+	"description": "Relationship manager with contact network visualization and interaction tracking",
+	"version": "1.0.0",
+	"author": {
+		"name": "Soulcraft Labs",
+		"email": "kits@soulcraft.com",
+		"url": "https://soulcraft.com"
+	},
+	"status": "released",
+	"icon": "👥",
+	"longDescription": "Build a relationship-focused contact manager where connections matter as much as contacts. Track interactions, visualize your network graph, and surface contacts you have not spoken to recently. Uses Brainy for rich relationship modeling with person, organization, event, and topic entity types.",
+	"tags": [
+		"crm",
+		"contacts",
+		"relationships",
+		"networking",
+		"brainy",
+		"sveltekit"
+	],
+	"role": "primary",
+	"type": "soulcraft",
+	"variables": [
+		{
+			"key": "appName",
+			"label": "App Name",
+			"description": "The name of your personal CRM app",
+			"type": "string",
+			"required": true,
+			"example": "my-network"
+		},
+		{
+			"key": "description",
+			"label": "Description",
+			"description": "A short description of your network",
+			"type": "string",
+			"required": false,
+			"example": "My personal contact network",
+			"default": "A relationship-first contact manager"
+		}
+	],
+	"shared": {
+		"industry": "personal-productivity",
+		"category": "business",
+		"aiExpertise": [
+			"Contact relationship management",
+			"Network analysis and insights",
+			"Follow-up strategy",
+			"Relationship nurturing",
+			"Contact organization and tagging"
+		],
+		"dataModelHints": [
+			"person",
+			"organization",
+			"event",
+			"topic"
+		],
+		"suggestions": [
+			{
+				"label": "Add a contact",
+				"prompt": "Help me add a new contact to my personal CRM"
+			},
+			{
+				"label": "Log an interaction",
+				"prompt": "Help me log a recent interaction with a contact"
+			},
+			{
+				"label": "Plan follow-ups",
+				"prompt": "Show me contacts I should follow up with and help me plan outreach"
+			},
+			{
+				"label": "Tag and organize",
+				"prompt": "Help me organize my contacts with tags and groups"
+			},
+			{
+				"label": "Relationship insights",
+				"prompt": "Analyze my contact network and suggest relationship-building opportunities"
+			},
+			{
+				"label": "View my network",
+				"prompt": "Show me my contact network in the graph view"
+			}
+		],
+		"dataModel": {
+			"entities": [
+				{
+					"domain": "contact",
+					"type": "Person",
+					"description": "A person in the relationship network with contact details",
+					"products": {
+						"workshop": {
+							"view": "gallery",
+							"icon": "👤"
+						},
+						"academy": {
+							"mapsTo": "learning-subject",
+							"assessable": false
+						}
+					}
+				},
+				{
+					"domain": "company",
+					"type": "Concept",
+					"description": "An organisation or company contacts are associated with",
+					"products": {
+						"workshop": {
+							"view": "graph",
+							"icon": "🏢"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": false
+						}
+					}
+				},
+				{
+					"domain": "interaction",
+					"type": "Event",
+					"description": "A logged interaction such as a call, email, or meeting",
+					"products": {
+						"workshop": {
+							"view": "timeline",
+							"icon": "💬"
+						},
+						"academy": {
+							"mapsTo": "practice-session",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "tag",
+					"type": "Concept",
+					"description": "A label categorising contacts by context or relationship type",
+					"products": {
+						"workshop": {
+							"view": "graph",
+							"icon": "🏷️"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": false
+						}
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "contact",
+					"to": "company",
+					"verb": "MemberOf",
+					"description": "Contact works at this company"
+				},
+				{
+					"from": "contact",
+					"to": "contact",
+					"verb": "FriendOf",
+					"description": "Contact knows another contact"
+				},
+				{
+					"from": "contact",
+					"to": "contact",
+					"verb": "References",
+					"description": "Contact was introduced by another"
+				},
+				{
+					"from": "interaction",
+					"to": "contact",
+					"verb": "Communicates",
+					"description": "Interaction was with this contact"
+				},
+				{
+					"from": "tag",
+					"to": "contact",
+					"verb": "Categorizes",
+					"description": "Tag is applied to this contact"
+				}
+			]
+		}
+	},
+	"workshop": {
+		"graphGuidance": {
+			"conceptCreation": {
+				"triggers": [
+					"User adds a new contact",
+					"User creates a company",
+					"User logs an interaction",
+					"User creates a tag"
+				],
+				"typeMapping": {
+					"contact": "person",
+					"company": "organization",
+					"interaction": "event",
+					"tag": "topic"
+				}
+			},
+			"relationshipPatterns": [
+				{
+					"from": "person",
+					"to": "organization",
+					"verb": "memberOf",
+					"description": "Contact works at company"
+				},
+				{
+					"from": "person",
+					"to": "person",
+					"verb": "friendOf",
+					"description": "Contact knows another contact"
+				},
+				{
+					"from": "person",
+					"to": "person",
+					"verb": "references",
+					"description": "Contact was introduced by another"
+				},
+				{
+					"from": "event",
+					"to": "person",
+					"verb": "communicates",
+					"description": "Interaction was with contact"
+				},
+				{
+					"from": "topic",
+					"to": "person",
+					"verb": "categorizes",
+					"description": "Tag applied to contact"
+				}
+			],
+			"rules": [
+				"Every contact should have at least one interaction logged",
+				"Prefer relationships over nested properties for connections",
+				"Use tags consistently across contacts for filtering"
+			]
+		},
+		"qualityGates": {
+			"fileChecks": [
+				{
+					"path": "package.json",
+					"required": [
+						"svelte",
+						"@sveltejs/kit",
+						"@soulcraft/brainy"
+					],
+					"optional": [
+						"typescript"
+					]
+				},
+				{
+					"path": "src/lib/types.ts",
+					"required": [
+						"Contact",
+						"Company",
+						"Interaction"
+					],
+					"optional": [
+						"Tag"
+					]
+				}
+			],
+			"projectChecks": [
+				"App starts with npm run dev",
+				"Can create new contacts",
+				"Can log interactions",
+				"Can view contact network graph",
+				"Search returns matching contacts"
+			],
+			"exportReady": [
+				"No TypeScript errors",
+				"All routes load correctly",
+				"Error handling in place"
+			]
+		},
+		"aiPersona": {
+			"role": "You are a relationship management expert helping users build and maintain meaningful professional and personal connections.",
+			"expertise": [
+				"Contact relationship management",
+				"Network analysis",
+				"Follow-up strategy",
+				"Relationship nurturing",
+				"Contact organization"
+			],
+			"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"
+			},
+			"oneClickCommand": "gcloud run deploy"
+		},
+		"sampleData": {
+			"description": "Realistic sample contacts demonstrating the CRM features",
+			"entities": [
+				{
+					"type": "person",
+					"name": "Alex Chen",
+					"properties": {
+						"email": "alex.chen@techcorp.io",
+						"phone": "+1-555-0101",
+						"role": "Engineering Manager",
+						"description": "Engineering lead at TechCorp. Interested in knowledge graphs and AI.",
+						"notes": "Met at TechConf 2024. Interested in knowledge graphs.",
+						"lastContacted": "2024-11-15",
+						"status": "active",
+						"createdAt": "2024-09-01"
+					}
+				},
+				{
+					"type": "person",
+					"name": "Sarah Johnson",
+					"properties": {
+						"email": "sarah.j@startup.co",
+						"phone": "+1-555-0102",
+						"role": "CEO",
+						"description": "Founder and CEO of Startup.co. College friend turned entrepreneur.",
+						"notes": "College friend, now running a startup",
+						"lastContacted": "2024-10-20",
+						"status": "active",
+						"createdAt": "2024-06-15"
+					}
+				},
+				{
+					"type": "organization",
+					"name": "TechCorp",
+					"properties": {
+						"industry": "Technology",
+						"website": "https://techcorp.io",
+						"size": "500-1000",
+						"description": "Enterprise software company specializing in AI solutions.",
+						"createdAt": "2024-09-01"
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "Alex Chen",
+					"verb": "memberOf",
+					"to": "TechCorp"
+				},
+				{
+					"from": "Sarah Johnson",
+					"verb": "friendOf",
+					"to": "Alex Chen"
+				}
+			]
+		}
+	},
+	"academy": {
+		"skillPath": "relationship-management",
+		"level": "beginner",
+		"learningObjectives": [
+			"Build a structured contact record capturing role, context of meeting, and shared interests",
+			"Log interactions consistently so the history of any relationship is retrievable at a glance",
+			"Identify contacts who need follow-up using recency data and prioritise outreach",
+			"Map network connections to discover shared contacts and introduction opportunities"
+		],
+		"assessmentTypes": [
+			"portfolio"
+		],
+		"certificationSlug": "relationship-manager"
+	}
+} satisfies SoulcraftKitConfig;
+
+export default personalCrm;

package/src/kits/personal-wiki.ts

@@ -0,0 +1,323 @@
+/**
+ * @module @soulcraft/kits/kits/personal-wiki
+ * @description Second brain with bi-directional links, knowledge graph, and semantic search
+ *
+ * Generated from: kits/personal-wiki/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';
+
+/**
+ * Personal Wiki kit configuration.
+ *
+ * @description Second brain with bi-directional links, knowledge graph, and semantic search
+ * @see {@link SoulcraftKitConfig}
+ */
+const personalWiki: SoulcraftKitConfig = {
+	"$schema": "https://soulcraft.com/schemas/kit/v2.json",
+	"id": "personal-wiki",
+	"name": "Personal Wiki",
+	"description": "Second brain with bi-directional links, knowledge graph, and semantic search",
+	"version": "1.0.0",
+	"author": {
+		"name": "Soulcraft Labs",
+		"email": "kits@soulcraft.com",
+		"url": "https://soulcraft.com"
+	},
+	"status": "released",
+	"icon": "📖",
+	"longDescription": "Build a Roam/Obsidian-like second brain with knowledge graph visualization. Connect notes with bi-directional links, explore your knowledge graph, and use semantic search to surface related ideas. Powered by Brainy for document, topic, task, and content entity modeling.",
+	"tags": [
+		"wiki",
+		"notes",
+		"knowledge",
+		"second-brain",
+		"pkm",
+		"brainy",
+		"sveltekit"
+	],
+	"role": "primary",
+	"type": "soulcraft",
+	"variables": [
+		{
+			"key": "appName",
+			"label": "App Name",
+			"description": "The name of your personal wiki app",
+			"type": "string",
+			"required": true,
+			"example": "my-wiki"
+		},
+		{
+			"key": "description",
+			"label": "Description",
+			"description": "A short description of your knowledge base",
+			"type": "string",
+			"required": false,
+			"example": "My personal knowledge base",
+			"default": "My personal knowledge base"
+		}
+	],
+	"shared": {
+		"industry": "personal-productivity",
+		"category": "knowledge",
+		"aiExpertise": [
+			"Personal knowledge management",
+			"Note-taking and linking strategies",
+			"Second brain methodology",
+			"Knowledge graph exploration",
+			"Zettelkasten and evergreen notes"
+		],
+		"dataModelHints": [
+			"document",
+			"topic",
+			"task",
+			"content"
+		],
+		"suggestions": [
+			{
+				"label": "Add a topic",
+				"prompt": "Help me add a new topic to my personal wiki"
+			},
+			{
+				"label": "Write an article",
+				"prompt": "Help me write a wiki article on a topic I'm learning about"
+			},
+			{
+				"label": "Link related topics",
+				"prompt": "Help me find and create links between related wiki topics"
+			},
+			{
+				"label": "Organize by category",
+				"prompt": "Help me organize my wiki topics into categories"
+			},
+			{
+				"label": "Find gaps",
+				"prompt": "Analyze my wiki and suggest topics that could use more detail"
+			},
+			{
+				"label": "Explore the wiki",
+				"prompt": "Show me my wiki topics and their connections in the mind map"
+			}
+		],
+		"dataModel": {
+			"entities": [
+				{
+					"domain": "page",
+					"type": "Document",
+					"description": "A wiki page containing notes and bi-directional links",
+					"products": {
+						"workshop": {
+							"view": "tree",
+							"icon": "📄"
+						},
+						"academy": {
+							"mapsTo": "learning-artifact",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "topic",
+					"type": "Concept",
+					"description": "A subject category grouping related wiki pages",
+					"products": {
+						"workshop": {
+							"view": "graph",
+							"icon": "🏷️"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": false
+						}
+					}
+				},
+				{
+					"domain": "category",
+					"type": "Concept",
+					"description": "A broad knowledge domain or namespace for pages",
+					"products": {
+						"workshop": {
+							"view": "graph",
+							"icon": "🗂️"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": false
+						}
+					}
+				},
+				{
+					"domain": "term",
+					"type": "Concept",
+					"description": "A defined glossary term with a dedicated page",
+					"products": {
+						"workshop": {
+							"view": "graph",
+							"icon": "📖"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": true
+						}
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "page",
+					"to": "page",
+					"verb": "References",
+					"description": "Page links to another page via wikilink"
+				},
+				{
+					"from": "page",
+					"to": "topic",
+					"verb": "InstanceOf",
+					"description": "Page belongs to this topic category"
+				},
+				{
+					"from": "topic",
+					"to": "topic",
+					"verb": "PartOf",
+					"description": "Subcategory relationship"
+				},
+				{
+					"from": "page",
+					"to": "term",
+					"verb": "Defines",
+					"description": "Page defines or explains this term"
+				}
+			]
+		}
+	},
+	"workshop": {
+		"workspaceConfig": {
+			"paradigm": "researcher",
+			"defaultTab": "explore",
+			"defaultView": "graph",
+			"defaultFile": "wiki/index.md"
+		},
+		"graphGuidance": {
+			"conceptCreation": {
+				"triggers": [
+					"When user creates a new wiki page",
+					"When user identifies a topic category",
+					"When user creates navigation structure",
+					"When user defines a glossary term"
+				],
+				"typeMapping": {
+					"page": "document",
+					"topic": "concept",
+					"category": "concept",
+					"term": "concept"
+				}
+			},
+			"relationshipPatterns": [
+				{
+					"from": "document",
+					"to": "document",
+					"verb": "references",
+					"description": "Page links to page"
+				},
+				{
+					"from": "document",
+					"to": "concept",
+					"verb": "instanceOf",
+					"description": "Page in category"
+				},
+				{
+					"from": "concept",
+					"to": "concept",
+					"verb": "partOf",
+					"description": "Subcategory"
+				},
+				{
+					"from": "document",
+					"to": "concept",
+					"verb": "defines",
+					"description": "Page defines term"
+				}
+			],
+			"rules": [
+				"Create document entities for wiki pages",
+				"Track links between pages",
+				"Organize pages into categories",
+				"Note hub pages and their connections"
+			]
+		},
+		"aiPersona": {
+			"role": "You are a personal knowledge management expert helping users build a connected second brain with bi-directional links, atomic notes, and semantic organization.",
+			"expertise": [
+				"Personal knowledge management",
+				"Zettelkasten method",
+				"Second brain methodology",
+				"Note-taking strategies",
+				"Knowledge graph design"
+			],
+			"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"
+			},
+			"oneClickCommand": "gcloud run deploy"
+		},
+		"sampleData": {
+			"entities": [
+				{
+					"type": "document",
+					"name": "Atomic Habits Summary",
+					"properties": {
+						"type": "note",
+						"content": "Key insights from James Clear's book...",
+						"created": "2024-10-15",
+						"description": "A comprehensive summary of the book's core concepts about habit formation.",
+						"status": "review"
+					}
+				},
+				{
+					"type": "topic",
+					"name": "Productivity",
+					"properties": {
+						"color": "#10b981",
+						"description": "Notes about getting things done effectively."
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "Productivity",
+					"verb": "describes",
+					"to": "Atomic Habits Summary"
+				}
+			]
+		}
+	},
+	"academy": {
+		"skillPath": "knowledge-management",
+		"level": "beginner",
+		"learningObjectives": [
+			"Write atomic notes that each capture a single idea and stand alone without external context",
+			"Create bi-directional links between notes and explain the nature of each connection",
+			"Organise a knowledge base into categories without deep nesting that buries content",
+			"Perform a weekly review to surface orphan notes and strengthen weak connections"
+		],
+		"assessmentTypes": [
+			"portfolio"
+		],
+		"certificationSlug": "knowledge-curator"
+	}
+} satisfies SoulcraftKitConfig;
+
+export default personalWiki;