osdlc-kit 0.3.0__tar.gz

osdlc_kit-0.3.0/.github/dependabot.yml

@@ -0,0 +1,20 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    open-pull-requests-limit: 5
+    commit-message:
+      prefix: "fix"
+      prefix-development: "chore"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    open-pull-requests-limit: 5
+    commit-message:
+      prefix: "chore"

osdlc_kit-0.3.0/.github/workflows/codeql.yml

@@ -0,0 +1,27 @@
+name: CodeQL
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  schedule:
+    - cron: '0 12 * * 1'
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: github/codeql-action/init@v4
+
+      - uses: github/codeql-action/autobuild@v4
+
+      - uses: github/codeql-action/analyze@v4

osdlc_kit-0.3.0/.github/workflows/lint.yml

@@ -0,0 +1,36 @@
+name: Lint
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  super-linter:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Super-Linter
+        uses: super-linter/super-linter@v8.6.0
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          VALIDATE_ALL_CODEBASE: false
+          DEFAULT_BRANCH: main
+          VALIDATE_JAVA: true
+          VALIDATE_KOTLIN_KT_LINT: true
+          VALIDATE_KOTLIN_BIOME: true
+          VALIDATE_YAML: true
+          VALIDATE_JSON: true
+          VALIDATE_XML: true
+          VALIDATE_MARKDOWN: true
+          VALIDATE_PROPERTIES: true
+          VALIDATE_GITHUB_ACTIONS: true
+          FILTER_REGEX_EXCLUDE: \.jks$|\.jar$|\.keystore$

osdlc_kit-0.3.0/.github/workflows/opencode.yml

@@ -0,0 +1,235 @@
+---
+name: opencode
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review:
+    types: [submitted]
+  workflow_run:
+    workflows: ["PR Check"]
+    types: [completed]
+
+concurrency:
+  group: opencode-${{ github.event_name }}-${{
+    github.event.issue.number ||
+    github.event.pull_request.number ||
+    github.event.workflow_run.pull_requests[0].number ||
+    github.event.reply_to_id }}-${{
+    github.event_name == 'workflow_run' && 'auto' ||
+    contains(github.event.comment.body, '/oc') && 'cmd' ||
+    'other' }}
+  cancel-in-progress: true
+
+jobs:
+  opencode:
+    if: |
+      github.event_name != 'workflow_run' &&
+      github.event.comment != null &&
+      github.event.comment.author_association == 'OWNER' &&
+      github.actor == 'andreaschiona' &&
+      (
+        contains(github.event.comment.body, ' /oc') ||
+        startsWith(github.event.comment.body, '/oc') ||
+        contains(github.event.comment.body, ' /opencode') ||
+        startsWith(github.event.comment.body, '/opencode')
+      )
+    runs-on: ubuntu-latest
+    timeout-minutes: 180
+    permissions:
+      id-token: write
+      contents: write
+      pull-requests: write
+      issues: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+          fetch-depth: 0
+
+      - name: Install jq
+        shell: bash
+        run: sudo apt-get update -qq && sudo apt-get install -y -qq jq
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+
+      - name: Get opencode version
+        id: version
+        shell: bash
+        run: |
+          VERSION=$(curl -sf https://api.github.com/repos/anomalyco/opencode/releases/latest |
+            grep -o '"tag_name": *"[^"]*"' | cut -d'"' -f4 || true)
+          echo "version=${VERSION:-v1.15.10}" >> "$GITHUB_OUTPUT"
+
+      - name: Cache opencode
+        id: cache
+        uses: actions/cache@v5
+        with:
+          path: ~/.opencode/bin
+          key: opencode-${{ runner.os }}-${{ runner.arch }}-${{ steps.version.outputs.version }}
+
+      - name: Install opencode
+        if: steps.cache.outputs.cache-hit != 'true'
+        shell: bash
+        run: curl -fsSL https://opencode.ai/install.sh | sh -s -- ${{ steps.version.outputs.version }}
+
+      - name: Add opencode to PATH
+        shell: bash
+        run: echo "$HOME/.opencode/bin" >> "$GITHUB_PATH"
+
+      - name: Determine model from comment
+        id: model_select
+        shell: bash
+        env:
+          COMMENT: ${{ github.event.comment.body }}
+        run: |
+          if echo "$COMMENT" | grep -qi "GEMINI"; then
+            echo "model=google/gemini-2.5-flash" >> "$GITHUB_OUTPUT"
+          elif echo "$COMMENT" | grep -qi "BIGPICKLE"; then
+            echo "model=opencode/big-pickle" >> "$GITHUB_OUTPUT"
+          elif echo "$COMMENT" | grep -qi "NEMOTRON"; then
+            echo "model=opencode/nemotron-3-super-free" >> "$GITHUB_OUTPUT"
+          else
+            echo "model=opencode/deepseek-v4-flash-free" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Run opencode (with retry)
+        shell: bash
+        id: run_opencode
+        env:
+          MODEL: ${{ steps.model_select.outputs.model }}
+          OPENCODE_TELEMETRY: false
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
+        run: |
+          echo "Selected model: $MODEL"
+
+          jq --arg model "$MODEL" '.model = $model' opencode.json > opencode.tmp.json && mv opencode.tmp.json opencode.json
+          echo "Injected model '$MODEL' into opencode.json"
+
+          MAX_RETRIES=3
+          RETRY_DELAY=15
+          for i in $(seq 1 "$MAX_RETRIES"); do
+            echo "opencode run attempt $i of $MAX_RETRIES"
+            if opencode github run; then
+              echo "opencode completed successfully"
+              exit 0
+            fi
+            exit_code=$?
+            echo "opencode exit code: $exit_code"
+            if [ "$i" -eq "$MAX_RETRIES" ]; then
+              echo "All $MAX_RETRIES attempts failed, last exit code: $exit_code"
+              exit 1
+            fi
+            echo "Attempt $i failed (exit code: $exit_code), retrying in ${RETRY_DELAY}s..."
+            sleep "$RETRY_DELAY"
+          done
+
+  auto-analyze-failure:
+    if: |
+      github.event_name == 'workflow_run' &&
+      github.event.workflow_run.conclusion == 'failure' &&
+      github.event.workflow_run.pull_requests[0] != null &&
+      github.event.workflow_run.head_repository.fork == false
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    permissions:
+      contents: read
+      pull-requests: write
+      checks: read
+    steps:
+      - name: Checkout PR head
+        uses: actions/checkout@v6
+        with:
+          ref: ${{ github.event.workflow_run.head_sha }}
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Get PR number
+        id: pr
+        shell: bash
+        run: |
+          {
+            echo "number=${{ github.event.workflow_run.pull_requests[0].number }}"
+            echo "head_branch=${{ github.event.workflow_run.head_branch }}"
+            echo "head_sha=${{ github.event.workflow_run.head_sha }}"
+          } >> "$GITHUB_OUTPUT"
+
+      - name: Collect failure context
+        shell: bash
+        run: |
+          mkdir -p /tmp/ci-context
+          URL="/repos/${{ github.repository }}/commits/${{ github.event.workflow_run.head_sha }}/check-runs"
+          gh api "$URL" --jq '
+            .check_runs[] | select(.conclusion == "failure") |
+            "## \(.name)\n\n**Title:** \(.output.title // "failed")\n\n**Summary:**\n\(.output.summary // "N/A")\n\n**Text:**\n\(.output.text // "N/A")\n"
+          ' > /tmp/ci-context/check-failures.md
+          gh pr diff ${{ steps.pr.outputs.number }} > /tmp/ci-context/pr-diff.diff
+          echo "Failure context collected ($(wc -l < /tmp/ci-context/check-failures.md) lines)"
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Get opencode version
+        id: version
+        shell: bash
+        run: |
+          VERSION=$(curl -sf https://api.github.com/repos/anomalyco/opencode/releases/latest |
+            grep -o '"tag_name": *"[^"]*"' | cut -d'"' -f4 || true)
+          echo "version=${VERSION:-v1.15.10}" >> "$GITHUB_OUTPUT"
+
+      - name: Cache opencode
+        id: cache
+        uses: actions/cache@v5
+        with:
+          path: ~/.opencode/bin
+          key: opencode-auto-${{ runner.os }}-${{ runner.arch }}-${{ steps.version.outputs.version }}
+
+      - name: Install opencode
+        if: steps.cache.outputs.cache-hit != 'true'
+        shell: bash
+        run: curl -fsSL https://opencode.ai/install.sh | sh -s -- ${{ steps.version.outputs.version }}
+
+      - name: Add opencode to PATH
+        shell: bash
+        run: echo "$HOME/.opencode/bin" >> "$GITHUB_PATH"
+
+      - name: Analyze failures with opencode
+        shell: bash
+        continue-on-error: true
+        env:
+          OPENCODE_TELEMETRY: false
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
+        run: |
+          opencode run --model opencode/deepseek-v4-flash-free \
+            --file /tmp/ci-context/check-failures.md \
+            --file /tmp/ci-context/pr-diff.diff \
+            "I CI check su questa PR (#${{ steps.pr.outputs.number }}) sono falliti. \
+            I file allegati contengono i dettagli dei check falliti e il diff della PR. \
+            Analizza i fallimenti e proponi correzioni specifiche. \
+            Fornisci un'analisi dettagliata in italiano." \
+            > /tmp/ci-context/analysis.md 2>&1
+
+      - name: Post analysis to PR
+        if: always() && steps.pr.outputs.number != ''
+        shell: bash
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          {
+            echo '## Analisi automatica CI'
+            echo ''
+            if [ -s /tmp/ci-context/analysis.md ]; then
+              echo 'OpenCode ha analizzato i fallimenti dei check su questo PR.'
+              echo ''
+              cat /tmp/ci-context/analysis.md
+            else
+              echo "L'analisi automatica non ha prodotto risultati."
+              echo "Per analizzare manualmente, commenta con /oc analizza i fallimenti CI su questa PR."
+            fi
+          } > /tmp/ci-context/body.md
+          gh pr comment ${{ steps.pr.outputs.number }} --body-file /tmp/ci-context/body.md

osdlc_kit-0.3.0/.github/workflows/pr-check.yml

@@ -0,0 +1,62 @@
+name: PR Check
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+    branches: [main]
+
+permissions:
+  contents: read
+  pull-requests: write
+  checks: write
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+
+      - name: Install dependencies
+        run: pip install pytest pytest-cov
+
+      - name: Lint
+        run: python -m py_compile run.py src/osdlc/*.py
+
+      - name: Test with coverage
+        run: python -m pytest --cov=src/osdlc --cov-report=xml --cov-report=term-missing -v
+
+      - name: Build
+        run: python -m py_compile run.py src/osdlc/*.py
+
+      - name: Upload coverage artifact
+        if: always()
+        uses: actions/upload-artifact@v7
+        with:
+          name: coverage-report
+          path: coverage.xml
+          retention-days: 7
+
+      - name: PR comment with results
+        if: always() && github.event_name == 'pull_request'
+        uses: actions/github-script@v9
+        with:
+          script: |
+            const { data: checks } = await github.rest.checks.listForRef({
+              ...context.repo,
+              ref: context.sha,
+            });
+            const summary = checks.check_runs.map(c =>
+              `- **${c.name}**: ${c.conclusion || 'in_progress'}`
+            ).join('\n');
+            github.rest.issues.createComment({
+              ...context.repo,
+              issue_number: context.issue.number,
+              body: `## PR Check Results\n\n${summary}\n\n_Updated at ${new Date().toISOString()}_`,
+            });

osdlc_kit-0.3.0/.github/workflows/release.yml

@@ -0,0 +1,156 @@
+name: Release
+
+on:
+  push:
+    branches: [main]
+    paths-ignore:
+      - '**.md'
+      - '.gitignore'
+      - '.github/**'
+
+permissions:
+  contents: write
+  issues: write
+  id-token: write  # needed for PyPI trusted publishing
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    outputs:
+      new_version: ${{ steps.resolve.outputs.new_version }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+
+      - name: Determine bump
+        id: bump
+        run: |
+          LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || true)
+          if [ -z "$LAST_TAG" ]; then
+            COMMITS=$(git log --format="%s")
+          else
+            COMMITS=$(git log "$LAST_TAG..HEAD" --format="%s")
+          fi
+          if echo "$COMMITS" | grep -q "BREAKING CHANGE"; then
+            echo "BUMP_TYPE=major" >> "$GITHUB_ENV"
+          elif echo "$COMMITS" | grep -q "^feat"; then
+            echo "BUMP_TYPE=minor" >> "$GITHUB_ENV"
+          else
+            echo "BUMP_TYPE=patch" >> "$GITHUB_ENV"
+          fi
+
+      - name: Bump version
+        id: version
+        shell: bash
+        run: |
+          OUTPUT=$(python src/osdlc/version.py update --root . 2>&1)
+          echo "update_output=$OUTPUT" >> "$GITHUB_OUTPUT"
+          NEW_VERSION=$(echo "$OUTPUT" | sed -n 's/.*-> \([0-9]\+\.[0-9]\+\.[0-9]\+\).*/\1/p')
+          echo "new_version=$NEW_VERSION" >> "$GITHUB_OUTPUT"
+          echo "$OUTPUT"
+
+      - name: Install dependencies
+        run: pip install pytest
+
+      - name: Lint
+        run: python -m py_compile run.py src/osdlc/*.py
+
+      - name: Run tests
+        id: tests
+        continue-on-error: true
+        run: python -m pytest -v || test $? -eq 5
+
+      - name: Build
+        run: python -m py_compile run.py src/osdlc/*.py
+
+      - name: Create issue on test failure
+        if: steps.tests.outcome == 'failure'
+        uses: actions/github-script@v9
+        with:
+          script: |
+            github.rest.issues.create({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              title: 'Release tests failed',
+              body: 'Tests failed during release for version ${{ steps.version.outputs.new_version }}. Check the release workflow run for details.',
+              labels: ['bug', 'auto-reported']
+            })
+
+      - name: Fail if tests failed
+        if: steps.tests.outcome == 'failure'
+        run: exit 1
+
+      - name: Resolve version (increment if tag exists)
+        id: resolve
+        run: |
+          VERSION_FILE="VERSION"
+          [ -f "pyproject.toml" ] && VERSION_FILE="pyproject.toml"
+          NEW_VERSION="${{ steps.version.outputs.new_version }}"
+          while git tag -l "v$NEW_VERSION" | grep -q .; do
+            echo "Tag v$NEW_VERSION already exists — incrementing"
+            IFS='.' read -r MAJOR MINOR PATCH <<< "$NEW_VERSION"
+            case "$BUMP_TYPE" in
+              major) MAJOR=$((MAJOR+1)); MINOR=0; PATCH=0 ;;
+              minor) MINOR=$((MINOR+1)); PATCH=0 ;;
+              patch) PATCH=$((PATCH+1)) ;;
+            esac
+            NEW_VERSION="$MAJOR.$MINOR.$PATCH"
+          done
+          echo "new_version=$NEW_VERSION" >> "$GITHUB_OUTPUT"
+          if [ -f "pyproject.toml" ]; then
+            sed -i "s/version = \"[0-9.]*\"/version = \"$NEW_VERSION\"/" pyproject.toml
+          else
+            echo "version=$NEW_VERSION" > "$VERSION_FILE"
+          fi
+
+      - name: Commit version bump
+        run: |
+          git config user.name "github-actions"
+          git config user.email "actions@github.com"
+          VERSION_FILE=$(python src/osdlc/version.py detect --root . | cut -d' ' -f1)
+          [ -z "$VERSION_FILE" ] && VERSION_FILE="VERSION"
+          git add "$VERSION_FILE"
+          git commit -m "chore: bump version to ${{ steps.resolve.outputs.new_version }} [skip ci]"
+          git tag v${{ steps.resolve.outputs.new_version }}
+
+      - name: Push changes
+        run: |
+          git push origin main
+          git push origin v${{ steps.resolve.outputs.new_version }}
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v3
+        with:
+          tag_name: v${{ steps.resolve.outputs.new_version }}
+          generate_release_notes: true
+          make_latest: true
+
+  publish:
+    needs: release
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: v${{ needs.release.outputs.new_version }}
+          fetch-depth: 0
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+
+      - name: Build wheel
+        run: |
+          pip install hatchling
+          python -m hatchling build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

osdlc_kit-0.3.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.pyc
+*.pyo
+.env
+venv/
+.venv/
+.coverage
+coverage.xml
+.pytest_cache/

osdlc_kit-0.3.0/AGENTS.md

@@ -0,0 +1,67 @@
+# AI Open SDLC Kit -- Agent Instructions
+
+## Project Overview
+
+This project uses Python with a manual build system (manual).
+
+## Verified Commands
+
+- **Build:** `python -m py_compile run.py src/osdlc/*.py`
+- **Test:** `python -m pytest --cov=src/osdlc --cov-report=xml --cov-report=term-missing -v`
+- **Lint:** `python -m py_compile run.py src/osdlc/*.py`
+
+## Environment
+
+Python 3.x. Install dependencies with `pip install pytest pytest-cov`.
+
+## OpenCode Protocol
+
+The agent MUST handle slash-commands found in issue or PR comments.
+
+### Parsing
+
+When opencode is triggered by a comment:
+1. Read the comment body from the triggering event.
+2. If the comment starts with `/oc` or `/opencode`, extract the first whitespace-delimited token immediately following the prefix.
+3. The remainder of the comment (after the command token) is the **instruction payload**.
+4. Route to the appropriate behaviour based on the command token.
+
+### Commands
+
+- **`/oc fix`** (Issue) - Apply a quick corrective change. Analyse the issue, create a throwaway fix branch from `main`, apply the fix, commit with `fix:`, and push. Do NOT create a PR. The payload may describe the fix intent.
+- **`/oc analyze`** (Issue) - Read the issue body and all comments. Perform a critical analysis, then post a detailed functional requirement as a new issue comment. Include: problem statement, affected areas, acceptance criteria, and open questions.
+- **`/oc plan`** (Issue) - Requires prior analyze. Read the analysed requirement, produce a technical implementation plan with file-level breakdown, and post it as a new issue comment.
+- **`/oc implement`** (Issue) - Requires prior plan. Create branch `issue-{{number}}` from `main`. Implement file-by-file, commit each unit conventionally. Open a PR targeting `main` with `Closes #{{number}}`.
+- **`/oc fixCheck`** (PR) - Read automated check results. For each failure, apply a fix, amend the PR branch, and re-trigger checks. Repeat up to 3 retries. Post a status comment when done.
+
+### Instruction Payload
+
+Any text after the command token is the instruction payload. The agent MAY use it for additional context:
+- `/oc fix add null guard` -> command `fix`, payload `add null guard`
+- `/oc analyze` -> command `analyze`, payload empty
+
+### Model Overrides
+
+The workflow sets the model based on keywords anywhere in the comment (case-insensitive):
+
+- `GEMINI` -> `google/gemini-2.5-flash`
+- `BIGPICKLE` -> `opencode/big-pickle`
+- `NEMOTRON` -> `opencode/nemotron-3-super-free`
+- (default) -> `opencode/deepseek-v4-flash-free`
+
+## Commit Convention
+
+Every commit MUST follow the Conventional Commits specification:
+- `feat: ...` -- a new feature
+- `fix: ...` -- a bug fix
+- `chore: ...` -- maintenance, dependencies, tooling
+- `BREAKING CHANGE: ...` or `feat!: ...` -- incompatible API changes
+
+## Branch Naming
+
+Feature branches MUST follow the pattern: `issue-{{number}}`
+Always branch from `main`.
+
+## Version Configuration
+
+Version is stored in: `VERSION`