lynkr 8.0.0 → 9.0.1

package/.github/workflows/README.md

@@ -1,215 +0,0 @@
-# GitHub Actions Workflows
-
-This directory contains GitHub Actions workflows for automated testing and CI/CD.
-
-## Available Workflows
-
-### 1. CI Tests (`ci.yml`)
-
-**Purpose:** Run comprehensive test suite on every push and pull request
-
-**Triggers:**
-- Push to `main` or `develop` branches
-- Pull requests to `main` or `develop` branches
-
-**What it does:**
-- Tests on Node.js 20.x and 22.x
-- Runs linter (`npm run lint`)
-- Runs unit tests (`npm run test:unit`)
-- Runs performance tests (`npm run test:performance`)
-- Uses npm cache for faster builds
-
-**Environment Variables:**
-- `DATABRICKS_API_KEY=test-key` (mock value for tests)
-- `DATABRICKS_API_BASE=http://test.com` (mock value for tests)
-
-**Status:** Runs on every push/PR, fails if unit tests fail
-
----
-
-### 2. Web Tools Tests (`web-tools-tests.yml`)
-
-**Purpose:** Run web search tool tests when related files change
-
-**Triggers:**
-- Changes to web tools source files:
-  - `src/tools/web.js`
-  - `src/tools/web-client.js`
-  - `src/clients/retry.js`
-  - `src/config/index.js`
-  - `test/web-tools.test.js`
-
-**What it does:**
-- Runs only the web tools test suite
-- Generates test summary in GitHub Actions UI
-- Faster feedback for web tools changes
-
-**Test Coverage:**
-- HTML extraction (9 tests)
-- HTTP keep-alive agent (2 tests)
-- Retry logic with exponential backoff (2 tests)
-- Configuration management (3 tests)
-- Error handling (1 test)
-- Performance validation (1 test)
-- Body preview configuration (1 test)
-
-**Total:** 19 tests
-
----
-
-### 3. NPM Publish (`npm-publish.yml`)
-
-**Purpose:** Automatically publish package to npm registry
-
-**Triggers:**
-- Git tags starting with `v` (e.g., `v0.1.5`)
-- GitHub Releases created
-
-**What it does:**
-- Runs full test suite before publishing
-- Checks if version already exists on npm
-- Publishes package to npm registry (if tests pass)
-- Prevents duplicate publishes
-- Creates publish summary
-
-**Requirements:**
-- `NPM_TOKEN` secret must be configured
-- Tests must pass
-- Version must be new
-
-**Status:** Only publishes on successful builds
-
----
-
-### 4. Version Bump (`version-bump.yml`)
-
-**Purpose:** Manual workflow to bump version and create releases
-
-**Triggers:**
-- Manual workflow dispatch (button in Actions tab)
-
-**What it does:**
-- Prompts for version type (patch/minor/major)
-- Runs tests before version bump
-- Updates package.json version
-- Creates git commit and tag
-- Pushes changes to repository
-- Creates GitHub Release with changelog
-- Triggers npm-publish workflow automatically
-
-**Options:**
-- `patch` - Bug fixes (0.1.4 → 0.1.5)
-- `minor` - New features (0.1.4 → 0.2.0)
-- `major` - Breaking changes (0.1.4 → 1.0.0)
-
----
-
-### 5. IndexNow Notification (`index.yml`)
-
-**Purpose:** Notify search engines when documentation is updated
-
-**Triggers:**
-- Push to `main` branch
-- Changes in `docs/**` directory
-
-**What it does:**
-- Notifies Bing IndexNow about updated documentation
-- Helps with SEO and documentation discoverability
-
----
-
-## Adding Status Badges
-
-Add these badges to your README.md:
-
-```markdown
-![CI Tests](https://github.com/vishalveerareddy123/Lynkr/actions/workflows/ci.yml/badge.svg)
-![Web Tools Tests](https://github.com/vishalveerareddy123/Lynkr/actions/workflows/web-tools-tests.yml/badge.svg)
-![npm version](https://img.shields.io/npm/v/lynkr.svg)
-![npm downloads](https://img.shields.io/npm/dt/lynkr.svg)
-```
-
-## Running Tests Locally
-
-Before pushing, run tests locally:
-
-```bash
-# Run all unit tests
-npm run test:unit
-
-# Run only web tools tests
-DATABRICKS_API_KEY=test-key DATABRICKS_API_BASE=http://test.com \
-  node --test test/web-tools.test.js
-
-# Run quick tests (routing only)
-npm run test:quick
-
-# Run all tests including performance
-npm test
-```
-
-## Workflow Configuration
-
-### Required Secrets
-
-**For npm publishing workflows:**
-- `NPM_TOKEN` - Your npm automation token (required to publish)
-  - Get from: https://www.npmjs.com/settings/YOUR_USERNAME/tokens
-  - Type: "Automation" token
-  - Add to: Settings → Secrets → Actions → New repository secret
-
-**For test workflows:**
-- No secrets required (uses mock credentials)
-
-**For IndexNow workflow:**
-- `INDEX_NOW` - Your IndexNow API key (optional, only for docs)
-
-### Matrix Strategy
-
-The CI workflow uses a matrix strategy to test on multiple Node.js versions:
-- Node.js 20.x (LTS)
-- Node.js 22.x (Current)
-
-This ensures compatibility across different Node versions.
-
-## Troubleshooting
-
-### Tests fail locally but pass in CI
-- Check Node.js version (`node --version`)
-- Ensure `npm ci` is used (not `npm install`)
-- Check for platform-specific issues (macOS vs Linux)
-
-### Tests pass locally but fail in CI
-- Environment variables might be missing
-- Dependencies might need updating
-- Check GitHub Actions logs for details
-
-### Workflow doesn't trigger
-- Verify file paths in `on.push.paths`
-- Check branch names match
-- Ensure workflow file is in `.github/workflows/`
-
-## Modifying Workflows
-
-When making changes:
-
-1. Test YAML syntax (use a YAML validator)
-2. Test locally first with same commands
-3. Create a PR to test in CI before merging
-4. Check GitHub Actions tab for results
-
-## Performance Considerations
-
-- **npm cache:** Workflows cache `node_modules` for faster builds
-- **Parallel jobs:** Tests run on multiple Node versions in parallel
-- **Path filtering:** Web tools workflow only runs when relevant files change
-- **continue-on-error:** Performance tests won't fail the build
-
-## Future Improvements
-
-Potential additions:
-- Code coverage reporting
-- Docker container testing
-- E2E integration tests
-- Deploy previews for PRs
-- Automated dependency updates (Dependabot)

package/.github/workflows/ci.yml

@@ -1,69 +0,0 @@
-name: CI Tests
-
-on:
-  push:
-    branches:
-      - main
-      - develop
-  pull_request:
-    branches:
-      - main
-      - develop
-
-jobs:
-  test:
-    name: Run Tests
-    runs-on: ubuntu-latest
-
-    strategy:
-      matrix:
-        node-version: [20.x, 22.x, 23.x, 24.x]
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-          cache: 'npm'
-
-      - name: Install dependencies (C++20 for native addons)
-        env:
-          CXXFLAGS: "-std=gnu++20"
-          npm_config_build_from_source: true
-        run: npm ci
-
-      - name: Run linter
-        run: npm run lint
-        continue-on-error: true
-
-      - name: Run unit tests
-        run: npm run test:unit
-        env:
-          DATABRICKS_API_KEY: test-key
-          DATABRICKS_API_BASE: http://test.com
-
-      - name: Run performance tests
-        run: npm run test:performance
-        env:
-          DATABRICKS_API_KEY: test-key
-          DATABRICKS_API_BASE: http://test.com
-        continue-on-error: true
-
-  test-summary:
-    name: Test Summary
-    runs-on: ubuntu-latest
-    needs: test
-    if: always()
-
-    steps:
-      - name: Check test results
-        run: |
-          echo "Tests completed"
-          if [ "${{ needs.test.result }}" == "failure" ]; then
-            echo "Tests failed!"
-            exit 1
-          fi
-          echo "All tests passed!"

package/.github/workflows/index.yml

@@ -1,62 +0,0 @@
-name: Notify IndexNow on Docs Update
-
-on:
-  push:
-    branches:
-      - main
-    paths:
-      - 'docs/**'
-
-jobs:
-  notify-indexnow:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Notify IndexNow
-        env:
-          INDEXNOW_KEY: ${{ secrets.INDEX_NOW }}
-        run: |
-          echo "Notifying IndexNow about updated docs..."
-
-          # Host
-          HOST="vishalveerareddy123.github.io"
-
-          # Secret key pulled from GitHub
-          KEY="$INDEXNOW_KEY"
-
-          # Public key location URL
-          KEY_LOCATION="https://$HOST/Lynkr/${KEY}.txt"
-
-          # Prepare JSON payload
-          URLS_JSON=$(cat <<EOF
-          {
-            "host": "$HOST",
-            "key": "$KEY",
-            "keyLocation": "$KEY_LOCATION",
-            "urlList": [
-              "https://$HOST/Lynkr/",
-              "https://$HOST/Lynkr/sitemap.xml"
-            ]
-          }
-          EOF
-          )
-
-          echo "Payload:"
-          echo "$URLS_JSON"
-
-          HTTP_CODE=$(curl -s -o /tmp/indexnow_response.txt -w "%{http_code}" \
-            -X POST "https://www.bing.com/indexnow" \
-            -H "Content-Type: application/json; charset=utf-8" \
-            -d "$URLS_JSON")
-
-          echo "IndexNow response HTTP code: $HTTP_CODE"
-          echo "IndexNow response body:"
-          cat /tmp/indexnow_response.txt
-
-          if [ "$HTTP_CODE" -ge 400 ]; then
-            echo "IndexNow request failed"
-            exit 1
-          fi

package/.github/workflows/web-tools-tests.yml

@@ -1,56 +0,0 @@
-name: Web Tools Tests
-
-on:
-  push:
-    paths:
-      - 'src/tools/web.js'
-      - 'src/tools/web-client.js'
-      - 'src/clients/retry.js'
-      - 'src/config/index.js'
-      - 'test/web-tools.test.js'
-      - '.github/workflows/web-tools-tests.yml'
-  pull_request:
-    paths:
-      - 'src/tools/web.js'
-      - 'src/tools/web-client.js'
-      - 'src/clients/retry.js'
-      - 'src/config/index.js'
-      - 'test/web-tools.test.js'
-
-jobs:
-  web-tools-test:
-    name: Web Tools Test Suite
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20.x'
-          cache: 'npm'
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Run web tools tests
-        run: |
-          DATABRICKS_API_KEY=test-key DATABRICKS_API_BASE=http://test.com \
-          node --test test/web-tools.test.js
-
-      - name: Test results summary
-        if: always()
-        run: |
-          echo "## Web Tools Test Results" >> $GITHUB_STEP_SUMMARY
-          echo "✅ All web tools tests passed!" >> $GITHUB_STEP_SUMMARY
-          echo "" >> $GITHUB_STEP_SUMMARY
-          echo "### Coverage:" >> $GITHUB_STEP_SUMMARY
-          echo "- HTML extraction (9 tests)" >> $GITHUB_STEP_SUMMARY
-          echo "- HTTP keep-alive agent (2 tests)" >> $GITHUB_STEP_SUMMARY
-          echo "- Retry logic with exponential backoff (2 tests)" >> $GITHUB_STEP_SUMMARY
-          echo "- Configuration management (3 tests)" >> $GITHUB_STEP_SUMMARY
-          echo "- Error handling (1 test)" >> $GITHUB_STEP_SUMMARY
-          echo "- Performance validation (1 test)" >> $GITHUB_STEP_SUMMARY
-          echo "- Body preview configuration (1 test)" >> $GITHUB_STEP_SUMMARY

package/CITATIONS.bib

@@ -1,6 +0,0 @@
-@article{zhang2024ace,
-  title={Agentic Context Engineering},
-  author={Zhang et al.},
-  journal={arXiv:2510.04618},
-  year={2024}
-}