flowmo 0.1.0 → 0.2.0

package/README.md

@@ -35,17 +35,52 @@ npx flowmo db:setup
 
 Run this any time you change your schema.
 
-### `flowmo db:seed`
+### `flowmo db:seed [file …]`
 
-Reads `database/seeds.sql` and inserts dummy data.
+Inserts seed data into the local database. Accepts an optional list of seed files to run in order.
 
 ```bash
+# Auto-discover: loads database/seeds/ directory (alphabetical) or falls back to database/seeds.sql
 npx flowmo db:seed
+
+# Explicit list — executed in the order given
+npx flowmo db:seed database/seeds/01_users.sql database/seeds/02_products.sql
 ```
 
-### `flowmo db:query <file> [params-json]`
+**Seed file resolution (no args):**
+1. `database/seeds/` directory exists → all `.sql` files, alphabetical order
+2. `database/seeds.sql` → single file fallback
+
+Prefix files with numbers (`01_`, `02_`) to control load order when using the directory.
+
+### `flowmo db:reset [--seed [file …]]`
+
+Drops and recreates the schema (equivalent to `db:setup`), then optionally seeds.
+
+```bash
+# Recreate schema only
+npx flowmo db:reset
+
+# Recreate schema + auto-discover seeds
+npx flowmo db:reset --seed
+
+# Recreate schema + explicit seed list
+npx flowmo db:reset --seed database/seeds/01_users.sql database/seeds/02_products.sql
+```
+
+The `--seed` flag follows the same resolution rules as `db:seed` — files after `--seed` are used as-is; no files after `--seed` triggers auto-discovery.
+
+### `flowmo db:query <file|sql> [params-json]`
+
+Executes a `.sql` or `.advance.sql` file against the local database and prints results as an ASCII table. Alternatively, pass an inline SQL string directly — no file needed.
+
+**Inline SQL:**
+```bash
+npx flowmo db:query "SELECT * FROM users"
+npx flowmo db:query "SELECT COUNT(*) FROM orders WHERE is_active = 1"
+```
 
-Executes a `.sql` or `.advance.sql` file against the local database and prints results as an ASCII table.
+Inline mode is param-free. For parameterised queries, use a file.
 
 **Standard SQL:**
 ```bash
@@ -90,7 +125,8 @@ A scaffolded Flowmo project looks like this:
 my-prototype/
 ├── database/
 │   ├── schema.sql          # DDL — your single source of truth
-│   ├── seeds.sql           # Dummy data for UI prototyping
+│   ├── seeds.sql           # Dummy data (single file)
+│   ├── seeds/              # OR: split seeds by table (01_users.sql, 02_products.sql …)
 │   └── queries/            # .sql and .advance.sql files
 ├── logic/                  # .flowchart.md server action flows
 ├── screens/                # .visual.html UI prototypes

package/bin/flowmo.js

@@ -23,17 +23,23 @@ ${picocolors.bold('Usage:')}
   flowmo <command> [options]
 
 ${picocolors.bold('Commands:')}
-  ${picocolors.cyan('db:setup')}                          Reset and provision the local database from database/schema.sql
-  ${picocolors.cyan('db:seed')}                           Insert seed data from database/seeds.sql
-  ${picocolors.cyan('db:query')} <file> [params-json]     Execute a .sql or .advance.sql query file
-                                   ${picocolors.dim('--limit <n>')}  Max rows to show (default: 10)
-                                   ${picocolors.dim('--simple')}     Plain key: value output, no truncation
+  ${picocolors.cyan('db:setup')}                            Reset and provision the local database from database/schema.sql
+  ${picocolors.cyan('db:seed')} [file …]                    Seed from explicit file(s), database/seeds/ dir, or database/seeds.sql
+  ${picocolors.cyan('db:reset')} [--seed [file …]]          Alias for db:setup; add --seed to also run seeds
+  ${picocolors.cyan('db:query')} <file|sql> [params-json]   Execute a .sql/.advance.sql file or an inline SQL string
+                                     ${picocolors.dim('--limit <n>')}  Max rows to show (default: 10)
+                                     ${picocolors.dim('--simple')}     Plain key: value output, no truncation
 
 ${picocolors.bold('Examples:')}
   flowmo db:setup
   flowmo db:seed
+  flowmo db:seed database/seeds/01_users.sql database/seeds/02_products.sql
+  flowmo db:reset
+  flowmo db:reset --seed
+  flowmo db:reset --seed database/seeds/01_users.sql database/seeds/02_products.sql
   flowmo db:query database/queries/get_users.sql
   flowmo db:query database/queries/get_user.advance.sql '{"UserId": 1}'
+  flowmo db:query "SELECT * FROM users"
   flowmo db:query database/queries/get_users.sql --limit 25
   flowmo db:query database/queries/get_users.sql --simple
 `;
@@ -46,11 +52,13 @@ async function run() {
 
   const { dbSetup } = await import('../src/commands/db-setup.js');
   const { dbSeed } = await import('../src/commands/db-seed.js');
+  const { dbReset } = await import('../src/commands/db-reset.js');
   const { dbQuery } = await import('../src/commands/db-query.js');
 
   const commands = {
     'db:setup': () => dbSetup(),
-    'db:seed': () => dbSeed(),
+    'db:seed': () => dbSeed(args),
+    'db:reset': () => dbReset(args),
     // Join all args after the file path in case the shell splits the JSON string.
     'db:query': () => dbQuery(args),
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flowmo",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Local, zero-infrastructure prototyping engine for OutSystems-Lite workflows",
   "type": "module",
   "license": "MIT",

package/src/commands/db-query.js

@@ -66,13 +66,25 @@ export async function dbQuery(rawArgs = []) {
     }
   }
 
-  const filePath = positional[0];
-  const paramsJson = positional.length > 1 ? positional.slice(1).join(' ') : undefined;
+  if (positional.length === 0) {
+    throw new Error('Usage: flowmo db:query <file.sql> [params-json]\n       flowmo db:query "SELECT …" (inline SQL, no params)');
+  }
 
-  if (!filePath) {
-    throw new Error('Usage: flowmo db:query <file> [params-json] [--limit <n>] [--simple]');
+  // Inline SQL mode: first positional arg does not end with .sql.
+  const looksLikeFile = positional[0].endsWith('.sql');
+  if (!looksLikeFile) {
+    const inlineSql = positional.join(' ');
+    console.log(picocolors.dim(`Query: ${inlineSql}\n`));
+    const db = await getDb();
+    const result = await db.query(inlineSql, []);
+    await closeDb();
+    renderTable(result.fields, result.rows, { simple, limit });
+    return;
   }
 
+  const filePath = positional[0];
+  const paramsJson = positional.length > 1 ? positional.slice(1).join(' ') : undefined;
+
   const resolved = path.resolve(process.cwd(), filePath);
 
   if (!fs.existsSync(resolved)) {

package/src/commands/db-reset.js

@@ -0,0 +1,19 @@
+import picocolors from 'picocolors';
+import { dbSetup } from './db-setup.js';
+import { dbSeed } from './db-seed.js';
+
+export async function dbReset(args = []) {
+  const seedIdx = args.indexOf('--seed');
+  const hasSeed = seedIdx !== -1;
+  // Everything after --seed is the explicit file list (empty = auto-discover).
+  const seedFiles = hasSeed ? args.slice(seedIdx + 1) : [];
+
+  await dbSetup();
+
+  if (hasSeed) {
+    console.log('');
+    await dbSeed(seedFiles);
+  } else {
+    console.log(picocolors.dim('\nTip: run with --seed to also seed the database.'));
+  }
+}

package/src/commands/db-seed.js

@@ -3,35 +3,75 @@ import path from 'path';
 import picocolors from 'picocolors';
 import { getDb, closeDb } from '../lib/db.js';
 
-function resolveFile(filename) {
-  const candidates = [
-    path.join(process.cwd(), 'database', filename),
-    path.join(process.cwd(), filename),
-  ];
-  return candidates.find((p) => fs.existsSync(p)) ?? null;
-}
+/**
+ * Resolve seed files to execute, in order.
+ *
+ * Resolution tiers:
+ *   1. Explicit list (args provided) — resolved relative to <cwd>/database/ then <cwd>/
+ *   2. Auto-discover database/seeds/ directory — all .sql files alphabetically
+ *   3. Fallback to database/seeds.sql or ./seeds.sql
+ */
+function resolveSeedFiles(args) {
+  // 1. Explicit list.
+  if (args && args.length > 0) {
+    return args.map((f) => {
+      const candidates = [
+        path.join(process.cwd(), 'database', f),
+        path.join(process.cwd(), f),
+        path.resolve(f),
+      ];
+      const found = candidates.find((p) => fs.existsSync(p));
+      if (!found) {
+        throw new Error(`Seed file not found: ${f}`);
+      }
+      return found;
+    });
+  }
 
-export async function dbSeed() {
-  const seedsPath = resolveFile('seeds.sql');
+  // 2. Auto-discover seeds/ directory.
+  const seedsDir = path.join(process.cwd(), 'database', 'seeds');
+  if (fs.existsSync(seedsDir) && fs.statSync(seedsDir).isDirectory()) {
+    const files = fs.readdirSync(seedsDir)
+      .filter((f) => f.endsWith('.sql'))
+      .sort()
+      .map((f) => path.join(seedsDir, f));
+    if (files.length > 0) return files;
+  }
 
-  if (!seedsPath) {
+  // 3. Fallback: single seeds.sql.
+  const candidates = [
+    path.join(process.cwd(), 'database', 'seeds.sql'),
+    path.join(process.cwd(), 'seeds.sql'),
+  ];
+  const found = candidates.find((p) => fs.existsSync(p));
+  if (!found) {
     throw new Error(
-      'seeds.sql not found. Looked in database/seeds.sql and ./seeds.sql.\nAre you in a Flowmo project directory?'
+      'No seed files found. Looked for database/seeds/, database/seeds.sql, and ./seeds.sql.\nAre you in a Flowmo project directory?'
     );
   }
+  return [found];
+}
 
-  const seeds = fs.readFileSync(seedsPath, 'utf-8').trim();
-
-  if (!seeds) {
-    throw new Error(`${seedsPath} is empty. Add your INSERT statements first.`);
-  }
+export async function dbSeed(files = []) {
+  const seedPaths = resolveSeedFiles(files);
 
   console.log(picocolors.cyan('Seeding database…'));
-  console.log(picocolors.dim(`Using: ${seedsPath}`));
 
   const db = await getDb();
-  await db.exec(seeds);
+
+  for (const seedsPath of seedPaths) {
+    const seeds = fs.readFileSync(seedsPath, 'utf-8').trim();
+
+    if (!seeds) {
+      throw new Error(`${seedsPath} is empty. Add your INSERT statements first.`);
+    }
+
+    console.log(picocolors.dim(`Running: ${seedsPath}`));
+    await db.exec(seeds);
+    console.log(picocolors.green(`✓ ${path.basename(seedsPath)}`));
+  }
+
   await closeDb();
 
-  console.log(picocolors.green(`✓ Database seeded from ${seedsPath}`));
+  console.log(picocolors.green(`\n✓ Database seeded (${seedPaths.length} file${seedPaths.length === 1 ? '' : 's'})`));
 }