simplicio-mapper 0.7.1__tar.gz → 0.7.2__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {simplicio_mapper-0.7.1 → simplicio_mapper-0.7.2}/CHANGELOG.md +7 -0
- {simplicio_mapper-0.7.1 → simplicio_mapper-0.7.2}/PKG-INFO +4 -1
- {simplicio_mapper-0.7.1 → simplicio_mapper-0.7.2}/PYPI.md +3 -0
- simplicio_mapper-0.7.2/README.md +105 -0
- simplicio_mapper-0.7.2/README.pt-BR.md +105 -0
- simplicio_mapper-0.7.2/READMEs/README.ar-SA.md +104 -0
- simplicio_mapper-0.7.2/READMEs/README.en.md +105 -0
- simplicio_mapper-0.7.2/READMEs/README.es-ES.md +104 -0
- simplicio_mapper-0.7.2/READMEs/README.fr-FR.md +104 -0
- simplicio_mapper-0.7.2/READMEs/README.he-IL.md +104 -0
- simplicio_mapper-0.7.2/READMEs/README.hi-IN.md +104 -0
- simplicio_mapper-0.7.2/READMEs/README.id-ID.md +104 -0
- simplicio_mapper-0.7.2/READMEs/README.it-IT.md +104 -0
- simplicio_mapper-0.7.2/READMEs/README.ja-JP.md +104 -0
- simplicio_mapper-0.7.2/READMEs/README.ko-KR.md +104 -0
- simplicio_mapper-0.7.2/READMEs/README.ms-MY.md +104 -0
- simplicio_mapper-0.7.2/READMEs/README.pl-PL.md +104 -0
- simplicio_mapper-0.7.2/READMEs/README.pt-BR.md +105 -0
- simplicio_mapper-0.7.2/READMEs/README.ru-RU.md +104 -0
- simplicio_mapper-0.7.2/READMEs/README.zh-CN.md +104 -0
- {simplicio_mapper-0.7.1 → simplicio_mapper-0.7.2}/pyproject.toml +3 -1
- {simplicio_mapper-0.7.1 → simplicio_mapper-0.7.2}/simplicio_mapper/__init__.py +1 -1
- simplicio_mapper-0.7.1/README.md +0 -471
- simplicio_mapper-0.7.1/README.pt-BR.md +0 -442
- {simplicio_mapper-0.7.1 → simplicio_mapper-0.7.2}/.catalog/README.md +0 -0
- {simplicio_mapper-0.7.1 → simplicio_mapper-0.7.2}/.gitignore +0 -0
- {simplicio_mapper-0.7.1 → simplicio_mapper-0.7.2}/LICENSE +0 -0
- {simplicio_mapper-0.7.1 → simplicio_mapper-0.7.2}/SIMPLICIO_INTEGRATION.md +0 -0
- {simplicio_mapper-0.7.1 → simplicio_mapper-0.7.2}/docs-site/README.md +0 -0
- {simplicio_mapper-0.7.1 → simplicio_mapper-0.7.2}/rust/README.md +0 -0
- {simplicio_mapper-0.7.1 → simplicio_mapper-0.7.2}/rust/pyproject.toml +0 -0
- {simplicio_mapper-0.7.1 → simplicio_mapper-0.7.2}/simplicio_mapper/_native.py +0 -0
- {simplicio_mapper-0.7.1 → simplicio_mapper-0.7.2}/simplicio_mapper/cache.py +0 -0
- {simplicio_mapper-0.7.1 → simplicio_mapper-0.7.2}/simplicio_mapper/cli.py +0 -0
- {simplicio_mapper-0.7.1 → simplicio_mapper-0.7.2}/simplicio_mapper/mapper.py +0 -0
- {simplicio_mapper-0.7.1 → simplicio_mapper-0.7.2}/simplicio_mapper/models.py +0 -0
- {simplicio_mapper-0.7.1 → simplicio_mapper-0.7.2}/video/README.md +0 -0
- {simplicio_mapper-0.7.1 → simplicio_mapper-0.7.2}/vscode-extension/LICENSE +0 -0
- {simplicio_mapper-0.7.1 → simplicio_mapper-0.7.2}/vscode-extension/README.md +0 -0
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## [0.7.2] - 2026-06-01
|
|
4
|
+
|
|
5
|
+
### Changed
|
|
6
|
+
- Rebuilt the README as a multilingual growth page inspired by Understand Anything and 50k+ star repository patterns.
|
|
7
|
+
- Added canonical translations under `READMEs/` for the full Simplicio language set and documented the new README globalization standard.
|
|
8
|
+
- Included the translations and globalization standard in package source metadata.
|
|
9
|
+
|
|
3
10
|
All notable changes to **LLM Project Mapper** are documented in this file.
|
|
4
11
|
|
|
5
12
|
Format follows [Keep a Changelog 1.1.0](https://keepachangelog.com/en/1.1.0/) and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: simplicio-mapper
|
|
3
|
-
Version: 0.7.
|
|
3
|
+
Version: 0.7.2
|
|
4
4
|
Summary: Python-first project mapper that emits .simplicio/project-map.json and precedent-index.json for the Simplicio ecosystem.
|
|
5
5
|
Project-URL: Homepage, https://github.com/wesleysimplicio/simplicio-mapper
|
|
6
6
|
Project-URL: Repository, https://github.com/wesleysimplicio/simplicio-mapper
|
|
@@ -47,6 +47,9 @@ Description-Content-Type: text/markdown
|
|
|
47
47
|
|
|
48
48
|
# simplicio-mapper
|
|
49
49
|
|
|
50
|
+
> README globalization release: the GitHub README now ships with 15 language entry points, Star History, ecosystem graph, and a proof-first structure. The package contract below remains the canonical PyPI technical reference.
|
|
51
|
+
|
|
52
|
+
|
|
50
53
|
Python-first project mapper for the Simplicio ecosystem. It scans a repository
|
|
51
54
|
and emits machine-readable artifacts that agents and tooling can consume
|
|
52
55
|
without parsing the human-readable markdown docs:
|
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
# simplicio-mapper
|
|
2
2
|
|
|
3
|
+
> README globalization release: the GitHub README now ships with 15 language entry points, Star History, ecosystem graph, and a proof-first structure. The package contract below remains the canonical PyPI technical reference.
|
|
4
|
+
|
|
5
|
+
|
|
3
6
|
Python-first project mapper for the Simplicio ecosystem. It scans a repository
|
|
4
7
|
and emits machine-readable artifacts that agents and tooling can consume
|
|
5
8
|
without parsing the human-readable markdown docs:
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
<h1 align="center">simplicio-mapper</h1>
|
|
2
|
+
|
|
3
|
+
<p align="center">
|
|
4
|
+
<strong>Map any repository into AI-readable context: project map, precedent index, architecture inventory, symbol index, call graph, and docs.</strong><br />
|
|
5
|
+
<em>Commands stay in English so they can be copied exactly.</em><br />
|
|
6
|
+
<a href="https://wesleysimplicio.github.io/llm-project-mapper/">Live docs: wesleysimplicio.github.io/llm-project-mapper</a>
|
|
7
|
+
</p>
|
|
8
|
+
|
|
9
|
+
<p align="center">
|
|
10
|
+
<a href="https://github.com/wesleysimplicio/simplicio-mapper/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/wesleysimplicio/simplicio-mapper?style=flat-square" /></a>
|
|
11
|
+
<a href="https://pypi.org/project/simplicio-mapper/"><img alt="PyPI" src="https://img.shields.io/pypi/v/simplicio-mapper.svg?style=flat-square" /></a>
|
|
12
|
+
<a href="https://www.npmjs.com/package/@wesleysimplicio/llm-project-mapper"><img alt="npm" src="https://img.shields.io/npm/v/%40wesleysimplicio%2Fllm-project-mapper.svg?style=flat-square" /></a>
|
|
13
|
+
<a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/license-MIT-yellow?style=flat-square" /></a>
|
|
14
|
+
</p>
|
|
15
|
+
|
|
16
|
+
<p align="center">
|
|
17
|
+
<a href="README.md">English</a> | <a href="READMEs/README.pt-BR.md">Português</a> | <a href="READMEs/README.es-ES.md">Español</a> | <a href="READMEs/README.ja-JP.md">日本語</a> | <a href="READMEs/README.ko-KR.md">한국어</a> | <a href="READMEs/README.zh-CN.md">简体中文</a> | <a href="READMEs/README.it-IT.md">Italiano</a> | <a href="READMEs/README.fr-FR.md">Français</a> | <a href="READMEs/README.ru-RU.md">Русский</a> | <a href="READMEs/README.pl-PL.md">Polski</a> | <a href="READMEs/README.hi-IN.md">हिन्दी</a> | <a href="READMEs/README.ar-SA.md">العربية</a> | <a href="READMEs/README.he-IL.md">עברית</a> | <a href="READMEs/README.ms-MY.md">Bahasa Melayu</a> | <a href="READMEs/README.id-ID.md">Bahasa Indonesia</a>
|
|
18
|
+
</p>
|
|
19
|
+
|
|
20
|
+
<p align="center">
|
|
21
|
+
<img src="assets/llm-project-mapper-hero.png" alt="simplicio-mapper preview" width="860" />
|
|
22
|
+
</p>
|
|
23
|
+
|
|
24
|
+
<p align="center">
|
|
25
|
+
<img src="assets/overlay-install.svg" alt="Overlay install flow" width="860" />
|
|
26
|
+
</p>
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## The short version
|
|
31
|
+
|
|
32
|
+
Map any repository into AI-readable context: project map, precedent index, architecture inventory, symbol index, call graph, and docs.
|
|
33
|
+
|
|
34
|
+
## Quick Start
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
pip install -U simplicio-mapper
|
|
38
|
+
simplicio-mapper index . --json
|
|
39
|
+
simplicio-mapper docs . --json
|
|
40
|
+
simplicio-mapper endpoints ./web --against ./api --json
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
## What it does
|
|
44
|
+
|
|
45
|
+
- Generates versioned .simplicio artifacts agents can read before planning.
|
|
46
|
+
- Works as both Python CLI and npm starter package.
|
|
47
|
+
- Builds architecture, symbol and call graph artifacts without forcing a framework.
|
|
48
|
+
- Exports markdown docs for wiki/review workflows while keeping remote publishing opt-in.
|
|
49
|
+
|
|
50
|
+
## Why this README is built to earn attention
|
|
51
|
+
|
|
52
|
+
- clear first-screen promise
|
|
53
|
+
- language links before installation
|
|
54
|
+
- badges and a visual hero for fast trust
|
|
55
|
+
- copy-ready quick start
|
|
56
|
+
- proof before long reference material
|
|
57
|
+
- star history for social proof
|
|
58
|
+
|
|
59
|
+
## How it works
|
|
60
|
+
|
|
61
|
+
```mermaid
|
|
62
|
+
flowchart LR
|
|
63
|
+
mapper["simplicio-mapper
|
|
64
|
+
repo context"] --> current["simplicio-mapper
|
|
65
|
+
this project"]
|
|
66
|
+
prompt["simplicio-prompt
|
|
67
|
+
reasoning runtime"] --> current
|
|
68
|
+
current --> evidence["validated evidence
|
|
69
|
+
tests, docs, screenshots"]
|
|
70
|
+
current --> sprint["simplicio-sprint
|
|
71
|
+
delivery loop"]
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
## Proof and validation
|
|
75
|
+
|
|
76
|
+
- Current local mapper version is 0.7.x with background indexing and docs-only modes.
|
|
77
|
+
- This repo is the canonical standard for visible, versioned .simplicio artifacts.
|
|
78
|
+
- It now carries the README globalization standard used across this workspace.
|
|
79
|
+
|
|
80
|
+
## Simplicio ecosystem
|
|
81
|
+
|
|
82
|
+
- [simplicio-mapper](https://github.com/wesleysimplicio/simplicio-mapper) supplies repo context before interpretation.
|
|
83
|
+
- [simplicio-cli](https://github.com/wesleysimplicio/simplicio-dev-cli) executes focused code tasks with verification.
|
|
84
|
+
- [simplicio-prompt](https://github.com/wesleysimplicio/simplicio-prompt) provides fan-out and consensus runtime patterns.
|
|
85
|
+
- [simplicio-sprint](https://github.com/wesleysimplicio/simplicio-sprint) turns cards into draft PR delivery loops.
|
|
86
|
+
|
|
87
|
+
## Documentation standard
|
|
88
|
+
|
|
89
|
+
- [SIMPLICIO_INTEGRATION.md](SIMPLICIO_INTEGRATION.md)
|
|
90
|
+
- [docs/readme-globalization-standard.md](docs/readme-globalization-standard.md)
|
|
91
|
+
- [docs/readme-globalization-standard.md](docs/readme-globalization-standard.md)
|
|
92
|
+
|
|
93
|
+
## Star History
|
|
94
|
+
|
|
95
|
+
<a href="https://www.star-history.com/#wesleysimplicio/simplicio-mapper&Date">
|
|
96
|
+
<picture>
|
|
97
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date&theme=dark" />
|
|
98
|
+
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date" />
|
|
99
|
+
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date" />
|
|
100
|
+
</picture>
|
|
101
|
+
</a>
|
|
102
|
+
|
|
103
|
+
## License
|
|
104
|
+
|
|
105
|
+
MIT. See [LICENSE](LICENSE).
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
<h1 align="center">simplicio-mapper</h1>
|
|
2
|
+
|
|
3
|
+
<p align="center">
|
|
4
|
+
<strong>Mapeie qualquer repositório em contexto legível por IA: project map, precedent index, inventário arquitetural, símbolos, call graph e docs.</strong><br />
|
|
5
|
+
<em>Os comandos ficam em inglês para poder copiar exatamente.</em><br />
|
|
6
|
+
<a href="https://wesleysimplicio.github.io/llm-project-mapper/">Docs ao vivo: wesleysimplicio.github.io/llm-project-mapper</a>
|
|
7
|
+
</p>
|
|
8
|
+
|
|
9
|
+
<p align="center">
|
|
10
|
+
<a href="https://github.com/wesleysimplicio/simplicio-mapper/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/wesleysimplicio/simplicio-mapper?style=flat-square" /></a>
|
|
11
|
+
<a href="https://pypi.org/project/simplicio-mapper/"><img alt="PyPI" src="https://img.shields.io/pypi/v/simplicio-mapper.svg?style=flat-square" /></a>
|
|
12
|
+
<a href="https://www.npmjs.com/package/@wesleysimplicio/llm-project-mapper"><img alt="npm" src="https://img.shields.io/npm/v/%40wesleysimplicio%2Fllm-project-mapper.svg?style=flat-square" /></a>
|
|
13
|
+
<a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/license-MIT-yellow?style=flat-square" /></a>
|
|
14
|
+
</p>
|
|
15
|
+
|
|
16
|
+
<p align="center">
|
|
17
|
+
<a href="README.md">English</a> | <a href="READMEs/README.pt-BR.md">Português</a> | <a href="READMEs/README.es-ES.md">Español</a> | <a href="READMEs/README.ja-JP.md">日本語</a> | <a href="READMEs/README.ko-KR.md">한국어</a> | <a href="READMEs/README.zh-CN.md">简体中文</a> | <a href="READMEs/README.it-IT.md">Italiano</a> | <a href="READMEs/README.fr-FR.md">Français</a> | <a href="READMEs/README.ru-RU.md">Русский</a> | <a href="READMEs/README.pl-PL.md">Polski</a> | <a href="READMEs/README.hi-IN.md">हिन्दी</a> | <a href="READMEs/README.ar-SA.md">العربية</a> | <a href="READMEs/README.he-IL.md">עברית</a> | <a href="READMEs/README.ms-MY.md">Bahasa Melayu</a> | <a href="READMEs/README.id-ID.md">Bahasa Indonesia</a>
|
|
18
|
+
</p>
|
|
19
|
+
|
|
20
|
+
<p align="center">
|
|
21
|
+
<img src="assets/llm-project-mapper-hero.png" alt="simplicio-mapper preview" width="860" />
|
|
22
|
+
</p>
|
|
23
|
+
|
|
24
|
+
<p align="center">
|
|
25
|
+
<img src="assets/overlay-install.svg" alt="Overlay install flow" width="860" />
|
|
26
|
+
</p>
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## Resumo direto
|
|
31
|
+
|
|
32
|
+
Mapeie qualquer repositório em contexto legível por IA: project map, precedent index, inventário arquitetural, símbolos, call graph e docs.
|
|
33
|
+
|
|
34
|
+
## Começo rápido
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
pip install -U simplicio-mapper
|
|
38
|
+
simplicio-mapper index . --json
|
|
39
|
+
simplicio-mapper docs . --json
|
|
40
|
+
simplicio-mapper endpoints ./web --against ./api --json
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
## O que faz
|
|
44
|
+
|
|
45
|
+
- Generates versioned .simplicio artifacts agents can read before planning.
|
|
46
|
+
- Works as both Python CLI and npm starter package.
|
|
47
|
+
- Builds architecture, symbol and call graph artifacts without forcing a framework.
|
|
48
|
+
- Exports markdown docs for wiki/review workflows while keeping remote publishing opt-in.
|
|
49
|
+
|
|
50
|
+
## Por que este README foi feito para ganhar atenção
|
|
51
|
+
|
|
52
|
+
- promessa clara na primeira tela
|
|
53
|
+
- links de idioma antes do install
|
|
54
|
+
- badges e hero visual para confiança imediata
|
|
55
|
+
- quick start copiável
|
|
56
|
+
- seção de prova antes de detalhes longos
|
|
57
|
+
- gráfico de estrelas para social proof
|
|
58
|
+
|
|
59
|
+
## Como funciona
|
|
60
|
+
|
|
61
|
+
```mermaid
|
|
62
|
+
flowchart LR
|
|
63
|
+
mapper["simplicio-mapper
|
|
64
|
+
repo context"] --> current["simplicio-mapper
|
|
65
|
+
this project"]
|
|
66
|
+
prompt["simplicio-prompt
|
|
67
|
+
reasoning runtime"] --> current
|
|
68
|
+
current --> evidence["validated evidence
|
|
69
|
+
tests, docs, screenshots"]
|
|
70
|
+
current --> sprint["simplicio-sprint
|
|
71
|
+
delivery loop"]
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
## Prova e validação
|
|
75
|
+
|
|
76
|
+
- Current local mapper version is 0.7.x with background indexing and docs-only modes.
|
|
77
|
+
- This repo is the canonical standard for visible, versioned .simplicio artifacts.
|
|
78
|
+
- It now carries the README globalization standard used across this workspace.
|
|
79
|
+
|
|
80
|
+
## Ecossistema Simplicio
|
|
81
|
+
|
|
82
|
+
- [simplicio-mapper](https://github.com/wesleysimplicio/simplicio-mapper) supplies repo context before interpretation.
|
|
83
|
+
- [simplicio-cli](https://github.com/wesleysimplicio/simplicio-dev-cli) executes focused code tasks with verification.
|
|
84
|
+
- [simplicio-prompt](https://github.com/wesleysimplicio/simplicio-prompt) provides fan-out and consensus runtime patterns.
|
|
85
|
+
- [simplicio-sprint](https://github.com/wesleysimplicio/simplicio-sprint) turns cards into draft PR delivery loops.
|
|
86
|
+
|
|
87
|
+
## Padrão de documentação
|
|
88
|
+
|
|
89
|
+
- [SIMPLICIO_INTEGRATION.md](SIMPLICIO_INTEGRATION.md)
|
|
90
|
+
- [docs/readme-globalization-standard.md](docs/readme-globalization-standard.md)
|
|
91
|
+
- [docs/readme-globalization-standard.md](docs/readme-globalization-standard.md)
|
|
92
|
+
|
|
93
|
+
## Histórico de estrelas
|
|
94
|
+
|
|
95
|
+
<a href="https://www.star-history.com/#wesleysimplicio/simplicio-mapper&Date">
|
|
96
|
+
<picture>
|
|
97
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date&theme=dark" />
|
|
98
|
+
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date" />
|
|
99
|
+
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date" />
|
|
100
|
+
</picture>
|
|
101
|
+
</a>
|
|
102
|
+
|
|
103
|
+
## Licença
|
|
104
|
+
|
|
105
|
+
MIT. See [LICENSE](LICENSE).
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
<h1 align="center" dir="rtl">simplicio-mapper</h1>
|
|
2
|
+
|
|
3
|
+
<p align="center" dir="rtl">
|
|
4
|
+
<strong>يحوّل أي مستودع إلى سياق قابل للقراءة من قبل الذكاء الاصطناعي: project map وprecedent index وجرد معماري وفهرس رموز وcall graph ووثائق.</strong><br />
|
|
5
|
+
<em>تبقى الأوامر بالإنجليزية حتى يمكن نسخها بدقة.</em>
|
|
6
|
+
</p>
|
|
7
|
+
|
|
8
|
+
<p align="center">
|
|
9
|
+
<a href="https://github.com/wesleysimplicio/simplicio-mapper/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/wesleysimplicio/simplicio-mapper?style=flat-square" /></a>
|
|
10
|
+
<a href="https://pypi.org/project/simplicio-mapper/"><img alt="PyPI" src="https://img.shields.io/pypi/v/simplicio-mapper.svg?style=flat-square" /></a>
|
|
11
|
+
<a href="https://www.npmjs.com/package/@wesleysimplicio/llm-project-mapper"><img alt="npm" src="https://img.shields.io/npm/v/%40wesleysimplicio%2Fllm-project-mapper.svg?style=flat-square" /></a>
|
|
12
|
+
<a href="../LICENSE"><img alt="License" src="https://img.shields.io/badge/license-MIT-yellow?style=flat-square" /></a>
|
|
13
|
+
</p>
|
|
14
|
+
|
|
15
|
+
<p align="center">
|
|
16
|
+
<a href="../README.md">English</a> | <a href="README.pt-BR.md">Português</a> | <a href="README.es-ES.md">Español</a> | <a href="README.ja-JP.md">日本語</a> | <a href="README.ko-KR.md">한국어</a> | <a href="README.zh-CN.md">简体中文</a> | <a href="README.it-IT.md">Italiano</a> | <a href="README.fr-FR.md">Français</a> | <a href="README.ru-RU.md">Русский</a> | <a href="README.pl-PL.md">Polski</a> | <a href="README.hi-IN.md">हिन्दी</a> | <a href="README.ar-SA.md">العربية</a> | <a href="README.he-IL.md">עברית</a> | <a href="README.ms-MY.md">Bahasa Melayu</a> | <a href="README.id-ID.md">Bahasa Indonesia</a>
|
|
17
|
+
</p>
|
|
18
|
+
|
|
19
|
+
<p align="center">
|
|
20
|
+
<img src="../assets/llm-project-mapper-hero.png" alt="simplicio-mapper preview" width="860" />
|
|
21
|
+
</p>
|
|
22
|
+
|
|
23
|
+
<p align="center">
|
|
24
|
+
<img src="../assets/overlay-install.svg" alt="Overlay install flow" width="860" />
|
|
25
|
+
</p>
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
## الخلاصة
|
|
30
|
+
|
|
31
|
+
يحوّل أي مستودع إلى سياق قابل للقراءة من قبل الذكاء الاصطناعي: project map وprecedent index وجرد معماري وفهرس رموز وcall graph ووثائق.
|
|
32
|
+
|
|
33
|
+
## البدء السريع
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
pip install -U simplicio-mapper
|
|
37
|
+
simplicio-mapper index . --json
|
|
38
|
+
simplicio-mapper docs . --json
|
|
39
|
+
simplicio-mapper endpoints ./web --against ./api --json
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
## ماذا يفعل
|
|
43
|
+
|
|
44
|
+
- Generates versioned .simplicio artifacts agents can read before planning.
|
|
45
|
+
- Works as both Python CLI and npm starter package.
|
|
46
|
+
- Builds architecture, symbol and call graph artifacts without forcing a framework.
|
|
47
|
+
- Exports markdown docs for wiki/review workflows while keeping remote publishing opt-in.
|
|
48
|
+
|
|
49
|
+
## لماذا صُمم هذا README لجذب الانتباه
|
|
50
|
+
|
|
51
|
+
- وعد واضح في أول شاشة
|
|
52
|
+
- روابط اللغات قبل التثبيت
|
|
53
|
+
- badges وصورة hero للثقة
|
|
54
|
+
- quick start قابل للنسخ
|
|
55
|
+
- إثبات قبل التفاصيل الطويلة
|
|
56
|
+
- رسم النجوم كدليل اجتماعي
|
|
57
|
+
|
|
58
|
+
## كيف يعمل
|
|
59
|
+
|
|
60
|
+
```mermaid
|
|
61
|
+
flowchart LR
|
|
62
|
+
mapper["simplicio-mapper
|
|
63
|
+
repo context"] --> current["simplicio-mapper
|
|
64
|
+
this project"]
|
|
65
|
+
prompt["simplicio-prompt
|
|
66
|
+
reasoning runtime"] --> current
|
|
67
|
+
current --> evidence["validated evidence
|
|
68
|
+
tests, docs, screenshots"]
|
|
69
|
+
current --> sprint["simplicio-sprint
|
|
70
|
+
delivery loop"]
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
## الإثبات والتحقق
|
|
74
|
+
|
|
75
|
+
- Current local mapper version is 0.7.x with background indexing and docs-only modes.
|
|
76
|
+
- This repo is the canonical standard for visible, versioned .simplicio artifacts.
|
|
77
|
+
- It now carries the README globalization standard used across this workspace.
|
|
78
|
+
|
|
79
|
+
## منظومة Simplicio
|
|
80
|
+
|
|
81
|
+
- [simplicio-mapper](https://github.com/wesleysimplicio/simplicio-mapper) supplies repo context before interpretation.
|
|
82
|
+
- [simplicio-cli](https://github.com/wesleysimplicio/simplicio-dev-cli) executes focused code tasks with verification.
|
|
83
|
+
- [simplicio-prompt](https://github.com/wesleysimplicio/simplicio-prompt) provides fan-out and consensus runtime patterns.
|
|
84
|
+
- [simplicio-sprint](https://github.com/wesleysimplicio/simplicio-sprint) turns cards into draft PR delivery loops.
|
|
85
|
+
|
|
86
|
+
## معيار التوثيق
|
|
87
|
+
|
|
88
|
+
- [SIMPLICIO_INTEGRATION.md](../SIMPLICIO_INTEGRATION.md)
|
|
89
|
+
- [docs/readme-globalization-standard.md](../docs/readme-globalization-standard.md)
|
|
90
|
+
- [docs/readme-globalization-standard.md](../docs/readme-globalization-standard.md)
|
|
91
|
+
|
|
92
|
+
## تاريخ النجوم
|
|
93
|
+
|
|
94
|
+
<a href="https://www.star-history.com/#wesleysimplicio/simplicio-mapper&Date">
|
|
95
|
+
<picture>
|
|
96
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date&theme=dark" />
|
|
97
|
+
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date" />
|
|
98
|
+
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date" />
|
|
99
|
+
</picture>
|
|
100
|
+
</a>
|
|
101
|
+
|
|
102
|
+
## الرخصة
|
|
103
|
+
|
|
104
|
+
MIT. See [LICENSE](../LICENSE).
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
<h1 align="center">simplicio-mapper</h1>
|
|
2
|
+
|
|
3
|
+
<p align="center">
|
|
4
|
+
<strong>Map any repository into AI-readable context: project map, precedent index, architecture inventory, symbol index, call graph, and docs.</strong><br />
|
|
5
|
+
<em>Commands stay in English so they can be copied exactly.</em><br />
|
|
6
|
+
<a href="https://wesleysimplicio.github.io/llm-project-mapper/">Live docs: wesleysimplicio.github.io/llm-project-mapper</a>
|
|
7
|
+
</p>
|
|
8
|
+
|
|
9
|
+
<p align="center">
|
|
10
|
+
<a href="https://github.com/wesleysimplicio/simplicio-mapper/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/wesleysimplicio/simplicio-mapper?style=flat-square" /></a>
|
|
11
|
+
<a href="https://pypi.org/project/simplicio-mapper/"><img alt="PyPI" src="https://img.shields.io/pypi/v/simplicio-mapper.svg?style=flat-square" /></a>
|
|
12
|
+
<a href="https://www.npmjs.com/package/@wesleysimplicio/llm-project-mapper"><img alt="npm" src="https://img.shields.io/npm/v/%40wesleysimplicio%2Fllm-project-mapper.svg?style=flat-square" /></a>
|
|
13
|
+
<a href="../LICENSE"><img alt="License" src="https://img.shields.io/badge/license-MIT-yellow?style=flat-square" /></a>
|
|
14
|
+
</p>
|
|
15
|
+
|
|
16
|
+
<p align="center">
|
|
17
|
+
<a href="../README.md">English</a> | <a href="README.pt-BR.md">Português</a> | <a href="README.es-ES.md">Español</a> | <a href="README.ja-JP.md">日本語</a> | <a href="README.ko-KR.md">한국어</a> | <a href="README.zh-CN.md">简体中文</a> | <a href="README.it-IT.md">Italiano</a> | <a href="README.fr-FR.md">Français</a> | <a href="README.ru-RU.md">Русский</a> | <a href="README.pl-PL.md">Polski</a> | <a href="README.hi-IN.md">हिन्दी</a> | <a href="README.ar-SA.md">العربية</a> | <a href="README.he-IL.md">עברית</a> | <a href="README.ms-MY.md">Bahasa Melayu</a> | <a href="README.id-ID.md">Bahasa Indonesia</a>
|
|
18
|
+
</p>
|
|
19
|
+
|
|
20
|
+
<p align="center">
|
|
21
|
+
<img src="../assets/llm-project-mapper-hero.png" alt="simplicio-mapper preview" width="860" />
|
|
22
|
+
</p>
|
|
23
|
+
|
|
24
|
+
<p align="center">
|
|
25
|
+
<img src="../assets/overlay-install.svg" alt="Overlay install flow" width="860" />
|
|
26
|
+
</p>
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## The short version
|
|
31
|
+
|
|
32
|
+
Map any repository into AI-readable context: project map, precedent index, architecture inventory, symbol index, call graph, and docs.
|
|
33
|
+
|
|
34
|
+
## Quick Start
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
pip install -U simplicio-mapper
|
|
38
|
+
simplicio-mapper index . --json
|
|
39
|
+
simplicio-mapper docs . --json
|
|
40
|
+
simplicio-mapper endpoints ./web --against ./api --json
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
## What it does
|
|
44
|
+
|
|
45
|
+
- Generates versioned .simplicio artifacts agents can read before planning.
|
|
46
|
+
- Works as both Python CLI and npm starter package.
|
|
47
|
+
- Builds architecture, symbol and call graph artifacts without forcing a framework.
|
|
48
|
+
- Exports markdown docs for wiki/review workflows while keeping remote publishing opt-in.
|
|
49
|
+
|
|
50
|
+
## Why this README is built to earn attention
|
|
51
|
+
|
|
52
|
+
- clear first-screen promise
|
|
53
|
+
- language links before installation
|
|
54
|
+
- badges and a visual hero for fast trust
|
|
55
|
+
- copy-ready quick start
|
|
56
|
+
- proof before long reference material
|
|
57
|
+
- star history for social proof
|
|
58
|
+
|
|
59
|
+
## How it works
|
|
60
|
+
|
|
61
|
+
```mermaid
|
|
62
|
+
flowchart LR
|
|
63
|
+
mapper["simplicio-mapper
|
|
64
|
+
repo context"] --> current["simplicio-mapper
|
|
65
|
+
this project"]
|
|
66
|
+
prompt["simplicio-prompt
|
|
67
|
+
reasoning runtime"] --> current
|
|
68
|
+
current --> evidence["validated evidence
|
|
69
|
+
tests, docs, screenshots"]
|
|
70
|
+
current --> sprint["simplicio-sprint
|
|
71
|
+
delivery loop"]
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
## Proof and validation
|
|
75
|
+
|
|
76
|
+
- Current local mapper version is 0.7.x with background indexing and docs-only modes.
|
|
77
|
+
- This repo is the canonical standard for visible, versioned .simplicio artifacts.
|
|
78
|
+
- It now carries the README globalization standard used across this workspace.
|
|
79
|
+
|
|
80
|
+
## Simplicio ecosystem
|
|
81
|
+
|
|
82
|
+
- [simplicio-mapper](https://github.com/wesleysimplicio/simplicio-mapper) supplies repo context before interpretation.
|
|
83
|
+
- [simplicio-cli](https://github.com/wesleysimplicio/simplicio-dev-cli) executes focused code tasks with verification.
|
|
84
|
+
- [simplicio-prompt](https://github.com/wesleysimplicio/simplicio-prompt) provides fan-out and consensus runtime patterns.
|
|
85
|
+
- [simplicio-sprint](https://github.com/wesleysimplicio/simplicio-sprint) turns cards into draft PR delivery loops.
|
|
86
|
+
|
|
87
|
+
## Documentation standard
|
|
88
|
+
|
|
89
|
+
- [SIMPLICIO_INTEGRATION.md](../SIMPLICIO_INTEGRATION.md)
|
|
90
|
+
- [docs/readme-globalization-standard.md](../docs/readme-globalization-standard.md)
|
|
91
|
+
- [docs/readme-globalization-standard.md](../docs/readme-globalization-standard.md)
|
|
92
|
+
|
|
93
|
+
## Star History
|
|
94
|
+
|
|
95
|
+
<a href="https://www.star-history.com/#wesleysimplicio/simplicio-mapper&Date">
|
|
96
|
+
<picture>
|
|
97
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date&theme=dark" />
|
|
98
|
+
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date" />
|
|
99
|
+
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date" />
|
|
100
|
+
</picture>
|
|
101
|
+
</a>
|
|
102
|
+
|
|
103
|
+
## License
|
|
104
|
+
|
|
105
|
+
MIT. See [LICENSE](../LICENSE).
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
<h1 align="center">simplicio-mapper</h1>
|
|
2
|
+
|
|
3
|
+
<p align="center">
|
|
4
|
+
<strong>Mapea cualquier repositorio en contexto legible por IA: project map, precedent index, inventario arquitectónico, símbolos, call graph y docs.</strong><br />
|
|
5
|
+
<em>Los comandos se mantienen en inglés para copiarlos exactamente.</em>
|
|
6
|
+
</p>
|
|
7
|
+
|
|
8
|
+
<p align="center">
|
|
9
|
+
<a href="https://github.com/wesleysimplicio/simplicio-mapper/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/wesleysimplicio/simplicio-mapper?style=flat-square" /></a>
|
|
10
|
+
<a href="https://pypi.org/project/simplicio-mapper/"><img alt="PyPI" src="https://img.shields.io/pypi/v/simplicio-mapper.svg?style=flat-square" /></a>
|
|
11
|
+
<a href="https://www.npmjs.com/package/@wesleysimplicio/llm-project-mapper"><img alt="npm" src="https://img.shields.io/npm/v/%40wesleysimplicio%2Fllm-project-mapper.svg?style=flat-square" /></a>
|
|
12
|
+
<a href="../LICENSE"><img alt="License" src="https://img.shields.io/badge/license-MIT-yellow?style=flat-square" /></a>
|
|
13
|
+
</p>
|
|
14
|
+
|
|
15
|
+
<p align="center">
|
|
16
|
+
<a href="../README.md">English</a> | <a href="README.pt-BR.md">Português</a> | <a href="README.es-ES.md">Español</a> | <a href="README.ja-JP.md">日本語</a> | <a href="README.ko-KR.md">한국어</a> | <a href="README.zh-CN.md">简体中文</a> | <a href="README.it-IT.md">Italiano</a> | <a href="README.fr-FR.md">Français</a> | <a href="README.ru-RU.md">Русский</a> | <a href="README.pl-PL.md">Polski</a> | <a href="README.hi-IN.md">हिन्दी</a> | <a href="README.ar-SA.md">العربية</a> | <a href="README.he-IL.md">עברית</a> | <a href="README.ms-MY.md">Bahasa Melayu</a> | <a href="README.id-ID.md">Bahasa Indonesia</a>
|
|
17
|
+
</p>
|
|
18
|
+
|
|
19
|
+
<p align="center">
|
|
20
|
+
<img src="../assets/llm-project-mapper-hero.png" alt="simplicio-mapper preview" width="860" />
|
|
21
|
+
</p>
|
|
22
|
+
|
|
23
|
+
<p align="center">
|
|
24
|
+
<img src="../assets/overlay-install.svg" alt="Overlay install flow" width="860" />
|
|
25
|
+
</p>
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
## Resumen directo
|
|
30
|
+
|
|
31
|
+
Mapea cualquier repositorio en contexto legible por IA: project map, precedent index, inventario arquitectónico, símbolos, call graph y docs.
|
|
32
|
+
|
|
33
|
+
## Inicio rápido
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
pip install -U simplicio-mapper
|
|
37
|
+
simplicio-mapper index . --json
|
|
38
|
+
simplicio-mapper docs . --json
|
|
39
|
+
simplicio-mapper endpoints ./web --against ./api --json
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
## Qué hace
|
|
43
|
+
|
|
44
|
+
- Generates versioned .simplicio artifacts agents can read before planning.
|
|
45
|
+
- Works as both Python CLI and npm starter package.
|
|
46
|
+
- Builds architecture, symbol and call graph artifacts without forcing a framework.
|
|
47
|
+
- Exports markdown docs for wiki/review workflows while keeping remote publishing opt-in.
|
|
48
|
+
|
|
49
|
+
## Por qué este README está diseñado para ganar atención
|
|
50
|
+
|
|
51
|
+
- promesa clara en la primera pantalla
|
|
52
|
+
- idiomas antes de instalar
|
|
53
|
+
- badges y hero visual
|
|
54
|
+
- quick start copiable
|
|
55
|
+
- prueba antes de detalles largos
|
|
56
|
+
- gráfico de estrellas
|
|
57
|
+
|
|
58
|
+
## Cómo funciona
|
|
59
|
+
|
|
60
|
+
```mermaid
|
|
61
|
+
flowchart LR
|
|
62
|
+
mapper["simplicio-mapper
|
|
63
|
+
repo context"] --> current["simplicio-mapper
|
|
64
|
+
this project"]
|
|
65
|
+
prompt["simplicio-prompt
|
|
66
|
+
reasoning runtime"] --> current
|
|
67
|
+
current --> evidence["validated evidence
|
|
68
|
+
tests, docs, screenshots"]
|
|
69
|
+
current --> sprint["simplicio-sprint
|
|
70
|
+
delivery loop"]
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
## Prueba y validación
|
|
74
|
+
|
|
75
|
+
- Current local mapper version is 0.7.x with background indexing and docs-only modes.
|
|
76
|
+
- This repo is the canonical standard for visible, versioned .simplicio artifacts.
|
|
77
|
+
- It now carries the README globalization standard used across this workspace.
|
|
78
|
+
|
|
79
|
+
## Ecosistema Simplicio
|
|
80
|
+
|
|
81
|
+
- [simplicio-mapper](https://github.com/wesleysimplicio/simplicio-mapper) supplies repo context before interpretation.
|
|
82
|
+
- [simplicio-cli](https://github.com/wesleysimplicio/simplicio-dev-cli) executes focused code tasks with verification.
|
|
83
|
+
- [simplicio-prompt](https://github.com/wesleysimplicio/simplicio-prompt) provides fan-out and consensus runtime patterns.
|
|
84
|
+
- [simplicio-sprint](https://github.com/wesleysimplicio/simplicio-sprint) turns cards into draft PR delivery loops.
|
|
85
|
+
|
|
86
|
+
## Estándar de documentación
|
|
87
|
+
|
|
88
|
+
- [SIMPLICIO_INTEGRATION.md](../SIMPLICIO_INTEGRATION.md)
|
|
89
|
+
- [docs/readme-globalization-standard.md](../docs/readme-globalization-standard.md)
|
|
90
|
+
- [docs/readme-globalization-standard.md](../docs/readme-globalization-standard.md)
|
|
91
|
+
|
|
92
|
+
## Historial de estrellas
|
|
93
|
+
|
|
94
|
+
<a href="https://www.star-history.com/#wesleysimplicio/simplicio-mapper&Date">
|
|
95
|
+
<picture>
|
|
96
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date&theme=dark" />
|
|
97
|
+
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date" />
|
|
98
|
+
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date" />
|
|
99
|
+
</picture>
|
|
100
|
+
</a>
|
|
101
|
+
|
|
102
|
+
## Licencia
|
|
103
|
+
|
|
104
|
+
MIT. See [LICENSE](../LICENSE).
|