crushdataai 1.2.12 → 1.2.14

package/assets/.agent/workflows/data-analyst.md

@@ -114,6 +114,29 @@ print(f"Missing values:\n{df.isnull().sum()}")
 
 ---
 
+## Step 5: Generate Dashboard Output
+
+After analysis, save for visualization:
+```python
+from pathlib import Path
+import json
+from datetime import datetime
+
+Path("reports/dashboards").mkdir(parents=True, exist_ok=True)
+
+dashboard = {
+    "metadata": {"title": "Analysis Dashboard", "generatedAt": datetime.now().isoformat()},
+    "kpis": [{"id": "kpi-1", "label": "Total", "value": "$50K", "trend": "+12%", "trendDirection": "up"}],
+    "charts": [{"id": "chart-1", "type": "line", "title": "Trend", "data": {"labels": ["Jan","Feb"], "datasets": [{"label": "Revenue", "values": [10000,20000]}]}}]
+}
+
+with open("reports/dashboards/dashboard.json", "w") as f:
+    json.dump(dashboard, f, indent=2)
+```
+Tell user: "Run `npx crushdataai dashboard` to view."
+
+---
+
 ## Pre-Delivery Checklist
 
 - [ ] Business question answered

package/assets/.claude/skills/data-analyst/SKILL.md

@@ -170,6 +170,54 @@ FROM table;
 
 ---
 
+## Step 5: Generate Dashboard Output
+
+**After analysis, save results for dashboard visualization:**
+
+1. **Search for best chart type:**
+   ```bash
+   python3 .claude/skills/data-analyst/scripts/search.py "<metric description>" --domain chart
+   ```
+
+2. **Create dashboard JSON:**
+   ```python
+   from pathlib import Path
+   import json
+   from datetime import datetime
+   
+   Path("reports/dashboards").mkdir(parents=True, exist_ok=True)
+   
+   dashboard = {
+       "metadata": {
+           "title": "Analysis Dashboard",
+           "generatedAt": datetime.now().isoformat(),
+           "dataRange": f"{start_date} to {end_date}"
+       },
+       "kpis": [
+           {"id": "kpi-1", "label": "Total Revenue", "value": "$50,000", "trend": "+12%", "trendDirection": "up"}
+       ],
+       "charts": [
+           {
+               "id": "chart-1",
+               "type": "line",  # line, bar, pie, area, scatter, donut, table
+               "title": "Monthly Trend",
+               "data": {
+                   "labels": ["Jan", "Feb", "Mar"],
+                   "datasets": [{"label": "Revenue", "values": [10000, 15000, 25000]}]
+               }
+           }
+       ]
+   }
+   
+   with open("reports/dashboards/dashboard.json", "w") as f:
+       json.dump(dashboard, f, indent=2)
+   ```
+
+3. **Tell user:**
+   > "Dashboard ready! Run `npx crushdataai dashboard` to view."
+
+---
+
 ## Pre-Delivery Checklist
 
 Before presenting final results:

package/assets/.cursor/commands/data-analyst.md

@@ -60,6 +60,26 @@ Report findings and ask user for confirmation.
 - Compare to benchmarks
 - Present for user validation
 
+### 5. Generate Dashboard Output
+After analysis, save for visualization:
+```python
+from pathlib import Path
+import json
+from datetime import datetime
+
+Path("reports/dashboards").mkdir(parents=True, exist_ok=True)
+
+dashboard = {
+    "metadata": {"title": "Analysis", "generatedAt": datetime.now().isoformat()},
+    "kpis": [{"id": "kpi-1", "label": "Total", "value": "$50K", "trend": "+12%"}],
+    "charts": [{"id": "chart-1", "type": "line", "title": "Trend", "data": {"labels": ["Jan","Feb"], "datasets": [{"label": "Revenue", "values": [10000,20000]}]}}]
+}
+
+with open("reports/dashboards/dashboard.json", "w") as f:
+    json.dump(dashboard, f, indent=2)
+```
+Tell user: "Run `npx crushdataai dashboard` to view."
+
 ---
 
 ## Quick Reference

package/assets/.github/prompts/data-analyst.prompt.md

@@ -58,3 +58,21 @@ Report and confirm before proceeding.
 - Check totals
 - Compare benchmarks
 - User validation
+
+### 5. Generate Dashboard Output
+After analysis, save for visualization:
+```python
+from pathlib import Path
+import json
+from datetime import datetime
+
+Path("reports/dashboards").mkdir(parents=True, exist_ok=True)
+dashboard = {
+    "metadata": {"title": "Analysis", "generatedAt": datetime.now().isoformat()},
+    "kpis": [{"id": "kpi-1", "label": "Total", "value": "$50K", "trend": "+12%"}],
+    "charts": [{"id": "chart-1", "type": "line", "title": "Trend", "data": {"labels": ["Jan","Feb"], "datasets": [{"label": "Revenue", "values": [10000,20000]}]}}]
+}
+with open("reports/dashboards/dashboard.json", "w") as f:
+    json.dump(dashboard, f, indent=2)
+```
+Tell user: "Run `npx crushdataai dashboard` to view."

package/assets/.kiro/steering/data-analyst.md

@@ -60,3 +60,21 @@ Ask: "Does this match your expectation?"
 - Compare to benchmarks
 - Document assumptions
 - Present for user confirmation
+
+### 5. Generate Dashboard Output
+After analysis, save for visualization:
+```python
+from pathlib import Path
+import json
+from datetime import datetime
+
+Path("reports/dashboards").mkdir(parents=True, exist_ok=True)
+dashboard = {
+    "metadata": {"title": "Analysis", "generatedAt": datetime.now().isoformat()},
+    "kpis": [{"id": "kpi-1", "label": "Total", "value": "$50K", "trend": "+12%"}],
+    "charts": [{"id": "chart-1", "type": "line", "title": "Trend", "data": {"labels": ["Jan","Feb"], "datasets": [{"label": "Revenue", "values": [10000,20000]}]}}]
+}
+with open("reports/dashboards/dashboard.json", "w") as f:
+    json.dump(dashboard, f, indent=2)
+```
+Tell user: "Run `npx crushdataai dashboard` to view."

package/assets/.windsurf/workflows/data-analyst.md

@@ -58,3 +58,21 @@ print(f"Shape: {df.shape}, Dates: {df['date'].min()} to {df['date'].max()}")
 - Check totals are reasonable
 - Compare to benchmarks
 - Present for user validation
+
+### 5. Generate Dashboard Output
+After analysis, save for visualization:
+```python
+from pathlib import Path
+import json
+from datetime import datetime
+
+Path("reports/dashboards").mkdir(parents=True, exist_ok=True)
+dashboard = {
+    "metadata": {"title": "Analysis", "generatedAt": datetime.now().isoformat()},
+    "kpis": [{"id": "kpi-1", "label": "Total", "value": "$50K", "trend": "+12%"}],
+    "charts": [{"id": "chart-1", "type": "line", "title": "Trend", "data": {"labels": ["Jan","Feb"], "datasets": [{"label": "Revenue", "values": [10000,20000]}]}}]
+}
+with open("reports/dashboards/dashboard.json", "w") as f:
+    json.dump(dashboard, f, indent=2)
+```
+Tell user: "Run `npx crushdataai dashboard` to view."

package/dist/commands.js

@@ -79,17 +79,25 @@ function getAssetsDir() {
 function copySharedFiles(targetDir, force) {
     const sharedSource = path.join(getAssetsDir(), '.shared', 'data-analyst');
     const sharedTarget = path.join(targetDir, SHARED_DIR);
-    if (fs.existsSync(sharedTarget) && !force) {
-        console.log(`  ⏭️  ${SHARED_DIR} already exists (use --force to overwrite)`);
-        return;
+    if (fs.existsSync(sharedTarget)) {
+        if (!force) {
+            console.log(`  ⏭️  ${SHARED_DIR} already exists (use --force to overwrite)`);
+            return;
+        }
+        // Clean reinstall: remove existing folder first
+        fs.removeSync(sharedTarget);
     }
-    fs.copySync(sharedSource, sharedTarget, { overwrite: force });
+    fs.copySync(sharedSource, sharedTarget);
     console.log(`  ✅ Created ${SHARED_DIR}/`);
 }
 function copyAIFiles(aiType, targetDir, force) {
     const config = AI_PATHS[aiType];
     const sourceDir = path.join(getAssetsDir(), config.sourceDir);
     const targetPath = path.join(targetDir, config.dir);
+    // Clean reinstall: remove entire folder first when force=true
+    if (fs.existsSync(targetPath) && force) {
+        fs.removeSync(targetPath);
+    }
     // Ensure directory exists
     fs.ensureDirSync(targetPath);
     for (const file of config.files) {
@@ -104,14 +112,18 @@ function copyAIFiles(aiType, targetDir, force) {
             console.log(`  ✅ Created ${config.dir}/${file}`);
         }
     }
-    // For Claude, also create symlinks to shared scripts and data
+    // For Claude, also copy shared scripts and data
     if (aiType === 'claude') {
         const scriptsLink = path.join(targetPath, 'scripts');
         const dataLink = path.join(targetPath, 'data');
-        const sharedScripts = path.relative(targetPath, path.join(targetDir, SHARED_DIR, 'scripts'));
-        const sharedData = path.relative(targetPath, path.join(targetDir, SHARED_DIR, 'data'));
-        // Note: Symlinks may require admin on Windows. Copy as fallback.
         try {
+            // Clean reinstall: remove existing folders first when force=true
+            if (force) {
+                if (fs.existsSync(scriptsLink))
+                    fs.removeSync(scriptsLink);
+                if (fs.existsSync(dataLink))
+                    fs.removeSync(dataLink);
+            }
             if (!fs.existsSync(scriptsLink)) {
                 fs.copySync(path.join(targetDir, SHARED_DIR, 'scripts'), scriptsLink);
                 console.log(`  ✅ Copied scripts to ${config.dir}/scripts/`);

package/dist/dashboard-server.d.ts

@@ -0,0 +1 @@
+export declare function startDashboardServer(port: number): Promise<void>;

package/dist/dashboard-server.js

@@ -0,0 +1,78 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startDashboardServer = startDashboardServer;
+const express_1 = __importDefault(require("express"));
+const path = __importStar(require("path"));
+const open_1 = __importDefault(require("open"));
+const dashboard_1 = __importDefault(require("./routes/dashboard"));
+async function startDashboardServer(port) {
+    const app = (0, express_1.default)();
+    // Serve static files from the built dashboard UI
+    const uiPath = path.join(__dirname, '..', 'ui-dashboard-dist');
+    app.use(express_1.default.static(uiPath));
+    // API routes
+    app.use('/api', dashboard_1.default);
+    // SPA fallback - serve index.html for client-side routing
+    app.get('*', (_req, res) => {
+        res.sendFile(path.join(uiPath, 'index.html'));
+    });
+    return new Promise((resolve, reject) => {
+        const server = app.listen(port, async () => {
+            console.log(`\n📊 Dashboard UI running at http://localhost:${port}\n`);
+            console.log('   Looking for dashboards in: reports/dashboards/');
+            console.log('   Press Ctrl+C to stop\n');
+            // Open browser
+            try {
+                await (0, open_1.default)(`http://localhost:${port}`);
+            }
+            catch (err) {
+                // Ignore open errors
+            }
+            resolve();
+        });
+        server.on('error', (err) => {
+            if (err.code === 'EADDRINUSE') {
+                reject(new Error(`Port ${port} is already in use. Try a different port with --port`));
+            }
+            else {
+                reject(err);
+            }
+        });
+    });
+}

package/dist/index.js

@@ -37,12 +37,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const commands_1 = require("./commands");
 const server_1 = require("./server");
+const dashboard_server_1 = require("./dashboard-server");
 const connections_1 = require("./connections");
 const program = new commander_1.Command();
 program
     .name('crushdataai')
     .description('CLI to install CrushData AI data analyst skill for AI coding assistants')
-    .version('1.2.1');
+    .version('1.2.14');
 program
     .command('init')
     .description('Initialize CrushData AI skill in current project')
@@ -125,4 +126,19 @@ program
     const { schema } = await Promise.resolve().then(() => __importStar(require('./commands/schema')));
     await schema(connection, table);
 });
+program
+    .command('dashboard')
+    .description('Open the dashboard visualization UI')
+    .option('-p, --port <port>', 'Server port', '3002')
+    .action(async (options) => {
+    const port = parseInt(options.port);
+    console.log('\n📊 Starting CrushData AI Dashboard...\n');
+    try {
+        await (0, dashboard_server_1.startDashboardServer)(port);
+    }
+    catch (error) {
+        console.error(`❌ Error: ${error.message}`);
+        process.exit(1);
+    }
+});
 program.parse();

package/dist/routes/dashboard.d.ts

@@ -0,0 +1,2 @@
+declare const router: import("express-serve-static-core").Router;
+export default router;

package/dist/routes/dashboard.js

@@ -0,0 +1,113 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const express_1 = require("express");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const router = (0, express_1.Router)();
+// Get reports/dashboards directory path relative to current working directory
+function getDashboardsDir() {
+    return path.join(process.cwd(), 'reports', 'dashboards');
+}
+// List all available dashboards
+router.get('/dashboards', (_req, res) => {
+    try {
+        const dashboardsDir = getDashboardsDir();
+        // Check if directory exists
+        if (!fs.existsSync(dashboardsDir)) {
+            return res.json([]);
+        }
+        // Read all JSON files in the directory
+        const files = fs.readdirSync(dashboardsDir)
+            .filter(file => file.endsWith('.json'));
+        const dashboards = files.map(file => {
+            const filePath = path.join(dashboardsDir, file);
+            const content = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+            // Use filename without extension as ID
+            const id = path.basename(file, '.json');
+            return {
+                id,
+                title: content.metadata?.title || id,
+                generatedAt: content.metadata?.generatedAt || '',
+                chartCount: content.charts?.length || 0,
+                kpiCount: content.kpis?.length || 0
+            };
+        });
+        res.json(dashboards);
+    }
+    catch (error) {
+        console.error('Error listing dashboards:', error);
+        res.status(500).json({ error: 'Failed to list dashboards' });
+    }
+});
+// Get a specific dashboard by ID
+router.get('/dashboards/:id', (req, res) => {
+    try {
+        const { id } = req.params;
+        const dashboardsDir = getDashboardsDir();
+        const filePath = path.join(dashboardsDir, `${id}.json`);
+        if (!fs.existsSync(filePath)) {
+            return res.status(404).json({ error: 'Dashboard not found' });
+        }
+        const content = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+        res.json(content);
+    }
+    catch (error) {
+        console.error('Error reading dashboard:', error);
+        res.status(500).json({ error: 'Failed to read dashboard' });
+    }
+});
+// Refresh a chart's data (placeholder for now - would re-run query)
+router.post('/charts/:id/refresh', (req, res) => {
+    try {
+        const { id } = req.params;
+        // For now, just return a success message
+        // In the future, this would:
+        // 1. Find the chart in a dashboard
+        // 2. Re-run its query against the data source
+        // 3. Update the chart data
+        // 4. Save the updated dashboard
+        res.json({
+            message: 'Refresh not yet implemented',
+            chartId: id,
+            lastRefreshed: new Date().toISOString()
+        });
+    }
+    catch (error) {
+        console.error('Error refreshing chart:', error);
+        res.status(500).json({ error: 'Failed to refresh chart' });
+    }
+});
+exports.default = router;

package/dist/types/dashboard.d.ts

@@ -0,0 +1,48 @@
+export interface DashboardMetadata {
+    title: string;
+    generatedAt: string;
+    dataRange?: string;
+    recordCount?: number;
+}
+export interface KPI {
+    id: string;
+    label: string;
+    value: string;
+    trend?: string;
+    trendDirection?: 'up' | 'down' | 'neutral';
+}
+export interface ChartQuery {
+    type: 'sql' | 'api';
+    connection?: string;
+    sql?: string;
+}
+export interface ChartDataset {
+    label: string;
+    values: number[];
+    color?: string;
+}
+export interface ChartData {
+    labels: string[];
+    datasets: ChartDataset[];
+}
+export interface Chart {
+    id: string;
+    type: string;
+    title: string;
+    description?: string;
+    query?: ChartQuery;
+    data: ChartData;
+    lastRefreshed?: string;
+}
+export interface Dashboard {
+    metadata: DashboardMetadata;
+    kpis: KPI[];
+    charts: Chart[];
+}
+export interface DashboardListItem {
+    id: string;
+    title: string;
+    generatedAt: string;
+    chartCount: number;
+    kpiCount: number;
+}

package/dist/types/dashboard.js

@@ -0,0 +1,3 @@
+"use strict";
+// Dashboard types for the API layer
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,13 +1,13 @@
 {
     "name": "crushdataai",
-    "version": "1.2.12",
+    "version": "1.2.14",
     "description": "CLI to install CrushData AI data analyst skill for AI coding assistants",
     "main": "dist/index.js",
     "bin": {
         "crushdataai": "./dist/index.js"
     },
     "scripts": {
-        "build": "tsc && cd ui-react && npm install && npm run build",
+        "build": "tsc && cd ui-react && npm install && npm run build && cd ../ui-dashboard && npm install && npm run build",
         "dev": "ts-node src/index.ts",
         "prepublishOnly": "npm run build"
     },
@@ -47,7 +47,8 @@
     "files": [
         "dist",
         "assets",
-        "ui"
+        "ui",
+        "ui-dashboard-dist"
     ],
     "repository": {
         "type": "git",