bruno/dss
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

[IMMUTABLE-UPDATE] Phase 3 Complete: Terminology Cleanup

Browse Source 
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.
This commit is contained in:
Digital Production Factory
2025-12-09 19:25:11 -03:00
parent 6ac9e7d811
commit 2c9f52c029
52 changed files with 154 additions and 154 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
admin-ui/design-tokens.json
View File

@@ -4,7 +4,7 @@
"design-system": {
"name": "DSS Admin UI",
"version": "1.0.0",
"description": "Design System Swarm - Admin UI Design Tokens"
"description": "Design System Server - Admin UI Design Tokens"
},
"color": {
"primary": {

4
admin-ui/js/components/admin/ds-user-settings.js
View File

@@ -226,10 +226,10 @@ export default class DSUserSettings extends HTMLElement {
<h2 style="margin: 0 0 16px 0; font-size: 18px;">About</h2>
<div style="background: var(--vscode-sidebar); border: 1px solid var(--vscode-border); border-radius: 4px; padding: 16px; margin-bottom: 16px;">
<h3 style="margin: 0 0 12px 0; font-size: 14px;">Design System Swarm</h3>
<h3 style="margin: 0 0 12px 0; font-size: 14px;">Design System Server</h3>
<p style="margin: 0 0 8px 0; font-size: 12px; color: var(--vscode-text-dim);">Version: 3.0.0 (MVP3)</p>
<p style="margin: 0 0 8px 0; font-size: 12px;">Advanced design system management platform with AI assistance, design tokens, and multi-team collaboration.</p>
<p style="margin: 0; font-size: 11px; color: var(--vscode-text-dim);">© 2024 Design System Swarm. All rights reserved.</p>
<p style="margin: 0; font-size: 11px; color: var(--vscode-text-dim);">© 2024 Design System Server. All rights reserved.</p>
</div>
<h3 style="margin: 16px 0 8px 0; font-size: 14px;">Features</h3>

2
admin-ui/js/core/ai.js
View File

@@ -1038,7 +1038,7 @@ class DsAiChat extends HTMLElement {
this.restoreTeamContext();
this.loadProjects();
// Subscribe to global project changes (organism awareness)
// Subscribe to global project changes (component awareness)
if (window.app?.store) {
// Read current state immediately (prevent race condition)
const currentProject = window.app.store.get('currentProject');

34
admin-ui/js/core/error-handler.js
View File

@@ -5,7 +5,7 @@
* Converts technical errors into human-friendly, actionable treatment plans.
* Integrates with the messaging system for structured error reporting.
*
* Biological Framework: These error messages use organism metaphors to make
* Biological Framework: These error messages use component metaphors to make
* issues intuitive. See docs/DSS_ORGANISM_GUIDE.md for the full framework.
*
* @module error-handler
@@ -14,7 +14,7 @@
import { notifyError, ErrorCode } from './messaging.js';
/**
* Error message templates with organism metaphors
* Error message templates with component metaphors
*
* These messages use biological language from the DSS Organism Framework.
* Each error is framed as a symptom the immune system detected, with
@@ -28,7 +28,7 @@ const errorMessages = {
actions: [
'Verify your Figma authentication token in Settings (nervous system communication)',
'Confirm you have access to this file in Figma (sensory perception)',
'Check if the file still exists (organism awareness)',
'Check if the file still exists (component awareness)',
],
code: ErrorCode.FIGMA_API_ERROR,
},
@@ -56,7 +56,7 @@ const errorMessages = {
title: '⚡ METABOLISM ALERT: Sensory Overload',
message: 'The DSS is sensing too quickly. Figma\'s rate limits have been triggered.',
actions: [
'Let the organism rest for 1-2 minutes before sensing again',
'Let the component rest for 1-2 minutes before sensing again',
'Reduce how frequently the sensory system extracts data',
],
code: ErrorCode.FIGMA_API_ERROR,
@@ -65,7 +65,7 @@ const errorMessages = {
title: '🔌 EXTERNAL SYSTEM ALERT: Figma Organism Stressed',
message: 'Figma\'s servers are experiencing stress. This is external to DSS.',
actions: [
'Wait while the external organism recovers',
'Wait while the external component recovers',
'Check Figma health: status.figma.com',
],
code: ErrorCode.FIGMA_API_ERROR,
@@ -84,19 +84,19 @@ const errorMessages = {
// API Connection Errors - Nervous System / Heart Issues
api_network: {
title: '❤️ CRITICAL: Heart Not Responding',
message: 'The DSS nervous system cannot reach the heart (server). The organism is not responding.',
message: 'The DSS nervous system cannot reach the heart (server). The component is not responding.',
actions: [
'Verify the heart is beating: curl http://localhost:3456/health',
'Restart the heart: cd tools/api && python3 -m uvicorn server:app --port 3456',
'Check your network connection to the organism',
'Check your network connection to the component',
],
code: ErrorCode.SYSTEM_NETWORK,
},
api_timeout: {
title: '⚡ METABOLISM ALERT: Organism Overloaded',
message: 'The DSS organism took too long to respond. The heart may be stressed or metabolism sluggish.',
message: 'The DSS component took too long to respond. The heart may be stressed or metabolism sluggish.',
actions: [
'Let the organism rest and try again shortly',
'Let the component rest and try again shortly',
'Check the heart\'s logs for signs of stress: tail -f /tmp/dss-demo.log',
'Reduce metabolic load (try processing smaller batches)',
],
@@ -108,7 +108,7 @@ const errorMessages = {
actions: [
'Examine the brain\'s thoughts in the logs: tail -f /tmp/dss-demo.log',
'Retry the operation to see if it recovers',
'Report the issue if the organism keeps failing',
'Report the issue if the component keeps failing',
],
code: ErrorCode.API_SERVER_ERROR,
},
@@ -116,7 +116,7 @@ const errorMessages = {
// Validation Errors - Immune System / Genetics
validation_missing_field: {
title: '🛡️ IMMUNE ALERT: DNA Incomplete',
message: 'The genetic code (configuration) is missing essential information. The organism cannot proceed.',
message: 'The genetic code (configuration) is missing essential information. The component cannot proceed.',
actions: [
'Fill in all fields marked as required (complete the genetic code)',
'Ensure each input field contains valid information',
@@ -137,11 +137,11 @@ const errorMessages = {
// Generic fallback
unknown: {
title: '🧬 ORGANISM ALERT: Unexplained Symptom',
message: 'The DSS organism experienced an unexpected problem. The root cause is unclear.',
message: 'The DSS component experienced an unexpected problem. The root cause is unclear.',
actions: [
'Try the operation again (organism may self-heal)',
'Try the operation again (component may self-heal)',
'Refresh if the issue persists (restart vitals)',
'Check browser console for clues about the organism\'s condition',
'Check browser console for clues about the component\'s condition',
],
code: ErrorCode.SYSTEM_UNEXPECTED,
},
@@ -281,7 +281,7 @@ export async function tryWithErrorHandling(fn, context = {}) {
}
/**
* Get user-friendly HTTP status message using organism metaphors
* Get user-friendly HTTP status message using component metaphors
* @param {number} status - HTTP status code
* @returns {string} User-friendly message with biological context
*/
@@ -289,9 +289,9 @@ export function getStatusMessage(status) {
const messages = {
400: '🛡️ Genetic Code Invalid - the DNA sequence doesn\'t compile',
401: '🔐 Authentication Failed - the nervous system can\'t verify identity',
403: '🚫 Access Forbidden - immune system rejected this organism',
403: '🚫 Access Forbidden - immune system rejected this component',
404: '👻 Target Lost - sensory organs can\'t perceive the resource',
429: '⚡ Metabolism Overloaded - organism sensing too quickly',
429: '⚡ Metabolism Overloaded - component sensing too quickly',
500: '🧠 Brain Error - critical neural processing failure',
502: '💀 Organism Unresponsive - the heart has stopped beating',
503: '🏥 Organism In Recovery - temporarily unable to metabolize requests',

2
admin-ui/js/core/landing-page.js
View File

@@ -161,7 +161,7 @@ class LandingPage {
this.landingPage.innerHTML = `
<div class="landing-hero">
<h1>Design System Swarm</h1>
<h1>Design System Server</h1>
<p>Welcome to your design system management interface. Select a dashboard to get started.</p>
</div>

20
admin-ui/js/core/logger.js
View File

@@ -2,7 +2,7 @@
* DSS Logger - Organism Brain Consciousness System
*
* The DSS brain uses this logger to become conscious of what's happening.
* Log levels represent the organism's level of awareness and concern.
* Log levels represent the component's level of awareness and concern.
*
* Framework: DSS Organism Framework
* See: docs/DSS_ORGANISM_GUIDE.md#brain
@@ -26,10 +26,10 @@
// Organism awareness levels - how conscious is the system?
const LOG_LEVELS = {
DEBUG: 0, // 🧠 Deep thought - brain analyzing internal processes
INFO: 1, // 💭 Awareness - organism knows what's happening
WARN: 2, // ⚠️ Symptom - organism detected something unusual
ERROR: 3, // 🛡️ Immune alert - organism detected a threat
NONE: 4 // 🌙 Sleep - organism is silent
INFO: 1, // 💭 Awareness - component knows what's happening
WARN: 2, // ⚠️ Symptom - component detected something unusual
ERROR: 3, // 🛡️ Immune alert - component detected a threat
NONE: 4 // 🌙 Sleep - component is silent
};
class Logger {
@@ -76,7 +76,7 @@ class Logger {
this.logs.shift();
}
// Console output with organism awareness emojis
// Console output with component awareness emojis
const levelEmojis = {
DEBUG: '🧠', // Brain thinking deeply
INFO: '💭', // Organism aware
@@ -153,7 +153,7 @@ class Logger {
/**
* 📜 Get recent consciousness records
* Retrieve the organism's recent thoughts and awareness
* Retrieve the component's recent thoughts and awareness
*/
getRecentLogs(count = 50) {
return this.logs.slice(-count);
@@ -169,7 +169,7 @@ class Logger {
/**
* 📤 Export consciousness
* Save the organism's awareness to a file for analysis
* Save the component's awareness to a file for analysis
*/
export() {
const dataStr = JSON.stringify(this.logs, null, 2);
@@ -186,12 +186,12 @@ class Logger {
/**
* 🧠 ORGANISM CONSCIOUSNESS
* Create the DSS organism's brain - a singleton logger that tracks all awareness
* Create the DSS component's brain - a singleton logger that tracks all awareness
*/
const logger = new Logger('DSS', 'INFO');
// Set log level from localStorage or URL param
// Allow tuning the organism's consciousness level (awareness sensitivity)
// Allow tuning the component's consciousness level (awareness sensitivity)
const urlParams = new URLSearchParams(window.location.search);
const logLevel = urlParams.get('log') || localStorage.getItem('dss_log_level') || 'INFO';
logger.setLevel(logLevel.toUpperCase());

2
admin-ui/js/core/project-selector.js
View File

@@ -20,7 +20,7 @@ class ProjectSelector {
getProjects() {
// Sample projects - in production these would come from an API
return [
{ id: 'dss', name: 'Design System Swarm', icon: '🎨' },
{ id: 'dss', name: 'Design System Server', icon: '🎨' },
{ id: 'component-library', name: 'Component Library', icon: '📦' },
{ id: 'tokens-manager', name: 'Tokens Manager', icon: '🎯' },
{ id: 'figma-sync', name: 'Figma Sync', icon: '🔄' }