@flowdevcli/flowdev 1.0.4 → 1.0.5

package/.env.example

@@ -3,3 +3,4 @@
 
 OLLAMA_MODEL=
 
+

package/Dockerfile

@@ -1,14 +1,14 @@
 # Stage 1: Build
-FROM node:18-alpine AS builder
+FROM node:28-alpine AS builder
 WORKDIR /app
 COPY package*.json ./
 RUN npm ci
 COPY . .
 
 # Stage 2: Production
-FROM node:18-alpine
+FROM node:28-alpine
 WORKDIR /app
 COPY --from=builder /app ./
 EXPOSE 3000
 # Formats the command string into a JSON array for CMD
-CMD ["npm", "run", "dev"]
+CMD ["npm", "start"]

package/README.md

@@ -0,0 +1,157 @@
+FLOWDEV
+=======
+The intelligent CLI for modern workflow automation.
+
+FlowDev is a privacy-first, offline-capable CLI tool designed to accelerate developer workflows. From scaffolding Docker environments to generating project structures using local or cloud AI, FlowDev keeps you in the flow without leaving your terminal.
+
+> "The developer tool for the next generation."
+
+[![npm version](https://img.shields.io/npm/v/flowdev.svg?style=flat-square)](https://www.npmjs.com/package/flowdev)
+[![install size](https://img.shields.io/badge/install%20size-unknown-blue?style=flat-square)](https://packagephobia.com/result?p=flowdev)
+[![downloads](https://img.shields.io/npm/dm/flowdev.svg?style=flat-square)](https://www.npmjs.com/package/flowdev)
+
+Install
+=======
+
+Global Installation (Recommended)
+---------------------------------
+To use FlowDev commands anywhere on your system:
+
+```bash
+npm install -g flowdev
+
+Local Installation
+
+If you prefer to use it per project:
+Bash
+
+npm install flowdev --save-dev
+
+Usage
+
+Once installed, FlowDev exposes the flowdev binary.
+
+    Check your installation:
+
+Bash
+flowdev --version
+
+    *Configure your environment (API keys & Models):
+Bash
+flowdev config
+
+
+    *Analyze your current project:
+Bash
+flowdev stats
+
+    *Generate a Docker environment:
+Bash
+flowdev dockerize
+
+Features
+AI & Automation (Hybrid Engine)
+
+FlowDev integrates with Ollama for offline capabilities and supports DeepSeek for high-performance cloud reasoning.
+
+1. Smart Assistant
+Ask questions about code or architecture using local or cloud models.
+Bash
+
+flowdev ask "How do I optimize a React useEffect hook?"
+
+2. Intelligent Audit
+Audit your code for bugs, security, and performance using AI.
+Bash
+
+flowdev audit
+
+3. Automatic Documentation
+Generate a professional README.md for your project instantly.
+Bash
+
+flowdev readme
+
+DevOps & Infrastructure
+
+1. Dockerize
+Instantly generate production-ready Dockerfile and docker-compose.yml files.
+Bash
+
+flowdev dockerize
+
+2. Kubernetes (Kube)
+Generate Kubernetes deployment and service manifests for your application.
+Bash
+
+flowdev kube
+
+Utilities
+
+1. Generate
+Generate a complete project (React, Django, Vue, Angular, Express) with Git and dependencies automatically configured.
+Bash
+
+flowdev generate
+
+2. Find (Pattern Search)
+A recursive search tool optimized for developers. Ignores node_modules and binaries.
+Bash
+
+flowdev find "TODO" --ext js,ts
+
+3. Stats
+Get an instant breakdown of your project's size, file count, and language distribution.
+Bash
+
+flowdev stats
+
+Requirements
+Node.js
+
+FlowDev requires Node.js v18+.
+Local AI (Optional)
+
+To use local AI features, you must have Ollama running locally.
+
+    Install Ollama: ollama.com
+
+    Start the service: ollama serve
+
+    FlowDev handles the rest.
+
+Cloud AI (Optional)
+
+To use Cloud features (DeepSeek), configure your API key via flowdev config.
+Documentation
+flowdev generate
+
+Provisions full-stack templates. Includes a fail-safe execution wrapper that generates a flowdev-debug.log if an installation fails.
+flowdev audit
+
+Uses AI to scan for security vulnerabilities and logic flaws. Perfect for pre-commit checks.
+flowdev dockerize
+
+Generates optimized configurations using multi-stage builds and non-root security practices.
+flowdev env
+
+Scans your project code and generates a .env.example file based on your environment variable usage.
+FAQ
+Does FlowDev send my code to the cloud?
+
+By default, No. Local AI processing happens on your machine via Ollama. Cloud processing is only used if you explicitly configure it and choose a cloud model.
+Do I need an API Key?
+
+No for local use. Yes if you wish to use cloud models like DeepSeek.
+Why "flowdev"?
+
+Because switching contexts breaks your flow. FlowDev keeps you in the terminal, automating the boring stuff so you can focus on the code.
+Changelog
+
+See CHANGELOG.md for details on recent updates.
+License
+
+[MIT](https://www.google.com/search?q=LICENSE)
+
+
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowdevcli/flowdev",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "AI-powered CLI tool",
   "type": "module",
   "bin": {
@@ -26,12 +26,13 @@
     "boxen": "^7.1.1",
     "chalk": "^5.3.0",
     "commander": "^11.1.0",
+    "conf": "^15.1.0",
     "dotenv": "^16.3.1",
     "execa": "^8.0.1",
     "figlet": "^1.7.0",
     "fs-extra": "^11.1.1",
     "gradient-string": "^2.0.2",
-    "inquirer": "^9.2.11",
+    "inquirer": "^9.3.8",
     "is-binary-path": "^3.0.0",
     "mammoth": "^1.11.0",
     "ollama": "^0.6.3",
@@ -46,4 +47,4 @@
   "publishConfig": {
     "access": "public"
   }
-}
+}

package/src/commands/ai/ask.js

@@ -1,94 +1,27 @@
-import ollama from 'ollama';
+/**
+ * @fileoverview FlowDev  -  Intelligent CLI tool
+ * @module flowdev
+ * @version 1.0.5
+ * * @license MIT
+ * Copyright (c) 2026 FlowDev Technologies.
+ * * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+ */
+
 import chalk from 'chalk';
 import ora from 'ora';
 import fs from 'fs-extra';
-import { exec, spawn } from 'node:child_process';
-import { promisify } from 'util';
 import { logger } from '../../utils/logger.js';
-
-const execAsync = promisify(exec);
-
-const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
-
-
-async function waitForOllamaServer({ retries = 15, delayMs = 1000 } = {}) {
-  for (let i = 0; i < retries; i++) {
-    try {
-      await ollama.list();
-      return true;
-    } catch (e) {
-      
-      logger.debug(`Ollama not ready (attempt ${i + 1}/${retries}): ${e.message}`);
-      await sleep(delayMs);
-    }
-  }
-  return false;
-}
-
-async function installOllamaEngine(spinner) {
-  const isWindows = process.platform === 'win32';
-  const installCmd = isWindows
-    ? 'winget install Ollama.Ollama --silent --accept-source-agreements'
-    : 'curl -fsSL https://ollama.com/install.sh | sh';
-
-  spinner.text = chalk.yellow('Downloading FlowDev engine package... (This may take a while)');
-
-  try {
-    
-    const { stdout, stderr } = await execAsync(installCmd, { maxBuffer: 10 * 1024 * 1024 });
-    logger.debug('install stdout: ' + (stdout || '').toString().slice(0, 2000));
-    logger.debug('install stderr: ' + (stderr || '').toString().slice(0, 2000));
-
-    spinner.succeed(chalk.green('FlowDev Engine installed successfully!'));
-    
-    await sleep(1500);
-  } catch (error) {
-    
-    spinner.fail(chalk.red('Automatic installation failed (admin rights or network?)'));
-    logger.error('Automatic installation error: ' + (error.message || error));
-    if (error.stdout || error.stderr) {
-      logger.error('Installer output (truncated):');
-      logger.error((error.stdout || '').toString().slice(0, 500));
-      logger.error((error.stderr || '').toString().slice(0, 500));
-    }
-
-    logger.error(`Try installing it manually: ${isWindows ? 'winget install Ollama.Ollama' : 'curl -fsSL https://ollama.com/install.sh | sh'}`);
-    throw error;
-  }
-}
-
-async function ensureOllamaRunning(spinner) {
-  try {
-   
-    await execAsync('ollama --version');
-  } catch (e) {
-    logger.info('Ollama binary not found. Attempting automatic install...');
-    
-    await installOllamaEngine(spinner);
-  }
-
-  
-  if (await waitForOllamaServer({ retries: 3, delayMs: 1000 })) {
-    return;
-  }
-
-  
-  logger.info('Starting ollama serve in background...');
-  try {
-    
-    const child = spawn('ollama', ['serve'], { detached: true, stdio: 'ignore' });
-    child.unref();
-  } catch (spawnErr) {
-    logger.error('Failed to spawn ollama serve: ' + spawnErr.message);
-    throw spawnErr;
-  }
-
-  
-  const ready = await waitForOllamaServer({ retries: 30, delayMs: 1000 });
-  if (!ready) {
-    throw new Error('Ollama server did not start in time. Check logs or run `ollama serve` manually.');
-  }
-}
+import { getAIResponse } from '../../utils/engine-check.js'; 
 
 export async function askCommand(question) {
   if (!question) {
@@ -99,80 +32,33 @@ export async function askCommand(question) {
   let spinner = ora(chalk.cyan('Initialization...')).start();
 
   try {
-    await ensureOllamaRunning(spinner);
-
-  
-    const modelName = process.env.OLLAMA_MODEL || 'llama3';
-
-    let hasModel = false;
-    try {
-      const models = await ollama.list();
-      hasModel = Array.isArray(models?.models) && models.models.some((m) => m.name?.startsWith(modelName));
-    } catch (err) {
-      logger.debug('Error listing models: ' + (err?.message || err));
-   
-    }
-
-    if (!hasModel) {
-      spinner.text = chalk.magenta('First launch: Configuring neurons...');
-      spinner.start();
-
-      try {
-        await ollama.pull({ model: modelName });
-        spinner.succeed(chalk.green('AI brain in charge !'));
-      } catch (pullErr) {
-        spinner.fail(chalk.red('Failed to download model.'));
-        logger.error('ollama.pull error: ' + (pullErr?.message || pullErr));
-        throw pullErr;
-      }
-
-      
-      spinner = ora(chalk.cyan('Thinking...')).start();
-    } else {
-      spinner.text = chalk.cyan('Thinking...');
-    }
-
-    
-    let context = 'flowdev intelligent CLI tool';
+    let context = 'You are FlowDev, an intelligent CLI assistant.';
     try {
       if (await fs.pathExists('package.json')) {
         const pkg = await fs.readJson('package.json');
-        if (pkg?.name) context += ` CURRENT CONTEXT: The user is in the project folder "${pkg.name}".`;
+        if (pkg?.name) context += ` CURRENT CONTEXT: User is in project "${pkg.name}".`;
       }
-    } catch (e) {
-      logger.debug('Failed to read package.json: ' + (e?.message || e));
-    }
-
-    const response = await ollama.chat({
-      model: modelName,
-      messages: [
-        { role: 'system', content: context },
-        { role: 'user', content: question },
-      ],
-      stream: true,
-    });
+    } catch (e) {}
+    const responseStream = await getAIResponse(
+        [
+            { role: 'system', content: context },
+            { role: 'user', content: question }
+        ],
+        spinner
+    );
 
-    
     spinner.stop();
+    console.log(chalk.bold.magenta('FlowDev:'));
 
-    for await (const part of response) {
+    for await (const part of responseStream) {
       const content = part?.message?.content;
       if (typeof content === 'string') {
         process.stdout.write(chalk.white(content));
       }
     }
-
     process.stdout.write('\n');
   } catch (error) {
-    
-    try { spinner.stop(); } catch (_) {}
-
-    logger.error('askCommand error: ' + (error?.message || error));
-
-    if (error?.code === 'ENOENT') {
-      console.log(chalk.red('\nUnable to find or install Ollama automatically.'));
-    } else {
-      console.log(chalk.red(`\nError: ${error?.message || error}`));
-    }
+    spinner.stop();
+    logger.error('Error: ' + error.message);
   }
-}
+}

package/src/commands/ai/audit.js

@@ -1,9 +1,27 @@
-import ollama from 'ollama';
+/**
+ * @fileoverview FlowDev  -  Intelligent CLI tool
+ * @module flowdev
+ * @version 1.0.5
+ * * @license MIT
+ * Copyright (c) 2026 FlowDev Technologies.
+ * * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+ */
+
 import chalk from 'chalk';
 import ora from 'ora';
 import fs from 'fs-extra';
 import path from 'path';
-import { ensureEngineReady } from '../../utils/engine-check.js';
+import { getAIResponse } from '../../utils/engine-check.js'; 
 import { logger } from '../../utils/logger.js';
 
 const AUDIT_EXTENSIONS = ['.js', '.ts', '.py', '.php', '.go', '.jsx', '.tsx', '.vue'];
@@ -31,18 +49,15 @@ export async function auditCommand() {
       return;
     }
 
-    await ensureEngineReady(spinner, 'llama3');
-    
-    spinner.text = chalk.magenta(`Auditing ${files.length} files...`);
+    spinner.text = chalk.magenta(`Preparing audit for ${files.length} files...`);
 
     let codeContext = "";
-    for (const file of files.slice(0, 10)) { 
+    for (const file of files.slice(0, 15)) { 
         const content = await fs.readFile(file, 'utf-8');
         codeContext += `\n--- File: ${path.basename(file)} ---\n${content}\n`;
     }
 
     const prompt = `
-      As an Expert Security Auditor,
       Analyze the following code for:
       1. Potential Bugs or logic errors.
       2. Security vulnerabilities (exposed keys, unsafe inputs).
@@ -50,26 +65,21 @@ export async function auditCommand() {
       4. Code quality and Best Practices.
 
       Provide a concise report with clear headings and bullet points.
-      If the code is perfect, congratulate the developer.
       
       Code to analyze:
-      ${codeContext}
+      ${codeContext.substring(0, 30000)} 
     `;
-
-    const response = await ollama.chat({
-      model: 'llama3',
-      messages: [{ role: 'user', content: prompt }],
-      stream: true,
-    });
+    const responseStream = await getAIResponse(
+        [{ role: 'user', content: prompt }], 
+        spinner
+    );
 
     spinner.stop();
-    console.log(chalk.bold.yellow('\n FLOWDEV AUDIT REPORT\n'));
-
-    for await (const part of response) {
+    for await (const part of responseStream) {
       process.stdout.write(chalk.white(part.message.content));
     }
 
-    console.log(chalk.cyan('\n\nAudit complete. Always double-check AI suggestions before applying.'));
+    console.log(chalk.cyan('\n\nAudit complete. Always verify AI suggestions.'));
 
   } catch (error) {
     spinner.stop();

package/src/commands/ai/explain.js

@@ -1,11 +1,29 @@
-import ollama from 'ollama';
+/**
+ * @fileoverview FlowDev  -  Intelligent CLI tool
+ * @module flowdev
+ * @version 1.0.5
+ * * @license MIT
+ * Copyright (c) 2026 FlowDev Technologies.
+ * * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+ */
+
 import chalk from 'chalk';
 import ora from 'ora';
 import fs from 'fs-extra';
 import path from 'path';
 import isBinaryPath from 'is-binary-path';
 import { createRequire } from 'module';
-import { ensureEngineReady } from '../../utils/engine-check.js';
+import { getAIResponse } from '../../utils/engine-check.js'; 
 import { logger } from '../../utils/logger.js';
 
 const require = createRequire(import.meta.url);
@@ -38,27 +56,26 @@ export async function explainCommand(filePath) {
   const spinner = ora(chalk.cyan('Initializing...')).start();
 
   try {
-    await ensureEngineReady(spinner, 'llama3');
-
     spinner.text = chalk.cyan(`Reading ${path.basename(filePath)}...`); 
     const content = await extractText(filePath);
 
-    spinner.text = chalk.magenta('Analyzing content...');
-    const response = await ollama.chat({  
-      model: 'llama3',
-      messages: [{ 
-        role: 'user', 
-        content: `Explain the following content clearly and concisely:\n\n${content.substring(0, 15000)}` 
-      }],
-      stream: true,
-    });
+    
+    const responseStream = await getAIResponse(
+        [{ 
+            role: 'user', 
+            content: `Explain the following content clearly and concisely:\n\n${content.substring(0, 15000)}` 
+        }],
+        spinner
+    );
 
     spinner.stop(); 
     console.log(chalk.red.bold(`ANALYSIS: ${path.basename(filePath).toUpperCase()} `));
     
-    for await (const part of response) {
+    for await (const part of responseStream) {
       process.stdout.write(chalk.white(part.message.content));
     }
+    process.stdout.write('\n');
+    
   } catch (error) {
     spinner.stop();
     logger.error(`Explain error: ${error.message}`);

package/src/commands/ai/readme.js

@@ -0,0 +1,70 @@
+/**
+ * @fileoverview FlowDev  -  Intelligent CLI tool
+ * @module flowdev
+ * @version 1.0.5
+ * * @license MIT
+ * Copyright (c) 2026 FlowDev Technologies.
+ * * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+ */
+
+import chalk from 'chalk';
+import ora from 'ora';
+import fs from 'fs-extra';
+import path from 'path';
+import { getAIResponse } from '../../utils/engine-check.js'; 
+import { logger } from '../../utils/logger.js';
+
+export async function readmeCommand() {
+  const spinner = ora(chalk.cyan('Reading project structure...')).start();
+
+  try {
+    const rootDir = process.cwd();
+    let projectInfo = "";
+
+    if (await fs.pathExists(path.join(rootDir, 'package.json'))) {
+      const pkg = await fs.readJson(path.join(rootDir, 'package.json'));
+      projectInfo += `Type: Node.js, Name: ${pkg.name}, Deps: ${Object.keys(pkg.dependencies || {}).join(', ')}`;
+    } else if (await fs.pathExists(path.join(rootDir, 'manage.py'))) {
+      projectInfo += `Type: Django/Python project`;
+    }
+
+    const prompt = `
+     Generate a professional README.md for a project with these details: ${projectInfo}.
+      The README should include:
+      - A catchy title with an emoji.
+      - Description, Installation, Usage.
+      - Return ONLY the markdown content.
+    `;
+
+    const responseStream = await getAIResponse(
+        [{ role: 'user', content: prompt }],
+        spinner
+    );
+
+    let readmeContent = "";
+    spinner.text = chalk.magenta('Drafting your documentation...');
+
+    for await (const part of responseStream) {
+        readmeContent += part.message.content;
+    }
+
+    const readmePath = path.join(rootDir, 'README.md');
+    await fs.writeFile(readmePath, readmeContent);
+
+    spinner.succeed(chalk.green('README.md generated successfully!'));
+
+  } catch (error) {
+    spinner.stop();
+    logger.error('Failed to generate README: ' + error.message);
+  }
+}