Merge pull request #15 from FlowLLM-AI/dev/0625

refactor(framework): introduce component-based application architecture

Author: jinliyl

.github/workflows/pre-commit.yml

@@ -11,13 +11,13 @@ jobs:
         os: [ ubuntu-latest ]
     env:
       OS: ${{ matrix.os }}
-      PYTHON: '3.10'
+      PYTHON: '3.11'
     steps:
       - uses: actions/checkout@master
       - name: Setup Python
         uses: actions/setup-python@master
         with:
-          python-version: '3.10'
+          python-version: '3.11'
       - name: Update setuptools
         run: |
           pip install -U setuptools wheel
@@ -35,4 +35,4 @@ jobs:
             echo -e "\e[41m  [**FAIL**] Please install pre-commit and format your code first. \e[0m"
             exit 1
           fi
-          echo -e "\e[46m  ********************************Passed******************************** \e[0m"
+          echo -e "\e[46m  ********************************Passed******************************** \e[0m"

.github/workflows/python-publish.yml

@@ -22,11 +22,11 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
     - name: Set up Python
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
-        python-version: '3.10'
+        python-version: '3.11'
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip

.github/workflows/unittest.yml

@@ -0,0 +1,43 @@
+name: Tests FlowLLM
+
+on:
+  push:
+    branches: [main, master, dev, develop]
+  pull_request:
+    branches: [main, master, dev, develop]
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  unit-tests:
+    name: Unit Tests - py${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: 'pip'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip setuptools wheel
+          pip install -e ".[dev,core]"
+
+      - name: Run unit tests
+        run: |
+          pytest tests/unit \
+            -v \
+            --tb=long \
+            -s \
+            --log-cli-level=WARNING

.gitignore

@@ -1,25 +1,54 @@
-.vscode
-.env*
+# OS / editor
 .DS_Store
-.idea
+.idea/
+.vscode/
+*.code-workspace
+
+# Local environment
+.env
+.env.*
+!.env.example
+!example.env
+.venv/
 venv/
-.ipynb_checkpoints
-.__pycache__
-__pycache__
-*.log
-tmp*
-temp*
-private*
+env/
+private*/
+
+# Python caches / test artifacts
+__pycache__/
+*.py[cod]
+*$py.class
+.ipynb_checkpoints/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+coverage.xml
+htmlcov/
+
+# Packaging / build outputs
+build/
 dist/
-nohup*
+*.egg-info/
+
+# Logs / temporary files
+*.log
+nohup.out
+nohup*.out
 log/
-**/logs/*
+logs/
+runs/
+tmp*/
+temp*/
 .trash/
-runs
-logs
-*.egg-info/*
-build/*
-**/cache/**
-*.pdf
-*.csv
-site/*
+
+# FlowLLM runtime data
+.flowllm/
+vault/
+*.db
+*.sqlite
+*.sqlite3
+
+# Documentation build outputs
+docs/_build/
+site/

.pre-commit-config.yaml

@@ -3,35 +3,25 @@ repos:
     rev: v6.0.0
     hooks:
       - id: check-ast
-        exclude: ^old/
       - id: check-yaml
-        exclude: ^old/
       - id: check-xml
-        exclude: ^old/
       - id: check-toml
-        exclude: ^old/
       - id: check-json
-        exclude: ^old/
       - id: detect-private-key
-        exclude: ^old/
       - id: trailing-whitespace
-        exclude: ^old/
   - repo: https://github.com/asottile/add-trailing-comma
     rev: v4.0.0
     hooks:
       - id: add-trailing-comma
-        exclude: ^old/
   - repo: https://github.com/psf/black
     rev: 25.9.0
     hooks:
     - id: black
-      exclude: ^old/
       args: [--line-length=120]
   - repo: https://github.com/PyCQA/flake8
     rev: 7.3.0
     hooks:
       - id: flake8
-        exclude: ^old/
         args: [
           "--extend-ignore=E203",
           "--max-line-length=120"
@@ -42,8 +32,7 @@ repos:
       - id: pylint
         exclude:
             (?x)(
-                ^old/
-                | ^docs
+                ^docs
                 | pb2\.py$
                 | grpc\.py$
                 | \.demo$
@@ -54,6 +43,7 @@ repos:
           --disable=W0511,
           --disable=W0718,
           --disable=W0122,
+          --disable=W1203,
           --disable=C0103,
           --disable=R0913,
           --disable=R0917,
@@ -81,8 +71,9 @@ repos:
           --disable=C3001,
           --disable=R1702,
           --disable=R0912,
+          --max-statements=120,
           --max-line-length=120,
-          --max-statements=75,
+          --max-module-lines=1500,
         ]
   - repo: https://github.com/regebro/pyroma
     rev: "5.0"

LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2024 FlowLLM
+   Copyright 2025 Alibaba Group
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.