gitsage-ai 0.2.0__tar.gz

gitsage_ai-0.2.0/.env.example

@@ -0,0 +1,14 @@
+# LLM Provider API Keys (fill in the one you're using)
+
+# DeepSeek (recommended — best value)
+DEEPSEEK_API_KEY=sk-your_key_here
+
+# Anthropic Claude (optional)
+ANTHROPIC_API_KEY=sk-ant-your_key_here
+
+# OpenAI (optional)
+OPENAI_API_KEY=sk-your_key_here
+
+# GitHub (optional — needed for gitsage explain/catchup to fetch PR/Issue context)
+# Scopes needed: repo (private) or public_repo (public only)
+GITHUB_TOKEN=ghp_your_token_here

gitsage_ai-0.2.0/.gitignore

@@ -0,0 +1,37 @@
+# Python
+__pycache__/
+*.py[cod]
+*.so
+.Python
+build/
+dist/
+*.egg-info/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Environment — NEVER commit
+.env
+.env.local
+
+# IDE
+.idea/
+.vscode/
+.DS_Store
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.mypy_cache/
+.ruff_cache/
+
+# gitsage runtime
+.gitsage_cache/
+CTX.local.md
+
+# Local memory (auto-generated)
+~/.gitsage/memory/

gitsage_ai-0.2.0/.gitsage/skills/commit/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: commit
+description: Generate git commit messages following project conventions
+trigger: auto
+---
+
+## Reasoning Steps
+
+1. Analyze staged diff — identify the INTENT, not just what files changed
+2. Cross-check against CTX.md commit conventions
+3. Extract JIRA/ticket number from branch name (if pattern matches)
+4. Generate primary candidate + 2 alternatives
+5. Assign confidence and reasoning to each candidate
+
+## Output Format
+
+Return structured JSON:
+{
+  "candidates": [
+    {
+      "message": "feat(payment): add retry mechanism with exponential backoff",
+      "confidence": "high",
+      "reason": "Clear intent from diff, matches project conventions"
+    },
+    {
+      "message": "feat: add payment retry logic",
+      "confidence": "medium",
+      "reason": "Missing module scope"
+    }
+  ],
+  "warning": null
+}
+
+## Guidelines
+
+- Extract purpose from diff, don't list filenames
+- If changes span multiple unrelated modules, suggest splitting
+- Set confidence to "low" when diff intent is unclear
+- warning field: use when commit should be split or something unusual detected

gitsage_ai-0.2.0/CHANGELOG.md

@@ -0,0 +1,68 @@
+# Changelog
+
+All notable changes to gitsage are documented here.
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+
+---
+
+## [0.2.0] — 2026-06-24
+
+### Added
+
+**MCP generation tools**
+- `generate_commit_message` — AI-generates commit candidates for staged changes via MCP. Runs the complete gitsage commit pipeline (CTX.md rules, memory, quality gate, deterministic override, style preferences) and returns ranked candidates with confidence scores and reasons. Any MCP-compatible client (Claude Code, Cursor, etc.) can now trigger gitsage generation directly.
+- `generate_standup` — AI-generates a standup report from today's commits via MCP. Respects CTX.md, memory and style preferences. Returns structured content with commit count and date.
+
+**Skill management**
+- `gitsage skill show <name>` — displays full SKILL.md content with Markdown syntax highlighting.
+- `gitsage skill add [name]` — interactive wizard that creates a correctly-formed SKILL.md (frontmatter + structured body template) in project or global scope.
+- `gitsage skill edit <name>` — opens a skill directly in `$EDITOR`.
+
+**`config init` interactive review loop**
+- After AI draft generation, users can apply natural-language modifications in a loop (e.g. "把站会格式改成英文", "加一条规则：禁止用英文") before saving. Modifications call a dedicated LLM pass and the updated content is shown immediately.
+- Mixed-language repo detection now prompts for explicit language choice (zh/en) before generation.
+- Multi-round pre-generation adjustment: each line adds an instruction; empty line proceeds to generate.
+
+### Fixed
+
+- `config init` review loop: `[y/回车]`, `[e]`, `[q]` shortcut labels were eaten by Rich's markup parser — escaped with `\[`.
+- `config init` input prompts: Chinese text in `input()` prompt caused readline to miscount cursor width, making backspace leave residual characters. Replaced with `console.input()` throughout.
+- CTX modify prompt / `StandupOutput` mismatch: system prompt said "output CTX.md only" while the code required JSON — the model returned empty content. Prompt updated to specify `{"content": "...", "items": []}` format.
+- Language preamble injected at top of system prompt (not appended) for stronger model compliance.
+
+### Changed
+
+- MCP server description updated to reflect new generation capabilities.
+- Project URLs in `pyproject.toml` corrected to `Moyonx/gitsage`.
+
+---
+
+## [0.1.0] — 2026-06-23
+
+### Added
+
+- **`gitsage commit`** — interactive commit message generation with 2–3 ranked candidates. Modes: `interactive` (default), `print`, `execute`, `hook` (for `prepare-commit-msg`). `--estimate` flag previews token cost.
+- **`gitsage standup`** — standup report from today's commits. `--print` for pipe-friendly plain text output.
+- **`gitsage pr`** — PR title and description for the current branch vs a base branch.
+- **`gitsage explain <file>`** — code archaeology: traces why code exists using git blame, commit history, and optional GitHub PR/Issue enrichment. Iterative agent loop with tool calls.
+- **`gitsage catchup`** — recent changes summary over a configurable time window.
+- **`gitsage config init`** — analyses git history and AI-generates a `CTX.md` project context file.
+- **`gitsage config show / set`** — view and modify configuration.
+- **`gitsage setup`** — interactive LLM provider wizard (Anthropic, OpenAI, DeepSeek, Ollama).
+- **`gitsage preferences`** — user preference survey: output language, emoji, scope, commit length, ticket format, standup audience.
+- **`gitsage model list / set / test`** — model management and connection testing.
+- **`gitsage memory show / clear`** — per-repo memory that summarises commit history and learned style.
+- **`gitsage skill list`** — list available skills from project and global directories.
+- **`gitsage install-hooks`** — installs `prepare-commit-msg` git hook for automatic suggestion on every `git commit`.
+- **`gitsage install-completion`** — shell tab completion for bash/zsh/fish.
+- **`gitsage doctor`** — environment and configuration health check.
+- **MCP Server** (`gitsage mcp serve`) — exposes git state as MCP tools: `get_staged_diff`, `get_recent_commits`, `get_git_status`, `get_branch_info`, `get_file_history`.
+- **`gitsage mcp install / status`** — register with Claude Desktop, Cursor, or any MCP client.
+- **Harness layer** — `QualityGate` enforces commit message rules (length, language, verb-start); `DeterministicOverride` injects ticket numbers and strips forbidden content regardless of LLM output.
+- **CTX.md** context system — project-level conventions file; parsed for commit rules, always/never rules, and language.
+- **Memory system** — append-on-commit, LLM-summarised every 20 observations, per-repo Markdown file.
+- **Skills system** — SKILL.md files in `.gitsage/skills/<name>/` inject domain-specific reasoning into prompts.
+- **Graceful degradation** — rate limit handling, LLM unavailability fallback with diff summary, GitHub-token-less local mode for `explain`.
+
+[0.2.0]: https://github.com/Moyonx/gitsage/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/Moyonx/gitsage/releases/tag/v0.1.0

gitsage_ai-0.2.0/CTX.md

@@ -0,0 +1,26 @@
+# gitsage - 项目上下文
+
+## 项目背景
+（请在此描述项目目的与功能）
+
+## 提交规范
+- 使用 Conventional Commits 格式：`<type>(<scope>): <description>`
+- 类型：feat / fix / refactor / chore / docs
+- 作用域：cli / preferences / agent / explain / readme 等模块名
+- 描述使用中文，简洁明确（平均 50 字符）
+- 示例：`feat(cli): config init 预生成调整改为多轮输入`
+
+## 站会报告格式
+- 面向技术团队
+- 按以下模板输出：
+  - 昨日完成：...
+  - 今日计划：...
+  - 阻塞问题：...
+- 每项使用一句简要的中文描述
+
+## 规则
+- 始终：提交信息使用中文
+- 始终：commit message 遵循 Conventional Commits
+- 始终：添加合适的作用域（scope）
+- 从不：在描述中使用表情符号
+- 从不：提交信息超过 100 字符

gitsage_ai-0.2.0/CTX.md.bak

@@ -0,0 +1,19 @@
+# CTX.md — gitsage 项目自身的上下文配置
+
+## 项目背景
+gitsage 是一个 git-native AI 开发者工作流助手，Python 实现。
+核心模块：cli / config / context / agent / harness / skills / mcp
+
+## Commit 规范
+格式：<类型>(<模块>): <描述>
+类型：feat / fix / refactor / test / docs / chore
+语言：英文
+示例：feat(cli): add interactive commit selection mode
+
+## 规则
+always:
+  - commit message 使用英文
+  - 描述简洁，动词开头
+never:
+  - 超过 72 字符
+  - 包含文件路径

gitsage_ai-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 gitsage Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.