@soulcraft/kits 1.0.0

package/src/kits/project-timeline.ts

@@ -0,0 +1,368 @@
+/**
+ * @module @soulcraft/kits/kits/project-timeline
+ * @description Visual project timeline with milestones and dependencies
+ *
+ * Generated from: kits/project-timeline/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';
+
+/**
+ * Project Timeline / Roadmap kit configuration.
+ *
+ * @description Visual project timeline with milestones and dependencies
+ * @see {@link SoulcraftKitConfig}
+ */
+const projectTimeline: SoulcraftKitConfig = {
+	"$schema": "https://soulcraft.com/schemas/kit/v2.json",
+	"id": "project-timeline",
+	"name": "Project Timeline / Roadmap",
+	"description": "Visual project timeline with milestones and dependencies",
+	"version": "1.0.0",
+	"author": {
+		"name": "Soulcraft Labs",
+		"email": "kits@soulcraft.com",
+		"url": "https://soulcraft.com"
+	},
+	"status": "released",
+	"icon": "📅",
+	"longDescription": "Create an interactive project timeline showing milestones, deadlines, and dependencies. Perfect for project planning, product roadmaps, or event planning. Visualizes as a sequence in timeline layout with dependency tracking and risk documentation.",
+	"tags": [
+		"project",
+		"timeline",
+		"planning",
+		"roadmap"
+	],
+	"role": "primary",
+	"type": "soulcraft",
+	"variables": [
+		{
+			"key": "projectName",
+			"label": "Project Name",
+			"description": "The name of your project",
+			"type": "string",
+			"required": true,
+			"example": "Product Launch"
+		},
+		{
+			"key": "startDate",
+			"label": "Start Date",
+			"description": "Project start date in ISO format",
+			"type": "string",
+			"required": false,
+			"example": "2025-01-01",
+			"default": ""
+		},
+		{
+			"key": "endDate",
+			"label": "End Date",
+			"description": "Project end date in ISO format",
+			"type": "string",
+			"required": false,
+			"example": "2025-06-01",
+			"default": ""
+		}
+	],
+	"shared": {
+		"industry": "business-strategy",
+		"category": "business",
+		"aiExpertise": [
+			"Project planning and milestone setting",
+			"Dependency analysis and critical path",
+			"Risk identification and mitigation",
+			"Resource planning",
+			"Project status reporting"
+		],
+		"dataModelHints": [
+			"event",
+			"task",
+			"concept",
+			"person"
+		],
+		"suggestions": [
+			{
+				"label": "Add a milestone",
+				"prompt": "Help me add a new milestone to my project timeline"
+			},
+			{
+				"label": "Plan a phase",
+				"prompt": "Help me plan the tasks and deliverables for a project phase"
+			},
+			{
+				"label": "Identify risks",
+				"prompt": "Help me identify potential risks and create mitigation plans"
+			},
+			{
+				"label": "Track dependencies",
+				"prompt": "Help me map out dependencies between project tasks"
+			},
+			{
+				"label": "Status update",
+				"prompt": "Help me write a project status update based on current progress"
+			},
+			{
+				"label": "View timeline",
+				"prompt": "Show me my project timeline in the timeline view"
+			}
+		],
+		"dataModel": {
+			"entities": [
+				{
+					"domain": "task",
+					"type": "Event",
+					"description": "A unit of work with status, owner, and dates",
+					"products": {
+						"workshop": {
+							"view": "board",
+							"icon": "✅"
+						},
+						"academy": {
+							"mapsTo": "practice-session",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "milestone",
+					"type": "Event",
+					"description": "A key project checkpoint or delivery date",
+					"products": {
+						"workshop": {
+							"view": "timeline",
+							"icon": "🏁"
+						},
+						"academy": {
+							"mapsTo": "practice-session",
+							"assessable": true
+						}
+					}
+				},
+				{
+					"domain": "phase",
+					"type": "Concept",
+					"description": "A named project phase grouping related tasks",
+					"products": {
+						"workshop": {
+							"view": "timeline",
+							"icon": "📅"
+						},
+						"academy": {
+							"mapsTo": "knowledge-unit",
+							"assessable": false
+						}
+					}
+				},
+				{
+					"domain": "deliverable",
+					"type": "Thing",
+					"description": "A tangible output produced by a task or phase",
+					"products": {
+						"workshop": {
+							"view": "gallery",
+							"icon": "📦"
+						},
+						"academy": {
+							"mapsTo": "resource",
+							"assessable": false
+						}
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "task",
+					"to": "task",
+					"verb": "DependsOn",
+					"description": "Task cannot start until this task is complete"
+				},
+				{
+					"from": "task",
+					"to": "milestone",
+					"verb": "Precedes",
+					"description": "Task must be done before this milestone"
+				},
+				{
+					"from": "task",
+					"to": "phase",
+					"verb": "PartOf",
+					"description": "Task belongs to this project phase"
+				}
+			]
+		}
+	},
+	"workshop": {
+		"workspaceConfig": {
+			"paradigm": "planner",
+			"defaultTab": "explore",
+			"defaultView": "timeline",
+			"defaultFile": "milestones/kickoff.md"
+		},
+		"graphGuidance": {
+			"conceptCreation": {
+				"triggers": [
+					"When user creates a task or milestone",
+					"When user defines a phase",
+					"When user identifies a dependency",
+					"When user assigns an owner"
+				],
+				"typeMapping": {
+					"task": "task",
+					"milestone": "event",
+					"phase": "concept",
+					"deliverable": "thing"
+				}
+			},
+			"relationshipPatterns": [
+				{
+					"from": "task",
+					"to": "task",
+					"verb": "dependsOn",
+					"description": "Task dependency"
+				},
+				{
+					"from": "task",
+					"to": "event",
+					"verb": "precedes",
+					"description": "Task before milestone"
+				},
+				{
+					"from": "task",
+					"to": "concept",
+					"verb": "partOf",
+					"description": "Task in phase"
+				},
+				{
+					"from": "task",
+					"to": "person",
+					"verb": "attributedTo",
+					"description": "Task owner"
+				}
+			],
+			"rules": [
+				"Create task entities for work items",
+				"Track dependencies between tasks",
+				"Link tasks to their milestones",
+				"Note phase groupings"
+			]
+		},
+		"qualityGates": {
+			"fileChecks": [
+				{
+					"path": "milestones/*.md",
+					"required": [
+						"Date",
+						"Status"
+					],
+					"optional": [
+						"Depends On",
+						"Deliverable",
+						"Owner",
+						"Tasks"
+					]
+				}
+			],
+			"projectChecks": [
+				"Start and end milestones are defined",
+				"All milestones are connected (no orphans)",
+				"Critical path is documented",
+				"Each milestone has an owner",
+				"Status is current for all items"
+			],
+			"exportReady": [
+				"All milestones have dates",
+				"Dependencies are complete",
+				"No blocked items without documented blockers",
+				"Status is up to date",
+				"Risks are documented with mitigations"
+			]
+		},
+		"aiPersona": {
+			"role": "You are a project manager helping teams plan, track, and deliver projects on time with clear milestones, dependencies, and risk management.",
+			"expertise": [
+				"Project planning",
+				"Milestone setting",
+				"Dependency analysis",
+				"Risk management",
+				"Status reporting"
+			],
+			"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 project timeline for a product launch",
+			"entities": [
+				{
+					"type": "event",
+					"name": "Project Kickoff",
+					"properties": {
+						"date": "2025-01-15",
+						"status": "done",
+						"description": "Initial project kickoff meeting with stakeholders.",
+						"milestone_type": "start"
+					}
+				},
+				{
+					"type": "event",
+					"name": "Design Complete",
+					"properties": {
+						"date": "2025-02-28",
+						"status": "in_progress",
+						"description": "UI/UX designs finalized and approved.",
+						"milestone_type": "milestone"
+					}
+				},
+				{
+					"type": "event",
+					"name": "Launch",
+					"properties": {
+						"date": "2025-04-30",
+						"status": "todo",
+						"description": "Product goes live.",
+						"milestone_type": "end"
+					}
+				}
+			],
+			"relationships": [
+				{
+					"from": "Project Kickoff",
+					"verb": "precedes",
+					"to": "Design Complete"
+				},
+				{
+					"from": "Design Complete",
+					"verb": "precedes",
+					"to": "Launch"
+				}
+			]
+		}
+	},
+	"academy": {
+		"skillPath": "project-management",
+		"level": "beginner",
+		"learningObjectives": [
+			"Define project scope with a clear start milestone and measurable end criteria",
+			"Break work into phases, tasks, and milestones with realistic date estimates",
+			"Map task dependencies and identify the critical path through a project",
+			"Document project risks with probability, impact, and a concrete mitigation plan"
+		],
+		"assessmentTypes": [
+			"portfolio",
+			"peer-review"
+		],
+		"certificationSlug": "project-manager"
+	}
+} satisfies SoulcraftKitConfig;
+
+export default projectTimeline;