Preserve spark02 repo state

README.md

@@ -39,6 +39,28 @@ mcps --help
 - `mcps fleet health --refresh`
 - `mcps fleet install --yes`
 
+## Output Defaults
+
+CLI list/search/status-style commands are compact by default for human and
+agent terminals. They show essential fields, truncate long text, and cap rows.
+Use `--limit` and `--cursor` to page through broad results.
+
+Use detail flags and commands when you need full records:
+
+```bash
+mcps list --verbose
+mcps info <server-id> --json
+mcps tools --verbose --limit 50
+mcps find postgres --cursor 20
+mcps providers info github --json
+mcps storage status --json
+```
+
+MCP list/search/catalog tools follow the same gradual-disclosure pattern:
+default responses are compact envelopes with `items`, `total`, `nextCursor`,
+and a `hint`; pass `verbose: true` or call a detail tool such as
+`get_server_info` or `get_provider_profile` for full JSON records.
+
 ## Fleet Operations
 
 Use machine registration plus fleet health/install commands to manage `@hasna/*`
@@ -102,16 +124,23 @@ mcps-mcp
 
 The MCP server exposes registry, finder, machine registry, and fleet orchestration tools.
 
-## Cloud Sync
+## Storage Sync
 
-This package supports cloud sync via `@hasna/cloud`:
+This package supports optional remote storage sync directly against a Postgres/RDS
+database. Local SQLite remains the default.
 
 ```bash
-cloud setup
-cloud sync push --service mcps
-cloud sync pull --service mcps
+export HASNA_MCPS_DATABASE_URL=postgres://...
+
+mcps storage status
+mcps storage push
+mcps storage pull
+mcps storage sync
 ```
 
+MCP exposes the same flow through `storage_status`, `storage_push`,
+`storage_pull`, and `storage_sync`.
+
 ## Data Directory
 
 Data is stored in `~/.hasna/mcps/`.

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/mcps",
-  "version": "0.0.18",
+  "version": "0.0.21",
   "description": "Meta-MCP registry & CLI — discover, manage, and proxy MCP servers",
   "type": "module",
   "repository": {
@@ -17,6 +17,10 @@
     "./mcp": {
       "import": "./dist/mcp/index.js",
       "types": "./dist/mcp/index.d.ts"
+    },
+    "./storage": {
+      "import": "./dist/storage.js",
+      "types": "./dist/storage.d.ts"
     }
   },
   "bin": {
@@ -31,7 +35,8 @@
     "README.md"
   ],
   "scripts": {
-    "build": "bun run build:dashboard && bun build ./src/cli/index.tsx --outdir ./bin --target bun --external ink --external react --external chalk && bun build ./src/mcp/index.ts --outfile ./bin/mcp.js --target bun && bun run scripts/fix-shebangs.ts && bun build ./src/index.ts --outdir ./dist --target bun && bun build ./src/mcp/index.ts --outdir ./dist/mcp --target bun && tsc --emitDeclarationOnly --declaration --outDir dist",
+    "clean": "rm -rf bin dist dashboard/dist",
+    "build": "bun run clean && bun run build:dashboard && bun build ./src/cli/index.tsx --outdir ./bin --target bun --external ink --external react --external chalk && bun build ./src/mcp/index.ts --outfile ./bin/mcp.js --target bun && bun run scripts/fix-shebangs.ts && bun build ./src/index.ts ./src/storage.ts --outdir ./dist --target bun && bun build ./src/mcp/index.ts --outdir ./dist/mcp --target bun && tsc --emitDeclarationOnly --declaration --outDir dist",
     "build:dashboard": "cd dashboard && bun install && bun run build",
     "dev": "bun run src/cli/index.tsx",
     "dev:mcp": "bun run src/mcp/index.ts",
@@ -43,19 +48,21 @@
     "postinstall": "mkdir -p $HOME/.hasna/mcps/cache 2>/dev/null || true"
   },
   "dependencies": {
-    "@hasna/cloud": "^0.1.24",
     "@modelcontextprotocol/sdk": "^1.26.0",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "ink": "^5.0.1",
     "ink-select-input": "^6.0.0",
     "ink-spinner": "^5.0.0",
     "ink-text-input": "^6.0.0",
+    "pg": "^8.20.0",
     "react": "^18.2.0",
-    "zod": "^3.23.0"
+    "zod": "^3.23.0",
+    "@hasna/events": "^0.1.6"
   },
   "devDependencies": {
     "@types/bun": "latest",
+    "@types/pg": "^8.15.6",
     "@types/react": "^18.2.0",
     "typescript": "^5"
   },