chore: cleanup dependencies and dev commands (#316)

Author: WH-2099

.github/pull_request_template.md

@@ -12,5 +12,5 @@ Thank you for your contribution! Before submitting your PR, please make sure you
 
 ## Available Checks
 
-- [ ] Code has passed local tests
+- [ ] `just build` has passed
 - [ ] Relevant documentation has been updated (if necessary)

.github/workflows/mkdocs.yml

@@ -30,11 +30,14 @@ jobs:
           cache-dependency-glob: uv.lock
           python-version: ${{ matrix.python-version }}
 
+      - name: Install just
+        uses: extractions/setup-just@53165ef7e734c5c07cb06b3c8e7b647c5aa16db3 # v4
+
       # - name: Debug
       #   uses: mxschmitt/action-tmate@v3
 
       - name: Build raw docs
-        run: make docs
+        run: just docs
 
       - name: Deploy docs
         uses: mhausenblas/mkdocs-deploy-gh-pages@master

.github/workflows/pr.yml

@@ -58,8 +58,11 @@ jobs:
           cache-dependency-glob: uv.lock
           python-version: "3.12"
 
+      - name: Install just
+        uses: extractions/setup-just@53165ef7e734c5c07cb06b3c8e7b647c5aa16db3 # v4
+
       - name: Run checks
-        run: make check
+        run: just check
 
   test:
     name: Test

.github/workflows/pypi_publish.yaml

@@ -70,8 +70,11 @@ jobs:
           cache-dependency-glob: uv.lock
           python-version: "3.12"
 
+      - name: Install just
+        uses: extractions/setup-just@53165ef7e734c5c07cb06b3c8e7b647c5aa16db3 # v4
+
       - name: Build distributions
-        run: make build
+        run: just build
 
       - name: Upload distributions
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1

.github/workflows/test.yml

@@ -28,11 +28,14 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
 
+      - name: Install just
+        uses: extractions/setup-just@53165ef7e734c5c07cb06b3c8e7b647c5aa16db3 # v4
+
       - name: Setup dify-plugin-cli
         run: ./scripts/setup-dify-plugin-cli.sh
 
       - name: Install dependencies
-        run: make dev
+        run: just dev
 
       - name: Run tests
-        run: make test
+        run: just test

AGENTS.md

@@ -7,33 +7,38 @@ This file provides guidance for agents working with code in this repository.
 ### Python SDK Development
 
 **Testing:**
+
 ```bash
-make test                              # Run all tests
+just test                              # Run all tests
 uv run pytest tests/specific_test.py   # Run specific test
 ```
 
 **Linting and Formatting:**
+
 ```bash
-make check                             # Check lockfile, formatting, and linting
-make lint                              # Check linting only
-make format                            # Apply formatting fixes
+just check                             # Check lockfile, formatting, and linting
+just lint                              # Check linting only
+just format                            # Apply formatting fixes
 ```
 
 **Documentation Generation:**
+
 ```bash
-make docs                              # Generate schema documentation
+just docs                              # Generate schema documentation
 ```
 
 **Build and Environment:**
+
 ```bash
-make dev                               # Sync default dev dependencies
-make build                             # Build source and wheel distributions
-make clean                             # Remove local build/test artifacts
+just dev                               # Sync default dev dependencies
+just build                             # Build source and wheel distributions
+just clean                             # Remove local build/test artifacts
 ```
 
 ## Project Architecture
 
 ### Repository Structure
+
 - **Root Level:** Python SDK package, project metadata, tests, and examples
 - **`src/dify_plugin/`:** Main Python SDK implementation
 - **`examples/`:** Complete plugin examples (GitHub, OpenAI, Jina, etc.)
@@ -43,48 +48,56 @@ make clean                             # Remove local build/test artifacts
 The Dify Plugin SDK follows a modular architecture with clear separation of concerns:
 
 #### Core Components (`src/dify_plugin/core/`)
+
 - **`runtime.py`:** Session management and backwards invocation system
 - **`plugin_executor.py`:** Main execution engine for plugin operations
 - **`plugin_registration.py`:** Plugin discovery and registration system
 - **`server/`:** Multi-protocol communication layer (stdio, TCP, serverless)
 
 #### Plugin Types (`src/dify_plugin/interfaces/`)
+
 - **`model/`:** AI model integrations (LLM, embedding, TTS, etc.)
 - **`tool/`:** Tool providers and individual tools
 - **`agent/`:** Agent strategy implementations
 - **`endpoint/`:** HTTP endpoint handlers
 - **`trigger/`:** Event trigger handlers
 
 #### Communication Patterns
+
 1. **Local Install:** stdio-based communication for development
 2. **Remote Install:** TCP-based communication for production deployment
 3. **Serverless:** HTTP-based communication for serverless environments
 
 #### Plugin Manifest System
+
 - **`manifest.yaml`:** Plugin metadata and configuration
 - **Version Management:** Semantic versioning with compatibility matrix
 - **Runtime Configuration:** Memory limits, permissions, language requirements
 
 ### Key Architectural Patterns
 
 #### Session-based Runtime
+
 - Each plugin operation runs in a `Session` context
 - Sessions provide access to invocations (model, tool, app, storage, file)
 - Backwards invocation allows plugins to call Dify services
 
 #### Multi-Modal Communication
+
 - **Full-duplex:** Real-time bidirectional communication (Local/Remote)
 - **HTTP streaming:** Server-sent events for serverless environments
 - **Blob handling:** Chunked transfer for large binary data
 
 #### Provider-Tool Architecture
+
 - **Providers:** Authentication and configuration management
 - **Tools:** Individual operations within a provider
 - **Credentials:** OAuth and API key management with validation
 
 ## Plugin Examples Structure
 
 Each example in `examples/` follows a consistent structure:
+
 - **`manifest.yaml`:** Plugin metadata
 - **`main.py`:** Plugin entry point
 - **`provider/`:** Provider configuration and implementation
@@ -102,5 +115,5 @@ Each example in `examples/` follows a consistent structure:
 
 1. Use existing examples as templates for new plugins
 2. Implement plugin interfaces in the appropriate category
-3. Run `make check` before submitting code changes
-4. Run `make test` when changes affect runtime behavior, SDK interfaces, or examples
+3. Run `just check` before submitting code changes
+4. Run `just test` when changes affect runtime behavior, SDK interfaces, or examples

Makefile

@@ -4,6 +4,24 @@ A Python SDK for building plugins for Dify.
 
 Here is a short introduction to Dify Plugin: <https://docs.dify.ai/plugins/introduction>
 
+## Development
+
+This repository uses [`just`](https://github.com/casey/just) as its command runner.
+Install it with your preferred package manager, or with uv:
+
+```bash
+uv tool install rust-just
+```
+
+Common development commands:
+
+```bash
+just dev      # Sync default dev dependencies
+just check    # Check lockfile, formatting, and linting
+just test     # Run all tests
+just build    # Build source and wheel distributions
+```
+
 ## Version Management
 
 This SDK follows Semantic Versioning (a.b.c):
@@ -22,7 +40,7 @@ When depending on this SDK, it's recommended to specify version constraints that
 Example in your project's dependency management:
 
 ```python
-dify_plugin~=0.7
+dify_plugin >= 0.8
 ```
 
 ## Manifest Version Reference
@@ -54,3 +72,4 @@ For the manifest specification, we've introduced two versioning fields:
 | 1.9.0                | 0.5.0         | Support Datasource functionality for plugins       |
 | 1.10.0               | 0.6.0         | Support Trigger functionality for plugins          |
 | 1.11.0               | 0.7.0         | Support Multimodal Reranking / Embeddings          |
+| 1.14.0               | 0.8.0         | Dependency and project structure cleanup           |

README.md

@@ -0,0 +1,30 @@
+dev:
+    uv sync
+
+format:
+    uv run ruff format
+
+lint:
+    uv run ruff check
+
+check:
+    uv lock --check
+    uv run ruff format --check --diff
+    uv run ruff check
+
+test:
+    uv run pytest
+
+docs:
+    uv run python -m dify_plugin.cli generate-docs
+    mkdir -p .mkdocs/docs
+    mv docs.md .mkdocs/docs/schema.md
+
+build:
+    uv build --no-create-gitignore --no-sources
+
+clean:
+    find . -type d -name '__pycache__' -prune -exec rm -rf {} +
+    rm -rf dist/ .pytest_cache/ .ruff_cache/
+    rm -f docs.md langgenius-openai.difypkg
+    uv run ruff clean

justfile

@@ -1,4 +1,4 @@
-minimum_prek_version = "0.3.8"
+minimum_prek_version = "0.3.13"
 
 [[repos]]
 repo = 'builtin'
@@ -28,9 +28,9 @@ hooks = [
 repo = 'local'
 
 [[repos.hooks]]
-id = 'make-check'
-name = 'make check'
-entry = 'make check'
+id = 'just-check'
+name = 'just check'
+entry = 'just check'
 language = 'system'
 always_run = true
 pass_filenames = false