cubest 0.1.0

package/README.hi.md

@@ -0,0 +1,110 @@
+# cubest
+
+[English](README.md) · [简体中文](README.zh-CN.md) · [Español](README.es.md) · **हिन्दी** · [العربية](README.ar.md) · [বাংলা](README.bn.md) · [Português](README.pt.md) · [Русский](README.ru.md) · [日本語](README.ja.md) · [ਪੰਜਾਬੀ](README.pa.md)
+
+> **AI एजेंट के हर रिपॉज़िटरी स्कैन पर 7–22× कम टोकन।**
+> सिंगल-पास OLAP एग्रीगेटर जो किसी भी टेक्स्ट स्ट्रीम — कोड, लॉग, CSV, JSONL,
+> XML, HTML, SDD आर्टिफ़ैक्ट्स — को कॉम्पैक्ट क्यूब में समेट देता है।
+> **Claude Code, Cursor, Codex, Aider, Windsurf, Cline, Continue.dev** और
+> हर AI कोडिंग एजेंट के लिए बनाया गया है जो इनपुट टोकन के हिसाब से बिल करता है।
+
+<p align="left">
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-blue.svg" alt="License"></a>
+  <img src="https://img.shields.io/badge/python-3.8%2B-blue.svg">
+  <img src="https://img.shields.io/badge/deps-stdlib%20only-green.svg">
+  <img src="https://img.shields.io/badge/tests-57%20passing-brightgreen.svg">
+</p>
+
+## 🧠 AI एजेंट को क्यों परवाह करनी चाहिए
+
+7 वास्तविक परिदृश्यों पर मापा गया (देखें [`examples/`](examples/)):
+
+| # | परिदृश्य                                    | Naive tokens | Cubest tokens | अनुपात    |
+|---|---------------------------------------------|:------------:|:-------------:|:---------:|
+| 1 | nginx लॉग में 5xx जाँच (5000 पंक्तियाँ)     | 3,590        | 158           | **22.7×** |
+| 2 | रिपॉज़िटरी ऑनबोर्डिंग (40 फ़ाइलें)         | 1,256        | 175           | 7.2×      |
+| 3 | `git diff` से MR इम्पैक्ट मैप              | 280          | 16            | **17.5×** |
+| 4 | छोटा CSV रोलअप (300 पंक्तियाँ)             | 280          | 368           | 0.8× ❌   |
+| 5 | 10 HTML पेजों का SEO ऑडिट                  | 382          | 49            | 7.8×      |
+| 6 | डिस्क उपयोग ऑडिट (300 फ़ाइलें)            | 338          | 68            | 5.0×      |
+| 7 | RSS श्रेणी रोलअप (3×30 आइटम)                | 1,692        | 265           | 6.4×      |
+|   | **मध्यक (median)**                          |              |               | **7.2×**  |
+
+Cubest **बड़े प्रवाह और श्रेणीबद्ध डेटा** पर जीतता है। बहुत छोटे टेबल डेटा
+(300-पंक्ति CSV) पर एक साधारण `awk` पाइपलाइन पहले से ही कॉम्पैक्ट है और
+यहाँ cubest हार भी सकता है। मुख्य परिदृश्यों — लॉग, कोड ट्री, sitemap
+क्रॉल — पर एजेंट के कॉन्टेक्स्ट में गिरने वाले टोकन 5–25× कम होते हैं।
+
+## 🚀 इंस्टॉलेशन
+
+```bash
+# सादा डाउनलोड (JSON प्रोफ़ाइल के लिए कोई dependency नहीं)
+curl -O https://raw.githubusercontent.com/BaryshevS/cubest/main/cubest.py
+python3 cubest.py --profile file_tree .
+
+# pip के ज़रिये (PyPI पर जल्द उपलब्ध)
+pip install cubest
+cubest --profile file_tree .
+
+# npm रैपर के ज़रिये
+npx cubest --profile file_tree .
+```
+
+## ⚡ त्वरित शुरुआत
+
+```bash
+# अनजान रिपॉज़िटरी का नक्शा (3000 के बजाय 30 लाइनें)
+cubest --profile file_tree .
+
+# nginx.gz लॉग — top URL × status × p95 latency
+cubest --profile nginx_access /var/log/nginx/access.log.gz
+
+# प्रति भाषा LOC गिनना
+cubest --profile loc_counter .
+
+# CSV → OLAP → इंटरैक्टिव ECharts डैशबोर्ड (एक HTML फ़ाइल)
+cubest -p '{
+  "dimensions": ["campaign", "device"],
+  "measures": [{"name":"impressions","type":"sum","field":"impressions"}],
+  "extract": [{"type":"preset","preset":"csv"}],
+  "output": {"format":"echarts","chart_type":"sankey"}
+}' report.csv > dashboard.html
+```
+
+## 📊 आउटपुट प्रारूप
+
+13 प्रारूप: `tree`, `flat`, `compact`, `csv`, `md_table`, `yaml`, `json`,
+`xml`, `dot`, `mermaid`, `plantuml`, `drawio`, `echarts`.
+
+31 बिल्ट-इन प्रोफ़ाइल — कोड, लॉग, CSV, SEO, K8s, OpenAPI, SDD के लिए।
+पूरी सूची [अंग्रेज़ी README](README.md#-what-you-get) में।
+
+## 📜 लाइसेंस
+
+Apache License 2.0 — [LICENSE](LICENSE) और [NOTICE](NOTICE) देखें।
+
+**एट्रिब्यूशन आवश्यकता (Apache 2.0 §4d):** यदि आप cubest को पुनर्वितरित करते हैं,
+तो NOTICE फ़ाइल को अपस्ट्रीम URL सुरक्षित रखते हुए शामिल करना अनिवार्य है:
+
+> https://github.com/BaryshevS/cubest
+
+## 💖 सहयोग
+
+अगर cubest आपके दैनिक एजेंट वर्कफ़्लो में टोकन बचाता है या किसी घटना को कम
+करता है, तो प्रायोजक बनने पर विचार करें — यह सीधे roadmap (t-digest,
+streaming CSV, एजेंट स्निपेट्स) और इन्फ़्रास्ट्रक्चर को फंड करता है:
+
+- **GitHub Sponsors** → https://github.com/sponsors/BaryshevS
+- **Open Collective** → https://opencollective.com/baryshevsv
+
+महीने के $3 भी प्रोजेक्ट चलाते रहते हैं। प्रायोजक issue triage में
+प्राथमिकता पाते हैं और रिलीज़ नोट्स में उल्लेखित होते हैं।
+
+## ⭐ रिपॉज़िटरी को स्टार दें
+
+यदि cubest आपके AI बजट का हिस्सा बचाता है या किसी SRE घटना को एक घंटे कम
+करता है — एक स्टार दूसरों को इसे खोजने में मदद करता है। बस यही अनुरोध है।
+
+<a href="https://github.com/BaryshevS/cubest/stargazers">
+  <img src="https://img.shields.io/github/stars/BaryshevS/cubest?style=social" alt="Star">
+</a>

package/README.ja.md

@@ -0,0 +1,113 @@
+# cubest
+
+[English](README.md) · [简体中文](README.zh-CN.md) · [Español](README.es.md) · [हिन्दी](README.hi.md) · [العربية](README.ar.md) · [বাংলা](README.bn.md) · [Português](README.pt.md) · [Русский](README.ru.md) · **日本語** · [ਪੰਜਾਬੀ](README.pa.md)
+
+> **AI エージェントのリポジトリスキャンあたり 7–22 倍のトークン節約。**
+> あらゆるテキストストリーム(コード、ログ、CSV、JSONL、XML、HTML、
+> SDD 成果物)をコンパクトな OLAP キューブに畳み込むシングルパス
+> アグリゲーター。**Claude Code、Cursor、Codex、Aider、Windsurf、Cline、
+> Continue.dev**、そして入力トークンごとに課金されるあらゆる AI
+> コーディングエージェント向けに設計されています。
+
+<p align="left">
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-blue.svg" alt="License"></a>
+  <img src="https://img.shields.io/badge/python-3.8%2B-blue.svg">
+  <img src="https://img.shields.io/badge/deps-stdlib%20のみ-green.svg">
+  <img src="https://img.shields.io/badge/tests-57%20通過-brightgreen.svg">
+</p>
+
+## 🧠 なぜ AI エージェントが気にすべきか
+
+7 つの実際的なシナリオで計測(詳細は [`examples/`](examples/) を参照):
+
+| # | シナリオ                              | ナイーブ tokens | Cubest tokens | 比率      |
+|---|---------------------------------------|:---------------:|:-------------:|:---------:|
+| 1 | 5000 行の nginx ログの 5xx 調査       | 3,590           | 158           | **22.7×** |
+| 2 | リポジトリのオンボーディング(40 files)| 1,256           | 175           | 7.2×      |
+| 3 | `git diff` からの MR 影響マップ       | 280             | 16            | **17.5×** |
+| 4 | 小さな CSV ロールアップ(300 行)      | 280             | 368           | 0.8× ❌   |
+| 5 | 10 ページの SEO 監査                  | 382             | 49            | 7.8×      |
+| 6 | 300 ファイルのディスク使用監査        | 338             | 68            | 5.0×      |
+| 7 | RSS カテゴリロールアップ(3×30)        | 1,692           | 265           | 6.4×      |
+|   | **中央値**                            |                 |               | **7.2×**  |
+
+Cubest は**大きなストリームと階層データ**で勝ちます。非常に小さな表形式データ
+(300 行の CSV)では素朴な `awk` パイプラインで既に十分コンパクトで、cubest は
+むしろ負けます。
+
+## 🚀 インストール
+
+```bash
+# シンプルなダウンロード(JSON プロファイルは deps 不要)
+curl -O https://raw.githubusercontent.com/BaryshevS/cubest/main/cubest.py
+python3 cubest.py --profile file_tree .
+
+# pip 経由(PyPI 公開予定)
+pip install cubest
+cubest --profile file_tree .
+
+# npm ラッパー経由
+npx cubest --profile file_tree .
+```
+
+## ⚡ クイックスタート
+
+```bash
+# 見知らぬリポジトリのマップ(3000 行の代わりに 30 行)
+cubest --profile file_tree .
+
+# Nginx access.log.gz — トップ URL × ステータス × 平均レイテンシ + p95/p99
+cubest --profile nginx_access /var/log/nginx/access.log.gz
+
+# 言語別コード行数(scc/tokei/cloc の代替)
+cubest --profile loc_counter .
+
+# CSV → OLAP → インタラクティブ ECharts ダッシュボード
+cubest -p '{
+  "dimensions": ["campaign", "device"],
+  "measures": [{"name":"impressions","type":"sum","field":"impressions"}],
+  "extract": [{"type":"preset","preset":"csv"}],
+  "output": {"format":"echarts","chart_type":"sankey"}
+}' report.csv > report.html
+```
+
+## 📊 出力形式
+
+13 の出力形式:`tree`、`flat`、`compact`、`csv`、`md_table`、`yaml`、`json`、
+`xml`、`dot`、`mermaid`、`plantuml`、`drawio`、`echarts`。
+
+31 の組み込みプロファイル — コード、ログ、CSV、SEO、K8s、OpenAPI、SDD。
+完全なリストは [英語 README](README.md#-what-you-get) をご覧ください。
+
+## 📜 ライセンス
+
+Apache License 2.0 — [LICENSE](LICENSE) と [NOTICE](NOTICE) を参照。
+
+**帰属要件(Apache 2.0 §4d):** cubest を再配布する場合(派生物、製品への
+組み込み、ホスト型サービス、コンテナイメージ、CLI ラッパー、IDE プラグイン、
+エージェントテンプレートの一部として)、NOTICE ファイル(またはその可読な
+内容)を含め、以下のアップストリーム URL を保持する必要があります:
+
+> https://github.com/BaryshevS/cubest
+
+## 💖 サポート
+
+cubest がエージェントの日常ワークフローでトークンを節約したり、
+インシデントを短縮したりする場合は、スポンサーになることをご検討ください。
+資金はロードマップの項目(t-digest、ストリーミング CSV、エージェント用
+スニペット)とインフラに直接使われます:
+
+- **GitHub Sponsors** → https://github.com/sponsors/BaryshevS
+- **Open Collective** → https://opencollective.com/baryshevsv
+
+月額 3 ドルでもプロジェクトの継続を支えます。スポンサーは issue の
+トリアージで優先され、リリースノートにクレジットされます。
+
+## ⭐ このリポジトリにスターを
+
+cubest が AI 予算の一部を節約したり、SRE インシデントを 1 時間短縮したりした
+場合、スターは他の人がこれを見つけるのを助けます。
+
+<a href="https://github.com/BaryshevS/cubest/stargazers">
+  <img src="https://img.shields.io/github/stars/BaryshevS/cubest?style=social" alt="Star">
+</a>