@programinglive/dev-workflow-mcp-server 1.7.0 → 1.7.9

package/db/index.js

@@ -1,204 +1,73 @@
-import Database from "better-sqlite3";
-import { existsSync } from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
+import { SqliteAdapter } from "./adapters/sqlite.js";
+import { MysqlAdapter } from "./adapters/mysql.js";
+import { PostgresAdapter } from "./adapters/postgres.js";
 
-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",
-};
+let adapterInstance = null;
 
-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);
+export async function getAdapter() {
+  if (adapterInstance) {
+    return adapterInstance;
   }
-  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();
+  const type = (process.env.DEV_WORKFLOW_DB_TYPE || "sqlite").toLowerCase();
+  const config = {
+    connectionUrl: process.env.DEV_WORKFLOW_DB_URL,
+    dbPath: process.env.DEV_WORKFLOW_DB_PATH // optional override for sqlite
+  };
+
+  switch (type) {
+    case "mysql":
+      adapterInstance = new MysqlAdapter(config);
+      break;
+    case "postgres":
+    case "postgresql":
+      adapterInstance = new PostgresAdapter(config);
+      break;
+    case "sqlite":
+    default:
+      adapterInstance = new SqliteAdapter(config);
+      break;
   }
-  return db;
+
+  await adapterInstance.connect();
+  return adapterInstance;
 }
 
-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)`;
+// Proxies for backward compatibility (though call sites need to handle Promises now)
 
-  db.exec(createHistory);
-  db.exec(createSummary);
-  db.exec(idxHistory);
-  db.exec(idxSummary);
+export async function insertHistoryEntry(userId, projectPath, entry) {
+  const db = await getAdapter();
+  await db.insertHistoryEntry(userId, projectPath, entry);
 }
 
-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 async function updateSummaryForUser(userId, projectPath) {
+  const db = await getAdapter();
+  await db.updateSummaryForUser(userId, projectPath);
 }
 
-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 async function getSummaryForUser(userId, projectPath) {
+  const db = await getAdapter();
+  return await db.getSummaryForUser(userId, projectPath);
 }
 
-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,
-  };
+export async function getHistoryForUser(userId, projectPath, options) {
+  const db = await getAdapter();
+  return await db.getHistoryForUser(userId, projectPath, options);
 }
 
-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 async function getHistorySummary(userId, projectPath, options) {
+  const db = await getAdapter();
+  return await db.getHistorySummary(userId, projectPath, options);
 }
 
-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 async function saveState(userId, projectPath, state) {
+  const db = await getAdapter();
+  await db.saveState(userId, projectPath, state);
 }
 
-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 }));
+export async function getState(userId, projectPath) {
+  const db = await getAdapter();
+  return await db.getState(userId, projectPath);
 }
+
+

package/docs/product/PRD.md

@@ -3,8 +3,8 @@
 ## 1. Overview
 - **Product**: Development Workflow MCP Server
 - **Prepared by**: Cascade (AI assistant)
-- **Date**: 2025-10-31
-- **Status**: Draft v0.1
+- **Date**: 2025-12-16
+- **Status**: Live v1.6+
 
 ## 2. Problem Statement
 Developers need structured guidance to maintain disciplined workflows across projects. Existing tooling lacks enforcement of sequential best practices (testing, documentation, release hygiene) and offers limited visibility into historical task execution.
@@ -13,6 +13,7 @@ Developers need structured guidance to maintain disciplined workflows across pro
 1. Enforce a consistent, auditable development workflow across teams.
 2. Provide actionable guidance for each workflow phase within IDE-integrated environments.
 3. Maintain per-project, per-user workflow state while supporting shared infrastructure (e.g., SQLite summaries, dashboard).
+4. **Support flexible data persistence**: Enable usage of various database backends (MySQL, PostgreSQL, SQLite) to adapt to different hosting and enterprise environments.
 
 ## 4. Non-Goals
 - Replacing full-featured project management tools.
@@ -28,19 +29,24 @@ Developers need structured guidance to maintain disciplined workflows across pro
 1. As a developer, I want to be guided through the workflow steps so I can avoid skipping critical tasks.
 2. As a team lead, I want an auditable history of workflow completion so I can ensure compliance.
 3. As an integrator, I want a simple API (tools/prompts) so I can plug the MCP server into existing agent workflows.
+4. As a devops engineer, I want to configure the server to use my existing database infrastructure (MySQL/PostgreSQL) instead of local files.
 
 ## 7. Functional Requirements
 - Provide MCP tools covering the full workflow lifecycle (start task, fix, test, document, commit, release, complete).
 - Persist workflow state per project and per user, with compatibility handling for legacy locations.
-- Offer aggregated project summaries (JSON artifacts, SQLite sync, optional web dashboard).
+- Offer aggregated project summaries (JSON artifacts, Database sync, optional web dashboard).
 - Guard release commands to ensure prerequisites are satisfied.
 - Support `run_full_workflow` for scripted execution of all steps with validation.
 - Web dashboard displays version dynamically from `package.json` via `/api/version` endpoint to stay in sync after releases.
+- **Multi-Database Support**: Abstract the storage layer to support:
+    - SQLite (default/local)
+    - MySQL
+    - PostgreSQL
 
 ## 8. Technical Considerations
 - Node.js (ESM) codebase leveraging `@modelcontextprotocol/sdk`.
 - File-based state stored under `.state/users/<user>/workflow-state.json` with compatibility symlinks.
-- Optional SQLite integration for history and summary caching.
+- **Database Abstraction**: Implement an Adapter/Repository pattern or use an ORM (e.g., Knex, Prisma, Drizzle) to support multiple SQL dialects.
 - Vite build pipeline for distribution bundle; source usage recommended for MCP.
 - Windows compatibility requirements (Python, Build Tools for native modules).
 - **Deployment options**: Local development, Netlify (static), Plesk (full-featured).
@@ -49,17 +55,21 @@ Developers need structured guidance to maintain disciplined workflows across pro
 - ≥90% of workflow operations executed via MCP tools (vs. manual overrides).
 - Reduction in release guard violations to <5% of attempts.
 - Positive qualitative feedback on guidance clarity from pilot teams.
+- Seamless switching between SQLite, MySQL, and PostgreSQL via configuration.
 
 ## 10. Milestones
 1. **MVP**: Core workflow tools, state persistence, basic history (complete).
 2. **Enhancements**: Improved project root detection, compatibility mirrors, `run_full_workflow` automation (complete).
 3. **v1.5.0**: Netlify deployment support for static web dashboard (complete).
-4. **Future**: Expanded dashboard analytics, customizable workflows, richer integrations.
+4. **v1.6.0+**: Dark/Light mode, UI Improvements (complete).
+5. **Multi-Database Support**: Refactor storage layer to support MySQL and PostgreSQL (Upcoming).
+6. **Future**: Expanded dashboard analytics, customizable workflows, richer integrations.
 
 ## 11. Risks & Mitigations
 - **Risk**: Workflow feels overly prescriptive. **Mitigation**: Provide escape hatches (`force_complete_task`, `drop_task`) with audit trails.
 - **Risk**: State corruption due to concurrent access. **Mitigation**: File locking and defensive JSON parsing (existing code handles gracefully, but monitor).
 - **Risk**: Integration friction with IDE clients. **Mitigation**: Maintain detailed README instructions and example configurations.
+- **Risk**: Complicated setup for users not needing external DBs. **Mitigation**: Keep SQLite/File-system as the default zero-config option.
 
 ## 12. Open Questions
 - Should additional workflow phases (e.g., design review) be supported?

package/docs/release-notes/RELEASE_NOTES.md

@@ -2,6 +2,135 @@
 
 Authoritative history of user-visible changes for the Development Workflow MCP Server. Each entry highlights the improvements that shipped with the tagged version.
 
+| Version | Date | Notes |
+|---------|------|-------|
+| 1.7.8 | 2025-12-16 | **ci:** remove all token config for pure OIDC publishing (d4759cc) |
+| 1.7.7 | 2025-12-16 | **ci:** remove duplicates and apply robust trusted publishing config (eedb661) |
+| 1.7.6 | 2025-12-16 | **ci:** restore registry config with token fallback for Trusted Publishing (542615c) |
+| 1.7.5 | 2025-12-16 | **ci:** switch to tokenless trusted publishing (fdfc4a9) |
+| 1.7.4 | 2025-12-16 | **ci:** add id-token permission for npm provenance (8930338) |
+| 1.7.3 | 2025-12-16 | **ci:** add web dependencies installation step (7d5dc62) |
+| 1.7.2 | 2025-12-16 | **ci:** consolidate release and publish workflows (98e5b31) |
+| 1.7.1 | 2025-12-16 | build errors and warnings (dc24831) |
+| 1.7.0 | 2025-12-16 | See CHANGELOG for details. |
+| 1.6.3 | 2025-12-06 | update release notes for 1.6.2 (f0c2d49) |
+| 1.6.2 | 2025-12-06 | update release notest for 1.6.1 (72a9284) |
+| 1.6.1 | 2025-12-06 | add table header to release notes for release script compatibility (44e47fc) |
+
+
+
+
+
+
+
+
+
+
+
+
+
+## 1.7.8 – 🐛 Bug Fixes
+
+Released on **2025-12-16**.
+
+- **ci:** remove all token config for pure OIDC publishing (d4759cc)
+
+## 1.7.7 – 🐛 Bug Fixes
+
+Released on **2025-12-16**.
+
+- **ci:** remove duplicates and apply robust trusted publishing config (eedb661)
+
+## 1.7.6 – 🐛 Bug Fixes
+
+Released on **2025-12-16**.
+
+- **ci:** restore registry config with token fallback for Trusted Publishing (542615c)
+
+## 1.7.5 – 🐛 Bug Fixes
+
+Released on **2025-12-16**.
+
+- **ci:** switch to tokenless trusted publishing (fdfc4a9)
+
+## 1.7.4 – 🐛 Bug Fixes
+
+Released on **2025-12-16**.
+
+- **ci:** add id-token permission for npm provenance (8930338)
+
+## 1.7.3 – 🐛 Bug Fixes
+
+Released on **2025-12-16**.
+
+- **ci:** add web dependencies installation step (7d5dc62)
+
+## 1.7.2 – 🐛 Bug Fixes
+
+Released on **2025-12-16**.
+
+- **ci:** consolidate release and publish workflows (98e5b31)
+
+## 1.7.1 – 🐛 Bug Fixes
+
+Released on **2025-12-16**.
+
+- build errors and warnings (dc24831)
+- suppress remaining build warnings (f7d9b2d)
+- handle null CustPL in birthday-customers.blade.php (ERP-19) (71b8f7e)
+- integrate database adapters into workflow state (370cbb4)
+- update PRD and add configuration guide (1dfccf5)
+- update release notes for 1.6.3 (afb9fb9)
+- add mysql2 and pg dependencies (94423d7)
+- **release:** null 🚀 (93a17e2)
+- **release:** null 🚀 (033097e)
+- **release:** null 🚀 (91c800a)
+- **release:** null 🚀 (f0958c4)
+- **release:** null 🚀 (ac3cc6e)
+- **release:** null 🚀 (f3f9a00)
+- **release:** null 🚀 (bcf7d95)
+- **release:** null 🚀 (74df6d6)
+- **release:** null 🚀 (0d9dc4d)
+- **release:** null 🚀 (9667012)
+- **release:** null 🚀 (db25d0c)
+- **release:** null 🚀 (50d5353)
+- **release:** null 🚀 (ee0a540)
+- **release:** null 🚀 (92558af)
+- **release:** null 🚀 (cd851ac)
+- **release:** null 🚀 (49ec562)
+- **release:** null 🚀 (bcc7a3c)
+- implement database adapters for sqlite, mysql, postgres (8e7416a)
+- persist active workflow state to database (d29546d)
+
+## 1.7.0
+
+Released on **2025-12-16**.
+
+- See CHANGELOG for details.
+
+## 1.6.3 – 📝 Documentation
+
+Released on **2025-12-06**.
+
+- update release notes for 1.6.2 (f0c2d49)
+- add light mode support to docs page (490cf22)
+
+## 1.6.2 – 📝 Documentation
+
+Released on **2025-12-06**.
+
+- update release notest for 1.6.1 (72a9284)
+- update create_documentation test to verify PRD check and remove incompatible jest test (a7f2b28)
+- add PRD file existence check to create_documentation workflow step (62cdee3)
+- add PRD file existence check to create_documentation workflow step (6c51012)
+
+## 1.6.1 – 🐛 Bug Fixes
+
+Released on **2025-12-06**.
+
+- add table header to release notes for release script compatibility (44e47fc)
+- add responsive vertical monitor support and dark/light mode toggle (5565765)
+
 ## Unreleased
 
 ## 1.5.11 — 2025-12-05

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@programinglive/dev-workflow-mcp-server",
-  "version": "1.7.0",
+  "version": "1.7.9",
   "description": "MCP server to enforce development workflow discipline",
   "homepage": "https://devworkflow.programinglive.com/",
   "mcpName": "io.github.programinglive/dev-workflow-mcp-server",
@@ -25,7 +25,8 @@
     "release:major": "node scripts/release.cjs major",
     "release:minor": "node scripts/release.cjs minor",
     "release:patch": "node scripts/release.cjs patch",
-    "web": "npm start --prefix web"
+    "web": "npm start --prefix web",
+    "release:first": "node scripts/release.cjs --first-release"
   },
   "keywords": [
     "mcp",
@@ -45,6 +46,8 @@
     "esbuild": "^0.25.0",
     "get-port": "^7.1.0",
     "marked": "^12.0.2",
+    "mysql2": "^3.15.3",
+    "pg": "^8.16.3",
     "vite": "^7.1.12"
   },
   "publishConfig": {
@@ -53,7 +56,7 @@
   "devDependencies": {
     "@commitlint/cli": "^20.2.0",
     "@commitlint/config-conventional": "^20.2.0",
-    "@programinglive/commiter": "^1.2.8",
+    "@programinglive/commiter": "^1.2.16",
     "autoprefixer": "^10.4.22",
     "husky": "^9.1.7",
     "postcss": "^8.5.6",

package/scripts/release.cjs

@@ -26,18 +26,18 @@ const SEMVER_REGEX = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/;
 const LOCKFILE_PREFERENCES = [
   { manager: 'pnpm', file: 'pnpm-lock.yaml' },
   { manager: 'yarn', file: 'yarn.lock' },
-  { manager: 'bun', file: 'bun.lockb' },
+  { manager: 'bun', file: 'bun.lock' },
   { manager: 'npm', file: 'package-lock.json' }
 ];
 
 function getCliArguments(argv = process.argv) {
   const rawArgs = argv.slice(2);
   if (rawArgs.length === 0) {
-    return { releaseType: undefined, extraArgs: [] };
+    return { releaseType: 'patch', extraArgs: [] };
   }
 
   if (rawArgs[0].startsWith('-')) {
-    return { releaseType: undefined, extraArgs: rawArgs };
+    return { releaseType: 'patch', extraArgs: rawArgs };
   }
 
   const [firstArg, ...rest] = rawArgs;
@@ -60,7 +60,14 @@ function getNpmRunArgument(env = process.env) {
 
 function buildStandardVersionArgs({ releaseType, extraArgs }) {
   const args = [];
-  if (releaseType) {
+  
+  // Handle --first-release flag
+  const isFirstRelease = Array.isArray(extraArgs) && extraArgs.includes('--first-release');
+  if (isFirstRelease) {
+    args.push('--release-as', '0.0.1');
+    // Remove --first-release from extraArgs to avoid passing it to standard-version
+    extraArgs = extraArgs.filter(arg => arg !== '--first-release');
+  } else if (releaseType) {
     const normalized = releaseType.trim();
     const isValid = VALID_RELEASE_TYPES.has(normalized) || SEMVER_REGEX.test(normalized);
     if (!isValid) {

package/tests/handlers.test.js

@@ -79,7 +79,7 @@ test("run_tests guidance mentions core documentation types", async () => {
   });
 });
 
-test("create_documentation accepts PRD and records created/updated message", async () => {
+test("create_documentation verifies PRD file exists", async () => {
   await withWorkflowState(async (workflowState) => {
     workflowState.state.testsPassed = true;
     await workflowState.save();
@@ -105,6 +105,7 @@ test("create_documentation accepts PRD and records created/updated message", asy
       utils,
     });
 
+    // Should succeed since PRD.md exists in the project
     assert.equal(workflowState.state.documentationCreated, true);
     assert.equal(workflowState.state.documentationType, "PRD");
     assert.equal(
@@ -115,6 +116,10 @@ test("create_documentation accepts PRD and records created/updated message", asy
       response.content[0].text.includes("Documentation created/updated!"),
       "create_documentation response should mention created/updated",
     );
+    assert.ok(
+      response.content[0].text.includes("PRD verified"),
+      "create_documentation response should verify PRD file",
+    );
   });
 });
 

package/tools/handlers.js

@@ -23,7 +23,7 @@ async function resetToCommitIfWorkingChanges(workflowState, git) {
 
   const hasWorkingChanges = await git.hasWorkingChanges();
   const hasStagedChanges = await git.hasStagedChanges();
-  
+
   if (!hasWorkingChanges && !hasStagedChanges) {
     return false;
   }
@@ -105,9 +105,8 @@ function getContinueGuidance(status) {
         : "Run your automated tests and record the outcome with 'run_tests'. Fix any failures before moving forward.";
     case "documentation":
       return status.testsSkipped
-        ? `Document the change (including manual QA for skipped tests) with 'create_documentation'. Reason recorded: ${
-            status.testsSkippedReason || "(none provided)"
-          }.`
+        ? `Document the change (including manual QA for skipped tests) with 'create_documentation'. Reason recorded: ${status.testsSkippedReason || "(none provided)"
+        }.`
         : "Capture your updates with 'create_documentation' (provide the documentation type and a short summary).";
     case "ready":
       return "Run 'check_ready_to_commit' to verify all prerequisite steps before committing.";
@@ -355,6 +354,16 @@ async function handleCreateDocumentation(args, workflowState) {
     return textResponse("⚠️ Please ensure tests are passing first! Run 'run_tests' with passed=true.");
   }
 
+  // Check if PRD exists in docs folder
+  const prdPath = path.join(__dirname, "..", "docs", "product", "PRD.md");
+  const prdExists = existsSync(prdPath);
+
+  if (!prdExists) {
+    return textResponse(
+      `⚠️ PRD file not found!\n\nExpected location: docs/product/PRD.md\n\nPlease create or update the PRD before marking documentation as complete.`
+    );
+  }
+
   workflowState.state.documentationCreated = true;
   workflowState.state.documentationType = args.documentationType;
   workflowState.state.documentationSummary = args.summary;
@@ -368,7 +377,7 @@ async function handleCreateDocumentation(args, workflowState) {
   await workflowState.save();
 
   return textResponse(
-    `✅ Documentation created/updated!\n\nType: ${args.documentationType}\nSummary: ${args.summary}\n\n🎉 You're ready to verify your work!\n\nNext Steps:\n1. ✓ Fix/implement feature\n2. ✓ Create tests\n3. ✓ Run tests (GREEN!)\n4. ✓ Create/update documentation\n5. ⏳ Run 'check_ready_to_commit' to verify\n6. ⏳ Run 'commit_and_push'\n7. ⏳ Run 'perform_release'\n8. ⏳ Mark as complete with 'complete_task'`
+    `✅ Documentation created/updated!\n\nType: ${args.documentationType}\nSummary: ${args.summary}\n✅ PRD verified: docs/product/PRD.md exists\n\n🎉 You're ready to verify your work!\n\nNext Steps:\n1. ✓ Fix/implement feature\n2. ✓ Create tests\n3. ✓ Run tests (GREEN!)\n4. ✓ Create/update documentation\n5. ⏳ Run 'check_ready_to_commit' to verify\n6. ⏳ Run 'commit_and_push'\n7. ⏳ Run 'perform_release'\n8. ⏳ Mark as complete with 'complete_task'`
   );
 }
 
@@ -443,8 +452,7 @@ async function handleCommitAndPush(args, context) {
     await workflowState.save();
 
     return textResponse(
-      `ℹ️ No changes detected. Assuming commit and push already completed.\nLast commit: ${
-        effectiveCommitMessage || "(unavailable)"
+      `ℹ️ No changes detected. Assuming commit and push already completed.\nLast commit: ${effectiveCommitMessage || "(unavailable)"
       }\n\nNext: Run 'perform_release' to handle the release and push tags.`
     );
   }
@@ -510,8 +518,7 @@ async function handleCommitAndPush(args, context) {
   await workflowState.save();
 
   return textResponse(
-    `✅ Commit and push completed!\n\nCommit message: ${generatedSummary}\nPushed to: ${
-      branchForPush || "(default upstream)"
+    `✅ Commit and push completed!\n\nCommit message: ${generatedSummary}\nPushed to: ${branchForPush || "(default upstream)"
     }\n\nNext: Run 'perform_release' to handle the release and push tags.`
   );
 }
@@ -772,7 +779,11 @@ async function handleProjectSummaryData(workflowState) {
 async function handleProjectSummaryDb(workflowState) {
   const { getSummaryForUser } = await import("../db/index.js");
   const userId = process.env.DEV_WORKFLOW_USER_ID || "default";
-  const summary = getSummaryForUser(userId);
+
+  // Calculate project root from state file path: <root>/.state/users/<user>/workflow-state.json
+  const projectPath = path.dirname(path.dirname(path.dirname(path.dirname(workflowState.stateFile))));
+
+  const summary = await getSummaryForUser(userId, projectPath);
   if (!summary) {
     return textResponse("📜 No project summary in database yet.");
   }
@@ -791,7 +802,7 @@ async function handleRerunWorkflow(workflowState) {
 
   // Reset all progress flags but preserve history
   workflowState.reset();
-  
+
   // Restore task context after reset
   workflowState.state.currentPhase = "coding";
   workflowState.state.taskDescription = currentDescription;

package/vite.config.js

@@ -34,6 +34,14 @@ export default defineConfig({
         'os',
         'process',
         'child_process',
+        'events',
+        'net',
+        'tls',
+        'timers',
+        'stream',
+        'crypto',
+        'zlib',
+        'dns',
       ],
     },
   },