diff --git a/.github/self-heal-schedule.yml b/.github/self-heal-schedule.yml new file mode 100644 index 00000000..d3cff4fc --- /dev/null +++ b/.github/self-heal-schedule.yml @@ -0,0 +1,4 @@ +schedule: "0 0 * * *" +rationale: "Initial schedule (Fallback: once a day at midnight)" +last_updated: "2024-05-22T00:00:00.000Z" +# AUTO-UPDATED diff --git a/.github/workflows/compute-schedule.yml b/.github/workflows/compute-schedule.yml new file mode 100644 index 00000000..5c62afeb --- /dev/null +++ b/.github/workflows/compute-schedule.yml @@ -0,0 +1,74 @@ +name: Compute Self-Heal Schedule + +on: + schedule: + - cron: "0 2 * * 0" # Weekly on Sunday at 02:00 + workflow_dispatch: + +jobs: + compute-schedule: + if: "!startsWith(github.ref_name, 'selfheal-')" + runs-on: ubuntu-latest + timeout-minutes: 5 + permissions: + contents: write + pull-requests: write + steps: + - name: Checkout code + uses: actions/checkout@v4 + with: + fetch-depth: 0 + + - name: Setup Node.js + uses: actions/setup-node@v4 + with: + node-version: 20 + cache: 'npm' + + - name: Install dependencies + run: npm ci + + - name: Check for duplicate schedule PRs + id: check_pr + env: + GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} + run: | + OPEN_PRS=$(gh pr list --label self-heal-schedule --state open --json number --jq length) + if [ "$OPEN_PRS" -gt 0 ]; then + echo "open_pr_exists=true" >> $GITHUB_OUTPUT + echo "Skipping compute because a self-heal-schedule PR is already open." + else + echo "open_pr_exists=false" >> $GITHUB_OUTPUT + fi + + - name: Compute and update schedule + if: steps.check_pr.outputs.open_pr_exists == 'false' + id: compute + run: | + node scripts/compute_schedule.mjs + if [ -n "$(git status --porcelain)" ]; then + echo "has_diff=true" >> $GITHUB_OUTPUT + else + echo "has_diff=false" >> $GITHUB_OUTPUT + fi + + - name: Create Pull Request + if: steps.check_pr.outputs.open_pr_exists == 'false' && steps.compute.outputs.has_diff == 'true' + env: + GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} + run: | + BRANCH_NAME="selfheal-schedule-$(date +%s)" + git checkout -b "$BRANCH_NAME" + + git config --global user.name "github-actions[bot]" + git config --global user.email "github-actions[bot]@users.noreply.github.com" + + git add .github/self-heal-schedule.yml .github/workflows/self-heal.yml + git commit -m "Update self-heal schedule based on telemetry" + git push origin "$BRANCH_NAME" + + gh pr create \ + --title "[Self-Heal Schedule] Update cadence" \ + --body "Automated PR to update the self-healing pipeline schedule based on recent repository telemetry." \ + --label "self-heal-schedule,automation" \ + --base main diff --git a/.github/workflows/self-heal.yml b/.github/workflows/self-heal.yml new file mode 100644 index 00000000..611dfa0e --- /dev/null +++ b/.github/workflows/self-heal.yml @@ -0,0 +1,120 @@ +name: Self-Heal Pipeline + +on: + schedule: + - cron: "0 0 * * *" # AUTO-UPDATED + workflow_run: + workflows: ["ci"] + types: + - completed + workflow_dispatch: + +concurrency: + group: selfheal-${{ github.ref }} + cancel-in-progress: true + +jobs: + repair: + # Only run scheduled triggers on the default branch + if: > + (!startsWith(github.ref_name, 'selfheal-')) && + (github.event_name != 'workflow_run' || github.event.workflow_run.conclusion == 'failure') + runs-on: ubuntu-latest + timeout-minutes: 15 + permissions: + contents: write + pull-requests: write + actions: read + + steps: + - name: Checkout code + uses: actions/checkout@v4 + with: + fetch-depth: 0 + + - name: Setup Node.js + uses: actions/setup-node@v4 + with: + node-version: 20 + cache: 'npm' + + - name: Install Dependencies + run: npm ci + + - name: Check for duplicate Self-Heal PRs + id: check_pr + env: + GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} + run: | + # Close stale PRs older than 7 days + gh pr list --label self-heal --state open --json number,createdAt | jq -r '.[] | select(.createdAt < (now - 604800 | todate)) | .number' | xargs -I {} gh pr close {} --comment "Closing stale self-heal PR" || true + + OPEN_PRS=$(gh pr list --label self-heal --state open --json number --jq length) + if [ "$OPEN_PRS" -gt 0 ]; then + echo "open_pr_exists=true" >> $GITHUB_OUTPUT + echo "Skipping repair because a self-heal PR is already open." + else + echo "open_pr_exists=false" >> $GITHUB_OUTPUT + fi + + - name: Run Pre-Repair Healthcheck + if: steps.check_pr.outputs.open_pr_exists == 'false' + id: pre_healthcheck + run: node scripts/healthcheck.mjs + continue-on-error: true + + - name: Run Self-Heal Repair Pipeline + if: steps.check_pr.outputs.open_pr_exists == 'false' + id: self_heal + run: node scripts/self_heal.mjs + + - name: Check git diff and scan for secrets + if: steps.check_pr.outputs.open_pr_exists == 'false' && steps.self_heal.outcome == 'success' + id: verify_diff + run: | + # Ensure there is a diff + if [ -z "$(git status --porcelain)" ]; then + echo "No diff found. Exiting." + exit 0 + fi + + # Stage files explicitly + git add src/ tests/ scripts/ package*.json .github/self-heal-schedule.yml .github/workflows/self-heal.yml 2>/dev/null || true + + # Scan for entropy (basic secret heuristic: strings with 20+ base64 chars that might be keys) + if git diff --staged | grep -qiE "(secret|token|api_key|password).*['\"][a-zA-Z0-9_-]{20,}['\"]"; then + echo "❌ ERROR: Potential secrets found in diff. Aborting." + git reset + exit 1 + fi + + echo "has_diff=true" >> $GITHUB_OUTPUT + + - name: Create Pull Request + if: steps.verify_diff.outputs.has_diff == 'true' + env: + GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} + run: | + BRANCH_NAME="selfheal-$(date +%s)" + git checkout -b "$BRANCH_NAME" + + git config --global user.name "github-actions[bot]" + git config --global user.email "github-actions[bot]@users.noreply.github.com" + + git commit -m "Auto-repair CI and drift issues" + git push origin "$BRANCH_NAME" + + TITLE="[Self-Heal] Repair CI and drift issues" + if [ "${{ github.event_name }}" == "schedule" ]; then + TITLE="[Self-Heal Scheduled] Drift fixes" + elif [ "${{ github.event_name }}" == "workflow_run" ]; then + TITLE="[Self-Heal Reactive] CI fix" + elif [ "${{ github.event_name }}" == "workflow_dispatch" ]; then + TITLE="[Self-Heal Manual] Repair" + fi + + gh pr create \ + --title "$TITLE" \ + --body "Automated self-healing PR triggered by \`${{ github.event_name }}\`. Please review the changes." \ + --label "self-heal,automation" \ + --base main diff --git a/SELF_HEAL_SETUP.md b/SELF_HEAL_SETUP.md new file mode 100644 index 00000000..469dd33f --- /dev/null +++ b/SELF_HEAL_SETUP.md @@ -0,0 +1,39 @@ +# Self-Healing CI Pipeline Setup + +This repository is equipped with an automated self-healing CI pipeline that detects code drift, formatting issues, and test failures, and automatically proposes fixes via Pull Requests. + +## Triggers +The self-healing pipeline runs under three conditions: +1. **Scheduled:** Proactively runs based on a self-computed schedule (to catch drift). +2. **CI Failure:** Reactively runs when the main `ci` workflow fails. +3. **Manual Dispatch:** Can be manually triggered via the GitHub Actions tab. + +## Self-Scheduling Logic +The pipeline dynamically computes its own optimal run frequency based on repository telemetry (commit frequency, pull request velocity). +- Active repositories will be checked more frequently. +- Dormant repositories will be checked less frequently to save CI minutes. +- The schedule is recomputed weekly via the `Compute Self-Heal Schedule` workflow, which creates a PR if the schedule needs to change. + +## Repair Pipeline Steps +The pipeline is idempotent and executes the following steps: +1. **Rebuild/Reinstall:** Clean install of tooling and dependencies. +2. **Lint/Format:** Auto-fix linting and formatting issues (via `eslint` and `prettier`). +3. **Snapshot Updates:** Updates missing or outdated test snapshots (via `vitest -u`). +4. **Type Stubs:** Acquires missing type definitions. +5. **Dependency Re-resolve:** Refreshes the package lockfile. +6. **Static Assets:** Regenerates documentation or code-gen assets (if applicable). + +After each step, a healthcheck is executed. If the healthcheck passes and there is a diff, the pipeline stops and creates a PR immediately to provide the minimal fix. + +## Customization and Overrides +To override the schedule: +1. Manually edit `.github/self-heal-schedule.yml`. +2. Ensure you keep the `# AUTO-UPDATED` comment at the bottom. +3. Commit and push the changes. The pipeline will respect this change, although it will eventually be re-evaluated. + +## Reviewer Checklist +When reviewing a `[Self-Heal]` PR, ensure: +- [ ] No unwanted dependency changes were introduced. +- [ ] Formatting changes align with project standards. +- [ ] Any updated test snapshots are logically correct and not masking a true bug. +- [ ] There are no exposed secrets or tokens in the diff. diff --git a/package-lock.json b/package-lock.json index 5643e919..9411c4d9 100644 --- a/package-lock.json +++ b/package-lock.json @@ -35,8 +35,11 @@ "@types/which": "^3.0.4", "@vitest/coverage-v8": "3.1.1", "esbuild": "^0.25.2", + "eslint": "^10.4.0", + "js-yaml": "^4.1.1", "multer": "1.4.5-lts.1", "openai": "^4.91.1", + "prettier": "^3.8.3", "tsx": "^4.19.3", "typescript": "^5.8.2", "vitest": "^3.1.1" @@ -560,6 +563,218 @@ "node": ">=18" } }, + "node_modules/@eslint-community/eslint-utils": { + "version": "4.9.1", + "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.1.tgz", + "integrity": "sha512-phrYmNiYppR7znFEdqgfWHXR6NCkZEK7hwWDHZUjit/2/U0r6XvkDl0SYnoM51Hq7FhCGdLDT6zxCCOY1hexsQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "eslint-visitor-keys": "^3.4.3" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + }, + "peerDependencies": { + "eslint": "^6.0.0 || ^7.0.0 || >=8.0.0" + } + }, + "node_modules/@eslint-community/eslint-utils/node_modules/eslint-visitor-keys": { + "version": "3.4.3", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz", + "integrity": "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/@eslint-community/regexpp": { + "version": "4.12.2", + "resolved": "https://registry.npmjs.org/@eslint-community/regexpp/-/regexpp-4.12.2.tgz", + "integrity": "sha512-EriSTlt5OC9/7SXkRSCAhfSxxoSUgBm33OH+IkwbdpgoqsSsUg7y3uh+IICI/Qg4BBWr3U2i39RpmycbxMq4ew==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^12.0.0 || ^14.0.0 || >=16.0.0" + } + }, + "node_modules/@eslint/config-array": { + "version": "0.23.5", + "resolved": "https://registry.npmjs.org/@eslint/config-array/-/config-array-0.23.5.tgz", + "integrity": "sha512-Y3kKLvC1dvTOT+oGlqNQ1XLqK6D1HU2YXPc52NmAlJZbMMWDzGYXMiPRJ8TYD39muD/OTjlZmNJ4ib7dvSrMBA==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@eslint/object-schema": "^3.0.5", + "debug": "^4.3.1", + "minimatch": "^10.2.4" + }, + "engines": { + "node": "^20.19.0 || ^22.13.0 || >=24" + } + }, + "node_modules/@eslint/config-array/node_modules/balanced-match": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-4.0.4.tgz", + "integrity": "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==", + "dev": true, + "license": "MIT", + "engines": { + "node": "18 || 20 || >=22" + } + }, + "node_modules/@eslint/config-array/node_modules/brace-expansion": { + "version": "5.0.6", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.6.tgz", + "integrity": "sha512-kLpxurY4Z4r9sgMsyG0Z9uzsBlgiU/EFKhj/h91/8yHu0edo7XuixOIH3VcJ8kkxs6/jPzoI6U9Vj3WqbMQ94g==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^4.0.2" + }, + "engines": { + "node": "18 || 20 || >=22" + } + }, + "node_modules/@eslint/config-array/node_modules/minimatch": { + "version": "10.2.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.5.tgz", + "integrity": "sha512-MULkVLfKGYDFYejP07QOurDLLQpcjk7Fw+7jXS2R2czRQzR56yHRveU5NDJEOviH+hETZKSkIk5c+T23GjFUMg==", + "dev": true, + "license": "BlueOak-1.0.0", + "dependencies": { + "brace-expansion": "^5.0.5" + }, + "engines": { + "node": "18 || 20 || >=22" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/@eslint/config-helpers": { + "version": "0.6.0", + "resolved": "https://registry.npmjs.org/@eslint/config-helpers/-/config-helpers-0.6.0.tgz", + "integrity": "sha512-ii6Bw9jJ2zi2cWA2Z+9/QZ/+3DX6kwaV5Q986D/CdP3Lap3w/pgQZ373FV7byY/i7L4IRH/G43I5dz1ClsCbpA==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@eslint/core": "^1.2.1" + }, + "engines": { + "node": "^20.19.0 || ^22.13.0 || >=24" + } + }, + "node_modules/@eslint/core": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/@eslint/core/-/core-1.2.1.tgz", + "integrity": "sha512-MwcE1P+AZ4C6DWlpin/OmOA54mmIZ/+xZuJiQd4SyB29oAJjN30UW9wkKNptW2ctp4cEsvhlLY/CsQ1uoHDloQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@types/json-schema": "^7.0.15" + }, + "engines": { + "node": "^20.19.0 || ^22.13.0 || >=24" + } + }, + "node_modules/@eslint/object-schema": { + "version": "3.0.5", + "resolved": "https://registry.npmjs.org/@eslint/object-schema/-/object-schema-3.0.5.tgz", + "integrity": "sha512-vqTaUEgxzm+YDSdElad6PiRoX4t8VGDjCtt05zn4nU810UIx/uNEV7/lZJ6KwFThKZOzOxzXy48da+No7HZaMw==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^20.19.0 || ^22.13.0 || >=24" + } + }, + "node_modules/@eslint/plugin-kit": { + "version": "0.7.1", + "resolved": "https://registry.npmjs.org/@eslint/plugin-kit/-/plugin-kit-0.7.1.tgz", + "integrity": "sha512-rZAP3aVgB9ds9KOeUSL+zZ21hPmo8dh6fnIFwRQj5EAZl9gzR7wxYbYXYysAM8CTqGmUGyp2S4kUdV17MnGuWQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@eslint/core": "^1.2.1", + "levn": "^0.4.1" + }, + "engines": { + "node": "^20.19.0 || ^22.13.0 || >=24" + } + }, + "node_modules/@humanfs/core": { + "version": "0.19.2", + "resolved": "https://registry.npmjs.org/@humanfs/core/-/core-0.19.2.tgz", + "integrity": "sha512-UhXNm+CFMWcbChXywFwkmhqjs3PRCmcSa/hfBgLIb7oQ5HNb1wS0icWsGtSAUNgefHeI+eBrA8I1fxmbHsGdvA==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@humanfs/types": "^0.15.0" + }, + "engines": { + "node": ">=18.18.0" + } + }, + "node_modules/@humanfs/node": { + "version": "0.16.8", + "resolved": "https://registry.npmjs.org/@humanfs/node/-/node-0.16.8.tgz", + "integrity": "sha512-gE1eQNZ3R++kTzFUpdGlpmy8kDZD/MLyHqDwqjkVQI0JMdI1D51sy1H958PNXYkM2rAac7e5/CnIKZrHtPh3BQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@humanfs/core": "^0.19.2", + "@humanfs/types": "^0.15.0", + "@humanwhocodes/retry": "^0.4.0" + }, + "engines": { + "node": ">=18.18.0" + } + }, + "node_modules/@humanfs/types": { + "version": "0.15.0", + "resolved": "https://registry.npmjs.org/@humanfs/types/-/types-0.15.0.tgz", + "integrity": "sha512-ZZ1w0aoQkwuUuC7Yf+7sdeaNfqQiiLcSRbfI08oAxqLtpXQr9AIVX7Ay7HLDuiLYAaFPu8oBYNq/QIi9URHJ3Q==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=18.18.0" + } + }, + "node_modules/@humanwhocodes/module-importer": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/@humanwhocodes/module-importer/-/module-importer-1.0.1.tgz", + "integrity": "sha512-bxveV4V8v5Yb4ncFTT3rPSgZBOpCkjfK0y4oVVVJwIuDVBRMDXrPyXRL988i5ap9m9bnyEEjWfm5WkBmtffLfA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=12.22" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/nzakas" + } + }, + "node_modules/@humanwhocodes/retry": { + "version": "0.4.3", + "resolved": "https://registry.npmjs.org/@humanwhocodes/retry/-/retry-0.4.3.tgz", + "integrity": "sha512-bV0Tgo9K4hfPCek+aMAn81RppFKv2ySDQeMoSZuvTASywNTnVJCArCZE2FWqpvIatKu7VMRLWlR1EazvVhDyhQ==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=18.18" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/nzakas" + } + }, "node_modules/@isaacs/cliui": { "version": "8.0.2", "resolved": "https://registry.npmjs.org/@isaacs/cliui/-/cliui-8.0.2.tgz", @@ -1180,6 +1395,13 @@ "@types/node": "*" } }, + "node_modules/@types/esrecurse": { + "version": "4.3.1", + "resolved": "https://registry.npmjs.org/@types/esrecurse/-/esrecurse-4.3.1.tgz", + "integrity": "sha512-xJBAbDifo5hpffDBuHl0Y8ywswbiAp/Wi7Y/GtAgSlZyIABppyurxVueOPE8LUQOxdlgi6Zqce7uoEpqNTeiUw==", + "dev": true, + "license": "MIT" + }, "node_modules/@types/estree": { "version": "1.0.7", "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.7.tgz", @@ -1483,6 +1705,29 @@ "node": ">= 0.6" } }, + "node_modules/acorn": { + "version": "8.16.0", + "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.16.0.tgz", + "integrity": "sha512-UVJyE9MttOsBQIDKw1skb9nAwQuR5wuGD3+82K6JgJlm/Y+KI92oNsMNGZCYdDsVtRHSak0pcV5Dno5+4jh9sw==", + "dev": true, + "license": "MIT", + "bin": { + "acorn": "bin/acorn" + }, + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/acorn-jsx": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/acorn-jsx/-/acorn-jsx-5.3.2.tgz", + "integrity": "sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==", + "dev": true, + "license": "MIT", + "peerDependencies": { + "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0" + } + }, "node_modules/agentkeepalive": { "version": "4.6.0", "resolved": "https://registry.npmjs.org/agentkeepalive/-/agentkeepalive-4.6.0.tgz", @@ -1496,9 +1741,10 @@ } }, "node_modules/ajv": { - "version": "6.12.6", - "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz", - "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==", + "version": "6.15.0", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.15.0.tgz", + "integrity": "sha512-fgFx7Hfoq60ytK2c7DhnF8jIvzYgOMxfugjLOSMHjLIPgenqa7S7oaagATUq99mV6IYvN2tRmC0wnTYX6iPbMw==", + "license": "MIT", "dependencies": { "fast-deep-equal": "^3.1.1", "fast-json-stable-stringify": "^2.0.0", @@ -1579,8 +1825,7 @@ "node_modules/argparse": { "version": "2.0.1", "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", - "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==", - "peer": true + "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==" }, "node_modules/array-flatten": { "version": "1.1.1", @@ -2005,6 +2250,13 @@ "node": ">=6" } }, + "node_modules/deep-is": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/deep-is/-/deep-is-0.1.4.tgz", + "integrity": "sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==", + "dev": true, + "license": "MIT" + }, "node_modules/delayed-stream": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz", @@ -2173,6 +2425,207 @@ "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz", "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==" }, + "node_modules/escape-string-regexp": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz", + "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/eslint": { + "version": "10.4.0", + "resolved": "https://registry.npmjs.org/eslint/-/eslint-10.4.0.tgz", + "integrity": "sha512-loXy6bWOoP3EP6JA7jo6p5jMpBJmHmsNZM5SFRHLdh1MGOPurMnNBj4ZlAbaqUAaQWbCr7jHV4P7gzAyryZWkQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@eslint-community/eslint-utils": "^4.8.0", + "@eslint-community/regexpp": "^4.12.2", + "@eslint/config-array": "^0.23.5", + "@eslint/config-helpers": "^0.6.0", + "@eslint/core": "^1.2.1", + "@eslint/plugin-kit": "^0.7.1", + "@humanfs/node": "^0.16.6", + "@humanwhocodes/module-importer": "^1.0.1", + "@humanwhocodes/retry": "^0.4.2", + "@types/estree": "^1.0.6", + "ajv": "^6.14.0", + "cross-spawn": "^7.0.6", + "debug": "^4.3.2", + "escape-string-regexp": "^4.0.0", + "eslint-scope": "^9.1.2", + "eslint-visitor-keys": "^5.0.1", + "espree": "^11.2.0", + "esquery": "^1.7.0", + "esutils": "^2.0.2", + "fast-deep-equal": "^3.1.3", + "file-entry-cache": "^8.0.0", + "find-up": "^5.0.0", + "glob-parent": "^6.0.2", + "ignore": "^5.2.0", + "imurmurhash": "^0.1.4", + "is-glob": "^4.0.0", + "json-stable-stringify-without-jsonify": "^1.0.1", + "minimatch": "^10.2.4", + "natural-compare": "^1.4.0", + "optionator": "^0.9.3" + }, + "bin": { + "eslint": "bin/eslint.js" + }, + "engines": { + "node": "^20.19.0 || ^22.13.0 || >=24" + }, + "funding": { + "url": "https://eslint.org/donate" + }, + "peerDependencies": { + "jiti": "*" + }, + "peerDependenciesMeta": { + "jiti": { + "optional": true + } + } + }, + "node_modules/eslint-scope": { + "version": "9.1.2", + "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-9.1.2.tgz", + "integrity": "sha512-xS90H51cKw0jltxmvmHy2Iai1LIqrfbw57b79w/J7MfvDfkIkFZ+kj6zC3BjtUwh150HsSSdxXZcsuv72miDFQ==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "@types/esrecurse": "^4.3.1", + "@types/estree": "^1.0.8", + "esrecurse": "^4.3.0", + "estraverse": "^5.2.0" + }, + "engines": { + "node": "^20.19.0 || ^22.13.0 || >=24" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/eslint-scope/node_modules/@types/estree": { + "version": "1.0.9", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.9.tgz", + "integrity": "sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==", + "dev": true, + "license": "MIT" + }, + "node_modules/eslint-visitor-keys": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-5.0.1.tgz", + "integrity": "sha512-tD40eHxA35h0PEIZNeIjkHoDR4YjjJp34biM0mDvplBe//mB+IHCqHDGV7pxF+7MklTvighcCPPZC7ynWyjdTA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^20.19.0 || ^22.13.0 || >=24" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/eslint/node_modules/balanced-match": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-4.0.4.tgz", + "integrity": "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==", + "dev": true, + "license": "MIT", + "engines": { + "node": "18 || 20 || >=22" + } + }, + "node_modules/eslint/node_modules/brace-expansion": { + "version": "5.0.6", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.6.tgz", + "integrity": "sha512-kLpxurY4Z4r9sgMsyG0Z9uzsBlgiU/EFKhj/h91/8yHu0edo7XuixOIH3VcJ8kkxs6/jPzoI6U9Vj3WqbMQ94g==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^4.0.2" + }, + "engines": { + "node": "18 || 20 || >=22" + } + }, + "node_modules/eslint/node_modules/minimatch": { + "version": "10.2.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.5.tgz", + "integrity": "sha512-MULkVLfKGYDFYejP07QOurDLLQpcjk7Fw+7jXS2R2czRQzR56yHRveU5NDJEOviH+hETZKSkIk5c+T23GjFUMg==", + "dev": true, + "license": "BlueOak-1.0.0", + "dependencies": { + "brace-expansion": "^5.0.5" + }, + "engines": { + "node": "18 || 20 || >=22" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/espree": { + "version": "11.2.0", + "resolved": "https://registry.npmjs.org/espree/-/espree-11.2.0.tgz", + "integrity": "sha512-7p3DrVEIopW1B1avAGLuCSh1jubc01H2JHc8B4qqGblmg5gI9yumBgACjWo4JlIc04ufug4xJ3SQI8HkS/Rgzw==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "acorn": "^8.16.0", + "acorn-jsx": "^5.3.2", + "eslint-visitor-keys": "^5.0.1" + }, + "engines": { + "node": "^20.19.0 || ^22.13.0 || >=24" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/esquery": { + "version": "1.7.0", + "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.7.0.tgz", + "integrity": "sha512-Ap6G0WQwcU/LHsvLwON1fAQX9Zp0A2Y6Y/cJBl9r/JbW90Zyg4/zbG6zzKa2OTALELarYHmKu0GhpM5EO+7T0g==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "estraverse": "^5.1.0" + }, + "engines": { + "node": ">=0.10" + } + }, + "node_modules/esrecurse": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/esrecurse/-/esrecurse-4.3.0.tgz", + "integrity": "sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "estraverse": "^5.2.0" + }, + "engines": { + "node": ">=4.0" + } + }, + "node_modules/estraverse": { + "version": "5.3.0", + "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-5.3.0.tgz", + "integrity": "sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==", + "dev": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">=4.0" + } + }, "node_modules/estree-walker": { "version": "3.0.3", "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-3.0.3.tgz", @@ -2182,6 +2635,16 @@ "@types/estree": "^1.0.0" } }, + "node_modules/esutils": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz", + "integrity": "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==", + "dev": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">=0.10.0" + } + }, "node_modules/etag": { "version": "1.8.1", "resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz", @@ -2310,6 +2773,13 @@ "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==", "license": "MIT" }, + "node_modules/fast-levenshtein": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/fast-levenshtein/-/fast-levenshtein-2.0.6.tgz", + "integrity": "sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==", + "dev": true, + "license": "MIT" + }, "node_modules/fast-uri": { "version": "3.0.6", "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.0.6.tgz", @@ -2369,6 +2839,19 @@ "node": ">= 8" } }, + "node_modules/file-entry-cache": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-8.0.0.tgz", + "integrity": "sha512-XXTUwCvisa5oacNGRP9SfNtYBNAMi+RPwBFmblZEF7N7swHYQS6/Zfk7SRwx4D5j3CH211YNRco1DEMNVfZCnQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "flat-cache": "^4.0.0" + }, + "engines": { + "node": ">=16.0.0" + } + }, "node_modules/finalhandler": { "version": "1.3.1", "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-1.3.1.tgz", @@ -2399,6 +2882,44 @@ "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz", "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==" }, + "node_modules/find-up": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz", + "integrity": "sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==", + "dev": true, + "license": "MIT", + "dependencies": { + "locate-path": "^6.0.0", + "path-exists": "^4.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/flat-cache": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/flat-cache/-/flat-cache-4.0.1.tgz", + "integrity": "sha512-f7ccFPK3SXFHpx15UIGyRJ/FJQctuKZ0zVuN3frBo4HnK3cay9VEW0R6yPYFHC0AgqhukPzKjq22t5DmAyqGyw==", + "dev": true, + "license": "MIT", + "dependencies": { + "flatted": "^3.2.9", + "keyv": "^4.5.4" + }, + "engines": { + "node": ">=16" + } + }, + "node_modules/flatted": { + "version": "3.4.2", + "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.4.2.tgz", + "integrity": "sha512-PjDse7RzhcPkIJwy5t7KPWQSZ9cAbzQXcafsetQoD7sOJRQlGikNbx7yZp2OotDnJyrDcbyRq3Ttb18iYOqkxA==", + "dev": true, + "license": "ISC" + }, "node_modules/follow-redirects": { "version": "1.15.9", "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.15.9.tgz", @@ -2591,6 +3112,19 @@ "url": "https://github.com/sponsors/isaacs" } }, + "node_modules/glob-parent": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz", + "integrity": "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==", + "dev": true, + "license": "ISC", + "dependencies": { + "is-glob": "^4.0.3" + }, + "engines": { + "node": ">=10.13.0" + } + }, "node_modules/gopd": { "version": "1.2.0", "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz", @@ -2688,6 +3222,26 @@ "node": ">=0.10.0" } }, + "node_modules/ignore": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz", + "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 4" + } + }, + "node_modules/imurmurhash": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz", + "integrity": "sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.8.19" + } + }, "node_modules/inherits": { "version": "2.0.4", "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", @@ -2701,6 +3255,16 @@ "node": ">= 0.10" } }, + "node_modules/is-extglob": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz", + "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, "node_modules/is-fullwidth-code-point": { "version": "3.0.0", "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz", @@ -2709,6 +3273,19 @@ "node": ">=8" } }, + "node_modules/is-glob": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz", + "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-extglob": "^2.1.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, "node_modules/is-promise": { "version": "4.0.0", "resolved": "https://registry.npmjs.org/is-promise/-/is-promise-4.0.0.tgz", @@ -2794,10 +3371,10 @@ } }, "node_modules/js-yaml": { - "version": "4.1.0", - "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz", - "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==", - "peer": true, + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.1.tgz", + "integrity": "sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==", + "license": "MIT", "dependencies": { "argparse": "^2.0.1" }, @@ -2805,11 +3382,65 @@ "js-yaml": "bin/js-yaml.js" } }, + "node_modules/json-buffer": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/json-buffer/-/json-buffer-3.0.1.tgz", + "integrity": "sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==", + "dev": true, + "license": "MIT" + }, "node_modules/json-schema-traverse": { "version": "0.4.1", "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz", "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==" }, + "node_modules/json-stable-stringify-without-jsonify": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/json-stable-stringify-without-jsonify/-/json-stable-stringify-without-jsonify-1.0.1.tgz", + "integrity": "sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw==", + "dev": true, + "license": "MIT" + }, + "node_modules/keyv": { + "version": "4.5.4", + "resolved": "https://registry.npmjs.org/keyv/-/keyv-4.5.4.tgz", + "integrity": "sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==", + "dev": true, + "license": "MIT", + "dependencies": { + "json-buffer": "3.0.1" + } + }, + "node_modules/levn": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/levn/-/levn-0.4.1.tgz", + "integrity": "sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "prelude-ls": "^1.2.1", + "type-check": "~0.4.0" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/locate-path": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz", + "integrity": "sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-locate": "^5.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, "node_modules/lodash.merge": { "version": "4.6.2", "resolved": "https://registry.npmjs.org/lodash.merge/-/lodash.merge-4.6.2.tgz", @@ -3019,6 +3650,13 @@ "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1" } }, + "node_modules/natural-compare": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/natural-compare/-/natural-compare-1.4.0.tgz", + "integrity": "sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==", + "dev": true, + "license": "MIT" + }, "node_modules/negotiator": { "version": "0.6.3", "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-0.6.3.tgz", @@ -3219,6 +3857,56 @@ "resolved": "https://registry.npmjs.org/openapi-types/-/openapi-types-12.1.3.tgz", "integrity": "sha512-N4YtSYJqghVu4iek2ZUvcN/0aqH1kRDuNqzcycDxhOUpg7GdvLa2F3DgS6yBNhInhv2r/6I0Flkn7CqL8+nIcw==" }, + "node_modules/optionator": { + "version": "0.9.4", + "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.4.tgz", + "integrity": "sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g==", + "dev": true, + "license": "MIT", + "dependencies": { + "deep-is": "^0.1.3", + "fast-levenshtein": "^2.0.6", + "levn": "^0.4.1", + "prelude-ls": "^1.2.1", + "type-check": "^0.4.0", + "word-wrap": "^1.2.5" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/p-limit": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz", + "integrity": "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "yocto-queue": "^0.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-locate": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-5.0.0.tgz", + "integrity": "sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-limit": "^3.0.2" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, "node_modules/package-json-from-dist": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/package-json-from-dist/-/package-json-from-dist-1.0.1.tgz", @@ -3233,6 +3921,16 @@ "node": ">= 0.8" } }, + "node_modules/path-exists": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz", + "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, "node_modules/path-key": { "version": "3.1.1", "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz", @@ -3332,6 +4030,32 @@ "node": "^10 || ^12 || >=14" } }, + "node_modules/prelude-ls": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.2.1.tgz", + "integrity": "sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/prettier": { + "version": "3.8.3", + "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.8.3.tgz", + "integrity": "sha512-7igPTM53cGHMW8xWuVTydi2KO233VFiTNyF5hLJqpilHfmn8C8gPf+PS7dUT64YcXFbiMGZxS9pCSxL/Dxm/Jw==", + "dev": true, + "license": "MIT", + "bin": { + "prettier": "bin/prettier.cjs" + }, + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/prettier/prettier?sponsor=1" + } + }, "node_modules/process-nextick-args": { "version": "2.0.1", "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.1.tgz", @@ -3986,6 +4710,19 @@ "fsevents": "~2.3.3" } }, + "node_modules/type-check": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/type-check/-/type-check-0.4.0.tgz", + "integrity": "sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==", + "dev": true, + "license": "MIT", + "dependencies": { + "prelude-ls": "^1.2.1" + }, + "engines": { + "node": ">= 0.8.0" + } + }, "node_modules/type-is": { "version": "1.6.18", "resolved": "https://registry.npmjs.org/type-is/-/type-is-1.6.18.tgz", @@ -4282,6 +5019,16 @@ "node": ">=8" } }, + "node_modules/word-wrap": { + "version": "1.2.5", + "resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.5.tgz", + "integrity": "sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, "node_modules/wrap-ansi": { "version": "8.1.0", "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-8.1.0.tgz", @@ -4457,6 +5204,19 @@ "node": ">=8" } }, + "node_modules/yocto-queue": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz", + "integrity": "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, "node_modules/zod": { "version": "3.24.1", "resolved": "https://registry.npmjs.org/zod/-/zod-3.24.1.tgz", diff --git a/package.json b/package.json index 8ea45a98..bbd0ba90 100644 --- a/package.json +++ b/package.json @@ -40,8 +40,11 @@ "@types/which": "^3.0.4", "@vitest/coverage-v8": "3.1.1", "esbuild": "^0.25.2", + "eslint": "^10.4.0", + "js-yaml": "^4.1.1", "multer": "1.4.5-lts.1", "openai": "^4.91.1", + "prettier": "^3.8.3", "tsx": "^4.19.3", "typescript": "^5.8.2", "vitest": "^3.1.1" diff --git a/scripts/compute_schedule.mjs b/scripts/compute_schedule.mjs new file mode 100755 index 00000000..3055cbeb --- /dev/null +++ b/scripts/compute_schedule.mjs @@ -0,0 +1,174 @@ +#!/usr/bin/env node + +import { execSync } from "child_process"; +import { readFileSync, writeFileSync, existsSync } from "fs"; +import path from "path"; +import yaml from "js-yaml"; + +// Telemetry Logic +function getCommitCount(days = 7) { + try { + const since = new Date( + Date.now() - days * 24 * 60 * 60 * 1000, + ).toISOString(); + const result = execSync(`git log --since="${since}" --format=oneline`) + .toString() + .trim(); + if (!result) return 0; + return result.split("\n").length; + } catch (err) { + return 0; // fallback if git fails + } +} + +// Very basic active period detection (mock for hour of least commits) +function getQuietHour() { + try { + const dates = execSync("git log --format=%aI") + .toString() + .trim() + .split("\n"); + if (!dates || dates.length === 0 || dates[0] === "") return 0; + + const hours = new Array(24).fill(0); + for (const d of dates) { + if (!d) continue; + const dateObj = new Date(d); + if (!isNaN(dateObj.getTime())) { + hours[dateObj.getHours()]++; + } + } + + // Find hour with min commits + let minHour = 0; + let minCount = Infinity; + for (let i = 0; i < 24; i++) { + if (hours[i] < minCount) { + minCount = hours[i]; + minHour = i; + } + } + return minHour; + } catch (err) { + return 0; // default to midnight + } +} + +// Compute new cadence +function computeSchedule() { + const commitCount = getCommitCount(14); // Look back 14 days + const velocity = commitCount / 14; + const quietHour = getQuietHour(); + + let schedule = `0 ${quietHour} * * *`; // Default: Rare/Infrequent (once a day) + let rationale = `Low activity (${velocity.toFixed(2)} commits/day). Running daily at hour ${quietHour}.`; + + if (velocity > 5) { + schedule = `0 ${quietHour},${(quietHour + 8) % 24},${(quietHour + 16) % 24} * * *`; + rationale = `High activity (${velocity.toFixed(2)} commits/day). Running 3x daily.`; + } else if (velocity > 2) { + schedule = `0 ${quietHour},${(quietHour + 12) % 24} * * *`; + rationale = `Active (${velocity.toFixed(2)} commits/day). Running 2x daily.`; + } else if (velocity < 0.2) { + schedule = `0 ${quietHour} * * 1`; // Once a week + rationale = `Dormant (${velocity.toFixed(2)} commits/day). Running weekly on Monday.`; + } + + return { schedule, rationale }; +} + +// Update schedule file +function updateScheduleFile(schedule, rationale) { + const schedulePath = path.join( + process.cwd(), + ".github", + "self-heal-schedule.yml", + ); + let data = {}; + + if (existsSync(schedulePath)) { + try { + const fileContents = readFileSync(schedulePath, "utf8"); + data = yaml.load(fileContents) || {}; + } catch (e) { + console.warn("Could not parse existing schedule file, creating new one."); + } + } + + // Oscillation guard: skip if updated in the last 3 days + if (data.last_updated) { + const lastUpdate = new Date(data.last_updated).getTime(); + const now = Date.now(); + const daysSinceUpdate = (now - lastUpdate) / (1000 * 60 * 60 * 24); + if (daysSinceUpdate < 3) { + console.log( + `\n=> Schedule was updated ${daysSinceUpdate.toFixed(1)} days ago (less than 3 days). Skipping recompute to avoid oscillation.`, + ); + return false; + } + } + + // If no change, return false + if (data.schedule === schedule && data.rationale === rationale) { + return false; + } + + data.schedule = schedule; + data.rationale = rationale; + data.last_updated = new Date().toISOString(); + + // Make sure we output valid yaml, and quote strings if needed + const newYaml = yaml.dump(data, { forceQuotes: true }); + writeFileSync(schedulePath, newYaml + "\n# AUTO-UPDATED\n", "utf8"); + return true; +} + +// Update Workflow file +function updateWorkflowFile(newSchedule) { + const workflowPath = path.join( + process.cwd(), + ".github", + "workflows", + "self-heal.yml", + ); + if (!existsSync(workflowPath)) return false; + + let content = readFileSync(workflowPath, "utf8"); + + // Replace the cron schedule in the workflow file. + // It anchors on the `# AUTO-UPDATED` comment. + const scheduleRegex = /cron:\s*['"]?.*['"]?\s*# AUTO-UPDATED/; + const replacement = `cron: "${newSchedule}" # AUTO-UPDATED`; + + if (scheduleRegex.test(content)) { + const updatedContent = content.replace(scheduleRegex, replacement); + if (content !== updatedContent) { + writeFileSync(workflowPath, updatedContent, "utf8"); + return true; + } + } + return false; +} + +async function main() { + console.log("=== Computing Self-Heal Schedule ==="); + const { schedule, rationale } = computeSchedule(); + console.log(`Computed Schedule: "${schedule}"`); + console.log(`Rationale: ${rationale}`); + + const changedData = updateScheduleFile(schedule, rationale); + const changedWf = updateWorkflowFile(schedule); + + if (changedData || changedWf) { + console.log("\n✅ Schedule updated. Changes need to be committed."); + process.exit(0); + } else { + console.log("\n✅ Schedule unchanged."); + process.exit(0); + } +} + +main().catch((err) => { + console.error(err); + process.exit(1); +}); diff --git a/scripts/healthcheck.mjs b/scripts/healthcheck.mjs new file mode 100755 index 00000000..6c6abe9a --- /dev/null +++ b/scripts/healthcheck.mjs @@ -0,0 +1,66 @@ +#!/usr/bin/env node + +import { execSync } from 'child_process'; +import { existsSync } from 'fs'; +import path from 'path'; + +// Helper to run commands +function runCmd(command, env = {}) { + try { + console.log(`\n=> Running: ${command}`); + execSync(command, { + stdio: 'inherit', + env: { ...process.env, ...env } + }); + return true; + } catch (error) { + console.error(`\n❌ Command failed: ${command}`); + return false; + } +} + +async function main() { + console.log('=== Running Healthcheck ==='); + let success = true; + + // 1. Check build + if (!runCmd('npm run build')) { + success = false; + } + + // 2. Check types + if (!runCmd('npx tsc --noEmit')) { + success = false; + } + + // 3. Check linting (if config exists) + const hasEslintConfig = existsSync(path.join(process.cwd(), 'eslint.config.js')) || + existsSync(path.join(process.cwd(), '.eslintrc.json')) || + existsSync(path.join(process.cwd(), '.eslintrc.js')); + + if (hasEslintConfig) { + if (!runCmd('npx eslint .')) { + success = false; + } + } else { + console.log('\n=> Skipping ESLint: No config found'); + } + + // 4. Check tests + if (!runCmd('npx vitest run --passWithNoTests')) { + success = false; + } + + if (success) { + console.log('\n✅ Healthcheck PASSED'); + process.exit(0); + } else { + console.error('\n❌ Healthcheck FAILED'); + process.exit(1); + } +} + +main().catch(err => { + console.error(err); + process.exit(1); +}); diff --git a/scripts/self_heal.mjs b/scripts/self_heal.mjs new file mode 100755 index 00000000..5b85f90d --- /dev/null +++ b/scripts/self_heal.mjs @@ -0,0 +1,105 @@ +#!/usr/bin/env node + +import { execSync } from 'child_process'; + +function runCmd(command, env = {}) { + try { + console.log(`\n=> Running: ${command}`); + execSync(command, { + stdio: 'inherit', + env: { ...process.env, ...env } + }); + return true; + } catch (error) { + console.error(`\n❌ Command failed: ${command}`); + return false; + } +} + +function getDiff() { + try { + return execSync('git status --porcelain').toString().trim(); + } catch (err) { + return ''; + } +} + +function runHealthcheck() { + console.log('\n=== Running Healthcheck ==='); + return runCmd('node scripts/healthcheck.mjs'); +} + +async function main() { + console.log('=== Starting Self-Heal Pipeline ==='); + + // 1. Rebuild/reinstall (clean install of tooling + deps) + console.log('\n--- Step 1: Rebuild / Reinstall ---'); + runCmd('npm ci'); + if (runHealthcheck() && getDiff() !== '') { + console.log('\n✅ Repair successful after Step 1.'); + process.exit(0); + } + + // 2. Lint/format auto-fix + console.log('\n--- Step 2: Lint and Format ---'); + // Only try eslint if we think it's configured. prettier we just run. + runCmd('npx eslint --fix . || true'); + runCmd('npx prettier -w .'); + if (runHealthcheck() && getDiff() !== '') { + console.log('\n✅ Repair successful after Step 2.'); + process.exit(0); + } + + // 3. Snapshot updates + console.log('\n--- Step 3: Snapshot Updates ---'); + runCmd('npx vitest run -u --passWithNoTests'); + if (runHealthcheck() && getDiff() !== '') { + console.log('\n✅ Repair successful after Step 3.'); + process.exit(0); + } + + // 4. Type stubs (Mock/skip as 'typesync' isn't explicitly configured) + console.log('\n--- Step 4: Type stubs ---'); + runCmd('npx typesync || true'); + if (runHealthcheck() && getDiff() !== '') { + console.log('\n✅ Repair successful after Step 4.'); + process.exit(0); + } + + // 5. Dependency re-resolve + console.log('\n--- Step 5: Dependency re-resolve ---'); + runCmd('npm update --latest'); + if (runHealthcheck() && getDiff() !== '') { + console.log('\n✅ Repair successful after Step 5.'); + process.exit(0); + } + + // 6. Static asset regeneration + console.log('\n--- Step 6: Static asset regeneration ---'); + // Assuming no specific generators for now, just build + runCmd('npm run build'); + if (runHealthcheck() && getDiff() !== '') { + console.log('\n✅ Repair successful after Step 6.'); + process.exit(0); + } + + // Final check + const isHealthy = runHealthcheck(); + const hasDiff = getDiff() !== ''; + + if (isHealthy && hasDiff) { + console.log('\n✅ Pipeline finished: Healthy with diff.'); + process.exit(0); + } else if (isHealthy && !hasDiff) { + console.log('\n✅ Pipeline finished: Healthy, no diff (no repair needed).'); + process.exit(1); // Exiting 1 so PR is not created when there's no diff. + } else { + console.log('\n❌ Pipeline finished: Unhealthy.'); + process.exit(1); + } +} + +main().catch(err => { + console.error(err); + process.exit(1); +});