@flowdevcli/flowdev 1.0.3 → 1.0.5

package/src/commands/utils/tree.js

@@ -1,3 +1,22 @@
+/**
+ * @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 { generateTree } from '../../services/file-system.js';
 

package/src/core/cli.js

@@ -1,3 +1,24 @@
+#!/usr/bin/env node
+
+/**
+ * @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 { program } from 'commander';
 import { createRequire } from 'node:module';
 import chalk from 'chalk';
@@ -7,11 +28,14 @@ import { dockerizeCommand } from '../commands/devops/dockerize.js';
 import {findCommand} from '../commands/scaffold/find.js'
 import { askCommand } from '../commands/ai/ask.js';
 import { explainCommand } from '../commands/ai/explain.js';
+import { askCommand } from '../commands/ai/readme.js'
 import { envCommand } from '../commands/devops/env.js';
 import { kubeCommand } from '../commands/devops/kube.js';
 import { generateCommand } from '../commands/scaffold/generate.js';
 import { auditCommand } from '../commands/ai/audit.js';
 import { testCommand } from '../commands/ai/test.js';
+import { updateCommand } from '../commands/system/update.js';
+import { configCommand } from './commands/config.js'
 
 
 const require = createRequire(import.meta.url);
@@ -109,5 +133,20 @@ export function setupCLI() {
     await testCommand(file);
   });
 
+  program
+  .command('readme')
+  .description('Automatically generate a README.md for the project')
+  .action(readmeCommand);
+
+ program
+  .command('config')
+  .description('Configure AI models (API keys, settings)')
+  .action(configCommand);
+
+  program
+  .command('update')
+  .description('Update FlowDev to the latest version')
+  .action(updateCommand);
+
   return program;
 }

package/src/services/analyzer.js

@@ -1,3 +1,22 @@
+/**
+ * @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 fs from 'node:fs/promises';
 import { createReadStream } from 'node:fs';
 import path from 'node:path';

package/src/services/file-system.js

@@ -1,3 +1,22 @@
+/**
+ * @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 fs from 'node:fs/promises';
 import path from 'node:path';
 import chalk from 'chalk';

package/src/templates/docker/templates.js

@@ -1,3 +1,21 @@
+/**
+ * @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.
+ */
 
 export const nodeDockerfile = (version, port, command) => `
 # Stage 1: Build

package/src/utils/engine-check.js

@@ -1,13 +1,15 @@
 import ollama from 'ollama';
 import chalk from 'chalk';
-import ora from 'ora';
+import inquirer from 'inquirer';
 import { exec, spawn } from 'node:child_process';
 import { promisify } from 'util';
 import { logger } from './logger.js';
+import { getDeepSeekKey } from './config-manager.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 {
@@ -26,46 +28,152 @@ async function installOllamaEngine(spinner) {
     ? 'winget install Ollama.Ollama --silent --accept-source-agreements'
     : 'curl -fsSL https://ollama.com/install.sh | sh';
 
-  
-  spinner.text = chalk.yellow("Installing FlowDev's engine package to run the command... (This may take a while)");
+  spinner.text = chalk.yellow("Installing local neural components... (Please wait)");
 
   try {
     await execAsync(installCmd, { maxBuffer: 10 * 1024 * 1024 });
-    spinner.succeed(chalk.green('FlowDev Engine installed successfully!'));
+    spinner.succeed(chalk.green('Local engine installed.'));
     await sleep(1500);
   } catch (error) {
-    spinner.fail(chalk.red('Automatic installation failed.'));
-    logger.error(`Please install it manually: ${isWindows ? 'winget install Ollama.Ollama' : 'curl -fsSL https://ollama.com/install.sh | sh'}`);
+    spinner.fail(chalk.red("Automatic installation failed."));
+    logger.error(`Please install Ollama manually.`);
     throw error;
   }
 }
 
-export async function ensureEngineReady(spinner, modelName = 'llama3') {
-  
+async function ensureOllamaReady(spinner, modelName) {
   try {
-    await execAsync('ollama --version');  
+    await execAsync('ollama --version');
   } catch (e) {
     await installOllamaEngine(spinner);
   }
-  
+
   if (!(await waitForOllamaServer({ retries: 3, delayMs: 1000 }))) {
-    spinner.text = chalk.blue('Starting engine in background...');
+    spinner.text = chalk.blue('Starting local inference service...');
     const child = spawn('ollama', ['serve'], { detached: true, stdio: 'ignore' });
     child.unref();
-    
+
     const ready = await waitForOllamaServer({ retries: 30, delayMs: 1000 });
-    if (!ready) throw new Error('Engine server failed to start.');
+    if (!ready) throw new Error("The local server is not responding.");
   }
+
   let hasModel = false;
   try {
     const models = await ollama.list();
     hasModel = Array.isArray(models?.models) && models.models.some((m) => m.name?.startsWith(modelName));
-  } catch (err) { }
+  } catch (err) {}
 
   if (!hasModel) {
-    spinner.text = chalk.magenta(`First launch: Downloading AI neurons (${modelName})...`);
+    spinner.text = chalk.magenta(`Acquiring the model ${modelName} (size: ~4GB)...`);
     await ollama.pull({ model: modelName });
-    spinner.succeed(chalk.green('AI brain loaded!'));
+    spinner.succeed(chalk.green('Local engine ready.'));
     spinner.start();
   }
-}
+}
+
+
+async function* streamDeepSeek(messages) {
+  const apiKey = getDeepSeekKey();
+  
+  const response = await fetch('https://api.deepseek.com/chat/completions', {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      'Authorization': `Bearer ${apiKey}`
+    },
+    body: JSON.stringify({
+      model: 'deepseek-chat',
+      messages: messages,
+      stream: true
+    })
+  });
+
+  if (!response.ok) {
+    const err = await response.text();
+    throw new Error(`DeepSeek API Error: ${response.status} - ${err}`);
+  }
+
+  const reader = response.body.getReader();
+  const decoder = new TextDecoder("utf-8");
+  let buffer = "";
+
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    buffer += decoder.decode(value, { stream: true });
+    const lines = buffer.split("\n");
+    buffer = lines.pop(); 
+
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (!trimmed || trimmed === "data: [DONE]") continue;
+      if (trimmed.startsWith("data: ")) {
+        try {
+          const json = JSON.parse(trimmed.replace("data: ", ""));
+          const content = json.choices[0]?.delta?.content;
+          if (content) yield { message: { content: content } };
+        } catch (e) {}
+      }
+    }
+  }
+}
+
+
+export async function getAIResponse(messages, spinner, forceModel = null) {
+  if (spinner) spinner.stop();
+
+  let provider = forceModel;
+
+  if (!provider) {
+    const hasKey = !!getDeepSeekKey();
+    
+    const answer = await inquirer.prompt([
+      {
+        type: 'list',
+        name: 'provider',
+        message: 'Select AI Model:',
+        choices: [
+          {
+            name: ' Llama 3 (Local - Private, Free, requires download)',
+            value: 'llama3',
+            short: 'Llama 3 (Local)'
+          },
+          {
+            name: `DeepSeek V3 (Cloud - Fast)`,
+            value: 'deepseek',
+            disabled: !hasKey ? 'run "flowdev config" first' : false,
+            short: 'DeepSeek (Cloud)'
+          }
+        ]
+      }
+    ]);
+    provider = answer.provider;
+  }
+
+  if (spinner) spinner.start();
+
+  if (provider === 'llama3') {
+    if (spinner) spinner.text = chalk.cyan('Local environment check...');
+    await ensureOllamaReady(spinner, 'llama3');
+    
+    if (spinner) spinner.text = chalk.magenta('Thinking...');
+    return await ollama.chat({
+      model: 'llama3',
+      messages: messages,
+      stream: true,
+    });
+  } 
+  else if (provider === 'deepseek') {
+    if (spinner) spinner.text = chalk.cyan('Connecting to the DeepSeek remote server...');
+    try {
+        await fetch('https://www.google.com', { method: 'HEAD' });
+    } catch (e) {
+        throw new Error("An active internet connection is required to use DeepSeek.");
+    }
+    
+    if (spinner) spinner.text = chalk.magenta('Analyzing...');
+    return streamDeepSeek(messages);
+  }
+}
+
+export { ensureOllamaReady as ensureEngineReady };

package/src/utils/logger.js

@@ -1,3 +1,22 @@
+/**
+ * @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';
 
 export const logger = {

package/src/commands/scaffold/readme.js

@@ -1,54 +0,0 @@
-import ollama from 'ollama';
-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 { 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/Web, Name: ${pkg.name}, Deps: ${Object.keys(pkg.dependencies || {}).join(', ')}`;
-    } else if (await fs.pathExists(path.join(rootDir, 'manage.py'))) {
-      projectInfo += `Type: Django/Python project`;
-    }
-
-    await ensureEngineReady(spinner, 'llama3');
-
-    spinner.text = chalk.magenta('Drafting your documentation...');
-
-    
-    const prompt = `
-      You are a technical writer. Generate a professional README.md for a project with these details: ${projectInfo}.
-      The README should include:
-      - A catchy title with an emoji.
-      - A brief description.
-      - Installation steps.
-      - How to run the project.
-      - Tech stack used.
-      
-      Return ONLY the markdown content.
-    `;
-
-    const response = await ollama.chat({
-      model: 'llama3.2',
-      messages: [{ role: 'user', content: prompt }],
-    });
-    const readmePath = path.join(rootDir, 'README.md');
-    await fs.writeFile(readmePath, response.message.content);
-
-    spinner.succeed(chalk.green('README.md generated successfully! '));
-
-  } catch (error) {
-    spinner.fail(chalk.red('Failed to generate README.'));
-    logger.error(error.message);
-  }
-}