62 lines
2.2 KiB
Markdown
62 lines
2.2 KiB
Markdown
# Upgrade Notes
|
|
|
|
This file summarizes major upgrades applied to DSS to support:
|
|
- JSON-only, portable storage
|
|
- a single MCP tool layer used by local + server + plugin
|
|
- local developer usage across many projects **and** a headless server for UX/QA/Admin
|
|
|
|
## Key upgrades
|
|
|
|
### 1) Unified MCP tool layer (`dss.mcp`)
|
|
|
|
Created a shared tool registry/execution layer used by:
|
|
- Headless server (`apps/api/server.py` → `/api/mcp/*`)
|
|
- Local MCP stdio server (`python -m dss.mcp.server`)
|
|
|
|
Proxy mode is supported via `DSS_API_URL`.
|
|
|
|
### 2) JSON-only storage (removed SQLite)
|
|
|
|
All state is stored as JSON under `DSS_HOME`:
|
|
- Project data: `$DSS_HOME/data/projects/<project_id>/...`
|
|
- System data: `$DSS_HOME/data/_system/...`
|
|
|
|
Auth user storage is JSON-based (`dss/storage/json_store.py:Users`).
|
|
|
|
### 3) Consistent storage root (`DSS_HOME`)
|
|
|
|
Storage now resolves in this order:
|
|
1. `DSS_HOME`
|
|
2. `./.dss` (project-local, if present)
|
|
3. `~/.dss`
|
|
|
|
### 4) Storybook generation reliability
|
|
|
|
Story generation now:
|
|
- scans component directories recursively
|
|
- writes the correct story extension (`.stories.jsx` vs `.stories.tsx`)
|
|
- avoids deleting user-authored stories by only clearing files with a DSS marker
|
|
|
|
### 5) Headless server serves built Admin UI
|
|
|
|
When `admin-ui/dist/index.html` exists, the headless server now serves the built Admin UI bundle as static files (so teams can access the web dashboard from the server port).
|
|
|
|
### 6) CLI analysis now produces portable JSON output
|
|
|
|
`./dss-cli.py analyze --project-path <path>` writes:
|
|
- `<project>/.dss/analysis_graph.json`
|
|
|
|
This is intended to be commit-friendly and shareable across machines.
|
|
|
|
### 7) Removed deprecated `dss-setup`
|
|
|
|
The deprecated Claude Code command `/dss-setup` has been removed. Use `/dss-init`.
|
|
|
|
## Migration notes
|
|
|
|
- If you previously relied on `.dss/dss.db` or `DSS_DATABASE`: it is no longer used.
|
|
- If you previously imported `dss_mcp` or used `dss/mcp_server/*`: use `dss/mcp/*`.
|
|
- If you previously referenced `dss-claude-plugin/servers/*` for MCP: use `python -m dss.mcp.server`.
|
|
- Re-run `./scripts/setup-mcp.sh` after pulling to refresh `.claude/mcp.json`.
|
|
- If you used the single-port launcher on `:3456`, note `./scripts/dss` now defaults to `:6220` (override with `DSS_PORT` or update your reverse proxy).
|