ipman-cli 0.1.88__tar.gz → 0.2.12__tar.gz

ipman_cli-0.2.12/.claude/archive/sprint-10.md

@@ -0,0 +1,25 @@
+# 当前 Sprint
+
+## Sprint 10（Phase 5 — IpHub Awesome-List 转型, Sub-1）
+
+**状态：** ✅ 全部完成
+
+### Chunk 1: ipman CLI 数据模型改动 ✅
+- IPPackage 6 个新字段 + parse/dump ✅
+- Publisher tags/summary/changelog ✅
+- Client --tag search ✅
+- CLI hub search/top --tag, info 新字段 ✅
+
+### Chunk 2: iphub 仓库模板 + 脚本 + 工作流 ✅
+- i18n 翻译文件 (en + zh-cn) ✅
+- README.md + HTML Landing Page 模板 ✅
+- generate_pages.py + generate_trending.py ✅
+- sync_tag_labels.py ✅
+- rebuild-index.yml 更新（tag 聚合 + trending） ✅
+- rebuild-pages.yml 新建 ✅
+- validate-pr.yml tag 校验 ✅
+
+### Chunk 3: 集成验证 + 人工事项 ✅
+- [x] GitHub Pages 启用（/docs 目录）
+- [x] 触发 rebuild-pages workflow
+- [x] 触发 rebuild-index workflow

ipman_cli-0.2.12/.claude/archive/sprint-11.md

@@ -0,0 +1,13 @@
+# Sprint 11（Phase 5 — Sub-2: Tag 搜索 + 排名 + 趋势推荐）— 已完成
+
+**状态：** ✅ 全部完成
+
+### 交付清单
+
+| 任务 | 仓库 | 状态 |
+|------|------|------|
+| `ipman hub trending` CLI 命令 | ipman | ✅ 340 tests |
+| IpHub 首页模板 (index-page.html.j2) | iphub | ✅ |
+| Tag 浏览页模板 (tag-page.html.j2) | iphub | ✅ |
+| i18n 新增 11 个 key (en + zh-cn) | iphub | ✅ |
+| generate_pages.py 首页 + tag 页生成 | iphub | ✅ |

ipman_cli-0.2.12/.claude/archive/sprint-12.md

@@ -0,0 +1,12 @@
+# Sprint 12（Phase 5 — Sub-3: 个人页面 + IP Landing Page 完善）— 已完成
+
+**状态：** ✅ 全部完成
+
+### 交付清单
+
+| 任务 | 仓库 | 状态 |
+|------|------|------|
+| Author 个人页面模板 (author-page.html.j2) | iphub | ✅ |
+| generate_pages.py 生成个人页面 | iphub | ✅ |
+| 首页新增 "Active Authors" 区域 | iphub | ✅ |
+| i18n 新增 7 key (en + zh-cn) | iphub | ✅ |

ipman_cli-0.2.12/.claude/archive/sprint-13.md

@@ -0,0 +1,15 @@
+# Sprint 13（Phase 5 — Sub-4: 社交媒体机器人 + 自动 IP 生成）— 已完成
+
+**状态：** ✅ 核心功能完成（Batch 2/3 暂缓）
+
+> 代码在私有仓库 `twisker/iphub-bot`
+
+### 交付清单
+
+| Batch | 内容 | 状态 |
+|-------|------|------|
+| Batch 1 | Cloudflare Worker 骨架 + AI 分析管道 + GitHub PR 提交 + 去重 + 限速 | ✅ 已部署 |
+| Batch 4 | GitHub Trending 轮询 | ✅ 已部署 |
+| Batch 5 | HN + Reddit + ProductHunt + Dev.to 轮询 | ✅ 已完成 |
+| Batch 2 | X (Twitter) webhook | 暂缓 |
+| Batch 3 | 微博 webhook | 暂缓 |

ipman_cli-0.2.12/.claude/archive/sprint-7.md

@@ -0,0 +1,30 @@
+# 当前 Sprint
+
+## Sprint 7（Phase 4 — 用户体验改进 + 持续质量保障）— 已完成
+
+**目标：** 简化虚拟环境操作体验，扩展 install 命令支持本地 skill
+
+**状态：** ✅ 全部完成
+
+### A 组：activate/deactivate 脚本改进 ✅
+
+| 任务 | 状态 |
+|------|------|
+| `ipman init` 命令（bash/zsh/fish/powershell） | ✅ |
+| Shell function wrapper 注入/移除/备份 | ✅ |
+| `--reverse` 撤销 + `--dry-run` 预览 | ✅ |
+| env.py activate/deactivate 消息更新 | ✅ |
+
+### B 组：install 本地 skill 支持 ✅
+
+| 任务 | 状态 |
+|------|------|
+| `_classify_source()` 三分类（ip_file / local_skill / hub_name） | ✅ |
+| `ClaudeCodeAdapter` 本地目录 → copytree | ✅ |
+| `OpenClawAdapter` 本地目录 → copytree | ✅ |
+| E2E 3 个 skip 测试已解锁 | ✅ |
+
+### 测试统计
+
+- 单元测试：321 passed
+- E2E 测试：320 collected（含解锁的 3 个 skill install 测试）

ipman_cli-0.2.12/.claude/current-sprint.md

@@ -0,0 +1,13 @@
+# 当前 Sprint
+
+（Phase 5 IpHub Awesome-List 转型已完成。Sprint 14 暂缓——自动化已基本就位。无活跃 Sprint。）
+
+## 项目整体进度
+
+| Phase | 内容 | 状态 |
+|-------|------|------|
+| Phase 1 | 核心功能（虚拟环境 + 技能管理） | ✅ |
+| Phase 2 | IpHub + 安全审查 + 依赖解析 | ✅ |
+| Phase 3 | 国际化 + 多渠道分发 | ✅ |
+| Phase 4 | 用户体验改进（ipman init + local skill install + E2E 测试） | ✅ |
+| Phase 5 | IpHub Awesome-List 转型（格式增强 + 趋势 + 页面 + 机器人） | ✅ |

ipman_cli-0.2.12/.claude/settings.local.json

@@ -0,0 +1,16 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(git config:*)",
+      "Bash(ls:*)",
+      "Bash(xargs wc:*)",
+      "Bash(find /d/repos/ipman/src/ipman -type f -name \"*.py\" -exec wc -l {} +)",
+      "Bash(find /d/repos/ipman -name *.clawhub -o -name .clawhub -o -name lock.json)",
+      "Bash(xargs grep:*)",
+      "Bash(find /d/repos/ipman/docs/reports -name *.md -type f)",
+      "Bash(rtk uv:*)",
+      "Bash(rtk git:*)",
+      "Bash(python -c \"import os; os.environ[''MOCK_CLAWHUB_STATE'']=''/tmp/test''; os.environ[''PATH'']=''C:/test;''+os.environ[''PATH'']; import subprocess; r=subprocess.run\\([''which'', ''clawhub''], capture_output=True, text=True\\); print\\(r.stdout, r.stderr\\)\")"
+    ]
+  }
+}

{ipman_cli-0.1.88 → ipman_cli-0.2.12}/.claude/sprint-plan.md

@@ -173,3 +173,94 @@
 | P1 | iphub 定时统计 + README Top 排名 Action | CI/CD | AI | 已完成 |
 | P1 | 多平台 PyInstaller 打包（Linux/macOS/Windows） | CI/CD | AI | 已完成 |
 | P2 | GitHub Actions 发布时自动构建 + GitHub Release 上传 | CI/CD | AI | 已完成 |
+
+---
+
+## Phase 4 -- 用户体验改进 + 持续质量保障
+
+### Sprint 7（activate/deactivate 脚本 + install 增强 + E2E 完善）
+
+**目标：** 简化虚拟环境操作体验，扩展 install 命令，完善 E2E 测试覆盖
+
+| 优先级 | 任务 | 所属模块 | 责任人 | 状态 |
+|-------|------|----------|--------|------|
+| P0 | 为各平台提供 activate/deactivate 脚本（参考 conda）：`ipman init` 命令注入 shell function wrapper，支持 bash/zsh/fish/powershell | core/shell_init + CLI | AI | 已完成 |
+| P0 | 扩展 `ipman install` 支持本地 skill 目录（`_classify_source()` 三分类，两个 adapter 用 `shutil.copytree`） | cli/skill + agents | AI | 已完成 |
+| P0 | 解锁 3 个 E2E Layer 2 测试（本地 skill install/uninstall/persistence） | tests/e2e/test_skill_install | AI | 已完成 |
+| P1 | Shell 集成：`ipman init` 注入后 activate/deactivate 直接生效，含 `--reverse` 撤销 + `--dry-run` 预览 | core/shell_init + CLI | AI | 已完成 |
+| P1 | Windows PowerShell 兼容：`Invoke-Expression` + 正确 splatting，替代不可用的 eval | core/shell_init | AI | 已完成 |
+| P1 | `ClaudeCodeAdapter`：本地路径 → `copytree` 到 `.claude/skills/`，远程名称 → `claude plugin install` | agents/claude_code | AI | 已完成 |
+| P1 | `OpenClawAdapter`：本地路径 → `copytree` 到 `.openclaw/skills/`，远程名称 → `clawhub install` | agents/openclaw | AI | 已完成 |
+| P2 | E2E 测试框架持续改进：根据运行结果修复测试用例 | tests/e2e | AI | 已完成 |
+
+---
+
+## Phase 5 -- IpHub Awesome-List 转型
+
+> **总体目标：** 将 IpHub 从扁平注册表升级为 awesome-list 式的策展与传播平台
+> **设计文档：** `docs/superpowers/specs/2026-03-16-iphub-ip-format-enhancement-design.md`
+> **实施计划：** `docs/superpowers/plans/2026-03-16-iphub-ip-format-enhancement.md`
+
+### Sprint 10（Sub-1: IP 格式增强 + 版本迭代 + Tag + 页面生成）
+
+**目标：** 扩展 IP 数据模型，建立三层架构（yaml → md → html），支持 tag 搜索、趋势统计、i18n Landing Page
+
+| 优先级 | 任务 | 所属模块 | 责任人 | 状态 |
+|-------|------|----------|--------|------|
+| P0 | IPPackage 扩展：新增 tags/summary/homepage/repository/icon/links 字段 | core/package | AI | 已完成 |
+| P0 | Publisher 适配：registry 输出新字段 + 版本文件含 changelog | hub/publisher | AI | 已完成 |
+| P0 | Client 适配：search() 支持 --tag 过滤 | hub/client | AI | 已完成 |
+| P0 | CLI 适配：hub search --tag, hub info 展示新字段 | cli/hub | AI | 已完成 |
+| P1 | i18n 翻译文件（en + zh-cn）| iphub/templates | AI | 已完成 |
+| P1 | README.md 生成模板（含新手引导）| iphub/templates | AI | 已完成 |
+| P1 | HTML Landing Page 模板（i18n + 响应式）| iphub/templates | AI | 已完成 |
+| P1 | 页面生成脚本 generate_pages.py | iphub/scripts | AI | 已完成 |
+| P1 | 趋势计算脚本 generate_trending.py | iphub/scripts | AI | 已完成 |
+| P2 | rebuild-index.yml：tag 聚合 + 趋势 + Labels 同步 | iphub/CI | AI | 已完成 |
+| P2 | rebuild-pages.yml：自动生成页面工作流 | iphub/CI | AI | 已完成 |
+| P2 | validate-pr.yml：tag 格式校验 | iphub/CI | AI | 已完成 |
+| P2 | GitHub Pages 启用（人工） | iphub 仓库设置 | 人工 | 已完成 |
+
+### Sprint 11（Sub-2: Tag 搜索 + 排名 + 趋势推荐） — 已完成
+
+| 任务 | 仓库 | 状态 |
+|------|------|------|
+| `ipman hub trending` CLI 命令 | ipman | 已完成 |
+| IpHub 首页模板 + trending 展示 | iphub | 已完成 |
+| Tag 浏览页模板 | iphub | 已完成 |
+| i18n 新增 11 key + generate_pages 首页/tag 生成 | iphub | 已完成 |
+
+### Sprint 12（Sub-3: 个人页面 + IP Landing Page 完善） — 已完成
+
+| 任务 | 仓库 | 状态 |
+|------|------|------|
+| Author 个人页面模板 + generate_pages 生成 | iphub | 已完成 |
+| 首页 "Active Authors" 区域 | iphub | 已完成 |
+| i18n 新增 7 key | iphub | 已完成 |
+
+### Sprint 13（Sub-4: 社交媒体机器人 + 自动 IP 生成）— 已完成
+
+> 代码和设计文档在私有仓库 `twisker/iphub-bot` 中。
+
+| Batch | 内容 | 状态 |
+|-------|------|------|
+| Batch 1+4 | 核心管道 + GitHub Trending 轮询 | 已完成 ✅ 已部署 |
+| Batch 5 | HN/Reddit/ProductHunt/Dev.to 轮询 | 已完成 |
+| Batch 2 | X webhook | 暂缓（需 X API $100/月） |
+| Batch 3 | 微博 webhook | 暂缓（需开发者认证） |
+
+### Sprint 14（Sub-5: 自动化编排层）— 暂缓
+
+> 自动化已基本就位（CI/CD workflows + Cloudflare Worker crons）。如需补充监控告警或健康检查，后续按需启动。
+
+---
+
+## Phase 5 完成总结
+
+| Sub | Sprint | 内容 | 状态 |
+|-----|--------|------|------|
+| Sub-1 | Sprint 10 | IP 格式增强 + tags + changelog + 页面生成 | ✅ |
+| Sub-2 | Sprint 11 | Tag 搜索 + 趋势推荐 + hub trending 命令 | ✅ |
+| Sub-3 | Sprint 12 | 个人页面 + IP Landing Page | ✅ |
+| Sub-4 | Sprint 13 | 社交媒体机器人 + 5 数据源自动 IP 生成 | ✅ |
+| Sub-5 | Sprint 14 | 自动化编排层 | 暂缓（已基本就位） |

ipman_cli-0.1.88/.github/workflows/e2e.yml → ipman_cli-0.2.12/.github/workflows/e2e-docker-legacy.yml

@@ -1,19 +1,15 @@
-# E2E tests — nightly + manual + pre-release
+# LEGACY: Docker-based E2E tests — replaced by e2e-fast.yml + e2e-full.yml
 # Runs real ipman against Docker containers with Claude Code / OpenClaw
 
-name: E2E Tests
+name: E2E Tests (Legacy)
 
 on:
-  schedule:
-    - cron: "0 4 * * *"  # Daily at 04:00 UTC
   workflow_dispatch:
     inputs:
       agent:
         description: "Agent to test (claude-code, openclaw, all)"
         required: false
         default: "all"
-  push:
-    tags: ["v*"]  # Also run before releases
 
 jobs:
   e2e:
@@ -27,9 +23,9 @@ jobs:
       - uses: actions/checkout@v4
 
       - name: Build test container
-        working-directory: tests/e2e
+        working-directory: tests/e2e-legacy
         run: docker compose build ${{ matrix.agent }}
 
       - name: Run E2E tests
-        working-directory: tests/e2e
+        working-directory: tests/e2e-legacy
         run: docker compose run --rm ${{ matrix.agent }}

ipman_cli-0.2.12/.github/workflows/e2e-fast.yml

@@ -0,0 +1,43 @@
+name: E2E Fast
+
+on:
+  push:
+    branches: [main, dev, "release/*"]
+  pull_request:
+    branches: [main, dev]
+
+jobs:
+  e2e-platform:
+    name: E2E Platform (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --group dev --group e2e
+
+      - name: Run E2E platform tests (Layer 1)
+        run: >
+          uv run pytest tests/e2e/
+          -m "platform"
+          --junit-xml=e2e-fast-results.xml
+          --timeout=60
+          -v
+
+      - name: Upload test results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: e2e-fast-${{ matrix.os }}
+          path: e2e-fast-results.xml

ipman_cli-0.2.12/.github/workflows/e2e-full.yml

@@ -0,0 +1,102 @@
+name: E2E Full
+
+on:
+  schedule:
+    - cron: "0 4 * * *"
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+    inputs:
+      layers:
+        description: "Marker expression (e.g. 'agent_session', 'publish')"
+        required: false
+        default: "e2e"
+
+jobs:
+  e2e-agents:
+    name: E2E (${{ matrix.os }}, ${{ matrix.agent }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        agent: [claude-code, openclaw]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --group dev --group e2e
+
+      - name: Install agent CLI
+        run: >
+          npm install -g ${{
+            matrix.agent == 'claude-code'
+            && '@anthropic-ai/claude-code'
+            || 'openclaw'
+          }}
+
+      - name: Run E2E tests
+        env:
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+        run: >
+          uv run pytest tests/e2e/
+          -m "platform or agent_cli or agent_session"
+          --agent ${{ matrix.agent }}
+          --junit-xml=e2e-full-results.xml
+          --timeout=300
+          --reruns 1 --reruns-delay 5
+          -v
+
+      - name: Upload test results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: e2e-full-${{ matrix.os }}-${{ matrix.agent }}
+          path: e2e-full-results.xml
+
+  e2e-publish-security:
+    name: Publish Security
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --group dev --group e2e
+
+      - name: Run publish security tests
+        env:
+          GH_TOKEN_OWNER: ${{ secrets.GH_TOKEN_OWNER }}
+          GH_TOKEN_USER_A: ${{ secrets.GH_TOKEN_USER_A }}
+          GH_TOKEN_USER_B: ${{ secrets.GH_TOKEN_USER_B }}
+          IPHUB_TEST_REPO: ${{ vars.IPHUB_TEST_REPO }}
+        run: >
+          uv run pytest tests/e2e/test_publish_workflow.py
+          -m "publish"
+          --junit-xml=publish-results.xml
+          --timeout=300
+          --reruns 2 --reruns-delay 10
+          -v
+
+      - name: Upload test results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: e2e-publish-security
+          path: publish-results.xml

{ipman_cli-0.1.88 → ipman_cli-0.2.12}/CLAUDE.md

@@ -30,6 +30,16 @@
 
 ## CLAUDE CODING 规范（必须遵守）
 
+### Git Hooks 初始化（每次新会话必检）
+
+**每次会话开始时，必须检查 `git config core.hooksPath` 是否为 `.githooks`。如果未设置，立即执行：**
+
+```bash
+git config core.hooksPath .githooks
+```
+
+这确保 `.githooks/pre-commit`（自动版本 bump）能正常工作。此配置是本地的，不跟随 git clone，因此每次换机器或 clone 新仓库后都需要重新设置。
+
 ### Git 提交纪律（最高优先级）
 
 **每次完成一组有意义的改动后，必须立即执行 `git add` + `git commit`，不得拖延、不得遗忘、不得等用户提醒。**

{ipman_cli-0.1.88 → ipman_cli-0.2.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ipman-cli
-Version: 0.1.88
+Version: 0.2.12
 Summary: Intelligence Package Manager - Agent skill virtual environment manager
 Project-URL: Homepage, https://github.com/twisker/ipman
 Project-URL: Repository, https://github.com/twisker/ipman
@@ -132,10 +132,21 @@ See the **[Security Guide](https://twisker.github.io/ipman/guide/security/)** fo
 ## IpHub Rankings
 
 <!-- TOP_SKILLS_START -->
-*Rankings will appear here once IpHub has install data.*
+## Top 10 Skills
+
+*Updated: 2026-03-23T04:30:04Z*
+
+| # | Name | Type | Installs | Users |
+|---|------|------|----------|-------|
 <!-- TOP_SKILLS_END -->
 
 <!-- TOP_PACKAGES_START -->
+## Top 10 Packages
+
+*Updated: 2026-03-23T04:30:04Z*
+
+| # | Name | Type | Installs | Users |
+|---|------|------|----------|-------|
 <!-- TOP_PACKAGES_END -->
 
 ## Star History

{ipman_cli-0.1.88 → ipman_cli-0.2.12}/README.md

@@ -102,10 +102,21 @@ See the **[Security Guide](https://twisker.github.io/ipman/guide/security/)** fo
 ## IpHub Rankings
 
 <!-- TOP_SKILLS_START -->
-*Rankings will appear here once IpHub has install data.*
+## Top 10 Skills
+
+*Updated: 2026-03-23T04:30:04Z*
+
+| # | Name | Type | Installs | Users |
+|---|------|------|----------|-------|
 <!-- TOP_SKILLS_END -->
 
 <!-- TOP_PACKAGES_START -->
+## Top 10 Packages
+
+*Updated: 2026-03-23T04:30:04Z*
+
+| # | Name | Type | Installs | Users |
+|---|------|------|----------|-------|
 <!-- TOP_PACKAGES_END -->
 
 ## Star History

ipman_cli-0.2.12/VERSION

@@ -0,0 +1 @@
+0.2.12