@sureshdsk/devflow-mcp 3.1.0 → 3.1.2

package/drizzle/meta/_journal.json

@@ -15,6 +15,20 @@
       "when": 1771834907179,
       "tag": "0001_mixed_genesis",
       "breakpoints": true
+    },
+    {
+      "idx": 2,
+      "version": "6",
+      "when": 1771835000000,
+      "tag": "0002_task_body_field",
+      "breakpoints": true
+    },
+    {
+      "idx": 3,
+      "version": "6",
+      "when": 1771835100000,
+      "tag": "0003_specs_table",
+      "breakpoints": true
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sureshdsk/devflow-mcp",
-  "version": "3.1.0",
+  "version": "3.1.2",
   "description": "Context-First Kanban for AI Agents - MCP server with web UI for managing AI agent workflows",
   "author": "DevFlow Team",
   "license": "MIT",
@@ -20,6 +20,8 @@
     "project-management"
   ],
   "packageManager": "pnpm@10.14.0",
+  "type": "commonjs",
+  "main": "./bin/devflow.js",
   "bin": {
     "devflow": "./bin/devflow.js",
     "devflow-mcp": "./bin/devflow.js"

package/scripts/init-db.js

@@ -17,6 +17,8 @@ const {
 
 const DB_DIR = path.join(os.homedir(), '.devflow');
 const DB_PATH = path.join(DB_DIR, 'devflow.db');
+// Always resolve migrations relative to the package, not process.cwd()
+const MIGRATIONS_FOLDER = path.join(__dirname, '..', 'drizzle');
 
 function parseInitArgs(args) {
   const options = {};
@@ -86,68 +88,35 @@ async function chooseSchemaTemplate(projectRoot, options) {
   };
 }
 
-async function initDatabase(options = {}) {
-  const projectRoot = process.cwd();
-  console.log('Initializing DevFlow database...');
-
-  // Ensure directory exists
-  try {
-    await fs.promises.mkdir(DB_DIR, { recursive: true });
-    console.log(`✓ Created directory: ${DB_DIR}`);
-  } catch (error) {
-    console.log(`✓ Directory already exists: ${DB_DIR}`);
+/**
+ * Validate that the migrations folder exists and has the required structure.
+ */
+function validateMigrationsFolder(folder) {
+  const journalPath = path.join(folder, 'meta', '_journal.json');
+  if (!fs.existsSync(folder)) {
+    throw new Error(
+      `Migrations folder not found at: ${folder}\n` +
+        'This usually means the package was not installed correctly.\n' +
+        'Try reinstalling: npm install -g @sureshdsk/devflow-mcp',
+    );
   }
-
-  // Create database connection
-  const client = createClient({
-    url: `file:${DB_PATH}`,
-  });
-
-  await client.execute('PRAGMA journal_mode = WAL');
-  await client.execute('PRAGMA foreign_keys = ON');
-
-  // If DB has old schema (features table), drop and recreate
-  const tables = await client.execute(
-    `SELECT name FROM sqlite_master WHERE type='table' AND name='features'`,
-  );
-  if (tables.rows.length > 0) {
-    console.log('⚠ Detected old schema (features table). Recreating database...');
-    client.close();
-    await fs.promises.unlink(DB_PATH);
-    const freshClient = createClient({ url: `file:${DB_PATH}` });
-    await freshClient.execute('PRAGMA journal_mode = WAL');
-    await freshClient.execute('PRAGMA foreign_keys = ON');
-    const freshDb = drizzle(freshClient);
-    console.log('Running migrations...');
-    await migrate(freshDb, { migrationsFolder: './drizzle' });
-    console.log('✓ Migrations complete');
-    const existingProjects = await freshClient.execute('SELECT id FROM projects LIMIT 1');
-    if (existingProjects.rows.length === 0) {
-      const id = randomUUID();
-      const now = Math.floor(Date.now() / 1000);
-      await freshClient.execute({
-        sql: `INSERT INTO projects (id, name, description, status, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)`,
-        args: [id, 'Default Project', 'Default project for tasks', 'active', now, now],
-      });
-      console.log('✓ Created default project');
-    }
-    const selected = await chooseSchemaTemplate(projectRoot, options);
-    console.log(`\n✓ Default schema template: ${selected.schemaId} (${selected.reason})`);
-    console.log(`✓ Saved project config: ${selected.configPath}`);
-    console.log(`\n✅ Database initialized at: ${DB_PATH}`);
-    console.log('\nYou can now:');
-    console.log('  1. Start the web UI: devflow dev');
-    console.log('  2. Start the MCP server: devflow mcp');
-    freshClient.close();
-    return;
+  if (!fs.existsSync(journalPath)) {
+    throw new Error(
+      `Migration journal not found at: ${journalPath}\n` +
+        'The drizzle/meta/_journal.json file is missing from the package.\n' +
+        'Try reinstalling: npm install -g @sureshdsk/devflow-mcp',
+    );
   }
+}
 
-  const db = drizzle(client);
-
-  // Run migrations
+/**
+ * Run migrations and create the default project if needed.
+ * Shared logic used by both fresh-db and existing-db paths.
+ */
+async function runMigrationsAndSeed(client, db) {
   console.log('Running migrations...');
   try {
-    await migrate(db, { migrationsFolder: './drizzle' });
+    await migrate(db, { migrationsFolder: MIGRATIONS_FOLDER });
   } catch (err) {
     if (err.message?.includes('already exists')) {
       console.log('✓ Schema already up to date');
@@ -163,28 +132,82 @@ async function initDatabase(options = {}) {
     const id = randomUUID();
     const now = Math.floor(Date.now() / 1000);
     await client.execute({
-      sql: `INSERT INTO projects (id, name, description, status, created_at, updated_at)
-            VALUES (?, ?, ?, ?, ?, ?)`,
+      sql: `INSERT INTO projects (id, name, description, status, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)`,
       args: [id, 'Default Project', 'Default project for tasks', 'active', now, now],
     });
     console.log('✓ Created default project');
   }
+}
 
-  const selected = await chooseSchemaTemplate(projectRoot, options);
+async function initDatabase(options = {}) {
+  const projectRoot = process.cwd();
+  console.log('Initializing DevFlow database...');
+
+  // Validate migrations folder before doing anything
+  validateMigrationsFolder(MIGRATIONS_FOLDER);
+
+  // Ensure directory exists
+  await fs.promises.mkdir(DB_DIR, { recursive: true });
+  console.log(`✓ Database directory: ${DB_DIR}`);
+
+  // Create database connection
+  const client = createClient({
+    url: `file:${DB_PATH}`,
+  });
+
+  try {
+    await client.execute('PRAGMA journal_mode = WAL');
+    await client.execute('PRAGMA foreign_keys = ON');
+
+    // If DB has old schema (features table), drop and recreate
+    const tables = await client.execute(
+      `SELECT name FROM sqlite_master WHERE type='table' AND name='features'`,
+    );
+    if (tables.rows.length > 0) {
+      console.log('⚠ Detected old schema (features table). Recreating database...');
+      client.close();
+      await fs.promises.unlink(DB_PATH);
+      const freshClient = createClient({ url: `file:${DB_PATH}` });
+      try {
+        await freshClient.execute('PRAGMA journal_mode = WAL');
+        await freshClient.execute('PRAGMA foreign_keys = ON');
+        const freshDb = drizzle(freshClient);
+        await runMigrationsAndSeed(freshClient, freshDb);
+        const selected = await chooseSchemaTemplate(projectRoot, options);
+        printSuccess(selected);
+      } finally {
+        freshClient.close();
+      }
+      return;
+    }
+
+    const db = drizzle(client);
+    await runMigrationsAndSeed(client, db);
+
+    const selected = await chooseSchemaTemplate(projectRoot, options);
+    printSuccess(selected);
+  } finally {
+    client.close();
+  }
+}
+
+function printSuccess(selected) {
   console.log(`\n✓ Default schema template: ${selected.schemaId} (${selected.reason})`);
   console.log(`✓ Saved project config: ${selected.configPath}`);
   console.log(`\n✅ Database initialized at: ${DB_PATH}`);
   console.log('\nYou can now:');
   console.log('  1. Start the web UI: devflow dev');
   console.log('  2. Start the MCP server: devflow mcp');
-
-  client.close();
 }
 
 if (require.main === module) {
   const options = parseInitArgs(process.argv.slice(2));
   initDatabase(options).catch((error) => {
-    console.error('Failed to initialize database:', error);
+    console.error('Failed to initialize database:', error.message || error);
+    console.error('\nTroubleshooting:');
+    console.error('  1. Try reinstalling: npm install -g @sureshdsk/devflow-mcp');
+    console.error('  2. Ensure ~/.devflow directory is writable');
+    console.error('  3. Report issues at: https://github.com/anthropics/devflow-mcp/issues');
     process.exit(1);
   });
 }

package/src/db/index.ts

@@ -1,9 +1,11 @@
 import { createClient } from '@libsql/client';
 import { drizzle } from 'drizzle-orm/libsql';
+import { migrate } from 'drizzle-orm/libsql/migrator';
 import * as schema from './schema';
-import { mkdirSync } from 'fs';
+import { mkdirSync, existsSync } from 'fs';
 import { join } from 'path';
 import { homedir } from 'os';
+import { randomUUID } from 'crypto';
 
 const DB_DIR = join(homedir(), '.devflow');
 const DB_PATH = join(DB_DIR, 'devflow.db');
@@ -17,7 +19,28 @@ function ensureDbDir() {
   }
 }
 
+/**
+ * Find the migrations folder. Works whether running from source (dev)
+ * or from the built dist/server output (production).
+ */
+function findMigrationsFolder(): string {
+  // Try common locations relative to this file
+  const candidates = [
+    join(__dirname, '..', '..', 'drizzle'), // from src/db/ or dist/server/
+    join(__dirname, '..', 'drizzle'), // from src/ or dist/
+    join(__dirname, 'drizzle'), // same dir
+  ];
+  for (const candidate of candidates) {
+    if (existsSync(join(candidate, 'meta', '_journal.json'))) {
+      return candidate;
+    }
+  }
+  // Fallback — return first candidate and let drizzle give a clear error
+  return candidates[0];
+}
+
 let dbInstance: ReturnType<typeof drizzle> | null = null;
+let migrationRan = false;
 
 export async function getDb() {
   if (dbInstance) return dbInstance;
@@ -33,6 +56,32 @@ export async function getDb() {
 
   dbInstance = drizzle(client, { schema });
 
+  // Auto-run migrations on first connection to ensure schema is up to date.
+  // This is a safety net for cases where postinstall didn't run.
+  if (!migrationRan) {
+    migrationRan = true;
+    try {
+      const migrationsFolder = findMigrationsFolder();
+      if (existsSync(join(migrationsFolder, 'meta', '_journal.json'))) {
+        await migrate(dbInstance, { migrationsFolder });
+
+        // Seed default project if needed
+        const rows = await client.execute('SELECT id FROM projects LIMIT 1');
+        if (rows.rows.length === 0) {
+          const id = randomUUID();
+          const now = Math.floor(Date.now() / 1000);
+          await client.execute({
+            sql: `INSERT INTO projects (id, name, description, status, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)`,
+            args: [id, 'Default Project', 'Default project for tasks', 'active', now, now],
+          });
+        }
+      }
+    } catch {
+      // Non-fatal: if migrations fail here, the explicit `devflow init` path
+      // will give the user a proper error message.
+    }
+  }
+
   return dbInstance;
 }