crewforge 0.2.0__tar.gz → 0.2.2__tar.gz

{crewforge-0.2.0/src/crewforge.egg-info → crewforge-0.2.2}/PKG-INFO

@@ -1,17 +1,22 @@
 Metadata-Version: 2.4
 Name: crewforge
-Version: 0.2.0
+Version: 0.2.2
 Summary: One crew of LLM agents, five recipes: code review, document Q&A, API scaffolding, content and honest academic-writing help — on any OpenAI-compatible provider.
 Author: Muhammad Aiman
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/aimanmalib/crewforge
-Project-URL: Repository, https://github.com/aimanmalib/crewforge
-Project-URL: Issues, https://github.com/aimanmalib/crewforge/issues
+Project-URL: Documentation, https://github.com/aimanmalib/crewforge#readme
 Project-URL: Changelog, https://github.com/aimanmalib/crewforge/blob/main/CHANGELOG.md
-Keywords: llm,agents,multi-agent,openai,code-review,rag,fastapi,content-generation,academic-writing,cli
+Project-URL: Issues, https://github.com/aimanmalib/crewforge/issues
+Project-URL: Source, https://github.com/aimanmalib/crewforge
+Project-URL: Security, https://github.com/aimanmalib/crewforge/security/policy
+Keywords: llm,agents,multi-agent,ai-agents,openai,openai-compatible,code-review,rag,document-qa,fastapi,api-scaffolding,content-generation,academic-writing,cli
 Classifier: Development Status :: 3 - Alpha
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Natural Language :: English
+Classifier: Natural Language :: Malay
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
@@ -19,8 +24,12 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Education
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Code Generators
 Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Text Processing :: General
 Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -41,18 +50,27 @@ Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
 Requires-Dist: pytest-cov>=5.0; extra == "dev"
 Requires-Dist: ruff>=0.6; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Requires-Dist: types-PyYAML>=6.0; extra == "dev"
 Requires-Dist: fastapi>=0.110; extra == "dev"
 Requires-Dist: httpx>=0.27; extra == "dev"
 Dynamic: license-file
 
-# crewforge
+<p align="center"><img src="https://raw.githubusercontent.com/aimanmalib/crewforge/main/brand/logo-512.png" width="112" height="112" alt="crewforge"></p>
+
+<h1 align="center">crewforge</h1>
+
+<p align="center"><a href="https://github.com/aimanmalib/crewforge/actions/workflows/ci.yml"><img src="https://github.com/aimanmalib/crewforge/actions/workflows/ci.yml/badge.svg" alt="CI"></a> <a href="https://pypi.org/project/crewforge/"><img src="https://img.shields.io/pypi/v/crewforge" alt="PyPI"></a> <a href="https://scorecard.dev/viewer/?uri=github.com/aimanmalib/crewforge"><img src="https://api.scorecard.dev/projects/github.com/aimanmalib/crewforge/badge" alt="OpenSSF Scorecard"></a> <img src="https://img.shields.io/badge/python-3.10%E2%80%933.14-blue" alt="Python 3.10–3.14"> <a href="https://github.com/aimanmalib/crewforge/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License: MIT"></a></p>
 
-**One crew of LLM agents, five recipes — code review, document Q&A, API scaffolding, content and honest academic-writing help — on any OpenAI-compatible provider, and it fails loudly instead of pretending.**
+<p align="center"><b>One crew of LLM agents, five recipes, any OpenAI-compatible provider.</b> · <i>Satu kru ejen LLM, lima resipi, mana-mana penyedia serasi OpenAI.</i><br>
+<a href="https://pypi.org/project/crewforge/">PyPI</a> · <a href="https://github.com/aimanmalib/crewforge/blob/main/CHANGELOG.md">changelog</a> · <a href="https://github.com/aimanmalib/crewforge/blob/main/docs/porting.md">porting notes</a> · Built in Malaysia by <a href="https://aimanmalib.com">Aiman Malib</a></p>
 
-[![CI](https://github.com/aimanmalib/crewforge/actions/workflows/ci.yml/badge.svg)](https://github.com/aimanmalib/crewforge/actions/workflows/ci.yml)
-[![PyPI](https://img.shields.io/pypi/v/crewforge)](https://pypi.org/project/crewforge/)
-![Python 3.10–3.13](https://img.shields.io/badge/python-3.10%E2%80%933.13-blue)
-![License: MIT](https://img.shields.io/badge/license-MIT-green)
+crewforge is a command-line tool and Python library that runs a crew of LLM agents through five recipes: code
+review, document Q&A, API scaffolding, content writing and honest academic-writing help. It works with any
+OpenAI-compatible provider, reads API keys only from the environment, and fails loudly instead of pretending: a run
+in which an agent produced nothing exits with code 1 and names that agent.
+
+[Bahasa Melayu ↓](#bahasa-melayu)
 
 ```bash
 crewforge review src/                                  # six reviewers + a summary
@@ -69,7 +87,7 @@ crewforge academic feedback draft.md --brief brief.md --language ms
 
 ## Why one crew, many recipes
 
-crewforge started as four separate command-line tools —
+crewforge started as four separate command-line tools:
 [codeguard](https://github.com/aimanmalib/codeguard),
 [documind](https://github.com/aimanmalib/documind),
 [apiforge](https://github.com/aimanmalib/apiforge) and
@@ -83,7 +101,7 @@ showed the copies had drifted and that each hid its failures differently:
 - apiforge scored a spec with **no endpoints** 100/100;
 - contentforge wrote the real API key into its YAML file, and sent `${OPENAI_API_KEY}` literally as the key.
 
-crewforge keeps one core — so a fix lands once — and turns each tool into a
+crewforge keeps one core, so a fix lands once, and turns each tool into a
 *recipe*: a set of agents plus the steps that connect them. The same core rules
 apply to every recipe: non-streaming requests, bounded retries, usage numbers
 taken only from the provider, keys only from the environment, and no run that
@@ -161,6 +179,11 @@ total   7 calls   22,366 tokens (provider-reported)
 
 ### `ask` and `summarize`
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/aimanmalib/crewforge/main/docs/demo/ask.gif" alt="Terminal demo: crewforge ask --verify answers two questions about a short project brief with [Source N] citations; the second answer says the document does not give the cost, and both answers are fact-checked claim by claim" width="900">
+</p>
+<p align="center"><sub>A real run of <code>crewforge ask --verify</code>: the answerer cites the passages it used as <code>[Source N]</code>, a second agent checks every claim against those passages, and the question the document does not answer is answered as such. Provider-reported tokens. Recorded with <a href="https://github.com/charmbracelet/vhs">VHS</a> from <a href="https://github.com/aimanmalib/crewforge/blob/main/docs/demo/ask.tape"><code>docs/demo/ask.tape</code></a> (the document is invented) using Gemini 3.8 Flash through an OpenAI-compatible gateway (the <code>custom</code> provider). The wait for the model is shown in full.</sub></p>
+
 ```text
 $ crewforge ask kestrel.md -q "How many sensors does Project Kestrel use, and who leads it?" --verify --export session.md
 ✓ ingested kestrel.md (1 chunks)
@@ -232,6 +255,11 @@ Indonesian forms such as *karena* or *kualitas*). Every step is recorded
 (file names and hashes, never content or keys) so `disclose` can write the
 AI-use statement many universities now ask for.
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/aimanmalib/crewforge/main/docs/demo/academic.gif" alt="Terminal demo: crewforge academic feedback --language ms comments in Malay on a student's essay draft, quoting the sentences it refers to, then a no-AI citation check lists (Lim, 2024) as cited in the text but missing from the reference list" width="900">
+</p>
+<p align="center"><sub>A real run of <code>crewforge academic feedback --language ms</code> on a short essay draft in Malay. Each comment quotes the student's own sentence and suggests a fix; nothing is rewritten. The citation check after it uses no AI: it finds <em>(Lim, 2024)</em> cited in the text but missing from the reference list. Only the <code>argument</code> reviewer is run so the result fits on one screen. Recorded with <a href="https://github.com/charmbracelet/vhs">VHS</a> from <a href="https://github.com/aimanmalib/crewforge/blob/main/docs/demo/academic.tape"><code>docs/demo/academic.tape</code></a> (draft, brief and reference are invented) using Gemini 3.8 Flash through an OpenAI-compatible gateway (the <code>custom</code> provider). The wait for the model is shown in full.</sub></p>
+
 ```text
 $ crewforge academic plan brief.md -f markdown          # a 1,200-word TSL3013 essay brief
 # Assignment plan: Regulated Integration over Prohibition: ...
@@ -268,13 +296,13 @@ Saya menggunakan crewforge academic (versi 0.1.0), sebuah alat berbantukan AI, d
 - 22 Oktober 2026: Perancangan: alat ini menukar taklimat tugasan (brief-ms.md) kepada 3 soalan kajian, rangka 5 bahagian dan peruntukan perkataan. ...
 ```
 
-How sources are labelled — there is no "verified" status, because the tool
+How sources are labelled: there is no "verified" status, because the tool
 cannot check that a source exists:
 
 | Source | Label |
 |---|---|
 | You supplied it | *supplied by you (not checked online)* |
-| The model proposed it, with a DOI, URL or valid ISBN | **UNVERIFIED** — check it |
+| The model proposed it, with a DOI, URL or valid ISBN | **UNVERIFIED**: check it |
 | The model proposed it with none of those | **LIKELY FABRICATED** |
 | The model added a DOI/URL/ISBN to a reference you supplied | **UNVERIFIED**, naming the added identifier |
 
@@ -309,47 +337,20 @@ An unknown provider name is a configuration error, not a silent fallback.
 
 ## Architecture
 
-```mermaid
-flowchart LR
-    CLI["crewforge CLI<br/>review · ask · summarize · ingest<br/>scaffold · validate · write<br/>academic plan · feedback · cite · disclose"] --> R
-
-    subgraph R["Recipes (src/crewforge/recipes)"]
-        RV[review]
-        DC[docs]
-        AP[api]
-        CT[content]
-        AC[academic]
-    end
-
-    R --> CREW
-
-    subgraph CORE["Core (src/crewforge/core)"]
-        CREW["Crew<br/>step() · parallel()<br/>names failed agents"]
-        AG["Agent<br/>ask() · ask_json()<br/>rejects empty output"]
-        PA["parsing<br/>tolerant JSON + schema"]
-        CL["LLMClient<br/>stream=false · retries 429/5xx only"]
-        US["UsageTracker<br/>provider-reported tokens"]
-        CF["LLMConfig + provider presets<br/>keys from env only"]
-        CREW --> AG
-        AG --> PA
-        AG --> CL
-        AG --> US
-        CL --> CF
-    end
-
-    CL -->|"/chat/completions"| P[("Any OpenAI-compatible provider")]
-```
+<p align="center"><img src="https://raw.githubusercontent.com/aimanmalib/crewforge/main/docs/architecture.png" alt="Architecture: the CLI dispatches to five recipes; each recipe builds a Crew of Agents on the shared core (parsing, LLMClient, LLMConfig, UsageTracker), which talks to any OpenAI-compatible provider over /chat/completions" width="100%"></p>
+
+<sub>Source: [docs/architecture.mmd](https://github.com/aimanmalib/crewforge/blob/main/docs/architecture.mmd) (re-render with `scripts/render_architecture.py`).</sub>
 
-- **`core/client.py`** — one async client. It always sends `"stream": false`,
+- **`core/client.py`**: one async client. It always sends `"stream": false`,
   retries only HTTP 429, 5xx and network/timeout errors (with capped exponential
   backoff that honours `Retry-After`), and fails on the first 401/403/4xx with a
   message naming the variable to fix. The key is only ever a request header.
-- **`core/agent.py`** — an agent is a role, a system prompt and per-agent
+- **`core/agent.py`**: an agent is a role, a system prompt and per-agent
   sampling defaults. `ask()` records usage and raises if the reply is blank;
   `ask_json()` additionally requires parseable JSON (optionally a pydantic schema).
-- **`core/crew.py`** — runs agents as sequential steps or parallel stages and
+- **`core/crew.py`**: runs agents as sequential steps or parallel stages and
   turns any failure into a `CrewFailedError` that lists every failed agent.
-- **`core/usage.py`** — per-agent calls, tokens, retries and latency, taken from
+- **`core/usage.py`**: per-agent calls, tokens, retries and latency, taken from
   the provider's `usage` object. Calls without usage are counted as "not reported",
   never estimated.
 
@@ -414,22 +415,23 @@ watching them fail; see [docs/porting.md](https://github.com/aimanmalib/crewforg
 
 crewforge was built with AI coding assistance (Claude Code) under the
 direction of its author, Muhammad Aiman. It consolidates four earlier tools by
-the same author — [codeguard](https://github.com/aimanmalib/codeguard),
+the same author ([codeguard](https://github.com/aimanmalib/codeguard),
 [documind](https://github.com/aimanmalib/documind),
 [apiforge](https://github.com/aimanmalib/apiforge) and
-[contentforge](https://github.com/aimanmalib/contentforge) — whose test suites
+[contentforge](https://github.com/aimanmalib/contentforge)), whose test suites
 were carried over into this repository (see [docs/porting.md](https://github.com/aimanmalib/crewforge/blob/main/docs/porting.md)
 for what was ported, re-targeted at the shared core, or dropped and why).
 
 The evidence that it works is meant to be checkable: the test suite (run
-`pytest`; it needs no key and no network), CI on Python 3.10–3.13, and the
+`pytest`; it needs no key and no network), CI on Python 3.10–3.14, and the
 real-provider runs shown above, two of which found bugs that were fixed with
 tests before the output was recorded.
 
 ## Contributing
 
-See [CONTRIBUTING.md](https://github.com/aimanmalib/crewforge/blob/main/CONTRIBUTING.md). In short: `pip install -e ".[dev,docs]"`,
-`pytest`, `ruff check . && ruff format --check .`, and every new failure path
+See [CONTRIBUTING.md](https://github.com/aimanmalib/crewforge/blob/main/CONTRIBUTING.md). In short: `uv sync --extra dev --extra docs`
+(versions from the committed `uv.lock`, as in CI), `uv run pytest`,
+`uv run ruff check . && uv run ruff format --check .`, and every new failure path
 needs a test that fails if the guard is removed.
 
 ## Security
@@ -439,10 +441,52 @@ Please report vulnerabilities privately through
 See [SECURITY.md](https://github.com/aimanmalib/crewforge/blob/main/SECURITY.md) for scope notes (what is sent to your provider,
 and what `validate` executes).
 
-## License
+## Bahasa Melayu
+
+crewforge ialah alat baris arahan dan pustaka Python yang menjalankan satu kru ejen LLM melalui lima resipi:
+semakan kod (`review`), soal jawab dokumen (`ask`, `summarize`), penjanaan projek API FastAPI (`scaffold`,
+`validate`), penulisan kandungan (`write`) dan bantuan penulisan akademik yang jujur (`academic`). Ia berfungsi
+dengan mana-mana penyedia serasi OpenAI, termasuk model tempatan melalui Ollama atau llama.cpp. Kunci API hanya
+dibaca dari pemboleh ubah persekitaran, tidak pernah ditulis ke fail.
+
+**Mengapa satu kru.** crewforge menggabungkan empat alat lama (codeguard, documind, apiforge, contentforge) yang
+masing-masing menyimpan salinan sendiri bagi rangka yang sama. Salinan itu sudah berbeza dan setiap satu
+menyembunyikan kegagalan dengan cara sendiri. Kini teras dikongsi: pembaikan dibuat sekali, dan setiap alat menjadi
+resipi di atas teras itu.
+
+**Gagal dengan jelas.** Larian yang ejennya memulangkan jawapan kosong atau tidak boleh dihurai, atau pengesah
+yang tidak menyemak apa-apa, keluar dengan kod 1 dan menamakan ejen itu. Kod keluar: `0` berjaya, `1` larian
+gagal, `2` ralat penggunaan atau konfigurasi. Bilangan token diambil daripada laporan penyedia sahaja, tidak
+dianggar.
+
+**Resipi `academic`.** Membantu pelajar dan penyelidik dengan kerja mereka **sendiri**: merancang dari taklimat
+tugasan, memberi ulasan atas draf tanpa menulis semula, memformat rujukan yang diberi pengguna (APA 7, IEEE,
+Harvard) tanpa menambah rujukan baharu, dan menulis pernyataan penggunaan AI daripada rekod langkah yang
+dijalankan. Output dalam bahasa Inggeris atau Bahasa Melayu (`--language ms`); output BM disemak untuk bentuk
+Indonesia seperti *karena* atau *kualitas*. Sumber yang dicadangkan model dilabel UNVERIFIED, atau LIKELY
+FABRICATED jika tiada DOI, URL atau ISBN. Tiada ciri "humanise" atau mengelak pengesan AI.
+
+**Pasang dan guna.**
+
+```bash
+pip install crewforge                 # Python 3.10 hingga 3.14
+pip install "crewforge[docs,api]"     # pilihan: PDF/DOCX dan semakan aplikasi FastAPI
+export OPENAI_API_KEY=sk-...          # atau penyedia lain, lihat `crewforge providers`
+crewforge review src/
+crewforge academic feedback draf.md --brief taklimat.md --language ms
+```
+
+Senarai penyedia, contoh setiap resipi dan seni bina ada dalam bahagian bahasa Inggeris di atas
+([Providers](https://github.com/aimanmalib/crewforge#providers), [Recipes](https://github.com/aimanmalib/crewforge#recipes)).
+
+## Licence
+
+[MIT](https://github.com/aimanmalib/crewforge/blob/main/LICENSE) © Muhammad Aiman. Made by [Aiman Malib](https://aimanmalib.com), Malaysia.
+
+## Work with Sasa Teguh
 
-[MIT](https://github.com/aimanmalib/crewforge/blob/main/LICENSE) © Muhammad Aiman
+[![Work with Sasa Teguh: book a call](https://raw.githubusercontent.com/sasateguh/.github/main/assets/work-with-sasa-teguh.png)](https://sasateguh.com/book)
 
----
+I built this project. I run [Sasa Teguh](https://sasateguh.com), a studio in Malaysia that builds websites found on Google and in AI answers, and sets up systems like this one for businesses.
 
-Built by [Sasa Teguh](https://sasateguh.com) · Malaysia
+[Book a call](https://sasateguh.com/book) · hello@sasateguh.com · [More from Sasa Teguh](https://github.com/sasateguh)

{crewforge-0.2.0 → crewforge-0.2.2}/README.md

@@ -1,11 +1,18 @@
-# crewforge
+<p align="center"><img src="https://raw.githubusercontent.com/aimanmalib/crewforge/main/brand/logo-512.png" width="112" height="112" alt="crewforge"></p>
 
-**One crew of LLM agents, five recipes — code review, document Q&A, API scaffolding, content and honest academic-writing help — on any OpenAI-compatible provider, and it fails loudly instead of pretending.**
+<h1 align="center">crewforge</h1>
 
-[![CI](https://github.com/aimanmalib/crewforge/actions/workflows/ci.yml/badge.svg)](https://github.com/aimanmalib/crewforge/actions/workflows/ci.yml)
-[![PyPI](https://img.shields.io/pypi/v/crewforge)](https://pypi.org/project/crewforge/)
-![Python 3.10–3.13](https://img.shields.io/badge/python-3.10%E2%80%933.13-blue)
-![License: MIT](https://img.shields.io/badge/license-MIT-green)
+<p align="center"><a href="https://github.com/aimanmalib/crewforge/actions/workflows/ci.yml"><img src="https://github.com/aimanmalib/crewforge/actions/workflows/ci.yml/badge.svg" alt="CI"></a> <a href="https://pypi.org/project/crewforge/"><img src="https://img.shields.io/pypi/v/crewforge" alt="PyPI"></a> <a href="https://scorecard.dev/viewer/?uri=github.com/aimanmalib/crewforge"><img src="https://api.scorecard.dev/projects/github.com/aimanmalib/crewforge/badge" alt="OpenSSF Scorecard"></a> <img src="https://img.shields.io/badge/python-3.10%E2%80%933.14-blue" alt="Python 3.10–3.14"> <a href="https://github.com/aimanmalib/crewforge/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License: MIT"></a></p>
+
+<p align="center"><b>One crew of LLM agents, five recipes, any OpenAI-compatible provider.</b> · <i>Satu kru ejen LLM, lima resipi, mana-mana penyedia serasi OpenAI.</i><br>
+<a href="https://pypi.org/project/crewforge/">PyPI</a> · <a href="https://github.com/aimanmalib/crewforge/blob/main/CHANGELOG.md">changelog</a> · <a href="https://github.com/aimanmalib/crewforge/blob/main/docs/porting.md">porting notes</a> · Built in Malaysia by <a href="https://aimanmalib.com">Aiman Malib</a></p>
+
+crewforge is a command-line tool and Python library that runs a crew of LLM agents through five recipes: code
+review, document Q&A, API scaffolding, content writing and honest academic-writing help. It works with any
+OpenAI-compatible provider, reads API keys only from the environment, and fails loudly instead of pretending: a run
+in which an agent produced nothing exits with code 1 and names that agent.
+
+[Bahasa Melayu ↓](#bahasa-melayu)
 
 ```bash
 crewforge review src/                                  # six reviewers + a summary
@@ -22,7 +29,7 @@ crewforge academic feedback draft.md --brief brief.md --language ms
 
 ## Why one crew, many recipes
 
-crewforge started as four separate command-line tools —
+crewforge started as four separate command-line tools:
 [codeguard](https://github.com/aimanmalib/codeguard),
 [documind](https://github.com/aimanmalib/documind),
 [apiforge](https://github.com/aimanmalib/apiforge) and
@@ -36,7 +43,7 @@ showed the copies had drifted and that each hid its failures differently:
 - apiforge scored a spec with **no endpoints** 100/100;
 - contentforge wrote the real API key into its YAML file, and sent `${OPENAI_API_KEY}` literally as the key.
 
-crewforge keeps one core — so a fix lands once — and turns each tool into a
+crewforge keeps one core, so a fix lands once, and turns each tool into a
 *recipe*: a set of agents plus the steps that connect them. The same core rules
 apply to every recipe: non-streaming requests, bounded retries, usage numbers
 taken only from the provider, keys only from the environment, and no run that
@@ -114,6 +121,11 @@ total   7 calls   22,366 tokens (provider-reported)
 
 ### `ask` and `summarize`
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/aimanmalib/crewforge/main/docs/demo/ask.gif" alt="Terminal demo: crewforge ask --verify answers two questions about a short project brief with [Source N] citations; the second answer says the document does not give the cost, and both answers are fact-checked claim by claim" width="900">
+</p>
+<p align="center"><sub>A real run of <code>crewforge ask --verify</code>: the answerer cites the passages it used as <code>[Source N]</code>, a second agent checks every claim against those passages, and the question the document does not answer is answered as such. Provider-reported tokens. Recorded with <a href="https://github.com/charmbracelet/vhs">VHS</a> from <a href="https://github.com/aimanmalib/crewforge/blob/main/docs/demo/ask.tape"><code>docs/demo/ask.tape</code></a> (the document is invented) using Gemini 3.8 Flash through an OpenAI-compatible gateway (the <code>custom</code> provider). The wait for the model is shown in full.</sub></p>
+
 ```text
 $ crewforge ask kestrel.md -q "How many sensors does Project Kestrel use, and who leads it?" --verify --export session.md
 ✓ ingested kestrel.md (1 chunks)
@@ -185,6 +197,11 @@ Indonesian forms such as *karena* or *kualitas*). Every step is recorded
 (file names and hashes, never content or keys) so `disclose` can write the
 AI-use statement many universities now ask for.
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/aimanmalib/crewforge/main/docs/demo/academic.gif" alt="Terminal demo: crewforge academic feedback --language ms comments in Malay on a student's essay draft, quoting the sentences it refers to, then a no-AI citation check lists (Lim, 2024) as cited in the text but missing from the reference list" width="900">
+</p>
+<p align="center"><sub>A real run of <code>crewforge academic feedback --language ms</code> on a short essay draft in Malay. Each comment quotes the student's own sentence and suggests a fix; nothing is rewritten. The citation check after it uses no AI: it finds <em>(Lim, 2024)</em> cited in the text but missing from the reference list. Only the <code>argument</code> reviewer is run so the result fits on one screen. Recorded with <a href="https://github.com/charmbracelet/vhs">VHS</a> from <a href="https://github.com/aimanmalib/crewforge/blob/main/docs/demo/academic.tape"><code>docs/demo/academic.tape</code></a> (draft, brief and reference are invented) using Gemini 3.8 Flash through an OpenAI-compatible gateway (the <code>custom</code> provider). The wait for the model is shown in full.</sub></p>
+
 ```text
 $ crewforge academic plan brief.md -f markdown          # a 1,200-word TSL3013 essay brief
 # Assignment plan: Regulated Integration over Prohibition: ...
@@ -221,13 +238,13 @@ Saya menggunakan crewforge academic (versi 0.1.0), sebuah alat berbantukan AI, d
 - 22 Oktober 2026: Perancangan: alat ini menukar taklimat tugasan (brief-ms.md) kepada 3 soalan kajian, rangka 5 bahagian dan peruntukan perkataan. ...
 ```
 
-How sources are labelled — there is no "verified" status, because the tool
+How sources are labelled: there is no "verified" status, because the tool
 cannot check that a source exists:
 
 | Source | Label |
 |---|---|
 | You supplied it | *supplied by you (not checked online)* |
-| The model proposed it, with a DOI, URL or valid ISBN | **UNVERIFIED** — check it |
+| The model proposed it, with a DOI, URL or valid ISBN | **UNVERIFIED**: check it |
 | The model proposed it with none of those | **LIKELY FABRICATED** |
 | The model added a DOI/URL/ISBN to a reference you supplied | **UNVERIFIED**, naming the added identifier |
 
@@ -262,47 +279,20 @@ An unknown provider name is a configuration error, not a silent fallback.
 
 ## Architecture
 
-```mermaid
-flowchart LR
-    CLI["crewforge CLI<br/>review · ask · summarize · ingest<br/>scaffold · validate · write<br/>academic plan · feedback · cite · disclose"] --> R
-
-    subgraph R["Recipes (src/crewforge/recipes)"]
-        RV[review]
-        DC[docs]
-        AP[api]
-        CT[content]
-        AC[academic]
-    end
-
-    R --> CREW
-
-    subgraph CORE["Core (src/crewforge/core)"]
-        CREW["Crew<br/>step() · parallel()<br/>names failed agents"]
-        AG["Agent<br/>ask() · ask_json()<br/>rejects empty output"]
-        PA["parsing<br/>tolerant JSON + schema"]
-        CL["LLMClient<br/>stream=false · retries 429/5xx only"]
-        US["UsageTracker<br/>provider-reported tokens"]
-        CF["LLMConfig + provider presets<br/>keys from env only"]
-        CREW --> AG
-        AG --> PA
-        AG --> CL
-        AG --> US
-        CL --> CF
-    end
-
-    CL -->|"/chat/completions"| P[("Any OpenAI-compatible provider")]
-```
+<p align="center"><img src="https://raw.githubusercontent.com/aimanmalib/crewforge/main/docs/architecture.png" alt="Architecture: the CLI dispatches to five recipes; each recipe builds a Crew of Agents on the shared core (parsing, LLMClient, LLMConfig, UsageTracker), which talks to any OpenAI-compatible provider over /chat/completions" width="100%"></p>
+
+<sub>Source: [docs/architecture.mmd](https://github.com/aimanmalib/crewforge/blob/main/docs/architecture.mmd) (re-render with `scripts/render_architecture.py`).</sub>
 
-- **`core/client.py`** — one async client. It always sends `"stream": false`,
+- **`core/client.py`**: one async client. It always sends `"stream": false`,
   retries only HTTP 429, 5xx and network/timeout errors (with capped exponential
   backoff that honours `Retry-After`), and fails on the first 401/403/4xx with a
   message naming the variable to fix. The key is only ever a request header.
-- **`core/agent.py`** — an agent is a role, a system prompt and per-agent
+- **`core/agent.py`**: an agent is a role, a system prompt and per-agent
   sampling defaults. `ask()` records usage and raises if the reply is blank;
   `ask_json()` additionally requires parseable JSON (optionally a pydantic schema).
-- **`core/crew.py`** — runs agents as sequential steps or parallel stages and
+- **`core/crew.py`**: runs agents as sequential steps or parallel stages and
   turns any failure into a `CrewFailedError` that lists every failed agent.
-- **`core/usage.py`** — per-agent calls, tokens, retries and latency, taken from
+- **`core/usage.py`**: per-agent calls, tokens, retries and latency, taken from
   the provider's `usage` object. Calls without usage are counted as "not reported",
   never estimated.
 
@@ -367,22 +357,23 @@ watching them fail; see [docs/porting.md](https://github.com/aimanmalib/crewforg
 
 crewforge was built with AI coding assistance (Claude Code) under the
 direction of its author, Muhammad Aiman. It consolidates four earlier tools by
-the same author — [codeguard](https://github.com/aimanmalib/codeguard),
+the same author ([codeguard](https://github.com/aimanmalib/codeguard),
 [documind](https://github.com/aimanmalib/documind),
 [apiforge](https://github.com/aimanmalib/apiforge) and
-[contentforge](https://github.com/aimanmalib/contentforge) — whose test suites
+[contentforge](https://github.com/aimanmalib/contentforge)), whose test suites
 were carried over into this repository (see [docs/porting.md](https://github.com/aimanmalib/crewforge/blob/main/docs/porting.md)
 for what was ported, re-targeted at the shared core, or dropped and why).
 
 The evidence that it works is meant to be checkable: the test suite (run
-`pytest`; it needs no key and no network), CI on Python 3.10–3.13, and the
+`pytest`; it needs no key and no network), CI on Python 3.10–3.14, and the
 real-provider runs shown above, two of which found bugs that were fixed with
 tests before the output was recorded.
 
 ## Contributing
 
-See [CONTRIBUTING.md](https://github.com/aimanmalib/crewforge/blob/main/CONTRIBUTING.md). In short: `pip install -e ".[dev,docs]"`,
-`pytest`, `ruff check . && ruff format --check .`, and every new failure path
+See [CONTRIBUTING.md](https://github.com/aimanmalib/crewforge/blob/main/CONTRIBUTING.md). In short: `uv sync --extra dev --extra docs`
+(versions from the committed `uv.lock`, as in CI), `uv run pytest`,
+`uv run ruff check . && uv run ruff format --check .`, and every new failure path
 needs a test that fails if the guard is removed.
 
 ## Security
@@ -392,10 +383,52 @@ Please report vulnerabilities privately through
 See [SECURITY.md](https://github.com/aimanmalib/crewforge/blob/main/SECURITY.md) for scope notes (what is sent to your provider,
 and what `validate` executes).
 
-## License
+## Bahasa Melayu
+
+crewforge ialah alat baris arahan dan pustaka Python yang menjalankan satu kru ejen LLM melalui lima resipi:
+semakan kod (`review`), soal jawab dokumen (`ask`, `summarize`), penjanaan projek API FastAPI (`scaffold`,
+`validate`), penulisan kandungan (`write`) dan bantuan penulisan akademik yang jujur (`academic`). Ia berfungsi
+dengan mana-mana penyedia serasi OpenAI, termasuk model tempatan melalui Ollama atau llama.cpp. Kunci API hanya
+dibaca dari pemboleh ubah persekitaran, tidak pernah ditulis ke fail.
+
+**Mengapa satu kru.** crewforge menggabungkan empat alat lama (codeguard, documind, apiforge, contentforge) yang
+masing-masing menyimpan salinan sendiri bagi rangka yang sama. Salinan itu sudah berbeza dan setiap satu
+menyembunyikan kegagalan dengan cara sendiri. Kini teras dikongsi: pembaikan dibuat sekali, dan setiap alat menjadi
+resipi di atas teras itu.
+
+**Gagal dengan jelas.** Larian yang ejennya memulangkan jawapan kosong atau tidak boleh dihurai, atau pengesah
+yang tidak menyemak apa-apa, keluar dengan kod 1 dan menamakan ejen itu. Kod keluar: `0` berjaya, `1` larian
+gagal, `2` ralat penggunaan atau konfigurasi. Bilangan token diambil daripada laporan penyedia sahaja, tidak
+dianggar.
+
+**Resipi `academic`.** Membantu pelajar dan penyelidik dengan kerja mereka **sendiri**: merancang dari taklimat
+tugasan, memberi ulasan atas draf tanpa menulis semula, memformat rujukan yang diberi pengguna (APA 7, IEEE,
+Harvard) tanpa menambah rujukan baharu, dan menulis pernyataan penggunaan AI daripada rekod langkah yang
+dijalankan. Output dalam bahasa Inggeris atau Bahasa Melayu (`--language ms`); output BM disemak untuk bentuk
+Indonesia seperti *karena* atau *kualitas*. Sumber yang dicadangkan model dilabel UNVERIFIED, atau LIKELY
+FABRICATED jika tiada DOI, URL atau ISBN. Tiada ciri "humanise" atau mengelak pengesan AI.
+
+**Pasang dan guna.**
+
+```bash
+pip install crewforge                 # Python 3.10 hingga 3.14
+pip install "crewforge[docs,api]"     # pilihan: PDF/DOCX dan semakan aplikasi FastAPI
+export OPENAI_API_KEY=sk-...          # atau penyedia lain, lihat `crewforge providers`
+crewforge review src/
+crewforge academic feedback draf.md --brief taklimat.md --language ms
+```
+
+Senarai penyedia, contoh setiap resipi dan seni bina ada dalam bahagian bahasa Inggeris di atas
+([Providers](https://github.com/aimanmalib/crewforge#providers), [Recipes](https://github.com/aimanmalib/crewforge#recipes)).
+
+## Licence
+
+[MIT](https://github.com/aimanmalib/crewforge/blob/main/LICENSE) © Muhammad Aiman. Made by [Aiman Malib](https://aimanmalib.com), Malaysia.
+
+## Work with Sasa Teguh
 
-[MIT](https://github.com/aimanmalib/crewforge/blob/main/LICENSE) © Muhammad Aiman
+[![Work with Sasa Teguh: book a call](https://raw.githubusercontent.com/sasateguh/.github/main/assets/work-with-sasa-teguh.png)](https://sasateguh.com/book)
 
----
+I built this project. I run [Sasa Teguh](https://sasateguh.com), a studio in Malaysia that builds websites found on Google and in AI answers, and sets up systems like this one for businesses.
 
-Built by [Sasa Teguh](https://sasateguh.com) · Malaysia
+[Book a call](https://sasateguh.com/book) · hello@sasateguh.com · [More from Sasa Teguh](https://github.com/sasateguh)

{crewforge-0.2.0 → crewforge-0.2.2}/pyproject.toml

@@ -4,18 +4,36 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "crewforge"
-version = "0.2.0"
+version = "0.2.2"
 description = "One crew of LLM agents, five recipes: code review, document Q&A, API scaffolding, content and honest academic-writing help — on any OpenAI-compatible provider."
 readme = "README.md"
 license = "MIT"
 license-files = ["LICENSE"]
 requires-python = ">=3.10"
 authors = [{ name = "Muhammad Aiman" }]
-keywords = ["llm", "agents", "multi-agent", "openai", "code-review", "rag", "fastapi", "content-generation", "academic-writing", "cli"]
+keywords = [
+    "llm",
+    "agents",
+    "multi-agent",
+    "ai-agents",
+    "openai",
+    "openai-compatible",
+    "code-review",
+    "rag",
+    "document-qa",
+    "fastapi",
+    "api-scaffolding",
+    "content-generation",
+    "academic-writing",
+    "cli",
+]
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Environment :: Console",
     "Intended Audience :: Developers",
+    "Intended Audience :: Education",
+    "Natural Language :: English",
+    "Natural Language :: Malay",
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
@@ -23,8 +41,12 @@ classifiers = [
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Education",
     "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Code Generators",
     "Topic :: Software Development :: Quality Assurance",
+    "Topic :: Text Processing :: General",
     "Typing :: Typed",
 ]
 dependencies = [
@@ -44,15 +66,19 @@ dev = [
     "pytest-asyncio>=0.23",
     "pytest-cov>=5.0",
     "ruff>=0.6",
+    "mypy>=1.10",
+    "types-PyYAML>=6.0",
     "fastapi>=0.110",
     "httpx>=0.27",
 ]
 
 [project.urls]
 Homepage = "https://github.com/aimanmalib/crewforge"
-Repository = "https://github.com/aimanmalib/crewforge"
-Issues = "https://github.com/aimanmalib/crewforge/issues"
+Documentation = "https://github.com/aimanmalib/crewforge#readme"
 Changelog = "https://github.com/aimanmalib/crewforge/blob/main/CHANGELOG.md"
+Issues = "https://github.com/aimanmalib/crewforge/issues"
+Source = "https://github.com/aimanmalib/crewforge"
+Security = "https://github.com/aimanmalib/crewforge/security/policy"
 
 [project.scripts]
 crewforge = "crewforge.cli:main"
@@ -80,6 +106,22 @@ select = ["E", "F", "W", "I", "UP", "B"]
 [tool.ruff.lint.per-file-ignores]
 "tests/**" = ["B011"]
 
+[tool.mypy]
+# CI runs `mypy` (lint job). Bodies of unannotated functions are checked too.
+files = ["src/crewforge"]
+python_version = "3.10"
+plugins = ["pydantic.mypy"]
+check_untyped_defs = true
+strict_equality = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_unused_configs = true
+
+[[tool.mypy.overrides]]
+# Pre-1.24 PyMuPDF import name, used only as a fallback; it ships no type information.
+module = ["fitz"]
+ignore_missing_imports = true
+
 [tool.coverage.run]
 source = ["crewforge"]
 branch = true

{crewforge-0.2.0 → crewforge-0.2.2}/src/crewforge/__init__.py

@@ -1,3 +1,3 @@
 """crewforge — one crew of LLM agents, five recipes, any OpenAI-compatible provider."""
 
-__version__ = "0.2.0"
+__version__ = "0.2.2"

{crewforge-0.2.0 → crewforge-0.2.2}/src/crewforge/recipes/academic/citations.py

@@ -66,12 +66,13 @@ class Identifiers:
 def identifiers(text: str) -> Identifiers:
     """Find the identifiers in a reference. URLs pointing at doi.org count as the DOI."""
     dois = {_strip_trailing(m.group(1)).lower() for m in _DOI.finditer(text)}
-    urls = set()
+    urls: set[str] = set()
     for m in _URL.finditer(text):
         url = _strip_trailing(m.group(0)).rstrip("/")
         if not any(host in url.lower() for host in _DOI_HOSTS):
             urls.add(url)
-    valid, invalid = set(), set()
+    valid: set[str] = set()
+    invalid: set[str] = set()
     # Springer-style DOIs embed an ISBN ("10.1007/978-3-..."): search the rest only.
     rest = _URL.sub(" ", _DOI.sub(" ", text))
     raw_isbns = [m.group(1) for m in _ISBN_LABELLED.finditer(rest)]