repowise 0.1.0__tar.gz

repowise-0.1.0/MANIFEST.in

@@ -0,0 +1,2 @@
+recursive-include packages/core/src/repowise/core/ingestion/queries *.scm
+recursive-include packages/core/src/repowise/core/generation/templates *.j2

repowise-0.1.0/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.4
+Name: repowise
+Version: 0.1.0
+Summary: Codebase intelligence for developers and AI — generates and maintains a structured wiki for any codebase
+License-Expression: AGPL-3.0-only
+Project-URL: Homepage, https://repowise.dev
+Project-URL: Repository, https://github.com/repowise-ai/repowise
+Project-URL: Issues, https://github.com/repowise-ai/repowise/issues
+Project-URL: Documentation, https://docs.repowise.dev
+Keywords: documentation,codebase,wiki,llm,ai,mcp
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Environment :: Console
+Classifier: Framework :: FastAPI
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: httpx<1,>=0.27
+Requires-Dist: tree-sitter<1,>=0.23
+Requires-Dist: tree-sitter-python<1,>=0.23
+Requires-Dist: tree-sitter-typescript<1,>=0.23
+Requires-Dist: tree-sitter-javascript<1,>=0.23
+Requires-Dist: tree-sitter-go<1,>=0.23
+Requires-Dist: tree-sitter-rust<1,>=0.23
+Requires-Dist: tree-sitter-java<1,>=0.23
+Requires-Dist: tree-sitter-cpp<1,>=0.23
+Requires-Dist: networkx<4,>=3.3
+Requires-Dist: scipy<2,>=1.11
+Requires-Dist: jinja2<4,>=3.1
+Requires-Dist: pathspec<1,>=0.12
+Requires-Dist: structlog<25,>=24
+Requires-Dist: sqlalchemy[asyncio]<3,>=2.0
+Requires-Dist: aiosqlite<1,>=0.20
+Requires-Dist: alembic<2,>=1.13
+Requires-Dist: pydantic<3,>=2.8
+Requires-Dist: tenacity<10,>=9
+Requires-Dist: gitpython<4,>=3.1
+Requires-Dist: pyyaml<7,>=6.0
+Requires-Dist: lancedb<1,>=0.12
+Requires-Dist: click<9,>=8.1
+Requires-Dist: rich<14,>=13
+Requires-Dist: watchdog<5,>=4
+Requires-Dist: fastapi<1,>=0.115
+Requires-Dist: uvicorn[standard]<1,>=0.32
+Requires-Dist: mcp<2,>=1.0
+Requires-Dist: apscheduler<4,>=3.10
+Requires-Dist: cryptography<44,>=43
+Provides-Extra: anthropic
+Requires-Dist: anthropic<1,>=0.40; extra == "anthropic"
+Provides-Extra: openai
+Requires-Dist: openai<2,>=1.50; extra == "openai"
+Provides-Extra: gemini
+Requires-Dist: google-genai<2,>=1.0; extra == "gemini"
+Provides-Extra: litellm
+Requires-Dist: litellm<2,>=1.50; extra == "litellm"
+Provides-Extra: postgres
+Requires-Dist: pgvector<1,>=0.3; extra == "postgres"
+Requires-Dist: asyncpg<1,>=0.29; extra == "postgres"
+Provides-Extra: all
+Requires-Dist: repowise[anthropic,gemini,litellm,openai,postgres]; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest<9,>=8; extra == "dev"
+Requires-Dist: pytest-asyncio<1,>=0.23; extra == "dev"
+Requires-Dist: pytest-snapshot<1,>=0.9; extra == "dev"
+Requires-Dist: respx<1,>=0.21; extra == "dev"
+Requires-Dist: time-machine<3,>=2.14; extra == "dev"
+Requires-Dist: ruff<1,>=0.6; extra == "dev"
+Requires-Dist: mypy<2,>=1.11; extra == "dev"
+Requires-Dist: types-networkx<4,>=3.3; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+
+# repowise
+
+**Codebase intelligence for developers and AI.**
+
+repowise generates and maintains a structured, hierarchical wiki for any codebase.
+It keeps documentation accurate as code changes and exposes everything through an
+MCP server so AI coding assistants can query it in real time.
+
+## Features
+
+- **Automatic documentation** — generates module, file, and symbol-level docs from source code
+- **Git intelligence** — tracks churn hotspots, ownership, and change patterns
+- **Dead code detection** — finds confirmed unused exports, functions, and types
+- **Decision intelligence** — captures *why* code is structured the way it is
+- **MCP server** — 8 tools for AI assistants (Claude Code, Cursor, Windsurf, etc.)
+- **REST API + Web UI** — browse the wiki, search, and explore architecture diagrams
+- **Multi-language** — Python, TypeScript, JavaScript, Go, Rust, Java, C/C++, Kotlin, Ruby
+
+## Install
+
+```bash
+pip install repowise
+```
+
+LLM providers are optional — install only the one you need:
+
+```bash
+pip install "repowise[anthropic]"    # Claude models
+pip install "repowise[openai]"       # GPT models
+pip install "repowise[gemini]"       # Gemini models
+pip install "repowise[litellm]"      # 100+ providers via LiteLLM
+pip install "repowise[all]"          # Everything
+```
+
+## Quick Start
+
+```bash
+# Generate documentation for your codebase
+repowise init --provider anthropic --model claude-sonnet-4-6
+
+# Keep docs in sync after code changes
+repowise update
+
+# Start the MCP server for AI assistants
+repowise mcp
+
+# Launch the web UI
+repowise serve
+```
+
+## How It Works
+
+1. **Ingestion** — parses every file using tree-sitter, extracts symbols, imports, and builds a dependency graph
+2. **Analysis** — computes git signals (churn, ownership, recency), detects dead code, identifies architectural decisions
+3. **Generation** — sends structured prompts to an LLM to produce wiki pages at every level of the hierarchy
+4. **Persistence** — stores everything in SQLite (or PostgreSQL) with full-text and vector search
+5. **Serving** — exposes the wiki through REST API, MCP server, and web UI
+
+## Requirements
+
+- Python 3.11+
+- Git (for repository analysis)
+- An LLM API key (for documentation generation — not needed for analysis-only mode)
+
+## Documentation
+
+- [Architecture Guide](docs/ARCHITECTURE.md)
+- [CLI Reference](packages/cli/README.md)
+- [Server & MCP Tools](packages/server/README.md)
+- [Core Library](packages/core/README.md)
+
+## License
+
+AGPL-3.0 — see [LICENSE](LICENSE) for details.

repowise-0.1.0/README.md

@@ -0,0 +1,74 @@
+# repowise
+
+**Codebase intelligence for developers and AI.**
+
+repowise generates and maintains a structured, hierarchical wiki for any codebase.
+It keeps documentation accurate as code changes and exposes everything through an
+MCP server so AI coding assistants can query it in real time.
+
+## Features
+
+- **Automatic documentation** — generates module, file, and symbol-level docs from source code
+- **Git intelligence** — tracks churn hotspots, ownership, and change patterns
+- **Dead code detection** — finds confirmed unused exports, functions, and types
+- **Decision intelligence** — captures *why* code is structured the way it is
+- **MCP server** — 8 tools for AI assistants (Claude Code, Cursor, Windsurf, etc.)
+- **REST API + Web UI** — browse the wiki, search, and explore architecture diagrams
+- **Multi-language** — Python, TypeScript, JavaScript, Go, Rust, Java, C/C++, Kotlin, Ruby
+
+## Install
+
+```bash
+pip install repowise
+```
+
+LLM providers are optional — install only the one you need:
+
+```bash
+pip install "repowise[anthropic]"    # Claude models
+pip install "repowise[openai]"       # GPT models
+pip install "repowise[gemini]"       # Gemini models
+pip install "repowise[litellm]"      # 100+ providers via LiteLLM
+pip install "repowise[all]"          # Everything
+```
+
+## Quick Start
+
+```bash
+# Generate documentation for your codebase
+repowise init --provider anthropic --model claude-sonnet-4-6
+
+# Keep docs in sync after code changes
+repowise update
+
+# Start the MCP server for AI assistants
+repowise mcp
+
+# Launch the web UI
+repowise serve
+```
+
+## How It Works
+
+1. **Ingestion** — parses every file using tree-sitter, extracts symbols, imports, and builds a dependency graph
+2. **Analysis** — computes git signals (churn, ownership, recency), detects dead code, identifies architectural decisions
+3. **Generation** — sends structured prompts to an LLM to produce wiki pages at every level of the hierarchy
+4. **Persistence** — stores everything in SQLite (or PostgreSQL) with full-text and vector search
+5. **Serving** — exposes the wiki through REST API, MCP server, and web UI
+
+## Requirements
+
+- Python 3.11+
+- Git (for repository analysis)
+- An LLM API key (for documentation generation — not needed for analysis-only mode)
+
+## Documentation
+
+- [Architecture Guide](docs/ARCHITECTURE.md)
+- [CLI Reference](packages/cli/README.md)
+- [Server & MCP Tools](packages/server/README.md)
+- [Core Library](packages/core/README.md)
+
+## License
+
+AGPL-3.0 — see [LICENSE](LICENSE) for details.

repowise-0.1.0/packages/cli/src/repowise/cli/__init__.py

@@ -0,0 +1,9 @@
+"""repowise CLI package.
+
+Entry point: ``repowise`` command (defined in repowise.cli.main).
+Codebase intelligence for developers and AI — dependency graphs,
+git signals, dead code detection, architectural decisions, and
+AI-generated documentation.
+"""
+
+__version__ = "0.1.0"

repowise-0.1.0/packages/cli/src/repowise/cli/commands/__init__.py

@@ -0,0 +1 @@
+"""CLI command modules."""

repowise-0.1.0/packages/cli/src/repowise/cli/commands/claude_md_cmd.py

@@ -0,0 +1,103 @@
+"""repowise generate-claude-md — generate/update CLAUDE.md for a repository."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import click
+
+from repowise.cli.helpers import (
+    ensure_repowise_dir,
+    get_db_url_for_repo,
+    run_async,
+)
+
+
+@click.command("generate-claude-md")
+@click.argument("path", required=False, default=None)
+@click.option(
+    "--output",
+    "output_path",
+    default=None,
+    metavar="FILE",
+    help="Write to a custom path (default: CLAUDE.md in the repo root).",
+)
+@click.option(
+    "--stdout",
+    "to_stdout",
+    is_flag=True,
+    default=False,
+    help="Print generated content to stdout instead of writing a file.",
+)
+def claude_md_command(
+    path: str | None,
+    output_path: str | None,
+    to_stdout: bool,
+) -> None:
+    """Generate or update CLAUDE.md with codebase intelligence context.
+
+    PATH defaults to the current directory.
+
+    The file is split into two sections:
+      - Your custom instructions (above the REPOWISE markers) — never modified.
+      - Repowise-managed section (between markers) — auto-updated from the index.
+
+    Run 'repowise init' or 'repowise update' to keep it current automatically.
+    """
+    repo_path = Path(path).resolve() if path else Path.cwd()
+    ensure_repowise_dir(repo_path)
+
+    try:
+        content = run_async(_generate(repo_path, output_path, to_stdout))
+    except Exception as exc:  # noqa: BLE001
+        raise click.ClickException(str(exc)) from exc
+
+    if to_stdout:
+        click.echo(content, nl=False)
+
+
+async def _generate(
+    repo_path: Path,
+    output_path: str | None,
+    to_stdout: bool,
+) -> str | None:
+    from repowise.core.generation.editor_files import ClaudeMdGenerator, EditorFileDataFetcher
+    from repowise.core.persistence import (
+        create_engine,
+        create_session_factory,
+        get_session,
+        init_db,
+    )
+    from repowise.core.persistence.crud import get_repository_by_path
+
+    url = get_db_url_for_repo(repo_path)
+    engine = create_engine(url)
+    await init_db(engine)
+    sf = create_session_factory(engine)
+
+    try:
+        async with get_session(sf) as session:
+            repo = await get_repository_by_path(session, str(repo_path))
+            if repo is None:
+                raise click.ClickException(
+                    f"Repository not found in index. Run 'repowise init' first."
+                )
+            fetcher = EditorFileDataFetcher(session, repo.id, repo_path)
+            data = await fetcher.fetch()
+    finally:
+        await engine.dispose()
+
+    gen = ClaudeMdGenerator()
+
+    if to_stdout:
+        return gen.render_full(repo_path, data)
+
+    dest = Path(output_path).resolve() if output_path else None
+    written = gen.write(dest.parent if dest else repo_path, data)
+    if dest and dest != written:
+        # Custom output path differs from default filename in same dir
+        written.rename(dest)
+        written = dest
+
+    click.echo(f"CLAUDE.md updated: {written}")
+    return None

repowise-0.1.0/packages/cli/src/repowise/cli/commands/dead_code_cmd.py

@@ -0,0 +1,143 @@
+"""``repowise dead-code`` — detect dead and unused code."""
+
+from __future__ import annotations
+
+import json
+
+import click
+from rich.table import Table
+
+from repowise.cli.helpers import (
+    console,
+    resolve_repo_path,
+    run_async,
+)
+
+
+@click.command("dead-code")
+@click.argument("path", required=False, type=click.Path(exists=True))
+@click.option("--min-confidence", default=0.4, type=float, help="Minimum confidence threshold.")
+@click.option("--safe-only", is_flag=True, help="Only show safe_to_delete=True findings.")
+@click.option(
+    "--kind",
+    type=click.Choice(["unreachable_file", "unused_export", "unused_internal", "zombie_package"]),
+    help="Filter by finding kind.",
+)
+@click.option(
+    "--format",
+    "fmt",
+    default="table",
+    type=click.Choice(["table", "json", "md"]),
+    help="Output format.",
+)
+def dead_code_command(
+    path: str | None,
+    min_confidence: float,
+    safe_only: bool,
+    kind: str | None,
+    fmt: str,
+) -> None:
+    """Detect dead and unused code."""
+    from pathlib import Path as PathlibPath
+
+    from repowise.core.analysis.dead_code import DeadCodeAnalyzer
+    from repowise.core.ingestion import ASTParser, FileTraverser, GraphBuilder
+
+    repo_path = resolve_repo_path(path)
+
+    console.print(f"[bold]repowise dead-code[/bold] — {repo_path}")
+
+    # Ingest
+    traverser = FileTraverser(repo_path)
+    file_infos = list(traverser.traverse())
+    parser = ASTParser()
+    graph_builder = GraphBuilder()
+
+    for fi in file_infos:
+        try:
+            source = PathlibPath(fi.abs_path).read_bytes()
+            parsed = parser.parse_file(fi, source)
+            graph_builder.add_file(parsed)
+        except Exception:
+            pass
+    graph_builder.build()
+
+    # Git metadata (best effort)
+    git_meta_map: dict = {}
+    try:
+        from repowise.core.ingestion.git_indexer import GitIndexer
+
+        git_indexer = GitIndexer(repo_path)
+        _, metadata_list = run_async(git_indexer.index_repo(""))
+        git_meta_map = {m["file_path"]: m for m in metadata_list}
+    except Exception:
+        pass
+
+    # Analyze
+    config = {"min_confidence": min_confidence}
+    if kind:
+        # Enable only the requested kind
+        config["detect_unreachable_files"] = kind == "unreachable_file"
+        config["detect_unused_exports"] = kind == "unused_export"
+        config["detect_unused_internals"] = kind == "unused_internal"
+        config["detect_zombie_packages"] = kind == "zombie_package"
+
+    analyzer = DeadCodeAnalyzer(graph_builder.graph(), git_meta_map)
+    report = analyzer.analyze(config)
+
+    findings = report.findings
+    if safe_only:
+        findings = [f for f in findings if f.safe_to_delete]
+
+    if fmt == "json":
+        output = []
+        for f in findings:
+            output.append({
+                "kind": f.kind.value,
+                "file_path": f.file_path,
+                "symbol_name": f.symbol_name,
+                "confidence": f.confidence,
+                "reason": f.reason,
+                "safe_to_delete": f.safe_to_delete,
+                "lines": f.lines,
+                "primary_owner": f.primary_owner,
+            })
+        click.echo(json.dumps(output, indent=2))
+        return
+
+    if fmt == "md":
+        click.echo(f"# Dead Code Report\n")
+        click.echo(f"**Total findings:** {len(findings)}")
+        click.echo(f"**Deletable lines:** {report.deletable_lines}\n")
+        for f in findings:
+            safe = " (safe to remove)" if f.safe_to_delete else ""
+            name = f"`{f.symbol_name}`" if f.symbol_name else f"`{f.file_path}`"
+            click.echo(f"- [{f.kind.value}] {name} — {f.reason} ({f.confidence:.0%}){safe}")
+        return
+
+    # Table format (default)
+    table = Table(title=f"Dead Code ({len(findings)} findings)")
+    table.add_column("Kind", style="cyan")
+    table.add_column("File / Symbol")
+    table.add_column("Confidence", justify="right")
+    table.add_column("Safe?", justify="center")
+    table.add_column("Lines", justify="right")
+    table.add_column("Reason")
+
+    for f in findings:
+        name = f.symbol_name or f.file_path
+        safe = "[green]✓[/green]" if f.safe_to_delete else "[red]✗[/red]"
+        table.add_row(
+            f.kind.value,
+            name,
+            f"{f.confidence:.0%}",
+            safe,
+            str(f.lines),
+            f.reason[:60],
+        )
+
+    console.print(table)
+    console.print(
+        f"\nDeletable lines: [bold]{report.deletable_lines:,}[/bold] "
+        f"(confidence: {report.confidence_summary})"
+    )