@soulcraft/kits 1.0.0

package/src/kits/music-collection.ts

@@ -0,0 +1,404 @@
+/**
+ * @module @soulcraft/kits/kits/music-collection
+ * @description Organize and explore your music library with albums, artists, playlists, and listening journal
+ *
+ * Generated from: kits/music-collection/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';
+
+/**
+ * Music Collection Manager kit configuration.
+ *
+ * @description Organize and explore your music library with albums, artists, playlists, and listening journal
+ * @see {@link SoulcraftKitConfig}
+ */
+const musicCollection: SoulcraftKitConfig = {
+	"$schema": "https://soulcraft.com/schemas/kit/v2.json",
+	"id": "music-collection",
+	"name": "Music Collection Manager",
+	"description": "Organize and explore your music library with albums, artists, playlists, and listening journal",
+	"version": "1.0.0",
+	"author": {
+		"name": "Soulcraft Labs",
+		"email": "kits@soulcraft.com",
+		"url": "https://soulcraft.com"
+	},
+	"status": "released",
+	"icon": "🎵",
+	"longDescription": "A comprehensive system for music lovers to catalog their collection, track listening habits, create smart playlists based on moods and genres, and discover connections between artists. Perfect for vinyl collectors, streaming curators, or anyone who wants to engage more deeply with their music.",
+	"tags": [
+		"music",
+		"collection",
+		"vinyl",
+		"playlists",
+		"listening",
+		"curation"
+	],
+	"role": "primary",
+	"type": "soulcraft",
+	"variables": [
+		{
+			"key": "projectName",
+			"label": "Collection Name",
+			"description": "The name of your music collection",
+			"type": "string",
+			"required": true,
+			"example": "My Music Collection"
+		},
+		{
+			"key": "ownerName",
+			"label": "Your Name",
+			"description": "Your name as the collector",
+			"type": "string",
+			"required": false,
+			"example": "Your Name"
+		},
+		{
+			"key": "primaryFormat",
+			"label": "Primary Format",
+			"description": "Your main way of listening",
+			"type": "string",
+			"required": false,
+			"example": "Vinyl, Digital, CD, Streaming"
+		}
+	],
+	"shared": {
+		"industry": "creative-arts",
+		"category": "creative",
+		"glossary": {
+			"vinyl": "A physical record format prized for its warm, analog sound",
+			"curation": "The art of selecting and organizing music into meaningful collections"
+		},
+		"aiExpertise": [
+			"Music history and artist knowledge",
+			"Genre classification and connections",
+			"Album and artist recommendations",
+			"Playlist curation by mood and context",
+			"Music metadata and discography"
+		],
+		"dataModelHints": [
+			"person",
+			"thing",
+			"topic",
+			"event"
+		],
+		"suggestions": [
+			{
+				"label": "Add an album",
+				"prompt": "Help me add a new album to my music collection"
+			},
+			{
+				"label": "Rate and review",
+				"prompt": "Help me write a review and rating for an album"
+			},
+			{
+				"label": "Discover connections",
+				"prompt": "Find connections between artists and genres in my collection"
+			},
+			{
+				"label": "Create a playlist",
+				"prompt": "Help me curate a playlist from my collection"
+			},
+			{
+				"label": "Collection stats",
+				"prompt": "Show me statistics about my music collection by genre and decade"
+			},
+			{
+				"label": "Browse collection",
+				"prompt": "Show me my music collection in the gallery view"
+			}
+		],
+		"dataModel": {
+			"entities": [
+				{
+					"domain": "artist",
+					"type": "Person",
+					"description": "A musician or band whose work is in the collection",
+					"products": {
+						"workshop": {
+							"view": "gallery",
+							"icon": "🎸"
+						},
+						"academy": {
+							"mapsTo": "learning-subject",
+							"assessable": false
+						}
+					}
+				},
+				{
+					"domain": "album",
+					"type": "Thing",
+					"description": "A music album or release with track listing and rating",
+					"products": {
+						"workshop": {
+							"view": "gallery",
+							"icon": "💿"
+						},
+						"academy": {
+							"mapsTo": "resource",
+							"assessable": false
+						}
+					}
+				},
+				{
+					"domain": "track",
+					"type": "Thing",
+					"description": "An individual song or track within an album",
+					"products": {
+						"workshop": {
+							"view": "gallery",
+							"icon": "🎵"
+						},
+						"academy": {
+							"mapsTo": "resource",
+							"assessable": false
+						}
+					}
+				},
+				{
+					"domain": "playlist",
+					"type": "Concept",
+					"description": "A curated collection of tracks grouped by mood or theme",
+					"products": {
+						"workshop": {
+							"view": "board",
+							"icon": "📋"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "genre",
+					"type": "Concept",
+					"description": "A music genre or style category",
+					"products": {
+						"workshop": {
+							"view": "graph",
+							"icon": "🎼"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": false
+						}
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "album",
+					"to": "artist",
+					"verb": "CreatedBy",
+					"description": "Album was created by this artist"
+				},
+				{
+					"from": "artist",
+					"to": "artist",
+					"verb": "InfluencedBy",
+					"description": "Musical influence relationship"
+				},
+				{
+					"from": "artist",
+					"to": "artist",
+					"verb": "CollaboratedWith",
+					"description": "Artists who have worked together"
+				},
+				{
+					"from": "album",
+					"to": "genre",
+					"verb": "HasGenre",
+					"description": "Album belongs to this genre"
+				},
+				{
+					"from": "track",
+					"to": "playlist",
+					"verb": "InPlaylist",
+					"description": "Track appears in this playlist"
+				}
+			]
+		}
+	},
+	"workshop": {
+		"workspaceConfig": {
+			"paradigm": "creative",
+			"defaultTab": "explore",
+			"defaultView": "gallery",
+			"defaultFile": "albums/first-album.md"
+		},
+		"graphGuidance": {
+			"conceptCreation": {
+				"triggers": [
+					"User adds a new album to their collection",
+					"User mentions a new artist",
+					"User creates a new playlist",
+					"User references a genre not yet in the system"
+				],
+				"typeMapping": {
+					"artist": "person",
+					"album": "creative-work",
+					"track": "creative-work",
+					"playlist": "collection",
+					"genre": "category",
+					"mood": "category",
+					"label": "organization",
+					"era": "category"
+				}
+			},
+			"relationshipPatterns": [
+				{
+					"from": "creative-work",
+					"to": "person",
+					"verb": "createdBy",
+					"description": "Album by artist"
+				},
+				{
+					"from": "person",
+					"to": "person",
+					"verb": "influencedBy",
+					"description": "Musical influence"
+				},
+				{
+					"from": "person",
+					"to": "person",
+					"verb": "collaboratedWith",
+					"description": "Worked together"
+				},
+				{
+					"from": "creative-work",
+					"to": "category",
+					"verb": "hasGenre",
+					"description": "Album genre"
+				},
+				{
+					"from": "creative-work",
+					"to": "collection",
+					"verb": "inPlaylist",
+					"description": "Track in playlist"
+				}
+			],
+			"rules": [
+				"Every album should link to its artist",
+				"Artists should have at least one genre",
+				"Influential relationships should be bidirectional when known",
+				"Playlists should link to their tracks or albums"
+			]
+		},
+		"qualityGates": {
+			"fileChecks": [
+				{
+					"path": "artists/*.md",
+					"required": [
+						"Genres",
+						"Key Albums"
+					],
+					"optional": [
+						"Influences",
+						"Personal Notes",
+						"Rating"
+					]
+				},
+				{
+					"path": "albums/*.md",
+					"required": [
+						"Artist",
+						"Year",
+						"Track Listing"
+					],
+					"optional": [
+						"My Review",
+						"Rating",
+						"When to Listen"
+					]
+				}
+			],
+			"projectChecks": [
+				"At least 5 artists documented",
+				"At least 10 albums in collection",
+				"At least one playlist created",
+				"Listening journal has entries"
+			],
+			"exportReady": [
+				"All albums linked to artists",
+				"Genres assigned to artists",
+				"Collection stats updated"
+			]
+		},
+		"aiPersona": {
+			"role": "You are an expert music curator and historian helping music lovers catalog their collections, discover connections between artists, and deepen their appreciation of music.",
+			"expertise": [
+				"Music history and genre knowledge",
+				"Artist biography and discography",
+				"Album curation and recommendation",
+				"Playlist design by mood and context",
+				"Music metadata and cataloging"
+			],
+			"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 music collection with albums, artists, and playlists",
+			"entities": [
+				{
+					"type": "media",
+					"name": "OK Computer",
+					"properties": {
+						"artist": "Radiohead",
+						"year": 1997,
+						"format": "Vinyl LP",
+						"rating": 10,
+						"description": "Groundbreaking alternative rock album exploring technology and alienation.",
+						"status": "owned"
+					}
+				},
+				{
+					"type": "person",
+					"name": "Radiohead",
+					"properties": {
+						"genre": "Alternative Rock",
+						"activeYears": "1985-present",
+						"origin": "Oxford, UK",
+						"description": "Influential British band known for experimental rock and electronic music."
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "OK Computer",
+					"verb": "createdBy",
+					"to": "Radiohead"
+				}
+			]
+		}
+	},
+	"academy": {
+		"skillPath": "music-curation",
+		"level": "beginner",
+		"learningObjectives": [
+			"Catalog albums with complete metadata (artist, year, genre, format, personal rating)",
+			"Identify and document influence relationships between artists across genres and eras",
+			"Build thematic playlists by selecting tracks that share mood, key, or narrative arc",
+			"Write a substantive album review that articulates why a record is significant"
+		],
+		"assessmentTypes": [
+			"portfolio"
+		],
+		"certificationSlug": "music-curator"
+	}
+} satisfies SoulcraftKitConfig;
+
+export default musicCollection;