vibesop 4.2.0__tar.gz

vibesop-4.2.0/.claude/settings.local.json

@@ -0,0 +1,15 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(find .:*)",
+      "Bash(cat .vibe/skills/*/SKILL.md)",
+      "Bash(uv run:*)",
+      "Bash(vibe route:*)",
+      "Bash(vibe --help)",
+      "Bash(vibe install:*)",
+      "Bash(python:*)",
+      "Bash(ls -lh src/vibesop/cli/commands/skill*.py)",
+      "Bash(grep -r \"vibe skill add\" docs/*.md examples/*.md)"
+    ]
+  }
+}

vibesop-4.2.0/.github/CODEOWNERS

@@ -0,0 +1,19 @@
+# CODEOWNERS for VibeSOP
+# https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
+
+* @nehcuh
+
+# Core modules
+/src/vibesop/routing/ @nehcuh
+/src/vibesop/workflow/ @nehcuh
+/src/vibesop/skills/ @nehcuh
+/src/vibesop/core/ @nehcuh
+
+# CLI
+/src/vibesop/cli/ @nehcuh
+
+# Tests
+/tests/ @nehcuh
+
+# Documentation
+/docs/ @nehcuh

vibesop-4.2.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,58 @@
+---
+name: Bug report
+about: Report a problem with VibeSOP
+title: '[BUG] '
+labels: bug
+assignees: ''
+---
+
+## Bug Description
+
+A clear and concise description of what the bug is.
+
+## Steps to Reproduce
+
+Steps to reproduce the behavior:
+
+1. Run command: `vibe ...`
+2. Input: `...`
+3. Observe: `...`
+
+## Expected Behavior
+
+What you expected to happen.
+
+## Actual Behavior
+
+What actually happened. Include error messages, stack traces, etc.
+
+```python
+# Paste code or error messages here
+```
+
+## Environment
+
+- **OS**: [e.g. Ubuntu 22.04, macOS 14, Windows 11]
+- **Python Version**: [e.g. 3.12.0]
+- **VibeSOP Version**: [e.g. 1.0.0]
+- **Installation Method**: [e.g. pip install, from source]
+
+## Logs
+
+Please paste relevant logs here:
+
+```
+# Paste logs here
+```
+
+## Output/Logs
+
+If applicable, add CLI output or logs to help explain your problem.
+
+## Additional Context
+
+Add any other context about the problem here.
+
+## Possible Solution
+
+If you have ideas on how to fix this, please describe them here.

vibesop-4.2.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,51 @@
+---
+name: Feature request
+about: Suggest an idea for VibeSOP
+title: '[FEATURE] '
+labels: enhancement
+assignees: ''
+---
+
+## Feature Description
+
+A clear and concise description of the feature you'd like to see added to VibeSOP.
+
+## Problem Statement
+
+What problem does this feature solve? Why is it needed?
+
+## Proposed Solution
+
+Describe the solution you'd like to see implemented.
+
+## Alternatives Considered
+
+Describe any alternative solutions or features you've considered.
+
+## Additional Context
+
+Add any other context, mockups, or examples about the feature request here.
+
+## Priority
+
+How important is this feature to you?
+
+- [ ] Critical
+- [ ] High
+- [ ] Medium
+- [ ] Low
+- [ ] Nice to have
+
+## Implementation Ideas
+
+If you have ideas on how this could be implemented, please describe them here.
+
+## Willing to Contribute
+
+- [ ] Yes, I'd like to implement this feature
+- [ ] No, I don't have time to implement it
+- [ ] Maybe, I'd need guidance
+
+## Additional Notes
+
+Any other information you'd like to share.

vibesop-4.2.0/.github/dependabot.yml

@@ -0,0 +1,20 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 10
+    commit-message:
+      prefix: "deps"
+    labels:
+      - "dependencies"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    commit-message:
+      prefix: "ci"
+    labels:
+      - "ci"

vibesop-4.2.0/.github/pull_request_template.md

@@ -0,0 +1,78 @@
+## Description
+
+Briefly describe the changes made in this pull request.
+
+## Type of Change
+
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update (changes to documentation only)
+- [ ] Refactoring (code improvement without changing functionality)
+- [ ] Performance improvement (code optimization)
+- [ ] Tests (adding or updating tests)
+
+## Related Issues
+
+Fixes #(issue number)
+Related to #(issue number)
+Closes #(issue number)
+
+## Changes Made
+
+List the main changes made in this PR:
+
+- Change 1
+- Change 2
+- Change 3
+
+## Testing
+
+Describe the tests you ran and how you verified your changes:
+
+```bash
+# Commands run to test
+pytest tests/ -v
+ruff check src/
+pyright src/
+```
+
+- [ ] Tests added/updated
+- [ ] All tests pass
+- [ ] Manual testing completed
+
+## Checklist
+
+- [ ] My code follows the style guidelines of this project
+- [ ] I have performed a self-review of my code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings
+- [ ] I have added tests that prove my fix is effective or that my feature works
+- [ ] New and existing tests pass locally with my changes
+- [ ] I have updated the CHANGELOG.md if applicable
+- [ ] I have updated type hints for all modified functions
+
+## Breaking Changes
+
+If this PR introduces breaking changes, please describe them here:
+
+1. Breaking change 1
+2. Breaking change 2
+
+Include migration instructions if applicable.
+
+## Screenshots (if applicable)
+
+If your changes affect the UI or configuration, add screenshots to help verify your changes.
+
+## Additional Notes
+
+Any additional information or context about this PR.
+
+## Reviewer Notes
+
+Any specific areas you'd like reviewers to focus on:
+
+- Area 1
+- Area 2

vibesop-4.2.0/.github/workflows/ci.yml

@@ -0,0 +1,125 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+env:
+  UV_VERSION: "0.5.0"
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: ${{ env.UV_VERSION }}
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run ruff lint
+        run: uv run ruff check .
+
+      - name: Run ruff format check
+        run: uv run ruff format --check .
+
+  type-check:
+    name: Type Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: ${{ env.UV_VERSION }}
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run basedpyright
+        run: uv run basedpyright
+
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: ${{ env.UV_VERSION }}
+
+      - name: Set up Python
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run tests with coverage
+        run: uv run pytest --cov=src/vibesop --cov-report=xml --cov-report=term-missing --cov-fail-under=80
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          file: ./coverage.xml
+          fail_ci_if_error: false
+
+  security:
+    name: Security Scan
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Install pip-audit
+        run: uv pip install pip-audit
+
+      - name: Run pip-audit
+        run: uv run pip-audit
+
+  benchmark:
+    name: Performance Benchmark
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: ${{ env.UV_VERSION }}
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run routing benchmarks
+        run: uv run pytest -m benchmark -v

vibesop-4.2.0/.github/workflows/release.yml

@@ -0,0 +1,53 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  # Gate: Run CI checks before release
+  ci-gate:
+    name: CI Gate
+    uses: ./.github/workflows/ci.yml
+
+  release:
+    name: Publish to PyPI
+    needs: ci-gate
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Verify version matches tag
+        run: |
+          TAG_VERSION=${GITHUB_REF#refs/tags/v}
+          PYPROJECT_VERSION=$(uv run python -c "import tomllib; print(tomllib.load(open('pyproject.toml', 'rb'))['project']['version'])")
+          if [ "$TAG_VERSION" != "$PYPROJECT_VERSION" ]; then
+            echo "Version mismatch: tag=$TAG_VERSION pyproject=$PYPROJECT_VERSION"
+            exit 1
+          fi
+          echo "Version verified: $TAG_VERSION"
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          files: dist/*

vibesop-4.2.0/.gitignore

@@ -0,0 +1,84 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# uv
+.uv/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Testing
+.pytest_cache/
+.coverage
+.coverage.*
+coverage.xml
+htmlcov/
+*.cover
+.hypothesis/
+
+# VibeSOP state
+.vibe/state/
+.vibe/sessions/
+.vibe/preferences.json
+.vibe/skills/
+.vibe/instincts/
+.vibe/instincts.jsonl
+.vibe/snapshots/
+.vibe/cache/
+.vibe/dist/
+.vibe/experiments/
+.vibe/memory/
+.vibe/checkpoints/
+.vibe/workflows/
+
+# Type checking
+.mypy_cache/
+.pyright_cache/
+ruff.toml
+.pytype/
+
+# Logs
+*.log
+
+# Distribution
+*.whl
+*.tar.gz
+.alma-snapshots
+.vibe/.vibe/
+
+# Runtime generated directories
+.vibe/core/
+.vibe/rules/

vibesop-4.2.0/.pre-commit-config.yaml

@@ -0,0 +1,30 @@
+# Pre-commit hooks for Python development
+
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.9.0
+    hooks:
+      - id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+      - id: ruff-format
+
+  - repo: https://github.com/gitleaks/gitleaks
+    rev: v8.18.0
+    hooks:
+      - id: gitleaks
+
+  - repo: local
+    hooks:
+      - id: basedpyright
+        name: basedpyright
+        entry: uv run basedpyright
+        language: system
+        types: [python]
+        pass_filenames: false
+      - id: pytest
+        name: Run tests
+        entry: uv run pytest tests/ -x -q --ignore=tests/benchmark
+        language: system
+        types: [python]
+        pass_filenames: false
+        always_run: true

vibesop-4.2.0/.python-version

@@ -0,0 +1 @@
+3.12

vibesop-4.2.0/.vibe/experiment.yaml

@@ -0,0 +1,27 @@
+domain: routing-optimization
+objective:
+  description: "Improve routing accuracy"
+  evaluator:
+    type: agent_judge
+    rubric:
+      - id: effectiveness
+        weight: 0.4
+        description: "How well it solves the problem"
+      - id: clarity
+        weight: 0.3
+        description: "Clarity of instructions/steps"
+      - id: efficiency
+        weight: 0.3
+        description: "Resource usage and speed"
+scope:
+  modifiable:
+    - core/skills/routing-optimization/SKILL.md
+  readonly:
+    - core/policies/**
+    - src/**
+  test_command: null
+constraints:
+  max_iterations: 15
+  time_budget_per_iteration: 180
+  must_pass_tests: false
+  stale_threshold: 5

vibesop-4.2.0/.vibe/skill-routing.yaml

@@ -0,0 +1,59 @@
+# Project-Level Skill Routing Configuration
+# This file allows you to customize routing behavior for this specific project.
+# Changes here override the global core/policies/task-routing.yaml settings.
+
+schema_version: 1
+
+# Add project-specific scenario patterns
+scenario_patterns:
+  - id: vibesop_dev
+    name: "VibeSOP Development"
+    trigger_mode: suggest
+    description: "Working on VibeSOP itself"
+    keywords:
+      - "refactor vibesop"
+      - "优化 vibesop"
+      - "vibesop 架构"
+      - "改进路由"
+    skill_id: "riper-workflow"
+    priority: P1
+    message: "VibeSOP 开发建议使用 RIPER 工作流进行系统性改进"
+
+  - id: gstack_browser
+    name: "GStack Browser QA"
+    trigger_mode: suggest
+    description: "Browser testing and screenshot via GStack"
+    keywords:
+      - "take a screenshot"
+      - "screenshot"
+      - "browser test"
+      - "headless browser"
+      - "chromium"
+      - "测试网站"
+      - "截图"
+    skill_id: "gstack"
+    priority: P1
+    message: "建议使用 GStack 进行浏览器测试和截图"
+
+  - id: gstack_qa
+    name: "GStack QA"
+    trigger_mode: suggest
+    description: "QA testing with GStack"
+    keywords:
+      - "qa test"
+      - "browser qa"
+      - "网站测试"
+    skill_id: "gstack/qa"
+    priority: P1
+    message: "建议使用 GStack QA 进行浏览器测试"
+
+# Project-specific routing hints
+routing_hints:
+  - keywords: ["模板", "template", "CLAUDE.md", "配置生成"]
+    suggest: "riper-workflow"
+    message: "模板修改建议使用 RIPER 流程：Research → Innovate → Plan → Execute → Review"
+
+# Override keywords
+override_keywords:
+  "用项目路由": project
+  "use project routing": project