276ed71f31
Migrated from design-system-swarm with fresh git history.
Old project history preserved in /home/overbits/apps/design-system-swarm
Core components:
- MCP Server (Python FastAPI with mcp 1.23.1)
- Claude Plugin (agents, commands, skills, strategies, hooks, core)
- DSS Backend (dss-mvp1 - token translation, Figma sync)
- Admin UI (Node.js/React)
- Server (Node.js/Express)
- Storybook integration (dss-mvp1/.storybook)
Self-contained configuration:
- All paths relative or use DSS_BASE_PATH=/home/overbits/dss
- PYTHONPATH configured for dss-mvp1 and dss-claude-plugin
- .env file with all configuration
- Claude plugin uses ${CLAUDE_PLUGIN_ROOT} for portability
Migration completed: $(date)
🤖 Clean migration with full functionality preserved
113 lines
3.5 KiB
JSON
113 lines
3.5 KiB
JSON
{
|
|
"$schema": "dss-knowledge-v1",
|
|
"type": "architecture",
|
|
"version": "0.8.0",
|
|
"last_updated": null,
|
|
"modules": [
|
|
{
|
|
"name": "messaging",
|
|
"path": "admin-ui/js/core/messaging.js",
|
|
"purpose": "Centralized notification system with structured error taxonomy and correlation IDs",
|
|
"features": [
|
|
"Event bus using CustomEvent API",
|
|
"Structured message format with correlation IDs",
|
|
"Error taxonomy (E1xxx-E5xxx for errors, S1xxx for success)",
|
|
"Message persistence via localStorage",
|
|
"Helper functions: notifySuccess, notifyError, notifyWarning, notifyInfo",
|
|
"Message history and debugging capabilities"
|
|
],
|
|
"error_codes": {
|
|
"E1xxx": "User errors (invalid input, forbidden actions)",
|
|
"E2xxx": "Validation errors (missing fields, invalid formats)",
|
|
"E3xxx": "API errors (request failed, timeout, unauthorized)",
|
|
"E4xxx": "System errors (unexpected, network, storage)",
|
|
"E5xxx": "Integration errors (Figma connection, API errors)",
|
|
"S1xxx": "Success codes (operation complete, created, updated, deleted)"
|
|
}
|
|
},
|
|
{
|
|
"name": "router",
|
|
"path": "admin-ui/js/core/router.js",
|
|
"purpose": "Centralized hash-based routing with guards and lifecycle hooks",
|
|
"features": [
|
|
"Centralized route registry",
|
|
"Route guards (beforeEnter, afterEnter, onLeave)",
|
|
"History management",
|
|
"Programmatic navigation",
|
|
"Route metadata support",
|
|
"Common guards (requireAuth, requireProject)"
|
|
],
|
|
"routes": [
|
|
"dashboard",
|
|
"projects",
|
|
"tokens",
|
|
"components",
|
|
"figma",
|
|
"docs",
|
|
"teams",
|
|
"audit",
|
|
"settings",
|
|
"services",
|
|
"quick-wins",
|
|
"chat"
|
|
]
|
|
},
|
|
{
|
|
"name": "workflows",
|
|
"path": "admin-ui/js/core/workflows.js",
|
|
"purpose": "Orchestrate multi-step user workflows with state machines",
|
|
"features": [
|
|
"Base StateMachine class",
|
|
"CreateProjectWorkflow (Create \u2192 Configure \u2192 Extract \u2192 Success)",
|
|
"TokenExtractionWorkflow (Connect \u2192 Select \u2192 Extract \u2192 Sync)",
|
|
"Progress tracking",
|
|
"State transition guards",
|
|
"Side effects via actions",
|
|
"Event emission for UI updates"
|
|
]
|
|
},
|
|
{
|
|
"name": "rest_api",
|
|
"path": "/home/overbits/dss/tools/api/server.py",
|
|
"purpose": "FastAPI server providing REST API and static file serving",
|
|
"port": 3456,
|
|
"endpoints": [],
|
|
"mounts": [
|
|
{
|
|
"path": "/admin-ui",
|
|
"type": "StaticFiles",
|
|
"line_number": 258
|
|
},
|
|
{
|
|
"path": "/",
|
|
"type": "StaticFiles",
|
|
"line_number": 3073
|
|
}
|
|
],
|
|
"total_endpoints": 0
|
|
}
|
|
],
|
|
"design_patterns": [
|
|
"Separation of Concerns",
|
|
"Single Responsibility Principle",
|
|
"Dependency Injection",
|
|
"Observer Pattern",
|
|
"State Machine Pattern",
|
|
"Command Pattern",
|
|
"Strategy Pattern"
|
|
],
|
|
"performance": {
|
|
"bundle_size_increase": "+15KB (minified)",
|
|
"initialization_time_increase": "+50ms",
|
|
"memory_usage": "+~1MB (50 messages in localStorage)",
|
|
"network_impact": "No additional requests"
|
|
},
|
|
"_metadata": {
|
|
"generator": "APIExtractor",
|
|
"generated_at": "2025-12-07T18:27:49.697019",
|
|
"source_files": [
|
|
"/home/overbits/dss/tools/api/server.py"
|
|
],
|
|
"version": "1.0.0"
|
|
}
|
|
} |