vibe-package-manager 1.0.0__tar.gz

vibe_package_manager-1.0.0/CHANGELOG.md

@@ -0,0 +1,68 @@
+# 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 Vibe Package Manager
+- SKILL synchronization from Git repositories
+- SubAgent synchronization from Git repositories
+- MCP installation via commands
+- Version compatibility checking with caret (^) notation support
+- Configuration file validation
+- Multi-agent support (Claude, iFlow)
+- Comprehensive documentation
+
+### Features
+- **Version Management**: Track and manage versions of SKILLs and SubAgents
+- **Dependency Resolution**: Support for semantic versioning with caret (^) notation
+- **Multi-Agent Support**: Sync to multiple agents from a single configuration
+- **Git Integration**: Clone and sync packages from Git repositories
+- **MCP Installation**: Execute installation commands for MCP servers
+- **Validation**: Validate configuration files and check version compatibility
+
+### Documentation
+- README.md with complete usage guide
+- QUICKSTART.md for getting started quickly
+- Example SKILL and SubAgent files
+- JSON Schema for configuration validation
+- Comprehensive open source guidelines
+
+## [1.0.0] - 2026-03-19
+
+### Added
+- Initial public release
+- Core package management functionality
+- CLI interface with sync and validate commands
+- Support for SKILL, SubAgent, and MCP dependencies
+- Git repository cloning and synchronization
+- Version compatibility validation
+- Configuration file validation
+- Comprehensive error handling and reporting
+
+### Documentation
+- Complete README with usage examples
+- Quick start guide
+- Open source contribution guidelines
+- Code of conduct
+- Security policy
+
+---
+
+## Version Format
+
+- **[Unreleased]**: Changes planned for the next release
+- **[X.Y.Z]**: Released versions
+
+## Change Types
+
+- **Added**: New features
+- **Changed**: Changes in existing functionality
+- **Deprecated**: Soon-to-be removed features
+- **Removed**: Removed features
+- **Fixed**: Bug fixes
+- **Security**: Security vulnerability fixes

vibe_package_manager-1.0.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,49 @@
+# Contributor Covenant Code of Conduct
+
+## 我们的承诺
+
+为了营造一个开放和友好的环境，我们作为贡献者和维护者承诺：无论年龄、体型、残疾、民族、性别认同和表达、经验水平、教育程度、社会经济地位、国籍、个人形象、种族、宗教或性认同和性取向如何，都欢迎参与我们项目的每个人。
+
+## 我们的标准
+
+积极行为包括：
+
+- 使用欢迎和包容的语言
+- 尊重不同的观点和经验
+- 优雅地接受建设性批评
+- 关注对社区最有利的事情
+- 对其他社区成员表示同理心
+
+不可接受的行为包括：
+
+- 使用性化的语言或图像，以及不受欢迎的性关注或性骚扰
+- 恶意评论、侮辱/贬损评论、个人或政治攻击
+- 公开或私下的骚扰
+- 未经明确许可发布他人的私人信息，例如物理地址或电子邮件地址
+- 在专业场合可能被合理认为不适当的其他行为
+
+## 我们的责任
+
+项目维护者有责任阐明可接受行为的标准，并应对任何不可接受的行为采取适当和公平的纠正措施。
+
+项目维护者有权并有权删除、编辑或拒绝不符合本行为准则的评论、提交、代码、wiki 编辑、问题和其他贡献，并有权暂时或永久禁止任何他们认为行为不当、威胁、冒犯或有害的贡献者。
+
+## 适用范围
+
+本行为准则适用于所有项目空间，当个人代表项目或其社区时也适用于公共空间。代表项目或社区的示例包括使用官方项目电子邮件地址、通过官方社交媒体账户发布或在在线或离线活动中担任指定代表。项目维护者可以进一步阐明和澄清项目代表性。
+
+## 执行
+
+可以通过项目团队发送邮件至 [maintainer@example.com] 来报告滥用、骚扰或其他不可接受的行为。所有投诉都将被审查和调查，并将产生被认为必要且适合情况的回应。项目团队有义务对事件的报告者保密。具体执行政策的更多细节可能会单独发布。
+
+不真诚地遵守或执行行为准则的项目维护者可能面临项目领导层确定的临时或永久后果。
+
+## 归属
+
+本行为准则改编自 [贡献者公约][homepage]，版本 1.4，
+可在 https://www.contributor-covenant.org/version/1/4/code-of-conduct.html 查看
+
+[homepage]: https://www.contributor-covenant.org
+
+有关本行为准则的常见问题的答案，请参阅
+https://www.contributor-covenant.org/faq

vibe_package_manager-1.0.0/CONTRIBUTING.md

@@ -0,0 +1,226 @@
+# Contributing to Vibe Package Manager
+
+感谢您对 Vibe Package Manager 项目的关注！我们欢迎所有形式的贡献。
+
+## 如何贡献
+
+### 报告 Bug
+
+如果您发现了 Bug，请：
+
+1. 检查 [Issues](https://github.com/YOUR_USERNAME/vibe_package_manager/issues) 确认问题尚未被报告
+2. 创建新的 Issue，使用 Bug 报告模板
+3. 提供详细信息：
+   - Bug 描述
+   - 复现步骤
+   - 预期行为
+   - 实际行为
+   - 环境信息（操作系统、Python 版本等）
+   - 相关日志或截图
+
+### 提出功能建议
+
+如果您有功能建议，请：
+
+1. 检查 [Issues](https://github.com/YOUR_USERNAME/vibe_package_manager/issues) 确认建议尚未被提出
+2. 创建新的 Issue，使用功能建议模板
+3. 提供详细信息：
+   - 功能描述
+   - 使用场景
+   - 预期效果
+   - 可能的实现方案
+
+### 提交代码
+
+#### 开发环境设置
+
+```bash
+# 1. Fork 并克隆仓库
+git clone https://github.com/YOUR_USERNAME/vibe_package_manager.git
+cd vibe_package_manager
+
+# 2. 创建虚拟环境
+python -m venv venv
+
+# Windows
+venv\Scripts\activate
+
+# Linux/Mac
+source venv/bin/activate
+
+# 3. 安装依赖
+pip install -r requirements.txt
+pip install pytest pytest-cov black flake8 mypy
+
+# 4. 运行测试
+pytest
+
+# 5. 代码格式化
+black src/ main.py
+
+# 6. 代码检查
+flake8 src/ main.py
+
+# 7. 类型检查
+mypy src/
+```
+
+#### 开发流程
+
+1. **创建功能分支**
+   ```bash
+   git checkout -b feature/your-feature-name
+   # 或
+   git checkout -b fix/your-bug-fix
+   ```
+
+2. **进行更改**
+   - 遵循现有代码风格
+   - 添加必要的测试
+   - 更新相关文档
+
+3. **提交更改**
+   ```bash
+   git add .
+   git commit -m "feat: add new feature"
+   ```
+
+   提交信息遵循 [约定式提交](https://www.conventionalcommits.org/) 规范：
+   - `feat:` 新功能
+   - `fix:` Bug 修复
+   - `docs:` 文档更新
+   - `style:` 代码格式调整
+   - `refactor:` 代码重构
+   - `test:` 测试相关
+   - `chore:` 构建/工具链相关
+
+4. **推送到你的 Fork**
+   ```bash
+   git push origin feature/your-feature-name
+   ```
+
+5. **创建 Pull Request**
+   - 在 GitHub 上创建 PR
+   - 填写 PR 模板
+   - 等待代码审查
+
+#### 代码规范
+
+- **Python 代码风格**：遵循 [PEP 8](https://www.python.org/dev/peps/pep-0008/)
+- **类型提示**：为公共函数添加类型提示
+- **文档字符串**：为公共函数编写文档字符串（遵循 Google 风格）
+- **测试覆盖率**：确保新功能有相应的测试
+- **提交信息**：使用约定式提交格式
+
+#### 代码审查
+
+所有 Pull Request 都需要经过代码审查。审查者会检查：
+
+- 代码质量和风格
+- 测试覆盖率
+- 文档完整性
+- 向后兼容性
+- 安全性问题
+
+请保持耐心，积极响应审查意见。
+
+### 改进文档
+
+文档改进也是重要的贡献！您可以：
+
+- 修正错误或不清晰的内容
+- 添加使用示例
+- 翻译文档到其他语言
+- 改进文档结构
+
+## 行为准则
+
+### 我们的承诺
+
+为了营造一个开放和友好的环境，我们承诺：
+
+- **尊重**：尊重不同的观点和经验
+- **包容**：欢迎并包容所有参与者
+- **友善**：以友善和建设性的方式交流
+- **协作**：优先考虑社区的最佳利益
+
+### 不被接受的行为
+
+- 使用性化的语言或图像
+- 人身攻击或侮辱性评论
+- 公开或私下的骚扰
+- 未经许可发布他人的私人信息
+- 其他不专业或不恰当的行为
+
+### 报告不当行为
+
+如果遇到不当行为，请通过以下方式联系维护者：
+- 提交 Issue
+- 发送邮件至项目维护者
+
+## 开发指南
+
+### 项目结构
+
+```
+vibe_package_manager/
+├── main.py                      # 主程序入口
+├── src/                         # 源代码
+│   ├── config_parser.py         # 配置解析
+│   ├── version_utils.py         # 版本工具
+│   ├── skill_sync.py            # SKILL 同步
+│   ├── subagent_sync.py         # SubAgent 同步
+│   └── mcp_installer.py         # MCP 安装
+├── tests/                       # 测试文件
+├── examples/                    # 示例文件
+└── docs/                        # 文档
+```
+
+### 添加新功能
+
+1. 在 `src/` 中添加新模块
+2. 编写相应的测试（在 `tests/` 中）
+3. 更新文档
+4. 提交 Pull Request
+
+### 修复 Bug
+
+1. 找到 Bug 的位置
+2. 编写测试用例复现 Bug
+3. 修复 Bug
+4. 确保所有测试通过
+5. 更新相关文档
+6. 提交 Pull Request
+
+## 发布流程
+
+### 版本号规范
+
+遵循 [语义化版本 2.0.0](https://semver.org/lang/zh-CN/)：
+
+- **主版本号**：不兼容的 API 修改
+- **次版本号**：向下兼容的功能性新增
+- **修订号**：向下兼容的问题修正
+
+### 发布步骤
+
+1. 更新版本号（在 `src/__init__.py` 中）
+2. 更新 CHANGELOG.md
+3. 创建 Git 标签
+4. 创建 GitHub Release
+5. 发布到 PyPI（如适用）
+
+## 获取帮助
+
+如果您在贡献过程中遇到问题：
+
+- 查看 [README.md](README.md)
+- 查看 [QUICKSTART.md](QUICKSTART.md)
+- 提交 Issue
+- 参与 [Discussions](https://github.com/YOUR_USERNAME/vibe_package_manager/discussions)
+
+## 致谢
+
+感谢所有为本项目做出贡献的开发者！
+
+您的贡献让 Vibe Package Manager 变得更好！

vibe_package_manager-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vibe Package Manager Team
+
+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.

vibe_package_manager-1.0.0/MANIFEST.in

@@ -0,0 +1,24 @@
+include README.md
+include LICENSE
+include CHANGELOG.md
+include CONTRIBUTING.md
+include CODE_OF_CONDUCT.md
+include SECURITY.md
+include QUICKSTART.md
+include requirements.txt
+include pyproject.toml
+include vibe_package.schema.json
+include vibe_package.example.json
+
+recursive-include examples *.md
+recursive-include src *.py
+recursive-include tests *.py
+
+exclude .gitignore
+exclude .github/*
+recursive-exclude .github *
+exclude __pycache__
+exclude *.pyc
+exclude *.pyo
+exclude .DS_Store
+exclude Thumbs.db