legacyver 2.1.7 → 2.1.8

package/README.md

@@ -1,199 +1,96 @@
-# Legacyver
+# 🚀 Legacyver
 
-Auto-generate technical documentation for legacy and undocumented codebases using AST parsing + LLMs.
-
-```bash
-npx legacyver analyze ./src
-```
-
-No documentation written beforehand. No configuration required. One command.
+**AI-powered CLI tool** untuk generate dokumentasi teknis secara otomatis dari codebase yang sudah ada (legacy) atau tidak memiliki dokumentasi. Menggunakan parsing AST yang mendalam dikombinasikan dengan LLM (Groq, Gemini, Ollama, dll.) untuk menjelaskan struktur, logika, dan pola kode kamu.
 
 ---
 
-## Install
+## ⚡ Panduan Cepat (Step-by-Step)
 
+Ikuti urutan ini untuk membuat dokumentasi kamu siap dalam hitungan menit:
+
+### 1. Instalasi
+Instal package secara global melalui npm:
 ```bash
 npm install -g legacyver
 ```
+*Atau gunakan `npx legacyver` jika kamu tidak ingin menginstalnya secara global.*
 
-Or use without installing:
-
+### 2. Login (Cloud Sync)
+Masuk ke akun Legacyver kamu untuk mengaktifkan sinkronisasi cloud dan menyimpan dokumentasi di dashboard:
 ```bash
-npx legacyver analyze ./src
+legacyver login
 ```
 
----
-
-## Quick Start
-
-**1. Initialize (saves your API key):**
-
+### 3. Inisialisasi Konfigurasi
+Jalankan wizard setup untuk menyimpan API key (Groq, Gemini, dll.) dan membuat file konfigurasi `.legacyverrc`:
 ```bash
 legacyver init
 ```
 
-**2. Analyze a codebase:**
-
+### 4. Analisis & Generate
+Jalankan perintah utama untuk menganalisis folder project kamu:
 ```bash
-legacyver analyze ./src
-```
-
-**3. View the output:**
-
-```
-legacyver-docs/
-  index.md        ← project overview + dependency graph + route map (Laravel)
-  SUMMARY.md      ← GitBook/Docusaurus compatible table of contents
-  src/
-    app.md
-    routes/users.md
-    ...
+legacyver analyze ./src --incremental
 ```
+*Flag `--incremental` memastikan hanya file yang dimodifikasi yang akan diproses ulang di jalankan berikutnya (lebih cepat & hemat).*
 
 ---
 
-## CLI Commands
+## 🛠️ Daftar Perintah (CLI Commands)
 
-### `legacyver analyze <dir>`
+### `legacyver analyze [target]`
+Perintah utama untuk memindai codebase dan membuat dokumentasi.
 
-Run the full documentation pipeline.
-
-| Flag | Default | Description |
-|------|---------|-------------|
-| `--out <dir>` | `./legacyver-docs` | Output directory |
-| `--format <fmt>` | `markdown` | Output format: `markdown`, `html`, `json` |
-| `--provider <p>` | `openrouter` | LLM provider: `openrouter`, `ollama` |
-| `--model <id>` | `meta-llama/llama-3.3-70b-instruct:free` | Model ID |
-| `--incremental` | `false` | Skip files unchanged since last run |
-| `--dry-run` | `false` | Estimate cost without calling LLM |
-| `--concurrency <n>` | `3` | Max parallel LLM requests |
-| `--max-file-size <kb>` | `500` | Skip files larger than this |
-| `--no-confirm` | — | Skip cost confirmation prompt |
-| `--verbose` | `false` | Enable debug logging |
+| Flag | Default | Deskripsi |
+|------|---------|-----------|
+| `--out <dir>` | `./legacyver-docs` | Folder output hasil dokumentasi |
+| `--format <fmt>` | `markdown` | Format output: `markdown`, `html`, `json` |
+| `--provider <p>` | `groq` | Provider AI: `groq`, `gemini`, `ollama`, `openrouter` |
+| `--incremental` | `false` | Hanya proses file yang berubah (lebih cepat) |
+| `--dry-run` | `false` | Estimasi penggunaan token tanpa memanggil AI |
+| `--no-confirm` | — | Lewati konfirmasi estimasi biaya |
 
 ### `legacyver init`
-
-Interactive wizard. Detects existing `.legacyverrc` and warns before overwriting. Saves API key to OS user config.
+Wizard interaktif untuk setup API key dan preferensi lokal.
 
 ### `legacyver providers`
+Cek status API key dan daftar model AI yang tersedia.
 
-List all supported providers, API key status, and per-model pricing.
+### `legacyver login / logout`
+Kelola sesi untuk sinkronisasi dokumentasi ke cloud.
 
-### `legacyver cache clear`
+---
 
-Delete the `.legacyver-cache/` directory to force full re-analysis on next run.
+## 🏗️ Dukungan Framework & Bahasa
 
-### `legacyver --version`
+| Kategori | Item yang Didukung |
+|----------|--------------------|
+| **Bahasa** | JavaScript, TypeScript, PHP, Python, Java, Go |
+| **Framework** | **Laravel** (Deteksi Otomatis Routes, Models, ERD), **Express** |
+| **Integrasi** | GitHub Actions, GitBook, Docusaurus |
 
-Print the installed version.
+### 🐘 Integrasi Mendalam Laravel
+Jika file `artisan` terdeteksi, Legacyver otomatis mengekstrak:
+- **Route Maps**: Daftar lengkap method, URI, dan Controller.
+- **ER Diagrams**: Membuat diagram Mermaid otomatis untuk Model kamu.
+- **Service Providers**: Mendokumentasikan binding dependency yang kompleks.
 
 ---
 
-## `.legacyverrc` Schema
-
-Create a `.legacyverrc` (JSON or YAML) in your project root:
+## ⚙️ Konfigurasi (`.legacyverrc`)
+Sesuaikan alur kerja kamu dengan file konfigurasi:
 
 ```json
 {
-  "provider": "openrouter",
-  "model": "meta-llama/llama-3.3-70b-instruct:free",
+  "provider": "gemini",
+  "model": "gemini-1.5-flash",
   "format": "markdown",
-  "out": "./legacyver-docs",
-  "concurrency": 3,
-  "maxFileSizeKb": 500,
-  "incremental": true
+  "incremental": true,
+  "out": "./legacyver-docs"
 }
 ```
 
-All fields are optional. CLI flags override file config.
-
-Also supported: `legacyver.config.js`, `legacyver.config.yaml`.
-
----
-
-## Supported Languages
-
-| Language | Extensions | Framework Support |
-|----------|-----------|-------------------|
-| JavaScript | `.js`, `.jsx`, `.mjs` | Express (auto-detected) |
-| TypeScript | `.ts`, `.tsx` | — |
-| Python | `.py` | — |
-| Java | `.java` | — |
-| Go | `.go` | — |
-| PHP | `.php`, `.blade.php` | Laravel (auto-detected) |
-
-**Laravel extras:** When an `artisan` file is detected, Legacyver automatically extracts:
-- Route Map (Method, URI, Controller, Middleware, Route Name)
-- Model Relationships (as Mermaid `erDiagram`)
-- Service Provider Bindings
-
 ---
 
-## Supported LLM Providers
-
-| Provider | Env Var | Notes |
-|----------|---------|-------|
-| OpenRouter | `OPENROUTER_API_KEY` | Default. Free models available (`:free` suffix). Get a key at [openrouter.ai/keys](https://openrouter.ai/keys) |
-| Ollama | — | Local/offline. Requires Ollama running: `ollama serve` |
-
-**Free usage:** The default model `meta-llama/llama-3.3-70b-instruct:free` is free via OpenRouter (rate-limited). Legacyver automatically caps concurrency to 1 for free models.
-
----
-
-## Ignore Files
-
-Create a `.legacyverignore` in your project root using gitignore syntax:
-
-```
-# .legacyverignore
-dist/
-build/
-coverage/
-*.min.js
-```
-
-See `.legacyverignore.example` for a documented example.
-
----
-
-## CI/CD Integration
-
-```yaml
-# GitHub Actions example
-- name: Generate docs
-  env:
-    OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}
-  run: |
-    npx legacyver analyze ./src --no-confirm --incremental --out ./docs
-```
-
-Legacyver detects non-TTY environments and disables spinners/progress bars automatically (plain log output only).
-
----
-
-## How It Works
-
-1. **Crawl** — `fast-glob` walks the directory, respects `.legacyverignore`
-2. **Parse** — Regex/heuristic AST extracts facts: function names, params, complexity scores, imports, exports, call patterns
-3. **PKG** — Assembles a Project Knowledge Graph linking all facts
-4. **LLM** — Sends grounded facts + raw source to LLM; system prompt enforces anti-hallucination contract
-5. **Validate** — Post-generation checks: hallucination detection, completeness check (all exports documented)
-6. **Render** — Writes Markdown/HTML/JSON to output directory
-
-**Design principle:** The LLM is a _writer_, not an analyst. AST extracts facts; LLM only explains them.
-
----
-
-## Contributing
-
-```bash
-git clone https://github.com/user/legacyver
-npm install
-npx vitest run
-```
-
----
-
-## License
-
-MIT
+## 📄 Lisensi
+MIT License. Dibuat dengan ❤️ untuk developer yang berjuang melawan legacy code.

package/bin/legacyver.js

@@ -69,4 +69,12 @@ program
   .description('Log out and stop syncing docs to the cloud')
   .action(logoutCmd);
 
+// push command
+const pushCmd = require('../src/cli/commands/push');
+program
+  .command('push [target]')
+  .description('Manually push generated docs to the cloud database')
+  .option('--out <dir>', 'Docs output directory to read from', './legacyver-docs')
+  .action(pushCmd);
+
 program.parse(process.argv);

package/legacyver-docs/components.md

@@ -1,51 +1,50 @@
 ## Overview
-The components.tsx file contains a collection of reusable React components and a utility function for formatting currency. 
+This file contains React components and a utility function for formatting currency. The components include a Button and a UserCard.
 
 ## Functions
 ### Button
-The Button function is a React component that renders a button element with a specified label, click handler, and variant.
+The Button component is a React functional component that renders a button element.
 #### Parameters
-| Name | Type | Description |
+| Parameter | Type | Description |
 | --- | --- | --- |
-| label | string | The text displayed on the button |
-| onClick | () => void | The function called when the button is clicked |
-| disabled | boolean | Whether the button is disabled (optional, default: false) |
-| variant | 'primary' | 'secondary' | 'danger' | The style variant of the button (optional, default: 'primary') |
+| label | string | The text to display on the button |
+| onClick | () => void | The function to call when the button is clicked |
+| disabled | boolean | Optional, whether the button is disabled |
+| variant | 'primary' | 'secondary' | 'danger' | Optional, the style variant of the button |
 #### Return Value
-A React button element
+The Button component returns a JSX button element.
 
 ### UserCard
-The UserCard function is a React component that fetches and displays user data based on a provided user ID.
+The UserCard component is a React functional component that fetches user data and displays it in a card.
 #### Parameters
-| Name | Type | Description |
+| Parameter | Type | Description |
 | --- | --- | --- |
-| userId | number | The ID of the user to fetch and display |
-| onClose | () => void | The function called when the close button is clicked |
+| userId | number | The ID of the user to fetch |
+| onClose | () => void | The function to call when the close button is clicked |
 #### Return Value
-A React element containing the user's name, email, and a close button, or a loading indicator if the data is not yet available
+The UserCard component returns a JSX div element containing the user's data or a loading/error message.
 
 ### formatCurrency
-The formatCurrency function formats a given amount as a currency string.
+The formatCurrency function formats a number as a currency string.
 #### Parameters
-| Name | Type | Description |
+| Parameter | Type | Description |
 | --- | --- | --- |
 | amount | number | The amount to format |
-| currency | string | The currency to use for formatting (optional, default: 'USD') |
+| currency | string | Optional, the currency to use (default: 'USD') |
 #### Return Value
-A string representing the formatted amount
+The formatCurrency function returns a string representing the formatted currency amount.
 
 ## Dependencies
 * React
-* useState
-* useEffect
+* Intl.NumberFormat
 
 ## Usage Example
-No clear usage example is visible in the provided code, but the components can be used as follows:
+No clear usage example is visible in the provided code. However, components can be used as follows:
 ```jsx
 import { Button, UserCard, formatCurrency } from './components';
 
 const App = () => {
-  const handleButtonClick = () => {
+  const handleButtonClicked = () => {
     console.log('Button clicked');
   };
 
@@ -55,9 +54,9 @@ const App = () => {
 
   return (
     <div>
-      <Button label="Click me" onClick={handleButtonClick} />
-      <UserCard userId={123} onClose={handleUserCardClose} />
-      <p>Formatted amount: {formatCurrency(12345.67)}</p>
+      <Button label="Click me" onClick={handleButtonClicked} />
+      <UserCard userId={1} onClose={handleUserCardClose} />
+      <p>Formatted currency: {formatCurrency(1000)}</p>
     </div>
   );
 };

package/legacyver-docs/index.md

@@ -2,7 +2,7 @@
 
 **Primary language:** typescript  
 **Total files:** 1  
-**Analyzed at:** 2026-02-21T18:11:04.560Z  
+**Analyzed at:** 2026-02-22T03:13:37.724Z  
 
 ## Files
 

package/nul

@@ -0,0 +1 @@
+/usr/bin/bash: line 1: type: %USERPROFILE%\.legacyver\session.json: not found

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "legacyver",
-  "version": "2.1.7",
+  "version": "2.1.8",
   "description": "AI-powered CLI tool to auto-generate technical documentation from legacy/undocumented codebases",
   "main": "src/index.js",
   "bin": {

package/src/cli/commands/push.js

@@ -0,0 +1,99 @@
+'use strict';
+
+const path = require('path');
+const fs = require('fs');
+const pc = require('picocolors');
+const { loadSession } = require('../../utils/config');
+const logger = require('../../utils/logger');
+
+/**
+ * legacyver push [target]
+ *
+ * Manually push existing generated docs to the cloud database.
+ * Reads markdown files from the output directory (default: ./legacyver-docs)
+ * and pushes them as documentation pages.
+ *
+ * Useful when:
+ * - analyze ran but DB was down at that time
+ * - you want to re-push after fixing DB issues
+ * - you generated docs on a machine without login and want to push from another
+ */
+module.exports = async function pushCommand(target, options) {
+  const session = loadSession();
+  if (!session.token) {
+    console.log(pc.red('\n  Not logged in. Run ') + pc.cyan('legacyver login') + pc.red(' first.\n'));
+    process.exitCode = 1;
+    return;
+  }
+
+  const targetDir = path.resolve(target || '.');
+  const outDir = path.resolve(options.out || './legacyver-docs');
+
+  // Check if output directory exists
+  if (!fs.existsSync(outDir)) {
+    console.log(pc.red(`\n  Output directory not found: ${outDir}`));
+    console.log(pc.dim('  Run ') + pc.cyan('legacyver analyze') + pc.dim(' first to generate docs.\n'));
+    process.exitCode = 1;
+    return;
+  }
+
+  // Collect all .md files from the output directory
+  const fragments = [];
+  collectMarkdownFiles(outDir, outDir, fragments);
+
+  if (fragments.length === 0) {
+    console.log(pc.yellow('\n  No markdown files found in ') + pc.cyan(outDir));
+    console.log(pc.dim('  Run ') + pc.cyan('legacyver analyze') + pc.dim(' first to generate docs.\n'));
+    return;
+  }
+
+  console.log(pc.bold('\nLegacyver Push\n'));
+  console.log(pc.dim(`  Source:  ${targetDir}`));
+  console.log(pc.dim(`  Docs:   ${outDir}`));
+  console.log(pc.dim(`  Files:  ${fragments.length} markdown files\n`));
+
+  // Dynamically require ora for spinner
+  let spinner;
+  try {
+    const ora = require('ora');
+    spinner = ora('Pushing docs to cloud...').start();
+  } catch {
+    console.log('  Pushing docs to cloud...');
+    spinner = { succeed: (m) => console.log(pc.green('  ' + m)), fail: (m) => console.log(pc.red('  ' + m)) };
+  }
+
+  try {
+    const { pushToDatabase } = require('../../db/index');
+    const result = await pushToDatabase(fragments, targetDir);
+
+    if (result.skipped) {
+      spinner.fail('Push skipped — token may be invalid or expired. Try logging in again.');
+      process.exitCode = 1;
+    } else {
+      spinner.succeed(`Pushed ${result.pushed} files to cloud`);
+      console.log(pc.dim('\n  Docs are now visible on the web dashboard.\n'));
+    }
+  } catch (err) {
+    spinner.fail('Push failed: ' + err.message);
+    logger.error('Push error details:', err);
+    process.exitCode = 1;
+  }
+};
+
+/**
+ * Recursively collect .md files from a directory.
+ * Each file becomes a fragment with { relativePath, content }.
+ */
+function collectMarkdownFiles(baseDir, dir, results) {
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      collectMarkdownFiles(baseDir, fullPath, results);
+    } else if (entry.isFile() && entry.name.endsWith('.md')) {
+      const relativePath = path.relative(baseDir, fullPath);
+      const content = fs.readFileSync(fullPath, 'utf8');
+      results.push({ relativePath, content });
+    }
+  }
+}