Metadata-Version: 2.4
Name: docuson
Version: 0.1.0b1
Summary: AI-powered documentation engine for vibe coders
Project-URL: Homepage, https://github.com/docuson/docuson
Project-URL: Documentation, https://github.com/docuson/docuson#readme
Project-URL: Repository, https://github.com/docuson/docuson
Project-URL: Issues, https://github.com/docuson/docuson/issues
Author: Docuson Team
License-Expression: MIT
License-File: LICENSE
Keywords: ai,code-analysis,documentation,llm,tree-sitter,vibe-coding
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Documentation
Classifier: Topic :: Software Development :: Documentation
Requires-Python: >=3.10
Requires-Dist: aiofiles>=23.0
Requires-Dist: aiohttp>=3.9
Requires-Dist: anthropic>=0.40.0
Requires-Dist: chardet>=5.2
Requires-Dist: click>=8.0
Requires-Dist: gitpython>=3.1
Requires-Dist: httpx>=0.25
Requires-Dist: jinja2>=3.1
Requires-Dist: networkx>=3.2
Requires-Dist: openai>=1.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.0
Requires-Dist: tree-sitter-languages<1.11.0,>=1.9.0
Requires-Dist: tree-sitter<0.23.0,>=0.21.0
Provides-Extra: all
Requires-Dist: markdown-it-py>=3.0; extra == 'all'
Requires-Dist: playwright>=1.40; extra == 'all'
Requires-Dist: pygments>=2.17; extra == 'all'
Requires-Dist: pytest-asyncio>=0.23; extra == 'all'
Requires-Dist: pytest-cov>=4.1; extra == 'all'
Requires-Dist: pytest>=8.0; extra == 'all'
Requires-Dist: ruff>=0.3.0; extra == 'all'
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest-cov>=4.1; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.3.0; extra == 'dev'
Provides-Extra: html
Requires-Dist: markdown-it-py>=3.0; extra == 'html'
Requires-Dist: pygments>=2.17; extra == 'html'
Provides-Extra: pdf
Requires-Dist: playwright>=1.40; extra == 'pdf'
Description-Content-Type: text/markdown

# Docuson

**AI-Powered Documentation Engine for Vibe Coders**

Docuson scans your codebase and generates complete, professional documentation in minutes — architecture diagrams, API references, security audits, database schemas, and more. One command. Works with code generated by Cursor, GitHub Copilot, Claude Code, and any AI coding tool.

## Why Docuson

- **41% of all code is now AI-generated** (GitHub, 2025) — but nobody documents it
- **2.7x more vulnerabilities** in AI-generated code vs human-written (Veracode)
- **69% of developers lose 8+ hours weekly** to poor documentation

Docuson is the documentation layer between you and your AI-generated code.

## Installation

```bash
pip install docuson
```

## Quick Start

```bash
# Initialize in your project
docuson init

# Scan your codebase (free, no API calls)
docuson scan

# Generate full documentation
docuson generate

# Preview the HTML docs locally
docuson serve
```

## What Docuson Generates

### 9 Specialized Analysis Passes

| Pass | What It Covers |
|------|---------------|
| Architecture | System overview, tech stack, design patterns, project structure |
| Data Layer | Database schema, ER diagrams, ORM analysis, migrations |
| API Layer | All endpoints, middleware, request/response schemas |
| Business Logic | Features, user flows, business rules, state machines |
| Frontend | Component hierarchy, state management, routing |
| Security | Auth system, vulnerabilities, secrets, OWASP flags |
| Infrastructure | Docker, CI/CD, deployment, monitoring |
| Cross-cutting | Error handling, logging, caching, config |
| Synthesis | Executive summary, health score, setup guide, glossary |

### Dual-View Output

- **Business View** — Plain English for founders, PMs, investors
- **Developer View** — Technical deep-dive with code references

### Output Formats

- Markdown (default)
- HTML site with search, dark mode, sidebar navigation
- PDF with cover page, TOC, diagrams

## Supported Languages (30+)

TypeScript, JavaScript, Python, Java, Kotlin, Go, Rust, Ruby, PHP, C#, Swift, Dart, C/C++, Scala, Elixir, and more — powered by Tree-sitter AST parsing.

## Supported Frameworks (20+)

Next.js, React, FastAPI, Django, Flask, Express, Spring Boot, Rails, Laravel, Flutter, Gin, Actix-web, ASP.NET, Ktor, Nuxt, SvelteKit, Remix, Angular, Vue, and more.

## All CLI Commands

```
docuson init          # Initialize in a project
docuson scan          # Scan codebase (free, no API)
docuson generate      # Generate documentation
docuson serve         # Preview HTML docs locally
docuson status        # Show documentation status
docuson diff          # Show changes since last generation
docuson usage         # Show token usage and budget
docuson github <url>  # Document a GitHub repo
docuson assist        # Live Assistant (real-time code notes)
docuson mcp-serve     # Start MCP server for AI tool integration
docuson config show   # Show configuration
```

## VS Code Extension

Install the Docuson extension for VS Code / Cursor:
- Generate docs from the command palette
- Status bar showing documentation state
- Live Assistant with inline diagnostics
- Sidebar with project status and quick actions

## MCP Server (AI Tool Integration)

Docuson exposes project knowledge via MCP so Claude Code, Copilot, and other AI tools can query your docs:

```json
{
  "mcpServers": {
    "docuson": {
      "command": "docuson",
      "args": ["mcp-serve", "--path", "/your/project"]
    }
  }
}
```

## Configuration

```bash
# Set your Anthropic API key
export DOCUSON_API_KEY=sk-ant-...

# Or configure interactively
docuson config set-key
```

Configuration lives in `.docuson/config.yaml`. See `docuson config show` for current settings.

## Requirements

- Python 3.10+
- Anthropic API key (for `generate` command — `scan` is free)

## License

MIT
