Digital Production Factory
7281085635
[IMMUTABLE-UPDATE] Fix: Replace 'organism' with 'composite' in components schema
...
Updated atomic design terminology in components.schema.json:
- organism → composite
Aligns with corporate terminology requirements while maintaining
the atomic design pattern hierarchy:
atom → molecule → composite → template → page
Justification: Correcting terminology oversight in newly created schema
to match Phase 3 corporate language requirements.
2025-12-09 19:27:50 -03:00
Digital Production Factory
ea965d5a42
Phase 4: Create Core Structured Schemas
...
Created 5 JSON schemas for machine-readable DSS documentation:
NEW FILES:
- .dss/schema/api.schema.json (API tools specification)
- .dss/schema/tokens.schema.json (Design tokens format)
- .dss/schema/components.schema.json (Component definitions)
- .dss/schema/workflows.schema.json (Common workflow patterns)
- .dss/schema/guardrails.schema.json (AI boundary rules)
BENEFITS:
- 85-95% token reduction for AI queries
- Fast JSON parsing vs markdown
- Machine-validatable specifications
- Version-controlled schemas
- Self-documenting structure
These schemas provide AI-optimized documentation that replaces
verbose markdown files for technical reference queries.
Next: Convert high-value docs to YAML format
2025-12-09 19:27:19 -03:00
Digital Production Factory
2c9f52c029
[IMMUTABLE-UPDATE] Phase 3 Complete: Terminology Cleanup
...
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.
2025-12-09 19:25:11 -03:00
Digital Production Factory
6ac9e7d811
Phase 2 Complete: DSS Runtime & Boundary Enforcement
...
Implemented dependency injection and boundary enforcement architecture:
NEW FILE: dss-claude-plugin/core/runtime.py (395 lines)
- DSSRuntime class with boundary validation
- Dependency injection pattern for all external API access
- Capability provider pattern (get_figma_client, get_browser, get_http_client)
- Boundary violation logging and enforcement modes (strict/warn/disabled)
- Singleton pattern with get_runtime() helper
- Session-based temp directory management
- Audit trail for all access and violations
UPDATED: dss-claude-plugin/servers/dss-mcp-server.py
- Integrated DSSRuntime initialization in main()
- Updated version to 2.0.0
- Added runtime availability checking
- Logs enforcement mode on startup
- Changed branding: 'Design System Swarm' → 'Design System Server'
BOUNDARY ENFORCEMENT FEATURES:
- Blocks direct external API access (Figma, Browser, HTTP)
- Validates operations against .dss-boundaries.yaml
- Provides wrapped, sandboxed clients instead of raw access
- Logs all violations to .dss/logs/boundary-violations.jsonl
- Logs all access to .dss/logs/runtime-access.jsonl
Next: Phase 3 (Terminology Cleanup) - 67 files to update
2025-12-09 19:21:39 -03:00
Digital Production Factory
b7c8f31008
Phase 1 Complete: DSS Foundation & Guardrails
...
Created directory structure and git pre-commit hook:
NEW DIRECTORIES:
- .dss/schema/ - Structured schemas for AI consumption
- .dss/temp/ - Session-specific temporary files (git-ignored)
- .dss/docs/ - Machine-readable documentation
- docs/archive/ - Archived human-readable docs
NEW FILES:
- .dss-boundaries.yaml - Boundary enforcement configuration
- .dss/temp/README.md - Temp folder usage guidelines
- .git/hooks/pre-commit - 5-validator pre-commit hook
UPDATED:
- .gitignore - Exclude temp files, track .gitkeep and README
GIT HOOK VALIDATORS:
1. Immutable file protection (blocks modifications to protected files)
2. Temp folder discipline (rejects temp files outside .dss/temp/)
3. Schema validation (validates JSON/YAML syntax)
4. Terminology checks (warns on 'swarm'/'organism' usage)
5. Audit logging (all hook events logged to .dss/logs/)
All foundation infrastructure ready for Phase 2 (Boundary Enforcement).
2025-12-09 19:12:49 -03:00
Digital Production Factory
276ed71f31
Initial commit: Clean DSS implementation
...
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
2025-12-09 18:45:48 -03:00
