@grunnverk/kilde 0.1.0

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,40 @@
+---
+name: Bug Report
+about: Create a report to help us improve
+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, Windows 11]
+- Node.js version: [e.g., 24.0.0]
+- Kilde version: [e.g., 0.1.0]
+- Installation method: [global, npx, local]
+
+## Configuration
+```yaml
+# Paste your .kilde/config.yaml here (remove sensitive info)
+```
+
+## Error Output
+```
+# Paste error messages or logs here
+```
+
+## Additional Context
+Add any other context about the problem here.

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,31 @@
+---
+name: Feature Request
+about: Suggest an idea for this project
+title: '[FEATURE] '
+labels: enhancement
+assignees: ''
+---
+
+## Feature Description
+A clear and concise description of the feature you'd like to see.
+
+## Problem Statement
+What problem does this feature solve? Is your feature request related to a problem?
+
+## Proposed Solution
+Describe the solution you'd like to see implemented.
+
+## Alternatives Considered
+Have you considered any alternative solutions or features?
+
+## Use Case
+Describe a specific use case where this feature would be beneficial.
+
+## Example Usage
+```bash
+# Show how the feature would be used
+kilde example --new-feature
+```
+
+## Additional Context
+Add any other context, screenshots, or examples about the feature request here.

package/.github/pull_request_template.md

@@ -0,0 +1,48 @@
+# Pull Request
+
+## Description
+Brief description of changes made in this PR.
+
+## Type of Change
+- [ ] Bug fix (non-breaking change that fixes an issue)
+- [ ] New feature (non-breaking change that adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+- [ ] Performance improvement
+- [ ] Code refactoring
+- [ ] Test improvement
+
+## Related Issues
+Fixes #(issue number)
+
+## Changes Made
+- Change 1
+- Change 2
+- Change 3
+
+## Testing
+- [ ] Tests pass locally (`npm test`)
+- [ ] New tests added for new functionality
+- [ ] Test coverage maintained or improved
+- [ ] Build succeeds (`npm run build`)
+- [ ] Linting passes (`npm run lint`)
+
+## Documentation
+- [ ] README updated (if needed)
+- [ ] API documentation updated (if needed)
+- [ ] CONTRIBUTING guide updated (if needed)
+- [ ] Comments added to complex code
+
+## Checklist
+- [ ] Code follows the project's style guidelines
+- [ ] Self-review of code completed
+- [ ] Comments added where needed
+- [ ] No console.log or debug statements
+- [ ] No breaking changes (or documented if necessary)
+- [ ] Commit messages follow conventional commits format
+
+## Screenshots (if applicable)
+Add screenshots to help explain your changes.
+
+## Additional Notes
+Any additional information that reviewers should know.

package/.github/workflows/deploy-docs.yml

@@ -0,0 +1,59 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'website/**'
+      - 'guide/**'
+      - 'README.md'
+      - 'docs/**'
+      - '.github/workflows/deploy-docs.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Build website
+        run: npm run docs:build
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: './website/dist'
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

package/.github/workflows/npm-publish.yml

@@ -0,0 +1,48 @@
+name: Publish to NPM
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24.x'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Run tests
+        run: npm test
+        env:
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+
+      - name: Build
+        run: npm run build
+
+      - name: Publish to NPM
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Create GitHub Release
+        uses: actions/create-release@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          tag_name: ${{ github.ref }}
+          release_name: Release ${{ github.ref }}
+          draft: false
+          prerelease: false

package/.github/workflows/test.yml

@@ -0,0 +1,48 @@
+name: Test
+
+on:
+  push:
+    branches: [main, working]
+  pull_request:
+    branches: [main, working]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    strategy:
+      matrix:
+        node-version: [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 }}
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Run linter
+        run: npm run lint
+
+      - name: Run tests with coverage
+        run: npm test
+        env:
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+
+      - name: Build
+        run: npm run build
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          file: ./coverage/lcov.info
+          flags: unittests
+          name: codecov-umbrella
+          fail_ci_if_error: false

package/CHANGELOG.md

@@ -0,0 +1,92 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- Initial release of Kilde
+- AI-powered commit message generation
+- Git-based release notes generation
+- Model Context Protocol (MCP) server integration
+- Interactive mode for reviewing messages
+- YAML/JSON configuration support
+- Comprehensive documentation (README, AI Guide, Contributing)
+- 107 unit tests with 85%+ coverage
+- GitHub Actions workflows for CI/CD
+
+## [0.1.0-dev.0] - 2026-01-21
+
+### Added
+- Project foundation and build system
+- Core commands: `commit` and `release`
+- Pure git implementation (no GitHub API dependencies)
+- Language-agnostic git automation
+- Commander.js CLI interface
+- Winston logging with debug mode
+- Configuration file support (.kilde/config.yaml)
+- Context files support for enhanced AI generation
+- Dry-run mode for previewing changes
+- MCP server with tools, resources, and prompts
+- Test suite with vitest
+- Comprehensive documentation
+
+### Features
+
+#### Commit Command
+- Generate AI-powered commit messages from git diff
+- Stage changes with `--add` flag
+- Auto-commit with `--sendit` flag
+- Interactive review mode
+- Amend previous commits
+- Push after committing
+- Custom context and context files
+- Dry-run preview mode
+
+#### Release Command
+- Generate release notes from git history
+- Tag-based version comparison
+- Customizable focus areas
+- Output to file
+- Interactive review mode
+- Context-aware generation
+
+#### MCP Integration
+- `kilde_commit` tool for AI assistants
+- `kilde_release` tool for AI assistants
+- Configuration resource (`kilde://config`)
+- Status resource (`kilde://status`)
+- Workspace resource (`kilde://workspace`)
+- Commit workflow prompt
+- Release workflow prompt
+
+### Technical
+- Node.js 24+ requirement
+- TypeScript strict mode
+- Vite build system (<30s builds)
+- ESLint + Prettier
+- Vitest for testing
+- Coverage reporting with v8
+- Git metadata injection in builds
+- Executable binaries (kilde, kilde-mcp)
+
+### Documentation
+- Comprehensive README with examples
+- AI Integration Guide for Claude
+- Contributing guidelines
+- API documentation
+- Issue and PR templates
+- Code of conduct
+
+### Infrastructure
+- GitHub Actions CI/CD
+- Automated testing on push/PR
+- NPM publishing workflow
+- CodeQL security analysis
+- Codecov integration
+
+[Unreleased]: https://github.com/grunnverk/kilde/compare/v0.1.0-dev.0...HEAD
+[0.1.0-dev.0]: https://github.com/grunnverk/kilde/releases/tag/v0.1.0-dev.0