Metadata-Version: 2.4
Name: talocode-archwiki
Version: 0.2.0
Summary: Turn any codebase into a visual architecture wiki for humans and agents
Author: Talocode
License: MIT
Keywords: architecture,wiki,codebase,visualization,talocode
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# Talocode ArchWiki

Turn any codebase into a visual architecture wiki for humans and agents.

## What it does

Scans a repo, detects routes/services/auth/database/build patterns, and generates:

- **architecture.json** — machine-readable graph for agents
- **architecture.html** — interactive dark visual wiki for humans

## Install

```bash
pip install talocode-archwiki
```

## Usage

```bash
# Scan current directory
archwiki .

# Scan specific repo
archwiki /path/to/repo

# Specify output directory
archwiki /path/to/repo /path/to/output
```

## Python SDK

```python
from archwiki import scan

result = scan("/path/to/repo")
print(result["json"]["stats"])
# {"total_files": 86, "total_nodes": 31, "total_edges": 0, "total_flows": 2}
```

## Output

### architecture.json

Machine-readable graph with nodes, edges, and flows:

```json
{
  "name": "my-app",
  "nodes": [
    {
      "id": "route_src/routes.ts",
      "name": "routes",
      "type": "route",
      "file": "src/routes.ts",
      "description": "route in routes.ts",
      "code_ref": "app.get('/api/users', ...)"
    }
  ],
  "flows": [
    {
      "id": "api_request",
      "name": "API Request",
      "steps": [...]
    }
  ]
}
```

### architecture.html

Interactive dark visual wiki with:

- Flow visualization (nodes + connections)
- Right sidebar (Flows + Steps)
- Click a node → see code reference
- Click a flow → see numbered steps
- Dark charcoal + gold accent design

## Talocode ecosystem

| Package | Install |
|---------|---------|
| ArchWiki (this package) | `pip install talocode-archwiki` |
| [Wiki](https://github.com/talocode/wiki) | `pip install talocode-wiki` |
| [DocuLane](https://github.com/talocode/doculane) | `pip install talocode-doculane` |
| [CodeLane](https://github.com/talocode/codelane) | `pip install talocode-codrane` |
| [XSearchLane](https://github.com/talocode/xsearchlane) | `npm i @talocode/xsearchlane` |
| [Tera](https://github.com/talocode/tera) | `pip install talocode-tera` |
| [Codra](https://github.com/talocode/codra) | `pip install talocode-codra` |
| [StackLane](https://github.com/talocode/stacklane) | `pip install talocode` |

More: [github.com/talocode](https://github.com/talocode) · [talocode.site](https://talocode.site) · [docs.talocode.site](https://docs.talocode.site)

## License

MIT © Talocode
