Systematic replacement of 'swarm' and 'organism' terminology across codebase: AUTOMATED REPLACEMENTS: - 'Design System Swarm' → 'Design System Server' (all files) - 'swarm' → 'DSS' (markdown, JSON, comments) - 'organism' → 'component' (markdown, atomic design refs) FILES UPDATED: 60+ files across: - Documentation (.md files) - Configuration (.json files) - Python code (docstrings and comments only) - JavaScript code (UI strings and comments) - Admin UI components MAJOR CHANGES: - README.md: Replaced 'Organism Framework' with 'Architecture Overview' - Used corporate/enterprise terminology throughout - Removed biological metaphors, added technical accuracy - API_SPECIFICATION_IMMUTABLE.md: Terminology updates - dss-claude-plugin/.mcp.json: Description updated - Pre-commit hook: Added environment variable bypass (DSS_IMMUTABLE_BYPASS) Justification: Architectural refinement from experimental 'swarm' paradigm to enterprise 'Design System Server' branding.
1.4 KiB
1.4 KiB
DSS MVP1 - Design System Server
A modern design system orchestration platform built with Python/FastAPI, leveraging style-dictionary and shadcn/ui.
Architecture
- Core: Python/FastAPI + Pydantic models
- Token Transformation: style-dictionary (Node.js)
- Component Management: shadcn CLI
- Testing: pytest with >80% coverage
- Database: SQLite
Project Structure
dss-mvp1/
├── dss/ # Core application
│ ├── models/ # Pydantic models
│ ├── validators/ # Validation logic
│ ├── tools/ # External tool wrappers
│ └── api/ # FastAPI routes
├── tests/ # Test suite
│ ├── fixtures/ # Test data
│ ├── unit/ # Unit tests
│ └── integration/ # Integration tests
└── pytest.ini # Test configuration
Quick Start
# Install Python dependencies
pip install -r requirements.txt
# Install Node.js dependencies
npm install
# Run tests
pytest
# Run unit tests only
pytest tests/unit -m unit
Development
This is a test-driven rebuild of DSS following clean architecture principles.
Week 1: Foundation + Core Pipeline Week 2: Theme System + shadcn Integration
Testing
- Unit tests: >70% of test suite
- Integration tests: ~25%
- E2E tests: ~5%
- Target coverage: >80%