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

.dss/doc-sync/manifest.json

@@ -0,0 +1,137 @@
+{
+  "$schema": "dss-doc-sync-v1",
+  "version": "1.0.0",
+  "last_updated": "2025-12-07",
+  "description": "Documentation synchronization manifest - maps code to documentation targets",
+
+  "sources": {
+    "code_mappings": [
+      {
+        "pattern": "tools/api/server.py",
+        "extracts_to": ".knowledge/dss-architecture.json",
+        "generator": "api_extractor",
+        "mcp_entities": ["DSS_FastAPI_Server", "DSS_API_Endpoints"],
+        "triggers": ["post-commit", "manual"],
+        "description": "FastAPI server REST endpoints"
+      },
+      {
+        "pattern": "dss-claude-plugin/servers/dss-mcp-server.py",
+        "extracts_to": ".knowledge/mcp-tools.json",
+        "generator": "mcp_extractor",
+        "mcp_entities": ["DSS_MCP_Server", "DSS_MCP_Tools"],
+        "triggers": ["post-commit", "manual"],
+        "description": "MCP server tool definitions"
+      },
+      {
+        "pattern": "admin-ui/js/**/*.js",
+        "extracts_to": ".knowledge/dss-architecture.json",
+        "generator": "component_extractor",
+        "mcp_entities": ["DSS_Admin_UI", "DSS_Browser_Logger"],
+        "triggers": ["post-commit"],
+        "description": "Admin UI JavaScript components"
+      },
+      {
+        "pattern": "dss-claude-plugin/core/**/*.py",
+        "extracts_to": ".knowledge/dss-architecture.json",
+        "generator": "architecture_analyzer",
+        "mcp_entities": ["DSS_Context_Compiler", "DSS_Core_Workflows"],
+        "triggers": ["post-commit"],
+        "description": "Core workflow modules"
+      }
+    ]
+  },
+
+  "generators": {
+    "api_extractor": {
+      "module": ".dss.doc-sync.generators.api_extractor",
+      "class": "APIExtractor",
+      "enabled": true,
+      "description": "Extract FastAPI routes and endpoints"
+    },
+    "mcp_extractor": {
+      "module": ".dss.doc-sync.generators.mcp_extractor",
+      "class": "MCPExtractor",
+      "enabled": true,
+      "description": "Extract MCP tool definitions"
+    },
+    "component_extractor": {
+      "module": ".dss.doc-sync.generators.component_extractor",
+      "class": "ComponentExtractor",
+      "enabled": true,
+      "description": "Extract UI component metadata"
+    },
+    "architecture_analyzer": {
+      "module": ".dss.doc-sync.generators.architecture_analyzer",
+      "class": "ArchitectureAnalyzer",
+      "enabled": true,
+      "description": "Analyze module architecture"
+    }
+  },
+
+  "mcp_sync": {
+    "enabled": true,
+    "sync_on": ["post-commit"],
+    "batch_size": 50,
+    "provenance_tracking": true,
+    "incremental": true,
+    "description": "Synchronize .knowledge/ JSON to MCP memory graph"
+  },
+
+  "cleanup_policy": {
+    ".dss/": {
+      "archive_after_days": 30,
+      "archive_to": ".dss/sessions/{YYYY-MM}/",
+      "exclude_patterns": [
+        "runtime-config.json",
+        "doc-sync/**",
+        "dss.db"
+      ],
+      "compress": true,
+      "description": "Archive old session work artifacts"
+    },
+    ".knowledge/": {
+      "backup_on_update": true,
+      "backup_to": ".dss/backups/knowledge/",
+      "keep_backups": 10,
+      "description": "Backup knowledge base before updates"
+    }
+  },
+
+  "validation": {
+    "pre_commit": {
+      "check_manifest_syntax": true,
+      "warn_on_doc_changes": true,
+      "block_on_validation_errors": false
+    },
+    "post_commit": {
+      "validate_generated_json": true,
+      "check_mcp_sync": true,
+      "report_failures": true
+    }
+  },
+
+  "git_hooks": {
+    "pre-commit": {
+      "enabled": true,
+      "actions": [
+        "validate_manifest",
+        "check_doc_consistency"
+      ]
+    },
+    "post-commit": {
+      "enabled": true,
+      "actions": [
+        "run_generators",
+        "update_knowledge_base",
+        "sync_mcp_memory"
+      ]
+    },
+    "post-merge": {
+      "enabled": true,
+      "actions": [
+        "reconcile_conflicts",
+        "regenerate_all_docs"
+      ]
+    }
+  }
+}