DSS 9dbd56271e
Some checks failed
DSS Project Analysis / dss-context-update (push) Has been cancelled
feat: Enterprise DSS architecture implementation
Complete implementation of enterprise design system validation:

Phase 1 - @dss/rules npm package:
- CLI with validate and init commands
- 16 rules across 5 categories (colors, spacing, typography, components, a11y)
- dss-ignore support (inline and next-line)
- Break-glass [dss-skip] for emergency merges
- CI workflow templates (Gitea, GitHub, GitLab)

Phase 2 - Metrics dashboard:
- FastAPI metrics API with SQLite storage
- Portfolio-wide metrics aggregation
- Project drill-down with file:line:column violations
- Trend charts and history tracking

Phase 3 - Local analysis cache:
- LocalAnalysisCache for offline-capable validation
- Mode detection (LOCAL/REMOTE/CI)
- Stale cache warnings with recommendations

Phase 4 - Project onboarding:
- dss-init command for project setup
- Creates ds.config.json, .dss/ folder structure
- Updates .gitignore and package.json scripts
- Optional CI workflow setup

Architecture decisions:
- No commit-back: CI uploads to dashboard, not git
- Three-tier: Dashboard (read-only) → CI (authoritative) → Local (advisory)
- Pull-based rules via npm for version control

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-11 09:41:36 -03:00

DSS - Design System Server

Monolithic design system platform. Ingest tokens from Figma/CSS/SCSS/Tailwind, normalize to canonical format, generate outputs.

Quick Start

pip install -r requirements.txt
python tools/api/server.py      # REST API on :3456
python tools/api/mcp_server.py  # MCP server on :3457

Structure

tools/           # Python backend (API, ingestion, analysis)
admin-ui/        # Web dashboard
cli/             # TypeScript CLI
dss-claude-plugin/  # Claude Code integration (skills, commands, agents)
.knowledge/      # AI knowledge base (DSS_CORE.json)
.dss/            # Runtime data, schemas, database

Core Concept

DSS structure is immutable. External systems adapt TO DSS via translation dictionaries.

See .knowledge/DSS_CORE.json for complete specification.

Test Commit to Verify Hooks

\n- CI/CD Verification Run

Description
Design System Showcase
Readme 7.2 MiB
Languages
Python 60.7%
TypeScript 22.8%
CSS 9.3%
JavaScript 3.7%
Shell 3.4%
Other 0.1%