@grunnverk/kilde 0.1.0

package/website/src/components/Commands.tsx

@@ -0,0 +1,182 @@
+import React from 'react';
+
+const Commands: React.FC = () => {
+    return (
+        <div className="section">
+            <h2>Commands</h2>
+            <p>
+        Kilde provides two core commands for git automation: <code className="code-inline">commit</code> and{' '}
+                <code className="code-inline">release</code>.
+            </p>
+
+            <h3>kilde commit</h3>
+            <p>Generate AI-powered commit messages from staged changes.</p>
+
+            <h4>Basic Usage</h4>
+            <div className="code-block">
+                <pre>{`# Generate message for staged changes
+kilde commit
+
+# Stage all changes and generate message
+kilde commit --add
+
+# Generate and commit immediately
+kilde commit --add --sendit`}</pre>
+            </div>
+
+            <h4>Common Flags</h4>
+            <div className="grid grid-2">
+                <div className="card">
+                    <h3>--add / -a</h3>
+                    <p>Stage all modified and deleted files before generating the commit message.</p>
+                    <div className="code-block">
+                        <pre>kilde commit --add</pre>
+                    </div>
+                </div>
+
+                <div className="card">
+                    <h3>--sendit / -s</h3>
+                    <p>Automatically commit without interactive review.</p>
+                    <div className="code-block">
+                        <pre>kilde commit --sendit</pre>
+                    </div>
+                </div>
+
+                <div className="card">
+                    <h3>--context / -c</h3>
+                    <p>Provide additional context to the AI for better commit messages.</p>
+                    <div className="code-block">
+                        <pre>kilde commit -c "Fix bug #123"</pre>
+                    </div>
+                </div>
+
+                <div className="card">
+                    <h3>--interactive / -i</h3>
+                    <p>Enable interactive mode to review and edit the generated message.</p>
+                    <div className="code-block">
+                        <pre>kilde commit --interactive</pre>
+                    </div>
+                </div>
+
+                <div className="card">
+                    <h3>--amend</h3>
+                    <p>Amend the previous commit instead of creating a new one.</p>
+                    <div className="code-block">
+                        <pre>kilde commit --amend</pre>
+                    </div>
+                </div>
+
+                <div className="card">
+                    <h3>--dry-run</h3>
+                    <p>Preview the generated message without committing.</p>
+                    <div className="code-block">
+                        <pre>kilde commit --dry-run</pre>
+                    </div>
+                </div>
+            </div>
+
+            <h3>kilde release</h3>
+            <p>Generate release notes from git history.</p>
+
+            <h4>Basic Usage</h4>
+            <div className="code-block">
+                <pre>{`# Generate notes for version 1.0.0
+kilde release 1.0.0
+
+# Generate notes between tags
+kilde release --from v0.9.0 --to v1.0.0
+
+# Generate notes from last tag to HEAD
+kilde release`}</pre>
+            </div>
+
+            <h4>Common Flags</h4>
+            <div className="grid grid-2">
+                <div className="card">
+                    <h3>--from &lt;ref&gt;</h3>
+                    <p>Starting git reference (tag, commit, branch).</p>
+                    <div className="code-block">
+                        <pre>kilde release --from v1.0.0</pre>
+                    </div>
+                </div>
+
+                <div className="card">
+                    <h3>--to &lt;ref&gt;</h3>
+                    <p>Ending git reference (tag, commit, branch).</p>
+                    <div className="code-block">
+                        <pre>kilde release --to HEAD</pre>
+                    </div>
+                </div>
+
+                <div className="card">
+                    <h3>--output / -o</h3>
+                    <p>Write release notes to a file instead of stdout.</p>
+                    <div className="code-block">
+                        <pre>kilde release -o RELEASE.md</pre>
+                    </div>
+                </div>
+
+                <div className="card">
+                    <h3>--focus</h3>
+                    <p>Focus on specific areas (comma-separated).</p>
+                    <div className="code-block">
+                        <pre>kilde release --focus security</pre>
+                    </div>
+                </div>
+
+                <div className="card">
+                    <h3>--interactive / -i</h3>
+                    <p>Review and edit release notes before saving.</p>
+                    <div className="code-block">
+                        <pre>kilde release --interactive</pre>
+                    </div>
+                </div>
+
+                <div className="card">
+                    <h3>--dry-run</h3>
+                    <p>Preview release notes without saving.</p>
+                    <div className="code-block">
+                        <pre>kilde release --dry-run</pre>
+                    </div>
+                </div>
+            </div>
+
+            <h3>Global Flags</h3>
+            <div className="grid grid-2">
+                <div className="card">
+                    <h3>--debug</h3>
+                    <p>Enable debug logging to see detailed execution information.</p>
+                    <div className="code-block">
+                        <pre>kilde commit --debug</pre>
+                    </div>
+                </div>
+
+                <div className="card">
+                    <h3>--config &lt;path&gt;</h3>
+                    <p>Specify a custom configuration file location.</p>
+                    <div className="code-block">
+                        <pre>kilde commit --config custom.yaml</pre>
+                    </div>
+                </div>
+
+                <div className="card">
+                    <h3>--version</h3>
+                    <p>Display the installed Kilde version.</p>
+                    <div className="code-block">
+                        <pre>kilde --version</pre>
+                    </div>
+                </div>
+
+                <div className="card">
+                    <h3>--help</h3>
+                    <p>Display help information for any command.</p>
+                    <div className="code-block">
+                        <pre>kilde commit --help</pre>
+                    </div>
+                </div>
+            </div>
+        </div>
+    );
+};
+
+export default Commands;

package/website/src/components/Configuration.tsx

@@ -0,0 +1,214 @@
+import React from 'react';
+
+const Configuration: React.FC = () => {
+    return (
+        <div className="section">
+            <h2>Configuration</h2>
+            <p>
+        Kilde supports flexible configuration via YAML or JSON files in multiple locations.
+            </p>
+
+            <h3>Configuration Locations</h3>
+            <p>Kilde searches for configuration files in this order:</p>
+            <div className="card">
+                <ol style={{ paddingLeft: '1.5rem', color: 'var(--color-text-secondary)' }}>
+                    <li>CLI <code className="code-inline">--config</code> flag</li>
+                    <li>Project config: <code className="code-inline">.kilde/config.yaml</code></li>
+                    <li>Project root: <code className="code-inline">.kilderc.yaml</code></li>
+                    <li>User home: <code className="code-inline">~/.kilde/config.yaml</code></li>
+                </ol>
+                <p style={{ marginTop: '1rem' }}>
+          Files are merged with later files taking precedence, allowing global defaults with project-specific overrides.
+                </p>
+            </div>
+
+            <h3>Basic Configuration</h3>
+            <div className="code-block">
+                <pre>{`# .kilde/config.yaml
+commit:
+  type: conventional
+  autoStage: false
+  ai:
+    model: gpt-4
+    temperature: 0.7
+
+release:
+  format: markdown
+  includeHashes: true`}</pre>
+            </div>
+
+            <h3>Commit Configuration</h3>
+            <div className="grid grid-2">
+                <div className="card">
+                    <h3>commit.type</h3>
+                    <p>Commit message format style.</p>
+                    <div className="code-block">
+                        <pre>{`commit:
+  type: conventional  # or 'simple'`}</pre>
+                    </div>
+                    <p>
+                        <strong>conventional</strong>: Follows Conventional Commits format
+                        <br />
+                        <strong>simple</strong>: Plain commit messages
+                    </p>
+                </div>
+
+                <div className="card">
+                    <h3>commit.autoStage</h3>
+                    <p>Automatically stage changes before committing.</p>
+                    <div className="code-block">
+                        <pre>{`commit:
+  autoStage: true`}</pre>
+                    </div>
+                    <p>Equivalent to <code className="code-inline">git add -A</code> before generating message.</p>
+                </div>
+
+                <div className="card">
+                    <h3>commit.ai.model</h3>
+                    <p>AI model to use for commit messages.</p>
+                    <div className="code-block">
+                        <pre>{`commit:
+  ai:
+    model: gpt-4  # or gpt-3.5-turbo`}</pre>
+                    </div>
+                    <p>Supports OpenAI and Anthropic models.</p>
+                </div>
+
+                <div className="card">
+                    <h3>commit.ai.temperature</h3>
+                    <p>Creativity level for AI responses (0.0 to 1.0).</p>
+                    <div className="code-block">
+                        <pre>{`commit:
+  ai:
+    temperature: 0.5  # More focused`}</pre>
+                    </div>
+                    <p>Lower values are more deterministic.</p>
+                </div>
+
+                <div className="card">
+                    <h3>commit.contextFiles</h3>
+                    <p>Files to always include for context.</p>
+                    <div className="code-block">
+                        <pre>{`commit:
+  contextFiles:
+    - CHANGELOG.md
+    - README.md`}</pre>
+                    </div>
+                    <p>Provides consistent context to the AI.</p>
+                </div>
+            </div>
+
+            <h3>Release Configuration</h3>
+            <div className="grid grid-2">
+                <div className="card">
+                    <h3>release.format</h3>
+                    <p>Output format for release notes.</p>
+                    <div className="code-block">
+                        <pre>{`release:
+  format: markdown  # or 'plain'`}</pre>
+                    </div>
+                </div>
+
+                <div className="card">
+                    <h3>release.includeHashes</h3>
+                    <p>Include commit hashes in release notes.</p>
+                    <div className="code-block">
+                        <pre>{`release:
+  includeHashes: true`}</pre>
+                    </div>
+                </div>
+
+                <div className="card">
+                    <h3>release.groupBy</h3>
+                    <p>How to group commits in release notes.</p>
+                    <div className="code-block">
+                        <pre>{`release:
+  groupBy: type  # or 'scope', 'none'`}</pre>
+                    </div>
+                </div>
+
+                <div className="card">
+                    <h3>release.focus</h3>
+                    <p>Default focus areas for release notes.</p>
+                    <div className="code-block">
+                        <pre>{`release:
+  focus:
+    - features
+    - security`}</pre>
+                    </div>
+                </div>
+            </div>
+
+            <h3>Environment Variables</h3>
+            <div className="card">
+                <h3>API Keys</h3>
+                <div className="code-block">
+                    <pre>{`# OpenAI
+export OPENAI_API_KEY=sk-...
+
+# Anthropic
+export ANTHROPIC_API_KEY=sk-ant-...`}</pre>
+                </div>
+
+                <h3>Other Variables</h3>
+                <div className="code-block">
+                    <pre>{`# Override config directory
+export KILDE_CONFIG_DIR=/custom/path
+
+# Set log level
+export KILDE_LOG_LEVEL=debug`}</pre>
+                </div>
+            </div>
+
+            <h3>Complete Example</h3>
+            <div className="code-block">
+                <pre>{`# .kilde/config.yaml
+commit:
+  type: conventional
+  autoStage: false
+  autoCommit: false
+  autoPush: false
+  contextFiles:
+    - CHANGELOG.md
+    - ARCHITECTURE.md
+  ai:
+    model: gpt-4
+    temperature: 0.7
+    maxTokens: 500
+  format:
+    maxLineLength: 72
+    scopeRequired: true
+
+release:
+  format: markdown
+  includeHashes: true
+  includeAuthors: true
+  groupBy: type
+  focus:
+    - features
+    - breaking
+    - security
+  ai:
+    model: gpt-4
+    temperature: 0.5
+    maxTokens: 2000
+
+mcp:
+  name: kilde
+  version: 0.1.0
+  tools:
+    - kilde_commit
+    - kilde_release
+  resources:
+    - config
+    - status
+    - workspace
+  prompts:
+    - commit-workflow
+    - release-workflow`}</pre>
+            </div>
+        </div>
+    );
+};
+
+export default Configuration;

package/website/src/components/Examples.tsx

@@ -0,0 +1,234 @@
+import React from 'react';
+
+const Examples: React.FC = () => {
+    return (
+        <div className="section">
+            <h2>Examples</h2>
+            <p>Real-world examples of using Kilde in different workflows.</p>
+
+            <h3>Quick Commit Workflow</h3>
+            <div className="card">
+                <p>Fast iteration with automatic staging and committing:</p>
+                <div className="code-block">
+                    <pre>{`# Make changes
+echo "export const API_URL = 'https://api.example.com';" > config.ts
+
+# Quick commit
+kilde commit --add --sendit
+
+# Generated commit:
+# feat(config): add API URL configuration
+#
+# Define API_URL constant for external service integration.`}</pre>
+                </div>
+            </div>
+
+            <h3>Interactive Review</h3>
+            <div className="card">
+                <p>Review and edit AI-generated messages:</p>
+                <div className="code-block">
+                    <pre>{`# Stage changes
+git add .
+
+# Generate and review
+kilde commit --interactive
+
+# Interactive prompt shows:
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# fix(auth): resolve session timeout issue
+#
+# Update session refresh logic to handle
+# edge cases properly.
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+#
+# [a] Accept  [e] Edit  [r] Regenerate  [c] Cancel`}</pre>
+                </div>
+            </div>
+
+            <h3>Commit with Context</h3>
+            <div className="card">
+                <p>Provide additional context for better messages:</p>
+                <div className="code-block">
+                    <pre>{`# Complex change that needs context
+kilde commit --add --context "Implement rate limiting per issue #456"
+
+# Generated commit:
+# feat(api): implement rate limiting
+#
+# Add rate limiting middleware to prevent API abuse.
+# Implements the solution proposed in issue #456 with
+# a token bucket algorithm.`}</pre>
+                </div>
+            </div>
+
+            <h3>Release Notes Generation</h3>
+            <div className="card">
+                <p>Generate release notes for a new version:</p>
+                <div className="code-block">
+                    <pre>{`# Generate notes for v2.0.0
+kilde release 2.0.0 --output RELEASE_NOTES.md
+
+# Generated content in RELEASE_NOTES.md:
+# # Release v2.0.0
+#
+# ## Features
+# - Add OAuth2 authentication
+# - Implement user profile management
+# - Add role-based access control
+#
+# ## Bug Fixes
+# - Fix session timeout handling
+# - Resolve memory leak in auth service
+#
+# ## Breaking Changes
+# - API endpoints now require authentication
+# - Update minimum Node.js version to 18`}</pre>
+                </div>
+            </div>
+
+            <h3>Release Notes Between Tags</h3>
+            <div className="card">
+                <p>Generate notes for a specific range:</p>
+                <div className="code-block">
+                    <pre>{`# Notes between two versions
+kilde release --from v1.9.0 --to v2.0.0 --interactive
+
+# Focus on security changes
+kilde release 2.0.0 --focus security,breaking`}</pre>
+                </div>
+            </div>
+
+            <h3>MCP Integration with Claude</h3>
+            <div className="card">
+                <p>Use Kilde through Claude Desktop:</p>
+                <div className="code-block">
+                    <pre>{`You: Create a commit for my staged changes
+
+Claude: I'll generate a commit message using Kilde.
+
+[Uses kilde_commit tool]
+
+Generated commit message:
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+feat(auth): add OAuth2 authentication
+
+Implement OAuth2 flow with support for
+Google and GitHub providers. Includes
+token refresh and secure storage.
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Would you like me to create this commit?
+
+You: Yes
+
+Claude: Commit created successfully!`}</pre>
+                </div>
+            </div>
+
+            <h3>Amend Previous Commit</h3>
+            <div className="card">
+                <p>Fix or update the last commit:</p>
+                <div className="code-block">
+                    <pre>{`# Made a mistake in last commit
+echo "// Fixed typo" >> auth.ts
+
+# Amend the commit
+kilde commit --add --amend
+
+# The AI will generate an updated message
+# that incorporates both the original and new changes`}</pre>
+                </div>
+            </div>
+
+            <h3>Dry Run Testing</h3>
+            <div className="card">
+                <p>Preview generated messages without committing:</p>
+                <div className="code-block">
+                    <pre>{`# Test commit message generation
+kilde commit --add --dry-run
+
+# Output shows:
+# - Generated commit message
+# - Affected files
+# - Diff summary
+# - Configuration used
+#
+# No actual commit is created`}</pre>
+                </div>
+            </div>
+
+            <h3>Complete Release Workflow</h3>
+            <div className="card">
+                <p>Full release process with tagging and pushing:</p>
+                <div className="code-block">
+                    <pre>{`# 1. Ensure all changes are committed
+git status
+
+# 2. Generate release notes interactively
+kilde release 1.5.0 --interactive --output RELEASE_NOTES.md
+
+# 3. Review and commit release notes
+git add RELEASE_NOTES.md
+kilde commit --sendit
+
+# 4. Create and push tag
+git tag v1.5.0
+git push origin main --tags
+
+# 5. Create GitHub release (optional)
+gh release create v1.5.0 --notes-file RELEASE_NOTES.md`}</pre>
+                </div>
+            </div>
+
+            <h3>Language-Agnostic Usage</h3>
+            <div className="card">
+                <p>Works with any programming language:</p>
+                <div className="code-block">
+                    <pre>{`# Python project
+cd my-python-app
+kilde commit --add
+
+# Go project
+cd my-go-service
+kilde commit --add
+
+# Rust project
+cd my-rust-lib
+kilde commit --add
+
+# Java project
+cd my-java-api
+kilde commit --add
+
+# All generate appropriate commit messages
+# based on the actual code changes, regardless
+# of the programming language`}</pre>
+                </div>
+            </div>
+
+            <h3>Team Configuration</h3>
+            <div className="card">
+                <p>Share configuration across your team:</p>
+                <div className="code-block">
+                    <pre>{`# Commit team config to repository
+# .kilde/config.yaml
+commit:
+  type: conventional
+  format:
+    maxLineLength: 72
+    scopeRequired: true
+  contextFiles:
+    - ARCHITECTURE.md
+
+# Individual developers can override in ~/.kilde/config.yaml
+commit:
+  autoStage: true  # Personal preference
+  ai:
+    model: gpt-3.5-turbo  # Faster for dev work`}</pre>
+                </div>
+            </div>
+        </div>
+    );
+};
+
+export default Examples;