feat: solana-depin-builder-skill — adaptive proof engine, coverage insurance, node reputation system

solana-depin-builder-skill/.github/ACTIONS.md

@@ -0,0 +1,102 @@
+name: CI — Lint, Validate & Test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  # ── Markdown lint ─────────────────────────────────────────────────────────────
+  markdown-lint:
+    name: Markdown Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+      - run: npm install -g markdownlint-cli@0.33.0
+      - run: markdownlint "**/*.md" --ignore node_modules --config .markdownlint.json
+
+  # ── Required file structure ────────────────────────────────────────────────
+  structure-check:
+    name: Required File Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Verify required files
+        run: |
+          REQUIRED=(
+            "AGENTS.md" "CLAUDE.md" "CONTRIBUTING.md" "SECURITY.md"
+            "README.md" "SKILL.md" "ecosystem-signals.md" "install.sh"
+            "rules/depin-safety.md"
+            "agents/depin-architect.md" "agents/reward-engineer.md"
+            "commands/depin-audit.md" "commands/node-economics.md"
+            "examples/ts/README.md" "examples/ts/src/roi-calculator.ts"
+            "examples/ts/tests/roi-calculator.test.ts"
+            "examples/anchor/README.md"
+            "examples/anchor/programs/depin-registry/src/lib.rs"
+          )
+          MISSING=0
+          for f in "${REQUIRED[@]}"; do
+            if [ -f "$f" ]; then echo "OK: $f"; else echo "MISSING: $f"; MISSING=$((MISSING+1)); fi
+          done
+          [ $MISSING -eq 0 ] || exit 1
+
+  # ── TypeScript examples — install + test ──────────────────────────────────
+  ts-tests:
+    name: TypeScript Example Tests
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: examples/ts
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+          cache-dependency-path: examples/ts/package-lock.json
+      - name: Install dependencies
+        run: npm install
+      - name: Run ROI calculator (smoke test)
+        run: node --loader ts-node/esm src/roi-calculator.ts || npx ts-node src/roi-calculator.ts
+      - name: Run unit tests
+        run: npm test -- --forceExit
+
+  # ── depin-safety.md policy assertions ─────────────────────────────────────
+  safety-policy-check:
+    name: Safety Policy Coverage
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Verify key safety terms referenced in skill files
+        run: |
+          TERMS=("anti-Sybil" "multisig" "emergency" "slash" "stake")
+          FAILURES=0
+          for term in "${TERMS[@]}"; do
+            if grep -rq "$term" skill/ agents/ commands/; then
+              echo "OK: '$term' referenced in skill/agents/commands"
+            else
+              echo "MISSING: '$term' — required by rules/depin-safety.md"
+              FAILURES=$((FAILURES+1))
+            fi
+          done
+          [ $FAILURES -eq 0 ] || exit 1
+
+  # ── Link check (internal) ─────────────────────────────────────────────────
+  link-check:
+    name: Internal Link Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+      - run: npm install -g markdown-link-check@3.11.0
+      - name: Check internal links in key docs
+        run: |
+          for f in README.md SKILL.md AGENTS.md CLAUDE.md; do
+            [ -f "$f" ] && markdown-link-check "$f" --config .mlc-config.json || true
+          done

solana-depin-builder-skill/.github/workflows/ci.yml

@@ -0,0 +1,185 @@
+name: CI/CD Pipeline
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  # TypeScript Examples
+  test-typescript:
+    name: Test TypeScript Examples
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: examples/ts/package-lock.json
+
+      - name: Install dependencies
+        working-directory: examples/ts
+        run: npm ci
+
+      - name: Run tests
+        working-directory: examples/ts
+        run: npm test
+
+      - name: Run ROI calculator
+        working-directory: examples/ts
+        run: npm run roi
+
+      - name: Security audit
+        working-directory: examples/ts
+        run: npm audit --audit-level=moderate
+
+      - name: Run Snyk security scan
+        uses: snyk/actions/node@master
+        env:
+          SNYK_TOKEN: ${{ secrets.SNYK_TOKEN }}
+        with:
+          args: --severity-threshold=high
+          command: test
+
+  # Anchor Program
+  test-anchor:
+    name: Test Anchor Program
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust
+        uses: actions-rs/toolchain@v1
+        with:
+          toolchain: stable
+          profile: minimal
+
+      - name: Install Solana CLI
+        run: sh -c "$(curl -sSfL https://release.solana.com/v1.18.4/install)"
+
+      - name: Install Anchor
+        run: cargo install --git https://github.com/coral-xyz/anchor avm --locked --force
+      - run: avm install latest
+      - run: avm use latest
+
+      - name: Build Anchor program
+        working-directory: examples/anchor
+        run: anchor build
+
+      - name: Run Anchor tests
+        working-directory: examples/anchor
+        run: anchor test --skip-local-validator
+
+      - name: Security audit (Cargo)
+        working-directory: examples/anchor
+        run: cargo audit
+
+      - name: Run Snyk security scan
+        uses: snyk/actions/rust@master
+        env:
+          SNYK_TOKEN: ${{ secrets.SNYK_TOKEN }}
+        with:
+          args: --severity-threshold=high
+          command: test
+
+  # Markdown Linting
+  lint-markdown:
+    name: Lint Markdown
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install markdownlint
+        run: npm install -g markdownlint-cli
+
+      - name: Run markdownlint
+        run: markdownlint '**/*.md' --config .markdownlint.json
+
+  # Structure Validation
+  validate-structure:
+    name: Validate Structure
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check required files exist
+        run: |
+          test -f SKILL.md || exit 1
+          test -f CLAUDE.md || exit 1
+          test -f AGENTS.md || exit 1
+          test -f README.md || exit 1
+          test -f rules/depin-safety.md || exit 1
+          test -f agents/depin-architect.md || exit 1
+          test -f agents/reward-engineer.md || exit 1
+          test -f skill/network-architecture.md || exit 1
+          test -f skill/oracle-integration.md || exit 1
+          test -f skill/coverage-verification.md || exit 1
+          test -f skill/reward-system.md || exit 1
+          test -f skill/node-registry.md || exit 1
+          test -f skill/data-marketplace.md || exit 1
+          test -f skill/network-growth.md || exit 1
+          test -f skill/hardware-integration.md || exit 1
+          test -f skill/depin-token-launch.md || exit 1
+          test -f skill/incident-response-integration.md || exit 1
+          test -f commands/depin-audit.md || exit 1
+          test -f commands/node-economics.md || exit 1
+          echo "✅ All required files exist"
+
+  # Test Coverage
+  coverage:
+    name: Test Coverage
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install dependencies
+        working-directory: examples/ts
+        run: npm ci
+
+      - name: Generate coverage report
+        working-directory: examples/ts
+        run: npm run test:coverage
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          file: examples/ts/coverage/lcov.info
+          flags: typescript
+
+  link-check:
+    name: Check Markdown Links
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Restore lychee cache
+        uses: actions/cache@v4
+        with:
+          path: .lycheecache
+          key: cache-lychee-${{ github.sha }}
+          restore-keys: cache-lychee-
+
+      - name: Run lychee link checker
+        uses: lycheeverse/lychee-action@v1
+        with:
+          args: >
+            --config .lychee.toml
+            --no-progress
+            '**/*.md'
+          fail: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

solana-depin-builder-skill/.markdownlint.json

@@ -0,0 +1,7 @@
+{
+  "default": true,
+  "MD013": false,
+  "MD033": false,
+  "MD041": false,
+  "MD024": false
+}

solana-depin-builder-skill/.mlc-config.json

@@ -0,0 +1,7 @@
+{
+  "ignorePatterns": [
+    { "pattern": "^https?://" }
+  ],
+  "retryOn429": true,
+  "retryCount": 3
+}

solana-depin-builder-skill/.vscode/extensions.json

@@ -0,0 +1,14 @@
+{
+  "recommendations": [
+    "dbaeumer.vscode-eslint",
+    "esbenp.prettier-vscode",
+    "rust-lang.rust-analyzer",
+    "tamasfe.even-better-toml",
+    "wayou.vscode-todo-highlight",
+    "streetsidesoftware.code-spell-checker",
+    "bierner.markdown-mermaid",
+    "yzhang.markdown-all-in-one",
+    "redhat.vscode-yaml",
+    "ms-vscode.makefile-tools"
+  ]
+}

solana-depin-builder-skill/.vscode/settings.json

@@ -0,0 +1,20 @@
+{
+  "editor.formatOnSave": true,
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "eslint.validate": [
+    "javascript",
+    "typescript",
+    "typescriptreact"
+  ],
+  "rust-analyzer.checkOnSave.command": "clippy",
+  "files.exclude": {
+    "**/.git": true,
+    "**/.svn": true,
+    "**/.hg": true,
+    "**/CVS": true,
+    "**/.DS_Store": true,
+    "**/Thumbs.db": true,
+    "**/node_modules": true,
+    "**/target": true
+  }
+}