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:

DSS_HOME
./.dss (project-local, if present)
~/.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).

2.2 KiB Raw Blame History