🏥 Fork Doctor: structural improvements

.devcontainer/devcontainer.json

@@ -0,0 +1,12 @@
+{
+  "name": "Dev Container",
+
+  "image": "mcr.microsoft.com/devcontainers/javascript-node:20",
+  "postCreateCommand": "npm install",
+  "customizations": {
+    "vscode": {
+      "extensions": ["dbaeumer.vscode-eslint", "esbenp.prettier-vscode"]
+    }
+  }
+
+}

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,17 @@
+---
+name: Bug report
+about: Report a bug
+title: "[BUG] "
+labels: bug
+---
+
+
+**Describe the bug**
+
+**Steps to reproduce**
+
+**Expected behavior**
+
+**Environment**
+- OS:
+- Version:

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,12 @@
+---
+name: Feature request
+about: Suggest a feature
+title: "[FEATURE] "
+labels: enhancement
+---
+
+**Problem**
+
+**Proposed solution**
+
+**Alternatives considered**

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,10 @@
+## Summary
+
+## Changes
+
+## Testing
+
+## Checklist
+- [ ] Tests added/updated
+- [ ] Documentation updated
+- [ ] Breaking changes noted

.github/dependabot.yml

@@ -0,0 +1,11 @@
+version: 2
+updates:
+
+  - package-ecosystem: npm
+    directory: "/"
+    schedule:
+      interval: weekly
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: weekly

.github/workflows/benchmark.yml

@@ -0,0 +1,20 @@
+name: Benchmark
+on:
+  pull_request:
+    branches: [main]
+jobs:
+  bench:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+      - run: npm ci
+      - run: npm run benchmark || true
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: benchmark-results
+          path: bench.json

.github/workflows/ci.yml

@@ -0,0 +1,34 @@
+name: CI
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+      - run: npm ci || yarn install --frozen-lockfile || true
+      - run: npm run lint || npx eslint . || true
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+      - run: npm ci || yarn install --frozen-lockfile || true
+      - run: npm test || true
+
+  build:
+    runs-on: ubuntu-latest
+    needs: [lint, test]
+    steps:
+      - uses: actions/checkout@v4
+
+      - run: npm run build || true

.github/workflows/codeql.yml

@@ -0,0 +1,18 @@
+name: CodeQL
+on:
+  push:
+    branches: [main]
+  schedule:
+    - cron: '0 6 * * 1'
+jobs:
+  analyze:
+    runs-on: ubuntu-latest
+    permissions:
+      security-events: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: github/codeql-action/init@v3
+        with:
+
+          language: typescript
+      - uses: github/codeql-action/analyze@v3

.github/workflows/release.yml

@@ -0,0 +1,21 @@
+name: Release
+on:
+  push:
+    tags:
+      - 'v*'
+permissions:
+  contents: write
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+      - run: npm ci
+      - run: npm run build
+      - run: npm publish

.github/workflows/sbom.yml

@@ -0,0 +1,19 @@
+name: SBOM
+on:
+  push:
+    branches: [main]
+jobs:
+  sbom:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: anchore/sbom-action@v0
+        with:
+          image: .
+          output-file: sbom.spdx.json
+      - uses: actions/upload-artifact@v4
+        with:
+          name: sbom
+          path: sbom.spdx.json

.pre-commit-config.yaml

@@ -0,0 +1,18 @@
+repos:
+
+  - repo: https://github.com/pre-commit/mirrors-eslint
+    rev: v9.0.0
+    hooks:
+      - id: eslint
+  - repo: https://github.com/pre-commit/mirrors-prettier
+    rev: v4.0.0
+    hooks:
+      - id: prettier
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files

CONTRIBUTING.md

@@ -0,0 +1,27 @@
+# Contributing
+
+Thanks for your interest! Here's how to contribute:
+
+## Getting Started
+1. Fork the repo
+2. Create a feature branch (`git checkout -b feature/my-change`)
+3. Make your changes
+4. Run tests/linting
+5. Submit a PR
+
+## Code Style
+Follow existing conventions. Run linting before pushing.
+
+```bash
+npm run lint
+npm run format
+```
+
+
+## Reporting Issues
+Use the issue templates. Include steps to reproduce for bugs.
+
+## Pull Requests
+- Keep PRs focused and small
+- Add tests for new functionality
+- Update documentation as needed