@mg21st/dev-assist 1.0.0

package/.eslintrc.json

@@ -0,0 +1,17 @@
+{
+  "root": true,
+  "parser": "@typescript-eslint/parser",
+  "plugins": ["@typescript-eslint"],
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended"
+  ],
+  "env": {
+    "node": true,
+    "es2020": true
+  },
+  "rules": {
+    "@typescript-eslint/no-explicit-any": "warn",
+    "@typescript-eslint/no-unused-vars": "warn"
+  }
+}

package/.github/workflows/ci.yml

@@ -0,0 +1,42 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint-and-build:
+    name: Lint & Build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: |
+            package-lock.json
+            ui/package-lock.json
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Build CLI
+        run: npm run build:cli
+
+      - name: Install UI dependencies
+        run: npm ci --prefix ui
+
+      - name: Build UI
+        run: npm run build:ui

package/.github/workflows/docs.yml

@@ -0,0 +1,49 @@
+name: Deploy Docs
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'docs/**'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    name: Build Docs
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Build with Jekyll
+        uses: actions/jekyll-build-pages@v1
+        with:
+          source: ./docs
+          destination: ./_site
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+
+  deploy:
+    name: Deploy to GitHub Pages
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

package/.github/workflows/publish.yml

@@ -0,0 +1,49 @@
+name: Publish to npm
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    name: Build & Publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+          cache: 'npm'
+          cache-dependency-path: |
+            package-lock.json
+            ui/package-lock.json
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build CLI
+        run: npm run build:cli
+
+      - name: Install UI dependencies
+        run: npm ci --prefix ui
+
+      - name: Build UI
+        run: npm run build:ui
+
+      - name: Verify build artifacts
+        run: test -f dist/cli/index.js
+
+      - name: Dry run publish
+        run: npm publish --dry-run --access public
+
+      - name: Publish to npm
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/README.md

@@ -0,0 +1,117 @@
+# DevAssist 🚀
+
+> All-in-one developer toolkit: Auto Test Generator, API Docs Generator & API Testing UI
+
+[![npm version](https://img.shields.io/npm/v/dev-assist.svg)](https://www.npmjs.com/package/dev-assist)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Features
+
+- 🧪 **Auto Test Generator** - AST-based test stub generation for JS/TS
+- 📚 **API Docs Generator** - Extract Express routes and generate OpenAPI specs + Markdown
+- 🌐 **Local UI Server** - Beautiful React UI with dashboard, tests viewer, API docs browser
+- ⚡ **API Testing Tab** - Lightweight Postman-like HTTP client built-in
+- 🧙 **Interactive CLI Wizard** - Guided setup experience
+
+## Installation
+
+```bash
+npm install -g dev-assist
+```
+
+## Usage
+
+### Interactive wizard
+```bash
+dev-assist
+```
+
+### Generate tests
+```bash
+dev-assist generate --tests --source ./src --output ./__tests__ --framework jest
+```
+
+### Generate API docs
+```bash
+dev-assist generate --docs --source ./src --output ./docs
+```
+
+### Generate both
+```bash
+dev-assist generate --source ./src
+```
+
+### Start UI server
+```bash
+dev-assist serve --port 3000
+```
+
+## Configuration
+
+Create `dev-assist.config.js` in your project root:
+
+```js
+module.exports = {
+  testFramework: 'jest',     // 'jest' | 'vitest'
+  sourceDir: './src',
+  testOutputDir: './__tests__',
+  docsOutputDir: './docs',
+  port: 3000,
+  watchMode: false,
+  baseUrl: 'http://localhost:3000',
+};
+```
+
+## Development Setup
+
+### Prerequisites
+- Node.js >= 16
+- npm >= 7
+
+### Build
+
+```bash
+# Install root dependencies
+npm install
+
+# Install UI dependencies
+cd ui && npm install && cd ..
+
+# Build everything
+npm run build
+```
+
+### Run in development
+```bash
+npm run dev
+```
+
+## Architecture
+
+```
+dev-assist/
+  bin/                    # CLI entry point
+  src/
+    cli/                  # Commander + Inquirer CLI
+    generators/           # Test & docs generators
+    parser/               # @babel/parser AST parser
+    server/               # Express backend API
+    shared/               # TypeScript types
+  ui/                     # React + Vite + Tailwind frontend
+```
+
+## API Endpoints (Server)
+
+| Method | Path | Description |
+|--------|------|-------------|
+| GET | /api/summary | Project statistics |
+| GET | /api/files | Parsed file list |
+| GET | /api/tests | Generated test files |
+| GET | /api/docs | API documentation |
+| POST | /api/generate/tests | Trigger test generation |
+| POST | /api/generate/docs | Trigger docs generation |
+| POST | /api/proxy | Proxy HTTP requests (API testing) |
+
+## License
+
+MIT

package/bin/dev-assist.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+'use strict';
+
+require('../dist/cli/index.js');

package/dev-assist.config.js

@@ -0,0 +1,10 @@
+/** @type {import('./src/shared/types').DevAssistConfig} */
+module.exports = {
+  testFramework: 'jest',
+  sourceDir: './src',
+  testOutputDir: './__tests__',
+  docsOutputDir: './docs',
+  port: 3000,
+  watchMode: false,
+  baseUrl: 'http://localhost:3000',
+};

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+"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 });
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const testGenerator_1 = require("../generators/testGenerator");
+const docsGenerator_1 = require("../generators/docsGenerator");
+const wizard_1 = require("./wizard");
+const config_1 = require("../config");
+const program = new commander_1.Command();
+program
+    .name('dev-assist')
+    .description('🚀 DevAssist - Auto Test Generator, API Docs & Testing UI')
+    .version('1.0.0');
+program
+    .command('generate')
+    .description('Generate tests and/or API docs')
+    .option('--tests', 'Generate test files only')
+    .option('--docs', 'Generate API docs only')
+    .option('-s, --source <dir>', 'Source directory', './src')
+    .option('-o, --output <dir>', 'Output directory', './__tests__')
+    .option('-f, --framework <framework>', 'Test framework (jest|vitest)', 'jest')
+    .action(async (options) => {
+    const config = await (0, config_1.loadConfig)();
+    const generateTests = options.tests || (!options.docs);
+    const generateDocs = options.docs || (!options.tests);
+    if (generateTests) {
+        console.log(chalk_1.default.cyan('\n🧪 Generating Tests...\n'));
+        const generator = new testGenerator_1.TestGenerator();
+        await generator.generate({
+            sourceDir: options.source || config.sourceDir || './src',
+            outputDir: options.output || config.testOutputDir || './__tests__',
+            framework: (options.framework || config.testFramework || 'jest'),
+        });
+    }
+    if (generateDocs) {
+        console.log(chalk_1.default.cyan('\n📚 Generating API Docs...\n'));
+        const generator = new docsGenerator_1.DocsGenerator();
+        await generator.generate({
+            sourceDir: options.source || config.sourceDir || './src',
+            outputDir: options.output || config.docsOutputDir || './docs',
+        });
+    }
+});
+program
+    .command('serve')
+    .description('Start the local UI server')
+    .option('-p, --port <port>', 'Port number', '3000')
+    .option('--no-open', 'Do not open browser automatically')
+    .action(async (options) => {
+    const config = await (0, config_1.loadConfig)();
+    const port = parseInt(options.port || config.port?.toString() || '3000', 10);
+    console.log(chalk_1.default.cyan(`\n🌐 Starting DevAssist UI on port ${port}...\n`));
+    const { startServer } = await Promise.resolve().then(() => __importStar(require('../server/index')));
+    await startServer({ port, openBrowser: options.open !== false });
+});
+program
+    .action(async () => {
+    try {
+        const answers = await (0, wizard_1.runWizard)();
+        if (answers.action === 'serve') {
+            const { startServer } = await Promise.resolve().then(() => __importStar(require('../server/index')));
+            await startServer({ port: answers.port || 3000, openBrowser: true });
+            return;
+        }
+        const config = await (0, config_1.loadConfig)();
+        const doTests = answers.action === 'tests' || answers.action === 'both';
+        const doDocs = answers.action === 'docs' || answers.action === 'both';
+        if (doTests) {
+            console.log(chalk_1.default.cyan('\n🧪 Generating Tests...\n'));
+            const generator = new testGenerator_1.TestGenerator();
+            await generator.generate({
+                sourceDir: answers.sourceDir || config.sourceDir || './src',
+                outputDir: answers.testOutputDir || config.testOutputDir || './__tests__',
+                framework: (answers.testFramework || config.testFramework || 'jest'),
+            });
+        }
+        if (doDocs) {
+            console.log(chalk_1.default.cyan('\n📚 Generating API Docs...\n'));
+            const generator = new docsGenerator_1.DocsGenerator();
+            await generator.generate({
+                sourceDir: answers.sourceDir || config.sourceDir || './src',
+                outputDir: answers.docsOutputDir || config.docsOutputDir || './docs',
+            });
+        }
+        console.log(chalk_1.default.green.bold('\n✅ DevAssist completed successfully!\n'));
+    }
+    catch (error) {
+        if (error.code === 'ERR_USE_AFTER_CLOSE') {
+            process.exit(0);
+        }
+        console.error(chalk_1.default.red('\n❌ Error:', error));
+        process.exit(1);
+    }
+});
+program.parse(process.argv);
+//# sourceMappingURL=index.js.map

package/dist/cli/wizard.d.ts

@@ -0,0 +1,5 @@
+import { DevAssistConfig } from '../shared/types';
+export declare function runWizard(): Promise<Partial<DevAssistConfig> & {
+    action?: string;
+}>;
+//# sourceMappingURL=wizard.d.ts.map

package/dist/cli/wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.d.ts","sourceRoot":"","sources":["../../src/cli/wizard.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,wBAAsB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA0DzF"}

package/dist/cli/wizard.js

@@ -0,0 +1,66 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runWizard = runWizard;
+const inquirer_1 = __importDefault(require("inquirer"));
+const chalk_1 = __importDefault(require("chalk"));
+async function runWizard() {
+    console.log(chalk_1.default.cyan.bold('\n🚀 Welcome to DevAssist CLI Wizard\n'));
+    const answers = await inquirer_1.default.prompt([
+        {
+            type: 'list',
+            name: 'action',
+            message: 'What would you like to do?',
+            choices: [
+                { name: '🧪 Generate Tests', value: 'tests' },
+                { name: '📚 Generate API Docs', value: 'docs' },
+                { name: '🔥 Generate Both (Tests + Docs)', value: 'both' },
+                { name: '🌐 Start UI Server', value: 'serve' },
+            ],
+        },
+        {
+            type: 'input',
+            name: 'sourceDir',
+            message: 'Source directory to scan:',
+            default: './src',
+        },
+        {
+            type: 'list',
+            name: 'testFramework',
+            message: 'Test framework:',
+            choices: ['jest', 'vitest'],
+            when: (a) => a.action === 'tests' || a.action === 'both',
+        },
+        {
+            type: 'input',
+            name: 'testOutputDir',
+            message: 'Test output directory:',
+            default: './__tests__',
+            when: (a) => a.action === 'tests' || a.action === 'both',
+        },
+        {
+            type: 'input',
+            name: 'docsOutputDir',
+            message: 'Docs output directory:',
+            default: './docs',
+            when: (a) => a.action === 'docs' || a.action === 'both',
+        },
+        {
+            type: 'number',
+            name: 'port',
+            message: 'UI server port:',
+            default: 3000,
+            when: (a) => a.action === 'serve',
+        },
+        {
+            type: 'confirm',
+            name: 'watchMode',
+            message: 'Enable watch mode?',
+            default: false,
+        },
+    ]);
+    return answers;
+}
+//# sourceMappingURL=wizard.js.map

package/dist/config.d.ts

@@ -0,0 +1,3 @@
+import { DevAssistConfig } from './shared/types';
+export declare function loadConfig(): Promise<DevAssistConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAYjD,wBAAsB,UAAU,IAAI,OAAO,CAAC,eAAe,CAAC,CAc3D"}

package/dist/config.js

@@ -0,0 +1,62 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const DEFAULT_CONFIG = {
+    testFramework: 'jest',
+    sourceDir: './src',
+    testOutputDir: './__tests__',
+    docsOutputDir: './docs',
+    port: 3000,
+    watchMode: false,
+    baseUrl: 'http://localhost:3000',
+};
+async function loadConfig() {
+    const configPath = path.resolve(process.cwd(), 'dev-assist.config.js');
+    if (fs.existsSync(configPath)) {
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const userConfig = require(configPath);
+            return { ...DEFAULT_CONFIG, ...userConfig };
+        }
+        catch {
+            // Ignore config load errors
+        }
+    }
+    return DEFAULT_CONFIG;
+}
+//# sourceMappingURL=config.js.map

package/dist/generators/docsGenerator.d.ts

@@ -0,0 +1,15 @@
+import { ApiDoc } from '../shared/types';
+export declare class DocsGenerator {
+    private parser;
+    constructor();
+    generate(options: {
+        sourceDir: string;
+        outputDir: string;
+        baseUrl?: string;
+        title?: string;
+    }): Promise<ApiDoc>;
+    private buildEndpoint;
+    private generateMarkdown;
+    private generateOpenApiSpec;
+}
+//# sourceMappingURL=docsGenerator.d.ts.map

package/dist/generators/docsGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docsGenerator.d.ts","sourceRoot":"","sources":["../../src/generators/docsGenerator.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAA4B,MAAM,iBAAiB,CAAC;AAEnE,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAY;;IAMpB,QAAQ,CAAC,OAAO,EAAE;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,MAAM,CAAC;IA4CnB,OAAO,CAAC,aAAa;IA6BrB,OAAO,CAAC,gBAAgB;IAuDxB,OAAO,CAAC,mBAAmB;CA4C5B"}