simplicio-mapper 0.7.0__tar.gz → 0.7.2__tar.gz

{simplicio_mapper-0.7.0 → simplicio_mapper-0.7.2}/CHANGELOG.md

@@ -1,11 +1,34 @@
 # Changelog
 
+## [0.7.2] - 2026-06-01
+
+### Changed
+- Rebuilt the README as a multilingual growth page inspired by Understand Anything and 50k+ star repository patterns.
+- Added canonical translations under `READMEs/` for the full Simplicio language set and documented the new README globalization standard.
+- Included the translations and globalization standard in package source metadata.
+
 All notable changes to **LLM Project Mapper** are documented in this file.
 
 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).
 
 ## [Unreleased]
 
+## [0.7.1] - 2026-06-01
+
+### Added
+- `simplicio-mapper index|map|update --background` starts a detached refresh
+  and writes `.simplicio/background-index.log`, so long-running inventory
+  updates can proceed without blocking the foreground workflow.
+- `simplicio-mapper index|map|update --docs-only` renders the Markdown wiki
+  view without emitting the index JSON payload, useful for docs-only refreshes.
+- Compatibility aliases `--json-only` and `--changed-only` for orchestration
+  scripts that distinguish JSON-only and changed-file refresh modes.
+
+### Changed
+- `simplicio-mapper index` now uses `.simplicio/index.lock` to avoid overlapping
+  foreground/background refreshes and returns a stable `status=skipped,
+  skipped_reason=locked` JSON contract when another refresh is active.
+
 ## [0.7.0] - 2026-06-01
 
 ### Added

{simplicio_mapper-0.7.0 → simplicio_mapper-0.7.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simplicio-mapper
-Version: 0.7.0
+Version: 0.7.2
 Summary: Python-first project mapper that emits .simplicio/project-map.json and precedent-index.json for the Simplicio ecosystem.
 Project-URL: Homepage, https://github.com/wesleysimplicio/simplicio-mapper
 Project-URL: Repository, https://github.com/wesleysimplicio/simplicio-mapper
@@ -47,6 +47,9 @@ Description-Content-Type: text/markdown
 
 # simplicio-mapper
 
+> 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.
+
+
 Python-first project mapper for the Simplicio ecosystem. It scans a repository
 and emits machine-readable artifacts that agents and tooling can consume
 without parsing the human-readable markdown docs:
@@ -96,6 +99,7 @@ simplicio-mapper endpoints path/to/web --against path/to/api --json
 # Render architecture inventory markdown for wiki/docs review
 simplicio-mapper docs path/to/project --json
 simplicio-mapper export-docs path/to/project --target ./wiki-export --json
+simplicio-mapper index path/to/project --docs --background
 
 # Map another project root, with hints when .starter-meta.json is absent
 simplicio-mapper map --root path/to/project --stack python --product-name "My App"
@@ -118,6 +122,10 @@ The `llm-project-mapper` console script is provided as an alias.
 | `--target <dir>` | Local target directory for `export-docs`. |
 | `--docs` | Render Markdown docs after `map` or `index`. |
 | `--no-docs` | Keep `map`/`index` JSON-only. |
+| `--docs-only` | Render the Markdown docs without emitting the index JSON payload. |
+| `--json-only` | Compatibility alias for keeping `map`/`index` JSON-only. |
+| `--changed-only` | Compatibility alias for incremental refresh workflows. |
+| `--background` | Start a detached index refresh and write `.simplicio/background-index.log`. |
 | `--json` | Emit stable `simplicio.mapper-index/v1` output for the `index` command. |
 | `--update` | Compatibility alias for index refresh workflows. |
 | `--verbose` | Show progress during `index` refreshes. |

{simplicio_mapper-0.7.0 → simplicio_mapper-0.7.2}/PYPI.md

@@ -1,5 +1,8 @@
 # simplicio-mapper
 
+> 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.
+
+
 Python-first project mapper for the Simplicio ecosystem. It scans a repository
 and emits machine-readable artifacts that agents and tooling can consume
 without parsing the human-readable markdown docs:
@@ -49,6 +52,7 @@ simplicio-mapper endpoints path/to/web --against path/to/api --json
 # Render architecture inventory markdown for wiki/docs review
 simplicio-mapper docs path/to/project --json
 simplicio-mapper export-docs path/to/project --target ./wiki-export --json
+simplicio-mapper index path/to/project --docs --background
 
 # Map another project root, with hints when .starter-meta.json is absent
 simplicio-mapper map --root path/to/project --stack python --product-name "My App"
@@ -71,6 +75,10 @@ The `llm-project-mapper` console script is provided as an alias.
 | `--target <dir>` | Local target directory for `export-docs`. |
 | `--docs` | Render Markdown docs after `map` or `index`. |
 | `--no-docs` | Keep `map`/`index` JSON-only. |
+| `--docs-only` | Render the Markdown docs without emitting the index JSON payload. |
+| `--json-only` | Compatibility alias for keeping `map`/`index` JSON-only. |
+| `--changed-only` | Compatibility alias for incremental refresh workflows. |
+| `--background` | Start a detached index refresh and write `.simplicio/background-index.log`. |
 | `--json` | Emit stable `simplicio.mapper-index/v1` output for the `index` command. |
 | `--update` | Compatibility alias for index refresh workflows. |
 | `--verbose` | Show progress during `index` refreshes. |

simplicio_mapper-0.7.2/README.md

@@ -0,0 +1,105 @@
+<h1 align="center">simplicio-mapper</h1>
+
+<p align="center">
+  <strong>Map any repository into AI-readable context: project map, precedent index, architecture inventory, symbol index, call graph, and docs.</strong><br />
+  <em>Commands stay in English so they can be copied exactly.</em><br />
+  <a href="https://wesleysimplicio.github.io/llm-project-mapper/">Live docs: wesleysimplicio.github.io/llm-project-mapper</a>
+</p>
+
+<p align="center">
+<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>
+<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>
+<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>
+<a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/license-MIT-yellow?style=flat-square" /></a>
+</p>
+
+<p align="center">
+<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>
+</p>
+
+<p align="center">
+  <img src="assets/llm-project-mapper-hero.png" alt="simplicio-mapper preview" width="860" />
+</p>
+
+<p align="center">
+  <img src="assets/overlay-install.svg" alt="Overlay install flow" width="860" />
+</p>
+
+---
+
+## The short version
+
+Map any repository into AI-readable context: project map, precedent index, architecture inventory, symbol index, call graph, and docs.
+
+## Quick Start
+
+```bash
+pip install -U simplicio-mapper
+simplicio-mapper index . --json
+simplicio-mapper docs . --json
+simplicio-mapper endpoints ./web --against ./api --json
+```
+
+## What it does
+
+- Generates versioned .simplicio artifacts agents can read before planning.
+- Works as both Python CLI and npm starter package.
+- Builds architecture, symbol and call graph artifacts without forcing a framework.
+- Exports markdown docs for wiki/review workflows while keeping remote publishing opt-in.
+
+## Why this README is built to earn attention
+
+- clear first-screen promise
+- language links before installation
+- badges and a visual hero for fast trust
+- copy-ready quick start
+- proof before long reference material
+- star history for social proof
+
+## How it works
+
+```mermaid
+flowchart LR
+  mapper["simplicio-mapper
+repo context"] --> current["simplicio-mapper
+this project"]
+  prompt["simplicio-prompt
+reasoning runtime"] --> current
+  current --> evidence["validated evidence
+tests, docs, screenshots"]
+  current --> sprint["simplicio-sprint
+delivery loop"]
+```
+
+## Proof and validation
+
+- Current local mapper version is 0.7.x with background indexing and docs-only modes.
+- This repo is the canonical standard for visible, versioned .simplicio artifacts.
+- It now carries the README globalization standard used across this workspace.
+
+## Simplicio ecosystem
+
+- [simplicio-mapper](https://github.com/wesleysimplicio/simplicio-mapper) supplies repo context before interpretation.
+- [simplicio-cli](https://github.com/wesleysimplicio/simplicio-dev-cli) executes focused code tasks with verification.
+- [simplicio-prompt](https://github.com/wesleysimplicio/simplicio-prompt) provides fan-out and consensus runtime patterns.
+- [simplicio-sprint](https://github.com/wesleysimplicio/simplicio-sprint) turns cards into draft PR delivery loops.
+
+## Documentation standard
+
+- [SIMPLICIO_INTEGRATION.md](SIMPLICIO_INTEGRATION.md)
+- [docs/readme-globalization-standard.md](docs/readme-globalization-standard.md)
+- [docs/readme-globalization-standard.md](docs/readme-globalization-standard.md)
+
+## Star History
+
+<a href="https://www.star-history.com/#wesleysimplicio/simplicio-mapper&Date">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date&theme=dark" />
+    <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date" />
+    <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date" />
+  </picture>
+</a>
+
+## License
+
+MIT. See [LICENSE](LICENSE).

simplicio_mapper-0.7.2/README.pt-BR.md

@@ -0,0 +1,105 @@
+<h1 align="center">simplicio-mapper</h1>
+
+<p align="center">
+  <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 />
+  <em>Os comandos ficam em inglês para poder copiar exatamente.</em><br />
+  <a href="https://wesleysimplicio.github.io/llm-project-mapper/">Docs ao vivo: wesleysimplicio.github.io/llm-project-mapper</a>
+</p>
+
+<p align="center">
+<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>
+<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>
+<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>
+<a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/license-MIT-yellow?style=flat-square" /></a>
+</p>
+
+<p align="center">
+<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>
+</p>
+
+<p align="center">
+  <img src="assets/llm-project-mapper-hero.png" alt="simplicio-mapper preview" width="860" />
+</p>
+
+<p align="center">
+  <img src="assets/overlay-install.svg" alt="Overlay install flow" width="860" />
+</p>
+
+---
+
+## Resumo direto
+
+Mapeie qualquer repositório em contexto legível por IA: project map, precedent index, inventário arquitetural, símbolos, call graph e docs.
+
+## Começo rápido
+
+```bash
+pip install -U simplicio-mapper
+simplicio-mapper index . --json
+simplicio-mapper docs . --json
+simplicio-mapper endpoints ./web --against ./api --json
+```
+
+## O que faz
+
+- Generates versioned .simplicio artifacts agents can read before planning.
+- Works as both Python CLI and npm starter package.
+- Builds architecture, symbol and call graph artifacts without forcing a framework.
+- Exports markdown docs for wiki/review workflows while keeping remote publishing opt-in.
+
+## Por que este README foi feito para ganhar atenção
+
+- promessa clara na primeira tela
+- links de idioma antes do install
+- badges e hero visual para confiança imediata
+- quick start copiável
+- seção de prova antes de detalhes longos
+- gráfico de estrelas para social proof
+
+## Como funciona
+
+```mermaid
+flowchart LR
+  mapper["simplicio-mapper
+repo context"] --> current["simplicio-mapper
+this project"]
+  prompt["simplicio-prompt
+reasoning runtime"] --> current
+  current --> evidence["validated evidence
+tests, docs, screenshots"]
+  current --> sprint["simplicio-sprint
+delivery loop"]
+```
+
+## Prova e validação
+
+- Current local mapper version is 0.7.x with background indexing and docs-only modes.
+- This repo is the canonical standard for visible, versioned .simplicio artifacts.
+- It now carries the README globalization standard used across this workspace.
+
+## Ecossistema Simplicio
+
+- [simplicio-mapper](https://github.com/wesleysimplicio/simplicio-mapper) supplies repo context before interpretation.
+- [simplicio-cli](https://github.com/wesleysimplicio/simplicio-dev-cli) executes focused code tasks with verification.
+- [simplicio-prompt](https://github.com/wesleysimplicio/simplicio-prompt) provides fan-out and consensus runtime patterns.
+- [simplicio-sprint](https://github.com/wesleysimplicio/simplicio-sprint) turns cards into draft PR delivery loops.
+
+## Padrão de documentação
+
+- [SIMPLICIO_INTEGRATION.md](SIMPLICIO_INTEGRATION.md)
+- [docs/readme-globalization-standard.md](docs/readme-globalization-standard.md)
+- [docs/readme-globalization-standard.md](docs/readme-globalization-standard.md)
+
+## Histórico de estrelas
+
+<a href="https://www.star-history.com/#wesleysimplicio/simplicio-mapper&Date">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date&theme=dark" />
+    <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date" />
+    <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date" />
+  </picture>
+</a>
+
+## Licença
+
+MIT. See [LICENSE](LICENSE).

simplicio_mapper-0.7.2/READMEs/README.ar-SA.md

@@ -0,0 +1,104 @@
+<h1 align="center" dir="rtl">simplicio-mapper</h1>
+
+<p align="center" dir="rtl">
+  <strong>يحوّل أي مستودع إلى سياق قابل للقراءة من قبل الذكاء الاصطناعي: project map وprecedent index وجرد معماري وفهرس رموز وcall graph ووثائق.</strong><br />
+  <em>تبقى الأوامر بالإنجليزية حتى يمكن نسخها بدقة.</em>
+</p>
+
+<p align="center">
+<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>
+<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>
+<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>
+<a href="../LICENSE"><img alt="License" src="https://img.shields.io/badge/license-MIT-yellow?style=flat-square" /></a>
+</p>
+
+<p align="center">
+<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>
+</p>
+
+<p align="center">
+  <img src="../assets/llm-project-mapper-hero.png" alt="simplicio-mapper preview" width="860" />
+</p>
+
+<p align="center">
+  <img src="../assets/overlay-install.svg" alt="Overlay install flow" width="860" />
+</p>
+
+---
+
+## الخلاصة
+
+يحوّل أي مستودع إلى سياق قابل للقراءة من قبل الذكاء الاصطناعي: project map وprecedent index وجرد معماري وفهرس رموز وcall graph ووثائق.
+
+## البدء السريع
+
+```bash
+pip install -U simplicio-mapper
+simplicio-mapper index . --json
+simplicio-mapper docs . --json
+simplicio-mapper endpoints ./web --against ./api --json
+```
+
+## ماذا يفعل
+
+- Generates versioned .simplicio artifacts agents can read before planning.
+- Works as both Python CLI and npm starter package.
+- Builds architecture, symbol and call graph artifacts without forcing a framework.
+- Exports markdown docs for wiki/review workflows while keeping remote publishing opt-in.
+
+## لماذا صُمم هذا README لجذب الانتباه
+
+- وعد واضح في أول شاشة
+- روابط اللغات قبل التثبيت
+- badges وصورة hero للثقة
+- quick start قابل للنسخ
+- إثبات قبل التفاصيل الطويلة
+- رسم النجوم كدليل اجتماعي
+
+## كيف يعمل
+
+```mermaid
+flowchart LR
+  mapper["simplicio-mapper
+repo context"] --> current["simplicio-mapper
+this project"]
+  prompt["simplicio-prompt
+reasoning runtime"] --> current
+  current --> evidence["validated evidence
+tests, docs, screenshots"]
+  current --> sprint["simplicio-sprint
+delivery loop"]
+```
+
+## الإثبات والتحقق
+
+- Current local mapper version is 0.7.x with background indexing and docs-only modes.
+- This repo is the canonical standard for visible, versioned .simplicio artifacts.
+- It now carries the README globalization standard used across this workspace.
+
+## منظومة Simplicio
+
+- [simplicio-mapper](https://github.com/wesleysimplicio/simplicio-mapper) supplies repo context before interpretation.
+- [simplicio-cli](https://github.com/wesleysimplicio/simplicio-dev-cli) executes focused code tasks with verification.
+- [simplicio-prompt](https://github.com/wesleysimplicio/simplicio-prompt) provides fan-out and consensus runtime patterns.
+- [simplicio-sprint](https://github.com/wesleysimplicio/simplicio-sprint) turns cards into draft PR delivery loops.
+
+## معيار التوثيق
+
+- [SIMPLICIO_INTEGRATION.md](../SIMPLICIO_INTEGRATION.md)
+- [docs/readme-globalization-standard.md](../docs/readme-globalization-standard.md)
+- [docs/readme-globalization-standard.md](../docs/readme-globalization-standard.md)
+
+## تاريخ النجوم
+
+<a href="https://www.star-history.com/#wesleysimplicio/simplicio-mapper&Date">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date&theme=dark" />
+    <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date" />
+    <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date" />
+  </picture>
+</a>
+
+## الرخصة
+
+MIT. See [LICENSE](../LICENSE).

simplicio_mapper-0.7.2/READMEs/README.en.md

@@ -0,0 +1,105 @@
+<h1 align="center">simplicio-mapper</h1>
+
+<p align="center">
+  <strong>Map any repository into AI-readable context: project map, precedent index, architecture inventory, symbol index, call graph, and docs.</strong><br />
+  <em>Commands stay in English so they can be copied exactly.</em><br />
+  <a href="https://wesleysimplicio.github.io/llm-project-mapper/">Live docs: wesleysimplicio.github.io/llm-project-mapper</a>
+</p>
+
+<p align="center">
+<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>
+<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>
+<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>
+<a href="../LICENSE"><img alt="License" src="https://img.shields.io/badge/license-MIT-yellow?style=flat-square" /></a>
+</p>
+
+<p align="center">
+<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>
+</p>
+
+<p align="center">
+  <img src="../assets/llm-project-mapper-hero.png" alt="simplicio-mapper preview" width="860" />
+</p>
+
+<p align="center">
+  <img src="../assets/overlay-install.svg" alt="Overlay install flow" width="860" />
+</p>
+
+---
+
+## The short version
+
+Map any repository into AI-readable context: project map, precedent index, architecture inventory, symbol index, call graph, and docs.
+
+## Quick Start
+
+```bash
+pip install -U simplicio-mapper
+simplicio-mapper index . --json
+simplicio-mapper docs . --json
+simplicio-mapper endpoints ./web --against ./api --json
+```
+
+## What it does
+
+- Generates versioned .simplicio artifacts agents can read before planning.
+- Works as both Python CLI and npm starter package.
+- Builds architecture, symbol and call graph artifacts without forcing a framework.
+- Exports markdown docs for wiki/review workflows while keeping remote publishing opt-in.
+
+## Why this README is built to earn attention
+
+- clear first-screen promise
+- language links before installation
+- badges and a visual hero for fast trust
+- copy-ready quick start
+- proof before long reference material
+- star history for social proof
+
+## How it works
+
+```mermaid
+flowchart LR
+  mapper["simplicio-mapper
+repo context"] --> current["simplicio-mapper
+this project"]
+  prompt["simplicio-prompt
+reasoning runtime"] --> current
+  current --> evidence["validated evidence
+tests, docs, screenshots"]
+  current --> sprint["simplicio-sprint
+delivery loop"]
+```
+
+## Proof and validation
+
+- Current local mapper version is 0.7.x with background indexing and docs-only modes.
+- This repo is the canonical standard for visible, versioned .simplicio artifacts.
+- It now carries the README globalization standard used across this workspace.
+
+## Simplicio ecosystem
+
+- [simplicio-mapper](https://github.com/wesleysimplicio/simplicio-mapper) supplies repo context before interpretation.
+- [simplicio-cli](https://github.com/wesleysimplicio/simplicio-dev-cli) executes focused code tasks with verification.
+- [simplicio-prompt](https://github.com/wesleysimplicio/simplicio-prompt) provides fan-out and consensus runtime patterns.
+- [simplicio-sprint](https://github.com/wesleysimplicio/simplicio-sprint) turns cards into draft PR delivery loops.
+
+## Documentation standard
+
+- [SIMPLICIO_INTEGRATION.md](../SIMPLICIO_INTEGRATION.md)
+- [docs/readme-globalization-standard.md](../docs/readme-globalization-standard.md)
+- [docs/readme-globalization-standard.md](../docs/readme-globalization-standard.md)
+
+## Star History
+
+<a href="https://www.star-history.com/#wesleysimplicio/simplicio-mapper&Date">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date&theme=dark" />
+    <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date" />
+    <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date" />
+  </picture>
+</a>
+
+## License
+
+MIT. See [LICENSE](../LICENSE).

simplicio_mapper-0.7.2/READMEs/README.es-ES.md

@@ -0,0 +1,104 @@
+<h1 align="center">simplicio-mapper</h1>
+
+<p align="center">
+  <strong>Mapea cualquier repositorio en contexto legible por IA: project map, precedent index, inventario arquitectónico, símbolos, call graph y docs.</strong><br />
+  <em>Los comandos se mantienen en inglés para copiarlos exactamente.</em>
+</p>
+
+<p align="center">
+<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>
+<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>
+<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>
+<a href="../LICENSE"><img alt="License" src="https://img.shields.io/badge/license-MIT-yellow?style=flat-square" /></a>
+</p>
+
+<p align="center">
+<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>
+</p>
+
+<p align="center">
+  <img src="../assets/llm-project-mapper-hero.png" alt="simplicio-mapper preview" width="860" />
+</p>
+
+<p align="center">
+  <img src="../assets/overlay-install.svg" alt="Overlay install flow" width="860" />
+</p>
+
+---
+
+## Resumen directo
+
+Mapea cualquier repositorio en contexto legible por IA: project map, precedent index, inventario arquitectónico, símbolos, call graph y docs.
+
+## Inicio rápido
+
+```bash
+pip install -U simplicio-mapper
+simplicio-mapper index . --json
+simplicio-mapper docs . --json
+simplicio-mapper endpoints ./web --against ./api --json
+```
+
+## Qué hace
+
+- Generates versioned .simplicio artifacts agents can read before planning.
+- Works as both Python CLI and npm starter package.
+- Builds architecture, symbol and call graph artifacts without forcing a framework.
+- Exports markdown docs for wiki/review workflows while keeping remote publishing opt-in.
+
+## Por qué este README está diseñado para ganar atención
+
+- promesa clara en la primera pantalla
+- idiomas antes de instalar
+- badges y hero visual
+- quick start copiable
+- prueba antes de detalles largos
+- gráfico de estrellas
+
+## Cómo funciona
+
+```mermaid
+flowchart LR
+  mapper["simplicio-mapper
+repo context"] --> current["simplicio-mapper
+this project"]
+  prompt["simplicio-prompt
+reasoning runtime"] --> current
+  current --> evidence["validated evidence
+tests, docs, screenshots"]
+  current --> sprint["simplicio-sprint
+delivery loop"]
+```
+
+## Prueba y validación
+
+- Current local mapper version is 0.7.x with background indexing and docs-only modes.
+- This repo is the canonical standard for visible, versioned .simplicio artifacts.
+- It now carries the README globalization standard used across this workspace.
+
+## Ecosistema Simplicio
+
+- [simplicio-mapper](https://github.com/wesleysimplicio/simplicio-mapper) supplies repo context before interpretation.
+- [simplicio-cli](https://github.com/wesleysimplicio/simplicio-dev-cli) executes focused code tasks with verification.
+- [simplicio-prompt](https://github.com/wesleysimplicio/simplicio-prompt) provides fan-out and consensus runtime patterns.
+- [simplicio-sprint](https://github.com/wesleysimplicio/simplicio-sprint) turns cards into draft PR delivery loops.
+
+## Estándar de documentación
+
+- [SIMPLICIO_INTEGRATION.md](../SIMPLICIO_INTEGRATION.md)
+- [docs/readme-globalization-standard.md](../docs/readme-globalization-standard.md)
+- [docs/readme-globalization-standard.md](../docs/readme-globalization-standard.md)
+
+## Historial de estrellas
+
+<a href="https://www.star-history.com/#wesleysimplicio/simplicio-mapper&Date">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date&theme=dark" />
+    <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date" />
+    <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-mapper&type=Date" />
+  </picture>
+</a>
+
+## Licencia
+
+MIT. See [LICENSE](../LICENSE).