Feature/pypi release

.github/workflows/ci.yml

@@ -11,7 +11,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: astral-sh/setup-uv@v3
+      - uses: astral-sh/setup-uv@v4
         with:
           version: "0.4.x"
       - uses: extractions/setup-just@v2
@@ -26,7 +26,7 @@ jobs:
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@v4
-      - uses: astral-sh/setup-uv@v3
+      - uses: astral-sh/setup-uv@v4
         with:
           version: "0.4.x"
       - uses: extractions/setup-just@v2

.github/workflows/release.yml

@@ -0,0 +1,30 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      id-token: write # For trusted publishing
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v4
+        with:
+          version: "0.4.x"
+
+      - name: Build package
+        run: |
+          cd packages/clerk
+          uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: packages/clerk/dist/

.gitignore

@@ -221,3 +221,7 @@ tmp_mcp_030/
 
 # Apple
 .DS_Store
+
+outputs/
+*.docx
+*.doc

AGENTS.md

@@ -18,6 +18,9 @@ uv sync
 uv run clerk list                    # List reasoning kits
 uv run clerk run <name>              # Run a kit
 uv run clerk run <name> --evaluate   # Run with evaluation
+uv run clerk run <name> --dynamic-resource resource_1="text"  # Inline dynamic resource
+uv run clerk run <name> --stdin resource_1                     # Pipe dynamic resource
+uv run clerk validate <name>         # Validate kit structure
 
 # Testing
 uv run pytest                        # Run all tests
@@ -148,10 +151,28 @@ frontend/src/
 ## Reasoning Kit Conventions
 
 - Resources: `resource_*.txt` or `resource_*.csv`
+- Dynamic resources: `dynamic_resource_*.txt` (provided at runtime)
 - Instructions: `instruction_*.txt` (numbered: 1, 2, 3...)
-- Placeholders: `{resource_N}` and `{workflow_N}`
+- Tools: `tool_*.json` referencing the global registry (e.g., `{"tool_name": "read_url"}`)
+- MCP servers: `mcp_servers.json` (kit-local override, merges with project-root config)
+- Placeholders: `{resource_N}`, `{workflow_N}`, and `{tool_N}`
 - Evaluations: stored in `evaluations/*.json`
 
+### MCP Server Config (`mcp_servers.json`)
+
+Supported transports: `stdio` (default), `sse`, `http`.
+
+```json
+{
+  "mcpServers": {
+    "opencaselaw": {
+      "transport": "sse",
+      "url": "https://mcp.opencaselaw.ch"
+    }
+  }
+}
+```
+
 ## Environment Setup
 
 ```bash

Justfile

@@ -43,6 +43,30 @@ dev-backend:
 dev-frontend:
     cd apps/website && npm run dev
 
+# Sync documentation to website
+sync-docs:
+    ./scripts/sync-docs.sh
+
+# Build website for production (includes docs sync)
+build-website: sync-docs
+    cd apps/website && npm run build
+
+# Build package for distribution
+build:
+    uv build packages/clerk
+
+# Publish to TestPyPI
+publish-test: build
+    uv publish --index testpypi dist/openclerk-*
+
+# Publish to PyPI (requires credentials)
+publish: build
+    uv publish dist/openclerk-*
+
+# Bump package version (e.g., just version patch)
+version BUMP:
+    cd packages/clerk && uvx bump-my-version bump {{BUMP}}
+
 # Clean build artifacts
 clean:
     find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true