@programinglive/dev-workflow-mcp-server 1.5.0 → 1.5.2

package/SECURITY.md

@@ -1,20 +1,20 @@
-# Security Policy
-
-## Supported Versions
-
-We release patches for security vulnerabilities under new minor or patch versions. Always use the latest release.
-
-## Reporting a Vulnerability
-
-If you discover a vulnerability, please email `security@programinglive.com` with:
-
-- Description of the issue
-- Steps to reproduce
-- Potential impact
-- Suggested remediation (if known)
-
-We aim to acknowledge reports within 72 hours and will keep you informed as we work on a fix. Please do not disclose the vulnerability publicly until we have released an update.
-
-## Disclosure Policy
-
-Once a fix is available, we will publish a security advisory in the repository releases and notify contributors via the README.
+# Security Policy
+
+## Supported Versions
+
+We release patches for security vulnerabilities under new minor or patch versions. Always use the latest release.
+
+## Reporting a Vulnerability
+
+If you discover a vulnerability, please email `security@programinglive.com` with:
+
+- Description of the issue
+- Steps to reproduce
+- Potential impact
+- Suggested remediation (if known)
+
+We aim to acknowledge reports within 72 hours and will keep you informed as we work on a fix. Please do not disclose the vulnerability publicly until we have released an update.
+
+## Disclosure Policy
+
+Once a fix is available, we will publish a security advisory in the repository releases and notify contributors via the README.

package/db/index.js

@@ -1,204 +1,204 @@
-import Database from "better-sqlite3";
-import { existsSync } from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const DB_FILENAME = "dev-workflow.db";
-const FREQUENCY_FORMATS = {
-  daily: "%Y-%m-%d",
-  monthly: "%Y-%m",
-  yearly: "%Y",
-};
-
-function getDbPath() {
-  const initCwd = process.env.INIT_CWD || process.cwd();
-  let projectRoot = initCwd;
-  while (projectRoot !== path.dirname(projectRoot)) {
-    if (existsSync(path.join(projectRoot, "package.json"))) break;
-    projectRoot = path.dirname(projectRoot);
-  }
-  return path.join(projectRoot, ".state", DB_FILENAME);
-}
-
-let db;
-export function getDb() {
-  if (!db) {
-    const dbPath = getDbPath();
-    db = new Database(dbPath);
-    db.pragma("journal_mode = WAL");
-    migrate();
-  }
-  return db;
-}
-
-function migrate() {
-  const createHistory = `
-    CREATE TABLE IF NOT EXISTS workflow_history (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      user_id TEXT NOT NULL,
-      task_description TEXT NOT NULL,
-      task_type TEXT NOT NULL,
-      commit_message TEXT,
-      timestamp DATETIME DEFAULT CURRENT_TIMESTAMP,
-      forced INTEGER DEFAULT 0,
-      force_reason TEXT,
-      dropped INTEGER DEFAULT 0,
-      drop_reason TEXT,
-      UNIQUE(user_id, timestamp, task_description)
-    )
-  `;
-  const createSummary = `
-    CREATE TABLE IF NOT EXISTS project_summary (
-      user_id TEXT PRIMARY KEY,
-      total_tasks INTEGER DEFAULT 0,
-      task_types TEXT DEFAULT '{}',
-      last_active DATETIME,
-      updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-      recent_tasks TEXT DEFAULT '[]'
-    )
-  `;
-  const idxHistory = `CREATE INDEX IF NOT EXISTS idx_workflow_history_user ON workflow_history(user_id)`;
-  const idxSummary = `CREATE INDEX IF NOT EXISTS idx_project_summary_user ON project_summary(user_id)`;
-
-  db.exec(createHistory);
-  db.exec(createSummary);
-  db.exec(idxHistory);
-  db.exec(idxSummary);
-}
-
-export function insertHistoryEntry(userId, entry) {
-  const stmt = getDb().prepare(`
-    INSERT OR REPLACE INTO workflow_history
-    (user_id, task_description, task_type, commit_message, timestamp, forced, force_reason, dropped, drop_reason)
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
-  `);
-  stmt.run(
-    userId,
-    entry.taskDescription,
-    entry.taskType,
-    entry.commitMessage,
-    entry.timestamp || new Date().toISOString(),
-    entry.forced ? 1 : 0,
-    entry.forceReason || null,
-    entry.dropped ? 1 : 0,
-    entry.dropReason || null
-  );
-  updateSummaryForUser(userId);
-}
-
-export function updateSummaryForUser(userId) {
-  const getHistory = getDb().prepare(`
-    SELECT task_type, timestamp, task_description
-    FROM workflow_history
-    WHERE user_id = ?
-    ORDER BY timestamp DESC
-    LIMIT 20
-  `);
-  const rows = getHistory.all(userId);
-
-  const taskTypes = {};
-  for (const row of rows) {
-    taskTypes[row.task_type] = (taskTypes[row.task_type] || 0) + 1;
-  }
-
-  const recentTasks = rows.slice(0, 5).map(r => ({
-    description: r.task_description,
-    type: r.task_type,
-    timestamp: r.timestamp,
-  }));
-
-  const lastActive = rows[0]?.timestamp || null;
-
-  const upsert = getDb().prepare(`
-    INSERT OR REPLACE INTO project_summary
-    (user_id, total_tasks, task_types, last_active, recent_tasks, updated_at)
-    VALUES (?, ?, ?, ?, ?, ?)
-  `);
-  upsert.run(
-    userId,
-    rows.length,
-    JSON.stringify(taskTypes),
-    lastActive,
-    JSON.stringify(recentTasks),
-    new Date().toISOString()
-  );
-}
-
-export function getSummaryForUser(userId) {
-  const stmt = getDb().prepare(`
-    SELECT * FROM project_summary WHERE user_id = ?
-  `);
-  const row = stmt.get(userId);
-  if (!row) return null;
-  return {
-    totalTasks: row.total_tasks,
-    taskTypes: JSON.parse(row.task_types),
-    lastActive: row.last_active,
-    recentTasks: JSON.parse(row.recent_tasks),
-    updatedAt: row.updated_at,
-  };
-}
-
-function buildHistoryFilters({ startDate, endDate }) {
-  const clauses = [];
-  const params = [];
-  if (startDate) {
-    clauses.push("DATE(timestamp) >= DATE(?)");
-    params.push(startDate);
-  }
-  if (endDate) {
-    clauses.push("DATE(timestamp) <= DATE(?)");
-    params.push(endDate);
-  }
-  return { clauses, params };
-}
-
-export function getHistoryForUser(userId, options = {}) {
-  const { page = 1, pageSize = 20, startDate, endDate } = options;
-  const sanitizedPage = Math.max(1, Number.isFinite(Number(page)) ? Math.floor(Number(page)) : 1);
-  const sanitizedPageSize = Math.min(100, Math.max(1, Number.isFinite(Number(pageSize)) ? Math.floor(Number(pageSize)) : 20));
-  const offset = (sanitizedPage - 1) * sanitizedPageSize;
-
-  const { clauses, params } = buildHistoryFilters({ startDate, endDate });
-  const where = ["user_id = ?", ...clauses].join(" AND ");
-  const dbInstance = getDb();
-
-  const countStmt = dbInstance.prepare(`SELECT COUNT(*) as total FROM workflow_history WHERE ${where}`);
-  const total = countStmt.get(userId, ...params).total;
-
-  const rowsStmt = dbInstance.prepare(`
-    SELECT *
-    FROM workflow_history
-    WHERE ${where}
-    ORDER BY timestamp DESC
-    LIMIT ?
-    OFFSET ?
-  `);
-  const entries = rowsStmt.all(userId, ...params, sanitizedPageSize, offset);
-
-  return {
-    entries,
-    total,
-    page: sanitizedPage,
-    pageSize: sanitizedPageSize,
-  };
-}
-
-export function getHistorySummary(userId, options = {}) {
-  const { startDate, endDate, frequency = "daily" } = options;
-  const format = FREQUENCY_FORMATS[frequency] || FREQUENCY_FORMATS.daily;
-  const { clauses, params } = buildHistoryFilters({ startDate, endDate });
-  const where = ["user_id = ?", ...clauses].join(" AND ");
-  const stmt = getDb().prepare(`
-    SELECT strftime('${format}', timestamp) AS period, COUNT(*) AS count
-    FROM workflow_history
-    WHERE ${where}
-    GROUP BY period
-    ORDER BY period DESC
-  `);
-  return stmt
-    .all(userId, ...params)
-    .map((row) => ({ period: row.period, count: row.count }));
-}
+import Database from "better-sqlite3";
+import { existsSync } from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const DB_FILENAME = "dev-workflow.db";
+const FREQUENCY_FORMATS = {
+  daily: "%Y-%m-%d",
+  monthly: "%Y-%m",
+  yearly: "%Y",
+};
+
+function getDbPath() {
+  const initCwd = process.env.INIT_CWD || process.cwd();
+  let projectRoot = initCwd;
+  while (projectRoot !== path.dirname(projectRoot)) {
+    if (existsSync(path.join(projectRoot, "package.json"))) break;
+    projectRoot = path.dirname(projectRoot);
+  }
+  return path.join(projectRoot, ".state", DB_FILENAME);
+}
+
+let db;
+export function getDb() {
+  if (!db) {
+    const dbPath = getDbPath();
+    db = new Database(dbPath);
+    db.pragma("journal_mode = WAL");
+    migrate();
+  }
+  return db;
+}
+
+function migrate() {
+  const createHistory = `
+    CREATE TABLE IF NOT EXISTS workflow_history (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      user_id TEXT NOT NULL,
+      task_description TEXT NOT NULL,
+      task_type TEXT NOT NULL,
+      commit_message TEXT,
+      timestamp DATETIME DEFAULT CURRENT_TIMESTAMP,
+      forced INTEGER DEFAULT 0,
+      force_reason TEXT,
+      dropped INTEGER DEFAULT 0,
+      drop_reason TEXT,
+      UNIQUE(user_id, timestamp, task_description)
+    )
+  `;
+  const createSummary = `
+    CREATE TABLE IF NOT EXISTS project_summary (
+      user_id TEXT PRIMARY KEY,
+      total_tasks INTEGER DEFAULT 0,
+      task_types TEXT DEFAULT '{}',
+      last_active DATETIME,
+      updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+      recent_tasks TEXT DEFAULT '[]'
+    )
+  `;
+  const idxHistory = `CREATE INDEX IF NOT EXISTS idx_workflow_history_user ON workflow_history(user_id)`;
+  const idxSummary = `CREATE INDEX IF NOT EXISTS idx_project_summary_user ON project_summary(user_id)`;
+
+  db.exec(createHistory);
+  db.exec(createSummary);
+  db.exec(idxHistory);
+  db.exec(idxSummary);
+}
+
+export function insertHistoryEntry(userId, entry) {
+  const stmt = getDb().prepare(`
+    INSERT OR REPLACE INTO workflow_history
+    (user_id, task_description, task_type, commit_message, timestamp, forced, force_reason, dropped, drop_reason)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `);
+  stmt.run(
+    userId,
+    entry.taskDescription,
+    entry.taskType,
+    entry.commitMessage,
+    entry.timestamp || new Date().toISOString(),
+    entry.forced ? 1 : 0,
+    entry.forceReason || null,
+    entry.dropped ? 1 : 0,
+    entry.dropReason || null
+  );
+  updateSummaryForUser(userId);
+}
+
+export function updateSummaryForUser(userId) {
+  const getHistory = getDb().prepare(`
+    SELECT task_type, timestamp, task_description
+    FROM workflow_history
+    WHERE user_id = ?
+    ORDER BY timestamp DESC
+    LIMIT 20
+  `);
+  const rows = getHistory.all(userId);
+
+  const taskTypes = {};
+  for (const row of rows) {
+    taskTypes[row.task_type] = (taskTypes[row.task_type] || 0) + 1;
+  }
+
+  const recentTasks = rows.slice(0, 5).map(r => ({
+    description: r.task_description,
+    type: r.task_type,
+    timestamp: r.timestamp,
+  }));
+
+  const lastActive = rows[0]?.timestamp || null;
+
+  const upsert = getDb().prepare(`
+    INSERT OR REPLACE INTO project_summary
+    (user_id, total_tasks, task_types, last_active, recent_tasks, updated_at)
+    VALUES (?, ?, ?, ?, ?, ?)
+  `);
+  upsert.run(
+    userId,
+    rows.length,
+    JSON.stringify(taskTypes),
+    lastActive,
+    JSON.stringify(recentTasks),
+    new Date().toISOString()
+  );
+}
+
+export function getSummaryForUser(userId) {
+  const stmt = getDb().prepare(`
+    SELECT * FROM project_summary WHERE user_id = ?
+  `);
+  const row = stmt.get(userId);
+  if (!row) return null;
+  return {
+    totalTasks: row.total_tasks,
+    taskTypes: JSON.parse(row.task_types),
+    lastActive: row.last_active,
+    recentTasks: JSON.parse(row.recent_tasks),
+    updatedAt: row.updated_at,
+  };
+}
+
+function buildHistoryFilters({ startDate, endDate }) {
+  const clauses = [];
+  const params = [];
+  if (startDate) {
+    clauses.push("DATE(timestamp) >= DATE(?)");
+    params.push(startDate);
+  }
+  if (endDate) {
+    clauses.push("DATE(timestamp) <= DATE(?)");
+    params.push(endDate);
+  }
+  return { clauses, params };
+}
+
+export function getHistoryForUser(userId, options = {}) {
+  const { page = 1, pageSize = 20, startDate, endDate } = options;
+  const sanitizedPage = Math.max(1, Number.isFinite(Number(page)) ? Math.floor(Number(page)) : 1);
+  const sanitizedPageSize = Math.min(100, Math.max(1, Number.isFinite(Number(pageSize)) ? Math.floor(Number(pageSize)) : 20));
+  const offset = (sanitizedPage - 1) * sanitizedPageSize;
+
+  const { clauses, params } = buildHistoryFilters({ startDate, endDate });
+  const where = ["user_id = ?", ...clauses].join(" AND ");
+  const dbInstance = getDb();
+
+  const countStmt = dbInstance.prepare(`SELECT COUNT(*) as total FROM workflow_history WHERE ${where}`);
+  const total = countStmt.get(userId, ...params).total;
+
+  const rowsStmt = dbInstance.prepare(`
+    SELECT *
+    FROM workflow_history
+    WHERE ${where}
+    ORDER BY timestamp DESC
+    LIMIT ?
+    OFFSET ?
+  `);
+  const entries = rowsStmt.all(userId, ...params, sanitizedPageSize, offset);
+
+  return {
+    entries,
+    total,
+    page: sanitizedPage,
+    pageSize: sanitizedPageSize,
+  };
+}
+
+export function getHistorySummary(userId, options = {}) {
+  const { startDate, endDate, frequency = "daily" } = options;
+  const format = FREQUENCY_FORMATS[frequency] || FREQUENCY_FORMATS.daily;
+  const { clauses, params } = buildHistoryFilters({ startDate, endDate });
+  const where = ["user_id = ?", ...clauses].join(" AND ");
+  const stmt = getDb().prepare(`
+    SELECT strftime('${format}', timestamp) AS period, COUNT(*) AS count
+    FROM workflow_history
+    WHERE ${where}
+    GROUP BY period
+    ORDER BY period DESC
+  `);
+  return stmt
+    .all(userId, ...params)
+    .map((row) => ({ period: row.period, count: row.count }));
+}

package/docs/NETLIFY_DEPLOYMENT.md

@@ -0,0 +1,125 @@
+# Netlify Deployment Guide
+
+Deploy the Dev Workflow web dashboard to Netlify for a public-facing documentation and demo site.
+
+## Overview
+
+The web dashboard can be deployed to Netlify as a static Next.js application. This deployment mode provides:
+
+- **Static documentation pages** - Full access to the `/docs` section
+- **Demo interface** - Showcase the workflow features
+- **API endpoints** - Serverless functions for version and npm download stats
+
+> **Note:** Database features (history, summary) return placeholder data in this deployment mode. For full functionality with persistent data, use the [local development server](./web-dashboard.md) or [Plesk deployment](./PLESK_DEPLOYMENT.md).
+
+## Live Site
+
+The official deployment is available at:
+- **Primary:** https://devworkflow.programinglive.com
+- **Netlify:** https://devworkflow.netlify.app
+
+## Prerequisites
+
+- Netlify account (free tier works)
+- Node.js 18+ for local builds
+- Git repository connected to Netlify (optional, for auto-deploy)
+
+## Quick Deploy
+
+### Option 1: Netlify CLI
+
+```bash
+# Install Netlify CLI
+npm install -g netlify-cli
+
+# Login to Netlify
+netlify login
+
+# Navigate to web directory
+cd web
+
+# Create new site and deploy
+netlify sites:create --name your-site-name
+netlify deploy --prod --build
+```
+
+### Option 2: Netlify Dashboard
+
+1. Go to [app.netlify.com](https://app.netlify.com)
+2. Click "Add new site" > "Import an existing project"
+3. Connect your GitHub repository
+4. Configure build settings:
+   - **Base directory:** `web`
+   - **Build command:** `npm run build`
+   - **Publish directory:** `.next`
+5. Deploy
+
+## Configuration
+
+The `web/netlify.toml` file configures the build:
+
+```toml
+[build]
+  command = "npm run build"
+  publish = ".next"
+
+[[plugins]]
+  package = "@netlify/plugin-nextjs"
+```
+
+## Custom Domain Setup
+
+1. Go to your site's **Domain management** in Netlify
+2. Click **Add a domain**
+3. Enter your subdomain (e.g., `devworkflow.yourdomain.com`)
+4. Add a CNAME record in your DNS provider:
+   - **Host:** `devworkflow` (or your subdomain)
+   - **Value:** `your-site-name.netlify.app`
+5. Click **Provision certificate** for HTTPS
+
+## API Endpoints
+
+The following API routes are available as Netlify Functions:
+
+| Endpoint | Description |
+| --- | --- |
+| `/api/version` | Returns current package version |
+| `/api/npm-downloads` | Returns monthly npm download count |
+| `/api/summary` | Returns placeholder summary data |
+| `/api/history` | Returns placeholder history data |
+| `/api/docs` | Returns documentation content |
+
+## Limitations
+
+When deployed to Netlify (static mode):
+
+- **No persistent database** - History and summary return empty/placeholder data
+- **No real-time updates** - Data is static between deployments
+- **Version is build-time** - Update `web/app/api/version/route.ts` before each release
+
+## Updating the Deployment
+
+### Manual Redeploy
+
+```bash
+cd web
+netlify deploy --prod --build
+```
+
+### Auto-Deploy (Recommended)
+
+Connect your GitHub repository to Netlify for automatic deployments on push to main branch.
+
+## Troubleshooting
+
+| Issue | Solution |
+| --- | --- |
+| 404 on custom domain | Provision SSL certificate in Netlify dashboard |
+| Build fails | Ensure `web/package.json` has no native dependencies |
+| Functions timeout | Netlify has 10s limit; optimize API routes |
+
+## Related
+
+- [Web Dashboard Guide](./web-dashboard.md)
+- [Plesk Deployment](./PLESK_DEPLOYMENT.md)
+- [Main README](../README.md)