@mg21st/dev-assist 1.0.0

package/dist/server/index.js

@@ -0,0 +1,247 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startServer = startServer;
+const express_1 = __importDefault(require("express"));
+const cors_1 = __importDefault(require("cors"));
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const http_1 = require("http");
+const socket_io_1 = require("socket.io");
+const chalk_1 = __importDefault(require("chalk"));
+const open_1 = __importDefault(require("open"));
+const chokidar_1 = __importDefault(require("chokidar"));
+const express_rate_limit_1 = __importDefault(require("express-rate-limit"));
+const astParser_1 = require("../parser/astParser");
+const testGenerator_1 = require("../generators/testGenerator");
+const docsGenerator_1 = require("../generators/docsGenerator");
+const config_1 = require("../config");
+async function startServer(options) {
+    const app = (0, express_1.default)();
+    const httpServer = (0, http_1.createServer)(app);
+    const io = new socket_io_1.Server(httpServer, { cors: { origin: '*' } });
+    const config = await (0, config_1.loadConfig)();
+    app.use((0, cors_1.default)());
+    app.use(express_1.default.json());
+    // Rate limiter: max 60 requests per minute per IP for API routes
+    const apiLimiter = (0, express_rate_limit_1.default)({
+        windowMs: 60000,
+        max: 60,
+        standardHeaders: true,
+        legacyHeaders: false,
+        message: { error: 'Too many requests, please try again later.' },
+    });
+    const uiDistPath = path.join(__dirname, '../../ui/dist');
+    if (fs.existsSync(uiDistPath)) {
+        app.use(express_1.default.static(uiDistPath));
+    }
+    const parser = new astParser_1.AstParser();
+    const testGenerator = new testGenerator_1.TestGenerator();
+    const docsGenerator = new docsGenerator_1.DocsGenerator();
+    app.get('/api/summary', apiLimiter, async (_req, res) => {
+        try {
+            const sourceDir = config.sourceDir || './src';
+            const parsedFiles = await parser.parseDirectory(path.resolve(process.cwd(), sourceDir));
+            let totalFunctions = 0;
+            let totalRoutes = 0;
+            for (const file of parsedFiles) {
+                totalFunctions += file.functions.length;
+                totalRoutes += file.routes.length;
+            }
+            res.json({
+                totalFiles: parsedFiles.length,
+                totalFunctions,
+                totalRoutes,
+                totalTests: 0,
+                generatedAt: new Date().toISOString(),
+            });
+        }
+        catch (error) {
+            res.status(500).json({ error: String(error) });
+        }
+    });
+    app.get('/api/files', apiLimiter, async (_req, res) => {
+        try {
+            const sourceDir = config.sourceDir || './src';
+            const parsedFiles = await parser.parseDirectory(path.resolve(process.cwd(), sourceDir));
+            res.json(parsedFiles);
+        }
+        catch (error) {
+            res.status(500).json({ error: String(error) });
+        }
+    });
+    app.post('/api/generate/tests', apiLimiter, async (req, res) => {
+        try {
+            const { sourceDir, outputDir, framework } = req.body;
+            const generated = await testGenerator.generate({
+                sourceDir: sourceDir || config.sourceDir || './src',
+                outputDir: outputDir || config.testOutputDir || './__tests__',
+                framework: (framework || config.testFramework || 'jest'),
+            });
+            res.json({ success: true, files: generated });
+        }
+        catch (error) {
+            res.status(500).json({ error: String(error) });
+        }
+    });
+    app.post('/api/generate/docs', apiLimiter, async (req, res) => {
+        try {
+            const { sourceDir, outputDir } = req.body;
+            const doc = await docsGenerator.generate({
+                sourceDir: sourceDir || config.sourceDir || './src',
+                outputDir: outputDir || config.docsOutputDir || './docs',
+                baseUrl: config.baseUrl,
+            });
+            res.json({ success: true, doc });
+        }
+        catch (error) {
+            res.status(500).json({ error: String(error) });
+        }
+    });
+    app.get('/api/docs', apiLimiter, async (_req, res) => {
+        try {
+            const docsPath = path.join(process.cwd(), config.docsOutputDir || './docs', 'api-docs.json');
+            if (fs.existsSync(docsPath)) {
+                const docs = JSON.parse(fs.readFileSync(docsPath, 'utf-8'));
+                res.json(docs);
+            }
+            else {
+                res.json({ endpoints: [], title: 'API Documentation', version: '1.0.0', baseUrl: config.baseUrl });
+            }
+        }
+        catch (error) {
+            res.status(500).json({ error: String(error) });
+        }
+    });
+    app.get('/api/tests', apiLimiter, async (_req, res) => {
+        try {
+            const testDir = path.join(process.cwd(), config.testOutputDir || './__tests__');
+            const tests = [];
+            if (fs.existsSync(testDir)) {
+                const getTestFiles = (dir) => {
+                    const files = [];
+                    const entries = fs.readdirSync(dir, { withFileTypes: true });
+                    for (const entry of entries) {
+                        const fullPath = path.join(dir, entry.name);
+                        if (entry.isDirectory())
+                            files.push(...getTestFiles(fullPath));
+                        else if (entry.isFile() && entry.name.includes('.test.'))
+                            files.push(fullPath);
+                    }
+                    return files;
+                };
+                const testFiles = getTestFiles(testDir);
+                for (const file of testFiles) {
+                    tests.push({
+                        filePath: path.relative(process.cwd(), file),
+                        content: fs.readFileSync(file, 'utf-8'),
+                    });
+                }
+            }
+            res.json(tests);
+        }
+        catch (error) {
+            res.status(500).json({ error: String(error) });
+        }
+    });
+    app.post('/api/proxy', async (req, res) => {
+        try {
+            const { url, method, headers, body } = req.body;
+            const startTime = Date.now();
+            const fetchOptions = {
+                method: method || 'GET',
+                headers: {
+                    'Content-Type': 'application/json',
+                    ...(headers || {}),
+                },
+            };
+            if (body && ['POST', 'PUT', 'PATCH'].includes(method?.toUpperCase() || '')) {
+                fetchOptions.body = typeof body === 'string' ? body : JSON.stringify(body);
+            }
+            const response = await fetch(url, fetchOptions);
+            const responseTime = Date.now() - startTime;
+            let responseData;
+            const contentType = response.headers.get('content-type') || '';
+            if (contentType.includes('application/json')) {
+                responseData = await response.json();
+            }
+            else {
+                responseData = await response.text();
+            }
+            res.json({
+                status: response.status,
+                statusText: response.statusText,
+                headers: Object.fromEntries(response.headers.entries()),
+                data: responseData,
+                responseTime,
+            });
+        }
+        catch (error) {
+            res.status(500).json({ error: String(error) });
+        }
+    });
+    app.get('*', apiLimiter, (_req, res) => {
+        const indexPath = path.join(__dirname, '../../ui/dist/index.html');
+        if (fs.existsSync(indexPath)) {
+            res.sendFile(indexPath);
+        }
+        else {
+            res.json({ message: 'DevAssist API Server', status: 'running' });
+        }
+    });
+    if (config.watchMode) {
+        const watcher = chokidar_1.default.watch(config.sourceDir || './src', {
+            ignored: /node_modules/,
+            persistent: true,
+        });
+        watcher.on('change', (filePath) => {
+            io.emit('file-changed', { filePath });
+        });
+    }
+    io.on('connection', (socket) => {
+        socket.emit('connected', { message: 'DevAssist server connected' });
+    });
+    httpServer.listen(options.port, () => {
+        console.log(chalk_1.default.green.bold(`\n✅ DevAssist UI running at http://localhost:${options.port}\n`));
+        console.log(chalk_1.default.gray('Press Ctrl+C to stop the server\n'));
+        if (options.openBrowser) {
+            (0, open_1.default)(`http://localhost:${options.port}`);
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/shared/types.d.ts

@@ -0,0 +1,77 @@
+export interface ParsedFunction {
+    name: string;
+    params: string[];
+    isAsync: boolean;
+    isExported: boolean;
+    returnType?: string;
+}
+export interface ParsedRoute {
+    method: string;
+    path: string;
+    handler: string;
+    params: string[];
+    middleware: string[];
+}
+export interface ParsedFile {
+    filePath: string;
+    functions: ParsedFunction[];
+    routes: ParsedRoute[];
+    imports: string[];
+}
+export interface GeneratedTest {
+    filePath: string;
+    sourceFile: string;
+    framework: 'jest' | 'vitest';
+    content: string;
+}
+export interface ApiEndpoint {
+    method: string;
+    path: string;
+    params: PathParam[];
+    queryParams: QueryParam[];
+    bodySchema?: BodySchema;
+    description?: string;
+    exampleRequest?: Record<string, unknown>;
+    exampleResponse?: Record<string, unknown>;
+}
+export interface PathParam {
+    name: string;
+    type: string;
+    required: boolean;
+}
+export interface QueryParam {
+    name: string;
+    type: string;
+    required: boolean;
+}
+export interface BodySchema {
+    type: string;
+    properties: Record<string, {
+        type: string;
+        required?: boolean;
+    }>;
+}
+export interface ApiDoc {
+    title: string;
+    version: string;
+    baseUrl: string;
+    endpoints: ApiEndpoint[];
+    generatedAt: string;
+}
+export interface DevAssistConfig {
+    testFramework: 'jest' | 'vitest';
+    sourceDir: string;
+    testOutputDir: string;
+    docsOutputDir: string;
+    port: number;
+    watchMode: boolean;
+    baseUrl: string;
+}
+export interface ProjectSummary {
+    totalFiles: number;
+    totalFunctions: number;
+    totalRoutes: number;
+    totalTests: number;
+    generatedAt: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,GAAG,QAAQ,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/shared/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/docs/_config.yml

@@ -0,0 +1,22 @@
+title: DevAssist
+description: All-in-one developer toolkit — Auto Test Generator, API Docs Generator & API Testing UI
+remote_theme: just-the-docs/just-the-docs
+
+url: https://moazzamgodil.github.io
+baseurl: /dev-assist
+
+aux_links:
+  "View on GitHub":
+    - "https://github.com/moazzamgodil/dev-assist"
+
+aux_links_new_tab: true
+
+nav_sort: case_insensitive
+
+color_scheme: light
+
+footer_content: "DevAssist is released under the <a href=\"https://opensource.org/licenses/MIT\">MIT License</a>."
+
+plugins:
+  - jekyll-remote-theme
+  - jekyll-seo-tag

package/docs/api-reference.md

@@ -0,0 +1,173 @@
+---
+title: API Reference
+nav_order: 5
+---
+
+# API Reference
+
+When you run `dev-assist serve`, an Express server starts locally. The UI communicates with this server, but you can also call these endpoints directly.
+
+---
+
+## Base URL
+
+```
+http://localhost:<port>/api
+```
+
+The default port is `3000`. Configure it via `--port` or `port` in `dev-assist.config.js`.
+
+---
+
+## Endpoints
+
+### GET `/api/summary`
+
+Returns a summary of the project statistics.
+
+**Response**
+
+```json
+{
+  "totalFiles": 12,
+  "totalFunctions": 47,
+  "totalRoutes": 8,
+  "testFiles": 12,
+  "docsFiles": 3
+}
+```
+
+---
+
+### GET `/api/files`
+
+Returns the list of parsed source files.
+
+**Response**
+
+```json
+[
+  {
+    "path": "src/server/index.ts",
+    "functions": ["startServer", "setupMiddleware"],
+    "routes": ["GET /api/summary", "POST /api/generate/tests"]
+  }
+]
+```
+
+---
+
+### GET `/api/tests`
+
+Returns the list of generated test files.
+
+**Response**
+
+```json
+[
+  {
+    "file": "__tests__/server/index.test.ts",
+    "content": "..."
+  }
+]
+```
+
+---
+
+### GET `/api/docs`
+
+Returns the generated API documentation.
+
+**Response**
+
+```json
+[
+  {
+    "file": "docs/api.md",
+    "content": "..."
+  }
+]
+```
+
+---
+
+### POST `/api/generate/tests`
+
+Triggers test stub generation.
+
+**Request body**
+
+```json
+{
+  "source": "./src",
+  "output": "./__tests__",
+  "framework": "jest"
+}
+```
+
+**Response**
+
+```json
+{
+  "success": true,
+  "filesGenerated": 12
+}
+```
+
+---
+
+### POST `/api/generate/docs`
+
+Triggers API documentation generation.
+
+**Request body**
+
+```json
+{
+  "source": "./src",
+  "output": "./docs"
+}
+```
+
+**Response**
+
+```json
+{
+  "success": true,
+  "filesGenerated": 3
+}
+```
+
+---
+
+### POST `/api/proxy`
+
+Proxies an HTTP request to any URL. Used by the built-in API testing client.
+
+**Request body**
+
+```json
+{
+  "method": "GET",
+  "url": "http://localhost:3000/api/summary",
+  "headers": {},
+  "body": null
+}
+```
+
+**Response**
+
+The proxied response body along with status code and headers.
+
+---
+
+## WebSocket Events
+
+DevAssist uses [Socket.IO](https://socket.io/) for real-time updates. Connect to the server on the same port:
+
+| Event | Direction | Description |
+|-------|-----------|-------------|
+| `generation:start` | Server → Client | Fired when generation begins |
+| `generation:progress` | Server → Client | Progress updates during generation |
+| `generation:done` | Server → Client | Fired when generation completes |
+| `generation:error` | Server → Client | Fired when generation fails |

package/docs/architecture.md

@@ -0,0 +1,90 @@
+---
+title: Architecture
+nav_order: 6
+---
+
+# Architecture
+
+## Project Layout
+
+```
+dev-assist/
+├── bin/
+│   └── dev-assist.js       # Node.js shebang entry point (calls dist/cli/index.js)
+├── src/
+│   ├── cli/
+│   │   ├── index.ts        # Commander CLI — registers commands and flags
+│   │   └── wizard.ts       # Inquirer interactive wizard
+│   ├── generators/
+│   │   ├── testGenerator.ts  # Generates Jest/Vitest test stubs from AST
+│   │   └── docsGenerator.ts  # Generates OpenAPI spec + Markdown from routes
+│   ├── parser/
+│   │   └── astParser.ts    # Babel-based AST parser for JS/TS source files
+│   ├── server/
+│   │   └── index.ts        # Express + Socket.IO API server
+│   ├── shared/
+│   │   └── types.ts        # Shared TypeScript interfaces and types
+│   └── config.ts           # Config file loader (dev-assist.config.js)
+├── ui/                     # React + Vite + Tailwind frontend
+│   ├── src/
+│   │   ├── components/     # Reusable UI components
+│   │   └── pages/          # Dashboard, Tests, Docs, API Tester pages
+│   └── vite.config.ts
+├── docs/                   # This documentation site (GitHub Pages)
+├── dev-assist.config.js    # Example configuration file
+└── package.json
+```
+
+---
+
+## Data Flow
+
+```
+User invokes CLI
+      │
+      ▼
+  bin/dev-assist.js
+      │
+      ▼
+  src/cli/index.ts  ──── interactive? ──► src/cli/wizard.ts
+      │
+      ├── generate --tests ──► src/generators/testGenerator.ts
+      │                              │
+      │                              └── src/parser/astParser.ts
+      │
+      ├── generate --docs  ──► src/generators/docsGenerator.ts
+      │                              │
+      │                              └── src/parser/astParser.ts
+      │
+      └── serve ──► src/server/index.ts ──► ui/ (static files)
+```
+
+---
+
+## Key Technologies
+
+| Layer | Technology | Purpose |
+|-------|-----------|---------|
+| CLI | [Commander.js](https://github.com/tj/commander.js) | Argument parsing and command registration |
+| CLI | [Inquirer.js](https://github.com/SBoudrias/Inquirer.js) | Interactive prompts |
+| Parser | [@babel/parser](https://babeljs.io/docs/babel-parser) | AST parsing of JS/TS source files |
+| Parser | [@babel/traverse](https://babeljs.io/docs/babel-traverse) | AST traversal to extract functions and routes |
+| Server | [Express](https://expressjs.com/) | REST API backend |
+| Server | [Socket.IO](https://socket.io/) | Real-time progress events |
+| UI | [React](https://react.dev/) | Component-based frontend |
+| UI | [Vite](https://vitejs.dev/) | Fast bundler and dev server |
+| UI | [Tailwind CSS](https://tailwindcss.com/) | Utility-first styling |
+| Styling (CLI) | [Chalk](https://github.com/chalk/chalk) | Terminal colors |
+| Styling (CLI) | [Ora](https://github.com/sindresorhus/ora) | Spinner animations |
+
+---
+
+## Build Pipeline
+
+```
+npm run build
+  ├── tsc -p tsconfig.build.json   → dist/   (CLI + server)
+  └── cd ui && npm run build       → ui/dist/ (React app)
+```
+
+The compiled UI assets are served as static files by the Express server.

package/docs/configuration.md

@@ -0,0 +1,52 @@
+---
+title: Configuration
+nav_order: 4
+---
+
+# Configuration
+
+DevAssist looks for a `dev-assist.config.js` file in the root of your project. If the file is absent, built-in defaults are used.
+
+---
+
+## Creating the Config File
+
+Run the interactive wizard and it will offer to create the file, or create it manually:
+
+```js
+// dev-assist.config.js
+module.exports = {
+  testFramework: 'jest',       // 'jest' | 'vitest'
+  sourceDir: './src',
+  testOutputDir: './__tests__',
+  docsOutputDir: './docs',
+  port: 3000,
+  watchMode: false,
+  baseUrl: 'http://localhost:3000',
+};
+```
+
+---
+
+## Options Reference
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `testFramework` | `string` | `'jest'` | Test framework to use for generated stubs. Accepts `'jest'` or `'vitest'`. |
+| `sourceDir` | `string` | `'./src'` | Directory containing your source files to parse. |
+| `testOutputDir` | `string` | `'./__tests__'` | Directory where generated test files are written. |
+| `docsOutputDir` | `string` | `'./docs'` | Directory where generated API documentation is written. |
+| `port` | `number` | `3000` | Port for the local UI server (`dev-assist serve`). |
+| `watchMode` | `boolean` | `false` | When `true`, re-generates output automatically when source files change. |
+| `baseUrl` | `string` | `'http://localhost:3000'` | Base URL used by the built-in HTTP client for API testing. |
+
+---
+
+## CLI Flags vs Config File
+
+CLI flags always override values from `dev-assist.config.js`. This allows you to keep default settings in the config file while overriding specific values for one-off runs:
+
+```bash
+# Use config defaults except for the port
+dev-assist serve --port 4000
+```