crushdataai 1.0.0

package/assets/windsurf/data-analyst.md

@@ -0,0 +1,35 @@
+# CrushData AI - Data Analyst Workflow
+
+A data analyst intelligence workflow for structured, professional data analysis.
+
+## Trigger
+Activate when user requests: data analysis, dashboards, metrics, EDA, cohort, funnel, or A/B tests.
+
+## Workflow
+
+### 1. Discovery (MANDATORY)
+Ask before coding:
+- Business question this analysis should answer
+- Which tables/databases contain the data
+- Company-specific metric definitions
+
+### 2. Search Knowledge
+```bash
+python3 .windsurf/workflows/../.shared/data-analyst/scripts/search.py "<query>" --domain <domain>
+```
+
+Domains: `workflow`, `metric`, `chart`, `sql`, `python`, `database`, `validation`
+
+Industry: `--industry saas|ecommerce|finance|marketing`
+
+### 3. Profile Data (MANDATORY)
+Run profiling before any analysis:
+```python
+print(f"Shape: {df.shape}, Dates: {df['date'].min()} to {df['date'].max()}")
+```
+
+### 4. Validate
+- Verify JOINs don't multiply rows
+- Check totals are reasonable
+- Compare to benchmarks
+- Present for user validation

package/dist/commands.d.ts

@@ -0,0 +1,3 @@
+export declare function init(aiType: string, force: boolean): void;
+export declare function update(): void;
+export declare function versions(): void;

package/dist/commands.js

@@ -0,0 +1,159 @@
+"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 });
+exports.init = init;
+exports.update = update;
+exports.versions = versions;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const AI_TYPES = ['claude', 'cursor', 'windsurf', 'antigravity', 'copilot', 'kiro'];
+const AI_PATHS = {
+    claude: {
+        dir: '.claude/skills/data-analyst',
+        files: ['SKILL.md']
+    },
+    cursor: {
+        dir: '.cursor/commands',
+        files: ['data-analyst.md']
+    },
+    windsurf: {
+        dir: '.windsurf/workflows',
+        files: ['data-analyst.md']
+    },
+    antigravity: {
+        dir: '.agent/workflows',
+        files: ['data-analyst.md']
+    },
+    copilot: {
+        dir: '.github/prompts',
+        files: ['data-analyst.prompt.md']
+    },
+    kiro: {
+        dir: '.kiro/steering',
+        files: ['data-analyst.md']
+    }
+};
+const SHARED_DIR = '.shared/data-analyst';
+function getAssetsDir() {
+    // In npm package, assets are in the package directory
+    return path.join(__dirname, '..', 'assets');
+}
+function copySharedFiles(targetDir, force) {
+    const sharedSource = path.join(getAssetsDir(), 'shared');
+    const sharedTarget = path.join(targetDir, SHARED_DIR);
+    if (fs.existsSync(sharedTarget) && !force) {
+        console.log(`  ⏭️  ${SHARED_DIR} already exists (use --force to overwrite)`);
+        return;
+    }
+    fs.copySync(sharedSource, sharedTarget, { overwrite: force });
+    console.log(`  ✅ Created ${SHARED_DIR}/`);
+}
+function copyAIFiles(aiType, targetDir, force) {
+    const config = AI_PATHS[aiType];
+    const sourceDir = path.join(getAssetsDir(), aiType);
+    const targetPath = path.join(targetDir, config.dir);
+    // Ensure directory exists
+    fs.ensureDirSync(targetPath);
+    for (const file of config.files) {
+        const sourcePath = path.join(sourceDir, file);
+        const destPath = path.join(targetPath, file);
+        if (fs.existsSync(destPath) && !force) {
+            console.log(`  ⏭️  ${config.dir}/${file} already exists`);
+            continue;
+        }
+        if (fs.existsSync(sourcePath)) {
+            fs.copyFileSync(sourcePath, destPath);
+            console.log(`  ✅ Created ${config.dir}/${file}`);
+        }
+    }
+    // For Claude, also create symlinks to 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 {
+            if (!fs.existsSync(scriptsLink)) {
+                fs.copySync(path.join(targetDir, SHARED_DIR, 'scripts'), scriptsLink);
+                console.log(`  ✅ Copied scripts to ${config.dir}/scripts/`);
+            }
+            if (!fs.existsSync(dataLink)) {
+                fs.copySync(path.join(targetDir, SHARED_DIR, 'data'), dataLink);
+                console.log(`  ✅ Copied data to ${config.dir}/data/`);
+            }
+        }
+        catch (err) {
+            console.log(`  ⚠️  Could not copy scripts/data. Use shared directory directly.`);
+        }
+    }
+}
+function init(aiType, force) {
+    const targetDir = process.cwd();
+    console.log(`\n🚀 Initializing CrushData AI in ${targetDir}\n`);
+    // Copy shared files first
+    copySharedFiles(targetDir, force);
+    // Handle 'all' or specific AI type
+    if (aiType === 'all') {
+        for (const ai of AI_TYPES) {
+            console.log(`\n📦 Setting up ${ai}...`);
+            copyAIFiles(ai, targetDir, force);
+        }
+    }
+    else if (AI_TYPES.includes(aiType)) {
+        console.log(`\n📦 Setting up ${aiType}...`);
+        copyAIFiles(aiType, targetDir, force);
+    }
+    else {
+        console.error(`❌ Unknown AI type: ${aiType}`);
+        console.error(`   Available: ${AI_TYPES.join(', ')}, all`);
+        process.exit(1);
+    }
+    console.log(`\n✨ CrushData AI installed successfully!`);
+    console.log(`\n📖 Usage:`);
+    console.log(`   - Claude Code: Uses skill automatically for data analysis requests`);
+    console.log(`   - Cursor/Windsurf/Antigravity: Use /data-analyst command`);
+    console.log(`   - Search: python3 .shared/data-analyst/scripts/search.py "<query>" --domain <domain>\n`);
+}
+function update() {
+    console.log('\n🔄 Checking for updates...');
+    console.log('   Run: npm update -g crushdataai');
+    console.log('   Then: crushdataai init --force\n');
+}
+function versions() {
+    console.log('\n📦 CrushData AI Versions');
+    console.log('   Installed: 1.0.0');
+    console.log('   Latest:    Check npm: npm show crushdataai version\n');
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const commands_1 = require("./commands");
+const program = new commander_1.Command();
+program
+    .name('crushdataai')
+    .description('CLI to install CrushData AI data analyst skill for AI coding assistants')
+    .version('1.0.0');
+program
+    .command('init')
+    .description('Initialize CrushData AI skill in current project')
+    .option('--ai <type>', 'AI assistant type (claude, cursor, windsurf, antigravity, copilot, kiro, all)', 'all')
+    .option('--force', 'Overwrite existing files', false)
+    .action((options) => {
+    (0, commands_1.init)(options.ai, options.force);
+});
+program
+    .command('update')
+    .description('Update CrushData AI skill to latest version')
+    .action(() => {
+    (0, commands_1.update)();
+});
+program
+    .command('versions')
+    .description('Show installed and latest versions')
+    .action(() => {
+    (0, commands_1.versions)();
+});
+program.parse();

package/package.json

@@ -0,0 +1,45 @@
+{
+    "name": "crushdataai",
+    "version": "1.0.0",
+    "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",
+        "dev": "ts-node src/index.ts",
+        "prepublishOnly": "npm run build"
+    },
+    "keywords": [
+        "data-analyst",
+        "ai-skill",
+        "claude",
+        "cursor",
+        "windsurf",
+        "antigravity",
+        "copilot"
+    ],
+    "author": "",
+    "license": "Apache-2.0",
+    "devDependencies": {
+        "@types/fs-extra": "^11.0.4",
+        "@types/node": "^20.10.0",
+        "typescript": "^5.3.0"
+    },
+    "dependencies": {
+        "commander": "^11.1.0",
+        "fs-extra": "^11.2.0"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "files": [
+        "dist",
+        "assets"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/SankaiAI/crushdataai-agent.git"
+    }
+}