update release v0.1.3

Author: zhe-pang

.clang-format

@@ -0,0 +1,15 @@
+BasedOnStyle: Google
+IndentWidth: 2
+ColumnLimit: 120
+BreakBeforeBraces: Custom
+AlignTrailingComments: true
+AllowShortFunctionsOnASingleLine: None
+AllowShortBlocksOnASingleLine: false
+AllowShortIfStatementsOnASingleLine: true
+AllowShortLoopsOnASingleLine: true
+AlignAfterOpenBracket: Align
+AlignConsecutiveDeclarations: true
+AlignConsecutiveAssignments: true
+BinPackArguments: false
+BinPackParameters: false
+CommentPragmas: false

.gitignore

@@ -0,0 +1,28 @@
+
+# csrc
+csrc/instantiations/*
+
+# mate
+mate/_version.py
+mate/_build_meta.py
+mate/data
+
+# vscode
+.vscode/
+
+# claude
+.claude
+
+# python
+__pycache__/
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+
+# temporary files
+mate/jit/aot-levels.json
+aot-lib/
+temp/
+mate/jit/aot-levels.json

.pre-commit-config.yaml

@@ -0,0 +1,65 @@
+# To use:
+#
+#     pre-commit run -a
+#
+# Or:
+#
+#     pre-commit install  # (runs every time you commit in git)
+#
+# To update this file:
+#
+#     pre-commit autoupdate
+#
+# See https://github.com/pre-commit/pre-commit
+
+repos:
+  # Standard hooks
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: check-added-large-files
+        args: ["--maxkb=1024"]
+      - id: check-case-conflict
+      - id: check-merge-conflict
+      - id: check-symlinks
+      - id: end-of-file-fixer
+      - id: mixed-line-ending
+      - id: requirements-txt-fixer
+      - id: trailing-whitespace
+
+  # Changes tabs to spaces
+  - repo: https://github.com/Lucas-C/pre-commit-hooks
+    rev: v1.5.5
+    hooks:
+      - id: remove-tabs
+      - id: remove-crlf
+
+  # Formatters
+  - repo: https://github.com/pre-commit/mirrors-clang-format
+    rev: v19.1.1
+    hooks:
+      - id: clang-format
+        types_or: [c++, c, cuda]
+        exclude: |
+          (?x)^(3rdparty/.*)$
+
+      - id: clang-format
+        types_or: [file]
+        files: '\.(mu|muh)$'
+        exclude: |
+          (?x)^(3rdparty/.*)$
+
+  -   repo: https://github.com/pre-commit/mirrors-mypy
+      rev: 'v1.17.1'  # Use the sha / tag you want to point at
+      hooks:
+      -   id: mypy
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    # Ruff version.
+    rev: v0.12.8
+    hooks:
+      # Run the linter.
+      - id: ruff-check
+      # Run the formatter.
+      - id: ruff-format
+        types_or: [ python, pyi ]

3rdparty/mutlass

@@ -1,43 +1,89 @@
 # MUSA AI Tensor Engine
 
-MATE(**M**USA **A**I **T**ensor **E**ngine) is a centralized library for Generative AI.
+MATE (**M**USA **A**I **T**ensor **E**ngine) is a centralized library for Generative AI workloads on MUSA. It provides high-performance attention and GEMM operators, and compatibility wrappers for CUDA-oriented Python APIs.
 
-## Installation
+## Highlights
 
-### Requirements
+- High-performance attention and GEMM operators for MUSA
+- Compatibility wrappers for `flash_attn` and `deep_gemm`
+- CLI tools for environment checks, configuration inspection, and replay
 
-MUSA Toolkits: 4.3.4 or later
+## Quick Links
 
-TorchMUSA: 2.7.1 or later
+- CLI documentation: [docs/mate_cli.md](docs/mate_cli.md)
+- FlashAttention compatibility summary: [docs/flash_attention.md](docs/flash_attention.md)
+- FlashAttention wrapper: [wrappers/flash-attention/README.md](wrappers/flash-attention/README.md)
+- DeepGEMM wrapper: [wrappers/deep_gemm/README.md](wrappers/deep_gemm/README.md)
 
-Architecutre: Pinghu(MP31)
+## Requirements
 
-### Install From Source
+| Component | Requirement |
+| --- | --- |
+| MUSA Toolkit | `4.3.6` or later |
+| TorchMUSA | `2.7` or later |
+| Architecture | `Pinghu (MP31)` |
+
+## Build From Source
 
 ```bash
-git clone git@github.com:MooreThreads/mate.git --recursive
+git clone https://github.com/MooreThreads/mate.git --recursive
 cd mate
-pip install --no-build-isolation . -v
+bash build.sh
 ```
 
-### Build From Source
+## Repository Layout
+
+| Path | Purpose |
+| --- | --- |
+| `mate/` | Core Python package and public APIs |
+| `wrappers/` | Compatibility wrapper packages for existing Python ecosystems |
+| `docs/` | Markdown docs and Sphinx sources |
+| `tests/` | Correctness and integration tests |
+| `benchmarks/` | Performance and benchmarking scripts |
+
+## MATE CLI
+
+MATE provides a command-line interface for configuration, debugging, diagnostics, and replay.
+
+| Command | Purpose |
+| --- | --- |
+| `mate check` | Validate the runtime environment |
+| `mate show-config` | Display installation and runtime configuration |
+| `mate env` | Show relevant environment variables |
+| `mate replay --dir PATH` | Replay API calls from Level 10 dumps |
+| `mate list-dumps PATH` | List recorded dump directories |
+
+Example:
 
 ```bash
-git clone git@github.com:MooreThreads/mate.git --recursive
-cd mate
-python -m build --wheel --no-isolation
+mate check
+mate show-config
+mate env
+mate replay --dir mate_dumps/
+mate list-dumps mate_dumps/
 ```
 
-## Build Docs
+See [docs/mate_cli.md](docs/mate_cli.md) for full CLI documentation.
+
+## Wrappers
+
+MATE uses the packages under `wrappers/` as a compatibility layer for CUDA-oriented software stacks on MUSA. These wrappers preserve familiar package names and high-level APIs while routing execution to MATE operators and kernels on MUSA, which helps existing integrations migrate with smaller code changes.
+
+| Wrapper | Package | Import Path | Purpose | Documentation |
+| --- | --- | --- | --- | --- |
+| `wrappers/flash-attention` | `mate-flash-attention` | `flash_attn` | FlashAttention-compatible APIs on top of MATE attention operators on MUSA | [wrapper README](wrappers/flash-attention/README.md), [compatibility summary](docs/flash_attention.md) |
+| `wrappers/deep_gemm` | `mate-deep_gemm` | `deep_gemm` | DeepGEMM-compatible APIs on top of MATE GEMM operators on MUSA | [wrapper README](wrappers/deep_gemm/README.md) |
+
+## Build Documentation
 
-**After installing mate**, run the following commands:
+After installing `mate`, build the Sphinx docs with:
 
 ```bash
 pip install sphinx furo
-cd mate/docs
+cd docs
 make html
 ```
 
 ## Acknowledgement
 
-Mate is inspired by [FlashInfer](https://github.com/flashinfer-ai/flashinfer), [FlashAttention](https://github.com/Dao-AILab/flash-attention), [cutlass](https://github.com/NVIDIA/cutlass), [FlashMLA](https://github.com/deepseek-ai/FlashMLA) and [DeepGemm](https://github.com/deepseek-ai/DeepGEMM) projects.
+MATE is inspired by [FlashInfer](https://github.com/flashinfer-ai/flashinfer), [FlashAttention](https://github.com/Dao-AILab/flash-attention), [cutlass](https://github.com/NVIDIA/cutlass), [FlashMLA](https://github.com/deepseek-ai/FlashMLA), and [DeepGemm](https://github.com/deepseek-ai/DeepGEMM).