@hasna/microservices 0.0.9 → 0.0.11

package/dist/index.js

@@ -7,7 +7,8 @@ var CATEGORIES = [
   "Productivity",
   "HR",
   "Analytics",
-  "Management"
+  "Management",
+  "Personal"
 ];
 var MICROSERVICES = [
   {
@@ -73,6 +74,20 @@ var MICROSERVICES = [
     category: "CRM",
     tags: ["social-media", "posts", "scheduling", "engagement", "analytics", "x", "linkedin", "instagram"]
   },
+  {
+    name: "leads",
+    displayName: "Leads",
+    description: "Lead generation, storage, scoring, and data enrichment with pipeline tracking, bulk import/export, and deduplication",
+    category: "CRM",
+    tags: ["leads", "lead-generation", "scoring", "enrichment", "pipeline", "dedup", "import", "export"]
+  },
+  {
+    name: "proposals",
+    displayName: "Proposals",
+    description: "Create, send, track, and convert proposals with templates, expiry tracking, and conversion analytics",
+    category: "CRM",
+    tags: ["proposals", "quotes", "estimates", "sales", "clients", "conversion"]
+  },
   {
     name: "inventory",
     displayName: "Inventory",
@@ -101,6 +116,34 @@ var MICROSERVICES = [
     category: "Operations",
     tags: ["domains", "dns", "ssl", "registrar", "nameservers", "whois", "certificates"]
   },
+  {
+    name: "products",
+    displayName: "Products",
+    description: "Product catalog with categories, pricing tiers, variants, bulk import/export, and inventory status tracking",
+    category: "Operations",
+    tags: ["products", "catalog", "pricing", "categories", "sku", "inventory", "import", "export"]
+  },
+  {
+    name: "notifications",
+    displayName: "Notifications",
+    description: "Send notifications across channels (email, Slack, SMS, webhook, in-app) with rules, templates, variable substitution, and event processing",
+    category: "Operations",
+    tags: ["notifications", "alerts", "email", "slack", "sms", "webhook", "in-app", "templates", "rules", "events"]
+  },
+  {
+    name: "projects",
+    displayName: "Projects",
+    description: "Project management with milestones, deliverables, budget tracking, timelines, and progress reporting",
+    category: "Operations",
+    tags: ["projects", "milestones", "deliverables", "budget", "timeline", "planning", "tracking"]
+  },
+  {
+    name: "compliance",
+    displayName: "Compliance",
+    description: "Compliance management with requirements tracking, license management, and audit scheduling across regulatory frameworks (GDPR, SOC2, HIPAA, PCI, ISO 27001)",
+    category: "Operations",
+    tags: ["compliance", "gdpr", "soc2", "hipaa", "pci", "iso27001", "audit", "licenses", "requirements", "regulatory"]
+  },
   {
     name: "notes",
     displayName: "Notes",
@@ -156,6 +199,55 @@ var MICROSERVICES = [
     description: "Transcribe audio and video from files and URLs (YouTube, Vimeo, Wistia, etc.) using ElevenLabs or OpenAI Whisper",
     category: "Productivity",
     tags: ["transcription", "audio", "video", "youtube", "vimeo", "wistia", "elevenlabs", "openai", "whisper", "speech-to-text"]
+  },
+  {
+    name: "wiki",
+    displayName: "Wiki",
+    description: "Wiki with pages, version history, internal links, and hierarchical page trees",
+    category: "Productivity",
+    tags: ["wiki", "pages", "knowledge-base", "versioning", "links", "markdown"]
+  },
+  {
+    name: "assets",
+    displayName: "Assets",
+    description: "Digital asset management with collections, tagging, metadata, and type-based organization",
+    category: "Productivity",
+    tags: ["assets", "files", "collections", "media", "images", "documents", "digital-assets"]
+  },
+  {
+    name: "habits",
+    displayName: "Habits",
+    description: "Habit tracking with streaks, completions, and analytics \u2014 daily, weekly, and monthly habits with completion rates and reports",
+    category: "Personal",
+    tags: ["habits", "streaks", "tracking", "completions", "daily", "weekly", "goals", "wellness"]
+  },
+  {
+    name: "health",
+    displayName: "Health",
+    description: "Health tracking with metrics, medications, appointments, and fitness logs",
+    category: "Personal",
+    tags: ["health", "metrics", "medications", "appointments", "fitness", "wellness", "medical"]
+  },
+  {
+    name: "reading",
+    displayName: "Reading",
+    description: "Reading tracker with books, highlights, reading sessions, pace analytics, and progress tracking",
+    category: "Personal",
+    tags: ["reading", "books", "highlights", "sessions", "tracking", "pace", "library"]
+  },
+  {
+    name: "travel",
+    displayName: "Travel",
+    description: "Travel management with trips, bookings, documents, loyalty programs, and budget tracking",
+    category: "Personal",
+    tags: ["travel", "trips", "bookings", "flights", "hotels", "loyalty", "documents", "budget"]
+  },
+  {
+    name: "analytics",
+    displayName: "Analytics",
+    description: "Business analytics with KPIs, dashboards, reports, and AI-powered executive summaries",
+    category: "Analytics",
+    tags: ["analytics", "kpis", "dashboards", "reports", "metrics", "business-intelligence", "executive-summary"]
   }
 ];
 function getMicroservice(name) {
@@ -270,6 +362,28 @@ function resolveSourceDir() {
   return fromBin;
 }
 var SOURCE_DIR = resolveSourceDir();
+var PRESERVED_DB_FILES = new Set(["data.db", "data.db-wal", "data.db-shm"]);
+function getCliCandidates(baseDir) {
+  return [
+    join2(baseDir, "src", "cli", "index.ts"),
+    join2(baseDir, "cli.ts"),
+    join2(baseDir, "src", "index.ts")
+  ];
+}
+function hasInstalledSource(baseDir) {
+  return getCliCandidates(baseDir).some((candidate) => existsSync2(candidate));
+}
+function clearInstalledSource(baseDir) {
+  if (!existsSync2(baseDir)) {
+    return;
+  }
+  for (const entry of readdirSync(baseDir)) {
+    if (PRESERVED_DB_FILES.has(entry)) {
+      continue;
+    }
+    rmSync(join2(baseDir, entry), { recursive: true, force: true });
+  }
+}
 function getMicroservicePath(name) {
   const msName = name.startsWith("microservice-") ? name : `microservice-${name}`;
   return join2(SOURCE_DIR, msName);
@@ -310,6 +424,9 @@ function installMicroservice(name, options = {}) {
     if (!existsSync2(targetDir)) {
       mkdirSync2(targetDir, { recursive: true });
     }
+    if (existsSync2(destPath) && overwrite) {
+      clearInstalledSource(destPath);
+    }
     cpSync(sourcePath, destPath, { recursive: true });
     return {
       microservice: cleanName,
@@ -334,7 +451,7 @@ function getInstalledMicroservices(targetDir) {
   }
   return readdirSync(dir).filter((f) => {
     const fullPath = join2(dir, f);
-    return f.startsWith("microservice-") && statSync(fullPath).isDirectory();
+    return f.startsWith("microservice-") && statSync(fullPath).isDirectory() && hasInstalledSource(fullPath);
   }).map((f) => f.replace("microservice-", ""));
 }
 function removeMicroservice(name, options = {}) {
@@ -363,7 +480,7 @@ function getMicroserviceStatus(name) {
   const msName = name.startsWith("microservice-") ? name : `microservice-${name}`;
   const msPath = join2(dir, msName);
   const dbPath = join2(msPath, "data.db");
-  const installed = existsSync2(msPath);
+  const installed = hasInstalledSource(msPath);
   const hasDatabase = existsSync2(dbPath);
   let dbSizeBytes = 0;
   if (hasDatabase) {

package/microservices/microservice-analytics/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@hasna/microservice-analytics",
+  "version": "0.0.1",
+  "description": "Business analytics microservice with KPIs, dashboards, reports, and AI-powered executive summaries",
+  "type": "module",
+  "bin": {
+    "microservice-analytics": "./src/cli/index.ts",
+    "microservice-analytics-mcp": "./src/mcp/index.ts"
+  },
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "scripts": {
+    "dev": "bun run ./src/cli/index.ts",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "commander": "^12.1.0",
+    "zod": "^3.24.0"
+  },
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  }
+}

package/microservices/microservice-analytics/src/cli/index.ts

@@ -0,0 +1,373 @@
+#!/usr/bin/env bun
+
+import { Command } from "commander";
+import {
+  recordKpi,
+  getKpi,
+  getKpiTrend,
+  listKpis,
+  getLatestKpis,
+  createDashboard,
+  getDashboard,
+  listDashboards,
+  updateDashboard,
+  deleteDashboard,
+  generateReport,
+  getReport,
+  listReports,
+  getBusinessHealth,
+  generateExecutiveSummary,
+} from "../db/analytics.js";
+
+const program = new Command();
+
+program
+  .name("microservice-analytics")
+  .description("Business analytics microservice")
+  .version("0.0.1");
+
+// --- KPIs ---
+
+const kpiCmd = program
+  .command("kpi")
+  .description("KPI management");
+
+kpiCmd
+  .command("record")
+  .description("Record a KPI value")
+  .requiredOption("--name <name>", "KPI name")
+  .requiredOption("--value <value>", "KPI value")
+  .option("--category <category>", "Category")
+  .option("--source <service>", "Source service")
+  .option("--period <period>", "Period (e.g. 2024-Q1)")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    const kpi = recordKpi({
+      name: opts.name,
+      value: parseFloat(opts.value),
+      category: opts.category,
+      source_service: opts.source,
+      period: opts.period,
+    });
+
+    if (opts.json) {
+      console.log(JSON.stringify(kpi, null, 2));
+    } else {
+      console.log(`Recorded KPI: ${kpi.name} = ${kpi.value} (${kpi.id})`);
+    }
+  });
+
+kpiCmd
+  .command("get")
+  .description("Get the latest value for a KPI")
+  .argument("<name>", "KPI name")
+  .option("--period <period>", "Filter by period")
+  .option("--json", "Output as JSON", false)
+  .action((name, opts) => {
+    const kpi = getKpi(name, opts.period);
+    if (!kpi) {
+      console.error(`KPI '${name}' not found.`);
+      process.exit(1);
+    }
+
+    if (opts.json) {
+      console.log(JSON.stringify(kpi, null, 2));
+    } else {
+      console.log(`${kpi.name}: ${kpi.value}`);
+      if (kpi.category) console.log(`  Category: ${kpi.category}`);
+      if (kpi.period) console.log(`  Period: ${kpi.period}`);
+      if (kpi.source_service) console.log(`  Source: ${kpi.source_service}`);
+      console.log(`  Recorded: ${kpi.recorded_at}`);
+    }
+  });
+
+kpiCmd
+  .command("trend")
+  .description("Get KPI trend over time")
+  .argument("<name>", "KPI name")
+  .option("--days <n>", "Number of days to look back", "30")
+  .option("--json", "Output as JSON", false)
+  .action((name, opts) => {
+    const trend = getKpiTrend(name, parseInt(opts.days));
+
+    if (opts.json) {
+      console.log(JSON.stringify(trend, null, 2));
+    } else {
+      if (trend.length === 0) {
+        console.log(`No trend data for '${name}' in the last ${opts.days} days.`);
+        return;
+      }
+      console.log(`Trend for ${name} (last ${opts.days} days):`);
+      for (const kpi of trend) {
+        console.log(`  ${kpi.recorded_at}: ${kpi.value}`);
+      }
+    }
+  });
+
+kpiCmd
+  .command("list")
+  .description("List KPIs")
+  .option("--category <category>", "Filter by category")
+  .option("--source <service>", "Filter by source service")
+  .option("--limit <n>", "Limit results")
+  .option("--latest", "Show only latest value per KPI", false)
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    const kpis = opts.latest
+      ? getLatestKpis()
+      : listKpis({
+          category: opts.category,
+          source_service: opts.source,
+          limit: opts.limit ? parseInt(opts.limit) : undefined,
+        });
+
+    if (opts.json) {
+      console.log(JSON.stringify(kpis, null, 2));
+    } else {
+      if (kpis.length === 0) {
+        console.log("No KPIs found.");
+        return;
+      }
+      for (const kpi of kpis) {
+        const cat = kpi.category ? ` [${kpi.category}]` : "";
+        console.log(`  ${kpi.name}: ${kpi.value}${cat}`);
+      }
+      console.log(`\n${kpis.length} KPI(s)`);
+    }
+  });
+
+// --- Dashboards ---
+
+const dashCmd = program
+  .command("dashboard")
+  .description("Dashboard management");
+
+dashCmd
+  .command("create")
+  .description("Create a dashboard")
+  .requiredOption("--name <name>", "Dashboard name")
+  .option("--description <desc>", "Description")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    const dashboard = createDashboard({
+      name: opts.name,
+      description: opts.description,
+    });
+
+    if (opts.json) {
+      console.log(JSON.stringify(dashboard, null, 2));
+    } else {
+      console.log(`Created dashboard: ${dashboard.name} (${dashboard.id})`);
+    }
+  });
+
+dashCmd
+  .command("list")
+  .description("List dashboards")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    const dashboards = listDashboards();
+
+    if (opts.json) {
+      console.log(JSON.stringify(dashboards, null, 2));
+    } else {
+      if (dashboards.length === 0) {
+        console.log("No dashboards found.");
+        return;
+      }
+      for (const d of dashboards) {
+        const desc = d.description ? ` — ${d.description}` : "";
+        console.log(`  ${d.name}${desc} (${d.widgets.length} widgets)`);
+      }
+      console.log(`\n${dashboards.length} dashboard(s)`);
+    }
+  });
+
+dashCmd
+  .command("get")
+  .description("Get a dashboard")
+  .argument("<id>", "Dashboard ID")
+  .option("--json", "Output as JSON", false)
+  .action((id, opts) => {
+    const dashboard = getDashboard(id);
+    if (!dashboard) {
+      console.error(`Dashboard '${id}' not found.`);
+      process.exit(1);
+    }
+
+    if (opts.json) {
+      console.log(JSON.stringify(dashboard, null, 2));
+    } else {
+      console.log(`${dashboard.name}`);
+      if (dashboard.description) console.log(`  Description: ${dashboard.description}`);
+      console.log(`  Widgets: ${dashboard.widgets.length}`);
+      console.log(`  Created: ${dashboard.created_at}`);
+    }
+  });
+
+dashCmd
+  .command("update")
+  .description("Update a dashboard")
+  .argument("<id>", "Dashboard ID")
+  .option("--name <name>", "Name")
+  .option("--description <desc>", "Description")
+  .option("--json", "Output as JSON", false)
+  .action((id, opts) => {
+    const input: Record<string, unknown> = {};
+    if (opts.name !== undefined) input.name = opts.name;
+    if (opts.description !== undefined) input.description = opts.description;
+
+    const dashboard = updateDashboard(id, input);
+    if (!dashboard) {
+      console.error(`Dashboard '${id}' not found.`);
+      process.exit(1);
+    }
+
+    if (opts.json) {
+      console.log(JSON.stringify(dashboard, null, 2));
+    } else {
+      console.log(`Updated: ${dashboard.name}`);
+    }
+  });
+
+dashCmd
+  .command("delete")
+  .description("Delete a dashboard")
+  .argument("<id>", "Dashboard ID")
+  .action((id) => {
+    const deleted = deleteDashboard(id);
+    if (deleted) {
+      console.log(`Deleted dashboard ${id}`);
+    } else {
+      console.error(`Dashboard '${id}' not found.`);
+      process.exit(1);
+    }
+  });
+
+// --- Reports ---
+
+const reportCmd = program
+  .command("report")
+  .description("Report management");
+
+reportCmd
+  .command("generate")
+  .description("Generate a report")
+  .requiredOption("--name <name>", "Report name")
+  .requiredOption("--type <type>", "Report type (daily|weekly|monthly|quarterly|annual|custom)")
+  .option("--period <period>", "Period (e.g. 2024-Q1)")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    const report = generateReport({
+      name: opts.name,
+      type: opts.type,
+      period: opts.period,
+    });
+
+    if (opts.json) {
+      console.log(JSON.stringify(report, null, 2));
+    } else {
+      console.log(`Generated report: ${report.name} (${report.id})`);
+      console.log(`Type: ${report.type}`);
+      if (report.period) console.log(`Period: ${report.period}`);
+      console.log(`\n${report.content}`);
+    }
+  });
+
+reportCmd
+  .command("list")
+  .description("List reports")
+  .option("--type <type>", "Filter by type")
+  .option("--limit <n>", "Limit results")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    const reports = listReports({
+      type: opts.type,
+      limit: opts.limit ? parseInt(opts.limit) : undefined,
+    });
+
+    if (opts.json) {
+      console.log(JSON.stringify(reports, null, 2));
+    } else {
+      if (reports.length === 0) {
+        console.log("No reports found.");
+        return;
+      }
+      for (const r of reports) {
+        const period = r.period ? ` (${r.period})` : "";
+        console.log(`  [${r.type}] ${r.name}${period} — ${r.generated_at}`);
+      }
+      console.log(`\n${reports.length} report(s)`);
+    }
+  });
+
+reportCmd
+  .command("get")
+  .description("Get a report")
+  .argument("<id>", "Report ID")
+  .option("--json", "Output as JSON", false)
+  .action((id, opts) => {
+    const report = getReport(id);
+    if (!report) {
+      console.error(`Report '${id}' not found.`);
+      process.exit(1);
+    }
+
+    if (opts.json) {
+      console.log(JSON.stringify(report, null, 2));
+    } else {
+      console.log(`${report.name} [${report.type}]`);
+      if (report.period) console.log(`Period: ${report.period}`);
+      console.log(`Generated: ${report.generated_at}`);
+      console.log(`\n${report.content}`);
+    }
+  });
+
+// --- Health & Summary ---
+
+program
+  .command("health")
+  .description("Get overall business health summary")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    const health = getBusinessHealth();
+
+    if (opts.json) {
+      console.log(JSON.stringify(health, null, 2));
+    } else {
+      console.log("=== Business Health ===");
+      console.log(`  Unique KPIs: ${health.total_kpis}`);
+      console.log(`  Reports: ${health.report_count}`);
+      console.log(`  Dashboards: ${health.dashboard_count}`);
+
+      if (health.categories.length > 0) {
+        console.log("\n  Categories:");
+        for (const cat of health.categories) {
+          console.log(`    ${cat.category}: ${cat.count} KPI(s), latest value: ${cat.latest_value}`);
+        }
+      }
+
+      if (health.latest_kpis.length > 0) {
+        console.log("\n  Latest KPIs:");
+        for (const kpi of health.latest_kpis) {
+          console.log(`    ${kpi.name}: ${kpi.value}`);
+        }
+      }
+    }
+  });
+
+program
+  .command("summary")
+  .description("Generate an AI-powered executive summary")
+  .option("--json", "Output as JSON", false)
+  .action(async (opts) => {
+    const summary = await generateExecutiveSummary();
+
+    if (opts.json) {
+      console.log(JSON.stringify({ summary }, null, 2));
+    } else {
+      console.log(summary);
+    }
+  });
+
+program.parse(process.argv);