seu-claude 1.1.1 → 2.3.0

package/.claude/settings.json

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "seu-claude": {
+      "command": "npx",
+      "args": [
+        "seu-claude"
+      ],
+      "env": {
+        "PROJECT_ROOT": "."
+      }
+    }
+  }
+}

package/.claude/settings.local.json

@@ -0,0 +1,62 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(git init:*)",
+      "Bash(git add:*)",
+      "Bash(git commit -m \"$\\(cat <<''EOF''\nfeat: initial implementation of seu-claude\n\nLocal Codebase RAG MCP Server for Claude Code with:\n- AST-based semantic chunking using Tree-sitter\n- LanceDB vector store for zero-copy disk-based storage\n- Transformers.js for local embedding generation\n- MCP server with index_codebase, search_codebase, and read_semantic_context tools\n- Incremental file hashing for efficient re-indexing\n- Multi-language support \\(TypeScript, JavaScript, Python, Rust, Go, Java, C/C++\\)\n\nAddresses the \"goldfish memory\" problem by proactively indexing the entire\ncodebase rather than relying on reactive observation of tool usage.\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>\nEOF\n\\)\")",
+      "Bash(git config:*)",
+      "Bash(git commit:*)",
+      "Bash(gh repo create:*)",
+      "Bash(gh repo view:*)",
+      "Bash(npm install:*)",
+      "Bash(npm run build:*)",
+      "Bash(node -e:*)",
+      "Bash(npm run lint:*)",
+      "Bash(timeout 5 node:*)",
+      "Bash(npm test:*)",
+      "Bash(npm run test:coverage:*)",
+      "Bash(git push:*)",
+      "Bash(npm run benchmark:*)",
+      "WebSearch",
+      "Bash(npm run download-model:*)",
+      "Bash(ls:*)",
+      "Bash(claude mcp add seu-claude --scope project -- npx seu-claude)",
+      "Bash(seu-claude doctor:*)",
+      "mcp__seu-claude__index_codebase",
+      "mcp__seu-claude__search_codebase",
+      "mcp__ide__getDiagnostics",
+      "Bash(git tag:*)",
+      "Bash(gh run:*)",
+      "Bash(npx prettier:*)",
+      "Bash(npm publish --access public)",
+      "Bash(npm view:*)",
+      "Bash(gh release list:*)",
+      "Bash(gh release create:*)",
+      "Bash(xargs cat:*)",
+      "Bash(wc:*)",
+      "Bash(for i in 1 2 3)",
+      "Bash(do echo \"=== Run $i ===\")",
+      "Bash(done)",
+      "mcp__seu-claude__search_xrefs",
+      "mcp__seu-claude__get_stats",
+      "Bash(git pull:*)",
+      "Bash(git stash:*)",
+      "Bash(cat:*)",
+      "Bash(npm run format:check:*)",
+      "Bash(npm run format:*)",
+      "Bash(git checkout:*)",
+      "Bash(xargs:*)",
+      "Bash(npx ts-node:*)",
+      "Bash(git rm:*)",
+      "Bash(git reset:*)",
+      "Bash(node scripts/fix-imports.mjs:*)",
+      "Bash(node:*)",
+      "Bash(npx tsx:*)",
+      "Bash(echo:*)"
+    ]
+  },
+  "enableAllProjectMcpServers": true,
+  "enabledMcpjsonServers": [
+    "seu-claude"
+  ]
+}

package/.dockerignore

@@ -0,0 +1,30 @@
+# Docker ignore file
+node_modules/
+dist/
+coverage/
+.git/
+.github/
+.husky/
+.vscode/
+
+# Test files
+**/__tests__/
+**/*.test.ts
+**/*.spec.ts
+jest.config.js
+
+# Development files
+*.md
+!README.md
+!LICENSE
+!CHANGELOG.md
+.eslintrc*
+.prettierrc
+tsconfig.json
+commitlint.config.cjs
+
+# Misc
+*.log
+*.tgz
+.DS_Store
+benchmark-results/

package/.eslintrc.cjs

@@ -0,0 +1,81 @@
+module.exports = {
+  root: true,
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    ecmaVersion: 2022,
+    sourceType: 'module',
+    project: './tsconfig.json',
+  },
+  plugins: ['@typescript-eslint'],
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended',
+    'plugin:@typescript-eslint/recommended-requiring-type-checking',
+  ],
+  env: {
+    node: true,
+    es2022: true,
+  },
+  rules: {
+    // TypeScript strict rules
+    '@typescript-eslint/explicit-function-return-type': 'warn',
+    '@typescript-eslint/no-explicit-any': 'warn',
+    '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+    '@typescript-eslint/strict-boolean-expressions': 'off',
+    '@typescript-eslint/no-floating-promises': 'error',
+    '@typescript-eslint/await-thenable': 'error',
+    '@typescript-eslint/no-misused-promises': 'error',
+    '@typescript-eslint/prefer-nullish-coalescing': 'warn',
+    '@typescript-eslint/prefer-optional-chain': 'warn',
+    
+    // Security rules
+    'no-eval': 'error',
+    'no-implied-eval': 'error',
+    'no-new-func': 'error',
+    'no-script-url': 'error',
+    
+    // Code quality
+    'no-console': ['warn', { allow: ['warn', 'error'] }],
+    'no-debugger': 'error',
+    'no-duplicate-imports': 'error',
+    'no-template-curly-in-string': 'warn',
+    'prefer-const': 'error',
+    'eqeqeq': ['error', 'always'],
+    
+    // Async/Promise handling
+    'no-async-promise-executor': 'error',
+    'no-promise-executor-return': 'error',
+    'require-atomic-updates': 'error',
+    
+    // Error handling
+    'no-throw-literal': 'error',
+  },
+  overrides: [
+    {
+      // Relax rules for test files
+      files: ['**/__tests__/**/*.ts', '**/*.test.ts', '**/*.spec.ts'],
+      rules: {
+        '@typescript-eslint/no-explicit-any': 'off',
+        '@typescript-eslint/no-unsafe-assignment': 'off',
+        '@typescript-eslint/no-unsafe-member-access': 'off',
+        '@typescript-eslint/no-unsafe-call': 'off',
+        'no-console': 'off',
+      },
+    },
+    {
+      // Relax rules for scripts
+      files: ['scripts/**/*.ts'],
+      rules: {
+        'no-console': 'off',
+        '@typescript-eslint/no-floating-promises': 'off',
+      },
+    },
+  ],
+  ignorePatterns: [
+    'dist/',
+    'node_modules/',
+    'coverage/',
+    '*.js',
+    '*.cjs',
+  ],
+};

package/.eslintrc.json

@@ -0,0 +1,26 @@
+{
+  "root": true,
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaVersion": 2022,
+    "sourceType": "module",
+    "project": "./tsconfig.json"
+  },
+  "plugins": ["@typescript-eslint"],
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended",
+    "plugin:@typescript-eslint/recommended-requiring-type-checking"
+  ],
+  "env": {
+    "node": true,
+    "es2022": true
+  },
+  "rules": {
+    "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
+    "@typescript-eslint/explicit-function-return-type": "off",
+    "@typescript-eslint/no-explicit-any": "warn",
+    "no-console": ["warn", { "allow": ["warn", "error"] }]
+  },
+  "ignorePatterns": ["dist/", "node_modules/", "*.js"]
+}

package/.github/CODEOWNERS

@@ -0,0 +1,16 @@
+# Default owners for everything
+* @jardhel
+
+# Security-sensitive files require owner review
+SECURITY.md @jardhel
+.github/workflows/** @jardhel
+package.json @jardhel
+package-lock.json @jardhel
+
+# Core source code
+src/** @jardhel
+
+# Configuration files
+tsconfig.json @jardhel
+.eslintrc* @jardhel
+Dockerfile @jardhel

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,42 @@
+---
+name: Bug Report
+about: Report a bug or unexpected behavior
+title: '[BUG] '
+labels: bug
+assignees: ''
+---
+
+## Bug Description
+
+A clear and concise description of what the bug is.
+
+## Steps to Reproduce
+
+1. Go to '...'
+2. Run command '...'
+3. See error
+
+## Expected Behavior
+
+What you expected to happen.
+
+## Actual Behavior
+
+What actually happened.
+
+## Environment
+
+- OS: [e.g., macOS 14.0, Ubuntu 22.04]
+- Node.js version: [e.g., 20.10.0]
+- seu-claude version: [e.g., 1.0.0]
+- Claude Code/Desktop version: [if applicable]
+
+## Logs
+
+```
+Paste relevant logs here
+```
+
+## Additional Context
+
+Add any other context about the problem here.

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,27 @@
+---
+name: Feature Request
+about: Suggest a new feature or enhancement
+title: '[FEATURE] '
+labels: enhancement
+assignees: ''
+---
+
+## Feature Description
+
+A clear and concise description of the feature you'd like.
+
+## Problem it Solves
+
+What problem does this feature solve? Is this related to a frustration?
+
+## Proposed Solution
+
+How do you envision this feature working?
+
+## Alternatives Considered
+
+What alternatives have you considered?
+
+## Additional Context
+
+Add any other context, mockups, or examples about the feature request here.

package/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,45 @@
+## Description
+
+<!-- Describe your changes in detail -->
+
+## Type of Change
+
+<!-- Mark relevant items with an x -->
+
+- [ ] Bug fix (non-breaking change that fixes an issue)
+- [ ] New feature (non-breaking change that adds functionality)
+- [ ] Breaking change (fix or feature that changes existing functionality)
+- [ ] Documentation update
+- [ ] Performance improvement
+- [ ] Code refactoring
+
+## Related Issues
+
+<!-- Link any related issues here using #issue_number -->
+
+Fixes #
+
+## Testing
+
+<!-- Describe how you tested your changes -->
+
+- [ ] Added/updated unit tests
+- [ ] All existing tests pass
+- [ ] Tested manually with Claude Code/Desktop
+
+## Checklist
+
+- [ ] My code follows the project's style guidelines
+- [ ] I have performed a self-review of my code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings
+- [ ] New and existing unit tests pass locally with my changes
+
+## Screenshots (if applicable)
+
+<!-- Add screenshots to help explain your changes -->
+
+## Additional Notes
+
+<!-- Any additional information that reviewers should know -->

package/.github/SUPPORT.md

@@ -0,0 +1,54 @@
+# Support
+
+Thank you for using **seu-claude**! We're here to help.
+
+## Getting Help
+
+### 📚 Documentation
+
+Before opening an issue, please check:
+
+- [README.md](README.md) - Installation and quick start
+- [CONTRIBUTING.md](CONTRIBUTING.md) - How to contribute
+- [GitHub Discussions](https://github.com/jardhel/seu-claude/discussions) - Community Q&A
+
+### 🐛 Bug Reports
+
+If you've found a bug:
+
+1. Check [existing issues](https://github.com/jardhel/seu-claude/issues) to see if it's already reported
+2. Use the [Bug Report template](.github/ISSUE_TEMPLATE/bug_report.md)
+3. Include all requested information
+
+### 💡 Feature Requests
+
+Have an idea? We'd love to hear it:
+
+1. Check [existing feature requests](https://github.com/jardhel/seu-claude/issues?q=is%3Aissue+label%3Aenhancement)
+2. Use the [Feature Request template](.github/ISSUE_TEMPLATE/feature_request.md)
+3. Explain your use case
+
+### ❓ Questions
+
+For general questions:
+
+- Open a [GitHub Discussion](https://github.com/jardhel/seu-claude/discussions)
+- Tag with the `question` label
+
+## Response Time
+
+- Critical bugs: Within 24 hours
+- Feature requests: Within 1 week
+- Questions: Within 2-3 days
+
+## Community Guidelines
+
+Please be respectful and constructive. We follow the [Contributor Covenant Code of Conduct](https://www.contributor-covenant.org/version/2/1/code_of_conduct/).
+
+## Commercial Support
+
+For enterprise support or custom development, contact: [your-email@example.com]
+
+---
+
+**Thank you for being part of the seu-claude community!** 🚀

package/.github/workflows/ci.yml

@@ -0,0 +1,186 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Lint & Format Check
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        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 --ignore-scripts
+      
+      - name: Run ESLint
+        run: npm run lint
+      
+      - name: Check formatting
+        run: npm run format:check
+
+  typecheck:
+    name: Type Check
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        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 --ignore-scripts
+      
+      - name: Type check
+        run: npm run typecheck
+
+  build:
+    name: Build & Test
+    runs-on: ubuntu-latest
+    needs: [lint, typecheck]
+
+    strategy:
+      matrix:
+        node-version: [20.x, 22.x]
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci --ignore-scripts
+
+      - name: Download tree-sitter grammars
+        run: npm run download-grammars
+
+      - name: Build
+        run: npm run build
+
+      - name: Run tests with coverage
+        run: npm run test:coverage -- --passWithNoTests
+
+      - name: Upload coverage artifact
+        if: matrix.node-version == '20.x'
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report
+          path: coverage/
+      
+      - name: Check coverage threshold
+        if: matrix.node-version == '20.x'
+        run: |
+          COVERAGE=$(cat coverage/coverage-summary.json | jq '.total.statements.pct')
+          echo "Coverage: $COVERAGE%"
+          if (( $(echo "$COVERAGE < 70" | bc -l) )); then
+            echo "::error::Coverage $COVERAGE% is below 70% threshold"
+            exit 1
+          fi
+        continue-on-error: true
+
+  security:
+    name: Security Audit
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        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 --ignore-scripts
+      
+      - name: Run npm audit
+        run: npm audit --audit-level=high
+        continue-on-error: true
+
+  sonarcloud:
+    name: SonarCloud Analysis
+    needs: build
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' || github.event.pull_request.head.repo.full_name == github.repository
+    continue-on-error: true  # Don't fail the workflow if SonarCloud isn't configured
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20.x
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci --ignore-scripts
+
+      - name: Download tree-sitter grammars
+        run: npm run download-grammars
+
+      - name: Run tests with coverage
+        run: npm run test:coverage -- --passWithNoTests
+
+      - name: SonarCloud Scan
+        uses: SonarSource/sonarcloud-github-action@master
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
+
+  release:
+    needs: [build]  # Remove sonarcloud dependency
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20.x
+          cache: 'npm'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm ci --ignore-scripts
+
+      - name: Build
+        run: npm run build
+
+      # Uncomment when ready to publish to npm
+      # - name: Publish to npm
+      #   run: npm publish --access public
+      #   env:
+      #     NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}