@contractspec/action.pr 0.9.0

package/.contractspec-ci/contracts.json

@@ -0,0 +1,3 @@
+{
+  "contracts": []
+}

package/CHANGELOG.md

@@ -0,0 +1,120 @@
+# Changelog
+
+## 0.9.0
+
+### Minor Changes
+
+- fix: publish with bun
+
+### Patch Changes
+
+- Updated dependencies
+  - @contractspec/bundle.workspace@1.60.0
+  - @contractspec/lib.contracts@1.60.0
+
+## 0.8.0
+
+### Minor Changes
+
+- 1a0cf44: fix: publishConfig not supported by bun
+
+### Patch Changes
+
+- Updated dependencies [1a0cf44]
+  - @contractspec/bundle.workspace@1.59.0
+  - @contractspec/lib.contracts@1.59.0
+
+## 0.7.0
+
+### Minor Changes
+
+- d1f0fd0: chore: Migrate non-app package builds from tsdown to shared Bun tooling, add `@contractspec/tool.bun`, and standardize `prebuild`/`build`/`typecheck` with platform-aware exports and `tsc` declaration emission into `dist`.
+
+### Patch Changes
+
+- Updated dependencies [d1f0fd0]
+- Updated dependencies [4355a9e]
+  - @contractspec/bundle.workspace@1.58.0
+  - @contractspec/lib.contracts@1.58.0
+
+## 0.6.0
+
+### Minor Changes
+
+- 11a5a05: feat: improve product intent
+
+### Patch Changes
+
+- Updated dependencies [8ecf3c1]
+- Updated dependencies [47c48c2]
+- Updated dependencies [a119963]
+- Updated dependencies [4651e06]
+- Updated dependencies [ad9d10a]
+- Updated dependencies [11a5a05]
+  - @contractspec/lib.contracts@1.57.0
+  - @contractspec/bundle.workspace@1.57.0
+
+## 0.5.1
+
+### Patch Changes
+
+- fix: improve publish config
+- Updated dependencies
+  - @contractspec/bundle.workspace@1.56.1
+  - @contractspec/lib.contracts@1.56.1
+
+## 0.5.0
+
+### Minor Changes
+
+- fix: release
+
+### Patch Changes
+
+- Updated dependencies
+  - @contractspec/bundle.workspace@1.56.0
+  - @contractspec/lib.contracts@1.56.0
+
+## 0.4.0
+
+### Minor Changes
+
+- fix: unpublished packages
+
+### Patch Changes
+
+- Updated dependencies
+  - @contractspec/bundle.workspace@1.55.0
+  - @contractspec/lib.contracts@1.55.0
+
+## 0.3.0
+
+### Minor Changes
+
+- ec5e95c: chore: upgrade dependencies
+
+### Patch Changes
+
+- Updated dependencies [ec5e95c]
+  - @contractspec/lib.contracts@1.54.0
+  - @contractspec/bundle.workspace@1.54.0
+
+## 0.2.0
+
+### Minor Changes
+
+- 89d3402: Add new ContractSpec PR and drift actions as the primary automation entrypoints.
+- f4180d4: fix: performance improvement
+- 64d84e1: Add contract-level verification table to impact reports. Defines query and data view contracts for per-contract drift status, surfaces covered, and last verified commit. Reports render the table when contracts data is present; backward compatible when absent.
+
+### Patch Changes
+
+- Updated dependencies [5b371b1]
+- Updated dependencies [f4180d4]
+- Updated dependencies [64d84e1]
+  - @contractspec/lib.contracts@1.53.0
+  - @contractspec/bundle.workspace@1.53.0
+
+## 0.1.0
+
+- Initial release.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,50 @@
+# ContractSpec PR Action
+
+Run ContractSpec PR checks (view, impact, validation, drift) with a reusable GitHub Action.
+
+Website: https://contractspec.io/
+
+## Usage
+
+```yaml
+name: ContractSpec PR
+
+on: pull_request
+
+jobs:
+  contractspec:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: ContractSpec PR checks
+        uses: lssm-tech/contractspec/packages/apps/action-pr@main
+        with:
+          generate-command: 'bun contractspec generate'
+```
+
+## Inputs
+
+| Input               | Description                         | Default               |
+| ------------------- | ----------------------------------- | --------------------- |
+| `package-manager`   | `bun`, `npm`, `pnpm`, `yarn`        | `bun`                 |
+| `working-directory` | Repo root or package path           | `.`                   |
+| `report-mode`       | `summary`, `comment`, `both`, `off` | `summary`             |
+| `enable-drift`      | Run generate + drift check          | `true`                |
+| `fail-on`           | `breaking`, `drift`, `any`, `never` | `any`                 |
+| `generate-command`  | Command to regenerate artifacts     | empty                 |
+| `validate-command`  | Validation command override         | empty                 |
+| `contracts-dir`     | Directory for contract changes      | empty                 |
+| `contracts-glob`    | Glob for contract changes           | empty                 |
+| `token`             | GitHub token for PR comments        | `${{ github.token }}` |
+
+## Outputs
+
+| Output                     | Description                            |
+| -------------------------- | -------------------------------------- |
+| `drift-detected`           | Whether drift was detected             |
+| `breaking-change-detected` | Whether breaking changes were detected |
+| `validation-failed`        | Whether validation failed              |

package/action.yml

@@ -0,0 +1,288 @@
+name: 'ContractSpec PR'
+description: 'Run ContractSpec PR checks (view, impact, validation, drift)'
+author: 'LSSM'
+branding:
+  icon: 'check-circle'
+  color: 'blue'
+
+inputs:
+  package-manager:
+    description: 'Package manager to use (bun|npm|pnpm|yarn)'
+    required: false
+    default: 'bun'
+  working-directory:
+    description: 'Working directory for running commands'
+    required: false
+    default: '.'
+  report-mode:
+    description: 'Report output mode (summary|comment|both|off)'
+    required: false
+    default: 'summary'
+  enable-drift:
+    description: 'Run drift detection after generate'
+    required: false
+    default: 'true'
+  fail-on:
+    description: 'Fail on breaking, drift, any, or never'
+    required: false
+    default: 'any'
+  generate-command:
+    description: 'Command to regenerate artifacts (required when enable-drift=true)'
+    required: false
+    default: 'bun contractspec generate'
+  validate-command:
+    description: 'Override validation command'
+    required: false
+    default: ''
+  contracts-dir:
+    description: 'Directory containing contract specs'
+    required: false
+    default: ''
+  contracts-glob:
+    description: 'Glob pattern for contract specs'
+    required: false
+    default: ''
+  token:
+    description: 'GitHub token for PR comments'
+    required: false
+    default: '${{ github.token }}'
+
+outputs:
+  drift-detected:
+    description: 'Whether drift was detected'
+    value: ${{ steps.result.outputs.drift_detected }}
+  breaking-change-detected:
+    description: 'Whether breaking changes were detected'
+    value: ${{ steps.result.outputs.breaking_change_detected }}
+  validation-failed:
+    description: 'Whether validation failed'
+    value: ${{ steps.result.outputs.validation_failed }}
+
+runs:
+  using: 'composite'
+  steps:
+    - name: Set action defaults
+      shell: bash
+      run: |
+        echo "PACKAGE_MANAGER=${{ inputs.package-manager }}" >> $GITHUB_ENV
+        echo "WORKING_DIRECTORY=${{ inputs.working-directory }}" >> $GITHUB_ENV
+        echo "REPORT_MODE=${{ inputs.report-mode }}" >> $GITHUB_ENV
+        echo "ENABLE_DRIFT=${{ inputs.enable-drift }}" >> $GITHUB_ENV
+        echo "FAIL_ON=${{ inputs.fail-on }}" >> $GITHUB_ENV
+        echo "GENERATE_COMMAND=${{ inputs.generate-command }}" >> $GITHUB_ENV
+        echo "VALIDATE_COMMAND=${{ inputs.validate-command }}" >> $GITHUB_ENV
+        echo "CONTRACTS_DIR=${{ inputs.contracts-dir }}" >> $GITHUB_ENV
+        echo "CONTRACTS_GLOB=${{ inputs.contracts-glob }}" >> $GITHUB_ENV
+        echo "COMMENT_TOKEN=${{ inputs.token }}" >> $GITHUB_ENV
+        echo "TURBO_TELEMETRY_DISABLED=1" >> $GITHUB_ENV
+        echo "DO_NOT_TRACK=1" >> $GITHUB_ENV
+        # Pass through Turbo env vars if present in the calling workflow environment
+        if [ -n "$TURBO_TOKEN" ]; then echo "TURBO_TOKEN=$TURBO_TOKEN" >> $GITHUB_ENV; fi
+        if [ -n "$TURBO_TEAM" ]; then echo "TURBO_TEAM=$TURBO_TEAM" >> $GITHUB_ENV; fi
+
+
+    - name: Setup Bun
+      uses: oven-sh/setup-bun@v2
+      with:
+        bun-version: '1.3.8'
+
+    - name: Setup Node
+      if: env.PACKAGE_MANAGER != 'bun'
+      uses: actions/setup-node@v4
+      with:
+        node-version: '20'
+
+    - name: Configure ContractSpec command
+      shell: bash
+      run: |
+        case "$PACKAGE_MANAGER" in
+          bun)
+            echo "CONTRACTSPEC_CMD=bunx contractspec" >> $GITHUB_ENV
+            ;;
+          npm)
+            echo "CONTRACTSPEC_CMD=npx contractspec" >> $GITHUB_ENV
+            ;;
+          pnpm)
+            echo "CONTRACTSPEC_CMD=pnpm dlx contractspec" >> $GITHUB_ENV
+            ;;
+          yarn)
+            echo "CONTRACTSPEC_CMD=yarn dlx contractspec" >> $GITHUB_ENV
+            ;;
+          *)
+            echo "::error::Unsupported package-manager: $PACKAGE_MANAGER"
+            exit 1
+            ;;
+        esac
+
+    - name: Install dependencies
+      shell: bash
+      working-directory: ${{ env.WORKING_DIRECTORY }}
+      run: |
+        case "$PACKAGE_MANAGER" in
+          bun)
+            if [ -f "bun.lock" ] || [ -f "bun.lockb" ]; then
+              bun install --frozen-lockfile
+            else
+              bun install
+            fi
+            ;;
+          npm)
+            if [ -f "package-lock.json" ]; then
+              npm ci
+            else
+              npm install
+            fi
+            ;;
+          pnpm)
+            corepack enable
+            pnpm install --frozen-lockfile
+            ;;
+          yarn)
+            corepack enable
+            yarn install --frozen-lockfile
+            ;;
+        esac
+
+    - name: Build local ContractSpec CLI (if present)
+      if: env.PACKAGE_MANAGER == 'bun'
+      shell: bash
+      working-directory: ${{ env.WORKING_DIRECTORY }}
+      run: |
+        if [ -f "packages/apps/cli-contractspec/package.json" ]; then
+          bun run build --filter=@contractspec/app.cli-contractspec
+        fi
+      env:
+        TURBO_TOKEN: ${{ env.TURBO_TOKEN }}
+        TURBO_TEAM: ${{ env.TURBO_TEAM }}
+
+    - name: Collect contract changes
+      id: changes
+      shell: bash
+      working-directory: ${{ env.WORKING_DIRECTORY }}
+      run: |
+        mkdir -p .contractspec-ci
+        BASELINE="${{ github.base_ref }}"
+        if [ -n "$BASELINE" ]; then
+          git fetch origin "$BASELINE" --depth=1 || true
+          BASELINE="origin/$BASELINE"
+        else
+          BASELINE="HEAD~1"
+        fi
+        echo "BASELINE=$BASELINE" >> $GITHUB_ENV
+        git diff --name-only "$BASELINE"...HEAD > .contractspec-ci/changed-files.txt
+        $CONTRACTSPEC_CMD action-pr collect-changes
+
+    - name: Generate contract view
+      shell: bash
+      working-directory: ${{ env.WORKING_DIRECTORY }}
+      run: |
+        set +e
+        $CONTRACTSPEC_CMD view --audience product --baseline "$BASELINE" > .contractspec-ci/product-view.md
+        VIEW_EXIT=$?
+        set -e
+        if [ $VIEW_EXIT -ne 0 ]; then
+          echo "Contract view failed (exit $VIEW_EXIT)." > .contractspec-ci/product-view.md
+        fi
+
+    - name: Run impact analysis
+      shell: bash
+      working-directory: ${{ env.WORKING_DIRECTORY }}
+      run: |
+        set +e
+        $CONTRACTSPEC_CMD impact --baseline "$BASELINE" --format json > .contractspec-ci/impact.json
+        IMPACT_EXIT=$?
+        set -e
+        if [ $IMPACT_EXIT -ne 0 ]; then
+          echo "{}" > .contractspec-ci/impact.json
+        fi
+
+    - name: Validate contracts
+      id: validate
+      shell: bash
+      working-directory: ${{ env.WORKING_DIRECTORY }}
+      run: |
+        set +e
+        if [ -n "$VALIDATE_COMMAND" ]; then
+          bash -lc "$VALIDATE_COMMAND" 2>&1 | tee .contractspec-ci/validation.txt
+        else
+          $CONTRACTSPEC_CMD validate 2>&1 | tee .contractspec-ci/validation.txt
+        fi
+        VALIDATION_EXIT=${PIPESTATUS[0]}
+        set -e
+        if [ $VALIDATION_EXIT -eq 0 ]; then
+          echo "VALIDATION_STATUS=pass" >> $GITHUB_ENV
+          echo "VALIDATION_FAILED=false" >> $GITHUB_ENV
+        else
+          echo "VALIDATION_STATUS=fail" >> $GITHUB_ENV
+          echo "VALIDATION_FAILED=true" >> $GITHUB_ENV
+        fi
+
+    - name: Run generate command
+      if: env.ENABLE_DRIFT == 'true'
+      shell: bash
+      working-directory: ${{ env.WORKING_DIRECTORY }}
+      run: |
+        if [ -z "$GENERATE_COMMAND" ]; then
+          echo "::error::generate-command is required when enable-drift=true"
+          exit 1
+        fi
+        bash -lc "$GENERATE_COMMAND"
+
+    - name: Check drift
+      if: env.ENABLE_DRIFT == 'true'
+      shell: bash
+      working-directory: ${{ env.WORKING_DIRECTORY }}
+      run: |
+        git status --porcelain > .contractspec-ci/drift-status.txt
+        $CONTRACTSPEC_CMD action-pr check-drift
+
+    - name: Mark drift as skipped
+      if: env.ENABLE_DRIFT != 'true'
+      shell: bash
+      run: |
+        echo "DRIFT_STATUS=skipped" >> $GITHUB_ENV
+        echo "DRIFT_DETECTED=false" >> $GITHUB_ENV
+
+    - name: Build report data
+      shell: bash
+      working-directory: ${{ env.WORKING_DIRECTORY }}
+      run: |
+        # Collect contract verification status
+        echo "Collecting contract verification status..."
+        $CONTRACTSPEC_CMD action-pr get-contract-status
+
+        # Build report data
+        $CONTRACTSPEC_CMD action-pr build-report-data
+
+    - name: Generate report
+      shell: bash
+      working-directory: ${{ env.WORKING_DIRECTORY }}
+      run: |
+        $CONTRACTSPEC_CMD action-pr generate-report
+
+    - name: Comment on PR
+      if: ${{ github.event.pull_request && (inputs.report-mode == 'comment' || inputs.report-mode == 'both') && !github.event.pull_request.head.repo.fork }}
+      uses: actions/github-script@v7
+      with:
+        github-token: ${{ env.COMMENT_TOKEN }}
+        script: |
+          const fs = require("fs");
+          const path = `${process.env.WORKING_DIRECTORY}/.contractspec-ci/report.md`;
+          const report = fs.readFileSync(path, "utf8");
+          const runUrl = `https://github.com/${context.repo.owner}/${context.repo.repo}/actions/runs/${context.runId}`;
+          const header = `## ContractSpec Report (run ${context.runId})`;
+          const body = `${header}\n${runUrl}\n\n${report}`;
+
+          await github.rest.issues.createComment({
+            owner: context.repo.owner,
+            repo: context.repo.repo,
+            issue_number: context.issue.number,
+            body,
+          });
+      continue-on-error: true
+
+    - name: Finalize results
+      id: result
+      shell: bash
+      run: |
+        $CONTRACTSPEC_CMD action-pr finalize

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@contractspec/action.pr",
+  "version": "0.9.0",
+  "description": "GitHub Action for ContractSpec PR checks",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/apps/action-pr"
+  },
+  "keywords": [
+    "github-action",
+    "contractspec",
+    "pr",
+    "drift",
+    "validation"
+  ],
+  "author": "LSSM",
+  "license": "MIT",
+  "dependencies": {
+    "@contractspec/lib.contracts": "1.60.0",
+    "@contractspec/bundle.workspace": "1.60.0"
+  },
+  "devDependencies": {
+    "@contractspec/tool.typescript": "1.60.0",
+    "@types/bun": "^1.3.8",
+    "@types/node": "^25.2.1",
+    "eslint": "^9.39.2",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "homepage": "https://contractspec.io"
+}