fix: replace placeholder URLs with SafewareTaiwan/leanai-asstf; add CI/CD workflows

Author: SafewareTaiwan

.github/FUNDING.yml

@@ -1,6 +1,6 @@
 # Funding and commercial licensing
 
-custom: ["https://github.com/safeware/Project_LeanAI/blob/main/docs/COMMERCIAL_LICENSE.md"]
+custom: ["https://github.com/SafewareTaiwan/leanai-asstf/blob/main/docs/COMMERCIAL_LICENSE.md"]
 
 # For commercial licensing inquiries, contact:
 # Bentley@safeware.com.tw

.github/workflows/ci.yml

@@ -8,12 +8,16 @@ on:
 
 jobs:
   test:
+    name: Test (${{ matrix.os }}, Python ${{ matrix.python-version }})
     runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest, macos-latest]
-        python-version: ["3.9", "3.10", "3.11", "3.12"]
+        os: [ubuntu-latest]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+        include:
+          - os: macos-latest
+            python-version: "3.13"
 
     steps:
       - name: Checkout repository
@@ -23,25 +27,14 @@ jobs:
         uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
+          cache: pip
 
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
           pip install -r requirements.txt
           pip install -r requirements-dev.txt
-
-      - name: Lint with ruff
-        run: |
-          ruff check asstf shared tests
-
-      - name: Check formatting with black
-        run: |
-          black --check asstf shared tests
-
-      - name: Type check with mypy
-        run: |
-          mypy asstf shared
+          pip install -r requirements-optional.txt
 
       - name: Run unit tests
-        run: |
-          pytest tests/ -v
+        run: pytest tests/ -v

.github/workflows/lint.yml

@@ -0,0 +1,36 @@
+name: Lint
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  lint:
+    name: Lint & Format
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+          cache: pip
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install -r requirements-dev.txt
+
+      - name: Lint with ruff
+        run: ruff check asstf shared tests
+
+      - name: Check formatting with black
+        run: black --check asstf shared tests
+
+      - name: Type check with mypy
+        run: mypy asstf shared

.github/workflows/publish.yml

@@ -0,0 +1,39 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  build-and-publish:
+    name: Build and publish package to PyPI
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/leanai-asstf
+    permissions:
+      id-token: write  # Required for Trusted Publishing (OIDC)
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+          cache: pip
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish package to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to the ASSTF project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.1] - 2026-07-05
+
+### Changed
+
+- Expanded PyPI keywords with core and extended SEO terms for better discoverability.
+
 ## [1.0.0] - 2026-07-05
 
 ### Added

CONTRIBUTING.md

@@ -10,7 +10,7 @@ This project is dual-licensed under the [LeanAI ASSTF Community License](LICENSE
 
 ### Reporting Bugs
 
-1. Check if the issue already exists in [GitHub Issues](https://github.com/safeware/Project_LeanAI/issues).
+1. Check if the issue already exists in [GitHub Issues](https://github.com/SafewareTaiwan/leanai-asstf/issues).
 2. If not, open a new issue using the **Bug Report** template.
 3. Include:
    - A clear description of the bug
@@ -58,8 +58,8 @@ We especially welcome benchmarks on public datasets! To contribute:
 ## Development Setup
 
 ```bash
-git clone https://github.com/safeware/Project_LeanAI.git
-cd Project_LeanAI
+git clone https://github.com/SafewareTaiwan/leanai-asstf.git
+cd leanai-asstf
 python3 -m venv .venv
 source .venv/bin/activate
 pip install -r requirements.txt

Document/ASSTF-based project.docx

@@ -0,0 +1,57 @@
+# LeanAI ASSTF Community License
+
+Version 1.0 - Effective Date: 2026-07-03
+
+This License Agreement (the "Agreement") is a legal contract between Safeware Technologies Inc., Ltd. (the "Licensor") and you (the "Licensee") for the use of the LeanAI ASSTF software and associated documentation (the "Software").
+
+## 1. Definitions
+
+- **Software**: The source code, model definitions, training scripts, evaluation scripts, documentation, and any other materials distributed under this License.
+- **ASSTF Technology**: The Adaptive State-Space Transfer Function algorithm, mathematical formulations, and related proprietary techniques described in the Licensor's technical publications and patent applications.
+- **Non-Commercial Use**: Use that is not primarily intended for, or directed toward, commercial advantage or monetary compensation.
+- **Commercial Use**: Any use that is not Non-Commercial Use, including but not limited to incorporation into products or services offered for sale, deployment in revenue-generating operations, SaaS offerings, and use by for-profit entities in the course of business.
+
+## 2. Grant of Rights
+
+Subject to the restrictions set forth in Section 3, the Licensor hereby grants the Licensee a worldwide, royalty-free, non-exclusive, non-transferable license to:
+
+1. Use the Software for Non-Commercial purposes.
+2. Study, modify, and create derivative works of the Software for Non-Commercial purposes.
+3. Distribute copies of the Software and derivative works, provided that such distribution is also under the terms of this Community License.
+4. Publish research results, benchmarks, and educational materials based on the Software, provided that the Licensor and the ASSTF Technology are properly attributed.
+
+## 3. Restrictions
+
+1. **No Commercial Use**. The Licensee may not use the Software, in whole or in part, for any Commercial Use without obtaining a separate Commercial License from the Licensor.
+2. **No Patent Grant**. This License does not grant the Licensee any rights under the Licensor's patents, patent applications, trade secrets, or other intellectual property relating to the ASSTF Technology, except as expressly necessary to exercise the rights granted in Section 2.
+3. **Attribution**. The Licensee must retain all copyright, patent, trademark, and attribution notices contained in the Software. Any distributed derivative work must include a prominent notice stating that it is based on the LeanAI ASSTF Software and provide a link to the original repository.
+4. **No Warranty Disclaimer Removal**. The Licensee may not remove or alter any warranty disclaimers or liability limitations in this License.
+5. **No Endorsement**. The Licensee may not use the Licensor's trademarks or imply endorsement without prior written permission.
+
+## 4. Source Code Availability
+
+The source code of the Software is made available to the Licensee under this License. Availability of source code does not constitute a grant of rights in the underlying ASSTF Technology beyond the limited scope expressly stated herein.
+
+## 5. Termination
+
+This License automatically terminates if the Licensee violates any of its terms. Upon termination, the Licensee must immediately cease all use and distribution of the Software and destroy all copies in its possession.
+
+## 6. Disclaimer of Warranty
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT.
+
+## 7. Limitation of Liability
+
+IN NO EVENT SHALL THE LICENSOR BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+## 8. Commercial Licensing
+
+For Commercial Use, please contact:
+
+Safeware Technologies Inc., Ltd.  
+Attn: LeanAI Licensing Department  
+Email: Bentley@safeware.com.tw
+
+## 9. Governing Law
+
+This Agreement shall be governed by and construed in accordance with the laws of the jurisdiction in which the Licensor is headquartered, without regard to conflict of law principles.

Document/OpenSourceStrategy.docx

@@ -1,37 +1,21 @@
-# Project_LeanAI - ASSTF Stage 1
-
-ASSTF (Adaptive State-Space Transfer Function): A PyTorch framework for dynamic neural topology that reduces parameters by 5-10x, enables test-time adaptation, and outperforms static models on structure-sensitive tasks.
-
-Project_LeanAI is a source-available research implementation of Adaptive State-Space Transfer Functions (ASSTF) for non-commercial research and educational use.
-
- 
-
----
-
 <div align="center">
-  <img src="assets/logo.png?raw=true" alt="ASSTF Logo" width="120">
+  <img src="assets/logo.svg" alt="ASSTF Logo" width="120">
   <h1>LeanAI ASSTF</h1>
   <p><strong>Adaptive State-Space Transfer Function</strong></p>
 </div>
 
----
-
-&nbsp;
-
 [![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
 [![PyTorch 2.0+](https://img.shields.io/badge/PyTorch-2.0+-ee4c2c.svg)](https://pytorch.org/)
 [![License: Community/Commercial](https://img.shields.io/badge/license-Community%2FCommercial-orange.svg)](LICENSE)
-[![Tests](https://img.shields.io/badge/tests-pytest-green.svg)](tests/)
+[![Tests](https://github.com/SafewareTaiwan/leanai-asstf/actions/workflows/ci.yml/badge.svg)](https://github.com/SafewareTaiwan/leanai-asstf/actions)
 
 > **Tiny, self-adapting neural layers for efficient edge AI and continual learning.**
 
 ASSTF (Adaptive State-Space Transfer Function) is a PyTorch framework that lets neural layers continuously reconfigure their effective state space through a small set of **structural parameters**. It combines **parameter-efficient learning** with **inference-time adaptation**, making it ideal for edge devices, personalization, and continual learning.
 
-Project_LeanAI is a source-available research implementation of Adaptive State-Space Transfer Functions (ASSTF). It is licensed under the LeanAI ASSTF Community License for non-commercial research and educational use. For commercial use, SaaS deployment, or redistribution in products, please contact Safeware Technologies for a commercial license.
-
 ---
 
-[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/safeware/Project_LeanAI/blob/main/notebooks/ASSTF_Quickstart.ipynb)
+[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/SafewareTaiwan/leanai-asstf/blob/main/notebooks/ASSTF_Quickstart.ipynb)
 
 ## 🚀 Current Status: Stage 1 — Grounding Credit
 
@@ -74,8 +58,8 @@ out = layer(x)  # shape: (16, 64)
 Train and evaluate all six demos:
 
 ```bash
-git clone https://github.com/YOUR_ORG/Project_LeanAI.git
-cd Project_LeanAI
+git clone https://github.com/SafewareTaiwan/leanai-asstf.git
+cd leanai-asstf
 python3 -m venv .venv && source .venv/bin/activate
 pip install -r requirements.txt
 pytest tests/ -v
@@ -95,8 +79,8 @@ pip install leanai-asstf
 ### From source
 
 ```bash
-git clone https://github.com/YOUR_ORG/Project_LeanAI.git
-cd Project_LeanAI
+git clone https://github.com/SafewareTaiwan/leanai-asstf.git
+cd leanai-asstf
 pip install -r requirements.txt
 ```
 
@@ -201,7 +185,7 @@ python run_all.py
 ## Project Structure
 
 ```
-Project_LeanAI/
+leanai-asstf/
 ├── asstf/                  # Core ASSTF framework
 ├── shared/                 # Baselines, metrics, early stopping
 ├── app_01_gesture/         # Gesture recognition demo