pm-server 0.3.0__tar.gz

pm_server-0.3.0/.gitignore

@@ -0,0 +1,41 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+*.egg
+
+# Virtual env
+.venv/
+venv/
+env/
+
+# Environment variables
+.env
+.env.local
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Ruff
+.ruff_cache/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Claude Code (local dev config)
+.claude/
+
+# PM Server data (local project management)
+.pm/

pm_server-0.3.0/CHANGELOG.md

@@ -0,0 +1,57 @@
+# Changelog
+
+## [0.3.0] - 2026-04-08
+
+### Added
+- CLAUDE.md auto-management: `pm_init` automatically adds PM Server rules with version markers
+- `pm_update_claudemd` MCP tool (16th tool) for updating PM Server rules section
+- `pm-server update-claudemd` CLI command with `--all` flag for batch updates
+- `claudemd.py` module with marker-based section management
+
+### Fixed
+- storage.py YAML header showing "PM Agent" instead of "PM Server"
+- dashboard_portfolio.html title showing old name
+- pm_discover MCP tool default scan path changed from "~" to "." (security)
+- uninstall_mcp() missing --scope user flag
+- migrate_from_pm_agent() now uses shutil.which() and timeout
+- Case-insensitive detection of "PM Agent" references in migrate command
+- `PmAgentError` renamed to `PmServerError`
+
+### Changed
+- Removed internal development prompts from docs/
+- Added `.claude/` and `.pm/` to .gitignore
+- pyproject.toml: added classifiers and dev extras
+- MCP tool count: 15 → 16
+
+## [0.2.0] - 2026-04-08
+
+### Changed
+- Package renamed from `pm-agent` to `pm-server` (PyPI name conflict with existing `PMAgent`)
+- GitHub repository moved to `flc-design/pm-server`
+- Added `pm-server migrate` command for transitioning from pm-agent
+
+### Added
+- `README.ja.md` — Japanese README
+- `migrate` CLI command for pm-agent → pm-server transition
+
+## [0.1.0] - 2026-04-07
+
+### Added
+- 15 MCP tools for project management
+- YAML-based task, decision, and log storage
+- HTML dashboard with Chart.js (single + portfolio view)
+- Text dashboard fallback
+- Velocity tracking and risk detection
+- Project discovery and auto-registration
+- CLI interface (install, uninstall, serve, discover, status)
+- Claude Code integration via `claude mcp add --scope user`
+
+### Fixed
+- installer.py: use `claude mcp add` instead of writing to wrong settings file
+- Template path resolution for packaged installations
+- Test isolation: prevent tests from polluting `~/.pm/registry.yaml`
+
+### Documentation
+- Development workflow guide (docs/workflow.md)
+- Design document (docs/design.md)
+- Project status report (docs/status.md)

pm_server-0.3.0/CLAUDE.md

@@ -0,0 +1,104 @@
+# PM Server — Claude Code Project Management System
+
+## プロジェクト概要
+
+Claude Code 用のプロジェクト管理 MCP Server。
+タスク追跡・進捗可視化・ブロッカー検知・ADR記録・全プロジェクト横断ダッシュボードを提供する。
+
+- **言語**: Python 3.11+
+- **フレームワーク**: FastMCP, Pydantic v2, Click, Jinja2
+- **データ形式**: YAML（human-readable, git-friendly）
+- **配布**: PyPI (`pm-server`)
+- **ライセンス**: MIT
+
+## 設計書
+
+実装の前に必ず `docs/design.md` を読むこと。
+これがすべてのアーキテクチャ判断の根拠となる。
+
+## ディレクトリ構成
+
+```
+pm-server/
+├── pyproject.toml
+├── README.md
+├── LICENSE
+├── src/
+│   └── pm_server/
+│       ├── __init__.py
+│       ├── __main__.py       # CLI (click)
+│       ├── server.py          # FastMCP サーバー (16 tools)
+│       ├── models.py          # Pydantic データモデル (12 models, 9 enums)
+│       ├── storage.py         # YAML 読み書き
+│       ├── installer.py       # Claude Code MCP 自動登録
+│       ├── discovery.py       # プロジェクト自動検出・情報推定
+│       ├── dashboard.py       # HTML/テキスト ダッシュボード生成
+│       ├── velocity.py        # ベロシティ・分析・リスク検知
+│       ├── utils.py           # パス解決、ID生成、集計ヘルパー
+│       └── templates/         # Jinja2 HTML テンプレート
+│           ├── dashboard_single.html
+│           └── dashboard_portfolio.html
+├── skill/
+│   └── SKILL.md               # Claude Code 用スキル定義
+├── tests/
+│   ├── conftest.py
+│   ├── test_models.py
+│   ├── test_storage.py
+│   ├── test_server.py
+│   ├── test_installer.py
+│   ├── test_discovery.py
+│   ├── test_dashboard.py
+│   └── test_velocity.py
+└── docs/
+    ├── design.md
+    └── implementation-prompt.md
+```
+
+## コーディング規約
+
+### Python スタイル
+- Python 3.11+ の機能を積極利用（`str | None`, `match-case` 等）
+- 型ヒントを全関数に記述
+- docstring は Google style
+- フォーマッター: ruff
+- リンター: ruff
+- テスト: pytest
+
+### 命名規則
+- モジュール: snake_case
+- クラス: PascalCase
+- 関数/変数: snake_case
+- 定数: UPPER_SNAKE_CASE
+- MCP ツール名: `pm_` プレフィクス（例: `pm_status`, `pm_add_task`）
+
+### エラーハンドリング
+- カスタム例外クラス: `PmServerError`, `ProjectNotFoundError`, `TaskNotFoundError`, `DecisionNotFoundError`
+- MCP ツールはエラー時に明確なメッセージを返す
+- YAML パースエラーは `PmServerError` にラップして伝播
+
+### YAML 規約
+- `pyyaml` の `safe_load` / `safe_dump` のみ使用
+- 出力は `default_flow_style=False`, `allow_unicode=True`, `sort_keys=False`
+- ファイル先頭にコメントヘッダーを付与
+
+### テスト規約
+- 各モジュールに対応する test ファイルを作成
+- `tmp_path` fixture で一時ディレクトリを使用
+- 正常系・異常系・エッジケースを網羅
+- テストデータは conftest.py に fixture として定義
+
+## セキュリティ上の注意
+
+- YAML は `safe_load` のみ（任意コード実行を防止）
+- installer.py は既存の settings.json の他のキーを絶対に壊さない
+- ファイルパスは `resolve()` で正規化（パストラバーサル防止）
+- subprocess に `shell=True` を使用しない
+- Jinja2 テンプレートは `autoescape` 有効
+
+## よくある間違い
+
+- ❌ `yaml.load()` を使う → ✅ `yaml.safe_load()` を使う
+- ❌ `Path("~/.pm")` → ✅ `Path.home() / ".pm"` or `Path("~/.pm").expanduser()`
+- ❌ settings.json を丸ごと上書き → ✅ 必要なキーのみ追加
+- ❌ project_path を必須引数にする → ✅ オプションにして自動検出
+- ❌ タスクIDをユーザーに手入力させる → ✅ 自動採番

pm_server-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shinichi Nakazato / FLC design co., ltd.
+
+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.

pm_server-0.3.0/PKG-INFO

@@ -0,0 +1,307 @@
+Metadata-Version: 2.4
+Name: pm-server
+Version: 0.3.0
+Summary: Project management MCP Server for Claude Code — track tasks, visualize progress, manage decisions
+Project-URL: Homepage, https://github.com/flc-design/pm-server
+Project-URL: Repository, https://github.com/flc-design/pm-server
+Project-URL: Issues, https://github.com/flc-design/pm-server/issues
+Author: Shinichi Nakazato
+License-Expression: MIT
+License-File: LICENSE
+Keywords: claude-code,mcp,mcp-server,project-management
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Requires-Dist: click>=8.0
+Requires-Dist: fastmcp>=2.0
+Requires-Dist: jinja2>=3.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# pm-server
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/)
+
+**[日本語版 README はこちら](README.ja.md)**
+
+**Project management MCP Server for Claude Code.**
+
+Track tasks, visualize progress, record decisions — all through natural language in your Claude Code session.
+
+```
+> 進捗は？
+✓ Phase 1 "Backend API": 60% complete (12/20 tasks)
+  - 3 tasks in progress, 1 blocked
+  - Velocity: 8 tasks/week (↑ trending up)
+
+> 次にやること
+1. [P0] MYAPP-014: Add user authentication endpoint
+2. [P1] MYAPP-015: Implement rate limiting
+3. [P1] MYAPP-018: Write integration tests
+
+> MYAPP-014 に着手
+✓ MYAPP-014 → in_progress
+```
+
+---
+
+## Features
+
+- **16 MCP tools** — task CRUD, status, blockers, velocity, dashboard, ADR, and more
+- **Natural language** — say "進捗は？" or "what's next?" instead of memorizing commands
+- **Zero configuration** — `pip install` + `pm-server install`, then just say "PM初期化して"
+- **Multi-project** — manage all your projects from a global registry with cross-project dashboards
+- **Git-friendly** — plain YAML files in `.pm/` directory, trackable with `git diff`
+- **Non-invasive** — adds only a `.pm/` directory to your project. `rm -rf .pm/` to remove completely
+
+---
+
+## Quick Start
+
+### Install (once)
+
+```bash
+pip install git+https://github.com/flc-design/pm-server.git
+pm-server install       # Registers MCP server in Claude Code
+# Restart Claude Code
+```
+
+### Initialize a project
+
+```
+# In Claude Code, cd to your project directory
+> PM初期化して
+✓ .pm/ created
+✓ Registered in global registry
+✓ Detected: name=my-app, version=1.2.0 (from package.json)
+```
+
+pm-server automatically detects project info from `package.json`, `pyproject.toml`, `Cargo.toml`, `.git/config`, and `README.md`.
+
+### Use it
+
+| You say | What happens |
+|---|---|
+| `進捗は？` / `status` | Show project progress summary |
+| `次にやること` / `what's next` | Recommend next tasks by priority & dependencies |
+| `タスク追加：○○を実装` | Add a new task (auto-numbered) |
+| `MYAPP-003 完了` | Mark task as done |
+| `ブロッカーある？` | List blocked tasks |
+| `ダッシュボード見せて` | Generate HTML dashboard (Chart.js, dark theme) |
+| `この設計にした理由を記録` | Record an Architecture Decision Record (ADR) |
+| `全プロジェクトの状態` | Cross-project portfolio view |
+
+---
+
+## MCP Tools (16 tools)
+
+### Project Management
+
+| Tool | Description |
+|---|---|
+| `pm_init` | Create `.pm/`, register in global registry, auto-detect project info |
+| `pm_status` | Phase progress, task summary, blockers, velocity |
+| `pm_tasks` | List tasks with filters (status / phase / priority / tag) |
+| `pm_add_task` | Add task with auto-numbered ID (e.g., `MYAPP-001`) |
+| `pm_update_task` | Update status, priority, notes, blocked_by |
+| `pm_next` | Recommend next tasks (excludes blocked / unmet dependencies) |
+| `pm_blockers` | List blocked tasks across projects |
+
+### Records
+
+| Tool | Description |
+|---|---|
+| `pm_log` | Daily log entry (progress / decision / blocker / note / milestone) |
+| `pm_add_decision` | Add ADR with context, decision, and consequences |
+
+### Analysis
+
+| Tool | Description |
+|---|---|
+| `pm_velocity` | Weekly velocity + trend (up / down / flat) |
+| `pm_risks` | Auto-detect risks: overdue, stale, long-blocked tasks |
+
+### Visualization
+
+| Tool | Description |
+|---|---|
+| `pm_dashboard` | HTML dashboard (single project or portfolio view) |
+
+### Discovery
+
+| Tool | Description |
+|---|---|
+| `pm_discover` | Scan directories for `.pm/` projects and auto-register |
+| `pm_cleanup` | Remove invalid paths from registry |
+| `pm_list` | List all registered projects |
+
+### Maintenance
+
+| Tool | Description |
+|---|---|
+| `pm_update_claudemd` | Update PM Server rules section in CLAUDE.md to latest version |
+
+---
+
+## Data Structure
+
+pm-server stores everything as plain YAML in a `.pm/` directory at your project root:
+
+```
+your-project/
+└── .pm/
+    ├── project.yaml        # Project metadata
+    ├── tasks.yaml          # Tasks with status, priority, dependencies
+    ├── decisions.yaml      # Architecture Decision Records (ADR)
+    ├── milestones.yaml     # Milestone definitions
+    ├── risks.yaml          # Risks and blockers
+    └── daily/
+        └── 2026-04-08.yaml # Auto-generated daily log
+```
+
+Global registry at `~/.pm/registry.yaml` indexes all projects.
+
+All files are human-readable and hand-editable. If something goes wrong, you can fix it with a text editor.
+
+---
+
+## CLAUDE.md Integration
+
+Add this to your project's `CLAUDE.md` for automatic PM behavior:
+
+```markdown
+## PM Server — Auto-actions (always follow these)
+
+### On session start (before first response)
+1. Run pm_status to show current progress
+2. Run pm_next to show top 3 recommended tasks
+3. Warn about blockers or overdue tasks
+
+### Before starting a task
+1. Run pm_update_task to set status to in_progress
+
+### On task completion
+1. Run pm_update_task to set status to done
+2. Run pm_log to record what was completed
+3. Run pm_next to show next recommendations
+4. Create an atomic git commit
+
+### On session end
+1. Update any in-progress task status
+2. Run pm_log to record session results
+3. Commit any uncommitted changes
+```
+
+---
+
+## CLI Commands
+
+```bash
+pm-server install       # Register MCP server in Claude Code
+pm-server uninstall     # Unregister MCP server
+pm-server serve         # Start MCP server (called by Claude Code automatically)
+pm-server discover .    # Scan for projects with .pm/ directories
+pm-server status        # Show project status from terminal
+pm-server migrate       # Migrate from pm-agent (rename transition)
+pm-server update-claudemd  # Update PM Server rules in CLAUDE.md
+```
+
+---
+
+## Architecture
+
+```
+Claude Code Session
+  │
+  ├── CLAUDE.md auto-action rules
+  │
+  └── MCP Server (stdio)
+        └── pm-server serve
+              │
+              ├── server.py    → 16 MCP tools (FastMCP)
+              ├── models.py    → Pydantic v2 data models
+              ├── storage.py   → YAML read/write
+              ├── velocity.py  → Velocity calculation & risk detection
+              ├── dashboard.py → HTML/text dashboard (Jinja2)
+              ├── discovery.py → Auto-detect project info
+              └── installer.py → claude mcp add wrapper
+                    │
+                    ├── project-A/.pm/
+                    ├── project-B/.pm/
+                    └── ~/.pm/registry.yaml
+```
+
+---
+
+## Migrating from pm-agent
+
+If you were using the earlier `pm-agent` package:
+
+```bash
+pip uninstall pm-agent
+pip install git+https://github.com/flc-design/pm-server.git
+pm-server migrate       # Switches MCP registration from pm-agent to pm-server
+# Restart Claude Code
+```
+
+The `migrate` command will:
+- Remove the old `pm-agent` MCP registration
+- Register `pm-server` as the new MCP server
+- Verify `~/.pm/registry.yaml` integrity
+- Warn about any `CLAUDE.md` files that reference `pm-agent`
+
+Your `.pm/` data directories are **unchanged** — no data migration needed.
+
+---
+
+## Requirements
+
+- Python 3.11+
+- Claude Code (with MCP support)
+
+### Dependencies
+
+- [FastMCP](https://github.com/jlowin/fastmcp) — MCP server framework
+- [Pydantic](https://docs.pydantic.dev/) v2 — data validation
+- [PyYAML](https://pyyaml.org/) — data persistence
+- [Click](https://click.palletsprojects.com/) — CLI framework
+- [Jinja2](https://jinja.palletsprojects.com/) — dashboard templates
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/flc-design/pm-server.git
+cd pm-server
+pip install -e ".[dev]"
+pytest                  # 115 tests
+ruff check src/         # Lint
+ruff format src/        # Format
+```
+
+---
+
+## Design Principles
+
+1. **Zero Configuration** — `pip install` + one command, done
+2. **Auto-everything** — detection, registration, and inference are fully automatic
+3. **Git-friendly** — plain text YAML, trackable with `git diff`
+4. **Human-readable** — safe to hand-edit, won't break
+5. **AI-native** — formats that Claude Code can naturally read and write
+6. **Non-invasive** — only adds `.pm/`, never modifies your project
+
+---
+
+## License
+
+MIT — Shinichi Nakazato / FLC design co., ltd.